@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
|
@@ -1,6 +1,7 @@
|
|
|
1
|
-
import { type AskOrigin, type AssertAllKeysHandled } from "./ask-origin.js";
|
|
1
|
+
import { type AskClass, type AskOrigin, type AssertAllKeysHandled } from "./ask-origin.js";
|
|
2
2
|
import { type EngineAttestation } from "./engine-attestation.js";
|
|
3
3
|
import { type ReadRootGrantScreen } from "./read-root-grant-screen.js";
|
|
4
|
+
import { type ApprovalWordsSeat } from "./approval-words.js";
|
|
4
5
|
import { type DecidedVia, type Settlement } from "./gate-outcome.js";
|
|
5
6
|
export { policyCannotAnswer, rowDemandsAPerson } from "./real-approval.js";
|
|
6
7
|
import { type BindingFault } from "./canonical-json.js";
|
|
@@ -242,6 +243,24 @@ export declare function advertisedWritableRootsSeat(seat: {
|
|
|
242
243
|
export declare function exemptRootsSeat(exemptRoots: readonly string[]): {
|
|
243
244
|
exemptRoots: readonly string[];
|
|
244
245
|
};
|
|
246
|
+
/** The facts a leg stamps on a call it judges, read at the moment of each judgment (the leg's cells move: the tracked cwd, the
|
|
247
|
+
* advertised-directory ledger). Every member is optional — a leg without hands has no roster face, cwd or root. */
|
|
248
|
+
export interface CallFacts {
|
|
249
|
+
/** The leg's budget snapshot (`ToolCallRequest.budget`). */
|
|
250
|
+
budget?: ToolCallRequest["budget"] | undefined;
|
|
251
|
+
/** The roster's face for the judged tool (a containment fence admits a write only by the tool's own declared path target). */
|
|
252
|
+
face?: ToolCallFace | undefined;
|
|
253
|
+
cwd?: string | undefined;
|
|
254
|
+
root?: string | undefined;
|
|
255
|
+
advertisedWritableDirs?: {
|
|
256
|
+
readonly roots: readonly string[];
|
|
257
|
+
} | undefined;
|
|
258
|
+
exemptRoots?: readonly string[] | undefined;
|
|
259
|
+
}
|
|
260
|
+
/** The request members {@link CallFacts} stamp: the ONE reading every request a leg hands a policy goes through — the live gate's
|
|
261
|
+
* call, the parked call's re-adjudication, the resumed call's belts, and every synthetic probe (whose verdict must be the
|
|
262
|
+
* verdict the model's own call would get). The call's own members (name, args, id, grant-binding words) are not leg facts. */
|
|
263
|
+
export declare function callFactsSeat(f: CallFacts): Pick<ToolCallRequest, "budget" | "face" | "cwd" | "root" | "advertisedWritableRoots" | "exemptRoots">;
|
|
245
264
|
/** Declared beside the receipt's list (decision-receipt.ts) — a new member added to either side is a compile error rather
|
|
246
265
|
* than a silent drift between the type and the screen; re-exported here, the module every consumer of the decision reads. */
|
|
247
266
|
export type { DecisionReason };
|
|
@@ -283,7 +302,7 @@ export declare const APPROVER_ATTRIBUTION_MAX_CHARS = 256;
|
|
|
283
302
|
* TRANSCRIPTION of what the approval channel said about its own settlement — the channel (a server's
|
|
284
303
|
* approval card, an HMAC-verified callback, an operator console) is where identity is established, and
|
|
285
304
|
* a library that holds no identity surface cannot second-guess it. What core owns is that the value is
|
|
286
|
-
* a value: a string, bounded, free of control bytes, or else loudly refused.
|
|
305
|
+
* a value: a string, bounded, free of control bytes, holding a visible character, or else loudly refused.
|
|
287
306
|
*
|
|
288
307
|
* Returns `{}` for "nothing supplied" (absent, and an empty string — an id of no characters is the
|
|
289
308
|
* absence of an id, the same truthiness fold the deny-note seat uses), `{ approver }` for a value to
|
|
@@ -378,14 +397,15 @@ export type PermissionResult = {
|
|
|
378
397
|
* decision that states it is refused at the receipt); a DISPLAY member: the approval card and the park row render it,
|
|
379
398
|
* nothing reads it to decide, and the classifier never sees it (it is not part of `message`). Absent ⇒ no member matched. */
|
|
380
399
|
allowRuleShadowed?: readonly import("./allow-rule-shadow.js").AllowRuleShadow[];
|
|
381
|
-
/**
|
|
382
|
-
* probe
|
|
383
|
-
*
|
|
384
|
-
*
|
|
385
|
-
*
|
|
386
|
-
* a matching allow rule did not clear a `probe_mandate` ask, on the card and in the parked row alike.
|
|
387
|
-
*
|
|
388
|
-
*
|
|
400
|
+
/** Disclosure (additive): the account of a FINDING about this call — a deployment reversibility probe's
|
|
401
|
+
* `reason` (why the probe did not clear the call) or the engine's read station's account of what it found. ENGINE-STAMPED
|
|
402
|
+
* by the gate after the receipt: at the irreversibility tighten (which constructs this decision wholesale), already
|
|
403
|
+
* neutralized + capped there — a `"maybe"` tier whose probe supplied no cause, and the `"always"` tier (which runs no
|
|
404
|
+
* probe), leave it absent —, and beside a mandate merged onto an ask another layer raised: it is the one sentence that
|
|
405
|
+
* says why a matching allow rule did not clear a `probe_mandate` ask, on the card and in the parked row alike. No policy
|
|
406
|
+
* or hook states it (a STAMP member: a decision that carries one is refused at the receipt) — an asker's own words ride
|
|
407
|
+
* the ask's `message`, which the receipt makes its `askReasons` entry. DISPLAY-ONLY like {@link allowRuleShadowed}:
|
|
408
|
+
* nothing reads this member to decide anything. */
|
|
389
409
|
probeReason?: string;
|
|
390
410
|
/** This ask puts a person's edit back to the person: the restriction chain would not run it as written and accepts it
|
|
391
411
|
* only as {@link import("./rewrite-rejudge.js").EditRewritten.acceptableForm}, the bytes this ask presents. ENGINE-MINTED by
|
|
@@ -412,7 +432,8 @@ export type PermissionResult = {
|
|
|
412
432
|
crossBoundaryMandated?: true;
|
|
413
433
|
/** This ask is MANDATED — no persisted allow rule and no STANDING ANSWER (a release remembered from an
|
|
414
434
|
* earlier call, at any scope, a session included) may retire it; only an answer produced for THIS call
|
|
415
|
-
* clears it — a person, a hook, a deployment's blanket `onAsk: "allow"` seat
|
|
435
|
+
* clears it — a person, a hook, a deployment's blanket `onAsk: "allow"` seat or the class table a seat declares
|
|
436
|
+
* ({@link declareClassAnswers}: it answers each call by that call's classes, remembering nothing), or the live deciders the
|
|
416
437
|
* ask's class row admits ({@link import("./ask-origin.js").MODE_ARBITRATION}); {@link requiresRealApproval}
|
|
417
438
|
* is the stronger demand that also refuses the blanket seat. ENGINE-STAMPED at the gate's single origin stamp from the ONE derivation
|
|
418
439
|
* the approval card's rule-offer word also reads ({@link import("./ask-origin.js").ruleClearanceOf},
|
|
@@ -436,10 +457,11 @@ export type PermissionResult = {
|
|
|
436
457
|
* hesitation, so a classifier verdict must not be the thing that clears it. A policy self-declaring the member only
|
|
437
458
|
* ever OPTS ITS OWN ask OUT of classifier auto-resolution (tightening — the false-claim direction is safe, unlike the
|
|
438
459
|
* engine-stamped `"hook"` word whose risk was laundering provenance AWAY). {@link combinePolicies} carries it onto the
|
|
439
|
-
* surviving ask when ANY folded-away concurrent ask bore it (monotone, tighten-only)
|
|
440
|
-
*
|
|
441
|
-
*
|
|
442
|
-
*
|
|
460
|
+
* surviving ask when ANY folded-away concurrent ask bore it (monotone, tighten-only). It is the ONE input of the
|
|
461
|
+
* `ask_rule` origin word ({@link origin}): a minter raising an ask for a written rule (a person's settings rule, an
|
|
462
|
+
* operator's must-ask list) that leaves it unset gets `policy` there, indistinguishable from hesitation. The text
|
|
463
|
+
* itself rides the ask as written to the approval request ({@link AskRequest.matchedAskRule}) and to the parked row
|
|
464
|
+
* (`PendingAction.tool_approval.cardAskRule`); the refusal's gate record carries the origin word only. */
|
|
443
465
|
matchedAskRule?: string;
|
|
444
466
|
/** design/252 G-2 (additive): the RULE-PROVENANCE evidence behind this ask — see
|
|
445
467
|
* {@link AskRuleEvidence}. A STAMP member, written inside the gate once, after the org layer and the
|
|
@@ -963,6 +985,7 @@ export type ApprovalSeatOutcome = boolean | (Extract<AskOutcome, {
|
|
|
963
985
|
}> & {
|
|
964
986
|
updatedInput?: never;
|
|
965
987
|
readRootGrant?: never;
|
|
988
|
+
feedback?: never;
|
|
966
989
|
});
|
|
967
990
|
/**
|
|
968
991
|
* Human-in-the-loop approval for selected tools. Tools in `requireApproval` call `approve(req)` and
|
|
@@ -976,13 +999,13 @@ export type ApprovalSeatOutcome = boolean | (Extract<AskOutcome, {
|
|
|
976
999
|
* {@link import("./permission-rule-model.js").renderUntrustedCommandText} (the display baseline)
|
|
977
1000
|
* or run its own screen — absence of the warning bit is "not on this surface", never "clean".
|
|
978
1001
|
*
|
|
979
|
-
* WHAT `approve` MAY RETURN: a boolean, as always, or the `{allow, …}` OUTCOME OBJECT the `onAsk` seat
|
|
980
|
-
*
|
|
981
|
-
*
|
|
982
|
-
*
|
|
983
|
-
*
|
|
984
|
-
*
|
|
985
|
-
*
|
|
1002
|
+
* WHAT `approve` MAY RETURN: a boolean, as always, or the `{allow, …}` OUTCOME OBJECT the `onAsk` seat takes, read by the SAME screen
|
|
1003
|
+
* ({@link readApproverOutcomeObject}) and narrowed to what this seat has a lane for ({@link ApprovalSeatOutcome}) — so a deployment
|
|
1004
|
+
* here can report WHO ended the wait (`settledBy:"policy"` for its own policy's yes or no, `"timeout"` for its own elapsed window),
|
|
1005
|
+
* attach the decider's `reason` and name the `approver`. A bare `true` / `false` is unchanged: a person's approval or refusal, the
|
|
1006
|
+
* refusal with this factory's own terse sentence. Before the object arm a bare boolean was the only spelling there was, so a machine's
|
|
1007
|
+
* decision filed a PERSON's record. A person's yes answers this factory's own question about the call, never the `cross_boundary` one
|
|
1008
|
+
* the station raises after the policy (`gate-fold.ts`): that goes to the ask seat, and a run with none refuses the call headless.
|
|
986
1009
|
*/
|
|
987
1010
|
export declare function createApprovalPolicy(opts: {
|
|
988
1011
|
/** Tools that need an approval decision. */
|
|
@@ -1225,6 +1248,12 @@ export interface AskRequest {
|
|
|
1225
1248
|
* account is rendered once onto {@link message} at this request's mint. A DISPLAY value, not an identity channel:
|
|
1226
1249
|
* a stored rule's identity travels on {@link AskRuleEvidence.personalRuleDots}. */
|
|
1227
1250
|
allowRuleShadowed?: readonly import("./allow-rule-shadow.js").AllowRuleShadow[];
|
|
1251
|
+
/** The written ask rule this card stands for, exactly as the decision's minter stamped it
|
|
1252
|
+
* ({@link PermissionResult}'s ask arm) — so a card can say "your rule X asks about this". Present only when the
|
|
1253
|
+
* minter stamped a non-empty string; relayed as written, never parsed, never matched against. The durable park
|
|
1254
|
+
* route keeps the same value on `PendingAction.tool_approval.cardAskRule`. UNTRUSTED-for-display; never
|
|
1255
|
+
* adjudication input. */
|
|
1256
|
+
readonly matchedAskRule?: string;
|
|
1228
1257
|
/** WHY the reversibility probe did not clear this call — the account of the tighten the
|
|
1229
1258
|
* card was showing WITHOUT until now (the gate knew the cause and dropped it at this seam, leaving the
|
|
1230
1259
|
* approver the action but not the reason it is being asked about). Present only for a `"maybe"`-tier
|
|
@@ -1300,6 +1329,27 @@ export interface AskRequest {
|
|
|
1300
1329
|
* bidi bit's two faces can.
|
|
1301
1330
|
*/
|
|
1302
1331
|
readonly previewWithheld?: "oversize" | "unavailable";
|
|
1332
|
+
/**
|
|
1333
|
+
* What the write's target holds now, beside the change: present on every card of a tool whose roster row writes a file
|
|
1334
|
+
* on the execution environment (the write family, a path target that is not read-only, the environment leg), absent on
|
|
1335
|
+
* every other card. `text` — the target's text exactly when the model's own `Read` of that path, issued now, would be
|
|
1336
|
+
* served (the run's served-read judge with every ask held, then the Read tool's own text read, held to the file the
|
|
1337
|
+
* judgment named); `absent` — nothing is at the path (said only after the read was allowed); `withheld` with `why`:
|
|
1338
|
+
* `oversize` (over `EXISTING_TARGET_READ_CAP` bytes, never cut short), `not_text` (a directory, a binary file, a body
|
|
1339
|
+
* that is not UTF-8), `read_refused` (the resolution or a judgment layer refuses the read or would first ask someone, or
|
|
1340
|
+
* the run's roster has no `Read` — the judgment's probe carries the face the roster gives `Read`),
|
|
1341
|
+
* `unavailable` (no reader on this lane — an ancestor's question, a seat that will not answer, a policy approver's seat
|
|
1342
|
+
* — or the judgment or read could not finish within the judgment's budget).
|
|
1343
|
+
*
|
|
1344
|
+
* Read once per ask, only when a person's seat will answer the card: a seat that answers and is not a policy approver's
|
|
1345
|
+
* (`asPolicyApprover` — a policy seat renders no card, so its card says `unavailable` and nothing is read). Never committed
|
|
1346
|
+
* as the model having read the file. The text is the target's own bytes, unredacted and never cut — a surface that stores
|
|
1347
|
+
* or forwards the card owns its redaction and its rendering budget (`EXISTING_TARGET_READ_CAP` is the read's bound, not a
|
|
1348
|
+
* length to validate the text against). A SNAPSHOT as of the ask: the approved write may meet a changed file. The durable
|
|
1349
|
+
* park's twin is `PendingAction.tool_approval.existingTarget`: this card's member when this ask's live card read it (a
|
|
1350
|
+
* card answered `unavailable` and then parked), else read at the park before the run releases its environment.
|
|
1351
|
+
*/
|
|
1352
|
+
readonly existingTarget?: import("./existing-target.js").ExistingTarget;
|
|
1303
1353
|
/** Canonical digest of the call's tool ({@link toolName}) and {@link args} as presented in THIS ask, computed by the engine's
|
|
1304
1354
|
* one call binding (`exactBoundInputHashOf`) — the same digest a durable park binds its checkpoint to, so an aggregating
|
|
1305
1355
|
* approver can reconcile a synchronous ask row against a parked checkpoint row for the same call
|
|
@@ -1309,6 +1359,13 @@ export interface AskRequest {
|
|
|
1309
1359
|
* wired-approver call, so a mint site added later is covered by construction); optional on the type because a deployment
|
|
1310
1360
|
* may invoke its approver function directly. */
|
|
1311
1361
|
readonly boundInputHash?: string;
|
|
1362
|
+
/** THIS question's identity in the checkpoint-id spelling ({@link import("./checkpoint-store.js").mintCheckpointId}), minted once
|
|
1363
|
+
* per question by the station that puts it to the approver: when the approver answers `"unavailable"` and the question parks
|
|
1364
|
+
* over the bytes this card showed, the row's `checkpointId` is this value; answered in-stream, no row ever carries it. A new
|
|
1365
|
+
* question is a new value (a fallback re-put, an approved edit's re-check, another asker's question, another call, bytes moved
|
|
1366
|
+
* after the card) — a card keyed on one is never answered by another. An identity, not a capability (the row's token resumes);
|
|
1367
|
+
* never adjudication input. On every request an engine station mints; optional because a deployment may call its approver. */
|
|
1368
|
+
readonly checkpointId?: string;
|
|
1312
1369
|
/** A call to the engine's `Skill` tool: the hash of {@link boundGrants} — the digest a parked approval of the same card is judged by, so a live card reconciles against its parked row by `(toolCallId, boundGrantDigest)` and an answer is remembered by "this tool + this binding". Present exactly on that call (whoever asked, however the question was worded); every other card carries {@link boundGrantAbsence} instead; `message` renders the same lists narrowed to what releases in the leg's mode. Reconciliation metadata, never adjudication input. */
|
|
1313
1370
|
readonly boundGrantDigest?: string;
|
|
1314
1371
|
/** The value {@link boundGrantDigest} hashes: `{ skill, allowedTools, disallowedTools }` in canonical spelling (de-duplicated, sorted), `skill: null` when no loaded skill is named; a fresh copy per ask; same presence. Display metadata (deployment text — render with contextual escaping). */
|
|
@@ -1402,7 +1459,9 @@ export interface AskRequest {
|
|
|
1402
1459
|
* carries the same seat under the same contract, filled by the same one factory.
|
|
1403
1460
|
*/
|
|
1404
1461
|
readonly ruleOffersAbsence?: import("./ask-origin.js").RuleOffersAbsence;
|
|
1405
|
-
/** The
|
|
1462
|
+
/** The one line a person or the model reads for this ask. Not a second reason seat: a structured approval surface reads the
|
|
1463
|
+
* ask's reasons from {@link askReasons} (the askers' own words) and the typed members (the class, the origin, the mandate
|
|
1464
|
+
* word, {@link probeReason}), never from this line. */
|
|
1406
1465
|
message: string;
|
|
1407
1466
|
/** Runner-filled source identity (design S1d §1): the end-user {@link AskRequest} issuing task's
|
|
1408
1467
|
* `principal` (design/62). An AGGREGATING `onAsk` (one approver fanning over N delegated workers)
|
|
@@ -1489,7 +1548,7 @@ export interface AskRequest {
|
|
|
1489
1548
|
* present on every ask that carries one, whatever lane is wired.
|
|
1490
1549
|
*
|
|
1491
1550
|
* WHAT IT DOES NOT SAY: that no answerer may answer. An approver — a person, a hook, a deployment's
|
|
1492
|
-
* blanket `onAsk: "allow"` seat — resolves a mandated ask normally; {@link requiresRealApproval} is
|
|
1551
|
+
* blanket `onAsk: "allow"` seat, the class table a seat declares ({@link declareClassAnswers}) — resolves a mandated ask normally; {@link requiresRealApproval} is
|
|
1493
1552
|
* the stronger, separate demand and is the one the engine's blanket seat refuses. A surface whose
|
|
1494
1553
|
* POSTURE seat declines to auto-answer mandated cards reads this member to know which they are.
|
|
1495
1554
|
* ABSENT is not the opposite claim on an older engine: a consumer that must tell "this engine mints
|
|
@@ -1549,11 +1608,13 @@ export interface AskRequest {
|
|
|
1549
1608
|
* when {@link askClass} is. */
|
|
1550
1609
|
readonly classes?: readonly import("./ask-origin.js").AskClass[];
|
|
1551
1610
|
/** WHO asked about this call and what each said, in its OWN words, in fold order ({@link
|
|
1552
|
-
* import("./ask-origin.js").AskReason}): a deployment policy chain's ask sentence,
|
|
1553
|
-
* host's cause word
|
|
1554
|
-
*
|
|
1555
|
-
*
|
|
1556
|
-
*
|
|
1611
|
+
* import("./ask-origin.js").AskReason}): a deployment policy chain's ask sentence, an integrity guard's question, a hook's or an
|
|
1612
|
+
* extension's reason, a hook host's cause word — the one machine-read seat of an asker's own words. Present ⇔ at least one
|
|
1613
|
+
* asker said something of its own about this call; a generic question (the write gate's default sentence, the permission
|
|
1614
|
+
* mode's own) and a sentence the engine composes about a fact that rides a typed member of this request are no entry. The
|
|
1615
|
+
* structured approval surface renders this member and the typed members beside it, never {@link message} (the line a person or
|
|
1616
|
+
* the model reads, not a second reason seat); `words` is untrusted display text (one line, capped). The inbox listing carries
|
|
1617
|
+
* the same entries (`CheckpointSummary.askReasons`). Filled by the four mint stations from one
|
|
1557
1618
|
* reader; the parked row carries the same value (`PendingAction.tool_approval.askReasons`). Never caller/worker-settable:
|
|
1558
1619
|
* a policy or hook answer that states it is refused at the decision receipt. */
|
|
1559
1620
|
readonly askReasons?: readonly import("./ask-origin.js").AskReason[];
|
|
@@ -1597,8 +1658,9 @@ export interface AskRequest {
|
|
|
1597
1658
|
* Read it as PRESENCE-or-nothing: the field is either `true` or ABSENT. It is never written `false`,
|
|
1598
1659
|
* because absence means "not detected", which honestly covers both "clean" and "the bounded scan did
|
|
1599
1660
|
* not reach it" (a pathologically deep or huge argument graph stops at the scan budget) — a `false`
|
|
1600
|
-
* would claim a proof the scan does not offer. Judged over the EXECUTING argument snapshot
|
|
1601
|
-
* tool's own {@link preview} projection, i.e. the payload
|
|
1661
|
+
* would claim a proof the scan does not offer. Judged over the EXECUTING argument snapshot, the
|
|
1662
|
+
* tool's own {@link preview} projection, i.e. the payload, and the target's current text the card
|
|
1663
|
+
* shows beside it ({@link existingTarget}); {@link message} is deliberately out of
|
|
1602
1664
|
* scope (engine/policy-composed prose, not the thing that runs).
|
|
1603
1665
|
*
|
|
1604
1666
|
* Filled at the `resolveAsk` chokepoint, beside {@link boundInputHash} — every wired `onAsk`
|
|
@@ -1610,7 +1672,8 @@ export interface AskRequest {
|
|
|
1610
1672
|
* mint sites, not over every approval callback. The other two human-decision routes:
|
|
1611
1673
|
* ① a durable park/suspend never invokes `onAsk` and never mints an AskRequest — its twin of this
|
|
1612
1674
|
* bit is the PERSISTED `PendingAction.tool_approval.hasBidiControls` on the parked row (judged at
|
|
1613
|
-
* the park mint
|
|
1675
|
+
* the park mint by the same card scan, {@link cardCarriesBidiControls}, over the row's own
|
|
1676
|
+
* fidelity-projected args snapshot + preview + the row's `existingTarget`, so the two faces
|
|
1614
1677
|
* can honestly differ on a shape-changing backend), projected to the inbox as
|
|
1615
1678
|
* `CheckpointSummary.hasBidiControls` — see those fields in `checkpoint-store.ts` for the reading
|
|
1616
1679
|
* contract; absence there is still "not detected", never a clean bill, and an inbox rendering
|
|
@@ -1727,8 +1790,8 @@ export type OnAsk = "deny" | "allow" | ((req: AskRequest, signal?: AbortSignal)
|
|
|
1727
1790
|
* already say "a person ended this wait" can also say which one, without core growing an identity
|
|
1728
1791
|
* surface it deliberately does not have. Read the two together: `settledBy:"policy"` with an `approver` names
|
|
1729
1792
|
* WHICH of the deployment's answering seats decided (a closed word the host owns, never a person).
|
|
1730
|
-
* Screened, not trusted (see {@link screenApproverAttribution}): a non-string, an over-long value
|
|
1731
|
-
* carrying control characters is a loud fail-closed refusal at {@link resolveAsk}, the same posture this
|
|
1793
|
+
* Screened, not trusted (see {@link screenApproverAttribution}): a non-string, an over-long value, one of
|
|
1794
|
+
* only whitespace or one carrying control characters is a loud fail-closed refusal at {@link resolveAsk}, the same posture this
|
|
1732
1795
|
* seam takes for every other out-of-contract value — and the same reason, since a defective attribution
|
|
1733
1796
|
* that were quietly dropped would leave a settlement looking unattributed rather than misreported. It is
|
|
1734
1797
|
* carried on the DECIDER arms (a person's or a policy's allow or refusal) and never on an end the engine
|
|
@@ -1750,6 +1813,18 @@ export type OnAsk = "deny" | "allow" | ((req: AskRequest, signal?: AbortSignal)
|
|
|
1750
1813
|
* path) — announced `approval.read_root_granted`. Anything else changes nothing and is announced
|
|
1751
1814
|
* `approval.read_root_grant_rejected`; the verdict it rode stands. A seat with no card (a policy's `approve`)
|
|
1752
1815
|
* refuses it. Keeping the directory beyond this run is the deployment's (`TaskSpec.additionalReadDirectories`).
|
|
1816
|
+
*
|
|
1817
|
+
* `feedback` — "yes, and tell the agent what to do next": what the approving PERSON typed into the card's input, the allow arm's
|
|
1818
|
+
* counterpart of a refusal's `reason` and the exact twin of the durable resume's `ResumeOutcome` `policy_ask` `feedback`. PRESENT
|
|
1819
|
+
* only when the person wrote something: it is read by the one reading the durable decide uses (the outer whitespace dropped; empty
|
|
1820
|
+
* or whitespace-only is nothing, and mints nothing), and the model reads the rest as the user's own words — verbatim, no fence, no
|
|
1821
|
+
* wrapper sentence, no length bound — as the user message that follows the tool results of the batch the approved call is part of
|
|
1822
|
+
* (the durable leg's continuation carries the same bytes in the same position). Like the durable face it is ARM- AND DECIDER-SCOPED, and
|
|
1823
|
+
* refused rather than dropped (a fail-closed deny naming the member, announced as the approver's defect): written words on a refusal
|
|
1824
|
+
* (a refusal's words are `reason`), on an answer settled by `"policy"` or given by a seat declared a policy (a machine's text must
|
|
1825
|
+
* never reach the model as the user's), a non-string, or text carrying the engine's `<system-reminder>` tag (opening or closing). A
|
|
1826
|
+
* seat with no lane to deliver words — the {@link createApprovalPolicy} `approve` door, an Artifact read's own consent card — refuses
|
|
1827
|
+
* them the same way. Words still queued when the run ends are announced by the steer lane's undrained account, never silently lost.
|
|
1753
1828
|
*/
|
|
1754
1829
|
export type AskOutcome = boolean | "unavailable" | {
|
|
1755
1830
|
allow: boolean;
|
|
@@ -1759,7 +1834,19 @@ export type AskOutcome = boolean | "unavailable" | {
|
|
|
1759
1834
|
approver?: string;
|
|
1760
1835
|
decidedVia?: DecidedVia;
|
|
1761
1836
|
readRootGrant?: string;
|
|
1837
|
+
feedback?: string;
|
|
1762
1838
|
};
|
|
1839
|
+
/** An approver callback — the function arm of {@link OnAsk}. */
|
|
1840
|
+
type ApproverFn = Extract<OnAsk, (...args: never[]) => unknown>;
|
|
1841
|
+
/**
|
|
1842
|
+
* The ONE way engine code puts a new function in front of an approver: `wrap` receives the approver and returns the function
|
|
1843
|
+
* that calls it, and the wrapper is registered as the same decision-maker ({@link askApproverIdentity} answers the approver's
|
|
1844
|
+
* root for it). Every fact read off the root — "are these two consultations the same consultation", "is this approver a
|
|
1845
|
+
* policy" ({@link isPolicyApprover}) — therefore reads the same through any number of engine wrappers. A blanket
|
|
1846
|
+
* `"allow"`/`"deny"` or an absent seat is returned as it is: there is no approver to stand in front of.
|
|
1847
|
+
*/
|
|
1848
|
+
export declare function wrapApprover(onAsk: OnAsk, wrap: (approver: ApproverFn) => ApproverFn): OnAsk;
|
|
1849
|
+
export declare function wrapApprover(onAsk: OnAsk | undefined, wrap: (approver: ApproverFn) => ApproverFn): OnAsk | undefined;
|
|
1763
1850
|
/**
|
|
1764
1851
|
* ruled 2026-08-04 — forward an approver into a delegated child, stamping every ask it raises with the
|
|
1765
1852
|
* delegation it came from ({@link AskDelegationProvenance}).
|
|
@@ -1773,6 +1860,72 @@ export type AskOutcome = boolean | "unavailable" | {
|
|
|
1773
1860
|
* otherwise overwrite it with its own shallower one.
|
|
1774
1861
|
*/
|
|
1775
1862
|
export declare function withDelegationProvenance(onAsk: OnAsk, delegation: AskDelegationProvenance): OnAsk;
|
|
1863
|
+
/**
|
|
1864
|
+
* Declare an approver callback a POLICY — a program that answers asks on the deployment's behalf (it relays an answer a
|
|
1865
|
+
* person gave before, refuses, or answers `"unavailable"` so the ask parks for a person), not a person reachable through
|
|
1866
|
+
* a channel. Returns the same function. The run then reads its seat as `policy_callback`
|
|
1867
|
+
* ({@link import("./wiring-manifest.js").AskSeamForm}): `approvalReach: "none"` keeps it (the declaration sets aside the
|
|
1868
|
+
* one seat that could be a person), the manifest reports `policy_reachable`, the posture door refuses it beside
|
|
1869
|
+
* `interactionPosture: "interactive"`, and an allow it gives on an ask carrying `requiresRealApproval` is refused.
|
|
1870
|
+
*
|
|
1871
|
+
* Mark the value that is actually installed as `onAsk` — the outermost one: a host closure put in front of a marked
|
|
1872
|
+
* approver is a new function, and an unmarked function reads as a person (today's reading — a lost mark never widens
|
|
1873
|
+
* anything). Marking a wrapper the engine made marks the approver behind it. A policy that would answer every ask with
|
|
1874
|
+
* a new allow is the blanket `onAsk: "allow"`, not a marked approver; a blanket is not a callback and cannot be marked.
|
|
1875
|
+
* A non-function is refused (`TypeError`); marking twice is the same as marking once.
|
|
1876
|
+
*/
|
|
1877
|
+
export declare function asPolicyApprover<F extends ApproverFn>(fn: F): F;
|
|
1878
|
+
/** Is this seat value an approver a deployment declared a policy ({@link asPolicyApprover})? Read at the approver's root, so
|
|
1879
|
+
* every engine wrapper of a marked approver answers the same; anything that is not a function answers `false`. */
|
|
1880
|
+
export declare function isPolicyApprover(v: unknown): boolean;
|
|
1881
|
+
/**
|
|
1882
|
+
* Declare the ask classes a seat answers by itself: `declareClassAnswers(seat, { classes, approver })` returns a NEW
|
|
1883
|
+
* approver function. An ask whose whole class set ({@link AskRequest.classes}: present, non-empty, every member in
|
|
1884
|
+
* `classes`) the table covers is answered `{ allow: true, settledBy: "policy", approver }` — the deployment's policy
|
|
1885
|
+
* allowed it, named by `approver` (a closed word the host owns) — and `seat` is not called; every other ask is `seat`'s.
|
|
1886
|
+
*
|
|
1887
|
+
* The table is DATA the engine reads: the resolver answers a covered ask with that same outcome without calling the
|
|
1888
|
+
* minted function, and the card's target ({@link AskRequest.existingTarget}) is not read for it, since nobody renders the
|
|
1889
|
+
* card. The settlement is the one the function's own answer files (`policy_allowed`, `who.party: "policy"`,
|
|
1890
|
+
* `who.approver: approver`). `seat` and every value that already holds it are left as they were: a table belongs only to
|
|
1891
|
+
* the function minted here and to the engine's wrappers of it (a delegated child's seat, an artifact mount's consent
|
|
1892
|
+
* wrapper). A host
|
|
1893
|
+
* closure put in front of the minted function is a new function the engine cannot read the table through: it is called,
|
|
1894
|
+
* and its call reaches the same answer.
|
|
1895
|
+
*
|
|
1896
|
+
* Only the classes a standing rule may clear can be declared — the column `ruleMayClear` of
|
|
1897
|
+
* {@link import("./ask-origin.js").MODE_ARBITRATION} (today `ordinary` and `unstated`): a table is a deployment's answer
|
|
1898
|
+
* to the questions the allow layer itself may answer, by class instead of by tool. A question the engine mints demanding a
|
|
1899
|
+
* person ({@link AskRequest.requiresRealApproval}) always carries a class outside that column, so no table covers it; a
|
|
1900
|
+
* hand-built request carrying the bit beside a covered set is answered by the table and refused by the real-approval arm,
|
|
1901
|
+
* as the function's own allow is.
|
|
1902
|
+
*
|
|
1903
|
+
* Whether the asks outside the table reach a person is the seat's form, as for any function: mark the minted function
|
|
1904
|
+
* ({@link asPolicyApprover}) when `seat` is a policy — mark the outermost value, `asPolicyApprover(declareClassAnswers(…))`.
|
|
1905
|
+
*
|
|
1906
|
+
* A bad declaration is refused (`TypeError`): `seat` not a function; `answers` not an object, or carrying a member besides
|
|
1907
|
+
* the two (`answers` is read by the engine's one receipt of a caller's record, so a Proxy or an object of another
|
|
1908
|
+
* prototype is refused in the receipt's own words, `config.invalid_argument`); `classes` not a non-empty array of {@link import("./ask-origin.js").ASK_CLASSES} words in that column;
|
|
1909
|
+
* `approver` absent, empty, or refused by the attribution screen (a string, bounded, no control or bidirectional bytes, not only whitespace).
|
|
1910
|
+
*/
|
|
1911
|
+
export declare function declareClassAnswers(seat: ApproverFn, answers: {
|
|
1912
|
+
readonly classes: readonly AskClass[];
|
|
1913
|
+
readonly approver: string;
|
|
1914
|
+
}): ApproverFn;
|
|
1915
|
+
/**
|
|
1916
|
+
* The answer a seat's declared class table ({@link declareClassAnswers}) gives an ask with this class set — `undefined`
|
|
1917
|
+
* when the seat carries no table or the table does not cover the set. Covered = present, non-empty, every member in the
|
|
1918
|
+
* table. Read at the seat's root. The ONE reading of a table: the minted function answers by it, the resolver answers
|
|
1919
|
+
* by it without calling the seat, and the card-target read gate skips the read by it. A fresh object each time.
|
|
1920
|
+
*/
|
|
1921
|
+
export declare function declaredClassAnswer(onAsk: unknown, classes: unknown): {
|
|
1922
|
+
allow: true;
|
|
1923
|
+
settledBy: "policy";
|
|
1924
|
+
approver: string;
|
|
1925
|
+
} | undefined;
|
|
1926
|
+
/** The classes a seat's declared table answers ({@link declareClassAnswers}), read at the seat's root — `undefined` when
|
|
1927
|
+
* the value is not a function carrying one. The wiring manifest's `ask.answeredClasses` reads this. */
|
|
1928
|
+
export declare function declaredAnswerClassesOf(onAsk: unknown): readonly AskClass[] | undefined;
|
|
1776
1929
|
/**
|
|
1777
1930
|
* ruled 2026-08-04 — the APPROVER BEHIND a possibly-forwarded `onAsk`: the identity that answers
|
|
1778
1931
|
* "is this the same human/UI?" across delegation hops.
|
|
@@ -1785,11 +1938,13 @@ export declare function withDelegationProvenance(onAsk: OnAsk, delegation: AskDe
|
|
|
1785
1938
|
*/
|
|
1786
1939
|
export declare function askApproverIdentity(onAsk: unknown): unknown;
|
|
1787
1940
|
/**
|
|
1788
|
-
* Is this `onAsk` seat
|
|
1941
|
+
* Is this `onAsk` seat an ANSWERING SEAT — an approver callback the run can put an ask to and get an answer from now?
|
|
1789
1942
|
*
|
|
1790
|
-
* Only a function is
|
|
1791
|
-
*
|
|
1792
|
-
*
|
|
1943
|
+
* Only a function is — a person's channel or a deployment's policy callback ({@link asPolicyApprover}) alike: both are
|
|
1944
|
+
* asked first and answer (a policy may answer `"unavailable"`, and only then does the ask park). WHO answers is a
|
|
1945
|
+
* different question, read off the seat's form ({@link isPolicyApprover}); this one asks only whether anybody does. A
|
|
1946
|
+
* blanket `"allow"`/`"deny"` string is a policy SETTING, not a callback (the same reading the interaction-posture door
|
|
1947
|
+
* gives it), and an absent seat is nobody at all; neither can answer an ask, so neither may outrank a durable park.
|
|
1793
1948
|
*
|
|
1794
1949
|
* ONE definition on purpose. Two sites must agree on this — the run's own sync-first decline, and the
|
|
1795
1950
|
* mandate frozen into the chain its children inherit — and when they were two hand-written booleans they
|
|
@@ -1799,7 +1954,7 @@ export declare function askApproverIdentity(onAsk: unknown): unknown;
|
|
|
1799
1954
|
* beside {@link askApproverIdentity}, because the two sites are now two prepare phases (the inherited-gate
|
|
1800
1955
|
* fold and the wiring station) plus the orchestrator, and each reaches DOWN for the one definition.
|
|
1801
1956
|
*/
|
|
1802
|
-
export declare function
|
|
1957
|
+
export declare function isAnsweringSeat(onAsk: OnAsk | undefined): boolean;
|
|
1803
1958
|
/** Where a durable-approval MANDATE on a leg comes from — the closed set of its two sources. */
|
|
1804
1959
|
export declare const DURABLE_MANDATE_SOURCES: readonly ["force_durable_gate", "durable_approval"];
|
|
1805
1960
|
export type DurableMandateSource = (typeof DURABLE_MANDATE_SOURCES)[number];
|
|
@@ -1810,7 +1965,7 @@ export type DurableMandateSource = (typeof DURABLE_MANDATE_SOURCES)[number];
|
|
|
1810
1965
|
* cannot answer an ask, so the park is the only honest resolution). A live seat beside the opt-in is not a
|
|
1811
1966
|
* mandate: the leg's asks — and its children's, at the same frozen seat — resolve there.
|
|
1812
1967
|
*
|
|
1813
|
-
* ONE definition on purpose, like {@link
|
|
1968
|
+
* ONE definition on purpose, like {@link isAnsweringSeat} beside it: the chain a parent freezes for its
|
|
1814
1969
|
* children and the loud "mandated but no store" disclosure at the wiring station used to derive the same
|
|
1815
1970
|
* fact with two hand-written conditions, and the second one read only the entitlement — a task that opted
|
|
1816
1971
|
* in and had no store degraded to the live chain in silence.
|
|
@@ -1821,20 +1976,36 @@ export declare function durableMandateSourceOf(args: {
|
|
|
1821
1976
|
onAsk: OnAsk | undefined;
|
|
1822
1977
|
}): DurableMandateSource | undefined;
|
|
1823
1978
|
/**
|
|
1824
|
-
*
|
|
1825
|
-
*
|
|
1826
|
-
*
|
|
1827
|
-
*
|
|
1828
|
-
* asks "does this leg have a durable park FACILITY at all" — the question-face mount decision and
|
|
1829
|
-
* the inherited-mandate float both need the bare declaration, seat or no seat, and had each spelled
|
|
1830
|
-
* `forceDurableGate === true || durableApprovalDeclared` by hand (two call sites, `prepare-
|
|
1831
|
-
* question-face.ts` and `prepare-policy-chain.ts`, one drifting from the other silently if either
|
|
1832
|
-
* grows a third source or a typo'd operator).
|
|
1833
|
-
*/
|
|
1979
|
+
* Does this leg carry a durable park opt-in, with NO live-seat narrowing (unlike {@link durableMandateSourceOf}, "is every ask
|
|
1980
|
+
* MANDATED to gate durably")? Read by the question face and mount, the inherited-mandate float and the sandbox prerequisite. The
|
|
1981
|
+
* sources: the leg's `durableApproval` (a delegated leg's is the one its parent forwarded), or the `forceDurableGate` entitlement
|
|
1982
|
+
* (synthesized into an opt-in). Where the leg's approval park cannot be resumed ({@link approvalParkNotResumableOf}) neither counts. */
|
|
1834
1983
|
export declare function durableParkOptInDeclared(args: {
|
|
1835
1984
|
forceDurableGate: boolean;
|
|
1836
1985
|
durableApprovalDeclared: boolean;
|
|
1986
|
+
approvalParkNotResumable: boolean;
|
|
1987
|
+
}): boolean;
|
|
1988
|
+
/** THE leg fact "an approval park of this leg cannot be resumed", derived once per leg (the driver) and read by name: today's one
|
|
1989
|
+
* source is a DELEGATED leg its parent forwarded no opt-in to (a synchronous or fork child; a background child whose lane cannot park). */
|
|
1990
|
+
export declare function approvalParkNotResumableOf(leg: {
|
|
1991
|
+
delegated: boolean;
|
|
1992
|
+
durableApprovalDeclared: boolean;
|
|
1837
1993
|
}): boolean;
|
|
1994
|
+
/** The leg's EFFECTIVE opt-in: its own (the caller's word wins — it may carry a tighter scope / ttl), else the one the entitlement
|
|
1995
|
+
* synthesizes where {@link durableParkOptInDeclared} lets it (the leg's scope, no ttl). ONE derivation for the leg's park mint and
|
|
1996
|
+
* the opt-in it forwards (a forced root's background child inherits the facility its parent has, not only what the caller wrote). */
|
|
1997
|
+
export declare function effectiveDurableApprovalOf(args: {
|
|
1998
|
+
declared: {
|
|
1999
|
+
scope: string;
|
|
2000
|
+
ttlMs?: number;
|
|
2001
|
+
} | undefined;
|
|
2002
|
+
forceDurableGate: boolean;
|
|
2003
|
+
approvalParkNotResumable: boolean;
|
|
2004
|
+
scope: string;
|
|
2005
|
+
}): {
|
|
2006
|
+
scope: string;
|
|
2007
|
+
ttlMs?: number;
|
|
2008
|
+
} | undefined;
|
|
1838
2009
|
/** EXACT structural clone for the approval boundary (alias isolation) — fail-closed, never lossy,
|
|
1839
2010
|
* never identity: a JSON round-trip would silently DROP unclonable members (presented ≠ executing =
|
|
1840
2011
|
* consent misrepresentation) and an identity fallback would hand the approver the live executing
|
|
@@ -2011,6 +2182,9 @@ export type ResolvedAsk = (Extract<PermissionResult, {
|
|
|
2011
2182
|
approverUnavailable?: never;
|
|
2012
2183
|
/** The answer's `readRootGrant` ({@link AskOutcome}), screened against the request's candidate. */
|
|
2013
2184
|
readRootGrant?: ReadRootGrantScreen;
|
|
2185
|
+
/** The words a person's allow carried ({@link AskOutcome} `feedback`), fit to deliver. Handed to the station's
|
|
2186
|
+
* {@link ApprovalWordsSeat} by {@link resolveAskFor} and gone from the resolution it returns. */
|
|
2187
|
+
feedback?: string;
|
|
2014
2188
|
}) | (Extract<PermissionResult, {
|
|
2015
2189
|
action: "deny";
|
|
2016
2190
|
}> & {
|
|
@@ -2018,6 +2192,7 @@ export type ResolvedAsk = (Extract<PermissionResult, {
|
|
|
2018
2192
|
approverUnavailable?: true;
|
|
2019
2193
|
/** A grant riding a refusal: always `rejected` (`on_refusal`). */
|
|
2020
2194
|
readRootGrant?: ReadRootGrantScreen;
|
|
2195
|
+
feedback?: never;
|
|
2021
2196
|
});
|
|
2022
2197
|
/** What one resolver ARM composes: the resolution plus the settlement it ended the wait with — composed at the arm, every deny
|
|
2023
2198
|
* naming one (there is no unclassified refusal), an allow only when a DECIDER approved (a blanket `"allow"` asked nobody). The
|
|
@@ -2084,6 +2259,17 @@ export declare function carriesBidiControls(value: unknown, limits?: {
|
|
|
2084
2259
|
maxNodes: number;
|
|
2085
2260
|
maxChars: number;
|
|
2086
2261
|
}): boolean;
|
|
2262
|
+
/**
|
|
2263
|
+
* Whether an approval card's shown text carries a directional control: the executing arguments, the tool's preview of
|
|
2264
|
+
* them, and the target's current text the card shows beside them ({@link AskRequest.existingTarget}) — each under the mint
|
|
2265
|
+
* tier of {@link carriesBidiControls}. The one scan both card faces run: the `resolveAsk` chokepoint for the synchronous card
|
|
2266
|
+
* and the durable park mint for the parked row's twin.
|
|
2267
|
+
*/
|
|
2268
|
+
export declare function cardCarriesBidiControls(card: {
|
|
2269
|
+
readonly args: unknown;
|
|
2270
|
+
readonly preview?: unknown;
|
|
2271
|
+
readonly existingTarget?: unknown;
|
|
2272
|
+
}): boolean;
|
|
2087
2273
|
/**
|
|
2088
2274
|
* Resolve an `ask` decision to a terminal `allow`/`deny` via {@link OnAsk}. Centralizes the headless
|
|
2089
2275
|
* auto-deny default, fail-closed error handling, and stable deny reasons so every ask site is
|
|
@@ -2115,6 +2301,12 @@ onLateSettlement?: (late: {
|
|
|
2115
2301
|
kind: "error";
|
|
2116
2302
|
error: unknown;
|
|
2117
2303
|
}) => void): Promise<ResolvedAsk>;
|
|
2304
|
+
/** What an engine mint station is told when the approver it asked FAILED (the resolver's `onApproverDefect`): how it failed, and whether
|
|
2305
|
+
* the seat is a policy the deployment declared ({@link asPolicyApprover}) or any other approver. Never the thrown text or the answer. */
|
|
2306
|
+
export interface ApproverDefect {
|
|
2307
|
+
readonly cause: "threw" | "out_of_contract";
|
|
2308
|
+
readonly seat: "policy" | "approver";
|
|
2309
|
+
}
|
|
2118
2310
|
/**
|
|
2119
2311
|
* {@link resolveAsk} at an engine mint station, which also hands over the decision it ASKED (`asked`): when the arm that ran
|
|
2120
2312
|
* quotes the question ({@link quotingQuestion}) and the question the request puts to the approver IS the sentence the engine
|
|
@@ -2127,4 +2319,7 @@ export declare function resolveAskFor(req: AskRequest, onAsk: OnAsk | undefined,
|
|
|
2127
2319
|
} | {
|
|
2128
2320
|
kind: "error";
|
|
2129
2321
|
error: unknown;
|
|
2130
|
-
}) => void) | undefined, asked: object | undefined
|
|
2322
|
+
}) => void) | undefined, asked: object | undefined, onApproverDefect?: (defect: ApproverDefect) => void,
|
|
2323
|
+
/** The station's carrier for a person's written `feedback` ({@link AskOutcome}). A station without one is a seat with no lane for
|
|
2324
|
+
* words: the answer that brings them is refused, never approved with the words gone. */
|
|
2325
|
+
approvalWords?: ApprovalWordsSeat): Promise<ResolvedAsk>;
|