@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
package/dist/core/allow-entry.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { heldBy } from "./tool-name-readings.js";
|
|
1
|
+
import { heldBy, wireOf } from "./tool-name-readings.js";
|
|
2
2
|
import { ruleIssue } from "./permission-rules.js";
|
|
3
3
|
import { isCoveringRuleName, ruleNameCovers } from "./namespaced-rule-name.js";
|
|
4
4
|
import { ruleSpellingOf } from "./permission-rule-syntax.js";
|
|
@@ -6,8 +6,10 @@ import { splitNamespacedName, toolNameFaultOf } from "./tool-name-aliases.js";
|
|
|
6
6
|
import { catalogToolNames, isShellFaceToolName } from "./tool-registry.js";
|
|
7
7
|
import { ALLOW_RULE_MEMBERS } from "./allow-rule-shadow.js";
|
|
8
8
|
import { callHostTargetOf } from "./host-target.js";
|
|
9
|
-
import { adjudicatePersistedDomainRules, wholeToolRuleReaches, adjudicatePersistedNameRules, commandCoverageOf,
|
|
9
|
+
import { adjudicatePersistedDomainRules, wholeToolRuleReaches, adjudicatePersistedNameRules, commandCoverageOf, ruleWordsOf, ruleContentOf, noticeRuleText, parseRuleText, programRunReachOf, ruleToolGrammarOf, unusableDeclaredBase, PATH_RULE_BASES, PATH_RULE_BASE_LABEL, commandPatternMayRun } from "./permission-rule-model.js";
|
|
10
10
|
import { pathRuleLaneAnswer } from "./runner/permission-rule-lanes.js";
|
|
11
|
+
import { policyAnchors } from "./path-rule-binding.js";
|
|
12
|
+
import { receiptRefusal, receiveOwnProperties } from "./own-property-receipt.js";
|
|
11
13
|
import { callTargetReadingOf } from "./effective-path-target.js";
|
|
12
14
|
import { splitShellCompoundSegments } from "../tools/fs/bash-readonly-classifier.js";
|
|
13
15
|
import { ASK_RULE_DISCLOSURE, MANDATE_DISCLOSURE, mandateDisclosureOf } from "./ask-origin.js";
|
|
@@ -132,12 +134,12 @@ export function autoStripped(compiled, call, allShell) {
|
|
|
132
134
|
case "shell":
|
|
133
135
|
return true;
|
|
134
136
|
case "tool":
|
|
135
|
-
case "covering":
|
|
136
137
|
return call !== undefined && answersTo(call, isShellFaceToolName);
|
|
137
138
|
case "command":
|
|
138
139
|
if (allShell)
|
|
139
140
|
return true;
|
|
140
141
|
return compiled.rule.match === "pattern" ? commandPatternMayRun(compiled.rule.command, AUTO_STRIPPED_PROGRAMS) : shellContentStripped(shellRuleContent(compiled.rule));
|
|
142
|
+
case "covering":
|
|
141
143
|
case "path":
|
|
142
144
|
case "name":
|
|
143
145
|
case "domain":
|
|
@@ -167,13 +169,19 @@ export function classifiesAllShell(spec) {
|
|
|
167
169
|
return spec.classifyAllShell === true;
|
|
168
170
|
}
|
|
169
171
|
const NO_LEADS = new Map();
|
|
170
|
-
function nameRowReaches(compiled, req) {
|
|
172
|
+
function nameRowReaches(compiled, req, reach) {
|
|
173
|
+
if (reach === "wire_name") {
|
|
174
|
+
const wire = wireOf("allowEntry.launchListNames", req);
|
|
175
|
+
if (compiled.kind === "tool" || compiled.kind === "shell")
|
|
176
|
+
return compiled.name === wire;
|
|
177
|
+
return compiled.kind === "covering" && ruleNameCovers(compiled.pattern, wire);
|
|
178
|
+
}
|
|
171
179
|
if (compiled.kind === "tool" || compiled.kind === "shell")
|
|
172
180
|
return wholeToolRuleReaches(compiled.name, req);
|
|
173
181
|
return compiled.kind === "covering" && answersTo(req, (n) => ruleNameCovers(compiled.pattern, n));
|
|
174
182
|
}
|
|
175
|
-
function commandOf(req) {
|
|
176
|
-
const tool =
|
|
183
|
+
function commandOf(req, behavior) {
|
|
184
|
+
const tool = ruleWordsOf(req, behavior).find((n) => ruleToolGrammarOf(n) === "command");
|
|
177
185
|
const command = req.args?.command;
|
|
178
186
|
return tool !== undefined && typeof command === "string" ? { tool, command } : undefined;
|
|
179
187
|
}
|
|
@@ -181,21 +189,25 @@ function admissionCallOf(call, ctx, liveCwd, posture) {
|
|
|
181
189
|
return { tool: call.tool, command: call.command, cwd: ctx.root, ...(ctx.sessionId !== undefined ? { sessionId: ctx.sessionId } : {}), ...(liveCwd !== undefined ? { execCwd: liveCwd } : {}), posture };
|
|
182
190
|
}
|
|
183
191
|
export function uncoveredCommandSegment(rows, req, ctx, posture) {
|
|
184
|
-
const call = commandOf(req);
|
|
192
|
+
const call = commandOf(req, "allow");
|
|
185
193
|
if (call === undefined)
|
|
186
194
|
return undefined;
|
|
187
195
|
const rules = rows.flatMap((r) => (r.behavior === "allow" && r.compiled.kind === "command" ? [r.compiled.rule] : []));
|
|
188
196
|
const coverage = commandCoverageOf(rules, admissionCallOf(call, ctx, ctx.liveCwd(), posture));
|
|
189
197
|
return "uncovered" in coverage ? coverage.uncovered : undefined;
|
|
190
198
|
}
|
|
191
|
-
export function
|
|
199
|
+
export function wholeToolEntryOf(rows, tool, behavior, names = "every_name") {
|
|
200
|
+
return rows.find((r) => r.behavior === behavior && nameRowReaches(r.compiled, tool, names));
|
|
201
|
+
}
|
|
202
|
+
export function judgeAllowEntries(rows, req, behavior, ctx, posture = "grant", names = "every_name") {
|
|
192
203
|
const live = rows.filter((r) => r.behavior === behavior);
|
|
193
204
|
if (live.length === 0)
|
|
194
205
|
return undefined;
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
const
|
|
206
|
+
const nameRow = wholeToolEntryOf(live, req, behavior, names);
|
|
207
|
+
if (nameRow !== undefined)
|
|
208
|
+
return [nameRow];
|
|
209
|
+
const words = ruleWordsOf(req, behavior);
|
|
210
|
+
const call = commandOf(req, behavior);
|
|
199
211
|
const liveCwd = ctx.liveCwd();
|
|
200
212
|
if (call !== undefined) {
|
|
201
213
|
const byRule = new Map();
|
|
@@ -217,14 +229,32 @@ export function judgeAllowEntries(rows, req, behavior, ctx, posture = "grant") {
|
|
|
217
229
|
}
|
|
218
230
|
const pathRows = live.filter((r) => r.compiled.kind === "path");
|
|
219
231
|
if (pathRows.length > 0) {
|
|
220
|
-
const
|
|
221
|
-
for (const
|
|
222
|
-
const
|
|
223
|
-
const
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
232
|
+
const sets = new Map();
|
|
233
|
+
for (const r of pathRows) {
|
|
234
|
+
const key = anchorsKey(r.pathBases);
|
|
235
|
+
const set = sets.get(key) ?? { anchors: key === UNDECLARED_SET ? ctx.anchors : policyAnchors(r.pathBases ?? {}, ctx.anchors), rows: [] };
|
|
236
|
+
sets.set(key, set);
|
|
237
|
+
set.rows.push(r);
|
|
238
|
+
}
|
|
239
|
+
for (const name of words.filter((n) => ruleToolGrammarOf(n) === "path")) {
|
|
240
|
+
let unreadable;
|
|
241
|
+
for (const set of sets.values()) {
|
|
242
|
+
const table = set.rows.map((r) => r.compiled.rule);
|
|
243
|
+
const answer = pathRuleLaneAnswer(table, { ...req, toolName: name }, { root: ctx.root, sessionId: ctx.sessionId, anchorsOf: () => set.anchors, leads: callTargetReadingOf(req)?.leads ?? NO_LEADS });
|
|
244
|
+
if (answer === undefined)
|
|
245
|
+
continue;
|
|
246
|
+
if ("unreadable" in answer) {
|
|
247
|
+
if (behavior === "deny")
|
|
248
|
+
unreadable ??= set.rows[0];
|
|
249
|
+
continue;
|
|
250
|
+
}
|
|
251
|
+
if ("behavior" in answer && answer.behavior === behavior) {
|
|
252
|
+
const rule = answer.rules[0]?.rule;
|
|
253
|
+
return [set.rows.find((r) => r.compiled.rule.rule === rule) ?? set.rows[0]];
|
|
254
|
+
}
|
|
227
255
|
}
|
|
256
|
+
if (unreadable !== undefined)
|
|
257
|
+
return [unreadable];
|
|
228
258
|
}
|
|
229
259
|
}
|
|
230
260
|
for (const grammar of ["name", "domain"]) {
|
|
@@ -232,7 +262,7 @@ export function judgeAllowEntries(rows, req, behavior, ctx, posture = "grant") {
|
|
|
232
262
|
if (familyRows.length === 0)
|
|
233
263
|
continue;
|
|
234
264
|
const table = familyRows.map((r) => r.compiled.rule);
|
|
235
|
-
for (const name of
|
|
265
|
+
for (const name of words.filter((n) => ruleToolGrammarOf(n) === grammar)) {
|
|
236
266
|
const at = { tool: name, cwd: ctx.root, ...(ctx.sessionId !== undefined ? { sessionId: ctx.sessionId } : {}) };
|
|
237
267
|
const named = { ...req, toolName: name };
|
|
238
268
|
const verdict = grammar === "name" ? adjudicatePersistedNameRules(table, { ...at, request: req }) : adjudicatePersistedDomainRules(table, { ...at, hosts: { tighten: callHostTargetOf(named, "tighten"), grant: callHostTargetOf(named, "grant") } });
|
|
@@ -245,32 +275,52 @@ export function judgeAllowEntries(rows, req, behavior, ctx, posture = "grant") {
|
|
|
245
275
|
export function allowingRows(rows, req, mode, allShell) {
|
|
246
276
|
return rows.filter((r) => !strippedInAuto(r.compiled, req, mode, allShell));
|
|
247
277
|
}
|
|
278
|
+
function allowListMemberOf(entry) {
|
|
279
|
+
return typeof entry === "string" ? { rule: entry } : entry;
|
|
280
|
+
}
|
|
281
|
+
function anchorsKey(pathBases) {
|
|
282
|
+
return JSON.stringify(PATH_RULE_BASES.map((word) => pathBases?.[word] ?? null));
|
|
283
|
+
}
|
|
284
|
+
const UNDECLARED_SET = anchorsKey(undefined);
|
|
285
|
+
function allowListMemberKey(member) {
|
|
286
|
+
return JSON.stringify([member.rule, anchorsKey(member.pathBases)]);
|
|
287
|
+
}
|
|
248
288
|
export class AllowEntryTable {
|
|
249
289
|
held = [];
|
|
250
|
-
|
|
290
|
+
heldKeys = new Set();
|
|
251
291
|
receivedAt = new Map();
|
|
252
292
|
seed(entries, reading = {}) {
|
|
253
|
-
const
|
|
293
|
+
const members = entries.map(allowListMemberOf);
|
|
254
294
|
if (reading.received === true) {
|
|
255
295
|
this.receivedAt = new Map();
|
|
256
|
-
|
|
257
|
-
const
|
|
296
|
+
members.forEach((m, i) => {
|
|
297
|
+
const key = allowListMemberKey(m);
|
|
298
|
+
const at = this.receivedAt.get(key);
|
|
258
299
|
if (at === undefined)
|
|
259
|
-
this.receivedAt.set(
|
|
300
|
+
this.receivedAt.set(key, [i]);
|
|
260
301
|
else
|
|
261
302
|
at.push(i);
|
|
262
303
|
});
|
|
263
304
|
}
|
|
264
|
-
|
|
265
|
-
|
|
305
|
+
const inert = [];
|
|
306
|
+
for (const member of members) {
|
|
307
|
+
const read = readRuleEntry(member.rule, "allow", reading.roster);
|
|
308
|
+
if (read.kind !== "row") {
|
|
309
|
+
const { kind: _kind, ...why } = read;
|
|
310
|
+
void _kind;
|
|
311
|
+
inert.push({ entry: member.rule, ...why });
|
|
312
|
+
continue;
|
|
313
|
+
}
|
|
314
|
+
const key = allowListMemberKey(member);
|
|
315
|
+
if (this.heldKeys.has(key))
|
|
266
316
|
continue;
|
|
267
|
-
this.
|
|
268
|
-
this.held.push({ behavior: "allow", entry:
|
|
317
|
+
this.heldKeys.add(key);
|
|
318
|
+
this.held.push({ behavior: "allow", entry: member.rule, compiled: read.compiled, ...(member.pathBases !== undefined ? { pathBases: member.pathBases } : {}) });
|
|
269
319
|
}
|
|
270
320
|
return inert;
|
|
271
321
|
}
|
|
272
322
|
entries() {
|
|
273
|
-
return this.held.map((r) => r.entry);
|
|
323
|
+
return this.held.map((r) => (r.pathBases === undefined ? r.entry : Object.freeze({ rule: r.entry, pathBases: r.pathBases })));
|
|
274
324
|
}
|
|
275
325
|
holdsPathRows() {
|
|
276
326
|
return this.held.some((r) => r.compiled.kind === "path");
|
|
@@ -278,11 +328,11 @@ export class AllowEntryTable {
|
|
|
278
328
|
lane(ctx) {
|
|
279
329
|
return {
|
|
280
330
|
allowing: (req, mode) => {
|
|
281
|
-
const hit = judgeAllowEntries(allowingRows(this.held, req, mode, ctx.classifyAllShell === true), req, "allow", ctx);
|
|
331
|
+
const hit = judgeAllowEntries(allowingRows(this.held, req, mode, ctx.classifyAllShell === true), req, "allow", ctx, "grant", "wire_name");
|
|
282
332
|
if (hit === undefined)
|
|
283
333
|
return undefined;
|
|
284
334
|
const entries = hit.map((r) => r.entry);
|
|
285
|
-
const positions =
|
|
335
|
+
const positions = hit.flatMap((r) => this.receivedAt.get(allowListMemberKey({ rule: r.entry, ...(r.pathBases !== undefined ? { pathBases: r.pathBases } : {}) })) ?? []).sort((a, b) => a - b);
|
|
286
336
|
return { entries, ...(positions.length > 0 ? { positions } : {}) };
|
|
287
337
|
},
|
|
288
338
|
};
|
|
@@ -302,7 +352,7 @@ export function withDeploymentAllowedTools(deps) {
|
|
|
302
352
|
if (deps.allowedTools === undefined)
|
|
303
353
|
return deps;
|
|
304
354
|
const allowedTools = screenAllowedToolsValue(deps.allowedTools, "RunnerDeps.allowedTools");
|
|
305
|
-
const inert =
|
|
355
|
+
const inert = new AllowEntryTable().seed(allowedTools ?? []);
|
|
306
356
|
if (inert.length > 0)
|
|
307
357
|
deliverEngineNotice(deps.onNotice, allowedToolsNotGrantedNotice(inert.map((e) => ({ source: "deployment", ...e })), undefined));
|
|
308
358
|
return { ...deps, allowedTools };
|
|
@@ -312,20 +362,63 @@ const ALLOW_LIST_SEATS = {
|
|
|
312
362
|
"TaskSpec.allowedTools": "the request's allow list",
|
|
313
363
|
"RunnerDeps.allowedTools": "the deployment's allow list",
|
|
314
364
|
};
|
|
365
|
+
const ANCHORED_MEMBER_KEYS = new Set(["rule", "pathBases"]);
|
|
366
|
+
const PATH_BASE_WORDS = new Set(PATH_RULE_BASES);
|
|
367
|
+
function receiveAnchoredMember(entry, at) {
|
|
368
|
+
const member = receiveOwnProperties(entry, { subject: at, unit: "member", moment: "when the list is read" });
|
|
369
|
+
for (const key of Object.keys(member)) {
|
|
370
|
+
if (!ANCHORED_MEMBER_KEYS.has(key))
|
|
371
|
+
throw receiptRefusal(`${at} carries ${inlineUntrusted(key, 80)}, which is not a member of an anchored entry (its members are rule and pathBases) — refused rather than read without it`);
|
|
372
|
+
}
|
|
373
|
+
const rule = Object.hasOwn(member, "rule") ? member.rule : undefined;
|
|
374
|
+
const pathBases = Object.hasOwn(member, "pathBases") ? member.pathBases : undefined;
|
|
375
|
+
if (typeof rule !== "string")
|
|
376
|
+
throw receiptRefusal(`${at}.rule must be a permission-rule string (got ${valueTypeLabel(rule)})`);
|
|
377
|
+
if (typeof pathBases !== "object" || pathBases === null || Array.isArray(pathBases))
|
|
378
|
+
throw receiptRefusal(`${at}.pathBases must be an object of base words (got ${valueTypeLabel(pathBases)})`);
|
|
379
|
+
const bases = receiveOwnProperties(pathBases, { subject: `${at}.pathBases`, unit: "base word", moment: "when the list is read" });
|
|
380
|
+
const held = Object.create(null);
|
|
381
|
+
for (const [word, value] of Object.entries(bases)) {
|
|
382
|
+
if (!PATH_BASE_WORDS.has(word))
|
|
383
|
+
throw receiptRefusal(`${at}.pathBases carries ${inlineUntrusted(word, 80)}, which is not a base word (${PATH_RULE_BASES.join(", ")}) — refused rather than read without it`);
|
|
384
|
+
if (typeof value !== "string")
|
|
385
|
+
throw receiptRefusal(`${at}.pathBases.${word} must be a path string (got ${valueTypeLabel(value)})`);
|
|
386
|
+
held[word] = value;
|
|
387
|
+
}
|
|
388
|
+
if (Object.keys(held).length === 0)
|
|
389
|
+
throw receiptRefusal(`${at}.pathBases declares no base word (${PATH_RULE_BASES.join(", ")}) — a member that declares no anchors is written as the rule string`);
|
|
390
|
+
return Object.freeze({ rule, pathBases: Object.freeze(held) });
|
|
391
|
+
}
|
|
315
392
|
export function screenAllowedToolsValue(value, seat) {
|
|
316
393
|
if (value === undefined)
|
|
317
394
|
return undefined;
|
|
318
395
|
const label = ALLOW_LIST_SEATS[seat];
|
|
319
396
|
const issues = [];
|
|
397
|
+
const out = [];
|
|
320
398
|
if (!Array.isArray(value)) {
|
|
321
|
-
issues.push(ruleIssue("", "invalid.entry_type", `${label} must be a list of permission-rule strings (got ${value === null ? "null" : typeof value})`, { name: seat }));
|
|
399
|
+
issues.push(ruleIssue("", "invalid.entry_type", `${label} must be a list of permission-rule strings or anchored rule members (got ${value === null ? "null" : typeof value})`, { name: seat }));
|
|
322
400
|
}
|
|
323
401
|
else {
|
|
324
402
|
const list = value;
|
|
325
|
-
list.
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
403
|
+
for (let i = 0; i < list.length; i++) {
|
|
404
|
+
const entry = list[i];
|
|
405
|
+
if (typeof entry === "string") {
|
|
406
|
+
out.push(entry);
|
|
407
|
+
continue;
|
|
408
|
+
}
|
|
409
|
+
if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
|
|
410
|
+
issues.push(ruleIssue("", "invalid.entry_type", `entry ${i} of ${label} must be a permission-rule string or an anchored rule member (got ${entry === null ? "null" : Array.isArray(entry) ? "an array" : typeof entry})`, { name: seat }));
|
|
411
|
+
continue;
|
|
412
|
+
}
|
|
413
|
+
const member = receiveAnchoredMember(entry, `${seat}[${i}]`);
|
|
414
|
+
const read = readRuleEntry(member.rule, "allow");
|
|
415
|
+
const bad = read.kind === "row" && read.compiled.kind === "path" ? unusableDeclaredBase(read.compiled.rule, member.pathBases) : undefined;
|
|
416
|
+
if (bad !== undefined) {
|
|
417
|
+
issues.push(ruleIssue(noticeRuleText(member.rule), "unsupported.path_base", `entry ${i} of ${label} is relative to ${PATH_RULE_BASE_LABEL[bad.base]}, and the one its set declares (pathBases.${bad.key}) is not an absolute path of its tree's family — the rule could not be judged on any call`, { name: seat }));
|
|
418
|
+
continue;
|
|
419
|
+
}
|
|
420
|
+
out.push(member);
|
|
421
|
+
}
|
|
329
422
|
}
|
|
330
423
|
if (issues.length > 0) {
|
|
331
424
|
const e = new Error(`${label}: ${issues.length} invalid entr${issues.length === 1 ? "y" : "ies"} — refusing rather than running without them:\n${issues.map((i) => ` [${i.code}] ${i.message}`).join("\n")}`);
|
|
@@ -333,7 +426,7 @@ export function screenAllowedToolsValue(value, seat) {
|
|
|
333
426
|
e.issues = issues;
|
|
334
427
|
throw e;
|
|
335
428
|
}
|
|
336
|
-
return Object.freeze(
|
|
429
|
+
return Object.freeze(out);
|
|
337
430
|
}
|
|
338
431
|
const SHADOW_ENTRIES_MAX = 5;
|
|
339
432
|
const SHADOW_ENTRY_MAX_CHARS = 200;
|
|
@@ -474,6 +567,8 @@ export function inertEntryPhrase(e) {
|
|
|
474
567
|
case "unprefixed_namespace":
|
|
475
568
|
return 'tool_name: a "__" name with no protocol prefix';
|
|
476
569
|
case "unmintable_segment":
|
|
570
|
+
if (e.ambiguous === true && e.guidance !== undefined)
|
|
571
|
+
return `tool_name: ${e.guidance}${spelling !== undefined ? ` Write "${spelling}"` : ""}`;
|
|
477
572
|
return `tool_name: a namespaced name with a segment the engine never mints${spelling !== undefined ? `, write "${spelling}"` : ""}`;
|
|
478
573
|
default: {
|
|
479
574
|
const exhaustive = e.verdict;
|
|
@@ -77,8 +77,6 @@ export type ResultCodeTableCoversEveryHostFailure = AssertAllKeysHandled<Exclude
|
|
|
77
77
|
/** The one result code that is not a host word: the host threw, timed out, or answered outside its contract. */
|
|
78
78
|
export declare const ARTIFACT_HOST_ERROR_CODE = "artifact.host_error";
|
|
79
79
|
export type ArtifactResultCode = (typeof ARTIFACT_FAILURE_RESULT_CODE)[ArtifactHostFailureCode] | typeof ARTIFACT_HOST_ERROR_CODE;
|
|
80
|
-
/** The `details.type` card the Artifact tool mints on every result. */
|
|
81
|
-
export declare const ARTIFACT_CARD = "artifact";
|
|
82
80
|
/**
|
|
83
81
|
* What a host declares at mount time. Invariants (a violation refuses the mount and announces
|
|
84
82
|
* `config.artifact_host_invalid`): `actions` non-empty, duplicate-free, within {@link ARTIFACT_ACTIONS},
|
|
@@ -38,7 +38,6 @@ export const ARTIFACT_FAILURE_RESULT_CODE = {
|
|
|
38
38
|
refused: "artifact.refused",
|
|
39
39
|
};
|
|
40
40
|
export const ARTIFACT_HOST_ERROR_CODE = "artifact.host_error";
|
|
41
|
-
export const ARTIFACT_CARD = "artifact";
|
|
42
41
|
const isPositiveInt = (v) => typeof v === "number" && Number.isSafeInteger(v) && v > 0;
|
|
43
42
|
const wordOf = (set, v) => typeof v === "string" && set.includes(v);
|
|
44
43
|
export function readArtifactHostCapabilities(host) {
|
|
@@ -81,6 +81,85 @@ export type AskOrigin = (typeof ASK_ORIGINS)[number];
|
|
|
81
81
|
/** Whether a value is a member of the closed origin set. Exported because the word crosses process
|
|
82
82
|
* boundaries: a host validating one it received must not hand-roll the set. */
|
|
83
83
|
export declare function isAskOrigin(v: unknown): v is AskOrigin;
|
|
84
|
+
/**
|
|
85
|
+
* WHY a hook asked about a call — the closed set a hook seat's answer states beside its `ask` (`questionCause`), read by the
|
|
86
|
+
* hook entry of {@link AskReason}: `asked` — the hook itself asks, in its own words (the answer's `message`); `verdict_unreadable`
|
|
87
|
+
* — the hook's host could not read the verdict the hook gave, so it asks a person instead; `verdict_unfinished` — the hook did not
|
|
88
|
+
* finish with a verdict (it timed out, exited, could not be run), so its host asks a person. On the two `verdict_*` words the
|
|
89
|
+
* answer's `message` is the host's own account and is not the hook's words: no entry carries it. An answer that states no cause
|
|
90
|
+
* reads as `asked`.
|
|
91
|
+
*/
|
|
92
|
+
export declare const HOOK_QUESTION_CAUSES: readonly ["asked", "verdict_unreadable", "verdict_unfinished"];
|
|
93
|
+
export type HookQuestionCause = (typeof HOOK_QUESTION_CAUSES)[number];
|
|
94
|
+
/** Membership test for {@link HookQuestionCause} — the receipt's screen of the hook seat's member. */
|
|
95
|
+
export declare function isHookQuestionCause(v: unknown): v is HookQuestionCause;
|
|
96
|
+
/**
|
|
97
|
+
* One asker of a call and what it said, in its OWN words — an entry of `askReasons` on the approval request and its parked row.
|
|
98
|
+
* The one law: an entry carries a question's asker's own words (a policy chain's ask sentence — the deployment's, an integrity
|
|
99
|
+
* guard's, a rule's —, a hook's or an extension's reason, a hook host's cause word); a sentence the engine composes about a call
|
|
100
|
+
* whose fact already rides a typed member (a tool mark, an allow layer's shadow, a classifier's no-ruling, a generic question)
|
|
101
|
+
* is no entry. `by` names the asker with the {@link AskOrigin} word for it; a hook entry names its registration when the engine
|
|
102
|
+
* knows it and the {@link HookQuestionCause}, and carries `words` only when the hook itself asked (`asked`). `words` is
|
|
103
|
+
* untrusted display text, already one line and capped ({@link ASK_REASON_WORDS_MAX}).
|
|
104
|
+
*/
|
|
105
|
+
export type AskReason = {
|
|
106
|
+
readonly by: "hook";
|
|
107
|
+
readonly registration?: string;
|
|
108
|
+
readonly cause: HookQuestionCause;
|
|
109
|
+
readonly words?: string;
|
|
110
|
+
} | {
|
|
111
|
+
readonly by: Exclude<AskOrigin, "hook">;
|
|
112
|
+
readonly words: string;
|
|
113
|
+
};
|
|
114
|
+
/** The cap on an entry's `words` — the one an extension's reason has always been shown under in the question's sentence. */
|
|
115
|
+
export declare const ASK_REASON_WORDS_MAX = 500;
|
|
116
|
+
/**
|
|
117
|
+
* The facts no layer BEFORE the gate holds about a call — the gate's org layer, its question-tool and marked-call lanes, its
|
|
118
|
+
* tightens and the tool seat's marks all read as absent. Two readers. An inherited station: the delegation half of the live
|
|
119
|
+
* gate's classifier eligibility — the SAME class row answers for the FROZEN classifier (an ask raised by a hook, minted by an
|
|
120
|
+
* explicit `ask` rule, or already a denial-limit fallback is as out of the frozen decider's reach as the live one's: the standing
|
|
121
|
+
* decision travels with the frozen entry); an ancestor's frozen classifier runs inside the policy fold, before the live gate's
|
|
122
|
+
* org layer has spoken and before its question-tool and marked-call lanes run, so those asks meet their exclusions downstream,
|
|
123
|
+
* where the facts exist, and excluded asks fall through to the frozen approver chain. The mandate marks are empty (the base
|
|
124
|
+
* names no seat): the policy-chain phase builds each call's facts over this base with THIS task's tool seat, so a marked tool's
|
|
125
|
+
* ask is classified at the station as at the gate; no call either (each station's own). And the receipt of a policy chain's ask,
|
|
126
|
+
* whose entry names the asker its own members say ({@link chainAskReasonsOf}) — not a word the gate's later layers would add.
|
|
127
|
+
*/
|
|
128
|
+
export declare const INHERITED_STATION_FACTS: Omit<AskOriginFacts, "call">;
|
|
129
|
+
/** A hook's entry ({@link AskReason}): the registration that answered (when the engine knows it), the cause, and — only when the hook
|
|
130
|
+
* itself asked — its reason as untrusted display text. Every station that reads a hook's or an extension's `ask` mints it here. */
|
|
131
|
+
export declare function hookAskReasonOf(registration: string | undefined, cause: HookQuestionCause, reason: string | undefined): Extract<AskReason, {
|
|
132
|
+
by: "hook";
|
|
133
|
+
}>;
|
|
134
|
+
/**
|
|
135
|
+
* The entry of a policy chain's ask, minted where the ask is RECEIVED (the gate's adjudication and its approved-edit re-check, an
|
|
136
|
+
* inherited station's read of an ancestor's ask): the receipt's own words, under the asker its own members name (the origin
|
|
137
|
+
* ladder over {@link INHERITED_STATION_FACTS} — a rule it matched, a classifier fallback it replays, else the policy). None when
|
|
138
|
+
* the ask has no words, or when its engine record says its words are the engine's generic question for the call
|
|
139
|
+
* (`genericQuestion`, while the ask's sentence is still that one: a write gate's default question, the plan mode's — the
|
|
140
|
+
* call's arguments and the ask's class already say it).
|
|
141
|
+
*/
|
|
142
|
+
export declare function chainAskReasonsOf(receipt: Extract<PermissionResult, {
|
|
143
|
+
action: "ask";
|
|
144
|
+
}>, call: AskOriginFacts["call"]): readonly AskReason[] | undefined;
|
|
145
|
+
/** A received decision with its policy chain's entry stamped ({@link chainAskReasonsOf}) — the gate's two adjudication receipts
|
|
146
|
+
* (the first judgment, an approved edit's re-check), right after the receipt. Not an ask, or no entry ⇒ the decision itself. */
|
|
147
|
+
export declare function withChainAskReasons(d: PermissionResult, call: AskOriginFacts["call"]): PermissionResult;
|
|
148
|
+
/** Two askers' entries in fold order — the standing ask's first, then the one folded over it; absent when neither has any. An
|
|
149
|
+
* entry is minted once, so the same entry reached twice (one ask relayed into the fold over itself) is one asker, listed once. */
|
|
150
|
+
export declare function joinAskReasons(standing: readonly AskReason[] | undefined, folded: readonly AskReason[] | undefined): readonly AskReason[] | undefined;
|
|
151
|
+
/** The `askReasons` member as a request, a carry and a parked row spread it — present ⇔ the ask carries at least one entry. The ONE
|
|
152
|
+
* reader of a surviving ask's entries for the four request mint stations and the park's carry (one value on the card and the row). */
|
|
153
|
+
export declare function askReasonsOf(d: PermissionResult): {
|
|
154
|
+
askReasons?: readonly AskReason[];
|
|
155
|
+
};
|
|
156
|
+
/**
|
|
157
|
+
* The entries as a boundary a host reads back holds them (the parked row): a list of well-formed entries copied fresh, else
|
|
158
|
+
* nothing — the row's twin is written from the gate's carry, but the row is a boundary, so the value is screened where it is
|
|
159
|
+
* published (the screen the row's `origin` and class pair take). A malformed list publishes no entry at all, never a partial one;
|
|
160
|
+
* an entry's members are read as its own data members (an inherited or accessor member is no member).
|
|
161
|
+
*/
|
|
162
|
+
export declare function receiveAskReasons(v: unknown): readonly AskReason[] | undefined;
|
|
84
163
|
/**
|
|
85
164
|
* A compile-time fence: `T` must be `never`. Instantiate it with `Exclude<<closed set>, keyof <table>>`
|
|
86
165
|
* beside a table that is meant to be TOTAL over the set — while every member has a row the argument is
|
package/dist/core/ask-origin.js
CHANGED
|
@@ -1,10 +1,86 @@
|
|
|
1
1
|
import { attestationOf } from "./engine-attestation.js";
|
|
2
2
|
import { isShellFaceToolName } from "./tool-registry.js";
|
|
3
|
+
import { inlineUntrusted } from "./untrusted-text.js";
|
|
3
4
|
export const ASK_ORIGINS = Object.freeze(["content_question", "plan_review", "ancestor_marked", "org_unavailable", "org_rule", "rule_store_unavailable", "hook", "ask_rule", "denial_limit_fallback", "shell_gate_tighten", "safety_tighten", "policy"]);
|
|
4
5
|
const ASK_ORIGIN_SET = new Set(ASK_ORIGINS);
|
|
5
6
|
export function isAskOrigin(v) {
|
|
6
7
|
return ASK_ORIGIN_SET.has(v);
|
|
7
8
|
}
|
|
9
|
+
export const HOOK_QUESTION_CAUSES = Object.freeze(["asked", "verdict_unreadable", "verdict_unfinished"]);
|
|
10
|
+
const HOOK_QUESTION_CAUSE_SET = new Set(HOOK_QUESTION_CAUSES);
|
|
11
|
+
export function isHookQuestionCause(v) {
|
|
12
|
+
return HOOK_QUESTION_CAUSE_SET.has(v);
|
|
13
|
+
}
|
|
14
|
+
export const ASK_REASON_WORDS_MAX = 500;
|
|
15
|
+
export const INHERITED_STATION_FACTS = { contentQuestion: false, markedUnresolvable: false, org: undefined, tightened: undefined, mandateMarks: {} };
|
|
16
|
+
export function hookAskReasonOf(registration, cause, reason) {
|
|
17
|
+
const words = cause === "asked" && reason !== undefined ? inlineUntrusted(reason, ASK_REASON_WORDS_MAX) : undefined;
|
|
18
|
+
return Object.freeze({ by: "hook", ...(registration !== undefined ? { registration } : {}), cause, ...(words !== undefined ? { words } : {}) });
|
|
19
|
+
}
|
|
20
|
+
export function chainAskReasonsOf(receipt, call) {
|
|
21
|
+
const message = receipt.message;
|
|
22
|
+
const record = attestationOf(receipt, call);
|
|
23
|
+
if (record?.receivedAskReasons !== undefined)
|
|
24
|
+
return record.receivedAskReasons.length > 0 ? record.receivedAskReasons : undefined;
|
|
25
|
+
if (message === undefined || message === record?.genericQuestion)
|
|
26
|
+
return undefined;
|
|
27
|
+
const by = askOriginOf(receipt, { ...INHERITED_STATION_FACTS, call });
|
|
28
|
+
const words = inlineUntrusted(message, ASK_REASON_WORDS_MAX);
|
|
29
|
+
return Object.freeze([Object.freeze(by === "hook" ? { by, cause: "asked", words } : { by, words })]);
|
|
30
|
+
}
|
|
31
|
+
export function withChainAskReasons(d, call) {
|
|
32
|
+
if (d.action !== "ask")
|
|
33
|
+
return d;
|
|
34
|
+
const askReasons = chainAskReasonsOf(d, call);
|
|
35
|
+
return askReasons === undefined ? d : { ...d, askReasons };
|
|
36
|
+
}
|
|
37
|
+
export function joinAskReasons(standing, folded) {
|
|
38
|
+
const joined = [...(standing ?? [])];
|
|
39
|
+
for (const e of folded ?? [])
|
|
40
|
+
if (!joined.includes(e))
|
|
41
|
+
joined.push(e);
|
|
42
|
+
return joined.length > 0 ? Object.freeze(joined) : undefined;
|
|
43
|
+
}
|
|
44
|
+
export function askReasonsOf(d) {
|
|
45
|
+
return d.action === "ask" && d.askReasons !== undefined && d.askReasons.length > 0 ? { askReasons: d.askReasons } : {};
|
|
46
|
+
}
|
|
47
|
+
const BAD = Symbol("malformed");
|
|
48
|
+
function ownEntryMember(e, k) {
|
|
49
|
+
const d = Object.getOwnPropertyDescriptor(e, k);
|
|
50
|
+
if (d === undefined)
|
|
51
|
+
return undefined;
|
|
52
|
+
return "value" in d ? d.value : BAD;
|
|
53
|
+
}
|
|
54
|
+
function receivedEntry(e) {
|
|
55
|
+
if (typeof e !== "object" || e === null || Array.isArray(e))
|
|
56
|
+
return undefined;
|
|
57
|
+
const by = ownEntryMember(e, "by");
|
|
58
|
+
const words = ownEntryMember(e, "words");
|
|
59
|
+
if (by === "hook") {
|
|
60
|
+
const cause = ownEntryMember(e, "cause");
|
|
61
|
+
const registration = ownEntryMember(e, "registration");
|
|
62
|
+
if (!isHookQuestionCause(cause) || (registration !== undefined && typeof registration !== "string"))
|
|
63
|
+
return undefined;
|
|
64
|
+
if (words !== undefined && (typeof words !== "string" || cause !== "asked"))
|
|
65
|
+
return undefined;
|
|
66
|
+
return Object.freeze({ by: "hook", ...(registration !== undefined ? { registration } : {}), cause, ...(words !== undefined ? { words } : {}) });
|
|
67
|
+
}
|
|
68
|
+
if (!isAskOrigin(by) || typeof words !== "string")
|
|
69
|
+
return undefined;
|
|
70
|
+
return Object.freeze({ by: by, words });
|
|
71
|
+
}
|
|
72
|
+
export function receiveAskReasons(v) {
|
|
73
|
+
if (!Array.isArray(v) || v.length === 0)
|
|
74
|
+
return undefined;
|
|
75
|
+
const out = [];
|
|
76
|
+
for (let i = 0; i < v.length; i++) {
|
|
77
|
+
const entry = Object.prototype.hasOwnProperty.call(v, i) ? receivedEntry(v[i]) : undefined;
|
|
78
|
+
if (entry === undefined)
|
|
79
|
+
return undefined;
|
|
80
|
+
out.push(entry);
|
|
81
|
+
}
|
|
82
|
+
return Object.freeze(out);
|
|
83
|
+
}
|
|
8
84
|
export function askOriginOf(decision, facts) {
|
|
9
85
|
const origin = originLadder(decision, facts);
|
|
10
86
|
if (ORIGIN_IMPLIES_REAL_APPROVAL[origin] === "at_derivation" && decision.requiresRealApproval !== true) {
|
|
@@ -66,12 +66,16 @@ export interface AskQuestionRequest {
|
|
|
66
66
|
* actually CALLS a question face: the in-tool synchronous call, and the gate's pre-execution content-ask
|
|
67
67
|
* routing. A durable suspend invokes no face at all, so it carries none. */
|
|
68
68
|
readonly principal?: string;
|
|
69
|
-
/** Runner-filled
|
|
70
|
-
* aggregating onQuestion. **worker-unforgeable for Runner-created delegated subagents/team
|
|
71
|
-
* (those child specs do not pass TaskSpec.sessionId — the Runner mints the id); a top-level caller CAN
|
|
72
|
-
* still set `TaskSpec.sessionId`, so this is NOT a globally unforgeable run id (design S1d §1.3).
|
|
73
|
-
* `readonly` + same "only where a face is really called" caveat as `principal`. */
|
|
74
|
-
readonly
|
|
69
|
+
/** Runner-filled: the issuing leg's session id (the conversation the question was raised in), for per-worker
|
|
70
|
+
* attribution by an aggregating onQuestion. **worker-unforgeable for Runner-created delegated subagents/team
|
|
71
|
+
* members** (those child specs do not pass TaskSpec.sessionId — the Runner mints the id); a top-level caller CAN
|
|
72
|
+
* still set `TaskSpec.sessionId`, so this is NOT a globally unforgeable run id (design S1d §1.3). It names a
|
|
73
|
+
* conversation, never a task. `readonly` + same "only where a face is really called" caveat as `principal`. */
|
|
74
|
+
readonly sourceSessionId?: string;
|
|
75
|
+
/** Runner-filled: the issuing leg's task id when that leg is a delegated child — the same value and the same
|
|
76
|
+
* presence as {@link import("./tool-policy.js").AskRequest}.agentId (one mint for both); absent on a host's
|
|
77
|
+
* question. `readonly` + same caveat as `principal`. */
|
|
78
|
+
readonly agentId?: string;
|
|
75
79
|
/**
|
|
76
80
|
* The canonical hash of the tool-call arguments this question was built from, as computed by the
|
|
77
81
|
* engine's one `boundInputHashOf` (the same digest the durable park binds its checkpoint to, so the
|
|
@@ -79,7 +83,7 @@ export interface AskQuestionRequest {
|
|
|
79
83
|
* — a directly-mounted tool calling its own face carries none.
|
|
80
84
|
*
|
|
81
85
|
* The split to keep straight, because the two words are easy to swap:
|
|
82
|
-
* - `(
|
|
86
|
+
* - `(sourceSessionId, toolCallId, boundInputHash)` is the RECONCILIATION key — "is this the same
|
|
83
87
|
* question, on the same call, in the same run?". It is what lets an in-stream delivery be matched
|
|
84
88
|
* against a parked one, and what an audit trail joins on. It is NOT an identity: all three
|
|
85
89
|
* components repeat for two sequential deliveries of an identical question.
|
|
@@ -96,7 +100,7 @@ export interface AskQuestionRequest {
|
|
|
96
100
|
* refused instead of applied to a question nobody is waiting on any more.
|
|
97
101
|
*
|
|
98
102
|
* Why not the tuple you might reach for first: `toolCallId` comes from the model/provider and is not
|
|
99
|
-
* guaranteed unique within a session, `
|
|
103
|
+
* guaranteed unique within a session, `sourceSessionId` can be caller-supplied, and the argument hash
|
|
100
104
|
* is identical for two identical questions. Their combination therefore repeats for two sequential
|
|
101
105
|
* deliveries of the same question — under which a registry would close the second on the first's
|
|
102
106
|
* ticket, or hand the second the first's late answer. That tuple remains the RECONCILIATION key
|
|
@@ -351,15 +355,17 @@ export declare function markBoundOnlyQuestionFace<F extends OnQuestion>(face: F)
|
|
|
351
355
|
* Callers resolve the seat first (`spec.onQuestion ?? deps.onQuestion`) and pass the resolved value.
|
|
352
356
|
*/
|
|
353
357
|
export declare function isLiveQuestionFace(face: unknown): face is OnQuestion;
|
|
358
|
+
/** The issuing leg's members of a question request. */
|
|
359
|
+
export type QuestionSource = Pick<AskQuestionRequest, "principal" | "sourceSessionId" | "agentId">;
|
|
360
|
+
/** The source members a question request carries, each only when present — the mounted tool's call and the gate's routing
|
|
361
|
+
* lane both read the leg's one ask source through this. */
|
|
362
|
+
export declare function questionSourceOf(source: QuestionSource | undefined): QuestionSource;
|
|
354
363
|
/** Build the AskUserQuestion tool. When `onQuestion` is undefined the tool still mounts but returns the
|
|
355
364
|
* headless default (so a run started without a human in the loop never hangs). */
|
|
356
365
|
export declare function createAskUserQuestionTool(onQuestion?: OnQuestion,
|
|
357
366
|
/** design S1d §1.2: Runner-filled source identity, merged into the {@link AskQuestionRequest} so an
|
|
358
|
-
* aggregating onQuestion can attribute per worker/user. Omitted ⇒
|
|
359
|
-
source?:
|
|
360
|
-
principal?: string;
|
|
361
|
-
sourceTaskId?: string;
|
|
362
|
-
}, opts?: AskUserQuestionToolOptions): AgentTool;
|
|
367
|
+
* aggregating onQuestion can attribute per worker/user. Omitted ⇒ the members stay absent (no-op). */
|
|
368
|
+
source?: QuestionSource, opts?: AskUserQuestionToolOptions): AgentTool;
|
|
363
369
|
/**
|
|
364
370
|
* The ONE producer of the "engine stripped the spawn turn's question face" fact. The strip (removing `onQuestion`
|
|
365
371
|
* from a child spec — or from the parent SPEC seat a child is built from — when the child OUTLIVES the request that
|
|
@@ -94,6 +94,13 @@ export function markBoundOnlyQuestionFace(face) {
|
|
|
94
94
|
export function isLiveQuestionFace(face) {
|
|
95
95
|
return typeof face === "function" && face !== QUESTION_AWAITS_RESUME && !boundOnlyQuestionFaces.has(face);
|
|
96
96
|
}
|
|
97
|
+
export function questionSourceOf(source) {
|
|
98
|
+
return {
|
|
99
|
+
...(source?.principal !== undefined ? { principal: source.principal } : {}),
|
|
100
|
+
...(source?.sourceSessionId !== undefined ? { sourceSessionId: source.sourceSessionId } : {}),
|
|
101
|
+
...(source?.agentId !== undefined ? { agentId: source.agentId } : {}),
|
|
102
|
+
};
|
|
103
|
+
}
|
|
97
104
|
export function createAskUserQuestionTool(onQuestion, source, opts) {
|
|
98
105
|
const disclosedSyntheticContinuations = new Set();
|
|
99
106
|
let approvalPostureSpent = false;
|
|
@@ -191,8 +198,7 @@ export function createAskUserQuestionTool(onQuestion, source, opts) {
|
|
|
191
198
|
const outcome = await onQuestion({
|
|
192
199
|
toolCallId: ctx.toolCallId,
|
|
193
200
|
questions,
|
|
194
|
-
|
|
195
|
-
sourceTaskId: source?.sourceTaskId,
|
|
201
|
+
...questionSourceOf(source),
|
|
196
202
|
deliveryId: uuidv7(),
|
|
197
203
|
}, ctx.signal);
|
|
198
204
|
const reading = classifyQuestionOutcome(outcome);
|
|
@@ -140,6 +140,8 @@ export interface MaybeCompactOptions {
|
|
|
140
140
|
/** The session to compact. Typed on the INTERFACE face (typecheck 车 2026-07-24): every member this
|
|
141
141
|
* module touches lives on `Session` (the optional `getPromptEpoch` degrades honestly via `?.()`). */
|
|
142
142
|
session: Session;
|
|
143
|
+
/** The leg's admission seat (`session.append`): a row this pass adds to the transcript passes it first. Absent ⇒ as made. */
|
|
144
|
+
admitRows?: import("../internal/harness.js").RowAdmission;
|
|
143
145
|
/** This run's prompt identity inputs (and the pinned center layer's provenance): the compaction restates the
|
|
144
146
|
* session's epoch when the identity is unchanged and advances it otherwise — the same identity the prepare-time
|
|
145
147
|
* record names, so a compaction never flaps the record. Absent ⇒ no restatement (a host compacting outside a run). */
|
|
@@ -8,6 +8,7 @@ import { brainToRuntime } from "./runtime.js";
|
|
|
8
8
|
import { defuseFenceMarkers, sanitizeUntrustedText } from "./untrusted-text.js";
|
|
9
9
|
import { createSafeNotifier, observeThenableRejection } from "./safe-notify.js";
|
|
10
10
|
import { thrownText } from "./thrown-value.js";
|
|
11
|
+
import { appendAdmittedRow } from "./row-admission.js";
|
|
11
12
|
import { egressThrownText } from "./untrusted-egress.js";
|
|
12
13
|
export const DEFAULT_COMPACTION_INSTRUCTIONS = "Preserve verbatim every code, identifier, name, number, file path, error message, credential " +
|
|
13
14
|
"reference, and explicit user instruction or decision mentioned anywhere in the conversation. " +
|
|
@@ -493,7 +494,7 @@ export async function maybeCompact(opts) {
|
|
|
493
494
|
const delivered = [];
|
|
494
495
|
for (const f of restoreFrames) {
|
|
495
496
|
try {
|
|
496
|
-
await opts.session
|
|
497
|
+
await appendAdmittedRow(opts.admitRows, opts.session, { role: "user", content: [...f.seed.content], timestamp: Date.now(), provenance: "engine-note", attachment: f.seed.attachment });
|
|
497
498
|
delivered.push(f);
|
|
498
499
|
}
|
|
499
500
|
catch (err) {
|
|
@@ -16,6 +16,14 @@ export declare const AUTO_MODE_DEFAULT_TIMEOUT_MS = 180000;
|
|
|
16
16
|
* would only make the person wait out the rung's budget and hear "timed out" for a failure that was not one.
|
|
17
17
|
*/
|
|
18
18
|
export declare const AUTO_MODE_CLASSIFIER_MAX_RETRIES = 4;
|
|
19
|
+
/**
|
|
20
|
+
* How many CONSECUTIVE classifications must end on a rung's rate limit (an HTTP 429 that outlived the brain's own
|
|
21
|
+
* {@link AUTO_MODE_CLASSIFIER_MAX_RETRIES} backoffs) before that rung is not asked again for the rest of the run, when
|
|
22
|
+
* `RunnerDeps.autoMode.rateLimitBreakAfter` is omitted. Each such classification has already slept the whole
|
|
23
|
+
* backoff ladder, so the number is the wall time a rate-limited seat may still cost before the walk starts behind it:
|
|
24
|
+
* three, the same count the denial limit hands a run to a person after.
|
|
25
|
+
*/
|
|
26
|
+
export declare const AUTO_MODE_RATE_LIMIT_BREAK_AFTER_DEFAULT = 3;
|
|
19
27
|
/**
|
|
20
28
|
* What an arming RECORDING that carries no `timeoutMs` meant when it was written: the default of its day. Every
|
|
21
29
|
* recipe minted since the deadline moved to 60 s MATERIALISES its bound, so an absent recorded knob dates the
|