@sema-agent/core 7.59.0 → 7.61.0
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/CHANGELOG.md +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +106 -32
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +15 -0
- package/dist/core/frame-settlement.js +10 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +9 -6
- package/dist/core/gate-lanes.js +46 -12
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +55 -3
- package/dist/core/locked-config.js +84 -51
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +23 -55
- package/dist/core/mcp.js +172 -156
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +29 -10
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/skills-seat.js +2 -2
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -4
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +3 -6
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
package/dist/core/tool-policy.js
CHANGED
|
@@ -3,16 +3,17 @@ import { homedir } from "node:os";
|
|
|
3
3
|
import { argsReadFrom, carryArgsReadFrom, withArgsReading } from "./effective-path-target.js";
|
|
4
4
|
import { editRewrittenSentence, readRejudge, rewriteChasedSentence } from "./rewrite-rejudge.js";
|
|
5
5
|
import { brandPolicyAskClass } from "./ask-class.js";
|
|
6
|
-
import { decisionAskClassesOf, headlessDenialMessage } from "./ask-origin.js";
|
|
6
|
+
import { decisionAskClassesOf, headlessDenialMessage, joinAskReasons } from "./ask-origin.js";
|
|
7
7
|
import { attest, attestationOf, isEngineAttestation, mergeAttestation, mintAttestation, withAttestation } from "./engine-attestation.js";
|
|
8
8
|
import { ownReadRootCandidate, readRootGrantSeat } from "./read-root-grant-screen.js";
|
|
9
|
-
import { decidersNote, settledByDecider } from "./gate-outcome.js";
|
|
9
|
+
import { DECIDED_VIA, decidersNote, isDecidedVia, policyDeciderOf, settledByDecider } from "./gate-outcome.js";
|
|
10
10
|
import { unjudgedAllowRefused } from "./real-approval.js";
|
|
11
11
|
export { policyCannotAnswer, rowDemandsAPerson } from "./real-approval.js";
|
|
12
12
|
import { sanitizeAutoModeArmingRecipe } from "./auto-mode-arming.js";
|
|
13
13
|
import { join, normalize as normalizePath, sep } from "node:path";
|
|
14
14
|
import { BASH_READONLY_DEFAULT_ALLOW, parseLeadingCommandName } from "../tools/fs/index.js";
|
|
15
15
|
import { readOnlyShellVerdict } from "./read-only-shell.js";
|
|
16
|
+
import { DEFAULT_GATE_AWAIT_TIMEOUT_MS, withGateTimeout } from "./gate-bounded-await.js";
|
|
16
17
|
import { protectivePathTargetOf, shellFaceToolNames } from "./tool-registry.js";
|
|
17
18
|
import { heldBy } from "./tool-name-readings.js";
|
|
18
19
|
import { bindableValueOf, boundInputHashOf, describeBindingFault, exactBoundInputHashOf } from "./canonical-json.js";
|
|
@@ -20,7 +21,7 @@ import { delimitUntrusted, inlineUntrusted, REVIEWER_NOTE_MAX_BODY } from "./unt
|
|
|
20
21
|
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
21
22
|
import { egressText, egressThrownText } from "./untrusted-egress.js";
|
|
22
23
|
import { assertNoRetiredKeys, assertNoRetiredToolPolicyKeys, RETIRED_DECISION_MEMBERS, RETIRED_TOOL_POLICY_KEYS } from "./retired-keys.js";
|
|
23
|
-
import { DECISION_MEMBER_ARMS, isEngineRefusal, nestedRecordsOf, receiveContract, receiveNestedRecords, refusedOutOfContract, screenContractValues } from "./decision-receipt.js";
|
|
24
|
+
import { DECISION_MEMBER_ARMS, HOOK_SEAT_MEMBER_ARMS, isEngineRefusal, nestedRecordsOf, receiveContract, receiveNestedRecords, refusedOutOfContract, screenContractValues } from "./decision-receipt.js";
|
|
24
25
|
export { isEngineRefusal } from "./decision-receipt.js";
|
|
25
26
|
import { isCoveringRuleName, ruleNameCovers } from "./namespaced-rule-name.js";
|
|
26
27
|
import { ruleContentOf } from "./permission-rule-model.js";
|
|
@@ -80,6 +81,19 @@ export function screenApproverAttribution(v) {
|
|
|
80
81
|
}
|
|
81
82
|
return { approver: v };
|
|
82
83
|
}
|
|
84
|
+
export function screenDecidedVia(v, word) {
|
|
85
|
+
if (v === undefined)
|
|
86
|
+
return {};
|
|
87
|
+
if (!isDecidedVia(v)) {
|
|
88
|
+
return {
|
|
89
|
+
defect: `decidedVia is outside the closed set (got ${v === null ? "null" : typeof v === "string" ? "a string that is not a member" : typeof v}) — it is exactly ${DECIDED_VIA.map((w) => `"${w}"`).join(" or ")}, or omitted`,
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
if (word !== "policy") {
|
|
93
|
+
return { defect: `decidedVia names which machine seat answered for the deployment's policy, and this decision reports "${word}" — the member rides a "policy" decision only` };
|
|
94
|
+
}
|
|
95
|
+
return { decidedVia: v };
|
|
96
|
+
}
|
|
83
97
|
export const ASK_EVIDENCE_ABSENCE_VALUES = ["not_wired", "not_adjudicated", "unavailable", "no_match", "not_reported"];
|
|
84
98
|
export function decisionText(d) {
|
|
85
99
|
return d.message;
|
|
@@ -106,7 +120,9 @@ export function answeredFor(d, call, runs) {
|
|
|
106
120
|
const record = attestationOf(d, call);
|
|
107
121
|
return record?.settlement !== undefined && licenseCovers(record.inputDigest, runs);
|
|
108
122
|
}
|
|
109
|
-
const
|
|
123
|
+
export const REFUSES_NO_WHOLE_TOOL = () => false;
|
|
124
|
+
export const TOOL_TABLE_VIEW_READ = "tool-table-view";
|
|
125
|
+
const TOOL_POLICY_CARRIED_MEMBERS = ["projection", "pathRules", "writeGuardRows", "nameSets", "wholeToolRefusals"];
|
|
110
126
|
export function carriedMembersOf(p) {
|
|
111
127
|
assertNoRetiredKeys(p, RETIRED_TOOL_POLICY_KEYS, "ToolPolicy");
|
|
112
128
|
const out = {};
|
|
@@ -131,6 +147,31 @@ export function toolPolicyWriteGuardRows(policies) {
|
|
|
131
147
|
return undefined;
|
|
132
148
|
return async (at) => (await Promise.all(sources.map((rowsOf) => rowsOf(at)))).flat();
|
|
133
149
|
}
|
|
150
|
+
const FOLDED_WHOLE_TOOL_READS = new WeakMap();
|
|
151
|
+
function settledWholeToolRead(read, signal) {
|
|
152
|
+
return withGateTimeout(Promise.resolve().then(() => read(signal)), DEFAULT_GATE_AWAIT_TIMEOUT_MS, signal, "a whole-tool reading").then((judge) => (tool) => {
|
|
153
|
+
try {
|
|
154
|
+
return judge(tool) === true;
|
|
155
|
+
}
|
|
156
|
+
catch {
|
|
157
|
+
return false;
|
|
158
|
+
}
|
|
159
|
+
}, () => REFUSES_NO_WHOLE_TOOL);
|
|
160
|
+
}
|
|
161
|
+
export function toolPolicyWholeToolRefusals(holders) {
|
|
162
|
+
const sources = [...new Set(holders.flatMap((h) => {
|
|
163
|
+
const read = h?.wholeToolRefusals;
|
|
164
|
+
return typeof read === "function" ? (FOLDED_WHOLE_TOOL_READS.get(read) ?? [read]) : [];
|
|
165
|
+
}))];
|
|
166
|
+
if (sources.length === 0)
|
|
167
|
+
return undefined;
|
|
168
|
+
const combined = async (signal) => {
|
|
169
|
+
const judges = await Promise.all(sources.map((read) => settledWholeToolRead(read, signal)));
|
|
170
|
+
return (tool) => judges.some((refuses) => refuses(tool));
|
|
171
|
+
};
|
|
172
|
+
FOLDED_WHOLE_TOOL_READS.set(combined, sources);
|
|
173
|
+
return combined;
|
|
174
|
+
}
|
|
134
175
|
export function coveringRuleEntries(entries, behavior) {
|
|
135
176
|
return (entries ?? []).filter((entry) => isCoveringRuleName(entry, behavior));
|
|
136
177
|
}
|
|
@@ -187,7 +228,7 @@ export function constraintChainEntryOf(policy, meta) {
|
|
|
187
228
|
...(meta?.durableMandate ? { durableMandate: true } : {}),
|
|
188
229
|
...(meta?.contentMandate ? { contentMandate: true } : {}),
|
|
189
230
|
};
|
|
190
|
-
const p = policy
|
|
231
|
+
const p = policy?.projection;
|
|
191
232
|
if (p === undefined)
|
|
192
233
|
return { opaque: true, ...m };
|
|
193
234
|
return { components: p.components, requiresLiveRemainder: p.requiresLiveRemainder, ...m };
|
|
@@ -220,7 +261,7 @@ export function constraintChainDigest(chain) {
|
|
|
220
261
|
}
|
|
221
262
|
const ALLOW = Object.freeze({ action: "allow" });
|
|
222
263
|
export const DECISION_MEMBERS = Object.keys(DECISION_MEMBER_ARMS);
|
|
223
|
-
const HOOK_RESULT_MEMBERS = [...DECISION_MEMBERS,
|
|
264
|
+
const HOOK_RESULT_MEMBERS = [...DECISION_MEMBERS, ...Object.keys(HOOK_SEAT_MEMBER_ARMS)];
|
|
224
265
|
const HOOK_SEAM_UNREAD = new Set(["decisionReason"]);
|
|
225
266
|
const HOOK_SEAM_OPTIONAL = new Set(["action"]);
|
|
226
267
|
const HOOK_RECEIPTS = new WeakSet();
|
|
@@ -383,7 +424,9 @@ export function createAllowDenyPolicy(opts) {
|
|
|
383
424
|
const deny = new Set(opts.deny ?? []);
|
|
384
425
|
const denyCovering = coveringRuleEntries(opts.deny, "deny");
|
|
385
426
|
const allowCovering = coveringRuleEntries(opts.allow, "allow");
|
|
427
|
+
const refusesWhole = (tool) => nameListHolds(deny, tool) || coveringRuleHit(denyCovering, tool);
|
|
386
428
|
return {
|
|
429
|
+
...(deny.size > 0 ? { wholeToolRefusals: () => Promise.resolve(refusesWhole) } : {}),
|
|
387
430
|
projection: {
|
|
388
431
|
components: [
|
|
389
432
|
...(opts.deny && opts.deny.length > 0 ? [{ kind: "tool_deny", names: [...opts.deny] }] : []),
|
|
@@ -393,9 +436,8 @@ export function createAllowDenyPolicy(opts) {
|
|
|
393
436
|
},
|
|
394
437
|
nameSets: [{ ...(opts.allow ? { allow: [...opts.allow] } : {}), ...(opts.deny ? { deny: [...opts.deny] } : {}) }],
|
|
395
438
|
check(req) {
|
|
396
|
-
if (
|
|
439
|
+
if (refusesWhole(req))
|
|
397
440
|
return { action: "deny", message: `tool "${req.toolName}" is denied by policy` };
|
|
398
|
-
}
|
|
399
441
|
if (allow && !nameListHolds(allow, req) && !coveringRuleHit(allowCovering, req)) {
|
|
400
442
|
return { action: "deny", message: `tool "${req.toolName}" is not in the allowlist` };
|
|
401
443
|
}
|
|
@@ -428,7 +470,9 @@ export function createApprovalPolicy(opts) {
|
|
|
428
470
|
const needCovering = coveringRuleEntries(opts.requireApproval, "ask");
|
|
429
471
|
const denyCovering = coveringRuleEntries(opts.deny, "deny");
|
|
430
472
|
const autoCovering = coveringRuleEntries(opts.autoAllow, "allow");
|
|
473
|
+
const refusesWhole = (tool) => nameListHolds(deny, tool) || coveringRuleHit(denyCovering, tool);
|
|
431
474
|
return {
|
|
475
|
+
...(deny.size > 0 ? { wholeToolRefusals: () => Promise.resolve(refusesWhole) } : {}),
|
|
432
476
|
projection: {
|
|
433
477
|
components: [
|
|
434
478
|
...(opts.deny && opts.deny.length > 0 ? [{ kind: "tool_deny", names: [...opts.deny] }] : []),
|
|
@@ -444,9 +488,8 @@ export function createApprovalPolicy(opts) {
|
|
|
444
488
|
},
|
|
445
489
|
],
|
|
446
490
|
async check(req, signal) {
|
|
447
|
-
if (
|
|
491
|
+
if (refusesWhole(req))
|
|
448
492
|
return { action: "deny", message: `tool "${req.toolName}" is denied by policy` };
|
|
449
|
-
}
|
|
450
493
|
if (nameListHolds(need, req) || coveringRuleHit(needCovering, req)) {
|
|
451
494
|
const attestOver = (inputDigest) => (d, settlement, bindingRefusal) => ({ ...d, attestation: mintAttestation(req, { settlement, origin: "policy", ...(inputDigest !== undefined ? { inputDigest } : {}), ...(bindingRefusal !== undefined ? { bindingRefusal } : {}) }) });
|
|
452
495
|
const unasked = unaskedSeatAnswer(req, signal, { aborted: `approval aborted for "${req.toolName}" (run or turn interrupted)`, unreachable: `approval for "${req.toolName}" was not requested: nobody can be asked about this call` }, "policy");
|
|
@@ -488,7 +531,7 @@ export function createApprovalPolicy(opts) {
|
|
|
488
531
|
return attest({
|
|
489
532
|
action: "deny",
|
|
490
533
|
message: reading.word === "policy"
|
|
491
|
-
? policyRefusalMessage(req.toolName, undefined, reading.note)
|
|
534
|
+
? policyRefusalMessage(req.toolName, undefined, reading.note, reading.via)
|
|
492
535
|
: reading.word === "timeout"
|
|
493
536
|
? `no one answered the approval request for "${req.toolName}" — the approver reported its own window elapsed with no answer; denied fail-closed${reading.note !== undefined ? `\nReviewer note:\n${delimitUntrusted("reviewer note", reading.note, REVIEWER_NOTE_MAX_BODY)}` : ""}`
|
|
494
537
|
: `approval denied for "${req.toolName}"${reading.note !== undefined ? `\nReviewer note:\n${delimitUntrusted("reviewer note", reading.note, REVIEWER_NOTE_MAX_BODY)}` : ""}`,
|
|
@@ -547,6 +590,7 @@ export function combinePolicies(...policies) {
|
|
|
547
590
|
nameSets: nameSets.length > 0 ? nameSets : undefined,
|
|
548
591
|
pathRules: pathRuled.length > 0 ? (anchors) => toolPolicyPathRules(pathRuled, anchors) : undefined,
|
|
549
592
|
writeGuardRows,
|
|
593
|
+
wholeToolRefusals: toolPolicyWholeToolRefusals(policies),
|
|
550
594
|
};
|
|
551
595
|
return {
|
|
552
596
|
...carriedMembersOf(folded),
|
|
@@ -887,16 +931,28 @@ export function tryCloneArgs(v) {
|
|
|
887
931
|
export function refusalOf(deny, judged) {
|
|
888
932
|
return deny.action !== "deny" || deny.updatedInput !== undefined ? deny : { ...deny, updatedInput: judged };
|
|
889
933
|
}
|
|
934
|
+
export function extensionSpeaker(by, reason) {
|
|
935
|
+
return { who: by !== undefined ? extensionNamed(by) : "an extension", why: reason !== undefined ? `: ${inlineUntrusted(reason, 500)}` : "" };
|
|
936
|
+
}
|
|
937
|
+
export function extensionNamed(registration) {
|
|
938
|
+
return `extension ${JSON.stringify(inlineUntrusted(registration, 80))}`;
|
|
939
|
+
}
|
|
940
|
+
export function extensionQuestionText(toolName, entry) {
|
|
941
|
+
const who = entry.registration !== undefined ? extensionNamed(entry.registration) : "an extension";
|
|
942
|
+
const why = entry.cause === "verdict_unreadable" ? ": the hook's verdict could not be read" : entry.cause === "verdict_unfinished" ? ": the hook did not finish with a verdict" : entry.words !== undefined ? `: ${entry.words}` : "";
|
|
943
|
+
return `tool "${toolName}" needs approval (asked by ${who}${why})`;
|
|
944
|
+
}
|
|
890
945
|
export function foldHookAsk(verdict, hookAsk) {
|
|
891
946
|
if (verdict.action === "deny")
|
|
892
947
|
return verdict;
|
|
893
948
|
const mandate = { ...(hookAsk.requiresRealApproval === true ? { requiresRealApproval: true } : {}), ...(hookAsk.crossBoundaryMandated === true ? { crossBoundaryMandated: true } : {}) };
|
|
894
949
|
if (verdict.action === "allow") {
|
|
895
|
-
return { action: "ask", ...(hookAsk.message !== undefined ? { message: hookAsk.message } : {}), decisionReason: "hook", ...mandate, ...(hookAsk.updatedInput !== undefined ? { updatedInput: hookAsk.updatedInput } : {}) };
|
|
950
|
+
return { action: "ask", ...(hookAsk.message !== undefined ? { message: hookAsk.message } : {}), decisionReason: "hook", ...mandate, ...(hookAsk.updatedInput !== undefined ? { updatedInput: hookAsk.updatedInput } : {}), ...(hookAsk.askReasons !== undefined ? { askReasons: hookAsk.askReasons } : {}) };
|
|
896
951
|
}
|
|
897
952
|
const hookMessage = hookAsk.message;
|
|
898
953
|
const message = hookMessage !== undefined && hookMessage !== verdict.message ? `${verdict.message !== undefined ? `${verdict.message} ` : ""}(a PreToolUse hook also asks: ${hookMessage})` : verdict.message;
|
|
899
|
-
|
|
954
|
+
const askReasons = joinAskReasons(verdict.askReasons, hookAsk.askReasons);
|
|
955
|
+
return { ...verdict, decisionReason: "hook", ...(message !== undefined ? { message } : {}), ...mandate, ...(askReasons !== undefined ? { askReasons } : {}) };
|
|
900
956
|
}
|
|
901
957
|
const OWNED_ARGS = new WeakSet();
|
|
902
958
|
export function ownArgs(v, root = "args") {
|
|
@@ -987,7 +1043,14 @@ export function humanRefusalSentence(subject, reason, delegatedChild) {
|
|
|
987
1043
|
function humanRefusalMessage(req, reason) {
|
|
988
1044
|
return `approval denied for "${req.toolName}": ${req.message}\n${humanRefusalSentence("tool use", reason, req.isDelegatedChild === true)}`;
|
|
989
1045
|
}
|
|
990
|
-
export function policyRefusalMessage(toolName, askMessage, note) {
|
|
1046
|
+
export function policyRefusalMessage(toolName, askMessage, note, decidedVia) {
|
|
1047
|
+
const decider = policyDeciderOf(decidedVia);
|
|
1048
|
+
if (decider.seat !== "policy") {
|
|
1049
|
+
const declined = `${decider.name} denied this call to "${toolName}"${askMessage !== undefined ? `: ${askMessage}` : ""}\nThe call did NOT run. Do not claim it ` +
|
|
1050
|
+
`succeeded and do not retry it unchanged; report what was blocked and why you needed it, then continue with the parts of ` +
|
|
1051
|
+
`the task it does not block.`;
|
|
1052
|
+
return note === undefined ? declined : `${declined}\nHook reason:\n${delimitUntrusted("hook reason", note, REVIEWER_NOTE_MAX_BODY)}`;
|
|
1053
|
+
}
|
|
991
1054
|
const head = `approval required for "${toolName}" but this run has no interactive approval channel${askMessage !== undefined ? `: ${askMessage}` : ""}`;
|
|
992
1055
|
const body = `${head}\nThe deployment's policy declined this tool use; the call did NOT run. Action requires interactive approval and ` +
|
|
993
1056
|
`permission prompts are not available in this context. Do not claim it succeeded and do not retry it here; report what ` +
|
|
@@ -1126,12 +1189,14 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
|
|
|
1126
1189
|
let allowed;
|
|
1127
1190
|
let suppliedEdit;
|
|
1128
1191
|
let suppliedApprover;
|
|
1192
|
+
let suppliedVia;
|
|
1129
1193
|
let grant;
|
|
1130
1194
|
try {
|
|
1131
1195
|
supplied = ok.settledBy;
|
|
1132
1196
|
allowed = ok.allow;
|
|
1133
1197
|
suppliedEdit = ok.updatedInput;
|
|
1134
1198
|
suppliedApprover = ok.approver;
|
|
1199
|
+
suppliedVia = ok.decidedVia;
|
|
1135
1200
|
grant = ok.readRootGrant;
|
|
1136
1201
|
}
|
|
1137
1202
|
catch (err) {
|
|
@@ -1150,6 +1215,10 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
|
|
|
1150
1215
|
if (attribution.defect !== undefined) {
|
|
1151
1216
|
return refused(`the approver for "${toolName}" reported an attribution this seam refuses: ${attribution.defect}; denied fail-closed`, settledByNobody("approver_contract"));
|
|
1152
1217
|
}
|
|
1218
|
+
const via = screenDecidedVia(suppliedVia, settledWord);
|
|
1219
|
+
if (via.defect !== undefined) {
|
|
1220
|
+
return refused(`the approver for "${toolName}" reported a decidedVia this seam refuses: ${via.defect}; denied fail-closed`, settledByNobody("approver_contract"));
|
|
1221
|
+
}
|
|
1153
1222
|
if (editLane === "none" && grant !== undefined) {
|
|
1154
1223
|
return refused(`the approver for "${toolName}" attached a readRootGrant on a seat that offers no directory — denied fail-closed (a grant answers an approval card's readRootCandidate)`, settledByNobody("approver_contract"));
|
|
1155
1224
|
}
|
|
@@ -1172,6 +1241,7 @@ function readApproverOutcomeObject(ok, toolName, editLane) {
|
|
|
1172
1241
|
kind: "deny",
|
|
1173
1242
|
word: settledWord,
|
|
1174
1243
|
note,
|
|
1244
|
+
via: via.decidedVia,
|
|
1175
1245
|
grant,
|
|
1176
1246
|
settlement: decider === undefined ? { kind: "approval_window_expired", who: { party: "host" }, when: Date.now() } : settledByDecider(decider, "refused", attribution.approver, note),
|
|
1177
1247
|
};
|
|
@@ -1284,7 +1354,7 @@ async function resolveAskArms(req, onAsk, signal, onLateSettlement) {
|
|
|
1284
1354
|
message: reading.word === "timeout"
|
|
1285
1355
|
? `approval for "${req.toolName}" was not answered before the approver's own window elapsed: ${req.message}${reading.note !== undefined ? `\nReviewer note:\n${delimitUntrusted("reviewer note", reading.note, REVIEWER_NOTE_MAX_BODY)}` : ""}`
|
|
1286
1356
|
: reading.word === "policy"
|
|
1287
|
-
? policyRefusalMessage(req.toolName, req.message, reading.note)
|
|
1357
|
+
? policyRefusalMessage(req.toolName, req.message, reading.note, reading.via)
|
|
1288
1358
|
: humanRefusalMessage(req, reading.note),
|
|
1289
1359
|
decisionReason: "mode",
|
|
1290
1360
|
settlement: reading.settlement,
|
|
@@ -43,14 +43,14 @@ export interface PersistenceFacts {
|
|
|
43
43
|
readonly exclude?: readonly string[];
|
|
44
44
|
/** The leg's by-name effect map: the fallback for a tool that declares no `effect` of its own (silent ⇒ `"write"`). */
|
|
45
45
|
readonly effects?: ReadonlyMap<string, import("./tool-spec.js").ToolEffect>;
|
|
46
|
-
/** The hand band is mounted on
|
|
47
|
-
* root, so their presence proves nothing about persistence there. */
|
|
48
|
-
readonly
|
|
46
|
+
/** The hand band is mounted on an env whose paths are not the host's (`pathsAreHostLocal` is false): its file tools
|
|
47
|
+
* write that filesystem, not the host-side memory root, so their presence proves nothing about persistence there. */
|
|
48
|
+
readonly handsOffHost: boolean;
|
|
49
49
|
}
|
|
50
50
|
/**
|
|
51
51
|
* The names, among a run's MOUNTED tools (instances, whose face members sit on the object itself), the persistence
|
|
52
52
|
* judgment passes. The judgment's inputs beyond the tools (the exclude snapshot, the by-name effect map, whether the
|
|
53
|
-
* hand band is
|
|
53
|
+
* hand band is off the host's disk) are leg facts only the run holds; {@link rosterCanPersistMemory} is the verdict built on it.
|
|
54
54
|
*/
|
|
55
55
|
export declare function persistenceCapableToolNames(tools: ReadonlyArray<PersistenceProbeTool>, facts: PersistenceFacts): string[];
|
|
56
56
|
/**
|
|
@@ -61,7 +61,7 @@ export declare function persistenceCapableToolNames(tools: ReadonlyArray<Persist
|
|
|
61
61
|
export declare function rosterCanPersistMemory(tools: ReadonlyArray<PersistenceProbeTool>, facts: PersistenceFacts, declared?: boolean): boolean;
|
|
62
62
|
/**
|
|
63
63
|
* The CANDIDATE set, from the static catalog alone: the names whose definition passes the same judgment on no leg
|
|
64
|
-
* facts at all (nothing excluded, no by-name effect map, hands
|
|
64
|
+
* facts at all (nothing excluded, no by-name effect map, hands on the host's disk) — the tools that COULD persist on a leg
|
|
65
65
|
* that mounts them. A prediction, not a verdict: whether a given run's roster persists is
|
|
66
66
|
* {@link rosterCanPersistMemory}, which the runner calls with the facts the run holds.
|
|
67
67
|
*/
|
|
@@ -36,7 +36,7 @@ function toolCanPersist(t, facts) {
|
|
|
36
36
|
const family = t.family ?? catalogEntriesNamed(t.name)[0]?.face.family;
|
|
37
37
|
if (!((pathTarget !== undefined && pathTarget.access !== "read") || family === "shell"))
|
|
38
38
|
return false;
|
|
39
|
-
return !facts.
|
|
39
|
+
return !facts.handsOffHost;
|
|
40
40
|
}
|
|
41
41
|
export function persistenceCapableToolNames(tools, facts) {
|
|
42
42
|
const out = new Set();
|
|
@@ -50,7 +50,7 @@ export function rosterCanPersistMemory(tools, facts, declared) {
|
|
|
50
50
|
}
|
|
51
51
|
export function persistenceCandidateToolNames() {
|
|
52
52
|
const rows = TOOL_CATALOG_ENTRIES.map((e) => ({ name: e.name, effect: e.face.effect, pathTarget: e.face.pathTarget, family: e.face.family }));
|
|
53
|
-
return persistenceCapableToolNames(rows, {
|
|
53
|
+
return persistenceCapableToolNames(rows, { handsOffHost: false });
|
|
54
54
|
}
|
|
55
55
|
export function pathTargetingToolNames() {
|
|
56
56
|
return names((e) => e.face.pathTarget !== undefined);
|
|
@@ -118,6 +118,75 @@ export interface ToolResultStore {
|
|
|
118
118
|
* audit receipts, scheduled execution), of which this is one caller-driven erase.
|
|
119
119
|
*/
|
|
120
120
|
deleteBySession?(sessionId: string): Promise<ToolResultDeletionReport> | ToolResultDeletionReport;
|
|
121
|
+
/**
|
|
122
|
+
* Age out the entries stored more than `opts.maxAgeMs` before `now` (epoch ms): the age bound a deployment states for
|
|
123
|
+
* offloaded results, read the same way by every backend — a SQL backend's sweep leg reads the same bound. An entry's
|
|
124
|
+
* age is the time its winning write stored it; the content and its owner record go together. Answers how many
|
|
125
|
+
* entries it removed.
|
|
126
|
+
*
|
|
127
|
+
* Rules every implementation follows:
|
|
128
|
+
* - **no bound, no deletion**: `opts` or `opts.maxAgeMs` absent ⇒ nothing is removed — the default keeps every
|
|
129
|
+
* entry, as a transcript is kept;
|
|
130
|
+
* - **a bound that cannot be evaluated is refused** before any entry is touched (`config.retention_policy_invalid`:
|
|
131
|
+
* a `maxAgeMs` that is not a finite number of milliseconds of 0 or more, a `now` that is not a finite number) —
|
|
132
|
+
* never read as "no bound";
|
|
133
|
+
* - **age only**: ownership is not consulted, and an entry still reachable from a transcript is removed when it
|
|
134
|
+
* is old enough — the model's read of it then says it may have expired (the honest degradation the read
|
|
135
|
+
* already has);
|
|
136
|
+
* - **idempotent**, and an entry that disappears between enumeration and removal is honest absence.
|
|
137
|
+
*
|
|
138
|
+
* Optional: absent ⇒ this store keeps entries until their session is deleted. An OPTIONAL leg of the contract kit
|
|
139
|
+
* (`toolResultStoreContract`), reported through its `onOptionalMember` callback.
|
|
140
|
+
*/
|
|
141
|
+
reap?(now: number, opts?: {
|
|
142
|
+
maxAgeMs?: number;
|
|
143
|
+
}): Promise<number> | number;
|
|
144
|
+
/**
|
|
145
|
+
* The READ half of the same ownership coordinate {@link deleteBySession} erases by: every entry this store recorded as belonging to
|
|
146
|
+
* `sessionId`, as the ref and the owner recorded at its winning write. Without it the offloaded results a session's transcript
|
|
147
|
+
* points at have no way out of a store, so a session moved to another store reads references it cannot dereference.
|
|
148
|
+
*
|
|
149
|
+
* The listing is the whole of the export: the bytes are read with {@link get} (bounded slices; `totalChars` says how much) and
|
|
150
|
+
* land in the other store with `put(ref, content, entry.provenance)` — that store's write-once election makes a repeated move an
|
|
151
|
+
* idempotent no-op and a ref that already belongs to a different owner a typed refusal ({@link ToolResultRefConflictError}).
|
|
152
|
+
* There is no second path for content.
|
|
153
|
+
*
|
|
154
|
+
* Rules every implementation follows, the same selection as {@link deleteBySession}:
|
|
155
|
+
* - **selection is by RECORDED PROVENANCE, never by parsing the ref**; `taskId` is ignored in the match (the entry's
|
|
156
|
+
* `provenance` still carries the one that was recorded — it is the very owner the importing `put` states);
|
|
157
|
+
* - **an UNOWNED entry is never listed**: it belongs to no session this call can name. It is counted in
|
|
158
|
+
* {@link ToolResultSessionListing.unattributable} (store-wide, the same figure a sweep reports), so a caller learns the
|
|
159
|
+
* listing cannot speak for such rows rather than being told a clean "that is all";
|
|
160
|
+
* - an entry the session owns but whose ref the store cannot name — only an entry written before the store recorded the ref beside
|
|
161
|
+
* it — is counted in {@link ToolResultSessionListing.unaddressable}, never listed under a guessed ref;
|
|
162
|
+
* - the listing is a snapshot with no order promised; an entry that disappears before the caller reads it is honest absence
|
|
163
|
+
* (`get` answers `undefined`), and a listing of a session with no entries is empty, not an error.
|
|
164
|
+
*
|
|
165
|
+
* Typed OPTIONAL, and an OPTIONAL leg of the published contract kit (`toolResultStoreContract`): a store that cannot enumerate
|
|
166
|
+
* by owner is still a usable offload store, so absence is a checkable fact reported through `onOptionalMember`, never a
|
|
167
|
+
* contract breach. Implementing it does NOT make a store `retention: "managed"`.
|
|
168
|
+
*/
|
|
169
|
+
listBySession?(sessionId: string): Promise<ToolResultSessionListing> | ToolResultSessionListing;
|
|
170
|
+
}
|
|
171
|
+
/** One entry a {@link ToolResultStore.listBySession} listing names: the ref and the owner recorded at its winning write — the two
|
|
172
|
+
* arguments an importing store's `put` takes beside the content `get` returns. */
|
|
173
|
+
export interface ToolResultListedEntry {
|
|
174
|
+
readonly ref: string;
|
|
175
|
+
readonly provenance: ToolResultProvenance;
|
|
176
|
+
}
|
|
177
|
+
/** What a {@link ToolResultStore.listBySession} call answers. */
|
|
178
|
+
export interface ToolResultSessionListing {
|
|
179
|
+
/** The session's entries, in no particular order. */
|
|
180
|
+
readonly entries: readonly ToolResultListedEntry[];
|
|
181
|
+
/** Entries the store could not attribute to ANY session (stored without provenance, or with an unreadable owner record) and so did
|
|
182
|
+
* not list: store-wide, the same figure {@link ToolResultDeletionReport.unattributable} reports. */
|
|
183
|
+
readonly unattributable: number;
|
|
184
|
+
/** Entries the session owns whose ref this store cannot name, so they are not listed. It counts ONE thing only — entries written
|
|
185
|
+
* before the store recorded the ref beside the entry (a file backend's folded file name is a digest of the ref, and the owner record
|
|
186
|
+
* it writes now carries the ref; records written by earlier versions do not). It is not a second kind of entry: a store whose
|
|
187
|
+
* entries were all written by a version that records the ref reports `0`, always. Such an entry is still removed by
|
|
188
|
+
* {@link ToolResultStore.deleteBySession}, so `entries.length + unaddressable` is the number a sweep of the session then deletes. */
|
|
189
|
+
readonly unaddressable: number;
|
|
121
190
|
}
|
|
122
191
|
/**
|
|
123
192
|
* What a {@link ToolResultStore.deleteBySession} sweep actually did. A count, not a `void`, because the
|
|
@@ -275,6 +344,11 @@ export declare function assertSafeToolResultRef(ref: string): void;
|
|
|
275
344
|
* matches.
|
|
276
345
|
*/
|
|
277
346
|
export declare function buildToolResultRef(sessionId: string, toolCallId: string, ...extraSegments: string[]): string;
|
|
347
|
+
/** The task whose result `ref` holds, read off the segment {@link buildTaskArtifactRef} put it in — `undefined` for every other
|
|
348
|
+
* ref, which by construction is not a task's result (only that mint carries {@link TASK_ARTIFACT_SEGMENT}). An origin, never an
|
|
349
|
+
* owner: who may read the bytes is still {@link ToolResultStore.ownerOf}'s answer. A task id the mint had to fold comes back as
|
|
350
|
+
* its folded segment, which names no task — the reading of a task that is gone. */
|
|
351
|
+
export declare function taskArtifactOriginOf(ref: string): string | undefined;
|
|
278
352
|
/**
|
|
279
353
|
* Backlog #119 — the ceiling on a ref this module can mint, so a durable backend can size its key
|
|
280
354
|
* column from a stated invariant instead of a guess (TiDB's was `VARCHAR(191)`, which a long
|
|
@@ -320,7 +394,6 @@ export interface ToolResultSlice {
|
|
|
320
394
|
* on the existing honest "may have expired" text). Durability across restarts still requires a real
|
|
321
395
|
* store (e.g. FileToolResultStore) via `RunnerDeps.toolResultStore`. */
|
|
322
396
|
export declare class InMemoryToolResultStore implements ToolResultStore {
|
|
323
|
-
private readonly opts?;
|
|
324
397
|
/** Managed-retention declaration (retention.ts): whether this store's rows are deleted on schedule by the deployment — given by
|
|
325
398
|
* the party that runs the sweep (the `retention` option), `"none"` when none is given; the store itself is put/get only. */
|
|
326
399
|
readonly retention: RetentionDeclaration;
|
|
@@ -330,10 +403,12 @@ export declare class InMemoryToolResultStore implements ToolResultStore {
|
|
|
330
403
|
private totalChars;
|
|
331
404
|
/** @param opts.retention the store's managed-retention declaration, default `"none"`; a word other than the two is refused
|
|
332
405
|
* (`config.retention_capability`). */
|
|
333
|
-
|
|
406
|
+
/** The bound, read once at construction by the integer reading (`undefined` = unbounded): the one value the eviction enforces. */
|
|
407
|
+
private readonly maxTotalChars;
|
|
408
|
+
constructor(options?: {
|
|
334
409
|
maxTotalChars?: number;
|
|
335
410
|
retention?: RetentionDeclaration;
|
|
336
|
-
}
|
|
411
|
+
});
|
|
337
412
|
put(ref: string, content: string, provenance?: ToolResultProvenance): void;
|
|
338
413
|
/** The owner recorded at the winning write; `undefined` for unknown AND for unowned entries,
|
|
339
414
|
* which a read face treats identically (fail-closed). */
|
|
@@ -344,6 +419,9 @@ export declare class InMemoryToolResultStore implements ToolResultStore {
|
|
|
344
419
|
* same provenance match applies with none of the file backend's two-object bookkeeping. Deleting
|
|
345
420
|
* from a Map while iterating it is defined (a removed key is simply not revisited). */
|
|
346
421
|
deleteBySession(sessionId: string): ToolResultDeletionReport;
|
|
422
|
+
/** This session's entries, selected on the owner recorded at the winning write — the very match {@link deleteBySession} runs (the
|
|
423
|
+
* interface states the rules). The ref is the map key, so every owned entry is nameable. */
|
|
424
|
+
listBySession(sessionId: string): ToolResultSessionListing;
|
|
347
425
|
/** design/80 D-2: true when NOTHING has been offloaded — a durable suspend can then proceed safely even on
|
|
348
426
|
* this in-memory store, because a cross-replica resume has no offloaded result to deref to null. */
|
|
349
427
|
isEmpty(): boolean;
|
|
@@ -431,6 +509,30 @@ onNotice?: (notice: import("./types.js").EngineNotice) => void): (toolCallId: st
|
|
|
431
509
|
* already has in hand. `taskId` is omitted (not `undefined`-valued) when the run declares none, so the
|
|
432
510
|
* stored shape compares equal across a durable round-trip. */
|
|
433
511
|
export declare function toolResultProvenanceOf(sessionId: string, taskId?: string): ToolResultProvenance;
|
|
512
|
+
/** Where a background task's result is written when its completion notification carries less than the whole of it: the
|
|
513
|
+
* offload store the receiving run's {@link OFFLOAD_TOOL_NAME} reads, and the session that run's refs are minted under. */
|
|
514
|
+
export interface TaskArtifactSeat {
|
|
515
|
+
readonly store: ToolResultStore;
|
|
516
|
+
readonly sessionId: string;
|
|
517
|
+
}
|
|
518
|
+
/** What {@link persistTaskArtifact} answers: the ref the text is stored under, a write that failed or went unconfirmed
|
|
519
|
+
* (no ref — a ref nobody can read back is a false promise), or no store to write to. */
|
|
520
|
+
export type TaskArtifact = {
|
|
521
|
+
readonly kind: "stored";
|
|
522
|
+
readonly ref: string;
|
|
523
|
+
} | {
|
|
524
|
+
readonly kind: "unconfirmed";
|
|
525
|
+
} | {
|
|
526
|
+
readonly kind: "no_store";
|
|
527
|
+
};
|
|
528
|
+
/**
|
|
529
|
+
* THE one write of a background task's result artifact. The ref is CONTENT-ADDRESSED (task id + a digest of the text):
|
|
530
|
+
* two cycles of one task with different answers get different refs, and the same answer written twice lands on the same
|
|
531
|
+
* write-once row — no cycle number is read, so a row reseeded after a restart (whose cycle counter restarts) cannot
|
|
532
|
+
* land a new answer on an old ref. The put is awaited before the answer is returned, so a caller that announces the ref
|
|
533
|
+
* announces a write that already landed.
|
|
534
|
+
*/
|
|
535
|
+
export declare function persistTaskArtifact(seat: TaskArtifactSeat | undefined, taskId: string, text: string): Promise<TaskArtifact>;
|
|
434
536
|
/**
|
|
435
537
|
* RB-374① — the ONE source of the "page the offloaded text back" suggestion sentence, shared by
|
|
436
538
|
* {@link buildPreview} (offload preview tail) and context-edit's cleared-marker refNote. The two
|
|
@@ -495,5 +597,9 @@ export declare const OFFLOADED_DETAIL_NOTICE_PREFIX = "\u2026[offloaded \u2014 "
|
|
|
495
597
|
/** True when `s` carries an offloaded-detail replacement notice (the newline-anchored prefix form the
|
|
496
598
|
* walk emits). A semantic consumer treats such a string as NOT the member's real bytes. */
|
|
497
599
|
export declare function isOffloadedDetailReplacement(s: string): boolean;
|
|
498
|
-
/** The injected `read_tool_result` tool: pages through an offloaded result. `effect:"read"` (verifier/reconcile-safe).
|
|
499
|
-
|
|
600
|
+
/** The injected `read_tool_result` tool: pages through an offloaded result. `effect:"read"` (verifier/reconcile-safe).
|
|
601
|
+
* `legsOfRef` = the legs a page-back of one ref travels: a ref holding a background task's result (`persistTaskArtifact`, its
|
|
602
|
+
* origin in the ref — {@link taskArtifactOriginOf}) travels the legs a poll of that task travels — content from another tree is
|
|
603
|
+
* an off-target read however it is read back — and the registry's reading answers it; absent, or for any other ref (offloaded
|
|
604
|
+
* tool output), none. */
|
|
605
|
+
export declare function createReadToolResultTool(store: ToolResultStore, legsOfRef?: (ref: string, tree: import("./cross-boundary-taint.js").CrossBoundaryTreeToken) => import("./cross-boundary-taint.js").BoundaryLegsGiven): AgentTool;
|
|
@@ -8,6 +8,8 @@ import { mountRuleFace, toolFace } from "./tool-catalog-entries.js";
|
|
|
8
8
|
import { thrownText } from "./thrown-value.js";
|
|
9
9
|
import { readRetentionDeclaration } from "./retention.js";
|
|
10
10
|
import { carryNotStartedReceipt } from "./delegation-not-started.js";
|
|
11
|
+
import { optionKeys, receiveOptions } from "./own-property-receipt.js";
|
|
12
|
+
import { NON_NEGATIVE_SAFE_INTEGER, readIntegerOption } from "./integer-option.js";
|
|
11
13
|
export const TOOL_RESULT_REF_CONFLICT_CODE = "tool_result.ref_conflict";
|
|
12
14
|
export class ToolResultRefConflictError extends Error {
|
|
13
15
|
ref;
|
|
@@ -51,7 +53,18 @@ const MAX_REF_SEGMENT_CHARS = 128;
|
|
|
51
53
|
const REF_SEGMENT_SEPARATOR = "~";
|
|
52
54
|
const FOLDED_SEGMENT_PREFIX = "fold.";
|
|
53
55
|
export function buildToolResultRef(sessionId, toolCallId, ...extraSegments) {
|
|
54
|
-
return
|
|
56
|
+
return composeToolResultRef(sessionId, [toolCallId, ...extraSegments].map(refSegment));
|
|
57
|
+
}
|
|
58
|
+
function composeToolResultRef(sessionId, segments) {
|
|
59
|
+
return [`tr_${refSegment(sessionId)}`, ...segments].join(REF_SEGMENT_SEPARATOR);
|
|
60
|
+
}
|
|
61
|
+
const TASK_ARTIFACT_SEGMENT = `${FOLDED_SEGMENT_PREFIX}task`;
|
|
62
|
+
function buildTaskArtifactRef(sessionId, taskId, text) {
|
|
63
|
+
return composeToolResultRef(sessionId, [TASK_ARTIFACT_SEGMENT, ...[taskId, toolResultContentSegment(text)].map(refSegment)]);
|
|
64
|
+
}
|
|
65
|
+
export function taskArtifactOriginOf(ref) {
|
|
66
|
+
const segments = ref.split(REF_SEGMENT_SEPARATOR);
|
|
67
|
+
return segments[1] === TASK_ARTIFACT_SEGMENT ? segments[2] : undefined;
|
|
55
68
|
}
|
|
56
69
|
function refSegment(raw) {
|
|
57
70
|
if (raw.length <= MAX_REF_SEGMENT_CHARS && NATIVE_REF_CHARSET.test(raw) && !raw.startsWith(FOLDED_SEGMENT_PREFIX))
|
|
@@ -66,18 +79,16 @@ export function toolResultContentSegment(text) {
|
|
|
66
79
|
function digestOfString(s) {
|
|
67
80
|
return createHash("sha256").update(Buffer.from(s, "utf16le")).digest("hex");
|
|
68
81
|
}
|
|
82
|
+
const IN_MEMORY_TOOL_RESULT_STORE_OPTION_KEYS = optionKeys()({ maxTotalChars: 0, retention: 0 });
|
|
69
83
|
export class InMemoryToolResultStore {
|
|
70
|
-
opts;
|
|
71
84
|
retention;
|
|
72
85
|
map = new Map();
|
|
73
86
|
totalChars = 0;
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
throw new Error("InMemoryToolResultStore: maxTotalChars must be a number (got NaN) — omit it for an unbounded store");
|
|
80
|
-
}
|
|
87
|
+
maxTotalChars;
|
|
88
|
+
constructor(options) {
|
|
89
|
+
const opts = receiveOptions(options, "InMemoryToolResultStore", IN_MEMORY_TOOL_RESULT_STORE_OPTION_KEYS);
|
|
90
|
+
this.retention = readRetentionDeclaration("InMemoryToolResultStore.retention", opts.retention);
|
|
91
|
+
this.maxTotalChars = readIntegerOption("InMemoryToolResultStore.maxTotalChars", opts.maxTotalChars, NON_NEGATIVE_SAFE_INTEGER, "characters", "an unbounded store");
|
|
81
92
|
}
|
|
82
93
|
put(ref, content, provenance) {
|
|
83
94
|
assertSafeToolResultRef(ref);
|
|
@@ -88,8 +99,8 @@ export class InMemoryToolResultStore {
|
|
|
88
99
|
}
|
|
89
100
|
this.map.set(ref, provenance === undefined ? { content } : { content, provenance: normalizeToolResultProvenance(provenance) });
|
|
90
101
|
this.totalChars += content.length;
|
|
91
|
-
const cap = this.
|
|
92
|
-
if (cap !== undefined
|
|
102
|
+
const cap = this.maxTotalChars;
|
|
103
|
+
if (cap !== undefined) {
|
|
93
104
|
for (const [oldRef, oldEntry] of this.map) {
|
|
94
105
|
if (this.totalChars <= cap || oldRef === ref)
|
|
95
106
|
break;
|
|
@@ -117,6 +128,19 @@ export class InMemoryToolResultStore {
|
|
|
117
128
|
}
|
|
118
129
|
return { deleted, unattributable };
|
|
119
130
|
}
|
|
131
|
+
listBySession(sessionId) {
|
|
132
|
+
const entries = [];
|
|
133
|
+
let unattributable = 0;
|
|
134
|
+
for (const [ref, entry] of this.map) {
|
|
135
|
+
if (entry.provenance === undefined) {
|
|
136
|
+
unattributable++;
|
|
137
|
+
continue;
|
|
138
|
+
}
|
|
139
|
+
if (entry.provenance.sessionId === sessionId)
|
|
140
|
+
entries.push({ ref, provenance: { ...entry.provenance } });
|
|
141
|
+
}
|
|
142
|
+
return { entries, unattributable, unaddressable: 0 };
|
|
143
|
+
}
|
|
120
144
|
isEmpty() {
|
|
121
145
|
return this.map.size === 0;
|
|
122
146
|
}
|
|
@@ -198,6 +222,18 @@ export function createOffloadPersist(store, sessionId, onNotice) {
|
|
|
198
222
|
export function toolResultProvenanceOf(sessionId, taskId) {
|
|
199
223
|
return taskId === undefined ? { sessionId } : { sessionId, taskId };
|
|
200
224
|
}
|
|
225
|
+
export async function persistTaskArtifact(seat, taskId, text) {
|
|
226
|
+
if (seat === undefined)
|
|
227
|
+
return { kind: "no_store" };
|
|
228
|
+
const ref = buildTaskArtifactRef(seat.sessionId, taskId, text);
|
|
229
|
+
try {
|
|
230
|
+
await seat.store.put(ref, text, toolResultProvenanceOf(seat.sessionId));
|
|
231
|
+
}
|
|
232
|
+
catch {
|
|
233
|
+
return { kind: "unconfirmed" };
|
|
234
|
+
}
|
|
235
|
+
return { kind: "stored", ref };
|
|
236
|
+
}
|
|
201
237
|
export function offloadPagebackHint(ref, form, reachableTools) {
|
|
202
238
|
const activate = reachableTools !== undefined && !reachableTools.has(OFFLOAD_TOOL_NAME)
|
|
203
239
|
? `${OFFLOAD_TOOL_NAME} is not active yet — call ${TOOL_SEARCH_NAME} with {"query":"select:${OFFLOAD_TOOL_NAME}"} to activate it, then `
|
|
@@ -386,11 +422,15 @@ async function offloadOversizedDetailStrings(details, store, thresholdChars, ses
|
|
|
386
422
|
};
|
|
387
423
|
return { value: finalize(value) };
|
|
388
424
|
}
|
|
389
|
-
export function createReadToolResultTool(store) {
|
|
425
|
+
export function createReadToolResultTool(store, legsOfRef) {
|
|
390
426
|
return defineTool({
|
|
391
427
|
name: OFFLOAD_TOOL_NAME,
|
|
392
428
|
...toolFace("read-tool-result"),
|
|
393
429
|
ruleFace: mountRuleFace("read-tool-result"),
|
|
430
|
+
boundaryLegsFor: (rawArgs, at) => {
|
|
431
|
+
const ref = rawArgs?.ref;
|
|
432
|
+
return typeof ref === "string" && legsOfRef !== undefined ? legsOfRef(ref, at.tree) : { legs: [] };
|
|
433
|
+
},
|
|
394
434
|
description: `Read the full content of a tool result that was too large and persisted (you saw it as ` +
|
|
395
435
|
`<persisted-output ref="..."> with a preview). Pass the ref; use offset/limit to page through it.`,
|
|
396
436
|
parameters: Type.Object({
|