@zhin.js/agent 0.1.29 → 0.1.31
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/README.md +48 -23
- package/lib/agent-prompt/resolver.d.ts.map +1 -1
- package/lib/agent-prompt/resolver.js +0 -1
- package/lib/agent-prompt/resolver.js.map +1 -1
- package/lib/assistant/config.d.ts +67 -0
- package/lib/assistant/config.d.ts.map +1 -0
- package/lib/assistant/config.js +47 -0
- package/lib/assistant/config.js.map +1 -0
- package/lib/assistant/domains/home-assistant.d.ts +37 -0
- package/lib/assistant/domains/home-assistant.d.ts.map +1 -0
- package/lib/assistant/domains/home-assistant.js +113 -0
- package/lib/assistant/domains/home-assistant.js.map +1 -0
- package/lib/assistant/event-ingress.d.ts +28 -0
- package/lib/assistant/event-ingress.d.ts.map +1 -0
- package/lib/assistant/event-ingress.js +132 -0
- package/lib/assistant/event-ingress.js.map +1 -0
- package/lib/assistant/event-types.d.ts +28 -0
- package/lib/assistant/event-types.d.ts.map +1 -0
- package/lib/assistant/event-types.js +2 -0
- package/lib/assistant/event-types.js.map +1 -0
- package/lib/assistant/home-config.d.ts +36 -0
- package/lib/assistant/home-config.d.ts.map +1 -0
- package/lib/assistant/home-config.js +21 -0
- package/lib/assistant/home-config.js.map +1 -0
- package/lib/assistant/home-mcp-bridge.d.ts +12 -0
- package/lib/assistant/home-mcp-bridge.d.ts.map +1 -0
- package/lib/assistant/home-mcp-bridge.js +26 -0
- package/lib/assistant/home-mcp-bridge.js.map +1 -0
- package/lib/assistant/home-policy.d.ts +16 -0
- package/lib/assistant/home-policy.d.ts.map +1 -0
- package/lib/assistant/home-policy.js +46 -0
- package/lib/assistant/home-policy.js.map +1 -0
- package/lib/assistant/home-tools.d.ts +15 -0
- package/lib/assistant/home-tools.d.ts.map +1 -0
- package/lib/assistant/home-tools.js +141 -0
- package/lib/assistant/home-tools.js.map +1 -0
- package/lib/assistant/index.d.ts +31 -0
- package/lib/assistant/index.d.ts.map +1 -0
- package/lib/assistant/index.js +18 -0
- package/lib/assistant/index.js.map +1 -0
- package/lib/assistant/job-engine.d.ts +40 -0
- package/lib/assistant/job-engine.d.ts.map +1 -0
- package/lib/assistant/job-engine.js +155 -0
- package/lib/assistant/job-engine.js.map +1 -0
- package/lib/assistant/job-scheduler.d.ts +6 -0
- package/lib/assistant/job-scheduler.d.ts.map +1 -0
- package/lib/assistant/job-scheduler.js +59 -0
- package/lib/assistant/job-scheduler.js.map +1 -0
- package/lib/assistant/job-store.d.ts +55 -0
- package/lib/assistant/job-store.d.ts.map +1 -0
- package/lib/assistant/job-store.js +280 -0
- package/lib/assistant/job-store.js.map +1 -0
- package/lib/assistant/job-worker.d.ts +20 -0
- package/lib/assistant/job-worker.d.ts.map +1 -0
- package/lib/assistant/job-worker.js +73 -0
- package/lib/assistant/job-worker.js.map +1 -0
- package/lib/assistant/legacy-convert.d.ts +48 -0
- package/lib/assistant/legacy-convert.d.ts.map +1 -0
- package/lib/assistant/legacy-convert.js +108 -0
- package/lib/assistant/legacy-convert.js.map +1 -0
- package/lib/assistant/notification-router.d.ts +34 -0
- package/lib/assistant/notification-router.d.ts.map +1 -0
- package/lib/assistant/notification-router.js +96 -0
- package/lib/assistant/notification-router.js.map +1 -0
- package/lib/assistant/profile-loader.d.ts +29 -0
- package/lib/assistant/profile-loader.d.ts.map +1 -0
- package/lib/assistant/profile-loader.js +168 -0
- package/lib/assistant/profile-loader.js.map +1 -0
- package/lib/assistant/profile-types.d.ts +56 -0
- package/lib/assistant/profile-types.d.ts.map +1 -0
- package/lib/assistant/profile-types.js +9 -0
- package/lib/assistant/profile-types.js.map +1 -0
- package/lib/assistant/runtime-registry.d.ts +20 -0
- package/lib/assistant/runtime-registry.d.ts.map +1 -0
- package/lib/assistant/runtime-registry.js +19 -0
- package/lib/assistant/runtime-registry.js.map +1 -0
- package/lib/assistant/types.d.ts +75 -0
- package/lib/assistant/types.d.ts.map +1 -0
- package/lib/assistant/types.js +6 -0
- package/lib/assistant/types.js.map +1 -0
- package/lib/bootstrap.d.ts +1 -5
- package/lib/bootstrap.d.ts.map +1 -1
- package/lib/bootstrap.js +1 -34
- package/lib/bootstrap.js.map +1 -1
- package/lib/builtin/analyze-media-tool.d.ts +13 -0
- package/lib/builtin/analyze-media-tool.d.ts.map +1 -0
- package/lib/builtin/analyze-media-tool.js +100 -0
- package/lib/builtin/analyze-media-tool.js.map +1 -0
- package/lib/builtin/ask-user-tool.d.ts +1 -1
- package/lib/builtin/ask-user-tool.d.ts.map +1 -1
- package/lib/builtin/ask-user-tool.js +1 -1
- package/lib/builtin/ask-user-tool.js.map +1 -1
- package/lib/builtin/edit-file-tool.d.ts.map +1 -1
- package/lib/builtin/edit-file-tool.js +5 -1
- package/lib/builtin/edit-file-tool.js.map +1 -1
- package/lib/builtin/generate-image-tool.d.ts +21 -0
- package/lib/builtin/generate-image-tool.d.ts.map +1 -0
- package/lib/builtin/generate-image-tool.js +138 -0
- package/lib/builtin/generate-image-tool.js.map +1 -0
- package/lib/builtin/read-file-tool.d.ts +1 -1
- package/lib/builtin/read-file-tool.d.ts.map +1 -1
- package/lib/builtin/read-file-tool.js +2 -7
- package/lib/builtin/read-file-tool.js.map +1 -1
- package/lib/builtin/run-deferred-task-tool.d.ts +1 -1
- package/lib/builtin/run-deferred-task-tool.d.ts.map +1 -1
- package/lib/builtin/run-deferred-task-tool.js +1 -1
- package/lib/builtin/run-deferred-task-tool.js.map +1 -1
- package/lib/builtin/spawn-task-tool.d.ts +1 -1
- package/lib/builtin/spawn-task-tool.d.ts.map +1 -1
- package/lib/builtin/spawn-task-tool.js +25 -4
- package/lib/builtin/spawn-task-tool.js.map +1 -1
- package/lib/builtin/write-file-tool.d.ts.map +1 -1
- package/lib/builtin/write-file-tool.js +6 -1
- package/lib/builtin/write-file-tool.js.map +1 -1
- package/lib/builtin-tools.d.ts.map +1 -1
- package/lib/builtin-tools.js +2 -0
- package/lib/builtin-tools.js.map +1 -1
- package/lib/config/agent-binding-registry.d.ts +14 -0
- package/lib/config/agent-binding-registry.d.ts.map +1 -0
- package/lib/config/agent-binding-registry.js +30 -0
- package/lib/config/agent-binding-registry.js.map +1 -0
- package/lib/config/agent-bindings.d.ts +4 -0
- package/lib/config/agent-bindings.d.ts.map +1 -0
- package/lib/config/agent-bindings.js +16 -0
- package/lib/config/agent-bindings.js.map +1 -0
- package/lib/config/normalize-ai-config.d.ts +15 -0
- package/lib/config/normalize-ai-config.d.ts.map +1 -0
- package/lib/config/normalize-ai-config.js +72 -0
- package/lib/config/normalize-ai-config.js.map +1 -0
- package/lib/config/provider-instance.d.ts +5 -0
- package/lib/config/provider-instance.d.ts.map +1 -0
- package/lib/config/provider-instance.js +65 -0
- package/lib/config/provider-instance.js.map +1 -0
- package/lib/config/types.d.ts +36 -0
- package/lib/config/types.d.ts.map +1 -0
- package/lib/config/types.js +2 -0
- package/lib/config/types.js.map +1 -0
- package/lib/config/validate-ai-config.d.ts +3 -0
- package/lib/config/validate-ai-config.d.ts.map +1 -0
- package/lib/config/validate-ai-config.js +40 -0
- package/lib/config/validate-ai-config.js.map +1 -0
- package/lib/cron-engine.d.ts +20 -18
- package/lib/cron-engine.d.ts.map +1 -1
- package/lib/cron-engine.js +42 -18
- package/lib/cron-engine.js.map +1 -1
- package/lib/deferred-worker-runner.d.ts +2 -0
- package/lib/deferred-worker-runner.d.ts.map +1 -1
- package/lib/deferred-worker-runner.js +17 -35
- package/lib/deferred-worker-runner.js.map +1 -1
- package/lib/discovery/agents.d.ts +2 -0
- package/lib/discovery/agents.d.ts.map +1 -1
- package/lib/discovery/agents.js +5 -0
- package/lib/discovery/agents.js.map +1 -1
- package/lib/hooks.d.ts +0 -1
- package/lib/hooks.d.ts.map +1 -1
- package/lib/hooks.js.map +1 -1
- package/lib/index.d.ts +14 -5
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +8 -3
- package/lib/index.js.map +1 -1
- package/lib/init/activate-ai-database-storage.d.ts +1 -1
- package/lib/init/activate-ai-database-storage.d.ts.map +1 -1
- package/lib/init/activate-ai-database-storage.js +16 -13
- package/lib/init/activate-ai-database-storage.js.map +1 -1
- package/lib/init/create-zhin-agent.d.ts.map +1 -1
- package/lib/init/create-zhin-agent.js +180 -69
- package/lib/init/create-zhin-agent.js.map +1 -1
- package/lib/init/introspection-commands-format.d.ts +40 -0
- package/lib/init/introspection-commands-format.d.ts.map +1 -0
- package/lib/init/introspection-commands-format.js +93 -0
- package/lib/init/introspection-commands-format.js.map +1 -0
- package/lib/init/message-media.d.ts.map +1 -1
- package/lib/init/message-media.js +12 -0
- package/lib/init/message-media.js.map +1 -1
- package/lib/init/output-renderer.d.ts +4 -0
- package/lib/init/output-renderer.d.ts.map +1 -1
- package/lib/init/output-renderer.js +6 -0
- package/lib/init/output-renderer.js.map +1 -1
- package/lib/init/register-ai-trigger.d.ts.map +1 -1
- package/lib/init/register-ai-trigger.js +155 -8
- package/lib/init/register-ai-trigger.js.map +1 -1
- package/lib/init/register-builtin-tools.d.ts.map +1 -1
- package/lib/init/register-builtin-tools.js +13 -3
- package/lib/init/register-builtin-tools.js.map +1 -1
- package/lib/init/register-db-models.d.ts.map +1 -1
- package/lib/init/register-db-models.js +7 -8
- package/lib/init/register-db-models.js.map +1 -1
- package/lib/init/register-db-upgrade.d.ts +1 -1
- package/lib/init/register-db-upgrade.js +2 -2
- package/lib/init/register-db-upgrade.js.map +1 -1
- package/lib/init/register-home-tools.d.ts +2 -0
- package/lib/init/register-home-tools.d.ts.map +1 -0
- package/lib/init/register-home-tools.js +51 -0
- package/lib/init/register-home-tools.js.map +1 -0
- package/lib/init/register-introspection-commands.d.ts +3 -0
- package/lib/init/register-introspection-commands.d.ts.map +1 -0
- package/lib/init/register-introspection-commands.js +97 -0
- package/lib/init/register-introspection-commands.js.map +1 -0
- package/lib/init/register-management-tools.d.ts +1 -1
- package/lib/init/register-management-tools.js +3 -3
- package/lib/init/register-management-tools.js.map +1 -1
- package/lib/init/register-mcp-memory-default.d.ts.map +1 -1
- package/lib/init/register-mcp-memory-default.js +1 -0
- package/lib/init/register-mcp-memory-default.js.map +1 -1
- package/lib/init/register-owner-approve-commands.d.ts.map +1 -1
- package/lib/init/register-owner-approve-commands.js +103 -111
- package/lib/init/register-owner-approve-commands.js.map +1 -1
- package/lib/init/register-typing-indicator.d.ts.map +1 -1
- package/lib/init/register-typing-indicator.js +111 -115
- package/lib/init/register-typing-indicator.js.map +1 -1
- package/lib/init.d.ts.map +1 -1
- package/lib/init.js +4 -0
- package/lib/init.js.map +1 -1
- package/lib/media/constants.d.ts +3 -0
- package/lib/media/constants.d.ts.map +1 -0
- package/lib/media/constants.js +3 -0
- package/lib/media/constants.js.map +1 -0
- package/lib/media/deliver-subagent-result.d.ts +15 -0
- package/lib/media/deliver-subagent-result.d.ts.map +1 -0
- package/lib/media/deliver-subagent-result.js +35 -0
- package/lib/media/deliver-subagent-result.js.map +1 -0
- package/lib/media/index.d.ts +14 -0
- package/lib/media/index.d.ts.map +1 -0
- package/lib/media/index.js +14 -0
- package/lib/media/index.js.map +1 -0
- package/lib/media/media-capabilities.d.ts +3 -0
- package/lib/media/media-capabilities.d.ts.map +1 -0
- package/lib/media/media-capabilities.js +15 -0
- package/lib/media/media-capabilities.js.map +1 -0
- package/lib/media/media-normalize.d.ts +10 -0
- package/lib/media/media-normalize.d.ts.map +1 -0
- package/lib/media/media-normalize.js +108 -0
- package/lib/media/media-normalize.js.map +1 -0
- package/lib/media/media-publisher.d.ts +8 -0
- package/lib/media/media-publisher.d.ts.map +1 -0
- package/lib/media/media-publisher.js +254 -0
- package/lib/media/media-publisher.js.map +1 -0
- package/lib/media/media-router.d.ts +7 -0
- package/lib/media/media-router.d.ts.map +1 -0
- package/lib/media/media-router.js +59 -0
- package/lib/media/media-router.js.map +1 -0
- package/lib/media/media-spool.d.ts +3 -0
- package/lib/media/media-spool.d.ts.map +1 -0
- package/lib/media/media-spool.js +25 -0
- package/lib/media/media-spool.js.map +1 -0
- package/lib/media/media-tool-bridge.d.ts +9 -0
- package/lib/media/media-tool-bridge.d.ts.map +1 -0
- package/lib/media/media-tool-bridge.js +61 -0
- package/lib/media/media-tool-bridge.js.map +1 -0
- package/lib/media/media-types.d.ts +50 -0
- package/lib/media/media-types.d.ts.map +1 -0
- package/lib/media/media-types.js +18 -0
- package/lib/media/media-types.js.map +1 -0
- package/lib/media/resolve-config.d.ts +3 -0
- package/lib/media/resolve-config.d.ts.map +1 -0
- package/lib/media/resolve-config.js +32 -0
- package/lib/media/resolve-config.js.map +1 -0
- package/lib/media/subagent-inbound.d.ts +20 -0
- package/lib/media/subagent-inbound.d.ts.map +1 -0
- package/lib/media/subagent-inbound.js +88 -0
- package/lib/media/subagent-inbound.js.map +1 -0
- package/lib/media/subagent-user-delivery.d.ts +16 -0
- package/lib/media/subagent-user-delivery.d.ts.map +1 -0
- package/lib/media/subagent-user-delivery.js +62 -0
- package/lib/media/subagent-user-delivery.js.map +1 -0
- package/lib/media/vision-capability.d.ts +5 -0
- package/lib/media/vision-capability.d.ts.map +1 -0
- package/lib/media/vision-capability.js +19 -0
- package/lib/media/vision-capability.js.map +1 -0
- package/lib/memory-layers.d.ts +57 -0
- package/lib/memory-layers.d.ts.map +1 -0
- package/lib/memory-layers.js +327 -0
- package/lib/memory-layers.js.map +1 -0
- package/lib/orchestrator/agent-dispatcher.d.ts.map +1 -1
- package/lib/orchestrator/agent-dispatcher.js +2 -0
- package/lib/orchestrator/agent-dispatcher.js.map +1 -1
- package/lib/orchestrator/mcp-lifecycle.d.ts +3 -0
- package/lib/orchestrator/mcp-lifecycle.d.ts.map +1 -1
- package/lib/orchestrator/mcp-lifecycle.js +34 -0
- package/lib/orchestrator/mcp-lifecycle.js.map +1 -1
- package/lib/orchestrator/resolve-subagent-tools.d.ts +20 -0
- package/lib/orchestrator/resolve-subagent-tools.d.ts.map +1 -0
- package/lib/orchestrator/resolve-subagent-tools.js +52 -0
- package/lib/orchestrator/resolve-subagent-tools.js.map +1 -0
- package/lib/orchestrator/task-queue.d.ts +4 -0
- package/lib/orchestrator/task-queue.d.ts.map +1 -1
- package/lib/orchestrator/task-queue.js +24 -0
- package/lib/orchestrator/task-queue.js.map +1 -1
- package/lib/orchestrator/tool-selection.d.ts +1 -1
- package/lib/orchestrator/tool-selection.d.ts.map +1 -1
- package/lib/orchestrator/tool-selection.js +2 -0
- package/lib/orchestrator/tool-selection.js.map +1 -1
- package/lib/routing/route-matcher.d.ts +12 -0
- package/lib/routing/route-matcher.d.ts.map +1 -0
- package/lib/routing/route-matcher.js +72 -0
- package/lib/routing/route-matcher.js.map +1 -0
- package/lib/routing/runtime-binding.d.ts +10 -0
- package/lib/routing/runtime-binding.d.ts.map +1 -0
- package/lib/routing/runtime-binding.js +6 -0
- package/lib/routing/runtime-binding.js.map +1 -0
- package/lib/routing/subagent-summarize.d.ts +6 -0
- package/lib/routing/subagent-summarize.d.ts.map +1 -0
- package/lib/routing/subagent-summarize.js +23 -0
- package/lib/routing/subagent-summarize.js.map +1 -0
- package/lib/security/file-policy.d.ts +7 -1
- package/lib/security/file-policy.d.ts.map +1 -1
- package/lib/security/file-policy.js +34 -1
- package/lib/security/file-policy.js.map +1 -1
- package/lib/service.d.ts +44 -25
- package/lib/service.d.ts.map +1 -1
- package/lib/service.js +93 -56
- package/lib/service.js.map +1 -1
- package/lib/subagent-ai-events.d.ts +30 -0
- package/lib/subagent-ai-events.d.ts.map +1 -0
- package/lib/subagent-ai-events.js +110 -0
- package/lib/subagent-ai-events.js.map +1 -0
- package/lib/subagent-goal-notify.d.ts +27 -6
- package/lib/subagent-goal-notify.d.ts.map +1 -1
- package/lib/subagent-goal-notify.js +46 -12
- package/lib/subagent-goal-notify.js.map +1 -1
- package/lib/subagent.d.ts +43 -3
- package/lib/subagent.d.ts.map +1 -1
- package/lib/subagent.js +191 -88
- package/lib/subagent.js.map +1 -1
- package/lib/task-executor.d.ts +10 -18
- package/lib/task-executor.d.ts.map +1 -1
- package/lib/task-executor.js +11 -34
- package/lib/task-executor.js.map +1 -1
- package/lib/typing-indicator/adapter-integration.d.ts.map +1 -1
- package/lib/typing-indicator/adapter-integration.js +2 -1
- package/lib/typing-indicator/adapter-integration.js.map +1 -1
- package/lib/typing-indicator/index.d.ts.map +1 -1
- package/lib/typing-indicator/index.js +18 -5
- package/lib/typing-indicator/index.js.map +1 -1
- package/lib/zhin-agent/agent-loop-standalone.d.ts +32 -0
- package/lib/zhin-agent/agent-loop-standalone.d.ts.map +1 -0
- package/lib/zhin-agent/agent-loop-standalone.js +144 -0
- package/lib/zhin-agent/agent-loop-standalone.js.map +1 -0
- package/lib/zhin-agent/agent-loop-turn.d.ts +51 -0
- package/lib/zhin-agent/agent-loop-turn.d.ts.map +1 -0
- package/lib/zhin-agent/agent-loop-turn.js +287 -0
- package/lib/zhin-agent/agent-loop-turn.js.map +1 -0
- package/lib/zhin-agent/builtin-tools.d.ts +3 -2
- package/lib/zhin-agent/builtin-tools.d.ts.map +1 -1
- package/lib/zhin-agent/builtin-tools.js +15 -16
- package/lib/zhin-agent/builtin-tools.js.map +1 -1
- package/lib/zhin-agent/config.d.ts +20 -14
- package/lib/zhin-agent/config.d.ts.map +1 -1
- package/lib/zhin-agent/config.js +19 -13
- package/lib/zhin-agent/config.js.map +1 -1
- package/lib/zhin-agent/deferred-delivery.d.ts +5 -0
- package/lib/zhin-agent/deferred-delivery.d.ts.map +1 -0
- package/lib/zhin-agent/deferred-delivery.js +29 -0
- package/lib/zhin-agent/deferred-delivery.js.map +1 -0
- package/lib/zhin-agent/event-emitter.d.ts.map +1 -1
- package/lib/zhin-agent/event-emitter.js +3 -2
- package/lib/zhin-agent/event-emitter.js.map +1 -1
- package/lib/zhin-agent/index.d.ts +50 -8
- package/lib/zhin-agent/index.d.ts.map +1 -1
- package/lib/zhin-agent/index.js +204 -17
- package/lib/zhin-agent/index.js.map +1 -1
- package/lib/zhin-agent/model-resolver.d.ts +0 -1
- package/lib/zhin-agent/model-resolver.d.ts.map +1 -1
- package/lib/zhin-agent/model-resolver.js.map +1 -1
- package/lib/zhin-agent/multimodal-message.d.ts +9 -0
- package/lib/zhin-agent/multimodal-message.d.ts.map +1 -0
- package/lib/zhin-agent/multimodal-message.js +69 -0
- package/lib/zhin-agent/multimodal-message.js.map +1 -0
- package/lib/zhin-agent/prompt-access.d.ts +4 -0
- package/lib/zhin-agent/prompt-access.d.ts.map +1 -0
- package/lib/zhin-agent/prompt-access.js +7 -0
- package/lib/zhin-agent/prompt-access.js.map +1 -0
- package/lib/zhin-agent/prompt-assembly.d.ts.map +1 -1
- package/lib/zhin-agent/prompt-assembly.js +0 -2
- package/lib/zhin-agent/prompt-assembly.js.map +1 -1
- package/lib/zhin-agent/prompt-controller.d.ts +53 -0
- package/lib/zhin-agent/prompt-controller.d.ts.map +1 -0
- package/lib/zhin-agent/prompt-controller.js +165 -0
- package/lib/zhin-agent/prompt-controller.js.map +1 -0
- package/lib/zhin-agent/prompt-input.d.ts +3 -0
- package/lib/zhin-agent/prompt-input.d.ts.map +1 -0
- package/lib/zhin-agent/prompt-input.js +8 -0
- package/lib/zhin-agent/prompt-input.js.map +1 -0
- package/lib/zhin-agent/prompt.d.ts.map +1 -1
- package/lib/zhin-agent/prompt.js +49 -16
- package/lib/zhin-agent/prompt.js.map +1 -1
- package/lib/zhin-agent/session-io.d.ts +12 -7
- package/lib/zhin-agent/session-io.d.ts.map +1 -1
- package/lib/zhin-agent/session-io.js +18 -15
- package/lib/zhin-agent/session-io.js.map +1 -1
- package/lib/zhin-agent/session-message-queue.d.ts +20 -0
- package/lib/zhin-agent/session-message-queue.d.ts.map +1 -0
- package/lib/zhin-agent/session-message-queue.js +52 -0
- package/lib/zhin-agent/session-message-queue.js.map +1 -0
- package/lib/zhin-agent/tool-calls-user-format.d.ts.map +1 -1
- package/lib/zhin-agent/tool-calls-user-format.js +8 -1
- package/lib/zhin-agent/tool-calls-user-format.js.map +1 -1
- package/lib/zhin-agent/tool-orchestration.d.ts.map +1 -1
- package/lib/zhin-agent/tool-orchestration.js +43 -10
- package/lib/zhin-agent/tool-orchestration.js.map +1 -1
- package/lib/zhin-agent/tool-runtime.d.ts +2 -4
- package/lib/zhin-agent/tool-runtime.d.ts.map +1 -1
- package/lib/zhin-agent/tool-runtime.js +4 -7
- package/lib/zhin-agent/tool-runtime.js.map +1 -1
- package/lib/zhin-agent/tool-search-orchestrator.d.ts +3 -0
- package/lib/zhin-agent/tool-search-orchestrator.d.ts.map +1 -1
- package/lib/zhin-agent/tool-search-orchestrator.js +8 -3
- package/lib/zhin-agent/tool-search-orchestrator.js.map +1 -1
- package/lib/zhin-agent/turn-context.d.ts +9 -0
- package/lib/zhin-agent/turn-context.d.ts.map +1 -0
- package/lib/zhin-agent/turn-context.js +12 -0
- package/lib/zhin-agent/turn-context.js.map +1 -0
- package/lib/zhin-agent/turn-pipeline.d.ts +5 -1
- package/lib/zhin-agent/turn-pipeline.d.ts.map +1 -1
- package/lib/zhin-agent/turn-pipeline.js +128 -401
- package/lib/zhin-agent/turn-pipeline.js.map +1 -1
- package/lib/zhin-agent/turn-tracker.d.ts +2 -0
- package/lib/zhin-agent/turn-tracker.d.ts.map +1 -1
- package/lib/zhin-agent/turn-tracker.js +11 -6
- package/lib/zhin-agent/turn-tracker.js.map +1 -1
- package/lib/zhin-agent/zhin-agent-private.d.ts +18 -5
- package/lib/zhin-agent/zhin-agent-private.d.ts.map +1 -1
- package/lib/zhin-agent/zhin-agent-private.js.map +1 -1
- package/package.json +3 -3
- package/lib/zhin-agent/llm-runner.d.ts +0 -16
- package/lib/zhin-agent/llm-runner.d.ts.map +0 -1
- package/lib/zhin-agent/llm-runner.js +0 -85
- package/lib/zhin-agent/llm-runner.js.map +0 -1
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { resolveIMSessionIdFromToolContext } from '@zhin.js/ai';
|
|
2
|
+
import { ensureMcpConnectionsForBinding } from './orchestrator/mcp-lifecycle.js';
|
|
3
|
+
export class SubagentAiEventReporter {
|
|
4
|
+
emitter;
|
|
5
|
+
ctx;
|
|
6
|
+
sessionId;
|
|
7
|
+
toolContext;
|
|
8
|
+
constructor(emitter, ctx) {
|
|
9
|
+
this.emitter = emitter;
|
|
10
|
+
this.ctx = ctx;
|
|
11
|
+
const scope = ctx.origin.sceneType === 'group' || ctx.origin.sceneType === 'channel'
|
|
12
|
+
? ctx.origin.sceneType
|
|
13
|
+
: 'private';
|
|
14
|
+
this.toolContext = {
|
|
15
|
+
platform: ctx.origin.platform,
|
|
16
|
+
botId: ctx.origin.botId,
|
|
17
|
+
sceneId: ctx.origin.sceneId,
|
|
18
|
+
senderId: ctx.origin.senderId,
|
|
19
|
+
messageId: ctx.origin.messageId,
|
|
20
|
+
scope,
|
|
21
|
+
fileRole: ctx.origin.fileRole,
|
|
22
|
+
};
|
|
23
|
+
this.sessionId = resolveIMSessionIdFromToolContext({
|
|
24
|
+
platform: ctx.origin.platform,
|
|
25
|
+
botId: ctx.origin.botId,
|
|
26
|
+
scope,
|
|
27
|
+
sceneId: ctx.origin.sceneId,
|
|
28
|
+
senderId: ctx.origin.senderId,
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
payload(extra = {}) {
|
|
32
|
+
return this.emitter.createPayload(this.sessionId, this.toolContext, 'text', {
|
|
33
|
+
source: 'subagent',
|
|
34
|
+
path: 'agent',
|
|
35
|
+
taskId: this.ctx.taskId,
|
|
36
|
+
label: this.ctx.label,
|
|
37
|
+
agentId: this.ctx.presetName ?? this.ctx.label,
|
|
38
|
+
...extra,
|
|
39
|
+
});
|
|
40
|
+
}
|
|
41
|
+
async processingStart(content) {
|
|
42
|
+
await this.emitter.dispatch('ai.processing.start', this.payload({
|
|
43
|
+
content,
|
|
44
|
+
keepTyping: this.ctx.keepTypingUntilUpstreamFinish,
|
|
45
|
+
}));
|
|
46
|
+
}
|
|
47
|
+
async processingFinish(reply, extra) {
|
|
48
|
+
await this.emitter.dispatch('ai.processing.finish', this.payload({
|
|
49
|
+
reply,
|
|
50
|
+
keepTyping: this.ctx.keepTypingUntilUpstreamFinish,
|
|
51
|
+
...extra,
|
|
52
|
+
}));
|
|
53
|
+
if (!this.ctx.keepTypingUntilUpstreamFinish) {
|
|
54
|
+
this.emitter.emit('ai.typing.stop', this.payload({ reason: 'subagent_done' }));
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
async processingError(error) {
|
|
58
|
+
await this.emitter.dispatch('ai.processing.error', this.payload({ error }));
|
|
59
|
+
if (!this.ctx.keepTypingUntilUpstreamFinish) {
|
|
60
|
+
this.emitter.emit('ai.typing.stop', this.payload({ reason: 'subagent_error' }));
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
async ensureMcpForBinding(mcps, serverNames) {
|
|
64
|
+
await ensureMcpConnectionsForBinding(mcps, serverNames, (event) => {
|
|
65
|
+
const payload = this.payload({
|
|
66
|
+
serverName: event.serverName,
|
|
67
|
+
loadedToolNames: event.toolNames,
|
|
68
|
+
error: event.error,
|
|
69
|
+
reason: event.connected === false ? 'disconnected' : undefined,
|
|
70
|
+
});
|
|
71
|
+
if (event.phase === 'start') {
|
|
72
|
+
this.emitter.emit('ai.mcp.connect.start', payload);
|
|
73
|
+
}
|
|
74
|
+
else if (event.phase === 'finish') {
|
|
75
|
+
this.emitter.emit('ai.mcp.connect.finish', payload);
|
|
76
|
+
}
|
|
77
|
+
else {
|
|
78
|
+
this.emitter.emit('ai.mcp.connect.error', payload);
|
|
79
|
+
}
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
createAgentLoopCallbacks(model) {
|
|
83
|
+
return {
|
|
84
|
+
onToolCall: (toolName, args) => {
|
|
85
|
+
this.emitter.emit('ai.tool.call', this.payload({
|
|
86
|
+
toolName,
|
|
87
|
+
args,
|
|
88
|
+
model,
|
|
89
|
+
}));
|
|
90
|
+
},
|
|
91
|
+
onToolResult: (toolName, result) => {
|
|
92
|
+
this.emitter.emit('ai.tool.result', this.payload({
|
|
93
|
+
toolName,
|
|
94
|
+
result,
|
|
95
|
+
model,
|
|
96
|
+
}));
|
|
97
|
+
},
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
async agentStart(model) {
|
|
101
|
+
await this.emitter.dispatch('ai.agent.start', this.payload({ model }));
|
|
102
|
+
}
|
|
103
|
+
async agentFinish(model, iterations) {
|
|
104
|
+
await this.emitter.dispatch('ai.agent.finish', this.payload({ model, iterations }));
|
|
105
|
+
}
|
|
106
|
+
async response(reply, model, iterations) {
|
|
107
|
+
await this.emitter.dispatch('ai.response', this.payload({ reply, model, iterations }));
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
//# sourceMappingURL=subagent-ai-events.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"subagent-ai-events.js","sourceRoot":"","sources":["../src/subagent-ai-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,aAAa,CAAC;AAIhE,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AAajF,MAAM,OAAO,uBAAuB;IAKf;IACA;IALV,SAAS,CAAS;IAClB,WAAW,CAAc;IAElC,YACmB,OAA8B,EAC9B,GAA2B;QAD3B,YAAO,GAAP,OAAO,CAAuB;QAC9B,QAAG,GAAH,GAAG,CAAwB;QAE5C,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS;YAClF,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS;YACtB,CAAC,CAAC,SAAS,CAAC;QACd,IAAI,CAAC,WAAW,GAAG;YACjB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ;YAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK;YACvB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO;YAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ;YAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS;YAC/B,KAAK;YACL,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ;SAC9B,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,iCAAiC,CAAC;YACjD,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ;YAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK;YACvB,KAAK;YACL,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO;YAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ;SAC9B,CAAC,CAAC;IACL,CAAC;IAEO,OAAO,CAAC,QAAgE,EAAE;QAChF,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE;YAC1E,MAAM,EAAE,UAAU;YAClB,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM;YACvB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;YACrB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK;YAC9C,GAAG,KAAK;SACT,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe;QACnC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,EAAE,IAAI,CAAC,OAAO,CAAC;YAC9D,OAAO;YACP,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,6BAA6B;SACnD,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,KAAa,EAAE,KAA8D;QAClG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,EAAE,IAAI,CAAC,OAAO,CAAC;YAC/D,KAAK;YACL,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,6BAA6B;YAClD,GAAG,KAAK;SACT,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAa;QACjC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,6BAA6B,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,IAAiB,EAAE,WAAqB;QAChE,MAAM,8BAA8B,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE;YAChE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;gBAC3B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,eAAe,EAAE,KAAK,CAAC,SAAS;gBAChC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM,EAAE,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;aAC/D,CAAC,CAAC;YACH,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;YACrD,CAAC;iBAAM,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACpC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;YACrD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,wBAAwB,CAAC,KAAa;QACpC,OAAO;YACL,UAAU,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE;gBAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC;oBAC7C,QAAQ;oBACR,IAAI;oBACJ,KAAK;iBACN,CAAC,CAAC,CAAC;YACN,CAAC;YACD,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;gBACjC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC;oBAC/C,QAAQ;oBACR,MAAM;oBACN,KAAK;iBACN,CAAC,CAAC,CAAC;YACN,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAa;QAC5B,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAyB,EAAE,UAAkB;QAC7D,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,KAAyB,EAAE,UAAkB;QACzE,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IACzF,CAAC;CACF"}
|
|
@@ -1,13 +1,34 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* 主 Agent 委派子任务时,向 IM
|
|
2
|
+
* 主 Agent 委派子任务时,向 IM 用户即时发送进度提示。
|
|
3
|
+
*
|
|
4
|
+
* 注意:`kind` 是用户可见的「执行通道」(异步/视觉/定时/同步/编排),
|
|
5
|
+
* 与 AgentDispatcher 内部的 `AgentRole`(subtask/worker 等工具权限)不是同一概念。
|
|
3
6
|
*/
|
|
4
7
|
import type { ToolContext } from '@zhin.js/core';
|
|
5
8
|
/** ToolContext.extra 中挂载的回调键 */
|
|
6
9
|
export declare const SUBAGENT_GOAL_NOTIFY_EXTRA_KEY = "onSubagentGoal";
|
|
7
|
-
|
|
8
|
-
export
|
|
9
|
-
|
|
10
|
-
export
|
|
10
|
+
/** 用户可见的执行通道(进度提示中间段) */
|
|
11
|
+
export type SubagentExecutionKind = 'async' | 'sync' | 'vision' | 'draw' | 'deferred' | 'cron';
|
|
12
|
+
export declare const SUBAGENT_EXECUTION_KIND_LABELS: Record<SubagentExecutionKind, string>;
|
|
13
|
+
export interface SubagentProcessingNotice {
|
|
14
|
+
taskId: string;
|
|
15
|
+
kind: SubagentExecutionKind;
|
|
16
|
+
label: string;
|
|
17
|
+
/** ai.agents / spawn_task 的 agent 名(如 draw、vision) */
|
|
18
|
+
agent?: string;
|
|
19
|
+
}
|
|
20
|
+
export type SubagentGoalNotifier = (notice: SubagentProcessingNotice) => void | Promise<void>;
|
|
21
|
+
export declare function resolveSubagentDisplayLabel(label: string | undefined, task: string): string;
|
|
22
|
+
/** spawn / spawnSync 的执行通道:具名 agent 优先,否则 sync/async */
|
|
23
|
+
export declare function resolveSpawnExecutionKind(options: {
|
|
24
|
+
sync?: boolean;
|
|
25
|
+
agent?: string;
|
|
26
|
+
}): SubagentExecutionKind;
|
|
27
|
+
/** 日志与进度提示用的 agent 展示名 */
|
|
28
|
+
export declare function resolveSubagentAgentLabel(agent?: string): string | undefined;
|
|
29
|
+
export declare function formatSubagentExecutionKindLabel(kind: SubagentExecutionKind): string;
|
|
30
|
+
/** 用户可见格式:任务【taskId】:执行通道·agent => label */
|
|
31
|
+
export declare function formatSubagentProcessingMessage(notice: SubagentProcessingNotice): string;
|
|
11
32
|
export declare function getSubagentGoalNotifier(ctx?: ToolContext): SubagentGoalNotifier | undefined;
|
|
12
|
-
export declare function notifySubagentGoal(ctx: ToolContext | undefined,
|
|
33
|
+
export declare function notifySubagentGoal(ctx: ToolContext | undefined, notice: SubagentProcessingNotice): Promise<void>;
|
|
13
34
|
//# sourceMappingURL=subagent-goal-notify.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"subagent-goal-notify.d.ts","sourceRoot":"","sources":["../src/subagent-goal-notify.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"subagent-goal-notify.d.ts","sourceRoot":"","sources":["../src/subagent-goal-notify.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,gCAAgC;AAChC,eAAO,MAAM,8BAA8B,mBAAmB,CAAC;AAE/D,yBAAyB;AACzB,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAE/F,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAOhF,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9F,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI3F;AAED,wDAAwD;AACxD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,qBAAqB,CAMxB;AAED,0BAA0B;AAC1B,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5E;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAEpF;AAED,4CAA4C;AAC5C,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAOxF;AAED,wBAAgB,uBAAuB,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,oBAAoB,GAAG,SAAS,CAG3F;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,GAAG,SAAS,EAC5B,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAaf"}
|
|
@@ -1,29 +1,63 @@
|
|
|
1
1
|
/** ToolContext.extra 中挂载的回调键 */
|
|
2
2
|
export const SUBAGENT_GOAL_NOTIFY_EXTRA_KEY = 'onSubagentGoal';
|
|
3
|
-
const
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
3
|
+
export const SUBAGENT_EXECUTION_KIND_LABELS = {
|
|
4
|
+
async: '异步',
|
|
5
|
+
sync: '同步',
|
|
6
|
+
vision: '视觉',
|
|
7
|
+
draw: '文生图',
|
|
8
|
+
deferred: '编排',
|
|
9
|
+
cron: '定时',
|
|
10
|
+
};
|
|
11
|
+
export function resolveSubagentDisplayLabel(label, task) {
|
|
12
|
+
const trimmed = label?.trim();
|
|
13
|
+
if (trimmed)
|
|
7
14
|
return trimmed;
|
|
8
|
-
return
|
|
15
|
+
return task.slice(0, 30) + (task.length > 30 ? '...' : '');
|
|
9
16
|
}
|
|
10
|
-
/**
|
|
11
|
-
export function
|
|
12
|
-
|
|
17
|
+
/** spawn / spawnSync 的执行通道:具名 agent 优先,否则 sync/async */
|
|
18
|
+
export function resolveSpawnExecutionKind(options) {
|
|
19
|
+
const agent = options.agent?.trim().toLowerCase();
|
|
20
|
+
if (agent === 'vision')
|
|
21
|
+
return 'vision';
|
|
22
|
+
if (agent === 'draw')
|
|
23
|
+
return 'draw';
|
|
24
|
+
if (options.sync)
|
|
25
|
+
return 'sync';
|
|
26
|
+
return 'async';
|
|
27
|
+
}
|
|
28
|
+
/** 日志与进度提示用的 agent 展示名 */
|
|
29
|
+
export function resolveSubagentAgentLabel(agent) {
|
|
30
|
+
const a = agent?.trim();
|
|
31
|
+
return a || undefined;
|
|
32
|
+
}
|
|
33
|
+
export function formatSubagentExecutionKindLabel(kind) {
|
|
34
|
+
return SUBAGENT_EXECUTION_KIND_LABELS[kind] ?? kind;
|
|
35
|
+
}
|
|
36
|
+
/** 用户可见格式:任务【taskId】:执行通道·agent => label */
|
|
37
|
+
export function formatSubagentProcessingMessage(notice) {
|
|
38
|
+
const taskId = notice.taskId.trim();
|
|
39
|
+
const kindLabel = formatSubagentExecutionKindLabel(notice.kind);
|
|
40
|
+
const label = notice.label.trim() || '任务';
|
|
41
|
+
const agent = resolveSubagentAgentLabel(notice.agent);
|
|
42
|
+
const channel = agent ? `${kindLabel}·${agent}` : kindLabel;
|
|
43
|
+
return `任务【${taskId}】:${channel} => ${label}`;
|
|
13
44
|
}
|
|
14
45
|
export function getSubagentGoalNotifier(ctx) {
|
|
15
46
|
const fn = ctx?.extra?.[SUBAGENT_GOAL_NOTIFY_EXTRA_KEY];
|
|
16
47
|
return typeof fn === 'function' ? fn : undefined;
|
|
17
48
|
}
|
|
18
|
-
export async function notifySubagentGoal(ctx,
|
|
49
|
+
export async function notifySubagentGoal(ctx, notice) {
|
|
19
50
|
const notify = getSubagentGoalNotifier(ctx);
|
|
20
51
|
if (!notify)
|
|
21
52
|
return;
|
|
22
|
-
|
|
23
|
-
if (!trimmed)
|
|
53
|
+
if (!notice.taskId.trim() || !notice.label.trim())
|
|
24
54
|
return;
|
|
25
55
|
try {
|
|
26
|
-
await notify(
|
|
56
|
+
await notify({
|
|
57
|
+
taskId: notice.taskId.trim(),
|
|
58
|
+
kind: notice.kind,
|
|
59
|
+
label: notice.label.trim(),
|
|
60
|
+
});
|
|
27
61
|
}
|
|
28
62
|
catch {
|
|
29
63
|
// 进度提示失败不中断子任务
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"subagent-goal-notify.js","sourceRoot":"","sources":["../src/subagent-goal-notify.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"subagent-goal-notify.js","sourceRoot":"","sources":["../src/subagent-goal-notify.ts"],"names":[],"mappings":"AAQA,gCAAgC;AAChC,MAAM,CAAC,MAAM,8BAA8B,GAAG,gBAAgB,CAAC;AAK/D,MAAM,CAAC,MAAM,8BAA8B,GAA0C;IACnF,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,KAAK;IACX,QAAQ,EAAE,IAAI;IACd,IAAI,EAAE,IAAI;CACX,CAAC;AAYF,MAAM,UAAU,2BAA2B,CAAC,KAAyB,EAAE,IAAY;IACjF,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,yBAAyB,CAAC,OAGzC;IACC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClD,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACpC,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IACxB,OAAO,CAAC,IAAI,SAAS,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,IAA2B;IAC1E,OAAO,8BAA8B,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACtD,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,+BAA+B,CAAC,MAAgC;IAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,gCAAgC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,yBAAyB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,OAAO,MAAM,MAAM,KAAK,OAAO,OAAO,KAAK,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAiB;IACvD,MAAM,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,CAAC,8BAA8B,CAAC,CAAC;IACxD,OAAO,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC,CAAE,EAA2B,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAA4B,EAC5B,MAAgC;IAEhC,MAAM,MAAM,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO;IAC1D,IAAI,CAAC;QACH,MAAM,MAAM,CAAC;YACX,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;AACH,CAAC"}
|
package/lib/subagent.d.ts
CHANGED
|
@@ -8,26 +8,43 @@
|
|
|
8
8
|
* 4. 完成后将结果投递回主流程,由主 agent 摘要后发送到原始频道
|
|
9
9
|
*/
|
|
10
10
|
import type { AIProvider, AgentTool, Usage } from '@zhin.js/core';
|
|
11
|
-
import type {
|
|
12
|
-
import type {
|
|
11
|
+
import type { ResolvedAgentBinding } from './config/types.js';
|
|
12
|
+
import type { McpRegistry } from './orchestrator/mcp-registry.js';
|
|
13
|
+
import type { AgentResult, ContentPart, ModelRegistry } from '@zhin.js/ai';
|
|
14
|
+
import { type ZhinAgentConfig } from './zhin-agent/config.js';
|
|
15
|
+
import type { ToolContext } from '@zhin.js/core';
|
|
13
16
|
import type { FileRole } from './security/file-role-policy.js';
|
|
14
17
|
import { AgentDispatcher, type AgentRole } from './orchestrator/agent-dispatcher.js';
|
|
18
|
+
import type { ToolCallRecord } from './zhin-agent/tool-calls-user-format.js';
|
|
19
|
+
import type { ZhinAgentEventEmitter } from './zhin-agent/event-emitter.js';
|
|
15
20
|
export interface SubagentOrigin {
|
|
16
21
|
platform: string;
|
|
17
22
|
botId: string;
|
|
18
23
|
sceneId: string;
|
|
19
24
|
senderId: string;
|
|
20
25
|
sceneType: string;
|
|
26
|
+
/** 入站消息 ID(ICQQ 等 reaction 打字必填) */
|
|
27
|
+
messageId?: string;
|
|
21
28
|
fileRole?: FileRole;
|
|
22
29
|
}
|
|
23
30
|
export interface SpawnOptions {
|
|
24
31
|
task: string;
|
|
25
32
|
label?: string;
|
|
26
33
|
origin: SubagentOrigin;
|
|
34
|
+
/** 配置/route 中的 agent 名(ai.agents + *.agent.md) */
|
|
35
|
+
agent?: string;
|
|
36
|
+
/** 显式绑定(优先于 agent 名解析) */
|
|
37
|
+
binding?: ResolvedAgentBinding;
|
|
38
|
+
/** 来自 *.agent.md 正文的 system prompt */
|
|
39
|
+
systemPrompt?: string;
|
|
27
40
|
/** Agent 角色(可选,默认为 'subtask') */
|
|
28
41
|
role?: AgentRole;
|
|
29
42
|
/** 任务上下文(可选) */
|
|
30
43
|
context?: Record<string, unknown>;
|
|
44
|
+
/** 首条 user 消息(含 vision parts);缺省则用 task 字符串 */
|
|
45
|
+
runInput?: string | ContentPart[];
|
|
46
|
+
/** 用于向用户发送「任务【id】:执行通道 => label」进度提示 */
|
|
47
|
+
notifyContext?: ToolContext;
|
|
31
48
|
}
|
|
32
49
|
export interface SubagentLifecycleEvent {
|
|
33
50
|
phase: 'spawn' | 'start' | 'finish';
|
|
@@ -36,13 +53,22 @@ export interface SubagentLifecycleEvent {
|
|
|
36
53
|
task: string;
|
|
37
54
|
origin: SubagentOrigin;
|
|
38
55
|
role?: AgentRole;
|
|
56
|
+
/** ai.agents 名,如 pm / architect / dev */
|
|
57
|
+
agent?: string;
|
|
39
58
|
status?: 'ok' | 'error';
|
|
40
59
|
result?: string;
|
|
41
60
|
error?: string;
|
|
42
61
|
}
|
|
43
|
-
export
|
|
62
|
+
export interface SubagentResultDelivery {
|
|
63
|
+
text: string;
|
|
64
|
+
toolCalls?: AgentResult['toolCalls'] | ToolCallRecord[];
|
|
65
|
+
}
|
|
66
|
+
export type SubagentResultSender = (origin: SubagentOrigin, delivery: SubagentResultDelivery) => Promise<void>;
|
|
44
67
|
export interface SubagentManagerOptions {
|
|
45
68
|
provider: AIProvider;
|
|
69
|
+
getProvider?: (alias: string) => AIProvider;
|
|
70
|
+
resolveBinding?: (agentName: string) => ResolvedAgentBinding | null;
|
|
71
|
+
getMcpRegistry?: () => McpRegistry | null;
|
|
46
72
|
workspace: string;
|
|
47
73
|
createTools: () => AgentTool[];
|
|
48
74
|
subagentTools?: string[];
|
|
@@ -58,9 +84,14 @@ export interface SubagentManagerOptions {
|
|
|
58
84
|
agentDispatcher?: AgentDispatcher;
|
|
59
85
|
/** 生命周期事件回调(供上层桥接到统一事件总线) */
|
|
60
86
|
onEvent?: (event: SubagentLifecycleEvent) => void | Promise<void>;
|
|
87
|
+
/** 与主 ZhinAgent 相同的 AI 处理事件总线(processing / tool / mcp 等) */
|
|
88
|
+
eventEmitter?: ZhinAgentEventEmitter | null;
|
|
61
89
|
}
|
|
62
90
|
export declare class SubagentManager {
|
|
63
91
|
private provider;
|
|
92
|
+
private getProviderFn;
|
|
93
|
+
private resolveBindingFn;
|
|
94
|
+
private getMcpRegistryFn;
|
|
64
95
|
private workspace;
|
|
65
96
|
private createTools;
|
|
66
97
|
private maxIterations;
|
|
@@ -73,9 +104,18 @@ export declare class SubagentManager {
|
|
|
73
104
|
private registerSubagentTask;
|
|
74
105
|
private agentDispatcher;
|
|
75
106
|
private onEvent;
|
|
107
|
+
private eventEmitter;
|
|
76
108
|
constructor(options: SubagentManagerOptions);
|
|
109
|
+
setEventEmitter(emitter: ZhinAgentEventEmitter | null): void;
|
|
77
110
|
setSender(sender: SubagentResultSender): void;
|
|
78
111
|
setModelRegistry(registry: ModelRegistry | null): void;
|
|
112
|
+
configureRouting(deps: {
|
|
113
|
+
getProvider?: (alias: string) => AIProvider;
|
|
114
|
+
resolveBinding?: (agentName: string) => ResolvedAgentBinding | null;
|
|
115
|
+
getMcpRegistry?: () => McpRegistry | null;
|
|
116
|
+
}): void;
|
|
117
|
+
/** 同步执行子 agent(入站 route 用);返回最终文本,不经过 resultSender */
|
|
118
|
+
spawnSync(options: SpawnOptions): Promise<string>;
|
|
79
119
|
spawn(options: SpawnOptions): Promise<string>;
|
|
80
120
|
getRunningCount(): number;
|
|
81
121
|
private runSubagent;
|
package/lib/subagent.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../src/subagent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../src/subagent.ts"],"names":[],"mappings":"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"}
|