@sema-agent/core 7.60.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 +605 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- 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 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- 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.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- 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 +30 -40
- package/dist/agents/subagent.js +187 -196
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/brain/anthropic.js +1 -0
- 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/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- 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.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +78 -19
- package/dist/core/checkpoint-store.js +8 -4
- 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/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- 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 +49 -18
- 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 +10 -0
- package/dist/core/frame-settlement.js +6 -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 +2 -1
- package/dist/core/gate-lanes.js +7 -4
- 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 +12 -4
- package/dist/core/governance-codes.js +16 -4
- package/dist/core/hooks.d.ts +12 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +48 -8
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -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 +2 -1
- package/dist/core/locked-config.js +5 -3
- 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-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +220 -46
- package/dist/core/mcp-probe.js +2 -2
- 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 +2 -1
- 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 +6 -49
- package/dist/core/mcp.js +115 -111
- 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-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- 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/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/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +7 -5
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- 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 +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +4 -1
- package/dist/core/mods/kernel/events.js +6 -6
- 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/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 +38 -16
- package/dist/core/mods/stations.js +25 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +61 -2
- package/dist/core/own-property-receipt.js +42 -2
- package/dist/core/park-selfcheck.js +4 -2
- 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 +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- 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/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- 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/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -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 -3
- package/dist/core/runner/assemble-result.js +12 -7
- 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/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 +2 -2
- package/dist/core/runner/contracts.d.ts +98 -26
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- 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/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- 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/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 +28 -9
- 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 +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
- package/dist/core/runner/prepare-config-doors.js +16 -17
- 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 +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- 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-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
- package/dist/core/runner/prepare-hands-readface.js +4 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
- package/dist/core/runner/prepare-inherited-gate.js +3 -0
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -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 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +56 -28
- 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-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- 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-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 +2 -0
- package/dist/core/runner/run-git-lane.js +2 -1
- package/dist/core/runner/run-harness-handlers.js +2 -2
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +40 -29
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +9 -7
- 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 +27 -14
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +27 -11
- 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/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/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 -2
- 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-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- 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 +3 -2
- package/dist/core/runner/turn-attachments.js +1 -1
- 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 +24 -25
- package/dist/core/secret-env.d.ts +11 -11
- 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 +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +2 -0
- package/dist/core/session-store.js +5 -7
- 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.js +1 -1
- 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 +30 -0
- package/dist/core/task-event.d.ts +17 -8
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +87 -13
- package/dist/core/task-registry-agent.d.ts +5 -43
- package/dist/core/task-registry-agent.js +24 -51
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +15 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +4 -21
- package/dist/core/task-registry.d.ts +19 -60
- package/dist/core/task-registry.js +19 -106
- package/dist/core/task-result.d.ts +24 -7
- 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 +10 -10
- 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 +2 -5
- 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.js +3 -2
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- 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 +108 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-spec.d.ts +19 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/user-attachment.js +26 -21
- 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 +34 -9
- package/dist/engine/execution-env/node-execution-env.js +213 -21
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +41 -7
- 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 +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- 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 +21 -11
- package/dist/index.js +15 -7
- package/dist/internal/harness-types.d.ts +2 -0
- 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 +11 -17
- package/dist/orchestration/run-workflow-tool.js +19 -42
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +8 -5
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.js +7 -4
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/index.d.ts +5 -3
- package/dist/stores/file/index.js +23 -8
- 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.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- 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.js +3 -2
- package/dist/stores/file/session-store.d.ts +16 -3
- package/dist/stores/file/session-store.js +21 -20
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -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/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- 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 +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- 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 +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +92 -10
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -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,4 +1,6 @@
|
|
|
1
1
|
import { types } from "node:util";
|
|
2
|
+
import { closestName } from "./closest-name.js";
|
|
3
|
+
import { inlineUntrusted } from "./untrusted-text.js";
|
|
2
4
|
import { describeFault, isPlainRecord, receive } from "./mods/kernel/receive.js";
|
|
3
5
|
import { MODS_VALUE_DEPTH } from "./mods/kernel/site-rules.js";
|
|
4
6
|
export function receiptRefusal(message) {
|
|
@@ -12,14 +14,37 @@ export function refuseProxy(given, words) {
|
|
|
12
14
|
}
|
|
13
15
|
export const CONFIG_RECEIPT_MODE = Object.freeze({ accessors: "call-once", depth: 1, others: "as-is", isProxy: (v) => types.isProxy(v) });
|
|
14
16
|
export const DECLARATION_RECEIPT_MODE = Object.freeze({ accessors: "call-once", depth: MODS_VALUE_DEPTH + 1, others: "refuse", freeze: true, isProxy: (v) => types.isProxy(v) });
|
|
15
|
-
export function
|
|
16
|
-
return
|
|
17
|
+
export function optionKeys() {
|
|
18
|
+
return ((table) => Object.freeze(Object.keys(table)));
|
|
19
|
+
}
|
|
20
|
+
export function receiveOptions(given, owner, keys) {
|
|
21
|
+
return given === undefined ? Object.freeze({}) : receiveMembers(given, { subject: `${owner} options`, unit: "option", moment: `at new ${owner}` }, keys);
|
|
17
22
|
}
|
|
18
23
|
export function receiveOwnProperties(given, words) {
|
|
24
|
+
admitPlainRecord(given, words);
|
|
25
|
+
return readCaptured(given, words);
|
|
26
|
+
}
|
|
27
|
+
export function strayMembersOf(given, words, keys) {
|
|
28
|
+
const names = Reflect.ownKeys(given).filter((k) => typeof k === "symbol" || !keys.includes(k));
|
|
29
|
+
return names.length === 0 ? undefined : Object.freeze({ names: Object.freeze(names), sentence: strayMembersSentence(words, names, keys) });
|
|
30
|
+
}
|
|
31
|
+
export function refuseStrayMembers(given, words, keys, refusal = receiptRefusal) {
|
|
32
|
+
admitPlainRecord(given, words);
|
|
33
|
+
const stray = strayMembersOf(given, words, keys);
|
|
34
|
+
if (stray !== undefined)
|
|
35
|
+
throw refusal(stray.sentence, stray.names);
|
|
36
|
+
}
|
|
37
|
+
export function receiveMembers(given, words, keys, refusal = receiptRefusal) {
|
|
38
|
+
refuseStrayMembers(given, words, keys, refusal);
|
|
39
|
+
return Object.freeze(readCaptured(given, words));
|
|
40
|
+
}
|
|
41
|
+
function admitPlainRecord(given, words) {
|
|
19
42
|
refuseProxy(given, words);
|
|
20
43
|
if (!isPlainRecord(given)) {
|
|
21
44
|
throw receiptRefusal(`${words.subject} must be a plain object (its prototype is neither Object.prototype nor null): every ${words.unit} is read once as an own property, and a ${words.unit} its prototype would supply is not read — refused rather than wired without it`);
|
|
22
45
|
}
|
|
46
|
+
}
|
|
47
|
+
function readCaptured(given, words) {
|
|
23
48
|
const received = receive(given, CONFIG_RECEIPT_MODE);
|
|
24
49
|
if (received.ok)
|
|
25
50
|
return received.value;
|
|
@@ -30,3 +55,18 @@ export function receiveOwnProperties(given, words) {
|
|
|
30
55
|
throw receiptRefusal(`${words.subject}'s prototype changed while its ${words.unit}s were read ${words.moment} — refused rather than wired from a moving object`);
|
|
31
56
|
throw receiptRefusal(`${words.subject} could not be read ${words.moment}: ${describeFault(received.fault)} — refused rather than wired without it`);
|
|
32
57
|
}
|
|
58
|
+
const STRAY_NAME_MAX = 80;
|
|
59
|
+
function strayMembersSentence(words, stray, keys) {
|
|
60
|
+
const named = stray.map((k) => {
|
|
61
|
+
if (typeof k === "symbol")
|
|
62
|
+
return `${inlineUntrusted(String(k), STRAY_NAME_MAX)} (a symbol-keyed member)`;
|
|
63
|
+
const shown = JSON.stringify(inlineUntrusted(k, STRAY_NAME_MAX));
|
|
64
|
+
const near = closestName(k, keys);
|
|
65
|
+
return near === undefined ? shown : `${shown} (did you mean ${JSON.stringify(near)}?)`;
|
|
66
|
+
});
|
|
67
|
+
const one = stray.length === 1;
|
|
68
|
+
const unit = words.unit;
|
|
69
|
+
const what = one ? `is not ${/^[aeiou]/i.test(unit) ? "an" : "a"} ${unit}` : `are not ${unit}s`;
|
|
70
|
+
const takes = keys.length === 0 ? `it takes no ${unit}s` : `the ${unit}s it takes are ${keys.map((k) => JSON.stringify(k)).join(", ")}`;
|
|
71
|
+
return `${words.subject}: ${named.join(", ")} ${what} it takes — ${takes}; refused ${words.moment} rather than read as absent (a misspelled ${unit} would leave its default in force and nothing would say so)`;
|
|
72
|
+
}
|
|
@@ -92,6 +92,7 @@ function syntheticCheckpoint(scope, fidelity) {
|
|
|
92
92
|
batchToolCallIds: [`${scope}:call`],
|
|
93
93
|
completedCallIds: [],
|
|
94
94
|
},
|
|
95
|
+
heldRows: [{ role: "user", content: [{ type: "text", text: "park wiring self-check held row" }], timestamp: 0, provenance: "engine-note", rewrittenBy: ["park-selfcheck"] }],
|
|
95
96
|
state: { activeTools: ["SelfCheck"], nestedStats: { tokens: 0, turns: 0, tasks: 0, costMicroUsd: 0, anyUnpriced: false } },
|
|
96
97
|
status: "pending",
|
|
97
98
|
createdAt: Date.now(),
|
|
@@ -99,7 +100,7 @@ function syntheticCheckpoint(scope, fidelity) {
|
|
|
99
100
|
suspendedAt: Date.now(),
|
|
100
101
|
resourceLedger: { spentMicroUsd: 0, spentTokens: 0, spentTurns: 0, sliceCount: 1 },
|
|
101
102
|
humanReview: { count: 1, totalWaitMs: 0, gates: [{ kind: "human", waitMs: 0, decision: "approve", toolName: "SelfCheck", toolCallId: `${scope}:selfcheck-call`, toolArg: "park self-check probe" }] },
|
|
102
|
-
|
|
103
|
+
sourceSessionId: `${scope}:session`,
|
|
103
104
|
principal: `${scope}:principal`,
|
|
104
105
|
durableApproval: { scope, ttlMs: PARK_SELFCHECK_ROW_TTL_MS },
|
|
105
106
|
deadline: Date.now() + PARK_SELFCHECK_ROW_TTL_MS,
|
|
@@ -112,6 +113,7 @@ function faithfulnessDelta(sent, got) {
|
|
|
112
113
|
scope: cp.scope,
|
|
113
114
|
sessionId: cp.sessionId,
|
|
114
115
|
leafId: cp.leafId,
|
|
116
|
+
heldRows: cp.heldRows,
|
|
115
117
|
gate: cp.gate,
|
|
116
118
|
pendingAction: cp.pendingAction,
|
|
117
119
|
state: cp.state,
|
|
@@ -124,7 +126,7 @@ function faithfulnessDelta(sent, got) {
|
|
|
124
126
|
suspendedAt: cp.suspendedAt,
|
|
125
127
|
resourceLedger: cp.resourceLedger,
|
|
126
128
|
humanReview: cp.humanReview,
|
|
127
|
-
|
|
129
|
+
sourceSessionId: cp.sourceSessionId,
|
|
128
130
|
principal: cp.principal,
|
|
129
131
|
durableApproval: cp.durableApproval,
|
|
130
132
|
});
|
|
@@ -22,5 +22,16 @@ export type ChainHopsReading = {
|
|
|
22
22
|
* cannot answer not vote ({@link chainHopsOrNone}), an allow admits nothing it could not see.
|
|
23
23
|
*/
|
|
24
24
|
export declare function symlinkChainHops(env: ExecutionEnv, path: string, signal: AbortSignal | undefined, family: PathFamily, baseCwd?: string): Promise<ChainHopsReading>;
|
|
25
|
+
/**
|
|
26
|
+
* Whether a target's leaf chain can hold a hop, once the environment said where the target lands: a link may be on the way
|
|
27
|
+
* when what was walked climbs a `..` (the lexical fold of `..` across a linked parent names another file than the one the
|
|
28
|
+
* filesystem walks to) or when the reader cannot say the target landed at its own lexical spelling (`landedElsewhere`: a
|
|
29
|
+
* link resolved elsewhere, or a resolution that rejoined a missing tail as spelled — the leaf may be a link whose target is
|
|
30
|
+
* not there yet). Where neither holds nothing on the way is a link, and the chain is not asked. The readers that skip the chain where no
|
|
31
|
+
* link can be on the way take this one gate before {@link symlinkChainHops}: a call's target views (`readPath`) and the shell read
|
|
32
|
+
* station's establishment. The write-protection table and the sensitive-path deny set do not: they read the chain whenever one of
|
|
33
|
+
* their rows can hear a hop.
|
|
34
|
+
*/
|
|
35
|
+
export declare function leafChainMayHold(walked: readonly (string | undefined)[], landedElsewhere: boolean, family: PathFamily): boolean;
|
|
25
36
|
/** A path guard's reading of a chain: the hops, or none — a view that cannot answer does not vote (its absence law). */
|
|
26
37
|
export declare function chainHopsOrNone(reading: ChainHopsReading): readonly string[];
|
|
@@ -13,6 +13,10 @@ export async function symlinkChainHops(env, path, signal, family, baseCwd) {
|
|
|
13
13
|
const chain = await env.canonicalChain(target, signal);
|
|
14
14
|
return chain.ok ? { ok: true, hops: chain.value.hops } : { ok: false, cause: chain.error.message, asked: true };
|
|
15
15
|
}
|
|
16
|
+
export function leafChainMayHold(walked, landedElsewhere, family) {
|
|
17
|
+
const climbs = family === "win" ? /(^|[\\/])\.\.([\\/]|$)/ : /(^|\/)\.\.(\/|$)/;
|
|
18
|
+
return landedElsewhere || walked.some((s) => s !== undefined && climbs.test(s));
|
|
19
|
+
}
|
|
16
20
|
export function chainHopsOrNone(reading) {
|
|
17
21
|
return reading.ok ? reading.hops : [];
|
|
18
22
|
}
|
|
@@ -35,7 +35,9 @@ export declare function bindPathRules<S extends PathRuleSpec>(specs: readonly S[
|
|
|
35
35
|
* alone. */
|
|
36
36
|
export declare function policyAnchors(declared: PathRuleBases, install: PathRuleBases | undefined): PathRuleBases;
|
|
37
37
|
/** A stored row's anchors: a PROJECT row's `/x` and relative words at the row's own scope root (the project it was written
|
|
38
|
-
* for), a global or session row's at the chain's top leg; `~/` at the top leg's home for every row.
|
|
38
|
+
* for), a global or session row's at the chain's top leg; `~/` at the top leg's home for every row. A row has no seat for a
|
|
39
|
+
* settings layer's own directory, so the settings import carries only the rules a row reads the way their layer does — a
|
|
40
|
+
* user layer's `/x`, read there at the configuration directory, stays in its file (`prepareCcImport`). */
|
|
39
41
|
export declare function persistedRowAnchors(scope: RuleScope, chainTop: PathRuleBases): PathRuleBases;
|
|
40
42
|
/** A leg's root as an identity for project coverage ({@link ScopeRootIdentity}): its canonical root, and each project
|
|
41
43
|
* row's scope root resolved through the leg's resolution (`leads`, each location once per leg) — so a row written under
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { parsePermissionRule } from "./permission-rule-syntax.js";
|
|
2
|
-
import { isUsablePathBase, pathRuleHeadOf, pathRuleReachOf, ruleBasesNeeded } from "./permission-rule-model.js";
|
|
2
|
+
import { isUsablePathBase, pathRuleHeadOf, pathRuleReachOf, pathRuleReachShapeOf, ruleBasesNeeded } from "./permission-rule-model.js";
|
|
3
3
|
import { pathFamilyOf, spellingOfIdentity } from "../tools/fs/safety.js";
|
|
4
4
|
import { absoluteTargetIdentityOf } from "./effective-path-target.js";
|
|
5
5
|
import { locationLeadsTo, ruleHeadParts } from "../tools/fs/read-deny.js";
|
|
@@ -12,6 +12,7 @@ export function bindPathRules(specs, anchors) {
|
|
|
12
12
|
const a = typeof anchors === "function" ? anchors(spec) : anchors;
|
|
13
13
|
const family = pathFamilyOf(a);
|
|
14
14
|
const head = pathRuleHeadOf(spec.parsed, a);
|
|
15
|
+
const shape = pathRuleReachShapeOf(spec.parsed, a);
|
|
15
16
|
const unanchored = ruleBasesNeeded(spec.parsed).filter((b) => !isUsablePathBase(b === "cwd" ? (a.cwd ?? a.root) : a[b], family));
|
|
16
17
|
const reach = (absolutePath) => {
|
|
17
18
|
const tree = a.root !== undefined || a.cwd !== undefined ? a : { root: absolutePath };
|
|
@@ -28,6 +29,7 @@ export function bindPathRules(specs, anchors) {
|
|
|
28
29
|
reach,
|
|
29
30
|
reaches: (absolutePath) => reach(absolutePath).reach !== "not_reached",
|
|
30
31
|
...(head !== undefined ? { head: spellingOfIdentity(head, family) } : {}),
|
|
32
|
+
...(shape !== undefined && (a.root !== undefined || a.cwd !== undefined) ? { reachShape: shape } : {}),
|
|
31
33
|
...(unanchored.length > 0 ? { unanchored } : {}),
|
|
32
34
|
};
|
|
33
35
|
});
|
package/dist/core/peer-seat.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { SdkHttpError } from "@modelcontextprotocol/client";
|
|
2
2
|
import { type CredentialRef } from "@sema-agent/primitives";
|
|
3
3
|
import { type McpServerSpec, type McpTransportKind } from "./mcp-server-spec.js";
|
|
4
4
|
import type { ProtocolId } from "./protocol-table.js";
|
|
@@ -121,7 +121,7 @@ export declare class PeerSeatFailure extends Error {
|
|
|
121
121
|
/**
|
|
122
122
|
* An MCP HTTP request the endpoint refused for its authorization — a 401, or a 403 whose Bearer challenge says `insufficient_scope`
|
|
123
123
|
* (RFC 6750 §3.1) — raised by the one fetch ({@link peerFetch}) in place of the SDK's status error, which keeps no header. It IS the
|
|
124
|
-
* SDK's status error (same class, same `
|
|
124
|
+
* SDK's status error (same class, same `status`), so every structural reader of a status reads it unchanged; it adds what the response
|
|
125
125
|
* said and what the re-ask after a 401 answered:
|
|
126
126
|
* · `reason` — `rejected` (401) or `scope` (403);
|
|
127
127
|
* · `resourceMetadataUrl` — the Bearer challenge's `resource_metadata` ({@link bearerChallengeParams}), the REMOTE's claim, read by
|
|
@@ -133,7 +133,7 @@ export declare class PeerSeatFailure extends Error {
|
|
|
133
133
|
* The text is the engine's sentence followed by the response body as the SDK's own error would have carried it (bounded to
|
|
134
134
|
* {@link REFUSAL_BODY_MAX} characters) — REMOTE text, read by every face through the one remote-words reading like any status body.
|
|
135
135
|
*/
|
|
136
|
-
export declare class PeerAuthorizationRefused extends
|
|
136
|
+
export declare class PeerAuthorizationRefused extends SdkHttpError {
|
|
137
137
|
readonly reason: "rejected" | "scope";
|
|
138
138
|
readonly resourceMetadataUrl: string | undefined;
|
|
139
139
|
readonly authorizeUrl: string | undefined;
|
package/dist/core/peer-seat.js
CHANGED
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
2
|
import { types } from "node:util";
|
|
3
|
-
import {
|
|
3
|
+
import { SdkErrorCode, SdkHttpError } from "@modelcontextprotocol/client";
|
|
4
4
|
import { canonicalize } from "./canonical-json.js";
|
|
5
5
|
import { readCredentialRef } from "@sema-agent/primitives";
|
|
6
6
|
import { callerText } from "./mcp-server-spec.js";
|
|
7
|
+
import { optionKeys, strayMembersOf } from "./own-property-receipt.js";
|
|
7
8
|
import { readMember, readOwnMembers } from "./thrown-value.js";
|
|
8
9
|
import { httpTrimmed, resolveProtocolHttpHeaders } from "./protocol-http-auth.js";
|
|
9
10
|
import { credentialHeaderValues, holdOwnCredentialValues, isSecretEnvKey, namesASecret } from "./secret-env.js";
|
|
@@ -141,14 +142,15 @@ export class PeerSeatFailure extends Error {
|
|
|
141
142
|
this.code = extra?.code ?? (reason === "answer_invalid" ? "config.peer_answer_invalid" : undefined);
|
|
142
143
|
}
|
|
143
144
|
}
|
|
144
|
-
export class PeerAuthorizationRefused extends
|
|
145
|
+
export class PeerAuthorizationRefused extends SdkHttpError {
|
|
145
146
|
reason;
|
|
146
147
|
resourceMetadataUrl;
|
|
147
148
|
authorizeUrl;
|
|
148
149
|
renewed;
|
|
149
150
|
constructor(reason, facts) {
|
|
150
151
|
const lead = reason === "rejected" ? "the endpoint refused the request's authorization (HTTP 401)" : "the endpoint refused the request for insufficient scope (HTTP 403)";
|
|
151
|
-
|
|
152
|
+
const text = facts.body !== undefined && facts.body !== "" ? `${lead}: ${facts.body}` : lead;
|
|
153
|
+
super(reason === "rejected" ? SdkErrorCode.ClientHttpAuthentication : SdkErrorCode.ClientHttpForbidden, text, { status: reason === "rejected" ? 401 : 403 });
|
|
152
154
|
this.name = "PeerAuthorizationRefused";
|
|
153
155
|
this.reason = reason;
|
|
154
156
|
this.resourceMetadataUrl = facts.resourceMetadataUrl;
|
|
@@ -172,7 +174,10 @@ const VALUE_LAW = Object.freeze({
|
|
|
172
174
|
headers: Object.freeze({ refuses: /[^\t\x20-\x7e\x80-\xff]/, holds: "a character an HTTP header value cannot carry" }),
|
|
173
175
|
env: Object.freeze({ refuses: /[\r\n\0]|\p{Surrogate}/u, holds: "a line break, a NUL or a lone surrogate" }),
|
|
174
176
|
});
|
|
175
|
-
const ANSWER_MEMBERS = {
|
|
177
|
+
const ANSWER_MEMBERS = Object.freeze({
|
|
178
|
+
carry: optionKeys()({ kind: 0, headers: 0, env: 0, expiresAt: 0 }),
|
|
179
|
+
unauthorized: optionKeys()({ kind: 0, authorizeUrl: 0 }),
|
|
180
|
+
});
|
|
176
181
|
const digestOf = (pieces) => {
|
|
177
182
|
const rows = (m) => Object.entries(m ?? {}).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
|
|
178
183
|
return createHash("sha256").update(JSON.stringify([rows(pieces.headers), rows(pieces.env)])).digest("hex");
|
|
@@ -210,9 +215,9 @@ export function readPeerAnswer(raw, lane) {
|
|
|
210
215
|
const kind = memberOf("kind");
|
|
211
216
|
if (kind !== "carry" && kind !== "unauthorized")
|
|
212
217
|
return { problem: `answered the kind ${inlineUntrusted(JSON.stringify(kind) ?? String(kind), 80)}, which is neither "carry" nor "unauthorized"` };
|
|
213
|
-
const extra =
|
|
218
|
+
const extra = strayMembersOf(record, { subject: "the peer seat's answer", unit: "member", moment: "when the answer is read" }, ANSWER_MEMBERS[kind])?.names[0];
|
|
214
219
|
if (extra !== undefined)
|
|
215
|
-
return { problem: `answered the member ${inlineUntrusted(JSON.stringify(extra), 80)}, which a "${kind}" answer does not have` };
|
|
220
|
+
return { problem: `answered the member ${inlineUntrusted(JSON.stringify(String(extra)), 80)}, which a "${kind}" answer does not have` };
|
|
216
221
|
if (kind === "unauthorized") {
|
|
217
222
|
const given = memberOf("authorizeUrl");
|
|
218
223
|
if (given === undefined)
|
|
@@ -480,7 +485,7 @@ export function peerFetch(carrier, principalHeader, principal) {
|
|
|
480
485
|
return res;
|
|
481
486
|
const challenge = bearerChallengeParams(res.headers.get("www-authenticate"));
|
|
482
487
|
if (res.status === 403 && challenge?.get("error") !== "insufficient_scope")
|
|
483
|
-
return res;
|
|
488
|
+
return unchallenged(res);
|
|
484
489
|
const resourceMetadataUrl = authorizationUrlOf(challenge?.get("resource_metadata"));
|
|
485
490
|
const body = init?.method === "POST" ? await bodyHead(res, REFUSAL_BODY_MAX) : void (await res.body?.cancel().catch(() => undefined));
|
|
486
491
|
const reask = res.status === 401 ? await carrier.rejected(pieces, signal) : undefined;
|
|
@@ -492,6 +497,13 @@ export function peerFetch(carrier, principalHeader, principal) {
|
|
|
492
497
|
});
|
|
493
498
|
};
|
|
494
499
|
}
|
|
500
|
+
function unchallenged(res) {
|
|
501
|
+
if (!res.headers.has("www-authenticate"))
|
|
502
|
+
return res;
|
|
503
|
+
const headers = new Headers(res.headers);
|
|
504
|
+
headers.delete("www-authenticate");
|
|
505
|
+
return new Response(res.body, { status: res.status, statusText: res.statusText, headers });
|
|
506
|
+
}
|
|
495
507
|
export const RETIRED_VALUE_MEMBERS = Object.freeze({ mcp: Object.freeze([Object.freeze(["transport", "headers"]), Object.freeze(["transport", "env"])]), a2a: Object.freeze([Object.freeze(["headers"])]) });
|
|
496
508
|
export function retiredValueMember(copy, at) {
|
|
497
509
|
for (const path of RETIRED_VALUE_MEMBERS[at]) {
|
|
@@ -535,7 +547,7 @@ export function mcpPeerTarget(spec, kind) {
|
|
|
535
547
|
export function answeredUnauthorized(err) {
|
|
536
548
|
let at = err;
|
|
537
549
|
for (let depth = 0; depth < 6 && at instanceof Error; depth++) {
|
|
538
|
-
if (at instanceof
|
|
550
|
+
if (at instanceof SdkHttpError && at.status === 401)
|
|
539
551
|
return true;
|
|
540
552
|
at = at.cause;
|
|
541
553
|
}
|
|
@@ -546,14 +546,22 @@ export declare function redeemRuleTicket(opts: {
|
|
|
546
546
|
export declare const IMPORTED_SETTINGS_LAYERS: readonly ["userSettings", "projectSettings", "localSettings"];
|
|
547
547
|
/** The three user-editable settings layers this version reads. */
|
|
548
548
|
export type ImportedSettingsLayer = (typeof IMPORTED_SETTINGS_LAYERS)[number];
|
|
549
|
-
/** One layer to read
|
|
550
|
-
*
|
|
551
|
-
|
|
552
|
-
|
|
549
|
+
/** One layer to read — a union by `layer`, so a member is present exactly where it is read. A project or local layer
|
|
550
|
+
* carries `root`: the canonical directory its rules are scoped to, taken from where the FILE actually lives, since the
|
|
551
|
+
* local layer is not always at a repository root. The user layer carries none — a root handed for it does not compile:
|
|
552
|
+
* its rules import as global rules, which read `/x` at each task's project root, so nothing here reads that layer's own
|
|
553
|
+
* directory, and an entry written against it stays in the settings file ({@link prepareCcImport}). */
|
|
554
|
+
export type CcImportLayer = {
|
|
555
|
+
layer: "userSettings";
|
|
556
|
+
path: string;
|
|
557
|
+
root?: never;
|
|
558
|
+
readFile: (path: string) => Promise<string | undefined>;
|
|
559
|
+
} | {
|
|
560
|
+
layer: Exclude<ImportedSettingsLayer, "userSettings">;
|
|
553
561
|
path: string;
|
|
554
562
|
root: string;
|
|
555
563
|
readFile: (path: string) => Promise<string | undefined>;
|
|
556
|
-
}
|
|
564
|
+
};
|
|
557
565
|
/**
|
|
558
566
|
* What the import WOULD do, shown before anyone confirms.
|
|
559
567
|
*
|
|
@@ -627,6 +635,14 @@ export type RedeemedBatchMember = {
|
|
|
627
635
|
* being escorted by a shell into a bare tool-name ask that widens `Bash(rm -r:*)` into "every Bash call
|
|
628
636
|
* asks". An entry that does not import (a spelling with no rule form, a tool the lane does not speak
|
|
629
637
|
* for, a non-string) is DISCLOSED in `skipped` with its reason and stays in the settings file.
|
|
638
|
+
*
|
|
639
|
+
* Only a rule the store reads the way its layer does is carried. A bare tool name is not (`unsupported.form`), and
|
|
640
|
+
* neither is a user-layer path pattern written from `/` (`unsupported.layer_root`, every behavior): the user layer reads
|
|
641
|
+
* it at its own directory (the configuration directory), a stored global rule reads `/x` at each task's project root, and
|
|
642
|
+
* no stored row has a seat for the layer's directory. `//abs`, `~/`, relative and non-path entries of the user layer carry
|
|
643
|
+
* as global rules; a project or local layer's `/x` carries, scoped to that layer's `root` (a project row reads `/x` there).
|
|
644
|
+
* A user layer handed a `root` refuses the whole call before any layer is read (`config.invalid_argument`, `detail.field`
|
|
645
|
+
* `layers[<i>].root`; the value is not echoed).
|
|
630
646
|
*/
|
|
631
647
|
export declare function prepareCcImport(opts: {
|
|
632
648
|
layers: CcImportLayer[];
|
|
@@ -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,8 +786,22 @@ 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
807
|
const layers = [];
|
|
@@ -860,6 +876,10 @@ export async function prepareCcImport(opts) {
|
|
|
860
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" });
|
|
861
877
|
continue;
|
|
862
878
|
}
|
|
879
|
+
if (!importCarries(scope, parsed.rule)) {
|
|
880
|
+
skipped.push({ rule: entry, reason: LAYER_ROOT_SKIP_REASON });
|
|
881
|
+
continue;
|
|
882
|
+
}
|
|
863
883
|
if (candidates.some((c) => c.behavior === behavior && c.rule === parsed.rule.rule && sameScope(c.scope, scope)))
|
|
864
884
|
continue;
|
|
865
885
|
candidates.push({ behavior, rule: parsed.rule.rule, scope });
|
|
@@ -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"
|
|
@@ -10,7 +10,7 @@ import { carriesShellRedirection, parseLeadingCommandName, splitShellCompoundSeg
|
|
|
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
|
}
|
|
@@ -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;
|
|
@@ -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) {
|