@notic/agent-engine 2.2.0 → 3.0.1
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 +31 -1
- package/README.md +97 -449
- package/dist/agent/Agent.d.ts +138 -355
- package/dist/agent/Agent.d.ts.map +1 -1
- package/dist/agent/Agent.js +305 -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 +41 -0
- package/dist/generator/Generator.d.ts.map +1 -0
- package/dist/generator/Generator.js +89 -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 +251 -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 +36 -25
- 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
package/dist/agent/Agent.js
CHANGED
|
@@ -1,1168 +1,345 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.Agent = exports.
|
|
4
|
-
const
|
|
5
|
-
const
|
|
6
|
-
const
|
|
7
|
-
const
|
|
8
|
-
const
|
|
9
|
-
const
|
|
10
|
-
const
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
3
|
+
exports.Agent = exports.AgentRunError = exports.CONTINUATION_THINKING_TAG = exports.CONTINUATION_INSTRUCTION_TAG = exports.TEMPORARY_PROMPT_TAG = void 0;
|
|
4
|
+
const data_1 = require("../core/data");
|
|
5
|
+
const generator_1 = require("../generator");
|
|
6
|
+
const message_1 = require("../message");
|
|
7
|
+
const provider_1 = require("../provider");
|
|
8
|
+
const prompt_1 = require("../prompt");
|
|
9
|
+
const session_1 = require("../session");
|
|
10
|
+
const tool_1 = require("../tool");
|
|
11
|
+
exports.TEMPORARY_PROMPT_TAG = "agent-engine:temporary";
|
|
12
|
+
exports.CONTINUATION_INSTRUCTION_TAG = "agent-engine:continue-instruction";
|
|
13
|
+
exports.CONTINUATION_THINKING_TAG = "agent-engine:continue-thinking";
|
|
14
|
+
class AgentRunError extends Error {
|
|
15
|
+
result;
|
|
14
16
|
cause;
|
|
15
|
-
constructor(
|
|
16
|
-
super(message);
|
|
17
|
-
this.
|
|
17
|
+
constructor(result, cause) {
|
|
18
|
+
super((0, data_1.errorOf)(cause).message);
|
|
19
|
+
this.result = result;
|
|
18
20
|
this.cause = cause;
|
|
21
|
+
this.name = result.status === "interrupted" ? (0, data_1.errorOf)(cause).name : "AgentRunError";
|
|
19
22
|
}
|
|
20
23
|
}
|
|
21
|
-
exports.
|
|
22
|
-
/**
|
|
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
|
-
*/
|
|
24
|
+
exports.AgentRunError = AgentRunError;
|
|
25
|
+
/** Stateful autonomous orchestration, built entirely on independent public modules. */
|
|
82
26
|
class Agent {
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
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;
|
|
27
|
+
options;
|
|
28
|
+
session;
|
|
29
|
+
promptBuilder;
|
|
30
|
+
generator;
|
|
31
|
+
toolExecutor;
|
|
32
|
+
events = new data_1.Events();
|
|
33
|
+
controller;
|
|
34
|
+
last;
|
|
103
35
|
constructor(options) {
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
}
|
|
110
|
-
this.
|
|
111
|
-
this.
|
|
112
|
-
this.
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
this.
|
|
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);
|
|
36
|
+
this.options = options;
|
|
37
|
+
(0, data_1.assert)(options.session || options.mode, "Supply a session or an explicit mode");
|
|
38
|
+
(0, data_1.assert)(!(options.session && options.mode), "Session and mode are mutually exclusive");
|
|
39
|
+
(0, data_1.assert)(!options.mode || ["tree", "list", "agent"].includes(options.mode), "Invalid agent mode");
|
|
40
|
+
(0, data_1.assert)(!(options.generator && options.provider), "Generator and provider are mutually exclusive");
|
|
41
|
+
const sessionOptions = "sessionOptions" in options ? options.sessionOptions ?? {} : {};
|
|
42
|
+
this.session = (options.session ?? (options.mode === "tree" ? session_1.TreeSession.create(sessionOptions.systemPrompt) : options.mode === "list" ? session_1.ListSession.create(sessionOptions) : session_1.AgentSession.create(sessionOptions)));
|
|
43
|
+
this.generator = options.generator ?? new generator_1.Generator({ provider: options.provider, model: options.model, generation: "generation" in options ? options.generation : undefined });
|
|
44
|
+
this.promptBuilder = options.promptBuilder ?? new prompt_1.PromptBuilder();
|
|
45
|
+
(0, data_1.assert)(!options.toolExecutor || !options.toolkit || options.toolExecutor.toolkit === options.toolkit, "Conflicting tool registries");
|
|
46
|
+
this.toolExecutor = options.toolExecutor ?? new tool_1.ToolExecutor({ ...options.tools, toolkit: options.toolkit ?? new tool_1.ToolKit() });
|
|
47
|
+
}
|
|
48
|
+
on(type, handler) {
|
|
49
|
+
return this.events.on(type, handler);
|
|
198
50
|
}
|
|
199
|
-
|
|
200
|
-
|
|
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;
|
|
51
|
+
get isRunning() {
|
|
52
|
+
return !!this.controller;
|
|
293
53
|
}
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
return this._toolApproval;
|
|
54
|
+
get lastRunState() {
|
|
55
|
+
return this.last;
|
|
297
56
|
}
|
|
298
|
-
/** 获取当前等待外部决策的审批请求 */
|
|
299
57
|
get pendingApprovals() {
|
|
300
|
-
return
|
|
58
|
+
return this.toolExecutor.pendingApprovals;
|
|
301
59
|
}
|
|
302
|
-
/** 外部批准一个 manual 工具审批请求 */
|
|
303
60
|
approve(approvalId) {
|
|
304
|
-
return this.
|
|
61
|
+
return this.toolExecutor.approve(approvalId);
|
|
305
62
|
}
|
|
306
|
-
/** 外部拒绝一个 manual 工具审批请求 */
|
|
307
63
|
reject(approvalId, reason) {
|
|
308
|
-
return this.
|
|
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;
|
|
64
|
+
return this.toolExecutor.reject(approvalId, reason);
|
|
322
65
|
}
|
|
323
|
-
|
|
324
|
-
|
|
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) {
|
|
66
|
+
abort(reason = "Generation cancelled") {
|
|
67
|
+
if (!this.controller || this.controller.signal.aborted)
|
|
346
68
|
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);
|
|
69
|
+
this.controller.abort(new DOMException(reason, "AbortError"));
|
|
354
70
|
return true;
|
|
355
71
|
}
|
|
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" });
|
|
72
|
+
idle() {
|
|
73
|
+
(0, data_1.assert)(!this.isRunning && !this.session.isGenerating, "Agent or session already has an active run");
|
|
388
74
|
}
|
|
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;
|
|
75
|
+
async notify(event) {
|
|
398
76
|
try {
|
|
399
|
-
this.
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
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);
|
|
77
|
+
await this.events.emit(event);
|
|
78
|
+
}
|
|
79
|
+
catch (error) {
|
|
80
|
+
(this.options.onHandlerError ?? (error => console.error(error)))((0, data_1.errorOf)(error));
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
async chat(input, options = {}) {
|
|
84
|
+
this.idle();
|
|
85
|
+
options.signal?.throwIfAborted();
|
|
86
|
+
const message = input instanceof message_1.Message ? input : message_1.Message.user(input);
|
|
87
|
+
(0, data_1.assert)(message.role === message_1.Role.User, "chat requires a user message");
|
|
88
|
+
this.session.addMessage(message);
|
|
89
|
+
return this.execute("chat", options);
|
|
90
|
+
}
|
|
91
|
+
/** Autonomous execution from already prepared context, without adding a user input. */
|
|
92
|
+
async run(options = {}) {
|
|
93
|
+
this.idle();
|
|
94
|
+
return this.execute("run", options);
|
|
95
|
+
}
|
|
96
|
+
continuationTarget(options) {
|
|
97
|
+
const history = this.session.history();
|
|
98
|
+
const target = options.targetMessageId ? this.session.getMessage(options.targetMessageId) : [...history].reverse().find(m => m.role === message_1.Role.Assistant);
|
|
99
|
+
(0, data_1.assert)(target?.role === message_1.Role.Assistant && history.includes(target), "Continuation requires an assistant in the selected history");
|
|
100
|
+
(0, data_1.assert)(history.at(-1) === target && !target.toolCalls.length, "Continue a final selected reply; unfinished tool calls require resume");
|
|
101
|
+
return target;
|
|
102
|
+
}
|
|
103
|
+
async continue(options = {}) {
|
|
104
|
+
this.idle();
|
|
105
|
+
const target = this.continuationTarget(options);
|
|
106
|
+
return this.execute("continue", options, target, options.instruction ?? "Continue the previous response without repeating it.", options.carryThinking !== false);
|
|
107
|
+
}
|
|
108
|
+
async resume(options = {}) {
|
|
109
|
+
this.idle();
|
|
110
|
+
(0, data_1.assert)(this.last && this.last.status !== "completed" && this.last.stopReason !== "conflict", "No resumable in-process run");
|
|
111
|
+
return this.execute("resume", options, undefined, "Continue the interrupted task. Do not repeat completed tool operations.", false, this.last.runId);
|
|
112
|
+
}
|
|
113
|
+
promptInput(history, kind, target, instruction, carryThinking = false) {
|
|
114
|
+
const messages = [...history];
|
|
115
|
+
const sources = [];
|
|
116
|
+
if (instruction) {
|
|
117
|
+
if (carryThinking && target?.thinking) {
|
|
118
|
+
const thinking = message_1.Message.assistant(target.thinking).tag(exports.TEMPORARY_PROMPT_TAG, exports.CONTINUATION_THINKING_TAG);
|
|
119
|
+
messages.push(thinking);
|
|
120
|
+
sources.push({ messageId: thinking.id, sourceMessageId: target.id, sourceRevision: target.revision, injected: true, source: "agent.continue.thinking" });
|
|
463
121
|
}
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
const
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
const
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
};
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
const
|
|
509
|
-
const
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
const
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
this.
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
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,
|
|
122
|
+
const user = message_1.Message.user(instruction).tag(exports.TEMPORARY_PROMPT_TAG, kind === "continue" ? exports.CONTINUATION_INSTRUCTION_TAG : "agent-engine:resume-instruction");
|
|
123
|
+
messages.push(user);
|
|
124
|
+
sources.push({ messageId: user.id, injected: true, source: `agent.${kind}.instruction` });
|
|
125
|
+
}
|
|
126
|
+
return { messages, options: { sources } };
|
|
127
|
+
}
|
|
128
|
+
async previewContext(options = {}) {
|
|
129
|
+
const kind = options.kind ?? "run";
|
|
130
|
+
const target = options.kind === "continue" ? this.continuationTarget(options) : undefined;
|
|
131
|
+
if (kind === "resume")
|
|
132
|
+
(0, data_1.assert)(this.last && this.last.status !== "completed" && this.last.stopReason !== "conflict", "No resumable in-process run");
|
|
133
|
+
const instruction = options.kind === "continue" ? options.instruction ?? "Continue the previous response without repeating it." : kind === "resume" ? "Continue the interrupted task. Do not repeat completed tool operations." : undefined;
|
|
134
|
+
const input = this.promptInput(this.session.history(), kind, target, instruction, options.kind === "continue" && options.carryThinking !== false);
|
|
135
|
+
return this.promptBuilder.preview(input.messages, input.options);
|
|
136
|
+
}
|
|
137
|
+
async prepareCommit(generated, context, signal) {
|
|
138
|
+
if (context.targetMessageId)
|
|
139
|
+
context.targetMessage = this.session.getMessage(context.targetMessageId)?.snapshot();
|
|
140
|
+
const transformed = await (0, data_1.abortable)(Promise.resolve(this.options.hooks?.beforeCommit?.(generated, context)), signal);
|
|
141
|
+
if (transformed)
|
|
142
|
+
generated = transformed;
|
|
143
|
+
(0, data_1.assert)(generated.role === message_1.Role.Assistant, "Model commit must be an assistant message");
|
|
144
|
+
this.session.assertGenerationUnchanged();
|
|
145
|
+
if (context.operation !== "append")
|
|
146
|
+
return { generated };
|
|
147
|
+
const target = this.session.getMessage(context.targetMessageId);
|
|
148
|
+
(0, data_1.assert)(target, "Continuation target no longer exists");
|
|
149
|
+
const prepared = (0, session_1.prepareContinuation)(target, generated);
|
|
150
|
+
const baseline = prepared.draft.snapshot();
|
|
151
|
+
const draft = await (0, data_1.abortable)(Promise.resolve(this.options.hooks?.beforeAppend?.(prepared.draft, { ...context, targetMessage: target.snapshot(), generatedMessage: generated.snapshot() })), signal) ?? prepared.draft;
|
|
152
|
+
this.session.assertGenerationUnchanged();
|
|
153
|
+
return { generated, append: { draft, baseline } };
|
|
154
|
+
}
|
|
155
|
+
async execute(kind, options, target, instruction, carryThinking = false, resumedFrom) {
|
|
156
|
+
const config = { maxSteps: 10, ...this.options.execution, ...options.execution };
|
|
157
|
+
(0, data_1.assert)(Number.isSafeInteger(config.maxSteps) && config.maxSteps >= 0, "maxSteps must be a non-negative integer (0 means unlimited)");
|
|
158
|
+
if (config.timeoutMs !== undefined)
|
|
159
|
+
(0, data_1.assert)(Number.isFinite(config.timeoutMs) && config.timeoutMs >= 0, "timeoutMs must be non-negative (0 means unlimited)");
|
|
160
|
+
const controller = new AbortController();
|
|
161
|
+
this.controller = controller;
|
|
162
|
+
const externalAbort = () => controller.abort(options.signal?.reason);
|
|
163
|
+
options.signal?.addEventListener("abort", externalAbort, { once: true });
|
|
164
|
+
if (options.signal?.aborted)
|
|
165
|
+
externalAbort();
|
|
166
|
+
const timer = !config.timeoutMs ? undefined : setTimeout(() => controller.abort(new DOMException("Agent run timed out", "TimeoutError")), config.timeoutMs);
|
|
167
|
+
const session = this.session;
|
|
168
|
+
const trace = session.trace;
|
|
169
|
+
const turnId = resumedFrom ? trace.records.runs.find(r => r.id === resumedFrom)?.turnId : session.currentTurnId;
|
|
170
|
+
const run = trace.run(kind, turnId, target?.id, resumedFrom);
|
|
171
|
+
let lastMessage;
|
|
172
|
+
let stepId;
|
|
173
|
+
let generated;
|
|
174
|
+
let first = true;
|
|
175
|
+
let started = false;
|
|
176
|
+
let modelCompleted = false;
|
|
177
|
+
let unappliedToolResults = [];
|
|
178
|
+
let result;
|
|
179
|
+
const toolEvents = this.toolExecutor.on("*", event => {
|
|
180
|
+
const eventRun = event.type === "approvalRequired" ? event.request.runId : event.record.runId;
|
|
181
|
+
if (eventRun === run.id)
|
|
182
|
+
return this.notify(event);
|
|
584
183
|
});
|
|
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
184
|
try {
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
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);
|
|
185
|
+
session.beginGeneration();
|
|
186
|
+
started = true;
|
|
187
|
+
await this.notify({ type: "runStarted", runId: run.id });
|
|
188
|
+
for (let index = 0; config.maxSteps === 0 || index < config.maxSteps; index++) {
|
|
189
|
+
controller.signal.throwIfAborted();
|
|
190
|
+
session.assertGenerationUnchanged();
|
|
191
|
+
const step = trace.step(run.id);
|
|
192
|
+
stepId = step.id;
|
|
193
|
+
modelCompleted = false;
|
|
194
|
+
const input = this.promptInput(session.history(), kind, target, first ? instruction : undefined, carryThinking);
|
|
195
|
+
const context = await (0, data_1.abortable)(this.promptBuilder.buildContext(input.messages, input.options), controller.signal);
|
|
196
|
+
await (0, data_1.abortable)(Promise.resolve(this.options.hooks?.beforeRequest?.(context, { runId: run.id, stepId })), controller.signal);
|
|
197
|
+
session.assertGenerationUnchanged();
|
|
198
|
+
const response = await this.generator.generate({ messages: context.messages, tools: this.toolExecutor.toolkit.definitions, generation: options.generation, signal: controller.signal, stream: options.stream, requestTimeoutMs: options.requestTimeoutMs ?? this.options.requestTimeoutMs,
|
|
199
|
+
thinking: { mode: "auto", scope: "tool_call", ...this.generator.options.thinking, ...this.options.thinking, ...options.thinking }, identity: { runId: run.id, stepId }, onEvent: event => this.notify(event) });
|
|
200
|
+
generated = response.message;
|
|
201
|
+
modelCompleted = true;
|
|
202
|
+
trace.updateStep(stepId, { status: "completed", finishReason: response.finishReason, usage: response.usage });
|
|
203
|
+
const commitContext = { runId: run.id, stepId, operation: target && first ? "append" : "create", targetMessageId: target && first ? target.id : undefined };
|
|
204
|
+
const prepared = await this.prepareCommit(generated, commitContext, controller.signal);
|
|
205
|
+
generated = prepared.generated;
|
|
206
|
+
session.assertGenerationUnchanged();
|
|
207
|
+
const previousIds = new Set(session.history().map(message => message.id));
|
|
208
|
+
lastMessage = target && first ? session.appendContinuation(target.id, generated, prepared.append) : session.appendGenerated(generated);
|
|
209
|
+
trace.updateStep(stepId, { messageId: lastMessage.id });
|
|
210
|
+
trace.contribute({ messageId: lastMessage.id, revision: lastMessage.revision, runId: run.id, stepId, operation: commitContext.operation });
|
|
211
|
+
for (const message of session.history())
|
|
212
|
+
if (!previousIds.has(message.id) && message.id !== lastMessage.id)
|
|
213
|
+
trace.contribute({ messageId: message.id, revision: message.revision, runId: run.id, stepId, operation: "create" });
|
|
214
|
+
const calls = [...generated.toolCalls];
|
|
215
|
+
generated = undefined;
|
|
216
|
+
await this.notify({ type: "messageCommitted", runId: run.id, stepId, message: lastMessage.snapshot(), operation: commitContext.operation });
|
|
217
|
+
await this.options.hooks?.afterCommit?.(lastMessage, commitContext);
|
|
218
|
+
first = false;
|
|
219
|
+
if (response.finishReason === "length")
|
|
220
|
+
throw new Error("Model output limit reached");
|
|
221
|
+
if (!calls.length) {
|
|
222
|
+
result = { runId: run.id, turnId, status: "completed", stopReason: "final", message: lastMessage, usage: trace.usage(run.id) };
|
|
772
223
|
break;
|
|
773
224
|
}
|
|
225
|
+
const executeTool = (call) => this.toolExecutor.execute(call, { signal: controller.signal, runId: run.id, stepId,
|
|
226
|
+
errorPolicy: config.toolErrorPolicy === "pause" || config.toolErrorPolicy === "throw" ? "throw" : "return", onRecord: record => {
|
|
227
|
+
trace.tool(record);
|
|
228
|
+
} });
|
|
229
|
+
let failure;
|
|
230
|
+
const outcomes = [];
|
|
231
|
+
if (config.toolConcurrency === "parallel") {
|
|
232
|
+
const settled = await Promise.allSettled(calls.map(executeTool));
|
|
233
|
+
for (let i = 0; i < settled.length; i++) {
|
|
234
|
+
const item = settled[i];
|
|
235
|
+
if (item.status === "fulfilled")
|
|
236
|
+
outcomes.push(item.value);
|
|
237
|
+
else {
|
|
238
|
+
failure ??= item.reason;
|
|
239
|
+
outcomes.push(this.failedTool(calls[i], item.reason, run.id, stepId));
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
else {
|
|
244
|
+
for (let i = 0; i < calls.length; i++) {
|
|
245
|
+
if (failure) {
|
|
246
|
+
outcomes.push(this.failedTool(calls[i], new Error("Not executed after an earlier tool failure"), run.id, stepId));
|
|
247
|
+
continue;
|
|
248
|
+
}
|
|
249
|
+
try {
|
|
250
|
+
outcomes.push(await executeTool(calls[i]));
|
|
251
|
+
}
|
|
252
|
+
catch (error) {
|
|
253
|
+
failure = error;
|
|
254
|
+
outcomes.push(this.failedTool(calls[i], error, run.id, stepId));
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
}
|
|
258
|
+
unappliedToolResults = outcomes.map(outcome => outcome.message);
|
|
259
|
+
for (const outcome of outcomes) {
|
|
260
|
+
session.appendGenerated(outcome.message);
|
|
261
|
+
trace.tool(outcome.record);
|
|
262
|
+
unappliedToolResults.shift();
|
|
263
|
+
}
|
|
264
|
+
if (failure)
|
|
265
|
+
throw failure;
|
|
774
266
|
}
|
|
775
|
-
}
|
|
776
|
-
for (const tc of approvedToolCalls) {
|
|
777
|
-
const result = resultByCallId.get(tc.toolCallId);
|
|
778
267
|
if (!result)
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
|
|
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;
|
|
268
|
+
throw new Error("Agent reached maxSteps without a final reply");
|
|
269
|
+
}
|
|
270
|
+
catch (error) {
|
|
271
|
+
const partial = error instanceof provider_1.GenerationError ? error.partial?.message : undefined;
|
|
272
|
+
const timedOut = (0, data_1.errorOf)(controller.signal.aborted ? controller.signal.reason : error instanceof provider_1.GenerationError ? error.cause : error).name === "TimeoutError";
|
|
273
|
+
const interrupted = controller.signal.aborted || timedOut;
|
|
274
|
+
let conflict = error instanceof session_1.SessionConflictError;
|
|
275
|
+
let unappliedPartial = partial;
|
|
276
|
+
if (stepId && !modelCompleted)
|
|
277
|
+
trace.updateStep(stepId, { status: interrupted ? "interrupted" : "failed", error: (0, data_1.errorOf)(error).message });
|
|
278
|
+
// Only the initial failed continuation segment rolls back. Later tool-loop steps
|
|
279
|
+
// create independent replies and retain partial output just like an ordinary run.
|
|
280
|
+
if (partial && !partial.isEmpty && (!target || !first || interrupted) && started && stepId) {
|
|
281
|
+
try {
|
|
282
|
+
const commitContext = { runId: run.id, stepId, operation: target && first ? "append" : "create", targetMessageId: target && first ? target.id : undefined };
|
|
283
|
+
const prepared = await this.prepareCommit(partial, commitContext);
|
|
284
|
+
const transformed = prepared.generated;
|
|
285
|
+
lastMessage = target && first ? session.appendContinuation(target.id, transformed, prepared.append) : session.appendGenerated(transformed);
|
|
286
|
+
unappliedPartial = undefined;
|
|
287
|
+
trace.updateStep(stepId, { messageId: lastMessage.id });
|
|
288
|
+
trace.contribute({ messageId: lastMessage.id, revision: lastMessage.revision, runId: run.id, stepId, operation: commitContext.operation });
|
|
289
|
+
for (const call of transformed.toolCalls)
|
|
290
|
+
session.appendGenerated(message_1.Message.tool(call.toolCallId, { error: "Incomplete tool call; no operation was executed", interrupted: true }, call.name));
|
|
291
|
+
await this.notify({ type: "messageCommitted", runId: run.id, stepId, message: lastMessage.snapshot(), operation: commitContext.operation });
|
|
292
|
+
}
|
|
293
|
+
catch (commitError) {
|
|
294
|
+
if (commitError instanceof session_1.SessionConflictError)
|
|
295
|
+
conflict = true;
|
|
844
296
|
}
|
|
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
297
|
}
|
|
856
|
-
|
|
857
|
-
|
|
858
|
-
|
|
859
|
-
|
|
860
|
-
|
|
861
|
-
|
|
862
|
-
|
|
863
|
-
|
|
298
|
+
if (started && !conflict && stepId) {
|
|
299
|
+
try {
|
|
300
|
+
session.assertGenerationUnchanged();
|
|
301
|
+
const history = session.history();
|
|
302
|
+
const answered = new Set(history.flatMap(message => message.parts.filter(part => part.type === "tool_result").map(part => part.toolCallId)));
|
|
303
|
+
for (const message of history)
|
|
304
|
+
for (const call of message.toolCalls)
|
|
305
|
+
if (!answered.has(call.toolCallId)) {
|
|
306
|
+
const outcome = this.failedTool(call, new Error("Run stopped before this tool produced a result; operation was not started by this step"), run.id, stepId);
|
|
307
|
+
session.appendGenerated(outcome.message);
|
|
308
|
+
trace.tool(outcome.record);
|
|
309
|
+
answered.add(call.toolCallId);
|
|
310
|
+
}
|
|
311
|
+
}
|
|
312
|
+
catch { /* External edits take precedence over protocol repairs. */
|
|
313
|
+
}
|
|
864
314
|
}
|
|
865
|
-
|
|
315
|
+
result = { runId: run.id, turnId, status: interrupted ? "interrupted" : "failed", stopReason: conflict ? "conflict" : interrupted ? timedOut ? "timeout" : "abort" : error instanceof tool_1.ToolExecutionError ? "toolError" : (0, data_1.errorOf)(error).message.includes("maxSteps") ? "maxSteps" : "error", message: lastMessage, usage: trace.usage(run.id), error: (0, data_1.errorOf)(error), unapplied: generated ?? unappliedPartial, unappliedToolResults: unappliedToolResults.length ? unappliedToolResults : undefined };
|
|
866
316
|
}
|
|
867
|
-
|
|
868
|
-
|
|
869
|
-
|
|
870
|
-
|
|
871
|
-
|
|
872
|
-
|
|
873
|
-
|
|
874
|
-
|
|
875
|
-
}
|
|
876
|
-
|
|
877
|
-
|
|
878
|
-
|
|
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) {
|
|
317
|
+
finally {
|
|
318
|
+
if (started)
|
|
319
|
+
session.endGeneration();
|
|
320
|
+
toolEvents();
|
|
321
|
+
if (timer !== undefined)
|
|
322
|
+
clearTimeout(timer);
|
|
323
|
+
options.signal?.removeEventListener("abort", externalAbort);
|
|
324
|
+
this.controller = undefined;
|
|
325
|
+
}
|
|
326
|
+
this.last = result;
|
|
327
|
+
trace.updateRun(run.id, { status: result.status, stopReason: result.stopReason });
|
|
328
|
+
await this.notify({ type: "runFinished", runId: run.id, result: result });
|
|
944
329
|
try {
|
|
945
|
-
|
|
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);
|
|
330
|
+
await this.options.hooks?.afterRun?.(result);
|
|
1002
331
|
}
|
|
1003
|
-
|
|
1004
|
-
|
|
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;
|
|
332
|
+
catch (error) {
|
|
333
|
+
throw new AgentRunError(result, error);
|
|
1131
334
|
}
|
|
1132
|
-
|
|
1133
|
-
|
|
335
|
+
if (result.error)
|
|
336
|
+
throw new AgentRunError(result, result.error);
|
|
337
|
+
return result;
|
|
1134
338
|
}
|
|
1135
|
-
|
|
1136
|
-
const
|
|
1137
|
-
|
|
1138
|
-
|
|
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
|
-
}
|
|
339
|
+
failedTool(call, error, runId, stepId) {
|
|
340
|
+
const message = message_1.Message.tool(call.toolCallId, { error: (0, data_1.errorOf)(error).message }, call.name);
|
|
341
|
+
const record = error instanceof tool_1.ToolExecutionError ? { ...error.record, resultMessageId: message.id } : { id: (0, data_1.id)("execution"), runId, stepId, toolCallId: call.toolCallId, name: call.name, arguments: {}, status: "failed", resultMessageId: message.id, error: (0, data_1.errorOf)(error).message };
|
|
342
|
+
return { message, record };
|
|
1166
343
|
}
|
|
1167
344
|
}
|
|
1168
345
|
exports.Agent = Agent;
|