@sema-agent/core 7.60.0 → 7.62.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 +917 -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 +71 -12
- package/dist/agents/cascade.js +61 -21
- 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-held-queue.d.ts +27 -4
- package/dist/agents/peer-held-queue.js +81 -36
- 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 +49 -10
- 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 +36 -41
- package/dist/agents/subagent.js +245 -200
- package/dist/agents/suspend-guard.d.ts +47 -16
- package/dist/agents/suspend-guard.js +13 -4
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +41 -30
- 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-features.d.ts +722 -0
- package/dist/core/checkpoint-features.js +98 -0
- package/dist/core/checkpoint-requirements.d.ts +33 -5
- package/dist/core/checkpoint-requirements.js +18 -5
- package/dist/core/checkpoint-row-verdict.d.ts +99 -0
- package/dist/core/checkpoint-row-verdict.js +225 -0
- package/dist/core/checkpoint-store.d.ts +107 -738
- package/dist/core/checkpoint-store.js +45 -143
- 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 +68 -21
- package/dist/core/engine-notice.js +9 -2
- 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 +4 -3
- 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 +14 -4
- package/dist/core/governance-codes.js +19 -4
- package/dist/core/hooks.d.ts +25 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/human-input-projection.d.ts +1 -0
- package/dist/core/human-input-projection.js +3 -0
- package/dist/core/image-admission.d.ts +47 -7
- 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 +4 -3
- 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 +225 -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-driver.d.ts +1 -1
- 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/memory-vector.d.ts +1 -1
- package/dist/core/memory.d.ts +10 -10
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +8 -6
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/classic-events.d.ts +9 -1
- package/dist/core/mods/dollar.d.ts +94 -1
- package/dist/core/mods/dollar.js +13 -1
- 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 +14 -3
- package/dist/core/mods/kernel/events.js +18 -15
- 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 +36 -4
- package/dist/core/mods/lifecycle-stations.js +44 -9
- package/dist/core/mods/session-append.d.ts +118 -0
- package/dist/core/mods/session-append.js +318 -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 +138 -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 +88 -21
- package/dist/core/mods/stations.js +149 -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 +68 -2
- package/dist/core/own-property-receipt.js +45 -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/read-root-candidate.js +1 -1
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/resume-startup-cause.d.ts +5 -4
- 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 +18 -3
- 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 +116 -34
- 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/delegation-owner.d.ts +43 -0
- package/dist/core/runner/delegation-owner.js +59 -0
- 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/lineage-reroot-view.d.ts +56 -0
- package/dist/core/runner/lineage-reroot-view.js +108 -0
- 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 +7 -2
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.d.ts +15 -0
- package/dist/core/runner/person-path-rows.js +27 -4
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
- package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
- 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 +3 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
- package/dist/core/runner/prepare-config-doors.d.ts +6 -6
- package/dist/core/runner/prepare-config-doors.js +19 -21
- 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 +6 -6
- package/dist/core/runner/prepare-hands-readface.js +32 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
- package/dist/core/runner/prepare-inherited-gate.js +10 -3
- 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 +61 -30
- 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 +8 -6
- package/dist/core/runner/resume-admission.js +23 -6
- package/dist/core/runner/resume-apply.d.ts +4 -0
- package/dist/core/runner/resume-apply.js +14 -5
- package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
- package/dist/core/runner/resume-checkpoint-screen.js +4 -84
- 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.d.ts +2 -0
- package/dist/core/runner/run-git-lane.js +6 -2
- package/dist/core/runner/run-harness-handlers.d.ts +2 -0
- package/dist/core/runner/run-harness-handlers.js +5 -4
- 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 +64 -36
- 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 +12 -9
- package/dist/core/runner/run-stop-and-final-verify.js +2 -1
- 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 +34 -18
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +33 -17
- 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/steering-preview.d.ts +9 -0
- package/dist/core/runner/steering-preview.js +5 -0
- 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 +16 -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-face-overlay.js +2 -0
- 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 +8 -2
- package/dist/core/runner/turn-attachments.js +2 -2
- 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 +26 -27
- package/dist/core/secret-env.d.ts +19 -16
- package/dist/core/secret-env.js +45 -27
- 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 +3 -1
- package/dist/core/session-store.js +10 -8
- package/dist/core/session.d.ts +16 -5
- 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 +8 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +83 -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/session-store-contract.js +22 -8
- 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 +24 -9
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +89 -14
- package/dist/core/task-registry-agent.d.ts +32 -50
- package/dist/core/task-registry-agent.js +36 -56
- 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 +22 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +5 -21
- package/dist/core/task-registry.d.ts +32 -62
- package/dist/core/task-registry.js +30 -110
- package/dist/core/task-result.d.ts +29 -12
- 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 +11 -11
- 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 +36 -6
- 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 +8 -5
- package/dist/core/tool-face.js +1 -1
- 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 +109 -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-roster.d.ts +4 -4
- package/dist/core/tool-spec.d.ts +23 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/types.d.ts +1 -1
- package/dist/core/types.js +1 -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 +37 -9
- package/dist/engine/execution-env/node-execution-env.js +221 -22
- 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 +52 -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/engine/session/parent-chain-guard.d.ts +3 -3
- package/dist/engine/session/parent-chain-guard.js +1 -1
- package/dist/engine/session/path-to-root.d.ts +18 -3
- package/dist/engine/session/path-to-root.js +15 -1
- package/dist/engine/session/repo-utils.d.ts +12 -1
- package/dist/engine/session/repo-utils.js +41 -0
- package/dist/engine/session/session.js +1 -1
- package/dist/engine/session/storage-base.d.ts +20 -0
- package/dist/engine/session/storage-base.js +28 -9
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +29 -18
- package/dist/index.js +19 -11
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/harness.d.ts +4 -3
- package/dist/internal/harness.js +3 -2
- 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 +14 -17
- package/dist/orchestration/run-workflow-tool.js +43 -50
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +7 -0
- package/dist/orchestration/workflow.js +10 -12
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.d.ts +2 -0
- package/dist/stores/file/checkpoint-store.js +13 -9
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/fs-atomic.d.ts +0 -22
- package/dist/stores/file/fs-atomic.js +0 -17
- package/dist/stores/file/index.d.ts +7 -12
- package/dist/stores/file/index.js +25 -12
- 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 +26 -7
- package/dist/stores/file/session-store.js +59 -35
- 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/bash-program-position.d.ts +3 -2
- package/dist/tools/fs/bash-program-position.js +7 -7
- 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/removal-targets.js +2 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-argv.d.ts +4 -2
- package/dist/tools/fs/shell-read-argv.js +14 -3
- package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
- package/dist/tools/fs/shell-read-bindings.js +148 -68
- package/dist/tools/fs/shell-read-check.js +20 -4
- package/dist/tools/fs/shell-read-establish.js +25 -9
- package/dist/tools/fs/shell-read-functions.js +2 -2
- 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/fs/shell-read-object-path.d.ts +59 -0
- package/dist/tools/fs/shell-read-object-path.js +119 -0
- package/dist/tools/fs/shell-read-plan.d.ts +8 -0
- package/dist/tools/fs/shell-read-plan.js +47 -30
- package/dist/tools/fs/shell-read-start.d.ts +66 -13
- package/dist/tools/fs/shell-read-start.js +89 -17
- package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
- package/dist/tools/fs/shell-read-workdir.js +31 -8
- 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 +112 -42
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core-stores-sql@7.62.0.json +30 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/core@7.62.0.json +2181 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/mods-kernel@7.62.0.json +42 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/wire-changes/primitives@7.62.0.json +30 -0
- package/dist/core/consolidate-scope.d.ts +0 -93
- package/dist/core/consolidate-scope.js +0 -98
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
- package/dist/core/runner/memory-consolidation.d.ts +0 -109
- package/dist/core/runner/memory-consolidation.js +0 -251
|
@@ -3,6 +3,7 @@ import type { ExecutionEnv } from "../../internal/harness-types.js";
|
|
|
3
3
|
import { type FsViolation, type ReadEntry, type ReadFileState } from "./safety.js";
|
|
4
4
|
import { type DecodedTextFile, type MalformedBody } from "./encoding.js";
|
|
5
5
|
import { type HomeViewsCarrier } from "./read-deny-home.js";
|
|
6
|
+
import type { ImageDownsampler } from "../../core/image-downsample.js";
|
|
6
7
|
import { type EngineNotice } from "../../core/types.js";
|
|
7
8
|
/**
|
|
8
9
|
* The "hand" tool band — built per task over an injected {@link ExecutionEnv} and a per-task
|
|
@@ -121,6 +122,30 @@ export declare function notReadRefusalText(env: ExecutionEnv, toolName: string,
|
|
|
121
122
|
* leaving the caller to guess that the limit is negotiable. Appended ONLY on the no-processor
|
|
122
123
|
* branch: with a processor already resolved the hint would be false advice. */
|
|
123
124
|
export declare const NO_DOWNSAMPLER_IMAGE_CAP_HINT: string;
|
|
125
|
+
/** The same refusal when the deployment itself set the processor seat to `false`: installing sharp changes nothing there,
|
|
126
|
+
* so naming it would be a wrong cause. */
|
|
127
|
+
export declare const IMAGE_PROCESSOR_OFF_CAP_HINT: string;
|
|
128
|
+
/** The one place the processor seat's three states pick the no-processor refusal's second sentence: `false` (the deployment
|
|
129
|
+
* turned it off) says so, absent (nothing resolved, so an install is the move) names the optional dependency, and a processor
|
|
130
|
+
* never reaches here — a resolved processor takes no hint. */
|
|
131
|
+
export declare function noProcessorImageCapHint(seat: ImageDownsampler | false | undefined): string;
|
|
132
|
+
/**
|
|
133
|
+
* The sentence a ran-then-cut Bash result ends with when it holds no captured output at all. The execution environment either STATED
|
|
134
|
+
* what it captured before the cut (a string for each of `partialStdout` / `partialStderr`, empty or not) or attached nothing: only the
|
|
135
|
+
* first can say the command wrote nothing, and the second says nothing about it — reading both as "" made a silence nobody observed.
|
|
136
|
+
*
|
|
137
|
+
* With the capture stated, a LONG-lived process that wrote nothing to its stdio is a real, examined phenomenon (capture chain proven
|
|
138
|
+
* live in and out of containers) — the honest reading is "stalled before producing output, or holding it in a block buffer", and saying
|
|
139
|
+
* so turns a dead-end disclosure into an actionable lead. Only on the timeout arm with a substantial window (>= 60s): a short window's
|
|
140
|
+
* silence is ordinary, and the aborted/callback arms don't know how long the process actually lived. A silence cut is the same
|
|
141
|
+
* phenomenon seen from the other side, and its window is by definition the substantial one — no minimum applies; the number is the
|
|
142
|
+
* window, never the request.
|
|
143
|
+
*/
|
|
144
|
+
export declare function zeroOutputSentence(error: {
|
|
145
|
+
code: string;
|
|
146
|
+
partialStdout?: string;
|
|
147
|
+
partialStderr?: string;
|
|
148
|
+
}, timeoutSec: number, noOutputSec: number | undefined): string;
|
|
124
149
|
/** Output-token cap as a char proxy (CC's 25000, at ~4 chars/token). Caps the shown body so 2000 very
|
|
125
150
|
* long lines cannot blow the context budget.
|
|
126
151
|
*
|
|
@@ -256,7 +281,7 @@ export declare function coerceWriteArguments(args: unknown): unknown;
|
|
|
256
281
|
* marker, because the head AND tail both matter for a shell. Kept as the inline shape even beside the
|
|
257
282
|
* file-backed recovery below — unlike a background task's poll-for-the-latest-tail interaction, a
|
|
258
283
|
* foreground command's head can carry status a bare tail-keep would drop. Shared by runShell
|
|
259
|
-
* (foreground)
|
|
284
|
+
* (foreground). Delegates its arithmetic to the shared
|
|
260
285
|
* {@link clipWithFilePointer} but never exercises its pointer arm — no caller here passes a path. */
|
|
261
286
|
export declare function clipShellOutput(s: string): string;
|
|
262
287
|
/**
|
|
@@ -271,12 +296,12 @@ export declare function clipShellOutput(s: string): string;
|
|
|
271
296
|
* fired, so nothing here overclaims completeness beyond what the text itself already discloses. Purely
|
|
272
297
|
* ADDITIVE: the inline head+tail framing above is untouched; this only gives the model a second, explicit
|
|
273
298
|
* route to the bytes that framing dropped. Writes BOTH streams (not just the one that overflowed) to ONE
|
|
274
|
-
* combined file — same shape
|
|
299
|
+
* combined file — same shape a background command's A5 output file uses (`stdout + stderr`, single pointer) — so the
|
|
275
300
|
* model gets one path regardless of which stream tripped the clip. Uses `env.createTempFile`/`writeFile`/
|
|
276
301
|
* `canonicalPath` — the standard `FileSystem` primitives every {@link ExecutionEnv} backend implements —
|
|
277
302
|
* NOT the Node env's internal exec spool, so this works uniformly across backends, not just the Node adapter.
|
|
278
303
|
*
|
|
279
|
-
* Deliberately NOT wired into the Read-tool root-fence exemption (unlike
|
|
304
|
+
* Deliberately NOT wired into the Read-tool root-fence exemption (unlike a background command's A5 file): that
|
|
280
305
|
* exemption is keyed off a TaskRegistry `background_bash` row with a live lifecycle (owner/scope/session
|
|
281
306
|
* visibility, membership dies with the row) — a one-shot foreground command has no such row, and building
|
|
282
307
|
* one purely to carry a read-exemption would be a parallel, un-owned lifecycle with no natural teardown.
|
|
@@ -65,6 +65,21 @@ export async function notReadRefusalText(env, toolName, key, v, signal, fallback
|
|
|
65
65
|
return fallbackHint === undefined ? base : `${base} ${fallbackHint}`;
|
|
66
66
|
}
|
|
67
67
|
export const NO_DOWNSAMPLER_IMAGE_CAP_HINT = `Install the optional "sharp" dependency (declared in this package's optionalDependencies) to read images up to ${IMAGE_ADMISSION.hard.readBytes.withProcessor} bytes — it downsamples them to fit the API image limit.`;
|
|
68
|
+
export const IMAGE_PROCESSOR_OFF_CAP_HINT = `This deployment turned the image processor off: images are not downsampled and are read only up to ${IMAGE_ADMISSION.hard.readBytes.withoutProcessor} bytes — shrink the image first, e.g. with an image tool run in the shell.`;
|
|
69
|
+
export function noProcessorImageCapHint(seat) {
|
|
70
|
+
return seat === false ? IMAGE_PROCESSOR_OFF_CAP_HINT : NO_DOWNSAMPLER_IMAGE_CAP_HINT;
|
|
71
|
+
}
|
|
72
|
+
export function zeroOutputSentence(error, timeoutSec, noOutputSec) {
|
|
73
|
+
if (error.partialStdout === undefined || error.partialStderr === undefined) {
|
|
74
|
+
return "(the execution environment attached no partial output for this cutoff, so whether the command wrote anything before it is not known)";
|
|
75
|
+
}
|
|
76
|
+
const hint = error.code === "liveness_no_output"
|
|
77
|
+
? ` — the process wrote nothing to its stdio for ${noOutputSec !== undefined ? `the whole ${noOutputSec}s window` : "the whole window"}; it may have been stalled before producing output, or holding it in a block buffer`
|
|
78
|
+
: error.code === "timeout" && timeoutSec >= 60
|
|
79
|
+
? ` — the process ran the full ${timeoutSec}s without writing to its stdio; it may have been stalled before producing output, or holding it in a block buffer`
|
|
80
|
+
: "";
|
|
81
|
+
return `(no output was produced before the cutoff${hint})`;
|
|
82
|
+
}
|
|
68
83
|
export const MAX_READ_OUTPUT_CHARS = 100_000;
|
|
69
84
|
export const BASH_DEFAULT_TIMEOUT_SEC = 120;
|
|
70
85
|
export const BASH_MAX_TIMEOUT_SEC = 600;
|
package/dist/tools/fs/index.d.ts
CHANGED
|
@@ -84,7 +84,7 @@ export interface HandsToolkitOptions {
|
|
|
84
84
|
* receipts) and stamped onto every background row Bash registers (stated). Absent ⇒ not stated: the rows
|
|
85
85
|
* leave the lane to the owning run's teardown. */
|
|
86
86
|
retainBackgroundProcesses?: boolean;
|
|
87
|
-
/** Mount
|
|
87
|
+
/** Mount TaskStop directly from this band (with a registry). Runner sets false and mounts it on the delegation surface once. */
|
|
88
88
|
mountBackgroundTaskTools?: boolean;
|
|
89
89
|
/** Completion-notification sink for finished background commands (threaded to createBashTool's
|
|
90
90
|
* onTaskNotification; the Runner wires the run-local injection lane here). */
|
package/dist/tools/fs/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { deliverEngineNotice } from "../../core/types.js";
|
|
2
|
-
import {
|
|
2
|
+
import { createTaskStopTool } from "../../core/task-registry.js";
|
|
3
3
|
import { hasBackgroundShell } from "../../core/background-shell.js";
|
|
4
4
|
import {} from "./safety.js";
|
|
5
5
|
import { createRepoMapTool } from "./repo-map.js";
|
|
@@ -24,7 +24,7 @@ import {} from "./fs-shared.js";
|
|
|
24
24
|
import { createModelFileReader, createReadFileTool } from "./fs-read.js";
|
|
25
25
|
import { createEditFileTool, createWriteFileTool, createNotebookEditTool } from "./fs-write.js";
|
|
26
26
|
import { createGrepTool, createGlobTool } from "./fs-search-tools.js";
|
|
27
|
-
import { createBashTool, createBashReadonlyTool
|
|
27
|
+
import { createBashTool, createBashReadonlyTool } from "./fs-bash.js";
|
|
28
28
|
export function handsWriteHalfMounts(opts) {
|
|
29
29
|
return opts.readOnly !== true;
|
|
30
30
|
}
|
|
@@ -122,19 +122,9 @@ export function createHandsToolkit(env, readFileState, rootCanonical, opts = {})
|
|
|
122
122
|
...(opts.monitorToolActive !== undefined ? { monitorToolActive: opts.monitorToolActive } : {}),
|
|
123
123
|
...(opts.reminderMark !== undefined ? { reminderMark: opts.reminderMark } : {}),
|
|
124
124
|
})));
|
|
125
|
-
if (!readOnly && mountBackgroundTaskTools && hasBackgroundShell(env)) {
|
|
125
|
+
if (!readOnly && mountBackgroundTaskTools && hasBackgroundShell(env) && opts.taskRegistry !== undefined) {
|
|
126
126
|
const sessionAxis = opts.sessionId !== undefined ? { sessionId: opts.sessionId } : {};
|
|
127
|
-
tools.push(opts.taskRegistry
|
|
128
|
-
? createTaskOutputTool({
|
|
129
|
-
registry: opts.taskRegistry,
|
|
130
|
-
owner: opts.taskOwner,
|
|
131
|
-
scope: opts.taskScope,
|
|
132
|
-
...sessionAxis,
|
|
133
|
-
notificationWired: opts.taskNotification !== undefined,
|
|
134
|
-
})
|
|
135
|
-
: createEnvTaskOutputTool(env), opts.taskRegistry
|
|
136
|
-
? createTaskStopTool({ registry: opts.taskRegistry, owner: opts.taskOwner, scope: opts.taskScope, ...sessionAxis })
|
|
137
|
-
: createEnvTaskStopTool(env));
|
|
127
|
+
tools.push(createTaskStopTool({ registry: opts.taskRegistry, owner: opts.taskOwner, scope: opts.taskScope, ...sessionAxis }));
|
|
138
128
|
}
|
|
139
129
|
}
|
|
140
130
|
return tools;
|
package/dist/tools/fs/pdf.d.ts
CHANGED
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
* sema follows the same shape with the ExecutionEnv seam (works against remote envs too) and honest
|
|
16
16
|
* degradation when poppler is absent — never a fake success.
|
|
17
17
|
*/
|
|
18
|
-
import type { ExecutionEnv } from "../../internal/harness-types.js";
|
|
18
|
+
import type { ExecutionEnv, ReadFloor } from "../../internal/harness-types.js";
|
|
19
19
|
/** Max pages a single `pages` request may span (CC `PDF_MAX_PAGES_PER_READ`). */
|
|
20
20
|
export declare const PDF_MAX_PAGES_PER_READ = 20;
|
|
21
21
|
/** Above this page count a whole-PDF read is refused and `pages` is required (CC `PDF_AT_MENTION_INLINE_THRESHOLD`). */
|
|
@@ -48,7 +48,7 @@ export declare function previewExecStream(s: string): string;
|
|
|
48
48
|
* when the tool is absent/fails and the bytes were already read. `undefined` = unknown (fail-open,
|
|
49
49
|
* matching CC's `getPDFPageCount → null`).
|
|
50
50
|
*/
|
|
51
|
-
export declare function getPdfPageCount(env: ExecutionEnv, absPath: string, bytes: Uint8Array | undefined, signal?: AbortSignal): Promise<number | undefined>;
|
|
51
|
+
export declare function getPdfPageCount(env: ExecutionEnv, absPath: string, bytes: Uint8Array | undefined, signal?: AbortSignal, readFloor?: ReadFloor): Promise<number | undefined>;
|
|
52
52
|
/** How many leading pages the vision fallback (level 2) renders for a whole-PDF read on a model without
|
|
53
53
|
* document input — conservative per-request budget; the note directs the model to `pages` for more. */
|
|
54
54
|
export declare const PDF_FALLBACK_RENDER_PAGES = 5;
|
|
@@ -110,7 +110,7 @@ export type PdfTextResult = {
|
|
|
110
110
|
export declare function extractPdfTextLayer(env: ExecutionEnv, absPath: string, range?: {
|
|
111
111
|
first: number;
|
|
112
112
|
last: number;
|
|
113
|
-
}, signal?: AbortSignal): Promise<PdfTextResult>;
|
|
113
|
+
}, signal?: AbortSignal, readFloor?: ReadFloor): Promise<PdfTextResult>;
|
|
114
114
|
export type PdfExtractResult = {
|
|
115
115
|
ok: true;
|
|
116
116
|
pages: Array<{
|
|
@@ -131,4 +131,4 @@ export type PdfExtractResult = {
|
|
|
131
131
|
* 120s timeout). Runs through the ExecutionEnv seam (temp dir + exec + readBinaryFile), so it works
|
|
132
132
|
* wherever the env does. `toolMissing` distinguishes "install poppler" from a real extraction failure.
|
|
133
133
|
*/
|
|
134
|
-
export declare function extractPdfPagesAsImages(env: ExecutionEnv, absPath: string, first: number, last: number, signal?: AbortSignal): Promise<PdfExtractResult>;
|
|
134
|
+
export declare function extractPdfPagesAsImages(env: ExecutionEnv, absPath: string, first: number, last: number, signal?: AbortSignal, readFloor?: ReadFloor): Promise<PdfExtractResult>;
|
package/dist/tools/fs/pdf.js
CHANGED
|
@@ -33,9 +33,9 @@ export function previewExecStream(s) {
|
|
|
33
33
|
? `${s.slice(0, PDF_EXEC_ERROR_PREVIEW_CHARS)} …[${s.length - PDF_EXEC_ERROR_PREVIEW_CHARS} chars truncated]`
|
|
34
34
|
: s;
|
|
35
35
|
}
|
|
36
|
-
export async function getPdfPageCount(env, absPath, bytes, signal) {
|
|
36
|
+
export async function getPdfPageCount(env, absPath, bytes, signal, readFloor) {
|
|
37
37
|
try {
|
|
38
|
-
const r = await env.exec(`pdfinfo ${shellQuote(absPath)}`, { timeout: 10, abortSignal: signal });
|
|
38
|
+
const r = await env.exec(`pdfinfo ${shellQuote(absPath)}`, { timeout: 10, abortSignal: signal, ...(readFloor !== undefined ? { readFloor } : {}) });
|
|
39
39
|
if (r.ok && r.value.exitCode === 0) {
|
|
40
40
|
const m = /^Pages:\s+(\d+)/m.exec(r.value.stdout);
|
|
41
41
|
if (m) {
|
|
@@ -67,7 +67,7 @@ export function pdfCutWords(cut) {
|
|
|
67
67
|
return { clause: `timed out after ${cut.sec}s`, noun: "timeout" };
|
|
68
68
|
return { clause: cut.sec !== undefined ? `was cut after producing no output for ${cut.sec}s` : "was cut for producing no output", noun: "cut" };
|
|
69
69
|
}
|
|
70
|
-
export async function extractPdfTextLayer(env, absPath, range, signal) {
|
|
70
|
+
export async function extractPdfTextLayer(env, absPath, range, signal, readFloor) {
|
|
71
71
|
const tmp = await env.createTempDir("sema-pdf-text-", signal);
|
|
72
72
|
if (!tmp.ok)
|
|
73
73
|
return { ok: false, toolMissing: false, error: `cannot create a temp dir for text extraction: ${tmp.error.message}` };
|
|
@@ -78,7 +78,7 @@ export async function extractPdfTextLayer(env, absPath, range, signal) {
|
|
|
78
78
|
return { ok: false, toolMissing: false, error: outR.error.message };
|
|
79
79
|
const rangeArgs = range ? `-f ${range.first} -l ${range.last} ` : "";
|
|
80
80
|
const cmd = `pdftotext -layout ${rangeArgs}${shellQuote(absPath)} ${shellQuote(outR.value)}`;
|
|
81
|
-
const r = await env.exec(cmd, { timeout: PDF_EXEC_TIMEOUT_SEC, abortSignal: signal });
|
|
81
|
+
const r = await env.exec(cmd, { timeout: PDF_EXEC_TIMEOUT_SEC, abortSignal: signal, ...(readFloor !== undefined ? { readFloor } : {}) });
|
|
82
82
|
if (!r.ok) {
|
|
83
83
|
if (isTimeCutCode(r.error.code)) {
|
|
84
84
|
const cut = cutOf(r.error);
|
|
@@ -125,7 +125,7 @@ async function listRenderedJpegs(env, dir, signal) {
|
|
|
125
125
|
.sort(),
|
|
126
126
|
};
|
|
127
127
|
}
|
|
128
|
-
export async function extractPdfPagesAsImages(env, absPath, first, last, signal) {
|
|
128
|
+
export async function extractPdfPagesAsImages(env, absPath, first, last, signal, readFloor) {
|
|
129
129
|
const tmp = await env.createTempDir("sema-pdf-pages-", signal);
|
|
130
130
|
if (!tmp.ok)
|
|
131
131
|
return { ok: false, toolMissing: false, error: `cannot create a temp dir for page extraction: ${tmp.error.message}` };
|
|
@@ -135,7 +135,7 @@ export async function extractPdfPagesAsImages(env, absPath, first, last, signal)
|
|
|
135
135
|
if (!prefixR.ok)
|
|
136
136
|
return { ok: false, toolMissing: false, error: prefixR.error.message };
|
|
137
137
|
const cmd = `pdftoppm -jpeg -r 100 -f ${first} -l ${last} ${shellQuote(absPath)} ${shellQuote(prefixR.value)}`;
|
|
138
|
-
const r = await env.exec(cmd, { timeout: PDF_EXEC_TIMEOUT_SEC, abortSignal: signal });
|
|
138
|
+
const r = await env.exec(cmd, { timeout: PDF_EXEC_TIMEOUT_SEC, abortSignal: signal, ...(readFloor !== undefined ? { readFloor } : {}) });
|
|
139
139
|
if (!r.ok) {
|
|
140
140
|
if (isTimeCutCode(r.error.code)) {
|
|
141
141
|
const cut = cutOf(r.error);
|
|
@@ -390,6 +390,9 @@ export function readDenyOver(current, homeViews) {
|
|
|
390
390
|
unexcludableUnder: (scope) => current().unexcludableUnder?.(scope) ?? false,
|
|
391
391
|
rowUnderRoot: (scope) => current().rowUnderRoot?.(scope) ?? null,
|
|
392
392
|
rowAtOrBelow: (path) => current().rowAtOrBelow?.(path) ?? null,
|
|
393
|
+
get compiledSegments() {
|
|
394
|
+
return current().compiledSegments;
|
|
395
|
+
},
|
|
393
396
|
homeViews: homeViews ?? { views: (signal) => current().homeViews.views(signal) },
|
|
394
397
|
};
|
|
395
398
|
}
|
|
@@ -411,7 +414,11 @@ export function homeViewsOf(env, judge, signal) {
|
|
|
411
414
|
return (judge?.homeViews ?? homeViewsAt(env, [])).views(signal, env);
|
|
412
415
|
}
|
|
413
416
|
export function carryHomeViews(judge, source) {
|
|
414
|
-
|
|
417
|
+
const carried = { ...judge, homeViews: source };
|
|
418
|
+
const id = judge.id;
|
|
419
|
+
if (typeof id === "string")
|
|
420
|
+
Object.defineProperty(carried, "id", { value: id, enumerable: false });
|
|
421
|
+
return carried;
|
|
415
422
|
}
|
|
416
423
|
export async function placeReadDenyAtHome(env, compile, homes, signal, configRoot) {
|
|
417
424
|
const entries = compile([]).entries;
|
|
@@ -85,6 +85,17 @@ export interface PathRuleDenyRow {
|
|
|
85
85
|
* A leg judges the row where that location LEADS too ({@link withRuleRowsWhereTheyLead}). Absent on a hand-built
|
|
86
86
|
* row, or one whose head cannot be read: it is judged as spelled. */
|
|
87
87
|
readonly head?: string;
|
|
88
|
+
/** The row's reach as a shape an OS confinement translates (the rule model's `pathRuleReachShapeOf`): the absolute
|
|
89
|
+
* location the resolved pattern starts at (`at`, the identity spelling, `/` for the root) and the glob segments after it
|
|
90
|
+
* (`*` within a segment, `**` across segments) — the row reaches every path whose segments below `at` match the globs as
|
|
91
|
+
* a PREFIX (the path the pattern names, and everything below it). Absent on a hand-built row or one whose pattern cannot
|
|
92
|
+
* be resolved: a confinement cannot express it, and a start carrying it is refused. */
|
|
93
|
+
readonly reachShape?: RuleReachShape;
|
|
94
|
+
}
|
|
95
|
+
/** {@link PathRuleDenyRow.reachShape}. */
|
|
96
|
+
export interface RuleReachShape {
|
|
97
|
+
readonly at: string;
|
|
98
|
+
readonly globs: readonly string[];
|
|
88
99
|
}
|
|
89
100
|
/** A row's reach over ONE absolute spelling, three-valued: `unreadable` = the row cannot be judged there (a base its anchor
|
|
90
101
|
* lacks) — a tightening judgment holds on it, an allow grants nothing on it. */
|
|
@@ -219,9 +230,20 @@ export interface ReadDenyMatcher {
|
|
|
219
230
|
* covers. A rule row's reach below a path is not enumerable: any rule row answers. */
|
|
220
231
|
rowAtOrBelow?(path: string): ReadDenyHit | null;
|
|
221
232
|
/** The table ONE call judges with — the Runner's tables are one per read of the person's rules, and a call judges with
|
|
222
|
-
* the read it was pinned to (an unknown or released call: the run's latest
|
|
223
|
-
*
|
|
233
|
+
* the read it was pinned to (an unknown or released call: the run's latest; no call, `undefined`: the table a judgment
|
|
234
|
+
* that is no call's takes now, refused as that judgment is — what a command start that is no call's pins). Absent on a
|
|
235
|
+
* table compiled once: it is every call's ({@link seatForCall}). */
|
|
224
236
|
forCall?(toolCallId: string | undefined): ReadDenyMatcher;
|
|
237
|
+
/** The compiled segment rows `matchPath` judges with (built-in tiers, additions, each placement of a placed row) — what an
|
|
238
|
+
* OS confinement translates the table from (read-floor.ts); the rule rows are {@link ruleRows}. Absent on a hand-built
|
|
239
|
+
* matcher: such a table has no confinement. */
|
|
240
|
+
readonly compiledSegments?: readonly CompiledSegmentPattern[];
|
|
241
|
+
/** The table's identity, minted once where {@link compileReadDeny} compiles it: a compiled table never changes its
|
|
242
|
+
* judgment, so two tables with one `id` judge every path alike. Not enumerable: a spread copy (which may replace the
|
|
243
|
+
* judgment) has none; the copy that only carries other home views (`carryHomeViews`) keeps it. Absent on a hand-built
|
|
244
|
+
* matcher and on a judge that reads another table at each judgment (`readDenyOver`): neither is one compiled table. The
|
|
245
|
+
* byte floor a start carries reports it (`ReadFloor.id`). */
|
|
246
|
+
readonly id?: string;
|
|
225
247
|
}
|
|
226
248
|
/** A seat the run's tables back — a deny table, a read-root set — as ONE call takes it: the call's own where the seat
|
|
227
249
|
* carries `forCall`, the seat itself otherwise (a table compiled once, a host's own list) and for a reader that is no
|
|
@@ -438,6 +460,8 @@ export interface SegmentMatcher {
|
|
|
438
460
|
test(segment: string): boolean;
|
|
439
461
|
/** The pattern is stars only: it matches every one segment. */
|
|
440
462
|
readonly anything: boolean;
|
|
463
|
+
/** The segment pattern as folded at compile (`*` the one metacharacter) — what an OS confinement translates the segment from. */
|
|
464
|
+
readonly source: string;
|
|
441
465
|
}
|
|
442
466
|
/** A compiled segment-run pattern (shared engine — the write guard delegates here too). */
|
|
443
467
|
export interface CompiledSegmentPattern {
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
1
2
|
import { sliceHeadSafe, sliceTailSafe } from "../../core/surrogate-safe-slice.js";
|
|
2
3
|
import { isAbsoluteForFamily, normalizeAbsPathLexically, pathFamilyOf, pathIdentityOf, spellingOfIdentity } from "./safety.js";
|
|
3
4
|
import { PROBE_REASON_MAX } from "../../core/untrusted-text.js";
|
|
@@ -99,10 +100,12 @@ function rowLedTo(row, head, at) {
|
|
|
99
100
|
return to.identity;
|
|
100
101
|
return id.identity.startsWith(under) ? `${onto}/${id.identity.slice(under.length)}` : undefined;
|
|
101
102
|
};
|
|
102
|
-
const { head: _head, ...rest } = row;
|
|
103
|
+
const { head: _head, reachShape: shape, ...rest } = row;
|
|
103
104
|
const reach = row.reach;
|
|
105
|
+
const twinShape = shape === undefined ? undefined : shape.at === to.identity ? { at: base, globs: shape.globs } : shape.at.startsWith(`${onto}/`) ? { at: `${under}${shape.at.slice(onto.length + 1)}`, globs: shape.globs } : undefined;
|
|
104
106
|
return {
|
|
105
107
|
...rest,
|
|
108
|
+
...(twinShape !== undefined ? { reachShape: twinShape } : {}),
|
|
106
109
|
reaches: (absolutePath) => {
|
|
107
110
|
const m = mapped(absolutePath);
|
|
108
111
|
return m !== undefined && row.reaches(m);
|
|
@@ -372,6 +375,7 @@ function foldedViewsOf(views) {
|
|
|
372
375
|
function segmentMatcher(pattern) {
|
|
373
376
|
return {
|
|
374
377
|
anything: /^\*+$/.test(pattern),
|
|
378
|
+
source: pattern,
|
|
375
379
|
test: (segment) => !segment.includes("/") && wildcardMatch(pattern, segment),
|
|
376
380
|
};
|
|
377
381
|
}
|
|
@@ -673,7 +677,7 @@ export function compileReadDeny(additions = [], layer = "additions", builtin, ru
|
|
|
673
677
|
const hit = denyTableHit(tableRows, { views: [{ path, kind: "lexical", ...(opts?.aliasResolved === true ? { aliasResolved: true } : {}) }] });
|
|
674
678
|
return hit === null ? null : { pattern: hit.pattern };
|
|
675
679
|
};
|
|
676
|
-
|
|
680
|
+
const table = {
|
|
677
681
|
entries: normalized,
|
|
678
682
|
...(ruleRows.length > 0 ? { ruleRows } : {}),
|
|
679
683
|
matchPath,
|
|
@@ -683,5 +687,8 @@ export function compileReadDeny(additions = [], layer = "additions", builtin, ru
|
|
|
683
687
|
unexcludableUnder,
|
|
684
688
|
rowUnderRoot,
|
|
685
689
|
rowAtOrBelow,
|
|
690
|
+
compiledSegments: Object.freeze([...judged]),
|
|
686
691
|
};
|
|
692
|
+
Object.defineProperty(table, "id", { value: `rdt-${randomUUID()}`, enumerable: false });
|
|
693
|
+
return table;
|
|
687
694
|
}
|
|
@@ -8,6 +8,11 @@
|
|
|
8
8
|
* engine's refusals cite (`readDenySeat`) and the judgment is the table's own `matchPath`, read off the table the call
|
|
9
9
|
* is pinned to (`seatForCall`). A floor never loosens the station: what the station refuses never starts.
|
|
10
10
|
*
|
|
11
|
+
* The floor is the run's, never the start's: every start a table owner makes carries the floor its seat answers for that
|
|
12
|
+
* start — a call's own pinned table, else the owner's base table — whether or not the start's output reaches the model.
|
|
13
|
+
* A floor is pinned at the start ({@link readFloorSeat}) and carries the identity of the compiled table it stands on
|
|
14
|
+
* (`ReadFloor.id`, minted where the table is compiled): one id, one judgment.
|
|
15
|
+
*
|
|
11
16
|
* Whether the environment KEEPS the floor is its declaration (`capabilities.keepsReadFloor`), judged once per table
|
|
12
17
|
* owner by {@link judgeReadFloorKept}: a non-empty table on an environment that does not keep it is announced, or
|
|
13
18
|
* refused when the deployment requires the floor.
|
|
@@ -15,12 +20,15 @@
|
|
|
15
20
|
import type { ExecutionEnv, ReadFloor } from "../../internal/harness-types.js";
|
|
16
21
|
import { type EngineNotice } from "../../core/engine-notice.js";
|
|
17
22
|
import { type ReadDenyMatcher } from "./read-deny.js";
|
|
18
|
-
/** The floor ONE
|
|
19
|
-
*
|
|
20
|
-
*
|
|
23
|
+
/** The floor ONE command start carries, read at the start off the table it judges with — a tool call's own (`toolCallId`),
|
|
24
|
+
* else the owner's base table (`undefined`: a start that is no call's, such as a git bookkeeping command or a probe whose
|
|
25
|
+
* lines enter the prompt) — `undefined` when that table holds no row (an empty table keeps nothing, and the start then
|
|
26
|
+
* carries no floor: the options are the ones a start took before the floor existed). Throws when the table cannot be
|
|
27
|
+
* read now (a call's tables that failed to compile, the run's newest still compiling, a partition of the person's rows
|
|
28
|
+
* unread): the start is refused. */
|
|
21
29
|
export type ReadFloorSeat = (toolCallId: string | undefined) => ReadFloor | undefined;
|
|
22
|
-
/** The seat over a
|
|
23
|
-
*
|
|
30
|
+
/** The seat over a table owner's deny table (the run's, or a library-direct band's own); `undefined` for no table. Built
|
|
31
|
+
* once per owner; every start the owner makes reads its floor through it, at the start. */
|
|
24
32
|
export declare function readFloorSeat(table: ReadDenyMatcher | undefined): ReadFloorSeat | undefined;
|
|
25
33
|
/** The value gate of the floor requirement (`RunnerDeps.readDenyFloorRequired`, mirrored on `HandsToolkitOptions`), the one
|
|
26
34
|
* gate of every door that admits it: a boolean, or absent (`undefined`, read as "not required"); anything else refuses
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { deliverEngineNotice } from "../../core/engine-notice.js";
|
|
2
2
|
import { keepsReadFloor } from "../../core/remote-env.js";
|
|
3
|
+
import { seatbeltProfile } from "../../core/shell-confinement.js";
|
|
4
|
+
import { thrownText } from "../../core/thrown-value.js";
|
|
3
5
|
import { readDenySeat, seatForCall } from "./read-deny.js";
|
|
4
6
|
import { isAbsoluteForFamily } from "./safety.js";
|
|
5
7
|
export function readFloorSeat(table) {
|
|
@@ -7,10 +9,14 @@ export function readFloorSeat(table) {
|
|
|
7
9
|
return undefined;
|
|
8
10
|
return (toolCallId) => readFloorOf(seatForCall(table, toolCallId));
|
|
9
11
|
}
|
|
10
|
-
function readFloorOf(
|
|
12
|
+
function readFloorOf(seat) {
|
|
13
|
+
return floorOver(typeof seat.forCall === "function" ? seat.forCall(undefined) : seat);
|
|
14
|
+
}
|
|
15
|
+
function floorOver(table) {
|
|
11
16
|
const rows = Object.freeze([...readDenySeat(table).denyEntries]);
|
|
12
17
|
if (rows.length === 0)
|
|
13
18
|
return undefined;
|
|
19
|
+
const id = typeof table.id === "string" ? table.id : undefined;
|
|
14
20
|
const denies = (absolutePath) => {
|
|
15
21
|
if (typeof absolutePath !== "string" || !isAbsoluteForFamily("own", absolutePath))
|
|
16
22
|
return rows[0];
|
|
@@ -21,7 +27,205 @@ function readFloorOf(table) {
|
|
|
21
27
|
return rows[0];
|
|
22
28
|
}
|
|
23
29
|
};
|
|
24
|
-
|
|
30
|
+
let made;
|
|
31
|
+
const confinement = (dialect) => {
|
|
32
|
+
if (dialect !== "seatbelt")
|
|
33
|
+
return { ok: false, row: rows[0], reason: `no confinement dialect is named ${JSON.stringify(dialect)} (the one dialect is "seatbelt")` };
|
|
34
|
+
try {
|
|
35
|
+
table.matchPath("/");
|
|
36
|
+
const segments = table.compiledSegments;
|
|
37
|
+
const rules = table.ruleRows ?? NO_RULE_ROWS;
|
|
38
|
+
if (made === undefined || made.segments !== segments || made.rules !== rules)
|
|
39
|
+
made = { segments, rules, profile: seatbeltProfileOf(segments, rules, rows[0]) };
|
|
40
|
+
return made.profile;
|
|
41
|
+
}
|
|
42
|
+
catch (e) {
|
|
43
|
+
return { ok: false, row: rows[0], reason: `the read-deny table cannot be judged now (${thrownText(e).slice(0, 300)})` };
|
|
44
|
+
}
|
|
45
|
+
};
|
|
46
|
+
return Object.freeze({ ...(id !== undefined ? { id } : {}), rows, denies, confinement });
|
|
47
|
+
}
|
|
48
|
+
const SEATBELT_EXPRESSION_MAX = 900;
|
|
49
|
+
const SEGMENT_SEP = "[/\\\\]";
|
|
50
|
+
const NO_RULE_ROWS = Object.freeze([]);
|
|
51
|
+
let canonicalAliases;
|
|
52
|
+
function aliasesOf() {
|
|
53
|
+
if (canonicalAliases !== undefined)
|
|
54
|
+
return canonicalAliases;
|
|
55
|
+
const single = new Map();
|
|
56
|
+
const multi = new Set();
|
|
57
|
+
for (let c = 0; c < 0x30000; c++) {
|
|
58
|
+
if (c >= 0xd800 && c <= 0xdfff)
|
|
59
|
+
continue;
|
|
60
|
+
const ch = String.fromCodePoint(c);
|
|
61
|
+
const n = ch.normalize("NFC");
|
|
62
|
+
if (n === ch)
|
|
63
|
+
continue;
|
|
64
|
+
if ([...n].length === 1)
|
|
65
|
+
single.set(n, [...(single.get(n) ?? []), ch]);
|
|
66
|
+
else
|
|
67
|
+
multi.add(n);
|
|
68
|
+
}
|
|
69
|
+
return (canonicalAliases = { single, multi: [...multi] });
|
|
70
|
+
}
|
|
71
|
+
function codePointExpression(ch, foldAscii, exact) {
|
|
72
|
+
const c = ch.codePointAt(0);
|
|
73
|
+
const letter = (c >= 0x41 && c <= 0x5a) || (c >= 0x61 && c <= 0x7a);
|
|
74
|
+
const spellings = foldAscii && letter ? [ch.toLowerCase(), ch.toUpperCase()] : [ch];
|
|
75
|
+
const aliases = exact ? [] : spellings.flatMap((sp) => aliasesOf().single.get(sp) ?? []);
|
|
76
|
+
if (spellings.length === 1 && aliases.length === 0)
|
|
77
|
+
return escapeLiteral(ch);
|
|
78
|
+
if (letter)
|
|
79
|
+
return `[${[...spellings, ...aliases].join("")}]`;
|
|
80
|
+
return `(${[...spellings, ...aliases].map(escapeLiteral).join("|")})`;
|
|
81
|
+
}
|
|
82
|
+
function escapeLiteral(x) {
|
|
83
|
+
return x.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
84
|
+
}
|
|
85
|
+
function seatbeltProfileOf(segments, rules, firstRow) {
|
|
86
|
+
if (segments === undefined)
|
|
87
|
+
return { ok: false, row: firstRow, reason: "the table carries no compiled rows to translate (a hand-built table)" };
|
|
88
|
+
const reads = new Set();
|
|
89
|
+
const holds = new Set();
|
|
90
|
+
const add = (row, e) => {
|
|
91
|
+
if ("untranslatable" in e)
|
|
92
|
+
return { ok: false, row, reason: e.untranslatable };
|
|
93
|
+
for (const x of [...e.reads, ...e.holds]) {
|
|
94
|
+
if (Buffer.byteLength(JSON.stringify(x)) - 2 > SEATBELT_EXPRESSION_MAX)
|
|
95
|
+
return { ok: false, row, reason: `its expression is longer than the ${SEATBELT_EXPRESSION_MAX} bytes a seatbelt profile reads` };
|
|
96
|
+
}
|
|
97
|
+
for (const x of e.reads)
|
|
98
|
+
reads.add(x);
|
|
99
|
+
for (const x of e.holds)
|
|
100
|
+
holds.add(x);
|
|
101
|
+
return undefined;
|
|
102
|
+
};
|
|
103
|
+
for (const pat of segments) {
|
|
104
|
+
const refused = add(pat.raw, segmentRowExpressions(pat));
|
|
105
|
+
if (refused !== undefined)
|
|
106
|
+
return refused;
|
|
107
|
+
}
|
|
108
|
+
for (const rule of rules) {
|
|
109
|
+
const refused = add(rule.rule, ruleRowExpressions(rule));
|
|
110
|
+
if (refused !== undefined)
|
|
111
|
+
return refused;
|
|
112
|
+
}
|
|
113
|
+
return { ok: true, profile: seatbeltProfile([...reads], [...holds]) };
|
|
114
|
+
}
|
|
115
|
+
function literalExpression(text, foldAscii, exact = false) {
|
|
116
|
+
let out = "";
|
|
117
|
+
for (const cluster of text.match(/\P{M}\p{M}*|\p{M}+/gu) ?? []) {
|
|
118
|
+
for (const ch of cluster) {
|
|
119
|
+
const c = ch.codePointAt(0);
|
|
120
|
+
if (c < 0x20 || c === 0x7f)
|
|
121
|
+
return { untranslatable: "it holds a control character" };
|
|
122
|
+
}
|
|
123
|
+
const composed = cluster.normalize("NFC");
|
|
124
|
+
const decomposed = cluster.normalize("NFD");
|
|
125
|
+
const cannotList = { untranslatable: `its name holds a character (${JSON.stringify(cluster)}) whose canonical spellings the dialect cannot list` };
|
|
126
|
+
if (!exact && aliasesOf().multi.some((m) => composed.includes(m)))
|
|
127
|
+
return cannotList;
|
|
128
|
+
if (exact || (composed === decomposed && cluster === composed)) {
|
|
129
|
+
for (const ch of cluster)
|
|
130
|
+
out += codePointExpression(ch, foldAscii, exact);
|
|
131
|
+
continue;
|
|
132
|
+
}
|
|
133
|
+
const parts = [...decomposed];
|
|
134
|
+
if (parts.length !== 2)
|
|
135
|
+
return cannotList;
|
|
136
|
+
const spell = (x) => [x, ...(aliasesOf().single.get(x) ?? [])];
|
|
137
|
+
const forms = new Set([...spell(composed)]);
|
|
138
|
+
for (const b of spell(parts[0]))
|
|
139
|
+
for (const m of spell(parts[1]))
|
|
140
|
+
forms.add(`${b}${m}`);
|
|
141
|
+
out += `(${[...forms].map(escapeLiteral).join("|")})`;
|
|
142
|
+
}
|
|
143
|
+
return out;
|
|
144
|
+
}
|
|
145
|
+
function segmentExpression(source, foldAscii) {
|
|
146
|
+
const parts = [];
|
|
147
|
+
const texts = source.split("*");
|
|
148
|
+
for (const [i, part] of texts.entries()) {
|
|
149
|
+
const last = [...part.normalize("NFD")].at(-1);
|
|
150
|
+
if ((i < texts.length - 1 && last !== undefined && /\p{M}/u.test(last)) || (i > 0 && /^\p{M}/u.test(part.normalize("NFD")))) {
|
|
151
|
+
return { untranslatable: `a marked character stands beside a wildcard in ${JSON.stringify(source)} (the marks the wildcard meets can reorder into it)` };
|
|
152
|
+
}
|
|
153
|
+
const lit = literalExpression(part, foldAscii);
|
|
154
|
+
if (typeof lit !== "string")
|
|
155
|
+
return lit;
|
|
156
|
+
parts.push(lit);
|
|
157
|
+
}
|
|
158
|
+
const trailing = /[*. ]$/.test(source) ? "" : "[. ]*";
|
|
159
|
+
return `${SEGMENT_SEP}${parts.join("[^/\\\\]*")}${trailing}`;
|
|
160
|
+
}
|
|
161
|
+
function segmentRowExpressions(pat) {
|
|
162
|
+
if (pat.fold === "unicode")
|
|
163
|
+
return { untranslatable: "its case fold is not the deny table's" };
|
|
164
|
+
const fold = pat.fold === "ascii";
|
|
165
|
+
const run = [];
|
|
166
|
+
for (const seg of pat.segments) {
|
|
167
|
+
const e = segmentExpression(seg.source, fold);
|
|
168
|
+
if (typeof e !== "string")
|
|
169
|
+
return e;
|
|
170
|
+
run.push(e);
|
|
171
|
+
}
|
|
172
|
+
if (pat.anchors !== undefined) {
|
|
173
|
+
const reads = [];
|
|
174
|
+
const holds = [];
|
|
175
|
+
for (const anchor of pat.anchors) {
|
|
176
|
+
const at = [];
|
|
177
|
+
for (const seg of anchor) {
|
|
178
|
+
const e = literalExpression(seg, fold);
|
|
179
|
+
if (typeof e !== "string")
|
|
180
|
+
return e;
|
|
181
|
+
at.push(`${SEGMENT_SEP}${e}${/[. ]$/.test(seg) ? "" : "[. ]*"}`);
|
|
182
|
+
}
|
|
183
|
+
const whole = `^${at.join("")}${run.join("")}(${SEGMENT_SEP}.*)?$`;
|
|
184
|
+
reads.push(whole);
|
|
185
|
+
holds.push(whole);
|
|
186
|
+
const located = [...at, ...run];
|
|
187
|
+
for (let k = 1; k < located.length; k++)
|
|
188
|
+
holds.push(`^${located.slice(0, k).join("")}$`);
|
|
189
|
+
}
|
|
190
|
+
return { reads, holds };
|
|
191
|
+
}
|
|
192
|
+
const whole = `^(/.*)?${run.join("")}(${SEGMENT_SEP}.*)?$`;
|
|
193
|
+
const holds = [whole];
|
|
194
|
+
for (let k = 1; k < run.length; k++)
|
|
195
|
+
holds.push(`^(/.*)?${run.slice(0, k).join("")}$`);
|
|
196
|
+
return { reads: [whole], holds };
|
|
197
|
+
}
|
|
198
|
+
function ruleRowExpressions(rule) {
|
|
199
|
+
const shape = rule.reachShape;
|
|
200
|
+
if (shape === undefined)
|
|
201
|
+
return { untranslatable: "the row's reach has no shape a profile can spell (a hand-built row, or one whose base is missing)" };
|
|
202
|
+
const at = [];
|
|
203
|
+
for (const seg of shape.at.split("/").filter(Boolean)) {
|
|
204
|
+
const e = literalExpression(seg, false, true);
|
|
205
|
+
if (typeof e !== "string")
|
|
206
|
+
return e;
|
|
207
|
+
at.push(`/${e}`);
|
|
208
|
+
}
|
|
209
|
+
const globs = [];
|
|
210
|
+
for (const glob of shape.globs) {
|
|
211
|
+
if (glob === "**") {
|
|
212
|
+
globs.push("(/[^/]+)*");
|
|
213
|
+
continue;
|
|
214
|
+
}
|
|
215
|
+
const parts = [];
|
|
216
|
+
for (const part of glob.split("*")) {
|
|
217
|
+
const lit = literalExpression(part, false, true);
|
|
218
|
+
if (typeof lit !== "string")
|
|
219
|
+
return lit;
|
|
220
|
+
parts.push(lit);
|
|
221
|
+
}
|
|
222
|
+
globs.push(`/${parts.join("[^/]*")}`);
|
|
223
|
+
}
|
|
224
|
+
const whole = `^${at.join("")}${globs.join("")}(/.*)?$`;
|
|
225
|
+
const holds = [whole];
|
|
226
|
+
for (let k = 1; k <= at.length; k++)
|
|
227
|
+
holds.push(`^${at.slice(0, k).join("")}$`);
|
|
228
|
+
return { reads: [whole], holds };
|
|
25
229
|
}
|
|
26
230
|
export function screenReadDenyFloorRequired(value, seat) {
|
|
27
231
|
if (value === undefined || typeof value === "boolean")
|
|
@@ -108,7 +108,7 @@ export function removalFindingsOf(established, seat, safeRoots = KNOWN_SAFE_ROOT
|
|
|
108
108
|
const rm = removal.program === "rm" || !named ? { recursive: selectsOptions(row, spelled, received.shellChooses, TRAVERSAL) } : undefined;
|
|
109
109
|
if (forced && segment.reentry === "argv")
|
|
110
110
|
out.push({ guard: "unverifiable_delete", program: removal.program, operand: segment.text.trim(), source: "stream" });
|
|
111
|
-
const relocated = enclosingRelocated || readProgramPosition(segment.argv).
|
|
111
|
+
const relocated = enclosingRelocated || readProgramPosition(segment.argv).baseMovedAt.length > 0;
|
|
112
112
|
for (const read of established.reads.get(segment) ?? []) {
|
|
113
113
|
if ((named && read.candidate.face !== "write") || read.candidate.provenance === "program_path" || options.has(read.candidate.raw))
|
|
114
114
|
continue;
|
|
@@ -133,7 +133,7 @@ export function removalFindingsOf(established, seat, safeRoots = KNOWN_SAFE_ROOT
|
|
|
133
133
|
out.push({ guard: "unverifiable_shell_text", program, text: script, source: "produced" });
|
|
134
134
|
if (programUnread(segment))
|
|
135
135
|
out.push({ guard: "unverifiable_shell_text", program: segment.launcherChain[0] ?? segment.text.trim(), text: segment.text.trim(), source: "position" });
|
|
136
|
-
const handedRelocated = enclosingRelocated || readProgramPosition(segment.argv).
|
|
136
|
+
const handedRelocated = enclosingRelocated || readProgramPosition(segment.argv).baseMovedAt.length > 0;
|
|
137
137
|
for (const nested of segment.nested) {
|
|
138
138
|
if (unreadPlan(nested)) {
|
|
139
139
|
out.push({ guard: "unverifiable_shell_text", program: program ?? segment.text.trim(), text: segment.text.trim(), source: "unread" });
|
|
@@ -211,8 +211,9 @@ export declare function jsGrepDetailed(env: ExecutionEnv, root: string, p: GrepP
|
|
|
211
211
|
export declare function jsGrep(env: ExecutionEnv, root: string, p: GrepParams, signal?: AbortSignal, guards?: JsGrepGuards, deny?: ReadDenyJudge, denyOut?: {
|
|
212
212
|
withheld?: ReadDenyWithheld;
|
|
213
213
|
}): Promise<string>;
|
|
214
|
-
/** Detect ripgrep once per env (cached).
|
|
215
|
-
|
|
214
|
+
/** Detect ripgrep once per env (cached). The detection is a start of the call that asks first and carries that call's floor
|
|
215
|
+
* (`readFloor`; absent ⇒ none, a caller with no run's table). */
|
|
216
|
+
export declare function detectRipgrep(env: ExecutionEnv, readFloor?: ReadFloor): Promise<boolean>;
|
|
216
217
|
/** How a grep result was produced when the ripgrep leg could not complete normally. Either the
|
|
217
218
|
* delivered text IS ripgrep's own partial output (`partial: true`), or ripgrep produced nothing
|
|
218
219
|
* usable and the results came from the JS fallback scanner (`fallback: "js-scan"`). Absent on a
|