evolcore 0.0.49 → 0.0.51
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 +103 -3
- package/bin/ec-build.mjs +60 -0
- package/bin/ecmsg.js +64 -57
- package/dist/ability/caller/authorization.js +21 -0
- package/dist/ability/caller/command.js +173 -0
- package/dist/ability/caller/contract.js +117 -0
- package/dist/ability/caller/credential-files.js +132 -0
- package/dist/ability/caller/daemon.js +183 -0
- package/dist/ability/caller/schema-view.js +157 -0
- package/dist/ability/caller/service.js +519 -0
- package/dist/ability/command-contract.js +5 -0
- package/dist/ability/daemon.js +5 -1
- package/dist/ability/interop-v1.js +156 -106
- package/dist/ability/management.js +1 -0
- package/dist/agent-template/jobs.js +79 -3
- package/dist/agent-template/runtime.js +459 -47
- package/dist/agent-template/service.js +1242 -198
- package/dist/agent-template/share.js +103 -0
- package/dist/agent-template/tool-runner.js +25 -0
- package/dist/agent-template/types.js +10 -2
- package/dist/agents/claude/availability.js +94 -0
- package/dist/agents/claude/capability-provider.js +154 -0
- package/dist/agents/claude/index.js +145 -0
- package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
- package/dist/agents/claude/session-file-adapter.js +246 -0
- package/dist/agents/codex/app-server-client.js +90 -10
- package/dist/agents/codex/availability.js +164 -0
- package/dist/agents/codex/capability-provider.js +138 -0
- package/dist/agents/codex/cli.js +38 -0
- package/dist/agents/codex/index.js +345 -0
- package/dist/agents/codex/mcp-elicitation.js +135 -0
- package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
- package/dist/agents/codex/session-file-adapter.js +834 -0
- package/dist/agents/dsh/availability.js +28 -0
- package/dist/agents/dsh/capability-provider.js +56 -0
- package/dist/agents/dsh/desktop-locations.ps1 +66 -0
- package/dist/agents/dsh/desktop-probe.cjs +37 -0
- package/dist/agents/dsh/index.js +98 -0
- package/dist/agents/dsh/installation.js +400 -0
- package/dist/agents/dsh/resources.js +755 -0
- package/dist/agents/dsh/runner.js +1183 -0
- package/dist/agents/dsh/runtime/README.md +243 -0
- package/dist/agents/dsh/runtime/authorization.js +23 -0
- package/dist/agents/dsh/runtime/bridge.js +837 -0
- package/dist/agents/dsh/runtime/config.js +271 -0
- package/dist/agents/dsh/runtime/entry.js +229 -0
- package/dist/agents/dsh/runtime/session-inspector.js +340 -0
- package/dist/agents/dsh/runtime/tool-policy.js +49 -0
- package/dist/agents/dsh/session-file-adapter.js +145 -0
- package/dist/agents/ecagent/index.js +215 -0
- package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
- package/dist/agents/ecagent/session-file-adapter.js +134 -0
- package/dist/agents/gemini/index.js +96 -0
- package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
- package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
- package/dist/aun/ability-device-routing.js +11 -17
- package/dist/aun/aid/agentmd.js +27 -1
- package/dist/aun/aid/control-aid.js +52 -32
- package/dist/aun/aid/managed-operation.js +6 -4
- package/dist/aun/group/invite-service.js +7 -37
- package/dist/aun/group/operations.js +6 -0
- package/dist/aun/menu/client.js +1 -1
- package/dist/aun/msg/history.js +1 -1
- package/dist/aun/msg/managed-operation.js +93 -21
- package/dist/aun/msg/mention-schema.js +1 -1
- package/dist/aun/msg/p2p.js +32 -4
- package/dist/aun/msg/upload.js +126 -3
- package/dist/aun/service-proxy.js +1 -1
- package/dist/aun/storage/index.js +242 -0
- package/dist/build-identity.json +1 -1
- package/dist/channels/aun.js +698 -213
- package/dist/channels/daemon.js +3 -2
- package/dist/channels/dingtalk.js +1 -1
- package/dist/channels/feishu.js +9 -9
- package/dist/channels/qqbot.js +1 -1
- package/dist/channels/wechat.js +2 -2
- package/dist/channels/wecom.js +1 -1
- package/dist/claude-gateway/agent-registration.js +389 -0
- package/dist/claude-gateway/binding.js +96 -0
- package/dist/claude-gateway/inbox.js +138 -0
- package/dist/claude-gateway/index.js +125 -0
- package/dist/claude-gateway/listing.js +330 -0
- package/dist/claude-gateway/router.js +328 -0
- package/dist/claude-gateway/sessions.js +128 -0
- package/dist/claude-gateway/terminal.js +250 -0
- package/dist/claude-gateway/transcript.js +272 -0
- package/dist/claude-gateway/types.js +14 -0
- package/dist/cli/ability-command.js +45 -0
- package/dist/cli/ability-output.js +182 -0
- package/dist/cli/agent-command.js +21 -2
- package/dist/cli/agent-create.js +197 -56
- package/dist/cli/agent-template.js +400 -27
- package/dist/cli/agent.js +105 -11
- package/dist/cli/aun-commands.js +237 -123
- package/dist/cli/bench.js +5 -2
- package/dist/cli/config.js +22 -6
- package/dist/cli/daemon-commands.js +283 -109
- package/dist/cli/data-command.js +1 -1
- package/dist/cli/debug-mode.js +9 -0
- package/dist/cli/directory.js +1 -2
- package/dist/cli/ecmsg-gateway.js +64 -26
- package/dist/cli/fs-command.js +67 -39
- package/dist/cli/index.js +45 -12
- package/dist/cli/init.js +161 -90
- package/dist/cli/managed-command-guard.js +3 -0
- package/dist/cli/menu-client.js +32 -7
- package/dist/cli/model.js +1 -1
- package/dist/cli/pay-command.js +30 -0
- package/dist/cli/provider-command.js +6 -2
- package/dist/cli/restart-monitor.js +4 -4
- package/dist/cli/services-command.js +35 -10
- package/dist/cli/skill-command.js +4 -4
- package/dist/cli/task-context.js +24 -14
- package/dist/cli/team-workspace-command.js +50 -52
- package/dist/cli/thread-command.js +81 -14
- package/dist/cli/trigger-command.js +47 -12
- package/dist/cli/watch-logs.js +2 -1
- package/dist/config/access-policy.js +16 -3
- package/dist/config/boot-log.js +3 -0
- package/dist/config/builtin-role-templates.js +1 -1
- package/dist/config/config-field-policy.js +26 -13
- package/dist/config/config-manager.js +113 -52
- package/dist/config/config-operation-service.js +22 -1
- package/dist/config/gateway-config.js +29 -44
- package/dist/config/invoke-ipc-service.js +1 -1
- package/dist/config/owner-config.js +5 -19
- package/dist/config/peer-book-store.js +2 -3
- package/dist/config/peer-book.js +2 -2
- package/dist/config/peer-role-resolver.js +3 -9
- package/dist/config/provider-identity-migration.js +24 -105
- package/dist/config/provider-ipc-service.js +13 -3
- package/dist/config/provider-local-sync.js +4 -1
- package/dist/config/provider-menu-request.js +21 -3
- package/dist/config/provider-templates.js +1 -1
- package/dist/config/providers-config.js +138 -31
- package/dist/config/providers-import.js +3 -3
- package/dist/config/providers-management.js +109 -118
- package/dist/config/resolved-config-op.js +1 -42
- package/dist/config/schema-migration.js +254 -15
- package/dist/config/schema-registry.js +53 -8
- package/dist/config-store.js +1343 -63
- package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
- package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
- package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
- package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
- package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
- package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
- package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
- package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
- package/dist/core/auth/agent-delegation.js +15 -8
- package/dist/core/auth/delegation-authorization.js +28 -0
- package/dist/core/auth/operation-authorizer.js +20 -2
- package/dist/core/auth/operation-catalog.js +80 -8
- package/dist/core/baseagent/baseagent-availability.js +197 -0
- package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
- package/dist/core/baseagent/baseagent-config-shared.js +56 -0
- package/dist/core/baseagent/baseagent-identity.js +68 -0
- package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
- package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
- package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
- package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
- package/dist/core/baseagent/baseagent.js +157 -0
- package/dist/{agents → core/baseagent}/runner-types.js +36 -4
- package/dist/core/capability/capability-manager.js +91 -33
- package/dist/core/capability/providers/claude-capability-provider.js +2 -154
- package/dist/core/capability/providers/codex-capability-provider.js +2 -136
- package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
- package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
- package/dist/core/command/agent-control.js +80 -17
- package/dist/core/command/agent-template-menu.js +23 -10
- package/dist/core/command/agentmd-menu-request.js +19 -8
- package/dist/core/command/agentmd-menu.js +14 -5
- package/dist/core/command/cli-intent-parser.js +15 -0
- package/dist/core/command/command-handler.js +127 -57
- package/dist/core/command/context-policy-menu.js +122 -0
- package/dist/core/command/data-root-resolver.js +157 -20
- package/dist/core/command/memory-slash.js +6 -6
- package/dist/core/command/menu-catalog.js +95 -19
- package/dist/core/command/menu-file-path.js +70 -0
- package/dist/core/command/menu-handler.js +392 -93
- package/dist/core/command/menu-protocol.js +47 -8
- package/dist/core/command/menu-query-batch.js +9 -5
- package/dist/core/command/private-mention-menu.js +71 -0
- package/dist/core/command/provider-menu.js +7 -11
- package/dist/core/command/role-menu.js +1 -1
- package/dist/core/command/skill-slash.js +17 -5
- package/dist/core/command/slash-gate.js +2 -4
- package/dist/core/command/slash-handler.js +143 -121
- package/dist/core/command/team-workspace-bootstrap.js +2 -1
- package/dist/core/command/team-workspace-team.js +3 -3
- package/dist/core/command/topic-slash.js +16 -10
- package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
- package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
- package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
- package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
- package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
- package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
- package/dist/core/file-integrity/store.js +1 -1
- package/dist/core/handoff/ipc-registration.js +3 -3
- package/dist/core/handoff/runtime.js +2 -2
- package/dist/{agents → core/inference}/request-identity.js +2 -2
- package/dist/core/inference/text-inference.js +4 -4
- package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
- package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
- package/dist/core/initialization/service.js +57 -9
- package/dist/core/invoke/executors/media.js +1 -1
- package/dist/core/invoke/executors/text.js +1 -1
- package/dist/core/memory/consolidation-context.js +3 -2
- package/dist/core/memory/consolidation-trigger.js +9 -3
- package/dist/core/memory/consolidation.js +39 -68
- package/dist/core/memory/memory-admin.js +6 -6
- package/dist/core/memory/memory-writer.js +1 -1
- package/dist/core/memory/relation-idle-monitor.js +1 -1
- package/dist/core/message/aun-ipc-sender.js +204 -88
- package/dist/core/message/aun-request-registry.js +44 -5
- package/dist/core/message/auto-mention-gate.js +1 -1
- package/dist/core/message/contact-admission.js +1 -1
- package/dist/core/message/im-renderer.js +19 -0
- package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
- package/dist/core/message/items-formatter.js +5 -5
- package/dist/core/message/message-admission.js +1 -1
- package/dist/core/message/message-bridge.js +239 -59
- package/dist/core/message/message-log.js +8 -0
- package/dist/core/message/message-queue.js +88 -7
- package/dist/core/message/message-utils.js +1 -1
- package/dist/core/message/peer-mode.js +16 -5
- package/dist/core/message/response-engine.js +351 -152
- package/dist/core/message/send-options.js +44 -7
- package/dist/core/message/send-routing.js +55 -115
- package/dist/core/message/stream-idle-monitor.js +1 -1
- package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
- package/dist/core/model/catalog-service.js +29 -8
- package/dist/core/model/model-capabilities.js +88 -0
- package/dist/core/model/model-catalog.js +18 -7
- package/dist/core/model/model-diagnostics.js +4 -4
- package/dist/core/ownership/owner-resolver.js +107 -101
- package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
- package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
- package/dist/core/permission/approval-gateway.js +9 -18
- package/dist/core/permission/ec-command-parser.js +242 -82
- package/dist/core/permission/managed-file.js +234 -0
- package/dist/core/permission/protected-paths.js +120 -9
- package/dist/core/permission/sandbox-runtime.js +267 -3
- package/dist/core/permission/services-path-acl.js +9 -2
- package/dist/core/permission/session-path-grants.js +1 -1
- package/dist/core/permission/shell-environment.js +15 -1
- package/dist/core/permission/tool-policy.js +21 -9
- package/dist/core/plugin/plugin-lifecycle.js +442 -0
- package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
- package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
- package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
- package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
- package/dist/core/{background-session → session/background}/types.js +1 -1
- package/dist/core/session/session-file-health.js +2 -272
- package/dist/core/session/session-idle-monitor.js +1 -1
- package/dist/core/session/session-manager.js +76 -12
- package/dist/core/session/session-mapper.js +16 -0
- package/dist/core/session/session-terminal.js +185 -0
- package/dist/core/session/session-title.js +8 -11
- package/dist/core/{system-session → session/system}/memory.js +43 -9
- package/dist/core/{system-session → session/system}/registry.js +1 -1
- package/dist/core/{system-session → session/system}/types.js +1 -1
- package/dist/core/skill/index-generator.js +3 -3
- package/dist/core/skill/switch-resolver.js +3 -0
- package/dist/core/task/task-activity-store.js +112 -0
- package/dist/core/task/task-recovery-service.js +2 -2
- package/dist/core/thread/command-parser.js +4 -1
- package/dist/core/thread/ipc-operation.js +6 -4
- package/dist/core/thread/thread-operation.js +27 -11
- package/dist/core/thread/thread-route.js +5 -3
- package/dist/core/thread/thread-service.js +307 -58
- package/dist/core/thread/topic-id.js +52 -2
- package/dist/core/thread/types.js +15 -1
- package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
- package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
- package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
- package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
- package/dist/directory/{owner-directory-search.js → search.js} +50 -2
- package/dist/directory/{owner-directory-store.js → store.js} +2 -2
- package/dist/eck/kit-renderer.js +3 -2
- package/dist/eck/manifest-engine.js +64 -2
- package/dist/eck/message-renderer.js +35 -0
- package/dist/ecweb/basic-settings-service.js +12 -10
- package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
- package/dist/ecweb/dsh-native-service.js +413 -0
- package/dist/ecweb/providers-service.js +5 -3
- package/dist/ecweb/runtime/lifecycle.js +1 -1
- package/dist/ecweb/runtime/supervisor.js +1 -1
- package/dist/event-center/center-config.js +2 -2
- package/dist/event-center/dispatcher.js +1 -1
- package/dist/event-center/ipc-operation.js +12 -3
- package/dist/event-center/pack-loader.js +2 -2
- package/dist/event-center/registry.js +6 -6
- package/dist/event-center/runtime.js +2 -2
- package/dist/index.js +181 -77
- package/dist/ipc.js +161 -12
- package/dist/outputs/authorization.js +27 -0
- package/dist/outputs/events.js +10 -1
- package/dist/outputs/panel-cards.js +960 -0
- package/dist/paths.js +60 -1
- package/dist/pay/command.js +38 -0
- package/dist/pay/protocol.js +136 -0
- package/dist/pay/runtime.js +196 -0
- package/dist/pay/service.js +384 -0
- package/dist/pay/store.js +81 -0
- package/dist/response-system/engines/v1/proactive-flow.js +30 -3
- package/dist/services/dispatcher.js +25 -7
- package/dist/services/host/main.js +397 -0
- package/dist/services/host/protocol.js +125 -0
- package/dist/services/host/resident.js +347 -0
- package/dist/services/host-client.js +398 -0
- package/dist/services/host-deploy.js +180 -0
- package/dist/services/host-launch.js +117 -0
- package/dist/services/host-recycle.js +208 -0
- package/dist/services/host-runtime.js +841 -0
- package/dist/services/idempotency.js +44 -86
- package/dist/services/index-generator.js +4 -3
- package/dist/services/index.js +258 -36
- package/dist/services/ipc-operation.js +503 -78
- package/dist/services/pack-manager.js +2 -2
- package/dist/services/router.js +43 -3
- package/dist/services/script-runner.js +541 -100
- package/dist/services/service-payload.js +28 -1
- package/dist/services/validation.js +136 -5
- package/dist/stats/context-usage.js +110 -0
- package/dist/stats/model-resolver.js +103 -17
- package/dist/stats/query.js +5 -0
- package/dist/trigger/application-service.js +9 -6
- package/dist/trigger/authorization.js +36 -33
- package/dist/trigger/ipc-service.js +4 -4
- package/dist/trigger/local-files.js +8 -166
- package/dist/trigger/manager.js +2 -2
- package/dist/trigger/parser.js +48 -0
- package/dist/trigger/scheduler.js +35 -13
- package/dist/trigger/script-executor.js +21 -0
- package/dist/trigger/script-sandbox.js +77 -232
- package/dist/trigger/system-definitions.js +25 -0
- package/dist/trigger/validation.js +1 -1
- package/dist/utils/aid-bind.js +3 -0
- package/dist/utils/atomic-write.js +88 -1
- package/dist/utils/cross-platform.js +4 -42
- package/dist/utils/error-dict.json +22 -1
- package/dist/utils/error-utils.js +193 -6
- package/dist/utils/evolcore-version.js +2 -2
- package/dist/utils/host-info.js +74 -1
- package/dist/utils/logger.js +5 -3
- package/dist/utils/media-cache.js +284 -42
- package/dist/utils/restart-safety.js +14 -1
- package/dist/utils/startup-trace.js +20 -4
- package/dist/utils/system-memory.js +113 -25
- package/dist/utils/systemd-lifecycle.js +154 -0
- package/dist/utils/welcome.js +64 -20
- package/dist/utils/windows-shell-trust.js +7 -3
- package/ecagent/README.md +35 -0
- package/ecagent/dist/agent-loop.js +80 -30
- package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
- package/ecagent/dist/harness/env/nodejs.js +49 -20
- package/ecagent/dist/harness/messages.js +3 -2
- package/ecagent/dist/harness/types.d.ts +1 -0
- package/ecagent/dist/runtime/types.d.ts +2 -0
- package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
- package/ecagent/dist/runtime/utils/validation.js +42 -0
- package/ecagent/dist/types.d.ts +2 -0
- package/kits/docs/INDEX.md +3 -2
- package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
- package/kits/docs/channels/aun.md +1 -1
- package/kits/docs/channels/feishu.md +1 -1
- package/kits/docs/evolcore/INDEX.md +13 -9
- package/kits/docs/evolcore/agent-create.md +2 -0
- package/kits/docs/evolcore/agent.md +133 -11
- package/kits/docs/evolcore/aid.md +39 -6
- package/kits/docs/evolcore/config.md +95 -1
- package/kits/docs/evolcore/ctl.md +2 -1
- package/kits/docs/evolcore/ec-capabilities.md +7 -10
- package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
- package/kits/docs/evolcore/event.md +1 -1
- package/kits/docs/evolcore/fs.md +49 -3
- package/kits/docs/evolcore/group.md +5 -4
- package/kits/docs/evolcore/memory-consolidation.md +1 -1
- package/kits/docs/evolcore/memory-tags.md +2 -0
- package/kits/docs/evolcore/menu-client.md +3 -3
- package/kits/docs/evolcore/menu-protocol.md +31 -2
- package/kits/docs/evolcore/model.md +12 -1
- package/kits/docs/evolcore/msg.md +96 -36
- package/kits/docs/evolcore/pay.md +22 -0
- package/kits/docs/evolcore/plugin.md +74 -0
- package/kits/docs/evolcore/provider.md +29 -2
- package/kits/docs/evolcore/rpc.md +2 -2
- package/kits/docs/evolcore/services.md +46 -18
- package/kits/docs/evolcore/skill.md +17 -1
- package/kits/docs/evolcore/stats.md +5 -0
- package/kits/docs/evolcore/storage.md +22 -0
- package/kits/docs/evolcore/thread-chain.md +20 -9
- package/kits/docs/evolcore/tool-authorization.md +14 -0
- package/kits/docs/evolcore/trigger.md +89 -13
- package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
- package/kits/docs/venues/feishu-group.md +3 -2
- package/kits/docs/venues/feishu-private.md +3 -2
- package/kits/rules/01-overview.md +11 -32
- package/kits/rules/02-navigation.md +20 -6
- package/kits/rules/06-channel.md +20 -4
- package/kits/schemas/_meta.json +42 -5
- package/kits/schemas/agent-config.schema.21.json +974 -0
- package/kits/schemas/agent-config.schema.22.json +977 -0
- package/kits/schemas/agent-config.schema.23.json +974 -0
- package/kits/schemas/agent-config.schema.24.json +986 -0
- package/kits/schemas/agent-config.schema.25.json +986 -0
- package/kits/schemas/daemon.schema.10.json +373 -0
- package/kits/schemas/daemon.schema.11.json +487 -0
- package/kits/schemas/daemon.schema.12.json +505 -0
- package/kits/schemas/daemon.schema.9.json +12 -0
- package/kits/schemas/defaults.schema.7.json +472 -0
- package/kits/schemas/defaults.schema.8.json +484 -0
- package/kits/schemas/providers.schema.1.json +1 -1
- package/kits/schemas/providers.schema.2.json +1 -1
- package/kits/schemas/providers.schema.3.json +26 -4
- package/kits/schemas/relation-config.schema.13.json +289 -0
- package/kits/skills/.switches.json +17 -1
- package/kits/skills/ability/SKILL.md +395 -33
- package/kits/skills/ability/STRUCTURE.md +338 -0
- package/kits/skills/ability/references/cli.md +208 -0
- package/kits/skills/ability/references/development.md +107 -37
- package/kits/skills/ability/references/management.md +106 -46
- package/kits/skills/ability/references/runtime-protocol.md +65 -63
- package/kits/skills/agent-output-cards/SKILL.md +80 -37
- package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
- package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
- package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
- package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
- package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
- package/kits/skills/agent-output-cards/examples/surface.html +8 -0
- package/kits/skills/agent-template-project/SKILL.md +51 -0
- package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
- package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
- package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
- package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
- package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
- package/kits/skills/ec-group/SKILL.md +8 -6
- package/kits/skills/ec-group/TASK.md +186 -0
- package/kits/skills/ec-group/WORKLOG.md +180 -0
- package/kits/skills/ec-group-collaboration/SKILL.md +5 -5
- package/kits/skills/ec-identity/SKILL.md +9 -6
- package/kits/skills/ec-pay/SKILL.md +223 -0
- package/kits/skills/ec-provider/SKILL.md +6 -6
- package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
- package/kits/skills/ec-service-call/SKILL.md +138 -0
- package/kits/skills/ec-service-pack/SKILL.md +277 -0
- package/kits/skills/ec-skill/SKILL.md +25 -9
- package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
- package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
- package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
- package/kits/skills/ec-trigger/SKILL.md +3 -3
- package/kits/skills/personal-assistant/SKILL.md +22 -22
- package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
- package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
- package/kits/skills/thread-ops/SKILL.md +19 -9
- package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
- package/kits/skills/wechat-article-reader/SKILL.md +2 -2
- package/kits/templates/memory-consolidation/notes.md +2 -2
- package/kits/templates/memory-consolidation/workflow.md +46 -0
- package/kits/templates/system-fragments/channel.md +13 -4
- package/kits/templates/system-fragments/commands.md +5 -4
- package/kits/templates/system-fragments/personal-assistant.md +2 -2
- package/kits/templates/system-fragments/reply.md +15 -9
- package/kits/templates/system-fragments/session.md +2 -2
- package/kits/templates/system-fragments/thread.md +30 -127
- package/kits/templates/system-fragments/venue.md +16 -0
- package/package.json +7 -7
- package/scripts/agent-template/index.mjs +7 -1
- package/scripts/agent-template/inspect.mjs +99 -39
- package/scripts/agent-template/overlay.mjs +126 -2
- package/scripts/agent-template/shared/common.mjs +49 -5
- package/scripts/agent-template/shared/plan.mjs +4 -2
- package/scripts/agent-template/shared/service-packs.mjs +104 -0
- package/scripts/agent-template/shared/team-schema.json +468 -39
- package/scripts/agent-template/shared/template-contract.mjs +93 -51
- package/scripts/agent-template/shared/template-package.mjs +225 -44
- package/scripts/agent-template/shared/template-runtime.mjs +137 -15
- package/scripts/agent-template/shared/template.mjs +31 -8
- package/scripts/agent-template/team-pack.mjs +528 -56
- package/scripts/agent-template/team-preview.mjs +102 -9
- package/scripts/aid-batch/identity-batch.mjs +1 -1
- package/dist/agents/baseagent-availability.js +0 -152
- package/dist/agents/baseagent.js +0 -750
- package/dist/agents/codex/catalog.js +0 -80
- package/dist/agents/ecagent-plugin-lazy.js +0 -41
- package/dist/agents/tool-time-context.js +0 -55
- package/dist/core/legacy-rename.js +0 -41
- package/dist/core/plugin-lifecycle.js +0 -137
- package/dist/core/rate-window.js +0 -53
- package/dist/core/runner-reload-transaction.js +0 -60
- package/dist/core/runtime-lock.js +0 -90
- package/dist/core/soul.js +0 -66
- package/dist/core/system-session/grants.js +0 -40
- package/dist/directory/owner-directory-agentmd-sync.js +0 -89
- package/dist/directory/owner-directory-request-operation.js +0 -79
- package/dist/directory/owner-directory-text.js +0 -60
- package/kits/docs/aun/ABILITY_CALLING.md +0 -280
- package/kits/docs/evolcore/ability.md +0 -185
- package/kits/skills/ability/references/calling.md +0 -56
- package/kits/skills/ability/references/contract-checklist.md +0 -37
- package/kits/skills/ability/references/recovery.md +0 -27
- /package/dist/{core/capability/providers/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
- /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
- /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
- /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
- /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
- /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
- /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
- /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
- /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
- /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
- /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
- /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
|
@@ -6,7 +6,10 @@
|
|
|
6
6
|
* 沙箱复用 buildTriggerScriptLaunch(scoped 路径),fullaccess 走无沙箱路径。
|
|
7
7
|
*/
|
|
8
8
|
import { spawn } from 'node:child_process';
|
|
9
|
+
import fs from 'node:fs';
|
|
10
|
+
import os from 'node:os';
|
|
9
11
|
import path from 'node:path';
|
|
12
|
+
import { randomUUID } from 'node:crypto';
|
|
10
13
|
import { buildTriggerScriptLaunch, runPrepareWithDeadline } from '../trigger/script-sandbox.js';
|
|
11
14
|
import { isCredentialEnvironmentName, sanitizeShellExecutionEnvironment } from '../core/permission/shell-environment.js';
|
|
12
15
|
import { resolveRuntimePermissionMode } from '../core/role/runtime-policy.js';
|
|
@@ -14,8 +17,16 @@ import { resolvePhaseOneExecutionSandbox } from '../core/permission/mode.js';
|
|
|
14
17
|
import { killProcessTree, resolveCommandPath } from '../utils/cross-platform.js';
|
|
15
18
|
import { logger } from '../utils/logger.js';
|
|
16
19
|
import { SCRIPTS_DIR } from './pack-manager.js';
|
|
20
|
+
import { SERVICE_TRANSPORT_FIELDS } from './service-payload.js';
|
|
21
|
+
import { DEFAULT_HANDLER_TIMEOUT_MS } from './validation.js';
|
|
22
|
+
import { FrameSplitter } from './host/protocol.js';
|
|
17
23
|
import { errorMessage } from './types.js';
|
|
18
24
|
const SCRIPT_OUTPUT_LIMIT_BYTES = 1024 * 1024;
|
|
25
|
+
/**
|
|
26
|
+
* 常驻脚本单帧上限。与宿主侧同口径(`HOST_FRAME_LIMIT_BYTES`)——两边对
|
|
27
|
+
* "一帧能有多大"必须给同一个答案,否则同一脚本换个执行路径就换个行为。
|
|
28
|
+
*/
|
|
29
|
+
const RESIDENT_LINE_LIMIT_BYTES = 2 * 1024 * 1024;
|
|
19
30
|
const NOOP_SENTINEL = '[[NOOP]]';
|
|
20
31
|
/** 与 trigger / event-center 同款排除名单。 */
|
|
21
32
|
const ENVIRONMENT_EXCLUDES = [
|
|
@@ -54,10 +65,20 @@ export function inferRuntime(script) {
|
|
|
54
65
|
}
|
|
55
66
|
export class ServiceScriptRunner {
|
|
56
67
|
deps;
|
|
68
|
+
hostRuntimeOverride;
|
|
57
69
|
constructor(deps) {
|
|
58
70
|
this.deps = deps;
|
|
59
71
|
}
|
|
60
|
-
|
|
72
|
+
/**
|
|
73
|
+
* 挂载/摘除宿主运行时。
|
|
74
|
+
*
|
|
75
|
+
* 单独做成方法而不是构造参数:总闸可以在 `reload()` 后变化,而 runner 与 dispatcher
|
|
76
|
+
* 在构造时就绑定好了(dispatcher 持有 runner 引用),重建一整套不划算。
|
|
77
|
+
*/
|
|
78
|
+
setHostRuntime(runtime) {
|
|
79
|
+
this.hostRuntimeOverride = runtime;
|
|
80
|
+
}
|
|
81
|
+
async run(pack, handler, message, options = {}) {
|
|
61
82
|
const startedAt = Date.now();
|
|
62
83
|
let cmd = handler.script;
|
|
63
84
|
// `cmd` 由 finish 统一带上:解释器与绝对路径在 try 里才算得出来(拿不到 runtime 时
|
|
@@ -67,6 +88,12 @@ export class ServiceScriptRunner {
|
|
|
67
88
|
cmd,
|
|
68
89
|
durationMs: Date.now() - startedAt,
|
|
69
90
|
});
|
|
91
|
+
// 宿主路径:同一份 stdin 契约与 env,只是把 spawn 交给常驻宿主。
|
|
92
|
+
// cmd 仍在这里拼,日志/台账口径不变。
|
|
93
|
+
const hostRuntime = this.hostRuntimeOverride;
|
|
94
|
+
if (hostRuntime) {
|
|
95
|
+
return await this.runViaHost(hostRuntime, pack, handler, message, finish, (value) => { cmd = value; }, options.peerRole);
|
|
96
|
+
}
|
|
70
97
|
let launch;
|
|
71
98
|
let sandboxFallbackReason;
|
|
72
99
|
try {
|
|
@@ -75,7 +102,7 @@ export class ServiceScriptRunner {
|
|
|
75
102
|
const scriptPath = path.join(pack.paths.scriptsDir, handler.script.slice(SCRIPTS_DIR.length + 1));
|
|
76
103
|
const scriptArgs = handler.args ?? [];
|
|
77
104
|
cmd = [executable, scriptPath, ...scriptArgs].join(' ');
|
|
78
|
-
const built = this.buildLaunch(pack, handler, message, executable, scriptPath, scriptArgs);
|
|
105
|
+
const built = this.buildLaunch(pack, handler, message, executable, scriptPath, scriptArgs, options.peerRole);
|
|
79
106
|
// Unsandboxed launches have no directory preparation or new authorization gap.
|
|
80
107
|
launch = built instanceof Promise ? await built : built;
|
|
81
108
|
if (launch.prepare) {
|
|
@@ -123,7 +150,20 @@ export class ServiceScriptRunner {
|
|
|
123
150
|
+ `file isolation is NOT applied, secrets in env are NOT scrubbed.${detail}`);
|
|
124
151
|
}
|
|
125
152
|
try {
|
|
126
|
-
|
|
153
|
+
if (message.deadlineAt !== undefined && Date.now() >= message.deadlineAt) {
|
|
154
|
+
return finish({ outcome: 'timeout', exitCode: 0, stdoutPreview: '', stderrPreview: '',
|
|
155
|
+
error: { code: 'SERVICE_DEADLINE_EXCEEDED', message: 'request expired before script execution' } });
|
|
156
|
+
}
|
|
157
|
+
// 常驻形态但宿主没开 → 降级成「每次调用起一个进程,喂一帧、读一行、杀掉」。
|
|
158
|
+
//
|
|
159
|
+
// 不能直接走下面的 `execute`:那里的 stdin 是契约 JSON(`{service,message}`),
|
|
160
|
+
// 而常驻脚本等的是 `{type:'call',callId,...}` 帧。喂错契约的后果不是"变慢",
|
|
161
|
+
// 而是脚本 `call.type !== 'call'` 直接返回、末行只剩 `{"t":"ready"}`,
|
|
162
|
+
// 被 `settleCapturedOutput` 判成 `HANDLER_PROTOCOL`——每次调用都失败,
|
|
163
|
+
// 且错误码指向脚本而非配置。
|
|
164
|
+
const result = handler.mode === 'resident'
|
|
165
|
+
? await this.executeResidentOnce(launch, pack, handler, message, cmd, finish)
|
|
166
|
+
: await this.execute(launch, pack, message, handler, cmd, finish);
|
|
127
167
|
// 把「本次没沙箱」透传给上游,供日志/台账/reply 明示。
|
|
128
168
|
return launch.sandboxAbsent ? { ...result, sandboxAbsent: launch.sandboxAbsent } : result;
|
|
129
169
|
}
|
|
@@ -157,12 +197,12 @@ export class ServiceScriptRunner {
|
|
|
157
197
|
};
|
|
158
198
|
}
|
|
159
199
|
/** 构造启动配置:fullaccess(或 bypass+owner)→ 无沙箱;否则 trigger 沙箱。 */
|
|
160
|
-
buildLaunch(pack, handler, message, executable, scriptPath, scriptArgs) {
|
|
200
|
+
buildLaunch(pack, handler, message, executable, scriptPath, scriptArgs, peerRoleOverride) {
|
|
201
|
+
const peerRole = peerRoleOverride ?? this.deps.resolvePeerRole?.(message.fromAid) ?? undefined;
|
|
161
202
|
const effective = this.deps.permissionMode
|
|
162
|
-
? this.deps.permissionMode()
|
|
163
|
-
: resolveRuntimePermissionMode({ selfAid: this.deps.aid }).effectiveValue;
|
|
164
|
-
//
|
|
165
|
-
const peerRole = this.deps.resolvePeerRole?.(message.fromAid) ?? undefined;
|
|
203
|
+
? this.deps.permissionMode(peerRole)
|
|
204
|
+
: resolveRuntimePermissionMode({ selfAid: this.deps.aid, role: peerRole }).effectiveValue;
|
|
205
|
+
// Caller policy selects the mode; only bypass + owner exempts the sandbox.
|
|
166
206
|
const sandboxDecision = resolvePhaseOneExecutionSandbox(effective, peerRole);
|
|
167
207
|
const ecEnv = this.buildEcEnv(pack, message);
|
|
168
208
|
if (sandboxDecision.state === 'off') {
|
|
@@ -184,9 +224,21 @@ export class ServiceScriptRunner {
|
|
|
184
224
|
triggerDir: pack.dir,
|
|
185
225
|
scriptPath,
|
|
186
226
|
scriptArgs,
|
|
227
|
+
// 快照以**包目录**为根:handler 可以住在 scripts/<子目录>/,往上跳一级的
|
|
228
|
+
// 相对 import(`../lib/x.mjs`)必须和本地运行解析到同一处。
|
|
229
|
+
snapshotRoot: pack.dir,
|
|
187
230
|
projectPath,
|
|
188
231
|
executionAuthorization: authorization,
|
|
189
|
-
}).then(launch => ({
|
|
232
|
+
}).then(launch => ({
|
|
233
|
+
...launch,
|
|
234
|
+
env: {
|
|
235
|
+
...launch.env,
|
|
236
|
+
...ecEnv,
|
|
237
|
+
// 沙箱里真实包目录是 EPERM,EC_PACK_DIR 必须指向包目录的快照镜像;
|
|
238
|
+
// 否则脚本会拿着一个必然打不开的路径去拼自己的数据文件。
|
|
239
|
+
...(launch.scriptSnapshotRoot ? { EC_PACK_DIR: launch.scriptSnapshotRoot } : {}),
|
|
240
|
+
},
|
|
241
|
+
}));
|
|
190
242
|
}
|
|
191
243
|
buildEcEnv(pack, message) {
|
|
192
244
|
return {
|
|
@@ -214,12 +266,131 @@ export class ServiceScriptRunner {
|
|
|
214
266
|
source: { type: 'event', eventPattern: '*' },
|
|
215
267
|
execution: {
|
|
216
268
|
type: 'script',
|
|
217
|
-
script: { path: handler.script, runtime: executable, args: handler.args ?? [], timeoutMs: handler.timeoutMs ??
|
|
269
|
+
script: { path: handler.script, runtime: executable, args: handler.args ?? [], timeoutMs: handler.timeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS },
|
|
218
270
|
onError: 'fail',
|
|
219
271
|
noopSentinel: NOOP_SENTINEL,
|
|
220
272
|
},
|
|
221
273
|
};
|
|
222
274
|
}
|
|
275
|
+
/**
|
|
276
|
+
* 经宿主执行一次调用。
|
|
277
|
+
*
|
|
278
|
+
* 与一次性路径的分工:这里只负责「把契约 stdin 和 per-call env 算出来、交给宿主、
|
|
279
|
+
* 把原始输出交给共用判定」。沙箱、快照、探针都在宿主启动时付过一次。
|
|
280
|
+
*/
|
|
281
|
+
async runViaHost(hostRuntime, pack, handler, message, finish, setCmd, peerRoleOverride) {
|
|
282
|
+
const runtime = handler.runtime ?? inferRuntime(handler.script);
|
|
283
|
+
let executable;
|
|
284
|
+
try {
|
|
285
|
+
executable = resolveRuntimeExecutable(runtime);
|
|
286
|
+
}
|
|
287
|
+
catch (error) {
|
|
288
|
+
const code = error.code ?? 'RUNTIME_NOT_FOUND';
|
|
289
|
+
return finish({ outcome: 'error', exitCode: 126, error: { code, message: errorMessage(error) }, stdoutPreview: '', stderrPreview: '' });
|
|
290
|
+
}
|
|
291
|
+
setCmd([executable, handler.script, ...(handler.args ?? [])].join(' '));
|
|
292
|
+
// 与一次性路径同一套构造:契约 JSON 先算,算不出来就不投递。
|
|
293
|
+
let stdin;
|
|
294
|
+
try {
|
|
295
|
+
stdin = this.buildStdin(pack, message);
|
|
296
|
+
}
|
|
297
|
+
catch (error) {
|
|
298
|
+
return finish({
|
|
299
|
+
outcome: 'error', exitCode: 0,
|
|
300
|
+
error: { code: 'HANDLER_PROTOCOL', message: `failed to build script stdin: ${errorMessage(error)}` },
|
|
301
|
+
stdoutPreview: '', stderrPreview: '',
|
|
302
|
+
});
|
|
303
|
+
}
|
|
304
|
+
const timeoutMs = handler.timeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS;
|
|
305
|
+
// 形态 B:常驻脚本每帧自带 `callId` 与本次调用的字段(环境变量在它启动时就冻结了)。
|
|
306
|
+
const resident = handler.mode === 'resident';
|
|
307
|
+
/**
|
|
308
|
+
* 常驻调用真正生效的期限。
|
|
309
|
+
*
|
|
310
|
+
* `hostRuntime.run` 对常驻用了 `softTimeoutMs ?? timeoutMs`,所以超时报错必须引用
|
|
311
|
+
* 同一个值——写 `timeoutMs` 会让「配 2s、报 20s」对不上,排查时直接指向错误的字段。
|
|
312
|
+
*/
|
|
313
|
+
const residentTimeoutMs = handler.resident?.softTimeoutMs ?? timeoutMs;
|
|
314
|
+
try {
|
|
315
|
+
const result = await hostRuntime.run({
|
|
316
|
+
role: peerRoleOverride ?? this.deps.resolvePeerRole?.(message.fromAid) ?? undefined,
|
|
317
|
+
deadlineAt: message.deadlineAt,
|
|
318
|
+
pack,
|
|
319
|
+
handler,
|
|
320
|
+
stdin,
|
|
321
|
+
env: this.buildEcEnv(pack, message),
|
|
322
|
+
timeoutMs,
|
|
323
|
+
...(resident
|
|
324
|
+
? { residentLine: (callId, workDir) => this.buildResidentLine(callId, workDir, handler, pack, message) }
|
|
325
|
+
: {}),
|
|
326
|
+
});
|
|
327
|
+
const hostFinish = (value) => finish({ ...value, ...(result.sandboxAbsent ? { sandboxAbsent: result.sandboxAbsent } : {}) });
|
|
328
|
+
// 形态 B 的结果是结构化的:不走 stdout 文本解析,直接映射成 outcome。
|
|
329
|
+
// 若硬套 `settleCapturedOutput`,就得把 data 再序列化回文本让 daemon 解析第二遍——
|
|
330
|
+
// 那会把"两条路径必须解析一致"变成长期负担。
|
|
331
|
+
if (result.resident) {
|
|
332
|
+
if (result.outcome === 'noop')
|
|
333
|
+
return hostFinish({ outcome: 'noop', exitCode: 0, stdoutPreview: '', stderrPreview: '' });
|
|
334
|
+
if (result.hostError) {
|
|
335
|
+
return hostFinish({
|
|
336
|
+
outcome: 'error',
|
|
337
|
+
exitCode: 0,
|
|
338
|
+
error: { code: result.hostError.code, message: result.hostError.message },
|
|
339
|
+
stdoutPreview: '',
|
|
340
|
+
stderrPreview: result.stderr.slice(-512),
|
|
341
|
+
});
|
|
342
|
+
}
|
|
343
|
+
if (result.timedOut) {
|
|
344
|
+
return hostFinish({
|
|
345
|
+
outcome: 'timeout', exitCode: 124,
|
|
346
|
+
error: { code: 'TIMEOUT', message: `resident call timed out after ${residentTimeoutMs}ms` },
|
|
347
|
+
stdoutPreview: '', stderrPreview: result.stderr.slice(-512),
|
|
348
|
+
});
|
|
349
|
+
}
|
|
350
|
+
if (result.scriptError) {
|
|
351
|
+
return hostFinish({
|
|
352
|
+
outcome: 'error', exitCode: 0,
|
|
353
|
+
error: result.scriptError,
|
|
354
|
+
stdoutPreview: '', stderrPreview: result.stderr.slice(-512),
|
|
355
|
+
});
|
|
356
|
+
}
|
|
357
|
+
// `noop` 已在上方原样传出(调用方据此不回包);走到这里是真正的 success。
|
|
358
|
+
return hostFinish({
|
|
359
|
+
outcome: 'success', exitCode: 0,
|
|
360
|
+
...(result.data !== undefined ? { data: result.data } : {}),
|
|
361
|
+
stdoutPreview: '', stderrPreview: result.stderr.slice(-512),
|
|
362
|
+
});
|
|
363
|
+
}
|
|
364
|
+
return hostFinish(settleCapturedOutput({
|
|
365
|
+
stdout: result.stdout,
|
|
366
|
+
stderr: result.stderr,
|
|
367
|
+
exitCode: result.exitCode,
|
|
368
|
+
timedOut: result.timedOut,
|
|
369
|
+
truncated: result.truncated,
|
|
370
|
+
timeoutMs,
|
|
371
|
+
// 宿主层面的失败(spawn 失败 / workDir 建不出来)按 spawn 失败处理,
|
|
372
|
+
// 但保留宿主给的码,便于区分「脚本崩了」与「宿主没法起脚本」。
|
|
373
|
+
...(result.hostError
|
|
374
|
+
? { spawnError: new Error(result.hostError.message), hostErrorCode: result.hostError.code }
|
|
375
|
+
: {}),
|
|
376
|
+
}));
|
|
377
|
+
}
|
|
378
|
+
catch (error) {
|
|
379
|
+
// 宿主不可用(启动失败 / 卡死 / 已关闭):这是**调度层**失败,不是脚本失败。
|
|
380
|
+
// 码原样透出,由 index.ts 决定不写 handled、不进幂等缓存。
|
|
381
|
+
const code = error.code;
|
|
382
|
+
return finish({
|
|
383
|
+
outcome: 'error',
|
|
384
|
+
exitCode: 0,
|
|
385
|
+
error: {
|
|
386
|
+
code: typeof code === 'string' && code ? code : 'SERVICES_HOST_UNAVAILABLE',
|
|
387
|
+
message: errorMessage(error),
|
|
388
|
+
},
|
|
389
|
+
stdoutPreview: '',
|
|
390
|
+
stderrPreview: '',
|
|
391
|
+
});
|
|
392
|
+
}
|
|
393
|
+
}
|
|
223
394
|
async execute(launch, pack, message, handler, cmd, finish) {
|
|
224
395
|
return await new Promise(resolve => {
|
|
225
396
|
const child = spawn(launch.command, launch.args, {
|
|
@@ -266,92 +437,22 @@ export class ServiceScriptRunner {
|
|
|
266
437
|
const timer = setTimeout(() => {
|
|
267
438
|
timedOut = true;
|
|
268
439
|
killTree();
|
|
269
|
-
}, handler.timeoutMs ??
|
|
440
|
+
}, handler.timeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS);
|
|
270
441
|
timer.unref?.();
|
|
271
442
|
const settle = (exitCode, spawnError) => {
|
|
272
443
|
if (settled)
|
|
273
444
|
return;
|
|
274
445
|
settled = true;
|
|
275
446
|
clearTimeout(timer);
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
}
|
|
286
|
-
if (truncated) {
|
|
287
|
-
resolve(finish({ outcome: 'error', exitCode: 125, error: { code: 'SCRIPT_OUTPUT_LIMIT', message: `output exceeded ${SCRIPT_OUTPUT_LIMIT_BYTES} bytes` }, stdoutPreview, stderrPreview }));
|
|
288
|
-
return;
|
|
289
|
-
}
|
|
290
|
-
if (exitCode !== 0) {
|
|
291
|
-
resolve(finish({
|
|
292
|
-
outcome: 'error',
|
|
293
|
-
exitCode,
|
|
294
|
-
error: { code: 'HANDLER_FAILED', message: stderrPreview || `exit code ${exitCode}` },
|
|
295
|
-
stdoutPreview,
|
|
296
|
-
stderrPreview,
|
|
297
|
-
}));
|
|
298
|
-
return;
|
|
299
|
-
}
|
|
300
|
-
const lines = stdout.trimEnd().split('\n').filter(line => line.trim().length > 0);
|
|
301
|
-
const lastLine = lines[lines.length - 1] ?? '';
|
|
302
|
-
if (lastLine.trimStart().startsWith(NOOP_SENTINEL)) {
|
|
303
|
-
resolve(finish({ outcome: 'noop', exitCode: 0, stdoutPreview, stderrPreview }));
|
|
304
|
-
return;
|
|
305
|
-
}
|
|
306
|
-
// 末行必须是契约 JSON:{outcome:"success",data} / {outcome:"error",error} / {outcome:"noop"}。
|
|
307
|
-
let parsed;
|
|
308
|
-
try {
|
|
309
|
-
const value = JSON.parse(lastLine);
|
|
310
|
-
if (value && typeof value === 'object' && !Array.isArray(value))
|
|
311
|
-
parsed = value;
|
|
312
|
-
}
|
|
313
|
-
catch {
|
|
314
|
-
parsed = undefined;
|
|
315
|
-
}
|
|
316
|
-
if (!parsed || typeof parsed.outcome !== 'string') {
|
|
317
|
-
resolve(finish({
|
|
318
|
-
outcome: 'error',
|
|
319
|
-
exitCode: 0,
|
|
320
|
-
error: { code: 'HANDLER_PROTOCOL', message: 'script stdout must end with a contract JSON line' },
|
|
321
|
-
stdoutPreview,
|
|
322
|
-
stderrPreview,
|
|
323
|
-
}));
|
|
324
|
-
return;
|
|
325
|
-
}
|
|
326
|
-
if (parsed.outcome === 'noop') {
|
|
327
|
-
resolve(finish({ outcome: 'noop', exitCode: 0, stdoutPreview, stderrPreview }));
|
|
328
|
-
return;
|
|
329
|
-
}
|
|
330
|
-
if (parsed.outcome === 'success') {
|
|
331
|
-
resolve(finish({ outcome: 'success', exitCode: 0, data: parsed.data, stdoutPreview, stderrPreview }));
|
|
332
|
-
return;
|
|
333
|
-
}
|
|
334
|
-
if (parsed.outcome === 'error') {
|
|
335
|
-
const error = parsed.error && typeof parsed.error === 'object' ? parsed.error : {};
|
|
336
|
-
resolve(finish({
|
|
337
|
-
outcome: 'error',
|
|
338
|
-
exitCode: 0,
|
|
339
|
-
error: {
|
|
340
|
-
code: typeof error.code === 'string' && error.code ? error.code : 'HANDLER_FAILED',
|
|
341
|
-
message: typeof error.message === 'string' ? error.message : 'handler reported an error',
|
|
342
|
-
},
|
|
343
|
-
stdoutPreview,
|
|
344
|
-
stderrPreview,
|
|
345
|
-
}));
|
|
346
|
-
return;
|
|
347
|
-
}
|
|
348
|
-
resolve(finish({
|
|
349
|
-
outcome: 'error',
|
|
350
|
-
exitCode: 0,
|
|
351
|
-
error: { code: 'HANDLER_PROTOCOL', message: `unknown outcome: ${parsed.outcome}` },
|
|
352
|
-
stdoutPreview,
|
|
353
|
-
stderrPreview,
|
|
354
|
-
}));
|
|
447
|
+
resolve(finish(settleCapturedOutput({
|
|
448
|
+
stdout,
|
|
449
|
+
stderr,
|
|
450
|
+
exitCode,
|
|
451
|
+
timedOut,
|
|
452
|
+
truncated,
|
|
453
|
+
timeoutMs: handler.timeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS,
|
|
454
|
+
...(spawnError ? { spawnError } : {}),
|
|
455
|
+
})));
|
|
355
456
|
};
|
|
356
457
|
child.on('error', error => settle(-1, error));
|
|
357
458
|
child.on('close', code => settle(typeof code === 'number' ? code : -1));
|
|
@@ -380,6 +481,255 @@ export class ServiceScriptRunner {
|
|
|
380
481
|
}
|
|
381
482
|
});
|
|
382
483
|
}
|
|
484
|
+
/**
|
|
485
|
+
* 形态 B 的调用行(常驻脚本每帧都要自带本次调用的全部上下文)。
|
|
486
|
+
*
|
|
487
|
+
* 为什么这里要重复一遍 `buildStdin` 里的字段:常驻进程的环境变量在启动时冻结,
|
|
488
|
+
* `EC_SERVICE` / `EC_REQUEST_ID` / `EC_FROM` / `EC_MESSAGE_ID` 每次调用都不同,
|
|
489
|
+
* 只能走帧。行里同时给 `workDir`,因为 `TMPDIR` 同样冻结了。
|
|
490
|
+
*/
|
|
491
|
+
buildResidentLine(callId, workDir, handler, pack, message) {
|
|
492
|
+
const identity = this.deps.identity();
|
|
493
|
+
// 调用级目录由 (workDir, callId) 确定性推导:daemon 与宿主各算一次即可,
|
|
494
|
+
// 不必逐层透传一个随时可能与 callId 不同步的字段。
|
|
495
|
+
const callDir = path.join(workDir, 'call', callId);
|
|
496
|
+
return JSON.stringify({
|
|
497
|
+
v: 1,
|
|
498
|
+
type: 'call',
|
|
499
|
+
callId,
|
|
500
|
+
service: {
|
|
501
|
+
type: message.type,
|
|
502
|
+
requestId: message.requestId,
|
|
503
|
+
from: message.fromAid,
|
|
504
|
+
messageId: message.messageId,
|
|
505
|
+
receivedAt: message.receivedAt,
|
|
506
|
+
encrypted: message.encrypted,
|
|
507
|
+
data: extractServiceData(message.payload),
|
|
508
|
+
},
|
|
509
|
+
agent: {
|
|
510
|
+
aid: this.deps.aid,
|
|
511
|
+
dir: this.deps.getProjectPath() ?? '',
|
|
512
|
+
type: identity.type,
|
|
513
|
+
exttype: identity.exttype,
|
|
514
|
+
},
|
|
515
|
+
pack: { id: pack.id, name: pack.name, dir: pack.dir },
|
|
516
|
+
handler: { script: handler.script },
|
|
517
|
+
// 两个目录,职责不同,别混:
|
|
518
|
+
//
|
|
519
|
+
// `workDir` 进程级、跨调用稳定(= 进程的 TMPDIR)。常驻脚本要放缓存、
|
|
520
|
+
// 索引、下载中间产物就放这里——包目录对它只读,这是唯一的
|
|
521
|
+
// 持久可写位置。**不要在调用结束时清空它**:并发调用正在用。
|
|
522
|
+
// `callDir` 调用级、本次独有。临时文件放这里,宿主在该调用结束后删除。
|
|
523
|
+
workDir,
|
|
524
|
+
callDir,
|
|
525
|
+
timeoutMs: handler.resident?.softTimeoutMs ?? handler.timeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS,
|
|
526
|
+
});
|
|
527
|
+
}
|
|
528
|
+
/**
|
|
529
|
+
* 降级执行常驻脚本:**每次调用起一个进程**,写一帧调用、读一行结果、杀掉。
|
|
530
|
+
*
|
|
531
|
+
* 用于 `host.enabled=false` 但 handler 声明了 `mode:"resident"`。语义上等价于
|
|
532
|
+
* 「没配常驻」——调用方拿到同样的结果,只是每次都要付一次进程启动成本。
|
|
533
|
+
*
|
|
534
|
+
* 为什么不能复用 `execute()`:那里的 stdin 是契约 JSON(`{service,message}`),
|
|
535
|
+
* 而常驻脚本等的是 `{type:'call',callId,...}` 帧。喂错契约不是"慢",是每次
|
|
536
|
+
* 调用都被判 `HANDLER_PROTOCOL`。
|
|
537
|
+
*
|
|
538
|
+
* 与宿主路径的差别只有三处,都不影响脚本契约:
|
|
539
|
+
* 1. 不做 ready 握手阻塞——进程只为这一次调用而生,整体超时已覆盖启动时间;
|
|
540
|
+
* 2. 拿到结果就杀掉进程(常驻脚本不会自己退出);
|
|
541
|
+
* 3. `workDir` 与 `callDir` 都是本次调用独有的目录(进程生命周期 = 调用生命周期)。
|
|
542
|
+
*/
|
|
543
|
+
async executeResidentOnce(launch, pack, handler, message, cmd, finish) {
|
|
544
|
+
const timeoutMs = handler.resident?.softTimeoutMs ?? handler.timeoutMs ?? DEFAULT_HANDLER_TIMEOUT_MS;
|
|
545
|
+
const callId = `svc-${randomUUID()}`;
|
|
546
|
+
// 目录:沙箱路径已经给了每调用一个的可写目录(`runDir/work`),直接用它;
|
|
547
|
+
// 无沙箱路径必须自己建——继承来的 TMPDIR 是整机共享的,用它再删会误伤别的进程。
|
|
548
|
+
let ownedDir;
|
|
549
|
+
let workDir = launch.env.TMPDIR;
|
|
550
|
+
if (launch.sandboxAbsent !== undefined || !workDir) {
|
|
551
|
+
ownedDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ec-resident-call-'));
|
|
552
|
+
workDir = ownedDir;
|
|
553
|
+
}
|
|
554
|
+
// 与宿主路径同一约定:`<workDir>/call/<callId>`,由 `buildResidentLine` 推导同一路径。
|
|
555
|
+
const callDir = path.join(workDir, 'call', callId);
|
|
556
|
+
try {
|
|
557
|
+
fs.mkdirSync(callDir, { recursive: true });
|
|
558
|
+
}
|
|
559
|
+
catch (error) {
|
|
560
|
+
return finish({
|
|
561
|
+
outcome: 'error', exitCode: 0,
|
|
562
|
+
error: { code: 'WORKDIR_UNAVAILABLE', message: errorMessage(error) },
|
|
563
|
+
stdoutPreview: '', stderrPreview: '',
|
|
564
|
+
});
|
|
565
|
+
}
|
|
566
|
+
const env = { ...launch.env, TMPDIR: workDir, TEMP: workDir, TMP: workDir };
|
|
567
|
+
const cleanupDir = () => {
|
|
568
|
+
if (!ownedDir)
|
|
569
|
+
return;
|
|
570
|
+
try {
|
|
571
|
+
fs.rmSync(ownedDir, { recursive: true, force: true });
|
|
572
|
+
}
|
|
573
|
+
catch { /* ignore */ }
|
|
574
|
+
};
|
|
575
|
+
return await new Promise(resolve => {
|
|
576
|
+
let child;
|
|
577
|
+
try {
|
|
578
|
+
child = spawn(launch.command, launch.args, {
|
|
579
|
+
cwd: launch.cwd,
|
|
580
|
+
env,
|
|
581
|
+
shell: false,
|
|
582
|
+
detached: process.platform !== 'win32',
|
|
583
|
+
windowsHide: true,
|
|
584
|
+
...(launch.windowsVerbatimArguments !== undefined ? { windowsVerbatimArguments: launch.windowsVerbatimArguments } : {}),
|
|
585
|
+
stdio: ['pipe', 'pipe', 'pipe'],
|
|
586
|
+
});
|
|
587
|
+
}
|
|
588
|
+
catch (error) {
|
|
589
|
+
cleanupDir();
|
|
590
|
+
resolve(finish({
|
|
591
|
+
outcome: 'error', exitCode: 127,
|
|
592
|
+
error: { code: 'SCRIPT_SPAWN_ERROR', message: errorMessage(error) },
|
|
593
|
+
stdoutPreview: '', stderrPreview: '',
|
|
594
|
+
}));
|
|
595
|
+
return;
|
|
596
|
+
}
|
|
597
|
+
const splitter = new FrameSplitter(RESIDENT_LINE_LIMIT_BYTES);
|
|
598
|
+
let stdoutRaw = '';
|
|
599
|
+
let stderr = '';
|
|
600
|
+
let totalBytes = 0;
|
|
601
|
+
let truncated = false;
|
|
602
|
+
let timedOut = false;
|
|
603
|
+
let killed = false;
|
|
604
|
+
let settled = false;
|
|
605
|
+
const killTree = () => {
|
|
606
|
+
if (killed)
|
|
607
|
+
return;
|
|
608
|
+
killed = true;
|
|
609
|
+
try {
|
|
610
|
+
killProcessTree(child.pid, true);
|
|
611
|
+
}
|
|
612
|
+
catch {
|
|
613
|
+
try {
|
|
614
|
+
child.kill('SIGKILL');
|
|
615
|
+
}
|
|
616
|
+
catch { /* already gone */ }
|
|
617
|
+
}
|
|
618
|
+
};
|
|
619
|
+
const settle = (outcome) => {
|
|
620
|
+
if (settled)
|
|
621
|
+
return;
|
|
622
|
+
settled = true;
|
|
623
|
+
clearTimeout(timer);
|
|
624
|
+
killTree();
|
|
625
|
+
cleanupDir();
|
|
626
|
+
resolve(finish(outcome));
|
|
627
|
+
};
|
|
628
|
+
const settleFromFrame = (frame) => {
|
|
629
|
+
const preview = stdoutRaw.slice(-512);
|
|
630
|
+
const stderrPreview = stderr.slice(-512);
|
|
631
|
+
const kind = frame.outcome;
|
|
632
|
+
if (kind === 'success') {
|
|
633
|
+
settle({ outcome: 'success', exitCode: 0, ...(frame.data !== undefined ? { data: frame.data } : {}), stdoutPreview: preview, stderrPreview });
|
|
634
|
+
return;
|
|
635
|
+
}
|
|
636
|
+
if (kind === 'noop') {
|
|
637
|
+
settle({ outcome: 'noop', exitCode: 0, stdoutPreview: preview, stderrPreview });
|
|
638
|
+
return;
|
|
639
|
+
}
|
|
640
|
+
const error = frame.error && typeof frame.error === 'object' ? frame.error : {};
|
|
641
|
+
settle({
|
|
642
|
+
outcome: kind === 'timeout' ? 'timeout' : 'error',
|
|
643
|
+
exitCode: kind === 'timeout' ? 124 : 0,
|
|
644
|
+
error: {
|
|
645
|
+
code: typeof error.code === 'string' && error.code ? error.code : (kind === 'timeout' ? 'TIMEOUT' : 'RESIDENT_FAILED'),
|
|
646
|
+
message: typeof error.message === 'string' ? error.message : 'resident handler reported an error',
|
|
647
|
+
},
|
|
648
|
+
stdoutPreview: preview,
|
|
649
|
+
stderrPreview,
|
|
650
|
+
});
|
|
651
|
+
};
|
|
652
|
+
child.stdout?.setEncoding('utf8');
|
|
653
|
+
child.stdout?.on('data', (chunk) => {
|
|
654
|
+
totalBytes += Buffer.byteLength(chunk);
|
|
655
|
+
if (totalBytes > SCRIPT_OUTPUT_LIMIT_BYTES) {
|
|
656
|
+
truncated = true;
|
|
657
|
+
settle({
|
|
658
|
+
outcome: 'error', exitCode: 125,
|
|
659
|
+
error: { code: 'SCRIPT_OUTPUT_LIMIT', message: `output exceeded ${SCRIPT_OUTPUT_LIMIT_BYTES} bytes` },
|
|
660
|
+
stdoutPreview: stdoutRaw.slice(-512), stderrPreview: stderr.slice(-512),
|
|
661
|
+
});
|
|
662
|
+
return;
|
|
663
|
+
}
|
|
664
|
+
stdoutRaw += chunk;
|
|
665
|
+
for (const line of splitter.push(chunk)) {
|
|
666
|
+
if (settled)
|
|
667
|
+
return;
|
|
668
|
+
if (!line.trim())
|
|
669
|
+
continue;
|
|
670
|
+
let frame;
|
|
671
|
+
try {
|
|
672
|
+
const parsed = JSON.parse(line);
|
|
673
|
+
if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
|
|
674
|
+
continue;
|
|
675
|
+
frame = parsed;
|
|
676
|
+
}
|
|
677
|
+
catch {
|
|
678
|
+
continue; // ready 之外的脏行:丢弃,与宿主侧同口径
|
|
679
|
+
}
|
|
680
|
+
// 只认本次调用的结果帧。ready 帧没有 callId,自然被跳过。
|
|
681
|
+
if (frame.callId !== callId)
|
|
682
|
+
continue;
|
|
683
|
+
settleFromFrame(frame);
|
|
684
|
+
return;
|
|
685
|
+
}
|
|
686
|
+
});
|
|
687
|
+
child.stderr?.setEncoding('utf8');
|
|
688
|
+
child.stderr?.on('data', (chunk) => { stderr += chunk; });
|
|
689
|
+
const timer = setTimeout(() => {
|
|
690
|
+
timedOut = true;
|
|
691
|
+
settle({
|
|
692
|
+
outcome: 'timeout', exitCode: 124,
|
|
693
|
+
error: { code: 'TIMEOUT', message: `resident call timed out after ${timeoutMs}ms` },
|
|
694
|
+
stdoutPreview: stdoutRaw.slice(-512), stderrPreview: stderr.slice(-512),
|
|
695
|
+
});
|
|
696
|
+
}, timeoutMs);
|
|
697
|
+
timer.unref?.();
|
|
698
|
+
child.on('error', error => {
|
|
699
|
+
settle({
|
|
700
|
+
outcome: 'error', exitCode: 127,
|
|
701
|
+
error: { code: 'SCRIPT_SPAWN_ERROR', message: errorMessage(error) },
|
|
702
|
+
stdoutPreview: stdoutRaw.slice(-512), stderrPreview: stderr.slice(-512),
|
|
703
|
+
});
|
|
704
|
+
});
|
|
705
|
+
child.on('close', code => {
|
|
706
|
+
// 结果帧之前就退出:如实报退出码。`settled` 已在拿到结果时拦住了这条。
|
|
707
|
+
if (timedOut)
|
|
708
|
+
return;
|
|
709
|
+
settle({
|
|
710
|
+
outcome: 'error', exitCode: typeof code === 'number' ? code : -1,
|
|
711
|
+
error: { code: 'RESIDENT_EXITED_EARLY', message: stderr.slice(-300) || `resident script exited with code ${code} before returning a result` },
|
|
712
|
+
stdoutPreview: stdoutRaw.slice(-512), stderrPreview: stderr.slice(-512),
|
|
713
|
+
});
|
|
714
|
+
});
|
|
715
|
+
// 立刻写调用帧:stdin 是管道,脚本读到 ready 之后再读也不丢。
|
|
716
|
+
//
|
|
717
|
+
// **不能 end()**:常驻脚本按契约「一行一个调用」循环读 stdin,end 会让它
|
|
718
|
+
// 立刻收到 EOF 并退出——症状是每次调用都回 `RESIDENT_EXITED_EARLY`,
|
|
719
|
+
// 而且看起来像脚本自己的 bug。进程由 `settle()` 里的 `killTree()` 收掉。
|
|
720
|
+
try {
|
|
721
|
+
child.stdin?.write(`${this.buildResidentLine(callId, workDir, handler, pack, message)}\n`);
|
|
722
|
+
}
|
|
723
|
+
catch (error) {
|
|
724
|
+
settle({
|
|
725
|
+
outcome: 'error', exitCode: 0,
|
|
726
|
+
error: { code: 'RESIDENT_WRITE_FAILED', message: errorMessage(error) },
|
|
727
|
+
stdoutPreview: '', stderrPreview: '',
|
|
728
|
+
});
|
|
729
|
+
}
|
|
730
|
+
void cmd;
|
|
731
|
+
});
|
|
732
|
+
}
|
|
383
733
|
/** 脚本契约 stdin(design.md §十一)。 */
|
|
384
734
|
buildStdin(pack, message) {
|
|
385
735
|
const identity = this.deps.identity();
|
|
@@ -395,23 +745,114 @@ export class ServiceScriptRunner {
|
|
|
395
745
|
data: extractServiceData(message.payload),
|
|
396
746
|
},
|
|
397
747
|
agent: { aid: this.deps.aid, dir: this.deps.getProjectPath() ?? '', type: identity.type, exttype: identity.exttype },
|
|
748
|
+
// 仅供脚本自描述与日志定位,**不等于可读写**:沙箱身份对 `services/` 树是 EPERM
|
|
749
|
+
// (`agents/<aid>` 根的继承 DENY(R)),ledger / logs 由 daemon 落盘。
|
|
398
750
|
paths: { ledger: pack.paths.ledger, logs: pack.paths.logsDir },
|
|
399
751
|
});
|
|
400
752
|
}
|
|
401
753
|
}
|
|
402
754
|
/**
|
|
403
|
-
*
|
|
404
|
-
* 这些字段不是调用方写的,剥掉才能让脚本只面对业务数据。
|
|
755
|
+
* 把一次执行的**原始可观测事实**判定为 `ServiceScriptOutcome`。
|
|
405
756
|
*
|
|
406
|
-
*
|
|
407
|
-
*
|
|
408
|
-
*
|
|
757
|
+
* **两条执行路径共用这一个函数**:一次性路径(daemon 直接 spawn 子进程)与宿主路径
|
|
758
|
+
* (宿主 spawn 子进程、把原始 stdout/stderr 回传)。抽出来是为了让判定只有一份实现——
|
|
759
|
+
* 如果宿主也解析一遍,两条路径的 `[[NOOP]]`、末行 JSON、截断、退出码语义必然漂移,
|
|
760
|
+
* 而漂移的表现是「同一份脚本在两种模式下结果不同」,极难排查。
|
|
761
|
+
*
|
|
762
|
+
* 纯函数:不碰时间、不碰进程、不碰文件系统,便于单测。
|
|
409
763
|
*/
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
764
|
+
export function settleCapturedOutput(input) {
|
|
765
|
+
const stdoutPreview = input.stdout.slice(-512);
|
|
766
|
+
const stderrPreview = input.stderr.slice(-512);
|
|
767
|
+
if (input.spawnError) {
|
|
768
|
+
return {
|
|
769
|
+
outcome: 'error',
|
|
770
|
+
exitCode: 127,
|
|
771
|
+
error: { code: input.hostErrorCode ?? 'SCRIPT_SPAWN_ERROR', message: input.spawnError.message },
|
|
772
|
+
stdoutPreview,
|
|
773
|
+
stderrPreview,
|
|
774
|
+
};
|
|
775
|
+
}
|
|
776
|
+
if (input.timedOut) {
|
|
777
|
+
return {
|
|
778
|
+
outcome: 'timeout',
|
|
779
|
+
exitCode: 124,
|
|
780
|
+
error: { code: 'TIMEOUT', message: `timed out after ${input.timeoutMs}ms` },
|
|
781
|
+
stdoutPreview,
|
|
782
|
+
stderrPreview,
|
|
783
|
+
};
|
|
784
|
+
}
|
|
785
|
+
if (input.truncated) {
|
|
786
|
+
return {
|
|
787
|
+
outcome: 'error',
|
|
788
|
+
exitCode: 125,
|
|
789
|
+
error: { code: 'SCRIPT_OUTPUT_LIMIT', message: `output exceeded ${SCRIPT_OUTPUT_LIMIT_BYTES} bytes` },
|
|
790
|
+
stdoutPreview,
|
|
791
|
+
stderrPreview,
|
|
792
|
+
};
|
|
793
|
+
}
|
|
794
|
+
if (input.exitCode !== 0) {
|
|
795
|
+
return {
|
|
796
|
+
outcome: 'error',
|
|
797
|
+
exitCode: input.exitCode,
|
|
798
|
+
error: { code: 'HANDLER_FAILED', message: stderrPreview || `exit code ${input.exitCode}` },
|
|
799
|
+
stdoutPreview,
|
|
800
|
+
stderrPreview,
|
|
801
|
+
};
|
|
802
|
+
}
|
|
803
|
+
const lines = input.stdout.trimEnd().split('\n').filter(line => line.trim().length > 0);
|
|
804
|
+
const lastLine = lines[lines.length - 1] ?? '';
|
|
805
|
+
if (lastLine.trimStart().startsWith(NOOP_SENTINEL)) {
|
|
806
|
+
return { outcome: 'noop', exitCode: 0, stdoutPreview, stderrPreview };
|
|
807
|
+
}
|
|
808
|
+
// 末行必须是契约 JSON:{outcome:"success",data} / {outcome:"error",error} / {outcome:"noop"}。
|
|
809
|
+
let parsed;
|
|
810
|
+
try {
|
|
811
|
+
const value = JSON.parse(lastLine);
|
|
812
|
+
if (value && typeof value === 'object' && !Array.isArray(value))
|
|
813
|
+
parsed = value;
|
|
814
|
+
}
|
|
815
|
+
catch {
|
|
816
|
+
parsed = undefined;
|
|
817
|
+
}
|
|
818
|
+
if (!parsed || typeof parsed.outcome !== 'string') {
|
|
819
|
+
return {
|
|
820
|
+
outcome: 'error',
|
|
821
|
+
exitCode: 0,
|
|
822
|
+
error: { code: 'HANDLER_PROTOCOL', message: 'script stdout must end with a contract JSON line' },
|
|
823
|
+
stdoutPreview,
|
|
824
|
+
stderrPreview,
|
|
825
|
+
};
|
|
826
|
+
}
|
|
827
|
+
if (parsed.outcome === 'noop') {
|
|
828
|
+
return { outcome: 'noop', exitCode: 0, stdoutPreview, stderrPreview };
|
|
829
|
+
}
|
|
830
|
+
if (parsed.outcome === 'success') {
|
|
831
|
+
return { outcome: 'success', exitCode: 0, data: parsed.data, stdoutPreview, stderrPreview };
|
|
832
|
+
}
|
|
833
|
+
if (parsed.outcome === 'error') {
|
|
834
|
+
const error = parsed.error && typeof parsed.error === 'object' ? parsed.error : {};
|
|
835
|
+
return {
|
|
836
|
+
outcome: 'error',
|
|
837
|
+
exitCode: 0,
|
|
838
|
+
error: {
|
|
839
|
+
code: typeof error.code === 'string' && error.code ? error.code : 'HANDLER_FAILED',
|
|
840
|
+
message: typeof error.message === 'string' ? error.message : 'handler reported an error',
|
|
841
|
+
},
|
|
842
|
+
stdoutPreview,
|
|
843
|
+
stderrPreview,
|
|
844
|
+
};
|
|
845
|
+
}
|
|
846
|
+
return {
|
|
847
|
+
outcome: 'error',
|
|
848
|
+
exitCode: 0,
|
|
849
|
+
error: { code: 'HANDLER_PROTOCOL', message: `unknown outcome: ${parsed.outcome}` },
|
|
850
|
+
stdoutPreview,
|
|
851
|
+
stderrPreview,
|
|
852
|
+
};
|
|
853
|
+
}
|
|
854
|
+
// 传输层字段名单移到 service-payload:调用侧也要用它做「可能被剥离」的提示,
|
|
855
|
+
// 两处各写一份必然漂移。说明见该常量的注释。
|
|
415
856
|
/**
|
|
416
857
|
* 脚本看到的 data:去掉传输层字段,其余原样。
|
|
417
858
|
* 不把整条 payload 交给脚本,避免它依赖 daemon 的内部字段。
|