@sema-agent/core 7.66.1 → 7.67.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3518 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +169 -0
- package/dist/brain/model-lane.js +505 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +164 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +105 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +24 -25
- package/dist/core/roles.js +148 -21
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +23 -0
- package/dist/core/runner/model-fallback-seat.js +64 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +11 -3
- package/dist/core/runner/prepare-park-ask.js +23 -19
- package/dist/core/runner/prepare-policy-chain.d.ts +17 -3
- package/dist/core/runner/prepare-policy-chain.js +144 -120
- package/dist/core/runner/prepare-project-context.d.ts +15 -53
- package/dist/core/runner/prepare-project-context.js +20 -83
- package/dist/core/runner/prepare-prompt-assembly.d.ts +7 -1
- package/dist/core/runner/prepare-prompt-assembly.js +9 -7
- package/dist/core/runner/prepare-prompt-inputs.d.ts +9 -3
- package/dist/core/runner/prepare-prompt-inputs.js +5 -3
- package/dist/core/runner/prepare-protocol-tools.d.ts +9 -4
- package/dist/core/runner/prepare-protocol-tools.js +46 -27
- package/dist/core/runner/prepare-question-face.d.ts +6 -5
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +19 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +126 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +64 -34
- package/dist/index.js +45 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +340 -32
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core-stores-sql@7.67.1.json +39 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/core@7.67.1.json +406 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/mods-kernel@7.67.1.json +39 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/primitives@7.67.1.json +39 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/wire-changes/wiki-gate@7.67.1.json +39 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import { rosterEntryNamed, toolCallFaceOf } from "./tool-roster.js";
|
|
2
|
+
import { pathTargetValue } from "./tool-registry.js";
|
|
3
|
+
import { ORG_ADJUDICATION_TIMEOUT_MS } from "./permission-rule-org.js";
|
|
4
|
+
import { declaredClassAnswer, isAnsweringSeat, isPolicyApprover } from "./tool-policy.js";
|
|
5
|
+
import { exactBoundInputHashOf } from "./canonical-json.js";
|
|
6
|
+
export const EXISTING_TARGET_KINDS = Object.freeze(["text", "absent", "withheld"]);
|
|
7
|
+
export const EXISTING_TARGET_WITHHELD_REASONS = Object.freeze(["oversize", "not_text", "read_refused", "unavailable"]);
|
|
8
|
+
export const EXISTING_TARGET_READ_CAP = 262_144;
|
|
9
|
+
export const EXISTING_TARGET_PROBE_FACE = "approval-card";
|
|
10
|
+
export function existingTargetCovers(row) {
|
|
11
|
+
return row !== undefined && row.family === "file-write" && row.pathTarget !== undefined && row.pathTarget.access !== "read" && Array.isArray(row.boundaryLegs) && row.boundaryLegs.includes("env");
|
|
12
|
+
}
|
|
13
|
+
export function createExistingTargetSeat() {
|
|
14
|
+
return { current: undefined, read: new WeakMap() };
|
|
15
|
+
}
|
|
16
|
+
export function readsCardTarget(onAsk, classes) {
|
|
17
|
+
return isAnsweringSeat(onAsk) && !isPolicyApprover(onAsk) && declaredClassAnswer(onAsk, classes) === undefined;
|
|
18
|
+
}
|
|
19
|
+
export async function cardTargetFor(seat, roster, ask, args, reads, signal) {
|
|
20
|
+
const earlier = seat.read.get(ask);
|
|
21
|
+
if (earlier !== undefined && (earlier.args === args || (earlier.binding !== undefined && earlier.binding === exactBoundInputHashOf(ask.toolName, args))))
|
|
22
|
+
return earlier.member;
|
|
23
|
+
const source = reads ? seat.current : undefined;
|
|
24
|
+
const member = await existingTargetOf(roster, ask.toolName, args, source, signal);
|
|
25
|
+
if (source !== undefined)
|
|
26
|
+
seat.read.set(ask, { args, binding: exactBoundInputHashOf(ask.toolName, args), member });
|
|
27
|
+
return member;
|
|
28
|
+
}
|
|
29
|
+
const UNAVAILABLE = Object.freeze({ kind: "withheld", why: "unavailable" });
|
|
30
|
+
const READ_REFUSED = Object.freeze({ kind: "withheld", why: "read_refused" });
|
|
31
|
+
const ENDED = Symbol("ended");
|
|
32
|
+
function within(p, signal) {
|
|
33
|
+
if (signal.aborted)
|
|
34
|
+
return Promise.resolve(ENDED);
|
|
35
|
+
return new Promise((resolve) => {
|
|
36
|
+
const end = () => resolve(ENDED);
|
|
37
|
+
signal.addEventListener("abort", end, { once: true });
|
|
38
|
+
p.then((v) => {
|
|
39
|
+
signal.removeEventListener("abort", end);
|
|
40
|
+
resolve(v);
|
|
41
|
+
}, () => {
|
|
42
|
+
signal.removeEventListener("abort", end);
|
|
43
|
+
resolve(ENDED);
|
|
44
|
+
});
|
|
45
|
+
});
|
|
46
|
+
}
|
|
47
|
+
function fromReading(r) {
|
|
48
|
+
switch (r.kind) {
|
|
49
|
+
case "text":
|
|
50
|
+
return { kind: "text", text: r.text };
|
|
51
|
+
case "absent":
|
|
52
|
+
return { kind: "absent" };
|
|
53
|
+
case "refused":
|
|
54
|
+
return READ_REFUSED;
|
|
55
|
+
case "not_text":
|
|
56
|
+
case "oversize":
|
|
57
|
+
return { kind: "withheld", why: r.kind };
|
|
58
|
+
case "moved":
|
|
59
|
+
case "unavailable":
|
|
60
|
+
return UNAVAILABLE;
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
export async function existingTargetOf(roster, toolName, args, source, signal) {
|
|
64
|
+
const row = roster !== undefined ? rosterEntryNamed(roster, toolName) : undefined;
|
|
65
|
+
if (!existingTargetCovers(row))
|
|
66
|
+
return {};
|
|
67
|
+
const path = row?.pathTarget !== undefined ? pathTargetValue(args, row.pathTarget) : undefined;
|
|
68
|
+
if (source === undefined || path === undefined)
|
|
69
|
+
return { existingTarget: UNAVAILABLE };
|
|
70
|
+
const face = toolCallFaceOf(roster, "Read");
|
|
71
|
+
if (face === undefined)
|
|
72
|
+
return { existingTarget: READ_REFUSED };
|
|
73
|
+
const deadlineAt = Date.now() + ORG_ADJUDICATION_TIMEOUT_MS;
|
|
74
|
+
const timeout = AbortSignal.timeout(ORG_ADJUDICATION_TIMEOUT_MS);
|
|
75
|
+
const wait = signal !== undefined ? AbortSignal.any([signal, timeout]) : timeout;
|
|
76
|
+
try {
|
|
77
|
+
const verdict = await within(source.judge({ file_path: path, face }, EXISTING_TARGET_PROBE_FACE, { deadlineAt }), wait);
|
|
78
|
+
if (verdict === ENDED || verdict.verdict === "unanswerable")
|
|
79
|
+
return { existingTarget: UNAVAILABLE };
|
|
80
|
+
if (verdict.verdict !== "no_objection")
|
|
81
|
+
return { existingTarget: READ_REFUSED };
|
|
82
|
+
const reading = await within(source.reader.readText(path, { signal: wait }, { capBytes: EXISTING_TARGET_READ_CAP, ...(verdict.judged !== undefined ? { judgedKey: verdict.judged } : {}) }), wait);
|
|
83
|
+
return { existingTarget: reading === ENDED ? UNAVAILABLE : fromReading(reading) };
|
|
84
|
+
}
|
|
85
|
+
catch {
|
|
86
|
+
return { existingTarget: UNAVAILABLE };
|
|
87
|
+
}
|
|
88
|
+
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { GovernanceRetryClass } from "./governance-codes.js";
|
|
2
2
|
import { type FileHistoryRetentionPolicy } from "./file-history-retention.js";
|
|
3
|
-
import type { ExecutionEnv } from "../internal/harness-types.js";
|
|
3
|
+
import type { ExecutionEnv, SessionRowExpectation } from "../internal/harness-types.js";
|
|
4
4
|
/** rel path of `child` under `root` in "/" form (win root) / verbatim form (posix root); null when not under.
|
|
5
5
|
* Fold "\" only under a WIN-family root ({@link isWinFormPath}); a POSIX tree may legally contain literal
|
|
6
6
|
* backslashes in FILE NAMES, and folding them would corrupt both the track key and the restore target. */
|
|
@@ -223,7 +223,8 @@ export interface FileHistoryDiffStats {
|
|
|
223
223
|
export interface RewindFilesRequest {
|
|
224
224
|
/** The session whose history is converged. It must exist. */
|
|
225
225
|
sessionId: string;
|
|
226
|
-
/** The boundary key: the entry id of
|
|
226
|
+
/** The boundary key: the entry id of the person's input that opened a turn (its run's first row of a person's
|
|
227
|
+
* input; an engine entry ahead of it, such as a task notification, is not one) — the id space `TaskSpec.rewindFilesTo`
|
|
227
228
|
* addresses ("the files as they were when that turn began"). An entry with no boundary of its own refuses. */
|
|
228
229
|
to: string;
|
|
229
230
|
/** Preview only: the working tree is not written (a fork whose history was never carried may have its carry
|
|
@@ -231,6 +232,11 @@ export interface RewindFilesRequest {
|
|
|
231
232
|
dryRun?: boolean;
|
|
232
233
|
/** Caller cancel for the restore. */
|
|
233
234
|
signal?: AbortSignal;
|
|
235
|
+
/** The occupant the caller read the session as: `{ row: { owner, incarnation } }` (a `SessionHead` serves as `row`) — the
|
|
236
|
+
* session under `sessionId` must still be that row (`sessionRowMatches` on the acquired session), or nothing is rewound and
|
|
237
|
+
* the answer is `resume.session_not_found`. `row: null` and `log` are refused (`rewind.invalid_spec`). Absent ⇒ any
|
|
238
|
+
* session under the id. The same member, read the same way, as `CompactSessionRequest.expect`. */
|
|
239
|
+
expect?: SessionRowExpectation;
|
|
234
240
|
}
|
|
235
241
|
/** `Runner.rewindFiles`' answer. A refusal is a thrown `Error` carrying a `code`. */
|
|
236
242
|
export type RewindFilesResult =
|
|
@@ -441,9 +447,9 @@ export interface FileHistoryStore {
|
|
|
441
447
|
/**
|
|
442
448
|
* Converge ONLY the tracked set to the boundary `entryId`: for each tracked file, target-version
|
|
443
449
|
* bytes ⇒ write via `env` (the guarded-write arm and the symlink/parent-chain/kind preflights are
|
|
444
|
-
* the design/381 slice-3
|
|
445
|
-
* overclaimed); deletion marker ⇒ remove;
|
|
446
|
-
* back to its v1 (pristine) version, and a base-unavailable path (DV-14) is REFUSED with reason
|
|
450
|
+
* the design/381 slice-3 preflight family, `applyFileRestoreViaEnv`; an env without the guarded write
|
|
451
|
+
* converges ADVISORY on the TOCTOU axis, stated, never overclaimed); deletion marker ⇒ remove;
|
|
452
|
+
* identical ⇒ untouched; tracked-later-than-target ⇒ fall back to its v1 (pristine) version, and a base-unavailable path (DV-14) is REFUSED with reason
|
|
447
453
|
* `base_unavailable` (left at its current state — never overwritten with a fake baseline).
|
|
448
454
|
* Per-file refusals SKIP that file and are counted, never failing the whole restore (CC form).
|
|
449
455
|
* Paths recorded relative to `root` re-join against the CURRENT root (worktree/moved-cwd safe).
|
|
@@ -568,7 +574,9 @@ export interface FileHistoryStore {
|
|
|
568
574
|
*
|
|
569
575
|
* A HOST MAY STILL CALL IT — the engine's seat covers sessions the engine prepares, and a
|
|
570
576
|
* deployment that copies history between scopes for its own reasons (a migration, a scope rename)
|
|
571
|
-
* is calling the same verb under the same law.
|
|
577
|
+
* is calling the same verb under the same law. The session-deletion cascade is one such caller: before it deletes a
|
|
578
|
+
* session's history it carries that history into each of the session's forks, with the same `conflict` reading (a fork that
|
|
579
|
+
* already received it, or has grown its own, is done) ({@link import("./retention.js").RETENTION_CASCADE}'s file-history row). What a MISSED carry gets is degraded, not broken,
|
|
572
580
|
* and it is worth naming precisely: the new scope starts EMPTY, so nothing the old one tracked is
|
|
573
581
|
* restorable from it. A rewind aimed at a pre-fork boundary answers "no boundary" (honest, typed)
|
|
574
582
|
* instead of converging those files, and the new lineage's own first touch of a path records THAT
|
package/dist/core/gate-lanes.js
CHANGED
|
@@ -10,7 +10,7 @@ import { ASK_USER_QUESTION_TOOL_NAME, isEngineQuestionFace } from "./ask-questio
|
|
|
10
10
|
import { routesContent } from "./tool-catalog-entries.js";
|
|
11
11
|
import { applyPersistedTightening, disclosedRuleSet } from "./persisted-rule-arms.js";
|
|
12
12
|
import { skillAllowDecision, skillRowRefusal } from "./skill-grant.js";
|
|
13
|
-
import { allowRuleShadowOf, withAllowRuleShadow } from "./allow-entry.js";
|
|
13
|
+
import { allowRuleShadowOf, askFallbackMessage, cardDisclosureOf, inheritedAskFallbackMessage, withAllowRuleShadow } from "./allow-entry.js";
|
|
14
14
|
import { CD_GIT_COMPOUND_SENTENCE, changesDirectoryBeforeGit, readOnlyShellVerdict } from "./read-only-shell.js";
|
|
15
15
|
import { readShellCommand } from "./shell-run-candidates.js";
|
|
16
16
|
import { COMMAND_RULE_TOOL, ruleShapeOf } from "./permission-rule-model.js";
|
|
@@ -53,8 +53,13 @@ export async function runGateLanes(pass) {
|
|
|
53
53
|
throw new Error(`a real-approval ask for "${toolName}" reached a park site with no origin word — the origin stamp precedes every park`);
|
|
54
54
|
return { origin: d.origin, ...(org !== undefined ? { org } : {}) };
|
|
55
55
|
};
|
|
56
|
-
const
|
|
56
|
+
const cardQuestionOf = ({ message, matchedAskRule }) => ({
|
|
57
|
+
cardMessage: message,
|
|
58
|
+
...(matchedAskRule !== undefined ? { cardAskRule: matchedAskRule } : {}),
|
|
59
|
+
});
|
|
60
|
+
const carryOf = (d, req) => ({
|
|
57
61
|
...(callSignal !== undefined ? { signal: callSignal } : {}),
|
|
62
|
+
...(d.action === "ask" ? cardQuestionOf(cardDisclosureOf(d, (markedUnresolvable() ? inheritedAskFallbackMessage : askFallbackMessage)(req.toolName))) : {}),
|
|
58
63
|
...(d.action === "ask" && d.denialLimitFallback !== undefined ? { denialLimitFallback: unarmedWindow(d.denialLimitFallback) } : {}),
|
|
59
64
|
...(d.action === "ask" && d.classifierNoRuling !== undefined ? { classifierNoRuling: d.classifierNoRuling } : {}),
|
|
60
65
|
...(d.action === "ask" && d.origin !== undefined ? { origin: d.origin } : {}),
|
|
@@ -66,7 +71,7 @@ export async function runGateLanes(pass) {
|
|
|
66
71
|
const parkAsk = async (d, req, args, safety, liveFaceUnavailable, org) => {
|
|
67
72
|
if (suspendAsk === undefined || d.action !== "ask")
|
|
68
73
|
return undefined;
|
|
69
|
-
const suspended = await parkWith(suspendAsk, [req, args, safety, liveFaceUnavailable, realApprovalOf(d, org), d.allowRuleShadowed, d.decisionReason, d.probeReason, d.probeCause, d.segmentCoverage, d.matchedAskRule, d.probeMandated], carryOf(d));
|
|
74
|
+
const suspended = await parkWith(suspendAsk, [req, args, safety, liveFaceUnavailable, realApprovalOf(d, org), d.allowRuleShadowed, d.decisionReason, d.probeReason, d.probeCause, d.segmentCoverage, d.matchedAskRule, d.probeMandated], carryOf(d, req));
|
|
70
75
|
if (suspended && "parkFailed" in suspended)
|
|
71
76
|
pass.parkFailed = suspended.parkFailed;
|
|
72
77
|
return suspended && !("parkFailed" in suspended) ? { suspend: suspended, preToolContext: pass.preToolContext } : undefined;
|
|
@@ -303,7 +303,8 @@ export type WinnerDecisionTableCoversEveryDecision = AssertAllKeysHandled<Exclud
|
|
|
303
303
|
* to share one seven-word list (`PermissionDeniedSource`) in which `classifier` meant both "the classifier
|
|
304
304
|
* asked" and "the classifier denied".
|
|
305
305
|
* - `policy` — the deployment `ToolPolicy` denied (directly, or re-checking an approved edit), or the
|
|
306
|
-
* approval-edit chain hit its round cap
|
|
306
|
+
* approval-edit chain hit its round cap, or the deployment's cross-boundary posture refused at the allow exit (the
|
|
307
|
+
* call's obligation, read again as it would run, is one no person answered, or the record it owes could not be written).
|
|
307
308
|
* - `hook` — a PreToolUse hook denied, threw, or never answered (the engine's fail-closed block on a
|
|
308
309
|
* hook that made no decision counts as the hook layer's refusal for attribution).
|
|
309
310
|
* - `org` — an organization policy rule denied; or, on a durable resume, the org's current verdict demands a person and
|
|
@@ -58,7 +58,81 @@ export interface AddWorktreeOptions {
|
|
|
58
58
|
* start begins: a run's git bookkeeping is the run's own start and carries the run's table. A read that throws is that
|
|
59
59
|
* step's failure (the add's refuses the mint before anything exists). Absent ⇒ the starts carry none (no run). */
|
|
60
60
|
readFloor?: () => ReadFloor | undefined;
|
|
61
|
+
/** What the env's `destroy()` does with the tree. `"discard"` (default): removes it whatever it holds (`--force`), the
|
|
62
|
+
* caller having decided its changes go; `destroy()` answers nothing. `"keep-if-dirty"`: removes it only when
|
|
63
|
+
* {@link treeKeptBecause} — the judgment `releaseSessionCheckout` reads — finds nothing to keep (no uncommitted file, no file
|
|
64
|
+
* git ignores, no commit past the base the tree was minted at, a readable state), and then without `--force`; `destroy()`
|
|
65
|
+
* answers the tree's {@link ReleasedTree} — a tree with something in it stays where it is, with its branch, and the answer
|
|
66
|
+
* says why (`kept`). Any other value is refused before anything is created (`config.invalid_argument`). */
|
|
67
|
+
onExit?: "discard" | "keep-if-dirty";
|
|
61
68
|
}
|
|
69
|
+
/** The release outcome of one tree — what `destroy()` of an {@link addWorktree} env and the release doors of a session's
|
|
70
|
+
* checkout answer. `branch` is present while the tree's branch still exists after the release. */
|
|
71
|
+
export interface ReleasedTree {
|
|
72
|
+
readonly path: string;
|
|
73
|
+
readonly removed: boolean;
|
|
74
|
+
readonly branch?: string;
|
|
75
|
+
readonly kept?: "dirty" | "ignored" | "commits" | "unverifiable" | "requested" | "not_owned";
|
|
76
|
+
readonly detail?: string;
|
|
77
|
+
}
|
|
78
|
+
/** The reasons {@link treeKeptBecause} answers: a subset of {@link ReleasedTree.kept} (the other two are a door's own). */
|
|
79
|
+
export type TreeKeptReason = Extract<NonNullable<ReleasedTree["kept"]>, "dirty" | "ignored" | "commits" | "unverifiable">;
|
|
80
|
+
/** The first {@link IGNORED_NAMED} ignored paths (each bounded) and how many more — how a tree's ignored files are named wherever
|
|
81
|
+
* a sentence names them (`removeTreeIfClean`'s `detail`, ExitWorktree's reply). */
|
|
82
|
+
export declare function namedIgnored(paths: readonly string[]): string;
|
|
83
|
+
/** What a managed tree holds that removing it would lose, as ONE reading of it answers ({@link treeHoldsOf}): `files` — the entries
|
|
84
|
+
* git lists as changed or untracked; `ignored` — the paths git ignores in it (an `.env`, build output, `node_modules/`); `commits` —
|
|
85
|
+
* how many commits sit past the base the tree was minted at (`undefined`: no base was read, or the count did not answer). */
|
|
86
|
+
export interface TreeHolds {
|
|
87
|
+
readonly files: number;
|
|
88
|
+
readonly ignored: readonly string[];
|
|
89
|
+
readonly commits: number | undefined;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* THE reading of a managed tree's contents, the one every door that removes a tree reads: one status read with
|
|
93
|
+
* `--ignored --untracked-files=normal` (untracked files are listed whatever the repository's `status.showUntrackedFiles` says —
|
|
94
|
+
* `no` would hide them) for the files and the ignored paths, then — when a base commit was read — one count of the commits past
|
|
95
|
+
* it. `undefined` when the status read failed. The verdict is {@link keptByHolds}'s; a door that also says how much the tree
|
|
96
|
+
* holds (ExitWorktree's reply) reads the counts off the same answer. A start that REJECTS (an environment whose `exec` throws, a
|
|
97
|
+
* floor that cannot be read) is read as a failed reading — a tree is kept on a guess, never removed — unless the caller passes
|
|
98
|
+
* `rethrow`: a door whose own state must survive a transient failure to retry it (ExitWorktree keeps its session active) lets the
|
|
99
|
+
* rejection propagate.
|
|
100
|
+
*/
|
|
101
|
+
export declare function treeHoldsOf(env: ExecutionEnv, path: string, baseSha: string | undefined, readFloor?: () => ReadFloor | undefined, opts?: {
|
|
102
|
+
readonly rethrow?: boolean;
|
|
103
|
+
}): Promise<TreeHolds | undefined>;
|
|
104
|
+
/**
|
|
105
|
+
* THE keep verdict over {@link treeHoldsOf}'s reading: why the tree must not be removed, or `undefined` when nothing in it would be
|
|
106
|
+
* lost. A tracked change or an untracked file keeps it (`dirty`); a file git ignores keeps it too (`ignored`), since removing the
|
|
107
|
+
* tree would delete it with it; then a commit past the base keeps it (`commits`). A reading that failed, and a base that was never
|
|
108
|
+
* read or a count that did not answer, are `unverifiable` — nothing is removed on a guess.
|
|
109
|
+
*/
|
|
110
|
+
export declare function keptByHolds(holds: TreeHolds | undefined): {
|
|
111
|
+
readonly kept: TreeKeptReason;
|
|
112
|
+
readonly detail?: string;
|
|
113
|
+
} | undefined;
|
|
114
|
+
/** The keep verdict of the tree at `path` ({@link keptByHolds} over {@link treeHoldsOf}): every removing door that keeps changes
|
|
115
|
+
* reads this one answer. */
|
|
116
|
+
export declare function treeKeptBecause(env: ExecutionEnv, path: string, baseSha: string | undefined, readFloor?: () => ReadFloor | undefined): Promise<{
|
|
117
|
+
readonly kept: TreeKeptReason;
|
|
118
|
+
readonly detail?: string;
|
|
119
|
+
} | undefined>;
|
|
120
|
+
/** `{ branch }` while `branch` still exists in the repository at `repository`, else `{}`. */
|
|
121
|
+
export declare function branchLeftOf(env: ExecutionEnv, repository: string, branch: string, readFloor?: () => ReadFloor | undefined): Promise<{
|
|
122
|
+
branch?: string;
|
|
123
|
+
}>;
|
|
124
|
+
/**
|
|
125
|
+
* THE keeping removal of a managed tree: {@link treeKeptBecause} first (a tree with something in it is kept and named, its branch
|
|
126
|
+
* left), then `stillOurs` — a door's own re-read right before the removal, answering the outcome when the tree is no longer
|
|
127
|
+
* its to remove — then the removal without `--force` (a write landing after the judgment keeps the tree: `unverifiable`, with
|
|
128
|
+
* git's words), its branch deleted with it only while the branch sits at the base commit.
|
|
129
|
+
*/
|
|
130
|
+
export declare function removeTreeIfClean(env: ExecutionEnv, tree: {
|
|
131
|
+
readonly path: string;
|
|
132
|
+
readonly repository: string;
|
|
133
|
+
readonly branch: string;
|
|
134
|
+
readonly baseSha: string | undefined;
|
|
135
|
+
}, readFloor: (() => ReadFloor | undefined) | undefined, stillOurs?: () => Promise<ReleasedTree | undefined>): Promise<ReleasedTree>;
|
|
62
136
|
/** Single-quote a path for the `exec` command STRING (the Shell API takes a command string, not argv). */
|
|
63
137
|
export declare function shq(s: string): string;
|
|
64
138
|
/**
|
|
@@ -105,8 +179,25 @@ how: "discard" | "clean"): Promise<{
|
|
|
105
179
|
* arbitrary shell access (bash can still reach the host — sandbox separately); UNCOMMITTED changes in the base
|
|
106
180
|
* repo are absent in the child (the tree starts at the base commit); a worktree orphaned by a process crash is reaped by
|
|
107
181
|
* {@link pruneWorktrees} (userland — there is no Runner hook for post-kill cleanup).
|
|
182
|
+
*
|
|
183
|
+
* Under `onExit: "keep-if-dirty"`, `destroy()` answers the tree's {@link ReleasedTree}: `removed: true` once it is gone, or
|
|
184
|
+
* `removed: false` with the reason it was kept (the tree and its branch left in place for the caller to inspect or merge).
|
|
185
|
+
* Under `"discard"` (the default) it answers nothing: the tree is gone, or `destroy()` rejects.
|
|
108
186
|
*/
|
|
109
|
-
export declare function addWorktree(baseEnv: ExecutionEnv, opts: AddWorktreeOptions
|
|
187
|
+
export declare function addWorktree(baseEnv: ExecutionEnv, opts: AddWorktreeOptions & {
|
|
188
|
+
readonly onExit: "keep-if-dirty";
|
|
189
|
+
}): Promise<{
|
|
190
|
+
env: ExecutionEnv & {
|
|
191
|
+
destroy(): Promise<ReleasedTree>;
|
|
192
|
+
};
|
|
193
|
+
worktreeDir: string;
|
|
194
|
+
name: string;
|
|
195
|
+
branch: string;
|
|
196
|
+
baseSha?: string;
|
|
197
|
+
}>;
|
|
198
|
+
export declare function addWorktree(baseEnv: ExecutionEnv, opts: AddWorktreeOptions & {
|
|
199
|
+
readonly onExit?: "discard";
|
|
200
|
+
}): Promise<{
|
|
110
201
|
env: ExecutionEnv & {
|
|
111
202
|
destroy(): Promise<void>;
|
|
112
203
|
};
|
|
@@ -66,6 +66,73 @@ export function managedWorktreeBranchOf(dir) {
|
|
|
66
66
|
return undefined;
|
|
67
67
|
return `${WORKTREE_BRANCH_PREFIX}/${dir.slice(dir.lastIndexOf("/") + 1)}`;
|
|
68
68
|
}
|
|
69
|
+
async function gitAt(env, command, cwd, readFloor, rethrow = false) {
|
|
70
|
+
try {
|
|
71
|
+
const floor = readFloor?.();
|
|
72
|
+
const r = await env.exec(command, { cwd, ...(floor !== undefined ? { readFloor: floor } : {}) });
|
|
73
|
+
return r.ok ? r.value : undefined;
|
|
74
|
+
}
|
|
75
|
+
catch (err) {
|
|
76
|
+
if (rethrow)
|
|
77
|
+
throw err;
|
|
78
|
+
return undefined;
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
const IGNORED_NAMED = 5;
|
|
82
|
+
export function namedIgnored(paths) {
|
|
83
|
+
const named = paths.slice(0, IGNORED_NAMED).map((p) => p.slice(0, 120)).join(", ");
|
|
84
|
+
return paths.length > IGNORED_NAMED ? `${named} and ${paths.length - IGNORED_NAMED} more` : named;
|
|
85
|
+
}
|
|
86
|
+
function ignoredDetail(paths) {
|
|
87
|
+
return `the tree holds files git ignores (${namedIgnored(paths)}), which removing it would delete — delete or move them, then release again`;
|
|
88
|
+
}
|
|
89
|
+
export async function treeHoldsOf(env, path, baseSha, readFloor, opts) {
|
|
90
|
+
const rethrow = opts?.rethrow === true;
|
|
91
|
+
const status = await gitAt(env, "git status --porcelain --ignored --untracked-files=normal", path, readFloor, rethrow);
|
|
92
|
+
if (status === undefined || status.exitCode !== 0)
|
|
93
|
+
return undefined;
|
|
94
|
+
const entries = status.stdout.split("\n").filter((line) => line !== "");
|
|
95
|
+
const ignored = entries.filter((line) => line.startsWith("!! ")).map((line) => line.slice(3));
|
|
96
|
+
let commits;
|
|
97
|
+
if (baseSha !== undefined) {
|
|
98
|
+
const ahead = await gitAt(env, `git rev-list --count ${shq(`${baseSha}..HEAD`)}`, path, readFloor, rethrow);
|
|
99
|
+
const counted = ahead !== undefined && ahead.exitCode === 0 ? Number.parseInt(ahead.stdout.trim(), 10) : Number.NaN;
|
|
100
|
+
if (Number.isFinite(counted))
|
|
101
|
+
commits = counted;
|
|
102
|
+
}
|
|
103
|
+
return { files: entries.length - ignored.length, ignored, commits };
|
|
104
|
+
}
|
|
105
|
+
export function keptByHolds(holds) {
|
|
106
|
+
if (holds === undefined)
|
|
107
|
+
return { kept: "unverifiable" };
|
|
108
|
+
if (holds.files > 0)
|
|
109
|
+
return { kept: "dirty" };
|
|
110
|
+
if (holds.ignored.length > 0)
|
|
111
|
+
return { kept: "ignored", detail: ignoredDetail(holds.ignored) };
|
|
112
|
+
if (holds.commits === undefined)
|
|
113
|
+
return { kept: "unverifiable" };
|
|
114
|
+
return holds.commits > 0 ? { kept: "commits" } : undefined;
|
|
115
|
+
}
|
|
116
|
+
export async function treeKeptBecause(env, path, baseSha, readFloor) {
|
|
117
|
+
return keptByHolds(await treeHoldsOf(env, path, baseSha, readFloor));
|
|
118
|
+
}
|
|
119
|
+
export async function branchLeftOf(env, repository, branch, readFloor) {
|
|
120
|
+
const ref = await gitAt(env, `git rev-parse --verify --quiet ${shq(`refs/heads/${branch}`)}`, repository, readFloor);
|
|
121
|
+
return ref !== undefined && ref.exitCode === 0 ? { branch } : {};
|
|
122
|
+
}
|
|
123
|
+
export async function removeTreeIfClean(env, tree, readFloor, stillOurs) {
|
|
124
|
+
const { path, repository, branch, baseSha } = tree;
|
|
125
|
+
const keep = await treeKeptBecause(env, path, baseSha, readFloor);
|
|
126
|
+
if (keep !== undefined)
|
|
127
|
+
return { path, removed: false, branch, ...keep };
|
|
128
|
+
const notOurs = await stillOurs?.();
|
|
129
|
+
if (notOurs !== undefined)
|
|
130
|
+
return notOurs;
|
|
131
|
+
const removed = await removeManagedWorktree(env, repository, path, baseSha !== undefined ? { name: branch, baseSha } : undefined, readFloor, "clean");
|
|
132
|
+
if (!removed.ok)
|
|
133
|
+
return { path, removed: false, kept: "unverifiable", branch, detail: removed.detail.trim().slice(0, 300) };
|
|
134
|
+
return { path, removed: true, ...(await branchLeftOf(env, repository, branch, readFloor)) };
|
|
135
|
+
}
|
|
69
136
|
export function shq(s) {
|
|
70
137
|
return `'${s.replace(/'/g, "'\\''")}'`;
|
|
71
138
|
}
|
|
@@ -121,6 +188,10 @@ export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, bran
|
|
|
121
188
|
}
|
|
122
189
|
}
|
|
123
190
|
export async function addWorktree(baseEnv, opts) {
|
|
191
|
+
const onExit = opts.onExit ?? "discard";
|
|
192
|
+
if (onExit !== "discard" && onExit !== "keep-if-dirty") {
|
|
193
|
+
throw Object.assign(new Error(`addWorktree: onExit must be "discard" or "keep-if-dirty"; nothing was created`), { code: "config.invalid_argument" });
|
|
194
|
+
}
|
|
124
195
|
const { worktreeDir, name, branch, anchor, baseSha } = await mintManagedWorktree(baseEnv, opts);
|
|
125
196
|
const branchRule = baseSha !== undefined ? { name: branch, baseSha } : undefined;
|
|
126
197
|
let inner;
|
|
@@ -133,18 +204,28 @@ export async function addWorktree(baseEnv, opts) {
|
|
|
133
204
|
}
|
|
134
205
|
const innerDestroy = inner.destroy;
|
|
135
206
|
const env = inner;
|
|
207
|
+
const release = async () => {
|
|
208
|
+
if (onExit === "keep-if-dirty")
|
|
209
|
+
return removeTreeIfClean(baseEnv, { path: worktreeDir, repository: anchor, branch, baseSha }, opts.readFloor);
|
|
210
|
+
const removed = await removeManagedWorktree(baseEnv, anchor, worktreeDir, branchRule, opts.readFloor, "discard");
|
|
211
|
+
if (!removed.ok) {
|
|
212
|
+
throw new Error(`git worktree remove failed twice — ${worktreeDir} is now an orphan (dir + registration remain; ` +
|
|
213
|
+
`\`git worktree prune\` cannot reclaim it while the dir exists — remove it manually): ${removed.detail}`);
|
|
214
|
+
}
|
|
215
|
+
};
|
|
136
216
|
env.destroy = async () => {
|
|
217
|
+
let innerFailure;
|
|
137
218
|
try {
|
|
138
219
|
if (typeof innerDestroy === "function")
|
|
139
220
|
await innerDestroy.call(inner);
|
|
140
221
|
}
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
if (!removed.ok) {
|
|
144
|
-
throw new Error(`git worktree remove failed twice — ${worktreeDir} is now an orphan (dir + registration remain; ` +
|
|
145
|
-
`\`git worktree prune\` cannot reclaim it while the dir exists — remove it manually): ${removed.detail}`);
|
|
146
|
-
}
|
|
222
|
+
catch (error) {
|
|
223
|
+
innerFailure = { error };
|
|
147
224
|
}
|
|
225
|
+
const released = await release();
|
|
226
|
+
if (innerFailure !== undefined)
|
|
227
|
+
throw innerFailure.error;
|
|
228
|
+
return released;
|
|
148
229
|
};
|
|
149
230
|
return { env, worktreeDir, name, branch, ...(baseSha !== undefined ? { baseSha } : {}) };
|
|
150
231
|
}
|
|
@@ -61,7 +61,11 @@ export declare function governanceRetryClass(code: string): GovernanceRetryClass
|
|
|
61
61
|
* `write` (`config.egress_requires_write_effect` — also minted, same meaning, for a protocol tool's resolved
|
|
62
62
|
* axes), a name the run reserves for a tool the engine injects (`config.reserved_tool_name` — structured output,
|
|
63
63
|
* the skill tool, tool search, the offload reader, an injected protocol tool; `runGoal`'s completion tool, which
|
|
64
|
-
* refuses before any run).
|
|
64
|
+
* refuses before any run). `config.tool_roster_bound` is also the roster's own bound: a leg whose mounted face would mint more
|
|
65
|
+
* than `TOOL_ROSTER_MAX_ENTRIES` rows is refused where prepare mints the roster, after the mounts and before any row; at
|
|
66
|
+
* run time the same judge refuses a domain swap over it, and the MCP refresh / re-dial reads that refusal as the server's
|
|
67
|
+
* empty listing, not as the run's failure. Each prepare-time refusal ends the run `failed` with the code on
|
|
68
|
+
* `terminal.code`. A caller-shape refusal, not a policy
|
|
65
69
|
* verdict: none of these is a governance code ({@link GOVERNANCE_CODES}); re-issuing the same declaration
|
|
66
70
|
* changes nothing. Every mint site at the door types its code against this set.
|
|
67
71
|
*/
|
|
@@ -125,6 +129,11 @@ export type RuleQuarantineReason = Exclude<RuleSyncDropReason, "own_actor_forged
|
|
|
125
129
|
* routing property into an entitlement vocabulary, and the two answer different questions: several
|
|
126
130
|
* codes below carry a session attribution while the person entitled to the fact is still the
|
|
127
131
|
* operator (a failed offload write, a routing fallback, a consolidation recommendation).
|
|
132
|
+
*
|
|
133
|
+
* Entitlement is who has the right to know, not who can fix it. A fact that changed what THIS session's run did —
|
|
134
|
+
* a deny row not kept under a recursive read, a model word the person named that the catalog does not hold, an input
|
|
135
|
+
* withheld from the model — is the session user's to hear even when the remedy is the operator's; a row stays
|
|
136
|
+
* `"operator"` only when the run itself is unchanged and the fact is the deployment's own.
|
|
128
137
|
*/
|
|
129
138
|
export type NoticeAudience = "user" | "operator";
|
|
130
139
|
/**
|
|
@@ -145,7 +154,7 @@ export type NoticeAudience = "user" | "operator";
|
|
|
145
154
|
* the union's catalog ({@link EngineNotice.code}). The groups below say only which family a row joins,
|
|
146
155
|
* so the catalog is not written a second time here and the two cannot drift.
|
|
147
156
|
*/
|
|
148
|
-
export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.read_floor_confinement_unavailable", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "config.legacy_tool_name", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "delegation.resume_lane_missing", "delegation.delivery_discarded", "mcp.injection_dropped", "
|
|
157
|
+
export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.read_floor_confinement_unavailable", "config.inherit_env_declared_late", "config.command_sandbox_unavailable", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "config.legacy_tool_name", "config.toolpolicy.unmatched_names", "config.agent.unknown_tool", "permission.allowed_tool_not_granted", "mods.registration_refused", "mods.display_withheld", "mods.stop_ended", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "delegation.resume_lane_missing", "delegation.delivery_discarded", "mcp.injection_dropped", "protocol.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "mcp.server_unavailable", "mcp.credential_echoed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.harvest_refused", "memory.harvest_conflict", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "model.fallback", "context.tool_turn_repaired", "context.media_removed", "context.tool_schema_removed", "context.messages_omitted", "instructions.withheld", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "approval.approver_defect", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "memory.mount_failed", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "tool_result.media_persisted", "config.image_processor_unavailable", "fs.staging_file_left", "fs.staging_file_swept", "session.lineage_rerooted", "rewind.boundary_unrecorded", "verify.verifier_is_implementer", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped", "model.context_window_assumed", "config.store_ephemeral"];
|
|
149
158
|
/** A catalogued code (see {@link ENGINE_NOTICE_CODES}); {@link NOTICE_MINTER} says who mints it. NOT the type of
|
|
150
159
|
* `EngineNotice.code`, which stays `string` — a host forwarding its own notices through the same
|
|
151
160
|
* sink is a supported shape, and narrowing that field would break it. */
|
|
@@ -191,6 +200,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
|
|
|
191
200
|
readonly "route.credential_origin_mismatch": "user";
|
|
192
201
|
readonly "approval.read_root_granted": "user";
|
|
193
202
|
readonly "approval.read_root_grant_rejected": "user";
|
|
203
|
+
readonly "approval.approver_defect": "operator";
|
|
194
204
|
readonly "config.durable_gate_unavailable": "user";
|
|
195
205
|
readonly "config.permission_mode_unavailable": "user";
|
|
196
206
|
readonly "permission.ask_released_by_mode": "user";
|
|
@@ -199,10 +209,15 @@ declare const NOTICE_AUDIENCE_TABLE: {
|
|
|
199
209
|
readonly "permission.rule_row_dropped": "user";
|
|
200
210
|
readonly "config.session_rules_earlier_grammar": "user";
|
|
201
211
|
readonly "config.legacy_tool_name": "user";
|
|
212
|
+
readonly "config.toolpolicy.unmatched_names": "user";
|
|
213
|
+
readonly "config.agent.unknown_tool": "user";
|
|
202
214
|
readonly "permission.allowed_tool_not_granted": "user";
|
|
203
215
|
readonly "mods.registration_refused": "user";
|
|
216
|
+
readonly "mods.display_withheld": "user";
|
|
217
|
+
readonly "mods.stop_ended": "user";
|
|
204
218
|
readonly "memory.capture_opted_out": "user";
|
|
205
219
|
readonly "memory.capture_optout_unpersisted": "user";
|
|
220
|
+
readonly "memory.mount_failed": "user";
|
|
206
221
|
readonly "memory.consolidation_withheld": "operator";
|
|
207
222
|
readonly "delegation.ask_unresolvable": "user";
|
|
208
223
|
readonly "inherit_env.names_withheld": "user";
|
|
@@ -224,8 +239,10 @@ declare const NOTICE_AUDIENCE_TABLE: {
|
|
|
224
239
|
readonly "config.write_protection_target_view_absent": "operator";
|
|
225
240
|
readonly "config.path_view_unresolved": "operator";
|
|
226
241
|
readonly "config.execution_env_capability_invalid": "operator";
|
|
227
|
-
readonly "config.read_deny_floor_unkept": "
|
|
242
|
+
readonly "config.read_deny_floor_unkept": "user";
|
|
228
243
|
readonly "config.read_floor_confinement_unavailable": "operator";
|
|
244
|
+
readonly "config.inherit_env_declared_late": "operator";
|
|
245
|
+
readonly "config.command_sandbox_unavailable": "user";
|
|
229
246
|
readonly "config.tool_card_undeclared": "operator";
|
|
230
247
|
readonly "config.tool_face_undeclared": "operator";
|
|
231
248
|
readonly "config.tool_face_invalid": "operator";
|
|
@@ -243,9 +260,10 @@ declare const NOTICE_AUDIENCE_TABLE: {
|
|
|
243
260
|
readonly "delegation.delivery_discarded": "operator";
|
|
244
261
|
readonly "checkpoint.execution_outcome_unrecorded": "operator";
|
|
245
262
|
readonly "mcp.injection_dropped": "user";
|
|
246
|
-
readonly "
|
|
263
|
+
readonly "protocol.revocation_probe_failed": "operator";
|
|
247
264
|
readonly "mcp.server_redialed": "operator";
|
|
248
265
|
readonly "mcp.authorization_required": "user";
|
|
266
|
+
readonly "mcp.server_unavailable": "user";
|
|
249
267
|
readonly "mcp.credential_echoed": "operator";
|
|
250
268
|
readonly "workflow.governance_key_stripped": "operator";
|
|
251
269
|
readonly "workflow.agent_option_ignored": "operator";
|
|
@@ -266,23 +284,30 @@ declare const NOTICE_AUDIENCE_TABLE: {
|
|
|
266
284
|
readonly "route.tool_call_id_folded": "operator";
|
|
267
285
|
readonly "route.extra_body_reserved_dropped": "operator";
|
|
268
286
|
readonly "model.capability_downgraded": "user";
|
|
269
|
-
readonly "model.role_defaulted": "
|
|
287
|
+
readonly "model.role_defaulted": "user";
|
|
288
|
+
readonly "model.fallback": "user";
|
|
270
289
|
readonly "context.tool_turn_repaired": "operator";
|
|
271
290
|
readonly "context.media_removed": "user";
|
|
272
291
|
readonly "context.tool_schema_removed": "user";
|
|
292
|
+
readonly "context.messages_omitted": "user";
|
|
293
|
+
readonly "instructions.withheld": "user";
|
|
273
294
|
readonly "skills.listing_truncated": "operator";
|
|
274
295
|
readonly "agents.listing_truncated": "operator";
|
|
275
296
|
readonly "tool_result.offload_put_failed": "operator";
|
|
276
297
|
readonly "tool_result.media_refused": "operator";
|
|
298
|
+
readonly "tool_result.media_persisted": "operator";
|
|
277
299
|
readonly "config.image_processor_unavailable": "operator";
|
|
278
300
|
readonly "fs.staging_file_left": "operator";
|
|
279
301
|
readonly "fs.staging_file_swept": "operator";
|
|
280
302
|
readonly "session.lineage_rerooted": "user";
|
|
303
|
+
readonly "rewind.boundary_unrecorded": "user";
|
|
304
|
+
readonly "verify.verifier_is_implementer": "user";
|
|
281
305
|
readonly "config.forward_sink_failed": "operator";
|
|
282
|
-
readonly "instructions.source_changed": "user";
|
|
283
306
|
readonly "server.model_unreachable": "user";
|
|
284
307
|
readonly "permission.entry_mode_clamped": "user";
|
|
308
|
+
readonly "model.context_window_assumed": "user";
|
|
285
309
|
readonly "memory.layer_locked_legacy": "operator";
|
|
310
|
+
readonly "config.store_ephemeral": "user";
|
|
286
311
|
};
|
|
287
312
|
/** Compile-time fence: every catalogued code has an audience row (and, via `satisfies`, only those). */
|
|
288
313
|
export type AudienceTableCoversEveryNoticeCode = AssertAllKeysHandled<Exclude<EngineNoticeCode, keyof typeof NOTICE_AUDIENCE_TABLE>>;
|
|
@@ -328,6 +353,8 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
328
353
|
readonly "config.execution_env_capability_invalid": "engine";
|
|
329
354
|
readonly "config.read_deny_floor_unkept": "engine";
|
|
330
355
|
readonly "config.read_floor_confinement_unavailable": "engine";
|
|
356
|
+
readonly "config.inherit_env_declared_late": "engine";
|
|
357
|
+
readonly "config.command_sandbox_unavailable": "engine";
|
|
331
358
|
readonly "config.tool_card_undeclared": "engine";
|
|
332
359
|
readonly "config.tool_face_undeclared": "engine";
|
|
333
360
|
readonly "config.tool_face_invalid": "engine";
|
|
@@ -347,8 +374,12 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
347
374
|
readonly "permission.rule_row_dropped": "engine";
|
|
348
375
|
readonly "config.session_rules_earlier_grammar": "engine";
|
|
349
376
|
readonly "config.legacy_tool_name": "engine";
|
|
377
|
+
readonly "config.toolpolicy.unmatched_names": "engine";
|
|
378
|
+
readonly "config.agent.unknown_tool": "engine";
|
|
350
379
|
readonly "permission.allowed_tool_not_granted": "engine";
|
|
351
380
|
readonly "mods.registration_refused": "engine";
|
|
381
|
+
readonly "mods.display_withheld": "engine";
|
|
382
|
+
readonly "mods.stop_ended": "engine";
|
|
352
383
|
readonly "peer.inbound_disposition": "engine";
|
|
353
384
|
readonly "peer.held_settled": "engine";
|
|
354
385
|
readonly "peer.idle_subscription": "engine";
|
|
@@ -364,9 +395,10 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
364
395
|
readonly "delegation.resume_lane_missing": "engine";
|
|
365
396
|
readonly "delegation.delivery_discarded": "engine";
|
|
366
397
|
readonly "mcp.injection_dropped": "engine";
|
|
367
|
-
readonly "
|
|
398
|
+
readonly "protocol.revocation_probe_failed": "engine";
|
|
368
399
|
readonly "mcp.server_redialed": "engine";
|
|
369
400
|
readonly "mcp.authorization_required": "engine";
|
|
401
|
+
readonly "mcp.server_unavailable": "engine";
|
|
370
402
|
readonly "mcp.credential_echoed": "engine";
|
|
371
403
|
readonly "workflow.governance_key_stripped": "engine";
|
|
372
404
|
readonly "workflow.agent_option_ignored": "engine";
|
|
@@ -400,9 +432,12 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
400
432
|
readonly "route.extra_body_reserved_dropped": "engine";
|
|
401
433
|
readonly "model.capability_downgraded": "engine";
|
|
402
434
|
readonly "model.role_defaulted": "engine";
|
|
435
|
+
readonly "model.fallback": "engine";
|
|
403
436
|
readonly "context.tool_turn_repaired": "engine";
|
|
404
437
|
readonly "context.media_removed": "engine";
|
|
405
438
|
readonly "context.tool_schema_removed": "engine";
|
|
439
|
+
readonly "context.messages_omitted": "engine";
|
|
440
|
+
readonly "instructions.withheld": "engine";
|
|
406
441
|
readonly "task.user_steer_undrained": "engine";
|
|
407
442
|
readonly "task.user_followup_undrained": "engine";
|
|
408
443
|
readonly "steering.parked_input_blocked": "engine";
|
|
@@ -413,20 +448,26 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
413
448
|
readonly "task.tool_turn_incomplete": "engine";
|
|
414
449
|
readonly "approval.read_root_granted": "engine";
|
|
415
450
|
readonly "approval.read_root_grant_rejected": "engine";
|
|
451
|
+
readonly "approval.approver_defect": "engine";
|
|
416
452
|
readonly "memory.capture_opted_out": "engine";
|
|
417
453
|
readonly "memory.capture_optout_unpersisted": "engine";
|
|
454
|
+
readonly "memory.mount_failed": "engine";
|
|
418
455
|
readonly "skills.listing_truncated": "engine";
|
|
419
456
|
readonly "agents.listing_truncated": "engine";
|
|
420
457
|
readonly "tool_result.offload_put_failed": "engine";
|
|
421
458
|
readonly "tool_result.media_refused": "engine";
|
|
459
|
+
readonly "tool_result.media_persisted": "engine";
|
|
422
460
|
readonly "config.image_processor_unavailable": "engine";
|
|
423
461
|
readonly "fs.staging_file_left": "engine";
|
|
424
462
|
readonly "fs.staging_file_swept": "engine";
|
|
425
463
|
readonly "session.lineage_rerooted": "engine";
|
|
426
|
-
readonly "
|
|
464
|
+
readonly "rewind.boundary_unrecorded": "engine";
|
|
465
|
+
readonly "verify.verifier_is_implementer": "engine";
|
|
427
466
|
readonly "memory.layer_locked_legacy": "server";
|
|
428
467
|
readonly "server.model_unreachable": "server";
|
|
429
468
|
readonly "permission.entry_mode_clamped": "server";
|
|
469
|
+
readonly "model.context_window_assumed": "server";
|
|
470
|
+
readonly "config.store_ephemeral": "server";
|
|
430
471
|
};
|
|
431
472
|
/** Compile-time fence: every catalogued code has a minter row (and, via `satisfies`, only those). */
|
|
432
473
|
export type MinterTableCoversEveryNoticeCode = AssertAllKeysHandled<Exclude<EngineNoticeCode, keyof typeof NOTICE_MINTER_TABLE>>;
|