@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
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
import { type LexedRedirect, type LexedSegment, type LexedToken, type LexedWord } from "../../shell/lex.js";
|
|
30
30
|
import { readProgramPosition } from "./bash-program-position.js";
|
|
31
31
|
import { type DeclaredAttribute } from "./program-read-model.js";
|
|
32
|
-
import { type
|
|
32
|
+
import { type InputText, type TextSource } from "./shell-reentry-text.js";
|
|
33
33
|
import { type BuiltinState } from "./shell-read-builtins.js";
|
|
34
34
|
/** A value a name may hold — the text the program receives ({@link spelled}: what a shell re-parsing it reads), literal
|
|
35
35
|
* throughout, or a PATTERN whose matches are the values (a `for` list word the shell globs before the loop binds it;
|
|
@@ -68,12 +68,21 @@ export interface FloorValue {
|
|
|
68
68
|
/** A value a binding that may not have run left an unknown name (#3536, {@link BindingTable.floorOf}): it yields to the
|
|
69
69
|
* floor reader's bound before any other ({@link wordFloorValues}). */
|
|
70
70
|
readonly held?: true;
|
|
71
|
+
/** A spelling of one PIECE of a word, not of the word, where another piece transforms what its name stores ({@link floorCombos}),
|
|
72
|
+
* or one made with or cut from such a spelling ({@link sourcedFloor}): the word may spell it, but nothing says it does — the
|
|
73
|
+
* deny judge reads it as a spelling the shell rewrites the word into, never one the plan places (a removal judges the word). */
|
|
74
|
+
readonly piece?: true;
|
|
71
75
|
}
|
|
72
76
|
/** A pattern value's names as a reader judges them, where that is not its spelling: its runs, a class the judge widens
|
|
73
77
|
* as `?` (the lexer's `WordExpansion.pattern.judged`), a leading `~` the literal tilde it is. */
|
|
74
78
|
export declare function judgedSpellingOf(v: BoundValue): string | undefined;
|
|
75
79
|
/** A value as a deny-floor spelling, its judged spelling with it. */
|
|
76
80
|
export declare function floorOf(v: BoundValue): FloorValue;
|
|
81
|
+
/** The values a binding gives its name as deny-floor spellings — what it holds where the text spells it, and its own floor —
|
|
82
|
+
* the spellings a kill of that name carries where the binding may have run before the reader ({@link BindingThread.kill}). */
|
|
83
|
+
export declare function bindingValues(b: Binding): WordFloor;
|
|
84
|
+
/** What bindings give their names ({@link bindingValues}), joined name by name. */
|
|
85
|
+
export declare function bindingFloors(bindings: Iterable<Binding>): Map<string, WordFloor>;
|
|
77
86
|
/** The values a name may hold where the text settles it. */
|
|
78
87
|
export type NameValues = readonly BoundValue[];
|
|
79
88
|
/** What a name holds at one point of a text: its possible values, or `"unknown"`. (The values are a NAMED arm: the
|
|
@@ -150,14 +159,24 @@ export interface Binding {
|
|
|
150
159
|
readonly name: string;
|
|
151
160
|
readonly state: NameState;
|
|
152
161
|
readonly prefix?: true;
|
|
162
|
+
/** The binding writes PART of the name, or the bash running the text may lack it ({@link SourcedName.keeps}): it takes
|
|
163
|
+
* effect, and what the name held stays beside it — read later as a binding beside the earlier ones; the segment's own
|
|
164
|
+
* later words read what it binds. */
|
|
165
|
+
readonly keeps?: true;
|
|
153
166
|
readonly loopVar?: true;
|
|
154
|
-
/** `local`: a plain `local NAME…`
|
|
167
|
+
/** `local`: a plain `local NAME…` (or `declare` / `typeset` with no option, {@link BODY_SCOPED_DECLARATIONS}) — in a
|
|
168
|
+
* function body the name is the body's own and never leaves it. `unread`: a
|
|
155
169
|
* declaration builtin with an option word (`declare -g`, `local -p`, `local -r`): which scope it binds in is not
|
|
156
170
|
* read, so it is neither the body's own name nor covered by an earlier `local`. */
|
|
157
171
|
readonly scope?: "local" | "unread";
|
|
158
172
|
/** Spellings the name may hold that the deny judge still reads where the name is otherwise unknown (an array's
|
|
159
|
-
* elements: what `${A[k]}` expands to is one of them
|
|
160
|
-
|
|
173
|
+
* elements: what `${A[k]}` expands to is one of them; the whole floor of the word an assignment binds it from,
|
|
174
|
+
* {@link assignedFloor}). */
|
|
175
|
+
readonly floor?: WordFloor;
|
|
176
|
+
/** The name's WHOLE value as a list: the elements of a compound `NAME=(…)` every one of which is a plain literal word
|
|
177
|
+
* ({@link literalElementsOf}). The name stays `unknown` to every scalar reader; only the one reader of a quoted all-elements
|
|
178
|
+
* expansion ({@link BindingTable.arrayOf}) reads the list, and only where this binding is the name's latest. */
|
|
179
|
+
readonly array?: readonly BoundValue[];
|
|
161
180
|
}
|
|
162
181
|
/** An attribute a declaration gives a name — or every name (`name` absent: the declaration computed it): a later
|
|
163
182
|
* assignment to it is evaluated as arithmetic (`integer`), stores a case change or an array element (`transformed`), or
|
|
@@ -181,6 +200,13 @@ export interface BindingEffect {
|
|
|
181
200
|
/** How one value word reads against the table, the earlier assignments of the same segment applied (bash assigns left
|
|
182
201
|
* to right): its possible values, or `unknown`. */
|
|
183
202
|
export type ValueReader = (word: Pick<LexedWord, "pieces">, quoted: boolean, overlay: ReadonlyMap<string, NameState>) => NameState;
|
|
203
|
+
/** How one value word's deny floor reads against the table ({@link wordFloorValues}), the earlier assignments of the same
|
|
204
|
+
* segment applied — what they store (`overlay`) and the floors they hand their names (`floors`). */
|
|
205
|
+
export type FloorReader = (word: Pick<LexedWord, "pieces">, overlay: ReadonlyMap<string, NameState>, floors: ReadonlyMap<string, WordFloor>) => WordFloor;
|
|
206
|
+
/** A reader with no table: no name is read, so no word's floor says anything. */
|
|
207
|
+
export declare const NO_FLOOR_READER: FloorReader;
|
|
208
|
+
/** The floor reader of a table ({@link FloorReader}): a name the segment's earlier assignments bound reads what they bound. */
|
|
209
|
+
export declare function floorReaderOf(table: FloorTable): FloorReader;
|
|
184
210
|
/** The segment's shape the effect needs beside its words: the functions whose definition heads were dropped from it. */
|
|
185
211
|
export interface SegmentShape {
|
|
186
212
|
readonly defines: readonly string[];
|
|
@@ -229,12 +255,28 @@ export declare function namesIn(word: Pick<LexedWord, "pieces">): string[];
|
|
|
229
255
|
* (a value then carries its {@link BoundValue} `fields`).
|
|
230
256
|
*/
|
|
231
257
|
export declare function valueOf(word: Pick<LexedWord, "pieces">, table: BindingTable | undefined, quoted: boolean, overlay?: ReadonlyMap<string, NameState>, split?: boolean): NameState;
|
|
258
|
+
/** A deny floor — a word's ({@link wordFloorValues}) or a name's ({@link BindingTable.floorOf}): the spellings, and whether a
|
|
259
|
+
* reader's bound let some go (`pastBound`) — the word, or the name, may then hold a value the floor no longer holds, which
|
|
260
|
+
* the deny judge cannot rule out. A name's floor is past its bound where a word's floor handed it on was (a call's own
|
|
261
|
+
* command environment, {@link BindingThread.callEnvironmentValues}): every word that reads the name is then past it too. */
|
|
262
|
+
export interface WordFloor {
|
|
263
|
+
readonly values: readonly FloorValue[];
|
|
264
|
+
readonly pastBound: boolean;
|
|
265
|
+
}
|
|
266
|
+
/** What a word's deny floor reads of the table: what each name holds, and each name's own floor. */
|
|
267
|
+
export type FloorTable = Pick<BindingTable, "stateOf" | "floorOf">;
|
|
268
|
+
/** No spelling, nothing let go. */
|
|
269
|
+
export declare const NO_FLOOR: WordFloor;
|
|
270
|
+
/** A floor that says nothing: no spelling, and nothing let go — no floor at all. */
|
|
271
|
+
export declare function isEmptyFloor(f: WordFloor): boolean;
|
|
272
|
+
/** Floors as one: every spelling of each, past its bound where any is. */
|
|
273
|
+
export declare function joinFloors(...floors: readonly WordFloor[]): WordFloor;
|
|
232
274
|
/**
|
|
233
275
|
* The spellings a word the table leaves unknown may still take through the deny floors of the names it refers to
|
|
234
276
|
* ({@link BindingTable.floorOf}) — `${A[k]}`, `${A[@]}`, `$A` reading an array's elements — or through their values where
|
|
235
277
|
* known: for the deny judge alone. Empty where some name it refers to leaves neither.
|
|
236
278
|
*/
|
|
237
|
-
export declare function wordFloorValues(word: Pick<LexedWord, "pieces">, table:
|
|
279
|
+
export declare function wordFloorValues(word: Pick<LexedWord, "pieces">, table: FloorTable | undefined): WordFloor;
|
|
238
280
|
/** Where a segment's argv heads a `for` / `select` loop: the index of that bare word, at the segment's start or past the
|
|
239
281
|
* bare control words in front of it (`do for x in …`, `then for …` — a loop nested in a body or a branch); `undefined`
|
|
240
282
|
* for any other segment. */
|
|
@@ -246,8 +288,9 @@ export declare function loopListHeadAt(argv: readonly LexedWord[]): number | und
|
|
|
246
288
|
* builtin of its name does not run — the call's effect is the body's; `maybe`: it may be one, so what the builtin binds is one
|
|
247
289
|
* more value its names may hold). `availability`: whether the builtin of a name runs by it where the segment stands
|
|
248
290
|
* ({@link BuiltinState}) — `disabled`: the word finds no command and binds nothing, `maybe`: as a function that may stand.
|
|
291
|
+
* `readFloor`: a value word's deny floor against the same table ({@link assignedFloor}; with no table, none).
|
|
249
292
|
*/
|
|
250
|
-
export declare function bindingEffectOf(segment: LexedSegment, argv: readonly LexedWord[], shape: SegmentShape, readValue: ValueReader, shadow?: "named" | "maybe", availability?: (builtin: string) => BuiltinState, fed?: readonly
|
|
293
|
+
export declare function bindingEffectOf(segment: LexedSegment, argv: readonly LexedWord[], shape: SegmentShape, readValue: ValueReader, shadow?: "named" | "maybe", availability?: (builtin: string) => BuiltinState, fed?: readonly InputText[], fedByLoop?: boolean, splitUnsettled?: boolean, readFloor?: FloorReader): BindingEffect;
|
|
251
294
|
/** Does this assignment store ARRAY ELEMENTS — a compound value `(…)`, or a subscripted name `a[k]=v`? Bash never exports
|
|
252
295
|
* an array (an element assigned to an exported scalar makes it an array, gone from every child's environment): what it
|
|
253
296
|
* stores reaches a program only through a word that reads an element — the element floor it leaves here ({@link
|
|
@@ -258,6 +301,39 @@ export declare function bindsArrayElement(a: Pick<NonNullable<LexedWord["assignm
|
|
|
258
301
|
/** Do a segment's leading assignment words stand alone — the shell itself binds them — rather than prefix a command whose
|
|
259
302
|
* environment they are? The binding rule and the read plan's environment candidates ask the same question. */
|
|
260
303
|
export declare function assignsAsStatement(pos: ReturnType<typeof readProgramPosition>): boolean;
|
|
304
|
+
/**
|
|
305
|
+
* A name a builtin binds from texts the command spells — a SOURCED binding: the texts that may reach it (`sources`, each one
|
|
306
|
+
* text that may arrive: the words it is made of and how, {@link TextSource}) and how the builtin cuts one text into the values
|
|
307
|
+
* the name may then hold (`cut`). The road of every builtin that binds a word to a name otherwise than as `NAME=word` — `read`
|
|
308
|
+
* / `mapfile` fed a here-string, a here-document or a printer's pipe, `printf -v`, `getopts`, a `for` / `select` list, a
|
|
309
|
+
* declaration operand the builtin does not store as written ({@link sourcedNamesOf}).
|
|
310
|
+
*/
|
|
311
|
+
export interface SourcedName {
|
|
312
|
+
readonly name: string;
|
|
313
|
+
readonly sources: readonly TextSource[];
|
|
314
|
+
readonly cut: (text: string) => readonly string[];
|
|
315
|
+
/** What the name may hold of a spelling that is only a PIECE of the text (a word the station does not make into the text,
|
|
316
|
+
* one value of several a word joins): `cut` where absent. */
|
|
317
|
+
readonly piece?: (text: string) => readonly string[];
|
|
318
|
+
/** The cut is not the builtin's own — the text does not settle how it splits — so the name may hold a piece the cut does
|
|
319
|
+
* not make: a floor with any spelling is past its bound. */
|
|
320
|
+
readonly loose?: true;
|
|
321
|
+
/** The builtin writes PART of the name — an element (`read 'b[1]'`), elements past an origin (`mapfile -O`), an entry of a
|
|
322
|
+
* table the shell keeps (`BASH_ALIASES`, `BASH_CMDS`) — and leaves the rest as it was, or the bash running the text may
|
|
323
|
+
* lack it (`mapfile` before 4, `compgen -V` before 5.3) and bind nothing: what the name held stays beside what it binds
|
|
324
|
+
* ({@link Binding.keeps}), as an element assignment's does. */
|
|
325
|
+
readonly keeps?: true;
|
|
326
|
+
}
|
|
327
|
+
/**
|
|
328
|
+
* THE SOURCED FLOOR — the deny floor a sourced binding ({@link SourcedName}) hands its name, the one reading `NAME=word` takes
|
|
329
|
+
* ({@link assignedFloor}) carried through the builtin: each source word read for every spelling it may take (`spellingsOf`:
|
|
330
|
+
* its values where the table settles them, else its own floor), every combination made into the source's text and cut as
|
|
331
|
+
* the builtin cuts a settled text — so a reader of the name reads what the sources may spell as it would read the sources.
|
|
332
|
+
* Where a source makes no text of some combination (a form the station does not spell, a word with no spelling), each word's
|
|
333
|
+
* own spellings are cut instead, never dropped (#3536's law); past the reader's bound the floor is too. What is cut of a
|
|
334
|
+
* word's piece spelling ({@link FloorValue.piece}), or of a text made with one, is a piece too.
|
|
335
|
+
*/
|
|
336
|
+
export declare function sourcedFloor(bound: SourcedName, spellingsOf: (word: Pick<LexedWord, "pieces">) => WordFloor): WordFloor;
|
|
261
337
|
/**
|
|
262
338
|
* The names an ARITHMETIC text may assign: every identifier in a text that carries an assignment operator (`=` that is no
|
|
263
339
|
* comparison, `+=` and its kin, `++`, `--`) — read whole, not parsed: a name only compared there is made unknown too.
|
|
@@ -265,7 +341,11 @@ export declare function assignsAsStatement(pos: ReturnType<typeof readProgramPos
|
|
|
265
341
|
export declare function arithmeticAssignedNames(text: string): string[];
|
|
266
342
|
/** The names a text binds anywhere (every segment, every name the binding rule reads), or `all` where it may bind any
|
|
267
343
|
* name — for a body that runs later. Unreadable text binds any. */
|
|
268
|
-
export declare function namesBoundIn(text: string
|
|
344
|
+
export declare function namesBoundIn(text: string): ReadonlySet<string> | "all";
|
|
345
|
+
/** {@link namesBoundIn}, each name with the values the text binds it to as it spells them ({@link bindingValues}) — its
|
|
346
|
+
* segments read as a text's own are, a value read where it is a literal ({@link valueOf} without a table): what a body
|
|
347
|
+
* run later may leave the name, the deny floor its binding carries. */
|
|
348
|
+
export declare function bindingsIn(text: string): ReadonlyMap<string, WordFloor> | "all";
|
|
269
349
|
/**
|
|
270
350
|
* Does this text bind `HOME` anywhere (or every name)? — the question a reader that spells the declared home for `~` /
|
|
271
351
|
* `$HOME` asks of a text it reads as ONE unit (the read-only classifier's segments). The read station asks the
|
|
@@ -283,12 +363,14 @@ export interface InheritedNames {
|
|
|
283
363
|
readonly references: boolean;
|
|
284
364
|
/** The deny floors a name starts the text with ({@link BindingTable.floorOf}): what the words handing it this text as
|
|
285
365
|
* written may name there — or, for a substitution body, the floors its segment reads. */
|
|
286
|
-
readonly floors?: ReadonlyMap<string,
|
|
366
|
+
readonly floors?: ReadonlyMap<string, WordFloor>;
|
|
287
367
|
/** The names something before the nested text may have changed — a change that can reach where it starts, and the
|
|
288
368
|
* names its own segment's command environment sets (`TMPDIR=… bash -c …`): there such a name no longer holds what the
|
|
289
369
|
* shell provides ({@link BindingTable.providedByShell}). `all`: any name. Absent: none. */
|
|
290
370
|
readonly rebound?: ReadonlySet<string> | "all";
|
|
291
371
|
}
|
|
372
|
+
/** Sets of deny floors as one, read when asked: each name's floors from each set, in order. */
|
|
373
|
+
export declare function joinedFloors(...sets: readonly (ReadonlyMap<string, WordFloor> | undefined)[]): ReadonlyMap<string, WordFloor>;
|
|
292
374
|
/** The function and builtin keys of the shell a text runs in — a literal `eval` text, a substitution body (a fork): what each key
|
|
293
375
|
* holds where the text starts (the outer table's answer for it), and the names a call to one of the outer functions may change. */
|
|
294
376
|
export interface InheritedFunctions {
|
|
@@ -300,14 +382,19 @@ export declare function joinRebound(a: ReadonlySet<string> | "all" | undefined,
|
|
|
300
382
|
/** What the thread answers for one reader: what a name may hold, and whether a name carries the integer attribute. */
|
|
301
383
|
export interface BindingTable {
|
|
302
384
|
stateOf(name: string): NameState;
|
|
385
|
+
/** The elements the name holds as a LIST here — where its latest binding that exists for this reader is a compound literal that
|
|
386
|
+
* certainly ran ({@link Binding.array}) and nothing since may have changed it; `undefined` otherwise (and for every name that is
|
|
387
|
+
* no such list: the name's scalar state is `unknown` all the same). */
|
|
388
|
+
arrayOf(name: string): readonly BoundValue[] | undefined;
|
|
303
389
|
/** Values assigned to this name are evaluated as arithmetic. */
|
|
304
390
|
isInteger(name: string): boolean;
|
|
305
391
|
/** The text may have changed `IFS` before this point: an unquoted expansion is split on what the text does not say. */
|
|
306
392
|
readonly ifsTouched: boolean;
|
|
307
393
|
/** `HOME` may hold something other than the declared home here. */
|
|
308
394
|
readonly homeTouched: boolean;
|
|
309
|
-
/** Every spelling any binding of this name before here left for the deny judge alone ({@link Binding.floor})
|
|
310
|
-
|
|
395
|
+
/** Every spelling any binding of this name before here left for the deny judge alone ({@link Binding.floor}), and whether
|
|
396
|
+
* a word's floor handed on to it was past its bound ({@link WordFloor.pastBound}). */
|
|
397
|
+
floorOf(name: string): WordFloor;
|
|
311
398
|
/** What a substitution body here starts with. */
|
|
312
399
|
readonly inherited: InheritedNames;
|
|
313
400
|
/** The names a change that can reach this point touched — a binding, or a name made unknown, that may run before it in
|
|
@@ -334,8 +421,9 @@ export interface BindingTable {
|
|
|
334
421
|
* pipeline member that is not the last, a background job — a substitution body is a text of its own) and one in a
|
|
335
422
|
* function body is NOT a binding for it. A function body runs at its call: a call the plan can see (a program word
|
|
336
423
|
* naming one of the text's functions, a code body a builtin runs later, which may name one) makes every name a body
|
|
337
|
-
* binds unknown from that segment on ({@link functionBound})
|
|
338
|
-
*
|
|
424
|
+
* binds unknown from that segment on ({@link functionBound}) — a kill that may not have run ({@link kill}): what the name
|
|
425
|
+
* held stays its deny floor; a text the plan does not read (`eval`, `source`, a computed program word) already makes every
|
|
426
|
+
* name unknown, the same way. The last member of a pipeline may or may not run in this
|
|
339
427
|
* shell: its bindings join the values before them. A body's own readers follow its own order; a reader in another body
|
|
340
428
|
* loses a name any other body binds ({@link Unreadable}). A name the body declares with a plain `local` (before the
|
|
341
429
|
* binding, where the declaration certainly ran) never leaves it.
|
|
@@ -345,7 +433,7 @@ export interface BindingTable {
|
|
|
345
433
|
*/
|
|
346
434
|
export declare class BindingThread {
|
|
347
435
|
private readonly segments;
|
|
348
|
-
/** What each segment binds
|
|
436
|
+
/** What each segment binds: its names, and a value only where it is a literal (the rest is the reader's to read). */
|
|
349
437
|
private readonly named;
|
|
350
438
|
/** The state a name starts the text in (and is reset to by a function body): the declared home for `HOME`. */
|
|
351
439
|
private readonly initial;
|
|
@@ -378,7 +466,7 @@ export declare class BindingThread {
|
|
|
378
466
|
/** Where a function body runs ({@link runsBodies}): the last segment that can call one, and the command environment of each call. */
|
|
379
467
|
private bodyRuns;
|
|
380
468
|
constructor(segments: readonly LexedSegment[],
|
|
381
|
-
/** What each segment binds
|
|
469
|
+
/** What each segment binds: its names, and a value only where it is a literal (the rest is the reader's to read). */
|
|
382
470
|
named: readonly BindingEffect[],
|
|
383
471
|
/** The state a name starts the text in (and is reset to by a function body): the declared home for `HOME`. */
|
|
384
472
|
initial: (name: string) => NameState,
|
|
@@ -418,6 +506,12 @@ export declare class BindingThread {
|
|
|
418
506
|
* has applied so far are the ones that precede it. A `local` counts like any binding: it shortens a name's life, not the
|
|
419
507
|
* view of a reader that runs inside its extent (a body called from there, a `trap` text it sets). */
|
|
420
508
|
private boundLater;
|
|
509
|
+
/** What call `c`'s own command environment hands the body it runs for `name` — the assignment word in front of the program
|
|
510
|
+
* (`p=x f`: the body reads `x`), the floor it hands the name read against the table at the call ({@link assignedFloor}, the
|
|
511
|
+
* one reading every road that binds a name from a word takes) — or `undefined` where that environment does not set the
|
|
512
|
+
* name ({@link runsBodies}' `environment`), or sets it to a value whose floor says nothing (the table's values at the call
|
|
513
|
+
* then stay the floor). */
|
|
514
|
+
private callEnvironmentValues;
|
|
421
515
|
/** Does a binding segment `at` makes, standing at `standing`, run in a subshell of its own — a pipeline member that is
|
|
422
516
|
* not the last, a background job? A segment's closing pipe or `&` ends ITS LAST command, at the depth that command
|
|
423
517
|
* stands: a binding that stands shallower (a function definition's head, in front of the block its body opens in the
|
|
@@ -432,18 +526,20 @@ export declare class BindingThread {
|
|
|
432
526
|
* runs in a subshell of its own (a pipeline member that is not the last, a background job), or stands in a `( … )`
|
|
433
527
|
* group the reader is not in. */
|
|
434
528
|
private visible;
|
|
529
|
+
/** Is a binding segment `at` makes, standing at `standing`, made in the shell a reader at segment `j` runs in (`j` absent: the
|
|
530
|
+
* text's end)? Not where it runs in a subshell of its own (a pipeline member that is not the last, a background job) or
|
|
531
|
+
* stands in a `( … )` group the reader is not in: nothing a subshell binds — a value, a deny floor — leaves it. (A function
|
|
532
|
+
* body is no subshell: what it binds reaches its callers, {@link kill}.) */
|
|
533
|
+
private inShellOf;
|
|
435
534
|
/** Where the binding `name` of segment `at` is made: the segment's own place, or — a function definition — where its head
|
|
436
535
|
* stands. */
|
|
437
536
|
private standingOf;
|
|
438
537
|
/** The names any of the text's function bodies binds — what a call to one of them may change — or `all` where a body
|
|
439
538
|
* may bind any name. A name the body keeps `local` ({@link leavesBody}) stays in it. */
|
|
440
539
|
functionBound(): ReadonlySet<string> | "all";
|
|
441
|
-
/**
|
|
442
|
-
*
|
|
443
|
-
|
|
444
|
-
* name may hold (detached), never as a certainty — the value before the call stays the deny floor (#3536's law; #3566).
|
|
445
|
-
* A name the body ALSO binds certainly is not here: that binding makes the call's kill certain. */
|
|
446
|
-
functionMaybeBound(): ReadonlySet<string>;
|
|
540
|
+
/** {@link functionBound}, each name with the values the bodies bind it to as the text spells them ({@link bindingValues}):
|
|
541
|
+
* what a call may leave the name, the deny floor its kill carries ({@link kill}). */
|
|
542
|
+
functionBindings(): ReadonlyMap<string, WordFloor> | "all";
|
|
447
543
|
/** The function body a binding segment `at` makes belongs to, where the name can outlive it: the body it stands in — a
|
|
448
544
|
* plain `local NAME` is the body's own and never leaves it (an optioned declaration, `declare -g` / `local -p`, reads no
|
|
449
545
|
* scope, so it can). What a reader in ANOTHER body loses ({@link unreadableBy}); a call to the body changes it unless a
|
|
@@ -487,11 +583,16 @@ export declare class BindingThread {
|
|
|
487
583
|
* function body other than the one that binds it? */
|
|
488
584
|
private lostAt;
|
|
489
585
|
/** Make these names unknown from segment `at` on (a loop body that binds them may have run before any of its beats; a
|
|
490
|
-
* call runs a body that binds them)
|
|
491
|
-
|
|
586
|
+
* call runs a body that binds them) — as a binding that may not have run, the one reading #3536 gives one: a beat may
|
|
587
|
+
* not come, a body's binding may sit behind a branch it does not take, the body called may not be the one that binds
|
|
588
|
+
* the name (the call does not name its body), so what the name held before stays its deny floor. And what the body binds
|
|
589
|
+
* may have run: `carried` — the values the body binds each name to ({@link bindingValues}) — joins that floor. */
|
|
590
|
+
kill(at: number, names: Iterable<string> | "all", carried?: ReadonlyMap<string, WordFloor>): void;
|
|
492
591
|
/** The table a reader at segment `j` sees; `andRunStart` = the first segment of `j`'s `&&` run; `where` = what the
|
|
493
|
-
* working-directory thread says `PWD` / `OLDPWD` hold there (absent: it does not say — both unknown).
|
|
494
|
-
|
|
592
|
+
* working-directory thread says `PWD` / `OLDPWD` hold there (absent: it does not say — both unknown). `asked`: the calls
|
|
593
|
+
* a reading of a name already reads, each name's own ({@link atCalls} — a table read at a call it asks; absent: a fresh
|
|
594
|
+
* reading per name). */
|
|
595
|
+
tableAt(j: number, andRunStart: number, where?: WorkingDirectoryState, asked?: Map<string, Set<number>>): BindingTable;
|
|
495
596
|
}
|
|
496
597
|
/** A segment that opens with `((`: an arithmetic command (or a subshell in a subshell — the tokens are the same). */
|
|
497
598
|
export declare function isArithmeticCommand(segment: LexedSegment): boolean;
|
|
@@ -510,8 +611,9 @@ export declare function parameterBodySubstitutions(body: string, table: BindingT
|
|
|
510
611
|
* evaluates a variable's value as arithmetic too, through any chain of names). A name the table does not settle
|
|
511
612
|
* contributes the literal values its bindings left (an array's elements) and nothing else: any other value is data the
|
|
512
613
|
* text does not hold. A name already on the chain is a cycle (bash refuses
|
|
513
|
-
* it). Each body is shell text the evaluator re-enters; past the reader's budget of values
|
|
514
|
-
*
|
|
614
|
+
* it). Each body is shell text the evaluator re-enters; past the reader's budget of values — or where a name's floor is
|
|
615
|
+
* past its own ({@link WordFloor.pastBound}: a value the text holds was let go) — the text itself is handed back as a
|
|
616
|
+
* body, so the segment re-enters text it did not follow (unestablished, never silent).
|
|
515
617
|
*/
|
|
516
618
|
export declare function arithmeticSubstitutions(text: string, table: BindingTable | undefined, chain?: ReadonlySet<string>, budget?: {
|
|
517
619
|
left: number;
|