@notic/agent-engine 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. package/LICENSE +190 -0
  2. package/README.md +725 -0
  3. package/dist/adapter/AnthropicAdapter.d.ts +47 -0
  4. package/dist/adapter/AnthropicAdapter.d.ts.map +1 -0
  5. package/dist/adapter/AnthropicAdapter.js +341 -0
  6. package/dist/adapter/AnthropicAdapter.js.map +1 -0
  7. package/dist/adapter/GeminiAdapter.d.ts +47 -0
  8. package/dist/adapter/GeminiAdapter.d.ts.map +1 -0
  9. package/dist/adapter/GeminiAdapter.js +315 -0
  10. package/dist/adapter/GeminiAdapter.js.map +1 -0
  11. package/dist/adapter/MessageAdapter.d.ts +66 -0
  12. package/dist/adapter/MessageAdapter.d.ts.map +1 -0
  13. package/dist/adapter/MessageAdapter.js +66 -0
  14. package/dist/adapter/MessageAdapter.js.map +1 -0
  15. package/dist/adapter/OpenAIAdapter.d.ts +45 -0
  16. package/dist/adapter/OpenAIAdapter.d.ts.map +1 -0
  17. package/dist/adapter/OpenAIAdapter.js +305 -0
  18. package/dist/adapter/OpenAIAdapter.js.map +1 -0
  19. package/dist/adapter/index.d.ts +5 -0
  20. package/dist/adapter/index.d.ts.map +1 -0
  21. package/dist/adapter/index.js +10 -0
  22. package/dist/adapter/index.js.map +1 -0
  23. package/dist/agent/Agent.d.ts +319 -0
  24. package/dist/agent/Agent.d.ts.map +1 -0
  25. package/dist/agent/Agent.js +876 -0
  26. package/dist/agent/Agent.js.map +1 -0
  27. package/dist/agent/index.d.ts +2 -0
  28. package/dist/agent/index.d.ts.map +1 -0
  29. package/dist/agent/index.js +8 -0
  30. package/dist/agent/index.js.map +1 -0
  31. package/dist/config/RequestConfig.d.ts +119 -0
  32. package/dist/config/RequestConfig.d.ts.map +1 -0
  33. package/dist/config/RequestConfig.js +257 -0
  34. package/dist/config/RequestConfig.js.map +1 -0
  35. package/dist/config/index.d.ts +2 -0
  36. package/dist/config/index.d.ts.map +1 -0
  37. package/dist/config/index.js +6 -0
  38. package/dist/config/index.js.map +1 -0
  39. package/dist/index.d.ts +29 -0
  40. package/dist/index.d.ts.map +1 -0
  41. package/dist/index.js +69 -0
  42. package/dist/index.js.map +1 -0
  43. package/dist/media/DefaultMediaResolver.d.ts +17 -0
  44. package/dist/media/DefaultMediaResolver.d.ts.map +1 -0
  45. package/dist/media/DefaultMediaResolver.js +114 -0
  46. package/dist/media/DefaultMediaResolver.js.map +1 -0
  47. package/dist/media/MediaResolver.d.ts +20 -0
  48. package/dist/media/MediaResolver.d.ts.map +1 -0
  49. package/dist/media/MediaResolver.js +3 -0
  50. package/dist/media/MediaResolver.js.map +1 -0
  51. package/dist/media/index.d.ts +3 -0
  52. package/dist/media/index.d.ts.map +1 -0
  53. package/dist/media/index.js +6 -0
  54. package/dist/media/index.js.map +1 -0
  55. package/dist/message/Message.d.ts +121 -0
  56. package/dist/message/Message.d.ts.map +1 -0
  57. package/dist/message/Message.js +345 -0
  58. package/dist/message/Message.js.map +1 -0
  59. package/dist/message/MessagePart.d.ts +46 -0
  60. package/dist/message/MessagePart.d.ts.map +1 -0
  61. package/dist/message/MessagePart.js +6 -0
  62. package/dist/message/MessagePart.js.map +1 -0
  63. package/dist/message/Role.d.ts +10 -0
  64. package/dist/message/Role.d.ts.map +1 -0
  65. package/dist/message/Role.js +14 -0
  66. package/dist/message/Role.js.map +1 -0
  67. package/dist/message/Usage.d.ts +31 -0
  68. package/dist/message/Usage.d.ts.map +1 -0
  69. package/dist/message/Usage.js +58 -0
  70. package/dist/message/Usage.js.map +1 -0
  71. package/dist/message/index.d.ts +5 -0
  72. package/dist/message/index.d.ts.map +1 -0
  73. package/dist/message/index.js +10 -0
  74. package/dist/message/index.js.map +1 -0
  75. package/dist/prompt/Injection.d.ts +72 -0
  76. package/dist/prompt/Injection.d.ts.map +1 -0
  77. package/dist/prompt/Injection.js +123 -0
  78. package/dist/prompt/Injection.js.map +1 -0
  79. package/dist/prompt/PromptBuilder.d.ts +276 -0
  80. package/dist/prompt/PromptBuilder.d.ts.map +1 -0
  81. package/dist/prompt/PromptBuilder.js +465 -0
  82. package/dist/prompt/PromptBuilder.js.map +1 -0
  83. package/dist/prompt/Rule.d.ts +98 -0
  84. package/dist/prompt/Rule.d.ts.map +1 -0
  85. package/dist/prompt/Rule.js +275 -0
  86. package/dist/prompt/Rule.js.map +1 -0
  87. package/dist/prompt/index.d.ts +4 -0
  88. package/dist/prompt/index.d.ts.map +1 -0
  89. package/dist/prompt/index.js +10 -0
  90. package/dist/prompt/index.js.map +1 -0
  91. package/dist/session/Inserter.d.ts +76 -0
  92. package/dist/session/Inserter.d.ts.map +1 -0
  93. package/dist/session/Inserter.js +217 -0
  94. package/dist/session/Inserter.js.map +1 -0
  95. package/dist/session/Paginator.d.ts +52 -0
  96. package/dist/session/Paginator.d.ts.map +1 -0
  97. package/dist/session/Paginator.js +110 -0
  98. package/dist/session/Paginator.js.map +1 -0
  99. package/dist/session/Query.d.ts +54 -0
  100. package/dist/session/Query.d.ts.map +1 -0
  101. package/dist/session/Query.js +97 -0
  102. package/dist/session/Query.js.map +1 -0
  103. package/dist/session/SearchCriteria.d.ts +39 -0
  104. package/dist/session/SearchCriteria.d.ts.map +1 -0
  105. package/dist/session/SearchCriteria.js +28 -0
  106. package/dist/session/SearchCriteria.js.map +1 -0
  107. package/dist/session/Session.d.ts +139 -0
  108. package/dist/session/Session.d.ts.map +1 -0
  109. package/dist/session/Session.js +344 -0
  110. package/dist/session/Session.js.map +1 -0
  111. package/dist/session/index.d.ts +6 -0
  112. package/dist/session/index.d.ts.map +1 -0
  113. package/dist/session/index.js +15 -0
  114. package/dist/session/index.js.map +1 -0
  115. package/dist/session/matchUtils.d.ts +22 -0
  116. package/dist/session/matchUtils.d.ts.map +1 -0
  117. package/dist/session/matchUtils.js +138 -0
  118. package/dist/session/matchUtils.js.map +1 -0
  119. package/dist/stream/StreamEvent.d.ts +193 -0
  120. package/dist/stream/StreamEvent.d.ts.map +1 -0
  121. package/dist/stream/StreamEvent.js +44 -0
  122. package/dist/stream/StreamEvent.js.map +1 -0
  123. package/dist/stream/StreamParser.d.ts +47 -0
  124. package/dist/stream/StreamParser.d.ts.map +1 -0
  125. package/dist/stream/StreamParser.js +225 -0
  126. package/dist/stream/StreamParser.js.map +1 -0
  127. package/dist/stream/index.d.ts +3 -0
  128. package/dist/stream/index.d.ts.map +1 -0
  129. package/dist/stream/index.js +8 -0
  130. package/dist/stream/index.js.map +1 -0
  131. package/dist/tool/Context.d.ts +30 -0
  132. package/dist/tool/Context.d.ts.map +1 -0
  133. package/dist/tool/Context.js +50 -0
  134. package/dist/tool/Context.js.map +1 -0
  135. package/dist/tool/Hook.d.ts +23 -0
  136. package/dist/tool/Hook.d.ts.map +1 -0
  137. package/dist/tool/Hook.js +27 -0
  138. package/dist/tool/Hook.js.map +1 -0
  139. package/dist/tool/McpToolAdapter.d.ts +47 -0
  140. package/dist/tool/McpToolAdapter.d.ts.map +1 -0
  141. package/dist/tool/McpToolAdapter.js +88 -0
  142. package/dist/tool/McpToolAdapter.js.map +1 -0
  143. package/dist/tool/Param.d.ts +68 -0
  144. package/dist/tool/Param.d.ts.map +1 -0
  145. package/dist/tool/Param.js +161 -0
  146. package/dist/tool/Param.js.map +1 -0
  147. package/dist/tool/Tool.d.ts +92 -0
  148. package/dist/tool/Tool.d.ts.map +1 -0
  149. package/dist/tool/Tool.js +198 -0
  150. package/dist/tool/Tool.js.map +1 -0
  151. package/dist/tool/ToolCall.d.ts +37 -0
  152. package/dist/tool/ToolCall.d.ts.map +1 -0
  153. package/dist/tool/ToolCall.js +118 -0
  154. package/dist/tool/ToolCall.js.map +1 -0
  155. package/dist/tool/ToolKit.d.ts +87 -0
  156. package/dist/tool/ToolKit.d.ts.map +1 -0
  157. package/dist/tool/ToolKit.js +173 -0
  158. package/dist/tool/ToolKit.js.map +1 -0
  159. package/dist/tool/ValueType.d.ts +12 -0
  160. package/dist/tool/ValueType.d.ts.map +1 -0
  161. package/dist/tool/ValueType.js +16 -0
  162. package/dist/tool/ValueType.js.map +1 -0
  163. package/dist/tool/index.d.ts +9 -0
  164. package/dist/tool/index.d.ts.map +1 -0
  165. package/dist/tool/index.js +21 -0
  166. package/dist/tool/index.js.map +1 -0
  167. package/dist/utils/generateId.d.ts +10 -0
  168. package/dist/utils/generateId.d.ts.map +1 -0
  169. package/dist/utils/generateId.js +18 -0
  170. package/dist/utils/generateId.js.map +1 -0
  171. package/dist/utils/index.d.ts +2 -0
  172. package/dist/utils/index.d.ts.map +1 -0
  173. package/dist/utils/index.js +6 -0
  174. package/dist/utils/index.js.map +1 -0
  175. package/package.json +72 -0
