@sema-agent/core 7.63.0 → 7.65.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.
Files changed (239) hide show
  1. package/CHANGELOG.md +725 -0
  2. package/dist/agents/cc-peer-directory.js +1 -0
  3. package/dist/agents/cc-peer-wire.d.ts +4 -0
  4. package/dist/agents/cc-peer-wire.js +1 -0
  5. package/dist/agents/cc-uds-peer-channel.js +5 -0
  6. package/dist/agents/cross-session-judge.d.ts +3 -1
  7. package/dist/agents/cross-session-judge.js +4 -1
  8. package/dist/agents/peer-directory.d.ts +8 -0
  9. package/dist/agents/peer-directory.js +4 -0
  10. package/dist/agents/peer-held-queue.d.ts +9 -3
  11. package/dist/agents/peer-held-queue.js +12 -9
  12. package/dist/agents/peer-idle.d.ts +20 -1
  13. package/dist/agents/peer-idle.js +23 -12
  14. package/dist/agents/peer-notice-route.d.ts +16 -5
  15. package/dist/agents/peer-notice-route.js +11 -9
  16. package/dist/agents/peer-notices.d.ts +25 -8
  17. package/dist/agents/peer-notices.js +6 -1
  18. package/dist/agents/peer-session-drain.d.ts +32 -6
  19. package/dist/agents/peer-session-drain.js +100 -26
  20. package/dist/agents/send-message-tool.d.ts +7 -0
  21. package/dist/agents/send-message-tool.js +18 -6
  22. package/dist/agents/subagent.js +25 -5
  23. package/dist/core/allow-entry.d.ts +4 -0
  24. package/dist/core/ask-origin.d.ts +1 -1
  25. package/dist/core/ask-origin.js +2 -2
  26. package/dist/core/ask-unresolvable-notice.d.ts +13 -4
  27. package/dist/core/ask-unresolvable-notice.js +10 -3
  28. package/dist/core/auto-compaction.d.ts +7 -5
  29. package/dist/core/auto-promote.d.ts +3 -2
  30. package/dist/core/background-agent-store.d.ts +14 -0
  31. package/dist/core/background-agent-store.js +3 -0
  32. package/dist/core/checkpoint-queries.d.ts +9 -6
  33. package/dist/core/checkpoint-queries.js +8 -3
  34. package/dist/core/checkpoint-store.d.ts +7 -4
  35. package/dist/core/context-settings.d.ts +39 -9
  36. package/dist/core/context-settings.js +32 -10
  37. package/dist/core/engine-attestation.d.ts +26 -6
  38. package/dist/core/engine-attestation.js +5 -1
  39. package/dist/core/engine-notice.d.ts +37 -2
  40. package/dist/core/engine-notice.js +3 -1
  41. package/dist/core/extension-requester.d.ts +9 -0
  42. package/dist/core/extension-requester.js +7 -0
  43. package/dist/core/file-history-store.d.ts +30 -2
  44. package/dist/core/file-history-store.js +48 -9
  45. package/dist/core/fs-write-gate-policy.js +1 -1
  46. package/dist/core/gate-fold.js +5 -1
  47. package/dist/core/gate-lanes.js +2 -0
  48. package/dist/core/gate-outcome.d.ts +39 -2
  49. package/dist/core/gate-outcome.js +20 -1
  50. package/dist/core/governance-codes.d.ts +8 -4
  51. package/dist/core/governance-codes.js +8 -3
  52. package/dist/core/leg-identity.d.ts +35 -1
  53. package/dist/core/leg-identity.js +10 -0
  54. package/dist/core/mailbox-store.d.ts +39 -4
  55. package/dist/core/mailbox-store.js +14 -2
  56. package/dist/core/memory-engine/consolidation.d.ts +13 -6
  57. package/dist/core/memory-engine/consolidation.js +26 -0
  58. package/dist/core/memory-engine/control-objects.d.ts +58 -0
  59. package/dist/core/memory-engine/control-objects.js +273 -0
  60. package/dist/core/memory-engine/control-plane-adoption.d.ts +51 -0
  61. package/dist/core/memory-engine/control-plane-adoption.js +161 -0
  62. package/dist/core/memory-engine/delegation-settlement.d.ts +73 -40
  63. package/dist/core/memory-engine/delegation-settlement.js +271 -107
  64. package/dist/core/memory-engine/dual-root.d.ts +3 -2
  65. package/dist/core/memory-engine/dual-root.js +7 -3
  66. package/dist/core/memory-engine/engine.d.ts +54 -33
  67. package/dist/core/memory-engine/engine.js +150 -157
  68. package/dist/core/memory-engine/file-backend.d.ts +58 -76
  69. package/dist/core/memory-engine/file-backend.js +111 -268
  70. package/dist/core/memory-engine/index.d.ts +3 -2
  71. package/dist/core/memory-engine/index.js +2 -1
  72. package/dist/core/memory-engine/layout.d.ts +135 -50
  73. package/dist/core/memory-engine/layout.js +214 -89
  74. package/dist/core/memory-engine/memory-age.d.ts +12 -0
  75. package/dist/core/memory-engine/memory-age.js +17 -0
  76. package/dist/core/memory-engine/memory-backend-contract.d.ts +10 -3
  77. package/dist/core/memory-engine/memory-backend-contract.js +159 -2
  78. package/dist/core/memory-engine/memory-deployment.d.ts +12 -4
  79. package/dist/core/memory-engine/memory-deployment.js +31 -6
  80. package/dist/core/memory-engine/origin-clearance.d.ts +12 -3
  81. package/dist/core/memory-engine/origin-clearance.js +64 -9
  82. package/dist/core/memory-engine/session-write-home.d.ts +34 -1
  83. package/dist/core/memory-engine/session-write-home.js +37 -10
  84. package/dist/core/memory-engine/tools.d.ts +2 -2
  85. package/dist/core/memory-engine/tools.js +7 -7
  86. package/dist/core/memory-engine/types.d.ts +55 -12
  87. package/dist/core/memory-engine/types.js +2 -1
  88. package/dist/core/memory-vector.d.ts +6 -14
  89. package/dist/core/memory.d.ts +0 -462
  90. package/dist/core/memory.js +0 -333
  91. package/dist/core/mode-policy.js +3 -3
  92. package/dist/core/mods/agent-stations.d.ts +18 -0
  93. package/dist/core/mods/agent-stations.js +8 -6
  94. package/dist/core/mods/extension-call.d.ts +4 -0
  95. package/dist/core/mods/extension-call.js +8 -0
  96. package/dist/core/mods/tool-call.js +3 -4
  97. package/dist/core/parent-spec-seat.d.ts +2 -2
  98. package/dist/core/peer-channel.d.ts +5 -0
  99. package/dist/core/permission-rule-consent.d.ts +64 -22
  100. package/dist/core/permission-rule-consent.js +106 -58
  101. package/dist/core/permission-rule-store.d.ts +56 -21
  102. package/dist/core/permission-rule-store.js +2 -0
  103. package/dist/core/refusal-echo.d.ts +20 -0
  104. package/dist/core/refusal-echo.js +33 -0
  105. package/dist/core/retention.d.ts +175 -10
  106. package/dist/core/retention.js +44 -0
  107. package/dist/core/retired-keys.d.ts +5 -0
  108. package/dist/core/retired-keys.js +3 -0
  109. package/dist/core/rule-offer-read.d.ts +0 -4
  110. package/dist/core/rule-offer-read.js +2 -18
  111. package/dist/core/runner/classifier-ladder.d.ts +10 -2
  112. package/dist/core/runner/classifier-ladder.js +4 -2
  113. package/dist/core/runner/compact-session.js +10 -7
  114. package/dist/core/runner/compaction-call-options.d.ts +7 -7
  115. package/dist/core/runner/compaction-call-options.js +3 -2
  116. package/dist/core/runner/contracts.d.ts +28 -9
  117. package/dist/core/runner/delegation-owner.d.ts +2 -3
  118. package/dist/core/runner/delegation-owner.js +2 -1
  119. package/dist/core/runner/gate-exit.d.ts +6 -0
  120. package/dist/core/runner/gate-exit.js +11 -2
  121. package/dist/core/runner/memory-consolidation-driver.d.ts +4 -2
  122. package/dist/core/runner/memory-consolidation-driver.js +8 -5
  123. package/dist/core/runner/prepare-ask-lane.js +3 -3
  124. package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -1
  125. package/dist/core/runner/prepare-caps-and-workflow.js +2 -2
  126. package/dist/core/runner/prepare-config-doors.js +4 -0
  127. package/dist/core/runner/prepare-delegation-surface.d.ts +3 -0
  128. package/dist/core/runner/prepare-delegation-surface.js +2 -2
  129. package/dist/core/runner/prepare-gate-stations.d.ts +8 -0
  130. package/dist/core/runner/prepare-gate-stations.js +15 -7
  131. package/dist/core/runner/prepare-hands-readface.js +1 -1
  132. package/dist/core/runner/prepare-inherited-gate.d.ts +3 -1
  133. package/dist/core/runner/prepare-inherited-gate.js +4 -2
  134. package/dist/core/runner/prepare-memory-engine-session.js +1 -1
  135. package/dist/core/runner/prepare-memory.d.ts +4 -0
  136. package/dist/core/runner/prepare-memory.js +22 -28
  137. package/dist/core/runner/prepare-policy-chain.js +18 -10
  138. package/dist/core/runner/prepare-prompt-inputs.js +1 -1
  139. package/dist/core/runner/prepare-task.d.ts +5 -1
  140. package/dist/core/runner/prepare-task.js +16 -11
  141. package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -1
  142. package/dist/core/runner/prepare-wiring-manifest.js +3 -2
  143. package/dist/core/runner/resume-admission.d.ts +2 -2
  144. package/dist/core/runner/resume-admission.js +2 -23
  145. package/dist/core/runner/role-resolution-table.d.ts +98 -0
  146. package/dist/core/runner/role-resolution-table.js +62 -0
  147. package/dist/core/runner/run-compaction-machinery.js +2 -2
  148. package/dist/core/runner/run-identity-wiring.js +12 -9
  149. package/dist/core/runner/run-leg.js +8 -4
  150. package/dist/core/runner/run-notification-lane.js +23 -23
  151. package/dist/core/runner/run-recovery-lanes.js +3 -3
  152. package/dist/core/runner/run-terminal-adoption.js +1 -1
  153. package/dist/core/runner/run-turn-boundary.js +14 -15
  154. package/dist/core/runner/runtask.js +1 -1
  155. package/dist/core/runner/sub-agent-deny-lists.d.ts +19 -0
  156. package/dist/core/runner/sub-agent-deny-lists.js +25 -0
  157. package/dist/core/runner/tool-occurrence.d.ts +4 -2
  158. package/dist/core/runner/tool-occurrence.js +2 -2
  159. package/dist/core/runner-deps.d.ts +1 -1
  160. package/dist/core/secret-env.d.ts +2 -2
  161. package/dist/core/secret-env.js +6 -20
  162. package/dist/core/session-checkout.d.ts +63 -3
  163. package/dist/core/session-checkout.js +152 -58
  164. package/dist/core/session-store.d.ts +6 -6
  165. package/dist/core/session-store.js +3 -3
  166. package/dist/core/shell-read-silence.js +8 -0
  167. package/dist/core/store-contracts/background-agent-store-contract.js +13 -0
  168. package/dist/core/store-contracts/peer-directory-contract.js +8 -1
  169. package/dist/core/task-event.d.ts +9 -5
  170. package/dist/core/task-notification.d.ts +137 -31
  171. package/dist/core/task-notification.js +198 -100
  172. package/dist/core/task-registry-agent.d.ts +11 -0
  173. package/dist/core/task-registry-agent.js +12 -3
  174. package/dist/core/task-registry-shared.d.ts +11 -0
  175. package/dist/core/task-registry.d.ts +18 -0
  176. package/dist/core/task-registry.js +27 -8
  177. package/dist/core/task-spec.d.ts +7 -2
  178. package/dist/core/tool-errors.d.ts +17 -9
  179. package/dist/core/tool-errors.js +1 -1
  180. package/dist/core/tool-policy.d.ts +18 -1
  181. package/dist/core/tool-policy.js +16 -7
  182. package/dist/core/tool-result-store.d.ts +20 -0
  183. package/dist/core/tool-spec.d.ts +10 -6
  184. package/dist/core/trace.d.ts +3 -2
  185. package/dist/core/workflow-journal-store.d.ts +11 -0
  186. package/dist/core/workflow-journal-store.js +7 -0
  187. package/dist/core/workflow-run-store.d.ts +9 -0
  188. package/dist/core/workflow-run-store.js +6 -0
  189. package/dist/core/write-protect.d.ts +16 -0
  190. package/dist/core/write-protect.js +10 -0
  191. package/dist/engine/compaction/compaction.d.ts +2 -1
  192. package/dist/engine/harness/types.d.ts +1 -0
  193. package/dist/engine/session/repo-utils.d.ts +14 -4
  194. package/dist/engine/session/repo-utils.js +5 -4
  195. package/dist/engine/session/session.d.ts +7 -1
  196. package/dist/engine/session/session.js +5 -2
  197. package/dist/index.d.ts +13 -11
  198. package/dist/index.js +13 -11
  199. package/dist/orchestration/run-workflow-tool.d.ts +4 -0
  200. package/dist/orchestration/run-workflow-tool.js +7 -0
  201. package/dist/orchestration/workflow-types.d.ts +2 -1
  202. package/dist/orchestration/workflow.d.ts +3 -0
  203. package/dist/orchestration/workflow.js +2 -1
  204. package/dist/prompts/default.d.ts +1 -2
  205. package/dist/scenarios/full-body.d.ts +1 -1
  206. package/dist/stores/file/adoption/adopt.d.ts +1 -1
  207. package/dist/stores/file/checkpoint-store.d.ts +6 -0
  208. package/dist/stores/file/checkpoint-store.js +4 -1
  209. package/dist/stores/file/file-history-store.d.ts +13 -0
  210. package/dist/stores/file/file-history-store.js +75 -13
  211. package/dist/stores/file/index.d.ts +12 -16
  212. package/dist/stores/file/index.js +7 -25
  213. package/dist/stores/file/permission-rule-store.d.ts +34 -0
  214. package/dist/stores/file/permission-rule-store.js +104 -9
  215. package/dist/stores/file/session-store.js +1 -1
  216. package/dist/stores/file/tool-result-store.d.ts +14 -0
  217. package/dist/stores/file/tool-result-store.js +39 -2
  218. package/dist/stores/file/workflow-journal-store.d.ts +4 -0
  219. package/dist/stores/file/workflow-journal-store.js +17 -0
  220. package/dist/stores/file/workflow-run-store.d.ts +3 -0
  221. package/dist/stores/file/workflow-run-store.js +15 -0
  222. package/dist/tools/fs/read-deny.d.ts +15 -2
  223. package/dist/tools/fs/read-deny.js +10 -2
  224. package/dist/tools/fs/shell-read-check.d.ts +8 -2
  225. package/dist/tools/fs/shell-read-check.js +7 -7
  226. package/package.json +2 -2
  227. package/test/export-surface.snapshot.json +71 -73
  228. package/wire-changes/core-stores-sql@7.64.0.json +30 -0
  229. package/wire-changes/core-stores-sql@7.65.0.json +30 -0
  230. package/wire-changes/core@7.64.0.json +2653 -0
  231. package/wire-changes/core@7.65.0.json +1650 -0
  232. package/wire-changes/mods-kernel@7.64.0.json +30 -0
  233. package/wire-changes/mods-kernel@7.65.0.json +30 -0
  234. package/wire-changes/primitives@7.64.0.json +30 -0
  235. package/wire-changes/primitives@7.65.0.json +337 -0
  236. package/dist/core/memory-recall.d.ts +0 -208
  237. package/dist/core/memory-recall.js +0 -136
  238. package/dist/stores/file/memory-store.d.ts +0 -124
  239. package/dist/stores/file/memory-store.js +0 -353
