@tdesign-react/chat 1.0.0 → 1.0.2-alpha.1

package/es/chat-engine/core/adapters/agui/events.js

@@ -0,0 +1,181 @@
+/**
+ * tdesign v1.0.1
+ * (c) 2025 tdesign
+ * @license MIT
+ */
+
+import { z } from 'zod';
+import { StateSchema, MessageSchema } from './types.js';
+import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import '@babel/runtime/helpers/wrapNativeSuper';
+
+var EventType = /* @__PURE__ */function (EventType2) {
+  EventType2["TEXT_MESSAGE_START"] = "TEXT_MESSAGE_START";
+  EventType2["TEXT_MESSAGE_CONTENT"] = "TEXT_MESSAGE_CONTENT";
+  EventType2["TEXT_MESSAGE_END"] = "TEXT_MESSAGE_END";
+  EventType2["TEXT_MESSAGE_CHUNK"] = "TEXT_MESSAGE_CHUNK";
+  EventType2["THINKING_TEXT_MESSAGE_START"] = "THINKING_TEXT_MESSAGE_START";
+  EventType2["THINKING_TEXT_MESSAGE_CONTENT"] = "THINKING_TEXT_MESSAGE_CONTENT";
+  EventType2["THINKING_TEXT_MESSAGE_END"] = "THINKING_TEXT_MESSAGE_END";
+  EventType2["THINKING_START"] = "THINKING_START";
+  EventType2["THINKING_END"] = "THINKING_END";
+  EventType2["TOOL_CALL_START"] = "TOOL_CALL_START";
+  EventType2["TOOL_CALL_ARGS"] = "TOOL_CALL_ARGS";
+  EventType2["TOOL_CALL_END"] = "TOOL_CALL_END";
+  EventType2["TOOL_CALL_CHUNK"] = "TOOL_CALL_CHUNK";
+  EventType2["TOOL_CALL_RESULT"] = "TOOL_CALL_RESULT";
+  EventType2["STATE_SNAPSHOT"] = "STATE_SNAPSHOT";
+  EventType2["STATE_DELTA"] = "STATE_DELTA";
+  EventType2["MESSAGES_SNAPSHOT"] = "MESSAGES_SNAPSHOT";
+  EventType2["RAW"] = "RAW";
+  EventType2["CUSTOM"] = "CUSTOM";
+  EventType2["RUN_STARTED"] = "RUN_STARTED";
+  EventType2["RUN_FINISHED"] = "RUN_FINISHED";
+  EventType2["RUN_ERROR"] = "RUN_ERROR";
+  EventType2["STEP_STARTED"] = "STEP_STARTED";
+  EventType2["STEP_FINISHED"] = "STEP_FINISHED";
+  return EventType2;
+}(EventType || {});
+function isTextMessageEvent(eventType) {
+  return ["TEXT_MESSAGE_START", "TEXT_MESSAGE_CHUNK", "TEXT_MESSAGE_CONTENT", "TEXT_MESSAGE_END"].includes(eventType);
+}
+function isThinkingEvent(eventType) {
+  return ["THINKING_START", "THINKING_TEXT_MESSAGE_START", "THINKING_TEXT_MESSAGE_CONTENT", "THINKING_TEXT_MESSAGE_END", "THINKING_END"].includes(eventType);
+}
+function isToolCallEvent(eventType) {
+  return ["TOOL_CALL_START", "TOOL_CALL_ARGS", "TOOL_CALL_CHUNK", "TOOL_CALL_RESULT", "TOOL_CALL_END"].includes(eventType);
+}
+function isStateEvent(eventType) {
+  return ["STATE_SNAPSHOT", "STATE_DELTA"].includes(eventType);
+}
+var BaseEventSchema = z.object({
+  type: z.nativeEnum(EventType),
+  timestamp: z.number().optional(),
+  rawEvent: z.any().optional()
+});
+var TextMessageStartEventSchema = BaseEventSchema.extend({
+  type: z.literal("TEXT_MESSAGE_START" /* TEXT_MESSAGE_START */),
+  messageId: z.string(),
+  role: z.literal("assistant")
+});
+var TextMessageContentEventSchema = BaseEventSchema.extend({
+  type: z.literal("TEXT_MESSAGE_CONTENT" /* TEXT_MESSAGE_CONTENT */),
+  messageId: z.string(),
+  delta: z.string().refine(function (s) {
+    return s.length > 0;
+  }, "Delta must not be an empty string")
+});
+var TextMessageEndEventSchema = BaseEventSchema.extend({
+  type: z.literal("TEXT_MESSAGE_END" /* TEXT_MESSAGE_END */),
+  messageId: z.string()
+});
+var TextMessageChunkEventSchema = BaseEventSchema.extend({
+  type: z.literal("TEXT_MESSAGE_CHUNK" /* TEXT_MESSAGE_CHUNK */),
+  messageId: z.string().optional(),
+  role: z.literal("assistant").optional(),
+  delta: z.string().optional()
+});
+var ThinkingTextMessageStartEventSchema = BaseEventSchema.extend({
+  type: z.literal("THINKING_TEXT_MESSAGE_START" /* THINKING_TEXT_MESSAGE_START */)
+});
+var ThinkingTextMessageContentEventSchema = TextMessageContentEventSchema.omit({
+  messageId: true,
+  type: true
+}).extend({
+  type: z.literal("THINKING_TEXT_MESSAGE_CONTENT" /* THINKING_TEXT_MESSAGE_CONTENT */)
+});
+var ThinkingTextMessageEndEventSchema = BaseEventSchema.extend({
+  type: z.literal("THINKING_TEXT_MESSAGE_END" /* THINKING_TEXT_MESSAGE_END */)
+});
+var ToolCallStartEventSchema = BaseEventSchema.extend({
+  type: z.literal("TOOL_CALL_START" /* TOOL_CALL_START */),
+  toolCallId: z.string(),
+  toolCallName: z.string(),
+  parentMessageId: z.string().optional()
+});
+var ToolCallArgsEventSchema = BaseEventSchema.extend({
+  type: z.literal("TOOL_CALL_ARGS" /* TOOL_CALL_ARGS */),
+  toolCallId: z.string(),
+  delta: z.string()
+});
+var ToolCallEndEventSchema = BaseEventSchema.extend({
+  type: z.literal("TOOL_CALL_END" /* TOOL_CALL_END */),
+  toolCallId: z.string()
+});
+var ToolCallResultEventSchema = BaseEventSchema.extend({
+  messageId: z.string(),
+  type: z.literal("TOOL_CALL_RESULT" /* TOOL_CALL_RESULT */),
+  toolCallId: z.string(),
+  toolCallName: z.string(),
+  content: z.string(),
+  role: z.literal("tool").optional()
+});
+var ToolCallChunkEventSchema = BaseEventSchema.extend({
+  type: z.literal("TOOL_CALL_CHUNK" /* TOOL_CALL_CHUNK */),
+  toolCallId: z.string().optional(),
+  toolCallName: z.string().optional(),
+  parentMessageId: z.string().optional(),
+  delta: z.string().optional()
+});
+var ThinkingStartEventSchema = BaseEventSchema.extend({
+  type: z.literal("THINKING_START" /* THINKING_START */),
+  title: z.string().optional()
+});
+var ThinkingEndEventSchema = BaseEventSchema.extend({
+  type: z.literal("THINKING_END" /* THINKING_END */),
+  title: z.string().optional()
+});
+var StateSnapshotEventSchema = BaseEventSchema.extend({
+  type: z.literal("STATE_SNAPSHOT" /* STATE_SNAPSHOT */),
+  snapshot: StateSchema
+});
+var StateDeltaEventSchema = BaseEventSchema.extend({
+  type: z.literal("STATE_DELTA" /* STATE_DELTA */),
+  delta: z.array(z.any())
+});
+var MessagesSnapshotEventSchema = BaseEventSchema.extend({
+  type: z.literal("MESSAGES_SNAPSHOT" /* MESSAGES_SNAPSHOT */),
+  messages: z.array(MessageSchema)
+});
+var RawEventSchema = BaseEventSchema.extend({
+  type: z.literal("RAW" /* RAW */),
+  event: z.any(),
+  source: z.string().optional()
+});
+var CustomEventSchema = BaseEventSchema.extend({
+  type: z.literal("CUSTOM" /* CUSTOM */),
+  name: z.string(),
+  value: z.any()
+});
+var RunStartedEventSchema = BaseEventSchema.extend({
+  type: z.literal("RUN_STARTED" /* RUN_STARTED */),
+  threadId: z.string(),
+  runId: z.string()
+});
+var RunFinishedEventSchema = BaseEventSchema.extend({
+  type: z.literal("RUN_FINISHED" /* RUN_FINISHED */),
+  threadId: z.string(),
+  runId: z.string(),
+  result: z.any().optional()
+});
+var RunErrorEventSchema = BaseEventSchema.extend({
+  type: z.literal("RUN_ERROR" /* RUN_ERROR */),
+  message: z.string(),
+  code: z.string().optional()
+});
+var StepStartedEventSchema = BaseEventSchema.extend({
+  type: z.literal("STEP_STARTED" /* STEP_STARTED */),
+  stepName: z.string()
+});
+var StepFinishedEventSchema = BaseEventSchema.extend({
+  type: z.literal("STEP_FINISHED" /* STEP_FINISHED */),
+  stepName: z.string()
+});
+var EventSchemas = z.discriminatedUnion("type", [TextMessageStartEventSchema, TextMessageContentEventSchema, TextMessageEndEventSchema, TextMessageChunkEventSchema, ThinkingTextMessageStartEventSchema, ThinkingTextMessageContentEventSchema, ThinkingTextMessageEndEventSchema, ToolCallStartEventSchema, ToolCallArgsEventSchema, ToolCallEndEventSchema, ToolCallChunkEventSchema, ToolCallResultEventSchema, StateSnapshotEventSchema, StateDeltaEventSchema, MessagesSnapshotEventSchema, RawEventSchema, CustomEventSchema, RunStartedEventSchema, RunFinishedEventSchema, RunErrorEventSchema, StepStartedEventSchema, StepFinishedEventSchema]);
+
+export { CustomEventSchema, EventSchemas, EventType, MessagesSnapshotEventSchema, RawEventSchema, RunErrorEventSchema, RunFinishedEventSchema, RunStartedEventSchema, StateDeltaEventSchema, StateSnapshotEventSchema, StepFinishedEventSchema, StepStartedEventSchema, TextMessageChunkEventSchema, TextMessageContentEventSchema, TextMessageEndEventSchema, TextMessageStartEventSchema, ThinkingEndEventSchema, ThinkingStartEventSchema, ThinkingTextMessageContentEventSchema, ThinkingTextMessageEndEventSchema, ThinkingTextMessageStartEventSchema, ToolCallArgsEventSchema, ToolCallChunkEventSchema, ToolCallEndEventSchema, ToolCallResultEventSchema, ToolCallStartEventSchema, isStateEvent, isTextMessageEvent, isThinkingEvent, isToolCallEvent };
+//# sourceMappingURL=events.js.map

