@sema-agent/core 7.66.1 → 7.67.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 +3483 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -261,7 +261,7 @@ function findingAccount(fold, boundary) {
|
|
|
261
261
|
return `"${fitMiddle(fold.declined.text.trim(), ACCOUNT_PART_MAX)}": ${fold.declined.unreadProgramText}, so where it ${verb} cannot be established ${NOT_AUTO_ALLOWED}`;
|
|
262
262
|
if (fold.declined !== undefined)
|
|
263
263
|
return `the text given to ${reenteredPrograms(fold)} — as an argument, on standard input, or in the file it names — runs as shell text this station does not parse ${NOT_AUTO_ALLOWED}`;
|
|
264
|
-
return `
|
|
264
|
+
return `where this command ${verb} could not be established ${NOT_AUTO_ALLOWED}`;
|
|
265
265
|
case "declined":
|
|
266
266
|
return fold.declined !== undefined ? declinedProgramSentence(fold.declined.text) : `the station could not read which program runs ${NOT_AUTO_ALLOWED}`;
|
|
267
267
|
case "identity_changed":
|
|
@@ -395,7 +395,10 @@ export interface ShellReadFold {
|
|
|
395
395
|
* standard input) and so is at least `unestablishable`, in text order — `declined` holds only the first finding of the rank, and the
|
|
396
396
|
* account of this question names each program, not the first. Present only with an `unestablished` fold. */
|
|
397
397
|
readonly reentered?: readonly ShellReadSegment[];
|
|
398
|
-
/** What
|
|
398
|
+
/** What could not be settled, in words, for a finding that has no witness read or declined segment to say it: for `unanswered`
|
|
399
|
+
* the first thing the establishment recorded ({@link Incomplete.detail}); for an `unestablishable` text the plan refused
|
|
400
|
+
* ({@link ShellReadPlan.unreadable}) the sentence the plan itself carries — a construct the lexer cannot close, a word whose
|
|
401
|
+
* value the text does not hold, a value a parameter expansion re-reads at run time. */
|
|
399
402
|
readonly cause?: string;
|
|
400
403
|
/** Some read of the text could not be established (an `unestablishable`, `unanswered` or `declined` finding anywhere, winning or not). */
|
|
401
404
|
readonly unestablished?: true;
|
|
@@ -69,6 +69,10 @@ export function judgeRead(read, boundary) {
|
|
|
69
69
|
}
|
|
70
70
|
}
|
|
71
71
|
}
|
|
72
|
+
if (read.candidate.floorPastBound === true && deny !== undefined) {
|
|
73
|
+
const cause = `the spellings "${read.candidate.raw}" may take pass the bound the station reads, so it may name a value no deny row was asked about`;
|
|
74
|
+
return { read: { ...read, cause }, kind: "unanswered", containment: writeTarget ? writeContainmentOf(read, boundary) : containmentOf(read, boundary) };
|
|
75
|
+
}
|
|
72
76
|
if (writeTarget)
|
|
73
77
|
return judgeWrite(read, boundary);
|
|
74
78
|
const containment = containmentOf(read, boundary);
|
|
@@ -149,7 +153,7 @@ export function foldShellReadFindings(judged) {
|
|
|
149
153
|
const walk = (j, reading) => {
|
|
150
154
|
const denyOnly = reading !== "full";
|
|
151
155
|
if (j.plan.unreadable !== undefined && !denyOnly)
|
|
152
|
-
raise({ finding: "unestablishable" });
|
|
156
|
+
raise({ finding: "unestablishable", cause: j.plan.unreadable });
|
|
153
157
|
for (const s of j.segments) {
|
|
154
158
|
for (const f of s.findings) {
|
|
155
159
|
if (denyOnly && f.kind !== "deny_hit" && (reading === "deny-hit" || f.kind !== "unanswered"))
|
|
@@ -88,6 +88,10 @@ export interface ReadCandidate {
|
|
|
88
88
|
/** A home word the plan does not place (the text may rebind `HOME`, it sits in a value, or it is a literal tilde the
|
|
89
89
|
* program may expand itself): spelled with the DECLARED home. The judge reads it for deny rows ONLY. */
|
|
90
90
|
readonly floorSpelled?: string;
|
|
91
|
+
/** The word's names are unknown here and the spellings their bindings left for the deny judge passed the bound the
|
|
92
|
+
* station reads: some were let go, so the word may spell one no deny row was asked about. The judge answers it
|
|
93
|
+
* `unanswered` (the station stopped at its own bound) where a deny row guards the face, unless a view hits a row. */
|
|
94
|
+
readonly floorPastBound?: true;
|
|
91
95
|
/** Deny rows only (never containment): a `floorSpelled` shadow, or the read copy of a word the program only writes. */
|
|
92
96
|
readonly denyOnly?: true;
|
|
93
97
|
/** A WRITE target (a `>`-family redirection, a `sed` `w` file, a file-writing command's operand): established like a
|
|
@@ -2,7 +2,7 @@ import { assignedWords, expansionsInHeredocBody, descriptorNameWords, lexShell,
|
|
|
2
2
|
import { programTextOf, readOfText, readsOf, rewritten, segmentReadingsOf, settledFieldsOf, spelledWithHome, unreadableSentenceOf } from "./shell-read-word.js";
|
|
3
3
|
import { braceWordListsOf } from "./shell-read-brace.js";
|
|
4
4
|
import { assignmentArithmetic, bare, listedVerbCandidates, pathSubcommandOf, programTextSentence, pushAssignment, roleReads, subscriptOnly, unlistedWords } from "./shell-read-argv.js";
|
|
5
|
-
import { ARITHMETIC_TEST_OPERATORS, BindingThread, arithmeticSubstitutions, assignsAsStatement, inheritedFunctionsOf, inheritedExportedFunctions, isArithmeticCommand, bindingEffectOf, joinRebound, loopListHeadAt, namesBoundIn, parameterBodySubstitutions, projectSegments, valueOf, } from "./shell-read-bindings.js";
|
|
5
|
+
import { ARITHMETIC_TEST_OPERATORS, BindingThread, arithmeticSubstitutions, assignsAsStatement, inheritedFunctionsOf, inheritedExportedFunctions, isArithmeticCommand, bindingEffectOf, bindingFloors, floorReaderOf, joinRebound, loopListHeadAt, namesBoundIn, parameterBodySubstitutions, projectSegments, valueOf, } from "./shell-read-bindings.js";
|
|
6
6
|
import { commandEnvironmentNames, isShellSyntaxWord, programBasename, programPositionRunsShell, readProgramPosition, shellScanDeclineOf, } from "./bash-program-position.js";
|
|
7
7
|
import { WorkdirThread, baseShiftOf, textCalls, textMayMove, textMovesOf, textSetsPhysical, withCommandEnvironment } from "./shell-read-workdir.js";
|
|
8
8
|
import { POLL_LOOP_MAX_BEATS, attachedOptionPayloads, isPathShapedToken, programTextSlotFiles, } from "./bash-readonly-classifier.js";
|
|
@@ -10,7 +10,7 @@ import { mayCarryGitVariables, objectPathPlacement } from "./shell-read-object-p
|
|
|
10
10
|
import { BLOCK_WORD_NAMES, commandLineOf, commandLineOptionSpellings, declaredAttributes, isDeclarationBuiltin, isInertBuiltin, launcherOptionPathRole, launcherOptionStep, readOptionRole, programLanguageOf, programTextOpensOf, selectedOptions, movesBaseByStack, opensNoOperand, programDelivery, programRow, readArgRoles, runsShellText, } from "./program-read-model.js";
|
|
11
11
|
import { shellWordsOf } from "../../shell/shell-words.js";
|
|
12
12
|
import { isAbsoluteForFamily } from "./safety.js";
|
|
13
|
-
import { codeBodies, launchedInput, literalEvalText, pipedTextOf, printedByProcess, reentersShell, reentryText, scriptFileAt, stdinTextsOf } from "./shell-reentry-text.js";
|
|
13
|
+
import { codeBodies, launchedInput, literalEvalText, pipedTextOf, printedByProcess, reentersShell, reentryText, scriptFileAt, stdinTextOf, stdinTextsOf } from "./shell-reentry-text.js";
|
|
14
14
|
import { heldAt, launchedAt, launchedInOf, nestedStartOf, plannedOnce, rebasePlan, startedAt, stdinFeeds } from "./shell-read-start.js";
|
|
15
15
|
import { inlineSourcedLiterals } from "./shell-read-sourced.js";
|
|
16
16
|
import { markStandardDevices } from "./shell-read-device.js";
|
|
@@ -87,11 +87,11 @@ function planText(command, decl, depth, start, from) {
|
|
|
87
87
|
const bodies0 = new BindingThread(lexed.segments, named0, initial, boundAnywhere, loopEndOf, start?.homeTouched === true, start?.inherited, start?.names);
|
|
88
88
|
const ifsBoundBefore = (si) => start?.boundAnywhere("IFS") === true || (bodies0.inFunctionBody(si) && boundHere("IFS")) || named0.some((_, j) => j < si && unknownAt(j)) || [...loopEndOf].some(([h, end]) => h <= si && si < end && named0.some((_, j) => h <= j && j < end && unknownAt(j)));
|
|
89
89
|
const feedsItself = (si) => lexed.segments[si].tokens.some((t) => (t.kind === "heredoc" && (t.fd ?? 0) === 0) || (t.kind === "redirect" && (t.fd ?? (t.op === "<" || t.op === "<<<" || t.op === "<>" || t.op === "<&" ? 0 : 1)) === 0));
|
|
90
|
-
const readFeedOf = (si) =>
|
|
91
|
-
const named = projected.map((p, si) =>
|
|
90
|
+
const readFeedOf = (si) => [stdinOf(si), !feedsItself(si) && loopFeedOf(si) !== undefined, ifsBoundBefore(si)];
|
|
91
|
+
const named = projected.map((p, si) => bindingEffectOf(lexed.segments[si], p.argv, p, (w, quoted, overlay) => valueOf(w, undefined, quoted, overlay), undefined, undefined, ...readFeedOf(si)));
|
|
92
92
|
const names = new BindingThread(lexed.segments, named, initial, boundAnywhere, loopEndOf, start?.homeTouched === true, start?.inherited, start?.names);
|
|
93
93
|
const laterStart = { initial: (name) => declared(name, boundAnywhere(name)), boundAnywhere, homeTouched: boundAnywhere("HOME"), inherited: names.inheritedAt() };
|
|
94
|
-
const nestedTextStart = (table, si, kind, at, exported = exportedNames) => kind === "substitution" ? { initial: (name) => table.stateOf(name), boundAnywhere, homeTouched: table.homeTouched, inherited: table.inherited, thread: heldThread(moves.functions), names: heldAt(table), ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}) } : startedAt(kind === "now" ? { ...laterStart, inherited: { ...laterStart.inherited, rebound: joinRebound(table.inherited.rebound, commandEnvironmentNames(projected[si].argv)) }, ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}), ...(
|
|
94
|
+
const nestedTextStart = (table, si, kind, at, exported = exportedNames) => kind === "substitution" ? { initial: (name) => table.stateOf(name), boundAnywhere, homeTouched: table.homeTouched, inherited: table.inherited, thread: heldThread(moves.functions), names: heldAt(table), ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}) } : startedAt(kind === "now" && readProgramPosition(projected[si].argv).program?.basename === "eval" ? evalStart(withCommandEnvironment(table, projected[si].argv)) : kind === "now" ? { ...laterStart, inherited: { ...laterStart.inherited, rebound: joinRebound(table.inherited.rebound, commandEnvironmentNames(projected[si].argv)) }, ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}), ...(exportedFunctions.size > 0 ? { thread: { physical: false, functions: exported, unread: exported, reached: workdir.reached }, names: inheritedExportedFunctions(exportedFunctions) } : {}) } : { ...laterStart, thread: heldThread(moves.functions, workdir.mayBePhysical || moves.physicalAt.some(Boolean)), names: names.heldAnywhere(), ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}) }, at);
|
|
95
95
|
const nestedPlanner = (table, si) => (text, kind, at) => planShellReads(text, decl, depth + 1, nestedTextStart(table, si, kind, at));
|
|
96
96
|
const empty = lexed.segments.map((segment, si) => segmentIsEmpty(segment, projected[si]));
|
|
97
97
|
const facts = projected.map(() => undefined);
|
|
@@ -124,7 +124,7 @@ function planText(command, decl, depth, start, from) {
|
|
|
124
124
|
return { end: ran.end, physical: ran.physical, reached: ran.reached, ...(ran.unsettled === true ? { unsettled: true } : {}) };
|
|
125
125
|
},
|
|
126
126
|
};
|
|
127
|
-
const evalStart = (table) => ({ initial: (name) => table.stateOf(name), boundAnywhere, homeTouched: table.homeTouched, inherited: table.inherited, thread: heldThread(moves.unread), names: heldAt(table, names.functionBound()) });
|
|
127
|
+
const evalStart = (table) => ({ initial: (name) => table.stateOf(name), boundAnywhere, homeTouched: table.homeTouched || table.commandSets.has("HOME"), inherited: { ...table.inherited, rebound: joinRebound(table.inherited.rebound, table.commandSets) }, thread: heldThread(moves.unread), names: heldAt(table, names.functionBound()), ...(exportedFunctions.size > 0 ? { exportedFunctions } : {}) });
|
|
128
128
|
const heldThread = (unread, physical = workdir.mayBePhysical) => ({ physical, functions: moves.functions, unread, reached: workdir.reached });
|
|
129
129
|
let andRunStart = 0;
|
|
130
130
|
let crossedAllAnd = true;
|
|
@@ -192,21 +192,16 @@ function planText(command, decl, depth, start, from) {
|
|
|
192
192
|
const end = loopEndOf.get(si);
|
|
193
193
|
if (end !== undefined) {
|
|
194
194
|
const body = named.slice(si + 1, end);
|
|
195
|
-
|
|
195
|
+
const carried = bindingFloors(body.flatMap((e) => e.bindings));
|
|
196
|
+
names.kill(si, body.some((e) => e.all === "unknown") ? "all" : [...carried.keys(), ...(moves.mayMove.slice(si + 1, end).some(Boolean) ? ["PWD", "OLDPWD"] : [])], carried);
|
|
196
197
|
}
|
|
197
198
|
const segment = lexed.segments[si];
|
|
198
|
-
const effect = bindingEffectOf(segment, projected[si].argv, projected[si], (w, quoted, overlay) => valueOf(w, table, quoted, overlay), moves.callAt(si, table), (builtin) => table.builtinState(builtin), ...readFeedOf(si));
|
|
199
|
+
const effect = bindingEffectOf(segment, projected[si].argv, projected[si], (w, quoted, overlay) => valueOf(w, table, quoted, overlay), moves.callAt(si, table), (builtin) => table.builtinState(builtin), ...readFeedOf(si), floorReaderOf(table));
|
|
199
200
|
const { all, ...rest } = effect;
|
|
200
201
|
names.apply(si, all === "reset" ? rest : effect, segment.connector === "&&" || segment.connector === "||", end, segment.spliced === true);
|
|
201
202
|
if (moves.callAt(si, table) !== undefined) {
|
|
202
|
-
const bound =
|
|
203
|
-
|
|
204
|
-
names.kill(si, "all", segment.spliced === true);
|
|
205
|
-
else {
|
|
206
|
-
const maybe = names.functionMaybeBound();
|
|
207
|
-
names.kill(si, [...bound].filter((n) => !maybe.has(n)), segment.spliced === true);
|
|
208
|
-
names.kill(si, maybe, true);
|
|
209
|
-
}
|
|
203
|
+
const bound = names.functionBindings();
|
|
204
|
+
names.kill(si, moves.callsUnread(si, table) || bound === "all" ? "all" : bound.keys(), bound === "all" ? undefined : bound);
|
|
210
205
|
}
|
|
211
206
|
if (moves.bodiesAt[si].length > 0)
|
|
212
207
|
names.runsLater(si, moves.bodiesAt[si].reduce((held, b) => joinRebound(held, namesBoundIn(b)), names.functionBound()));
|
|
@@ -254,6 +249,13 @@ function planText(command, decl, depth, start, from) {
|
|
|
254
249
|
};
|
|
255
250
|
walk(projected.map((_, si) => si), true);
|
|
256
251
|
closeScopes();
|
|
252
|
+
projected.forEach((_, si) => {
|
|
253
|
+
const table = tables[si];
|
|
254
|
+
if (!names.inFunctionBody(si) || facts[si] === undefined || table === undefined)
|
|
255
|
+
return;
|
|
256
|
+
facts[si] = undefined;
|
|
257
|
+
factsAt(si, table);
|
|
258
|
+
});
|
|
257
259
|
const end = workdir.end();
|
|
258
260
|
const gather = (ats) => {
|
|
259
261
|
const at = new Map();
|
|
@@ -277,7 +279,7 @@ function planText(command, decl, depth, start, from) {
|
|
|
277
279
|
const key = JSON.stringify([j, t.text, t.in, s.at.map(keyOf)]);
|
|
278
280
|
let ran = handedCallers.get(key);
|
|
279
281
|
if (ran === undefined) {
|
|
280
|
-
const start = t.in === "shell" ? evalStart(table) : nestedTextStart(table, j, t.in === "child" ? "now" : "substitution", undefined, t.functions);
|
|
282
|
+
const start = t.in === "shell" ? evalStart(withCommandEnvironment(table, projected[j].argv)) : nestedTextStart(table, j, t.in === "child" ? "now" : "substitution", undefined, t.functions);
|
|
281
283
|
ran = planText(t.text, decl, depth + 1, start, s.at).callers ?? s;
|
|
282
284
|
handedCallers.set(key, ran);
|
|
283
285
|
}
|
|
@@ -383,7 +385,7 @@ function planText(command, decl, depth, start, from) {
|
|
|
383
385
|
...(f.verb !== undefined ? { verb: f.verb } : {}),
|
|
384
386
|
...(f.reentry !== undefined ? { reentry: f.reentry } : {}),
|
|
385
387
|
...(f.unreadProgramText !== undefined ? { unreadProgramText: f.unreadProgramText } : {}),
|
|
386
|
-
...(f.stdin !== undefined ? { stdin: f.stdin } : {}),
|
|
388
|
+
...(f.stdin !== undefined ? { stdin: f.stdin.map(stdinTextOf) } : {}),
|
|
387
389
|
declines: f.declines,
|
|
388
390
|
reads: dedupe(f.reads).map(programRead),
|
|
389
391
|
redirects: f.redirects.map((r) => ({ op: r.op, direction: r.direction, ...(r.fd !== undefined ? { fd: r.fd } : {}), ...(r.target !== undefined ? { target: withBases(r.target) } : {}) })),
|
|
@@ -463,7 +465,7 @@ function readingFacts(segment, p, decl, reading, nestedPlan, fed, inheritedFns =
|
|
|
463
465
|
const unsettle = (c) => floor((unresolvedRaw.has(c.raw) || (homeWithheld && c.spelled.startsWith("~"))) && c.expands !== "unresolvable" ? { ...c, expands: "unresolvable" } : c);
|
|
464
466
|
const each = (c) => {
|
|
465
467
|
const { floors, ...one } = c;
|
|
466
|
-
const shadows = (floors ?? []).map((v) => ({ spelled: v.spelled, ...(v.pattern !== undefined ? { pattern: v.pattern } : {}), raw: one.raw, provenance: one.provenance, expands: v.glob === true ? "glob" : false, denyOnly: true }));
|
|
468
|
+
const shadows = (floors ?? []).map((v) => ({ spelled: v.spelled, ...(v.pattern !== undefined ? { pattern: v.pattern } : {}), raw: one.raw, provenance: one.provenance, expands: v.piece === true ? "unresolvable" : v.glob === true ? "glob" : false, denyOnly: true }));
|
|
467
469
|
return [unsettle(one), ...shadows];
|
|
468
470
|
};
|
|
469
471
|
const move = facts.baseMove;
|
|
@@ -3,15 +3,16 @@
|
|
|
3
3
|
*
|
|
4
4
|
* `. ./lib.sh` / `source lib.sh` run a file's text in THIS shell: the functions it defines stand after it, and a call
|
|
5
5
|
* to one later runs its body where the call stands. The station cannot read a file — but where the same command wrote
|
|
6
|
-
* the file first, with a literal printer and a `>` redirection (`printf 'f(){ …; }\n' > lib.sh; . ./lib.sh
|
|
7
|
-
*
|
|
6
|
+
* the file first, with a literal printer and a `>` redirection (`printf 'f(){ …; }\n' > lib.sh; . ./lib.sh`, or `cat`
|
|
7
|
+
* fed a here-document the shell expands nothing in), the text it sources IS the literal the printer spells: the
|
|
8
|
+
* segments of that literal are spliced in place of the `source`
|
|
8
9
|
* segment, before anything is projected, so every later reader (definitions, bodies, callers, bindings, the
|
|
9
10
|
* working-directory thread) reads them as the shell runs them — no reader of its own.
|
|
10
11
|
*
|
|
11
12
|
* Fail-closed where the claim does not hold: a file the command did not write IMMEDIATELY before the source (another
|
|
12
13
|
* segment between — a second write, a move, a pipe, a group — is a claim the station does not make), a write reached
|
|
13
14
|
* through `&&` / `||` that the source is not chained to (it may not have run), a write with `>>`, through a pipe, with
|
|
14
|
-
* a word the shell rewrites
|
|
15
|
+
* a word the shell rewrites, a format that converts or a here-document the shell expands, a printer with a launcher or a prefix assignment, a `source`
|
|
15
16
|
* carrying a redirection of its own, or a literal the lexer cannot read, splices nothing — the `source` segment stays what it was (text run in this shell that the
|
|
16
17
|
* station does not hold: an unsettled start, the #3358 law). Bash's `sourcepath` PATH search of a bare name is not
|
|
17
18
|
* read: the file the command wrote at that spelling is taken as the text (docs/KNOWN-LIMITS.md KL-3400-a).
|
|
@@ -32,9 +32,17 @@ function printfFormatText(format) {
|
|
|
32
32
|
}
|
|
33
33
|
return out;
|
|
34
34
|
}
|
|
35
|
+
function hereDocumentText(h) {
|
|
36
|
+
if (h.body.split("\n").some((line) => line.startsWith("\t")))
|
|
37
|
+
return undefined;
|
|
38
|
+
if (!h.quoted && /[$`\\]/.test(h.body))
|
|
39
|
+
return undefined;
|
|
40
|
+
return h.body.length === 0 ? "" : `${h.body}\n`;
|
|
41
|
+
}
|
|
35
42
|
function writtenLiteralOf(segment) {
|
|
36
43
|
const redirects = segment.tokens.filter((t) => t.kind === "redirect");
|
|
37
|
-
|
|
44
|
+
const heredocs = segment.tokens.filter((t) => t.kind === "heredoc");
|
|
45
|
+
if (redirects.length !== 1 || heredocs.length > 1 || segment.tokens.some((t) => t.kind === "group"))
|
|
38
46
|
return undefined;
|
|
39
47
|
const r = redirects[0];
|
|
40
48
|
if (r.kind !== "redirect" || r.op !== ">" || (r.fd ?? 1) !== 1 || r.target === undefined)
|
|
@@ -50,6 +58,15 @@ function writtenLiteralOf(segment) {
|
|
|
50
58
|
if (words.some((w) => w === undefined))
|
|
51
59
|
return undefined;
|
|
52
60
|
const literal = words;
|
|
61
|
+
const heredoc = heredocs[0];
|
|
62
|
+
if (pos.program.basename === "cat") {
|
|
63
|
+
if (heredoc === undefined || literal.length !== 0 || (heredoc.fd ?? 0) !== 0 || heredoc.allocated === true)
|
|
64
|
+
return undefined;
|
|
65
|
+
const text = hereDocumentText(heredoc);
|
|
66
|
+
return text === undefined ? undefined : { file, text };
|
|
67
|
+
}
|
|
68
|
+
if (heredoc !== undefined)
|
|
69
|
+
return undefined;
|
|
53
70
|
if (pos.program.basename === "printf") {
|
|
54
71
|
if (literal.length !== 1)
|
|
55
72
|
return undefined;
|
|
@@ -6,10 +6,10 @@
|
|
|
6
6
|
* does —, unless it starts in a working directory of its own.
|
|
7
7
|
*/
|
|
8
8
|
import { type LexedSegment } from "../../shell/lex.js";
|
|
9
|
-
import type
|
|
9
|
+
import { type BindingTable, type InheritedBody, type InheritedFunctions, type NameReader, type WordFloor } from "./shell-read-bindings.js";
|
|
10
10
|
import { type ProgramPosition } from "./bash-program-position.js";
|
|
11
11
|
import { type TargetUser } from "./program-read-model.js";
|
|
12
|
-
import type {
|
|
12
|
+
import type { InputText } from "./shell-reentry-text.js";
|
|
13
13
|
import type { ReadCandidate, ShellReadPlan } from "./shell-read-plan.js";
|
|
14
14
|
import type { Read } from "./shell-read-word.js";
|
|
15
15
|
/** Where a nested text starts its names: a substitution body inherits the table of the segment it sits in (a subshell
|
|
@@ -33,7 +33,7 @@ export interface PlanStart {
|
|
|
33
33
|
* ({@link InheritedFunctions}). A text a new process runs (a child shell's `-c`) holds none: every builtin enabled, no function. */
|
|
34
34
|
readonly names?: InheritedFunctions;
|
|
35
35
|
/** What arrives on its own standard input (the input of the shell running it). */
|
|
36
|
-
readonly stdin?: readonly
|
|
36
|
+
readonly stdin?: readonly InputText[];
|
|
37
37
|
/** The functions the shell running this text inherited (`export -f`, an environment's `BASH_FUNC_*`), each with whether
|
|
38
38
|
* its body is text the engine read ({@link InheritedBody}), inherited by it and by ITS child shells: a child adds its own
|
|
39
39
|
* exports and passes the whole on, so a grandchild still sees a function exported two shells up (#1628). Only on a
|
|
@@ -61,9 +61,9 @@ export declare function heldAt(table: BindingTable, bound?: InheritedFunctions["
|
|
|
61
61
|
/** What a segment says of the start of a text it hands a shell to run later: the deny floors of the words it holds as
|
|
62
62
|
* written, the user the shell runs as ({@link TargetUser}), and the shell's standard input. */
|
|
63
63
|
export interface NestedStart {
|
|
64
|
-
readonly floors?: ReadonlyMap<string,
|
|
64
|
+
readonly floors?: ReadonlyMap<string, WordFloor>;
|
|
65
65
|
readonly as?: TargetUser;
|
|
66
|
-
readonly stdin?: readonly
|
|
66
|
+
readonly stdin?: readonly InputText[];
|
|
67
67
|
}
|
|
68
68
|
/** Where a text run later starts ({@link NestedStart}): the later start, with the shell's standard input, the floors of the
|
|
69
69
|
* words that hand it on, and — run as another user — that user's `HOME` (the caller's, the target's, or either) and, for
|
|
@@ -77,7 +77,7 @@ export declare function plannedOnce<K, P>(plan: (text: string, kind: K, at?: Nes
|
|
|
77
77
|
* prints); else the input of the group (`{ …; }`, `( … )`) it stands in — a group a pipe feeds hands each member that
|
|
78
78
|
* pipe; else the input the text itself was handed (`start`: a shell's `-c` text reads that shell's standard input).
|
|
79
79
|
*/
|
|
80
|
-
export declare function stdinFeeds(segments: readonly LexedSegment[], start: readonly
|
|
80
|
+
export declare function stdinFeeds(segments: readonly LexedSegment[], start: readonly InputText[], piped: (si: number) => readonly InputText[]): (si: number) => readonly InputText[];
|
|
81
81
|
/**
|
|
82
82
|
* Where a nested text with no working directory of its own starts (a substitution body, a here-document's substitution, a
|
|
83
83
|
* launcher's command string): a PLACEHOLDER below the declared working directory, joined as its path family joins, whose last
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { literalTildeSpelling } from "../../shell/lex.js";
|
|
2
|
+
import { joinedFloors } from "./shell-read-bindings.js";
|
|
2
3
|
import { programBasename } from "./bash-program-position.js";
|
|
3
4
|
import { launcherOptionPathRole, launcherOptionStep, programRow, readOptionRole } from "./program-read-model.js";
|
|
4
5
|
import { chdirFrom } from "./shell-read-object-path.js";
|
|
@@ -36,12 +37,6 @@ export function plannedOnce(plan) {
|
|
|
36
37
|
return planned.get(key);
|
|
37
38
|
};
|
|
38
39
|
}
|
|
39
|
-
function joinedFloors(a, b) {
|
|
40
|
-
const out = new Map(a);
|
|
41
|
-
for (const [name, floors] of b)
|
|
42
|
-
out.set(name, [...(out.get(name) ?? []), ...floors]);
|
|
43
|
-
return out;
|
|
44
|
-
}
|
|
45
40
|
export function stdinFeeds(segments, start, piped) {
|
|
46
41
|
const opener = [];
|
|
47
42
|
const enclosing = [];
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* does to the word before the program sees it.
|
|
6
6
|
*/
|
|
7
7
|
import { type LexedCommand, type LexedWord, type WordPiece } from "../../shell/lex.js";
|
|
8
|
-
import { type BindingTable, type BoundValue, type FloorValue } from "./shell-read-bindings.js";
|
|
8
|
+
import { type BindingTable, type BoundValue, type FloorValue, type WordFloor } from "./shell-read-bindings.js";
|
|
9
9
|
/** `"glob"` = an unquoted pathname-expansion character; `"unresolvable"` = the shell rewrites the word (a brace,
|
|
10
10
|
* variable or command substitution) so its text is not the path. The read candidate's own field, spelled here. */
|
|
11
11
|
export type WordExpands = false | "glob" | "unresolvable";
|
|
@@ -34,6 +34,8 @@ export interface Read {
|
|
|
34
34
|
/** The word's names are unknown here, but their bindings left spellings for the deny judge (an array's elements):
|
|
35
35
|
* what the word may then spell, for the deny judge alone. */
|
|
36
36
|
readonly floorValues?: readonly FloorValue[];
|
|
37
|
+
/** The word's deny floor passed the reader's bound ({@link import("./shell-read-bindings.js").WordFloor.pastBound}). */
|
|
38
|
+
readonly floorPastBound?: true;
|
|
37
39
|
}
|
|
38
40
|
/** The reads of a segment's words against the binding table at that segment (`homeDir` = the declared home, the
|
|
39
41
|
* state `HOME` starts in). A word that refers to no name, or only to a `HOME` the text has not touched (`~/x`, placed
|
|
@@ -50,7 +52,7 @@ export interface SegmentReading {
|
|
|
50
52
|
readonly table: BindingTable;
|
|
51
53
|
readonly reads: readonly Read[];
|
|
52
54
|
readonly argv: readonly LexedWord[];
|
|
53
|
-
readonly floors: ReadonlyMap<string,
|
|
55
|
+
readonly floors: ReadonlyMap<string, WordFloor>;
|
|
54
56
|
}
|
|
55
57
|
/**
|
|
56
58
|
* The readings of one segment's words (its argv and its redirection targets): the names they read through the table that
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { argvOf, assignedWords, lexShell, literalTildeSpelling, UNRESOLVED_SENTENCE } from "../../shell/lex.js";
|
|
2
2
|
import { expansionInWord, extglobOpenerIn, globInWord, homeExpansionOf } from "./bash-readonly-classifier.js";
|
|
3
|
-
import { floorOf, judgedSpellingOf, namesIn, wordFloorValues, wordValues } from "./shell-read-bindings.js";
|
|
3
|
+
import { floorOf, isEmptyFloor, joinFloors, judgedSpellingOf, NO_FLOOR, namesIn, wordFloorValues, wordValues } from "./shell-read-bindings.js";
|
|
4
4
|
import { READINGS_MAX } from "./shell-read-brace.js";
|
|
5
5
|
export function readsOf(words, table, homeDir, split = false) {
|
|
6
6
|
return words.map((word) => {
|
|
@@ -12,8 +12,8 @@ export function readsOf(words, table, homeDir, split = false) {
|
|
|
12
12
|
if (values === undefined)
|
|
13
13
|
return { ...asWritten, expands: expandsOf(word) };
|
|
14
14
|
if (values === "unknown") {
|
|
15
|
-
const
|
|
16
|
-
return { ...asWritten, expands: refersToName ? "unresolvable" : expandsOf(word), ...(
|
|
15
|
+
const floor = refersToName ? wordFloorValues(word, table) : NO_FLOOR;
|
|
16
|
+
return { ...asWritten, expands: refersToName ? "unresolvable" : expandsOf(word), ...(floor.values.length > 0 ? { floorValues: floor.values } : {}), ...(floor.pastBound ? { floorPastBound: true } : {}) };
|
|
17
17
|
}
|
|
18
18
|
const glob = values.some((v) => v.glob === true) || globInWord(word);
|
|
19
19
|
const refersToHome = word.pieces.some((p) => p.expansion?.kind === "tilde" || (p.expansion?.kind === "parameter" && p.expansion.name === "HOME"));
|
|
@@ -68,8 +68,8 @@ export function segmentReadingsOf(argv, targets, table, homeDir) {
|
|
|
68
68
|
if (name === undefined)
|
|
69
69
|
continue;
|
|
70
70
|
const held = reading.stateOf(name);
|
|
71
|
-
const floor =
|
|
72
|
-
if (floor
|
|
71
|
+
const floor = joinFloors({ values: held === "unknown" ? [] : held.map(floorOf), pastBound: false }, reading.floorOf(name));
|
|
72
|
+
if (!isEmptyFloor(floor))
|
|
73
73
|
floors.set(name, floor);
|
|
74
74
|
}
|
|
75
75
|
}
|
|
@@ -82,6 +82,7 @@ function namesReadIn(word, table) {
|
|
|
82
82
|
function overlaidTable(table, overlay) {
|
|
83
83
|
return {
|
|
84
84
|
stateOf: (name) => overlay.get(name) ?? table.stateOf(name),
|
|
85
|
+
arrayOf: (name) => (overlay.has(name) ? undefined : table.arrayOf(name)),
|
|
85
86
|
isInteger: (name) => table.isInteger(name),
|
|
86
87
|
ifsTouched: table.ifsTouched,
|
|
87
88
|
homeTouched: table.homeTouched,
|
|
@@ -91,7 +92,7 @@ function overlaidTable(table, overlay) {
|
|
|
91
92
|
builtinState: (name) => table.builtinState(name),
|
|
92
93
|
floorOf: (name) => {
|
|
93
94
|
const held = table.stateOf(name);
|
|
94
|
-
return overlay.get(name) !== "unknown" || held === "unknown" ? table.floorOf(name) :
|
|
95
|
+
return overlay.get(name) !== "unknown" || held === "unknown" ? table.floorOf(name) : joinFloors(table.floorOf(name), { values: held.map(floorOf), pastBound: false });
|
|
95
96
|
},
|
|
96
97
|
inherited: table.inherited,
|
|
97
98
|
};
|
|
@@ -51,7 +51,7 @@ export type BaseShift = {
|
|
|
51
51
|
export interface WorkdirContext {
|
|
52
52
|
readonly homeDir?: string;
|
|
53
53
|
readonly textBinds: (name: string) => boolean;
|
|
54
|
-
readonly evalEnd: (text: string, from: readonly BaseCandidate[] | "unmodelled", table:
|
|
54
|
+
readonly evalEnd: (text: string, from: readonly BaseCandidate[] | "unmodelled", table: CommandTable) => {
|
|
55
55
|
readonly end: readonly BaseCandidate[] | "unmodelled";
|
|
56
56
|
readonly physical: boolean;
|
|
57
57
|
readonly reached: ReadonlySet<string>;
|
|
@@ -151,16 +151,28 @@ export interface StdinText {
|
|
|
151
151
|
* only — bash ≥ 4.1 puts it on a descriptor of its own and leaves standard input what it was. */
|
|
152
152
|
readonly allocated?: true;
|
|
153
153
|
}
|
|
154
|
-
/**
|
|
155
|
-
*
|
|
156
|
-
|
|
157
|
-
|
|
154
|
+
/** A text as the station reads it: the {@link StdinText} and the words it is made of, where the command spells them
|
|
155
|
+
* ({@link TextSource}). The plan reports the {@link StdinText} alone ({@link stdinTextOf}). */
|
|
156
|
+
export interface InputText extends StdinText {
|
|
157
|
+
readonly source?: TextSource;
|
|
158
|
+
}
|
|
159
|
+
/** The {@link StdinText} a plan reports of an input text. */
|
|
160
|
+
export declare function stdinTextOf(input: InputText): StdinText;
|
|
161
|
+
/** The words a text is made of where the command spells them, and how the text is made of their texts (`made`): a
|
|
162
|
+
* here-string's word (the word and a newline), a here-document's body (the body), a printer's operands (what it prints,
|
|
163
|
+
* {@link printedText}). `made` answers `undefined` for a text it does not read (a word it is not handed, a printer form the
|
|
164
|
+
* station does not spell). What a builtin the text feeds binds is read off it for the deny judge alone
|
|
165
|
+
* ({@link import("./shell-read-bindings.js").sourcedFloor}). */
|
|
166
|
+
export interface TextSource {
|
|
167
|
+
readonly words: readonly Pick<LexedWord, "pieces">[];
|
|
168
|
+
readonly made: (texts: readonly (string | undefined)[]) => string | undefined;
|
|
169
|
+
}
|
|
170
|
+
/** The text a producer's words say it prints, where every one is literal ({@link printerOf}). */
|
|
158
171
|
export declare function printedBy(segment: LexedSegment): string | undefined;
|
|
159
172
|
/** What a pipe hands the segment after it: the producing segment as written, and the text it spells where it is a literal
|
|
160
|
-
* printer ({@link printedBy}). */
|
|
161
|
-
export declare function pipedTextOf(producer: LexedSegment):
|
|
162
|
-
/** The text a word that is one process substitution prints, where its
|
|
163
|
-
* `<(printf 'X')` — a script file a shell is handed, or the file its standard input is redirected from. */
|
|
173
|
+
* printer ({@link printedBy}) — its words where it is a printer ({@link printerOf}). */
|
|
174
|
+
export declare function pipedTextOf(producer: LexedSegment): InputText;
|
|
175
|
+
/** The text a word that is one process substitution prints, where its printer's words are literal ({@link processPrinterOf}). */
|
|
164
176
|
export declare function printedByProcess(word: LexedWord): string | undefined;
|
|
165
177
|
/** What may arrive on a segment's standard input: each here-document opened on descriptor 0 (one on another descriptor, `3<<EOF`, is not standard input) —
|
|
166
178
|
* its body, literal when quoted or when nothing in it expands — each here-string (literal when its word is), `<` file
|
|
@@ -168,4 +180,7 @@ export declare function printedByProcess(word: LexedWord): string | undefined;
|
|
|
168
180
|
* pipe or the input of the group it stands in, the input of the shell running its text) unless one of those three
|
|
169
181
|
* replaces it. One opened on a `{NAME}` descriptor is in the list (bash 3.2 reads it on 0) and replaces nothing (bash ≥ 4.1
|
|
170
182
|
* does not): both readings ({@link StdinText.allocated}). */
|
|
171
|
-
export declare function stdinTextsOf(segment: LexedSegment, fed: readonly
|
|
183
|
+
export declare function stdinTextsOf(segment: LexedSegment, fed: readonly InputText[]): InputText[];
|
|
184
|
+
/** What the segment's own redirections may deliver on descriptor `fd` ({@link inputTextOn}) — a builtin reading another
|
|
185
|
+
* descriptor (`read -u 3`); `fd` absent: one the text does not settle, any of them. */
|
|
186
|
+
export declare function descriptorTextsOf(segment: LexedSegment, fd: number | undefined): InputText[];
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { lexShell, literalHeredocBody, literalTextOf } from "../../shell/lex.js";
|
|
1
|
+
import { heredocBodyPieces, lexShell, literalHeredocBody, literalTextOf } from "../../shell/lex.js";
|
|
2
2
|
import { programBasename, readProgramPosition } from "./bash-program-position.js";
|
|
3
3
|
import { implementationRejects, implementationsOf, printedText, programRow, readArgRoles, selectedOptions, selectedSpellings, targetUserOf } from "./program-read-model.js";
|
|
4
4
|
import { namesStandardInput } from "./safety.js";
|
|
@@ -244,7 +244,12 @@ function scriptSourceOf(row, args) {
|
|
|
244
244
|
return { stdin: true };
|
|
245
245
|
return { file: first.at, stdin: options.some((e) => e.kind === "option" && e.reading === "speculative") };
|
|
246
246
|
}
|
|
247
|
-
export function
|
|
247
|
+
export function stdinTextOf(input) {
|
|
248
|
+
const { source: _words, ...text } = input;
|
|
249
|
+
return text;
|
|
250
|
+
}
|
|
251
|
+
const literalMade = (source) => source.made(source.words.map((w) => literalTextOf(w.pieces)));
|
|
252
|
+
function printerOf(segment) {
|
|
248
253
|
if (segment.tokens.some((t) => t.kind !== "word"))
|
|
249
254
|
return undefined;
|
|
250
255
|
const argv = segment.tokens.filter((t) => t.kind === "word");
|
|
@@ -252,36 +257,61 @@ export function printedBy(segment) {
|
|
|
252
257
|
const program = pos.program;
|
|
253
258
|
if (program === undefined || pos.refusal !== undefined || pos.launchers.length > 0 || literalTextOf(argv[program.index].pieces) === undefined)
|
|
254
259
|
return undefined;
|
|
255
|
-
|
|
260
|
+
const row = programRow(program.basename);
|
|
261
|
+
return row?.prints === undefined ? undefined : { words: argv.slice(program.index + 1), made: (texts) => printedText(row, texts) };
|
|
262
|
+
}
|
|
263
|
+
export function printedBy(segment) {
|
|
264
|
+
const printer = printerOf(segment);
|
|
265
|
+
return printer === undefined ? undefined : literalMade(printer);
|
|
256
266
|
}
|
|
257
267
|
export function pipedTextOf(producer) {
|
|
258
|
-
const
|
|
259
|
-
|
|
268
|
+
const source = printerOf(producer);
|
|
269
|
+
const printed = source === undefined ? undefined : literalMade(source);
|
|
270
|
+
return { from: `${producer.text.trim()} |`, ...(printed !== undefined ? { printed } : {}), ...(source !== undefined ? { source } : {}) };
|
|
260
271
|
}
|
|
261
|
-
|
|
272
|
+
function processPrinterOf(word) {
|
|
262
273
|
const e = word.pieces.length === 1 ? word.pieces[0].expansion : undefined;
|
|
263
274
|
if (e?.kind !== "process" || e.body === undefined || !word.raw.startsWith("<("))
|
|
264
275
|
return undefined;
|
|
265
276
|
const lexed = lexShell(e.body);
|
|
266
|
-
return "parseFailure" in lexed || lexed.segments.length !== 1 ? undefined :
|
|
277
|
+
return "parseFailure" in lexed || lexed.segments.length !== 1 ? undefined : printerOf(lexed.segments[0]);
|
|
278
|
+
}
|
|
279
|
+
export function printedByProcess(word) {
|
|
280
|
+
const printer = processPrinterOf(word);
|
|
281
|
+
return printer === undefined ? undefined : literalMade(printer);
|
|
267
282
|
}
|
|
268
283
|
export function stdinTextsOf(segment, fed) {
|
|
269
284
|
const out = [];
|
|
270
285
|
let replacesPipe = false;
|
|
271
286
|
for (const t of segment.tokens) {
|
|
272
|
-
const
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
else if (t.kind === "redirect" && (t.fd ?? 0) === 0 && (t.op === "<<<" || t.op === "<" || t.op === "<>" || (t.op === "<&" && t.dup !== "-"))) {
|
|
279
|
-
const literal = t.op === "<<<" && t.target !== undefined ? literalTextOf(t.target.pieces) : undefined;
|
|
280
|
-
const printed = t.op === "<" && t.target !== undefined ? printedByProcess(t.target) : undefined;
|
|
281
|
-
out.push({ from: `${t.op}${t.target?.raw ?? t.dup ?? ""}`, ...(literal !== undefined ? { literal } : {}), ...(printed !== undefined ? { printed } : {}), ...allocated });
|
|
282
|
-
if (!onAllocated)
|
|
283
|
-
replacesPipe = true;
|
|
284
|
-
}
|
|
287
|
+
const text = inputTextOn(t, 0);
|
|
288
|
+
if (text === undefined)
|
|
289
|
+
continue;
|
|
290
|
+
out.push(text);
|
|
291
|
+
if (t.kind === "redirect" && text.allocated !== true)
|
|
292
|
+
replacesPipe = true;
|
|
285
293
|
}
|
|
286
294
|
return replacesPipe ? out : [...fed, ...out];
|
|
287
295
|
}
|
|
296
|
+
export function descriptorTextsOf(segment, fd) {
|
|
297
|
+
return segment.tokens.flatMap((t) => {
|
|
298
|
+
const text = fd !== undefined ? inputTextOn(t, fd) : t.kind === "heredoc" || t.kind === "redirect" ? inputTextOn(t, t.fd ?? 0) : undefined;
|
|
299
|
+
return text === undefined ? [] : [text];
|
|
300
|
+
});
|
|
301
|
+
}
|
|
302
|
+
function inputTextOn(t, fd) {
|
|
303
|
+
const allocated = (t.kind === "heredoc" || t.kind === "redirect") && t.allocated === true ? { allocated: true } : {};
|
|
304
|
+
if (t.kind === "heredoc" && (t.fd ?? 0) === fd) {
|
|
305
|
+
const literal = t.quoted ? t.body : literalHeredocBody(t.body);
|
|
306
|
+
const pieces = t.quoted ? [{ span: [0, t.body.length], quotedBy: "'", literal: t.body }] : heredocBodyPieces(t.body);
|
|
307
|
+
const source = pieces === undefined ? undefined : { words: [{ pieces }], made: ([body]) => body };
|
|
308
|
+
return { from: t.body, ...(literal !== undefined ? { literal } : {}), ...(source !== undefined ? { source } : {}), ...allocated };
|
|
309
|
+
}
|
|
310
|
+
if (t.kind !== "redirect" || (t.fd ?? 0) !== fd || !(t.op === "<<<" || t.op === "<" || t.op === "<>" || (t.op === "<&" && t.dup !== "-")))
|
|
311
|
+
return undefined;
|
|
312
|
+
const literal = t.op === "<<<" && t.target !== undefined ? literalTextOf(t.target.pieces) : undefined;
|
|
313
|
+
const printer = t.op === "<" && t.target !== undefined ? processPrinterOf(t.target) : undefined;
|
|
314
|
+
const printed = printer === undefined ? undefined : literalMade(printer);
|
|
315
|
+
const source = t.op === "<<<" && t.target !== undefined ? { words: [t.target], made: ([word]) => (word === undefined ? undefined : `${word}\n`) } : printer;
|
|
316
|
+
return { from: `${t.op}${t.target?.raw ?? t.dup ?? ""}`, ...(literal !== undefined ? { literal } : {}), ...(printed !== undefined ? { printed } : {}), ...(source !== undefined ? { source } : {}), ...allocated };
|
|
317
|
+
}
|
package/dist/tools/monitor.d.ts
CHANGED
|
@@ -44,6 +44,7 @@ import { type MonitorTimers, type TaskRegistry } from "../core/task-registry.js"
|
|
|
44
44
|
import { type TaskNotificationPayload } from "../core/task-notification.js";
|
|
45
45
|
import type { ShellReadAdmission } from "./fs/shell-read-check.js";
|
|
46
46
|
import type { ReadFloorSeat } from "./fs/read-floor.js";
|
|
47
|
+
import { type CommandSandboxSeat } from "../core/command-sandbox.js";
|
|
47
48
|
/** The refusal a watch gets where no event or completion would come back from it (no completion sink for the call, no
|
|
48
49
|
* mount sink): nothing is spawned. */
|
|
49
50
|
export declare const MONITOR_NO_COMPLETION_CHANNEL = "Error (Monitor): a watch is not available here \u2014 no event or final notification would come back from one on this mount. Run the command in the foreground (with a timeout) instead.";
|
|
@@ -79,6 +80,9 @@ export interface MonitorToolOptions {
|
|
|
79
80
|
/** The byte floor's seat (read-floor.ts) — the SAME table the shell faces carry: the watched command's start hands it to
|
|
80
81
|
* the environment. Absent ⇒ the start carries no floor. */
|
|
81
82
|
readFloor?: ReadFloorSeat;
|
|
83
|
+
/** The command sandbox seat (`command-sandbox.ts`) — the SAME one the shell faces take: the watched command's start hands
|
|
84
|
+
* its call's sandbox instruction to the environment, or is refused. Absent ⇒ the start carries no sandbox. */
|
|
85
|
+
commandSandbox?: CommandSandboxSeat;
|
|
82
86
|
/** RB-465-b (HRD-PTL-3 残件): spec-level retain (`TaskSpec.retainBackgroundProcesses`) — the task lane of
|
|
83
87
|
* THE retain predicate (`retainsBackgroundProcesses`), OR-composed with the env capability. Read twice,
|
|
84
88
|
* by the same predicate: the persistent-watch receipt's wording, and the row's `retained` mark at
|
package/dist/tools/monitor.js
CHANGED
|
@@ -5,8 +5,11 @@ import { MONITOR_DEFAULT_TIMEOUT_MS, MONITOR_MAX_TIMEOUT_MS, } from "../core/tas
|
|
|
5
5
|
import { admitsBackgroundLaunch, resolveCompletionSink } from "../core/task-notification.js";
|
|
6
6
|
import { toolFace } from "../core/tool-catalog-entries.js";
|
|
7
7
|
import { ONE_SHOT_BACKGROUND_COMMAND_NOTE } from "./fs/fs-bash-background-text.js";
|
|
8
|
+
import { sandboxRefusalText } from "../core/command-sandbox.js";
|
|
8
9
|
import { isDeadCwd, diagnoseDeadCwd } from "./fs/dead-cwd.js";
|
|
10
|
+
import { envErrorDetail } from "./fs/env-error-detail.js";
|
|
9
11
|
import { thrownText } from "../core/thrown-value.js";
|
|
12
|
+
import { callScopeOf } from "../core/isolation-scope.js";
|
|
10
13
|
export const MONITOR_NO_COMPLETION_CHANNEL = "Error (Monitor): a watch is not available here — no event or final notification would come back from one on this mount. Run the command in the foreground (with a timeout) instead.";
|
|
11
14
|
const MONITOR_DESCRIPTION = "Run a shell command in the background and watch its stdout as a stream of events.\n" +
|
|
12
15
|
"\n" +
|
|
@@ -86,16 +89,23 @@ export function createMonitorTool(env, opts) {
|
|
|
86
89
|
if (ctx.signal?.aborted === true)
|
|
87
90
|
return errorResult("Error (Monitor): the call was cancelled before the watch started.");
|
|
88
91
|
const readFloor = opts.readFloor?.(ctx.toolCallId);
|
|
92
|
+
const sandbox = opts.commandSandbox?.();
|
|
93
|
+
if (sandbox !== undefined && !sandbox.ok)
|
|
94
|
+
return errorResult(sandboxRefusalText("Monitor", { by: "gate" }), { type: "monitor-start", sandboxUnavailable: true });
|
|
89
95
|
const spawn = await env.spawnBackground(command, {
|
|
90
96
|
...(opts.cwdRef !== undefined ? { cwd: opts.cwdRef.current } : {}),
|
|
91
97
|
...(spawnTimeoutSec !== undefined ? { timeout: spawnTimeoutSec } : {}),
|
|
92
98
|
...(readFloor !== undefined ? { readFloor } : {}),
|
|
99
|
+
...(sandbox?.sandbox !== undefined ? { sandbox: sandbox.sandbox } : {}),
|
|
93
100
|
});
|
|
94
|
-
if (!spawn.ok)
|
|
95
|
-
|
|
101
|
+
if (!spawn.ok) {
|
|
102
|
+
if (spawn.error.code === "sandbox_unavailable")
|
|
103
|
+
return errorResult(sandboxRefusalText("Monitor", { by: "environment", detail: envErrorDetail(spawn.error.message), refusedBy: spawn.error.refusedBy }), { type: "monitor-start", sandboxUnavailable: true, refusedBy: spawn.error.refusedBy ?? "environment" });
|
|
104
|
+
return errorResult(`Error (Monitor): ${envErrorDetail(spawn.error.message)}`);
|
|
105
|
+
}
|
|
96
106
|
const sessionScoped = isPersistent && opts.sessionId !== undefined;
|
|
97
107
|
const owner = sessionScoped ? opts.sessionId : (ctx.taskId ?? opts.owner);
|
|
98
|
-
const scope = ctx
|
|
108
|
+
const scope = callScopeOf(ctx, opts);
|
|
99
109
|
const outputFile = await createBackgroundOutputFile(env, "monitor-task-");
|
|
100
110
|
let taskId;
|
|
101
111
|
try {
|
|
@@ -125,7 +135,7 @@ export function createMonitorTool(env, opts) {
|
|
|
125
135
|
try {
|
|
126
136
|
const kill = await env.killBackground(spawn.value.shellId);
|
|
127
137
|
if (!kill.ok)
|
|
128
|
-
killDetail = `${kill.error.code}: ${kill.error.message}`;
|
|
138
|
+
killDetail = `${kill.error.code}: ${envErrorDetail(kill.error.message)}`;
|
|
129
139
|
}
|
|
130
140
|
catch (killErr) {
|
|
131
141
|
killDetail = thrownText(killErr);
|