@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
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
*
|
|
4
4
|
* 见 arch/budget-redesign.md:只记录,不 kill。Policy 另层(P3+)。
|
|
5
5
|
*/
|
|
6
|
-
import { nominalTotalTokens } from '@octopi-agent/core/types/
|
|
6
|
+
import { nominalTotalTokens } from '@octopi-agent/core/types/step.js';
|
|
7
7
|
/**
|
|
8
8
|
* UsageLedger
|
|
9
9
|
*/
|
|
@@ -20,6 +20,7 @@ export class UsageLedger {
|
|
|
20
20
|
summaryOutputTokens = 0;
|
|
21
21
|
toolCalls = 0;
|
|
22
22
|
contextEstTokens;
|
|
23
|
+
contextActualTokens;
|
|
23
24
|
contextWindowTokens;
|
|
24
25
|
toolSummaryApplied = 0;
|
|
25
26
|
toolOutputRawChars = 0;
|
|
@@ -46,6 +47,14 @@ export class UsageLedger {
|
|
|
46
47
|
this.summaryLlmCalls++;
|
|
47
48
|
this.summaryOutputTokens += usage.outputTokens;
|
|
48
49
|
}
|
|
50
|
+
else {
|
|
51
|
+
// context 实测:只认对话请求的 prompt 实测(摘要请求的 usage 是另一个请求的体量,
|
|
52
|
+
// 混入会污染压力轴);provider 报告优先,分项和兜底——与展示口径同源
|
|
53
|
+
const promptActual = usage.inputReportedTokens ??
|
|
54
|
+
usage.inputUncachedTokens + usage.inputCachedTokens + usage.inputCacheWriteTokens;
|
|
55
|
+
if (promptActual > 0)
|
|
56
|
+
this.contextActualTokens = promptActual;
|
|
57
|
+
}
|
|
49
58
|
}
|
|
50
59
|
/** @param n - 工具调用次数 */
|
|
51
60
|
recordToolCall(n = 1) {
|
|
@@ -98,6 +107,7 @@ export class UsageLedger {
|
|
|
98
107
|
this.summaryOutputTokens = 0;
|
|
99
108
|
this.toolCalls = 0;
|
|
100
109
|
this.contextEstTokens = undefined;
|
|
110
|
+
this.contextActualTokens = undefined;
|
|
101
111
|
this.contextWindowTokens = undefined;
|
|
102
112
|
this.toolSummaryApplied = 0;
|
|
103
113
|
this.toolOutputRawChars = 0;
|
|
@@ -127,6 +137,7 @@ export class UsageLedger {
|
|
|
127
137
|
toolCalls: this.toolCalls,
|
|
128
138
|
elapsedMs: Date.now() - this.startTime,
|
|
129
139
|
contextEstTokens: this.contextEstTokens,
|
|
140
|
+
contextActualTokens: this.contextActualTokens,
|
|
130
141
|
contextWindowTokens: this.contextWindowTokens,
|
|
131
142
|
toolSummaryApplied: this.toolSummaryApplied,
|
|
132
143
|
toolOutputRawChars: this.toolOutputRawChars,
|
|
@@ -135,3 +146,14 @@ export class UsageLedger {
|
|
|
135
146
|
};
|
|
136
147
|
}
|
|
137
148
|
}
|
|
149
|
+
/**
|
|
150
|
+
* wrap-up 压力轴的 context 体量口径(单一实现):实测优先,估算只做前瞻补充。
|
|
151
|
+
* 毒估算/锚外推可把估算放大数倍(2026-11-07 实测 5.4× 虚高误杀 run),
|
|
152
|
+
* 压力裁决必须锚在 provider 实测上;无实测(首步前)才回落估算。
|
|
153
|
+
*
|
|
154
|
+
* @param snapshot - 用量账本快照
|
|
155
|
+
* @returns 压力裁决用的 context 体量(tokens),两者皆缺返回 undefined
|
|
156
|
+
*/
|
|
157
|
+
export function contextPressureTokens(snapshot) {
|
|
158
|
+
return snapshot.contextActualTokens ?? snapshot.contextEstTokens;
|
|
159
|
+
}
|
|
@@ -8,6 +8,15 @@ export interface CredentialDatabaseOptions {
|
|
|
8
8
|
dbPath?: string;
|
|
9
9
|
wal?: boolean;
|
|
10
10
|
busyTimeoutMs?: number;
|
|
11
|
+
/**
|
|
12
|
+
* 把 `dbPath` 所在目录收紧到当前用户(POSIX 0700 / Windows ACL)。
|
|
13
|
+
*
|
|
14
|
+
* 默认 `false`:`dbPath` 是公开选项,调用方可能指向共享目录(`/var/lib/foo/app.db`),
|
|
15
|
+
* 不打招呼就 `chmod 700` 会把别人的服务状态一起锁掉。产品路径经
|
|
16
|
+
* {@link resolveCredentialPaths} 产出的专用目录,由 `CredentialStore.openDefault`
|
|
17
|
+
* 显式打开该开关;嵌入方指定自己的路径时自行负责目录权限。
|
|
18
|
+
*/
|
|
19
|
+
hardenDir?: boolean;
|
|
11
20
|
}
|
|
12
21
|
export interface CredentialPaths {
|
|
13
22
|
root: string;
|
|
@@ -3,8 +3,10 @@
|
|
|
3
3
|
*
|
|
4
4
|
* 与 knowledge.db / octopi.json 分离:资源级访问凭证,规模可随集成增长。
|
|
5
5
|
*/
|
|
6
|
+
import { statSync } from 'node:fs';
|
|
6
7
|
import { mkdir } from 'node:fs/promises';
|
|
7
8
|
import { dirname, join } from 'node:path';
|
|
9
|
+
import { restrictToOwner } from '../../../file-mode.js';
|
|
8
10
|
/**
|
|
9
11
|
* 解析 Credential 数据面路径
|
|
10
12
|
*
|
|
@@ -14,6 +16,48 @@ export function resolveCredentialPaths(octopiHome) {
|
|
|
14
16
|
const root = join(octopiHome, 'credentials');
|
|
15
17
|
return { root, dbPath: join(root, 'credentials.db') };
|
|
16
18
|
}
|
|
19
|
+
/**
|
|
20
|
+
* 把 Credential 数据面目录收紧到当前用户,并回溯收紧已存在的库文件。
|
|
21
|
+
*
|
|
22
|
+
* 为什么要做:`credentials.db` 与其边车(`-wal` / `-shm` / `-journal`)都生在这个目录里,
|
|
23
|
+
* 目录不收紧要等于库不收紧。此前是裸 `mkdir` —— POSIX 上按 umask 落成 0755(group/other
|
|
24
|
+
* 可读),Windows 上完全继承 OCTOPI_HOME 所在位置的 ACL(指到共享卷即他人可读)。
|
|
25
|
+
*
|
|
26
|
+
* 顺序要点:**先收紧目录、再 open 数据库**。SQLite 在打开期间创建/重建的边车会继承目录
|
|
27
|
+
* 的 ACE(Windows `(OI)(CI)` / POSIX 0700),因此不存在"新边车更宽"的窗口。
|
|
28
|
+
*
|
|
29
|
+
* 目录收紧失败即抛:宁可拒绝打开数据面,也不在已知可见的位置建库。已存在的文件回溯失败
|
|
30
|
+
* 只告警——库里是密文与引用,为它中断服务不划算,但绝不能假装已保护。
|
|
31
|
+
*
|
|
32
|
+
* @param root - Credential 数据面目录
|
|
33
|
+
* @param dbPath - 库文件路径(用于回溯收紧自身与边车)
|
|
34
|
+
* @throws 当目录无法收紧到当前用户时(错误带 `cause`)
|
|
35
|
+
*/
|
|
36
|
+
function hardenCredentialDir(root, dbPath) {
|
|
37
|
+
try {
|
|
38
|
+
restrictToOwner(root, 'dir');
|
|
39
|
+
}
|
|
40
|
+
catch (err) {
|
|
41
|
+
throw new Error(`[credentials] cannot restrict ${root} to the current user`, { cause: err });
|
|
42
|
+
}
|
|
43
|
+
// 目录收紧不会回溯改写已存在文件的 ACE —— 老库是在旧权限下建出来的。
|
|
44
|
+
// `-journal` 也要管:`wal: false` 或回滚日志模式下用它,升级前遗留的会保留旧 ACL。
|
|
45
|
+
for (const sibling of [dbPath, `${dbPath}-wal`, `${dbPath}-shm`, `${dbPath}-journal`]) {
|
|
46
|
+
try {
|
|
47
|
+
// 用 statSync 而不是 existsSync:少一次 TOCTOU 形状
|
|
48
|
+
statSync(sibling);
|
|
49
|
+
}
|
|
50
|
+
catch {
|
|
51
|
+
continue; // 不存在(正常路径:干净关闭后边车会被 SQLite 删掉)
|
|
52
|
+
}
|
|
53
|
+
try {
|
|
54
|
+
restrictToOwner(sibling, 'file');
|
|
55
|
+
}
|
|
56
|
+
catch (err) {
|
|
57
|
+
console.warn(`[credentials] could not restrict existing ${sibling} (${String(err)}); it stays readable per its current ACL`);
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
}
|
|
17
61
|
export class CredentialDatabase {
|
|
18
62
|
db;
|
|
19
63
|
constructor(db) {
|
|
@@ -33,7 +77,10 @@ export class CredentialDatabase {
|
|
|
33
77
|
}
|
|
34
78
|
const dbPath = options?.dbPath ?? ':memory:';
|
|
35
79
|
if (dbPath !== ':memory:') {
|
|
36
|
-
|
|
80
|
+
const root = dirname(dbPath);
|
|
81
|
+
await mkdir(root, { recursive: true });
|
|
82
|
+
if (options?.hardenDir)
|
|
83
|
+
hardenCredentialDir(root, dbPath);
|
|
37
84
|
}
|
|
38
85
|
const db = new DatabaseSyncCtor(dbPath, {
|
|
39
86
|
timeout: options?.busyTimeoutMs ?? 5000,
|
|
@@ -47,36 +94,80 @@ export class CredentialDatabase {
|
|
|
47
94
|
return cdb;
|
|
48
95
|
}
|
|
49
96
|
createTables() {
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
97
|
+
// v2(arch/multi-tenancy.md §4 域分离):唯一键 name → (name, scope_level, scope_key)。
|
|
98
|
+
// v1 的 UNIQUE(name) 是跨租户同名互覆的洞(同名 upsert 会写穿他租户);存量库重建迁移。
|
|
99
|
+
const CREATE_CREDENTIALS_V2 = `
|
|
100
|
+
CREATE TABLE IF NOT EXISTS credentials (
|
|
101
|
+
id TEXT PRIMARY KEY,
|
|
102
|
+
name TEXT NOT NULL,
|
|
103
|
+
kind TEXT NOT NULL,
|
|
104
|
+
description TEXT,
|
|
105
|
+
username TEXT,
|
|
106
|
+
header_name TEXT,
|
|
107
|
+
header_prefix TEXT,
|
|
108
|
+
secret_mode TEXT NOT NULL,
|
|
109
|
+
secret_env TEXT,
|
|
110
|
+
secret_cipher BLOB,
|
|
111
|
+
secret_nonce BLOB,
|
|
112
|
+
secret_file TEXT,
|
|
113
|
+
scope_level TEXT NOT NULL DEFAULT 'global',
|
|
114
|
+
scope_key TEXT NOT NULL DEFAULT 'global',
|
|
115
|
+
created_at INTEGER NOT NULL,
|
|
116
|
+
updated_at INTEGER NOT NULL,
|
|
117
|
+
last_used_at INTEGER,
|
|
118
|
+
expires_at INTEGER
|
|
119
|
+
);
|
|
120
|
+
`;
|
|
121
|
+
const CREATE_BINDINGS = `
|
|
122
|
+
CREATE TABLE IF NOT EXISTS credential_bindings (
|
|
123
|
+
credential_id TEXT NOT NULL,
|
|
124
|
+
consumer_kind TEXT NOT NULL,
|
|
125
|
+
consumer_id TEXT NOT NULL,
|
|
126
|
+
created_at INTEGER NOT NULL,
|
|
127
|
+
PRIMARY KEY (credential_id, consumer_kind, consumer_id)
|
|
128
|
+
);
|
|
129
|
+
`;
|
|
130
|
+
const tableExists = this.db
|
|
131
|
+
.prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'credentials'")
|
|
132
|
+
.get();
|
|
133
|
+
const domainIndexExists = this.db
|
|
134
|
+
.prepare("SELECT name FROM sqlite_master WHERE type = 'index' AND name = 'credentials_domain_name'")
|
|
135
|
+
.get();
|
|
136
|
+
if (tableExists && !domainIndexExists) {
|
|
137
|
+
// v1 → v2 迁移:整表重建(SQLite 改不了列级 UNIQUE;拷贝后原地换表)。
|
|
138
|
+
// 原子性(评审 MAJ-4):单事务内完成 + 失败 ROLLBACK 并抛出(fail-loud,半迁移库
|
|
139
|
+
// 不得继续使用);残留 v1 残表先清(MIN-1 前置);唯一索引并入同事务(MIN-1)。
|
|
140
|
+
this.db.exec('DROP TABLE IF EXISTS credentials_v1_legacy;');
|
|
141
|
+
this.db.exec('BEGIN IMMEDIATE;');
|
|
142
|
+
try {
|
|
143
|
+
this.db.exec(`
|
|
144
|
+
ALTER TABLE credentials RENAME TO credentials_v1_legacy;
|
|
145
|
+
${CREATE_CREDENTIALS_V2}
|
|
146
|
+
INSERT INTO credentials (
|
|
147
|
+
id, name, kind, description, username, header_name, header_prefix,
|
|
148
|
+
secret_mode, secret_env, secret_cipher, secret_nonce, secret_file,
|
|
149
|
+
scope_level, scope_key, created_at, updated_at, last_used_at, expires_at
|
|
150
|
+
)
|
|
151
|
+
SELECT
|
|
152
|
+
id, name, kind, description, username, header_name, header_prefix,
|
|
153
|
+
secret_mode, secret_env, secret_cipher, secret_nonce, secret_file,
|
|
154
|
+
scope_level, scope_key, created_at, updated_at, last_used_at, expires_at
|
|
155
|
+
FROM credentials_v1_legacy;
|
|
156
|
+
DROP TABLE credentials_v1_legacy;
|
|
157
|
+
CREATE UNIQUE INDEX credentials_domain_name ON credentials(name, scope_level, scope_key);
|
|
158
|
+
`);
|
|
159
|
+
this.db.exec('COMMIT;');
|
|
160
|
+
}
|
|
161
|
+
catch (err) {
|
|
162
|
+
this.db.exec('ROLLBACK;');
|
|
163
|
+
throw err;
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
else {
|
|
167
|
+
this.db.exec(CREATE_CREDENTIALS_V2);
|
|
168
|
+
this.db.exec('CREATE UNIQUE INDEX IF NOT EXISTS credentials_domain_name ON credentials(name, scope_level, scope_key);');
|
|
169
|
+
}
|
|
170
|
+
this.db.exec(CREATE_BINDINGS);
|
|
80
171
|
}
|
|
81
172
|
get raw() {
|
|
82
173
|
return this.db;
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* 永不通过 list/get 返回明文密钥;resolve 时校验 expiresAt,过期返回 null。
|
|
6
6
|
*/
|
|
7
7
|
import { CredentialDatabase } from './db.js';
|
|
8
|
-
import { type CredentialConsumerRef, type CredentialMeta, type CredentialWrite, type ResolvedCredential } from './types.js';
|
|
8
|
+
import { type CredentialConsumerRef, type CredentialMeta, type CredentialScopeRef, type CredentialWrite, type ResolvedCredential } from './types.js';
|
|
9
9
|
export declare class CredentialStore {
|
|
10
10
|
private db;
|
|
11
11
|
/** true 时无绑定的凭证不可 resolve(部署拧紧 / untrusted) */
|
|
@@ -16,6 +16,7 @@ export declare class CredentialStore {
|
|
|
16
16
|
static open(options?: {
|
|
17
17
|
dbPath?: string;
|
|
18
18
|
requireBindings?: boolean;
|
|
19
|
+
hardenDir?: boolean;
|
|
19
20
|
}): Promise<CredentialStore>;
|
|
20
21
|
/**
|
|
21
22
|
* 按 OCTOPI_HOME 打开默认 credentials.db
|
|
@@ -31,13 +32,51 @@ export declare class CredentialStore {
|
|
|
31
32
|
* @returns 无密文元数据
|
|
32
33
|
*/
|
|
33
34
|
set(write: CredentialWrite): CredentialMeta;
|
|
35
|
+
/** 按域精确定位(唯一键 (name, scope_level, scope_key)) */ private findByScope;
|
|
36
|
+
/**
|
|
37
|
+
* 域内按名定位(§4 域分离):
|
|
38
|
+
* - 有归属租户:本租户私有(level=tenant, key=tenantId)优先——同名遮蔽平台同名;
|
|
39
|
+
* 平台域兜底;他租户私有对本域不存在(不泄露存在性)。
|
|
40
|
+
* - 无归属:**平台域**(level != tenant,含管理域 project/agent/plugin),不含任何
|
|
41
|
+
* 租户私有行——租户密文只经归属租户解析(MAJ-10/评审 MIN-18:unattributed 解析
|
|
42
|
+
* 不得成为读他租户密文的旁路)。管理面(get/list/delete)仍可不带域查看全量元数据。
|
|
43
|
+
*/
|
|
44
|
+
private findRow;
|
|
34
45
|
private hasCipher;
|
|
35
46
|
/**
|
|
36
|
-
*
|
|
47
|
+
* 读元数据(无密文)。
|
|
48
|
+
* 同名跨域(遮蔽)时:给 scope 精确定位;不给取最早登记(宿主面确定性视图)。
|
|
49
|
+
*
|
|
50
|
+
* @param name - 凭证名
|
|
51
|
+
* @param scope - 域(level/key);缺省不限域
|
|
37
52
|
*/
|
|
38
|
-
get(name: string): CredentialMeta | null;
|
|
53
|
+
get(name: string, scope?: CredentialScopeRef): CredentialMeta | null;
|
|
39
54
|
list(): CredentialMeta[];
|
|
40
|
-
|
|
55
|
+
/**
|
|
56
|
+
* 删除凭证(含绑定)。同名跨域且未给 scope = 歧义 fail-loud——域唯一后
|
|
57
|
+
* name 不再是唯一身份,静默删错行等于数据事故。
|
|
58
|
+
*
|
|
59
|
+
* @param name - 凭证名
|
|
60
|
+
* @param scope - 域(level/key);缺省不限域
|
|
61
|
+
* @returns 是否删除了记录
|
|
62
|
+
*/
|
|
63
|
+
delete(name: string, scope?: CredentialScopeRef): boolean;
|
|
64
|
+
/** 按名(可选域)取全部匹配行 */
|
|
65
|
+
private findAll;
|
|
66
|
+
/** 按名(可选域)定位唯一行;歧义 fail-loud(写路径专用) */
|
|
67
|
+
private requireNamed;
|
|
68
|
+
/**
|
|
69
|
+
* 用时解析为明文 secret(短命;调用方禁止日志/持久化)。
|
|
70
|
+
* 消费约束与 {@link resolve} 相同(SEC-3c 绑定检查、过期返回 null)。
|
|
71
|
+
* 供插件 secret 原语(api.secrets)等非 header 形态的消费者使用。
|
|
72
|
+
*
|
|
73
|
+
* @param name - 凭证名
|
|
74
|
+
* @param consumer - 消费方;绑定非空时必填
|
|
75
|
+
* @param options - requireBindings 覆盖
|
|
76
|
+
* @returns 明文 secret;无档、无密钥材料或过期时 null
|
|
77
|
+
* @throws 绑定策略拒绝时抛错(勿静默降级)
|
|
78
|
+
*/
|
|
79
|
+
reveal(name: string, consumer?: import('./types.js').CredentialConsumerRef | null, options?: import('./types.js').ResolveCredentialOptions): Promise<string | null>;
|
|
41
80
|
/**
|
|
42
81
|
* 用时解析为请求头(短命;调用方禁止日志)。
|
|
43
82
|
* 消费侧强制 `credential_bindings`(SEC-3c):绑定非空须命中 consumer;
|
|
@@ -50,9 +89,31 @@ export declare class CredentialStore {
|
|
|
50
89
|
* @throws 绑定策略拒绝时抛错(勿静默降级)
|
|
51
90
|
*/
|
|
52
91
|
resolve(name: string, consumer?: import('./types.js').CredentialConsumerRef | null, options?: import('./types.js').ResolveCredentialOptions): Promise<ResolvedCredential | null>;
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
92
|
+
/** 明文解析单一实现点(reveal/resolve 共用):材料解析 + 绑定检查 + last_used_at。 */
|
|
93
|
+
private revealSecret;
|
|
94
|
+
/**
|
|
95
|
+
* 绑定消费方。同名跨域且未给 scope = 歧义 fail-loud。
|
|
96
|
+
*
|
|
97
|
+
* @param consumer - 消费方
|
|
98
|
+
* @param name - 凭证名
|
|
99
|
+
* @param scope - 域(level/key);缺省不限域
|
|
100
|
+
*/
|
|
101
|
+
bind(consumer: CredentialConsumerRef, name: string, scope?: CredentialScopeRef): void;
|
|
102
|
+
/**
|
|
103
|
+
* 解绑消费方。同名跨域且未给 scope = 歧义 fail-loud。
|
|
104
|
+
*
|
|
105
|
+
* @param consumer - 消费方
|
|
106
|
+
* @param name - 凭证名
|
|
107
|
+
* @param scope - 域(level/key);缺省不限域
|
|
108
|
+
*/
|
|
109
|
+
unbind(consumer: CredentialConsumerRef, name: string, scope?: CredentialScopeRef): void;
|
|
110
|
+
/**
|
|
111
|
+
* 列绑定(按命中行 id;同名跨域给 scope 定位)。
|
|
112
|
+
*
|
|
113
|
+
* @param name - 凭证名
|
|
114
|
+
* @param scope - 域(level/key);缺省不限域(取最早登记)
|
|
115
|
+
*/
|
|
116
|
+
listBindings(name: string, scope?: CredentialScopeRef): Array<{
|
|
56
117
|
kind: string;
|
|
57
118
|
id: string;
|
|
58
119
|
}>;
|