@sema-agent/core 7.60.0 → 7.62.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 +917 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +71 -12
- package/dist/agents/cascade.js +61 -21
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-held-queue.d.ts +27 -4
- package/dist/agents/peer-held-queue.js +81 -36
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +49 -10
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +36 -41
- package/dist/agents/subagent.js +245 -200
- package/dist/agents/suspend-guard.d.ts +47 -16
- package/dist/agents/suspend-guard.js +13 -4
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +41 -30
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-features.d.ts +722 -0
- package/dist/core/checkpoint-features.js +98 -0
- package/dist/core/checkpoint-requirements.d.ts +33 -5
- package/dist/core/checkpoint-requirements.js +18 -5
- package/dist/core/checkpoint-row-verdict.d.ts +99 -0
- package/dist/core/checkpoint-row-verdict.js +225 -0
- package/dist/core/checkpoint-store.d.ts +107 -738
- package/dist/core/checkpoint-store.js +45 -143
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +68 -21
- package/dist/core/engine-notice.js +9 -2
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +10 -0
- package/dist/core/frame-settlement.js +6 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +4 -3
- package/dist/core/gate-lanes.js +7 -4
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +14 -4
- package/dist/core/governance-codes.js +19 -4
- package/dist/core/hooks.d.ts +25 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/human-input-projection.d.ts +1 -0
- package/dist/core/human-input-projection.js +3 -0
- package/dist/core/image-admission.d.ts +47 -7
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +4 -3
- package/dist/core/locked-config.js +5 -3
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +225 -46
- package/dist/core/mcp-probe.js +2 -2
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +2 -1
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +6 -49
- package/dist/core/mcp.js +115 -111
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-engine/consolidation-driver.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/memory-vector.d.ts +1 -1
- package/dist/core/memory.d.ts +10 -10
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +8 -6
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/classic-events.d.ts +9 -1
- package/dist/core/mods/dollar.d.ts +94 -1
- package/dist/core/mods/dollar.js +13 -1
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +14 -3
- package/dist/core/mods/kernel/events.js +18 -15
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/lifecycle-stations.d.ts +36 -4
- package/dist/core/mods/lifecycle-stations.js +44 -9
- package/dist/core/mods/session-append.d.ts +118 -0
- package/dist/core/mods/session-append.js +318 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +138 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +88 -21
- package/dist/core/mods/stations.js +149 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +68 -2
- package/dist/core/own-property-receipt.js +45 -2
- package/dist/core/park-selfcheck.js +4 -2
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/read-root-candidate.js +1 -1
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/resume-startup-cause.d.ts +5 -4
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -3
- package/dist/core/runner/assemble-result.js +12 -7
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/compact-session.js +18 -3
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +116 -34
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/delegation-owner.d.ts +43 -0
- package/dist/core/runner/delegation-owner.js +59 -0
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
- package/dist/core/runner/lineage-reroot-view.js +108 -0
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +7 -2
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.d.ts +15 -0
- package/dist/core/runner/person-path-rows.js +27 -4
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
- package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +2 -1
- package/dist/core/runner/prepare-config-doors.d.ts +6 -6
- package/dist/core/runner/prepare-config-doors.js +19 -21
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +6 -6
- package/dist/core/runner/prepare-hands-readface.js +32 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +8 -0
- package/dist/core/runner/prepare-inherited-gate.js +10 -3
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +61 -30
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +8 -6
- package/dist/core/runner/resume-admission.js +23 -6
- package/dist/core/runner/resume-apply.d.ts +4 -0
- package/dist/core/runner/resume-apply.js +14 -5
- package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
- package/dist/core/runner/resume-checkpoint-screen.js +4 -84
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +2 -0
- package/dist/core/runner/run-git-lane.d.ts +2 -0
- package/dist/core/runner/run-git-lane.js +6 -2
- package/dist/core/runner/run-harness-handlers.d.ts +2 -0
- package/dist/core/runner/run-harness-handlers.js +5 -4
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +64 -36
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +12 -9
- package/dist/core/runner/run-stop-and-final-verify.js +2 -1
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +34 -18
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +33 -17
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/steering-preview.d.ts +9 -0
- package/dist/core/runner/steering-preview.js +5 -0
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +16 -7
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -2
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-face-overlay.js +2 -0
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +8 -2
- package/dist/core/runner/turn-attachments.js +2 -2
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +26 -27
- package/dist/core/secret-env.d.ts +19 -16
- package/dist/core/secret-env.js +45 -27
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +3 -1
- package/dist/core/session-store.js +10 -8
- package/dist/core/session.d.ts +16 -5
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +8 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +83 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/session-store-contract.js +22 -8
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +24 -9
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +89 -14
- package/dist/core/task-registry-agent.d.ts +32 -50
- package/dist/core/task-registry-agent.js +36 -56
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +22 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +5 -21
- package/dist/core/task-registry.d.ts +32 -62
- package/dist/core/task-registry.js +30 -110
- package/dist/core/task-result.d.ts +29 -12
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +11 -11
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +36 -6
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.js +3 -2
- package/dist/core/tool-face.d.ts +8 -5
- package/dist/core/tool-face.js +1 -1
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +109 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-roster.d.ts +4 -4
- package/dist/core/tool-spec.d.ts +23 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/types.d.ts +1 -1
- package/dist/core/types.js +1 -1
- package/dist/core/user-attachment.js +26 -21
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +37 -9
- package/dist/engine/execution-env/node-execution-env.js +221 -22
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +52 -7
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/engine/session/parent-chain-guard.d.ts +3 -3
- package/dist/engine/session/parent-chain-guard.js +1 -1
- package/dist/engine/session/path-to-root.d.ts +18 -3
- package/dist/engine/session/path-to-root.js +15 -1
- package/dist/engine/session/repo-utils.d.ts +12 -1
- package/dist/engine/session/repo-utils.js +41 -0
- package/dist/engine/session/session.js +1 -1
- package/dist/engine/session/storage-base.d.ts +20 -0
- package/dist/engine/session/storage-base.js +28 -9
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +29 -18
- package/dist/index.js +19 -11
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/harness.d.ts +4 -3
- package/dist/internal/harness.js +3 -2
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +14 -17
- package/dist/orchestration/run-workflow-tool.js +43 -50
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +7 -0
- package/dist/orchestration/workflow.js +10 -12
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.d.ts +2 -0
- package/dist/stores/file/checkpoint-store.js +13 -9
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/fs-atomic.d.ts +0 -22
- package/dist/stores/file/fs-atomic.js +0 -17
- package/dist/stores/file/index.d.ts +7 -12
- package/dist/stores/file/index.js +25 -12
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.js +3 -2
- package/dist/stores/file/session-store.d.ts +26 -7
- package/dist/stores/file/session-store.js +59 -35
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/bash-program-position.d.ts +3 -2
- package/dist/tools/fs/bash-program-position.js +7 -7
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/removal-targets.js +2 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-argv.d.ts +4 -2
- package/dist/tools/fs/shell-read-argv.js +14 -3
- package/dist/tools/fs/shell-read-bindings.d.ts +18 -2
- package/dist/tools/fs/shell-read-bindings.js +148 -68
- package/dist/tools/fs/shell-read-check.js +20 -4
- package/dist/tools/fs/shell-read-establish.js +25 -9
- package/dist/tools/fs/shell-read-functions.js +2 -2
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
- package/dist/tools/fs/shell-read-object-path.js +119 -0
- package/dist/tools/fs/shell-read-plan.d.ts +8 -0
- package/dist/tools/fs/shell-read-plan.js +47 -30
- package/dist/tools/fs/shell-read-start.d.ts +66 -13
- package/dist/tools/fs/shell-read-start.js +89 -17
- package/dist/tools/fs/shell-read-workdir.d.ts +29 -8
- package/dist/tools/fs/shell-read-workdir.js +31 -8
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +112 -42
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core-stores-sql@7.62.0.json +30 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/core@7.62.0.json +2181 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/mods-kernel@7.62.0.json +42 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/wire-changes/primitives@7.62.0.json +30 -0
- package/dist/core/consolidate-scope.d.ts +0 -93
- package/dist/core/consolidate-scope.js +0 -98
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
- package/dist/core/runner/memory-consolidation.d.ts +0 -109
- package/dist/core/runner/memory-consolidation.js +0 -251
|
@@ -51,7 +51,9 @@ export declare function formatToolError(error: unknown): string;
|
|
|
51
51
|
*
|
|
52
52
|
* - `budget` — the cost/token budget gate fired (`limits.max_tokens_exceeded` / `limits.max_cost_exceeded`).
|
|
53
53
|
* - `limit` — a hard run limit fired (`limits.max_turns_exceeded` / `limits.max_walltime_exceeded`).
|
|
54
|
-
* - `output` — the structured/answer output was rejected (`output.invalid` / `output.degenerate`)
|
|
54
|
+
* - `output` — the structured/answer output was rejected (`output.invalid` / `output.degenerate`), or the
|
|
55
|
+
* model's output could not be used after the loop's bounded retries (`model.malformed_tool_use_exhausted`
|
|
56
|
+
* / `model.truncated_output_exhausted`).
|
|
55
57
|
* - `suspend` — the suspend-loop cap fired (`suspend.loop`); a TERMINAL failure, distinct from a
|
|
56
58
|
* resumable `suspended` status (which carries no errorCode).
|
|
57
59
|
* - `review` — a review-pause terminal (`review.pending`).
|
|
@@ -118,8 +120,9 @@ export type WorkerErrorClass = "budget" | "limit" | "output" | "suspend" | "revi
|
|
|
118
120
|
* SCOPE: this folds a TERMINAL `TaskResult.errorCode` only — i.e. every OUR dotted prefix that the runner can
|
|
119
121
|
* assemble into a failed task outcome (`limits.`/`output.`/`suspend.`/`review.`/`unexpected.`/
|
|
120
122
|
* `oracle.`/`resume.`/`config.`/`usage.`) as a broad PREFIX, plus `memory.admission_required` /
|
|
121
|
-
* `memory.admission_denied` / `env.lifetime_expired` as EXACT codes (their
|
|
122
|
-
* are NOT all terminal-errorCode-shaped — see {@link EXACT_CODE_CLASS}'s
|
|
123
|
+
* `memory.admission_denied` / `env.lifetime_expired` / the two `model.*_exhausted` loop terminals as EXACT codes (their
|
|
124
|
+
* sibling `memory.*`/`env.*`/`model.*` strings are NOT all terminal-errorCode-shaped — see {@link EXACT_CODE_CLASS}'s
|
|
125
|
+
* comment), plus the flat 1.36 codes.
|
|
123
126
|
* The `limits.` namespace splits into the `budget` and `limit` classes by exact code — see
|
|
124
127
|
* {@link EXACT_CODE_CLASS}. Operation-level dotted codes that are surfaced to a *caller* and never become a
|
|
125
128
|
* task outcome are deliberately OUT of scope: `steering.*` (`steering.not_running`/`steering.invalid_content`/
|
package/dist/core/tool-errors.js
CHANGED
|
@@ -89,6 +89,8 @@ const EXACT_CODE_CLASS = new Map([
|
|
|
89
89
|
["memory.admission_denied", "config"],
|
|
90
90
|
["memory.capture_optout_denied", "config"],
|
|
91
91
|
["env.lifetime_expired", "config"],
|
|
92
|
+
["model.malformed_tool_use_exhausted", "output"],
|
|
93
|
+
["model.truncated_output_exhausted", "output"],
|
|
92
94
|
]);
|
|
93
95
|
const DOTTED_PREFIX_CLASS = [
|
|
94
96
|
["limits.", "limit"],
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { callerText, dataKind, perToolEmptyName, perToolEntryRefusal, receivePerToolDeclaration } from "./mcp-server-spec.js";
|
|
2
2
|
import { isPlainRecord } from "./mods/kernel/receive.js";
|
|
3
|
+
import { strayMembersOf } from "./own-property-receipt.js";
|
|
3
4
|
import { faceProblem } from "./runner/tool-face-overlay.js";
|
|
4
5
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
5
6
|
const TOOL_FACE_MEMBERS = { family: true, pathTarget: true, hostTarget: true, renderHints: true, ruleFace: true };
|
|
@@ -20,8 +21,8 @@ function kindProblem(label, value, kind) {
|
|
|
20
21
|
function membersOf(raw, label, names) {
|
|
21
22
|
if (!isPlainRecord(raw))
|
|
22
23
|
return `${label} is ${dataKind(raw)}, not an object`;
|
|
23
|
-
const
|
|
24
|
-
return
|
|
24
|
+
const stray = strayMembersOf(raw, { subject: label, unit: "member", moment: "when the face is read" }, names);
|
|
25
|
+
return stray === undefined ? raw : `${label} has an unknown member ${callerText(String(stray.names[0]))} (the members are ${names.join(", ")})`;
|
|
25
26
|
}
|
|
26
27
|
function ownMember(record, name) {
|
|
27
28
|
return Object.hasOwn(record, name) ? record[name] : undefined;
|
package/dist/core/tool-face.d.ts
CHANGED
|
@@ -16,13 +16,12 @@ export declare const TOOL_FAMILIES: readonly ["shell", "file-read", "file-write"
|
|
|
16
16
|
export type ToolFamily = (typeof TOOL_FAMILIES)[number];
|
|
17
17
|
/**
|
|
18
18
|
* The closed set of MOUNT-CONDITION tags a static catalog entry is listed under. The static half of the
|
|
19
|
-
* catalog carries an ARRAY (a tool can be mounted by more than one condition
|
|
20
|
-
* hand band and the delegation surface); the effect roster records the ONE tag that actually fired.
|
|
19
|
+
* catalog carries an ARRAY (a tool can be mounted by more than one condition); the effect roster records the ONE tag that actually fired.
|
|
21
20
|
*
|
|
22
21
|
* - `hands` — the hand band (an execution env is wired: `deps.executionEnv` / `executionEnvFactory`);
|
|
23
22
|
* - `backgroundTasks` — the background-task surface (`Monitor`);
|
|
24
23
|
* - `workflow` — the workflow tool surface (`Workflow`);
|
|
25
|
-
* - `delegation` — the union of the background-task and workflow surfaces (
|
|
24
|
+
* - `delegation` — the union of the background-task and workflow surfaces (TaskStop/
|
|
26
25
|
* AgentTranscript, SendMessage's first condition);
|
|
27
26
|
* - `hostInternals` — a host-internal seat is present (`RunInternals.parentNotify`);
|
|
28
27
|
* - `peerLane` — the peer-session lane is mounted;
|
|
@@ -39,8 +38,12 @@ export type ToolMountTag = (typeof TOOL_MOUNT_TAGS)[number];
|
|
|
39
38
|
import type { AssertAllKeysHandled } from "./ask-origin.js";
|
|
40
39
|
/** The closed set of specialised approval cards a shell may pre-select from a render hint. The hint is a
|
|
41
40
|
* PRE-FILTER: the shell owns each card's input schema and validates the call's full args before
|
|
42
|
-
* mounting the card (design/388 §2.5 boundary ①).
|
|
43
|
-
|
|
41
|
+
* mounting the card (design/388 §2.5 boundary ①).
|
|
42
|
+
*
|
|
43
|
+
* `computer-access` (the call carries `apps`, the list asked for) and `computer-control` (the call carries nothing the
|
|
44
|
+
* card needs) are the two consent cards of a tool that hands the model the user's screen; a caller or an MCP overlay may
|
|
45
|
+
* declare either. What each grants is per connection: `docs/sdk/04-tools-and-mcp.md` states the lifetime. */
|
|
46
|
+
export declare const TOOL_APPROVAL_CARDS: readonly ["file-edit", "file-write", "notebook-edit", "shell", "fetch", "skill", "workflow", "plan", "question", "generic", "computer-access", "computer-control"];
|
|
44
47
|
export type ToolApprovalCard = (typeof TOOL_APPROVAL_CARDS)[number];
|
|
45
48
|
/** Membership in the closed set — the one screen a stored or declared card word passes before it is read. */
|
|
46
49
|
export declare function isToolApprovalCard(word: unknown): word is ToolApprovalCard;
|
package/dist/core/tool-face.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
export const TOOL_FAMILIES = Object.freeze(["shell", "file-read", "file-write", "search", "web", "delegate", "plan", "scaffold", "memory", "protocol", "other"]);
|
|
2
2
|
export const TOOL_MOUNT_TAGS = Object.freeze(["hands", "backgroundTasks", "workflow", "delegation", "hostInternals", "peerLane", "scheduler", "memory", "scenario", "always", "optional"]);
|
|
3
|
-
export const TOOL_APPROVAL_CARDS = Object.freeze(["file-edit", "file-write", "notebook-edit", "shell", "fetch", "skill", "workflow", "plan", "question", "generic"]);
|
|
3
|
+
export const TOOL_APPROVAL_CARDS = Object.freeze(["file-edit", "file-write", "notebook-edit", "shell", "fetch", "skill", "workflow", "plan", "question", "generic", "computer-access", "computer-control"]);
|
|
4
4
|
export function isToolApprovalCard(word) {
|
|
5
5
|
return typeof word === "string" && TOOL_APPROVAL_CARDS.includes(word);
|
|
6
6
|
}
|
|
@@ -1,33 +1,5 @@
|
|
|
1
1
|
import { type ProtocolNamespace } from "./protocol-table.js";
|
|
2
2
|
import type { RuleBehavior } from "./permission-rule-model.js";
|
|
3
|
-
/**
|
|
4
|
-
* RB-476-A stage 2 (ruling 2026-08-02, RB-476 "no compatibility surface survives", replay
|
|
5
|
-
* resolution included) — the durable-name machinery this module used to hold is RETIRED:
|
|
6
|
-
*
|
|
7
|
-
* - `OLD_TO_NEW` (the Q6/design-108/design-115 persisted-name normalization) and the MCP `mcp__`
|
|
8
|
-
* prefix arm are gone: a persisted checkpoint/orphan/policy entry carrying a pre-rename name no
|
|
9
|
-
* longer resolves to the live roster. Old durable state misses LOUDLY (`resume.tool_unavailable`
|
|
10
|
-
* on a resumed checkpoint, a roster miss on replay) — by ruling, old sessions are sacrificed
|
|
11
|
-
* rather than carried.
|
|
12
|
-
* - `canonicalToolName` is gone with it: with the mapping cleared it was the identity function, and
|
|
13
|
-
* keeping an identity shim invites the next mapping to grow back silently.
|
|
14
|
-
* - `TOMBSTONED_TOOLS` (a second table of per-name re-education prose) is gone. A CALL to a retired name is
|
|
15
|
-
* told what the one table here says about it ({@link judgeToolNameMiss}): the miss is `expected-absent`
|
|
16
|
-
* with the successor, where any other unknown name stays the generic roster miss.
|
|
17
|
-
*
|
|
18
|
-
* What REMAINS is validation data: {@link RETIRED_TOOL_NAMES} maps every name the engine ever
|
|
19
|
-
* retired to a one-line guidance string, and {@link judgeRuleToolName} is the ONE judgment of it a rule's
|
|
20
|
-
* tool name gets ({@link toolNameFaultOf} adds the near-miss step: the one reading). They exist because deleting the mapping flips stale POLICY entries from "silently
|
|
21
|
-
* matched" to "silently matches nothing" — and for a deny/requireApproval entry that direction WIDENS
|
|
22
|
-
* the surface. `validatePermissionRules` (permission-rules.ts) does NOT classify retired names itself:
|
|
23
|
-
* which names a deployment mounts its OWN tool under is a roster fact, and the judgment takes the roster.
|
|
24
|
-
* A deployment that mounts its OWN tool under one of these names is unaffected: the name is then in the
|
|
25
|
-
* roster and the judgment answers `current`.
|
|
26
|
-
*
|
|
27
|
-
* GRAMMAR of a guidance string, read by {@link judgeRuleToolName} and held by a pin: it opens with
|
|
28
|
-
* `renamed "<name>"` (a 1:1 successor — the judgment's `currentName`), `folded into "<name>"` (merged into a
|
|
29
|
-
* wider tool: writing it would deny more than the entry did, so it is no current name), or `removed — `.
|
|
30
|
-
*/
|
|
31
3
|
export declare const RETIRED_TOOL_NAMES: ReadonlyMap<string, string>;
|
|
32
4
|
/** The four answers {@link judgeRuleToolName} gives — a closed set. */
|
|
33
5
|
export declare const RULE_TOOL_NAME_VERDICTS: readonly ["current", "retired", "unprefixed_namespace", "unmintable_segment"];
|
|
@@ -95,7 +67,11 @@ export interface PeerReading {
|
|
|
95
67
|
* segment is read through the mint — the peer a reading names is the one the mint would spell it as. `[]` for a name with no
|
|
96
68
|
* second reading: no separator in the body (the one reading is {@link splitNamespacedName}'s), a glob, an empty segment on either
|
|
97
69
|
* side of a cut, or a namespace the reference has no spelling for (only MCP's server names reach a rule from another product).
|
|
98
|
-
* The first reading is the first separator's — the one `splitNamespacedName` gives.
|
|
70
|
+
* The first reading is the first separator's — the one `splitNamespacedName` gives. The readings run one way only: from the
|
|
71
|
+
* reference's spelling to the minted peers. The fold is lossy (`a__b` and `a_b` mint one prefix) and only a peer segment is folded —
|
|
72
|
+
* the separator between a peer and its tool never is — so a name already in the minted spelling (`mcp__a_b__t`) is the name the
|
|
73
|
+
* engine mounts and is read as that, never as the unfolded spellings that fold to it (server `a`'s tool `b__t` is another tool);
|
|
74
|
+
* a name no mint produces (`b3126_echo`) reads as no tool, and the policy-name audit announces it.
|
|
99
75
|
*/
|
|
100
76
|
export declare function peerReadingsOf(name: string): readonly PeerReading[];
|
|
101
77
|
/**
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { carriesNamespaceSeparator, MCP_NAMESPACE, protocolOf } from "./protocol-table.js";
|
|
2
2
|
import { mintNamespacePrefix } from "./protocol-naming.js";
|
|
3
3
|
import { catalogToolNames } from "./tool-registry.js";
|
|
4
|
+
const BACKGROUND_OUTPUT_READING = "removed — read a background command's output file with Read (its launch receipt and completion notification name the path); a background agent's or workflow's result arrives in its completion notification (read the full text with ReadToolResult and the ref it names when the notification clips it)";
|
|
4
5
|
export const RETIRED_TOOL_NAMES = new Map([
|
|
5
6
|
["read_file", 'renamed "Read"'],
|
|
6
7
|
["edit_file", 'renamed "Edit"'],
|
|
@@ -25,11 +26,14 @@ export const RETIRED_TOOL_NAMES = new Map([
|
|
|
25
26
|
["run_workflow", 'renamed "Workflow"'],
|
|
26
27
|
["RunWorkflow", 'renamed "Workflow"'],
|
|
27
28
|
["Task", 'renamed "Agent" (a deployment-defined tool named "Task" is fine — this fires only when the name matches nothing in the roster)'],
|
|
28
|
-
["
|
|
29
|
-
["
|
|
30
|
-
["
|
|
31
|
-
["
|
|
32
|
-
["
|
|
29
|
+
["TaskOutput", BACKGROUND_OUTPUT_READING],
|
|
30
|
+
["BashOutput", BACKGROUND_OUTPUT_READING],
|
|
31
|
+
["AgentOutputTool", BACKGROUND_OUTPUT_READING],
|
|
32
|
+
["BashOutputTool", BACKGROUND_OUTPUT_READING],
|
|
33
|
+
["AgentOutput", BACKGROUND_OUTPUT_READING],
|
|
34
|
+
["WorkflowStatus", BACKGROUND_OUTPUT_READING],
|
|
35
|
+
["TeamCreate", "removed — the session has one implicit team: start a teammate with Agent (a name makes it addressable via SendMessage)"],
|
|
36
|
+
["TeamDelete", "removed — the session has one implicit team: stop a teammate with TaskStop"],
|
|
33
37
|
["KillShell", 'renamed "TaskStop"'],
|
|
34
38
|
["KillBash", 'renamed "TaskStop"'],
|
|
35
39
|
["ListMcpResources", 'renamed "ListMcpResourcesTool"'],
|
|
@@ -4,13 +4,16 @@
|
|
|
4
4
|
* the wire name the gate resolves it to, the other aliases that resolve to the same row); which of them a site reads
|
|
5
5
|
* is a property of the SITE, declared here once:
|
|
6
6
|
*
|
|
7
|
-
* · `any` — a TIGHTEN keyed on an engine name set
|
|
8
|
-
*
|
|
7
|
+
* · `any` — a TIGHTEN keyed on an engine name set (a deny / ask rule's content included), or a rule naming a WHOLE tool
|
|
8
|
+
* (no content: the name a person or a skill wrote reaches every call that answers to it): the call is held
|
|
9
|
+
* under EVERY name it answers to ({@link heldBy}); a set-valued table is read as the union of its entries
|
|
10
|
+
* ({@link heldValues}).
|
|
9
11
|
* · `seat` — a multi-key seat keyed on engine names: ONE name is chosen ({@link seatOf}) and every key of the seat is
|
|
10
12
|
* read under it. `tier` = the name whose irreversibility tier is strictest (`never < maybe < always`, an
|
|
11
13
|
* absent tier lowest; a tie goes to the call's wire name — the tool that runs judges its own call with its
|
|
12
14
|
* own probe — then to the earlier name of the call); `member` = the first name the table holds.
|
|
13
|
-
* · `wire` — a GRANT or a ROUTING keyed on an engine name
|
|
15
|
+
* · `wire` — a GRANT or a ROUTING keyed on an engine name — an allow rule's content (read in the grammar of the tool that
|
|
16
|
+
* runs), and every entry of an allow list handed in at launch: the call's wire name only ({@link wireOf}).
|
|
14
17
|
* · `spelling` — a record of what the model said (stream frames, transcripts, counters): the harness event's own name;
|
|
15
18
|
* no port — listed so the table is complete.
|
|
16
19
|
*
|
|
@@ -111,6 +114,10 @@ export declare const NAME_READINGS: {
|
|
|
111
114
|
readonly kind: "any";
|
|
112
115
|
readonly file: string;
|
|
113
116
|
};
|
|
117
|
+
readonly "allowEntry.launchListNames": {
|
|
118
|
+
readonly kind: "wire";
|
|
119
|
+
readonly file: string;
|
|
120
|
+
};
|
|
114
121
|
readonly "skillGrant.binding": {
|
|
115
122
|
readonly kind: "wire";
|
|
116
123
|
readonly file: string;
|
|
@@ -127,6 +134,10 @@ export declare const NAME_READINGS: {
|
|
|
127
134
|
readonly kind: "any";
|
|
128
135
|
readonly file: string;
|
|
129
136
|
};
|
|
137
|
+
readonly "policy.persistedGrammar.grant": {
|
|
138
|
+
readonly kind: "wire";
|
|
139
|
+
readonly file: string;
|
|
140
|
+
};
|
|
130
141
|
readonly "policy.persistedToolRule": {
|
|
131
142
|
readonly kind: "any";
|
|
132
143
|
readonly file: string;
|
|
@@ -29,10 +29,12 @@ export const NAME_READINGS = {
|
|
|
29
29
|
"policy.projectionReplay": any(POLICY),
|
|
30
30
|
"policy.sessionRules.effect": wire("src/core/runner/session-rule-policy.ts"),
|
|
31
31
|
"allowEntry.names": any("src/core/allow-entry.ts"),
|
|
32
|
+
"allowEntry.launchListNames": wire("src/core/allow-entry.ts"),
|
|
32
33
|
"skillGrant.binding": wire("src/core/skill-grant.ts"),
|
|
33
34
|
"gate.skillActivationSeat": wire(GATE),
|
|
34
35
|
"policy.permissionRules": any("src/core/permission-rules.ts"),
|
|
35
36
|
"policy.persistedGrammar": any("src/core/permission-rule-model.ts"),
|
|
37
|
+
"policy.persistedGrammar.grant": wire("src/core/permission-rule-model.ts"),
|
|
36
38
|
"policy.persistedToolRule": any("src/core/permission-rule-model.ts"),
|
|
37
39
|
"policy.sensitivePathGuardedByName": any("src/core/sensitive-path-policy.ts"),
|
|
38
40
|
"floor.protectivePathTarget": seat("member", "src/core/tool-registry.ts"),
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { 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 Settlement } from "./gate-outcome.js";
|
|
4
|
+
import { type DecidedVia, type Settlement } from "./gate-outcome.js";
|
|
5
5
|
export { policyCannotAnswer, rowDemandsAPerson } from "./real-approval.js";
|
|
6
6
|
import { type BindingFault } from "./canonical-json.js";
|
|
7
7
|
import { type DecisionReason } from "./decision-receipt.js";
|
|
@@ -293,6 +293,20 @@ export declare function screenApproverAttribution(v: unknown): {
|
|
|
293
293
|
approver?: string;
|
|
294
294
|
defect?: string;
|
|
295
295
|
};
|
|
296
|
+
/**
|
|
297
|
+
* Screen the `decidedVia` member — the ONE screen both entry points hold it to (the synchronous `AskOutcome` object and
|
|
298
|
+
* the durable `hostDecision`), so one value cannot meet two standards depending on its door. `word` is the decider word
|
|
299
|
+
* the same answer reported (`settledBy`, folded; `hostDecision.decidedBy`): both closed sets spell the policy decider
|
|
300
|
+
* `"policy"`, and that is the only word the member refines.
|
|
301
|
+
*
|
|
302
|
+
* Returns `{}` for absent, `{ decidedVia }` for a member of {@link DECIDED_VIA} beside `"policy"`, or `{ defect }` with the
|
|
303
|
+
* sentence the caller puts in its own refusal. A closed word is exact: the empty string is outside the set, and the
|
|
304
|
+
* defect names the member and the set, never the supplied value (a host string is not echoed into a refusal).
|
|
305
|
+
*/
|
|
306
|
+
export declare function screenDecidedVia(v: unknown, word: string): {
|
|
307
|
+
decidedVia?: DecidedVia;
|
|
308
|
+
defect?: string;
|
|
309
|
+
};
|
|
296
310
|
/** An integrity guard an ask stands on — an engine finding, carried on the ask's record ({@link EngineAttestation.guards}). */
|
|
297
311
|
export type AskGuard = "dangerous_delete" | "unverifiable_delete" | "unverifiable_shell_text" | "transcript_write" | "artifact_shared_read";
|
|
298
312
|
/**
|
|
@@ -455,6 +469,11 @@ export type PermissionResult = {
|
|
|
455
469
|
/** The ask's whole class set, in {@link import("./ask-origin.js").ASK_CLASSES} order (see
|
|
456
470
|
* {@link AskRequest.classes}). Stamped beside {@link askClass}, under the same rule. */
|
|
457
471
|
classes?: readonly import("./ask-origin.js").AskClass[];
|
|
472
|
+
/** WHO asked about this call and what each said, in its own words — see {@link AskRequest.askReasons}. A STAMP member:
|
|
473
|
+
* the gate writes it where it receives a policy chain's ask ({@link import("./ask-origin.js").chainAskReasonsOf}) and
|
|
474
|
+
* where a hook or an extension asks ({@link import("./ask-origin.js").hookAskReasonOf}); a decision that states it is
|
|
475
|
+
* refused at the receipt. A layer that spreads the ask keeps it. */
|
|
476
|
+
askReasons?: readonly import("./ask-origin.js").AskReason[];
|
|
458
477
|
/** The call could not be READ against a rule that may reach it — a content-form deny row, a content-form
|
|
459
478
|
* ask row, a persisted-rule row (the lexer's word), or rows the shell read station's boundary stands on that
|
|
460
479
|
* could not be read (`persisted_rows`). ENGINE-STAMPED at the four unreadable mint sites;
|
|
@@ -633,13 +652,28 @@ export interface ToolPolicy {
|
|
|
633
652
|
* name refuses the run, an unmounted one is advised). Carried through {@link combinePolicies} (the union of the
|
|
634
653
|
* members' groups); read with {@link toolPolicyNameSets}. */
|
|
635
654
|
readonly nameSets?: readonly ToolPolicyNameSets[];
|
|
655
|
+
/** The tools this policy refuses EVERY call of — its deny rules that name a whole tool (no content: `Tool`, `Tool(*)`, a
|
|
656
|
+
* protocol peer, a covering glob), whatever the call carries: one read of the rules (a policy whose rules move reads them
|
|
657
|
+
* then), and the judge of a tool by every name it answers to. The model's tool table leaves such a tool out; `check` still
|
|
658
|
+
* refuses its calls (the member answers no call). A policy that declares it names only tools its own `check` refuses every
|
|
659
|
+
* call of. Carried through {@link combinePolicies} (a tool any member refuses whole); read with {@link toolPolicyWholeToolRefusals}. */
|
|
660
|
+
readonly wholeToolRefusals?: (signal?: AbortSignal) => Promise<WholeToolRefusal>;
|
|
636
661
|
}
|
|
662
|
+
/** A tool as a rule names it: its name and the face the roster stamps (every name it answers to). */
|
|
663
|
+
export type ToolIdentity = Pick<ToolCallRequest, "toolName" | "face">;
|
|
664
|
+
/** Whether a policy (or a lane) refuses every call of the tool — the judge one read of its whole-tool deny rules yields. */
|
|
665
|
+
export type WholeToolRefusal = (tool: ToolIdentity) => boolean;
|
|
666
|
+
/** The judge of a policy with no whole-tool deny rule. */
|
|
667
|
+
export declare const REFUSES_NO_WHOLE_TOOL: WholeToolRefusal;
|
|
668
|
+
/** The id a whole-tool judge's read of the session rules carries — no call of the leg, so that reader takes a read of its own
|
|
669
|
+
* for it (the person's rules are read for a request through `PersonPathRows.forRequest`). */
|
|
670
|
+
export declare const TOOL_TABLE_VIEW_READ = "tool-table-view";
|
|
637
671
|
/**
|
|
638
672
|
* The members a policy carries beside `check` — one table for every seat that carries them: {@link wrapToolPolicy} reads
|
|
639
673
|
* each by name off the wrapped policy, {@link combinePolicies} folds each. The fence makes a new {@link ToolPolicy} member
|
|
640
674
|
* a compile error until the table names it.
|
|
641
675
|
*/
|
|
642
|
-
declare const TOOL_POLICY_CARRIED_MEMBERS: readonly ["projection", "pathRules", "writeGuardRows", "nameSets"];
|
|
676
|
+
declare const TOOL_POLICY_CARRIED_MEMBERS: readonly ["projection", "pathRules", "writeGuardRows", "nameSets", "wholeToolRefusals"];
|
|
643
677
|
type ToolPolicyCarriedMember = (typeof TOOL_POLICY_CARRIED_MEMBERS)[number];
|
|
644
678
|
export type ToolPolicyCarriesEveryMember = AssertAllKeysHandled<Exclude<Exclude<keyof ToolPolicy, "check">, ToolPolicyCarriedMember>>;
|
|
645
679
|
/** The carried members that are set on `p`, each read by name — an accessor or a non-enumerable member included. A
|
|
@@ -666,6 +700,10 @@ export declare function toolPolicyPathRules(policies: readonly (ToolPolicy | und
|
|
|
666
700
|
* judgment, in member order (a member that throws throws here — the judgment leaves the target unplaced). `undefined`
|
|
667
701
|
* when none carries any. */
|
|
668
702
|
export declare function toolPolicyWriteGuardRows(policies: readonly (ToolPolicy | undefined)[]): ToolPolicy["writeGuardRows"];
|
|
703
|
+
/** The whole-tool refusals the given holders carry together (combined policies included): one read of every reading they stand
|
|
704
|
+
* for, side by side, each settled ({@link settledWholeToolRead}) — a reading the fold holds twice (a layer re-appended) once; a
|
|
705
|
+
* tool refused whole when any reading refuses it whole (a deny in the fold refuses the call). `undefined` when none carries any. */
|
|
706
|
+
export declare function toolPolicyWholeToolRefusals(holders: readonly (Pick<ToolPolicy, "wholeToolRefusals"> | undefined)[]): ToolPolicy["wholeToolRefusals"];
|
|
669
707
|
/**
|
|
670
708
|
* One deterministic DENY component of a {@link ToolPolicyProjection} (F-012 L1). All fields are plain
|
|
671
709
|
* serializable data — a component round-trips JSON/`structuredClone` unchanged, which is what lets a
|
|
@@ -1372,21 +1410,27 @@ export interface AskRequest {
|
|
|
1372
1410
|
* durable suspend/checkpoint flow does NOT invoke `onAsk` on the suspend side, so v1 ask-aggregation
|
|
1373
1411
|
* requires `checkpointStore` unset (design S1d §1.4 P-a). */
|
|
1374
1412
|
readonly principal?: string;
|
|
1375
|
-
/** Runner-filled
|
|
1376
|
-
* to tell which worker an ask came from
|
|
1377
|
-
* **worker-unforgeable for Runner-created delegated
|
|
1378
|
-
* Runner mints it); a top-level caller MAY continue its own
|
|
1379
|
-
* is NOT a global "never forgeable" run id — aggregation only
|
|
1380
|
-
* where it holds (design S1d §1.3).
|
|
1381
|
-
*
|
|
1382
|
-
*
|
|
1383
|
-
|
|
1384
|
-
|
|
1413
|
+
/** Runner-filled: the issuing leg's session id — the conversation the ask was raised in, the address its
|
|
1414
|
+
* transcript and its parked row live at. An aggregating `onAsk` uses it to tell which worker an ask came from
|
|
1415
|
+
* (nested grandchildren each carry their own session). **worker-unforgeable for Runner-created delegated
|
|
1416
|
+
* subagents** (a child never sets sessionId — the Runner mints it); a top-level caller MAY continue its own
|
|
1417
|
+
* session via `TaskSpec.sessionId`, so this is NOT a global "never forgeable" run id — aggregation only
|
|
1418
|
+
* aggregates delegated workers, the context where it holds (design S1d §1.3). Present on every ask the
|
|
1419
|
+
* Runner mints, the host's included. It names a conversation, never a task: the delegated agent that asked
|
|
1420
|
+
* is {@link agentId}. `readonly` + same sync-path-only / P-a caveat as `principal`. */
|
|
1421
|
+
readonly sourceSessionId?: string;
|
|
1422
|
+
/** Runner-filled: the issuing leg's task id when that leg is a DELEGATED CHILD — a background sub-agent's
|
|
1423
|
+
* registry task id (`a…`, the string its row, `TaskStop`, `SendMessage` and `task_notification.task_id` use),
|
|
1424
|
+
* else the leg's own task id (a foreground sub-agent has no registry row: its session id). Present exactly
|
|
1425
|
+
* when {@link isDelegatedChild} is (a fork and a directly-started workflow's agent included — NOT the
|
|
1426
|
+
* {@link fromSubagent} set); absent on a host ask. The same value the leg's extension events carry as
|
|
1427
|
+
* `agentId`, read through the one predicate that mints it there. `readonly`, sync-path-only, S1d posture. */
|
|
1428
|
+
readonly agentId?: string;
|
|
1385
1429
|
/** design/153 §1 (RB-39②) — Runner-filled: present (`true`) exactly when the gate raising this ask
|
|
1386
1430
|
* belongs to a DELEGATED SUBAGENT (the prepareTask `isSubagent` fact — trusted `internals.parentTaskId`
|
|
1387
1431
|
* presence; a child cannot self-declare or suppress it, internals never ride a TaskSpec). Undefined ⇒ the
|
|
1388
1432
|
* host / a top-level task. THE explicit "from a background agent" discriminator (replaces presence-
|
|
1389
|
-
* or equality-heuristics on {@link
|
|
1433
|
+
* or equality-heuristics on {@link sourceSessionId}). `readonly`, sync-path-only, S1d posture. */
|
|
1390
1434
|
readonly fromSubagent?: true;
|
|
1391
1435
|
/** design/153 §1 — Runner-filled: the issuing task's display identity (a subagent's explicit agent
|
|
1392
1436
|
* name, else its agent-type; undefined for the host and unnamed children). **UNTRUSTED-for-display**
|
|
@@ -1502,6 +1546,15 @@ export interface AskRequest {
|
|
|
1502
1546
|
* reads the whole set — a class it will not answer anywhere in it is a question it does not answer. Present exactly
|
|
1503
1547
|
* when {@link askClass} is. */
|
|
1504
1548
|
readonly classes?: readonly import("./ask-origin.js").AskClass[];
|
|
1549
|
+
/** WHO asked about this call and what each said, in its OWN words, in fold order ({@link
|
|
1550
|
+
* import("./ask-origin.js").AskReason}): a deployment policy chain's ask sentence, a hook's or an extension's reason, a hook
|
|
1551
|
+
* host's cause word. Present ⇔ at least one asker said something of its own about this call; a generic question (the write
|
|
1552
|
+
* gate's default sentence, the permission mode's own) and a sentence the engine composes about a fact that rides a typed
|
|
1553
|
+
* member of this request are no entry. The structured approval surface renders this member and the typed members beside it,
|
|
1554
|
+
* never {@link message}; `words` is untrusted display text (one line, capped). Filled by the four mint stations from one
|
|
1555
|
+
* reader; the parked row carries the same value (`PendingAction.tool_approval.askReasons`). Never caller/worker-settable:
|
|
1556
|
+
* a policy or hook answer that states it is refused at the decision receipt. */
|
|
1557
|
+
readonly askReasons?: readonly import("./ask-origin.js").AskReason[];
|
|
1505
1558
|
/** Engine-judged risk axes of the action awaiting approval, for the human decision surface: a
|
|
1506
1559
|
* coarse `requiresRealApproval` cannot tell "cannot be undone" from "data leaves the machine",
|
|
1507
1560
|
* and those call for different scrutiny. Filled by the gate from the SAME resolved axes the
|
|
@@ -1522,7 +1575,7 @@ export interface AskRequest {
|
|
|
1522
1575
|
/** ruled 2026-08-04 — present exactly when this ask was raised inside a DELEGATED child whose approver
|
|
1523
1576
|
* is the ancestor run's (the `ToolExecuteContext.onAsk` seat the delegation tool forwards). Additive:
|
|
1524
1577
|
* an approver that ignores it is unaffected; a durable park/suspend flow never invokes `onAsk` at all,
|
|
1525
|
-
* so this — like `principal`/`
|
|
1578
|
+
* so this — like `principal`/`sourceSessionId` — exists only on the synchronous resolution path.
|
|
1526
1579
|
* See {@link AskDelegationProvenance} for the trust posture of each member. */
|
|
1527
1580
|
readonly delegation?: AskDelegationProvenance;
|
|
1528
1581
|
/**
|
|
@@ -1551,7 +1604,7 @@ export interface AskRequest {
|
|
|
1551
1604
|
* on the type because a deployment may invoke its approver function directly.
|
|
1552
1605
|
*
|
|
1553
1606
|
* SCOPE, stated so absence is not read as a clean bill on the other routes: this is the
|
|
1554
|
-
* SYNCHRONOUS `onAsk` ask, like `principal`/`
|
|
1607
|
+
* SYNCHRONOUS `onAsk` ask, like `principal`/`sourceSessionId` — the closure claim is over AskRequest
|
|
1555
1608
|
* mint sites, not over every approval callback. The other two human-decision routes:
|
|
1556
1609
|
* ① a durable park/suspend never invokes `onAsk` and never mints an AskRequest — its twin of this
|
|
1557
1610
|
* bit is the PERSISTED `PendingAction.tool_approval.hasBidiControls` on the parked row (judged at
|
|
@@ -1568,6 +1621,8 @@ export interface AskRequest {
|
|
|
1568
1621
|
*/
|
|
1569
1622
|
readonly hasBidiControls?: true;
|
|
1570
1623
|
}
|
|
1624
|
+
/** The issuing leg's identity on a Runner-minted ask: minted once per leg, and every ask, question and park of the leg reads it. */
|
|
1625
|
+
export type AskSourceIdentity = Pick<AskRequest, "principal" | "sourceSessionId" | "agentId" | "fromSubagent" | "sourceAgentName" | "isDelegatedChild">;
|
|
1571
1626
|
/**
|
|
1572
1627
|
* How an `ask` decision is resolved when a policy/hook requests human confirmation (design/37):
|
|
1573
1628
|
* - `"deny"` (and the default when omitted) — **headless auto-deny**: no approver, so `ask` resolves
|
|
@@ -1678,6 +1733,15 @@ export type OnAsk = "deny" | "allow" | ((req: AskRequest, signal?: AbortSignal)
|
|
|
1678
1733
|
* produced (an abort, a throw, an unclonable edit): nobody approved those. A host's own elapsed window has
|
|
1679
1734
|
* no attribution seat on its record (`approval_window_expired` names the host as a party, not a seat).
|
|
1680
1735
|
*
|
|
1736
|
+
* `decidedVia` — WHICH MACHINE SEAT answered for `settledBy: "policy"`, a closed word
|
|
1737
|
+
* ({@link import("./gate-outcome.js").DECIDED_VIA}; the durable leg's `hostDecision.decidedVia` is the same word):
|
|
1738
|
+
* `"policy"` (the deployment's own policy; ABSENT reads the same) or `"permission_request_hook"` (a PermissionRequest
|
|
1739
|
+
* hook answered on the deployment's behalf). It picks the refusal SENTENCE ({@link policyRefusalMessage}) — a
|
|
1740
|
+
* hook's "no" is not "this run has no interactive approval channel" — and leaves the record as it is
|
|
1741
|
+
* (`policy_refused` / `policy_allowed`). Not `approver`: that seat is a transcription core never reads back; this one
|
|
1742
|
+
* is the closed word core reads. Read once with the other members; a value outside the closed set, or the member beside
|
|
1743
|
+
* any word but `"policy"` (a person, an elapsed window), is a loud fail-closed refusal at {@link resolveAsk}.
|
|
1744
|
+
*
|
|
1681
1745
|
* `readRootGrant` — "yes, and add this directory": the card's {@link AskRequest.readRootCandidate} `dir`, sent back
|
|
1682
1746
|
* byte for byte (`shell.read_boundary.grant_candidate_is_the_grant`). Beside `allow: true` on an ask carrying that
|
|
1683
1747
|
* candidate, THIS run's read directories include it from then on (read faces only; `covers: "exact"` = that one
|
|
@@ -1691,6 +1755,7 @@ export type AskOutcome = boolean | "unavailable" | {
|
|
|
1691
1755
|
settledBy?: "human" | "timeout" | "policy";
|
|
1692
1756
|
reason?: string;
|
|
1693
1757
|
approver?: string;
|
|
1758
|
+
decidedVia?: DecidedVia;
|
|
1694
1759
|
readRootGrant?: string;
|
|
1695
1760
|
};
|
|
1696
1761
|
/**
|
|
@@ -1791,12 +1856,30 @@ export declare function tryCloneArgs<T>(v: T): {
|
|
|
1791
1856
|
* exit reports (`finalInput`, the deny observer's `input`); a deny already carrying the args its own layers judged (a composed
|
|
1792
1857
|
* chain's, nested ones included) keeps them. Read by the gate's lanes and by {@link combinePolicies}. Only a deny is changed. */
|
|
1793
1858
|
export declare function refusalOf<D extends PermissionResult>(deny: D, judged: unknown): D;
|
|
1859
|
+
/** Who spoke an extension's verdict on a call, as a gate sentence names it (`extension "<registration>"`, else "an
|
|
1860
|
+
* extension"), and the reason it gave (`: <reason>`, else nothing) — read by every sentence about an extension's verdict,
|
|
1861
|
+
* a `tool.check` answer's and a `classic.PreToolUse` answer's alike. */
|
|
1862
|
+
export declare function extensionSpeaker(by: string | undefined, reason: string | undefined): {
|
|
1863
|
+
readonly who: string;
|
|
1864
|
+
readonly why: string;
|
|
1865
|
+
};
|
|
1866
|
+
/** `extension "<registration>"` — the registration's name as a quoted string, so a name can never end its own quotes and run on
|
|
1867
|
+
* into the sentence around it. A registered name has one form (`MOD_REGISTRATION_NAME`, the kernel's screen) and this reads
|
|
1868
|
+
* identically to it; the quoting is the second line, for a name no screen has judged here (one carried in from elsewhere). */
|
|
1869
|
+
export declare function extensionNamed(registration: string): string;
|
|
1870
|
+
/** An extension's own question about a call, as the text a reader of `message` reads it: which extension asks, and why — read
|
|
1871
|
+
* off the question's ONE entry ({@link import("./ask-origin.js").hookAskReasonOf}), so the sentence and the entry are one value.
|
|
1872
|
+
* The one sentence an ask raised by an extension carries, whichever event raised it (`tool.check`, `classic.PreToolUse`); when
|
|
1873
|
+
* the hook's host asks because the hook gave no verdict it could act on, the sentence says that instead of quoting anyone. */
|
|
1874
|
+
export declare function extensionQuestionText(toolName: string, entry: Extract<import("./ask-origin.js").AskReason, {
|
|
1875
|
+
by: "hook";
|
|
1876
|
+
}>): string;
|
|
1794
1877
|
/**
|
|
1795
1878
|
* A PreToolUse hook's `ask` folded over a verdict by `deny > ask > allow` — the ONE law for the gate's first screening and for
|
|
1796
1879
|
* an approved edit's re-screen. A deny stands. Over an allow, the hook's own ask, RECONSTRUCTED rather than spread (its message,
|
|
1797
|
-
* its real-approval demand and cross-boundary member, its rewrite) under the hook provenance the engine stamps. Over an ask, that ask keeps every member,
|
|
1880
|
+
* its real-approval demand and cross-boundary member, its rewrite, its askers' entries) under the hook provenance the engine stamps. Over an ask, that ask keeps every member,
|
|
1798
1881
|
* takes the hook provenance and the hook's real-approval demand and cross-boundary member, and its message carries the hook's beside its own — a person
|
|
1799
|
-
* clearing one ask that stands for two gates sees both reasons.
|
|
1882
|
+
* clearing one ask that stands for two gates sees both reasons: its `askReasons` are the standing ask's entries, then the hook's.
|
|
1800
1883
|
*/
|
|
1801
1884
|
export declare function foldHookAsk(verdict: Exclude<PermissionResult, {
|
|
1802
1885
|
action: "deny";
|
|
@@ -1898,8 +1981,16 @@ export declare function humanRefusalSentence(subject: HumanRefusalSubject, reaso
|
|
|
1898
1981
|
* as the user's guidance, because no user gave it. `askMessage` is the ask's own prompt where the caller
|
|
1899
1982
|
* has one (the synchronous leg does); a durable decide answers a call parked in an earlier leg and has
|
|
1900
1983
|
* none, and the head then simply names the call.
|
|
1984
|
+
*
|
|
1985
|
+
* WHICH MACHINE SEAT answered (`decidedVia`, read through {@link policyDeciderOf}) picks between two sentences
|
|
1986
|
+
* and nothing else. The deployment's own policy (the word, or its absence) gets the sentence above. Any other seat
|
|
1987
|
+
* DID answer, so "this run has no interactive approval channel" would be false about it: the head names the seat
|
|
1988
|
+
* that declined (`a PermissionRequest hook denied this call`), and the seat's own words ride the fence under its
|
|
1989
|
+
* label. The fence is a deliberate divergence from the reference, which hands a hook's message to the model as the
|
|
1990
|
+
* refusal text itself (`iPt` (cli309.js:288208), `runHooks` (cli309.js:295883)): here every decider's free text is
|
|
1991
|
+
* untrusted data and reaches the model only fenced, whoever typed it.
|
|
1901
1992
|
*/
|
|
1902
|
-
export declare function policyRefusalMessage(toolName: string, askMessage: string | undefined, note: string | undefined): string;
|
|
1993
|
+
export declare function policyRefusalMessage(toolName: string, askMessage: string | undefined, note: string | undefined, decidedVia: DecidedVia | undefined): string;
|
|
1903
1994
|
/**
|
|
1904
1995
|
* A {@link resolveAsk} result: always a TERMINAL `allow`/`deny` (never `ask`). `approverUnavailable`
|
|
1905
1996
|
* is the out-of-band G1 three-value marker: the live approver returned `"unavailable"` for this ask —
|