@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
|
@@ -0,0 +1,396 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* LLM Wire Dump — 把 provider 实际发送的请求体按 session 落盘
|
|
3
|
+
*
|
|
4
|
+
* 目的:前缀缓存是否命中,只取决于「本次请求输入前缀 vs 上一次请求」的逐字节一致性。
|
|
5
|
+
* 现有观测(Observer `context.llm`)只能看到 ContextEngine 出口的 role/content 视图,
|
|
6
|
+
* 既不含 tools,也不含 provider 侧变换(Anthropic system 提升、OpenAI sanitize/flatten),
|
|
7
|
+
* 因此无法回答「前缀到底在哪一条消息、哪个字节断开」。
|
|
8
|
+
*
|
|
9
|
+
* 落盘形态(每个调用两份):
|
|
10
|
+
* - `<dir>/<session>/<id>.json` —— 完整请求体(wire body,逐字节同实际发送)
|
|
11
|
+
* - `<dir>/<session>/index.jsonl` —— 轻量索引(每消息 hash/长度 + toolsHash + 结果/usage)
|
|
12
|
+
*
|
|
13
|
+
* 设计约束:
|
|
14
|
+
* - 默认关闭(写盘量按请求体 × 调用次数计,长 session 可能很大)。
|
|
15
|
+
* - 写入串行排队且不阻塞调用方(fire-and-forget);`flush()` 供测试/优雅退出等待。
|
|
16
|
+
* - 每 session 环形上限 `maxCallsPerSession`:超出后删除最旧的 body 文件并压缩索引。
|
|
17
|
+
*
|
|
18
|
+
* @module integration/providers/wire-dump
|
|
19
|
+
*/
|
|
20
|
+
import { createHash, randomBytes } from 'node:crypto';
|
|
21
|
+
import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'node:fs';
|
|
22
|
+
import { join } from 'node:path';
|
|
23
|
+
import { getOctopiHome } from '../../paths.js';
|
|
24
|
+
/** 缺省落盘根目录 */
|
|
25
|
+
export function defaultWireDumpDir() {
|
|
26
|
+
return join(getOctopiHome(), 'logs', 'llm-requests');
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* 从 wire body 提取前缀单元文本(比对与落盘的唯一权威顺序)
|
|
30
|
+
*
|
|
31
|
+
* - OpenAI:`body.messages`
|
|
32
|
+
* - Anthropic:顶层 `system`(字符串)+ `body.messages`;system 在 wire 语义上位于最前
|
|
33
|
+
*
|
|
34
|
+
* @param body - provider 实际发送的请求体
|
|
35
|
+
* @returns 前缀单元(role + 该单元 JSON 文本)
|
|
36
|
+
*/
|
|
37
|
+
export function wireUnitPayloads(body) {
|
|
38
|
+
const payloads = [];
|
|
39
|
+
const messages = Array.isArray(body.messages) ? body.messages : [];
|
|
40
|
+
// 顶层 system 在 wire 语义上永远位于最前,无条件作为首单元:
|
|
41
|
+
// 若某 body 同时含 inline system 消息(第三方 provider 可能如此),漏掉顶层 system
|
|
42
|
+
// 会让它的变化完全不触发 divergence。OpenAI/Anthropic 都不会产生这种并存。
|
|
43
|
+
const system = body.system;
|
|
44
|
+
if (typeof system === 'string' && system.length > 0) {
|
|
45
|
+
payloads.push({ role: 'system', text: JSON.stringify({ role: 'system', content: system }) });
|
|
46
|
+
}
|
|
47
|
+
for (const msg of messages) {
|
|
48
|
+
const role = msg != null && typeof msg === 'object' && typeof msg.role === 'string'
|
|
49
|
+
? (msg.role)
|
|
50
|
+
: 'unknown';
|
|
51
|
+
payloads.push({ role, text: JSON.stringify(msg ?? null) });
|
|
52
|
+
}
|
|
53
|
+
return payloads;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* 从 wire body 提取用于前缀比对的最小单元序列
|
|
57
|
+
*
|
|
58
|
+
* @param body - provider 实际发送的请求体
|
|
59
|
+
* @returns 前缀单元(role/len/hash)
|
|
60
|
+
*/
|
|
61
|
+
export function extractWireUnits(body) {
|
|
62
|
+
return wireUnitPayloads(body).map((p) => ({ role: p.role, len: p.text.length, hash: shortHash(p.text) }));
|
|
63
|
+
}
|
|
64
|
+
/** 目录名安全化:sessionId 可能含 `:` `/` 等 */
|
|
65
|
+
export function sanitizeSessionDirName(sessionId) {
|
|
66
|
+
return sessionId.replace(/[^A-Za-z0-9._-]/g, '_') || '_unknown';
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* 创建 wire dump sink
|
|
70
|
+
*
|
|
71
|
+
* @param options - 落盘目录 / 环形上限 / 身份解析
|
|
72
|
+
* @returns sink;capture 返回的句柄用于回填结果
|
|
73
|
+
*/
|
|
74
|
+
export function createWireDumpSink(options = {}) {
|
|
75
|
+
const rootDir = options.dir ?? defaultWireDumpDir();
|
|
76
|
+
const maxCalls = options.maxCallsPerSession ?? 200;
|
|
77
|
+
const maxBodyBytes = options.maxBodyBytes ?? 8_000_000;
|
|
78
|
+
const resolveContext = options.resolveContext;
|
|
79
|
+
let seq = 0;
|
|
80
|
+
let queue = Promise.resolve();
|
|
81
|
+
// 调用 id 的实例段:同进程内可能有多个 sink(daemon + 一次 CLI run),
|
|
82
|
+
// 各自 seq 从 1 起、Date.now() 同毫秒,只靠 at+seq 会撞 id,裁剪时连新行一起删掉
|
|
83
|
+
const instanceTag = randomBytes(4).toString('hex');
|
|
84
|
+
/** session 目录 → 已写调用 id(升序),用于环形裁剪 */
|
|
85
|
+
const writtenBySession = new Map();
|
|
86
|
+
const primedSessions = new Set();
|
|
87
|
+
const enqueue = (task) => {
|
|
88
|
+
queue = queue.then(() => task()).catch(() => {
|
|
89
|
+
// 观测 fail-open:写盘失败绝不影响请求路径(唯一失败面是本模块自身的 IO)
|
|
90
|
+
});
|
|
91
|
+
};
|
|
92
|
+
const sessionDirPath = (sessionId) => join(rootDir, sanitizeSessionDirName(sessionId));
|
|
93
|
+
/**
|
|
94
|
+
* 首次写入某 session 时,用磁盘现有索引恢复环形状态(进程重启不覆盖旧文件)
|
|
95
|
+
*
|
|
96
|
+
* 以 index.jsonl 的 request 行顺序为准:oversize 调用没有 body 文件,只扫目录会漏掉它们,
|
|
97
|
+
* 导致这些行的环形逐出永远不发生。旧目录(索引尚未生成)才退回按 body 文件名恢复。
|
|
98
|
+
*/
|
|
99
|
+
const primeSession = (dir) => {
|
|
100
|
+
if (primedSessions.has(dir))
|
|
101
|
+
return;
|
|
102
|
+
primedSessions.add(dir);
|
|
103
|
+
const indexPath = join(dir, 'index.jsonl');
|
|
104
|
+
try {
|
|
105
|
+
if (existsSync(indexPath)) {
|
|
106
|
+
const ids = readFileSync(indexPath, 'utf8')
|
|
107
|
+
.split('\n')
|
|
108
|
+
.filter((line) => line.trim().length > 0)
|
|
109
|
+
.map((line) => {
|
|
110
|
+
try {
|
|
111
|
+
const rec = JSON.parse(line);
|
|
112
|
+
return rec.type === 'request' ? rec.id : null;
|
|
113
|
+
}
|
|
114
|
+
catch {
|
|
115
|
+
// 半行(进程被杀)没有 id 可供恢复;后续行仍可读
|
|
116
|
+
return null;
|
|
117
|
+
}
|
|
118
|
+
})
|
|
119
|
+
.filter((id) => id != null);
|
|
120
|
+
writtenBySession.set(dir, ids);
|
|
121
|
+
return;
|
|
122
|
+
}
|
|
123
|
+
if (!existsSync(dir))
|
|
124
|
+
return;
|
|
125
|
+
const ids = readdirSync(dir)
|
|
126
|
+
.filter((f) => f.endsWith('.json'))
|
|
127
|
+
.map((f) => f.slice(0, -'.json'.length))
|
|
128
|
+
.sort(compareCallIds);
|
|
129
|
+
writtenBySession.set(dir, ids);
|
|
130
|
+
}
|
|
131
|
+
catch {
|
|
132
|
+
writtenBySession.set(dir, []);
|
|
133
|
+
}
|
|
134
|
+
};
|
|
135
|
+
/** 环形裁剪:删除最旧 body 文件并压缩索引(保持 index 与现存 body 一致) */
|
|
136
|
+
const trimSession = (dir) => {
|
|
137
|
+
const ids = writtenBySession.get(dir) ?? [];
|
|
138
|
+
if (ids.length <= maxCalls)
|
|
139
|
+
return;
|
|
140
|
+
const remove = ids.splice(0, ids.length - maxCalls);
|
|
141
|
+
const removeSet = new Set(remove);
|
|
142
|
+
for (const id of remove) {
|
|
143
|
+
try {
|
|
144
|
+
unlinkSync(join(dir, `${id}.json`));
|
|
145
|
+
}
|
|
146
|
+
catch {
|
|
147
|
+
// 文件可能已被人工清理;索引压缩仍按 removeSet 进行
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
const indexPath = join(dir, 'index.jsonl');
|
|
151
|
+
try {
|
|
152
|
+
if (!existsSync(indexPath))
|
|
153
|
+
return;
|
|
154
|
+
const records = readFileSync(indexPath, 'utf8')
|
|
155
|
+
.split('\n')
|
|
156
|
+
.filter((line) => line.trim().length > 0)
|
|
157
|
+
.map((line) => {
|
|
158
|
+
try {
|
|
159
|
+
return JSON.parse(line);
|
|
160
|
+
}
|
|
161
|
+
catch {
|
|
162
|
+
return null;
|
|
163
|
+
}
|
|
164
|
+
})
|
|
165
|
+
.filter((rec) => rec != null)
|
|
166
|
+
.filter((rec) => !removeSet.has(rec.id));
|
|
167
|
+
// 没有对应 request 行的 result(旧数据/人工删行后)一并清掉,避免孤儿行无限累积
|
|
168
|
+
const liveIds = new Set(records.filter((rec) => rec.type === 'request').map((rec) => rec.id));
|
|
169
|
+
const kept = records
|
|
170
|
+
.filter((rec) => rec.type === 'request' || liveIds.has(rec.id))
|
|
171
|
+
.map((rec) => JSON.stringify(rec));
|
|
172
|
+
writeFileSync(indexPath, kept.length > 0 ? `${kept.join('\n')}\n` : '');
|
|
173
|
+
}
|
|
174
|
+
catch {
|
|
175
|
+
// 索引压缩失败仅导致索引偏大;body 已删,diff 侧按缺失 body 降级为纯 hash 比对
|
|
176
|
+
}
|
|
177
|
+
};
|
|
178
|
+
const capture = (input) => {
|
|
179
|
+
const ctx = resolveContext?.();
|
|
180
|
+
const sessionId = ctx?.sessionId ?? '_unscoped';
|
|
181
|
+
const dir = sessionDirPath(sessionId);
|
|
182
|
+
const at = Date.now();
|
|
183
|
+
seq += 1;
|
|
184
|
+
const n = seq;
|
|
185
|
+
// 实例段保证跨 sink / 跨进程唯一:at+seq 在同毫秒内会重复
|
|
186
|
+
const id = `${at}-${n}-${instanceTag}`;
|
|
187
|
+
// 序列化/哈希在调用方线程完成:body 在此刻定型(排队期间不会被后续代码改写),
|
|
188
|
+
// 只有落盘 I/O 进入队列——「不阻塞调用方」指不等待磁盘。
|
|
189
|
+
const units = extractWireUnits(input.body);
|
|
190
|
+
const bodyJson = JSON.stringify(input.body);
|
|
191
|
+
const bodyBytes = Buffer.byteLength(bodyJson, 'utf8');
|
|
192
|
+
const oversize = bodyBytes > maxBodyBytes;
|
|
193
|
+
const toolJson = input.body.tools ? JSON.stringify(input.body.tools) : '';
|
|
194
|
+
const toolsHash = toolJson ? shortHash(toolJson) : '';
|
|
195
|
+
const chars = units.reduce((sum, u) => sum + u.len, 0);
|
|
196
|
+
const request = {
|
|
197
|
+
type: 'request',
|
|
198
|
+
id,
|
|
199
|
+
at,
|
|
200
|
+
n,
|
|
201
|
+
sessionId: ctx?.sessionId,
|
|
202
|
+
agentId: ctx?.agentId,
|
|
203
|
+
runId: ctx?.runId,
|
|
204
|
+
provider: input.provider,
|
|
205
|
+
model: input.model,
|
|
206
|
+
mode: input.mode,
|
|
207
|
+
msgCount: units.length,
|
|
208
|
+
chars,
|
|
209
|
+
bodyBytes,
|
|
210
|
+
oversize,
|
|
211
|
+
toolCount: Array.isArray(input.body.tools) ? input.body.tools.length : 0,
|
|
212
|
+
toolsHash,
|
|
213
|
+
roles: units.map((u) => u.role),
|
|
214
|
+
lens: units.map((u) => u.len),
|
|
215
|
+
hashes: units.map((u) => u.hash),
|
|
216
|
+
file: oversize ? undefined : `${id}.json`,
|
|
217
|
+
};
|
|
218
|
+
enqueue(() => {
|
|
219
|
+
mkdirSync(dir, { recursive: true });
|
|
220
|
+
primeSession(dir);
|
|
221
|
+
if (!oversize) {
|
|
222
|
+
writeFileSync(join(dir, `${id}.json`), bodyJson);
|
|
223
|
+
}
|
|
224
|
+
const ids = writtenBySession.get(dir) ?? [];
|
|
225
|
+
ids.push(id);
|
|
226
|
+
writtenBySession.set(dir, ids);
|
|
227
|
+
appendFileSync(join(dir, 'index.jsonl'), `${JSON.stringify(request)}\n`);
|
|
228
|
+
trimSession(dir);
|
|
229
|
+
});
|
|
230
|
+
return {
|
|
231
|
+
id,
|
|
232
|
+
finish: (result) => {
|
|
233
|
+
const record = {
|
|
234
|
+
type: 'result',
|
|
235
|
+
id,
|
|
236
|
+
at: Date.now(),
|
|
237
|
+
outcome: result.outcome,
|
|
238
|
+
durationMs: Math.max(0, Math.round(result.durationMs)),
|
|
239
|
+
ttftMs: result.ttftMs != null ? Math.max(0, Math.round(result.ttftMs)) : undefined,
|
|
240
|
+
usage: result.usage
|
|
241
|
+
? {
|
|
242
|
+
inputCachedTokens: result.usage.inputCachedTokens,
|
|
243
|
+
inputUncachedTokens: result.usage.inputUncachedTokens,
|
|
244
|
+
inputCacheWriteTokens: result.usage.inputCacheWriteTokens,
|
|
245
|
+
inputReportedTokens: result.usage.inputReportedTokens,
|
|
246
|
+
outputTokens: result.usage.outputTokens,
|
|
247
|
+
cacheAware: result.usage.cacheAware,
|
|
248
|
+
}
|
|
249
|
+
: undefined,
|
|
250
|
+
};
|
|
251
|
+
enqueue(() => {
|
|
252
|
+
// 该调用的 request 行已被环形裁剪(长流式调用可能在收尾前被逐出):
|
|
253
|
+
// 再追加 result 只会留下永远不被逐出的孤儿行,直接丢弃
|
|
254
|
+
const ids = writtenBySession.get(dir);
|
|
255
|
+
if (!ids?.includes(id))
|
|
256
|
+
return;
|
|
257
|
+
appendFileSync(join(dir, 'index.jsonl'), `${JSON.stringify(record)}\n`);
|
|
258
|
+
});
|
|
259
|
+
},
|
|
260
|
+
};
|
|
261
|
+
};
|
|
262
|
+
return {
|
|
263
|
+
capture,
|
|
264
|
+
flush: () => queue,
|
|
265
|
+
};
|
|
266
|
+
}
|
|
267
|
+
/** 16 位短 hash(sha256 前 8 字节)——足够区分前缀单元,日志体积可控 */
|
|
268
|
+
function shortHash(text) {
|
|
269
|
+
return createHash('sha256').update(text).digest('hex').slice(0, 16);
|
|
270
|
+
}
|
|
271
|
+
/**
|
|
272
|
+
* 调用 id 形如 `<at>-<n>-<instanceTag>`:按 `at`、`n` 数值比较,其余段按字符串
|
|
273
|
+
*
|
|
274
|
+
* 整体字典序会把 `n=10` 排到 `n=2` 之前,环形逐出会因此删错调用。
|
|
275
|
+
*
|
|
276
|
+
* @param a - 调用 id
|
|
277
|
+
* @param b - 调用 id
|
|
278
|
+
* @returns 比较结果(<0 / 0 / >0)
|
|
279
|
+
*/
|
|
280
|
+
function compareCallIds(a, b) {
|
|
281
|
+
const pa = a.split('-');
|
|
282
|
+
const pb = b.split('-');
|
|
283
|
+
for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
|
|
284
|
+
const sa = pa[i] ?? '';
|
|
285
|
+
const sb = pb[i] ?? '';
|
|
286
|
+
const na = Number(sa);
|
|
287
|
+
const nb = Number(sb);
|
|
288
|
+
if (sa !== '' && sb !== '' && Number.isFinite(na) && Number.isFinite(nb)) {
|
|
289
|
+
if (na !== nb)
|
|
290
|
+
return na - nb;
|
|
291
|
+
}
|
|
292
|
+
else if (sa !== sb) {
|
|
293
|
+
return sa < sb ? -1 : 1;
|
|
294
|
+
}
|
|
295
|
+
}
|
|
296
|
+
return 0;
|
|
297
|
+
}
|
|
298
|
+
/**
|
|
299
|
+
* 给 provider 套一层 wire dump 装饰器
|
|
300
|
+
*
|
|
301
|
+
* 请求体由 provider 自己的 `wireBodyFor` 构造(同一 builder),装饰器只负责落盘与计时;
|
|
302
|
+
* 不支持该能力的 provider 原样透传(不落盘)。
|
|
303
|
+
*
|
|
304
|
+
* @param inner - 真实 provider
|
|
305
|
+
* @param sink - 落盘 sink
|
|
306
|
+
* @returns 透传装饰器
|
|
307
|
+
*/
|
|
308
|
+
export function withWireDump(inner, sink) {
|
|
309
|
+
const builder = inner;
|
|
310
|
+
const buildBody = (request, mode) => {
|
|
311
|
+
if (typeof builder.wireBodyFor !== 'function')
|
|
312
|
+
return null;
|
|
313
|
+
try {
|
|
314
|
+
return builder.wireBodyFor.call(inner, request, mode);
|
|
315
|
+
}
|
|
316
|
+
catch {
|
|
317
|
+
// 观测 fail-open:body 构造失败绝不能影响真实请求(唯一失败面是本模块自身的判定)
|
|
318
|
+
return null;
|
|
319
|
+
}
|
|
320
|
+
};
|
|
321
|
+
const modelOf = (request) => request.model ?? inner.defaultModel ?? '';
|
|
322
|
+
/** 捕获失败(hash/序列化异常)不得影响真实请求 */
|
|
323
|
+
const tryCapture = (request, mode) => {
|
|
324
|
+
try {
|
|
325
|
+
const body = buildBody(request, mode);
|
|
326
|
+
if (!body)
|
|
327
|
+
return undefined;
|
|
328
|
+
return sink.capture({ provider: inner.name, model: modelOf(request), mode, body });
|
|
329
|
+
}
|
|
330
|
+
catch {
|
|
331
|
+
return undefined;
|
|
332
|
+
}
|
|
333
|
+
};
|
|
334
|
+
return {
|
|
335
|
+
name: inner.name,
|
|
336
|
+
defaultModel: inner.defaultModel,
|
|
337
|
+
models: inner.models,
|
|
338
|
+
isAvailable: () => inner.isAvailable(),
|
|
339
|
+
getModelInfo: (modelName) => inner.getModelInfo(modelName),
|
|
340
|
+
getModelInfos: () => inner.getModelInfos(),
|
|
341
|
+
chat: async (request) => {
|
|
342
|
+
const handle = tryCapture(request, 'chat');
|
|
343
|
+
const startedAt = Date.now();
|
|
344
|
+
try {
|
|
345
|
+
const res = await inner.chat(request);
|
|
346
|
+
handle?.finish({ outcome: 'ok', usage: res.usage, durationMs: Date.now() - startedAt });
|
|
347
|
+
return res;
|
|
348
|
+
}
|
|
349
|
+
catch (err) {
|
|
350
|
+
handle?.finish({ outcome: 'error', durationMs: Date.now() - startedAt });
|
|
351
|
+
throw err;
|
|
352
|
+
}
|
|
353
|
+
},
|
|
354
|
+
stream: async function* (request) {
|
|
355
|
+
const handle = tryCapture(request, 'stream');
|
|
356
|
+
if (!handle) {
|
|
357
|
+
yield* inner.stream(request);
|
|
358
|
+
return;
|
|
359
|
+
}
|
|
360
|
+
const startedAt = Date.now();
|
|
361
|
+
let ttftMs;
|
|
362
|
+
let usage;
|
|
363
|
+
let sawDone = false;
|
|
364
|
+
let completed = false;
|
|
365
|
+
let failed = false;
|
|
366
|
+
try {
|
|
367
|
+
for await (const chunk of inner.stream(request)) {
|
|
368
|
+
if (ttftMs == null)
|
|
369
|
+
ttftMs = Date.now() - startedAt;
|
|
370
|
+
if (chunk.type === 'done') {
|
|
371
|
+
sawDone = true;
|
|
372
|
+
}
|
|
373
|
+
// usage 通常只在 done chunk 上;任何 chunk 携带都取,避免缺哨兵时丢掉已消耗额度
|
|
374
|
+
if (chunk.usage)
|
|
375
|
+
usage = chunk.usage;
|
|
376
|
+
yield chunk;
|
|
377
|
+
}
|
|
378
|
+
completed = true;
|
|
379
|
+
}
|
|
380
|
+
catch (err) {
|
|
381
|
+
failed = true;
|
|
382
|
+
throw err;
|
|
383
|
+
}
|
|
384
|
+
finally {
|
|
385
|
+
handle.finish({
|
|
386
|
+
// 正常读完但服务端没发 done 哨兵(代理断流/兼容实现)不等于消费者放弃:
|
|
387
|
+
// 判 abandoned 会把真实完成记成"提前中断",并误报给 llm-diff
|
|
388
|
+
outcome: failed ? 'error' : sawDone || completed ? 'ok' : 'abandoned',
|
|
389
|
+
usage,
|
|
390
|
+
ttftMs,
|
|
391
|
+
durationMs: Date.now() - startedAt,
|
|
392
|
+
});
|
|
393
|
+
}
|
|
394
|
+
},
|
|
395
|
+
};
|
|
396
|
+
}
|
|
@@ -26,10 +26,23 @@ export interface JsonlSessionStoreOptions {
|
|
|
26
26
|
export declare class JsonlSessionStore implements SessionStore<SessionData> {
|
|
27
27
|
private readonly sessionsDir;
|
|
28
28
|
private readonly index?;
|
|
29
|
+
/** 同 sessionId 读改写串行(save / updateMetadata / syncMessages / delete) */
|
|
30
|
+
private readonly writeQueues;
|
|
31
|
+
/**
|
|
32
|
+
* syncMessages 增量判定缓存:本实例最近一次写下的消息文件状态。
|
|
33
|
+
* size(字节数)抓「旁路整包 save / 外部改动」造成的文件漂移;refs(消息对象
|
|
34
|
+
* 引用序列)抓「同一实例的序列分歧」。任一不符即整文件对齐重写,自愈。
|
|
35
|
+
* LRU 上限防长驻进程把全量转录引用常驻堆内存。
|
|
36
|
+
*/
|
|
37
|
+
private readonly syncCaches;
|
|
38
|
+
/** 记录/刷新增量判定缓存(LRU:超限淘汰最旧条目) */
|
|
39
|
+
private noteSyncCache;
|
|
29
40
|
/**
|
|
30
41
|
* @param options - sessionsDir + 可选 index
|
|
31
42
|
*/
|
|
32
43
|
constructor(options: JsonlSessionStoreOptions);
|
|
44
|
+
private withWriteLock;
|
|
45
|
+
private readStateData;
|
|
33
46
|
private metaFile;
|
|
34
47
|
private sessionFile;
|
|
35
48
|
private sessionStateFile;
|
|
@@ -40,6 +53,22 @@ export declare class JsonlSessionStore implements SessionStore<SessionData> {
|
|
|
40
53
|
private removeSessionFiles;
|
|
41
54
|
load(sessionId: string): Promise<SessionData | null>;
|
|
42
55
|
save(sessionId: string, data: SessionData): Promise<void>;
|
|
56
|
+
/**
|
|
57
|
+
* metadata 原子读改写(含删键)。与 save 同会话串行。
|
|
58
|
+
*
|
|
59
|
+
* @param sessionId - 会话 id
|
|
60
|
+
* @param mutate - 原地修改 meta,或返回替换对象;返回 undefined 表示用原地结果
|
|
61
|
+
*/
|
|
62
|
+
updateMetadata(sessionId: string, mutate: (meta: Record<string, unknown>) => void | Record<string, unknown>): Promise<void>;
|
|
63
|
+
/**
|
|
64
|
+
* 消息序列对齐(Run 进行中转录增量落盘)。契约见 SessionStore.syncMessages。
|
|
65
|
+
*
|
|
66
|
+
* 增量判定:文件字节数与上次本实例写入一致,且给定序列以已同步序列为
|
|
67
|
+
* 引用相等前缀 → 只追加尾差;任一不成立(旁路整包 save / 外部改动 /
|
|
68
|
+
* 前缀分歧 / 冷缓存)→ 整文件对齐重写。漂移不是错误路径:旁路写者
|
|
69
|
+
* 整包 save 是常态动作,对齐即自愈。
|
|
70
|
+
*/
|
|
71
|
+
syncMessages(sessionId: string, messages: readonly unknown[]): Promise<void>;
|
|
43
72
|
list(filter?: SessionListFilter): Promise<SessionMeta[]>;
|
|
44
73
|
/**
|
|
45
74
|
* 按会话事实 lifecycle 过滤(索引投影;缺省视为 active)。
|