@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
|
@@ -25,6 +25,11 @@ export interface ArchiveManagerOptions {
|
|
|
25
25
|
forceArchiveDays?: number;
|
|
26
26
|
/** 可选 EventBus:归档成功后 emit session.ended */
|
|
27
27
|
events?: EventBus;
|
|
28
|
+
/** Optional Host observation after archive export and hot-store deletion. */
|
|
29
|
+
onSessionArchived?: (event: {
|
|
30
|
+
sessionId: string;
|
|
31
|
+
agentId: string;
|
|
32
|
+
}) => void | Promise<void>;
|
|
28
33
|
}
|
|
29
34
|
export declare class SessionArchiveManager {
|
|
30
35
|
private store;
|
|
@@ -33,6 +38,7 @@ export declare class SessionArchiveManager {
|
|
|
33
38
|
private archiveRetentionMs;
|
|
34
39
|
private forceArchiveMs;
|
|
35
40
|
private events?;
|
|
41
|
+
private onSessionArchived?;
|
|
36
42
|
/**
|
|
37
43
|
* @param store - SessionStore(契约级;不绑具体后端)
|
|
38
44
|
* @param options - 归档目录与保留策略
|
|
@@ -54,14 +60,26 @@ export declare class SessionArchiveManager {
|
|
|
54
60
|
private appendToArchive;
|
|
55
61
|
/**
|
|
56
62
|
* 查询归档中的 session
|
|
63
|
+
*
|
|
64
|
+
* @param sessionId - 会话 id
|
|
65
|
+
* @param opts - 租户收口(§9.1-2,T4b):带 tenantId 时越域视为不存在(不泄漏存在性)
|
|
57
66
|
*/
|
|
58
|
-
queryArchive(sessionId: string
|
|
67
|
+
queryArchive(sessionId: string, opts?: {
|
|
68
|
+
tenantId?: string;
|
|
69
|
+
}): Promise<SessionData | null>;
|
|
59
70
|
/**
|
|
60
71
|
* 列出归档中的 session 元数据
|
|
72
|
+
*
|
|
73
|
+
* @param filter - agentId / tenantId(§9.1-2,T4b):带 tenantId 时只列本域;
|
|
74
|
+
* 兼容旧签名(string = agentId)——绝不静默放宽语义(评审 MIN-3)
|
|
61
75
|
*/
|
|
62
|
-
listArchived(
|
|
76
|
+
listArchived(filter?: string | {
|
|
77
|
+
agentId?: string;
|
|
78
|
+
tenantId?: string;
|
|
79
|
+
}): Promise<Array<{
|
|
63
80
|
sessionId: string;
|
|
64
81
|
agentId: string;
|
|
82
|
+
tenantId?: string;
|
|
65
83
|
archivedAt: number;
|
|
66
84
|
}>>;
|
|
67
85
|
/**
|
|
@@ -11,10 +11,12 @@
|
|
|
11
11
|
*
|
|
12
12
|
* @module
|
|
13
13
|
*/
|
|
14
|
-
import { mkdir, readdir, stat, unlink, readFile
|
|
14
|
+
import { mkdir, readdir, stat, unlink, readFile } from 'node:fs/promises';
|
|
15
15
|
import { gzip, gunzip } from 'node:zlib';
|
|
16
16
|
import { promisify } from 'node:util';
|
|
17
17
|
import { join } from 'node:path';
|
|
18
|
+
import { atomicWriteFile } from './atomic-tmp.js';
|
|
19
|
+
import { DEFAULT_TENANT_ID } from '@octopi-agent/core/types.js';
|
|
18
20
|
import { sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
|
|
19
21
|
export class SessionArchiveManager {
|
|
20
22
|
store;
|
|
@@ -23,6 +25,7 @@ export class SessionArchiveManager {
|
|
|
23
25
|
archiveRetentionMs;
|
|
24
26
|
forceArchiveMs;
|
|
25
27
|
events;
|
|
28
|
+
onSessionArchived;
|
|
26
29
|
/**
|
|
27
30
|
* @param store - SessionStore(契约级;不绑具体后端)
|
|
28
31
|
* @param options - 归档目录与保留策略
|
|
@@ -34,6 +37,7 @@ export class SessionArchiveManager {
|
|
|
34
37
|
this.archiveRetentionMs = (options.archiveRetentionDays ?? 180) * 24 * 60 * 60 * 1000;
|
|
35
38
|
this.forceArchiveMs = (options.forceArchiveDays ?? 90) * 24 * 60 * 60 * 1000;
|
|
36
39
|
this.events = options.events;
|
|
40
|
+
this.onSessionArchived = options.onSessionArchived;
|
|
37
41
|
}
|
|
38
42
|
/**
|
|
39
43
|
* 执行归档流程
|
|
@@ -93,6 +97,14 @@ export class SessionArchiveManager {
|
|
|
93
97
|
sessionId: session.id,
|
|
94
98
|
data: { reason: 'archived' },
|
|
95
99
|
});
|
|
100
|
+
if (this.onSessionArchived) {
|
|
101
|
+
try {
|
|
102
|
+
await this.onSessionArchived({ sessionId: session.id, agentId: session.agentId });
|
|
103
|
+
}
|
|
104
|
+
catch {
|
|
105
|
+
// Observation cannot undo a completed archive; its adapter records the failure.
|
|
106
|
+
}
|
|
107
|
+
}
|
|
96
108
|
}
|
|
97
109
|
/**
|
|
98
110
|
* 追加一条记录到压缩归档文件(temp + rename,避免截断式写坏当月冷备)
|
|
@@ -110,15 +122,18 @@ export class SessionArchiveManager {
|
|
|
110
122
|
}
|
|
111
123
|
const newContent = existing + line;
|
|
112
124
|
const compressed = await this.compress(Buffer.from(newContent, 'utf-8'));
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
await
|
|
125
|
+
// tmp+rename 原子落位(读侧不见半截)。已知局限(评审 del-3c3fcfeb MIN-3):
|
|
126
|
+
// existing+line 的读改写无并发串行,同文件并发追加会丢行——当前 runArchive
|
|
127
|
+
// 顺序执行无触发点;启用归档调度前必须按文件路径串行化(arch/open-problems.md)。
|
|
128
|
+
await atomicWriteFile(filePath, compressed);
|
|
117
129
|
}
|
|
118
130
|
/**
|
|
119
131
|
* 查询归档中的 session
|
|
132
|
+
*
|
|
133
|
+
* @param sessionId - 会话 id
|
|
134
|
+
* @param opts - 租户收口(§9.1-2,T4b):带 tenantId 时越域视为不存在(不泄漏存在性)
|
|
120
135
|
*/
|
|
121
|
-
async queryArchive(sessionId) {
|
|
136
|
+
async queryArchive(sessionId, opts) {
|
|
122
137
|
const files = await this.listArchiveFiles();
|
|
123
138
|
for (const file of files) {
|
|
124
139
|
try {
|
|
@@ -128,6 +143,9 @@ export class SessionArchiveManager {
|
|
|
128
143
|
for (const line of lines) {
|
|
129
144
|
const entry = JSON.parse(line);
|
|
130
145
|
if (entry.sessionId === sessionId) {
|
|
146
|
+
if (opts?.tenantId !== undefined && (entry.data.meta?.tenantId ?? DEFAULT_TENANT_ID) !== opts.tenantId) {
|
|
147
|
+
return null;
|
|
148
|
+
}
|
|
131
149
|
return entry.data;
|
|
132
150
|
}
|
|
133
151
|
}
|
|
@@ -140,8 +158,12 @@ export class SessionArchiveManager {
|
|
|
140
158
|
}
|
|
141
159
|
/**
|
|
142
160
|
* 列出归档中的 session 元数据
|
|
161
|
+
*
|
|
162
|
+
* @param filter - agentId / tenantId(§9.1-2,T4b):带 tenantId 时只列本域;
|
|
163
|
+
* 兼容旧签名(string = agentId)——绝不静默放宽语义(评审 MIN-3)
|
|
143
164
|
*/
|
|
144
|
-
async listArchived(
|
|
165
|
+
async listArchived(filter) {
|
|
166
|
+
const normalized = typeof filter === 'string' ? { agentId: filter } : (filter ?? {});
|
|
145
167
|
const files = await this.listArchiveFiles();
|
|
146
168
|
const results = [];
|
|
147
169
|
for (const file of files) {
|
|
@@ -152,10 +174,14 @@ export class SessionArchiveManager {
|
|
|
152
174
|
for (const line of lines) {
|
|
153
175
|
const entry = JSON.parse(line);
|
|
154
176
|
const pick = toIndexPick(entry.data);
|
|
155
|
-
|
|
177
|
+
const entryTenant = entry.data.meta?.tenantId ?? DEFAULT_TENANT_ID;
|
|
178
|
+
if (normalized.tenantId !== undefined && entryTenant !== normalized.tenantId)
|
|
179
|
+
continue;
|
|
180
|
+
if (!normalized.agentId || sessionMatchesAgent(pick, normalized.agentId)) {
|
|
156
181
|
results.push({
|
|
157
182
|
sessionId: entry.sessionId,
|
|
158
183
|
agentId: entry.data.agentId,
|
|
184
|
+
tenantId: entryTenant,
|
|
159
185
|
archivedAt: entry.archivedAt,
|
|
160
186
|
});
|
|
161
187
|
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export declare function atomicTmpPath(target: string): string;
|
|
2
|
+
/**
|
|
3
|
+
* tmp+rename 原子整文件写:读侧任何时刻只见旧版或新版,绝不见半截。
|
|
4
|
+
*
|
|
5
|
+
* (T5 演练实锤 2026-11-14:截断式 writeFile 并发读曾 254/320 次读到空转录,
|
|
6
|
+
* load→save 放大链路会把转录永久清空。)
|
|
7
|
+
*
|
|
8
|
+
* @param target - 目标文件路径
|
|
9
|
+
* @param content - 整文件内容
|
|
10
|
+
* @returns 写入完成(rename 落位)的 Promise
|
|
11
|
+
*/
|
|
12
|
+
export declare function atomicWriteFile(target: string, content: string | Buffer): Promise<void>;
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { writeFile, rename } from 'node:fs/promises';
|
|
2
|
+
/**
|
|
3
|
+
* 原子写 tmp 路径命名(按「写操作」唯一)。
|
|
4
|
+
*
|
|
5
|
+
* tmp+rename 原子写的前提:tmp 名在同一目标上绝不复用。仅 pid+毫秒 不够——
|
|
6
|
+
* 同毫秒双写共用 tmp 名:先到者 rename 走 tmp,后到者 rename ENOENT;更糟时
|
|
7
|
+
* 后到者 writeFile 的半截被 rename 进目标(静默损坏)。T5 演练实锤 2026-11-14
|
|
8
|
+
* (sessions.json 元索引同毫秒双写)。
|
|
9
|
+
*
|
|
10
|
+
* 前提声明:唯一性成立域是**单机**(pid 不撞);多机共享同一 OCTOPI_HOME(P2
|
|
11
|
+
* 拓扑)时补 random 段兜底。进程内另以单调序号断言同 ms 不复用。
|
|
12
|
+
*
|
|
13
|
+
* @param target - 目标文件路径
|
|
14
|
+
* @returns 该次写操作专属的 tmp 路径(pid + 毫秒 + 进程内单调序号 + 随机段)
|
|
15
|
+
*/
|
|
16
|
+
let seq = 0;
|
|
17
|
+
export function atomicTmpPath(target) {
|
|
18
|
+
seq += 1;
|
|
19
|
+
const rand = Math.random().toString(36).slice(2, 8);
|
|
20
|
+
return `${target}.${process.pid}.${Date.now()}.${seq}.${rand}.tmp`;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* tmp+rename 原子整文件写:读侧任何时刻只见旧版或新版,绝不见半截。
|
|
24
|
+
*
|
|
25
|
+
* (T5 演练实锤 2026-11-14:截断式 writeFile 并发读曾 254/320 次读到空转录,
|
|
26
|
+
* load→save 放大链路会把转录永久清空。)
|
|
27
|
+
*
|
|
28
|
+
* @param target - 目标文件路径
|
|
29
|
+
* @param content - 整文件内容
|
|
30
|
+
* @returns 写入完成(rename 落位)的 Promise
|
|
31
|
+
*/
|
|
32
|
+
export async function atomicWriteFile(target, content) {
|
|
33
|
+
const tmpPath = atomicTmpPath(target);
|
|
34
|
+
await writeFile(tmpPath, content);
|
|
35
|
+
await rename(tmpPath, target);
|
|
36
|
+
}
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* <sessionsDir>/
|
|
6
6
|
* sessions.json ← 所有 session 的元数据索引(键 = sessionId;含 lifecycle 投影)
|
|
7
7
|
* <sessionId>.jsonl ← 对话记录(JSONL;save 整聚合快照写回,非磁盘 append-only)
|
|
8
|
-
* <sessionId>.state.json ← 附带状态(tasks /
|
|
8
|
+
* <sessionId>.state.json ← 附带状态(tasks / steps / metadata / 模型 2 字段)
|
|
9
9
|
*
|
|
10
10
|
* 主键 = sessionId;文件名一律 `toSessionFileName`(跨平台安全)。
|
|
11
11
|
* 可选 `index`:可重建检索投影(失败不阻断权威写)。禁止把 index 当权威。
|
|
@@ -69,6 +69,15 @@ export declare class JsonlSessionStore implements SessionStore<SessionData> {
|
|
|
69
69
|
* 整包 save 是常态动作,对齐即自愈。
|
|
70
70
|
*/
|
|
71
71
|
syncMessages(sessionId: string, messages: readonly unknown[]): Promise<void>;
|
|
72
|
+
/**
|
|
73
|
+
* spawnBy 投影 backfill(每实例一次):升级前落盘的会话其索引条目缺 `spawnBy`
|
|
74
|
+
* (权威值在 state.json),历史隐藏子会话 / 父子归组依赖该投影。
|
|
75
|
+
* 只补缺失条目,幂等;失败不阻断 list(显式降级 = 子会话暂在历史露出),
|
|
76
|
+
* warn 后清缓存待下次 list 重试,不静默吞。
|
|
77
|
+
*/
|
|
78
|
+
private spawnLinkBackfill?;
|
|
79
|
+
private ensureSpawnLinkBackfill;
|
|
80
|
+
private backfillSpawnLinks;
|
|
72
81
|
list(filter?: SessionListFilter): Promise<SessionMeta[]>;
|
|
73
82
|
/**
|
|
74
83
|
* 按会话事实 lifecycle 过滤(索引投影;缺省视为 active)。
|
|
@@ -5,14 +5,16 @@
|
|
|
5
5
|
* <sessionsDir>/
|
|
6
6
|
* sessions.json ← 所有 session 的元数据索引(键 = sessionId;含 lifecycle 投影)
|
|
7
7
|
* <sessionId>.jsonl ← 对话记录(JSONL;save 整聚合快照写回,非磁盘 append-only)
|
|
8
|
-
* <sessionId>.state.json ← 附带状态(tasks /
|
|
8
|
+
* <sessionId>.state.json ← 附带状态(tasks / steps / metadata / 模型 2 字段)
|
|
9
9
|
*
|
|
10
10
|
* 主键 = sessionId;文件名一律 `toSessionFileName`(跨平台安全)。
|
|
11
11
|
* 可选 `index`:可重建检索投影(失败不阻断权威写)。禁止把 index 当权威。
|
|
12
12
|
* `sessions.json` parse 失败会拒绝写回,避免清空 meta。
|
|
13
13
|
*/
|
|
14
|
-
import { access, mkdir, readFile,
|
|
14
|
+
import { access, mkdir, readFile, unlink, appendFile, stat } from 'node:fs/promises';
|
|
15
15
|
import { join } from 'node:path';
|
|
16
|
+
import { atomicWriteFile } from './atomic-tmp.js';
|
|
17
|
+
import { DEFAULT_TENANT_ID } from '@octopi-agent/core/types.js';
|
|
16
18
|
import { toSessionFileName } from '@octopi-agent/core/session-filename.js';
|
|
17
19
|
import { readTitleState, sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
|
|
18
20
|
async function fileExists(path) {
|
|
@@ -45,22 +47,46 @@ function isRefPrefix(synced, incoming) {
|
|
|
45
47
|
return true;
|
|
46
48
|
}
|
|
47
49
|
/**
|
|
48
|
-
* 历史 state.json 的 turns[].input
|
|
50
|
+
* 历史 state.json 的 turns[].input(全量历史快照;turns 为账本旧字段名)已废弃:读取即剥,turns 整键读入 steps,
|
|
49
51
|
* 下次 save 自然瘦身。输入正文的唯一权威是 messages JSONL(Discourse)。
|
|
50
52
|
*
|
|
51
53
|
* 读取端宽松、写入端严格:legacy 账本可能缺 inputCount(旧格式无此字段),
|
|
52
54
|
* rest spread 保全其余键,仅类型层面放宽;新写入的账本必含 inputCount。
|
|
53
55
|
*/
|
|
54
|
-
function
|
|
55
|
-
if (!Array.isArray(
|
|
56
|
+
function slimSteps(steps) {
|
|
57
|
+
if (!Array.isArray(steps))
|
|
56
58
|
return [];
|
|
57
|
-
return
|
|
59
|
+
return steps.flatMap((t) => {
|
|
58
60
|
if (!t || typeof t !== 'object')
|
|
59
61
|
return [];
|
|
60
62
|
const { input: _dropped, ...rest } = t;
|
|
61
63
|
return [rest];
|
|
62
64
|
});
|
|
63
65
|
}
|
|
66
|
+
/**
|
|
67
|
+
* `sessions.json` 元索引 read-modify-write 串行队列,按 meta 文件路径在**进程内**
|
|
68
|
+
* 共享(模块级:同进程多 store 实例也互斥——daemon 同进程就有双实例)。
|
|
69
|
+
*
|
|
70
|
+
* T5 演练实锤 2026-11-14:元索引是全店共享文件,per-session 的 withWriteLock 挡不住
|
|
71
|
+
* 跨 session 并发 read-modify-write——读旧写旧丢条目,且截断直写曾让并发 delete 6ms
|
|
72
|
+
* 即损坏整份元索引(评审 del-3c3fcfeb MAJ-1/2)。锁序恒为 session 锁 → meta 锁;
|
|
73
|
+
* meta 锁内不取任何 session 锁,无死锁环。回归锚 tests/session-store-write-race.test.ts。
|
|
74
|
+
*
|
|
75
|
+
* 已知边界(勿当已闭):**跨进程**窗口仍在——gateway 与 run-serve 子进程同写一份
|
|
76
|
+
* sessions.json,本锁不跨进程;收口走 P2-1 session-serve 或 flock,登记
|
|
77
|
+
* arch/multi-tenancy.md §9.1-14。
|
|
78
|
+
*
|
|
79
|
+
* @param metaPath - 元索引文件路径(锁键)
|
|
80
|
+
* @param fn - 元索引 RMW 整段(read → mutate → write)
|
|
81
|
+
* @returns fn 的结果
|
|
82
|
+
*/
|
|
83
|
+
const metaWriteQueues = new Map();
|
|
84
|
+
function withMetaLock(metaPath, fn) {
|
|
85
|
+
const prev = metaWriteQueues.get(metaPath) ?? Promise.resolve();
|
|
86
|
+
const run = prev.then(fn, fn);
|
|
87
|
+
metaWriteQueues.set(metaPath, run.then(() => undefined, () => undefined));
|
|
88
|
+
return run;
|
|
89
|
+
}
|
|
64
90
|
export class JsonlSessionStore {
|
|
65
91
|
sessionsDir;
|
|
66
92
|
index;
|
|
@@ -102,7 +128,7 @@ export class JsonlSessionStore {
|
|
|
102
128
|
return null;
|
|
103
129
|
try {
|
|
104
130
|
const parsed = JSON.parse(await readFile(statePath, 'utf-8'));
|
|
105
|
-
return { ...parsed,
|
|
131
|
+
return { ...parsed, steps: slimSteps(parsed?.steps ?? parsed?.turns) };
|
|
106
132
|
}
|
|
107
133
|
catch {
|
|
108
134
|
return null;
|
|
@@ -132,9 +158,7 @@ export class JsonlSessionStore {
|
|
|
132
158
|
}
|
|
133
159
|
async writeMetaIndex(index) {
|
|
134
160
|
await mkdir(this.sessionsDir, { recursive: true });
|
|
135
|
-
|
|
136
|
-
await writeFile(tmpPath, JSON.stringify(index, null, 2));
|
|
137
|
-
await rename(tmpPath, this.metaFile());
|
|
161
|
+
await atomicWriteFile(this.metaFile(), JSON.stringify(index, null, 2));
|
|
138
162
|
}
|
|
139
163
|
buildIndexEntry(data) {
|
|
140
164
|
const participantAgentIds = data.meta.participantAgentIds ??
|
|
@@ -142,6 +166,8 @@ export class JsonlSessionStore {
|
|
|
142
166
|
const lifecycle = data.lifecycle?.lifecycle ?? data.meta.lifecycle ?? 'active';
|
|
143
167
|
return {
|
|
144
168
|
...data.meta,
|
|
169
|
+
// 投影取值单一来源:SessionData.tenantId ?? meta.tenantId(legacy);显式放 spread 后
|
|
170
|
+
tenantId: data.tenantId ?? data.meta.tenantId,
|
|
145
171
|
id: data.id,
|
|
146
172
|
agentId: data.agentId || data.meta.agentId,
|
|
147
173
|
primaryAgentId: data.primaryAgentId ?? data.meta.primaryAgentId,
|
|
@@ -153,6 +179,9 @@ export class JsonlSessionStore {
|
|
|
153
179
|
// 置顶是用户数据:权威在 metadata.pinnedAt(受 save 浅合并保护,
|
|
154
180
|
// 长驻 run 对象的整包 save 抹不掉);meta.pinnedAt 仅作旧数据回退
|
|
155
181
|
pinnedAt: readPinnedAt(data.metadata?.pinnedAt) ?? readPinnedAt(data.meta.pinnedAt),
|
|
182
|
+
// 委派来源投影(D7):历史隐藏子会话 / 父子归组(右栏"子会话")依赖本字段;
|
|
183
|
+
// 权威在 state.json 的 spawnBy(存量条目由 ensureSpawnLinkBackfill 补投影)
|
|
184
|
+
spawnBy: data.spawnBy,
|
|
156
185
|
// 标题是用户数据:权威在 metadata 三键(同 pinnedAt 通道,save 按 titleUpdatedAt 仲裁);
|
|
157
186
|
// 投影必须覆盖 ...data.meta 展开带出的陈旧 meta.title,不做旧数据回退
|
|
158
187
|
...readTitleState(data.metadata),
|
|
@@ -177,7 +206,7 @@ export class JsonlSessionStore {
|
|
|
177
206
|
if (resolved.state) {
|
|
178
207
|
try {
|
|
179
208
|
const parsed = JSON.parse(await readFile(resolved.state, 'utf-8'));
|
|
180
|
-
state = { ...parsed,
|
|
209
|
+
state = { ...parsed, steps: slimSteps(parsed?.steps ?? parsed?.turns) };
|
|
181
210
|
}
|
|
182
211
|
catch { /* corrupt state, ignore */ }
|
|
183
212
|
}
|
|
@@ -192,6 +221,7 @@ export class JsonlSessionStore {
|
|
|
192
221
|
: undefined);
|
|
193
222
|
return {
|
|
194
223
|
id: sessionId,
|
|
224
|
+
tenantId: state.tenantId ?? meta?.tenantId,
|
|
195
225
|
agentId,
|
|
196
226
|
primaryAgentId: state.primaryAgentId ?? meta?.primaryAgentId ?? agentId,
|
|
197
227
|
preferredAgentId: state.preferredAgentId ?? meta?.preferredAgentId,
|
|
@@ -214,38 +244,43 @@ export class JsonlSessionStore {
|
|
|
214
244
|
updatedAt: Date.now(),
|
|
215
245
|
},
|
|
216
246
|
messages,
|
|
217
|
-
|
|
247
|
+
steps: state.steps ?? [],
|
|
218
248
|
metadata: state.metadata ?? {},
|
|
219
249
|
tasks: state.tasks ?? [],
|
|
220
250
|
};
|
|
221
251
|
}
|
|
222
252
|
async removeSessionFiles(sessionId) {
|
|
253
|
+
// 元索引先摘(meta RMW 归锁 + 原子写)、数据文件后删(MAJ-1,评审 del-3c3fcfeb):
|
|
254
|
+
// 旧序「先删文件、后截断写回索引」曾让并发 delete 6ms 即损坏整份元索引,且读旧
|
|
255
|
+
// 写回会复活/吞掉他人条目。新序 crash 只会留孤儿文件(磁盘清理兜底),不留幽灵
|
|
256
|
+
// 条目。摘除失败如实上抛:吞错只会把「delete 假成功」和「索引损坏」都藏起来。
|
|
257
|
+
const metaPath = this.metaFile();
|
|
258
|
+
if (await fileExists(metaPath)) {
|
|
259
|
+
await withMetaLock(metaPath, async () => {
|
|
260
|
+
const allMeta = await this.readMetaIndex();
|
|
261
|
+
delete allMeta[sessionId];
|
|
262
|
+
await this.writeMetaIndex(allMeta);
|
|
263
|
+
});
|
|
264
|
+
}
|
|
223
265
|
for (const p of [this.sessionFile(sessionId), this.sessionStateFile(sessionId)]) {
|
|
224
266
|
if (await fileExists(p)) {
|
|
225
267
|
await unlink(p);
|
|
226
268
|
}
|
|
227
269
|
}
|
|
228
|
-
// OP-15:会话附件目录随 session
|
|
270
|
+
// OP-15:会话附件目录随 session 删除清理;转换记录同理(F6:摘要正文含用户内容)
|
|
229
271
|
try {
|
|
230
272
|
const { rm } = await import('node:fs/promises');
|
|
231
273
|
const { join } = await import('node:path');
|
|
232
274
|
const { toSessionFileName } = await import('@octopi-agent/core/session-filename.js');
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
275
|
+
for (const dir of ['attachments', 'transform']) {
|
|
276
|
+
await rm(join(this.sessionsDir, toSessionFileName(sessionId), dir), {
|
|
277
|
+
recursive: true,
|
|
278
|
+
force: true,
|
|
279
|
+
});
|
|
280
|
+
}
|
|
237
281
|
}
|
|
238
282
|
catch {
|
|
239
|
-
//
|
|
240
|
-
}
|
|
241
|
-
const metaPath = this.metaFile();
|
|
242
|
-
if (await fileExists(metaPath)) {
|
|
243
|
-
try {
|
|
244
|
-
const allMeta = await this.readMetaIndex();
|
|
245
|
-
delete allMeta[sessionId];
|
|
246
|
-
await writeFile(metaPath, JSON.stringify(allMeta, null, 2));
|
|
247
|
-
}
|
|
248
|
-
catch { /* ignore */ }
|
|
283
|
+
// 附件/转换记录清理失败不阻断 session 删除;残留由磁盘清理兜底
|
|
249
284
|
}
|
|
250
285
|
}
|
|
251
286
|
async load(sessionId) {
|
|
@@ -266,7 +301,9 @@ export class JsonlSessionStore {
|
|
|
266
301
|
// 写数据文件在前,索引在后:crash 时索引最多缺条目(load 仍能直接读文件),
|
|
267
302
|
// 不会出现索引有但数据没写完的不一致
|
|
268
303
|
const jsonl = data.messages.map(msg => JSON.stringify(msg)).join('\n') + '\n';
|
|
269
|
-
|
|
304
|
+
// tmp+rename 原子写(MAJ-2,评审 del-3c3fcfeb):截断直写曾让并发 load 读到
|
|
305
|
+
// 0 条消息(实测 254/320),load→save 放大链路会把转录永久清空
|
|
306
|
+
await atomicWriteFile(this.sessionFile(sessionId), jsonl);
|
|
270
307
|
// 全量重写后同步增量缓存(防止下一次 syncMessages 误判漂移)
|
|
271
308
|
this.noteSyncCache(sessionId, Buffer.byteLength(jsonl, 'utf-8'), data.messages.slice());
|
|
272
309
|
// metadata 浅合并:长驻 run 对象上的陈旧/空 metadata 不得抹掉
|
|
@@ -289,26 +326,38 @@ export class JsonlSessionStore {
|
|
|
289
326
|
metadata.titleSource = fresh.titleSource;
|
|
290
327
|
metadata.titleUpdatedAt = fresh.titleUpdatedAt;
|
|
291
328
|
}
|
|
292
|
-
await
|
|
329
|
+
await atomicWriteFile(this.sessionStateFile(sessionId), JSON.stringify({
|
|
330
|
+
// 字段集必须与 updateMetadata() 的 state 重写保持一致:漏写即静默清字段
|
|
331
|
+
tenantId: data.tenantId ?? data.meta.tenantId,
|
|
293
332
|
agentId: data.agentId,
|
|
294
333
|
primaryAgentId: data.primaryAgentId ?? data.agentId,
|
|
295
334
|
preferredAgentId: data.preferredAgentId,
|
|
296
335
|
switchAudit: data.switchAudit ?? [],
|
|
297
|
-
spawnBy
|
|
336
|
+
// spawnBy 只增不清:陈旧整包 save(从零构造 SessionData)不得抹掉委派关联(D7),
|
|
337
|
+
// 与 metadata 浅合并 / 标题仲裁同哲学;删关联不做(子会话归属是审计链)
|
|
338
|
+
spawnBy: data.spawnBy ?? prevState?.spawnBy,
|
|
298
339
|
participants: data.participants ?? [],
|
|
299
340
|
contextDetachIndex: data.contextDetachIndex,
|
|
300
341
|
contextCompact: data.contextCompact,
|
|
301
342
|
contextCompacts: data.contextCompacts,
|
|
302
343
|
lifecycle: data.lifecycle,
|
|
303
344
|
tasks: data.tasks ?? [],
|
|
304
|
-
|
|
345
|
+
steps: data.steps ?? [],
|
|
305
346
|
metadata,
|
|
306
347
|
}, null, 2));
|
|
307
348
|
// 索引携带 lifecycle 投影:list 过滤 / 归档扫描不必打开 state
|
|
308
|
-
//
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
349
|
+
// 索引最后更新:数据就绪才写入(meta RMW 进程内串行,见模块级 withMetaLock)
|
|
350
|
+
await withMetaLock(this.metaFile(), async () => {
|
|
351
|
+
const index = await this.readMetaIndex();
|
|
352
|
+
index[sessionId] = this.buildIndexEntry({
|
|
353
|
+
...data,
|
|
354
|
+
id: sessionId,
|
|
355
|
+
metadata,
|
|
356
|
+
// 与 state 写同口径:陈旧整包 save 不得抹掉委派关联投影
|
|
357
|
+
spawnBy: data.spawnBy ?? prevState?.spawnBy,
|
|
358
|
+
});
|
|
359
|
+
await this.writeMetaIndex(index);
|
|
360
|
+
});
|
|
312
361
|
// 可搜投影(失败不阻断;权威已落盘,可 rebuild)
|
|
313
362
|
if (this.index) {
|
|
314
363
|
try {
|
|
@@ -337,10 +386,12 @@ export class JsonlSessionStore {
|
|
|
337
386
|
const replaced = mutate(meta);
|
|
338
387
|
const metadata = replaced === undefined ? meta : replaced;
|
|
339
388
|
await mkdir(this.sessionsDir, { recursive: true });
|
|
340
|
-
await
|
|
389
|
+
await atomicWriteFile(this.sessionStateFile(sessionId), JSON.stringify({
|
|
390
|
+
tenantId: prev?.tenantId,
|
|
341
391
|
agentId: prev?.agentId,
|
|
342
392
|
// 字段集必须与 save() 的 state 重写保持一致:漏写即静默清字段
|
|
343
|
-
//(contextDetachIndex 曾被漏掉——updateMetadata
|
|
393
|
+
//(contextDetachIndex 曾被漏掉——updateMetadata 后租约截断点归零,续跑全量灌窗;
|
|
394
|
+
// tenantId 曾被漏掉——load→save 一轮往返把租户会话擦进 default 桶)
|
|
344
395
|
primaryAgentId: prev?.primaryAgentId ?? prev?.agentId,
|
|
345
396
|
preferredAgentId: prev?.preferredAgentId,
|
|
346
397
|
switchAudit: prev?.switchAudit ?? [],
|
|
@@ -351,23 +402,27 @@ export class JsonlSessionStore {
|
|
|
351
402
|
contextCompacts: prev?.contextCompacts,
|
|
352
403
|
lifecycle: prev?.lifecycle,
|
|
353
404
|
tasks: prev?.tasks ?? [],
|
|
354
|
-
|
|
405
|
+
steps: prev?.steps ?? [],
|
|
355
406
|
metadata,
|
|
356
407
|
}, null, 2));
|
|
357
408
|
try {
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
409
|
+
await withMetaLock(this.metaFile(), async () => {
|
|
410
|
+
const index = await this.readMetaIndex();
|
|
411
|
+
const entry = index[sessionId];
|
|
412
|
+
if (entry) {
|
|
413
|
+
index[sessionId] = {
|
|
414
|
+
...entry,
|
|
415
|
+
// pinnedAt 投影与 buildIndexEntry 同规则(置顶/取消即时可见于 list)
|
|
416
|
+
pinnedAt: readPinnedAt(metadata.pinnedAt),
|
|
417
|
+
// 委派关联投影同规则(MIN-5:只经历 updateMetadata 的会话也补投影)
|
|
418
|
+
spawnBy: entry.spawnBy ?? prev?.spawnBy,
|
|
419
|
+
// 标题投影同规则(rename / 自动标题即时可见于 list)
|
|
420
|
+
...readTitleState(metadata),
|
|
421
|
+
updatedAt: Date.now(),
|
|
422
|
+
};
|
|
423
|
+
await this.writeMetaIndex(index);
|
|
424
|
+
}
|
|
425
|
+
});
|
|
371
426
|
}
|
|
372
427
|
catch {
|
|
373
428
|
// 索引投影可重建;metadata 权威已落盘
|
|
@@ -408,14 +463,60 @@ export class JsonlSessionStore {
|
|
|
408
463
|
}
|
|
409
464
|
// 整文件对齐走 tmp+rename:读侧(浏览器刷新 load)不得撞见写半截的转录
|
|
410
465
|
const jsonl = messages.map((m) => JSON.stringify(m)).join('\n') + '\n';
|
|
411
|
-
|
|
412
|
-
await writeFile(tmpPath, jsonl);
|
|
413
|
-
await rename(tmpPath, path);
|
|
466
|
+
await atomicWriteFile(path, jsonl);
|
|
414
467
|
this.noteSyncCache(sessionId, Buffer.byteLength(jsonl, 'utf-8'), messages.slice());
|
|
415
468
|
});
|
|
416
469
|
}
|
|
470
|
+
/**
|
|
471
|
+
* spawnBy 投影 backfill(每实例一次):升级前落盘的会话其索引条目缺 `spawnBy`
|
|
472
|
+
* (权威值在 state.json),历史隐藏子会话 / 父子归组依赖该投影。
|
|
473
|
+
* 只补缺失条目,幂等;失败不阻断 list(显式降级 = 子会话暂在历史露出),
|
|
474
|
+
* warn 后清缓存待下次 list 重试,不静默吞。
|
|
475
|
+
*/
|
|
476
|
+
spawnLinkBackfill;
|
|
477
|
+
ensureSpawnLinkBackfill() {
|
|
478
|
+
this.spawnLinkBackfill ??= this.backfillSpawnLinks().then(() => undefined, (err) => {
|
|
479
|
+
this.spawnLinkBackfill = undefined;
|
|
480
|
+
console.warn(`[JsonlSessionStore] spawnBy backfill failed: ${err instanceof Error ? err.message : String(err)}`);
|
|
481
|
+
});
|
|
482
|
+
return this.spawnLinkBackfill;
|
|
483
|
+
}
|
|
484
|
+
async backfillSpawnLinks() {
|
|
485
|
+
const snapshot = await this.readMetaIndex();
|
|
486
|
+
const missing = Object.values(snapshot).filter((e) => !e.spawnBy);
|
|
487
|
+
if (missing.length === 0)
|
|
488
|
+
return;
|
|
489
|
+
// state 读取放锁外(只读;state 原子写保证不读到半截);meta 锁内只做短 RMW 补写
|
|
490
|
+
const patches = new Map();
|
|
491
|
+
for (const entry of missing) {
|
|
492
|
+
const spawnBy = (await this.readStateData(entry.id))?.spawnBy;
|
|
493
|
+
if (spawnBy)
|
|
494
|
+
patches.set(entry.id, spawnBy);
|
|
495
|
+
}
|
|
496
|
+
if (patches.size === 0)
|
|
497
|
+
return;
|
|
498
|
+
await withMetaLock(this.metaFile(), async () => {
|
|
499
|
+
const index = await this.readMetaIndex();
|
|
500
|
+
let changed = false;
|
|
501
|
+
for (const [id, spawnBy] of patches) {
|
|
502
|
+
const entry = index[id];
|
|
503
|
+
if (entry && !entry.spawnBy) {
|
|
504
|
+
entry.spawnBy = spawnBy;
|
|
505
|
+
changed = true;
|
|
506
|
+
}
|
|
507
|
+
}
|
|
508
|
+
if (changed)
|
|
509
|
+
await this.writeMetaIndex(index);
|
|
510
|
+
});
|
|
511
|
+
}
|
|
417
512
|
async list(filter) {
|
|
513
|
+
await this.ensureSpawnLinkBackfill();
|
|
418
514
|
let entries = Object.values(await this.readMetaIndex());
|
|
515
|
+
if (filter?.tenantId) {
|
|
516
|
+
const tenantId = filter.tenantId;
|
|
517
|
+
// 历史缺省视作 'default'(multi-tenancy §5 渐进迁移)
|
|
518
|
+
entries = entries.filter((e) => (e.tenantId ?? DEFAULT_TENANT_ID) === tenantId);
|
|
519
|
+
}
|
|
419
520
|
if (filter?.agentId) {
|
|
420
521
|
const agentId = filter.agentId;
|
|
421
522
|
entries = entries.filter((e) => sessionMatchesAgent(e, agentId));
|
|
@@ -21,6 +21,11 @@ export declare function createSqliteSessionIndex(options: {
|
|
|
21
21
|
wal?: boolean;
|
|
22
22
|
/** 默认自动探测 FTS5;false 则只用 LIKE */
|
|
23
23
|
fts?: boolean;
|
|
24
|
+
/**
|
|
25
|
+
* 只读打开(P1-1a / MAJ-6):不写 WAL、不做 DDL(schema 归写者门面首建)——
|
|
26
|
+
* run 侧 prefilter 消费用本模式,保证 sessions.index.db 单写者纪律。
|
|
27
|
+
*/
|
|
28
|
+
readOnly?: boolean;
|
|
24
29
|
}): Promise<SessionIndexBackend>;
|
|
25
30
|
/**
|
|
26
31
|
* 从 JsonlSessionStore 全量重建投影。
|
|
@@ -57,8 +57,13 @@ export async function createSqliteSessionIndex(options) {
|
|
|
57
57
|
catch {
|
|
58
58
|
throw new Error(`SqliteSessionIndex requires Node.js >= 24 built-in "node:sqlite". Current process.version=${process.version}`);
|
|
59
59
|
}
|
|
60
|
-
const index = new SqliteSessionIndex(DatabaseSyncCtor, options.dbPath, options.wal !== false, options.fts !== false);
|
|
61
|
-
|
|
60
|
+
const index = new SqliteSessionIndex(DatabaseSyncCtor, options.dbPath, options.readOnly === true ? false : options.wal !== false, options.fts !== false, options.readOnly === true);
|
|
61
|
+
if (options.readOnly === true) {
|
|
62
|
+
await index.probeFtsReadOnly();
|
|
63
|
+
}
|
|
64
|
+
else {
|
|
65
|
+
await index.ensureSchema();
|
|
66
|
+
}
|
|
62
67
|
return index;
|
|
63
68
|
}
|
|
64
69
|
/** FTS5 字面量:双引号包裹,内部引号翻倍 */
|
|
@@ -72,16 +77,32 @@ class SqliteSessionIndex {
|
|
|
72
77
|
db;
|
|
73
78
|
wantFts;
|
|
74
79
|
fts = false;
|
|
75
|
-
|
|
76
|
-
|
|
80
|
+
readOnly;
|
|
81
|
+
constructor(Ctor, dbPath, wal, wantFts, readOnly = false) {
|
|
82
|
+
this.db = new Ctor(dbPath, {
|
|
83
|
+
timeout: 5000,
|
|
84
|
+
enableForeignKeyConstraints: false,
|
|
85
|
+
...(readOnly ? { readOnly: true } : {}),
|
|
86
|
+
});
|
|
77
87
|
if (wal)
|
|
78
88
|
this.db.exec('PRAGMA journal_mode = WAL');
|
|
79
89
|
this.wantFts = wantFts;
|
|
90
|
+
this.readOnly = readOnly;
|
|
91
|
+
}
|
|
92
|
+
/** 只读模式的 FTS 探测(不建表;缺表 = 纯 LIKE) */
|
|
93
|
+
async probeFtsReadOnly() {
|
|
94
|
+
const row = this.db
|
|
95
|
+
.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='messages_fts'")
|
|
96
|
+
.get();
|
|
97
|
+
this.fts = this.wantFts && row !== undefined;
|
|
80
98
|
}
|
|
81
99
|
get ftsEnabled() {
|
|
82
100
|
return this.fts;
|
|
83
101
|
}
|
|
84
102
|
async ensureSchema() {
|
|
103
|
+
if (this.readOnly) {
|
|
104
|
+
throw new Error('SqliteSessionIndex: ensureSchema refused on readOnly handle (schema belongs to the writer facade)');
|
|
105
|
+
}
|
|
85
106
|
this.db.exec(`
|
|
86
107
|
CREATE TABLE IF NOT EXISTS index_meta (
|
|
87
108
|
key TEXT PRIMARY KEY,
|