@sema-agent/core 7.66.1 → 7.67.1
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 +3518 -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 +169 -0
- package/dist/brain/model-lane.js +505 -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 +164 -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 +105 -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 +24 -25
- package/dist/core/roles.js +148 -21
- 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 +23 -0
- package/dist/core/runner/model-fallback-seat.js +64 -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 +19 -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 +126 -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 +64 -34
- package/dist/index.js +45 -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 +340 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core-stores-sql@7.67.1.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/core@7.67.1.json +406 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/mods-kernel@7.67.1.json +39 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/primitives@7.67.1.json +39 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/wire-changes/wiki-gate@7.67.1.json +39 -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
package/dist/tools/fs/fs-read.js
CHANGED
|
@@ -5,7 +5,8 @@ import { decodeTextBytes } from "./encoding.js";
|
|
|
5
5
|
import { isNotebookPath, parseNotebookCells, renderNotebookCells, stripNotebookImageData, NOTEBOOK_IMAGE_BASE64_BUDGET } from "./notebook.js";
|
|
6
6
|
import { resolveImageProcessor } from "../../core/image-downsample.js";
|
|
7
7
|
import { countPdfPagesFromBytes, PDF_MAX_PAGES_PER_READ } from "./pdf.js";
|
|
8
|
-
import { MAX_READ_BYTES, SLICED_READ_MAX_BYTES, noProcessorImageCapHint, MAX_READ_OUTPUT_CHARS, FILE_PATH_PARAMS, countLines,
|
|
8
|
+
import { MAX_READ_BYTES, SLICED_READ_MAX_BYTES, noProcessorImageCapHint, MAX_READ_OUTPUT_CHARS, BASE_READ_TOKENS, FILE_PATH_PARAMS, countLines, enoentMessage, } from "./fs-shared.js";
|
|
9
|
+
import { envErrorDetail } from "./env-error-detail.js";
|
|
9
10
|
import { readPdfFile } from "./fs-pdf.js";
|
|
10
11
|
import { seatForCall, seatReady } from "./read-deny.js";
|
|
11
12
|
import { thrownText } from "../../core/thrown-value.js";
|
|
@@ -16,8 +17,43 @@ import { fileArgPath } from "../../core/tool-registry.js";
|
|
|
16
17
|
import { admitImageBytes, IMAGE_ADMISSION, imageReadCap, PDF_TARGET_RAW_SIZE, pdfMagicMatches, unprocessedSizeClause } from "../../core/image-admission.js";
|
|
17
18
|
import { createEntryDenyJudge, enumerateDirectory } from "./dir-entries.js";
|
|
18
19
|
import { FileError } from "../../internal/harness.js";
|
|
19
|
-
export const READ_OUTCOMES = Object.freeze(["attached", "partial", "
|
|
20
|
+
export const READ_OUTCOMES = Object.freeze(["attached", "partial", "not_attached"]);
|
|
21
|
+
function textLaneOf(bytes) {
|
|
22
|
+
if (pdfMagicMatches(bytes))
|
|
23
|
+
return { kind: "pdf" };
|
|
24
|
+
const format = binaryMagicFormat(bytes);
|
|
25
|
+
if (format !== undefined)
|
|
26
|
+
return { kind: "binary_format", format };
|
|
27
|
+
const decoded = decodeTextBytes(bytes);
|
|
28
|
+
if (decoded.malformed === "truncated_utf16")
|
|
29
|
+
return { kind: "truncated_utf16" };
|
|
30
|
+
if (isBinaryContent(decoded.text.slice(0, 8192)))
|
|
31
|
+
return { kind: "binary_content" };
|
|
32
|
+
return { kind: "text", decoded };
|
|
33
|
+
}
|
|
20
34
|
const UNBINDABLE = "this environment cannot bind a read to the file that was checked, so it was not read";
|
|
35
|
+
const LARGE_READ_CLAUSE = {
|
|
36
|
+
read_anyway: " To read it anyway, up to what still fits in your context, call Read again with allow_large: true \u2014 only if you genuinely need all of it or the user asked for the whole file.",
|
|
37
|
+
over_room: " Even with allow_large, this is more than fits in the context you have left this turn (other large reads in the same turn share that room).",
|
|
38
|
+
unavailable: " allow_large is not available where this read runs; read it in parts with offset and limit.",
|
|
39
|
+
};
|
|
40
|
+
function raisedReadLimitsOf(ticket) {
|
|
41
|
+
if (ticket === undefined)
|
|
42
|
+
return undefined;
|
|
43
|
+
const room = ticket.room();
|
|
44
|
+
if (!(room > BASE_READ_TOKENS))
|
|
45
|
+
return undefined;
|
|
46
|
+
return { tokens: room, bytes: Math.min(SLICED_READ_MAX_BYTES, Math.max(MAX_READ_BYTES, Math.floor(room * ticket.charsPerToken * 3))) };
|
|
47
|
+
}
|
|
48
|
+
export function servedReadTokens(body, charsPerToken) {
|
|
49
|
+
return Math.max(Math.ceil(body.length / charsPerToken), Math.ceil(Buffer.byteLength(body, "utf8") / 2));
|
|
50
|
+
}
|
|
51
|
+
function leastServedReadTokens(bytes, charsPerToken) {
|
|
52
|
+
const utf8 = Math.ceil(Math.max(0, bytes - 3) / 2);
|
|
53
|
+
const units = Math.max(0, Math.floor((bytes - 2) / 2));
|
|
54
|
+
const utf16 = Math.max(Math.ceil(units / charsPerToken), Math.ceil(units / 2));
|
|
55
|
+
return Math.min(utf8, utf16);
|
|
56
|
+
}
|
|
21
57
|
const NO_EFFECTS = () => ({ disclosure: [] });
|
|
22
58
|
async function admitNotebookImages(blocks, imageProcessor) {
|
|
23
59
|
if (!blocks.some((b) => b.type === "image"))
|
|
@@ -34,7 +70,7 @@ async function admitNotebookImages(blocks, imageProcessor) {
|
|
|
34
70
|
}));
|
|
35
71
|
}
|
|
36
72
|
export function createModelFileReader(opts) {
|
|
37
|
-
const { env, state, rootCanonical, cwdRef, imageProcessor, pdfCapabilities, bgOutputReadExemption, readFace, reminderMark, readDeny: readDenySeat, additionalRoots: rootsSeat } = opts;
|
|
73
|
+
const { env, state, rootCanonical, cwdRef, imageProcessor, pdfCapabilities, bgOutputReadExemption, readFace, reminderMark, readDeny: readDenySeat, additionalRoots: rootsSeat, contextRoom } = opts;
|
|
38
74
|
const windows = opts.disclosureWindows ?? new Map();
|
|
39
75
|
const refuse = (envelope, kind) => ({
|
|
40
76
|
outcome: "not_attached",
|
|
@@ -56,18 +92,11 @@ export function createModelFileReader(opts) {
|
|
|
56
92
|
};
|
|
57
93
|
const readForModel = async (args, ctx, opts) => {
|
|
58
94
|
const readDeny = seatForCall(readDenySeat, ctx.toolCallId);
|
|
59
|
-
const { offset, limit, pages } = (args ?? {});
|
|
95
|
+
const { offset, limit, pages, allow_large: allowLarge } = (args ?? {});
|
|
96
|
+
const optedIn = allowLarge === true;
|
|
60
97
|
const path = fileArgPath(args);
|
|
61
98
|
if (path === undefined)
|
|
62
99
|
return refuse(errorResult(`Error (Read): file_path is required.`));
|
|
63
|
-
const unchanged = (note, kind, reason, startLine, endLine, totalLines) => ({
|
|
64
|
-
outcome: "unchanged",
|
|
65
|
-
kind,
|
|
66
|
-
data: [],
|
|
67
|
-
notes: [note],
|
|
68
|
-
details: { type: "file_unchanged", reason, file: { filePath: path, startLine, endLine, totalLines } },
|
|
69
|
-
effects: NO_EFFECTS(),
|
|
70
|
-
});
|
|
71
100
|
const r = await resolve(path, ctx);
|
|
72
101
|
if (!r.ok)
|
|
73
102
|
return refuse(errorResult(violationText("Read", r.violation), violationDetails(r.violation)));
|
|
@@ -76,7 +105,14 @@ export function createModelFileReader(opts) {
|
|
|
76
105
|
return refuse(errorResult(`Error (Read): "${path.slice(0, 300)}" resolved to a different file while it was being checked, so it was not read.`, { type: "target_moved" }));
|
|
77
106
|
}
|
|
78
107
|
const bound = opts?.bound;
|
|
79
|
-
const readBytes = (key, laneCap) =>
|
|
108
|
+
const readBytes = async (key, laneCap) => {
|
|
109
|
+
if (bound !== undefined)
|
|
110
|
+
return bound.object.readBytes(laneCap, ctx.signal);
|
|
111
|
+
const got = await env.readBinaryFile(key, ctx.signal, laneCap + 1);
|
|
112
|
+
return got.ok && got.value.byteLength > laneCap
|
|
113
|
+
? { ok: false, error: new FileError("invalid", `The file is over the ${laneCap}-byte read cap (${got.value.byteLength} bytes or more); it was not read`, key) }
|
|
114
|
+
: got;
|
|
115
|
+
};
|
|
80
116
|
const info = bound === undefined ? await env.fileInfo(r.key, ctx.signal) : await bound.object.size().then((s) => (s.ok ? { ok: true, value: { kind: bound.object.kind, size: s.value } } : s));
|
|
81
117
|
if (info.ok && info.value.kind === "directory") {
|
|
82
118
|
return refuse(errorResult(`Error (Read): "${path}" is a directory, not a file; use glob/grep or list it with the shell.`), "directory");
|
|
@@ -89,7 +125,7 @@ export function createModelFileReader(opts) {
|
|
|
89
125
|
const ex = await env.exists(r.key, ctx.signal);
|
|
90
126
|
if (ex.ok && !ex.value)
|
|
91
127
|
return refuse(errorResult(`Error (Read): ${await enoentMessage(env, r.key, cwdRef?.current ?? rootCanonical, ctx.signal, readDeny)}`), "image");
|
|
92
|
-
return refuse(errorResult(`Error (Read): cannot stat image "${path}" to verify its size before reading: ${meta.error.message}`), "image");
|
|
128
|
+
return refuse(errorResult(`Error (Read): cannot stat image "${path}" to verify its size before reading: ${envErrorDetail(meta.error.message)}`), "image");
|
|
93
129
|
}
|
|
94
130
|
const processor = await resolveImageProcessor(imageProcessor);
|
|
95
131
|
const readCap = imageReadCap(processor);
|
|
@@ -99,7 +135,7 @@ export function createModelFileReader(opts) {
|
|
|
99
135
|
return refuse(errorResult(tooLargeToRead(meta.value.size)), "image");
|
|
100
136
|
const bin = await readBytes(r.key, readCap);
|
|
101
137
|
if (!bin.ok)
|
|
102
|
-
return refuse(errorResult(`Error (Read): cannot read image "${path}": ${bin.error.message}`), "image");
|
|
138
|
+
return refuse(errorResult(`Error (Read): cannot read image "${path}": ${envErrorDetail(bin.error.message)}`), "image");
|
|
103
139
|
const admitted = await admitImageBytes(bin.value, imageMime, processor);
|
|
104
140
|
if (!admitted.ok) {
|
|
105
141
|
switch (admitted.reason) {
|
|
@@ -134,12 +170,12 @@ export function createModelFileReader(opts) {
|
|
|
134
170
|
const pdfOf = async (preRead) => {
|
|
135
171
|
if (bound !== undefined || opts?.pdfAsReference === true) {
|
|
136
172
|
if (!info.ok)
|
|
137
|
-
return refuse(errorResult(`Error (Read): cannot size PDF "${path.slice(0, 300)}": ${info.error.message
|
|
173
|
+
return refuse(errorResult(`Error (Read): cannot size PDF "${path.slice(0, 300)}": ${envErrorDetail(info.error.message)}`), "pdf");
|
|
138
174
|
let held = preRead;
|
|
139
175
|
if (held === undefined && info.value.size <= PDF_TARGET_RAW_SIZE) {
|
|
140
176
|
const got = await readBytes(r.key, PDF_TARGET_RAW_SIZE);
|
|
141
177
|
if (!got.ok)
|
|
142
|
-
return refuse(errorResult(`Error (Read): cannot read PDF "${path.slice(0, 300)}": ${got.error.message
|
|
178
|
+
return refuse(errorResult(`Error (Read): cannot read PDF "${path.slice(0, 300)}": ${envErrorDetail(got.error.message)}`), "pdf");
|
|
143
179
|
held = got.value;
|
|
144
180
|
}
|
|
145
181
|
const pageCount = held !== undefined ? countPdfPagesFromBytes(held) : undefined;
|
|
@@ -166,8 +202,29 @@ export function createModelFileReader(opts) {
|
|
|
166
202
|
};
|
|
167
203
|
if (r.key.toLowerCase().endsWith(".pdf"))
|
|
168
204
|
return pdfOf(undefined);
|
|
205
|
+
let ticketRead;
|
|
206
|
+
const ticketOf = () => (ticketRead ??= contextRoom === undefined ? Promise.resolve(undefined) : contextRoom.open(ctx.toolCallId));
|
|
207
|
+
const offerFor = async (size) => {
|
|
208
|
+
const t = await ticketOf();
|
|
209
|
+
if (t === undefined)
|
|
210
|
+
return optedIn ? "unavailable" : undefined;
|
|
211
|
+
const limits = raisedReadLimitsOf(t);
|
|
212
|
+
if (optedIn || limits === undefined)
|
|
213
|
+
return "over_room";
|
|
214
|
+
const fits = "bytes" in size ? (size.bytes <= limits.bytes && leastServedReadTokens(size.bytes, t.charsPerToken) <= limits.tokens) : servedReadTokens(size.body, t.charsPerToken) <= limits.tokens;
|
|
215
|
+
return fits ? "read_anyway" : "over_room";
|
|
216
|
+
};
|
|
217
|
+
const clauseFor = async (size) => {
|
|
218
|
+
const offer = await offerFor(size);
|
|
219
|
+
return offer === undefined ? "" : LARGE_READ_CLAUSE[offer];
|
|
220
|
+
};
|
|
221
|
+
const ticket = optedIn ? await ticketOf() : undefined;
|
|
222
|
+
const raised = raisedReadLimitsOf(ticket);
|
|
223
|
+
const bytesCap = raised?.bytes ?? MAX_READ_BYTES;
|
|
224
|
+
let wholeCap = bytesCap;
|
|
169
225
|
const binaryExt = hasBinaryExtension(r.key);
|
|
170
226
|
const binaryExtRefusal = () => refuse(errorResult(`Error (Read): "${path}" appears to be a binary file (by extension); this tool reads UTF-8 text only.`), "text");
|
|
227
|
+
const tooLargeInFull = (size, cap, clause) => refuse(errorResult(`Error (Read): "${path}" is too large to read in full (${size} bytes > ${cap}-byte cap); pass an explicit offset/limit to read a slice, or use grep to search it instead.${clause}`), "text");
|
|
171
228
|
if (info.ok) {
|
|
172
229
|
if (info.value.size > SLICED_READ_MAX_BYTES) {
|
|
173
230
|
if (binaryExt)
|
|
@@ -176,50 +233,40 @@ export function createModelFileReader(opts) {
|
|
|
176
233
|
`(${info.value.size} bytes > ${SLICED_READ_MAX_BYTES}-byte cap — the reader loads the whole file into memory before slicing). ` +
|
|
177
234
|
`Stream a portion with bash instead, e.g. \`sed -n '1,200p' <file>\` for a line range or \`head -c 65536 <file>\` for the leading bytes, or use grep to search it.`), "text");
|
|
178
235
|
}
|
|
179
|
-
if (!isNb && info.value.size >
|
|
236
|
+
if (!isNb && info.value.size > bytesCap && limit === undefined) {
|
|
180
237
|
if (binaryExt)
|
|
181
238
|
return binaryExtRefusal();
|
|
182
|
-
|
|
239
|
+
const offer = await offerFor({ bytes: info.value.size });
|
|
240
|
+
if (offer !== "read_anyway")
|
|
241
|
+
return tooLargeInFull(info.value.size, bytesCap, offer === undefined ? "" : LARGE_READ_CLAUSE[offer]);
|
|
242
|
+
wholeCap = raisedReadLimitsOf(await ticketOf())?.bytes ?? bytesCap;
|
|
183
243
|
}
|
|
184
244
|
}
|
|
185
245
|
else {
|
|
186
246
|
const ex = await env.exists(r.key, ctx.signal);
|
|
187
247
|
if (ex.ok && !ex.value)
|
|
188
248
|
return refuse(errorResult(`Error (Read): ${await enoentMessage(env, r.key, cwdRef?.current ?? rootCanonical, ctx.signal, readDeny)}`), "text");
|
|
189
|
-
return refuse(errorResult(`Error (Read): cannot determine the type of "${path.slice(0, 300)}" (stat failed: ${info.error.message
|
|
249
|
+
return refuse(errorResult(`Error (Read): cannot determine the type of "${path.slice(0, 300)}" (stat failed: ${envErrorDetail(info.error.message)}); refusing to open it — if it is a FIFO/socket/device, reading it would hang. Retry if this was transient, or inspect it with Bash (e.g. \`file\`, \`ls -l\`).`), "text");
|
|
190
250
|
}
|
|
191
|
-
const readBin = await readBytes(r.key, !isNb && limit === undefined ?
|
|
251
|
+
const readBin = await readBytes(r.key, !isNb && limit === undefined ? wholeCap : SLICED_READ_MAX_BYTES);
|
|
192
252
|
if (!readBin.ok)
|
|
193
|
-
return refuse(errorResult(`Error (Read): cannot read "${path}": ${readBin.error.message}`), "text");
|
|
194
|
-
const
|
|
195
|
-
if (
|
|
196
|
-
if (binaryExt)
|
|
197
|
-
return binaryExtRefusal();
|
|
198
|
-
return refuse(errorResult(`Error (Read): "${path}" is too large to read with this tool even as an offset/limit slice ` +
|
|
199
|
-
`(${readSize} bytes > ${SLICED_READ_MAX_BYTES}-byte cap — the reader loads the whole file into memory before slicing). ` +
|
|
200
|
-
`Stream a portion with bash instead, e.g. \`sed -n '1,200p' <file>\` for a line range or \`head -c 65536 <file>\` for the leading bytes, or use grep to search it.`), "text");
|
|
201
|
-
}
|
|
202
|
-
if (!isNb && readSize > MAX_READ_BYTES && limit === undefined) {
|
|
203
|
-
if (binaryExt)
|
|
204
|
-
return binaryExtRefusal();
|
|
205
|
-
return refuse(errorResult(`Error (Read): "${path}" is too large to read in full (${readSize} bytes > ${MAX_READ_BYTES}-byte cap); pass an explicit offset/limit to read a slice, or use grep to search it instead.`), "text");
|
|
206
|
-
}
|
|
207
|
-
if (pdfMagicMatches(readBin.value))
|
|
253
|
+
return refuse(errorResult(`Error (Read): cannot read "${path}": ${envErrorDetail(readBin.error.message)}`), "text");
|
|
254
|
+
const lane = textLaneOf(readBin.value);
|
|
255
|
+
if (lane.kind === "pdf")
|
|
208
256
|
return pdfOf(readBin.value);
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
return refuse(errorResult(`Error (Read): "${path}" appears to be a binary file (${magicFormat}, identified by its file signature — whatever its extension says); ` +
|
|
257
|
+
if (lane.kind === "binary_format") {
|
|
258
|
+
return refuse(errorResult(`Error (Read): "${path}" appears to be a binary file (${lane.format}, identified by its file signature — whatever its extension says); ` +
|
|
212
259
|
`this tool reads UTF-8 and BOM-marked UTF-16LE text only. Inspect or convert it with bash instead.`), "text");
|
|
213
260
|
}
|
|
214
|
-
|
|
215
|
-
if (decoded.malformed === "truncated_utf16") {
|
|
261
|
+
if (lane.kind === "truncated_utf16") {
|
|
216
262
|
return refuse(errorResult(`Error (Read): "${path}" has a UTF-16 BOM but a truncated (odd-length) body — the file is corrupt or mis-labelled; repair/convert it with bash (e.g. \`iconv\`) first.`), "text");
|
|
217
263
|
}
|
|
218
|
-
|
|
219
|
-
if (isBinaryContent(content.slice(0, 8192))) {
|
|
264
|
+
if (lane.kind === "binary_content") {
|
|
220
265
|
return refuse(errorResult(`Error (Read): "${path}" appears to be a binary file (non-text content); this tool reads UTF-8 and BOM-marked UTF-16LE text only. ` +
|
|
221
266
|
`If it is UTF-16 without a BOM or a legacy encoding, convert it first (e.g. \`iconv -f UTF-16LE -t UTF-8\`) or inspect/transform it with bash.`), "text");
|
|
222
267
|
}
|
|
268
|
+
const decoded = lane.decoded;
|
|
269
|
+
const content = decoded.text;
|
|
223
270
|
const nbParsed = isNb ? parseNotebookCells(content, path) : undefined;
|
|
224
271
|
const nbForced = nbParsed !== undefined && nbParsed.ok;
|
|
225
272
|
const effOffset = nbForced ? undefined : offset;
|
|
@@ -244,23 +291,16 @@ export function createModelFileReader(opts) {
|
|
|
244
291
|
const parsed = nbParsed;
|
|
245
292
|
const rendered = renderNotebookCells(parsed.cells, NOTEBOOK_IMAGE_BASE64_BUDGET);
|
|
246
293
|
if (rendered.textChars > MAX_READ_OUTPUT_CHARS) {
|
|
247
|
-
return refuse(errorResult(`Error (Read): notebook "${path}" projects to ~${Math.round(rendered.textChars / 4)} tokens of cell content, over the
|
|
294
|
+
return refuse(errorResult(`Error (Read): notebook "${path}" projects to ~${Math.round(rendered.textChars / 4)} tokens of cell content, over the ${BASE_READ_TOKENS}-token limit ` +
|
|
248
295
|
`(offset/limit do not apply to notebooks — the whole notebook is always projected). Inspect portions with Bash + jq instead, e.g.\n` +
|
|
249
296
|
` cat "${path}" | jq '.cells[:20]' # First 20 cells\n` +
|
|
250
297
|
` cat "${path}" | jq '.cells | length' # Count total cells\n` +
|
|
251
298
|
` cat "${path}" | jq '.cells[] | select(.cell_type=="code") | .source' # All code sources`), "notebook");
|
|
252
299
|
}
|
|
253
|
-
const prevNb = (opts?.dedupAgainst ?? state).get(r.key);
|
|
254
|
-
if (prevNb?.seededFromContext && !prevNb.isPartialView && prevNb.hash === hash) {
|
|
255
|
-
return unchanged({ kind: "already_in_context", key: r.key }, "notebook", "already-in-context", 1, total, total);
|
|
256
|
-
}
|
|
257
|
-
if (prevNb && !prevNb.isPartialView && prevNb.hash === hash && prevNb.view && prevNb.view.start === 1 && prevNb.view.end === total) {
|
|
258
|
-
return unchanged({ kind: "unchanged", path, start: 1, end: total, total }, "notebook", "unchanged-since-last-read", 1, total, total);
|
|
259
|
-
}
|
|
260
300
|
const observation = { key: r.key, entry: { hash, totalLines: countLines(content), truncated: false, view: { start: 1, end: total } } };
|
|
261
301
|
if (rendered.blocks.length === 0)
|
|
262
302
|
notes.push({ kind: "notebook_no_cells" });
|
|
263
|
-
const disclosure = disclosureOf(rendered.blocks.filter((b) => b.type === "text").map((b) => b.text), "notebook", r.key, opts?.
|
|
303
|
+
const disclosure = disclosureOf(rendered.blocks.filter((b) => b.type === "text").map((b) => b.text), "notebook", r.key, opts?.freshContext !== true);
|
|
264
304
|
if (disclosure.note !== undefined)
|
|
265
305
|
notes.push(disclosure.note);
|
|
266
306
|
return {
|
|
@@ -278,12 +318,20 @@ export function createModelFileReader(opts) {
|
|
|
278
318
|
const renderBody = (sl) => sl.map((l, i) => `${start + i}\t${l}`).join("\n");
|
|
279
319
|
let body = renderBody(slice);
|
|
280
320
|
let partial;
|
|
281
|
-
|
|
321
|
+
const booked = raised !== undefined && ticket !== undefined ? { ticket, tokens: servedReadTokens(body, ticket.charsPerToken) } : undefined;
|
|
322
|
+
const lifted = booked !== undefined ? raisedReadLimitsOf(booked.ticket) : undefined;
|
|
323
|
+
const overBaseBytes = !isNb && limit === undefined && readBin.value.length > MAX_READ_BYTES;
|
|
324
|
+
if ((body.length > MAX_READ_OUTPUT_CHARS || overBaseBytes) && (lifted === undefined || booked === undefined || booked.tokens > lifted.tokens)) {
|
|
325
|
+
if (overBaseBytes)
|
|
326
|
+
return tooLargeInFull(readBin.value.length, MAX_READ_BYTES, await clauseFor({ body }));
|
|
282
327
|
const defaultFullRead = start <= 1 && effLimit === undefined;
|
|
328
|
+
const room = lifted !== undefined && booked !== undefined ? lifted.tokens : undefined;
|
|
329
|
+
const approxTokens = room !== undefined && booked !== undefined ? booked.tokens : Math.round(body.length / 4);
|
|
330
|
+
const offer = await offerFor({ body });
|
|
283
331
|
if (!defaultFullRead) {
|
|
284
|
-
return refuse(errorResult(`Error (Read): the requested range of "${path}" is ~${
|
|
332
|
+
return refuse(errorResult(`Error (Read): the requested range of "${path}" is ~${approxTokens} tokens, over the ${room ?? BASE_READ_TOKENS}-token limit. Narrow it with offset/limit, or use grep to search the file.${offer === undefined ? "" : LARGE_READ_CLAUSE[offer]}`), "text");
|
|
285
333
|
}
|
|
286
|
-
const
|
|
334
|
+
const told = { ...(room !== undefined ? { room } : {}), ...(offer !== undefined ? { offer } : {}) };
|
|
287
335
|
let n = Math.max(1, Math.min(slice.length, Math.floor(slice.length * (MAX_READ_OUTPUT_CHARS / body.length) * 0.95)));
|
|
288
336
|
let paged = slice.slice(0, n);
|
|
289
337
|
let pagedBody = renderBody(paged);
|
|
@@ -296,7 +344,7 @@ export function createModelFileReader(opts) {
|
|
|
296
344
|
slice = paged;
|
|
297
345
|
end = start - 1 + slice.length;
|
|
298
346
|
body = pagedBody;
|
|
299
|
-
partial = { kind: "partial_page", end, total, approxTokens };
|
|
347
|
+
partial = { kind: "partial_page", end, total, approxTokens, ...told };
|
|
300
348
|
}
|
|
301
349
|
else {
|
|
302
350
|
let cut = MAX_READ_OUTPUT_CHARS - 200;
|
|
@@ -306,17 +354,12 @@ export function createModelFileReader(opts) {
|
|
|
306
354
|
slice = [slice[0].slice(0, cut)];
|
|
307
355
|
end = start;
|
|
308
356
|
body = renderBody(slice);
|
|
309
|
-
partial = { kind: "partial_chars", cut, totalChars: content.length, approxTokens };
|
|
357
|
+
partial = { kind: "partial_chars", cut, totalChars: content.length, approxTokens, ...told };
|
|
310
358
|
}
|
|
311
359
|
}
|
|
312
360
|
const truncated = start > 1 || end < total || partial !== undefined;
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
return unchanged({ kind: "already_in_context", key: r.key }, "text", "already-in-context", 1, total, total);
|
|
316
|
-
}
|
|
317
|
-
if (total > 0 && prev && !prev.isPartialView && prev.hash === hash && prev.view && prev.view.start === start && prev.view.end === end) {
|
|
318
|
-
return unchanged({ kind: "unchanged", path, start, end, total }, "text", "unchanged-since-last-read", start, end, total);
|
|
319
|
-
}
|
|
361
|
+
if (booked !== undefined && partial === undefined)
|
|
362
|
+
booked.ticket.claim(booked.tokens);
|
|
320
363
|
const observation = {
|
|
321
364
|
key: r.key,
|
|
322
365
|
entry: { hash, totalLines: countLines(content), truncated, ...(partial !== undefined ? { isPartialView: true } : {}), view: { start, end } },
|
|
@@ -327,7 +370,7 @@ export function createModelFileReader(opts) {
|
|
|
327
370
|
notes.push(partial);
|
|
328
371
|
else if (truncated)
|
|
329
372
|
notes.push({ kind: "range", path, start, end, total });
|
|
330
|
-
const disclosure = disclosureOf([body], "read", r.key, opts?.
|
|
373
|
+
const disclosure = disclosureOf([body], "read", r.key, opts?.freshContext !== true);
|
|
331
374
|
if (disclosure.note !== undefined)
|
|
332
375
|
notes.push(disclosure.note);
|
|
333
376
|
return {
|
|
@@ -357,6 +400,40 @@ export function createModelFileReader(opts) {
|
|
|
357
400
|
const r = await resolve(path, ctx).catch((err) => ({ ok: false, violation: { code: "invalid", message: thrownText(err) } }));
|
|
358
401
|
return r.ok ? { ok: true, key: r.key } : { ok: false, refusal: errorResult(violationText("Read", r.violation), violationDetails(r.violation)) };
|
|
359
402
|
},
|
|
403
|
+
async readText(path, ctx, { judgedKey, capBytes, bound }) {
|
|
404
|
+
const r = await resolve(path, ctx).catch(() => undefined);
|
|
405
|
+
if (r === undefined || !r.ok)
|
|
406
|
+
return { kind: "refused" };
|
|
407
|
+
if (judgedKey !== undefined && r.key !== judgedKey)
|
|
408
|
+
return { kind: "moved" };
|
|
409
|
+
if (bound !== undefined) {
|
|
410
|
+
if (bound.key !== r.key)
|
|
411
|
+
return { kind: "moved" };
|
|
412
|
+
if (bound.object.kind === "directory")
|
|
413
|
+
return { kind: "not_text" };
|
|
414
|
+
const held = await bound.object.readBytes(capBytes, ctx.signal);
|
|
415
|
+
if (!held.ok)
|
|
416
|
+
return held.error.code === "invalid" ? { kind: "oversize" } : { kind: "unavailable" };
|
|
417
|
+
const heldLane = textLaneOf(held.value);
|
|
418
|
+
return heldLane.kind === "text" && heldLane.decoded.malformed === undefined ? { kind: "text", text: heldLane.decoded.text } : { kind: "not_text" };
|
|
419
|
+
}
|
|
420
|
+
const info = await env.fileInfo(r.key, ctx.signal);
|
|
421
|
+
if (!info.ok) {
|
|
422
|
+
const ex = await env.exists(r.key, ctx.signal);
|
|
423
|
+
return ex.ok && !ex.value ? { kind: "absent" } : { kind: "unavailable" };
|
|
424
|
+
}
|
|
425
|
+
if (info.value.kind === "directory")
|
|
426
|
+
return { kind: "not_text" };
|
|
427
|
+
if (info.value.size > capBytes)
|
|
428
|
+
return { kind: "oversize" };
|
|
429
|
+
const bin = await env.readBinaryFile(r.key, ctx.signal, capBytes + 1);
|
|
430
|
+
if (!bin.ok)
|
|
431
|
+
return { kind: "unavailable" };
|
|
432
|
+
if (bin.value.byteLength > capBytes)
|
|
433
|
+
return { kind: "oversize" };
|
|
434
|
+
const lane = textLaneOf(bin.value);
|
|
435
|
+
return lane.kind === "text" && lane.decoded.malformed === undefined ? { kind: "text", text: lane.decoded.text } : { kind: "not_text" };
|
|
436
|
+
},
|
|
360
437
|
openBound: (key, signal) => (env.openBound !== undefined ? env.openBound(key, signal) : Promise.resolve({ ok: false, error: new FileError("not_supported", UNBINDABLE, key) })),
|
|
361
438
|
listDirectory: (bound, signal) => enumerateDirectory(env, bound.key, readDenySeat !== undefined ? createEntryDenyJudge(env, readDenySeat, signal) : undefined, signal, () => bound.object.list(signal)),
|
|
362
439
|
planDisclosure(segments, throttleKey) {
|
|
@@ -368,10 +445,14 @@ export function createModelFileReader(opts) {
|
|
|
368
445
|
throw new Error("ModelFileReader.commit: this read result was already committed — a delivery commits its read once");
|
|
369
446
|
committed.add(result);
|
|
370
447
|
if (result.observation !== undefined) {
|
|
448
|
+
const entry = result.observation.entry;
|
|
449
|
+
const prior = state.get(result.observation.key);
|
|
450
|
+
const sameBody = prior !== undefined && prior.hash === entry.hash && prior.view?.start === entry.view?.start && prior.view?.end === entry.view?.end && prior.isPartialView === entry.isPartialView;
|
|
451
|
+
const witnesses = [...new Set([...(sameBody ? (prior.witnesses ?? []) : []), ...(at?.transmittedByToolCallId !== undefined ? [at.transmittedByToolCallId] : [])])];
|
|
371
452
|
state.set(result.observation.key, {
|
|
372
|
-
...
|
|
453
|
+
...entry,
|
|
373
454
|
lastReadAt: at?.now ?? Date.now(),
|
|
374
|
-
|
|
455
|
+
...(witnesses.length > 0 ? { witnesses } : {}),
|
|
375
456
|
});
|
|
376
457
|
}
|
|
377
458
|
for (const e of result.effects.disclosure)
|
|
@@ -379,25 +460,23 @@ export function createModelFileReader(opts) {
|
|
|
379
460
|
},
|
|
380
461
|
};
|
|
381
462
|
}
|
|
463
|
+
const partialCapPhrase = (room) => (room !== undefined ? `allow_large had room for ${room} tokens this turn` : `cap ${BASE_READ_TOKENS}`);
|
|
464
|
+
const partialOfferClause = (offer) => (offer !== undefined ? LARGE_READ_CLAUSE[offer] : "");
|
|
382
465
|
export function renderReadNoteForTool(note, mark) {
|
|
383
466
|
switch (note.kind) {
|
|
384
467
|
case "empty_file":
|
|
385
468
|
return `${openSystemReminder(mark)}Warning: the file exists but the contents are empty.</system-reminder>`;
|
|
386
469
|
case "past_eof":
|
|
387
470
|
return `${openSystemReminder(mark)}Warning: the file exists but is shorter than the provided offset (${note.offset}). The file has ${note.totalLines} lines.</system-reminder>`;
|
|
388
|
-
case "already_in_context":
|
|
389
|
-
return seededFileUnchangedReminder(note.key, mark);
|
|
390
|
-
case "unchanged":
|
|
391
|
-
return `[${note.path}: unchanged since you last read it (lines ${note.start}-${note.end} of ${note.total}); content omitted to save context]`;
|
|
392
471
|
case "range":
|
|
393
472
|
return `[${note.path}: lines ${note.start}-${note.end} of ${note.total}${note.end < note.total ? " — use offset to see more" : ""}]\n`;
|
|
394
473
|
case "partial_page":
|
|
395
|
-
return (`[Truncated: PARTIAL view — showing lines 1-${note.end} of ${note.total} total (~${note.approxTokens} tokens,
|
|
396
|
-
`Call Read with offset=${note.end + 1} limit=${note.end} for the next page, or Grep to find a specific section. ` +
|
|
474
|
+
return (`[Truncated: PARTIAL view — showing lines 1-${note.end} of ${note.total} total (~${note.approxTokens} tokens, ${partialCapPhrase(note.room)}). ` +
|
|
475
|
+
`Call Read with offset=${note.end + 1} limit=${note.end} for the next page, or Grep to find a specific section.${partialOfferClause(note.offer)} ` +
|
|
397
476
|
`Do NOT answer from this page alone if the answer may be further in the file.]\n`);
|
|
398
477
|
case "partial_chars":
|
|
399
|
-
return (`[Truncated: PARTIAL view — showing the first ${note.cut} of ${note.totalChars} characters (~${note.approxTokens} tokens,
|
|
400
|
-
`this file has very long lines and cannot be paginated by line. Use Grep to find a specific section, or Read with offset/limit to page through it. ` +
|
|
478
|
+
return (`[Truncated: PARTIAL view — showing the first ${note.cut} of ${note.totalChars} characters (~${note.approxTokens} tokens, ${partialCapPhrase(note.room)}); ` +
|
|
479
|
+
`this file has very long lines and cannot be paginated by line. Use Grep to find a specific section, or Read with offset/limit to page through it.${partialOfferClause(note.offer)} ` +
|
|
401
480
|
`Do NOT answer from this excerpt alone if the answer may be elsewhere in the file.]\n`);
|
|
402
481
|
case "notebook_fallback":
|
|
403
482
|
return "[not a parseable notebook — showing raw file text]\n";
|
|
@@ -420,8 +499,6 @@ export function renderReadToolResult(r, mark) {
|
|
|
420
499
|
const lead = r.notes.find((n) => n.kind === "past_eof" || n.kind === "empty_file");
|
|
421
500
|
if (lead !== undefined)
|
|
422
501
|
return renderReadNoteForTool(lead, mark);
|
|
423
|
-
if (r.outcome === "unchanged")
|
|
424
|
-
return { content: renderReadNoteForTool(r.notes[0], mark), ...(r.details !== undefined ? { details: r.details } : {}) };
|
|
425
502
|
const disclosure = noteOf("disclosure");
|
|
426
503
|
const trailer = disclosure !== undefined ? renderReadNoteForTool(disclosure, mark) : undefined;
|
|
427
504
|
switch (r.kind) {
|
|
@@ -481,7 +558,7 @@ export function createReadFileTool(env, state, rootCanonical, cwdRef, additional
|
|
|
481
558
|
"- Results are returned using cat -n format, with line numbers starting at 1\n" +
|
|
482
559
|
"- Reads images (PNG, JPG, …) and presents them visually. Reads PDFs via the `pages` parameter (e.g. \"1-5\", max 20 pages/request; a PDF whose detected page count exceeds 10 requires `pages`). Reads Jupyter notebooks (.ipynb) as cells with outputs (offset/limit do not apply).\n" +
|
|
483
560
|
"- Reading a directory, a missing file, or an empty file returns an error or system reminder rather than content.\n" +
|
|
484
|
-
"- Other binaries (archives, executables) are refused. A whole-file read of a text file over 256 KB is refused — read it in slices with explicit offset/limit, or Grep it instead.\n" +
|
|
561
|
+
"- Other binaries (archives, executables) are refused. A whole-file read of a text file over 256 KB is refused unless `allow_large` is set and the file fits the context left this turn — read it in slices with explicit offset/limit, or Grep it instead.\n" +
|
|
485
562
|
"- You must read a file before editing it.\n" +
|
|
486
563
|
"- Do NOT re-read a file you just edited to verify — Edit/Write would have errored if the change failed, and the harness tracks file state for you.",
|
|
487
564
|
descriptionVariants: [{ id: "classic", traits: { noneOf: ["lean_prompt"] }, text: "Reads a file from the local filesystem.\n" +
|
|
@@ -495,7 +572,7 @@ export function createReadFileTool(env, state, rootCanonical, cwdRef, additional
|
|
|
495
572
|
"- You must read a file before editing it.\n" +
|
|
496
573
|
"- Reads PDFs (.pdf): the document is provided to the model directly (text layer included). Use the `pages` parameter (e.g., \"1-5\") to read a page range; a PDF whose detected page count exceeds 10 requires `pages`. Maximum 20 pages per request.\n" +
|
|
497
574
|
"- Reads Jupyter notebooks (.ipynb) as cells with outputs (offset/limit do not apply).\n" +
|
|
498
|
-
"- Other binaries (archives, executables) are refused. A whole-file read of a text file over 256 KB is refused — read it in slices with explicit offset/limit, or Grep it instead.\n" +
|
|
575
|
+
"- Other binaries (archives, executables) are refused. A whole-file read of a text file over 256 KB is refused unless `allow_large` is set and the file fits the context left this turn — read it in slices with explicit offset/limit, or Grep it instead.\n" +
|
|
499
576
|
"- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.\n" +
|
|
500
577
|
"- Do NOT re-read a file you just edited to verify — Edit/Write would have errored if the change failed, and the harness tracks file state for you." }],
|
|
501
578
|
parameters: Type.Object({
|
|
@@ -503,6 +580,9 @@ export function createReadFileTool(env, state, rootCanonical, cwdRef, additional
|
|
|
503
580
|
offset: Type.Optional(Type.Integer({ minimum: 0, description: "The line number to start reading from. Only provide if the file is too large to read at once (1-based; default 1)." })),
|
|
504
581
|
limit: Type.Optional(Type.Integer({ minimum: 1, description: "The number of lines to read. Only provide if the file is too large to read at once. (Default: the whole file, bounded by the output-token cap.)" })),
|
|
505
582
|
pages: Type.Optional(Type.String({ description: `Page range for PDF files (e.g., "1-5", "3", "10-20"). Only applicable to PDF files. Maximum ${PDF_MAX_PAGES_PER_READ} pages per request.` })),
|
|
583
|
+
allow_large: Type.Optional(Type.Boolean({
|
|
584
|
+
description: "Set to true to read a text file, or a line range of one, that is over the usual size limits, up to what still fits in your context. Only use this when you genuinely need all of it or the user asked for the whole file; otherwise read it in parts with offset and limit, or search it.",
|
|
585
|
+
})),
|
|
506
586
|
}),
|
|
507
587
|
execute: async (args, ctx) => {
|
|
508
588
|
const result = await reader.readForModel(args, ctx);
|
|
@@ -2,7 +2,7 @@ import type { AgentTool, ExecutionEnv } from "../../internal/harness-types.js";
|
|
|
2
2
|
import { type RootsSeat } from "./safety.js";
|
|
3
3
|
import { type ReadDenyMatcher } from "./read-deny.js";
|
|
4
4
|
import type { ContainmentFace } from "./containment-face.js";
|
|
5
|
-
import type
|
|
5
|
+
import { type CwdRef } from "./fs-shared.js";
|
|
6
6
|
/**
|
|
7
7
|
* The Grep card's details assembly, PURE over the engine text ({mode, offset} from the request) —
|
|
8
8
|
* exported so the text→structured mapping is pinnable with synthetic texts (the byte-truncation and
|
|
@@ -4,6 +4,8 @@ import { clipSpelling, pathFamilyOf, resolveKey, violationText, violationDetails
|
|
|
4
4
|
import { runGrepDetailed, runGlobDetailed, invalidGlobTokens } from "./search.js";
|
|
5
5
|
import { seatForCall } from "./read-deny.js";
|
|
6
6
|
import { readFloorSeat } from "./read-floor.js";
|
|
7
|
+
import {} from "./fs-shared.js";
|
|
8
|
+
import { envErrorDetail } from "./env-error-detail.js";
|
|
7
9
|
import { toolFace } from "../../core/tool-catalog-entries.js";
|
|
8
10
|
import { pathTargetBaseOf, splitAbsoluteGlobPattern } from "../../core/effective-path-target.js";
|
|
9
11
|
import { pathTargetValue } from "../../core/tool-registry.js";
|
|
@@ -157,7 +159,7 @@ export function createGrepTool(env, rootCanonical, rootsSeat, denySeat, readFace
|
|
|
157
159
|
if (!info.ok) {
|
|
158
160
|
const ex = await env.exists(scoped, ctx.signal);
|
|
159
161
|
if (!(ex.ok && !ex.value)) {
|
|
160
|
-
return errorResult(`Error (Grep): cannot determine the type of "${scopeSpelling.slice(0, 300)}" (stat failed: ${info.error.message
|
|
162
|
+
return errorResult(`Error (Grep): cannot determine the type of "${scopeSpelling.slice(0, 300)}" (stat failed: ${envErrorDetail(info.error.message)}); refusing to search it — if it is a FIFO/socket/device, reading it would hang. Retry if this was transient.`);
|
|
161
163
|
}
|
|
162
164
|
}
|
|
163
165
|
}
|