@notic/agent-engine 2.1.0 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +56 -15
- package/README.md +97 -434
- package/dist/agent/Agent.d.ts +133 -355
- package/dist/agent/Agent.d.ts.map +1 -1
- package/dist/agent/Agent.js +302 -1123
- package/dist/agent/Agent.js.map +1 -1
- package/dist/agent/index.d.ts +1 -1
- package/dist/agent/index.d.ts.map +1 -1
- package/dist/agent/index.js +15 -8
- package/dist/agent/index.js.map +1 -1
- package/dist/core/data.d.ts +17 -0
- package/dist/core/data.d.ts.map +1 -0
- package/dist/core/data.js +86 -0
- package/dist/core/data.js.map +1 -0
- package/dist/generator/Generator.d.ts +37 -0
- package/dist/generator/Generator.d.ts.map +1 -0
- package/dist/generator/Generator.js +71 -0
- package/dist/generator/Generator.js.map +1 -0
- package/dist/generator/index.d.ts +2 -0
- package/dist/generator/index.d.ts.map +1 -0
- package/dist/generator/index.js +18 -0
- package/dist/generator/index.js.map +1 -0
- package/dist/index.d.ts +7 -33
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +21 -92
- package/dist/index.js.map +1 -1
- package/dist/legacy/adapter/AnthropicAdapter.d.ts.map +1 -0
- package/dist/{adapter → legacy/adapter}/AnthropicAdapter.js +3 -3
- package/dist/legacy/adapter/AnthropicAdapter.js.map +1 -0
- package/dist/legacy/adapter/GeminiAdapter.d.ts.map +1 -0
- package/dist/{adapter → legacy/adapter}/GeminiAdapter.js +3 -3
- package/dist/legacy/adapter/GeminiAdapter.js.map +1 -0
- package/dist/legacy/adapter/MessageAdapter.d.ts.map +1 -0
- package/dist/legacy/adapter/MessageAdapter.js.map +1 -0
- package/dist/legacy/adapter/OpenAIAdapter.d.ts.map +1 -0
- package/dist/{adapter → legacy/adapter}/OpenAIAdapter.js +1 -1
- package/dist/legacy/adapter/OpenAIAdapter.js.map +1 -0
- package/dist/legacy/adapter/OpenAIResponsesAdapter.d.ts.map +1 -0
- package/dist/legacy/adapter/OpenAIResponsesAdapter.js.map +1 -0
- package/dist/legacy/adapter/index.d.ts.map +1 -0
- package/dist/legacy/adapter/index.js.map +1 -0
- package/dist/legacy/agent/Agent.d.ts +371 -0
- package/dist/legacy/agent/Agent.d.ts.map +1 -0
- package/dist/legacy/agent/Agent.js +1169 -0
- package/dist/legacy/agent/Agent.js.map +1 -0
- package/dist/legacy/agent/index.d.ts +2 -0
- package/dist/legacy/agent/index.d.ts.map +1 -0
- package/dist/legacy/agent/index.js +11 -0
- package/dist/legacy/agent/index.js.map +1 -0
- package/dist/legacy/client/ModelClient.d.ts.map +1 -0
- package/dist/legacy/client/ModelClient.js.map +1 -0
- package/dist/legacy/client/index.d.ts.map +1 -0
- package/dist/legacy/client/index.js.map +1 -0
- package/dist/legacy/config/RequestConfig.d.ts.map +1 -0
- package/dist/legacy/config/RequestConfig.js.map +1 -0
- package/dist/legacy/config/index.d.ts.map +1 -0
- package/dist/legacy/config/index.js.map +1 -0
- package/dist/legacy/index.d.ts +36 -0
- package/dist/legacy/index.d.ts.map +1 -0
- package/dist/legacy/index.js +97 -0
- package/dist/legacy/index.js.map +1 -0
- package/dist/legacy/media/BrowserMediaResolver.d.ts.map +1 -0
- package/dist/legacy/media/BrowserMediaResolver.js.map +1 -0
- package/dist/legacy/media/DefaultMediaResolver.d.ts.map +1 -0
- package/dist/legacy/media/DefaultMediaResolver.js.map +1 -0
- package/dist/legacy/media/MediaResolver.d.ts.map +1 -0
- package/dist/legacy/media/MediaResolver.js.map +1 -0
- package/dist/legacy/media/index.d.ts.map +1 -0
- package/dist/legacy/media/index.js.map +1 -0
- package/dist/legacy/message/Message.d.ts +147 -0
- package/dist/legacy/message/Message.d.ts.map +1 -0
- package/dist/legacy/message/Message.js +446 -0
- package/dist/legacy/message/Message.js.map +1 -0
- package/dist/legacy/message/MessagePart.d.ts +50 -0
- package/dist/legacy/message/MessagePart.d.ts.map +1 -0
- package/dist/legacy/message/MessagePart.js +6 -0
- package/dist/legacy/message/MessagePart.js.map +1 -0
- package/dist/legacy/message/Role.d.ts +10 -0
- package/dist/legacy/message/Role.d.ts.map +1 -0
- package/dist/legacy/message/Role.js +14 -0
- package/dist/legacy/message/Role.js.map +1 -0
- package/dist/legacy/message/Usage.d.ts.map +1 -0
- package/dist/legacy/message/Usage.js.map +1 -0
- package/dist/legacy/message/index.d.ts +5 -0
- package/dist/legacy/message/index.d.ts.map +1 -0
- package/dist/legacy/message/index.js +10 -0
- package/dist/legacy/message/index.js.map +1 -0
- package/dist/legacy/node.d.ts +3 -0
- package/dist/legacy/node.d.ts.map +1 -0
- package/dist/legacy/node.js +6 -0
- package/dist/legacy/node.js.map +1 -0
- package/dist/legacy/prompt/Injection.d.ts.map +1 -0
- package/dist/legacy/prompt/Injection.js.map +1 -0
- package/dist/legacy/prompt/PromptBuilder.d.ts +284 -0
- package/dist/legacy/prompt/PromptBuilder.d.ts.map +1 -0
- package/dist/legacy/prompt/PromptBuilder.js +491 -0
- package/dist/legacy/prompt/PromptBuilder.js.map +1 -0
- package/dist/legacy/prompt/Rule.d.ts.map +1 -0
- package/dist/legacy/prompt/Rule.js.map +1 -0
- package/dist/legacy/prompt/index.d.ts +4 -0
- package/dist/legacy/prompt/index.d.ts.map +1 -0
- package/dist/legacy/prompt/index.js +10 -0
- package/dist/legacy/prompt/index.js.map +1 -0
- package/dist/legacy/provider/Provider.d.ts +48 -0
- package/dist/legacy/provider/Provider.d.ts.map +1 -0
- package/dist/legacy/provider/Provider.js +73 -0
- package/dist/legacy/provider/Provider.js.map +1 -0
- package/dist/legacy/provider/index.d.ts +2 -0
- package/dist/legacy/provider/index.d.ts.map +1 -0
- package/dist/legacy/provider/index.js +10 -0
- package/dist/legacy/provider/index.js.map +1 -0
- package/dist/legacy/session/AgentSession.d.ts +13 -0
- package/dist/legacy/session/AgentSession.d.ts.map +1 -0
- package/dist/legacy/session/AgentSession.js +3 -0
- package/dist/legacy/session/AgentSession.js.map +1 -0
- package/dist/legacy/session/Inserter.d.ts.map +1 -0
- package/dist/legacy/session/Inserter.js.map +1 -0
- package/dist/legacy/session/ListSession.d.ts +64 -0
- package/dist/legacy/session/ListSession.d.ts.map +1 -0
- package/dist/legacy/session/ListSession.js +251 -0
- package/dist/legacy/session/ListSession.js.map +1 -0
- package/dist/legacy/session/Paginator.d.ts.map +1 -0
- package/dist/legacy/session/Paginator.js.map +1 -0
- package/dist/legacy/session/Query.d.ts.map +1 -0
- package/dist/legacy/session/Query.js.map +1 -0
- package/dist/legacy/session/SearchCriteria.d.ts.map +1 -0
- package/dist/legacy/session/SearchCriteria.js.map +1 -0
- package/dist/legacy/session/Session.d.ts.map +1 -0
- package/dist/legacy/session/Session.js.map +1 -0
- package/dist/legacy/session/index.d.ts +9 -0
- package/dist/legacy/session/index.d.ts.map +1 -0
- package/dist/legacy/session/index.js +17 -0
- package/dist/legacy/session/index.js.map +1 -0
- package/dist/legacy/session/matchUtils.d.ts.map +1 -0
- package/dist/legacy/session/matchUtils.js.map +1 -0
- package/dist/legacy/stream/AnthropicStreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/AnthropicStreamParser.js.map +1 -0
- package/dist/legacy/stream/GeminiStreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/GeminiStreamParser.js.map +1 -0
- package/dist/legacy/stream/MessageStreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/MessageStreamParser.js.map +1 -0
- package/dist/legacy/stream/OpenAIResponsesStreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/OpenAIResponsesStreamParser.js.map +1 -0
- package/dist/legacy/stream/StreamEvent.d.ts.map +1 -0
- package/dist/legacy/stream/StreamEvent.js.map +1 -0
- package/dist/legacy/stream/StreamParser.d.ts.map +1 -0
- package/dist/legacy/stream/StreamParser.js.map +1 -0
- package/dist/legacy/stream/index.d.ts.map +1 -0
- package/dist/legacy/stream/index.js.map +1 -0
- package/dist/legacy/tool/Context.d.ts.map +1 -0
- package/dist/legacy/tool/Context.js.map +1 -0
- package/dist/legacy/tool/Hook.d.ts.map +1 -0
- package/dist/legacy/tool/Hook.js.map +1 -0
- package/dist/legacy/tool/McpToolAdapter.d.ts.map +1 -0
- package/dist/legacy/tool/McpToolAdapter.js.map +1 -0
- package/dist/legacy/tool/Param.d.ts.map +1 -0
- package/dist/legacy/tool/Param.js.map +1 -0
- package/dist/legacy/tool/Tool.d.ts +92 -0
- package/dist/legacy/tool/Tool.d.ts.map +1 -0
- package/dist/legacy/tool/Tool.js +198 -0
- package/dist/legacy/tool/Tool.js.map +1 -0
- package/dist/legacy/tool/ToolCall.d.ts.map +1 -0
- package/dist/legacy/tool/ToolCall.js.map +1 -0
- package/dist/legacy/tool/ToolKit.d.ts +91 -0
- package/dist/legacy/tool/ToolKit.d.ts.map +1 -0
- package/dist/legacy/tool/ToolKit.js +209 -0
- package/dist/legacy/tool/ToolKit.js.map +1 -0
- package/dist/legacy/tool/ValueType.d.ts.map +1 -0
- package/dist/legacy/tool/ValueType.js.map +1 -0
- package/dist/legacy/tool/index.d.ts +9 -0
- package/dist/legacy/tool/index.d.ts.map +1 -0
- package/dist/legacy/tool/index.js +22 -0
- package/dist/legacy/tool/index.js.map +1 -0
- package/dist/legacy/utils/generateId.d.ts.map +1 -0
- package/dist/legacy/utils/generateId.js.map +1 -0
- package/dist/legacy/utils/index.d.ts.map +1 -0
- package/dist/legacy/utils/index.js.map +1 -0
- package/dist/message/Message.d.ts +90 -135
- package/dist/message/Message.d.ts.map +1 -1
- package/dist/message/Message.js +195 -414
- package/dist/message/Message.js.map +1 -1
- package/dist/message/MessagePart.d.ts +7 -1
- package/dist/message/MessagePart.d.ts.map +1 -1
- package/dist/message/MessagePart.js +0 -3
- package/dist/message/MessagePart.js.map +1 -1
- package/dist/message/Role.d.ts.map +1 -1
- package/dist/message/Role.js.map +1 -1
- package/dist/message/index.d.ts +1 -4
- package/dist/message/index.d.ts.map +1 -1
- package/dist/message/index.js +15 -7
- package/dist/message/index.js.map +1 -1
- package/dist/node.d.ts +1 -2
- package/dist/node.d.ts.map +1 -1
- package/dist/node.js +1 -1
- package/dist/node.js.map +1 -1
- package/dist/prompt/PromptBuilder.d.ts +43 -278
- package/dist/prompt/PromptBuilder.d.ts.map +1 -1
- package/dist/prompt/PromptBuilder.js +71 -473
- package/dist/prompt/PromptBuilder.js.map +1 -1
- package/dist/prompt/index.d.ts +1 -3
- package/dist/prompt/index.d.ts.map +1 -1
- package/dist/prompt/index.js +15 -7
- package/dist/prompt/index.js.map +1 -1
- package/dist/provider/HttpProvider.d.ts +32 -0
- package/dist/provider/HttpProvider.d.ts.map +1 -0
- package/dist/provider/HttpProvider.js +160 -0
- package/dist/provider/HttpProvider.js.map +1 -0
- package/dist/provider/Provider.d.ts +125 -45
- package/dist/provider/Provider.d.ts.map +1 -1
- package/dist/provider/Provider.js +77 -58
- package/dist/provider/Provider.js.map +1 -1
- package/dist/provider/capabilities.d.ts +108 -0
- package/dist/provider/capabilities.d.ts.map +1 -0
- package/dist/provider/capabilities.js +10 -0
- package/dist/provider/capabilities.js.map +1 -0
- package/dist/provider/index.d.ts +7 -1
- package/dist/provider/index.d.ts.map +1 -1
- package/dist/provider/index.js +23 -7
- package/dist/provider/index.js.map +1 -1
- package/dist/provider/media.d.ts +9 -0
- package/dist/provider/media.d.ts.map +1 -0
- package/dist/provider/media.js +3 -0
- package/dist/provider/media.js.map +1 -0
- package/dist/provider/transport.d.ts +10 -0
- package/dist/provider/transport.d.ts.map +1 -0
- package/dist/provider/transport.js +121 -0
- package/dist/provider/transport.js.map +1 -0
- package/dist/session/AgentSession.d.ts +16 -0
- package/dist/session/AgentSession.d.ts.map +1 -0
- package/dist/session/AgentSession.js +24 -0
- package/dist/session/AgentSession.js.map +1 -0
- package/dist/session/BaseSession.d.ts +49 -0
- package/dist/session/BaseSession.d.ts.map +1 -0
- package/dist/session/BaseSession.js +147 -0
- package/dist/session/BaseSession.js.map +1 -0
- package/dist/session/ListSession.d.ts +46 -0
- package/dist/session/ListSession.d.ts.map +1 -0
- package/dist/session/ListSession.js +205 -0
- package/dist/session/ListSession.js.map +1 -0
- package/dist/session/SessionQuery.d.ts +31 -0
- package/dist/session/SessionQuery.d.ts.map +1 -0
- package/dist/session/SessionQuery.js +67 -0
- package/dist/session/SessionQuery.js.map +1 -0
- package/dist/session/TreeSession.d.ts +24 -0
- package/dist/session/TreeSession.d.ts.map +1 -0
- package/dist/session/TreeSession.js +122 -0
- package/dist/session/TreeSession.js.map +1 -0
- package/dist/session/continuation.d.ts +9 -0
- package/dist/session/continuation.d.ts.map +1 -0
- package/dist/session/continuation.js +48 -0
- package/dist/session/continuation.js.map +1 -0
- package/dist/session/index.d.ts +10 -5
- package/dist/session/index.d.ts.map +1 -1
- package/dist/session/index.js +24 -12
- package/dist/session/index.js.map +1 -1
- package/dist/session/restoreSession.d.ts +4 -0
- package/dist/session/restoreSession.d.ts.map +1 -0
- package/dist/session/restoreSession.js +12 -0
- package/dist/session/restoreSession.js.map +1 -0
- package/dist/session/structures.d.ts +32 -0
- package/dist/session/structures.d.ts.map +1 -0
- package/dist/session/structures.js +3 -0
- package/dist/session/structures.js.map +1 -0
- package/dist/session/trace.d.ts +73 -0
- package/dist/session/trace.d.ts.map +1 -0
- package/dist/session/trace.js +90 -0
- package/dist/session/trace.js.map +1 -0
- package/dist/session/types.d.ts +76 -0
- package/dist/session/types.d.ts.map +1 -0
- package/dist/session/types.js +12 -0
- package/dist/session/types.js.map +1 -0
- package/dist/tool/Tool.d.ts +26 -89
- package/dist/tool/Tool.d.ts.map +1 -1
- package/dist/tool/Tool.js +38 -185
- package/dist/tool/Tool.js.map +1 -1
- package/dist/tool/ToolExecutor.d.ts +59 -0
- package/dist/tool/ToolExecutor.d.ts.map +1 -0
- package/dist/tool/ToolExecutor.js +128 -0
- package/dist/tool/ToolExecutor.js.map +1 -0
- package/dist/tool/ToolKit.d.ts +17 -77
- package/dist/tool/ToolKit.d.ts.map +1 -1
- package/dist/tool/ToolKit.js +29 -189
- package/dist/tool/ToolKit.js.map +1 -1
- package/dist/tool/index.d.ts +4 -8
- package/dist/tool/index.d.ts.map +1 -1
- package/dist/tool/index.js +17 -19
- package/dist/tool/index.js.map +1 -1
- package/docs/API-2.x.md +1827 -0
- package/docs/API.md +248 -1698
- package/docs/CE-FEEDBACK-3.0.md +148 -0
- package/docs/CHARACTEREDITOR-3.0-NOTES.md +156 -0
- package/docs/DATA-MODEL-3.0.md +248 -0
- package/docs/DESIGN-3.0.md +326 -0
- package/docs/MIGRATION-3.0.md +77 -0
- package/docs/MULTIMEDIA-3.0.md +145 -0
- package/docs/PLAN-3.0.md +121 -0
- package/package.json +37 -26
- package/dist/adapter/AnthropicAdapter.d.ts.map +0 -1
- package/dist/adapter/AnthropicAdapter.js.map +0 -1
- package/dist/adapter/GeminiAdapter.d.ts.map +0 -1
- package/dist/adapter/GeminiAdapter.js.map +0 -1
- package/dist/adapter/MessageAdapter.d.ts.map +0 -1
- package/dist/adapter/MessageAdapter.js.map +0 -1
- package/dist/adapter/OpenAIAdapter.d.ts.map +0 -1
- package/dist/adapter/OpenAIAdapter.js.map +0 -1
- package/dist/adapter/OpenAIResponsesAdapter.d.ts.map +0 -1
- package/dist/adapter/OpenAIResponsesAdapter.js.map +0 -1
- package/dist/adapter/index.d.ts.map +0 -1
- package/dist/adapter/index.js.map +0 -1
- package/dist/client/ModelClient.d.ts.map +0 -1
- package/dist/client/ModelClient.js.map +0 -1
- package/dist/client/index.d.ts.map +0 -1
- package/dist/client/index.js.map +0 -1
- package/dist/config/RequestConfig.d.ts.map +0 -1
- package/dist/config/RequestConfig.js.map +0 -1
- package/dist/config/index.d.ts.map +0 -1
- package/dist/config/index.js.map +0 -1
- package/dist/media/BrowserMediaResolver.d.ts.map +0 -1
- package/dist/media/BrowserMediaResolver.js.map +0 -1
- package/dist/media/DefaultMediaResolver.d.ts.map +0 -1
- package/dist/media/DefaultMediaResolver.js.map +0 -1
- package/dist/media/MediaResolver.d.ts.map +0 -1
- package/dist/media/MediaResolver.js.map +0 -1
- package/dist/media/index.d.ts.map +0 -1
- package/dist/media/index.js.map +0 -1
- package/dist/message/Usage.d.ts.map +0 -1
- package/dist/message/Usage.js.map +0 -1
- package/dist/prompt/Injection.d.ts.map +0 -1
- package/dist/prompt/Injection.js.map +0 -1
- package/dist/prompt/Rule.d.ts.map +0 -1
- package/dist/prompt/Rule.js.map +0 -1
- package/dist/session/Inserter.d.ts.map +0 -1
- package/dist/session/Inserter.js.map +0 -1
- package/dist/session/Paginator.d.ts.map +0 -1
- package/dist/session/Paginator.js.map +0 -1
- package/dist/session/Query.d.ts.map +0 -1
- package/dist/session/Query.js.map +0 -1
- package/dist/session/SearchCriteria.d.ts.map +0 -1
- package/dist/session/SearchCriteria.js.map +0 -1
- package/dist/session/Session.d.ts.map +0 -1
- package/dist/session/Session.js.map +0 -1
- package/dist/session/matchUtils.d.ts.map +0 -1
- package/dist/session/matchUtils.js.map +0 -1
- package/dist/stream/AnthropicStreamParser.d.ts.map +0 -1
- package/dist/stream/AnthropicStreamParser.js.map +0 -1
- package/dist/stream/GeminiStreamParser.d.ts.map +0 -1
- package/dist/stream/GeminiStreamParser.js.map +0 -1
- package/dist/stream/MessageStreamParser.d.ts.map +0 -1
- package/dist/stream/MessageStreamParser.js.map +0 -1
- package/dist/stream/OpenAIResponsesStreamParser.d.ts.map +0 -1
- package/dist/stream/OpenAIResponsesStreamParser.js.map +0 -1
- package/dist/stream/StreamEvent.d.ts.map +0 -1
- package/dist/stream/StreamEvent.js.map +0 -1
- package/dist/stream/StreamParser.d.ts.map +0 -1
- package/dist/stream/StreamParser.js.map +0 -1
- package/dist/stream/index.d.ts.map +0 -1
- package/dist/stream/index.js.map +0 -1
- package/dist/tool/Context.d.ts.map +0 -1
- package/dist/tool/Context.js.map +0 -1
- package/dist/tool/Hook.d.ts.map +0 -1
- package/dist/tool/Hook.js.map +0 -1
- package/dist/tool/McpToolAdapter.d.ts.map +0 -1
- package/dist/tool/McpToolAdapter.js.map +0 -1
- package/dist/tool/Param.d.ts.map +0 -1
- package/dist/tool/Param.js.map +0 -1
- package/dist/tool/ToolCall.d.ts.map +0 -1
- package/dist/tool/ToolCall.js.map +0 -1
- package/dist/tool/ValueType.d.ts.map +0 -1
- package/dist/tool/ValueType.js.map +0 -1
- package/dist/utils/generateId.d.ts.map +0 -1
- package/dist/utils/generateId.js.map +0 -1
- package/dist/utils/index.d.ts.map +0 -1
- package/dist/utils/index.js.map +0 -1
- /package/dist/{adapter → legacy/adapter}/AnthropicAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/GeminiAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/MessageAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/MessageAdapter.js +0 -0
- /package/dist/{adapter → legacy/adapter}/OpenAIAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/OpenAIResponsesAdapter.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/OpenAIResponsesAdapter.js +0 -0
- /package/dist/{adapter → legacy/adapter}/index.d.ts +0 -0
- /package/dist/{adapter → legacy/adapter}/index.js +0 -0
- /package/dist/{client → legacy/client}/ModelClient.d.ts +0 -0
- /package/dist/{client → legacy/client}/ModelClient.js +0 -0
- /package/dist/{client → legacy/client}/index.d.ts +0 -0
- /package/dist/{client → legacy/client}/index.js +0 -0
- /package/dist/{config → legacy/config}/RequestConfig.d.ts +0 -0
- /package/dist/{config → legacy/config}/RequestConfig.js +0 -0
- /package/dist/{config → legacy/config}/index.d.ts +0 -0
- /package/dist/{config → legacy/config}/index.js +0 -0
- /package/dist/{media → legacy/media}/BrowserMediaResolver.d.ts +0 -0
- /package/dist/{media → legacy/media}/BrowserMediaResolver.js +0 -0
- /package/dist/{media → legacy/media}/DefaultMediaResolver.d.ts +0 -0
- /package/dist/{media → legacy/media}/DefaultMediaResolver.js +0 -0
- /package/dist/{media → legacy/media}/MediaResolver.d.ts +0 -0
- /package/dist/{media → legacy/media}/MediaResolver.js +0 -0
- /package/dist/{media → legacy/media}/index.d.ts +0 -0
- /package/dist/{media → legacy/media}/index.js +0 -0
- /package/dist/{message → legacy/message}/Usage.d.ts +0 -0
- /package/dist/{message → legacy/message}/Usage.js +0 -0
- /package/dist/{prompt → legacy/prompt}/Injection.d.ts +0 -0
- /package/dist/{prompt → legacy/prompt}/Injection.js +0 -0
- /package/dist/{prompt → legacy/prompt}/Rule.d.ts +0 -0
- /package/dist/{prompt → legacy/prompt}/Rule.js +0 -0
- /package/dist/{session → legacy/session}/Inserter.d.ts +0 -0
- /package/dist/{session → legacy/session}/Inserter.js +0 -0
- /package/dist/{session → legacy/session}/Paginator.d.ts +0 -0
- /package/dist/{session → legacy/session}/Paginator.js +0 -0
- /package/dist/{session → legacy/session}/Query.d.ts +0 -0
- /package/dist/{session → legacy/session}/Query.js +0 -0
- /package/dist/{session → legacy/session}/SearchCriteria.d.ts +0 -0
- /package/dist/{session → legacy/session}/SearchCriteria.js +0 -0
- /package/dist/{session → legacy/session}/Session.d.ts +0 -0
- /package/dist/{session → legacy/session}/Session.js +0 -0
- /package/dist/{session → legacy/session}/matchUtils.d.ts +0 -0
- /package/dist/{session → legacy/session}/matchUtils.js +0 -0
- /package/dist/{stream → legacy/stream}/AnthropicStreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/AnthropicStreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/GeminiStreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/GeminiStreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/MessageStreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/MessageStreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/OpenAIResponsesStreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/OpenAIResponsesStreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/StreamEvent.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/StreamEvent.js +0 -0
- /package/dist/{stream → legacy/stream}/StreamParser.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/StreamParser.js +0 -0
- /package/dist/{stream → legacy/stream}/index.d.ts +0 -0
- /package/dist/{stream → legacy/stream}/index.js +0 -0
- /package/dist/{tool → legacy/tool}/Context.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/Context.js +0 -0
- /package/dist/{tool → legacy/tool}/Hook.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/Hook.js +0 -0
- /package/dist/{tool → legacy/tool}/McpToolAdapter.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/McpToolAdapter.js +0 -0
- /package/dist/{tool → legacy/tool}/Param.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/Param.js +0 -0
- /package/dist/{tool → legacy/tool}/ToolCall.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/ToolCall.js +0 -0
- /package/dist/{tool → legacy/tool}/ValueType.d.ts +0 -0
- /package/dist/{tool → legacy/tool}/ValueType.js +0 -0
- /package/dist/{utils → legacy/utils}/generateId.d.ts +0 -0
- /package/dist/{utils → legacy/utils}/generateId.js +0 -0
- /package/dist/{utils → legacy/utils}/index.d.ts +0 -0
- /package/dist/{utils → legacy/utils}/index.js +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,22 +1,63 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
##
|
|
3
|
+
## 3.0.0 - 2026-10-26
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
- CE feedback: business Message metadata/tags and Session metadata can change during runs without invalidating request leases; content and protocol edits still conflict. Custom request metadata keys persist alongside separate request revisions.
|
|
6
|
+
- Continuation temporary messages now enter PromptBuilder before transforms, with tags/source labels and matching continuation previews. Default merges retain business metadata/tags; awaited beforeAppend hooks edit detached merged targets without overwriting unrelated concurrent annotations.
|
|
7
|
+
- Tool-related continuation thinking is stored once with its native signatures; independent thinking blocks remain available for display.
|
|
8
|
+
- Version 3 session structures are publicly typed. Flat tree imports preserve external message/node IDs, explicit root/sibling order and selection.
|
|
9
|
+
- Prompt transforms can return messages with source descriptors while retaining Message[] compatibility. Transport requests include explicit stream and purpose; Generator/Agent thinking defaults accept per-call overrides.
|
|
10
|
+
- Added EmbeddingProvider capability contract for inheritable custom providers; no built-in vendor embedding protocol yet. Added 16 CE feedback regression cases and documented the integration contract in docs/CE-FEEDBACK-3.0.md.
|
|
11
|
+
- Provider is now an inheritable HTTP base; ChatProvider remains a structural chat capability. Separate ImageProvider, AudioProvider and VideoProvider contracts support media outputs without requiring chat.
|
|
12
|
+
- Shared subclass hooks handle authentication, JSON/multipart/binary requests, GET task queries, SSE and bounded binary reading. Video submission/query/optional remote cancellation are distinct operations.
|
|
13
|
+
- VideoPart and Message.addVideo support video persistence in all session types; chat subclasses can extend serializeMessages, while unsupported built-in video input fails explicitly.
|
|
6
14
|
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
-
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
15
|
+
- New independent editable Message model with content-block IDs, revisions and flat serialization.
|
|
16
|
+
- TreeSession, sequence/turn ListSession, and interaction-based AgentSession share querying and Turn/Run/Step/tool execution records.
|
|
17
|
+
- SDK-free HTTP providers for OpenAI compatible, OpenAI Responses, Anthropic and Gemini, with injectable transport/media and SSE cancellation.
|
|
18
|
+
- Generator performs a single model request; Agent orchestrates chat/run/continue/resume and contextual tool loops.
|
|
19
|
+
- Standalone ToolExecutor validates JSON Schema and handles authorization, manual approval, timeout and cancellation; tool availability is dynamic.
|
|
20
|
+
- Independent async PromptBuilder provides detached contexts, source tracking and non-consuming previews.
|
|
21
|
+
- Awaited commit hooks, continuation merging, generation contribution/usage tracking, partial progress retention and session edit conflict detection.
|
|
22
|
+
- Breaking: root/subpath APIs and session storage format are 3.0. The 2.x implementation remains available through explicit `/legacy` imports; existing demos use this compatibility entry.
|
|
23
|
+
- Vendor SDKs are no longer runtime/peer dependencies; Ajv provides tool validation. Browser and explicit Node media entries remain separate.
|
|
24
|
+
- See docs/API.md and docs/MIGRATION-3.0.md. CharacterEditor and live model integration are not migrated by this release work.
|
|
25
|
+
|
|
26
|
+
## 2.2.0 - 2026-09-07
|
|
27
|
+
|
|
28
|
+
### Added
|
|
29
|
+
|
|
30
|
+
- `ListSession`: a linear alternative-list conversation model alongside the tree-based `Session`. Each row holds multiple candidates, and one tool loop's full message trace belongs to a single candidate.
|
|
31
|
+
- `AgentSession` interface describing the conversation operations `Agent` needs, so custom session models can drive the Agent loop.
|
|
32
|
+
- Optional `beginGeneration()` / `endGeneration()` session lifecycle hooks, called by `Agent` around a run so a session can group a whole tool loop into one candidate.
|
|
33
|
+
- `ListSession` selection and history APIs: `select()`, `addCandidate()`, `removeCandidate()`, `regenerate()`, `cancelRegeneration()`, `truncateAfter()`, `acceptHistory()`, plus `rows`, `alternatives` and `staleRowIds`.
|
|
34
|
+
- `ListSession.toJSON()` / `ListSession.fromJSON()` preserving every candidate, trace and selection, with strict validation on restore.
|
|
35
|
+
|
|
36
|
+
### Changed
|
|
37
|
+
|
|
38
|
+
- `Agent` is now generic over its session type (`Agent<S extends AgentSession = Session>`); `agent.session` keeps the concrete type that was passed in.
|
|
39
|
+
|
|
40
|
+
### Compatibility
|
|
41
|
+
|
|
42
|
+
- Fully backward compatible. `Agent` defaults to `Session`, so existing code keeps tree-specific APIs such as `agent.session.root` without changes.
|
|
43
|
+
|
|
44
|
+
## 2.1.0 - 2026-06-19
|
|
45
|
+
|
|
46
|
+
### Added
|
|
47
|
+
|
|
48
|
+
- `Message.isEmpty` and `Message.pruneEmpty()` for shared empty-message handling.
|
|
49
|
+
- `PromptBuilder` support for using empty messages as anchors while dropping them from the final context by default.
|
|
50
|
+
- `dropEmptyMessages: false` build option for debugging or custom context pipelines that need to retain empty messages.
|
|
51
|
+
|
|
52
|
+
### Changed
|
|
53
|
+
|
|
54
|
+
- `Message.getHistory(true)` now preserves an empty system root instead of silently omitting it.
|
|
55
|
+
- `Agent` prunes empty messages at the model request boundary, including `runRaw()`, so incompatible providers do not receive empty messages.
|
|
56
|
+
- API documentation now describes empty-root history behavior and PromptBuilder empty-message cleanup.
|
|
57
|
+
|
|
58
|
+
## 2.0.0 - 2026-06-11
|
|
59
|
+
|
|
60
|
+
### Added
|
|
20
61
|
|
|
21
62
|
- `agent.generate()` for generating from the current Session without appending a User message.
|
|
22
63
|
- Awaitable `BEFORE_ASSISTANT_COMMIT` lifecycle handlers before Session persistence.
|
package/README.md
CHANGED
|
@@ -1,434 +1,97 @@
|
|
|
1
|
-
# AgentEngine
|
|
2
|
-
|
|
3
|
-
AgentEngine
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
```
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
const
|
|
28
|
-
console.log(
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
npm
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
# MCP 集成,可选
|
|
100
|
-
npm install @modelcontextprotocol/sdk
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
环境要求:
|
|
104
|
-
|
|
105
|
-
- Node.js >= 18
|
|
106
|
-
- TypeScript 项目推荐开启 `strict`
|
|
107
|
-
|
|
108
|
-
根入口可直接用于浏览器和 WebView。Node.js 中需要读取本地媒体文件时:
|
|
109
|
-
|
|
110
|
-
```ts
|
|
111
|
-
import { DefaultMediaResolver } from "@notic/agent-engine/node";
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
## 快速开始
|
|
115
|
-
|
|
116
|
-
### 1. 创建 Agent
|
|
117
|
-
|
|
118
|
-
```ts
|
|
119
|
-
import OpenAI from "openai";
|
|
120
|
-
import { Agent, RequestConfig, Session } from "@notic/agent-engine";
|
|
121
|
-
|
|
122
|
-
const client = new OpenAI({
|
|
123
|
-
apiKey: process.env.OPENAI_API_KEY,
|
|
124
|
-
baseURL: "https://api.openai.com/v1",
|
|
125
|
-
});
|
|
126
|
-
|
|
127
|
-
const agent = new Agent({
|
|
128
|
-
client,
|
|
129
|
-
model: "gpt-4o-mini",
|
|
130
|
-
session: Session.create("你是一个友好的中文助手。"),
|
|
131
|
-
config: RequestConfig.create().temperature(0.3).maxTokens(1024),
|
|
132
|
-
});
|
|
133
|
-
```
|
|
134
|
-
|
|
135
|
-
OpenAI-compatible 平台只需要替换 `baseURL` 和 `model`:
|
|
136
|
-
|
|
137
|
-
```ts
|
|
138
|
-
const client = new OpenAI({
|
|
139
|
-
apiKey: process.env.DEEPSEEK_API_KEY,
|
|
140
|
-
baseURL: "https://api.deepseek.com",
|
|
141
|
-
});
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
### 2. 监听流式输出
|
|
145
|
-
|
|
146
|
-
```ts
|
|
147
|
-
import { StreamEventType } from "@notic/agent-engine";
|
|
148
|
-
|
|
149
|
-
agent.on(StreamEventType.TEXT_DELTA, (event) => {
|
|
150
|
-
process.stdout.write(event.delta);
|
|
151
|
-
});
|
|
152
|
-
|
|
153
|
-
agent.on(StreamEventType.TOOL_EXECUTE_START, (event) => {
|
|
154
|
-
console.log("tool:", event.name);
|
|
155
|
-
});
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
### 3. 运行一轮对话
|
|
159
|
-
|
|
160
|
-
```ts
|
|
161
|
-
const reply = await agent.run("帮我写一个 npm 包介绍。");
|
|
162
|
-
console.log(reply.text);
|
|
163
|
-
```
|
|
164
|
-
|
|
165
|
-
`Agent` 会自动把用户消息和助手回复写入 `Session`。
|
|
166
|
-
|
|
167
|
-
## Provider
|
|
168
|
-
|
|
169
|
-
Provider 只负责组合三块可替换能力:
|
|
170
|
-
|
|
171
|
-
- `ModelClient`:发送平台请求,返回流或完整响应。
|
|
172
|
-
- `MessageAdapter`:在统一 `Message` 与平台 JSON 之间转换。
|
|
173
|
-
- `MessageStreamParser`:把平台流事件转换成统一事件和 `Message`。
|
|
174
|
-
|
|
175
|
-
Agent 不需要知道当前使用哪一家模型平台。
|
|
176
|
-
|
|
177
|
-
### OpenAI Compatible
|
|
178
|
-
|
|
179
|
-
适用于 OpenAI Chat Completions,以及 DeepSeek、Qwen、Kimi、GLM 等兼容平台:
|
|
180
|
-
|
|
181
|
-
```ts
|
|
182
|
-
import OpenAI from "openai";
|
|
183
|
-
import {
|
|
184
|
-
Agent,
|
|
185
|
-
OpenAICompatibleProvider,
|
|
186
|
-
Session,
|
|
187
|
-
} from "@notic/agent-engine";
|
|
188
|
-
|
|
189
|
-
const client = new OpenAI({
|
|
190
|
-
apiKey: process.env.DEEPSEEK_API_KEY,
|
|
191
|
-
baseURL: "https://api.deepseek.com",
|
|
192
|
-
});
|
|
193
|
-
|
|
194
|
-
const agent = new Agent({
|
|
195
|
-
provider: new OpenAICompatibleProvider(client),
|
|
196
|
-
model: "deepseek-chat",
|
|
197
|
-
session: Session.create(),
|
|
198
|
-
});
|
|
199
|
-
```
|
|
200
|
-
|
|
201
|
-
### OpenAI Responses API
|
|
202
|
-
|
|
203
|
-
```ts
|
|
204
|
-
import OpenAI from "openai";
|
|
205
|
-
import { Agent, OpenAIResponsesProvider, Session } from "@notic/agent-engine";
|
|
206
|
-
|
|
207
|
-
const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
|
|
208
|
-
const agent = new Agent({
|
|
209
|
-
provider: new OpenAIResponsesProvider(client),
|
|
210
|
-
model: "your-openai-model",
|
|
211
|
-
session: Session.create(),
|
|
212
|
-
});
|
|
213
|
-
```
|
|
214
|
-
|
|
215
|
-
Responses Provider 会保留 reasoning item、加密推理状态和 function call item,供下一轮工具调用继续使用。
|
|
216
|
-
|
|
217
|
-
### Anthropic
|
|
218
|
-
|
|
219
|
-
```ts
|
|
220
|
-
import Anthropic from "@anthropic-ai/sdk";
|
|
221
|
-
import { Agent, AnthropicProvider, Session } from "@notic/agent-engine";
|
|
222
|
-
|
|
223
|
-
const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
|
|
224
|
-
const agent = new Agent({
|
|
225
|
-
provider: new AnthropicProvider(client),
|
|
226
|
-
model: "your-claude-model",
|
|
227
|
-
session: Session.create(),
|
|
228
|
-
});
|
|
229
|
-
```
|
|
230
|
-
|
|
231
|
-
### Gemini
|
|
232
|
-
|
|
233
|
-
```ts
|
|
234
|
-
import { GoogleGenAI } from "@google/genai";
|
|
235
|
-
import { Agent, GeminiProvider, Session } from "@notic/agent-engine";
|
|
236
|
-
|
|
237
|
-
const client = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
|
|
238
|
-
const agent = new Agent({
|
|
239
|
-
provider: new GeminiProvider(client),
|
|
240
|
-
model: "your-gemini-model",
|
|
241
|
-
session: Session.create(),
|
|
242
|
-
});
|
|
243
|
-
```
|
|
244
|
-
|
|
245
|
-
所有内置 Provider 都支持:
|
|
246
|
-
|
|
247
|
-
```ts
|
|
248
|
-
await agent.run("增量输出");
|
|
249
|
-
await agent.run("完整响应", { stream: false });
|
|
250
|
-
```
|
|
251
|
-
|
|
252
|
-
## 工具调用示例
|
|
253
|
-
|
|
254
|
-
```ts
|
|
255
|
-
import { Agent, Param, Session, Tool, ToolKit } from "@notic/agent-engine";
|
|
256
|
-
|
|
257
|
-
const getWeather = Tool.create(async (args) => {
|
|
258
|
-
return {
|
|
259
|
-
city: args.city,
|
|
260
|
-
temperature: 21,
|
|
261
|
-
unit: "celsius",
|
|
262
|
-
};
|
|
263
|
-
})
|
|
264
|
-
.name("get_weather")
|
|
265
|
-
.description("查询城市天气")
|
|
266
|
-
.params(
|
|
267
|
-
Param.string("city").desc("城市名称").required()
|
|
268
|
-
)
|
|
269
|
-
.build();
|
|
270
|
-
|
|
271
|
-
const toolkit = new ToolKit().add(getWeather);
|
|
272
|
-
|
|
273
|
-
const agent = new Agent({
|
|
274
|
-
client,
|
|
275
|
-
model: "your-model",
|
|
276
|
-
session: Session.create("需要外部信息时可以调用工具。"),
|
|
277
|
-
toolkit,
|
|
278
|
-
});
|
|
279
|
-
|
|
280
|
-
const reply = await agent.run("北京今天适合跑步吗?");
|
|
281
|
-
console.log(reply.text);
|
|
282
|
-
```
|
|
283
|
-
|
|
284
|
-
当模型发起工具调用时,AgentEngine 会自动执行工具、把结果写回会话,并再次请求模型生成最终答案。
|
|
285
|
-
|
|
286
|
-
## 模块地图
|
|
287
|
-
|
|
288
|
-
```text
|
|
289
|
-
AgentEngine
|
|
290
|
-
├─ Message 统一消息模型:文本、多模态、工具调用、树节点
|
|
291
|
-
├─ Session 会话树:历史、分支、查询、插入、分页
|
|
292
|
-
├─ Tool 工具系统:Param、Tool、ToolKit、Hook、MCP
|
|
293
|
-
├─ Stream 流式解析:chunk -> 结构化事件 -> Message
|
|
294
|
-
├─ Prompt 提示词构建:Rule、Injection、数组操作管线
|
|
295
|
-
├─ Config 请求参数:预设、链式配置、三层优先级
|
|
296
|
-
├─ Client 传输边界:流式请求、完整响应、中断信号
|
|
297
|
-
├─ Adapter 消息转换:OpenAI、Responses、Anthropic、Gemini
|
|
298
|
-
├─ Provider Client + Adapter + Parser 的低耦合组合
|
|
299
|
-
├─ Media 媒体解析:浏览器默认实现 + Node 本地文件子入口
|
|
300
|
-
└─ Agent 编排层:自动循环、审批、中断、恢复
|
|
301
|
-
```
|
|
302
|
-
|
|
303
|
-
### Message
|
|
304
|
-
|
|
305
|
-
统一消息对象,支持:
|
|
306
|
-
|
|
307
|
-
- `Message.user()` / `Message.assistant()` / `Message.system()`
|
|
308
|
-
- 文本、图片、音频、文件
|
|
309
|
-
- 工具调用和工具结果
|
|
310
|
-
- thinking 内容
|
|
311
|
-
- 标签、元数据和树结构
|
|
312
|
-
- `setText()` / `setParts()` 安全替换内容并自动失效缓存
|
|
313
|
-
|
|
314
|
-
### Session
|
|
315
|
-
|
|
316
|
-
会话管理器,负责:
|
|
317
|
-
|
|
318
|
-
- root -> cursor 的当前历史路径
|
|
319
|
-
- 对话分支和回退
|
|
320
|
-
- 查询当前分支或全树
|
|
321
|
-
- 在历史中插入消息
|
|
322
|
-
- 在兄弟分支间分页切换
|
|
323
|
-
|
|
324
|
-
### Tool
|
|
325
|
-
|
|
326
|
-
工具系统,负责:
|
|
327
|
-
|
|
328
|
-
- 用 `Param` 定义参数 schema
|
|
329
|
-
- 用 `Tool` 包装 TypeScript 函数
|
|
330
|
-
- 用 `ToolKit` 注册并执行多个工具
|
|
331
|
-
- 用 Hook 处理校验、取消、结果改写和错误降级
|
|
332
|
-
|
|
333
|
-
### Stream
|
|
334
|
-
|
|
335
|
-
流式解析器,负责:
|
|
336
|
-
|
|
337
|
-
- 文本增量
|
|
338
|
-
- thinking / reasoning 增量
|
|
339
|
-
- 工具调用增量
|
|
340
|
-
- usage
|
|
341
|
-
- 最终 `Message` 组装
|
|
342
|
-
|
|
343
|
-
### Prompt
|
|
344
|
-
|
|
345
|
-
提示词构建器,负责:
|
|
346
|
-
|
|
347
|
-
- 按角色、标签、内容或自定义规则定位消息
|
|
348
|
-
- 动态注入 system/user/assistant 消息
|
|
349
|
-
- 控制注入生命周期、概率和优先级
|
|
350
|
-
- 在发送模型前过滤、裁剪或转换上下文
|
|
351
|
-
|
|
352
|
-
### Config
|
|
353
|
-
|
|
354
|
-
请求参数配置器,负责:
|
|
355
|
-
|
|
356
|
-
- temperature / top_p / top_k
|
|
357
|
-
- max_tokens
|
|
358
|
-
- stop
|
|
359
|
-
- seed
|
|
360
|
-
- response_format
|
|
361
|
-
- 自定义平台参数
|
|
362
|
-
|
|
363
|
-
### Adapter
|
|
364
|
-
|
|
365
|
-
平台适配器,负责:
|
|
366
|
-
|
|
367
|
-
- 把 AgentEngine 的 `Message[]` 序列化成平台请求格式
|
|
368
|
-
- 处理多模态内容
|
|
369
|
-
- 处理工具调用和工具结果
|
|
370
|
-
- 控制 thinking 内容如何回传
|
|
371
|
-
|
|
372
|
-
### Provider
|
|
373
|
-
|
|
374
|
-
Provider 提供平台预设,但不接管 Agent 执行流程:
|
|
375
|
-
|
|
376
|
-
- `OpenAICompatibleProvider`
|
|
377
|
-
- `OpenAIResponsesProvider`
|
|
378
|
-
- `AnthropicProvider`
|
|
379
|
-
- `GeminiProvider`
|
|
380
|
-
- `Provider.create()` 自定义组合
|
|
381
|
-
|
|
382
|
-
通过 `provider.supportsComplete` 可以检查是否支持非流式完整响应。
|
|
383
|
-
|
|
384
|
-
### Agent
|
|
385
|
-
|
|
386
|
-
智能体编排层,负责:
|
|
387
|
-
|
|
388
|
-
- 管理 `Session`
|
|
389
|
-
- 调用模型 stream
|
|
390
|
-
- 派发事件
|
|
391
|
-
- 在 Assistant 提交 Session 前等待生命周期转换
|
|
392
|
-
- 执行工具循环
|
|
393
|
-
- 处理工具审批
|
|
394
|
-
- 中断、超时、恢复和继续
|
|
395
|
-
|
|
396
|
-
## 文档
|
|
397
|
-
|
|
398
|
-
完整教程式 API 文档见:
|
|
399
|
-
|
|
400
|
-
- [docs/API.md](./docs/API.md)
|
|
401
|
-
- [CHANGELOG.md](./CHANGELOG.md)
|
|
402
|
-
|
|
403
|
-
建议阅读顺序:
|
|
404
|
-
|
|
405
|
-
1. 安装与最小示例
|
|
406
|
-
2. Agent:智能体编排
|
|
407
|
-
3. Tool:工具系统
|
|
408
|
-
4. Prompt:提示词构建
|
|
409
|
-
5. Session:会话树
|
|
410
|
-
6. Adapter / Media:平台与多模态适配
|
|
411
|
-
|
|
412
|
-
## 测试
|
|
413
|
-
|
|
414
|
-
项目使用 Node.js 内置测试运行器。
|
|
415
|
-
|
|
416
|
-
```bash
|
|
417
|
-
npm test
|
|
418
|
-
```
|
|
419
|
-
|
|
420
|
-
真实 API 测试需要显式开启,避免普通测试误触发外部请求:
|
|
421
|
-
|
|
422
|
-
```bash
|
|
423
|
-
RUN_REAL_DEEPSEEK_TESTS=1 DEEPSEEK_API_KEY=sk-... npm run test:real:deepseek
|
|
424
|
-
```
|
|
425
|
-
|
|
426
|
-
## 构建
|
|
427
|
-
|
|
428
|
-
```bash
|
|
429
|
-
npm run build
|
|
430
|
-
```
|
|
431
|
-
|
|
432
|
-
## License
|
|
433
|
-
|
|
434
|
-
Apache-2.0
|
|
1
|
+
# AgentEngine 3.0
|
|
2
|
+
|
|
3
|
+
AgentEngine 是一个模块化的 TypeScript Agent 框架。Message 负责内容,Session 负责组织,PromptBuilder 负责临时上下文,Generator 负责一次模型请求,ToolExecutor 负责审批与执行,Agent 负责持续的工具循环和会话维护。
|
|
4
|
+
|
|
5
|
+
3.0 根入口使用新的 API。原 2.x 实现保留在 `@notic/agent-engine/legacy`,详见 [迁移说明](./docs/MIGRATION-3.0.md)。
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
npm install @notic/agent-engine@^3.0.0
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
```ts
|
|
12
|
+
import { Agent, AgentSession, OpenAIProvider, PromptBuilder } from "@notic/agent-engine";
|
|
13
|
+
|
|
14
|
+
const session = AgentSession.create({ systemPrompt: "你是一个简洁可靠的助手。" });
|
|
15
|
+
const promptBuilder = new PromptBuilder();
|
|
16
|
+
const agent = new Agent({
|
|
17
|
+
provider: new OpenAIProvider({ apiKey: process.env.OPENAI_API_KEY }),
|
|
18
|
+
model: "your-model",
|
|
19
|
+
session,
|
|
20
|
+
promptBuilder,
|
|
21
|
+
generation: { temperature: 0.5, maxOutputTokens: 2048 },
|
|
22
|
+
execution: { maxSteps: 10 },
|
|
23
|
+
});
|
|
24
|
+
agent.on("textDelta", event => {
|
|
25
|
+
if (event.type === "textDelta") process.stdout.write(event.delta);
|
|
26
|
+
});
|
|
27
|
+
const result = await agent.chat("介绍一下 AgentEngine。");
|
|
28
|
+
console.log(result.message?.text, result.usage);
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## 独立模块
|
|
32
|
+
|
|
33
|
+
| 模块 | 用途 |
|
|
34
|
+
| --- | --- |
|
|
35
|
+
| Message | 编辑文本、思考、媒体和工具内容块;稳定 ID、版本与变更通知 |
|
|
36
|
+
| TreeSession | 树结构会话、分支选择、剪枝与嫁接 |
|
|
37
|
+
| ListSession | 候选消息序列,默认 sequence,可选 turn |
|
|
38
|
+
| AgentSession | 一次用户交互作为一轮,轮内包含多个模型和工具步骤 |
|
|
39
|
+
| PromptBuilder | 临时注入、异步转换、来源追踪、不消耗寿命的预览 |
|
|
40
|
+
| Provider / 能力接口 | 可继承 HTTP 基类,聊天、图片、音频、视频、向量能力独立扩展 |
|
|
41
|
+
| Generator | 单次模型调用;不写 Session,不执行工具 |
|
|
42
|
+
| ToolKit / ToolExecutor | JSON Schema 校验、动态工具、授权、人工审批、取消与超时 |
|
|
43
|
+
| Agent | chat、run、continue、resume、步骤预算、提交与执行记录 |
|
|
44
|
+
|
|
45
|
+
三种 Session 都保存 Turn、Run、Step、工具执行及消息生成贡献,可以按轮次和执行查询;导出使用平坦的版本化结构。
|
|
46
|
+
|
|
47
|
+
Agent 使用传入的 Session 和 PromptBuilder。未提供 Session 时必须指定 `mode: "tree" | "list" | "agent"`;未提供 PromptBuilder 时创建默认实例,均可从 Agent 获取。
|
|
48
|
+
|
|
49
|
+
## 单次生成
|
|
50
|
+
|
|
51
|
+
```ts
|
|
52
|
+
import { Generator, Message, AnthropicProvider } from "@notic/agent-engine";
|
|
53
|
+
|
|
54
|
+
const generator = new Generator({
|
|
55
|
+
provider: new AnthropicProvider({ apiKey: "your-key" }),
|
|
56
|
+
model: "your-model",
|
|
57
|
+
});
|
|
58
|
+
const response = await generator.generate({
|
|
59
|
+
messages: [Message.user("分析这段内容")],
|
|
60
|
+
stream: false,
|
|
61
|
+
});
|
|
62
|
+
console.log(response.message.text);
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
自主维护上下文、执行工具的业务使用 Agent。已准备好 Session 时调用 `agent.run()`;开始新交互调用 `agent.chat(input)`。
|
|
66
|
+
|
|
67
|
+
## 平台与业务扩展
|
|
68
|
+
|
|
69
|
+
提供 OpenAIProvider(Chat Completions / OpenAI compatible)、OpenAIResponsesProvider、AnthropicProvider 和 GeminiProvider。运行时无需安装厂商 SDK,默认使用标准 fetch、Response 和 Web Streams;支持自定义地址、传输与附件解析器。工具校验依赖 Ajv。
|
|
70
|
+
|
|
71
|
+
框架复用经过验证的内部协议转换与解析代码,2.x 兼容层独立保留。浏览器入口不包含 Node builtin;本地文件附件解析器从 `@notic/agent-engine/node` 导入。
|
|
72
|
+
|
|
73
|
+
业务可以继承 Provider 或现有厂商 Provider,实现 ImageProvider、AudioProvider、VideoProvider,复用鉴权、传输、SSE、二进制和附件解析。视频任务提交与查询分开,便于恢复已有任务。Message 支持视频内容块;内置聊天 codec 暂不编码视频输入,可覆盖 serializeMessages 扩展。媒体接口由子类实现,详见 [多媒体扩展](./docs/MULTIMEDIA-3.0.md)。
|
|
74
|
+
|
|
75
|
+
消息的显示、保存和发送可以分别处理:流式事件用于即时显示,beforeCommit 用于修改保存内容,PromptBuilder 用于改变请求上下文。续写保留原消息身份并追加内容,临时续写指令不进入 Session。
|
|
76
|
+
|
|
77
|
+
运行中可以更新 Message 的业务 metadata/tags 或 Session.metadata;内容、协议元数据与结构编辑仍检测冲突。续写临时消息进入 PromptBuilder,previewContext 支持续写参数,beforeAppend 可编辑默认合并后的目标草稿。编译器可返回消息和来源标签;旧会话可直接映射公开的平坦结构导入,保留业务 ID 与兄弟顺序。具体行为见 [CE 反馈落实与接入契约](./docs/CE-FEEDBACK-3.0.md)。
|
|
78
|
+
|
|
79
|
+
## 文档与验证
|
|
80
|
+
|
|
81
|
+
- [3.0 API 与使用示例](./docs/API.md)
|
|
82
|
+
- [Provider 继承与多媒体](./docs/MULTIMEDIA-3.0.md)
|
|
83
|
+
- [CE 反馈落实与接入契约](./docs/CE-FEEDBACK-3.0.md)
|
|
84
|
+
- [2.x → 3.0 迁移](./docs/MIGRATION-3.0.md)
|
|
85
|
+
- [实施状态与设计基线](./docs/PLAN-3.0.md)
|
|
86
|
+
- [设计讨论记录](./docs/DESIGN-3.0.md)
|
|
87
|
+
- [数据模型设计](./docs/DATA-MODEL-3.0.md)
|
|
88
|
+
- [CharacterEditor 业务分析](./docs/CHARACTEREDITOR-3.0-NOTES.md)
|
|
89
|
+
- [2.x 历史 API](./docs/API-2.x.md)
|
|
90
|
+
|
|
91
|
+
```sh
|
|
92
|
+
npm install
|
|
93
|
+
npm test
|
|
94
|
+
npm run build
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
测试覆盖新 API、旧版兼容层、合成 HTTP/SSE、深树导入导出、审批、取消、续写、恢复及冲突;同时检查浏览器构建、无 Buffer 的附件处理和包导出。默认不调用真实模型。demo/battle 和 demo/editor 暂时使用 legacy 入口。
|