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,117 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 宿主进程的沙箱启动配置。
|
|
3
|
+
*
|
|
4
|
+
* 设计稿:`docs/services/resident-mode.md` §3.2、§六。
|
|
5
|
+
*
|
|
6
|
+
* ## 为什么复用 `buildTriggerScriptLaunch` 而不是新写一套策略
|
|
7
|
+
*
|
|
8
|
+
* 宿主程序在沙箱看来**就是一个脚本**:它有一个入口文件、需要被暂存到运行目录、
|
|
9
|
+
* 需要一个可写的 workDir、需要读自己的程序目录。区别只有两点:
|
|
10
|
+
*
|
|
11
|
+
* 1. 它有第二个能力——spawn 子进程(而脚本不 spawn);
|
|
12
|
+
* 2. 它的探针必须验证**孙进程**也在围栏里,而脚本的探针只验直接子进程。
|
|
13
|
+
*
|
|
14
|
+
* 第 1 点不需要任何策略改动:沙箱是加在宿主进程上的,子进程继承(已实测 EPERM)。
|
|
15
|
+
* 第 2 点只需要换探针,不需要换策略。所以本模块只做两件事:构造合成 trigger、指定探针。
|
|
16
|
+
*
|
|
17
|
+
* **绝不能另写一套策略构造**:两份策略必然漂移,而漂移的表现是「某条 deny 悄悄没了」,
|
|
18
|
+
* 这是最难发现、后果最严重的一类缺陷。
|
|
19
|
+
*/
|
|
20
|
+
import path from 'node:path';
|
|
21
|
+
import { buildTriggerScriptLaunch, } from '../trigger/script-sandbox.js';
|
|
22
|
+
import { isCredentialEnvironmentName, sanitizeShellExecutionEnvironment } from '../core/permission/shell-environment.js';
|
|
23
|
+
import { resolvePhaseOneExecutionSandbox } from '../core/permission/mode.js';
|
|
24
|
+
/**
|
|
25
|
+
* 合成一个「宿主」trigger。
|
|
26
|
+
*
|
|
27
|
+
* 只用于喂给沙箱构造函数——它不是真实的 trigger,不落盘、不进 trigger 列表。
|
|
28
|
+
* `id` 里带 version,使无沙箱路径的日志能看出在跑哪个宿主版本。
|
|
29
|
+
*/
|
|
30
|
+
function syntheticHostTrigger(input, executable) {
|
|
31
|
+
return {
|
|
32
|
+
$schema_version: 3.1,
|
|
33
|
+
id: `services-host:${input.aid}:${path.basename(input.programDir)}`,
|
|
34
|
+
agentAid: input.aid,
|
|
35
|
+
name: '服务常驻宿主',
|
|
36
|
+
enabled: true,
|
|
37
|
+
createdAt: 0,
|
|
38
|
+
updatedAt: 0,
|
|
39
|
+
labels: { kind: 'services-host' },
|
|
40
|
+
source: { type: 'event', eventPattern: '*' },
|
|
41
|
+
execution: {
|
|
42
|
+
type: 'script',
|
|
43
|
+
script: {
|
|
44
|
+
path: path.basename(input.programEntry),
|
|
45
|
+
runtime: executable,
|
|
46
|
+
args: [],
|
|
47
|
+
// 宿主是长跑进程:这里的 timeoutMs 由沙箱构造函数用于探针预算,不用于杀宿主。
|
|
48
|
+
timeoutMs: 300_000,
|
|
49
|
+
},
|
|
50
|
+
onError: 'fail',
|
|
51
|
+
noopSentinel: '[[NOOP]]',
|
|
52
|
+
},
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* 构造宿主进程的启动配置。
|
|
57
|
+
*
|
|
58
|
+
* 与脚本同样的两条路径:`fullaccess` / `bypass+owner` → 无沙箱;否则 → scoped 沙箱。
|
|
59
|
+
* 无沙箱时 `sandboxAbsent` 会被带上,调用方必须据此写台账——宿主是全生命周期无沙箱,
|
|
60
|
+
* 比一次调用的降级严重得多(设计稿 6.5)。
|
|
61
|
+
*/
|
|
62
|
+
/**
|
|
63
|
+
* 无沙箱宿主的环境变量:清洗掉凭据后继承,再叠加调用方给的基础 env。
|
|
64
|
+
*
|
|
65
|
+
* 与一次性路径 `buildUnsandboxedLaunch` 同口径(同为「无文件隔离,但秘密要洗」)。
|
|
66
|
+
* 注意宿主是长跑进程:这里漏掉一个凭据变量,泄漏面是**整个宿主生命周期**而不是一次调用。
|
|
67
|
+
*/
|
|
68
|
+
function buildUnsandboxedHostEnv(extra) {
|
|
69
|
+
const env = {};
|
|
70
|
+
for (const [key, value] of Object.entries(sanitizeShellExecutionEnvironment(process.env))) {
|
|
71
|
+
if (typeof value !== 'string')
|
|
72
|
+
continue;
|
|
73
|
+
if (key.toUpperCase().startsWith('EVOLCORE_'))
|
|
74
|
+
continue;
|
|
75
|
+
if (isCredentialEnvironmentName(key))
|
|
76
|
+
continue;
|
|
77
|
+
env[key] = value;
|
|
78
|
+
}
|
|
79
|
+
return { ...env, ...extra };
|
|
80
|
+
}
|
|
81
|
+
export async function buildHostLaunch(input) {
|
|
82
|
+
const authorization = {
|
|
83
|
+
allowed: true,
|
|
84
|
+
scope: 'agent',
|
|
85
|
+
permissionMode: input.permissionMode,
|
|
86
|
+
role: input.role,
|
|
87
|
+
};
|
|
88
|
+
const executable = process.execPath;
|
|
89
|
+
// 无沙箱路径必须先判:`buildTriggerScriptLaunch` 在 fullaccess 下**直接抛错**
|
|
90
|
+
// (它不接受"请求了 scoped 但档位是 fullaccess"),所以不能让它兜底。
|
|
91
|
+
// 语义与一次性路径一致:fullaccess / bypass+owner → 免沙箱并留痕。
|
|
92
|
+
const sandboxDecision = resolvePhaseOneExecutionSandbox(input.permissionMode, input.role);
|
|
93
|
+
if (sandboxDecision.state === 'off') {
|
|
94
|
+
const reason = sandboxDecision.reason === 'fullaccess' ? 'fullaccess' : 'owner-bypass';
|
|
95
|
+
return {
|
|
96
|
+
command: executable,
|
|
97
|
+
args: [input.programEntry],
|
|
98
|
+
cwd: input.programDir,
|
|
99
|
+
env: buildUnsandboxedHostEnv(input.env),
|
|
100
|
+
sandboxAbsent: reason,
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
const launch = await buildTriggerScriptLaunch({
|
|
104
|
+
trigger: syntheticHostTrigger(input, executable),
|
|
105
|
+
triggerDir: input.programDir,
|
|
106
|
+
scriptPath: input.programEntry,
|
|
107
|
+
scriptArgs: [],
|
|
108
|
+
projectPath: input.projectPath,
|
|
109
|
+
executionAuthorization: authorization,
|
|
110
|
+
// 宿主会再 spawn 脚本次进程:必须验证孙进程也在围栏里(设计稿 6.2)。
|
|
111
|
+
verifyGrandchild: true,
|
|
112
|
+
...(input.extraReadRoots ? { extraReadRoots: input.extraReadRoots } : {}),
|
|
113
|
+
...(input.extraWriteRoots ? { extraWriteRoots: input.extraWriteRoots } : {}),
|
|
114
|
+
...(input.signal ? { signal: input.signal } : {}),
|
|
115
|
+
});
|
|
116
|
+
return { ...launch, env: { ...launch.env, ...input.env } };
|
|
117
|
+
}
|
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 计划内自愈重启:**间隔**(该不该换)与**时机**(等到何时换)是两层。
|
|
3
|
+
*
|
|
4
|
+
* 设计稿:`docs/services/resident-mode.md` §3.8.2。
|
|
5
|
+
*
|
|
6
|
+
* ## 为什么必须分两层
|
|
7
|
+
*
|
|
8
|
+
* 宿主是常驻的,长跑必然累积泄漏(句柄未关、定时器未清、Buffer 池涨)。但重启会打断
|
|
9
|
+
* 在途调用,所以不能「到点就换」。正确形态是:
|
|
10
|
+
*
|
|
11
|
+
* 1. **间隔 / 泄漏信号**只负责「置位该换了」(`pendingRestart`);
|
|
12
|
+
* 2. **空闲窗口**负责真正执行——等到连续 5 分钟没有在途调用才换。
|
|
13
|
+
*
|
|
14
|
+
* 混为一谈有两种错误方向,都踩过:
|
|
15
|
+
*
|
|
16
|
+
* - **到点就硬重启**:繁忙宿主上反复打断调用,调用方不断拿到 `SERVICES_HOST_RESTARTING`;
|
|
17
|
+
* - **把空闲当退出用**:稀疏流量(每 6 分钟一次)每次调用都要重新付约 1 秒沙箱税,
|
|
18
|
+
* 常驻模式的收益被完全吃光。1 小时那个是**空闲回收**(进程销毁),不是这里。
|
|
19
|
+
*
|
|
20
|
+
* ## 长跑不停机怎么办
|
|
21
|
+
*
|
|
22
|
+
* 一个包如果持续繁忙、永远凑不出 5 分钟空闲,重启就永远不发生。所以有 `forceAfterMs`
|
|
23
|
+
* 兜底:置位后最多等 2 小时,到期强制排空重启。正常情况下不该触发。
|
|
24
|
+
*/
|
|
25
|
+
export const DEFAULT_RECYCLE_POLICY = {
|
|
26
|
+
intervalTiersMs: [8 * 3600_000, 4 * 3600_000, 2 * 3600_000, 3600_000, 1800_000],
|
|
27
|
+
rssGrowthFactor: 2,
|
|
28
|
+
rssAbsoluteBytes: 300 * 1024 * 1024,
|
|
29
|
+
handleGrowth: 100,
|
|
30
|
+
idleCpuPercent: 5,
|
|
31
|
+
cpuStreakRequired: 3,
|
|
32
|
+
idleWindowMs: 5 * 60_000,
|
|
33
|
+
forceAfterMs: 2 * 3600_000,
|
|
34
|
+
tierEscalationWindows: [1, 2, 3, 4],
|
|
35
|
+
tierResetAfterMs: 24 * 3600_000,
|
|
36
|
+
};
|
|
37
|
+
export class HostRecycleController {
|
|
38
|
+
policy;
|
|
39
|
+
tier = 0;
|
|
40
|
+
/** 基线:宿主启动后稳定时的水位。泄漏判据都相对它。 */
|
|
41
|
+
baseline;
|
|
42
|
+
/**
|
|
43
|
+
* 启动时间。
|
|
44
|
+
*
|
|
45
|
+
* **不能用 0 当"未启动"哨兵**:epoch 毫秒里 0 是合法值(测试与某些虚拟时钟会传它),
|
|
46
|
+
* 那样 `onTick` 会永远以为宿主没启动过。用 `undefined` 表达"未启动"。
|
|
47
|
+
*/
|
|
48
|
+
startedAt;
|
|
49
|
+
/** 置位时间;0 表示未置位。 */
|
|
50
|
+
pendingSince = 0;
|
|
51
|
+
pendingReason = '';
|
|
52
|
+
/** 历史上触发重启的时间戳,用于等级升降。 */
|
|
53
|
+
recycleStamps = [];
|
|
54
|
+
/**
|
|
55
|
+
* 最后一次**观察到泄漏信号**的时间,用于等级回落。
|
|
56
|
+
*
|
|
57
|
+
* 判据用「多久没见过泄漏」而不是「多久没重启」:间隔到点的**计划内重启不算脏**,
|
|
58
|
+
* 否则每 8 小时一次的例行更换就会把干净期清零,等级永远降不下来。
|
|
59
|
+
*/
|
|
60
|
+
lastLeakAt = 0;
|
|
61
|
+
/** 连续多少次空闲采样超过 CPU 阈值(见 `cpuStreakRequired`)。 */
|
|
62
|
+
cpuStreak = 0;
|
|
63
|
+
constructor(policy = {}) {
|
|
64
|
+
this.policy = { ...DEFAULT_RECYCLE_POLICY, ...policy };
|
|
65
|
+
}
|
|
66
|
+
get currentTier() {
|
|
67
|
+
return this.tier;
|
|
68
|
+
}
|
|
69
|
+
get currentIntervalMs() {
|
|
70
|
+
return this.policy.intervalTiersMs[Math.min(this.tier, this.policy.intervalTiersMs.length - 1)];
|
|
71
|
+
}
|
|
72
|
+
get isPending() {
|
|
73
|
+
return this.pendingSince !== 0;
|
|
74
|
+
}
|
|
75
|
+
/** 当前置位的原因(未置位时为空串)。 */
|
|
76
|
+
get pendingRestartReason() {
|
|
77
|
+
return this.pendingReason;
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* 宿主启动时调用:起点与基线都要重置。
|
|
81
|
+
*
|
|
82
|
+
* **基线无条件覆盖**(没传就清空,由启动后第一份采样重新设定)。以前是「传了才覆盖」,
|
|
83
|
+
* 于是宿主重启后沿用**上一个进程**的 rss/handles 基线:新进程一上来就比旧基线大一截,
|
|
84
|
+
* 泄漏判据立刻置位,把一次正常的重启变成「刚起来就该换」。
|
|
85
|
+
*/
|
|
86
|
+
markStarted(nowMs, baseline) {
|
|
87
|
+
this.startedAt = nowMs;
|
|
88
|
+
this.pendingSince = 0;
|
|
89
|
+
this.pendingReason = '';
|
|
90
|
+
this.cpuStreak = 0;
|
|
91
|
+
this.baseline = baseline;
|
|
92
|
+
}
|
|
93
|
+
/** 用启动后第一份稳定采样设定基线(只设一次)。 */
|
|
94
|
+
seedBaseline(snapshot) {
|
|
95
|
+
if (!this.baseline)
|
|
96
|
+
this.baseline = snapshot;
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
* 外部请求重启(例如:宿主程序版本变了、包脚本内容变了)。
|
|
100
|
+
*
|
|
101
|
+
* 只是**置位**,仍然要走空闲窗口才会真正执行——这和间隔到点是同一条路径。
|
|
102
|
+
* 不走这条路的话,热重载会在有调用在飞的时候硬重启,把 `SERVICES_HOST_RESTARTING`
|
|
103
|
+
* 糊到调用方脸上;而热重载本该是运维动作,不该产生用户可见错误。
|
|
104
|
+
*/
|
|
105
|
+
requestRecycle(nowMs, reason) {
|
|
106
|
+
if (this.pendingSince !== 0)
|
|
107
|
+
return; // 已置位:保留最早的原因,避免反复覆盖
|
|
108
|
+
this.pendingSince = nowMs;
|
|
109
|
+
this.pendingReason = reason;
|
|
110
|
+
}
|
|
111
|
+
/**
|
|
112
|
+
* 每次调用结束后推进一次。
|
|
113
|
+
*
|
|
114
|
+
* @param idleForMs 当前已连续空闲多久(0 表示刚有调用结束/正在忙)
|
|
115
|
+
*/
|
|
116
|
+
onTick(nowMs, snapshot, idleForMs) {
|
|
117
|
+
if (this.startedAt === undefined)
|
|
118
|
+
return { action: 'none' };
|
|
119
|
+
if (!this.baseline)
|
|
120
|
+
this.baseline = snapshot;
|
|
121
|
+
// 等级回落先判:它依赖「距上次泄漏信号多久」,与是否正要重启无关。
|
|
122
|
+
// 放在下面能保证即使宿主繁忙、间隔一直触发,回落也不会被跳过。
|
|
123
|
+
if (this.tier > 0 && this.lastLeakAt > 0
|
|
124
|
+
&& nowMs - this.lastLeakAt >= this.policy.tierResetAfterMs) {
|
|
125
|
+
this.tier -= 1;
|
|
126
|
+
// 回落一级后重新计时:连续干净 48 小时才再降一级,不是一次性掉到底。
|
|
127
|
+
this.lastLeakAt = nowMs;
|
|
128
|
+
}
|
|
129
|
+
// 第一层:是否需要换
|
|
130
|
+
if (this.pendingSince === 0) {
|
|
131
|
+
const leak = this.detectLeak(snapshot);
|
|
132
|
+
if (leak) {
|
|
133
|
+
this.pendingSince = nowMs;
|
|
134
|
+
this.pendingReason = leak;
|
|
135
|
+
this.lastLeakAt = nowMs;
|
|
136
|
+
}
|
|
137
|
+
else if (nowMs - this.startedAt >= this.currentIntervalMs) {
|
|
138
|
+
this.pendingSince = nowMs;
|
|
139
|
+
this.pendingReason = `uptime reached tier ${this.tier} interval (${Math.round(this.currentIntervalMs / 60000)}min)`;
|
|
140
|
+
}
|
|
141
|
+
else {
|
|
142
|
+
return { action: 'none' };
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
// 第二层:等到空闲才换
|
|
146
|
+
const waitedMs = nowMs - this.pendingSince;
|
|
147
|
+
const forced = waitedMs >= this.policy.forceAfterMs;
|
|
148
|
+
if (idleForMs < this.policy.idleWindowMs && !forced) {
|
|
149
|
+
return { action: 'pending', reason: this.pendingReason, waitedMs };
|
|
150
|
+
}
|
|
151
|
+
const reason = forced
|
|
152
|
+
? `${this.pendingReason}; forced after ${Math.round(waitedMs / 60000)}min without idle window`
|
|
153
|
+
: this.pendingReason;
|
|
154
|
+
this.recordRecycle(nowMs);
|
|
155
|
+
return { action: 'recycle', reason, tier: this.tier };
|
|
156
|
+
}
|
|
157
|
+
/** 泄漏判定:返回原因字符串,没有泄漏返回 undefined。 */
|
|
158
|
+
detectLeak(snapshot) {
|
|
159
|
+
const base = this.baseline;
|
|
160
|
+
if (!base)
|
|
161
|
+
return undefined;
|
|
162
|
+
if (snapshot.handles - base.handles >= this.policy.handleGrowth) {
|
|
163
|
+
return `handle leak: ${snapshot.handles} vs baseline ${base.handles}`;
|
|
164
|
+
}
|
|
165
|
+
if (snapshot.rss > base.rss * this.policy.rssGrowthFactor
|
|
166
|
+
&& snapshot.rss > this.policy.rssAbsoluteBytes) {
|
|
167
|
+
return `memory growth: ${Math.round(snapshot.rss / 1048576)}MB vs baseline ${Math.round(base.rss / 1048576)}MB`;
|
|
168
|
+
}
|
|
169
|
+
// CPU 判据只在**真正空闲**时成立:有调用在跑时 CPU 高是它该有的样子。
|
|
170
|
+
// 早期版本漏了这个前提,结果每个有流量的宿主都会被判成"空转定时器"。
|
|
171
|
+
if (snapshot.inFlight === 0 && snapshot.idleCpuPercent > this.policy.idleCpuPercent) {
|
|
172
|
+
this.cpuStreak += 1;
|
|
173
|
+
// 连续多次才认:单次偏高可能只是 GC、磁盘抖动、机器负载。
|
|
174
|
+
if (this.cpuStreak >= this.policy.cpuStreakRequired) {
|
|
175
|
+
return `idle CPU ${snapshot.idleCpuPercent}% sustained for ${this.cpuStreak} samples suggests a spinning timer or poller`;
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
else {
|
|
179
|
+
this.cpuStreak = 0;
|
|
180
|
+
}
|
|
181
|
+
return undefined;
|
|
182
|
+
}
|
|
183
|
+
/** 记录一次计划内重启:推进等级。 */
|
|
184
|
+
recordRecycle(nowMs) {
|
|
185
|
+
this.pendingSince = 0;
|
|
186
|
+
this.pendingReason = '';
|
|
187
|
+
this.recycleStamps.push(nowMs);
|
|
188
|
+
// 只统计最近 24 小时。
|
|
189
|
+
while (this.recycleStamps.length > 0 && nowMs - this.recycleStamps[0] > this.policy.tierResetAfterMs) {
|
|
190
|
+
this.recycleStamps.shift();
|
|
191
|
+
}
|
|
192
|
+
const count = this.recycleStamps.length;
|
|
193
|
+
const nextTier = this.policy.tierEscalationWindows.filter(threshold => count >= threshold).length;
|
|
194
|
+
this.tier = Math.min(nextTier, this.policy.intervalTiersMs.length - 1);
|
|
195
|
+
}
|
|
196
|
+
/** 观测用:24 小时内计划内重启次数。 */
|
|
197
|
+
get recycleCount24h() {
|
|
198
|
+
return this.recycleStamps.length;
|
|
199
|
+
}
|
|
200
|
+
/** 观测用:距离下次因时长而置位还有多久;已置位返回 0。 */
|
|
201
|
+
msUntilInterval(nowMs) {
|
|
202
|
+
if (this.pendingSince !== 0)
|
|
203
|
+
return 0;
|
|
204
|
+
if (this.startedAt === undefined)
|
|
205
|
+
return this.currentIntervalMs;
|
|
206
|
+
return Math.max(0, this.currentIntervalMs - (nowMs - this.startedAt));
|
|
207
|
+
}
|
|
208
|
+
}
|