@octopi-agent/engine 0.98.4 → 0.121.10
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/dist/builtin-model-info.js +28 -7
- package/dist/config-admin/agent-presets.d.ts +32 -0
- package/dist/config-admin/agent-presets.js +133 -0
- package/dist/config-admin/discover.d.ts +33 -4
- package/dist/config-admin/discover.js +101 -6
- package/dist/config-admin/env.d.ts +11 -0
- package/dist/config-admin/env.js +41 -0
- package/dist/config-admin/error-copy.d.ts +106 -0
- package/dist/config-admin/error-copy.js +287 -0
- package/dist/config-admin/i18n.d.ts +21 -0
- package/dist/config-admin/i18n.js +19 -0
- package/dist/config-admin/index.d.ts +6 -2
- package/dist/config-admin/index.js +3 -1
- package/dist/config-admin/model-presets.d.ts +14 -0
- package/dist/config-admin/model-presets.js +595 -70
- package/dist/config-admin/onboarding-apply.d.ts +71 -0
- package/dist/config-admin/onboarding-apply.js +235 -0
- package/dist/config-admin/onboarding.d.ts +154 -0
- package/dist/config-admin/onboarding.js +270 -0
- package/dist/config-admin/redact.d.ts +42 -9
- package/dist/config-admin/redact.js +69 -5
- package/dist/config-schema/agent.d.ts +40 -6
- package/dist/config-schema/agent.js +44 -6
- package/dist/config-schema/browser.d.ts +62 -0
- package/dist/config-schema/browser.js +89 -0
- package/dist/config-schema/context.d.ts +12 -37
- package/dist/config-schema/context.js +10 -31
- package/dist/config-schema/engine.d.ts +140 -164
- package/dist/config-schema/engine.js +10 -7
- package/dist/config-schema/governance.d.ts +20 -2
- package/dist/config-schema/governance.js +18 -3
- package/dist/config-schema/models.d.ts +10 -12
- package/dist/config-schema/models.js +16 -3
- package/dist/config-schema/run.d.ts +6 -2
- package/dist/config-schema/run.js +12 -2
- package/dist/config-schema/shared.d.ts +1 -3
- package/dist/config-schema/shared.js +4 -4
- package/dist/config-schema/substrate.d.ts +19 -88
- package/dist/config-schema/substrate.js +30 -107
- package/dist/config.d.ts +161 -123
- package/dist/config.js +109 -7
- package/dist/file-mode.d.ts +67 -0
- package/dist/file-mode.js +182 -0
- package/dist/fork-child.d.ts +82 -0
- package/dist/fork-child.js +123 -0
- package/dist/harness/activation/delegated-run.d.ts +42 -0
- package/dist/harness/activation/delegated-run.js +71 -0
- package/dist/harness/activation/dispatcher.js +11 -0
- package/dist/harness/activation/inbox.d.ts +3 -3
- package/dist/harness/activation/inbox.js +3 -3
- package/dist/harness/activation/index.d.ts +1 -0
- package/dist/harness/activation/run-backend.d.ts +92 -0
- package/dist/harness/activation/run-backend.js +16 -0
- package/dist/harness/activation/run-protocol.d.ts +392 -0
- package/dist/harness/activation/run-protocol.js +19 -0
- package/dist/harness/activation/runtime.d.ts +33 -0
- package/dist/harness/activation/runtime.js +130 -31
- package/dist/harness/activation/types.d.ts +20 -3
- package/dist/harness/agent/builder.d.ts +36 -3
- package/dist/harness/agent/builder.js +206 -46
- package/dist/harness/agent/config-bridge.d.ts +10 -1
- package/dist/harness/agent/config-bridge.js +24 -5
- package/dist/harness/agent/config-integrity.js +19 -2
- package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
- package/dist/harness/agent/registered-tool-adapter.js +67 -0
- package/dist/harness/agent/wire-agent-builder.d.ts +13 -3
- package/dist/harness/agent/wire-agent-builder.js +35 -9
- package/dist/harness/capabilities/document/backends/plain.js +2 -1
- package/dist/harness/capabilities/document/factory.d.ts +5 -0
- package/dist/harness/capabilities/document/factory.js +1 -0
- package/dist/harness/capabilities/document/legacy/factory.js +3 -2
- package/dist/harness/capabilities/document/port.js +6 -3
- package/dist/harness/capabilities/document/types.d.ts +5 -0
- package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
- package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
- package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
- package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
- package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
- package/dist/harness/collaboration/autonomous-subsystem/loader.js +2 -1
- package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
- package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +14 -4
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +50 -41
- package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
- package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
- package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +4 -1
- package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +7 -3
- package/dist/harness/collaboration/delegation/child-run.d.ts +10 -1
- package/dist/harness/collaboration/delegation/child-run.js +38 -6
- package/dist/harness/collaboration/delegation/index.d.ts +1 -1
- package/dist/harness/collaboration/delegation/index.js +1 -1
- package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
- package/dist/harness/collaboration/delegation/notifier.js +8 -1
- package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
- package/dist/harness/collaboration/delegation/service.d.ts +11 -4
- package/dist/harness/collaboration/delegation/service.js +35 -13
- package/dist/harness/collaboration/delegation/store.d.ts +4 -0
- package/dist/harness/collaboration/delegation/store.js +3 -1
- package/dist/harness/collaboration/delegation/types.d.ts +34 -2
- package/dist/harness/collaboration/delegation/types.js +22 -0
- package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
- package/dist/harness/collaboration/delegation/wiring.js +12 -1
- package/dist/harness/context/budget-allocator.d.ts +26 -18
- package/dist/harness/context/budget-allocator.js +67 -32
- package/dist/harness/context/capabilities/compact/engine.d.ts +44 -11
- package/dist/harness/context/capabilities/compact/engine.js +296 -160
- package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
- package/dist/harness/context/capabilities/compact/handover.js +7 -5
- package/dist/harness/context/capabilities/compact/index.d.ts +7 -2
- package/dist/harness/context/capabilities/compact/index.js +5 -1
- package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
- package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
- package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
- package/dist/harness/context/capabilities/compact/messages.js +91 -0
- package/dist/harness/context/capabilities/compact/types.d.ts +134 -19
- package/dist/harness/context/capabilities/compact/types.js +11 -1
- package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
- package/dist/harness/context/capabilities/compact/view-split.js +72 -0
- package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
- package/dist/harness/context/capabilities/summary/gate.js +53 -6
- package/dist/harness/context/capabilities/summary/port.js +0 -1
- package/dist/harness/context/capabilities/summary/registry.js +20 -0
- package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
- package/dist/harness/context/capabilities/summary/resolver.js +1 -6
- package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
- package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
- package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
- package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
- package/dist/harness/context/capabilities/summary/types.d.ts +19 -6
- package/dist/harness/context/constitution/default-agents.md +85 -0
- package/dist/harness/context/context-size-ledger.d.ts +143 -0
- package/dist/harness/context/context-size-ledger.js +243 -0
- package/dist/harness/context/default-context-engine.d.ts +290 -120
- package/dist/harness/context/default-context-engine.js +1555 -764
- package/dist/harness/context/index.d.ts +3 -2
- package/dist/harness/context/index.js +2 -1
- package/dist/harness/context/layer-health.d.ts +4 -0
- package/dist/harness/context/layer-health.js +4 -0
- package/dist/harness/context/layer-types.d.ts +72 -0
- package/dist/harness/context/layer-types.js +87 -2
- package/dist/harness/context/layers.d.ts +17 -15
- package/dist/harness/context/layers.js +54 -17
- package/dist/harness/context/message-selector.d.ts +10 -8
- package/dist/harness/context/message-selector.js +49 -27
- package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
- package/dist/harness/context/prefix-fingerprint.js +52 -0
- package/dist/harness/context/summarize.d.ts +2 -2
- package/dist/harness/context/summarize.js +27 -2
- package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
- package/dist/harness/context/system-prompt-assembler.js +7 -3
- package/dist/harness/context/token-constants.d.ts +8 -6
- package/dist/harness/context/token-constants.js +8 -7
- package/dist/harness/context/token-estimate-fns.d.ts +37 -27
- package/dist/harness/context/token-estimate-fns.js +85 -66
- package/dist/harness/context/token-estimator.d.ts +27 -12
- package/dist/harness/context/token-estimator.js +120 -66
- package/dist/harness/context/token-segments.d.ts +88 -0
- package/dist/harness/context/token-segments.js +103 -0
- package/dist/harness/context/tool-result-aging.d.ts +109 -16
- package/dist/harness/context/tool-result-aging.js +220 -55
- package/dist/harness/context/tool-result-body.js +2 -0
- package/dist/harness/context/transform/anchors.d.ts +66 -0
- package/dist/harness/context/transform/anchors.js +125 -0
- package/dist/harness/context/transform/fold.d.ts +56 -0
- package/dist/harness/context/transform/fold.js +135 -0
- package/dist/harness/context/transform/migrate.d.ts +41 -0
- package/dist/harness/context/transform/migrate.js +69 -0
- package/dist/harness/context/transform/types.d.ts +129 -0
- package/dist/harness/context/transform/types.js +19 -0
- package/dist/harness/context/turn-envelope.d.ts +6 -3
- package/dist/harness/context/types.d.ts +196 -119
- package/dist/harness/context/types.js +25 -1
- package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
- package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
- package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
- package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
- package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
- package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
- package/dist/harness/extension/execution-environment/workspace.js +1 -1
- package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +28 -2
- package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
- package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
- package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
- package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
- package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
- package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
- package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
- package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
- package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
- package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
- package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
- package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +223 -222
- package/dist/harness/extension/plugin-ecosystem/plugins/api.js +218 -203
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +78 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +80 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
- package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
- package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +57 -114
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +279 -282
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +46 -484
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +123 -345
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +50 -223
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +144 -20
- package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +17 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
- package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
- package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
- package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
- package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
- package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
- package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
- package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +36 -8
- package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
- package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
- package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
- package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
- package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
- package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
- package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +19 -24
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
- package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
- package/dist/harness/governance/accounting/usage-ledger.js +23 -1
- package/dist/harness/governance/credentials/db.d.ts +9 -0
- package/dist/harness/governance/credentials/db.js +122 -31
- package/dist/harness/governance/credentials/store.d.ts +68 -7
- package/dist/harness/governance/credentials/store.js +177 -64
- package/dist/harness/governance/credentials/types.d.ts +13 -2
- package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
- package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
- package/dist/harness/governance/index.d.ts +1 -0
- package/dist/harness/governance/index.js +1 -0
- package/dist/harness/governance/registry/db.d.ts +32 -0
- package/dist/harness/governance/registry/db.js +142 -0
- package/dist/harness/governance/registry/index.d.ts +9 -0
- package/dist/harness/governance/registry/index.js +9 -0
- package/dist/harness/governance/registry/service.d.ts +381 -0
- package/dist/harness/governance/registry/service.js +825 -0
- package/dist/harness/governance/registry/types.d.ts +77 -0
- package/dist/harness/governance/registry/types.js +7 -0
- package/dist/harness/governance/security/capability-enforcer.js +1 -2
- package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
- package/dist/harness/governance/security/default-security-guard.js +12 -1
- package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
- package/dist/harness/governance/security/risk-evaluator.js +307 -21
- package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
- package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
- package/dist/harness/index.d.ts +17 -15
- package/dist/harness/index.js +9 -9
- package/dist/harness/knowledge/boot-config.d.ts +57 -0
- package/dist/harness/knowledge/boot-config.js +52 -0
- package/dist/harness/knowledge/catalog-types.d.ts +2 -0
- package/dist/harness/knowledge/client.d.ts +77 -9
- package/dist/harness/knowledge/client.js +95 -24
- package/dist/harness/knowledge/db.d.ts +16 -0
- package/dist/harness/knowledge/db.js +112 -41
- package/dist/harness/knowledge/describe-sample.d.ts +23 -0
- package/dist/harness/knowledge/describe-sample.js +58 -0
- package/dist/harness/knowledge/describe.d.ts +8 -0
- package/dist/harness/knowledge/describe.js +18 -2
- package/dist/harness/knowledge/engine-thread.js +11 -7
- package/dist/harness/knowledge/grounding.js +7 -2
- package/dist/harness/knowledge/http-app.d.ts +15 -0
- package/dist/harness/knowledge/http-app.js +117 -25
- package/dist/harness/knowledge/http-bridge.d.ts +15 -0
- package/dist/harness/knowledge/http-bridge.js +19 -0
- package/dist/harness/knowledge/http-params.d.ts +18 -0
- package/dist/harness/knowledge/http-params.js +24 -0
- package/dist/harness/knowledge/index.d.ts +2 -0
- package/dist/harness/knowledge/index.js +1 -0
- package/dist/harness/knowledge/knowledge-serve-child.js +5 -3
- package/dist/harness/knowledge/purge.js +5 -2
- package/dist/harness/knowledge/query-service.d.ts +25 -4
- package/dist/harness/knowledge/query-service.js +79 -43
- package/dist/harness/knowledge/query-worker-client.d.ts +14 -2
- package/dist/harness/knowledge/query-worker-client.js +8 -3
- package/dist/harness/knowledge/query-worker.js +9 -5
- package/dist/harness/knowledge/read-http.d.ts +2 -0
- package/dist/harness/knowledge/read-http.js +14 -3
- package/dist/harness/knowledge/retriever.d.ts +1 -1
- package/dist/harness/knowledge/retriever.js +1 -2
- package/dist/harness/knowledge/serve.d.ts +14 -8
- package/dist/harness/knowledge/serve.js +14 -6
- package/dist/harness/knowledge/source-store.d.ts +101 -5
- package/dist/harness/knowledge/source-store.js +323 -74
- package/dist/harness/knowledge/start-service-process.d.ts +41 -14
- package/dist/harness/knowledge/start-service-process.js +67 -96
- package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
- package/dist/harness/knowledge/tenant-gate.js +167 -0
- package/dist/harness/knowledge/types.d.ts +7 -0
- package/dist/harness/knowledge/writer-service.d.ts +55 -11
- package/dist/harness/knowledge/writer-service.js +200 -30
- package/dist/harness/knowledge/writer-worker-client.d.ts +19 -11
- package/dist/harness/knowledge/writer-worker-client.js +40 -5
- package/dist/harness/knowledge/writer-worker.js +20 -5
- package/dist/harness/memory/backfill-trigger.d.ts +10 -3
- package/dist/harness/memory/backfill-trigger.js +19 -19
- package/dist/harness/memory/cognition-seeds.d.ts +45 -0
- package/dist/harness/memory/cognition-seeds.js +67 -0
- package/dist/harness/memory/cognition.d.ts +12 -3
- package/dist/harness/memory/cognition.js +55 -35
- package/dist/harness/memory/conceptualizer.d.ts +11 -1
- package/dist/harness/memory/conceptualizer.js +10 -1
- package/dist/harness/memory/context-slice.d.ts +42 -0
- package/dist/harness/memory/context-slice.js +197 -0
- package/dist/harness/memory/health-probe.d.ts +8 -2
- package/dist/harness/memory/health-probe.js +10 -13
- package/dist/harness/memory/index.d.ts +5 -1
- package/dist/harness/memory/index.js +3 -1
- package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
- package/dist/harness/memory/sqlite/agent-db.js +9 -8
- package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
- package/dist/harness/memory/sqlite/cognition-store.js +103 -45
- package/dist/harness/memory/sqlite/memory-store.js +4 -0
- package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
- package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
- package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
- package/dist/harness/memory/types.d.ts +24 -6
- package/dist/harness/memory/wisdom-formation.d.ts +14 -3
- package/dist/harness/memory/wisdom-formation.js +85 -22
- package/dist/harness/memory/wisdom-gates.d.ts +14 -0
- package/dist/harness/memory/wisdom-gates.js +59 -19
- package/dist/harness/memory/wisdom.js +9 -0
- package/dist/harness/observability/observer/hub.d.ts +10 -0
- package/dist/harness/observability/observer/hub.js +120 -17
- package/dist/harness/observability/observer/types.d.ts +10 -6
- package/dist/harness/run/agent/agent.d.ts +40 -21
- package/dist/harness/run/agent/agent.js +67 -13
- package/dist/harness/run/agent/index.d.ts +1 -1
- package/dist/harness/run/budget/budget.d.ts +28 -10
- package/dist/harness/run/budget/budget.js +38 -15
- package/dist/harness/run/concurrency/tool-validator.js +4 -3
- package/dist/harness/run/model/index.d.ts +3 -1
- package/dist/harness/run/model/index.js +2 -1
- package/dist/harness/run/model/resolver.d.ts +4 -1
- package/dist/harness/run/model/resolver.js +36 -2
- package/dist/harness/run/model/run-scope.d.ts +2 -0
- package/dist/harness/run/model/run-scope.js +7 -0
- package/dist/harness/run/model/types.d.ts +22 -5
- package/dist/harness/run/model/types.js +3 -2
- package/dist/harness/run/model/window-truth.d.ts +37 -0
- package/dist/harness/run/model/window-truth.js +39 -0
- package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
- package/dist/harness/run/reliability/context-length-feedback.js +128 -0
- package/dist/harness/run/reliability/harness-events.d.ts +3 -3
- package/dist/harness/run/reliability/model-error-policy.js +4 -0
- package/dist/harness/run/reliability/run-agent.d.ts +32 -4
- package/dist/harness/run/reliability/run-agent.js +216 -63
- package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
- package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
- package/dist/harness/run/run-guard/default-run-guard.js +8 -8
- package/dist/harness/run/run-host.d.ts +302 -0
- package/dist/harness/run/run-host.js +978 -0
- package/dist/harness/run/run-scope.d.ts +48 -4
- package/dist/harness/run/run-scope.js +19 -1
- package/dist/harness/run/runner.d.ts +181 -39
- package/dist/harness/run/runner.js +654 -119
- package/dist/harness/session/attachments/index.d.ts +1 -0
- package/dist/harness/session/attachments/index.js +1 -0
- package/dist/harness/session/attachments/inject.d.ts +21 -10
- package/dist/harness/session/attachments/inject.js +76 -24
- package/dist/harness/session/attachments/recall-index.d.ts +70 -0
- package/dist/harness/session/attachments/recall-index.js +219 -0
- package/dist/harness/session/attachments/service.d.ts +21 -0
- package/dist/harness/session/attachments/service.js +258 -139
- package/dist/harness/session/attachments/types.d.ts +6 -0
- package/dist/harness/session/in-memory-store.js +13 -1
- package/dist/harness/session/schedules/service.d.ts +10 -2
- package/dist/harness/session/schedules/service.js +13 -2
- package/dist/harness/session/tasks/tools.js +12 -0
- package/dist/harness/session/transform-store.d.ts +136 -0
- package/dist/harness/session/transform-store.js +302 -0
- package/dist/harness/session/types.d.ts +11 -15
- package/dist/harness/shared/events/agent-event-map.d.ts +75 -13
- package/dist/harness/shared/events/agent-event-map.js +3 -2
- package/dist/harness/shared/events/scenario-events.d.ts +6 -6
- package/dist/harness/shared/types/agent-definition.d.ts +7 -2
- package/dist/index.d.ts +16 -18
- package/dist/index.js +9 -10
- package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
- package/dist/integration/agent-runtime/channel-message-source.js +4 -3
- package/dist/integration/browser/camoufox.d.ts +40 -0
- package/dist/integration/browser/camoufox.js +80 -0
- package/dist/integration/browser/index.d.ts +91 -0
- package/dist/integration/browser/index.js +110 -0
- package/dist/integration/browser/install.d.ts +47 -0
- package/dist/integration/browser/install.js +214 -0
- package/dist/integration/browser/playwright.d.ts +224 -0
- package/dist/integration/browser/playwright.js +925 -0
- package/dist/integration/browser/service.d.ts +41 -0
- package/dist/integration/browser/service.js +181 -0
- package/dist/integration/browser/stealth.d.ts +42 -0
- package/dist/integration/browser/stealth.js +104 -0
- package/dist/integration/observability/metrics.d.ts +6 -6
- package/dist/integration/observability/metrics.js +13 -13
- package/dist/integration/observability/observer-bridge.js +2 -2
- package/dist/integration/observability/trace-collector.d.ts +5 -5
- package/dist/integration/observability/trace-collector.js +34 -35
- package/dist/integration/observability/trace-events.d.ts +3 -3
- package/dist/integration/observability/trace-events.js +3 -3
- package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
- package/dist/integration/providers/anthropic-message-normalize.js +48 -0
- package/dist/integration/providers/anthropic.js +41 -3
- package/dist/integration/providers/fetch-timeout.d.ts +17 -0
- package/dist/integration/providers/fetch-timeout.js +24 -0
- package/dist/integration/providers/openai.d.ts +8 -0
- package/dist/integration/providers/openai.js +48 -2
- package/dist/integration/providers/usage.d.ts +1 -1
- package/dist/integration/providers/wire-dump-diff.js +2 -1
- package/dist/integration/providers/wire-dump.d.ts +57 -3
- package/dist/integration/providers/wire-dump.js +119 -6
- package/dist/integration/storage/archive-manager.d.ts +20 -2
- package/dist/integration/storage/archive-manager.js +34 -8
- package/dist/integration/storage/atomic-tmp.d.ts +12 -0
- package/dist/integration/storage/atomic-tmp.js +36 -0
- package/dist/integration/storage/jsonl.d.ts +10 -1
- package/dist/integration/storage/jsonl.js +155 -54
- package/dist/integration/storage/session-index.d.ts +5 -0
- package/dist/integration/storage/session-index.js +25 -4
- package/dist/integration/tools/assemble.d.ts +50 -0
- package/dist/integration/tools/assemble.js +137 -0
- package/dist/paths.d.ts +18 -0
- package/dist/paths.js +36 -0
- package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
- package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
- package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
- package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
- package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
- package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
- package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
- package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
- package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
- package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
- package/dist/subsystems/wisdom-steward/formation/config.yaml +4 -0
- package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
- package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
- package/package.json +14 -15
- package/dist/harness/context/hybrid-compressor.d.ts +0 -41
- package/dist/harness/context/hybrid-compressor.js +0 -159
- package/dist/harness/context/llm-summarizer.d.ts +0 -46
- package/dist/harness/context/llm-summarizer.js +0 -249
- package/dist/harness/context/smart-router.d.ts +0 -75
- package/dist/harness/context/smart-router.js +0 -118
- package/dist/harness/context/truncate-compressor.d.ts +0 -28
- package/dist/harness/context/truncate-compressor.js +0 -107
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
- package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
- package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
- package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
- package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
* 原则:原件 + .manifest.json 为权威;抽取/索引可重建。
|
|
7
7
|
*/
|
|
8
8
|
import { createHash, randomUUID } from 'node:crypto';
|
|
9
|
-
import { readFileSync } from 'node:fs';
|
|
9
|
+
import { readFileSync, statSync } from 'node:fs';
|
|
10
10
|
import { mkdir, rename, rm, writeFile } from 'node:fs/promises';
|
|
11
11
|
import { join } from 'node:path';
|
|
12
12
|
import { resolveSessionAttachmentsPaths } from './paths.js';
|
|
@@ -14,6 +14,20 @@ import { attachmentExtension, isPathInside, sanitizeAttachmentName } from './san
|
|
|
14
14
|
import { classifyAttachmentKind, extractCompanionName, extractText, isPlainReadable, } from './extract.js';
|
|
15
15
|
import { DEFAULT_ATTACHMENT_LIMITS, } from './types.js';
|
|
16
16
|
import { isDocumentExtractError } from '../../capabilities/document/errors.js';
|
|
17
|
+
import { SessionAttachmentRecallIndex, attachmentExtractHash } from './recall-index.js';
|
|
18
|
+
/** 同一进程内跨 Service 实例的 Session 写临界区,避免多文件上传末写覆盖。 */
|
|
19
|
+
const sessionWriteTails = new Map();
|
|
20
|
+
function serializeSessionWrite(sessionId, operation) {
|
|
21
|
+
const previous = sessionWriteTails.get(sessionId) ?? Promise.resolve();
|
|
22
|
+
const current = previous.then(operation, operation);
|
|
23
|
+
const tail = current.then(() => undefined, () => undefined);
|
|
24
|
+
sessionWriteTails.set(sessionId, tail);
|
|
25
|
+
void tail.finally(() => {
|
|
26
|
+
if (sessionWriteTails.get(sessionId) === tail)
|
|
27
|
+
sessionWriteTails.delete(sessionId);
|
|
28
|
+
});
|
|
29
|
+
return current;
|
|
30
|
+
}
|
|
17
31
|
export class SessionAttachmentService {
|
|
18
32
|
sessionsDir;
|
|
19
33
|
limits;
|
|
@@ -79,113 +93,195 @@ export class SessionAttachmentService {
|
|
|
79
93
|
* @throws 超限 / 类型不允许
|
|
80
94
|
*/
|
|
81
95
|
async save(sessionId, input) {
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
if (!ext && this.limits.allowedExtensions.length > 0) {
|
|
88
|
-
throw new Error('file type not allowed: missing extension');
|
|
89
|
-
}
|
|
90
|
-
const data = Buffer.isBuffer(input.data)
|
|
91
|
-
? input.data
|
|
92
|
-
: typeof input.data === 'string'
|
|
93
|
-
? Buffer.from(input.data, 'utf8')
|
|
94
|
-
: Buffer.from(input.data);
|
|
95
|
-
if (data.byteLength > this.limits.maxFileBytes) {
|
|
96
|
-
throw new Error(`file exceeds maxFileBytes (${this.limits.maxFileBytes})`);
|
|
97
|
-
}
|
|
98
|
-
const manifest = this.readManifest(sessionId);
|
|
99
|
-
const live = manifest.items.filter((i) => i.status !== 'promoted');
|
|
100
|
-
if (live.length >= this.limits.maxFiles) {
|
|
101
|
-
throw new Error(`too many attachments (max ${this.limits.maxFiles})`);
|
|
102
|
-
}
|
|
103
|
-
const total = live.reduce((s, i) => s + i.sizeBytes, 0) + data.byteLength;
|
|
104
|
-
if (total > this.limits.maxTotalBytes) {
|
|
105
|
-
throw new Error(`attachments exceed maxTotalBytes (${this.limits.maxTotalBytes})`);
|
|
106
|
-
}
|
|
107
|
-
const root = this.attachmentRoot(sessionId);
|
|
108
|
-
await mkdir(root, { recursive: true });
|
|
109
|
-
const uniqueName = this.uniqueName(live, name);
|
|
110
|
-
const abs = join(root, uniqueName);
|
|
111
|
-
if (!isPathInside(root, abs)) {
|
|
112
|
-
throw new Error('invalid attachment path');
|
|
113
|
-
}
|
|
114
|
-
await writeFile(abs, data);
|
|
115
|
-
const kind = classifyAttachmentKind(uniqueName);
|
|
116
|
-
const contentHash = createHash('sha256').update(data).digest('hex');
|
|
117
|
-
const item = {
|
|
118
|
-
id: `att_${randomUUID().slice(0, 12)}`,
|
|
119
|
-
name: uniqueName,
|
|
120
|
-
mime: input.mime ?? guessMime(uniqueName),
|
|
121
|
-
sizeBytes: data.byteLength,
|
|
122
|
-
contentHash: `sha256:${contentHash}`,
|
|
123
|
-
path: uniqueName,
|
|
124
|
-
status: 'ready',
|
|
125
|
-
kind,
|
|
126
|
-
createdAt: Date.now(),
|
|
127
|
-
};
|
|
128
|
-
if (isPlainReadable(kind, uniqueName)) {
|
|
129
|
-
item.extractPath = uniqueName;
|
|
130
|
-
const extracted = extractText(data, uniqueName, kind);
|
|
131
|
-
if (extracted) {
|
|
132
|
-
item.status = 'parsed';
|
|
133
|
-
item.parse = { ok: true, chars: extracted.chars };
|
|
96
|
+
return serializeSessionWrite(sessionId, async () => {
|
|
97
|
+
const name = sanitizeAttachmentName(input.name);
|
|
98
|
+
const ext = attachmentExtension(name);
|
|
99
|
+
if (this.limits.allowedExtensions.length > 0 && ext && !this.limits.allowedExtensions.includes(ext)) {
|
|
100
|
+
throw new Error(`file type not allowed: ${ext}`);
|
|
134
101
|
}
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
item.parse = { ok: false, error: 'binary content in text extension' };
|
|
102
|
+
if (!ext && this.limits.allowedExtensions.length > 0) {
|
|
103
|
+
throw new Error('file type not allowed: missing extension');
|
|
138
104
|
}
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
105
|
+
const data = Buffer.isBuffer(input.data)
|
|
106
|
+
? input.data
|
|
107
|
+
: typeof input.data === 'string'
|
|
108
|
+
? Buffer.from(input.data, 'utf8')
|
|
109
|
+
: Buffer.from(input.data);
|
|
110
|
+
if (data.byteLength > this.limits.maxFileBytes) {
|
|
111
|
+
throw new Error(`file exceeds maxFileBytes (${this.limits.maxFileBytes})`);
|
|
112
|
+
}
|
|
113
|
+
const manifest = this.readManifest(sessionId);
|
|
114
|
+
const live = manifest.items.filter((i) => i.status !== 'promoted');
|
|
115
|
+
if (live.length >= this.limits.maxFiles) {
|
|
116
|
+
throw new Error(`too many attachments (max ${this.limits.maxFiles})`);
|
|
117
|
+
}
|
|
118
|
+
const total = live.reduce((s, i) => s + i.sizeBytes, 0) + data.byteLength;
|
|
119
|
+
if (total > this.limits.maxTotalBytes) {
|
|
120
|
+
throw new Error(`attachments exceed maxTotalBytes (${this.limits.maxTotalBytes})`);
|
|
155
121
|
}
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
122
|
+
const root = this.attachmentRoot(sessionId);
|
|
123
|
+
await mkdir(root, { recursive: true });
|
|
124
|
+
const uniqueName = this.uniqueName(live, name);
|
|
125
|
+
const abs = join(root, uniqueName);
|
|
126
|
+
if (!isPathInside(root, abs)) {
|
|
127
|
+
throw new Error('invalid attachment path');
|
|
128
|
+
}
|
|
129
|
+
await writeFile(abs, data);
|
|
130
|
+
const kind = classifyAttachmentKind(uniqueName);
|
|
131
|
+
const contentHash = createHash('sha256').update(data).digest('hex');
|
|
132
|
+
const item = {
|
|
133
|
+
id: `att_${randomUUID().slice(0, 12)}`,
|
|
134
|
+
name: uniqueName,
|
|
135
|
+
mime: input.mime ?? guessMime(uniqueName),
|
|
136
|
+
sizeBytes: data.byteLength,
|
|
137
|
+
contentHash: `sha256:${contentHash}`,
|
|
138
|
+
path: uniqueName,
|
|
139
|
+
status: 'ready',
|
|
140
|
+
kind,
|
|
141
|
+
createdAt: Date.now(),
|
|
142
|
+
};
|
|
143
|
+
if (isPlainReadable(kind, uniqueName)) {
|
|
144
|
+
item.extractPath = uniqueName;
|
|
145
|
+
const extracted = extractText(data, uniqueName, kind);
|
|
146
|
+
if (extracted) {
|
|
147
|
+
item.status = 'parsed';
|
|
148
|
+
item.parse = { ok: true, chars: extracted.chars };
|
|
163
149
|
}
|
|
164
150
|
else {
|
|
165
|
-
item.
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
151
|
+
item.status = 'parse_failed';
|
|
152
|
+
item.parse = { ok: false, error: 'binary content in text extension' };
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
else if (kind === 'document' && this.documentPort) {
|
|
156
|
+
const companion = extractCompanionName(uniqueName);
|
|
157
|
+
item.extractPath = companion;
|
|
158
|
+
try {
|
|
159
|
+
const result = await this.documentPort.extract({
|
|
160
|
+
data: new Uint8Array(data),
|
|
161
|
+
name: uniqueName,
|
|
162
|
+
});
|
|
163
|
+
const absExtract = join(root, companion);
|
|
164
|
+
if (!isPathInside(root, absExtract)) {
|
|
165
|
+
throw new Error('invalid extract path');
|
|
166
|
+
}
|
|
167
|
+
await writeFile(absExtract, result.markdown);
|
|
168
|
+
item.status = 'parsed';
|
|
169
|
+
item.parse = { ok: true, chars: result.markdown.length };
|
|
170
|
+
}
|
|
171
|
+
catch (err) {
|
|
172
|
+
item.status = 'parse_failed';
|
|
173
|
+
if (isDocumentExtractError(err)) {
|
|
174
|
+
item.parse = {
|
|
175
|
+
ok: false,
|
|
176
|
+
error: `${err.code}${err.requires ? ` (requires: ${err.requires.join(',')})` : ''}`,
|
|
177
|
+
};
|
|
178
|
+
}
|
|
179
|
+
else {
|
|
180
|
+
item.parse = {
|
|
181
|
+
ok: false,
|
|
182
|
+
error: err instanceof Error ? err.message : String(err),
|
|
183
|
+
};
|
|
184
|
+
}
|
|
169
185
|
}
|
|
170
186
|
}
|
|
187
|
+
else if (kind === 'image') {
|
|
188
|
+
item.status = 'ready';
|
|
189
|
+
}
|
|
190
|
+
else if (kind === 'document') {
|
|
191
|
+
item.status = 'ready';
|
|
192
|
+
item.parse = {
|
|
193
|
+
ok: false,
|
|
194
|
+
error: 'document extract disabled (no DocumentPort)',
|
|
195
|
+
};
|
|
196
|
+
}
|
|
197
|
+
else {
|
|
198
|
+
item.status = 'ready';
|
|
199
|
+
item.parse = { ok: false, error: 'no extractor for this type (see OP adapter)' };
|
|
200
|
+
}
|
|
201
|
+
manifest.items.push(item);
|
|
202
|
+
await this.indexSavedAttachment(sessionId, item);
|
|
203
|
+
await this.writeManifest(sessionId, manifest);
|
|
204
|
+
return item;
|
|
205
|
+
});
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* 上传解析成功后默认建立 Session 私有关键词投影,不注册 Knowledge source。
|
|
209
|
+
* 索引是可重建降级面:失败不影响原件与抽取文本的保存。
|
|
210
|
+
*/
|
|
211
|
+
async indexSavedAttachment(sessionId, item) {
|
|
212
|
+
if (!item.extractPath || !item.parse?.ok)
|
|
213
|
+
return;
|
|
214
|
+
const root = this.attachmentRoot(sessionId);
|
|
215
|
+
const rel = item.extractPath;
|
|
216
|
+
const abs = join(root, rel);
|
|
217
|
+
if (!isPathInside(root, abs))
|
|
218
|
+
return;
|
|
219
|
+
try {
|
|
220
|
+
const text = readFileSync(abs, 'utf8');
|
|
221
|
+
await new SessionAttachmentRecallIndex(root).upsert(item, text, item.path);
|
|
222
|
+
const stat = statSync(abs);
|
|
223
|
+
Object.assign(item.parse, {
|
|
224
|
+
extractHash: attachmentExtractHash(item, text),
|
|
225
|
+
extractBytes: stat.size,
|
|
226
|
+
extractMtimeMs: stat.mtimeMs,
|
|
227
|
+
extractCtimeMs: stat.ctimeMs,
|
|
228
|
+
});
|
|
171
229
|
}
|
|
172
|
-
|
|
173
|
-
|
|
230
|
+
catch {
|
|
231
|
+
// 投影失败仅使本轮召回走 structure_tools,不损失附件读取能力。
|
|
174
232
|
}
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
233
|
+
}
|
|
234
|
+
/**
|
|
235
|
+
* 查询本轮附件的本地关键词召回;索引不可用由调用方回退 structure_tools。
|
|
236
|
+
*
|
|
237
|
+
* @param sessionId - 会话 id
|
|
238
|
+
* @param query - 局部检索焦点
|
|
239
|
+
* @param attachmentIds - 本轮已授权的附件范围
|
|
240
|
+
* @param limit - 全局 top-k
|
|
241
|
+
*/
|
|
242
|
+
async recall(sessionId, query, attachmentIds, limit) {
|
|
243
|
+
const attachments = attachmentIds
|
|
244
|
+
.map((id) => this.get(sessionId, id))
|
|
245
|
+
.filter((a) => a != null && a.status !== 'promoted');
|
|
246
|
+
try {
|
|
247
|
+
return await new SessionAttachmentRecallIndex(this.attachmentRoot(sessionId))
|
|
248
|
+
.search(query, attachments, limit);
|
|
181
249
|
}
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
250
|
+
catch {
|
|
251
|
+
// 缺失/损坏/陈旧索引:与零命中区分,统一由注入层回退 structure_tools。
|
|
252
|
+
return null;
|
|
185
253
|
}
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
254
|
+
}
|
|
255
|
+
/**
|
|
256
|
+
* 从 manifest + 完整抽取文本重建本地投影;全部读取成功后才替换旧投影。
|
|
257
|
+
* 普通发送不调用此重路径,索引不可用时仍按 structure_tools 降级。
|
|
258
|
+
*
|
|
259
|
+
* @param sessionId - 会话 id
|
|
260
|
+
*/
|
|
261
|
+
async rebuildRecall(sessionId) {
|
|
262
|
+
return serializeSessionWrite(sessionId, async () => {
|
|
263
|
+
const manifest = this.readManifest(sessionId);
|
|
264
|
+
const items = manifest.items
|
|
265
|
+
.filter((a) => a.status !== 'promoted' && a.extractPath && a.parse?.ok)
|
|
266
|
+
.map((attachment) => {
|
|
267
|
+
const text = this.readExtractedText(sessionId, attachment.id);
|
|
268
|
+
const stat = statSync(join(this.attachmentRoot(sessionId), attachment.extractPath));
|
|
269
|
+
return { attachment, text, stat, sourcePath: attachment.path };
|
|
270
|
+
});
|
|
271
|
+
if (items.some((item) => item.text == null)) {
|
|
272
|
+
throw new Error('attachment extract unavailable; recall index was not replaced');
|
|
273
|
+
}
|
|
274
|
+
await new SessionAttachmentRecallIndex(this.attachmentRoot(sessionId)).rebuild(items.map((item) => ({ ...item, text: item.text })));
|
|
275
|
+
for (const { attachment, text, stat } of items) {
|
|
276
|
+
Object.assign(attachment.parse, {
|
|
277
|
+
extractHash: attachmentExtractHash(attachment, text),
|
|
278
|
+
extractBytes: stat.size,
|
|
279
|
+
extractMtimeMs: stat.mtimeMs,
|
|
280
|
+
extractCtimeMs: stat.ctimeMs,
|
|
281
|
+
});
|
|
282
|
+
}
|
|
283
|
+
await this.writeManifest(sessionId, manifest);
|
|
284
|
+
});
|
|
189
285
|
}
|
|
190
286
|
/**
|
|
191
287
|
* 删除附件(原件 + 伴生 + manifest 条目)
|
|
@@ -194,29 +290,37 @@ export class SessionAttachmentService {
|
|
|
194
290
|
* @param attachmentId - 附件 id
|
|
195
291
|
*/
|
|
196
292
|
async delete(sessionId, attachmentId) {
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
const root = this.attachmentRoot(sessionId);
|
|
206
|
-
const absFile = join(root, item.path);
|
|
207
|
-
if (!isPathInside(root, absFile)) {
|
|
208
|
-
throw new Error('invalid attachment path in manifest');
|
|
209
|
-
}
|
|
210
|
-
await safeUnlink(absFile);
|
|
211
|
-
if (item.extractPath && item.extractPath !== item.path) {
|
|
212
|
-
const absExtract = join(root, item.extractPath);
|
|
213
|
-
if (isPathInside(root, absExtract)) {
|
|
214
|
-
await safeUnlink(absExtract);
|
|
293
|
+
return serializeSessionWrite(sessionId, async () => {
|
|
294
|
+
const manifest = this.readManifest(sessionId);
|
|
295
|
+
const idx = manifest.items.findIndex((i) => i.id === attachmentId);
|
|
296
|
+
if (idx < 0)
|
|
297
|
+
return false;
|
|
298
|
+
const item = manifest.items[idx];
|
|
299
|
+
if (item.status === 'promoted') {
|
|
300
|
+
throw new Error('attachment already promoted; delete from project source');
|
|
215
301
|
}
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
302
|
+
const root = this.attachmentRoot(sessionId);
|
|
303
|
+
const absFile = join(root, item.path);
|
|
304
|
+
if (!isPathInside(root, absFile)) {
|
|
305
|
+
throw new Error('invalid attachment path in manifest');
|
|
306
|
+
}
|
|
307
|
+
await safeUnlink(absFile);
|
|
308
|
+
if (item.extractPath && item.extractPath !== item.path) {
|
|
309
|
+
const absExtract = join(root, item.extractPath);
|
|
310
|
+
if (isPathInside(root, absExtract)) {
|
|
311
|
+
await safeUnlink(absExtract);
|
|
312
|
+
}
|
|
313
|
+
}
|
|
314
|
+
manifest.items.splice(idx, 1);
|
|
315
|
+
try {
|
|
316
|
+
await new SessionAttachmentRecallIndex(root).remove(attachmentId);
|
|
317
|
+
}
|
|
318
|
+
catch {
|
|
319
|
+
// 索引缺失/损坏时已不可召回;原件与登记删除仍须完成。
|
|
320
|
+
}
|
|
321
|
+
await this.writeManifest(sessionId, manifest);
|
|
322
|
+
return true;
|
|
323
|
+
});
|
|
220
324
|
}
|
|
221
325
|
/**
|
|
222
326
|
* 会话删除 / 归档清理:移除整个附件目录
|
|
@@ -224,8 +328,10 @@ export class SessionAttachmentService {
|
|
|
224
328
|
* @param sessionId - 会话 id
|
|
225
329
|
*/
|
|
226
330
|
async deleteAll(sessionId) {
|
|
227
|
-
|
|
228
|
-
|
|
331
|
+
return serializeSessionWrite(sessionId, async () => {
|
|
332
|
+
const root = this.attachmentRoot(sessionId);
|
|
333
|
+
await rm(root, { recursive: true, force: true });
|
|
334
|
+
});
|
|
229
335
|
}
|
|
230
336
|
/**
|
|
231
337
|
* 标记已绑定可检索 source
|
|
@@ -235,13 +341,15 @@ export class SessionAttachmentService {
|
|
|
235
341
|
* @param sourceId - Knowledge source id
|
|
236
342
|
*/
|
|
237
343
|
async markSearchable(sessionId, attachmentId, sourceId) {
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
344
|
+
return serializeSessionWrite(sessionId, async () => {
|
|
345
|
+
const manifest = this.readManifest(sessionId);
|
|
346
|
+
const item = manifest.items.find((i) => i.id === attachmentId);
|
|
347
|
+
if (!item)
|
|
348
|
+
throw new Error(`attachment not found: ${attachmentId}`);
|
|
349
|
+
item.searchableSourceId = sourceId;
|
|
350
|
+
await this.writeManifest(sessionId, manifest);
|
|
351
|
+
return item;
|
|
352
|
+
});
|
|
245
353
|
}
|
|
246
354
|
/**
|
|
247
355
|
* 标记已归入项目(文件移出后调用)
|
|
@@ -251,14 +359,22 @@ export class SessionAttachmentService {
|
|
|
251
359
|
* @param info - 项目信息
|
|
252
360
|
*/
|
|
253
361
|
async markPromoted(sessionId, attachmentId, info) {
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
362
|
+
return serializeSessionWrite(sessionId, async () => {
|
|
363
|
+
const manifest = this.readManifest(sessionId);
|
|
364
|
+
const item = manifest.items.find((i) => i.id === attachmentId);
|
|
365
|
+
if (!item)
|
|
366
|
+
throw new Error(`attachment not found: ${attachmentId}`);
|
|
367
|
+
item.status = 'promoted';
|
|
368
|
+
item.promoted = { ...info, at: Date.now() };
|
|
369
|
+
try {
|
|
370
|
+
await new SessionAttachmentRecallIndex(this.attachmentRoot(sessionId)).remove(attachmentId);
|
|
371
|
+
}
|
|
372
|
+
catch {
|
|
373
|
+
// 可重建投影清理失败不阻断权威 promote 状态迁移。
|
|
374
|
+
}
|
|
375
|
+
await this.writeManifest(sessionId, manifest);
|
|
376
|
+
return item;
|
|
377
|
+
});
|
|
262
378
|
}
|
|
263
379
|
/**
|
|
264
380
|
* 绝对路径(工具 / promote 用)
|
|
@@ -320,14 +436,17 @@ export class SessionAttachmentService {
|
|
|
320
436
|
const parsed = JSON.parse(raw);
|
|
321
437
|
return { sessionId, version: 1, items: parsed.items ?? [] };
|
|
322
438
|
}
|
|
323
|
-
catch {
|
|
324
|
-
|
|
439
|
+
catch (err) {
|
|
440
|
+
if (err.code === 'ENOENT') {
|
|
441
|
+
return { sessionId, version: 1, items: [] };
|
|
442
|
+
}
|
|
443
|
+
throw err;
|
|
325
444
|
}
|
|
326
445
|
}
|
|
327
446
|
async writeManifest(sessionId, manifest) {
|
|
328
447
|
const { root, manifestPath } = resolveSessionAttachmentsPaths(this.sessionsDir, sessionId);
|
|
329
448
|
await mkdir(root, { recursive: true });
|
|
330
|
-
const tmp = `${manifestPath}.${process.pid}.tmp`;
|
|
449
|
+
const tmp = `${manifestPath}.${process.pid}.${randomUUID()}.tmp`;
|
|
331
450
|
await writeFile(tmp, JSON.stringify(manifest, null, 2));
|
|
332
451
|
await rename(tmp, manifestPath);
|
|
333
452
|
}
|
|
@@ -9,6 +9,12 @@ export interface AttachmentParseInfo {
|
|
|
9
9
|
ok: boolean;
|
|
10
10
|
chars?: number;
|
|
11
11
|
error?: string;
|
|
12
|
+
/** sha256(originalHash + NUL + fullExtractText),由解析/索引构建写入 */
|
|
13
|
+
extractHash?: string;
|
|
14
|
+
/** 抽取文件建索引时的大小与 mtime/ctime;代次变化才重读全文验 hash */
|
|
15
|
+
extractBytes?: number;
|
|
16
|
+
extractMtimeMs?: number;
|
|
17
|
+
extractCtimeMs?: number;
|
|
12
18
|
}
|
|
13
19
|
/** 单条会话附件(manifest 条目) */
|
|
14
20
|
export interface SessionAttachment {
|
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
*
|
|
7
7
|
* @layer harness/session — Session 域纯内存默认实现(非生产落盘后端)。
|
|
8
8
|
*/
|
|
9
|
+
import { DEFAULT_TENANT_ID } from '@octopi-agent/core/types.js';
|
|
9
10
|
import { readTitleState, sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
|
|
10
11
|
function toIndexPick(s) {
|
|
11
12
|
return {
|
|
@@ -44,7 +45,13 @@ export class InMemorySessionStore {
|
|
|
44
45
|
metadata.titleSource = freshTitle.titleSource;
|
|
45
46
|
metadata.titleUpdatedAt = freshTitle.titleUpdatedAt;
|
|
46
47
|
}
|
|
47
|
-
|
|
48
|
+
// spawnBy 只增不清(与 JsonlSessionStore.save 同口径):陈旧整包 save 不得抹掉委派关联(D7)
|
|
49
|
+
this.sessions.set(sessionId, {
|
|
50
|
+
...data,
|
|
51
|
+
id: sessionId,
|
|
52
|
+
metadata,
|
|
53
|
+
spawnBy: data.spawnBy ?? prev?.spawnBy,
|
|
54
|
+
});
|
|
48
55
|
}
|
|
49
56
|
async updateMetadata(sessionId, mutate) {
|
|
50
57
|
const prev = this.sessions.get(sessionId);
|
|
@@ -74,8 +81,11 @@ export class InMemorySessionStore {
|
|
|
74
81
|
const values = Array.from(this.sessions.values());
|
|
75
82
|
return values
|
|
76
83
|
.filter((s) => (filter?.agentId ? sessionMatchesAgent(toIndexPick(s), filter.agentId) : true))
|
|
84
|
+
// 历史缺省视作 DEFAULT_TENANT_ID(与 JsonlSessionStore.list 同规则,共享常量保证)
|
|
85
|
+
.filter((s) => (filter?.tenantId ? (s.tenantId ?? DEFAULT_TENANT_ID) === filter.tenantId : true))
|
|
77
86
|
.map((s) => ({
|
|
78
87
|
...s.meta,
|
|
88
|
+
tenantId: s.tenantId,
|
|
79
89
|
primaryAgentId: s.primaryAgentId ?? s.meta.primaryAgentId,
|
|
80
90
|
preferredAgentId: s.preferredAgentId ?? s.meta.preferredAgentId,
|
|
81
91
|
participantAgentIds: toIndexPick(s).participantAgentIds,
|
|
@@ -83,6 +93,8 @@ export class InMemorySessionStore {
|
|
|
83
93
|
pinnedAt: typeof s.metadata?.pinnedAt === 'number' && Number.isFinite(s.metadata.pinnedAt)
|
|
84
94
|
? s.metadata.pinnedAt
|
|
85
95
|
: s.meta.pinnedAt,
|
|
96
|
+
// 与 JsonlSessionStore.buildIndexEntry 同规则:委派来源投影(D7)
|
|
97
|
+
spawnBy: s.spawnBy,
|
|
86
98
|
// 与 JsonlSessionStore.buildIndexEntry 同规则:标题权威在 metadata 三键(无旧数据回退)
|
|
87
99
|
...readTitleState(s.metadata),
|
|
88
100
|
}));
|
|
@@ -71,9 +71,14 @@ export declare class SessionScheduleService {
|
|
|
71
71
|
private coalesceSeen;
|
|
72
72
|
constructor(options?: SessionScheduleServiceOptions);
|
|
73
73
|
/**
|
|
74
|
-
*
|
|
74
|
+
* 打开/建库。幂等(先开者语义为准)。
|
|
75
|
+
*
|
|
76
|
+
* @param options - `arm: false` = 只开 store 不重臂/不起 tick(执行面用:§5.4
|
|
77
|
+
* 触发面唯一在 gateway,run 节点若重臂会把到期作业经空 wakeup 静默消费)
|
|
75
78
|
*/
|
|
76
|
-
open(
|
|
79
|
+
open(options?: {
|
|
80
|
+
arm?: boolean;
|
|
81
|
+
}): Promise<void>;
|
|
77
82
|
/** 兜底扫描:防 timer 丢失(P1) */
|
|
78
83
|
private startTick;
|
|
79
84
|
/**
|
|
@@ -163,6 +168,9 @@ export declare class SessionScheduleService {
|
|
|
163
168
|
*/
|
|
164
169
|
purgeSession(sessionId: string): number;
|
|
165
170
|
private disarm;
|
|
171
|
+
/** store-only 模式(执行面,open({arm:false})):不点火/不起 tick/不自消费——
|
|
172
|
+
* set/update/resume 经本口也不得 arm(否则到期作业被空 wakeup 静默消费)。 */
|
|
173
|
+
private armEnabled;
|
|
166
174
|
private arm;
|
|
167
175
|
private rearmAll;
|
|
168
176
|
/** 测试/手动触发(穿冷却语义:仅 active) */
|
|
@@ -69,13 +69,19 @@ export class SessionScheduleService {
|
|
|
69
69
|
this.notify = options.notify;
|
|
70
70
|
}
|
|
71
71
|
/**
|
|
72
|
-
*
|
|
72
|
+
* 打开/建库。幂等(先开者语义为准)。
|
|
73
|
+
*
|
|
74
|
+
* @param options - `arm: false` = 只开 store 不重臂/不起 tick(执行面用:§5.4
|
|
75
|
+
* 触发面唯一在 gateway,run 节点若重臂会把到期作业经空 wakeup 静默消费)
|
|
73
76
|
*/
|
|
74
|
-
async open() {
|
|
77
|
+
async open(options) {
|
|
75
78
|
if (this.opened)
|
|
76
79
|
return;
|
|
77
80
|
this.store = await SessionScheduleStore.create(this.options);
|
|
78
81
|
this.opened = true;
|
|
82
|
+
this.armEnabled = options?.arm !== false;
|
|
83
|
+
if (!this.armEnabled)
|
|
84
|
+
return;
|
|
79
85
|
this.rearmAll();
|
|
80
86
|
this.startTick();
|
|
81
87
|
}
|
|
@@ -460,7 +466,12 @@ export class SessionScheduleService {
|
|
|
460
466
|
}
|
|
461
467
|
this.firing.delete(id);
|
|
462
468
|
}
|
|
469
|
+
/** store-only 模式(执行面,open({arm:false})):不点火/不起 tick/不自消费——
|
|
470
|
+
* set/update/resume 经本口也不得 arm(否则到期作业被空 wakeup 静默消费)。 */
|
|
471
|
+
armEnabled = true;
|
|
463
472
|
arm(schedule) {
|
|
473
|
+
if (!this.armEnabled)
|
|
474
|
+
return;
|
|
464
475
|
if (schedule.status !== 'active')
|
|
465
476
|
return;
|
|
466
477
|
this.disarm(schedule.id);
|
|
@@ -50,6 +50,18 @@ export function createTaskListTool(service) {
|
|
|
50
50
|
},
|
|
51
51
|
},
|
|
52
52
|
},
|
|
53
|
+
/**
|
|
54
|
+
* 结果老化:**整体丢弃**,只留「调用发生过」的最小标记。
|
|
55
|
+
*
|
|
56
|
+
* 依据:任务状态在本请求里已有**活读**副本——`renderSessionTasksInjection(session.tasks)`
|
|
57
|
+
* 每次 run 起点注入 `<session_tasks>`(未完成 goal 的 id / status / description /
|
|
58
|
+
* 步骤进度 / 进展备注)。所以旧的 task_list 结果不是信息补充,而是**同一信息的
|
|
59
|
+
* 过期副本**;而 task_list 是本地查询、零网络成本,重查比读副本更准。
|
|
60
|
+
*
|
|
61
|
+
* 不给「计数摘要」:计数器没有时态标记,40 条消息后会被读成当前事实;
|
|
62
|
+
* 活注入写的是「当前会话未完成任务」,时态明确。
|
|
63
|
+
*/
|
|
64
|
+
ageResult: () => '[stale task_list] call task_list again for current tasks',
|
|
53
65
|
handler: async (args, context) => {
|
|
54
66
|
const status = args.status;
|
|
55
67
|
const parentId = args.parent_id;
|