@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
|
@@ -16,11 +16,16 @@
|
|
|
16
16
|
*/
|
|
17
17
|
import { getTextContent } from '@octopi-agent/core/types.js';
|
|
18
18
|
import { HeuristicTokenEstimator, estimateLLMMessages } from './token-estimator.js';
|
|
19
|
+
import { toolResultBody } from './tool-result-body.js';
|
|
20
|
+
import { buildToolCallLedger } from './llm-summarizer.js';
|
|
21
|
+
import { agedToolResultPointer, agedToolArgDigest, applyAgingToMessages, computeToolResultAgingPlan, resolveToolResultAgingOptions, } from './tool-result-aging.js';
|
|
19
22
|
import { DefaultMessageSelector } from './message-selector.js';
|
|
20
23
|
import { HybridCompressor } from './hybrid-compressor.js';
|
|
21
24
|
import { DefaultBudgetAllocator } from './budget-allocator.js';
|
|
22
25
|
import { SmartRouter } from './smart-router.js';
|
|
23
26
|
import { compactStateKey } from './compact-key.js';
|
|
27
|
+
import { isTurnAnchor } from './layer-types.js';
|
|
28
|
+
import { extractUserMessageText, isTurnStartContent, } from './turn-envelope.js';
|
|
24
29
|
import { createCompactEngine } from './capabilities/compact/index.js';
|
|
25
30
|
// ── 引擎实现 ──
|
|
26
31
|
/** 摘要正文包装:确保带 [Conversation Summary] 标记,便于 extract / 调试 */
|
|
@@ -36,7 +41,6 @@ export class DefaultContextEngine {
|
|
|
36
41
|
info = {
|
|
37
42
|
id: 'default',
|
|
38
43
|
name: 'Default Context Engine',
|
|
39
|
-
ownsCompaction: true,
|
|
40
44
|
};
|
|
41
45
|
config;
|
|
42
46
|
router;
|
|
@@ -51,9 +55,14 @@ export class DefaultContextEngine {
|
|
|
51
55
|
router: config?.router ?? {},
|
|
52
56
|
protectFirstN: config?.protectFirstN ?? 3,
|
|
53
57
|
protectLastN: config?.protectLastN ?? 20,
|
|
54
|
-
compactThreshold: config?.compactThreshold ?? 0.5,
|
|
55
58
|
proactiveCompactRatio: config?.proactiveCompactRatio ?? 0.6,
|
|
56
59
|
proactiveCooldownMs: config?.proactiveCooldownMs ?? 30_000,
|
|
60
|
+
historyAging: resolveToolResultAgingOptions(config?.historyAging),
|
|
61
|
+
targetTokens: config?.targetTokens ?? 200_000,
|
|
62
|
+
// <1 或非法值回落缺省——0 会把目标线压成 0(压缩风暴),不是「禁用」语义
|
|
63
|
+
compactFallbackRatio: config?.compactFallbackRatio != null && config.compactFallbackRatio >= 1
|
|
64
|
+
? config.compactFallbackRatio
|
|
65
|
+
: 3,
|
|
57
66
|
compactEngine: config?.compactEngine ??
|
|
58
67
|
createCompactEngine({
|
|
59
68
|
defaultProtectHead: config?.protectFirstN ?? 3,
|
|
@@ -84,6 +93,10 @@ export class DefaultContextEngine {
|
|
|
84
93
|
const { sessionId, agentId, messages, systemPrompt, tools, contextWindow, compactTargetTokens, signal, tokenEstimator, summarize, emit, loadCompactState, } = params;
|
|
85
94
|
// E4:引擎内部 compact 状态键 = (sessionId, agentId)
|
|
86
95
|
const stateKey = compactStateKey(sessionId, agentId);
|
|
96
|
+
// F1-B2:老化计划基于**完整历史**(append-only)一次算好、随视图复用——
|
|
97
|
+
// 按裁剪视图重算会让已降级条目回原文、批量边界来回翻转(烧前缀缓存)。
|
|
98
|
+
// 估算(estimateLLMMessages)作用于老化后的 LLM 视图,尺子与实际请求一致。
|
|
99
|
+
const agingPlan = computeToolResultAgingPlan(messages, this.config.historyAging);
|
|
87
100
|
// 窗口未知且无显式 compactTargetTokens:跳过基于预算的自动压缩/截断
|
|
88
101
|
const budgetCap = params.tokenBudget ?? contextWindow ?? compactTargetTokens;
|
|
89
102
|
const windowKnown = contextWindow != null && contextWindow > 0;
|
|
@@ -99,16 +112,35 @@ export class DefaultContextEngine {
|
|
|
99
112
|
...existing,
|
|
100
113
|
previousSummary: restored.summary ?? existing?.previousSummary,
|
|
101
114
|
lastProactiveMessageCount: restored.lastProactiveMessageCount ?? existing?.lastProactiveMessageCount,
|
|
115
|
+
lastProactiveCoverEnd: restored.lastProactiveCoverEnd ?? existing?.lastProactiveCoverEnd,
|
|
102
116
|
lastProactiveTokens: restored.lastProactiveTokens ?? existing?.lastProactiveTokens,
|
|
103
117
|
});
|
|
104
118
|
}
|
|
105
119
|
}
|
|
106
120
|
}
|
|
107
|
-
// 未知窗口:无 token 预算 →
|
|
121
|
+
// 未知窗口:无 token 预算 → 不按 budget 截消息。
|
|
122
|
+
// F1-B3:targetTokens>0 时兜底压缩与窗口无关,窗口未知照样执行(工作目标解耦);
|
|
123
|
+
// targetTokens=0:只挂窗口比例线(proactiveCompactRatio);该模式窗口未知时跳过 proactive。
|
|
108
124
|
// 已有结构压缩摘要时,用 head + summary + tail 视图
|
|
109
125
|
if (!windowKnown && !targetKnown && budgetCap == null) {
|
|
110
|
-
const
|
|
111
|
-
|
|
126
|
+
const proactive = this.config.targetTokens > 0
|
|
127
|
+
? await this.applyProactiveCompact({
|
|
128
|
+
sessionId,
|
|
129
|
+
stateKey,
|
|
130
|
+
messages,
|
|
131
|
+
messagesBudget: 0,
|
|
132
|
+
agingPlan,
|
|
133
|
+
summarize,
|
|
134
|
+
estimator,
|
|
135
|
+
emit,
|
|
136
|
+
systemPrompt,
|
|
137
|
+
tools,
|
|
138
|
+
})
|
|
139
|
+
: { messages };
|
|
140
|
+
const view = proactive.messages !== messages
|
|
141
|
+
? { messages: proactive.messages, droppedSummary: proactive.droppedSummary }
|
|
142
|
+
: this.buildStructuralView(sessionId, messages, emit, stateKey);
|
|
143
|
+
const llmMessages = this.buildLlmMessages(view.messages, systemPrompt, tools, agingPlan);
|
|
112
144
|
const rawEstimatedTokens = estimateLLMMessages(llmMessages);
|
|
113
145
|
this.states.set(stateKey, {
|
|
114
146
|
...this.states.get(stateKey),
|
|
@@ -137,9 +169,12 @@ export class DefaultContextEngine {
|
|
|
137
169
|
stateKey,
|
|
138
170
|
messages,
|
|
139
171
|
messagesBudget: budget.messagesBudget,
|
|
172
|
+
agingPlan,
|
|
140
173
|
summarize,
|
|
141
174
|
estimator,
|
|
142
175
|
emit,
|
|
176
|
+
systemPrompt,
|
|
177
|
+
tools,
|
|
143
178
|
});
|
|
144
179
|
const workingMessages = proactive.messages;
|
|
145
180
|
const proactiveDroppedSummary = proactive.droppedSummary;
|
|
@@ -151,7 +186,7 @@ export class DefaultContextEngine {
|
|
|
151
186
|
}, estimator);
|
|
152
187
|
// 3. 如果没有溢出,不需要压缩
|
|
153
188
|
if (selection.overflow.length === 0) {
|
|
154
|
-
const llmMessages = this.buildLlmMessages(selection.kept, systemPrompt, tools);
|
|
189
|
+
const llmMessages = this.buildLlmMessages(selection.kept, systemPrompt, tools, agingPlan);
|
|
155
190
|
const rawEstimatedTokens = estimateLLMMessages(llmMessages);
|
|
156
191
|
const estimatedTokens = this.calibrateTokens(sessionId, rawEstimatedTokens, stateKey);
|
|
157
192
|
this.states.set(stateKey, {
|
|
@@ -191,6 +226,8 @@ export class DefaultContextEngine {
|
|
|
191
226
|
tokensBefore: overflowTokensBefore,
|
|
192
227
|
});
|
|
193
228
|
try {
|
|
229
|
+
// 缓存前缀:本轮会话同形 system+history(与主动摘要同纪律)
|
|
230
|
+
const overflowLlmPrefix = this.buildLlmMessages(workingMessages, systemPrompt, tools, agingPlan);
|
|
194
231
|
switch (routing.route) {
|
|
195
232
|
case 'truncate_tool_results_only': {
|
|
196
233
|
const compressed = await this.config.compressor.compress({
|
|
@@ -211,14 +248,15 @@ export class DefaultContextEngine {
|
|
|
211
248
|
previousSummary,
|
|
212
249
|
summarize,
|
|
213
250
|
tokenEstimator: estimator,
|
|
251
|
+
llmPrefix: overflowLlmPrefix,
|
|
214
252
|
});
|
|
215
253
|
compressedOverflow = compressed.result;
|
|
216
254
|
droppedSummary = compressed.droppedSummary;
|
|
217
255
|
break;
|
|
218
256
|
}
|
|
219
257
|
default: {
|
|
220
|
-
//
|
|
221
|
-
compressedOverflow = selection.overflow
|
|
258
|
+
// 兜底:保守降级(head + 工具账本 + tail),禁止只留 4 条
|
|
259
|
+
compressedOverflow = await this.conservativeTruncate(selection.overflow, estimator);
|
|
222
260
|
break;
|
|
223
261
|
}
|
|
224
262
|
}
|
|
@@ -231,17 +269,24 @@ export class DefaultContextEngine {
|
|
|
231
269
|
error: err instanceof Error ? err.message : String(err),
|
|
232
270
|
durationMs: Date.now() - overflowStart,
|
|
233
271
|
});
|
|
234
|
-
//
|
|
235
|
-
compressedOverflow = selection.overflow
|
|
272
|
+
// 压缩失败:保守降级,不中断本轮
|
|
273
|
+
compressedOverflow = await this.conservativeTruncate(selection.overflow, estimator);
|
|
236
274
|
droppedSummary = 'Context compact failed; fell back to truncation';
|
|
237
275
|
}
|
|
238
|
-
// 6.
|
|
239
|
-
// kept =
|
|
240
|
-
//
|
|
241
|
-
const
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
const
|
|
276
|
+
// 6. 重组(严格时间序):protectHead → 压缩旧 middle → 未压新 middle → tail
|
|
277
|
+
// kept = [protectHead, selectedMiddle, tail];overflow = 较旧 middle。
|
|
278
|
+
// 禁止把 compressedOverflow 插在 selectedMiddle 之后(乱序会伤推理且每轮边界漂移打穿前缀)。
|
|
279
|
+
const tailLen = selection.tail.length;
|
|
280
|
+
const keptBody = selection.kept.slice(0, Math.max(0, selection.kept.length - tailLen));
|
|
281
|
+
const headCount = Math.min(this.config.protectFirstN, workingMessages.length);
|
|
282
|
+
const protectHead = keptBody.slice(0, Math.min(headCount, keptBody.length));
|
|
283
|
+
const selectedMiddle = keptBody.slice(protectHead.length);
|
|
284
|
+
const reassembled = [
|
|
285
|
+
...protectHead,
|
|
286
|
+
...compressedOverflow,
|
|
287
|
+
...selectedMiddle,
|
|
288
|
+
...selection.tail,
|
|
289
|
+
];
|
|
245
290
|
// 7. 更新状态
|
|
246
291
|
const compressedTokens = estimator.estimateMessages(reassembled);
|
|
247
292
|
emit?.({
|
|
@@ -258,11 +303,15 @@ export class DefaultContextEngine {
|
|
|
258
303
|
...overflowState,
|
|
259
304
|
// 存摘要正文(而非 dropped 描述),供下次迭代更新
|
|
260
305
|
previousSummary: this.extractSummaryText(compressedOverflow) ?? overflowState?.previousSummary,
|
|
261
|
-
lastEstimatedTokens: compressedTokens,
|
|
262
306
|
});
|
|
263
|
-
// 8. 构建 LLM
|
|
264
|
-
|
|
307
|
+
// 8. 构建 LLM 消息(校准基 = 老化后 LLM 视图估算——尺子必须量实际请求,
|
|
308
|
+
// 不能像旧代码存 raw Message 估算,否则 calibrationRatio 系统性漂移)
|
|
309
|
+
const llmMessages = this.buildLlmMessages(reassembled, systemPrompt, tools, agingPlan);
|
|
265
310
|
const rawEstimatedTokens = estimateLLMMessages(llmMessages);
|
|
311
|
+
this.states.set(stateKey, {
|
|
312
|
+
...this.states.get(stateKey),
|
|
313
|
+
lastEstimatedTokens: rawEstimatedTokens,
|
|
314
|
+
});
|
|
266
315
|
const estimatedTokens = this.calibrateTokens(sessionId, rawEstimatedTokens, stateKey);
|
|
267
316
|
return {
|
|
268
317
|
messages: llmMessages,
|
|
@@ -282,92 +331,234 @@ export class DefaultContextEngine {
|
|
|
282
331
|
return {
|
|
283
332
|
summary: state?.previousSummary,
|
|
284
333
|
lastProactiveMessageCount: state?.lastProactiveMessageCount,
|
|
334
|
+
lastProactiveCoverEnd: state?.lastProactiveCoverEnd,
|
|
285
335
|
lastProactiveTokens: state?.lastProactiveTokens,
|
|
286
336
|
};
|
|
287
337
|
}
|
|
288
338
|
/**
|
|
289
|
-
*
|
|
339
|
+
* 主动压缩(路径 A):消息 token 超过触发线时,在硬溢出前收缩
|
|
290
340
|
*
|
|
291
|
-
*
|
|
292
|
-
* -
|
|
293
|
-
* -
|
|
294
|
-
*
|
|
341
|
+
* 触发线取两条线的 min(都保留,缺一不可):
|
|
342
|
+
* - **目标线** targetTokens × compactFallbackRatio——与窗口解耦,防长会话失忆
|
|
343
|
+
* - **窗口比例线** messagesBudget × proactiveCompactRatio——防小窗口/已知窗口到顶仍未触发
|
|
344
|
+
*
|
|
345
|
+
* 语义(粘滞 + ratio=0 禁新压缩):
|
|
346
|
+
* - **压缩视图粘滞**:一旦建立过压缩态(previousSummary 或 lastProactiveMessageCount),
|
|
347
|
+
* 后续装配优先复用 head+摘要/机械中间+tail,不因估算回落或 ratio=0 而打回全量
|
|
348
|
+
* (全量请求会 bust 前缀缓存,且等于撤销已完成的压缩)。
|
|
349
|
+
* - **proactiveCompactRatio=0**:禁止**发起新的**路径 A 压缩(不只禁 LLM);
|
|
350
|
+
* **不**丢弃已有压缩视图。
|
|
351
|
+
* - 策略:
|
|
352
|
+
* - ratio=0:无压缩态原样返回;有压缩态仅粘滞重建
|
|
353
|
+
* - 未超线且无压缩态:原样返回
|
|
354
|
+
* - 超线且需要新一轮压缩(上次压缩后新增消息够多):LLM 压缩中间段并产出语义摘要
|
|
355
|
+
* - 已有压缩态且增量小或冷却中或禁新 LLM:零 LLM 重建视图
|
|
295
356
|
*/
|
|
296
357
|
async applyProactiveCompact(params) {
|
|
297
|
-
const { sessionId, messages, messagesBudget, summarize, estimator, emit } = params;
|
|
358
|
+
const { sessionId, messages, messagesBudget, agingPlan, summarize, estimator, emit, systemPrompt, tools, } = params;
|
|
298
359
|
const stateKey = params.stateKey ?? sessionId;
|
|
299
360
|
const ratio = this.config.proactiveCompactRatio;
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
}
|
|
303
|
-
const currentTokens = estimator.estimateMessages(messages);
|
|
304
|
-
const threshold = Math.floor(messagesBudget * ratio);
|
|
305
|
-
if (currentTokens <= threshold) {
|
|
361
|
+
const state = this.states.get(stateKey);
|
|
362
|
+
if (messages.length === 0) {
|
|
306
363
|
return { messages };
|
|
307
364
|
}
|
|
308
365
|
const protectFirstN = this.config.protectFirstN;
|
|
309
366
|
const protectLastN = this.config.protectLastN;
|
|
367
|
+
// 压缩态粘滞:有摘要或覆盖计数即认定「已压缩」,之后不回全量
|
|
368
|
+
const hasCompactView = state?.lastProactiveMessageCount != null || !!state?.previousSummary;
|
|
369
|
+
// 边界对齐(不拆 tool_call/tool_result 对)——两形状都会被严格网关 400
|
|
370
|
+
const { headEnd, tailStart } = this.alignViewSplit(messages, protectFirstN, protectLastN);
|
|
371
|
+
const head = messages.slice(0, headEnd);
|
|
372
|
+
const tail = messages.slice(tailStart);
|
|
373
|
+
const middle = this.semanticHistory(messages.slice(headEnd, tailStart));
|
|
374
|
+
const headTailTokens = estimator.estimateMessages(head) + estimator.estimateMessages(tail);
|
|
375
|
+
/**
|
|
376
|
+
* 零 LLM 粘滞重建。
|
|
377
|
+
*
|
|
378
|
+
* 有语义摘要时:head + 摘要 + **摘要覆盖点之后的增量** + tail。
|
|
379
|
+
* 增量(上次 `lastProactiveMessageCount` 之后、已滑出 tail 的消息)不得被旧摘要顶掉——
|
|
380
|
+
* 否则长 tool turn 会丢当前 run 前半段工作记录。
|
|
381
|
+
*
|
|
382
|
+
* @param targetMiddleTokens - 增量段机械压缩预算
|
|
383
|
+
* @returns 重建视图;无法重建时返回 null
|
|
384
|
+
*/
|
|
385
|
+
const rebuildStickyView = async (targetMiddleTokens) => {
|
|
386
|
+
if (messages.length <= protectFirstN + protectLastN) {
|
|
387
|
+
return null;
|
|
388
|
+
}
|
|
389
|
+
if (state?.previousSummary) {
|
|
390
|
+
const summaryMsg = {
|
|
391
|
+
role: 'user',
|
|
392
|
+
content: wrapContextSummary(state.previousSummary),
|
|
393
|
+
timestamp: Date.now(),
|
|
394
|
+
metadata: { source: 'contextSummary' },
|
|
395
|
+
};
|
|
396
|
+
// 摘要覆盖到 lastProactiveCoverEnd(tailStart);之后的消息是增量,必须保留
|
|
397
|
+
const coverUpTo = state.lastProactiveCoverEnd ?? 0;
|
|
398
|
+
const sinceIdx = Math.max(coverUpTo, headEnd);
|
|
399
|
+
const sinceCompact = this.semanticHistory(messages.slice(sinceIdx, tailStart));
|
|
400
|
+
let extra = sinceCompact;
|
|
401
|
+
if (sinceCompact.length > 0) {
|
|
402
|
+
const extraTokens = estimator.estimateMessages(sinceCompact);
|
|
403
|
+
if (extraTokens > targetMiddleTokens) {
|
|
404
|
+
try {
|
|
405
|
+
const compressedExtra = await this.config.compressor.compress({
|
|
406
|
+
messages: sinceCompact,
|
|
407
|
+
targetTokens: targetMiddleTokens,
|
|
408
|
+
tokenEstimator: estimator,
|
|
409
|
+
});
|
|
410
|
+
extra = compressedExtra.result;
|
|
411
|
+
}
|
|
412
|
+
catch {
|
|
413
|
+
// 机械压缩失败:保留增量原文(宁可胖,不可丢)
|
|
414
|
+
extra = sinceCompact;
|
|
415
|
+
}
|
|
416
|
+
}
|
|
417
|
+
}
|
|
418
|
+
return { messages: [...head, summaryMsg, ...extra, ...tail] };
|
|
419
|
+
}
|
|
420
|
+
if (middle.length === 0) {
|
|
421
|
+
return null;
|
|
422
|
+
}
|
|
423
|
+
try {
|
|
424
|
+
const compressed = await this.config.compressor.compress({
|
|
425
|
+
messages: middle,
|
|
426
|
+
targetTokens: targetMiddleTokens,
|
|
427
|
+
tokenEstimator: estimator,
|
|
428
|
+
});
|
|
429
|
+
return { messages: [...head, ...compressed.result, ...tail] };
|
|
430
|
+
}
|
|
431
|
+
catch {
|
|
432
|
+
return null;
|
|
433
|
+
}
|
|
434
|
+
};
|
|
435
|
+
// F1-B3:尺子量**老化视图**(实际请求的保守上界)——raw 估算会把 B2 稳态误判超线(双机制打架)。
|
|
436
|
+
// 压缩输入仍用原 messages(摘要质量需要原文)。
|
|
437
|
+
const currentTokens = estimator.estimateMessages(applyAgingToMessages(messages, agingPlan, this.config.historyAging));
|
|
438
|
+
// 两条触发线(都保留;刻意不用 legacy 命名,防被当成死代码清掉):
|
|
439
|
+
// - 目标线 targetLine = targetTokens × compactFallbackRatio:与窗口解耦(F1-B3),
|
|
440
|
+
// 防长会话失忆;1M 窗口只挂比例线会永不触发。
|
|
441
|
+
// - 窗口比例线 windowRatioLine = messagesBudget × proactiveCompactRatio:
|
|
442
|
+
// 防小窗口(256k 等)在摸到目标线之前就顶满。
|
|
443
|
+
// 窗口未知(messagesBudget=0)时比例线为 +∞,只用目标线。
|
|
444
|
+
const targetLine = Math.ceil(this.config.targetTokens * this.config.compactFallbackRatio);
|
|
445
|
+
const windowRatioLine = messagesBudget > 0 ? Math.floor(messagesBudget * ratio) : Number.POSITIVE_INFINITY;
|
|
446
|
+
// ratio=0:禁止发起新的路径 A 压缩(不只禁 LLM)。已有粘滞视图仍重建,不打回全量。
|
|
447
|
+
if (ratio <= 0) {
|
|
448
|
+
if (!hasCompactView) {
|
|
449
|
+
return { messages };
|
|
450
|
+
}
|
|
451
|
+
// 粘滞增量预算挂工作目标(不挂被禁用的比例线)
|
|
452
|
+
const stickyBase = this.config.targetTokens > 0 ? this.config.targetTokens : 20_000;
|
|
453
|
+
const stickyMiddleTokens = Math.max(200, Math.floor(stickyBase * 0.55) - headTailTokens);
|
|
454
|
+
const sticky = await rebuildStickyView(stickyMiddleTokens);
|
|
455
|
+
if (!sticky) {
|
|
456
|
+
return { messages };
|
|
457
|
+
}
|
|
458
|
+
const reducedTokens = estimator.estimateMessages(sticky.messages);
|
|
459
|
+
this.states.set(stateKey, {
|
|
460
|
+
...state,
|
|
461
|
+
lastProactiveTokens: reducedTokens,
|
|
462
|
+
lastEstimatedTokens: reducedTokens,
|
|
463
|
+
});
|
|
464
|
+
return { messages: sticky.messages };
|
|
465
|
+
}
|
|
466
|
+
// 触发线:目标线与窗口比例线取 min——小窗口走有门槛/冷却的温和 A,
|
|
467
|
+
// 不被挤成死代码后交给无门槛的溢出路径每 turn 压缩(双机制打架换位置,评审 H1)。
|
|
468
|
+
const threshold = this.config.targetTokens > 0 ? Math.min(targetLine, windowRatioLine) : windowRatioLine;
|
|
469
|
+
const targetMiddleTokens = Math.max(200, Math.floor(threshold * 0.55) - headTailTokens);
|
|
470
|
+
// 新 LLM 压缩闸门(方案 E):
|
|
471
|
+
// - 无 summarize 或 turn 内:禁止新 LLM,不丢已有压缩态
|
|
472
|
+
// - **turn 内**(最近真实 user 之后已有工具活动):禁止新 LLM 摘要——
|
|
473
|
+
// 活动工作记录在 middle 里,摘要会吃掉当前 run;只允许机械分级
|
|
474
|
+
// - turn 边界(新 user 刚到、工具活动尚未开始):才允许对更早历史做 LLM 摘要
|
|
475
|
+
const midTurn = isMidTurn(messages);
|
|
476
|
+
const allowNewLlmCompact = !!summarize && !midTurn;
|
|
477
|
+
// 未超线:无压缩态则原样;有压缩态则粘滞重建(禁止回全量)
|
|
478
|
+
if (currentTokens <= threshold) {
|
|
479
|
+
if (!hasCompactView) {
|
|
480
|
+
return { messages };
|
|
481
|
+
}
|
|
482
|
+
const sticky = await rebuildStickyView(targetMiddleTokens);
|
|
483
|
+
if (!sticky) {
|
|
484
|
+
return { messages };
|
|
485
|
+
}
|
|
486
|
+
const reducedTokens = estimator.estimateMessages(sticky.messages);
|
|
487
|
+
this.states.set(stateKey, {
|
|
488
|
+
...state,
|
|
489
|
+
lastProactiveTokens: reducedTokens,
|
|
490
|
+
lastEstimatedTokens: reducedTokens,
|
|
491
|
+
});
|
|
492
|
+
return { messages: sticky.messages };
|
|
493
|
+
}
|
|
310
494
|
if (messages.length <= protectFirstN + protectLastN) {
|
|
311
495
|
return { messages };
|
|
312
496
|
}
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
//
|
|
317
|
-
// 注意:只比「自上次摘要以来新增条数」,不要拿全量 token 和压缩后视图比
|
|
497
|
+
// 判据:是否开启新一轮压缩 —— 只看「自上次压缩以来的新增条数」与冷却。
|
|
498
|
+
// 注意:只比「自上次压缩以来新增条数」,不要拿全量 token 和压缩后视图比;
|
|
499
|
+
// 也不要把「有无 previousSummary」当判据:压缩可能是机械截断(无摘要),
|
|
500
|
+
// 拿摘要存在与否当判据会让无摘要会话每轮重裁、复用分支永远进不去。
|
|
318
501
|
const lastCount = state?.lastProactiveMessageCount;
|
|
319
502
|
const newSinceLast = lastCount === undefined ? messages.length : messages.length - lastCount;
|
|
320
503
|
const minNewForResummarize = Math.max(3, Math.floor(protectLastN * 0.25));
|
|
321
|
-
|
|
504
|
+
// 增长门(target 模式;防「偶发兜底」变「周期压缩」):持续超线的会话全量口径不回落,
|
|
505
|
+
// 若只看消息增量,每攒 minNewForResummarize 条就全量重压(LLM 成本/延迟失控)。
|
|
506
|
+
// 只有全量口径较上次压缩实质增长(≥ 25% 阈值)才允许再打 LLM。
|
|
507
|
+
// targetTokens=0(只挂窗口比例线)保持既有「攒够增量重试」节奏不动。
|
|
508
|
+
const lastFull = state?.lastProactiveFullTokens;
|
|
509
|
+
const grownEnough = this.config.targetTokens <= 0 ||
|
|
510
|
+
lastFull === undefined ||
|
|
511
|
+
currentTokens >= lastFull + Math.max(1, Math.floor(threshold * 0.25));
|
|
512
|
+
const needNewCompaction = newSinceLast >= minNewForResummarize && grownEnough;
|
|
322
513
|
// 冷却:刚做过 LLM 摘要则优先缓存重建,降低单 turn 双摘要概率
|
|
323
514
|
const cooldownMs = this.config.proactiveCooldownMs;
|
|
324
515
|
const inCooldown = cooldownMs > 0 &&
|
|
325
516
|
state?.lastProactiveLlmAt != null &&
|
|
326
517
|
Date.now() - state.lastProactiveLlmAt < cooldownMs;
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
durationMs: 0,
|
|
360
|
-
cached: true,
|
|
361
|
-
});
|
|
362
|
-
return { messages: reduced };
|
|
518
|
+
// 复用重建(零 LLM):已压缩过,且增量小或在冷却期或禁止新 LLM。
|
|
519
|
+
if (hasCompactView &&
|
|
520
|
+
(!allowNewLlmCompact || !needNewCompaction || inCooldown)) {
|
|
521
|
+
const sticky = await rebuildStickyView(targetMiddleTokens);
|
|
522
|
+
if (sticky) {
|
|
523
|
+
const reducedTokens = estimator.estimateMessages(sticky.messages);
|
|
524
|
+
// 只更新视图 token,**不要**改 lastProactiveMessageCount:
|
|
525
|
+
// 该字段表示「压缩覆盖到的全量条数」,只能在真正完成一次压缩时推进。
|
|
526
|
+
// 若复用重建也改成 messages.length,每轮 +1 会永远凑不满再压缩阈值。
|
|
527
|
+
this.states.set(stateKey, {
|
|
528
|
+
...state,
|
|
529
|
+
lastProactiveTokens: reducedTokens,
|
|
530
|
+
lastEstimatedTokens: reducedTokens,
|
|
531
|
+
});
|
|
532
|
+
emit?.({
|
|
533
|
+
type: 'context.compact.start',
|
|
534
|
+
sessionId,
|
|
535
|
+
reason: 'proactive',
|
|
536
|
+
tokensBefore: currentTokens,
|
|
537
|
+
threshold,
|
|
538
|
+
});
|
|
539
|
+
emit?.({
|
|
540
|
+
type: 'context.compact.end',
|
|
541
|
+
sessionId,
|
|
542
|
+
reason: 'proactive',
|
|
543
|
+
tokensBefore: currentTokens,
|
|
544
|
+
tokensAfter: reducedTokens,
|
|
545
|
+
durationMs: 0,
|
|
546
|
+
cached: true,
|
|
547
|
+
});
|
|
548
|
+
return { messages: sticky.messages };
|
|
549
|
+
}
|
|
363
550
|
}
|
|
364
|
-
//
|
|
365
|
-
|
|
551
|
+
// 禁新路径 A(无 summarize / turn 内)且无粘滞视图:超线也只走机械(不打摘要 LLM)
|
|
552
|
+
if (!allowNewLlmCompact) {
|
|
553
|
+
const sticky = await rebuildStickyView(targetMiddleTokens);
|
|
554
|
+
return sticky ? { messages: sticky.messages } : { messages };
|
|
555
|
+
}
|
|
556
|
+
// 需要新一轮压缩:压缩 head/tail 之间的中间段(语义历史,不含 grounding)。
|
|
557
|
+
// requireSummary:主交付是语义摘要(缓解长会话失忆),机械截断达标也必须补摘要——
|
|
558
|
+
// 否则 previousSummary 永远为空、复用分支永远进不去,每个 turn 都会重裁+发通知。
|
|
366
559
|
if (middle.length === 0) {
|
|
367
560
|
return { messages };
|
|
368
561
|
}
|
|
369
|
-
const headTailTokens = estimator.estimateMessages(head) + estimator.estimateMessages(tail);
|
|
370
|
-
const targetMiddleTokens = Math.max(200, Math.floor(threshold * 0.55) - headTailTokens);
|
|
371
562
|
const proactiveStart = Date.now();
|
|
372
563
|
emit?.({
|
|
373
564
|
type: 'context.compact.start',
|
|
@@ -378,12 +569,16 @@ export class DefaultContextEngine {
|
|
|
378
569
|
});
|
|
379
570
|
let compressed;
|
|
380
571
|
try {
|
|
572
|
+
// 缓存前缀 = 会话同形 system+history(禁止改字节);摘要指令只挂在尾部
|
|
573
|
+
const llmPrefix = this.buildLlmMessages(messages, systemPrompt, tools, agingPlan);
|
|
381
574
|
compressed = await this.config.compressor.compress({
|
|
382
575
|
messages: middle,
|
|
383
576
|
targetTokens: targetMiddleTokens,
|
|
384
577
|
previousSummary: state?.previousSummary,
|
|
385
578
|
summarize,
|
|
386
579
|
tokenEstimator: estimator,
|
|
580
|
+
requireSummary: true,
|
|
581
|
+
llmPrefix,
|
|
387
582
|
});
|
|
388
583
|
}
|
|
389
584
|
catch (err) {
|
|
@@ -394,8 +589,9 @@ export class DefaultContextEngine {
|
|
|
394
589
|
error: err instanceof Error ? err.message : String(err),
|
|
395
590
|
durationMs: Date.now() - proactiveStart,
|
|
396
591
|
});
|
|
397
|
-
//
|
|
398
|
-
|
|
592
|
+
// 主动摘要失败:优先粘滞重建,其次不改视图
|
|
593
|
+
const sticky = await rebuildStickyView(targetMiddleTokens);
|
|
594
|
+
return sticky ? { messages: sticky.messages } : { messages };
|
|
399
595
|
}
|
|
400
596
|
const reduced = [...head, ...compressed.result, ...tail];
|
|
401
597
|
const reducedTokens = estimator.estimateMessages(reduced);
|
|
@@ -404,8 +600,13 @@ export class DefaultContextEngine {
|
|
|
404
600
|
...state,
|
|
405
601
|
previousSummary: actualSummary,
|
|
406
602
|
lastEstimatedTokens: reducedTokens,
|
|
603
|
+
// 增长门用全量条数;覆盖终点单独记 tailStart(tail 不在摘要内)
|
|
407
604
|
lastProactiveMessageCount: messages.length,
|
|
605
|
+
lastProactiveCoverEnd: tailStart,
|
|
408
606
|
lastProactiveTokens: reducedTokens,
|
|
607
|
+
lastProactiveFullTokens: currentTokens,
|
|
608
|
+
// 本轮(requireSummary)真正发起过 LLM 摘要调用(成功或失败均算发起),
|
|
609
|
+
// 时间戳用于冷却;复用重建与纯机械降级不得推进此字段。
|
|
409
610
|
lastProactiveLlmAt: Date.now(),
|
|
410
611
|
});
|
|
411
612
|
emit?.({
|
|
@@ -422,32 +623,131 @@ export class DefaultContextEngine {
|
|
|
422
623
|
droppedSummary: compressed.droppedSummary ?? 'Older turns proactively summarized',
|
|
423
624
|
};
|
|
424
625
|
}
|
|
425
|
-
/**
|
|
626
|
+
/**
|
|
627
|
+
* 保守降级(overflow **middle 替换体**):工具账本说明 + 近尾
|
|
628
|
+
* 外层 head/tail 由 assemble 重组拼接,此处不得重复携带。
|
|
629
|
+
*
|
|
630
|
+
* @param messages - 待降级消息(overflow 段)
|
|
631
|
+
* @param _estimator - token 估算器(保留签名对称)
|
|
632
|
+
* @returns 降级后的消息列表
|
|
633
|
+
*/
|
|
634
|
+
async conservativeTruncate(messages, _estimator) {
|
|
635
|
+
const keepCount = Math.min(Math.max(6, Math.ceil(messages.length * 0.15)), messages.length);
|
|
636
|
+
const kept = messages.slice(-keepCount);
|
|
637
|
+
const dropped = messages.slice(0, messages.length - keepCount);
|
|
638
|
+
// 无可丢弃:原样返回(禁止「0 removed」假通知膨胀)
|
|
639
|
+
if (dropped.length === 0) {
|
|
640
|
+
return [...messages];
|
|
641
|
+
}
|
|
642
|
+
const body = buildToolCallLedger(dropped);
|
|
643
|
+
const notice = {
|
|
644
|
+
role: 'user',
|
|
645
|
+
content: body
|
|
646
|
+
? `[Context truncated: ${dropped.length} earlier messages removed to fit context window]\n[Tool call ledger — do NOT redo these unless explicitly asked]\n${body}`
|
|
647
|
+
: `[Context truncated: ${dropped.length} earlier messages removed to fit context window]`,
|
|
648
|
+
timestamp: Date.now(),
|
|
649
|
+
metadata: { source: 'contextSummary' },
|
|
650
|
+
};
|
|
651
|
+
return [notice, ...kept];
|
|
652
|
+
}
|
|
653
|
+
/**
|
|
654
|
+
* 从压缩结果中提取语义摘要正文(contextSummary 标记或 [Conversation Summary] 前缀)。
|
|
655
|
+
* 机械降级的占位说明([Context truncated / [Context compressed / [Structural compact])
|
|
656
|
+
* 不算语义摘要:把它们当摘要存入 previousSummary 会污染增量合并输入,
|
|
657
|
+
* 并让复用分支拿到假摘要、掩盖「从未真正摘要」的事实。
|
|
658
|
+
*/
|
|
426
659
|
extractSummaryText(compressed) {
|
|
427
660
|
for (const m of compressed) {
|
|
428
|
-
if (m.metadata?.source === 'contextSummary' &&
|
|
661
|
+
if (m.metadata?.source === 'contextSummary' &&
|
|
662
|
+
typeof m.content === 'string' &&
|
|
663
|
+
m.content.trim() &&
|
|
664
|
+
!this.isMechanicalNotice(m.content)) {
|
|
429
665
|
return m.content;
|
|
430
666
|
}
|
|
431
667
|
}
|
|
432
668
|
for (const m of compressed) {
|
|
433
|
-
if (typeof m.content === 'string' &&
|
|
669
|
+
if (typeof m.content === 'string' &&
|
|
670
|
+
m.content.includes('[Conversation Summary]') &&
|
|
671
|
+
!this.isMechanicalNotice(m.content)) {
|
|
434
672
|
return m.content;
|
|
435
673
|
}
|
|
436
674
|
}
|
|
437
675
|
return undefined;
|
|
438
676
|
}
|
|
439
677
|
/**
|
|
440
|
-
*
|
|
441
|
-
*
|
|
678
|
+
* 机械降级占位说明判别(非语义摘要):首条实质行以占位标记开头即认定。
|
|
679
|
+
* 只看首行而非全文 includes——真实摘要引用这些字符串(如记录「曾发生截断」)不得被误杀。
|
|
680
|
+
*
|
|
681
|
+
* @param text - 候选摘要正文
|
|
682
|
+
* @returns 是否为机械占位说明
|
|
683
|
+
*/
|
|
684
|
+
isMechanicalNotice(text) {
|
|
685
|
+
for (const raw of text.split('\n')) {
|
|
686
|
+
const line = raw.trim();
|
|
687
|
+
if (!line || line === '[Conversation Summary]')
|
|
688
|
+
continue;
|
|
689
|
+
return (line.startsWith('[Context truncated:') ||
|
|
690
|
+
line.startsWith('[Context compressed:') ||
|
|
691
|
+
line.startsWith('[Structural compact]'));
|
|
692
|
+
}
|
|
693
|
+
return false;
|
|
694
|
+
}
|
|
695
|
+
/**
|
|
696
|
+
* 判断是否工具结果消息(视图边界对齐用)
|
|
697
|
+
*
|
|
698
|
+
* @param msg - 待判定消息
|
|
699
|
+
* @returns 是否为工具结果消息
|
|
700
|
+
*/
|
|
701
|
+
isToolResultMessage(msg) {
|
|
702
|
+
return msg.role === 'tool' || (msg.toolResults?.length ?? 0) > 0;
|
|
703
|
+
}
|
|
704
|
+
/**
|
|
705
|
+
* 视图切分边界对齐(不拆 tool_call/tool_result 对)
|
|
706
|
+
*
|
|
707
|
+
* head 不得停在带 toolCalls 的 assistant 上(其结果落入中间段,视图里会成悬空调用);
|
|
708
|
+
* tail 不得起于 tool 结果(其调用在中间段,会成孤儿结果)——两种形状都会被严格网关 400。
|
|
709
|
+
*
|
|
710
|
+
* @param messages - 全量消息
|
|
711
|
+
* @param headCount - 期望头部条数
|
|
712
|
+
* @param tailCount - 期望尾部条数
|
|
713
|
+
* @returns 对齐后的 head 终点(不含)与 tail 起点(含)
|
|
714
|
+
*/
|
|
715
|
+
alignViewSplit(messages, headCount, tailCount) {
|
|
716
|
+
let headEnd = Math.min(headCount, messages.length);
|
|
717
|
+
while (headEnd > 0 && (messages[headEnd - 1]?.toolCalls?.length ?? 0) > 0) {
|
|
718
|
+
headEnd--;
|
|
719
|
+
}
|
|
720
|
+
let tailStart = Math.max(0, messages.length - tailCount);
|
|
721
|
+
while (tailStart > headEnd && this.isToolResultMessage(messages[tailStart])) {
|
|
722
|
+
tailStart--;
|
|
723
|
+
}
|
|
724
|
+
return { headEnd, tailStart };
|
|
725
|
+
}
|
|
726
|
+
/**
|
|
727
|
+
* 压缩/摘要的语义输入:丢掉托管 system 与 turn 信封元数据
|
|
728
|
+
* (turn_context picks 不进 previousSummary——防陈旧择取固化进摘要);
|
|
729
|
+
* turn_start 只保留 <user_message> 正文。
|
|
442
730
|
*/
|
|
443
731
|
semanticHistory(messages) {
|
|
444
|
-
|
|
732
|
+
const out = [];
|
|
733
|
+
for (const m of messages) {
|
|
445
734
|
if (m.role === 'system' && m.metadata?.source === 'systemPrompt')
|
|
446
|
-
|
|
735
|
+
continue;
|
|
736
|
+
if (m.metadata?.source === 'turnEnd')
|
|
737
|
+
continue;
|
|
447
738
|
if (m.metadata?.source === 'knowledgeGrounding')
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
739
|
+
continue;
|
|
740
|
+
if (m.metadata?.source === 'runtimeSnapshot')
|
|
741
|
+
continue;
|
|
742
|
+
if (m.metadata?.source === 'sessionAttachment')
|
|
743
|
+
continue;
|
|
744
|
+
if (isTurnStartContent(m.content)) {
|
|
745
|
+
out.push({ ...m, content: extractUserMessageText(m.content) });
|
|
746
|
+
continue;
|
|
747
|
+
}
|
|
748
|
+
out.push(m);
|
|
749
|
+
}
|
|
750
|
+
return out;
|
|
451
751
|
}
|
|
452
752
|
/**
|
|
453
753
|
* 结构视图:有 previousSummary 时 head + summary + tail;否则原样
|
|
@@ -464,8 +764,11 @@ export class DefaultContextEngine {
|
|
|
464
764
|
if (messages.length <= protectFirstN + protectLastN) {
|
|
465
765
|
return { messages };
|
|
466
766
|
}
|
|
467
|
-
|
|
468
|
-
|
|
767
|
+
// 边界对齐(不拆 tool_call/tool_result 对):与 applyProactiveCompact 同款——
|
|
768
|
+
// 未对齐的 head/tail 会被严格网关 400
|
|
769
|
+
const { headEnd, tailStart } = this.alignViewSplit(messages, protectFirstN, protectLastN);
|
|
770
|
+
const head = messages.slice(0, headEnd);
|
|
771
|
+
const tail = messages.slice(tailStart);
|
|
469
772
|
const summaryMsg = {
|
|
470
773
|
role: 'user',
|
|
471
774
|
content: wrapContextSummary(summary),
|
|
@@ -495,7 +798,7 @@ export class DefaultContextEngine {
|
|
|
495
798
|
* 算法委托 capabilities/compact;本引擎只维护 E4 状态。
|
|
496
799
|
*/
|
|
497
800
|
async structuralCompact(params) {
|
|
498
|
-
const { sessionId, messages, summarize, estimator } = params;
|
|
801
|
+
const { sessionId, messages, summarize, estimator, llmPrefix } = params;
|
|
499
802
|
const stateKey = params.stateKey ?? sessionId;
|
|
500
803
|
const protectFirstN = this.config.protectFirstN;
|
|
501
804
|
const protectLastN = this.config.protectLastN;
|
|
@@ -503,14 +806,21 @@ export class DefaultContextEngine {
|
|
|
503
806
|
const state = this.states.get(stateKey);
|
|
504
807
|
if (messages.length <= protectFirstN + protectLastN) {
|
|
505
808
|
return {
|
|
506
|
-
summary: state?.previousSummary
|
|
809
|
+
summary: state?.previousSummary,
|
|
810
|
+
compacted: false,
|
|
507
811
|
tokensBefore,
|
|
508
812
|
tokensAfter: tokensBefore,
|
|
813
|
+
coveredMessageCount: state?.lastProactiveCoverEnd,
|
|
509
814
|
};
|
|
510
815
|
}
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
816
|
+
// 覆盖坐标与 applyProactiveCompact / rebuildStickyView 同一系:
|
|
817
|
+
// 原始 messages 上 alignViewSplit → middle 语义历史 → 摘要;coverEnd = tailStart。
|
|
818
|
+
// 禁止对 semanticHistory(全量) 切 protectHead/Tail(过滤数组下标 ≠ 原始下标,会丢消息)。
|
|
819
|
+
const { headEnd, tailStart } = this.alignViewSplit(messages, protectFirstN, protectLastN);
|
|
820
|
+
const middle = this.semanticHistory(messages.slice(headEnd, tailStart));
|
|
821
|
+
const outcome = await this.config.compactEngine.compactMessages(middle, {
|
|
822
|
+
protectHead: 0,
|
|
823
|
+
protectTail: 0,
|
|
514
824
|
targetTokens: params.compactTargetTokens,
|
|
515
825
|
mode: 'structure_only',
|
|
516
826
|
previousSummary: state?.previousSummary,
|
|
@@ -520,67 +830,28 @@ export class DefaultContextEngine {
|
|
|
520
830
|
? Math.max(200, Math.floor(params.compactTargetTokens * 0.3))
|
|
521
831
|
: undefined,
|
|
522
832
|
onSummarizeFail: 'truncate',
|
|
833
|
+
llmPrefix,
|
|
523
834
|
});
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
835
|
+
// 与 extractSummaryText 同一不变量:机械占位说明不是语义摘要,不得进入 previousSummary
|
|
836
|
+
// (增量合并输入、复用重建依据、持久化快照来源)——否则占位会经快照恢复再次污染状态。
|
|
837
|
+
const semanticSummary = outcome.summary && !this.isMechanicalNotice(outcome.summary) ? outcome.summary : undefined;
|
|
838
|
+
const summary = semanticSummary ?? state?.previousSummary;
|
|
527
839
|
const tokensAfter = outcome.tokensAfter ?? tokensBefore;
|
|
528
840
|
this.states.set(stateKey, {
|
|
529
841
|
...state,
|
|
530
842
|
previousSummary: summary,
|
|
531
843
|
lastProactiveMessageCount: messages.length,
|
|
844
|
+
lastProactiveCoverEnd: tailStart,
|
|
532
845
|
lastProactiveTokens: tokensAfter,
|
|
533
846
|
lastEstimatedTokens: tokensAfter,
|
|
534
847
|
lastProactiveLlmAt: summarize ? Date.now() : state?.lastProactiveLlmAt,
|
|
535
848
|
});
|
|
536
|
-
return { summary, tokensBefore, tokensAfter };
|
|
537
|
-
}
|
|
538
|
-
/**
|
|
539
|
-
* 压缩存储
|
|
540
|
-
*
|
|
541
|
-
* - force / 无 tokenBudget:可走结构压缩(compactStructural)
|
|
542
|
-
* - 有 tokenBudget 且非 force:低于阈值跳过
|
|
543
|
-
* - 窗口未知且非 force、无 target:跳过自动压缩
|
|
544
|
-
*/
|
|
545
|
-
async compact(params) {
|
|
546
|
-
const { sessionId, agentId, tokenBudget, compactTargetTokens, force, currentTokenCount, } = params;
|
|
547
|
-
const stateKey = compactStateKey(sessionId, agentId);
|
|
548
|
-
const state = this.states.get(stateKey);
|
|
549
|
-
if (!state) {
|
|
550
|
-
return {
|
|
551
|
-
ok: true,
|
|
552
|
-
compacted: false,
|
|
553
|
-
reason: 'No state found for session',
|
|
554
|
-
tokensBefore: 0,
|
|
555
|
-
};
|
|
556
|
-
}
|
|
557
|
-
const tokensBefore = currentTokenCount ?? state.lastEstimatedTokens ?? state.lastProactiveTokens ?? 0;
|
|
558
|
-
if (!force && tokenBudget != null && tokenBudget > 0) {
|
|
559
|
-
const threshold = Math.floor(tokenBudget * this.config.compactThreshold);
|
|
560
|
-
if (tokensBefore <= threshold) {
|
|
561
|
-
return {
|
|
562
|
-
ok: true,
|
|
563
|
-
compacted: false,
|
|
564
|
-
reason: `Tokens (${tokensBefore}) below threshold (${threshold})`,
|
|
565
|
-
tokensBefore,
|
|
566
|
-
};
|
|
567
|
-
}
|
|
568
|
-
}
|
|
569
|
-
// 窗口未知 + 非 force + 无显式 target:禁用自动压缩
|
|
570
|
-
if (!force && tokenBudget == null && compactTargetTokens == null) {
|
|
571
|
-
return {
|
|
572
|
-
ok: true,
|
|
573
|
-
compacted: false,
|
|
574
|
-
reason: 'contextWindow unknown; auto compact disabled (force/structural still available)',
|
|
575
|
-
tokensBefore,
|
|
576
|
-
};
|
|
577
|
-
}
|
|
578
|
-
this.states.delete(stateKey);
|
|
579
849
|
return {
|
|
580
|
-
|
|
581
|
-
compacted:
|
|
582
|
-
reason: force ? 'forced' : 'threshold',
|
|
850
|
+
summary,
|
|
851
|
+
compacted: outcome.compacted,
|
|
583
852
|
tokensBefore,
|
|
853
|
+
tokensAfter,
|
|
854
|
+
coveredMessageCount: tailStart,
|
|
584
855
|
};
|
|
585
856
|
}
|
|
586
857
|
/**
|
|
@@ -599,14 +870,16 @@ export class DefaultContextEngine {
|
|
|
599
870
|
summarize: input.summarize,
|
|
600
871
|
estimator,
|
|
601
872
|
compactTargetTokens: input.compactTargetTokens,
|
|
873
|
+
llmPrefix: input.llmPrefix,
|
|
602
874
|
});
|
|
603
875
|
return {
|
|
604
876
|
ok: true,
|
|
605
|
-
compacted:
|
|
877
|
+
compacted: result.compacted,
|
|
606
878
|
reason: 'structural',
|
|
607
879
|
tokensBefore: result.tokensBefore,
|
|
608
880
|
tokensAfter: result.tokensAfter,
|
|
609
|
-
summary: result.summary
|
|
881
|
+
summary: result.summary,
|
|
882
|
+
coveredMessageCount: result.coveredMessageCount,
|
|
610
883
|
};
|
|
611
884
|
}
|
|
612
885
|
/**
|
|
@@ -657,7 +930,6 @@ export class DefaultContextEngine {
|
|
|
657
930
|
* 使用校准比率修正 token 估算
|
|
658
931
|
*
|
|
659
932
|
* 当有真实 usage 数据时,用 calibrationRatio 修正启发式估算值。
|
|
660
|
-
* 参考 OpenClaw 的 estimateContextTokens() 策略:
|
|
661
933
|
* 优先用真实值,估算只做兜底,校准比率平滑修正偏差。
|
|
662
934
|
*/
|
|
663
935
|
calibrateTokens(sessionId, rawEstimated, stateKey) {
|
|
@@ -669,7 +941,7 @@ export class DefaultContextEngine {
|
|
|
669
941
|
const clampedRatio = Math.max(0.5, Math.min(2.0, state.calibrationRatio));
|
|
670
942
|
return Math.ceil(rawEstimated * clampedRatio);
|
|
671
943
|
}
|
|
672
|
-
buildLlmMessages(messages, systemPrompt, tools) {
|
|
944
|
+
buildLlmMessages(messages, systemPrompt, tools, aging) {
|
|
673
945
|
const result = [];
|
|
674
946
|
// 系统提示词(唯一权威来源)。
|
|
675
947
|
// Loop 会把同一内容以 metadata.source==='systemPrompt' unshift 进 messages,
|
|
@@ -677,21 +949,19 @@ export class DefaultContextEngine {
|
|
|
677
949
|
if (systemPrompt) {
|
|
678
950
|
result.push({ role: 'system', content: systemPrompt });
|
|
679
951
|
}
|
|
680
|
-
//
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
lastGroundingIdx = i;
|
|
685
|
-
}
|
|
952
|
+
// 全回放(append-only):turn_context / turn_end / 历史槽位一律保留,
|
|
953
|
+
// 否则历史中部删改会打穿 provider 前缀缓存。
|
|
954
|
+
// 唯一例外:runStopped 是引擎停止的审计/展示凭据,不是对话内容——
|
|
955
|
+
// 它只进聊天回放(系统提示条),不回灌 LLM(否则每次停止都在上下文里留痕)。
|
|
686
956
|
for (let i = 0; i < messages.length; i++) {
|
|
687
957
|
const msg = messages[i];
|
|
688
958
|
if (msg.role === 'system' && msg.metadata?.source === 'systemPrompt') {
|
|
689
959
|
continue;
|
|
690
960
|
}
|
|
691
|
-
if (msg.metadata?.source === '
|
|
961
|
+
if (msg.metadata?.source === 'runStopped') {
|
|
692
962
|
continue;
|
|
693
963
|
}
|
|
694
|
-
result.push(...this.convertMessage(msg));
|
|
964
|
+
result.push(...this.convertMessage(msg, aging));
|
|
695
965
|
}
|
|
696
966
|
return result;
|
|
697
967
|
}
|
|
@@ -704,7 +974,7 @@ export class DefaultContextEngine {
|
|
|
704
974
|
* - 工具结果消息
|
|
705
975
|
* - 多模态消息
|
|
706
976
|
*/
|
|
707
|
-
convertMessage(msg) {
|
|
977
|
+
convertMessage(msg, aging) {
|
|
708
978
|
const result = [];
|
|
709
979
|
// 清理无效消息
|
|
710
980
|
if (this.shouldSkipMessage(msg)) {
|
|
@@ -715,11 +985,10 @@ export class DefaultContextEngine {
|
|
|
715
985
|
// 错误必须进入 content:Loop 写历史时 result=null、error=文案,
|
|
716
986
|
// 若只读 result 会变成 "null",LLM 看不到失败原因。
|
|
717
987
|
for (const tr of msg.toolResults ?? []) {
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
: JSON.stringify(tr.result ?? null);
|
|
988
|
+
// F1-B2:老化条目降级为结构化指针(错误文案保真在指针内;tool_call 配对不动)
|
|
989
|
+
const content = aging && aging.agedIds.has(tr.toolCallId)
|
|
990
|
+
? agedToolResultPointer(tr, aging.argsById.get(tr.toolCallId), this.config.historyAging)
|
|
991
|
+
: toolResultBody(tr);
|
|
723
992
|
result.push({
|
|
724
993
|
role: 'tool',
|
|
725
994
|
content,
|
|
@@ -730,17 +999,23 @@ export class DefaultContextEngine {
|
|
|
730
999
|
}
|
|
731
1000
|
else if (msg.role === 'assistant' && msg.toolCalls?.length) {
|
|
732
1001
|
// 带工具调用的 assistant 消息
|
|
1002
|
+
// F1-B2:与结果同步老化的参数降级为键值摘要(id/name 不动,arguments 仍是合法 JSON)
|
|
733
1003
|
result.push({
|
|
734
1004
|
role: 'assistant',
|
|
735
1005
|
content: getTextContent(msg.content) || null,
|
|
736
|
-
tool_calls: msg.toolCalls.map(tc =>
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
1006
|
+
tool_calls: msg.toolCalls.map(tc => {
|
|
1007
|
+
const args = aging && this.config.historyAging.ageToolArgs && aging.agedIds.has(tc.id)
|
|
1008
|
+
? agedToolArgDigest(tc.name, tc.arguments, this.config.historyAging)
|
|
1009
|
+
: tc.arguments;
|
|
1010
|
+
return {
|
|
1011
|
+
id: tc.id,
|
|
1012
|
+
type: 'function',
|
|
1013
|
+
function: {
|
|
1014
|
+
name: tc.name,
|
|
1015
|
+
arguments: JSON.stringify(args),
|
|
1016
|
+
},
|
|
1017
|
+
};
|
|
1018
|
+
}),
|
|
744
1019
|
});
|
|
745
1020
|
}
|
|
746
1021
|
else if (Array.isArray(msg.content)) {
|
|
@@ -834,3 +1109,39 @@ export class DefaultContextEngine {
|
|
|
834
1109
|
return false;
|
|
835
1110
|
}
|
|
836
1111
|
}
|
|
1112
|
+
/**
|
|
1113
|
+
* 是否处于 turn 内(最近真实 user 消息之后已有工具活动)
|
|
1114
|
+
*
|
|
1115
|
+
* 方案 E:turn 内 middle 全是当前 run 工作记录,禁止 LLM 摘要;
|
|
1116
|
+
* turn 边界(新 user 刚落、尚无工具)才允许对更早历史做语义压缩。
|
|
1117
|
+
*
|
|
1118
|
+
* 「真实 user」= 无 agentId 归因,且非引擎载体(含 `engineHint` reliability 注入)。
|
|
1119
|
+
* 多 agent 共线时带 agentId 的 user 不重置本边界(只认主对话发言)。
|
|
1120
|
+
*
|
|
1121
|
+
* @param messages - 全量消息
|
|
1122
|
+
* @returns 是否 turn 内
|
|
1123
|
+
*/
|
|
1124
|
+
export function isMidTurn(messages) {
|
|
1125
|
+
let lastGenuineUserIdx = -1;
|
|
1126
|
+
for (let i = 0; i < messages.length; i++) {
|
|
1127
|
+
const msg = messages[i];
|
|
1128
|
+
// 「真实 user」收紧:agentId 归因的 user(appendCommandDiscourse)不重置边界,
|
|
1129
|
+
// 载体过滤走唯一谓词 isTurnAnchor
|
|
1130
|
+
if (msg.agentId)
|
|
1131
|
+
continue;
|
|
1132
|
+
if (!isTurnAnchor(msg))
|
|
1133
|
+
continue;
|
|
1134
|
+
lastGenuineUserIdx = i;
|
|
1135
|
+
}
|
|
1136
|
+
if (lastGenuineUserIdx < 0)
|
|
1137
|
+
return false;
|
|
1138
|
+
for (let i = lastGenuineUserIdx + 1; i < messages.length; i++) {
|
|
1139
|
+
const msg = messages[i];
|
|
1140
|
+
if (msg.role === 'tool' ||
|
|
1141
|
+
(msg.toolResults?.length ?? 0) > 0 ||
|
|
1142
|
+
(msg.toolCalls?.length ?? 0) > 0) {
|
|
1143
|
+
return true;
|
|
1144
|
+
}
|
|
1145
|
+
}
|
|
1146
|
+
return false;
|
|
1147
|
+
}
|