@@ -1,11 +1,12 @@
1
- import { isMailboxDecisionFinal, mailboxCrossProcessMountVerdict, moveMailboxDecision } from "../core/mailbox-store.js";
2
- import { decodeEngineFrame, ENGINE_FRAME_CODEC_VERSION, renderTaskNotificationXml, taskNotificationDedupKey } from "../core/task-notification.js";
1
+ import { isMailboxDecisionFinal, moveMailboxDecision, sessionBoxMountVerdict } from "../core/mailbox-store.js";
2
+ import { decodeEngineFrame, deliveryDiscardedNotice, ENGINE_FRAME_CODEC_VERSION, frameDelivery, renderTaskNotificationXml, taskNotificationDedupKey } from "../core/task-notification.js";
3
+ import { sameOccupant } from "../engine/session/repo-utils.js";
3
4
  import { createFrameSettlement, toolResultReceiptKey } from "../core/frame-settlement.js";
4
5
  import { PRINCIPAL_INBOX_HANDLE } from "./cross-session-ref.js";
5
6
  import { isGateMintedRecord, principalInboxConsumerOf } from "./org-delivery-gate.js";
6
7
  import { deliverEngineNotice } from "../core/types.js";
7
8
  import { buildCrossSessionEnvelope, CrossSessionCodecError, encodePeerAddress } from "./cross-session-envelope.js";
