@notic/agent-engine 2.2.0 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +24 -1
- package/README.md +97 -449
- package/dist/agent/Agent.d.ts +132 -355
- package/dist/agent/Agent.d.ts.map +1 -1
- package/dist/agent/Agent.js +302 -1128
- package/dist/agent/Agent.js.map +1 -1
- package/dist/agent/index.d.ts +1 -1
- package/dist/agent/index.d.ts.map +1 -1
- package/dist/agent/index.js +15 -8
- package/dist/agent/index.js.map +1 -1
- package/dist/core/data.d.ts +17 -0
- package/dist/core/data.d.ts.map +1 -0
- package/dist/core/data.js +86 -0
- package/dist/core/data.js.map +1 -0
- package/dist/generator/Generator.d.ts +37 -0
- package/dist/generator/Generator.d.ts.map +1 -0
- package/dist/generator/Generator.js +71 -0
- package/dist/generator/Generator.js.map +1 -0
- package/dist/generator/index.d.ts +2 -0
- package/dist/generator/index.d.ts.map +1 -0
- package/dist/generator/index.js +18 -0
- package/dist/generator/index.js.map +1 -0
- package/dist/index.d.ts +7 -35
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +21 -94
- package/dist/index.js.map +1 -1
- package/dist/legacy/adapter/AnthropicAdapter.d.ts.map +1 -0
- package/dist/{adapter → legacy/adapter}/AnthropicAdapter.js +3 -3
- package/dist/legacy/adapter/AnthropicAdapter.js.map +1 -0
- package/dist/legacy/adapter/GeminiAdapter.d.ts.map +1 -0
- package/dist/{adapter → legacy/adapter}/GeminiAdapter.js +3 -3
- package/dist/legacy/adapter/GeminiAdapter.js.map +1 -0
- package/dist/legacy/adapter/MessageAdapter.d.ts.map +1 -0
- package/dist/legacy/adapter/MessageAdapter.js.map +1 -0
- package/dist/legacy/adapter/OpenAIAdapter.d.ts.map +1 -0
- package/dist/{adapter → legacy/adapter}/OpenAIAdapter.js +1 -1
- package/dist/legacy/adapter/OpenAIAdapter.js.map +1 -0
- package/dist/legacy/adapter/OpenAIResponsesAdapter.d.ts.map +1 -0
- package/dist/legacy/adapter/OpenAIResponsesAdapter.js.map +1 -0
- package/dist/legacy/adapter/index.d.ts.map +1 -0
- package/dist/legacy/adapter/index.js.map +1 -0
- package/dist/legacy/agent/Agent.d.ts +371 -0
- package/dist/legacy/agent/Agent.d.ts.map +1 -0
- package/dist/legacy/agent/Agent.js +1169 -0
- package/dist/legacy/agent/Agent.js.map +1 -0
- package/dist/legacy/agent/index.d.ts +2 -0
- package/dist/legacy/agent/index.d.ts.map +1 -0
- package/dist/legacy/agent/index.js +11 -0
- package/dist/legacy/agent/index.js.map +1 -0
- package/dist/legacy/client/ModelClient.d.ts.map +1 -0
- package/dist/legacy/client/ModelClient.js.map +1 -0
- package/dist/legacy/client/index.d.ts.map +1 -0
- package/dist/legacy/client/index.js.map +1 -0
- package/dist/legacy/config/RequestConfig.d.ts.map +1 -0
- package/dist/legacy/config/RequestConfig.js.map +1 -0
- package/dist/legacy/config/index.d.ts.map +1 -0
- package/dist/legacy/config/index.js.map +1 -0
- package/dist/legacy/index.d.ts +36 -0
- package/dist/legacy/index.d.ts.map +1 -0
- package/dist/legacy/index.js +97 -0
- package/dist/legacy/index.js.map +1 -0
- package/dist/legacy/media/BrowserMediaResolver.d.ts.map +1 -0
- package/dist/legacy/media/BrowserMediaResolver.js.map +1 -0
- package/dist/legacy/media/DefaultMediaResolver.d.ts.map +1 -0
- package/dist/legacy/media/DefaultMediaResolver.js.map +1 -0
- package/dist/legacy/media/MediaResolver.d.ts.map +1 -0
- package/dist/legacy/media/MediaResolver.js.map +1 -0
- package/dist/legacy/media/index.d.ts.map +1 -0
- package/dist/legacy/media/index.js.map +1 -0
- package/dist/legacy/message/Message.d.ts +147 -0
- package/dist/legacy/message/Message.d.ts.map +1 -0
- package/dist/legacy/message/Message.js +446 -0
- package/dist/legacy/message/Message.js.map +1 -0
- package/dist/legacy/message/MessagePart.d.ts +50 -0
- package/dist/legacy/message/MessagePart.d.ts.map +1 -0
- package/dist/legacy/message/MessagePart.js +6 -0
- package/dist/legacy/message/MessagePart.js.map +1 -0
- package/dist/legacy/message/Role.d.ts +10 -0
- package/dist/legacy/message/Role.d.ts.map +1 -0
- package/dist/legacy/message/Role.js +14 -0
- package/dist/legacy/message/Role.js.map +1 -0
- package/dist/legacy/message/Usage.d.ts.map +1 -0
- package/dist/legacy/message/Usage.js.map +1 -0
- package/dist/legacy/message/index.d.ts +5 -0
- package/dist/legacy/message/index.d.ts.map +1 -0
- package/dist/legacy/message/index.js +10 -0
- package/dist/legacy/message/index.js.map +1 -0
- package/dist/legacy/node.d.ts +3 -0
- package/dist/legacy/node.d.ts.map +1 -0
- package/dist/legacy/node.js +6 -0
- package/dist/legacy/node.js.map +1 -0
- package/dist/legacy/prompt/Injection.d.ts.map +1 -0
- package/dist/legacy/prompt/Injection.js.map +1 -0
- package/dist/legacy/prompt/PromptBuilder.d.ts +284 -0
- package/dist/legacy/prompt/PromptBuilder.d.ts.map +1 -0
- package/dist/legacy/prompt/PromptBuilder.js +491 -0
- package/dist/legacy/prompt/PromptBuilder.js.map +1 -0
- package/dist/legacy/prompt/Rule.d.ts.map +1 -0
- package/dist/legacy/prompt/Rule.js.map +1 -0
- package/dist/legacy/prompt/index.d.ts +4 -0
- package/dist/legacy/prompt/index.d.ts.map +1 -0
- package/dist/legacy/prompt/index.js +10 -0
- package/dist/legacy/prompt/index.js.map +1 -0
- package/dist/legacy/provider/Provider.d.ts +48 -0
- package/dist/legacy/provider/Provider.d.ts.map +1 -0
- package/dist/legacy/provider/Provider.js +73 -0
- package/dist/legacy/provider/Provider.js.map +1 -0
- package/dist/legacy/provider/index.d.ts +2 -0
- package/dist/legacy/provider/index.d.ts.map +1 -0
- package/dist/legacy/provider/index.js +10 -0
- package/dist/legacy/provider/index.js.map +1 -0
- package/dist/legacy/session/AgentSession.d.ts +13 -0
- package/dist/legacy/session/AgentSession.d.ts.map +1 -0
- package/dist/legacy/session/AgentSession.js +3 -0
- package/dist/legacy/session/AgentSession.js.map +1 -0
- package/dist/legacy/session/Inserter.d.ts.map +1 -0
- package/dist/legacy/session/Inserter.js.map +1 -0
- package/dist/legacy/session/ListSession.d.ts +64 -0
- package/dist/legacy/session/ListSession.d.ts.map +1 -0
- package/dist/legacy/session/ListSession.js +251 -0
- package/dist/legacy/session/ListSession.js.map +1 -0
- package/dist/legacy/session/Paginator.d.ts.map +1 -0
- package/dist/legacy/session/Paginator.js.map +1 -0
- package/dist/legacy/session/Query.d.ts.map +1 -0
- package/dist/legacy/session/Query.js.map +1 -0
- package/dist/legacy/session/SearchCriteria.d.ts.map +1 -0
- package/dist/legacy/session/SearchCriteria.js.map +1 -0
- package/dist/legacy/session/Session.d.ts.map +1 -0
- package/dist/legacy/session/Session.js.map +1 -0
- package/dist/legacy/session/index.d.ts +9 -0
- package/dist/legacy/session/index.d.ts.map +1 -0
- package/dist/legacy/session/index.js +17 -0
- package/dist/legacy/session/index.js.map +1 -0
- package/dist/legacy/session/matchUtils.d.ts.map +1 -0
- package/dist/legacy/session/matchUtils.js.map +1 -0
- package/dist/legacy/stream/AnthropicStreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/AnthropicStreamParser.js.map +1 -0
- package/dist/legacy/stream/GeminiStreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/GeminiStreamParser.js.map +1 -0
- package/dist/legacy/stream/MessageStreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/MessageStreamParser.js.map +1 -0
- package/dist/legacy/stream/OpenAIResponsesStreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/OpenAIResponsesStreamParser.js.map +1 -0
- package/dist/legacy/stream/StreamEvent.d.ts.map +1 -0
- package/dist/legacy/stream/StreamEvent.js.map +1 -0
- package/dist/legacy/stream/StreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/StreamParser.js.map +1 -0
- package/dist/legacy/stream/index.d.ts.map +1 -0
- package/dist/legacy/stream/index.js.map +1 -0
- package/dist/legacy/tool/Context.d.ts.map +1 -0
- package/dist/legacy/tool/Context.js.map +1 -0
- package/dist/legacy/tool/Hook.d.ts.map +1 -0
- package/dist/legacy/tool/Hook.js.map +1 -0
- package/dist/legacy/tool/McpToolAdapter.d.ts.map +1 -0
- package/dist/legacy/tool/McpToolAdapter.js.map +1 -0
- package/dist/legacy/tool/Param.d.ts.map +1 -0
- package/dist/legacy/tool/Param.js.map +1 -0
- package/dist/legacy/tool/Tool.d.ts +92 -0
- package/dist/legacy/tool/Tool.d.ts.map +1 -0
- package/dist/legacy/tool/Tool.js +198 -0
- package/dist/legacy/tool/Tool.js.map +1 -0
- package/dist/legacy/tool/ToolCall.d.ts.map +1 -0
- package/dist/legacy/tool/ToolCall.js.map +1 -0
- package/dist/legacy/tool/ToolKit.d.ts +91 -0
- package/dist/legacy/tool/ToolKit.d.ts.map +1 -0
- package/dist/legacy/tool/ToolKit.js +209 -0
- package/dist/legacy/tool/ToolKit.js.map +1 -0
- package/dist/legacy/tool/ValueType.d.ts.map +1 -0
- package/dist/legacy/tool/ValueType.js.map +1 -0
- package/dist/legacy/tool/index.d.ts +9 -0
- package/dist/legacy/tool/index.d.ts.map +1 -0
- package/dist/legacy/tool/index.js +22 -0
- package/dist/legacy/tool/index.js.map +1 -0
- package/dist/legacy/utils/generateId.d.ts.map +1 -0
- package/dist/legacy/utils/generateId.js.map +1 -0
- package/dist/legacy/utils/index.d.ts.map +1 -0
- package/dist/legacy/utils/index.js.map +1 -0
- package/dist/message/Message.d.ts +90 -135
- package/dist/message/Message.d.ts.map +1 -1
- package/dist/message/Message.js +195 -414
- package/dist/message/Message.js.map +1 -1
- package/dist/message/MessagePart.d.ts +7 -1
- package/dist/message/MessagePart.d.ts.map +1 -1
- package/dist/message/MessagePart.js +0 -3
- package/dist/message/MessagePart.js.map +1 -1
- package/dist/message/Role.d.ts.map +1 -1
- package/dist/message/Role.js.map +1 -1
- package/dist/message/index.d.ts +1 -4
- package/dist/message/index.d.ts.map +1 -1
- package/dist/message/index.js +15 -7
- package/dist/message/index.js.map +1 -1
- package/dist/node.d.ts +1 -2
- package/dist/node.d.ts.map +1 -1
- package/dist/node.js +1 -1
- package/dist/node.js.map +1 -1
- package/dist/prompt/PromptBuilder.d.ts +43 -278
- package/dist/prompt/PromptBuilder.d.ts.map +1 -1
- package/dist/prompt/PromptBuilder.js +71 -473
- package/dist/prompt/PromptBuilder.js.map +1 -1
- package/dist/prompt/index.d.ts +1 -3
- package/dist/prompt/index.d.ts.map +1 -1
- package/dist/prompt/index.js +15 -7
- package/dist/prompt/index.js.map +1 -1
- package/dist/provider/HttpProvider.d.ts +32 -0
- package/dist/provider/HttpProvider.d.ts.map +1 -0
- package/dist/provider/HttpProvider.js +160 -0
- package/dist/provider/HttpProvider.js.map +1 -0
- package/dist/provider/Provider.d.ts +125 -45
- package/dist/provider/Provider.d.ts.map +1 -1
- package/dist/provider/Provider.js +77 -58
- package/dist/provider/Provider.js.map +1 -1
- package/dist/provider/capabilities.d.ts +108 -0
- package/dist/provider/capabilities.d.ts.map +1 -0
- package/dist/provider/capabilities.js +10 -0
- package/dist/provider/capabilities.js.map +1 -0
- package/dist/provider/index.d.ts +7 -1
- package/dist/provider/index.d.ts.map +1 -1
- package/dist/provider/index.js +23 -7
- package/dist/provider/index.js.map +1 -1
- package/dist/provider/media.d.ts +9 -0
- package/dist/provider/media.d.ts.map +1 -0
- package/dist/provider/media.js +3 -0
- package/dist/provider/media.js.map +1 -0
- package/dist/provider/transport.d.ts +10 -0
- package/dist/provider/transport.d.ts.map +1 -0
- package/dist/provider/transport.js +121 -0
- package/dist/provider/transport.js.map +1 -0
- package/dist/session/AgentSession.d.ts +14 -11
- package/dist/session/AgentSession.d.ts.map +1 -1
- package/dist/session/AgentSession.js +21 -0
- package/dist/session/AgentSession.js.map +1 -1
- package/dist/session/BaseSession.d.ts +49 -0
- package/dist/session/BaseSession.d.ts.map +1 -0
- package/dist/session/BaseSession.js +147 -0
- package/dist/session/BaseSession.js.map +1 -0
- package/dist/session/ListSession.d.ts +37 -55
- package/dist/session/ListSession.d.ts.map +1 -1
- package/dist/session/ListSession.js +175 -221
- package/dist/session/ListSession.js.map +1 -1
- package/dist/session/SessionQuery.d.ts +31 -0
- package/dist/session/SessionQuery.d.ts.map +1 -0
- package/dist/session/SessionQuery.js +67 -0
- package/dist/session/SessionQuery.js.map +1 -0
- package/dist/session/TreeSession.d.ts +24 -0
- package/dist/session/TreeSession.d.ts.map +1 -0
- package/dist/session/TreeSession.js +122 -0
- package/dist/session/TreeSession.js.map +1 -0
- package/dist/session/continuation.d.ts +9 -0
- package/dist/session/continuation.d.ts.map +1 -0
- package/dist/session/continuation.js +48 -0
- package/dist/session/continuation.js.map +1 -0
- package/dist/session/index.d.ts +10 -8
- package/dist/session/index.d.ts.map +1 -1
- package/dist/session/index.js +24 -14
- package/dist/session/index.js.map +1 -1
- package/dist/session/restoreSession.d.ts +4 -0
- package/dist/session/restoreSession.d.ts.map +1 -0
- package/dist/session/restoreSession.js +12 -0
- package/dist/session/restoreSession.js.map +1 -0
- package/dist/session/structures.d.ts +32 -0
- package/dist/session/structures.d.ts.map +1 -0
- package/dist/session/structures.js +3 -0
- package/dist/session/structures.js.map +1 -0
- package/dist/session/trace.d.ts +73 -0
- package/dist/session/trace.d.ts.map +1 -0
- package/dist/session/trace.js +90 -0
- package/dist/session/trace.js.map +1 -0
- package/dist/session/types.d.ts +76 -0
- package/dist/session/types.d.ts.map +1 -0
- package/dist/session/types.js +12 -0
- package/dist/session/types.js.map +1 -0
- package/dist/tool/Tool.d.ts +26 -89
- package/dist/tool/Tool.d.ts.map +1 -1
- package/dist/tool/Tool.js +38 -185
- package/dist/tool/Tool.js.map +1 -1
- package/dist/tool/ToolExecutor.d.ts +59 -0
- package/dist/tool/ToolExecutor.d.ts.map +1 -0
- package/dist/tool/ToolExecutor.js +128 -0
- package/dist/tool/ToolExecutor.js.map +1 -0
- package/dist/tool/ToolKit.d.ts +17 -77
- package/dist/tool/ToolKit.d.ts.map +1 -1
- package/dist/tool/ToolKit.js +29 -189
- package/dist/tool/ToolKit.js.map +1 -1
- package/dist/tool/index.d.ts +4 -8
- package/dist/tool/index.d.ts.map +1 -1
- package/dist/tool/index.js +17 -19
- package/dist/tool/index.js.map +1 -1
- package/docs/API-2.x.md +1827 -0
- package/docs/API.md +248 -1825
- package/docs/CE-FEEDBACK-3.0.md +148 -0
- package/docs/CHARACTEREDITOR-3.0-NOTES.md +156 -0
- package/docs/DATA-MODEL-3.0.md +248 -0
- package/docs/DESIGN-3.0.md +326 -0
- package/docs/MIGRATION-3.0.md +77 -0
- package/docs/MULTIMEDIA-3.0.md +145 -0
- package/docs/PLAN-3.0.md +121 -0
- package/package.json +37 -26
- package/dist/adapter/AnthropicAdapter.d.ts.map +0 -1
- package/dist/adapter/AnthropicAdapter.js.map +0 -1
- package/dist/adapter/GeminiAdapter.d.ts.map +0 -1
- package/dist/adapter/GeminiAdapter.js.map +0 -1
- package/dist/adapter/MessageAdapter.d.ts.map +0 -1
- package/dist/adapter/MessageAdapter.js.map +0 -1
- package/dist/adapter/OpenAIAdapter.d.ts.map +0 -1
- package/dist/adapter/OpenAIAdapter.js.map +0 -1
- package/dist/adapter/OpenAIResponsesAdapter.d.ts.map +0 -1
- package/dist/adapter/OpenAIResponsesAdapter.js.map +0 -1
- package/dist/adapter/index.d.ts.map +0 -1
- package/dist/adapter/index.js.map +0 -1
- package/dist/client/ModelClient.d.ts.map +0 -1
- package/dist/client/ModelClient.js.map +0 -1
- package/dist/client/index.d.ts.map +0 -1
- package/dist/client/index.js.map +0 -1
- package/dist/config/RequestConfig.d.ts.map +0 -1
- package/dist/config/RequestConfig.js.map +0 -1
- package/dist/config/index.d.ts.map +0 -1
- package/dist/config/index.js.map +0 -1
- package/dist/media/BrowserMediaResolver.d.ts.map +0 -1
- package/dist/media/BrowserMediaResolver.js.map +0 -1
- package/dist/media/DefaultMediaResolver.d.ts.map +0 -1
- package/dist/media/DefaultMediaResolver.js.map +0 -1
- package/dist/media/MediaResolver.d.ts.map +0 -1
- package/dist/media/MediaResolver.js.map +0 -1
- package/dist/media/index.d.ts.map +0 -1
- package/dist/media/index.js.map +0 -1
- package/dist/message/Usage.d.ts.map +0 -1
- package/dist/message/Usage.js.map +0 -1
- package/dist/prompt/Injection.d.ts.map +0 -1
- package/dist/prompt/Injection.js.map +0 -1
- package/dist/prompt/Rule.d.ts.map +0 -1
- package/dist/prompt/Rule.js.map +0 -1
- package/dist/session/Inserter.d.ts.map +0 -1
- package/dist/session/Inserter.js.map +0 -1
- package/dist/session/Paginator.d.ts.map +0 -1
- package/dist/session/Paginator.js.map +0 -1
- package/dist/session/Query.d.ts.map +0 -1
- package/dist/session/Query.js.map +0 -1
- package/dist/session/SearchCriteria.d.ts.map +0 -1
- package/dist/session/SearchCriteria.js.map +0 -1
- package/dist/session/Session.d.ts.map +0 -1
- package/dist/session/Session.js.map +0 -1
- package/dist/session/matchUtils.d.ts.map +0 -1
- package/dist/session/matchUtils.js.map +0 -1
- package/dist/stream/AnthropicStreamParser.d.ts.map +0 -1
- package/dist/stream/AnthropicStreamParser.js.map +0 -1
- package/dist/stream/GeminiStreamParser.d.ts.map +0 -1
- package/dist/stream/GeminiStreamParser.js.map +0 -1
- package/dist/stream/MessageStreamParser.d.ts.map +0 -1
- package/dist/stream/MessageStreamParser.js.map +0 -1
- package/dist/stream/OpenAIResponsesStreamParser.d.ts.map +0 -1
- package/dist/stream/OpenAIResponsesStreamParser.js.map +0 -1
- package/dist/stream/StreamEvent.d.ts.map +0 -1
- package/dist/stream/StreamEvent.js.map +0 -1
- package/dist/stream/StreamParser.d.ts.map +0 -1
- package/dist/stream/StreamParser.js.map +0 -1
- package/dist/stream/index.d.ts.map +0 -1
- package/dist/stream/index.js.map +0 -1
- package/dist/tool/Context.d.ts.map +0 -1
- package/dist/tool/Context.js.map +0 -1
- package/dist/tool/Hook.d.ts.map +0 -1
- package/dist/tool/Hook.js.map +0 -1
- package/dist/tool/McpToolAdapter.d.ts.map +0 -1
- package/dist/tool/McpToolAdapter.js.map +0 -1
- package/dist/tool/Param.d.ts.map +0 -1
- package/dist/tool/Param.js.map +0 -1
- package/dist/tool/ToolCall.d.ts.map +0 -1
- package/dist/tool/ToolCall.js.map +0 -1
- package/dist/tool/ValueType.d.ts.map +0 -1
- package/dist/tool/ValueType.js.map +0 -1
- package/dist/utils/generateId.d.ts.map +0 -1
- package/dist/utils/generateId.js.map +0 -1
- package/dist/utils/index.d.ts.map +0 -1
- package/dist/utils/index.js.map +0 -1
- /package/dist/{adapter → legacy/adapter}/AnthropicAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/GeminiAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/MessageAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/MessageAdapter.js +0 -0
- /package/dist/{adapter → legacy/adapter}/OpenAIAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/OpenAIResponsesAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/OpenAIResponsesAdapter.js +0 -0
- /package/dist/{adapter → legacy/adapter}/index.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/index.js +0 -0
- /package/dist/{client → legacy/client}/ModelClient.d.ts +0 -0
- /package/dist/{client → legacy/client}/ModelClient.js +0 -0
- /package/dist/{client → legacy/client}/index.d.ts +0 -0
- /package/dist/{client → legacy/client}/index.js +0 -0
- /package/dist/{config → legacy/config}/RequestConfig.d.ts +0 -0
- /package/dist/{config → legacy/config}/RequestConfig.js +0 -0
- /package/dist/{config → legacy/config}/index.d.ts +0 -0
- /package/dist/{config → legacy/config}/index.js +0 -0
- /package/dist/{media → legacy/media}/BrowserMediaResolver.d.ts +0 -0
- /package/dist/{media → legacy/media}/BrowserMediaResolver.js +0 -0
- /package/dist/{media → legacy/media}/DefaultMediaResolver.d.ts +0 -0
- /package/dist/{media → legacy/media}/DefaultMediaResolver.js +0 -0
- /package/dist/{media → legacy/media}/MediaResolver.d.ts +0 -0
- /package/dist/{media → legacy/media}/MediaResolver.js +0 -0
- /package/dist/{media → legacy/media}/index.d.ts +0 -0
- /package/dist/{media → legacy/media}/index.js +0 -0
- /package/dist/{message → legacy/message}/Usage.d.ts +0 -0
- /package/dist/{message → legacy/message}/Usage.js +0 -0
- /package/dist/{prompt → legacy/prompt}/Injection.d.ts +0 -0
- /package/dist/{prompt → legacy/prompt}/Injection.js +0 -0
- /package/dist/{prompt → legacy/prompt}/Rule.d.ts +0 -0
- /package/dist/{prompt → legacy/prompt}/Rule.js +0 -0
- /package/dist/{session → legacy/session}/Inserter.d.ts +0 -0
- /package/dist/{session → legacy/session}/Inserter.js +0 -0
- /package/dist/{session → legacy/session}/Paginator.d.ts +0 -0
- /package/dist/{session → legacy/session}/Paginator.js +0 -0
- /package/dist/{session → legacy/session}/Query.d.ts +0 -0
- /package/dist/{session → legacy/session}/Query.js +0 -0
- /package/dist/{session → legacy/session}/SearchCriteria.d.ts +0 -0
- /package/dist/{session → legacy/session}/SearchCriteria.js +0 -0
- /package/dist/{session → legacy/session}/Session.d.ts +0 -0
- /package/dist/{session → legacy/session}/Session.js +0 -0
- /package/dist/{session → legacy/session}/matchUtils.d.ts +0 -0
- /package/dist/{session → legacy/session}/matchUtils.js +0 -0
- /package/dist/{stream → legacy/stream}/AnthropicStreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/AnthropicStreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/GeminiStreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/GeminiStreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/MessageStreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/MessageStreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/OpenAIResponsesStreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/OpenAIResponsesStreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/StreamEvent.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/StreamEvent.js +0 -0
- /package/dist/{stream → legacy/stream}/StreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/StreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/index.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/index.js +0 -0
- /package/dist/{tool → legacy/tool}/Context.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/Context.js +0 -0
- /package/dist/{tool → legacy/tool}/Hook.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/Hook.js +0 -0
- /package/dist/{tool → legacy/tool}/McpToolAdapter.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/McpToolAdapter.js +0 -0
- /package/dist/{tool → legacy/tool}/Param.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/Param.js +0 -0
- /package/dist/{tool → legacy/tool}/ToolCall.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/ToolCall.js +0 -0
- /package/dist/{tool → legacy/tool}/ValueType.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/ValueType.js +0 -0
- /package/dist/{utils → legacy/utils}/generateId.d.ts +0 -0
- /package/dist/{utils → legacy/utils}/generateId.js +0 -0
- /package/dist/{utils → legacy/utils}/index.d.ts +0 -0
- /package/dist/{utils → legacy/utils}/index.js +0 -0
|
@@ -0,0 +1,326 @@
|
|
|
1
|
+
# AgentEngine 3.0 设计讨论记录
|
|
2
|
+
|
|
3
|
+
记录日期:2026-10-08。
|
|
4
|
+
|
|
5
|
+
本文保存从 2.2.0 开始的 3.0 重构讨论、接口草案和方案演进。运行时代码现已切换到 3.0.0;历史草案不作为最终 API,请阅读 [当前 API](./API.md)、[实施状态](./PLAN-3.0.md) 与 [迁移说明](./MIGRATION-3.0.md)。文中的旧实现分析对应重构前版本。
|
|
6
|
+
|
|
7
|
+
2026-10-08:用户认可当前设计方向,剩余常规细节按实际业务需要收敛。[设计基线与实施计划](./PLAN-3.0.md) 记录后续采用的默认选择与阶段目标。本讨论记录保留方案演进,不将历史草案当作最终接口。
|
|
8
|
+
|
|
9
|
+
## 1. 重构目标
|
|
10
|
+
|
|
11
|
+
将 AgentEngine 设计成结构清晰、模块解耦、API 易懂且容易发现的 Agent 框架。
|
|
12
|
+
|
|
13
|
+
本次按 3.0 大版本设计,重点重新审视职责和接口,不以维持所有 2.x 接口为前提。实施采用新根入口与显式 legacy 兼容层。
|
|
14
|
+
|
|
15
|
+
主要动机:
|
|
16
|
+
|
|
17
|
+
- 逐渐脱离模型厂商 SDK,实现框架自己的平台请求和协议转换。
|
|
18
|
+
- 拆开 Message 与 Session,解决消息内容和会话组织职责混杂的问题。
|
|
19
|
+
- 整理配置入口、配置归属、默认值和覆盖规则,减少需要记忆的隐式行为。
|
|
20
|
+
- 明确 Agent 的执行循环、工具审批、继续生成和会话维护方式。
|
|
21
|
+
- 保留模块独立使用的能力,允许业务直接操作会话和构建上下文。
|
|
22
|
+
|
|
23
|
+
## 2. 已确认的设计方向
|
|
24
|
+
|
|
25
|
+
### 2.1 Message 独立于会话节点
|
|
26
|
+
|
|
27
|
+
Message 成为独立的消息数据模型,表达角色、内容及必要的消息属性。
|
|
28
|
+
|
|
29
|
+
父子关系、节点位置、候选选择和轮次归属由 Session 负责。Message 不再承担树节点职责,现有 `parent`、`children`、`append()`、节点删除和历史查询等会话能力需要迁出。
|
|
30
|
+
|
|
31
|
+
2026-10-08 补充确认:内容编辑保留在 Message 中,由最了解内容结构的 Message 实现。Session 提供详细查询让用户获得具体 Message,并可提供委托 Message 编辑方法的便捷入口。Message 不承担会话结构修改、业务保存或界面渲染。
|
|
32
|
+
|
|
33
|
+
倾向使用带编辑能力的 Message 对象;编辑方法、只读视图、标识和版本的具体实现仍需确定。
|
|
34
|
+
|
|
35
|
+
### 2.2 提供三种会话模型
|
|
36
|
+
|
|
37
|
+
| 会话类型 | 组织方式 | 主要用途 |
|
|
38
|
+
| --- | --- | --- |
|
|
39
|
+
| TreeSession | 标准树结构,节点引用消息 | 对话分支、回退、旧消息编辑后的分支生成 |
|
|
40
|
+
| ListSession | 有序槽位,每个槽位包含多个候选和当前选中项 | 可切换候选的列表式会话 |
|
|
41
|
+
| AgentSession | 按用户交互轮次组织消息,轮内允许多个模型步骤 | Agent 交互与执行过程管理 |
|
|
42
|
+
|
|
43
|
+
这些会话可独立创建和使用。共同操作接口及各自特有 API 待定义,不要求所有会话都暴露树形光标或相同的结构操作。
|
|
44
|
+
|
|
45
|
+
### 2.3 ListSession 的候选单位可配置
|
|
46
|
+
|
|
47
|
+
默认候选单位为 `sequence`,一个候选是一段有序消息序列。
|
|
48
|
+
|
|
49
|
+
普通回复可以只有一条消息;工具调用回复可以包含完整的 `Assistant → Tool → Assistant` 轨迹。切换候选时切换完整序列,不能只替换最终文本而遗留另一候选的工具轨迹。
|
|
50
|
+
|
|
51
|
+
另一个候选单位为 `turn`,一个候选是一整轮用户交互,包含输入和该轮内的模型步骤、工具结果与回复。
|
|
52
|
+
|
|
53
|
+
消息序列模式示例:
|
|
54
|
+
|
|
55
|
+
```text
|
|
56
|
+
槽位 1:用户输入
|
|
57
|
+
槽位 2:回复候选 A / 回复候选 B
|
|
58
|
+
每个候选都可以包含多条消息
|
|
59
|
+
槽位 3:下一条用户输入
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
交互轮模式示例:
|
|
63
|
+
|
|
64
|
+
```text
|
|
65
|
+
槽位 1:交互候选 A / 交互候选 B
|
|
66
|
+
每个候选都包含输入与完整生成过程
|
|
67
|
+
槽位 2:下一轮交互的候选
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
切换早期候选后,后续历史是否保留、如何标记失效、怎样接受或重新生成,仍需明确。候选切换不意味着撤销工具已经产生的外部副作用。
|
|
71
|
+
|
|
72
|
+
### 2.4 AgentSession 的一轮是一次用户交互
|
|
73
|
+
|
|
74
|
+
一轮交互可以包含多次模型调用及工具执行:
|
|
75
|
+
|
|
76
|
+
```text
|
|
77
|
+
第 1 轮
|
|
78
|
+
用户输入
|
|
79
|
+
模型步骤 1:助手发起工具调用,工具返回结果
|
|
80
|
+
模型步骤 2:助手再次调用工具,工具返回结果
|
|
81
|
+
模型步骤 3:助手给出最终回复
|
|
82
|
+
|
|
83
|
+
第 2 轮
|
|
84
|
+
用户补充输入
|
|
85
|
+
模型步骤 1:助手给出回复
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
不能把“一轮用户交互”与“一次模型调用”混为一谈。
|
|
89
|
+
|
|
90
|
+
### 2.5 框架自行实现 Provider
|
|
91
|
+
|
|
92
|
+
自行实现 OpenAI、Gemini 和 Anthropic 的接口接入,包括请求发送、响应读取和统一数据转换,逐步脱离厂商 SDK。
|
|
93
|
+
|
|
94
|
+
用户使用统一的 Message、工具定义和常用请求配置。提交请求时,转换器将统一结构转换为平台格式;接收响应时,再转换为统一响应和增量事件。
|
|
95
|
+
|
|
96
|
+
转换范围需要覆盖消息、工具、配置、完整响应与流式事件。不能只处理消息数组而把其余平台格式交给用户。
|
|
97
|
+
|
|
98
|
+
SDK 接入是否保留为可选适配方式、协议级 Provider 的名称和数量,待确定。
|
|
99
|
+
|
|
100
|
+
### 2.6 工具审批归入工具执行模块
|
|
101
|
+
|
|
102
|
+
工具审批与工具执行形成可独立使用的能力,避免审批仅存在于 Agent 内部。
|
|
103
|
+
|
|
104
|
+
Agent 负责协调对话流程和运行状态,调用工具执行入口并反映审批等待及执行结果。工具执行模块内部的授权策略、人工审批入口、超时和错误语义还需要设计。
|
|
105
|
+
|
|
106
|
+
### 2.7 Agent 提供便捷功能,并维护传入的独立模块
|
|
107
|
+
|
|
108
|
+
用户可以独立创建 Session 和 PromptBuilder,直接编辑会话、调整上下文规则,再交给 Agent 使用。
|
|
109
|
+
|
|
110
|
+
Agent 使用传入的实例,根据该 Session 的组织规则自动维护会话。用户通过 Agent 获取到的应当是同一个实例,不另行维护隐藏的会话副本。
|
|
111
|
+
|
|
112
|
+
- 传入 Session:使用该实例,无需再指定会话模式。
|
|
113
|
+
- 未传入 Session:需要指定 Agent 模式,由模式决定自动创建 TreeSession、ListSession 或 AgentSession。
|
|
114
|
+
- 未传入 PromptBuilder:Agent 自动创建一个可获取、可操作的默认实例。
|
|
115
|
+
- 自动创建或外部传入的 Session、PromptBuilder,都可以通过 Agent 获取。
|
|
116
|
+
|
|
117
|
+
模式字段主要用于自动创建 Session;具体参数名、模式与 Session 配置的类型约束待确定。
|
|
118
|
+
|
|
119
|
+
### 2.8 对话入口与继续生成
|
|
120
|
+
|
|
121
|
+
对话入口倾向使用易懂的 `chat()` 名称,开始新交互并自动维护 Session。
|
|
122
|
+
|
|
123
|
+
“继续生成”的目标行为已经明确:
|
|
124
|
+
|
|
125
|
+
1. 从待继续的助手消息取得已有思考和回答。
|
|
126
|
+
2. 将已有思考作为助手消息回传,并提供已有回答所需的上下文。
|
|
127
|
+
3. 接上用于继续生成的用户指令,再请求模型。
|
|
128
|
+
4. 将新思考拼接到原思考,将新回答拼接到原回答。
|
|
129
|
+
5. 最终会话不保留继续指令,不产生额外的普通用户交互。
|
|
130
|
+
|
|
131
|
+
```text
|
|
132
|
+
原回复:thinking = A,text = B
|
|
133
|
+
新生成:thinking = C,text = D
|
|
134
|
+
合并后:thinking = A + C,text = B + D
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
平台协议所需的原生状态也需要保留。具体回传格式由 Provider 转换层处理。
|
|
138
|
+
|
|
139
|
+
继续过程中有工具调用、部分生成失败、用户同时编辑目标消息等情况,尚需定义提交和合并规则。
|
|
140
|
+
|
|
141
|
+
### 2.9 所有 Session 保留轮次与工具执行信息
|
|
142
|
+
|
|
143
|
+
TreeSession、ListSession、AgentSession 均需要保留消息轮次和工具使用轮次信息。AgentSession 的区别是以交互轮组织会话,不能将轮次记录能力限定在该类型中。
|
|
144
|
+
|
|
145
|
+
具体 Turn、Run、Step、工具执行记录及其与 Message 的关系见 [消息、会话与运行记录契约草案](./DATA-MODEL-3.0.md)。仅在 Agent 的运行状态或流式事件中记录,不足以支持会话保存、恢复和后续查询。
|
|
146
|
+
|
|
147
|
+
### 2.10 保存、显示与模型上下文允许不同
|
|
148
|
+
|
|
149
|
+
模型生成内容、Session 中保存的内容、界面显示和下一次请求的上下文不保证一致。框架提供清楚的转换与关联入口,允许业务实现提交前处理、临时上下文转换和显示投影。
|
|
150
|
+
|
|
151
|
+
Message 负责当前消息内容;Session 负责组织与查询;业务控制显示和实际持久化方式。如何记录生成来源、如何通知提交结果等具体契约仍为设计草案。
|
|
152
|
+
|
|
153
|
+
## 3. 当前 2.2.0 实现备忘
|
|
154
|
+
|
|
155
|
+
本节记录讨论时对源码的核对结果,用于区分现状与 3.0 目标。后续实现变化后应同步更新或归档本节。
|
|
156
|
+
|
|
157
|
+
### 3.1 当前 Agent 的执行循环
|
|
158
|
+
|
|
159
|
+
主要代码见 [Agent.ts](../src/legacy/agent/Agent.ts)。
|
|
160
|
+
|
|
161
|
+
```text
|
|
162
|
+
run(content)
|
|
163
|
+
→ 创建用户 Message
|
|
164
|
+
→ runWith(message):追加到 Session
|
|
165
|
+
→ 开始执行,调用 Session.beginGeneration()(若有)
|
|
166
|
+
→ 每次模型调用:
|
|
167
|
+
Session.history()
|
|
168
|
+
→ PromptBuilder.build()(若提供)
|
|
169
|
+
→ 清理空消息
|
|
170
|
+
→ Adapter 构建平台请求
|
|
171
|
+
→ Client 请求模型
|
|
172
|
+
→ Parser 解析流,或 Adapter 解析完整响应
|
|
173
|
+
→ 等待 BEFORE_ASSISTANT_COMMIT
|
|
174
|
+
→ Session.addAssistant()
|
|
175
|
+
→ 如有工具调用且配置了 ToolKit:审批、执行、写入工具结果
|
|
176
|
+
→ 再次请求模型
|
|
177
|
+
→ 结束,调用 Session.endGeneration()(若有),清理资源
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
- `generate()` 使用已有会话上下文,不追加用户消息,仍执行工具循环。
|
|
181
|
+
- `runRaw()` 只执行一次模型请求,跳过 Session、PromptBuilder 和自动工具循环。
|
|
182
|
+
- 当前 `maxTurns` 与事件中的 `turn` 主要计数模型调用步骤,不等于 3.0 定义的用户交互轮。
|
|
183
|
+
- ListSession 通过生成边界将一次工具循环归入一个候选。
|
|
184
|
+
|
|
185
|
+
### 3.2 当前 Session 与 PromptBuilder 的访问
|
|
186
|
+
|
|
187
|
+
- Session 是必传参数,没有自动创建逻辑。
|
|
188
|
+
- PromptBuilder 可选,没有传入时保持 `undefined`。
|
|
189
|
+
- `agent.session` 和 `agent.promptBuilder` 返回持有的实例。
|
|
190
|
+
- 可以独立修改传入的实例,也可以用 `setPromptBuilder()` 替换或移除 Builder。
|
|
191
|
+
- 没有公开的 Session 替换接口。
|
|
192
|
+
- 现有 Message 可用 `setText()`、`setParts()` 编辑内容;直接改动 `parts` 需要注意缓存失效。
|
|
193
|
+
- TreeSession 的结构操作分散在 Message、Session、Inserter、Paginator 等对象中。
|
|
194
|
+
- ListSession 的多数结构修改操作在生成期间被禁止。
|
|
195
|
+
- Agent 有提交前 Hook,但上下文构建和请求发送阶段主要封装在私有方法中。
|
|
196
|
+
|
|
197
|
+
### 3.3 当前 PromptBuilder 的临时性与状态变化
|
|
198
|
+
|
|
199
|
+
主要代码见 [PromptBuilder.ts](../src/legacy/prompt/PromptBuilder.ts) 和 [Injection.ts](../src/legacy/prompt/Injection.ts)。
|
|
200
|
+
|
|
201
|
+
Agent 不会将 `build()` 产出的上下文整体写回 Session,注入消息通常只参与请求。
|
|
202
|
+
|
|
203
|
+
但是,构建只复制消息数组,历史里的 Message 对象仍然共享。自定义操作若直接修改这些 Message,会影响 Session 中的内容。临时数组并不意味着消息对象完全隔离。
|
|
204
|
+
|
|
205
|
+
每次模型调用都会重新构建上下文。注入生命周期按构建消耗,通过概率判定的注入即使没有匹配到位置也会消耗;手动 `build()` 预览也会改变生命周期状态。
|
|
206
|
+
|
|
207
|
+
### 3.4 当前继续与恢复
|
|
208
|
+
|
|
209
|
+
当前 `continue()` 最终调用 `run(继续提示)`,会保存用户提示并追加新的助手消息,不会合并原回复或删除提示。
|
|
210
|
+
|
|
211
|
+
`resume()` 调用严格恢复模式的 `continue()`,根据可恢复状态继续发起模型请求。当前 API 将普通继续与异常恢复放在同一套入口中,与拟定的 3.0 继续生成语义有差异。
|
|
212
|
+
|
|
213
|
+
### 3.5 当前工具审批、执行与 SDK 接入
|
|
214
|
+
|
|
215
|
+
- 审批请求、人工确认、待审批列表和审批超时主要实现在 Agent 中。
|
|
216
|
+
- [ToolKit](../src/legacy/tool/ToolKit.ts) 负责查找工具、解析参数、调用工具并返回工具结果消息。直接执行 ToolKit 不会经过 Agent 审批。
|
|
217
|
+
- 工具定义还有校验、执行前后、错误和序列化 Hook。
|
|
218
|
+
- 源码未直接导入模型厂商 SDK,但 [内置 Client](../src/legacy/client/ModelClient.ts) 主要通过传入的 SDK 形状对象发送请求。
|
|
219
|
+
- 当前 [ToolSchema](../src/legacy/tool/Tool.ts) 使用 OpenAI function tools 格式;独立于 SDK 还需要进一步独立于平台数据格式。
|
|
220
|
+
|
|
221
|
+
### 3.6 当前配置入口
|
|
222
|
+
|
|
223
|
+
模型请求参数的覆盖顺序是 `RequestConfig → Agent.requestOptions → 单次运行参数`。
|
|
224
|
+
|
|
225
|
+
单次运行参数中的 `signal`、`timeoutMs`、`stream`、`promptBuildOptions`、`serializeOptions` 被单独处理,其余字段视为模型请求参数。
|
|
226
|
+
|
|
227
|
+
审批、工具错误策略、最大模型调用次数、提示词注入、thinking 序列化等配置分布在不同模块。接口整理应明确每一类配置的归属,而不只是更换链式方法名称。
|
|
228
|
+
|
|
229
|
+
现有用法详见 [API 文档](./API.md)。
|
|
230
|
+
|
|
231
|
+
## 4. 待评估的设计建议
|
|
232
|
+
|
|
233
|
+
以下内容在讨论中提出,但尚未定为最终方案。
|
|
234
|
+
|
|
235
|
+
### 4.1 基础模型与公共会话接口
|
|
236
|
+
|
|
237
|
+
- 将 Turn 做成可复用的数据模型,供 ListSession 的 turn 模式和 AgentSession 使用。
|
|
238
|
+
- 区分 Turn(用户交互)、Step(模型步骤)、Run(一次执行及其控制状态)。恢复执行可关联原 Turn,Run 与 Turn 不必一一对应。
|
|
239
|
+
- 公共会话接口使用 `Session` 或 `SessionLike` 等名称。当前 `AgentSession` 是接口名,需要为新的具体会话类让出名称。
|
|
240
|
+
- 用公共会话契约和生成提交边界协调写入,减少 Agent 内部按具体类型分支,也允许用户实现自己的 Session。
|
|
241
|
+
- ListSession 的候选单位在创建时固定;模式转换采用显式操作,而非任意运行时切换。
|
|
242
|
+
- Session 提供方便的查询、结构删除和生成提交接口;内容编辑的便捷操作委托 Message,并感知内容变化以维护历史和索引。
|
|
243
|
+
- 2026-10-08 补充已确认所有 Session 保留轮次信息;具体身份、生成贡献、查询与提交方案见 [数据模型契约草案](./DATA-MODEL-3.0.md)。草案中的字段及默认策略不自动视为已确认。
|
|
244
|
+
|
|
245
|
+
### 4.2 Provider 的外部统一与内部拆分
|
|
246
|
+
|
|
247
|
+
- Provider 对外提供统一的完整响应和流式调用接口。
|
|
248
|
+
- 内部区分 HTTP 传输、请求与响应转换、流式协议解析;常规用户只需配置 Provider。
|
|
249
|
+
- 考虑按协议提供 OpenAI Compatible、OpenAI Responses、Anthropic 和 Gemini 实现。当前支持的 Chat Completions 与 Responses 不应被视为同一种协议。
|
|
250
|
+
- 常用生成参数统一,平台专属参数通过有类型的入口提供。
|
|
251
|
+
- 明确模型能力、不支持参数和冲突配置的处理,不静默忽略或统一钳制所有平台参数。
|
|
252
|
+
- 保留协议往返所必需的签名、推理状态等数据,避免统一 Message 时丢失多轮工具调用所需信息。
|
|
253
|
+
|
|
254
|
+
### 4.3 API、配置与扩展入口
|
|
255
|
+
|
|
256
|
+
- `chat()` 开始新交互;`continue()` 扩展已有回复;`resume()` 恢复执行。此前提出 Agent.generate 使用现有上下文,2026-10-08 用户进一步提出将一次生成下沉到小于 Agent 的独立单元,详见 4.4;最终入口归属待确认。
|
|
257
|
+
- 按模型生成、运行控制、工具执行、上下文构建划分有类型的配置,提供编辑器补全和最终生效配置查看能力。
|
|
258
|
+
- 提供请求前和提交前扩展入口,区分普通通知事件与会影响执行结果的异步 Hook。
|
|
259
|
+
- 提供不消耗生命周期的上下文预览,并明确注入按用户交互、模型步骤或请求次数生效的语义。
|
|
260
|
+
- 继续指令可只存在于临时上下文,从而实现最终不保留指令的行为。
|
|
261
|
+
- 生成开始时绑定提交目标;目标被编辑、删除或候选切换时,应有明确的结果归属和冲突处理规则。
|
|
262
|
+
- 工具执行入口可命名为 ToolExecutor,统一校验、授权、审批和执行;Agent 协调等待状态。具体拆分待定。
|
|
263
|
+
|
|
264
|
+
### 4.4 一次生成与 Agent 自主执行分别建模
|
|
265
|
+
|
|
266
|
+
2026-10-08 用户提出:Agent 应当是带上下文、能够多步自主运行的编排单元;调用方自行维护上下文与流程时,应使用一个小于 Agent 的生成单元。
|
|
267
|
+
|
|
268
|
+
用户随后认可这一组织方式。独立单次生成与 Agent 多步骤自主执行的职责拆分已确认;默认名称、入口和实现次序收敛到 [实施计划](./PLAN-3.0.md)。
|
|
269
|
+
|
|
270
|
+
现状说明:2.2.0 的 Agent.generate 并不只请求一次模型,它仅省略追加用户消息,仍运行完整工具循环。
|
|
271
|
+
|
|
272
|
+
讨论草案:
|
|
273
|
+
|
|
274
|
+
- 小单元暂称 Generator:接收明确的上下文、模型配置和可见工具定义,执行一次模型生成,输出统一响应及增量事件。
|
|
275
|
+
- 一次生成可以使用流式或完整响应,也可以返回工具调用;Generator 不自动执行工具、不追加工具结果、不再次请求模型。
|
|
276
|
+
- Generator 不拥有会话和自主循环。用户可以从自己的 Session、PromptBuilder 取得上下文,再调用它,并自行决定提交和后续动作。
|
|
277
|
+
- Agent 组合 Generator、Session、PromptBuilder 和工具执行模块,维护多步流程、执行记录与停止条件。
|
|
278
|
+
- Provider 保持平台协议与传输边界;Generator 提供独立、方便的单次生成入口,避免业务自定义流程必须先创建 Agent。
|
|
279
|
+
- Agent 侧的 generate 是否移除或保留一个含义明确的任务入口、小单元最终名称,以及与 Provider 的配置分工,尚未最终确定。
|
|
280
|
+
- 一次 chat 是一轮用户交互,可以包含多个模型 Step;带上下文的 Agent 可连续接受用户交互。不能将多步自主执行与多个用户交互混为一谈。
|
|
281
|
+
|
|
282
|
+
## 5. API 方向示例(非最终接口)
|
|
283
|
+
|
|
284
|
+
```ts
|
|
285
|
+
const session = ListSession.create({ candidateUnit: "sequence" });
|
|
286
|
+
const promptBuilder = new PromptBuilder();
|
|
287
|
+
|
|
288
|
+
const agent = new Agent({
|
|
289
|
+
provider,
|
|
290
|
+
model: "model-name",
|
|
291
|
+
session,
|
|
292
|
+
promptBuilder,
|
|
293
|
+
});
|
|
294
|
+
|
|
295
|
+
await agent.chat("帮我分析这个问题");
|
|
296
|
+
await agent.continue({ instruction: "继续展开第二点" });
|
|
297
|
+
|
|
298
|
+
// 不提供会话时,指定模式自动创建。
|
|
299
|
+
const anotherAgent = new Agent({
|
|
300
|
+
provider,
|
|
301
|
+
model: "model-name",
|
|
302
|
+
mode: "agent",
|
|
303
|
+
});
|
|
304
|
+
|
|
305
|
+
anotherAgent.session;
|
|
306
|
+
anotherAgent.promptBuilder;
|
|
307
|
+
```
|
|
308
|
+
|
|
309
|
+
候选单位默认 sequence 已确定;`candidateUnit`、`mode`、`instruction` 等字段名称和上述构造签名仍是草案。
|
|
310
|
+
|
|
311
|
+
## 6. 下一步:结合实际业务检验设计
|
|
312
|
+
|
|
313
|
+
2026-10-08:用户提供 `D:\Code\NodeJs\CharacterEditor`,已阅读当前工作区中 AgentEngine 的主要使用链路。静态阅读结果见 [CharacterEditor 使用分析与 3.0 设计输入](./CHARACTEREDITOR-3.0-NOTES.md)。未运行业务或执行验证脚本,未修改该业务项目。
|
|
314
|
+
|
|
315
|
+
业务中已存在三家平台的自定义 HTTP/SSE 接入、续写合并、树形与列表候选会话、动态工具启用、人工审批和提示词状态结算。新增设计输入包括可注入的跨端传输、稳定的消息与结构标识、明确的生成提交边界,以及上下文来源和预览能力。这些仍是待评估建议,不自动升级为已确认方案。
|
|
316
|
+
|
|
317
|
+
后续继续检验:
|
|
318
|
+
|
|
319
|
+
- 实际消息类型、会话展示方式、候选切换与历史编辑方式。
|
|
320
|
+
- Agent 的启动、生成、继续、中断和恢复流程。
|
|
321
|
+
- 工具审批的交互方式、执行策略与副作用处理需求。
|
|
322
|
+
- 系统提示、动态上下文和临时指令如何构建。
|
|
323
|
+
- 会话保存、应用重启与运行恢复是否需要分别支持。
|
|
324
|
+
- 当前调用代码中困难、重复或依赖框架内部细节的部分。
|
|
325
|
+
|
|
326
|
+
先通过实际业务确定数据关系、典型调用和扩展需求,再收敛接口与实现计划。本文应持续更新,并明确哪些讨论结果已被业务验证、修改或放弃。
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
# 2.x → 3.0 迁移
|
|
2
|
+
|
|
3
|
+
3.0 是破坏性升级,根入口切换到新的独立模块。当前版本为 3.0.0。保存数据升级与业务调用升级分别处理。
|
|
4
|
+
|
|
5
|
+
## 旧业务过渡
|
|
6
|
+
|
|
7
|
+
原实现保留在 src/legacy,可先修改导入:
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
import { Agent, Session, StreamEventType } from "@notic/agent-engine/legacy";
|
|
11
|
+
import { OpenAIAdapter } from "@notic/agent-engine/legacy/adapter";
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
旧模型客户端仍由业务传入 SDK/兼容客户端。厂商 SDK 已从框架 runtime/peer 依赖移除,legacy 应用自行安装其使用的 SDK。旧测试覆盖兼容入口,原 demo 使用 legacy。新旧 Message/Session 不混用。
|
|
15
|
+
|
|
16
|
+
## 接口变化
|
|
17
|
+
|
|
18
|
+
| 2.x | 3.0 |
|
|
19
|
+
| --- | --- |
|
|
20
|
+
| Agent({client,model,session}) | Agent({provider,model,session}) 或传 generator |
|
|
21
|
+
| 聊天 Provider 类型 | ChatProvider 结构化契约;Provider 是可继承的通用 HTTP 基类 |
|
|
22
|
+
| Session.create(prompt) | TreeSession.create(prompt) |
|
|
23
|
+
| AgentSession 接口 | SessionLike 契约;AgentSession 是按交互轮组织的具体类 |
|
|
24
|
+
| Message.parent/children/add/branch | TreeSession.nodes/nodeFor/select/addMessage/remove |
|
|
25
|
+
| agent.run(userInput) | agent.chat(userInput),通过 result.message 取回复 |
|
|
26
|
+
| agent.generate() | 已有上下文自主运行:agent.run;一次请求:generator.generate |
|
|
27
|
+
| agent.runRaw | 独立 Generator,业务自己处理结果 |
|
|
28
|
+
| RequestConfig/requestOptions | generation、execution、tools、PromptBuilder 四个归属 |
|
|
29
|
+
| maxTurns 表示模型调用限制 | execution.maxSteps,默认 10 |
|
|
30
|
+
| Agent 内工具审批 | 独立 ToolExecutor,Agent 提供代理审批方法 |
|
|
31
|
+
| Param/ValueType | Tool.define/new Tool,参数用 JSON Schema |
|
|
32
|
+
| StreamEventType.TEXT_DELTA | textDelta 等字符串事件,含 messageId/stepId |
|
|
33
|
+
| Message.usage | Step.usage 和 AgentResult.usage |
|
|
34
|
+
| 同步 PromptBuilder/Rule | 异步 build/preview/use,规则作为业务 transform |
|
|
35
|
+
|
|
36
|
+
```ts
|
|
37
|
+
import { Agent, TreeSession, OpenAIProvider, PromptBuilder } from "@notic/agent-engine";
|
|
38
|
+
const session = TreeSession.create("系统提示");
|
|
39
|
+
const agent = new Agent({
|
|
40
|
+
provider: new OpenAIProvider({ baseURL: "https://your-proxy/v1", apiKey: "key" }),
|
|
41
|
+
model: "your-model", session, promptBuilder: new PromptBuilder(),
|
|
42
|
+
generation: { temperature: 0.5, maxOutputTokens: 2048 },
|
|
43
|
+
execution: { maxSteps: 10 },
|
|
44
|
+
hooks: {
|
|
45
|
+
beforeCommit(message) { message.setText(normalizeForStorage(message.text)); },
|
|
46
|
+
async afterCommit(message) { await store.save(message.toJSON()); },
|
|
47
|
+
},
|
|
48
|
+
});
|
|
49
|
+
session.addUser("已准备好的输入");
|
|
50
|
+
const result = await agent.run();
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
网络代理迁到 transport,附件地址解析迁到 mediaResolver;平台参数可用 providerOptions,与统一参数冲突会报错。运行错误用 AgentRunError.result 读取保留进度。数据存储、角色宏、世界书和界面展示继续由业务控制。
|
|
54
|
+
|
|
55
|
+
媒体生成 adapter 可继承 Provider 并实现 ImageProvider/AudioProvider/VideoProvider,向量请求可实现 EmbeddingProvider;也可扩展已有厂商 Provider,详见 [媒体扩展](./MULTIMEDIA-3.0.md)。transport 的 body 现为可选 JSON/BodyInit,检查聊天 wire body 时使用 ChatHttpRequest 或 isJsonBody 做类型收窄。自建 HttpRequest 描述必须提供 stream:boolean;基类请求可指定 purpose,业务可以据此配置单次请求超时。
|
|
56
|
+
|
|
57
|
+
## 保存数据
|
|
58
|
+
|
|
59
|
+
3.0 存储为 version=3 的平坦消息表、结构表和执行记录表。restoreSession 只接受该格式,旧递归 Message 树不能直接传入。先保留旧数据,再显式迁移。
|
|
60
|
+
|
|
61
|
+
推荐把旧树一次映射为 TreeSessionData:消息表读取 role/parts/metadata/tags,节点表保留 id/messageId/parentId/children,structure.roots 保留根顺序,cursor 保留当前节点,再调用 TreeSession.fromJSON 或 restoreSession 校验导入。消息与节点 ID 独立,只需各自表内唯一的非空字符串,支持原业务 ID。children 顺序保留候选翻页顺序,nodes 表无需按父子顺序排列。公开类型与可运行的最小数据示例见 [CE 接入契约](./CE-FEEDBACK-3.0.md)。
|
|
62
|
+
|
|
63
|
+
旧空 root 改为独立系统消息,用 systemMessageId 引用,不当作普通树节点或真实用户输入。旧根上的会话变量、笔记文档可迁至 SessionData.metadata;属于系统消息本身的 metadata 可保留。修改 systemPrompt 文本不会清除系统消息 metadata。也可以逐条 addMessage 接入新树,但会生成新节点 ID,已有外部节点引用和大量历史更适合直接映射。
|
|
64
|
+
|
|
65
|
+
MessageData 新增可选 requestRevision/requestMetadataKeys。早期 3.0 快照未写前者时以 revision 初始化;未写后者仍默认标记内置协议键。metadata/tags 的业务编辑不再造成运行冲突,内容与协议编辑仍会;自定义转换依赖的 metadata 键用 setMeta(key,value,{affectsRequest:true}) 标记。Session metadata 缺省为 {},旧 3.0 树未写 roots 时按节点表中的根顺序导入。
|
|
66
|
+
|
|
67
|
+
旧记录缺少真实 Run/Step/工具执行时保留未知,不伪造调用和用量。UI 消息 ID、工具调用 ID、模型步骤 ID 分开映射。导入后可 run 已有上下文,不恢复旧进程审批/执行现场。
|
|
68
|
+
|
|
69
|
+
## CharacterEditor 接入
|
|
70
|
+
|
|
71
|
+
此次未修改 CharacterEditor。建议依次更新 ui/src/lib/agent.ts 的导出、providerRuntime 的传输/附件桥接、conversation Session codec、agentRuntime 的生成和审批,再替换 continuation 与事件投影。
|
|
72
|
+
|
|
73
|
+
区分 messageGenerated(模型输出)与 messageCommitted(转换后保存内容);宏副作用在提交成功后结算,预览用 builder.preview 或 agent.previewContext。续写预览使用 {kind:"continue",...},临时指令与思考先进入变换,旧业务不用再手动写入/删除 Session 指令。变换支持返回 {messages,sources} 接上 CE 编译器标签,原 Message[] 形式仍兼容。
|
|
74
|
+
|
|
75
|
+
续写 beforeCommit 处理生成消息,可读 context.targetMessage 快照;beforeAppend 编辑默认合并目标草稿,适合组件渲染、状态根与缓存清理。默认最新业务元数据覆盖、标签并集;多段思考保留独立,带工具调用的思考只保存在工具调用载体。运行中的普通业务状态写入不冲突,实际内容/协议/结构编辑冲突时保留 unapplied,由 UI 决定重新生成或应用。
|
|
76
|
+
|
|
77
|
+
详见 [3.0 API](./API.md) 和 [业务分析](./CHARACTEREDITOR-3.0-NOTES.md)。真实模型与 CharacterEditor 集成仍需在业务环境验证。
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
# Provider 继承与多媒体能力
|
|
2
|
+
|
|
3
|
+
2026-10-08:补齐首次重构遗漏的媒体生成扩展契约。此文对应实际公开接口;CharacterEditor 未修改。
|
|
4
|
+
|
|
5
|
+
## 业务依据与边界
|
|
6
|
+
|
|
7
|
+
CharacterEditor 的 `ui/src/features/media/adapters.ts` 包含图片生成(含渐进预览)、MiniMax 语音合成(JSON/音频分片)和 Seedance 视频创建/查询。`jobs.ts` 保存任务 ID、下载和保存产物、恢复已有任务;`tools/mediaTools.ts` 将这些能力提供给 Agent 工具。媒体参数由 `features/models/mediaParameters.ts` 单独管理。
|
|
8
|
+
|
|
9
|
+
这些能力与聊天附件输入分别设计:Message 可以承载图片、音频、视频和文件;Provider 的媒体生成返回产物或任务。聊天 generation 参数不自动传给媒体接口。业务数据库、appfile 注册、保存重试、模型目录、展示和预览 URL 生命周期仍属于业务。
|
|
10
|
+
|
|
11
|
+
## 基类与能力接口
|
|
12
|
+
|
|
13
|
+
`Provider` 是可继承的抽象基类,提供公共 HTTP/附件基础设施;基类没有聊天或媒体占位方法。子类只实现支持的操作。也可以继承已有 OpenAIProvider、OpenAIResponsesProvider、AnthropicProvider、GeminiProvider,再增加媒体接口,复用其鉴权与聊天功能。
|
|
14
|
+
|
|
15
|
+
| 能力 | 接口 | 方法 |
|
|
16
|
+
| --- | --- | --- |
|
|
17
|
+
| 聊天 | ChatProvider | generate(request,options,emit?) |
|
|
18
|
+
| 图片生成 | ImageProvider | generateImages(request,options?) |
|
|
19
|
+
| 音频生成/语音合成 | AudioProvider | generateAudio(request,options?) |
|
|
20
|
+
| 视频生成 | VideoProvider | createVideo(request,options?)、getVideoTask(taskId,options?),可选 cancelVideoTask |
|
|
21
|
+
| 向量 | EmbeddingProvider | embed(request,options?) |
|
|
22
|
+
|
|
23
|
+
Agent 与 Generator 只要求结构化的 ChatProvider,不要求继承;仅支持媒体或向量的 Provider 无需伪造聊天方法。`supportsCapability(provider, "chat" | "image" | "audio" | "video" | "embedding")` 检查操作并收窄 TypeScript 类型。它表示实现了操作;具体模型是否支持仍由业务模型目录决定。
|
|
24
|
+
|
|
25
|
+
内置三家 Provider 当前实现的是聊天协议。此次新增的是媒体能力契约、继承基础设施与合成验证,未新增 OpenAI Images、MiniMax 或 Seedance 的生产协议实现。业务可将已有 adapter 接到这些接口,之后也能将通用协议实现贡献到框架。
|
|
26
|
+
|
|
27
|
+
## 一个扩展例子
|
|
28
|
+
|
|
29
|
+
下面使用业务网关的归一化响应作示例,`/media/images` 是示例路由,不是厂商 API。
|
|
30
|
+
|
|
31
|
+
```ts
|
|
32
|
+
import {
|
|
33
|
+
OpenAIProvider, supportsCapability,
|
|
34
|
+
type ImageProvider, type ImageGenerationRequest,
|
|
35
|
+
type ImageGenerationResult, type MediaCallOptions,
|
|
36
|
+
} from "@notic/agent-engine";
|
|
37
|
+
|
|
38
|
+
class BusinessProvider extends OpenAIProvider implements ImageProvider {
|
|
39
|
+
async generateImages(
|
|
40
|
+
input: ImageGenerationRequest,
|
|
41
|
+
options: MediaCallOptions = {},
|
|
42
|
+
): Promise<ImageGenerationResult> {
|
|
43
|
+
const result = await this.requestJSON<ImageGenerationResult>("media/images", {
|
|
44
|
+
body: { model: input.model, prompt: input.prompt, ...input.parameters },
|
|
45
|
+
signal: options.signal,
|
|
46
|
+
stream: false, purpose: "image",
|
|
47
|
+
});
|
|
48
|
+
if (!Array.isArray(result.artifacts)) throw new Error("Invalid image response");
|
|
49
|
+
return result;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
const provider = new BusinessProvider({ baseURL: "https://your-gateway/v1", apiKey: "key" });
|
|
54
|
+
if (supportsCapability(provider, "image")) {
|
|
55
|
+
const result = await provider.generateImages({
|
|
56
|
+
model: "your-image-model", prompt: "湖边的房屋",
|
|
57
|
+
parameters: { quality: "high" },
|
|
58
|
+
});
|
|
59
|
+
await artifactStore.save(result.artifacts);
|
|
60
|
+
}
|
|
61
|
+
// 同一实例仍可传给 Agent / Generator,使用继承的聊天接口。
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
原生 API 子类自行转换和校验输入/输出;requestJSON 的泛型不做运行时 schema 校验。ImageProvider/AudioProvider/VideoProvider 支持参数泛型,例如 `ImageProvider<{ quality?: "high" | "low" }>`;也可在工具入口用 JSON Schema 约束模型可传参数。
|
|
65
|
+
|
|
66
|
+
纯媒体提供者直接 `extends Provider implements AudioProvider` 即可。媒体基类提供的 protected 接口:
|
|
67
|
+
|
|
68
|
+
| 接口 | 用途 |
|
|
69
|
+
| --- | --- |
|
|
70
|
+
| options、baseURL | 子类配置与基础地址 |
|
|
71
|
+
| resolveApiKey(signal?)、authHeaders(signal?) | 获取异步凭据;覆盖特定服务的鉴权 |
|
|
72
|
+
| buildHttpRequest(path,init)、send(request) | 构建请求、使用公共传输和 HTTP 错误处理 |
|
|
73
|
+
| request(path,init)、requestJSON<T>(path,init) | 相对 baseURL 发送请求,返回 Response 或 JSON |
|
|
74
|
+
| readEvents(response,signal?,{maxEventBytes?}) | SSE 解帧,协议事件由子类处理 |
|
|
75
|
+
| readBytes(response,signal?,maxBytes?) | 可取消、有大小限制的二进制读取 |
|
|
76
|
+
| resolveMedia(url,signal?) | 复用附件解析器,处理业务地址 |
|
|
77
|
+
|
|
78
|
+
init 支持 method、body、headers、signal、stream、purpose。transport 支持 GET/POST/PUT/PATCH/DELETE,body 可以是 JSON、FormData、二进制或其他标准 BodyInit。基类总是输出明确的 stream:boolean(默认 false);purpose 默认 custom,可设 chat/image/audio/video/embedding/models/custom。子类负责声明真实流式行为,例如使用 SSE 的图片请求设置 stream:true、purpose:image。业务传输层据此决定单次请求超时;Agent.execution.timeoutMs 仍是整次运行预算。
|
|
79
|
+
|
|
80
|
+
默认传输保留原始二进制/FormData,不重复 JSON 编码;multipart 的 Content-Type 由 fetch 生成边界。相对请求复用凭据;产物下载使用独立业务传输,避免把供应商鉴权带到产物域名。
|
|
81
|
+
|
|
82
|
+
SSE 默认单事件上限 16 MiB,可按图片分片需要明确设置 maxEventBytes;二进制默认 64 MiB,可显式设置 maxBytes。取消及失败会释放读取器,已取消的请求不会由基类提交给 transport。停止本地等待不表示远端任务已撤销。
|
|
83
|
+
|
|
84
|
+
## 请求、产物与事件
|
|
85
|
+
|
|
86
|
+
ImageGenerationRequest、AudioGenerationRequest、VideoGenerationRequest 共用 model、prompt、inputs?、parameters?。语音合成的 prompt 是朗读文本;inputs 是图片/音频/视频/文件引用。参数归属媒体接口,不混入 GenerationConfig。
|
|
87
|
+
|
|
88
|
+
图片/音频返回 `{ artifacts, model?, usage?, metadata? }`,每项包含 kind、mimeType、source、metadata?。source 显式区分:
|
|
89
|
+
|
|
90
|
+
```ts
|
|
91
|
+
{ type: "url", url: "https://..." }
|
|
92
|
+
{ type: "bytes", bytes: new Uint8Array(...) }
|
|
93
|
+
{ type: "base64", base64: "..." }
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
二进制产物保留在响应中,业务保存后可将 URL 放入 Message;不会强迫把字节放进会话 JSON。usage 为媒体指标字典,不强制套用聊天 token 统计。流式 options 支持 signal、stream、onEvent;事件为 mediaPreview、mediaChunk、mediaProgress。预览与最终产物区分,子类须在完整产物到达后才完成 Promise。
|
|
97
|
+
|
|
98
|
+
## 视频任务与恢复
|
|
99
|
+
|
|
100
|
+
```ts
|
|
101
|
+
const task = await videoProvider.createVideo({ model: "video", prompt: "湖边日落" });
|
|
102
|
+
await taskStore.save(task); // 优先持久化 id 与供应商选择
|
|
103
|
+
const current = await videoProvider.getVideoTask(task.id, { signal });
|
|
104
|
+
// 重启/超时后继续 getVideoTask(existingId),不再次调用 createVideo。
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
VideoTask 包含 id、status、model?、artifacts?、error?、metadata?。归一状态为 queued/running/completed/failed/cancelled。createVideo 创建一次任务;getVideoTask 查询一次,不隐含重新提交或自动轮询。业务按自己的时限/间隔等待,保存原始任务 ID 与供应商信息。
|
|
108
|
+
|
|
109
|
+
本地 signal 仅控制本地请求/等待。cancelVideoTask 是可选的显式远端取消接口,未实现时不会伪装成远端取消成功。提交发生后但未收到任务 ID 的网络失败不能确认服务端是否接受,业务不能默认自动重提。
|
|
110
|
+
|
|
111
|
+
## 视频消息与聊天转换
|
|
112
|
+
|
|
113
|
+
Message.addVideo(url,mimeType?) 和 VideoPart 已实现;三种 Session 都能查询、编辑、保存和恢复视频内容。内置聊天 codec 尚未编码视频输入,会明确报错,避免丢弃。
|
|
114
|
+
|
|
115
|
+
HttpProvider 的 `protected serializeMessages(request,signal?)` 是公开扩展点,返回 SerializedMessages(messages 与可选 systemMessage)。子类可通过它将视频映射到自己的协议,继续复用 buildRequest 和原有响应解析;全新聊天协议则实现 ChatProvider.generate。输入能力与视频生成能力独立。
|
|
116
|
+
|
|
117
|
+
## 向量扩展
|
|
118
|
+
|
|
119
|
+
EmbeddingRequest 为 `{model,input:string|readonly string[],dimensions?,providerOptions?}`,EmbeddingResult 为 `{embeddings:{index,vector:number[]}[],model?,usage?:{inputTokens,totalTokens}}`。embed 的 options 支持 signal;当前仅提供能力契约,没有内置 OpenAI /embeddings 编码实现。业务转换供应商输出、验证向量后返回统一结果,可像媒体一样继承 Provider 复用 requestJSON。
|
|
120
|
+
|
|
121
|
+
```ts
|
|
122
|
+
import {
|
|
123
|
+
Provider, type EmbeddingProvider, type EmbeddingRequest, type EmbeddingResult,
|
|
124
|
+
} from "@notic/agent-engine";
|
|
125
|
+
|
|
126
|
+
// 示例网关已返回统一结构;供应商原生响应应在子类中显式转换和校验。
|
|
127
|
+
class BusinessEmbeddingProvider extends Provider implements EmbeddingProvider {
|
|
128
|
+
async embed(input: EmbeddingRequest, options: { signal?: AbortSignal } = {}): Promise<EmbeddingResult> {
|
|
129
|
+
const result = await this.requestJSON<EmbeddingResult>("embedding", {
|
|
130
|
+
body: { model: input.model, input: input.input, dimensions: input.dimensions },
|
|
131
|
+
signal: options.signal, stream: false, purpose: "embedding",
|
|
132
|
+
});
|
|
133
|
+
if (!Array.isArray(result.embeddings)) throw new Error("Invalid embedding response");
|
|
134
|
+
return result;
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
向量调用不创建 Message、不写 Session、不经过 Agent 模型循环。检索索引、缓存和持久化由业务维护。继承与 capability 验证见 `test/v3/ce-feedback.test.ts`。
|
|
140
|
+
|
|
141
|
+
## 通过工具接入 Agent
|
|
142
|
+
|
|
143
|
+
Agent 不自动选择媒体模型或调用媒体方法。业务注册 Tool,在 execute 中调用对应 capability,传递 context.signal,保存产物并返回可序列化文件引用。独立 ToolExecutor 负责执行前审批;VideoTask ID 和未完成状态可作为工具结果返回,再通过任务查询工具继续。
|
|
144
|
+
|
|
145
|
+
合成验证见 `test/v3/multimedia.test.ts`,覆盖纯媒体和混合继承、鉴权、渐进图片、音频字节、multipart、视频恢复/取消、传输错误、读取限制与视频消息转换。浏览器运行验证也覆盖基类继承和二进制读取。没有调用真实媒体服务。
|