@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
|
@@ -21,6 +21,14 @@ export interface AgentRuntimeConfig {
|
|
|
21
21
|
expectedMaxConcurrentRuns?: number;
|
|
22
22
|
coalesceBufferLimit?: number;
|
|
23
23
|
};
|
|
24
|
+
/**
|
|
25
|
+
* trigger 的 lease_held 延迟重投(协调面「唤醒」原语):
|
|
26
|
+
* maxAttempts 缺省 3、delayMs 缺省 2000;human 同样重投(拒可见 + 补达,2026-11-14 插话修复②)。
|
|
27
|
+
*/
|
|
28
|
+
wakeupRetry?: {
|
|
29
|
+
maxAttempts?: number;
|
|
30
|
+
delayMs?: number;
|
|
31
|
+
};
|
|
24
32
|
}
|
|
25
33
|
export declare class AgentRuntime {
|
|
26
34
|
private readonly events?;
|
|
@@ -32,6 +40,10 @@ export declare class AgentRuntime {
|
|
|
32
40
|
private readonly activeRuns;
|
|
33
41
|
private readonly listeners;
|
|
34
42
|
private readonly expectedMaxConcurrentRuns?;
|
|
43
|
+
private readonly wakeupRetryMax;
|
|
44
|
+
private readonly wakeupRetryDelayMs;
|
|
45
|
+
private readonly wakeupAttempts;
|
|
46
|
+
private readonly wakeupScheduled;
|
|
35
47
|
private started;
|
|
36
48
|
constructor(config?: AgentRuntimeConfig);
|
|
37
49
|
get running(): boolean;
|
|
@@ -75,6 +87,27 @@ export declare class AgentRuntime {
|
|
|
75
87
|
* @param options.onDelivery - 活跃 Run 接收即回执(早于 Run 结束)
|
|
76
88
|
*/
|
|
77
89
|
dispatch(trigger: Trigger, options?: import('./types.js').DispatchOptions): Promise<DispatchResult | FanoutDispatchResult>;
|
|
90
|
+
/**
|
|
91
|
+
* 唤醒/重试语义收口(协调面「唤醒」原语的跨进程补齐,B):
|
|
92
|
+
* trigger 被 run 层直拒(RUN_LEASE_HELD_MARKER——同会话并发 run 闸;产生点在
|
|
93
|
+
* 执行前,消息未入上下文)时,按原 Trigger 定向重投至少一次到达。重投走
|
|
94
|
+
* **dispatchToTarget(per-target)**:fan-out 场景只补失败目标,不给已送达
|
|
95
|
+
* 目标重复投递。human 同样重投(宁可重投不可静默丢):本次 'failed' 原样回到
|
|
96
|
+
* 用户可见面(拒可见),重投成功则补达,渠道回复路由由随行的 onEvent/onDelivery
|
|
97
|
+
* 闭包续上(gateway 侧晚到回复按 retryScheduled 标记开启)。
|
|
98
|
+
*
|
|
99
|
+
* @param trigger - 原 Trigger(唤醒凭证)
|
|
100
|
+
* @param target - 失败的路由目标(重投定向)
|
|
101
|
+
* @param result - dispatch 结果
|
|
102
|
+
* @param onEvent - 原派发的事件闭包(重投续用;human 渠道回复路由依赖它)
|
|
103
|
+
* @param onDelivery - 原派发的投递回执闭包(重投续用)
|
|
104
|
+
* @returns 原结果透传 + retryScheduled 标记(重投在后台进行,不吞本次失败)
|
|
105
|
+
*/
|
|
106
|
+
private finalizeDelivery;
|
|
107
|
+
/** 延迟重投(per-target 定向;attempts 上限后 TRIGGER_DROPPED 落账;同键单飞防重复排程)
|
|
108
|
+
* @returns 是否排程成功(false = 预算耗尽已落账 dropped)
|
|
109
|
+
*/
|
|
110
|
+
private scheduleWakeupRetry;
|
|
78
111
|
/**
|
|
79
112
|
* 路由目标的活跃 inbox 接收(human 与 delegation signal 共用)。
|
|
80
113
|
* 仅 message / agent_signal 可接续;其余类型与带附件/换模型输入走完整新 Run。
|
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
* 设计:arch/agent-runtime.md
|
|
8
8
|
*/
|
|
9
9
|
import { CoalesceBuffer } from './coalesce.js';
|
|
10
|
+
import { RUN_LEASE_HELD_MARKER } from './run-protocol.js';
|
|
10
11
|
import { buildRunRequest, compileMessages, resolveSessionId } from './compiler.js';
|
|
11
12
|
import { ExplicitRouter } from './router.js';
|
|
12
13
|
import { RuntimeEvents } from './types.js';
|
|
@@ -35,11 +36,17 @@ export class AgentRuntime {
|
|
|
35
36
|
activeRuns = new Map();
|
|
36
37
|
listeners = new Set();
|
|
37
38
|
expectedMaxConcurrentRuns;
|
|
39
|
+
wakeupRetryMax;
|
|
40
|
+
wakeupRetryDelayMs;
|
|
41
|
+
wakeupAttempts = new Map();
|
|
42
|
+
wakeupScheduled = new Set();
|
|
38
43
|
started = false;
|
|
39
44
|
constructor(config = {}) {
|
|
40
45
|
this.events = config.events;
|
|
41
46
|
this.router = config.router ?? new ExplicitRouter();
|
|
42
47
|
this.expectedMaxConcurrentRuns = config.admission?.expectedMaxConcurrentRuns;
|
|
48
|
+
this.wakeupRetryMax = config.wakeupRetry?.maxAttempts ?? 3;
|
|
49
|
+
this.wakeupRetryDelayMs = config.wakeupRetry?.delayMs ?? 2000;
|
|
43
50
|
this.coalesce = new CoalesceBuffer({
|
|
44
51
|
defaultWindowMs: config.defaultCoalesceMs,
|
|
45
52
|
maxEntries: config.admission?.coalesceBufferLimit ?? config.coalesceBufferLimit ?? 256,
|
|
@@ -249,11 +256,66 @@ export class AgentRuntime {
|
|
|
249
256
|
}
|
|
250
257
|
return { status: 'skipped', reason: 'no_agent' };
|
|
251
258
|
}
|
|
259
|
+
/**
|
|
260
|
+
* 唤醒/重试语义收口(协调面「唤醒」原语的跨进程补齐,B):
|
|
261
|
+
* trigger 被 run 层直拒(RUN_LEASE_HELD_MARKER——同会话并发 run 闸;产生点在
|
|
262
|
+
* 执行前,消息未入上下文)时,按原 Trigger 定向重投至少一次到达。重投走
|
|
263
|
+
* **dispatchToTarget(per-target)**:fan-out 场景只补失败目标,不给已送达
|
|
264
|
+
* 目标重复投递。human 同样重投(宁可重投不可静默丢):本次 'failed' 原样回到
|
|
265
|
+
* 用户可见面(拒可见),重投成功则补达,渠道回复路由由随行的 onEvent/onDelivery
|
|
266
|
+
* 闭包续上(gateway 侧晚到回复按 retryScheduled 标记开启)。
|
|
267
|
+
*
|
|
268
|
+
* @param trigger - 原 Trigger(唤醒凭证)
|
|
269
|
+
* @param target - 失败的路由目标(重投定向)
|
|
270
|
+
* @param result - dispatch 结果
|
|
271
|
+
* @param onEvent - 原派发的事件闭包(重投续用;human 渠道回复路由依赖它)
|
|
272
|
+
* @param onDelivery - 原派发的投递回执闭包(重投续用)
|
|
273
|
+
* @returns 原结果透传 + retryScheduled 标记(重投在后台进行,不吞本次失败)
|
|
274
|
+
*/
|
|
275
|
+
finalizeDelivery(trigger, target, result, onEvent, onDelivery) {
|
|
276
|
+
const key = `${trigger.id}:${target.agentId}`;
|
|
277
|
+
if (result.status === 'failed' && result.error.includes(RUN_LEASE_HELD_MARKER)) {
|
|
278
|
+
const scheduled = this.scheduleWakeupRetry(trigger, target, onEvent, onDelivery);
|
|
279
|
+
return { ...result, retryScheduled: scheduled };
|
|
280
|
+
}
|
|
281
|
+
if (result.status === 'ran' || result.status === 'accepted') {
|
|
282
|
+
this.wakeupAttempts.delete(key);
|
|
283
|
+
}
|
|
284
|
+
return result;
|
|
285
|
+
}
|
|
286
|
+
/** 延迟重投(per-target 定向;attempts 上限后 TRIGGER_DROPPED 落账;同键单飞防重复排程)
|
|
287
|
+
* @returns 是否排程成功(false = 预算耗尽已落账 dropped)
|
|
288
|
+
*/
|
|
289
|
+
scheduleWakeupRetry(trigger, target, onEvent, onDelivery) {
|
|
290
|
+
const key = `${trigger.id}:${target.agentId}`;
|
|
291
|
+
if (this.wakeupScheduled.has(key))
|
|
292
|
+
return true; // 已排程:不重复排(同键单飞)
|
|
293
|
+
const attempts = this.wakeupAttempts.get(key) ?? 0;
|
|
294
|
+
if (attempts >= this.wakeupRetryMax) {
|
|
295
|
+
this.wakeupAttempts.delete(key);
|
|
296
|
+
this.emitRuntime(RuntimeEvents.TRIGGER_DROPPED, {
|
|
297
|
+
triggerRef: toTriggerRef(trigger),
|
|
298
|
+
triggerId: trigger.id,
|
|
299
|
+
reason: RUN_LEASE_HELD_MARKER,
|
|
300
|
+
});
|
|
301
|
+
return false;
|
|
302
|
+
}
|
|
303
|
+
this.wakeupAttempts.set(key, attempts + 1);
|
|
304
|
+
this.wakeupScheduled.add(key);
|
|
305
|
+
setTimeout(() => {
|
|
306
|
+
this.wakeupScheduled.delete(key);
|
|
307
|
+
void this.dispatchToTarget(trigger, target, { onEvent, onDelivery }).catch(() => {
|
|
308
|
+
// 重投自身的调度失败由下一轮 finalize/DROPPED 落账;这里不吞错——
|
|
309
|
+
// 仅避免 unhandled rejection(dispatch 内部已 fail-loud 事件化)。
|
|
310
|
+
});
|
|
311
|
+
}, this.wakeupRetryDelayMs);
|
|
312
|
+
return true;
|
|
313
|
+
}
|
|
252
314
|
/**
|
|
253
315
|
* 路由目标的活跃 inbox 接收(human 与 delegation signal 共用)。
|
|
254
316
|
* 仅 message / agent_signal 可接续;其余类型与带附件/换模型输入走完整新 Run。
|
|
255
317
|
*/
|
|
256
|
-
offerToTarget(trigger, target, sessionId, onEvent) {
|
|
318
|
+
async offerToTarget(trigger, target, sessionId, onEvent) {
|
|
257
319
|
if (!target.dispatcher.inbox)
|
|
258
320
|
return 'dispatched';
|
|
259
321
|
if (trigger.type !== 'message' && trigger.type !== 'agent_signal')
|
|
@@ -261,27 +323,40 @@ export class AgentRuntime {
|
|
|
261
323
|
const [compiledMessage] = compileMessages([trigger]);
|
|
262
324
|
const human = trigger.type === 'message' && trigger.payload.kind === 'user_message';
|
|
263
325
|
const delegationId = trigger.metadata?.delegationId;
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
326
|
+
try {
|
|
327
|
+
return await target.dispatcher.inbox.offer({
|
|
328
|
+
agentId: target.agentId,
|
|
329
|
+
sessionId,
|
|
330
|
+
entryId: delegationId ?? trigger.id,
|
|
331
|
+
triggerType: trigger.type,
|
|
332
|
+
human,
|
|
333
|
+
modelOverride: trigger.metadata?.modelOverride,
|
|
334
|
+
modelProvider: trigger.metadata?.modelProvider,
|
|
335
|
+
trigger,
|
|
336
|
+
onEvent,
|
|
337
|
+
message: compiledMessage,
|
|
338
|
+
onAdmitted: (delivery) => {
|
|
339
|
+
try {
|
|
340
|
+
this.emitRuntime(RuntimeEvents.INBOX_ADMITTED, {
|
|
341
|
+
triggerId: trigger.id,
|
|
342
|
+
agentId: target.agentId,
|
|
343
|
+
sessionId,
|
|
344
|
+
delegationId,
|
|
345
|
+
delivery,
|
|
346
|
+
});
|
|
347
|
+
}
|
|
348
|
+
catch {
|
|
349
|
+
// 观测事件不得影响投递语义(admitted 后抛错会被外层 fail-open 翻成
|
|
350
|
+
// 'dispatched' = 双投)——通知是尽力而为面
|
|
351
|
+
}
|
|
352
|
+
},
|
|
353
|
+
});
|
|
354
|
+
}
|
|
355
|
+
catch {
|
|
356
|
+
// 协调面「插话」fail-open(语义权威点):offer 通道失败不吞消息,
|
|
357
|
+
// 一律回到 'dispatched' 由调用方照常 dispatch 新 Run 送达。
|
|
358
|
+
return 'dispatched';
|
|
359
|
+
}
|
|
285
360
|
}
|
|
286
361
|
async dispatchToTarget(trigger, target, options) {
|
|
287
362
|
const agent = this.agents.get(target.agentId);
|
|
@@ -294,12 +369,25 @@ export class AgentRuntime {
|
|
|
294
369
|
});
|
|
295
370
|
// 单一 offer 点:活跃 Run 接收 = 不再开新 Run(原 Trigger 不 dispatch,
|
|
296
371
|
// Run 关闭未消费时由 inbox 按原 Trigger 重投)
|
|
297
|
-
const offerResult = this.offerToTarget(trigger, agent, sessionId, options?.onEvent);
|
|
298
|
-
if (offerResult === '
|
|
299
|
-
|
|
300
|
-
|
|
372
|
+
const offerResult = await this.offerToTarget(trigger, agent, sessionId, options?.onEvent);
|
|
373
|
+
if (offerResult === 'continued' || offerResult === 'duplicate') {
|
|
374
|
+
if (offerResult === 'continued') {
|
|
375
|
+
options?.onDelivery?.('continued');
|
|
376
|
+
// 插话送达即本周期成功:清重投计数(否则残留计数会让下一轮冲突提前耗尽)
|
|
377
|
+
this.wakeupAttempts.delete(`${trigger.id}:${agent.agentId}`);
|
|
378
|
+
}
|
|
379
|
+
// duplicate(同 id 已受理/已入上下文)不回执 continued、不抑制调用方同步回复:
|
|
380
|
+
// at-least-once 重投的去重出口——重复投递不重复执行也不重复回答(回答由
|
|
381
|
+
// 首次受理的那条路由负责),但也不冒充「已续接」误导调用方晚到回复闭包。
|
|
382
|
+
return {
|
|
383
|
+
status: 'accepted',
|
|
384
|
+
agentId: agent.agentId,
|
|
385
|
+
sessionId,
|
|
386
|
+
delivery: offerResult,
|
|
387
|
+
};
|
|
301
388
|
}
|
|
302
389
|
options?.onDelivery?.('run');
|
|
390
|
+
const finalize = (result) => this.finalizeDelivery(trigger, agent, result, options?.onEvent, options?.onDelivery);
|
|
303
391
|
if (trigger.coalesceKey) {
|
|
304
392
|
this.emitRuntime(RuntimeEvents.RUN_SCHEDULED, {
|
|
305
393
|
triggerId: trigger.id,
|
|
@@ -315,11 +403,11 @@ export class AgentRuntime {
|
|
|
315
403
|
onFlush: (triggers, onEvent) => this.executeTriggers(agent, triggers, sessionId, onEvent ?? options?.onEvent),
|
|
316
404
|
});
|
|
317
405
|
if (result.kind === 'no_key' || result.kind === 'buffer_full') {
|
|
318
|
-
return this.executeTriggers(agent, [trigger], sessionId, options?.onEvent);
|
|
406
|
+
return finalize(await this.executeTriggers(agent, [trigger], sessionId, options?.onEvent));
|
|
319
407
|
}
|
|
320
|
-
return result.done;
|
|
408
|
+
return finalize(await result.done);
|
|
321
409
|
}
|
|
322
|
-
return this.executeTriggers(agent, [trigger], sessionId, options?.onEvent);
|
|
410
|
+
return finalize(await this.executeTriggers(agent, [trigger], sessionId, options?.onEvent));
|
|
323
411
|
}
|
|
324
412
|
async executeTriggers(agent, triggers, sessionId, onEvent) {
|
|
325
413
|
if (!this.started) {
|
|
@@ -327,10 +415,21 @@ export class AgentRuntime {
|
|
|
327
415
|
}
|
|
328
416
|
// I6:schedule 点火以 timer 主体入审计(arch/session-schedules.md)
|
|
329
417
|
const isScheduleWake = triggers.some((t) => t.type === 'schedule');
|
|
418
|
+
// Channel/user triggers carry their real sender as the Run principal so Hook
|
|
419
|
+
// audit attribution reflects who actually asked; host-internal triggers keep
|
|
420
|
+
// no actor rather than inventing one.
|
|
421
|
+
const senderId = isScheduleWake
|
|
422
|
+
? undefined
|
|
423
|
+
: triggers
|
|
424
|
+
.map((t) => ('source' in t.payload ? t.payload.source?.senderId : undefined))
|
|
425
|
+
.find((id) => typeof id === 'string' && id.length > 0);
|
|
426
|
+
// §9.1-6:触发源租户(渠道锚等)随 Trigger 传播 → run principal 归属
|
|
427
|
+
const tenantId = triggers.map((t) => t.tenantId).find((id) => typeof id === 'string' && id.length > 0);
|
|
330
428
|
const request = buildRunRequest(agent, triggers, sessionId, {
|
|
331
|
-
actorType: isScheduleWake ? 'timer' : undefined,
|
|
332
|
-
actorId: isScheduleWake ? (triggers[0]?.metadata?.reason ?? triggers[0]?.id) :
|
|
429
|
+
actorType: isScheduleWake ? 'timer' : senderId ? 'user' : undefined,
|
|
430
|
+
actorId: isScheduleWake ? (triggers[0]?.metadata?.reason ?? triggers[0]?.id) : senderId,
|
|
333
431
|
intent: isScheduleWake ? 'schedule_wake' : undefined,
|
|
432
|
+
...(tenantId === undefined ? {} : { tenantId }),
|
|
334
433
|
});
|
|
335
434
|
const controller = new AbortController();
|
|
336
435
|
const run = {
|
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
*/
|
|
6
6
|
import type { Message } from '@octopi-agent/core/types.js';
|
|
7
7
|
import type { AgentEvent } from '@octopi-agent/core/primitives/event-bus.js';
|
|
8
|
+
import type { SessionRights } from '../governance/session-acl/types.js';
|
|
8
9
|
export type TriggerType = 'message' | 'schedule' | 'event' | 'escalate' | 'agent_signal' | 'manual';
|
|
9
10
|
export type TriggerPayload = {
|
|
10
11
|
kind: 'user_message';
|
|
@@ -26,6 +27,8 @@ export interface Trigger {
|
|
|
26
27
|
agentId?: string;
|
|
27
28
|
toAgents?: string[];
|
|
28
29
|
sessionId?: string;
|
|
30
|
+
/** 触发源归属租户(§9.1-6:渠道锚/租户会话创建方);合入 run principal,缺省锚 agent 归属 */
|
|
31
|
+
tenantId?: string;
|
|
29
32
|
/** 来源端时间戳;缺省用 dispatch 时刻 */
|
|
30
33
|
timestamp?: number;
|
|
31
34
|
payload: TriggerPayload;
|
|
@@ -75,6 +78,13 @@ export interface RunRequest {
|
|
|
75
78
|
modelOverride?: string;
|
|
76
79
|
/** modelOverride 为裸名时的 provider */
|
|
77
80
|
modelProvider?: string;
|
|
81
|
+
/**
|
|
82
|
+
* per-run systemPrompt 覆盖(委派子 run:模板 persona + 编排指令,delegation §9.4)。
|
|
83
|
+
* 显式值覆盖挂载默认;缺省沿用挂载体 defaults。
|
|
84
|
+
*/
|
|
85
|
+
systemPrompt?: string;
|
|
86
|
+
/** per-run 权利天花板(D3:只能收紧不能放宽;Runner 与模板天花板取交集) */
|
|
87
|
+
rightsCeiling?: SessionRights;
|
|
78
88
|
/** Principal / Intent 字段位(宪法 I6);宿主填充,引擎不做权限 NLU */
|
|
79
89
|
actorId?: string;
|
|
80
90
|
actorType?: 'host' | 'user' | 'agent' | 'service' | 'timer' | 'subsystem';
|
|
@@ -97,7 +107,8 @@ export interface RunDispatcher {
|
|
|
97
107
|
execute(req: RunRequest, signal?: AbortSignal): AsyncIterable<AgentEvent>;
|
|
98
108
|
/** 可选:活跃 Run 接续;缺省保持原 Trigger 排队语义。 */
|
|
99
109
|
inbox?: {
|
|
100
|
-
|
|
110
|
+
/** 本地 SessionInbox 同步返回;跨进程代理返回 Promise(远程 inboxOffer op)。 */
|
|
111
|
+
offer(signal: import('./inbox.js').SessionInboxSignal): import('./inbox.js').InboxOfferResult | Promise<import('./inbox.js').InboxOfferResult>;
|
|
101
112
|
};
|
|
102
113
|
}
|
|
103
114
|
/** dispatch 调用方选项 */
|
|
@@ -105,7 +116,7 @@ export interface DispatchOptions {
|
|
|
105
116
|
/** Run 事件流转发(频道回复捕获等);不变量 #6 */
|
|
106
117
|
onEvent?: (event: AgentEvent) => void;
|
|
107
118
|
/** 活跃 Run 接收即回执(早于 Run 结束);run = 走新 Run。 */
|
|
108
|
-
onDelivery?: (delivery: '
|
|
119
|
+
onDelivery?: (delivery: 'continued' | 'run') => void;
|
|
109
120
|
}
|
|
110
121
|
export interface RouteTarget {
|
|
111
122
|
agentId: string;
|
|
@@ -143,13 +154,19 @@ export type DispatchResult = {
|
|
|
143
154
|
status: 'accepted';
|
|
144
155
|
agentId: string;
|
|
145
156
|
sessionId: string;
|
|
146
|
-
|
|
157
|
+
/**
|
|
158
|
+
* continued = 活跃 Run 接收续接;duplicate = 同 id 已受理/已入上下文
|
|
159
|
+
* (at-least-once 重投的去重出口),不重复执行、不重复回答。
|
|
160
|
+
*/
|
|
161
|
+
delivery: 'continued' | 'duplicate';
|
|
147
162
|
} | {
|
|
148
163
|
status: 'skipped';
|
|
149
164
|
reason: 'no_agent' | 'filtered' | 'runtime_stopped' | 'aborted';
|
|
150
165
|
} | {
|
|
151
166
|
status: 'failed';
|
|
152
167
|
error: string;
|
|
168
|
+
/** lease_held 延迟重投已排程:本次拒可见,回答稍后经随行 onEvent 补达 */
|
|
169
|
+
retryScheduled?: boolean;
|
|
153
170
|
};
|
|
154
171
|
/** fan-out 聚合结果(toAgents 长度 > 1 时由 dispatch 返回) */
|
|
155
172
|
export type FanoutDispatchResult = {
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
* .model('gpt-5.5')
|
|
10
10
|
* .persona('./personas/my-agent')
|
|
11
11
|
* .tool(myTool)
|
|
12
|
-
* .budget({
|
|
12
|
+
* .budget({ maxSteps: 15 })
|
|
13
13
|
* .build();
|
|
14
14
|
* ```
|
|
15
15
|
*/
|
|
@@ -45,6 +45,7 @@ export interface ToolContextProvider {
|
|
|
45
45
|
sessionId: string;
|
|
46
46
|
agentId: string;
|
|
47
47
|
runId?: string;
|
|
48
|
+
agentToolPolicy?: import('@octopi-agent/core/types.js').ToolPolicy;
|
|
48
49
|
messages: import('@octopi-agent/core/types.js').Message[];
|
|
49
50
|
cwd?: string;
|
|
50
51
|
attachmentRoots?: string[];
|
|
@@ -138,6 +139,14 @@ export interface AgentBuildResult {
|
|
|
138
139
|
registerTools: (tools: RegisteredTool[]) => void;
|
|
139
140
|
/** ContextEngine 实例(手动压缩入口) */
|
|
140
141
|
contextEngine?: import('../context/types.js').ContextEngine;
|
|
142
|
+
/**
|
|
143
|
+
* 脉搏注册表(P0c A′):本 agent 声明的全部周期任务(key 已带 agentId 前缀、实例内唯一)。
|
|
144
|
+
* run 宿主聚合为实例级 PulseSpec 自述给 gateway 脉搏调度器;fire 为进程内驱动入口。
|
|
145
|
+
*/
|
|
146
|
+
pulses: Array<{
|
|
147
|
+
spec: import('../activation/run-protocol.js').PulseSpec;
|
|
148
|
+
fire: () => Promise<unknown>;
|
|
149
|
+
}>;
|
|
141
150
|
contextHealth: (agentId?: string) => Promise<import('../context/layer-health.js').ContextLayerHealth>;
|
|
142
151
|
}
|
|
143
152
|
/** 缺省子系统搜索并加载 spec(供 build 自动发现与 serve 启动日志共用) */
|
|
@@ -158,7 +167,9 @@ export declare class AgentBuilder {
|
|
|
158
167
|
private _toolBus;
|
|
159
168
|
private _contextEngine?;
|
|
160
169
|
private _summarize?;
|
|
161
|
-
/**
|
|
170
|
+
/** 按 session 键控的 context 压力(由 convertToLlm 更新;共享 Agent 下并发会话不串号) */
|
|
171
|
+
private _contextPressureBySession;
|
|
172
|
+
/** 兜底:无 sessionId 的调用方(仅 advisory 用途;并发下可能串号,不得用于持久化) */
|
|
162
173
|
private _lastContextPressure?;
|
|
163
174
|
/** 为 true 时禁止自动挂默认 summarize(测试/特殊场景) */
|
|
164
175
|
private _disableAutoSummarize;
|
|
@@ -179,6 +190,8 @@ export declare class AgentBuilder {
|
|
|
179
190
|
private _systemPrompt?;
|
|
180
191
|
/** Skill 目录(SKILL.md);build 时 discover 并注入 system prompt 索引 */
|
|
181
192
|
private _skillDirectory?;
|
|
193
|
+
/** Skill id allowlist(agents[].skills);未设置 = 全部启用 */
|
|
194
|
+
private _skillAllowlist?;
|
|
182
195
|
private _skillManager?;
|
|
183
196
|
/** 记忆检索(注入 system prompt MemoryLayer) */
|
|
184
197
|
private _memoryStore?;
|
|
@@ -198,7 +211,7 @@ export declare class AgentBuilder {
|
|
|
198
211
|
private _knowledgeGrounding?;
|
|
199
212
|
/** 智慧(注入 system prompt WisdomLayer) */
|
|
200
213
|
private _wisdomStore?;
|
|
201
|
-
/** Wisdom 注入策略(wisdom.injection:core/scenario 上限 + trialVisible) */
|
|
214
|
+
/** Wisdom 注入策略(wisdom.injection:core/scenario/trial 上限 + trialVisible) */
|
|
202
215
|
private _wisdomInjection?;
|
|
203
216
|
/** 认知图谱(注入 system prompt CognitionLayer) */
|
|
204
217
|
private _cognitionStore?;
|
|
@@ -240,6 +253,10 @@ export declare class AgentBuilder {
|
|
|
240
253
|
private _agentHome?;
|
|
241
254
|
/** 逻辑 agentId(观测 / 子系统审计用) */
|
|
242
255
|
private _agentId?;
|
|
256
|
+
/** 归属租户(arch/multi-tenancy.md §4):audit 打标 / 家当派生域;缺省 = DEFAULT_TENANT_ID 语义 */
|
|
257
|
+
private _tenantId?;
|
|
258
|
+
/** Deferred until build so .pluginTools() and .agentId() order is immaterial. */
|
|
259
|
+
private _pluginToolRecords;
|
|
243
260
|
/** 设置模型提供者 */
|
|
244
261
|
model(provider: ModelProvider): this;
|
|
245
262
|
model(name: string): this;
|
|
@@ -249,6 +266,11 @@ export declare class AgentBuilder {
|
|
|
249
266
|
* 覆盖注册(显式)。用于热更新/替换同名工具,不可默默发生。
|
|
250
267
|
*/
|
|
251
268
|
toolReplace(tool: RegisteredTool): this;
|
|
269
|
+
/**
|
|
270
|
+
* Mount host-owned plugin contributions into this Agent's ToolBus projection.
|
|
271
|
+
* Authorization is applied by ToolBus/RunScope; mounting is not Tool exposure.
|
|
272
|
+
*/
|
|
273
|
+
pluginTools(records: readonly import('../extension/plugin-ecosystem/plugins/contribution-registry.js').PluginToolRecord[]): this;
|
|
252
274
|
/** 批量注册:逐个 try/catch,避免一个工具失败拖垮整表 */
|
|
253
275
|
tools(...tools: RegisteredTool[]): this;
|
|
254
276
|
private _contextProvider;
|
|
@@ -309,6 +331,14 @@ export declare class AgentBuilder {
|
|
|
309
331
|
* `~` 形态在此展开(与 workspace / agentHome 同规,幂等)。
|
|
310
332
|
*/
|
|
311
333
|
skillDirectory(dir: string): this;
|
|
334
|
+
/**
|
|
335
|
+
* Skill 启用清单(agents[].skills):discover 只保留列出的 skill id。
|
|
336
|
+
* 不调用或传 undefined = 目录内全部启用。
|
|
337
|
+
*
|
|
338
|
+
* @param ids - 允许的 skill id 列表(SKILL.md 目录名)
|
|
339
|
+
* @returns this
|
|
340
|
+
*/
|
|
341
|
+
skillAllowlist(ids: string[] | undefined): this;
|
|
312
342
|
/** 直接注入 SkillManager(跳过目录 discover) */
|
|
313
343
|
skills(manager: import('../extension/plugin-ecosystem/skills/types.js').SkillManager): this;
|
|
314
344
|
/** 注入 MemoryStore(每轮按 query 召回进 system prompt) */
|
|
@@ -360,6 +390,7 @@ export declare class AgentBuilder {
|
|
|
360
390
|
wisdomInjection(cfg: {
|
|
361
391
|
coreMaxItems?: number;
|
|
362
392
|
scenarioMaxItems?: number;
|
|
393
|
+
trialMaxItems?: number;
|
|
363
394
|
trialVisible?: boolean;
|
|
364
395
|
}): this;
|
|
365
396
|
/** 注入 ConceptGraphStore(spreadingActivate 召回概念子图,进 system prompt CognitionLayer) */
|
|
@@ -453,6 +484,8 @@ export declare class AgentBuilder {
|
|
|
453
484
|
agentHome(dir: string): this;
|
|
454
485
|
/** 逻辑 agentId(extract pending 扫描 / 观测) */
|
|
455
486
|
agentId(id: string): this;
|
|
487
|
+
/** 归属租户(audit 打标 / 家当派生域;arch/multi-tenancy.md §4) */
|
|
488
|
+
tenantId(id: string): this;
|
|
456
489
|
/** 直接设置 systemPrompt(优先于 persona 目录) */
|
|
457
490
|
systemPrompt(prompt: string): this;
|
|
458
491
|
/** 设置 Session 存储 */
|