@notic/agent-engine 2.1.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 +56 -15
- package/README.md +97 -434
- package/dist/agent/Agent.d.ts +133 -355
- package/dist/agent/Agent.d.ts.map +1 -1
- package/dist/agent/Agent.js +302 -1123
- 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 -33
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +21 -92
- 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 +16 -0
- package/dist/session/AgentSession.d.ts.map +1 -0
- package/dist/session/AgentSession.js +24 -0
- package/dist/session/AgentSession.js.map +1 -0
- 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 +46 -0
- package/dist/session/ListSession.d.ts.map +1 -0
- package/dist/session/ListSession.js +205 -0
- package/dist/session/ListSession.js.map +1 -0
- 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 -5
- package/dist/session/index.d.ts.map +1 -1
- package/dist/session/index.js +24 -12
- 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 -1698
- 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
package/dist/tool/Tool.js
CHANGED
|
@@ -1,198 +1,51 @@
|
|
|
1
1
|
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
2
5
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.Tool = void 0;
|
|
4
|
-
const
|
|
5
|
-
const
|
|
6
|
-
const
|
|
7
|
-
|
|
8
|
-
* 工具定义 — Builder 模式
|
|
9
|
-
*
|
|
10
|
-
* build() 前: 构建阶段,链式配置
|
|
11
|
-
* build() 后: 冻结状态,只能create() 调用实例
|
|
12
|
-
*
|
|
13
|
-
* 用法:
|
|
14
|
-
* const weather = Tool.create(getWeatherFn)
|
|
15
|
-
* .name("get_weather")
|
|
16
|
-
* .description("获取天气")
|
|
17
|
-
* .params(
|
|
18
|
-
* Param.string("city").desc("城市名").required(),
|
|
19
|
-
* Param.string("unit").desc("单位").enum(["celsius", "fahrenheit"]),
|
|
20
|
-
* )
|
|
21
|
-
* .on(Hook.ON_ERROR, (ctx) => { ctx.result = "暂不可用"; })
|
|
22
|
-
* .build();
|
|
23
|
-
*/
|
|
6
|
+
exports.ToolArgumentsError = exports.Tool = void 0;
|
|
7
|
+
const data_1 = require("../core/data");
|
|
8
|
+
const ajv_1 = __importDefault(require("ajv"));
|
|
9
|
+
const _2020_1 = __importDefault(require("ajv/dist/2020"));
|
|
10
|
+
const ajv_formats_1 = __importDefault(require("ajv-formats"));
|
|
24
11
|
class Tool {
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
this._func = func;
|
|
34
|
-
this._name = name || func.name || "unnamed";
|
|
35
|
-
// 初始化所有 Hook的handler 列表
|
|
36
|
-
for (const hook of Object.values(Hook_1.Hook)) {
|
|
37
|
-
this._hooks.set(hook, []);
|
|
38
|
-
}
|
|
12
|
+
validator;
|
|
13
|
+
options;
|
|
14
|
+
constructor(options) {
|
|
15
|
+
(0, data_1.assert)(options.name.trim() && typeof options.execute === "function", "Invalid tool definition");
|
|
16
|
+
this.options = { ...options, parameters: (0, data_1.immutable)((0, data_1.copy)(options.parameters)) };
|
|
17
|
+
const compiler = String(options.parameters.$schema ?? "").includes("2020-12") ? new _2020_1.default({ allErrors: true }) : new ajv_1.default({ allErrors: true });
|
|
18
|
+
(0, ajv_formats_1.default)(compiler);
|
|
19
|
+
this.validator = compiler.compile((0, data_1.copy)(options.parameters));
|
|
39
20
|
}
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
// ========================
|
|
43
|
-
/**
|
|
44
|
-
* 创建工具 Builder
|
|
45
|
-
* @param fn 工具执行函数,签名 (args: Record<string, unknown>) => unknown
|
|
46
|
-
*/
|
|
47
|
-
static create(fn) {
|
|
48
|
-
return new Tool(fn);
|
|
21
|
+
static define(options) {
|
|
22
|
+
return new Tool(options);
|
|
49
23
|
}
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
*跳过 Builder 阶段,直接进入 built 状态
|
|
53
|
-
*/
|
|
54
|
-
static fromRaw(name, description, schema, fn) {
|
|
55
|
-
const tool = new Tool(fn, name);
|
|
56
|
-
tool._description = description;
|
|
57
|
-
tool._schema = schema;
|
|
58
|
-
tool._built = true;
|
|
59
|
-
return tool;
|
|
24
|
+
get name() {
|
|
25
|
+
return this.options.name;
|
|
60
26
|
}
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
// ========================
|
|
64
|
-
name(n) {
|
|
65
|
-
this.guardNotBuilt();
|
|
66
|
-
this._name = n;
|
|
67
|
-
return this;
|
|
27
|
+
get requiresApproval() {
|
|
28
|
+
return this.options.requiresApproval ?? false;
|
|
68
29
|
}
|
|
69
|
-
|
|
70
|
-
this.
|
|
71
|
-
this._description = desc;
|
|
72
|
-
return this;
|
|
30
|
+
get definition() {
|
|
31
|
+
return (0, data_1.copy)({ name: this.name, description: this.options.description, parameters: this.options.parameters });
|
|
73
32
|
}
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
this.guardNotBuilt();
|
|
79
|
-
this._params.push(...params);
|
|
80
|
-
return this;
|
|
33
|
+
validate(arguments_) {
|
|
34
|
+
if (!arguments_ || typeof arguments_ !== "object" || Array.isArray(arguments_) || !this.validator(arguments_))
|
|
35
|
+
throw new ToolArgumentsError(this.validator.errors?.map(error => `${error.instancePath || "/"} ${error.message}`).join("; ") || "Tool arguments must be an object");
|
|
36
|
+
return arguments_;
|
|
81
37
|
}
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
*/
|
|
85
|
-
on(hook, handler) {
|
|
86
|
-
this.guardNotBuilt();
|
|
87
|
-
this._hooks.get(hook).push(handler);
|
|
88
|
-
return this;
|
|
89
|
-
}
|
|
90
|
-
/**
|
|
91
|
-
* 冻结配置,生成 JSON Schema
|
|
92
|
-
*/
|
|
93
|
-
build() {
|
|
94
|
-
this.guardNotBuilt();
|
|
95
|
-
// 组装 properties和 required
|
|
96
|
-
const properties = {};
|
|
97
|
-
const required = [];
|
|
98
|
-
for (const param of this._params) {
|
|
99
|
-
properties[param.name] = param.toSchema();
|
|
100
|
-
if (param.isRequired) {
|
|
101
|
-
required.push(param.name);
|
|
102
|
-
}
|
|
103
|
-
}
|
|
104
|
-
this._schema = {
|
|
105
|
-
type: "function",
|
|
106
|
-
function: {
|
|
107
|
-
name: this._name,
|
|
108
|
-
description: this._description,
|
|
109
|
-
parameters: {
|
|
110
|
-
type: "object",
|
|
111
|
-
properties,
|
|
112
|
-
required,
|
|
113
|
-
},
|
|
114
|
-
},
|
|
115
|
-
};
|
|
116
|
-
this._built = true;
|
|
117
|
-
return this;
|
|
118
|
-
}
|
|
119
|
-
// ========================
|
|
120
|
-
// 运行时(build 后)
|
|
121
|
-
// ========================
|
|
122
|
-
/** 获取 OpenAI tools 格式的 JSON Schema */
|
|
123
|
-
get schema() {
|
|
124
|
-
this.guardBuilt();
|
|
125
|
-
return this._schema;
|
|
126
|
-
}
|
|
127
|
-
/** 工具名*/
|
|
128
|
-
get toolName() {
|
|
129
|
-
return this._name;
|
|
130
|
-
}
|
|
131
|
-
/** 执行函数 */
|
|
132
|
-
get func() {
|
|
133
|
-
return this._func;
|
|
134
|
-
}
|
|
135
|
-
/**
|
|
136
|
-
* 从模版创建一次具体的函数调用
|
|
137
|
-
*
|
|
138
|
-
* @param toolCallId LLM 返回的 tool_call id
|
|
139
|
-
* @param args 调用参数
|
|
140
|
-
*/
|
|
141
|
-
create(toolCallId, args, signal) {
|
|
142
|
-
this.guardBuilt();
|
|
143
|
-
const ctx = new Context_1.Context(toolCallId, this._name, { ...args }, signal);
|
|
144
|
-
try {
|
|
145
|
-
// ---- ON_CREATE ----
|
|
146
|
-
this.fire(Hook_1.Hook.ON_CREATE, ctx);
|
|
147
|
-
// ---- ON_VALIDATE ----
|
|
148
|
-
this.fire(Hook_1.Hook.ON_VALIDATE, ctx);
|
|
149
|
-
//内置校验:必填参数
|
|
150
|
-
const requiredParams = this._params.filter((p) => p.isRequired);
|
|
151
|
-
const missing = requiredParams
|
|
152
|
-
.filter((p) => !(p.name in ctx.arguments))
|
|
153
|
-
.map((p) => p.name);
|
|
154
|
-
if (missing.length > 0) {
|
|
155
|
-
throw new Error(`缺少必填参数: ${missing.join(", ")}`);
|
|
156
|
-
}
|
|
157
|
-
}
|
|
158
|
-
catch (e) {
|
|
159
|
-
const error = e instanceof Error ? e : new Error(String(e));
|
|
160
|
-
ctx.error = error;
|
|
161
|
-
// ---- ON_ERROR ----
|
|
162
|
-
this.fire(Hook_1.Hook.ON_ERROR, ctx);
|
|
163
|
-
// ON_ERROR 未提供降级结果则继续抛出
|
|
164
|
-
if (ctx.result === undefined) {
|
|
165
|
-
throw error;
|
|
166
|
-
}
|
|
167
|
-
}
|
|
168
|
-
return new ToolCall_1.ToolCall(this, toolCallId, this._name, ctx.arguments, signal, ctx);
|
|
169
|
-
}
|
|
170
|
-
/**
|
|
171
|
-
* 触发钩子链
|
|
172
|
-
*/
|
|
173
|
-
fire(hook, ctx) {
|
|
174
|
-
const handlers = this._hooks.get(hook) || [];
|
|
175
|
-
for (const handler of handlers) {
|
|
176
|
-
const result = handler(ctx);
|
|
177
|
-
if (result instanceof Context_1.Context) {
|
|
178
|
-
ctx = result;
|
|
179
|
-
}
|
|
180
|
-
}
|
|
181
|
-
return ctx;
|
|
182
|
-
}
|
|
183
|
-
// ========================
|
|
184
|
-
// 防护
|
|
185
|
-
// ========================
|
|
186
|
-
guardBuilt() {
|
|
187
|
-
if (!this._built) {
|
|
188
|
-
throw new Error("工具尚未构建,请先调用 build()");
|
|
189
|
-
}
|
|
190
|
-
}
|
|
191
|
-
guardNotBuilt() {
|
|
192
|
-
if (this._built) {
|
|
193
|
-
throw new Error("工具已构建,无法修改");
|
|
194
|
-
}
|
|
38
|
+
execute(arguments_, context) {
|
|
39
|
+
return this.options.execute(arguments_, context);
|
|
195
40
|
}
|
|
196
41
|
}
|
|
197
42
|
exports.Tool = Tool;
|
|
43
|
+
class ToolArgumentsError extends Error {
|
|
44
|
+
code = "TOOL_ARGUMENTS";
|
|
45
|
+
constructor(message) {
|
|
46
|
+
super(message);
|
|
47
|
+
this.name = "ToolArgumentsError";
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
exports.ToolArgumentsError = ToolArgumentsError;
|
|
198
51
|
//# sourceMappingURL=Tool.js.map
|
package/dist/tool/Tool.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Tool.js","sourceRoot":"","sources":["../../src/tool/Tool.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"Tool.js","sourceRoot":"","sources":["../../src/tool/Tool.ts"],"names":[],"mappings":";;;;;;AAAA,uCAAuD;AAEvD,8CAA4C;AAC5C,0DAAoC;AACpC,8DAAqC;AAarC,MAAa,IAAI;IACL,SAAS,CAAmB;IAC5B,OAAO,CAAiB;IAChC,YAAY,OAAuB;QAC/B,IAAA,aAAM,EAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU,EAAE,yBAAyB,CAAC,CAAC;QAChG,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,IAAA,gBAAS,EAAC,IAAA,WAAI,EAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAC/E,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,eAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,aAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChJ,IAAA,qBAAU,EAAC,QAAQ,CAAC,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAA,WAAI,EAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,CAAC,MAAM,CAAoC,OAAuB;QACpE,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC7B,CAAC;IACD,IAAI,gBAAgB;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,KAAK,CAAC;IAClD,CAAC;IACD,IAAI,UAAU;QACV,OAAO,IAAA,WAAI,EAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACjH,CAAC;IACD,QAAQ,CAAC,UAAmB;QACxB,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;YACzG,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,IAAI,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,kCAAkC,CAAC,CAAC;QACxK,OAAO,UAAe,CAAC;IAC3B,CAAC;IACD,OAAO,CAAC,UAAa,EAAE,OAAoB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;CACJ;AA9BD,oBA8BC;AACD,MAAa,kBAAmB,SAAQ,KAAK;IAChC,IAAI,GAAG,gBAAgB,CAAC;IACjC,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACrC,CAAC;CACJ;AAND,gDAMC"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { Message, ToolCallPart } from "../message";
|
|
2
|
+
import type { ToolExecutionRecord } from "../session/trace";
|
|
3
|
+
import { ToolKit } from './ToolKit';
|
|
4
|
+
export declare class ToolExecutionError extends Error {
|
|
5
|
+
readonly record: ToolExecutionRecord;
|
|
6
|
+
readonly cause?: unknown | undefined;
|
|
7
|
+
readonly code = "TOOL_EXECUTION";
|
|
8
|
+
constructor(message: string, record: ToolExecutionRecord, cause?: unknown | undefined);
|
|
9
|
+
}
|
|
10
|
+
export interface ApprovalRequest {
|
|
11
|
+
approvalId: string;
|
|
12
|
+
toolExecutionId: string;
|
|
13
|
+
toolCallId: string;
|
|
14
|
+
name: string;
|
|
15
|
+
arguments: Record<string, unknown>;
|
|
16
|
+
runId?: string;
|
|
17
|
+
stepId?: string;
|
|
18
|
+
}
|
|
19
|
+
export type ApprovalDecision = "allow" | "deny" | "ask" | {
|
|
20
|
+
action: "allow" | "deny" | "ask";
|
|
21
|
+
reason?: string;
|
|
22
|
+
};
|
|
23
|
+
export interface ToolExecutorOptions {
|
|
24
|
+
toolkit: ToolKit;
|
|
25
|
+
approval?: "auto" | "manual" | ((request: ApprovalRequest) => ApprovalDecision | Promise<ApprovalDecision>);
|
|
26
|
+
approvalTimeoutMs?: number;
|
|
27
|
+
errorPolicy?: "return" | "throw";
|
|
28
|
+
}
|
|
29
|
+
export type ToolEvent = {
|
|
30
|
+
type: "approvalRequired";
|
|
31
|
+
request: ApprovalRequest;
|
|
32
|
+
} | {
|
|
33
|
+
type: "toolUpdated";
|
|
34
|
+
record: ToolExecutionRecord;
|
|
35
|
+
};
|
|
36
|
+
export interface ToolOutcome {
|
|
37
|
+
message: Message;
|
|
38
|
+
record: ToolExecutionRecord;
|
|
39
|
+
}
|
|
40
|
+
export declare class ToolExecutor {
|
|
41
|
+
private options;
|
|
42
|
+
readonly toolkit: ToolKit;
|
|
43
|
+
private events;
|
|
44
|
+
private pending;
|
|
45
|
+
constructor(options: ToolExecutorOptions);
|
|
46
|
+
on(type: ToolEvent["type"] | "*", handler: (event: ToolEvent) => unknown): () => void;
|
|
47
|
+
get pendingApprovals(): ApprovalRequest[];
|
|
48
|
+
approve(approvalId: string): boolean;
|
|
49
|
+
reject(approvalId: string, reason?: string): boolean;
|
|
50
|
+
execute(call: ToolCallPart, context?: {
|
|
51
|
+
signal?: AbortSignal;
|
|
52
|
+
runId?: string;
|
|
53
|
+
stepId?: string;
|
|
54
|
+
onRecord?: (record: ToolExecutionRecord) => void | Promise<void>;
|
|
55
|
+
errorPolicy?: "return" | "throw";
|
|
56
|
+
}): Promise<ToolOutcome>;
|
|
57
|
+
private wait;
|
|
58
|
+
}
|
|
59
|
+
//# sourceMappingURL=ToolExecutor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ToolExecutor.d.ts","sourceRoot":"","sources":["../../src/tool/ToolExecutor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,qBAAa,kBAAmB,SAAQ,KAAK;IAEZ,QAAQ,CAAC,MAAM,EAAE,mBAAmB;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IAD3F,QAAQ,CAAC,IAAI,oBAAoB;gBACrB,OAAO,EAAE,MAAM,EAAW,MAAM,EAAE,mBAAmB,EAAW,KAAK,CAAC,EAAE,OAAO,YAAA;CAI9F;AACD,MAAM,WAAW,eAAe;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG;IACtD,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AACF,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5G,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACpC;AACD,MAAM,MAAM,SAAS,GAAG;IACpB,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,eAAe,CAAC;CAC5B,GAAG;IACA,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AACF,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;CAC/B;AACD,qBAAa,YAAY;IAUT,OAAO,CAAC,OAAO;IAT3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAMV;gBACe,OAAO,EAAE,mBAAmB;IAGhD,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,GAAG,MAAM,IAAI;IAGrF,IAAI,gBAAgB,IAAI,eAAe,EAAE,CAExC;IACD,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAOpC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,SAAqB,GAAG,OAAO;IAO1D,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,GAAE;QACvC,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACjE,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;KAC/B,GAAG,OAAO,CAAC,WAAW,CAAC;YAgEf,IAAI;CAuBrB"}
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.ToolExecutor = exports.ToolExecutionError = void 0;
|
|
4
|
+
const data_1 = require("../core/data");
|
|
5
|
+
const message_1 = require("../message");
|
|
6
|
+
const Tool_1 = require("./Tool");
|
|
7
|
+
class ToolExecutionError extends Error {
|
|
8
|
+
record;
|
|
9
|
+
cause;
|
|
10
|
+
code = "TOOL_EXECUTION";
|
|
11
|
+
constructor(message, record, cause) {
|
|
12
|
+
super(message);
|
|
13
|
+
this.record = record;
|
|
14
|
+
this.cause = cause;
|
|
15
|
+
this.name = "ToolExecutionError";
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
exports.ToolExecutionError = ToolExecutionError;
|
|
19
|
+
class ToolExecutor {
|
|
20
|
+
options;
|
|
21
|
+
toolkit;
|
|
22
|
+
events = new data_1.Events();
|
|
23
|
+
pending = new Map();
|
|
24
|
+
constructor(options) {
|
|
25
|
+
this.options = options;
|
|
26
|
+
this.toolkit = options.toolkit;
|
|
27
|
+
}
|
|
28
|
+
on(type, handler) {
|
|
29
|
+
return this.events.on(type, handler);
|
|
30
|
+
}
|
|
31
|
+
get pendingApprovals() {
|
|
32
|
+
return (0, data_1.copy)([...this.pending.values()].map(item => item.request));
|
|
33
|
+
}
|
|
34
|
+
approve(approvalId) {
|
|
35
|
+
const pending = this.pending.get(approvalId);
|
|
36
|
+
if (!pending)
|
|
37
|
+
return false;
|
|
38
|
+
pending.resolve({ approved: true });
|
|
39
|
+
return true;
|
|
40
|
+
}
|
|
41
|
+
reject(approvalId, reason = "Rejected by user") {
|
|
42
|
+
const pending = this.pending.get(approvalId);
|
|
43
|
+
if (!pending)
|
|
44
|
+
return false;
|
|
45
|
+
pending.resolve({ approved: false, reason });
|
|
46
|
+
return true;
|
|
47
|
+
}
|
|
48
|
+
async execute(call, context = {}) {
|
|
49
|
+
const record = { id: (0, data_1.id)("execution"), name: call.name, toolCallId: call.toolCallId, runId: context.runId, stepId: context.stepId, arguments: {}, status: "running" };
|
|
50
|
+
const update = async () => {
|
|
51
|
+
await context.onRecord?.((0, data_1.copy)(record));
|
|
52
|
+
await this.events.emit({ type: "toolUpdated", record: (0, data_1.copy)(record) });
|
|
53
|
+
};
|
|
54
|
+
try {
|
|
55
|
+
context.signal?.throwIfAborted();
|
|
56
|
+
const tool = this.toolkit.get(call.name);
|
|
57
|
+
(0, data_1.assert)(tool && this.toolkit.isEnabled(call.name), `Unavailable tool: ${call.name}`);
|
|
58
|
+
let args;
|
|
59
|
+
try {
|
|
60
|
+
args = call.arguments.trim() ? JSON.parse(call.arguments) : {};
|
|
61
|
+
}
|
|
62
|
+
catch {
|
|
63
|
+
throw new Tool_1.ToolArgumentsError("Tool arguments are not valid JSON");
|
|
64
|
+
}
|
|
65
|
+
const validated = tool.validate(args);
|
|
66
|
+
record.arguments = (0, data_1.copy)(validated);
|
|
67
|
+
const request = { approvalId: (0, data_1.id)("approval"), toolExecutionId: record.id, toolCallId: call.toolCallId, name: call.name, arguments: (0, data_1.copy)(validated), runId: context.runId, stepId: context.stepId };
|
|
68
|
+
const decision = typeof this.options.approval === "function" ? await (0, data_1.abortable)(Promise.resolve(this.options.approval(request)), context.signal) : this.options.approval === "manual" || tool.requiresApproval ? "ask" : "allow";
|
|
69
|
+
const action = typeof decision === "string" ? decision : decision.action;
|
|
70
|
+
let accepted = { approved: action === "allow", reason: typeof decision === "object" ? decision.reason : undefined };
|
|
71
|
+
if (action === "ask") {
|
|
72
|
+
record.status = "awaitingApproval";
|
|
73
|
+
await update();
|
|
74
|
+
accepted = await this.wait(request, context.signal);
|
|
75
|
+
}
|
|
76
|
+
if (!accepted.approved) {
|
|
77
|
+
record.status = "rejected";
|
|
78
|
+
record.error = accepted.reason ?? "Tool execution denied";
|
|
79
|
+
const message = message_1.Message.tool(call.toolCallId, { error: record.error, rejected: true }, call.name);
|
|
80
|
+
record.resultMessageId = message.id;
|
|
81
|
+
await update();
|
|
82
|
+
return { message, record: (0, data_1.copy)(record) };
|
|
83
|
+
}
|
|
84
|
+
context.signal?.throwIfAborted();
|
|
85
|
+
(0, data_1.assert)(this.toolkit.isEnabled(call.name), `Tool disabled before execution: ${call.name}`);
|
|
86
|
+
record.status = "running";
|
|
87
|
+
await update();
|
|
88
|
+
const toolContext = { signal: context.signal, runId: context.runId, stepId: context.stepId, toolExecutionId: record.id, toolCallId: call.toolCallId, throwIfAborted: () => context.signal?.throwIfAborted() };
|
|
89
|
+
const result = await (0, data_1.abortable)(Promise.resolve(tool.execute(validated, toolContext)), context.signal);
|
|
90
|
+
const message = message_1.Message.tool(call.toolCallId, result, call.name);
|
|
91
|
+
record.status = "completed";
|
|
92
|
+
record.resultMessageId = message.id;
|
|
93
|
+
await update();
|
|
94
|
+
return { message, record: (0, data_1.copy)(record) };
|
|
95
|
+
}
|
|
96
|
+
catch (error) {
|
|
97
|
+
record.status = context.signal?.aborted ? "interrupted" : "failed";
|
|
98
|
+
record.error = (0, data_1.errorOf)(error).message;
|
|
99
|
+
const message = message_1.Message.tool(call.toolCallId, { error: record.error, interrupted: record.status === "interrupted" }, call.name);
|
|
100
|
+
record.resultMessageId = message.id;
|
|
101
|
+
await update();
|
|
102
|
+
if (context.signal?.aborted)
|
|
103
|
+
throw new ToolExecutionError(record.error, (0, data_1.copy)(record), error);
|
|
104
|
+
if ((context.errorPolicy ?? this.options.errorPolicy) === "throw")
|
|
105
|
+
throw new ToolExecutionError(record.error, (0, data_1.copy)(record), error);
|
|
106
|
+
return { message, record: (0, data_1.copy)(record) };
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
async wait(request, signal) {
|
|
110
|
+
let timer;
|
|
111
|
+
const promise = new Promise(resolve => {
|
|
112
|
+
this.pending.set(request.approvalId, { request: (0, data_1.copy)(request), resolve });
|
|
113
|
+
if (this.options.approvalTimeoutMs !== undefined)
|
|
114
|
+
timer = setTimeout(() => resolve({ approved: false, reason: "Approval timed out" }), this.options.approvalTimeoutMs);
|
|
115
|
+
});
|
|
116
|
+
try {
|
|
117
|
+
await this.events.emit({ type: "approvalRequired", request: (0, data_1.copy)(request) });
|
|
118
|
+
return await (0, data_1.abortable)(promise, signal);
|
|
119
|
+
}
|
|
120
|
+
finally {
|
|
121
|
+
if (timer)
|
|
122
|
+
clearTimeout(timer);
|
|
123
|
+
this.pending.delete(request.approvalId);
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
exports.ToolExecutor = ToolExecutor;
|
|
128
|
+
//# sourceMappingURL=ToolExecutor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ToolExecutor.js","sourceRoot":"","sources":["../../src/tool/ToolExecutor.ts"],"names":[],"mappings":"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"}
|
package/dist/tool/ToolKit.d.ts
CHANGED
|
@@ -1,75 +1,18 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
import { Message } from "../message/Message";
|
|
4
|
-
export type ToolErrorPolicy = "return_to_model" | "throw";
|
|
5
|
-
export declare class ToolExecutionError extends Error {
|
|
6
|
-
readonly toolCallId: string;
|
|
7
|
-
readonly toolName: string;
|
|
8
|
-
readonly cause?: unknown;
|
|
9
|
-
constructor(toolCallId: string, toolName: string, cause: unknown);
|
|
10
|
-
}
|
|
11
|
-
export declare class ToolArgumentsError extends Error {
|
|
12
|
-
readonly rawArguments: string;
|
|
13
|
-
constructor(message: string, rawArguments: string);
|
|
14
|
-
}
|
|
15
|
-
export interface ToolExecutionOptions {
|
|
16
|
-
/** 中断信号:传入 Tool Context,供工具内部响应取消 */
|
|
17
|
-
signal?: AbortSignal;
|
|
18
|
-
/** 工具错误策略:默认 return_to_model */
|
|
19
|
-
errorPolicy?: ToolErrorPolicy;
|
|
20
|
-
}
|
|
21
|
-
/**
|
|
22
|
-
* 工具包管理器
|
|
23
|
-
*
|
|
24
|
-
* 统一管理所有工具,作为 Message 系统与 Tool 系统之间的桥梁。
|
|
25
|
-
*
|
|
26
|
-
* 用法:
|
|
27
|
-
*const toolkit = new ToolKit()
|
|
28
|
-
* .add(weatherTool, timeTool);
|
|
29
|
-
*
|
|
30
|
-
* await toolkit.addMCP(mcpClient);// 自动发现 MCP 工具
|
|
31
|
-
*
|
|
32
|
-
* const tools = toolkit.schemas;// 丢给LLM
|
|
33
|
-
* const results = await toolkit.executeAll(msg.toolCalls); // 批量执行
|
|
34
|
-
*/
|
|
1
|
+
import type { ToolDefinition } from "../provider";
|
|
2
|
+
import { Tool } from './Tool';
|
|
35
3
|
export declare class ToolKit {
|
|
36
|
-
private
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
add(...tools: Tool[]): this;
|
|
41
|
-
/**
|
|
42
|
-
* 从 MCP Client 自动发现并注册工具
|
|
43
|
-
*
|
|
44
|
-
* @param client @modelcontextprotocol/sdk的 Client 实例
|
|
45
|
-
*/
|
|
46
|
-
addMCP(client: McpClientLike): Promise<this>;
|
|
47
|
-
/** 按名称获取工具 */
|
|
48
|
-
get(name: string): Tool | undefined;
|
|
49
|
-
/** 检查工具是否存在 */
|
|
50
|
-
has(name: string): boolean;
|
|
51
|
-
/** 所有工具的schema,直接传给LLM 的 tools参数 */
|
|
52
|
-
get schemas(): ToolSchema[];
|
|
53
|
-
/** 所有工具名*/
|
|
54
|
-
get names(): string[];
|
|
55
|
-
/** 工具数量 */
|
|
4
|
+
private tools;
|
|
5
|
+
private visible;
|
|
6
|
+
add(...tools: Tool<any>[]): this;
|
|
7
|
+
get(name: string): Tool<any> | undefined;
|
|
56
8
|
get size(): number;
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
/**
|
|
64
|
-
* 并行执行多个 ToolCallPart
|
|
65
|
-
*/
|
|
66
|
-
executeAll(toolCallParts: ToolCallPart[], options?: ToolExecutionOptions): Promise<Message[]>;
|
|
67
|
-
private parseArguments;
|
|
9
|
+
has(name: string): boolean;
|
|
10
|
+
enable(name: string): this;
|
|
11
|
+
disable(name: string): this;
|
|
12
|
+
isEnabled(name: string): boolean;
|
|
13
|
+
get definitions(): ToolDefinition[];
|
|
14
|
+
addMCP(client: McpClientLike): Promise<this>;
|
|
68
15
|
}
|
|
69
|
-
/**
|
|
70
|
-
* MCP Client最小接口
|
|
71
|
-
*避免直接依赖 @modelcontextprotocol/sdk 的具体类型
|
|
72
|
-
*/
|
|
73
16
|
export interface McpClientLike {
|
|
74
17
|
listTools(): Promise<{
|
|
75
18
|
tools: Array<{
|
|
@@ -78,14 +21,11 @@ export interface McpClientLike {
|
|
|
78
21
|
inputSchema: Record<string, unknown>;
|
|
79
22
|
}>;
|
|
80
23
|
}>;
|
|
81
|
-
callTool(
|
|
24
|
+
callTool(input: {
|
|
82
25
|
name: string;
|
|
83
|
-
arguments
|
|
84
|
-
}
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
text?: string;
|
|
88
|
-
}>;
|
|
89
|
-
}>;
|
|
26
|
+
arguments: Record<string, unknown>;
|
|
27
|
+
}, options?: {
|
|
28
|
+
signal?: AbortSignal;
|
|
29
|
+
}): Promise<unknown>;
|
|
90
30
|
}
|
|
91
31
|
//# sourceMappingURL=ToolKit.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ToolKit.d.ts","sourceRoot":"","sources":["../../src/tool/ToolKit.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"ToolKit.d.ts","sourceRoot":"","sources":["../../src/tool/ToolKit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,qBAAa,OAAO;IAChB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,OAAO,CAAqB;IACpC,GAAG,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAQhC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS;IAGxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAG1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAGhC,IAAI,WAAW,IAAI,cAAc,EAAE,CAElC;IACK,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrD;AACD,MAAM,WAAW,aAAa;IAC1B,SAAS,IAAI,OAAO,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC;YACT,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACxC,CAAC,CAAC;KACN,CAAC,CAAC;IACH,QAAQ,CAAC,KAAK,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,EAAE,OAAO,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,WAAW,CAAC;KACxB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxB"}
|