@notic/agent-engine 2.2.0 → 3.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.
- package/CHANGELOG.md +24 -1
- package/README.md +97 -449
- package/dist/agent/Agent.d.ts +132 -355
- package/dist/agent/Agent.d.ts.map +1 -1
- package/dist/agent/Agent.js +302 -1128
- package/dist/agent/Agent.js.map +1 -1
- package/dist/agent/index.d.ts +1 -1
- package/dist/agent/index.d.ts.map +1 -1
- package/dist/agent/index.js +15 -8
- package/dist/agent/index.js.map +1 -1
- package/dist/core/data.d.ts +17 -0
- package/dist/core/data.d.ts.map +1 -0
- package/dist/core/data.js +86 -0
- package/dist/core/data.js.map +1 -0
- package/dist/generator/Generator.d.ts +37 -0
- package/dist/generator/Generator.d.ts.map +1 -0
- package/dist/generator/Generator.js +71 -0
- package/dist/generator/Generator.js.map +1 -0
- package/dist/generator/index.d.ts +2 -0
- package/dist/generator/index.d.ts.map +1 -0
- package/dist/generator/index.js +18 -0
- package/dist/generator/index.js.map +1 -0
- package/dist/index.d.ts +7 -35
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +21 -94
- package/dist/index.js.map +1 -1
- package/dist/legacy/adapter/AnthropicAdapter.d.ts.map +1 -0
- package/dist/{adapter → legacy/adapter}/AnthropicAdapter.js +3 -3
- package/dist/legacy/adapter/AnthropicAdapter.js.map +1 -0
- package/dist/legacy/adapter/GeminiAdapter.d.ts.map +1 -0
- package/dist/{adapter → legacy/adapter}/GeminiAdapter.js +3 -3
- package/dist/legacy/adapter/GeminiAdapter.js.map +1 -0
- package/dist/legacy/adapter/MessageAdapter.d.ts.map +1 -0
- package/dist/legacy/adapter/MessageAdapter.js.map +1 -0
- package/dist/legacy/adapter/OpenAIAdapter.d.ts.map +1 -0
- package/dist/{adapter → legacy/adapter}/OpenAIAdapter.js +1 -1
- package/dist/legacy/adapter/OpenAIAdapter.js.map +1 -0
- package/dist/legacy/adapter/OpenAIResponsesAdapter.d.ts.map +1 -0
- package/dist/legacy/adapter/OpenAIResponsesAdapter.js.map +1 -0
- package/dist/legacy/adapter/index.d.ts.map +1 -0
- package/dist/legacy/adapter/index.js.map +1 -0
- package/dist/legacy/agent/Agent.d.ts +371 -0
- package/dist/legacy/agent/Agent.d.ts.map +1 -0
- package/dist/legacy/agent/Agent.js +1169 -0
- package/dist/legacy/agent/Agent.js.map +1 -0
- package/dist/legacy/agent/index.d.ts +2 -0
- package/dist/legacy/agent/index.d.ts.map +1 -0
- package/dist/legacy/agent/index.js +11 -0
- package/dist/legacy/agent/index.js.map +1 -0
- package/dist/legacy/client/ModelClient.d.ts.map +1 -0
- package/dist/legacy/client/ModelClient.js.map +1 -0
- package/dist/legacy/client/index.d.ts.map +1 -0
- package/dist/legacy/client/index.js.map +1 -0
- package/dist/legacy/config/RequestConfig.d.ts.map +1 -0
- package/dist/legacy/config/RequestConfig.js.map +1 -0
- package/dist/legacy/config/index.d.ts.map +1 -0
- package/dist/legacy/config/index.js.map +1 -0
- package/dist/legacy/index.d.ts +36 -0
- package/dist/legacy/index.d.ts.map +1 -0
- package/dist/legacy/index.js +97 -0
- package/dist/legacy/index.js.map +1 -0
- package/dist/legacy/media/BrowserMediaResolver.d.ts.map +1 -0
- package/dist/legacy/media/BrowserMediaResolver.js.map +1 -0
- package/dist/legacy/media/DefaultMediaResolver.d.ts.map +1 -0
- package/dist/legacy/media/DefaultMediaResolver.js.map +1 -0
- package/dist/legacy/media/MediaResolver.d.ts.map +1 -0
- package/dist/legacy/media/MediaResolver.js.map +1 -0
- package/dist/legacy/media/index.d.ts.map +1 -0
- package/dist/legacy/media/index.js.map +1 -0
- package/dist/legacy/message/Message.d.ts +147 -0
- package/dist/legacy/message/Message.d.ts.map +1 -0
- package/dist/legacy/message/Message.js +446 -0
- package/dist/legacy/message/Message.js.map +1 -0
- package/dist/legacy/message/MessagePart.d.ts +50 -0
- package/dist/legacy/message/MessagePart.d.ts.map +1 -0
- package/dist/legacy/message/MessagePart.js +6 -0
- package/dist/legacy/message/MessagePart.js.map +1 -0
- package/dist/legacy/message/Role.d.ts +10 -0
- package/dist/legacy/message/Role.d.ts.map +1 -0
- package/dist/legacy/message/Role.js +14 -0
- package/dist/legacy/message/Role.js.map +1 -0
- package/dist/legacy/message/Usage.d.ts.map +1 -0
- package/dist/legacy/message/Usage.js.map +1 -0
- package/dist/legacy/message/index.d.ts +5 -0
- package/dist/legacy/message/index.d.ts.map +1 -0
- package/dist/legacy/message/index.js +10 -0
- package/dist/legacy/message/index.js.map +1 -0
- package/dist/legacy/node.d.ts +3 -0
- package/dist/legacy/node.d.ts.map +1 -0
- package/dist/legacy/node.js +6 -0
- package/dist/legacy/node.js.map +1 -0
- package/dist/legacy/prompt/Injection.d.ts.map +1 -0
- package/dist/legacy/prompt/Injection.js.map +1 -0
- package/dist/legacy/prompt/PromptBuilder.d.ts +284 -0
- package/dist/legacy/prompt/PromptBuilder.d.ts.map +1 -0
- package/dist/legacy/prompt/PromptBuilder.js +491 -0
- package/dist/legacy/prompt/PromptBuilder.js.map +1 -0
- package/dist/legacy/prompt/Rule.d.ts.map +1 -0
- package/dist/legacy/prompt/Rule.js.map +1 -0
- package/dist/legacy/prompt/index.d.ts +4 -0
- package/dist/legacy/prompt/index.d.ts.map +1 -0
- package/dist/legacy/prompt/index.js +10 -0
- package/dist/legacy/prompt/index.js.map +1 -0
- package/dist/legacy/provider/Provider.d.ts +48 -0
- package/dist/legacy/provider/Provider.d.ts.map +1 -0
- package/dist/legacy/provider/Provider.js +73 -0
- package/dist/legacy/provider/Provider.js.map +1 -0
- package/dist/legacy/provider/index.d.ts +2 -0
- package/dist/legacy/provider/index.d.ts.map +1 -0
- package/dist/legacy/provider/index.js +10 -0
- package/dist/legacy/provider/index.js.map +1 -0
- package/dist/legacy/session/AgentSession.d.ts +13 -0
- package/dist/legacy/session/AgentSession.d.ts.map +1 -0
- package/dist/legacy/session/AgentSession.js +3 -0
- package/dist/legacy/session/AgentSession.js.map +1 -0
- package/dist/legacy/session/Inserter.d.ts.map +1 -0
- package/dist/legacy/session/Inserter.js.map +1 -0
- package/dist/legacy/session/ListSession.d.ts +64 -0
- package/dist/legacy/session/ListSession.d.ts.map +1 -0
- package/dist/legacy/session/ListSession.js +251 -0
- package/dist/legacy/session/ListSession.js.map +1 -0
- package/dist/legacy/session/Paginator.d.ts.map +1 -0
- package/dist/legacy/session/Paginator.js.map +1 -0
- package/dist/legacy/session/Query.d.ts.map +1 -0
- package/dist/legacy/session/Query.js.map +1 -0
- package/dist/legacy/session/SearchCriteria.d.ts.map +1 -0
- package/dist/legacy/session/SearchCriteria.js.map +1 -0
- package/dist/legacy/session/Session.d.ts.map +1 -0
- package/dist/legacy/session/Session.js.map +1 -0
- package/dist/legacy/session/index.d.ts +9 -0
- package/dist/legacy/session/index.d.ts.map +1 -0
- package/dist/legacy/session/index.js +17 -0
- package/dist/legacy/session/index.js.map +1 -0
- package/dist/legacy/session/matchUtils.d.ts.map +1 -0
- package/dist/legacy/session/matchUtils.js.map +1 -0
- package/dist/legacy/stream/AnthropicStreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/AnthropicStreamParser.js.map +1 -0
- package/dist/legacy/stream/GeminiStreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/GeminiStreamParser.js.map +1 -0
- package/dist/legacy/stream/MessageStreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/MessageStreamParser.js.map +1 -0
- package/dist/legacy/stream/OpenAIResponsesStreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/OpenAIResponsesStreamParser.js.map +1 -0
- package/dist/legacy/stream/StreamEvent.d.ts.map +1 -0
- package/dist/legacy/stream/StreamEvent.js.map +1 -0
- package/dist/legacy/stream/StreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/StreamParser.js.map +1 -0
- package/dist/legacy/stream/index.d.ts.map +1 -0
- package/dist/legacy/stream/index.js.map +1 -0
- package/dist/legacy/tool/Context.d.ts.map +1 -0
- package/dist/legacy/tool/Context.js.map +1 -0
- package/dist/legacy/tool/Hook.d.ts.map +1 -0
- package/dist/legacy/tool/Hook.js.map +1 -0
- package/dist/legacy/tool/McpToolAdapter.d.ts.map +1 -0
- package/dist/legacy/tool/McpToolAdapter.js.map +1 -0
- package/dist/legacy/tool/Param.d.ts.map +1 -0
- package/dist/legacy/tool/Param.js.map +1 -0
- package/dist/legacy/tool/Tool.d.ts +92 -0
- package/dist/legacy/tool/Tool.d.ts.map +1 -0
- package/dist/legacy/tool/Tool.js +198 -0
- package/dist/legacy/tool/Tool.js.map +1 -0
- package/dist/legacy/tool/ToolCall.d.ts.map +1 -0
- package/dist/legacy/tool/ToolCall.js.map +1 -0
- package/dist/legacy/tool/ToolKit.d.ts +91 -0
- package/dist/legacy/tool/ToolKit.d.ts.map +1 -0
- package/dist/legacy/tool/ToolKit.js +209 -0
- package/dist/legacy/tool/ToolKit.js.map +1 -0
- package/dist/legacy/tool/ValueType.d.ts.map +1 -0
- package/dist/legacy/tool/ValueType.js.map +1 -0
- package/dist/legacy/tool/index.d.ts +9 -0
- package/dist/legacy/tool/index.d.ts.map +1 -0
- package/dist/legacy/tool/index.js +22 -0
- package/dist/legacy/tool/index.js.map +1 -0
- package/dist/legacy/utils/generateId.d.ts.map +1 -0
- package/dist/legacy/utils/generateId.js.map +1 -0
- package/dist/legacy/utils/index.d.ts.map +1 -0
- package/dist/legacy/utils/index.js.map +1 -0
- package/dist/message/Message.d.ts +90 -135
- package/dist/message/Message.d.ts.map +1 -1
- package/dist/message/Message.js +195 -414
- package/dist/message/Message.js.map +1 -1
- package/dist/message/MessagePart.d.ts +7 -1
- package/dist/message/MessagePart.d.ts.map +1 -1
- package/dist/message/MessagePart.js +0 -3
- package/dist/message/MessagePart.js.map +1 -1
- package/dist/message/Role.d.ts.map +1 -1
- package/dist/message/Role.js.map +1 -1
- package/dist/message/index.d.ts +1 -4
- package/dist/message/index.d.ts.map +1 -1
- package/dist/message/index.js +15 -7
- package/dist/message/index.js.map +1 -1
- package/dist/node.d.ts +1 -2
- package/dist/node.d.ts.map +1 -1
- package/dist/node.js +1 -1
- package/dist/node.js.map +1 -1
- package/dist/prompt/PromptBuilder.d.ts +43 -278
- package/dist/prompt/PromptBuilder.d.ts.map +1 -1
- package/dist/prompt/PromptBuilder.js +71 -473
- package/dist/prompt/PromptBuilder.js.map +1 -1
- package/dist/prompt/index.d.ts +1 -3
- package/dist/prompt/index.d.ts.map +1 -1
- package/dist/prompt/index.js +15 -7
- package/dist/prompt/index.js.map +1 -1
- package/dist/provider/HttpProvider.d.ts +32 -0
- package/dist/provider/HttpProvider.d.ts.map +1 -0
- package/dist/provider/HttpProvider.js +160 -0
- package/dist/provider/HttpProvider.js.map +1 -0
- package/dist/provider/Provider.d.ts +125 -45
- package/dist/provider/Provider.d.ts.map +1 -1
- package/dist/provider/Provider.js +77 -58
- package/dist/provider/Provider.js.map +1 -1
- package/dist/provider/capabilities.d.ts +108 -0
- package/dist/provider/capabilities.d.ts.map +1 -0
- package/dist/provider/capabilities.js +10 -0
- package/dist/provider/capabilities.js.map +1 -0
- package/dist/provider/index.d.ts +7 -1
- package/dist/provider/index.d.ts.map +1 -1
- package/dist/provider/index.js +23 -7
- package/dist/provider/index.js.map +1 -1
- package/dist/provider/media.d.ts +9 -0
- package/dist/provider/media.d.ts.map +1 -0
- package/dist/provider/media.js +3 -0
- package/dist/provider/media.js.map +1 -0
- package/dist/provider/transport.d.ts +10 -0
- package/dist/provider/transport.d.ts.map +1 -0
- package/dist/provider/transport.js +121 -0
- package/dist/provider/transport.js.map +1 -0
- package/dist/session/AgentSession.d.ts +14 -11
- package/dist/session/AgentSession.d.ts.map +1 -1
- package/dist/session/AgentSession.js +21 -0
- package/dist/session/AgentSession.js.map +1 -1
- package/dist/session/BaseSession.d.ts +49 -0
- package/dist/session/BaseSession.d.ts.map +1 -0
- package/dist/session/BaseSession.js +147 -0
- package/dist/session/BaseSession.js.map +1 -0
- package/dist/session/ListSession.d.ts +37 -55
- package/dist/session/ListSession.d.ts.map +1 -1
- package/dist/session/ListSession.js +175 -221
- package/dist/session/ListSession.js.map +1 -1
- package/dist/session/SessionQuery.d.ts +31 -0
- package/dist/session/SessionQuery.d.ts.map +1 -0
- package/dist/session/SessionQuery.js +67 -0
- package/dist/session/SessionQuery.js.map +1 -0
- package/dist/session/TreeSession.d.ts +24 -0
- package/dist/session/TreeSession.d.ts.map +1 -0
- package/dist/session/TreeSession.js +122 -0
- package/dist/session/TreeSession.js.map +1 -0
- package/dist/session/continuation.d.ts +9 -0
- package/dist/session/continuation.d.ts.map +1 -0
- package/dist/session/continuation.js +48 -0
- package/dist/session/continuation.js.map +1 -0
- package/dist/session/index.d.ts +10 -8
- package/dist/session/index.d.ts.map +1 -1
- package/dist/session/index.js +24 -14
- package/dist/session/index.js.map +1 -1
- package/dist/session/restoreSession.d.ts +4 -0
- package/dist/session/restoreSession.d.ts.map +1 -0
- package/dist/session/restoreSession.js +12 -0
- package/dist/session/restoreSession.js.map +1 -0
- package/dist/session/structures.d.ts +32 -0
- package/dist/session/structures.d.ts.map +1 -0
- package/dist/session/structures.js +3 -0
- package/dist/session/structures.js.map +1 -0
- package/dist/session/trace.d.ts +73 -0
- package/dist/session/trace.d.ts.map +1 -0
- package/dist/session/trace.js +90 -0
- package/dist/session/trace.js.map +1 -0
- package/dist/session/types.d.ts +76 -0
- package/dist/session/types.d.ts.map +1 -0
- package/dist/session/types.js +12 -0
- package/dist/session/types.js.map +1 -0
- package/dist/tool/Tool.d.ts +26 -89
- package/dist/tool/Tool.d.ts.map +1 -1
- package/dist/tool/Tool.js +38 -185
- package/dist/tool/Tool.js.map +1 -1
- package/dist/tool/ToolExecutor.d.ts +59 -0
- package/dist/tool/ToolExecutor.d.ts.map +1 -0
- package/dist/tool/ToolExecutor.js +128 -0
- package/dist/tool/ToolExecutor.js.map +1 -0
- package/dist/tool/ToolKit.d.ts +17 -77
- package/dist/tool/ToolKit.d.ts.map +1 -1
- package/dist/tool/ToolKit.js +29 -189
- package/dist/tool/ToolKit.js.map +1 -1
- package/dist/tool/index.d.ts +4 -8
- package/dist/tool/index.d.ts.map +1 -1
- package/dist/tool/index.js +17 -19
- package/dist/tool/index.js.map +1 -1
- package/docs/API-2.x.md +1827 -0
- package/docs/API.md +248 -1825
- package/docs/CE-FEEDBACK-3.0.md +148 -0
- package/docs/CHARACTEREDITOR-3.0-NOTES.md +156 -0
- package/docs/DATA-MODEL-3.0.md +248 -0
- package/docs/DESIGN-3.0.md +326 -0
- package/docs/MIGRATION-3.0.md +77 -0
- package/docs/MULTIMEDIA-3.0.md +145 -0
- package/docs/PLAN-3.0.md +121 -0
- package/package.json +37 -26
- package/dist/adapter/AnthropicAdapter.d.ts.map +0 -1
- package/dist/adapter/AnthropicAdapter.js.map +0 -1
- package/dist/adapter/GeminiAdapter.d.ts.map +0 -1
- package/dist/adapter/GeminiAdapter.js.map +0 -1
- package/dist/adapter/MessageAdapter.d.ts.map +0 -1
- package/dist/adapter/MessageAdapter.js.map +0 -1
- package/dist/adapter/OpenAIAdapter.d.ts.map +0 -1
- package/dist/adapter/OpenAIAdapter.js.map +0 -1
- package/dist/adapter/OpenAIResponsesAdapter.d.ts.map +0 -1
- package/dist/adapter/OpenAIResponsesAdapter.js.map +0 -1
- package/dist/adapter/index.d.ts.map +0 -1
- package/dist/adapter/index.js.map +0 -1
- package/dist/client/ModelClient.d.ts.map +0 -1
- package/dist/client/ModelClient.js.map +0 -1
- package/dist/client/index.d.ts.map +0 -1
- package/dist/client/index.js.map +0 -1
- package/dist/config/RequestConfig.d.ts.map +0 -1
- package/dist/config/RequestConfig.js.map +0 -1
- package/dist/config/index.d.ts.map +0 -1
- package/dist/config/index.js.map +0 -1
- package/dist/media/BrowserMediaResolver.d.ts.map +0 -1
- package/dist/media/BrowserMediaResolver.js.map +0 -1
- package/dist/media/DefaultMediaResolver.d.ts.map +0 -1
- package/dist/media/DefaultMediaResolver.js.map +0 -1
- package/dist/media/MediaResolver.d.ts.map +0 -1
- package/dist/media/MediaResolver.js.map +0 -1
- package/dist/media/index.d.ts.map +0 -1
- package/dist/media/index.js.map +0 -1
- package/dist/message/Usage.d.ts.map +0 -1
- package/dist/message/Usage.js.map +0 -1
- package/dist/prompt/Injection.d.ts.map +0 -1
- package/dist/prompt/Injection.js.map +0 -1
- package/dist/prompt/Rule.d.ts.map +0 -1
- package/dist/prompt/Rule.js.map +0 -1
- package/dist/session/Inserter.d.ts.map +0 -1
- package/dist/session/Inserter.js.map +0 -1
- package/dist/session/Paginator.d.ts.map +0 -1
- package/dist/session/Paginator.js.map +0 -1
- package/dist/session/Query.d.ts.map +0 -1
- package/dist/session/Query.js.map +0 -1
- package/dist/session/SearchCriteria.d.ts.map +0 -1
- package/dist/session/SearchCriteria.js.map +0 -1
- package/dist/session/Session.d.ts.map +0 -1
- package/dist/session/Session.js.map +0 -1
- package/dist/session/matchUtils.d.ts.map +0 -1
- package/dist/session/matchUtils.js.map +0 -1
- package/dist/stream/AnthropicStreamParser.d.ts.map +0 -1
- package/dist/stream/AnthropicStreamParser.js.map +0 -1
- package/dist/stream/GeminiStreamParser.d.ts.map +0 -1
- package/dist/stream/GeminiStreamParser.js.map +0 -1
- package/dist/stream/MessageStreamParser.d.ts.map +0 -1
- package/dist/stream/MessageStreamParser.js.map +0 -1
- package/dist/stream/OpenAIResponsesStreamParser.d.ts.map +0 -1
- package/dist/stream/OpenAIResponsesStreamParser.js.map +0 -1
- package/dist/stream/StreamEvent.d.ts.map +0 -1
- package/dist/stream/StreamEvent.js.map +0 -1
- package/dist/stream/StreamParser.d.ts.map +0 -1
- package/dist/stream/StreamParser.js.map +0 -1
- package/dist/stream/index.d.ts.map +0 -1
- package/dist/stream/index.js.map +0 -1
- package/dist/tool/Context.d.ts.map +0 -1
- package/dist/tool/Context.js.map +0 -1
- package/dist/tool/Hook.d.ts.map +0 -1
- package/dist/tool/Hook.js.map +0 -1
- package/dist/tool/McpToolAdapter.d.ts.map +0 -1
- package/dist/tool/McpToolAdapter.js.map +0 -1
- package/dist/tool/Param.d.ts.map +0 -1
- package/dist/tool/Param.js.map +0 -1
- package/dist/tool/ToolCall.d.ts.map +0 -1
- package/dist/tool/ToolCall.js.map +0 -1
- package/dist/tool/ValueType.d.ts.map +0 -1
- package/dist/tool/ValueType.js.map +0 -1
- package/dist/utils/generateId.d.ts.map +0 -1
- package/dist/utils/generateId.js.map +0 -1
- package/dist/utils/index.d.ts.map +0 -1
- package/dist/utils/index.js.map +0 -1
- /package/dist/{adapter → legacy/adapter}/AnthropicAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/GeminiAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/MessageAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/MessageAdapter.js +0 -0
- /package/dist/{adapter → legacy/adapter}/OpenAIAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/OpenAIResponsesAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/OpenAIResponsesAdapter.js +0 -0
- /package/dist/{adapter → legacy/adapter}/index.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/index.js +0 -0
- /package/dist/{client → legacy/client}/ModelClient.d.ts +0 -0
- /package/dist/{client → legacy/client}/ModelClient.js +0 -0
- /package/dist/{client → legacy/client}/index.d.ts +0 -0
- /package/dist/{client → legacy/client}/index.js +0 -0
- /package/dist/{config → legacy/config}/RequestConfig.d.ts +0 -0
- /package/dist/{config → legacy/config}/RequestConfig.js +0 -0
- /package/dist/{config → legacy/config}/index.d.ts +0 -0
- /package/dist/{config → legacy/config}/index.js +0 -0
- /package/dist/{media → legacy/media}/BrowserMediaResolver.d.ts +0 -0
- /package/dist/{media → legacy/media}/BrowserMediaResolver.js +0 -0
- /package/dist/{media → legacy/media}/DefaultMediaResolver.d.ts +0 -0
- /package/dist/{media → legacy/media}/DefaultMediaResolver.js +0 -0
- /package/dist/{media → legacy/media}/MediaResolver.d.ts +0 -0
- /package/dist/{media → legacy/media}/MediaResolver.js +0 -0
- /package/dist/{media → legacy/media}/index.d.ts +0 -0
- /package/dist/{media → legacy/media}/index.js +0 -0
- /package/dist/{message → legacy/message}/Usage.d.ts +0 -0
- /package/dist/{message → legacy/message}/Usage.js +0 -0
- /package/dist/{prompt → legacy/prompt}/Injection.d.ts +0 -0
- /package/dist/{prompt → legacy/prompt}/Injection.js +0 -0
- /package/dist/{prompt → legacy/prompt}/Rule.d.ts +0 -0
- /package/dist/{prompt → legacy/prompt}/Rule.js +0 -0
- /package/dist/{session → legacy/session}/Inserter.d.ts +0 -0
- /package/dist/{session → legacy/session}/Inserter.js +0 -0
- /package/dist/{session → legacy/session}/Paginator.d.ts +0 -0
- /package/dist/{session → legacy/session}/Paginator.js +0 -0
- /package/dist/{session → legacy/session}/Query.d.ts +0 -0
- /package/dist/{session → legacy/session}/Query.js +0 -0
- /package/dist/{session → legacy/session}/SearchCriteria.d.ts +0 -0
- /package/dist/{session → legacy/session}/SearchCriteria.js +0 -0
- /package/dist/{session → legacy/session}/Session.d.ts +0 -0
- /package/dist/{session → legacy/session}/Session.js +0 -0
- /package/dist/{session → legacy/session}/matchUtils.d.ts +0 -0
- /package/dist/{session → legacy/session}/matchUtils.js +0 -0
- /package/dist/{stream → legacy/stream}/AnthropicStreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/AnthropicStreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/GeminiStreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/GeminiStreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/MessageStreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/MessageStreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/OpenAIResponsesStreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/OpenAIResponsesStreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/StreamEvent.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/StreamEvent.js +0 -0
- /package/dist/{stream → legacy/stream}/StreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/StreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/index.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/index.js +0 -0
- /package/dist/{tool → legacy/tool}/Context.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/Context.js +0 -0
- /package/dist/{tool → legacy/tool}/Hook.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/Hook.js +0 -0
- /package/dist/{tool → legacy/tool}/McpToolAdapter.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/McpToolAdapter.js +0 -0
- /package/dist/{tool → legacy/tool}/Param.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/Param.js +0 -0
- /package/dist/{tool → legacy/tool}/ToolCall.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/ToolCall.js +0 -0
- /package/dist/{tool → legacy/tool}/ValueType.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/ValueType.js +0 -0
- /package/dist/{utils → legacy/utils}/generateId.d.ts +0 -0
- /package/dist/{utils → legacy/utils}/generateId.js +0 -0
- /package/dist/{utils → legacy/utils}/index.d.ts +0 -0
- /package/dist/{utils → legacy/utils}/index.js +0 -0
|
@@ -0,0 +1,1169 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.Agent = exports.AgentToolApprovalTimeoutError = exports.AgentToolApprovalError = exports.AgentAlreadyRunningError = exports.AgentTimeoutError = exports.AgentAbortError = void 0;
|
|
4
|
+
const Message_1 = require("../message/Message");
|
|
5
|
+
const Role_1 = require("../message/Role");
|
|
6
|
+
const OpenAIAdapter_1 = require("../adapter/OpenAIAdapter");
|
|
7
|
+
const ToolKit_1 = require("../tool/ToolKit");
|
|
8
|
+
const StreamParser_1 = require("../stream/StreamParser");
|
|
9
|
+
const StreamEvent_1 = require("../stream/StreamEvent");
|
|
10
|
+
const utils_1 = require("../utils");
|
|
11
|
+
const client_1 = require("../client");
|
|
12
|
+
/** Agent 主动中断错误 */
|
|
13
|
+
class AgentAbortError extends Error {
|
|
14
|
+
cause;
|
|
15
|
+
constructor(message = "Agent run aborted", cause) {
|
|
16
|
+
super(message);
|
|
17
|
+
this.name = "AbortError";
|
|
18
|
+
this.cause = cause;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
exports.AgentAbortError = AgentAbortError;
|
|
22
|
+
/** Agent 超时错误 */
|
|
23
|
+
class AgentTimeoutError extends Error {
|
|
24
|
+
constructor(timeoutMs) {
|
|
25
|
+
super(`Agent run timed out after ${timeoutMs}ms`);
|
|
26
|
+
this.name = "TimeoutError";
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
exports.AgentTimeoutError = AgentTimeoutError;
|
|
30
|
+
/** 同一个 Agent 实例不允许同时运行多个任务 */
|
|
31
|
+
class AgentAlreadyRunningError extends Error {
|
|
32
|
+
constructor() {
|
|
33
|
+
super("Agent 已有运行中的任务,请等待完成或先中断当前任务");
|
|
34
|
+
this.name = "AgentAlreadyRunningError";
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
exports.AgentAlreadyRunningError = AgentAlreadyRunningError;
|
|
38
|
+
/** 工具审批函数执行失败 */
|
|
39
|
+
class AgentToolApprovalError extends Error {
|
|
40
|
+
request;
|
|
41
|
+
cause;
|
|
42
|
+
constructor(request, cause) {
|
|
43
|
+
const message = cause instanceof Error ? cause.message : String(cause);
|
|
44
|
+
super(`工具审批失败 [${request.name}]: ${message}`);
|
|
45
|
+
this.name = "ToolApprovalError";
|
|
46
|
+
this.request = request;
|
|
47
|
+
this.cause = cause;
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
exports.AgentToolApprovalError = AgentToolApprovalError;
|
|
51
|
+
/** 等待手动工具审批超时 */
|
|
52
|
+
class AgentToolApprovalTimeoutError extends Error {
|
|
53
|
+
request;
|
|
54
|
+
timeoutMs;
|
|
55
|
+
constructor(request, timeoutMs) {
|
|
56
|
+
super(`工具审批超时 [${request.name}]: ${timeoutMs}ms`);
|
|
57
|
+
this.name = "ToolApprovalTimeoutError";
|
|
58
|
+
this.request = request;
|
|
59
|
+
this.timeoutMs = timeoutMs;
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
exports.AgentToolApprovalTimeoutError = AgentToolApprovalTimeoutError;
|
|
63
|
+
/** 默认 handler 错误处理器 */
|
|
64
|
+
const defaultHandlerErrorHandler = (error, event) => {
|
|
65
|
+
// eslint-disable-next-line no-console
|
|
66
|
+
console.error(`[AgentEngine] Event handler error [${event.type}]:`, error);
|
|
67
|
+
};
|
|
68
|
+
/**
|
|
69
|
+
* 智能体 — 自动循环层
|
|
70
|
+
*
|
|
71
|
+
* 串联Session + Adapter + ToolKit + StreamParser,
|
|
72
|
+
* 实现流式调用→ 解析 → 工具执行 → 再调用的自动循环。
|
|
73
|
+
*
|
|
74
|
+
* 用法:
|
|
75
|
+
*const agent = new Agent({ client, model, session, toolkit });
|
|
76
|
+
* agent
|
|
77
|
+
* .on(StreamEventType.TEXT_DELTA, (e) => process.stdout.write(e.delta))
|
|
78
|
+
* .on(StreamEventType.TOOL_CALL_START, (e) => console.log(`🔧 ${e.name}`));
|
|
79
|
+
*
|
|
80
|
+
* const reply = await agent.run("北京天气怎么样?");
|
|
81
|
+
*/
|
|
82
|
+
class Agent {
|
|
83
|
+
_client;
|
|
84
|
+
_model;
|
|
85
|
+
_adapter;
|
|
86
|
+
_parserFactory;
|
|
87
|
+
_toolkit;
|
|
88
|
+
_session;
|
|
89
|
+
_promptBuilder;
|
|
90
|
+
_maxTurns;
|
|
91
|
+
_config;
|
|
92
|
+
_requestOptions;
|
|
93
|
+
_toolApproval;
|
|
94
|
+
_toolApprovalMode;
|
|
95
|
+
_toolApprovalTimeoutMs;
|
|
96
|
+
_toolApprovalTimeoutPolicy;
|
|
97
|
+
_toolErrorPolicy;
|
|
98
|
+
_pendingApprovals = new Map();
|
|
99
|
+
_handlers = new Map();
|
|
100
|
+
_activeAbortController;
|
|
101
|
+
_lastRunState;
|
|
102
|
+
_handlerErrorHandler = defaultHandlerErrorHandler;
|
|
103
|
+
constructor(options) {
|
|
104
|
+
const client = options.client
|
|
105
|
+
? (0, client_1.toModelClient)(options.client)
|
|
106
|
+
: options.provider?.client;
|
|
107
|
+
if (!client) {
|
|
108
|
+
throw new Error("Agent requires either client or provider");
|
|
109
|
+
}
|
|
110
|
+
this._client = client;
|
|
111
|
+
this._model = options.model;
|
|
112
|
+
this._adapter = options.adapter ?? options.provider?.adapter ?? new OpenAIAdapter_1.OpenAIAdapter();
|
|
113
|
+
this._parserFactory = options.parserFactory
|
|
114
|
+
?? options.provider?.parserFactory
|
|
115
|
+
?? (() => new StreamParser_1.StreamParser());
|
|
116
|
+
this._toolkit = options.toolkit;
|
|
117
|
+
this._session = options.session;
|
|
118
|
+
this._promptBuilder = options.promptBuilder;
|
|
119
|
+
this._config = options.config;
|
|
120
|
+
this._maxTurns = options.maxTurns ?? 10;
|
|
121
|
+
this._requestOptions = options.requestOptions ?? {};
|
|
122
|
+
this._toolApproval = options.toolApproval;
|
|
123
|
+
this._toolApprovalMode = options.toolApprovalMode ?? "auto";
|
|
124
|
+
this._toolApprovalTimeoutMs = options.toolApprovalTimeoutMs;
|
|
125
|
+
this._toolApprovalTimeoutPolicy = options.toolApprovalTimeoutPolicy ?? "reject";
|
|
126
|
+
this._toolErrorPolicy = options.toolErrorPolicy ?? "return_to_model";
|
|
127
|
+
// 初始化所有事件的handler列表
|
|
128
|
+
for (const type of Object.values(StreamEvent_1.StreamEventType)) {
|
|
129
|
+
this._handlers.set(type, []);
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
on(event, handler) {
|
|
133
|
+
const events = Array.isArray(event) ? event : [event];
|
|
134
|
+
for (const e of events) {
|
|
135
|
+
if (!this._handlers.has(e)) {
|
|
136
|
+
this._handlers.set(e, []);
|
|
137
|
+
}
|
|
138
|
+
this._handlers.get(e).push(handler);
|
|
139
|
+
}
|
|
140
|
+
return this;
|
|
141
|
+
}
|
|
142
|
+
off(event, handler) {
|
|
143
|
+
const handlers = this._handlers.get(event);
|
|
144
|
+
if (handlers) {
|
|
145
|
+
const index = handlers.indexOf(handler);
|
|
146
|
+
if (index !== -1)
|
|
147
|
+
handlers.splice(index, 1);
|
|
148
|
+
}
|
|
149
|
+
return this;
|
|
150
|
+
}
|
|
151
|
+
once(event, handler) {
|
|
152
|
+
const wrapper = (e) => {
|
|
153
|
+
this.off(event, wrapper);
|
|
154
|
+
return handler(e);
|
|
155
|
+
};
|
|
156
|
+
return this.on(event, wrapper);
|
|
157
|
+
}
|
|
158
|
+
/**
|
|
159
|
+
* 移除指定事件的所有监听器,不传参则移除所有事件的所有监听器
|
|
160
|
+
*/
|
|
161
|
+
removeAllListeners(event) {
|
|
162
|
+
if (event) {
|
|
163
|
+
this._handlers.set(event, []);
|
|
164
|
+
}
|
|
165
|
+
else {
|
|
166
|
+
for (const key of this._handlers.keys()) {
|
|
167
|
+
this._handlers.set(key, []);
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
return this;
|
|
171
|
+
}
|
|
172
|
+
// ========================
|
|
173
|
+
// 运行
|
|
174
|
+
// ========================
|
|
175
|
+
/**
|
|
176
|
+
* 流式运行 — 最常用的入口
|
|
177
|
+
*
|
|
178
|
+
* 自动addUser → 循环(stream → parse → toolCall → execute) → addAssistant
|
|
179
|
+
*
|
|
180
|
+
* @param content 用户输入
|
|
181
|
+
* @param options 临时覆盖的请求参数
|
|
182
|
+
* @returns 最终的Assistant Message
|
|
183
|
+
*/
|
|
184
|
+
async run(content, options) {
|
|
185
|
+
const userMsg = Message_1.Message.user(content);
|
|
186
|
+
return this.runWith(userMsg, options);
|
|
187
|
+
}
|
|
188
|
+
/**
|
|
189
|
+
* 传入已构建的 Message 运行
|
|
190
|
+
*
|
|
191
|
+
* 直接将完整的 Message 对象追加到 Session,
|
|
192
|
+
* 保留其所有 parts(多模态内容)、tags、metadata。
|
|
193
|
+
*/
|
|
194
|
+
async runWith(message, options) {
|
|
195
|
+
this.ensureIdle();
|
|
196
|
+
this._session.addMessage(message);
|
|
197
|
+
return this.executeLoop(options);
|
|
198
|
+
}
|
|
199
|
+
/**
|
|
200
|
+
* 基于当前 Session 直接生成 Assistant,不自动追加新的 User 消息。
|
|
201
|
+
* 适合调用方已经通过 Session、Inserter 或 PromptBuilder 准备好上下文的场景。
|
|
202
|
+
*/
|
|
203
|
+
async generate(options) {
|
|
204
|
+
this.ensureIdle();
|
|
205
|
+
return this.executeLoop(options);
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* 直接传入历史运行(不走Session)
|
|
209
|
+
*/
|
|
210
|
+
async runRaw(messages, options) {
|
|
211
|
+
this.ensureIdle();
|
|
212
|
+
const run = this.prepareRunOptions(options);
|
|
213
|
+
try {
|
|
214
|
+
this.throwIfAborted(run.signal);
|
|
215
|
+
const configParams = this._config ? this._config.build() : {};
|
|
216
|
+
const mergedOptions = { ...configParams, ...this._requestOptions, ...run.requestOptions };
|
|
217
|
+
const requestParams = await this.buildModelRequest(messages, mergedOptions, run);
|
|
218
|
+
if (!run.stream) {
|
|
219
|
+
const { assistantMsg } = await this.executeCompleteRequest(requestParams, run);
|
|
220
|
+
return assistantMsg;
|
|
221
|
+
}
|
|
222
|
+
const parser = this._parserFactory();
|
|
223
|
+
const stream = await this.raceWithAbort(this._client.stream(requestParams, this.createClientOptions(run.signal)), run.signal);
|
|
224
|
+
for await (const chunk of stream) {
|
|
225
|
+
this.throwIfAborted(run.signal);
|
|
226
|
+
const events = parser.feed(chunk);
|
|
227
|
+
this.emitParserEvents(events);
|
|
228
|
+
}
|
|
229
|
+
this.throwIfAborted(run.signal);
|
|
230
|
+
const finalEvents = parser.finish();
|
|
231
|
+
this.emitParserEvents(finalEvents);
|
|
232
|
+
const message = this.extractMessage(finalEvents);
|
|
233
|
+
return message;
|
|
234
|
+
}
|
|
235
|
+
catch (e) {
|
|
236
|
+
const error = this.toError(e);
|
|
237
|
+
this.emitError(error);
|
|
238
|
+
throw error;
|
|
239
|
+
}
|
|
240
|
+
finally {
|
|
241
|
+
run.cleanup();
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
// ========================
|
|
245
|
+
// 配置
|
|
246
|
+
// ========================
|
|
247
|
+
/** 修改模型 */
|
|
248
|
+
setModel(model) {
|
|
249
|
+
this._model = model;
|
|
250
|
+
return this;
|
|
251
|
+
}
|
|
252
|
+
/** 修改最大轮次 */
|
|
253
|
+
setMaxTurns(n) {
|
|
254
|
+
this._maxTurns = n;
|
|
255
|
+
return this;
|
|
256
|
+
}
|
|
257
|
+
/** 设置请求参数配置 */
|
|
258
|
+
setConfig(config) {
|
|
259
|
+
this._config = config;
|
|
260
|
+
return this;
|
|
261
|
+
}
|
|
262
|
+
/** 获取请求参数配置 */
|
|
263
|
+
get config() {
|
|
264
|
+
return this._config;
|
|
265
|
+
}
|
|
266
|
+
/** 设置额外请求参数(兼容旧 API) */
|
|
267
|
+
setRequestOptions(options) {
|
|
268
|
+
this._requestOptions = { ...this._requestOptions, ...options };
|
|
269
|
+
return this;
|
|
270
|
+
}
|
|
271
|
+
/** 获取关联的Session */
|
|
272
|
+
get session() {
|
|
273
|
+
return this._session;
|
|
274
|
+
}
|
|
275
|
+
/** 获取提示词构建器 */
|
|
276
|
+
get promptBuilder() {
|
|
277
|
+
return this._promptBuilder;
|
|
278
|
+
}
|
|
279
|
+
/** 设置提示词构建器 */
|
|
280
|
+
setPromptBuilder(builder) {
|
|
281
|
+
this._promptBuilder = builder;
|
|
282
|
+
return this;
|
|
283
|
+
}
|
|
284
|
+
/** 设置工具审批函数 */
|
|
285
|
+
setToolApproval(handler) {
|
|
286
|
+
this._toolApproval = handler;
|
|
287
|
+
return this;
|
|
288
|
+
}
|
|
289
|
+
/** 设置工具审批模式 */
|
|
290
|
+
setToolApprovalMode(mode) {
|
|
291
|
+
this._toolApprovalMode = mode;
|
|
292
|
+
return this;
|
|
293
|
+
}
|
|
294
|
+
/** 获取工具审批函数 */
|
|
295
|
+
get toolApproval() {
|
|
296
|
+
return this._toolApproval;
|
|
297
|
+
}
|
|
298
|
+
/** 获取当前等待外部决策的审批请求 */
|
|
299
|
+
get pendingApprovals() {
|
|
300
|
+
return Array.from(this._pendingApprovals.values()).map(({ resolve, reject, createdAt, ...req }) => req);
|
|
301
|
+
}
|
|
302
|
+
/** 外部批准一个 manual 工具审批请求 */
|
|
303
|
+
approve(approvalId) {
|
|
304
|
+
return this.resolvePendingApproval(approvalId, true);
|
|
305
|
+
}
|
|
306
|
+
/** 外部拒绝一个 manual 工具审批请求 */
|
|
307
|
+
reject(approvalId, reason) {
|
|
308
|
+
return this.resolvePendingApproval(approvalId, { approved: false, reason });
|
|
309
|
+
}
|
|
310
|
+
/** 设置工具错误策略 */
|
|
311
|
+
setToolErrorPolicy(policy) {
|
|
312
|
+
this._toolErrorPolicy = policy;
|
|
313
|
+
return this;
|
|
314
|
+
}
|
|
315
|
+
/** 获取工具错误策略 */
|
|
316
|
+
get toolErrorPolicy() {
|
|
317
|
+
return this._toolErrorPolicy;
|
|
318
|
+
}
|
|
319
|
+
/** 获取当前模型 */
|
|
320
|
+
get model() {
|
|
321
|
+
return this._model;
|
|
322
|
+
}
|
|
323
|
+
/** 最近一次运行状态 */
|
|
324
|
+
get lastRunState() {
|
|
325
|
+
return this._lastRunState;
|
|
326
|
+
}
|
|
327
|
+
/** 是否存在可恢复的异常中断现场 */
|
|
328
|
+
get canResume() {
|
|
329
|
+
return this._lastRunState?.canResume ?? false;
|
|
330
|
+
}
|
|
331
|
+
/** 是否可以继续当前任务:异常可恢复,或当前 Session 光标在 assistant 消息上 */
|
|
332
|
+
get canContinue() {
|
|
333
|
+
return this.canResume || this._session.cursor.role === "assistant";
|
|
334
|
+
}
|
|
335
|
+
/** 当前是否有运行中的请求 */
|
|
336
|
+
get isRunning() {
|
|
337
|
+
return !!this._activeAbortController;
|
|
338
|
+
}
|
|
339
|
+
/**
|
|
340
|
+
* 中断当前运行中的 Agent。
|
|
341
|
+
*
|
|
342
|
+
* 返回 true 表示确实触发了中断;返回 false 表示当前没有可中断的运行。
|
|
343
|
+
*/
|
|
344
|
+
abort(reason) {
|
|
345
|
+
if (!this._activeAbortController || this._activeAbortController.signal.aborted) {
|
|
346
|
+
return false;
|
|
347
|
+
}
|
|
348
|
+
const error = reason instanceof AgentAbortError
|
|
349
|
+
? reason
|
|
350
|
+
: reason instanceof Error
|
|
351
|
+
? new AgentAbortError(reason.message, reason)
|
|
352
|
+
: new AgentAbortError(reason ?? "Agent run aborted by user");
|
|
353
|
+
this._activeAbortController.abort(error);
|
|
354
|
+
return true;
|
|
355
|
+
}
|
|
356
|
+
/**
|
|
357
|
+
* 继续当前任务。
|
|
358
|
+
*
|
|
359
|
+
* mode=auto 时:若上次运行可恢复,则走 resume 语义;否则追加普通继续提示。
|
|
360
|
+
*/
|
|
361
|
+
async continue(options) {
|
|
362
|
+
const mode = options?.mode ?? "auto";
|
|
363
|
+
const shouldResume = mode === "resume" || (mode === "auto" && this.canResume);
|
|
364
|
+
if (mode === "resume" && !this.canResume) {
|
|
365
|
+
throw new Error("当前没有可恢复的中断任务");
|
|
366
|
+
}
|
|
367
|
+
if (!shouldResume && !this.canContinue) {
|
|
368
|
+
throw new Error("当前没有可继续的上下文");
|
|
369
|
+
}
|
|
370
|
+
const prompt = options?.prompt ?? (shouldResume
|
|
371
|
+
? "请从上一次中断的位置继续完成任务。不要重复已经完成的内容。如果上一次停在句子中间,请自然衔接;如果停在工具调用或操作流程中,请继续完成剩余步骤。"
|
|
372
|
+
: "请继续完成上一个任务,保持相同的结构和风格,不要重复已经完成的内容。");
|
|
373
|
+
const serializeOptions = options?.serializeOptions ?? {
|
|
374
|
+
thinking: {
|
|
375
|
+
mode: options?.thinkingMode ?? (shouldResume ? "auto" : "none"),
|
|
376
|
+
scope: shouldResume ? "last" : "none",
|
|
377
|
+
},
|
|
378
|
+
};
|
|
379
|
+
const { mode: _mode, prompt: _prompt, thinkingMode: _thinkingMode, ...runOptions } = options ?? {};
|
|
380
|
+
return this.run(prompt, {
|
|
381
|
+
...runOptions,
|
|
382
|
+
serializeOptions,
|
|
383
|
+
});
|
|
384
|
+
}
|
|
385
|
+
/** 严格从异常中断处恢复 */
|
|
386
|
+
async resume(options) {
|
|
387
|
+
return this.continue({ ...options, mode: "resume" });
|
|
388
|
+
}
|
|
389
|
+
// ========================
|
|
390
|
+
// 核心循环
|
|
391
|
+
// ========================
|
|
392
|
+
async executeLoop(options) {
|
|
393
|
+
const run = this.prepareRunOptions(options);
|
|
394
|
+
let sessionStarted = false;
|
|
395
|
+
this.startRunState();
|
|
396
|
+
let currentParser;
|
|
397
|
+
let partialAlreadyPersisted = false;
|
|
398
|
+
try {
|
|
399
|
+
this._session.beginGeneration?.();
|
|
400
|
+
sessionStarted = true;
|
|
401
|
+
const mergedOptions = this.buildMergedOptions(run.requestOptions);
|
|
402
|
+
let lastAssistantMsg;
|
|
403
|
+
for (let turn = 0; turn < this._maxTurns; turn++) {
|
|
404
|
+
this.throwIfAborted(run.signal);
|
|
405
|
+
const parser = run.stream ? this._parserFactory() : undefined;
|
|
406
|
+
currentParser = parser;
|
|
407
|
+
partialAlreadyPersisted = false;
|
|
408
|
+
this.updateRunState({ turn });
|
|
409
|
+
this.emit({ type: StreamEvent_1.StreamEventType.TURN_START, turn });
|
|
410
|
+
// 流式调用 + 解析
|
|
411
|
+
const response = parser
|
|
412
|
+
? await this.executeSingleStream(parser, mergedOptions, run)
|
|
413
|
+
: await this.executeSingleComplete(mergedOptions, run);
|
|
414
|
+
// 模型响应已经完整返回;提交前生命周期失败时不应回退为未转换的 partial。
|
|
415
|
+
currentParser = undefined;
|
|
416
|
+
const commitEvent = {
|
|
417
|
+
type: StreamEvent_1.StreamEventType.BEFORE_ASSISTANT_COMMIT,
|
|
418
|
+
message: response.assistantMsg,
|
|
419
|
+
turn,
|
|
420
|
+
finishReason: response.finishReason,
|
|
421
|
+
};
|
|
422
|
+
await this.emitAsync(commitEvent);
|
|
423
|
+
const assistantMsg = commitEvent.message;
|
|
424
|
+
const finishReason = response.finishReason;
|
|
425
|
+
if (assistantMsg.role !== Role_1.Role.Assistant) {
|
|
426
|
+
throw new Error("BEFORE_ASSISTANT_COMMIT 必须返回 Assistant 消息");
|
|
427
|
+
}
|
|
428
|
+
// 添加到 Session
|
|
429
|
+
this._session.addAssistant(assistantMsg);
|
|
430
|
+
lastAssistantMsg = assistantMsg;
|
|
431
|
+
partialAlreadyPersisted = true;
|
|
432
|
+
this.updateRunState({ lastMessage: assistantMsg });
|
|
433
|
+
// 输出长度限制
|
|
434
|
+
if (finishReason === "length") {
|
|
435
|
+
this.failRunState(new Error("模型输出达到长度限制,未完成最终回复"), "max_tokens", assistantMsg, true);
|
|
436
|
+
return assistantMsg;
|
|
437
|
+
}
|
|
438
|
+
const hasToolCalls = assistantMsg.toolCalls.length > 0;
|
|
439
|
+
this.emit({ type: StreamEvent_1.StreamEventType.TURN_END, turn, hasToolCalls });
|
|
440
|
+
// 如果没有工具调用,循环结束
|
|
441
|
+
if (!hasToolCalls || !this._toolkit) {
|
|
442
|
+
this.completeRunState(assistantMsg, "final");
|
|
443
|
+
return assistantMsg;
|
|
444
|
+
}
|
|
445
|
+
// 工具审批 + 执行
|
|
446
|
+
await this.processToolCalls(assistantMsg.toolCalls, turn, run.signal);
|
|
447
|
+
}
|
|
448
|
+
// 循环结束后的检查
|
|
449
|
+
return this.handleLoopExhausted(lastAssistantMsg);
|
|
450
|
+
}
|
|
451
|
+
catch (e) {
|
|
452
|
+
const error = this.toError(e);
|
|
453
|
+
const reason = this.classifyStopReason(error);
|
|
454
|
+
const partial = currentParser && !partialAlreadyPersisted
|
|
455
|
+
? this.persistPartialSnapshot(currentParser, reason)
|
|
456
|
+
: undefined;
|
|
457
|
+
const canResume = !!partial || this.isContinuableError(error);
|
|
458
|
+
if (canResume) {
|
|
459
|
+
this.completeInterruptedToolCalls(error, reason);
|
|
460
|
+
}
|
|
461
|
+
if (this._lastRunState?.error !== error) {
|
|
462
|
+
this.failRunState(error, reason, partial, canResume);
|
|
463
|
+
}
|
|
464
|
+
this.emitError(error);
|
|
465
|
+
throw error;
|
|
466
|
+
}
|
|
467
|
+
finally {
|
|
468
|
+
if (sessionStarted)
|
|
469
|
+
this._session.endGeneration?.();
|
|
470
|
+
run.cleanup();
|
|
471
|
+
}
|
|
472
|
+
}
|
|
473
|
+
/**
|
|
474
|
+
* 合并请求参数:Config → requestOptions → run options
|
|
475
|
+
*/
|
|
476
|
+
buildMergedOptions(runOptions) {
|
|
477
|
+
const configParams = this._config ? this._config.build() : {};
|
|
478
|
+
return { ...configParams, ...this._requestOptions, ...runOptions };
|
|
479
|
+
}
|
|
480
|
+
async buildModelRequest(messages, options, run) {
|
|
481
|
+
const requestMessages = Message_1.Message.pruneEmpty(messages);
|
|
482
|
+
const serialized = await this.raceWithAbort(this._adapter.serialize(requestMessages, run.serializeOptions), run.signal);
|
|
483
|
+
const tools = this._toolkit?.size ? this._toolkit.schemas : undefined;
|
|
484
|
+
if (this._adapter.buildRequest) {
|
|
485
|
+
return this._adapter.buildRequest({
|
|
486
|
+
model: this._model,
|
|
487
|
+
serialized,
|
|
488
|
+
tools,
|
|
489
|
+
options,
|
|
490
|
+
stream: run.stream,
|
|
491
|
+
});
|
|
492
|
+
}
|
|
493
|
+
const request = {
|
|
494
|
+
model: this._model,
|
|
495
|
+
messages: serialized.messages,
|
|
496
|
+
...options,
|
|
497
|
+
stream: run.stream,
|
|
498
|
+
};
|
|
499
|
+
if (tools)
|
|
500
|
+
request.tools = tools;
|
|
501
|
+
return request;
|
|
502
|
+
}
|
|
503
|
+
/**
|
|
504
|
+
* 执行单轮流式调用:序列化 → 请求 → 解析 → 返回 Message
|
|
505
|
+
*/
|
|
506
|
+
async executeSingleStream(parser, mergedOptions, run) {
|
|
507
|
+
// 获取会话历史,经 PromptBuilder 注入后序列化
|
|
508
|
+
const history = this._session.history();
|
|
509
|
+
const context = this._promptBuilder
|
|
510
|
+
? this._promptBuilder.build(history, run.promptBuildOptions)
|
|
511
|
+
: history;
|
|
512
|
+
const adaptedRequest = await this.buildModelRequest(context, mergedOptions, run);
|
|
513
|
+
// 流式调用
|
|
514
|
+
const stream = await this.raceWithAbort(this._client.stream(adaptedRequest, this.createClientOptions(run.signal)), run.signal);
|
|
515
|
+
// 解析 chunks
|
|
516
|
+
for await (const chunk of stream) {
|
|
517
|
+
this.throwIfAborted(run.signal);
|
|
518
|
+
const events = parser.feed(chunk);
|
|
519
|
+
this.emitParserEvents(events);
|
|
520
|
+
}
|
|
521
|
+
this.throwIfAborted(run.signal);
|
|
522
|
+
// 结束解析
|
|
523
|
+
const finalEvents = parser.finish();
|
|
524
|
+
this.emitParserEvents(finalEvents);
|
|
525
|
+
// 提取组装好的 Message
|
|
526
|
+
const assistantMsg = this.extractMessage(finalEvents);
|
|
527
|
+
const finishReason = this.extractFinishReason(finalEvents);
|
|
528
|
+
// 填充 model(usage 已由 StreamParser 在 buildMessage 中填入)
|
|
529
|
+
assistantMsg.model = this._model;
|
|
530
|
+
return { assistantMsg, finishReason };
|
|
531
|
+
}
|
|
532
|
+
/** Execute one complete-response turn without a stream parser. */
|
|
533
|
+
async executeSingleComplete(mergedOptions, run) {
|
|
534
|
+
const history = this._session.history();
|
|
535
|
+
const context = this._promptBuilder
|
|
536
|
+
? this._promptBuilder.build(history, run.promptBuildOptions)
|
|
537
|
+
: history;
|
|
538
|
+
const request = await this.buildModelRequest(context, mergedOptions, run);
|
|
539
|
+
return this.executeCompleteRequest(request, run);
|
|
540
|
+
}
|
|
541
|
+
async executeCompleteRequest(request, run) {
|
|
542
|
+
if (!this._client.complete) {
|
|
543
|
+
throw new Error("The configured ModelClient does not support non-streaming requests; implement complete() or use stream: true");
|
|
544
|
+
}
|
|
545
|
+
const raw = await this.raceWithAbort(this._client.complete(request, this.createClientOptions(run.signal)), run.signal);
|
|
546
|
+
this.throwIfAborted(run.signal);
|
|
547
|
+
const assistantMsg = this._adapter.deserializeResponse
|
|
548
|
+
? this._adapter.deserializeResponse(raw)
|
|
549
|
+
: this._adapter.deserialize(raw);
|
|
550
|
+
const finishReason = this._adapter.getFinishReason?.(raw);
|
|
551
|
+
assistantMsg.model ??= this._model;
|
|
552
|
+
this.emitCompleteResponseEvents(assistantMsg, finishReason);
|
|
553
|
+
return { assistantMsg, finishReason };
|
|
554
|
+
}
|
|
555
|
+
emitCompleteResponseEvents(message, finishReason) {
|
|
556
|
+
if (message.thinking) {
|
|
557
|
+
this.emit({
|
|
558
|
+
type: StreamEvent_1.StreamEventType.THINKING_DONE,
|
|
559
|
+
thinking: message.thinking,
|
|
560
|
+
});
|
|
561
|
+
}
|
|
562
|
+
if (message.text) {
|
|
563
|
+
this.emit({ type: StreamEvent_1.StreamEventType.TEXT_DONE, text: message.text });
|
|
564
|
+
}
|
|
565
|
+
message.toolCalls.forEach((toolCall, index) => {
|
|
566
|
+
this.emit({
|
|
567
|
+
type: StreamEvent_1.StreamEventType.TOOL_CALL_START,
|
|
568
|
+
index,
|
|
569
|
+
toolCallId: toolCall.toolCallId,
|
|
570
|
+
name: toolCall.name,
|
|
571
|
+
});
|
|
572
|
+
this.emit({
|
|
573
|
+
type: StreamEvent_1.StreamEventType.TOOL_CALL_DONE,
|
|
574
|
+
index,
|
|
575
|
+
toolCallId: toolCall.toolCallId,
|
|
576
|
+
name: toolCall.name,
|
|
577
|
+
arguments: toolCall.arguments,
|
|
578
|
+
});
|
|
579
|
+
});
|
|
580
|
+
this.emit({
|
|
581
|
+
type: StreamEvent_1.StreamEventType.MESSAGE_DONE,
|
|
582
|
+
message,
|
|
583
|
+
finishReason,
|
|
584
|
+
});
|
|
585
|
+
}
|
|
586
|
+
/**
|
|
587
|
+
* 处理工具调用:审批 → 执行 → 结果回写 Session
|
|
588
|
+
*/
|
|
589
|
+
async processToolCalls(toolCalls, turn, signal) {
|
|
590
|
+
// 工具审批
|
|
591
|
+
const approvalResults = await this.approveToolCalls(toolCalls, turn, signal);
|
|
592
|
+
const approvedToolCalls = approvalResults
|
|
593
|
+
.filter((item) => item.approved)
|
|
594
|
+
.map((item) => item.toolCall);
|
|
595
|
+
const rejectedToolResults = approvalResults
|
|
596
|
+
.filter((item) => !item.approved)
|
|
597
|
+
.map((item) => Message_1.Message.tool(item.toolCall.toolCallId, JSON.stringify({ error: item.reason || "工具调用被拒绝", rejected: true }), item.toolCall.name));
|
|
598
|
+
if (approvedToolCalls.length === 0) {
|
|
599
|
+
if (rejectedToolResults.length > 0) {
|
|
600
|
+
this._session.addTool(rejectedToolResults);
|
|
601
|
+
}
|
|
602
|
+
const error = new Error("所有工具调用均被审批拒绝");
|
|
603
|
+
this.failRunState(error, "tool_approval_rejected", undefined, true);
|
|
604
|
+
throw error;
|
|
605
|
+
}
|
|
606
|
+
// 为每个工具调用发出 START 事件
|
|
607
|
+
for (const tc of approvedToolCalls) {
|
|
608
|
+
this.throwIfAborted(signal);
|
|
609
|
+
this.emit({
|
|
610
|
+
type: StreamEvent_1.StreamEventType.TOOL_EXECUTE_START,
|
|
611
|
+
toolCallId: tc.toolCallId,
|
|
612
|
+
name: tc.name,
|
|
613
|
+
});
|
|
614
|
+
}
|
|
615
|
+
// 并行执行所有工具调用
|
|
616
|
+
const toolResults = await this.executeApprovedToolCalls(approvedToolCalls, rejectedToolResults, signal);
|
|
617
|
+
// 添加工具结果到 Session
|
|
618
|
+
this._session.addTool(toolResults);
|
|
619
|
+
}
|
|
620
|
+
/**
|
|
621
|
+
* 循环耗尽后的结果检查
|
|
622
|
+
*/
|
|
623
|
+
handleLoopExhausted(lastAssistantMsg) {
|
|
624
|
+
if (!lastAssistantMsg) {
|
|
625
|
+
throw new Error("Agent 运行失败:未获得任何回复");
|
|
626
|
+
}
|
|
627
|
+
if (lastAssistantMsg.toolCalls.length > 0 && this._toolkit) {
|
|
628
|
+
const error = new Error(`Agent 达到最大循环轮次 maxTurns=${this._maxTurns},但仍未获得最终回复`);
|
|
629
|
+
this.failRunState(error, "max_turns", lastAssistantMsg, true);
|
|
630
|
+
throw error;
|
|
631
|
+
}
|
|
632
|
+
this.completeRunState(lastAssistantMsg, "final");
|
|
633
|
+
return lastAssistantMsg;
|
|
634
|
+
}
|
|
635
|
+
// ========================
|
|
636
|
+
// 事件分发
|
|
637
|
+
// ========================
|
|
638
|
+
/**
|
|
639
|
+
* 发射事件(支持内置事件和自定义事件)
|
|
640
|
+
*
|
|
641
|
+
* 内置事件由 Agent 循环自动发射,用户也可手动发射自定义事件:
|
|
642
|
+
*
|
|
643
|
+
* agent.emit({ type: "my_abort", reason: "用户取消" });
|
|
644
|
+
*
|
|
645
|
+
* 结合 on() 可实现自定义中断等高级功能:
|
|
646
|
+
*
|
|
647
|
+
* agent.on("abort", (e) => { ... });
|
|
648
|
+
* agent.emit({ type: "abort" });
|
|
649
|
+
*/
|
|
650
|
+
emit(event) {
|
|
651
|
+
const handlers = [...(this._handlers.get(event.type) || [])];
|
|
652
|
+
for (const handler of handlers) {
|
|
653
|
+
try {
|
|
654
|
+
const result = handler(event);
|
|
655
|
+
if (result && typeof result.then === "function") {
|
|
656
|
+
Promise.resolve(result).catch((error) => {
|
|
657
|
+
this.reportHandlerError(error, event);
|
|
658
|
+
});
|
|
659
|
+
}
|
|
660
|
+
}
|
|
661
|
+
catch (e) {
|
|
662
|
+
this.reportHandlerError(e, event);
|
|
663
|
+
}
|
|
664
|
+
}
|
|
665
|
+
}
|
|
666
|
+
/**
|
|
667
|
+
* 按注册顺序等待事件监听器完成。
|
|
668
|
+
*
|
|
669
|
+
* 与 emit() 的通知语义不同,监听器失败会在上报后继续向调用方抛出,
|
|
670
|
+
* 适合提交前转换等必须完成后才能继续的生命周期。
|
|
671
|
+
*/
|
|
672
|
+
async emitAsync(event) {
|
|
673
|
+
const handlers = [...(this._handlers.get(event.type) || [])];
|
|
674
|
+
for (const handler of handlers) {
|
|
675
|
+
try {
|
|
676
|
+
await handler(event);
|
|
677
|
+
}
|
|
678
|
+
catch (error) {
|
|
679
|
+
this.reportHandlerError(error, event);
|
|
680
|
+
throw error;
|
|
681
|
+
}
|
|
682
|
+
}
|
|
683
|
+
}
|
|
684
|
+
/**
|
|
685
|
+
* 设置事件 handler 报错时的处理器。
|
|
686
|
+
*
|
|
687
|
+
* 默认会调用 console.error 记录,可传入 noop 完全静默或接入自定义 logger。
|
|
688
|
+
* 传入 undefined 或不传参时恢复为默认行为。
|
|
689
|
+
*/
|
|
690
|
+
setHandlerErrorHandler(handler) {
|
|
691
|
+
this._handlerErrorHandler = handler ?? defaultHandlerErrorHandler;
|
|
692
|
+
return this;
|
|
693
|
+
}
|
|
694
|
+
emitParserEvents(events) {
|
|
695
|
+
let parserError;
|
|
696
|
+
for (const event of events) {
|
|
697
|
+
if (event.type === StreamEvent_1.StreamEventType.ERROR) {
|
|
698
|
+
parserError ??= event.error;
|
|
699
|
+
}
|
|
700
|
+
else {
|
|
701
|
+
this.emit(event);
|
|
702
|
+
}
|
|
703
|
+
}
|
|
704
|
+
if (parserError) {
|
|
705
|
+
throw parserError;
|
|
706
|
+
}
|
|
707
|
+
}
|
|
708
|
+
reportHandlerError(errorLike, event) {
|
|
709
|
+
const error = errorLike instanceof Error ? errorLike : new Error(String(errorLike));
|
|
710
|
+
try {
|
|
711
|
+
this._handlerErrorHandler(error, event);
|
|
712
|
+
}
|
|
713
|
+
catch {
|
|
714
|
+
// 错误处理器本身也抛错时静默吞掉,避免递归
|
|
715
|
+
}
|
|
716
|
+
}
|
|
717
|
+
// ========================
|
|
718
|
+
// 辅助
|
|
719
|
+
// ========================
|
|
720
|
+
extractMessage(events) {
|
|
721
|
+
for (const event of events) {
|
|
722
|
+
if (event.type === StreamEvent_1.StreamEventType.MESSAGE_DONE) {
|
|
723
|
+
return event.message;
|
|
724
|
+
}
|
|
725
|
+
}
|
|
726
|
+
throw new Error("未找到 MESSAGE_DONE 事件");
|
|
727
|
+
}
|
|
728
|
+
extractFinishReason(events) {
|
|
729
|
+
for (const event of events) {
|
|
730
|
+
if (event.type === StreamEvent_1.StreamEventType.MESSAGE_DONE) {
|
|
731
|
+
return event.finishReason;
|
|
732
|
+
}
|
|
733
|
+
}
|
|
734
|
+
return undefined;
|
|
735
|
+
}
|
|
736
|
+
async executeApprovedToolCalls(approvedToolCalls, rejectedToolResults, signal) {
|
|
737
|
+
const policy = this._toolErrorPolicy;
|
|
738
|
+
const toolResults = [];
|
|
739
|
+
if (policy === "throw") {
|
|
740
|
+
try {
|
|
741
|
+
const results = await this.raceWithAbort(this._toolkit.executeAll(approvedToolCalls, {
|
|
742
|
+
signal,
|
|
743
|
+
errorPolicy: "throw",
|
|
744
|
+
}), signal);
|
|
745
|
+
toolResults.push(...results);
|
|
746
|
+
}
|
|
747
|
+
catch (e) {
|
|
748
|
+
const error = this.toError(e);
|
|
749
|
+
this.emitToolExecutionError(error);
|
|
750
|
+
this.failRunState(error, "tool_execution_error", undefined, false);
|
|
751
|
+
throw error;
|
|
752
|
+
}
|
|
753
|
+
}
|
|
754
|
+
else {
|
|
755
|
+
for (const toolCall of approvedToolCalls) {
|
|
756
|
+
this.throwIfAborted(signal);
|
|
757
|
+
const result = await this.raceWithAbort(this._toolkit.execute(toolCall, {
|
|
758
|
+
signal,
|
|
759
|
+
errorPolicy: policy === "pause" ? "throw" : "return_to_model",
|
|
760
|
+
}), signal).catch((e) => this.handleToolExecutionFailure(toolCall, e, policy));
|
|
761
|
+
if (result) {
|
|
762
|
+
toolResults.push(result);
|
|
763
|
+
}
|
|
764
|
+
}
|
|
765
|
+
}
|
|
766
|
+
// 按 toolCallId 建索引,避免 O(n²) 查找,且不依赖顺序
|
|
767
|
+
const resultByCallId = new Map();
|
|
768
|
+
for (const result of toolResults) {
|
|
769
|
+
for (const part of result.parts) {
|
|
770
|
+
if (part.type === "tool_result") {
|
|
771
|
+
resultByCallId.set(part.toolCallId, result);
|
|
772
|
+
break;
|
|
773
|
+
}
|
|
774
|
+
}
|
|
775
|
+
}
|
|
776
|
+
for (const tc of approvedToolCalls) {
|
|
777
|
+
const result = resultByCallId.get(tc.toolCallId);
|
|
778
|
+
if (!result)
|
|
779
|
+
continue;
|
|
780
|
+
this.throwIfAborted(signal);
|
|
781
|
+
const toolError = result.metadata.toolExecutionError;
|
|
782
|
+
if (toolError) {
|
|
783
|
+
this.emitToolExecutionError(new ToolKit_1.ToolExecutionError(tc.toolCallId, tc.name, new Error(toolError.message || "工具执行失败")), tc, result);
|
|
784
|
+
continue;
|
|
785
|
+
}
|
|
786
|
+
this.emit({
|
|
787
|
+
type: StreamEvent_1.StreamEventType.TOOL_EXECUTE_DONE,
|
|
788
|
+
toolCallId: tc.toolCallId,
|
|
789
|
+
name: tc.name,
|
|
790
|
+
result,
|
|
791
|
+
});
|
|
792
|
+
}
|
|
793
|
+
return [...rejectedToolResults, ...toolResults];
|
|
794
|
+
}
|
|
795
|
+
handleToolExecutionFailure(toolCall, errorLike, policy) {
|
|
796
|
+
const error = this.toError(errorLike);
|
|
797
|
+
if (policy === "pause") {
|
|
798
|
+
const result = Message_1.Message.tool(toolCall.toolCallId, JSON.stringify({ error: error.message, paused: true }), toolCall.name);
|
|
799
|
+
this.emitToolExecutionError(error, toolCall, result);
|
|
800
|
+
this._session.addTool([result]);
|
|
801
|
+
this.failRunState(error, "tool_execution_error", result, true);
|
|
802
|
+
throw error;
|
|
803
|
+
}
|
|
804
|
+
this.emitToolExecutionError(error, toolCall);
|
|
805
|
+
return Message_1.Message.tool(toolCall.toolCallId, JSON.stringify({ error: error.message }), toolCall.name);
|
|
806
|
+
}
|
|
807
|
+
emitToolExecutionError(error, toolCall, result) {
|
|
808
|
+
const toolError = error instanceof ToolKit_1.ToolExecutionError ? error : undefined;
|
|
809
|
+
this.emit({
|
|
810
|
+
type: StreamEvent_1.StreamEventType.TOOL_EXECUTE_ERROR,
|
|
811
|
+
toolCallId: toolCall?.toolCallId ?? toolError?.toolCallId ?? "",
|
|
812
|
+
name: toolCall?.name ?? toolError?.toolName ?? "",
|
|
813
|
+
error,
|
|
814
|
+
result,
|
|
815
|
+
});
|
|
816
|
+
}
|
|
817
|
+
async approveToolCalls(toolCalls, turn, signal) {
|
|
818
|
+
const results = [];
|
|
819
|
+
for (const toolCall of toolCalls) {
|
|
820
|
+
this.throwIfAborted(signal);
|
|
821
|
+
const approvalId = this.generateApprovalId();
|
|
822
|
+
const request = {
|
|
823
|
+
approvalId,
|
|
824
|
+
toolCallId: toolCall.toolCallId,
|
|
825
|
+
name: toolCall.name,
|
|
826
|
+
arguments: this.safeParseArguments(toolCall.arguments),
|
|
827
|
+
rawArguments: toolCall.arguments,
|
|
828
|
+
turn,
|
|
829
|
+
};
|
|
830
|
+
this.emit({
|
|
831
|
+
type: StreamEvent_1.StreamEventType.TOOL_APPROVAL_REQUIRED,
|
|
832
|
+
...request,
|
|
833
|
+
});
|
|
834
|
+
let approvalResult;
|
|
835
|
+
try {
|
|
836
|
+
approvalResult = await this.resolveToolApproval(request, signal);
|
|
837
|
+
}
|
|
838
|
+
catch (e) {
|
|
839
|
+
const error = this.toError(e);
|
|
840
|
+
if (error instanceof AgentAbortError ||
|
|
841
|
+
error instanceof AgentTimeoutError ||
|
|
842
|
+
error instanceof AgentToolApprovalTimeoutError) {
|
|
843
|
+
throw error;
|
|
844
|
+
}
|
|
845
|
+
throw new AgentToolApprovalError(request, error);
|
|
846
|
+
}
|
|
847
|
+
const normalized = this.normalizeApprovalResult(approvalResult);
|
|
848
|
+
if (normalized.approved) {
|
|
849
|
+
this.emit({
|
|
850
|
+
type: StreamEvent_1.StreamEventType.TOOL_APPROVAL_ACCEPTED,
|
|
851
|
+
approvalId,
|
|
852
|
+
toolCallId: toolCall.toolCallId,
|
|
853
|
+
name: toolCall.name,
|
|
854
|
+
});
|
|
855
|
+
}
|
|
856
|
+
else {
|
|
857
|
+
this.emit({
|
|
858
|
+
type: StreamEvent_1.StreamEventType.TOOL_APPROVAL_REJECTED,
|
|
859
|
+
approvalId,
|
|
860
|
+
toolCallId: toolCall.toolCallId,
|
|
861
|
+
name: toolCall.name,
|
|
862
|
+
reason: normalized.reason,
|
|
863
|
+
});
|
|
864
|
+
}
|
|
865
|
+
results.push({ toolCall, ...normalized });
|
|
866
|
+
}
|
|
867
|
+
return results;
|
|
868
|
+
}
|
|
869
|
+
normalizeApprovalResult(result) {
|
|
870
|
+
if (typeof result === "boolean")
|
|
871
|
+
return { approved: result };
|
|
872
|
+
return {
|
|
873
|
+
approved: result.approved,
|
|
874
|
+
reason: result.reason,
|
|
875
|
+
};
|
|
876
|
+
}
|
|
877
|
+
resolveToolApproval(request, signal) {
|
|
878
|
+
if (this._toolApproval) {
|
|
879
|
+
return this.raceWithAbort(Promise.resolve(this._toolApproval(request)), signal);
|
|
880
|
+
}
|
|
881
|
+
if (this._toolApprovalMode !== "manual") {
|
|
882
|
+
return Promise.resolve(true);
|
|
883
|
+
}
|
|
884
|
+
return this.waitForManualApproval(request, signal);
|
|
885
|
+
}
|
|
886
|
+
waitForManualApproval(request, signal) {
|
|
887
|
+
return new Promise((resolve, reject) => {
|
|
888
|
+
let settled = false;
|
|
889
|
+
let timer;
|
|
890
|
+
const cleanup = () => {
|
|
891
|
+
if (timer)
|
|
892
|
+
clearTimeout(timer);
|
|
893
|
+
signal?.removeEventListener("abort", onAbort);
|
|
894
|
+
this._pendingApprovals.delete(request.approvalId);
|
|
895
|
+
};
|
|
896
|
+
const settleResolve = (result) => {
|
|
897
|
+
if (settled)
|
|
898
|
+
return;
|
|
899
|
+
settled = true;
|
|
900
|
+
cleanup();
|
|
901
|
+
resolve(result);
|
|
902
|
+
};
|
|
903
|
+
const settleReject = (error) => {
|
|
904
|
+
if (settled)
|
|
905
|
+
return;
|
|
906
|
+
settled = true;
|
|
907
|
+
cleanup();
|
|
908
|
+
reject(error);
|
|
909
|
+
};
|
|
910
|
+
const onAbort = () => settleReject(this.getAbortReason(signal));
|
|
911
|
+
if (signal?.aborted) {
|
|
912
|
+
settleReject(this.getAbortReason(signal));
|
|
913
|
+
return;
|
|
914
|
+
}
|
|
915
|
+
if (signal) {
|
|
916
|
+
signal.addEventListener("abort", onAbort, { once: true });
|
|
917
|
+
}
|
|
918
|
+
if (this._toolApprovalTimeoutMs !== undefined) {
|
|
919
|
+
timer = setTimeout(() => {
|
|
920
|
+
if (this._toolApprovalTimeoutPolicy === "abort") {
|
|
921
|
+
settleReject(new AgentToolApprovalTimeoutError(request, Math.max(0, this._toolApprovalTimeoutMs)));
|
|
922
|
+
}
|
|
923
|
+
else {
|
|
924
|
+
settleResolve({ approved: false, reason: "工具审批超时" });
|
|
925
|
+
}
|
|
926
|
+
}, Math.max(0, this._toolApprovalTimeoutMs));
|
|
927
|
+
}
|
|
928
|
+
this._pendingApprovals.set(request.approvalId, {
|
|
929
|
+
...request,
|
|
930
|
+
createdAt: new Date(),
|
|
931
|
+
resolve: settleResolve,
|
|
932
|
+
reject: settleReject,
|
|
933
|
+
});
|
|
934
|
+
});
|
|
935
|
+
}
|
|
936
|
+
resolvePendingApproval(approvalId, result) {
|
|
937
|
+
const pending = this._pendingApprovals.get(approvalId);
|
|
938
|
+
if (!pending)
|
|
939
|
+
return false;
|
|
940
|
+
pending.resolve(result);
|
|
941
|
+
return true;
|
|
942
|
+
}
|
|
943
|
+
safeParseArguments(args) {
|
|
944
|
+
try {
|
|
945
|
+
const parsed = JSON.parse(args);
|
|
946
|
+
return typeof parsed === "object" && parsed !== null ? parsed : {};
|
|
947
|
+
}
|
|
948
|
+
catch {
|
|
949
|
+
return {};
|
|
950
|
+
}
|
|
951
|
+
}
|
|
952
|
+
generateApprovalId() {
|
|
953
|
+
return (0, utils_1.generateId)("approval");
|
|
954
|
+
}
|
|
955
|
+
prepareRunOptions(options) {
|
|
956
|
+
this.ensureIdle();
|
|
957
|
+
const { signal: externalSignal, timeoutMs, promptBuildOptions, serializeOptions, stream = true, ...requestOptions } = options ?? {};
|
|
958
|
+
const cleanupFns = [];
|
|
959
|
+
const controller = new AbortController();
|
|
960
|
+
const signal = controller.signal;
|
|
961
|
+
this._activeAbortController = controller;
|
|
962
|
+
if (externalSignal?.aborted) {
|
|
963
|
+
controller.abort(this.getAbortReason(externalSignal));
|
|
964
|
+
}
|
|
965
|
+
else if (externalSignal) {
|
|
966
|
+
const onAbort = () => controller.abort(this.getAbortReason(externalSignal));
|
|
967
|
+
externalSignal.addEventListener("abort", onAbort, { once: true });
|
|
968
|
+
cleanupFns.push(() => externalSignal.removeEventListener("abort", onAbort));
|
|
969
|
+
}
|
|
970
|
+
if (timeoutMs !== undefined) {
|
|
971
|
+
const timer = setTimeout(() => {
|
|
972
|
+
controller.abort(new AgentTimeoutError(timeoutMs));
|
|
973
|
+
}, Math.max(0, timeoutMs));
|
|
974
|
+
cleanupFns.push(() => clearTimeout(timer));
|
|
975
|
+
}
|
|
976
|
+
return {
|
|
977
|
+
requestOptions,
|
|
978
|
+
stream,
|
|
979
|
+
signal,
|
|
980
|
+
promptBuildOptions,
|
|
981
|
+
serializeOptions,
|
|
982
|
+
cleanup: () => {
|
|
983
|
+
for (const fn of cleanupFns)
|
|
984
|
+
fn();
|
|
985
|
+
if (this._activeAbortController === controller) {
|
|
986
|
+
this._activeAbortController = undefined;
|
|
987
|
+
}
|
|
988
|
+
},
|
|
989
|
+
};
|
|
990
|
+
}
|
|
991
|
+
createClientOptions(signal) {
|
|
992
|
+
return signal ? { signal } : undefined;
|
|
993
|
+
}
|
|
994
|
+
ensureIdle() {
|
|
995
|
+
if (this.isRunning) {
|
|
996
|
+
throw new AgentAlreadyRunningError();
|
|
997
|
+
}
|
|
998
|
+
}
|
|
999
|
+
throwIfAborted(signal) {
|
|
1000
|
+
if (signal?.aborted) {
|
|
1001
|
+
throw this.getAbortReason(signal);
|
|
1002
|
+
}
|
|
1003
|
+
}
|
|
1004
|
+
getAbortReason(signal) {
|
|
1005
|
+
const reason = signal.reason;
|
|
1006
|
+
if (reason instanceof Error)
|
|
1007
|
+
return reason;
|
|
1008
|
+
if (reason !== undefined)
|
|
1009
|
+
return new AgentAbortError(String(reason));
|
|
1010
|
+
return new AgentAbortError();
|
|
1011
|
+
}
|
|
1012
|
+
async raceWithAbort(promise, signal) {
|
|
1013
|
+
this.throwIfAborted(signal);
|
|
1014
|
+
if (!signal)
|
|
1015
|
+
return promise;
|
|
1016
|
+
return Promise.race([
|
|
1017
|
+
promise,
|
|
1018
|
+
new Promise((_, reject) => {
|
|
1019
|
+
const onAbort = () => reject(this.getAbortReason(signal));
|
|
1020
|
+
const cleanup = () => signal.removeEventListener("abort", onAbort);
|
|
1021
|
+
signal.addEventListener("abort", onAbort, { once: true });
|
|
1022
|
+
promise.then(cleanup, cleanup);
|
|
1023
|
+
}),
|
|
1024
|
+
]);
|
|
1025
|
+
}
|
|
1026
|
+
toError(error) {
|
|
1027
|
+
return error instanceof Error ? error : new Error(String(error));
|
|
1028
|
+
}
|
|
1029
|
+
emitError(error) {
|
|
1030
|
+
this.emit({
|
|
1031
|
+
type: StreamEvent_1.StreamEventType.ERROR,
|
|
1032
|
+
error,
|
|
1033
|
+
});
|
|
1034
|
+
}
|
|
1035
|
+
startRunState() {
|
|
1036
|
+
const now = new Date();
|
|
1037
|
+
this._lastRunState = {
|
|
1038
|
+
id: (0, utils_1.generateId)("run"),
|
|
1039
|
+
status: "running",
|
|
1040
|
+
turn: 0,
|
|
1041
|
+
canResume: false,
|
|
1042
|
+
createdAt: now,
|
|
1043
|
+
updatedAt: now,
|
|
1044
|
+
};
|
|
1045
|
+
}
|
|
1046
|
+
updateRunState(patch) {
|
|
1047
|
+
if (!this._lastRunState)
|
|
1048
|
+
return;
|
|
1049
|
+
this._lastRunState = {
|
|
1050
|
+
...this._lastRunState,
|
|
1051
|
+
...patch,
|
|
1052
|
+
updatedAt: new Date(),
|
|
1053
|
+
};
|
|
1054
|
+
}
|
|
1055
|
+
completeRunState(message, reason) {
|
|
1056
|
+
this.updateRunState({
|
|
1057
|
+
status: "completed",
|
|
1058
|
+
stopReason: reason,
|
|
1059
|
+
lastMessage: message,
|
|
1060
|
+
canResume: false,
|
|
1061
|
+
});
|
|
1062
|
+
}
|
|
1063
|
+
failRunState(error, reason, partial, canResume = false) {
|
|
1064
|
+
this.updateRunState({
|
|
1065
|
+
status: reason === "abort" || reason === "timeout" ? "interrupted" : "failed",
|
|
1066
|
+
stopReason: reason,
|
|
1067
|
+
error,
|
|
1068
|
+
partialMessage: partial,
|
|
1069
|
+
canResume,
|
|
1070
|
+
});
|
|
1071
|
+
}
|
|
1072
|
+
classifyStopReason(error) {
|
|
1073
|
+
if (error instanceof AgentTimeoutError || error.name === "TimeoutError")
|
|
1074
|
+
return "timeout";
|
|
1075
|
+
if (error instanceof AgentToolApprovalTimeoutError ||
|
|
1076
|
+
error.name === "ToolApprovalTimeoutError")
|
|
1077
|
+
return "timeout";
|
|
1078
|
+
if (error instanceof AgentAbortError || error.name === "AbortError")
|
|
1079
|
+
return "abort";
|
|
1080
|
+
if (error instanceof AgentToolApprovalError ||
|
|
1081
|
+
error.name === "ToolApprovalError")
|
|
1082
|
+
return "tool_approval_error";
|
|
1083
|
+
if (error instanceof ToolKit_1.ToolExecutionError || error.name === "ToolExecutionError")
|
|
1084
|
+
return "tool_execution_error";
|
|
1085
|
+
const name = (error.name || "").toLowerCase();
|
|
1086
|
+
const message = (error.message || "").toLowerCase();
|
|
1087
|
+
const code = error.code?.toLowerCase() ?? "";
|
|
1088
|
+
const causeName = (error.cause?.name || "").toLowerCase();
|
|
1089
|
+
if (name.includes("apiconnection") ||
|
|
1090
|
+
name.includes("connection") ||
|
|
1091
|
+
name.includes("network") ||
|
|
1092
|
+
causeName.includes("connection") ||
|
|
1093
|
+
code === "econnreset" ||
|
|
1094
|
+
code === "econnrefused" ||
|
|
1095
|
+
code === "etimedout" ||
|
|
1096
|
+
code === "enotfound" ||
|
|
1097
|
+
code === "eai_again" ||
|
|
1098
|
+
message.includes("fetch failed") ||
|
|
1099
|
+
message.includes("network error") ||
|
|
1100
|
+
message.includes("socket hang up")) {
|
|
1101
|
+
return "network_error";
|
|
1102
|
+
}
|
|
1103
|
+
if (name.includes("stream") || message.includes("stream error") || message.includes("premature close")) {
|
|
1104
|
+
return "stream_error";
|
|
1105
|
+
}
|
|
1106
|
+
return "unknown_error";
|
|
1107
|
+
}
|
|
1108
|
+
persistPartialSnapshot(parser, reason) {
|
|
1109
|
+
if (!parser.hasSnapshotContent)
|
|
1110
|
+
return undefined;
|
|
1111
|
+
const partial = parser.snapshot;
|
|
1112
|
+
partial.model = this._model;
|
|
1113
|
+
partial
|
|
1114
|
+
.setMeta("partial", true)
|
|
1115
|
+
.setMeta("stopReason", reason)
|
|
1116
|
+
.setMeta("finishReason", parser.finishReason);
|
|
1117
|
+
partial.tag("partial", "recoverable");
|
|
1118
|
+
this._session.addAssistant(partial);
|
|
1119
|
+
return partial;
|
|
1120
|
+
}
|
|
1121
|
+
isContinuableError(error) {
|
|
1122
|
+
if (error instanceof AgentTimeoutError ||
|
|
1123
|
+
error instanceof AgentAbortError ||
|
|
1124
|
+
error instanceof AgentToolApprovalTimeoutError ||
|
|
1125
|
+
error instanceof AgentToolApprovalError ||
|
|
1126
|
+
error instanceof ToolKit_1.ToolExecutionError ||
|
|
1127
|
+
error.name === "TimeoutError" ||
|
|
1128
|
+
error.name === "AbortError" ||
|
|
1129
|
+
error.name === "ToolExecutionError") {
|
|
1130
|
+
return true;
|
|
1131
|
+
}
|
|
1132
|
+
const reason = this.classifyStopReason(error);
|
|
1133
|
+
return reason === "network_error" || reason === "stream_error";
|
|
1134
|
+
}
|
|
1135
|
+
completeInterruptedToolCalls(error, reason) {
|
|
1136
|
+
const history = this._session.history();
|
|
1137
|
+
let assistantIndex = -1;
|
|
1138
|
+
for (let i = history.length - 1; i >= 0; i--) {
|
|
1139
|
+
if (history[i].role === "assistant" && history[i].toolCalls.length > 0) {
|
|
1140
|
+
assistantIndex = i;
|
|
1141
|
+
break;
|
|
1142
|
+
}
|
|
1143
|
+
}
|
|
1144
|
+
if (assistantIndex === -1)
|
|
1145
|
+
return;
|
|
1146
|
+
const assistant = history[assistantIndex];
|
|
1147
|
+
const completedIds = new Set();
|
|
1148
|
+
for (let i = assistantIndex + 1; i < history.length; i++) {
|
|
1149
|
+
for (const part of history[i].parts) {
|
|
1150
|
+
if (part.type === "tool_result") {
|
|
1151
|
+
completedIds.add(part.toolCallId);
|
|
1152
|
+
}
|
|
1153
|
+
}
|
|
1154
|
+
}
|
|
1155
|
+
const missingResults = assistant.toolCalls
|
|
1156
|
+
.filter((toolCall) => toolCall.toolCallId && !completedIds.has(toolCall.toolCallId))
|
|
1157
|
+
.map((toolCall) => Message_1.Message.tool(toolCall.toolCallId, JSON.stringify({
|
|
1158
|
+
error: error.message,
|
|
1159
|
+
interrupted: true,
|
|
1160
|
+
outcome: "unknown",
|
|
1161
|
+
stopReason: reason,
|
|
1162
|
+
}), toolCall.name).tag("interrupted", "recoverable").setMeta("interrupted", true));
|
|
1163
|
+
if (missingResults.length > 0) {
|
|
1164
|
+
this._session.addTool(missingResults);
|
|
1165
|
+
}
|
|
1166
|
+
}
|
|
1167
|
+
}
|
|
1168
|
+
exports.Agent = Agent;
|
|
1169
|
+
//# sourceMappingURL=Agent.js.map
|