@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
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.ExecutionTrace = void 0;
|
|
4
|
+
const data_1 = require("../core/data");
|
|
5
|
+
class ExecutionTrace {
|
|
6
|
+
data = { turns: [], runs: [], steps: [], tools: [], contributions: [] };
|
|
7
|
+
get records() {
|
|
8
|
+
return (0, data_1.immutable)((0, data_1.copy)(this.data));
|
|
9
|
+
}
|
|
10
|
+
turn(inputs) {
|
|
11
|
+
const record = { id: (0, data_1.id)("turn"), inputMessageIds: [...inputs], createdAt: new Date().toISOString() };
|
|
12
|
+
this.data.turns.push(record);
|
|
13
|
+
return (0, data_1.copy)(record);
|
|
14
|
+
}
|
|
15
|
+
run(kind, turnId, targetMessageId, resumedFrom) {
|
|
16
|
+
const record = { id: (0, data_1.id)("run"), kind, turnId, targetMessageId, resumedFrom, status: "running", createdAt: new Date().toISOString() };
|
|
17
|
+
this.data.runs.push(record);
|
|
18
|
+
return (0, data_1.copy)(record);
|
|
19
|
+
}
|
|
20
|
+
step(runId) {
|
|
21
|
+
const record = { id: (0, data_1.id)("step"), runId, index: this.data.steps.filter(s => s.runId === runId).length, status: "running" };
|
|
22
|
+
this.data.steps.push(record);
|
|
23
|
+
return (0, data_1.copy)(record);
|
|
24
|
+
}
|
|
25
|
+
updateRun(runId, patch) {
|
|
26
|
+
const record = this.data.runs.find(r => r.id === runId);
|
|
27
|
+
(0, data_1.assert)(record, "Unknown run");
|
|
28
|
+
Object.assign(record, (0, data_1.copy)(patch));
|
|
29
|
+
}
|
|
30
|
+
updateStep(stepId, patch) {
|
|
31
|
+
const record = this.data.steps.find(s => s.id === stepId);
|
|
32
|
+
(0, data_1.assert)(record, "Unknown step");
|
|
33
|
+
Object.assign(record, (0, data_1.copy)(patch));
|
|
34
|
+
}
|
|
35
|
+
tool(record) {
|
|
36
|
+
const index = this.data.tools.findIndex(t => t.id === record.id);
|
|
37
|
+
if (index < 0)
|
|
38
|
+
this.data.tools.push((0, data_1.copy)(record));
|
|
39
|
+
else
|
|
40
|
+
this.data.tools[index] = (0, data_1.copy)(record);
|
|
41
|
+
}
|
|
42
|
+
contribute(record) {
|
|
43
|
+
this.data.contributions.push((0, data_1.copy)(record));
|
|
44
|
+
}
|
|
45
|
+
source(messageId) {
|
|
46
|
+
return (0, data_1.copy)(this.data.contributions.find(c => c.messageId === messageId));
|
|
47
|
+
}
|
|
48
|
+
usage(runId) {
|
|
49
|
+
return this.data.steps.filter(s => !runId || s.runId === runId).reduce((sum, s) => ({ inputTokens: sum.inputTokens + (s.usage?.inputTokens ?? 0), outputTokens: sum.outputTokens + (s.usage?.outputTokens ?? 0), totalTokens: sum.totalTokens + (s.usage?.totalTokens ?? 0) }), { inputTokens: 0, outputTokens: 0, totalTokens: 0 });
|
|
50
|
+
}
|
|
51
|
+
toJSON() {
|
|
52
|
+
return JSON.parse(JSON.stringify(this.data));
|
|
53
|
+
}
|
|
54
|
+
static fromJSON(data) {
|
|
55
|
+
const trace = new ExecutionTrace();
|
|
56
|
+
(0, data_1.assert)(data && [data.turns, data.runs, data.steps, data.tools, data.contributions].every(Array.isArray), "Invalid execution trace");
|
|
57
|
+
const identifiers = new Set();
|
|
58
|
+
for (const record of [...data.turns, ...data.runs, ...data.steps, ...data.tools]) {
|
|
59
|
+
(0, data_1.assert)(typeof record.id === "string" && !identifiers.has(record.id), "Duplicate execution identity");
|
|
60
|
+
identifiers.add(record.id);
|
|
61
|
+
}
|
|
62
|
+
const statuses = ["running", "completed", "interrupted", "failed"];
|
|
63
|
+
for (const turn of data.turns)
|
|
64
|
+
(0, data_1.assert)(Array.isArray(turn.inputMessageIds) && turn.inputMessageIds.every(key => typeof key === "string"), "Invalid turn inputs");
|
|
65
|
+
for (const run of data.runs) {
|
|
66
|
+
(0, data_1.assert)(statuses.includes(run.status) && ["chat", "run", "continue", "resume"].includes(run.kind), "Invalid run record");
|
|
67
|
+
(0, data_1.assert)(!run.turnId || data.turns.some(t => t.id === run.turnId), "Unknown turn reference");
|
|
68
|
+
(0, data_1.assert)(!run.resumedFrom || data.runs.some(r => r.id === run.resumedFrom && r.id !== run.id), "Unknown resumed run");
|
|
69
|
+
}
|
|
70
|
+
for (const step of data.steps) {
|
|
71
|
+
(0, data_1.assert)(statuses.includes(step.status) && Number.isSafeInteger(step.index) && step.index >= 0, "Invalid model step");
|
|
72
|
+
(0, data_1.assert)(data.runs.some(r => r.id === step.runId), "Unknown run reference");
|
|
73
|
+
if (step.usage)
|
|
74
|
+
(0, data_1.assert)([step.usage.inputTokens, step.usage.outputTokens, step.usage.totalTokens].every(value => Number.isFinite(value) && value >= 0), "Invalid token usage");
|
|
75
|
+
}
|
|
76
|
+
for (const tool of data.tools) {
|
|
77
|
+
(0, data_1.assert)(["awaitingApproval", "rejected", ...statuses].includes(tool.status) && typeof tool.toolCallId === "string" && typeof tool.name === "string" && tool.arguments && typeof tool.arguments === "object", "Invalid tool record");
|
|
78
|
+
(0, data_1.assert)(!tool.runId || data.runs.some(run => run.id === tool.runId), "Unknown tool run reference");
|
|
79
|
+
(0, data_1.assert)(!tool.stepId || data.steps.some(s => s.id === tool.stepId && (!tool.runId || s.runId === tool.runId)), "Unknown tool step reference");
|
|
80
|
+
}
|
|
81
|
+
for (const contribution of data.contributions) {
|
|
82
|
+
(0, data_1.assert)(typeof contribution.messageId === "string" && Number.isSafeInteger(contribution.revision) && contribution.revision >= 0 && ["create", "append", "replace"].includes(contribution.operation), "Invalid message contribution");
|
|
83
|
+
(0, data_1.assert)(data.steps.some(s => s.id === contribution.stepId && s.runId === contribution.runId), "Unknown contribution reference");
|
|
84
|
+
}
|
|
85
|
+
trace.data = (0, data_1.copy)(data);
|
|
86
|
+
return trace;
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
exports.ExecutionTrace = ExecutionTrace;
|
|
90
|
+
//# sourceMappingURL=trace.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/session/trace.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import { Message, MessageContent, MessageData, Role } from "../message";
|
|
2
|
+
import { ExecutionTrace, TraceData } from "./trace";
|
|
3
|
+
import type { SessionQuery } from "./SessionQuery";
|
|
4
|
+
import type { TreeStructure, ListStructure, AgentStructure } from "./structures";
|
|
5
|
+
export declare class SessionConflictError extends Error {
|
|
6
|
+
readonly code = "SESSION_CONFLICT";
|
|
7
|
+
constructor();
|
|
8
|
+
}
|
|
9
|
+
export type QueryScope = "active" | "all";
|
|
10
|
+
export type SessionQueries = Pick<SessionQuery, "messages" | "turns" | "runs" | "steps" | "toolExecutions">;
|
|
11
|
+
export interface MessageCriteria {
|
|
12
|
+
id?: string;
|
|
13
|
+
role?: Role;
|
|
14
|
+
tags?: readonly string[];
|
|
15
|
+
content?: string | RegExp;
|
|
16
|
+
partType?: MessageData["parts"][number]["type"];
|
|
17
|
+
metadata?: Record<string, unknown>;
|
|
18
|
+
turnId?: string;
|
|
19
|
+
runId?: string;
|
|
20
|
+
stepId?: string;
|
|
21
|
+
toolCallId?: string;
|
|
22
|
+
scope?: QueryScope;
|
|
23
|
+
offset?: number;
|
|
24
|
+
limit?: number;
|
|
25
|
+
predicate?: (message: Message) => boolean;
|
|
26
|
+
}
|
|
27
|
+
export interface SessionDataBase {
|
|
28
|
+
format: "agent-engine-session";
|
|
29
|
+
version: 3;
|
|
30
|
+
id: string;
|
|
31
|
+
title?: string;
|
|
32
|
+
metadata?: Record<string, unknown>;
|
|
33
|
+
systemMessageId: string;
|
|
34
|
+
messages: MessageData[];
|
|
35
|
+
trace: TraceData;
|
|
36
|
+
}
|
|
37
|
+
export interface TreeSessionData extends SessionDataBase {
|
|
38
|
+
type: "tree";
|
|
39
|
+
structure: TreeStructure;
|
|
40
|
+
}
|
|
41
|
+
export interface ListSessionData extends SessionDataBase {
|
|
42
|
+
type: "list";
|
|
43
|
+
structure: ListStructure;
|
|
44
|
+
}
|
|
45
|
+
export interface AgentSessionData extends SessionDataBase {
|
|
46
|
+
type: "agent";
|
|
47
|
+
structure: AgentStructure;
|
|
48
|
+
}
|
|
49
|
+
export type SessionData = TreeSessionData | ListSessionData | AgentSessionData;
|
|
50
|
+
export interface ContinuationCommitOptions {
|
|
51
|
+
draft?: Message;
|
|
52
|
+
baseline?: Message;
|
|
53
|
+
}
|
|
54
|
+
export interface SessionLike {
|
|
55
|
+
readonly id: string;
|
|
56
|
+
readonly type: SessionData["type"];
|
|
57
|
+
readonly trace: ExecutionTrace;
|
|
58
|
+
readonly query: SessionQueries;
|
|
59
|
+
readonly currentTurnId: string | undefined;
|
|
60
|
+
readonly isGenerating: boolean;
|
|
61
|
+
readonly metadata: Readonly<Record<string, unknown>>;
|
|
62
|
+
setMeta(key: string, value: unknown): this;
|
|
63
|
+
deleteMeta(key: string): this;
|
|
64
|
+
history(): Message[];
|
|
65
|
+
addMessage(message: Message): Message;
|
|
66
|
+
addUser(content: MessageContent): Message;
|
|
67
|
+
getMessage(id: string): Message | undefined;
|
|
68
|
+
editMessage(id: string, edit: (message: Message) => void): Message;
|
|
69
|
+
beginGeneration(): void;
|
|
70
|
+
assertGenerationUnchanged(): void;
|
|
71
|
+
appendGenerated(message: Message): Message;
|
|
72
|
+
appendContinuation(targetId: string, generated: Message, options?: ContinuationCommitOptions): Message;
|
|
73
|
+
endGeneration(): void;
|
|
74
|
+
toJSON(): SessionData;
|
|
75
|
+
}
|
|
76
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjF,qBAAa,oBAAqB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,sBAAsB;;CAKtC;AACD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC;AAC1C,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,gBAAgB,CAAC,CAAC;AAC5G,MAAM,WAAW,eAAe;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CAC7C;AACD,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,SAAS,CAAC;CACpB;AACD,MAAM,WAAW,eAAgB,SAAQ,eAAe;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,aAAa,CAAC;CAAE;AACpG,MAAM,WAAW,eAAgB,SAAQ,eAAe;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,aAAa,CAAC;CAAE;AACpG,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IAAG,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,cAAc,CAAC;CAAE;AACvG,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAC/E,MAAM,WAAW,yBAAyB;IAAG,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAAE;AACnF,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1E,OAAO,IAAI,OAAO,EAAE,CAAC;IACrB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IACtC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;IAC1C,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC5C,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;IACnE,eAAe,IAAI,IAAI,CAAC;IACxB,yBAAyB,IAAI,IAAI,CAAC;IAClC,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IAC3C,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACvG,aAAa,IAAI,IAAI,CAAC;IACtB,MAAM,IAAI,WAAW,CAAC;CACzB"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.SessionConflictError = void 0;
|
|
4
|
+
class SessionConflictError extends Error {
|
|
5
|
+
code = "SESSION_CONFLICT";
|
|
6
|
+
constructor() {
|
|
7
|
+
super("The session changed while generation was in progress");
|
|
8
|
+
this.name = "SessionConflictError";
|
|
9
|
+
}
|
|
10
|
+
}
|
|
11
|
+
exports.SessionConflictError = SessionConflictError;
|
|
12
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":";;;AAIA,MAAa,oBAAqB,SAAQ,KAAK;IAClC,IAAI,GAAG,kBAAkB,CAAC;IACnC;QACI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACvC,CAAC;CACJ;AAND,oDAMC"}
|
package/dist/tool/Tool.d.ts
CHANGED
|
@@ -1,92 +1,29 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
/** OpenAI tools 格式的 schema */
|
|
10
|
-
export interface ToolSchema {
|
|
11
|
-
type: "function";
|
|
12
|
-
function: {
|
|
13
|
-
name: string;
|
|
14
|
-
description: string;
|
|
15
|
-
parameters: {
|
|
16
|
-
type: "object";
|
|
17
|
-
properties: Record<string, unknown>;
|
|
18
|
-
required: string[];
|
|
19
|
-
};
|
|
20
|
-
};
|
|
1
|
+
import type { ToolDefinition } from "../provider";
|
|
2
|
+
export interface ToolContext {
|
|
3
|
+
signal?: AbortSignal;
|
|
4
|
+
runId?: string;
|
|
5
|
+
stepId?: string;
|
|
6
|
+
toolExecutionId: string;
|
|
7
|
+
toolCallId: string;
|
|
8
|
+
throwIfAborted(): void;
|
|
21
9
|
}
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
private _func;
|
|
41
|
-
private _name;
|
|
42
|
-
private _description;
|
|
43
|
-
private _params;
|
|
44
|
-
private _hooks;
|
|
45
|
-
private _built;
|
|
46
|
-
private _schema?;
|
|
47
|
-
private constructor();
|
|
48
|
-
/**
|
|
49
|
-
* 创建工具 Builder
|
|
50
|
-
* @param fn 工具执行函数,签名 (args: Record<string, unknown>) => unknown
|
|
51
|
-
*/
|
|
52
|
-
static create(fn: ToolFunction): Tool;
|
|
53
|
-
/**
|
|
54
|
-
* 从已有的schema + 执行函数直接创建(用于 MCP 等外部工具)
|
|
55
|
-
*跳过 Builder 阶段,直接进入 built 状态
|
|
56
|
-
*/
|
|
57
|
-
static fromRaw(name: string, description: string, schema: ToolSchema, fn: ToolFunction): Tool;
|
|
58
|
-
name(n: string): this;
|
|
59
|
-
description(desc: string): this;
|
|
60
|
-
/**
|
|
61
|
-
* 批量添加参数
|
|
62
|
-
*/
|
|
63
|
-
params(...params: Param[]): this;
|
|
64
|
-
/**
|
|
65
|
-
* 注册钩子,同一Hook 可注册多个handler,按注册顺序执行
|
|
66
|
-
*/
|
|
67
|
-
on(hook: Hook, handler: HookHandler): this;
|
|
68
|
-
/**
|
|
69
|
-
* 冻结配置,生成 JSON Schema
|
|
70
|
-
*/
|
|
71
|
-
build(): this;
|
|
72
|
-
/** 获取 OpenAI tools 格式的 JSON Schema */
|
|
73
|
-
get schema(): ToolSchema;
|
|
74
|
-
/** 工具名*/
|
|
75
|
-
get toolName(): string;
|
|
76
|
-
/** 执行函数 */
|
|
77
|
-
get func(): ToolFunction;
|
|
78
|
-
/**
|
|
79
|
-
* 从模版创建一次具体的函数调用
|
|
80
|
-
*
|
|
81
|
-
* @param toolCallId LLM 返回的 tool_call id
|
|
82
|
-
* @param args 调用参数
|
|
83
|
-
*/
|
|
84
|
-
create(toolCallId: string, args: Record<string, unknown>, signal?: AbortSignal): ToolCall;
|
|
85
|
-
/**
|
|
86
|
-
* 触发钩子链
|
|
87
|
-
*/
|
|
88
|
-
fire(hook: Hook, ctx: Context): Context;
|
|
89
|
-
private guardBuilt;
|
|
90
|
-
private guardNotBuilt;
|
|
10
|
+
export interface ToolOptions<A extends Record<string, unknown> = Record<string, unknown>> extends ToolDefinition {
|
|
11
|
+
execute: (arguments_: A, context: ToolContext) => unknown | Promise<unknown>;
|
|
12
|
+
requiresApproval?: boolean;
|
|
13
|
+
}
|
|
14
|
+
export declare class Tool<A extends Record<string, unknown> = Record<string, unknown>> {
|
|
15
|
+
private validator;
|
|
16
|
+
private options;
|
|
17
|
+
constructor(options: ToolOptions<A>);
|
|
18
|
+
static define<A extends Record<string, unknown>>(options: ToolOptions<A>): Tool<A>;
|
|
19
|
+
get name(): string;
|
|
20
|
+
get requiresApproval(): boolean;
|
|
21
|
+
get definition(): ToolDefinition;
|
|
22
|
+
validate(arguments_: unknown): A;
|
|
23
|
+
execute(arguments_: A, context: ToolContext): unknown | Promise<unknown>;
|
|
24
|
+
}
|
|
25
|
+
export declare class ToolArgumentsError extends Error {
|
|
26
|
+
readonly code = "TOOL_ARGUMENTS";
|
|
27
|
+
constructor(message: string);
|
|
91
28
|
}
|
|
92
29
|
//# sourceMappingURL=Tool.d.ts.map
|
package/dist/tool/Tool.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../../src/tool/Tool.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../../src/tool/Tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,WAAW,WAAW;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,IAAI,IAAI,CAAC;CAC1B;AACD,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,SAAQ,cAAc;IAC5G,OAAO,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AACD,qBAAa,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzE,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,OAAO,CAAiB;gBACpB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAOnC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAGlF,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IACD,IAAI,UAAU,IAAI,cAAc,CAE/B;IACD,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,CAAC;IAKhC,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAG3E;AACD,qBAAa,kBAAmB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,oBAAoB;gBACrB,OAAO,EAAE,MAAM;CAI9B"}
|
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"}
|