@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
|
@@ -85,6 +85,17 @@ export interface PathRuleDenyRow {
|
|
|
85
85
|
* A leg judges the row where that location LEADS too ({@link withRuleRowsWhereTheyLead}). Absent on a hand-built
|
|
86
86
|
* row, or one whose head cannot be read: it is judged as spelled. */
|
|
87
87
|
readonly head?: string;
|
|
88
|
+
/** The row's reach as a shape an OS confinement translates (the rule model's `pathRuleReachShapeOf`): the absolute
|
|
89
|
+
* location the resolved pattern starts at (`at`, the identity spelling, `/` for the root) and the glob segments after it
|
|
90
|
+
* (`*` within a segment, `**` across segments) — the row reaches every path whose segments below `at` match the globs as
|
|
91
|
+
* a PREFIX (the path the pattern names, and everything below it). Absent on a hand-built row or one whose pattern cannot
|
|
92
|
+
* be resolved: a confinement cannot express it, and a start carrying it is refused. */
|
|
93
|
+
readonly reachShape?: RuleReachShape;
|
|
94
|
+
}
|
|
95
|
+
/** {@link PathRuleDenyRow.reachShape}. */
|
|
96
|
+
export interface RuleReachShape {
|
|
97
|
+
readonly at: string;
|
|
98
|
+
readonly globs: readonly string[];
|
|
88
99
|
}
|
|
89
100
|
/** A row's reach over ONE absolute spelling, three-valued: `unreadable` = the row cannot be judged there (a base its anchor
|
|
90
101
|
* lacks) — a tightening judgment holds on it, an allow grants nothing on it. */
|
|
@@ -219,9 +230,20 @@ export interface ReadDenyMatcher {
|
|
|
219
230
|
* covers. A rule row's reach below a path is not enumerable: any rule row answers. */
|
|
220
231
|
rowAtOrBelow?(path: string): ReadDenyHit | null;
|
|
221
232
|
/** The table ONE call judges with — the Runner's tables are one per read of the person's rules, and a call judges with
|
|
222
|
-
* the read it was pinned to (an unknown or released call: the run's latest
|
|
223
|
-
*
|
|
233
|
+
* the read it was pinned to (an unknown or released call: the run's latest; no call, `undefined`: the table a judgment
|
|
234
|
+
* that is no call's takes now, refused as that judgment is — what a command start that is no call's pins). Absent on a
|
|
235
|
+
* table compiled once: it is every call's ({@link seatForCall}). */
|
|
224
236
|
forCall?(toolCallId: string | undefined): ReadDenyMatcher;
|
|
237
|
+
/** The compiled segment rows `matchPath` judges with (built-in tiers, additions, each placement of a placed row) — what an
|
|
238
|
+
* OS confinement translates the table from (read-floor.ts); the rule rows are {@link ruleRows}. Absent on a hand-built
|
|
239
|
+
* matcher: such a table has no confinement. */
|
|
240
|
+
readonly compiledSegments?: readonly CompiledSegmentPattern[];
|
|
241
|
+
/** The table's identity, minted once where {@link compileReadDeny} compiles it: a compiled table never changes its
|
|
242
|
+
* judgment, so two tables with one `id` judge every path alike. Not enumerable: a spread copy (which may replace the
|
|
243
|
+
* judgment) has none; the copy that only carries other home views (`carryHomeViews`) keeps it. Absent on a hand-built
|
|
244
|
+
* matcher and on a judge that reads another table at each judgment (`readDenyOver`): neither is one compiled table. The
|
|
245
|
+
* byte floor a start carries reports it (`ReadFloor.id`). */
|
|
246
|
+
readonly id?: string;
|
|
225
247
|
}
|
|
226
248
|
/** A seat the run's tables back — a deny table, a read-root set — as ONE call takes it: the call's own where the seat
|
|
227
249
|
* carries `forCall`, the seat itself otherwise (a table compiled once, a host's own list) and for a reader that is no
|
|
@@ -438,6 +460,8 @@ export interface SegmentMatcher {
|
|
|
438
460
|
test(segment: string): boolean;
|
|
439
461
|
/** The pattern is stars only: it matches every one segment. */
|
|
440
462
|
readonly anything: boolean;
|
|
463
|
+
/** The segment pattern as folded at compile (`*` the one metacharacter) — what an OS confinement translates the segment from. */
|
|
464
|
+
readonly source: string;
|
|
441
465
|
}
|
|
442
466
|
/** A compiled segment-run pattern (shared engine — the write guard delegates here too). */
|
|
443
467
|
export interface CompiledSegmentPattern {
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
1
2
|
import { sliceHeadSafe, sliceTailSafe } from "../../core/surrogate-safe-slice.js";
|
|
2
3
|
import { isAbsoluteForFamily, normalizeAbsPathLexically, pathFamilyOf, pathIdentityOf, spellingOfIdentity } from "./safety.js";
|
|
3
4
|
import { PROBE_REASON_MAX } from "../../core/untrusted-text.js";
|
|
@@ -99,10 +100,12 @@ function rowLedTo(row, head, at) {
|
|
|
99
100
|
return to.identity;
|
|
100
101
|
return id.identity.startsWith(under) ? `${onto}/${id.identity.slice(under.length)}` : undefined;
|
|
101
102
|
};
|
|
102
|
-
const { head: _head, ...rest } = row;
|
|
103
|
+
const { head: _head, reachShape: shape, ...rest } = row;
|
|
103
104
|
const reach = row.reach;
|
|
105
|
+
const twinShape = shape === undefined ? undefined : shape.at === to.identity ? { at: base, globs: shape.globs } : shape.at.startsWith(`${onto}/`) ? { at: `${under}${shape.at.slice(onto.length + 1)}`, globs: shape.globs } : undefined;
|
|
104
106
|
return {
|
|
105
107
|
...rest,
|
|
108
|
+
...(twinShape !== undefined ? { reachShape: twinShape } : {}),
|
|
106
109
|
reaches: (absolutePath) => {
|
|
107
110
|
const m = mapped(absolutePath);
|
|
108
111
|
return m !== undefined && row.reaches(m);
|
|
@@ -372,6 +375,7 @@ function foldedViewsOf(views) {
|
|
|
372
375
|
function segmentMatcher(pattern) {
|
|
373
376
|
return {
|
|
374
377
|
anything: /^\*+$/.test(pattern),
|
|
378
|
+
source: pattern,
|
|
375
379
|
test: (segment) => !segment.includes("/") && wildcardMatch(pattern, segment),
|
|
376
380
|
};
|
|
377
381
|
}
|
|
@@ -673,7 +677,7 @@ export function compileReadDeny(additions = [], layer = "additions", builtin, ru
|
|
|
673
677
|
const hit = denyTableHit(tableRows, { views: [{ path, kind: "lexical", ...(opts?.aliasResolved === true ? { aliasResolved: true } : {}) }] });
|
|
674
678
|
return hit === null ? null : { pattern: hit.pattern };
|
|
675
679
|
};
|
|
676
|
-
|
|
680
|
+
const table = {
|
|
677
681
|
entries: normalized,
|
|
678
682
|
...(ruleRows.length > 0 ? { ruleRows } : {}),
|
|
679
683
|
matchPath,
|
|
@@ -683,5 +687,8 @@ export function compileReadDeny(additions = [], layer = "additions", builtin, ru
|
|
|
683
687
|
unexcludableUnder,
|
|
684
688
|
rowUnderRoot,
|
|
685
689
|
rowAtOrBelow,
|
|
690
|
+
compiledSegments: Object.freeze([...judged]),
|
|
686
691
|
};
|
|
692
|
+
Object.defineProperty(table, "id", { value: `rdt-${randomUUID()}`, enumerable: false });
|
|
693
|
+
return table;
|
|
687
694
|
}
|
|
@@ -7,13 +7,64 @@
|
|
|
7
7
|
* OPENS. Both read the same rows through the same judgment: this module derives nothing — the rows are the ones the
|
|
8
8
|
* engine's refusals cite (`readDenySeat`) and the judgment is the table's own `matchPath`, read off the table the call
|
|
9
9
|
* is pinned to (`seatForCall`). A floor never loosens the station: what the station refuses never starts.
|
|
10
|
+
*
|
|
11
|
+
* The floor is the run's, never the start's: every start a table owner makes carries the floor its seat answers for that
|
|
12
|
+
* start — a call's own pinned table, else the owner's base table — whether or not the start's output reaches the model.
|
|
13
|
+
* A floor is pinned at the start ({@link readFloorSeat}) and carries the identity of the compiled table it stands on
|
|
14
|
+
* (`ReadFloor.id`, minted where the table is compiled): one id, one judgment.
|
|
15
|
+
*
|
|
16
|
+
* Whether the environment KEEPS the floor is its declaration (`capabilities.keepsReadFloor`), judged once per table
|
|
17
|
+
* owner by {@link judgeReadFloorKept}: a non-empty table on an environment that does not keep it is announced, or
|
|
18
|
+
* refused when the deployment requires the floor.
|
|
10
19
|
*/
|
|
11
|
-
import type { ReadFloor } from "../../internal/harness-types.js";
|
|
20
|
+
import type { ExecutionEnv, ReadFloor } from "../../internal/harness-types.js";
|
|
21
|
+
import { type EngineNotice } from "../../core/engine-notice.js";
|
|
12
22
|
import { type ReadDenyMatcher } from "./read-deny.js";
|
|
13
|
-
/** The floor ONE
|
|
14
|
-
*
|
|
15
|
-
*
|
|
23
|
+
/** The floor ONE command start carries, read at the start off the table it judges with — a tool call's own (`toolCallId`),
|
|
24
|
+
* else the owner's base table (`undefined`: a start that is no call's, such as a git bookkeeping command or a probe whose
|
|
25
|
+
* lines enter the prompt) — `undefined` when that table holds no row (an empty table keeps nothing, and the start then
|
|
26
|
+
* carries no floor: the options are the ones a start took before the floor existed). Throws when the table cannot be
|
|
27
|
+
* read now (a call's tables that failed to compile, the run's newest still compiling, a partition of the person's rows
|
|
28
|
+
* unread): the start is refused. */
|
|
16
29
|
export type ReadFloorSeat = (toolCallId: string | undefined) => ReadFloor | undefined;
|
|
17
|
-
/** The seat over a
|
|
18
|
-
*
|
|
30
|
+
/** The seat over a table owner's deny table (the run's, or a library-direct band's own); `undefined` for no table. Built
|
|
31
|
+
* once per owner; every start the owner makes reads its floor through it, at the start. */
|
|
19
32
|
export declare function readFloorSeat(table: ReadDenyMatcher | undefined): ReadFloorSeat | undefined;
|
|
33
|
+
/** The value gate of the floor requirement (`RunnerDeps.readDenyFloorRequired`, mirrored on `HandsToolkitOptions`), the one
|
|
34
|
+
* gate of every door that admits it: a boolean, or absent (`undefined`, read as "not required"); anything else refuses
|
|
35
|
+
* (`config.read_face_seat`), because a requirement that cannot be read is no requirement and must not read as one side. */
|
|
36
|
+
export declare function screenReadDenyFloorRequired(value: unknown, seat: string): boolean | undefined;
|
|
37
|
+
/** The code a non-empty read-deny table on an environment that does not keep the byte floor carries: the operator's notice,
|
|
38
|
+
* and the prepare refusal when the deployment requires the floor — one fact, one word, two loudness dialects. */
|
|
39
|
+
export declare const READ_DENY_FLOOR_UNKEPT = "config.read_deny_floor_unkept";
|
|
40
|
+
/** What {@link judgeReadFloorKept} is handed: the table's owner states the environment, its table, the floor its own engine
|
|
41
|
+
* starts carry off that table (the base table's), and whether the deployment requires the floor. */
|
|
42
|
+
export interface ReadFloorJudgment {
|
|
43
|
+
readonly env: Pick<ExecutionEnv, "capabilities">;
|
|
44
|
+
readonly table: ReadDenyMatcher | undefined;
|
|
45
|
+
readonly floor: ReadFloor | undefined;
|
|
46
|
+
readonly required: boolean;
|
|
47
|
+
readonly onNotice: ((notice: EngineNotice) => void) | undefined;
|
|
48
|
+
/** The run the judgment is for, carried on the notice (a library-direct band has none). */
|
|
49
|
+
readonly attribution?: {
|
|
50
|
+
readonly sessionId?: string;
|
|
51
|
+
readonly runId?: string;
|
|
52
|
+
};
|
|
53
|
+
/** The owner's once-latch when it judges more than one table (a run: every table it compiles): the notice is said the
|
|
54
|
+
* first time and never again for that owner; a refusal is never latched. Absent ⇒ every judgment may say it. */
|
|
55
|
+
readonly said?: {
|
|
56
|
+
done: boolean;
|
|
57
|
+
};
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* The ONE judgment of whether a table owner's byte floor is kept, taken where the table is compiled: the Runner's prepare
|
|
61
|
+
* for a run (each delegated child on its own environment), a library-direct hand band for the table it compiles itself —
|
|
62
|
+
* never a band handed the Runner's face. Judged on the table's AUTHORITATIVE row count, the rows its refusals cite:
|
|
63
|
+
* · no row ⇒ nothing to keep, no judgment;
|
|
64
|
+
* · rows, and no floor for the owner's engine starts to carry ⇒ an engine defect, refused loudly (the starts would run with
|
|
65
|
+
* fewer rows than the table holds);
|
|
66
|
+
* · rows, on an environment that declares it keeps the floor ⇒ nothing to say;
|
|
67
|
+
* · rows, on one that does not: `required` ⇒ refused with {@link READ_DENY_FLOOR_UNKEPT}; otherwise that word once, to the
|
|
68
|
+
* operator — a recursive read under a root still reads the rows below it there, so the notice is no protection.
|
|
69
|
+
*/
|
|
70
|
+
export declare function judgeReadFloorKept(j: ReadFloorJudgment): void;
|
|
@@ -1,3 +1,7 @@
|
|
|
1
|
+
import { deliverEngineNotice } from "../../core/engine-notice.js";
|
|
2
|
+
import { keepsReadFloor } from "../../core/remote-env.js";
|
|
3
|
+
import { seatbeltProfile } from "../../core/shell-confinement.js";
|
|
4
|
+
import { thrownText } from "../../core/thrown-value.js";
|
|
1
5
|
import { readDenySeat, seatForCall } from "./read-deny.js";
|
|
2
6
|
import { isAbsoluteForFamily } from "./safety.js";
|
|
3
7
|
export function readFloorSeat(table) {
|
|
@@ -5,10 +9,14 @@ export function readFloorSeat(table) {
|
|
|
5
9
|
return undefined;
|
|
6
10
|
return (toolCallId) => readFloorOf(seatForCall(table, toolCallId));
|
|
7
11
|
}
|
|
8
|
-
function readFloorOf(
|
|
12
|
+
function readFloorOf(seat) {
|
|
13
|
+
return floorOver(typeof seat.forCall === "function" ? seat.forCall(undefined) : seat);
|
|
14
|
+
}
|
|
15
|
+
function floorOver(table) {
|
|
9
16
|
const rows = Object.freeze([...readDenySeat(table).denyEntries]);
|
|
10
17
|
if (rows.length === 0)
|
|
11
18
|
return undefined;
|
|
19
|
+
const id = typeof table.id === "string" ? table.id : undefined;
|
|
12
20
|
const denies = (absolutePath) => {
|
|
13
21
|
if (typeof absolutePath !== "string" || !isAbsoluteForFamily("own", absolutePath))
|
|
14
22
|
return rows[0];
|
|
@@ -19,5 +27,236 @@ function readFloorOf(table) {
|
|
|
19
27
|
return rows[0];
|
|
20
28
|
}
|
|
21
29
|
};
|
|
22
|
-
|
|
30
|
+
let made;
|
|
31
|
+
const confinement = (dialect) => {
|
|
32
|
+
if (dialect !== "seatbelt")
|
|
33
|
+
return { ok: false, row: rows[0], reason: `no confinement dialect is named ${JSON.stringify(dialect)} (the one dialect is "seatbelt")` };
|
|
34
|
+
try {
|
|
35
|
+
table.matchPath("/");
|
|
36
|
+
const segments = table.compiledSegments;
|
|
37
|
+
const rules = table.ruleRows ?? NO_RULE_ROWS;
|
|
38
|
+
if (made === undefined || made.segments !== segments || made.rules !== rules)
|
|
39
|
+
made = { segments, rules, profile: seatbeltProfileOf(segments, rules, rows[0]) };
|
|
40
|
+
return made.profile;
|
|
41
|
+
}
|
|
42
|
+
catch (e) {
|
|
43
|
+
return { ok: false, row: rows[0], reason: `the read-deny table cannot be judged now (${thrownText(e).slice(0, 300)})` };
|
|
44
|
+
}
|
|
45
|
+
};
|
|
46
|
+
return Object.freeze({ ...(id !== undefined ? { id } : {}), rows, denies, confinement });
|
|
47
|
+
}
|
|
48
|
+
const SEATBELT_EXPRESSION_MAX = 900;
|
|
49
|
+
const SEGMENT_SEP = "[/\\\\]";
|
|
50
|
+
const NO_RULE_ROWS = Object.freeze([]);
|
|
51
|
+
let canonicalAliases;
|
|
52
|
+
function aliasesOf() {
|
|
53
|
+
if (canonicalAliases !== undefined)
|
|
54
|
+
return canonicalAliases;
|
|
55
|
+
const single = new Map();
|
|
56
|
+
const multi = new Set();
|
|
57
|
+
for (let c = 0; c < 0x30000; c++) {
|
|
58
|
+
if (c >= 0xd800 && c <= 0xdfff)
|
|
59
|
+
continue;
|
|
60
|
+
const ch = String.fromCodePoint(c);
|
|
61
|
+
const n = ch.normalize("NFC");
|
|
62
|
+
if (n === ch)
|
|
63
|
+
continue;
|
|
64
|
+
if ([...n].length === 1)
|
|
65
|
+
single.set(n, [...(single.get(n) ?? []), ch]);
|
|
66
|
+
else
|
|
67
|
+
multi.add(n);
|
|
68
|
+
}
|
|
69
|
+
return (canonicalAliases = { single, multi: [...multi] });
|
|
70
|
+
}
|
|
71
|
+
function codePointExpression(ch, foldAscii, exact) {
|
|
72
|
+
const c = ch.codePointAt(0);
|
|
73
|
+
const letter = (c >= 0x41 && c <= 0x5a) || (c >= 0x61 && c <= 0x7a);
|
|
74
|
+
const spellings = foldAscii && letter ? [ch.toLowerCase(), ch.toUpperCase()] : [ch];
|
|
75
|
+
const aliases = exact ? [] : spellings.flatMap((sp) => aliasesOf().single.get(sp) ?? []);
|
|
76
|
+
if (spellings.length === 1 && aliases.length === 0)
|
|
77
|
+
return escapeLiteral(ch);
|
|
78
|
+
if (letter)
|
|
79
|
+
return `[${[...spellings, ...aliases].join("")}]`;
|
|
80
|
+
return `(${[...spellings, ...aliases].map(escapeLiteral).join("|")})`;
|
|
81
|
+
}
|
|
82
|
+
function escapeLiteral(x) {
|
|
83
|
+
return x.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
84
|
+
}
|
|
85
|
+
function seatbeltProfileOf(segments, rules, firstRow) {
|
|
86
|
+
if (segments === undefined)
|
|
87
|
+
return { ok: false, row: firstRow, reason: "the table carries no compiled rows to translate (a hand-built table)" };
|
|
88
|
+
const reads = new Set();
|
|
89
|
+
const holds = new Set();
|
|
90
|
+
const add = (row, e) => {
|
|
91
|
+
if ("untranslatable" in e)
|
|
92
|
+
return { ok: false, row, reason: e.untranslatable };
|
|
93
|
+
for (const x of [...e.reads, ...e.holds]) {
|
|
94
|
+
if (Buffer.byteLength(JSON.stringify(x)) - 2 > SEATBELT_EXPRESSION_MAX)
|
|
95
|
+
return { ok: false, row, reason: `its expression is longer than the ${SEATBELT_EXPRESSION_MAX} bytes a seatbelt profile reads` };
|
|
96
|
+
}
|
|
97
|
+
for (const x of e.reads)
|
|
98
|
+
reads.add(x);
|
|
99
|
+
for (const x of e.holds)
|
|
100
|
+
holds.add(x);
|
|
101
|
+
return undefined;
|
|
102
|
+
};
|
|
103
|
+
for (const pat of segments) {
|
|
104
|
+
const refused = add(pat.raw, segmentRowExpressions(pat));
|
|
105
|
+
if (refused !== undefined)
|
|
106
|
+
return refused;
|
|
107
|
+
}
|
|
108
|
+
for (const rule of rules) {
|
|
109
|
+
const refused = add(rule.rule, ruleRowExpressions(rule));
|
|
110
|
+
if (refused !== undefined)
|
|
111
|
+
return refused;
|
|
112
|
+
}
|
|
113
|
+
return { ok: true, profile: seatbeltProfile([...reads], [...holds]) };
|
|
114
|
+
}
|
|
115
|
+
function literalExpression(text, foldAscii, exact = false) {
|
|
116
|
+
let out = "";
|
|
117
|
+
for (const cluster of text.match(/\P{M}\p{M}*|\p{M}+/gu) ?? []) {
|
|
118
|
+
for (const ch of cluster) {
|
|
119
|
+
const c = ch.codePointAt(0);
|
|
120
|
+
if (c < 0x20 || c === 0x7f)
|
|
121
|
+
return { untranslatable: "it holds a control character" };
|
|
122
|
+
}
|
|
123
|
+
const composed = cluster.normalize("NFC");
|
|
124
|
+
const decomposed = cluster.normalize("NFD");
|
|
125
|
+
const cannotList = { untranslatable: `its name holds a character (${JSON.stringify(cluster)}) whose canonical spellings the dialect cannot list` };
|
|
126
|
+
if (!exact && aliasesOf().multi.some((m) => composed.includes(m)))
|
|
127
|
+
return cannotList;
|
|
128
|
+
if (exact || (composed === decomposed && cluster === composed)) {
|
|
129
|
+
for (const ch of cluster)
|
|
130
|
+
out += codePointExpression(ch, foldAscii, exact);
|
|
131
|
+
continue;
|
|
132
|
+
}
|
|
133
|
+
const parts = [...decomposed];
|
|
134
|
+
if (parts.length !== 2)
|
|
135
|
+
return cannotList;
|
|
136
|
+
const spell = (x) => [x, ...(aliasesOf().single.get(x) ?? [])];
|
|
137
|
+
const forms = new Set([...spell(composed)]);
|
|
138
|
+
for (const b of spell(parts[0]))
|
|
139
|
+
for (const m of spell(parts[1]))
|
|
140
|
+
forms.add(`${b}${m}`);
|
|
141
|
+
out += `(${[...forms].map(escapeLiteral).join("|")})`;
|
|
142
|
+
}
|
|
143
|
+
return out;
|
|
144
|
+
}
|
|
145
|
+
function segmentExpression(source, foldAscii) {
|
|
146
|
+
const parts = [];
|
|
147
|
+
const texts = source.split("*");
|
|
148
|
+
for (const [i, part] of texts.entries()) {
|
|
149
|
+
const last = [...part.normalize("NFD")].at(-1);
|
|
150
|
+
if ((i < texts.length - 1 && last !== undefined && /\p{M}/u.test(last)) || (i > 0 && /^\p{M}/u.test(part.normalize("NFD")))) {
|
|
151
|
+
return { untranslatable: `a marked character stands beside a wildcard in ${JSON.stringify(source)} (the marks the wildcard meets can reorder into it)` };
|
|
152
|
+
}
|
|
153
|
+
const lit = literalExpression(part, foldAscii);
|
|
154
|
+
if (typeof lit !== "string")
|
|
155
|
+
return lit;
|
|
156
|
+
parts.push(lit);
|
|
157
|
+
}
|
|
158
|
+
const trailing = /[*. ]$/.test(source) ? "" : "[. ]*";
|
|
159
|
+
return `${SEGMENT_SEP}${parts.join("[^/\\\\]*")}${trailing}`;
|
|
160
|
+
}
|
|
161
|
+
function segmentRowExpressions(pat) {
|
|
162
|
+
if (pat.fold === "unicode")
|
|
163
|
+
return { untranslatable: "its case fold is not the deny table's" };
|
|
164
|
+
const fold = pat.fold === "ascii";
|
|
165
|
+
const run = [];
|
|
166
|
+
for (const seg of pat.segments) {
|
|
167
|
+
const e = segmentExpression(seg.source, fold);
|
|
168
|
+
if (typeof e !== "string")
|
|
169
|
+
return e;
|
|
170
|
+
run.push(e);
|
|
171
|
+
}
|
|
172
|
+
if (pat.anchors !== undefined) {
|
|
173
|
+
const reads = [];
|
|
174
|
+
const holds = [];
|
|
175
|
+
for (const anchor of pat.anchors) {
|
|
176
|
+
const at = [];
|
|
177
|
+
for (const seg of anchor) {
|
|
178
|
+
const e = literalExpression(seg, fold);
|
|
179
|
+
if (typeof e !== "string")
|
|
180
|
+
return e;
|
|
181
|
+
at.push(`${SEGMENT_SEP}${e}${/[. ]$/.test(seg) ? "" : "[. ]*"}`);
|
|
182
|
+
}
|
|
183
|
+
const whole = `^${at.join("")}${run.join("")}(${SEGMENT_SEP}.*)?$`;
|
|
184
|
+
reads.push(whole);
|
|
185
|
+
holds.push(whole);
|
|
186
|
+
const located = [...at, ...run];
|
|
187
|
+
for (let k = 1; k < located.length; k++)
|
|
188
|
+
holds.push(`^${located.slice(0, k).join("")}$`);
|
|
189
|
+
}
|
|
190
|
+
return { reads, holds };
|
|
191
|
+
}
|
|
192
|
+
const whole = `^(/.*)?${run.join("")}(${SEGMENT_SEP}.*)?$`;
|
|
193
|
+
const holds = [whole];
|
|
194
|
+
for (let k = 1; k < run.length; k++)
|
|
195
|
+
holds.push(`^(/.*)?${run.slice(0, k).join("")}$`);
|
|
196
|
+
return { reads: [whole], holds };
|
|
197
|
+
}
|
|
198
|
+
function ruleRowExpressions(rule) {
|
|
199
|
+
const shape = rule.reachShape;
|
|
200
|
+
if (shape === undefined)
|
|
201
|
+
return { untranslatable: "the row's reach has no shape a profile can spell (a hand-built row, or one whose base is missing)" };
|
|
202
|
+
const at = [];
|
|
203
|
+
for (const seg of shape.at.split("/").filter(Boolean)) {
|
|
204
|
+
const e = literalExpression(seg, false, true);
|
|
205
|
+
if (typeof e !== "string")
|
|
206
|
+
return e;
|
|
207
|
+
at.push(`/${e}`);
|
|
208
|
+
}
|
|
209
|
+
const globs = [];
|
|
210
|
+
for (const glob of shape.globs) {
|
|
211
|
+
if (glob === "**") {
|
|
212
|
+
globs.push("(/[^/]+)*");
|
|
213
|
+
continue;
|
|
214
|
+
}
|
|
215
|
+
const parts = [];
|
|
216
|
+
for (const part of glob.split("*")) {
|
|
217
|
+
const lit = literalExpression(part, false, true);
|
|
218
|
+
if (typeof lit !== "string")
|
|
219
|
+
return lit;
|
|
220
|
+
parts.push(lit);
|
|
221
|
+
}
|
|
222
|
+
globs.push(`/${parts.join("[^/]*")}`);
|
|
223
|
+
}
|
|
224
|
+
const whole = `^${at.join("")}${globs.join("")}(/.*)?$`;
|
|
225
|
+
const holds = [whole];
|
|
226
|
+
for (let k = 1; k <= at.length; k++)
|
|
227
|
+
holds.push(`^${at.slice(0, k).join("")}$`);
|
|
228
|
+
return { reads: [whole], holds };
|
|
229
|
+
}
|
|
230
|
+
export function screenReadDenyFloorRequired(value, seat) {
|
|
231
|
+
if (value === undefined || typeof value === "boolean")
|
|
232
|
+
return value;
|
|
233
|
+
const e = new Error(`${seat} must be a boolean or absent (got ${value === null ? "null" : typeof value}) — a requirement that cannot be read is no requirement, so it refuses loudly instead of reading as one side.`);
|
|
234
|
+
e.code = "config.read_face_seat";
|
|
235
|
+
throw e;
|
|
236
|
+
}
|
|
237
|
+
export const READ_DENY_FLOOR_UNKEPT = "config.read_deny_floor_unkept";
|
|
238
|
+
export function judgeReadFloorKept(j) {
|
|
239
|
+
const rowCount = j.table === undefined ? 0 : readDenySeat(j.table).denyEntries.length;
|
|
240
|
+
if (rowCount === 0)
|
|
241
|
+
return;
|
|
242
|
+
if (j.floor === undefined || j.floor.rows.length !== rowCount) {
|
|
243
|
+
throw new Error(`the read-deny table holds ${rowCount} row(s) but the floor its engine starts would carry holds ${j.floor?.rows.length ?? 0} — refused rather than start commands with fewer rows than the table refuses (an engine defect).`);
|
|
244
|
+
}
|
|
245
|
+
if (keepsReadFloor(j.env))
|
|
246
|
+
return;
|
|
247
|
+
if (j.required) {
|
|
248
|
+
const e = new Error(`The run's read-deny table holds ${rowCount} row(s), and the execution environment does not declare that it keeps the byte floor (capabilities.keepsReadFloor is not true), while the deployment requires the floor (readDenyFloorRequired) — refused before any command starts. Run it on an environment that keeps the floor, or unset the requirement.`);
|
|
249
|
+
e.code = READ_DENY_FLOOR_UNKEPT;
|
|
250
|
+
throw e;
|
|
251
|
+
}
|
|
252
|
+
if (j.said !== undefined) {
|
|
253
|
+
if (j.said.done)
|
|
254
|
+
return;
|
|
255
|
+
j.said.done = true;
|
|
256
|
+
}
|
|
257
|
+
deliverEngineNotice(j.onNotice, {
|
|
258
|
+
code: READ_DENY_FLOOR_UNKEPT,
|
|
259
|
+
message: `The run's read-deny table holds ${rowCount} row(s), and the execution environment does not declare that it keeps the byte floor (capabilities.keepsReadFloor is not true): the engine refuses what a command names, but a recursive read under a root reads the files below it on this environment, deny rows included, and their bytes reach the conversation. To refuse such runs instead, set readDenyFloorRequired.`,
|
|
260
|
+
detail: { rowCount, ...(j.attribution?.sessionId !== undefined ? { sessionId: j.attribution.sessionId } : {}), ...(j.attribution?.runId !== undefined ? { runId: j.attribution.runId } : {}) },
|
|
261
|
+
});
|
|
23
262
|
}
|
|
@@ -7,7 +7,7 @@ import type { ToolCallRequest } from "../../core/tool-policy.js";
|
|
|
7
7
|
export declare const SHELL_REMOVAL_COMMANDS: readonly ["rm", "rmdir"];
|
|
8
8
|
export type ShellRemovalCommand = (typeof SHELL_REMOVAL_COMMANDS)[number];
|
|
9
9
|
/** What makes a removal target dangerous, in the order a card names it. */
|
|
10
|
-
export type DangerousRemovalKind = "filesystem_root" | "home" | "workspace" | "top_level";
|
|
10
|
+
export type DangerousRemovalKind = "filesystem_root" | "home" | "workspace" | "top_level" | "mounted_drive";
|
|
11
11
|
/** The protected locations a removal is judged against. `homes`: the environment's declared home and every other spelling
|
|
12
12
|
* of it (its canonical one); `workspace`: the task root, the working directory, the additional working directories. */
|
|
13
13
|
export interface RemovalSeat {
|
|
@@ -26,9 +26,14 @@ export interface DangerousRemoval {
|
|
|
26
26
|
* implementation's set — the filesystem root (a drive root, a UNC share root), a home directory
|
|
27
27
|
* (every spelling the seat holds), a workspace directory or any of its ANCESTORS (the task root, the working directory, an
|
|
28
28
|
* additional working directory — whether the home lies inside the task root or the task root inside the home), a top-level
|
|
29
|
-
* directory (one segment below the root)
|
|
29
|
+
* directory (one segment below the root) — and, for an `rm` that walks what it removes (`rm`: present; `recursive`: it
|
|
30
|
+
* selects a recursive option; or the path names every entry of a directory), a mounted drive ({@link MOUNTED_DRIVE_KEY}):
|
|
31
|
+
* the folder that holds drives, a drive, or an entry at a drive's top level. `undefined` for a relative path or any other
|
|
32
|
+
* target.
|
|
30
33
|
*/
|
|
31
|
-
export declare function dangerousRemovalOf(path: string, seat: RemovalSeat
|
|
34
|
+
export declare function dangerousRemovalOf(path: string, seat: RemovalSeat, rm?: {
|
|
35
|
+
readonly recursive: boolean;
|
|
36
|
+
}): DangerousRemovalKind | undefined;
|
|
32
37
|
/** What one removal finding asks: a protected location (`dangerous_delete`; `untrackedFrom` — the segment the working
|
|
33
38
|
* directory stops being tracked at, where the target is relative and was judged where the text stood then); a recursive
|
|
34
39
|
* forced removal whose target the
|
|
@@ -68,7 +73,7 @@ export declare const KNOWN_SAFE_ROOTS: readonly string[];
|
|
|
68
73
|
* OPERANDS (every write target that is not one of its option words: a word some implementation's reading of the
|
|
69
74
|
* program's row writes, {@link writeReadings}) as the plan established it on the WRITE face (the entry the program
|
|
70
75
|
* unlinks, and the deny-floor shadow of a home word the plan did not place) is judged by {@link dangerousRemovalOf},
|
|
71
|
-
* save one the program refuses by its own first step ({@link refusedByRemoval}: `.`, `..`). In a recursive forced removal ({@link
|
|
76
|
+
* save one the program refuses by its own first step ({@link refusedByRemoval}: `.`, `..`). In a recursive forced removal ({@link selectsOptions}), an operand
|
|
72
77
|
* the shell rewrites from a value the plan's table does not settle — a name with no value here or one set in a form the
|
|
73
78
|
* table cannot read, a substitution, a parameter operator, a positional parameter — is an unverifiable target, save a
|
|
74
79
|
* literal path below a known-safe root the shell still provides there ({@link belowKnownSafeRoot}); so are the operands
|
|
@@ -24,11 +24,14 @@ function removalKey(path) {
|
|
|
24
24
|
function driveOf(path, key) {
|
|
25
25
|
return isWinFormPath(path) && key.length >= 2 && key[1] === ":" ? key.slice(0, 2) : "";
|
|
26
26
|
}
|
|
27
|
-
|
|
27
|
+
const MOUNTED_DRIVE_KEY = /^\/(?:system\/)?volumes(?:\/[^/]+){0,2}$|^\/mnt\/(?:[^/]+|[a-z]\/[^/]+)$|^\/(?:run\/)?media(?:\/[^/]+){0,3}$/;
|
|
28
|
+
const NAMES_EVERY_ENTRY = /(?:[\\/]+\*+)+[\\/]*$/;
|
|
29
|
+
export function dangerousRemovalOf(path, seat, rm) {
|
|
28
30
|
if (!isAbsoluteForFamily("own", path))
|
|
29
31
|
return undefined;
|
|
30
32
|
const k = removalKey(path);
|
|
31
|
-
const
|
|
33
|
+
const drive = driveOf(path, k);
|
|
34
|
+
const rest = k.slice(drive.length);
|
|
32
35
|
if (rest === "/" || /^\/\/[^/]+\/[^/]+$/.test(k))
|
|
33
36
|
return "filesystem_root";
|
|
34
37
|
if (seat.homes.some((h) => isAbsoluteForFamily("own", h) && removalKey(h) === k))
|
|
@@ -38,6 +41,8 @@ export function dangerousRemovalOf(path, seat) {
|
|
|
38
41
|
return "workspace";
|
|
39
42
|
if (/^\/[^/]+$/.test(rest))
|
|
40
43
|
return "top_level";
|
|
44
|
+
if (rm !== undefined && (rm.recursive || NAMES_EVERY_ENTRY.test(path)) && drive === "" && !k.startsWith("//") && MOUNTED_DRIVE_KEY.test(rest))
|
|
45
|
+
return "mounted_drive";
|
|
41
46
|
return undefined;
|
|
42
47
|
}
|
|
43
48
|
function tildeNamesAHome(spelled) {
|
|
@@ -47,10 +52,10 @@ function tildeNamesAHome(spelled) {
|
|
|
47
52
|
const key = removalKey(`/~home${m[2] ?? ""}`);
|
|
48
53
|
return key === "/~home" || !key.startsWith("/~home/");
|
|
49
54
|
}
|
|
50
|
-
function removalKindOf(read, seat) {
|
|
55
|
+
function removalKindOf(read, seat, rm) {
|
|
51
56
|
const floors = read.established === "unestablishable" && read.candidate.bases === "unmodelled" ? read.spellings : [];
|
|
52
57
|
for (const view of [read.target, read.origin, ...floors]) {
|
|
53
|
-
const kind = view === undefined ? undefined : dangerousRemovalOf(view, seat);
|
|
58
|
+
const kind = view === undefined ? undefined : dangerousRemovalOf(view, seat, rm);
|
|
54
59
|
if (kind !== undefined)
|
|
55
60
|
return kind;
|
|
56
61
|
}
|
|
@@ -76,11 +81,12 @@ function optionsReceived(row, args) {
|
|
|
76
81
|
const shellChooses = chosenAt >= 0 && writeReadings(row, present.slice(0, chosenAt + 1).map((w) => w.spelled)).some((r) => r.written.length === 0);
|
|
77
82
|
return { refused: rowRefusesArgv(row, asWritten), shellChooses };
|
|
78
83
|
}
|
|
79
|
-
|
|
84
|
+
const TRAVERSAL = (o) => o.selects === "traversal";
|
|
85
|
+
const FORCED = (o) => o.mode === "forced";
|
|
86
|
+
function selectsOptions(row, args, shellChooses, ...wanted) {
|
|
80
87
|
return implementationsOf(row).some((view) => {
|
|
81
88
|
const selected = selectedOptions(view, args, "one-implementation");
|
|
82
|
-
|
|
83
|
-
return selects((o) => o.selects === "traversal") && selects((o) => o.mode === "forced");
|
|
89
|
+
return wanted.every((has) => selected.some(has) || (shellChooses && declaresOption(view, has)));
|
|
84
90
|
});
|
|
85
91
|
}
|
|
86
92
|
export function removalFindingsOf(established, seat, safeRoots = KNOWN_SAFE_ROOTS, enclosingRelocated = false) {
|
|
@@ -98,7 +104,8 @@ export function removalFindingsOf(established, seat, safeRoots = KNOWN_SAFE_ROOT
|
|
|
98
104
|
const { row, named } = removal;
|
|
99
105
|
const removed = new Set(writeReadings(row, spelled).flatMap((r) => r.written.map((w) => w.at)));
|
|
100
106
|
const options = new Set(args.filter((_, at) => !removed.has(at)).map((w) => w.raw));
|
|
101
|
-
const forced =
|
|
107
|
+
const forced = selectsOptions(row, spelled, received.shellChooses, TRAVERSAL, FORCED);
|
|
108
|
+
const rm = removal.program === "rm" || !named ? { recursive: selectsOptions(row, spelled, received.shellChooses, TRAVERSAL) } : undefined;
|
|
102
109
|
if (forced && segment.reentry === "argv")
|
|
103
110
|
out.push({ guard: "unverifiable_delete", program: removal.program, operand: segment.text.trim(), source: "stream" });
|
|
104
111
|
const relocated = enclosingRelocated || readProgramPosition(segment.argv).launcherMovesBase;
|
|
@@ -107,7 +114,7 @@ export function removalFindingsOf(established, seat, safeRoots = KNOWN_SAFE_ROOT
|
|
|
107
114
|
continue;
|
|
108
115
|
if (refusedByRemoval(read))
|
|
109
116
|
continue;
|
|
110
|
-
const kind = removalKindOf(read, seat);
|
|
117
|
+
const kind = removalKindOf(read, seat, rm);
|
|
111
118
|
if (kind !== undefined) {
|
|
112
119
|
const untracked = read.candidate.bases === "unmodelled" ? established.plan.segments.find((s) => s.bases === "unmodelled")?.text.trim() : undefined;
|
|
113
120
|
out.push({ guard: "dangerous_delete", kind, program: removal.program, operand: read.candidate.raw, target: read.target ?? read.candidate.floorSpelled ?? read.candidate.spelled, ...(untracked !== undefined ? { untrackedFrom: untracked } : {}) });
|
|
@@ -191,6 +198,7 @@ const DANGEROUS_REMOVAL_SENTENCE = {
|
|
|
191
198
|
home: (p, t) => `\`${p}\` would remove a home directory (${t})`,
|
|
192
199
|
workspace: (p, t) => `\`${p}\` would remove a workspace directory — the task root, the working directory or an additional working directory — or one of its ancestors (${t})`,
|
|
193
200
|
top_level: (p, t) => `\`${p}\` would remove a top-level system directory (${t})`,
|
|
201
|
+
mounted_drive: (p, t) => `\`${p}\` would remove a mounted drive, the folder that holds mounted drives, or a file or folder at the top level of a drive (${t}) — if you meant something deeper inside, name it by its full path`,
|
|
194
202
|
};
|
|
195
203
|
const UNVERIFIABLE_REMOVAL_SENTENCE = {
|
|
196
204
|
rewritten: (p, o) => `\`${p}\` recursive+force target ${o} is rewritten by the shell from a value this command does not settle (a name with no value here or one it sets in a form the guard cannot read, a substitution, a parameter operator) — the deleted path cannot be verified from this command`,
|
|
@@ -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
|
import { type HomeViewsCarrier } from "./read-deny-home.js";
|
|
3
3
|
import { type FsGlob } from "./fs-glob.js";
|
|
4
4
|
/** The JS scanner's own output ceiling, in bytes of emitted content rows. Pinned to the
|
|
@@ -211,8 +211,9 @@ export declare function jsGrepDetailed(env: ExecutionEnv, root: string, p: GrepP
|
|
|
211
211
|
export declare function jsGrep(env: ExecutionEnv, root: string, p: GrepParams, signal?: AbortSignal, guards?: JsGrepGuards, deny?: ReadDenyJudge, denyOut?: {
|
|
212
212
|
withheld?: ReadDenyWithheld;
|
|
213
213
|
}): Promise<string>;
|
|
214
|
-
/** Detect ripgrep once per env (cached).
|
|
215
|
-
|
|
214
|
+
/** Detect ripgrep once per env (cached). The detection is a start of the call that asks first and carries that call's floor
|
|
215
|
+
* (`readFloor`; absent ⇒ none, a caller with no run's table). */
|
|
216
|
+
export declare function detectRipgrep(env: ExecutionEnv, readFloor?: ReadFloor): Promise<boolean>;
|
|
216
217
|
/** How a grep result was produced when the ripgrep leg could not complete normally. Either the
|
|
217
218
|
* delivered text IS ripgrep's own partial output (`partial: true`), or ripgrep produced nothing
|
|
218
219
|
* usable and the results came from the JS fallback scanner (`fallback: "js-scan"`). Absent on a
|
|
@@ -312,10 +313,10 @@ export declare function rgOutputDenyTripwire(stdout: string, mode: GrepOutputMod
|
|
|
312
313
|
* re-scan — partial results ship with a caveat; only a zero-output failure degrades to
|
|
313
314
|
* {@link jsGrep}, and that degradation is declared in both text and structure. An external abort
|
|
314
315
|
* propagates as the interruption it is (no fallback rerun). */
|
|
315
|
-
export declare function rgGrepDetailed(env: ExecutionEnv, root: string, p: GrepParams, signal?: AbortSignal, deny?: ReadDenyJudge): Promise<GrepRunResult>;
|
|
316
|
+
export declare function rgGrepDetailed(env: ExecutionEnv, root: string, p: GrepParams, signal?: AbortSignal, deny?: ReadDenyJudge, readFloor?: ReadFloor): Promise<GrepRunResult>;
|
|
316
317
|
/** grep dispatch: ripgrep when the env has it, else the hardened JS fallback.
|
|
317
318
|
* Returns the degradation facts alongside the text so the tool layer can surface them structurally. */
|
|
318
|
-
export declare function runGrepDetailed(env: ExecutionEnv, root: string, p: GrepParams, signal?: AbortSignal, deny?: ReadDenyJudge): Promise<GrepRunResult>;
|
|
319
|
+
export declare function runGrepDetailed(env: ExecutionEnv, root: string, p: GrepParams, signal?: AbortSignal, deny?: ReadDenyJudge, readFloor?: ReadFloor): Promise<GrepRunResult>;
|
|
319
320
|
/** Text-only wrapper of {@link runGrepDetailed}. */
|
|
320
321
|
export declare function runGrep(env: ExecutionEnv, root: string, p: GrepParams, signal?: AbortSignal): Promise<string>;
|
|
321
322
|
/** glob: find files by name pattern, with optional sub-path scoping; returns RELATIVE paths. */
|