@sema-agent/core 7.59.0 → 7.61.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 +1169 -0
- package/README.md +2 -2
- package/dist/agents/agent-definition.d.ts +7 -0
- package/dist/agents/agent-definition.js +12 -0
- package/dist/agents/agent-transcript-tool.d.ts +4 -3
- package/dist/agents/agent-transcript-tool.js +4 -2
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/child-model-seat.js +6 -3
- 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 -1
- package/dist/agents/inherited-tool-pool.d.ts +28 -1
- package/dist/agents/inherited-tool-pool.js +22 -0
- package/dist/agents/list-agents-tool.d.ts +1 -1
- 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 +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.d.ts +11 -1
- package/dist/agents/retain-ledger.js +16 -3
- package/dist/agents/roster-store.d.ts +2 -2
- package/dist/agents/roster-store.js +8 -3
- package/dist/agents/send-message-tool.d.ts +14 -27
- package/dist/agents/send-message-tool.js +47 -54
- 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 +52 -28
- package/dist/agents/subagent.js +276 -246
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/tool-filter.d.ts +1 -3
- package/dist/agents/tool-filter.js +4 -12
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/bench/metrics.d.ts +3 -5
- package/dist/bench/metrics.js +0 -1
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/degrading.js +3 -1
- 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/route-adjudicator.js +3 -1
- package/dist/brain/status-sink.d.ts +7 -1
- package/dist/brain/status-sink.js +6 -0
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/brain/timeout.d.ts +3 -1
- package/dist/brain/timeout.js +18 -5
- package/dist/core/a2a.d.ts +15 -5
- package/dist/core/a2a.js +34 -19
- package/dist/core/agent-definition.d.ts +20 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +61 -23
- package/dist/core/allow-entry.js +134 -39
- package/dist/core/artifact-host.d.ts +0 -2
- package/dist/core/artifact-host.js +0 -1
- 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-defaults.d.ts +8 -0
- package/dist/core/auto-mode-defaults.js +1 -0
- package/dist/core/auto-mode-rebuild.d.ts +2 -1
- package/dist/core/auto-mode.d.ts +39 -4
- package/dist/core/auto-mode.js +66 -17
- package/dist/core/background-agent-store.d.ts +17 -6
- package/dist/core/background-agent-store.js +15 -13
- package/dist/core/background-shell.d.ts +12 -1
- package/dist/core/background-shell.js +12 -0
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +86 -32
- package/dist/core/checkpoint-store.js +10 -5
- 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/compliance.d.ts +1 -1
- package/dist/core/context-settings.js +3 -5
- package/dist/core/credential-echo.d.ts +52 -0
- package/dist/core/credential-echo.js +65 -0
- package/dist/core/credential-vocabulary.d.ts +13 -3
- package/dist/core/credential-vocabulary.js +12 -4
- package/dist/core/cross-boundary-taint.d.ts +5 -6
- 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 +106 -32
- 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 +15 -0
- package/dist/core/frame-settlement.js +10 -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 +9 -6
- package/dist/core/gate-lanes.js +46 -12
- 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 +19 -3
- package/dist/core/governance-codes.js +27 -3
- package/dist/core/hands-band-screen.js +0 -1
- package/dist/core/hands-band.d.ts +0 -3
- package/dist/core/hooks.d.ts +51 -60
- package/dist/core/hooks.js +131 -78
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +145 -52
- package/dist/core/image-admission.js +202 -47
- package/dist/core/image-downsample.d.ts +36 -69
- package/dist/core/image-downsample.js +111 -73
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/integer-option.d.ts +21 -0
- package/dist/core/integer-option.js +13 -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 +55 -3
- package/dist/core/locked-config.js +84 -51
- 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-call-meta.d.ts +2 -2
- package/dist/core/mcp-call-meta.js +9 -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 +83 -16
- package/dist/core/mcp-failure.js +67 -30
- package/dist/core/mcp-host-seat.d.ts +131 -0
- package/dist/core/mcp-host-seat.js +305 -0
- package/dist/core/mcp-probe.d.ts +7 -2
- package/dist/core/mcp-probe.js +9 -4
- 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 +39 -9
- package/dist/core/mcp-server-spec.js +55 -21
- 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 +23 -55
- package/dist/core/mcp.js +172 -156
- 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-admission.d.ts +23 -6
- package/dist/core/memory-admission.js +19 -9
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/content-origin.d.ts +13 -0
- package/dist/core/memory-engine/content-origin.js +21 -3
- 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/index.d.ts +2 -1
- package/dist/core/memory-engine/index.js +2 -1
- 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/scope-contract.d.ts +13 -3
- package/dist/core/memory-engine/scope-contract.js +2 -2
- package/dist/core/memory-engine/sync-client.d.ts +68 -13
- package/dist/core/memory-engine/sync-client.js +147 -18
- package/dist/core/memory-engine/sync-report.d.ts +106 -0
- package/dist/core/memory-engine/sync-report.js +119 -0
- package/dist/core/memory-engine/sync.d.ts +13 -3
- package/dist/core/mode-policy.d.ts +15 -7
- package/dist/core/mode-policy.js +18 -6
- package/dist/core/model-receipt.d.ts +39 -0
- package/dist/core/model-receipt.js +139 -0
- package/dist/core/mods/agent-stations.d.ts +100 -0
- package/dist/core/mods/agent-stations.js +154 -0
- package/dist/core/mods/dollar.d.ts +62 -0
- 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 +9 -4
- package/dist/core/mods/kernel/dispatch.js +8 -8
- package/dist/core/mods/kernel/events.d.ts +13 -4
- package/dist/core/mods/kernel/events.js +14 -10
- package/dist/core/mods/kernel/receive.d.ts +5 -0
- package/dist/core/mods/kernel/receive.js +10 -0
- 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 +41 -0
- package/dist/core/mods/lifecycle-stations.js +35 -0
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -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 +141 -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 +89 -75
- package/dist/core/mods/stations.js +57 -53
- package/dist/core/mods/tool-call.d.ts +12 -4
- package/dist/core/mods/tool-call.js +32 -16
- package/dist/core/mounted-mcp.d.ts +5 -0
- package/dist/core/mounted-mcp.js +2 -2
- package/dist/core/namespaced-rule-name.d.ts +7 -1
- package/dist/core/namespaced-rule-name.js +13 -2
- package/dist/core/oracle-isolation.js +1 -1
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +62 -0
- package/dist/core/own-property-receipt.js +43 -0
- package/dist/core/park-selfcheck.js +12 -10
- 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 +66 -11
- package/dist/core/peer-seat.js +199 -42
- package/dist/core/permission-rule-consent.d.ts +21 -26
- package/dist/core/permission-rule-consent.js +22 -3
- package/dist/core/permission-rule-model.d.ts +38 -13
- package/dist/core/permission-rule-model.js +54 -16
- 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/protocol-http-auth.d.ts +14 -2
- package/dist/core/protocol-http-auth.js +16 -7
- package/dist/core/read-face-seats.d.ts +7 -5
- package/dist/core/read-face-seats.js +4 -1
- package/dist/core/redaction-marks.d.ts +4 -3
- package/dist/core/redaction-marks.js +2 -2
- package/dist/core/remote-env.d.ts +218 -122
- package/dist/core/remote-env.js +133 -14
- 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/retention.js +37 -12
- package/dist/core/retired-keys.d.ts +8 -3
- package/dist/core/retired-keys.js +4 -1
- package/dist/core/rewrite-rejudge.d.ts +12 -5
- package/dist/core/rewrite-rejudge.js +9 -5
- package/dist/core/roles.d.ts +37 -3
- package/dist/core/roles.js +126 -78
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/rule-owner.d.ts +3 -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 -8
- package/dist/core/runner/assemble-result.js +12 -8
- package/dist/core/runner/call-hook-stations.d.ts +17 -10
- package/dist/core/runner/call-hook-stations.js +21 -10
- 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/child-tree.d.ts +7 -8
- package/dist/core/runner/child-tree.js +6 -6
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +39 -8
- package/dist/core/runner/compact-session.js +14 -2
- 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 +7 -2
- package/dist/core/runner/contracts.d.ts +158 -65
- package/dist/core/runner/cross-boundary-lane.d.ts +4 -6
- package/dist/core/runner/cross-boundary-lane.js +11 -2
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- 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/env-capability-census.d.ts +15 -20
- package/dist/core/runner/env-capability-census.js +25 -34
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/file-history-request.d.ts +2 -2
- package/dist/core/runner/file-history-request.js +0 -8
- package/dist/core/runner/gate-exit.d.ts +75 -7
- package/dist/core/runner/gate-exit.js +20 -1
- package/dist/core/runner/git-status-frame.d.ts +5 -2
- package/dist/core/runner/git-status-frame.js +4 -4
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/image.d.ts +7 -2
- package/dist/core/runner/image.js +14 -8
- package/dist/core/runner/inline-image.d.ts +10 -8
- package/dist/core/runner/inline-image.js +11 -9
- 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/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +29 -10
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- 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 +6 -3
- package/dist/core/runner/prepare-boundary-parks.js +4 -4
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +6 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +5 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -1
- package/dist/core/runner/prepare-config-doors.js +30 -26
- 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 +13 -11
- package/dist/core/runner/prepare-delegation-surface.js +7 -8
- 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-file-history.d.ts +10 -12
- package/dist/core/runner/prepare-file-history.js +3 -12
- package/dist/core/runner/prepare-gate-stations.d.ts +23 -17
- package/dist/core/runner/prepare-gate-stations.js +10 -7
- package/dist/core/runner/prepare-hands-readface.d.ts +8 -6
- package/dist/core/runner/prepare-hands-readface.js +19 -11
- package/dist/core/runner/prepare-inherited-gate.d.ts +11 -4
- package/dist/core/runner/prepare-inherited-gate.js +12 -5
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +2 -2
- package/dist/core/runner/prepare-memory.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +8 -7
- package/dist/core/runner/prepare-park-ask.js +6 -12
- package/dist/core/runner/prepare-policy-chain.d.ts +15 -25
- package/dist/core/runner/prepare-policy-chain.js +131 -128
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-project-context.js +8 -5
- package/dist/core/runner/prepare-prompt-inputs.d.ts +4 -0
- package/dist/core/runner/prepare-prompt-inputs.js +4 -2
- package/dist/core/runner/prepare-protocol-tools.d.ts +5 -3
- package/dist/core/runner/prepare-protocol-tools.js +9 -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 -9
- package/dist/core/runner/prepare-suspend-saga.js +21 -13
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +84 -42
- 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-turn-wiring.d.ts +2 -0
- package/dist/core/runner/prepare-turn-wiring.js +7 -2
- package/dist/core/runner/prepare-wiring-manifest.d.ts +7 -3
- package/dist/core/runner/prepare-wiring-manifest.js +34 -19
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +12 -8
- 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 +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-checkpoint-screen.js +4 -4
- 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 +6 -1
- package/dist/core/runner/run-attachment-seats.js +3 -3
- package/dist/core/runner/run-brain-sinks.js +1 -0
- package/dist/core/runner/run-git-lane.d.ts +3 -1
- package/dist/core/runner/run-git-lane.js +3 -2
- package/dist/core/runner/run-harness-handlers.d.ts +3 -1
- package/dist/core/runner/run-harness-handlers.js +5 -3
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +15 -6
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +65 -56
- package/dist/core/runner/run-notification-lane.d.ts +3 -1
- package/dist/core/runner/run-notification-lane.js +36 -12
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +14 -8
- package/dist/core/runner/run-stop-and-final-verify.d.ts +4 -0
- package/dist/core/runner/run-stop-and-final-verify.js +12 -4
- 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 +37 -19
- package/dist/core/runner/runtask.d.ts +25 -7
- package/dist/core/runner/runtask.js +46 -22
- 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/skills-seat.js +2 -2
- 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 +8 -7
- package/dist/core/runner/sub-agent-deny-lists.js +10 -7
- package/dist/core/runner/synthetic-tools.js +2 -2
- 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 -4
- 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.d.ts +1 -1
- package/dist/core/runner/tool-face-overlay.js +26 -19
- 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-result-media-seat.d.ts +9 -1
- package/dist/core/runner/tool-result-media-seat.js +17 -1
- 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 +6 -7
- package/dist/core/runner/turn-attachments.js +4 -17
- 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 +55 -43
- package/dist/core/secret-env.d.ts +14 -13
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +10 -3
- package/dist/core/session-policy-store.js +21 -3
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +5 -2
- package/dist/core/session-store.js +53 -16
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.d.ts +9 -0
- package/dist/core/skill-grant.js +18 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -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/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +67 -0
- package/dist/core/stub-env.d.ts +5 -5
- package/dist/core/stub-env.js +11 -1
- package/dist/core/swappable-deps.d.ts +17 -43
- package/dist/core/swappable-deps.js +15 -5
- package/dist/core/synthetic-read-verdict.d.ts +1 -1
- package/dist/core/task-event.d.ts +35 -10
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +172 -12
- package/dist/core/task-notification.js +209 -12
- package/dist/core/task-registry-agent.d.ts +23 -55
- package/dist/core/task-registry-agent.js +41 -56
- package/dist/core/task-registry-monitor.d.ts +8 -1
- package/dist/core/task-registry-monitor.js +43 -61
- package/dist/core/task-registry-shared.d.ts +52 -114
- package/dist/core/task-registry-shared.js +24 -48
- package/dist/core/task-registry-workflow.js +5 -22
- package/dist/core/task-registry.d.ts +64 -90
- package/dist/core/task-registry.js +73 -119
- package/dist/core/task-result.d.ts +27 -19
- 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 +13 -16
- package/dist/core/task-stream.d.ts +1 -1
- 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 +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +3 -6
- 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.d.ts +7 -6
- package/dist/core/tool-face-reader.js +6 -4
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +23 -28
- package/dist/core/tool-name-aliases.js +63 -7
- 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 +113 -22
- package/dist/core/tool-policy.js +85 -15
- package/dist/core/tool-registry.d.ts +5 -5
- package/dist/core/tool-registry.js +2 -2
- package/dist/core/tool-result-store.d.ts +111 -5
- package/dist/core/tool-result-store.js +52 -12
- package/dist/core/tool-spec.d.ts +39 -10
- package/dist/core/trace.d.ts +18 -2
- package/dist/core/types.d.ts +3 -3
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-text.js +1 -1
- package/dist/core/user-attachment.d.ts +10 -5
- package/dist/core/user-attachment.js +40 -27
- 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 -7
- package/dist/engine/execution-env/node-execution-env.js +224 -21
- package/dist/engine/harness/agent-harness.d.ts +66 -19
- package/dist/engine/harness/agent-harness.js +98 -27
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +151 -34
- 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 +18 -13
- package/dist/engine/loop/agent-loop.js +173 -32
- package/dist/engine/loop/types.d.ts +21 -5
- package/dist/engine/lsp/node-lsp-manager.d.ts +3 -3
- package/dist/engine/lsp/node-lsp-manager.js +32 -13
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +41 -23
- package/dist/index.js +29 -16
- package/dist/internal/harness-types.d.ts +3 -1
- 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 +20 -20
- package/dist/orchestration/run-workflow-tool.js +63 -56
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-governance.js +2 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +8 -0
- package/dist/orchestration/workflow.js +33 -9
- package/dist/prompts/default.d.ts +1 -10
- package/dist/prompts/default.js +0 -2
- package/dist/stores/file/background-agent-store.d.ts +1 -1
- package/dist/stores/file/background-agent-store.js +19 -14
- package/dist/stores/file/checkpoint-store.d.ts +127 -2
- package/dist/stores/file/checkpoint-store.js +24 -16
- package/dist/stores/file/file-history-store.d.ts +1 -1
- package/dist/stores/file/file-history-store.js +4 -1
- package/dist/stores/file/index.d.ts +9 -6
- package/dist/stores/file/index.js +33 -9
- 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.d.ts +1 -1
- package/dist/stores/file/mailbox-store.js +43 -21
- package/dist/stores/file/memory-store.d.ts +1 -1
- package/dist/stores/file/memory-store.js +4 -1
- 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.d.ts +1 -1
- package/dist/stores/file/session-policy-store.js +4 -1
- package/dist/stores/file/session-store.d.ts +17 -4
- package/dist/stores/file/session-store.js +22 -19
- package/dist/stores/file/shared-ledger.d.ts +26 -0
- package/dist/stores/file/shared-ledger.js +38 -9
- package/dist/stores/file/tool-result-store.d.ts +31 -2
- package/dist/stores/file/tool-result-store.js +129 -7
- package/dist/stores/file/usage-window-store.d.ts +1 -1
- package/dist/stores/file/usage-window-store.js +4 -1
- package/dist/stores/file/workflow-journal-store.d.ts +1 -13
- package/dist/stores/file/workflow-journal-store.js +4 -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/containment-face.d.ts +5 -0
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/encoding.d.ts +13 -4
- package/dist/tools/fs/encoding.js +17 -2
- package/dist/tools/fs/fs-bash-background-text.d.ts +13 -0
- package/dist/tools/fs/fs-bash-background-text.js +7 -0
- package/dist/tools/fs/fs-bash.d.ts +11 -22
- package/dist/tools/fs/fs-bash.js +58 -154
- package/dist/tools/fs/fs-pdf.d.ts +2 -2
- package/dist/tools/fs/fs-pdf.js +34 -27
- package/dist/tools/fs/fs-read.d.ts +5 -4
- package/dist/tools/fs/fs-read.js +35 -18
- package/dist/tools/fs/fs-search-tools.js +4 -1
- package/dist/tools/fs/fs-shared.d.ts +39 -16
- package/dist/tools/fs/fs-shared.js +25 -6
- package/dist/tools/fs/fs-write.js +5 -5
- package/dist/tools/fs/index.d.ts +15 -9
- package/dist/tools/fs/index.js +12 -18
- 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 +57 -6
- package/dist/tools/fs/read-floor.js +241 -2
- package/dist/tools/fs/removal-targets.d.ts +9 -4
- package/dist/tools/fs/removal-targets.js +17 -9
- package/dist/tools/fs/search.d.ts +6 -5
- package/dist/tools/fs/search.js +10 -10
- package/dist/tools/fs/shell-read-establish.js +3 -1
- 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/monitor.d.ts +12 -10
- package/dist/tools/monitor.js +22 -13
- package/dist/tools/scheduler-tools.js +42 -4
- package/dist/tools/web.d.ts +0 -10
- package/dist/tools/web.js +1 -4
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +8 -3
- package/test/export-surface.snapshot.json +166 -30
- package/wire-changes/core-stores-sql@7.60.0.json +30 -0
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.60.0.json +3274 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.60.0.json +62 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.60.0.json +30 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
|
@@ -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.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.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", "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", "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,6 +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": "user";
|
|
178
179
|
readonly "classifier.role_defaulted": "operator";
|
|
179
180
|
readonly "classifier.contract_broken": "operator";
|
|
180
181
|
readonly "task.turn_interrupted": "user";
|
|
@@ -220,6 +221,8 @@ declare const NOTICE_AUDIENCE_TABLE: {
|
|
|
220
221
|
readonly "config.write_protection_target_view_absent": "operator";
|
|
221
222
|
readonly "config.path_view_unresolved": "operator";
|
|
222
223
|
readonly "config.execution_env_capability_invalid": "operator";
|
|
224
|
+
readonly "config.read_deny_floor_unkept": "operator";
|
|
225
|
+
readonly "config.read_floor_confinement_unavailable": "operator";
|
|
223
226
|
readonly "config.tool_card_undeclared": "operator";
|
|
224
227
|
readonly "config.tool_face_undeclared": "operator";
|
|
225
228
|
readonly "config.tool_face_invalid": "operator";
|
|
@@ -238,6 +241,7 @@ declare const NOTICE_AUDIENCE_TABLE: {
|
|
|
238
241
|
readonly "mcp.revocation_probe_failed": "operator";
|
|
239
242
|
readonly "mcp.server_redialed": "operator";
|
|
240
243
|
readonly "mcp.authorization_required": "user";
|
|
244
|
+
readonly "mcp.credential_echoed": "operator";
|
|
241
245
|
readonly "workflow.governance_key_stripped": "operator";
|
|
242
246
|
readonly "workflow.agent_option_ignored": "operator";
|
|
243
247
|
readonly "memory.content_class_declared": "operator";
|
|
@@ -259,11 +263,15 @@ declare const NOTICE_AUDIENCE_TABLE: {
|
|
|
259
263
|
readonly "model.capability_downgraded": "user";
|
|
260
264
|
readonly "model.role_defaulted": "operator";
|
|
261
265
|
readonly "context.tool_turn_repaired": "operator";
|
|
262
|
-
readonly "context.
|
|
266
|
+
readonly "context.media_removed": "user";
|
|
267
|
+
readonly "context.tool_schema_removed": "user";
|
|
263
268
|
readonly "skills.listing_truncated": "operator";
|
|
264
269
|
readonly "agents.listing_truncated": "operator";
|
|
265
270
|
readonly "tool_result.offload_put_failed": "operator";
|
|
266
271
|
readonly "tool_result.media_refused": "operator";
|
|
272
|
+
readonly "config.image_processor_unavailable": "operator";
|
|
273
|
+
readonly "fs.staging_file_left": "operator";
|
|
274
|
+
readonly "fs.staging_file_swept": "operator";
|
|
267
275
|
readonly "config.forward_sink_failed": "operator";
|
|
268
276
|
readonly "instructions.source_changed": "user";
|
|
269
277
|
readonly "session.records_skipped": "user";
|
|
@@ -313,6 +321,8 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
313
321
|
readonly "config.write_protection_target_view_absent": "engine";
|
|
314
322
|
readonly "config.path_view_unresolved": "engine";
|
|
315
323
|
readonly "config.execution_env_capability_invalid": "engine";
|
|
324
|
+
readonly "config.read_deny_floor_unkept": "engine";
|
|
325
|
+
readonly "config.read_floor_confinement_unavailable": "engine";
|
|
316
326
|
readonly "config.tool_card_undeclared": "engine";
|
|
317
327
|
readonly "config.tool_face_undeclared": "engine";
|
|
318
328
|
readonly "config.tool_face_invalid": "engine";
|
|
@@ -338,6 +348,7 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
338
348
|
readonly "peer.idle_subscription": "engine";
|
|
339
349
|
readonly "classifier.denial_limit": "engine";
|
|
340
350
|
readonly "classifier.fallback": "engine";
|
|
351
|
+
readonly "classifier.seat_rate_limited": "engine";
|
|
341
352
|
readonly "classifier.role_defaulted": "engine";
|
|
342
353
|
readonly "classifier.contract_broken": "engine";
|
|
343
354
|
readonly "classifier.unavailable": "engine";
|
|
@@ -348,6 +359,7 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
348
359
|
readonly "mcp.revocation_probe_failed": "engine";
|
|
349
360
|
readonly "mcp.server_redialed": "engine";
|
|
350
361
|
readonly "mcp.authorization_required": "engine";
|
|
362
|
+
readonly "mcp.credential_echoed": "engine";
|
|
351
363
|
readonly "workflow.governance_key_stripped": "engine";
|
|
352
364
|
readonly "workflow.agent_option_ignored": "engine";
|
|
353
365
|
readonly "memory.session_polluted": "engine";
|
|
@@ -379,7 +391,8 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
379
391
|
readonly "model.capability_downgraded": "engine";
|
|
380
392
|
readonly "model.role_defaulted": "engine";
|
|
381
393
|
readonly "context.tool_turn_repaired": "engine";
|
|
382
|
-
readonly "context.
|
|
394
|
+
readonly "context.media_removed": "engine";
|
|
395
|
+
readonly "context.tool_schema_removed": "engine";
|
|
383
396
|
readonly "task.user_steer_undrained": "engine";
|
|
384
397
|
readonly "task.user_followup_undrained": "engine";
|
|
385
398
|
readonly "steering.parked_input_blocked": "engine";
|
|
@@ -396,6 +409,9 @@ declare const NOTICE_MINTER_TABLE: {
|
|
|
396
409
|
readonly "agents.listing_truncated": "engine";
|
|
397
410
|
readonly "tool_result.offload_put_failed": "engine";
|
|
398
411
|
readonly "tool_result.media_refused": "engine";
|
|
412
|
+
readonly "config.image_processor_unavailable": "engine";
|
|
413
|
+
readonly "fs.staging_file_left": "engine";
|
|
414
|
+
readonly "fs.staging_file_swept": "engine";
|
|
399
415
|
readonly "instructions.source_changed": "server";
|
|
400
416
|
readonly "session.records_skipped": "server";
|
|
401
417
|
readonly "memory.layer_locked_legacy": "server";
|
|
@@ -142,6 +142,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
|
|
|
142
142
|
"config.write_protection_target_view_absent",
|
|
143
143
|
"config.path_view_unresolved",
|
|
144
144
|
"config.execution_env_capability_invalid",
|
|
145
|
+
"config.read_deny_floor_unkept",
|
|
146
|
+
"config.read_floor_confinement_unavailable",
|
|
145
147
|
"config.tool_card_undeclared",
|
|
146
148
|
"config.tool_face_undeclared",
|
|
147
149
|
"config.tool_face_invalid",
|
|
@@ -167,6 +169,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
|
|
|
167
169
|
"peer.idle_subscription",
|
|
168
170
|
"classifier.denial_limit",
|
|
169
171
|
"classifier.fallback",
|
|
172
|
+
"classifier.seat_rate_limited",
|
|
170
173
|
"classifier.role_defaulted",
|
|
171
174
|
"classifier.contract_broken",
|
|
172
175
|
"classifier.unavailable",
|
|
@@ -177,6 +180,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
|
|
|
177
180
|
"mcp.revocation_probe_failed",
|
|
178
181
|
"mcp.server_redialed",
|
|
179
182
|
"mcp.authorization_required",
|
|
183
|
+
"mcp.credential_echoed",
|
|
180
184
|
"workflow.governance_key_stripped",
|
|
181
185
|
"workflow.agent_option_ignored",
|
|
182
186
|
"memory.session_polluted",
|
|
@@ -208,7 +212,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
|
|
|
208
212
|
"model.capability_downgraded",
|
|
209
213
|
"model.role_defaulted",
|
|
210
214
|
"context.tool_turn_repaired",
|
|
211
|
-
"context.
|
|
215
|
+
"context.media_removed",
|
|
216
|
+
"context.tool_schema_removed",
|
|
212
217
|
"task.user_steer_undrained",
|
|
213
218
|
"task.user_followup_undrained",
|
|
214
219
|
"steering.parked_input_blocked",
|
|
@@ -225,6 +230,9 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
|
|
|
225
230
|
"agents.listing_truncated",
|
|
226
231
|
"tool_result.offload_put_failed",
|
|
227
232
|
"tool_result.media_refused",
|
|
233
|
+
"config.image_processor_unavailable",
|
|
234
|
+
"fs.staging_file_left",
|
|
235
|
+
"fs.staging_file_swept",
|
|
228
236
|
"instructions.source_changed",
|
|
229
237
|
"session.records_skipped",
|
|
230
238
|
"memory.layer_locked_legacy",
|
|
@@ -243,6 +251,7 @@ const NOTICE_AUDIENCE_TABLE = {
|
|
|
243
251
|
"classifier.denial_limit": "user",
|
|
244
252
|
"classifier.unavailable": "user",
|
|
245
253
|
"classifier.fallback": "operator",
|
|
254
|
+
"classifier.seat_rate_limited": "user",
|
|
246
255
|
"classifier.role_defaulted": "operator",
|
|
247
256
|
"classifier.contract_broken": "operator",
|
|
248
257
|
"task.turn_interrupted": "user",
|
|
@@ -288,6 +297,8 @@ const NOTICE_AUDIENCE_TABLE = {
|
|
|
288
297
|
"config.write_protection_target_view_absent": "operator",
|
|
289
298
|
"config.path_view_unresolved": "operator",
|
|
290
299
|
"config.execution_env_capability_invalid": "operator",
|
|
300
|
+
"config.read_deny_floor_unkept": "operator",
|
|
301
|
+
"config.read_floor_confinement_unavailable": "operator",
|
|
291
302
|
"config.tool_card_undeclared": "operator",
|
|
292
303
|
"config.tool_face_undeclared": "operator",
|
|
293
304
|
"config.tool_face_invalid": "operator",
|
|
@@ -306,6 +317,7 @@ const NOTICE_AUDIENCE_TABLE = {
|
|
|
306
317
|
"mcp.revocation_probe_failed": "operator",
|
|
307
318
|
"mcp.server_redialed": "operator",
|
|
308
319
|
"mcp.authorization_required": "user",
|
|
320
|
+
"mcp.credential_echoed": "operator",
|
|
309
321
|
"workflow.governance_key_stripped": "operator",
|
|
310
322
|
"workflow.agent_option_ignored": "operator",
|
|
311
323
|
"memory.content_class_declared": "operator",
|
|
@@ -327,11 +339,15 @@ const NOTICE_AUDIENCE_TABLE = {
|
|
|
327
339
|
"model.capability_downgraded": "user",
|
|
328
340
|
"model.role_defaulted": "operator",
|
|
329
341
|
"context.tool_turn_repaired": "operator",
|
|
330
|
-
"context.
|
|
342
|
+
"context.media_removed": "user",
|
|
343
|
+
"context.tool_schema_removed": "user",
|
|
331
344
|
"skills.listing_truncated": "operator",
|
|
332
345
|
"agents.listing_truncated": "operator",
|
|
333
346
|
"tool_result.offload_put_failed": "operator",
|
|
334
347
|
"tool_result.media_refused": "operator",
|
|
348
|
+
"config.image_processor_unavailable": "operator",
|
|
349
|
+
"fs.staging_file_left": "operator",
|
|
350
|
+
"fs.staging_file_swept": "operator",
|
|
335
351
|
"config.forward_sink_failed": "operator",
|
|
336
352
|
"instructions.source_changed": "user",
|
|
337
353
|
"session.records_skipped": "user",
|
|
@@ -362,6 +378,8 @@ const NOTICE_MINTER_TABLE = {
|
|
|
362
378
|
"config.write_protection_target_view_absent": "engine",
|
|
363
379
|
"config.path_view_unresolved": "engine",
|
|
364
380
|
"config.execution_env_capability_invalid": "engine",
|
|
381
|
+
"config.read_deny_floor_unkept": "engine",
|
|
382
|
+
"config.read_floor_confinement_unavailable": "engine",
|
|
365
383
|
"config.tool_card_undeclared": "engine",
|
|
366
384
|
"config.tool_face_undeclared": "engine",
|
|
367
385
|
"config.tool_face_invalid": "engine",
|
|
@@ -387,6 +405,7 @@ const NOTICE_MINTER_TABLE = {
|
|
|
387
405
|
"peer.idle_subscription": "engine",
|
|
388
406
|
"classifier.denial_limit": "engine",
|
|
389
407
|
"classifier.fallback": "engine",
|
|
408
|
+
"classifier.seat_rate_limited": "engine",
|
|
390
409
|
"classifier.role_defaulted": "engine",
|
|
391
410
|
"classifier.contract_broken": "engine",
|
|
392
411
|
"classifier.unavailable": "engine",
|
|
@@ -397,6 +416,7 @@ const NOTICE_MINTER_TABLE = {
|
|
|
397
416
|
"mcp.revocation_probe_failed": "engine",
|
|
398
417
|
"mcp.server_redialed": "engine",
|
|
399
418
|
"mcp.authorization_required": "engine",
|
|
419
|
+
"mcp.credential_echoed": "engine",
|
|
400
420
|
"workflow.governance_key_stripped": "engine",
|
|
401
421
|
"workflow.agent_option_ignored": "engine",
|
|
402
422
|
"memory.session_polluted": "engine",
|
|
@@ -428,7 +448,8 @@ const NOTICE_MINTER_TABLE = {
|
|
|
428
448
|
"model.capability_downgraded": "engine",
|
|
429
449
|
"model.role_defaulted": "engine",
|
|
430
450
|
"context.tool_turn_repaired": "engine",
|
|
431
|
-
"context.
|
|
451
|
+
"context.media_removed": "engine",
|
|
452
|
+
"context.tool_schema_removed": "engine",
|
|
432
453
|
"task.user_steer_undrained": "engine",
|
|
433
454
|
"task.user_followup_undrained": "engine",
|
|
434
455
|
"steering.parked_input_blocked": "engine",
|
|
@@ -445,6 +466,9 @@ const NOTICE_MINTER_TABLE = {
|
|
|
445
466
|
"agents.listing_truncated": "engine",
|
|
446
467
|
"tool_result.offload_put_failed": "engine",
|
|
447
468
|
"tool_result.media_refused": "engine",
|
|
469
|
+
"config.image_processor_unavailable": "engine",
|
|
470
|
+
"fs.staging_file_left": "engine",
|
|
471
|
+
"fs.staging_file_swept": "engine",
|
|
448
472
|
"instructions.source_changed": "server",
|
|
449
473
|
"session.records_skipped": "server",
|
|
450
474
|
"memory.layer_locked_legacy": "server",
|
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
const HANDS_BAND_MEMBERS = {
|
|
2
2
|
bashReadonlyAllow: { takes: "a list of command-name strings", ok: (v) => Array.isArray(v) && v.every((c) => typeof c === "string") },
|
|
3
3
|
commitCoAuthor: { takes: "a string or false", ok: (v) => typeof v === "string" || v === false },
|
|
4
|
-
readImageDownsampler: { takes: "a function or false", ok: (v) => typeof v === "function" || v === false },
|
|
5
4
|
beforeWrite: { takes: "a function", ok: (v) => typeof v === "function" },
|
|
6
5
|
autoBackgroundOnTimeout: { takes: "a boolean", ok: (v) => typeof v === "boolean" },
|
|
7
6
|
};
|
|
@@ -104,9 +104,6 @@ export interface HandsBandOptions {
|
|
|
104
104
|
/** Co-Authored-By trailer for the bash git protocol. Default NONE ([c209] BREAKING: attribution is a
|
|
105
105
|
* deployment identity asset — the branded scenario sets `"Name <email>"`); `false` ≡ unset. */
|
|
106
106
|
commitCoAuthor?: string | false;
|
|
107
|
-
/** Read-tool image downsampler: inject your own, or `false` to force-disable (deterministic no-sharp).
|
|
108
|
-
* Omitted ⇒ auto-detect sharp. Same contract as the MCP-side {@link import("./mcp.js").ImageDownsampler}. */
|
|
109
|
-
readImageDownsampler?: ((input: Buffer, mimeType: string) => Promise<import("./mcp.js").DownsampledImage | undefined>) | false;
|
|
110
107
|
/** Deployment write gate — COMPOSED with (never replacing) the engine's MemoryEngine write-scan gate:
|
|
111
108
|
* this hook judges first (a rejection short-circuits), the engine gate then still runs in full. */
|
|
112
109
|
beforeWrite?: BeforeWriteHook;
|
package/dist/core/hooks.d.ts
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import type { ActorAssertion, DocumentContent, ImageContent, TextContent } from "../internal/llm.js";
|
|
2
2
|
import type { ExecutionEnv, FileError, Result, SessionTreeEntry } from "../internal/harness-types.js";
|
|
3
|
-
import type { DecisionReason, PermissionResult, ResolvedAsk, ToolCallFace, ToolCallRequest
|
|
3
|
+
import type { DecisionReason, PermissionResult, ResolvedAsk, ToolCallFace, ToolCallRequest } from "./tool-policy.js";
|
|
4
4
|
import { type CallTargetStamp } from "./effective-path-target.js";
|
|
5
|
-
import type { GateOutcome } from "./gate-outcome.js";
|
|
5
|
+
import type { ClassifierDenyCause, DeniedBy, GateOutcome } from "./gate-outcome.js";
|
|
6
6
|
import { type PreToolUseScreening } from "./runner/gate-exit.js";
|
|
7
7
|
export { normalizeOrgGateVerdict, normalizePersistedRuleHit } from "./rule-lane-reads.js";
|
|
8
|
-
import {
|
|
8
|
+
import type { AskClass } from "./ask-class.js";
|
|
9
9
|
import { type PermissionMode } from "./ask-origin.js";
|
|
10
10
|
import { type AutoModeDenialTracker } from "./auto-mode.js";
|
|
11
11
|
export { formatHookFeedback } from "./reminder-mint.js";
|
|
@@ -438,9 +438,8 @@ export declare function createHookEnvCapabilities(env: ExecutionEnv): HookEnvCap
|
|
|
438
438
|
* ({@link mintHookInvocationIdentity} — single mint home) and every station reuses it.
|
|
439
439
|
* · HONESTLY ABSENT (no fabrication) where the engine structurally cannot know:
|
|
440
440
|
* 1. a HOST driving the exported {@link runToolGate} directly without supplying `ToolGateInput.identity`;
|
|
441
|
-
* 2.
|
|
442
|
-
*
|
|
443
|
-
* 3. a deployment driving the compaction module directly with its own `preCompact`/`postCompact` options.
|
|
441
|
+
* 2. a deployment driving the compaction module directly with its own `preCompact`/`postCompact` options.
|
|
442
|
+
* (An ancestor's installation judging a DESCENDANT's call carries the descendant's envelope: the e is the judged leg's.)
|
|
444
443
|
*
|
|
445
444
|
* CONSUMER NOTE — the minted object is FROZEN and carries a NULL PROTOTYPE (same rule and same
|
|
446
445
|
* trade as {@link HookEnvCapabilities}: absence must be a fact about this object, not about what
|
|
@@ -451,8 +450,8 @@ export declare function createHookEnvCapabilities(env: ExecutionEnv): HookEnvCap
|
|
|
451
450
|
export interface HookInvocationIdentity {
|
|
452
451
|
/** The run's session id (uuid domain) — the same key `TaskResult.sessionId` reports. */
|
|
453
452
|
readonly sessionId: string;
|
|
454
|
-
/** The run's unified task id (
|
|
455
|
-
*
|
|
453
|
+
/** The run's unified task id (the leg's one mint; TaskEvent's `sourceTaskId` and `task_progress` key on it): a background
|
|
454
|
+
* sub-agent's registry task id, else the host's declared task id, else {@link sessionId}. */
|
|
456
455
|
readonly taskId: string;
|
|
457
456
|
/** Which prepared leg this invocation belongs to — the wiring manifest's own `leg.kind`
|
|
458
457
|
* derivation, verbatim ({@link WiringLegKind}: `"root" | "child" | "resume"`). NOTE the fork
|
|
@@ -530,8 +529,9 @@ export interface HookToolOutput {
|
|
|
530
529
|
* whole hook result; the concurrent arm never carried it, so the two arms disagreed on a member neither
|
|
531
530
|
* of them reads. Nothing in the engine reads it off a decision.
|
|
532
531
|
*
|
|
533
|
-
* PreToolUse lane × settlement table (the gate's phase 1 in {@link runToolGate}
|
|
534
|
-
* {@link
|
|
532
|
+
* PreToolUse lane × settlement table (the gate's phase 1 in {@link runToolGate}, for the leg's own bus; an inherited
|
|
533
|
+
* installation's words are read in {@link createPreToolUseScreening}: its ask goes to its own frozen regime, its allow is no
|
|
534
|
+
* objection, its deny and its failure are as below). "Held" = the ask survives to a person:
|
|
535
535
|
* neither an allow rule (`decisionReason: "hook"` is outside the allow layer) nor the classifier (hook asks are
|
|
536
536
|
* never classifier-answerable) clears it.
|
|
537
537
|
* · returns `allow` (± `updatedInput` / `additionalContext`) → the face's own word (`hookAllowedBy`, naming the registration); the policy
|
|
@@ -549,6 +549,10 @@ export interface HookToolOutput {
|
|
|
549
549
|
*/
|
|
550
550
|
export type PreToolUseResult = PermissionResult & {
|
|
551
551
|
additionalContext?: string;
|
|
552
|
+
/** WHY the hook asks, on an `ask` only ({@link import("./ask-origin.js").HookQuestionCause}; absent reads `asked`): on the two
|
|
553
|
+
* `verdict_*` words the `message` is the host's account, which no entry carries. Outside the set, or on another arm, the
|
|
554
|
+
* decision receipt refuses it (an engine fail-closed deny). */
|
|
555
|
+
questionCause?: import("./ask-origin.js").HookQuestionCause;
|
|
552
556
|
};
|
|
553
557
|
/** A PostToolUse hook result: replace the tool output and/or append context (both optional). */
|
|
554
558
|
export interface PostToolUseResult {
|
|
@@ -783,12 +787,14 @@ export interface ToolGateInput extends PermissionSeatInputs, SkillGateSeats, All
|
|
|
783
787
|
* the call fail-closed (the event's failure column), and so does a cancel; an observe handler never decides.
|
|
784
788
|
*/
|
|
785
789
|
modBus?: Pick<import("./mods/kernel/index.js").ModBus, "hasHandlers" | "dispatch">;
|
|
786
|
-
/** The inherited installations
|
|
787
|
-
*
|
|
788
|
-
*
|
|
789
|
-
*
|
|
790
|
-
*
|
|
791
|
-
|
|
790
|
+
/** The inherited installations that judge this leg's calls too (`inheritedInstallations`, the rule's one home), each on its
|
|
791
|
+
* own bus after {@link modBus}: `classic.PreToolUse` at phase 1 (and at every re-screen), with this leg's identity and the
|
|
792
|
+
* installation's environment; `tool.check` at the verdict read, each over the verdict the previous left standing. On both
|
|
793
|
+
* events their `deny` is the hook's own refusal, their `allow` never clears an ask (an installation answers only its own
|
|
794
|
+
* leg's questions; it is disclosed as the `hook` member's shadow), and their `ask` goes to each installation's own `settle`
|
|
795
|
+
* (where its installation froze the question), never to this gate's resolver; an approval there that edits the call takes
|
|
796
|
+
* this gate's approved-edit pass. Absent ⇒ only {@link modBus} is raised. */
|
|
797
|
+
inheritedInstallations?: readonly import("./mods/stations.js").InheritedInstallation[];
|
|
792
798
|
/** The leg's observed permission mode, carried on every `classic.PreToolUse` e this gate call raises. Absent ⇒ the e
|
|
793
799
|
* carries none (a host-driven gate with no leg seat). */
|
|
794
800
|
observedPermissionMode?: () => PermissionMode;
|
|
@@ -1282,7 +1288,7 @@ export interface ToolGateInput extends PermissionSeatInputs, SkillGateSeats, All
|
|
|
1282
1288
|
};
|
|
1283
1289
|
/**
|
|
1284
1290
|
* F-012 L2 — the SANDBOX ADMISSION leg. Present ONLY when the runner armed the mode: the execution
|
|
1285
|
-
* env DECLARES isolation (`
|
|
1291
|
+
* env DECLARES isolation (`capabilities.isolation === true`, read through `isIsolated` — a Runner-resolved
|
|
1286
1292
|
* fact, never caller self-report) AND the park prerequisites hold (durable park configured + a wired
|
|
1287
1293
|
* checkpoint store — every store carries the required `reopen`, read at its seat). Absent ⇒ the whole step does not
|
|
1288
1294
|
* exist and the decision path is byte-identical to a build without it.
|
|
@@ -1320,52 +1326,33 @@ export interface ToolGateInput extends PermissionSeatInputs, SkillGateSeats, All
|
|
|
1320
1326
|
};
|
|
1321
1327
|
}
|
|
1322
1328
|
/**
|
|
1323
|
-
* The PreToolUse screening face ({@link PreToolUseScreening}) for ONE call — `classic.PreToolUse` raised on the leg's
|
|
1324
|
-
* bus
|
|
1325
|
-
*
|
|
1326
|
-
* approved
|
|
1329
|
+
* The PreToolUse screening face ({@link PreToolUseScreening}) for ONE call — `classic.PreToolUse` raised on the leg's own
|
|
1330
|
+
* bus and then on each inherited installation's ({@link ToolGateInput.inheritedInstallations}), the per-screening e and the
|
|
1331
|
+
* fail-closed sentences, built in ONE place for every site that screens a call: the gate's phase 1, the fold's second look
|
|
1332
|
+
* and the approved-edit re-screens (through {@link runToolGate}'s pass) and the resumed leg's re-screen of an approved call.
|
|
1333
|
+
* Undefined when no handler hangs on the event on any of those buses.
|
|
1327
1334
|
*
|
|
1328
1335
|
* The e: `tool` (the call's wire name), `tool_use_id`, `input` — a deep-frozen copy of the args, so what a handler
|
|
1329
1336
|
* judges is what runs (`input` is pinned; a rewrite is the answer's `updatedInput`) — `agentId` on a delegated leg,
|
|
1330
|
-
* `cwd` (the task's tracked cwd, read per screening), `env` (the capability face), `identity`, `permissionMode`.
|
|
1331
|
-
|
|
1332
|
-
|
|
1333
|
-
/**
|
|
1334
|
-
* Fold a leg's `classic.PreToolUse` chain into a {@link ToolPolicy} layer, so the screening a task installed can also
|
|
1335
|
-
* travel down a delegation chain as one more inherited constraint — the constraint MINT. `chain` is the installing
|
|
1336
|
-
* leg's bus; the policy raises `classic.PreToolUse` on it with the handlers that JUDGE (an observe handler never enters
|
|
1337
|
-
* a constraint — the participant filter below is that rule's one home).
|
|
1338
|
-
*
|
|
1339
|
-
* Why a policy and not a second channel: a delegated child already folds each ancestor's caller policy
|
|
1340
|
-
* (`InheritedGate.parentConstraints`), and that fold is where `deny > ask > allow`, the rewrite cascade, the
|
|
1341
|
-
* ancestor-frozen approver and the durable mandate all already live. Expressing the screening in the same shape means
|
|
1342
|
-
* the child gains no new decision channel — the existing fold consumes it — and the tighten-only property is
|
|
1343
|
-
* structural rather than restated.
|
|
1344
|
-
*
|
|
1345
|
-
* The mapping mirrors the gate's own phase 1 decision for decision:
|
|
1346
|
-
* - no opinion, and an `allow` → `allow`, contributing nothing (a constraint only tightens: it clears no question);
|
|
1347
|
-
* - `deny` → `deny` in the fold's own words;
|
|
1348
|
-
* - `ask` → `ask`, stamped `decisionReason:"hook"` (and the mandate, when the answer set it) so every consumer that
|
|
1349
|
-
* distinguishes a screening ask from a policy ask reads the same fact one level down;
|
|
1350
|
-
* - `allow`/`ask` with `updatedInput` → the same rewrite, which the fold cascades and re-checks;
|
|
1351
|
-
* - a failed screening (a handler that threw, ran past its budget or broke the site's contract) or a cancel → the
|
|
1352
|
-
* fail-closed deny, because a screening that cannot answer must not pass the call. The installing leg's bus
|
|
1353
|
-
* already reported a crash or a timeout on that leg's error lane.
|
|
1354
|
-
*
|
|
1355
|
-
* **Idempotency** ({@link combinePolicies}): a layer's `check` may run more than once for a single tool call (the fold
|
|
1356
|
-
* scans past an `ask`, a later rewrite re-runs the prefix, an approved edit is re-adjudicated), so a handler with a side
|
|
1357
|
-
* effect sees that call more than once on those paths. Its own leg's phase 1 has always had the third of these.
|
|
1358
|
-
*
|
|
1359
|
-
* Not carried, and not reconstructible in this shape: `additionalContext` (a policy verdict has no channel for
|
|
1360
|
-
* model-facing text — the context belongs to the run whose gate ran it), the leg identity and the tracked cwd (the
|
|
1361
|
-
* fold's request carries neither, and the installing leg's would name the wrong run), and the phase-1 observer
|
|
1362
|
-
* exclusion (a deny raised here is a fold deny: the descendant's deny observer sees it as `source:"policy"`). `env` is
|
|
1363
|
-
* the capability face of the environment the chain was installed against, captured at the install site.
|
|
1337
|
+
* `cwd` (the task's tracked cwd, read per screening), `env` (the capability face), `identity`, `permissionMode`. On an
|
|
1338
|
+
* inherited installation the e is THIS leg's (its identity, its mode, its cwd — the call being judged) and the `env` is the
|
|
1339
|
+
* environment that installation was installed against; only its judging handlers take part.
|
|
1364
1340
|
*
|
|
1365
|
-
*
|
|
1366
|
-
*
|
|
1341
|
+
* Every installation is one judge of the call, under one answer reading: a failure or a cancel refuses the call
|
|
1342
|
+
* fail-closed, a `deny` refuses it as the hook's own refusal, a rewrite is adopted (an installation that judged the earlier
|
|
1343
|
+
* bytes judges the rewrite once — a verdict covers the bytes it was given; a deny or yet another form there refuses), the
|
|
1344
|
+
* context lines are collected. Its other words differ by WHOSE installation it is: the leg's own `ask` / `allow` is the
|
|
1345
|
+
* leg's (folded by the gate as before); an inherited installation's `ask` is settled under the regime it froze
|
|
1346
|
+
* (`InheritedInstallation.settle`, read through `readSettled` — the pass's ledger): refused ⇒ the call is refused,
|
|
1347
|
+
* approved ⇒ that question is answered, approved with an edit ⇒ the screen ends and the gate's approved-edit pass takes the
|
|
1348
|
+
* edit, floated ⇒ the question stands marked; its `allow` is no objection (an installation answers only its own leg's
|
|
1349
|
+
* questions), disclosed beside the leg's own hook member.
|
|
1367
1350
|
*/
|
|
1368
|
-
export declare function
|
|
1351
|
+
export declare function createPreToolUseScreening(input: Pick<ToolGateInput, "event" | "modBus" | "inheritedInstallations" | "observedPermissionMode" | "trackedCwd" | "hookEnv" | "identity" | "abortSignal" | "callSignal">, readSettled?: (settled: PermissionResult) => {
|
|
1352
|
+
readonly decision: PermissionResult;
|
|
1353
|
+
readonly deniedBy?: DeniedBy;
|
|
1354
|
+
readonly cause?: ClassifierDenyCause;
|
|
1355
|
+
}): PreToolUseScreening | undefined;
|
|
1369
1356
|
/**
|
|
1370
1357
|
* The park closure's ONE structural seat — what the gate hands the durable park beyond the twelve
|
|
1371
1358
|
* positional seats. Every member is optional and read by name, so a new thing the park must know
|
|
@@ -1401,11 +1388,14 @@ export interface AskCarry {
|
|
|
1401
1388
|
readonly mandate?: import("./ask-origin.js").PersistedRuleMandate;
|
|
1402
1389
|
/** The deployment's authorship ({@link import("./tool-policy.js").AskRequest.authoredBy}), for the row's twin. */
|
|
1403
1390
|
readonly authoredBy?: "deployment";
|
|
1391
|
+
/** The surviving ask's askers' entries ({@link import("./tool-policy.js").AskRequest.askReasons}), for the row's twin — the
|
|
1392
|
+
* same value the synchronous card carries. */
|
|
1393
|
+
readonly askReasons?: readonly import("./ask-origin.js").AskReason[];
|
|
1404
1394
|
}
|
|
1405
1395
|
/** What a durable row persists of an {@link AskCarry}: the fallback member COPIED (the row never aliases
|
|
1406
1396
|
* the gate's object; its window is already `0` — the gate's carry mint is the one writer of that
|
|
1407
|
-
* number), the origin word only when it is a member of the closed set,
|
|
1408
|
-
* well-formed, as
|
|
1397
|
+
* number), the origin word only when it is a member of the closed set, the class pair and the askers' entries only when
|
|
1398
|
+
* well-formed, as fresh copies (the carry is typed, but the row is the boundary a host reads back through —
|
|
1409
1399
|
* the same screen the summary applies to the word). */
|
|
1410
1400
|
export declare function askCarryRowMembers(carry: AskCarry | undefined): {
|
|
1411
1401
|
denialLimitFallback?: import("./auto-mode.js").DenialLimitFallback;
|
|
@@ -1413,6 +1403,7 @@ export declare function askCarryRowMembers(carry: AskCarry | undefined): {
|
|
|
1413
1403
|
origin?: import("./ask-origin.js").AskOrigin;
|
|
1414
1404
|
askClass?: import("./ask-origin.js").AskClass;
|
|
1415
1405
|
classes?: readonly import("./ask-origin.js").AskClass[];
|
|
1406
|
+
askReasons?: readonly import("./ask-origin.js").AskReason[];
|
|
1416
1407
|
};
|
|
1417
1408
|
/**
|
|
1418
1409
|
* The design/37 **two-phase tool gate** — the single chokepoint that makes the load-bearing invariant
|