@octopi-agent/engine 0.98.4 → 0.121.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/builtin-model-info.js +28 -7
- package/dist/config-admin/agent-presets.d.ts +32 -0
- package/dist/config-admin/agent-presets.js +133 -0
- package/dist/config-admin/discover.d.ts +33 -4
- package/dist/config-admin/discover.js +101 -6
- package/dist/config-admin/env.d.ts +11 -0
- package/dist/config-admin/env.js +41 -0
- package/dist/config-admin/error-copy.d.ts +106 -0
- package/dist/config-admin/error-copy.js +287 -0
- package/dist/config-admin/i18n.d.ts +21 -0
- package/dist/config-admin/i18n.js +19 -0
- package/dist/config-admin/index.d.ts +6 -2
- package/dist/config-admin/index.js +3 -1
- package/dist/config-admin/model-presets.d.ts +14 -0
- package/dist/config-admin/model-presets.js +595 -70
- package/dist/config-admin/onboarding-apply.d.ts +71 -0
- package/dist/config-admin/onboarding-apply.js +235 -0
- package/dist/config-admin/onboarding.d.ts +154 -0
- package/dist/config-admin/onboarding.js +270 -0
- package/dist/config-admin/redact.d.ts +42 -9
- package/dist/config-admin/redact.js +69 -5
- package/dist/config-schema/agent.d.ts +40 -6
- package/dist/config-schema/agent.js +44 -6
- package/dist/config-schema/browser.d.ts +62 -0
- package/dist/config-schema/browser.js +89 -0
- package/dist/config-schema/context.d.ts +12 -37
- package/dist/config-schema/context.js +10 -31
- package/dist/config-schema/engine.d.ts +140 -164
- package/dist/config-schema/engine.js +10 -7
- package/dist/config-schema/governance.d.ts +20 -2
- package/dist/config-schema/governance.js +18 -3
- package/dist/config-schema/models.d.ts +10 -12
- package/dist/config-schema/models.js +16 -3
- package/dist/config-schema/run.d.ts +6 -2
- package/dist/config-schema/run.js +12 -2
- package/dist/config-schema/shared.d.ts +1 -3
- package/dist/config-schema/shared.js +4 -4
- package/dist/config-schema/substrate.d.ts +19 -88
- package/dist/config-schema/substrate.js +30 -107
- package/dist/config.d.ts +161 -123
- package/dist/config.js +109 -7
- package/dist/file-mode.d.ts +67 -0
- package/dist/file-mode.js +182 -0
- package/dist/fork-child.d.ts +82 -0
- package/dist/fork-child.js +123 -0
- package/dist/harness/activation/delegated-run.d.ts +42 -0
- package/dist/harness/activation/delegated-run.js +71 -0
- package/dist/harness/activation/dispatcher.js +11 -0
- package/dist/harness/activation/inbox.d.ts +3 -3
- package/dist/harness/activation/inbox.js +3 -3
- package/dist/harness/activation/index.d.ts +1 -0
- package/dist/harness/activation/run-backend.d.ts +92 -0
- package/dist/harness/activation/run-backend.js +16 -0
- package/dist/harness/activation/run-protocol.d.ts +392 -0
- package/dist/harness/activation/run-protocol.js +19 -0
- package/dist/harness/activation/runtime.d.ts +33 -0
- package/dist/harness/activation/runtime.js +130 -31
- package/dist/harness/activation/types.d.ts +20 -3
- package/dist/harness/agent/builder.d.ts +36 -3
- package/dist/harness/agent/builder.js +206 -46
- package/dist/harness/agent/config-bridge.d.ts +10 -1
- package/dist/harness/agent/config-bridge.js +24 -5
- package/dist/harness/agent/config-integrity.js +19 -2
- package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
- package/dist/harness/agent/registered-tool-adapter.js +67 -0
- package/dist/harness/agent/wire-agent-builder.d.ts +13 -3
- package/dist/harness/agent/wire-agent-builder.js +35 -9
- package/dist/harness/capabilities/document/backends/plain.js +2 -1
- package/dist/harness/capabilities/document/factory.d.ts +5 -0
- package/dist/harness/capabilities/document/factory.js +1 -0
- package/dist/harness/capabilities/document/legacy/factory.js +3 -2
- package/dist/harness/capabilities/document/port.js +6 -3
- package/dist/harness/capabilities/document/types.d.ts +5 -0
- package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
- package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
- package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
- package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
- package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
- package/dist/harness/collaboration/autonomous-subsystem/loader.js +2 -1
- package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
- package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +14 -4
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +50 -41
- package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
- package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
- package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +4 -1
- package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +7 -3
- package/dist/harness/collaboration/delegation/child-run.d.ts +10 -1
- package/dist/harness/collaboration/delegation/child-run.js +38 -6
- package/dist/harness/collaboration/delegation/index.d.ts +1 -1
- package/dist/harness/collaboration/delegation/index.js +1 -1
- package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
- package/dist/harness/collaboration/delegation/notifier.js +8 -1
- package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
- package/dist/harness/collaboration/delegation/service.d.ts +11 -4
- package/dist/harness/collaboration/delegation/service.js +35 -13
- package/dist/harness/collaboration/delegation/store.d.ts +4 -0
- package/dist/harness/collaboration/delegation/store.js +3 -1
- package/dist/harness/collaboration/delegation/types.d.ts +34 -2
- package/dist/harness/collaboration/delegation/types.js +22 -0
- package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
- package/dist/harness/collaboration/delegation/wiring.js +12 -1
- package/dist/harness/context/budget-allocator.d.ts +26 -18
- package/dist/harness/context/budget-allocator.js +67 -32
- package/dist/harness/context/capabilities/compact/engine.d.ts +44 -11
- package/dist/harness/context/capabilities/compact/engine.js +296 -160
- package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
- package/dist/harness/context/capabilities/compact/handover.js +7 -5
- package/dist/harness/context/capabilities/compact/index.d.ts +7 -2
- package/dist/harness/context/capabilities/compact/index.js +5 -1
- package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
- package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
- package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
- package/dist/harness/context/capabilities/compact/messages.js +91 -0
- package/dist/harness/context/capabilities/compact/types.d.ts +134 -19
- package/dist/harness/context/capabilities/compact/types.js +11 -1
- package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
- package/dist/harness/context/capabilities/compact/view-split.js +72 -0
- package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
- package/dist/harness/context/capabilities/summary/gate.js +53 -6
- package/dist/harness/context/capabilities/summary/port.js +0 -1
- package/dist/harness/context/capabilities/summary/registry.js +20 -0
- package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
- package/dist/harness/context/capabilities/summary/resolver.js +1 -6
- package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
- package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
- package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
- package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
- package/dist/harness/context/capabilities/summary/types.d.ts +19 -6
- package/dist/harness/context/constitution/default-agents.md +85 -0
- package/dist/harness/context/context-size-ledger.d.ts +143 -0
- package/dist/harness/context/context-size-ledger.js +243 -0
- package/dist/harness/context/default-context-engine.d.ts +290 -120
- package/dist/harness/context/default-context-engine.js +1555 -764
- package/dist/harness/context/index.d.ts +3 -2
- package/dist/harness/context/index.js +2 -1
- package/dist/harness/context/layer-health.d.ts +4 -0
- package/dist/harness/context/layer-health.js +4 -0
- package/dist/harness/context/layer-types.d.ts +72 -0
- package/dist/harness/context/layer-types.js +87 -2
- package/dist/harness/context/layers.d.ts +17 -15
- package/dist/harness/context/layers.js +54 -17
- package/dist/harness/context/message-selector.d.ts +10 -8
- package/dist/harness/context/message-selector.js +49 -27
- package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
- package/dist/harness/context/prefix-fingerprint.js +52 -0
- package/dist/harness/context/summarize.d.ts +2 -2
- package/dist/harness/context/summarize.js +27 -2
- package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
- package/dist/harness/context/system-prompt-assembler.js +7 -3
- package/dist/harness/context/token-constants.d.ts +8 -6
- package/dist/harness/context/token-constants.js +8 -7
- package/dist/harness/context/token-estimate-fns.d.ts +37 -27
- package/dist/harness/context/token-estimate-fns.js +85 -66
- package/dist/harness/context/token-estimator.d.ts +27 -12
- package/dist/harness/context/token-estimator.js +120 -66
- package/dist/harness/context/token-segments.d.ts +88 -0
- package/dist/harness/context/token-segments.js +103 -0
- package/dist/harness/context/tool-result-aging.d.ts +109 -16
- package/dist/harness/context/tool-result-aging.js +220 -55
- package/dist/harness/context/tool-result-body.js +2 -0
- package/dist/harness/context/transform/anchors.d.ts +66 -0
- package/dist/harness/context/transform/anchors.js +125 -0
- package/dist/harness/context/transform/fold.d.ts +56 -0
- package/dist/harness/context/transform/fold.js +135 -0
- package/dist/harness/context/transform/migrate.d.ts +41 -0
- package/dist/harness/context/transform/migrate.js +69 -0
- package/dist/harness/context/transform/types.d.ts +129 -0
- package/dist/harness/context/transform/types.js +19 -0
- package/dist/harness/context/turn-envelope.d.ts +6 -3
- package/dist/harness/context/types.d.ts +196 -119
- package/dist/harness/context/types.js +25 -1
- package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
- package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
- package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
- package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
- package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
- package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
- package/dist/harness/extension/execution-environment/workspace.js +1 -1
- package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +28 -2
- package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
- package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
- package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
- package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
- package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
- package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
- package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
- package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
- package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
- package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
- package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
- package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +223 -222
- package/dist/harness/extension/plugin-ecosystem/plugins/api.js +218 -203
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +78 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +80 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
- package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
- package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +57 -114
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +279 -282
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +46 -484
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +123 -345
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +50 -223
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +144 -20
- package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +17 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
- package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
- package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
- package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
- package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
- package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
- package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
- package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +36 -8
- package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
- package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
- package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
- package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
- package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
- package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
- package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +19 -24
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
- package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
- package/dist/harness/governance/accounting/usage-ledger.js +23 -1
- package/dist/harness/governance/credentials/db.d.ts +9 -0
- package/dist/harness/governance/credentials/db.js +122 -31
- package/dist/harness/governance/credentials/store.d.ts +68 -7
- package/dist/harness/governance/credentials/store.js +177 -64
- package/dist/harness/governance/credentials/types.d.ts +13 -2
- package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
- package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
- package/dist/harness/governance/index.d.ts +1 -0
- package/dist/harness/governance/index.js +1 -0
- package/dist/harness/governance/registry/db.d.ts +32 -0
- package/dist/harness/governance/registry/db.js +142 -0
- package/dist/harness/governance/registry/index.d.ts +9 -0
- package/dist/harness/governance/registry/index.js +9 -0
- package/dist/harness/governance/registry/service.d.ts +381 -0
- package/dist/harness/governance/registry/service.js +825 -0
- package/dist/harness/governance/registry/types.d.ts +77 -0
- package/dist/harness/governance/registry/types.js +7 -0
- package/dist/harness/governance/security/capability-enforcer.js +1 -2
- package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
- package/dist/harness/governance/security/default-security-guard.js +12 -1
- package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
- package/dist/harness/governance/security/risk-evaluator.js +307 -21
- package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
- package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
- package/dist/harness/index.d.ts +17 -15
- package/dist/harness/index.js +9 -9
- package/dist/harness/knowledge/boot-config.d.ts +57 -0
- package/dist/harness/knowledge/boot-config.js +52 -0
- package/dist/harness/knowledge/catalog-types.d.ts +2 -0
- package/dist/harness/knowledge/client.d.ts +77 -9
- package/dist/harness/knowledge/client.js +95 -24
- package/dist/harness/knowledge/db.d.ts +16 -0
- package/dist/harness/knowledge/db.js +112 -41
- package/dist/harness/knowledge/describe-sample.d.ts +23 -0
- package/dist/harness/knowledge/describe-sample.js +58 -0
- package/dist/harness/knowledge/describe.d.ts +8 -0
- package/dist/harness/knowledge/describe.js +18 -2
- package/dist/harness/knowledge/engine-thread.js +11 -7
- package/dist/harness/knowledge/grounding.js +7 -2
- package/dist/harness/knowledge/http-app.d.ts +15 -0
- package/dist/harness/knowledge/http-app.js +117 -25
- package/dist/harness/knowledge/http-bridge.d.ts +15 -0
- package/dist/harness/knowledge/http-bridge.js +19 -0
- package/dist/harness/knowledge/http-params.d.ts +18 -0
- package/dist/harness/knowledge/http-params.js +24 -0
- package/dist/harness/knowledge/index.d.ts +2 -0
- package/dist/harness/knowledge/index.js +1 -0
- package/dist/harness/knowledge/knowledge-serve-child.js +5 -3
- package/dist/harness/knowledge/purge.js +5 -2
- package/dist/harness/knowledge/query-service.d.ts +25 -4
- package/dist/harness/knowledge/query-service.js +79 -43
- package/dist/harness/knowledge/query-worker-client.d.ts +14 -2
- package/dist/harness/knowledge/query-worker-client.js +8 -3
- package/dist/harness/knowledge/query-worker.js +9 -5
- package/dist/harness/knowledge/read-http.d.ts +2 -0
- package/dist/harness/knowledge/read-http.js +14 -3
- package/dist/harness/knowledge/retriever.d.ts +1 -1
- package/dist/harness/knowledge/retriever.js +1 -2
- package/dist/harness/knowledge/serve.d.ts +14 -8
- package/dist/harness/knowledge/serve.js +14 -6
- package/dist/harness/knowledge/source-store.d.ts +101 -5
- package/dist/harness/knowledge/source-store.js +323 -74
- package/dist/harness/knowledge/start-service-process.d.ts +41 -14
- package/dist/harness/knowledge/start-service-process.js +67 -96
- package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
- package/dist/harness/knowledge/tenant-gate.js +167 -0
- package/dist/harness/knowledge/types.d.ts +7 -0
- package/dist/harness/knowledge/writer-service.d.ts +55 -11
- package/dist/harness/knowledge/writer-service.js +200 -30
- package/dist/harness/knowledge/writer-worker-client.d.ts +19 -11
- package/dist/harness/knowledge/writer-worker-client.js +40 -5
- package/dist/harness/knowledge/writer-worker.js +20 -5
- package/dist/harness/memory/backfill-trigger.d.ts +10 -3
- package/dist/harness/memory/backfill-trigger.js +19 -19
- package/dist/harness/memory/cognition-seeds.d.ts +45 -0
- package/dist/harness/memory/cognition-seeds.js +67 -0
- package/dist/harness/memory/cognition.d.ts +12 -3
- package/dist/harness/memory/cognition.js +55 -35
- package/dist/harness/memory/conceptualizer.d.ts +11 -1
- package/dist/harness/memory/conceptualizer.js +10 -1
- package/dist/harness/memory/context-slice.d.ts +42 -0
- package/dist/harness/memory/context-slice.js +197 -0
- package/dist/harness/memory/health-probe.d.ts +8 -2
- package/dist/harness/memory/health-probe.js +10 -13
- package/dist/harness/memory/index.d.ts +5 -1
- package/dist/harness/memory/index.js +3 -1
- package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
- package/dist/harness/memory/sqlite/agent-db.js +9 -8
- package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
- package/dist/harness/memory/sqlite/cognition-store.js +103 -45
- package/dist/harness/memory/sqlite/memory-store.js +4 -0
- package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
- package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
- package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
- package/dist/harness/memory/types.d.ts +24 -6
- package/dist/harness/memory/wisdom-formation.d.ts +14 -3
- package/dist/harness/memory/wisdom-formation.js +85 -22
- package/dist/harness/memory/wisdom-gates.d.ts +14 -0
- package/dist/harness/memory/wisdom-gates.js +59 -19
- package/dist/harness/memory/wisdom.js +9 -0
- package/dist/harness/observability/observer/hub.d.ts +10 -0
- package/dist/harness/observability/observer/hub.js +120 -17
- package/dist/harness/observability/observer/types.d.ts +10 -6
- package/dist/harness/run/agent/agent.d.ts +40 -21
- package/dist/harness/run/agent/agent.js +67 -13
- package/dist/harness/run/agent/index.d.ts +1 -1
- package/dist/harness/run/budget/budget.d.ts +28 -10
- package/dist/harness/run/budget/budget.js +38 -15
- package/dist/harness/run/concurrency/tool-validator.js +4 -3
- package/dist/harness/run/model/index.d.ts +3 -1
- package/dist/harness/run/model/index.js +2 -1
- package/dist/harness/run/model/resolver.d.ts +4 -1
- package/dist/harness/run/model/resolver.js +36 -2
- package/dist/harness/run/model/run-scope.d.ts +2 -0
- package/dist/harness/run/model/run-scope.js +7 -0
- package/dist/harness/run/model/types.d.ts +22 -5
- package/dist/harness/run/model/types.js +3 -2
- package/dist/harness/run/model/window-truth.d.ts +37 -0
- package/dist/harness/run/model/window-truth.js +39 -0
- package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
- package/dist/harness/run/reliability/context-length-feedback.js +128 -0
- package/dist/harness/run/reliability/harness-events.d.ts +3 -3
- package/dist/harness/run/reliability/model-error-policy.js +4 -0
- package/dist/harness/run/reliability/run-agent.d.ts +32 -4
- package/dist/harness/run/reliability/run-agent.js +216 -63
- package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
- package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
- package/dist/harness/run/run-guard/default-run-guard.js +8 -8
- package/dist/harness/run/run-host.d.ts +302 -0
- package/dist/harness/run/run-host.js +978 -0
- package/dist/harness/run/run-scope.d.ts +48 -4
- package/dist/harness/run/run-scope.js +19 -1
- package/dist/harness/run/runner.d.ts +181 -39
- package/dist/harness/run/runner.js +654 -119
- package/dist/harness/session/attachments/index.d.ts +1 -0
- package/dist/harness/session/attachments/index.js +1 -0
- package/dist/harness/session/attachments/inject.d.ts +21 -10
- package/dist/harness/session/attachments/inject.js +76 -24
- package/dist/harness/session/attachments/recall-index.d.ts +70 -0
- package/dist/harness/session/attachments/recall-index.js +219 -0
- package/dist/harness/session/attachments/service.d.ts +21 -0
- package/dist/harness/session/attachments/service.js +258 -139
- package/dist/harness/session/attachments/types.d.ts +6 -0
- package/dist/harness/session/in-memory-store.js +13 -1
- package/dist/harness/session/schedules/service.d.ts +10 -2
- package/dist/harness/session/schedules/service.js +13 -2
- package/dist/harness/session/tasks/tools.js +12 -0
- package/dist/harness/session/transform-store.d.ts +136 -0
- package/dist/harness/session/transform-store.js +302 -0
- package/dist/harness/session/types.d.ts +11 -15
- package/dist/harness/shared/events/agent-event-map.d.ts +75 -13
- package/dist/harness/shared/events/agent-event-map.js +3 -2
- package/dist/harness/shared/events/scenario-events.d.ts +6 -6
- package/dist/harness/shared/types/agent-definition.d.ts +7 -2
- package/dist/index.d.ts +16 -18
- package/dist/index.js +9 -10
- package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
- package/dist/integration/agent-runtime/channel-message-source.js +4 -3
- package/dist/integration/browser/camoufox.d.ts +40 -0
- package/dist/integration/browser/camoufox.js +80 -0
- package/dist/integration/browser/index.d.ts +91 -0
- package/dist/integration/browser/index.js +110 -0
- package/dist/integration/browser/install.d.ts +47 -0
- package/dist/integration/browser/install.js +214 -0
- package/dist/integration/browser/playwright.d.ts +224 -0
- package/dist/integration/browser/playwright.js +925 -0
- package/dist/integration/browser/service.d.ts +41 -0
- package/dist/integration/browser/service.js +181 -0
- package/dist/integration/browser/stealth.d.ts +42 -0
- package/dist/integration/browser/stealth.js +104 -0
- package/dist/integration/observability/metrics.d.ts +6 -6
- package/dist/integration/observability/metrics.js +13 -13
- package/dist/integration/observability/observer-bridge.js +2 -2
- package/dist/integration/observability/trace-collector.d.ts +5 -5
- package/dist/integration/observability/trace-collector.js +34 -35
- package/dist/integration/observability/trace-events.d.ts +3 -3
- package/dist/integration/observability/trace-events.js +3 -3
- package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
- package/dist/integration/providers/anthropic-message-normalize.js +48 -0
- package/dist/integration/providers/anthropic.js +41 -3
- package/dist/integration/providers/fetch-timeout.d.ts +17 -0
- package/dist/integration/providers/fetch-timeout.js +24 -0
- package/dist/integration/providers/openai.d.ts +8 -0
- package/dist/integration/providers/openai.js +48 -2
- package/dist/integration/providers/usage.d.ts +1 -1
- package/dist/integration/providers/wire-dump-diff.js +2 -1
- package/dist/integration/providers/wire-dump.d.ts +57 -3
- package/dist/integration/providers/wire-dump.js +119 -6
- package/dist/integration/storage/archive-manager.d.ts +20 -2
- package/dist/integration/storage/archive-manager.js +34 -8
- package/dist/integration/storage/atomic-tmp.d.ts +12 -0
- package/dist/integration/storage/atomic-tmp.js +36 -0
- package/dist/integration/storage/jsonl.d.ts +10 -1
- package/dist/integration/storage/jsonl.js +155 -54
- package/dist/integration/storage/session-index.d.ts +5 -0
- package/dist/integration/storage/session-index.js +25 -4
- package/dist/integration/tools/assemble.d.ts +50 -0
- package/dist/integration/tools/assemble.js +137 -0
- package/dist/paths.d.ts +18 -0
- package/dist/paths.js +36 -0
- package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
- package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
- package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
- package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
- package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
- package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
- package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
- package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
- package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
- package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
- package/dist/subsystems/wisdom-steward/formation/config.yaml +4 -0
- package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
- package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
- package/package.json +14 -15
- package/dist/harness/context/hybrid-compressor.d.ts +0 -41
- package/dist/harness/context/hybrid-compressor.js +0 -159
- package/dist/harness/context/llm-summarizer.d.ts +0 -46
- package/dist/harness/context/llm-summarizer.js +0 -249
- package/dist/harness/context/smart-router.d.ts +0 -75
- package/dist/harness/context/smart-router.js +0 -118
- package/dist/harness/context/truncate-compressor.d.ts +0 -28
- package/dist/harness/context/truncate-compressor.js +0 -107
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
- package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
- package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
- package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
- package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
|
@@ -3,37 +3,38 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Harness 层的默认实现,整合所有组件:
|
|
5
5
|
* - MessageSelector:消息选择
|
|
6
|
-
* -
|
|
6
|
+
* - capabilities/compact:压缩执行(交接摘要 + 机械降级阶梯;本引擎只做触发/状态)
|
|
7
7
|
* - BudgetAllocator:预算分配
|
|
8
8
|
* - TokenEstimator:Token 估算
|
|
9
9
|
*
|
|
10
10
|
* 特性:
|
|
11
|
-
* -
|
|
12
|
-
*
|
|
13
|
-
*
|
|
11
|
+
* - **持久转换记录**(arch/context-size-accounting.md §10.18):压缩产物是事实,
|
|
12
|
+
* 不是临时视图。装配 = 原文 + 有效记录的确定性 fold(transform/fold)——没有
|
|
13
|
+
* 游标、没有增量抢救;没被记录覆盖的消息逐字在视图里。回填只在显式撤销时。
|
|
14
|
+
* - fresh 门控只决定**新记录的类型**(summary / degrade),不再决定旧记录是否生效。
|
|
15
|
+
* - 四区域划分(头部保护 + 中间可压缩 + 尾部保护)退为压缩时刻的选段策略:
|
|
16
|
+
* 保护窗决定记录覆盖哪些消息(写进锚点),装配不再看它们。
|
|
17
|
+
* - 边界对齐(不拆分 tool_call/tool_result 对)——同上,压缩时刻生效。
|
|
14
18
|
* - 迭代式摘要(传入上次摘要,更新而非重建)
|
|
15
19
|
* - 实际 token 数回写
|
|
16
20
|
*/
|
|
17
|
-
import type { Message } from '@octopi-agent/core/types.js';
|
|
18
|
-
import type {
|
|
19
|
-
import type { ContextEngine, ContextEngineInfo, AssembleParams, AssembleResult, IngestParams,
|
|
21
|
+
import type { Message, ToolResultAger } from '@octopi-agent/core/types.js';
|
|
22
|
+
import type { LLMToolDefinition } from '@octopi-agent/core/interfaces/model-provider.js';
|
|
23
|
+
import type { ContextEngine, ContextEngineInfo, AssembleParams, AssembleResult, IngestParams, AfterStepParams, TokenEstimator, SummarizeFunction, MessageSelector, BudgetAllocator, ContextEmitFn, ContextCompactSnapshot } from './types.js';
|
|
20
24
|
import { type ToolResultAgingConfig } from './tool-result-aging.js';
|
|
21
|
-
import type {
|
|
22
|
-
import type {
|
|
25
|
+
import type { CompactEngine, CompactOutcome } from './capabilities/compact/index.js';
|
|
26
|
+
import type { TransformStore } from './transform/types.js';
|
|
23
27
|
export interface DefaultContextEngineConfig {
|
|
24
28
|
/** 消息选择策略 */
|
|
25
29
|
messageSelector?: MessageSelector;
|
|
26
|
-
/** 压缩策略 */
|
|
27
|
-
compressor?: Compressor;
|
|
28
30
|
/** 预算分配策略 */
|
|
29
31
|
budgetAllocator?: BudgetAllocator;
|
|
30
32
|
/** Token 估算器 */
|
|
31
33
|
tokenEstimator?: TokenEstimator;
|
|
32
34
|
/** 智能路由器配置 */
|
|
33
|
-
|
|
34
|
-
/** 头部保护消息数(默认 5:交接快照的「任务前因」) */
|
|
35
|
+
/** 头部保护消息数(默认 5:交接快照的「任务前因」)。压缩时刻的选段策略。 */
|
|
35
36
|
protectFirstN?: number;
|
|
36
|
-
/** 尾部保护消息数(默认 20
|
|
37
|
+
/** 尾部保护消息数(默认 20:进度锚,明确任务截止到哪)。压缩时刻的选段策略。 */
|
|
37
38
|
protectLastN?: number;
|
|
38
39
|
/** 摘要软目标预算(P1c 缺省 clamp(2%, 2k, 8k)):可配置 ratioPct/minTokens/maxTokens */
|
|
39
40
|
summaryBudget?: {
|
|
@@ -44,155 +45,209 @@ export interface DefaultContextEngineConfig {
|
|
|
44
45
|
/**
|
|
45
46
|
* 窗口比例线:消息 token / messagesBudget 超过该比例时,
|
|
46
47
|
* 在窗口硬溢出之前先做主动压缩(缓解长会话失忆 / 窗口到顶未触发)。
|
|
47
|
-
* 默认 0.6;`0` = 禁止**发起新的**路径 A 压缩(不只禁 LLM
|
|
48
|
+
* 默认 0.6;`0` = 禁止**发起新的**路径 A 压缩(不只禁 LLM),不丢已有转换记录。
|
|
48
49
|
*/
|
|
49
50
|
proactiveCompactRatio?: number;
|
|
51
|
+
/** 主动 LLM 摘要冷却(ms)。冷却期内零 LLM 复用(fold),避免单 turn 双摘要。默认 30_000。 */
|
|
52
|
+
proactiveCooldownMs?: number;
|
|
50
53
|
/**
|
|
51
|
-
*
|
|
52
|
-
* 默认
|
|
54
|
+
* 单次摘要 LLM 调用预算(ms)。0 = 不设预算(只受 provider 超时约束)。
|
|
55
|
+
* 默认 300_000:摘要请求体量与视图同阶(P2 后约 100–200KB),正常远低于此值;
|
|
56
|
+
* 留足慢 provider / 大请求的余量,同时给「provider 挂死」一个确定上界——超时即中止,
|
|
57
|
+
* 按 onSummarizeFail 降级(2026-11-07 事故)。中断不续做:下一轮重新发起即可。
|
|
53
58
|
*/
|
|
54
|
-
|
|
59
|
+
summarizeTimeoutMs?: number;
|
|
55
60
|
/**
|
|
56
61
|
* 历史工具结果批量冻结老化(F1-B2):当前 run 永不老化、近 rawWindow 条跨轮原文、
|
|
57
62
|
* 更旧按 freezeBatch 成批降级为结构化指针(视图级、write-once、禁渐进)。
|
|
58
63
|
* 缺省启用(40 条 / 批 20 / 指针 400 字符)。
|
|
59
64
|
*/
|
|
60
65
|
historyAging?: ToolResultAgingConfig;
|
|
61
|
-
/**
|
|
62
|
-
* 工作目标 token(与窗口解耦,F1-B3)。>0 时主动压缩目标线 = targetTokens ×
|
|
63
|
-
* compactFallbackRatio,并与窗口比例线取 min。
|
|
64
|
-
* 默认 200000;0 = 只挂窗口比例线(proactiveCompactRatio)。
|
|
65
|
-
*/
|
|
66
|
+
/** 工作目标 token(与窗口解耦,F1-B3)。>0 时主动压缩目标线 = targetTokens × compactFallbackRatio。默认 200000。 */
|
|
66
67
|
targetTokens?: number;
|
|
68
|
+
/** 目标线倍数(默认 3)。触发线 = targetTokens × compactFallbackRatio;窗口比例线始终并存。 */
|
|
69
|
+
compactFallbackRatio?: number;
|
|
67
70
|
/**
|
|
68
|
-
*
|
|
69
|
-
*
|
|
70
|
-
*
|
|
71
|
-
*
|
|
71
|
+
* turn 内(工具活动进行中)主动压缩的保护尾条数(2026-11-07 方案 E 修订)。
|
|
72
|
+
* turn 内进行中的工作记录(最近的工具步骤/证据/推理链)不进压缩选段,由活跃窗口保护;
|
|
73
|
+
* 窗口外的执行痕迹可正常语义压缩(长任务 turn 内上下文持续增长时目标线才真正生效)。
|
|
74
|
+
* turn 边界仍用 protectLastN。默认 50;取 max(protectLastN, midTurnProtectLastN)。
|
|
72
75
|
*/
|
|
73
|
-
|
|
74
|
-
/** 公用能力 CompactEngine
|
|
76
|
+
midTurnProtectLastN?: number;
|
|
77
|
+
/** 公用能力 CompactEngine(缺省自动创建;算法委托,记录/状态仍在本引擎) */
|
|
75
78
|
compactEngine?: CompactEngine;
|
|
79
|
+
/**
|
|
80
|
+
* 转换记录存储(持久化拍板:记录跨装配永久生效)。缺省 InMemory(进程内永久);
|
|
81
|
+
* 组合层注入 JsonlTransformStore 获得 `sessions/<sid>/transform/` 持久化。
|
|
82
|
+
*/
|
|
83
|
+
transformStore?: TransformStore;
|
|
84
|
+
/** Host extension boundary; absent preserves the existing engine exactly. */
|
|
85
|
+
extensionHooks?: import('../extension/plugin-ecosystem/hooks/types.js').ExtensionHookPort;
|
|
86
|
+
extensionIdentity?: {
|
|
87
|
+
sessionId: string;
|
|
88
|
+
agentId?: string;
|
|
89
|
+
};
|
|
76
90
|
}
|
|
77
|
-
/** 摘要正文包装:确保带 [Conversation Summary] 标记,便于 extract / 调试 */
|
|
78
|
-
declare function wrapContextSummary(text: string): string;
|
|
79
|
-
/** 供调用方/测试引用 */
|
|
80
|
-
export { wrapContextSummary };
|
|
81
91
|
export declare class DefaultContextEngine implements ContextEngine {
|
|
82
92
|
readonly info: ContextEngineInfo;
|
|
83
93
|
private config;
|
|
84
|
-
private router;
|
|
85
94
|
private states;
|
|
95
|
+
/** 转换记录账本缓存(每 (sessionId, agentId) 加载一次;append 同步进缓存) */
|
|
96
|
+
private ledgers;
|
|
97
|
+
/** 孤儿记录告警去重(键:session|agent|seq[|partial]) */
|
|
98
|
+
private orphanWarned;
|
|
99
|
+
/** P1-a 校准台账:ratio 按 model 分键,observe/calibrate 唯一出入口 */
|
|
100
|
+
private sizeLedger;
|
|
101
|
+
/**
|
|
102
|
+
* 最近一次会话请求的工具面前缀指纹(按 sessionId)。
|
|
103
|
+
*
|
|
104
|
+
* 只为可观测:摘要请求的前缀必须与它同形才能命中缓存。tools 在一个会话生命周期内
|
|
105
|
+
* 近乎不变,一旦摘要请求的 toolsHash 与之不同,就是真问题(2026-11-12 事故形状)。
|
|
106
|
+
* 只告警不断言——摘要前缀与「当前」请求本就可能不同(折叠阶梯)。
|
|
107
|
+
*/
|
|
108
|
+
/** 最近一次工具面哈希(按数组引用缓存,避免每 step 重复 sha1) */
|
|
109
|
+
private lastToolsHash?;
|
|
110
|
+
/**
|
|
111
|
+
* 最近一次**会话请求**的前缀指纹(tools + system + messages)
|
|
112
|
+
*
|
|
113
|
+
* 用途:摘要请求发出前比对——任一项不同,前缀缓存必 miss。
|
|
114
|
+
* 2026-11-13 事故正是 tools/system 相同而 messages 半区(老化形态)分叉,
|
|
115
|
+
* 旧实现只存 tools 哈希,看不见这类差异。
|
|
116
|
+
*/
|
|
117
|
+
private lastRequestPrefix;
|
|
86
118
|
constructor(config?: DefaultContextEngineConfig);
|
|
87
119
|
/**
|
|
88
120
|
* 组装上下文
|
|
89
121
|
*
|
|
90
|
-
*
|
|
122
|
+
* 核心方法。装配 = 原文 + 有效转换记录的确定性 fold;需要收缩时由
|
|
123
|
+
* proactive/overflow 路径产出新记录(记录先落盘、后发视图)。
|
|
91
124
|
*
|
|
92
|
-
*
|
|
125
|
+
* 路由(Q2 B′ 后两路由):
|
|
93
126
|
* - fits: 不需要压缩
|
|
94
|
-
* -
|
|
95
|
-
* - compact_only: 只做 LLM 摘要
|
|
96
|
-
* - compact_then_truncate: 先 LLM 摘要,再截断
|
|
127
|
+
* - compact: 走 compact 能力(有 summarize 出真摘要;无 summarize / 失败走机械降级阶梯)
|
|
97
128
|
*/
|
|
98
129
|
assemble(params: AssembleParams): Promise<AssembleResult>;
|
|
99
|
-
/** 从引擎内存态导出可持久化快照 */
|
|
100
|
-
private buildCompactSnapshot;
|
|
101
130
|
/**
|
|
102
|
-
*
|
|
131
|
+
* 加载(并缓存)(sessionId, agentId) 的转换记录账本;账本为空且有旧压缩快照时
|
|
132
|
+
* 一次性迁移(幂等:账本非空即跳过)。
|
|
103
133
|
*
|
|
104
|
-
*
|
|
105
|
-
*
|
|
106
|
-
*
|
|
107
|
-
*
|
|
108
|
-
*
|
|
109
|
-
* - **压缩视图粘滞**:一旦建立过压缩态(previousSummary 或 lastProactiveMessageCount),
|
|
110
|
-
* 后续装配优先复用 head+摘要/机械中间+tail,不因估算回落或 ratio=0 而打回全量
|
|
111
|
-
* (全量请求会 bust 前缀缓存,且等于撤销已完成的压缩)。
|
|
112
|
-
* - **proactiveCompactRatio=0**:禁止**发起新的**路径 A 压缩(不只禁 LLM);
|
|
113
|
-
* **不**丢弃已有压缩视图。
|
|
114
|
-
* - 策略:
|
|
115
|
-
* - ratio=0:无压缩态原样返回;有压缩态仅粘滞重建
|
|
116
|
-
* - 未超线且无压缩态:原样返回
|
|
117
|
-
* - 超线且需要新一轮压缩(上次压缩后新增消息够多):LLM 压缩中间段并产出语义摘要
|
|
118
|
-
* - 已有压缩态且增量小或冷却中或禁新 LLM:零 LLM 重建视图
|
|
134
|
+
* @param sessionId - 会话 id
|
|
135
|
+
* @param agentId - agent id
|
|
136
|
+
* @param messages - 全量原始消息(迁移锚点需要)
|
|
137
|
+
* @param loadLegacy - 旧 ContextCompactSnapshot 读口(迁移输入;缺省不迁移)
|
|
138
|
+
* @returns 账本
|
|
119
139
|
*/
|
|
120
|
-
private
|
|
140
|
+
private loadLedger;
|
|
121
141
|
/**
|
|
122
|
-
*
|
|
123
|
-
* 外层 head/tail 由 assemble 重组拼接,此处不得重复携带。
|
|
142
|
+
* 摘要调用预算(P3):外部 abort 与单次摘要超时合并成一个 signal。
|
|
124
143
|
*
|
|
125
|
-
*
|
|
126
|
-
*
|
|
127
|
-
*
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
/**
|
|
131
|
-
* 从压缩结果中提取语义摘要正文(contextSummary 标记或 [Conversation Summary] 前缀)。
|
|
132
|
-
* 机械降级的占位说明([Context truncated / [Context compressed / [Structural compact])
|
|
133
|
-
* 不算语义摘要:把它们当摘要存入 previousSummary 会污染增量合并输入,
|
|
134
|
-
* 并让复用分支拿到假摘要、掩盖「从未真正摘要」的事实。
|
|
144
|
+
* 为什么必须合并:run 中止只到 convertToLlm 边界,摘要调用在 `provider.chat` 内部
|
|
145
|
+
* 等待 HTTP;没有 signal 时 abort 只能等 provider 自己超时(实测 900s,UI 全程假死)。
|
|
146
|
+
*
|
|
147
|
+
* @param external - 上游(run)abort 信号
|
|
148
|
+
* @returns 合并信号与「是否超时」判定(超时归失败降级,外部中止归取消不写记录)
|
|
135
149
|
*/
|
|
136
|
-
private
|
|
150
|
+
private createSummarizeSignal;
|
|
137
151
|
/**
|
|
138
|
-
*
|
|
139
|
-
* 只看首行而非全文 includes——真实摘要引用这些字符串(如记录「曾发生截断」)不得被误杀。
|
|
152
|
+
* 请求口径读数:**fold 视图 + 老化** = 实际发给 LLM 的 messages 部分。
|
|
140
153
|
*
|
|
141
|
-
*
|
|
142
|
-
*
|
|
154
|
+
* 压缩决策(触发线、增长门、记录 meta)只许用这个口径:量原文会让「已压缩但视图很小」
|
|
155
|
+
* 的会话被反复判超线(2026-11-07 事故:视图 118k、原文 621k → 每次增长 25% 必然重压)。
|
|
156
|
+
*
|
|
157
|
+
* @param folded - 当前 fold 结果
|
|
158
|
+
* @param agingPlan - 老化计划(基于完整历史,按消息身份匹配)
|
|
159
|
+
* @param estimator - 校准后的估算器
|
|
160
|
+
* @returns messages 口径 token 估算
|
|
143
161
|
*/
|
|
144
|
-
private
|
|
162
|
+
private measureRequestViewTokens;
|
|
145
163
|
/**
|
|
146
|
-
*
|
|
164
|
+
* 报告尺(rawRequestViewTokens,M3 统一):**请求形状 messages(fold+老化)+ system + tools**
|
|
165
|
+
* 的未校准全请求估算。manual/proactive/overflow 的 compact 对 tokensBefore/After 与
|
|
166
|
+
* contextSize 快照同式(一处公式,禁止手抄分叉——旧 auto 口径 messages-only 缺
|
|
167
|
+
* system/tools,报出来比顶栏永远少一截,M3)。
|
|
147
168
|
*
|
|
148
|
-
* @param
|
|
149
|
-
* @
|
|
169
|
+
* @param view - fold 视图(未老化原文形态)
|
|
170
|
+
* @param systemPrompt - 同形 system(缺省按空串)
|
|
171
|
+
* @param tools - 请求工具面(缺省按空)
|
|
172
|
+
* @param agingPlan - 老化计划(与真实请求同式)
|
|
173
|
+
* @param raw - 未校准估算器(报告尺单位,不乘 ratio)
|
|
174
|
+
* @returns 全请求口径 token 估算
|
|
150
175
|
*/
|
|
151
|
-
private
|
|
176
|
+
private reportRequestTokens;
|
|
152
177
|
/**
|
|
153
|
-
*
|
|
178
|
+
* 摘要请求的回声比对源(P2):前缀去掉既有压缩占位。
|
|
154
179
|
*
|
|
155
|
-
*
|
|
156
|
-
*
|
|
180
|
+
* 前缀已是 fold 视图时,占位正文就是「上一份交接书」——模型续写/复用它是正常迭代,
|
|
181
|
+
* 不是复读原文;若把占位计入比对源,只要新增内容不多就会误判 verbatim_echo 并降级。
|
|
157
182
|
*
|
|
158
|
-
* @param
|
|
159
|
-
* @param
|
|
160
|
-
* @param
|
|
161
|
-
* @returns
|
|
183
|
+
* @param view - 摘要前缀所用的消息(fold 视图)
|
|
184
|
+
* @param systemPrompt - 同形 system
|
|
185
|
+
* @param agingPlan - 老化计划(与真实请求同式)
|
|
186
|
+
* @returns 换行拼接的文本投影
|
|
162
187
|
*/
|
|
163
|
-
private
|
|
188
|
+
private buildEchoSource;
|
|
189
|
+
/** 重 fold(append 后调用);孤儿告警去重键 = session|agent|seq(F9:跨会话不串键) */
|
|
190
|
+
private foldView;
|
|
164
191
|
/**
|
|
165
|
-
*
|
|
166
|
-
*
|
|
167
|
-
*
|
|
192
|
+
* 显式撤销一条转换记录(回填的唯一通道;记录模型拍板:「回填只在显式撤销时」)。
|
|
193
|
+
*
|
|
194
|
+
* 撤销是 append-only 附加行,永久生效面翻转为 revoked;被覆盖的原文在下一次
|
|
195
|
+
* 装配回到视图。宿主(UI/工具)据此实现「撤销压缩」。
|
|
196
|
+
*
|
|
197
|
+
* @param sessionId - 会话 id
|
|
198
|
+
* @param agentId - agent id
|
|
199
|
+
* @param seq - 记录 seq(账本 load 可得)
|
|
200
|
+
* @returns void
|
|
168
201
|
*/
|
|
169
|
-
|
|
202
|
+
revokeTransformRecord(sessionId: string, agentId: string | undefined, seq: number): Promise<void>;
|
|
203
|
+
/** 当前有效语义摘要正文(最新 summary 型记录的文本;机械占位永不冒充) */
|
|
204
|
+
private deriveSummary;
|
|
170
205
|
/**
|
|
171
|
-
*
|
|
206
|
+
* previousSummary 的覆盖终点(下标,不含)——与 deriveSummary 同一选择口径(最新、
|
|
207
|
+
* type==='summary'、有正文)的记录,返回其**解析后**覆盖端(M-4/C1,评审 del-e1ee43ef)。
|
|
208
|
+
*
|
|
209
|
+
* 摘要素材起点必须与 previousSummary 同源:derivedCoverEnd 含 degrade 多 run 的最大覆盖
|
|
210
|
+
* 端 E(E > S 是常态),以 E 为起点会把 [S, E)「既不在旧摘要、也不在新素材」的原文排除,
|
|
211
|
+
* 而新记录 covers 吞掉 [headEnd, tailStart) 全区间 → 静默丢数据。返回 undefined = 覆盖端
|
|
212
|
+
* 解析不出(如零覆盖 legacy 记录)→ 素材回退全区间(宁可胖不丢,方向安全)。
|
|
172
213
|
*/
|
|
173
|
-
private
|
|
214
|
+
private deriveSummaryCoverEnd;
|
|
215
|
+
/** 有效记录覆盖终点(下标,不含)——传输口径 coveredMessageCount 用 */
|
|
216
|
+
private derivedCoverEnd;
|
|
217
|
+
/** 重启恢复:增长门/冷却基数从账本 meta 初始化(仅内存态缺失时;F2 对称) */
|
|
218
|
+
private restoreGatesFromLedger;
|
|
174
219
|
/**
|
|
175
|
-
*
|
|
220
|
+
* 压缩产物 → 持久转换记录(三条压缩路径的唯一翻译口)。
|
|
176
221
|
*
|
|
177
|
-
*
|
|
178
|
-
*
|
|
179
|
-
*
|
|
180
|
-
*
|
|
181
|
-
* @
|
|
222
|
+
* 翻译 = 对照压缩输入与产物视图做身份差分:产物里消失的原文/占位所代表的原始
|
|
223
|
+
* 区间即记录覆盖区间(contiguous 合并)。fresh 且为真摘要 → summary 型;否则
|
|
224
|
+
* degrade 型(机械占位如实分类,伪摘要永不冒充 summary)。
|
|
225
|
+
*
|
|
226
|
+
* @param params - 输入集合、产物视图、fresh 判定等
|
|
227
|
+
* @returns 生成的记录(无丢弃时为 undefined,不产记录)
|
|
182
228
|
*/
|
|
183
|
-
private
|
|
229
|
+
private appendRecordFromProduct;
|
|
184
230
|
/**
|
|
185
|
-
*
|
|
186
|
-
*
|
|
231
|
+
* 主动压缩(路径 A):消息 token 超过触发线时,在硬溢出前收缩
|
|
232
|
+
*
|
|
233
|
+
* 触发线取两条线的 min:
|
|
234
|
+
* - **目标线** targetTokens × compactFallbackRatio——与窗口解耦,防长会话失忆
|
|
235
|
+
* - **窗口比例线** messagesBudget × proactiveCompactRatio——防小窗口到顶未触发
|
|
236
|
+
*
|
|
237
|
+
* 语义(记录模型):
|
|
238
|
+
* - 装配 = fold(原文 + 有效记录);已有压缩态天然粘滞,不因估算回落打回全量
|
|
239
|
+
* - proactiveCompactRatio=0:禁止发起**新的**压缩;已有记录照常生效
|
|
240
|
+
* - 超线且需要新一轮压缩(增长门 + 冷却):LLM 压缩中间段 → 产出 summary 记录
|
|
241
|
+
* - 其余情形:零 LLM,直接返回 fold 视图
|
|
187
242
|
*/
|
|
188
|
-
private
|
|
243
|
+
private applyProactiveCompact;
|
|
189
244
|
/**
|
|
190
245
|
* 结构压缩:头尾保护 + 中间段摘要(不依赖 contextWindow)
|
|
191
|
-
* 算法委托 capabilities/compact
|
|
246
|
+
* 算法委托 capabilities/compact;本引擎把产物翻译成转换记录。
|
|
192
247
|
*/
|
|
193
248
|
private structuralCompact;
|
|
194
249
|
/**
|
|
195
|
-
*
|
|
250
|
+
* 结构压缩入口(手动)— 可无 contextWindow
|
|
196
251
|
*
|
|
197
252
|
* @param input - sessionId + 全量 messages + 可选 summarize
|
|
198
253
|
* @returns 压缩结果
|
|
@@ -204,8 +259,7 @@ export declare class DefaultContextEngine implements ContextEngine {
|
|
|
204
259
|
summarize?: SummarizeFunction;
|
|
205
260
|
compactTargetTokens?: number;
|
|
206
261
|
/** 缓存前缀:会话同形 system+history */
|
|
207
|
-
|
|
208
|
-
/** 同形前缀原料:与会话请求同源的 systemPrompt(tools 文档随 system 文本);无 llmPrefix 时引擎内建 */
|
|
262
|
+
/** 同形前缀原料:与会话请求同源的 systemPrompt(工具面随它同批产出,不可单独传) */
|
|
209
263
|
systemPrompt?: string;
|
|
210
264
|
tools?: LLMToolDefinition[];
|
|
211
265
|
/** task 快照:交接式摘要指令尾部注入 */
|
|
@@ -215,35 +269,141 @@ export declare class DefaultContextEngine implements ContextEngine {
|
|
|
215
269
|
maxOutputTokens?: number;
|
|
216
270
|
/** F22:cache-miss 旁路事件出口(manual 路可观测性,与 proactive/overflow 对称) */
|
|
217
271
|
emit?: ContextEmitFn;
|
|
218
|
-
|
|
272
|
+
/** 旧压缩快照读口(迁移输入;缺省不迁移) */
|
|
273
|
+
loadCompactState?: (sessionId: string) => Promise<ContextCompactSnapshot | undefined> | ContextCompactSnapshot | undefined;
|
|
274
|
+
/**
|
|
275
|
+
* 老化策略:摘要前缀的 messages 半区必须与会话请求逐字节同源。
|
|
276
|
+
*
|
|
277
|
+
* 缺省时摘要视图退回默认机械指针,而会话请求用 per-tool ager →
|
|
278
|
+
* 同一条工具结果两种形态,前缀从第一条起分叉、缓存 0 命中
|
|
279
|
+
* (2026-11-13 生产实测:678 个共同结果中 515 个(76%)形态不同)。
|
|
280
|
+
*/
|
|
281
|
+
toolAgers?: ReadonlyMap<string, ToolResultAger>;
|
|
282
|
+
toolArgAgers?: ReadonlySet<string>;
|
|
283
|
+
/** run 中止信号(F1):透传至摘要/压缩调用,run abort 即取消(不写记录) */
|
|
284
|
+
signal?: AbortSignal;
|
|
285
|
+
}): Promise<CompactOutcome>;
|
|
286
|
+
/**
|
|
287
|
+
* 冻结请求级配对槽(callId 同源配对的唯一写入口,2026-11-08)。
|
|
288
|
+
*
|
|
289
|
+
* 每次冻结携带单调 seq(pairSeq)作请求身份;覆盖未消费的旧槽即作废并告警——
|
|
290
|
+
* 「上一请求 usage 未到就再次装配」正是错位对(0.085/0.258 家族)的嫌疑通道,
|
|
291
|
+
* 静默覆盖会让旧估算去配陌生 usage。覆盖语义=只认最新发送(串行下与先到先得等价,
|
|
292
|
+
* 非串行下更安全:旧请求可能已被重试/替代)。
|
|
293
|
+
*
|
|
294
|
+
* @param stateKey 会话状态键
|
|
295
|
+
* @param rawEstimatedTokens 本请求「system+tools+视图」口径未校准估算
|
|
296
|
+
* @param modelKey 校准分键
|
|
297
|
+
*/
|
|
298
|
+
/**
|
|
299
|
+
* 校准分键(取舍③落地 2026-11-08):ratio/锚按 (session, modelKey) 复合键隔离——
|
|
300
|
+
* 同 modelKey 的多 session 内容形态各异,混学 EMA 互相毒化(生产实证:跨形态比率
|
|
301
|
+
* 0.185 vs 1.263 共存)。stateKey 即 session 维度(E4 compact key component)。
|
|
302
|
+
*/
|
|
303
|
+
private calKey;
|
|
304
|
+
private freezeUsagePair;
|
|
219
305
|
/**
|
|
220
306
|
* 每轮结束后更新状态
|
|
221
307
|
*
|
|
222
|
-
* 使用 LLM 返回的真实 usage 校准 token
|
|
223
|
-
*
|
|
224
|
-
*
|
|
225
|
-
*
|
|
308
|
+
* 使用 LLM 返回的真实 usage 校准 token 估算:把(实测 prompt, 请求口径估算)样本
|
|
309
|
+
* 送入 ContextSizeLedger(P1-a,ratio 按 model 分键)。
|
|
310
|
+
*
|
|
311
|
+
* 配对纪律(2026-11-07):分母只能是**本请求** assemble 冻结的 pendingUsagePair,
|
|
312
|
+
* 消费即清;缺对丢样,绝不拿旧估算/旧实测凑对(错位对是毒 ratio 样本与毒锚的源头)。
|
|
226
313
|
*/
|
|
227
|
-
|
|
314
|
+
afterStep(params: AfterStepParams): Promise<void>;
|
|
228
315
|
/**
|
|
229
316
|
* 存储消息(可选)
|
|
230
317
|
*
|
|
231
318
|
* DefaultContextEngine 不需要单独存储消息,
|
|
232
319
|
* 因为消息历史由调用方管理。
|
|
233
320
|
*/
|
|
321
|
+
/**
|
|
322
|
+
* 校准状态快照(持久化用):per-key 样本计数 + 锚(含 stateKey 归属)。
|
|
323
|
+
* 与 importCalibration 配对——重启后恢复,消除校准冷启动过渡(跑几轮才准)。
|
|
324
|
+
*/
|
|
325
|
+
exportCalibration(): {
|
|
326
|
+
samples: Record<string, {
|
|
327
|
+
samples: number;
|
|
328
|
+
}>;
|
|
329
|
+
anchors: Record<string, {
|
|
330
|
+
actual: number;
|
|
331
|
+
raw: number;
|
|
332
|
+
modelKey: string;
|
|
333
|
+
}>;
|
|
334
|
+
};
|
|
335
|
+
/**
|
|
336
|
+
* 校准状态恢复(restore 用):锚/样本计数回填——restore 后第一轮即 anchored/calibrated。
|
|
337
|
+
*/
|
|
338
|
+
importCalibration(data: {
|
|
339
|
+
samples?: Record<string, {
|
|
340
|
+
samples: number;
|
|
341
|
+
}>;
|
|
342
|
+
anchors?: Record<string, {
|
|
343
|
+
actual: number;
|
|
344
|
+
raw: number;
|
|
345
|
+
modelKey: string;
|
|
346
|
+
}>;
|
|
347
|
+
}): void;
|
|
234
348
|
ingest(_params: IngestParams): Promise<void>;
|
|
235
349
|
/**
|
|
236
|
-
*
|
|
350
|
+
* 工具面指纹(按数组引用记忆,NIT-9)。
|
|
351
|
+
*
|
|
352
|
+
* sha1(JSON.stringify(tools)) 在每个 LLM step 的 assemble 出口都会跑一次;工具面
|
|
353
|
+
* 在一步之内几乎总是不变的同一实例,按引用复用可把常态成本降到一次比较。
|
|
354
|
+
*
|
|
355
|
+
* @param tools - 工具面
|
|
356
|
+
* @returns 哈希(16 位)
|
|
357
|
+
*/
|
|
358
|
+
private toolsHashOf;
|
|
359
|
+
/**
|
|
360
|
+
* 摘要前缀工具面校验(可观测护栏,2026-11-12)。
|
|
237
361
|
*
|
|
238
|
-
*
|
|
362
|
+
* tools 在会话生命周期内近乎不变;摘要请求的 toolsHash 与最近一次会话请求不同,
|
|
363
|
+
* 就说明前缀从第一字节断开,缓存必然 miss。这里只告警不断言——摘要前缀与「当前」
|
|
364
|
+
* 请求本就可能不同(折叠阶梯是逐轮追加的),但工具面不该变。
|
|
365
|
+
*
|
|
366
|
+
* @param stateKey - 引擎状态键(sessionId + agentId,与 compactStateKey 同源)
|
|
367
|
+
* @param tools - 摘要请求即将使用的工具面
|
|
368
|
+
* @returns 无(异常情况打印告警)
|
|
369
|
+
*/
|
|
370
|
+
/**
|
|
371
|
+
* 记录「最近一次会话请求」的前缀基线(唯一实现)
|
|
372
|
+
*
|
|
373
|
+
* 三处调用点(两个 assemble 出口 + buildRequestView 的默认分支)都经此,
|
|
374
|
+
* 禁止各自手写 set 体:2026-11-13 一轮里同一段 set 体曾出现三份,
|
|
375
|
+
* 正是「改一边忘另一边」的形状(CON E8)。
|
|
376
|
+
*
|
|
377
|
+
* 摘要路径**不得**调用:它会把自己的指纹写成基线,护栏随即永远一致。
|
|
378
|
+
*
|
|
379
|
+
* @param stateKey - 引擎状态键(与 compactStateKey 同源)
|
|
380
|
+
* @param view - 会话请求前缀(messages 必须已是老化后的 LLM 形态)
|
|
381
|
+
*/
|
|
382
|
+
private recordSessionRequest;
|
|
383
|
+
private checkSummaryToolFace;
|
|
384
|
+
private checkSummaryPrefix;
|
|
385
|
+
/**
|
|
386
|
+
* 构建**请求视图**:前缀的 messages 与 tools 同批产出(缓存前缀的原子单位)。
|
|
387
|
+
*
|
|
388
|
+
* 会话请求与摘要请求(proactive / manual)都经此产出前缀。这样"改装配逻辑忘了一边"
|
|
389
|
+
* 在结构上不可能发生:没有哪条路径能只拿到 messages 或只拿到 tools。
|
|
390
|
+
*
|
|
391
|
+
* @param input.messages - 已折叠的视图(领域消息)
|
|
392
|
+
* @param input.systemPrompt - 会话托管 system 文本(逐字取自上一轮请求,不重建)
|
|
393
|
+
* @param input.tools - 已解析的工具面(调用方与 run 同源解析,禁自行拼装)
|
|
394
|
+
* @param input.aging - 老化计划(上游决策;此处不重新推导,避免静默推进)
|
|
395
|
+
* @returns 请求视图
|
|
239
396
|
*/
|
|
397
|
+
private buildRequestView;
|
|
240
398
|
/**
|
|
241
|
-
*
|
|
399
|
+
* 构建 LLM 消息格式(前缀的 messages 半区)
|
|
242
400
|
*
|
|
243
|
-
*
|
|
244
|
-
*
|
|
401
|
+
* 注意:这里刻意**不接受 tools**。缓存前缀的原子产物是 `RequestView`
|
|
402
|
+
* (messages + tools 同批产出,见 core `RequestView`);一个收了 tools 却不用的参数
|
|
403
|
+
* 会让读者误以为「视图=system+messages+tools」,2026-11-12 的前缀缓存事故正是这样
|
|
404
|
+
* 发生的(摘要请求看着"同形",实际整包 tools 缺失)。
|
|
405
|
+
* 需要成对产出时请用 {@link buildRequestView}。
|
|
245
406
|
*/
|
|
246
|
-
private calibrateTokens;
|
|
247
407
|
private buildLlmMessages;
|
|
248
408
|
/**
|
|
249
409
|
* 转换单条消息为 LLM 格式
|
|
@@ -277,3 +437,13 @@ export declare class DefaultContextEngine implements ContextEngine {
|
|
|
277
437
|
* @returns 是否 turn 内
|
|
278
438
|
*/
|
|
279
439
|
export declare function isMidTurn(messages: Message[]): boolean;
|
|
440
|
+
/**
|
|
441
|
+
* 最后一条「真实 user 消息」的下标(turn 起点标识)。
|
|
442
|
+
*
|
|
443
|
+
* 「真实 user」= 无 agentId 归因,且非引擎载体(含 `engineHint` reliability 注入)。
|
|
444
|
+
* 历史 append-only,该下标在同 turn 内稳定,可作 turn key(overflow 每 turn 限一次用)。
|
|
445
|
+
*
|
|
446
|
+
* @param messages - 全量消息
|
|
447
|
+
* @returns 下标;无真实 user 时返回 -1
|
|
448
|
+
*/
|
|
449
|
+
export declare function lastGenuineUserIndex(messages: Message[]): number;
|