@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
|
@@ -1,18 +1,21 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { optionKeys, receiveMembers } from "./own-property-receipt.js";
|
|
2
|
+
import { refuseRetentionPolicy, retentionKnobRefusal } from "./retention-policy.js";
|
|
2
3
|
export const DEFAULT_FILE_HISTORY_BOUNDARY_KEEP = 100;
|
|
3
|
-
const
|
|
4
|
-
export function
|
|
4
|
+
const FILE_HISTORY_RETENTION_KNOBS = optionKeys()({ keep: 0 });
|
|
5
|
+
export function receiveFileHistoryRetention(label, policy) {
|
|
5
6
|
if (policy === undefined)
|
|
6
|
-
return
|
|
7
|
+
return undefined;
|
|
7
8
|
if (typeof policy !== "object" || policy === null || Array.isArray(policy)) {
|
|
8
|
-
refuseRetentionPolicy(label, "retention", policy, `an object of retention knobs (${
|
|
9
|
-
}
|
|
10
|
-
const unknown = Object.keys(policy).filter((k) => !KNOWN_KNOBS.has(k));
|
|
11
|
-
if (unknown.length > 0) {
|
|
12
|
-
const first = unknown[0];
|
|
13
|
-
refuseRetentionPolicy(label, `retention.${first}`, policy[first], `omitted — ${JSON.stringify(first)} is not a retention knob (the only knob is "keep"), and a misspelled one would leave the engine default in force while the operator believes their own number is`);
|
|
9
|
+
refuseRetentionPolicy(label, "retention", policy, `an object of retention knobs (${FILE_HISTORY_RETENTION_KNOBS.join(", ")}) or omitted`);
|
|
14
10
|
}
|
|
15
|
-
const
|
|
11
|
+
const copy = receiveMembers(policy, { subject: `${label}.retention`, unit: "retention knob", moment: "at construction" }, FILE_HISTORY_RETENTION_KNOBS, retentionKnobRefusal);
|
|
12
|
+
boundaryKeepOf(label, copy.keep);
|
|
13
|
+
return copy;
|
|
14
|
+
}
|
|
15
|
+
export function resolveFileHistoryRetention(label, policy) {
|
|
16
|
+
return boundaryKeepOf(label, receiveFileHistoryRetention(label, policy)?.keep);
|
|
17
|
+
}
|
|
18
|
+
function boundaryKeepOf(label, keep) {
|
|
16
19
|
if (keep === undefined)
|
|
17
20
|
return DEFAULT_FILE_HISTORY_BOUNDARY_KEEP;
|
|
18
21
|
if (keep === "unbounded")
|
|
@@ -597,7 +597,37 @@ export interface FileHistoryStore {
|
|
|
597
597
|
*/
|
|
598
598
|
exportHistory?(scope: string): Promise<FileHistoryExportResult>;
|
|
599
599
|
importHistory?(scope: string, data: FileHistoryExport, srcGetBlob: (hash: string) => Promise<Uint8Array | undefined>): Promise<FileHistoryResult>;
|
|
600
|
+
/**
|
|
601
|
+
* The store's blob exchange — how another machine's bytes come in ahead of an import, go out to a puller, and are
|
|
602
|
+
* asked about — as one optional member group ({@link FileHistoryBlobExchange}): present ⇒ all three of its members;
|
|
603
|
+
* absent ⇒ this store exchanges no blobs (it can still import, from a source the caller reads). Read through
|
|
604
|
+
* {@link fileHistoryBlobExchangeOf}, which refuses a group with a member missing. A puller hands
|
|
605
|
+
* `blobExchange.get` to {@link importHistory} as its `srcGetBlob`.
|
|
606
|
+
*/
|
|
607
|
+
readonly blobExchange?: FileHistoryBlobExchange;
|
|
608
|
+
}
|
|
609
|
+
/**
|
|
610
|
+
* {@link FileHistoryStore.blobExchange}: one capability, three members.
|
|
611
|
+
*
|
|
612
|
+
* - `put(hash, bytes)` stores bytes under their content address. The store checks the address itself — bytes whose
|
|
613
|
+
* sha256 is not `hash` are refused (`adopt_failed`, `permanence: "terminal"`) and nothing is stored — and records
|
|
614
|
+
* the blob present the same way a capture records one, so bytes no history references yet are kept like any other
|
|
615
|
+
* unreferenced blob: until the orphan sweep's grace window runs out. Idempotent.
|
|
616
|
+
* - `get(hash)` answers the bytes, or `undefined` when the store does not hold them.
|
|
617
|
+
* - `has(hashes)` answers which of `hashes` the store holds, from its own index — no bytes are read.
|
|
618
|
+
*/
|
|
619
|
+
export interface FileHistoryBlobExchange {
|
|
620
|
+
put(hash: string, bytes: Uint8Array): Promise<FileHistoryResult>;
|
|
621
|
+
get(hash: string): Promise<Uint8Array | undefined>;
|
|
622
|
+
has(hashes: readonly string[]): Promise<ReadonlySet<string>>;
|
|
600
623
|
}
|
|
624
|
+
/**
|
|
625
|
+
* The store's blob exchange, read as one capability: `undefined` when the store carries no `blobExchange`; its three
|
|
626
|
+
* members, bound, when it carries the whole group; a refusal (`config.invalid_argument`) when the group is not an
|
|
627
|
+
* object or a member is missing or not a function. A store that still carries the retired `syncBlobFaces` marker is
|
|
628
|
+
* refused too: the capability is the group's presence, and a second word for it is a second reading.
|
|
629
|
+
*/
|
|
630
|
+
export declare function fileHistoryBlobExchangeOf(store: FileHistoryStore): FileHistoryBlobExchange | undefined;
|
|
601
631
|
/**
|
|
602
632
|
* design/381 §3 + §10 T-5 — the FENCING judge for a boundary-capture attempt, exposed as a
|
|
603
633
|
* direct-callable function (the G6b grey-box seat) and used by every in-tree backend as the single
|
|
@@ -852,7 +882,7 @@ export declare class InMemoryFileHistoryStore implements FileHistoryStore {
|
|
|
852
882
|
* (adversarial round): two concurrent captures can lease the same new hash, and the first
|
|
853
883
|
* attempt's release must not strip the second attempt's liveness. */
|
|
854
884
|
private readonly inFlightBlobs;
|
|
855
|
-
constructor(
|
|
885
|
+
constructor(options?: InMemoryFileHistoryStoreOptions);
|
|
856
886
|
/**
|
|
857
887
|
* The RETENTION pass, run after a boundary commits (design/381 §片2 — see {@link FileHistoryStore.reap}
|
|
858
888
|
* for why the backend owns this rather than the host). Boundaries are an insertion-ordered map
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
2
|
import { readMember, thrownText } from "./thrown-value.js";
|
|
3
|
+
import { readMemberGroup } from "./member-group.js";
|
|
3
4
|
import { isAbsoluteForFamily, isWinFormPath, pathFamilyOf, relativeInEveryFamily } from "../tools/fs/safety.js";
|
|
4
5
|
import { fileHistoryBoundariesToKeep, resolveFileHistoryRetention } from "./file-history-retention.js";
|
|
6
|
+
import { optionKeys, receiveOptions } from "./own-property-receipt.js";
|
|
5
7
|
const normSlash = (p) => p.replace(/\\/g, "/");
|
|
6
8
|
const stripTrailSep = (p) => (isWinFormPath(p) ? p.replace(/[\\/]+$/, "") : p.replace(/\/+$/, ""));
|
|
7
9
|
const foldDrive = (p) => (/^[A-Za-z]:(\/|$)/.test(p) ? p[0].toLowerCase() + p.slice(1) : p);
|
|
@@ -244,6 +246,31 @@ function judgeFileHistoryEnvelope(data) {
|
|
|
244
246
|
}
|
|
245
247
|
return { ok: true };
|
|
246
248
|
}
|
|
249
|
+
const BLOB_EXCHANGE_MEMBERS = Object.freeze(["put", "get", "has"]);
|
|
250
|
+
export function fileHistoryBlobExchangeOf(store) {
|
|
251
|
+
const owner = "FileHistoryStore.blobExchange";
|
|
252
|
+
let marker;
|
|
253
|
+
let group;
|
|
254
|
+
try {
|
|
255
|
+
marker = Reflect.get(store, "syncBlobFaces");
|
|
256
|
+
group = store.blobExchange;
|
|
257
|
+
}
|
|
258
|
+
catch (cause) {
|
|
259
|
+
throw invalidBlobExchange(`${owner} could not be read (${thrownText(cause)}).`);
|
|
260
|
+
}
|
|
261
|
+
if (marker !== undefined)
|
|
262
|
+
throw invalidBlobExchange(`FileHistoryStore carries the retired syncBlobFaces marker — the blob exchange is the ${owner} group (put / get / has): present means the capability, absent means none.`);
|
|
263
|
+
if (group === undefined)
|
|
264
|
+
return undefined;
|
|
265
|
+
if (typeof group !== "object" || group === null)
|
|
266
|
+
throw invalidBlobExchange(`${owner} must be an object with put / get / has (got ${group === null ? "null" : typeof group}).`);
|
|
267
|
+
return readMemberGroup(owner, group, BLOB_EXCHANGE_MEMBERS, true);
|
|
268
|
+
}
|
|
269
|
+
function invalidBlobExchange(message) {
|
|
270
|
+
const e = new Error(message);
|
|
271
|
+
e.code = "config.invalid_argument";
|
|
272
|
+
return e;
|
|
273
|
+
}
|
|
247
274
|
export function boundaryPublishVerdict(attempt) {
|
|
248
275
|
return attempt.aborted ? { publish: false, reason: "aborted" } : { publish: true };
|
|
249
276
|
}
|
|
@@ -412,13 +439,15 @@ async function applyRecordedMode(env, absPath, opts, currentMode) {
|
|
|
412
439
|
const r = await env.setFileMode(absPath, want & 0o7777, opts.signal);
|
|
413
440
|
return r.ok ? "applied" : "unpreserved";
|
|
414
441
|
}
|
|
442
|
+
const IN_MEMORY_FILE_HISTORY_STORE_OPTION_KEYS = optionKeys()({ retention: 0 });
|
|
415
443
|
export class InMemoryFileHistoryStore {
|
|
416
444
|
scopes = new Map();
|
|
417
445
|
boundaryKeep;
|
|
418
446
|
blobs = new Map();
|
|
419
447
|
inFlightBlobs = new Map();
|
|
420
|
-
constructor(
|
|
421
|
-
|
|
448
|
+
constructor(options) {
|
|
449
|
+
const opts = receiveOptions(options, "InMemoryFileHistoryStore", IN_MEMORY_FILE_HISTORY_STORE_OPTION_KEYS);
|
|
450
|
+
this.boundaryKeep = resolveFileHistoryRetention("InMemoryFileHistoryStore", opts.retention);
|
|
422
451
|
}
|
|
423
452
|
applyBoundaryRetention(scope, justCommitted) {
|
|
424
453
|
if (this.boundaryKeep === null)
|
|
@@ -40,6 +40,13 @@ export interface FrameSettlement {
|
|
|
40
40
|
* host decided what the model reads, so the consumer settles the record as the host's decision (terminal),
|
|
41
41
|
* discloses it loudly, and never hands it over again. */
|
|
42
42
|
readonly hostWithheld: Set<string>;
|
|
43
|
+
/** Awaited keys whose frame the session's receiving station did not hand over ({@link settleConsumedFrame}): an
|
|
44
|
+
* extension consumed it, or a handler there failed — key → who (an extension's name, or `engine`) and why. The consumer
|
|
45
|
+
* settles the record as that decision (terminal), tells its sender, and never hands it over again. */
|
|
46
|
+
readonly consumed: Map<string, {
|
|
47
|
+
readonly by: string;
|
|
48
|
+
readonly reason: string;
|
|
49
|
+
}>;
|
|
43
50
|
/** Compactions that LANDED this run and have not been consumed by a settlement pass yet, in landing
|
|
44
51
|
* order. Recorded only while {@link FrameSettlement.wantsEffects} says a record could still be
|
|
45
52
|
* broken by one, and cleared by the consumer's LOCAL settlement half — which needs no lease, so an
|
|
@@ -63,6 +70,9 @@ export interface FrameSettlement {
|
|
|
63
70
|
wantsEffects?: () => boolean;
|
|
64
71
|
}
|
|
65
72
|
export declare function createFrameSettlement(): FrameSettlement;
|
|
73
|
+
/** The receiving station did not hand the frame keyed `key` over: its ask is answered now, as consumed (only an ask some
|
|
74
|
+
* consumer registered is answered — a frame nobody awaits leaves nothing behind). */
|
|
75
|
+
export declare function settleConsumedFrame(seam: FrameSettlement, key: string, by: string, reason: string): void;
|
|
66
76
|
/** The carrier key of a TOOL RESULT (the `ReadInbox` pull face): its own domain, so it can never
|
|
67
77
|
* collide with an injection queue dedup key. One tool result can carry SEVERAL frames, each asked for
|
|
68
78
|
* under its own key with this carrier. */
|
|
@@ -81,6 +91,11 @@ export declare function frameSurvivesInToolResult(committedContent: unknown, fra
|
|
|
81
91
|
/** The station that applies a HOST hook's `updatedOutput` marks the carrier — only when an ask rides it, so an
|
|
82
92
|
* ordinary rewritten result leaves nothing behind. */
|
|
83
93
|
export declare function noteHostRewrite(seam: FrameSettlement, toolCallId: string): void;
|
|
94
|
+
/** A station WITHHELD a call's result in place of what it produced (a checking extension could not hand back its answer):
|
|
95
|
+
* the host side decided what the model reads, so the carrier is marked as rewritten and its asks are answered now,
|
|
96
|
+
* against the content that replaces the result, through the one writer below — a call whose result no transcript commit
|
|
97
|
+
* follows (an extension's own call) is settled all the same, and the commit of one that does follow finds nothing left. */
|
|
98
|
+
export declare function settleWithheldResult(seam: FrameSettlement, toolCallId: string, content: unknown): void;
|
|
84
99
|
/** The receipt sink's ONE writer: every ask riding `carrier` is answered — a receipt when its frame is in
|
|
85
100
|
* the committed content (or it is its own carrier); when it is not, host-withheld if a host hook rewrote the
|
|
86
101
|
* carrier (the host's decision), withheld otherwise (owed again). */
|
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
export function createFrameSettlement() {
|
|
2
|
-
return { awaiting: new Map(), receipts: new Map(), withheld: new Set(), hostRewritten: new Set(), hostWithheld: new Set(), compactions: [] };
|
|
2
|
+
return { awaiting: new Map(), receipts: new Map(), withheld: new Set(), hostRewritten: new Set(), hostWithheld: new Set(), consumed: new Map(), compactions: [] };
|
|
3
|
+
}
|
|
4
|
+
export function settleConsumedFrame(seam, key, by, reason) {
|
|
5
|
+
if (!seam.awaiting.delete(key))
|
|
6
|
+
return;
|
|
7
|
+
seam.consumed.set(key, Object.freeze({ by, reason }));
|
|
3
8
|
}
|
|
4
9
|
export function toolResultReceiptKey(toolCallId) {
|
|
5
10
|
return `tool_result:${toolCallId}`;
|
|
@@ -22,6 +27,10 @@ export function noteHostRewrite(seam, toolCallId) {
|
|
|
22
27
|
}
|
|
23
28
|
}
|
|
24
29
|
}
|
|
30
|
+
export function settleWithheldResult(seam, toolCallId, content) {
|
|
31
|
+
noteHostRewrite(seam, toolCallId);
|
|
32
|
+
recordFrameReceipt(seam, toolResultReceiptKey(toolCallId), content, "");
|
|
33
|
+
}
|
|
25
34
|
export function recordFrameReceipt(seam, carrier, committedContent, entryId) {
|
|
26
35
|
const hostRewrote = seam.hostRewritten.delete(carrier);
|
|
27
36
|
for (const [key, ask] of seam.awaiting) {
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { ExecutionEnv } from "../internal/harness-types.js";
|
|
2
|
-
import type { PermissionResult, ToolPolicy } from "./tool-policy.js";
|
|
2
|
+
import type { PermissionResult, ToolCallRequest, ToolPolicy } from "./tool-policy.js";
|
|
3
3
|
import { type PathGuardRow } from "./path-guard-rows.js";
|
|
4
4
|
/** One write domain SOURCE as an allow row of the one table: it reaches every location at or below one of its admitted keys.
|
|
5
5
|
* The write gate's three sources, and a session rule's `allowDirs` (the confinement that admits a write only inside them). */
|
|
@@ -39,8 +39,8 @@ export interface FsWriteGatePolicyOptions {
|
|
|
39
39
|
defaultWrite: "ask" | "allow";
|
|
40
40
|
/** The ask the default verdict mints in place of the gate's ordinary write question — a permission mode's own
|
|
41
41
|
* sentence over the resolved `path`, with the gate's domain note (a configured domain that was not honored) to
|
|
42
|
-
* append when there is one. Read only where `defaultWrite` is `"ask"`. */
|
|
43
|
-
defaultAsk?: (path: string, note: string | undefined) => PermissionResult;
|
|
42
|
+
* append when there is one, and the call it answers. Read only where `defaultWrite` is `"ask"`. */
|
|
43
|
+
defaultAsk?: (path: string, note: string | undefined, call: ToolCallRequest) => PermissionResult;
|
|
44
44
|
/**
|
|
45
45
|
* Session-exemption lookup ("allow all for this session" grants recorded by the deployment's approval
|
|
46
46
|
* surface). Consulted ONCE per covered write, after the domain checks and immediately BEFORE the gate
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { canonicalizeTarget, lexicalViewOf, pathFamilyOf, writeTargetPath } from "../tools/fs/safety.js";
|
|
2
|
+
import { attest } from "./engine-attestation.js";
|
|
2
3
|
import { isWithin } from "./runner/session-rule-policy.js";
|
|
3
4
|
import { swallowedFenceRoot } from "./runner/advertised-writable-dirs.js";
|
|
4
5
|
import { declaredPathTargetOf, isProtectedWrite } from "./tool-registry.js";
|
|
@@ -51,9 +52,6 @@ export function createFsWriteGatePolicy(opts) {
|
|
|
51
52
|
const rootLexical = absoluteRootOf(rootPath, env.cwd);
|
|
52
53
|
assertExemptDirsDoNotCoverRoot(exemptDirs, rootLexical);
|
|
53
54
|
const guardedCapable = env.writeFileGuarded !== undefined;
|
|
54
|
-
const advisory = guardedCapable
|
|
55
|
-
? ""
|
|
56
|
-
: " (advisory adjudication: this environment provides no guarded write, so approval is judged before a separate, non-atomic write step)";
|
|
57
55
|
return {
|
|
58
56
|
async check(req, signal) {
|
|
59
57
|
if (!isProtectedWrite(req))
|
|
@@ -68,11 +66,11 @@ export function createFsWriteGatePolicy(opts) {
|
|
|
68
66
|
const declared = declaredPathTargetOf(req);
|
|
69
67
|
const path = declared === undefined ? undefined : writeTargetPath(req, declared);
|
|
70
68
|
if (path === undefined) {
|
|
71
|
-
return ask(`write tool "${req.toolName}" requires approval: the call has no resolvable path target to confine${declared === undefined ? " (the tool declares no path target)" : ""}
|
|
69
|
+
return ask(`write tool "${req.toolName}" requires approval: the call has no resolvable path target to confine${declared === undefined ? " (the tool declares no path target)" : ""}`);
|
|
72
70
|
}
|
|
73
71
|
const canon = await canonicalizeTarget(env, path, signal, pathFamilyOf({ root: rootPath, cwd: req.cwd ?? env.cwd }), pathTargetBaseOf(declared, { root: rootPath, cwd: req.cwd }));
|
|
74
72
|
if (!canon.ok) {
|
|
75
|
-
return ask(`write to "${path}" requires approval: its real target could not be resolved (${canon.message})
|
|
73
|
+
return ask(`write to "${path}" requires approval: its real target could not be resolved (${canon.message})`);
|
|
76
74
|
}
|
|
77
75
|
const advertised = req.advertisedWritableRoots ?? [];
|
|
78
76
|
const targetViews = { views: [{ path: canon.key, kind: "canonical" }] };
|
|
@@ -132,8 +130,11 @@ export function createFsWriteGatePolicy(opts) {
|
|
|
132
130
|
return { action: "allow" };
|
|
133
131
|
const note = refusedDomain === undefined ? undefined : ` — note: the configured write domain ${refusedDomain} was not honored; a domain that holds the root would exempt every write under it`;
|
|
134
132
|
if (opts.defaultAsk !== undefined)
|
|
135
|
-
return opts.defaultAsk(path, note);
|
|
136
|
-
|
|
133
|
+
return opts.defaultAsk(path, note, req);
|
|
134
|
+
if (note !== undefined)
|
|
135
|
+
return ask(`approve write to "${path}"?${note}`);
|
|
136
|
+
const generic = `approve write to "${path}"?`;
|
|
137
|
+
return attest(ask(generic), req, { genericQuestion: generic });
|
|
137
138
|
},
|
|
138
139
|
};
|
|
139
140
|
}
|
package/dist/core/gate-fold.js
CHANGED
|
@@ -2,7 +2,7 @@ import { inlineUntrusted } from "./untrusted-text.js";
|
|
|
2
2
|
import { markTightenMessage } from "./safety-axis-vocab.js";
|
|
3
3
|
import { PROBE_REASON_MAX, normalizeProbeCause } from "./checkpoint-store.js";
|
|
4
4
|
import { normalizeReadRootCandidate } from "./read-root-candidate.js";
|
|
5
|
-
import { engineFailClosedExit, hookDenyExit } from "./runner/gate-exit.js";
|
|
5
|
+
import { engineFailClosedExit, hookDenyExit, settledScreenExit, takeInheritedScreen } from "./runner/gate-exit.js";
|
|
6
6
|
import { noteRewrite, POLICY_AUTHOR, readRejudge, screenRewrite } from "./rewrite-rejudge.js";
|
|
7
7
|
import { traceHookCrash } from "./gate-crash-trace.js";
|
|
8
8
|
import { writeProtectionMandated, writeProtectionReachOf, writeProtectionTightenDecision } from "./write-protect.js";
|
|
@@ -12,7 +12,7 @@ import { failedJudgmentDeny } from "./runner/policy-throw.js";
|
|
|
12
12
|
import { thrownText } from "./thrown-value.js";
|
|
13
13
|
import { argsAsTheToolReads } from "./effective-path-target.js";
|
|
14
14
|
import { foldHookAsk, refuseOutOfContractDecision } from "./tool-policy.js";
|
|
15
|
-
import { withProbeMandate } from "./ask-origin.js";
|
|
15
|
+
import { withChainAskReasons, withProbeMandate } from "./ask-origin.js";
|
|
16
16
|
import { applyUnansweredSilence, readStationAnswer, silencedBy } from "./shell-read-silence.js";
|
|
17
17
|
import { asksUnstated, permissionSeatAt, unstatedAskMessage } from "./mode-policy.js";
|
|
18
18
|
export async function runGateFold(pass) {
|
|
@@ -40,17 +40,20 @@ export async function runGateFold(pass) {
|
|
|
40
40
|
if (attributed !== undefined)
|
|
41
41
|
pass.classifierRound = attributed;
|
|
42
42
|
}
|
|
43
|
+
pass.decision = withChainAskReasons(pass.decision, pass.req);
|
|
43
44
|
const rewritten = pass.screening !== undefined && pass.decision.action !== "deny" ? readRejudge(pass.req, pass.currentInput, pass.decision) : undefined;
|
|
44
45
|
if (pass.screening !== undefined && rewritten?.kind === "rewritten") {
|
|
45
46
|
const second = await screenRewrite(pass.screening, pass.req, rewritten.form, `the rewritten call to "${toolName}"`);
|
|
46
|
-
if (second.kind === "refused") {
|
|
47
|
-
pass.currentInput = rewritten.form;
|
|
47
|
+
if (second.kind === "refused" || second.kind === "settled") {
|
|
48
|
+
pass.currentInput = second.judged !== undefined ? second.judged : rewritten.form;
|
|
49
|
+
if (second.kind === "settled")
|
|
50
|
+
return await settledScreenExit(pass, second);
|
|
48
51
|
return second.by === "hook" ? hookDenyExit(pass, second.reason, second.extension) : await engineFailClosedExit(pass, second.reason, second.extension);
|
|
49
52
|
}
|
|
50
|
-
|
|
51
|
-
pass.preToolContext.push(second.answer.additionalContext);
|
|
53
|
+
pass.preToolContext.push(...second.contexts);
|
|
52
54
|
pass.hookAsk = second.answer?.action === "ask" ? second.answer : undefined;
|
|
53
55
|
pass.hookAllowedBy = second.answer?.action === "allow" ? (second.answeredBy !== undefined ? [second.answeredBy] : []) : undefined;
|
|
56
|
+
takeInheritedScreen(pass, second.inherited);
|
|
54
57
|
}
|
|
55
58
|
if ((pass.decision.action === "allow" || pass.decision.action === "ask") && pass.decision.updatedInput !== undefined) {
|
|
56
59
|
pass.policyRewrite = argsAsTheToolReads(pass.req, pass.decision.updatedInput);
|
package/dist/core/gate-lanes.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { argsAsTheToolReads, withArgsReading } from "./effective-path-target.js";
|
|
2
2
|
import { attest, attestationOf, bindableArgsOf, decisionText, foldHookAsk, refusalOf, refuseOutOfContractDecision } from "./tool-policy.js";
|
|
3
3
|
import { APPROVER_AUTHOR, extensionAuthors, noteRewrite, outletAsk, POLICY_AUTHOR, readRejudge, rewriteChasedSentence, screenRewrite } from "./rewrite-rejudge.js";
|
|
4
|
-
import { arbitrateByMode, classifyAsk, decisionAskClassesOf, dontAskRefusalMessage, fileCommandOptionsSentence, persistedRuleMandateOf, safetyAxisOf, stampAskOrigin } from "./ask-origin.js";
|
|
4
|
+
import { arbitrateByMode, askReasonsOf, classifyAsk, joinAskReasons, decisionAskClassesOf, dontAskRefusalMessage, fileCommandOptionsSentence, persistedRuleMandateOf, safetyAxisOf, stampAskOrigin, withChainAskReasons } from "./ask-origin.js";
|
|
5
5
|
import { classifierParseFailureDenyMessage, denialLimitFallbackMessage, rungDidNotRule, unarmedWindow } from "./auto-mode.js";
|
|
6
6
|
import { classifierNoRulingArm, settleNoRulingAsk } from "./classifier-unavailable-arm.js";
|
|
7
7
|
import { SETTLEMENT_NOBODY_JUDGED } from "./gate-outcome.js";
|
|
@@ -19,12 +19,13 @@ import { callFaceSeat } from "./tool-roster.js";
|
|
|
19
19
|
import { wireOf } from "./tool-name-readings.js";
|
|
20
20
|
import { modeAcceptsFileCommand } from "./mode-policy.js";
|
|
21
21
|
import { ORG_RULE_DECISION_REASON, ORG_UNAVAILABLE_DECISION_REASON, orgUnreadableClause } from "./permission-rule-org.js";
|
|
22
|
-
import { exitGate, passAskFace, untakenValueExit } from "./runner/gate-exit.js";
|
|
22
|
+
import { exitGate, passAskFace, takeSettledScreen, untakenValueExit } from "./runner/gate-exit.js";
|
|
23
23
|
import { readOrgRuleLane, readPersistedRuleLane } from "./rule-lane-reads.js";
|
|
24
24
|
import { traceHookCrash } from "./gate-crash-trace.js";
|
|
25
25
|
import { createGateDeadline, awaitWriteProtectionJudgment, withGateTimeout } from "./gate-bounded-await.js";
|
|
26
26
|
import { readStationAnswer } from "./shell-read-silence.js";
|
|
27
|
-
import {
|
|
27
|
+
import { judgedInputOf, raiseToolCheck } from "./mods/stations.js";
|
|
28
|
+
import { agentIdOf } from "./leg-identity.js";
|
|
28
29
|
import { extensionAllowOf, readToolChecks } from "./tool-check-reading.js";
|
|
29
30
|
import { policyThrowLine, reportPolicyThrow } from "./runner/policy-throw.js";
|
|
30
31
|
function parkWith(suspendAsk, parkArgs, carry) {
|
|
@@ -60,6 +61,7 @@ export async function runGateLanes(pass) {
|
|
|
60
61
|
...(d.action === "ask" && d.askClass !== undefined && d.classes !== undefined ? { askClass: d.askClass, classes: d.classes } : {}),
|
|
61
62
|
...(d.action === "ask" && d.mandated === true ? { mandated: true, ...(d.mandate !== undefined ? { mandate: d.mandate } : {}) } : {}),
|
|
62
63
|
...(d.action === "ask" && d.authoredBy === "deployment" ? { authoredBy: "deployment" } : {}),
|
|
64
|
+
...askReasonsOf(d),
|
|
63
65
|
});
|
|
64
66
|
const parkAsk = async (d, req, args, safety, liveFaceUnavailable, org) => {
|
|
65
67
|
if (suspendAsk === undefined || d.action !== "ask")
|
|
@@ -193,7 +195,7 @@ export async function runGateLanes(pass) {
|
|
|
193
195
|
};
|
|
194
196
|
const chains = [
|
|
195
197
|
...(own !== undefined ? [{ raise: (p) => raiseToolCheck(own, { ...e }, p, signal), ...(mayClear !== undefined ? { mayClear } : {}) }] : []),
|
|
196
|
-
...(input.
|
|
198
|
+
...(input.inheritedInstallations ?? []).map((c) => ({ raise: (p) => raiseToolCheck(c.bus, { ...e }, p, signal, c.judges), settle: settleThroughLedger(c.settle) })),
|
|
197
199
|
];
|
|
198
200
|
const project = (current, clears) => {
|
|
199
201
|
const reason = decisionText(current);
|
|
@@ -208,7 +210,9 @@ export async function runGateLanes(pass) {
|
|
|
208
210
|
pass.deniedExtension = settledRefusal === undefined ? by : undefined;
|
|
209
211
|
pass.denyCause = settledRefusal?.cause;
|
|
210
212
|
};
|
|
211
|
-
if (pass.decision.action
|
|
213
|
+
if (pass.screenApproval !== undefined && pass.decision.action !== "deny")
|
|
214
|
+
takeApprovedEdit({ kind: "approved", allow: pass.screenApproval });
|
|
215
|
+
if (pass.decision.action === "allow" && !approvedWithArgs) {
|
|
212
216
|
const read = await checkTool(pass.decision, finalArgs, orgAnswer.org, pass.policyRewrite);
|
|
213
217
|
if (read !== undefined)
|
|
214
218
|
pass.toolCheckRaised = true;
|
|
@@ -274,6 +278,7 @@ export async function runGateLanes(pass) {
|
|
|
274
278
|
const storedAllows = laneAnswer?.hit?.behavior === "allow" ? laneAnswer.hit.rules : undefined;
|
|
275
279
|
const members = [
|
|
276
280
|
["hook", () => (pass.hookAllowedBy !== undefined ? { entries: pass.hookAllowedBy, clear: () => extensionAllowOf(pass.hookAllowedBy ?? [], pass.policyRewrite), afterClear: async () => undefined } : undefined)],
|
|
281
|
+
["hook", () => (pass.inheritedAllowedBy !== undefined ? { entries: pass.inheritedAllowedBy, clear: () => extensionAllowOf(pass.inheritedAllowedBy ?? [], pass.policyRewrite), afterClear: async () => undefined, discloseOnly: true } : undefined)],
|
|
277
282
|
["deployment", () => {
|
|
278
283
|
const hit = input.deploymentAllows?.allowing(pass.req, mode);
|
|
279
284
|
return hit && { entries: hit.entries, ...(hit.positions !== undefined ? { positions: hit.positions } : {}), clear: () => listAllow("deployment_rule", "the deployment's", hit.entries), afterClear: () => notifier.notifyAsync(() => input.deploymentAllows?.onAllowed?.({ toolName: pass.req.toolName, toolCallId, entries: hit.entries }), "toolGate.allowedToolsResolved") };
|
|
@@ -309,7 +314,7 @@ export async function runGateLanes(pass) {
|
|
|
309
314
|
const hit = match();
|
|
310
315
|
if (hit === undefined)
|
|
311
316
|
continue;
|
|
312
|
-
if (allowMayClear()) {
|
|
317
|
+
if (hit.discloseOnly !== true && allowMayClear()) {
|
|
313
318
|
pass.decision = await clearAs(member, hit);
|
|
314
319
|
break;
|
|
315
320
|
}
|
|
@@ -585,16 +590,27 @@ export async function runGateLanes(pass) {
|
|
|
585
590
|
let rewrittenEdit = false;
|
|
586
591
|
if (screening !== undefined) {
|
|
587
592
|
const screened = await screening.screen(editArgs, `the approved edit for "${toolName}"`, pass.req);
|
|
593
|
+
if ((screened.kind !== "answered" || screened.answer?.action === "deny") && screened.judged !== undefined)
|
|
594
|
+
editArgs = screened.judged;
|
|
588
595
|
if (screened.kind === "refused") {
|
|
589
596
|
editDenied = { action: "deny", message: screened.reason };
|
|
590
597
|
pass.deniedBy = "hook";
|
|
591
598
|
pass.deniedExtension = screened.extension;
|
|
592
599
|
break;
|
|
593
600
|
}
|
|
601
|
+
if (screened.kind === "settled") {
|
|
602
|
+
editDenied = takeSettledScreen(pass, screened);
|
|
603
|
+
break;
|
|
604
|
+
}
|
|
605
|
+
pass.preToolContext.push(...screened.contexts);
|
|
606
|
+
if (screened.inherited?.approved !== undefined) {
|
|
607
|
+
shownToApprover = { bytes: editArgs };
|
|
608
|
+
editArgs = screened.inherited.approved.updatedInput;
|
|
609
|
+
editAnswer = screened.inherited.approved;
|
|
610
|
+
continue;
|
|
611
|
+
}
|
|
594
612
|
const hr = screened.answer;
|
|
595
613
|
if (hr) {
|
|
596
|
-
if (hr.additionalContext)
|
|
597
|
-
pass.preToolContext.push(hr.additionalContext);
|
|
598
614
|
if (hr.action === "deny") {
|
|
599
615
|
editDenied = { action: "deny", message: decisionText(hr) ?? `the approved edit for "${toolName}" was blocked by a PreToolUse hook` };
|
|
600
616
|
pass.deniedBy = "hook";
|
|
@@ -612,6 +628,9 @@ export async function runGateLanes(pass) {
|
|
|
612
628
|
rewrittenEdit = true;
|
|
613
629
|
}
|
|
614
630
|
}
|
|
631
|
+
const floatedAsk = screened.inherited?.floated;
|
|
632
|
+
if (floatedAsk !== undefined)
|
|
633
|
+
editHookAsk = editHookAsk !== undefined ? foldHookAsk(editHookAsk, floatedAsk) : floatedAsk;
|
|
615
634
|
}
|
|
616
635
|
let recheck = { action: "allow" };
|
|
617
636
|
if (adjudicate) {
|
|
@@ -632,7 +651,7 @@ export async function runGateLanes(pass) {
|
|
|
632
651
|
if (attributed !== undefined)
|
|
633
652
|
pass.classifierRound = attributed;
|
|
634
653
|
const read = ledger.fromDecision(recheck);
|
|
635
|
-
recheck = read.decision;
|
|
654
|
+
recheck = withChainAskReasons(read.decision, { toolCallId, toolName });
|
|
636
655
|
if (recheck.action === "deny" && read.deniedBy !== undefined) {
|
|
637
656
|
editDenied = recheck;
|
|
638
657
|
pass.deniedBy = read.deniedBy;
|
|
@@ -655,16 +674,30 @@ export async function runGateLanes(pass) {
|
|
|
655
674
|
editArgs = policyRead.form;
|
|
656
675
|
rewrittenEdit = true;
|
|
657
676
|
const second = screening !== undefined ? await screenRewrite(screening, pass.req, editArgs, `the rewritten edit for "${toolName}"`) : undefined;
|
|
677
|
+
if ((second?.kind === "refused" || second?.kind === "settled") && second.judged !== undefined)
|
|
678
|
+
editArgs = second.judged;
|
|
658
679
|
if (second?.kind === "refused") {
|
|
659
680
|
editDenied = { action: "deny", message: second.reason };
|
|
660
681
|
pass.deniedBy = "hook";
|
|
661
682
|
pass.deniedExtension = second.extension;
|
|
662
683
|
break;
|
|
663
684
|
}
|
|
685
|
+
if (second?.kind === "settled") {
|
|
686
|
+
editDenied = takeSettledScreen(pass, second);
|
|
687
|
+
break;
|
|
688
|
+
}
|
|
664
689
|
if (second?.kind === "stands") {
|
|
665
|
-
|
|
666
|
-
pass.preToolContext.push(second.answer.additionalContext);
|
|
690
|
+
pass.preToolContext.push(...second.contexts);
|
|
667
691
|
editHookAsk = second.answer?.action === "ask" ? second.answer : undefined;
|
|
692
|
+
const floatedAsk = second.inherited?.floated;
|
|
693
|
+
if (floatedAsk !== undefined)
|
|
694
|
+
editHookAsk = editHookAsk !== undefined ? foldHookAsk(editHookAsk, floatedAsk) : floatedAsk;
|
|
695
|
+
if (second.inherited?.approved !== undefined) {
|
|
696
|
+
shownToApprover = { bytes: editArgs };
|
|
697
|
+
editArgs = second.inherited.approved.updatedInput;
|
|
698
|
+
editAnswer = second.inherited.approved;
|
|
699
|
+
continue;
|
|
700
|
+
}
|
|
668
701
|
}
|
|
669
702
|
}
|
|
670
703
|
const editOrg = await applyOrgLayer(recheck, editArgs);
|
|
@@ -720,7 +753,8 @@ export async function runGateLanes(pass) {
|
|
|
720
753
|
const rra = carried.requiresRealApproval === true ? { requiresRealApproval: true } : {};
|
|
721
754
|
const call = { toolCallId, toolName };
|
|
722
755
|
const folded = new Set([...(editDecision.action === "ask" ? (attestationOf(editDecision, call)?.foldedClasses ?? []) : []), ...decisionAskClassesOf(carried, call), ...(carried.classes ?? [])]);
|
|
723
|
-
|
|
756
|
+
const askReasons = editDecision.action === "ask" ? joinAskReasons(editDecision.askReasons, carried.askReasons) : undefined;
|
|
757
|
+
editDecision = stampEditAsk(editDecision.action === "ask" ? attest({ ...editDecision, ...rra, ...(askReasons !== undefined ? { askReasons } : {}) }, call, { foldedClasses: [...folded] }) : carried);
|
|
724
758
|
carriedOwnAsk = undefined;
|
|
725
759
|
}
|
|
726
760
|
const editRead = await checkTool(editDecision, editArgs, editOrg.org, undefined);
|
|
@@ -135,12 +135,51 @@ export declare function isSettlementParty(v: unknown): v is SettlementParty;
|
|
|
135
135
|
export declare const HOST_DECIDERS: readonly ["person", "sla_timeout", "policy"];
|
|
136
136
|
export type HostDecider = (typeof HOST_DECIDERS)[number];
|
|
137
137
|
export declare const isHostDecider: (word: unknown) => word is HostDecider;
|
|
138
|
+
/**
|
|
139
|
+
* WHICH MACHINE SEAT answered when the deployment's policy decided an ask — the closed set of the `decidedVia` member
|
|
140
|
+
* (`AskOutcome.decidedVia` on the synchronous leg, `hostDecision.decidedVia` on a durable decide; one word set, one
|
|
141
|
+
* name, both faces). It refines the policy decider and nothing else: a person, an elapsed window and the host's SLA
|
|
142
|
+
* sweep are not machines that answered, so the member beside any other decider word is refused, never ignored.
|
|
143
|
+
* - `policy` — the deployment's own policy answered (an unattended lane answering by class, a headless lane whose
|
|
144
|
+
* seat can show nobody a prompt). ABSENT reads the same: an unrevised host is unchanged.
|
|
145
|
+
* - `permission_request_hook` — a PermissionRequest hook answered the ask on the deployment's behalf (the
|
|
146
|
+
* reference's `decisionReason.type: "hook"` with `hookName: "PermissionRequest"`, `iPt` (cli309.js:288208) /
|
|
147
|
+
* `runHooks` (cli309.js:295883)). A hook's refusal is not "this run has no approval channel": something DID answer,
|
|
148
|
+
* and the model reads that the hook declined, with the hook's own words.
|
|
149
|
+
* The record is unchanged by it (`policy_allowed` / `policy_refused`, `who.party: "policy"`): the member decides which
|
|
150
|
+
* sentence the model reads ({@link import("./tool-policy.js").policyRefusalMessage}), not which party the record names.
|
|
151
|
+
*/
|
|
152
|
+
export declare const DECIDED_VIA: readonly ["policy", "permission_request_hook"];
|
|
153
|
+
export type DecidedVia = (typeof DECIDED_VIA)[number];
|
|
154
|
+
export declare const isDecidedVia: (word: unknown) => word is DecidedVia;
|
|
155
|
+
/** The model-facing NAME of each machine seat a policy decision can come from ({@link policyDeciderOf}). */
|
|
156
|
+
declare const POLICY_DECIDER_NAMES: Readonly<{
|
|
157
|
+
readonly policy: "this deployment's own policy";
|
|
158
|
+
readonly permission_request_hook: "a PermissionRequest hook";
|
|
159
|
+
}>;
|
|
160
|
+
/** The fence over the name table: `never` while every seat word has a name. */
|
|
161
|
+
export type PolicyDeciderNamesCoverEverySeat = AssertAllKeysHandled<Exclude<DecidedVia, keyof typeof POLICY_DECIDER_NAMES>>;
|
|
162
|
+
/**
|
|
163
|
+
* THE reading of `decidedVia` — the one place its absence folds ("absent ⇒ the deployment's own policy") and the one
|
|
164
|
+
* place each seat is NAMED to the model. Every sentence that names who REFUSED a tool approval for the policy reads it:
|
|
165
|
+
* the refusal composer ({@link import("./tool-policy.js").policyRefusalMessage}, all three legs) and the durable
|
|
166
|
+
* resume's continuation reminder, so the tool result and the reminder about the same refusal can never name two
|
|
167
|
+
* different deciders. A sentence about a policy's ALLOW that a later check refuses names the party alone ("not a
|
|
168
|
+
* person"), and so does a plan pause's reminder.
|
|
169
|
+
*/
|
|
170
|
+
export declare function policyDeciderOf(decidedVia: DecidedVia | undefined): {
|
|
171
|
+
readonly seat: DecidedVia;
|
|
172
|
+
readonly name: string;
|
|
173
|
+
};
|
|
138
174
|
/** The host's DECISION FACTS on a durable decide — who ended the wait, and the attribution the approval channel
|
|
139
175
|
* reported for that party. ONE shape for every decide that records its decider (a tool approval's and a plan
|
|
140
|
-
* pause's); core mints the settlement word from it ({@link settlementOfHostDecision}), the host never supplies one.
|
|
176
|
+
* pause's); core mints the settlement word from it ({@link settlementOfHostDecision}), the host never supplies one.
|
|
177
|
+
* `decidedVia` — which machine seat answered for a `"policy"` decider ({@link DECIDED_VIA}); legal only beside
|
|
178
|
+
* `decidedBy: "policy"`, absent ⇒ the deployment's policy. */
|
|
141
179
|
export interface HostDecisionFacts {
|
|
142
180
|
decidedBy: HostDecider;
|
|
143
181
|
approver?: string;
|
|
182
|
+
decidedVia?: DecidedVia;
|
|
144
183
|
}
|
|
145
184
|
/** The DECIDER arms of {@link Settlement} — a person's and the deployment policy's, the two parties that
|
|
146
185
|
* answer an ask either way. Named so a site that both composes one and quotes its note can read the seat
|
|
@@ -28,6 +28,16 @@ export function isSettlementParty(v) {
|
|
|
28
28
|
}
|
|
29
29
|
export const HOST_DECIDERS = Object.freeze(["person", "sla_timeout", "policy"]);
|
|
30
30
|
export const isHostDecider = (word) => HOST_DECIDERS.some((w) => w === word);
|
|
31
|
+
export const DECIDED_VIA = Object.freeze(["policy", "permission_request_hook"]);
|
|
32
|
+
export const isDecidedVia = (word) => DECIDED_VIA.some((w) => w === word);
|
|
33
|
+
const POLICY_DECIDER_NAMES = Object.freeze({
|
|
34
|
+
policy: "this deployment's own policy",
|
|
35
|
+
permission_request_hook: "a PermissionRequest hook",
|
|
36
|
+
});
|
|
37
|
+
export function policyDeciderOf(decidedVia) {
|
|
38
|
+
const seat = decidedVia ?? "policy";
|
|
39
|
+
return { seat, name: POLICY_DECIDER_NAMES[seat] };
|
|
40
|
+
}
|
|
31
41
|
export function decidersNote(text) {
|
|
32
42
|
return text === "" ? undefined : text;
|
|
33
43
|
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { ExecutionEnv } from "../internal/harness-types.js";
|
|
1
|
+
import type { ExecutionEnv, ReadFloor } from "../internal/harness-types.js";
|
|
2
2
|
/** The managed parent (under the repository root) that holds every managed worktree — the reference implementation's
|
|
3
3
|
* `.claude/worktrees/` under this project's brand — so {@link pruneWorktrees} and a userland reaper find orphans by one known
|
|
4
4
|
* location. Every tree the engine mints lives at `<repoRoot>/.sema/worktrees/<slug>` (see {@link managedWorktreeDir}). */
|
|
@@ -31,6 +31,10 @@ export interface AddWorktreeOptions {
|
|
|
31
31
|
rootEnvAt: (worktreeDir: string) => ExecutionEnv | Promise<ExecutionEnv>;
|
|
32
32
|
/** Base commit/ref for the worktree (default `HEAD` at creation time). */
|
|
33
33
|
commit?: string;
|
|
34
|
+
/** The byte floor (`ExecutionEnvExecOptions.readFloor`) of every start the mint and the tree's removal make, read as each
|
|
35
|
+
* start begins: a run's git bookkeeping is the run's own start and carries the run's table. A read that throws is that
|
|
36
|
+
* step's failure (the add's refuses the mint before anything exists). Absent ⇒ the starts carry none (no run). */
|
|
37
|
+
readFloor?: () => ReadFloor | undefined;
|
|
34
38
|
}
|
|
35
39
|
/**
|
|
36
40
|
* Remove a managed worktree and — by the ONE branch rule — its branch: the branch is deleted only when its tip is still the
|
|
@@ -46,7 +50,7 @@ export interface AddWorktreeOptions {
|
|
|
46
50
|
export declare function removeManagedWorktree(baseEnv: ExecutionEnv, repoRoot: string, worktreeDir: string, branch?: {
|
|
47
51
|
readonly name: string;
|
|
48
52
|
readonly baseSha: string;
|
|
49
|
-
}): Promise<{
|
|
53
|
+
}, readFloor?: () => ReadFloor | undefined): Promise<{
|
|
50
54
|
ok: true;
|
|
51
55
|
branchDeleted?: string;
|
|
52
56
|
branchKept?: string;
|
|
@@ -85,7 +89,7 @@ export declare function addWorktree(baseEnv: ExecutionEnv, opts: AddWorktreeOpti
|
|
|
85
89
|
* on a claim it could not have checked. Same fail-loud treatment {@link removeManagedWorktree} already got
|
|
86
90
|
* Report the outcome, let the caller decide what to say. Never throws (a throwing env
|
|
87
91
|
* lands on the same `{ok:false}`), so a caller that ignores the value behaves exactly as before. */
|
|
88
|
-
export declare function pruneWorktrees(baseEnv: ExecutionEnv, repoRoot: string): Promise<{
|
|
92
|
+
export declare function pruneWorktrees(baseEnv: ExecutionEnv, repoRoot: string, readFloor?: ReadFloor): Promise<{
|
|
89
93
|
ok: true;
|
|
90
94
|
} | {
|
|
91
95
|
ok: false;
|