@octopi-agent/engine 0.97.15 → 0.102.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/config-schema/agent.d.ts +37 -5
- package/dist/config-schema/agent.js +24 -4
- package/dist/config-schema/context.d.ts +6 -36
- package/dist/config-schema/context.js +4 -28
- package/dist/config-schema/engine.d.ts +61 -160
- package/dist/config-schema/engine.js +1 -5
- package/dist/config-schema/governance.d.ts +10 -1
- package/dist/config-schema/governance.js +38 -1
- package/dist/config-schema/models.d.ts +2 -8
- package/dist/config-schema/models.js +0 -2
- package/dist/config-schema/run.d.ts +2 -2
- package/dist/config-schema/run.js +2 -2
- package/dist/config-schema/shared.d.ts +0 -3
- package/dist/config-schema/shared.js +0 -2
- package/dist/config-schema/substrate.d.ts +14 -88
- package/dist/config-schema/substrate.js +22 -107
- package/dist/config.d.ts +45 -113
- package/dist/config.js +8 -2
- package/dist/harness/activation/dispatcher.js +7 -0
- package/dist/harness/activation/inbox.d.ts +3 -3
- package/dist/harness/activation/inbox.js +3 -3
- package/dist/harness/activation/runtime.js +13 -5
- package/dist/harness/activation/types.d.ts +2 -2
- package/dist/harness/agent/builder.d.ts +34 -2
- package/dist/harness/agent/builder.js +189 -58
- package/dist/harness/agent/config-bridge.js +9 -2
- package/dist/harness/agent/config-integrity.d.ts +66 -0
- package/dist/harness/agent/config-integrity.js +108 -2
- package/dist/harness/agent/wire-agent-builder.d.ts +11 -3
- package/dist/harness/agent/wire-agent-builder.js +31 -7
- package/dist/harness/capabilities/document/factory.d.ts +5 -0
- package/dist/harness/capabilities/document/factory.js +1 -0
- 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/index.d.ts +2 -2
- package/dist/harness/collaboration/autonomous-subsystem/index.js +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/loader.js +4 -1
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +21 -4
- 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/completion-guard.d.ts +40 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/completion-guard.js +59 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +2 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -0
- package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +12 -3
- package/dist/harness/collaboration/delegation/child-run.d.ts +1 -1
- package/dist/harness/collaboration/delegation/child-run.js +4 -4
- 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/service.d.ts +2 -0
- package/dist/harness/collaboration/delegation/service.js +2 -1
- package/dist/harness/collaboration/delegation/store.d.ts +2 -0
- package/dist/harness/collaboration/delegation/store.js +2 -1
- package/dist/harness/collaboration/delegation/types.d.ts +23 -2
- package/dist/harness/collaboration/delegation/types.js +22 -0
- package/dist/harness/collaboration/delegation/wiring.js +11 -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 +0 -6
- package/dist/harness/context/capabilities/compact/engine.js +169 -121
- 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 +5 -1
- package/dist/harness/context/capabilities/compact/index.js +4 -0
- 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 +76 -11
- 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/port.js +0 -1
- package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
- package/dist/harness/context/capabilities/summary/resolver.js +4 -9
- package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
- package/dist/harness/context/capabilities/summary/types.d.ts +4 -7
- package/dist/harness/context/context-size-ledger.d.ts +143 -0
- package/dist/harness/context/context-size-ledger.js +236 -0
- package/dist/harness/context/default-context-engine.d.ts +195 -119
- package/dist/harness/context/default-context-engine.js +1241 -743
- package/dist/harness/context/index.d.ts +2 -2
- package/dist/harness/context/index.js +1 -1
- package/dist/harness/context/layer-types.d.ts +15 -0
- package/dist/harness/context/layer-types.js +14 -1
- package/dist/harness/context/layers.d.ts +16 -19
- package/dist/harness/context/layers.js +42 -14
- package/dist/harness/context/message-selector.d.ts +10 -8
- package/dist/harness/context/message-selector.js +49 -27
- package/dist/harness/context/summarize.d.ts +3 -3
- package/dist/harness/context/summarize.js +11 -4
- package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
- package/dist/harness/context/system-prompt-assembler.js +3 -1
- 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 +6 -1
- package/dist/harness/context/tool-result-aging.js +16 -5
- 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 +127 -117
- package/dist/harness/extension/execution-environment/effect-policy.d.ts +24 -2
- package/dist/harness/extension/execution-environment/effect-policy.js +30 -0
- package/dist/harness/extension/execution-environment/ops-audit.d.ts +7 -3
- package/dist/harness/extension/execution-environment/ops-audit.js +11 -12
- 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/undo-log.d.ts +6 -2
- package/dist/harness/extension/execution-environment/undo-log.js +31 -10
- package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +1 -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/plugins/api.d.ts +83 -249
- package/dist/harness/extension/plugin-ecosystem/plugins/api.js +88 -214
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +43 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +61 -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 +50 -117
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +316 -285
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +23 -490
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +85 -353
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +41 -223
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +138 -19
- package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +15 -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/builtin.js +17 -24
- package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -8
- package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +3 -9
- package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +3 -6
- package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +9 -5
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +9 -130
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +122 -14
- package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +4 -13
- package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +25 -11
- package/dist/harness/extension/plugin-ecosystem/tools/platform.js +168 -62
- 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 +11 -2
- 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/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/security/capability-enforcer.js +1 -2
- package/dist/harness/governance/security/default-risk-policy.d.ts +1 -0
- package/dist/harness/governance/security/default-risk-policy.js +1 -0
- package/dist/harness/governance/security/default-security-guard.js +9 -0
- package/dist/harness/governance/security/index.d.ts +1 -0
- package/dist/harness/governance/security/index.js +2 -0
- package/dist/harness/governance/security/risk-evaluator.js +13 -0
- package/dist/harness/governance/security/risk-types.d.ts +12 -0
- package/dist/harness/governance/security/shell-parser-fallback.d.ts +29 -0
- package/dist/harness/governance/security/shell-parser-fallback.js +410 -0
- package/dist/harness/governance/security/shell-parser-shared.d.ts +83 -0
- package/dist/harness/governance/security/shell-parser-shared.js +188 -0
- package/dist/harness/governance/security/shell-parser-treesitter.d.ts +52 -0
- package/dist/harness/governance/security/shell-parser-treesitter.js +370 -0
- package/dist/harness/governance/security/shell-parser.d.ts +23 -10
- package/dist/harness/governance/security/shell-parser.js +37 -496
- package/dist/harness/governance/security/vendor/README.md +24 -0
- package/dist/harness/governance/security/vendor/tree-sitter-bash.LICENSE.txt +21 -0
- package/dist/harness/governance/security/vendor/tree-sitter-bash.wasm +0 -0
- package/dist/harness/index.d.ts +12 -12
- package/dist/harness/index.js +7 -7
- package/dist/harness/knowledge/boot-config.d.ts +55 -0
- package/dist/harness/knowledge/boot-config.js +50 -0
- package/dist/harness/knowledge/catalog-types.d.ts +2 -0
- package/dist/harness/knowledge/client.d.ts +24 -2
- package/dist/harness/knowledge/client.js +19 -5
- package/dist/harness/knowledge/db.js +5 -0
- 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 +6 -0
- package/dist/harness/knowledge/grounding.js +3 -1
- package/dist/harness/knowledge/http-app.js +35 -4
- 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 +3 -0
- package/dist/harness/knowledge/purge.js +5 -2
- package/dist/harness/knowledge/query-service.d.ts +13 -2
- package/dist/harness/knowledge/query-service.js +4 -2
- package/dist/harness/knowledge/query-worker-client.d.ts +9 -1
- package/dist/harness/knowledge/query-worker-client.js +4 -2
- package/dist/harness/knowledge/query-worker.js +4 -2
- package/dist/harness/knowledge/read-http.js +5 -1
- package/dist/harness/knowledge/serve.d.ts +8 -7
- package/dist/harness/knowledge/serve.js +9 -0
- package/dist/harness/knowledge/source-store.js +26 -3
- package/dist/harness/knowledge/start-service-process.d.ts +15 -7
- package/dist/harness/knowledge/start-service-process.js +21 -9
- package/dist/harness/knowledge/types.d.ts +7 -0
- package/dist/harness/knowledge/writer-service.d.ts +37 -9
- package/dist/harness/knowledge/writer-service.js +120 -14
- package/dist/harness/knowledge/writer-worker-client.d.ts +10 -9
- package/dist/harness/knowledge/writer-worker-client.js +20 -2
- package/dist/harness/knowledge/writer-worker.js +9 -1
- package/dist/harness/memory/index.d.ts +6 -2
- package/dist/harness/memory/index.js +4 -1
- package/dist/harness/memory/memory-events.d.ts +25 -0
- package/dist/harness/memory/memory-events.js +38 -0
- package/dist/harness/memory/sqlite/agent-db.js +15 -0
- package/dist/harness/memory/sqlite/wisdom-store.d.ts +7 -2
- package/dist/harness/memory/sqlite/wisdom-store.js +86 -12
- package/dist/harness/memory/steward-policy.d.ts +3 -0
- package/dist/harness/memory/steward-policy.js +1 -1
- package/dist/harness/memory/types.d.ts +47 -7
- package/dist/harness/memory/wisdom-attribution.d.ts +136 -0
- package/dist/harness/memory/wisdom-attribution.js +287 -0
- package/dist/harness/memory/wisdom-events.d.ts +37 -0
- package/dist/harness/memory/wisdom-events.js +61 -0
- package/dist/harness/memory/wisdom-formation.d.ts +31 -1
- package/dist/harness/memory/wisdom-formation.js +130 -33
- package/dist/harness/memory/wisdom-gates.d.ts +14 -0
- package/dist/harness/memory/wisdom-gates.js +59 -19
- package/dist/harness/memory/wisdom.d.ts +7 -2
- package/dist/harness/memory/wisdom.js +49 -2
- package/dist/harness/observability/observer/hub.js +25 -15
- 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 +66 -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/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 +10 -4
- package/dist/harness/run/reliability/run-agent.js +137 -53
- 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-scope.d.ts +41 -4
- package/dist/harness/run/runner.d.ts +71 -31
- package/dist/harness/run/runner.js +368 -106
- 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/transform-store.d.ts +136 -0
- package/dist/harness/session/transform-store.js +302 -0
- package/dist/harness/session/types.d.ts +2 -2
- package/dist/harness/shared/events/agent-event-map.d.ts +46 -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/paths/glob.d.ts +52 -0
- package/dist/harness/shared/paths/glob.js +218 -0
- package/dist/harness/shared/paths/index.d.ts +84 -0
- package/dist/harness/shared/paths/index.js +179 -0
- package/dist/harness/shared/types/agent-definition.d.ts +1 -2
- package/dist/index.d.ts +14 -17
- package/dist/index.js +7 -9
- 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.js +14 -1
- package/dist/integration/providers/openai.js +7 -1
- package/dist/integration/providers/usage.d.ts +1 -1
- package/dist/integration/providers/wire-dump.d.ts +1 -1
- package/dist/integration/storage/archive-manager.d.ts +6 -0
- package/dist/integration/storage/archive-manager.js +10 -0
- package/dist/integration/storage/jsonl.d.ts +1 -1
- package/dist/integration/storage/jsonl.js +18 -16
- package/dist/subsystems/cognition-steward/conceptualize/config.yaml +4 -2
- package/dist/subsystems/cognition-steward/conceptualize/handler.js +12 -20
- package/dist/subsystems/memory-steward/backfill/config.yaml +4 -2
- package/dist/subsystems/memory-steward/backfill/handler.js +44 -52
- package/dist/subsystems/wisdom-steward/attribute/SUBSYSTEM.md +24 -0
- package/dist/subsystems/wisdom-steward/attribute/config.yaml +60 -0
- package/dist/subsystems/wisdom-steward/attribute/handler.d.ts +23 -0
- package/dist/subsystems/wisdom-steward/attribute/handler.js +167 -0
- package/dist/subsystems/wisdom-steward/evaluate/handler.js +3 -1
- package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
- package/dist/subsystems/wisdom-steward/formation/config.yaml +13 -5
- package/dist/subsystems/wisdom-steward/formation/handler.js +39 -23
- package/dist/subsystems/wisdom-steward/govern/config.yaml +1 -1
- package/dist/subsystems/wisdom-steward/govern/handler.js +4 -0
- package/package.json +16 -14
- 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
|
@@ -0,0 +1,236 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ContextSizeLedger — 校准后上下文体量台账(P1-a,arch/context-size-accounting.md §4.3)
|
|
3
|
+
*
|
|
4
|
+
* 职责:把 `promptTokensActual`(provider 实测)学到的比率作用到**所有决策读数**(R1:
|
|
5
|
+
* 决策只许用被实测校准过的 viewTokens)。取代旧「只乘展示值 + 逐 session ratio +
|
|
6
|
+
* 静默 [0.5,2.0] 夹取」的三处缺陷:
|
|
7
|
+
* 1. 决策点(smart-router / message-selector / compact / budget-allocator)未受益;
|
|
8
|
+
* 2. clamp [0.5,2.0] 掩盖严重低估(实测偏差 2.9× 被夹到 2.0);
|
|
9
|
+
* 3. 分母口径漂移(口径对齐后 lastEstimatedTokens 恒为「system+tools+视图」)。
|
|
10
|
+
*
|
|
11
|
+
* 设计要点(拍板):
|
|
12
|
+
* - ratio **按 model 分 key**(跨 session 共享统计,收敛快);
|
|
13
|
+
* - EMA 平滑 0.7 新 / 0.3 旧;
|
|
14
|
+
* - 夹取带 [0.25, 4.0] = 入账值域:超出即夹取(方向一致的越界样本可学习),越界**告警而非静默**;
|
|
15
|
+
* 注意偏离门相对「已学 ratio」判,r<1 时带内样本也可能出门——出门不等于越界;
|
|
16
|
+
* - 偏离门(arch §10.14):新样本偏离已学 ratio 超 RATIO_SAMPLE_MAX_DEVIATION 倍即**拒绝入账**
|
|
17
|
+
* (错配样本如「陈旧 usage × 当步估算」双向拉扯 ratio 震荡,见 2026-11-06 事故);
|
|
18
|
+
* - 逃逸重锚(评审 F1):连续 RATIO_ESCAPE_STREAK 个同向且内部一致的被拒样本 = regime shift
|
|
19
|
+
* 证据,以簇中心重锚——拒绝零状态变化会把真值永久锁在门外(毒化 bootstrap 后 50 个真样本
|
|
20
|
+
* 全拒的实测锁死);交替垃圾内部永不一致、永远进不来;
|
|
21
|
+
* - 告警按 (session, model, 事件类) 限频 1 条/小时(拒绝告警不被夹取告警吞掉);
|
|
22
|
+
* - 决策出口 decisionTokens(方案 B,arch §10.16):≥2 已入账样本且未降级才走 calibrate(R1);
|
|
23
|
+
* 否则实测锚定(actual × raw/anchor.raw)或裸 raw。
|
|
24
|
+
*
|
|
25
|
+
* 状态为进程内存(ratio 冷启动 1.0,2–3 个样本内收敛);不落盘。
|
|
26
|
+
*/
|
|
27
|
+
/** ratio 夹取边界(拍板:[0.25, 4.0]) */
|
|
28
|
+
export const RATIO_CLAMP_MIN = 0.25;
|
|
29
|
+
export const RATIO_CLAMP_MAX = 4.0;
|
|
30
|
+
/** 样本偏离门:新样本偏离已学 ratio 超该倍数(任一方向)即拒绝入账(arch §10.14) */
|
|
31
|
+
export const RATIO_SAMPLE_MAX_DEVIATION = 4.0;
|
|
32
|
+
/** 逃逸重锚:连续同向且内部一致的被拒簇达该长度即视为 regime shift(评审 F1) */
|
|
33
|
+
export const RATIO_ESCAPE_STREAK = 3;
|
|
34
|
+
/** 逃逸簇内部一致性:max/min ≤ 该值才算「同向一致」(交替垃圾永不一致) */
|
|
35
|
+
export const RATIO_ESCAPE_CONSISTENCY = 2.0;
|
|
36
|
+
/** 预测带:入账样本偏离已学 ratio 超该倍数 = 校准预测失准 → 降级(方案 B 门,arch §10.16) */
|
|
37
|
+
export const RATIO_PREDICTION_BAND = 1.5;
|
|
38
|
+
/** 越界告警限频:每 (session, model) 每小时 1 条 */
|
|
39
|
+
export const RATIO_WARN_INTERVAL_MS = 3_600_000;
|
|
40
|
+
const EMA_NEW_WEIGHT = 0.7;
|
|
41
|
+
/** 校准台账:observe(actual, view) 学 ratio;calibrate(viewTokens) 出校准读数 */
|
|
42
|
+
export class ContextSizeLedger {
|
|
43
|
+
warn;
|
|
44
|
+
ratioByModel = new Map();
|
|
45
|
+
samplesByModel = new Map();
|
|
46
|
+
rejectedByModel = new Map();
|
|
47
|
+
rejectStreaks = new Map();
|
|
48
|
+
degradedByModel = new Map();
|
|
49
|
+
lastWarnAt = new Map();
|
|
50
|
+
constructor(warn = (m) => console.warn(m)) {
|
|
51
|
+
this.warn = warn;
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* 记录一对实测/估算样本(分母 view 必须是「system+tools+视图」口径的**未校准**估算)。
|
|
55
|
+
*
|
|
56
|
+
* @param modelKey provider/model 标识(ratio 的分键)
|
|
57
|
+
* @param actual provider 实测 prompt tokens
|
|
58
|
+
* @param view 同一请求的未校准视图估算
|
|
59
|
+
* @param opts sessionId(告警限频键)/ now(测试注入时钟)
|
|
60
|
+
* @returns 裁决(调用方据其决定是否冻结实测锚——夹取/拒收/重锚样本一律不得作锚)
|
|
61
|
+
*/
|
|
62
|
+
observe(modelKey, actual, view, opts) {
|
|
63
|
+
if (!(actual > 0) || !(view > 0))
|
|
64
|
+
return 'ignored';
|
|
65
|
+
const raw = actual / view;
|
|
66
|
+
const prev = this.ratioByModel.get(modelKey) ?? 1.0;
|
|
67
|
+
const hasSamples = (this.samplesByModel.get(modelKey) ?? 0) > 0;
|
|
68
|
+
const outsideGate = hasSamples &&
|
|
69
|
+
(raw > prev * RATIO_SAMPLE_MAX_DEVIATION || raw < prev / RATIO_SAMPLE_MAX_DEVIATION);
|
|
70
|
+
if (outsideGate) {
|
|
71
|
+
this.rejectedByModel.set(modelKey, (this.rejectedByModel.get(modelKey) ?? 0) + 1);
|
|
72
|
+
// 滑窗(评审 F2):只保留最近 RATIO_ESCAPE_STREAK 个被拒样本——全史 min/max 一旦被
|
|
73
|
+
// 一对不一致垃圾拉开就永不收敛,逃逸随之永久失效(实测:0.05+11.0 后 20 个真样本全拒)。
|
|
74
|
+
const recent = this.rejectStreaks.get(modelKey) ?? [];
|
|
75
|
+
recent.push(raw);
|
|
76
|
+
if (recent.length > RATIO_ESCAPE_STREAK)
|
|
77
|
+
recent.shift();
|
|
78
|
+
this.rejectStreaks.set(modelKey, recent);
|
|
79
|
+
// 逃逸重锚(评审 F1):窗口内同向且内部一致的被拒样本 = regime shift 证据(真实换挡或
|
|
80
|
+
// 新错配源),以窗心重锚。拒绝零状态变化会把真值永久锁在门外;交替垃圾(0.088↔11.014)
|
|
81
|
+
// 任意 RATIO_ESCAPE_STREAK 连窗 max/min 巨大、永不满足一致性,进不来。
|
|
82
|
+
if (recent.length >= RATIO_ESCAPE_STREAK) {
|
|
83
|
+
const min = Math.min(...recent);
|
|
84
|
+
const max = Math.max(...recent);
|
|
85
|
+
if (max / min <= RATIO_ESCAPE_CONSISTENCY) {
|
|
86
|
+
const rebase = Math.min(RATIO_CLAMP_MAX, Math.max(RATIO_CLAMP_MIN, (min + max) / 2));
|
|
87
|
+
this.ratioByModel.set(modelKey, rebase);
|
|
88
|
+
this.samplesByModel.set(modelKey, (this.samplesByModel.get(modelKey) ?? 0) + 1);
|
|
89
|
+
this.rejectStreaks.set(modelKey, []);
|
|
90
|
+
this.setDegraded(modelKey, false, opts, raw); // 重锚基于新鲜证据窗,预测恢复可信
|
|
91
|
+
this.warnOnce(opts?.sessionId, modelKey, raw, opts?.now, 'rebase', `regime shift: rebase learned=${rebase.toFixed(3)}`);
|
|
92
|
+
return 'rebased';
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
this.setDegraded(modelKey, true, opts, raw); // 证据流敌对 → 校准降级(方案 B)
|
|
96
|
+
this.warnOnce(opts?.sessionId, modelKey, raw, opts?.now, 'reject', `rejected(已拒绝入账) learned=${prev.toFixed(3)} gate=[${(prev / RATIO_SAMPLE_MAX_DEVIATION).toFixed(3)}, ${(prev * RATIO_SAMPLE_MAX_DEVIATION).toFixed(3)}]`);
|
|
97
|
+
return 'rejected';
|
|
98
|
+
}
|
|
99
|
+
this.rejectStreaks.set(modelKey, []);
|
|
100
|
+
const outOfClamp = raw < RATIO_CLAMP_MIN || raw > RATIO_CLAMP_MAX;
|
|
101
|
+
if (outOfClamp) {
|
|
102
|
+
this.warnOnce(opts?.sessionId, modelKey, raw, opts?.now, 'clamp', `out of clamp(已夹取入账) clamp=[${RATIO_CLAMP_MIN}, ${RATIO_CLAMP_MAX}]`);
|
|
103
|
+
}
|
|
104
|
+
// 预测带(方案 B 门):入账样本偏离已学 ratio 超 RATIO_PREDICTION_BAND 倍 = 乘数
|
|
105
|
+
// 预测失准(如毒化 ratio 尚未被门拦住的窗口期)→ 降级,直到样本回到带内
|
|
106
|
+
this.setDegraded(modelKey, hasSamples && (raw > prev * RATIO_PREDICTION_BAND || raw < prev / RATIO_PREDICTION_BAND), opts, raw);
|
|
107
|
+
const clamped = Math.min(RATIO_CLAMP_MAX, Math.max(RATIO_CLAMP_MIN, raw));
|
|
108
|
+
this.ratioByModel.set(modelKey, EMA_NEW_WEIGHT * clamped + (1 - EMA_NEW_WEIGHT) * prev);
|
|
109
|
+
this.samplesByModel.set(modelKey, (this.samplesByModel.get(modelKey) ?? 0) + 1);
|
|
110
|
+
return outOfClamp ? 'clamped' : 'accepted';
|
|
111
|
+
}
|
|
112
|
+
/** 降级状态写入 + 进入/退出可见(评审 F5):生产须能从日志判定决策读数是校准还是实测锚定 */
|
|
113
|
+
setDegraded(modelKey, value, opts, raw) {
|
|
114
|
+
const was = this.degradedByModel.get(modelKey) ?? false;
|
|
115
|
+
this.degradedByModel.set(modelKey, value);
|
|
116
|
+
if (was !== value) {
|
|
117
|
+
this.warnOnce(opts?.sessionId, modelKey, raw, opts?.now, value ? 'degrade' : 'recover', value ? 'calibration degraded(决策改实测锚定)' : 'calibration recovered(决策回校准)');
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* 校准一个视图估算(决策与展示读数的唯一出口)。
|
|
122
|
+
*
|
|
123
|
+
* @param modelKey provider/model 标识
|
|
124
|
+
* @param viewTokens 未校准视图估算
|
|
125
|
+
* @returns 校准后的 token 数(向上取整)
|
|
126
|
+
*/
|
|
127
|
+
calibrate(modelKey, viewTokens) {
|
|
128
|
+
return Math.ceil(viewTokens * this.ratio(modelKey));
|
|
129
|
+
}
|
|
130
|
+
/** 当前平滑 ratio(无样本 = 1.0) */
|
|
131
|
+
ratio(modelKey) {
|
|
132
|
+
return this.ratioByModel.get(modelKey) ?? 1.0;
|
|
133
|
+
}
|
|
134
|
+
/** 已学习样本数(收敛观测用;只计已入账样本) */
|
|
135
|
+
sampleCount(modelKey) {
|
|
136
|
+
return this.samplesByModel.get(modelKey) ?? 0;
|
|
137
|
+
}
|
|
138
|
+
/** 被样本门拒绝的样本数(校准停学/锁死观测与 fail-safe 判定用) */
|
|
139
|
+
rejectedCount(modelKey) {
|
|
140
|
+
return this.rejectedByModel.get(modelKey) ?? 0;
|
|
141
|
+
}
|
|
142
|
+
/** 校准是否降级(证据流敌对/预测带外;方案 B 触发位) */
|
|
143
|
+
isDegraded(modelKey) {
|
|
144
|
+
return this.degradedByModel.get(modelKey) ?? false;
|
|
145
|
+
}
|
|
146
|
+
/**
|
|
147
|
+
* 决策读数出口(R1 + 降级 B,arch §10.16)。
|
|
148
|
+
*
|
|
149
|
+
* - 校准可信(≥2 个已入账样本且未降级):ceil(raw × ratio)(R1 原语义);
|
|
150
|
+
* - 不可信(冷启动单样本 / 降级,评审 F1)且有实测锚:ceil(actual × raw / anchor.raw)
|
|
151
|
+
* ——实测是滞后一个请求的硬真值,乘 raw 增长比外推本步增量(拍板方案 B);
|
|
152
|
+
* 锚为 {actual, raw, modelKey} 冻结对(同请求同源,评审 F3),跨 model 无效;
|
|
153
|
+
* - 不可信无锚:raw(诚实估算,不乘可疑 ratio)。
|
|
154
|
+
*
|
|
155
|
+
* @param modelKey provider/model 标识
|
|
156
|
+
* @param rawTokens 本次请求口径的未校准估算
|
|
157
|
+
* @param anchor 实测锚(冻结对:actual=该请求实测 prompt,raw=同请求未校准估算)
|
|
158
|
+
* @returns 决策用 token 读数
|
|
159
|
+
*/
|
|
160
|
+
decisionTokens(modelKey, rawTokens, anchor) {
|
|
161
|
+
return this.decisionTokensWithSource(modelKey, rawTokens, anchor).tokens;
|
|
162
|
+
}
|
|
163
|
+
/**
|
|
164
|
+
* decisionTokens 的带来源变体(可观测:pressure 快照 readingSource,评审 F5)。
|
|
165
|
+
*
|
|
166
|
+
* @param modelKey provider/model 标识
|
|
167
|
+
* @param rawTokens 本次请求口径的未校准估算
|
|
168
|
+
* @param anchor 实测锚(冻结对)
|
|
169
|
+
* @returns 决策读数 + 读数来源(calibrated=校准 / anchored=实测锚定 / raw=裸估算)
|
|
170
|
+
*/
|
|
171
|
+
/**
|
|
172
|
+
* 校准状态导出(持久化用,取舍③配套):重启后第一轮即 anchored/calibrated,
|
|
173
|
+
* 消除「跑几轮才校准」的冷启动过渡。导出 per-key 样本计数 + 最新锚。
|
|
174
|
+
*/
|
|
175
|
+
exportState() {
|
|
176
|
+
const out = {};
|
|
177
|
+
for (const [k, v] of this.samplesByModel)
|
|
178
|
+
out[k] = { samples: v };
|
|
179
|
+
return out;
|
|
180
|
+
}
|
|
181
|
+
/** 校准状态导入(restore 用):样本计数回填 EMA 可信度判定(ratio 本身按新样本重建)。 */
|
|
182
|
+
importState(state) {
|
|
183
|
+
for (const [k, v] of Object.entries(state ?? {})) {
|
|
184
|
+
if (typeof v?.samples === 'number' && v.samples > 0)
|
|
185
|
+
this.samplesByModel.set(k, v.samples);
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
decisionTokensWithSource(modelKey, rawTokens, anchor) {
|
|
189
|
+
const trusted = (this.samplesByModel.get(modelKey) ?? 0) >= 2 && !this.isDegraded(modelKey);
|
|
190
|
+
if (trusted)
|
|
191
|
+
return { tokens: this.calibrate(modelKey, rawTokens), source: 'calibrated' };
|
|
192
|
+
if (anchor && anchor.modelKey === modelKey && anchor.actual > 0 && anchor.raw > 0) {
|
|
193
|
+
// 锚卫生(2026-11-07):锚是同请求实测对的外推(配对槽保证同源)。不做比率带拒用——
|
|
194
|
+
// ratio 远离 1 可能是合法极端内容(图片/大 schema,F1 冷锚定语义),带检查会把这种
|
|
195
|
+
// 内容的决策砸回裸估算(低估 → 压缩触发漏报)。
|
|
196
|
+
// 夹取(2026-11-08,生产现场 0.185 毒读数):clamped 样本 EMA 吃夹取值而锚冻结的是
|
|
197
|
+
// 原始值——极端比率(大 tools schema 本地估算偏高 5×)以原始值外推会毒化读数。
|
|
198
|
+
// 与 EMA 同 guard 夹取 [RATIO_CLAMP_MIN, RATIO_CLAMP_MAX]:不拒极端锚(极端内容仍
|
|
199
|
+
// 锚定),但比率不越过与 EMA 相同的界——两把尺同界。
|
|
200
|
+
const anchorRatio = Math.min(RATIO_CLAMP_MAX, Math.max(RATIO_CLAMP_MIN, anchor.actual / anchor.raw));
|
|
201
|
+
return { tokens: Math.ceil(anchorRatio * rawTokens), source: 'anchored' };
|
|
202
|
+
}
|
|
203
|
+
return { tokens: rawTokens, source: 'raw' };
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
* 包装一个原始估算器为「校准读数」估算器(R1:决策路径读校准值)。
|
|
207
|
+
* 读数 = calibrate(raw);形状归一与计数仍在原始估算器(P1-c 单实现)。
|
|
208
|
+
*/
|
|
209
|
+
calibratedEstimator(modelKey, raw) {
|
|
210
|
+
const ledger = this;
|
|
211
|
+
return {
|
|
212
|
+
estimateMessage(message) {
|
|
213
|
+
return ledger.calibrate(modelKey, raw.estimateMessage(message));
|
|
214
|
+
},
|
|
215
|
+
estimateMessages(messages) {
|
|
216
|
+
return ledger.calibrate(modelKey, raw.estimateMessages(messages));
|
|
217
|
+
},
|
|
218
|
+
estimateText(text) {
|
|
219
|
+
return ledger.calibrate(modelKey, raw.estimateText(text));
|
|
220
|
+
},
|
|
221
|
+
estimateTools(tools) {
|
|
222
|
+
return ledger.calibrate(modelKey, raw.estimateTools(tools));
|
|
223
|
+
},
|
|
224
|
+
};
|
|
225
|
+
}
|
|
226
|
+
/** 样本告警:每 (session, model, 事件类) 每小时至多 1 条(reject/clamp/rebase 分键,拒绝不被夹取吞掉) */
|
|
227
|
+
warnOnce(sessionId, modelKey, raw, now, cls, detail) {
|
|
228
|
+
const key = `${sessionId ?? '—'}|${modelKey}|${cls}`;
|
|
229
|
+
const ts = now ?? Date.now();
|
|
230
|
+
const last = this.lastWarnAt.get(key);
|
|
231
|
+
if (last !== undefined && ts - last < RATIO_WARN_INTERVAL_MS)
|
|
232
|
+
return;
|
|
233
|
+
this.lastWarnAt.set(key, ts);
|
|
234
|
+
this.warn(`[ctx-cal] ratio sample ${cls}: session=${sessionId ?? '—'} model=${modelKey} raw=${raw.toFixed(3)} ${detail}(系统性偏差请校正估算器比率;错配请查 usage/估算配对,arch §10.14)`);
|
|
235
|
+
}
|
|
236
|
+
}
|