8
- import { judgeCrossSessionInbound, principalInboundLayers, resolveCrossSessionInboundSetting } from "./cross-session-judge.js";
9
+ import { isCrossSessionHoldCause, judgeCrossSessionInbound, principalInboundLayers, resolveCrossSessionInboundSetting } from "./cross-session-judge.js";
9
10
  import { judgePeerAdmission, peerAxisToken, resolvePeerLaneConfig } from "./peer-admission.js";
10
11
  import { isPeerSessionId, listPeerDirectory, PEER_SESSION_ID_GRAMMAR, peerSessionBoxHandle } from "./peer-directory.js";
11
12
  import { inlineUntrusted } from "../core/untrusted-text.js";
@@ -13,7 +14,7 @@ import { createListAgentsTool, LIST_AGENTS_TOOL_ALIAS, LIST_AGENTS_TOOL_NAME } f
13
14
  import { foldPermissionModeClass } from "./cross-session-judge.js";
14
15
  import { peerHeldQueueFor } from "./peer-held-queue.js";
15
16
  import { peerIdleMachineFor } from "./peer-idle.js";
16
- import { describePeerIdleSubscription, isPeerDeliveryReceiptState, isPeerIdleNoticeKind, peerIdleNoticeLabel, renderCrossSessionDeliveryNotice, renderCrossSessionDroppedNotice, renderCrossSessionIdleNotice, resolveCrossSessionDialogExpiry } from "./peer-notices.js";
17
+ import { describePeerIdleSubscription, isPeerDeliveryReceiptState, isPeerIdleNoticeKind, peerHeldReceiptStateOf, peerIdleNoticeLabel, renderCrossSessionDeliveryNotice, renderCrossSessionDroppedNotice, renderCrossSessionIdleNotice, resolveCrossSessionDialogExpiry } from "./peer-notices.js";
17
18
  import { routePeerDeliveryReceipt, routePeerDroppedReceipt, routePeerIdleNotice } from "./peer-notice-route.js";
18
19
  import { thrownText } from "../core/thrown-value.js";
19
20
  export const PEER_DRAIN_LEASE_TTL_MS = 5 * 60_000;
@@ -22,13 +23,13 @@ export const PRINCIPAL_INBOX_UNMINTED_CAUSE = "not_minted_by_delivery_gate";
22
23
  export function terminalsDrainPrincipalInbox(deps) {
23
24
  return principalInboxConsumerOf(deps).kind === "terminals";
24
25
  }
