001/*
002 *  Copyright (c) 2023-2026, Agents-Flex (fuhai999@gmail.com).
003 *  <p>
004 *  Licensed under the Apache License, Version 2.0 (the "License");
005 *  you may not use this file except in compliance with the License.
006 *  You may obtain a copy of the License at
007 *  <p>
008 *  http://www.apache.org/licenses/LICENSE-2.0
009 *  <p>
010 *  Unless required by applicable law or agreed to in writing, software
011 *  distributed under the License is distributed on an "AS IS" BASIS,
012 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 *  See the License for the specific language governing permissions and
014 *  limitations under the License.
015 */
016package com.agentsflex.core.model.chat;
017
018import com.agentsflex.core.model.chat.response.AiMessageResponse;
019import com.agentsflex.core.model.client.StreamContext;
020import org.slf4j.Logger;
021
022public interface StreamResponseListener {
023
024    Logger logger = org.slf4j.LoggerFactory.getLogger(StreamResponseListener.class);
025
026    default void onStart(StreamContext context) {
027    }
028
029    void onMessage(StreamContext context, AiMessageResponse response);
030
031    default void onStop(StreamContext context) {
032    }
033
034    default void onFailure(StreamContext context, Throwable throwable) {
035        if (throwable != null) {
036            throwable.printStackTrace();
037            logger.error(throwable.toString(), throwable);
038        }
039    }
040}