@octopi-agent/engine 0.102.10 → 0.121.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/builtin-model-info.js +28 -7
- package/dist/config-admin/agent-presets.d.ts +32 -0
- package/dist/config-admin/agent-presets.js +133 -0
- package/dist/config-admin/discover.d.ts +33 -4
- package/dist/config-admin/discover.js +101 -6
- package/dist/config-admin/env.d.ts +11 -0
- package/dist/config-admin/env.js +41 -0
- package/dist/config-admin/error-copy.d.ts +106 -0
- package/dist/config-admin/error-copy.js +287 -0
- package/dist/config-admin/i18n.d.ts +21 -0
- package/dist/config-admin/i18n.js +19 -0
- package/dist/config-admin/index.d.ts +6 -2
- package/dist/config-admin/index.js +3 -1
- package/dist/config-admin/model-presets.d.ts +14 -0
- package/dist/config-admin/model-presets.js +595 -70
- package/dist/config-admin/onboarding-apply.d.ts +71 -0
- package/dist/config-admin/onboarding-apply.js +235 -0
- package/dist/config-admin/onboarding.d.ts +154 -0
- package/dist/config-admin/onboarding.js +270 -0
- package/dist/config-admin/redact.d.ts +42 -9
- package/dist/config-admin/redact.js +69 -5
- package/dist/config-schema/agent.d.ts +5 -1
- package/dist/config-schema/agent.js +20 -2
- package/dist/config-schema/browser.d.ts +62 -0
- package/dist/config-schema/browser.js +89 -0
- package/dist/config-schema/context.d.ts +7 -2
- package/dist/config-schema/context.js +6 -3
- package/dist/config-schema/engine.d.ts +86 -7
- package/dist/config-schema/engine.js +9 -2
- package/dist/config-schema/governance.d.ts +12 -1
- package/dist/config-schema/governance.js +10 -2
- package/dist/config-schema/models.d.ts +12 -8
- package/dist/config-schema/models.js +16 -1
- package/dist/config-schema/run.d.ts +4 -0
- package/dist/config-schema/run.js +10 -0
- package/dist/config-schema/shared.d.ts +1 -0
- package/dist/config-schema/shared.js +4 -2
- package/dist/config-schema/substrate.d.ts +5 -0
- package/dist/config-schema/substrate.js +8 -0
- package/dist/config.d.ts +116 -10
- package/dist/config.js +109 -13
- package/dist/file-mode.d.ts +67 -0
- package/dist/file-mode.js +182 -0
- package/dist/fork-child.d.ts +82 -0
- package/dist/fork-child.js +123 -0
- package/dist/harness/activation/delegated-run.d.ts +42 -0
- package/dist/harness/activation/delegated-run.js +71 -0
- package/dist/harness/activation/dispatcher.js +4 -0
- package/dist/harness/activation/index.d.ts +1 -0
- package/dist/harness/activation/run-backend.d.ts +92 -0
- package/dist/harness/activation/run-backend.js +16 -0
- package/dist/harness/activation/run-protocol.d.ts +392 -0
- package/dist/harness/activation/run-protocol.js +19 -0
- package/dist/harness/activation/runtime.d.ts +33 -0
- package/dist/harness/activation/runtime.js +119 -28
- package/dist/harness/activation/types.d.ts +19 -2
- package/dist/harness/agent/builder.d.ts +12 -0
- package/dist/harness/agent/builder.js +78 -22
- package/dist/harness/agent/config-bridge.d.ts +10 -1
- package/dist/harness/agent/config-bridge.js +15 -3
- package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
- package/dist/harness/agent/registered-tool-adapter.js +67 -0
- package/dist/harness/agent/wire-agent-builder.d.ts +2 -0
- package/dist/harness/agent/wire-agent-builder.js +9 -2
- package/dist/harness/capabilities/document/backends/plain.js +2 -1
- package/dist/harness/capabilities/document/legacy/factory.js +3 -2
- package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
- package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
- package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
- package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
- package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
- package/dist/harness/collaboration/autonomous-subsystem/loader.js +1 -0
- package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
- package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +13 -3
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +48 -39
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +3 -0
- package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +4 -0
- package/dist/harness/collaboration/delegation/child-run.d.ts +9 -0
- package/dist/harness/collaboration/delegation/child-run.js +34 -2
- package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
- package/dist/harness/collaboration/delegation/service.d.ts +9 -4
- package/dist/harness/collaboration/delegation/service.js +33 -12
- package/dist/harness/collaboration/delegation/store.d.ts +2 -0
- package/dist/harness/collaboration/delegation/store.js +1 -0
- package/dist/harness/collaboration/delegation/types.d.ts +11 -0
- package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
- package/dist/harness/collaboration/delegation/wiring.js +1 -0
- package/dist/harness/context/capabilities/compact/engine.d.ts +44 -5
- package/dist/harness/context/capabilities/compact/engine.js +127 -39
- package/dist/harness/context/capabilities/compact/index.d.ts +2 -1
- package/dist/harness/context/capabilities/compact/index.js +1 -1
- package/dist/harness/context/capabilities/compact/types.d.ts +59 -9
- package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
- package/dist/harness/context/capabilities/summary/gate.js +53 -6
- package/dist/harness/context/capabilities/summary/registry.js +20 -0
- package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
- package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
- package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
- package/dist/harness/context/capabilities/summary/types.d.ts +16 -0
- package/dist/harness/context/constitution/default-agents.md +85 -0
- package/dist/harness/context/context-size-ledger.js +8 -1
- package/dist/harness/context/default-context-engine.d.ts +100 -6
- package/dist/harness/context/default-context-engine.js +382 -89
- package/dist/harness/context/index.d.ts +2 -1
- package/dist/harness/context/index.js +1 -0
- package/dist/harness/context/layer-health.d.ts +4 -0
- package/dist/harness/context/layer-health.js +4 -0
- package/dist/harness/context/layer-types.d.ts +57 -0
- package/dist/harness/context/layer-types.js +73 -1
- package/dist/harness/context/layers.d.ts +3 -0
- package/dist/harness/context/layers.js +13 -6
- package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
- package/dist/harness/context/prefix-fingerprint.js +52 -0
- package/dist/harness/context/summarize.js +18 -0
- package/dist/harness/context/system-prompt-assembler.d.ts +2 -0
- package/dist/harness/context/system-prompt-assembler.js +5 -2
- package/dist/harness/context/tool-result-aging.d.ts +104 -16
- package/dist/harness/context/tool-result-aging.js +211 -57
- package/dist/harness/context/types.d.ts +71 -4
- package/dist/harness/context/types.js +25 -1
- package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
- package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
- package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
- package/dist/harness/extension/execution-environment/workspace.js +1 -1
- package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +27 -1
- package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
- package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
- package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
- package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
- package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
- package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +168 -1
- package/dist/harness/extension/plugin-ecosystem/plugins/api.js +156 -15
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +40 -5
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +45 -26
- package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +11 -1
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +42 -76
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +30 -1
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +46 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +9 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +19 -14
- package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +3 -1
- package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +1 -1
- package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
- package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
- package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
- package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
- package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
- package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
- package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
- package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
- package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
- package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
- package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
- package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +10 -24
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
- package/dist/harness/governance/credentials/db.d.ts +9 -0
- package/dist/harness/governance/credentials/db.js +122 -31
- package/dist/harness/governance/credentials/store.d.ts +68 -7
- package/dist/harness/governance/credentials/store.js +177 -64
- package/dist/harness/governance/credentials/types.d.ts +13 -2
- package/dist/harness/governance/index.d.ts +1 -0
- package/dist/harness/governance/index.js +1 -0
- package/dist/harness/governance/registry/db.d.ts +32 -0
- package/dist/harness/governance/registry/db.js +142 -0
- package/dist/harness/governance/registry/index.d.ts +9 -0
- package/dist/harness/governance/registry/index.js +9 -0
- package/dist/harness/governance/registry/service.d.ts +381 -0
- package/dist/harness/governance/registry/service.js +825 -0
- package/dist/harness/governance/registry/types.d.ts +77 -0
- package/dist/harness/governance/registry/types.js +7 -0
- package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
- package/dist/harness/governance/security/default-security-guard.js +12 -1
- package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
- package/dist/harness/governance/security/risk-evaluator.js +307 -21
- package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
- package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
- package/dist/harness/index.d.ts +5 -3
- package/dist/harness/index.js +2 -2
- package/dist/harness/knowledge/boot-config.d.ts +2 -0
- package/dist/harness/knowledge/boot-config.js +2 -0
- package/dist/harness/knowledge/client.d.ts +53 -7
- package/dist/harness/knowledge/client.js +77 -20
- package/dist/harness/knowledge/db.d.ts +16 -0
- package/dist/harness/knowledge/db.js +107 -41
- package/dist/harness/knowledge/engine-thread.js +5 -7
- package/dist/harness/knowledge/grounding.js +4 -1
- package/dist/harness/knowledge/http-app.d.ts +15 -0
- package/dist/harness/knowledge/http-app.js +82 -21
- package/dist/harness/knowledge/http-bridge.d.ts +15 -0
- package/dist/harness/knowledge/http-bridge.js +19 -0
- package/dist/harness/knowledge/knowledge-serve-child.js +2 -3
- package/dist/harness/knowledge/query-service.d.ts +12 -2
- package/dist/harness/knowledge/query-service.js +75 -41
- package/dist/harness/knowledge/query-worker-client.d.ts +5 -1
- package/dist/harness/knowledge/query-worker-client.js +4 -1
- package/dist/harness/knowledge/query-worker.js +5 -3
- package/dist/harness/knowledge/read-http.d.ts +2 -0
- package/dist/harness/knowledge/read-http.js +9 -2
- package/dist/harness/knowledge/retriever.d.ts +1 -1
- package/dist/harness/knowledge/retriever.js +1 -2
- package/dist/harness/knowledge/serve.d.ts +6 -1
- package/dist/harness/knowledge/serve.js +5 -6
- package/dist/harness/knowledge/source-store.d.ts +101 -5
- package/dist/harness/knowledge/source-store.js +297 -71
- package/dist/harness/knowledge/start-service-process.d.ts +27 -8
- package/dist/harness/knowledge/start-service-process.js +49 -90
- package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
- package/dist/harness/knowledge/tenant-gate.js +167 -0
- package/dist/harness/knowledge/writer-service.d.ts +18 -2
- package/dist/harness/knowledge/writer-service.js +80 -16
- package/dist/harness/knowledge/writer-worker-client.d.ts +9 -2
- package/dist/harness/knowledge/writer-worker-client.js +20 -3
- package/dist/harness/knowledge/writer-worker.js +11 -4
- package/dist/harness/memory/backfill-trigger.d.ts +10 -3
- package/dist/harness/memory/backfill-trigger.js +19 -19
- package/dist/harness/memory/cognition-seeds.d.ts +45 -0
- package/dist/harness/memory/cognition-seeds.js +67 -0
- package/dist/harness/memory/cognition.d.ts +12 -3
- package/dist/harness/memory/cognition.js +55 -35
- package/dist/harness/memory/conceptualizer.d.ts +11 -1
- package/dist/harness/memory/conceptualizer.js +10 -1
- package/dist/harness/memory/context-slice.d.ts +42 -0
- package/dist/harness/memory/context-slice.js +197 -0
- package/dist/harness/memory/health-probe.d.ts +8 -2
- package/dist/harness/memory/health-probe.js +10 -13
- package/dist/harness/memory/index.d.ts +5 -1
- package/dist/harness/memory/index.js +3 -1
- package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
- package/dist/harness/memory/sqlite/agent-db.js +9 -8
- package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
- package/dist/harness/memory/sqlite/cognition-store.js +103 -45
- package/dist/harness/memory/sqlite/memory-store.js +4 -0
- package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
- package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
- package/dist/harness/memory/types.d.ts +18 -2
- package/dist/harness/observability/observer/hub.d.ts +10 -0
- package/dist/harness/observability/observer/hub.js +95 -2
- package/dist/harness/run/agent/agent.js +3 -2
- package/dist/harness/run/concurrency/tool-validator.js +4 -3
- package/dist/harness/run/reliability/run-agent.d.ts +22 -0
- package/dist/harness/run/reliability/run-agent.js +79 -10
- package/dist/harness/run/run-host.d.ts +302 -0
- package/dist/harness/run/run-host.js +978 -0
- package/dist/harness/run/run-scope.d.ts +11 -0
- package/dist/harness/run/run-scope.js +19 -1
- package/dist/harness/run/runner.d.ts +149 -22
- package/dist/harness/run/runner.js +352 -35
- package/dist/harness/session/in-memory-store.js +13 -1
- package/dist/harness/session/schedules/service.d.ts +10 -2
- package/dist/harness/session/schedules/service.js +13 -2
- package/dist/harness/session/tasks/tools.js +12 -0
- package/dist/harness/session/types.d.ts +10 -14
- package/dist/harness/shared/events/agent-event-map.d.ts +29 -0
- package/dist/harness/shared/types/agent-definition.d.ts +6 -0
- package/dist/index.d.ts +3 -2
- package/dist/index.js +2 -1
- package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
- package/dist/integration/agent-runtime/channel-message-source.js +4 -3
- package/dist/integration/browser/camoufox.d.ts +40 -0
- package/dist/integration/browser/camoufox.js +80 -0
- package/dist/integration/browser/index.d.ts +91 -0
- package/dist/integration/browser/index.js +110 -0
- package/dist/integration/browser/install.d.ts +47 -0
- package/dist/integration/browser/install.js +214 -0
- package/dist/integration/browser/playwright.d.ts +224 -0
- package/dist/integration/browser/playwright.js +925 -0
- package/dist/integration/browser/service.d.ts +41 -0
- package/dist/integration/browser/service.js +181 -0
- package/dist/integration/browser/stealth.d.ts +42 -0
- package/dist/integration/browser/stealth.js +104 -0
- package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
- package/dist/integration/providers/anthropic-message-normalize.js +48 -0
- package/dist/integration/providers/anthropic.js +27 -2
- package/dist/integration/providers/fetch-timeout.d.ts +17 -0
- package/dist/integration/providers/fetch-timeout.js +24 -0
- package/dist/integration/providers/openai.d.ts +8 -0
- package/dist/integration/providers/openai.js +41 -1
- package/dist/integration/providers/wire-dump-diff.js +2 -1
- package/dist/integration/providers/wire-dump.d.ts +56 -2
- package/dist/integration/providers/wire-dump.js +119 -6
- package/dist/integration/storage/archive-manager.d.ts +14 -2
- package/dist/integration/storage/archive-manager.js +24 -8
- package/dist/integration/storage/atomic-tmp.d.ts +12 -0
- package/dist/integration/storage/atomic-tmp.js +36 -0
- package/dist/integration/storage/jsonl.d.ts +9 -0
- package/dist/integration/storage/jsonl.js +137 -38
- package/dist/integration/storage/session-index.d.ts +5 -0
- package/dist/integration/storage/session-index.js +25 -4
- package/dist/integration/tools/assemble.d.ts +50 -0
- package/dist/integration/tools/assemble.js +137 -0
- package/dist/paths.d.ts +18 -0
- package/dist/paths.js +36 -0
- package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
- package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
- package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
- package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
- package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
- package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
- package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
- package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
- package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
- package/dist/subsystems/wisdom-steward/formation/config.yaml +3 -0
- package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
- package/package.json +5 -3
|
@@ -18,8 +18,8 @@
|
|
|
18
18
|
* - 迭代式摘要(传入上次摘要,更新而非重建)
|
|
19
19
|
* - 实际 token 数回写
|
|
20
20
|
*/
|
|
21
|
-
import type { Message } from '@octopi-agent/core/types.js';
|
|
22
|
-
import type {
|
|
21
|
+
import type { Message, ToolResultAger } from '@octopi-agent/core/types.js';
|
|
22
|
+
import type { LLMToolDefinition } from '@octopi-agent/core/interfaces/model-provider.js';
|
|
23
23
|
import type { ContextEngine, ContextEngineInfo, AssembleParams, AssembleResult, IngestParams, AfterStepParams, TokenEstimator, SummarizeFunction, MessageSelector, BudgetAllocator, ContextEmitFn, ContextCompactSnapshot } from './types.js';
|
|
24
24
|
import { type ToolResultAgingConfig } from './tool-result-aging.js';
|
|
25
25
|
import type { CompactEngine, CompactOutcome } from './capabilities/compact/index.js';
|
|
@@ -98,6 +98,23 @@ export declare class DefaultContextEngine implements ContextEngine {
|
|
|
98
98
|
private orphanWarned;
|
|
99
99
|
/** P1-a 校准台账:ratio 按 model 分键,observe/calibrate 唯一出入口 */
|
|
100
100
|
private sizeLedger;
|
|
101
|
+
/**
|
|
102
|
+
* 最近一次会话请求的工具面前缀指纹(按 sessionId)。
|
|
103
|
+
*
|
|
104
|
+
* 只为可观测:摘要请求的前缀必须与它同形才能命中缓存。tools 在一个会话生命周期内
|
|
105
|
+
* 近乎不变,一旦摘要请求的 toolsHash 与之不同,就是真问题(2026-11-12 事故形状)。
|
|
106
|
+
* 只告警不断言——摘要前缀与「当前」请求本就可能不同(折叠阶梯)。
|
|
107
|
+
*/
|
|
108
|
+
/** 最近一次工具面哈希(按数组引用缓存,避免每 step 重复 sha1) */
|
|
109
|
+
private lastToolsHash?;
|
|
110
|
+
/**
|
|
111
|
+
* 最近一次**会话请求**的前缀指纹(tools + system + messages)
|
|
112
|
+
*
|
|
113
|
+
* 用途:摘要请求发出前比对——任一项不同,前缀缓存必 miss。
|
|
114
|
+
* 2026-11-13 事故正是 tools/system 相同而 messages 半区(老化形态)分叉,
|
|
115
|
+
* 旧实现只存 tools 哈希,看不见这类差异。
|
|
116
|
+
*/
|
|
117
|
+
private lastRequestPrefix;
|
|
101
118
|
constructor(config?: DefaultContextEngineConfig);
|
|
102
119
|
/**
|
|
103
120
|
* 组装上下文
|
|
@@ -143,6 +160,20 @@ export declare class DefaultContextEngine implements ContextEngine {
|
|
|
143
160
|
* @returns messages 口径 token 估算
|
|
144
161
|
*/
|
|
145
162
|
private measureRequestViewTokens;
|
|
163
|
+
/**
|
|
164
|
+
* 报告尺(rawRequestViewTokens,M3 统一):**请求形状 messages(fold+老化)+ system + tools**
|
|
165
|
+
* 的未校准全请求估算。manual/proactive/overflow 的 compact 对 tokensBefore/After 与
|
|
166
|
+
* contextSize 快照同式(一处公式,禁止手抄分叉——旧 auto 口径 messages-only 缺
|
|
167
|
+
* system/tools,报出来比顶栏永远少一截,M3)。
|
|
168
|
+
*
|
|
169
|
+
* @param view - fold 视图(未老化原文形态)
|
|
170
|
+
* @param systemPrompt - 同形 system(缺省按空串)
|
|
171
|
+
* @param tools - 请求工具面(缺省按空)
|
|
172
|
+
* @param agingPlan - 老化计划(与真实请求同式)
|
|
173
|
+
* @param raw - 未校准估算器(报告尺单位,不乘 ratio)
|
|
174
|
+
* @returns 全请求口径 token 估算
|
|
175
|
+
*/
|
|
176
|
+
private reportRequestTokens;
|
|
146
177
|
/**
|
|
147
178
|
* 摘要请求的回声比对源(P2):前缀去掉既有压缩占位。
|
|
148
179
|
*
|
|
@@ -228,8 +259,7 @@ export declare class DefaultContextEngine implements ContextEngine {
|
|
|
228
259
|
summarize?: SummarizeFunction;
|
|
229
260
|
compactTargetTokens?: number;
|
|
230
261
|
/** 缓存前缀:会话同形 system+history */
|
|
231
|
-
|
|
232
|
-
/** 同形前缀原料:与会话请求同源的 systemPrompt(tools 文档随 system 文本);无 llmPrefix 时引擎内建 */
|
|
262
|
+
/** 同形前缀原料:与会话请求同源的 systemPrompt(工具面随它同批产出,不可单独传) */
|
|
233
263
|
systemPrompt?: string;
|
|
234
264
|
tools?: LLMToolDefinition[];
|
|
235
265
|
/** task 快照:交接式摘要指令尾部注入 */
|
|
@@ -241,6 +271,17 @@ export declare class DefaultContextEngine implements ContextEngine {
|
|
|
241
271
|
emit?: ContextEmitFn;
|
|
242
272
|
/** 旧压缩快照读口(迁移输入;缺省不迁移) */
|
|
243
273
|
loadCompactState?: (sessionId: string) => Promise<ContextCompactSnapshot | undefined> | ContextCompactSnapshot | undefined;
|
|
274
|
+
/**
|
|
275
|
+
* 老化策略:摘要前缀的 messages 半区必须与会话请求逐字节同源。
|
|
276
|
+
*
|
|
277
|
+
* 缺省时摘要视图退回默认机械指针,而会话请求用 per-tool ager →
|
|
278
|
+
* 同一条工具结果两种形态,前缀从第一条起分叉、缓存 0 命中
|
|
279
|
+
* (2026-11-13 生产实测:678 个共同结果中 515 个(76%)形态不同)。
|
|
280
|
+
*/
|
|
281
|
+
toolAgers?: ReadonlyMap<string, ToolResultAger>;
|
|
282
|
+
toolArgAgers?: ReadonlySet<string>;
|
|
283
|
+
/** run 中止信号(F1):透传至摘要/压缩调用,run abort 即取消(不写记录) */
|
|
284
|
+
signal?: AbortSignal;
|
|
244
285
|
}): Promise<CompactOutcome>;
|
|
245
286
|
/**
|
|
246
287
|
* 冻结请求级配对槽(callId 同源配对的唯一写入口,2026-11-08)。
|
|
@@ -306,9 +347,62 @@ export declare class DefaultContextEngine implements ContextEngine {
|
|
|
306
347
|
}): void;
|
|
307
348
|
ingest(_params: IngestParams): Promise<void>;
|
|
308
349
|
/**
|
|
309
|
-
*
|
|
350
|
+
* 工具面指纹(按数组引用记忆,NIT-9)。
|
|
351
|
+
*
|
|
352
|
+
* sha1(JSON.stringify(tools)) 在每个 LLM step 的 assemble 出口都会跑一次;工具面
|
|
353
|
+
* 在一步之内几乎总是不变的同一实例,按引用复用可把常态成本降到一次比较。
|
|
354
|
+
*
|
|
355
|
+
* @param tools - 工具面
|
|
356
|
+
* @returns 哈希(16 位)
|
|
357
|
+
*/
|
|
358
|
+
private toolsHashOf;
|
|
359
|
+
/**
|
|
360
|
+
* 摘要前缀工具面校验(可观测护栏,2026-11-12)。
|
|
361
|
+
*
|
|
362
|
+
* tools 在会话生命周期内近乎不变;摘要请求的 toolsHash 与最近一次会话请求不同,
|
|
363
|
+
* 就说明前缀从第一字节断开,缓存必然 miss。这里只告警不断言——摘要前缀与「当前」
|
|
364
|
+
* 请求本就可能不同(折叠阶梯是逐轮追加的),但工具面不该变。
|
|
365
|
+
*
|
|
366
|
+
* @param stateKey - 引擎状态键(sessionId + agentId,与 compactStateKey 同源)
|
|
367
|
+
* @param tools - 摘要请求即将使用的工具面
|
|
368
|
+
* @returns 无(异常情况打印告警)
|
|
369
|
+
*/
|
|
370
|
+
/**
|
|
371
|
+
* 记录「最近一次会话请求」的前缀基线(唯一实现)
|
|
372
|
+
*
|
|
373
|
+
* 三处调用点(两个 assemble 出口 + buildRequestView 的默认分支)都经此,
|
|
374
|
+
* 禁止各自手写 set 体:2026-11-13 一轮里同一段 set 体曾出现三份,
|
|
375
|
+
* 正是「改一边忘另一边」的形状(CON E8)。
|
|
376
|
+
*
|
|
377
|
+
* 摘要路径**不得**调用:它会把自己的指纹写成基线,护栏随即永远一致。
|
|
378
|
+
*
|
|
379
|
+
* @param stateKey - 引擎状态键(与 compactStateKey 同源)
|
|
380
|
+
* @param view - 会话请求前缀(messages 必须已是老化后的 LLM 形态)
|
|
381
|
+
*/
|
|
382
|
+
private recordSessionRequest;
|
|
383
|
+
private checkSummaryToolFace;
|
|
384
|
+
private checkSummaryPrefix;
|
|
385
|
+
/**
|
|
386
|
+
* 构建**请求视图**:前缀的 messages 与 tools 同批产出(缓存前缀的原子单位)。
|
|
387
|
+
*
|
|
388
|
+
* 会话请求与摘要请求(proactive / manual)都经此产出前缀。这样"改装配逻辑忘了一边"
|
|
389
|
+
* 在结构上不可能发生:没有哪条路径能只拿到 messages 或只拿到 tools。
|
|
390
|
+
*
|
|
391
|
+
* @param input.messages - 已折叠的视图(领域消息)
|
|
392
|
+
* @param input.systemPrompt - 会话托管 system 文本(逐字取自上一轮请求,不重建)
|
|
393
|
+
* @param input.tools - 已解析的工具面(调用方与 run 同源解析,禁自行拼装)
|
|
394
|
+
* @param input.aging - 老化计划(上游决策;此处不重新推导,避免静默推进)
|
|
395
|
+
* @returns 请求视图
|
|
396
|
+
*/
|
|
397
|
+
private buildRequestView;
|
|
398
|
+
/**
|
|
399
|
+
* 构建 LLM 消息格式(前缀的 messages 半区)
|
|
310
400
|
*
|
|
311
|
-
*
|
|
401
|
+
* 注意:这里刻意**不接受 tools**。缓存前缀的原子产物是 `RequestView`
|
|
402
|
+
* (messages + tools 同批产出,见 core `RequestView`);一个收了 tools 却不用的参数
|
|
403
|
+
* 会让读者误以为「视图=system+messages+tools」,2026-11-12 的前缀缓存事故正是这样
|
|
404
|
+
* 发生的(摘要请求看着"同形",实际整包 tools 缺失)。
|
|
405
|
+
* 需要成对产出时请用 {@link buildRequestView}。
|
|
312
406
|
*/
|
|
313
407
|
private buildLlmMessages;
|
|
314
408
|
/**
|