@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,5 +1,5 @@
|
|
|
1
1
|
import { randomBytes } from "node:crypto";
|
|
2
|
-
import { COMMAND_RULE_TOOL, cardRuleFormOf, escapeForDisclosure, foldSpacing, hasUnrenderableCharacters, parseRuleText, ruleAdmitsCommand, ruleBreadthWarningsOf, segmentCoverageOf, suggestRuleForHost, suggestRuleForName, suggestRuleForTool, suggestRulesForCommand, EDITED_RULE_BREADTH_WARNING_CODES, RULE_OFFER_KINDS, UNCOVERED_SEGMENT_REASONS, RULE_BEHAVIORS, RULE_BEHAVIOR_PRECEDENCE, isRuleBehavior, } from "./permission-rule-model.js";
|
|
2
|
+
import { COMMAND_RULE_TOOL, cardRuleFormOf, escapeForDisclosure, foldSpacing, hasUnrenderableCharacters, parseRuleText, ruleAdmitsCommand, ruleBasesNeeded, ruleBreadthWarningsOf, segmentCoverageOf, suggestRuleForHost, suggestRuleForName, suggestRuleForTool, suggestRulesForCommand, EDITED_RULE_BREADTH_WARNING_CODES, RULE_OFFER_KINDS, UNCOVERED_SEGMENT_REASONS, RULE_BEHAVIORS, RULE_BEHAVIOR_PRECEDENCE, isRuleBehavior, } from "./permission-rule-model.js";
|
|
3
3
|
import { readRuleOwner, sameRuleOwner } from "./rule-owner.js";
|
|
4
4
|
import { principalNameOf, readPrincipal } from "./principal-name.js";
|
|
5
5
|
import { isPlainRecord } from "./mods/kernel/receive.js";
|
|
@@ -690,6 +690,8 @@ export async function redeemRuleTicket(opts) {
|
|
|
690
690
|
const parsedRule = parseRuleText(candidate.rule, candidate.behavior);
|
|
691
691
|
if ("reject" in parsedRule)
|
|
692
692
|
return { status: "refused", reason: `${parsedRule.reject.code}: ${parsedRule.reject.message}` };
|
|
693
|
+
if (rec.kind === "import" && !importCarries(candidate.scope, parsedRule.rule))
|
|
694
|
+
return { status: "refused", reason: LAYER_ROOT_RECORD_REASON };
|
|
693
695
|
let store;
|
|
694
696
|
try {
|
|
695
697
|
store = storeForOwner(opts.deps.provider, caller);
|
|
@@ -784,11 +786,24 @@ function originOfRecordKind(kind) {
|
|
|
784
786
|
}
|
|
785
787
|
export const IMPORTED_SETTINGS_LAYERS = Object.freeze(["userSettings", "projectSettings", "localSettings"]);
|
|
786
788
|
const IMPORT_UNCOVERED_LAYERS = { flagSettings: "not-imported-v1", policySettings: "not-imported-v1" };
|
|
789
|
+
function importCarries(scope, rule) {
|
|
790
|
+
return !(scope.kind === "global" && ruleBasesNeeded(rule).includes("root"));
|
|
791
|
+
}
|
|
792
|
+
const LAYER_ROOT_SKIP_REASON = "unsupported.layer_root: a path pattern written from `/` in the user settings layer reads at that layer's own directory (the configuration directory), and a stored global rule reads `/` at the project root of each task — the stored copy would guard or open another directory, so it stays in the settings file, unimported; to carry it, spell the directory out (`//<directory>/…`, or `~/<path>` under the home) — a directory whose name holds `*`, `?`, `[`, `]`, `{` or `}` has no literal spelling in the path grammar and cannot be written this way";
|
|
793
|
+
const LAYER_ROOT_RECORD_REASON = "unsupported.layer_root: this import record carries a global rule written from `/` — the user settings layer reads it at its own directory (the configuration directory), a stored global rule reads it at the project root of each task, so it does not land; prepare the import again and the entry is disclosed in skipped, left in the settings file";
|
|
787
794
|
export async function prepareCcImport(opts) {
|
|
788
795
|
const owner = resolveCallerOwner(opts.principal, opts.owner, "prepareCcImport");
|
|
796
|
+
opts.layers.forEach((layer, i) => {
|
|
797
|
+
if (layer.layer === "userSettings" && layer.root !== undefined) {
|
|
798
|
+
const field = `layers[${i}].root`;
|
|
799
|
+
const e = new Error(`prepareCcImport got a root on the user settings layer (${field}) — the user layer has no root: its rules import as global rules, which read \`/\` at each task's project root, and nothing reads that layer's own directory; drop the member (a project or local layer keeps its root)`);
|
|
800
|
+
e.code = "config.invalid_argument";
|
|
801
|
+
e.detail = { field };
|
|
802
|
+
throw e;
|
|
803
|
+
}
|
|
804
|
+
});
|
|
789
805
|
const candidates = [];
|
|
790
806
|
const skipped = [];
|
|
791
|
-
const translated = [];
|
|
792
807
|
const layers = [];
|
|
793
808
|
for (const layer of opts.layers) {
|
|
794
809
|
let raw;
|
|
@@ -861,13 +876,17 @@ export async function prepareCcImport(opts) {
|
|
|
861
876
|
skipped.push({ rule: entry, reason: "unsupported.form: a bare tool-name entry is a name-set item the host carries from the settings layer's own lists — it stays in the settings file, unimported" });
|
|
862
877
|
continue;
|
|
863
878
|
}
|
|
879
|
+
if (!importCarries(scope, parsed.rule)) {
|
|
880
|
+
skipped.push({ rule: entry, reason: LAYER_ROOT_SKIP_REASON });
|
|
881
|
+
continue;
|
|
882
|
+
}
|
|
864
883
|
if (candidates.some((c) => c.behavior === behavior && c.rule === parsed.rule.rule && sameScope(c.scope, scope)))
|
|
865
884
|
continue;
|
|
866
885
|
candidates.push({ behavior, rule: parsed.rule.rule, scope });
|
|
867
886
|
}
|
|
868
887
|
}
|
|
869
888
|
}
|
|
870
|
-
const preview = { candidates, skipped,
|
|
889
|
+
const preview = { candidates, skipped, layers, uncovered: { ...IMPORT_UNCOVERED_LAYERS } };
|
|
871
890
|
if (candidates.length === 0)
|
|
872
891
|
return { preview };
|
|
873
892
|
const record = {
|
|
@@ -132,7 +132,7 @@ export declare function readRowBehavior(v: unknown): RuleBehavior | undefined;
|
|
|
132
132
|
export type PersistedRuleTool = string;
|
|
133
133
|
/** The command grammar's ONE rule word — the spelling a shell command rule is written in (`Bash(<command>)`, upstream's).
|
|
134
134
|
* A rule word, not a tool list: the calls a command rule reaches are the SHELL FACE's — every catalog definition whose
|
|
135
|
-
* `command` the command grammar judges ({@link
|
|
135
|
+
* `command` the command grammar judges ({@link ruleWordsOf}). */
|
|
136
136
|
export declare const COMMAND_RULE_TOOL = "Bash";
|
|
137
137
|
/** The read face's rule word: a `Read(<path>)` rule speaks for every call that reads a path ({@link PATH_RULE_FACES}). */
|
|
138
138
|
export declare const READ_RULE_TOOL = "Read";
|
|
@@ -276,7 +276,7 @@ export declare const DOMAIN_RULE_MARKER = "domain:";
|
|
|
276
276
|
* rule policy's compiler through {@link ruleLaneOf}, the entry lists, the approval card), and a property of the rule's tool NAME
|
|
277
277
|
* as the catalog declares it, never of the tool a leg mounts under that name. The model's tool set is DERIVED, never a hand-kept
|
|
278
278
|
* list: the command rule word ({@link COMMAND_RULE_TOOL}) takes the COMMAND grammar — the other shell-face tools take none of
|
|
279
|
-
* their own, their command is judged by the `Bash(…)` rules ({@link
|
|
279
|
+
* their own, their command is judged by the `Bash(…)` rules ({@link ruleWordsOf}); the tools of {@link NAME_RULE_FACES} the
|
|
280
280
|
* NAME grammar (each in its row's spelling: bare `Skill(<name>)`, keyed `Artifact(action:<word>)`); every name the catalog
|
|
281
281
|
* declares a host target for (`hostTargetOf`: WebFetch) the DOMAIN grammar; every name it declares a path target for
|
|
282
282
|
* (`pathTargetOf`: Read / Edit / Write / Glob / NotebookEdit / …) the PATH grammar. A rule on any other tool has no content
|
|
@@ -288,7 +288,7 @@ export declare function ruleToolGrammarOf(toolName: string): RuleGrammar | undef
|
|
|
288
288
|
/**
|
|
289
289
|
* THE rule a tool's approval card mints a "don't ask again" option in — one answer, read by the offer factory and the consent door
|
|
290
290
|
* alike: `command` for the command rule word (the shell card's command rules), `name` / `domain` for a tool of those grammars (the one
|
|
291
|
-
* exact value rule), `tool` for a call no rule word speaks for under any name it answers to ({@link
|
|
291
|
+
* exact value rule), `tool` for a call no rule word speaks for under any name it answers to ({@link ruleWordsOf} of a tightening empty: the
|
|
292
292
|
* whole-tool rule, the reference's fallback card), and `undefined` for the rest — a path tool (no path offer is minted), a shell-face
|
|
293
293
|
* sibling of the command word (its commands are `Bash(…)` rules), and a tool that answers to one of those under an alias it declares
|
|
294
294
|
* (a caller's shell wearing `Bash`: a one-click whole-tool yes on it would be a licence for every program): its card names that it has
|
|
@@ -318,13 +318,15 @@ export declare function ruleLaneOf(tool: string, content: string): RuleLane;
|
|
|
318
318
|
* `Skill` call is resolved by — or undefined (not a name-grammar tool; no such argument; not a string; the empty string, which
|
|
319
319
|
* names no value: an empty and an omitted argument are one call to every reader, as they are to the tool that runs it). */
|
|
320
320
|
export declare function nameRuleSubjectOf(toolName: string, args: unknown): string | undefined;
|
|
321
|
-
/** The rule WORDS a
|
|
322
|
-
* name
|
|
323
|
-
*
|
|
324
|
-
*
|
|
325
|
-
* name
|
|
326
|
-
*
|
|
327
|
-
|
|
321
|
+
/** The rule WORDS a rule of `behavior` reaches the call under, once each — the word a name's rules are written in: a shell-face
|
|
322
|
+
* name's is the command grammar's {@link COMMAND_RULE_TOOL} (a `Bash(<command>)` rule reaches `Monitor` as it reaches `Bash`), a
|
|
323
|
+
* path, name or domain tool's its own name. A deny or ask reads every name the call answers to (the model's spelling, the wire
|
|
324
|
+
* name, the other aliases that resolve to it), so a stored `Bash(rm:*)` row reaches a tool that answers to `Bash` under another
|
|
325
|
+
* wire name; an allow reads the call's wire name alone — a grant written in a tool's grammar is a grant for the tool whose
|
|
326
|
+
* grammar it is, so a `Bash(npm test:*)` allow does not reach a caller's tool that only wears `Bash`. Every lane that judges a
|
|
327
|
+
* call by a rule's content reads it here: the policy compiler, the person's stored rows, the org partition, the allow lists.
|
|
328
|
+
* Empty ⇒ no grammar speaks for the call in that direction. A rule with no content is read by {@link wholeToolRuleReaches}. */
|
|
329
|
+
export declare function ruleWordsOf(req: NamedCall, behavior: RuleBehavior): readonly string[];
|
|
328
330
|
/** The match words a persisted rule is stored with, spelled once: {@link PersistedRuleMatch} is derived from this
|
|
329
331
|
* tuple (each form is documented there). A store backend that checks a stored row's `match` reads this value
|
|
330
332
|
* rather than keeping its own list. */
|
|
@@ -832,6 +834,14 @@ export declare function ruleBasesNeeded(rule: Pick<PersistedRule, "match" | "com
|
|
|
832
834
|
/** Is this base usable by {@link resolvePathPattern} — an absolute path with a lexical normal form? A rule
|
|
833
835
|
* compiler asks this at compile time so a pattern is refused rather than compiled inert. */
|
|
834
836
|
export declare function isUsablePathBase(base: string | undefined, family: PathFamily | undefined): boolean;
|
|
837
|
+
/** The base a rule SET declares for this rule's pattern that cannot be read ({@link isUsablePathBase}): the base word the
|
|
838
|
+
* pattern needs and the declared key that holds the bad value (`cwd`'s stand-in is the declared `root`) — the one judgment of
|
|
839
|
+
* declared anchors, a policy's and an allow list member's alike. `undefined` when every base the rule needs that the set
|
|
840
|
+
* declares is usable (a base the set leaves out is the leg's, judged there). */
|
|
841
|
+
export declare function unusableDeclaredBase(rule: Pick<PersistedRule, "match" | "command">, declared: PathRuleBases): {
|
|
842
|
+
readonly base: PathRuleBase;
|
|
843
|
+
readonly key: PathRuleBase;
|
|
844
|
+
} | undefined;
|
|
835
845
|
/**
|
|
836
846
|
* The PATH family's tightening reach — three-valued like the command family's ({@link programRunReachOf}):
|
|
837
847
|
* does this deny/ask rule reach the call's target path? The target is the caller's ALREADY-RESOLVED
|
|
@@ -849,9 +859,22 @@ export declare function isUsablePathBase(base: string | undefined, family: PathF
|
|
|
849
859
|
* no root reached nothing at all).
|
|
850
860
|
*/
|
|
851
861
|
export declare function pathRuleReachOf(rule: Pick<PersistedRule, "match" | "command" | "behavior">, target: PathIdentity, bases: PathRuleBases, treeFamily?: PathFamily | undefined): ProgramRunReachOutcome;
|
|
862
|
+
/**
|
|
863
|
+
* A path rule's reach as a SHAPE (the deny table's `reachShape`, what an OS confinement translates): the location the
|
|
864
|
+
* resolved pattern starts at — its base and then its body's segments up to the first one carrying `*` (`/` when the
|
|
865
|
+
* first does; the base's segments are letters), or a directory rule's directory — and the glob segments after it. {@link pathRuleReachOf} is this shape's judgment (the
|
|
866
|
+
* target's segments below `at` match the globs as a prefix), read off the same resolution. `undefined` where the reach is
|
|
867
|
+
* no shape: the pattern needs a base the call does not supply (the rule reads `unreadable` everywhere), a directory rule
|
|
868
|
+
* admits nothing, a UNC pattern, or any other match form.
|
|
869
|
+
*/
|
|
870
|
+
export declare function pathRuleReachShapeOf(rule: Pick<PersistedRule, "match" | "command" | "behavior">, bases: PathRuleBases): {
|
|
871
|
+
readonly at: string;
|
|
872
|
+
readonly globs: readonly string[];
|
|
873
|
+
} | undefined;
|
|
852
874
|
/**
|
|
853
875
|
* Where a path rule's reach STARTS under the call's bases — its HEAD: the location the resolved pattern names before
|
|
854
|
-
* its first segment carrying `*` (the whole path when none does), or a directory
|
|
876
|
+
* its body's first segment carrying `*` (the whole path when none does; the base's segments are letters), or a directory
|
|
877
|
+
* rule's directory. Everything the rule
|
|
855
878
|
* reaches lies at or below the head, so a spelling of the head that the environment resolves elsewhere (a link, a
|
|
856
879
|
* firmlink, `/var` → `/private/var`) is a second spelling of everything the rule reaches — the deny tables judge the
|
|
857
880
|
* rule at both ({@link import("../tools/fs/read-deny.js").withRuleRowsWhereTheyLead}; the reference's "physical twin"
|
|
@@ -1310,9 +1333,11 @@ export declare function adjudicatePersistedDomainRules(rules: readonly Persisted
|
|
|
1310
1333
|
* THE predicate of a whole-tool rule (`match: "tool"`) over one call: the rule reaches the call iff the call answers to the name it
|
|
1311
1334
|
* spells, under every name the call answers to (the model's spelling, the wire name, the aliases that resolve to it) — the
|
|
1312
1335
|
* reference's tool-wide matcher. Every reader of a rule with no content asks it: an entry list's whole-tool row and a person's stored
|
|
1313
|
-
* whole-tool row alike.
|
|
1336
|
+
* whole-tool row alike. A row of a list that RESTRICTS (`behavior` deny / ask) whose MCP name the lookup reads more than one way
|
|
1337
|
+
* ({@link peerReadingsOf}: `mcp__a__b` is tool `b` of server `a` and every tool of server `a__b`) reaches the call under any of its
|
|
1338
|
+
* readings; a granting row keeps the one name it spells — an ambiguous spelling never widens a grant.
|
|
1314
1339
|
*/
|
|
1315
|
-
export declare function wholeToolRuleReaches(tool: string, call: NamedCall): boolean;
|
|
1340
|
+
export declare function wholeToolRuleReaches(tool: string, call: NamedCall, behavior?: RuleBehavior): boolean;
|
|
1316
1341
|
/**
|
|
1317
1342
|
* The whole-tool sibling of {@link adjudicatePersistedRules}: the same precedence walk (deny > ask > allow) over the whole-tool rows
|
|
1318
1343
|
* (`match: "tool"`) that reach the call ({@link wholeToolRuleReaches}) and are eligible under their own tool ({@link eligiblePersisted},
|
|
@@ -3,14 +3,14 @@ import { shellWordsOf } from "../shell/shell-words.js";
|
|
|
3
3
|
import { lexShell } from "../shell/lex.js";
|
|
4
4
|
import { readProgramPosition } from "../tools/fs/bash-program-position.js";
|
|
5
5
|
import { isNameableToolName, parsePermissionRule, ruleSpellingOf } from "./permission-rule-syntax.js";
|
|
6
|
-
import {
|
|
7
|
-
import { toolNameFaultOf } from "./tool-name-aliases.js";
|
|
6
|
+
import { namesASetOfTools, ruleNameCovers } from "./namespaced-rule-name.js";
|
|
7
|
+
import { peerReadingsOf, readsNameGlob, toolNameFaultOf } from "./tool-name-aliases.js";
|
|
8
8
|
import { compileReadDeny } from "../tools/fs/read-deny.js";
|
|
9
9
|
import { carriesShellRedirection, parseLeadingCommandName, splitShellCompoundSegments } from "../tools/fs/bash-readonly-classifier.js";
|
|
10
10
|
import { INLINE_TRUNCATION_MARK, inlineUntrusted } from "./untrusted-text.js";
|
|
11
11
|
import { catalogRuleFaceOf, catalogToolNames, hostTargetOf, isShellFaceToolName, pathTargetOf, protectivePathTargetOf } from "./tool-registry.js";
|
|
12
12
|
import { HOST_UNREADABLE_SENTENCE, hostPatternAdmits, readHostPattern, spelledHostPattern } from "./host-target.js";
|
|
13
|
-
import { heldBy, heldValues } from "./tool-name-readings.js";
|
|
13
|
+
import { heldBy, heldValues, wireOf } from "./tool-name-readings.js";
|
|
14
14
|
import { carriesDotSegment, isAbsoluteForFamily, isIdentityDir, isPathIdentity, isShellRootedSpellingUnmapped, isUncIdentity, pathFamilyOf, pathIdentityOf } from "../tools/fs/safety.js";
|
|
15
15
|
import { bindPathRules, judgeRuleRows, rowsWhereTheyLead } from "./path-rule-binding.js";
|
|
16
16
|
import { readShellCommand } from "./shell-run-candidates.js";
|
|
@@ -143,7 +143,7 @@ export function cardRuleFormOf(toolName, call = { toolName }) {
|
|
|
143
143
|
const grammar = ruleToolGrammarOf(toolName);
|
|
144
144
|
if (grammar === "name" || grammar === "domain")
|
|
145
145
|
return grammar;
|
|
146
|
-
return grammar === undefined &&
|
|
146
|
+
return grammar === undefined && ruleWordsOf(call, "deny").length === 0 && ruleWordsOf({ toolName }, "deny").length === 0 ? "tool" : undefined;
|
|
147
147
|
}
|
|
148
148
|
export function shellRuleParamOf(tool, content) {
|
|
149
149
|
const colon = content.indexOf(":");
|
|
@@ -173,7 +173,11 @@ export function nameRuleSubjectOf(toolName, args) {
|
|
|
173
173
|
const value = args[face.param];
|
|
174
174
|
return typeof value === "string" && value !== "" ? value : undefined;
|
|
175
175
|
}
|
|
176
|
-
export function
|
|
176
|
+
export function ruleWordsOf(req, behavior) {
|
|
177
|
+
if (behavior === "allow") {
|
|
178
|
+
const word = ruleWordOf(wireOf("policy.persistedGrammar.grant", req));
|
|
179
|
+
return word === undefined ? [] : [word];
|
|
180
|
+
}
|
|
177
181
|
const words = heldValues("policy.persistedGrammar", { get: ruleWordOf }, req);
|
|
178
182
|
return words.length <= 1 ? words : [...new Set(words)];
|
|
179
183
|
}
|
|
@@ -426,7 +430,7 @@ export function respelledRuleTextOf(text, behavior) {
|
|
|
426
430
|
return "rule" in read ? read.rule.rule : undefined;
|
|
427
431
|
}
|
|
428
432
|
function parseWholeToolRule(text, tool, behavior) {
|
|
429
|
-
if (!isNameableToolName(tool) ||
|
|
433
|
+
if (!isNameableToolName(tool) || namesASetOfTools(tool, behavior)) {
|
|
430
434
|
return reject("invalid.grammar", `"${text}" names a set of tools — a stored rule names one tool, or one tool's content; a set of tools is a list entry's form`);
|
|
431
435
|
}
|
|
432
436
|
const fault = toolNameFaultOf(tool, catalogToolNames(), behavior);
|
|
@@ -748,7 +752,7 @@ function resolvePathPattern(pattern, bases, behavior, treeFamily = pathFamilyOf(
|
|
|
748
752
|
const tree = bases.root ?? bases.cwd;
|
|
749
753
|
if (pattern.startsWith("//")) {
|
|
750
754
|
const abs = pathIdentityOf("/" + pattern.slice(2), family, tree);
|
|
751
|
-
return abs.ok ? { resolved: abs.identity } : { missingBase: "root" };
|
|
755
|
+
return abs.ok ? { resolved: abs.identity, literal: 0 } : { missingBase: "root" };
|
|
752
756
|
}
|
|
753
757
|
const needed = ruleBasesNeeded({ match: "path", command: pattern })[0];
|
|
754
758
|
const baseValue = baseValueOf(needed, bases);
|
|
@@ -761,11 +765,23 @@ function resolvePathPattern(pattern, bases, behavior, treeFamily = pathFamilyOf(
|
|
|
761
765
|
const bare = needed === "cwd" && peeled !== "" && !peeled.includes("/");
|
|
762
766
|
const anyDepth = bare && (peeled === rest || behavior !== "allow");
|
|
763
767
|
const body = anyDepth ? "**/" + peeled : rest;
|
|
764
|
-
return { resolved: (normal === "/" ? "" : normal) + "/" + body };
|
|
768
|
+
return { resolved: (normal === "/" ? "" : normal) + "/" + body, literal: normal.split("/").filter((sg) => sg !== "").length };
|
|
769
|
+
}
|
|
770
|
+
function firstGlobSegment(segments, literal) {
|
|
771
|
+
return segments.findIndex((sg, i) => i >= literal && sg.includes("*"));
|
|
765
772
|
}
|
|
766
773
|
export function isUsablePathBase(base, family) {
|
|
767
774
|
return base !== undefined && isAbsoluteForFamily(family ?? "own", base) && pathIdentityOf(base, family, base).ok;
|
|
768
775
|
}
|
|
776
|
+
export function unusableDeclaredBase(rule, declared) {
|
|
777
|
+
for (const base of ruleBasesNeeded(rule)) {
|
|
778
|
+
const key = base === "cwd" && declared.cwd === undefined ? "root" : base;
|
|
779
|
+
const value = declared[key];
|
|
780
|
+
if (value !== undefined && !isUsablePathBase(value, pathFamilyOf(declared)))
|
|
781
|
+
return { base, key };
|
|
782
|
+
}
|
|
783
|
+
return undefined;
|
|
784
|
+
}
|
|
769
785
|
function segmentGlobMatches(glob, segment) {
|
|
770
786
|
if (!glob.includes("*"))
|
|
771
787
|
return glob === segment;
|
|
@@ -788,7 +804,7 @@ function segmentGlobMatches(glob, segment) {
|
|
|
788
804
|
}
|
|
789
805
|
return true;
|
|
790
806
|
}
|
|
791
|
-
function globSegmentsReach(globs, target) {
|
|
807
|
+
function globSegmentsReach(globs, target, literal) {
|
|
792
808
|
const seen = new Set();
|
|
793
809
|
const width = target.length + 1;
|
|
794
810
|
const walk = (g, t) => {
|
|
@@ -798,6 +814,8 @@ function globSegmentsReach(globs, target) {
|
|
|
798
814
|
if (seen.has(key))
|
|
799
815
|
return false;
|
|
800
816
|
seen.add(key);
|
|
817
|
+
if (g < literal)
|
|
818
|
+
return t < target.length && globs[g] === target[t] && walk(g + 1, t + 1);
|
|
801
819
|
if (globs[g] === "**")
|
|
802
820
|
return walk(g + 1, t) || (t < target.length && walk(g, t + 1));
|
|
803
821
|
if (t >= target.length)
|
|
@@ -822,7 +840,25 @@ export function pathRuleReachOf(rule, target, bases, treeFamily = pathFamilyOf(b
|
|
|
822
840
|
return NOT_REACHED;
|
|
823
841
|
const globs = r.resolved.split("/").filter((sg) => sg !== "");
|
|
824
842
|
const segments = target.split("/").filter((sg) => sg !== "");
|
|
825
|
-
return globSegmentsReach(globs, segments) ? REACHED : NOT_REACHED;
|
|
843
|
+
return globSegmentsReach(globs, segments, r.literal) ? REACHED : NOT_REACHED;
|
|
844
|
+
}
|
|
845
|
+
export function pathRuleReachShapeOf(rule, bases) {
|
|
846
|
+
const family = pathFamilyOf(bases);
|
|
847
|
+
if (rule.match === "subpath") {
|
|
848
|
+
if (carriesDotSegment(rule.command, family))
|
|
849
|
+
return undefined;
|
|
850
|
+
const dir = pathIdentityOf(rule.command, family, bases.root ?? bases.cwd);
|
|
851
|
+
return dir.ok && isIdentityDir(dir.identity, family) && dir.identity.startsWith("/") && !isUncIdentity(dir.identity) ? { at: dir.identity, globs: [] } : undefined;
|
|
852
|
+
}
|
|
853
|
+
if (rule.match !== "path")
|
|
854
|
+
return undefined;
|
|
855
|
+
const r = resolvePathPattern(rule.command, bases, rule.behavior, family);
|
|
856
|
+
if ("missingBase" in r || !r.resolved.startsWith("/") || isUncIdentity(r.resolved))
|
|
857
|
+
return undefined;
|
|
858
|
+
const segments = r.resolved.split("/").filter((sg) => sg !== "");
|
|
859
|
+
const wild = firstGlobSegment(segments, r.literal);
|
|
860
|
+
const lead = wild === -1 ? segments : segments.slice(0, wild);
|
|
861
|
+
return { at: `/${lead.join("/")}`, globs: wild === -1 ? [] : segments.slice(wild) };
|
|
826
862
|
}
|
|
827
863
|
export function pathRuleHeadOf(rule, bases) {
|
|
828
864
|
const family = pathFamilyOf(bases);
|
|
@@ -838,9 +874,10 @@ export function pathRuleHeadOf(rule, bases) {
|
|
|
838
874
|
const r = resolvePathPattern(rule.command, bases, rule.behavior);
|
|
839
875
|
if ("missingBase" in r)
|
|
840
876
|
return undefined;
|
|
841
|
-
const
|
|
842
|
-
const wild =
|
|
843
|
-
|
|
877
|
+
const segments = r.resolved.split("/").filter((sg) => sg !== "");
|
|
878
|
+
const wild = firstGlobSegment(segments, r.literal);
|
|
879
|
+
const lead = wild === -1 ? segments : segments.slice(0, wild);
|
|
880
|
+
head = lead.length === 0 ? "" : `${isUncIdentity(r.resolved) ? "//" : "/"}${lead.join("/")}`;
|
|
844
881
|
}
|
|
845
882
|
else
|
|
846
883
|
return undefined;
|
|
@@ -1458,13 +1495,14 @@ export function adjudicatePersistedDomainRules(rules, call) {
|
|
|
1458
1495
|
}
|
|
1459
1496
|
return undefined;
|
|
1460
1497
|
}
|
|
1461
|
-
export function wholeToolRuleReaches(tool, call) {
|
|
1462
|
-
|
|
1498
|
+
export function wholeToolRuleReaches(tool, call, behavior) {
|
|
1499
|
+
const readsOtherServers = readsNameGlob(behavior) && peerReadingsOf(tool).length > 0;
|
|
1500
|
+
return heldBy("policy.persistedToolRule", { has: (name) => name === tool || (readsOtherServers && ruleNameCovers(tool, name)) }, call);
|
|
1463
1501
|
}
|
|
1464
1502
|
export function adjudicatePersistedToolRules(rules, call) {
|
|
1465
1503
|
const at = { cwd: call.cwd, ...(call.sessionId !== undefined ? { sessionId: call.sessionId } : {}), ...(call.scopeIdentity !== undefined ? { scopeIdentity: call.scopeIdentity } : {}) };
|
|
1466
1504
|
for (const behavior of RULE_BEHAVIORS_BY_PRECEDENCE) {
|
|
1467
|
-
const row = rules.find((rule) => rule.match === "tool" && wholeToolRuleReaches(rule.tool, call.request) && eligiblePersisted(rule, { ...at, tool: rule.tool }, behavior));
|
|
1505
|
+
const row = rules.find((rule) => rule.match === "tool" && wholeToolRuleReaches(rule.tool, call.request, behavior) && eligiblePersisted(rule, { ...at, tool: rule.tool }, behavior));
|
|
1468
1506
|
if (row !== undefined)
|
|
1469
1507
|
return { behavior, rules: [row] };
|
|
1470
1508
|
}
|
|
@@ -238,7 +238,7 @@ export interface ReadOrgRow {
|
|
|
238
238
|
readonly behavior: "deny" | "ask";
|
|
239
239
|
readonly parsed: ParsedRule;
|
|
240
240
|
}
|
|
241
|
-
/** One call as the org layer judges it: the rule words it
|
|
241
|
+
/** One call as the org layer judges it: the rule words a tightening reaches it under (`ruleWordsOf`; one word is enough), its shell
|
|
242
242
|
* command when it is the shell tool's, and the face of its path target when it has one (`callPathFaceOf`). */
|
|
243
243
|
export interface OrgRuleCall {
|
|
244
244
|
readonly tool: string | readonly string[];
|
|
@@ -2,6 +2,7 @@ import { escapeForDisclosure, isRuleBehavior, parseRuleText } from "./permission
|
|
|
2
2
|
import { PERMISSION_RULE_WRITER, errText, isValidDurableScope, normalizePersistedRule, sameRuleIdentity, writerOf, } from "./permission-rule-store.js";
|
|
3
3
|
import { readRuleOwner } from "./rule-owner.js";
|
|
4
4
|
import { readPrincipal } from "./principal-name.js";
|
|
5
|
+
import { optionKeys, receiveMembers } from "./own-property-receipt.js";
|
|
5
6
|
import { UNGOVERNED_ORG_RESOLUTION, compileOrgShadowPredicate, createOrgRulePartition } from "./permission-rule-org.js";
|
|
6
7
|
export function ruleSourceOf(scope) {
|
|
7
8
|
return scope.kind === "global" ? "user" : scope.kind;
|
|
@@ -176,8 +177,10 @@ export async function effectiveOrThrow(store, query) {
|
|
|
176
177
|
return view;
|
|
177
178
|
}
|
|
178
179
|
export async function effectivePermissionRules(opts) {
|
|
179
|
-
|
|
180
|
+
const o = receiveMembers(opts, { subject: "effectivePermissionRules options", unit: "option", moment: "at effectivePermissionRules" }, EFFECTIVE_RULES_OPTION_KEYS);
|
|
181
|
+
return await resolveOwnerStore(o).effective(o.sessionId !== undefined ? { sessionId: o.sessionId } : undefined);
|
|
180
182
|
}
|
|
183
|
+
const EFFECTIVE_RULES_OPTION_KEYS = optionKeys()({ provider: 0, principal: 0, owner: 0, sessionId: 0 });
|
|
181
184
|
export function resolveOwnerStore(opts) {
|
|
182
185
|
const owner = opts.owner === undefined ? undefined : readRuleOwner(opts.owner);
|
|
183
186
|
if (opts.owner !== undefined && owner === undefined) {
|
|
@@ -199,6 +199,10 @@ export interface PermissionRulePolicyOptions {
|
|
|
199
199
|
* environment's home of the leg it enters the delegation chain on — and stays there for every child and every `cd`.
|
|
200
200
|
* A declared value that is not an absolute path of its tree's family is refused at compile time
|
|
201
201
|
* (`unsupported.path_base`, naming the base — {@link ruleBasesNeeded} is the same classification).
|
|
202
|
+
* A SETTINGS LAYER's rules are one rule set, the reference's reading of `/x` (the root of the layer the rule came from):
|
|
203
|
+
* `root` = the layer's root — the task root for a project or local layer, the configuration directory for a user layer —
|
|
204
|
+
* and `cwd` = the task root, since a relative pattern reads at the working directory whatever its layer (left out, it
|
|
205
|
+
* stands in at `root`). Rules of several layers merged into one set read every `/x` at that one set's root.
|
|
202
206
|
* These are the RULES' anchors, never the call's: a call's target is read from the call (its target reading, else its
|
|
203
207
|
* own `root` / `cwd`); only a host calling the policy directly with a request that carries neither has its target
|
|
204
208
|
* resolved against `root` / `cwd` here. A target nothing locates is unreadable: every path rule able to reach the
|
|
@@ -3,8 +3,7 @@ import { MCP_NAMESPACE } from "./protocol-table.js";
|
|
|
3
3
|
import { catalogRuleFaceOf, isShellFaceToolName, pathTargetOf } from "./tool-registry.js";
|
|
4
4
|
import { HOST_UNREADABLE_SENTENCE, callHostTargetOf } from "./host-target.js";
|
|
5
5
|
import { indexOfUnescaped, lastIndexOfUnescaped, parsePermissionRule, ruleSpellingOf } from "./permission-rule-syntax.js";
|
|
6
|
-
import { callPathFaceOf, canonicalNameValue, COMMAND_RULE_TOOL, domainRuleAdmits,
|
|
7
|
-
import { pathFamilyOf } from "../tools/fs/safety.js";
|
|
6
|
+
import { callPathFaceOf, canonicalNameValue, COMMAND_RULE_TOOL, domainRuleAdmits, ruleWordsOf, mountedOnlyArgumentOf, mountedValueArmOf, NAME_RULE_FACES, nameRuleReach, nameRuleSubjectOf, nameValueAbsentReason, nameValuesUnreadReason, parseRuleText, PATH_RULE_BASE_LABEL, PATH_RULE_FACES, programRunReachOf, ruleLaneOf, unusableDeclaredBase, ruleShapeOf, shellRuleParamOf, ruleContentOf } from "./permission-rule-model.js";
|
|
8
7
|
import { callTargetReadingOf, callTargetViewsOf } from "./effective-path-target.js";
|
|
9
8
|
import { DEFAULT_MAX_SCALAR_VALUE_CHARS, paramRuleReaches } from "./param-rule-reach.js";
|
|
10
9
|
import { bindPathRules, judgeRuleRows, policyAnchors, rowsWhereTheyLead } from "./path-rule-binding.js";
|
|
@@ -209,11 +208,9 @@ function compile(rules, caps, primaryFieldGeneric, ruleFaces, pathBases = {}) {
|
|
|
209
208
|
bad(text, "invalid.command_rule", `${parsedPath.reject.code}: ${parsedPath.reject.message}`);
|
|
210
209
|
continue;
|
|
211
210
|
}
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
bad(text, "unsupported.path_base", `"${text}" is relative to ${PATH_RULE_BASE_LABEL[base]}, and the one this policy declares for it is not an absolute path of its tree's family — the rule could not be judged on any call`, { name: `pathBases.${base === "cwd" && pathBases.cwd === undefined ? "root" : base}` });
|
|
216
|
-
}
|
|
211
|
+
const unusable = unusableDeclaredBase(parsedPath.rule, pathBases);
|
|
212
|
+
if (unusable !== undefined) {
|
|
213
|
+
bad(text, "unsupported.path_base", `"${text}" is relative to ${PATH_RULE_BASE_LABEL[unusable.base]}, and the one this policy declares for it is not an absolute path of its tree's family — the rule could not be judged on any call`, { name: `pathBases.${unusable.key}` });
|
|
217
214
|
}
|
|
218
215
|
if (issues.length > 0 && issues[issues.length - 1].rule === text && issues[issues.length - 1].code === "unsupported.path_base")
|
|
219
216
|
continue;
|
|
@@ -332,6 +329,8 @@ export function createPermissionRulePolicy(rules, opts) {
|
|
|
332
329
|
const heldFor = (table, req) => heldValues("policy.permissionRules", table, req);
|
|
333
330
|
const coveringHit = (lane, req) => lane.length === 0 ? undefined : heldFor({ get: (name) => lane.find((r) => ruleNameCovers(r.ruleName, name)) }, req)[0];
|
|
334
331
|
const hasCovering = namespacedCovering.deny.length > 0 || namespacedCovering.ask.length > 0;
|
|
332
|
+
const wholeToolDeny = (req) => entryFor(req)?.bare.deny ?? (hasCovering ? coveringHit(namespacedCovering.deny, req) : undefined);
|
|
333
|
+
const deniesWhole = namespacedCovering.deny.length > 0 || [...byTool.values()].some((e) => e.bare.deny !== undefined);
|
|
335
334
|
const faceRules = {
|
|
336
335
|
deny: [...byTool.values()].flatMap((e) => e.content.deny.filter((r) => r.faces !== undefined)),
|
|
337
336
|
ask: [...byTool.values()].flatMap((e) => e.content.ask.filter((r) => r.faces !== undefined)),
|
|
@@ -462,20 +461,16 @@ export function createPermissionRulePolicy(rules, opts) {
|
|
|
462
461
|
};
|
|
463
462
|
return {
|
|
464
463
|
nameSets: [nameSets],
|
|
464
|
+
...(deniesWhole ? { wholeToolRefusals: () => Promise.resolve((tool) => wholeToolDeny(tool) !== undefined) } : {}),
|
|
465
465
|
...(pathSpecs.length > 0 ? { pathRules: (anchors) => boundAt(policyAnchors(pathBases, anchors)).rows } : {}),
|
|
466
466
|
check(req) {
|
|
467
467
|
const entry = entryFor(req);
|
|
468
468
|
const covering = hasCovering;
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
if (covering) {
|
|
473
|
-
const coveringDeny = coveringHit(namespacedCovering.deny, req);
|
|
474
|
-
if (coveringDeny)
|
|
475
|
-
return { action: "deny", message: ruleDenial(req, coveringDeny.ruleText, coveringDeny.source) };
|
|
476
|
-
}
|
|
469
|
+
const whole = wholeToolDeny(req);
|
|
470
|
+
if (whole !== undefined)
|
|
471
|
+
return { action: "deny", message: ruleDenial(req, whole.ruleText, whole.source) };
|
|
477
472
|
const callFace = faceRules.deny.length > 0 || faceRules.ask.length > 0 ? callPathFaceOf(req) : undefined;
|
|
478
|
-
const shellCall = hasCommandRules &&
|
|
473
|
+
const shellCall = hasCommandRules && ruleWordsOf(req, "deny").includes(COMMAND_RULE_TOOL);
|
|
479
474
|
const denyLane = contentLaneOf("deny", entry, shellCall, callFace);
|
|
480
475
|
const contentDeny = denyLane.length > 0 ? contentHit(denyLane, req) : undefined;
|
|
481
476
|
if (contentDeny !== undefined && contentDeny.unreadable === undefined) {
|
|
@@ -7,8 +7,8 @@
|
|
|
7
7
|
* transport writes itself (an MCP request's session, protocol version, content type, accept and resume headers) is the
|
|
8
8
|
* protocol's: neither a seat's answer nor the principal header owns it. The hosted-connector assertion header
|
|
9
9
|
* ({@link MCP_ASSERTION_HEADER}) is the seat's to answer and never the principal header's name. A header the credential
|
|
10
|
-
* vocabulary reads as a credential is one the engine holds from the moment
|
|
11
|
-
* inherits a variable whose value equals it
|
|
10
|
+
* vocabulary reads as a credential is one the engine holds from the moment the seat answers it, before the answer is judged
|
|
11
|
+
* (the carrier's one intake, src/core/peer-seat.ts): no child spawned on this host inherits a variable whose value equals it.
|
|
12
12
|
*
|
|
13
13
|
* A principal header that breaks the rule is that peer's defect: the resolver throws inside the peer's own dial, so the
|
|
14
14
|
* peer is skipped with a coded warning and its siblings still mount; an answer that breaks it is the seat's, and that send
|
|
@@ -54,6 +54,8 @@ export declare function resolveProtocolHttpHeaders(protocol: ProtocolId, t: Prot
|
|
|
54
54
|
/** The engine's default request headers under the declared ones: a declared name, in any case, owns that header
|
|
55
55
|
* (the default of the same name is not sent beside it). */
|
|
56
56
|
export declare function underDeclaredHeaders(defaults: Readonly<Record<string, string>>, declared: Record<string, string> | undefined): Record<string, string>;
|
|
57
|
+
/** A header value as the transport sends it: the HTTP whitespace at its two edges is not part of the value (WHATWG `Headers`). */
|
|
58
|
+
export declare const httpTrimmed: (value: string) => string;
|
|
57
59
|
/**
|
|
58
60
|
* A peer's error text with what the peer was SENT taken out of it. Both kinds of removal are found on the ORIGINAL text (so no marker is
|
|
59
61
|
* rescanned and no replacement can disturb what another one reads) and the ranges they take are merged, one marker per merged range: every
|
|
@@ -69,6 +71,16 @@ export declare function underDeclaredHeaders(defaults: Readonly<Record<string, s
|
|
|
69
71
|
* whole marker with it, so the pass over its own output answers the same text.
|
|
70
72
|
*/
|
|
71
73
|
export declare function scrubRequestEcho(text: string, declared: readonly string[]): string;
|
|
74
|
+
/**
|
|
75
|
+
* A remote's own account of itself read without the credentials its connection's requests carried — THE one eraser of what a successful
|
|
76
|
+
* dial or listing hands the engine (an MCP server's `serverInfo`, instructions and tool listing; an A2A peer's card). The needle is
|
|
77
|
+
* `credentials` (the connection's credential values, `PeerCarrier.credentials`): every occurrence of one, in any spelling the
|
|
78
|
+
* request-echo derivation gives it ({@link requestEchoSpellings}) and in any letter case, becomes the redaction mark in place, the way
|
|
79
|
+
* {@link scrubRequestEcho} takes a declared value out of a failure's words. Nothing else is taken — no Cookie member, no vocabulary
|
|
80
|
+
* guess: the rest of the text is the remote's own account, and only the needle is the engine's to withhold. A text with no needle in it
|
|
81
|
+
* is returned as it was (the same string). The function is a fixed point.
|
|
82
|
+
*/
|
|
83
|
+
export declare function eraseSentCredentials(text: string, credentials: readonly string[]): string;
|
|
72
84
|
/**
|
|
73
85
|
* THE one form a remote endpoint's words take when the engine carries them in its own words — an MCP server's failure, a model
|
|
74
86
|
* provider's error body, frame or transport failure, a memory distiller seat's failure: what the request was declared with
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { authSchemeCredentials
|
|
1
|
+
import { authSchemeCredentials } from "./secret-env.js";
|
|
2
2
|
import { egressText } from "./untrusted-egress.js";
|
|
3
3
|
import { REDACTION_MARK, redactionMarkerSpans } from "./redaction-marks.js";
|
|
4
4
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
@@ -30,7 +30,6 @@ export function resolveProtocolHttpHeaders(protocol, t, principal) {
|
|
|
30
30
|
const principalHeader = t.principalHeader;
|
|
31
31
|
const answered = t.headers;
|
|
32
32
|
const own = { ...(answered !== undefined ? { headers: { ...answered } } : {}), ...(principalHeader !== undefined ? { principalHeader } : {}) };
|
|
33
|
-
holdOwnCredentialValues(credentialHeaderValues(own.headers));
|
|
34
33
|
const collision = headerOwnershipCollision(own, protocol);
|
|
35
34
|
if (collision !== undefined) {
|
|
36
35
|
const problem = collision.engineOwned
|
|
@@ -49,7 +48,7 @@ export function underDeclaredHeaders(defaults, declared) {
|
|
|
49
48
|
const owned = new Set(Object.keys(declared ?? {}).map((k) => k.toLowerCase()));
|
|
50
49
|
return { ...Object.fromEntries(Object.entries(defaults).filter(([k]) => !owned.has(k.toLowerCase()))), ...declared };
|
|
51
50
|
}
|
|
52
|
-
const httpTrimmed = (value) => value.replace(/^[\t\n\r ]+|[\t\n\r ]+$/g, "");
|
|
51
|
+
export const httpTrimmed = (value) => value.replace(/^[\t\n\r ]+|[\t\n\r ]+$/g, "");
|
|
53
52
|
function percentEncoded(value) {
|
|
54
53
|
try {
|
|
55
54
|
return encodeURIComponent(value);
|
|
@@ -105,7 +104,14 @@ function structuredEnd(text, at) {
|
|
|
105
104
|
return text.length;
|
|
106
105
|
}
|
|
107
106
|
export function scrubRequestEcho(text, declared) {
|
|
108
|
-
|
|
107
|
+
return markedOver(text, requestEchoRanges(text, declared));
|
|
108
|
+
}
|
|
109
|
+
export function eraseSentCredentials(text, credentials) {
|
|
110
|
+
if (credentials.length === 0 || text === "")
|
|
111
|
+
return text;
|
|
112
|
+
return markedOver(text, needleRanges(text, credentials, []));
|
|
113
|
+
}
|
|
114
|
+
function markedOver(text, removed) {
|
|
109
115
|
if (removed.length === 0)
|
|
110
116
|
return text;
|
|
111
117
|
removed.sort((a, b) => a[0] - b[0] || b[1] - a[1]);
|
|
@@ -122,13 +128,16 @@ export function scrubRequestEcho(text, declared) {
|
|
|
122
128
|
return out + text.slice(kept);
|
|
123
129
|
}
|
|
124
130
|
function requestEchoRanges(text, declared) {
|
|
131
|
+
const members = cookieMembers(text);
|
|
132
|
+
return [...members.map(([, from, end]) => [from, end]), ...needleRanges(text, declared, members)];
|
|
133
|
+
}
|
|
134
|
+
function needleRanges(text, values, members) {
|
|
125
135
|
const forms = new Set();
|
|
126
|
-
for (const value of
|
|
136
|
+
for (const value of values)
|
|
127
137
|
for (const spelling of requestEchoSpellings(value))
|
|
128
138
|
forms.add(spelling);
|
|
129
139
|
forms.delete("");
|
|
130
|
-
const
|
|
131
|
-
const removed = members.map(([, from, end]) => [from, end]);
|
|
140
|
+
const removed = [];
|
|
132
141
|
const markers = redactionMarkerSpans(text);
|
|
133
142
|
for (const hit of valueHits(text, [...forms])) {
|
|
134
143
|
if (members.some(([name, from]) => hit[0] >= name && hit[1] <= from))
|
|
@@ -12,8 +12,8 @@ import { type ReadDenyEntry } from "../tools/fs/index.js";
|
|
|
12
12
|
* into meaningless one-character entries with zero refusal. Garbage must refuse loudly at the door,
|
|
13
13
|
* never be consumed letter by letter. */
|
|
14
14
|
export declare function assertStringArraySeat(value: unknown, seat: string, entryLaw: "strings" | "compiler-owned"): void;
|
|
15
|
-
/** The
|
|
16
|
-
export declare const READ_DENY_DEPLOYMENT_SEATS: readonly ["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude"];
|
|
15
|
+
/** The four DEPLOYMENT read-deny seats: the table's three, and whether the deployment requires the byte floor kept. */
|
|
16
|
+
export declare const READ_DENY_DEPLOYMENT_SEATS: readonly ["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude", "readDenyFloorRequired"];
|
|
17
17
|
export type ReadDenyDeploymentSeat = (typeof READ_DENY_DEPLOYMENT_SEATS)[number];
|
|
18
18
|
/**
|
|
19
19
|
* The copy a read-deny seat keeps of its declared value — the one copy law of both doors that admit one (`new Runner`
|
|
@@ -24,7 +24,9 @@ export type ReadDenyDeploymentSeat = (typeof READ_DENY_DEPLOYMENT_SEATS)[number]
|
|
|
24
24
|
export declare function copyReadDenySeat(value: unknown): unknown;
|
|
25
25
|
/**
|
|
26
26
|
* Screen one deployment read-deny seat's value with the laws a prepare applies to it (the array door and the
|
|
27
|
-
* one compiler's entry law for the additions; the built-in table's tier / row-name law for the
|
|
28
|
-
* return a copy; `undefined` stays `undefined` (no declaration
|
|
27
|
+
* one compiler's entry law for the additions; the built-in table's tier / row-name law for the next two; a boolean
|
|
28
|
+
* for the floor requirement) and return a copy; `undefined` stays `undefined` (no declaration — for the requirement,
|
|
29
|
+
* the documented reading "not required", under which an unkept floor is still announced).
|
|
29
30
|
*/
|
|
30
|
-
export declare function screenReadDenySeat(seat:
|
|
31
|
+
export declare function screenReadDenySeat(seat: "readDenyFloorRequired", value: unknown): boolean | undefined;
|
|
32
|
+
export declare function screenReadDenySeat(seat: ReadDenyDeploymentSeat, value: unknown): readonly ReadDenyEntry[] | readonly string[] | boolean | undefined;
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { compileReadDeny, readDenyBuiltinConfigOf } from "../tools/fs/index.js";
|
|
2
|
+
import { screenReadDenyFloorRequired } from "../tools/fs/read-floor.js";
|
|
2
3
|
export function assertStringArraySeat(value, seat, entryLaw) {
|
|
3
4
|
if (value === undefined)
|
|
4
5
|
return;
|
|
@@ -18,7 +19,7 @@ export function assertStringArraySeat(value, seat, entryLaw) {
|
|
|
18
19
|
}
|
|
19
20
|
}
|
|
20
21
|
}
|
|
21
|
-
export const READ_DENY_DEPLOYMENT_SEATS = Object.freeze(["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude"]);
|
|
22
|
+
export const READ_DENY_DEPLOYMENT_SEATS = Object.freeze(["readDenyPatterns", "readDenyBuiltinTiers", "readDenyBuiltinExclude", "readDenyFloorRequired"]);
|
|
22
23
|
export function copyReadDenySeat(value) {
|
|
23
24
|
if (!Array.isArray(value))
|
|
24
25
|
return value;
|
|
@@ -27,6 +28,8 @@ export function copyReadDenySeat(value) {
|
|
|
27
28
|
export function screenReadDenySeat(seat, value) {
|
|
28
29
|
if (value === undefined)
|
|
29
30
|
return undefined;
|
|
31
|
+
if (seat === "readDenyFloorRequired")
|
|
32
|
+
return screenReadDenyFloorRequired(value, `RunnerDeps.${seat}`);
|
|
30
33
|
if (seat === "readDenyPatterns") {
|
|
31
34
|
assertStringArraySeat(value, `RunnerDeps.${seat}`, "compiler-owned");
|
|
32
35
|
const entries = copyReadDenySeat(value);
|
|
@@ -1,12 +1,13 @@
|
|
|
1
1
|
/** The marks, by what they stand for. `whole` is the bare mark (a span removed whole — a credential value, a floor, a
|
|
2
2
|
* depth cut); the others name the shape that was withheld: `credentials` a URL's userinfo, `url` a whole URL, `path` an
|
|
3
|
-
* absolute filesystem path. A mark the engine writes is exactly one of these four.
|
|
4
|
-
|
|
3
|
+
* absolute filesystem path. A mark the engine writes is exactly one of these four. Frozen: the table is exported to hosts, and every
|
|
4
|
+
* pass reads it at call time, so a write by a reader would change what the engine writes. */
|
|
5
|
+
export declare const REDACTION_MARKS: Readonly<{
|
|
5
6
|
readonly whole: "[redacted]";
|
|
6
7
|
readonly credentials: "[redacted-credentials]";
|
|
7
8
|
readonly url: "[redacted-url]";
|
|
8
9
|
readonly path: "[redacted-path]";
|
|
9
|
-
}
|
|
10
|
+
}>;
|
|
10
11
|
/** The bare mark — what a host compares against to tell that the engine withheld a value. */
|
|
11
12
|
export declare const REDACTION_MARK: "[redacted]";
|
|
12
13
|
/** Where the marks sit in `s`, one [start, end) span at a time, leftmost first. Lazy: a reader that stops early (a display cut stops
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
export const REDACTION_MARKS = {
|
|
1
|
+
export const REDACTION_MARKS = Object.freeze({
|
|
2
2
|
whole: "[redacted]",
|
|
3
3
|
credentials: "[redacted-credentials]",
|
|
4
4
|
url: "[redacted-url]",
|
|
5
5
|
path: "[redacted-path]",
|
|
6
|
-
};
|
|
6
|
+
});
|
|
7
7
|
export const REDACTION_MARK = REDACTION_MARKS.whole;
|
|
8
8
|
const escapeLiteral = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
9
9
|
const REDACTION_MARKER_RE = new RegExp(Object.values(REDACTION_MARKS).map(escapeLiteral).join("|"), "g");
|