@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
|
@@ -73,6 +73,20 @@ export interface EngineNotice {
|
|
|
73
73
|
* answered `{ refuse }` on `plugin.register`, or failed while judging it (fail-closed). The run goes on without it.
|
|
74
74
|
* Audience `user` (the seat is in `detail`). Once per refused registration per run. `detail: { name, seat, tier,
|
|
75
75
|
* provenance?, refusedBy, reason, sessionId }` (`seat` ∈ `deployment` / `task`; `provenance` as the host gave it, absent when none).
|
|
76
|
+
* - `"mods.display_withheld"` — an answer for a window of an assistant message's display did not stand: its `classic.MessageDisplay`
|
|
77
|
+
* handler threw, answered a form the station cannot take, or the window was not answered within its own 10 s (counted from when
|
|
78
|
+
* its text settled, a dispatch slot's wait included). The handler is skipped (the ones below it answer in its place) and the window
|
|
79
|
+
* shows what the answers that stood left of it (a deadline skips every handler not yet answered) — the model's text when none did; the stored message and the model's view are
|
|
80
|
+
* unchanged. Audience `user`. Once per failing handler per window, said when the window is released. `detail: { messageId, turn, index, final, cause, registration?,
|
|
81
|
+
* sessionId }` (`cause` ∈ `threw` / `timeout` / `violation` / `reentry` / `deadline` / `fault`; `registration` names the failing
|
|
82
|
+
* extension, absent on `deadline` (the window's time ran out) and on `fault` (the engine's own failure to raise it)). A caller's stop says nothing.
|
|
83
|
+
* - `"mods.stop_ended"` — a `classic.Stop` / `classic.SubagentStop` answer carrying `end` closed the stop point: the run was not pushed
|
|
84
|
+
* back there (the answer's `block` and contexts, and the other seat's, were not fed to the model; the model is not told). It closes
|
|
85
|
+
* that stop point only — a one-shot submission still waits for what its lane is owed, and a later stop point asks again. Audience
|
|
86
|
+
* `user`. Once per stop point it closed. `detail: { event, registration, seat, reason?, sessionId, sourceSessionId?, agentId?, runId }`
|
|
87
|
+
* (`event` ∈ `classic.Stop` / `classic.SubagentStop`; `registration` the extension whose handler's answer carried `end` — an answer no
|
|
88
|
+
* registration produced carries none; `seat` ∈ `deployment` / `task`; `reason` the `end` text, bounded, absent when blank; the address
|
|
89
|
+
* keys are the leg notice's: a delegated leg's notice goes to its tree's root session and names the leg). A cancelled run says nothing.
|
|
76
90
|
* - `"skills.listing_truncated"` — the `<skills>` disclosure block did not fit its byte budget, so
|
|
77
91
|
* at least one skill is listed without its description (`nameOnly`) or, in the pathological case,
|
|
78
92
|
* not listed at all (`dropped`); the `Skill` tool still serves every one of them. Audience
|
|
@@ -99,10 +113,18 @@ export interface EngineNotice {
|
|
|
99
113
|
* an MCP server, a host tool, an engine tool or a `tool_result` hook's replacement) whose bytes the tool-result
|
|
100
114
|
* seat's admission refused: not a base64 payload, a media type outside the closed set, over the cap, bytes
|
|
101
115
|
* without the claimed type's signature, or bytes no processor could bring within the reject edge (or whose header
|
|
102
|
-
* states no size). Each such block already stands in the result as a text placeholder naming
|
|
103
|
-
*
|
|
104
|
-
*
|
|
105
|
-
*
|
|
116
|
+
* states no size). Each such block already stands in the result as a text placeholder naming the tool and the refusal
|
|
117
|
+
* (never the bytes), so the model, `tool_end.output` and the transcript read that; this is the operator's account. A
|
|
118
|
+
* block refused for its SIZE (`raw_too_large`, `dimensions_too_large`, `base64_too_large`) has its bytes kept in the
|
|
119
|
+
* run's tool-result store and its placeholder names the `ref`, or why they were not kept (`notKept`: `no_byte_store` |
|
|
120
|
+
* `over_limit` | `store_failed`; the store's error text in `saveError`, this account only). ONCE PER CALL.
|
|
121
|
+
* `detail: { toolName, toolCallId, refused: [{ type, reason, bytes, limit?, width?, height?, mimeType?, ref?, notKept?,
|
|
122
|
+
* saveError? }], sessionId, runId }` — closed-set words, counts, a media type only when it can be one (≤ 100 characters).
|
|
123
|
+
* - `"tool_result.media_persisted"` — an MCP tool call or resource read whose server sent binary content that is not
|
|
124
|
+
* media the model reads (an audio block, a resource blob of a type outside the admission's image and document sets):
|
|
125
|
+
* its bytes were kept in the run's tool-result store and the result carries a line naming each one's ref in place of
|
|
126
|
+
* the bytes (or why it was not kept). ONCE PER CALL (or read). `detail: { server, toolName, toolCallId, kept: [{ bytes,
|
|
127
|
+
* mimeType?, ref | notKept (+ saveError) }], sessionId, runId }`.
|
|
106
128
|
* - `"config.image_processor_unavailable"` — an image went to the model as it was, over the image admission's soft
|
|
107
129
|
* target (`IMAGE_ADMISSION.soft.targetBytes`), because the run has no image processor (`RunnerDeps.imageProcessor`
|
|
108
130
|
* is `false`, or sharp did not resolve). ONCE PER RUN, at the first such image wherever it entered (a tool's result,
|
|
@@ -129,6 +151,21 @@ export interface EngineNotice {
|
|
|
129
151
|
* above the break and its side branches). Counts and entry ids only, never a record's words. ONCE PER PREPARED LEG for a whole branch,
|
|
130
152
|
* once per break for a broken one (and then the whole-branch form is not said), at the first read that met it — said when the acquire
|
|
131
153
|
* has settled on the attempt that holds, so an attempt that lost a write race and was run again is not described.
|
|
154
|
+
* - `"rewind.boundary_unrecorded"` — the file-history boundary of this turn was not recorded (the store answered a failure, or the
|
|
155
|
+
* capture did not finish within its 30 s fence): the turn goes on, and a rewind to its entry will refuse
|
|
156
|
+
* `rewind_snapshot.unresolvable`. Minted by the boundary seat where it hands the same failure to `onError` (`{ phase: "rewind" }`,
|
|
157
|
+
* the operator's half), so the two are one fact. Audience `user`. `detail: { sessionId, entryId, cause }` — `entryId` is the row
|
|
158
|
+
* of the person's input the boundary was for, `cause` the store's code (`FILE_HISTORY_ERROR_CODES`; `aborted` for the fence); never
|
|
159
|
+
* the store's message, never a path. ONCE PER FAILED CAPTURE, at most once per run.
|
|
160
|
+
* - `"verify.verifier_is_implementer"` (`src/agents/verifier-independence.ts`) — the verification gate's verifier leg answered on the
|
|
161
|
+
* SAME resolved model id as the implementation leg it judged (`TaskResult.model` of the two: an unset `verifier` role falling back to
|
|
162
|
+
* the main model, a tier default that names the same entry, or a `verifierModel` that is the implementer's own), so the verdict is a
|
|
163
|
+
* model grading its own work and the outcome says `VerificationOutcome.independent: false`. The verification runs and its verdict
|
|
164
|
+
* stands — the notice and that bit are the disclosure. Said only when BOTH ids are known (a result that carries no `model` reads as
|
|
165
|
+
* "cannot say", not as independent); a mid-run degradation is not read (the compared ids are the engine-selected ones). ONCE PER GATE
|
|
166
|
+
* RUN, at the first verifier leg that read so. Audience `user`; `detail: { model, verifierSeat, sessionId? }` — `model` the
|
|
167
|
+
* shared id (bounded at 80), `verifierSeat` is `verifierModel` (the call named it) or `roles.verifier` (the role resolved it);
|
|
168
|
+
* `sessionId` (also lifted to the top level) is the implementation's session, absent when the result carries none.
|
|
132
169
|
* - `"workflow.governance_key_stripped"` (#235) — the fields of an LLM-authored workflow `agent(spec)`
|
|
133
170
|
* that did NOT cross the governed default-deny whitelist: an unrecognized/control-plane field, or a
|
|
134
171
|
* `readFace` value that is not the containment-tightening one. The spawn PROCEEDS on the deployment
|
|
@@ -172,16 +209,16 @@ export interface EngineNotice {
|
|
|
172
209
|
* `writeScope` absent ⇔ a read-only layering. Minted at the DECLARATION rather than at the
|
|
173
210
|
* mount (the declaration is already the fact, and a mount that later fails must not swallow
|
|
174
211
|
* it). Dedup unit: once per prepared leg.
|
|
175
|
-
* - `"
|
|
176
|
-
*
|
|
177
|
-
*
|
|
212
|
+
* - `"protocol.revocation_probe_failed"` (design/338) — the `protocolRevocations.revoked` probe threw or answered a
|
|
213
|
+
* non-boolean; MCP and A2A requests FAIL OPEN (revocation tightens) and this announces once per prepared leg,
|
|
214
|
+
* whichever protocol asked first (a resume prepares again and may announce again).
|
|
178
215
|
* `detail: { message, runId }` — still no sessionId (a deployment wiring fact, not
|
|
179
|
-
* session-attributed); `runId` (#499) makes the once-per-
|
|
180
|
-
* attributing the line to a conversation, an opaque invocation id saying which
|
|
216
|
+
* session-attributed); `runId` (#499) makes the once-per-leg claim CHECKABLE without
|
|
217
|
+
* attributing the line to a conversation, an opaque invocation id saying which leg
|
|
181
218
|
* rather than whose. `"operator"` audience by
|
|
182
219
|
* its explicit {@link NOTICE_AUDIENCE} row (#433 made the registry total over the catalog —
|
|
183
220
|
* no engine-minted code is audience-defaulted any more). The refusal itself
|
|
184
|
-
* (`mcp.server_revoked`) is a tool RESULT code, not a notice.
|
|
221
|
+
* (`mcp.server_revoked` / `a2a.peer_revoked`) is a tool RESULT code, not a notice.
|
|
185
222
|
* - `"mcp.server_redialed"` — a host asked this run to RE-DIAL one MCP server (the run
|
|
186
223
|
* handle's `reconnectMcpServer` verb) and this is what came of it. `detail: { server, outcome,
|
|
187
224
|
* added, removed, reason?, sessionId, runId }` — `outcome` is the result's own three-word answer
|
|
@@ -205,6 +242,14 @@ export interface EngineNotice {
|
|
|
205
242
|
* authorize; `sessionId` REQUIRED at the mint. Dedup unit: once per (leg, server) — a resume is a new
|
|
206
243
|
* leg and may announce again. A deployment that waits for the authorization keys on this notice; the
|
|
207
244
|
* leg itself does not park on it.
|
|
245
|
+
* - `"mcp.server_unavailable"` — an MCP server the leg could not reach (it failed to connect or to list its tools) and so SKIPPED: the
|
|
246
|
+
* run goes on with the tools of the servers that did connect, and this server's are missing from it. The person's half of the SAME
|
|
247
|
+
* warning the operator reads on `onError` (`{ phase: "mcp" }`, code `mcp.server_unavailable`): derived at the Runner's drain of the
|
|
248
|
+
* materialization's warning lane from the warning object itself, so the two are one fact; the wiring manifest's `mcp` row and the
|
|
249
|
+
* materialization's `statuses` already read `failed` and are not touched. `detail: { server, sessionId, runId }` — `server` is the
|
|
250
|
+
* declared entry's name, never the failure's text, a URL, a command or a path. A server whose dial failed `unauthorized` is NOT told
|
|
251
|
+
* here — `mcp.authorization_required` is its notice. `"user"` audience; `sessionId` REQUIRED at the mint. Dedup unit: once per
|
|
252
|
+
* (leg, server) — a later leg whose dial fails again is a new fact; a consumer folding per session would hide a second server's.
|
|
208
253
|
* - `"mcp.credential_echoed"` — a protocol peer (an MCP server, an A2A peer) echoed a credential its
|
|
209
254
|
* connection's requests carried into what it said about itself: an MCP server's `serverInfo`, its
|
|
210
255
|
* instructions or its tool listing, an A2A peer's agent card. The engine reads that account through
|
|
@@ -412,9 +457,15 @@ export interface EngineNotice {
|
|
|
412
457
|
* refused at every prepare. Never minted for `default` (the main model's seat: an unknown word there is still refused,
|
|
413
458
|
* `config.unknown_role` / `unknown_model_ref`) nor `classifier` (its own stand-in and its own line, `classifier.role_defaulted`).
|
|
414
459
|
* Named once per SESSION per (seat, word), whether or not a read of this leg reaches the seat; root legs only. Audience
|
|
415
|
-
* `operator
|
|
460
|
+
* `user` (the default answers where the named model was meant to; the fix stays the operator's), always session-attributed; `detail: { seat, role, model, reason: "unknown_model_ref", fallback, sessionId, runId? }` — `seat` the
|
|
416
461
|
* `roles.<role>` the refusal would have named, `model` the word written there (bounded at 80), `fallback` the roles the seat's
|
|
417
462
|
* chain would reach, nearest first.
|
|
463
|
+
* - `"model.fallback"` (#3567; `src/core/runner/model-fallback-seat.ts`) — a model request walked its `Model.fallbacks`
|
|
464
|
+
* chain: a fallback model answered (`outcome: "served"`) or none could (`"exhausted"`, the request ending with the requested
|
|
465
|
+
* model's own failure). Read off the answer's marker where the run books each answer — the main loop (`lane: "main"`) and
|
|
466
|
+
* the side-call book (`compaction` / `classifier` / `mod` / `advisor`); a call outside a leg's book announces nothing.
|
|
467
|
+
* ONCE PER LEG PER (from, to, reason, outcome). Audience `user`; `detail: { from, to, reason, outcome, chain, lane,
|
|
468
|
+
* fromWindow?, toWindow?, sessionId, runId? }` — `chain` the hops tried after `from`, the windows the models' `contextWindow`.
|
|
418
469
|
* - `"context.tool_turn_repaired"` (#1224) — a provider request was built from a transcript that breaks the
|
|
419
470
|
* tool-turn law, and the request view restored it (`engine/llm/tool-turns.ts`; the transcript is never
|
|
420
471
|
* rewritten): a block after an assistant's tool calls moved ahead of them (`trailing_text`), a result recorded
|
|
@@ -448,6 +499,21 @@ export interface EngineNotice {
|
|
|
448
499
|
* refusal's record stands in sends it so (`engine/llm/rejected-images.ts`; MCP and A2A tools only, at most 8 per such
|
|
449
500
|
* transcript; a compaction that summarizes the record away returns the schema until the provider refuses it again).
|
|
450
501
|
* The model can still call the tool. Audience `user`; `detail: { tool, sessionId, runId }`. ONCE PER REFUSAL.
|
|
502
|
+
* - `"context.messages_omitted"` (#1822) — the request's guard trim, the last resort after compaction declined, failed
|
|
503
|
+
* or did not get the request under its guard, left the OLDEST messages out of what the model sees (the model reads
|
|
504
|
+
* a line saying earlier messages were omitted; the session keeps every message). Audience `user`;
|
|
505
|
+
* `detail: { omitted, sessionId, runId }`, `omitted` = how many messages that request left out. ONCE PER TRIMMED
|
|
506
|
+
* STRETCH: told on the first trimmed request a context hook handed on, silent while the requests after it stay
|
|
507
|
+
* trimmed, said again only after a request that fit (a provisional view the in-turn compaction replaced says
|
|
508
|
+
* nothing). A shell that renders a compaction failure as "the context was not shrunk" reads this code for that
|
|
509
|
+
* request: the context the model saw WAS shrunk, by omission.
|
|
510
|
+
* - `"instructions.withheld"` — an instruction file (today: of a directory the run accessed, the family
|
|
511
|
+
* `NESTED_MEMORY_LANE.declaration` names) was not loaded because the model could not Read it: none of it reached the model.
|
|
512
|
+
* Audience `user`; `detail: { path, reason, sessionId, runId }`, `reason` closed (`INSTRUCTIONS_WITHHELD_REASONS`:
|
|
513
|
+
* `rule_denied`, `outside_roots`, `approval_required`, `admission_unknown`, `target_moved`). ONCE PER SESSION per
|
|
514
|
+
* (path, reason), across runs; a delegated leg records it and says nothing. A file that exists but cannot be read
|
|
515
|
+
* (an I/O error, not text, past the read bound) is the operator's line instead (`onError` phase `degraded`,
|
|
516
|
+
* classification `attachment-read`), once per session per path.
|
|
451
517
|
* - `"task.tool_turn_incomplete"` (#1230) — the person's line for a tool turn the model was handed incomplete, beside
|
|
452
518
|
* the note the model itself reads. `detail.cause` (closed `TOOL_TURN_INCOMPLETE_CAUSES`): `truncated` — calls whose
|
|
453
519
|
* arguments were cut before they parsed, dropped (they did not run); `unnamed` — calls that arrived with no tool
|
|
@@ -517,11 +583,21 @@ export interface EngineNotice {
|
|
|
517
583
|
* `RunnerDeps.readDenyFloorRequired` turns it into (the prepare then fails with the same code); never minted for an
|
|
518
584
|
* empty table or an environment that keeps the floor (the Stub of a run without hands keeps it by refusing every
|
|
519
585
|
* start). Once per run — each delegated child on its own environment — and once per construction of a library-direct
|
|
520
|
-
* band that compiles its own table; `detail: { rowCount, sessionId?, runId? }`
|
|
586
|
+
* band that compiles its own table. Audience `user` (the session's own reads can reach a forbidden file's bytes; the way out stays the operator's); `detail: { rowCount, sessionId?, runId? }` — both ids on a run's notice, neither on a library-direct band's (no session).
|
|
521
587
|
* - `"config.read_floor_confinement_unavailable"` — a Node environment was asked to confine its starts to the floor
|
|
522
588
|
* (`readFloorConfinement: "os"`) and this host cannot (not macOS, or the seatbelt base does not apply here): the
|
|
523
589
|
* environment declares it does not keep the floor, and the run's own judgment (`config.read_deny_floor_unkept`)
|
|
524
590
|
* follows. Once per construction, at construction; `detail: { reason }`.
|
|
591
|
+
* - `"config.inherit_env_declared_late"` — a Node environment's `inheritEnv` list names a variable that a process-level
|
|
592
|
+
* own-credential declaration (`declareWithheldEnv`) made after the environment was built now withholds: every shell
|
|
593
|
+
* child the environment would start is refused, the command's failure carrying the same sentence. Said once per
|
|
594
|
+
* environment, at the first refused start (a read of the environment announces nothing); audience `operator` (the
|
|
595
|
+
* order of two wiring steps the deployment owns); `detail: { index, name }` — the entry, never a value.
|
|
596
|
+
* - `"config.command_sandbox_unavailable"` — the task requires a command sandbox (`TaskSpec.sandbox.enabled`) with
|
|
597
|
+
* `failIfUnavailable: false`, and its execution environment keeps none (`capabilities.commandSandbox` is not true): the
|
|
598
|
+
* run proceeds and its commands run unsandboxed. Under `failIfUnavailable` (its default) the prepare fails with the same
|
|
599
|
+
* code instead. Once per run, at prepare. Audience `user` (the person asked for the sandbox and does not have it);
|
|
600
|
+
* `detail: { reason, sessionId?, runId? }`.
|
|
525
601
|
* - `"config.secret_env_scrubbed"` (#1081) — the D1 fail-closed `scrub` policy, or the deployment's
|
|
526
602
|
* own credentials (`declareWithheldEnv`: a declared name, or a value equal to a declared or engine-held
|
|
527
603
|
* credential value), withheld one or more keys from a spawned child's environment (a tool's shell, an
|
|
@@ -533,9 +609,10 @@ export interface EngineNotice {
|
|
|
533
609
|
* - `"inherit_env.names_withheld"` (#1963) — the same fact for the person whose run drives a tool shell: the variables
|
|
534
610
|
* of the engine's environment that shell does not receive (`ExecutionEnv.withheldEnv`), the scrub's half (the run's
|
|
535
611
|
* `inheritEnv` hands them on) and the engine's own credentials (no policy does). Audience `user`. Read as each
|
|
536
|
-
* call to the engine's own shell tool starts on
|
|
612
|
+
* call to the engine's own shell tool starts, on every leg (the answer can grow during a run: a credential the engine
|
|
537
613
|
* takes in when it first routes a model is withheld from the next child); once per SESSION per name set (the
|
|
538
|
-
* session's announced record).
|
|
614
|
+
* session's announced record). A delegated leg's goes to the delegation tree's root session and names the leg
|
|
615
|
+
* (`sourceSessionId`, `agentId?`, #3650). `detail: { state, names?, ownCredentials?, sessionId, sourceSessionId?, agentId?, runId? }` — `state` `"withheld"`
|
|
539
616
|
* carries the operator row's split (names only, never a value); `"unknown"` (the environment answered `"unknown"`)
|
|
540
617
|
* carries no names and says the engine could not determine them.
|
|
541
618
|
* - `"config.credential_not_withheld"` (#1816) — a credential value the engine was handed (a brain's key or credential
|
|
@@ -621,8 +698,23 @@ export interface EngineNotice {
|
|
|
621
698
|
* `detail: { layer, entries: [{ field, entry, layer, guidance, source? }], total, sessionId }` — `layer` ∈ `caller_policy` / `session_rules` /
|
|
622
699
|
* `ancestor_session_rules` / `task_selector` (a task's tool-name lists) / `skill_table` (a skill's `disallowed-tools`; `source` names the list's
|
|
623
700
|
* owner), `field` ∈ `deny` / `ask`, `guidance` the retirement table's own line, `entries` unique by (field, entry, source) in scan order (at most 32), `total` every one.
|
|
701
|
+
* - `"config.toolpolicy.unmatched_names"` — a tool-name list the REQUEST's own seats wrote (a delegation definition's `allowTools` /
|
|
702
|
+
* `denyTools` in `TaskSpec.agents`, the run's own `allowTools` / `excludeTools`) holds a name no tool of the list's universe answers to
|
|
703
|
+
* (a misspelt name, a server this task does not declare). The entry is kept as written and the run goes on; this says so, because the
|
|
704
|
+
* person who wrote it believes the name guards or grants a tool. Audience `user`. One code, two faces: the operator reads the same
|
|
705
|
+
* sentence on `onError` (`phase: "config"`, the same `code`) — and ONLY there when the list is the deployment's (a delegation tool's
|
|
706
|
+
* own lists, a deployment's tool policy: the policy name audit's advisory carries the code on that channel alone). Once per session
|
|
707
|
+
* per entry. `detail: { where, side, entry, nearest?, sessionId }` — `where` names whose list it is, `side` ∈ `allowed` / `denied`,
|
|
708
|
+
* `entry` the name as written, `nearest` the nearest name a tool of the universe answers to when one is within two edits.
|
|
709
|
+
* - `"config.agent.unknown_tool"` — an entry of a DEFINITION's `allowTools` / `denyTools` that no tool name can be (`"Bash("`, `"a b"`,
|
|
710
|
+
* `""`, `"a b(x)"`: the rule syntax reads no name in it). The run goes on; the definition cannot be delegated to until the entry is
|
|
711
|
+
* fixed — the delegation to it is refused with this same code (`details: { error, reason: "grammar" }`), where it is used. Audience
|
|
712
|
+
* `user`: the person who wrote the definition believes the entry bounds the agent. One code, two faces: the operator reads the same
|
|
713
|
+
* sentence on `onError` (`phase: "config"`, the same `code`, `detail.reason`) — and ONLY there when the definition is one a
|
|
714
|
+
* delegation tool the deployment mounted carries. Once per session per list, naming its first such entry. `detail: { where, side, entry, reason: "grammar", sessionId }`.
|
|
624
715
|
* - `"config.durable_gate_unavailable"` — a durable-approval MANDATE is in force on a leg with NO
|
|
625
|
-
* checkpoint store
|
|
716
|
+
* park facility (no checkpoint store; or, for the entitlement, a delegated leg that cannot be resumed — `cause` below):
|
|
717
|
+
* the per-principal `forceDurableGate` entitlement, or the task's own
|
|
626
718
|
* `durableApproval` opt-in with no live approver seat (`durableMandateSourceOf`, the predicate the
|
|
627
719
|
* leg's children inherit). A mandate with no park facility cannot be honored: no ask of the leg can suspend, so each one resolves on the LIVE
|
|
628
720
|
* chain — a live approver / question face answers in-stream, and with none the ask is denied
|
|
@@ -633,9 +725,12 @@ export interface EngineNotice {
|
|
|
633
725
|
* it through the sink as always). Once per prepared task leg — a resume or a delegated child
|
|
634
726
|
* is its own leg and says so again; `detail: { sessionId, runId, principal?, cause, source,
|
|
635
727
|
* liveApprover, liveQuestionFace }` — `source` is `"force_durable_gate"` or `"durable_approval"`
|
|
636
|
-
* (which mandate is unhonored; the recovery differs); `cause` is `"no_deployment_store"` (the deployment wired none)
|
|
728
|
+
* (which mandate is unhonored; the recovery differs); `cause` is `"no_deployment_store"` (the deployment wired none),
|
|
637
729
|
* `"task_store_disabled"` (`TaskSpec.checkpointStore: "disabled"`, the per-run off switch, on a leg
|
|
638
|
-
* whose deployment may well have a store: the fix is the task's)
|
|
730
|
+
* whose deployment may well have a store: the fix is the task's), or `"leg_not_resumable"` (a store, but the entitlement binds a
|
|
731
|
+
* DELEGATED leg its parent forwarded no durable approval to — a synchronous or fork child, a background child whose lane cannot
|
|
732
|
+
* park. Such a leg parks no ask and nothing answers in its place: every permission ask is refused without consulting the
|
|
733
|
+
* approver, a question is refused, not shown — unlike the two store causes, whose asks resolve on the live chain); `liveApprover` /
|
|
639
734
|
* `liveQuestionFace`: whether a live seat will EFFECTIVELY answer the leg's permission asks /
|
|
640
735
|
* questions in-stream (a delegated child under an inherited content mandate reads `false`
|
|
641
736
|
* even with a face wired — the marker withholds the question), or the fail-closed deny will.
|
|
@@ -683,8 +778,8 @@ export interface EngineNotice {
|
|
|
683
778
|
*
|
|
684
779
|
* - `"task.turn_interrupted"` (design/373) — a running turn was ACTUALLY CUT at a manufactured
|
|
685
780
|
* boundary: the in-flight provider stream / tool batch was aborted (finished tool calls keep
|
|
686
|
-
* their real results, never-started ones settle as paired
|
|
687
|
-
*
|
|
781
|
+
* their real results, never-started ones settle as paired results; the interruption marker
|
|
782
|
+
* line lands on the bare-halt lane only). **THREE mint lanes, one code** — the CUT is lane-independent, so it is one fact
|
|
688
783
|
* with one spelling, and `detail.cause` is the arm discriminator (a consumer that must tell
|
|
689
784
|
* them apart reads that key; one that only cares "a turn was cut" reads neither):
|
|
690
785
|
* · the STEER-NOW lane (design/373) — a caller-provenance steer with `priority: "now"` cut
|
|
@@ -704,7 +799,15 @@ export interface EngineNotice {
|
|
|
704
799
|
* ending, no `haltedByUser`, plus a `task.halt_unconsumed`); the notice stands beside that
|
|
705
800
|
* terminal without contradiction, because a seat really was cut — `haltedByUser` answers
|
|
706
801
|
* the other question (was the halt CONSUMED), see that seat.
|
|
707
|
-
*
|
|
802
|
+
* · the EXTENSION lane (a mod's `$.turn.abort({ turn })`) — an extension ended the running model
|
|
803
|
+
* turn and the run goes on at the ordinary turn boundary (a queued follow-up opens the next
|
|
804
|
+
* turn, else the stop gate is asked, else the run completes carrying {@link TaskResult.turnAbortedBy}).
|
|
805
|
+
* `detail: { cause: "extension_abort", extension, turn, sessionId, runId, taskId }` — `extension`
|
|
806
|
+
* is the registration that asked, `turn` the turn number it ended; no `inputId`, no `actorId`. The notice
|
|
807
|
+
* rides the cut's ACCEPTANCE: a cut that lands after the request's end was delivered but before the loop
|
|
808
|
+
* obtained its final is accepted and announced, yet the turn still ends as its answer — that cut is then
|
|
809
|
+
* disclosed by `task.halt_unconsumed` (`detail.source: "extension"`) at the result's settlement.
|
|
810
|
+
* In every lane: one notice per REAL cut (a `now` that found nothing in flight or whose frame
|
|
708
811
|
* already rode the imminent boundary, and a halt with nothing in flight, announce nothing — no
|
|
709
812
|
* false interrupt claims); `runId` is the INVOCATION that was cut; every cut turn counts toward
|
|
710
813
|
* `maxTurns`, so an interrupt storm's cost is bounded and each of its cuts is on the record.
|
|
@@ -727,9 +830,16 @@ export interface EngineNotice {
|
|
|
727
830
|
* for it (a brain minting its own `aborted` final beside a late halt, a natural completion the halt
|
|
728
831
|
* arrived too late to prevent, an approval park whose commit won the race and whose abort owned the
|
|
729
832
|
* ending); once per such run, at the result's settlement. Either way the notice is the halt's trace
|
|
730
|
-
* beside the verb receipt. `detail: { sessionId, runId, taskId }` — `runId` is the run whose ending
|
|
833
|
+
* beside the verb receipt. `detail: { source: "halt", sessionId, runId, taskId }` — `runId` is the run whose ending
|
|
731
834
|
* the halt failed to claim. Audience `"user"`. A REFUSED halt (typed `steering.not_running` throw)
|
|
732
835
|
* mints nothing: the refusal itself is the loud answer.
|
|
836
|
+
* The same code is the trace of the OTHER request that asks to end a turn — an extension's `$.turn.abort` whose cut
|
|
837
|
+
* was ACCEPTED (`task.turn_interrupted` was announced) but that no settlement took as its turn's cause: the turn had
|
|
838
|
+
* already ended on its own outcome (its request's end was delivered before the cut, so it ends as an answer), or
|
|
839
|
+
* the run's own ending won. The result does NOT carry `turnAbortedBy` for it. One per such cut, at the result's
|
|
840
|
+
* settlement (the settle arm). `detail: { source: "extension", extension, turn, sessionId, runId, taskId }` —
|
|
841
|
+
* `extension` and `turn` are the cut's own (the ones its `task.turn_interrupted` carried). `detail.source`
|
|
842
|
+
* (`"halt" | "extension"`) names whose request it was; a steer-now's cut asks to redirect, not to end, and has none.
|
|
733
843
|
*
|
|
734
844
|
* - `"task.late_approval"` (design/384 slice 1) — a synchronous ask approval was NOT CONSUMED:
|
|
735
845
|
* a run or turn interrupt released the wait (the `resolveAsk` race arm detached the approver's
|
|
@@ -746,7 +856,7 @@ export interface EngineNotice {
|
|
|
746
856
|
* forward it on its own wire.
|
|
747
857
|
*
|
|
748
858
|
* - `"task.interrupt_unconsumed"` — a HARD stop ({@link TaskStream.interrupt}, the task's `signal`,
|
|
749
|
-
* the walltime or the turns limit) landed AFTER the run's last turn had already given its answer
|
|
859
|
+
* the walltime or the turns limit, the budget gate) landed AFTER the run's last turn had already given its answer
|
|
750
860
|
* (`stopReason:"stop"`, not partial, and no steer / follow-up of the person's still pending — a
|
|
751
861
|
* queued continuation makes that "stop" work in progress, and a stop that cuts it stays the
|
|
752
862
|
* ordinary abort with its undrained-input account) and before the loop's end — what it aborted was the run's
|
|
@@ -754,11 +864,11 @@ export interface EngineNotice {
|
|
|
754
864
|
* answer stands: the run ends `completed` with it as `result`, no `[Request interrupted by user]`
|
|
755
865
|
* marker is written and no `limits.*` terminal is minted for the axis that fired; this notice is
|
|
756
866
|
* the stop's only trace. Minted once per such run, after the terminal arbitration (so it never
|
|
757
|
-
* claims a completed ending the terminal did not give
|
|
758
|
-
* turn's own spend still fails the run and mints nothing here); `detail: { sessionId, runId,
|
|
867
|
+
* claims a completed ending the terminal did not give); `detail: { sessionId, runId,
|
|
759
868
|
* taskId, origin }` with `origin` ∈ `"interrupt"` (the verb) | `"walltime"` | `"turns"` |
|
|
869
|
+
* `"budget"` (the budget gate's stop on an answering turn; the spend is on `stats`) |
|
|
760
870
|
* `"signal"` (every other run-level abort: the task's own `signal`, a parent's cancel, a
|
|
761
|
-
* `destroy()`, a refused preempt — the leg names the
|
|
871
|
+
* `destroy()`, a refused preempt — the leg names the four it can tell apart and files the rest
|
|
762
872
|
* here). Audience `"user"`. A stop that arrives AFTER the loop's end but before `done` aborted no
|
|
763
873
|
* live loop and mints nothing here: it is answered, the end-of-task compaction pass does not run past
|
|
764
874
|
* it (cut in flight — `compaction_outcome{mooted, reason:"cancelled"}` — or never started), and the
|
|
@@ -773,6 +883,14 @@ export interface EngineNotice {
|
|
|
773
883
|
* `not_a_string` | `no_candidate` | `mismatch` | `unresolvable` | `resolves_elsewhere` | `admits_artifact_store`
|
|
774
884
|
* (the directory contains the wired local artifact store, lies inside it or is it) | `no_read_roots`. Once per
|
|
775
885
|
* answered ask. Audience `"user"`.
|
|
886
|
+
* - `"approval.approver_defect"` (`src/core/runner/approver-defect-announcer.ts`, `approverDefectAnnouncer`; minted by the four stations that put an
|
|
887
|
+
* ask to an approver) — the approver THREW, or ANSWERED outside its contract (an answer that is not `true` / `false` /
|
|
888
|
+
* `"unavailable"` / the `{allow}` object, or an object the seam refuses: a reason that is no string, an attribution or a
|
|
889
|
+
* `decidedVia` it cannot read), and the call it was asked about was denied fail-closed — the tool did not run. The model reads that
|
|
890
|
+
* denial as it reads any other; this tells the one who wired the seat that the seat is broken.
|
|
891
|
+
* `detail: { toolName, toolCallId, cause, seat, sessionId, runId, taskId }` — `cause` ∈ `threw` / `out_of_contract`; `seat` ∈
|
|
892
|
+
* `policy` (an approver the deployment declared a policy, `asPolicyApprover`) / `approver` (any other); never the thrown text or the
|
|
893
|
+
* answer (the denial the model reads names them). Once per denied ask. Audience `"operator"`: the defect is the deployment's code.
|
|
776
894
|
*
|
|
777
895
|
* - `"checkpoint.execution_outcome_unrecorded"` — the resumed leg's pending-call resolver disposed
|
|
778
896
|
* the decided action (executed it, delivered the refusal, or vetoed the person's yes) and filed
|
|
@@ -963,6 +1081,13 @@ export interface EngineNotice {
|
|
|
963
1081
|
* failures of a switch the person is still trying to throw.
|
|
964
1082
|
* Read the run's own outcome (or the verb's rejection) to tell the two apart; this code alone
|
|
965
1083
|
* does not say whether anything stopped.
|
|
1084
|
+
* - `"memory.mount_failed"` — a memory store that was asked for did not mount for this run (the memory phase's fail-open
|
|
1085
|
+
* arm: the task runs without its memory). Minted under the guard that mints the run's `memoryless` / `mount-failed`
|
|
1086
|
+
* observation, so the two are one fact; the operator's half is `onError` (`{ phase: "memory" }`), this is the person's.
|
|
1087
|
+
* `detail: { sessionId, scopes, cause }` — `scopes` is what the task asked to mount (the whole span failed), `cause` the
|
|
1088
|
+
* refusal's own code when it is a member of `STORE_FORM_REFUSAL_CODES`, else `"unclassified"`; never the thrown text, never a
|
|
1089
|
+
* path. Audience `"user"`. Dedup unit: once per SESSION — key `(code, detail.sessionId)`; the phase mints once per leg whose
|
|
1090
|
+
* mount failed. The model's half is the memory band's writes-unavailable notice, said only where the roster cannot persist.
|
|
966
1091
|
* - `"memory.consolidation_incomplete"` (design/376, LLM consolidation driver) — a driver run
|
|
967
1092
|
* settled without reaching the fixpoint: `detail` names the stop reason (the closed
|
|
968
1093
|
* `ConsolidationRunStopReason` set), cycles done, and the residue (write-failure or
|
|
@@ -1077,9 +1202,9 @@ export interface EngineNotice {
|
|
|
1077
1202
|
* is the one sentence naming the caller-side change that would have let the call run, as the tool text carries it (for arguments
|
|
1078
1203
|
* no approval can be bound to, the binding's own sentence: the remedy's approver half would not let them run). Audience `"user"`: the refused
|
|
1079
1204
|
* work is the session user's own; the operator hears it through the sink like every code.
|
|
1080
|
-
* - `"delegation.resume_lane_missing"` (#3334) — a parked agent resumed by a lane-less drive
|
|
1081
|
-
* its
|
|
1082
|
-
* the consume, to the process default seat. `detail: { taskId, rootSessionId? }`. Audience `"operator"`.
|
|
1205
|
+
* - `"delegation.resume_lane_missing"` (#3334) — a parked agent resumed by a lane-less drive whose task registry holds no park of it: its completion is routed to its
|
|
1206
|
+
* tree's root session — its live run on the drive's runner, else its durable box (`detail.path: "box"`) — or, where the root has no durable box (the sentence names why),
|
|
1207
|
+
* the mount's sink; a submission waiting on it elsewhere is not settled by it. Once per drive, at the consume, to the process default seat. `detail: { taskId, rootSessionId?, path? }`. Audience `"operator"`.
|
|
1083
1208
|
* - `"delegation.delivery_discarded"` (#3431) — a frame (a background task's completion, a monitor event, a child's message)
|
|
1084
1209
|
* addressed to an earlier occupant of a session id — the id deleted and created again, by another principal or the same
|
|
1085
1210
|
* one — was discarded instead of delivered to the occupant the id holds now. Once per frame, by the Runner's per-session
|
|
@@ -1115,7 +1240,7 @@ export interface EngineNotice {
|
|
|
1115
1240
|
* throw rendered twice keeps one id, two refusals sharing a code/scope/message get two. Omitted
|
|
1116
1241
|
* (never fabricated) when the caller composes the line with no error in hand.
|
|
1117
1242
|
*
|
|
1118
|
-
* The
|
|
1243
|
+
* The five SERVER-minted rows ({@link NOTICE_MINTER} `"server"`) — catalogued so their audience and detail shape
|
|
1119
1244
|
* are read here like every other row; this engine never mints them. A server forwards them through the same sink.
|
|
1120
1245
|
* - `"permission.entry_mode_clamped"` — the permission mode the caller requested was clamped by the deployment's
|
|
1121
1246
|
* entry floor BEFORE the run reached this engine (the server's own clamp, through this package's
|
|
@@ -1124,10 +1249,6 @@ export interface EngineNotice {
|
|
|
1124
1249
|
* `config.permission_mode_unavailable`, never this row. Audience `"user"`; `detail: { requested, effective,
|
|
1125
1250
|
* ceiling, sessionId }` — `requested` the caller's word, `effective` the word the run starts under, `ceiling`
|
|
1126
1251
|
* the floor that clamped it; no run id — the clamp happens at intake, before any run exists. Once per run.
|
|
1127
|
-
* - `"instructions.source_changed"` — the project instruction file this run injects is not the one the same
|
|
1128
|
-
* session's previous run injected (a file added, removed or renamed). Audience `"user"`; `detail: { previous,
|
|
1129
|
-
* current, sessionId }` — `previous` / `current` are chain-member relative paths, `null` = that run had none.
|
|
1130
|
-
* No `runId`. Once per run.
|
|
1131
1252
|
* - `"memory.layer_locked_legacy"` — a memory layer an older engine left without its owner-write bit was found at
|
|
1132
1253
|
* boot; deletes in it will fail until the operator restores the bit. Audience `"operator"`; `detail: { layers,
|
|
1133
1254
|
* remedy }` — layer directory names and the one command. No session. Once per boot.
|
|
@@ -1140,6 +1261,13 @@ export interface EngineNotice {
|
|
|
1140
1261
|
* per-leg dedup folds the two into one line); `proxyInUse` present only when that request went through a proxy,
|
|
1141
1262
|
* its value the variable's name (`HTTP_PROXY` or `HTTPS_PROXY`), never the proxy address. No `runId`. Once per
|
|
1142
1263
|
* leg per target.
|
|
1264
|
+
* - `"model.context_window_assumed"` — a model the catalog gives no `contextWindow` for ran on an assumed window the serving layer chose before the run reached this engine. Audience `"user"`; `detail: { model, assumedContextWindow, sessionId }` — the model's name and the window the run was sized on; no `runId`.
|
|
1265
|
+
* - `"config.store_ephemeral"` (#3952) — the deployment declared this engine's session and checkpoint stores
|
|
1266
|
+
* process-local: parking and resume hold only within the serving process. Present only when the deployment's
|
|
1267
|
+
* store declares itself ephemeral; this package reads no such declaration and mints no such notice. Audience
|
|
1268
|
+
* `"user"` — the person's parked work and later resume are what the declaration bounds, and the remedy (a
|
|
1269
|
+
* durable store) stays the deployment's; `detail.sessionId` names the session. The sentence the person reads and
|
|
1270
|
+
* how often it is told are the server's; this engine only catalogues the code.
|
|
1143
1271
|
*
|
|
1144
1272
|
* Deliberately NOT a notice family: brain retry/reconnect liveness (a rate limit, a 5xx, a
|
|
1145
1273
|
* transient network failure being retried). Those are per-attempt liveness frames with their own
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/** The mode of every file the engine creates to hold its own data: owner read/write only. */
|
|
2
|
+
export declare const PRIVATE_FILE_MODE = 384;
|
|
3
|
+
/**
|
|
4
|
+
* The one way the engine opens a file it will fill and then publish under another name: a NEW file, owner-only. `open(2)`
|
|
5
|
+
* applies a mode only to a file it creates, so a truncating open (`"w"`) of a name that is already there keeps that file's
|
|
6
|
+
* old mode and its inode, and the rename that publishes it hands both to the official name. Two shapes of write need two
|
|
7
|
+
* spellings, and no third:
|
|
8
|
+
* - a temp file that is renamed or linked onto its target — {@link openExclusiveTemp}, below;
|
|
9
|
+
* - a file whose name is fixed and sits in a directory this very call just created (a lock's owner token, a staged tree) —
|
|
10
|
+
* `openSync(path, "wx", PRIVATE_FILE_MODE)`: a directory made a moment ago holds nothing, so `wx` cannot meet a
|
|
11
|
+
* leftover, and a planted name is refused rather than written through.
|
|
12
|
+
* Anything that opens a file for writing, with a mode, and neither of these, is the defect this module exists to prevent.
|
|
13
|
+
*/
|
|
14
|
+
/**
|
|
15
|
+
* Open a NEW temp file named `<stem>.<pid>.<random>.tmp` for writing, and say which name it got. The open is
|
|
16
|
+
* `O_CREAT | O_EXCL`, so it never reuses a file that is already there. A name already taken is skipped for a fresh one,
|
|
17
|
+
* never opened, truncated or removed — whatever stands there is not ours to touch. After {@link TEMP_OPEN_ATTEMPTS} taken
|
|
18
|
+
* names the open throws a plain `Error` carrying the last `EEXIST` as its `cause`: deliberately not an `EEXIST` itself,
|
|
19
|
+
* because a caller that publishes with `link` answers an `EEXIST` of its own for "the target is already there", and must
|
|
20
|
+
* not read an exhausted temp namespace as a published blob.
|
|
21
|
+
*/
|
|
22
|
+
export declare function openExclusiveTemp(stem: string): {
|
|
23
|
+
fd: number;
|
|
24
|
+
path: string;
|
|
25
|
+
};
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { randomBytes } from "node:crypto";
|
|
2
|
+
import { constants as FS, openSync } from "node:fs";
|
|
3
|
+
export const PRIVATE_FILE_MODE = 0o600;
|
|
4
|
+
const TEMP_OPEN_ATTEMPTS = 8;
|
|
5
|
+
export function openExclusiveTemp(stem) {
|
|
6
|
+
let lastExists;
|
|
7
|
+
for (let attempt = 0; attempt < TEMP_OPEN_ATTEMPTS; attempt++) {
|
|
8
|
+
const path = `${stem}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
|
|
9
|
+
try {
|
|
10
|
+
return { fd: openSync(path, FS.O_CREAT | FS.O_EXCL | FS.O_WRONLY, PRIVATE_FILE_MODE), path };
|
|
11
|
+
}
|
|
12
|
+
catch (err) {
|
|
13
|
+
if (err.code !== "EEXIST")
|
|
14
|
+
throw err;
|
|
15
|
+
lastExists = err;
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
throw new Error(`file store: no unused temp file name for ${stem} after ${TEMP_OPEN_ATTEMPTS} attempts`, { cause: lastExists });
|
|
19
|
+
}
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The current state of a write's target, on the approval card that asks for the write.
|
|
3
|
+
*
|
|
4
|
+
* THE RULE (one sentence): a write tool's approval card carries what its target holds now exactly when the model's own `Read`
|
|
5
|
+
* of that path, issued now, would be served; otherwise the card says why it has none. No read floor of its own, no read path
|
|
6
|
+
* of its own: the read is the Read tool's — the run's served-read judge (the synthetic `Read` probe with every ask held, so a
|
|
7
|
+
* read anyone would first be asked about is not served, carrying what the live gate stamps on the model's own `Read` — the
|
|
8
|
+
* face the run's roster gives `Read` and the leg's facts — so a policy judges the probe as it judges the model's own `Read`;
|
|
9
|
+
* a roster with no `Read` serves no read at all), then the Read tool's own text read on the execution lane,
|
|
10
|
+
* its final resolution held to the file the judgment named. Nothing about the read is recorded: the card's read never
|
|
11
|
+
* stands for the model having read the file (a later `Write` of a file the model never read is still refused).
|
|
12
|
+
*
|
|
13
|
+
* WHICH CARDS: a tool whose roster row writes a file on the execution environment ({@link existingTargetCovers}) — the
|
|
14
|
+
* write family, a path target that is not read-only, the environment leg. Every card in that scope carries the member;
|
|
15
|
+
* a card outside it never does.
|
|
16
|
+
*
|
|
17
|
+
* THE STATES:
|
|
18
|
+
* text — the target's text, as the Read tool's text lane decodes it (byte-order mark removed, CRLF folded to LF) —
|
|
19
|
+
* the coordinate the write tool's own result reports the old contents in;
|
|
20
|
+
* absent — nothing is at the path (said only after the judgment and the resolution allowed the read: a refused path
|
|
21
|
+
* never tells whether it exists);
|
|
22
|
+
* withheld — `oversize` (past {@link EXISTING_TARGET_READ_CAP}, by the stat or by the bytes read; never cut short),
|
|
23
|
+
* `not_text` (a directory, a binary file, a body that is not UTF-8 or a truncated UTF-16 body),
|
|
24
|
+
* `read_refused` (the resolution, or a judgment layer, refuses the read or would first ask someone about it,
|
|
25
|
+
* or the run's roster has no `Read`),
|
|
26
|
+
* `unavailable` (no reader on this lane, a layer that could not answer, the judgment landing on another file,
|
|
27
|
+
* the stat or the read failing, the wait ending first).
|
|
28
|
+
*
|
|
29
|
+
* WHEN: ONE read per ask. The live ask reads only when a person's seat will answer the card ({@link readsCardTarget}: a seat
|
|
30
|
+
* that answers, not a policy approver's — a policy seat renders no card — and not answering the ask from its declared class
|
|
31
|
+
* table); the durable park reads only when no lane of
|
|
32
|
+
* the same ask read before it, before the run lets go of its environment, and keeps the answer on the parked row (a resumed
|
|
33
|
+
* run never reads again). A park after the live card answered `unavailable` carries the live card's member as read
|
|
34
|
+
* ({@link cardTargetFor}; "the same arguments" is the approval binding's reading — {@link exactBoundInputHashOf} — so a
|
|
35
|
+
* park whose arguments went through the stored JSON form is still the same ask's arguments). A card is the target as of
|
|
36
|
+
* the ask: the file may change before the approved write runs.
|
|
37
|
+
*/
|
|
38
|
+
import { type ToolRoster, type ToolRosterEntry } from "./tool-roster.js";
|
|
39
|
+
import type { SyntheticServedReadJudge } from "./synthetic-read-verdict.js";
|
|
40
|
+
import { type OnAsk } from "./tool-policy.js";
|
|
41
|
+
import type { AskClass } from "./ask-origin.js";
|
|
42
|
+
import type { ModelFileReader } from "../tools/fs/fs-read.js";
|
|
43
|
+
/** The card member's three shapes. */
|
|
44
|
+
export declare const EXISTING_TARGET_KINDS: readonly ["text", "absent", "withheld"];
|
|
45
|
+
export type ExistingTargetKind = (typeof EXISTING_TARGET_KINDS)[number];
|
|
46
|
+
/** Why a card in scope carries no text. */
|
|
47
|
+
export declare const EXISTING_TARGET_WITHHELD_REASONS: readonly ["oversize", "not_text", "read_refused", "unavailable"];
|
|
48
|
+
export type ExistingTargetWithheldReason = (typeof EXISTING_TARGET_WITHHELD_REASONS)[number];
|
|
49
|
+
export type ExistingTarget = {
|
|
50
|
+
readonly kind: "text";
|
|
51
|
+
readonly text: string;
|
|
52
|
+
} | {
|
|
53
|
+
readonly kind: "absent";
|
|
54
|
+
} | {
|
|
55
|
+
readonly kind: "withheld";
|
|
56
|
+
readonly why: ExistingTargetWithheldReason;
|
|
57
|
+
};
|
|
58
|
+
/** The most bytes a card's read takes from its target; a larger target is `withheld` / `oversize`. */
|
|
59
|
+
export declare const EXISTING_TARGET_READ_CAP = 262144;
|
|
60
|
+
/** The served-read judge's probe face (probe id `approval-card-visibility-probe`). */
|
|
61
|
+
export declare const EXISTING_TARGET_PROBE_FACE = "approval-card";
|
|
62
|
+
/** Whether a roster row's card carries the member: it writes a file on the execution environment. Read off the row's own
|
|
63
|
+
* declarations, never a list of names. */
|
|
64
|
+
export declare function existingTargetCovers(row: Pick<ToolRosterEntry, "family" | "pathTarget" | "boundaryLegs"> | undefined): boolean;
|
|
65
|
+
/** What a lane reads a card's target with: the run's served-read judge (it stamps the leg's facts on its probe) and the
|
|
66
|
+
* lane's file reader. */
|
|
67
|
+
export interface ExistingTargetSource {
|
|
68
|
+
readonly judge: SyntheticServedReadJudge;
|
|
69
|
+
readonly reader: Pick<ModelFileReader, "readText">;
|
|
70
|
+
}
|
|
71
|
+
/** What one ask's lane read: the arguments it read the target of (and their approval binding), and the member it got. */
|
|
72
|
+
interface TargetRead {
|
|
73
|
+
readonly args: unknown;
|
|
74
|
+
readonly binding: string | undefined;
|
|
75
|
+
readonly member: {
|
|
76
|
+
readonly existingTarget?: ExistingTarget;
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
/** The run's source, filled once the run's judge exists (empty on a lane with no reader), and what each ask's lanes read. */
|
|
80
|
+
export interface ExistingTargetSeat {
|
|
81
|
+
current: ExistingTargetSource | undefined;
|
|
82
|
+
/** The member an ask's lane read, by the ask's request object: a later lane of the same ask over the same arguments
|
|
83
|
+
* carries it instead of reading again. */
|
|
84
|
+
readonly read: WeakMap<object, TargetRead>;
|
|
85
|
+
}
|
|
86
|
+
/** A run's seat, its source not yet filled. */
|
|
87
|
+
export declare function createExistingTargetSeat(): ExistingTargetSeat;
|
|
88
|
+
/** Whether a live ask's seat reads its card's target: a seat that answers the card, is not a policy approver's
|
|
89
|
+
* ({@link import("./tool-policy.js").asPolicyApprover} — a policy seat renders no card), and does not answer this ask from
|
|
90
|
+
* its declared class table ({@link import("./tool-policy.js").declareClassAnswers} — the resolver answers a covered ask
|
|
91
|
+
* without calling the seat, so no card is rendered). `classes` is the class set the request to the seat carries. */
|
|
92
|
+
export declare function readsCardTarget(onAsk: OnAsk | undefined, classes: readonly AskClass[] | undefined): boolean;
|
|
93
|
+
/**
|
|
94
|
+
* The member one lane puts on one ask's card: what an earlier lane of the same ask (`ask`, its request object) read over the
|
|
95
|
+
* same arguments (the same object, or the same approval binding); else, when `reads`, one read (recorded for the ask's later
|
|
96
|
+
* lanes); else the member of a card nobody read.
|
|
97
|
+
*/
|
|
98
|
+
export declare function cardTargetFor(seat: ExistingTargetSeat, roster: ToolRoster | undefined, ask: {
|
|
99
|
+
readonly toolName: string;
|
|
100
|
+
}, args: unknown, reads: boolean, signal?: AbortSignal): Promise<{
|
|
101
|
+
existingTarget?: ExistingTarget;
|
|
102
|
+
}>;
|
|
103
|
+
/**
|
|
104
|
+
* The member the card of `toolName`'s call carries, as a spread: `{}` for a card out of scope (its row on `roster`, by
|
|
105
|
+
* {@link existingTargetCovers}); `withheld` / `unavailable` with no source (a lane that has no reader, or a caller that does
|
|
106
|
+
* not read); `withheld` / `read_refused` when the roster has no `Read`. One wait bounds the judgment and the read together
|
|
107
|
+
* — the judgment's own budget; the call's signal ends it sooner. Never throws.
|
|
108
|
+
*/
|
|
109
|
+
export declare function existingTargetOf(roster: ToolRoster | undefined, toolName: string, args: unknown, source: ExistingTargetSource | undefined, signal?: AbortSignal): Promise<{
|
|
110
|
+
existingTarget?: ExistingTarget;
|
|
111
|
+
}>;
|
|
112
|
+
export {};
|