@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
|
@@ -4,7 +4,7 @@ import { type ClassifierUnavailableSeat } from "../classifier-unavailable-arm.js
|
|
|
4
4
|
import { type PermissionResult, type ResolvedAsk, type ToolCallRequest } from "../tool-policy.js";
|
|
5
5
|
import { type Settlement } from "../gate-outcome.js";
|
|
6
6
|
import { type EngineNotice } from "../types.js";
|
|
7
|
-
import { type AskClass, type AskClassFacts, type AskClassification, type AskOrigin, type
|
|
7
|
+
import { type AskClass, type AskClassFacts, type AskClassification, type AskOrigin, type AskReason } from "../ask-origin.js";
|
|
8
8
|
import type { Prepared, StopForDenialLimit } from "./contracts.js";
|
|
9
9
|
/**
|
|
10
10
|
* The classifier DENIAL-LIMIT arms of the tool gate's inherited (delegation) lane, extracted
|
|
@@ -89,23 +89,6 @@ export declare function createDenialLimitStop(opts: {
|
|
|
89
89
|
export type InheritedAsk = Extract<PermissionResult, {
|
|
90
90
|
action: "ask";
|
|
91
91
|
}>;
|
|
92
|
-
/**
|
|
93
|
-
* The delegation half of the live gate's classifier eligibility: the SAME class row (`classifyAsk` over the
|
|
94
|
-
* ask's own members) answers for the FROZEN classifier — an ask raised by a hook, minted by an
|
|
95
|
-
* explicit `ask` permission rule, or already a denial-limit fallback is exactly as out of the frozen
|
|
96
|
-
* decider's reach as the live one's, because the person's / hook's standing decision travels with the
|
|
97
|
-
* frozen entry and a frozen decider resolving it would re-open the same hole one process over. The
|
|
98
|
-
* three GATE-HELD facts of the derivation are not this station's to judge: an ancestor's frozen
|
|
99
|
-
* classifier runs inside the policy fold, BEFORE the live gate's org layer has spoken and before its
|
|
100
|
-
* question-tool and marked-call lanes run, so they read as absent here and those asks meet their
|
|
101
|
-
* exclusions downstream, where the facts exist. Excluded asks fall through to the frozen approver
|
|
102
|
-
* chain, the delegation lane's original chain. The word and the class set are derived inside
|
|
103
|
-
* {@link judgeInheritedClassifier} and threaded to every reader ({@link inheritedAskCarry}).
|
|
104
|
-
* The MANDATE marks here are empty (the base names no seat): the policy-chain phase builds each call's facts over this
|
|
105
|
-
* base with THIS task's tool seat — the seat the request's risk axes are read from — so a marked tool's ask is
|
|
106
|
-
* classified by the seat at the station as at the gate. What the ancestor's ask carries on ITSELF still answers. No call either (each station's own).
|
|
107
|
-
*/
|
|
108
|
-
export declare const INHERITED_STATION_FACTS: Omit<AskOriginFacts, "call">;
|
|
109
92
|
/** The members of a surviving ask that ride onto the approval request with a COMPUTED value — what the
|
|
110
93
|
* four request mint stations (the gate's own and the three inherited-lane ones) spread after the seats
|
|
111
94
|
* they spell themselves: the ask's origin word, its class (the word and the set, carried together) and its
|
|
@@ -116,6 +99,9 @@ export interface AskRequestCarry {
|
|
|
116
99
|
classes?: readonly AskClass[];
|
|
117
100
|
denialLimitFallback?: DenialLimitFallback;
|
|
118
101
|
classifierNoRuling?: AutoModeFallbackCause;
|
|
102
|
+
/** The askers' own words ({@link import("../ask-origin.js").AskReason}), as the gate's stamp left them or as an inherited
|
|
103
|
+
* station read them off the ancestor's ask. */
|
|
104
|
+
askReasons?: readonly AskReason[];
|
|
119
105
|
}
|
|
120
106
|
/** The GATE's own mint station: every member is read off the surviving decision, which is the gate's
|
|
121
107
|
* OWN snapshot (its stamp point spreads the policy's object and stamps the word and the class onto the copy),
|
|
@@ -131,7 +117,7 @@ export declare function gateAskCarry(decision: InheritedAsk, liveApprover: boole
|
|
|
131
117
|
* read). */
|
|
132
118
|
export declare function inheritedAskCarry(judged: Pick<Extract<InheritedClassifierJudgment<InheritedAsk>, {
|
|
133
119
|
kind: "resolve";
|
|
134
|
-
}>, "origin" | "classification" | "fallback" | "ask">, liveApprover: boolean, tracker: AutoModeDenialTracker | undefined): AskRequestCarry;
|
|
120
|
+
}>, "origin" | "classification" | "fallback" | "ask" | "askReasons">, liveApprover: boolean, tracker: AutoModeDenialTracker | undefined): AskRequestCarry;
|
|
135
121
|
/** What {@link judgeInheritedClassifier} hands back to the arm that called it. */
|
|
136
122
|
export type InheritedClassifierJudgment<A extends InheritedAsk> =
|
|
137
123
|
/** The frozen classifier allowed. `result` is the allow the arm RETURNS — minted at the judging station so
|
|
@@ -167,6 +153,7 @@ export type InheritedClassifierJudgment<A extends InheritedAsk> =
|
|
|
167
153
|
origin: AskOrigin;
|
|
168
154
|
classification: AskClassification;
|
|
169
155
|
noRulingHere?: true;
|
|
156
|
+
askReasons?: readonly AskReason[];
|
|
170
157
|
};
|
|
171
158
|
/**
|
|
172
159
|
* The ancestor's frozen classifier, run BEFORE its frozen approver in the ancestor's own gate order,
|
|
@@ -213,12 +200,18 @@ export declare function judgeInheritedClassifier<A extends InheritedAsk>(opts: {
|
|
|
213
200
|
/** The station's facts for this call (the base with this task's tool seat); absent ⇒ {@link INHERITED_STATION_FACTS}. */
|
|
214
201
|
facts?: AskClassFacts;
|
|
215
202
|
}): Promise<InheritedClassifierJudgment<A>>;
|
|
203
|
+
/** The ancestor's ask as an inherited station floats it back into this leg's fold (its approver unavailable): the askers the station
|
|
204
|
+
* read before narrating it ride the engine's record, so the gate's receipt reads them, not the narrated sentence. */
|
|
205
|
+
export declare function floatedInheritedAsk<A extends InheritedAsk>(judged: Pick<ResolveJudgment<A>, "ask" | "askReasons">, call: {
|
|
206
|
+
toolCallId: string;
|
|
207
|
+
toolName: string;
|
|
208
|
+
}): A;
|
|
216
209
|
/** The fallback an inherited station hands its frozen approver, minted ONCE for both ways a bound is reached (a counted ruling
|
|
217
210
|
* refusal; a no-ruling card the approver's POLICY refused, {@link settleNoRulingAsk}) — its own object, word and class set. */
|
|
218
211
|
type ResolveJudgment<A extends InheritedAsk> = Extract<InheritedClassifierJudgment<A>, {
|
|
219
212
|
kind: "resolve";
|
|
220
213
|
}>;
|
|
221
|
-
export declare function inheritedFallbackJudgment<A extends InheritedAsk>(ask: A, fallback: UnarmedDenialLimitFallback, latestBlockedAction: string, facts: AskClassFacts): ResolveJudgment<A>;
|
|
214
|
+
export declare function inheritedFallbackJudgment<A extends InheritedAsk>(ask: A, fallback: UnarmedDenialLimitFallback, latestBlockedAction: string, facts: AskClassFacts, askReasons: readonly AskReason[] | undefined): ResolveJudgment<A>;
|
|
222
215
|
/** One resolution of an inherited ask at its frozen approver (the three arms): a no-ruling card its POLICY refused counts
|
|
223
216
|
* ({@link settleNoRulingAsk}); at the bound the call is resolved again there as the fallback. Returns the judgment it answered. */
|
|
224
217
|
export declare function resolveInheritedAsk<A extends InheritedAsk>(judged: ResolveJudgment<A>, resolveWith: (j: ResolveJudgment<A>) => Promise<ResolvedAsk>, tracker: AutoModeDenialTracker | undefined, call: {
|
|
@@ -277,7 +270,8 @@ export declare function lateAskSettlementObserver(args: {
|
|
|
277
270
|
toolCallId: string;
|
|
278
271
|
sessionId: string;
|
|
279
272
|
runId: string;
|
|
280
|
-
taskId
|
|
273
|
+
/** The leg's own task id (`Prepared.taskId`), always present. */
|
|
274
|
+
taskId: string;
|
|
281
275
|
onNotice: import("../types.js").RunnerDeps["onNotice"];
|
|
282
276
|
onError: import("../types.js").RunnerDeps["onError"];
|
|
283
277
|
}): (late: {
|
|
@@ -4,9 +4,10 @@ import { sanitizeAutoModeArmingRecipe, tightenDenialLimit } from "../auto-mode-a
|
|
|
4
4
|
import { classifierNoRulingArm, settleNoRulingAsk } from "../classifier-unavailable-arm.js";
|
|
5
5
|
import { attest, attestationOf } from "../tool-policy.js";
|
|
6
6
|
import { SETTLEMENT_NOBODY_JUDGED } from "../gate-outcome.js";
|
|
7
|
+
import { legNoticeTaskId } from "../mods/stations.js";
|
|
7
8
|
import { deliverEngineNotice } from "../types.js";
|
|
8
9
|
import { inlineUntrusted } from "../untrusted-text.js";
|
|
9
|
-
import { askClassMembersOf, askOriginOf, classifyAsk } from "../ask-origin.js";
|
|
10
|
+
import { askClassMembersOf, askOriginOf, askReasonsOf, chainAskReasonsOf, classifyAsk, INHERITED_STATION_FACTS } from "../ask-origin.js";
|
|
10
11
|
export function attachRebuiltDenialTrackers(entries, denialLimit) {
|
|
11
12
|
if (entries === undefined)
|
|
12
13
|
return undefined;
|
|
@@ -60,7 +61,6 @@ export function createDenialLimitStop(opts) {
|
|
|
60
61
|
};
|
|
61
62
|
return { gateStopRef, stopForDenialLimit };
|
|
62
63
|
}
|
|
63
|
-
export const INHERITED_STATION_FACTS = { contentQuestion: false, markedUnresolvable: false, org: undefined, tightened: undefined, mandateMarks: {} };
|
|
64
64
|
const noRulingCarry = (why) => (isAutoModeFallbackCause(why) ? { classifierNoRuling: why } : {});
|
|
65
65
|
function fallbackCarry(fallback, liveApprover, tracker) {
|
|
66
66
|
if (fallback === undefined)
|
|
@@ -73,6 +73,7 @@ export function gateAskCarry(decision, liveApprover, tracker) {
|
|
|
73
73
|
...(decision.askClass !== undefined && decision.classes !== undefined ? { askClass: decision.askClass, classes: decision.classes } : {}),
|
|
74
74
|
...fallbackCarry(decision.denialLimitFallback, liveApprover, tracker),
|
|
75
75
|
...noRulingCarry(decision.classifierNoRuling),
|
|
76
|
+
...askReasonsOf(decision),
|
|
76
77
|
};
|
|
77
78
|
}
|
|
78
79
|
export function inheritedAskCarry(judged, liveApprover, tracker) {
|
|
@@ -81,6 +82,7 @@ export function inheritedAskCarry(judged, liveApprover, tracker) {
|
|
|
81
82
|
...askClassMembersOf(judged.classification),
|
|
82
83
|
...fallbackCarry(judged.fallback, liveApprover, tracker),
|
|
83
84
|
...noRulingCarry(judged.ask.classifierNoRuling),
|
|
85
|
+
...(judged.askReasons !== undefined && judged.askReasons.length > 0 ? { askReasons: judged.askReasons } : {}),
|
|
84
86
|
};
|
|
85
87
|
}
|
|
86
88
|
export const inheritedAskFallbackMessage = (toolName) => `approval required for "${toolName}" (inherited parent policy)`;
|
|
@@ -88,6 +90,8 @@ export async function judgeInheritedClassifier(opts) {
|
|
|
88
90
|
const { autoMode, req } = opts;
|
|
89
91
|
const facts = opts.facts ?? { ...INHERITED_STATION_FACTS, call: req }, m = facts.mandateMarks;
|
|
90
92
|
const frames = [...(m.egress === true ? [markTightenMessage(req.toolName, "egress")] : []), ...(m.irreversibility === "always" ? [markTightenMessage(req.toolName, "irreversible")] : [])];
|
|
93
|
+
const askReasons = opts.ask.askReasons ?? chainAskReasonsOf(opts.ask, req);
|
|
94
|
+
const reasoned = askReasons !== undefined ? { askReasons } : {};
|
|
91
95
|
const ask = (frames.length > 0 ? { ...opts.ask, message: [opts.ask.message ?? inheritedAskFallbackMessage(req.toolName), ...frames].join(" — ") } : opts.ask);
|
|
92
96
|
const origin = askOriginOf(ask, facts);
|
|
93
97
|
const classification = classifyAsk(ask, facts);
|
|
@@ -96,13 +100,13 @@ export async function judgeInheritedClassifier(opts) {
|
|
|
96
100
|
return live === "dontAsk" || live === "bypassPermissions" || live === "plan" || (autoMode?.liveMode !== undefined && autoMode.liveMode.current !== "auto");
|
|
97
101
|
};
|
|
98
102
|
if (autoMode === undefined || classifierStandsDown() || !classification.row.classifierEligible) {
|
|
99
|
-
return { kind: "resolve", ask, fallback: ask.denialLimitFallback, mintedHere: false, origin, classification };
|
|
103
|
+
return { kind: "resolve", ask, fallback: ask.denialLimitFallback, mintedHere: false, origin, classification, ...reasoned };
|
|
100
104
|
}
|
|
101
105
|
const verdict = await autoMode.decider
|
|
102
106
|
.decide({ req, ...(ask.message !== undefined ? { askMessage: ask.message } : {}) }, opts.signal)
|
|
103
107
|
.catch(() => ({ kind: "unavailable", cause: "error" }));
|
|
104
108
|
if (verdict.kind === "allow" && classifierStandsDown())
|
|
105
|
-
return { kind: "resolve", ask, fallback: ask.denialLimitFallback, mintedHere: false, origin, classification };
|
|
109
|
+
return { kind: "resolve", ask, fallback: ask.denialLimitFallback, mintedHere: false, origin, classification, ...reasoned };
|
|
106
110
|
const attributed = (d) => (verdict.classifier !== undefined ? attest(d, req, { classifierRound: verdict.classifier }) : d);
|
|
107
111
|
if (verdict.kind === "allow") {
|
|
108
112
|
autoMode.denialTracking?.recordAllow();
|
|
@@ -111,7 +115,7 @@ export async function judgeInheritedClassifier(opts) {
|
|
|
111
115
|
const noRuling = rungDidNotRule(verdict);
|
|
112
116
|
const arm = noRuling !== undefined ? classifierNoRulingArm({ ask, req, cause: noRuling, seat: opts.unavailableSeat, aborted: opts.signal.aborted }) : undefined;
|
|
113
117
|
if (arm?.kind === "asked")
|
|
114
|
-
return { kind: "resolve", ask: arm.ask, fallback: ask.denialLimitFallback, mintedHere: false, origin, classification: classifyAsk(arm.ask, facts), noRulingHere: true };
|
|
118
|
+
return { kind: "resolve", ask: arm.ask, fallback: ask.denialLimitFallback, mintedHere: false, origin, classification: classifyAsk(arm.ask, facts), noRulingHere: true, ...reasoned };
|
|
115
119
|
if (arm?.kind === "denied")
|
|
116
120
|
return { kind: "deny", result: attributed(arm.deny) };
|
|
117
121
|
const reason = verdict.kind === "block" ? (verdict.reason ? inlineUntrusted(verdict.reason) : "") : classifierParseFailureDenyMessage(verdict.classifier);
|
|
@@ -125,19 +129,22 @@ export async function judgeInheritedClassifier(opts) {
|
|
|
125
129
|
};
|
|
126
130
|
return { kind: "deny", result: attributed(verdict.kind === "parse_error" ? attest(denied, req, { classifierCause: "parse_error" }) : denied) };
|
|
127
131
|
}
|
|
128
|
-
return inheritedFallbackJudgment(ask, tracked.fallback, reason || category || req.toolName, facts);
|
|
132
|
+
return inheritedFallbackJudgment(ask, tracked.fallback, reason || category || req.toolName, facts, askReasons);
|
|
129
133
|
}
|
|
130
|
-
export function
|
|
134
|
+
export function floatedInheritedAsk(judged, call) {
|
|
135
|
+
return attest(judged.ask, call, { receivedAskReasons: judged.askReasons ?? [] });
|
|
136
|
+
}
|
|
137
|
+
export function inheritedFallbackJudgment(ask, fallback, latestBlockedAction, facts, askReasons) {
|
|
131
138
|
const { classifierNoRuling: _why, ...standing } = ask;
|
|
132
139
|
const minted = { ...standing, message: denialLimitFallbackMessage(fallback, latestBlockedAction), decisionReason: "classifier", requiresRealApproval: true, denialLimitFallback: fallback };
|
|
133
|
-
return { kind: "resolve", ask: minted, fallback, mintedHere: true, origin: askOriginOf(minted, facts), classification: classifyAsk(minted, facts) };
|
|
140
|
+
return { kind: "resolve", ask: minted, fallback, mintedHere: true, origin: askOriginOf(minted, facts), classification: classifyAsk(minted, facts), ...(askReasons !== undefined ? { askReasons } : {}) };
|
|
134
141
|
}
|
|
135
142
|
export async function resolveInheritedAsk(judged, resolveWith, tracker, call, facts) {
|
|
136
143
|
const resolved = await resolveWith(judged);
|
|
137
144
|
const refallback = settleNoRulingAsk({ ask: judged.ask, mintedHere: judged.noRulingHere === true, resolved: fallbackResolutionOf(resolved, call), tracker });
|
|
138
145
|
if (refallback === undefined)
|
|
139
146
|
return { resolved, judged };
|
|
140
|
-
const again = inheritedFallbackJudgment(judged.ask, refallback, call.toolName, facts);
|
|
147
|
+
const again = inheritedFallbackJudgment(judged.ask, refallback, call.toolName, facts, judged.askReasons);
|
|
141
148
|
return { resolved: await resolveWith(again), judged: again };
|
|
142
149
|
}
|
|
143
150
|
export const fallbackResolutionOf = (r, call) => ({ action: r.action, settlement: attestationOf(r, call)?.settlement, ...(r.approverUnavailable === true ? { approverUnavailable: true } : {}) });
|
|
@@ -173,7 +180,7 @@ export function lateAskSettlementObserver(args) {
|
|
|
173
180
|
toolCallId: args.toolCallId,
|
|
174
181
|
sessionId: args.sessionId,
|
|
175
182
|
runId: args.runId,
|
|
176
|
-
...(args
|
|
183
|
+
...legNoticeTaskId(args),
|
|
177
184
|
},
|
|
178
185
|
});
|
|
179
186
|
return;
|
|
@@ -4,30 +4,25 @@ import type { EngineNotice } from "../engine-notice.js";
|
|
|
4
4
|
export interface MalformedCapabilityDeclaration {
|
|
5
5
|
readonly key: string;
|
|
6
6
|
readonly valueType: string;
|
|
7
|
-
/** The shape the seat takes: a `capabilities.*` boolean
|
|
8
|
-
|
|
7
|
+
/** The shape the seat takes: a `capabilities.*` boolean (or the block itself, an object), an optional seam method, or
|
|
8
|
+
* nothing (`absent`: a member of the block that is no capability). */
|
|
9
|
+
readonly expected: "boolean" | "object" | "function" | "absent";
|
|
9
10
|
}
|
|
10
11
|
/**
|
|
11
|
-
* Every
|
|
12
|
+
* Every capability this env does not DECLARE as a boolean: each key of the block that is absent, not a boolean, or
|
|
13
|
+
* cannot be received — or the block itself, when it is present but not an object or cannot be received — and each
|
|
14
|
+
* member the block carries outside the eight keys (a misspelled key leaves the key it meant undeclared).
|
|
12
15
|
*
|
|
13
|
-
* The
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
* outside {@link NO_ABSENT_READING} (and announced, alike, for a key inside it) — so one test covers both and
|
|
18
|
-
* the census needs no membership rule at all.
|
|
16
|
+
* The block is judged on its one receipt (`capabilityReceiptOf`), the frozen copy every reader reads. `undefined` is
|
|
17
|
+
* where absence lands — an absent key and an explicit `undefined` are the same word to every reader — and both are
|
|
18
|
+
* announced, as a wrong shape is. An env with no block at all is announced once per key: every reader takes every key's
|
|
19
|
+
* safe side, and the operator learns which.
|
|
19
20
|
*
|
|
20
|
-
* TOTAL by construction: a diagnostic may not be the thing that fails a run. Every read of the adapter
|
|
21
|
-
*
|
|
22
|
-
*
|
|
23
|
-
*
|
|
24
|
-
* could not be had).
|
|
25
|
-
*
|
|
26
|
-
* What a snapshot cannot promise: this is taken once, at admission. An adapter whose capability values
|
|
27
|
-
* CHANGE afterwards can hand a later reader something this census never saw; the declaration is
|
|
28
|
-
* documented as a constant property of the adapter, and a mutable one is outside what any one-time
|
|
29
|
-
* reading covers.
|
|
21
|
+
* TOTAL by construction: a diagnostic may not be the thing that fails a run. Every read of the adapter can throw on a
|
|
22
|
+
* getter or a Proxy trap — the block acquisition, each key, each optional method — and a read that throws is itself a
|
|
23
|
+
* declaration nobody can use, so it is reported rather than raised (`unreadable`, under the key when there is one and
|
|
24
|
+
* under `capabilities` when the block itself could not be had).
|
|
30
25
|
*/
|
|
31
26
|
export declare function malformedCapabilityDeclarations(env: ExecutionEnv): MalformedCapabilityDeclaration[];
|
|
32
|
-
/** Announce each malformed declaration once, to the operator who wired the adapter. */
|
|
27
|
+
/** Announce each undeclared or malformed declaration once, to the operator who wired the adapter. */
|
|
33
28
|
export declare function announceMalformedCapabilities(env: ExecutionEnv, onNotice: ((notice: EngineNotice) => void) | undefined): void;
|
|
@@ -1,9 +1,5 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { CAPABILITY_KEYS, UNDECLARED_CAPABILITY_READING, capabilityReceiptOf } from "../remote-env.js";
|
|
2
2
|
import { deliverEngineNotice } from "../engine-notice.js";
|
|
3
|
-
const BOOLEAN_CAPABILITY_KEYS = ["isolation", "suspendable", "canonicalPathAuthoritative", "sharesProcessTable"];
|
|
4
|
-
const NO_ABSENT_READING = {
|
|
5
|
-
sharesProcessTable: "whether the commands it runs are processes on this engine's own process table has no default, so the Bash tool refuses every pattern kill that needs the question (`pkill`, `killall`, a `kill` fed by `pgrep`; `pkill -P $$`, the shell's own children, runs) on this environment until the adapter declares it — `true` when its commands run on a table that holds the engine (a host lane, or a PID namespace that contains the engine's), `false` only when they run where the engine is not (another machine, a PID namespace that does not contain it)",
|
|
6
|
-
};
|
|
7
3
|
const OPTIONAL_METHOD_KEYS = ["writeFileExclusive", "writeFileGuarded", "setFileMode", "readLink", "canonicalChain", "fileIdentity", "openBound"];
|
|
8
4
|
export function malformedCapabilityDeclarations(env) {
|
|
9
5
|
const out = [];
|
|
@@ -20,41 +16,36 @@ export function malformedCapabilityDeclarations(env) {
|
|
|
20
16
|
continue;
|
|
21
17
|
out.push({ key, valueType: value === null ? "null" : typeof value, expected: "function" });
|
|
22
18
|
}
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
if (!isRemoteExecutionEnv(env))
|
|
26
|
-
return out;
|
|
27
|
-
caps = env.capabilities;
|
|
28
|
-
}
|
|
29
|
-
catch {
|
|
30
|
-
out.push({ key: "capabilities", valueType: "unreadable", expected: "boolean" });
|
|
31
|
-
return out;
|
|
32
|
-
}
|
|
33
|
-
for (const key of BOOLEAN_CAPABILITY_KEYS) {
|
|
34
|
-
let value;
|
|
35
|
-
try {
|
|
36
|
-
value = caps[key];
|
|
37
|
-
}
|
|
38
|
-
catch {
|
|
39
|
-
out.push({ key, valueType: "unreadable", expected: "boolean" });
|
|
40
|
-
continue;
|
|
41
|
-
}
|
|
42
|
-
if (typeof value === "boolean" || (value === undefined && NO_ABSENT_READING[key] === undefined))
|
|
43
|
-
continue;
|
|
44
|
-
out.push({ key, valueType: value === null ? "null" : typeof value, expected: "boolean" });
|
|
45
|
-
}
|
|
19
|
+
for (const finding of capabilityReceiptOf(env).findings)
|
|
20
|
+
out.push(finding);
|
|
46
21
|
return out;
|
|
47
22
|
}
|
|
23
|
+
function declaredAs({ key, valueType, expected }) {
|
|
24
|
+
if (expected === "function")
|
|
25
|
+
return `declares ${key} as a ${valueType}, not a function`;
|
|
26
|
+
if (expected === "object")
|
|
27
|
+
return valueType === "unreadable" ? "declares a capabilities block that cannot be read" : `declares capabilities as a ${valueType}, not an object`;
|
|
28
|
+
if (expected === "absent")
|
|
29
|
+
return `declares capabilities.${key}, which is no capability`;
|
|
30
|
+
if (valueType === "undefined")
|
|
31
|
+
return `does not declare capabilities.${key}`;
|
|
32
|
+
if (valueType === "unreadable")
|
|
33
|
+
return `declares capabilities.${key} with a value that cannot be read`;
|
|
34
|
+
return `declares capabilities.${key} as a ${valueType}, not a boolean`;
|
|
35
|
+
}
|
|
48
36
|
export function announceMalformedCapabilities(env, onNotice) {
|
|
49
|
-
for (const
|
|
50
|
-
const
|
|
37
|
+
for (const finding of malformedCapabilityDeclarations(env)) {
|
|
38
|
+
const { key, valueType, expected } = finding;
|
|
39
|
+
const row = expected === "boolean" ? UNDECLARED_CAPABILITY_READING[key] : undefined;
|
|
51
40
|
deliverEngineNotice(onNotice, {
|
|
52
41
|
code: "config.execution_env_capability_invalid",
|
|
53
42
|
message: expected === "function"
|
|
54
|
-
? `The execution environment
|
|
55
|
-
:
|
|
56
|
-
? `The execution environment ${
|
|
57
|
-
:
|
|
43
|
+
? `The execution environment ${declaredAs(finding)}. This seat is declared by being present as a callable method and undeclared by being absent, so every reader takes the absent reading — the reach the adapter meant to declare is silently the old one. Fix the adapter — this is a wiring fault, not a supported way to leave the seat unset.`
|
|
44
|
+
: expected === "absent"
|
|
45
|
+
? `The execution environment ${declaredAs(finding)}: the block holds exactly ${CAPABILITY_KEYS.join(", ")}, so no reader takes this member, and a misspelled key leaves the key it meant undeclared. Fix the adapter — this is a wiring fault, not a supported extension of the block.`
|
|
46
|
+
: expected === "object"
|
|
47
|
+
? `The execution environment ${declaredAs(finding)}. Every capability is required and none can be read, so every reader takes its key's undeclared reading (${CAPABILITY_KEYS.map((k) => `${k} as ${JSON.stringify(UNDECLARED_CAPABILITY_READING[k].reads)}`).join(", ")}). Fix the adapter — this is a wiring fault, not a supported way to leave the capabilities unset.`
|
|
48
|
+
: `The execution environment ${declaredAs(finding)}. Every capability is required and has no default reading, so the engine reads it as ${JSON.stringify(row?.reads)}: ${row?.so}. Fix the adapter — this is a wiring fault, not a supported way to leave the capability unset.`,
|
|
58
49
|
detail: { key, valueType },
|
|
59
50
|
});
|
|
60
51
|
}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The single-shot TERMINAL settle of a pending checkpoint row by an actor of THIS Runner, and the duty an expired row carries — one
|
|
3
|
+
* statement for the actors that settle a row so: the resume preflight's terminal arm (the deployment ruled the binding dead),
|
|
4
|
+
* `Runner.voidVerifierPause` (the host voids a verifier's own card) and the stream-side reap of a suspended run.
|
|
5
|
+
*
|
|
6
|
+
* `expire` races `resolve` on the same pending row and exactly one settler wins; `expired` is terminal (an expired token is never
|
|
7
|
+
* redeemed again — reopen serves resolved rows only). So the duty is keyed on the ROW, not on who won: once the row is expired, the
|
|
8
|
+
* token's parked parent-constraint entry is evicted and, when THIS process holds the paused env, its reap record is TAKEN (one
|
|
9
|
+
* synchronous take — the record is the ownership token, so two observers never destroy twice) and the env destroyed, BOUNDED (a
|
|
10
|
+
* wedged adapter must not hold the settle's answer hostage: a timeout or throw goes to `onDestroyError`, never masks the settle).
|
|
11
|
+
* The winner runs it; a settler that LOSES reads what the row is now and runs the same duty when it finds it `expired` — another
|
|
12
|
+
* Runner, the deployment reaper or an earlier settler expired it, and none of them holds this process's env. A row the loser finds
|
|
13
|
+
* anything else (a resume resolved it and owns the env) keeps its env and its record. A store throw on the settle closes this
|
|
14
|
+
* attempt's claim and propagates; a throw reading the row after a loss is said and the record kept for a later settle to act on.
|
|
15
|
+
*/
|
|
16
|
+
import type { CheckpointStore, CheckpointToken } from "../checkpoint-store.js";
|
|
17
|
+
import type { LocalClaims } from "./local-claims.js";
|
|
18
|
+
import type { InheritedGate, SuspendReap } from "./contracts.js";
|
|
19
|
+
export interface ExpireRowInput {
|
|
20
|
+
/** borrowed-readonly — the row's token and its OWN scope (read off the row, never the caller's). */
|
|
21
|
+
token: CheckpointToken;
|
|
22
|
+
scope: string;
|
|
23
|
+
/** borrowed-readonly — the store the row lives in. */
|
|
24
|
+
store: CheckpointStore;
|
|
25
|
+
/** borrowed-mutable — the Runner's same-Runner claims: this attempt opens its own with the CAS and closes it once the duty is decided. */
|
|
26
|
+
locallyClaimedTokens: LocalClaims;
|
|
27
|
+
/** borrowed-mutable — the Runner's parked-constraint registry: the token's entry is evicted once the row is expired. */
|
|
28
|
+
parentConstraintRegistry: Map<CheckpointToken, NonNullable<InheritedGate["parentConstraints"]>>;
|
|
29
|
+
/** borrowed-mutable — the Runner's suspended-env reap handles: whoever runs the expired duty takes and retires this token's. */
|
|
30
|
+
suspendedEnvReaps: Map<CheckpointToken, SuspendReap>;
|
|
31
|
+
/** borrowed-readonly — the bounded destroy's label, and where its timeout or throw (or a failed read after a loss) is said, with the parked session. */
|
|
32
|
+
destroyLabel: string;
|
|
33
|
+
onDestroyError: (err: unknown, sessionId: string) => void;
|
|
34
|
+
}
|
|
35
|
+
/** Settle the row `expired`; `true` = this call won the CAS, `false` = another settler already had (the duty still runs if the row is expired). */
|
|
36
|
+
export declare function expireRowWithDuty(input: ExpireRowInput): Promise<boolean>;
|
|
37
|
+
/**
|
|
38
|
+
* A settle attempt of this Runner LOST its CAS: read the row, and run the expired duty when it is `expired`. Answers what was seen —
|
|
39
|
+
* the row's status, `"absent"` (no row), or `undefined` (nothing held here to act on, or the read threw: said, record kept) — and
|
|
40
|
+
* never throws.
|
|
41
|
+
*/
|
|
42
|
+
export declare function settleLostRow(input: Omit<ExpireRowInput, "scope" | "locallyClaimedTokens">): Promise<"pending" | "resolved" | "expired" | "absent" | undefined>;
|
|
43
|
+
/** The expired row's duty in THIS Runner: evict the parked constraint, take the reap record, destroy its env (bounded). */
|
|
44
|
+
export declare function runExpiredDuty(input: Omit<ExpireRowInput, "scope" | "store" | "locallyClaimedTokens">): Promise<void>;
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import { hasDestroy } from "../remote-env.js";
|
|
2
|
+
import { settleTeardownLeg } from "./teardown-bounded.js";
|
|
3
|
+
export async function expireRowWithDuty(input) {
|
|
4
|
+
const { token, scope, store, locallyClaimedTokens } = input;
|
|
5
|
+
locallyClaimedTokens.open(token);
|
|
6
|
+
let won;
|
|
7
|
+
try {
|
|
8
|
+
won = await store.expire(token, scope);
|
|
9
|
+
}
|
|
10
|
+
catch (expireErr) {
|
|
11
|
+
locallyClaimedTokens.close(token);
|
|
12
|
+
throw expireErr;
|
|
13
|
+
}
|
|
14
|
+
locallyClaimedTokens.close(token);
|
|
15
|
+
if (!won) {
|
|
16
|
+
await settleLostRow(input);
|
|
17
|
+
return false;
|
|
18
|
+
}
|
|
19
|
+
await runExpiredDuty(input);
|
|
20
|
+
return true;
|
|
21
|
+
}
|
|
22
|
+
export async function settleLostRow(input) {
|
|
23
|
+
const { token, store, suspendedEnvReaps } = input;
|
|
24
|
+
const reap = suspendedEnvReaps.get(token);
|
|
25
|
+
if (reap === undefined)
|
|
26
|
+
return undefined;
|
|
27
|
+
let status;
|
|
28
|
+
try {
|
|
29
|
+
status = (await store.get(token))?.status ?? "absent";
|
|
30
|
+
}
|
|
31
|
+
catch (readErr) {
|
|
32
|
+
say(input, readErr, reap.sessionId);
|
|
33
|
+
return undefined;
|
|
34
|
+
}
|
|
35
|
+
if (status === "expired")
|
|
36
|
+
await runExpiredDuty(input);
|
|
37
|
+
return status;
|
|
38
|
+
}
|
|
39
|
+
export async function runExpiredDuty(input) {
|
|
40
|
+
const { token, parentConstraintRegistry, suspendedEnvReaps, destroyLabel } = input;
|
|
41
|
+
parentConstraintRegistry.delete(token);
|
|
42
|
+
const reap = suspendedEnvReaps.get(token);
|
|
43
|
+
suspendedEnvReaps.delete(token);
|
|
44
|
+
if (reap === undefined || reap.env === undefined)
|
|
45
|
+
return;
|
|
46
|
+
const { env, sessionId } = reap;
|
|
47
|
+
await settleTeardownLeg(() => (hasDestroy(env) ? env.destroy() : undefined), destroyLabel, (envErr) => say(input, envErr, sessionId));
|
|
48
|
+
}
|
|
49
|
+
function say(input, err, sessionId) {
|
|
50
|
+
try {
|
|
51
|
+
input.onDestroyError(err, sessionId);
|
|
52
|
+
}
|
|
53
|
+
catch {
|
|
54
|
+
}
|
|
55
|
+
}
|
|
@@ -4,8 +4,8 @@ import type { RunnerDeps, TaskSpec } from "../types.js";
|
|
|
4
4
|
/**
|
|
5
5
|
* The file-history REQUEST door: every refusal the request (`TaskSpec`) and the deployment's own seats decide
|
|
6
6
|
* without the session, the env or the store's contents — the three bad-value doors (`RunnerDeps.onTrackFailure`,
|
|
7
|
-
* `RunnerDeps.fileHistoryStore` / `fileHistoryCapture`, `TaskSpec.fileHistory`), the
|
|
8
|
-
*
|
|
7
|
+
* `RunnerDeps.fileHistoryStore` / `fileHistoryCapture`, `TaskSpec.fileHistory`), the restoreFiles / resumeAt /
|
|
8
|
+
* rewindFilesTo contradictions, and a restore asked of a run that holds no
|
|
9
9
|
* history (`rewind.capture_disabled` / `rewind.store_unconfigured`). SYNCHRONOUS and side-effect free; the driver
|
|
10
10
|
* calls it BEFORE the session is acquired, so a request refused here leaves the session — its leaf included —
|
|
11
11
|
* exactly as it was. What it resolves rides into the file-history phase (`prepareFileHistory`) unchanged.
|
|
@@ -4,14 +4,6 @@ export function resolveFileHistoryRequest(spec, deps) {
|
|
|
4
4
|
const declaredOff = wiredSeat === "disabled" || runDeclaredOff;
|
|
5
5
|
const fileHistoryStore = declaredOff ? undefined : wiredSeat;
|
|
6
6
|
const captureStore = captureOff ? undefined : fileHistoryStore;
|
|
7
|
-
const legacyRewindFiles = spec.rewindFiles;
|
|
8
|
-
if (legacyRewindFiles === true) {
|
|
9
|
-
if (spec.resumeAt !== undefined) {
|
|
10
|
-
const e = new Error(`rewind-files: TaskSpec.rewindFiles is retired (design/381 — rewind now converges the per-edited-file history, not a whole-tree snapshot). This request pairs it with resumeAt, i.e. the RESTORE sense: set restoreFiles: true instead. (The capture sense needs no request anymore — first-touch tracking is on whenever a RunnerDeps.fileHistoryStore is wired and neither RunnerDeps.fileHistoryCapture nor TaskSpec.fileHistory turns it off.)`);
|
|
11
|
-
e.code = "rewind.rewind_files_retired";
|
|
12
|
-
throw e;
|
|
13
|
-
}
|
|
14
|
-
}
|
|
15
7
|
if (spec.restoreFiles === true && spec.resumeAt === undefined) {
|
|
16
8
|
const e = new Error(`rewind-files: restoreFiles: true needs a resumeAt anchor — restoring files means converging them to a specific prior entry's boundary, and this spec names none. Use resumeAt + restoreFiles to move conversation and files together, or rewindFilesTo alone for a code-only restore.`);
|
|
17
9
|
e.code = "rewind.invalid_spec";
|
|
@@ -140,24 +140,55 @@ export declare function frozenInputSnapshot(input: unknown): unknown;
|
|
|
140
140
|
/** What one `classic.PreToolUse` screening came to: an answer the receipt took (`undefined` = no opinion), or the
|
|
141
141
|
* engine's fail-closed refusal of the call with its sentence (a handler that failed or broke the site's contract,
|
|
142
142
|
* or a cancel). */
|
|
143
|
-
/** A screen's outcome
|
|
144
|
-
*
|
|
145
|
-
*
|
|
143
|
+
/** A screen's outcome over every installation that screens the call (the leg's own bus, then each inherited installation). An
|
|
144
|
+
* answer is the leg's own verdict — or an inherited installation's `deny`, which ends the screen — naming the registration that
|
|
145
|
+
* answered it (`answeredBy`, absent when no handler spoke); its `updatedInput` is the bytes the screen ended on when any
|
|
146
|
+
* installation rewrote, `rewrittenBy` the extensions that authored them (in the order they rewrote). `contexts` are every
|
|
147
|
+
* `additionalContext` line the screen collected, in raise order. `settled`: an inherited installation's question was refused
|
|
148
|
+
* where its installation froze it (`deniedBy` / `cause` as the pass's ledger read the refusal). A refusal — a deny, a failure, a
|
|
149
|
+
* settled refusal — names the bytes its judge judged (`judged`) when a rewrite earlier in the screen made them other bytes than
|
|
150
|
+
* those the screen was given. */
|
|
146
151
|
export type PreToolUseScreen = {
|
|
147
152
|
readonly kind: "answered";
|
|
148
153
|
readonly answer: PreToolUseResult | undefined;
|
|
149
154
|
readonly answeredBy?: string;
|
|
150
155
|
readonly rewrittenBy?: readonly string[];
|
|
156
|
+
readonly contexts: readonly string[];
|
|
157
|
+
readonly inherited?: InheritedScreenRead;
|
|
158
|
+
readonly judged?: unknown;
|
|
151
159
|
} | {
|
|
152
160
|
readonly kind: "refused";
|
|
153
161
|
readonly reason: string; /** the registration the bus names for the failed screening (the mint reads whether it names an extension); absent on a cancel */
|
|
154
162
|
readonly extension?: string;
|
|
163
|
+
readonly judged?: unknown;
|
|
164
|
+
} | {
|
|
165
|
+
readonly kind: "settled";
|
|
166
|
+
readonly deny: PermissionResult;
|
|
167
|
+
readonly deniedBy: DeniedBy;
|
|
168
|
+
readonly cause?: ClassifierDenyCause;
|
|
169
|
+
readonly judged?: unknown;
|
|
155
170
|
};
|
|
171
|
+
/** What the inherited installations' `classic.PreToolUse` came to beside the leg's own answer (present when one was raised): the
|
|
172
|
+
* registrations whose `allow` is no objection here (the allow layer's `hook` member discloses them; an inherited allow clears
|
|
173
|
+
* nothing of this leg's), the question a settlement floated to this leg's park (the call is marked; it folds as the leg's own
|
|
174
|
+
* hook ask does), and a person's approval of an edit at an installation's question (the gate's approved-edit pass takes it). */
|
|
175
|
+
export interface InheritedScreenRead {
|
|
176
|
+
readonly allowedBy: readonly string[];
|
|
177
|
+
readonly floated?: Extract<PermissionResult, {
|
|
178
|
+
action: "ask";
|
|
179
|
+
}>;
|
|
180
|
+
readonly approved?: Extract<PermissionResult, {
|
|
181
|
+
action: "allow";
|
|
182
|
+
}> & {
|
|
183
|
+
readonly updatedInput: unknown;
|
|
184
|
+
};
|
|
185
|
+
}
|
|
156
186
|
/**
|
|
157
|
-
* The PreToolUse screening face as the gate's stations see it — `classic.PreToolUse` raised on the leg's bus
|
|
158
|
-
* per-screening e, the answer receipt
|
|
159
|
-
*
|
|
160
|
-
*
|
|
187
|
+
* The PreToolUse screening face as the gate's stations see it — `classic.PreToolUse` raised on the leg's bus and then on each
|
|
188
|
+
* inherited installation's, the per-screening e, the answer receipt, the installations' settlements and the fail-closed
|
|
189
|
+
* sentences behind one method, so every re-screen (the fold's second look, the approved-edit pass) runs the SAME screening
|
|
190
|
+
* the phase-1 pass ran. Present on the pass exactly when a handler hangs on the event on one of those buses (an observe
|
|
191
|
+
* handler of the leg's own runs inside the screening too; it never decides).
|
|
161
192
|
*/
|
|
162
193
|
export interface PreToolUseScreening {
|
|
163
194
|
/** Raise `classic.PreToolUse` over `args`; `subject` names what is screened in a fail-closed sentence; `readAs` is the call
|
|
@@ -169,6 +200,31 @@ export interface PreToolUseScreening {
|
|
|
169
200
|
/** The model-facing text for the screen's OWN deny of this call (unwrapped; every exit wraps it with the leg's mark). */
|
|
170
201
|
deniedReason(answer: PreToolUseResult): string;
|
|
171
202
|
}
|
|
203
|
+
/** What the inherited installations said in a screen, taken onto the pass — the one reading for phase 1 and the fold's second
|
|
204
|
+
* look: a floated question folds as the leg's own hook ask does (the call is marked, so no layer of this leg answers it), the
|
|
205
|
+
* allow speakers go to the allow layer's disclosure (the latest screen's reading replaces an earlier one), and a person's
|
|
206
|
+
* approved edit waits for the lanes' approved-edit pass. */
|
|
207
|
+
export declare function takeInheritedScreen(pass: GatePass, read: InheritedScreenRead | undefined): void;
|
|
208
|
+
/** A screen's `settled` outcome: an inherited installation's question refused where its installation froze it, in the layer word
|
|
209
|
+
* and the cause its reader read (`policy` when it read none), over the bytes its judge judged when a rewrite made them others. */
|
|
210
|
+
export declare function settledScreen(read: {
|
|
211
|
+
readonly decision: PermissionResult;
|
|
212
|
+
readonly deniedBy?: DeniedBy;
|
|
213
|
+
readonly cause?: ClassifierDenyCause;
|
|
214
|
+
}, judged: {
|
|
215
|
+
readonly judged?: unknown;
|
|
216
|
+
}): Extract<PreToolUseScreen, {
|
|
217
|
+
kind: "settled";
|
|
218
|
+
}>;
|
|
219
|
+
/** A settled screen taken onto the pass — the one reading for phase 1, the fold's second look and the approved-edit pass's two
|
|
220
|
+
* screens: its layer word and cause are the pass's; the refusal is returned for the site to stand (the decision, or the edit's). */
|
|
221
|
+
export declare function takeSettledScreen(pass: GatePass, settled: Extract<PreToolUseScreen, {
|
|
222
|
+
kind: "settled";
|
|
223
|
+
}>): PermissionResult;
|
|
224
|
+
/** A settled screen ends the pass as the call's settlement: its refusal is the decision, through the single deny exit. */
|
|
225
|
+
export declare function settledScreenExit(pass: GatePass, settled: Extract<PreToolUseScreen, {
|
|
226
|
+
kind: "settled";
|
|
227
|
+
}>): Promise<ToolGateResult>;
|
|
172
228
|
/** The FACE a pass's questions are put on ({@link askFaceOf} of the call's wire name) — the one reading of it the
|
|
173
229
|
* write-protection tighten (the fold) and every class derivation (the lanes) make. */
|
|
174
230
|
export declare function passAskFace(pass: Pick<GatePass, "req">): AskFace;
|
|
@@ -255,6 +311,18 @@ export interface GatePass {
|
|
|
255
311
|
* that answered it: the allow layer's hook member (its `entries`). Writers: the dispatch (phase 1) and the fold's second
|
|
256
312
|
* look after a policy rewrite (rewrite-rejudge.ts), whose answer replaces the first. Reader: the lanes' allow layer. */
|
|
257
313
|
hookAllowedBy?: readonly string[];
|
|
314
|
+
/** borrowed-mutable — the inherited installations whose `classic.PreToolUse` answered `allow` for the bytes that run: no
|
|
315
|
+
* objection, disclosed as the allow layer's `hook` member over a standing ask (never a clear). Writers: the dispatch (phase 1)
|
|
316
|
+
* and the fold's second look (its reading replaces the first). Reader: the lanes' allow layer. */
|
|
317
|
+
inheritedAllowedBy?: readonly string[];
|
|
318
|
+
/** borrowed-mutable — a person at an inherited installation's question approved an EDIT of the call during a screen: the lanes
|
|
319
|
+
* take it into the approved-edit pass after the fold (as a `tool.check` raise's approval is taken). Writers: the dispatch
|
|
320
|
+
* (phase 1) and the fold's second look. Reader: the lanes. */
|
|
321
|
+
screenApproval?: Extract<PermissionResult, {
|
|
322
|
+
action: "allow";
|
|
323
|
+
}> & {
|
|
324
|
+
readonly updatedInput: unknown;
|
|
325
|
+
};
|
|
258
326
|
/** borrowed-mutable — `tool.check` was raised in this pass's first adjudication, which raises it once: set by the
|
|
259
327
|
* raise in front of the ask branch, read by the raise behind the read-only arm (it then raises nothing). Writer and
|
|
260
328
|
* reader: the lanes. */
|
|
@@ -2,7 +2,7 @@ import { screenGateOutcome, SETTLEMENT_IS_REFUSAL } from "../gate-outcome.js";
|
|
|
2
2
|
import { askFaceOf, classifyAsk, headlessApprovalRemedy } from "../ask-origin.js";
|
|
3
3
|
import { wireOf } from "../tool-name-readings.js";
|
|
4
4
|
import { isProtectedWrite } from "../tool-registry.js";
|
|
5
|
-
import { attestationOf, decisionText, licenseCovers } from "../tool-policy.js";
|
|
5
|
+
import { attestationOf, decisionText, foldHookAsk, licenseCovers } from "../tool-policy.js";
|
|
6
6
|
import { pathDenialCardOf } from "../../tools/fs/safety.js";
|
|
7
7
|
import { argsAsTheToolReads } from "../effective-path-target.js";
|
|
8
8
|
import { rewriteRecordOf } from "../rewrite-rejudge.js";
|
|
@@ -218,6 +218,25 @@ function withParkFailureCause(reason, parkFailed, nobodyJudged) {
|
|
|
218
218
|
const note = `${reason} — note: a durable approval park was attempted for this call and could not be minted (${inlineUntrusted(parkFailed, PARK_FAILURE_CAUSE_MAX)})`;
|
|
219
219
|
return nobodyJudged ? `${note}; with nobody to judge the call, that is why it stopped — it can be issued again once its park can be minted.` : `${note}.`;
|
|
220
220
|
}
|
|
221
|
+
export function takeInheritedScreen(pass, read) {
|
|
222
|
+
if (read?.floated !== undefined)
|
|
223
|
+
pass.hookAsk = pass.hookAsk !== undefined ? foldHookAsk(pass.hookAsk, read.floated) : read.floated;
|
|
224
|
+
pass.inheritedAllowedBy = read !== undefined && read.allowedBy.length > 0 ? read.allowedBy : undefined;
|
|
225
|
+
if (read?.approved !== undefined)
|
|
226
|
+
pass.screenApproval = read.approved;
|
|
227
|
+
}
|
|
228
|
+
export function settledScreen(read, judged) {
|
|
229
|
+
return { kind: "settled", deny: read.decision, deniedBy: read.deniedBy ?? "policy", ...(read.cause !== undefined ? { cause: read.cause } : {}), ...judged };
|
|
230
|
+
}
|
|
231
|
+
export function takeSettledScreen(pass, settled) {
|
|
232
|
+
pass.deniedBy = settled.deniedBy;
|
|
233
|
+
pass.denyCause = settled.cause;
|
|
234
|
+
return settled.deny;
|
|
235
|
+
}
|
|
236
|
+
export async function settledScreenExit(pass, settled) {
|
|
237
|
+
pass.decision = takeSettledScreen(pass, settled);
|
|
238
|
+
return await exitGate(pass);
|
|
239
|
+
}
|
|
221
240
|
export function passAskFace(pass) {
|
|
222
241
|
return askFaceOf(wireOf("gate.askFace", pass.req));
|
|
223
242
|
}
|