@sema-agent/core 7.66.0 → 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 +3498 -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 +13 -3
- package/dist/core/runner/prepare-park-ask.js +25 -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 +7 -6
- 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.66.1.json +30 -0
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.66.1.json +46 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.66.1.json +30 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.66.1.json +30 -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
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
import { join } from "node:path";
|
|
2
2
|
import { receiveRetentionPolicy } from "../../core/retention-policy.js";
|
|
3
|
-
import { WorkflowRunStoreError, isTerminalWorkflowStatus, nextWorkflowRunOnUpdate, queryWorkflowRuns, WORKFLOW_RUN_REAP_KNOBS, } from "../../core/workflow-run-store.js";
|
|
3
|
+
import { WorkflowRunStoreError, admitWorkflowRun, isTerminalWorkflowStatus, nextWorkflowRunOnUpdate, queryWorkflowRuns, readStoredWorkflowRun, workflowRunReapCandidates, WORKFLOW_RUN_REAP_KNOBS, WORKFLOW_RUN_ROW_SHAPE, } from "../../core/workflow-run-store.js";
|
|
4
4
|
import { SharedLedgerTable } from "./shared-ledger.js";
|
|
5
5
|
import { guardCorruptSink } from "./corrupt-read-sink.js";
|
|
6
6
|
import { assertAdoptionBootGate } from "./adoption/marker.js";
|
|
7
7
|
import { optionKeys, receiveOptions } from "../../core/own-property-receipt.js";
|
|
8
8
|
import { readLedgerTuning } from "./ledger-tuning.js";
|
|
9
9
|
const FILE_WORKFLOW_RUN_STORE_OPTION_KEYS = optionKeys()({ fsync: 0, compactEvery: 0, onCorruptRead: 0 });
|
|
10
|
-
const isRunRow = (x) => x
|
|
10
|
+
const isRunRow = (x) => WORKFLOW_RUN_ROW_SHAPE.rowKey(x);
|
|
11
11
|
const runLedgers = new SharedLedgerTable({
|
|
12
12
|
label: "workflow-run ledger",
|
|
13
13
|
keyOf: (run) => run.id,
|
|
@@ -31,6 +31,7 @@ export class FileWorkflowRunStore {
|
|
|
31
31
|
compactEvery;
|
|
32
32
|
ledger;
|
|
33
33
|
closed = false;
|
|
34
|
+
disclose;
|
|
34
35
|
get runs() {
|
|
35
36
|
return this.ledger.rows;
|
|
36
37
|
}
|
|
@@ -41,11 +42,14 @@ export class FileWorkflowRunStore {
|
|
|
41
42
|
this.fsyncEnabled = tuning.fsync;
|
|
42
43
|
this.compactEvery = tuning.compactEvery;
|
|
43
44
|
const dir = join(root, "workflow-runs");
|
|
45
|
+
const sink = guardCorruptSink(opts.onCorruptRead);
|
|
46
|
+
const ledgerPath = join(dir, "runs.jsonl");
|
|
47
|
+
this.disclose = sink === undefined ? undefined : (reason) => sink({ kind: "file", path: ledgerPath, reason });
|
|
44
48
|
this.ledger = runLedgers.acquire({
|
|
45
49
|
dir,
|
|
46
50
|
tmpDir: join(root, "tmp"),
|
|
47
|
-
...(
|
|
48
|
-
ledgerPath
|
|
51
|
+
...(sink !== undefined ? { onCorruptRead: sink } : {}),
|
|
52
|
+
ledgerPath,
|
|
49
53
|
snapshotPath: join(dir, "runs.snapshot.jsonl"),
|
|
50
54
|
});
|
|
51
55
|
}
|
|
@@ -63,16 +67,16 @@ export class FileWorkflowRunStore {
|
|
|
63
67
|
const stored = structuredClone(run);
|
|
64
68
|
stored.id = id;
|
|
65
69
|
stored.rev = run.rev ?? 0;
|
|
66
|
-
this.commit({ t: "put", id, run: stored }, this.fsyncEnabled);
|
|
70
|
+
this.commit({ t: "put", id, run: admitWorkflowRun(stored, id) }, this.fsyncEnabled);
|
|
67
71
|
});
|
|
68
72
|
}
|
|
69
73
|
async get(id) {
|
|
70
74
|
const run = this.runs.get(id);
|
|
71
|
-
return run ? structuredClone(run) : null;
|
|
75
|
+
return run ? structuredClone(readStoredWorkflowRun(run, { key: id }, this.disclose)) : null;
|
|
72
76
|
}
|
|
73
77
|
async update(id, scope, run, expect) {
|
|
74
78
|
return this.withLock(id, () => {
|
|
75
|
-
const next = nextWorkflowRunOnUpdate(this.runs.get(id), id, scope, run, expect);
|
|
79
|
+
const next = nextWorkflowRunOnUpdate(this.runs.get(id), id, scope, run, expect, this.disclose);
|
|
76
80
|
if (!next)
|
|
77
81
|
return false;
|
|
78
82
|
this.commit({ t: "update", id, run: next }, this.fsyncEnabled);
|
|
@@ -80,18 +84,17 @@ export class FileWorkflowRunStore {
|
|
|
80
84
|
});
|
|
81
85
|
}
|
|
82
86
|
async listByScope(scope, opts) {
|
|
83
|
-
return queryWorkflowRuns(this.runs.
|
|
87
|
+
return queryWorkflowRuns(this.runs.entries(), scope, opts, this.disclose);
|
|
84
88
|
}
|
|
85
89
|
async reap(scope, now, opts) {
|
|
86
90
|
const policy = receiveRetentionPolicy("WorkflowRunStore.reap", opts, WORKFLOW_RUN_REAP_KNOBS);
|
|
87
91
|
if (policy.maxAgeMs === undefined && policy.keep === undefined)
|
|
88
92
|
return 0;
|
|
89
|
-
const terminal =
|
|
90
|
-
terminal.sort((a, b) => b.createdAt - a.createdAt);
|
|
93
|
+
const terminal = workflowRunReapCandidates(this.runs.entries(), scope, this.disclose);
|
|
91
94
|
const doomed = [];
|
|
92
95
|
for (let i = 0; i < terminal.length; i++) {
|
|
93
96
|
const r = terminal[i];
|
|
94
|
-
const tooOld = policy.maxAgeMs !== undefined &&
|
|
97
|
+
const tooOld = policy.maxAgeMs !== undefined && r.age < now - policy.maxAgeMs;
|
|
95
98
|
const overKeep = policy.keep !== undefined && i >= policy.keep;
|
|
96
99
|
if (tooOld || overKeep)
|
|
97
100
|
doomed.push({ id: r.id, byAge: tooOld });
|
|
@@ -10,6 +10,7 @@ const ARTIFACT_ACTION_LEGS = {
|
|
|
10
10
|
};
|
|
11
11
|
import { ARTIFACT_TOOL_NAME, mountRuleFace, toolFace } from "../../core/tool-catalog-entries.js";
|
|
12
12
|
import { attest, resolveAsk } from "../../core/tool-policy.js";
|
|
13
|
+
import { mintCheckpointId } from "../../core/checkpoint-store.js";
|
|
13
14
|
import { NOT_BINDABLE } from "../../core/skill-grant-binding.js";
|
|
14
15
|
import { approvalCardOf } from "../../core/tool-roster.js";
|
|
15
16
|
import { errorResult } from "../../core/tools.js";
|
|
@@ -349,6 +350,7 @@ export function createArtifactTool(opts) {
|
|
|
349
350
|
const resolved = await resolveAsk({
|
|
350
351
|
toolName: ARTIFACT_TOOL_NAME,
|
|
351
352
|
toolCallId: ctx.toolCallId,
|
|
353
|
+
checkpointId: mintCheckpointId(),
|
|
352
354
|
args: { action: "read", url },
|
|
353
355
|
message: `Read a shared artifact: ${inlineUntrusted(url, 300)}${title}${version} — an artifact another person shared with this user; approving covers re-reads of it for the rest of this run.`,
|
|
354
356
|
requiresRealApproval: true,
|
|
@@ -3,6 +3,7 @@ import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, re
|
|
|
3
3
|
import { dirname, join, resolve, sep } from "node:path";
|
|
4
4
|
import { ARTIFACT_HOST_FAILURE_CODES, } from "../../core/artifact-host.js";
|
|
5
5
|
import { physicalPathOf } from "../../core/physical-path.js";
|
|
6
|
+
import { openExclusiveTemp } from "../../core/exclusive-temp.js";
|
|
6
7
|
import { acquireStoreDirLock } from "../../stores/file/fs-atomic.js";
|
|
7
8
|
import { normalizePublishedPath } from "./artifact-tool.js";
|
|
8
9
|
export const EVAL_STUB_URL_PREFIX = "eval-stub://artifact/";
|
|
@@ -76,8 +77,7 @@ function fsyncTreeBestEffort(dir) {
|
|
|
76
77
|
fsyncTreeBestEffort(join(dir, entry.name));
|
|
77
78
|
fsyncDirBestEffort(dir);
|
|
78
79
|
}
|
|
79
|
-
function
|
|
80
|
-
const fd = openSync(path, "w", 0o600);
|
|
80
|
+
function fillFsync(fd, bytes) {
|
|
81
81
|
try {
|
|
82
82
|
writeFileSync(fd, bytes);
|
|
83
83
|
fsyncSync(fd);
|
|
@@ -156,10 +156,10 @@ export class LocalArtifactStub {
|
|
|
156
156
|
}
|
|
157
157
|
}
|
|
158
158
|
#commitLedger(next) {
|
|
159
|
-
const
|
|
159
|
+
const text = JSON.stringify(next, null, 2);
|
|
160
|
+
const { fd, path: ledgerTmp } = openExclusiveTemp(join(this.dir, LEDGER_FILE));
|
|
160
161
|
try {
|
|
161
|
-
|
|
162
|
-
writeFsync(ledgerTmp, text);
|
|
162
|
+
fillFsync(fd, text);
|
|
163
163
|
const verified = parseLedger(readFileSync(ledgerTmp, "utf8"), ledgerTmp);
|
|
164
164
|
if (JSON.stringify(verified) !== JSON.stringify(next))
|
|
165
165
|
throw new Error("artifact stub ledger did not read back as written");
|
|
@@ -216,7 +216,7 @@ export class LocalArtifactStub {
|
|
|
216
216
|
for (const f of files) {
|
|
217
217
|
const target = join(tmpDir, ...f.path.split("/"));
|
|
218
218
|
mkdirSync(dirname(target), { recursive: true, mode: 0o700 });
|
|
219
|
-
|
|
219
|
+
fillFsync(openSync(target, "wx", 0o600), f.content);
|
|
220
220
|
}
|
|
221
221
|
fsyncTreeBestEffort(tmpDir);
|
|
222
222
|
mkdirSync(dirname(versionDir), { recursive: true, mode: 0o700 });
|
|
@@ -145,6 +145,5 @@ export declare function shellScanDeclineOf(pos: ProgramPosition, acceptsStreamTa
|
|
|
145
145
|
/** ONE sentence per refusal kind, minted here and nowhere else. */
|
|
146
146
|
export declare function programPositionRefusalSentence(refusal: ProgramPositionRefusal): string;
|
|
147
147
|
/** The sentence a segment whose program the walk DECLINED carries, read off the segment's text — the program-position reader's own
|
|
148
|
-
* refusal, the stream fact, or that no program could be named: the read station's account of the segment
|
|
149
|
-
* are this one sentence. */
|
|
148
|
+
* refusal, the stream fact, or that no program could be named: the read station's account of the segment. */
|
|
150
149
|
export declare function declinedProgramSentence(text: string): string;
|
|
@@ -110,6 +110,14 @@ export interface LeadingCommandNameOptions {
|
|
|
110
110
|
* {@link import("../../core/permission-rule-model.js").BARE_INTERPRETER_NAMES}).
|
|
111
111
|
*/
|
|
112
112
|
pathPrefixedNameIsText?: boolean;
|
|
113
|
+
/**
|
|
114
|
+
* Read an arithmetic expansion that names nothing — digits, operators and blanks, no variable, no `$`, no
|
|
115
|
+
* substitution ({@link literalArithmeticSpelling}) — as the number it prints, not as an expansion to refuse.
|
|
116
|
+
* Only meaningful with {@link quotedOperatorsAreText}, which is where the leading-name parser reads the lexer's
|
|
117
|
+
* result at all. OPT-IN for the compound classify face, the face that asks "does this command change anything":
|
|
118
|
+
* a persisted rule's text is compared literally, where `ls $((1+2))` and `ls 3` are two commands.
|
|
119
|
+
*/
|
|
120
|
+
literalArithmeticIsText?: boolean;
|
|
113
121
|
}
|
|
114
122
|
/**
|
|
115
123
|
* The SINGLE fail-closed simple-command parser shared by `bash_readonly`'s single-command admission, the
|
|
@@ -131,6 +139,19 @@ export declare function parseLeadingCommandName(command: string, options?: Leadi
|
|
|
131
139
|
} | {
|
|
132
140
|
reject: string;
|
|
133
141
|
};
|
|
142
|
+
/** What a refused read-only call is worded by, and the one place each cause is worded: the program is not among a face's
|
|
143
|
+
* programs (`unlisted`), or it is a program the reader's tables know whose call uses an option outside its read-only set
|
|
144
|
+
* (`option` — `sort -o out`: `sort` without it is read-only). */
|
|
145
|
+
export type ReadOnlyRefusalCause = {
|
|
146
|
+
readonly kind: "unlisted";
|
|
147
|
+
readonly program: string;
|
|
148
|
+
} | {
|
|
149
|
+
readonly kind: "option";
|
|
150
|
+
readonly program: string;
|
|
151
|
+
readonly option: string;
|
|
152
|
+
};
|
|
153
|
+
/** The sentence for a {@link ReadOnlyRefusalCause}. */
|
|
154
|
+
export declare function readOnlyRefusalSentence(cause: ReadOnlyRefusalCause): string;
|
|
134
155
|
/** The one sentence for a program a face's list of programs does not name — the compound classifier's list check and
|
|
135
156
|
* the read-only reader's `readers` narrowing both mint it here. */
|
|
136
157
|
export declare function unlistedReaderSentence(program: string): string;
|
|
@@ -155,6 +176,9 @@ export interface StrictResidualOptions {
|
|
|
155
176
|
/** The declared home: a word that spells it ({@link homeExpansionOf}) is not an expansion to refuse — unless the
|
|
156
177
|
* command may rebind `HOME` ({@link textBindsHome}), which makes the declared home a guess. */
|
|
157
178
|
readonly homeDir?: string;
|
|
179
|
+
/** An arithmetic expansion that names nothing ({@link literalArithmeticSpelling}) is the number it prints, not an
|
|
180
|
+
* expansion to refuse — in the expansion pass and in the quote-blind class (its parentheses and operators). */
|
|
181
|
+
readonly literalArithmetic?: boolean;
|
|
158
182
|
}
|
|
159
183
|
/**
|
|
160
184
|
* THE classify faces' whole-string gate, as a PREDICATE over the one lexer's result: the residual space those
|
|
@@ -216,6 +240,7 @@ export declare function splitShellCompoundSegments(source: string, options?: {
|
|
|
216
240
|
trailingTerminator?: "strip" | "keep";
|
|
217
241
|
redirection?: "reject" | "tolerate" | "data-free";
|
|
218
242
|
homeDir?: string;
|
|
243
|
+
literalArithmetic?: boolean;
|
|
219
244
|
}): ShellCompoundSegments | {
|
|
220
245
|
reject: string;
|
|
221
246
|
};
|
|
@@ -495,6 +520,16 @@ export declare function classifyCompoundReadonlyDetailed(command: string, allow:
|
|
|
495
520
|
boundary?: {
|
|
496
521
|
readonly homeDir?: string;
|
|
497
522
|
}): CompoundReadonlyVerdict;
|
|
523
|
+
/** {@link classifyCompoundReadonlyDetailed}'s verdict with the one fact its sentence does not carry: `unlistedProgram` is set exactly
|
|
524
|
+
* when the verdict's reason IS the list refusal ({@link unlistedReaderSentence}) of that program, so a reader that words a refusal by
|
|
525
|
+
* its cause asks for the cause instead of reading it back out of the sentence. Not part of the package surface. */
|
|
526
|
+
export interface CompoundReadonlyFacts extends CompoundReadonlyVerdict {
|
|
527
|
+
readonly unlistedProgram?: string;
|
|
528
|
+
}
|
|
529
|
+
/** The compound classifier itself ({@link classifyCompoundReadonlyDetailed} is its package-surface face). */
|
|
530
|
+
export declare function classifyCompoundReadonlyFacts(command: string, allow: ReadonlySet<string>, boundary?: {
|
|
531
|
+
readonly homeDir?: string;
|
|
532
|
+
}): CompoundReadonlyFacts;
|
|
498
533
|
/**
|
|
499
534
|
* Compound read-only classification, reason-only face. Returns the demotion reason, or
|
|
500
535
|
* undefined when the command classifies read-only. ⚠️ `undefined` is NOT "safe to auto-execute":
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { anchorSpelling, isAbsoluteForFamily, isBlockedDevicePath, isShellRootedSpellingUnmapped, nativeUncSpellingOf, normalizeAbsPathLexically, win32NamespaceScreen, pathFamilyOf } from "./safety.js";
|
|
2
|
-
import { PARSE_FAILURE_SENTENCE, UNRESOLVED_SENTENCE, argvOf, lexShell, literalTildeSpelling, } from "../../shell/lex.js";
|
|
2
|
+
import { PARSE_FAILURE_SENTENCE, UNRESOLVED_SENTENCE, argvOf, expansionHidesRun, lexShell, literalTildeSpelling, } from "../../shell/lex.js";
|
|
3
3
|
import { shellWordsOf } from "../../shell/shell-words.js";
|
|
4
4
|
import { textBindsHome } from "./shell-read-bindings.js";
|
|
5
5
|
import { GENERATOR_DEVICES, newLineDescriptors, bindDescriptors, isNamedDescriptorWord, standardDeviceUnrebound, descriptorsBoundBy } from "./shell-read-device.js";
|
|
@@ -16,7 +16,7 @@ export function bashClassifyDefaultAllow() {
|
|
|
16
16
|
return [...BASH_READONLY_DEFAULT_ALLOW, ...BASH_CLASSIFY_EXTRA_ALLOW];
|
|
17
17
|
}
|
|
18
18
|
const SHELL_OPERATORS = /[;&|<>$()`\n\r\\]/;
|
|
19
|
-
function hasBareShellOperator(s, quotedOperatorsAreText) {
|
|
19
|
+
function hasBareShellOperator(s, quotedOperatorsAreText, literalArithmeticIsText = false) {
|
|
20
20
|
if (!quotedOperatorsAreText)
|
|
21
21
|
return SHELL_OPERATORS.test(s);
|
|
22
22
|
const lexed = lexShell(s);
|
|
@@ -27,18 +27,44 @@ function hasBareShellOperator(s, quotedOperatorsAreText) {
|
|
|
27
27
|
for (const t of lexed.segments[0].tokens) {
|
|
28
28
|
if (t.kind !== "word")
|
|
29
29
|
return true;
|
|
30
|
-
if (expandsBeyondText(t) || t.assignment?.form === "compound")
|
|
30
|
+
if (expandsBeyondText(t, literalArithmeticIsText ? s : undefined) || t.assignment?.form === "compound")
|
|
31
31
|
return true;
|
|
32
32
|
if (t.pieces.some((p) => p.quotedBy === "\\" || (p.quotedBy === undefined && p.literal !== undefined && /[\r\\]/.test(p.literal))))
|
|
33
33
|
return true;
|
|
34
34
|
}
|
|
35
35
|
return false;
|
|
36
36
|
}
|
|
37
|
-
|
|
37
|
+
const LITERAL_ARITHMETIC_SPELLING = /^[\t\x20-\x5b\x5d-\x7e]*$/;
|
|
38
|
+
function literalArithmeticSpelling(p, source) {
|
|
39
|
+
if (p.expansion?.kind !== "arithmetic" || expansionHidesRun(p.expansion))
|
|
40
|
+
return undefined;
|
|
41
|
+
const text = source.slice(p.span[0], p.span[1]);
|
|
42
|
+
return LITERAL_ARITHMETIC_SPELLING.test(text) ? text : undefined;
|
|
43
|
+
}
|
|
44
|
+
function literalArithmeticOf(w, source) {
|
|
45
|
+
const found = new Map();
|
|
46
|
+
for (const p of w.pieces) {
|
|
47
|
+
const text = literalArithmeticSpelling(p, source);
|
|
48
|
+
if (text === undefined)
|
|
49
|
+
return new Map();
|
|
50
|
+
found.set(p, text);
|
|
51
|
+
}
|
|
52
|
+
return found;
|
|
53
|
+
}
|
|
54
|
+
function withoutLiteralArithmetic(w, source) {
|
|
55
|
+
let raw = w.raw;
|
|
56
|
+
for (const text of literalArithmeticOf(w, source).values())
|
|
57
|
+
raw = raw.replace(text, "");
|
|
58
|
+
return raw;
|
|
59
|
+
}
|
|
60
|
+
function expandsBeyondText(w, literalArithmeticIn) {
|
|
38
61
|
if (w.quotedSpans.some((q) => q.by === '$"'))
|
|
39
62
|
return true;
|
|
63
|
+
const numbers = literalArithmeticIn !== undefined ? literalArithmeticOf(w, literalArithmeticIn) : undefined;
|
|
40
64
|
for (const p of w.pieces) {
|
|
41
65
|
const k = p.expansion?.kind;
|
|
66
|
+
if (k === "arithmetic" && numbers?.has(p) === true)
|
|
67
|
+
continue;
|
|
42
68
|
if (k === "parameter" || k === "command" || k === "process" || k === "arithmetic")
|
|
43
69
|
return true;
|
|
44
70
|
if (p.expansion?.inner !== undefined)
|
|
@@ -54,7 +80,7 @@ export function parseLeadingCommandName(command, options) {
|
|
|
54
80
|
const trimmed = command.trim();
|
|
55
81
|
if (!trimmed)
|
|
56
82
|
return { reject: "empty command" };
|
|
57
|
-
if (hasBareShellOperator(trimmed, options?.quotedOperatorsAreText === true)) {
|
|
83
|
+
if (hasBareShellOperator(trimmed, options?.quotedOperatorsAreText === true, options?.literalArithmeticIsText === true)) {
|
|
58
84
|
return {
|
|
59
85
|
reject: "shell operators (pipes, redirects, ;, &&, command substitution, subshells, variable expansion) are not allowed — run a single simple command",
|
|
60
86
|
};
|
|
@@ -71,8 +97,11 @@ export function parseLeadingCommandName(command, options) {
|
|
|
71
97
|
return { reject: "the command name must be a bare token (no quotes, braces, globs, or ~)" };
|
|
72
98
|
return { name: first };
|
|
73
99
|
}
|
|
100
|
+
export function readOnlyRefusalSentence(cause) {
|
|
101
|
+
return cause.kind === "unlisted" ? `command "${cause.program}" is not in the read-only allowlist` : `option "${cause.option}" is not one of the read-only options of "${cause.program}"`;
|
|
102
|
+
}
|
|
74
103
|
export function unlistedReaderSentence(program) {
|
|
75
|
-
return
|
|
104
|
+
return readOnlyRefusalSentence({ kind: "unlisted", program });
|
|
76
105
|
}
|
|
77
106
|
const SHELL_SEGMENT_QUOTE_BLIND_REJECT = /[<>()`\n\r\\]/;
|
|
78
107
|
const SHELL_EXPANSION_CHARS = /[$]/;
|
|
@@ -113,7 +142,7 @@ export function strictResidualRefusal(lexed, source, opts = {}) {
|
|
|
113
142
|
return reason;
|
|
114
143
|
for (const t of s.tokens) {
|
|
115
144
|
if (t.kind === "word") {
|
|
116
|
-
if (inClass(t.raw))
|
|
145
|
+
if (inClass(opts.literalArithmetic === true ? withoutLiteralArithmetic(t, source) : t.raw))
|
|
117
146
|
return reason;
|
|
118
147
|
words.push(t);
|
|
119
148
|
continue;
|
|
@@ -133,7 +162,7 @@ export function strictResidualRefusal(lexed, source, opts = {}) {
|
|
|
133
162
|
}
|
|
134
163
|
const home = opts.homeDir !== undefined && !textBindsHome(source) ? opts.homeDir : undefined;
|
|
135
164
|
for (const w of words) {
|
|
136
|
-
if (expandsBeyondText(w) && !(home !== undefined && homeSpelledForClassify(w, home) !== undefined))
|
|
165
|
+
if (expandsBeyondText(w, opts.literalArithmetic === true ? source : undefined) && !(home !== undefined && homeSpelledForClassify(w, home) !== undefined))
|
|
137
166
|
return reason;
|
|
138
167
|
}
|
|
139
168
|
for (const s of lexed.segments) {
|
|
@@ -156,6 +185,7 @@ export function splitShellCompoundSegments(source, options) {
|
|
|
156
185
|
tolerateRedirection: options?.redirection === "tolerate",
|
|
157
186
|
dataFreeRedirections: options?.redirection === "data-free",
|
|
158
187
|
...(options?.homeDir !== undefined ? { homeDir: options.homeDir } : {}),
|
|
188
|
+
...(options?.literalArithmetic === true ? { literalArithmetic: true } : {}),
|
|
159
189
|
});
|
|
160
190
|
if (refused !== undefined)
|
|
161
191
|
return { reject: refused };
|
|
@@ -732,15 +762,20 @@ function segmentCompoundForReadonly(command, homeDir) {
|
|
|
732
762
|
if (!trimmed)
|
|
733
763
|
return { reject: "empty command" };
|
|
734
764
|
const terminatorStripped = trimmed.endsWith(";") ? trimmed.slice(0, -1) : trimmed;
|
|
735
|
-
return splitShellCompoundSegments(terminatorStripped, { trailingTerminator: "keep", redirection: "data-free", ...(homeDir !== undefined ? { homeDir } : {}) });
|
|
765
|
+
return splitShellCompoundSegments(terminatorStripped, { trailingTerminator: "keep", redirection: "data-free", literalArithmetic: true, ...(homeDir !== undefined ? { homeDir } : {}) });
|
|
736
766
|
}
|
|
737
767
|
export function classifyCompoundReadonlyDetailed(command, allow, boundary) {
|
|
768
|
+
const { reason } = classifyCompoundReadonlyFacts(command, allow, boundary);
|
|
769
|
+
return reason === undefined ? {} : { reason };
|
|
770
|
+
}
|
|
771
|
+
export function classifyCompoundReadonlyFacts(command, allow, boundary) {
|
|
738
772
|
const split = segmentCompoundForReadonly(command, boundary?.homeDir);
|
|
739
773
|
if ("reject" in split)
|
|
740
774
|
return { reason: split.reject };
|
|
741
775
|
const { segments, pipeFed } = split;
|
|
742
776
|
const homeRebound = boundary?.homeDir !== undefined && textBindsHome(command);
|
|
743
777
|
let nameRefusal;
|
|
778
|
+
let unlistedProgram;
|
|
744
779
|
const unlistedSegments = new Set();
|
|
745
780
|
const reheaded = new Map();
|
|
746
781
|
for (let si = 0; si < segments.length; si++) {
|
|
@@ -765,7 +800,7 @@ export function classifyCompoundReadonlyDetailed(command, allow, boundary) {
|
|
|
765
800
|
if (familyRefusal !== undefined)
|
|
766
801
|
nameRefusal ??= familyRefusal;
|
|
767
802
|
}
|
|
768
|
-
const parsed = parseLeadingCommandName(toks.raw.slice(from).join(" "), { quotedOperatorsAreText: true, pathPrefixedNameIsText: true });
|
|
803
|
+
const parsed = parseLeadingCommandName(toks.raw.slice(from).join(" "), { quotedOperatorsAreText: true, pathPrefixedNameIsText: true, literalArithmeticIsText: true });
|
|
769
804
|
if ("reject" in parsed)
|
|
770
805
|
return { reason: parsed.reject };
|
|
771
806
|
const pathPrefixed = parsed.name.includes("/");
|
|
@@ -781,7 +816,10 @@ export function classifyCompoundReadonlyDetailed(command, allow, boundary) {
|
|
|
781
816
|
nameRefusal ??= unlistedReaderSentence(folded[0]);
|
|
782
817
|
continue;
|
|
783
818
|
}
|
|
784
|
-
nameRefusal
|
|
819
|
+
if (nameRefusal === undefined) {
|
|
820
|
+
nameRefusal = unlistedReaderSentence(parsed.name);
|
|
821
|
+
unlistedProgram = parsed.name;
|
|
822
|
+
}
|
|
785
823
|
if (runsShellText(name))
|
|
786
824
|
return { reason: unjudgedProgramTextRefusal(parsed.name, "runs its argument as shell text") };
|
|
787
825
|
if (pos.launchers.length > 0) {
|
|
@@ -887,7 +925,7 @@ export function classifyCompoundReadonlyDetailed(command, allow, boundary) {
|
|
|
887
925
|
const cdSegments = foldedSegments.filter((st) => st.folded[0] === "cd");
|
|
888
926
|
if (cdSegments.length > 1)
|
|
889
927
|
shapeRefusal ??= `multiple directory changes in one command require approval for clarity ${NOT_AUTO_ALLOWED}`;
|
|
890
|
-
return shapeRefusal
|
|
928
|
+
return shapeRefusal === undefined ? {} : { reason: shapeRefusal, ...(unlistedProgram !== undefined ? { unlistedProgram } : {}) };
|
|
891
929
|
}
|
|
892
930
|
export function classifyCompoundReadonly(command, allow, boundary) {
|
|
893
931
|
return classifyCompoundReadonlyDetailed(command, allow, boundary).reason;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function envErrorDetail(message: string | undefined): string;
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { hasVisibleContent } from "../../core/principal-name.js";
|
|
2
|
+
import { extensionWords } from "../../core/untrusted-egress.js";
|
|
3
|
+
const ENV_ERROR_DETAIL_MAX = 512;
|
|
4
|
+
export function envErrorDetail(message) {
|
|
5
|
+
const folded = extensionWords(typeof message === "string" ? message : "", ENV_ERROR_DETAIL_MAX);
|
|
6
|
+
return hasVisibleContent(folded) ? folded : "the execution environment reported no reason";
|
|
7
|
+
}
|
|
@@ -5,6 +5,7 @@ import { type CwdRef } from "./fs-shared.js";
|
|
|
5
5
|
import type { ReversibilityVerdict } from "../../core/types.js";
|
|
6
6
|
import type { ShellReadAdmission } from "./shell-read-check.js";
|
|
7
7
|
import type { ReadFloorSeat } from "./read-floor.js";
|
|
8
|
+
import { type CommandSandboxSeat } from "../../core/command-sandbox.js";
|
|
8
9
|
/**
|
|
9
10
|
* The full shell face's SHAPE classifier for the `bash` tool, exposed as a `ToolSpec.reversibilityProbe`
|
|
10
11
|
* (the "maybe" tier's probe, installed on every full shell). A command is reversible ONLY if every connected
|
|
@@ -93,13 +94,14 @@ export declare function createBashTool(env: ExecutionEnv, rootCanonical: string,
|
|
|
93
94
|
* it). A deployment that wants the CC-parity behavior sets this explicitly; sema's own default
|
|
94
95
|
* Runner wiring currently does NOT set it, so this feature ships INERT until a caller opts in.
|
|
95
96
|
*
|
|
96
|
-
* IT ARMS
|
|
97
|
-
* to adopt a running command instead of ending it,
|
|
97
|
+
* IT ARMS THREE TRIGGERS, not one — the name is older than the other two. All are the engine deciding
|
|
98
|
+
* to adopt a running command instead of ending it, all take the same adoption chain, and all are
|
|
98
99
|
* gated on the same eligibility read of this command's text (`canAutoBackground`): (1) the command's
|
|
99
|
-
* OWN timeout fires,
|
|
100
|
-
* still runs (see {@link queuedHumanInput})
|
|
101
|
-
*
|
|
102
|
-
*
|
|
100
|
+
* OWN timeout fires, (2) a person's input is waiting for the turn boundary while this command
|
|
101
|
+
* still runs (see {@link queuedHumanInput}), and (3) a cut whose source moves an armed command aside
|
|
102
|
+
* ends the turn (see {@link turnCutMovesCommandAside}). A deployment that opted in for one has opted in
|
|
103
|
+
* for all; there is deliberately no second knob, because "may this command be moved to the background
|
|
104
|
+
* by the engine" is one question and answering it twice is how the triggers would drift apart.
|
|
103
105
|
*/
|
|
104
106
|
autoBackgroundOnTimeout?: boolean;
|
|
105
107
|
/**
|
|
@@ -121,6 +123,17 @@ export declare function createBashTool(env: ExecutionEnv, rootCanonical: string,
|
|
|
121
123
|
* message (the pre-seat behavior), which is also what a standalone toolkit build gets.
|
|
122
124
|
*/
|
|
123
125
|
queuedHumanInput?: () => boolean;
|
|
126
|
+
/**
|
|
127
|
+
* Does the cut now aborting `signal` (the call's own turn signal) move an {@link autoBackgroundOnTimeout}-armed running
|
|
128
|
+
* command into the background instead of ending it? Asked once, inside that abort's own dispatch, by the answer the
|
|
129
|
+
* harness keeps per cut source (an extension's turn end moves it; a person's halt and a steer-now end it). `true` fires
|
|
130
|
+
* the SAME detach verb ctrl+b fires, ahead of the environment's own abort, so a command the environment adopts on the
|
|
131
|
+
* spot is never killed; one it refuses to adopt is ended exactly as before. Reference field `backgroundedByTurnAbort`.
|
|
132
|
+
*
|
|
133
|
+
* Wired on a top-level leg only (the reference moves a command aside for a turn abort on its main thread alone): absent
|
|
134
|
+
* ⇒ every cut ends the running command, which is also what a delegated leg and a standalone toolkit build get.
|
|
135
|
+
*/
|
|
136
|
+
turnCutMovesCommandAside?: (signal: AbortSignal) => boolean;
|
|
124
137
|
/**
|
|
125
138
|
* Mirrors {@link import("../../core/types.js").TaskSpec.oneShot}: this run has no later
|
|
126
139
|
* turn for an async background notification to land in (a headless `-p` process exits once the
|
|
@@ -149,6 +162,9 @@ export declare function createBashTool(env: ExecutionEnv, rootCanonical: string,
|
|
|
149
162
|
/** The byte floor's seat (read-floor.ts): every command this leg starts, foreground or background, carries the
|
|
150
163
|
* read-deny table its call judges with to the environment. Absent ⇒ no table, the starts carry nothing. */
|
|
151
164
|
readFloor?: ReadFloorSeat;
|
|
165
|
+
/** The run's command sandbox seat (`command-sandbox.ts`): every command this leg starts, foreground or background, hands
|
|
166
|
+
* its call's sandbox instruction to the environment, or is refused. Absent ⇒ the run requires no sandbox. */
|
|
167
|
+
commandSandbox?: CommandSandboxSeat;
|
|
152
168
|
/** The run's image processor seat (`RunnerDeps.imageProcessor`), for an image-data-URI stdout. */
|
|
153
169
|
imageProcessor?: ImageDownsampler | false;
|
|
154
170
|
/** Override of the `timeout` parameter's DEFAULT budget, in ms — see
|
|
@@ -210,6 +226,8 @@ export declare function createBashReadonlyTool(env: ExecutionEnv, rootCanonical:
|
|
|
210
226
|
shellReadAdmission?: ShellReadAdmission;
|
|
211
227
|
/** The byte floor's seat — the SAME one the full shell leg takes (read-floor.ts). */
|
|
212
228
|
readFloor?: ReadFloorSeat;
|
|
229
|
+
/** The command sandbox seat — the SAME one the full shell leg takes (command-sandbox.ts). */
|
|
230
|
+
commandSandbox?: CommandSandboxSeat;
|
|
213
231
|
/** The image processor seat — the SAME one the full shell leg takes. */
|
|
214
232
|
imageProcessor?: ImageDownsampler | false;
|
|
215
233
|
/** The run's tool-progress sink — the SAME seat the full shell leg takes, for the same reason its
|