@sema-agent/core 7.61.0 → 7.63.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 +840 -0
- package/dist/agents/cascade.d.ts +11 -3
- package/dist/agents/cascade.js +1 -1
- package/dist/agents/peer-held-queue.d.ts +27 -4
- package/dist/agents/peer-held-queue.js +81 -36
- package/dist/agents/peer-session-drain.js +13 -3
- package/dist/agents/subagent-transcript-placement.d.ts +23 -0
- package/dist/agents/subagent-transcript-placement.js +14 -0
- package/dist/agents/subagent.d.ts +6 -1
- package/dist/agents/subagent.js +143 -58
- package/dist/agents/suspend-guard.d.ts +38 -16
- package/dist/agents/suspend-guard.js +9 -4
- package/dist/agents/verify.js +4 -3
- package/dist/brain/route-adjudicator.js +9 -4
- package/dist/core/approval-object.js +1 -1
- package/dist/core/arg-summary.js +1 -1
- package/dist/core/ask-question.d.ts +2 -2
- package/dist/core/canonical-json.d.ts +23 -13
- package/dist/core/canonical-json.js +4 -4
- package/dist/core/checkpoint-features.d.ts +722 -0
- package/dist/core/checkpoint-features.js +98 -0
- package/dist/core/checkpoint-queries.d.ts +47 -4
- package/dist/core/checkpoint-queries.js +36 -16
- package/dist/core/checkpoint-requirements.d.ts +12 -5
- package/dist/core/checkpoint-requirements.js +11 -5
- package/dist/core/checkpoint-row-verdict.d.ts +110 -0
- package/dist/core/checkpoint-row-verdict.js +245 -0
- package/dist/core/checkpoint-store.d.ts +76 -753
- package/dist/core/checkpoint-store.js +83 -144
- package/dist/core/compliance.d.ts +6 -2
- package/dist/core/compliance.js +3 -3
- package/dist/core/engine-attestation.d.ts +1 -1
- package/dist/core/engine-notice.d.ts +38 -7
- package/dist/core/engine-notice.js +9 -2
- package/dist/core/gate-fold.js +2 -2
- package/dist/core/git-worktree-env.d.ts +62 -3
- package/dist/core/git-worktree-env.js +91 -30
- package/dist/core/governance-codes.d.ts +9 -3
- package/dist/core/governance-codes.js +16 -3
- package/dist/core/hooks.d.ts +13 -0
- package/dist/core/human-input-projection.d.ts +1 -0
- package/dist/core/human-input-projection.js +3 -0
- package/dist/core/image-admission.d.ts +1 -1
- package/dist/core/locked-config.d.ts +2 -2
- package/dist/core/mcp-host-seat.js +6 -1
- package/dist/core/memory-engine/consolidation-driver.d.ts +33 -18
- package/dist/core/memory-engine/consolidation-driver.js +99 -98
- package/dist/core/memory-engine/consolidation.d.ts +73 -10
- package/dist/core/memory-engine/consolidation.js +167 -11
- package/dist/core/memory-engine/data-plane.d.ts +8 -4
- package/dist/core/memory-engine/data-plane.js +11 -6
- package/dist/core/memory-engine/delegation-settlement.d.ts +37 -35
- package/dist/core/memory-engine/delegation-settlement.js +53 -59
- package/dist/core/memory-engine/dual-root.d.ts +12 -6
- package/dist/core/memory-engine/dual-root.js +9 -5
- package/dist/core/memory-engine/engine.d.ts +98 -35
- package/dist/core/memory-engine/engine.js +477 -380
- package/dist/core/memory-engine/entry-scan.d.ts +8 -0
- package/dist/core/memory-engine/entry-scan.js +3 -0
- package/dist/core/memory-engine/file-backend.d.ts +29 -3
- package/dist/core/memory-engine/file-backend.js +66 -35
- package/dist/core/memory-engine/index.d.ts +7 -7
- package/dist/core/memory-engine/index.js +6 -6
- package/dist/core/memory-engine/landing-admission.d.ts +5 -3
- package/dist/core/memory-engine/landing-admission.js +3 -3
- package/dist/core/memory-engine/layout.d.ts +121 -45
- package/dist/core/memory-engine/layout.js +252 -102
- package/dist/core/memory-engine/memory-backend-contract.d.ts +19 -1
- package/dist/core/memory-engine/memory-backend-contract.js +320 -0
- package/dist/core/memory-engine/memory-deployment.d.ts +31 -8
- package/dist/core/memory-engine/memory-deployment.js +26 -12
- package/dist/core/memory-engine/scope-contract.d.ts +52 -11
- package/dist/core/memory-engine/scope-contract.js +68 -19
- package/dist/core/memory-engine/session-write-home.d.ts +3 -1
- package/dist/core/memory-engine/session-write-home.js +1 -1
- package/dist/core/memory-engine/sync-client.d.ts +3 -1
- package/dist/core/memory-engine/sync-client.js +7 -0
- package/dist/core/memory-engine/sync-report.d.ts +3 -2
- package/dist/core/memory-engine/sync-report.js +6 -2
- package/dist/core/memory-engine/tools.d.ts +2 -2
- package/dist/core/memory-engine/tools.js +10 -10
- package/dist/core/memory-engine/types.d.ts +118 -19
- package/dist/core/memory-engine/types.js +1 -0
- package/dist/core/memory-vector.d.ts +1 -1
- package/dist/core/memory.d.ts +10 -10
- package/dist/core/memory.js +15 -6
- package/dist/core/mode-policy.js +1 -1
- package/dist/core/mods/classic-events.d.ts +9 -1
- package/dist/core/mods/dollar.d.ts +32 -1
- package/dist/core/mods/dollar.js +13 -1
- package/dist/core/mods/kernel/events.d.ts +11 -3
- package/dist/core/mods/kernel/events.js +13 -10
- package/dist/core/mods/lifecycle-stations.d.ts +36 -4
- package/dist/core/mods/lifecycle-stations.js +44 -9
- package/dist/core/mods/session-append.d.ts +4 -1
- package/dist/core/mods/session-append.js +7 -0
- package/dist/core/mods/session-receive.js +12 -15
- package/dist/core/mods/stations.d.ts +70 -6
- package/dist/core/mods/stations.js +144 -1
- package/dist/core/own-property-receipt.d.ts +7 -0
- package/dist/core/own-property-receipt.js +3 -0
- package/dist/core/park-selfcheck.js +2 -2
- package/dist/core/pause-registry.d.ts +2 -0
- package/dist/core/pause-registry.js +3 -0
- package/dist/core/permission-rule-consent.d.ts +10 -3
- package/dist/core/permission-rule-consent.js +37 -24
- package/dist/core/permission-rule-store.d.ts +35 -1
- package/dist/core/permission-rule-store.js +27 -8
- package/dist/core/read-only-shell.js +3 -2
- package/dist/core/read-root-candidate.js +1 -1
- package/dist/core/redaction-marks.d.ts +8 -0
- package/dist/core/redaction-marks.js +6 -0
- package/dist/core/remote-env.d.ts +12 -1
- package/dist/core/remote-env.js +3 -0
- package/dist/core/resume-startup-cause.d.ts +5 -4
- package/dist/core/runner/child-tree.d.ts +29 -3
- package/dist/core/runner/child-tree.js +39 -16
- package/dist/core/runner/compact-session.js +5 -2
- package/dist/core/runner/contracts.d.ts +36 -17
- package/dist/core/runner/delegation-owner.d.ts +43 -0
- package/dist/core/runner/delegation-owner.js +59 -0
- package/dist/core/runner/gate-exit.js +2 -2
- package/dist/core/runner/inherited-ask-grants.js +1 -1
- package/dist/core/runner/lineage-reroot-view.d.ts +56 -0
- package/dist/core/runner/lineage-reroot-view.js +108 -0
- package/dist/core/runner/memory-consolidation-driver.d.ts +6 -3
- package/dist/core/runner/memory-consolidation-driver.js +4 -4
- package/dist/core/runner/memory-consolidation-write-judge.d.ts +2 -1
- package/dist/core/runner/memory-consolidation-write-judge.js +3 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +2 -1
- package/dist/core/runner/permission-rule-lanes.js +2 -2
- package/dist/core/runner/person-path-rows.d.ts +23 -3
- package/dist/core/runner/person-path-rows.js +31 -4
- package/dist/core/runner/placement-fence.d.ts +12 -0
- package/dist/core/runner/placement-fence.js +20 -6
- package/dist/core/runner/prepare-acquire-reconcile.d.ts +4 -1
- package/dist/core/runner/prepare-acquire-reconcile.js +7 -2
- package/dist/core/runner/prepare-ask-lane.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +5 -1
- package/dist/core/runner/prepare-caps-and-workflow.js +6 -3
- package/dist/core/runner/prepare-config-doors.d.ts +6 -6
- package/dist/core/runner/prepare-config-doors.js +3 -4
- package/dist/core/runner/prepare-execution-env.js +17 -6
- package/dist/core/runner/prepare-hands-readface.d.ts +3 -2
- package/dist/core/runner/prepare-hands-readface.js +32 -10
- package/dist/core/runner/prepare-inherited-gate.d.ts +12 -8
- package/dist/core/runner/prepare-inherited-gate.js +14 -6
- package/dist/core/runner/prepare-memory-engine-session.d.ts +2 -4
- package/dist/core/runner/prepare-memory-engine-session.js +4 -4
- package/dist/core/runner/prepare-memory.d.ts +3 -2
- package/dist/core/runner/prepare-memory.js +28 -20
- package/dist/core/runner/prepare-park-ask.js +4 -3
- package/dist/core/runner/prepare-task.js +22 -16
- package/dist/core/runner/prepare-workspace-restore.js +3 -6
- package/dist/core/runner/resume-admission.d.ts +3 -3
- package/dist/core/runner/resume-admission.js +6 -3
- package/dist/core/runner/resume-apply.d.ts +4 -0
- package/dist/core/runner/resume-apply.js +11 -4
- package/dist/core/runner/resume-checkpoint-screen.d.ts +9 -0
- package/dist/core/runner/resume-checkpoint-screen.js +4 -84
- package/dist/core/runner/run-git-lane.d.ts +2 -0
- package/dist/core/runner/run-git-lane.js +4 -1
- package/dist/core/runner/run-harness-handlers.d.ts +2 -0
- package/dist/core/runner/run-harness-handlers.js +3 -2
- package/dist/core/runner/run-leg.js +25 -8
- package/dist/core/runner/run-settle-and-teardown.js +6 -4
- package/dist/core/runner/run-stop-and-final-verify.js +2 -1
- package/dist/core/runner/run-turn-boundary.js +7 -4
- package/dist/core/runner/runtask.js +6 -6
- package/dist/core/runner/steering-preview.d.ts +9 -0
- package/dist/core/runner/steering-preview.js +5 -0
- package/dist/core/runner/stream-steer-verb.js +8 -0
- package/dist/core/runner/terminal-account.js +1 -1
- package/dist/core/runner/tool-face-overlay.js +2 -0
- package/dist/core/runner/turn-attachments.d.ts +5 -0
- package/dist/core/runner/turn-attachments.js +1 -1
- package/dist/core/runner-deps.d.ts +8 -4
- package/dist/core/secret-env.d.ts +9 -6
- package/dist/core/secret-env.js +41 -22
- package/dist/core/session-checkout.d.ts +108 -0
- package/dist/core/session-checkout.js +485 -0
- package/dist/core/session-store.d.ts +13 -5
- package/dist/core/session-store.js +28 -4
- package/dist/core/session.d.ts +29 -5
- package/dist/core/session.js +3 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +6 -12
- package/dist/core/store-contracts/checkpoint-store-contract.js +73 -6
- package/dist/core/store-contracts/session-store-contract.js +61 -8
- package/dist/core/task-event.d.ts +28 -1
- package/dist/core/task-notification.d.ts +9 -1
- package/dist/core/task-notification.js +8 -1
- package/dist/core/task-registry-agent.d.ts +40 -8
- package/dist/core/task-registry-agent.js +57 -24
- package/dist/core/task-registry-shared.d.ts +33 -11
- package/dist/core/task-registry-workflow.js +4 -3
- package/dist/core/task-registry.d.ts +27 -10
- package/dist/core/task-registry.js +19 -13
- package/dist/core/task-result.d.ts +5 -5
- package/dist/core/task-spec-members.js +1 -1
- package/dist/core/task-spec.d.ts +21 -1
- package/dist/core/terminal-cause.d.ts +6 -6
- package/dist/core/tool-face.d.ts +6 -2
- package/dist/core/tool-face.js +1 -1
- package/dist/core/tool-policy.d.ts +16 -13
- package/dist/core/tool-policy.js +11 -10
- package/dist/core/tool-roster.d.ts +4 -4
- package/dist/core/tool-spec.d.ts +42 -19
- package/dist/core/types.d.ts +2 -2
- package/dist/core/types.js +1 -1
- package/dist/core/untrusted-egress.d.ts +15 -4
- package/dist/core/untrusted-egress.js +23 -22
- package/dist/core/workspace-snapshot.d.ts +3 -1
- package/dist/core/workspace-snapshot.js +1 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +3 -0
- package/dist/engine/execution-env/node-execution-env.js +12 -5
- package/dist/engine/harness/types.d.ts +77 -1
- package/dist/engine/harness/types.js +108 -0
- package/dist/engine/session/import-validate.js +6 -1
- package/dist/engine/session/parent-chain-guard.d.ts +3 -3
- package/dist/engine/session/parent-chain-guard.js +1 -1
- package/dist/engine/session/path-to-root.d.ts +18 -3
- package/dist/engine/session/path-to-root.js +15 -1
- package/dist/engine/session/repo-utils.d.ts +12 -1
- package/dist/engine/session/repo-utils.js +41 -0
- package/dist/engine/session/session.d.ts +24 -1
- package/dist/engine/session/session.js +46 -2
- package/dist/engine/session/storage-base.d.ts +20 -0
- package/dist/engine/session/storage-base.js +28 -9
- package/dist/index.d.ts +16 -12
- package/dist/index.js +11 -8
- package/dist/internal/harness-types.d.ts +1 -1
- package/dist/internal/harness.d.ts +4 -3
- package/dist/internal/harness.js +3 -2
- package/dist/orchestration/run-workflow-tool.d.ts +7 -1
- package/dist/orchestration/run-workflow-tool.js +28 -11
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow.d.ts +6 -0
- package/dist/orchestration/workflow.js +5 -8
- package/dist/stores/file/checkpoint-store.d.ts +2 -0
- package/dist/stores/file/checkpoint-store.js +7 -6
- package/dist/stores/file/fs-atomic.d.ts +0 -22
- package/dist/stores/file/fs-atomic.js +0 -17
- package/dist/stores/file/index.d.ts +2 -9
- package/dist/stores/file/index.js +2 -4
- package/dist/stores/file/session-store.d.ts +13 -7
- package/dist/stores/file/session-store.js +42 -18
- package/dist/tools/fs/bash-program-position.d.ts +3 -2
- package/dist/tools/fs/bash-program-position.js +10 -10
- package/dist/tools/fs/program-read-model.d.ts +34 -10
- package/dist/tools/fs/program-read-model.js +37 -7
- package/dist/tools/fs/program-read-model.rows.js +13 -2
- package/dist/tools/fs/read-deny.d.ts +13 -1
- package/dist/tools/fs/read-deny.js +10 -2
- package/dist/tools/fs/removal-targets.js +5 -5
- package/dist/tools/fs/safety.d.ts +2 -0
- package/dist/tools/fs/safety.js +1 -1
- package/dist/tools/fs/shell-read-argv.d.ts +11 -2
- package/dist/tools/fs/shell-read-argv.js +45 -29
- package/dist/tools/fs/shell-read-bindings.d.ts +20 -2
- package/dist/tools/fs/shell-read-bindings.js +153 -69
- package/dist/tools/fs/shell-read-brace.d.ts +18 -0
- package/dist/tools/fs/shell-read-brace.js +79 -0
- package/dist/tools/fs/shell-read-check.js +29 -11
- package/dist/tools/fs/shell-read-establish.js +43 -22
- package/dist/tools/fs/shell-read-functions.js +2 -2
- package/dist/tools/fs/shell-read-judge.d.ts +11 -0
- package/dist/tools/fs/shell-read-judge.js +3 -3
- package/dist/tools/fs/shell-read-object-path.d.ts +59 -0
- package/dist/tools/fs/shell-read-object-path.js +119 -0
- package/dist/tools/fs/shell-read-plan.d.ts +18 -0
- package/dist/tools/fs/shell-read-plan.js +217 -104
- package/dist/tools/fs/shell-read-start.d.ts +76 -13
- package/dist/tools/fs/shell-read-start.js +97 -17
- package/dist/tools/fs/shell-read-word.d.ts +10 -0
- package/dist/tools/fs/shell-read-word.js +9 -5
- package/dist/tools/fs/shell-read-workdir.d.ts +54 -14
- package/dist/tools/fs/shell-read-workdir.js +103 -19
- package/dist/tools/fs/shell-read-write-targets.js +13 -8
- package/dist/tools/worktree.d.ts +3 -2
- package/dist/tools/worktree.js +7 -35
- package/package.json +3 -2
- package/test/export-surface.snapshot.json +93 -43
- package/wire-changes/core-stores-sql@7.62.0.json +30 -0
- package/wire-changes/core-stores-sql@7.63.0.json +30 -0
- package/wire-changes/core@7.62.0.json +2181 -0
- package/wire-changes/core@7.63.0.json +3523 -0
- package/wire-changes/mods-kernel@7.62.0.json +42 -0
- package/wire-changes/mods-kernel@7.63.0.json +30 -0
- package/wire-changes/primitives@7.62.0.json +30 -0
- package/wire-changes/primitives@7.63.0.json +445 -0
- package/dist/core/consolidate-scope.d.ts +0 -93
- package/dist/core/consolidate-scope.js +0 -98
- package/dist/core/credential-vocabulary.d.ts +0 -176
- package/dist/core/credential-vocabulary.js +0 -190
- package/dist/core/redaction-passes.d.ts +0 -82
- package/dist/core/redaction-passes.js +0 -377
- package/dist/core/runner/memory-consolidation.d.ts +0 -109
- package/dist/core/runner/memory-consolidation.js +0 -251
package/dist/agents/subagent.js
CHANGED
|
@@ -3,7 +3,7 @@ import { isAbsolute } from "node:path";
|
|
|
3
3
|
import { backgroundChildTerminal } from "../core/delegation-frames.js";
|
|
4
4
|
import { bindDelegationName } from "../core/delegation-name.js";
|
|
5
5
|
import { authoredSteerOf } from "../core/input-author.js";
|
|
6
|
-
import {
|
|
6
|
+
import { DELEGATION_OWNER_UNBOUND, delegationOwnerOf, rowOwnerReading } from "../core/runner/delegation-owner.js";
|
|
7
7
|
import { resumeRefusalDetailOf, resumeStartupCauseOf } from "../core/resume-startup-cause.js";
|
|
8
8
|
import { errorCodeOf, thrownFailureOf } from "../core/runner/terminal-account.js";
|
|
9
9
|
import { applyParentSpecSeat, parentSpecSeatOfCtx } from "../core/parent-spec-seat.js";
|
|
@@ -32,10 +32,11 @@ import { normalizePeerName, reservedPeerNameReason } from "./cross-session-ref.j
|
|
|
32
32
|
import { SUBAGENT_PROMPT } from "../prompts/default.js";
|
|
33
33
|
import { roleBaseOf } from "../prompt-assembly/role-base.js";
|
|
34
34
|
import { readPromptRole } from "../prompt-assembly/select.js";
|
|
35
|
-
import { hasSessionFork } from "../core/session.js";
|
|
35
|
+
import { declaresSubagentPlacement, hasSessionFork } from "../core/session.js";
|
|
36
36
|
import { isDurablePause, pauseFamily } from "./suspend-guard.js";
|
|
37
37
|
import { childRejection, childTerminalFace, childThrownText } from "./child-failure.js";
|
|
38
38
|
import { forwardSafely } from "../core/runner/forward-sink.js";
|
|
39
|
+
import { callerPlacementSeats } from "../core/runner/child-tree.js";
|
|
39
40
|
import { legTaskIdOf } from "../core/leg-identity.js";
|
|
40
41
|
import { delimitUntrusted, inlineUntrusted } from "../core/untrusted-text.js";
|
|
41
42
|
import { createSafeNotifier } from "../core/safe-notify.js";
|
|
@@ -47,7 +48,8 @@ import { BG_AGENT_REAP_STOP_ERROR, chosenAgentName } from "../core/task-registry
|
|
|
47
48
|
import { readDurableOrgAdmission } from "../core/memory-admission.js";
|
|
48
49
|
import { governanceRetryClass } from "../core/governance-codes.js";
|
|
49
50
|
import { readSkillGrantCapture } from "../core/skill-grant.js";
|
|
50
|
-
import { admitsBackgroundLaunch, completionResultField, oweTerminalDelivery, resolveCompletionSink, terminalFrameFacets } from "../core/task-notification.js";
|
|
51
|
+
import { admitsBackgroundLaunch, completionResultField, moveTerminalDelivery, oweTerminalDelivery, resolveCompletionSink, terminalFrameFacets } from "../core/task-notification.js";
|
|
52
|
+
import { deliverEngineNotice } from "../core/engine-notice.js";
|
|
51
53
|
import { RETAIN_DEFAULT_TTL_MS, RETAIN_DEFAULT_MAX, RUNNING_AGENT_OBSERVE_EVERY_BEATS, DELEGATION_MAX_CONCURRENT_DEFAULT, DELEGATION_MAX_PER_SESSION_DEFAULT } from "../config/defaults.js";
|
|
52
54
|
function rollupDelegatedCost(stats, nested) {
|
|
53
55
|
if (stats.costMicroUsd === undefined)
|
|
@@ -81,6 +83,7 @@ import { LAUNCH_RECEIPT_OWN_WORDS_CLAUSE, launchReceiptNoQuoteClause } from "./l
|
|
|
81
83
|
import { ObserverDigestTap, ObserverPairing, createObserverReportToolSpec, markObserverTaskId, unmarkObserverTaskId, isObserverTaskId, ObserverResumeStateError, ObserverStoppedByUserError, observerFramingPrompt, observerSlug, resolveObserverDeclaration, } from "./observer.js";
|
|
82
84
|
import { SubagentStepRecorder, redactThenCut } from "./subagent-steps.js";
|
|
83
85
|
import { childOwnerKeys, parkCompletionNotify, runningBackgroundUnder } from "./subagent-completion-gate.js";
|
|
86
|
+
import { placesSubagentTranscripts, subagentTranscriptPlacement } from "./subagent-transcript-placement.js";
|
|
84
87
|
import { OUTPUT_TOOL_NAME, mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
85
88
|
import { canonicalNameValue } from "../core/permission-rule-model.js";
|
|
86
89
|
import { definitionAllowTools, inheritedChildPool, inheritedHostSeats, inheritedMcpDeclarations, withDefinitionServers, withoutWakerSeats } from "./inherited-tool-pool.js";
|
|
@@ -387,6 +390,7 @@ const SUBAGENT_ERROR_KIND_BY_CODE = {
|
|
|
387
390
|
stream_torn: "network",
|
|
388
391
|
refusal: "logic",
|
|
389
392
|
length_empty: "logic",
|
|
393
|
+
"config.placement_not_honored": "logic",
|
|
390
394
|
};
|
|
391
395
|
const SUBAGENT_RETRYABLE = {
|
|
392
396
|
rate_limit: true,
|
|
@@ -1084,6 +1088,28 @@ function chargeLocalDelegationInFlight(anchor, key) {
|
|
|
1084
1088
|
live.delete(key);
|
|
1085
1089
|
};
|
|
1086
1090
|
}
|
|
1091
|
+
const REFUSAL_OCCUPANTS_LISTED = 5;
|
|
1092
|
+
function reachableOccupants(registry, scope, root, caller) {
|
|
1093
|
+
const face = registry === undefined ? undefined : registry.activeDelegationOccupants;
|
|
1094
|
+
if (typeof face !== "function")
|
|
1095
|
+
return new Map();
|
|
1096
|
+
try {
|
|
1097
|
+
return new Map(face.call(registry, scope, root, caller).filter((o) => o.reachable).map((o) => [o.id, o.name]));
|
|
1098
|
+
}
|
|
1099
|
+
catch {
|
|
1100
|
+
return new Map();
|
|
1101
|
+
}
|
|
1102
|
+
}
|
|
1103
|
+
function concurrencyOccupants(active, reachable, local) {
|
|
1104
|
+
const listed = active.filter((id) => reachable.has(id)).slice(0, REFUSAL_OCCUPANTS_LISTED);
|
|
1105
|
+
const parts = listed.map((id) => `task_id ${id} (${JSON.stringify(reachable.get(id))})`);
|
|
1106
|
+
const rest = active.length - listed.length;
|
|
1107
|
+
if (rest > 0)
|
|
1108
|
+
parts.push(`${rest} ${listed.length > 0 ? "more " : ""}registered`);
|
|
1109
|
+
if (local > 0)
|
|
1110
|
+
parts.push(`${local} running synchronously inside a call of this tree, no task_id`);
|
|
1111
|
+
return { text: parts.join(", "), stoppable: listed.length > 0 };
|
|
1112
|
+
}
|
|
1087
1113
|
const spawnAbortedResult = (wt, fault) => notStartedResult({
|
|
1088
1114
|
isError: true,
|
|
1089
1115
|
content: `Sub-agent not started: the delegating call was aborted.${wt ? `\n${wt}` : ""}`,
|
|
@@ -1119,7 +1145,7 @@ function delegationEntryPool(seat) {
|
|
|
1119
1145
|
return { key, occupy: (kind) => (kind === "local" ? chargeLocalDelegationInFlight(seat.poolAnchor, key) : noopRelease) };
|
|
1120
1146
|
}
|
|
1121
1147
|
async function openDelegationEntryGate(input) {
|
|
1122
|
-
const { poolAnchor, registry, store, root, caps, signal } = input;
|
|
1148
|
+
const { poolAnchor, registry, store, root, caps, signal, caller } = input;
|
|
1123
1149
|
const pool = delegationEntryPool(input);
|
|
1124
1150
|
if (root === undefined)
|
|
1125
1151
|
return { ...pool, admit: () => ({ admitted: true, release: noopRelease }) };
|
|
@@ -1143,11 +1169,13 @@ async function openDelegationEntryGate(input) {
|
|
|
1143
1169
|
const local = localDelegationInFlightCount(poolAnchor, key);
|
|
1144
1170
|
const running = active.length + local;
|
|
1145
1171
|
if (running >= caps.maxConcurrent) {
|
|
1172
|
+
const who = concurrencyOccupants(active, reachableOccupants(registry, scope, root, { ...caller, scope }), local);
|
|
1173
|
+
const stop = who.stoppable ? " or stop a listed one (TaskStop with its task_id)" : "";
|
|
1146
1174
|
return {
|
|
1147
1175
|
admitted: false,
|
|
1148
1176
|
refusal: {
|
|
1149
1177
|
code: "delegation.concurrency_cap",
|
|
1150
|
-
text: `this session tree already has ${running} agents running — the concurrency cap (${caps.maxConcurrent}; RunnerDeps.delegationEntryCaps.maxConcurrent) refuses another. ${kind === "registered" ?
|
|
1178
|
+
text: `this session tree already has ${running} agents running${who.text === "" ? "" : ` (${who.text})`} — the concurrency cap (${caps.maxConcurrent}; RunnerDeps.delegationEntryCaps.maxConcurrent) refuses another. ${kind === "registered" ? `Wait for one to complete (you will be notified)${stop}, then relaunch.` : `Wait for one of them to finish${stop}, then try again.`}`,
|
|
1151
1179
|
},
|
|
1152
1180
|
};
|
|
1153
1181
|
}
|
|
@@ -1511,7 +1539,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1511
1539
|
const a = canonicalSubagentTypeArgs(args, acceptedSubagentTypes(), generalPurposeShadowed);
|
|
1512
1540
|
const parentSpecSeat = parentSpecSeatOfCtx(ctx);
|
|
1513
1541
|
const reviveClaim = ctx.reviveClaim;
|
|
1514
|
-
const
|
|
1542
|
+
const parkedLane = reviveClaim?.parkedResume !== undefined ? opts.background?.registry.parkedCompletionSink(reviveClaim.row.handle) : undefined;
|
|
1543
|
+
const backgroundSink = opts.background !== undefined ? resolveCompletionSink(ctx.onTaskNotification ?? parkedLane, opts.background.notify) : undefined;
|
|
1515
1544
|
const backgroundLane = opts.background !== undefined && admitsBackgroundLaunch(backgroundSink);
|
|
1516
1545
|
if (reviveClaim !== undefined && !backgroundLane) {
|
|
1517
1546
|
return notStartedResult({
|
|
@@ -1815,6 +1844,10 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1815
1844
|
...(cause !== undefined ? { cause: childThrownText(cause) } : {}),
|
|
1816
1845
|
...(worktreeFault !== undefined ? { worktreeCause: worktreeFault } : {}),
|
|
1817
1846
|
});
|
|
1847
|
+
const ownerUnboundResult = async (background, tree) => {
|
|
1848
|
+
const wt = await finishWorktree();
|
|
1849
|
+
return notStartedResult(errorResult(`${background ? "Sub-agent not started in background" : "Sub-agent not started"}: the delegation tree's owner does not bind — ${tree.reason.slice(0, 600)}.${wt ? `\n${wt.slice(0, 1600)}` : ""}`, { error: DELEGATION_OWNER_UNBOUND, code: DELEGATION_OWNER_UNBOUND, ...faultDetails(tree.fault) }));
|
|
1850
|
+
};
|
|
1818
1851
|
let injectedTools = [];
|
|
1819
1852
|
let extraToolsNote;
|
|
1820
1853
|
const treeBudget = extraToolsBudget ?? { used: 0 };
|
|
@@ -2143,7 +2176,14 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2143
2176
|
? (reviveClaim.row.rootSessionId ?? reviveClaim.row.parentSessionId ?? (reviveClaim.row.sessionScoped ? reviveClaim.row.owner : undefined))
|
|
2144
2177
|
: (ctx.rootSessionId ?? ctx.sessionId);
|
|
2145
2178
|
const entryPoolSeat = { poolAnchor: entryCapPoolAnchor, scope: treeScope, root: entryCapRoot };
|
|
2146
|
-
const openEntryGate = () => openDelegationEntryGate({
|
|
2179
|
+
const openEntryGate = () => openDelegationEntryGate({
|
|
2180
|
+
...entryPoolSeat,
|
|
2181
|
+
registry: opts.background?.registry,
|
|
2182
|
+
store: opts.background?.agentStore,
|
|
2183
|
+
caps: entryCaps,
|
|
2184
|
+
signal: ctx.signal,
|
|
2185
|
+
caller: { owner: ctx.taskId ?? opts.background?.owner, ...(ctx.sessionId !== undefined ? { sessionId: ctx.sessionId } : {}) },
|
|
2186
|
+
});
|
|
2147
2187
|
const provenanceRequest = ctx.delegationProvenanceForChildren?.();
|
|
2148
2188
|
const childProvenanceRef = provenanceRequest !== undefined ? { current: newDelegationProvenanceAggregate() } : undefined;
|
|
2149
2189
|
const childAttestation = (completed) => childProvenanceRef !== undefined ? reduceDelegationAttestation(childProvenanceRef.current, { completed }) : undefined;
|
|
@@ -2162,6 +2202,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2162
2202
|
...(inheritedAllowedTools !== undefined && inheritedAllowedTools.length > 0 ? { inheritedAllowedTools: [...inheritedAllowedTools] } : {}),
|
|
2163
2203
|
...(childProvenanceRef !== undefined && provenanceRequest !== undefined ? { delegationProvenance: { ref: childProvenanceRef, contentSafety: provenanceRequest } } : {}),
|
|
2164
2204
|
...(reviveClaim === undefined && ctx.crossBoundaryTreeForChildren !== undefined ? { crossBoundaryTree: ctx.crossBoundaryTreeForChildren } : {}),
|
|
2205
|
+
...(reviveClaim === undefined && ctx.delegationOwner !== undefined ? { delegationOwner: ctx.delegationOwner } : {}),
|
|
2165
2206
|
...(treeScope !== undefined ? { registryScope: treeScope } : {}),
|
|
2166
2207
|
...(ctx.checkpointScopeForChildren !== undefined ? { checkpointScope: ctx.checkpointScopeForChildren } : {}),
|
|
2167
2208
|
...(ctx.inheritedGateForChildren ? { inheritedGate: ctx.inheritedGateForChildren() } : {}),
|
|
@@ -2220,7 +2261,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2220
2261
|
})(),
|
|
2221
2262
|
...(ctx.subagentRetain !== undefined ? { parentRetainLedger: ctx.subagentRetain } : {}),
|
|
2222
2263
|
onForwardEvent: recordingForward,
|
|
2223
|
-
...(ctx.parentCwd
|
|
2264
|
+
...callerPlacementSeats(ctx.parentCwd, ctx.callerRoot),
|
|
2224
2265
|
...(ctx.placementTarget !== undefined ? { placementTarget: ctx.placementTarget } : {}),
|
|
2225
2266
|
...(worktreeDir !== undefined
|
|
2226
2267
|
? { parentCwd: worktreeDir, worktreeOffered: true, onWorkspaceResolved: (ws) => void (childPlacement = ws) }
|
|
@@ -2455,14 +2496,20 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2455
2496
|
if (wantsFork) {
|
|
2456
2497
|
let forkedId;
|
|
2457
2498
|
let releaseForked;
|
|
2499
|
+
const forkTree = await delegationOwnerOf(ctx.delegationOwner);
|
|
2500
|
+
if (!forkTree.bound)
|
|
2501
|
+
return ownerUnboundResult(false, forkTree);
|
|
2502
|
+
const forkBg = wantsBackground ? opts.background : undefined;
|
|
2503
|
+
const forkPlacementHandle = forkBg?.agentStore !== undefined ? forkBg.registry.mintTaskId("background_agent") : undefined;
|
|
2504
|
+
const forkOpts = forkPlacementHandle !== undefined ? { placement: subagentTranscriptPlacement(ctx, treeScope, forkPlacementHandle) } : undefined;
|
|
2458
2505
|
try {
|
|
2459
2506
|
if (ctx.hostSessionFork) {
|
|
2460
|
-
const forkHandle = await ctx.hostSessionFork();
|
|
2507
|
+
const forkHandle = await ctx.hostSessionFork(forkOpts);
|
|
2461
2508
|
forkedId = forkHandle?.sessionId ?? null;
|
|
2462
2509
|
releaseForked = forkHandle?.release;
|
|
2463
2510
|
}
|
|
2464
2511
|
else {
|
|
2465
|
-
forkedId = (await opts.runner.sessions.fork?.(ctx.sessionId,
|
|
2512
|
+
forkedId = (await opts.runner.sessions.fork?.(ctx.sessionId, forkTree.owner, declaresSubagentPlacement(opts.runner.sessions) ? forkOpts : undefined)) ?? null;
|
|
2466
2513
|
}
|
|
2467
2514
|
}
|
|
2468
2515
|
catch (e) {
|
|
@@ -2512,7 +2559,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2512
2559
|
const forkSettleId = forkSettlementSeat !== undefined ? `bg-${uuidv7()}` : undefined;
|
|
2513
2560
|
if (forkSettlementSeat !== undefined && forkSettleId !== undefined) {
|
|
2514
2561
|
try {
|
|
2515
|
-
registerDelegationLaunch(forkSettlementSeat.
|
|
2562
|
+
await registerDelegationLaunch(forkSettlementSeat.governance, { settleId: forkSettleId, sessionId: forkSettlementSeat.sessionId, now: Date.now, ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}) });
|
|
2516
2563
|
}
|
|
2517
2564
|
catch (e) {
|
|
2518
2565
|
dropHostAbortListener();
|
|
@@ -2524,7 +2571,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2524
2571
|
});
|
|
2525
2572
|
}
|
|
2526
2573
|
}
|
|
2527
|
-
const settleForkRow = (terminal) => {
|
|
2574
|
+
const settleForkRow = async (terminal) => {
|
|
2528
2575
|
if (forkSettlementSeat === undefined || forkSettleId === undefined)
|
|
2529
2576
|
return;
|
|
2530
2577
|
const att = terminal !== undefined ? childAttestation(terminal.kind === "completed") : undefined;
|
|
@@ -2533,7 +2580,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2533
2580
|
let lastErr;
|
|
2534
2581
|
for (let attempt = 0; attempt < 3 && !settled; attempt++) {
|
|
2535
2582
|
try {
|
|
2536
|
-
settleDelegation(forkSettlementSeat.
|
|
2583
|
+
await settleDelegation(forkSettlementSeat.governance, { settleId: forkSettleId, status: verdict, now: Date.now });
|
|
2537
2584
|
settled = true;
|
|
2538
2585
|
}
|
|
2539
2586
|
catch (e) {
|
|
@@ -2542,7 +2589,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2542
2589
|
}
|
|
2543
2590
|
if (settled && verdict === "external") {
|
|
2544
2591
|
try {
|
|
2545
|
-
replayExternalSettlementEffects(forkSettlementSeat.controlDir, { carry: true, now: Date.now });
|
|
2592
|
+
await replayExternalSettlementEffects(forkSettlementSeat.governance, forkSettlementSeat.controlDir, { carry: true, now: Date.now });
|
|
2546
2593
|
}
|
|
2547
2594
|
catch {
|
|
2548
2595
|
}
|
|
@@ -2555,6 +2602,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2555
2602
|
let taskId;
|
|
2556
2603
|
try {
|
|
2557
2604
|
taskId = bg.registry.registerBackgroundAgent({
|
|
2605
|
+
...(forkPlacementHandle !== undefined ? { id: forkPlacementHandle } : {}),
|
|
2558
2606
|
...(bgOwner !== undefined ? { owner: bgOwner } : {}),
|
|
2559
2607
|
...(bgScope !== undefined ? { scope: bgScope } : {}),
|
|
2560
2608
|
...(sessionScopedBg ? { sessionScoped: true } : {}),
|
|
@@ -2582,7 +2630,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2582
2630
|
const wt = await finishWorktree();
|
|
2583
2631
|
if (forkSettlementSeat !== undefined && forkSettleId !== undefined) {
|
|
2584
2632
|
try {
|
|
2585
|
-
settleDelegation(forkSettlementSeat.
|
|
2633
|
+
await settleDelegation(forkSettlementSeat.governance, { settleId: forkSettleId, status: "void", now: Date.now, note: "registration failed before invoke (not dispatched)" });
|
|
2586
2634
|
}
|
|
2587
2635
|
catch {
|
|
2588
2636
|
}
|
|
@@ -2593,7 +2641,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2593
2641
|
chargeDelegationEntryHandle(bg.registry, forkEntryGate.key, bg.agentStore, taskId);
|
|
2594
2642
|
oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
|
|
2595
2643
|
childInternals.peerSelfRef?.addAxis("h", taskId);
|
|
2596
|
-
bg.registry.bindBackgroundAgentSession(taskId, forkedId);
|
|
2644
|
+
bg.registry.bindBackgroundAgentSession(taskId, forkedId, opts.runner.sessions);
|
|
2597
2645
|
stepRecorder.lockTo(taskId);
|
|
2598
2646
|
const forkBgHangAt = Date.now();
|
|
2599
2647
|
bg.registry.attachAgentTerminalNotifier(taskId, () => {
|
|
@@ -2726,8 +2774,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2726
2774
|
void bgForkChild
|
|
2727
2775
|
.then(async (child) => {
|
|
2728
2776
|
const childFace = childTerminalFace(child.terminal);
|
|
2729
|
-
settleForkRow(child.terminal);
|
|
2777
|
+
const forkSettled = settleForkRow(child.terminal);
|
|
2730
2778
|
dropHostAbortListener();
|
|
2779
|
+
await forkSettled;
|
|
2731
2780
|
await finishWorktree(child.terminal);
|
|
2732
2781
|
try {
|
|
2733
2782
|
const nsb = child.stats.nested;
|
|
@@ -2808,7 +2857,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2808
2857
|
}
|
|
2809
2858
|
})
|
|
2810
2859
|
.catch((e) => {
|
|
2811
|
-
settleForkRow({ kind: "failed" });
|
|
2860
|
+
void settleForkRow({ kind: "failed" });
|
|
2812
2861
|
dropHostAbortListener();
|
|
2813
2862
|
void finishWorktree();
|
|
2814
2863
|
const killed = abort.signal.aborted;
|
|
@@ -2981,6 +3030,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2981
3030
|
const abort = new AbortController();
|
|
2982
3031
|
const reviveRow = reviveClaim?.row;
|
|
2983
3032
|
const parkedResume = reviveClaim?.parkedResume;
|
|
3033
|
+
let cycleSink = parkedResume !== undefined && parkedLane !== undefined ? parkedLane : notify;
|
|
2984
3034
|
const sessionScopedBg = reviveRow !== undefined ? reviveRow.sessionScoped : ctx.backgroundScope === "session" && ctx.sessionId !== undefined;
|
|
2985
3035
|
const outlivesThisRequest = sessionScopedBg || reviveRow !== undefined;
|
|
2986
3036
|
const onHostAbort = () => abort.abort();
|
|
@@ -2994,6 +3044,17 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2994
3044
|
const shortDesc = reviveRow?.description ?? String(a.description ?? "sub-agent").slice(0, 200);
|
|
2995
3045
|
const bgOwner = reviveRow !== undefined ? reviveRow.owner : sessionScopedBg ? ctx.sessionId : ctx.taskId ?? bg.owner;
|
|
2996
3046
|
const bgScope = treeScope;
|
|
3047
|
+
const childTreeOwner = () => (reviveRow !== undefined ? rowOwnerReading(opts.runner.sessions, reviveRow.sessionId) : delegationOwnerOf(ctx.delegationOwner));
|
|
3048
|
+
let placedTreeOwner;
|
|
3049
|
+
if (reviveRow === undefined && placesSubagentTranscripts(bg.agentStore, opts.runner.sessions)) {
|
|
3050
|
+
const tree = await childTreeOwner();
|
|
3051
|
+
if (!tree.bound) {
|
|
3052
|
+
dropHostAbortListener();
|
|
3053
|
+
await cancelObserver();
|
|
3054
|
+
return ownerUnboundResult(true, tree);
|
|
3055
|
+
}
|
|
3056
|
+
placedTreeOwner = tree.owner;
|
|
3057
|
+
}
|
|
2997
3058
|
const bgEntryPool = delegationEntryPool(entryPoolSeat);
|
|
2998
3059
|
const capLedgerKey = bgEntryPool.key;
|
|
2999
3060
|
if (reviveRow !== undefined) {
|
|
@@ -3012,7 +3073,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3012
3073
|
const bgSettleId = settlementSeat !== undefined ? `bg-${uuidv7()}` : undefined;
|
|
3013
3074
|
if (settlementSeat !== undefined && bgSettleId !== undefined) {
|
|
3014
3075
|
try {
|
|
3015
|
-
registerDelegationLaunch(settlementSeat.
|
|
3076
|
+
await registerDelegationLaunch(settlementSeat.governance, { settleId: bgSettleId, sessionId: settlementSeat.sessionId, now: Date.now, ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}) });
|
|
3016
3077
|
}
|
|
3017
3078
|
catch (e) {
|
|
3018
3079
|
dropHostAbortListener();
|
|
@@ -3025,7 +3086,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3025
3086
|
});
|
|
3026
3087
|
}
|
|
3027
3088
|
}
|
|
3028
|
-
const settleDelegationRow = (terminal) => {
|
|
3089
|
+
const settleDelegationRow = async (terminal) => {
|
|
3029
3090
|
if (settlementSeat === undefined || bgSettleId === undefined)
|
|
3030
3091
|
return;
|
|
3031
3092
|
const att = terminal !== undefined ? childAttestation(terminal.kind === "completed") : undefined;
|
|
@@ -3034,7 +3095,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3034
3095
|
let lastErr;
|
|
3035
3096
|
for (let attempt = 0; attempt < 3 && !settled; attempt++) {
|
|
3036
3097
|
try {
|
|
3037
|
-
settleDelegation(settlementSeat.
|
|
3098
|
+
await settleDelegation(settlementSeat.governance, { settleId: bgSettleId, status: verdict, now: Date.now });
|
|
3038
3099
|
settled = true;
|
|
3039
3100
|
}
|
|
3040
3101
|
catch (e) {
|
|
@@ -3043,7 +3104,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3043
3104
|
}
|
|
3044
3105
|
if (settled && verdict === "external") {
|
|
3045
3106
|
try {
|
|
3046
|
-
replayExternalSettlementEffects(settlementSeat.controlDir, { carry: true, now: Date.now });
|
|
3107
|
+
await replayExternalSettlementEffects(settlementSeat.governance, settlementSeat.controlDir, { carry: true, now: Date.now });
|
|
3047
3108
|
}
|
|
3048
3109
|
catch {
|
|
3049
3110
|
}
|
|
@@ -3114,7 +3175,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3114
3175
|
const wt = await finishWorktree();
|
|
3115
3176
|
if (settlementSeat !== undefined && bgSettleId !== undefined) {
|
|
3116
3177
|
try {
|
|
3117
|
-
settleDelegation(settlementSeat.
|
|
3178
|
+
await settleDelegation(settlementSeat.governance, { settleId: bgSettleId, status: "void", now: Date.now, note: "registration failed before invoke (not dispatched)" });
|
|
3118
3179
|
}
|
|
3119
3180
|
catch {
|
|
3120
3181
|
}
|
|
@@ -3123,7 +3184,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3123
3184
|
}
|
|
3124
3185
|
if (capLedgerKey !== undefined)
|
|
3125
3186
|
chargeDelegationEntryHandle(bg.registry, capLedgerKey, bg.agentStore, reviveRow === undefined ? taskId : undefined);
|
|
3126
|
-
|
|
3187
|
+
if (parkedResume === undefined)
|
|
3188
|
+
oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
|
|
3127
3189
|
childInternals.peerSelfRef?.addAxis("h", taskId);
|
|
3128
3190
|
if (agentName !== undefined) {
|
|
3129
3191
|
recordRosterSpawn(ctx.roster, { name: agentName, agentId: taskId, toolUseId: ctx.toolCallId, owner: bgOwner, scope: bgScope, ...(reviveRow !== undefined ? (reviveRow.model !== undefined ? { model: reviveRow.model } : {}) : rowModelKey !== undefined ? { model: rowModelKey } : {}), ...(modelFallback !== undefined ? { modelFallback } : {}), ...(reviveRow !== undefined ? ((reviveRow.rootSessionId ?? reviveRow.parentSessionId) !== undefined ? { rootSessionId: reviveRow.rootSessionId ?? reviveRow.parentSessionId } : {}) : (ctx.rootSessionId ?? ctx.sessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? ctx.sessionId } : {}), ...(sessionScopedBg ? { sessionScoped: true } : {}), createdAt: reviveRow?.spawnedAt ?? Date.now() }, (err) => opts.onObserverError?.(err, { site: "roster.recordSpawn" }));
|
|
@@ -3139,26 +3201,32 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3139
3201
|
const bgChildSessionId = reviveRow?.sessionId ?? uuidv7();
|
|
3140
3202
|
const bgStartedAt = Date.now();
|
|
3141
3203
|
stepRecorder.lockTo(taskId);
|
|
3142
|
-
bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId);
|
|
3204
|
+
bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId, opts.runner.sessions);
|
|
3143
3205
|
const bgCycleSeq = bg.registry.backgroundAgentCycleSeq(taskId);
|
|
3144
|
-
|
|
3145
|
-
|
|
3146
|
-
|
|
3147
|
-
const
|
|
3148
|
-
const
|
|
3206
|
+
let retainedCycle;
|
|
3207
|
+
const cycleSeqOfFrames = () => retainedCycle?.cycleSeq ?? (parkedResume !== undefined ? (reviveRow?.seq ?? 1) + 1 : reviveRow?.seq);
|
|
3208
|
+
bg.registry.attachAgentTerminalNotifier(taskId, (ending) => {
|
|
3209
|
+
const stoppedByLanded = ending.status === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
|
|
3210
|
+
const completionIdLanded = bg.registry.getCompletionId(taskId);
|
|
3211
|
+
const seqLanded = bg.registry.backgroundAgentCycleSeq(taskId);
|
|
3212
|
+
const landedElapsedMs = Date.now() - bgStartedAt;
|
|
3213
|
+
const landedFrame = {
|
|
3149
3214
|
task_id: taskId,
|
|
3150
3215
|
task_type: "background_agent",
|
|
3151
3216
|
toolUseId: ctx.toolCallId,
|
|
3152
|
-
status:
|
|
3217
|
+
status: ending.status,
|
|
3153
3218
|
...terminalFrameFacets({ spawnName: agentName }),
|
|
3154
|
-
|
|
3155
|
-
|
|
3219
|
+
...(cycleSeqOfFrames() !== undefined ? { seq: cycleSeqOfFrames() } : {}),
|
|
3220
|
+
...(stoppedByLanded !== undefined ? { stoppedBy: stoppedByLanded } : {}),
|
|
3221
|
+
summary: ending.status === "failed" ? `Agent "${shortDesc}" failed: ${ending.error ?? "ended"}${ccElapsedTag(landedElapsedMs)}`.slice(0, 300) : ccCompletionText(shortDesc, "killed", "killed", landedElapsedMs),
|
|
3222
|
+
...(ending.status === "failed" && ending.error !== undefined ? { error: ending.error.slice(0, REPORT_FIELD_MAX) } : {}),
|
|
3156
3223
|
sessionId: bgChildSessionId,
|
|
3157
3224
|
resumable: false,
|
|
3158
|
-
...(
|
|
3225
|
+
...(completionIdLanded !== undefined ? { completionId: completionIdLanded } : {}),
|
|
3159
3226
|
};
|
|
3160
|
-
sinkEmit(backgroundChildTerminal(
|
|
3161
|
-
|
|
3227
|
+
sinkEmit(backgroundChildTerminal(landedFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(seqLanded !== undefined ? { generation: seqLanded } : {}) }));
|
|
3228
|
+
const landedLane = ending.parkLane ?? cycleSink;
|
|
3229
|
+
notifier.notify(() => landedLane?.(landedFrame, { priority: "next" }), "subagent.landedTerminalNotify");
|
|
3162
3230
|
});
|
|
3163
3231
|
const bgDurableProbe = bg.registry.durableAgentRowProbe(taskId);
|
|
3164
3232
|
const bgRowConfirmed = async () => (bgDurableProbe ? await bgDurableProbe().catch(() => false) : false);
|
|
@@ -3199,6 +3267,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3199
3267
|
if (sessionScopedBg && bgRetainLedger)
|
|
3200
3268
|
ensureSessionReapHook(bg.registry);
|
|
3201
3269
|
const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined, bgChildSessionId, bgDurableProbe, { registry: bg.registry, taskId }, backgroundLegFacts(taskId));
|
|
3270
|
+
retainedCycle = bgRetain;
|
|
3202
3271
|
if (bgRetain) {
|
|
3203
3272
|
bg.registry.markRetainedContinuation(taskId);
|
|
3204
3273
|
const origRelease = bgRetain.release;
|
|
@@ -3207,7 +3276,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3207
3276
|
await origRelease();
|
|
3208
3277
|
};
|
|
3209
3278
|
}
|
|
3210
|
-
bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId);
|
|
3279
|
+
bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId, opts.runner.sessions);
|
|
3211
3280
|
const forwardDurableApproval = ctx.durableApprovalForChildren !== undefined &&
|
|
3212
3281
|
bg.agentStore !== undefined &&
|
|
3213
3282
|
childParkStore !== undefined &&
|
|
@@ -3250,16 +3319,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3250
3319
|
usage: { toolUses: toolStarts },
|
|
3251
3320
|
});
|
|
3252
3321
|
}, () => bg.registry.noteBackgroundAgentActivity(taskId));
|
|
3253
|
-
const
|
|
3254
|
-
|
|
3255
|
-
const bgPlacement = bg.agentStore !== undefined && opts.runner.sessions.placements?.subagent !== undefined
|
|
3256
|
-
? {
|
|
3257
|
-
kind: "subagent",
|
|
3258
|
-
...(bgScope !== undefined ? { scope: bgScope } : {}),
|
|
3259
|
-
...(bgPlacementParent !== undefined ? { parentSessionId: bgPlacementParent } : {}),
|
|
3260
|
-
...(bgPlacementRoot !== undefined ? { rootSessionId: bgPlacementRoot } : {}),
|
|
3261
|
-
handle: taskId,
|
|
3262
|
-
}
|
|
3322
|
+
const bgPlacement = placedTreeOwner !== undefined
|
|
3323
|
+
? { ...subagentTranscriptPlacement(ctx, bgScope, taskId), owner: placedTreeOwner }
|
|
3263
3324
|
: undefined;
|
|
3264
3325
|
const bgInternals = bgSink
|
|
3265
3326
|
? {
|
|
@@ -3316,6 +3377,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3316
3377
|
const driveParkedResume = async () => {
|
|
3317
3378
|
const pr = parkedResume;
|
|
3318
3379
|
const claimStores = { agentStore: bg.agentStore, checkpointStore: childParkStore };
|
|
3380
|
+
let consumed = false;
|
|
3319
3381
|
const rollbackAndThrow = async (e) => {
|
|
3320
3382
|
let disp = "retry";
|
|
3321
3383
|
try {
|
|
@@ -3323,6 +3385,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3323
3385
|
}
|
|
3324
3386
|
catch {
|
|
3325
3387
|
}
|
|
3388
|
+
if (!consumed && disp !== "failed")
|
|
3389
|
+
cycleSink = undefined;
|
|
3326
3390
|
const msg = thrownText(e);
|
|
3327
3391
|
throw new Error(disp === "rolled_back"
|
|
3328
3392
|
? `parked resume rolled back — the approval is still pending (retryable): ${msg}`
|
|
@@ -3381,6 +3445,16 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3381
3445
|
const won = await bg.registry.consumeParkedFlip(taskId, { agentStore: bg.agentStore }, pr.ticket);
|
|
3382
3446
|
if (!won)
|
|
3383
3447
|
throw new Error("the parked row moved under the resume (a stop or another transition won) — resume aborted");
|
|
3448
|
+
moveTerminalDelivery(parkedLane, notify, { task_id: taskId, task_type: "background_agent" });
|
|
3449
|
+
cycleSink = notify;
|
|
3450
|
+
consumed = true;
|
|
3451
|
+
if (parkedLane === undefined && ctx.onTaskNotification === undefined) {
|
|
3452
|
+
deliverEngineNotice(undefined, {
|
|
3453
|
+
code: "delegation.resume_lane_missing",
|
|
3454
|
+
message: `the parked agent ${taskId} was resumed with no run lane in this process to complete into (it parked in another process, or before this one restarted): its completion goes to the deployment's background channel, and a submission still waiting on it elsewhere is not settled by it`,
|
|
3455
|
+
detail: { taskId, ...(reviveRow?.rootSessionId !== undefined ? { rootSessionId: reviveRow.rootSessionId } : {}) },
|
|
3456
|
+
});
|
|
3457
|
+
}
|
|
3384
3458
|
};
|
|
3385
3459
|
let childResult;
|
|
3386
3460
|
try {
|
|
@@ -3427,8 +3501,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3427
3501
|
reopened = false;
|
|
3428
3502
|
}
|
|
3429
3503
|
if (reopened) {
|
|
3430
|
-
bg.registry.parkBackgroundAgent(taskId, {
|
|
3504
|
+
const reParked = bg.registry.parkBackgroundAgent(taskId, {
|
|
3431
3505
|
checkpointToken: pr.ticket.token,
|
|
3506
|
+
completionSink: cycleSink,
|
|
3432
3507
|
resolveStop: async () => {
|
|
3433
3508
|
const cpS = childParkStore;
|
|
3434
3509
|
const cp = (await cpS.get(pr.ticket.token));
|
|
@@ -3437,6 +3512,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3437
3512
|
return await cpS.expire(pr.ticket.token, cp.scope);
|
|
3438
3513
|
},
|
|
3439
3514
|
});
|
|
3515
|
+
if (reParked === "parked")
|
|
3516
|
+
cycleSink = undefined;
|
|
3440
3517
|
throw new Error(`parked resume could not complete and the approval was REOPENED (still approvable/retryable): ${childResult.terminal.message ?? "failed"}`, { cause: childResult.terminal });
|
|
3441
3518
|
}
|
|
3442
3519
|
}
|
|
@@ -3459,9 +3536,10 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3459
3536
|
void bgChildPromise
|
|
3460
3537
|
.then(async (child) => {
|
|
3461
3538
|
const childFace = childTerminalFace(child.terminal);
|
|
3462
|
-
settleDelegationRow(child.terminal);
|
|
3539
|
+
const rowSettled = settleDelegationRow(child.terminal);
|
|
3463
3540
|
closeObserverWindow(childFace.status);
|
|
3464
3541
|
dropHostAbortListener();
|
|
3542
|
+
await rowSettled;
|
|
3465
3543
|
await finishWorktree(child.terminal);
|
|
3466
3544
|
try {
|
|
3467
3545
|
const ns2 = child.stats.nested;
|
|
@@ -3474,7 +3552,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3474
3552
|
}
|
|
3475
3553
|
catch {
|
|
3476
3554
|
}
|
|
3477
|
-
const seqAtSettle =
|
|
3555
|
+
const seqAtSettle = cycleSeqOfFrames();
|
|
3478
3556
|
const bgHandbackWarning = isDurablePause(child.terminal)
|
|
3479
3557
|
? undefined
|
|
3480
3558
|
: await reviewHandback({
|
|
@@ -3517,7 +3595,10 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3517
3595
|
else {
|
|
3518
3596
|
let attested = false;
|
|
3519
3597
|
try {
|
|
3520
|
-
await
|
|
3598
|
+
const tree = placedTreeOwner !== undefined ? { bound: true, owner: placedTreeOwner } : await childTreeOwner();
|
|
3599
|
+
if (!tree.bound)
|
|
3600
|
+
throw new Error(tree.reason);
|
|
3601
|
+
await bg.ensureChildSessionDurable(bgChildSessionId, { owner: tree.owner });
|
|
3521
3602
|
attested = true;
|
|
3522
3603
|
}
|
|
3523
3604
|
catch {
|
|
@@ -3527,6 +3608,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3527
3608
|
? bg.registry.parkBackgroundAgent(taskId, {
|
|
3528
3609
|
checkpointToken: token,
|
|
3529
3610
|
seq: seqAtSettle ?? 1,
|
|
3611
|
+
completionSink: cycleSink,
|
|
3530
3612
|
resolveStop: async () => {
|
|
3531
3613
|
const cpS = childParkStore;
|
|
3532
3614
|
const cp = (await cpS.get(token));
|
|
@@ -3594,7 +3676,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3594
3676
|
const bgTerminalSummary = failReasonBg !== undefined
|
|
3595
3677
|
? `Agent "${shortDesc}" failed: ${failReasonBg}${ccElapsedTag(bgElapsedMs)}${observerNote}`.slice(0, 300) + errorKindClause(errClassBg)
|
|
3596
3678
|
: `${ccCompletionText(shortDesc, settled, childFace.status, bgElapsedMs)}${observerNote}`;
|
|
3597
|
-
const
|
|
3679
|
+
const completionSink = cycleSink;
|
|
3680
|
+
const ownsTerminalFaces = completionSink !== undefined && bg.registry.claimAgentTerminalNotify(taskId);
|
|
3598
3681
|
const bgResultField = await completionResultField(bgHandbackResult, (report) => persistTaskArtifact(ctx.taskArtifacts, taskId, report), (ref) => bg.registry.recordArtifactRef(taskId, ref, completionIdBg), notifier);
|
|
3599
3682
|
const completionFrame = {
|
|
3600
3683
|
task_id: taskId,
|
|
@@ -3627,24 +3710,25 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3627
3710
|
owners: gateOwners,
|
|
3628
3711
|
pendingCount: aliveBgCount,
|
|
3629
3712
|
payload: completionFrame,
|
|
3630
|
-
notify,
|
|
3713
|
+
notify: completionSink,
|
|
3631
3714
|
});
|
|
3632
3715
|
}
|
|
3633
3716
|
else if (ownsTerminalFaces) {
|
|
3634
3717
|
try {
|
|
3635
|
-
|
|
3718
|
+
completionSink(completionFrame, { priority: "next" });
|
|
3636
3719
|
}
|
|
3637
3720
|
catch {
|
|
3638
3721
|
}
|
|
3639
3722
|
}
|
|
3640
3723
|
})
|
|
3641
3724
|
.catch(async (e) => {
|
|
3642
|
-
settleDelegationRow({ kind: "failed" });
|
|
3725
|
+
const rowSettled = settleDelegationRow({ kind: "failed" });
|
|
3643
3726
|
closeObserverWindow("failed");
|
|
3644
3727
|
dropHostAbortListener();
|
|
3728
|
+
await rowSettled;
|
|
3645
3729
|
void finishWorktree();
|
|
3646
3730
|
const killed = abort.signal.aborted;
|
|
3647
|
-
const seqAtSettle =
|
|
3731
|
+
const seqAtSettle = cycleSeqOfFrames();
|
|
3648
3732
|
if (bgRetain) {
|
|
3649
3733
|
if (killed)
|
|
3650
3734
|
void bgRetainLedger?.evict(ctx.toolCallId);
|
|
@@ -3669,7 +3753,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3669
3753
|
}
|
|
3670
3754
|
const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
|
|
3671
3755
|
const observerNote = observerNoteFor(await startBoundedObserverDrain());
|
|
3672
|
-
const
|
|
3756
|
+
const rejectSink = cycleSink;
|
|
3757
|
+
const ownsTerminalFacesReject = rejectSink !== undefined && bg.registry.claimAgentTerminalNotify(taskId);
|
|
3673
3758
|
const rejectFrame = {
|
|
3674
3759
|
task_id: taskId,
|
|
3675
3760
|
task_type: "background_agent",
|
|
@@ -3688,7 +3773,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3688
3773
|
sinkEmit(backgroundChildTerminal(rejectFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(bgCycleSeq !== undefined ? { generation: bgCycleSeq } : {}) }));
|
|
3689
3774
|
try {
|
|
3690
3775
|
if (ownsTerminalFacesReject)
|
|
3691
|
-
|
|
3776
|
+
rejectSink(rejectFrame, { priority: "next" });
|
|
3692
3777
|
}
|
|
3693
3778
|
catch {
|
|
3694
3779
|
}
|