@octopi-agent/engine 0.70.7 → 0.90.11
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/LICENSE +201 -201
- package/NOTICE +7 -7
- package/README.md +64 -26
- package/dist/config-schema/agent.d.ts +89 -1
- package/dist/config-schema/agent.js +81 -5
- package/dist/config-schema/context.d.ts +24 -5
- package/dist/config-schema/context.js +28 -1
- package/dist/config-schema/engine.d.ts +205 -13
- package/dist/config-schema/engine.js +31 -2
- package/dist/config-schema/governance.d.ts +95 -0
- package/dist/config-schema/governance.js +93 -1
- package/dist/config-schema/models.d.ts +3 -3
- package/dist/config-schema/observability.d.ts +6 -0
- package/dist/config-schema/observability.js +16 -0
- package/dist/config-schema/run.d.ts +10 -0
- package/dist/config-schema/run.js +18 -0
- package/dist/config-schema/shared.d.ts +13 -0
- package/dist/config-schema/shared.js +22 -0
- package/dist/config-schema/substrate.d.ts +2 -2
- package/dist/config-schema/subsystems.d.ts +1 -1
- package/dist/config-schema/subsystems.js +2 -1
- package/dist/config.d.ts +201 -8
- package/dist/config.js +105 -3
- package/dist/harness/activation/compiler.js +3 -0
- package/dist/harness/activation/runtime.d.ts +7 -0
- package/dist/harness/activation/runtime.js +60 -2
- package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
- package/dist/harness/activation/sources/agent-signal.js +33 -0
- package/dist/harness/activation/types.d.ts +6 -1
- package/dist/harness/agent/builder.d.ts +50 -5
- package/dist/harness/agent/builder.js +189 -59
- package/dist/harness/agent/config-bridge.d.ts +33 -25
- package/dist/harness/agent/config-bridge.js +84 -291
- package/dist/harness/agent/index.d.ts +3 -1
- package/dist/harness/agent/index.js +2 -1
- package/dist/harness/agent/tool-purpose.d.ts +46 -0
- package/dist/harness/agent/tool-purpose.js +127 -0
- package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
- package/dist/harness/agent/wire-agent-builder.js +370 -0
- package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +11 -1
- package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +11 -1
- package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +13 -0
- package/dist/harness/collaboration/autonomous-subsystem/loader.js +16 -1
- package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +8 -1
- package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -9
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
- package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
- package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
- package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
- package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
- package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
- package/dist/harness/collaboration/delegation/child-run.js +241 -0
- package/dist/harness/collaboration/delegation/index.d.ts +26 -0
- package/dist/harness/collaboration/delegation/index.js +25 -0
- package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
- package/dist/harness/collaboration/delegation/notifier.js +84 -0
- package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
- package/dist/harness/collaboration/delegation/registry-types.js +61 -0
- package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
- package/dist/harness/collaboration/delegation/registry.js +220 -0
- package/dist/harness/collaboration/delegation/service.d.ts +249 -0
- package/dist/harness/collaboration/delegation/service.js +499 -0
- package/dist/harness/collaboration/delegation/store.d.ts +155 -0
- package/dist/harness/collaboration/delegation/store.js +271 -0
- package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
- package/dist/harness/collaboration/delegation/transport.js +61 -0
- package/dist/harness/collaboration/delegation/types.d.ts +231 -0
- package/dist/harness/collaboration/delegation/types.js +70 -0
- package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
- package/dist/harness/collaboration/delegation/wiring.js +145 -0
- package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
- package/dist/harness/collaboration/orchestration/index.js +11 -11
- package/dist/harness/context/assembler.d.ts +2 -2
- package/dist/harness/context/assembler.js +12 -7
- package/dist/harness/context/capabilities/compact/engine.js +80 -38
- package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
- package/dist/harness/context/capabilities/summary/registry.js +10 -0
- package/dist/harness/context/constitution/default-agents.md +230 -228
- package/dist/harness/context/default-context-engine.d.ts +101 -23
- package/dist/harness/context/default-context-engine.js +483 -172
- package/dist/harness/context/hybrid-compressor.d.ts +3 -3
- package/dist/harness/context/hybrid-compressor.js +18 -23
- package/dist/harness/context/index.d.ts +5 -1
- package/dist/harness/context/index.js +2 -0
- package/dist/harness/context/layer-snapshot.d.ts +4 -0
- package/dist/harness/context/layer-snapshot.js +30 -18
- package/dist/harness/context/layer-types.d.ts +85 -1
- package/dist/harness/context/layer-types.js +110 -4
- package/dist/harness/context/layers.d.ts +5 -2
- package/dist/harness/context/layers.js +11 -5
- package/dist/harness/context/llm-summarizer.d.ts +15 -1
- package/dist/harness/context/llm-summarizer.js +107 -56
- package/dist/harness/context/message-selector.js +6 -2
- package/dist/harness/context/root-instructions.d.ts +72 -0
- package/dist/harness/context/root-instructions.js +227 -0
- package/dist/harness/context/runtime-datetime.d.ts +34 -7
- package/dist/harness/context/runtime-datetime.js +66 -10
- package/dist/harness/context/smart-router.d.ts +1 -1
- package/dist/harness/context/smart-router.js +1 -1
- package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
- package/dist/harness/context/system-prompt-assembler.js +73 -6
- package/dist/harness/context/token-constants.d.ts +2 -2
- package/dist/harness/context/token-constants.js +2 -2
- package/dist/harness/context/token-estimate-fns.d.ts +1 -3
- package/dist/harness/context/token-estimate-fns.js +2 -4
- package/dist/harness/context/token-estimator.d.ts +1 -1
- package/dist/harness/context/token-estimator.js +14 -6
- package/dist/harness/context/tool-result-aging.d.ts +140 -0
- package/dist/harness/context/tool-result-aging.js +331 -0
- package/dist/harness/context/tool-result-body.d.ts +10 -0
- package/dist/harness/context/tool-result-body.js +27 -0
- package/dist/harness/context/turn-envelope.d.ts +123 -0
- package/dist/harness/context/turn-envelope.js +188 -0
- package/dist/harness/context/types.d.ts +35 -47
- package/dist/harness/extension/execution-environment/effect-policy.d.ts +258 -0
- package/dist/harness/extension/execution-environment/effect-policy.js +358 -0
- package/dist/harness/extension/execution-environment/index.d.ts +18 -2
- package/dist/harness/extension/execution-environment/index.js +11 -2
- package/dist/harness/extension/execution-environment/isolation.js +5 -1
- package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
- package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
- package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
- package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
- package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
- package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
- package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
- package/dist/harness/extension/execution-environment/sandbox.js +521 -51
- package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
- package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
- package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
- package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
- package/dist/harness/extension/execution-environment/types.d.ts +67 -39
- package/dist/harness/extension/execution-environment/types.js +2 -2
- package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
- package/dist/harness/extension/execution-environment/undo-log.js +627 -0
- package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
- package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
- package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
- package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
- package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
- package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
- package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
- package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +51 -0
- package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +153 -0
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
- package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
- package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
- package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
- package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
- package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
- package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +241 -70
- package/dist/harness/extension/plugin-ecosystem/tools/git-runner.d.ts +31 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-runner.js +104 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.d.ts +111 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.js +197 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +463 -0
- package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
- package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
- package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +6 -0
- package/dist/harness/extension/plugin-ecosystem/tools/index.js +4 -0
- package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
- package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
- package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
- package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
- package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
- package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
- package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
- package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
- package/dist/harness/governance/credentials/index.d.ts +1 -1
- package/dist/harness/governance/credentials/store.d.ts +16 -4
- package/dist/harness/governance/credentials/store.js +33 -6
- package/dist/harness/governance/credentials/types.d.ts +11 -0
- package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
- package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
- package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
- package/dist/harness/governance/human-in-the-loop/index.js +3 -3
- package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
- package/dist/harness/governance/human-in-the-loop/types.js +6 -2
- package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
- package/dist/harness/governance/security/capability-enforcer.js +31 -8
- package/dist/harness/governance/security/degradation.js +5 -7
- package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
- package/dist/harness/governance/security/risk-evaluator.js +4 -82
- package/dist/harness/governance/security/temp-path.d.ts +41 -0
- package/dist/harness/governance/security/temp-path.js +117 -0
- package/dist/harness/governance/session-acl/index.d.ts +1 -0
- package/dist/harness/governance/session-acl/index.js +1 -0
- package/dist/harness/governance/session-acl/rights.d.ts +12 -0
- package/dist/harness/governance/session-acl/rights.js +89 -7
- package/dist/harness/governance/session-acl/seed-roles.js +9 -1
- package/dist/harness/governance/session-acl/service.js +21 -29
- package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
- package/dist/harness/governance/session-acl/tool-rights.js +238 -0
- package/dist/harness/governance/session-acl/types.d.ts +22 -0
- package/dist/harness/index.d.ts +16 -12
- package/dist/harness/index.js +10 -6
- package/dist/harness/knowledge/file-identity.d.ts +8 -0
- package/dist/harness/knowledge/file-identity.js +26 -1
- package/dist/harness/knowledge/file-index-store.js +11 -11
- package/dist/harness/knowledge/grounding.d.ts +2 -1
- package/dist/harness/knowledge/grounding.js +8 -5
- package/dist/harness/knowledge/index-store.d.ts +31 -4
- package/dist/harness/knowledge/index-store.js +121 -39
- package/dist/harness/knowledge/index.d.ts +2 -2
- package/dist/harness/knowledge/index.js +1 -1
- package/dist/harness/knowledge/ingest.d.ts +115 -115
- package/dist/harness/knowledge/ingest.js +154 -151
- package/dist/harness/knowledge/job-control-state.js +4 -4
- package/dist/harness/knowledge/job-control.js +11 -11
- package/dist/harness/knowledge/knowledge-serve-child.js +1 -1
- package/dist/harness/knowledge/membership-store.js +11 -11
- package/dist/harness/knowledge/network-guard.d.ts +61 -4
- package/dist/harness/knowledge/network-guard.js +390 -113
- package/dist/harness/knowledge/purge.js +4 -1
- package/dist/harness/knowledge/query-service.js +3 -3
- package/dist/harness/knowledge/writer-service.d.ts +2 -0
- package/dist/harness/knowledge/writer-service.js +14 -13
- package/dist/harness/memory/backfill-coverage.js +3 -1
- package/dist/harness/memory/backfill-trigger.d.ts +2 -2
- package/dist/harness/memory/backfill-trigger.js +4 -4
- package/dist/harness/memory/index.d.ts +1 -0
- package/dist/harness/memory/index.js +1 -0
- package/dist/harness/memory/sqlite/agent-db.js +2 -0
- package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
- package/dist/harness/memory/sqlite/memory-store.js +14 -4
- package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
- package/dist/harness/memory/store.d.ts +1 -0
- package/dist/harness/memory/store.js +3 -0
- package/dist/harness/memory/time-format.d.ts +28 -0
- package/dist/harness/memory/time-format.js +52 -0
- package/dist/harness/memory/types.d.ts +12 -0
- package/dist/harness/observability/observer/hub.js +53 -2
- package/dist/harness/observability/observer/index.d.ts +2 -2
- package/dist/harness/observability/observer/index.js +1 -1
- package/dist/harness/observability/observer/types.d.ts +80 -0
- package/dist/harness/observability/observer/types.js +118 -9
- package/dist/harness/run/agent/agent.d.ts +18 -0
- package/dist/harness/run/agent/agent.js +26 -0
- package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
- package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
- package/dist/harness/run/reliability/harness-events.d.ts +4 -0
- package/dist/harness/run/reliability/run-agent.js +110 -18
- package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
- package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
- package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
- package/dist/harness/run/run-guard/default-run-guard.js +104 -44
- package/dist/harness/run/run-scope.d.ts +52 -0
- package/dist/harness/run/runner.d.ts +117 -16
- package/dist/harness/run/runner.js +668 -157
- package/dist/harness/session/attachments/llm-intent.js +17 -17
- package/dist/harness/session/history/port.js +16 -5
- package/dist/harness/session/in-memory-store.d.ts +6 -0
- package/dist/harness/session/in-memory-store.js +55 -3
- package/dist/harness/session/schedules/index.d.ts +10 -0
- package/dist/harness/session/schedules/index.js +10 -0
- package/dist/harness/session/schedules/render.d.ts +13 -0
- package/dist/harness/session/schedules/render.js +63 -0
- package/dist/harness/session/schedules/service.d.ts +179 -0
- package/dist/harness/session/schedules/service.js +695 -0
- package/dist/harness/session/schedules/store.d.ts +119 -0
- package/dist/harness/session/schedules/store.js +323 -0
- package/dist/harness/session/schedules/tools.d.ts +39 -0
- package/dist/harness/session/schedules/tools.js +442 -0
- package/dist/harness/session/schedules/types.d.ts +104 -0
- package/dist/harness/session/schedules/types.js +97 -0
- package/dist/harness/session/tasks/tools.js +22 -0
- package/dist/harness/session/title.js +25 -9
- package/dist/harness/session/types.d.ts +35 -0
- package/dist/harness/shared/events/agent-event-map.d.ts +39 -0
- package/dist/harness/shared/events/agent-event-map.js +2 -0
- package/dist/harness/shared/types/agent-definition.d.ts +23 -0
- package/dist/index.d.ts +25 -9
- package/dist/index.js +11 -2
- package/dist/integration/observability/run-telemetry.d.ts +8 -0
- package/dist/integration/observability/run-telemetry.js +31 -8
- package/dist/integration/observability/trace-collector.js +26 -4
- package/dist/integration/observability/trace-events.d.ts +1 -0
- package/dist/integration/observability/trace-events.js +2 -0
- package/dist/integration/observability/trace-logger.js +27 -17
- package/dist/integration/providers/anthropic.d.ts +10 -0
- package/dist/integration/providers/anthropic.js +44 -1
- package/dist/integration/providers/openai.d.ts +10 -0
- package/dist/integration/providers/openai.js +58 -2
- package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
- package/dist/integration/providers/wire-dump-diff.js +351 -0
- package/dist/integration/providers/wire-dump.d.ts +178 -0
- package/dist/integration/providers/wire-dump.js +396 -0
- package/dist/integration/storage/jsonl.d.ts +29 -0
- package/dist/integration/storage/jsonl.js +243 -41
- package/dist/integration/storage/session-index.js +63 -8
- package/dist/paths.d.ts +19 -0
- package/dist/paths.js +38 -1
- package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
- package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
- package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
- package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
- package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
- package/dist/subsystems/safety-guard/config.yaml +3 -1
- package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
- package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
- package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
- package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
- package/package.json +115 -115
- package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
- package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
- package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
- package/dist/harness/collaboration/multi-agent/index.js +0 -15
- package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
- package/dist/harness/collaboration/multi-agent/process.js +0 -256
- package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
- package/dist/harness/collaboration/multi-agent/registry.js +0 -137
- package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
- package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
- package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
- package/dist/harness/collaboration/multi-agent/types.js +0 -15
- package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
- package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
- package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
- package/dist/harness/collaboration/orchestration/async-task.js +0 -359
- package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
- package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
- package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
- package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
- package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
- package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
- package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
- package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
- package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
- package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
- package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
- package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
- package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
- package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
- package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
- package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
- package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
- package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
- package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
- package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
- package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
- package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
- package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
- package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
- package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
- package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
- package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
- package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
- package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
- package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
- package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
- package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
- package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
- package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
- package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
- package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
- /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
- /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
|
@@ -11,10 +11,10 @@
|
|
|
11
11
|
* 可选 `index`:可重建检索投影(失败不阻断权威写)。禁止把 index 当权威。
|
|
12
12
|
* `sessions.json` parse 失败会拒绝写回,避免清空 meta。
|
|
13
13
|
*/
|
|
14
|
-
import { access, mkdir, readFile, writeFile, unlink, rename } from 'node:fs/promises';
|
|
14
|
+
import { access, mkdir, readFile, writeFile, unlink, rename, appendFile, stat } from 'node:fs/promises';
|
|
15
15
|
import { join } from 'node:path';
|
|
16
16
|
import { toSessionFileName } from '@octopi-agent/core/session-filename.js';
|
|
17
|
-
import { sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
|
|
17
|
+
import { readTitleState, sessionMatchesAgent } from '@octopi-agent/core/types/session.js';
|
|
18
18
|
async function fileExists(path) {
|
|
19
19
|
try {
|
|
20
20
|
await access(path);
|
|
@@ -24,9 +24,65 @@ async function fileExists(path) {
|
|
|
24
24
|
return false;
|
|
25
25
|
}
|
|
26
26
|
}
|
|
27
|
+
/** pinnedAt 投影:仅接受有限数值(epoch ms),其余视为未置顶 */
|
|
28
|
+
function readPinnedAt(value) {
|
|
29
|
+
return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
|
|
30
|
+
}
|
|
31
|
+
/** 已同步序列上限(LRU):缓存只服务于增量判定,不得把全会话转录常驻钉在堆里 */
|
|
32
|
+
const MAX_SYNC_CACHES = 64;
|
|
33
|
+
/**
|
|
34
|
+
* 已同步序列是否为给定序列的引用相等前缀。
|
|
35
|
+
* 调用方契约:已同步消息不再原地修改(原地修改 = 视为新序列,须由调用方
|
|
36
|
+
* 保证不发生在首同步之前,如 turn_start 定形)。
|
|
37
|
+
*/
|
|
38
|
+
function isRefPrefix(synced, incoming) {
|
|
39
|
+
if (incoming.length < synced.length)
|
|
40
|
+
return false;
|
|
41
|
+
for (let i = 0; i < synced.length; i++) {
|
|
42
|
+
if (synced[i] !== incoming[i])
|
|
43
|
+
return false;
|
|
44
|
+
}
|
|
45
|
+
return true;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* 历史 state.json 的 turns[].input(全量历史快照)已废弃:读取即剥,
|
|
49
|
+
* 下次 save 自然瘦身。输入正文的唯一权威是 messages JSONL(Discourse)。
|
|
50
|
+
*
|
|
51
|
+
* 读取端宽松、写入端严格:legacy 账本可能缺 inputCount(旧格式无此字段),
|
|
52
|
+
* rest spread 保全其余键,仅类型层面放宽;新写入的账本必含 inputCount。
|
|
53
|
+
*/
|
|
54
|
+
function slimTurns(turns) {
|
|
55
|
+
if (!Array.isArray(turns))
|
|
56
|
+
return [];
|
|
57
|
+
return turns.flatMap((t) => {
|
|
58
|
+
if (!t || typeof t !== 'object')
|
|
59
|
+
return [];
|
|
60
|
+
const { input: _dropped, ...rest } = t;
|
|
61
|
+
return [rest];
|
|
62
|
+
});
|
|
63
|
+
}
|
|
27
64
|
export class JsonlSessionStore {
|
|
28
65
|
sessionsDir;
|
|
29
66
|
index;
|
|
67
|
+
/** 同 sessionId 读改写串行(save / updateMetadata / syncMessages / delete) */
|
|
68
|
+
writeQueues = new Map();
|
|
69
|
+
/**
|
|
70
|
+
* syncMessages 增量判定缓存:本实例最近一次写下的消息文件状态。
|
|
71
|
+
* size(字节数)抓「旁路整包 save / 外部改动」造成的文件漂移;refs(消息对象
|
|
72
|
+
* 引用序列)抓「同一实例的序列分歧」。任一不符即整文件对齐重写,自愈。
|
|
73
|
+
* LRU 上限防长驻进程把全量转录引用常驻堆内存。
|
|
74
|
+
*/
|
|
75
|
+
syncCaches = new Map();
|
|
76
|
+
/** 记录/刷新增量判定缓存(LRU:超限淘汰最旧条目) */
|
|
77
|
+
noteSyncCache(sessionId, size, refs) {
|
|
78
|
+
this.syncCaches.delete(sessionId);
|
|
79
|
+
if (this.syncCaches.size >= MAX_SYNC_CACHES) {
|
|
80
|
+
const oldest = this.syncCaches.keys().next().value;
|
|
81
|
+
if (oldest !== undefined)
|
|
82
|
+
this.syncCaches.delete(oldest);
|
|
83
|
+
}
|
|
84
|
+
this.syncCaches.set(sessionId, { size, refs });
|
|
85
|
+
}
|
|
30
86
|
/**
|
|
31
87
|
* @param options - sessionsDir + 可选 index
|
|
32
88
|
*/
|
|
@@ -34,6 +90,24 @@ export class JsonlSessionStore {
|
|
|
34
90
|
this.sessionsDir = options.sessionsDir;
|
|
35
91
|
this.index = options.index;
|
|
36
92
|
}
|
|
93
|
+
withWriteLock(sessionId, fn) {
|
|
94
|
+
const prev = this.writeQueues.get(sessionId) ?? Promise.resolve();
|
|
95
|
+
const run = prev.then(fn, fn);
|
|
96
|
+
this.writeQueues.set(sessionId, run.then(() => undefined, () => undefined));
|
|
97
|
+
return run;
|
|
98
|
+
}
|
|
99
|
+
async readStateData(sessionId) {
|
|
100
|
+
const statePath = this.sessionStateFile(sessionId);
|
|
101
|
+
if (!(await fileExists(statePath)))
|
|
102
|
+
return null;
|
|
103
|
+
try {
|
|
104
|
+
const parsed = JSON.parse(await readFile(statePath, 'utf-8'));
|
|
105
|
+
return { ...parsed, turns: slimTurns(parsed?.turns) };
|
|
106
|
+
}
|
|
107
|
+
catch {
|
|
108
|
+
return null;
|
|
109
|
+
}
|
|
110
|
+
}
|
|
37
111
|
metaFile() {
|
|
38
112
|
return join(this.sessionsDir, 'sessions.json');
|
|
39
113
|
}
|
|
@@ -76,6 +150,12 @@ export class JsonlSessionStore {
|
|
|
76
150
|
lifecycle,
|
|
77
151
|
endedAt: data.lifecycle?.endedAt ?? data.meta.endedAt,
|
|
78
152
|
archivedAt: data.lifecycle?.archivedAt ?? data.meta.archivedAt,
|
|
153
|
+
// 置顶是用户数据:权威在 metadata.pinnedAt(受 save 浅合并保护,
|
|
154
|
+
// 长驻 run 对象的整包 save 抹不掉);meta.pinnedAt 仅作旧数据回退
|
|
155
|
+
pinnedAt: readPinnedAt(data.metadata?.pinnedAt) ?? readPinnedAt(data.meta.pinnedAt),
|
|
156
|
+
// 标题是用户数据:权威在 metadata 三键(同 pinnedAt 通道,save 按 titleUpdatedAt 仲裁);
|
|
157
|
+
// 投影必须覆盖 ...data.meta 展开带出的陈旧 meta.title,不做旧数据回退
|
|
158
|
+
...readTitleState(data.metadata),
|
|
79
159
|
};
|
|
80
160
|
}
|
|
81
161
|
async readSession(sessionId, resolved) {
|
|
@@ -96,7 +176,8 @@ export class JsonlSessionStore {
|
|
|
96
176
|
let state = {};
|
|
97
177
|
if (resolved.state) {
|
|
98
178
|
try {
|
|
99
|
-
|
|
179
|
+
const parsed = JSON.parse(await readFile(resolved.state, 'utf-8'));
|
|
180
|
+
state = { ...parsed, turns: slimTurns(parsed?.turns) };
|
|
100
181
|
}
|
|
101
182
|
catch { /* corrupt state, ignore */ }
|
|
102
183
|
}
|
|
@@ -115,7 +196,9 @@ export class JsonlSessionStore {
|
|
|
115
196
|
primaryAgentId: state.primaryAgentId ?? meta?.primaryAgentId ?? agentId,
|
|
116
197
|
preferredAgentId: state.preferredAgentId ?? meta?.preferredAgentId,
|
|
117
198
|
switchAudit: state.switchAudit,
|
|
199
|
+
spawnBy: state.spawnBy,
|
|
118
200
|
participants: state.participants,
|
|
201
|
+
contextDetachIndex: state.contextDetachIndex,
|
|
119
202
|
contextCompact: state.contextCompact,
|
|
120
203
|
contextCompacts: state.contextCompacts,
|
|
121
204
|
lifecycle,
|
|
@@ -178,39 +261,155 @@ export class JsonlSessionStore {
|
|
|
178
261
|
});
|
|
179
262
|
}
|
|
180
263
|
async save(sessionId, data) {
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
264
|
+
return this.withWriteLock(sessionId, async () => {
|
|
265
|
+
await mkdir(this.sessionsDir, { recursive: true });
|
|
266
|
+
// 写数据文件在前,索引在后:crash 时索引最多缺条目(load 仍能直接读文件),
|
|
267
|
+
// 不会出现索引有但数据没写完的不一致
|
|
268
|
+
const jsonl = data.messages.map(msg => JSON.stringify(msg)).join('\n') + '\n';
|
|
269
|
+
await writeFile(this.sessionFile(sessionId), jsonl);
|
|
270
|
+
// 全量重写后同步增量缓存(防止下一次 syncMessages 误判漂移)
|
|
271
|
+
this.noteSyncCache(sessionId, Buffer.byteLength(jsonl, 'utf-8'), data.messages.slice());
|
|
272
|
+
// metadata 浅合并:长驻 run 对象上的陈旧/空 metadata 不得抹掉
|
|
273
|
+
// 并发 updateMetadata 写入的键(clientToolCalls / fileReleases…)。
|
|
274
|
+
// 删键必须走 updateMetadata。
|
|
275
|
+
const prevState = await this.readStateData(sessionId);
|
|
276
|
+
const metadata = {
|
|
277
|
+
...(prevState?.metadata ?? {}),
|
|
278
|
+
...(data.metadata ?? {}),
|
|
279
|
+
};
|
|
280
|
+
// 标题三键按 titleUpdatedAt 仲裁:浅合并只护「缺键」,不护「旧值」——
|
|
281
|
+
// 长驻 run 对象上 run 开始时的旧 trio 不得回滚运行期间 rename/标题生成写入的新 trio。
|
|
282
|
+
// incoming 缺时间戳视为陈旧(写端恒打三键;缺戳 = 半写/外来写),同样归磁盘胜
|
|
283
|
+
const fresh = readTitleState(prevState?.metadata);
|
|
284
|
+
const incomingTitle = readTitleState(data.metadata);
|
|
285
|
+
if (fresh.titleUpdatedAt !== undefined &&
|
|
286
|
+
(incomingTitle.titleUpdatedAt === undefined ||
|
|
287
|
+
incomingTitle.titleUpdatedAt < fresh.titleUpdatedAt)) {
|
|
288
|
+
metadata.title = fresh.title;
|
|
289
|
+
metadata.titleSource = fresh.titleSource;
|
|
290
|
+
metadata.titleUpdatedAt = fresh.titleUpdatedAt;
|
|
291
|
+
}
|
|
292
|
+
await writeFile(this.sessionStateFile(sessionId), JSON.stringify({
|
|
293
|
+
agentId: data.agentId,
|
|
294
|
+
primaryAgentId: data.primaryAgentId ?? data.agentId,
|
|
295
|
+
preferredAgentId: data.preferredAgentId,
|
|
296
|
+
switchAudit: data.switchAudit ?? [],
|
|
297
|
+
spawnBy: data.spawnBy,
|
|
298
|
+
participants: data.participants ?? [],
|
|
299
|
+
contextDetachIndex: data.contextDetachIndex,
|
|
300
|
+
contextCompact: data.contextCompact,
|
|
301
|
+
contextCompacts: data.contextCompacts,
|
|
302
|
+
lifecycle: data.lifecycle,
|
|
303
|
+
tasks: data.tasks ?? [],
|
|
304
|
+
turns: data.turns ?? [],
|
|
305
|
+
metadata,
|
|
306
|
+
}, null, 2));
|
|
307
|
+
// 索引携带 lifecycle 投影:list 过滤 / 归档扫描不必打开 state
|
|
308
|
+
// 索引最后更新:数据就绪才写入
|
|
309
|
+
const index = await this.readMetaIndex();
|
|
310
|
+
index[sessionId] = this.buildIndexEntry({ ...data, id: sessionId, metadata });
|
|
311
|
+
await this.writeMetaIndex(index);
|
|
312
|
+
// 可搜投影(失败不阻断;权威已落盘,可 rebuild)
|
|
313
|
+
if (this.index) {
|
|
314
|
+
try {
|
|
315
|
+
await this.index.upsertFromSession(sessionId, { ...data, id: sessionId, metadata });
|
|
316
|
+
}
|
|
317
|
+
catch (err) {
|
|
318
|
+
// 投影可重建,吞掉索引写失败(不拖垮权威 save)
|
|
319
|
+
console.warn(`[JsonlSessionStore] session index upsert failed for ${sessionId}: ${err instanceof Error ? err.message : String(err)}`);
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
});
|
|
323
|
+
}
|
|
324
|
+
/**
|
|
325
|
+
* metadata 原子读改写(含删键)。与 save 同会话串行。
|
|
326
|
+
*
|
|
327
|
+
* @param sessionId - 会话 id
|
|
328
|
+
* @param mutate - 原地修改 meta,或返回替换对象;返回 undefined 表示用原地结果
|
|
329
|
+
*/
|
|
330
|
+
async updateMetadata(sessionId, mutate) {
|
|
331
|
+
return this.withWriteLock(sessionId, async () => {
|
|
332
|
+
const prev = await this.readStateData(sessionId);
|
|
333
|
+
const hasMessages = await fileExists(this.sessionFile(sessionId));
|
|
334
|
+
if (!prev && !hasMessages)
|
|
335
|
+
return;
|
|
336
|
+
const meta = { ...(prev?.metadata ?? {}) };
|
|
337
|
+
const replaced = mutate(meta);
|
|
338
|
+
const metadata = replaced === undefined ? meta : replaced;
|
|
339
|
+
await mkdir(this.sessionsDir, { recursive: true });
|
|
340
|
+
await writeFile(this.sessionStateFile(sessionId), JSON.stringify({
|
|
341
|
+
agentId: prev?.agentId,
|
|
342
|
+
primaryAgentId: prev?.primaryAgentId,
|
|
343
|
+
preferredAgentId: prev?.preferredAgentId,
|
|
344
|
+
switchAudit: prev?.switchAudit ?? [],
|
|
345
|
+
spawnBy: prev?.spawnBy,
|
|
346
|
+
participants: prev?.participants ?? [],
|
|
347
|
+
contextCompact: prev?.contextCompact,
|
|
348
|
+
contextCompacts: prev?.contextCompacts,
|
|
349
|
+
lifecycle: prev?.lifecycle,
|
|
350
|
+
tasks: prev?.tasks ?? [],
|
|
351
|
+
turns: prev?.turns ?? [],
|
|
352
|
+
metadata,
|
|
353
|
+
}, null, 2));
|
|
206
354
|
try {
|
|
207
|
-
await this.
|
|
355
|
+
const index = await this.readMetaIndex();
|
|
356
|
+
const entry = index[sessionId];
|
|
357
|
+
if (entry) {
|
|
358
|
+
index[sessionId] = {
|
|
359
|
+
...entry,
|
|
360
|
+
// pinnedAt 投影与 buildIndexEntry 同规则(置顶/取消即时可见于 list)
|
|
361
|
+
pinnedAt: readPinnedAt(metadata.pinnedAt),
|
|
362
|
+
// 标题投影同规则(rename / 自动标题即时可见于 list)
|
|
363
|
+
...readTitleState(metadata),
|
|
364
|
+
updatedAt: Date.now(),
|
|
365
|
+
};
|
|
366
|
+
await this.writeMetaIndex(index);
|
|
367
|
+
}
|
|
208
368
|
}
|
|
209
|
-
catch
|
|
210
|
-
//
|
|
211
|
-
console.warn(`[JsonlSessionStore] session index upsert failed for ${sessionId}: ${err instanceof Error ? err.message : String(err)}`);
|
|
369
|
+
catch {
|
|
370
|
+
// 索引投影可重建;metadata 权威已落盘
|
|
212
371
|
}
|
|
213
|
-
}
|
|
372
|
+
});
|
|
373
|
+
}
|
|
374
|
+
/**
|
|
375
|
+
* 消息序列对齐(Run 进行中转录增量落盘)。契约见 SessionStore.syncMessages。
|
|
376
|
+
*
|
|
377
|
+
* 增量判定:文件字节数与上次本实例写入一致,且给定序列以已同步序列为
|
|
378
|
+
* 引用相等前缀 → 只追加尾差;任一不成立(旁路整包 save / 外部改动 /
|
|
379
|
+
* 前缀分歧 / 冷缓存)→ 整文件对齐重写。漂移不是错误路径:旁路写者
|
|
380
|
+
* 整包 save 是常态动作,对齐即自愈。
|
|
381
|
+
*/
|
|
382
|
+
async syncMessages(sessionId, messages) {
|
|
383
|
+
return this.withWriteLock(sessionId, async () => {
|
|
384
|
+
await mkdir(this.sessionsDir, { recursive: true });
|
|
385
|
+
const path = this.sessionFile(sessionId);
|
|
386
|
+
const cache = this.syncCaches.get(sessionId);
|
|
387
|
+
let size = -1;
|
|
388
|
+
try {
|
|
389
|
+
size = (await stat(path)).size;
|
|
390
|
+
}
|
|
391
|
+
catch {
|
|
392
|
+
// 文件不存在 → 走整文件对齐
|
|
393
|
+
}
|
|
394
|
+
// 增量通道不是会话创建通道:会话完全不存在时跳过(创建/重建由 save 负责)
|
|
395
|
+
if (size < 0 && !(await fileExists(this.sessionStateFile(sessionId))))
|
|
396
|
+
return;
|
|
397
|
+
if (cache && size === cache.size && isRefPrefix(cache.refs, messages)) {
|
|
398
|
+
const added = messages.slice(cache.refs.length);
|
|
399
|
+
if (added.length === 0)
|
|
400
|
+
return;
|
|
401
|
+
const jsonl = added.map((m) => JSON.stringify(m)).join('\n') + '\n';
|
|
402
|
+
await appendFile(path, jsonl);
|
|
403
|
+
this.noteSyncCache(sessionId, size + Buffer.byteLength(jsonl, 'utf-8'), messages.slice());
|
|
404
|
+
return;
|
|
405
|
+
}
|
|
406
|
+
// 整文件对齐走 tmp+rename:读侧(浏览器刷新 load)不得撞见写半截的转录
|
|
407
|
+
const jsonl = messages.map((m) => JSON.stringify(m)).join('\n') + '\n';
|
|
408
|
+
const tmpPath = `${path}.${process.pid}.${Date.now()}.tmp`;
|
|
409
|
+
await writeFile(tmpPath, jsonl);
|
|
410
|
+
await rename(tmpPath, path);
|
|
411
|
+
this.noteSyncCache(sessionId, Buffer.byteLength(jsonl, 'utf-8'), messages.slice());
|
|
412
|
+
});
|
|
214
413
|
}
|
|
215
414
|
async list(filter) {
|
|
216
415
|
let entries = Object.values(await this.readMetaIndex());
|
|
@@ -229,15 +428,18 @@ export class JsonlSessionStore {
|
|
|
229
428
|
return entries.filter((e) => (e.lifecycle ?? 'active') === lifecycle);
|
|
230
429
|
}
|
|
231
430
|
async delete(sessionId) {
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
431
|
+
return this.withWriteLock(sessionId, async () => {
|
|
432
|
+
await this.removeSessionFiles(sessionId);
|
|
433
|
+
this.syncCaches.delete(sessionId);
|
|
434
|
+
if (this.index) {
|
|
435
|
+
try {
|
|
436
|
+
await this.index.remove(sessionId);
|
|
437
|
+
}
|
|
438
|
+
catch {
|
|
439
|
+
// 投影可重建
|
|
440
|
+
}
|
|
239
441
|
}
|
|
240
|
-
}
|
|
442
|
+
});
|
|
241
443
|
}
|
|
242
444
|
async exists(sessionId) {
|
|
243
445
|
return (await fileExists(this.sessionFile(sessionId)))
|
|
@@ -7,12 +7,41 @@
|
|
|
7
7
|
* P2.d:可选 FTS5(trigram)。短词(<3 码点,常见二字中文)trigram 命不中,
|
|
8
8
|
* 自动回落 LIKE;FTS 不可用时整库 LIKE。
|
|
9
9
|
*/
|
|
10
|
+
import { createHash } from 'node:crypto';
|
|
10
11
|
import { extractSearchableFields } from '@octopi-agent/engine/harness/session/history/score.js';
|
|
11
12
|
/** 单字段入库切片;更长文本可能在预筛中漏检 → prefilter 返回 null 回退扫描 */
|
|
12
13
|
const INDEX_TEXT_SLICE = 2000;
|
|
13
14
|
const SCHEMA_VERSION = 2;
|
|
14
15
|
/** trigram 最少 3 码点;更短走 LIKE */
|
|
15
16
|
const TRIGRAM_MIN_CHARS = 3;
|
|
17
|
+
/**
|
|
18
|
+
* transient 消息(每轮剥旧插新的托管注入块)不是 Discourse 内容:
|
|
19
|
+
* UI 与 LLM 窗口都过滤它,索引同样排除——否则增量/全量两条路径口径漂移,
|
|
20
|
+
* 且剥离后残留幽灵词条。口径变更:session_search 不再命中临时注入块。
|
|
21
|
+
*/
|
|
22
|
+
function isTransientMessage(msg) {
|
|
23
|
+
const src = msg.metadata?.source;
|
|
24
|
+
return (src === 'knowledgeGrounding' ||
|
|
25
|
+
src === 'sessionAttachment' ||
|
|
26
|
+
// E8 易变快照:日志保留(审计)但非 Discourse 发言,索引不收(防幽灵词条/归因错误)
|
|
27
|
+
src === 'runtimeSnapshot');
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* 已索引持久消息尾指纹:增量快路径的前缀未变判据。
|
|
31
|
+
*
|
|
32
|
+
* 消息内容不可变、历史只追加/截断,尾指纹一致 ⇒ 前缀未换(截断会使尾指纹
|
|
33
|
+
* 变化或条数变小,从而回退全量重建)。只 hash 可搜字段,成本 O(单条消息)。
|
|
34
|
+
*/
|
|
35
|
+
function tailFingerprint(msg) {
|
|
36
|
+
const h = createHash('sha1');
|
|
37
|
+
for (const f of extractSearchableFields(msg, true)) {
|
|
38
|
+
h.update(f.field);
|
|
39
|
+
h.update('\u0000');
|
|
40
|
+
h.update(f.text);
|
|
41
|
+
h.update('\u0000');
|
|
42
|
+
}
|
|
43
|
+
return h.digest('hex');
|
|
44
|
+
}
|
|
16
45
|
/**
|
|
17
46
|
* 创建 SQLite 会话投影索引(node:sqlite,Node >= 24)。
|
|
18
47
|
*
|
|
@@ -97,6 +126,14 @@ class SqliteSessionIndex {
|
|
|
97
126
|
.prepare(`INSERT INTO index_meta (key, value) VALUES ('schema_version', ?)`)
|
|
98
127
|
.run(String(SCHEMA_VERSION));
|
|
99
128
|
}
|
|
129
|
+
// v2→v3 列迁移:增量 upsert 状态(indexed_count = 已索引持久消息条数,tail_fp = 尾指纹)
|
|
130
|
+
const cols = this.db.prepare(`PRAGMA table_info(sessions)`).all();
|
|
131
|
+
if (!cols.some((c) => c.name === 'indexed_count')) {
|
|
132
|
+
this.db.exec(`ALTER TABLE sessions ADD COLUMN indexed_count INTEGER`);
|
|
133
|
+
}
|
|
134
|
+
if (!cols.some((c) => c.name === 'tail_fp')) {
|
|
135
|
+
this.db.exec(`ALTER TABLE sessions ADD COLUMN tail_fp TEXT`);
|
|
136
|
+
}
|
|
100
137
|
}
|
|
101
138
|
tryEnableFts() {
|
|
102
139
|
try {
|
|
@@ -145,23 +182,41 @@ class SqliteSessionIndex {
|
|
|
145
182
|
message_count = excluded.message_count,
|
|
146
183
|
source = excluded.source`)
|
|
147
184
|
.run(sessionId, data.agentId ?? meta.agentId ?? 'default', data.primaryAgentId ?? meta.primaryAgentId ?? null, data.preferredAgentId ?? meta.preferredAgentId ?? null, JSON.stringify(participantIds ?? []), lifecycle, meta.createdAt ?? null, meta.updatedAt ?? Date.now(), data.lifecycle?.endedAt ?? meta.endedAt ?? null, data.lifecycle?.archivedAt ?? meta.archivedAt ?? null, messages.length, source);
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
185
|
+
// 增量快路径:持久消息序列只追加且尾指纹未变 → 只插新增;
|
|
186
|
+
// 否则(截断 / 尾指纹不符 / 首次)全量重建该会话。
|
|
187
|
+
// msg_index = 持久序列下标(transient 之外的稳定序号);prefilter 只消费
|
|
188
|
+
// sessionId,msg_index 仅供内部定位,不等于 session.messages 全文下标。
|
|
189
|
+
const persisted = messages.filter((m) => !isTransientMessage(m));
|
|
190
|
+
const prevRow = this.db
|
|
191
|
+
.prepare(`SELECT indexed_count, tail_fp FROM sessions WHERE session_id = ?`)
|
|
192
|
+
.get(sessionId);
|
|
193
|
+
const prevCount = prevRow?.indexed_count ?? 0;
|
|
194
|
+
const prefixIntact = persisted.length >= prevCount &&
|
|
195
|
+
(prevCount === 0 || tailFingerprint(persisted[prevCount - 1]) === prevRow?.tail_fp);
|
|
152
196
|
const insert = this.db.prepare(`INSERT OR REPLACE INTO messages (session_id, msg_index, role, agent_id, timestamp, field, text)
|
|
153
197
|
VALUES (?, ?, ?, ?, ?, ?, ?)`);
|
|
154
198
|
const insertFts = this.fts
|
|
155
199
|
? this.db.prepare(`INSERT INTO messages_fts (text, session_id, msg_index, field) VALUES (?, ?, ?, ?)`)
|
|
156
200
|
: null;
|
|
157
|
-
|
|
158
|
-
|
|
201
|
+
const start = prefixIntact ? prevCount : 0;
|
|
202
|
+
if (!prefixIntact) {
|
|
203
|
+
this.db.prepare(`DELETE FROM messages WHERE session_id = ?`).run(sessionId);
|
|
204
|
+
if (this.fts) {
|
|
205
|
+
this.db.prepare(`DELETE FROM messages_fts WHERE session_id = ?`).run(sessionId);
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
for (let j = start; j < persisted.length; j++) {
|
|
209
|
+
const msg = persisted[j];
|
|
159
210
|
for (const f of extractSearchableFields(msg, true)) {
|
|
160
211
|
const text = f.text.slice(0, INDEX_TEXT_SLICE);
|
|
161
|
-
insert.run(sessionId,
|
|
162
|
-
insertFts?.run(text, sessionId,
|
|
212
|
+
insert.run(sessionId, j, msg.role, msg.agentId ?? null, msg.timestamp ?? null, f.field, text);
|
|
213
|
+
insertFts?.run(text, sessionId, j, f.field);
|
|
163
214
|
}
|
|
164
215
|
}
|
|
216
|
+
const newFp = persisted.length ? tailFingerprint(persisted[persisted.length - 1]) : null;
|
|
217
|
+
this.db
|
|
218
|
+
.prepare(`UPDATE sessions SET indexed_count = ?, tail_fp = ? WHERE session_id = ?`)
|
|
219
|
+
.run(persisted.length, newFp, sessionId);
|
|
165
220
|
this.db.exec('COMMIT');
|
|
166
221
|
}
|
|
167
222
|
catch (err) {
|
package/dist/paths.d.ts
CHANGED
|
@@ -1,3 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 展开 `~` 前缀为用户主目录(Windows/Linux/macOS 通用)。
|
|
3
|
+
* 接受 `~`、`~/rest`、`~\rest`(Windows 形态,剩余分隔符归一为 `/` 后按平台 join);
|
|
4
|
+
* `~user/…` 等其他形态不展开(无跨平台语义)。已是绝对路径的原样返回(幂等)。
|
|
5
|
+
*
|
|
6
|
+
* @param p - 配置原文路径
|
|
7
|
+
* @returns 展开后的路径
|
|
8
|
+
*/
|
|
9
|
+
export declare function expandHomePath(p: string): string;
|
|
10
|
+
/**
|
|
11
|
+
* 配置路径合法形态:绝对路径,或 `~` / `~/…` / `~\…`。
|
|
12
|
+
* win32 上「绝对」要求盘符(`C:\`/`C:/`)或 UNC(`\\server\share`)——
|
|
13
|
+
* `\foo` 这类盘符相对路径会按当前盘隐式解析,属于要消灭的隐式行为。
|
|
14
|
+
* 相对路径直接拒绝:被 resolve 到进程 cwd 属于隐式行为,加载即报错。
|
|
15
|
+
*
|
|
16
|
+
* @param p - 配置原文路径
|
|
17
|
+
* @returns 形态合法与否
|
|
18
|
+
*/
|
|
19
|
+
export declare function isConfigPathShape(p: string): boolean;
|
|
1
20
|
/** 默认系统根目录 */
|
|
2
21
|
export declare const DEFAULT_OCTOPI_HOME: string;
|
|
3
22
|
/** 环境变量名 */
|
package/dist/paths.js
CHANGED
|
@@ -1,9 +1,46 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Runtime home path helpers (OCTOPI_HOME).
|
|
3
3
|
* Shared by gateway / suite so neither depends on the other for path resolution.
|
|
4
|
+
*
|
|
5
|
+
* This module must stay zod-free: harness runtime code imports it for path
|
|
6
|
+
* semantics without pulling in the config-schema layer.
|
|
4
7
|
*/
|
|
5
|
-
import { join, resolve } from 'node:path';
|
|
8
|
+
import { isAbsolute, join, resolve } from 'node:path';
|
|
6
9
|
import { homedir } from 'node:os';
|
|
10
|
+
/**
|
|
11
|
+
* 展开 `~` 前缀为用户主目录(Windows/Linux/macOS 通用)。
|
|
12
|
+
* 接受 `~`、`~/rest`、`~\rest`(Windows 形态,剩余分隔符归一为 `/` 后按平台 join);
|
|
13
|
+
* `~user/…` 等其他形态不展开(无跨平台语义)。已是绝对路径的原样返回(幂等)。
|
|
14
|
+
*
|
|
15
|
+
* @param p - 配置原文路径
|
|
16
|
+
* @returns 展开后的路径
|
|
17
|
+
*/
|
|
18
|
+
export function expandHomePath(p) {
|
|
19
|
+
if (p === '~')
|
|
20
|
+
return homedir();
|
|
21
|
+
if (p.startsWith('~/') || p.startsWith('~\\')) {
|
|
22
|
+
// `~\a\b` 多段:把剩余的 `\` 归一为 `/`,避免 POSIX 上把 `\` 当文件名字符
|
|
23
|
+
return join(homedir(), p.slice(2).replace(/\\/g, '/'));
|
|
24
|
+
}
|
|
25
|
+
return p;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* 配置路径合法形态:绝对路径,或 `~` / `~/…` / `~\…`。
|
|
29
|
+
* win32 上「绝对」要求盘符(`C:\`/`C:/`)或 UNC(`\\server\share`)——
|
|
30
|
+
* `\foo` 这类盘符相对路径会按当前盘隐式解析,属于要消灭的隐式行为。
|
|
31
|
+
* 相对路径直接拒绝:被 resolve 到进程 cwd 属于隐式行为,加载即报错。
|
|
32
|
+
*
|
|
33
|
+
* @param p - 配置原文路径
|
|
34
|
+
* @returns 形态合法与否
|
|
35
|
+
*/
|
|
36
|
+
export function isConfigPathShape(p) {
|
|
37
|
+
if (p === '~' || p.startsWith('~/') || p.startsWith('~\\'))
|
|
38
|
+
return true;
|
|
39
|
+
if (process.platform === 'win32') {
|
|
40
|
+
return /^[A-Za-z]:[\\/]/.test(p) || p.startsWith('\\\\');
|
|
41
|
+
}
|
|
42
|
+
return isAbsolute(p);
|
|
43
|
+
}
|
|
7
44
|
/** 默认系统根目录 */
|
|
8
45
|
export const DEFAULT_OCTOPI_HOME = join(homedir(), '.octopi');
|
|
9
46
|
/** 环境变量名 */
|
|
@@ -1,43 +1,43 @@
|
|
|
1
|
-
# Cognition Steward Conceptualize
|
|
2
|
-
|
|
3
|
-
你是概念化助手。从**命题 + 证据语境**中提取可复用概念与关系假设,输出结构化 JSON。
|
|
4
|
-
|
|
5
|
-
本文是 system 认知指令;用户消息仅提供 Memory 命题与 contextSlice。不要复述本文规则。
|
|
6
|
-
|
|
7
|
-
## 输出
|
|
8
|
-
|
|
9
|
-
严格 JSON 对象:
|
|
10
|
-
|
|
11
|
-
```json
|
|
12
|
-
{
|
|
13
|
-
"nodes": [
|
|
14
|
-
{
|
|
15
|
-
"name": "会话租约",
|
|
16
|
-
"kind": "construct",
|
|
17
|
-
"description": "sessionId 级互斥租约",
|
|
18
|
-
"domain": ["session", "concurrency"]
|
|
19
|
-
}
|
|
20
|
-
],
|
|
21
|
-
"edges": [
|
|
22
|
-
{
|
|
23
|
-
"fromName": "会话租约",
|
|
24
|
-
"toName": "Session",
|
|
25
|
-
"relationType": "part_of",
|
|
26
|
-
"evidenceClass": "mereonymy",
|
|
27
|
-
"cue": "证据中的原句片段"
|
|
28
|
-
}
|
|
29
|
-
],
|
|
30
|
-
"rejected": []
|
|
31
|
-
}
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
## 规则
|
|
35
|
-
|
|
36
|
-
- 概念是**可复用判别单元**(entity/construct/method/problem/constraint),不是每个名词
|
|
37
|
-
- `relationType`:causes / part_of / opposes / similar_to / evolves_to / related
|
|
38
|
-
- `evidenceClass`:causal / mereonymy / negation / analogy / evolution / cooccur
|
|
39
|
-
- **强关系必须给 cue**(证据原句片段);无把握时只用 `related` + `cooccur`
|
|
40
|
-
- 禁止假因果:非因果证据不得标 causes
|
|
41
|
-
- 两个义项不同时**禁止合并成一个 name**;宁可拆开
|
|
42
|
-
- 没有值得记的概念返回 `{"nodes":[],"edges":[],"rejected":[]}`
|
|
43
|
-
- kind 只能是 entity / construct / method / problem / constraint
|
|
1
|
+
# Cognition Steward Conceptualize
|
|
2
|
+
|
|
3
|
+
你是概念化助手。从**命题 + 证据语境**中提取可复用概念与关系假设,输出结构化 JSON。
|
|
4
|
+
|
|
5
|
+
本文是 system 认知指令;用户消息仅提供 Memory 命题与 contextSlice。不要复述本文规则。
|
|
6
|
+
|
|
7
|
+
## 输出
|
|
8
|
+
|
|
9
|
+
严格 JSON 对象:
|
|
10
|
+
|
|
11
|
+
```json
|
|
12
|
+
{
|
|
13
|
+
"nodes": [
|
|
14
|
+
{
|
|
15
|
+
"name": "会话租约",
|
|
16
|
+
"kind": "construct",
|
|
17
|
+
"description": "sessionId 级互斥租约",
|
|
18
|
+
"domain": ["session", "concurrency"]
|
|
19
|
+
}
|
|
20
|
+
],
|
|
21
|
+
"edges": [
|
|
22
|
+
{
|
|
23
|
+
"fromName": "会话租约",
|
|
24
|
+
"toName": "Session",
|
|
25
|
+
"relationType": "part_of",
|
|
26
|
+
"evidenceClass": "mereonymy",
|
|
27
|
+
"cue": "证据中的原句片段"
|
|
28
|
+
}
|
|
29
|
+
],
|
|
30
|
+
"rejected": []
|
|
31
|
+
}
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
## 规则
|
|
35
|
+
|
|
36
|
+
- 概念是**可复用判别单元**(entity/construct/method/problem/constraint),不是每个名词
|
|
37
|
+
- `relationType`:causes / part_of / opposes / similar_to / evolves_to / related
|
|
38
|
+
- `evidenceClass`:causal / mereonymy / negation / analogy / evolution / cooccur
|
|
39
|
+
- **强关系必须给 cue**(证据原句片段);无把握时只用 `related` + `cooccur`
|
|
40
|
+
- 禁止假因果:非因果证据不得标 causes
|
|
41
|
+
- 两个义项不同时**禁止合并成一个 name**;宁可拆开
|
|
42
|
+
- 没有值得记的概念返回 `{"nodes":[],"edges":[],"rejected":[]}`
|
|
43
|
+
- kind 只能是 entity / construct / method / problem / constraint
|