25
- export function judgePeerLaneMount(deps, sessionId) {
26
+ export function judgePeerLaneMount(deps, sessionId, sessions) {
26
27
  if (deps.peerDirectory === undefined)
27
28
  return undefined;
28
29
  if (deps.mailboxStore === undefined) {
29
30
  return { ok: false, code: "mailbox.cross_process_unsafe", reason: "RunnerDeps.peerDirectory is wired but RunnerDeps.mailboxStore is not — the cross-session lane parks messages in the recipient's durable session box and has no store to park them in" };
30
31
  }
31
- const store = mailboxCrossProcessMountVerdict(deps.mailboxStore);
32
+ const store = sessionBoxMountVerdict(deps.mailboxStore, sessions);
32
33
  if (!store.ok)
33
34
  return store;
34
35
  if (sessionId !== undefined && !isPeerSessionId(sessionId)) {
@@ -42,9 +43,9 @@ export function judgePeerLaneMount(deps, sessionId) {
42
43
  }
43
44
  export function judgeSessionBoxDrain(deps, leg) {
44
45
  const mailbox = deps.mailboxStore;
45
- if (mailbox === undefined || leg.isDelegatedChild)
46
+ if (mailbox === undefined || leg.isDelegatedChild || leg.unread === true)
46
47
  return undefined;
47
- if (!mailboxCrossProcessMountVerdict(mailbox).ok || !isPeerSessionId(leg.sessionId))
48
+ if (!sessionBoxMountVerdict(mailbox, leg.sessions).ok || !isPeerSessionId(leg.sessionId))
48
49
  return undefined;
49
50
  return {
50
51
  mailbox,
@@ -65,6 +66,7 @@ export function createPeerSessionDrain(opts) {
65
66
  const TERMINAL_DISPOSITIONS = new Set(["committed", "resupply_exhausted", "terminal"]);
66
67
  const isTerminalDisposition = (d) => d !== undefined && TERMINAL_DISPOSITIONS.has(d.kind);
67
68
  const clockOpt = opts.clock !== undefined ? { clock: opts.clock } : {};
69
+ const occupantOpt = opts.occupant !== undefined ? { occupant: opts.occupant } : {};
68
70
  const mintLane = (kind) => {
69
71
  const boxHandle = kind === "session" ? peerSessionBoxHandle(sessionId) : PRINCIPAL_INBOX_HANDLE;
70
72
  return {
@@ -74,7 +76,7 @@ export function createPeerSessionDrain(opts) {
74
76
  ledger: new Map(),
75
77
  ackedUpTo: undefined,
76
78
  disclosedHeld: new Set(),
77
- held: peerHeldQueueFor(scope, sessionId, kind === "session" ? clockOpt : { ...clockOpt, box: boxHandle }),
79
+ held: peerHeldQueueFor(scope, sessionId, kind === "session" ? { ...clockOpt, ...occupantOpt } : { ...clockOpt, box: boxHandle }),
78
80
  };
79
81
  };
80
82
  const lanes = opts.principalInbox === true ? [mintLane("session"), mintLane("principal")] : [mintLane("session")];
@@ -84,11 +86,11 @@ export function createPeerSessionDrain(opts) {
84
86
  let inFlight = Promise.resolve();
85
87
  let noticeRound = 0;
86
88
  let currentRound;
87
- const idleMachine = peerIdleMachineFor(scope, sessionId, clockOpt);
89
+ const idleMachine = peerIdleMachineFor(scope, sessionId, { ...clockOpt, ...occupantOpt });
88
90
  const disclose = (lane, disposition, cause, m, heldNote) => deliverEngineNotice(opts.onNotice, {
89
91
  code: "peer.inbound_disposition",
90
92
  message: `cross-session message seq ${m.seq} in ${lane.label} was ${disposition === "held"
91
- ? `HELD${heldNote !== undefined ? ` (${heldNote})` : lane.kind === "session" ? " (it entered this session's held queue and STAYS IN THE BOX \u2014 the box is that queue's durable seat, so it is not acked until it settles; it is re-judged at every boundary, released or refused with a receipt to the sender, and expires with a receipt under dialogExpiry)" : " (it entered this session's held queue for the principal inbox and STAYS IN THE BOX until it settles; it is re-judged at every boundary. The sender is another principal: no receipt reaches it from here \u2014 the delivery gate's receipt is its record)"}`
93
+ ? `HELD${heldNote !== undefined ? ` (${heldNote})` : lane.kind === "session" ? ` (it entered this session's held queue and STAYS IN THE BOX \u2014 the box is that queue's durable seat, so it is not acked until it settles; it is re-judged at every boundary, released or refused with a receipt to the sender, ${isCrossSessionHoldCause(cause) && peerHeldReceiptStateOf(cause) === "held" ? "and expires with a receipt under dialogExpiry" : "and has no expiry deadline: its cause is this session's own settings or state, not a review"})` : " (it entered this session's held queue for the principal inbox and STAYS IN THE BOX until it settles; it is re-judged at every boundary. The sender is another principal: no receipt reaches it from here \u2014 the delivery gate's receipt is its record)"}`
92
94
  : disposition === "refused"
93
95
  ? "refused by this session's crossSessionInbound setting"
94
96
  : disposition === "resupply_exhausted"
@@ -110,7 +112,7 @@ export function createPeerSessionDrain(opts) {
110
112
  const route = () => ({
111
113
  mailbox,
112
114
  scope,
113
- self: { sessionId, ...(opts.selfName?.() !== undefined ? { name: opts.selfName() } : {}), modeClass: opts.selfModeClass },
115
+ self: { sessionId, ...(opts.selfName?.() !== undefined ? { name: opts.selfName() } : {}), ...occupantOpt, modeClass: opts.selfModeClass },
114
116
  ...(opts.onError !== undefined ? { onError: opts.onError } : {}),
115
117
  });
116
118
  const buildPeerMessagePayload = (lane, m) => {
@@ -146,7 +148,10 @@ export function createPeerSessionDrain(opts) {
146
148
  crossSessionNotice: { kind, text },
147
149
  _sema_provenance: { kind: "cross_session_notice", from: encodePeerAddress(storedSessionAddress(m.peerMeta?.fromSession) ?? (m.from ?? "unknown")), taskId: boxHandle, seq: m.seq, ...(m.peerMeta !== undefined ? { peerMeta: { ...m.peerMeta } } : {}) },
148
150
  });
149
- const receiptAddress = (lane, entry) => (lane.kind === "session" ? entry.peerMeta?.fromSession : undefined);
151
+ const receiptAddress = (lane, entry) => {
152
+ const from = lane.kind === "session" ? entry.peerMeta?.fromSession : undefined;
153
+ return from === undefined ? undefined : { sessionId: from, occupant: entry.peerMeta?.fromOccupant };
154
+ };
150
155
  const receipt = (lane) => async (entry, state) => {
151
156
  const to = receiptAddress(lane, entry);
152
157
  if (to === undefined)
@@ -234,18 +239,19 @@ export function createPeerSessionDrain(opts) {
234
239
  for (const lane of lanes)
235
240
  bindHeld(lane, true);
236
241
  idleMachine.target.configure({
237
- notify: (sub, notice) => void routePeerIdleNotice(route(), sub.requester, notice),
242
+ notify: (sub, notice) => void routePeerIdleNotice(route(), { sessionId: sub.requester, occupant: sub.requesterOccupant }, notice),
238
243
  judge: (sub) => judgeMeta(readFacts(), { ...(sub.fromMode !== undefined ? { fromMode: sub.fromMode } : {}), ...(sub.selfSent ? { fromSession: sessionId } : {}) }),
239
244
  heldCount: () => lanes.reduce((n, lane) => n + lane.held.size(), 0),
240
245
  ...(opts.lastTurnText !== undefined ? { lastTurnText: opts.lastTurnText } : {}),
241
246
  });
242
247
  idleMachine.requester.configure({
243
- expired: (o) => void routePeerIdleNotice(route(), sessionId, { kind: "expired", label: o.label }),
248
+ expired: (o) => void routePeerIdleNotice(route(), { sessionId, occupant: opts.occupant }, { kind: "expired", label: o.label }),
244
249
  });
245
- const reconcileHeld = (lane, lease) => {
250
+ const reconcileHeld = async (lane, lease) => {
246
251
  const live = lease.messages.filter((m) => lane.ackedUpTo === undefined || m.seq > lane.ackedUpTo);
247
252
  lane.held.reconcile(new Map(live.map((m) => [m.seq, m.decision])));
248
253
  adoptFinalDecisions(lane, lease);
254
+ await adoptAddressedOccupant(lane, lease);
249
255
  for (const m of live) {
250
256
  const d = lane.ledger.get(m.seq);
251
257
  if (lane.held.has(m.seq)) {
@@ -263,10 +269,70 @@ export function createPeerSessionDrain(opts) {
263
269
  if (!isMailboxDecisionFinal(m.decision))
264
270
  continue;
265
271
  const d = lane.ledger.get(m.seq);
266
- if (d === undefined || d.kind === "held" || d.kind === "invalidated")
272
+ if (d === undefined || d.kind === "held" || d.kind === "invalidated" || d.kind === "addressed_elsewhere")
267
273
  lane.ledger.set(m.seq, { kind: "terminal", why: `held_${m.decision}` });
268
274
  }
269
275
  };
276
+ const confirmations = new WeakMap();
277
+ const holdsSessionNow = (lease) => {
278
+ let answer = confirmations.get(lease);
279
+ if (answer === undefined) {
280
+ answer = (async () => {
281
+ const sessions = opts.sessions;
282
+ if (typeof sessions?.headOf !== "function")
283
+ return false;
284
+ try {
285
+ const head = await sessions.headOf(sessionId);
286
+ return head !== undefined && sameOccupant(head.incarnation, opts.occupant);
287
+ }
288
+ catch (e) {
289
+ opts.onError?.(e, { phase: "degraded", sessionId, classification: "peer-box-occupant" });
290
+ return false;
291
+ }
292
+ })();
293
+ confirmations.set(lease, answer);
294
+ }
295
+ return answer;
296
+ };
297
+ const adoptAddressedOccupant = async (lane, lease) => {
298
+ if (lane.kind !== "session")
299
+ return;
300
+ const elsewhere = lease.messages.filter((m) => {
301
+ if (lane.ackedUpTo !== undefined && m.seq <= lane.ackedUpTo)
302
+ return false;
303
+ const d = lane.ledger.get(m.seq);
304
+ if (d !== undefined && d.kind !== "addressed_elsewhere")
305
+ return false;
306
+ return !sameOccupant(m.peerMeta?.occupant, opts.occupant);
307
+ });
308
+ if (elsewhere.length === 0)
309
+ return;
310
+ const confirmed = await holdsSessionNow(lease);
311
+ for (const m of elsewhere) {
312
+ if (!confirmed) {
313
+ lane.ledger.set(m.seq, { kind: "addressed_elsewhere" });
314
+ continue;
315
+ }
316
+ lane.ledger.set(m.seq, { kind: "terminal", why: "addressed_occupant" });
317
+ discardAddressedElsewhere(m);
318
+ }
319
+ };
320
+ const discardAddressedElsewhere = (m) => {
321
+ const meta = m.peerMeta;
322
+ let frame = { task_id: boxHandle, task_type: "background_agent", status: "event", summary: "cross-session box record", seq: m.seq };
323
+ if (meta?.kind === "engine_frame") {
324
+ const decoded = decodeEngineFrame(m.content);
325
+ if (decoded.ok)
326
+ frame = decoded.payload;
327
+ }
328
+ deliverEngineNotice(opts.onNotice, deliveryDiscardedNotice({ sessionId, occupant: meta?.occupant }, opts.occupant, frameDelivery(frame), "box"));
329
+ if (meta?.kind !== "peer_message" || meta.fromRoot !== undefined)
330
+ return;
331
+ const to = receiptAddress(sessionLane, m);
332
+ if (to === undefined)
333
+ return;
334
+ void routePeerDeliveryReceipt(route(), to, "refused", m.seq, meta.occupant !== undefined ? "the receiving engine: that session was deleted and created again before the message was read" : "the receiving engine: the message did not say which session of that id it was for");
335
+ };
270
336
  const wantsCompactionEffects = () => {
271
337
  for (const lane of lanes)
272
338
  for (const d of lane.ledger.values())
@@ -360,6 +426,7 @@ export function createPeerSessionDrain(opts) {
360
426
  const ackSettledPrefix = async (lane, lease) => {
361
427
  const { ledger, boxHandle } = lane;
362
428
  adoptFinalDecisions(lane, lease);
429
+ await adoptAddressedOccupant(lane, lease);
363
430
  const prefix = deriveAckPrefix(lane, lease.messages);
364
431
  if (prefix !== undefined && (lane.ackedUpTo === undefined || prefix > lane.ackedUpTo)) {
365
432
  try {
@@ -422,21 +489,22 @@ export function createPeerSessionDrain(opts) {
422
489
  currentRound.dispose(sessionLane, m.seq, "subscription_unaddressed");
423
490
  return;
424
491
  }
425
- const sub = { requester, ...(m.from !== undefined ? { requesterName: m.from } : {}), ...(meta.fromMode !== undefined ? { fromMode: meta.fromMode } : {}), selfSent: requester.toLowerCase() === sessionId.toLowerCase(), requestedAt: m.sentAt };
492
+ const sub = { requester, ...(meta.fromOccupant !== undefined ? { requesterOccupant: meta.fromOccupant } : {}), ...(m.from !== undefined ? { requesterName: m.from } : {}), ...(meta.fromMode !== undefined ? { fromMode: meta.fromMode } : {}), selfSent: requester.toLowerCase() === sessionId.toLowerCase(), requestedAt: m.sentAt };
493
+ const answerTo = { sessionId: requester, occupant: meta.fromOccupant };
426
494
  const announce = (outcome, live) => deliverEngineNotice(opts.onNotice, {
427
495
  code: "peer.idle_subscription",
428
496
  message: outcome === "recorded" || outcome === "refreshed" ? `${describePeerIdleSubscription(encodePeerAddress(peerSessionBoxHandle(requester)))} (${outcome}; ${live} live)` : `A peer session at ${encodePeerAddress(peerSessionBoxHandle(requester))} asked to be told when this session is next idle and was answered "unavailable": ${outcome === "full" ? "this session's subscription table is full" : `this session's crossSessionInbound setting is "refuse"`}.`,
429
497
  detail: { outcome, fromSession: requester, live, seq: m.seq, box: boxHandle, sessionId, runId },
430
498
  });
431
499
  if (facts.setting.value === "refuse") {
432
- void routePeerIdleNotice(route(), requester, { kind: "unavailable" });
500
+ void routePeerIdleNotice(route(), answerTo, { kind: "unavailable" });
433
501
  announce("refused", idleMachine.target.size());
434
502
  currentRound.dispose(sessionLane, m.seq, "subscription_refused");
435
503
  return;
436
504
  }
437
505
  const outcome = idleMachine.target.subscribe(sub);
438
506
  if (outcome === "full")
439
- void routePeerIdleNotice(route(), requester, { kind: "unavailable" });
507
+ void routePeerIdleNotice(route(), answerTo, { kind: "unavailable" });
440
508
  announce(outcome, idleMachine.target.size());
441
509
  currentRound.dispose(sessionLane, m.seq, `subscription_${outcome}`);
442
510
  };
@@ -560,7 +628,7 @@ export function createPeerSessionDrain(opts) {
560
628
  round.lease(leased.map((c) => c.lane));
561
629
  for (const { lane, lease } of leased) {
562
630
  bindHeld(lane, true);
563
- reconcileHeld(lane, lease);
631
+ await reconcileHeld(lane, lease);
564
632
  await lane.held.rejudge();
565
633
  }
566
634
  try {
@@ -806,25 +874,28 @@ function peerModeClassOf(refs) {
806
874
  return refs.askEffective !== undefined ? foldPermissionModeClass(refs.permissionMode?.(), refs.askEffective) : "unknown";
807
875
  }
808
876
  export function announcePeerLaneMount(deps, leg) {
809
- const verdict = judgePeerLaneMount(deps, leg.sessionId);
877
+ const verdict = judgePeerLaneMount(deps, leg.sessionId, leg.sessions);
810
878
  if (verdict === undefined)
811
879
  return false;
812
880
  if (verdict.ok)
813
881
  return true;
814
882
  deliverEngineNotice(deps.onNotice, {
815
883
  code: "config.peer_lane_unmounted",
816
- message: `Cross-session lane NOT mounted for this run: ${verdict.reason}. ListAgents is not mounted and peer-session addresses refuse with that reason${verdict.code === PEER_SESSION_ID_UNGRAMMATICAL_CODE ? "." : "; wire a mailbox store that declares crossProcessSafe: true (the bundled FileMailboxStore does)."}`,
884
+ message: `Cross-session lane NOT mounted for this run: ${verdict.reason}. ListAgents is not mounted and peer-session addresses refuse with that reason${verdict.code === PEER_SESSION_ID_UNGRAMMATICAL_CODE ? "." : "; wire a mailbox store that declares crossProcessSafe: true (the bundled FileMailboxStore does) over a session store that reads a session's row by id (SessionStore.headOf — the bundled session stores do)."}`,
817
885
  detail: { reason: verdict.reason, code: verdict.code, mailboxWired: deps.mailboxStore !== undefined, sessionId: leg.sessionId, runId: leg.runId },
818
886
  });
819
887
  return false;
820
888
  }
821
889
  export function peerLaneSendMessageSeats(args) {
890
+ const { sessionId, occupant, unread } = args.address;
822
891
  return {
823
892
  peerDirectory: args.peerDirectory,
824
893
  ...(args.peerChannel !== undefined ? { peerChannel: args.peerChannel } : {}),
825
894
  ...(args.listingMounted !== undefined ? { peerListingMounted: args.listingMounted } : {}),
826
895
  peerSelfSession: {
827
- sessionId: args.sessionId,
896
+ sessionId,
897
+ ...(occupant !== undefined ? { occupant } : {}),
898
+ ...(unread === true ? { occupantUnread: true } : {}),
828
899
  scope: args.scope,
829
900
  ...(args.name !== undefined ? { name: args.name } : {}),
830
901
  modeClass: () => peerModeClassOf(args.refs),
@@ -883,13 +954,14 @@ export function bindPeerSessionDrain(harness, opts) {
883
954
  }
884
955
  export function bindPeerLaneDrain(harness, args) {
885
956
  const { deps } = args;
957
+ const { sessionId, occupant } = args.address;
886
958
  let rowName;
887
959
  const lookupRowName = async () => {
888
960
  if (deps.peerDirectory === undefined)
889
961
  return;
890
962
  try {
891
963
  const rows = await listPeerDirectory(deps.peerDirectory, { scope: args.scope });
892
- rowName = rows.find((r) => r.sessionId.toLowerCase() === args.sessionId.toLowerCase())?.name;
964
+ rowName = rows.find((r) => r.sessionId.toLowerCase() === sessionId.toLowerCase())?.name;
893
965
  }
894
966
  catch {
895
967
  rowName = undefined;
@@ -897,7 +969,9 @@ export function bindPeerLaneDrain(harness, args) {
897
969
  };
898
970
  const drain = bindPeerSessionDrain(harness, {
899
971
  mailbox: deps.mailboxStore,
900
- sessionId: args.sessionId,
972
+ sessionId,
973
+ ...(occupant !== undefined ? { occupant } : {}),
974
+ sessions: args.sessions,
901
975
  runId: args.runId,
902
976
  scope: args.scope,
903
977
  ...(terminalsDrainPrincipalInbox(deps) ? { principalInbox: true } : {}),
@@ -197,9 +197,16 @@ export interface SendMessageToolOptions {
197
197
  * `ask.effective`) — read at SEND time, attested on the parked record's typed `peerMeta.fromMode`.
198
198
  * The Runner mount fills it; a direct mount without it sends with no session attestation (the
199
199
  * recipient then judges it as "no class asserted").
200
+ *
201
+ * `occupant` = the occupant this session holds (`SessionMetadata.incarnation`; absent = no token): every record this tool parks
202
+ * names it as `fromOccupant`, so a receipt or an idle notice comes back to this occupant and no later one of the id, and this
203
+ * session's idle machine is the seat of that address. `occupantUnread` = the leg could not read its occupant: its address is
204
+ * nobody's, so nothing can be addressed back to it — a message still goes (naming no `fromOccupant`), an idle subscription is refused.
200
205
  */
201
206
  peerSelfSession?: {
202
207
  sessionId: string;
208
+ occupant?: string;
209
+ occupantUnread?: true;
203
210
  scope?: string;
204
211
  name?: string;
205
212
  modeClass?: () => PermissionModeClass | "unknown";
@@ -6,10 +6,10 @@ import { normalizeAgentName, chosenAgentName, DURABLE_AGENT_HANDLE_RE, DURABLE_A
6
6
  import { announceTranscriptIntegrityGapOnce, canAccessAgentRecord, clearRevivedRowTerminalPayload } from "../core/background-agent-store.js";
7
7
  import { readClampFloor } from "../core/child-clamp-seats.js";
8
8
  import { uuidv7 } from "../internal/harness.js";
9
- import { MAILBOX_TOMBSTONED_RECIPIENT_CODE, mailboxCrossProcessMountVerdict } from "../core/mailbox-store.js";
9
+ import { MAILBOX_TOMBSTONED_RECIPIENT_CODE, sessionBoxMountVerdict } from "../core/mailbox-store.js";
10
10
  import { peerSendVerdictSeverity } from "./cross-session-judge.js";
11
11
  import { listPeerDirectory, parsePeerSessionAddress, peerSessionBoxHandle, peerSessionLane, resolvePeerSessions } from "./peer-directory.js";
12
- import { peerIdleMachineFor } from "./peer-idle.js";
12
+ import { peerIdleMachineOfOwnAddress } from "./peer-idle.js";
13
13
  import { PEER_IDLE_OUTSTANDING_CAP, PEER_IDLE_SUBSCRIPTION_TTL_MS, peerIdleNoticeLabel } from "./peer-notices.js";
14
14
  import { escapeAttributeValue, escapeEnvelopeTag, isObserverTaskId, OBSERVER_SENDMESSAGE_SENDER_REFUSAL, OBSERVER_SENDMESSAGE_TARGET_REFUSAL, } from "./observer.js";
15
15
  import { inlineUntrusted } from "../core/untrusted-text.js";
@@ -94,7 +94,7 @@ export function createSendMessageTool(opts) {
94
94
  return { active: false };
95
95
  if (opts.mailbox === undefined)
96
96
  return { active: false, reason: "a peer-session directory is wired but no mailbox store is (the lane parks messages in the recipient's durable session box)" };
97
- const verdict = mailboxCrossProcessMountVerdict(opts.mailbox);
97
+ const verdict = sessionBoxMountVerdict(opts.mailbox, opts.runner.sessions);
98
98
  return verdict.ok ? { active: true } : { active: false, reason: verdict.reason };
99
99
  })();
100
100
  const baseParameters = Type.Object({
@@ -241,6 +241,7 @@ export function createSendMessageTool(opts) {
241
241
  return { content: `Message not sent: ${text.slice(0, PEER_REFUSAL_TEXT_MAX)}`, details: { error: code, code, to, verdict, ...extra }, isError: true };
242
242
  };
243
243
  const peerSelfSessionId = opts.peerSelfSession?.sessionId ?? directMountSessionId;
244
+ const selfOccupant = opts.peerSelfSession?.occupant;
244
245
  const peerScope = guardScope ?? opts.peerSelfSession?.scope;
245
246
  let ownRowName;
246
247
  const resolvePeerTarget = async () => {
@@ -285,10 +286,12 @@ export function createSendMessageTool(opts) {
285
286
  return admissionRefusal(sendVerdict.reason, peerLabel);
286
287
  const peerMeta = {
287
288
  ...(peerSelfSessionId !== undefined ? { fromSession: peerSelfSessionId } : {}),
289
+ ...(selfOccupant !== undefined ? { fromOccupant: selfOccupant } : {}),
288
290
  ...(modeClass === "bypass" || modeClass === "prompting" ? { fromMode: modeClass } : {}),
289
291
  ...(senderKey !== undefined ? { senderKey } : {}),
290
292
  kind: "peer_message",
291
293
  ...(urgent ? { urgent: true } : {}),
294
+ ...(record.occupant !== null ? { occupant: record.occupant } : {}),
292
295
  };
293
296
  try {
294
297
  seq = await opts.mailbox.append(peerScope, handle, { from: ownRowName ?? opts.peerSelfSession?.name ?? senderLabel, content: storedContent, sentAt: now, hopChain: prospectiveChain, peerMeta });
@@ -306,23 +309,32 @@ export function createSendMessageTool(opts) {
306
309
  if (peerSelfSessionId === undefined) {
307
310
  subscription = { ok: false, code: "peer_send.other", severity: "error", message: "this mount has no session identity, so no idle notice could be addressed back to it — no subscription was made." };
308
311
  }
312
+ else if (opts.peerSelfSession?.occupantUnread === true) {
313
+ subscription = { ok: false, code: "peer_send.other", severity: "error", message: "this session's occupant could not be read, so no idle notice could be addressed back to it — no subscription was made." };
314
+ }
309
315
  else {
310
- const ask = peerIdleMachineFor(peerScope, peerSelfSessionId).requester.request(record.sessionId, peerIdleNoticeLabel(record.name) ?? handle);
311
- if (!ask.ok) {
316
+ const idle = peerIdleMachineOfOwnAddress(peerScope, peerSelfSessionId, selfOccupant !== undefined ? { occupant: selfOccupant } : {});
317
+ const ask = idle?.requester.request(record.sessionId, peerIdleNoticeLabel(record.name) ?? handle);
318
+ if (idle === undefined || ask === undefined) {
319
+ subscription = { ok: false, code: "peer_send.other", severity: "error", message: "this session was deleted and created again after this run started, so no idle notice could be addressed back to it — no subscription was made." };
320
+ }
321
+ else if (!ask.ok) {
312
322
  subscription = { ok: false, code: "peer_send.subscription_cap", severity: peerSendVerdictSeverity("peer_send.subscription_cap"), message: `you already hold ${PEER_IDLE_OUTSTANDING_CAP} outstanding idle subscriptions — no new one was made; wait for a notice or for one to expire.` };
313
323
  }
314
324
  else {
315
325
  const subMeta = {
316
326
  fromSession: peerSelfSessionId,
327
+ ...(selfOccupant !== undefined ? { fromOccupant: selfOccupant } : {}),
317
328
  ...(modeClass === "bypass" || modeClass === "prompting" ? { fromMode: modeClass } : {}),
318
329
  kind: "idle_subscription",
330
+ ...(record.occupant !== null ? { occupant: record.occupant } : {}),
319
331
  };
320
332
  try {
321
333
  subscriptionSeq = await opts.mailbox.append(peerScope, handle, { from: ownRowName ?? opts.peerSelfSession?.name ?? senderLabel, content: `[idle subscription] ${ownRowName ?? opts.peerSelfSession?.name ?? senderLabel} asked to be told once when this session next goes idle`, sentAt: now, hopChain: [], peerMeta: subMeta });
322
334
  subscription = { ok: true, disposition: record.liveness !== "live" ? "parked_offline" : "queued", via: "store" };
323
335
  }
324
336
  catch (e) {
325
- peerIdleMachineFor(peerScope, peerSelfSessionId).requester.settle(record.sessionId, "unavailable");
337
+ idle.requester.settle(record.sessionId, "unavailable");
326
338
  subscription = { ok: false, code: e?.code === MAILBOX_TOMBSTONED_RECIPIENT_CODE ? "peer_send.invalid_target" : "peer_send.other", severity: "error", message: `the session box refused the subscription record (${(thrownText(e)).slice(0, 200)}) — no subscription was made.` };
327
339
  }
328
340
  }
@@ -40,11 +40,13 @@ import { callerPlacementSeats } from "../core/runner/child-tree.js";
40
40
  import { legTaskIdOf } from "../core/leg-identity.js";
41
41
  import { delimitUntrusted, inlineUntrusted } from "../core/untrusted-text.js";
42
42
  import { createSafeNotifier } from "../core/safe-notify.js";
43
- import { boundedRedactedSummary } from "../core/untrusted-egress.js";
43
+ import { boundedRedactedSummary, extensionWords } from "../core/untrusted-egress.js";
44
+ import { readExtensionRequester } from "../core/extension-requester.js";
44
45
  import { uuidv7 } from "../internal/harness.js";
45
46
  import { addWorktree } from "../core/git-worktree-env.js";
46
47
  import { shellQuote } from "../tools/fs/search.js";
47
48
  import { BG_AGENT_REAP_STOP_ERROR, chosenAgentName } from "../core/task-registry.js";
49
+ import { agentOutcomeIsError } from "../core/task-registry-agent.js";
48
50
  import { readDurableOrgAdmission } from "../core/memory-admission.js";
49
51
  import { governanceRetryClass } from "../core/governance-codes.js";
50
52
  import { readSkillGrantCapture } from "../core/skill-grant.js";
@@ -1094,7 +1096,13 @@ function reachableOccupants(registry, scope, root, caller) {
1094
1096
  if (typeof face !== "function")
1095
1097
  return new Map();
1096
1098
  try {
1097
- return new Map(face.call(registry, scope, root, caller).filter((o) => o.reachable).map((o) => [o.id, o.name]));
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
+ }));
1098
1106
  }
1099
1107
  catch {
1100
1108
  return new Map();
@@ -1102,7 +1110,10 @@ function reachableOccupants(registry, scope, root, caller) {
1102
1110
  }
1103
1111
  function concurrencyOccupants(active, reachable, local) {
1104
1112
  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))})`);
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
+ });
1106
1117
  const rest = active.length - listed.length;
1107
1118
  if (rest > 0)
1108
1119
  parts.push(`${rest} ${listed.length > 0 ? "more " : ""}registered`);
@@ -2241,11 +2252,13 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2241
2252
  ...((reviveClaim.row.rootSessionId ?? reviveClaim.row.parentSessionId) !== undefined
2242
2253
  ? { rootSessionId: reviveClaim.row.rootSessionId ?? reviveClaim.row.parentSessionId }
2243
2254
  : {}),
2255
+ ...(reviveClaim.row.rootSessionId !== undefined && reviveClaim.row.rootSessionIncarnation !== undefined ? { rootSessionIncarnation: reviveClaim.row.rootSessionIncarnation } : {}),
2244
2256
  }
2245
2257
  : {
2246
2258
  ...(ctx.taskId !== undefined ? { parentTaskId: ctx.taskId } : {}),
2247
2259
  ...(ctx.sessionId !== undefined ? { parentSessionId: ctx.sessionId } : {}),
2248
2260
  ...((ctx.rootSessionId ?? ctx.sessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? ctx.sessionId } : {}),
2261
+ ...(ctx.rootSessionIncarnation !== undefined ? { rootSessionIncarnation: ctx.rootSessionIncarnation } : {}),
2249
2262
  ...(ctx.placementRoot !== undefined ? { placementRoot: ctx.placementRoot } : {}),
2250
2263
  }),
2251
2264
  ...(ctx.centerArtifactDigest !== undefined ? { parentCenterArtifactDigest: ctx.centerArtifactDigest } : {}),
@@ -2589,7 +2602,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2589
2602
  }
2590
2603
  if (settled && verdict === "external") {
2591
2604
  try {
2592
- await replayExternalSettlementEffects(forkSettlementSeat.governance, forkSettlementSeat.controlDir, { carry: true, now: Date.now });
2605
+ await replayExternalSettlementEffects(forkSettlementSeat.governance, { carry: true, now: Date.now });
2593
2606
  }
2594
2607
  catch {
2595
2608
  }
@@ -2608,10 +2621,12 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
2608
2621
  ...(sessionScopedBg ? { sessionScoped: true } : {}),
2609
2622
  description: shortDesc,
2610
2623
  agentType: spawnAgentType,
2624
+ ...(extensionSpawn !== undefined ? { requestedBy: extensionSpawn.requestedBy } : {}),
2611
2625
  ...(agentName !== undefined ? { name: agentName } : {}),
2612
2626
  ...(ctx.taskId !== undefined && ctx.taskId !== ctx.sessionId ? { parentTaskId: ctx.taskId } : {}),
2613
2627
  ...(ctx.sessionId !== undefined ? { parentSessionId: ctx.sessionId } : {}),
2614
2628
  ...((ctx.rootSessionId ?? ctx.sessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? ctx.sessionId } : {}),
2629
+ ...(ctx.rootSessionIncarnation !== undefined ? { rootSessionIncarnation: ctx.rootSessionIncarnation } : {}),
2615
2630
  ...(rowModelKey !== undefined ? { model: rowModelKey } : {}),
2616
2631
  deliveryChannel: "attaching",
2617
2632
  toolUseId: ctx.toolCallId,
@@ -3005,6 +3020,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3005
3020
  ].filter(Boolean);
3006
3021
  return {
3007
3022
  content: forkLines.join("\n"),
3023
+ ...(agentOutcomeIsError(forkFace.status) ? { isError: true } : {}),
3008
3024
  details: completedAgentCard(forkChild, {
3009
3025
  subagentType: FORK_SUBAGENT_TYPE,
3010
3026
  error: forkErr,
@@ -3104,7 +3120,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3104
3120
  }
3105
3121
  if (settled && verdict === "external") {
3106
3122
  try {
3107
- await replayExternalSettlementEffects(settlementSeat.governance, settlementSeat.controlDir, { carry: true, now: Date.now });
3123
+ await replayExternalSettlementEffects(settlementSeat.governance, { carry: true, now: Date.now });
3108
3124
  }
3109
3125
  catch {
3110
3126
  }
@@ -3124,6 +3140,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3124
3140
  ...(reviveRow.sessionScoped ? { sessionScoped: true } : {}),
3125
3141
  ...(reviveRow.description !== undefined ? { description: reviveRow.description } : {}),
3126
3142
  agentType: spawnAgentType,
3143
+ ...(reviveRow.requestedBy !== undefined ? { requestedBy: reviveRow.requestedBy } : {}),
3127
3144
  name: reviveRow.name,
3128
3145
  ...(reviveRow.parentTaskId !== undefined ? { parentTaskId: reviveRow.parentTaskId } : {}),
3129
3146
  ...(reviveRow.parentSessionId !== undefined ? { parentSessionId: reviveRow.parentSessionId } : {}),
@@ -3157,10 +3174,12 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3157
3174
  ...(sessionScopedBg ? { sessionScoped: true } : {}),
3158
3175
  description: shortDesc,
3159
3176
  agentType: spawnAgentType,
3177
+ ...(extensionSpawn !== undefined ? { requestedBy: extensionSpawn.requestedBy } : {}),
3160
3178
  ...(agentName !== undefined ? { name: agentName } : {}),
3161
3179
  ...(ctx.taskId !== undefined && ctx.taskId !== ctx.sessionId ? { parentTaskId: ctx.taskId } : {}),
3162
3180
  ...(ctx.sessionId !== undefined ? { parentSessionId: ctx.sessionId } : {}),
3163
3181
  ...((ctx.rootSessionId ?? ctx.sessionId) !== undefined ? { rootSessionId: ctx.rootSessionId ?? ctx.sessionId } : {}),
3182
+ ...(ctx.rootSessionIncarnation !== undefined ? { rootSessionIncarnation: ctx.rootSessionIncarnation } : {}),
3164
3183
  ...(rowModelKey !== undefined ? { model: rowModelKey } : {}),
3165
3184
  deliveryChannel: "attaching",
3166
3185
  toolUseId: ctx.toolCallId,
@@ -3989,6 +4008,7 @@ function createSubagentToolNode(opts, depth, excluded, extraToolsBudget) {
3989
4008
  ].filter(Boolean);
3990
4009
  return {
3991
4010
  content: lines.join("\n"),
4011
+ ...(agentOutcomeIsError(childFace.status) ? { isError: true } : {}),
3992
4012
  details: completedAgentCard(child, {
3993
4013
  ...(def !== undefined ? { subagentType: def.name } : {}),
3994
4014
  error: errClass,
@@ -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
@@ -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
- * (`genericQuestion`, while the ask's sentence is still that one: a write gate's default question, the plan mode's — the
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, {
@@ -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 || message === record?.genericQuestion)
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);
@@ -24,8 +24,10 @@
24
24
  * a live approver reachable for delegated children — is a deployment posture the operator hears through
25
25
  * the sink like every other code; the row only adds the session-stream projection so the person whose
26
26
  * call was refused sees WHY it did not run. `sessionId` is therefore REQUIRED at the mint (the routing
27
- * half of a user row). Dedup unit: per tool call — the gate's obligation (it owns the call); this module
28
- * is pure.
27
+ * half of a user row). On a delegated leg it is the delegation tree's root — the session a person
28
+ * watches; the child's own session has no reader — and `sourceSessionId` / `agentId` say which leg the
29
+ * refused call was (the gate station's notice address, `noticeAddressOf`). Dedup unit: per tool call —
30
+ * the gate's obligation (it owns the call); this module is pure.
29
31
  */
30
32
  import type { EngineNotice } from "./engine-notice.js";
31
33
  import { type ApprovalRemedy, type AssertAllKeysHandled, type HeadlessApproverSeat } from "./ask-origin.js";
@@ -36,8 +38,14 @@ export type AskUnresolvableCause = (typeof ASK_UNRESOLVABLE_CAUSES)[number];
36
38
  export declare function isAskUnresolvableCause(v: unknown): v is AskUnresolvableCause;
37
39
  /** What the gate knows at the deny exit — facts only, no words of the engine's vocabulary composed. */
38
40
  export interface AskUnresolvableFacts {
39
- /** The session whose call was refused — the notice's routing key, required (see module note). */
41
+ /** The session the notice is addressed to — its routing key, required (see module note): the refused leg's own session on a
42
+ * top-level leg, the delegation tree's root on a delegated one (`noticeAddressOf`, leg-identity.ts). */
40
43
  readonly sessionId: string;
44
+ /** Present exactly when the refused call was a delegated leg's: that leg's session (the call's own conversation). */
45
+ readonly sourceSessionId?: string;
46
+ /** The delegated leg's agent id, beside {@link sourceSessionId} (never without it): the id the spawner's card and the leg's
47
+ * events carry. */
48
+ readonly agentId?: string;
41
49
  /** The tool the ask was for (the message quotes it verbatim). */
42
50
  readonly toolName: string;
43
51
  /** The refused call's id — the correlation key to the `tool_end` frame carrying the same deny. */
@@ -86,7 +94,8 @@ export declare function askUnresolvableRemedySeat(cause: AskUnresolvableCause):
86
94
  * an empty session or tool name, or a cause outside the closed set, is refused at the mint with a
87
95
  * `TypeError` rather than shaped into a notice that would route nowhere or say nothing.
88
96
  *
89
- * `detail: { sessionId, toolName, toolCallId, cause, parkLaneExisted, remedy?, remedies? }` — `remedy` rides the causes that say nobody
97
+ * `detail: { sessionId, sourceSessionId?, agentId?, toolName, toolCallId, cause, parkLaneExisted, remedy?, remedies? }` — `sourceSessionId`
98
+ * and `agentId` ride a delegated leg's refusal only (the leg the call was, the notice being addressed to the tree's root); `remedy` rides the causes that say nobody
90
99
  * could be asked ({@link askUnresolvableRemedySeat}: the sentence the refusal's tool text carries) and `remedies` beside it, the same
91
100
  * way out as data ({@link ApprovalRemedy}); `sessionId` is lifted onto the typed key by {@link import("./engine-notice.js").deliverEngineNotice}, the one throat.
92
101
  */