@sema-agent/core 7.66.1 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3483 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -146,19 +146,25 @@ export declare function zeroOutputSentence(error: {
|
|
|
146
146
|
partialStdout?: string;
|
|
147
147
|
partialStderr?: string;
|
|
148
148
|
}, timeoutSec: number, noOutputSec: number | undefined): string;
|
|
149
|
-
/**
|
|
150
|
-
*
|
|
149
|
+
/** Read's base output budget in tokens (CC's 25000): the size a read is served or paged at without
|
|
150
|
+
* `allow_large`, and the bar `allow_large` must clear before it raises anything (a turn whose room is not
|
|
151
|
+
* above this keeps the base limits). Every sentence that names the base limit renders this one number. */
|
|
152
|
+
export declare const BASE_READ_TOKENS = 25000;
|
|
153
|
+
/** Output-token cap as a char proxy (`BASE_READ_TOKENS` at ~4 chars/token). Caps the shown body so 2000
|
|
154
|
+
* very long lines cannot blow the context budget.
|
|
151
155
|
*
|
|
152
156
|
* Only the 25000 NUMBER is CC's. CC does NOT use a flat chars/4 proxy — it pre-filters with a
|
|
153
157
|
* PER-EXTENSION chars-per-token coefficient (json/jsonl = 2, half the 4 assumed here) and then
|
|
154
|
-
* confirms with a REAL tokenizer; its budget is also overridable
|
|
155
|
-
*
|
|
156
|
-
* (
|
|
157
|
-
*
|
|
158
|
-
*
|
|
159
|
-
*
|
|
160
|
-
*
|
|
161
|
-
|
|
158
|
+
* confirms with a REAL tokenizer; its budget is also overridable by a feature gate, which has no sema
|
|
159
|
+
* lane. The per-call override does: `allow_large` raises the budget to the turn's context room
|
|
160
|
+
* (`fs-read.ts`), measuring the served body as `max(chars / charsPerToken, bytes / 2)` — CC's own
|
|
161
|
+
* tokenizer-less floor. Consequence, stated rather than hidden: on token-dense text (JSON/CJK/base64)
|
|
162
|
+
* this proxy UNDER-counts, so sema serves a page CC would have cut further; on token-sparse text it
|
|
163
|
+
* over-counts and paginates earlier than CC. A real tokenizer here would need a provider-neutral
|
|
164
|
+
* counting seam (BYOM — no single vocabulary), which is why the proxy stands; the divergence is a
|
|
165
|
+
* fidelity delta, not a correctness one (the partial-view marker always states the served window
|
|
166
|
+
* truthfully). */
|
|
167
|
+
export declare const MAX_READ_OUTPUT_CHARS: number;
|
|
162
168
|
export declare const BASH_DEFAULT_TIMEOUT_SEC = 120;
|
|
163
169
|
export declare const BASH_MAX_TIMEOUT_SEC = 600;
|
|
164
170
|
export declare const BASH_DEFAULT_TIMEOUT_MS: number;
|
|
@@ -186,14 +192,6 @@ export declare const MIN_BASH_TIMEOUT_MS = 1000;
|
|
|
186
192
|
* the 1-second floor. Between {@link MIN_BASH_TIMEOUT_MS} (exclusive) and this, every request lands on
|
|
187
193
|
* the floor with its remainder discarded. */
|
|
188
194
|
export declare const BASH_TIMEOUT_PLATEAU_END_MS = 1500;
|
|
189
|
-
/**
|
|
190
|
-
* A host-supplied failure `message` is untrusted as a CARRIER OF FACTS: an execution env whose adapter
|
|
191
|
-
* hands back an empty (or whitespace-only) string turns any text built as `Error (X): ${message}` into a
|
|
192
|
-
* bare `Error (X):` — a card with a red badge and nothing to act on, which is exactly what a model (and
|
|
193
|
-
* a person) reads as "the engine broke and won't say how". Use this wherever the message IS the whole
|
|
194
|
-
* fact; where it only decorates a sentence the engine wrote itself, interpolate it directly.
|
|
195
|
-
*/
|
|
196
|
-
export declare function envErrorDetail(message: string | undefined): string;
|
|
197
195
|
/**
|
|
198
196
|
* The `timeout` parameter's model-facing description, rendered from the SAME caps the runtime enforces
|
|
199
197
|
* and the SAME plateau the refusal applies — one text for both shell legs so a boundary can never be
|
|
@@ -406,35 +404,23 @@ export declare function ipynbRedirect(toolName: string, path: string): string |
|
|
|
406
404
|
* ends in "\n". Behavior is identical for content WITHOUT a trailing newline. Shared by read_file's
|
|
407
405
|
* `total`, edit_file/write_file's "N lines" report, and the persisted ReadFileState.totalLines. */
|
|
408
406
|
export declare function countLines(s: string): number;
|
|
409
|
-
/** The
|
|
410
|
-
* unchanged
|
|
407
|
+
/** The sentence a request carries in place of a whole-file Read of a file this leg seeded into its system prompt,
|
|
408
|
+
* unchanged (`request-copy-projection.ts`; the result itself stores the contents). `filePath` is the CANONICAL key (CC passes the resolved full path, matching the
|
|
411
409
|
* `Contents of <path>` header its context seeding emits — deployments seeding files should title the
|
|
412
410
|
* injected block the same way so the back-reference lands). Locked verbatim by test: the BODY and
|
|
413
411
|
* close tag stay fixed; the open tag alone is rendered by the mint home and carries the session
|
|
414
412
|
* mark when one is threaded (the recorded wire-form divergence). */
|
|
415
413
|
export declare function seededFileUnchangedReminder(filePath: string, mark?: string): string;
|
|
416
|
-
/**
|
|
417
|
-
* True when `resultText` is one of the Read tool's TWO dedup markers (the ordinary
|
|
418
|
-
* unchanged-since-last-read stub below, or {@link seededFileUnchangedReminder}) rather than a genuine
|
|
419
|
-
* content transmission. A consumer deciding "is this file's real content present in THIS message"
|
|
420
|
-
* (e.g. auto-compaction's kept-tail visibility scan) must treat a stub hit as absence — the marker
|
|
421
|
-
* POINTS AT an earlier read that may itself no longer be in context.
|
|
422
|
-
*
|
|
423
|
-
* Both emitters ALSO carry a structured marker (`details.type === "file_unchanged"`,
|
|
424
|
-
* fs-read.ts `fileUnchangedResult`) — consumers with access to the tool result's `details` should
|
|
425
|
-
* branch on that instead of this prose match (which can false-positive on file CONTENT that quotes
|
|
426
|
-
* either sentence). This predicate stays for text-only surfaces (compaction sees rendered text).
|
|
427
|
-
*/
|
|
428
|
-
export declare function isReadDedupStubResult(resultText: string): boolean;
|
|
429
414
|
/** Pre-seed the hands' read state for a file whose FULL, disk-verbatim text was injected into the
|
|
430
|
-
* model's context at startup (`seededFromContext` seeding of the memory preload; sema:
|
|
431
|
-
*
|
|
432
|
-
* `content` MUST be the file's exact disk text at load time — the
|
|
433
|
-
*
|
|
415
|
+
* model's context at startup (`seededFromContext` seeding of the memory preload; sema: the memory
|
|
416
|
+
* engine's materialized index → prepare-task).
|
|
417
|
+
* `content` MUST be the file's exact disk text at load time — a hash match reads as "the seed is the file"; a
|
|
418
|
+
* truncated/annotated variant must NOT be seeded (CC exempts those via
|
|
434
419
|
* `isPartialView`; sema's contract is simply "don't seed partials"). `key` is the CANONICAL path
|
|
435
420
|
* (resolveKey output), so it collides correctly with real Read/Edit entries. Note the CC-faithful
|
|
436
|
-
* side effect: a seeded file passes read-before-edit (the model legitimately has the full text).
|
|
437
|
-
|
|
421
|
+
* side effect: a seeded file passes read-before-edit (the model legitimately has the full text).
|
|
422
|
+
* Returns the hash the entry carries — the leg's seed table (the request projection's seeded sentence) records it. */
|
|
423
|
+
export declare function seedReadFileStateFromContext(state: ReadFileState, key: string, content: string): string;
|
|
438
424
|
/**
|
|
439
425
|
* Seed the hands' read state from a WHOLE-file content the session transcript recorded on an earlier
|
|
440
426
|
* turn (the selection rules live in core/runner/session-file-state-replay.ts).
|
|
@@ -444,15 +430,26 @@ export declare function seedReadFileStateFromContext(state: ReadFileState, key:
|
|
|
444
430
|
* - `lastReadAt` is the RECORDED moment, not now. It is what the changed-files detector compares an
|
|
445
431
|
* mtime against, so an honest old stamp keeps a between-turns modification detectable; stamping
|
|
446
432
|
* "now" would hide exactly the change the model needs told about.
|
|
447
|
-
* - no `view
|
|
448
|
-
* with "unchanged since you last read it" — true only while the earlier read's body is still IN
|
|
449
|
-
* the context, which a continuation (or a compaction inside it) cannot promise.
|
|
433
|
+
* - no `view`: the entry claims the file's whole text, not a window the model was served.
|
|
450
434
|
* - no `seededFromContext`: that flag means the text lives in the system-prompt lane and survives
|
|
451
435
|
* compaction. This text lives in the transcript and does not.
|
|
452
436
|
* A Read result's text carries that result's call id (`transmission`), as the live read's entry does, so a trim that
|
|
453
437
|
* drops the result retires the entry; a Write's post-condition rode no result body and carries none.
|
|
454
438
|
*/
|
|
455
439
|
export declare function seedReadFileStateFromTranscript(state: ReadFileState, key: string, content: string, lastReadAt: number, transmission?: string): void;
|
|
440
|
+
/**
|
|
441
|
+
* The entries a leg may carry out of ANOTHER leg's read state — the one answer every cross-leg carrier reads (the
|
|
442
|
+
* same-Runner inheritance arm below, the durable resume's checkpoint seed): all of them but the seeded ones.
|
|
443
|
+
*
|
|
444
|
+
* `seededFromContext` claims the file's text lives in the system-prompt lane OF THAT LEG — a claim only the receiving
|
|
445
|
+
* leg's own startup seeding can make. A still-declared file is seeded again on the receiving leg (no loss); one the
|
|
446
|
+
* receiving deployment no longer declares must not keep answering a Read with an "already in your context" reminder
|
|
447
|
+
* that is no longer true, nor keep admitting an Edit the model never saw the text for. The filter is on the READ side:
|
|
448
|
+
* a checkpoint row an earlier release wrote still carries the flag, and is one case with a new row.
|
|
449
|
+
*
|
|
450
|
+
* Entries are returned by REFERENCE, in the source's order (ReadEntry values are never mutated in place).
|
|
451
|
+
*/
|
|
452
|
+
export declare function entriesCarriedAcrossLegs(entries: Iterable<readonly [string, ReadEntry]>): Array<[string, ReadEntry]>;
|
|
456
453
|
/**
|
|
457
454
|
* Copy a SESSION-inherited read-file state into a new task's map, under the new task's
|
|
458
455
|
* own containment judgment (CC parity: readFileState is session-scoped — minted once per REPL session,
|
|
@@ -465,25 +462,21 @@ export declare function seedReadFileStateFromTranscript(state: ReadFileState, ke
|
|
|
465
462
|
* root or face narrowed between the turns must narrow what the state remembers, exactly as the
|
|
466
463
|
* replay leg already judges — an unjudged copy would smuggle out-of-face entries into the task
|
|
467
464
|
* (and into its checkpoints).
|
|
468
|
-
* -
|
|
469
|
-
* system-prompt lane OF THIS TASK — a claim only this task's own startup seeding can make.
|
|
470
|
-
* A still-declared file is re-seeded the same turn (no loss); a no-longer-declared one must not
|
|
471
|
-
* keep answering reads with an "already in your context" reminder that is no longer true.
|
|
465
|
+
* - **Only what {@link entriesCarriedAcrossLegs} lets cross crosses** — the seeded entries do not inherit.
|
|
472
466
|
*
|
|
473
467
|
* Entries are copied by REFERENCE (ReadEntry values are never mutated in place — every write-back
|
|
474
468
|
* `set`s a fresh object), so recorded facts (view / isPartialView / lastReadAt) ride verbatim: the
|
|
475
|
-
*
|
|
469
|
+
* edit gate and the partial-view refusal keep working across turns exactly as inside one task.
|
|
476
470
|
*/
|
|
477
471
|
export declare function inheritSessionReadFileState(target: ReadFileState, inherited: ReadFileState, judgeKey: (recordedKey: string) => Promise<string | undefined>): Promise<void>;
|
|
478
472
|
/**
|
|
479
473
|
* CC parity: a landed compaction summarizes old Read results OUT of the context, so every non-seeded
|
|
480
474
|
* read-state entry must be dropped — CC snapshots then
|
|
481
|
-
* `readFileState.clear()`s at the same spot. Without this, the
|
|
482
|
-
*
|
|
483
|
-
* anywhere in the context (the model works from hallucinated memory or has to vary offset/limit to escape).
|
|
475
|
+
* `readFileState.clear()`s at the same spot. Without this, the read-before-edit gate admits an edit of a file
|
|
476
|
+
* whose content no longer exists anywhere in the context (the model works from memory of a summarized read).
|
|
484
477
|
* Two deliberate divergences from CC's bare clear(), each from sema's own structure:
|
|
485
478
|
* - SEEDED entries survive: their content lives in the system-prompt lane, which compaction never touches,
|
|
486
|
-
* so
|
|
479
|
+
* so the model still holds the text (CC re-seeds the same family right after its clear — equivalent end state).
|
|
487
480
|
* - A file still visible in the compaction's KEPT tail (its read or its attachment frame is there) survives
|
|
488
481
|
* unmodified, for the same reason: the model's view of it did not change. Wiping it would make the
|
|
489
482
|
* read-before-edit gate reject an Edit the model can visibly justify, and the next Read retransmit the file.
|
|
@@ -494,8 +487,10 @@ export declare function inheritSessionReadFileState(target: ReadFileState, inher
|
|
|
494
487
|
*/
|
|
495
488
|
/**
|
|
496
489
|
* What the read state holds once a landed summary has taken its reads out of view — the ONE answer to "which entries
|
|
497
|
-
* survive a compaction": the seeded entries and `preserveKeys
|
|
498
|
-
*
|
|
490
|
+
* survive a compaction": the seeded entries and `preserveKeys`, a surviving entry holding its newest witness only (the
|
|
491
|
+
* kept tail is the newest stretch of the transcript, so what it still shows of a file is the file's newest copy; the older
|
|
492
|
+
* copies went into the summary and would otherwise keep the entry standing after the last visible one leaves). The
|
|
493
|
+
* summarized clear applies it to the live state.
|
|
499
494
|
*/
|
|
500
495
|
export declare function readFileStateAfterSummary(state: ReadonlyMap<string, ReadEntry>, preserveKeys: ReadonlyArray<string>): ReadFileState;
|
|
501
496
|
/**
|
|
@@ -503,18 +498,19 @@ export declare function readFileStateAfterSummary(state: ReadonlyMap<string, Rea
|
|
|
503
498
|
* SHRINK rather than compaction: the request-layer stale-result pass replaces an old tool result's
|
|
504
499
|
* content with a cleared marker, and the request guard's last-resort trim drops old messages — a Read's
|
|
505
500
|
* result or an attachment frame among them — from the request; no summary, no re-attachment, nothing changed in the
|
|
506
|
-
* session — and for a read the effect on the entry is identical: the body
|
|
507
|
-
* longer anywhere the model can see, so the entry must retire with it. A transmission is named by the
|
|
501
|
+
* session — and for a read the effect on the entry is identical: the body it records the model as holding is no
|
|
502
|
+
* longer anywhere the model can see, so the entry must retire with it (the edit gate then asks for a fresh read). A transmission is named by the
|
|
508
503
|
* tool call that carried it, or by the attachment frame (`attachmentTransmissionId`).
|
|
509
504
|
*
|
|
510
|
-
* Selection is by the TRANSMISSION, not by path — an entry
|
|
511
|
-
*
|
|
512
|
-
* tell apart. KNOWN IMPRECISION: a call id is not
|
|
513
|
-
* by id + message timestamp + ordinal for that reason) and the
|
|
514
|
-
* mint, which does not know the timestamp of the message its result will land
|
|
515
|
-
* therefore retire one entry too many, costing a re-transmission and a tightened read-before-edit
|
|
516
|
-
* — the same tightening the summarized arm accepts wholesale. The converse is
|
|
517
|
-
*
|
|
505
|
+
* Selection is by the TRANSMISSION, not by path — an entry holds the id of every delivery of its body (its witness
|
|
506
|
+
* set, `ReadEntry.witnesses`), so a clear or a trim of one copy leaves the entry standing while another stays and
|
|
507
|
+
* retires it with the last, which a path-keyed retirement could not tell apart. KNOWN IMPRECISION: a call id is not
|
|
508
|
+
* unique over a run (the clear ledger keys occurrences by id + message timestamp + ordinal for that reason) and the
|
|
509
|
+
* finer key is not reachable at the Read mint, which does not know the timestamp of the message its result will land
|
|
510
|
+
* in. A reused id can therefore retire one entry too many, costing a re-transmission and a tightened read-before-edit
|
|
511
|
+
* gate — the same tightening the summarized arm accepts wholesale. The converse is a departure no arm reports (a copy
|
|
512
|
+
* the tool-turn law drops from the request is the candidate; none is constructed): the witness stays and the edit gate
|
|
513
|
+
* lets an edit through on a body the request does not carry.
|
|
518
514
|
*/
|
|
519
515
|
export type ReadFileStateShrink =
|
|
520
516
|
/** A landed compaction: everything but {@link readFileStateAfterSummary} retires (`preserveKeys` stayed visible in the kept tail). */
|
|
@@ -80,7 +80,8 @@ export function zeroOutputSentence(error, timeoutSec, noOutputSec) {
|
|
|
80
80
|
: "";
|
|
81
81
|
return `(no output was produced before the cutoff${hint})`;
|
|
82
82
|
}
|
|
83
|
-
export const
|
|
83
|
+
export const BASE_READ_TOKENS = 25_000;
|
|
84
|
+
export const MAX_READ_OUTPUT_CHARS = BASE_READ_TOKENS * 4;
|
|
84
85
|
export const BASH_DEFAULT_TIMEOUT_SEC = 120;
|
|
85
86
|
export const BASH_MAX_TIMEOUT_SEC = 600;
|
|
86
87
|
export const BASH_DEFAULT_TIMEOUT_MS = BASH_DEFAULT_TIMEOUT_SEC * 1000;
|
|
@@ -109,10 +110,6 @@ function validTimeoutMs(n) {
|
|
|
109
110
|
const floored = Math.floor(n);
|
|
110
111
|
return bashTimeoutDefect(floored) === undefined ? floored : undefined;
|
|
111
112
|
}
|
|
112
|
-
export function envErrorDetail(message) {
|
|
113
|
-
const trimmed = (message ?? "").trim();
|
|
114
|
-
return trimmed === "" ? "the execution environment reported no reason" : trimmed;
|
|
115
|
-
}
|
|
116
113
|
let announcedTimeoutConfigBySink = new WeakMap();
|
|
117
114
|
const announcedTimeoutConfigConsole = new Set();
|
|
118
115
|
function timeoutConfigLedger(onNotice) {
|
|
@@ -332,21 +329,24 @@ export function countLines(s) {
|
|
|
332
329
|
export function seededFileUnchangedReminder(filePath, mark) {
|
|
333
330
|
return `${openSystemReminder(mark)}This file is already in your context (see "Contents of ${filePath}" above) and has not changed on disk. Use that content instead of re-reading.</system-reminder>`;
|
|
334
331
|
}
|
|
335
|
-
export function isReadDedupStubResult(resultText) {
|
|
336
|
-
return (resultText.includes("unchanged since you last read it") ||
|
|
337
|
-
resultText.includes("has not changed on disk. Use that content instead of re-reading"));
|
|
338
|
-
}
|
|
339
332
|
export function seedReadFileStateFromContext(state, key, content) {
|
|
340
|
-
|
|
333
|
+
const hash = sha256(normalizeFileText(content));
|
|
334
|
+
state.set(key, { hash, totalLines: countLines(content), truncated: false, lastReadAt: Date.now(), seededFromContext: true });
|
|
335
|
+
return hash;
|
|
341
336
|
}
|
|
342
337
|
export function seedReadFileStateFromTranscript(state, key, content, lastReadAt, transmission) {
|
|
343
338
|
const text = normalizeFileText(content);
|
|
344
|
-
state.set(key, { hash: sha256(text), totalLines: countLines(text), truncated: false, lastReadAt, ...(transmission !== undefined ? {
|
|
339
|
+
state.set(key, { hash: sha256(text), totalLines: countLines(text), truncated: false, lastReadAt, ...(transmission !== undefined ? { witnesses: [transmission] } : {}) });
|
|
340
|
+
}
|
|
341
|
+
export function entriesCarriedAcrossLegs(entries) {
|
|
342
|
+
const kept = [];
|
|
343
|
+
for (const [key, entry] of entries)
|
|
344
|
+
if (entry.seededFromContext !== true)
|
|
345
|
+
kept.push([key, entry]);
|
|
346
|
+
return kept;
|
|
345
347
|
}
|
|
346
348
|
export async function inheritSessionReadFileState(target, inherited, judgeKey) {
|
|
347
|
-
for (const [key, entry] of inherited) {
|
|
348
|
-
if (entry.seededFromContext === true)
|
|
349
|
-
continue;
|
|
349
|
+
for (const [key, entry] of entriesCarriedAcrossLegs(inherited)) {
|
|
350
350
|
const judged = await judgeKey(key);
|
|
351
351
|
if (judged !== undefined)
|
|
352
352
|
target.set(judged, entry);
|
|
@@ -354,7 +354,9 @@ export async function inheritSessionReadFileState(target, inherited, judgeKey) {
|
|
|
354
354
|
}
|
|
355
355
|
export function readFileStateAfterSummary(state, preserveKeys) {
|
|
356
356
|
const preserve = new Set(preserveKeys);
|
|
357
|
-
return new Map([...state]
|
|
357
|
+
return new Map([...state]
|
|
358
|
+
.filter(([k, v]) => v.seededFromContext === true || preserve.has(k))
|
|
359
|
+
.map(([k, v]) => [k, v.witnesses !== undefined && v.witnesses.length > 1 ? { ...v, witnesses: v.witnesses.slice(-1) } : v]));
|
|
358
360
|
}
|
|
359
361
|
export function applyContextShrinkToReadFileState(state, shrink) {
|
|
360
362
|
if (shrink.kind === "transmissions-gone") {
|
|
@@ -362,15 +364,26 @@ export function applyContextShrinkToReadFileState(state, shrink) {
|
|
|
362
364
|
return;
|
|
363
365
|
const cleared = new Set(shrink.transmissions);
|
|
364
366
|
for (const [k, v] of [...state]) {
|
|
365
|
-
if (v.
|
|
367
|
+
if (v.witnesses === undefined)
|
|
368
|
+
continue;
|
|
369
|
+
const left = v.witnesses.filter((w) => !cleared.has(w));
|
|
370
|
+
if (left.length === v.witnesses.length)
|
|
371
|
+
continue;
|
|
372
|
+
if (left.length === 0)
|
|
366
373
|
state.delete(k);
|
|
374
|
+
else
|
|
375
|
+
state.set(k, { ...v, witnesses: left });
|
|
367
376
|
}
|
|
368
377
|
return;
|
|
369
378
|
}
|
|
370
379
|
const surviving = readFileStateAfterSummary(state, shrink.preserveKeys ?? []);
|
|
371
|
-
for (const k of [...state.keys()])
|
|
372
|
-
|
|
380
|
+
for (const k of [...state.keys()]) {
|
|
381
|
+
const kept = surviving.get(k);
|
|
382
|
+
if (kept === undefined)
|
|
373
383
|
state.delete(k);
|
|
384
|
+
else if (kept !== state.get(k))
|
|
385
|
+
state.set(k, kept);
|
|
386
|
+
}
|
|
374
387
|
}
|
|
375
388
|
export async function enoentMessage(env, key, cwd, signal, readDeny) {
|
|
376
389
|
let msg = `File does not exist. Note: your current working directory is ${cwd}.`;
|
|
@@ -4,6 +4,7 @@ import { type ReadFileState } from "./safety.js";
|
|
|
4
4
|
import type { ContainmentFace } from "./containment-face.js";
|
|
5
5
|
import { type WriteDenyMatcher } from "./read-deny.js";
|
|
6
6
|
import { type CwdRef } from "./fs-shared.js";
|
|
7
|
+
import type { ToolResultStore } from "../../core/tool-result-store.js";
|
|
7
8
|
/**
|
|
8
9
|
* The `beforeWrite` CONTENT hook, mounted here rather than in ToolPolicy because only this band sees
|
|
9
10
|
* the FINAL text an Edit/NotebookEdit produces — the applied old→new full text is what actually lands
|
|
@@ -19,6 +20,18 @@ export type { BeforeWriteRequest, BeforeWriteResult, BeforeWriteHook, TrackEditR
|
|
|
19
20
|
export type WriteRootSeat = string | (() => string);
|
|
20
21
|
export declare function createEditFileTool(env: ExecutionEnv, state: ReadFileState, rootCanonical: WriteRootSeat, cwdRef?: CwdRef, additionalRoots?: readonly string[], beforeWrite?: BeforeWriteHook, trackEdit?: TrackFileEditHook, onEdited?: FileEditedHook, writeFace?: () => ContainmentFace, writeDeny?: WriteDenyMatcher): AgentTool;
|
|
21
22
|
export declare function createWriteFileTool(env: ExecutionEnv, state: ReadFileState, rootCanonical: WriteRootSeat, cwdRef?: CwdRef, additionalRoots?: readonly string[], beforeWrite?: BeforeWriteHook, trackEdit?: TrackFileEditHook, onEdited?: FileEditedHook, writeFace?: () => ContainmentFace, writeDeny?: WriteDenyMatcher): AgentTool;
|
|
23
|
+
/** The reads SaveToolResult makes of the run's tool-result store: the one way a ref is read (text first, then bytes). */
|
|
24
|
+
export type KeptBytesReader = Pick<ToolResultStore, "get" | "bytesOf">;
|
|
25
|
+
/**
|
|
26
|
+
* SaveToolResult — writes the bytes a tool result kept in the run's tool-result store (the ref its line named) into a NEW file.
|
|
27
|
+
* The lane is Edit's create lane step for step: the path resolved and confined as every write tool's (`resolveKey`), an existing
|
|
28
|
+
* path refused, the write gate over the bytes themselves (`beforeWrite`), the first-touch history ("did not exist"), and the
|
|
29
|
+
* final write exclusive where the environment can make it so — a lost create race answers `already_exists`, a moved target
|
|
30
|
+
* `precondition_failed`, each in its own sentence; an environment with neither atomic seam keeps Edit's two-step create (the
|
|
31
|
+
* same accepted residue). The ref is read the way every reader reads one: a ref holding text is refused (it is ReadToolResult's),
|
|
32
|
+
* and one holding neither is the honest miss.
|
|
33
|
+
*/
|
|
34
|
+
export declare function createSaveToolResultTool(env: ExecutionEnv, store: KeptBytesReader, rootCanonical: WriteRootSeat, cwdRef?: CwdRef, additionalRoots?: readonly string[], beforeWrite?: BeforeWriteHook, trackEdit?: TrackFileEditHook, onEdited?: FileEditedHook, writeFace?: () => ContainmentFace, writeDeny?: WriteDenyMatcher): AgentTool;
|
|
22
35
|
/**
|
|
23
36
|
* design v1.163 — NotebookEdit: replace/insert/delete a single cell in a .ipynb. CC-parity tool over the SAME hand-band
|
|
24
37
|
* safety skeleton as Edit/Write (resolveKey containment → requireRead read-before-edit → checkStale content-hash
|
|
@@ -5,8 +5,10 @@ import { sha256, resolveKey, violationText, violationDetails, requireRead, check
|
|
|
5
5
|
import { decodeTextBytes, encodeTextForFile, normalizeEditText, normalizeFileText } from "./encoding.js";
|
|
6
6
|
import { seatForCall } from "./read-deny.js";
|
|
7
7
|
import { MAX_EDIT_BYTES, decodeEditBytes, tooLargeToEditMessage, malformedBodyMessage, persistedTextOf, notReadRefusalText, enoentMessage, FILE_STATE_TRAILER, FILE_PATH_PARAMS, coerceWriteArguments, ipynbRedirect, countLines, applyRecordedEdit, } from "./fs-shared.js";
|
|
8
|
+
import { envErrorDetail } from "./env-error-detail.js";
|
|
8
9
|
import { toolFace } from "../../core/tool-catalog-entries.js";
|
|
9
10
|
import { fileArgPath } from "../../core/tool-registry.js";
|
|
11
|
+
import { SAVE_TOOL_RESULT_NAME } from "../../core/tool-result-bytes.js";
|
|
10
12
|
import { thrownText } from "../../core/thrown-value.js";
|
|
11
13
|
async function envFinalWrite(env, key, content, signal, opts) {
|
|
12
14
|
const fireEdited = () => {
|
|
@@ -162,7 +164,7 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
|
|
|
162
164
|
const singleOld = batch ? undefined : a.old_string;
|
|
163
165
|
const exists = await env.exists(r.key, ctx.signal);
|
|
164
166
|
if (!exists.ok)
|
|
165
|
-
return errorResult(`Error (Edit): cannot stat "${path}": ${exists.error.message}`);
|
|
167
|
+
return errorResult(`Error (Edit): cannot stat "${path}": ${envErrorDetail(exists.error.message)}`);
|
|
166
168
|
if (!exists.value) {
|
|
167
169
|
if (singleOld === "") {
|
|
168
170
|
const created = a.new_string ?? "";
|
|
@@ -180,9 +182,9 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
|
|
|
180
182
|
return errorResult(`Error (Edit): cannot create "${path}": file already exists (created concurrently since the existence check). Read the file first, then edit it normally (or Write after the Read to overwrite it).`);
|
|
181
183
|
}
|
|
182
184
|
if (write.error.code === "precondition_failed") {
|
|
183
|
-
return errorResult(`Error (Edit): cannot create "${path.slice(0, 512)}": the atomic write refused its precondition (${write.error.message
|
|
185
|
+
return errorResult(`Error (Edit): cannot create "${path.slice(0, 512)}": the atomic write refused its precondition (${envErrorDetail(write.error.message)}) — the on-disk state at that path changed between the existence check and the write (something may now exist there, or the path may now resolve somewhere else, e.g. through a symlink). Nothing was written. Read the path to see what is actually there before acting on it.`);
|
|
184
186
|
}
|
|
185
|
-
return errorResult(`Error (Edit): cannot write "${path}": ${write.error.message}`);
|
|
187
|
+
return errorResult(`Error (Edit): cannot write "${path}": ${envErrorDetail(write.error.message)}`);
|
|
186
188
|
}
|
|
187
189
|
const createdNorm = normalizeFileText(created);
|
|
188
190
|
state.set(r.key, { hash: sha256(createdNorm), totalLines: countLines(createdNorm), truncated: false, lastReadAt: Date.now() });
|
|
@@ -200,7 +202,7 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
|
|
|
200
202
|
if (singleOld === "") {
|
|
201
203
|
const preBin = await env.readBinaryFile(r.key, ctx.signal);
|
|
202
204
|
if (!preBin.ok)
|
|
203
|
-
return errorResult(`Error (Edit): cannot read "${path}": ${preBin.error.message}`);
|
|
205
|
+
return errorResult(`Error (Edit): cannot read "${path}": ${envErrorDetail(preBin.error.message)}`);
|
|
204
206
|
if (preBin.value.byteLength > MAX_EDIT_BYTES) {
|
|
205
207
|
return errorResult(tooLargeToEditMessage(path, preBin.value.byteLength));
|
|
206
208
|
}
|
|
@@ -230,7 +232,7 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
|
|
|
230
232
|
const encodedOverwrite = encodeTextForFile(newContent, preDec.encoding, preDec.endings);
|
|
231
233
|
const write = await envFinalWrite(env, r.key, encodedOverwrite, ctx.signal, { track: trackedOverwrite, edited: { hook: onEdited, tool: "Edit", path } });
|
|
232
234
|
if (!write.ok)
|
|
233
|
-
return errorResult(`Error (Edit): cannot write "${path}": ${write.error.message}`);
|
|
235
|
+
return errorResult(`Error (Edit): cannot write "${path}": ${envErrorDetail(write.error.message)}`);
|
|
234
236
|
const persistedOverwrite = persistedTextOf(encodedOverwrite);
|
|
235
237
|
state.set(r.key, { hash: sha256(persistedOverwrite), totalLines: countLines(persistedOverwrite), truncated: false, lastReadAt: Date.now() });
|
|
236
238
|
return {
|
|
@@ -246,7 +248,7 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
|
|
|
246
248
|
return errorResult(await notReadRefusalText(env, "Edit", r.key, notRead, ctx.signal, READ_REFUSED_ESCAPE_HINT));
|
|
247
249
|
const readBin = await env.readBinaryFile(r.key, ctx.signal);
|
|
248
250
|
if (!readBin.ok)
|
|
249
|
-
return errorResult(`Error (Edit): cannot read "${path}": ${readBin.error.message}`);
|
|
251
|
+
return errorResult(`Error (Edit): cannot read "${path}": ${envErrorDetail(readBin.error.message)}`);
|
|
250
252
|
if (readBin.value.byteLength > MAX_EDIT_BYTES) {
|
|
251
253
|
return errorResult(tooLargeToEditMessage(path, readBin.value.byteLength));
|
|
252
254
|
}
|
|
@@ -307,7 +309,7 @@ export function createEditFileTool(env, state, rootCanonical, cwdRef, additional
|
|
|
307
309
|
const encodedEdit = encodeTextForFile(working, decoded.encoding, decoded.endings);
|
|
308
310
|
const write = await envFinalWrite(env, r.key, encodedEdit, ctx.signal, { track: trackedEdit, edited: { hook: onEdited, tool: "Edit", path } });
|
|
309
311
|
if (!write.ok)
|
|
310
|
-
return errorResult(`Error (Edit): cannot write "${path}": ${write.error.message}`);
|
|
312
|
+
return errorResult(`Error (Edit): cannot write "${path}": ${envErrorDetail(write.error.message)}`);
|
|
311
313
|
const persistedEdit = persistedTextOf(encodedEdit);
|
|
312
314
|
state.set(r.key, { hash: sha256(persistedEdit), totalLines: countLines(persistedEdit), truncated: false, lastReadAt: Date.now() });
|
|
313
315
|
const a0 = appliedEdits[0];
|
|
@@ -371,7 +373,7 @@ export function createWriteFileTool(env, state, rootCanonical, cwdRef, additiona
|
|
|
371
373
|
return errorResult(violationText("Write", r.violation), violationDetails(r.violation));
|
|
372
374
|
const exists = await env.exists(r.key, ctx.signal);
|
|
373
375
|
if (!exists.ok)
|
|
374
|
-
return errorResult(`Error (Write): cannot stat "${path}": ${exists.error.message}`);
|
|
376
|
+
return errorResult(`Error (Write): cannot stat "${path}": ${envErrorDetail(exists.error.message)}`);
|
|
375
377
|
let originalFile;
|
|
376
378
|
if (exists.value) {
|
|
377
379
|
const notRead = requireRead(state, r.key);
|
|
@@ -380,7 +382,7 @@ export function createWriteFileTool(env, state, rootCanonical, cwdRef, additiona
|
|
|
380
382
|
}
|
|
381
383
|
const readBin = await env.readBinaryFile(r.key, ctx.signal);
|
|
382
384
|
if (!readBin.ok)
|
|
383
|
-
return errorResult(`Error (Write): cannot re-read "${path}" to verify it is unchanged: ${readBin.error.message}`);
|
|
385
|
+
return errorResult(`Error (Write): cannot re-read "${path}" to verify it is unchanged: ${envErrorDetail(readBin.error.message)}`);
|
|
384
386
|
const decodedPrev = decodeTextBytes(readBin.value);
|
|
385
387
|
if (decodedPrev.malformed)
|
|
386
388
|
return errorResult(malformedBodyMessage("Write", path, decodedPrev.malformed));
|
|
@@ -397,7 +399,7 @@ export function createWriteFileTool(env, state, rootCanonical, cwdRef, additiona
|
|
|
397
399
|
const encodedWrite = encodeTextForFile(content, decodedPrev.encoding, "preserve");
|
|
398
400
|
const write = await envFinalWrite(env, r.key, encodedWrite, ctx.signal, { track: trackedWrite, edited: { hook: onEdited, tool: "Write", path } });
|
|
399
401
|
if (!write.ok)
|
|
400
|
-
return errorResult(`Error (Write): cannot write "${path}": ${write.error.message}`);
|
|
402
|
+
return errorResult(`Error (Write): cannot write "${path}": ${envErrorDetail(write.error.message)}`);
|
|
401
403
|
const persistedWrite = persistedTextOf(encodedWrite);
|
|
402
404
|
state.set(r.key, { hash: sha256(persistedWrite), totalLines: countLines(persistedWrite), truncated: false, lastReadAt: Date.now() });
|
|
403
405
|
return {
|
|
@@ -413,7 +415,7 @@ export function createWriteFileTool(env, state, rootCanonical, cwdRef, additiona
|
|
|
413
415
|
return errorResult(trackedCreate.refusal);
|
|
414
416
|
const write = await envFinalWrite(env, r.key, content, ctx.signal, { track: trackedCreate, edited: { hook: onEdited, tool: "Write", path } });
|
|
415
417
|
if (!write.ok)
|
|
416
|
-
return errorResult(`Error (Write): cannot write "${path}": ${write.error.message}`);
|
|
418
|
+
return errorResult(`Error (Write): cannot write "${path}": ${envErrorDetail(write.error.message)}`);
|
|
417
419
|
const totalLines = countLines(content);
|
|
418
420
|
state.set(r.key, { hash: sha256(normalizeFileText(content)), totalLines, truncated: false, lastReadAt: Date.now() });
|
|
419
421
|
void originalFile;
|
|
@@ -426,6 +428,60 @@ export function createWriteFileTool(env, state, rootCanonical, cwdRef, additiona
|
|
|
426
428
|
write.prepareArguments = coerceWriteArguments;
|
|
427
429
|
return write;
|
|
428
430
|
}
|
|
431
|
+
export function createSaveToolResultTool(env, store, rootCanonical, cwdRef, additionalRoots, beforeWrite, trackEdit, onEdited, writeFace, writeDeny) {
|
|
432
|
+
return defineTool({
|
|
433
|
+
name: SAVE_TOOL_RESULT_NAME,
|
|
434
|
+
...toolFace("save-tool-result"),
|
|
435
|
+
description: "Writes the binary content a tool result kept (its line names a ref) into a new file.\n" +
|
|
436
|
+
"\n" +
|
|
437
|
+
"- `ref` is the ref the tool result named; `file_path` is where to write it.\n" +
|
|
438
|
+
"- The path must not exist yet: this tool creates files, it never overwrites one.",
|
|
439
|
+
parameters: Type.Object({
|
|
440
|
+
ref: Type.String({ description: "The ref the tool result named for its kept bytes." }),
|
|
441
|
+
...FILE_PATH_PARAMS,
|
|
442
|
+
}),
|
|
443
|
+
execute: async (args, ctx) => {
|
|
444
|
+
const ref = args.ref;
|
|
445
|
+
if (typeof ref !== "string" || ref === "")
|
|
446
|
+
return errorResult(`Error (SaveToolResult): ref is required.`);
|
|
447
|
+
const path = fileArgPath(args);
|
|
448
|
+
if (path === undefined)
|
|
449
|
+
return errorResult(`Error (SaveToolResult): file_path is required.`);
|
|
450
|
+
const r = await resolveKey(env, rootOf(rootCanonical), path, ctx.signal, cwdRef?.current, additionalRoots, undefined, seatForCall(writeDeny, ctx.toolCallId), writeFace?.());
|
|
451
|
+
if (!r.ok)
|
|
452
|
+
return errorResult(violationText(SAVE_TOOL_RESULT_NAME, r.violation), violationDetails(r.violation));
|
|
453
|
+
if ((await store.get(ref, { limit: 0 })) !== undefined) {
|
|
454
|
+
return errorResult(`Error (SaveToolResult): ref "${ref.slice(0, 600)}" holds text, not kept bytes — read it with ReadToolResult.`);
|
|
455
|
+
}
|
|
456
|
+
const kept = await store.bytesOf?.(ref);
|
|
457
|
+
if (kept === undefined)
|
|
458
|
+
return errorResult(`No kept bytes for ref "${ref.slice(0, 600)}" — they may have expired, or this run's tool-result store does not hold them. Nothing was written.`);
|
|
459
|
+
const exists = await env.exists(r.key, ctx.signal);
|
|
460
|
+
if (!exists.ok)
|
|
461
|
+
return errorResult(`Error (SaveToolResult): cannot stat "${path.slice(0, 512)}": ${envErrorDetail(exists.error.message)}`);
|
|
462
|
+
if (exists.value)
|
|
463
|
+
return errorResult(`Error (SaveToolResult): "${path.slice(0, 512)}" already exists — this tool only creates new files; choose a path that does not exist. Nothing was written.`);
|
|
464
|
+
const bytes = await kept.bytes();
|
|
465
|
+
const gated = await gateToolWrite(beforeWrite, SAVE_TOOL_RESULT_NAME, path, r.key, bytes);
|
|
466
|
+
if (gated !== undefined)
|
|
467
|
+
return errorResult(gated);
|
|
468
|
+
const tracked = await trackToolEdit(trackEdit, SAVE_TOOL_RESULT_NAME, path, r.key, ctx.signal);
|
|
469
|
+
if (tracked.refusal !== undefined)
|
|
470
|
+
return errorResult(tracked.refusal);
|
|
471
|
+
const write = await envFinalWrite(env, r.key, bytes, ctx.signal, { exclusive: true, track: tracked, edited: { hook: onEdited, tool: SAVE_TOOL_RESULT_NAME, path } });
|
|
472
|
+
if (!write.ok) {
|
|
473
|
+
if (write.error.code === "already_exists") {
|
|
474
|
+
return errorResult(`Error (SaveToolResult): cannot create "${path.slice(0, 512)}": file already exists (created concurrently since the existence check). Nothing was written; choose another path.`);
|
|
475
|
+
}
|
|
476
|
+
if (write.error.code === "precondition_failed") {
|
|
477
|
+
return errorResult(`Error (SaveToolResult): cannot create "${path.slice(0, 512)}": the atomic write refused its precondition (${envErrorDetail(write.error.message)}) — the on-disk state at that path changed between the existence check and the write. Nothing was written.`);
|
|
478
|
+
}
|
|
479
|
+
return errorResult(`Error (SaveToolResult): cannot write "${path.slice(0, 512)}": ${envErrorDetail(write.error.message)}`);
|
|
480
|
+
}
|
|
481
|
+
return `Wrote ${bytes.byteLength} bytes${kept.mediaType !== undefined ? ` (${kept.mediaType})` : ""} from ref "${ref}" to ${path}.`;
|
|
482
|
+
},
|
|
483
|
+
});
|
|
484
|
+
}
|
|
429
485
|
const notebookNotIpynbMessage = (notebookPath) => `Error (NotebookEdit): "${notebookPath}" is not a .ipynb file; use Edit for other file types.`;
|
|
430
486
|
const NOTEBOOK_CELL_TYPE_REQUIRED_MESSAGE = `Error (NotebookEdit): Cell type is required when using edit_mode=insert.`;
|
|
431
487
|
const NOTEBOOK_CELL_ID_REQUIRED_MESSAGE = `Error (NotebookEdit): cell_id is required for replace/delete.`;
|
|
@@ -491,7 +547,7 @@ export function createNotebookEditTool(env, state, rootCanonical, cwdRef, additi
|
|
|
491
547
|
return errorResult(await notReadRefusalText(env, "NotebookEdit", r.key, notRead, ctx.signal, READ_REFUSED_ESCAPE_HINT));
|
|
492
548
|
const readBin = await env.readBinaryFile(r.key, ctx.signal);
|
|
493
549
|
if (!readBin.ok)
|
|
494
|
-
return errorResult(`Error (NotebookEdit): cannot read "${notebook_path}": ${readBin.error.message}`);
|
|
550
|
+
return errorResult(`Error (NotebookEdit): cannot read "${notebook_path}": ${envErrorDetail(readBin.error.message)}`);
|
|
495
551
|
const decodedNb = decodeTextBytes(readBin.value);
|
|
496
552
|
if (decodedNb.malformed)
|
|
497
553
|
return errorResult(malformedBodyMessage("NotebookEdit", notebook_path, decodedNb.malformed));
|
|
@@ -568,7 +624,7 @@ export function createNotebookEditTool(env, state, rootCanonical, cwdRef, additi
|
|
|
568
624
|
return errorResult(trackedNb.refusal);
|
|
569
625
|
const w = await envFinalWrite(env, r.key, encodeTextForFile(updated, decodedNb.encoding, decodedNb.endings), ctx.signal, { track: trackedNb, edited: { hook: onEdited, tool: "NotebookEdit", path: notebook_path } });
|
|
570
626
|
if (!w.ok)
|
|
571
|
-
return errorResult(`Error (NotebookEdit): cannot write "${notebook_path}": ${w.error.message}`);
|
|
627
|
+
return errorResult(`Error (NotebookEdit): cannot write "${notebook_path}": ${envErrorDetail(w.error.message)}`);
|
|
572
628
|
state.set(r.key, { hash: sha256(updated), totalLines: countLines(updated), truncated: false, lastReadAt: Date.now() });
|
|
573
629
|
const nbDetails = {
|
|
574
630
|
type: "notebook-edit",
|
package/dist/tools/fs/index.d.ts
CHANGED
|
@@ -13,11 +13,14 @@ export * from "./fs-bash.js";
|
|
|
13
13
|
export * from "./read-deny.js";
|
|
14
14
|
export { readDenyHomesOf } from "./read-deny-home.js";
|
|
15
15
|
import type { ShellReadAdmission } from "./shell-read-check.js";
|
|
16
|
+
import type { CommandSandboxSeat } from "../../core/command-sandbox.js";
|
|
16
17
|
export { BASH_CLASSIFY_EXTRA_ALLOW, bashClassifyDefaultAllow } from "./bash-readonly-classifier.js";
|
|
17
18
|
import { type ReadDenyEntry } from "./read-deny.js";
|
|
18
19
|
import { type ContainmentFace } from "./containment-face.js";
|
|
19
20
|
export * from "./containment-face.js";
|
|
20
21
|
import { type CwdRef } from "./fs-shared.js";
|
|
22
|
+
import { type KeptBytesReader } from "./fs-write.js";
|
|
23
|
+
import type { ContextRoomSeat } from "../../core/runner/context-room.js";
|
|
21
24
|
/** Options for {@link createHandsToolkit}. */
|
|
22
25
|
export interface HandsToolkitOptions {
|
|
23
26
|
/** CC --add-dir parity: extra allowed containment roots (canonical). Widens file-tool containment
|
|
@@ -59,10 +62,18 @@ export interface HandsToolkitOptions {
|
|
|
59
62
|
* consumer mounting the read-only band outside the Runner must run `runToolGate` with a station of its own
|
|
60
63
|
* (`createShellReadStation`). */
|
|
61
64
|
shellReadAdmission?: ShellReadAdmission;
|
|
65
|
+
/** The run's command sandbox seat (`command-sandbox.ts`), for both shell faces: every command they start hands its call's
|
|
66
|
+
* sandbox instruction to the environment, or is refused. ABSENT ⇒ the starts carry no sandbox (a run that requires none, a
|
|
67
|
+
* library-direct toolkit). */
|
|
68
|
+
commandSandbox?: CommandSandboxSeat;
|
|
62
69
|
/** The gate's file read station's ADMISSION (`FileReadStation.admitted`, file-read-check.ts), handed to Read / Grep /
|
|
63
70
|
* Glob / RepoMap: an out-of-root target the gate put to a question and then let through is read once, on the canonical key the
|
|
64
71
|
* station judged. ABSENT ⇒ no station (a library-direct toolkit): the tools refuse every out-of-root target. */
|
|
65
72
|
readAdmission?: (toolCallId: string | undefined, canonicalKey: string) => boolean;
|
|
73
|
+
/** The leg's context-room seat, handed to the file reader: Read's `allow_large` raises a text read's limits to the room
|
|
74
|
+
* measured for its call. ABSENT ⇒ no room is measured (a library-direct toolkit): a call that sets the key is told it is not
|
|
75
|
+
* available when it is over the limits. */
|
|
76
|
+
contextRoom?: ContextRoomSeat;
|
|
66
77
|
/** Commit-message attribution trailer for the `bash` git protocol. Default NONE — attribution is a
|
|
67
78
|
* deployment identity asset, so the branded deployment sets it; pass `"Name <email>"` to advertise
|
|
68
79
|
* one, `false` (≡ unset) for no trailer section. */
|
|
@@ -131,6 +142,10 @@ export interface HandsToolkitOptions {
|
|
|
131
142
|
* of the same name. Runner-wired (reads the harness's own accepted-but-unserved account); absent ⇒ the
|
|
132
143
|
* shell never auto-backgrounds a running command, exactly as before. */
|
|
133
144
|
queuedHumanInput?: () => boolean;
|
|
145
|
+
/** Does the cut now aborting a call's turn move an armed running command into the background — see createBashTool's
|
|
146
|
+
* taskOpts field of the same name. Runner-wired on a top-level leg (reads the harness's row for the cut's source); absent
|
|
147
|
+
* ⇒ every cut ends the running command, exactly as before. */
|
|
148
|
+
turnCutMovesCommandAside?: (signal: AbortSignal) => boolean;
|
|
134
149
|
/** The run's image processor seat (`RunnerDeps.imageProcessor`), for every image this band hands the model (Read, a
|
|
135
150
|
* rendered PDF page, a Bash data URI): a processor; `false` = none (deterministic no-sharp behavior); undefined =
|
|
136
151
|
* auto-detect the optional sharp dependency once per process. */
|
|
@@ -154,6 +169,9 @@ export interface HandsToolkitOptions {
|
|
|
154
169
|
* Purely additive: it cannot refuse a write, and a fault in it is contained in both shapes (a
|
|
155
170
|
* synchronous throw and a rejected promise), neither of them awaited. */
|
|
156
171
|
onFileEdited?: FileEditedHook;
|
|
172
|
+
/** The run's tool-result store, when it keeps bytes (its byte arm): the write half then mounts SaveToolResult beside Write, under
|
|
173
|
+
* the same gate, history and edited seats. Absent, or a store without `bytesOf` ⇒ no SaveToolResult. */
|
|
174
|
+
toolResultBytes?: KeptBytesReader;
|
|
157
175
|
/** See createBashTool's taskOpts field of the same name: whether the Monitor tool is on this run's
|
|
158
176
|
* roster (the Runner mounts Monitor, this band never does). `false` drops the gh rate-limit hint's
|
|
159
177
|
* Monitor clause; absent ⇒ the full wording. */
|
|
@@ -275,7 +293,7 @@ export declare function backgroundOutputReadExemption(registry: TaskRegistry | u
|
|
|
275
293
|
readonly sessionId?: string;
|
|
276
294
|
}, env: ExecutionEnv): ((canonicalKey: string, c?: {
|
|
277
295
|
taskId?: string;
|
|
278
|
-
|
|
296
|
+
isolationScope?: string;
|
|
279
297
|
}) => boolean) | undefined;
|
|
280
298
|
/**
|
|
281
299
|
* Build the per-task hand tool band over an injected env + fresh per-task read state.
|