@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
|
@@ -17,7 +17,7 @@ import type { HumanReviewGateRow } from "../task-result.js";
|
|
|
17
17
|
import type { RepairBundle } from "../../agents/repair-loop.js";
|
|
18
18
|
import type { SubagentRetainLedger } from "../../agents/retain-ledger.js";
|
|
19
19
|
import type { BrainCallGuardrailRef } from "../../brain/timeout.js";
|
|
20
|
-
import type { ActiveWorktreeSession, AgentHarness, AgentMessage, AgentTool, AnnouncedListingSnapshotInput, ExecutionEnv, ThinkingLevel } from "../../internal/harness.js";
|
|
20
|
+
import type { ActiveWorktreeSession, AgentHarness, AgentMessage, AgentTool, AnnouncedListingSnapshotInput, ExecutionEnv, LoopTerminalReason, RowAdmission, ThinkingLevel } from "../../internal/harness.js";
|
|
21
21
|
import type { Model } from "../../internal/llm.js";
|
|
22
22
|
import type { WorkflowSizeGuideline } from "../../orchestration/workflow-size-guideline.js";
|
|
23
23
|
import type { ToolManifestRow } from "../../prompt-assembly/tool-catalog.js";
|
|
@@ -37,7 +37,7 @@ import type { Checkpoint, CheckpointState, CheckpointStore, CheckpointToken, Pen
|
|
|
37
37
|
import type { ExecutionOutcomeRecordWord } from "../checkpoint-execution-record.js";
|
|
38
38
|
import type { ClearedProjectionLedger, MicroCompactMachine, OccurrenceIndex } from "../context-edit.js";
|
|
39
39
|
import type { ModBus } from "../mods/kernel/index.js";
|
|
40
|
-
import type { LegModBus, LegMods
|
|
40
|
+
import type { LegModBus, LegMods } from "../mods/stations.js";
|
|
41
41
|
import type { HookInvocationIdentity, OrgGateVerdict, PermissionDeniedPayload, PostToolBatchCall, ToolGateInput } from "../hooks.js";
|
|
42
42
|
import type { MaterializedMcp } from "../mcp.js";
|
|
43
43
|
import type { MemoryEngine } from "../memory-engine/engine.js";
|
|
@@ -52,7 +52,7 @@ import type { ModelPricing } from "../pricing.js";
|
|
|
52
52
|
import type { PushQueue } from "../push-queue.js";
|
|
53
53
|
import type { SystemInjectionPriority, TaskNotificationPayload } from "../task-notification.js";
|
|
54
54
|
import type { OnAsk, PermissionResult, ResolvedAsk, ToolCallRequest, ToolPolicy } from "../tool-policy.js";
|
|
55
|
-
import type { RemoteExecutionEnv, SnapshotId, WorkspaceHandle } from "../remote-env.js";
|
|
55
|
+
import type { PlacementTarget, RemoteExecutionEnv, SnapshotId, WorkspaceHandle } from "../remote-env.js";
|
|
56
56
|
import type { ToolDisclosureManifest } from "../trace.js";
|
|
57
57
|
import type { AgentDefinition, Brain, CompactOutcome, ModelRef, ModelRoles, NestedUsageAccum, PermissionMode, RunnerDeps, ShellGateDoctrine, TaskEvent, TaskEventIdentity, TaskResult, TaskSpec, TaskStream, ToolActivity, ToolEffect } from "../types.js";
|
|
58
58
|
import type { InheritedAutoModeFace, PermissionModeController } from "../mode-policy.js";
|
|
@@ -271,6 +271,9 @@ export interface Prepared {
|
|
|
271
271
|
* the `Session` contract instead. */
|
|
272
272
|
session: StoredSession;
|
|
273
273
|
sessionId: string;
|
|
274
|
+
/** This leg's task id, minted ONCE at prepare ({@link import("../leg-identity.js").legTaskIdOf}): its identity, frames, events'
|
|
275
|
+
* `sourceTaskId`, trace frames and `TaskResult.taskId` read it here; none re-spells it. */
|
|
276
|
+
taskId: string;
|
|
274
277
|
/**
|
|
275
278
|
* THIS INVOCATION's own identity, minted once at the top of {@link prepareTask} and never
|
|
276
279
|
* rewritten. The third id of the trio, and the only one the engine owns outright:
|
|
@@ -278,7 +281,7 @@ export interface Prepared {
|
|
|
278
281
|
* - `sessionId` — the CONVERSATION's identity (shared by every run that continues it);
|
|
279
282
|
* - `runId` — THIS call of the engine.
|
|
280
283
|
*
|
|
281
|
-
* The gap it closes: the
|
|
284
|
+
* The gap it closes: the leg's task id ({@link taskId}) answers the same value for
|
|
282
285
|
* two runs of one session whenever the host supplies no task id, so every per-run account keyed on
|
|
283
286
|
* it FOLDED two runs into one row (two runs each losing one steer read as one run losing one).
|
|
284
287
|
* A per-run account must key on this; a per-TASK fact (trace `taskId`, the host's own correlation
|
|
@@ -293,7 +296,7 @@ export interface Prepared {
|
|
|
293
296
|
runId: string;
|
|
294
297
|
/** The deployment's host floor as the config doors compiled it (absent ⇒ none declared) — the task images' guard reads it. */
|
|
295
298
|
hostFloor?: import("../host-floor.js").HostFloor;
|
|
296
|
-
/** The (owner, scope) key this run's registry-facing tools register rows under — (
|
|
299
|
+
/** The (owner, scope) key this run's registry-facing tools register rows under — ({@link taskId}, mount domain), minted once at prepare; the teardown sweeps read it and never re-derive it. */
|
|
297
300
|
registryAccess: {
|
|
298
301
|
readonly owner: string;
|
|
299
302
|
readonly scope: string;
|
|
@@ -363,8 +366,10 @@ export interface Prepared {
|
|
|
363
366
|
*/
|
|
364
367
|
toolOccurrences: import("./tool-occurrence.js").ToolOccurrenceTable;
|
|
365
368
|
/**
|
|
366
|
-
* The parent-thread human-rejection halt fact (see `
|
|
367
|
-
* moment a bare human rejection halts the turn's batch
|
|
369
|
+
* The parent-thread human-rejection halt fact (see `isBareHumanRefusal`): present from the
|
|
370
|
+
* moment a bare human rejection halts the turn's batch — or a resumed leg records one (a parked call's, a plan
|
|
371
|
+
* pause's; `rejectedToolCallId` then names the gated call, or the call that asked for the plan pause when the row
|
|
372
|
+
* recorded one) — until the run ends or the NEXT provider
|
|
368
373
|
* request begins (user input continuing the run clears it). Consumers: the runner's stop gate
|
|
369
374
|
* (suppress natural-end pushback / final-verify injection — engine continuations must not restart
|
|
370
375
|
* a run a person just stopped), the turn-boundary engine steers (same reason), and the result
|
|
@@ -373,7 +378,7 @@ export interface Prepared {
|
|
|
373
378
|
*/
|
|
374
379
|
batchHaltRef: {
|
|
375
380
|
current?: {
|
|
376
|
-
rejectedToolCallId
|
|
381
|
+
rejectedToolCallId?: string;
|
|
377
382
|
};
|
|
378
383
|
};
|
|
379
384
|
/** Summed usage of nested sub-runs (sub-agents) spawned by this task's tools. */
|
|
@@ -406,6 +411,9 @@ export interface Prepared {
|
|
|
406
411
|
* states are their own values); the seat is optional only so a Prepared shape without the phase
|
|
407
412
|
* cannot fabricate one. */
|
|
408
413
|
effectiveMemoryScopes?: import("../types.js").EffectiveMemoryScopes;
|
|
414
|
+
/** The leg's placement fixed point as prepare resolved it ONCE — the value the env-factory ctx was minted with and the suspend
|
|
415
|
+
* stamp records — echoed on `TaskResult.placementRoot`. Absent when the resolution came out empty (`""` is absence). */
|
|
416
|
+
placementRoot?: string;
|
|
409
417
|
/** The per-task logical cwd ref when a real shell is mounted (else undefined); the workspace frame reads it. */
|
|
410
418
|
cwdRef?: CwdRef;
|
|
411
419
|
/** The leg's `workspace_changed` seat (its one snapshot projection): the run binds the sink after `wiring_manifest` (the leg-start frame) and observes after each tool. */
|
|
@@ -474,7 +482,6 @@ export interface Prepared {
|
|
|
474
482
|
readonly refused: string;
|
|
475
483
|
readonly extension?: string;
|
|
476
484
|
} | {
|
|
477
|
-
readonly args: unknown;
|
|
478
485
|
readonly admit: () => void;
|
|
479
486
|
}>;
|
|
480
487
|
/** The leg's `tool.call` station (`mods/tool-call.ts`) — every execution of a call passes it; absent when no handler hangs on the event. */
|
|
@@ -548,6 +555,19 @@ export interface Prepared {
|
|
|
548
555
|
hookIdentity: HookInvocationIdentity;
|
|
549
556
|
/** The leg's mods bus: one per leg, admitted at this leg's prepare (both seats, `plugin.register` run once for this leg). Every classic station raises its event on it; its `records` are the manifest's `mods[]`. */
|
|
550
557
|
modBus: ModBus;
|
|
558
|
+
/** The leg's one admission seat (`session-append.ts`): a direct writer passes each row through it first (`appendAdmittedRow`). */
|
|
559
|
+
admitRows: RowAdmission;
|
|
560
|
+
/** The leg's one receiving station (`session-receive.ts`): the live lane, the turn-open redelivery and the box drain's pull
|
|
561
|
+
* hand every frame to it before the model reads it. */
|
|
562
|
+
receiveSeat: import("../task-notification.js").FrameReceiver;
|
|
563
|
+
/** The turn-open redelivery's hand-over while the receiving station judges it (set only when a handler listens and frames
|
|
564
|
+
* were parked): the leg's prompt waits on it, so what the station hands over is in the first model call. */
|
|
565
|
+
turnOpenRedelivery: {
|
|
566
|
+
current?: Promise<void>;
|
|
567
|
+
};
|
|
568
|
+
/** The leg's `session.compact` station and its `$.session.compact` window (`session-compact.ts`): every compaction lane runs
|
|
569
|
+
* its pass through it. */
|
|
570
|
+
compactStation: import("../mods/session-compact.js").CompactStation;
|
|
551
571
|
/**
|
|
552
572
|
* This session's DURABLE box, present iff this leg mounted the session-box drain (a top-level leg
|
|
553
573
|
* over a cross-process-safe mailbox with a grammatical session id). The notification lane binds it
|
|
@@ -570,6 +590,8 @@ export interface Prepared {
|
|
|
570
590
|
/** The pending commits of this leg's attachment frames, settled by the transcript-append receipt sink — the one place
|
|
571
591
|
* an attachment's read effects are applied. Always present. */
|
|
572
592
|
attachmentDelivery: import("../user-attachment.js").AttachmentDelivery;
|
|
593
|
+
/** The run's once-per-run account of an image sent unprocessed over the soft target — the tool-result seat's and the leg's (task images, attachments). */
|
|
594
|
+
imageUnprocessed: (bytes: number) => void;
|
|
573
595
|
/** The leg's one file reader — the Read tool's own (one read state, one set of disclosure windows and counters),
|
|
574
596
|
* handed to the leg's other carriers of a file. Present iff hands are mounted. */
|
|
575
597
|
modelFileReader?: import("../../tools/fs/fs-read.js").ModelFileReader;
|
|
@@ -862,6 +884,11 @@ export interface Prepared {
|
|
|
862
884
|
continuation: boolean;
|
|
863
885
|
abortedBeforeTurnEnd: boolean;
|
|
864
886
|
};
|
|
887
|
+
/** The word the loop's exit named (its terminal trace step; absent until it exits), read by the terminal arbitration
|
|
888
|
+
* (`ResultFlags.loopTerminal`) for the exits the final message cannot state. Always present. */
|
|
889
|
+
loopTerminalRef: {
|
|
890
|
+
reason?: LoopTerminalReason;
|
|
891
|
+
};
|
|
865
892
|
/** Records the FIRST brain call this run's outer guardrail gave up on (see
|
|
866
893
|
* {@link import("../../brain/timeout.js").withBrainCallGuardrail}). Always present; `timedOut`
|
|
867
894
|
* stays absent unless the guardrail fired. The run loop reads it AFTER the loop settles and gives
|
|
@@ -958,7 +985,7 @@ export interface Prepared {
|
|
|
958
985
|
* · protocol-tools — pushes the MCP tools (through the remote wrapper), RefreshMcpTools (servers declared),
|
|
959
986
|
* the A2A tools; at RUN time its refresh closure splices a server's name-prefix domain out and back in;
|
|
960
987
|
* · hands mount — pushes the hands band (env wired);
|
|
961
|
-
* · delegation-surface — pushes
|
|
988
|
+
* · delegation-surface — pushes TaskStop (background ∨ workflow door), SendMessage (door ∨
|
|
962
989
|
* parentNotify ∨ peer lane, ∧ runner self ∧ no shadow), AgentTranscript (door ∧ runner self ∧ no shadow),
|
|
963
990
|
* ListAgents (peer lane ∧ built-in SendMessage ∧ mountable), Monitor (background), EnterWorktree +
|
|
964
991
|
* ExitWorktree (tracked cwd), ReadToolResult (offload store);
|
|
@@ -1219,15 +1246,23 @@ export interface Prepared {
|
|
|
1219
1246
|
/** The posture composition's run-local half (the newest carrier's protection slot; the row last composed for). */
|
|
1220
1247
|
postureFrameRef: import("../auto-mode-directive.js").PostureFrameRef;
|
|
1221
1248
|
/** G1 通告层 — narrow getter over the process task registry: THIS run's visible live background tasks
|
|
1222
|
-
* (pending / running / parked under the same owner/scope/session identity the
|
|
1223
|
-
*
|
|
1224
|
-
* handles/env/abort). Read by the post-compact listing (which caps what it
|
|
1225
|
-
* diff and the stop hook's `backgroundTasks` view.
|
|
1226
|
-
|
|
1249
|
+
* (pending / running / parked under the same owner/scope/session identity the TaskStop tool
|
|
1250
|
+
* uses), EVERY one (`TaskRegistry.liveTasks`), as a projection (id/description/status and the row's read handle,
|
|
1251
|
+
* `TaskRegistry.readHandleOf` — never handles/env/abort). Read by the post-compact listing (which caps what it
|
|
1252
|
+
* renders), the resume's orphan diff and the stop hook's `backgroundTasks` view. `{ settled: true }` = the same rows with
|
|
1253
|
+
* the finished ones too (`TaskRegistry.list`) — the whole-session notification loss's table, where a finished task's
|
|
1254
|
+
* lost frame is the likeliest loss and its read handle the one way back. */
|
|
1255
|
+
listBackgroundTasks: (opts?: {
|
|
1256
|
+
settled?: true;
|
|
1257
|
+
}) => Array<{
|
|
1227
1258
|
id: string;
|
|
1228
1259
|
description?: string;
|
|
1229
1260
|
status: string;
|
|
1261
|
+
read?: string;
|
|
1230
1262
|
}>;
|
|
1263
|
+
/** One task's read handle under the same identity (`TaskRegistry.readHandleOf`) — a live or terminal row this leg reaches;
|
|
1264
|
+
* `undefined` for an unreachable id or a row with nothing to read. Read by a dropped notification's disclosure line. */
|
|
1265
|
+
taskReadHandleOf: (taskId: string) => string | undefined;
|
|
1231
1266
|
/** The parent-run subagent-retain ledger (present ONLY when `spec.retainSubagentSessions`
|
|
1232
1267
|
* is enabled). The Runner disposes it (abort in-flight resumes + unpin + release every retained child
|
|
1233
1268
|
* session) in the task's terminal `finally` — same UNCONDITIONAL posture as the background-agent reap:
|
|
@@ -1305,6 +1340,9 @@ export interface PrepareResume {
|
|
|
1305
1340
|
/** The session leaf to rewind to (the suspension point) BEFORE reconcile — discards the abort's
|
|
1306
1341
|
* off-branch "Operation aborted" writes so the resume engine resolves the pending batch cleanly. */
|
|
1307
1342
|
leafId: string;
|
|
1343
|
+
/** The session rows the parked leg's port held past that leaf (`Checkpoint.heldRows`): the resumed harness's queue starts with
|
|
1344
|
+
* them and writes them at the transcript's first legal point. Absent ⇒ the park held none. */
|
|
1345
|
+
heldRows?: readonly AgentMessage[];
|
|
1308
1346
|
/** Batch tool-call ids of the suspended turn — wake-reconcile SKIPS these (they are resumed, not
|
|
1309
1347
|
* crash-interrupted; closing them with `[INTERRUPTED]` would DESTROY the suspended batch, §15.2 #7). */
|
|
1310
1348
|
suspendedBatch: ReadonlySet<string>;
|
|
@@ -1374,13 +1412,15 @@ export interface PrepareResume {
|
|
|
1374
1412
|
* (`"always"`): a child inherits it and cannot lift it. `permissionMode` is the ceiling a child's own
|
|
1375
1413
|
* declaration is clamped under.
|
|
1376
1414
|
* - **Opaque half** (`parentConstraints`): each ancestor's live caller `ToolPolicy` plus its FROZEN
|
|
1377
|
-
* `onAsk`, ancestors first — and, for a
|
|
1378
|
-
*
|
|
1379
|
-
*
|
|
1380
|
-
*
|
|
1381
|
-
*
|
|
1382
|
-
*
|
|
1383
|
-
*
|
|
1415
|
+
* `onAsk`, ancestors first — and, for a mods-wired ancestor, a SECOND entry: its installation (the bus
|
|
1416
|
+
* its admission mounted, `installation`), carrying its own frozen approver/mandate/env axes. A caller
|
|
1417
|
+
* policy is folded AFTER the child's own caller policy and BEFORE the trailing deny-narrowing re-check,
|
|
1418
|
+
* each wrapper resolving its own `ask` via the ancestor's frozen approver — so a parent `ask` never
|
|
1419
|
+
* widens into a child auto-allow, and a parent `allow{updatedInput}` rewrite is still re-checked by the
|
|
1420
|
+
* child's narrowing layers. An installation judges the child's calls at the child's gate, on the
|
|
1421
|
+
* installation's own bus (`classic.PreToolUse` at phase 1, `tool.check` at the verdict read), its
|
|
1422
|
+
* question settled under the same frozen axes. NOT serializable: a durable resume must re-supply it via
|
|
1423
|
+
* `resumeStream(..., internals)` (see {@link CheckpointState.inheritedGate}).
|
|
1384
1424
|
*
|
|
1385
1425
|
* Chain assembly is single-sited in prepareTask's ctx injection (`inheritedGateForChildren`): upstream
|
|
1386
1426
|
* chain + THIS task's own contribution (its session-rule snapshot, its RESOLVED caller policy —
|
|
@@ -1489,9 +1529,18 @@ export interface InheritedGate extends InheritedAutoModeFace {
|
|
|
1489
1529
|
* same frozen `onAsk` — no mandate). It is a CONSERVATIVE descendant-side mandate: whether or not a given ask would actually
|
|
1490
1530
|
* have parked at the ancestor (the regime may be scoped), the durable-park semantics cannot be
|
|
1491
1531
|
* reconstructed in a delegated child's context — so a wrapper seeing `ask` under this flag denies
|
|
1492
|
-
* fail-closed (tighten-only holds) instead of resolving synchronously.
|
|
1493
|
-
|
|
1532
|
+
* fail-closed (tighten-only holds) instead of resolving synchronously.
|
|
1533
|
+
*
|
|
1534
|
+
* Each entry is exactly ONE of two kinds: a caller policy (`policy`), or a screening installation
|
|
1535
|
+
* (`installation` — the bus a leg's admission mounted, or {@link import("../mods/stations.js").admitModChain}'s on a
|
|
1536
|
+
* cross-process re-supply). A chain naming both, neither, or an installation no engine admission mounted is refused. */
|
|
1537
|
+
parentConstraints?: ReadonlyArray<({
|
|
1494
1538
|
policy: ToolPolicy;
|
|
1539
|
+
installation?: undefined;
|
|
1540
|
+
} | {
|
|
1541
|
+
installation: LegModBus;
|
|
1542
|
+
policy?: undefined;
|
|
1543
|
+
}) & {
|
|
1495
1544
|
onAsk?: OnAsk;
|
|
1496
1545
|
durableMandate?: boolean;
|
|
1497
1546
|
/** The CONTENT-ask twin of `durableMandate`, frozen from the QUESTION seat (`spec.onQuestion ??
|
|
@@ -1543,26 +1592,14 @@ export interface InheritedGate extends InheritedAutoModeFace {
|
|
|
1543
1592
|
};
|
|
1544
1593
|
};
|
|
1545
1594
|
/**
|
|
1546
|
-
*
|
|
1547
|
-
* `classic.PreToolUse`
|
|
1548
|
-
*
|
|
1549
|
-
*
|
|
1550
|
-
*
|
|
1551
|
-
*
|
|
1552
|
-
*
|
|
1553
|
-
*
|
|
1554
|
-
* The identity (`sameInstallation`) is that chain plus the context the entry's questions are settled in — the frozen
|
|
1555
|
-
* approver, the two durable mandates, the environment, the classifier instance — and it is the CONSERVATIVE test:
|
|
1556
|
-
* two chains over the same registrations in a different order, or a re-built registration object, compare unequal,
|
|
1557
|
-
* and a bus no engine admission mounted is no leg's installation. Chain assembly does not re-append a leg already on
|
|
1558
|
-
* the chain; a descendant's own gate stands in for an entry only when that identity holds under no mandate (the
|
|
1559
|
-
* pass-through of its `classic.PreToolUse`, the skip of its `tool.check`); any other entry is judged on both events
|
|
1560
|
-
* under its own context — judged twice rather than skipped, never toward a missed one.
|
|
1561
|
-
*/
|
|
1562
|
-
mods?: readonly ModChainLink[];
|
|
1563
|
-
/**
|
|
1564
|
-
* The environment this screening face was installed against — the source of the `HookEnvCapabilities`
|
|
1565
|
-
* handed to it, compared BY REFERENCE, `undefined` when the installation had no env face. Part of the
|
|
1595
|
+
* The environment this installation was installed against — the source of the `HookEnvCapabilities` face its
|
|
1596
|
+
* `classic.PreToolUse` e carries (`env`), compared BY REFERENCE, `undefined` when the installation had no env. The
|
|
1597
|
+
* installation identity (`sameInstallation`) is the chain its bus's admission recorded plus the context its questions are
|
|
1598
|
+
* settled in — the frozen approver, the two durable mandates, this environment, the classifier instance — the
|
|
1599
|
+
* CONSERVATIVE test: two chains over the same registrations in a different order, or a re-built registration object,
|
|
1600
|
+
* compare unequal. Chain assembly does not re-append a leg already on the chain; a descendant's own gate stands in for an
|
|
1601
|
+
* installation only when that identity holds under no mandate; any other is judged on both events under its own context
|
|
1602
|
+
* — judged twice rather than skipped, never toward a missed one. Part of the
|
|
1566
1603
|
* installation's identity for the same reason the frozen approver is (HIGH): a face that
|
|
1567
1604
|
* resolves paths through `ctx.env` answers a different question in a different environment, so an
|
|
1568
1605
|
* ancestor running against the deployment's tree and a descendant running in an isolated worktree are
|
|
@@ -1634,6 +1671,11 @@ export interface RunInternals {
|
|
|
1634
1671
|
* releases the lease when its materialization is disposed — see `mcp-connection-pool.ts`. Trusted, never a TaskSpec field.
|
|
1635
1672
|
*/
|
|
1636
1673
|
mcpPool?: import("../mcp-connection-pool.js").McpConnectionPool;
|
|
1674
|
+
/** This leg's host seats by declaration name: a `{ kind: "host" }` server of `TaskSpec.mcp` / `ResumeTaskConfig.mcp` dials through the
|
|
1675
|
+
* pipe its seat opens for each dial (mcp-host-seat.ts; a request-level seat rides `hostSeatOfRequests`); a declaration with no seat fails its dial (`config.mcp_host_seat_missing`), a seat with no declaration is
|
|
1676
|
+
* announced once (`config.mcp_host_seat_undeclared`). The leg's own: a delegated child is handed the seats of the host servers it
|
|
1677
|
+
* is declared (inherited or its definition's own), a retained child's snapshot keeps none (its waker's seats ride each wake). Trusted, never a TaskSpec field. */
|
|
1678
|
+
mcpHostSeats?: ReadonlyMap<string, import("../mcp-host-seat.js").McpHostSeat>;
|
|
1637
1679
|
/**
|
|
1638
1680
|
* The tool-selector layers of the run that spawned this leg — its ceiling ({@link ToolFaceSnapshot.selector}`.layers`): this
|
|
1639
1681
|
* leg's selector is these layers plus its own `allowTools` / `excludeTools`, so nothing a child names can widen what its
|
|
@@ -1839,10 +1881,10 @@ export interface RunInternals {
|
|
|
1839
1881
|
* mirroring `insideFork`.
|
|
1840
1882
|
*/
|
|
1841
1883
|
isDelegatedChild?: boolean;
|
|
1842
|
-
/**
|
|
1843
|
-
*
|
|
1844
|
-
*
|
|
1845
|
-
|
|
1884
|
+
/** Who wrote this leg's objective ({@link import("../input-author.js").InputAuthor}), stated by the seat that mints it; absent = the public
|
|
1885
|
+
* entry's caller, `operator`. Only the operator's objective passes `classic.UserPromptSubmit`; a non-member reads `unknown`, is screened and
|
|
1886
|
+
* reported once (`onError`, `"config"`). Never inherited — each seat says its own. TRUSTED run-scoped channel (NOT a {@link TaskSpec} field). */
|
|
1887
|
+
objectiveAuthor?: import("../input-author.js").InputAuthor;
|
|
1846
1888
|
/**
|
|
1847
1889
|
* Subagent transcript persistence — the child transcript session's PLACEMENT declaration, minted
|
|
1848
1890
|
* by the background delegation lane (the trusted spawner: it knows the a* handle, scope and root)
|
|
@@ -1900,7 +1942,7 @@ export interface RunInternals {
|
|
|
1900
1942
|
*/
|
|
1901
1943
|
inheritedSkillGrants?: readonly SkillGrantRecord[];
|
|
1902
1944
|
/** The parent's request allow entries at the spawn (`ctx.activeRequestAllowedTools()`), seeded as this child's own request rows until it ends — the channel of {@link inheritedSkillGrants}. */
|
|
1903
|
-
inheritedAllowedTools?: readonly
|
|
1945
|
+
inheritedAllowedTools?: readonly import("../allow-entry.js").AllowListEntry[];
|
|
1904
1946
|
/**
|
|
1905
1947
|
* When this task runs as a SUB-AGENT spawned under a parent task's
|
|
1906
1948
|
* tool call, the spawning tool's `ToolExecuteContext.toolCallId`. The Runner stamps it onto this task's
|
|
@@ -1948,6 +1990,10 @@ export interface RunInternals {
|
|
|
1948
1990
|
/** The spawning run's sessionId (paired with parentTaskId; see
|
|
1949
1991
|
* ToolExecuteContext.parentSessionId). */
|
|
1950
1992
|
parentSessionId?: string;
|
|
1993
|
+
/** The registry row this leg runs as (a background child's `a…` handle, the id `TaskStop` / `SendMessage` take), which the leg's
|
|
1994
|
+
* one task-id mint reads first. Set by the background lanes (plain, fork, retained snapshot); absent on a top-level run, a
|
|
1995
|
+
* synchronous child and a workflow agent. Stamped as `CheckpointState.rowTaskId`. Trusted seat, NOT a {@link TaskSpec} field. */
|
|
1996
|
+
rowTaskId?: string;
|
|
1951
1997
|
/**
|
|
1952
1998
|
* The memory-capture opt-out FLOOR: TRUE ⇔ the spawning session was under an
|
|
1953
1999
|
* opt-out when this child spawned. The child then runs opted-out itself (its prepare mints its
|
|
@@ -2032,9 +2078,27 @@ export interface RunInternals {
|
|
|
2032
2078
|
* `resume.placement_mismatch`). TRUSTED run-scoped channel (never a {@link TaskSpec} field).
|
|
2033
2079
|
*/
|
|
2034
2080
|
placementRoot?: string;
|
|
2081
|
+
/** The placement FENCE this leg is minted under: the target of the leg that hands it work (a spawner, a waker, a composition's
|
|
2082
|
+
* first leg), folded at the mint into {@link import("../remote-env.js").ExecutionEnvFactoryContext.placementTarget} — whose
|
|
2083
|
+
* contract lists every producer; one hop, re-read at every leg (unlike the tree's fixed point {@link placementRoot}). An
|
|
2084
|
+
* unreadable value is refused at the mint (`config.placement_not_honored`). TRUSTED run-scoped channel (never a {@link TaskSpec} field). */
|
|
2085
|
+
placementTarget?: PlacementTarget;
|
|
2086
|
+
/**
|
|
2087
|
+
* Which composition this leg is a leg of, and whose run it belongs to ({@link CompositionLeg}): minted ONLY by a composition
|
|
2088
|
+
* entry when it hands the leg out (`runCascade` / `resumeCascade` for each rung, the verification gate for each verifier leg),
|
|
2089
|
+
* never by the engine. The suspend mint stamps it on the row as `CheckpointState.compositionLeg`, so a card a leg parks says
|
|
2090
|
+
* itself which leg of which composition it is and which host session it belongs to; one value, read ONCE at prepare (the live
|
|
2091
|
+
* member, else the row's; an `entry` outside the closed set is refused there, `config.invalid_argument`). On a resume the same rule as the
|
|
2092
|
+
* placement fixed point: a live value wins, a live value that CONTRADICTS the row's is refused pre-CAS
|
|
2093
|
+
* (`resume.composition_mismatch`, the row stays pending), an absent one is restored from the row — and a live value over a row
|
|
2094
|
+
* that records none (a card minted before the member, or by a leg nobody labelled) is that row's first record, never refused.
|
|
2095
|
+
* Not threaded to the leg's children: a child is not a rung, its card is filed by its own lane. TRUSTED run-scoped channel
|
|
2096
|
+
* (never a {@link TaskSpec} field).
|
|
2097
|
+
*/
|
|
2098
|
+
compositionLeg?: CompositionLeg;
|
|
2035
2099
|
/**
|
|
2036
2100
|
* The REGISTRY SCOPE this run's own background row lives in: the domain its registry-facing
|
|
2037
|
-
* tools (
|
|
2101
|
+
* tools (TaskStop / SendMessage / AgentTranscript / Monitor, and the announce listing)
|
|
2038
2102
|
* must mount in to see it. Filled by the delegation tool at spawn, which is the party that CHOSE the
|
|
2039
2103
|
* domain when it registered the row — `ctx.principal` when the spawning run has one, else the
|
|
2040
2104
|
* delegation mount's declared `background.scope`, and on a revival the claimed row's own scope.
|
|
@@ -2103,6 +2167,9 @@ export interface RunInternals {
|
|
|
2103
2167
|
* per run" true across the lanes that forward. A caller value is overridden like the refs beside it;
|
|
2104
2168
|
* absent ⇒ the door mints a per-object one, so containment never depends on the threading. */
|
|
2105
2169
|
forwardScope?: import("./forward-sink.js").ForwardSinkScope;
|
|
2170
|
+
/** The door's receipt of this leg's `mcp` / `a2a` declarations — ENGINE-owned, taken by `Runner.runTaskStream` at the call for every
|
|
2171
|
+
* leg (a caller value is overridden): the leg's door judges this copy, and the references it names are what the leg holds (peer-seat.ts). */
|
|
2172
|
+
receivedPeers?: import("../locked-config.js").ReceivedPeerDeclarations;
|
|
2106
2173
|
/**
|
|
2107
2174
|
* The Runner's per-session read-file-state seats (CC parity: readFileState is
|
|
2108
2175
|
* session-scoped). Always set by the Runner's own prepare call (overriding any caller value, like
|
|
@@ -2249,7 +2316,7 @@ export interface RunInternals {
|
|
|
2249
2316
|
* the tool ctx as {@link ToolExecuteContext.onSubagentSpawn} and recursively down the delegation
|
|
2250
2317
|
* tree. Absent ⇒ children run non-steerable (prior behavior, zero overhead).
|
|
2251
2318
|
* SCOPE: only SYNC delegations emit a handle — a
|
|
2252
|
-
* `run_in_background` child does not (
|
|
2319
|
+
* `run_in_background` child does not (its completion notification carries the result; TaskStop stops it); wiring the background
|
|
2253
2320
|
* lane is a recorded follow-up, not an oversight a deployment should discover at runtime.
|
|
2254
2321
|
*/
|
|
2255
2322
|
onSubagentSpawn?: (handle: import("../../agents/subagent.js").SubagentSteerHandle) => void;
|
|
@@ -2349,14 +2416,17 @@ export interface ResolvedWorkspace {
|
|
|
2349
2416
|
cwd: string;
|
|
2350
2417
|
/** True only for an accepted `isolation: "worktree"` request (⇒ `cwd` is this agent's own worktree). */
|
|
2351
2418
|
isolated: boolean;
|
|
2352
|
-
/** True when the task's execution env
|
|
2353
|
-
* target (a per-task sandbox on the shape-(d) exemption leg,
|
|
2354
|
-
* or names an unrelated directory — on the host.
|
|
2355
|
-
*
|
|
2419
|
+
/** True when the task's execution env does not declare its paths the host's (`pathsAreHostLocal` is false — whatever
|
|
2420
|
+
* interface drives it): `cwd` then names a path INSIDE that target (a per-task sandbox on the shape-(d) exemption leg,
|
|
2421
|
+
* e.g. `/workspace`), which does not exist — or names an unrelated directory — on the host. A host lane driven through
|
|
2422
|
+
* the remote seam reads `false`. `isolated && !remote` is the only combination under which `cwd` is a host path a
|
|
2423
|
+
* consumer may diff / merge / remove. */
|
|
2356
2424
|
remote: boolean;
|
|
2357
2425
|
/** Where a delegated child's environment placed it against where its caller asked; absent on a leg no delegation
|
|
2358
2426
|
* caller placed. */
|
|
2359
2427
|
placement?: ChildPlacement;
|
|
2428
|
+
/** The target this leg's env reported as it settled — the fence of every leg it hands work to; absent when it reported none. */
|
|
2429
|
+
target?: PlacementTarget;
|
|
2360
2430
|
}
|
|
2361
2431
|
/**
|
|
2362
2432
|
* The resolver's answer, with the WITHHELD cause beside the value.
|
|
@@ -2432,7 +2502,7 @@ export interface SuspendSaga {
|
|
|
2432
2502
|
suspendLoopCapHit: (count: number, cap: number | undefined, detail: string) => boolean;
|
|
2433
2503
|
/** The `suspendVM` target by CAPABILITY, or undefined. */
|
|
2434
2504
|
suspendableEnv: RemoteExecutionEnv | undefined;
|
|
2435
|
-
/** The park-only remote target (
|
|
2505
|
+
/** The park-only remote target (declares `suspendable: false`: externally durable), or undefined. */
|
|
2436
2506
|
parkOnlyRemoteEnv: RemoteExecutionEnv | undefined;
|
|
2437
2507
|
/** The park-only identity capture (snapshotId stripped, `restoreMode: "park_only"`). */
|
|
2438
2508
|
parkOnlyHandle: (env: RemoteExecutionEnv) => WorkspaceHandle;
|
|
@@ -2551,6 +2621,7 @@ export interface RunState {
|
|
|
2551
2621
|
turnResponseModel: string | undefined;
|
|
2552
2622
|
/** B15 三期使能:postToolBatch 的本回合聚集批(每回合边界消费并重置 — 回合语义,故归 turn)。 */
|
|
2553
2623
|
toolBatch: PostToolBatchCall[];
|
|
2624
|
+
completed?: readonly import("../mods/lifecycle-stations.js").CompletedTurn[];
|
|
2554
2625
|
};
|
|
2555
2626
|
counters: {
|
|
2556
2627
|
/** How many LIMIT-APPROACH frames have been injected this run (0..2). Also the
|
|
@@ -2616,6 +2687,29 @@ export interface RunState {
|
|
|
2616
2687
|
* objective's attachments nor the objective's run origin (a config that carries `userAttachments` or `runOrigin` anyway is
|
|
2617
2688
|
* refused before the claim; a wake states its leg's word on the input it hands over). */
|
|
2618
2689
|
export type ResumeTaskConfig = Omit<TaskSpec, "objective" | "sessionId" | "userAttachments" | "runOrigin">;
|
|
2690
|
+
/**
|
|
2691
|
+
* A composition leg's identity ({@link RunInternals.compositionLeg}, `CheckpointState.compositionLeg`): which entry handed the
|
|
2692
|
+
* leg out, which leg of it this is, and the host session the composition runs for. One member per entry; `entry` is a closed
|
|
2693
|
+
* set, and a word outside it is refused wherever the identity is read (`config.invalid_argument`), never stamped on a card.
|
|
2694
|
+
* · `entry: "cascade"` — `leg` is the ladder rung's index (0-based); `hostSessionId` is the caller's `TaskSpec.sessionId`,
|
|
2695
|
+
* the session a host files the composition's run under. A rung runs in its OWN session (the card's `sessionId`), so a host
|
|
2696
|
+
* links a rung's card back to its run by `hostSessionId`, never by the card's session. A cascade whose caller named no
|
|
2697
|
+
* session mints none: that rung's card cannot be linked by composition.
|
|
2698
|
+
* · `entry: "verify"` — the verification gate's VERIFIER leg (`verifyCompleted` and every entry built on it): `leg` is the
|
|
2699
|
+
* verification iteration (1-based, the number `onRound` reports); `hostSessionId` is the implementation's session (the result
|
|
2700
|
+
* the gate verifies, which every fix leg continues). Only the verifier leg is handed one — a fix leg continues the
|
|
2701
|
+
* implementation session itself, so its card already sits in the host's session. A verifier runs in a session the gate
|
|
2702
|
+
* minted, so its card is one no resume of the host's own run reaches: a host reads this entry to tell it from a card it
|
|
2703
|
+
* can decide, and settles it by its token — `runner.resume`, or `Runner.voidVerifierPause` to void it and unpin the
|
|
2704
|
+
* verifier session. An implementation result with no session id mints none.
|
|
2705
|
+
* Three identities beside each other on one card, never merged: the card's `sessionId` (what a resume continues),
|
|
2706
|
+
* `placementRootSessionId` (where the work is placed), and this (whose run it is, and which leg).
|
|
2707
|
+
*/
|
|
2708
|
+
export type CompositionLeg = {
|
|
2709
|
+
readonly entry: "cascade" | "verify";
|
|
2710
|
+
readonly leg: number;
|
|
2711
|
+
readonly hostSessionId: string;
|
|
2712
|
+
};
|
|
2619
2713
|
/** Resume plan threaded from {@link Runner.resume} into the shared run loop. */
|
|
2620
2714
|
export interface ResumeRun {
|
|
2621
2715
|
cp: Checkpoint;
|
|
@@ -2716,14 +2810,7 @@ export interface TurnBoundaryDeps {
|
|
|
2716
2810
|
readonly userHalted: boolean;
|
|
2717
2811
|
readonly callerStop: import("./caller-stop-gate.js").CallerStopGate;
|
|
2718
2812
|
};
|
|
2719
|
-
manualCompactRef:
|
|
2720
|
-
requested: boolean;
|
|
2721
|
-
waiters: Array<{
|
|
2722
|
-
resolve: (outcome: CompactOutcome) => void;
|
|
2723
|
-
signal?: AbortSignal;
|
|
2724
|
-
instructions?: string;
|
|
2725
|
-
}>;
|
|
2726
|
-
};
|
|
2813
|
+
manualCompactRef: Pick<ManualCompactRef, "requested" | "waiters">;
|
|
2727
2814
|
todoToolMounted: boolean;
|
|
2728
2815
|
taskToolsMounted: boolean;
|
|
2729
2816
|
walltimeMonotonicDeadline: number | undefined;
|
|
@@ -2805,7 +2892,7 @@ export interface HarnessHandlersDeps {
|
|
|
2805
2892
|
onError: RunnerDeps["onError"];
|
|
2806
2893
|
onNotice: RunnerDeps["onNotice"];
|
|
2807
2894
|
};
|
|
2808
|
-
|
|
2895
|
+
mediaBudgetBase64Chars: RunnerDeps["mediaBudgetBase64Chars"];
|
|
2809
2896
|
/** The run's ONE isolation scope for the {@link RunInternals} observation sinks, minted by the
|
|
2810
2897
|
* identity-wiring lane (which calls the first of them) and shared with these handlers, so the
|
|
2811
2898
|
* "first failure per site" disclosure is one account for the whole run rather than one per lane. */
|
|
@@ -2864,6 +2951,9 @@ export interface RunnerSelfSeat {
|
|
|
2864
2951
|
canRerootChild?(): boolean;
|
|
2865
2952
|
/** Fire `RunnerDeps.onTaskOutcome` through the swallow-guarded chokepoint (thin compositions emit at their terminal state). */
|
|
2866
2953
|
emitTaskOutcome(outcome: TaskOutcome): void;
|
|
2954
|
+
/** A hold, on the peer seat THIS runner's legs ask, of the references `declared` names — taken by a keeper of declarations
|
|
2955
|
+
* outside a leg (a retained child's ledger entry), released by it once (peer-seat.ts `holdPeerDeclarations`). */
|
|
2956
|
+
holdDeclarations(declared: import("../peer-seat.js").PeerDeclarations): import("../peer-seat.js").PeerDeclarationHold;
|
|
2867
2957
|
/** Run a task to completion. `internals` is the TRUSTED run-scoped channel (never a TaskSpec field). */
|
|
2868
2958
|
runTask(spec: TaskSpec, internals?: RunInternals): Promise<TaskResult>;
|
|
2869
2959
|
/** Streaming form of {@link RunnerSelfSeat.runTask}; `resume` is the run loop's resume plan, `internals` the trusted channel. */
|
|
@@ -2941,10 +3031,13 @@ export interface TaskIdRef {
|
|
|
2941
3031
|
* gate the run-end backstop closes before its final drain. */
|
|
2942
3032
|
export interface ManualCompactRef {
|
|
2943
3033
|
requested: boolean;
|
|
3034
|
+
/** `requestedBy`: the extension a `$.session.compact` request came from (absent on a host `compact()` request) — the
|
|
3035
|
+
* pass that claims it carries it on the frame that ends it. */
|
|
2944
3036
|
waiters: Array<{
|
|
2945
3037
|
resolve: (outcome: CompactOutcome) => void;
|
|
2946
3038
|
signal?: AbortSignal;
|
|
2947
3039
|
instructions?: string;
|
|
3040
|
+
requestedBy?: import("../task-event.js").ExtensionRequester;
|
|
2948
3041
|
}>;
|
|
2949
3042
|
emitMooted?: (reason: string) => void;
|
|
2950
3043
|
closed?: boolean;
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
* put, when the leg settles) also when conversation content follows the newest record. A write that fails refuses its call (or its
|
|
12
12
|
* row) on a governed tree; a prepare's or a settle's, and any write on a tree that is not governed, mints
|
|
13
13
|
* `config.cross_boundary_record_unwritten`, once per state. A record says how the content before it is READ: a leg's end record also
|
|
14
|
-
* carries what the session is still owed — each unfinished background task the leg's
|
|
14
|
+
* carries what the session is still owed — each unfinished background task the leg's task access reaches, judged as the poll the
|
|
15
15
|
* session's next leg (another tree) would make of it, so its delivery is read under the bit it brings. A leg that takes over a
|
|
16
16
|
* session whose content no record covers (none on the branch, or after the newest), on an armed tree, reads that content as
|
|
17
17
|
* off-target.
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
* leg reaches declares itself the target NOW, and the tree's state NOW.
|
|
22
22
|
*/
|
|
23
23
|
import type { AgentTool } from "../../internal/harness.js";
|
|
24
|
-
import type { SessionTreeEntry } from "../../internal/harness-types.js";
|
|
24
|
+
import type { ExecutionEnv, SessionTreeEntry } from "../../internal/harness-types.js";
|
|
25
25
|
import { type CrossBoundaryCheck, type CrossBoundaryPosture, type CrossBoundaryTreeToken, type OwedDeliveries } from "../cross-boundary-taint.js";
|
|
26
26
|
import { type ToolRoster } from "../tool-roster.js";
|
|
27
27
|
import type { RunnerDeps } from "../types.js";
|
|
@@ -73,10 +73,8 @@ export interface CrossBoundaryLaneInput {
|
|
|
73
73
|
posture: CrossBoundaryPosture | undefined;
|
|
74
74
|
/** The run fold: this leg's environment declares the target, or the row it resumes was minted on one. */
|
|
75
75
|
externalContentTargetActive: boolean;
|
|
76
|
-
/** The leg's own environment — read for its CURRENT declaration at each judgment. */
|
|
77
|
-
env:
|
|
78
|
-
readonly externalContentTarget?: boolean;
|
|
79
|
-
};
|
|
76
|
+
/** The leg's own environment — read for its CURRENT declaration (`targetIsExternal`) at each judgment. */
|
|
77
|
+
env: Pick<ExecutionEnv, "capabilities">;
|
|
80
78
|
session: {
|
|
81
79
|
getBranch(): Promise<ReadonlyArray<SessionTreeEntry>>;
|
|
82
80
|
getLeafId(): Promise<string | null>;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { targetIsExternal } from "../remote-env.js";
|
|
1
2
|
import { BOUNDARY_LEGS, CROSS_BOUNDARY_RECORD_TYPE, CROSS_BOUNDARY_TAINT_BITS, STRICTEST_CROSS_BOUNDARY_TREE, crossBoundaryObligation, crossBoundaryPostureUndeclaredNotice, crossBoundaryRecordUnwrittenNotice, crossBoundaryRecordData, crossBoundaryTreeCovers, crossBoundaryTreeGoverned, joinCrossBoundaryTree, readCrossBoundaryRecord, } from "../cross-boundary-taint.js";
|
|
2
3
|
import { deliverEngineNotice } from "../engine-notice.js";
|
|
3
4
|
import { policyCannotAnswer } from "../real-approval.js";
|
|
@@ -23,6 +24,14 @@ export function joinedCrossBoundaryTree(handed, report) {
|
|
|
23
24
|
const EVERY_LEG = Object.freeze([...BOUNDARY_LEGS]);
|
|
24
25
|
const ONE_OUTSIDE_READ = Object.freeze([Object.freeze({ legs: Object.freeze(["outside_read"]) })]);
|
|
25
26
|
const bitsOf = (t) => CROSS_BOUNDARY_TAINT_BITS.filter((b) => t[b] === true);
|
|
27
|
+
function obligationReaching(legs, reached, tree) {
|
|
28
|
+
const declared = reached === undefined ? false : targetIsExternal(reached);
|
|
29
|
+
if (declared !== "undeclared")
|
|
30
|
+
return crossBoundaryObligation(legs, declared, tree);
|
|
31
|
+
const onTarget = crossBoundaryObligation(legs, true, tree);
|
|
32
|
+
const offTarget = crossBoundaryObligation(legs, false, tree);
|
|
33
|
+
return Object.freeze({ mandate: onTarget.mandate || offTarget.mandate, record: onTarget.record || offTarget.record });
|
|
34
|
+
}
|
|
26
35
|
function legsOfCall(view, legEnv, token, call, report) {
|
|
27
36
|
const roster = view.roster.current;
|
|
28
37
|
const row = roster !== undefined ? rosterEntryNamed(roster, call.toolName) : undefined;
|
|
@@ -137,7 +146,7 @@ export async function prepareCrossBoundaryLane(input) {
|
|
|
137
146
|
const OBSERVED = Object.freeze({ offTargetReadObserved: true });
|
|
138
147
|
const addedBy = (record) => (record && ref.current.offTargetReadObserved !== true ? OBSERVED : undefined);
|
|
139
148
|
const owedBit = (owed) => {
|
|
140
|
-
const records = (given) => given.some((d) =>
|
|
149
|
+
const records = (given) => given.some((d) => obligationReaching(d.legs, d.env, ref.current).record);
|
|
141
150
|
try {
|
|
142
151
|
return addedBy(records(owed()));
|
|
143
152
|
}
|
|
@@ -166,7 +175,7 @@ export async function prepareCrossBoundaryLane(input) {
|
|
|
166
175
|
const obligationOf = (call, say) => {
|
|
167
176
|
const { legs, env: reached } = legsOfCall(view, env, token, call, say);
|
|
168
177
|
try {
|
|
169
|
-
return
|
|
178
|
+
return obligationReaching(legs, reached, ref.current);
|
|
170
179
|
}
|
|
171
180
|
catch (err) {
|
|
172
181
|
say(`the cross-boundary obligation of "${call.toolName}" could not be read (${thrownText(err)}) — the call reads as every leg, off the target`);
|
|
@@ -94,7 +94,7 @@ export interface DecideVerdict {
|
|
|
94
94
|
}
|
|
95
95
|
/**
|
|
96
96
|
* Read and judge the host's decision facts — the ONE validation for every durable decide. `raw` is the caller's
|
|
97
|
-
* `hostDecision`, read ONCE by the lane (this function reads `decidedBy` and `
|
|
97
|
+
* `hostDecision`, read ONCE by the lane (this function reads `decidedBy`, `approver` and `decidedVia` once each, off it).
|
|
98
98
|
* - the facts are REQUIRED: absence (or a non-object) is refused — absence is not a fact about the wait, and core
|
|
99
99
|
* does not guess one;
|
|
100
100
|
* - `decidedBy` is a member of the closed set ({@link isHostDecider}); the sweep's word is the host's SLA sweep and
|
|
@@ -102,7 +102,9 @@ export interface DecideVerdict {
|
|
|
102
102
|
* the word would file a record of an event that row's contract says cannot happen;
|
|
103
103
|
* - WHO MAY ALLOW the row: not the sweep's word (a wait nobody answered), and not the policy on a row that demands a
|
|
104
104
|
* person (`policyCannotAnswer`, the synchronous seat's rule);
|
|
105
|
-
* - the attribution passes the shared screen (a bounded plain string) — refused rather than dropped
|
|
105
|
+
* - the attribution passes the shared screen (a bounded plain string) — refused rather than dropped;
|
|
106
|
+
* - `decidedVia`, when present, is a member of its closed set beside `decidedBy: "policy"` ({@link screenDecidedVia}, the
|
|
107
|
+
* synchronous seam's screen); a plan pause takes it under the same screen and its reminder reads `decidedBy` alone.
|
|
106
108
|
*/
|
|
107
109
|
export declare function captureHostDecision(cp: Checkpoint, raw: unknown, lane: DecideLane, verdict: DecideVerdict): HostDecisionFacts;
|
|
108
110
|
/** The origin word of the ask a pending row holds: a tool approval's was stamped on the park by the gate; a plan
|
|
@@ -2,10 +2,10 @@ import { isAskOrigin } from "../ask-origin.js";
|
|
|
2
2
|
import { isLiveQuestionFace, markBoundOnlyQuestionFace } from "../ask-question.js";
|
|
3
3
|
import { boundInputHashOf } from "../canonical-json.js";
|
|
4
4
|
import { CheckpointError } from "../checkpoint-store.js";
|
|
5
|
-
import { decidersNote, isHostDecider, settlementOfHostDecision } from "../gate-outcome.js";
|
|
5
|
+
import { decidersNote, isHostDecider, policyDeciderOf, settlementOfHostDecision } from "../gate-outcome.js";
|
|
6
6
|
import { formatHookFeedback } from "../hooks.js";
|
|
7
7
|
import { facetOf, isGateKind, isQuestionGate } from "../pause-registry.js";
|
|
8
|
-
import { humanRefusalSentence, policyCannotAnswer, screenApproverAttribution } from "../tool-policy.js";
|
|
8
|
+
import { humanRefusalSentence, policyCannotAnswer, screenApproverAttribution, screenDecidedVia } from "../tool-policy.js";
|
|
9
9
|
import { mintGateOutcome } from "./gate-exit.js";
|
|
10
10
|
import { delimitUntrusted, REVIEWER_NOTE_MAX_BODY } from "../untrusted-text.js";
|
|
11
11
|
import { writtenFeedback } from "./approval-feedback.js";
|
|
@@ -108,7 +108,10 @@ export function captureHostDecision(cp, raw, lane, verdict) {
|
|
|
108
108
|
if (attribution.defect !== undefined) {
|
|
109
109
|
throw new CheckpointError("checkpoint.invalid_outcome", `resume carries an approver attribution this engine refuses: ${attribution.defect}; refusing pre-CAS, the checkpoint stays pending`, { field: "approver" });
|
|
110
110
|
}
|
|
111
|
-
|
|
111
|
+
const via = screenDecidedVia(raw.decidedVia, decidedBy);
|
|
112
|
+
if (via.defect !== undefined)
|
|
113
|
+
throw new CheckpointError("checkpoint.invalid_outcome", `resume hostDecision carries a decidedVia this engine refuses: ${via.defect}; refusing pre-CAS, the checkpoint stays pending`, { field: "hostDecision" });
|
|
114
|
+
return { decidedBy, ...(attribution.approver !== undefined ? { approver: attribution.approver } : {}), ...(via.decidedVia !== undefined ? { decidedVia: via.decidedVia } : {}) };
|
|
112
115
|
}
|
|
113
116
|
export function parkedOriginOf(cp) {
|
|
114
117
|
if (cp.pendingAction.kind === "tool_approval")
|
|
@@ -183,6 +186,6 @@ export function resumeContinuation(resume, mark, fullShellReachable, delegatedCh
|
|
|
183
186
|
}
|
|
184
187
|
const decided = decision === "allow"
|
|
185
188
|
? "was APPROVED and has now been executed — its result is in the tool results above"
|
|
186
|
-
: `was DENIED ${hostDecision.decidedBy === "policy" ?
|
|
189
|
+
: `was DENIED ${hostDecision.decidedBy === "policy" ? `by ${policyDeciderOf(hostDecision.decidedVia).name}` : "because its approval window elapsed with no answer"}, not by a person — the refusal and its reason are in the tool results above`;
|
|
187
190
|
return formatHookFeedback(`The pending tool call "${pendingAction.toolName}" ${decided}. ${resumed}${carryOn}`, mark);
|
|
188
191
|
}
|