package/es/chat-engine/core/adapters/agui/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sources":["../../../../../../pro-components/chat/chat-engine/core/adapters/agui/events.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { MessageSchema, StateSchema } from './types';\n\nexport type ToolCallEventType =\n  | 'TOOL_CALL_START'\n  | 'TOOL_CALL_ARGS'\n  | 'TOOL_CALL_END'\n  | 'TOOL_CALL_CHUNK'\n  | 'TOOL_CALL_RESULT';\n\nexport enum EventType {\n  TEXT_MESSAGE_START = 'TEXT_MESSAGE_START',\n  TEXT_MESSAGE_CONTENT = 'TEXT_MESSAGE_CONTENT',\n  TEXT_MESSAGE_END = 'TEXT_MESSAGE_END',\n  TEXT_MESSAGE_CHUNK = 'TEXT_MESSAGE_CHUNK',\n  THINKING_TEXT_MESSAGE_START = 'THINKING_TEXT_MESSAGE_START',\n  THINKING_TEXT_MESSAGE_CONTENT = 'THINKING_TEXT_MESSAGE_CONTENT',\n  THINKING_TEXT_MESSAGE_END = 'THINKING_TEXT_MESSAGE_END',\n  THINKING_START = 'THINKING_START',\n  THINKING_END = 'THINKING_END',\n\n  TOOL_CALL_START = 'TOOL_CALL_START',\n  TOOL_CALL_ARGS = 'TOOL_CALL_ARGS',\n  TOOL_CALL_END = 'TOOL_CALL_END',\n  TOOL_CALL_CHUNK = 'TOOL_CALL_CHUNK',\n  TOOL_CALL_RESULT = 'TOOL_CALL_RESULT',\n\n  STATE_SNAPSHOT = 'STATE_SNAPSHOT',\n  STATE_DELTA = 'STATE_DELTA',\n  MESSAGES_SNAPSHOT = 'MESSAGES_SNAPSHOT',\n  RAW = 'RAW',\n  CUSTOM = 'CUSTOM',\n  RUN_STARTED = 'RUN_STARTED',\n  RUN_FINISHED = 'RUN_FINISHED',\n  RUN_ERROR = 'RUN_ERROR',\n  STEP_STARTED = 'STEP_STARTED',\n  STEP_FINISHED = 'STEP_FINISHED',\n}\n\n/**\n * 检查事件类型是否为文本消息相关\n * @param eventType 事件类型\n * @returns 是否为文本消息事件\n */\nexport function isTextMessageEvent(eventType: string): boolean {\n  return ['TEXT_MESSAGE_START', 'TEXT_MESSAGE_CHUNK', 'TEXT_MESSAGE_CONTENT', 'TEXT_MESSAGE_END'].includes(eventType);\n}\n\n/**\n * 检查事件类型是否为思考相关\n * @param eventType 事件类型\n * @returns 是否为思考事件\n */\nexport function isThinkingEvent(eventType: string): boolean {\n  return [\n    'THINKING_START',\n    'THINKING_TEXT_MESSAGE_START',\n    'THINKING_TEXT_MESSAGE_CONTENT',\n    'THINKING_TEXT_MESSAGE_END',\n    'THINKING_END',\n  ].includes(eventType);\n}\n\n/**\n * 检查事件类型是否为工具调用相关\n * @param eventType 事件类型\n * @returns 是否为工具调用事件\n */\nexport function isToolCallEvent(eventType: string): boolean {\n  return ['TOOL_CALL_START', 'TOOL_CALL_ARGS', 'TOOL_CALL_CHUNK', 'TOOL_CALL_RESULT', 'TOOL_CALL_END'].includes(\n    eventType,\n  );\n}\n\n/**\n * 检查事件类型是否为状态相关\n * @param eventType 事件类型\n * @returns 是否为状态事件\n */\nexport function isStateEvent(eventType: string): boolean {\n  return ['STATE_SNAPSHOT', 'STATE_DELTA'].includes(eventType);\n}\n\nconst BaseEventSchema = z.object({\n  type: z.nativeEnum(EventType),\n  timestamp: z.number().optional(),\n  rawEvent: z.any().optional(),\n});\n\nexport const TextMessageStartEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.TEXT_MESSAGE_START),\n  messageId: z.string(),\n  role: z.literal('assistant'),\n});\n\nexport const TextMessageContentEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.TEXT_MESSAGE_CONTENT),\n  messageId: z.string(),\n  delta: z.string().refine((s) => s.length > 0, 'Delta must not be an empty string'),\n});\n\nexport const TextMessageEndEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.TEXT_MESSAGE_END),\n  messageId: z.string(),\n});\n\nexport const TextMessageChunkEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.TEXT_MESSAGE_CHUNK),\n  messageId: z.string().optional(),\n  role: z.literal('assistant').optional(),\n  delta: z.string().optional(),\n});\n\nexport const ThinkingTextMessageStartEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.THINKING_TEXT_MESSAGE_START),\n});\n\nexport const ThinkingTextMessageContentEventSchema = TextMessageContentEventSchema.omit({\n  messageId: true,\n  type: true,\n}).extend({\n  type: z.literal(EventType.THINKING_TEXT_MESSAGE_CONTENT),\n});\n\nexport const ThinkingTextMessageEndEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.THINKING_TEXT_MESSAGE_END),\n});\n\nexport const ToolCallStartEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.TOOL_CALL_START),\n  toolCallId: z.string(),\n  toolCallName: z.string(),\n  parentMessageId: z.string().optional(),\n});\n\nexport const ToolCallArgsEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.TOOL_CALL_ARGS),\n  toolCallId: z.string(),\n  delta: z.string(),\n});\n\nexport const ToolCallEndEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.TOOL_CALL_END),\n  toolCallId: z.string(),\n});\n\nexport const ToolCallResultEventSchema = BaseEventSchema.extend({\n  messageId: z.string(),\n  type: z.literal(EventType.TOOL_CALL_RESULT),\n  toolCallId: z.string(),\n  toolCallName: z.string(),\n  content: z.string(),\n  role: z.literal('tool').optional(),\n});\n\nexport const ToolCallChunkEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.TOOL_CALL_CHUNK),\n  toolCallId: z.string().optional(),\n  toolCallName: z.string().optional(),\n  parentMessageId: z.string().optional(),\n  delta: z.string().optional(),\n});\n\nexport const ThinkingStartEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.THINKING_START),\n  title: z.string().optional(),\n});\n\nexport const ThinkingEndEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.THINKING_END),\n  title: z.string().optional(),\n});\n\nexport const StateSnapshotEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.STATE_SNAPSHOT),\n  snapshot: StateSchema,\n});\n\nexport const StateDeltaEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.STATE_DELTA),\n  delta: z.array(z.any()), // JSON Patch (RFC 6902)\n});\n\nexport const MessagesSnapshotEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.MESSAGES_SNAPSHOT),\n  messages: z.array(MessageSchema),\n});\n\nexport const RawEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.RAW),\n  event: z.any(),\n  source: z.string().optional(),\n});\n\nexport const CustomEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.CUSTOM),\n  name: z.string(),\n  value: z.any(),\n});\n\nexport const RunStartedEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.RUN_STARTED),\n  threadId: z.string(),\n  runId: z.string(),\n});\n\nexport const RunFinishedEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.RUN_FINISHED),\n  threadId: z.string(),\n  runId: z.string(),\n  result: z.any().optional(),\n});\n\nexport const RunErrorEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.RUN_ERROR),\n  message: z.string(),\n  code: z.string().optional(),\n});\n\nexport const StepStartedEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.STEP_STARTED),\n  stepName: z.string(),\n});\n\nexport const StepFinishedEventSchema = BaseEventSchema.extend({\n  type: z.literal(EventType.STEP_FINISHED),\n  stepName: z.string(),\n});\n\nexport const EventSchemas = z.discriminatedUnion('type', [\n  TextMessageStartEventSchema,\n  TextMessageContentEventSchema,\n  TextMessageEndEventSchema,\n  TextMessageChunkEventSchema,\n  ThinkingTextMessageStartEventSchema,\n  ThinkingTextMessageContentEventSchema,\n  ThinkingTextMessageEndEventSchema,\n  ToolCallStartEventSchema,\n  ToolCallArgsEventSchema,\n  ToolCallEndEventSchema,\n  ToolCallChunkEventSchema,\n  ToolCallResultEventSchema,\n  StateSnapshotEventSchema,\n  StateDeltaEventSchema,\n  MessagesSnapshotEventSchema,\n  RawEventSchema,\n  CustomEventSchema,\n  RunStartedEventSchema,\n  RunFinishedEventSchema,\n  RunErrorEventSchema,\n  StepStartedEventSchema,\n  StepFinishedEventSchema,\n]);\n\nexport type BaseEvent = z.infer<typeof BaseEventSchema>;\nexport type TextMessageStartEvent = z.infer<typeof TextMessageStartEventSchema>;\nexport type TextMessageContentEvent = z.infer<typeof TextMessageContentEventSchema>;\nexport type TextMessageEndEvent = z.infer<typeof TextMessageEndEventSchema>;\nexport type TextMessageChunkEvent = z.infer<typeof TextMessageChunkEventSchema>;\nexport type ThinkingTextMessageStartEvent = z.infer<typeof ThinkingTextMessageStartEventSchema>;\nexport type ThinkingTextMessageContentEvent = z.infer<typeof ThinkingTextMessageContentEventSchema>;\nexport type ThinkingTextMessageEndEvent = z.infer<typeof ThinkingTextMessageEndEventSchema>;\nexport type ToolCallStartEvent = z.infer<typeof ToolCallStartEventSchema>;\nexport type ToolCallArgsEvent = z.infer<typeof ToolCallArgsEventSchema>;\nexport type ToolCallEndEvent = z.infer<typeof ToolCallEndEventSchema>;\nexport type ToolCallChunkEvent = z.infer<typeof ToolCallChunkEventSchema>;\nexport type ToolCallResultEvent = z.infer<typeof ToolCallResultEventSchema>;\nexport type ThinkingStartEvent = z.infer<typeof ThinkingStartEventSchema>;\nexport type ThinkingEndEvent = z.infer<typeof ThinkingEndEventSchema>;\nexport type StateSnapshotEvent = z.infer<typeof StateSnapshotEventSchema>;\nexport type StateDeltaEvent = z.infer<typeof StateDeltaEventSchema>;\nexport type MessagesSnapshotEvent = z.infer<typeof MessagesSnapshotEventSchema>;\nexport type RawEvent = z.infer<typeof RawEventSchema>;\nexport type CustomEvent = z.infer<typeof CustomEventSchema>;\nexport type RunStartedEvent = z.infer<typeof RunStartedEventSchema>;\nexport type RunFinishedEvent = z.infer<typeof RunFinishedEventSchema>;\nexport type RunErrorEvent = z.infer<typeof RunErrorEventSchema>;\nexport type StepStartedEvent = z.infer<typeof StepStartedEventSchema>;\nexport type StepFinishedEvent = z.infer<typeof StepFinishedEventSchema>;\n"],"names":["EventType","isTextMessageEvent","eventType","includes","isThinkingEvent","isToolCallEvent","isStateEvent","BaseEventSchema","z","object","type","nativeEnum","timestamp","number","optional","rawEvent","any","TextMessageStartEventSchema","extend","literal","messageId","string","role","TextMessageContentEventSchema","delta","refine","s","length","TextMessageEndEventSchema","TextMessageChunkEventSchema","ThinkingTextMessageStartEventSchema","ThinkingTextMessageContentEventSchema","omit","ThinkingTextMessageEndEventSchema","ToolCallStartEventSchema","toolCallId","toolCallName","parentMessageId","ToolCallArgsEventSchema","ToolCallEndEventSchema","ToolCallResultEventSchema","content","ToolCallChunkEventSchema","ThinkingStartEventSchema","title","ThinkingEndEventSchema","StateSnapshotEventSchema","snapshot","StateSchema","StateDeltaEventSchema","array","MessagesSnapshotEventSchema","messages","MessageSchema","RawEventSchema","event","source","CustomEventSchema","name","value","RunStartedEventSchema","threadId","runId","RunFinishedEventSchema","result","RunErrorEventSchema","message","code","StepStartedEventSchema","stepName","StepFinishedEventSchema","EventSchemas","discriminatedUnion"],"mappings":"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"}

