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
|
@@ -11,7 +11,7 @@ import path from 'path';
|
|
|
11
11
|
import fs from 'fs';
|
|
12
12
|
import crypto from 'crypto';
|
|
13
13
|
import { logger } from './logger.js';
|
|
14
|
-
import { agentRelationDir } from '../paths.js';
|
|
14
|
+
import { agentRelationDir, agentAttachmentsDir, agentAttachmentIndexDir, agentAttachmentsMonthDir, agentAttachmentSha256IndexPath, } from '../paths.js';
|
|
15
15
|
import { parsePeerKey } from '../core/relation/peer-identity.js';
|
|
16
16
|
import { isSameOrDescendant } from '../core/permission/protected-paths.js';
|
|
17
17
|
// ── 常量 ──────────────────────────────────────────────────────────────────────
|
|
@@ -112,68 +112,214 @@ export async function validateImage(buffer, opts) {
|
|
|
112
112
|
}
|
|
113
113
|
return { mime: type.mime };
|
|
114
114
|
}
|
|
115
|
-
|
|
115
|
+
/** 旧版附件目录(升级前的落点,仅用于兼容读取)。 */
|
|
116
|
+
function legacyRelationAttachmentsDir(selfAid, peerKey) {
|
|
116
117
|
parsePeerKey(peerKey);
|
|
117
118
|
return path.join(agentRelationDir(selfAid, peerKey), 'attachments');
|
|
118
119
|
}
|
|
119
|
-
/**
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
120
|
+
/** 关系归属索引文件:`$AGENT_DIR/attachments/index/<peerKey>.jsonl`。 */
|
|
121
|
+
function attachmentIndexPath(selfAid, peerKey) {
|
|
122
|
+
parsePeerKey(peerKey);
|
|
123
|
+
return path.join(agentAttachmentIndexDir(selfAid), `${peerKey}.jsonl`);
|
|
124
|
+
}
|
|
125
|
+
/** 当月目录名。本地月,`YYYY-MM`。 */
|
|
126
|
+
function currentMonth() {
|
|
127
|
+
const now = new Date();
|
|
128
|
+
const month = `${now.getMonth() + 1}`.padStart(2, '0');
|
|
129
|
+
return `${now.getFullYear()}-${month}`;
|
|
130
|
+
}
|
|
131
|
+
/** 在 sha256 反查索引里找这份内容;命中且文件仍在才返回。 */
|
|
132
|
+
function findSha256Record(selfAid, sha256) {
|
|
133
|
+
const indexPath = agentAttachmentSha256IndexPath(selfAid, sha256.slice(0, 2));
|
|
134
|
+
let text;
|
|
135
|
+
try {
|
|
136
|
+
text = fs.readFileSync(indexPath, 'utf8');
|
|
137
|
+
}
|
|
138
|
+
catch {
|
|
139
|
+
return null;
|
|
126
140
|
}
|
|
127
|
-
|
|
141
|
+
// 从后往前:同一内容可能有跨月多条记录,最后一条是最新落点。
|
|
142
|
+
const lines = text.split('\n');
|
|
143
|
+
for (let i = lines.length - 1; i >= 0; i--) {
|
|
144
|
+
const line = lines[i].trim();
|
|
145
|
+
if (!line)
|
|
146
|
+
continue;
|
|
147
|
+
let record;
|
|
148
|
+
try {
|
|
149
|
+
record = JSON.parse(line);
|
|
150
|
+
}
|
|
151
|
+
catch {
|
|
152
|
+
continue;
|
|
153
|
+
}
|
|
154
|
+
if (record.sha256 !== sha256)
|
|
155
|
+
continue;
|
|
156
|
+
const candidate = path.join(agentAttachmentsMonthDir(selfAid, record.month), record.storage);
|
|
157
|
+
try {
|
|
158
|
+
const stat = fs.lstatSync(candidate);
|
|
159
|
+
if (stat.isFile() && !stat.isSymbolicLink() && stat.size === record.size) {
|
|
160
|
+
return record;
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
catch { /* 文件已不在,继续找更早的记录 */ }
|
|
164
|
+
}
|
|
165
|
+
return null;
|
|
166
|
+
}
|
|
167
|
+
function appendSha256Record(selfAid, record) {
|
|
168
|
+
const indexPath = agentAttachmentSha256IndexPath(selfAid, record.sha256.slice(0, 2));
|
|
169
|
+
ensureDir(path.dirname(indexPath));
|
|
170
|
+
fs.appendFileSync(indexPath, `${JSON.stringify(record)}\n`, { mode: 0o600 });
|
|
171
|
+
}
|
|
172
|
+
function ensureDir(directory) {
|
|
128
173
|
fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
|
|
129
174
|
if (process.platform !== 'win32')
|
|
130
175
|
fs.chmodSync(directory, 0o700);
|
|
176
|
+
}
|
|
177
|
+
/** 读取索引文件的全部记录;文件不存在时返回空数组。 */
|
|
178
|
+
function readIndexRecords(indexPath) {
|
|
179
|
+
let text;
|
|
180
|
+
try {
|
|
181
|
+
text = fs.readFileSync(indexPath, 'utf8');
|
|
182
|
+
}
|
|
183
|
+
catch {
|
|
184
|
+
return [];
|
|
185
|
+
}
|
|
186
|
+
const records = [];
|
|
187
|
+
for (const line of text.split('\n')) {
|
|
188
|
+
if (!line.trim())
|
|
189
|
+
continue;
|
|
190
|
+
try {
|
|
191
|
+
records.push(JSON.parse(line));
|
|
192
|
+
}
|
|
193
|
+
catch { /* skip malformed line */ }
|
|
194
|
+
}
|
|
195
|
+
return records;
|
|
196
|
+
}
|
|
197
|
+
function appendIndexRecord(indexPath, metadata) {
|
|
198
|
+
fs.appendFileSync(indexPath, `${JSON.stringify(metadata)}\n`, { mode: 0o600 });
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* 在 agent 级附件目录里为 `filename` 找一个落点。
|
|
202
|
+
*
|
|
203
|
+
* 规则(2026-11-16 起):
|
|
204
|
+
* - 同名文件存在且 **大小与 sha256 都相同** → 复用已有文件,不新增副本;
|
|
205
|
+
* - 同名但内容不同 → 依次尝试 `<base>-1<ext>`、`<base>-2<ext>`…,已存在同名候选时
|
|
206
|
+
* 同样先做内容比对,命中即复用;
|
|
207
|
+
* - 全部空闲 → 用原始文件名。
|
|
208
|
+
*/
|
|
209
|
+
/** 与附件本体同级的保留名:索引子目录不能用作用户文件名。 */
|
|
210
|
+
const RESERVED_ATTACHMENT_NAMES = new Set(['index']);
|
|
211
|
+
function resolveAttachmentTarget(directory, filename, buffer, sha256) {
|
|
212
|
+
const ext = path.extname(filename);
|
|
213
|
+
const base = ext ? filename.slice(0, -ext.length) : filename;
|
|
214
|
+
for (let index = 0; index < 10_000; index++) {
|
|
215
|
+
const candidate = index === 0 ? filename : `${base}-${index}${ext}`;
|
|
216
|
+
// 保留名(如 index 子目录)不能作为附件本体名,直接跳到下一个编号。
|
|
217
|
+
if (RESERVED_ATTACHMENT_NAMES.has(candidate.toLowerCase()))
|
|
218
|
+
continue;
|
|
219
|
+
const candidatePath = path.join(directory, candidate);
|
|
220
|
+
if (!fs.existsSync(candidatePath)) {
|
|
221
|
+
return { filename: candidate, filePath: candidatePath, reused: false };
|
|
222
|
+
}
|
|
223
|
+
try {
|
|
224
|
+
const stat = fs.lstatSync(candidatePath);
|
|
225
|
+
// 目录(如 index/)不是可复用候选,跳过后继续找编号。
|
|
226
|
+
if (!stat.isFile() || stat.isSymbolicLink() || stat.size !== buffer.length)
|
|
227
|
+
continue;
|
|
228
|
+
const existingSha = crypto.createHash('sha256').update(fs.readFileSync(candidatePath)).digest('hex');
|
|
229
|
+
if (existingSha === sha256)
|
|
230
|
+
return { filename: candidate, filePath: candidatePath, reused: true };
|
|
231
|
+
}
|
|
232
|
+
catch {
|
|
233
|
+
continue;
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
throw new Error(`Too many same-name attachments in agent attachment directory: ${filename}`);
|
|
237
|
+
}
|
|
238
|
+
/**
|
|
239
|
+
* Save one attachment (image or arbitrary file).
|
|
240
|
+
*
|
|
241
|
+
* 文件本体进 agent 级目录(按内容去重,同一份文件发给多个对端只占一份磁盘);
|
|
242
|
+
* 归属信息追加到该对端的索引 `$AGENT_DIR/attachments/index/<peerKey>.jsonl`,
|
|
243
|
+
* 保留「这段关系什么时候收发过什么」的痕迹。
|
|
244
|
+
*/
|
|
245
|
+
export function saveRelationAttachment(buffer, selfAid, peerKey, mimeType, opts = {}) {
|
|
246
|
+
const originalName = opts.filename ? sanitizeFileName(opts.filename) : '';
|
|
247
|
+
let extension;
|
|
248
|
+
if (opts.allowAnyExtension && originalName) {
|
|
249
|
+
extension = path.extname(originalName);
|
|
250
|
+
}
|
|
251
|
+
else {
|
|
252
|
+
extension = RELATION_ATTACHMENT_EXTENSIONS[mimeType] ?? '';
|
|
253
|
+
if (!extension)
|
|
254
|
+
throw new Error(`Unsupported relation attachment MIME type: ${mimeType}`);
|
|
255
|
+
}
|
|
256
|
+
if (buffer.length < 1 || buffer.length > RELATION_ATTACHMENT_MAX_BYTES) {
|
|
257
|
+
throw new Error(`Relation attachment must be between 1 byte and ${RELATION_ATTACHMENT_MAX_BYTES} bytes`);
|
|
258
|
+
}
|
|
259
|
+
ensureDir(agentAttachmentsDir(selfAid));
|
|
260
|
+
const indexDir = agentAttachmentIndexDir(selfAid);
|
|
261
|
+
ensureDir(indexDir);
|
|
131
262
|
const attachmentId = crypto.randomBytes(16).toString('hex');
|
|
132
|
-
const
|
|
133
|
-
const filePath = path.join(directory, filename);
|
|
134
|
-
const metadataPath = path.join(directory, `${attachmentId}.json`);
|
|
263
|
+
const requestedName = originalName || `${attachmentId}${extension}`;
|
|
135
264
|
const sha256 = crypto.createHash('sha256').update(buffer).digest('hex');
|
|
265
|
+
const createdAt = Date.now();
|
|
266
|
+
// 1. 先查 sha256 反查索引:同内容(任何名字、任何月份)直接复用,不新增副本。
|
|
267
|
+
const hit = findSha256Record(selfAid, sha256);
|
|
268
|
+
if (hit) {
|
|
269
|
+
const metadata = {
|
|
270
|
+
version: 1, attachmentId, selfAid, peerKey,
|
|
271
|
+
filename: requestedName, storage: hit.storage, mimeType,
|
|
272
|
+
sha256, size: buffer.length, direction: opts.direction ?? 'in', createdAt,
|
|
273
|
+
month: hit.month,
|
|
274
|
+
};
|
|
275
|
+
// 归属索引仍追加一条:这段关系这次确实收发过它,本体复用。
|
|
276
|
+
appendIndexRecord(attachmentIndexPath(selfAid, peerKey), metadata);
|
|
277
|
+
return { ...metadata, filePath: path.join(agentAttachmentsMonthDir(selfAid, hit.month), hit.storage) };
|
|
278
|
+
}
|
|
279
|
+
// 2. 未命中:写当月目录。
|
|
280
|
+
const month = currentMonth();
|
|
281
|
+
const directory = agentAttachmentsMonthDir(selfAid, month);
|
|
282
|
+
ensureDir(directory);
|
|
283
|
+
const target = resolveAttachmentTarget(directory, requestedName, buffer, sha256);
|
|
136
284
|
const metadata = {
|
|
137
|
-
version: 1, attachmentId, selfAid, peerKey,
|
|
138
|
-
|
|
285
|
+
version: 1, attachmentId, selfAid, peerKey,
|
|
286
|
+
filename: requestedName, storage: target.filename, mimeType,
|
|
287
|
+
sha256, size: buffer.length, direction: opts.direction ?? 'in', createdAt, month,
|
|
139
288
|
};
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
289
|
+
if (!target.reused) {
|
|
290
|
+
fs.writeFileSync(target.filePath, buffer, { flag: 'wx', mode: 0o600 });
|
|
291
|
+
}
|
|
292
|
+
// 索引一律追加:同一份内容收发 N 次就有 N 条记录,文件本体只落一份。
|
|
293
|
+
appendIndexRecord(attachmentIndexPath(selfAid, peerKey), metadata);
|
|
294
|
+
appendSha256Record(selfAid, { sha256, month, storage: target.filename, size: buffer.length, createdAt });
|
|
295
|
+
return { ...metadata, filePath: target.filePath };
|
|
143
296
|
}
|
|
144
297
|
/** Resolve an attachment only inside the authenticated Agent/peer relation. */
|
|
145
298
|
export function readRelationAttachment(selfAid, peerKey, attachmentSource) {
|
|
146
|
-
|
|
299
|
+
// 兼容三种输入:新版文件名(会话内认知名)、旧版 32 位 hex ID、绝对路径。
|
|
300
|
+
const basename = path.basename(attachmentSource);
|
|
301
|
+
const legacyId = RELATION_ATTACHMENT_ID_RE.test(attachmentSource)
|
|
147
302
|
? attachmentSource
|
|
148
|
-
: path.basename(
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
const
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
|
|
157
|
-
if (metadata.version !== 1 || metadata.attachmentId !== attachmentId
|
|
158
|
-
|| metadata.selfAid !== selfAid || metadata.peerKey !== peerKey
|
|
159
|
-
|| RELATION_ATTACHMENT_EXTENSIONS[metadata.mimeType] === undefined
|
|
160
|
-
|| metadata.filename !== `${attachmentId}${RELATION_ATTACHMENT_EXTENSIONS[metadata.mimeType]}`) {
|
|
303
|
+
: (RELATION_ATTACHMENT_ID_RE.test(path.basename(basename, path.extname(basename)))
|
|
304
|
+
? path.basename(basename, path.extname(basename))
|
|
305
|
+
: '');
|
|
306
|
+
const metadata = resolveIndexedMetadata(selfAid, peerKey, basename)
|
|
307
|
+
?? (legacyId ? resolveLegacyMetadata(selfAid, peerKey, legacyId, basename) : null);
|
|
308
|
+
if (!metadata)
|
|
309
|
+
throw new Error('Attachment metadata not found');
|
|
310
|
+
if (metadata.version !== 1 || metadata.selfAid !== selfAid || metadata.peerKey !== peerKey) {
|
|
161
311
|
throw new Error('Attachment ownership metadata mismatch');
|
|
162
312
|
}
|
|
163
|
-
const
|
|
164
|
-
|
|
313
|
+
const attachmentId = metadata.attachmentId;
|
|
314
|
+
if (!RELATION_ATTACHMENT_ID_RE.test(attachmentId))
|
|
315
|
+
throw new Error('Invalid attachment ID');
|
|
316
|
+
const realPath = resolveAttachmentFile(selfAid, peerKey, metadata);
|
|
317
|
+
const stat = fs.lstatSync(realPath);
|
|
165
318
|
if (!stat.isFile() || stat.isSymbolicLink() || stat.size !== metadata.size
|
|
166
319
|
|| stat.size < 1 || stat.size > RELATION_ATTACHMENT_MAX_BYTES) {
|
|
167
320
|
throw new Error('Attachment file is missing or invalid');
|
|
168
321
|
}
|
|
169
|
-
const
|
|
170
|
-
const realPath = fs.realpathSync(filePath);
|
|
171
|
-
if (!isSameOrDescendant(realPath, realDirectory))
|
|
172
|
-
throw new Error('Attachment path escaped its relation directory');
|
|
173
|
-
if (path.isAbsolute(attachmentSource) && fs.realpathSync(attachmentSource) !== realPath) {
|
|
174
|
-
throw new Error('Attachment path does not match the current relation');
|
|
175
|
-
}
|
|
176
|
-
const buffer = fs.readFileSync(filePath);
|
|
322
|
+
const buffer = fs.readFileSync(realPath);
|
|
177
323
|
const sha256 = crypto.createHash('sha256').update(buffer).digest('hex');
|
|
178
324
|
if (sha256 !== metadata.sha256)
|
|
179
325
|
throw new Error('Attachment content hash mismatch');
|
|
@@ -181,10 +327,106 @@ export function readRelationAttachment(selfAid, peerKey, attachmentSource) {
|
|
|
181
327
|
attachment: {
|
|
182
328
|
attachmentId, selfAid, peerKey, filePath: realPath,
|
|
183
329
|
mimeType: metadata.mimeType, sha256, size: buffer.length,
|
|
330
|
+
storage: metadata.storage ?? metadata.filename,
|
|
331
|
+
...(metadata.month ? { month: metadata.month } : {}),
|
|
184
332
|
},
|
|
185
333
|
buffer,
|
|
186
334
|
};
|
|
187
335
|
}
|
|
336
|
+
/** 旧版:`<peerKey>/attachments/<id>.json` + `<id><ext>`,仍在关系目录里。 */
|
|
337
|
+
function resolveLegacyMetadata(selfAid, peerKey, legacyId, requestedBasename) {
|
|
338
|
+
const directory = legacyRelationAttachmentsDir(selfAid, peerKey);
|
|
339
|
+
const legacyPath = path.join(directory, `${legacyId}.json`);
|
|
340
|
+
try {
|
|
341
|
+
const stat = fs.lstatSync(legacyPath);
|
|
342
|
+
if (!stat.isFile() || stat.isSymbolicLink())
|
|
343
|
+
return null;
|
|
344
|
+
const raw = JSON.parse(fs.readFileSync(legacyPath, 'utf8'));
|
|
345
|
+
if (!raw || typeof raw !== 'object')
|
|
346
|
+
return null;
|
|
347
|
+
// 旧记录没有 storage/direction 字段,落盘名按旧约定推导。
|
|
348
|
+
const filename = typeof raw.filename === 'string' ? raw.filename : '';
|
|
349
|
+
return {
|
|
350
|
+
...raw,
|
|
351
|
+
filename: requestedBasename || filename,
|
|
352
|
+
storage: filename,
|
|
353
|
+
direction: 'in',
|
|
354
|
+
};
|
|
355
|
+
}
|
|
356
|
+
catch {
|
|
357
|
+
return null;
|
|
358
|
+
}
|
|
359
|
+
}
|
|
360
|
+
/** 新版:`$AGENT_DIR/attachments/index/<peerKey>.jsonl` 里按 filename 取最后一条。 */
|
|
361
|
+
function resolveIndexedMetadata(selfAid, peerKey, filename) {
|
|
362
|
+
if (!filename || filename.includes('\0') || filename === '.' || filename === '..'
|
|
363
|
+
|| path.basename(filename) !== filename) {
|
|
364
|
+
throw new Error('Invalid attachment name');
|
|
365
|
+
}
|
|
366
|
+
const records = readIndexRecords(attachmentIndexPath(selfAid, peerKey));
|
|
367
|
+
for (let index = records.length - 1; index >= 0; index--) {
|
|
368
|
+
const record = records[index];
|
|
369
|
+
if (record.filename === filename || record.storage === filename || record.attachmentId === filename)
|
|
370
|
+
return record;
|
|
371
|
+
}
|
|
372
|
+
return null;
|
|
373
|
+
}
|
|
374
|
+
/** 取文件本体路径:新版在 agent 级目录,旧版回落到关系目录。 */
|
|
375
|
+
function resolveAttachmentFile(selfAid, peerKey, metadata) {
|
|
376
|
+
const storage = typeof metadata.storage === 'string' && metadata.storage
|
|
377
|
+
? metadata.storage
|
|
378
|
+
: metadata.filename;
|
|
379
|
+
if (!storage || path.basename(storage) !== storage)
|
|
380
|
+
throw new Error('Invalid attachment storage name');
|
|
381
|
+
const agentDirPath = agentAttachmentsDir(selfAid);
|
|
382
|
+
// 新版:记录带 month,本体在 `<attachments>/<YYYY-MM>/<storage>`。
|
|
383
|
+
if (typeof metadata.month === 'string' && metadata.month) {
|
|
384
|
+
const monthDir = agentAttachmentsMonthDir(selfAid, metadata.month);
|
|
385
|
+
const monthCandidate = path.join(monthDir, storage);
|
|
386
|
+
if (fs.existsSync(monthCandidate)) {
|
|
387
|
+
const realRoot = fs.realpathSync(agentDirPath);
|
|
388
|
+
const realPath = fs.realpathSync(monthCandidate);
|
|
389
|
+
if (!isSameOrDescendant(realPath, realRoot))
|
|
390
|
+
throw new Error('Attachment path escaped the agent attachment directory');
|
|
391
|
+
return realPath;
|
|
392
|
+
}
|
|
393
|
+
}
|
|
394
|
+
// 旧记录(无 month 字段):本体平铺在 attachments/ 下。
|
|
395
|
+
const agentCandidate = path.join(agentDirPath, storage);
|
|
396
|
+
if (fs.existsSync(agentCandidate)) {
|
|
397
|
+
const realRoot = fs.realpathSync(agentDirPath);
|
|
398
|
+
const realPath = fs.realpathSync(agentCandidate);
|
|
399
|
+
if (!isSameOrDescendant(realPath, realRoot))
|
|
400
|
+
throw new Error('Attachment path escaped the agent attachment directory');
|
|
401
|
+
return realPath;
|
|
402
|
+
}
|
|
403
|
+
// 旧版附件仍在关系目录里。
|
|
404
|
+
const legacyDir = legacyRelationAttachmentsDir(selfAid, peerKey);
|
|
405
|
+
const legacyCandidate = path.join(legacyDir, storage);
|
|
406
|
+
if (fs.existsSync(legacyCandidate)) {
|
|
407
|
+
const realRoot = fs.realpathSync(legacyDir);
|
|
408
|
+
const realPath = fs.realpathSync(legacyCandidate);
|
|
409
|
+
if (!isSameOrDescendant(realPath, realRoot))
|
|
410
|
+
throw new Error('Attachment path escaped its relation directory');
|
|
411
|
+
return realPath;
|
|
412
|
+
}
|
|
413
|
+
throw new Error('Attachment file is missing or invalid');
|
|
414
|
+
}
|
|
415
|
+
/**
|
|
416
|
+
* 生成消息正文里的附件标记。
|
|
417
|
+
*
|
|
418
|
+
* 格式:`[文件: 对端名 → 路径]`;当「对端名」与「实际落盘名」不一致时追加
|
|
419
|
+
* `(原名 对端名)`,避免模型或用户按显示名去引用文件时对不上号。
|
|
420
|
+
*
|
|
421
|
+
* @param shownPath 展示路径。当轮传绝对路径(模型直接可用);
|
|
422
|
+
* 历史记录传 `$AGENT_DIR/…` 别名(换机器后仍可展开)。
|
|
423
|
+
* @param pathUnavailable 代码侧拿不到 selfAid、别名无法生成时为 true。
|
|
424
|
+
*/
|
|
425
|
+
export function formatAttachmentMarker(label, displayName, shownPath, storageName, pathUnavailable = false) {
|
|
426
|
+
const shown = pathUnavailable ? `${shownPath} (路径不可用:selfAid 缺失)` : shownPath;
|
|
427
|
+
const base = `[${label}: ${displayName} → ${shown}]`;
|
|
428
|
+
return storageName && storageName !== displayName ? `${base} (原名 ${displayName})` : base;
|
|
429
|
+
}
|
|
188
430
|
/**
|
|
189
431
|
* 把已下载的附件 Buffer 转成入站图片条目(供 baseagent 视觉通道)。
|
|
190
432
|
*
|
|
@@ -5,7 +5,15 @@ const REAL_RESTART_TEST_OVERRIDE = 'EVOLCORE_ALLOW_REAL_RESTART_IN_TEST';
|
|
|
5
5
|
export function readRestartRequest(filePath, requestId) {
|
|
6
6
|
try {
|
|
7
7
|
const request = JSON.parse(fs.readFileSync(filePath, 'utf8'));
|
|
8
|
-
|
|
8
|
+
if (!request?.requestId || (requestId && request.requestId !== requestId))
|
|
9
|
+
return null;
|
|
10
|
+
// A failed unit may never start a replacement process. Readers can still
|
|
11
|
+
// observe a terminal timeout without requiring a surviving supervisor.
|
|
12
|
+
if (request.backend === 'systemd' && ['requested', 'accepted'].includes(request.status)
|
|
13
|
+
&& request.deadline && request.deadline <= Date.now()) {
|
|
14
|
+
return { ...request, status: 'timeout', reason: 'Systemd replacement did not confirm ready before the restart deadline' };
|
|
15
|
+
}
|
|
16
|
+
return request;
|
|
9
17
|
}
|
|
10
18
|
catch {
|
|
11
19
|
return null;
|
|
@@ -15,6 +23,9 @@ export function createRestartRequest(filePath, request, isProcessAlive) {
|
|
|
15
23
|
fs.mkdirSync(path.dirname(filePath), { recursive: true });
|
|
16
24
|
try {
|
|
17
25
|
const previous = JSON.parse(fs.readFileSync(filePath, 'utf8'));
|
|
26
|
+
if (previous.backend === 'systemd' && ['requested', 'accepted'].includes(previous.status)
|
|
27
|
+
&& Number(previous.deadline) > Date.now())
|
|
28
|
+
return false;
|
|
18
29
|
if ([previous.launcherPid, previous.monitorPid]
|
|
19
30
|
.some(pid => typeof pid === 'number' && isProcessAlive(pid))
|
|
20
31
|
|| Date.now() - Number(previous.updatedAt ?? previous.timestamp ?? 0) < 30_000)
|
|
@@ -39,6 +50,8 @@ export function updateRestartRequest(filePath, requestId, update) {
|
|
|
39
50
|
const request = readRestartRequest(filePath, requestId);
|
|
40
51
|
if (!request)
|
|
41
52
|
return false;
|
|
53
|
+
if (['ready', 'failed', 'timeout'].includes(request.status) && update.status && update.status !== request.status)
|
|
54
|
+
return false;
|
|
42
55
|
atomicWriteJson(filePath, { ...request, ...update, updatedAt: Date.now() });
|
|
43
56
|
return true;
|
|
44
57
|
}
|
|
@@ -94,6 +94,8 @@ export async function startRequestedStartupCpuProfile(traceId) {
|
|
|
94
94
|
}
|
|
95
95
|
/** 保留的启动/停止次数(按 traceId 去重后) */
|
|
96
96
|
export const STARTUP_TRACE_KEEP = 50;
|
|
97
|
+
/** 中间快照最多每 250ms 保存一次;就绪和终态仍立即落盘。 */
|
|
98
|
+
const STARTUP_TRACE_SNAPSHOT_INTERVAL_MS = 250;
|
|
97
99
|
/** CLI 传 traceId 给 daemon 的环境变量,让两侧记录落进同一次启动。 */
|
|
98
100
|
export const STARTUP_TRACE_ID_ENV = 'EVOLCORE_STARTUP_TRACE_ID';
|
|
99
101
|
/** traceId 以时间前缀开头,按字典序即按时间序。 */
|
|
@@ -126,6 +128,7 @@ export class StartupTracer {
|
|
|
126
128
|
readyAtMs;
|
|
127
129
|
taskReadyAtMs;
|
|
128
130
|
pendingTasks = new Set();
|
|
131
|
+
persistTimer;
|
|
129
132
|
constructor(source, opts = {}) {
|
|
130
133
|
this.source = source;
|
|
131
134
|
this.kind = opts.kind ?? 'startup';
|
|
@@ -200,7 +203,7 @@ export class StartupTracer {
|
|
|
200
203
|
if (this.pendingTasks.size === 0)
|
|
201
204
|
this.finish(true);
|
|
202
205
|
else
|
|
203
|
-
this.
|
|
206
|
+
this.schedulePersist();
|
|
204
207
|
}
|
|
205
208
|
};
|
|
206
209
|
return Object.assign(settle, {
|
|
@@ -262,6 +265,8 @@ export class StartupTracer {
|
|
|
262
265
|
/** 放弃本次记录(未真正发生启动时用,比如 daemon 已在运行)。 */
|
|
263
266
|
discard() {
|
|
264
267
|
this.finished = true;
|
|
268
|
+
clearTimeout(this.persistTimer);
|
|
269
|
+
this.persistTimer = undefined;
|
|
265
270
|
}
|
|
266
271
|
/** 闭合最后阶段并落盘。重复调用无副作用。 */
|
|
267
272
|
finish(ok) {
|
|
@@ -276,7 +281,16 @@ export class StartupTracer {
|
|
|
276
281
|
this.finished = true;
|
|
277
282
|
this.persist(this.readyAtMs !== undefined || ok, now);
|
|
278
283
|
}
|
|
284
|
+
schedulePersist() {
|
|
285
|
+
if (this.persistTimer)
|
|
286
|
+
return;
|
|
287
|
+
// 不随每个完成回调重置计时,持续有任务完成时也能定期看到进度。
|
|
288
|
+
this.persistTimer = setTimeout(() => this.persist(true), STARTUP_TRACE_SNAPSHOT_INTERVAL_MS);
|
|
289
|
+
this.persistTimer.unref();
|
|
290
|
+
}
|
|
279
291
|
persist(ok, now = Date.now()) {
|
|
292
|
+
clearTimeout(this.persistTimer);
|
|
293
|
+
this.persistTimer = undefined;
|
|
280
294
|
const record = {
|
|
281
295
|
traceId: this.traceId,
|
|
282
296
|
kind: this.kind,
|
|
@@ -301,7 +315,7 @@ export class StartupTracer {
|
|
|
301
315
|
spans: this.spans,
|
|
302
316
|
};
|
|
303
317
|
try {
|
|
304
|
-
appendStartupTrace(record);
|
|
318
|
+
appendStartupTrace(record, this.finished);
|
|
305
319
|
}
|
|
306
320
|
catch {
|
|
307
321
|
// 埋点失败不能影响启动本身
|
|
@@ -339,11 +353,13 @@ export function processStartOfThisProcess() {
|
|
|
339
353
|
const uptimeMs = Math.round(process.uptime() * 1000);
|
|
340
354
|
return Date.now() - uptimeMs;
|
|
341
355
|
}
|
|
342
|
-
function appendStartupTrace(record) {
|
|
356
|
+
function appendStartupTrace(record, compact) {
|
|
343
357
|
const file = resolvePaths().lifecycleTrace;
|
|
344
358
|
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
345
359
|
fs.appendFileSync(file, `${JSON.stringify(record)}\n`, 'utf-8');
|
|
346
|
-
|
|
360
|
+
// 历史读取、拆行和去重只在生命周期结束时做一次,不能阻塞每个启动回调。
|
|
361
|
+
if (compact)
|
|
362
|
+
trimStartupTrace(file);
|
|
347
363
|
}
|
|
348
364
|
/** 只保留最近 STARTUP_TRACE_KEEP 个 traceId 的行;行数不多时跳过。 */
|
|
349
365
|
function trimStartupTrace(file) {
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
import fs from 'fs';
|
|
2
2
|
import os from 'os';
|
|
3
|
+
import path from 'node:path';
|
|
3
4
|
function readNumber(filePath) {
|
|
4
5
|
try {
|
|
5
|
-
const
|
|
6
|
-
|
|
6
|
+
const raw = fs.readFileSync(filePath, 'utf8').trim();
|
|
7
|
+
const value = /^\d+$/u.test(raw) ? Number(raw) : NaN;
|
|
8
|
+
return Number.isSafeInteger(value) && value >= 0 ? value : null;
|
|
7
9
|
}
|
|
8
10
|
catch {
|
|
9
11
|
return null;
|
|
@@ -19,39 +21,125 @@ export function parseCgroupV2MemoryStat(input) {
|
|
|
19
21
|
}
|
|
20
22
|
return values;
|
|
21
23
|
}
|
|
24
|
+
function readText(file) {
|
|
25
|
+
try {
|
|
26
|
+
return fs.readFileSync(file, 'utf8').trim();
|
|
27
|
+
}
|
|
28
|
+
catch {
|
|
29
|
+
return '';
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
function memoryHierarchies(cgroupRoot) {
|
|
33
|
+
if (cgroupRoot !== '/sys/fs/cgroup') {
|
|
34
|
+
return [{ directory: cgroupRoot, mountPoint: cgroupRoot, version: 2 }];
|
|
35
|
+
}
|
|
36
|
+
const memberships = readText('/proc/self/cgroup').split('\n')
|
|
37
|
+
.map(line => line.match(/^\d+:([^:]*):(\/.*)$/u))
|
|
38
|
+
.filter((match) => match !== null);
|
|
39
|
+
const hierarchies = [];
|
|
40
|
+
const decode = (value) => value.replace(/\\([0-7]{3})/gu, (_match, octal) => String.fromCharCode(Number.parseInt(octal, 8)));
|
|
41
|
+
for (const line of readText('/proc/self/mountinfo').split('\n')) {
|
|
42
|
+
const [mount, filesystem] = line.split(' - ');
|
|
43
|
+
if (!mount || !filesystem)
|
|
44
|
+
continue;
|
|
45
|
+
const fields = mount.split(' ');
|
|
46
|
+
const [type, , options = ''] = filesystem.split(' ');
|
|
47
|
+
if (type !== 'cgroup2' && !(type === 'cgroup' && options.split(',').includes('memory')))
|
|
48
|
+
continue;
|
|
49
|
+
if (!fields[3] || !fields[4])
|
|
50
|
+
continue;
|
|
51
|
+
const version = type === 'cgroup2' ? 2 : 1;
|
|
52
|
+
const member = memberships.find(match => version === 2
|
|
53
|
+
? match[1] === '' : match[1].split(',').includes('memory'));
|
|
54
|
+
if (!member)
|
|
55
|
+
continue;
|
|
56
|
+
const mountPoint = decode(fields[4]);
|
|
57
|
+
const relative = path.posix.relative(decode(fields[3]), member[2]);
|
|
58
|
+
const suffix = relative === '..' || relative.startsWith('../') ? member[2] : relative;
|
|
59
|
+
const directory = path.posix.resolve(mountPoint, `./${suffix}`);
|
|
60
|
+
if (directory === mountPoint || directory.startsWith(`${mountPoint}/`)) {
|
|
61
|
+
hierarchies.push({ directory, mountPoint, version });
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
if (hierarchies.length === 0) {
|
|
65
|
+
for (const [mountPoint, version] of [['/sys/fs/cgroup', 2], ['/sys/fs/cgroup/memory', 1]]) {
|
|
66
|
+
const member = memberships.find(match => version === 2
|
|
67
|
+
? match[1] === '' : match[1].split(',').includes('memory'));
|
|
68
|
+
const directory = path.posix.resolve(mountPoint, `.${member?.[2] ?? '/'}`);
|
|
69
|
+
if (directory === mountPoint || directory.startsWith(`${mountPoint}/`)) {
|
|
70
|
+
hierarchies.push({ directory, mountPoint, version });
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
return hierarchies;
|
|
75
|
+
}
|
|
22
76
|
/**
|
|
23
77
|
* System memory for the current container/host namespace.
|
|
24
78
|
*
|
|
25
|
-
*
|
|
26
|
-
*
|
|
27
|
-
*
|
|
28
|
-
*
|
|
79
|
+
* Total is bounded by visible cgroup hard limits, including ancestors. Usage
|
|
80
|
+
* excludes filesystem cache when available. Free is hard-limit headroom;
|
|
81
|
+
* available also includes the cache estimate, bounded by parent headroom and
|
|
82
|
+
* host free memory. These are estimates, not guarantees of future allocation.
|
|
29
83
|
*/
|
|
30
84
|
export function readSystemMemoryUsage(cgroupRoot = '/sys/fs/cgroup') {
|
|
31
|
-
const
|
|
32
|
-
const
|
|
85
|
+
const hostTotal = os.totalmem();
|
|
86
|
+
const hostAvailable = os.freemem();
|
|
87
|
+
let memTotal = hostTotal;
|
|
33
88
|
if (process.platform === 'linux') {
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
89
|
+
let headroom = hostAvailable;
|
|
90
|
+
let available = hostAvailable;
|
|
91
|
+
let usage;
|
|
92
|
+
for (const hierarchy of memoryHierarchies(cgroupRoot)) {
|
|
93
|
+
let directory = hierarchy.directory;
|
|
94
|
+
while (true) {
|
|
95
|
+
const limit = readNumber(`${directory}/${hierarchy.version === 2 ? 'memory.max' : 'memory.limit_in_bytes'}`);
|
|
96
|
+
const current = readNumber(`${directory}/${hierarchy.version === 2 ? 'memory.current' : 'memory.usage_in_bytes'}`);
|
|
97
|
+
const stat = parseCgroupV2MemoryStat(readText(`${directory}/memory.stat`));
|
|
98
|
+
const cache = hierarchy.version === 2 ? stat.get('file') : stat.get('total_cache') ?? stat.get('cache');
|
|
99
|
+
if (directory === hierarchy.directory && current !== null) {
|
|
100
|
+
usage = { current, cache, version: hierarchy.version };
|
|
101
|
+
}
|
|
102
|
+
// v1's unlimited sentinel exceeds safe integer precision and is ignored.
|
|
103
|
+
if (limit !== null) {
|
|
104
|
+
memTotal = Math.min(memTotal, limit);
|
|
105
|
+
if (current !== null) {
|
|
106
|
+
headroom = Math.min(headroom, Math.max(0, limit - current));
|
|
107
|
+
available = Math.min(available, Math.max(0, limit - Math.max(0, current - (cache ?? 0))));
|
|
108
|
+
}
|
|
50
109
|
}
|
|
110
|
+
if (directory === hierarchy.mountPoint)
|
|
111
|
+
break;
|
|
112
|
+
directory = path.posix.dirname(directory);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
if (usage) {
|
|
116
|
+
const { current, cache, version } = usage;
|
|
117
|
+
const memUsed = Math.min(memTotal, Math.max(0, current - (cache ?? 0)));
|
|
118
|
+
return {
|
|
119
|
+
memTotal, memUsed,
|
|
120
|
+
memFree: Math.min(headroom, Math.max(0, memTotal - current)),
|
|
121
|
+
memAvailable: Math.min(available, Math.max(0, memTotal - memUsed)),
|
|
122
|
+
memorySource: version === 2
|
|
123
|
+
? cache === undefined ? 'cgroup-v2-current' : 'cgroup-v2-current-minus-file'
|
|
124
|
+
: cache === undefined ? 'cgroup-v1-usage' : 'cgroup-v1-usage-minus-cache',
|
|
125
|
+
cgroupCurrent: current,
|
|
126
|
+
...(cache === undefined ? {} : { fileCache: cache }),
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
// Even if usage files are unreadable, keep a discovered hard limit and use
|
|
130
|
+
// Node's container-aware availability instead of subtracting host metrics.
|
|
131
|
+
if (memTotal < hostTotal) {
|
|
132
|
+
let memAvailable = 0;
|
|
133
|
+
try {
|
|
134
|
+
memAvailable = process.availableMemory();
|
|
51
135
|
}
|
|
52
|
-
catch { /*
|
|
136
|
+
catch { /* conservative fallback */ }
|
|
137
|
+
memAvailable = Number.isFinite(memAvailable) ? Math.max(0, Math.min(memTotal, hostAvailable, memAvailable)) : 0;
|
|
138
|
+
return { memTotal, memUsed: memTotal - memAvailable, memFree: memAvailable,
|
|
139
|
+
memAvailable, memorySource: 'runtime-available' };
|
|
53
140
|
}
|
|
54
141
|
}
|
|
142
|
+
const memAvailable = Math.max(0, Math.min(memTotal, hostAvailable));
|
|
55
143
|
return {
|
|
56
144
|
memTotal,
|
|
57
145
|
memUsed: Math.max(0, memTotal - memAvailable),
|