@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
|
@@ -1,5 +1,6 @@
|
|
|
1
|
+
import { randomBytes } from "node:crypto";
|
|
1
2
|
import { Type } from "typebox";
|
|
2
|
-
import { isNotificationInjectionOutcome } from "../core/task-notification.js";
|
|
3
|
+
import { admitsBackgroundLaunch, isNotificationInjectionOutcome, resolveCompletionSink } from "../core/task-notification.js";
|
|
3
4
|
import { defineTool } from "../core/tools.js";
|
|
4
5
|
import { normalizeAgentName, chosenAgentName, DURABLE_AGENT_HANDLE_RE, DURABLE_AGENT_HEARTBEAT_MS } from "../core/task-registry.js";
|
|
5
6
|
import { announceTranscriptIntegrityGapOnce, canAccessAgentRecord, clearRevivedRowTerminalPayload } from "../core/background-agent-store.js";
|
|
@@ -24,7 +25,11 @@ import { clampValuesOf } from "../core/child-clamp-seats.js";
|
|
|
24
25
|
import { assertParentSpecSeatCurrent } from "../core/parent-spec-seat.js";
|
|
25
26
|
import { resolveSubagentTranscriptTier } from "../core/wiring-manifest.js";
|
|
26
27
|
export const SEND_MESSAGE_TOOL_NAME = "SendMessage";
|
|
27
|
-
let uplinkSeqGlobal =
|
|
28
|
+
let uplinkSeqGlobal = processUplinkSeqOrigin();
|
|
29
|
+
function processUplinkSeqOrigin() {
|
|
30
|
+
const draw = randomBytes(7);
|
|
31
|
+
return 2 ** 51 + (draw[0] & 0x07) * 2 ** 48 + draw.readUIntBE(1, 6);
|
|
32
|
+
}
|
|
28
33
|
const UPLINK_RESULT_MAX = 8000;
|
|
29
34
|
function clipCarrierMessage(text) {
|
|
30
35
|
return text.length > UPLINK_RESULT_MAX ? `${text.slice(0, UPLINK_RESULT_MAX)}\n[message truncated: ${text.length} chars total]` : text;
|
|
@@ -102,36 +107,8 @@ export function createSendMessageTool(opts) {
|
|
|
102
107
|
const sendMessageParameters = peerLane.active
|
|
103
108
|
? Type.Object({ ...baseParameters.properties, message: Type.Optional(Type.String({ description: `${baseParameters.properties.message.description ?? ""} Optional only for a pure notify_when_idle subscription.`.trim() })), ...notifyWhenIdleParameter })
|
|
104
109
|
: baseParameters;
|
|
105
|
-
const
|
|
106
|
-
const
|
|
107
|
-
const RETRIEVE_NOW = retrievalMounted === false
|
|
108
|
-
? "its result cannot be collected by this run (no TaskOutput is mounted beside this tool) — do not wait for it, and say so in your answer if the result matters"
|
|
109
|
-
: `retrieve its result NOW with TaskOutput(task_id, block: true)${retrievalHedge} rather than ending your turn`;
|
|
110
|
-
const RETRIEVE_LATER = retrievalMounted === false
|
|
111
|
-
? "its result cannot be collected by this run (no TaskOutput is mounted beside this tool)"
|
|
112
|
-
: "retrieve its status and result with TaskOutput(task_id) where mounted";
|
|
113
|
-
const WAIT_NOW = retrievalMounted === false
|
|
114
|
-
? "do not wait for it — this face has no TaskOutput to block on, and"
|
|
115
|
-
: `wait for it NOW with TaskOutput(task_id, block: true)${retrievalHedge} —`;
|
|
116
|
-
const CHECK_LATER = retrievalMounted === false
|
|
117
|
-
? "its completion cannot be checked from this face (no TaskOutput is mounted beside this tool)"
|
|
118
|
-
: "check for its completion with TaskOutput(task_id) where mounted";
|
|
119
|
-
const capitalize = (text) => `${text.charAt(0).toUpperCase()}${text.slice(1)}`;
|
|
120
|
-
const completionMode = opts.oneShot === true ? "one_shot" : (opts.notificationWired ?? opts.notify !== undefined) ? "notified" : "silent";
|
|
121
|
-
const notifyWired = completionMode === "notified";
|
|
122
|
-
const NO_COMPLETION_NOTICE = completionMode === "one_shot"
|
|
123
|
-
? `this is a ONE-SHOT submission — there is no later turn for a completion notification to land in, so ${RETRIEVE_NOW}`
|
|
124
|
-
: `its completion is NOT announced on this mount — ${RETRIEVE_LATER}`;
|
|
125
|
-
const AWAIT_COMPLETION = notifyWired
|
|
126
|
-
? "Wait for its completion notification"
|
|
127
|
-
: completionMode === "one_shot"
|
|
128
|
-
? `${capitalize(WAIT_NOW)} this one-shot submission ends with this turn`
|
|
129
|
-
: capitalize(CHECK_LATER);
|
|
130
|
-
const awaitCompletion = notifyWired
|
|
131
|
-
? "wait for its completion notification"
|
|
132
|
-
: completionMode === "one_shot"
|
|
133
|
-
? `${WAIT_NOW} this one-shot submission ends with this turn`
|
|
134
|
-
: CHECK_LATER;
|
|
110
|
+
const AWAIT_COMPLETION = "Wait for its completion notification";
|
|
111
|
+
const awaitCompletion = "wait for its completion notification";
|
|
135
112
|
const sendMessagePins = new Map();
|
|
136
113
|
const pinGuard = (targetId, targetName, rung, to) => {
|
|
137
114
|
if (rung === "other")
|
|
@@ -173,15 +150,7 @@ export function createSendMessageTool(opts) {
|
|
|
173
150
|
`background run with its full prior conversation preserved, so don't re-explain what it already knows. Names ` +
|
|
174
151
|
`keep working after an agent completes; but if a name you already messaged is later taken by a NEWER agent, the ` +
|
|
175
152
|
`send is refused rather than silently redirected — re-send with the task_id of whichever agent you meant. ` +
|
|
176
|
-
|
|
177
|
-
? `You will be notified automatically when it completes — prefer ending your turn; do not poll. `
|
|
178
|
-
: completionMode === "one_shot"
|
|
179
|
-
? `This is a ONE-SHOT submission: there is no later turn for a completion notification to land in, so do NOT end your turn expecting one${retrievalMounted === false
|
|
180
|
-
? "; a continued agent's result cannot be collected by this run (no TaskOutput is mounted beside this tool) — say so if the result matters"
|
|
181
|
-
: ` — wait actively with TaskOutput(task_id, block: true)${retrievalHedge} when you need a continued agent's result`}. `
|
|
182
|
-
: `A finished agent is NOT announced on this mount${retrievalMounted === false
|
|
183
|
-
? ", and its result cannot be collected by this run (no TaskOutput is mounted beside this tool) — do not end your turn to wait for a notification that never comes"
|
|
184
|
-
: " — check on it with TaskOutput(task_id) where mounted rather than ending your turn to wait for a notification that never comes"}. `) +
|
|
153
|
+
`You will be notified automatically when it completes — prefer ending your turn; do not poll. ` +
|
|
185
154
|
(continuationTier === "full"
|
|
186
155
|
? `Continuing a finished agent works for agents with a durable record — by name or task_id, even across restarts — and for runs that retain sub-agent sessions; when neither covers it you get an honest error and should launch a new agent with the needed context instead.`
|
|
187
156
|
: continuationTier === "rows"
|
|
@@ -230,6 +199,11 @@ export function createSendMessageTool(opts) {
|
|
|
230
199
|
if (isObserverTaskId(to)) {
|
|
231
200
|
return { content: OBSERVER_SENDMESSAGE_TARGET_REFUSAL, details: { error: "observer_target", to }, isError: true };
|
|
232
201
|
}
|
|
202
|
+
if (message !== "" && ctx.sendStation?.listens() === true) {
|
|
203
|
+
const verdict = await ctx.sendStation.send({ to, text: message, toolCallId: ctx.toolCallId }, ctx.signal);
|
|
204
|
+
if (!verdict.go)
|
|
205
|
+
return { content: `Message not sent: ${verdict.reason}`, details: { error: "send_refused", code: "send_refused", by: verdict.by, to }, isError: true };
|
|
206
|
+
}
|
|
233
207
|
const admissionConfig = resolvePeerLaneConfig(opts.lane, opts.onNotice);
|
|
234
208
|
const guardScope = ctx.principal ?? opts.scope ?? opts.peerSelfSession?.scope;
|
|
235
209
|
const selfRef = ctx.peerSelfRef ?? opts.peerSelf;
|
|
@@ -245,6 +219,13 @@ export function createSendMessageTool(opts) {
|
|
|
245
219
|
const prospectiveChain = appendHopToken(inboundChain, senderKey);
|
|
246
220
|
const admitFor = (recipientKey, ownTokens) => judgePeerAdmission(guardScope, recipientKey, { senderKey, body: message, prospectiveChain, ownTokens }, admissionConfig);
|
|
247
221
|
const DEDUP_RETRY_NOTE = "Note: resending the identical text within the dedup window reads as duplicate — rephrase or wait it out.";
|
|
222
|
+
const continuationSink = resolveCompletionSink(ctx.onTaskNotification, opts.notify);
|
|
223
|
+
const continuationAdmitted = admitsBackgroundLaunch(continuationSink, opts.notificationWired === true);
|
|
224
|
+
const noContinuationLane = (whoLabel) => ({
|
|
225
|
+
content: `Message not sent: ${whoLabel.slice(0, 200)} has finished and cannot be continued here — no completion would come back from it on this mount. Launch a new agent with the needed context instead.`,
|
|
226
|
+
details: { error: "revive.no_background", code: "revive.no_background", to },
|
|
227
|
+
isError: true,
|
|
228
|
+
});
|
|
248
229
|
const admissionRefusal = (reason, whoLabel) => {
|
|
249
230
|
const text = reason === "rate_limited"
|
|
250
231
|
? `you are sending messages to ${whoLabel} faster than its rate limit — the budget refills on its own; slow down and resend in a moment.`
|
|
@@ -492,7 +473,9 @@ export function createSendMessageTool(opts) {
|
|
|
492
473
|
? `Message parked in process for main (${mainLabel}): it has no run in progress, so the message waits in this process for its next run — this copy does not survive a restart of this process. Continue with your task; do not wait for a reply.`
|
|
493
474
|
: outcome === "dropped_duplicate"
|
|
494
475
|
? `Message not re-sent to main (${mainLabel}): it already delivered this exact message. Continue with your task; do not resend the same content.`
|
|
495
|
-
:
|
|
476
|
+
: outcome === "refused"
|
|
477
|
+
? `Message not delivered to main (${mainLabel}): its receiving station did not hand it to its model (an extension there consumed it, or a handler there failed). Continue with your task; do not resend the same content.`
|
|
478
|
+
: `Message sent to main — queued for ${mainLabel} at its next turn boundary (accepted into its lane, not yet read). If that run finishes before reading it, the message may not survive. Continue with your task; do not wait for a reply.`;
|
|
496
479
|
return {
|
|
497
480
|
content,
|
|
498
481
|
details: { type: "send-message", status: "uplinked", to: "main", seq: uplinkSeq, ...(outcome !== undefined ? { disposition: outcome } : {}), ...(opts.uplinkSessionId !== undefined ? { session: opts.uplinkSessionId } : {}) },
|
|
@@ -581,6 +564,8 @@ export function createSendMessageTool(opts) {
|
|
|
581
564
|
}
|
|
582
565
|
if (row.sessionId === undefined)
|
|
583
566
|
return undefined;
|
|
567
|
+
if (!continuationAdmitted)
|
|
568
|
+
return noContinuationLane(whoT3);
|
|
584
569
|
const floorRead = readClampFloor(row.policyFloor);
|
|
585
570
|
if (!floorRead.ok) {
|
|
586
571
|
return {
|
|
@@ -637,7 +622,7 @@ export function createSendMessageTool(opts) {
|
|
|
637
622
|
catch (e) {
|
|
638
623
|
await rollbackDrain();
|
|
639
624
|
if (e?.code === "not_found") {
|
|
640
|
-
announceTranscriptIntegrityGapOnce(handle, scope, opts.onTranscriptIntegrityGap);
|
|
625
|
+
announceTranscriptIntegrityGapOnce(handle, scope, opts.onTranscriptIntegrityGap, continuationTier);
|
|
641
626
|
return queueFullReceipt(`No transcript found for agent ${handle}, so a revival cannot drain the backlog.`);
|
|
642
627
|
}
|
|
643
628
|
return queueFullReceipt(`Its transcript store did not answer (${thrownText(e)}) — this send did not start a backlog drain; a later resend will try again.`);
|
|
@@ -736,7 +721,7 @@ export function createSendMessageTool(opts) {
|
|
|
736
721
|
catch (e) {
|
|
737
722
|
await rollback();
|
|
738
723
|
if (e?.code === "not_found") {
|
|
739
|
-
announceTranscriptIntegrityGapOnce(handle, scope, opts.onTranscriptIntegrityGap);
|
|
724
|
+
announceTranscriptIntegrityGapOnce(handle, scope, opts.onTranscriptIntegrityGap, continuationTier);
|
|
740
725
|
return {
|
|
741
726
|
content: `Message not sent: no transcript found for agent ${handle} — it cannot be revived. Launch a new agent with the needed context instead.`,
|
|
742
727
|
details: { error: "resume.session_not_found", to },
|
|
@@ -815,9 +800,7 @@ export function createSendMessageTool(opts) {
|
|
|
815
800
|
const priorCount = lease.messages.length - 1;
|
|
816
801
|
return {
|
|
817
802
|
content: `Message sent — ${whoT3} was revived in the background with its prior context intact${priorCount > 0 ? ` (${priorCount} earlier pending message(s) delivered with it)` : ""}. ` +
|
|
818
|
-
|
|
819
|
-
? `You will be notified automatically when it completes. Continue with other work — do not poll.`
|
|
820
|
-
: `${NO_COMPLETION_NOTICE.charAt(0).toUpperCase()}${NO_COMPLETION_NOTICE.slice(1)}.`),
|
|
803
|
+
`You will be notified automatically when it completes. Continue with other work — do not poll.`,
|
|
821
804
|
details: { type: "send-message", status: "revived", to, task_id: handle, seq: nextSeq, ...(priorCount > 0 ? { priorMessages: priorCount } : {}) },
|
|
822
805
|
};
|
|
823
806
|
}
|
|
@@ -958,15 +941,22 @@ export function createSendMessageTool(opts) {
|
|
|
958
941
|
}, { priority: "next" });
|
|
959
942
|
if (delivered.ok) {
|
|
960
943
|
const receiptText = delivered.disposition === "parked"
|
|
961
|
-
? `Message parked for ${who}: the agent finished before reading it — it will be delivered when the agent is next continued.
|
|
944
|
+
? `Message parked for ${who}: the agent finished before reading it — it will be delivered when the agent is next continued. You will be notified of its completion; continue with other work.`
|
|
962
945
|
: delivered.disposition === "pending"
|
|
963
|
-
? `Message accepted for ${who} but delivery is UNCONFIRMED (its channel did not confirm within the wait window) — it stays queued and will deliver if the channel binds.
|
|
964
|
-
: `Message queued for delivery to ${who} at its next turn. If it finishes before reading it, the message may not survive —
|
|
946
|
+
? `Message accepted for ${who} but delivery is UNCONFIRMED (its channel did not confirm within the wait window) — it stays queued and will deliver if the channel binds. You will be notified of the agent's completion either way; resend then if it went unanswered. ${DEDUP_RETRY_NOTE}`
|
|
947
|
+
: `Message queued for delivery to ${who} at its next turn. If it finishes before reading it, the message may not survive — you will be notified of its completion either way; resend then if it went unanswered. Continue with other work; do not poll. ${DEDUP_RETRY_NOTE}`;
|
|
965
948
|
return {
|
|
966
949
|
content: receiptText,
|
|
967
950
|
details: { type: "send-message", status: "delivered_running", disposition: delivered.disposition, to, task_id: targetId, summary },
|
|
968
951
|
};
|
|
969
952
|
}
|
|
953
|
+
if (delivered.reason === "refused") {
|
|
954
|
+
return {
|
|
955
|
+
content: `Message not delivered: ${who} did not take it — its receiving station did not hand it to its model (an extension there consumed it, or a handler there failed). Do not resend the same message; continue, or choose another approach.`,
|
|
956
|
+
details: { error: "refused", code: "refused", to },
|
|
957
|
+
isError: true,
|
|
958
|
+
};
|
|
959
|
+
}
|
|
970
960
|
if (delivered.reason === "no_channel") {
|
|
971
961
|
return {
|
|
972
962
|
content: `Message not sent: ${who} is still running and this deployment has no mid-run delivery channel for it. ${AWAIT_COMPLETION}, then SendMessage to continue it. ${DEDUP_RETRY_NOTE}`,
|
|
@@ -1040,6 +1030,8 @@ export function createSendMessageTool(opts) {
|
|
|
1040
1030
|
isError: true,
|
|
1041
1031
|
};
|
|
1042
1032
|
}
|
|
1033
|
+
if (!continuationAdmitted)
|
|
1034
|
+
return noContinuationLane(who);
|
|
1043
1035
|
return await withTargetLane(targetLaneKey(access.scope, targetId), async () => {
|
|
1044
1036
|
const l3Entry = ledger.get(resumeToolUseId);
|
|
1045
1037
|
const l3RecipientKey = peerAxisToken(access.scope, "h", targetId);
|
|
@@ -1057,7 +1049,7 @@ export function createSendMessageTool(opts) {
|
|
|
1057
1049
|
runner: opts.runner,
|
|
1058
1050
|
peerOrigin: { hopChain: prospectiveChain },
|
|
1059
1051
|
...(opts.notify !== undefined && selfRef !== undefined ? { currentParentPeerRef: selfRef } : {}),
|
|
1060
|
-
...(
|
|
1052
|
+
...(continuationSink !== undefined ? { notify: continuationSink } : {}),
|
|
1061
1053
|
...(opts.sink ? { sink: opts.sink } : {}),
|
|
1062
1054
|
registry: opts.registry,
|
|
1063
1055
|
taskId: targetId,
|
|
@@ -1075,9 +1067,12 @@ export function createSendMessageTool(opts) {
|
|
|
1075
1067
|
...(row.createdAt !== undefined ? { rowSpawnedAt: row.createdAt } : {}),
|
|
1076
1068
|
...(opts.onNotifyError !== undefined ? { onNotifyError: opts.onNotifyError } : {}),
|
|
1077
1069
|
...(opts.notify ? { currentParentNotify: opts.notify } : {}),
|
|
1070
|
+
...(opts.taskArtifacts !== undefined ? { currentTaskArtifacts: opts.taskArtifacts } : {}),
|
|
1078
1071
|
...(ctx.onQuestion !== undefined && row.sessionScoped !== true ? { currentOnQuestion: ctx.onQuestion } : {}),
|
|
1079
1072
|
currentClamps: clampValuesOf(ctx, ctx.parentSpecSeat),
|
|
1080
1073
|
...(ctx.autoModeReview !== undefined ? { currentAutoModeReview: ctx.autoModeReview } : {}),
|
|
1074
|
+
currentMcpHostSeats: ctx.mountedMcp?.().hostSeats,
|
|
1075
|
+
currentPlacementTarget: ctx.placementTarget,
|
|
1081
1076
|
});
|
|
1082
1077
|
const fromPrefix = senderIsChild ? `(message from teammate "${senderLabel}")\n` : "";
|
|
1083
1078
|
try {
|
|
@@ -1086,9 +1081,7 @@ export function createSendMessageTool(opts) {
|
|
|
1086
1081
|
const marker = await resume(`${fromPrefix}[${safeSummary}] ${safeMessage}`);
|
|
1087
1082
|
return {
|
|
1088
1083
|
content: `Message sent — ${who} resumed in the background with its prior context intact (correlation marker [${marker}]).\n` +
|
|
1089
|
-
|
|
1090
|
-
? `You will be notified automatically when it completes; its reply will carry [${marker}]. Continue with other work — do not poll.`
|
|
1091
|
-
: `Its reply will carry [${marker}], but ${NO_COMPLETION_NOTICE}.`),
|
|
1084
|
+
`You will be notified automatically when it completes; its reply will carry [${marker}]. Continue with other work — do not poll.`,
|
|
1092
1085
|
details: { type: "send-message", status: "resumed", to, task_id: targetId, marker, summary },
|
|
1093
1086
|
};
|
|
1094
1087
|
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { TaskRegistry } from "../core/task-registry.js";
|
|
2
|
+
import { type TaskNotificationPayload } from "../core/task-notification.js";
|
|
3
|
+
import type { SubagentRetainEntry } from "./retain-ledger.js";
|
|
4
|
+
/** The registry owner keys a child's own background work registers under: run-scoped work under the
|
|
5
|
+
* child's task id, session-scoped work under its session id (the `sessionScoped ? sessionId : taskId`
|
|
6
|
+
* owner read of the bash and monitor tools and of the sub-agent lanes). On a background lane the two
|
|
7
|
+
* differ — the task id is the row id — so a reader of "the child's work" reads both; elsewhere they are
|
|
8
|
+
* one key. */
|
|
9
|
+
export declare function childOwnerKeys(taskId: string, sessionId: string): readonly string[];
|
|
10
|
+
/** Running background tasks under any of `owners` (the gate's liveness read). */
|
|
11
|
+
export declare function runningBackgroundUnder(registry: TaskRegistry, owners: readonly string[]): number;
|
|
12
|
+
/**
|
|
13
|
+
* design/144 §1.2 — PARK a background child's `completed` notification behind its own still-running
|
|
14
|
+
* background tasks (207 p0g: "the child finished, but work it launched is still running — the completion
|
|
15
|
+
* news waits for the last of it"). Callers: the spawn settle resolve leg AND the resume settle resolve
|
|
16
|
+
* leg (1.284 C1 — the gate applies to every stop cycle). The frame is the PARK-TIME SNAPSHOT (seq /
|
|
17
|
+
* recentSteps / editedFiles composed by the caller before this call); delivery happens on the registry's
|
|
18
|
+
* owner-quiescence hook (the LAST settling background task's poke), exactly once (registry one-shot set
|
|
19
|
+
* + the `done` latch). The delivered frame's summary gets a decorative "(delivered after N …)" suffix —
|
|
20
|
+
* DISPLAY ONLY, not contract (tests must never lock that wording). `entry.deferredNotify` is both the
|
|
21
|
+
* resume-void hook (a wake cancels the watcher and drops the frame — see the SubagentRetainEntry ruling)
|
|
22
|
+
* and the C2 eviction-flush hook (an entry leaving the ledger delivers the frame NOW, undecorated).
|
|
23
|
+
*/
|
|
24
|
+
export declare function parkCompletionNotify(deps: {
|
|
25
|
+
registry: TaskRegistry;
|
|
26
|
+
entry: SubagentRetainEntry;
|
|
27
|
+
/** The child's owner keys in the registry ({@link childOwnerKeys}). */
|
|
28
|
+
owners: readonly string[];
|
|
29
|
+
/** Running background-task count at park time (rides the decorative delivery suffix). */
|
|
30
|
+
pendingCount: number;
|
|
31
|
+
payload: TaskNotificationPayload;
|
|
32
|
+
notify: (n: TaskNotificationPayload, opts?: {
|
|
33
|
+
priority?: "now" | "next" | "later";
|
|
34
|
+
}) => void;
|
|
35
|
+
}): void;
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { retireTerminalDelivery } from "../core/task-notification.js";
|
|
2
|
+
export function childOwnerKeys(taskId, sessionId) {
|
|
3
|
+
return taskId === sessionId ? [taskId] : [taskId, sessionId];
|
|
4
|
+
}
|
|
5
|
+
export function runningBackgroundUnder(registry, owners) {
|
|
6
|
+
let n = 0;
|
|
7
|
+
for (const owner of owners)
|
|
8
|
+
n += registry.countRunningBackgroundForOwner(owner);
|
|
9
|
+
return n;
|
|
10
|
+
}
|
|
11
|
+
export function parkCompletionNotify(deps) {
|
|
12
|
+
const { registry, entry, owners, pendingCount, payload, notify } = deps;
|
|
13
|
+
let done = false;
|
|
14
|
+
const deliver = (decorated) => {
|
|
15
|
+
if (done)
|
|
16
|
+
return;
|
|
17
|
+
done = true;
|
|
18
|
+
unsubscribe();
|
|
19
|
+
if (entry.deferredNotify?.cancel === cancel)
|
|
20
|
+
entry.deferredNotify = undefined;
|
|
21
|
+
try {
|
|
22
|
+
notify(decorated
|
|
23
|
+
? {
|
|
24
|
+
...payload,
|
|
25
|
+
summary: `${payload.summary} (delivered after ${pendingCount} background ${pendingCount === 1 ? "child" : "children"} settled)`,
|
|
26
|
+
}
|
|
27
|
+
: payload, { priority: "next" });
|
|
28
|
+
}
|
|
29
|
+
catch {
|
|
30
|
+
}
|
|
31
|
+
};
|
|
32
|
+
const watchers = new Map();
|
|
33
|
+
const unsubscribe = () => {
|
|
34
|
+
for (const off of watchers.values())
|
|
35
|
+
off();
|
|
36
|
+
watchers.clear();
|
|
37
|
+
};
|
|
38
|
+
const arm = () => {
|
|
39
|
+
for (const owner of owners) {
|
|
40
|
+
if (watchers.has(owner) || registry.countRunningBackgroundForOwner(owner) === 0)
|
|
41
|
+
continue;
|
|
42
|
+
watchers.set(owner, registry.onBackgroundQuiescence(owner, (reason) => {
|
|
43
|
+
watchers.delete(owner);
|
|
44
|
+
if (reason === "evicted")
|
|
45
|
+
deliver(false);
|
|
46
|
+
else if (runningBackgroundUnder(registry, owners) === 0)
|
|
47
|
+
deliver(true);
|
|
48
|
+
else
|
|
49
|
+
arm();
|
|
50
|
+
}));
|
|
51
|
+
}
|
|
52
|
+
};
|
|
53
|
+
arm();
|
|
54
|
+
const cancel = () => {
|
|
55
|
+
if (done)
|
|
56
|
+
return;
|
|
57
|
+
done = true;
|
|
58
|
+
unsubscribe();
|
|
59
|
+
retireTerminalDelivery(notify, payload);
|
|
60
|
+
};
|
|
61
|
+
entry.deferredNotify = { ...(payload.seq !== undefined ? { seq: payload.seq } : {}), cancel, flush: () => deliver(false) };
|
|
62
|
+
}
|
|
@@ -5,9 +5,10 @@
|
|
|
5
5
|
*
|
|
6
6
|
* Scope: ONE direct child. A grandchild re-threads the same forward sink, and the sink does not order direct-child
|
|
7
7
|
* content before grandchild frames, so scoping is EXPLICIT:
|
|
8
|
-
* 1. the spawn site calls {@link SubagentStepRecorder.lockTo} the moment the child's
|
|
9
|
-
* (
|
|
10
|
-
*
|
|
8
|
+
* 1. the spawn site calls {@link SubagentStepRecorder.lockTo} the moment the child's task id is known
|
|
9
|
+
* (a background lane: its registry row id; a synchronous fork: the forked sessionId; a synchronous
|
|
10
|
+
* retained child: the pre-minted child sessionId; a retained wake: the woken leg's task id) — after
|
|
11
|
+
* that, only `sourceTaskId === lockedSource` frames are recorded;
|
|
11
12
|
* 2. lanes where the child id is minted inside `runTask` (plain sync / non-retained background) anchor
|
|
12
13
|
* by FRAME PAIRING instead: the runner stamps `sourceTaskId` + `parentToolCallId` together on every
|
|
13
14
|
* child content event, and the DIRECT child's `parentToolCallId` is THIS delegation's own tool-call
|
|
@@ -70,9 +71,9 @@ export declare class SubagentStepRecorder {
|
|
|
70
71
|
*/
|
|
71
72
|
constructor(parentToolCallId?: string);
|
|
72
73
|
/**
|
|
73
|
-
* CORE-2 — explicitly anchor the observed DIRECT child by its
|
|
74
|
-
*
|
|
75
|
-
* spawn site. If events arrived BEFORE the anchor and the provisional lock caught a DIFFERENT source
|
|
74
|
+
* CORE-2 — explicitly anchor the observed DIRECT child by its task id — the `sourceTaskId` its frames
|
|
75
|
+
* carry (`legTaskIdOf`: its registry row id on a background lane, else its session id, since
|
|
76
|
+
* `buildChildSpec` never sets `spec.taskId`). Call as soon as the id is known at the spawn site. If events arrived BEFORE the anchor and the provisional lock caught a DIFFERENT source
|
|
76
77
|
* (a grandchild racing through the shared sink), everything recorded so far belongs to the wrong
|
|
77
78
|
* descendant — reset it and re-lock, so the projection never mixes generations.
|
|
78
79
|
*/
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { RunnerSelfSeat } from "../core/runner/contracts.js";
|
|
2
2
|
import type { AgentDefinition, Model, ModelRef, TaskLimits, TerminalCause, ToolSpec } from "../core/types.js";
|
|
3
3
|
export { childThinkingSeat, deploymentSubagentThinking, deploymentSubagentTierModel } from "./child-model-seat.js";
|
|
4
|
-
import { type ExecutionEnv } from "../internal/harness.js";
|
|
4
|
+
import { type ExecutionEnv, type ReadFloor } from "../internal/harness.js";
|
|
5
5
|
import type { TaskNotificationPayload } from "../core/task-notification.js";
|
|
6
6
|
import { RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX } from "../config/defaults.js";
|
|
7
7
|
/**
|
|
@@ -173,9 +173,13 @@ export interface SubagentWorktreeIsolation {
|
|
|
173
173
|
* (closure over the run's ExecutionEnv/taskRootPath — trusted, mirrors the scheduler/fork mounts). The
|
|
174
174
|
* worktree-rooted env handed to {@link addWorktree} is a thin prototype view over the base env with `destroy`
|
|
175
175
|
* MASKED (an own `destroy: undefined`), so tearing the worktree down can never cascade into destroying the
|
|
176
|
-
* parent's own (possibly factory-owned) env.
|
|
176
|
+
* parent's own (possibly factory-owned) env. Its git starts carry the floor `parentFloor` answers as each begins (the run's base table).
|
|
177
177
|
*/
|
|
178
|
-
export declare function createSubagentWorktreeHelper(baseEnv: ExecutionEnv, repoRoot: string): SubagentWorktreeIsolation;
|
|
178
|
+
export declare function createSubagentWorktreeHelper(baseEnv: ExecutionEnv, repoRoot: string, parentFloor: () => ReadFloor | undefined): SubagentWorktreeIsolation;
|
|
179
|
+
/** The one line a synchronous result carries when the call asked for the background lane (by default, by
|
|
180
|
+
* `run_in_background`, by its definition, or by a name) but no completion sink resolved for it — no background launch
|
|
181
|
+
* is made where nothing would hear it finish (`admitsBackgroundLaunch`). */
|
|
182
|
+
export declare const AGENT_RAN_SYNC_NO_CHANNEL_NOTE = "note: this agent ran synchronously \u2014 no completion would come back from a background agent on this mount, so the background lane is not used here.";
|
|
179
183
|
/** Names an `AgentDefinition.name` must not collide with (would confuse the enum vs a real tool name). Includes the
|
|
180
184
|
* default delegation tool name itself, so a child agent can't be named "Agent" even when a custom `opts.name` is set. */
|
|
181
185
|
export declare const RESERVED_AGENT_NAMES: ReadonlySet<string>;
|
|
@@ -331,8 +335,8 @@ export declare const SUBAGENT_SUSPENDED_CHECKPOINT_EXPIRED = "suspended.checkpoi
|
|
|
331
335
|
* rejects with `steering.not_running` once the child ends. The handle never reaches the model.
|
|
332
336
|
*/
|
|
333
337
|
export interface SubagentSteerHandle {
|
|
334
|
-
/** The child run's
|
|
335
|
-
* is the SPAWN-time identity: the parent's tool call id — stable, unique per delegation
|
|
338
|
+
/** The child run's task id is minted inside the child's own prepare (`legTaskIdOf`), after spawn, so
|
|
339
|
+
* this is the SPAWN-time identity: the parent's tool call id — stable, unique per delegation. */
|
|
336
340
|
parentToolCallId: string;
|
|
337
341
|
/** The child's display name (taskName / agent-type), when one was threaded. */
|
|
338
342
|
agentName?: string;
|
|
@@ -397,6 +401,9 @@ export declare function createSubagentResume(deps: {
|
|
|
397
401
|
currentParentNotify?: (n: TaskNotificationPayload, opts?: {
|
|
398
402
|
priority?: "now" | "next" | "later";
|
|
399
403
|
}) => void;
|
|
404
|
+
/** The RESUMING caller's result store, the pair of `currentParentNotify`: a cut completion is stored where the run that
|
|
405
|
+
* hears it reads (its `ToolExecuteContext.taskArtifacts`). Absent ⇒ the cut says the full text is not readable here. */
|
|
406
|
+
currentTaskArtifacts?: import("../core/tool-result-store.js").TaskArtifactSeat;
|
|
400
407
|
/** The RESUMING caller's live content-ask face (its trusted `ToolExecuteContext.onQuestion`), same
|
|
401
408
|
* reasoning as `currentParentNotify` one line up: the retained snapshot deliberately carries NO
|
|
402
409
|
* question face (the spawn turn's is stripped at freeze time — a per-request lane is torn down with
|
|
@@ -423,6 +430,12 @@ export declare function createSubagentResume(deps: {
|
|
|
423
430
|
currentAutoModeReview?: {
|
|
424
431
|
decider: import("../core/auto-mode.js").AutoModeDecider;
|
|
425
432
|
};
|
|
433
|
+
/** The RESUMING caller's own host seats (its trusted `ToolExecuteContext.mountedMcp` seats), same turn-bound reasoning: the snapshot keeps
|
|
434
|
+
* none, so the resumed cycle's host-transport servers dial through the waker's seats of their names, or fail their dial without one. */
|
|
435
|
+
currentMcpHostSeats?: ReadonlyMap<string, import("../core/mcp-host-seat.js").McpHostSeat> | undefined;
|
|
436
|
+
/** The RESUMING caller's own placement target (its trusted `ToolExecuteContext.placementTarget`), same per-wake reasoning: the snapshot
|
|
437
|
+
* keeps none, so the resumed cycle is minted under the waker's target — the one fence a tier-3 revival of the same agent would get. */
|
|
438
|
+
currentPlacementTarget?: import("../core/remote-env.js").PlacementTarget | undefined;
|
|
426
439
|
/** design/176 — present iff this resume is PEER-DRIVEN (the SendMessage carrier): the resume
|
|
427
440
|
* prompt takes the peer-resume trust frame (teammate header + fence label + the per-message
|
|
428
441
|
* discipline block — never the operator-authority wording), and the woken cycle's inbound peer
|
|
@@ -470,6 +483,13 @@ export declare function createSubagentResume(deps: {
|
|
|
470
483
|
/** RB-473 batch 2b — bounded disclosure when a deployment sink throws inside this resume closure's
|
|
471
484
|
* isolation scope (first failure per site; later ones counted only). */
|
|
472
485
|
onNotifyError?: (failure: import("../core/safe-notify.js").SafeNotifyFailure) => void;
|
|
486
|
+
/** The delegation entry gate the child was SPAWNED under — its tree's concurrency pool. A woken
|
|
487
|
+
* cycle is a running agent like any other, so it occupies that pool for exactly its own life:
|
|
488
|
+
* a cycle that revived its registry row is counted by the row (`registered`), one that runs with
|
|
489
|
+
* no row is charged to the pool's local half (`local`). Occupy only — the cap verdicts stay on the
|
|
490
|
+
* spawn door: CC 2.1.309's resume path calls `takeConcurrencySlot` (cli309.js:288053) with no cap read.
|
|
491
|
+
* Absent ⇒ the waker wakes rows only (SendMessage: every launch it makes revives a row, which counts itself). */
|
|
492
|
+
entryGate?: Pick<DelegationEntryPool, "occupy">;
|
|
473
493
|
}): (content: string) => Promise<string>;
|
|
474
494
|
/** Subagent transcript persistence — the RESOLVED delegation entry-caps pair (both members present;
|
|
475
495
|
* see {@link resolveDelegationEntryCaps}). */
|
|
@@ -495,6 +515,17 @@ export declare function delegationEntryLedgerFootprint(registry: object): {
|
|
|
495
515
|
keys: number;
|
|
496
516
|
handles: number;
|
|
497
517
|
};
|
|
518
|
+
/** Which half of the running count a started child lives in: `registered` = it has a running registry
|
|
519
|
+
* row (the row IS its count), `local` = it runs with no row and is counted by the pool's in-flight map. */
|
|
520
|
+
type DelegationEntryKind = "registered" | "local";
|
|
521
|
+
/** One session tree's delegation pool ({@link delegationEntryPool}): its key and its ONE reservation, which
|
|
522
|
+
* every child that starts running is charged through. A CONTINUATION — a retained child woken here, or a
|
|
523
|
+
* stopped child revived from its durable row — only occupies: counted, never refused by a full pool. */
|
|
524
|
+
interface DelegationEntryPool {
|
|
525
|
+
key: string | undefined;
|
|
526
|
+
/** Reserve this pool's slot for a child of `kind`; returns the idempotent giveback. */
|
|
527
|
+
occupy: (kind: DelegationEntryKind) => () => void;
|
|
528
|
+
}
|
|
498
529
|
/**
|
|
499
530
|
* Options for {@link createSubagentTool}.
|
|
500
531
|
*
|
|
@@ -560,7 +591,7 @@ export interface SubagentToolOptions {
|
|
|
560
591
|
* asynchronously, and completion fires ONE task-notification ("next" priority — design/373 §3.7 census
|
|
561
592
|
* re-seat, upstream-anchored: every background-task terminal is explicitly "next" there; the earlier
|
|
562
593
|
* "later doesn't derail active work" reading was the flat era's — a completion must reach a busy model
|
|
563
|
-
* at the boundary, not at the run's closing seat).
|
|
594
|
+
* at the boundary, not at the run's closing seat). Stop via TaskStop; the result arrives in the completion notification. Absent ⇒ synchronous only.
|
|
564
595
|
*/
|
|
565
596
|
background?: {
|
|
566
597
|
registry: import("../core/task-registry.js").TaskRegistry;
|
|
@@ -571,20 +602,21 @@ export interface SubagentToolOptions {
|
|
|
571
602
|
* matching the engine chain's `principal ?? "default"`), never implied by omission. */
|
|
572
603
|
scope: string;
|
|
573
604
|
/**
|
|
574
|
-
* Deployment-level completion-push FALLBACK — not an always-on tap.
|
|
605
|
+
* Deployment-level completion-push FALLBACK for a spawn's settle — not an always-on tap. That settle is
|
|
575
606
|
* delivered through `ctx.onTaskNotification ?? background.notify`: inside an engine-driven run
|
|
576
607
|
* the tool-execution context carries the run's own notification injector (the completion lands
|
|
577
|
-
* in the PARENT's live injection queue at its next turn boundary)
|
|
578
|
-
*
|
|
579
|
-
*
|
|
580
|
-
*
|
|
581
|
-
*
|
|
608
|
+
* in the PARENT's live injection queue at its next turn boundary) and this sink is not called for it —
|
|
609
|
+
* one completion, one channel. It fires for a settle only WITHOUT an engine notification channel (direct
|
|
610
|
+
* `execute()` harnesses, minimal mounts); with neither, no background launch is made — the agent runs synchronously
|
|
611
|
+
* (the one background admission, `admitsBackgroundLaunch`). An operator resume (`handle.resume`) is launched by no
|
|
612
|
+
* call of a run, so its completion always goes to this sink, engine-driven or not; absent, it is not delivered. An
|
|
613
|
+
* unconditional process-level completion tap is `RunnerDeps.onBackgroundChildEvent` (the BCE terminal frame).
|
|
582
614
|
*/
|
|
583
615
|
notify?: (n: import("../core/task-notification.js").TaskNotificationPayload, opts?: {
|
|
584
616
|
priority?: "now" | "next" | "later";
|
|
585
617
|
}) => void;
|
|
586
618
|
/** design/151 S1a: the durable execution-row ledger. Present ⇒ every background registration
|
|
587
|
-
* writes a durable row (restart-surviving
|
|
619
|
+
* writes a durable row (restart-surviving host reads; the S1b lifecycle flip keys off the
|
|
588
620
|
* same wiring). Absent ⇒ pre-151 in-memory-only lifecycle, unchanged. */
|
|
589
621
|
agentStore?: import("../core/background-agent-store.js").BackgroundAgentStore;
|
|
590
622
|
/** design/153 §7.3 — the park lane's checkpoint store where no host seat rides (a tool invoked outside a Runner task, and the
|
|
@@ -785,7 +817,7 @@ export interface SubagentToolOptions {
|
|
|
785
817
|
export interface SubagentSpawnContext {
|
|
786
818
|
/** THIS delegation tool-call's id — the spawn moment's stable coordinate. */
|
|
787
819
|
toolCallId: string;
|
|
788
|
-
/** The PARENT run's stable
|
|
820
|
+
/** The PARENT run's stable task id (its leg's single mint, `legTaskIdOf`; Runner-filled). Absent outside a Runner. */
|
|
789
821
|
parentTaskId?: string;
|
|
790
822
|
/** The PARENT run's session id (Runner-filled). Absent outside a Runner. */
|
|
791
823
|
parentSessionId?: string;
|
|
@@ -844,26 +876,14 @@ export declare function forkWorktreeTranslationNote(parentCwd: string | undefine
|
|
|
844
876
|
* ③ the SendMessage continuation pointer was absent — CC teaches the exact follow-up call, with the
|
|
845
877
|
* summary shape, right on the card.
|
|
846
878
|
* Registered sema-side deltas that STAY: the id is the unified `task_id` (CC: `agentId`); sema has no
|
|
847
|
-
* agent output file, so the anchor's no-outputFile variant is the one reproduced;
|
|
848
|
-
*
|
|
879
|
+
* agent output file, so the anchor's no-outputFile variant is the one reproduced; like CC, a card exists only where a
|
|
880
|
+
* notification lane does (no sink ⇒ no background launch); the caller's `notes` are sema's own
|
|
849
881
|
* per-call truths (model override, injected tools, worktree, task- vs session-scoped lifetime).
|
|
850
882
|
*/
|
|
851
883
|
export declare function asyncLaunchedReceipt(p: {
|
|
852
884
|
taskId: string;
|
|
853
885
|
/** The lane's own "what is running" opener — the Agent lane and the fork lane say different things. */
|
|
854
886
|
workingLine: string;
|
|
855
|
-
/** Whether a real notification sink is wired (the receipt speaks the RUNTIME sink truth). */
|
|
856
|
-
notify: boolean;
|
|
857
|
-
/**
|
|
858
|
-
* RB-220 — mirrors {@link import("../core/types.js").ToolExecuteContext.oneShot}: this run has no
|
|
859
|
-
* later turn for an async background notification to land in (a headless `-p` process exits once
|
|
860
|
-
* the turn ends). Checked AHEAD of `notify` below — a one-shot submission is wrong to promise a
|
|
861
|
-
* notification regardless of whether a notify sink happens to be wired, the same failure form
|
|
862
|
-
* `run_workflow`'s launch note was fixed for (RB-215/run-workflow-tool.ts): a model that follows
|
|
863
|
-
* "end your turn and wait" advice in a one-shot process loses the result — the process exits with
|
|
864
|
-
* nothing left alive to receive it. Default undefined ⇒ byte-compat (pre-RB-220 wording).
|
|
865
|
-
*/
|
|
866
|
-
oneShot?: boolean;
|
|
867
887
|
/** Per-call honest notes, rendered one per line between the status line and the closing instruction. */
|
|
868
888
|
notes?: (string | undefined)[];
|
|
869
889
|
}): string;
|
|
@@ -872,6 +892,10 @@ export declare function asyncLaunchedReceipt(p: {
|
|
|
872
892
|
*
|
|
873
893
|
* The child runs synchronously in a fresh session (isolated context) with a narrowed tool set and
|
|
874
894
|
* its own model, and returns a structured, machine-readable handoff (status / result / blockedReason / stats).
|
|
895
|
+
*
|
|
896
|
+
* The Runner passed as `runner` is also the child's deployment statement: the child resolves its read face from that Runner's
|
|
897
|
+
* `RunnerDeps.readFace` seat, so a host that binds this tool to a different Runner than the parent's has changed the seat the child
|
|
898
|
+
* reads, and the parent's `roots` still reaches the child through the restricting clamp, so the stricter side wins.
|
|
875
899
|
*/
|
|
876
900
|
export declare function createSubagentTool(opts: SubagentToolOptions): ToolSpec;
|
|
877
901
|
/**
|