package/es/chat-engine/core/adapters/agui/index.d.ts

@@ -0,0 +1,75 @@
+import type { AIMessageContent, ChatMessagesData, ChatRequestParams, SSEChunkData, ToolCall } from '../../type';
+import type { RunErrorEvent, RunFinishedEvent, RunStartedEvent } from './events';
+import type { AGUIHistoryMessage } from './types';
+export type { AGUIHistoryMessage, AGUIUserHistoryMessage, AGUIAssistantHistoryMessage, AGUIToolHistoryMessage, } from './types';
+/**
+ * AGUI协议适配器回调接口
+ */
+export interface AGUIAdapterCallbacks {
+    onRunStart?: (event: RunStartedEvent) => void;
+    onRunComplete?: (isAborted: boolean, params: ChatRequestParams, event?: RunFinishedEvent) => void;
+    onRunError?: (error: RunErrorEvent) => void;
+}
+/**
+ * AGUI协议适配器
+ * 1. 处理AGUI协议特定的事件（RUN_STARTED, RUN_FINISHED, RUN_ERROR）
+ * 2. 管理工具调用的生命周期
+ * 3. 将AGUI事件映射为ChatEngine可理解的消息内容
+ * 4. 转换AG-UI历史消息为ChatMessagesData格式
+ */
+export declare class AGUIAdapter {
+    /**
+     * 转换AG-UI历史消息为ChatMessagesData格式（静态方法）
+     *
+     * 转换策略：
+     * 1. 以用户消息为边界进行分组
+     * 2. 每个用户消息对应一个AI消息，包含该用户输入后的所有AI回复和工具调用结果
+     * 3. 按照后端数据的原始顺序构建content数组
+     * 4. 避免重复处理同一个工具调用
+     * 5. 支持只有assistant消息的情况（如welcome消息）
+     *
+     * @param historyMessages AG-UI格式的历史消息数组
+     * @returns 转换后的ChatMessagesData数组
+     */
+    static convertHistoryMessages(historyMessages: AGUIHistoryMessage[]): ChatMessagesData[];
+    private aguiEventMapper;
+    constructor();
+    /**
+     * 处理AGUI事件
+     *
+     * 处理流程：
+     * 1. 解析SSE数据（AG-UI后端返回标准SSE格式，data字段是JSON字符串）
+     * 2. 处理AGUI特定事件（生命周期事件）
+     * 3. 使用事件映射器转换为消息内容
+     * 4. 同步工具调用状态
+     *
+     * @param chunk SSE数据块
+     * @param callbacks 回调函数
+     * @returns 处理结果
+     */
+    handleAGUIEvent(chunk: SSEChunkData, callbacks: AGUIAdapterCallbacks): AIMessageContent | AIMessageContent[] | null;
+    /**
+     * 获取AGUI事件映射器
+     */
+    get toolcalls(): ToolCall[];
+    getToolcallByName(name: string): ToolCall | undefined;
+    /**
+     * 重置适配器状态
+     */
+    reset(): void;
+    /**
+     * 处理AGUI特定事件
+     *
+     * 处理RUN_STARTED、RUN_FINISHED、RUN_ERROR等生命周期事件
+     * 这些事件用于通知外部系统状态变化，并执行相应的回调
+     *
+     * @param event 解析后的事件对象
+     * @param callbacks 回调函数
+     * @returns 是否处理了生命周期事件
+     */
+    private handleAGUISpecificEvents;
+}
+/**
+ * 状态订阅机制导出
+ */
+export * from './state-manager';

