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
|
@@ -0,0 +1,397 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 服务常驻宿主程序。
|
|
3
|
+
*
|
|
4
|
+
* 设计稿:`docs/services/resident-mode.md` §三、§4.1、§五。
|
|
5
|
+
*
|
|
6
|
+
* 由 daemon 以 `node <program>/main.js` 拉起(在沙箱内),之后长期存活。
|
|
7
|
+
* 一个 agent 一个实例,服务该 agent 的全部服务包。
|
|
8
|
+
*
|
|
9
|
+
* ## 只做四件事
|
|
10
|
+
*
|
|
11
|
+
* 1. 从 stdin 读换行分隔的帧;
|
|
12
|
+
* 2. `call` 帧 → 异步 spawn 一个子进程,按 `callId` 记账,**不阻塞**接收下一帧;
|
|
13
|
+
* 3. 子进程结束 / 超时 → 写一条 `result` 帧;
|
|
14
|
+
* 4. `ping` → 立刻回 `pong`;stdin EOF → 终止全部子进程并在 5 秒内退出。
|
|
15
|
+
*
|
|
16
|
+
* ## 刻意不做的事
|
|
17
|
+
*
|
|
18
|
+
* - **不解析脚本 stdout 的语义**。末行 JSON、`[[NOOP]]`、`HANDLER_PROTOCOL` 判定全部留在
|
|
19
|
+
* daemon 侧(`script-runner`),与一次性路径共用一份实现。宿主只搬运原始文本。
|
|
20
|
+
* - **不认识 `EC_*`**。环境变量由 daemon 算好整个传下来。
|
|
21
|
+
* - **不做业务级重试**。失败就是失败,重试是调用方的事。
|
|
22
|
+
*
|
|
23
|
+
* ## 硬约束
|
|
24
|
+
*
|
|
25
|
+
* - **不许有同步阻塞 I/O**:一旦阻塞事件循环,保活 ping 就会排队,daemon 会把一个健康的
|
|
26
|
+
* 宿主判成卡死并重启(连带杀掉在途调用)。所以本文件里没有任何 `*Sync` 调用。
|
|
27
|
+
* - **stdout 只写帧**,任何诊断信息走 stderr。
|
|
28
|
+
*/
|
|
29
|
+
import { spawn } from 'node:child_process';
|
|
30
|
+
import fs from 'node:fs';
|
|
31
|
+
import path from 'node:path';
|
|
32
|
+
import { CHILD_OUTPUT_LIMIT_BYTES, FrameSplitter, HOST_PROGRAM_VERSION, encodeFrame, decodeFrame, } from './protocol.js';
|
|
33
|
+
import { ResidentHost, RESIDENT_HARD_TIMEOUT_AFTER } from './resident.js';
|
|
34
|
+
/** 收到 EOF 后的自毁期限。防某个卡住的子进程把宿主拖住不退。 */
|
|
35
|
+
const EOF_SELF_DESTRUCT_MS = 5000;
|
|
36
|
+
/**
|
|
37
|
+
* 自省采样周期。
|
|
38
|
+
*
|
|
39
|
+
* 10 秒足够让 daemon 在「泄漏已经明显」时及时介入,又不会让长跑宿主产生可观测的
|
|
40
|
+
* 额外开销(一次采样是三个同步 API,微秒级)。
|
|
41
|
+
*/
|
|
42
|
+
const STATS_INTERVAL_MS = 10_000;
|
|
43
|
+
/**
|
|
44
|
+
* 采样周期的运行时覆盖。
|
|
45
|
+
*
|
|
46
|
+
* 只为两件事存在:运维现场调参与自动化测试(等 10 秒一次的采样在测试里不可接受)。
|
|
47
|
+
* 非法值静默回落到默认——采样周期配错不该让宿主起不来。
|
|
48
|
+
*/
|
|
49
|
+
function statsIntervalMs() {
|
|
50
|
+
const raw = Number(process.env.EVOLCORE_HOST_STATS_MS);
|
|
51
|
+
return Number.isFinite(raw) && raw >= 100 ? Math.min(raw, 600_000) : STATS_INTERVAL_MS;
|
|
52
|
+
}
|
|
53
|
+
/** 统计口径。 */
|
|
54
|
+
let callsCompleted = 0;
|
|
55
|
+
const inFlight = new Map();
|
|
56
|
+
let shuttingDown = false;
|
|
57
|
+
/** 形态 B 的常驻子进程池(每个 residentKey 一个进程)。 */
|
|
58
|
+
const resident = new ResidentHost({ log: message => logToStderr(message) });
|
|
59
|
+
/** 写一帧到 stdout。只在这里碰 stdout,别处一律 stderr。 */
|
|
60
|
+
function writeFrame(frame) {
|
|
61
|
+
if (shuttingDown && frame.t !== 'result')
|
|
62
|
+
return;
|
|
63
|
+
try {
|
|
64
|
+
process.stdout.write(encodeFrame(frame));
|
|
65
|
+
}
|
|
66
|
+
catch {
|
|
67
|
+
// stdout 已关闭(daemon 退出了):没什么可做的,自毁定时器会收尾。
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
function logToStderr(message) {
|
|
71
|
+
try {
|
|
72
|
+
process.stderr.write(`[host] ${message}\n`);
|
|
73
|
+
}
|
|
74
|
+
catch {
|
|
75
|
+
/* ignore */
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
/** 杀掉子进程。Windows 上没有进程组信号,用 kill 逐个尽力而为。 */
|
|
79
|
+
function killChild(child) {
|
|
80
|
+
try {
|
|
81
|
+
if (child.pid) {
|
|
82
|
+
child.kill('SIGKILL');
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
catch {
|
|
86
|
+
/* already gone */
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* 逐块累积输出,超过上限就标记并杀进程。
|
|
91
|
+
*
|
|
92
|
+
* 与 `script-runner` 的口径一致:**超限是失败,不是截断**(截断会让脚本以为成功)。
|
|
93
|
+
*/
|
|
94
|
+
function accumulate(state, chunk) {
|
|
95
|
+
if (state.truncated)
|
|
96
|
+
return;
|
|
97
|
+
state.bytes += chunk.length;
|
|
98
|
+
if (state.bytes > CHILD_OUTPUT_LIMIT_BYTES) {
|
|
99
|
+
state.truncated = true;
|
|
100
|
+
killChild(state.child);
|
|
101
|
+
return;
|
|
102
|
+
}
|
|
103
|
+
const text = chunk.toString('utf8');
|
|
104
|
+
// 只保留前 1 MiB:即使超限,也要回传已收集的部分做 preview。
|
|
105
|
+
if (state.stdout.length < CHILD_OUTPUT_LIMIT_BYTES)
|
|
106
|
+
state.stdout += text;
|
|
107
|
+
}
|
|
108
|
+
function settle(callId, exitCode, spawnError) {
|
|
109
|
+
const state = inFlight.get(callId);
|
|
110
|
+
if (!state || state.settled)
|
|
111
|
+
return;
|
|
112
|
+
state.settled = true;
|
|
113
|
+
clearTimeout(state.timer);
|
|
114
|
+
inFlight.delete(callId);
|
|
115
|
+
const durationMs = Date.now() - state.startedAt;
|
|
116
|
+
callsCompleted += 1;
|
|
117
|
+
const frame = {
|
|
118
|
+
t: 'result',
|
|
119
|
+
callId,
|
|
120
|
+
outcome: 'success',
|
|
121
|
+
stdout: state.stdout,
|
|
122
|
+
stderr: state.stderr,
|
|
123
|
+
exitCode,
|
|
124
|
+
durationMs,
|
|
125
|
+
timedOut: state.timedOut,
|
|
126
|
+
};
|
|
127
|
+
if (spawnError) {
|
|
128
|
+
frame.outcome = 'error';
|
|
129
|
+
frame.hostError = { code: 'SCRIPT_SPAWN_ERROR', message: spawnError.message };
|
|
130
|
+
}
|
|
131
|
+
else if (state.timedOut) {
|
|
132
|
+
frame.outcome = 'timeout';
|
|
133
|
+
}
|
|
134
|
+
else if (state.truncated) {
|
|
135
|
+
frame.outcome = 'error';
|
|
136
|
+
frame.truncated = true;
|
|
137
|
+
frame.hostError = { code: 'SCRIPT_OUTPUT_LIMIT', message: `output exceeded ${CHILD_OUTPUT_LIMIT_BYTES} bytes` };
|
|
138
|
+
}
|
|
139
|
+
else if (exitCode !== 0) {
|
|
140
|
+
frame.outcome = 'error';
|
|
141
|
+
}
|
|
142
|
+
writeFrame(frame);
|
|
143
|
+
// 临时目录删除不能阻塞主流程:失败的清理只记日志(下次启动会扫残留)。
|
|
144
|
+
fs.rm(state.workDir, { recursive: true, force: true }, error => {
|
|
145
|
+
if (error)
|
|
146
|
+
logToStderr(`workDir cleanup failed for ${callId}: ${error.message}`);
|
|
147
|
+
});
|
|
148
|
+
}
|
|
149
|
+
function handleCall(frame) {
|
|
150
|
+
if (shuttingDown)
|
|
151
|
+
return;
|
|
152
|
+
if (frame.mode === 'resident') {
|
|
153
|
+
void handleResidentCall(frame);
|
|
154
|
+
return;
|
|
155
|
+
}
|
|
156
|
+
let child;
|
|
157
|
+
try {
|
|
158
|
+
// 每个调用一个独立临时目录,落在 daemon 给的 workDir 下(它是策略里唯一可写的路径)。
|
|
159
|
+
fs.mkdirSync(frame.workDir, { recursive: true });
|
|
160
|
+
}
|
|
161
|
+
catch (error) {
|
|
162
|
+
writeFrame({
|
|
163
|
+
t: 'result', callId: frame.callId, outcome: 'error',
|
|
164
|
+
stdout: '', stderr: '', exitCode: 0, durationMs: 0, timedOut: false,
|
|
165
|
+
hostError: { code: 'WORKDIR_UNAVAILABLE', message: error.message },
|
|
166
|
+
});
|
|
167
|
+
return;
|
|
168
|
+
}
|
|
169
|
+
try {
|
|
170
|
+
child = spawn(frame.runtime, [frame.scriptPath, ...frame.args], {
|
|
171
|
+
cwd: frame.cwd,
|
|
172
|
+
env: {
|
|
173
|
+
...frame.env,
|
|
174
|
+
// 临时目录三件套指向本次调用自己的目录。
|
|
175
|
+
TMPDIR: frame.workDir, TEMP: frame.workDir, TMP: frame.workDir,
|
|
176
|
+
},
|
|
177
|
+
stdio: ['pipe', 'pipe', 'pipe'],
|
|
178
|
+
windowsHide: true,
|
|
179
|
+
shell: false,
|
|
180
|
+
});
|
|
181
|
+
}
|
|
182
|
+
catch (error) {
|
|
183
|
+
fs.rm(frame.workDir, { recursive: true, force: true }, () => { });
|
|
184
|
+
writeFrame({
|
|
185
|
+
t: 'result', callId: frame.callId, outcome: 'error',
|
|
186
|
+
stdout: '', stderr: '', exitCode: 0, durationMs: 0, timedOut: false,
|
|
187
|
+
hostError: { code: 'SCRIPT_SPAWN_ERROR', message: error.message },
|
|
188
|
+
});
|
|
189
|
+
return;
|
|
190
|
+
}
|
|
191
|
+
const state = {
|
|
192
|
+
child,
|
|
193
|
+
timer: setTimeout(() => {
|
|
194
|
+
state.timedOut = true;
|
|
195
|
+
killChild(child);
|
|
196
|
+
}, frame.timeoutMs),
|
|
197
|
+
startedAt: Date.now(),
|
|
198
|
+
stdout: '',
|
|
199
|
+
stderr: '',
|
|
200
|
+
bytes: 0,
|
|
201
|
+
truncated: false,
|
|
202
|
+
timedOut: false,
|
|
203
|
+
settled: false,
|
|
204
|
+
workDir: frame.workDir,
|
|
205
|
+
};
|
|
206
|
+
state.timer.unref?.();
|
|
207
|
+
inFlight.set(frame.callId, state);
|
|
208
|
+
child.stdout?.on('data', (chunk) => accumulate(state, chunk));
|
|
209
|
+
child.stderr?.on('data', (chunk) => {
|
|
210
|
+
if (state.stderr.length < CHILD_OUTPUT_LIMIT_BYTES / 4)
|
|
211
|
+
state.stderr += chunk.toString('utf8');
|
|
212
|
+
});
|
|
213
|
+
child.on('error', error => settle(frame.callId, -1, error));
|
|
214
|
+
child.on('close', code => settle(frame.callId, typeof code === 'number' ? code : -1));
|
|
215
|
+
// 契约 JSON 已在 daemon 侧序列化好;写失败(进程早退)由 close 兜底。
|
|
216
|
+
try {
|
|
217
|
+
child.stdin?.on('error', () => { });
|
|
218
|
+
child.stdin?.end(frame.stdin);
|
|
219
|
+
}
|
|
220
|
+
catch {
|
|
221
|
+
/* ignore */
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
/**
|
|
225
|
+
* 形态 B 的一次调用。
|
|
226
|
+
*
|
|
227
|
+
* 调用行由 daemon 拼好传下来(含 `callId` 与本次 `EC_*` 等价字段),这里只负责投递
|
|
228
|
+
* 与把结果映射成统一的 ResultFrame——与形态 A 共用同一套 daemon 侧判定。
|
|
229
|
+
*/
|
|
230
|
+
async function handleResidentCall(frame) {
|
|
231
|
+
const startedAt = Date.now();
|
|
232
|
+
const key = frame.residentKey ?? `${frame.scriptPath}`;
|
|
233
|
+
try {
|
|
234
|
+
const result = await resident.call({
|
|
235
|
+
key,
|
|
236
|
+
runtime: frame.runtime,
|
|
237
|
+
scriptPath: frame.scriptPath,
|
|
238
|
+
args: frame.args,
|
|
239
|
+
env: frame.env,
|
|
240
|
+
cwd: frame.cwd,
|
|
241
|
+
workDir: frame.workDir,
|
|
242
|
+
line: frame.residentLine ?? '',
|
|
243
|
+
callId: frame.callId,
|
|
244
|
+
softTimeoutMs: frame.timeoutMs,
|
|
245
|
+
hardTimeoutAfter: frame.hardTimeoutAfter ?? RESIDENT_HARD_TIMEOUT_AFTER,
|
|
246
|
+
...(frame.residentStartTimeoutMs ? { startTimeoutMs: frame.residentStartTimeoutMs } : {}),
|
|
247
|
+
});
|
|
248
|
+
const resultFrame = {
|
|
249
|
+
t: 'result',
|
|
250
|
+
callId: frame.callId,
|
|
251
|
+
outcome: result.outcome === 'timeout' ? 'timeout' : result.outcome,
|
|
252
|
+
// 形态 B 不走 stdout 文本:脚本回的就是结构化正文,宿主已经解析过。
|
|
253
|
+
stdout: '',
|
|
254
|
+
stderr: '',
|
|
255
|
+
exitCode: 0,
|
|
256
|
+
durationMs: result.durationMs,
|
|
257
|
+
timedOut: result.timedOut,
|
|
258
|
+
resident: true,
|
|
259
|
+
...(result.payload !== undefined ? { data: result.payload } : {}),
|
|
260
|
+
// 脚本自己报的业务错误(`outcome:error` + error 字段)不是宿主故障,
|
|
261
|
+
// 不能塞进 `hostError`——那会让 daemon 判成「脚本没起来」。
|
|
262
|
+
...(result.hostError ? { hostError: result.hostError } : {}),
|
|
263
|
+
...(!result.hostError && result.error && result.outcome !== 'success'
|
|
264
|
+
? { scriptError: result.error }
|
|
265
|
+
: {}),
|
|
266
|
+
};
|
|
267
|
+
writeFrame(resultFrame);
|
|
268
|
+
}
|
|
269
|
+
catch (error) {
|
|
270
|
+
writeFrame({
|
|
271
|
+
t: 'result', callId: frame.callId, outcome: 'error',
|
|
272
|
+
stdout: '', stderr: '', exitCode: 0, durationMs: Date.now() - startedAt, timedOut: false,
|
|
273
|
+
resident: true,
|
|
274
|
+
hostError: { code: 'RESIDENT_UNAVAILABLE', message: error.message },
|
|
275
|
+
});
|
|
276
|
+
}
|
|
277
|
+
finally {
|
|
278
|
+
// 与形态 A 的 `settle()` 同口径:不管成败都算完成一次。
|
|
279
|
+
// 漏掉这里的话,常驻路径的调用在自省快照里完全不可见(callsCompleted 恒为 0),
|
|
280
|
+
// 运维看到的是一个"永不接活"的宿主。
|
|
281
|
+
callsCompleted += 1;
|
|
282
|
+
}
|
|
283
|
+
}
|
|
284
|
+
function shutdown(reason) {
|
|
285
|
+
if (shuttingDown)
|
|
286
|
+
return;
|
|
287
|
+
shuttingDown = true;
|
|
288
|
+
logToStderr(`shutting down: ${reason}`);
|
|
289
|
+
resident.killAll('host shutting down');
|
|
290
|
+
for (const [callId, state] of inFlight) {
|
|
291
|
+
killChild(state.child);
|
|
292
|
+
settle(callId, -1);
|
|
293
|
+
}
|
|
294
|
+
// 自毁兜底:即使某个子进程杀不掉也不拖住进程。
|
|
295
|
+
const timer = setTimeout(() => process.exit(0), EOF_SELF_DESTRUCT_MS);
|
|
296
|
+
timer.unref?.();
|
|
297
|
+
process.exit(0);
|
|
298
|
+
}
|
|
299
|
+
function main() {
|
|
300
|
+
// 启动时清理上一次被强杀留下的临时目录(宿主可能整进程被 kill,来不及删)。
|
|
301
|
+
try {
|
|
302
|
+
const parent = process.env.EVOLCORE_HOST_WORKDIR;
|
|
303
|
+
if (parent) {
|
|
304
|
+
const callsRoot = path.join(parent, 'services-call');
|
|
305
|
+
if (fs.existsSync(callsRoot)) {
|
|
306
|
+
for (const entry of fs.readdirSync(callsRoot)) {
|
|
307
|
+
fs.rmSync(path.join(callsRoot, entry), { recursive: true, force: true });
|
|
308
|
+
}
|
|
309
|
+
}
|
|
310
|
+
}
|
|
311
|
+
}
|
|
312
|
+
catch (error) {
|
|
313
|
+
logToStderr(`stale workDir sweep failed: ${error.message}`);
|
|
314
|
+
}
|
|
315
|
+
writeFrame({ t: 'ready', programVersion: HOST_PROGRAM_VERSION, pid: process.pid });
|
|
316
|
+
/**
|
|
317
|
+
* 自省采样。
|
|
318
|
+
*
|
|
319
|
+
* 三项指标各有分工(设计稿 3.8.2):
|
|
320
|
+
* - `rss`:**粗粒度**,GC 会让它来回跳,所以判据要看「超基线 2 倍」而不是绝对值;
|
|
321
|
+
* - `handles`:**最灵敏**的泄漏信号——`getActiveResourcesInfo` 数的是活跃句柄,
|
|
322
|
+
* 没清的定时器/没关的 socket 会立刻反映出来,且不会像 rss 那样抖;
|
|
323
|
+
* - `idleCpuPercent`:空闲时应当接近 0;明显大于 0 说明有空转定时器或轮询。
|
|
324
|
+
*
|
|
325
|
+
* CPU 用「两次采样之间的增量 / 经过时间」,所以第一轮没有基准、跳过。
|
|
326
|
+
*/
|
|
327
|
+
/**
|
|
328
|
+
* CPU 度量窗口。
|
|
329
|
+
*
|
|
330
|
+
* **不能拿采样间隔当窗口**:间隔短于 1 秒时,一次 GC 或一次定时器抖动就能让
|
|
331
|
+
* 单次读数虚高到 10%以上,把健康的空闲宿主判成"空转定时器"。
|
|
332
|
+
* 所以固定用不少于 1 秒的窗口,采样间隔再短也不缩窗口。
|
|
333
|
+
*/
|
|
334
|
+
const CPU_WINDOW_MS = Math.max(1000, statsIntervalMs());
|
|
335
|
+
let lastCpu = process.cpuUsage();
|
|
336
|
+
let lastSampleAt = Date.now();
|
|
337
|
+
const statsTimer = setInterval(() => {
|
|
338
|
+
if (shuttingDown)
|
|
339
|
+
return;
|
|
340
|
+
const now = Date.now();
|
|
341
|
+
const elapsedMs = now - lastSampleAt;
|
|
342
|
+
// 窗口不足就不出数:宁可少报一次,也不报一个不准的数字。
|
|
343
|
+
if (elapsedMs < CPU_WINDOW_MS)
|
|
344
|
+
return;
|
|
345
|
+
const cpu = process.cpuUsage(lastCpu);
|
|
346
|
+
lastCpu = process.cpuUsage();
|
|
347
|
+
lastSampleAt = now;
|
|
348
|
+
const cpuMs = (cpu.user + cpu.system) / 1000;
|
|
349
|
+
writeFrame({
|
|
350
|
+
t: 'stats',
|
|
351
|
+
stats: {
|
|
352
|
+
uptimeMs: Math.round(process.uptime() * 1000),
|
|
353
|
+
rss: process.memoryUsage().rss,
|
|
354
|
+
handles: process.getActiveResourcesInfo().length,
|
|
355
|
+
idleCpuPercent: Math.round(Math.min(100, (cpuMs / elapsedMs) * 100) * 10) / 10,
|
|
356
|
+
// 在途 = 一次性子进程 + 常驻进程里等结果的调用。只算 `inFlight.size` 会让
|
|
357
|
+
// 纯常驻包在 status 上永远显示 0 在途,泄漏判据也随之失真。
|
|
358
|
+
inFlight: inFlight.size + resident.inFlight,
|
|
359
|
+
callsCompleted,
|
|
360
|
+
resident: { processes: resident.size, ...resident.drops },
|
|
361
|
+
},
|
|
362
|
+
});
|
|
363
|
+
}, Math.min(statsIntervalMs(), 1000));
|
|
364
|
+
statsTimer.unref?.();
|
|
365
|
+
const splitter = new FrameSplitter();
|
|
366
|
+
process.stdin.setEncoding('utf8');
|
|
367
|
+
process.stdin.on('data', (chunk) => {
|
|
368
|
+
for (const line of splitter.push(chunk)) {
|
|
369
|
+
const frame = decodeFrame(line);
|
|
370
|
+
if (!frame) {
|
|
371
|
+
logToStderr('dropped a line that is not a frame');
|
|
372
|
+
continue;
|
|
373
|
+
}
|
|
374
|
+
if (frame.t === 'ping') {
|
|
375
|
+
// 必须同步立刻回:这是保活判据,任何排队都会被 daemon 判成卡死。
|
|
376
|
+
writeFrame({ t: 'pong', seq: frame.seq });
|
|
377
|
+
}
|
|
378
|
+
else if (frame.t === 'call') {
|
|
379
|
+
handleCall(frame);
|
|
380
|
+
}
|
|
381
|
+
else {
|
|
382
|
+
logToStderr(`ignored frame type ${frame.t}`);
|
|
383
|
+
}
|
|
384
|
+
}
|
|
385
|
+
});
|
|
386
|
+
process.stdin.on('end', () => shutdown('stdin EOF'));
|
|
387
|
+
process.stdin.on('error', () => shutdown('stdin error'));
|
|
388
|
+
// 进程级兜底:任何未捕获异常都不能让宿主静默消失——先回报再退,daemon 才好重启。
|
|
389
|
+
process.on('uncaughtException', error => {
|
|
390
|
+
logToStderr(`uncaughtException: ${error.stack ?? error.message}`);
|
|
391
|
+
shutdown('uncaughtException');
|
|
392
|
+
});
|
|
393
|
+
process.on('unhandledRejection', error => {
|
|
394
|
+
logToStderr(`unhandledRejection: ${String(error)}`);
|
|
395
|
+
});
|
|
396
|
+
}
|
|
397
|
+
main();
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 常驻宿主模式的帧协议:daemon ↔ 宿主之间**换行分隔 JSON**(JSON Lines)。
|
|
3
|
+
*
|
|
4
|
+
* 设计稿:`docs/services/resident-mode.md` §五。
|
|
5
|
+
*
|
|
6
|
+
* ## 为什么是 JSON Lines
|
|
7
|
+
*
|
|
8
|
+
* `JSON.stringify` 的出口不会产生裸换行(字符串里的 `\n` 已被转义成 `\\n`),所以
|
|
9
|
+
* 「一行一帧」天然无歧义,不需要长度前缀或分隔符协商。代价是任何**非帧**输出都会破坏
|
|
10
|
+
* 流,因此约定:**宿主 stdout 只写帧,日志一律走 stderr**。
|
|
11
|
+
*
|
|
12
|
+
* ## 分工(重要)
|
|
13
|
+
*
|
|
14
|
+
* 本协议刻意让宿主"哑":
|
|
15
|
+
*
|
|
16
|
+
* - `call` 帧里的 `stdin` 是**已经序列化好的契约 JSON 字符串**,宿主原样写进子进程 stdin,
|
|
17
|
+
* 不解析、不改造。`EC_*` 环境变量同理,由 daemon 算好后整个 `env` 传下来。
|
|
18
|
+
* 这样宿主不认识任何业务语义,宿主升级不会改变调用行为。
|
|
19
|
+
* - `result` 帧回传**原始 stdout/stderr 文本**,末行 JSON 解析、`[[NOOP]]` 判定、
|
|
20
|
+
* 1 MB 截断全部留在 daemon 侧(`script-runner`),与一次性路径共用同一份实现。
|
|
21
|
+
* 如果宿主也解析一遍,两条路径的判定就必然漂移。
|
|
22
|
+
*/
|
|
23
|
+
/** 单帧上限。超过即判该帧非法;**不因此杀宿主**(宿主是长跑进程)。 */
|
|
24
|
+
export const HOST_FRAME_LIMIT_BYTES = 2 * 1024 * 1024;
|
|
25
|
+
/** 子进程 stdout/stderr 合计上限,与 `script-runner` 的 1 MiB 同口径。 */
|
|
26
|
+
export const CHILD_OUTPUT_LIMIT_BYTES = 1024 * 1024;
|
|
27
|
+
/** 序列化成一帧(含换行)。 */
|
|
28
|
+
export function encodeFrame(frame) {
|
|
29
|
+
return `${JSON.stringify(frame)}\n`;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* 解析一行。
|
|
33
|
+
*
|
|
34
|
+
* 返回 `undefined` 表示**这一行不是合法帧**(空行、非 JSON、非对象、缺 `t`、`t` 不认识)。
|
|
35
|
+
* 调用方必须能容忍这种行:宿主可能写了半行、也可能被打上了第三方库的调试输出,
|
|
36
|
+
* 任何一次都**不该**判死宿主——连续多次才判协议破坏(由调用方计数)。
|
|
37
|
+
*/
|
|
38
|
+
export function decodeFrame(line) {
|
|
39
|
+
const text = line.trim();
|
|
40
|
+
if (!text)
|
|
41
|
+
return undefined;
|
|
42
|
+
let value;
|
|
43
|
+
try {
|
|
44
|
+
value = JSON.parse(text);
|
|
45
|
+
}
|
|
46
|
+
catch {
|
|
47
|
+
return undefined;
|
|
48
|
+
}
|
|
49
|
+
if (!value || typeof value !== 'object' || Array.isArray(value))
|
|
50
|
+
return undefined;
|
|
51
|
+
const record = value;
|
|
52
|
+
const type = record.t;
|
|
53
|
+
if (type !== 'ping' && type !== 'pong' && type !== 'call'
|
|
54
|
+
&& type !== 'result' && type !== 'ready' && type !== 'log' && type !== 'stats') {
|
|
55
|
+
return undefined;
|
|
56
|
+
}
|
|
57
|
+
return record;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* 增量帧切分器。
|
|
61
|
+
*
|
|
62
|
+
* 换行分隔的流式解析不能假设「一次 data 事件正好一行」:管道会任意切块。这个类维护
|
|
63
|
+
* 一个残buffer,只在见到 `\n` 时吐出一行。
|
|
64
|
+
*
|
|
65
|
+
* **超长行的处理**:超过 `HOST_FRAME_LIMIT_BYTES` 仍未见换行,说明对端在写一条非法
|
|
66
|
+
* 巨型帧——直接丢弃到下一个换行,并回一个 `undefined` + 计数,而不是无限堆内存。
|
|
67
|
+
*/
|
|
68
|
+
export class FrameSplitter {
|
|
69
|
+
limitBytes;
|
|
70
|
+
buffer = '';
|
|
71
|
+
overflowing = false;
|
|
72
|
+
/** 因超长被丢弃的行数,宿主与 daemon 两侧都可以读它做告警。 */
|
|
73
|
+
droppedForSize = 0;
|
|
74
|
+
constructor(limitBytes = HOST_FRAME_LIMIT_BYTES) {
|
|
75
|
+
this.limitBytes = limitBytes;
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* 投喂一段文本,返回其中完整的行。
|
|
79
|
+
*
|
|
80
|
+
* 返回的数组里**只包含已确认完整的行**;末尾不完整的一段留在内部 buffer 里等下一次。
|
|
81
|
+
*/
|
|
82
|
+
push(chunk) {
|
|
83
|
+
this.buffer += chunk;
|
|
84
|
+
const lines = [];
|
|
85
|
+
let index;
|
|
86
|
+
while ((index = this.buffer.indexOf('\n')) >= 0) {
|
|
87
|
+
const line = this.buffer.slice(0, index);
|
|
88
|
+
this.buffer = this.buffer.slice(index + 1);
|
|
89
|
+
if (this.overflowing) {
|
|
90
|
+
// 这一行的前半段已因超长被丢弃,整行作废。
|
|
91
|
+
this.overflowing = false;
|
|
92
|
+
continue;
|
|
93
|
+
}
|
|
94
|
+
lines.push(line);
|
|
95
|
+
}
|
|
96
|
+
if (!this.overflowing && this.buffer.length > this.limitBytes) {
|
|
97
|
+
this.droppedForSize += 1;
|
|
98
|
+
this.overflowing = true;
|
|
99
|
+
this.buffer = '';
|
|
100
|
+
}
|
|
101
|
+
else if (this.overflowing) {
|
|
102
|
+
this.buffer = '';
|
|
103
|
+
}
|
|
104
|
+
return lines;
|
|
105
|
+
}
|
|
106
|
+
/** 流结束时取出残余(无换行结尾的最后一行)。 */
|
|
107
|
+
flush() {
|
|
108
|
+
const rest = this.buffer;
|
|
109
|
+
this.buffer = '';
|
|
110
|
+
if (this.overflowing) {
|
|
111
|
+
this.overflowing = false;
|
|
112
|
+
return [];
|
|
113
|
+
}
|
|
114
|
+
return rest ? [rest] : [];
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* 宿主程序版本。部署路径用它做目录名,ready 帧用它让 daemon 判断是否需要重启。
|
|
119
|
+
*
|
|
120
|
+
* **改了宿主程序行为就要升版本**:已部署的旧进程只有在版本不一致时才会被换掉,
|
|
121
|
+
* 不升版本的话新代码要等旧进程自然退出(空闲回收 / 崩溃)才可能生效。
|
|
122
|
+
*
|
|
123
|
+
* 历史:`1` 初版;`2` 补齐常驻侧自省(callsCompleted / inFlight / 丢帧计数)。
|
|
124
|
+
*/
|
|
125
|
+
export const HOST_PROGRAM_VERSION = '2';
|