@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,148 @@
|
|
|
1
|
+
# CharacterEditor 反馈落实与接入契约
|
|
2
|
+
|
|
3
|
+
2026-10-08,对应 AgentEngine 3.0.0。依据 CE 的 [需求文档](D:/Code/NodeJs/CharacterEditor/docs/plans/2026-10-08-agentengine-3-feedback.md)。此次修改与合成验证均在 AgentEngine 中完成,CharacterEditor 的代码和原反馈文档未修改。
|
|
4
|
+
|
|
5
|
+
## 反馈处理结果
|
|
6
|
+
|
|
7
|
+
| CE 编号 | 已实现的接口与行为 |
|
|
8
|
+
| --- | --- |
|
|
9
|
+
| 1 运行中的业务状态写入 | Message.revision 记录全部编辑;requestRevision 只记录内容和请求相关元数据。业务 metadata/tags 可在运行中写入,不冲突、不使后续候选失效;真正的内容、协议和结构编辑仍检测冲突。 |
|
|
10
|
+
| 2 续写提示词排版 | 临时思考和继续指令先交给 PromptBuilder,带可识别 tags 与 sources;previewContext({kind:"continue",...}) 走同一路径。 |
|
|
11
|
+
| 3 续写合并 | 默认最新业务 metadata 浅覆盖、tags 并集;beforeCommit 可读取目标快照,beforeAppend 可修改默认合并草稿。带工具调用的 thinking 只存一份。 |
|
|
12
|
+
| 4 会话业务槽 | Session.metadata/setMeta/deleteMeta,独立 JSON 数据,保存且不影响租约。系统消息 metadata 也继续支持。 |
|
|
13
|
+
| 5 大量旧会话迁移 | 公开带类型的 SessionData 和结构类型,平坦表直接导入,保留外部节点/消息 ID、根/兄弟顺序与当前路径。 |
|
|
14
|
+
| 6 编译器来源标签 | transform 返回 Message[] 或 {messages,sources};旧变换兼容,新标签可通过后续变换保留。 |
|
|
15
|
+
| 7 传输标志 | HttpRequest.stream 必填 boolean,purpose 可区分 chat/image/audio/video/embedding/models/custom。单次请求超时由业务传输层处理。 |
|
|
16
|
+
| 8 思考策略 | Generator、Agent 构造和单次运行均可配置 thinking,逐字段覆盖;Agent 默认 auto/tool_call。 |
|
|
17
|
+
| 确认:向量 | 新增 EmbeddingProvider/EmbeddingRequest/EmbeddingResult;可继承 Provider 实现 embed,复用传输。当前没有内置厂商向量协议。 |
|
|
18
|
+
| 确认:多段思考 | 无工具调用的续写保留独立 thinking 块,CE 可显示为旧思考、分隔、新思考。工具思考单独留在协议载体中,可按执行记录关联显示。 |
|
|
19
|
+
|
|
20
|
+
完整参数见 [API](./API.md),媒体和向量契约见 [Provider 扩展](./MULTIMEDIA-3.0.md)。
|
|
21
|
+
|
|
22
|
+
## 状态与冲突
|
|
23
|
+
|
|
24
|
+
```ts
|
|
25
|
+
// 工具、宏结算和提交通知均可写入业务状态。
|
|
26
|
+
session.setMeta("stateDocument", { variables: { count: 1 }, notes: [] });
|
|
27
|
+
session.setMeta("started", true);
|
|
28
|
+
message.setMeta("stateRoot", "state/next").tag("undoable");
|
|
29
|
+
|
|
30
|
+
// 自定义编码/编译依赖的键应标为请求相关。
|
|
31
|
+
message.setMeta("customRouting", "model-port/1", { affectsRequest: true });
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Message 的 requestMetadataKeys 将自定义标记随序列化保存。内置保留键 thinkingSignature、geminiThinkingSignature、openaiReasoningItems、toolName、name 默认参与冲突检测。不能通过 affectsRequest:false 取消已有标记。
|
|
35
|
+
|
|
36
|
+
setText、setParts 等内容编辑仍触发冲突,内容块的 metadata 也是内容。系统文本编辑、选中路径或候选切换同样检测。ListSession 以请求版本判断后续候选是否失效。Session.metadata 不是模型输入;编译器若将业务状态转为提示词,应自行明确状态结算时点,依赖的消息 metadata 可使用上述请求标记。
|
|
37
|
+
|
|
38
|
+
## 提示词编译与预览
|
|
39
|
+
|
|
40
|
+
```ts
|
|
41
|
+
import {
|
|
42
|
+
PromptBuilder, Message, CONTINUATION_INSTRUCTION_TAG,
|
|
43
|
+
} from "@notic/agent-engine";
|
|
44
|
+
|
|
45
|
+
const promptBuilder = new PromptBuilder().use(messages => {
|
|
46
|
+
// 续写时这里已包含带标签的临时 User。
|
|
47
|
+
const instruction = messages.find(m => m.hasTag(CONTINUATION_INSTRUCTION_TAG));
|
|
48
|
+
const world = Message.system("世界书: 城市规则");
|
|
49
|
+
const index = instruction ? messages.indexOf(instruction) : messages.length;
|
|
50
|
+
return {
|
|
51
|
+
messages: [...messages.slice(0, index), world, ...messages.slice(index)],
|
|
52
|
+
sources: [{ messageId: world.id, source: "世界书: 城市", injected: true }],
|
|
53
|
+
};
|
|
54
|
+
});
|
|
55
|
+
|
|
56
|
+
const continueOptions = { instruction: "继续上一条回复,不重复原内容。", carryThinking: true };
|
|
57
|
+
const preview = await agent.previewContext({ kind: "continue", ...continueOptions });
|
|
58
|
+
// preview.messages / preview.sources 可供调试面板使用。
|
|
59
|
+
await agent.continue(continueOptions);
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
示例的 agent 应使用上面的 promptBuilder。CE 可将编译器的输出直接映射为 {messages,sources},sources 以 messageId 对应最终输出,sourceMessageId 可关联原历史消息。临时消息的 ID 每次构建不同;预览对齐角色、内容、标签、来源与排版,不能把它的临时 ID 当成下一次请求的持久身份。
|
|
63
|
+
|
|
64
|
+
预览不消费 injection life、不写 Session,不调用 beforeRequest 或 Provider 编码。应将希望预览的排版放在变换内;变换自己产生的外部副作用不会被引擎撤销。
|
|
65
|
+
|
|
66
|
+
## 续写保存与显示
|
|
67
|
+
|
|
68
|
+
```ts
|
|
69
|
+
const agent = new Agent({
|
|
70
|
+
provider, model: "your-model", session, promptBuilder,
|
|
71
|
+
hooks: {
|
|
72
|
+
beforeCommit(generated, context) {
|
|
73
|
+
generated.setMeta("modelName", "your-model").tag("generated");
|
|
74
|
+
// context.operation === "append" 时 context.targetMessage 是目标快照。
|
|
75
|
+
},
|
|
76
|
+
beforeAppend(draft, context) {
|
|
77
|
+
// draft 已含默认内容/metadata/tags 合并;保留原消息 ID。
|
|
78
|
+
draft.setMeta("components", renderComponents(draft.text));
|
|
79
|
+
draft.setMeta("stateRoot", context.generatedMessage.metadata.stateRoot
|
|
80
|
+
?? context.targetMessage.metadata.stateRoot ?? null);
|
|
81
|
+
draft.deleteMeta("obsoleteRenderCache");
|
|
82
|
+
},
|
|
83
|
+
async afterCommit(actual) {
|
|
84
|
+
await messageStore.save(actual.toJSON());
|
|
85
|
+
},
|
|
86
|
+
},
|
|
87
|
+
});
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
beforeCommit 先处理生成消息,beforeAppend 再处理目标草稿。两个目标快照与生成快照都隔离于 Session;beforeAppend 失败时不提交草稿。异步钩子等待期间新增的无关业务 metadata/tags 会保留,草稿显式修改的键按钩子处理。已提交的内容不会因为 afterCommit 持久化失败而撤回。
|
|
91
|
+
|
|
92
|
+
默认合并只更新目标消息,其他分支的显式业务状态保持原值。业务自行计算分支状态继承。带工具调用的续写会另存生成 ID 对应的协议消息,包含该步的 thinking 和 tool_call;目标只接收其正文/媒体,避免两处保存相同思考。签名保留在对应思考块中,原生 reasoning items 按协议合并或保留在工具载体。
|
|
93
|
+
|
|
94
|
+
## 平坦树直接导入
|
|
95
|
+
|
|
96
|
+
以下为最小可导入示例。已有 CE 数据可逐表转换,不必调用 select/addMessage 重放。
|
|
97
|
+
|
|
98
|
+
```ts
|
|
99
|
+
import { Message, Role, TreeSession, type TreeSessionData } from "@notic/agent-engine";
|
|
100
|
+
|
|
101
|
+
const system = new Message(Role.System, "角色提示", {}, { id: "ce/system" });
|
|
102
|
+
const user = new Message(Role.User, "你好", {}, { id: "ce/user/1" });
|
|
103
|
+
const left = new Message(Role.Assistant, "候选一", {}, { id: "ce/reply/1" });
|
|
104
|
+
const right = new Message(Role.Assistant, "候选二", {}, { id: "ce/reply/2" });
|
|
105
|
+
const data: TreeSessionData = {
|
|
106
|
+
format: "agent-engine-session", version: 3, type: "tree", id: "ce/session/1",
|
|
107
|
+
metadata: { started: true }, systemMessageId: system.id,
|
|
108
|
+
messages: [system, user, left, right].map(m => m.toJSON()),
|
|
109
|
+
trace: { turns: [], runs: [], steps: [], tools: [], contributions: [] },
|
|
110
|
+
structure: {
|
|
111
|
+
nodes: [
|
|
112
|
+
{ id: "n/right", messageId: right.id, parentId: "n/user", children: [] },
|
|
113
|
+
{ id: "n/user", messageId: user.id, parentId: null, children: ["n/left", "n/right"] },
|
|
114
|
+
{ id: "n/left", messageId: left.id, parentId: "n/user", children: [] },
|
|
115
|
+
],
|
|
116
|
+
roots: ["n/user"], cursor: "n/right",
|
|
117
|
+
},
|
|
118
|
+
};
|
|
119
|
+
const session = TreeSession.fromJSON(data);
|
|
120
|
+
// history(): system → user → 候选二;候选顺序仍是 left、right。
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
roots 指定根节点顺序,children 指定兄弟顺序,nodes 表顺序不影响两者。Message ID 和节点 ID 可以是非空的业务字符串,只要求在各自表内唯一;系统消息不能同时成为普通树节点。fromJSON 校验父子引用、重复节点、循环、可达性、选中节点等。
|
|
124
|
+
|
|
125
|
+
历史没有真实 Turn/Run/Step 时像示例一样保留空 trace,不根据文本伪造工具执行或用量;若 CE 有可信的交互记录,可显式迁移到 trace。导入不会恢复运行控制器或待审批操作。旧数据迁移步骤见 [迁移说明](./MIGRATION-3.0.md)。
|
|
126
|
+
|
|
127
|
+
## 传输与思考配置
|
|
128
|
+
|
|
129
|
+
transport 可直接用 request.stream / request.purpose 决定联网策略,不必解析平台 body 或 URL。执行预算 execution.timeoutMs 仍涵盖整次模型、工具和审批等待;CE 的单次非流式模型超时应在自己的 transport 中实现,并继续传递 signal。
|
|
130
|
+
|
|
131
|
+
```ts
|
|
132
|
+
const agent = new Agent({
|
|
133
|
+
provider, model: "your-model", session,
|
|
134
|
+
thinking: { mode: "native", scope: "tool_call" },
|
|
135
|
+
});
|
|
136
|
+
await agent.run({ thinking: { mode: "message" } });
|
|
137
|
+
await agent.continue({ thinking: { mode: "none" }, carryThinking: false });
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
覆写逐字段合并,不改变下一次调用的默认配置。carryThinking 控制续写临时的文本思考载体,thinking 控制原消息 thinking 块的协议回传。
|
|
141
|
+
|
|
142
|
+
## 验证与剩余接入工作
|
|
143
|
+
|
|
144
|
+
`test/v3/ce-feedback.test.ts` 新增 16 项测试,覆盖三种 Session 的运行期状态写入、真实编辑冲突、候选有效性、续写排版/预览/来源、钩子成功与失败、取消部分输出、异步业务写入、工具思考去重、平坦导入及顺序、存储兼容、流标志、思考配置和向量扩展。
|
|
145
|
+
|
|
146
|
+
2026-10-08 的 npm test:241 项测试,240 通过,1 项真实 API 测试跳过;75 项 3.0 测试全部通过。TypeScript、浏览器构建与无 Buffer 的运行、包导出检查通过。测试使用合成数据与 fake transport,没有真实平台调用。
|
|
147
|
+
|
|
148
|
+
CE 后续在自己的项目中适配 Provider 端口、提示词编译器、平坦 Session codec、续写、事件投影与审批。此文是对接依据,不代表 CE 已完成迁移、数据库存储验证或实际供应商联调。
|
|
@@ -0,0 +1,156 @@
|
|
|
1
|
+
# CharacterEditor 使用分析与 AgentEngine 3.0 设计输入
|
|
2
|
+
|
|
3
|
+
记录日期:2026-10-08。
|
|
4
|
+
|
|
5
|
+
业务项目:`D:\Code\NodeJs\CharacterEditor`。`ui/package.json` 当前声明 `@notic/agent-engine@2.2.0`。
|
|
6
|
+
|
|
7
|
+
本文通过静态阅读当前工作区的相关代码、架构文档和部分验证脚本整理使用方式。未运行业务、调用真实模型或执行验证脚本,未修改 CharacterEditor。下面的设计建议是新的讨论输入,不代表已经确认的 3.0 规范。
|
|
8
|
+
|
|
9
|
+
相关设计记录:[AgentEngine 3.0 设计讨论](./DESIGN-3.0.md)。后续已在 AgentEngine 实现新运行时,接入映射见 [迁移说明](./MIGRATION-3.0.md);业务项目未在本次修改或运行。
|
|
10
|
+
|
|
11
|
+
2026-10-08 后续确认:Message 负责自身内容编辑,Session 提供详细查询和委托编辑的便捷入口;三种会话均保留轮次与工具执行信息;保存和显示可以不同。具体方案见 [消息、会话与运行记录契约草案](./DATA-MODEL-3.0.md)。下文的业务事实保持不变,其他建议仍待收敛。
|
|
12
|
+
|
|
13
|
+
2026-10-08 CE 后续反馈已落实:运行期间业务状态写入、续写构建/预览和合并钩子、会话 metadata、平坦导入结构、变换来源标签、传输标志、思考策略与向量契约。当前接口和接入示例见 [反馈落实](./CE-FEEDBACK-3.0.md),下文仍保留首次分析的背景。
|
|
14
|
+
|
|
15
|
+
## 1. AgentEngine 的主要业务入口
|
|
16
|
+
|
|
17
|
+
CharacterEditor 的浏览器桥接入口为 `ui/src/lib/agent.ts`。主要调用链如下:
|
|
18
|
+
|
|
19
|
+
| 场景 | 主要入口(相对 CharacterEditor 根目录) | 当前使用方式 |
|
|
20
|
+
| --- | --- | --- |
|
|
21
|
+
| AI 助手 | `ui/src/stores/useChatStore.ts`、`ui/src/features/chat/agentRuntime.ts` | 独立 Session 保存真实消息;先准备用户消息,再创建 Agent,调用 generate;事件投影成 UI 消息 |
|
|
22
|
+
| RP 聊天 | `ui/src/stores/useRPChatStore.ts`、`ui/src/lib/rpPromptCompiler.ts` | Session 树保存历史与分支;支持编辑、重生成、候选切换、续写和摘要分支 |
|
|
23
|
+
| 游戏卡持久 Agent | `ui/src/features/gameCards/gameAgentService.ts` | 使用树形 Session 或 ListSession;保存候选及选择;支持 generate、continue、resume 和重新生成 |
|
|
24
|
+
| 游戏卡单次生成 | `ui/src/features/gameCards/gameAiBackend.ts` | 创建独立 Session 和工具包,生成过程中经宿主转发事件与工具执行 |
|
|
25
|
+
| 会话标题等辅助调用 | `ui/src/features/conversation/sessionTitles.ts` | 独立短会话、单步、非流式调用 |
|
|
26
|
+
|
|
27
|
+
当前助手和 RP 都使用树形 Session 作为已提交会话的真实数据源,UI 列表是投影。新增 AgentSession 后,是否迁移某个场景应由需要保留的分支、轮次和候选语义决定,不能仅按“助手”名称自动选择。
|
|
28
|
+
|
|
29
|
+
## 2. Provider:业务已经自行实现 HTTP 与 SSE
|
|
30
|
+
|
|
31
|
+
证据:`ui/src/features/chat/providerRuntime.ts`,特别是 `createEngineProvider`、`createOpenAICompatibleClient`、`createAnthropicClient`、`createGeminiClient` 和 `parseSSE`。
|
|
32
|
+
|
|
33
|
+
目前业务为三种平台发送 HTTP 请求、处理鉴权、完整响应和 SSE,并提供 SDK 形状的对象给 AgentEngine 内置 Provider。Gemini 还需要将引擎输出的 SDK 形状请求转换为 HTTP 请求体。
|
|
34
|
+
|
|
35
|
+
这说明框架自行实现平台协议有直接的业务价值:业务可以减少模拟 SDK 接口、解析 SSE 和重复处理平台请求的代码。业务项目仍声明 openai 依赖,不能据此断言整个应用已经移除了 SDK。
|
|
36
|
+
|
|
37
|
+
### 对 3.0 的设计输入
|
|
38
|
+
|
|
39
|
+
- Provider 接受统一请求,自己负责平台协议转换和流解码。
|
|
40
|
+
- 支持注入网络传输。`ui/src/api/network.ts` 的 `apiFetch` 统一提供直接请求、Web 服务代理和 Tauri 原生桥,Provider 应能复用这个边界。
|
|
41
|
+
- 自定义网络层应获得 URL、请求方法、headers、body 和取消信号,并能返回可读取的响应流。最终接口形式待确定。
|
|
42
|
+
- 框架处理模型协议;业务继续负责自己的代理、设备能力、凭据获取和配置存储。
|
|
43
|
+
- 保留 Provider 包装或请求处理扩展点。当前 `providerPolicy.ts` 会在发送前处理模型能力、预算和推理配置。
|
|
44
|
+
- 保留媒体资源解析扩展点。`managedAttachments.ts` 将 `attachment://`、`appfile://` 引用转换为提交所需的媒体数据,同时保留会话中的原引用。
|
|
45
|
+
|
|
46
|
+
## 3. Session:编辑与存储需要明确的结构操作
|
|
47
|
+
|
|
48
|
+
证据:`ui/src/features/conversation/sessionCore.ts`、`sessionOperations.ts`、`assistantSession.ts`,以及两种聊天 Store 的编辑、删除、重生成、分支和压缩动作。
|
|
49
|
+
|
|
50
|
+
业务目前自行维护:
|
|
51
|
+
|
|
52
|
+
- metadata 中的稳定消息标识,以及 UI 标识与引擎消息的映射。
|
|
53
|
+
- 节点的查询、遍历、删除、光标调整和分支切换。
|
|
54
|
+
- 工具调用与结果的关联删除。
|
|
55
|
+
- 迭代式 Flat Session 编解码,保存完整树、节点顺序与当前路径,避免深树递归序列化。
|
|
56
|
+
- 业务状态在分支间的继承与关联。
|
|
57
|
+
|
|
58
|
+
### 对 3.0 的设计输入
|
|
59
|
+
|
|
60
|
+
- Message 与会话节点分开后,明确 Message ID、节点 ID、候选 ID、Turn ID 的含义及引用关系。
|
|
61
|
+
- 提供按稳定标识定位、查询、结构删除、替换和遍历的公开接口。用户获取 Message 后通过消息自身方法编辑内容;Session 的编辑便捷入口委托这些方法。结构变化后由 Session 保持选中项或当前路径有效。
|
|
62
|
+
- 三种会话都保存轮次、模型步骤和工具执行关联。续写合并后,一个 Message 可以具有多个生成来源,不能只保存单一 stepId。
|
|
63
|
+
- 明确工具调用及结果的关联规则,避免业务通过全树扫描维护基础协议一致性。
|
|
64
|
+
- 会话导出应保存组织结构与选择,并支持深历史;格式带版本,具体快照、增量保存或记录迭代接口待定。
|
|
65
|
+
- 会话和结构单元应允许关联业务扩展数据。当前大量会话状态存放在 system root 上,Message 脱离节点后需要为会话属性与结构状态提供明确归属。
|
|
66
|
+
- 不将 CharacterEditor 的状态继承、数据库或具体业务事务搬进引擎;引擎提供必要的定位与生命周期能力。
|
|
67
|
+
|
|
68
|
+
## 4. 继续生成:有现成业务实现可用于检验设计
|
|
69
|
+
|
|
70
|
+
证据:`ui/src/features/conversation/continuation.ts`、`useChatStore.ts` 的继续动作、`useRPChatStore.ts` 的 `continueGeneration`,以及 `ui/scripts/verify-continuation.mjs` 中的场景断言。
|
|
71
|
+
|
|
72
|
+
RP 续写会暂时移动已有 thinking 到助手文本消息、添加用户继续指令,再调用 generate。助手续写调用现有 agent.continue,事后标记其追加的用户指令。两者最终使用共享逻辑合并内容、移除临时消息和修整树。
|
|
73
|
+
|
|
74
|
+
业务语义比字符串拼接更完整:
|
|
75
|
+
|
|
76
|
+
- 正常完成:合并正文与思考,保留新媒体内容,清理临时指令。
|
|
77
|
+
- 用户中止:把已经输出的部分作为提前结束合并。
|
|
78
|
+
- 续写首次响应未完整返回就失败:恢复续写前状态,原回复不变。
|
|
79
|
+
- 续写首次响应完整返回后,后续工具步骤失败:保留已完成内容和后续执行进度。
|
|
80
|
+
- 首次续写回复含工具调用:工具调用之前的正文并入原回复;工具调用、结果及其后的消息保持有序关联,不全压成一条消息。
|
|
81
|
+
- 合并时还需保留原有分支和分支状态关系,移除临时节点不能改变其他分支的业务状态。
|
|
82
|
+
|
|
83
|
+
### 对 3.0 的设计输入
|
|
84
|
+
|
|
85
|
+
- 内置 continue 应绑定明确目标,并以临时请求上下文实现继续指令。
|
|
86
|
+
- 区分完成、中止和失败,明确哪些结果合并、哪些结果回滚。
|
|
87
|
+
- 合并操作必须保留媒体、工具协议关联和必要的模型元数据。
|
|
88
|
+
- 引擎提供通用的合并结果和结构变化信息,业务据此关联自己的状态。
|
|
89
|
+
- 当前业务的细节可作为候选行为和验证场景;尚需用户决定是否全部作为 3.0 默认行为。
|
|
90
|
+
- 旧数据转换属于 CharacterEditor 的迁移任务,不必进入 AgentEngine 核心。
|
|
91
|
+
|
|
92
|
+
## 5. 工具:可见、启用与执行授权是不同状态
|
|
93
|
+
|
|
94
|
+
证据:`ui/src/features/tools/onDemand.ts`、`toolBundles.ts`、`ui/src/features/chat/agentRuntime.ts` 的审批事件处理,以及 RP 工具事件绑定。
|
|
95
|
+
|
|
96
|
+
助手先暴露 tools_list / tools_enable,模型按需加载工具。工具启用后,下一次模型调用才获得完整定义;启用不等于批准执行。
|
|
97
|
+
|
|
98
|
+
助手和 RP 均将 Agent 配置为人工审批模式,再通过事件查询业务策略:自动允许的调用异步 approve,需要确认的调用显示审批卡片。业务自行维护审批 ID 与 Agent 的映射,处理完成、拒绝和运行结束后的清理。
|
|
99
|
+
|
|
100
|
+
游戏卡工具还直接使用已有 JSON Schema,并自行校验参数,包括 Param builder 不能完整表达的约束。
|
|
101
|
+
|
|
102
|
+
### 对 3.0 的设计输入
|
|
103
|
+
|
|
104
|
+
- 工具执行模块区分注册、模型可见性、启用与每次执行授权。
|
|
105
|
+
- 每次模型步骤读取当前工具定义,保留运行期间动态加载工具的能力。
|
|
106
|
+
- 支持完整 JSON Schema 输入,工具内部使用平台无关的定义;参数校验能力及依赖策略待确定。
|
|
107
|
+
- 执行策略允许访问解析后的参数、运行上下文和取消信号,支持自动允许、拒绝或等待人工决策。
|
|
108
|
+
- 审批请求、决策入口、超时与清理由独立工具执行能力维护;Agent 负责运行协调。
|
|
109
|
+
- 工具失败结果、抛错、暂停和并发策略应分别定义,避免一个选项隐式改变多个行为。
|
|
110
|
+
- 资源写入事务、应用权限目录和业务回滚规则继续由业务实现。
|
|
111
|
+
|
|
112
|
+
## 6. PromptBuilder:需要预览、异步准备与结算边界
|
|
113
|
+
|
|
114
|
+
证据:`ui/src/lib/rpPromptCompiler.ts`、`assistantRuntimePromptCompiler.ts`、`ui/src/features/chat/agentRuntime.ts`、`ui/src/features/macros/promptTransaction.ts` 和两个 Store 的 `getDebugMessages`。
|
|
115
|
+
|
|
116
|
+
上下文由角色资料、预设、世界书、Skills、记忆或笔记索引、宏和正则等多种来源组成。业务先完成异步准备,再创建同步 PromptBuilder;RP 还进行深度插入和相邻 system 消息合并。
|
|
117
|
+
|
|
118
|
+
预览与运行分开构建。调试面板通过消息对象身份、metadata 或 WeakMap 区分注入来源。提示词宏可能修改状态,因此业务通过 WeakMap 绑定暂存事务,生成后按已保留的完整模型步骤提交或回滚,并在工具写状态前结算相关宏。
|
|
119
|
+
|
|
120
|
+
### 对 3.0 的设计输入
|
|
121
|
+
|
|
122
|
+
- 保留任意消息数组转换能力,允许业务自定义顺序、位置、裁剪及内容处理。
|
|
123
|
+
- 明确异步准备与上下文构建的扩展入口,可考虑异步 builder 或独立准备阶段。
|
|
124
|
+
- 区分无副作用的预览和正式运行中的构建与消费;预览不应改变注入次数或提交业务状态。
|
|
125
|
+
- 上下文构建结果可携带来源、锚点和转换记录,使业务不必依赖对象身份判断来源。
|
|
126
|
+
- 提供生成前、模型步骤提交前后、运行结束等明确生命周期,使业务能绑定自己的暂存状态与结算逻辑。
|
|
127
|
+
- 区分模型完成、会话写入和业务持久化成功,框架内存提交不代表数据库提交。
|
|
128
|
+
- 世界书触发、角色宏、应用 Skills 和正则规则保持业务扩展。
|
|
129
|
+
|
|
130
|
+
## 7. 流式事件:明确运行、步骤、消息与内容归属
|
|
131
|
+
|
|
132
|
+
证据:`ui/src/features/chat/agentRuntime.ts` 的 `bindChatAgentEvents`、RP 流式展示绑定、`gameAgentService.ts` 的事件转发和 `gameAiBackend.ts` 的推理事件转换。
|
|
133
|
+
|
|
134
|
+
业务自行创建流式消息标识;每次工具循环切换占位消息;工具调用开始时固定已有文本;提交前再给 Message 写入 UI 标识。游戏 Agent 的转发层另行添加 runId、agentId 和 conversationId。
|
|
135
|
+
|
|
136
|
+
### 对 3.0 的设计输入
|
|
137
|
+
|
|
138
|
+
- 流式事件从生成开始就能关联运行、模型步骤和最终消息,必要时关联内容块和工具调用。
|
|
139
|
+
- delta 与累计 snapshot 的字段和语义保持一致,便于多种 UI 或宿主协议转换。
|
|
140
|
+
- 区分模型原始输出完成与应用转换后消息已提交。RP 会在提交前执行输出正则,最终保存内容可能不同于流式原文。
|
|
141
|
+
- 明确 partial、已完成步骤与失败原因,业务能直接判断保留或回滚范围,减少拼接多个可选字段推断状态的逻辑。
|
|
142
|
+
- 渲染节流、消息卡片和沙箱通信由业务处理,引擎输出结构化事实。
|
|
143
|
+
|
|
144
|
+
## 8. 优先讨论顺序
|
|
145
|
+
|
|
146
|
+
2026-10-08 补充核查:`features/media/adapters.ts`、`jobs.ts`、`tools/mediaTools.ts` 提供了图片生成、语音合成和视频异步任务,首次重构没有覆盖这些输出能力。现已添加 Provider 基类、独立媒体能力接口、GET/multipart/二进制传输和视频消息扩展;接口与边界见 [多媒体设计与实现](./MULTIMEDIA-3.0.md)。业务的持久化、模型目录、参数 schema 和界面继续通过扩展接入,未修改业务代码。
|
|
147
|
+
|
|
148
|
+
1. Message、节点、候选、Turn 和模型步骤的身份及关系。
|
|
149
|
+
2. Session 的公开编辑、生成提交和序列化契约。
|
|
150
|
+
3. continue 的目标绑定、合并、工具边界与失败语义。
|
|
151
|
+
4. 独立工具执行与审批策略,动态工具定义和参数校验。
|
|
152
|
+
5. Provider 的统一请求、可注入传输与媒体解析。
|
|
153
|
+
6. PromptBuilder 的来源信息、预览、异步扩展和生命周期。
|
|
154
|
+
7. 流式事件与配置 API,形成少量典型业务调用样例。
|
|
155
|
+
|
|
156
|
+
这些输入支持此前讨论的模块边界,并增加了对扩展入口、提交状态和身份关联的具体要求。后续应以选定的真实场景检验草案,避免将整个应用运行时复制到框架中。
|
|
@@ -0,0 +1,248 @@
|
|
|
1
|
+
# AgentEngine 3.0 消息、会话与运行记录契约草案
|
|
2
|
+
|
|
3
|
+
记录日期:2026-10-08。
|
|
4
|
+
|
|
5
|
+
依据:[设计讨论记录](./DESIGN-3.0.md)、[CharacterEditor 使用分析](./CHARACTEREDITOR-3.0-NOTES.md)。本文保留讨论阶段的职责、数据关系和操作语义。相关运行时代码已实现,实际字段和接口见 [API](./API.md);下文草案用于解释设计动机。
|
|
6
|
+
|
|
7
|
+
当前实施边界和默认选择见 [3.0 设计基线与实施计划](./PLAN-3.0.md)。本文列出的细节问题用于指导实现样例和验证,常规选择由该计划收敛。
|
|
8
|
+
|
|
9
|
+
## 1. 本轮明确的要求
|
|
10
|
+
|
|
11
|
+
- Message 脱离节点结构,但保留自身的内容编辑能力。
|
|
12
|
+
- Session 提供详细查询,让用户获得具体 Message;便捷编辑接口委托 Message 的编辑方法。
|
|
13
|
+
- 模型生成、会话保存、界面显示不保证内容或形状一致,需要明确转换与关联关系。
|
|
14
|
+
- TreeSession、ListSession、AgentSession 都保留消息轮次与工具使用轮次信息。
|
|
15
|
+
- AgentEngine 要覆盖实际业务需要的通用逻辑;业务通过稳定公开接口接入自己的规则。
|
|
16
|
+
|
|
17
|
+
以下为实现这些要求的设计草案,未确认的行为在最后单独列出。
|
|
18
|
+
|
|
19
|
+
## 2. 职责与所有权
|
|
20
|
+
|
|
21
|
+
| 对象 | 拥有的内容 | 提供的操作 |
|
|
22
|
+
| --- | --- | --- |
|
|
23
|
+
| Message | 标识、角色、内容块、消息元数据、内容版本 | 内容读取、追加、替换、移除、克隆与消息数据导出 |
|
|
24
|
+
| Session | 消息集合、组织结构、选择状态、会话扩展数据、运行关联记录 | 查询、结构编辑、历史投影、生成提交、会话导入导出 |
|
|
25
|
+
| TurnRecord | 一次用户交互的身份和输入关联 | 将多个运行和消息归入同一次交互 |
|
|
26
|
+
| RunRecord | 一次实际执行及其步骤、停止原因、提交目标 | 表达一次生成、重生成、继续或恢复的执行记录 |
|
|
27
|
+
| StepRecord | 一次模型调用及其输出关联、用量和结束原因 | 关联模型请求与输出,并关联这一步发起的工具调用 |
|
|
28
|
+
| ToolExecutionRecord | 一次工具调用的参数、审批、执行状态和结果关联 | 记录工具执行事实,关联模型步骤或独立调用来源 |
|
|
29
|
+
| PromptBuilder | 上下文构建规则和构建结果的来源信息 | 为请求构建临时上下文,提供预览与扩展入口 |
|
|
30
|
+
|
|
31
|
+
2026-10-08 后续讨论提出独立的单次生成单元(暂称 Generator),Agent 在其上组合上下文与自主执行循环。Generator 产生一次模型响应;Step 记录该调用,二者不是同一个数据对象。具体入口与名称待确认,见 [设计记录 4.4](./DESIGN-3.0.md#44-一次生成与-agent-自主执行分别建模)。
|
|
32
|
+
|
|
33
|
+
RunRecord 是可保存的数据;运行时的 Run 控制对象另外持有 AbortController、等待中的 Promise 和执行依赖。这些运行时对象不进入会话 JSON。
|
|
34
|
+
|
|
35
|
+
Message 不拥有 Session、节点位置、父子关系或当前候选,也不直接执行数据库保存和界面渲染。
|
|
36
|
+
|
|
37
|
+
## 3. Message:内容编辑由消息本身完成
|
|
38
|
+
|
|
39
|
+
倾向使用具有编辑方法的 Message class。具体实现形式仍可调整,但外部不需要了解缓存或内容块维护细节。
|
|
40
|
+
|
|
41
|
+
建议保留和补充少量明确操作:
|
|
42
|
+
|
|
43
|
+
```ts
|
|
44
|
+
message.text;
|
|
45
|
+
message.thinking;
|
|
46
|
+
message.parts;
|
|
47
|
+
|
|
48
|
+
message.setText("替换正文");
|
|
49
|
+
message.appendText("追加正文");
|
|
50
|
+
message.setThinking("替换思考");
|
|
51
|
+
message.appendThinking("追加思考");
|
|
52
|
+
message.setParts(parts);
|
|
53
|
+
message.addPart(part);
|
|
54
|
+
message.replacePart(partId, replacement);
|
|
55
|
+
message.removePart(partId);
|
|
56
|
+
message.setMeta("business.source", value);
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
语义要求:
|
|
60
|
+
|
|
61
|
+
- 文本编辑保留未涉及的思考、媒体和工具内容块。
|
|
62
|
+
- 部分内容块的编辑保留其余块的顺序,不随意重排平台所需的内容顺序。
|
|
63
|
+
- 编辑方法统一维护缓存与版本;用户不需要手动 invalidateCache。
|
|
64
|
+
- parts 及嵌套内容通过只读视图或快照公开,避免数组和对象的直接写入绕过编辑方法。
|
|
65
|
+
- 消息 ID 在内容编辑后保持不变;版本随内容变化更新。
|
|
66
|
+
- 普通克隆产生新的消息身份;请求构建可以使用保留来源标识的值快照。两者语义分别定义,避免同 ID 的独立可变对象混淆。
|
|
67
|
+
- provider 所需的协议扩展数据有明确归属;内容编辑之后这些数据是否仍有效,需要由协议转换层判断。
|
|
68
|
+
|
|
69
|
+
内容块是否全部具有稳定 ID、setText 在多个文本块中的具体替换位置、元数据变更如何计入版本,还需要按多模态和平台协议样例确定。
|
|
70
|
+
|
|
71
|
+
### 3.1 独立编辑与 Session 的变化感知
|
|
72
|
+
|
|
73
|
+
用户从 Session 查询到的 Message 是该 Session 持有的对象,可以直接调用内容编辑方法。
|
|
74
|
+
|
|
75
|
+
建议 Message 发出不依赖 Session 类型的变更通知,Session 注册消息时监听,移除或释放时解除监听。这样 Message 不反向依赖 Session,Session 又能更新内容版本、查询索引和历史失效标记。
|
|
76
|
+
|
|
77
|
+
变更通知与可阻止修改的执行 Hook 分别定义。多个 Session 显式共享同一个 Message 时,直接修改应当影响所有持有者;需要隔离的业务使用克隆。
|
|
78
|
+
|
|
79
|
+
Session 的编辑便捷入口委托 Message:
|
|
80
|
+
|
|
81
|
+
```ts
|
|
82
|
+
const message = session.getMessage(messageId);
|
|
83
|
+
message?.setText("修改后的内容");
|
|
84
|
+
|
|
85
|
+
// 等价的便捷调用,不复制一套文本编辑逻辑。
|
|
86
|
+
session.editMessage(messageId, message => {
|
|
87
|
+
message.setText("修改后的内容");
|
|
88
|
+
});
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
Session 负责定位及结构有效性,Message 负责内容变更。编辑中的冲突与运行提交规则见第 7 节。
|
|
92
|
+
|
|
93
|
+
## 4. 三种 Session 共用轮次与执行记录
|
|
94
|
+
|
|
95
|
+
轮次信息属于所有 Session 的共同记录能力,组织结构是另外一个维度。
|
|
96
|
+
|
|
97
|
+
```text
|
|
98
|
+
共同消息与执行记录
|
|
99
|
+
Turn → Run → Step → ToolExecution
|
|
100
|
+
│
|
|
101
|
+
消息出现位置与生成贡献关联
|
|
102
|
+
│
|
|
103
|
+
┌───────────────┼───────────────┐
|
|
104
|
+
TreeSession ListSession AgentSession
|
|
105
|
+
按树组织 按候选槽位组织 按交互轮组织
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
AgentSession 按 Turn 直接组织交互;TreeSession 和 ListSession 保留相同的轮次信息,用于查询、导出和恢复后的展示。
|
|
109
|
+
|
|
110
|
+
### 4.1 轮次定义
|
|
111
|
+
|
|
112
|
+
- Turn:一次用户交互。新 chat 创建新 Turn;继续或恢复关联原 Turn。
|
|
113
|
+
- Run:一次实际执行。重新生成、续写和恢复有独立 Run,保留运行之间的关联。
|
|
114
|
+
- Step:某个 Run 中的一次模型调用,编号在该 Run 内计算。
|
|
115
|
+
- ToolExecution:一个模型 Step 可以发起多个工具调用;每次具体执行有自己的标识和结果。
|
|
116
|
+
|
|
117
|
+
模型返回的 toolCallId 用于平台协议配对。内部 toolExecutionId 用于标识一次真实执行,不把厂商的调用 ID 当作跨步骤、跨运行的全局唯一身份。
|
|
118
|
+
|
|
119
|
+
手动添加的 system、user、assistant、tool 消息不一定具有完整运行来源。提供显式归组或关联入口;来源未知时保留未知,不按角色顺序伪造完整的执行历史。
|
|
120
|
+
|
|
121
|
+
小生成单元使用明确传入的上下文,不创建用户输入或自动维护 Turn。调用方若将结果纳入 Session,允许显式关联执行与 Turn;没有明确用户交互来源时保留为独立生成,不伪造用户输入。Agent 的自主执行入口负责其 Turn / Run 归属;确切默认归组策略待定。
|
|
122
|
+
|
|
123
|
+
### 4.2 Message 的身份与出现位置分别管理
|
|
124
|
+
|
|
125
|
+
轮次关联不应仅在 Message 上写一个 turnId 或 stepId。
|
|
126
|
+
|
|
127
|
+
原因:
|
|
128
|
+
|
|
129
|
+
- 同一 Message 可能在多个 Session 或结构位置中使用。
|
|
130
|
+
- 续写后的一个 Message 可能包含多次模型调用的贡献。
|
|
131
|
+
- 重生成会保留同一交互的多个候选,各自有不同的运行记录。
|
|
132
|
+
|
|
133
|
+
建议 Session 保存消息出现位置与执行记录的关联。关联包含可定位的结构身份,如节点 ID 或候选 ID,以及 turnId、runId、stepId。Message 只处理自身内容。
|
|
134
|
+
|
|
135
|
+
### 4.3 合并后的消息保留多次生成贡献
|
|
136
|
+
|
|
137
|
+
例如用户提出任务后,模型调用工具并回复,随后继续生成:
|
|
138
|
+
|
|
139
|
+
```text
|
|
140
|
+
Turn T1
|
|
141
|
+
Run R1:正常生成
|
|
142
|
+
Step S1:Assistant M1 发起工具调用 C1
|
|
143
|
+
ToolExecution E1:结果 Message M2
|
|
144
|
+
Step S2:生成回答 Message M3
|
|
145
|
+
|
|
146
|
+
Run R2:继续生成,目标为 M3
|
|
147
|
+
Step S3:生成续写,提交时合并进 M3
|
|
148
|
+
|
|
149
|
+
最终会话:M1 → M2 → M3
|
|
150
|
+
M3 的生成贡献:R1/S2 + R2/S3
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
示例中的 S1/S2/S3 是稳定标识;步骤显示编号分别为 R1 的 1、2 和 R2 的 1。
|
|
154
|
+
|
|
155
|
+
建议保存独立的消息生成贡献记录:关联生成来源、目标 Message ID、目标版本和本次提交操作,如 create、append 或 replace。精确记录到内容块或范围的方式待定。
|
|
156
|
+
|
|
157
|
+
后续用户编辑可以使历史贡献的文本范围不再准确,此时保留生成来源并标明内容已编辑,不声称当前文本仍等同于原始模型输出。
|
|
158
|
+
|
|
159
|
+
Step 保留自身 usage,合并正文不覆盖此前调用的用量。按 Run、Turn 或候选汇总时,明确计算范围并按模型调用去重。
|
|
160
|
+
|
|
161
|
+
### 4.4 分支、候选与删除
|
|
162
|
+
|
|
163
|
+
- 重生成使用新的 Run 和 Step,保留旧候选的记录;选中历史与全会话记录可分别查询。
|
|
164
|
+
- 分支中的交互顺序由当前路径计算。稳定身份与界面上的“第几轮”分别管理。
|
|
165
|
+
- 切换候选后,查询当前上下文时仅包含选中的路径或候选;查询完整记录时可包含未选中的执行。
|
|
166
|
+
- 删除当前内容不会静默改变已经执行过工具的事实。可以保留脱离当前内容的历史记录,并提供显式清理机制;确切删除与清理策略待定。
|
|
167
|
+
- 所有 Session 的导出和导入都保留必要的 Turn、Run、Step、ToolExecution 与消息关联,轮次信息不能只存在于流式事件或 Agent 内存中。
|
|
168
|
+
- 不要求默认保存每次调用的完整原始请求、原始响应和重复媒体。保留结构与执行事实,详细原始数据可由显式记录策略提供。
|
|
169
|
+
|
|
170
|
+
## 5. Session 查询契约
|
|
171
|
+
|
|
172
|
+
采用公共查询能力,默认范围为当前选中历史,显式选择全会话范围。API 示例:
|
|
173
|
+
|
|
174
|
+
```ts
|
|
175
|
+
session.getMessage(messageId);
|
|
176
|
+
session.query.messages({ role: "assistant", scope: "active" });
|
|
177
|
+
session.query.messages({ tags: ["important"], scope: "all" });
|
|
178
|
+
session.query.messages({ turnId, scope: "active" });
|
|
179
|
+
session.query.messages({ runId, toolCallId, scope: "all" });
|
|
180
|
+
|
|
181
|
+
session.query.turns({ scope: "active" });
|
|
182
|
+
session.query.runs({ turnId, scope: "all" });
|
|
183
|
+
session.query.steps({ runId });
|
|
184
|
+
session.query.toolExecutions({ runId, status: "awaitingApproval" });
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
查询维度可包含标识、角色、内容、标签、消息元数据、内容块类型、轮次、运行、步骤和工具执行。允许自定义谓词。
|
|
188
|
+
|
|
189
|
+
查询返回的 Message 可以通过自身接口编辑;执行记录提供只读结果,由会话提交接口或执行模块维护其一致性。
|
|
190
|
+
|
|
191
|
+
需要明确:
|
|
192
|
+
|
|
193
|
+
- 当前范围与全会话范围的顺序、分页以及身份去重规则。
|
|
194
|
+
- 通过 Message 查询内容,与通过节点、候选、Turn 查询出现位置的区别。
|
|
195
|
+
- 同一内容出现在多个位置时,结构操作必须指定位置身份,不能仅凭 Message ID 猜测删除哪个节点。
|
|
196
|
+
- 仅消息查询不代表某次调用生成时的原始内容;追踪执行来源时查询相应记录和贡献。
|
|
197
|
+
|
|
198
|
+
## 6. 生成、提交、请求上下文与显示分别表达
|
|
199
|
+
|
|
200
|
+
CharacterEditor 已存在输出正则、仅请求生效的正则和仅显示生效的正则。框架不强制这些内容相同,也不把所有转换塞进 Message.text。
|
|
201
|
+
|
|
202
|
+
```text
|
|
203
|
+
模型原始输出 → 提交前处理 → Session 中的 Message
|
|
204
|
+
├→ 请求上下文转换 → Provider
|
|
205
|
+
├→ 业务显示投影 → UI
|
|
206
|
+
└→ 会话数据导出 → 业务存储
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
原则:
|
|
210
|
+
|
|
211
|
+
- Message 表达当前版本的消息内容,能够被用户编辑。
|
|
212
|
+
- Step 和生成贡献表达模型执行与提交来源。
|
|
213
|
+
- PromptBuilder 基于消息快照构建临时上下文,转换不修改 Session;保留来源关联。
|
|
214
|
+
- UI 可以隐藏思考、将工具调用投影成卡片、合并展示或修改显示文本,显示投影不自动写回会话。
|
|
215
|
+
- 提交前转换允许明确修改即将进入 Session 的内容。
|
|
216
|
+
- Session 内存提交与业务持久化完成是两个阶段,不把 MESSAGE_COMMITTED 当作数据库成功。
|
|
217
|
+
|
|
218
|
+
建议事件至少区分模型消息组装完成与会话提交完成,并带有关联身份。继续生成可在 UI 中先显示旧内容加新增量,最终用已提交 Message 校正显示;不强制用户采用特定渲染方式。
|
|
219
|
+
|
|
220
|
+
## 7. 生成提交与外部编辑
|
|
221
|
+
|
|
222
|
+
Agent 在开始运行时绑定 Turn、目标位置、候选和需要检查的内容版本;完成时通过 Session 的提交操作应用结果。
|
|
223
|
+
|
|
224
|
+
Message 的编辑能力保持独立。运行中的外部编辑、目标删除和候选切换由提交规则处理,不能默默把输出写到结束时的新光标,也不能覆盖已经编辑的消息。
|
|
225
|
+
|
|
226
|
+
继续生成尤其需要校验目标版本。可采用检测冲突后保留未应用结果的默认策略;是否允许用户指定追加、另建候选或其他解决方式,待确定。
|
|
227
|
+
|
|
228
|
+
提交操作协调消息编辑与执行记录:
|
|
229
|
+
|
|
230
|
+
- create:创建并放入指定位置,登记生成贡献。
|
|
231
|
+
- append:调用目标 Message 的追加方法,登记新贡献。
|
|
232
|
+
- replace:替换目标内容或位置引用,保留明确的旧记录关系。
|
|
233
|
+
- failure / interruption:记录实际执行进度和最终保留内容,不制造未执行工具的成功结果。
|
|
234
|
+
|
|
235
|
+
框架提供内存层面的协调;业务可以在明确的提交生命周期绑定自己的状态和持久化事务。框架不会承诺撤销外部工具副作用。
|
|
236
|
+
|
|
237
|
+
## 8. 需要继续决定的细节
|
|
238
|
+
|
|
239
|
+
1. Message 的内容块身份、编辑方法的精确语义、变更通知与版本粒度。
|
|
240
|
+
2. 手动添加消息和 generate 的默认 Turn 归组方式。
|
|
241
|
+
3. 节点、候选和交互轮的公共引用形式,以及共享 Message 的约束。
|
|
242
|
+
4. 生成贡献是否默认精确到内容块;编辑、删除后如何保留或清理记录。
|
|
243
|
+
5. Run / Step / ToolExecution 的最小持久字段与运行时状态的区别。
|
|
244
|
+
6. continue 在工具调用、中止和失败时的具体提交策略。
|
|
245
|
+
7. 外部编辑冲突的默认处理与结果返回类型。
|
|
246
|
+
8. 公开查询 API 的命名、范围、顺序与分页,避免引入大量重复入口。
|
|
247
|
+
|
|
248
|
+
下一步可以用正常聊天、工具循环、重生成、继续生成、消息编辑、导出恢复六组样例检验这些契约,再进入实现。
|