package/es/chat-engine/core/adapters/agui/index.js

@@ -0,0 +1,165 @@
+/**
+ * tdesign v1.0.1
+ * (c) 2025 tdesign
+ * @license MIT
+ */
+
+import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
+import _classCallCheck from '@babel/runtime/helpers/classCallCheck';
+import _createClass from '@babel/runtime/helpers/createClass';
+import { AGUIEventMapper } from './event-mapper.js';
+import { EventType } from './events.js';
+import { buildToolCallMap, processReasoningContent, processToolCalls } from './utils.js';
+export { StateManagerImpl, stateManager } from './state-manager.js';
+import '@babel/runtime/helpers/slicedToArray';
+import '@babel/runtime/helpers/defineProperty';
+import 'zod';
+import './types.js';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import '@babel/runtime/helpers/wrapNativeSuper';
+import '@babel/runtime/helpers/typeof';
+import '../../utils/index.js';
+
+var AGUIAdapter = /*#__PURE__*/function () {
+  function AGUIAdapter() {
+    _classCallCheck(this, AGUIAdapter);
+    this.aguiEventMapper = new AGUIEventMapper();
+  }
+  return _createClass(AGUIAdapter, [{
+    key: "handleAGUIEvent",
+    value: function handleAGUIEvent(chunk, callbacks) {
+      var _event;
+      var event;
+      try {
+        event = typeof chunk.data === "string" ? JSON.parse(chunk.data) : chunk.data;
+      } catch (error) {
+        console.warn("Failed to parse AG-UI event data:", error);
+        return null;
+      }
+      if (!((_event = event) !== null && _event !== void 0 && _event.type)) return null;
+      var lifecycleHandled = this.handleAGUISpecificEvents(event, callbacks);
+      if (lifecycleHandled) {
+        return null;
+      }
+      var result = this.aguiEventMapper.mapEvent(chunk);
+      return result;
+    }
+  }, {
+    key: "toolcalls",
+    get: function get() {
+      return this.aguiEventMapper.getToolCalls();
+    }
+  }, {
+    key: "getToolcallByName",
+    value: function getToolcallByName(name) {
+      var result = this.aguiEventMapper.getToolCalls().find(function (call) {
+        return call.toolCallName === name;
+      });
+      return result;
+    }
+  }, {
+    key: "reset",
+    value: function reset() {
+      this.aguiEventMapper.reset();
+    }
+  }, {
+    key: "handleAGUISpecificEvents",
+    value: function handleAGUISpecificEvents(event, callbacks) {
+      var _callbacks$onRunStart, _callbacks$onRunCompl, _callbacks$onRunError;
+      switch (event.type) {
+        case EventType.RUN_STARTED:
+          (_callbacks$onRunStart = callbacks.onRunStart) === null || _callbacks$onRunStart === void 0 || _callbacks$onRunStart.call(callbacks, event);
+          return true;
+        case EventType.RUN_FINISHED:
+          (_callbacks$onRunCompl = callbacks.onRunComplete) === null || _callbacks$onRunCompl === void 0 || _callbacks$onRunCompl.call(callbacks, false, {}, event);
+          return true;
+        case EventType.RUN_ERROR:
+          (_callbacks$onRunError = callbacks.onRunError) === null || _callbacks$onRunError === void 0 || _callbacks$onRunError.call(callbacks, event);
+          return true;
+        default:
+          return false;
+      }
+    }
+  }], [{
+    key: "convertHistoryMessages",
+    value: function convertHistoryMessages(historyMessages) {
+      if (!historyMessages || historyMessages.length === 0) {
+        return [];
+      }
+      var convertedMessages = [];
+      var toolCallMap = buildToolCallMap(historyMessages);
+      var currentUserMessage = null;
+      var currentGroupMessages = [];
+      var processMessageGroup = function processMessageGroup(messages) {
+        var allContent = [];
+        messages.filter(function (msg) {
+          return msg.role === "assistant";
+        }).forEach(function (msg) {
+          var assistantMsg = msg;
+          if (assistantMsg.reasoningContent) {
+            var reasoningContentResult = processReasoningContent(assistantMsg.reasoningContent);
+            if (reasoningContentResult) {
+              allContent.push(reasoningContentResult);
+            }
+          }
+          if (assistantMsg.content) {
+            allContent.push({
+              type: "markdown",
+              data: assistantMsg.content
+            });
+          }
+          if (assistantMsg.toolCalls && assistantMsg.toolCalls.length > 0) {
+            var toolCallContents = processToolCalls(assistantMsg.toolCalls, toolCallMap);
+            allContent.push.apply(allContent, _toConsumableArray(toolCallContents));
+          }
+        });
+        return allContent;
+      };
+      var createAIMessage = function createAIMessage(messages) {
+        if (messages.length > 0) {
+          var allContent = processMessageGroup(messages);
+          if (allContent.length > 0) {
+            var firstMessageInGroup = messages[0];
+            convertedMessages.push({
+              id: firstMessageInGroup.id,
+              role: "assistant",
+              content: allContent,
+              status: "complete"
+            });
+          }
+        }
+      };
+      var flushCurrentGroup = function flushCurrentGroup() {
+        if (currentUserMessage) {
+          convertedMessages.push({
+            id: currentUserMessage.id,
+            role: "user",
+            content: [{
+              type: "text",
+              data: currentUserMessage.content
+            }],
+            datetime: new Date(currentUserMessage.timestamp || Date.now()).toISOString()
+          });
+        }
+        createAIMessage(currentGroupMessages);
+        currentUserMessage = null;
+        currentGroupMessages = [];
+      };
+      historyMessages.forEach(function (msg) {
+        if (msg.role === "user") {
+          flushCurrentGroup();
+          currentUserMessage = msg;
+        } else if (msg.role === "assistant" || msg.role === "tool") {
+          currentGroupMessages.push(msg);
+        }
+      });
+      flushCurrentGroup();
+      return convertedMessages;
+    }
+  }]);
+}();
+
+export { AGUIAdapter };
+//# sourceMappingURL=index.js.map

