@octopi-agent/engine 0.98.4 → 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 +40 -6
- package/dist/config-schema/agent.js +44 -6
- package/dist/config-schema/browser.d.ts +62 -0
- package/dist/config-schema/browser.js +89 -0
- package/dist/config-schema/context.d.ts +12 -37
- package/dist/config-schema/context.js +10 -31
- package/dist/config-schema/engine.d.ts +140 -164
- package/dist/config-schema/engine.js +10 -7
- package/dist/config-schema/governance.d.ts +20 -2
- package/dist/config-schema/governance.js +18 -3
- package/dist/config-schema/models.d.ts +10 -12
- package/dist/config-schema/models.js +16 -3
- package/dist/config-schema/run.d.ts +6 -2
- package/dist/config-schema/run.js +12 -2
- package/dist/config-schema/shared.d.ts +1 -3
- package/dist/config-schema/shared.js +4 -4
- package/dist/config-schema/substrate.d.ts +19 -88
- package/dist/config-schema/substrate.js +30 -107
- package/dist/config.d.ts +161 -123
- package/dist/config.js +109 -7
- 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 +11 -0
- package/dist/harness/activation/inbox.d.ts +3 -3
- package/dist/harness/activation/inbox.js +3 -3
- 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 +130 -31
- package/dist/harness/activation/types.d.ts +20 -3
- package/dist/harness/agent/builder.d.ts +36 -3
- package/dist/harness/agent/builder.js +206 -46
- package/dist/harness/agent/config-bridge.d.ts +10 -1
- package/dist/harness/agent/config-bridge.js +24 -5
- package/dist/harness/agent/config-integrity.js +19 -2
- 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 +13 -3
- package/dist/harness/agent/wire-agent-builder.js +35 -9
- package/dist/harness/capabilities/document/backends/plain.js +2 -1
- package/dist/harness/capabilities/document/factory.d.ts +5 -0
- package/dist/harness/capabilities/document/factory.js +1 -0
- package/dist/harness/capabilities/document/legacy/factory.js +3 -2
- 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/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 +2 -1
- 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 +14 -4
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +50 -41
- 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 +4 -1
- package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +7 -3
- package/dist/harness/collaboration/delegation/child-run.d.ts +10 -1
- package/dist/harness/collaboration/delegation/child-run.js +38 -6
- 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/registry-types.d.ts +2 -0
- package/dist/harness/collaboration/delegation/service.d.ts +11 -4
- package/dist/harness/collaboration/delegation/service.js +35 -13
- package/dist/harness/collaboration/delegation/store.d.ts +4 -0
- package/dist/harness/collaboration/delegation/store.js +3 -1
- package/dist/harness/collaboration/delegation/types.d.ts +34 -2
- package/dist/harness/collaboration/delegation/types.js +22 -0
- package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
- package/dist/harness/collaboration/delegation/wiring.js +12 -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 +44 -11
- package/dist/harness/context/capabilities/compact/engine.js +296 -160
- 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 +7 -2
- package/dist/harness/context/capabilities/compact/index.js +5 -1
- 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 +134 -19
- 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/gate.d.ts +19 -2
- package/dist/harness/context/capabilities/summary/gate.js +53 -6
- package/dist/harness/context/capabilities/summary/port.js +0 -1
- package/dist/harness/context/capabilities/summary/registry.js +20 -0
- 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/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 +19 -6
- package/dist/harness/context/constitution/default-agents.md +85 -0
- package/dist/harness/context/context-size-ledger.d.ts +143 -0
- package/dist/harness/context/context-size-ledger.js +243 -0
- package/dist/harness/context/default-context-engine.d.ts +290 -120
- package/dist/harness/context/default-context-engine.js +1555 -764
- package/dist/harness/context/index.d.ts +3 -2
- package/dist/harness/context/index.js +2 -1
- 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 +72 -0
- package/dist/harness/context/layer-types.js +87 -2
- package/dist/harness/context/layers.d.ts +17 -15
- package/dist/harness/context/layers.js +54 -17
- package/dist/harness/context/message-selector.d.ts +10 -8
- package/dist/harness/context/message-selector.js +49 -27
- package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
- package/dist/harness/context/prefix-fingerprint.js +52 -0
- package/dist/harness/context/summarize.d.ts +2 -2
- package/dist/harness/context/summarize.js +27 -2
- package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
- package/dist/harness/context/system-prompt-assembler.js +7 -3
- 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 +109 -16
- package/dist/harness/context/tool-result-aging.js +220 -55
- 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 +196 -119
- 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/ops-audit.d.ts +1 -1
- package/dist/harness/extension/execution-environment/privileged-exec.js +4 -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/execution-environment/workspace.js +1 -1
- package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +28 -2
- 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/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/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 +223 -222
- package/dist/harness/extension/plugin-ecosystem/plugins/api.js +218 -203
- 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 +78 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +80 -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 +57 -114
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +279 -282
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +46 -484
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +123 -345
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +50 -223
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +144 -20
- package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +17 -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/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 +36 -8
- 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/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 +19 -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/accounting/usage-ledger.d.ts +13 -1
- package/dist/harness/governance/accounting/usage-ledger.js +23 -1
- 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/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/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/capability-enforcer.js +1 -2
- 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 +17 -15
- package/dist/harness/index.js +9 -9
- package/dist/harness/knowledge/boot-config.d.ts +57 -0
- package/dist/harness/knowledge/boot-config.js +52 -0
- package/dist/harness/knowledge/catalog-types.d.ts +2 -0
- package/dist/harness/knowledge/client.d.ts +77 -9
- package/dist/harness/knowledge/client.js +95 -24
- package/dist/harness/knowledge/db.d.ts +16 -0
- package/dist/harness/knowledge/db.js +112 -41
- 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 +11 -7
- package/dist/harness/knowledge/grounding.js +7 -2
- package/dist/harness/knowledge/http-app.d.ts +15 -0
- package/dist/harness/knowledge/http-app.js +117 -25
- package/dist/harness/knowledge/http-bridge.d.ts +15 -0
- package/dist/harness/knowledge/http-bridge.js +19 -0
- 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 +5 -3
- package/dist/harness/knowledge/purge.js +5 -2
- package/dist/harness/knowledge/query-service.d.ts +25 -4
- package/dist/harness/knowledge/query-service.js +79 -43
- package/dist/harness/knowledge/query-worker-client.d.ts +14 -2
- package/dist/harness/knowledge/query-worker-client.js +8 -3
- package/dist/harness/knowledge/query-worker.js +9 -5
- package/dist/harness/knowledge/read-http.d.ts +2 -0
- package/dist/harness/knowledge/read-http.js +14 -3
- package/dist/harness/knowledge/retriever.d.ts +1 -1
- package/dist/harness/knowledge/retriever.js +1 -2
- package/dist/harness/knowledge/serve.d.ts +14 -8
- package/dist/harness/knowledge/serve.js +14 -6
- package/dist/harness/knowledge/source-store.d.ts +101 -5
- package/dist/harness/knowledge/source-store.js +323 -74
- package/dist/harness/knowledge/start-service-process.d.ts +41 -14
- package/dist/harness/knowledge/start-service-process.js +67 -96
- package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
- package/dist/harness/knowledge/tenant-gate.js +167 -0
- package/dist/harness/knowledge/types.d.ts +7 -0
- package/dist/harness/knowledge/writer-service.d.ts +55 -11
- package/dist/harness/knowledge/writer-service.js +200 -30
- package/dist/harness/knowledge/writer-worker-client.d.ts +19 -11
- package/dist/harness/knowledge/writer-worker-client.js +40 -5
- package/dist/harness/knowledge/writer-worker.js +20 -5
- 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/sqlite/wisdom-store.js +35 -10
- package/dist/harness/memory/types.d.ts +24 -6
- 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.d.ts +10 -0
- package/dist/harness/observability/observer/hub.js +120 -17
- 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 +67 -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/concurrency/tool-validator.js +4 -3
- 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 +32 -4
- package/dist/harness/run/reliability/run-agent.js +216 -63
- 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-host.d.ts +302 -0
- package/dist/harness/run/run-host.js +978 -0
- package/dist/harness/run/run-scope.d.ts +48 -4
- package/dist/harness/run/run-scope.js +19 -1
- package/dist/harness/run/runner.d.ts +181 -39
- package/dist/harness/run/runner.js +654 -119
- 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/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/transform-store.d.ts +136 -0
- package/dist/harness/session/transform-store.js +302 -0
- package/dist/harness/session/types.d.ts +11 -15
- package/dist/harness/shared/events/agent-event-map.d.ts +75 -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 +7 -2
- package/dist/index.d.ts +16 -18
- package/dist/index.js +9 -10
- 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/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-message-normalize.d.ts +20 -0
- package/dist/integration/providers/anthropic-message-normalize.js +48 -0
- package/dist/integration/providers/anthropic.js +41 -3
- 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 +48 -2
- package/dist/integration/providers/usage.d.ts +1 -1
- package/dist/integration/providers/wire-dump-diff.js +2 -1
- package/dist/integration/providers/wire-dump.d.ts +57 -3
- package/dist/integration/providers/wire-dump.js +119 -6
- package/dist/integration/storage/archive-manager.d.ts +20 -2
- package/dist/integration/storage/archive-manager.js +34 -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 +10 -1
- package/dist/integration/storage/jsonl.js +155 -54
- 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/SUBSYSTEM.md +8 -1
- package/dist/subsystems/wisdom-steward/formation/config.yaml +4 -0
- package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
- package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
- package/package.json +14 -15
- 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
|
@@ -39,7 +39,9 @@ const RECENT_TOOLS_MAX = 10;
|
|
|
39
39
|
const TOKEN_WINDOW = 10;
|
|
40
40
|
export class RunMetricsCollector {
|
|
41
41
|
startTime = Date.now();
|
|
42
|
-
|
|
42
|
+
/** 人类输入等待累计(ask_user 等回传);elapsedMs 口径与 Budget 一致:等人不算运行 */
|
|
43
|
+
humanWaitMs = 0;
|
|
44
|
+
globalSteps = 0;
|
|
43
45
|
totalToolCalls = 0;
|
|
44
46
|
nominalTotalTokens = 0;
|
|
45
47
|
lastToolName = '';
|
|
@@ -53,25 +55,25 @@ export class RunMetricsCollector {
|
|
|
53
55
|
consecutiveIdenticalFailures = 0;
|
|
54
56
|
uniqueTools = new Set();
|
|
55
57
|
recentToolCalls = [];
|
|
56
|
-
|
|
58
|
+
stepSummaries = [];
|
|
57
59
|
tokenDeltas = [];
|
|
58
60
|
recoveryHistory = [];
|
|
59
61
|
externalSignals = [];
|
|
60
62
|
noopStreak = 0;
|
|
61
63
|
lastSuccessAt = 0;
|
|
62
64
|
lastSubstantialTextAt = 0;
|
|
63
|
-
/** 记录一轮结束(token 另经 recordTokens 从
|
|
64
|
-
|
|
65
|
-
this.
|
|
66
|
-
this.
|
|
67
|
-
if (this.
|
|
68
|
-
this.
|
|
65
|
+
/** 记录一轮结束(token 另经 recordTokens 从 step_end.usage 累加) */
|
|
66
|
+
recordStep(summary) {
|
|
67
|
+
this.globalSteps++;
|
|
68
|
+
this.stepSummaries.push(summary);
|
|
69
|
+
if (this.stepSummaries.length > SUMMARIES_MAX) {
|
|
70
|
+
this.stepSummaries = this.stepSummaries.slice(-SUMMARIES_MAX);
|
|
69
71
|
}
|
|
70
72
|
if (summary.contentPreview && summary.contentPreview.length >= 80) {
|
|
71
|
-
this.lastSubstantialTextAt = this.
|
|
73
|
+
this.lastSubstantialTextAt = this.globalSteps;
|
|
72
74
|
}
|
|
73
75
|
}
|
|
74
|
-
/** 记录本轮 token 消耗(与 Budget 共用
|
|
76
|
+
/** 记录本轮 token 消耗(与 Budget 共用 step_end.usage) */
|
|
75
77
|
recordTokens(delta) {
|
|
76
78
|
if (delta <= 0)
|
|
77
79
|
return;
|
|
@@ -79,10 +81,22 @@ export class RunMetricsCollector {
|
|
|
79
81
|
this.tokenDeltas.push(delta);
|
|
80
82
|
if (this.tokenDeltas.length > TOKEN_WINDOW)
|
|
81
83
|
this.tokenDeltas.shift();
|
|
82
|
-
const last = this.
|
|
84
|
+
const last = this.stepSummaries[this.stepSummaries.length - 1];
|
|
83
85
|
if (last)
|
|
84
86
|
last.tokenDelta += delta;
|
|
85
87
|
}
|
|
88
|
+
/**
|
|
89
|
+
* 记录人类输入等待时长(ask_user 等阻塞式人机工具回传)。
|
|
90
|
+
* Guard 的 hardWallClockMs 是 burn 阀,口径与 Budget wall-clock 对齐:等人不算运行。
|
|
91
|
+
* 累计以存续时长封顶(并行等待/超报不得把 elapsedMs 扣成 0 之外的假值)。
|
|
92
|
+
*
|
|
93
|
+
* @param ms - 本次等待时长(毫秒)
|
|
94
|
+
*/
|
|
95
|
+
addHumanWaitMs(ms) {
|
|
96
|
+
if (ms > 0) {
|
|
97
|
+
this.humanWaitMs = Math.min(this.humanWaitMs + ms, Date.now() - this.startTime);
|
|
98
|
+
}
|
|
99
|
+
}
|
|
86
100
|
/**
|
|
87
101
|
* 记录工具结果
|
|
88
102
|
*
|
|
@@ -133,7 +147,7 @@ export class RunMetricsCollector {
|
|
|
133
147
|
this.consecutiveIdenticalFailures = 0;
|
|
134
148
|
this.lastFailureFingerprint = '';
|
|
135
149
|
if (!isNoop) {
|
|
136
|
-
this.lastSuccessAt = this.
|
|
150
|
+
this.lastSuccessAt = this.globalSteps;
|
|
137
151
|
this.noopStreak = 0;
|
|
138
152
|
}
|
|
139
153
|
}
|
|
@@ -164,18 +178,18 @@ export class RunMetricsCollector {
|
|
|
164
178
|
if (this.noopStreak >= 3)
|
|
165
179
|
return false;
|
|
166
180
|
// 成功工具或实质文本出现在最近 3 轮内
|
|
167
|
-
if (this.
|
|
181
|
+
if (this.globalSteps - this.lastSuccessAt <= 3 && this.lastSuccessAt > 0)
|
|
168
182
|
return true;
|
|
169
|
-
if (this.
|
|
183
|
+
if (this.globalSteps - this.lastSubstantialTextAt <= 3 &&
|
|
170
184
|
this.lastSubstantialTextAt > 0) {
|
|
171
185
|
return true;
|
|
172
186
|
}
|
|
173
187
|
// 刚开始的 run:尚无失败堆积时视为有进展
|
|
174
|
-
if (this.
|
|
188
|
+
if (this.globalSteps <= 2 && this.consecutiveErrors === 0)
|
|
175
189
|
return true;
|
|
176
190
|
// 连续无成功且无实质文本
|
|
177
|
-
if (this.
|
|
178
|
-
this.
|
|
191
|
+
if (this.globalSteps - Math.max(this.lastSuccessAt, this.lastSubstantialTextAt) >= 3 &&
|
|
192
|
+
this.globalSteps >= 3) {
|
|
179
193
|
return false;
|
|
180
194
|
}
|
|
181
195
|
return this.consecutiveErrors === 0;
|
|
@@ -198,12 +212,13 @@ export class RunMetricsCollector {
|
|
|
198
212
|
this.externalSignals = [];
|
|
199
213
|
return s;
|
|
200
214
|
}
|
|
201
|
-
get
|
|
202
|
-
return this.
|
|
215
|
+
get steps() {
|
|
216
|
+
return this.globalSteps;
|
|
203
217
|
}
|
|
204
218
|
get tokens() {
|
|
205
219
|
return this.nominalTotalTokens;
|
|
206
220
|
}
|
|
221
|
+
/** 存续时长(含人类等待;展示/账本口径)。裁决口径见 buildContext(活跃时长) */
|
|
207
222
|
get elapsedMs() {
|
|
208
223
|
return Date.now() - this.startTime;
|
|
209
224
|
}
|
|
@@ -242,11 +257,11 @@ export class RunMetricsCollector {
|
|
|
242
257
|
return {
|
|
243
258
|
sessionId: ids.sessionId ?? 'inline',
|
|
244
259
|
agentId: ids.agentId ?? 'default',
|
|
245
|
-
|
|
260
|
+
steps: this.globalSteps,
|
|
246
261
|
totalToolCalls: this.totalToolCalls,
|
|
247
262
|
nominalTotalTokens: this.nominalTotalTokens,
|
|
248
|
-
elapsedMs: Date.now() - this.startTime,
|
|
249
|
-
recentSummaries: this.
|
|
263
|
+
elapsedMs: Math.max(0, Date.now() - this.startTime - this.humanWaitMs),
|
|
264
|
+
recentSummaries: this.stepSummaries.slice(-8),
|
|
250
265
|
metrics,
|
|
251
266
|
recoveryHistory: [...this.recoveryHistory],
|
|
252
267
|
externalSignals: this.externalSignals.map(s => ({
|
|
@@ -266,7 +281,7 @@ export class RunMetricsCollector {
|
|
|
266
281
|
return {
|
|
267
282
|
sessionId: ids.sessionId,
|
|
268
283
|
agentId: ids.agentId,
|
|
269
|
-
|
|
284
|
+
steps: this.globalSteps,
|
|
270
285
|
totalToolCalls: this.totalToolCalls,
|
|
271
286
|
nominalTotalTokens: this.nominalTotalTokens,
|
|
272
287
|
elapsedMs: Date.now() - this.startTime,
|
|
@@ -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 ?? '?'} 次)
|
|
@@ -0,0 +1,302 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* RunHost — run 实例侧执行宿主(arch/service-topology.md §4「P0b 落地形态」)。
|
|
3
|
+
*
|
|
4
|
+
* 持有 run 侧全部运行时态:挂载槽、in-flight 计数、退役回收、会话锁、准入闸门执行、
|
|
5
|
+
* 审批/客户端工具跨通道配对、compact 解析(P0a 迁移注记清偿:控制面只传键,
|
|
6
|
+
* systemPrompt/tools/摘要绑定在此从 run 侧自身状态解析)。
|
|
7
|
+
*
|
|
8
|
+
* 内核自 gateway 的 InProcessRunBackend 搬入(行为冻结;原搬迁自 gateway.ts 的
|
|
9
|
+
* agentCache/retiredRunners/runnerInflight/wrapInflightTracking/retireRunner 语义不变)。
|
|
10
|
+
* gateway 脚手架以子类形态过渡到 P0b 步骤 5 删除;远程实现(run-serve-child)直接
|
|
11
|
+
* 以本类为执行核。
|
|
12
|
+
*
|
|
13
|
+
* 语义边界(触发面/执行面分离,§5.4):本类只做执行面;触发面(AgentRuntime /
|
|
14
|
+
* TriggerSource)永远在 gateway 进程。inbox 重投等需要触发面的动作经
|
|
15
|
+
* `notify('redispatch')` 回 gateway,本类不内嵌任何常驻触发器。
|
|
16
|
+
*/
|
|
17
|
+
import type { AgentEvent } from '@octopi-agent/core/primitives/event-bus.js';
|
|
18
|
+
import type { RegisteredTool } from '@octopi-agent/core/types.js';
|
|
19
|
+
import type { ModelProvider } from '@octopi-agent/core/interfaces/model-provider.js';
|
|
20
|
+
import type { RunDispatcher, RunRequest, Trigger } from '../activation/index.js';
|
|
21
|
+
import type { RunSmokeReport } from '../activation/run-protocol.js';
|
|
22
|
+
import type { AdmissionGateResult, RunBackend, RunBackendHealth } from '../activation/run-backend.js';
|
|
23
|
+
import type { AgentDefinitionWire, RunControlOp, RunControlResponse, RunHostNotify } from '../activation/run-protocol.js';
|
|
24
|
+
import type { RunApprovalRequestInput } from '../activation/run-protocol.js';
|
|
25
|
+
import type { HitlAskResult } from '../governance/human-in-the-loop/decision-cache.js';
|
|
26
|
+
import type { SessionAwareRunner, RunConfig } from './runner.js';
|
|
27
|
+
import type { Agent } from './agent/index.js';
|
|
28
|
+
import type { ContextEngine } from '../context/types.js';
|
|
29
|
+
import type { ContextLayerHealth } from '../context/layer-health.js';
|
|
30
|
+
import type { SessionData } from '../session/types.js';
|
|
31
|
+
import type { DiscardFileEffectsResult } from '../extension/execution-environment/undo-log.js';
|
|
32
|
+
import type { SessionLease } from './concurrency/session-lease.js';
|
|
33
|
+
import type { CompactTransportOutcome } from '../context/capabilities/compact/types.js';
|
|
34
|
+
import type { ContextEmitFn } from '../context/types.js';
|
|
35
|
+
/** compact 进度事件形状(ContextEmitFn 同式;双缝出口见 onCompactEvent)——
|
|
36
|
+
* 从事件联合**派生**而非手抄字段表(评审 F-6:手抄形状会随新字段静默丢失) */
|
|
37
|
+
type CompactEmitEvent = Parameters<ContextEmitFn>[0];
|
|
38
|
+
export interface RunHostOptions {
|
|
39
|
+
/** inbox 未消费项的原 Trigger 重投路径(remote 形态:RunHostNotify.redispatch 回 gateway) */
|
|
40
|
+
redispatch: (trigger: Trigger, options?: {
|
|
41
|
+
onEvent?: (event: AgentEvent) => void;
|
|
42
|
+
}) => void | Promise<unknown>;
|
|
43
|
+
/** run 起点准入闸门;返回结果 = 拒新 run(政策在 gateway,执行在 backend) */
|
|
44
|
+
admissionGate?: (req: {
|
|
45
|
+
agentId: string;
|
|
46
|
+
sessionId: string;
|
|
47
|
+
}) => AdmissionGateResult | undefined;
|
|
48
|
+
/** 共享会话锁(缺省自建进程内锁;所有 Runner 与控制面共用同一实例) */
|
|
49
|
+
sessionLock?: SessionLease;
|
|
50
|
+
/** 宿主通知出口(remote: fork IPC;shim: 直连 gateway 处理器) */
|
|
51
|
+
notify?: (notify: RunHostNotify) => void;
|
|
52
|
+
/** compact 摘要模型解析的 provider 映射 */
|
|
53
|
+
providers?: ReadonlyMap<string, ModelProvider>;
|
|
54
|
+
/** agent 默认模型绑定(会话模型缺失时的 compact 摘要回退) */
|
|
55
|
+
resolveDefaultModel?: (agentId: string) => {
|
|
56
|
+
provider: string;
|
|
57
|
+
model: string;
|
|
58
|
+
} | undefined;
|
|
59
|
+
/** 会话 metadata 读取(compact 模型绑定来自 session.metadata.model) */
|
|
60
|
+
loadSessionMetadata?: (sessionId: string) => Promise<Record<string, unknown> | undefined>;
|
|
61
|
+
/** 请求口径计量(config.context.contextAssembler.compactTargetTokens) */
|
|
62
|
+
compactTargetTokens?: number;
|
|
63
|
+
/** compact 进度双缝出口(Hub timeline + gatewayBus→WS;remote 形态转 notify('session_event')) */
|
|
64
|
+
onCompactEvent?: (event: CompactEmitEvent) => void;
|
|
65
|
+
/** 热重建:新定义 → 新挂载 spec(本类负责退役+重挂;并发单飞在调用方) */
|
|
66
|
+
buildMountSpec?: (agentId: string, definition: AgentDefinitionWire) => Promise<RunBackendMountSpec>;
|
|
67
|
+
/**
|
|
68
|
+
* 会话写口(控制面写路径 op 用:append/truncate;写者单点 = run 节点,§3)。
|
|
69
|
+
* 缺省命中即 fail-loud。discardFileUndo 带宿主的 memoryRestorer 与 sessionsDir 解析。
|
|
70
|
+
*/
|
|
71
|
+
sessionWriter?: {
|
|
72
|
+
load(sessionId: string): Promise<SessionData | undefined>;
|
|
73
|
+
save(sessionId: string, session: SessionData): Promise<void>;
|
|
74
|
+
patchMetadata(sessionId: string, updater: (meta: Record<string, unknown>) => void): Promise<void>;
|
|
75
|
+
discardFileUndo(sessionId: string, agentId: string): Promise<DiscardFileEffectsResult>;
|
|
76
|
+
};
|
|
77
|
+
/**
|
|
78
|
+
* console 受控写后重锚定安全指纹(ops P2 §8.4;boot 纯数据自建守卫的同步缝)。
|
|
79
|
+
* 缺省命中 reattestSecurity op 即 fail-loud(守卫漂移拒 run 不变)。
|
|
80
|
+
*/
|
|
81
|
+
reattestSecurity?: (options: {
|
|
82
|
+
expectHash: string;
|
|
83
|
+
allowedChanged: string[];
|
|
84
|
+
}) => {
|
|
85
|
+
previousFingerprint: string;
|
|
86
|
+
fingerprint: string;
|
|
87
|
+
changed: string[];
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* mount 输入:构建工厂(run-assembly)产出的执行体(P1-1b 契约拆分自
|
|
92
|
+
* activation/run-backend 迁入:装配是 RunHost 自身面,不是 gateway 消费面)。
|
|
93
|
+
*
|
|
94
|
+
* @param agentId - agent id(挂载槽位键)
|
|
95
|
+
* @param agent - 构建好的 Agent 实例
|
|
96
|
+
* @param runner - 会话感知执行器(实现细节,句柄不外泄)
|
|
97
|
+
* @param contextEngine - 上下文引擎(compact 控制面用)
|
|
98
|
+
* @param contextHealth - 七层健康探针
|
|
99
|
+
* @param registerTools - 动态工具注册口
|
|
100
|
+
* @param runConfigDefaults - 执行腿缺省(agentId/contextWindow/systemPrompt;不含消息级 model 覆盖)
|
|
101
|
+
*/
|
|
102
|
+
export interface RunBackendMountSpec {
|
|
103
|
+
agentId: string;
|
|
104
|
+
agent: Agent;
|
|
105
|
+
runner: SessionAwareRunner;
|
|
106
|
+
contextEngine?: ContextEngine;
|
|
107
|
+
contextHealth?: (agentId?: string) => Promise<ContextLayerHealth>;
|
|
108
|
+
registerTools: (tools: RegisteredTool[]) => void;
|
|
109
|
+
runConfigDefaults: Partial<RunConfig>;
|
|
110
|
+
/**
|
|
111
|
+
* 脉搏注册表(P0c A′):该执行体声明的周期任务(key 实例内唯一)。
|
|
112
|
+
* RunHost 聚合到 `health().pulses` 自述;`control {type:'pulse'}` 按 key 驱动。
|
|
113
|
+
*/
|
|
114
|
+
pulses?: Array<{
|
|
115
|
+
spec: import('../activation/run-protocol.js').PulseSpec;
|
|
116
|
+
fire: () => Promise<unknown>;
|
|
117
|
+
}>;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* mount 返回:RunHost 域内句柄(进程内活引用,P1-1b 自 RunBackend 契约迁入)。
|
|
121
|
+
*
|
|
122
|
+
* 命名即边界:`InProcess` 声明这些是**进程内活引用**(Agent 实例、闭包),跨不了进程
|
|
123
|
+
* 边界。远程契约面是纯数据 `control` 消息,不是句柄的 RPC stub;勿在本类型上追加方法
|
|
124
|
+
* 当作契约扩展点。
|
|
125
|
+
*/
|
|
126
|
+
export interface InProcessAgentHandle {
|
|
127
|
+
agentId: string;
|
|
128
|
+
agent: Agent;
|
|
129
|
+
contextEngine?: ContextEngine;
|
|
130
|
+
contextHealth?: (agentId?: string) => Promise<ContextLayerHealth>;
|
|
131
|
+
registerTools: (tools: RegisteredTool[]) => void;
|
|
132
|
+
/** 注册进 AgentRuntime 的执行腿(已含准入闸门 + in-flight 计数包装) */
|
|
133
|
+
dispatcher: RunDispatcher;
|
|
134
|
+
}
|
|
135
|
+
export declare class RunHost implements RunBackend {
|
|
136
|
+
readonly sessionLock: SessionLease;
|
|
137
|
+
protected readonly opts: RunHostOptions;
|
|
138
|
+
private readonly mounted;
|
|
139
|
+
/** 脉搏注册表(P0c A′):key → 进程内驱动入口 + 自述元数据(gateway 单发驱动) */
|
|
140
|
+
private readonly pulseFire;
|
|
141
|
+
private readonly pulseSpecs;
|
|
142
|
+
private readonly buildInFlight;
|
|
143
|
+
private readonly retiredRunners;
|
|
144
|
+
private readonly runnerInflight;
|
|
145
|
+
private readonly activeRuns;
|
|
146
|
+
private readonly pendingApprovals;
|
|
147
|
+
private readonly pendingClientCalls;
|
|
148
|
+
private visibilitySnapshot;
|
|
149
|
+
/** 客户端工具现况注册表(B3:mount 晚于 setClientTools 时重放;add 同名覆盖) */
|
|
150
|
+
private readonly clientToolRegistry;
|
|
151
|
+
private knowledgeState;
|
|
152
|
+
constructor(options: RunHostOptions);
|
|
153
|
+
mount(spec: RunBackendMountSpec): InProcessAgentHandle;
|
|
154
|
+
get(agentId: string): InProcessAgentHandle | undefined;
|
|
155
|
+
/**
|
|
156
|
+
* 消息路径 get-or-mount(gateway.getOrMountHandle 同语义):未挂载则经
|
|
157
|
+
* buildMountSpec 钩子构建+挂载;同 agent 并发首建单飞合流。
|
|
158
|
+
*
|
|
159
|
+
* 语义基线(B1):并发请求全部成功;竞态败者回收自己的构建产物、复用胜者句柄;
|
|
160
|
+
* 其余 mount 错误如实上抛(fail-loud)。
|
|
161
|
+
*
|
|
162
|
+
* @param agentId - agent id
|
|
163
|
+
* @param definition - agent 定义(纯数据;透传构建钩子)
|
|
164
|
+
* @returns 句柄(保证已挂载)
|
|
165
|
+
*/
|
|
166
|
+
ensureMounted(agentId: string, definition: AgentDefinitionWire): Promise<InProcessAgentHandle>;
|
|
167
|
+
handles(): InProcessAgentHandle[];
|
|
168
|
+
mountedAgentIds(): string[];
|
|
169
|
+
retire(agentId: string): void;
|
|
170
|
+
execute(req: RunRequest, signal?: AbortSignal): AsyncIterable<AgentEvent>;
|
|
171
|
+
/**
|
|
172
|
+
* 契约执行入口(§4):execute + 按会话登记 AbortController(control 'abort' 的目标)。
|
|
173
|
+
* 并发同会话调用不在此拦(E1/E2 互斥由 sessionLock 排队语义承接;abort 作用于该
|
|
174
|
+
* 会话全部在途 controller)。
|
|
175
|
+
*
|
|
176
|
+
* @param req - run 请求(纯数据)
|
|
177
|
+
* @param signal - 外部中止信号(委派子 run 的 D4 本地投影;合流到本 run 的 controller)
|
|
178
|
+
* @returns 协议事件流
|
|
179
|
+
*/
|
|
180
|
+
startRun(req: RunRequest, signal?: AbortSignal): AsyncIterable<AgentEvent>;
|
|
181
|
+
/**
|
|
182
|
+
* 控制 op 统一入口(契约 `control` 的 run 侧执行面)。
|
|
183
|
+
* 错误表面:失败一律进 `RunControlResponse` 的 `ok:false`(远程层映射 HTTP 4xx),
|
|
184
|
+
* 不静默吞。
|
|
185
|
+
*
|
|
186
|
+
* @param op - 纯数据控制 op
|
|
187
|
+
* @returns 执行结果
|
|
188
|
+
*/
|
|
189
|
+
handleControl(op: RunControlOp): Promise<RunControlResponse>;
|
|
190
|
+
/**
|
|
191
|
+
* 审批请求(pluginManager approval sink 与装配 requestApproval 的远程形态入口):
|
|
192
|
+
* 注册配对并经 notify 出港;回执由 control 'approvalReply' 解配对。
|
|
193
|
+
*
|
|
194
|
+
* @param input - 审批请求载荷(RunApprovalRequestInput 形状)
|
|
195
|
+
* @returns 审批结果
|
|
196
|
+
*/
|
|
197
|
+
askApproval(input: RunApprovalRequestInput): Promise<HitlAskResult>;
|
|
198
|
+
/** ask_user 跨通道配对(问句经 notify 出港,作答经 control 'askUserReply' 解配对) */
|
|
199
|
+
private readonly pendingAsks;
|
|
200
|
+
/**
|
|
201
|
+
* ask_user 提问(AskUserCallback 的远程形态入口):注册配对并经 notify 出港。
|
|
202
|
+
* 回执 ok:false 时拒接 → 工具调用抛错(fail-loud,不吞失败)。
|
|
203
|
+
*
|
|
204
|
+
* @param input - 问句载荷
|
|
205
|
+
* @returns 用户作答
|
|
206
|
+
*/
|
|
207
|
+
askQuestion(input: {
|
|
208
|
+
sessionId: string;
|
|
209
|
+
agentId: string;
|
|
210
|
+
question: string;
|
|
211
|
+
options?: string[];
|
|
212
|
+
}): Promise<string>;
|
|
213
|
+
/**
|
|
214
|
+
* 把动态 client tool 同步进已 build 的 Agent(E5 下同 session 串行,无需锁 tool 列表)。
|
|
215
|
+
* handleControl('setClientTools') 与 in-process 直连路径共用本核心。
|
|
216
|
+
*
|
|
217
|
+
* @param ops - 工具增删(RegisteredTool 已就位)
|
|
218
|
+
* @param visibility - 会话 tool 面可见性谓词
|
|
219
|
+
*/
|
|
220
|
+
applyClientTools(ops: Array<{
|
|
221
|
+
op: 'add';
|
|
222
|
+
tool: RegisteredTool;
|
|
223
|
+
} | {
|
|
224
|
+
op: 'remove';
|
|
225
|
+
name: string;
|
|
226
|
+
}>, visibility: (sessionId: string, toolName: string) => boolean): void;
|
|
227
|
+
compactSession(sessionId: string, agentId: string): Promise<CompactTransportOutcome>;
|
|
228
|
+
/**
|
|
229
|
+
* 截断会话消息(编辑重发唯一写路径;自 gateway.truncateMessagesFrom 迁入,行为冻结)。
|
|
230
|
+
* 校验:仅最后一轮中止、锚点为该 turn 用户输入;随后截断 + 租约下标收缩 +
|
|
231
|
+
* abortedTurn 清理 + 本轮文件效应逆放(用户手改保留)。
|
|
232
|
+
*
|
|
233
|
+
* @param sessionId - 会话 id
|
|
234
|
+
* @param fromIndex - 截断锚点(须等于 abortedTurn.userMessageIndex)
|
|
235
|
+
* @returns 控制响应(result = 消息数 + 文件效应逆放结果)
|
|
236
|
+
*/
|
|
237
|
+
private truncateMessagesFrom;
|
|
238
|
+
/**
|
|
239
|
+
* 冒烟(健康门 §4.3,`POST /smoke`):逐 agent 装配热路径自检——工具面枚举 +
|
|
240
|
+
* 一次 no-LLM 应答(contextHealth)。**不是 run,不占 run 语义**。
|
|
241
|
+
*
|
|
242
|
+
* @returns 冒烟报告(逐项如实入 checks;聚合 ok = 有 agent 且全部通过)
|
|
243
|
+
*/
|
|
244
|
+
smoke(): Promise<RunSmokeReport>;
|
|
245
|
+
health(): Promise<RunBackendHealth>;
|
|
246
|
+
disposeAll(): void;
|
|
247
|
+
/**
|
|
248
|
+
* compact 解析(P0a 迁移注记清偿):systemPrompt/tools/摘要绑定/进度双缝全部从
|
|
249
|
+
* run 侧自身状态解析,控制面只传键。搬移自 gateway.ts 手动压缩调用点(行为冻结)。
|
|
250
|
+
*
|
|
251
|
+
* @param sessionId - 会话 id
|
|
252
|
+
* @param agentId - compact 视图归属 agent(E4 键,调用方已消歧)
|
|
253
|
+
* @returns 压缩结果
|
|
254
|
+
*/
|
|
255
|
+
private resolveAndCompact;
|
|
256
|
+
/**
|
|
257
|
+
* 退役 runner:in-flight 计数归零即 dispose;30min 长尾强制兜底(warn 后仍回收)。
|
|
258
|
+
*
|
|
259
|
+
* @param runner - 要退役的 runner
|
|
260
|
+
*/
|
|
261
|
+
protected retireRunner(runner: SessionAwareRunner): void;
|
|
262
|
+
/**
|
|
263
|
+
* 退役 runner 回收(幂等;stop 兜底也走这里)。
|
|
264
|
+
*
|
|
265
|
+
* @param runner - 要回收的 runner
|
|
266
|
+
*/
|
|
267
|
+
private disposeRetiredRunner;
|
|
268
|
+
/**
|
|
269
|
+
* 包装 dispatcher:execute 前过 run 起点准入闸门(ops P2 三件套),
|
|
270
|
+
* execute 期间维护 runner 的 in-flight run 计数(退役 dispose 判据)。
|
|
271
|
+
*
|
|
272
|
+
* @param runner - 计数/账本归属的 runner
|
|
273
|
+
* @param inner - 原 dispatcher
|
|
274
|
+
* @returns 包装后的 dispatcher(结构兼容 RunDispatcher)
|
|
275
|
+
*/
|
|
276
|
+
private wrapInflightTracking;
|
|
277
|
+
/**
|
|
278
|
+
* 客户端工具桥:wire spec → RegisteredTool(handler 跨通道配对执行)。
|
|
279
|
+
* 请求经 notify('client_tool_call') 出港,结果由 control 'clientToolResult' 解配对。
|
|
280
|
+
*
|
|
281
|
+
* @param spec - 线上工具形状(definition + source)
|
|
282
|
+
* @returns run 侧可执行工具
|
|
283
|
+
*/
|
|
284
|
+
private materializeClientTool;
|
|
285
|
+
/** 可见性谓词(快照求值;宿主 onBuilt 在构建期装到 agent 上) */
|
|
286
|
+
buildVisibilityPredicate(): (sessionId: string, toolName: string) => boolean;
|
|
287
|
+
/**
|
|
288
|
+
* 调用期 liveness 校验(方案 A 的配套):工具留在 schema 里,但真的没有 live
|
|
289
|
+
* provider 时立刻响亮失败,而不是挂到 TTL 超时。
|
|
290
|
+
*
|
|
291
|
+
* 快照过期 = liveness 未知 → 不阻断(交调用自身 TTL 兜底),避免误拒。
|
|
292
|
+
*
|
|
293
|
+
* @param sessionId - 会话 id
|
|
294
|
+
* @param toolName - 客户端工具名
|
|
295
|
+
* @returns true = 可信地不在线(拒绝调用)
|
|
296
|
+
*/
|
|
297
|
+
private isClientToolConfirmedOffline;
|
|
298
|
+
private requireSessionWriter;
|
|
299
|
+
private requireBuildMountSpec;
|
|
300
|
+
private notify;
|
|
301
|
+
}
|
|
302
|
+
export {};
|