@sema-agent/core 7.62.0 → 7.64.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 +936 -0
- package/dist/agents/cc-peer-directory.js +1 -0
- package/dist/agents/cc-peer-wire.d.ts +4 -0
- package/dist/agents/cc-peer-wire.js +1 -0
- package/dist/agents/cc-uds-peer-channel.js +5 -0
- package/dist/agents/cross-session-judge.d.ts +3 -1
- package/dist/agents/cross-session-judge.js +4 -1
- package/dist/agents/peer-directory.d.ts +8 -0
- package/dist/agents/peer-directory.js +4 -0
- package/dist/agents/peer-held-queue.d.ts +9 -3
- package/dist/agents/peer-held-queue.js +12 -9
- package/dist/agents/peer-idle.d.ts +20 -1
- package/dist/agents/peer-idle.js +23 -12
- package/dist/agents/peer-notice-route.d.ts +16 -5
- package/dist/agents/peer-notice-route.js +11 -9
- package/dist/agents/peer-notices.d.ts +25 -8
- package/dist/agents/peer-notices.js +6 -1
- package/dist/agents/peer-session-drain.d.ts +32 -6
- package/dist/agents/peer-session-drain.js +100 -26
- package/dist/agents/send-message-tool.d.ts +7 -0
- package/dist/agents/send-message-tool.js +18 -6
- package/dist/agents/subagent-transcript-placement.d.ts +23 -0
- package/dist/agents/subagent-transcript-placement.js +14 -0
- package/dist/agents/subagent.js +102 -54
- package/dist/brain/route-adjudicator.js +9 -4
- package/dist/core/allow-entry.d.ts +4 -0
- package/dist/core/approval-object.js +1 -1
- package/dist/core/arg-summary.js +1 -1
- package/dist/core/ask-origin.d.ts +1 -1
- package/dist/core/ask-origin.js +2 -2
- package/dist/core/ask-question.d.ts +2 -2
- package/dist/core/ask-unresolvable-notice.d.ts +13 -4
- package/dist/core/ask-unresolvable-notice.js +10 -3
- package/dist/core/auto-compaction.d.ts +7 -5
- package/dist/core/background-agent-store.d.ts +7 -0
- package/dist/core/background-agent-store.js +3 -0
- package/dist/core/canonical-json.d.ts +23 -13
- package/dist/core/canonical-json.js +4 -4
- package/dist/core/checkpoint-queries.d.ts +50 -4
- package/dist/core/checkpoint-queries.js +42 -17
- package/dist/core/checkpoint-requirements.d.ts +3 -3
- package/dist/core/checkpoint-requirements.js +2 -1
- package/dist/core/checkpoint-row-verdict.d.ts +15 -4
- package/dist/core/checkpoint-row-verdict.js +22 -2
- package/dist/core/checkpoint-store.d.ts +28 -11
- package/dist/core/checkpoint-store.js +45 -4
- package/dist/core/compliance.d.ts +6 -2
- package/dist/core/compliance.js +3 -3
- package/dist/core/context-settings.d.ts +40 -9
- package/dist/core/context-settings.js +32 -10
- package/dist/core/engine-attestation.d.ts +27 -7
- package/dist/core/engine-attestation.js +5 -1
- package/dist/core/engine-notice.d.ts +43 -5
- package/dist/core/extension-requester.d.ts +9 -0
- package/dist/core/extension-requester.js +7 -0
- package/dist/core/file-history-store.d.ts +28 -0
- package/dist/core/file-history-store.js +48 -5
- package/dist/core/fs-write-gate-policy.js +1 -1
- package/dist/core/gate-fold.js +2 -0
- package/dist/core/gate-lanes.js +2 -0
- package/dist/core/gate-outcome.d.ts +39 -2
- package/dist/core/gate-outcome.js +20 -1
- 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 +17 -3
- package/dist/core/leg-identity.d.ts +19 -1
- package/dist/core/leg-identity.js +12 -0
- package/dist/core/mailbox-store.d.ts +39 -4
- package/dist/core/mailbox-store.js +14 -2
- package/dist/core/memory-engine/consolidation-driver.d.ts +32 -17
- package/dist/core/memory-engine/consolidation-driver.js +99 -98
- package/dist/core/memory-engine/consolidation.d.ts +74 -10
- package/dist/core/memory-engine/consolidation.js +183 -11
- package/dist/core/memory-engine/control-objects.d.ts +25 -0
- package/dist/core/memory-engine/control-objects.js +151 -0
- package/dist/core/memory-engine/control-plane-adoption.d.ts +48 -0
- package/dist/core/memory-engine/control-plane-adoption.js +159 -0
- 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 +58 -40
- package/dist/core/memory-engine/delegation-settlement.js +270 -85
- package/dist/core/memory-engine/dual-root.d.ts +12 -6
- package/dist/core/memory-engine/dual-root.js +11 -7
- package/dist/core/memory-engine/engine.d.ts +136 -58
- package/dist/core/memory-engine/engine.js +491 -394
- 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 +62 -60
- package/dist/core/memory-engine/file-backend.js +122 -198
- package/dist/core/memory-engine/index.d.ts +8 -7
- package/dist/core/memory-engine/index.js +7 -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 +127 -46
- package/dist/core/memory-engine/layout.js +264 -109
- package/dist/core/memory-engine/memory-backend-contract.d.ts +26 -1
- package/dist/core/memory-engine/memory-backend-contract.js +476 -0
- package/dist/core/memory-engine/memory-deployment.d.ts +42 -11
- package/dist/core/memory-engine/memory-deployment.js +54 -15
- package/dist/core/memory-engine/origin-clearance.d.ts +12 -3
- package/dist/core/memory-engine/origin-clearance.js +68 -9
- 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 +37 -2
- package/dist/core/memory-engine/session-write-home.js +38 -11
- 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 +155 -19
- package/dist/core/memory-engine/types.js +2 -0
- package/dist/core/memory.js +15 -6
- package/dist/core/mode-policy.js +3 -3
- package/dist/core/mods/agent-stations.d.ts +18 -0
- package/dist/core/mods/agent-stations.js +8 -6
- package/dist/core/mods/extension-call.d.ts +4 -0
- package/dist/core/mods/extension-call.js +8 -0
- package/dist/core/mods/stations.d.ts +20 -1
- package/dist/core/mods/stations.js +21 -2
- package/dist/core/mods/tool-call.js +3 -4
- package/dist/core/parent-spec-seat.d.ts +2 -2
- 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/peer-channel.d.ts +5 -0
- package/dist/core/permission-rule-consent.d.ts +26 -8
- package/dist/core/permission-rule-consent.js +76 -36
- package/dist/core/permission-rule-store.d.ts +72 -13
- package/dist/core/permission-rule-store.js +29 -8
- package/dist/core/read-only-shell.js +3 -2
- package/dist/core/redaction-marks.d.ts +8 -0
- package/dist/core/redaction-marks.js +6 -0
- package/dist/core/refusal-echo.d.ts +20 -0
- package/dist/core/refusal-echo.js +33 -0
- package/dist/core/remote-env.d.ts +12 -1
- package/dist/core/remote-env.js +3 -0
- package/dist/core/retention.d.ts +180 -10
- package/dist/core/retention.js +45 -0
- package/dist/core/retired-keys.d.ts +5 -0
- package/dist/core/retired-keys.js +3 -0
- package/dist/core/rule-offer-read.d.ts +0 -4
- package/dist/core/rule-offer-read.js +2 -18
- package/dist/core/runner/child-tree.d.ts +29 -3
- package/dist/core/runner/child-tree.js +39 -16
- package/dist/core/runner/classifier-ladder.d.ts +7 -1
- package/dist/core/runner/classifier-ladder.js +4 -2
- package/dist/core/runner/compact-session.js +10 -7
- package/dist/core/runner/compaction-call-options.d.ts +7 -7
- package/dist/core/runner/compaction-call-options.js +3 -2
- package/dist/core/runner/contracts.d.ts +39 -11
- package/dist/core/runner/delegation-owner.d.ts +10 -3
- package/dist/core/runner/delegation-owner.js +4 -1
- package/dist/core/runner/gate-exit.d.ts +6 -0
- package/dist/core/runner/gate-exit.js +13 -4
- package/dist/core/runner/inherited-ask-grants.js +1 -1
- package/dist/core/runner/memory-consolidation-driver.d.ts +10 -5
- package/dist/core/runner/memory-consolidation-driver.js +12 -9
- 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/person-path-rows.d.ts +8 -3
- package/dist/core/runner/person-path-rows.js +5 -1
- package/dist/core/runner/placement-fence.d.ts +12 -0
- package/dist/core/runner/placement-fence.js +20 -6
- package/dist/core/runner/prepare-ask-lane.js +5 -5
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +7 -2
- package/dist/core/runner/prepare-caps-and-workflow.js +7 -4
- package/dist/core/runner/prepare-config-doors.js +4 -0
- package/dist/core/runner/prepare-delegation-surface.d.ts +3 -0
- package/dist/core/runner/prepare-delegation-surface.js +2 -2
- package/dist/core/runner/prepare-execution-env.js +17 -6
- package/dist/core/runner/prepare-gate-stations.d.ts +5 -0
- package/dist/core/runner/prepare-gate-stations.js +5 -5
- package/dist/core/runner/prepare-hands-readface.d.ts +2 -1
- package/dist/core/runner/prepare-hands-readface.js +5 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +13 -9
- package/dist/core/runner/prepare-inherited-gate.js +12 -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 +7 -2
- package/dist/core/runner/prepare-memory.js +41 -39
- package/dist/core/runner/prepare-park-ask.js +4 -3
- package/dist/core/runner/prepare-policy-chain.js +7 -7
- package/dist/core/runner/prepare-prompt-inputs.js +1 -1
- package/dist/core/runner/prepare-task.js +26 -18
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -1
- package/dist/core/runner/prepare-wiring-manifest.js +3 -2
- package/dist/core/runner/prepare-workspace-restore.js +3 -6
- package/dist/core/runner/resume-admission.d.ts +2 -2
- package/dist/core/runner/resume-admission.js +2 -23
- package/dist/core/runner/role-resolution-table.d.ts +98 -0
- package/dist/core/runner/role-resolution-table.js +62 -0
- package/dist/core/runner/run-compaction-machinery.js +2 -2
- package/dist/core/runner/run-identity-wiring.js +12 -9
- package/dist/core/runner/run-leg.js +9 -5
- package/dist/core/runner/run-notification-lane.js +22 -22
- package/dist/core/runner/run-recovery-lanes.js +3 -3
- package/dist/core/runner/run-settle-and-teardown.js +3 -2
- package/dist/core/runner/run-terminal-adoption.js +1 -1
- package/dist/core/runner/run-turn-boundary.js +14 -15
- package/dist/core/runner/runtask.js +1 -1
- package/dist/core/runner/terminal-account.js +1 -1
- package/dist/core/runner/tool-occurrence.d.ts +4 -2
- package/dist/core/runner/tool-occurrence.js +2 -2
- package/dist/core/runner-deps.d.ts +7 -3
- package/dist/core/secret-env.d.ts +1 -1
- package/dist/core/secret-env.js +4 -4
- package/dist/core/session-checkout.d.ts +168 -0
- package/dist/core/session-checkout.js +579 -0
- package/dist/core/session-store.d.ts +12 -4
- package/dist/core/session-store.js +23 -3
- package/dist/core/session.d.ts +16 -2
- package/dist/core/session.js +3 -0
- package/dist/core/shell-read-silence.js +8 -0
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +0 -12
- package/dist/core/store-contracts/checkpoint-store-contract.js +6 -7
- package/dist/core/store-contracts/peer-directory-contract.js +8 -1
- package/dist/core/store-contracts/session-store-contract.js +39 -0
- package/dist/core/task-event.d.ts +30 -5
- package/dist/core/task-notification.d.ts +119 -32
- package/dist/core/task-notification.js +186 -100
- package/dist/core/task-registry-agent.d.ts +25 -2
- package/dist/core/task-registry-agent.js +56 -22
- package/dist/core/task-registry-shared.d.ts +33 -11
- package/dist/core/task-registry.d.ts +33 -9
- package/dist/core/task-registry.js +36 -18
- package/dist/core/task-spec-members.js +1 -1
- package/dist/core/task-spec.d.ts +27 -2
- package/dist/core/tool-errors.d.ts +14 -6
- package/dist/core/tool-errors.js +1 -1
- package/dist/core/tool-policy.d.ts +32 -13
- package/dist/core/tool-policy.js +27 -17
- package/dist/core/tool-result-store.d.ts +20 -0
- package/dist/core/tool-spec.d.ts +42 -19
- package/dist/core/trace.d.ts +3 -2
- package/dist/core/types.d.ts +1 -1
- package/dist/core/untrusted-egress.d.ts +15 -4
- package/dist/core/untrusted-egress.js +23 -22
- package/dist/core/workflow-journal-store.d.ts +11 -0
- package/dist/core/workflow-journal-store.js +7 -0
- package/dist/core/workflow-run-store.d.ts +9 -0
- package/dist/core/workflow-run-store.js +6 -0
- package/dist/core/workspace-snapshot.d.ts +3 -1
- package/dist/core/workspace-snapshot.js +1 -0
- package/dist/engine/compaction/compaction.d.ts +2 -1
- package/dist/engine/harness/types.d.ts +67 -1
- package/dist/engine/harness/types.js +108 -0
- package/dist/engine/session/import-validate.js +6 -1
- package/dist/engine/session/session.d.ts +30 -1
- package/dist/engine/session/session.js +48 -1
- package/dist/index.d.ts +12 -7
- package/dist/index.js +12 -7
- package/dist/internal/harness-types.d.ts +1 -1
- package/dist/orchestration/run-workflow-tool.d.ts +8 -1
- package/dist/orchestration/run-workflow-tool.js +8 -0
- package/dist/orchestration/workflow-types.d.ts +2 -1
- package/dist/orchestration/workflow.d.ts +6 -0
- package/dist/orchestration/workflow.js +5 -2
- package/dist/stores/file/checkpoint-store.d.ts +6 -0
- package/dist/stores/file/checkpoint-store.js +4 -1
- package/dist/stores/file/file-history-store.d.ts +13 -0
- package/dist/stores/file/file-history-store.js +75 -13
- package/dist/stores/file/index.d.ts +11 -1
- package/dist/stores/file/index.js +7 -11
- package/dist/stores/file/permission-rule-store.d.ts +23 -0
- package/dist/stores/file/permission-rule-store.js +75 -7
- package/dist/stores/file/session-store.js +2 -1
- package/dist/stores/file/tool-result-store.d.ts +14 -0
- package/dist/stores/file/tool-result-store.js +39 -2
- package/dist/stores/file/workflow-journal-store.d.ts +4 -0
- package/dist/stores/file/workflow-journal-store.js +17 -0
- package/dist/stores/file/workflow-run-store.d.ts +3 -0
- package/dist/stores/file/workflow-run-store.js +15 -0
- package/dist/tools/fs/bash-program-position.js +3 -3
- 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 +28 -3
- package/dist/tools/fs/read-deny.js +18 -2
- package/dist/tools/fs/removal-targets.js +3 -3
- 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 +8 -1
- package/dist/tools/fs/shell-read-argv.js +34 -29
- package/dist/tools/fs/shell-read-bindings.d.ts +2 -0
- package/dist/tools/fs/shell-read-bindings.js +5 -1
- 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.d.ts +8 -2
- package/dist/tools/fs/shell-read-check.js +16 -14
- package/dist/tools/fs/shell-read-establish.js +23 -16
- 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-plan.d.ts +10 -0
- package/dist/tools/fs/shell-read-plan.js +189 -93
- package/dist/tools/fs/shell-read-start.d.ts +19 -9
- package/dist/tools/fs/shell-read-start.js +20 -12
- 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 +26 -7
- package/dist/tools/fs/shell-read-workdir.js +73 -12
- 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 +135 -11
- package/wire-changes/core-stores-sql@7.63.0.json +30 -0
- package/wire-changes/core-stores-sql@7.64.0.json +30 -0
- package/wire-changes/core@7.63.0.json +3523 -0
- package/wire-changes/core@7.64.0.json +2653 -0
- package/wire-changes/mods-kernel@7.63.0.json +30 -0
- package/wire-changes/mods-kernel@7.64.0.json +30 -0
- package/wire-changes/primitives@7.63.0.json +445 -0
- package/wire-changes/primitives@7.64.0.json +30 -0
- 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/agents/subagent.js
CHANGED
|
@@ -32,22 +32,26 @@ 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";
|
|
42
|
-
import { boundedRedactedSummary } from "../core/untrusted-egress.js";
|
|
43
|
+
import { boundedRedactedSummary, extensionWords } from "../core/untrusted-egress.js";
|
|
44
|
+
import { readExtensionRequester } from "../core/extension-requester.js";
|
|
43
45
|
import { uuidv7 } from "../internal/harness.js";
|
|
44
46
|
import { addWorktree } from "../core/git-worktree-env.js";
|
|
45
47
|
import { shellQuote } from "../tools/fs/search.js";
|
|
46
48
|
import { BG_AGENT_REAP_STOP_ERROR, chosenAgentName } from "../core/task-registry.js";
|
|
49
|
+
import { agentOutcomeIsError } from "../core/task-registry-agent.js";
|
|
47
50
|
import { readDurableOrgAdmission } from "../core/memory-admission.js";
|
|
48
51
|
import { governanceRetryClass } from "../core/governance-codes.js";
|
|
49
52
|
import { readSkillGrantCapture } from "../core/skill-grant.js";
|
|
50
|
-
import { admitsBackgroundLaunch, completionResultField, oweTerminalDelivery, resolveCompletionSink, terminalFrameFacets } from "../core/task-notification.js";
|
|
53
|
+
import { admitsBackgroundLaunch, completionResultField, moveTerminalDelivery, oweTerminalDelivery, resolveCompletionSink, terminalFrameFacets } from "../core/task-notification.js";
|
|
54
|
+
import { deliverEngineNotice } from "../core/engine-notice.js";
|
|
51
55
|
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
56
|
function rollupDelegatedCost(stats, nested) {
|
|
53
57
|
if (stats.costMicroUsd === undefined)
|
|
@@ -81,6 +85,7 @@ import { LAUNCH_RECEIPT_OWN_WORDS_CLAUSE, launchReceiptNoQuoteClause } from "./l
|
|
|
81
85
|
import { ObserverDigestTap, ObserverPairing, createObserverReportToolSpec, markObserverTaskId, unmarkObserverTaskId, isObserverTaskId, ObserverResumeStateError, ObserverStoppedByUserError, observerFramingPrompt, observerSlug, resolveObserverDeclaration, } from "./observer.js";
|
|
82
86
|
import { SubagentStepRecorder, redactThenCut } from "./subagent-steps.js";
|
|
83
87
|
import { childOwnerKeys, parkCompletionNotify, runningBackgroundUnder } from "./subagent-completion-gate.js";
|
|
88
|
+
import { placesSubagentTranscripts, subagentTranscriptPlacement } from "./subagent-transcript-placement.js";
|
|
84
89
|
import { OUTPUT_TOOL_NAME, mountRuleFace, toolFace } from "../core/tool-catalog-entries.js";
|
|
85
90
|
import { canonicalNameValue } from "../core/permission-rule-model.js";
|
|
86
91
|
import { definitionAllowTools, inheritedChildPool, inheritedHostSeats, inheritedMcpDeclarations, withDefinitionServers, withoutWakerSeats } from "./inherited-tool-pool.js";
|
|
@@ -387,6 +392,7 @@ const SUBAGENT_ERROR_KIND_BY_CODE = {
|
|
|
387
392
|
stream_torn: "network",
|
|
388
393
|
refusal: "logic",
|
|
389
394
|
length_empty: "logic",
|
|
395
|
+
"config.placement_not_honored": "logic",
|
|
390
396
|
};
|
|
391
397
|
const SUBAGENT_RETRYABLE = {
|
|
392
398
|
rate_limit: true,
|
|
@@ -1090,7 +1096,13 @@ function reachableOccupants(registry, scope, root, caller) {
|
|
|
1090
1096
|
if (typeof face !== "function")
|
|
1091
1097
|
return new Map();
|
|
1092
1098
|
try {
|
|
1093
|
-
return new Map(face
|
|
1099
|
+
return new Map(face
|
|
1100
|
+
.call(registry, scope, root, caller)
|
|
1101
|
+
.filter((o) => o.reachable)
|
|
1102
|
+
.map((o) => {
|
|
1103
|
+
const requestedBy = readExtensionRequester(o.requestedBy);
|
|
1104
|
+
return [o.id, { name: o.name, ...(requestedBy !== undefined ? { requestedBy } : {}) }];
|
|
1105
|
+
}));
|
|
1094
1106
|
}
|
|
1095
1107
|
catch {
|
|
1096
1108
|
return new Map();
|
|
@@ -1098,7 +1110,10 @@ function reachableOccupants(registry, scope, root, caller) {
|
|
|
1098
1110
|
}
|
|
1099
1111
|
function concurrencyOccupants(active, reachable, local) {
|
|
1100
1112
|
const listed = active.filter((id) => reachable.has(id)).slice(0, REFUSAL_OCCUPANTS_LISTED);
|
|
1101
|
-
const parts = listed.map((id) =>
|
|
1113
|
+
const parts = listed.map((id) => {
|
|
1114
|
+
const o = reachable.get(id);
|
|
1115
|
+
return `task_id ${id} (${JSON.stringify(o.name)}${o.requestedBy !== undefined ? `, started by extension "${extensionWords(o.requestedBy.name, 80)}"` : ""})`;
|
|
1116
|
+
});
|
|
1102
1117
|
const rest = active.length - listed.length;
|
|
1103
1118
|
if (rest > 0)
|
|
1104
1119
|
parts.push(`${rest} ${listed.length > 0 ? "more " : ""}registered`);
|
|
@@ -1535,7 +1550,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
1535
1550
|
const a = canonicalSubagentTypeArgs(args, acceptedSubagentTypes(), generalPurposeShadowed);
|
|
1536
1551
|
const parentSpecSeat = parentSpecSeatOfCtx(ctx);
|
|
1537
1552
|
const reviveClaim = ctx.reviveClaim;
|
|
1538
|
-
const
|
|
1553
|
+
const parkedLane = reviveClaim?.parkedResume !== undefined ? opts.background?.registry.parkedCompletionSink(reviveClaim.row.handle) : undefined;
|
|
1554
|
+
const backgroundSink = opts.background !== undefined ? resolveCompletionSink(ctx.onTaskNotification ?? parkedLane, opts.background.notify) : undefined;
|
|
1539
1555
|
const backgroundLane = opts.background !== undefined && admitsBackgroundLaunch(backgroundSink);
|
|
1540
1556
|
if (reviveClaim !== undefined && !backgroundLane) {
|
|
1541
1557
|
return notStartedResult({
|
|
@@ -2241,6 +2257,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2241
2257
|
...(ctx.taskId !== undefined ? { parentTaskId: ctx.taskId } : {}),
|
|
2242
2258
|
...(ctx.sessionId !== undefined ? { parentSessionId: ctx.sessionId } : {}),
|
|
2243
2259
|
...((ctx.rootSessionId ?? ctx.sessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? ctx.sessionId } : {}),
|
|
2260
|
+
...(ctx.rootSessionIncarnation !== undefined ? { rootSessionIncarnation: ctx.rootSessionIncarnation } : {}),
|
|
2244
2261
|
...(ctx.placementRoot !== undefined ? { placementRoot: ctx.placementRoot } : {}),
|
|
2245
2262
|
}),
|
|
2246
2263
|
...(ctx.centerArtifactDigest !== undefined ? { parentCenterArtifactDigest: ctx.centerArtifactDigest } : {}),
|
|
@@ -2256,7 +2273,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2256
2273
|
})(),
|
|
2257
2274
|
...(ctx.subagentRetain !== undefined ? { parentRetainLedger: ctx.subagentRetain } : {}),
|
|
2258
2275
|
onForwardEvent: recordingForward,
|
|
2259
|
-
...(ctx.parentCwd
|
|
2276
|
+
...callerPlacementSeats(ctx.parentCwd, ctx.callerRoot),
|
|
2260
2277
|
...(ctx.placementTarget !== undefined ? { placementTarget: ctx.placementTarget } : {}),
|
|
2261
2278
|
...(worktreeDir !== undefined
|
|
2262
2279
|
? { parentCwd: worktreeDir, worktreeOffered: true, onWorkspaceResolved: (ws) => void (childPlacement = ws) }
|
|
@@ -2494,14 +2511,17 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2494
2511
|
const forkTree = await delegationOwnerOf(ctx.delegationOwner);
|
|
2495
2512
|
if (!forkTree.bound)
|
|
2496
2513
|
return ownerUnboundResult(false, forkTree);
|
|
2514
|
+
const forkBg = wantsBackground ? opts.background : undefined;
|
|
2515
|
+
const forkPlacementHandle = forkBg?.agentStore !== undefined ? forkBg.registry.mintTaskId("background_agent") : undefined;
|
|
2516
|
+
const forkOpts = forkPlacementHandle !== undefined ? { placement: subagentTranscriptPlacement(ctx, treeScope, forkPlacementHandle) } : undefined;
|
|
2497
2517
|
try {
|
|
2498
2518
|
if (ctx.hostSessionFork) {
|
|
2499
|
-
const forkHandle = await ctx.hostSessionFork();
|
|
2519
|
+
const forkHandle = await ctx.hostSessionFork(forkOpts);
|
|
2500
2520
|
forkedId = forkHandle?.sessionId ?? null;
|
|
2501
2521
|
releaseForked = forkHandle?.release;
|
|
2502
2522
|
}
|
|
2503
2523
|
else {
|
|
2504
|
-
forkedId = (await opts.runner.sessions.fork?.(ctx.sessionId, forkTree.owner)) ?? null;
|
|
2524
|
+
forkedId = (await opts.runner.sessions.fork?.(ctx.sessionId, forkTree.owner, declaresSubagentPlacement(opts.runner.sessions) ? forkOpts : undefined)) ?? null;
|
|
2505
2525
|
}
|
|
2506
2526
|
}
|
|
2507
2527
|
catch (e) {
|
|
@@ -2551,7 +2571,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2551
2571
|
const forkSettleId = forkSettlementSeat !== undefined ? `bg-${uuidv7()}` : undefined;
|
|
2552
2572
|
if (forkSettlementSeat !== undefined && forkSettleId !== undefined) {
|
|
2553
2573
|
try {
|
|
2554
|
-
registerDelegationLaunch(forkSettlementSeat.
|
|
2574
|
+
await registerDelegationLaunch(forkSettlementSeat.governance, { settleId: forkSettleId, sessionId: forkSettlementSeat.sessionId, now: Date.now, ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}) });
|
|
2555
2575
|
}
|
|
2556
2576
|
catch (e) {
|
|
2557
2577
|
dropHostAbortListener();
|
|
@@ -2563,7 +2583,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2563
2583
|
});
|
|
2564
2584
|
}
|
|
2565
2585
|
}
|
|
2566
|
-
const settleForkRow = (terminal) => {
|
|
2586
|
+
const settleForkRow = async (terminal) => {
|
|
2567
2587
|
if (forkSettlementSeat === undefined || forkSettleId === undefined)
|
|
2568
2588
|
return;
|
|
2569
2589
|
const att = terminal !== undefined ? childAttestation(terminal.kind === "completed") : undefined;
|
|
@@ -2572,7 +2592,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2572
2592
|
let lastErr;
|
|
2573
2593
|
for (let attempt = 0; attempt < 3 && !settled; attempt++) {
|
|
2574
2594
|
try {
|
|
2575
|
-
settleDelegation(forkSettlementSeat.
|
|
2595
|
+
await settleDelegation(forkSettlementSeat.governance, { settleId: forkSettleId, status: verdict, now: Date.now });
|
|
2576
2596
|
settled = true;
|
|
2577
2597
|
}
|
|
2578
2598
|
catch (e) {
|
|
@@ -2581,7 +2601,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2581
2601
|
}
|
|
2582
2602
|
if (settled && verdict === "external") {
|
|
2583
2603
|
try {
|
|
2584
|
-
replayExternalSettlementEffects(forkSettlementSeat.controlDir, { carry: true, now: Date.now });
|
|
2604
|
+
await replayExternalSettlementEffects(forkSettlementSeat.governance, forkSettlementSeat.controlDir, { carry: true, now: Date.now });
|
|
2585
2605
|
}
|
|
2586
2606
|
catch {
|
|
2587
2607
|
}
|
|
@@ -2594,11 +2614,13 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2594
2614
|
let taskId;
|
|
2595
2615
|
try {
|
|
2596
2616
|
taskId = bg.registry.registerBackgroundAgent({
|
|
2617
|
+
...(forkPlacementHandle !== undefined ? { id: forkPlacementHandle } : {}),
|
|
2597
2618
|
...(bgOwner !== undefined ? { owner: bgOwner } : {}),
|
|
2598
2619
|
...(bgScope !== undefined ? { scope: bgScope } : {}),
|
|
2599
2620
|
...(sessionScopedBg ? { sessionScoped: true } : {}),
|
|
2600
2621
|
description: shortDesc,
|
|
2601
2622
|
agentType: spawnAgentType,
|
|
2623
|
+
...(extensionSpawn !== undefined ? { requestedBy: extensionSpawn.requestedBy } : {}),
|
|
2602
2624
|
...(agentName !== undefined ? { name: agentName } : {}),
|
|
2603
2625
|
...(ctx.taskId !== undefined && ctx.taskId !== ctx.sessionId ? { parentTaskId: ctx.taskId } : {}),
|
|
2604
2626
|
...(ctx.sessionId !== undefined ? { parentSessionId: ctx.sessionId } : {}),
|
|
@@ -2621,7 +2643,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2621
2643
|
const wt = await finishWorktree();
|
|
2622
2644
|
if (forkSettlementSeat !== undefined && forkSettleId !== undefined) {
|
|
2623
2645
|
try {
|
|
2624
|
-
settleDelegation(forkSettlementSeat.
|
|
2646
|
+
await settleDelegation(forkSettlementSeat.governance, { settleId: forkSettleId, status: "void", now: Date.now, note: "registration failed before invoke (not dispatched)" });
|
|
2625
2647
|
}
|
|
2626
2648
|
catch {
|
|
2627
2649
|
}
|
|
@@ -2765,8 +2787,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2765
2787
|
void bgForkChild
|
|
2766
2788
|
.then(async (child) => {
|
|
2767
2789
|
const childFace = childTerminalFace(child.terminal);
|
|
2768
|
-
settleForkRow(child.terminal);
|
|
2790
|
+
const forkSettled = settleForkRow(child.terminal);
|
|
2769
2791
|
dropHostAbortListener();
|
|
2792
|
+
await forkSettled;
|
|
2770
2793
|
await finishWorktree(child.terminal);
|
|
2771
2794
|
try {
|
|
2772
2795
|
const nsb = child.stats.nested;
|
|
@@ -2847,7 +2870,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2847
2870
|
}
|
|
2848
2871
|
})
|
|
2849
2872
|
.catch((e) => {
|
|
2850
|
-
settleForkRow({ kind: "failed" });
|
|
2873
|
+
void settleForkRow({ kind: "failed" });
|
|
2851
2874
|
dropHostAbortListener();
|
|
2852
2875
|
void finishWorktree();
|
|
2853
2876
|
const killed = abort.signal.aborted;
|
|
@@ -2995,6 +3018,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
2995
3018
|
].filter(Boolean);
|
|
2996
3019
|
return {
|
|
2997
3020
|
content: forkLines.join("\n"),
|
|
3021
|
+
...(agentOutcomeIsError(forkFace.status) ? { isError: true } : {}),
|
|
2998
3022
|
details: completedAgentCard(forkChild, {
|
|
2999
3023
|
subagentType: FORK_SUBAGENT_TYPE,
|
|
3000
3024
|
error: forkErr,
|
|
@@ -3020,6 +3044,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3020
3044
|
const abort = new AbortController();
|
|
3021
3045
|
const reviveRow = reviveClaim?.row;
|
|
3022
3046
|
const parkedResume = reviveClaim?.parkedResume;
|
|
3047
|
+
let cycleSink = parkedResume !== undefined && parkedLane !== undefined ? parkedLane : notify;
|
|
3023
3048
|
const sessionScopedBg = reviveRow !== undefined ? reviveRow.sessionScoped : ctx.backgroundScope === "session" && ctx.sessionId !== undefined;
|
|
3024
3049
|
const outlivesThisRequest = sessionScopedBg || reviveRow !== undefined;
|
|
3025
3050
|
const onHostAbort = () => abort.abort();
|
|
@@ -3035,7 +3060,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3035
3060
|
const bgScope = treeScope;
|
|
3036
3061
|
const childTreeOwner = () => (reviveRow !== undefined ? rowOwnerReading(opts.runner.sessions, reviveRow.sessionId) : delegationOwnerOf(ctx.delegationOwner));
|
|
3037
3062
|
let placedTreeOwner;
|
|
3038
|
-
if (reviveRow === undefined && bg.agentStore
|
|
3063
|
+
if (reviveRow === undefined && placesSubagentTranscripts(bg.agentStore, opts.runner.sessions)) {
|
|
3039
3064
|
const tree = await childTreeOwner();
|
|
3040
3065
|
if (!tree.bound) {
|
|
3041
3066
|
dropHostAbortListener();
|
|
@@ -3062,7 +3087,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3062
3087
|
const bgSettleId = settlementSeat !== undefined ? `bg-${uuidv7()}` : undefined;
|
|
3063
3088
|
if (settlementSeat !== undefined && bgSettleId !== undefined) {
|
|
3064
3089
|
try {
|
|
3065
|
-
registerDelegationLaunch(settlementSeat.
|
|
3090
|
+
await registerDelegationLaunch(settlementSeat.governance, { settleId: bgSettleId, sessionId: settlementSeat.sessionId, now: Date.now, ...(ctx.toolCallId !== undefined ? { toolUseId: ctx.toolCallId } : {}) });
|
|
3066
3091
|
}
|
|
3067
3092
|
catch (e) {
|
|
3068
3093
|
dropHostAbortListener();
|
|
@@ -3075,7 +3100,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3075
3100
|
});
|
|
3076
3101
|
}
|
|
3077
3102
|
}
|
|
3078
|
-
const settleDelegationRow = (terminal) => {
|
|
3103
|
+
const settleDelegationRow = async (terminal) => {
|
|
3079
3104
|
if (settlementSeat === undefined || bgSettleId === undefined)
|
|
3080
3105
|
return;
|
|
3081
3106
|
const att = terminal !== undefined ? childAttestation(terminal.kind === "completed") : undefined;
|
|
@@ -3084,7 +3109,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3084
3109
|
let lastErr;
|
|
3085
3110
|
for (let attempt = 0; attempt < 3 && !settled; attempt++) {
|
|
3086
3111
|
try {
|
|
3087
|
-
settleDelegation(settlementSeat.
|
|
3112
|
+
await settleDelegation(settlementSeat.governance, { settleId: bgSettleId, status: verdict, now: Date.now });
|
|
3088
3113
|
settled = true;
|
|
3089
3114
|
}
|
|
3090
3115
|
catch (e) {
|
|
@@ -3093,7 +3118,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3093
3118
|
}
|
|
3094
3119
|
if (settled && verdict === "external") {
|
|
3095
3120
|
try {
|
|
3096
|
-
replayExternalSettlementEffects(settlementSeat.controlDir, { carry: true, now: Date.now });
|
|
3121
|
+
await replayExternalSettlementEffects(settlementSeat.governance, settlementSeat.controlDir, { carry: true, now: Date.now });
|
|
3097
3122
|
}
|
|
3098
3123
|
catch {
|
|
3099
3124
|
}
|
|
@@ -3113,6 +3138,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3113
3138
|
...(reviveRow.sessionScoped ? { sessionScoped: true } : {}),
|
|
3114
3139
|
...(reviveRow.description !== undefined ? { description: reviveRow.description } : {}),
|
|
3115
3140
|
agentType: spawnAgentType,
|
|
3141
|
+
...(reviveRow.requestedBy !== undefined ? { requestedBy: reviveRow.requestedBy } : {}),
|
|
3116
3142
|
name: reviveRow.name,
|
|
3117
3143
|
...(reviveRow.parentTaskId !== undefined ? { parentTaskId: reviveRow.parentTaskId } : {}),
|
|
3118
3144
|
...(reviveRow.parentSessionId !== undefined ? { parentSessionId: reviveRow.parentSessionId } : {}),
|
|
@@ -3146,6 +3172,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3146
3172
|
...(sessionScopedBg ? { sessionScoped: true } : {}),
|
|
3147
3173
|
description: shortDesc,
|
|
3148
3174
|
agentType: spawnAgentType,
|
|
3175
|
+
...(extensionSpawn !== undefined ? { requestedBy: extensionSpawn.requestedBy } : {}),
|
|
3149
3176
|
...(agentName !== undefined ? { name: agentName } : {}),
|
|
3150
3177
|
...(ctx.taskId !== undefined && ctx.taskId !== ctx.sessionId ? { parentTaskId: ctx.taskId } : {}),
|
|
3151
3178
|
...(ctx.sessionId !== undefined ? { parentSessionId: ctx.sessionId } : {}),
|
|
@@ -3164,7 +3191,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3164
3191
|
const wt = await finishWorktree();
|
|
3165
3192
|
if (settlementSeat !== undefined && bgSettleId !== undefined) {
|
|
3166
3193
|
try {
|
|
3167
|
-
settleDelegation(settlementSeat.
|
|
3194
|
+
await settleDelegation(settlementSeat.governance, { settleId: bgSettleId, status: "void", now: Date.now, note: "registration failed before invoke (not dispatched)" });
|
|
3168
3195
|
}
|
|
3169
3196
|
catch {
|
|
3170
3197
|
}
|
|
@@ -3173,7 +3200,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3173
3200
|
}
|
|
3174
3201
|
if (capLedgerKey !== undefined)
|
|
3175
3202
|
chargeDelegationEntryHandle(bg.registry, capLedgerKey, bg.agentStore, reviveRow === undefined ? taskId : undefined);
|
|
3176
|
-
|
|
3203
|
+
if (parkedResume === undefined)
|
|
3204
|
+
oweTerminalDelivery(notify, { task_id: taskId, task_type: "background_agent" });
|
|
3177
3205
|
childInternals.peerSelfRef?.addAxis("h", taskId);
|
|
3178
3206
|
if (agentName !== undefined) {
|
|
3179
3207
|
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" }));
|
|
@@ -3191,24 +3219,30 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3191
3219
|
stepRecorder.lockTo(taskId);
|
|
3192
3220
|
bg.registry.bindBackgroundAgentSession(taskId, bgChildSessionId, opts.runner.sessions);
|
|
3193
3221
|
const bgCycleSeq = bg.registry.backgroundAgentCycleSeq(taskId);
|
|
3194
|
-
|
|
3195
|
-
|
|
3196
|
-
|
|
3197
|
-
const
|
|
3198
|
-
const
|
|
3222
|
+
let retainedCycle;
|
|
3223
|
+
const cycleSeqOfFrames = () => retainedCycle?.cycleSeq ?? (parkedResume !== undefined ? (reviveRow?.seq ?? 1) + 1 : reviveRow?.seq);
|
|
3224
|
+
bg.registry.attachAgentTerminalNotifier(taskId, (ending) => {
|
|
3225
|
+
const stoppedByLanded = ending.status === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
|
|
3226
|
+
const completionIdLanded = bg.registry.getCompletionId(taskId);
|
|
3227
|
+
const seqLanded = bg.registry.backgroundAgentCycleSeq(taskId);
|
|
3228
|
+
const landedElapsedMs = Date.now() - bgStartedAt;
|
|
3229
|
+
const landedFrame = {
|
|
3199
3230
|
task_id: taskId,
|
|
3200
3231
|
task_type: "background_agent",
|
|
3201
3232
|
toolUseId: ctx.toolCallId,
|
|
3202
|
-
status:
|
|
3233
|
+
status: ending.status,
|
|
3203
3234
|
...terminalFrameFacets({ spawnName: agentName }),
|
|
3204
|
-
|
|
3205
|
-
|
|
3235
|
+
...(cycleSeqOfFrames() !== undefined ? { seq: cycleSeqOfFrames() } : {}),
|
|
3236
|
+
...(stoppedByLanded !== undefined ? { stoppedBy: stoppedByLanded } : {}),
|
|
3237
|
+
summary: ending.status === "failed" ? `Agent "${shortDesc}" failed: ${ending.error ?? "ended"}${ccElapsedTag(landedElapsedMs)}`.slice(0, 300) : ccCompletionText(shortDesc, "killed", "killed", landedElapsedMs),
|
|
3238
|
+
...(ending.status === "failed" && ending.error !== undefined ? { error: ending.error.slice(0, REPORT_FIELD_MAX) } : {}),
|
|
3206
3239
|
sessionId: bgChildSessionId,
|
|
3207
3240
|
resumable: false,
|
|
3208
|
-
...(
|
|
3241
|
+
...(completionIdLanded !== undefined ? { completionId: completionIdLanded } : {}),
|
|
3209
3242
|
};
|
|
3210
|
-
sinkEmit(backgroundChildTerminal(
|
|
3211
|
-
|
|
3243
|
+
sinkEmit(backgroundChildTerminal(landedFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(seqLanded !== undefined ? { generation: seqLanded } : {}) }));
|
|
3244
|
+
const landedLane = ending.parkLane ?? cycleSink;
|
|
3245
|
+
notifier.notify(() => landedLane?.(landedFrame, { priority: "next" }), "subagent.landedTerminalNotify");
|
|
3212
3246
|
});
|
|
3213
3247
|
const bgDurableProbe = bg.registry.durableAgentRowProbe(taskId);
|
|
3214
3248
|
const bgRowConfirmed = async () => (bgDurableProbe ? await bgDurableProbe().catch(() => false) : false);
|
|
@@ -3249,6 +3283,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3249
3283
|
if (sessionScopedBg && bgRetainLedger)
|
|
3250
3284
|
ensureSessionReapHook(bg.registry);
|
|
3251
3285
|
const bgRetain = await tryRetainChild(bgRetainLedger, sessionScopedBg && ctx.subagentRetain ? ctx.subagentRetain.ttlMs : undefined, bgChildSessionId, bgDurableProbe, { registry: bg.registry, taskId }, backgroundLegFacts(taskId));
|
|
3286
|
+
retainedCycle = bgRetain;
|
|
3252
3287
|
if (bgRetain) {
|
|
3253
3288
|
bg.registry.markRetainedContinuation(taskId);
|
|
3254
3289
|
const origRelease = bgRetain.release;
|
|
@@ -3300,17 +3335,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3300
3335
|
usage: { toolUses: toolStarts },
|
|
3301
3336
|
});
|
|
3302
3337
|
}, () => bg.registry.noteBackgroundAgentActivity(taskId));
|
|
3303
|
-
const bgPlacementRoot = ctx.rootSessionId ?? ctx.sessionId;
|
|
3304
|
-
const bgPlacementParent = ctx.sessionId;
|
|
3305
3338
|
const bgPlacement = placedTreeOwner !== undefined
|
|
3306
|
-
? {
|
|
3307
|
-
kind: "subagent",
|
|
3308
|
-
...(bgScope !== undefined ? { scope: bgScope } : {}),
|
|
3309
|
-
...(bgPlacementParent !== undefined ? { parentSessionId: bgPlacementParent } : {}),
|
|
3310
|
-
...(bgPlacementRoot !== undefined ? { rootSessionId: bgPlacementRoot } : {}),
|
|
3311
|
-
handle: taskId,
|
|
3312
|
-
owner: placedTreeOwner,
|
|
3313
|
-
}
|
|
3339
|
+
? { ...subagentTranscriptPlacement(ctx, bgScope, taskId), owner: placedTreeOwner }
|
|
3314
3340
|
: undefined;
|
|
3315
3341
|
const bgInternals = bgSink
|
|
3316
3342
|
? {
|
|
@@ -3367,6 +3393,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3367
3393
|
const driveParkedResume = async () => {
|
|
3368
3394
|
const pr = parkedResume;
|
|
3369
3395
|
const claimStores = { agentStore: bg.agentStore, checkpointStore: childParkStore };
|
|
3396
|
+
let consumed = false;
|
|
3370
3397
|
const rollbackAndThrow = async (e) => {
|
|
3371
3398
|
let disp = "retry";
|
|
3372
3399
|
try {
|
|
@@ -3374,6 +3401,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3374
3401
|
}
|
|
3375
3402
|
catch {
|
|
3376
3403
|
}
|
|
3404
|
+
if (!consumed && disp !== "failed")
|
|
3405
|
+
cycleSink = undefined;
|
|
3377
3406
|
const msg = thrownText(e);
|
|
3378
3407
|
throw new Error(disp === "rolled_back"
|
|
3379
3408
|
? `parked resume rolled back — the approval is still pending (retryable): ${msg}`
|
|
@@ -3432,6 +3461,16 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3432
3461
|
const won = await bg.registry.consumeParkedFlip(taskId, { agentStore: bg.agentStore }, pr.ticket);
|
|
3433
3462
|
if (!won)
|
|
3434
3463
|
throw new Error("the parked row moved under the resume (a stop or another transition won) — resume aborted");
|
|
3464
|
+
moveTerminalDelivery(parkedLane, notify, { task_id: taskId, task_type: "background_agent" });
|
|
3465
|
+
cycleSink = notify;
|
|
3466
|
+
consumed = true;
|
|
3467
|
+
if (parkedLane === undefined && ctx.onTaskNotification === undefined) {
|
|
3468
|
+
deliverEngineNotice(undefined, {
|
|
3469
|
+
code: "delegation.resume_lane_missing",
|
|
3470
|
+
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`,
|
|
3471
|
+
detail: { taskId, ...(reviveRow?.rootSessionId !== undefined ? { rootSessionId: reviveRow.rootSessionId } : {}) },
|
|
3472
|
+
});
|
|
3473
|
+
}
|
|
3435
3474
|
};
|
|
3436
3475
|
let childResult;
|
|
3437
3476
|
try {
|
|
@@ -3478,8 +3517,9 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3478
3517
|
reopened = false;
|
|
3479
3518
|
}
|
|
3480
3519
|
if (reopened) {
|
|
3481
|
-
bg.registry.parkBackgroundAgent(taskId, {
|
|
3520
|
+
const reParked = bg.registry.parkBackgroundAgent(taskId, {
|
|
3482
3521
|
checkpointToken: pr.ticket.token,
|
|
3522
|
+
completionSink: cycleSink,
|
|
3483
3523
|
resolveStop: async () => {
|
|
3484
3524
|
const cpS = childParkStore;
|
|
3485
3525
|
const cp = (await cpS.get(pr.ticket.token));
|
|
@@ -3488,6 +3528,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3488
3528
|
return await cpS.expire(pr.ticket.token, cp.scope);
|
|
3489
3529
|
},
|
|
3490
3530
|
});
|
|
3531
|
+
if (reParked === "parked")
|
|
3532
|
+
cycleSink = undefined;
|
|
3491
3533
|
throw new Error(`parked resume could not complete and the approval was REOPENED (still approvable/retryable): ${childResult.terminal.message ?? "failed"}`, { cause: childResult.terminal });
|
|
3492
3534
|
}
|
|
3493
3535
|
}
|
|
@@ -3510,9 +3552,10 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3510
3552
|
void bgChildPromise
|
|
3511
3553
|
.then(async (child) => {
|
|
3512
3554
|
const childFace = childTerminalFace(child.terminal);
|
|
3513
|
-
settleDelegationRow(child.terminal);
|
|
3555
|
+
const rowSettled = settleDelegationRow(child.terminal);
|
|
3514
3556
|
closeObserverWindow(childFace.status);
|
|
3515
3557
|
dropHostAbortListener();
|
|
3558
|
+
await rowSettled;
|
|
3516
3559
|
await finishWorktree(child.terminal);
|
|
3517
3560
|
try {
|
|
3518
3561
|
const ns2 = child.stats.nested;
|
|
@@ -3525,7 +3568,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3525
3568
|
}
|
|
3526
3569
|
catch {
|
|
3527
3570
|
}
|
|
3528
|
-
const seqAtSettle =
|
|
3571
|
+
const seqAtSettle = cycleSeqOfFrames();
|
|
3529
3572
|
const bgHandbackWarning = isDurablePause(child.terminal)
|
|
3530
3573
|
? undefined
|
|
3531
3574
|
: await reviewHandback({
|
|
@@ -3581,6 +3624,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3581
3624
|
? bg.registry.parkBackgroundAgent(taskId, {
|
|
3582
3625
|
checkpointToken: token,
|
|
3583
3626
|
seq: seqAtSettle ?? 1,
|
|
3627
|
+
completionSink: cycleSink,
|
|
3584
3628
|
resolveStop: async () => {
|
|
3585
3629
|
const cpS = childParkStore;
|
|
3586
3630
|
const cp = (await cpS.get(token));
|
|
@@ -3648,7 +3692,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3648
3692
|
const bgTerminalSummary = failReasonBg !== undefined
|
|
3649
3693
|
? `Agent "${shortDesc}" failed: ${failReasonBg}${ccElapsedTag(bgElapsedMs)}${observerNote}`.slice(0, 300) + errorKindClause(errClassBg)
|
|
3650
3694
|
: `${ccCompletionText(shortDesc, settled, childFace.status, bgElapsedMs)}${observerNote}`;
|
|
3651
|
-
const
|
|
3695
|
+
const completionSink = cycleSink;
|
|
3696
|
+
const ownsTerminalFaces = completionSink !== undefined && bg.registry.claimAgentTerminalNotify(taskId);
|
|
3652
3697
|
const bgResultField = await completionResultField(bgHandbackResult, (report) => persistTaskArtifact(ctx.taskArtifacts, taskId, report), (ref) => bg.registry.recordArtifactRef(taskId, ref, completionIdBg), notifier);
|
|
3653
3698
|
const completionFrame = {
|
|
3654
3699
|
task_id: taskId,
|
|
@@ -3681,24 +3726,25 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3681
3726
|
owners: gateOwners,
|
|
3682
3727
|
pendingCount: aliveBgCount,
|
|
3683
3728
|
payload: completionFrame,
|
|
3684
|
-
notify,
|
|
3729
|
+
notify: completionSink,
|
|
3685
3730
|
});
|
|
3686
3731
|
}
|
|
3687
3732
|
else if (ownsTerminalFaces) {
|
|
3688
3733
|
try {
|
|
3689
|
-
|
|
3734
|
+
completionSink(completionFrame, { priority: "next" });
|
|
3690
3735
|
}
|
|
3691
3736
|
catch {
|
|
3692
3737
|
}
|
|
3693
3738
|
}
|
|
3694
3739
|
})
|
|
3695
3740
|
.catch(async (e) => {
|
|
3696
|
-
settleDelegationRow({ kind: "failed" });
|
|
3741
|
+
const rowSettled = settleDelegationRow({ kind: "failed" });
|
|
3697
3742
|
closeObserverWindow("failed");
|
|
3698
3743
|
dropHostAbortListener();
|
|
3744
|
+
await rowSettled;
|
|
3699
3745
|
void finishWorktree();
|
|
3700
3746
|
const killed = abort.signal.aborted;
|
|
3701
|
-
const seqAtSettle =
|
|
3747
|
+
const seqAtSettle = cycleSeqOfFrames();
|
|
3702
3748
|
if (bgRetain) {
|
|
3703
3749
|
if (killed)
|
|
3704
3750
|
void bgRetainLedger?.evict(ctx.toolCallId);
|
|
@@ -3723,7 +3769,8 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3723
3769
|
}
|
|
3724
3770
|
const stoppedBy = settled === "killed" ? bg.registry.getStopAttribution(taskId) ?? "system" : undefined;
|
|
3725
3771
|
const observerNote = observerNoteFor(await startBoundedObserverDrain());
|
|
3726
|
-
const
|
|
3772
|
+
const rejectSink = cycleSink;
|
|
3773
|
+
const ownsTerminalFacesReject = rejectSink !== undefined && bg.registry.claimAgentTerminalNotify(taskId);
|
|
3727
3774
|
const rejectFrame = {
|
|
3728
3775
|
task_id: taskId,
|
|
3729
3776
|
task_type: "background_agent",
|
|
@@ -3742,7 +3789,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3742
3789
|
sinkEmit(backgroundChildTerminal(rejectFrame, { taskId, sessionScoped: sessionScopedBg === true, sessionId: bgChildSessionId, transcriptId: bgChildSessionId, parentToolCallId: ctx.toolCallId, ...(bgCycleSeq !== undefined ? { generation: bgCycleSeq } : {}) }));
|
|
3743
3790
|
try {
|
|
3744
3791
|
if (ownsTerminalFacesReject)
|
|
3745
|
-
|
|
3792
|
+
rejectSink(rejectFrame, { priority: "next" });
|
|
3746
3793
|
}
|
|
3747
3794
|
catch {
|
|
3748
3795
|
}
|
|
@@ -3958,6 +4005,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
|
|
|
3958
4005
|
].filter(Boolean);
|
|
3959
4006
|
return {
|
|
3960
4007
|
content: lines.join("\n"),
|
|
4008
|
+
...(agentOutcomeIsError(childFace.status) ? { isError: true } : {}),
|
|
3961
4009
|
details: completedAgentCard(child, {
|
|
3962
4010
|
...(def !== undefined ? { subagentType: def.name } : {}),
|
|
3963
4011
|
error: errClass,
|
|
@@ -5,9 +5,9 @@ import { receiptRefusal, receiveOwnProperties } from "../core/own-property-recei
|
|
|
5
5
|
import { credentialHeaderValues, holdOwnCredentialValues, isBlankCredential, isCredentialHeaderName, isSchemedCredentialHeader } from "../core/secret-env.js";
|
|
6
6
|
import { deliverEngineNotice } from "../core/engine-notice.js";
|
|
7
7
|
import { uuidv7 } from "../engine/session/uuid.js";
|
|
8
|
-
import { REDACTION_MARKS } from "../core/redaction-marks.js";
|
|
9
|
-
import {
|
|
10
|
-
const REDACTED_VALUE =
|
|
8
|
+
import { REDACTION_MARKS, WITHHELD_VALUE_MARK } from "../core/redaction-marks.js";
|
|
9
|
+
import { CREDENTIAL_VOCABULARY } from "@sema-agent/primitives";
|
|
10
|
+
const REDACTED_VALUE = WITHHELD_VALUE_MARK;
|
|
11
11
|
const REDACTED_CREDENTIALS = REDACTION_MARKS.credentials;
|
|
12
12
|
function servableParse(raw) {
|
|
13
13
|
let u;
|
|
@@ -181,7 +181,12 @@ export function joinRequestUrl(root, suffix) {
|
|
|
181
181
|
}
|
|
182
182
|
return composed;
|
|
183
183
|
}
|
|
184
|
-
const AUTHORITY_USERINFO =
|
|
184
|
+
const AUTHORITY_USERINFO = (() => {
|
|
185
|
+
const row = CREDENTIAL_VOCABULARY.values.find((r) => r.id === "url-userinfo");
|
|
186
|
+
if (row === undefined)
|
|
187
|
+
throw new Error('route-adjudicator: the credential vocabulary has no "url-userinfo" row');
|
|
188
|
+
return new RegExp(row.match.source, row.match.flags);
|
|
189
|
+
})();
|
|
185
190
|
export function stripUrlCredentials(text) {
|
|
186
191
|
return text.replace(AUTHORITY_USERINFO, `$1${REDACTED_CREDENTIALS}@`);
|
|
187
192
|
}
|
|
@@ -313,6 +313,10 @@ type AllowedToolsSeat = keyof typeof ALLOW_LIST_SEATS;
|
|
|
313
313
|
* cannot be received ({@link receiveAnchoredMember}) with `config.invalid_argument`; an anchored path rule whose set declares a
|
|
314
314
|
* base it cannot be read at — a relative spelling, one of no tree's family — with the code and issue (`unsupported.path_base`) a
|
|
315
315
|
* deny / ask rule set's declaration meets (`unusableDeclaredBase`, the one judgment).
|
|
316
|
+
*
|
|
317
|
+
* Exported from the package root: a host that takes an allow list in ahead of the run (an admission door) calls this with the seat the
|
|
318
|
+
* list will be handed at, and meets — at the door, in the same words and with the same `code` and `issues` — the refusal the run would
|
|
319
|
+
* answer at its start. It is the one judgment; the host writes no second one.
|
|
316
320
|
*/
|
|
317
321
|
export declare function screenAllowedToolsValue(value: unknown, seat: AllowedToolsSeat): readonly AllowListEntry[] | undefined;
|
|
318
322
|
/** The disclosure record for one member, minted from the entries it matched: each sanitized (deployment or model-authored
|
|
@@ -81,7 +81,7 @@ function judgeTool(row, live, station) {
|
|
|
81
81
|
return { member: "tool", disposition: "veto", code: "resume.target_moved", message: vetoed(row.toolName, "the tool's declaration (what it does, reaches and trusts: its effect, egress, irreversibility, content origin, boundary legs, rule face or model gate) changed after the approval") };
|
|
82
82
|
}
|
|
83
83
|
function judgeTargets(row, live) {
|
|
84
|
-
if ((row.targets === undefined && row.targetReads === undefined) || ("decided" in live && !licenseCovers(row.boundInputHash, live.decided)))
|
|
84
|
+
if ((row.targets === undefined && row.targetReads === undefined) || ("decided" in live && !licenseCovers(row.boundInputHash, row.toolName, live.decided)))
|
|
85
85
|
return undefined;
|
|
86
86
|
const why = landedElsewhere(row.targets, row.targetReads, live);
|
|
87
87
|
return why === undefined ? undefined : { member: "targets", disposition: "veto", code: "resume.target_moved", message: vetoed(row.toolName, why) };
|
package/dist/core/arg-summary.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { readProgramPosition } from "../tools/fs/bash-program-position.js";
|
|
2
2
|
import { argvOf, lexShell } from "../shell/lex.js";
|
|
3
|
-
import { isSensitiveRecordKey } from "
|
|
3
|
+
import { isSensitiveRecordKey } from "@sema-agent/primitives";
|
|
4
4
|
import { egressText } from "./untrusted-egress.js";
|
|
5
5
|
const ACTIVITY_ARG_MAX = 80;
|
|
6
6
|
function truncCodePoints(s) {
|
|
@@ -136,7 +136,7 @@ export declare function hookAskReasonOf(registration: string | undefined, cause:
|
|
|
136
136
|
* inherited station's read of an ancestor's ask): the receipt's own words, under the asker its own members name (the origin
|
|
137
137
|
* ladder over {@link INHERITED_STATION_FACTS} — a rule it matched, a classifier fallback it replays, else the policy). None when
|
|
138
138
|
* the ask has no words, or when its engine record says its words are the engine's generic question for the call
|
|
139
|
-
* (
|
|
139
|
+
* ({@link engineSentenceOf}, while the ask's sentence is still that one: a write gate's default question, the plan mode's — the
|
|
140
140
|
* call's arguments and the ask's class already say it).
|
|
141
141
|
*/
|
|
142
142
|
export declare function chainAskReasonsOf(receipt: Extract<PermissionResult, {
|
package/dist/core/ask-origin.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { attestationOf } from "./engine-attestation.js";
|
|
1
|
+
import { attestationOf, engineSentenceOf } from "./engine-attestation.js";
|
|
2
2
|
import { isShellFaceToolName } from "./tool-registry.js";
|
|
3
3
|
import { inlineUntrusted } from "./untrusted-text.js";
|
|
4
4
|
export const ASK_ORIGINS = Object.freeze(["content_question", "plan_review", "ancestor_marked", "org_unavailable", "org_rule", "rule_store_unavailable", "hook", "ask_rule", "denial_limit_fallback", "shell_gate_tighten", "safety_tighten", "policy"]);
|
|
@@ -22,7 +22,7 @@ export function chainAskReasonsOf(receipt, call) {
|
|
|
22
22
|
const record = attestationOf(receipt, call);
|
|
23
23
|
if (record?.receivedAskReasons !== undefined)
|
|
24
24
|
return record.receivedAskReasons.length > 0 ? record.receivedAskReasons : undefined;
|
|
25
|
-
if (message === undefined ||
|
|
25
|
+
if (message === undefined || engineSentenceOf(receipt, call)?.generic === true)
|
|
26
26
|
return undefined;
|
|
27
27
|
const by = askOriginOf(receipt, { ...INHERITED_STATION_FACTS, call });
|
|
28
28
|
const words = inlineUntrusted(message, ASK_REASON_WORDS_MAX);
|
|
@@ -77,8 +77,8 @@ export interface AskQuestionRequest {
|
|
|
77
77
|
* question. `readonly` + same caveat as `principal`. */
|
|
78
78
|
readonly agentId?: string;
|
|
79
79
|
/**
|
|
80
|
-
* The canonical hash of the tool
|
|
81
|
-
* engine's one `
|
|
80
|
+
* The canonical hash of the tool call this question was built from — the call's tool and its arguments, as computed by
|
|
81
|
+
* the engine's one call binding `exactBoundInputHashOf` (the same digest the durable park binds its checkpoint to, so the
|
|
82
82
|
* two lanes are reconcilable against each other). Present only when the engine routed the question
|
|
83
83
|
* — a directly-mounted tool calling its own face carries none.
|
|
84
84
|
*
|