@sema-agent/core 7.66.0 → 7.67.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +3498 -0
- package/LICENSE +2 -1
- package/dist/agents/agent-definition.js +2 -1
- package/dist/agents/agent-transcript-tool.d.ts +1 -1
- package/dist/agents/agent-transcript-tool.js +4 -3
- package/dist/agents/builtin-agents.d.ts +10 -7
- package/dist/agents/builtin-agents.js +1 -0
- package/dist/agents/cascade.d.ts +24 -11
- package/dist/agents/cascade.js +21 -9
- package/dist/agents/child-failure.d.ts +30 -0
- package/dist/agents/child-failure.js +25 -1
- package/dist/agents/composition-placement.d.ts +6 -2
- package/dist/agents/composition-placement.js +7 -3
- package/dist/agents/cross-session-envelope.d.ts +10 -1
- package/dist/agents/cross-session-envelope.js +6 -2
- package/dist/agents/cross-session-judge.d.ts +7 -1
- package/dist/agents/cross-session-judge.js +1 -0
- package/dist/agents/cumulative-stats.d.ts +36 -2
- package/dist/agents/cumulative-stats.js +44 -9
- package/dist/agents/delegation-registry-seat.js +2 -3
- package/dist/agents/inherited-tool-pool.d.ts +9 -4
- package/dist/agents/inherited-tool-pool.js +7 -1
- package/dist/agents/leg-label.d.ts +28 -0
- package/dist/agents/leg-label.js +9 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/list-agents-tool.js +4 -4
- package/dist/agents/org-delivery-gate.d.ts +129 -23
- package/dist/agents/org-delivery-gate.js +41 -20
- package/dist/agents/peer-held-queue.d.ts +15 -10
- package/dist/agents/peer-held-queue.js +47 -19
- package/dist/agents/peer-notice-route.js +2 -2
- package/dist/agents/peer-notices.d.ts +13 -2
- package/dist/agents/peer-notices.js +12 -2
- package/dist/agents/peer-session-drain.d.ts +65 -15
- package/dist/agents/peer-session-drain.js +198 -41
- package/dist/agents/read-inbox-tool.d.ts +3 -2
- package/dist/agents/read-inbox-tool.js +7 -5
- package/dist/agents/repair-loop.js +20 -16
- package/dist/agents/retain-ledger.d.ts +1 -1
- package/dist/agents/retain-ledger.js +2 -4
- package/dist/agents/root-session-lane.d.ts +27 -0
- package/dist/agents/root-session-lane.js +57 -0
- package/dist/agents/roster-store.js +1 -2
- package/dist/agents/send-message-tool.js +6 -4
- package/dist/agents/subagent.d.ts +20 -4
- package/dist/agents/subagent.js +218 -183
- package/dist/agents/tool-filter.d.ts +3 -10
- package/dist/agents/tool-filter.js +0 -13
- package/dist/agents/verifier-independence.d.ts +31 -0
- package/dist/agents/verifier-independence.js +23 -0
- package/dist/agents/verify.d.ts +23 -11
- package/dist/agents/verify.js +28 -12
- package/dist/agents/yield-adoption.d.ts +24 -0
- package/dist/agents/yield-adoption.js +84 -0
- package/dist/bench/metrics.d.ts +2 -2
- package/dist/brain/anthropic.d.ts +4 -2
- package/dist/brain/anthropic.js +49 -35
- package/dist/brain/brain-faces.d.ts +11 -0
- package/dist/brain/brain-faces.js +6 -0
- package/dist/brain/cache-retention.d.ts +2 -0
- package/dist/brain/cache-retention.js +9 -0
- package/dist/brain/circuit-breaker.js +51 -26
- package/dist/brain/errors.d.ts +15 -1
- package/dist/brain/errors.js +8 -0
- package/dist/brain/failover.d.ts +6 -0
- package/dist/brain/failover.js +52 -37
- package/dist/brain/media-degrade.d.ts +5 -0
- package/dist/brain/media-degrade.js +4 -0
- package/dist/brain/model-capability.d.ts +2 -1
- package/dist/brain/model-lane.d.ts +145 -0
- package/dist/brain/model-lane.js +444 -0
- package/dist/brain/open-responses.js +19 -22
- package/dist/brain/openai.js +23 -22
- package/dist/brain/provider-message.d.ts +9 -0
- package/dist/brain/provider-message.js +18 -0
- package/dist/brain/reasoning-request.d.ts +9 -7
- package/dist/brain/reasoning-request.js +9 -10
- package/dist/brain/reasoning.d.ts +47 -13
- package/dist/brain/reasoning.js +20 -10
- package/dist/brain/route-adjudicator.d.ts +8 -2
- package/dist/brain/route-adjudicator.js +35 -1
- package/dist/brain/route-conformance.js +17 -0
- package/dist/brain/routing.d.ts +2 -0
- package/dist/brain/routing.js +19 -8
- package/dist/brain/status-sink.d.ts +5 -4
- package/dist/brain/status-sink.js +2 -2
- package/dist/brain/stream-engine.js +8 -2
- package/dist/brain/stream-shared.d.ts +12 -0
- package/dist/brain/stream-shared.js +18 -0
- package/dist/brain/timeout.d.ts +28 -0
- package/dist/brain/timeout.js +13 -4
- package/dist/brain/tool-schema-projection.d.ts +2 -0
- package/dist/brain/tool-schema-projection.js +108 -0
- package/dist/brain/usage-reading.d.ts +49 -0
- package/dist/brain/usage-reading.js +44 -0
- package/dist/brain/usage-reasoning.d.ts +38 -0
- package/dist/brain/usage-reasoning.js +9 -0
- package/dist/config/catalog.d.ts +3 -0
- package/dist/config/catalog.js +18 -9
- package/dist/core/a2a.d.ts +22 -4
- package/dist/core/a2a.js +191 -50
- package/dist/core/agent-definition.d.ts +3 -1
- package/dist/core/agent-state.d.ts +29 -16
- package/dist/core/agent-state.js +36 -9
- package/dist/core/allow-entry.d.ts +12 -3
- package/dist/core/allow-entry.js +10 -3
- package/dist/core/approval-display.d.ts +18 -0
- package/dist/core/approval-display.js +26 -0
- package/dist/core/approval-object.js +2 -2
- package/dist/core/approval-route.d.ts +16 -0
- package/dist/core/approval-route.js +5 -0
- package/dist/core/approval-words.d.ts +43 -0
- package/dist/core/approval-words.js +37 -0
- package/dist/core/ask-origin.d.ts +37 -10
- package/dist/core/ask-origin.js +19 -7
- package/dist/core/ask-question.d.ts +36 -8
- package/dist/core/ask-question.js +24 -9
- package/dist/core/ask-unresolvable-notice.d.ts +3 -2
- package/dist/core/ask-unresolvable-notice.js +3 -2
- package/dist/core/attachment-source.d.ts +50 -0
- package/dist/core/attachment-source.js +46 -0
- package/dist/core/auto-compaction.d.ts +151 -40
- package/dist/core/auto-compaction.js +115 -50
- package/dist/core/auto-mode.d.ts +5 -0
- package/dist/core/auto-mode.js +11 -4
- package/dist/core/background-agent-store.d.ts +151 -23
- package/dist/core/background-agent-store.js +201 -61
- package/dist/core/background-shell.d.ts +4 -1
- package/dist/core/background-shell.js +1 -0
- package/dist/core/cache-break-detector.d.ts +49 -25
- package/dist/core/cache-break-detector.js +99 -44
- package/dist/core/caller-text.d.ts +28 -0
- package/dist/core/caller-text.js +12 -0
- package/dist/core/canonical-json.d.ts +5 -0
- package/dist/core/canonical-json.js +7 -0
- package/dist/core/checkpoint-features.d.ts +80 -9
- package/dist/core/checkpoint-features.js +1 -1
- package/dist/core/checkpoint-generation.d.ts +8 -1
- package/dist/core/checkpoint-generation.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +47 -14
- package/dist/core/checkpoint-queries.js +63 -30
- package/dist/core/checkpoint-requirements.d.ts +36 -3
- package/dist/core/checkpoint-requirements.js +11 -1
- package/dist/core/checkpoint-row-verdict.d.ts +0 -2
- package/dist/core/checkpoint-row-verdict.js +5 -8
- package/dist/core/checkpoint-store.d.ts +166 -41
- package/dist/core/checkpoint-store.js +96 -15
- package/dist/core/child-clamp-seats.d.ts +10 -2
- package/dist/core/child-clamp-seats.js +2 -2
- package/dist/core/classifier-unavailable-arm.d.ts +11 -9
- package/dist/core/classifier-unavailable-arm.js +4 -2
- package/dist/core/command-sandbox-dispatch.d.ts +13 -0
- package/dist/core/command-sandbox-dispatch.js +8 -0
- package/dist/core/command-sandbox.d.ts +231 -0
- package/dist/core/command-sandbox.js +344 -0
- package/dist/core/completion-id.d.ts +21 -0
- package/dist/core/completion-id.js +14 -0
- package/dist/core/config-refusal-codes.d.ts +22 -0
- package/dist/core/config-refusal-codes.js +196 -0
- package/dist/core/context-edit.d.ts +26 -0
- package/dist/core/context-edit.js +4 -2
- package/dist/core/context-guard.d.ts +80 -7
- package/dist/core/context-guard.js +126 -25
- package/dist/core/context-settings.d.ts +32 -0
- package/dist/core/context-settings.js +41 -3
- package/dist/core/contract-faces.d.ts +22 -0
- package/dist/core/contract-faces.js +1 -0
- package/dist/core/credential-echo.d.ts +2 -2
- package/dist/core/credential-echo.js +2 -2
- package/dist/core/cross-boundary-taint.d.ts +10 -8
- package/dist/core/decision-receipt.d.ts +3 -2
- package/dist/core/decision-receipt.js +1 -1
- package/dist/core/definition-entry-grammar.d.ts +42 -0
- package/dist/core/definition-entry-grammar.js +15 -0
- package/dist/core/engine-attestation.d.ts +19 -4
- package/dist/core/engine-attestation.js +4 -0
- package/dist/core/engine-capabilities.d.ts +8 -1
- package/dist/core/engine-capabilities.js +1 -1
- package/dist/core/engine-contracts/open-face-contract.d.ts +39 -0
- package/dist/core/engine-contracts/open-face-contract.js +57 -0
- package/dist/core/engine-notice.d.ts +161 -33
- package/dist/core/exclusive-temp.d.ts +25 -0
- package/dist/core/exclusive-temp.js +19 -0
- package/dist/core/existing-target.d.ts +112 -0
- package/dist/core/existing-target.js +88 -0
- package/dist/core/file-history-store.d.ts +14 -6
- package/dist/core/gate-lanes.js +8 -3
- package/dist/core/gate-outcome.d.ts +2 -1
- package/dist/core/git-worktree-env.d.ts +92 -1
- package/dist/core/git-worktree-env.js +87 -6
- package/dist/core/governance-codes.d.ts +49 -8
- package/dist/core/governance-codes.js +59 -8
- package/dist/core/hands-band.d.ts +10 -6
- package/dist/core/hooks.d.ts +60 -6
- package/dist/core/hooks.js +10 -2
- package/dist/core/host-floor.d.ts +24 -8
- package/dist/core/host-floor.js +45 -16
- package/dist/core/human-input-projection.d.ts +7 -0
- package/dist/core/human-input-projection.js +11 -3
- package/dist/core/image-admission.d.ts +16 -4
- package/dist/core/image-admission.js +29 -17
- package/dist/core/input-author.d.ts +43 -1
- package/dist/core/input-author.js +19 -0
- package/dist/core/isolation-scope.d.ts +41 -0
- package/dist/core/isolation-scope.js +10 -0
- package/dist/core/json-schema-seats.d.ts +11 -0
- package/dist/core/json-schema-seats.js +5 -0
- package/dist/core/leg-identity.d.ts +53 -5
- package/dist/core/leg-identity.js +32 -1
- package/dist/core/locked-config.d.ts +33 -38
- package/dist/core/locked-config.js +21 -3
- package/dist/core/lsp.js +2 -1
- package/dist/core/mailbox-store.d.ts +111 -18
- package/dist/core/mailbox-store.js +101 -13
- package/dist/core/mcp-call-meta.js +1 -1
- package/dist/core/mcp-connection-pool.d.ts +8 -2
- package/dist/core/mcp-connection-pool.js +3 -1
- package/dist/core/mcp-failure.d.ts +6 -1
- package/dist/core/mcp-failure.js +10 -0
- package/dist/core/mcp-host-read.d.ts +293 -0
- package/dist/core/mcp-host-read.js +428 -0
- package/dist/core/mcp-server-link.d.ts +28 -6
- package/dist/core/mcp-server-link.js +35 -7
- package/dist/core/mcp-server-spec.d.ts +22 -29
- package/dist/core/mcp-server-spec.js +7 -14
- package/dist/core/mcp-server-unavailable-notice.d.ts +32 -0
- package/dist/core/mcp-server-unavailable-notice.js +15 -0
- package/dist/core/mcp-session-end.d.ts +5 -2
- package/dist/core/mcp-session-end.js +7 -2
- package/dist/core/mcp-tool-meta.d.ts +6 -0
- package/dist/core/mcp-tool-meta.js +1 -0
- package/dist/core/mcp.d.ts +54 -19
- package/dist/core/mcp.js +194 -241
- package/dist/core/memory-engine/committed-shadow-read.d.ts +16 -0
- package/dist/core/memory-engine/committed-shadow-read.js +21 -0
- package/dist/core/memory-engine/consolidation-driver.js +2 -1
- package/dist/core/memory-engine/consolidation.d.ts +3 -3
- package/dist/core/memory-engine/control-objects.d.ts +4 -3
- package/dist/core/memory-engine/control-objects.js +6 -4
- package/dist/core/memory-engine/delegation-settlement.d.ts +127 -25
- package/dist/core/memory-engine/delegation-settlement.js +145 -18
- package/dist/core/memory-engine/distiller.d.ts +2 -1
- package/dist/core/memory-engine/distiller.js +10 -5
- package/dist/core/memory-engine/dual-root.js +2 -2
- package/dist/core/memory-engine/engine.d.ts +127 -33
- package/dist/core/memory-engine/engine.js +774 -323
- package/dist/core/memory-engine/entry-scan.d.ts +3 -0
- package/dist/core/memory-engine/entry-scan.js +8 -0
- package/dist/core/memory-engine/export-bundle.d.ts +4 -0
- package/dist/core/memory-engine/export-bundle.js +2 -0
- package/dist/core/memory-engine/file-backend.d.ts +62 -17
- package/dist/core/memory-engine/file-backend.js +155 -99
- package/dist/core/memory-engine/index.d.ts +1 -1
- package/dist/core/memory-engine/index.js +1 -1
- package/dist/core/memory-engine/layer-observations.d.ts +7 -1
- package/dist/core/memory-engine/layer-observations.js +6 -0
- package/dist/core/memory-engine/layout.d.ts +88 -26
- package/dist/core/memory-engine/layout.js +105 -29
- package/dist/core/memory-engine/memory-deployment.js +4 -4
- package/dist/core/memory-engine/mount-failed-notice.d.ts +24 -0
- package/dist/core/memory-engine/mount-failed-notice.js +22 -0
- package/dist/core/memory-engine/origin-clearance.d.ts +15 -1
- package/dist/core/memory-engine/origin-clearance.js +30 -10
- package/dist/core/memory-engine/scan.js +1 -1
- package/dist/core/memory-engine/scope-contract.js +4 -3
- package/dist/core/memory-engine/session-write-home.js +13 -1
- package/dist/core/memory-engine/sync-client.d.ts +1 -1
- package/dist/core/memory-engine/sync-client.js +3 -1
- package/dist/core/memory-engine/tools.d.ts +5 -4
- package/dist/core/memory-engine/tools.js +1 -1
- package/dist/core/memory-engine/types.d.ts +18 -1
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory.d.ts +1 -1
- package/dist/core/memory.js +2 -6
- package/dist/core/mode-policy.d.ts +8 -1
- package/dist/core/mode-policy.js +6 -2
- package/dist/core/model-fallbacks.d.ts +103 -0
- package/dist/core/model-fallbacks.js +79 -0
- package/dist/core/model-receipt.d.ts +15 -3
- package/dist/core/model-receipt.js +22 -1
- package/dist/core/model-seat.d.ts +1 -1
- package/dist/core/mods/classic-events.d.ts +5 -1
- package/dist/core/mods/dollar.d.ts +47 -2
- package/dist/core/mods/dollar.js +28 -5
- package/dist/core/mods/kernel/budget.d.ts +6 -0
- package/dist/core/mods/kernel/budget.js +6 -0
- package/dist/core/mods/kernel/dispatch.d.ts +23 -2
- package/dist/core/mods/kernel/dispatch.js +104 -15
- package/dist/core/mods/kernel/events.d.ts +18 -1
- package/dist/core/mods/kernel/events.js +7 -6
- package/dist/core/mods/kernel/index.d.ts +2 -2
- package/dist/core/mods/kernel/index.js +1 -1
- package/dist/core/mods/kernel/receive.d.ts +2 -1
- package/dist/core/mods/lifecycle-stations.d.ts +13 -4
- package/dist/core/mods/lifecycle-stations.js +8 -3
- package/dist/core/mods/message-display.d.ts +81 -0
- package/dist/core/mods/message-display.js +369 -0
- package/dist/core/mods/prompt-submit.d.ts +1 -1
- package/dist/core/mods/prompt-submit.js +5 -2
- package/dist/core/mods/session-append.d.ts +2 -2
- package/dist/core/mods/session-append.js +2 -1
- package/dist/core/mods/session-compact.js +2 -2
- package/dist/core/mods/stations.d.ts +48 -18
- package/dist/core/mods/stations.js +100 -19
- package/dist/core/mods/stop-answers.d.ts +23 -0
- package/dist/core/mods/stop-answers.js +20 -0
- package/dist/core/mounted-mcp.d.ts +48 -8
- package/dist/core/mounted-mcp.js +82 -16
- package/dist/core/namespaced-rule-name.js +2 -1
- package/dist/core/own-property-receipt.js +3 -5
- package/dist/core/parent-spec-seat.d.ts +20 -1
- package/dist/core/parent-spec-seat.js +13 -3
- package/dist/core/park-selfcheck.js +1 -0
- package/dist/core/path-identity.js +2 -1
- package/dist/core/peer-seat.d.ts +21 -7
- package/dist/core/peer-seat.js +25 -16
- package/dist/core/permission-rule-consent.js +15 -5
- package/dist/core/permission-rule-model.d.ts +4 -2
- package/dist/core/permission-rule-model.js +43 -23
- package/dist/core/permission-rule-store.d.ts +31 -16
- package/dist/core/permission-rule-store.js +27 -18
- package/dist/core/present-plan-tool.d.ts +6 -1
- package/dist/core/present-plan-tool.js +11 -3
- package/dist/core/pricing.d.ts +8 -6
- package/dist/core/pricing.js +1 -1
- package/dist/core/principal-name.d.ts +13 -0
- package/dist/core/principal-name.js +9 -2
- package/dist/core/process-identity.d.ts +140 -0
- package/dist/core/process-identity.js +215 -0
- package/dist/core/protocol-http-auth.d.ts +28 -6
- package/dist/core/protocol-http-auth.js +22 -5
- package/dist/core/protocol-naming.d.ts +7 -0
- package/dist/core/protocol-naming.js +12 -2
- package/dist/core/protocol-revocation.d.ts +72 -0
- package/dist/core/protocol-revocation.js +98 -0
- package/dist/core/protocol-table.d.ts +4 -4
- package/dist/core/protocol-table.js +3 -2
- package/dist/core/push-queue.d.ts +35 -2
- package/dist/core/push-queue.js +60 -4
- package/dist/core/read-only-shell.d.ts +19 -0
- package/dist/core/read-only-shell.js +38 -11
- package/dist/core/real-approval.d.ts +26 -0
- package/dist/core/real-approval.js +15 -0
- package/dist/core/redaction-marks.d.ts +6 -2
- package/dist/core/redaction-marks.js +3 -0
- package/dist/core/reminder-mint.d.ts +6 -0
- package/dist/core/reminder-mint.js +9 -8
- package/dist/core/remote-env.d.ts +31 -15
- package/dist/core/remote-env.js +29 -0
- package/dist/core/request-copy-projection.d.ts +51 -0
- package/dist/core/request-copy-projection.js +410 -0
- package/dist/core/resume-config-judge.d.ts +69 -0
- package/dist/core/resume-config-judge.js +78 -0
- package/dist/core/resume-startup-cause.d.ts +14 -4
- package/dist/core/resume-startup-cause.js +12 -2
- package/dist/core/retention-policy.js +2 -1
- package/dist/core/retention.d.ts +119 -24
- package/dist/core/retention.js +60 -16
- package/dist/core/retired-keys.d.ts +0 -10
- package/dist/core/retired-keys.js +2 -3
- package/dist/core/roles.d.ts +6 -0
- package/dist/core/roles.js +65 -4
- package/dist/core/row-shape.d.ts +149 -0
- package/dist/core/row-shape.js +184 -0
- package/dist/core/runner/advertised-writable-dirs.js +10 -9
- package/dist/core/runner/advisor-instructions.d.ts +11 -27
- package/dist/core/runner/advisor-instructions.js +18 -20
- package/dist/core/runner/advisor-tool.js +1 -0
- package/dist/core/runner/announce-once-ledger.js +4 -1
- package/dist/core/runner/approval-feedback.d.ts +17 -8
- package/dist/core/runner/approval-feedback.js +18 -13
- package/dist/core/runner/approver-defect-announcer.d.ts +17 -0
- package/dist/core/runner/approver-defect-announcer.js +22 -0
- package/dist/core/runner/assemble-result.d.ts +29 -14
- package/dist/core/runner/assemble-result.js +16 -25
- package/dist/core/runner/cache-hit-account.d.ts +77 -0
- package/dist/core/runner/cache-hit-account.js +46 -0
- package/dist/core/runner/call-hook-stations.d.ts +3 -2
- package/dist/core/runner/call-hook-stations.js +5 -4
- package/dist/core/runner/changed-files-scan.d.ts +43 -0
- package/dist/core/runner/changed-files-scan.js +34 -0
- package/dist/core/runner/checkpoint-scope.d.ts +33 -9
- package/dist/core/runner/checkpoint-scope.js +27 -1
- package/dist/core/runner/classifier-ladder.d.ts +2 -2
- package/dist/core/runner/classifier-ladder.js +18 -9
- package/dist/core/runner/clock-and-limits.d.ts +15 -4
- package/dist/core/runner/clock-and-limits.js +19 -1
- package/dist/core/runner/compact-session.js +84 -14
- package/dist/core/runner/compaction-call-options.d.ts +2 -29
- package/dist/core/runner/compaction-call-options.js +2 -9
- package/dist/core/runner/compaction-restate.d.ts +18 -2
- package/dist/core/runner/compaction-restate.js +36 -2
- package/dist/core/runner/construction-doors.js +8 -0
- package/dist/core/runner/context-room.d.ts +55 -0
- package/dist/core/runner/context-room.js +71 -0
- package/dist/core/runner/contracts.d.ts +313 -205
- package/dist/core/runner/conversation-segment.d.ts +49 -14
- package/dist/core/runner/conversation-segment.js +92 -19
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -0
- package/dist/core/runner/cross-boundary-lane.js +9 -6
- package/dist/core/runner/decide-continuation.js +1 -1
- package/dist/core/runner/deferred-ask.d.ts +62 -0
- package/dist/core/runner/deferred-ask.js +44 -0
- package/dist/core/runner/delegation-owner.d.ts +19 -0
- package/dist/core/runner/delegation-owner.js +27 -1
- package/dist/core/runner/denial-limit-arms.d.ts +10 -6
- package/dist/core/runner/denial-limit-arms.js +13 -7
- package/dist/core/runner/env-capability-census.d.ts +1 -1
- package/dist/core/runner/file-history-request.js +2 -1
- package/dist/core/runner/file-history-restore.d.ts +16 -2
- package/dist/core/runner/file-history-restore.js +9 -1
- package/dist/core/runner/gate-exit.d.ts +18 -5
- package/dist/core/runner/gate-exit.js +26 -15
- package/dist/core/runner/git-status-frame.d.ts +26 -8
- package/dist/core/runner/git-status-frame.js +14 -9
- package/dist/core/runner/halt-attribution.d.ts +29 -12
- package/dist/core/runner/halt-attribution.js +38 -11
- package/dist/core/runner/image.js +3 -2
- package/dist/core/runner/initial-run-state.d.ts +1 -1
- package/dist/core/runner/initial-run-state.js +4 -4
- package/dist/core/runner/language-frame.d.ts +66 -0
- package/dist/core/runner/language-frame.js +76 -0
- package/dist/core/runner/leg-frame.d.ts +81 -0
- package/dist/core/runner/leg-frame.js +68 -0
- package/dist/core/runner/main-call-account.d.ts +34 -0
- package/dist/core/runner/main-call-account.js +50 -0
- package/dist/core/runner/mcp-redial.d.ts +9 -7
- package/dist/core/runner/mcp-redial.js +20 -21
- package/dist/core/runner/memory-consolidation-driver.d.ts +2 -0
- package/dist/core/runner/memory-consolidation-driver.js +5 -3
- package/dist/core/runner/messages-omitted-seat.d.ts +2 -0
- package/dist/core/runner/messages-omitted-seat.js +21 -0
- package/dist/core/runner/model-fallback-seat.d.ts +20 -0
- package/dist/core/runner/model-fallback-seat.js +43 -0
- package/dist/core/runner/model-lane-seat.d.ts +12 -0
- package/dist/core/runner/model-lane-seat.js +35 -0
- package/dist/core/runner/nested-memory-content.d.ts +33 -0
- package/dist/core/runner/nested-memory-content.js +171 -0
- package/dist/core/runner/nested-memory-lane.d.ts +181 -0
- package/dist/core/runner/nested-memory-lane.js +673 -0
- package/dist/core/runner/park-commit.d.ts +7 -0
- package/dist/core/runner/park-commit.js +3 -0
- package/dist/core/runner/prepare-advisor.d.ts +7 -9
- package/dist/core/runner/prepare-advisor.js +11 -5
- package/dist/core/runner/prepare-artifact.d.ts +1 -1
- package/dist/core/runner/prepare-artifact.js +8 -3
- package/dist/core/runner/prepare-ask-lane.d.ts +21 -3
- package/dist/core/runner/prepare-ask-lane.js +32 -28
- package/dist/core/runner/prepare-boundary-parks.d.ts +2 -2
- package/dist/core/runner/prepare-boundary-parks.js +21 -17
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +10 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +24 -18
- package/dist/core/runner/prepare-config-doors.d.ts +51 -5
- package/dist/core/runner/prepare-config-doors.js +73 -73
- package/dist/core/runner/prepare-context-lane.d.ts +68 -3
- package/dist/core/runner/prepare-context-lane.js +137 -27
- package/dist/core/runner/prepare-defer-classify.d.ts +0 -4
- package/dist/core/runner/prepare-defer-classify.js +9 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +8 -8
- package/dist/core/runner/prepare-delegation-surface.js +72 -64
- package/dist/core/runner/prepare-execution-env.js +1 -9
- package/dist/core/runner/prepare-file-history.d.ts +3 -2
- package/dist/core/runner/prepare-file-history.js +11 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +21 -11
- package/dist/core/runner/prepare-gate-stations.js +13 -13
- package/dist/core/runner/prepare-hands-readface.d.ts +23 -6
- package/dist/core/runner/prepare-hands-readface.js +18 -12
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -5
- package/dist/core/runner/prepare-inherited-gate.js +14 -10
- package/dist/core/runner/prepare-lsp.js +2 -1
- package/dist/core/runner/prepare-memory-engine-session.js +30 -10
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +38 -16
- package/dist/core/runner/prepare-offload-wrappers.d.ts +3 -16
- package/dist/core/runner/prepare-offload-wrappers.js +6 -5
- package/dist/core/runner/prepare-park-ask.d.ts +13 -3
- package/dist/core/runner/prepare-park-ask.js +25 -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 +7 -6
- package/dist/core/runner/prepare-question-face.js +7 -6
- package/dist/core/runner/prepare-suspend-saga.d.ts +3 -0
- package/dist/core/runner/prepare-suspend-saga.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +3 -3
- package/dist/core/runner/prepare-task.js +113 -61
- package/dist/core/runner/prepare-tool-disclosure-mount.js +6 -5
- package/dist/core/runner/prepare-turn-wiring.d.ts +33 -7
- package/dist/core/runner/prepare-turn-wiring.js +53 -17
- package/dist/core/runner/prepare-wiring-manifest.d.ts +42 -5
- package/dist/core/runner/prepare-wiring-manifest.js +81 -42
- package/dist/core/runner/prepare-workspace-restore.js +3 -2
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/reply-pricing.d.ts +31 -18
- package/dist/core/runner/reply-pricing.js +10 -15
- package/dist/core/runner/resume-admission.js +10 -15
- package/dist/core/runner/resume-apply.js +20 -9
- package/dist/core/runner/resume-checkpoint-screen.js +2 -4
- package/dist/core/runner/resume-internals-and-config.d.ts +12 -9
- package/dist/core/runner/resume-internals-and-config.js +37 -9
- package/dist/core/runner/resume-preflight.js +3 -3
- package/dist/core/runner/retired-runner-deps.js +3 -0
- package/dist/core/runner/rewind-files.js +6 -6
- package/dist/core/runner/run-attachment-seats.d.ts +1 -3
- package/dist/core/runner/run-attachment-seats.js +1 -6
- package/dist/core/runner/run-brain-sinks.d.ts +4 -7
- package/dist/core/runner/run-brain-sinks.js +7 -10
- package/dist/core/runner/run-clock-and-content.d.ts +8 -5
- package/dist/core/runner/run-clock-and-content.js +18 -3
- package/dist/core/runner/run-compaction-machinery.d.ts +8 -4
- package/dist/core/runner/run-compaction-machinery.js +4 -19
- package/dist/core/runner/run-git-lane.d.ts +8 -3
- package/dist/core/runner/run-git-lane.js +5 -3
- package/dist/core/runner/run-harness-handlers.d.ts +4 -1
- package/dist/core/runner/run-harness-handlers.js +70 -45
- package/dist/core/runner/run-identity-wiring.d.ts +6 -0
- package/dist/core/runner/run-identity-wiring.js +17 -8
- package/dist/core/runner/run-leg.d.ts +5 -2
- package/dist/core/runner/run-leg.js +156 -71
- package/dist/core/runner/run-notification-lane.d.ts +1 -1
- package/dist/core/runner/run-notification-lane.js +22 -10
- package/dist/core/runner/run-recovery-lanes.js +8 -6
- package/dist/core/runner/run-settle-and-teardown.d.ts +4 -0
- package/dist/core/runner/run-settle-and-teardown.js +77 -26
- package/dist/core/runner/run-stop-and-final-verify.js +46 -12
- package/dist/core/runner/run-telemetry-and-budget-seats.js +13 -28
- package/dist/core/runner/run-terminal-adoption.d.ts +2 -2
- package/dist/core/runner/run-terminal-adoption.js +14 -9
- package/dist/core/runner/run-tool-mount-facts.js +5 -9
- package/dist/core/runner/run-turn-boundary.d.ts +3 -2
- package/dist/core/runner/run-turn-boundary.js +112 -106
- package/dist/core/runner/runtask.d.ts +28 -8
- package/dist/core/runner/runtask.js +132 -41
- package/dist/core/runner/session-file-state-replay.d.ts +5 -3
- package/dist/core/runner/session-file-state-replay.js +10 -3
- package/dist/core/runner/session-rule-policy.d.ts +3 -3
- package/dist/core/runner/session-verb-doors.d.ts +18 -3
- package/dist/core/runner/session-verb-doors.js +38 -6
- package/dist/core/runner/shell-env-withheld.d.ts +8 -5
- package/dist/core/runner/shell-env-withheld.js +4 -4
- package/dist/core/runner/side-call-account.d.ts +12 -8
- package/dist/core/runner/side-call-account.js +24 -15
- package/dist/core/runner/stream-halt-verbs.js +1 -0
- package/dist/core/runner/stream-mode-verb.js +2 -1
- package/dist/core/runner/stream-settle-backstop.js +4 -1
- package/dist/core/runner/stream-steer-verb.js +35 -19
- package/dist/core/runner/sub-agent-deny-lists.d.ts +47 -11
- package/dist/core/runner/sub-agent-deny-lists.js +140 -39
- package/dist/core/runner/teardown-bounded.d.ts +6 -0
- package/dist/core/runner/teardown-bounded.js +12 -7
- package/dist/core/runner/terminal-account.d.ts +2 -0
- package/dist/core/runner/terminal-account.js +6 -1
- package/dist/core/runner/tool-disclosure.js +2 -1
- package/dist/core/runner/tool-end-body.js +3 -1
- package/dist/core/runner/tool-face-overlay.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +34 -9
- package/dist/core/runner/tool-occurrence.js +32 -21
- package/dist/core/runner/tool-progress-lane.d.ts +20 -5
- package/dist/core/runner/tool-progress-lane.js +27 -5
- package/dist/core/runner/tool-result-media-seat.d.ts +15 -4
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- package/dist/core/runner/tool-table-view.js +1 -1
- package/dist/core/runner/turn-attachments.d.ts +44 -71
- package/dist/core/runner/turn-attachments.js +52 -104
- package/dist/core/runner/usage-accounting.d.ts +3 -2
- package/dist/core/runner/usage-accounting.js +3 -2
- package/dist/core/runner/void-verifier-pause.js +1 -1
- package/dist/core/runner-deps.d.ts +42 -158
- package/dist/core/runtime-caps.d.ts +16 -4
- package/dist/core/secret-env.d.ts +20 -3
- package/dist/core/secret-env.js +46 -23
- package/dist/core/sensitive-path-policy.d.ts +8 -0
- package/dist/core/sensitive-path-policy.js +10 -2
- package/dist/core/session-checkout.d.ts +32 -27
- package/dist/core/session-checkout.js +109 -61
- package/dist/core/session-log-transfer.js +2 -1
- package/dist/core/session-policy-store.d.ts +24 -11
- package/dist/core/session-policy-store.js +11 -2
- package/dist/core/session-store.d.ts +16 -2
- package/dist/core/session-store.js +43 -17
- package/dist/core/session.d.ts +31 -3
- package/dist/core/session.js +33 -2
- package/dist/core/shell-run-candidates.d.ts +20 -8
- package/dist/core/shell-run-candidates.js +44 -21
- package/dist/core/side-query.d.ts +17 -5
- package/dist/core/side-query.js +17 -14
- package/dist/core/skill-grant.js +2 -3
- package/dist/core/skills-directory.js +3 -66
- package/dist/core/snapshot-frame-seat.d.ts +8 -0
- package/dist/core/snapshot-frame-seat.js +24 -0
- package/dist/core/steer-replay.d.ts +19 -3
- package/dist/core/steer-replay.js +8 -1
- package/dist/core/store-contracts/background-agent-store-contract.d.ts +17 -2
- package/dist/core/store-contracts/background-agent-store-contract.js +131 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +63 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +15 -2
- package/dist/core/store-contracts/mailbox-store-contract.js +213 -3
- package/dist/core/store-contracts/permission-rule-write-contract.js +24 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.d.ts +15 -0
- package/dist/core/store-contracts/session-deletion-cascade-contract.js +288 -0
- package/dist/core/store-contracts/session-policy-store-contract.js +57 -36
- package/dist/core/store-contracts/session-repo-contract.js +130 -5
- package/dist/core/store-contracts/session-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/session-store-contract.js +17 -0
- package/dist/core/store-contracts/task-list-store-contract.d.ts +32 -0
- package/dist/core/store-contracts/task-list-store-contract.js +240 -0
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +41 -0
- package/dist/core/stub-env.d.ts +2 -2
- package/dist/core/stub-env.js +1 -0
- package/dist/core/synthetic-read-verdict.d.ts +38 -28
- package/dist/core/synthetic-read-verdict.js +19 -28
- package/dist/core/task-event.d.ts +171 -19
- package/dist/core/task-intake.d.ts +26 -0
- package/dist/core/task-intake.js +31 -0
- package/dist/core/task-limits.d.ts +8 -6
- package/dist/core/task-notification.d.ts +88 -8
- package/dist/core/task-notification.js +45 -5
- package/dist/core/task-registry-agent.d.ts +24 -7
- package/dist/core/task-registry-agent.js +51 -28
- package/dist/core/task-registry-monitor.js +16 -14
- package/dist/core/task-registry-shared.d.ts +177 -35
- package/dist/core/task-registry-shared.js +44 -17
- package/dist/core/task-registry-workflow.js +8 -5
- package/dist/core/task-registry-yield.d.ts +32 -0
- package/dist/core/task-registry-yield.js +85 -0
- package/dist/core/task-registry.d.ts +88 -10
- package/dist/core/task-registry.js +124 -33
- package/dist/core/task-result.d.ts +115 -31
- package/dist/core/task-spec-members.d.ts +140 -1
- package/dist/core/task-spec-members.js +23 -8
- package/dist/core/task-spec.d.ts +181 -51
- package/dist/core/task-spec.js +1 -1
- package/dist/core/task-stream.d.ts +12 -2
- package/dist/core/terminal-cause.d.ts +12 -4
- package/dist/core/thrown-value.d.ts +49 -7
- package/dist/core/thrown-value.js +38 -2
- package/dist/core/tool-catalog-entries.js +13 -3
- package/dist/core/tool-data-door.d.ts +7 -0
- package/dist/core/tool-data-door.js +13 -0
- package/dist/core/tool-face-lists.d.ts +25 -0
- package/dist/core/tool-face-lists.js +38 -0
- package/dist/core/tool-face-reader.d.ts +0 -10
- package/dist/core/tool-face-reader.js +5 -3
- package/dist/core/tool-list-grammar.d.ts +103 -0
- package/dist/core/tool-list-grammar.js +130 -0
- package/dist/core/tool-mount-facts.d.ts +47 -0
- package/dist/core/tool-mount-facts.js +50 -0
- package/dist/core/tool-mount-plan.d.ts +196 -0
- package/dist/core/tool-mount-plan.js +404 -0
- package/dist/core/tool-mount-static.d.ts +12 -0
- package/dist/core/tool-mount-static.js +174 -0
- package/dist/core/tool-name-aliases.d.ts +60 -2
- package/dist/core/tool-name-aliases.js +22 -2
- package/dist/core/tool-name-list.d.ts +3 -0
- package/dist/core/tool-name-readings.d.ts +4 -0
- package/dist/core/tool-name-readings.js +1 -0
- package/dist/core/tool-policy.d.ts +246 -51
- package/dist/core/tool-policy.js +165 -71
- package/dist/core/tool-registry.d.ts +4 -11
- package/dist/core/tool-registry.js +0 -3
- package/dist/core/tool-result-bytes.d.ts +94 -0
- package/dist/core/tool-result-bytes.js +34 -0
- package/dist/core/tool-result-store.d.ts +97 -13
- package/dist/core/tool-result-store.js +52 -4
- package/dist/core/tool-roster.d.ts +71 -10
- package/dist/core/tool-roster.js +71 -21
- package/dist/core/tool-search-setting.d.ts +7 -9
- package/dist/core/tool-search-setting.js +23 -7
- package/dist/core/tool-spec.d.ts +32 -2
- package/dist/core/tools.js +6 -20
- package/dist/core/trace.d.ts +63 -11
- package/dist/core/trace.js +19 -0
- package/dist/core/types.d.ts +8 -6
- package/dist/core/types.js +3 -1
- package/dist/core/unmatched-tool-names.d.ts +37 -0
- package/dist/core/unmatched-tool-names.js +18 -0
- package/dist/core/untrusted-egress.d.ts +16 -5
- package/dist/core/untrusted-egress.js +202 -32
- package/dist/core/untrusted-text.d.ts +29 -8
- package/dist/core/untrusted-text.js +6 -3
- package/dist/core/user-attachment.d.ts +129 -35
- package/dist/core/user-attachment.js +124 -57
- package/dist/core/user-row-origin.d.ts +63 -0
- package/dist/core/user-row-origin.js +61 -0
- package/dist/core/wiring-manifest.d.ts +161 -39
- package/dist/core/wiring-manifest.js +42 -6
- package/dist/core/workflow-run-store-contract.d.ts +11 -1
- package/dist/core/workflow-run-store-contract.js +60 -7
- package/dist/core/workflow-run-store.d.ts +61 -12
- package/dist/core/workflow-run-store.js +100 -15
- package/dist/core/workspace-snapshot.d.ts +10 -14
- package/dist/core/workspace-snapshot.js +3 -22
- package/dist/core/write-protect.d.ts +3 -5
- package/dist/core/write-protect.js +2 -4
- package/dist/engine/compaction/compaction.d.ts +3 -0
- package/dist/engine/compaction/compaction.js +4 -3
- package/dist/engine/execution-env/node-execution-env.d.ts +15 -4
- package/dist/engine/execution-env/node-execution-env.js +80 -27
- package/dist/engine/harness/agent-harness.d.ts +143 -27
- package/dist/engine/harness/agent-harness.js +162 -74
- package/dist/engine/harness/types.d.ts +84 -13
- package/dist/engine/harness/types.js +21 -1
- package/dist/engine/llm/tool-turns.d.ts +4 -0
- package/dist/engine/llm/tool-turns.js +7 -2
- package/dist/engine/llm/types.d.ts +111 -24
- package/dist/engine/llm/types.js +69 -5
- package/dist/engine/llm/validation.js +2 -1
- package/dist/engine/loop/agent-loop.d.ts +39 -6
- package/dist/engine/loop/agent-loop.js +172 -82
- package/dist/engine/loop/types.d.ts +43 -4
- package/dist/engine/lsp/node-lsp-manager.d.ts +5 -3
- package/dist/engine/lsp/node-lsp-manager.js +14 -10
- package/dist/engine/session/import-validate.js +9 -0
- package/dist/engine/session/memory-repo.d.ts +8 -1
- package/dist/engine/session/memory-repo.js +20 -12
- package/dist/engine/session/repo-utils.d.ts +10 -0
- package/dist/engine/session/repo-utils.js +11 -5
- package/dist/engine/session/row-cells.d.ts +32 -0
- package/dist/engine/session/row-cells.js +25 -0
- package/dist/index.d.ts +63 -34
- package/dist/index.js +44 -21
- package/dist/internal/harness.d.ts +8 -6
- package/dist/internal/harness.js +6 -4
- package/dist/internal/llm.d.ts +2 -2
- package/dist/internal/llm.js +1 -1
- package/dist/orchestration/governance-baseline-validity.d.ts +7 -0
- package/dist/orchestration/governance-baseline-validity.js +33 -9
- package/dist/orchestration/run-workflow-tool.d.ts +2 -0
- package/dist/orchestration/run-workflow-tool.js +25 -12
- package/dist/orchestration/workflow-governance.d.ts +19 -4
- package/dist/orchestration/workflow-governance.js +30 -9
- package/dist/orchestration/workflow-primitives.d.ts +4 -1
- package/dist/orchestration/workflow-primitives.js +2 -2
- package/dist/orchestration/workflow-script-runner.d.ts +1 -1
- package/dist/orchestration/workflow-size-guideline.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +21 -12
- package/dist/orchestration/workflow-types.js +15 -4
- package/dist/orchestration/workflow.d.ts +37 -7
- package/dist/orchestration/workflow.js +81 -35
- package/dist/prompt-assembly/artifact-store.js +6 -9
- package/dist/prompt-assembly/assemble.d.ts +4 -10
- package/dist/prompt-assembly/assemble.js +1 -3
- package/dist/prompt-assembly/catalog/constitution.d.ts +0 -20
- package/dist/prompt-assembly/catalog/constitution.js +2 -0
- package/dist/prompt-assembly/catalog/core-behavior.js +5 -3
- package/dist/prompt-assembly/catalog/engine.d.ts +108 -0
- package/dist/prompt-assembly/catalog/engine.js +19 -0
- package/dist/prompt-assembly/catalog/environment.d.ts +276 -0
- package/dist/prompt-assembly/catalog/environment.js +61 -0
- package/dist/prompt-assembly/catalog/index.d.ts +9 -2
- package/dist/prompt-assembly/catalog/index.js +73 -2
- package/dist/prompt-assembly/catalog/locales/index.d.ts +16 -0
- package/dist/prompt-assembly/catalog/locales/index.js +22 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/constitution.js +124 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/core-behavior.js +120 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.d.ts +8 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/cowork.js +442 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/engine.js +15 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/environment.js +50 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/modes.js +163 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.d.ts +7 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/role.js +148 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.d.ts +6 -0
- package/dist/prompt-assembly/catalog/locales/zh-Hans/team.js +246 -0
- package/dist/prompt-assembly/catalog/role.js +3 -6
- package/dist/prompt-assembly/catalog/schema.d.ts +23 -1
- package/dist/prompt-assembly/catalog/schema.js +2 -0
- package/dist/prompt-assembly/composer.d.ts +6 -11
- package/dist/prompt-assembly/composer.js +7 -7
- package/dist/prompt-assembly/engine-text.d.ts +9 -0
- package/dist/prompt-assembly/engine-text.js +33 -0
- package/dist/prompt-assembly/event-registry.js +3 -3
- package/dist/prompt-assembly/explain.d.ts +1 -0
- package/dist/prompt-assembly/explain.js +1 -1
- package/dist/prompt-assembly/locale-review.d.ts +13 -0
- package/dist/prompt-assembly/locale-review.js +19 -0
- package/dist/prompt-assembly/overlay.d.ts +7 -3
- package/dist/prompt-assembly/overlay.js +27 -5
- package/dist/prompt-assembly/renderers.d.ts +4 -4
- package/dist/prompt-assembly/renderers.js +26 -17
- package/dist/prompt-assembly/role-base.d.ts +1 -1
- package/dist/prompt-assembly/select.d.ts +26 -5
- package/dist/prompt-assembly/select.js +25 -2
- package/dist/prompt-assembly/slots.d.ts +19 -0
- package/dist/prompt-assembly/slots.js +16 -0
- package/dist/prompt-assembly/sugar.d.ts +4 -7
- package/dist/prompt-assembly/sugar.js +1 -2
- package/dist/prompt-assembly/tool-catalog.d.ts +5 -1
- package/dist/prompt-assembly/tool-catalog.js +5 -1
- package/dist/prompt-assembly/turn-snapshot.d.ts +38 -10
- package/dist/prompt-assembly/turn-snapshot.js +43 -13
- package/dist/prompt-assembly/types.d.ts +3 -0
- package/dist/prompts/cowork.d.ts +6 -25
- package/dist/prompts/cowork.js +10 -12
- package/dist/prompts/default.d.ts +10 -32
- package/dist/prompts/default.js +37 -63
- package/dist/shell/lex.d.ts +39 -13
- package/dist/shell/lex.js +70 -30
- package/dist/stores/file/background-agent-store.d.ts +5 -0
- package/dist/stores/file/background-agent-store.js +35 -61
- package/dist/stores/file/checkpoint-store.d.ts +5 -3
- package/dist/stores/file/checkpoint-store.js +8 -10
- package/dist/stores/file/fs-atomic.d.ts +27 -70
- package/dist/stores/file/fs-atomic.js +52 -148
- package/dist/stores/file/index.d.ts +12 -0
- package/dist/stores/file/index.js +27 -2
- package/dist/stores/file/mailbox-store.d.ts +10 -1
- package/dist/stores/file/mailbox-store.js +40 -12
- package/dist/stores/file/permission-rule-adopt.js +5 -2
- package/dist/stores/file/permission-rule-store.d.ts +81 -20
- package/dist/stores/file/permission-rule-store.js +126 -33
- package/dist/stores/file/session-policy-store.d.ts +2 -2
- package/dist/stores/file/session-store.d.ts +21 -2
- package/dist/stores/file/session-store.js +27 -14
- package/dist/stores/file/task-list-store.js +23 -25
- package/dist/stores/file/tool-result-store.d.ts +45 -7
- package/dist/stores/file/tool-result-store.js +99 -36
- package/dist/stores/file/workflow-run-store.d.ts +1 -0
- package/dist/stores/file/workflow-run-store.js +14 -11
- package/dist/tools/artifact/artifact-tool.js +2 -0
- package/dist/tools/artifact/local-stub.js +6 -6
- package/dist/tools/fs/bash-program-position.d.ts +1 -2
- package/dist/tools/fs/bash-readonly-classifier.d.ts +35 -0
- package/dist/tools/fs/bash-readonly-classifier.js +50 -12
- package/dist/tools/fs/env-error-detail.d.ts +1 -0
- package/dist/tools/fs/env-error-detail.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +24 -6
- package/dist/tools/fs/fs-bash.js +73 -25
- package/dist/tools/fs/fs-pdf.js +6 -4
- package/dist/tools/fs/fs-read.d.ts +76 -31
- package/dist/tools/fs/fs-read.js +159 -79
- package/dist/tools/fs/fs-search-tools.d.ts +1 -1
- package/dist/tools/fs/fs-search-tools.js +3 -1
- package/dist/tools/fs/fs-shared.d.ts +59 -63
- package/dist/tools/fs/fs-shared.js +31 -18
- package/dist/tools/fs/fs-write.d.ts +13 -0
- package/dist/tools/fs/fs-write.js +69 -13
- package/dist/tools/fs/index.d.ts +19 -1
- package/dist/tools/fs/index.js +10 -2
- package/dist/tools/fs/pdf.js +10 -9
- package/dist/tools/fs/read-deny.js +4 -10
- package/dist/tools/fs/read-floor.d.ts +5 -4
- package/dist/tools/fs/removal-targets.d.ts +11 -5
- package/dist/tools/fs/removal-targets.js +62 -32
- package/dist/tools/fs/safety.d.ts +26 -19
- package/dist/tools/fs/safety.js +13 -8
- package/dist/tools/fs/search.d.ts +1 -1
- package/dist/tools/fs/shell-read-argv.js +1 -0
- package/dist/tools/fs/shell-read-bindings.d.ts +128 -26
- package/dist/tools/fs/shell-read-bindings.js +667 -139
- package/dist/tools/fs/shell-read-check.js +1 -1
- package/dist/tools/fs/shell-read-judge.d.ts +4 -1
- package/dist/tools/fs/shell-read-judge.js +5 -1
- package/dist/tools/fs/shell-read-plan.d.ts +4 -0
- package/dist/tools/fs/shell-read-plan.js +21 -19
- package/dist/tools/fs/shell-read-sourced.d.ts +4 -3
- package/dist/tools/fs/shell-read-sourced.js +18 -1
- package/dist/tools/fs/shell-read-start.d.ts +6 -6
- package/dist/tools/fs/shell-read-start.js +1 -6
- package/dist/tools/fs/shell-read-word.d.ts +4 -2
- package/dist/tools/fs/shell-read-word.js +7 -6
- package/dist/tools/fs/shell-read-workdir.d.ts +1 -1
- package/dist/tools/fs/shell-reentry-text.d.ts +24 -9
- package/dist/tools/fs/shell-reentry-text.js +50 -20
- package/dist/tools/monitor.d.ts +4 -0
- package/dist/tools/monitor.js +14 -4
- package/dist/tools/scheduler-tools.d.ts +5 -2
- package/dist/tools/scheduler-tools.js +8 -6
- package/dist/tools/task-list.d.ts +49 -20
- package/dist/tools/task-list.js +115 -35
- package/dist/tools/web.d.ts +13 -3
- package/dist/tools/web.js +17 -6
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +24 -25
- package/package.json +10 -3
- package/test/export-surface.snapshot.json +330 -32
- package/wire-changes/core-stores-sql@7.66.1.json +30 -0
- package/wire-changes/core-stores-sql@7.67.0.json +39 -0
- package/wire-changes/core@7.66.1.json +46 -0
- package/wire-changes/core@7.67.0.json +12578 -0
- package/wire-changes/mods-kernel@7.66.1.json +30 -0
- package/wire-changes/mods-kernel@7.67.0.json +167 -0
- package/wire-changes/primitives@7.66.1.json +30 -0
- package/wire-changes/primitives@7.67.0.json +325 -0
- package/wire-changes/wiki-gate@7.67.0.json +1636 -0
- package/dist/brain/degrading.d.ts +0 -93
- package/dist/brain/degrading.js +0 -189
- package/dist/core/tool-conformance.d.ts +0 -20
- package/dist/core/tool-conformance.js +0 -37
|
@@ -4,30 +4,42 @@
|
|
|
4
4
|
* A parent model answers "how far along is it?" from what its read faces show. Three faces read a
|
|
5
5
|
* background agent: AgentTranscript (its recent steps), ListAgents (the roster) and the host task poll.
|
|
6
6
|
* Each one projects {@link readAgentState}'s result and renders it with {@link agentStateSummary} /
|
|
7
|
-
* {@link agentActivityClause} / {@link
|
|
7
|
+
* {@link agentActivityClause} / {@link agentParkClause}; none derives status, activity time or park
|
|
8
8
|
* facts on its own, so the three cannot disagree about one agent at one instant.
|
|
9
9
|
*
|
|
10
10
|
* Sources:
|
|
11
11
|
* - the registry row — the live handle this engine process runs ({@link agentStateSourceOfHandle}), or the
|
|
12
12
|
* durable record when no live handle answers ({@link agentStateSourceOfRecord});
|
|
13
|
-
* - for a row whose status is `parked` only, the
|
|
14
|
-
*
|
|
15
|
-
*
|
|
13
|
+
* - for a row whose status is `parked` only, the checkpoint the row names, read through the run's checkpoint
|
|
14
|
+
* seat (the same seat the Agent tool parks children into). The checkpoint is the ONE source of what the park
|
|
15
|
+
* waits on (its gate): a person's approval, or a resource limit — a scheduler's yield among them. The token is
|
|
16
|
+
* the resume capability and never leaves this module: a face renders the checkpoint's non-secret `checkpointId`.
|
|
16
17
|
*
|
|
17
18
|
* Absence is stated, never left silent: a missing activity time renders as "last activity unknown (…why)",
|
|
18
|
-
* and a parked row whose card cannot be read carries `
|
|
19
|
-
* goes quiet on a fact invites the reader to fill the gap with a guess.
|
|
19
|
+
* and a parked row whose card cannot be read carries `park.state` `missing` / `unreadable` (and no gate). A face
|
|
20
|
+
* that goes quiet on a fact invites the reader to fill the gap with a guess.
|
|
20
21
|
*/
|
|
21
22
|
import type { SemaTaskStatus } from "./task-registry-shared.js";
|
|
22
23
|
import { type CheckpointSeat } from "./checkpoint-seat.js";
|
|
23
|
-
|
|
24
|
+
import type { CheckpointGate, ResourceLimitReason } from "./checkpoint-store.js";
|
|
25
|
+
/** The park card's state: the checkpoint row's own `status`, plus `missing` (the row names no card, or
|
|
24
26
|
* the store holds none under its token) and `unreadable` (no checkpoint seat on this face, or the store
|
|
25
27
|
* threw). The same five answers the parked-row reconciliation sweep gives the same question. */
|
|
26
|
-
export type
|
|
27
|
-
/**
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
28
|
+
export type AgentParkState = "pending" | "resolved" | "expired" | "missing" | "unreadable";
|
|
29
|
+
/** What a parked agent waits on — its checkpoint's gate, reduced to the non-secret kind (and, for a resource
|
|
30
|
+
* limit, the closed reason word; the other kinds' free-text reason never leaves the card). */
|
|
31
|
+
export type AgentParkGate = {
|
|
32
|
+
readonly kind: "resource_limit";
|
|
33
|
+
readonly reason: ResourceLimitReason;
|
|
34
|
+
} | {
|
|
35
|
+
readonly kind: Exclude<CheckpointGate["kind"], "resource_limit">;
|
|
36
|
+
};
|
|
37
|
+
/** The checkpoint a parked agent waits on. */
|
|
38
|
+
export interface AgentPark {
|
|
39
|
+
state: AgentParkState;
|
|
40
|
+
/** What the park waits on, read off the checkpoint. Present when the card was read and carries a known gate. */
|
|
41
|
+
gate?: AgentParkGate;
|
|
42
|
+
/** The checkpoint's non-secret identity (the card id a person sees in an approval inbox). Present when
|
|
31
43
|
* the card was read and carries one. */
|
|
32
44
|
checkpointId?: string;
|
|
33
45
|
/** The card's SLA / abandonment deadline, epoch ms. Present when the card was read and carries one. */
|
|
@@ -49,7 +61,7 @@ export interface AgentState {
|
|
|
49
61
|
* process is not observable here), or a row that never recorded one. */
|
|
50
62
|
lastActivityAt?: number;
|
|
51
63
|
/** Present exactly when {@link status} is `parked`. */
|
|
52
|
-
|
|
64
|
+
park?: AgentPark;
|
|
53
65
|
}
|
|
54
66
|
/** The row facts {@link readAgentState} reads. Built by the two projections below — never by a face. */
|
|
55
67
|
export interface AgentStateSource {
|
|
@@ -85,7 +97,8 @@ export declare function readAgentState(src: AgentStateSource, seat: CheckpointSe
|
|
|
85
97
|
export declare function formatAgo(ms: number): string;
|
|
86
98
|
/** `last activity <age> ago`, or the reason the time is unknown. */
|
|
87
99
|
export declare function agentActivityClause(s: AgentState): string;
|
|
88
|
-
/**
|
|
89
|
-
|
|
90
|
-
|
|
100
|
+
/** `<what it waits on> <card id> <state>[ (deadline in <age> | deadline passed <age> ago)]` — facts only; a pending
|
|
101
|
+
* yield adds when it continues (nobody decides it: its owner's next run does). */
|
|
102
|
+
export declare function agentParkClause(p: AgentPark, readAt: number): string;
|
|
103
|
+
/** The one-line state sentence: `<status> · <activity clause>[ · <park clause>]`. */
|
|
91
104
|
export declare function agentStateSummary(s: AgentState): string;
|
package/dist/core/agent-state.js
CHANGED
|
@@ -19,7 +19,24 @@ export function agentStateSourceOfRecord(r) {
|
|
|
19
19
|
};
|
|
20
20
|
}
|
|
21
21
|
const finite = (n) => typeof n === "number" && Number.isFinite(n);
|
|
22
|
-
|
|
22
|
+
const PARK_GATE_WORDS = {
|
|
23
|
+
human: "approval",
|
|
24
|
+
irreversible_ask: "approval",
|
|
25
|
+
needs_review: "review",
|
|
26
|
+
plan_review: "review",
|
|
27
|
+
task_done: "awaiting task",
|
|
28
|
+
resource_limit: null,
|
|
29
|
+
};
|
|
30
|
+
const RESOURCE_LIMIT_REASONS = { budget_tokens: true, budget_cost: true, walltime: true, turns: true, preempt: true, usage_window: true, env_lifetime: true };
|
|
31
|
+
function parkGateOf(gate) {
|
|
32
|
+
const g = gate;
|
|
33
|
+
if (typeof g?.kind !== "string" || !Object.hasOwn(PARK_GATE_WORDS, g.kind))
|
|
34
|
+
return undefined;
|
|
35
|
+
if (g.kind !== "resource_limit")
|
|
36
|
+
return { kind: g.kind };
|
|
37
|
+
return typeof g.reason === "string" && Object.hasOwn(RESOURCE_LIMIT_REASONS, g.reason) ? { kind: "resource_limit", reason: g.reason } : undefined;
|
|
38
|
+
}
|
|
39
|
+
async function readParkCard(store, token) {
|
|
23
40
|
let cp;
|
|
24
41
|
try {
|
|
25
42
|
cp = (await store.get(token));
|
|
@@ -30,8 +47,10 @@ async function readApprovalCard(store, token) {
|
|
|
30
47
|
if (cp === null || cp === undefined)
|
|
31
48
|
return { state: "missing" };
|
|
32
49
|
const state = cp.status === "pending" || cp.status === "resolved" || cp.status === "expired" ? cp.status : "unreadable";
|
|
50
|
+
const gate = parkGateOf(cp.gate);
|
|
33
51
|
return {
|
|
34
52
|
state,
|
|
53
|
+
...(gate !== undefined ? { gate } : {}),
|
|
35
54
|
...(typeof cp.checkpointId === "string" && cp.checkpointId !== "" ? { checkpointId: cp.checkpointId } : {}),
|
|
36
55
|
...(finite(cp.deadline) ? { deadline: cp.deadline } : {}),
|
|
37
56
|
};
|
|
@@ -46,11 +65,11 @@ export function readAgentState(src, seat, now) {
|
|
|
46
65
|
if (base.status !== "parked")
|
|
47
66
|
return base;
|
|
48
67
|
if (src.parkedCheckpointToken === undefined)
|
|
49
|
-
return { ...base,
|
|
68
|
+
return { ...base, park: { state: "missing" } };
|
|
50
69
|
const store = checkpointStoreOfSeat(seat);
|
|
51
70
|
if (store === undefined)
|
|
52
|
-
return { ...base,
|
|
53
|
-
return
|
|
71
|
+
return { ...base, park: { state: "unreadable" } };
|
|
72
|
+
return readParkCard(store, src.parkedCheckpointToken).then((park) => ({ ...base, park }));
|
|
54
73
|
}
|
|
55
74
|
export function formatAgo(ms) {
|
|
56
75
|
const sec = Math.max(0, Math.floor(ms / 1000));
|
|
@@ -69,11 +88,19 @@ export function agentActivityClause(s) {
|
|
|
69
88
|
return `last activity ${formatAgo(s.readAt - s.lastActivityAt)} ago`;
|
|
70
89
|
return s.row === "durable_row" && s.status === "running" ? "last activity unknown (recorded as running by another engine process)" : "last activity unknown (not recorded)";
|
|
71
90
|
}
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
91
|
+
function parkWord(gate) {
|
|
92
|
+
if (gate === undefined)
|
|
93
|
+
return "park";
|
|
94
|
+
if (gate.kind !== "resource_limit")
|
|
95
|
+
return PARK_GATE_WORDS[gate.kind];
|
|
96
|
+
return gate.reason === "preempt" ? "yielded" : `paused (${gate.reason})`;
|
|
97
|
+
}
|
|
98
|
+
export function agentParkClause(p, readAt) {
|
|
99
|
+
const id = p.checkpointId !== undefined ? ` ${inlineUntrusted(p.checkpointId, 64)}` : "";
|
|
100
|
+
const deadline = p.deadline === undefined ? "" : p.deadline > readAt ? ` (deadline in ${formatAgo(p.deadline - readAt)})` : ` (deadline passed ${formatAgo(readAt - p.deadline)} ago)`;
|
|
101
|
+
const continues = p.state === "pending" && p.gate?.kind === "resource_limit" && p.gate.reason === "preempt" ? " — continues when its owner runs again" : "";
|
|
102
|
+
return `${parkWord(p.gate)}${id} ${p.state}${deadline}${continues}`;
|
|
76
103
|
}
|
|
77
104
|
export function agentStateSummary(s) {
|
|
78
|
-
return [s.status, agentActivityClause(s), ...(s.
|
|
105
|
+
return [s.status, agentActivityClause(s), ...(s.park !== undefined ? [agentParkClause(s.park, s.readAt)] : [])].join(" · ");
|
|
79
106
|
}
|
|
@@ -386,9 +386,16 @@ export declare function allowRuleShadowSentence(shadows: readonly AllowRuleShado
|
|
|
386
386
|
authoredBy?: "deployment";
|
|
387
387
|
probeReason?: string;
|
|
388
388
|
}): string;
|
|
389
|
-
/** The card
|
|
390
|
-
*
|
|
391
|
-
|
|
389
|
+
/** The question a card asks when the decision carried no sentence of its own — the one fallback every approval request
|
|
390
|
+
* and every parked row of the gate's own lane shares. */
|
|
391
|
+
export declare const askFallbackMessage: (toolName: string) => string;
|
|
392
|
+
/** The provenance sentence an inherited card carries when the ancestor's ask brought no words of its own — the one spelling
|
|
393
|
+
* the inherited request mint, the frame join and the park of that ask (floated back unresolved) share. */
|
|
394
|
+
export declare const inheritedAskFallbackMessage: (toolName: string) => string;
|
|
395
|
+
/** The card's disclosure members off a surviving ask, minted at every station that builds an approval request and at the
|
|
396
|
+
* park twin that keeps the same members on the row: the sanitized records, the message with the sentence rendered onto
|
|
397
|
+
* it, the written ask rule the card stands for (relayed as written: a non-empty string or nothing), and the outlet of a
|
|
398
|
+
* person's rewritten edit (the approved-edit pass's own member, whose form is the bytes the card presents). */
|
|
392
399
|
export declare function cardDisclosureOf(decision: {
|
|
393
400
|
message?: string;
|
|
394
401
|
allowRuleShadowed?: unknown;
|
|
@@ -397,10 +404,12 @@ export declare function cardDisclosureOf(decision: {
|
|
|
397
404
|
authoredBy?: "deployment";
|
|
398
405
|
probeReason?: string;
|
|
399
406
|
editRewritten?: EditRewritten;
|
|
407
|
+
matchedAskRule?: unknown;
|
|
400
408
|
}, fallbackMessage: string): {
|
|
401
409
|
message: string;
|
|
402
410
|
allowRuleShadowed?: readonly AllowRuleShadow[];
|
|
403
411
|
editRewritten?: EditRewritten;
|
|
412
|
+
matchedAskRule?: string;
|
|
404
413
|
};
|
|
405
414
|
/** The notice for list entries that grant (or refuse) nothing — one code for every list. */
|
|
406
415
|
export declare const ALLOWED_TOOL_NOT_GRANTED_CODE = "permission.allowed_tool_not_granted";
|
package/dist/core/allow-entry.js
CHANGED
|
@@ -14,6 +14,7 @@ import { callTargetReadingOf } from "./effective-path-target.js";
|
|
|
14
14
|
import { splitShellCompoundSegments } from "../tools/fs/bash-readonly-classifier.js";
|
|
15
15
|
import { ASK_RULE_DISCLOSURE, MANDATE_DISCLOSURE, mandateDisclosureOf } from "./ask-origin.js";
|
|
16
16
|
import { inlineUntrusted, isMintableProbeReason } from "./untrusted-text.js";
|
|
17
|
+
import { callerText } from "./caller-text.js";
|
|
17
18
|
import { valueTypeLabel } from "./tool-name-list.js";
|
|
18
19
|
import { deliverEngineNotice } from "./engine-notice.js";
|
|
19
20
|
export const ALLOW_ENTRY_INERT_REASONS = Object.freeze(["wildcard_all", "namespace_wildcard", "content_unsupported", "grammar", "tool_name", "near_miss", "earlier_grammar"]);
|
|
@@ -374,7 +375,7 @@ function receiveAnchoredMember(entry, at) {
|
|
|
374
375
|
const member = receiveOwnProperties(entry, { subject: at, unit: "member", moment: "when the list is read" });
|
|
375
376
|
for (const key of Object.keys(member)) {
|
|
376
377
|
if (!ANCHORED_MEMBER_KEYS.has(key))
|
|
377
|
-
throw receiptRefusal(`${at} carries ${
|
|
378
|
+
throw receiptRefusal(`${at} carries ${callerText(key)}, which is not a member of an anchored entry (its members are rule and pathBases) — refused rather than read without it`);
|
|
378
379
|
}
|
|
379
380
|
const rule = Object.hasOwn(member, "rule") ? member.rule : undefined;
|
|
380
381
|
const pathBases = Object.hasOwn(member, "pathBases") ? member.pathBases : undefined;
|
|
@@ -386,7 +387,7 @@ function receiveAnchoredMember(entry, at) {
|
|
|
386
387
|
const held = Object.create(null);
|
|
387
388
|
for (const [word, value] of Object.entries(bases)) {
|
|
388
389
|
if (!PATH_BASE_WORDS.has(word))
|
|
389
|
-
throw receiptRefusal(`${at}.pathBases carries ${
|
|
390
|
+
throw receiptRefusal(`${at}.pathBases carries ${callerText(word)}, which is not a base word (${PATH_RULE_BASES.join(", ")}) — refused rather than read without it`);
|
|
390
391
|
if (typeof value !== "string")
|
|
391
392
|
throw receiptRefusal(`${at}.pathBases.${word} must be a path string (got ${valueTypeLabel(value)})`);
|
|
392
393
|
held[word] = value;
|
|
@@ -533,9 +534,15 @@ export function allowRuleShadowSentence(shadows, ask) {
|
|
|
533
534
|
: SHADOW_REASON[askClass ?? "ordinary"];
|
|
534
535
|
return `${shadows.map(memberPhrase).join("; ")} ${one ? "matches this call but does not clear the ask" : "match this call but do not clear the ask"}${why !== undefined ? ` — ${why}` : ""}`;
|
|
535
536
|
}
|
|
537
|
+
export const askFallbackMessage = (toolName) => `approval required for "${toolName}"`;
|
|
538
|
+
export const inheritedAskFallbackMessage = (toolName) => `approval required for "${toolName}" (inherited parent policy)`;
|
|
536
539
|
export function cardDisclosureOf(decision, fallbackMessage) {
|
|
537
540
|
const base = decision.message ?? fallbackMessage;
|
|
538
|
-
const
|
|
541
|
+
const rule = decision.matchedAskRule;
|
|
542
|
+
const outlet = {
|
|
543
|
+
...(decision.editRewritten !== undefined ? { editRewritten: decision.editRewritten } : {}),
|
|
544
|
+
...(typeof rule === "string" && rule.length > 0 ? { matchedAskRule: rule } : {}),
|
|
545
|
+
};
|
|
539
546
|
const shadows = readAllowRuleShadows(decision.allowRuleShadowed);
|
|
540
547
|
if (shadows === undefined)
|
|
541
548
|
return { message: base, ...outlet };
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The approval card's display sanitizer and size bound — one reading for every value the engine hands an approval
|
|
3
|
+
* surface as display metadata: the tool's approval preview at the card's mint, and the card's question as the parked
|
|
4
|
+
* row keeps it. A leaf: it imports nothing, so the gate lane and the park twin read the same rule.
|
|
5
|
+
*
|
|
6
|
+
* Every string leaf is model-, tool- or policy-authored and flows to approval UIs: control characters (terminal
|
|
7
|
+
* escapes, CR; `\n` and `\t` kept for legible multi-line detail) become U+2400 here, so no lane forwards a raw escape
|
|
8
|
+
* sequence. Markdown / content semantics stay the renderer's contextual-escaping job; these values are advisory and
|
|
9
|
+
* never adjudication input.
|
|
10
|
+
*/
|
|
11
|
+
/** The serialized-size bound (JSON characters) past which a display value is replaced by a truncation account. */
|
|
12
|
+
export declare const APPROVAL_DISPLAY_MAX_CHARS = 16384;
|
|
13
|
+
/** Neutralize control characters in every string leaf (keys included); a value nested deeper than six levels is
|
|
14
|
+
* dropped. Non-string scalars pass unchanged. */
|
|
15
|
+
export declare const sanitizeApprovalDisplay: (node: unknown, depth?: number) => unknown;
|
|
16
|
+
/** The card's question as a parked row keeps it: sanitized, and past the bound replaced by an account naming the
|
|
17
|
+
* size. A non-string or empty value keeps nothing. */
|
|
18
|
+
export declare function approvalMessageOf(message: unknown): string | undefined;
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
export const APPROVAL_DISPLAY_MAX_CHARS = 16_384;
|
|
2
|
+
const CONTROL = /[\u0000-\u0008\u000b-\u001f\u007f]/g;
|
|
3
|
+
const neutralize = (text) => text.replace(CONTROL, "␀");
|
|
4
|
+
export const sanitizeApprovalDisplay = (node, depth = 0) => {
|
|
5
|
+
if (depth > 6)
|
|
6
|
+
return undefined;
|
|
7
|
+
if (typeof node === "string")
|
|
8
|
+
return neutralize(node);
|
|
9
|
+
if (node === null || typeof node !== "object")
|
|
10
|
+
return node;
|
|
11
|
+
if (Array.isArray(node))
|
|
12
|
+
return node.map((v) => sanitizeApprovalDisplay(v, depth + 1));
|
|
13
|
+
const out = {};
|
|
14
|
+
for (const [k, v] of Object.entries(node)) {
|
|
15
|
+
out[`${sanitizeApprovalDisplay(k, depth + 1)}`] = sanitizeApprovalDisplay(v, depth + 1);
|
|
16
|
+
}
|
|
17
|
+
return out;
|
|
18
|
+
};
|
|
19
|
+
export function approvalMessageOf(message) {
|
|
20
|
+
if (typeof message !== "string" || message.length === 0)
|
|
21
|
+
return undefined;
|
|
22
|
+
const serialized = JSON.stringify(message).length;
|
|
23
|
+
if (serialized > APPROVAL_DISPLAY_MAX_CHARS)
|
|
24
|
+
return `approval message exceeded 16KiB (${serialized} chars serialized)`;
|
|
25
|
+
return neutralize(message);
|
|
26
|
+
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { canonicalize } from "./canonical-json.js";
|
|
1
|
+
import { canonicalize, isSha16 } from "./canonical-json.js";
|
|
2
2
|
import { licenseCovers } from "./tool-policy.js";
|
|
3
3
|
import { pathTargetResolutionOf } from "./effective-path-target.js";
|
|
4
4
|
import { parkedSkillApprovalRefusal } from "./skill-grant.js";
|
|
@@ -11,7 +11,7 @@ const isString = (v) => typeof v === "string";
|
|
|
11
11
|
const absentOr = (shape) => (v) => v === undefined || shape(v);
|
|
12
12
|
const isSlot = (v) => isPlainRecord(v) && typeof v["param"] === "string";
|
|
13
13
|
const TOOL_MEMBER_SHAPES = Object.freeze({
|
|
14
|
-
capabilityId:
|
|
14
|
+
capabilityId: isSha16, contractId: isString, shapeDigest: isString, implementationRevision: isString, family: isString, declarationDigest: isString,
|
|
15
15
|
engineMounted: absentOr((v) => v === true), pathTarget: absentOr(isSlot), hostTarget: absentOr(isSlot),
|
|
16
16
|
});
|
|
17
17
|
const unreadToolMembers = (row) => Object.keys(TOOL_MEMBER_SHAPES).filter((k) => !TOOL_MEMBER_SHAPES[k](row[k]));
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The APPROVAL ROUTE words — where an ask carrying `requiresRealApproval` goes from a station, the closed set of the ONE
|
|
3
|
+
* approval-seat decision. A leaf: the route is derived in `wiring-manifest.ts` (`approvalRouteOf` there; that module
|
|
4
|
+
* re-exports these names as its consumer face) and screened by the stations that fork on it, some of which sit below the
|
|
5
|
+
* manifest in the import graph.
|
|
6
|
+
*
|
|
7
|
+
* `live_approver` (a live approver callback answers it now), `policy_seat` (the deployment's approval policy callback
|
|
8
|
+
* answers it now — it cannot approve it, since the bit asks for a person; it refuses it, or answers `"unavailable"` and the
|
|
9
|
+
* ask parks), `durable_park` (it parks for a person to answer later), `none` (nobody can: a blanket policy seat, no seat, or
|
|
10
|
+
* a run that declared nobody can be asked — each only when no park lane is armed, since an armed park is the deployment's
|
|
11
|
+
* own statement that an answer can wait for a person — or a word that cannot be resolved — the fail-closed reading).
|
|
12
|
+
*/
|
|
13
|
+
export declare const APPROVAL_ROUTES: readonly ["live_approver", "policy_seat", "durable_park", "none"];
|
|
14
|
+
export type ApprovalRoute = (typeof APPROVAL_ROUTES)[number];
|
|
15
|
+
/** Membership test for {@link ApprovalRoute} — a station's stated route is screened through it, never trusted by shape. */
|
|
16
|
+
export declare function isApprovalRoute(v: unknown): v is ApprovalRoute;
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The words as the model is to read them, or `undefined` when nothing was written: absent, or — after the outer whitespace is dropped —
|
|
3
|
+
* a text that says nothing by the input path's one definition of that ({@link isBlankInput}: whitespace and control characters only).
|
|
4
|
+
* The queue the live leg delivers through drops such a text for the same reason, so the two cannot disagree about whether words exist.
|
|
5
|
+
*/
|
|
6
|
+
export declare function writtenFeedback(feedback: string | undefined): string | undefined;
|
|
7
|
+
/** Why written words may not be delivered as the person's: they ride a refusal (a refusal's words are its `reason`), the answer is not
|
|
8
|
+
* a person's (a machine's text must never reach the model as the user's), or they carry the engine's `<system-reminder>` tag. */
|
|
9
|
+
export type UnfitFeedback = "on_a_deny" | "by_a_machine" | "reminder_tag";
|
|
10
|
+
/**
|
|
11
|
+
* The one judge of written words, in the order both faces refuse them: the arm first, then the party, then the tag. `words` is
|
|
12
|
+
* {@link writtenFeedback}'s output (the caller has already held the value to the string domain); nothing written is never unfit.
|
|
13
|
+
*/
|
|
14
|
+
export declare function unfitFeedbackOf(words: string | undefined, arm: {
|
|
15
|
+
readonly allowed: boolean;
|
|
16
|
+
readonly byPerson: boolean;
|
|
17
|
+
}): UnfitFeedback | undefined;
|
|
18
|
+
/**
|
|
19
|
+
* The live leg's carrier for the words: queues them so the next model request, after the batch the approved call is part of has
|
|
20
|
+
* settled its tool results, begins with them as a user message of their own. It never throws — a queue that refuses them reports
|
|
21
|
+
* the refusal itself — so the resolver that calls it can stay a plain wait on the approver.
|
|
22
|
+
*/
|
|
23
|
+
export type ApprovalWordsSeat = (words: string) => Promise<void>;
|
|
24
|
+
/** What a live answer's `feedback` reads as: the trimmed words (`undefined` when nothing was written), or the sentence the answer is refused in. */
|
|
25
|
+
export type LiveWords = {
|
|
26
|
+
readonly kind: "words";
|
|
27
|
+
readonly words: string | undefined;
|
|
28
|
+
} | {
|
|
29
|
+
readonly kind: "refused";
|
|
30
|
+
readonly message: string;
|
|
31
|
+
};
|
|
32
|
+
/**
|
|
33
|
+
* The live face's ONE reading of an approver's `feedback` member, composed on the judge above: the string domain first (never coerced,
|
|
34
|
+
* never read as blank), then {@link writtenFeedback}, then whether the seat can carry words at all, then {@link unfitFeedbackOf}. A
|
|
35
|
+
* refusal is the approver's defect in the seam's own words, never words quietly dropped behind an approval. `answer` states what the
|
|
36
|
+
* seam knows: the tool the card is about, the arm, whether a person gave it, and whether this seat has a carrier.
|
|
37
|
+
*/
|
|
38
|
+
export declare function liveWordsOf(feedback: unknown, answer: {
|
|
39
|
+
readonly toolName: string;
|
|
40
|
+
readonly allowed: boolean;
|
|
41
|
+
readonly byPerson: boolean;
|
|
42
|
+
readonly hasCarrier: boolean;
|
|
43
|
+
}): LiveWords;
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { isBlankInput } from "./input-author.js";
|
|
2
|
+
import { sanitizeUntrustedText, sentinelTagRefusal } from "./untrusted-text.js";
|
|
3
|
+
export function writtenFeedback(feedback) {
|
|
4
|
+
const trimmed = feedback?.trim();
|
|
5
|
+
return trimmed === undefined || isBlankInput(trimmed) ? undefined : trimmed;
|
|
6
|
+
}
|
|
7
|
+
export function unfitFeedbackOf(words, arm) {
|
|
8
|
+
if (words === undefined)
|
|
9
|
+
return undefined;
|
|
10
|
+
if (!arm.allowed)
|
|
11
|
+
return "on_a_deny";
|
|
12
|
+
if (!arm.byPerson)
|
|
13
|
+
return "by_a_machine";
|
|
14
|
+
return sanitizeUntrustedText(words) !== words ? "reminder_tag" : undefined;
|
|
15
|
+
}
|
|
16
|
+
export function liveWordsOf(feedback, answer) {
|
|
17
|
+
const who = `the approver for "${answer.toolName}" attached \`feedback\``;
|
|
18
|
+
if (feedback !== undefined && typeof feedback !== "string") {
|
|
19
|
+
return { kind: "refused", message: `${who} that is not a plain string (got ${feedback === null ? "null" : typeof feedback}) — the approving person's words are plain text; denied fail-closed` };
|
|
20
|
+
}
|
|
21
|
+
const words = writtenFeedback(feedback);
|
|
22
|
+
if (words === undefined)
|
|
23
|
+
return { kind: "words", words };
|
|
24
|
+
if (!answer.hasCarrier) {
|
|
25
|
+
return { kind: "refused", message: `${who} on a seat that has no lane to deliver words to the model — denied fail-closed (the words ride an approval card's allow through the run's own approver seat)` };
|
|
26
|
+
}
|
|
27
|
+
switch (unfitFeedbackOf(words, answer)) {
|
|
28
|
+
case undefined:
|
|
29
|
+
return { kind: "words", words };
|
|
30
|
+
case "on_a_deny":
|
|
31
|
+
return { kind: "refused", message: `${who} to a refusal — feedback is the approving person's words on an allow (a refusal's words are \`reason\`); denied fail-closed rather than dropping them silently` };
|
|
32
|
+
case "by_a_machine":
|
|
33
|
+
return { kind: "refused", message: `${who} to an answer no person gave (settledBy "policy", or an approver the deployment declared a policy) — feedback is delivered to the model as the user's own words, which only a person's answer can be; denied fail-closed rather than attributing a machine's text to the user` };
|
|
34
|
+
case "reminder_tag":
|
|
35
|
+
return { kind: "refused", message: `${who}: ${sentinelTagRefusal("approval allow feedback")}; denied fail-closed` };
|
|
36
|
+
}
|
|
37
|
+
}
|
|
@@ -23,6 +23,12 @@
|
|
|
23
23
|
* bit any origin can carry — a safety policy's own ask carries it with origin `policy`), and the
|
|
24
24
|
* gate's `autoMode` seat says whether a classifier is WIRED at all (a property of the session, not of
|
|
25
25
|
* the ask). Both stay where they are and are consumed beside the origin, not folded into it.
|
|
26
|
+
*
|
|
27
|
+
* Where an ask says WHY. An asker's own words have one machine-read seat, the ask's `askReasons` entries ({@link AskReason});
|
|
28
|
+
* a fact that rides a typed member is said by that member — the class (`askClass` / `classes`), the origin, the mandate word,
|
|
29
|
+
* and the account of a finding a read station or a deployment's reversibility probe made (`probeReason`, the `probe_mandate`
|
|
30
|
+
* word's disclosure). The ask's `message` is the one line a person or the model reads, not a second reason seat: a structured
|
|
31
|
+
* approval surface reads its reasons from the entries and the typed members, never from it.
|
|
26
32
|
*/
|
|
27
33
|
import type { PermissionResult } from "./tool-policy.js";
|
|
28
34
|
import { type EngineAttestation } from "./engine-attestation.js";
|
|
@@ -62,6 +68,14 @@ import type { ContainmentFace } from "../tools/fs/containment-face.js";
|
|
|
62
68
|
* an instruction rather than hesitation.
|
|
63
69
|
* - `denial_limit_fallback` — the auto-mode classifier reached its denial bound and handed the call
|
|
64
70
|
* to a person; the classifier stands BEFORE this ask, never after it.
|
|
71
|
+
* - `integrity_guard` — an always-on engine integrity guard put the question in its own words: a removal of a protected
|
|
72
|
+
* location, an unverifiable recursive delete, shell text the engine cannot read, the session-transcript write. Read off the
|
|
73
|
+
* guard's own account of the sentence the ask still says ({@link engineSentenceOf}`(…).guard`), never off the record's
|
|
74
|
+
* `guards` (a read station's silence lists a guard behind a question another layer raised): a later layer that rewrote the
|
|
75
|
+
* message without restating that account leaves the ask to the words below. Above the two tighten words: a tighten only
|
|
76
|
+
* ever replaces an allow, so the two never hold together on one pass, and where a pass's tighten fact outlived its turn
|
|
77
|
+
* (an approved edit's re-check) the decision's own record is the one that speaks for it. The reference implementation's
|
|
78
|
+
* `safetyCheck`.
|
|
65
79
|
* - `shell_gate_tighten` — the gate's own irreversibility tighten raised the ask over a tier the COARSE
|
|
66
80
|
* shell seat installed (the shape tier on every full shell, or the `shellGate: "always"` floor), not an
|
|
67
81
|
* explicit per-tool mark. The gate records that its own tighten spoke; a policy stamping
|
|
@@ -76,7 +90,7 @@ import type { ContainmentFace } from "../tools/fs/containment-face.js";
|
|
|
76
90
|
* observer or an approval card can say WHICH engine layer raised the question, which one word
|
|
77
91
|
* could not.
|
|
78
92
|
*/
|
|
79
|
-
export declare const ASK_ORIGINS: readonly ["content_question", "plan_review", "ancestor_marked", "org_unavailable", "org_rule", "rule_store_unavailable", "hook", "ask_rule", "denial_limit_fallback", "shell_gate_tighten", "safety_tighten", "policy"];
|
|
93
|
+
export declare const ASK_ORIGINS: readonly ["content_question", "plan_review", "ancestor_marked", "org_unavailable", "org_rule", "rule_store_unavailable", "hook", "ask_rule", "denial_limit_fallback", "integrity_guard", "shell_gate_tighten", "safety_tighten", "policy"];
|
|
80
94
|
export type AskOrigin = (typeof ASK_ORIGINS)[number];
|
|
81
95
|
/** Whether a value is a member of the closed origin set. Exported because the word crosses process
|
|
82
96
|
* boundaries: a host validating one it received must not hand-roll the set. */
|
|
@@ -345,10 +359,11 @@ export declare function askMandateMember(ask: RuleClearanceFacts | undefined): {
|
|
|
345
359
|
* A MANDATE merged onto an ask another layer raised — the one writer of both merge arms (the read station's, the reversibility
|
|
346
360
|
* probe's; `gate-fold.ts`). The mandate is the fact that a standing allow rule may not clear the ask, and its account is the only
|
|
347
361
|
* sentence that can say why (the allow layer's disclosure words a `probe_mandate` with it, on the card and in the parked row): the
|
|
348
|
-
* two travel together. The FIRST layer to mandate an ask brings its account, or none: a `probeReason` the ask arrived with
|
|
349
|
-
*
|
|
350
|
-
*
|
|
351
|
-
*
|
|
362
|
+
* two travel together. The FIRST layer to mandate an ask brings its account, or none: a `probeReason` the ask arrived with is another
|
|
363
|
+
* station's account of a finding that did not mandate it (no policy states one: the receipt refuses it — the read station's account of
|
|
364
|
+
* an ask it raised without a mandate, which the reversibility probe's merge arm meets), and is replaced by the account — or removed
|
|
365
|
+
* where the mandating layer gave none, so it is never read as the reason the mandate stands; an ask already mandated keeps the first
|
|
366
|
+
* layer's. The ask's action, message, reason and every other disclosure are untouched.
|
|
352
367
|
*/
|
|
353
368
|
export declare function withProbeMandate<D extends Extract<PermissionResult, {
|
|
354
369
|
action: "ask";
|
|
@@ -375,7 +390,10 @@ export declare function ownedClearanceFacts(d: Extract<PermissionResult, {
|
|
|
375
390
|
* (`denialLimitFallback`: a self-declared one opts the policy's own ask out of automatic
|
|
376
391
|
* resolution, the safe direction, not a defect), so the invariant is pinned at the engine's two
|
|
377
392
|
* mint sites (the gate's fallback re-mint and the inherited station's) rather than thrown at
|
|
378
|
-
* derivation, where a policy's own object could trip it;
|
|
393
|
+
* derivation, where a policy's own object could trip it; `integrity_guard` likewise: its input is the
|
|
394
|
+
* guard's own record, which no policy composes but a policy wrapping an exported guard can relay beside a
|
|
395
|
+
* bit it cleared, so the bit is pinned at the two guard mint sites (the removal guard's ask, the
|
|
396
|
+
* session-transcript guard's);
|
|
379
397
|
* - `false` — the origin says nothing about the bit: a `policy` ask may carry it (a safety policy's
|
|
380
398
|
* own mandate) or not, and both are legal.
|
|
381
399
|
*/
|
|
@@ -389,6 +407,7 @@ export declare const ORIGIN_IMPLIES_REAL_APPROVAL: {
|
|
|
389
407
|
readonly hook: false;
|
|
390
408
|
readonly ask_rule: false;
|
|
391
409
|
readonly denial_limit_fallback: "at_mint";
|
|
410
|
+
readonly integrity_guard: "at_mint";
|
|
392
411
|
readonly shell_gate_tighten: false;
|
|
393
412
|
readonly safety_tighten: false;
|
|
394
413
|
readonly policy: false;
|
|
@@ -867,6 +886,11 @@ export declare function askFaceOf(toolName: string): AskFace;
|
|
|
867
886
|
* shell floor) mint no bit and explain none — except `requires_user_interaction`, whose declaration the origin stamp
|
|
868
887
|
* turns into the bit on every ask of the tool. */
|
|
869
888
|
export declare const RRA_EXPLAINERS: ReadonlySet<AskClass>;
|
|
889
|
+
/** Whether a set of classes holds one that explains the `requiresRealApproval` bit ({@link RRA_EXPLAINERS}) — the ONE reading of the
|
|
890
|
+
* bit's fence. A bit a member explains is that member's demand for a person, not the bare bit `policy_rra` names: the mint reads it over
|
|
891
|
+
* an ask's own members ({@link ownAskClassesOf}) and again over the whole set ({@link classifyAsk}), and the edit re-check reads it
|
|
892
|
+
* over the classes a person answered ({@link import("./real-approval.js").editRecheckUnanswered}). */
|
|
893
|
+
export declare function explainsRealApprovalBit(classes: Iterable<AskClass>): boolean;
|
|
870
894
|
/** The classes a permission mode can RELEASE for a call on `face`, in {@link ASK_CLASSES} order. The same list on every face
|
|
871
895
|
* but one class — {@link RELEASED_ON_SHELL_FACE}. A frozen list: a caller holding it cannot change the next read. A word
|
|
872
896
|
* outside {@link ASK_FACES} throws. */
|
|
@@ -997,10 +1021,11 @@ export declare function dontAskRefusalMessage(input: {
|
|
|
997
1021
|
readonly ruleShape: string;
|
|
998
1022
|
}): string;
|
|
999
1023
|
/** The state of the approver seat a remedy is written for: `absent` — no approver is wired for the leg; `unavailable` — one is
|
|
1000
|
-
* wired and answered that nobody is reachable for this ask; `
|
|
1024
|
+
* wired and answered that nobody is reachable for this ask; `policy` — the approver wired is the deployment's approval policy
|
|
1025
|
+
* (`asPolicyApprover`) and it answered `unavailable` for this ask; `declared_none` — the run declared that nobody on it can be
|
|
1001
1026
|
* asked (`approvalReach: "none"`), whatever is wired. Absent in the input reads as `absent` (the posture the function was
|
|
1002
1027
|
* written for). */
|
|
1003
|
-
export type HeadlessApproverSeat = "absent" | "unavailable" | "declared_none";
|
|
1028
|
+
export type HeadlessApproverSeat = "absent" | "unavailable" | "policy" | "declared_none";
|
|
1004
1029
|
/** The kinds of way out a refusal carries as DATA: `approver` — a person who can answer becomes reachable (the sentence's approver clause);
|
|
1005
1030
|
* `permission_mode` — a mode that releases the ask with nobody answering it (`bypassPermissions`, unless the deployment's caps deny it:
|
|
1006
1031
|
* a denied bypass folds to `default`). A host renders a kind or leaves it unrendered; the sentence a user reads never teaches the release. */
|
|
@@ -1032,7 +1057,8 @@ export interface HeadlessApprovalRemedy {
|
|
|
1032
1057
|
* after its refusal: the caller-side change that would have let this call run, as a sentence (`sentence`) and as the
|
|
1033
1058
|
* ways out in data (`remedies`, {@link ApprovalRemedy}: the approver in every arm). Read off the effective mode, the
|
|
1034
1059
|
* ask's folded class row and whether the call is a covered write (the mode write gate's own question):
|
|
1035
|
-
* · a class no permission mode releases (`bypassImmune`) — only a person can answer it: wire an approver
|
|
1060
|
+
* · a class no permission mode releases (`bypassImmune`) — only a person can answer it: wire an approver (a `cross_boundary` ask adds
|
|
1061
|
+
* that an earlier yes from the policy or an approval factory does not answer it, {@link CROSS_BOUNDARY_EARLIER_YES});
|
|
1036
1062
|
* · the plan mode's own question (`mode`) — leave plan (steer the mode, or approve the plan) or wire an approver;
|
|
1037
1063
|
* · the write gate's own ask under `default` / `auto` — `acceptEdits` lets writes inside the working
|
|
1038
1064
|
* directories through without asking;
|
|
@@ -1042,7 +1068,8 @@ export interface HeadlessApprovalRemedy {
|
|
|
1042
1068
|
* the sentence does not say so; `remedies` carries it as a `permission_mode` member for a host that chooses to offer it.
|
|
1043
1069
|
* Every arm also names the approver, in the clause of the seat's own state ({@link HeadlessApproverSeat}): none wired ⇒
|
|
1044
1070
|
* wire one; one wired that answered `unavailable` for this ask ⇒ make a person reachable through it (a wired approver is
|
|
1045
|
-
* never told to be wired); the
|
|
1071
|
+
* never told to be wired); the deployment's approval policy answered `unavailable` ⇒ park it for a person, or run it where a
|
|
1072
|
+
* person can be asked (a policy is not a person to make reachable); the run declared nobody can be asked ⇒ run it where a person can be, or park it. The refusal's tool text and the `delegation.ask_unresolvable` notice both carry this sentence —
|
|
1046
1073
|
* they call this function, neither spells it — and the notice carries `remedies` beside it.
|
|
1047
1074
|
* Under `dontAsk` (the mode answers no ask: {@link dontAskRefusalMessage} carries this arm) the one question is whether an allow
|
|
1048
1075
|
* rule may clear the ask — the folded row's `ruleMayClear`, the allow layer's own reading: yes ⇒ add an allow rule covering the
|
package/dist/core/ask-origin.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { attestationOf, engineSentenceOf } from "./engine-attestation.js";
|
|
2
2
|
import { isShellFaceToolName } from "./tool-registry.js";
|
|
3
3
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
4
|
-
export const ASK_ORIGINS = Object.freeze(["content_question", "plan_review", "ancestor_marked", "org_unavailable", "org_rule", "rule_store_unavailable", "hook", "ask_rule", "denial_limit_fallback", "shell_gate_tighten", "safety_tighten", "policy"]);
|
|
4
|
+
export const ASK_ORIGINS = Object.freeze(["content_question", "plan_review", "ancestor_marked", "org_unavailable", "org_rule", "rule_store_unavailable", "hook", "ask_rule", "denial_limit_fallback", "integrity_guard", "shell_gate_tighten", "safety_tighten", "policy"]);
|
|
5
5
|
const ASK_ORIGIN_SET = new Set(ASK_ORIGINS);
|
|
6
6
|
export function isAskOrigin(v) {
|
|
7
7
|
return ASK_ORIGIN_SET.has(v);
|
|
@@ -173,6 +173,8 @@ function originLadder(decision, facts) {
|
|
|
173
173
|
return "ask_rule";
|
|
174
174
|
if (decision.denialLimitFallback !== undefined)
|
|
175
175
|
return "denial_limit_fallback";
|
|
176
|
+
if (engineSentenceOf(decision, facts.call)?.guard !== undefined)
|
|
177
|
+
return "integrity_guard";
|
|
176
178
|
if (facts.tightened === "shell_gate")
|
|
177
179
|
return "shell_gate_tighten";
|
|
178
180
|
if (facts.tightened === "safety")
|
|
@@ -189,6 +191,7 @@ export const ORIGIN_IMPLIES_REAL_APPROVAL = {
|
|
|
189
191
|
hook: false,
|
|
190
192
|
ask_rule: false,
|
|
191
193
|
denial_limit_fallback: "at_mint",
|
|
194
|
+
integrity_guard: "at_mint",
|
|
192
195
|
shell_gate_tighten: false,
|
|
193
196
|
safety_tighten: false,
|
|
194
197
|
policy: false,
|
|
@@ -338,6 +341,12 @@ function bypassImmuneOf(c) {
|
|
|
338
341
|
}
|
|
339
342
|
const CLASSIFIER_WITHHELD_ON_ROOTS = new Set(["probe"]);
|
|
340
343
|
export const RRA_EXPLAINERS = new Set(["dangerous_delete", "unverifiable_delete", "unverifiable_shell_text", "transcript_write", "org_rule", "rule_unreadable", "denial_limit_fallback", "classifier_no_ruling", "ancestor", "artifact_shared_read", "requires_user_interaction", "cross_boundary"]);
|
|
344
|
+
export function explainsRealApprovalBit(classes) {
|
|
345
|
+
for (const c of classes)
|
|
346
|
+
if (RRA_EXPLAINERS.has(c))
|
|
347
|
+
return true;
|
|
348
|
+
return false;
|
|
349
|
+
}
|
|
341
350
|
const RELEASABLE_BY_FACE = Object.freeze({
|
|
342
351
|
shell: Object.freeze(ASK_CLASSES.filter((c) => !bypassImmuneOn(c, "shell"))),
|
|
343
352
|
other: Object.freeze(ASK_CLASSES.filter((c) => !bypassImmuneOn(c, "other"))),
|
|
@@ -386,7 +395,7 @@ export function ownAskClassesOf(d, record) {
|
|
|
386
395
|
out.add("hook");
|
|
387
396
|
if (d.decisionReason === "mode")
|
|
388
397
|
out.add("mode");
|
|
389
|
-
if (d.requiresRealApproval === true && !
|
|
398
|
+
if (d.requiresRealApproval === true && !explainsRealApprovalBit(out))
|
|
390
399
|
out.add("policy_rra");
|
|
391
400
|
if (out.size === 0 && d.mandated === true)
|
|
392
401
|
out.add("operator_forced");
|
|
@@ -453,7 +462,7 @@ export function classifyAsk(d, facts) {
|
|
|
453
462
|
classes.add("unstated");
|
|
454
463
|
for (const c of facts.ancestorClasses ?? [])
|
|
455
464
|
classes.add(c);
|
|
456
|
-
if (d.requiresRealApproval === true && !
|
|
465
|
+
if (d.requiresRealApproval === true && !explainsRealApprovalBit(classes))
|
|
457
466
|
classes.add("policy_rra");
|
|
458
467
|
for (const c of record?.foldedClasses ?? [])
|
|
459
468
|
classes.add(c);
|
|
@@ -509,6 +518,7 @@ export function readApprovalRemedy(v) {
|
|
|
509
518
|
}
|
|
510
519
|
}
|
|
511
520
|
}
|
|
521
|
+
const CROSS_BOUNDARY_EARLIER_YES = "an earlier yes from the policy or an approval factory does not answer this question";
|
|
512
522
|
const APPROVER_REMEDY = Object.freeze({ kind: "approver" });
|
|
513
523
|
const RELEASE_REMEDY = Object.freeze({ kind: "permission_mode", value: "bypassPermissions", disclosedOn: "gate.disposition.released" });
|
|
514
524
|
export function headlessApprovalRemedy(input) {
|
|
@@ -521,14 +531,16 @@ export function headlessApprovalRemedy(input) {
|
|
|
521
531
|
}
|
|
522
532
|
const approver = input.approverSeat === "unavailable"
|
|
523
533
|
? "make a person reachable through the approver that is wired (it answered `unavailable` for this ask)"
|
|
524
|
-
: input.approverSeat === "
|
|
525
|
-
? '
|
|
526
|
-
:
|
|
534
|
+
: input.approverSeat === "policy"
|
|
535
|
+
? "the deployment's approval policy answered `unavailable` for this ask — arm a durable approval park so the ask waits for a person, or run it where a person can be asked"
|
|
536
|
+
: input.approverSeat === "declared_none"
|
|
537
|
+
? 'run it where a person can be asked — this run declares `approvalReach: "none"` (nobody on it can be asked) — or arm a durable approval park so the ask waits for a person'
|
|
538
|
+
: "wire an approver (`onAsk`) to put it to a person";
|
|
527
539
|
const c = input.classification;
|
|
528
540
|
if (input.mode === "acceptEdits" && input.unplacedOptions !== undefined && (c === undefined || (c.classes.size === 1 && c.classes.has("ordinary"))))
|
|
529
541
|
return way(`${fileCommandOptionsSentence(input.unplacedOptions.program)} Spell the ${input.unplacedOptions.program} without option words for the mode to answer it, or ${approver}`);
|
|
530
542
|
if (c !== undefined && bypassImmuneOf(c))
|
|
531
|
-
return way(`no permission mode releases this ask (${c.askClass}): ${approver}, or change the call`);
|
|
543
|
+
return way(`no permission mode releases this ask (${c.askClass}): ${approver}, or change the call${c.classes.has("cross_boundary") ? ` — ${CROSS_BOUNDARY_EARLIER_YES}` : ""}`);
|
|
532
544
|
if (input.mode === "plan" && c?.classes.has("mode") === true)
|
|
533
545
|
return way(`the plan permission mode asks before every write and every call to a tool the engine does not define that is not read-only — leave plan mode (\`setPermissionMode\` to another mode, or approve the plan) to run it, or ${approver}`);
|
|
534
546
|
if (c !== undefined && c.classes.size === 1 && c.classes.has("unstated"))
|