@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
|
@@ -5,17 +5,39 @@
|
|
|
5
5
|
*/
|
|
6
6
|
import type { Message } from '@octopi-agent/core/types.js';
|
|
7
7
|
import type { LLMMessage } from '@octopi-agent/core/interfaces/model-provider.js';
|
|
8
|
-
import type { SummaryCoverage, SummaryPolicy
|
|
8
|
+
import type { SummaryCoverage, SummaryPolicy } from '../summary/types.js';
|
|
9
9
|
export type CompactMode = 'structure_only' | 'summary_only' | 'head_tail_only' | 'auto';
|
|
10
10
|
/**
|
|
11
|
-
*
|
|
12
|
-
*
|
|
11
|
+
* 摘要执行函数(族 A 交接式摘要的唯一执行契约,manual / proactive / overflow 共用)。
|
|
12
|
+
*
|
|
13
|
+
* 契约(迭代式更新):`options.previousSummary` 已按约定嵌入 `messages` 正文
|
|
14
|
+
* ("Previous summary: …" 段),实现方无需再读 opts 拼 prompt;**返回值即完整
|
|
15
|
+
* 更新后的摘要**,调用方不得再与旧摘要拼接。
|
|
16
|
+
*
|
|
17
|
+
* @param messages - 摘要请求消息(system 指令 + 用户正文;非原始对话序列)
|
|
18
|
+
* @param options - 摘要选项
|
|
19
|
+
* @returns 完整更新后的摘要文本
|
|
13
20
|
*/
|
|
14
|
-
export type
|
|
21
|
+
export type SummarizeFunction = (messages: LLMMessage[], options?: {
|
|
15
22
|
/** 上次摘要(已嵌入 messages 正文;仅作元信息回传) */
|
|
16
23
|
previousSummary?: string;
|
|
24
|
+
/** 摘要 token 预算 */
|
|
17
25
|
maxTokens?: number;
|
|
26
|
+
/** 自定义指令 */
|
|
18
27
|
instructions?: string;
|
|
28
|
+
/**
|
|
29
|
+
* usage 回传(2026-11-08 outputTokens 真值):摘要请求的 provider 实测输出 tokens。
|
|
30
|
+
* 摘要产物的体量以此为准(真值),估算只作无回传时的兜底——「放着真值用估算」
|
|
31
|
+
* 是压缩计量的口径缺陷(tokensBefore/After 核对,2026-11-08)。
|
|
32
|
+
*/
|
|
33
|
+
onUsage?: (usage: {
|
|
34
|
+
outputTokens?: number;
|
|
35
|
+
}) => void;
|
|
36
|
+
/**
|
|
37
|
+
* 中止信号(P3):run 中止或摘要预算超时都必须能取消在飞请求,
|
|
38
|
+
* 否则 UI 只能干等到 provider 侧超时(2026-11-07 事故:2.13MB 非流式请求挂 20+ 分钟)。
|
|
39
|
+
*/
|
|
40
|
+
signal?: AbortSignal;
|
|
19
41
|
}) => Promise<string>;
|
|
20
42
|
export interface CompactTokenEstimator {
|
|
21
43
|
estimateMessages(messages: Message[]): number;
|
|
@@ -26,16 +48,24 @@ export interface CompactOptions {
|
|
|
26
48
|
protectTail?: number;
|
|
27
49
|
targetTokens?: number;
|
|
28
50
|
mode?: CompactMode;
|
|
29
|
-
/**
|
|
30
|
-
|
|
51
|
+
/** Hook 归因身份:手动压缩不在 RunScope 内,调用方显式身份优先于 RunScope 回落 */
|
|
52
|
+
sessionId?: string;
|
|
53
|
+
agentId?: string;
|
|
54
|
+
/** conversation 策略或显式 policy / id;经 buildSystemPrompt 产指令,要求 output:'text' 策略 */
|
|
31
55
|
summarizePolicy?: SummaryPolicy | string;
|
|
32
|
-
/**
|
|
33
|
-
summarizeFn?:
|
|
34
|
-
/**
|
|
35
|
-
summaryPort?: SummaryPort;
|
|
56
|
+
/** 注入的摘要执行函数(族 A;契约见 SummarizeFunction) */
|
|
57
|
+
summarizeFn?: SummarizeFunction;
|
|
58
|
+
/** 摘要失败/取消时的降级策略:truncate=裁掉未覆盖中段(宁可瘦不丢坏),keep_partial=保留部分产物 */
|
|
36
59
|
onSummarizeFail?: 'truncate' | 'keep_partial';
|
|
37
60
|
estimator?: CompactTokenEstimator;
|
|
38
61
|
previousSummary?: string;
|
|
62
|
+
/**
|
|
63
|
+
* 摘要增量素材(M-4):上一份摘要覆盖终点之后、保护尾之前的新消息。与 previousSummary
|
|
64
|
+
* 同时给出时,textify 旁路只文本化本段(合并契约:previousSummary + 新消息 = 完整
|
|
65
|
+
* 更新),不再把已覆盖历史以全量 raw middle 复发(2.13MB 事故形状)。缺省 = 全量
|
|
66
|
+
* middle(首次压缩/无摘要兜底)。
|
|
67
|
+
*/
|
|
68
|
+
freshMessages?: Message[];
|
|
39
69
|
maxSummaryTokens?: number;
|
|
40
70
|
/**
|
|
41
71
|
* 摘要软目标预算(P1c 拍板缺省 clamp(2%, 2k, 8k)):写进指令的「尽量控制在 N tokens」,
|
|
@@ -55,9 +85,14 @@ export interface CompactOptions {
|
|
|
55
85
|
* 防止模型只总结眼前最近的尾部、漏掉真正要被折叠的旧中段。
|
|
56
86
|
*/
|
|
57
87
|
foldRange?: {
|
|
88
|
+
/** 本次需要并入摘要的消息条数(既有摘要之后、保护尾之前) */
|
|
58
89
|
replacedCount: number;
|
|
90
|
+
/** 会话消息总数 */
|
|
59
91
|
total: number;
|
|
92
|
+
/** 原样保留的尾部条数 */
|
|
60
93
|
preservedTail: number;
|
|
94
|
+
/** 前缀里上一份摘要已经代表的早期消息条数(0/缺省 = 无既有摘要) */
|
|
95
|
+
coveredCount?: number;
|
|
61
96
|
};
|
|
62
97
|
/** 会话模型窗口(评审 F5):provider 多按 input+max_tokens ≤ window 校验,压缩恰在最满时触发 */
|
|
63
98
|
contextWindow?: number;
|
|
@@ -68,6 +103,15 @@ export interface CompactOptions {
|
|
|
68
103
|
* summarizeFn 路径只许尾部追加指令;禁止改写前缀字节。
|
|
69
104
|
*/
|
|
70
105
|
llmPrefix?: import('@octopi-agent/core/interfaces/model-provider.js').LLMMessage[];
|
|
106
|
+
/**
|
|
107
|
+
* 回声比对源覆盖(P2):前缀含既有摘要占位时,占位正文不得参与回声判定——
|
|
108
|
+
* 模型复用/续写上一份交接书不是「复读原文」。缺省回落到前缀文本投影。
|
|
109
|
+
*/
|
|
110
|
+
echoSource?: string;
|
|
111
|
+
/**
|
|
112
|
+
* 中止信号(P3):run 中止 / 摘要预算超时 → 取消在飞摘要请求。
|
|
113
|
+
* 取消产生的错误按 onSummarizeFail 降级(调用方另按 signal.aborted 决定是否写记录)。
|
|
114
|
+
*/
|
|
71
115
|
signal?: AbortSignal;
|
|
72
116
|
emit?: (e: {
|
|
73
117
|
type: 'compact.start' | 'compact.end' | 'compact.error' | 'compact.summarize_fallback';
|
|
@@ -82,14 +126,36 @@ export interface CompactOutcome {
|
|
|
82
126
|
tokensBefore: number;
|
|
83
127
|
tokensAfter?: number;
|
|
84
128
|
summary?: string;
|
|
129
|
+
/** 摘要覆盖终点(下标,不含)= tailStart:E4 状态推进与重放共用锚点。
|
|
130
|
+
* 手动路径(structuralCompact)产出;失败/未新鲜摘要时携带旧值或留空。 */
|
|
131
|
+
coveredMessageCount?: number;
|
|
85
132
|
/** 本次是否产出了**新的**语义摘要(评审 F1):false 时 summary 只是旧摘要兜底,
|
|
86
133
|
* 调用方不得据此推进覆盖计数/覆盖点(否则未摘要的中段会被记成「已覆盖」)。 */
|
|
87
134
|
fresh?: boolean;
|
|
135
|
+
/** 本次是否真正发起过摘要 LLM 调用(成功/失败均算):冷却时间戳只随 true 推进(F8R-01)。
|
|
136
|
+
* 必填(显式标注,杜绝空值歧义):机械/早退路径
|
|
137
|
+
* (empty、within_target、too_short、head_tail_only)显式 false,不许留空。 */
|
|
138
|
+
summarizeAttempted: boolean;
|
|
139
|
+
/** fresh 摘要响应的 provider 实测输出 tokens(onUsage 回传,2026-11-08):
|
|
140
|
+
* 摘要产物体量的真值;无回传(自定义 summarizeFn/失败)时缺省,计量回落估算。 */
|
|
141
|
+
summaryOutputTokens?: number;
|
|
88
142
|
coverage?: SummaryCoverage;
|
|
89
143
|
/** Message[] 或纯文本结果,由入口决定 */
|
|
90
144
|
view: Message[] | string;
|
|
91
145
|
droppedSummary?: string;
|
|
92
146
|
}
|
|
147
|
+
/**
|
|
148
|
+
* 锁面/传输层结果投影:`CompactOutcome` 去 `view`(大对象,UI 无需,不过锁面)。
|
|
149
|
+
* 新增可选字段自动随契约流动——**禁止**在 runner/gateway 手抄字段表(会静默丢新字段)。
|
|
150
|
+
*/
|
|
151
|
+
export type CompactTransportOutcome = Omit<CompactOutcome, 'view'>;
|
|
152
|
+
/**
|
|
153
|
+
* 把能力结果投影为传输结果(唯一投影实现)。
|
|
154
|
+
*
|
|
155
|
+
* @param result - 能力层压缩结果
|
|
156
|
+
* @returns 剥离 view 后的传输结果
|
|
157
|
+
*/
|
|
158
|
+
export declare function toCompactTransport(result: CompactOutcome): CompactTransportOutcome;
|
|
93
159
|
export interface CompactEngine {
|
|
94
160
|
/**
|
|
95
161
|
* 压缩消息序列(会话 / 旁路)
|
|
@@ -113,6 +179,5 @@ export interface CreateCompactEngineOptions {
|
|
|
113
179
|
defaultProtectTail?: number;
|
|
114
180
|
defaultTargetTokens?: number;
|
|
115
181
|
defaultMode?: CompactMode;
|
|
116
|
-
summaryPort?: SummaryPort;
|
|
117
182
|
estimator?: CompactTokenEstimator;
|
|
118
183
|
}
|
|
@@ -3,4 +3,14 @@
|
|
|
3
3
|
*
|
|
4
4
|
* @module harness/context/capabilities/compact/types
|
|
5
5
|
*/
|
|
6
|
-
|
|
6
|
+
/**
|
|
7
|
+
* 把能力结果投影为传输结果(唯一投影实现)。
|
|
8
|
+
*
|
|
9
|
+
* @param result - 能力层压缩结果
|
|
10
|
+
* @returns 剥离 view 后的传输结果
|
|
11
|
+
*/
|
|
12
|
+
export function toCompactTransport(result) {
|
|
13
|
+
const { view: _view, ...rest } = result;
|
|
14
|
+
void _view; // 有意剥离:view 不过锁面
|
|
15
|
+
return rest;
|
|
16
|
+
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 切片手术 — 视图边界对齐与语义过滤的唯一实现
|
|
3
|
+
*
|
|
4
|
+
* P3(2026-11-03)自 DefaultContextEngine 迁入:引擎瘦身为触发/状态层,
|
|
5
|
+
* 「怎么切」属执行手术归本模块。**修 #10**:compact 引擎自身的 head/tail 切片
|
|
6
|
+
* 从此也走 `alignViewSplit`(此前裸 slice 会把 tool_call/tool_result 对劈开:
|
|
7
|
+
* head 停在带 toolCalls 的 assistant 上 → 悬空调用;tail 起于 tool 结果 →
|
|
8
|
+
* 孤儿结果,两者都会被严格网关 400)。
|
|
9
|
+
*
|
|
10
|
+
* @module harness/context/capabilities/compact/view-split
|
|
11
|
+
*/
|
|
12
|
+
import type { Message } from '@octopi-agent/core/types.js';
|
|
13
|
+
/**
|
|
14
|
+
* 视图切分边界对齐(不拆 tool_call/tool_result 对)。
|
|
15
|
+
*
|
|
16
|
+
* head 不得停在带 toolCalls 的 assistant 上(其结果落入中间段,视图里会成悬空调用);
|
|
17
|
+
* tail 不得起于 tool 结果(其调用在中间段,会成孤儿结果)。
|
|
18
|
+
*
|
|
19
|
+
* @param messages - 全量消息
|
|
20
|
+
* @param headCount - 期望头部条数
|
|
21
|
+
* @param tailCount - 期望尾部条数
|
|
22
|
+
* @returns 对齐后的 head 终点(不含)与 tail 起点(含);对齐后实际条数可能与期望不同
|
|
23
|
+
*/
|
|
24
|
+
export declare function alignViewSplit(messages: Message[], headCount: number, tailCount: number): {
|
|
25
|
+
headEnd: number;
|
|
26
|
+
tailStart: number;
|
|
27
|
+
};
|
|
28
|
+
/**
|
|
29
|
+
* 压缩/摘要的语义输入:丢掉托管 system 与 turn 信封元数据
|
|
30
|
+
* (turn_context picks 不进 previousSummary——防陈旧择取固化进摘要);
|
|
31
|
+
* turn_start 只保留 <user_message> 正文。
|
|
32
|
+
*
|
|
33
|
+
* @param messages - 待过滤消息
|
|
34
|
+
* @returns 语义历史(过滤后的消息列表)
|
|
35
|
+
*/
|
|
36
|
+
export declare function semanticHistory(messages: Message[]): Message[];
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 切片手术 — 视图边界对齐与语义过滤的唯一实现
|
|
3
|
+
*
|
|
4
|
+
* P3(2026-11-03)自 DefaultContextEngine 迁入:引擎瘦身为触发/状态层,
|
|
5
|
+
* 「怎么切」属执行手术归本模块。**修 #10**:compact 引擎自身的 head/tail 切片
|
|
6
|
+
* 从此也走 `alignViewSplit`(此前裸 slice 会把 tool_call/tool_result 对劈开:
|
|
7
|
+
* head 停在带 toolCalls 的 assistant 上 → 悬空调用;tail 起于 tool 结果 →
|
|
8
|
+
* 孤儿结果,两者都会被严格网关 400)。
|
|
9
|
+
*
|
|
10
|
+
* @module harness/context/capabilities/compact/view-split
|
|
11
|
+
*/
|
|
12
|
+
import { extractUserMessageText, isTurnStartContent, } from '../../turn-envelope.js';
|
|
13
|
+
import { isToolResultMessage } from './messages.js';
|
|
14
|
+
/**
|
|
15
|
+
* 视图切分边界对齐(不拆 tool_call/tool_result 对)。
|
|
16
|
+
*
|
|
17
|
+
* head 不得停在带 toolCalls 的 assistant 上(其结果落入中间段,视图里会成悬空调用);
|
|
18
|
+
* tail 不得起于 tool 结果(其调用在中间段,会成孤儿结果)。
|
|
19
|
+
*
|
|
20
|
+
* @param messages - 全量消息
|
|
21
|
+
* @param headCount - 期望头部条数
|
|
22
|
+
* @param tailCount - 期望尾部条数
|
|
23
|
+
* @returns 对齐后的 head 终点(不含)与 tail 起点(含);对齐后实际条数可能与期望不同
|
|
24
|
+
*/
|
|
25
|
+
export function alignViewSplit(messages, headCount, tailCount) {
|
|
26
|
+
let headEnd = Math.max(0, Math.min(headCount, messages.length));
|
|
27
|
+
while (headEnd > 0 && (messages[headEnd - 1]?.toolCalls?.length ?? 0) > 0) {
|
|
28
|
+
headEnd--;
|
|
29
|
+
}
|
|
30
|
+
let tailStart = Math.max(0, messages.length - tailCount);
|
|
31
|
+
// tailCount=0 时 tailStart === messages.length(空尾):不得越界读 messages[len]
|
|
32
|
+
while (tailStart > headEnd &&
|
|
33
|
+
tailStart < messages.length &&
|
|
34
|
+
isToolResultMessage(messages[tailStart])) {
|
|
35
|
+
tailStart--;
|
|
36
|
+
}
|
|
37
|
+
// protectN 总和 > messages.length 时裸值可畸形(headEnd > tailStart):夹回合法切点,
|
|
38
|
+
// 禁止 head/tail 重叠重复出消息(调用方多有过短早退,这里是 API 直调用户的护栏)
|
|
39
|
+
if (tailStart < headEnd) {
|
|
40
|
+
tailStart = headEnd;
|
|
41
|
+
}
|
|
42
|
+
return { headEnd, tailStart };
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* 压缩/摘要的语义输入:丢掉托管 system 与 turn 信封元数据
|
|
46
|
+
* (turn_context picks 不进 previousSummary——防陈旧择取固化进摘要);
|
|
47
|
+
* turn_start 只保留 <user_message> 正文。
|
|
48
|
+
*
|
|
49
|
+
* @param messages - 待过滤消息
|
|
50
|
+
* @returns 语义历史(过滤后的消息列表)
|
|
51
|
+
*/
|
|
52
|
+
export function semanticHistory(messages) {
|
|
53
|
+
const out = [];
|
|
54
|
+
for (const m of messages) {
|
|
55
|
+
if (m.role === 'system' && m.metadata?.source === 'systemPrompt')
|
|
56
|
+
continue;
|
|
57
|
+
if (m.metadata?.source === 'turnEnd')
|
|
58
|
+
continue;
|
|
59
|
+
if (m.metadata?.source === 'knowledgeGrounding')
|
|
60
|
+
continue;
|
|
61
|
+
if (m.metadata?.source === 'runtimeSnapshot')
|
|
62
|
+
continue;
|
|
63
|
+
if (m.metadata?.source === 'sessionAttachment')
|
|
64
|
+
continue;
|
|
65
|
+
if (isTurnStartContent(m.content)) {
|
|
66
|
+
out.push({ ...m, content: extractUserMessageText(m.content) });
|
|
67
|
+
continue;
|
|
68
|
+
}
|
|
69
|
+
out.push(m);
|
|
70
|
+
}
|
|
71
|
+
return out;
|
|
72
|
+
}
|
|
@@ -22,7 +22,6 @@ export function createSummaryPort(options) {
|
|
|
22
22
|
providers: options.providers,
|
|
23
23
|
levelMap: options.levelMap,
|
|
24
24
|
fallbackProvider: options.fallbackProvider,
|
|
25
|
-
legacySummaryModel: options.legacySummaryModel,
|
|
26
25
|
explicitModel: options.model,
|
|
27
26
|
modelLevel: options.modelLevel,
|
|
28
27
|
policyModel,
|
|
@@ -27,7 +27,7 @@ export declare function resolvePolicyForUnit(unit: ContentUnit, registry: Record
|
|
|
27
27
|
*/
|
|
28
28
|
export declare function buildPolicyRegistry(overrides?: Record<string, SummaryPolicy>): Record<string, SummaryPolicy>;
|
|
29
29
|
/**
|
|
30
|
-
* 解析摘要用 ModelProvider(priority: policy.model → policy.modelLevel → explicit → level(缺省 mini) →
|
|
30
|
+
* 解析摘要用 ModelProvider(priority: policy.model → policy.modelLevel → explicit → level(缺省 mini) → mini → standard → fallback)
|
|
31
31
|
*
|
|
32
32
|
* @param input - providers / levelMap / 显式与兼容配置
|
|
33
33
|
* @returns 解析结果
|
|
@@ -76,7 +76,7 @@ function parseProviderModel(ref) {
|
|
|
76
76
|
return { provider: ref.slice(0, slash), model: ref.slice(slash + 1) };
|
|
77
77
|
}
|
|
78
78
|
/**
|
|
79
|
-
* 解析摘要用 ModelProvider(priority: policy.model → policy.modelLevel → explicit → level(缺省 mini) →
|
|
79
|
+
* 解析摘要用 ModelProvider(priority: policy.model → policy.modelLevel → explicit → level(缺省 mini) → mini → standard → fallback)
|
|
80
80
|
*
|
|
81
81
|
* @param input - providers / levelMap / 显式与兼容配置
|
|
82
82
|
* @returns 解析结果
|
|
@@ -126,11 +126,6 @@ export function resolveSummaryModel(input) {
|
|
|
126
126
|
const summaryLevel = pickLevel(levelName);
|
|
127
127
|
if (summaryLevel)
|
|
128
128
|
return { ...summaryLevel, from: 'level' };
|
|
129
|
-
if (input.legacySummaryModel) {
|
|
130
|
-
const r = tryModelRef(input.legacySummaryModel, 'legacy');
|
|
131
|
-
if (r)
|
|
132
|
-
return r;
|
|
133
|
-
}
|
|
134
129
|
const mini = pickLevel('mini');
|
|
135
130
|
if (mini)
|
|
136
131
|
return { ...mini, from: 'mini' };
|
|
@@ -72,7 +72,7 @@ export interface ApplyToolOutputGateOutput {
|
|
|
72
72
|
structuredError?: string;
|
|
73
73
|
};
|
|
74
74
|
/** Summary LLM 调用的 usage(用于 UsageLedger 归因;仅 L2) */
|
|
75
|
-
usage?: import('@octopi-agent/core/types/
|
|
75
|
+
usage?: import('@octopi-agent/core/types/step.js').TokenUsage;
|
|
76
76
|
}
|
|
77
77
|
/**
|
|
78
78
|
* 工具结果出口门控:**L1 硬顶(永远)+ 可选 L2 摘要**
|
|
@@ -92,7 +92,7 @@ export interface SummaryResult {
|
|
|
92
92
|
tokensIn: number;
|
|
93
93
|
tokensOut: number;
|
|
94
94
|
/** Provider 上报的完整 usage(含 cache 分项),用于 UsageLedger 归因 */
|
|
95
|
-
usage?: import('@octopi-agent/core/types/
|
|
95
|
+
usage?: import('@octopi-agent/core/types/step.js').TokenUsage;
|
|
96
96
|
truncatedInput?: boolean;
|
|
97
97
|
chunks?: {
|
|
98
98
|
total: number;
|
|
@@ -129,8 +129,6 @@ export interface ResolveSummaryModelInput {
|
|
|
129
129
|
fallback?: string[];
|
|
130
130
|
}>;
|
|
131
131
|
fallbackProvider?: ModelProvider;
|
|
132
|
-
/** config.contextEngine.summaryModel 兼容键 */
|
|
133
|
-
legacySummaryModel?: string;
|
|
134
132
|
/** config.summary.model 显式 */
|
|
135
133
|
explicitModel?: string;
|
|
136
134
|
/** config.summary.modelLevel,默认 'mini' */
|
|
@@ -142,7 +140,7 @@ export interface ResolveSummaryModelInput {
|
|
|
142
140
|
export interface ResolvedSummaryModel {
|
|
143
141
|
provider: ModelProvider;
|
|
144
142
|
model?: string;
|
|
145
|
-
from: 'policy.model' | 'policy.modelLevel' | 'explicit' | 'level' | '
|
|
143
|
+
from: 'policy.model' | 'policy.modelLevel' | 'explicit' | 'level' | 'mini' | 'standard' | 'fallback';
|
|
146
144
|
}
|
|
147
145
|
export interface CreateSummaryPortOptions {
|
|
148
146
|
providers: Map<string, ModelProvider>;
|
|
@@ -151,7 +149,6 @@ export interface CreateSummaryPortOptions {
|
|
|
151
149
|
fallback?: string[];
|
|
152
150
|
}>;
|
|
153
151
|
fallbackProvider: ModelProvider;
|
|
154
|
-
legacySummaryModel?: string;
|
|
155
152
|
model?: string;
|
|
156
153
|
modelLevel?: string;
|
|
157
154
|
/** 整策略替换(同 id 全量覆盖) */
|
|
@@ -167,5 +164,5 @@ export interface CreateSummaryPortOptions {
|
|
|
167
164
|
toolBindings?: Record<string, Partial<ToolSummaryBinding>>;
|
|
168
165
|
maxReturnCharsDefault?: number;
|
|
169
166
|
/** Summary LLM 调用的 usage 回调(用于 UsageLedger 归因) */
|
|
170
|
-
onUsage?: (usage: import('@octopi-agent/core/types/
|
|
167
|
+
onUsage?: (usage: import('@octopi-agent/core/types/step.js').TokenUsage) => void;
|
|
171
168
|
}
|
|
@@ -0,0 +1,143 @@
|
|
|
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
|
+
import type { TokenEstimator } from './types.js';
|
|
28
|
+
/** ratio 夹取边界(拍板:[0.25, 4.0]) */
|
|
29
|
+
export declare const RATIO_CLAMP_MIN = 0.25;
|
|
30
|
+
export declare const RATIO_CLAMP_MAX = 4;
|
|
31
|
+
/** 样本偏离门:新样本偏离已学 ratio 超该倍数(任一方向)即拒绝入账(arch §10.14) */
|
|
32
|
+
export declare const RATIO_SAMPLE_MAX_DEVIATION = 4;
|
|
33
|
+
/** 逃逸重锚:连续同向且内部一致的被拒簇达该长度即视为 regime shift(评审 F1) */
|
|
34
|
+
export declare const RATIO_ESCAPE_STREAK = 3;
|
|
35
|
+
/** 逃逸簇内部一致性:max/min ≤ 该值才算「同向一致」(交替垃圾永不一致) */
|
|
36
|
+
export declare const RATIO_ESCAPE_CONSISTENCY = 2;
|
|
37
|
+
/** 预测带:入账样本偏离已学 ratio 超该倍数 = 校准预测失准 → 降级(方案 B 门,arch §10.16) */
|
|
38
|
+
export declare const RATIO_PREDICTION_BAND = 1.5;
|
|
39
|
+
/** 越界告警限频:每 (session, model) 每小时 1 条 */
|
|
40
|
+
export declare const RATIO_WARN_INTERVAL_MS = 3600000;
|
|
41
|
+
export interface SizeLedgerWarn {
|
|
42
|
+
(message: string): void;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* observe 裁决:accepted=干净入账(可作锚)/ clamped=越界夹取入账(禁作锚)/
|
|
46
|
+
* rejected=样本门拒收 / rebased=滑窗重锚 / ignored=无效对(缺一边,丢样)
|
|
47
|
+
*/
|
|
48
|
+
export type ObserveVerdict = 'accepted' | 'clamped' | 'rejected' | 'rebased' | 'ignored';
|
|
49
|
+
/** 校准台账:observe(actual, view) 学 ratio;calibrate(viewTokens) 出校准读数 */
|
|
50
|
+
export declare class ContextSizeLedger {
|
|
51
|
+
private readonly warn;
|
|
52
|
+
private ratioByModel;
|
|
53
|
+
private samplesByModel;
|
|
54
|
+
private rejectedByModel;
|
|
55
|
+
private rejectStreaks;
|
|
56
|
+
private degradedByModel;
|
|
57
|
+
private lastWarnAt;
|
|
58
|
+
constructor(warn?: SizeLedgerWarn);
|
|
59
|
+
/**
|
|
60
|
+
* 记录一对实测/估算样本(分母 view 必须是「system+tools+视图」口径的**未校准**估算)。
|
|
61
|
+
*
|
|
62
|
+
* @param modelKey provider/model 标识(ratio 的分键)
|
|
63
|
+
* @param actual provider 实测 prompt tokens
|
|
64
|
+
* @param view 同一请求的未校准视图估算
|
|
65
|
+
* @param opts sessionId(告警限频键)/ now(测试注入时钟)
|
|
66
|
+
* @returns 裁决(调用方据其决定是否冻结实测锚——夹取/拒收/重锚样本一律不得作锚)
|
|
67
|
+
*/
|
|
68
|
+
observe(modelKey: string, actual: number, view: number, opts?: {
|
|
69
|
+
sessionId?: string;
|
|
70
|
+
now?: number;
|
|
71
|
+
}): ObserveVerdict;
|
|
72
|
+
/** 降级状态写入 + 进入/退出可见(评审 F5):生产须能从日志判定决策读数是校准还是实测锚定 */
|
|
73
|
+
private setDegraded;
|
|
74
|
+
/**
|
|
75
|
+
* 校准一个视图估算(决策与展示读数的唯一出口)。
|
|
76
|
+
*
|
|
77
|
+
* @param modelKey provider/model 标识
|
|
78
|
+
* @param viewTokens 未校准视图估算
|
|
79
|
+
* @returns 校准后的 token 数(向上取整)
|
|
80
|
+
*/
|
|
81
|
+
calibrate(modelKey: string, viewTokens: number): number;
|
|
82
|
+
/** 当前平滑 ratio(无样本 = 1.0) */
|
|
83
|
+
ratio(modelKey: string): number;
|
|
84
|
+
/** 已学习样本数(收敛观测用;只计已入账样本) */
|
|
85
|
+
sampleCount(modelKey: string): number;
|
|
86
|
+
/** 被样本门拒绝的样本数(校准停学/锁死观测与 fail-safe 判定用) */
|
|
87
|
+
rejectedCount(modelKey: string): number;
|
|
88
|
+
/** 校准是否降级(证据流敌对/预测带外;方案 B 触发位) */
|
|
89
|
+
isDegraded(modelKey: string): boolean;
|
|
90
|
+
/**
|
|
91
|
+
* 决策读数出口(R1 + 降级 B,arch §10.16)。
|
|
92
|
+
*
|
|
93
|
+
* - 校准可信(≥2 个已入账样本且未降级):ceil(raw × ratio)(R1 原语义);
|
|
94
|
+
* - 不可信(冷启动单样本 / 降级,评审 F1)且有实测锚:ceil(actual × raw / anchor.raw)
|
|
95
|
+
* ——实测是滞后一个请求的硬真值,乘 raw 增长比外推本步增量(拍板方案 B);
|
|
96
|
+
* 锚为 {actual, raw, modelKey} 冻结对(同请求同源,评审 F3),跨 model 无效;
|
|
97
|
+
* - 不可信无锚:raw(诚实估算,不乘可疑 ratio)。
|
|
98
|
+
*
|
|
99
|
+
* @param modelKey provider/model 标识
|
|
100
|
+
* @param rawTokens 本次请求口径的未校准估算
|
|
101
|
+
* @param anchor 实测锚(冻结对:actual=该请求实测 prompt,raw=同请求未校准估算)
|
|
102
|
+
* @returns 决策用 token 读数
|
|
103
|
+
*/
|
|
104
|
+
decisionTokens(modelKey: string, rawTokens: number, anchor?: {
|
|
105
|
+
actual: number;
|
|
106
|
+
raw: number;
|
|
107
|
+
modelKey: string;
|
|
108
|
+
}): number;
|
|
109
|
+
/**
|
|
110
|
+
* decisionTokens 的带来源变体(可观测:pressure 快照 readingSource,评审 F5)。
|
|
111
|
+
*
|
|
112
|
+
* @param modelKey provider/model 标识
|
|
113
|
+
* @param rawTokens 本次请求口径的未校准估算
|
|
114
|
+
* @param anchor 实测锚(冻结对)
|
|
115
|
+
* @returns 决策读数 + 读数来源(calibrated=校准 / anchored=实测锚定 / raw=裸估算)
|
|
116
|
+
*/
|
|
117
|
+
/**
|
|
118
|
+
* 校准状态导出(持久化用,取舍③配套):重启后第一轮即 anchored/calibrated,
|
|
119
|
+
* 消除「跑几轮才校准」的冷启动过渡。导出 per-key 样本计数 + 最新锚。
|
|
120
|
+
*/
|
|
121
|
+
exportState(): Record<string, {
|
|
122
|
+
samples: number;
|
|
123
|
+
}>;
|
|
124
|
+
/** 校准状态导入(restore 用):样本计数回填 EMA 可信度判定(ratio 本身按新样本重建)。 */
|
|
125
|
+
importState(state: Record<string, {
|
|
126
|
+
samples: number;
|
|
127
|
+
}>): void;
|
|
128
|
+
decisionTokensWithSource(modelKey: string, rawTokens: number, anchor?: {
|
|
129
|
+
actual: number;
|
|
130
|
+
raw: number;
|
|
131
|
+
modelKey: string;
|
|
132
|
+
}): {
|
|
133
|
+
tokens: number;
|
|
134
|
+
source: 'calibrated' | 'anchored' | 'raw';
|
|
135
|
+
};
|
|
136
|
+
/**
|
|
137
|
+
* 包装一个原始估算器为「校准读数」估算器(R1:决策路径读校准值)。
|
|
138
|
+
* 读数 = calibrate(raw);形状归一与计数仍在原始估算器(P1-c 单实现)。
|
|
139
|
+
*/
|
|
140
|
+
calibratedEstimator(modelKey: string, raw: TokenEstimator): TokenEstimator;
|
|
141
|
+
/** 样本告警:每 (session, model, 事件类) 每小时至多 1 条(reject/clamp/rebase 分键,拒绝不被夹取吞掉) */
|
|
142
|
+
private warnOnce;
|
|
143
|
+
}
|