@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
|
@@ -135,12 +135,51 @@ export declare function isSettlementParty(v: unknown): v is SettlementParty;
|
|
|
135
135
|
export declare const HOST_DECIDERS: readonly ["person", "sla_timeout", "policy"];
|
|
136
136
|
export type HostDecider = (typeof HOST_DECIDERS)[number];
|
|
137
137
|
export declare const isHostDecider: (word: unknown) => word is HostDecider;
|
|
138
|
+
/**
|
|
139
|
+
* WHICH MACHINE SEAT answered when the deployment's policy decided an ask — the closed set of the `decidedVia` member
|
|
140
|
+
* (`AskOutcome.decidedVia` on the synchronous leg, `hostDecision.decidedVia` on a durable decide; one word set, one
|
|
141
|
+
* name, both faces). It refines the policy decider and nothing else: a person, an elapsed window and the host's SLA
|
|
142
|
+
* sweep are not machines that answered, so the member beside any other decider word is refused, never ignored.
|
|
143
|
+
* - `policy` — the deployment's own policy answered (an unattended lane answering by class, a headless lane whose
|
|
144
|
+
* seat can show nobody a prompt). ABSENT reads the same: an unrevised host is unchanged.
|
|
145
|
+
* - `permission_request_hook` — a PermissionRequest hook answered the ask on the deployment's behalf (the
|
|
146
|
+
* reference's `decisionReason.type: "hook"` with `hookName: "PermissionRequest"`, `iPt` (cli309.js:288208) /
|
|
147
|
+
* `runHooks` (cli309.js:295883)). A hook's refusal is not "this run has no approval channel": something DID answer,
|
|
148
|
+
* and the model reads that the hook declined, with the hook's own words.
|
|
149
|
+
* The record is unchanged by it (`policy_allowed` / `policy_refused`, `who.party: "policy"`): the member decides which
|
|
150
|
+
* sentence the model reads ({@link import("./tool-policy.js").policyRefusalMessage}), not which party the record names.
|
|
151
|
+
*/
|
|
152
|
+
export declare const DECIDED_VIA: readonly ["policy", "permission_request_hook"];
|
|
153
|
+
export type DecidedVia = (typeof DECIDED_VIA)[number];
|
|
154
|
+
export declare const isDecidedVia: (word: unknown) => word is DecidedVia;
|
|
155
|
+
/** The model-facing NAME of each machine seat a policy decision can come from ({@link policyDeciderOf}). */
|
|
156
|
+
declare const POLICY_DECIDER_NAMES: Readonly<{
|
|
157
|
+
readonly policy: "this deployment's own policy";
|
|
158
|
+
readonly permission_request_hook: "a PermissionRequest hook";
|
|
159
|
+
}>;
|
|
160
|
+
/** The fence over the name table: `never` while every seat word has a name. */
|
|
161
|
+
export type PolicyDeciderNamesCoverEverySeat = AssertAllKeysHandled<Exclude<DecidedVia, keyof typeof POLICY_DECIDER_NAMES>>;
|
|
162
|
+
/**
|
|
163
|
+
* THE reading of `decidedVia` — the one place its absence folds ("absent ⇒ the deployment's own policy") and the one
|
|
164
|
+
* place each seat is NAMED to the model. Every sentence that names who REFUSED a tool approval for the policy reads it:
|
|
165
|
+
* the refusal composer ({@link import("./tool-policy.js").policyRefusalMessage}, all three legs) and the durable
|
|
166
|
+
* resume's continuation reminder, so the tool result and the reminder about the same refusal can never name two
|
|
167
|
+
* different deciders. A sentence about a policy's ALLOW that a later check refuses names the party alone ("not a
|
|
168
|
+
* person"), and so does a plan pause's reminder.
|
|
169
|
+
*/
|
|
170
|
+
export declare function policyDeciderOf(decidedVia: DecidedVia | undefined): {
|
|
171
|
+
readonly seat: DecidedVia;
|
|
172
|
+
readonly name: string;
|
|
173
|
+
};
|
|
138
174
|
/** The host's DECISION FACTS on a durable decide — who ended the wait, and the attribution the approval channel
|
|
139
175
|
* reported for that party. ONE shape for every decide that records its decider (a tool approval's and a plan
|
|
140
|
-
* pause's); core mints the settlement word from it ({@link settlementOfHostDecision}), the host never supplies one.
|
|
176
|
+
* pause's); core mints the settlement word from it ({@link settlementOfHostDecision}), the host never supplies one.
|
|
177
|
+
* `decidedVia` — which machine seat answered for a `"policy"` decider ({@link DECIDED_VIA}); legal only beside
|
|
178
|
+
* `decidedBy: "policy"`, absent ⇒ the deployment's policy. */
|
|
141
179
|
export interface HostDecisionFacts {
|
|
142
180
|
decidedBy: HostDecider;
|
|
143
181
|
approver?: string;
|
|
182
|
+
decidedVia?: DecidedVia;
|
|
144
183
|
}
|
|
145
184
|
/** The DECIDER arms of {@link Settlement} — a person's and the deployment policy's, the two parties that
|
|
146
185
|
* answer an ask either way. Named so a site that both composes one and quotes its note can read the seat
|
|
@@ -28,6 +28,16 @@ export function isSettlementParty(v) {
|
|
|
28
28
|
}
|
|
29
29
|
export const HOST_DECIDERS = Object.freeze(["person", "sla_timeout", "policy"]);
|
|
30
30
|
export const isHostDecider = (word) => HOST_DECIDERS.some((w) => w === word);
|
|
31
|
+
export const DECIDED_VIA = Object.freeze(["policy", "permission_request_hook"]);
|
|
32
|
+
export const isDecidedVia = (word) => DECIDED_VIA.some((w) => w === word);
|
|
33
|
+
const POLICY_DECIDER_NAMES = Object.freeze({
|
|
34
|
+
policy: "this deployment's own policy",
|
|
35
|
+
permission_request_hook: "a PermissionRequest hook",
|
|
36
|
+
});
|
|
37
|
+
export function policyDeciderOf(decidedVia) {
|
|
38
|
+
const seat = decidedVia ?? "policy";
|
|
39
|
+
return { seat, name: POLICY_DECIDER_NAMES[seat] };
|
|
40
|
+
}
|
|
31
41
|
export function decidersNote(text) {
|
|
32
42
|
return text === "" ? undefined : text;
|
|
33
43
|
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { ExecutionEnv } from "../internal/harness-types.js";
|
|
1
|
+
import type { ExecutionEnv, ReadFloor } from "../internal/harness-types.js";
|
|
2
2
|
/** The managed parent (under the repository root) that holds every managed worktree — the reference implementation's
|
|
3
3
|
* `.claude/worktrees/` under this project's brand — so {@link pruneWorktrees} and a userland reaper find orphans by one known
|
|
4
4
|
* location. Every tree the engine mints lives at `<repoRoot>/.sema/worktrees/<slug>` (see {@link managedWorktreeDir}). */
|
|
@@ -31,6 +31,10 @@ export interface AddWorktreeOptions {
|
|
|
31
31
|
rootEnvAt: (worktreeDir: string) => ExecutionEnv | Promise<ExecutionEnv>;
|
|
32
32
|
/** Base commit/ref for the worktree (default `HEAD` at creation time). */
|
|
33
33
|
commit?: string;
|
|
34
|
+
/** The byte floor (`ExecutionEnvExecOptions.readFloor`) of every start the mint and the tree's removal make, read as each
|
|
35
|
+
* start begins: a run's git bookkeeping is the run's own start and carries the run's table. A read that throws is that
|
|
36
|
+
* step's failure (the add's refuses the mint before anything exists). Absent ⇒ the starts carry none (no run). */
|
|
37
|
+
readFloor?: () => ReadFloor | undefined;
|
|
34
38
|
}
|
|
35
39
|
/**
|
|
36
40
|
* Remove a managed worktree and — by the ONE branch rule — its branch: the branch is deleted only when its tip is still the
|
|
@@ -46,7 +50,7 @@ export interface AddWorktreeOptions {
|
|
|
46
50
|
export declare function removeManagedWorktree(baseEnv: ExecutionEnv, repoRoot: string, worktreeDir: string, branch?: {
|
|
47
51
|
readonly name: string;
|
|
48
52
|
readonly baseSha: string;
|
|
49
|
-
}): Promise<{
|
|
53
|
+
}, readFloor?: () => ReadFloor | undefined): Promise<{
|
|
50
54
|
ok: true;
|
|
51
55
|
branchDeleted?: string;
|
|
52
56
|
branchKept?: string;
|
|
@@ -85,7 +89,7 @@ export declare function addWorktree(baseEnv: ExecutionEnv, opts: AddWorktreeOpti
|
|
|
85
89
|
* on a claim it could not have checked. Same fail-loud treatment {@link removeManagedWorktree} already got
|
|
86
90
|
* Report the outcome, let the caller decide what to say. Never throws (a throwing env
|
|
87
91
|
* lands on the same `{ok:false}`), so a caller that ignores the value behaves exactly as before. */
|
|
88
|
-
export declare function pruneWorktrees(baseEnv: ExecutionEnv, repoRoot: string): Promise<{
|
|
92
|
+
export declare function pruneWorktrees(baseEnv: ExecutionEnv, repoRoot: string, readFloor?: ReadFloor): Promise<{
|
|
89
93
|
ok: true;
|
|
90
94
|
} | {
|
|
91
95
|
ok: false;
|
|
@@ -55,12 +55,13 @@ async function symlinkedLevel(env, repoRoot, worktreeDir) {
|
|
|
55
55
|
}
|
|
56
56
|
return undefined;
|
|
57
57
|
}
|
|
58
|
-
export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, branch) {
|
|
58
|
+
export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, branch, readFloor) {
|
|
59
|
+
const readFloorNow = () => { const f = readFloor?.(); return f !== undefined ? { readFloor: f } : {}; };
|
|
59
60
|
let detail = "";
|
|
60
61
|
let removed = false;
|
|
61
62
|
for (let attempt = 0; attempt < 2 && !removed; attempt++) {
|
|
62
63
|
try {
|
|
63
|
-
const r = await baseEnv.exec(`git worktree remove --force ${shq(worktreeDir)}`, { cwd: repoRoot });
|
|
64
|
+
const r = await baseEnv.exec(`git worktree remove --force ${shq(worktreeDir)}`, { cwd: repoRoot, ...readFloorNow() });
|
|
64
65
|
if (r.ok && r.value.exitCode === 0)
|
|
65
66
|
removed = true;
|
|
66
67
|
else
|
|
@@ -77,10 +78,10 @@ export async function removeManagedWorktree(baseEnv, repoRoot, worktreeDir, bran
|
|
|
77
78
|
if (!/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/.test(branch.baseSha) || /^0+$/.test(branch.baseSha))
|
|
78
79
|
return { ok: true, branchKept: `${branch.name} (its base commit is not a usable witness)` };
|
|
79
80
|
try {
|
|
80
|
-
const del = await baseEnv.exec(`git update-ref --no-deref -d ${shq(`refs/heads/${branch.name}`)} ${shq(branch.baseSha)}`, { cwd: repoRoot });
|
|
81
|
+
const del = await baseEnv.exec(`git update-ref --no-deref -d ${shq(`refs/heads/${branch.name}`)} ${shq(branch.baseSha)}`, { cwd: repoRoot, ...readFloorNow() });
|
|
81
82
|
if (del.ok && del.value.exitCode === 0)
|
|
82
83
|
return { ok: true, branchDeleted: branch.name };
|
|
83
|
-
const tip = await baseEnv.exec(`git rev-parse --verify --quiet ${shq(`refs/heads/${branch.name}`)}`, { cwd: repoRoot });
|
|
84
|
+
const tip = await baseEnv.exec(`git rev-parse --verify --quiet ${shq(`refs/heads/${branch.name}`)}`, { cwd: repoRoot, ...readFloorNow() });
|
|
84
85
|
if (tip.ok && tip.value.exitCode !== 0)
|
|
85
86
|
return { ok: true };
|
|
86
87
|
if (tip.ok && tip.value.stdout.trim() !== branch.baseSha)
|
|
@@ -101,20 +102,22 @@ export async function addWorktree(baseEnv, opts) {
|
|
|
101
102
|
const symlinked = await symlinkedLevel(baseEnv, opts.repoRoot, worktreeDir);
|
|
102
103
|
if (symlinked !== undefined)
|
|
103
104
|
throw new Error(symlinked);
|
|
105
|
+
const readFloorNow = () => { const readFloor = opts.readFloor?.(); return readFloor !== undefined ? { readFloor } : {}; };
|
|
104
106
|
const add = await baseEnv.exec(`git worktree add --no-track -b ${shq(branch)} ${shq(worktreeDir)} ${shq(opts.commit ?? "HEAD")}`, {
|
|
105
107
|
cwd: opts.repoRoot,
|
|
108
|
+
...readFloorNow(),
|
|
106
109
|
});
|
|
107
110
|
if (!add.ok || add.value.exitCode !== 0) {
|
|
108
111
|
const detail = add.ok ? add.value.stderr || add.value.stdout : thrownText(add.error);
|
|
109
112
|
throw new Error(`git worktree add failed: ${detail}`);
|
|
110
113
|
}
|
|
111
114
|
const excludeLine = shq(`/${WORKTREE_PARENT}/`);
|
|
112
|
-
await
|
|
113
|
-
.exec(`ex="$(git rev-parse --git-path info/exclude)" && mkdir -p "$(dirname "$ex")" && ` +
|
|
114
|
-
`{ grep -qxF ${excludeLine} "$ex" 2>/dev/null || printf '%s\\n' ${excludeLine} >> "$ex"; }`, { cwd: opts.repoRoot })
|
|
115
|
+
await Promise.resolve()
|
|
116
|
+
.then(() => baseEnv.exec(`ex="$(git rev-parse --git-path info/exclude)" && mkdir -p "$(dirname "$ex")" && ` +
|
|
117
|
+
`{ grep -qxF ${excludeLine} "$ex" 2>/dev/null || printf '%s\\n' ${excludeLine} >> "$ex"; }`, { cwd: opts.repoRoot, ...readFloorNow() }))
|
|
115
118
|
.catch(() => undefined);
|
|
116
|
-
const baseSha = await
|
|
117
|
-
.exec("git rev-parse HEAD", { cwd: worktreeDir })
|
|
119
|
+
const baseSha = await Promise.resolve()
|
|
120
|
+
.then(() => baseEnv.exec("git rev-parse HEAD", { cwd: worktreeDir, ...readFloorNow() }))
|
|
118
121
|
.then((r) => (r.ok && r.value.exitCode === 0 && r.value.stdout.trim() !== "" ? r.value.stdout.trim() : undefined))
|
|
119
122
|
.catch(() => undefined);
|
|
120
123
|
const branchRule = baseSha !== undefined ? { name: branch, baseSha } : undefined;
|
|
@@ -123,7 +126,7 @@ export async function addWorktree(baseEnv, opts) {
|
|
|
123
126
|
inner = await opts.rootEnvAt(worktreeDir);
|
|
124
127
|
}
|
|
125
128
|
catch (err) {
|
|
126
|
-
await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule);
|
|
129
|
+
await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule, opts.readFloor);
|
|
127
130
|
throw err;
|
|
128
131
|
}
|
|
129
132
|
const innerDestroy = inner.destroy;
|
|
@@ -134,7 +137,7 @@ export async function addWorktree(baseEnv, opts) {
|
|
|
134
137
|
await innerDestroy.call(inner);
|
|
135
138
|
}
|
|
136
139
|
finally {
|
|
137
|
-
const removed = await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule);
|
|
140
|
+
const removed = await removeManagedWorktree(baseEnv, opts.repoRoot, worktreeDir, branchRule, opts.readFloor);
|
|
138
141
|
if (!removed.ok) {
|
|
139
142
|
throw new Error(`git worktree remove failed twice — ${worktreeDir} is now an orphan (dir + registration remain; ` +
|
|
140
143
|
`\`git worktree prune\` cannot reclaim it while the dir exists — remove it manually): ${removed.detail}`);
|
|
@@ -143,9 +146,9 @@ export async function addWorktree(baseEnv, opts) {
|
|
|
143
146
|
};
|
|
144
147
|
return { env, worktreeDir, name, branch, ...(baseSha !== undefined ? { baseSha } : {}) };
|
|
145
148
|
}
|
|
146
|
-
export async function pruneWorktrees(baseEnv, repoRoot) {
|
|
149
|
+
export async function pruneWorktrees(baseEnv, repoRoot, readFloor) {
|
|
147
150
|
try {
|
|
148
|
-
const r = await baseEnv.exec("git worktree prune", { cwd: repoRoot });
|
|
151
|
+
const r = await baseEnv.exec("git worktree prune", { cwd: repoRoot, ...(readFloor !== undefined ? { readFloor } : {}) });
|
|
149
152
|
if (r.ok && r.value.exitCode === 0)
|
|
150
153
|
return { ok: true };
|
|
151
154
|
return {
|
|
@@ -145,7 +145,7 @@ export type NoticeAudience = "user" | "operator";
|
|
|
145
145
|
* the union's catalog ({@link EngineNotice.code}). The groups below say only which family a row joins,
|
|
146
146
|
* so the catalog is not written a second time here and the two cannot drift.
|
|
147
147
|
*/
|
|
148
|
-
export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "mcp.injection_dropped", "mcp.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "mcp.credential_echoed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "context.tool_turn_repaired", "context.
|
|
148
|
+
export declare const ENGINE_NOTICE_CODES: readonly ["config.autocompact_window_clamped", "config.env_timeout_discarded", "config.materialize_env_discarded", "config.models_swapped", "config.context_settings_swapped", "config.read_face_swapped", "config.read_face_deployment_clamped", "config.write_face_swapped", "config.write_face_deployment_clamped", "config.read_deny_swapped", "config.tool_model_gate_removed", "config.tool_model_gate_unknown_class", "config.tool_model_gate_env_invalid", "config.artifact_host_invalid", "config.task_root_not_canonical", "config.write_protection_target_view_absent", "config.path_view_unresolved", "config.execution_env_capability_invalid", "config.read_deny_floor_unkept", "config.read_floor_confinement_unavailable", "config.tool_card_undeclared", "config.tool_face_undeclared", "config.tool_face_invalid", "config.forward_sink_failed", "config.durable_gate_unavailable", "config.peer_admission_out_of_range", "config.peer_lane_unmounted", "config.secret_env_scrubbed", "inherit_env.names_withheld", "config.credential_not_withheld", "config.cross_boundary_posture_undeclared", "config.cross_boundary_record_unwritten", "config.permission_mode_unavailable", "permission.ask_released_by_mode", "permission.read_deny_unapplied", "permission.rule_store_unavailable", "permission.rule_row_dropped", "config.session_rules_earlier_grammar", "permission.allowed_tool_not_granted", "mods.registration_refused", "peer.inbound_disposition", "peer.held_settled", "peer.idle_subscription", "classifier.denial_limit", "classifier.fallback", "classifier.seat_rate_limited", "classifier.role_defaulted", "classifier.contract_broken", "classifier.unavailable", "checkpoint.execution_outcome_unrecorded", "delegation.transcript_integrity", "delegation.ask_unresolvable", "mcp.injection_dropped", "mcp.revocation_probe_failed", "mcp.server_redialed", "mcp.authorization_required", "mcp.credential_echoed", "workflow.governance_key_stripped", "workflow.agent_option_ignored", "memory.session_polluted", "memory.harvest_quarantined", "memory.delegation_static_mark_waived", "memory.content_class_declared", "memory.hold_opened", "memory.hold_released", "memory.hold_disposed", "memory.consolidation_recommended", "memory.consolidation_committed", "memory.consolidation_conflict", "memory.consolidation_incomplete", "memory.consolidation_refused", "memory.consolidation_withheld", "memory.restore_withheld", "memory.project_scope_absent", "route.fallback_to_primary", "route.classifier_unroutable", "route.seat_detached", "advisor.not_attached", "route.credential_origin_mismatch", "route.credential_rebound", "route.response_model_mismatch", "route.tool_call_id_folded", "route.finish_reason_unknown", "route.stream_end_ignored", "route.extra_body_reserved_dropped", "model.capability_downgraded", "model.role_defaulted", "context.tool_turn_repaired", "context.media_removed", "context.tool_schema_removed", "task.user_steer_undrained", "task.user_followup_undrained", "steering.parked_input_blocked", "task.turn_interrupted", "task.halt_unconsumed", "task.late_approval", "task.interrupt_unconsumed", "task.tool_turn_incomplete", "approval.read_root_granted", "approval.read_root_grant_rejected", "memory.capture_opted_out", "memory.capture_optout_unpersisted", "skills.listing_truncated", "agents.listing_truncated", "tool_result.offload_put_failed", "tool_result.media_refused", "config.image_processor_unavailable", "fs.staging_file_left", "fs.staging_file_swept", "session.lineage_rerooted", "instructions.source_changed", "session.records_skipped", "memory.layer_locked_legacy", "server.model_unreachable", "permission.entry_mode_clamped"];
|
|
149
149
|
/** A catalogued code (see {@link ENGINE_NOTICE_CODES}); {@link NOTICE_MINTER} says who mints it. NOT the type of
|
|
150
150
|
* `EngineNotice.code`, which stays `string` — a host forwarding its own notices through the same
|
|
151
151
|
* sink is a supported shape, and narrowing that field would break it. */
|
|
@@ -175,7 +175,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
|
|
|
175
175
|
readonly "classifier.denial_limit": "user";
|
|
176
176
|
readonly "classifier.unavailable": "user";
|
|
177
177
|
readonly "classifier.fallback": "operator";
|
|
178
|
-
readonly "classifier.seat_rate_limited": "
|
|
178
|
+
readonly "classifier.seat_rate_limited": "user";
|
|
179
179
|
readonly "classifier.role_defaulted": "operator";
|
|
180
180
|
readonly "classifier.contract_broken": "operator";
|
|
181
181
|
readonly "task.turn_interrupted": "user";
|
|
@@ -222,6 +222,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
|
|
|
222
222
|
readonly "config.path_view_unresolved": "operator";
|
|
223
223
|
readonly "config.execution_env_capability_invalid": "operator";
|
|
224
224
|
readonly "config.read_deny_floor_unkept": "operator";
|
|
225
|
+
readonly "config.read_floor_confinement_unavailable": "operator";
|
|
225
226
|
readonly "config.tool_card_undeclared": "operator";
|
|
226
227
|
readonly "config.tool_face_undeclared": "operator";
|
|
227
228
|
readonly "config.tool_face_invalid": "operator";
|
|
@@ -262,12 +263,16 @@ declare const NOTICE_AUDIENCE_TABLE: {
|
|
|
262
263
|
readonly "model.capability_downgraded": "user";
|
|
263
264
|
readonly "model.role_defaulted": "operator";
|
|
264
265
|
readonly "context.tool_turn_repaired": "operator";
|
|
265
|
-
readonly "context.
|
|
266
|
+
readonly "context.media_removed": "user";
|
|
267
|
+
readonly "context.tool_schema_removed": "user";
|
|
266
268
|
readonly "skills.listing_truncated": "operator";
|
|
267
269
|
readonly "agents.listing_truncated": "operator";
|
|
268
270
|
readonly "tool_result.offload_put_failed": "operator";
|
|
269
271
|
readonly "tool_result.media_refused": "operator";
|
|
270
272
|
readonly "config.image_processor_unavailable": "operator";
|
|
273
|
+
readonly "fs.staging_file_left": "operator";
|
|
274
|
+
readonly "fs.staging_file_swept": "operator";
|
|
275
|
+
readonly "session.lineage_rerooted": "user";
|
|
271
276
|
readonly "config.forward_sink_failed": "operator";
|
|
272
277
|
readonly "instructions.source_changed": "user";
|
|
273
278
|
readonly "session.records_skipped": "user";
|
|
@@ -318,6 +323,7 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
318
323
|
readonly "config.path_view_unresolved": "engine";
|
|
319
324
|
readonly "config.execution_env_capability_invalid": "engine";
|
|
320
325
|
readonly "config.read_deny_floor_unkept": "engine";
|
|
326
|
+
readonly "config.read_floor_confinement_unavailable": "engine";
|
|
321
327
|
readonly "config.tool_card_undeclared": "engine";
|
|
322
328
|
readonly "config.tool_face_undeclared": "engine";
|
|
323
329
|
readonly "config.tool_face_invalid": "engine";
|
|
@@ -386,7 +392,8 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
386
392
|
readonly "model.capability_downgraded": "engine";
|
|
387
393
|
readonly "model.role_defaulted": "engine";
|
|
388
394
|
readonly "context.tool_turn_repaired": "engine";
|
|
389
|
-
readonly "context.
|
|
395
|
+
readonly "context.media_removed": "engine";
|
|
396
|
+
readonly "context.tool_schema_removed": "engine";
|
|
390
397
|
readonly "task.user_steer_undrained": "engine";
|
|
391
398
|
readonly "task.user_followup_undrained": "engine";
|
|
392
399
|
readonly "steering.parked_input_blocked": "engine";
|
|
@@ -404,6 +411,9 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
404
411
|
readonly "tool_result.offload_put_failed": "engine";
|
|
405
412
|
readonly "tool_result.media_refused": "engine";
|
|
406
413
|
readonly "config.image_processor_unavailable": "engine";
|
|
414
|
+
readonly "fs.staging_file_left": "engine";
|
|
415
|
+
readonly "fs.staging_file_swept": "engine";
|
|
416
|
+
readonly "session.lineage_rerooted": "engine";
|
|
407
417
|
readonly "instructions.source_changed": "server";
|
|
408
418
|
readonly "session.records_skipped": "server";
|
|
409
419
|
readonly "memory.layer_locked_legacy": "server";
|
|
@@ -143,6 +143,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
|
|
|
143
143
|
"config.path_view_unresolved",
|
|
144
144
|
"config.execution_env_capability_invalid",
|
|
145
145
|
"config.read_deny_floor_unkept",
|
|
146
|
+
"config.read_floor_confinement_unavailable",
|
|
146
147
|
"config.tool_card_undeclared",
|
|
147
148
|
"config.tool_face_undeclared",
|
|
148
149
|
"config.tool_face_invalid",
|
|
@@ -211,7 +212,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
|
|
|
211
212
|
"model.capability_downgraded",
|
|
212
213
|
"model.role_defaulted",
|
|
213
214
|
"context.tool_turn_repaired",
|
|
214
|
-
"context.
|
|
215
|
+
"context.media_removed",
|
|
216
|
+
"context.tool_schema_removed",
|
|
215
217
|
"task.user_steer_undrained",
|
|
216
218
|
"task.user_followup_undrained",
|
|
217
219
|
"steering.parked_input_blocked",
|
|
@@ -229,6 +231,9 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
|
|
|
229
231
|
"tool_result.offload_put_failed",
|
|
230
232
|
"tool_result.media_refused",
|
|
231
233
|
"config.image_processor_unavailable",
|
|
234
|
+
"fs.staging_file_left",
|
|
235
|
+
"fs.staging_file_swept",
|
|
236
|
+
"session.lineage_rerooted",
|
|
232
237
|
"instructions.source_changed",
|
|
233
238
|
"session.records_skipped",
|
|
234
239
|
"memory.layer_locked_legacy",
|
|
@@ -247,7 +252,7 @@ const NOTICE_AUDIENCE_TABLE = {
|
|
|
247
252
|
"classifier.denial_limit": "user",
|
|
248
253
|
"classifier.unavailable": "user",
|
|
249
254
|
"classifier.fallback": "operator",
|
|
250
|
-
"classifier.seat_rate_limited": "
|
|
255
|
+
"classifier.seat_rate_limited": "user",
|
|
251
256
|
"classifier.role_defaulted": "operator",
|
|
252
257
|
"classifier.contract_broken": "operator",
|
|
253
258
|
"task.turn_interrupted": "user",
|
|
@@ -294,6 +299,7 @@ const NOTICE_AUDIENCE_TABLE = {
|
|
|
294
299
|
"config.path_view_unresolved": "operator",
|
|
295
300
|
"config.execution_env_capability_invalid": "operator",
|
|
296
301
|
"config.read_deny_floor_unkept": "operator",
|
|
302
|
+
"config.read_floor_confinement_unavailable": "operator",
|
|
297
303
|
"config.tool_card_undeclared": "operator",
|
|
298
304
|
"config.tool_face_undeclared": "operator",
|
|
299
305
|
"config.tool_face_invalid": "operator",
|
|
@@ -334,12 +340,16 @@ const NOTICE_AUDIENCE_TABLE = {
|
|
|
334
340
|
"model.capability_downgraded": "user",
|
|
335
341
|
"model.role_defaulted": "operator",
|
|
336
342
|
"context.tool_turn_repaired": "operator",
|
|
337
|
-
"context.
|
|
343
|
+
"context.media_removed": "user",
|
|
344
|
+
"context.tool_schema_removed": "user",
|
|
338
345
|
"skills.listing_truncated": "operator",
|
|
339
346
|
"agents.listing_truncated": "operator",
|
|
340
347
|
"tool_result.offload_put_failed": "operator",
|
|
341
348
|
"tool_result.media_refused": "operator",
|
|
342
349
|
"config.image_processor_unavailable": "operator",
|
|
350
|
+
"fs.staging_file_left": "operator",
|
|
351
|
+
"fs.staging_file_swept": "operator",
|
|
352
|
+
"session.lineage_rerooted": "user",
|
|
343
353
|
"config.forward_sink_failed": "operator",
|
|
344
354
|
"instructions.source_changed": "user",
|
|
345
355
|
"session.records_skipped": "user",
|
|
@@ -371,6 +381,7 @@ const NOTICE_MINTER_TABLE = {
|
|
|
371
381
|
"config.path_view_unresolved": "engine",
|
|
372
382
|
"config.execution_env_capability_invalid": "engine",
|
|
373
383
|
"config.read_deny_floor_unkept": "engine",
|
|
384
|
+
"config.read_floor_confinement_unavailable": "engine",
|
|
374
385
|
"config.tool_card_undeclared": "engine",
|
|
375
386
|
"config.tool_face_undeclared": "engine",
|
|
376
387
|
"config.tool_face_invalid": "engine",
|
|
@@ -439,7 +450,8 @@ const NOTICE_MINTER_TABLE = {
|
|
|
439
450
|
"model.capability_downgraded": "engine",
|
|
440
451
|
"model.role_defaulted": "engine",
|
|
441
452
|
"context.tool_turn_repaired": "engine",
|
|
442
|
-
"context.
|
|
453
|
+
"context.media_removed": "engine",
|
|
454
|
+
"context.tool_schema_removed": "engine",
|
|
443
455
|
"task.user_steer_undrained": "engine",
|
|
444
456
|
"task.user_followup_undrained": "engine",
|
|
445
457
|
"steering.parked_input_blocked": "engine",
|
|
@@ -457,6 +469,9 @@ const NOTICE_MINTER_TABLE = {
|
|
|
457
469
|
"tool_result.offload_put_failed": "engine",
|
|
458
470
|
"tool_result.media_refused": "engine",
|
|
459
471
|
"config.image_processor_unavailable": "engine",
|
|
472
|
+
"fs.staging_file_left": "engine",
|
|
473
|
+
"fs.staging_file_swept": "engine",
|
|
474
|
+
"session.lineage_rerooted": "engine",
|
|
460
475
|
"instructions.source_changed": "server",
|
|
461
476
|
"session.records_skipped": "server",
|
|
462
477
|
"memory.layer_locked_legacy": "server",
|
package/dist/core/hooks.d.ts
CHANGED
|
@@ -205,6 +205,19 @@ export interface StopFailureEvent extends ClassicEventBase {
|
|
|
205
205
|
/** Turns completed when the failure ended the run. */
|
|
206
206
|
readonly turns: number;
|
|
207
207
|
}
|
|
208
|
+
/** `classic.SessionStart`'s `e` — raised once per leg, in the bottom of `session.start` (the leg is prepared, its first model
|
|
209
|
+
* request not yet made). Observe-only. */
|
|
210
|
+
export interface SessionStartEvent extends ClassicEventBase {
|
|
211
|
+
/** The leg's tracked working directory. */
|
|
212
|
+
readonly cwd: string;
|
|
213
|
+
readonly sessionId: string;
|
|
214
|
+
}
|
|
215
|
+
/** `classic.SessionEnd`'s `e` — raised once per leg, in the bottom of `session.end` (its terminal settled). Observe-only. */
|
|
216
|
+
export interface SessionEndEvent extends ClassicEventBase {
|
|
217
|
+
/** The terminal status word. */
|
|
218
|
+
readonly reason: string;
|
|
219
|
+
readonly sessionId: string;
|
|
220
|
+
}
|
|
208
221
|
/** `classic.PreCompact`'s `e` — before each compaction, after the trigger gate and a valid cut point. Answer:
|
|
209
222
|
* {@link PreCompactResult} (`block` honored on "auto" / "manual" only). */
|
|
210
223
|
export interface PreCompactEvent extends ClassicEventBase {
|
|
@@ -450,8 +463,8 @@ export declare function createHookEnvCapabilities(env: ExecutionEnv): HookEnvCap
|
|
|
450
463
|
export interface HookInvocationIdentity {
|
|
451
464
|
/** The run's session id (uuid domain) — the same key `TaskResult.sessionId` reports. */
|
|
452
465
|
readonly sessionId: string;
|
|
453
|
-
/** The run's unified task id (
|
|
454
|
-
*
|
|
466
|
+
/** The run's unified task id (the leg's one mint; TaskEvent's `sourceTaskId` and `task_progress` key on it): a background
|
|
467
|
+
* sub-agent's registry task id, else the host's declared task id, else {@link sessionId}. */
|
|
455
468
|
readonly taskId: string;
|
|
456
469
|
/** Which prepared leg this invocation belongs to — the wiring manifest's own `leg.kind`
|
|
457
470
|
* derivation, verbatim ({@link WiringLegKind}: `"root" | "child" | "resume"`). NOTE the fork
|
|
@@ -549,6 +562,10 @@ export interface HookToolOutput {
|
|
|
549
562
|
*/
|
|
550
563
|
export type PreToolUseResult = PermissionResult & {
|
|
551
564
|
additionalContext?: string;
|
|
565
|
+
/** WHY the hook asks, on an `ask` only ({@link import("./ask-origin.js").HookQuestionCause}; absent reads `asked`): on the two
|
|
566
|
+
* `verdict_*` words the `message` is the host's account, which no entry carries. Outside the set, or on another arm, the
|
|
567
|
+
* decision receipt refuses it (an engine fail-closed deny). */
|
|
568
|
+
questionCause?: import("./ask-origin.js").HookQuestionCause;
|
|
552
569
|
};
|
|
553
570
|
/** A PostToolUse hook result: replace the tool output and/or append context (both optional). */
|
|
554
571
|
export interface PostToolUseResult {
|
|
@@ -1384,11 +1401,14 @@ export interface AskCarry {
|
|
|
1384
1401
|
readonly mandate?: import("./ask-origin.js").PersistedRuleMandate;
|
|
1385
1402
|
/** The deployment's authorship ({@link import("./tool-policy.js").AskRequest.authoredBy}), for the row's twin. */
|
|
1386
1403
|
readonly authoredBy?: "deployment";
|
|
1404
|
+
/** The surviving ask's askers' entries ({@link import("./tool-policy.js").AskRequest.askReasons}), for the row's twin — the
|
|
1405
|
+
* same value the synchronous card carries. */
|
|
1406
|
+
readonly askReasons?: readonly import("./ask-origin.js").AskReason[];
|
|
1387
1407
|
}
|
|
1388
1408
|
/** What a durable row persists of an {@link AskCarry}: the fallback member COPIED (the row never aliases
|
|
1389
1409
|
* the gate's object; its window is already `0` — the gate's carry mint is the one writer of that
|
|
1390
|
-
* number), the origin word only when it is a member of the closed set,
|
|
1391
|
-
* well-formed, as
|
|
1410
|
+
* number), the origin word only when it is a member of the closed set, the class pair and the askers' entries only when
|
|
1411
|
+
* well-formed, as fresh copies (the carry is typed, but the row is the boundary a host reads back through —
|
|
1392
1412
|
* the same screen the summary applies to the word). */
|
|
1393
1413
|
export declare function askCarryRowMembers(carry: AskCarry | undefined): {
|
|
1394
1414
|
denialLimitFallback?: import("./auto-mode.js").DenialLimitFallback;
|
|
@@ -1396,6 +1416,7 @@ export declare function askCarryRowMembers(carry: AskCarry | undefined): {
|
|
|
1396
1416
|
origin?: import("./ask-origin.js").AskOrigin;
|
|
1397
1417
|
askClass?: import("./ask-origin.js").AskClass;
|
|
1398
1418
|
classes?: readonly import("./ask-origin.js").AskClass[];
|
|
1419
|
+
askReasons?: readonly import("./ask-origin.js").AskReason[];
|
|
1399
1420
|
};
|
|
1400
1421
|
/**
|
|
1401
1422
|
* The design/37 **two-phase tool gate** — the single chokepoint that makes the load-bearing invariant
|
package/dist/core/hooks.js
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
import { argsAsTheToolReads, stampArgsReading } from "./effective-path-target.js";
|
|
2
2
|
import { extensionAuthors, noteRewrite, readRejudge, rewriteChasedSentence, screeningAuthorship } from "./rewrite-rejudge.js";
|
|
3
|
-
import { decisionText, describeThrown, foldHookAsk, isEngineRefusal, ownArgs, ownedReading, refuseOutOfContractDecision } from "./tool-policy.js";
|
|
3
|
+
import { decisionText, describeThrown, extensionQuestionText, foldHookAsk, isEngineRefusal, ownArgs, ownedReading, refuseOutOfContractDecision } from "./tool-policy.js";
|
|
4
4
|
import { createSettlementLedger, engineFailClosedExit, hookDenyExit, settledScreen, settledScreenExit, takeInheritedScreen, unownedArgsExit } from "./runner/gate-exit.js";
|
|
5
5
|
import { composeCallSignal } from "./runner/abort-race.js";
|
|
6
6
|
import { classicEventBase, dispatchClassic, ENGINE_CORE_ANSWER, failedHandlerClause, judgedInputOf, observePermissionDenied } from "./mods/stations.js";
|
|
7
7
|
import { runGateFold } from "./gate-fold.js";
|
|
8
8
|
import { runGateLanes } from "./gate-lanes.js";
|
|
9
9
|
export { normalizeOrgGateVerdict, normalizePersistedRuleHit } from "./rule-lane-reads.js";
|
|
10
|
-
import { isAskOrigin, screenAskClassMembers } from "./ask-origin.js";
|
|
10
|
+
import { hookAskReasonOf, isAskOrigin, receiveAskReasons, screenAskClassMembers } from "./ask-origin.js";
|
|
11
11
|
import { isAutoModeFallbackCause } from "./auto-mode.js";
|
|
12
12
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
13
13
|
export { formatHookFeedback } from "./reminder-mint.js";
|
|
@@ -111,6 +111,11 @@ function preToolUseRefusedReason(subject, failed) {
|
|
|
111
111
|
: "";
|
|
112
112
|
return `a PreToolUse hook ${failedHandlerClause(failed)} while screening ${subject}; the call was NOT executed (fail-closed).${tail}`;
|
|
113
113
|
}
|
|
114
|
+
function hookAskOf(r, answeredBy, toolName) {
|
|
115
|
+
const { questionCause, ...ask } = r;
|
|
116
|
+
const entry = hookAskReasonOf(answeredBy, questionCause ?? "asked", decisionText(ask));
|
|
117
|
+
return { ...ask, ...(answeredBy !== undefined ? { message: extensionQuestionText(toolName, entry) } : {}), askReasons: Object.freeze([entry]) };
|
|
118
|
+
}
|
|
114
119
|
export function createPreToolUseScreening(input, readSettled = (decision) => ({ decision })) {
|
|
115
120
|
const own = input.modBus !== undefined && input.modBus.hasHandlers("classic.PreToolUse") ? input.modBus : undefined;
|
|
116
121
|
const inherited = (input.inheritedInstallations ?? []).filter((i) => i.bus.hasHandlers("classic.PreToolUse", i.judges));
|
|
@@ -143,7 +148,7 @@ export function createPreToolUseScreening(input, readSettled = (decision) => ({
|
|
|
143
148
|
if (outcome.kind === "failed")
|
|
144
149
|
return { kind: "refused", reason: preToolUseRefusedReason(subject, outcome), extension: outcome.registration };
|
|
145
150
|
const r = screenPreToolUseResult(outcome.answer);
|
|
146
|
-
const answer = r === null || r === false ? undefined : r;
|
|
151
|
+
const answer = r === null || r === false || r === undefined ? undefined : r.action === "ask" ? hookAskOf(r, outcome.answeredBy, toolName) : r;
|
|
147
152
|
const rewrittenBy = authorship.of(outcome.answer);
|
|
148
153
|
return { kind: "answered", answer, ...(outcome.answeredBy !== undefined ? { answeredBy: outcome.answeredBy } : {}), rewrittenBy: answer?.updatedInput === undefined ? [] : rewrittenBy.length > 0 || outcome.answeredBy === undefined ? rewrittenBy : [outcome.answeredBy] };
|
|
149
154
|
};
|
|
@@ -214,7 +219,7 @@ export function createPreToolUseScreening(input, readSettled = (decision) => ({
|
|
|
214
219
|
allowedBy.set(i, r.answeredBy);
|
|
215
220
|
if (verdict?.action !== "ask")
|
|
216
221
|
return undefined;
|
|
217
|
-
const ask = { action: "ask", message: decisionText(verdict) ?? `approval required for "${toolName}" (an inherited PreToolUse hook)`, decisionReason: "hook", ...(verdict.requiresRealApproval === true ? { requiresRealApproval: true } : {}) };
|
|
222
|
+
const ask = { action: "ask", message: decisionText(verdict) ?? `approval required for "${toolName}" (an inherited PreToolUse hook)`, decisionReason: "hook", ...(verdict.requiresRealApproval === true ? { requiresRealApproval: true } : {}), ...(verdict.askReasons !== undefined ? { askReasons: verdict.askReasons } : {}) };
|
|
218
223
|
const call = Object.freeze({ toolName, toolCallId, args: bytes, ...(as.face !== undefined ? { face: as.face } : {}) });
|
|
219
224
|
const settled = readSettled(await seat.installation.settle(ask, call, signal));
|
|
220
225
|
if (settled.decision.action === "deny")
|
|
@@ -241,11 +246,13 @@ export function askCarryRowMembers(carry) {
|
|
|
241
246
|
const origin = carry.origin;
|
|
242
247
|
const why = carry.classifierNoRuling;
|
|
243
248
|
const classed = screenAskClassMembers(carry.askClass, carry.classes);
|
|
249
|
+
const askReasons = receiveAskReasons(carry.askReasons);
|
|
244
250
|
return {
|
|
245
251
|
...(carry.denialLimitFallback !== undefined ? { denialLimitFallback: { ...carry.denialLimitFallback } } : {}),
|
|
246
252
|
...(isAutoModeFallbackCause(why) ? { classifierNoRuling: why } : {}),
|
|
247
253
|
...(isAskOrigin(origin) ? { origin } : {}),
|
|
248
254
|
...(classed !== undefined ? classed : {}),
|
|
255
|
+
...(askReasons !== undefined ? { askReasons } : {}),
|
|
249
256
|
};
|
|
250
257
|
}
|
|
251
258
|
export async function runToolGate(input) {
|
package/dist/core/host-floor.js
CHANGED
|
@@ -2,7 +2,7 @@ import { isIP } from "node:net";
|
|
|
2
2
|
import { HOST_UNREADABLE_SENTENCE, callHostTargetOf, hostOfUrl, hostPatternAdmits, readHostPattern, spelledHostPattern } from "./host-target.js";
|
|
3
3
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
4
4
|
import { describeFault, isPlainRecord, receive } from "./mods/kernel/receive.js";
|
|
5
|
-
import { DECLARATION_RECEIPT_MODE } from "./own-property-receipt.js";
|
|
5
|
+
import { DECLARATION_RECEIPT_MODE, optionKeys, refuseStrayMembers } from "./own-property-receipt.js";
|
|
6
6
|
function isPrivateV4(ip) {
|
|
7
7
|
const o = ip.split(".").map(Number);
|
|
8
8
|
if (o.length !== 4 || o.some((n) => !Number.isInteger(n) || n < 0 || n > 255))
|
|
@@ -48,7 +48,7 @@ export function isPrivateHost(host) {
|
|
|
48
48
|
return /^fe[89ab]/.test(h) || /^f[cd]/.test(h) || /^fe[c-f]/.test(h);
|
|
49
49
|
}
|
|
50
50
|
export const HOST_FLOOR_INVALID_CODE = "config.host_floor_invalid";
|
|
51
|
-
const
|
|
51
|
+
const FLOOR_KEYS = optionKeys()({ deny: 0, only: 0 });
|
|
52
52
|
function floorInvalid(what) {
|
|
53
53
|
return Object.assign(new Error(`RunnerDeps.hostFloor ${what} — a host floor that does not read is refused whole, never half-armed (an entry is a host pattern: \`example.com\` or \`*.example.com\`).`), { code: HOST_FLOOR_INVALID_CODE });
|
|
54
54
|
}
|
|
@@ -95,9 +95,7 @@ export function compileHostFloor(declared) {
|
|
|
95
95
|
return undefined;
|
|
96
96
|
if (!isPlainRecord(value))
|
|
97
97
|
throw floorInvalid(`must be a record { deny?, only? } (got ${value === null ? "null" : Array.isArray(value) ? "a list" : typeof value})`);
|
|
98
|
-
|
|
99
|
-
if (unknownMember !== undefined)
|
|
100
|
-
throw floorInvalid(`has a member "${inlineUntrusted(unknownMember, 60)}" — its members are \`deny\` and \`only\``);
|
|
98
|
+
refuseStrayMembers(value, { subject: "RunnerDeps.hostFloor", unit: "member", moment: "when the floor is compiled" }, FLOOR_KEYS, (_, [stray]) => floorInvalid(`has a member "${inlineUntrusted(String(stray), 60)}" — its members are \`deny\` and \`only\``));
|
|
101
99
|
const deny = readEntries(value.deny, "deny") ?? [];
|
|
102
100
|
const only = readEntries(value.only, "only");
|
|
103
101
|
for (const o of only ?? []) {
|
|
@@ -33,6 +33,7 @@ const HANDLED_HUMAN_INPUT_KEYS = {
|
|
|
33
33
|
entryId: "forwarded",
|
|
34
34
|
attachments: "forwarded",
|
|
35
35
|
runOrigin: "forwarded",
|
|
36
|
+
rewrittenBy: "forwarded",
|
|
36
37
|
};
|
|
37
38
|
export function buildHumanInputEvent(input) {
|
|
38
39
|
void HANDLED_HUMAN_INPUT_KEYS;
|
|
@@ -49,6 +50,7 @@ export function buildHumanInputEvent(input) {
|
|
|
49
50
|
...(input.entryId !== undefined ? { entryId: input.entryId } : {}),
|
|
50
51
|
...(input.attachments !== undefined && input.attachments.length > 0 ? { attachments: input.attachments.map((a) => ({ ...a })) } : {}),
|
|
51
52
|
...(input.runOrigin !== undefined ? { runOrigin: input.runOrigin } : {}),
|
|
53
|
+
...(input.rewrittenBy !== undefined ? { rewrittenBy: Object.freeze([...input.rewrittenBy]) } : {}),
|
|
52
54
|
};
|
|
53
55
|
}
|
|
54
56
|
export function buildAppliedHumanInputEvent(input) {
|
|
@@ -62,5 +64,6 @@ export function buildAppliedHumanInputEvent(input) {
|
|
|
62
64
|
...(input.actor?.issuer !== undefined ? { issuer: input.actor.issuer } : {}),
|
|
63
65
|
...(input.principal !== undefined ? { principal: input.principal } : {}),
|
|
64
66
|
...(input.runOrigin !== undefined ? { runOrigin: input.runOrigin } : {}),
|
|
67
|
+
...(input.rewrittenBy !== undefined ? { rewrittenBy: input.rewrittenBy } : {}),
|
|
65
68
|
});
|
|
66
69
|
}
|