@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
|
@@ -55,12 +55,12 @@ export class DefaultRunGuard {
|
|
|
55
55
|
this.checkpointCount++;
|
|
56
56
|
let verdict;
|
|
57
57
|
// ── 可选资源兜底(默认关闭;总闸归 ResourceBudget) ──
|
|
58
|
-
if (this.config.hardLimit !== undefined && context.
|
|
58
|
+
if (this.config.hardLimit !== undefined && context.steps >= this.config.hardLimit) {
|
|
59
59
|
verdict = {
|
|
60
60
|
action: 'stop',
|
|
61
61
|
failureKind: 'burn',
|
|
62
|
-
reason: `硬上限触发:已运行 ${context.
|
|
63
|
-
userMessage: `任务已运行 ${context.
|
|
62
|
+
reason: `硬上限触发:已运行 ${context.steps} 轮(上限 ${this.config.hardLimit})`,
|
|
63
|
+
userMessage: `任务已运行 ${context.steps} 轮,达到安全上限。如需继续,请优化任务后重新开始。`,
|
|
64
64
|
};
|
|
65
65
|
}
|
|
66
66
|
else if (this.config.hardWallClockMs !== undefined &&
|
|
@@ -109,7 +109,7 @@ export class DefaultRunGuard {
|
|
|
109
109
|
recoveryActions: actions,
|
|
110
110
|
nextCheckpointIn: highSeverity.length > 0
|
|
111
111
|
? this.config.minCheckpointInterval
|
|
112
|
-
: Math.max(this.config.minCheckpointInterval, Math.floor(context.
|
|
112
|
+
: Math.max(this.config.minCheckpointInterval, Math.floor(context.steps * 0.5) || this.config.minCheckpointInterval),
|
|
113
113
|
};
|
|
114
114
|
}
|
|
115
115
|
}
|
|
@@ -146,7 +146,7 @@ export class DefaultRunGuard {
|
|
|
146
146
|
return verdict;
|
|
147
147
|
}
|
|
148
148
|
normalVerdict(context) {
|
|
149
|
-
const next = Math.min(this.config.maxCheckpointInterval, Math.max(this.config.minCheckpointInterval, Math.floor(context.
|
|
149
|
+
const next = Math.min(this.config.maxCheckpointInterval, Math.max(this.config.minCheckpointInterval, Math.floor(context.steps * 1.2) || this.config.checkpointInterval));
|
|
150
150
|
return {
|
|
151
151
|
action: 'continue',
|
|
152
152
|
reason: '正常运行',
|
|
@@ -310,7 +310,7 @@ export class DefaultRunGuard {
|
|
|
310
310
|
//
|
|
311
311
|
// - 旧规则 5 的两个分支都不生效:`low` 没有任何消费方(裁决只取 high/medium);
|
|
312
312
|
// `medium` 要求 `noopStreak >= 3`,而 run-agent 在 `consecutiveNoops >= noopThreshold`
|
|
313
|
-
// 时已设置 `_noopLoopStop` 并发出可见停止事件,`
|
|
313
|
+
// 时已设置 `_noopLoopStop` 并发出可见停止事件,`shouldStopAfterStep` 直接结束 turn,
|
|
314
314
|
// 本规则只是重复判定,还会多注入一条 hint、污染 recoveryHistory。
|
|
315
315
|
//
|
|
316
316
|
// 结论:真正需要 Guard 的异常只有三类——同参同结果(无进展循环)、同参同错误(没换方法)、
|
|
@@ -338,7 +338,7 @@ export class DefaultRunGuard {
|
|
|
338
338
|
const recoveryLine = ctx.recoveryHistory && ctx.recoveryHistory.length > 0
|
|
339
339
|
? `\n最近恢复尝试:\n${ctx.recoveryHistory
|
|
340
340
|
.slice(-5)
|
|
341
|
-
.map((h, i) => ` ${i + 1}. [iter ${h.
|
|
341
|
+
.map((h, i) => ` ${i + 1}. [iter ${h.steps}] ${h.actionType}${h.failureKind ? ` (${h.failureKind})` : ''}: ${h.reason}`)
|
|
342
342
|
.join('\n')}`
|
|
343
343
|
: '';
|
|
344
344
|
const signalsLine = ctx.externalSignals && ctx.externalSignals.length > 0
|
|
@@ -352,7 +352,7 @@ export class DefaultRunGuard {
|
|
|
352
352
|
${summaryText}${taskLine}${recoveryLine}${signalsLine}
|
|
353
353
|
|
|
354
354
|
当前指标:
|
|
355
|
-
- 迭代次数: ${ctx.
|
|
355
|
+
- 迭代次数: ${ctx.steps}
|
|
356
356
|
- 连续错误: ${ctx.metrics.consecutiveErrors}
|
|
357
357
|
- 连续同一错误: ${ctx.metrics.consecutiveIdenticalFailures ?? '(未提供)'}
|
|
358
358
|
- 工具失败率: ${(ctx.metrics.toolFailureRate * 100).toFixed(0)}%(窗口 ${ctx.metrics.toolCallsInWindow ?? '?'} 次)
|
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
*/
|
|
11
11
|
import type { Message } from '@octopi-agent/core/types.js';
|
|
12
12
|
import type { ToolFileEffects } from '@octopi-agent/core/types/tools.js';
|
|
13
|
+
import type { ToolPolicy } from '@octopi-agent/core/types/agent-definition.js';
|
|
13
14
|
import type { ToolIsolationMode } from '../extension/execution-environment/isolation.js';
|
|
14
15
|
/** 工具执行时可见的 Run 运行时上下文 */
|
|
15
16
|
export interface RunToolRuntime {
|
|
@@ -42,6 +43,8 @@ export interface RunToolRuntime {
|
|
|
42
43
|
homeWrite?: boolean;
|
|
43
44
|
/** Run-level securityDegraded hook */
|
|
44
45
|
noteSecurityDegraded?: (reason: string) => void;
|
|
46
|
+
/** 人类输入等待回传(预算 wall-clock 扣减);由 run-agent 挂接 per-run Budget */
|
|
47
|
+
noteHumanWait?: (ms: number) => void;
|
|
45
48
|
/** ops 审计回传(ops P2):动作/越权写入 → 统一审计账本 */
|
|
46
49
|
recordOpsEvent?: (record: {
|
|
47
50
|
event: string;
|
|
@@ -104,10 +107,7 @@ export interface RunToolRuntime {
|
|
|
104
107
|
*/
|
|
105
108
|
sessionRights?: import('../governance/session-acl/types.js').EffectiveSessionRights;
|
|
106
109
|
/** SEC-2 static agent tool policy (agents[].tools) */
|
|
107
|
-
agentToolPolicy?:
|
|
108
|
-
allow?: string[];
|
|
109
|
-
deny?: string[];
|
|
110
|
-
};
|
|
110
|
+
agentToolPolicy?: ToolPolicy;
|
|
111
111
|
}
|
|
112
112
|
/** 一次 Run 的作用域身份(I1) */
|
|
113
113
|
export interface RunScope {
|
|
@@ -118,8 +118,35 @@ export interface RunScope {
|
|
|
118
118
|
* 由 Runner 在组装 RunScope 时生成;Observer/审计共用,不另造第二套 ID。
|
|
119
119
|
*/
|
|
120
120
|
runId?: string;
|
|
121
|
+
/** Read-only Host Principal; supplied by the caller, never by a plugin. */
|
|
122
|
+
principal?: {
|
|
123
|
+
actorId?: string;
|
|
124
|
+
actorType?: string;
|
|
125
|
+
tenantId?: string;
|
|
126
|
+
};
|
|
127
|
+
/** Current effective input, used by extension attribution and collection. */
|
|
128
|
+
prompt?: string;
|
|
129
|
+
/** Host-owned per-Run model snapshot; plugin transforms must use the Host resolver. */
|
|
130
|
+
resolvedModel?: import('./model/types.js').ResolvedModel;
|
|
131
|
+
/** Host-only allowlist resolver for iteration model transforms. */
|
|
132
|
+
resolveConfiguredModel?: (selection: {
|
|
133
|
+
provider: string;
|
|
134
|
+
model: string;
|
|
135
|
+
}) => import('./model/types.js').ResolvedModel | null;
|
|
136
|
+
thinkingLevel?: import('@octopi-agent/core/types.js').ThinkingLevel;
|
|
137
|
+
extensionSnapshotBudgetTokens?: number;
|
|
138
|
+
iteration?: number;
|
|
121
139
|
/** 本轮 systemPrompt 装配结果;供 convertToLlm / 层装配 */
|
|
122
140
|
systemPrompt?: string;
|
|
141
|
+
/**
|
|
142
|
+
* 本 Run 实际发送的工具清单(与 loop 的 toolDefs 同源 = run 级 AgentContext.tools)。
|
|
143
|
+
* 估算与请求必须量同一集合(F1-B3「尺子与作用域同源」):convertToLlm 若回退
|
|
144
|
+
* 实例级 agent.context.tools,会话过滤面不同会产出系统性错位估算(2026-11-07:
|
|
145
|
+
* 委派子会话首步实测 23,811 / 估算 5,643,毒对进台账后被锚外推放大 5.4×)。
|
|
146
|
+
* M-6:实现须**活读**(getter 读 run context 当前 tools)——beforeStep 可替换
|
|
147
|
+
* tools 数组,快照会让估算与请求在 run 中途分叉;回退链止于「无 tools = 0 个」。
|
|
148
|
+
*/
|
|
149
|
+
tools?: import('@octopi-agent/core/loop/types.js').AgentTool[];
|
|
123
150
|
/**
|
|
124
151
|
* turn 级 Knowledge grounding(arch/knowledge-layer.md §4.4)。
|
|
125
152
|
* 内容命中不进 system;消息侧插槽 source='knowledgeGrounding'。
|
|
@@ -135,6 +162,12 @@ export interface RunScope {
|
|
|
135
162
|
toolRuntime?: RunToolRuntime;
|
|
136
163
|
/** Agent 模板 revision(Reserved:AgentRevision 绑 Run) */
|
|
137
164
|
agentRevision?: string;
|
|
165
|
+
/**
|
|
166
|
+
* 交接式摘要素材的活来源(F8R-05):惰性渲染当前会话 task 快照。
|
|
167
|
+
* 装配/摘要时现取——session.tasks 与 SessionTaskService attachSession 是同一
|
|
168
|
+
* 内存对象,run 内任务变更即刻可见;避免自动压缩用注入历史里的旧副本。
|
|
169
|
+
*/
|
|
170
|
+
taskSnapshot?: () => string;
|
|
138
171
|
}
|
|
139
172
|
/**
|
|
140
173
|
* 生成与 RunScope 对齐的 runId(含 sessionId/agentId,可读且可排序)
|
|
@@ -18,6 +18,7 @@ type TypedSessionStore = SessionStore<SessionData>;
|
|
|
18
18
|
import type { Agent } from './agent/index.js';
|
|
19
19
|
import type { HarnessLoopEvent } from './reliability/harness-events.js';
|
|
20
20
|
import type { ReliabilityHarness } from './reliability/run-agent.js';
|
|
21
|
+
import { type OpsAuditEvent } from '../extension/execution-environment/ops-audit.js';
|
|
21
22
|
import type { SessionTaskService } from '../session/tasks/service.js';
|
|
22
23
|
import type { SessionInboxEntry, SessionInboxBinding } from '../activation/inbox.js';
|
|
23
24
|
import { type ToolIsolationMode } from '../extension/execution-environment/isolation.js';
|
|
@@ -147,13 +148,20 @@ export interface SessionAwareRunnerConfig {
|
|
|
147
148
|
/** credentials.requireBindings(SEC-3c):无绑定凭证不可 resolve */
|
|
148
149
|
requireCredentialBindings?: boolean;
|
|
149
150
|
confirmEffect?: import("../extension/execution-environment/effect-policy.js").ConfirmEffect;
|
|
151
|
+
/** 附件轻量意图分流的默认 provider(仅无 Gateway 模型快照时回退)。 */
|
|
152
|
+
defaultIntentProvider?: import('@octopi-agent/core/interfaces/model-provider.js').ModelProvider;
|
|
150
153
|
/** 附件注入参数(knowledge.attachments.inject;缺省用内建默认) */
|
|
151
154
|
sessionAttachmentInject?: {
|
|
152
155
|
fullTextMaxChars?: number;
|
|
156
|
+
recallTopK?: number;
|
|
153
157
|
intent?: 'llm' | 'off';
|
|
154
158
|
intentTimeoutMs?: number;
|
|
155
159
|
emptyMessagePrompt?: string;
|
|
156
160
|
};
|
|
161
|
+
/** Budget for plugin Runtime snapshot contributions; never part of systemPrompt. */
|
|
162
|
+
extensionSnapshotBudgetTokens?: number;
|
|
163
|
+
/** Host-owned narrow extension boundary; no plugin registry enters Runner. */
|
|
164
|
+
extensionHooks?: import('../extension/plugin-ecosystem/hooks/types.js').ExtensionHookPort;
|
|
157
165
|
/**
|
|
158
166
|
* 事件旁路(Telemetry)。每条适配后事件调用(含 llm_stream_delta),
|
|
159
167
|
* 不改变 yield 语义。由 Builder 注入 RunTelemetry.onEvent。
|
|
@@ -164,7 +172,7 @@ export interface SessionAwareRunnerConfig {
|
|
|
164
172
|
}) => void;
|
|
165
173
|
}
|
|
166
174
|
/**
|
|
167
|
-
* 失败凭证消息中附带残句的截断上限(显示用途;完整残句在带 error 标记的
|
|
175
|
+
* 失败凭证消息中附带残句的截断上限(显示用途;完整残句在带 error 标记的 step 账本)
|
|
168
176
|
*
|
|
169
177
|
* 展示型截断,与 wire-dump 的消息截断同性质——不是部署可变参数,故不进配置。
|
|
170
178
|
*/
|
|
@@ -180,10 +188,11 @@ export interface RunConfig {
|
|
|
180
188
|
model?: string;
|
|
181
189
|
/** model 为裸名时的 provider 缺省 */
|
|
182
190
|
modelProvider?: string;
|
|
183
|
-
temperature?: number;
|
|
184
191
|
cwd?: string;
|
|
185
192
|
/** 本次 Run 的工具隔离覆盖(缺省用 Runner 配置 / DEFAULT_TOOL_ISOLATION) */
|
|
186
193
|
toolIsolation?: ToolIsolationMode;
|
|
194
|
+
/** Caller identity forwarded from the real RunRequest; not a plugin-provided claim. */
|
|
195
|
+
principal?: import('../extension/plugin-ecosystem/hooks/types.js').ExtensionHookContext['principal'];
|
|
187
196
|
/** Agent 模板 revision 绑 Run(Reserved:AgentRevision);写入 RunScope / 审计 */
|
|
188
197
|
agentRevision?: string;
|
|
189
198
|
contextWindow?: number;
|
|
@@ -223,9 +232,9 @@ export declare function adaptLoopEvent(event: HarnessLoopEvent, meta: {
|
|
|
223
232
|
* 失败轮的正文只能来自这里——不得回落到上一次调用的完整回复冒充本次输出。
|
|
224
233
|
*/
|
|
225
234
|
callStreamedContent?: string;
|
|
226
|
-
/** 最近一次 turn_end 的正文快照与错误标记,供 runner 落
|
|
227
|
-
|
|
228
|
-
|
|
235
|
+
/** 最近一次 turn_end 的正文快照与错误标记,供 runner 落 step 账本 */
|
|
236
|
+
lastStepContent?: string;
|
|
237
|
+
lastStepError?: boolean;
|
|
229
238
|
/** `agent_end.reason='error'` 时的错误文本,收口落失败凭证 */
|
|
230
239
|
errorMessage?: string;
|
|
231
240
|
lastUserContent?: string;
|
|
@@ -319,6 +328,8 @@ export declare class SessionAwareRunner {
|
|
|
319
328
|
private groundingAssembler?;
|
|
320
329
|
/** 模型快照解析器(Gateway 注入;每 run 只调一次) */
|
|
321
330
|
private resolveModelOverride?;
|
|
331
|
+
/** 无 Gateway 快照时,附件轻量意图分流回退到 Builder 的当前会话 provider。 */
|
|
332
|
+
private defaultIntentProvider?;
|
|
322
333
|
constructor(agent: Agent, harness: ReliabilityHarness, store: TypedSessionStore, config?: SessionAwareRunnerConfig & {
|
|
323
334
|
events?: import('@octopi-agent/core/primitives/event-bus.js').EventBus;
|
|
324
335
|
});
|
|
@@ -330,8 +341,24 @@ export declare class SessionAwareRunner {
|
|
|
330
341
|
*
|
|
331
342
|
* @param event - §7 事件词表
|
|
332
343
|
* @param data - 事件载荷(hash 走 canonicalJson,键序无关)
|
|
344
|
+
* @param opts.ignoreRunOverride - true = 忽略 run 级 effectOpsAudit 粘滞值
|
|
345
|
+
* (准入拒绝发生在 run 起点之前,不受上一轮 run 的 opsAudit:'off' 影响)
|
|
333
346
|
*/
|
|
334
347
|
private recordOpsAudit;
|
|
348
|
+
/**
|
|
349
|
+
* 对外 ops 记账口(账本 + 观测双写)——run 准入拒绝等发生在 Runner 执行流之外、
|
|
350
|
+
* 但属同一 ops 语义面的事件(如 gateway 侧 knowledge.required 闸门)用它对齐
|
|
351
|
+
* `ops.config.security_changed` / `ops.kill_switch.tripped` 的三件套待遇。
|
|
352
|
+
* (不叫 recordOpsEvent:与工具上下文的同名回调(仅账本)区分。)
|
|
353
|
+
*
|
|
354
|
+
* @param event - §7 事件词表
|
|
355
|
+
* @param data - 事件载荷(hash 走 canonicalJson,入账本)
|
|
356
|
+
* @param origin - 触发者锚点(观测事件的 agentId/sessionId;账本锚未落定时补锚)
|
|
357
|
+
*/
|
|
358
|
+
recordAdmissionRefusal(event: OpsAuditEvent, data: Record<string, unknown>, origin: {
|
|
359
|
+
agentId: string;
|
|
360
|
+
sessionId: string;
|
|
361
|
+
}): void;
|
|
335
362
|
/** 外送收口(懒建;仅配置了宿主侧收口路径时启用) */
|
|
336
363
|
private resolveOpsExporter;
|
|
337
364
|
/**
|
|
@@ -477,34 +504,22 @@ export declare class SessionAwareRunner {
|
|
|
477
504
|
sessionId: string;
|
|
478
505
|
agentId: string;
|
|
479
506
|
messages: Message[];
|
|
480
|
-
summarize?:
|
|
481
|
-
maxTokens?: number;
|
|
482
|
-
}) => Promise<string>;
|
|
507
|
+
summarize?: import('../context/types.js').SummarizeFunction;
|
|
483
508
|
compactTargetTokens?: number;
|
|
484
509
|
/** task 快照:交接式摘要指令尾部注入 */
|
|
485
510
|
taskSnapshot?: string;
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
/** 摘要覆盖终点(tailStart,不含) */
|
|
494
|
-
coveredMessageCount?: number;
|
|
495
|
-
}>;
|
|
496
|
-
summarize?: (messages: import('@octopi-agent/core/interfaces/model-provider.js').LLMMessage[], opts?: {
|
|
497
|
-
maxTokens?: number;
|
|
498
|
-
}) => Promise<string>;
|
|
511
|
+
/** 请求口径计量原料(2026-11-08 B1):与会话下一请求同源的 system/tools */
|
|
512
|
+
systemPrompt?: string;
|
|
513
|
+
tools?: import('@octopi-agent/core/interfaces/model-provider.js').LLMToolDefinition[];
|
|
514
|
+
/** 旧压缩快照读口(迁移输入) */
|
|
515
|
+
loadCompactState?: (sessionId: string) => Promise<import('../context/types.js').ContextCompactSnapshot | undefined> | import('../context/types.js').ContextCompactSnapshot | undefined;
|
|
516
|
+
}) => Promise<import('../context/capabilities/compact/types.js').CompactOutcome>;
|
|
517
|
+
summarize?: import('../context/types.js').SummarizeFunction;
|
|
499
518
|
compactTargetTokens?: number;
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
tokensBefore: number;
|
|
505
|
-
tokensAfter?: number;
|
|
506
|
-
summary?: string;
|
|
507
|
-
}>;
|
|
519
|
+
/** 请求口径计量原料(2026-11-08 B1):透传给 compactStructural */
|
|
520
|
+
systemPrompt?: string;
|
|
521
|
+
tools?: import('@octopi-agent/core/interfaces/model-provider.js').LLMToolDefinition[];
|
|
522
|
+
}): Promise<import('../context/capabilities/compact/types.js').CompactTransportOutcome>;
|
|
508
523
|
/**
|
|
509
524
|
* 获取 Session 锁(经 SessionLease;E2 键 = sessionId)
|
|
510
525
|
*
|