package/es/chat-engine/core/adapters/agui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../../../pro-components/chat/chat-engine/core/adapters/agui/index.ts"],"sourcesContent":["/* eslint-disable class-methods-use-this */\nimport type { AIMessageContent, ChatMessagesData,ChatRequestParams, SSEChunkData, ToolCall } from '../../type';\nimport { AGUIEventMapper } from './event-mapper';\nimport type { BaseEvent,RunErrorEvent, RunFinishedEvent, RunStartedEvent } from './events';\nimport { EventType } from './events';\nimport type { AGUIAssistantHistoryMessage,AGUIHistoryMessage, AGUIUserHistoryMessage } from './types';\nimport { buildToolCallMap,processReasoningContent, processToolCalls } from './utils';\n\n// 重新导出类型，以便其他文件可以使用\nexport type {\n  AGUIHistoryMessage,\n  AGUIUserHistoryMessage,\n  AGUIAssistantHistoryMessage,\n  AGUIToolHistoryMessage,\n} from './types';\n\n/**\n * AGUI协议适配器回调接口\n */\nexport interface AGUIAdapterCallbacks {\n  onRunStart?: (event: RunStartedEvent) => void;\n  onRunComplete?: (isAborted: boolean, params: ChatRequestParams, event?: RunFinishedEvent) => void;\n  onRunError?: (error: RunErrorEvent) => void;\n}\n\n/**\n * AGUI协议适配器\n * 1. 处理AGUI协议特定的事件（RUN_STARTED, RUN_FINISHED, RUN_ERROR）\n * 2. 管理工具调用的生命周期\n * 3. 将AGUI事件映射为ChatEngine可理解的消息内容\n * 4. 转换AG-UI历史消息为ChatMessagesData格式\n */\nexport class AGUIAdapter {\n  /**\n   * 转换AG-UI历史消息为ChatMessagesData格式（静态方法）\n   *\n   * 转换策略：\n   * 1. 以用户消息为边界进行分组\n   * 2. 每个用户消息对应一个AI消息，包含该用户输入后的所有AI回复和工具调用结果\n   * 3. 按照后端数据的原始顺序构建content数组\n   * 4. 避免重复处理同一个工具调用\n   * 5. 支持只有assistant消息的情况（如welcome消息）\n   *\n   * @param historyMessages AG-UI格式的历史消息数组\n   * @returns 转换后的ChatMessagesData数组\n   */\n  static convertHistoryMessages(historyMessages: AGUIHistoryMessage[]): ChatMessagesData[] {\n    if (!historyMessages || historyMessages.length === 0) {\n      return [];\n    }\n    const convertedMessages: ChatMessagesData[] = [];\n    const toolCallMap = buildToolCallMap(historyMessages);\n\n    // 按用户消息分组处理\n    let currentUserMessage: AGUIUserHistoryMessage | null = null;\n    let currentGroupMessages: AGUIHistoryMessage[] = []; // 存储当前组的所有消息\n\n    /**\n     * 处理消息组，构建AI消息的content数组\n     */\n    const processMessageGroup = (messages: AGUIHistoryMessage[]): AIMessageContent[] => {\n      const allContent: AIMessageContent[] = [];\n\n      messages\n        .filter((msg) => msg.role === 'assistant')\n        .forEach((msg) => {\n          const assistantMsg = msg as AGUIAssistantHistoryMessage;\n\n          // 处理 reasoningContent（支持 reasoning 和 thinking 两种类型）\n          if (assistantMsg.reasoningContent) {\n            const reasoningContentResult = processReasoningContent(assistantMsg.reasoningContent);\n            if (reasoningContentResult) {\n              allContent.push(reasoningContentResult);\n            }\n          }\n\n          // 处理普通文本内容\n          if (assistantMsg.content) {\n            allContent.push({\n              type: 'markdown',\n              data: assistantMsg.content,\n            });\n          }\n\n          // 处理工具调用内容\n          if (assistantMsg.toolCalls && assistantMsg.toolCalls.length > 0) {\n            const toolCallContents = processToolCalls(assistantMsg.toolCalls, toolCallMap);\n            allContent.push(...(toolCallContents as AIMessageContent[]));\n          }\n        });\n\n      return allContent;\n    };\n\n    /**\n     * 创建AI消息\n     */\n    const createAIMessage = (messages: AGUIHistoryMessage[]): void => {\n      if (messages.length > 0) {\n        const allContent = processMessageGroup(messages);\n        if (allContent.length > 0) {\n          const firstMessageInGroup = messages[0];\n          convertedMessages.push({\n            id: firstMessageInGroup.id,\n            role: 'assistant',\n            content: allContent,\n            status: 'complete',\n          });\n        }\n      }\n    };\n\n    /**\n     * 处理当前消息组\n     */\n    const flushCurrentGroup = () => {\n      if (currentUserMessage) {\n        // 添加用户消息\n        convertedMessages.push({\n          id: currentUserMessage.id,\n          role: 'user',\n          content: [\n            {\n              type: 'text',\n              data: currentUserMessage.content,\n            },\n          ],\n          datetime: new Date(currentUserMessage.timestamp || Date.now()).toISOString(),\n        });\n      }\n      // 处理AI消息\n      createAIMessage(currentGroupMessages);\n\n      // 重置当前组\n      currentUserMessage = null;\n      currentGroupMessages = [];\n    };\n\n    // 按顺序处理消息\n    historyMessages.forEach((msg) => {\n      if (msg.role === 'user') {\n        // 遇到新的用户消息，先处理之前的组\n        flushCurrentGroup();\n\n        // 开始新的组\n        currentUserMessage = msg as AGUIUserHistoryMessage;\n      } else if (msg.role === 'assistant' || msg.role === 'tool') {\n        // 收集助手消息和工具调用结果到当前组\n        currentGroupMessages.push(msg);\n      }\n    });\n\n    // 处理最后一组\n    flushCurrentGroup();\n    return convertedMessages;\n  }\n\n  private aguiEventMapper: AGUIEventMapper;\n\n  constructor() {\n    this.aguiEventMapper = new AGUIEventMapper();\n  }\n\n  /**\n   * 处理AGUI事件\n   *\n   * 处理流程：\n   * 1. 解析SSE数据（AG-UI后端返回标准SSE格式，data字段是JSON字符串）\n   * 2. 处理AGUI特定事件（生命周期事件）\n   * 3. 使用事件映射器转换为消息内容\n   * 4. 同步工具调用状态\n   *\n   * @param chunk SSE数据块\n   * @param callbacks 回调函数\n   * @returns 处理结果\n   */\n  handleAGUIEvent(chunk: SSEChunkData, callbacks: AGUIAdapterCallbacks): AIMessageContent | AIMessageContent[] | null {\n    // AG-UI后端返回标准SSE格式，data字段是JSON字符串\n    let event: BaseEvent;\n    try {\n      event = typeof chunk.data === 'string' ? JSON.parse(chunk.data) : chunk.data;\n    } catch (error) {\n      console.warn('Failed to parse AG-UI event data:', error);\n      return null;\n    }\n\n    if (!event?.type) return null;\n\n    // 处理AGUI特定事件（生命周期事件）\n    const lifecycleHandled = this.handleAGUISpecificEvents(event, callbacks);\n\n    // 如果是生命周期事件，不需要转换为消息内容\n    if (lifecycleHandled) {\n      return null;\n    }\n\n    // 使用事件映射器处理内容事件\n    const result = this.aguiEventMapper.mapEvent(chunk);\n\n    return result;\n  }\n\n  /**\n   * 获取AGUI事件映射器\n   */\n  get toolcalls() {\n    return this.aguiEventMapper.getToolCalls();\n  }\n\n  getToolcallByName(name: string): ToolCall | undefined {\n    const result = this.aguiEventMapper.getToolCalls().find((call) => call.toolCallName === name);\n    return result;\n  }\n\n  /**\n   * 重置适配器状态\n   */\n  reset(): void {\n    this.aguiEventMapper.reset();\n  }\n\n  /**\n   * 处理AGUI特定事件\n   *\n   * 处理RUN_STARTED、RUN_FINISHED、RUN_ERROR等生命周期事件\n   * 这些事件用于通知外部系统状态变化，并执行相应的回调\n   *\n   * @param event 解析后的事件对象\n   * @param callbacks 回调函数\n   * @returns 是否处理了生命周期事件\n   */\n  private handleAGUISpecificEvents(event: BaseEvent, callbacks: AGUIAdapterCallbacks): boolean {\n    switch (event.type) {\n      case EventType.RUN_STARTED:\n        callbacks.onRunStart?.(event as RunStartedEvent);\n        return true;\n      case EventType.RUN_FINISHED:\n        callbacks.onRunComplete?.(false, {} as ChatRequestParams, event as RunFinishedEvent);\n        return true;\n      case EventType.RUN_ERROR:\n        callbacks.onRunError?.(event as RunErrorEvent);\n        return true;\n      default:\n        return false; // 不是生命周期事件\n    }\n  }\n}\n\n/**\n * 状态订阅机制导出\n */\nexport * from './state-manager';\n"],"names":["AGUIAdapter","_classCallCheck","aguiEventMapper","AGUIEventMapper","_createClass","key","value","handleAGUIEvent","chunk","callbacks","_event","event","data","JSON","parse","error","console","warn","type","lifecycleHandled","handleAGUISpecificEvents","result","mapEvent","get","getToolCalls","getToolcallByName","name","find","call","toolCallName","reset","_callbacks$onRunStart","_callbacks$onRunCompl","_callbacks$onRunError","EventType","RUN_STARTED","onRunStart","RUN_FINISHED","onRunComplete","RUN_ERROR","onRunError","convertHistoryMessages","historyMessages","length","convertedMessages","toolCallMap","buildToolCallMap","currentUserMessage","currentGroupMessages","processMessageGroup","messages","allContent","filter","msg","role","forEach","assistantMsg","reasoningContent","reasoningContentResult","processReasoningContent","push","content","toolCalls","toolCallContents","processToolCalls","apply","_toConsumableArray","createAIMessage","firstMessageInGroup","id","status","flushCurrentGroup","datetime","Date","timestamp","now","toISOString"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAgCO,IAAMA,WAAY,gBAAA,YAAA;AA+HvB,EAAA,SAAAA,cAAc;AAAAC,IAAAA,eAAA,OAAAD,WAAA,CAAA,CAAA;AACP,IAAA,IAAA,CAAAE,eAAA,GAAkB,IAAIC,eAAgB,EAAA,CAAA;AAC7C,GAAA;EAAA,OAAAC,YAAA,CAAAJ,WAAA,EAAA,CAAA;IAAAK,GAAA,EAAA,iBAAA;AAAAC,IAAAA,KAAA,EAeA,SAAAC,eAAAA,CAAgBC,OAAqBC,SAA+E,EAAA;AAAA,MAAA,IAAAC,MAAA,CAAA;AAE9G,MAAA,IAAAC,KAAA,CAAA;MACA,IAAA;AACMA,QAAAA,KAAA,GAAA,OAAOH,MAAMI,IAAS,KAAA,QAAA,GAAWC,KAAKC,KAAM,CAAAN,KAAA,CAAMI,IAAI,CAAA,GAAIJ,KAAM,CAAAI,IAAA,CAAA;eACjEG,KAAP,EAAA;AACQC,QAAAA,OAAA,CAAAC,IAAA,CAAK,qCAAqCF,KAAK,CAAA,CAAA;AAChD,QAAA,OAAA,IAAA,CAAA;AACT,OAAA;AAEA,MAAA,IAAI,EAAAL,CAAAA,MAAA,GAACC,KAAO,MAAAD,IAAAA,IAAAA,MAAA,KAAPA,KAAAA,CAAAA,IAAAA,MAAA,CAAOQ,IAAA,CAAa,EAAA,OAAA,IAAA,CAAA;MAGzB,IAAMC,gBAAmB,GAAA,IAAA,CAAKC,wBAAyB,CAAAT,KAAA,EAAOF,SAAS,CAAA,CAAA;AAGvE,MAAA,IAAIU,gBAAkB,EAAA;AACb,QAAA,OAAA,IAAA,CAAA;AACT,OAAA;MAGA,IAAME,MAAS,GAAA,IAAA,CAAKnB,eAAgB,CAAAoB,QAAA,CAASd,KAAK,CAAA,CAAA;AAE3C,MAAA,OAAAa,MAAA,CAAA;AACT,KAAA;AAAA,GAAA,EAAA;IAAAhB,GAAA,EAAA,WAAA;IAAAkB,GAAA,EAKA,SAAAA,GAAAA,GAAgB;AACP,MAAA,OAAA,IAAA,CAAKrB,gBAAgBsB,YAAa,EAAA,CAAA;AAC3C,KAAA;AAAA,GAAA,EAAA;IAAAnB,GAAA,EAAA,mBAAA;AAAAC,IAAAA,KAAA,EAEA,SAAAmB,kBAAkBC,IAAoC,EAAA;AAC9C,MAAA,IAAAL,MAAA,GAAS,IAAK,CAAAnB,eAAA,CAAgBsB,YAAa,EAAA,CAAEG,KAAK,UAACC,IAAA,EAAA;AAAA,QAAA,OAASA,IAAK,CAAAC,YAAA,KAAiBH,IAAI,CAAA;OAAA,CAAA,CAAA;AACrF,MAAA,OAAAL,MAAA,CAAA;AACT,KAAA;AAAA,GAAA,EAAA;IAAAhB,GAAA,EAAA,OAAA;AAAAC,IAAAA,KAAA,EAKA,SAAAwB,KAAcA,GAAA;AACZ,MAAA,IAAA,CAAK5B,gBAAgB4B,KAAM,EAAA,CAAA;AAC7B,KAAA;AAAA,GAAA,EAAA;IAAAzB,GAAA,EAAA,0BAAA;AAAAC,IAAAA,KAAA,EAYQ,SAAAc,wBAAAA,CAAyBT,OAAkBF,SAA0C,EAAA;AAAA,MAAA,IAAAsB,qBAAA,EAAAC,qBAAA,EAAAC,qBAAA,CAAA;MAC3F,QAAQtB,KAAM,CAAAO,IAAA;QAAA,KACPgB,SAAU,CAAAC,WAAA;AACb,UAAA,CAAAJ,qBAAA,GAAAtB,SAAA,CAAU2B,kDAAVL,KAAAA,CAAAA,IAAAA,qBAAA,CAAAH,IAAA,CAAAnB,SAAA,EAAuBE,KAAwB,CAAA,CAAA;AACxC,UAAA,OAAA,IAAA,CAAA;QAAA,KACJuB,SAAU,CAAAG,YAAA;UACb,CAAAL,qBAAA,GAAAvB,SAAA,CAAU6B,aAAgB,MAAAN,IAAAA,IAAAA,qBAAA,eAA1BA,qBAAA,CAAAJ,IAAA,CAAAnB,SAAA,EAA0B,KAAA,EAAO,EAAC,EAAwBE,KAAyB,CAAA,CAAA;AAC5E,UAAA,OAAA,IAAA,CAAA;QAAA,KACJuB,SAAU,CAAAK,SAAA;AACb,UAAA,CAAAN,qBAAA,GAAAxB,SAAA,CAAU+B,kDAAVP,KAAAA,CAAAA,IAAAA,qBAAA,CAAAL,IAAA,CAAAnB,SAAA,EAAuBE,KAAsB,CAAA,CAAA;AACtC,UAAA,OAAA,IAAA,CAAA;AAAA,QAAA;AAEA,UAAA,OAAA,KAAA,CAAA;AAAA,OAAA;AAEb,KAAA;AAAA,GAAA,CAAA,EAAA,CAAA;IAAAN,GAAA,EAAA,wBAAA;AAAAC,IAAAA,KAAA,EAvMA,SAAOmC,uBAAuBC,eAA2D,EAAA;MACvF,IAAI,CAACA,eAAA,IAAmBA,eAAgB,CAAAC,MAAA,KAAW,CAAG,EAAA;AACpD,QAAA,OAAO,EAAC,CAAA;AACV,OAAA;MACA,IAAMC,oBAAwC,EAAC,CAAA;AACzC,MAAA,IAAAC,WAAA,GAAcC,iBAAiBJ,eAAe,CAAA,CAAA;MAGpD,IAAIK,kBAAoD,GAAA,IAAA,CAAA;MACxD,IAAIC,uBAA6C,EAAC,CAAA;AAK5C,MAAA,IAAAC,mBAAA,GAAsB,SAAtBA,mBAAAA,CAAuBC,QAAuD,EAAA;QAClF,IAAMC,aAAiC,EAAC,CAAA;AAGrCD,QAAAA,QAAA,CAAAE,MAAA,CAAO,UAACC,GAAQ,EAAA;AAAA,UAAA,OAAAA,GAAA,CAAIC,SAAS,WAAW,CAAA;AAAA,SAAA,CAAA,CACxCC,OAAQ,CAAA,UAACF,GAAQ,EAAA;UAChB,IAAMG,YAAe,GAAAH,GAAA,CAAA;UAGrB,IAAIG,aAAaC,gBAAkB,EAAA;AAC3B,YAAA,IAAAC,sBAAA,GAAyBC,uBAAwB,CAAAH,YAAA,CAAaC,gBAAgB,CAAA,CAAA;AACpF,YAAA,IAAIC,sBAAwB,EAAA;AAC1BP,cAAAA,UAAA,CAAWS,KAAKF,sBAAsB,CAAA,CAAA;AACxC,aAAA;AACF,WAAA;UAGA,IAAIF,aAAaK,OAAS,EAAA;YACxBV,UAAA,CAAWS,IAAK,CAAA;AACd1C,cAAAA,IAAM,EAAA,UAAA;cACNN,MAAM4C,YAAa,CAAAK,OAAAA;AACrB,aAAC,CAAA,CAAA;AACH,WAAA;UAGA,IAAIL,YAAa,CAAAM,SAAA,IAAaN,YAAa,CAAAM,SAAA,CAAUnB,SAAS,CAAG,EAAA;YAC/D,IAAMoB,gBAAmB,GAAAC,gBAAA,CAAiBR,YAAa,CAAAM,SAAA,EAAWjB,WAAW,CAAA,CAAA;YAClEM,UAAA,CAAAS,IAAA,CAAAK,KAAA,CAAAd,UAAA,EAAAe,kBAAA,CAASH,gBAAuC,CAAA,CAAA,CAAA;AAC7D,WAAA;AACF,SAAC,CAAA,CAAA;AAEI,QAAA,OAAAZ,UAAA,CAAA;OACT,CAAA;AAKM,MAAA,IAAAgB,eAAA,GAAkB,SAAlBA,eAAAA,CAAmBjB,QAAyC,EAAA;AAC5D,QAAA,IAAAA,QAAA,CAASP,SAAS,CAAG,EAAA;AACjB,UAAA,IAAAQ,UAAA,GAAaF,oBAAoBC,QAAQ,CAAA,CAAA;AAC3C,UAAA,IAAAC,UAAA,CAAWR,SAAS,CAAG,EAAA;AACzB,YAAA,IAAMyB,sBAAsBlB,QAAS,CAAA,CAAA,CAAA,CAAA;YACrCN,iBAAA,CAAkBgB,IAAK,CAAA;cACrBS,IAAID,mBAAoB,CAAAC,EAAA;AACxBf,cAAAA,IAAM,EAAA,WAAA;AACNO,cAAAA,OAAS,EAAAV,UAAA;AACTmB,cAAAA,MAAQ,EAAA,UAAA;AACV,aAAC,CAAA,CAAA;AACH,WAAA;AACF,SAAA;OACF,CAAA;AAKA,MAAA,IAAMC,oBAAoB,SAApBA,oBAA0B;AAC9B,QAAA,IAAIxB,kBAAoB,EAAA;UAEtBH,iBAAA,CAAkBgB,IAAK,CAAA;YACrBS,IAAItB,kBAAmB,CAAAsB,EAAA;AACvBf,YAAAA,IAAM,EAAA,MAAA;AACNO,YAAAA,OAAS,EAAA,CACP;AACE3C,cAAAA,IAAM,EAAA,MAAA;cACNN,MAAMmC,kBAAmB,CAAAc,OAAAA;AAC3B,aAAA,CACF;AACAW,YAAAA,QAAA,EAAU,IAAIC,IAAK,CAAA1B,kBAAA,CAAmB2B,aAAaD,IAAK,CAAAE,GAAA,EAAK,CAAA,CAAEC,WAAY,EAAA;AAC7E,WAAC,CAAA,CAAA;AACH,SAAA;QAEAT,eAAA,CAAgBnB,oBAAoB,CAAA,CAAA;AAGfD,QAAAA,kBAAA,GAAA,IAAA,CAAA;AACrBC,QAAAA,oBAAA,GAAuB,EAAC,CAAA;OAC1B,CAAA;AAGgBN,MAAAA,eAAA,CAAAa,OAAA,CAAQ,UAACF,GAAQ,EAAA;AAC3B,QAAA,IAAAA,GAAA,CAAIC,SAAS,MAAQ,EAAA;AAELiB,UAAAA,iBAAA,EAAA,CAAA;AAGGxB,UAAAA,kBAAA,GAAAM,GAAA,CAAA;AACvB,mBAAWA,GAAI,CAAAC,IAAA,KAAS,WAAe,IAAAD,GAAA,CAAIC,SAAS,MAAQ,EAAA;AAE1DN,UAAAA,oBAAA,CAAqBY,KAAKP,GAAG,CAAA,CAAA;AAC/B,SAAA;AACF,OAAC,CAAA,CAAA;AAGiBkB,MAAAA,iBAAA,EAAA,CAAA;AACX,MAAA,OAAA3B,iBAAA,CAAA;AACT,KAAA;AAAA,GAAA,CAAA,CAAA,CAAA;AAAA,CAAA;;;;"}