@@ -0,0 +1,193 @@
1
+ import { Message } from "../message/Message";
2
+ /** 模型流式完成原因(兼容 OpenAI finish_reason,并允许扩展字符串) */
3
+ export type FinishReason = "stop" | "length" | "tool_calls" | "content_filter" | "function_call" | string;
4
+ /**
5
+ * 流式事件类型枚举
6
+ */
7
+ export declare enum StreamEventType {
8
+ /** 思考/推理增量到达 */
9
+ THINKING_DELTA = "thinking_delta",
10
+ /** 思考/推理流结束 */
11
+ THINKING_DONE = "thinking_done",
12
+ /** 文本增量到达 */
13
+ TEXT_DELTA = "text_delta",
14
+ /** 文本流结束 */
15
+ TEXT_DONE = "text_done",
16
+ /** 工具调用开始(拿到 id + name) */
17
+ TOOL_CALL_START = "tool_call_start",
18
+ /** 工具参数增量 */
19
+ TOOL_CALL_DELTA = "tool_call_delta",
20
+ /** 单个工具调用完成(完整参数就绪) */
21
+ TOOL_CALL_DONE = "tool_call_done",
22
+ /** 工具调用需要审批 */
23
+ TOOL_APPROVAL_REQUIRED = "tool_approval_required",
24
+ /** 工具调用审批通过 */
25
+ TOOL_APPROVAL_ACCEPTED = "tool_approval_accepted",
26
+ /** 工具调用审批拒绝 */
27
+ TOOL_APPROVAL_REJECTED = "tool_approval_rejected",
28
+ /** 工具开始执行 */
29
+ TOOL_EXECUTE_START = "tool_execute_start",
30
+ /** 工具执行完成 */
31
+ TOOL_EXECUTE_DONE = "tool_execute_done",
32
+ /** 工具执行失败 */
33
+ TOOL_EXECUTE_ERROR = "tool_execute_error",
34
+ /** 整条消息组装完毕 */
35
+ MESSAGE_DONE = "message_done",
36
+ /** 新一轮循环开始 */
37
+ TURN_START = "turn_start",
38
+ /** 一轮循环结束 */
39
+ TURN_END = "turn_end",
40
+ /** 错误 */
41
+ ERROR = "error"
42
+ }
43
+ export interface ThinkingDeltaEvent {
44
+ type: StreamEventType.THINKING_DELTA;
45
+ /** 本次思考增量 */
46
+ delta: string;
47
+ /** 截至目前的完整思考文本 */
48
+ snapshot: string;
49
+ }
50
+ export interface ThinkingDoneEvent {
51
+ type: StreamEventType.THINKING_DONE;
52
+ /** 最终完整思考文本 */
53
+ thinking: string;
54
+ }
55
+ export interface TextDeltaEvent {
56
+ type: StreamEventType.TEXT_DELTA;
57
+ /** 本次增量文本 */
58
+ delta: string;
59
+ /** 截至目前的完整文本 */
60
+ snapshot: string;
61
+ }
62
+ export interface TextDoneEvent {
63
+ type: StreamEventType.TEXT_DONE;
64
+ /** 最终完整文本 */
65
+ text: string;
66
+ }
67
+ export interface ToolCallStartEvent {
68
+ type: StreamEventType.TOOL_CALL_START;
69
+ /** 工具调用在 tool_calls 数组中的索引 */
70
+ index: number;
71
+ /** tool_call_id */
72
+ toolCallId: string;
73
+ /**工具名*/
74
+ name: string;
75
+ }
76
+ export interface ToolCallDeltaEvent {
77
+ type: StreamEventType.TOOL_CALL_DELTA;
78
+ index: number;
79
+ /** 本次参数增量 */
80
+ argsDelta: string;
81
+ /** 截至目前的完整参数 JSON */
82
+ argsSnapshot: string;
83
+ }
84
+ export interface ToolCallDoneEvent {
85
+ type: StreamEventType.TOOL_CALL_DONE;
86
+ index: number;
87
+ toolCallId: string;
88
+ name: string;
89
+ /** 完整的参数 JSON string */
90
+ arguments: string;
91
+ }
92
+ export interface ToolApprovalRequiredEvent {
93
+ type: StreamEventType.TOOL_APPROVAL_REQUIRED;
94
+ approvalId: string;
95
+ toolCallId: string;
96
+ name: string;
97
+ /** 已解析参数 */
98
+ arguments: Record<string, unknown>;
99
+ /** 原始参数 JSON string */
100
+ rawArguments: string;
101
+ /** 当前 Agent turn */
102
+ turn: number;
103
+ }
104
+ export interface ToolApprovalAcceptedEvent {
105
+ type: StreamEventType.TOOL_APPROVAL_ACCEPTED;
106
+ approvalId: string;
107
+ toolCallId: string;
108
+ name: string;
109
+ }
110
+ export interface ToolApprovalRejectedEvent {
111
+ type: StreamEventType.TOOL_APPROVAL_REJECTED;
112
+ approvalId: string;
113
+ toolCallId: string;
114
+ name: string;
115
+ reason?: string;
116
+ }
117
+ export interface ToolExecuteStartEvent {
118
+ type: StreamEventType.TOOL_EXECUTE_START;
119
+ toolCallId: string;
120
+ name: string;
121
+ }
122
+ export interface ToolExecuteDoneEvent {
123
+ type: StreamEventType.TOOL_EXECUTE_DONE;
124
+ toolCallId: string;
125
+ name: string;
126
+ /** 工具执行结果 Message */
127
+ result: Message;
128
+ }
129
+ export interface ToolExecuteErrorEvent {
130
+ type: StreamEventType.TOOL_EXECUTE_ERROR;
131
+ toolCallId: string;
132
+ name: string;
133
+ error: Error;
134
+ /** 写回模型的错误结果;throw 策略下可能为空 */
135
+ result?: Message;
136
+ }
137
+ export interface MessageDoneEvent {
138
+ type: StreamEventType.MESSAGE_DONE;
139
+ /** 组装完成的 Message */
140
+ message: Message;
141
+ /** 模型完成原因,例如 stop / length / tool_calls */
142
+ finishReason?: FinishReason;
143
+ }
144
+ export interface TurnStartEvent {
145
+ type: StreamEventType.TURN_START;
146
+ /** 当前轮次(0-based) */
147
+ turn: number;
148
+ }
149
+ export interface TurnEndEvent {
150
+ type: StreamEventType.TURN_END;
151
+ /** 当前轮次 */
152
+ turn: number;
153
+ /** 本轮是否有工具调用 */
154
+ hasToolCalls: boolean;
155
+ }
156
+ export interface ErrorEvent {
157
+ type: StreamEventType.ERROR;
158
+ error: Error;
159
+ }
160
+ /**
161
+ * 流式事件联合类型
162
+ */
163
+ export type StreamEvent = ThinkingDeltaEvent | ThinkingDoneEvent | TextDeltaEvent | TextDoneEvent | ToolCallStartEvent | ToolCallDeltaEvent | ToolCallDoneEvent | ToolApprovalRequiredEvent | ToolApprovalAcceptedEvent | ToolApprovalRejectedEvent | ToolExecuteStartEvent | ToolExecuteDoneEvent | ToolExecuteErrorEvent | MessageDoneEvent | TurnStartEvent | TurnEndEvent | ErrorEvent;
164
+ /**
165
+ * 事件类型 → 事件数据结构的映射
166
+ *
167
+ * 用于 Agent.on() 的泛型推断,使注册特定事件时
168
+ * handler 参数自动推断为对应的事件类型。
169
+ *
170
+ * 例如:
171
+ *agent.on(StreamEventType.TEXT_DELTA, (e) => e.delta)
172
+ * // e自动推断为 TextDeltaEvent,可直接访问 .delta
173
+ */
174
+ export interface StreamEventMap {
175
+ [StreamEventType.THINKING_DELTA]: ThinkingDeltaEvent;
176
+ [StreamEventType.THINKING_DONE]: ThinkingDoneEvent;
177
+ [StreamEventType.TEXT_DELTA]: TextDeltaEvent;
178
+ [StreamEventType.TEXT_DONE]: TextDoneEvent;
179
+ [StreamEventType.TOOL_CALL_START]: ToolCallStartEvent;
180
+ [StreamEventType.TOOL_CALL_DELTA]: ToolCallDeltaEvent;
181
+ [StreamEventType.TOOL_CALL_DONE]: ToolCallDoneEvent;
182
+ [StreamEventType.TOOL_APPROVAL_REQUIRED]: ToolApprovalRequiredEvent;
183
+ [StreamEventType.TOOL_APPROVAL_ACCEPTED]: ToolApprovalAcceptedEvent;
184
+ [StreamEventType.TOOL_APPROVAL_REJECTED]: ToolApprovalRejectedEvent;
185
+ [StreamEventType.TOOL_EXECUTE_START]: ToolExecuteStartEvent;
186
+ [StreamEventType.TOOL_EXECUTE_DONE]: ToolExecuteDoneEvent;
187
+ [StreamEventType.TOOL_EXECUTE_ERROR]: ToolExecuteErrorEvent;
188
+ [StreamEventType.MESSAGE_DONE]: MessageDoneEvent;
189
+ [StreamEventType.TURN_START]: TurnStartEvent;
190
+ [StreamEventType.TURN_END]: TurnEndEvent;
191
+ [StreamEventType.ERROR]: ErrorEvent;
192
+ }
193
+ //# sourceMappingURL=StreamEvent.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StreamEvent.d.ts","sourceRoot":"","sources":["../../src/stream/StreamEvent.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.StreamEventType = void 0;
4
+ /**
5
+ * 流式事件类型枚举
6
+ */
7
+ var StreamEventType;
8
+ (function (StreamEventType) {
9
+ /** 思考/推理增量到达 */
10
+ StreamEventType["THINKING_DELTA"] = "thinking_delta";
11
+ /** 思考/推理流结束 */
12
+ StreamEventType["THINKING_DONE"] = "thinking_done";
13
+ /** 文本增量到达 */
14
+ StreamEventType["TEXT_DELTA"] = "text_delta";
15
+ /** 文本流结束 */
16
+ StreamEventType["TEXT_DONE"] = "text_done";
17
+ /** 工具调用开始(拿到 id + name) */
18
+ StreamEventType["TOOL_CALL_START"] = "tool_call_start";
19
+ /** 工具参数增量 */
20
+ StreamEventType["TOOL_CALL_DELTA"] = "tool_call_delta";
21
+ /** 单个工具调用完成(完整参数就绪) */
22
+ StreamEventType["TOOL_CALL_DONE"] = "tool_call_done";
23
+ /** 工具调用需要审批 */
24
+ StreamEventType["TOOL_APPROVAL_REQUIRED"] = "tool_approval_required";
25
+ /** 工具调用审批通过 */
26
+ StreamEventType["TOOL_APPROVAL_ACCEPTED"] = "tool_approval_accepted";
27
+ /** 工具调用审批拒绝 */
28
+ StreamEventType["TOOL_APPROVAL_REJECTED"] = "tool_approval_rejected";
29
+ /** 工具开始执行 */
30
+ StreamEventType["TOOL_EXECUTE_START"] = "tool_execute_start";
31
+ /** 工具执行完成 */
32
+ StreamEventType["TOOL_EXECUTE_DONE"] = "tool_execute_done";
33
+ /** 工具执行失败 */
34
+ StreamEventType["TOOL_EXECUTE_ERROR"] = "tool_execute_error";
35
+ /** 整条消息组装完毕 */
36
+ StreamEventType["MESSAGE_DONE"] = "message_done";
37
+ /** 新一轮循环开始 */
38
+ StreamEventType["TURN_START"] = "turn_start";
39
+ /** 一轮循环结束 */
40
+ StreamEventType["TURN_END"] = "turn_end";
41
+ /** 错误 */
42
+ StreamEventType["ERROR"] = "error";
43
+ })(StreamEventType || (exports.StreamEventType = StreamEventType = {}));
44
+ //# sourceMappingURL=StreamEvent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StreamEvent.js","sourceRoot":"","sources":["../../src/stream/StreamEvent.ts"],"names":[],"mappings":";;;AAWA;;GAEG;AACH,IAAY,eAmCX;AAnCD,WAAY,eAAe;IACzB,gBAAgB;IAChB,oDAAiC,CAAA;IACjC,eAAe;IACf,kDAA+B,CAAA;IAC/B,aAAa;IACb,4CAAyB,CAAA;IACzB,YAAY;IACZ,0CAAuB,CAAA;IACvB,2BAA2B;IAC3B,sDAAmC,CAAA;IACnC,aAAa;IACb,sDAAmC,CAAA;IACnC,uBAAuB;IACvB,oDAAiC,CAAA;IACjC,eAAe;IACf,oEAAiD,CAAA;IACjD,eAAe;IACf,oEAAiD,CAAA;IACjD,eAAe;IACf,oEAAiD,CAAA;IACjD,aAAa;IACb,4DAAyC,CAAA;IACzC,aAAa;IACb,0DAAuC,CAAA;IACvC,aAAa;IACb,4DAAyC,CAAA;IACzC,eAAe;IACf,gDAA6B,CAAA;IAC7B,cAAc;IACd,4CAAyB,CAAA;IACzB,aAAa;IACb,wCAAqB,CAAA;IACrB,SAAS;IACT,kCAAe,CAAA;AACjB,CAAC,EAnCW,eAAe,+BAAf,eAAe,QAmC1B"}
@@ -0,0 +1,47 @@
1
+ import { Message } from "../message/Message";
2
+ import { FinishReason, StreamEvent } from "./StreamEvent";
3
+ /**
4
+ * 流式解析器
5
+ *
6
+ * 将 OpenAI 流式 API 返回的一个个chunk 解析为结构化事件,
7
+ * 并最终组装成完整的 Message 对象。
8
+ *
9
+ * StreamParser 是纯粹的、无副作用的,不依赖 Session 或ToolKit。
10
+ *
11
+ * 用法:
12
+ *const parser = new StreamParser();
13
+ * for await (const chunk of stream) {
14
+ * const events = parser.feed(chunk);
15
+ * for (const event of events) { ... }
16
+ * }
17
+ *const finalEvents = parser.finish();
18
+ */
19
+ export declare class StreamParser {
20
+ private _thinkingBuffer;
21
+ private _textBuffer;
22
+ private _toolCalls;
23
+ private _finishReason?;
24
+ private _finished;
25
+ /**
26
+ * 喂入一个 OpenAI stream chunk,返回本次产出的事件
27
+ */
28
+ feed(chunk: any): StreamEvent[];
29
+ /**
30
+ * 通知流结束,产出最终事件(TEXT_DONE、TOOL_CALL_DONE、MESSAGE_DONE)
31
+ */
32
+ finish(): StreamEvent[];
33
+ /**
34
+ * 获取当前已组装的 Message 快照(随时可用)
35
+ */
36
+ get snapshot(): Message;
37
+ /** 模型完成原因,例如 stop / length / tool_calls */
38
+ get finishReason(): FinishReason | undefined;
39
+ /** 当前是否已累积任何 assistant 内容 */
40
+ get hasSnapshotContent(): boolean;
41
+ /**
42
+ * 重置解析器状态,可复用于下一轮
43
+ */
44
+ reset(): void;
45
+ private buildMessage;
46
+ }
47
+ //# sourceMappingURL=StreamParser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StreamParser.d.ts","sourceRoot":"","sources":["../../src/stream/StreamParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,OAAO,EACL,YAAY,EACZ,WAAW,EAEZ,MAAM,eAAe,CAAC;AAUvB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,aAAa,CAAC,CAAe;IACrC,OAAO,CAAC,SAAS,CAAkB;IAMnC;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,GAAG,GAAG,WAAW,EAAE;IAoG/B;;OAEG;IACH,MAAM,IAAI,WAAW,EAAE;IAgDvB;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,2CAA2C;IAC3C,IAAI,YAAY,IAAI,YAAY,GAAG,SAAS,CAE3C;IAED,6BAA6B;IAC7B,IAAI,kBAAkB,IAAI,OAAO,CAIhC;IAMD;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb,OAAO,CAAC,YAAY;CAyBrB"}
@@ -0,0 +1,225 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.StreamParser = void 0;
4
+ const Message_1 = require("../message/Message");
5
+ const Role_1 = require("../message/Role");
6
+ const StreamEvent_1 = require("./StreamEvent");
7
+ /**
8
+ * 流式解析器
9
+ *
10
+ * 将 OpenAI 流式 API 返回的一个个chunk 解析为结构化事件,
11
+ * 并最终组装成完整的 Message 对象。
12
+ *
13
+ * StreamParser 是纯粹的、无副作用的,不依赖 Session 或ToolKit。
14
+ *
15
+ * 用法:
16
+ *const parser = new StreamParser();
17
+ * for await (const chunk of stream) {
18
+ * const events = parser.feed(chunk);
19
+ * for (const event of events) { ... }
20
+ * }
21
+ *const finalEvents = parser.finish();
22
+ */
23
+ class StreamParser {
24
+ _thinkingBuffer = "";
25
+ _textBuffer = "";
26
+ _toolCalls = new Map();
27
+ _finishReason;
28
+ _finished = false;
29
+ //========================
30
+ //喂入Chunk
31
+ // ========================
32
+ /**
33
+ * 喂入一个 OpenAI stream chunk,返回本次产出的事件
34
+ */
35
+ feed(chunk) {
36
+ const events = [];
37
+ try {
38
+ const choices = chunk.choices;
39
+ if (!choices || choices.length === 0)
40
+ return events;
41
+ const choice = choices[0];
42
+ if (choice.finish_reason) {
43
+ this._finishReason = choice.finish_reason;
44
+ }
45
+ const delta = choice.delta;
46
+ if (!delta)
47
+ return events;
48
+ // ---- 思考/推理增量 ----
49
+ //兼容多种字段名:reasoning_content (DeepSeek/Qwen), thinking (Claude)
50
+ const thinkingDelta = delta.reasoning_content ?? delta.thinking ?? null;
51
+ if (thinkingDelta) {
52
+ this._thinkingBuffer += thinkingDelta;
53
+ events.push({
54
+ type: StreamEvent_1.StreamEventType.THINKING_DELTA,
55
+ delta: thinkingDelta,
56
+ snapshot: this._thinkingBuffer,
57
+ });
58
+ }
59
+ // ---- 文本增量 ----
60
+ if (delta.content) {
61
+ this._textBuffer += delta.content;
62
+ events.push({
63
+ type: StreamEvent_1.StreamEventType.TEXT_DELTA,
64
+ delta: delta.content,
65
+ snapshot: this._textBuffer,
66
+ });
67
+ }
68
+ // ---- 工具调用增量 ----
69
+ if (delta.tool_calls) {
70
+ for (const tc of delta.tool_calls) {
71
+ const index = tc.index ?? 0;
72
+ if (!this._toolCalls.has(index)) {
73
+ // 新的工具调用
74
+ this._toolCalls.set(index, {
75
+ id: tc.id || "",
76
+ name: tc.function?.name || "",
77
+ argsBuffer: tc.function?.arguments || "",
78
+ started: false,
79
+ });
80
+ }
81
+ else {
82
+ // 累积
83
+ const acc = this._toolCalls.get(index);
84
+ if (tc.id)
85
+ acc.id = tc.id;
86
+ if (tc.function?.name)
87
+ acc.name = tc.function.name;
88
+ if (tc.function?.arguments) {
89
+ acc.argsBuffer += tc.function.arguments;
90
+ }
91
+ }
92
+ const acc = this._toolCalls.get(index);
93
+ // 首次拿到 id + name时触发 START
94
+ if (!acc.started && acc.id && acc.name) {
95
+ acc.started = true;
96
+ events.push({
97
+ type: StreamEvent_1.StreamEventType.TOOL_CALL_START,
98
+ index,
99
+ toolCallId: acc.id,
100
+ name: acc.name,
101
+ });
102
+ }
103
+ // 参数增量
104
+ if (tc.function?.arguments) {
105
+ events.push({
106
+ type: StreamEvent_1.StreamEventType.TOOL_CALL_DELTA,
107
+ index,
108
+ argsDelta: tc.function.arguments,
109
+ argsSnapshot: acc.argsBuffer,
110
+ });
111
+ }
112
+ }
113
+ }
114
+ }
115
+ catch (e) {
116
+ events.push({
117
+ type: StreamEvent_1.StreamEventType.ERROR,
118
+ error: e instanceof Error ? e : new Error(String(e)),
119
+ });
120
+ }
121
+ return events;
122
+ }
123
+ // ========================
124
+ // 结束
125
+ // ========================
126
+ /**
127
+ * 通知流结束,产出最终事件(TEXT_DONE、TOOL_CALL_DONE、MESSAGE_DONE)
128
+ */
129
+ finish() {
130
+ if (this._finished)
131
+ return [];
132
+ this._finished = true;
133
+ const events = [];
134
+ // THINKING_DONE
135
+ if (this._thinkingBuffer.length > 0) {
136
+ events.push({
137
+ type: StreamEvent_1.StreamEventType.THINKING_DONE,
138
+ thinking: this._thinkingBuffer,
139
+ });
140
+ }
141
+ // TEXT_DONE
142
+ if (this._textBuffer.length > 0) {
143
+ events.push({
144
+ type: StreamEvent_1.StreamEventType.TEXT_DONE,
145
+ text: this._textBuffer,
146
+ });
147
+ }
148
+ // TOOL_CALL_DONE
149
+ for (const [index, acc] of this._toolCalls) {
150
+ events.push({
151
+ type: StreamEvent_1.StreamEventType.TOOL_CALL_DONE,
152
+ index,
153
+ toolCallId: acc.id,
154
+ name: acc.name,
155
+ arguments: acc.argsBuffer,
156
+ });
157
+ }
158
+ // MESSAGE_DONE
159
+ const message = this.buildMessage();
160
+ events.push({
161
+ type: StreamEvent_1.StreamEventType.MESSAGE_DONE,
162
+ message,
163
+ finishReason: this._finishReason,
164
+ });
165
+ return events;
166
+ }
167
+ // ========================
168
+ // 快照
169
+ // ========================
170
+ /**
171
+ * 获取当前已组装的 Message 快照(随时可用)
172
+ */
173
+ get snapshot() {
174
+ return this.buildMessage();
175
+ }
176
+ /** 模型完成原因,例如 stop / length / tool_calls */
177
+ get finishReason() {
178
+ return this._finishReason;
179
+ }
180
+ /** 当前是否已累积任何 assistant 内容 */
181
+ get hasSnapshotContent() {
182
+ return this._thinkingBuffer.length > 0 ||
183
+ this._textBuffer.length > 0 ||
184
+ this._toolCalls.size > 0;
185
+ }
186
+ // ========================
187
+ // 重置
188
+ // ========================
189
+ /**
190
+ * 重置解析器状态,可复用于下一轮
191
+ */
192
+ reset() {
193
+ this._thinkingBuffer = "";
194
+ this._textBuffer = "";
195
+ this._toolCalls.clear();
196
+ this._finishReason = undefined;
197
+ this._finished = false;
198
+ }
199
+ // ========================
200
+ // 内部
201
+ // ========================
202
+ buildMessage() {
203
+ const parts = [];
204
+ // 思考
205
+ if (this._thinkingBuffer.length > 0) {
206
+ parts.push({ type: "thinking", text: this._thinkingBuffer });
207
+ }
208
+ // 文本
209
+ if (this._textBuffer.length > 0) {
210
+ parts.push({ type: "text", text: this._textBuffer });
211
+ }
212
+ // 工具调用
213
+ for (const [, acc] of this._toolCalls) {
214
+ parts.push({
215
+ type: "tool_call",
216
+ toolCallId: acc.id,
217
+ name: acc.name,
218
+ arguments: acc.argsBuffer,
219
+ });
220
+ }
221
+ return new Message_1.Message(Role_1.Role.Assistant, parts);
222
+ }
223
+ }
224
+ exports.StreamParser = StreamParser;
225
+ //# sourceMappingURL=StreamParser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StreamParser.js","sourceRoot":"","sources":["../../src/stream/StreamParser.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ export { StreamEventType, FinishReason, StreamEvent, StreamEventMap, ThinkingDeltaEvent, ThinkingDoneEvent, TextDeltaEvent, TextDoneEvent, ToolCallStartEvent, ToolCallDeltaEvent, ToolCallDoneEvent, ToolApprovalRequiredEvent, ToolApprovalAcceptedEvent, ToolApprovalRejectedEvent, ToolExecuteStartEvent, ToolExecuteDoneEvent, ToolExecuteErrorEvent, MessageDoneEvent, TurnStartEvent, TurnEndEvent, ErrorEvent, } from "./StreamEvent";
2
+ export { StreamParser } from "./StreamParser";
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,YAAY,EACZ,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
@@ -0,0 +1,8 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.StreamParser = exports.StreamEventType = void 0;
4
+ var StreamEvent_1 = require("./StreamEvent");
5
+ Object.defineProperty(exports, "StreamEventType", { enumerable: true, get: function () { return StreamEvent_1.StreamEventType; } });
6
+ var StreamParser_1 = require("./StreamParser");
7
+ Object.defineProperty(exports, "StreamParser", { enumerable: true, get: function () { return StreamParser_1.StreamParser; } });
8
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":";;;AAAA,6CAsBuB;AArBrB,8GAAA,eAAe,OAAA;AAsBjB,+CAA8C;AAArC,4GAAA,YAAY,OAAA"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * 生命周期上下文
3
+ *
4
+ * 在钩子之间传递,贯穿整个工具调用生命周期。
5
+ * 钩子可以修改 arguments / result / cancelled 等字段来影响执行流程。
6
+ */
7
+ export declare class Context {
8
+ /** tool_call_id */
9
+ id: string;
10
+ /** 工具名 */
11
+ name: string;
12
+ /** 调用参数(钩子可修改) */
13
+ arguments: Record<string, unknown>;
14
+ /** 执行结果(钩子可改写) */
15
+ result?: unknown;
16
+ /** 执行异常 */
17
+ error?: Error;
18
+ /** 是否取消执行 */
19
+ cancelled: boolean;
20
+ /** 取消原因 */
21
+ cancelReason: string;
22
+ /** 中断信号:用于工具内部响应 Agent abort / timeout */
23
+ signal?: AbortSignal;
24
+ constructor(id: string, name: string, args: Record<string, unknown>, signal?: AbortSignal);
25
+ /** 如果已中断则抛出中断原因 */
26
+ throwIfAborted(): void;
27
+ /** 取消执行的便捷方法 */
28
+ cancel(reason: string): this;
29
+ }
30
+ //# sourceMappingURL=Context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../src/tool/Context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,mBAAmB;IACZ,EAAE,EAAE,MAAM,CAAC;IAElB,UAAU;IACH,IAAI,EAAE,MAAM,CAAC;IAEpB,kBAAkB;IACX,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE1C,kBAAkB;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IAExB,WAAW;IACJ,KAAK,CAAC,EAAE,KAAK,CAAC;IAErB,aAAa;IACN,SAAS,EAAE,OAAO,CAAS;IAElC,WAAW;IACJ,YAAY,EAAE,MAAM,CAAM;IAEjC,0CAA0C;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;gBAG1B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,WAAW;IAQtB,mBAAmB;IACnB,cAAc,IAAI,IAAI;IAOtB,gBAAgB;IAChB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAK7B"}
@@ -0,0 +1,50 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Context = void 0;
4
+ /**
5
+ * 生命周期上下文
6
+ *
7
+ * 在钩子之间传递,贯穿整个工具调用生命周期。
8
+ * 钩子可以修改 arguments / result / cancelled 等字段来影响执行流程。
9
+ */
10
+ class Context {
11
+ /** tool_call_id */
12
+ id;
13
+ /** 工具名 */
14
+ name;
15
+ /** 调用参数(钩子可修改) */
16
+ arguments;
17
+ /** 执行结果(钩子可改写) */
18
+ result;
19
+ /** 执行异常 */
20
+ error;
21
+ /** 是否取消执行 */
22
+ cancelled = false;
23
+ /** 取消原因 */
24
+ cancelReason = "";
25
+ /** 中断信号:用于工具内部响应 Agent abort / timeout */
26
+ signal;
27
+ constructor(id, name, args, signal) {
28
+ this.id = id;
29
+ this.name = name;
30
+ this.arguments = args;
31
+ this.signal = signal;
32
+ }
33
+ /** 如果已中断则抛出中断原因 */
34
+ throwIfAborted() {
35
+ if (!this.signal?.aborted)
36
+ return;
37
+ const reason = this.signal.reason;
38
+ if (reason instanceof Error)
39
+ throw reason;
40
+ throw new Error(reason !== undefined ? String(reason) : "Tool execution aborted");
41
+ }
42
+ /** 取消执行的便捷方法 */
43
+ cancel(reason) {
44
+ this.cancelled = true;
45
+ this.cancelReason = reason;
46
+ return this;
47
+ }
48
+ }
49
+ exports.Context = Context;
50
+ //# sourceMappingURL=Context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Context.js","sourceRoot":"","sources":["../../src/tool/Context.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,MAAa,OAAO;IAClB,mBAAmB;IACZ,EAAE,CAAS;IAElB,UAAU;IACH,IAAI,CAAS;IAEpB,kBAAkB;IACX,SAAS,CAA0B;IAE1C,kBAAkB;IACX,MAAM,CAAW;IAExB,WAAW;IACJ,KAAK,CAAS;IAErB,aAAa;IACN,SAAS,GAAY,KAAK,CAAC;IAElC,WAAW;IACJ,YAAY,GAAW,EAAE,CAAC;IAEjC,0CAA0C;IACnC,MAAM,CAAe;IAE5B,YACE,EAAU,EACV,IAAY,EACZ,IAA6B,EAC7B,MAAoB;QAEpB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,mBAAmB;IACnB,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO;YAAE,OAAO;QAClC,MAAM,MAAM,GAAI,IAAI,CAAC,MAA6C,CAAC,MAAM,CAAC;QAC1E,IAAI,MAAM,YAAY,KAAK;YAAE,MAAM,MAAM,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;IACpF,CAAC;IAED,gBAAgB;IAChB,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAnDD,0BAmDC"}