@octopi-agent/engine 0.98.4 → 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 +35 -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 +57 -160
- package/dist/config-schema/engine.js +1 -5
- package/dist/config-schema/governance.d.ts +8 -1
- package/dist/config-schema/governance.js +8 -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 +24 -3
- package/dist/harness/agent/builder.js +131 -27
- package/dist/harness/agent/config-bridge.js +9 -2
- package/dist/harness/agent/config-integrity.js +19 -2
- package/dist/harness/agent/wire-agent-builder.d.ts +11 -3
- package/dist/harness/agent/wire-agent-builder.js +26 -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/loader.js +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +2 -2
- 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 +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +3 -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 +1 -6
- package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
- package/dist/harness/context/capabilities/summary/types.d.ts +3 -6
- 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 +14 -15
- package/dist/harness/context/layers.js +41 -11
- 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 +2 -2
- package/dist/harness/context/summarize.js +9 -2
- package/dist/harness/context/system-prompt-assembler.d.ts +2 -0
- package/dist/harness/context/system-prompt-assembler.js +2 -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/ops-audit.d.ts +1 -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/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/delegation.js +18 -8
- 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/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/sqlite/wisdom-store.js +35 -10
- package/dist/harness/memory/types.d.ts +6 -4
- 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.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 +37 -4
- package/dist/harness/run/runner.d.ts +44 -29
- package/dist/harness/run/runner.js +320 -102
- 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/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/wisdom-steward/formation/SUBSYSTEM.md +8 -1
- package/dist/subsystems/wisdom-steward/formation/config.yaml +1 -0
- package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
- package/package.json +11 -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
|
+
}
|