package/es/chat-engine/core/adapters/agui/state-manager.d.ts

@@ -0,0 +1,99 @@
+/**
+ * 状态管理器
+ * 支持两种订阅模式：
+ * 1. 最新状态模式：订阅最新状态，适用于状态覆盖场景
+ * 2. 绑定状态模式：订阅特定stateKey，适用于状态隔离场景
+ */
+export interface StateManager {
+    /**
+     * 获取当前活跃的状态key
+     */
+    getCurrentStateKey: () => string | null;
+    /**
+     * 获取当前状态（基于当前状态key）
+     */
+    getCurrentState: () => any;
+    /**
+     * 获取指定状态key的状态
+     */
+    getState: (stateKey: string) => any;
+    /**
+     * 获取所有状态keys
+     */
+    getAllStateKeys: () => string[];
+    /**
+     * 订阅状态变化
+     * @param callback 状态变化回调函数
+     * @param targetStateKey 可选：指定订阅特定的stateKey，不传则订阅当前活跃状态
+     */
+    subscribe: (callback: (state: any, stateKey: string) => void, targetStateKey?: string) => () => void;
+    /**
+     * 处理AG-UI状态事件，自动从事件中提取stateKey
+     */
+    handleStateEvent: (event: {
+        type: string;
+        snapshot?: any;
+        delta?: any[];
+    }) => void;
+    /**
+     * 清理所有状态和订阅
+     */
+    clear: () => void;
+}
+export declare class StateManagerImpl implements StateManager {
+    private states;
+    private currentStateKey;
+    private latestSubscribers;
+    private boundSubscribers;
+    /**
+     * 获取当前活跃的状态key
+     */
+    getCurrentStateKey(): string | null;
+    /**
+     * 获取当前状态（基于当前状态key）
+     */
+    getCurrentState(): any;
+    /**
+     * 获取指定状态key的状态
+     */
+    getState(stateKey: string): any;
+    /**
+     * 获取所有状态keys
+     */
+    getAllStateKeys(): string[];
+    /**
+     * 订阅最新状态（覆盖模式）
+     * 适用于只有一个组件，每轮都用新状态更新的场景
+     */
+    subscribeToLatest(callback: (state: any, stateKey: string) => void): () => void;
+    /**
+     * 订阅状态变化（实现 StateManager 接口）
+     * @param callback 状态变化回调函数
+     * @param targetStateKey 可选：指定订阅特定的stateKey，不传则订阅当前活跃状态
+     */
+    subscribe(callback: (state: any, stateKey: string) => void, targetStateKey?: string): () => void;
+    /**
+     * 订阅特定状态（隔离模式）
+     * 适用于每轮对话创建新组件，各自保持独立状态的场景
+     */
+    subscribeToState(stateKey: string, callback: (state: any) => void): () => void;
+    /**
+     * 处理AG-UI状态事件
+     * 自动从事件中提取stateKey，无需外部传递
+     */
+    handleStateEvent(event: {
+        type: string;
+        snapshot?: any;
+        delta?: any[];
+    }): void;
+    clear(): void;
+    /**
+     * 设置状态并立即通知订阅者
+     */
+    private setState;
+    /**
+     * 通知订阅者
+     */
+    private notifySubscribers;
+}
+export declare const stateManager: StateManagerImpl;