@fungi.computer/shiitake 0.5.0 → 0.6.0

package/docs/api/cloudflare.md

@@ -428,7 +428,13 @@ type CloudflareShiitake = ShiitakeOwnerAgent &
       sessionId,
       commandId,
     ) => Promise<CommandSettlement | undefined>;
-    acceptMail: (mail, meta?, reply?) => Promise<Accepted>;
+    acceptMail: (
+      mail,
+      meta?,
+      reply?,
+      stageAcceptedNotice?,
+      sessionGrantDelivery?,
+    ) => Promise<Accepted>;
     alarm: () => Promise<void>;
     activeSessions: () => Promise<readonly string[]>;
     abortActive: () => Promise<void>;

package/docs/api/delegation.md

@@ -24,9 +24,9 @@ new AgentDelegation(deps): AgentDelegation;
 
 ###### Parameters
 
-| Parameter | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `deps`    | `Readonly`\<\{ `storage`: `WatchdogSqliteOwner`; `expiresAt`: () => `number`; `identity`: () => \| [`DelegationIdentity`](#delegationidentity) \| `null` \| `Promise`\<[`DelegationIdentity`](#delegationidentity) \| `null`\>; `directory`: () => [`AgentControlDirectory`](agent-control.md#agentcontroldirectory); `deliver`: (`mail`) => `Promise`\<[`DelegationReceipt`](client.md#delegationreceipt)\>; `prepare`: (`mail`) => `Promise`\<`void`\>; `accept`: (`mail`, `reply?`) => `Promise`\<[`Accepted`](client.md#accepted)\>; \}\> |
+| Parameter | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `deps`    | `Readonly`\<\{ `storage`: `WatchdogSqliteOwner`; `expiresAt`: () => `number`; `identity`: () => \| [`DelegationIdentity`](#delegationidentity) \| `null` \| `Promise`\<[`DelegationIdentity`](#delegationidentity) \| `null`\>; `directory`: () => [`AgentControlDirectory`](agent-control.md#agentcontroldirectory); `deliver`: (`mail`) => `Promise`\<[`DelegationReceipt`](client.md#delegationreceipt)\>; `prepare`: (`mail`) => `Promise`\<`void`\>; `stageAcceptedNotice`: (`mail`, `scopeId`) => `void`; `accept`: (`mail`, `reply`, `stageAcceptedNotice`) => `Promise`\<[`Accepted`](client.md#accepted)\>; \}\> |
 
 ###### Returns
 
@@ -144,6 +144,24 @@ Admit one addressed Agent mail for this Agent, or refuse it.
 
 `Promise`\<`PostDeliveryResult`\>
 
+##### localUndeliverable()
+
+```ts
+localUndeliverable(original): Promise<PostDeliveryResult>;
+```
+
+Admit local outbox exhaustion through the same Fleet/system reply gate.
+
+###### Parameters
+
+| Parameter  | Type          |
+| ---------- | ------------- |
+| `original` | `BirdDogMail` |
+
+###### Returns
+
+`Promise`\<`PostDeliveryResult`\>
+
 ---
 
 ### AgentDisclosureRefused
@@ -189,9 +207,9 @@ new AgentMail(deps): AgentMail;
 
 ###### Parameters
 
-| Parameter | Type                                                                                                                                                                                                                                                                                                                                                                                                |
-| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `deps`    | `Readonly`\<\{ `storage`: `WatchdogSqliteOwner`; `post`: () => [`AgentMailPost`](#agentmailpost); `identity`: () => \| [`DelegationIdentity`](#delegationidentity) \| `null` \| `Promise`\<[`DelegationIdentity`](#delegationidentity) \| `null`\>; `replySettlement`: [`AgentReplySettlement`](#agentreplysettlement); `drain`: () => `Promise`\<`void`\>; `wake`: () => `Promise`\<`void`\>; \}\> |
+| Parameter | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `deps`    | `Readonly`\<\{ `storage`: `WatchdogSqliteOwner`; `post`: () => [`AgentMailPost`](#agentmailpost); `identity`: () => \| [`DelegationIdentity`](#delegationidentity) \| `null` \| `Promise`\<[`DelegationIdentity`](#delegationidentity) \| `null`\>; `replySettlement`: [`AgentReplySettlement`](#agentreplysettlement); `onUndeliverable`: (`original`, `reply`) => `Promise`\<`PostDeliveryResult`\>; `drain`: () => `Promise`\<`void`\>; `wake`: () => `Promise`\<`void`\>; \}\> |
 
 ###### Returns
 
@@ -217,18 +235,53 @@ Submit one mail and return recipient acceptance or relay-held custody.
 
 `Promise`\<[`DelegationReceipt`](client.md#delegationreceipt)\>
 
+##### stageUndeliverableReplies()
+
+```ts
+stageUndeliverableReplies(): Promise<void>;
+```
+
+Reconcile exhausted original outbox mail into one local system reply.
+
+###### Returns
+
+`Promise`\<`void`\>
+
+##### stageAcceptedNotice()
+
+```ts
+stageAcceptedNotice(mail, scopeId): void;
+```
+
+Stage the acceptance reply through this Post owner without leaving the
+transaction.
+
+###### Parameters
+
+| Parameter | Type          |
+| --------- | ------------- |
+| `mail`    | `BirdDogMail` |
+| `scopeId` | `string`      |
+
+###### Returns
+
+`void`
+
 ##### mailRoom()
 
 ```ts
-mailRoom(): BirdDogEffect;
+mailRoom(): Readonly<{
+  fanOut: (settlement) => Effect<void, BirdDogError>;
+  postMail?: (mail) => Effect<void, BirdDogError>;
+  drainOutbox: () => Effect<void, BirdDogError>;
+  nextWakeAt: () => Effect<number | undefined, BirdDogError>;
+}> & object;
 ```
 
 BirdDog's mail room: disclosed settlement replies fan out over Post.
 
 ###### Returns
 
-`BirdDogEffect`
-
 ## Type Aliases
 
 ### DelegationIdentity
@@ -272,7 +325,7 @@ type AgentMailPost = Pick<
   PostRuntime<{
     agentMail: ReturnType<typeof agentMailRoute>;
   }>,
-  "send" | "read" | "nextWake"
+  "send" | "read" | "nextWake" | "deadLetters"
 >;
 ```
 
@@ -302,106 +355,206 @@ link routes Agent work without owning Shiitake's grammar.
 ### agentMailRoute()
 
 ```ts
-function agentMailRoute(namespace, replySettlement): PostRoute<AgentMailAddress, {
-  key: string;
-  to: {
-     kind: "agent";
-     agentId: string;
-     sessionId: string;
-  };
+function agentMailRoute(namespace, replySettlement): PostRoute<AgentMailAddress,
+  | {
   from: {
      kind: "agent";
      agentId: string;
      sessionId: string;
   };
-  replyTo: readonly object[];
-  content: string;
-  createdAt: number;
-  meta?: Json | undefined;
   reply?:   | {
      commandId: string;
      outcome: "completed" | "failed" | "cancelled" | "interrupted" | "outcome_unknown";
      diagnostic?: string;
+   }
+     | {
+     outcome: "accepted";
+     commandId: string;
    }
      | {
      outcome: "undeliverable";
-     reason: "recipient_offline" | "recipient_left";
+     reason: "recipient_left";
    };
-}, {
   key: string;
   to: {
      kind: "agent";
      agentId: string;
-     sessionId: string;
+     sessionId?: string;
   };
+  replyTo: readonly object[];
+  content: string;
+  createdAt: number;
+  meta?: Json | undefined;
+}
+  | {
   from: {
+     kind: "system";
+     systemId: "hub";
+  };
+  reply: {
+     outcome: "undeliverable";
+     reason: "recipient_offline";
+  };
+  key: string;
+  to: {
      kind: "agent";
      agentId: string;
-     sessionId: string;
+     sessionId?: string;
   };
   replyTo: readonly object[];
   content: string;
   createdAt: number;
   meta?: Json | undefined;
+},
+  | {
+  from: {
+     kind: "agent";
+     agentId: string;
+     sessionId: string;
+  };
   reply?:   | {
      commandId: string;
      outcome: "completed" | "failed" | "cancelled" | "interrupted" | "outcome_unknown";
      diagnostic?: string;
+   }
+     | {
+     outcome: "accepted";
+     commandId: string;
    }
      | {
      outcome: "undeliverable";
-     reason: "recipient_offline" | "recipient_left";
+     reason: "recipient_left";
    };
-}, AgentMailAddress, {
   key: string;
   to: {
      kind: "agent";
      agentId: string;
-     sessionId: string;
+     sessionId?: string;
   };
+  replyTo: readonly object[];
+  content: string;
+  createdAt: number;
+  meta?: Json | undefined;
+}
+  | {
   from: {
+     kind: "system";
+     systemId: "hub";
+  };
+  reply: {
+     outcome: "undeliverable";
+     reason: "recipient_offline";
+  };
+  key: string;
+  to: {
      kind: "agent";
      agentId: string;
-     sessionId: string;
+     sessionId?: string;
   };
   replyTo: readonly object[];
   content: string;
   createdAt: number;
   meta?: Json | undefined;
+}, AgentMailAddress,
+  | {
+  from: {
+     kind: "agent";
+     agentId: string;
+     sessionId: string;
+  };
   reply?:   | {
      commandId: string;
      outcome: "completed" | "failed" | "cancelled" | "interrupted" | "outcome_unknown";
      diagnostic?: string;
+   }
+     | {
+     outcome: "accepted";
+     commandId: string;
    }
      | {
      outcome: "undeliverable";
-     reason: "recipient_offline" | "recipient_left";
+     reason: "recipient_left";
    };
-}, {
   key: string;
   to: {
      kind: "agent";
      agentId: string;
-     sessionId: string;
+     sessionId?: string;
   };
+  replyTo: readonly object[];
+  content: string;
+  createdAt: number;
+  meta?: Json | undefined;
+}
+  | {
   from: {
+     kind: "system";
+     systemId: "hub";
+  };
+  reply: {
+     outcome: "undeliverable";
+     reason: "recipient_offline";
+  };
+  key: string;
+  to: {
      kind: "agent";
      agentId: string;
-     sessionId: string;
+     sessionId?: string;
   };
   replyTo: readonly object[];
   content: string;
   createdAt: number;
   meta?: Json | undefined;
+},
+  | {
+  from: {
+     kind: "agent";
+     agentId: string;
+     sessionId: string;
+  };
   reply?:   | {
      commandId: string;
      outcome: "completed" | "failed" | "cancelled" | "interrupted" | "outcome_unknown";
      diagnostic?: string;
+   }
+     | {
+     outcome: "accepted";
+     commandId: string;
    }
      | {
      outcome: "undeliverable";
-     reason: "recipient_offline" | "recipient_left";
+     reason: "recipient_left";
    };
+  key: string;
+  to: {
+     kind: "agent";
+     agentId: string;
+     sessionId?: string;
+  };
+  replyTo: readonly object[];
+  content: string;
+  createdAt: number;
+  meta?: Json | undefined;
+}
+  | {
+  from: {
+     kind: "system";
+     systemId: "hub";
+  };
+  reply: {
+     outcome: "undeliverable";
+     reason: "recipient_offline";
+  };
+  key: string;
+  to: {
+     kind: "agent";
+     agentId: string;
+     sessionId?: string;
+  };
+  replyTo: readonly object[];
+  content: string;
+  createdAt: number;
+  meta?: Json | undefined;
 }> & Omit<Readonly<{
   addressKind: string;
   deadlineMs?: number;
@@ -439,35 +592,55 @@ retries.
 
 #### Returns
 
-`PostRoute`\<`AgentMailAddress`, \{ `key`: `string`; `to`: \{ `kind`: `"agent"`;
-`agentId`: `string`; `sessionId`: `string`; \}; `from`: \{ `kind`: `"agent"`;
-`agentId`: `string`; `sessionId`: `string`; \}; `replyTo`: readonly `object`[];
-`content`: `string`; `createdAt`: `number`; `meta?`: Json \| undefined;
-`reply?`: \| \{ `commandId`: `string`; `outcome`: `"completed"` \| `"failed"` \|
-`"cancelled"` \| `"interrupted"` \| `"outcome_unknown"`; `diagnostic?`:
-`string`; \} \| \{ `outcome`: `"undeliverable"`; `reason`: `"recipient_offline"`
-\| `"recipient_left"`; \}; \}, \{ `key`: `string`; `to`: \{ `kind`: `"agent"`;
-`agentId`: `string`; `sessionId`: `string`; \}; `from`: \{ `kind`: `"agent"`;
-`agentId`: `string`; `sessionId`: `string`; \}; `replyTo`: readonly `object`[];
-`content`: `string`; `createdAt`: `number`; `meta?`: Json \| undefined;
-`reply?`: \| \{ `commandId`: `string`; `outcome`: `"completed"` \| `"failed"` \|
-`"cancelled"` \| `"interrupted"` \| `"outcome_unknown"`; `diagnostic?`:
-`string`; \} \| \{ `outcome`: `"undeliverable"`; `reason`: `"recipient_offline"`
-\| `"recipient_left"`; \}; \}, `AgentMailAddress`, \{ `key`: `string`; `to`: \{
-`kind`: `"agent"`; `agentId`: `string`; `sessionId`: `string`; \}; `from`: \{
-`kind`: `"agent"`; `agentId`: `string`; `sessionId`: `string`; \}; `replyTo`:
+`PostRoute`\<`AgentMailAddress`, \| \{ `from`: \{ `kind`: `"agent"`; `agentId`:
+`string`; `sessionId`: `string`; \}; `reply?`: \| \{ `commandId`: `string`;
+`outcome`: `"completed"` \| `"failed"` \| `"cancelled"` \| `"interrupted"` \|
+`"outcome_unknown"`; `diagnostic?`: `string`; \} \| \{ `outcome`: `"accepted"`;
+`commandId`: `string`; \} \| \{ `outcome`: `"undeliverable"`; `reason`:
+`"recipient_left"`; \}; `key`: `string`; `to`: \{ `kind`: `"agent"`; `agentId`:
+`string`; `sessionId?`: `string`; \}; `replyTo`: readonly `object`[]; `content`:
+`string`; `createdAt`: `number`; `meta?`: Json \| undefined; \} \| \{ `from`: \{
+`kind`: `"system"`; `systemId`: `"hub"`; \}; `reply`: \{ `outcome`:
+`"undeliverable"`; `reason`: `"recipient_offline"`; \}; `key`: `string`; `to`:
+\{ `kind`: `"agent"`; `agentId`: `string`; `sessionId?`: `string`; \};
+`replyTo`: readonly `object`[]; `content`: `string`; `createdAt`: `number`;
+`meta?`: Json \| undefined; \}, \| \{ `from`: \{ `kind`: `"agent"`; `agentId`:
+`string`; `sessionId`: `string`; \}; `reply?`: \| \{ `commandId`: `string`;
+`outcome`: `"completed"` \| `"failed"` \| `"cancelled"` \| `"interrupted"` \|
+`"outcome_unknown"`; `diagnostic?`: `string`; \} \| \{ `outcome`: `"accepted"`;
+`commandId`: `string`; \} \| \{ `outcome`: `"undeliverable"`; `reason`:
+`"recipient_left"`; \}; `key`: `string`; `to`: \{ `kind`: `"agent"`; `agentId`:
+`string`; `sessionId?`: `string`; \}; `replyTo`: readonly `object`[]; `content`:
+`string`; `createdAt`: `number`; `meta?`: Json \| undefined; \} \| \{ `from`: \{
+`kind`: `"system"`; `systemId`: `"hub"`; \}; `reply`: \{ `outcome`:
+`"undeliverable"`; `reason`: `"recipient_offline"`; \}; `key`: `string`; `to`:
+\{ `kind`: `"agent"`; `agentId`: `string`; `sessionId?`: `string`; \};
+`replyTo`: readonly `object`[]; `content`: `string`; `createdAt`: `number`;
+`meta?`: Json \| undefined; \}, `AgentMailAddress`, \| \{ `from`: \{ `kind`:
+`"agent"`; `agentId`: `string`; `sessionId`: `string`; \}; `reply?`: \| \{
+`commandId`: `string`; `outcome`: `"completed"` \| `"failed"` \| `"cancelled"`
+\| `"interrupted"` \| `"outcome_unknown"`; `diagnostic?`: `string`; \} \| \{
+`outcome`: `"accepted"`; `commandId`: `string`; \} \| \{ `outcome`:
+`"undeliverable"`; `reason`: `"recipient_left"`; \}; `key`: `string`; `to`: \{
+`kind`: `"agent"`; `agentId`: `string`; `sessionId?`: `string`; \}; `replyTo`:
 readonly `object`[]; `content`: `string`; `createdAt`: `number`; `meta?`: Json
-\| undefined; `reply?`: \| \{ `commandId`: `string`; `outcome`: `"completed"` \|
-`"failed"` \| `"cancelled"` \| `"interrupted"` \| `"outcome_unknown"`;
-`diagnostic?`: `string`; \} \| \{ `outcome`: `"undeliverable"`; `reason`:
-`"recipient_offline"` \| `"recipient_left"`; \}; \}, \{ `key`: `string`; `to`:
-\{ `kind`: `"agent"`; `agentId`: `string`; `sessionId`: `string`; \}; `from`: \{
-`kind`: `"agent"`; `agentId`: `string`; `sessionId`: `string`; \}; `replyTo`:
+\| undefined; \} \| \{ `from`: \{ `kind`: `"system"`; `systemId`: `"hub"`; \};
+`reply`: \{ `outcome`: `"undeliverable"`; `reason`: `"recipient_offline"`; \};
+`key`: `string`; `to`: \{ `kind`: `"agent"`; `agentId`: `string`; `sessionId?`:
+`string`; \}; `replyTo`: readonly `object`[]; `content`: `string`; `createdAt`:
+`number`; `meta?`: Json \| undefined; \}, \| \{ `from`: \{ `kind`: `"agent"`;
+`agentId`: `string`; `sessionId`: `string`; \}; `reply?`: \| \{ `commandId`:
+`string`; `outcome`: `"completed"` \| `"failed"` \| `"cancelled"` \|
+`"interrupted"` \| `"outcome_unknown"`; `diagnostic?`: `string`; \} \| \{
+`outcome`: `"accepted"`; `commandId`: `string`; \} \| \{ `outcome`:
+`"undeliverable"`; `reason`: `"recipient_left"`; \}; `key`: `string`; `to`: \{
+`kind`: `"agent"`; `agentId`: `string`; `sessionId?`: `string`; \}; `replyTo`:
 readonly `object`[]; `content`: `string`; `createdAt`: `number`; `meta?`: Json
-\| undefined; `reply?`: \| \{ `commandId`: `string`; `outcome`: `"completed"` \|
-`"failed"` \| `"cancelled"` \| `"interrupted"` \| `"outcome_unknown"`;
-`diagnostic?`: `string`; \} \| \{ `outcome`: `"undeliverable"`; `reason`:
-`"recipient_offline"` \| `"recipient_left"`; \}; \}\> & `Omit`\<`Readonly`\<\{
+\| undefined; \} \| \{ `from`: \{ `kind`: `"system"`; `systemId`: `"hub"`; \};
+`reply`: \{ `outcome`: `"undeliverable"`; `reason`: `"recipient_offline"`; \};
+`key`: `string`; `to`: \{ `kind`: `"agent"`; `agentId`: `string`; `sessionId?`:
+`string`; \}; `replyTo`: readonly `object`[]; `content`: `string`; `createdAt`:
+`number`; `meta?`: Json \| undefined; \}\> & `Omit`\<`Readonly`\<\{
 `addressKind`: `string`; `deadlineMs?`: `number`; `address`: `Codec`\<`unknown`,
 `unknown`\>; `event`: `Codec`\<`unknown`, `unknown`\>; `encodeEnvelope`:
 (`envelope`) => `object`; `parseDelivery`: (`envelope`) => `object`;

package/docs/api/effect.md

@@ -19,7 +19,12 @@ type ShiitakeEffectHost = Readonly<{
     commandId,
   ) => Effect.Effect<CommandSettlement | undefined, ShiitakeError>;
   agent: ShiitakeEffectOwner;
-  acceptMail: (mail, meta?, reply?) => Effect.Effect<Accepted, ShiitakeError>;
+  acceptMail: (
+    mail,
+    meta?,
+    reply?,
+    stageAcceptedNotice?,
+  ) => Effect.Effect<Accepted, ShiitakeError>;
 }>;
 ```
 
@@ -36,6 +41,7 @@ type ModelAcquisitionEffect = Readonly<{
   retryAfterMs?: (message) => number | undefined;
   retryable: (message) => boolean;
   failureReason?: (message) => string | undefined;
+  rejection?: (message) => ProviderRejection | undefined;
   providerError?: (message) => string | undefined;
   release: Effect.Effect<void, ShiitakeError>;
 }>;
@@ -157,6 +163,7 @@ type ShiitakeEffectCommandHandler = {
     Readonly<{
       status: "accepted";
       commandId: string;
+      sessionId?: string;
     }>,
     ShiitakeError
   >;
@@ -187,6 +194,7 @@ Effect-native addressable Session handle.
 (input): Effect<Readonly<{
   status: "accepted";
   commandId: string;
+  sessionId?: string;
 }>, ShiitakeError>;
 ```
 
@@ -200,8 +208,8 @@ Accept one durable prompt command.
 
 ##### Returns
 
-`Effect`\<`Readonly`\<\{ `status`: `"accepted"`; `commandId`: `string`; \}\>,
-[`ShiitakeError`](index.md#shiitakeerror)\>
+`Effect`\<`Readonly`\<\{ `status`: `"accepted"`; `commandId`: `string`;
+`sessionId?`: `string`; \}\>, [`ShiitakeError`](index.md#shiitakeerror)\>
 
 #### Call Signature
 
@@ -489,9 +497,10 @@ function openHost(options, mailRoom): Effect<Readonly<{
    }>
     | undefined, ShiitakeError>;
   agent: ShiitakeEffectOwner;
-  acceptMail: (mail, meta?, reply?) => Effect<Readonly<{
+  acceptMail: (mail, meta?, reply?, stageAcceptedNotice?) => Effect<Readonly<{
      status: "accepted";
      commandId: string;
+     sessionId?: string;
   }>, ShiitakeError>;
 }>, ShiitakeError>;
 ```
@@ -513,8 +522,9 @@ Open the Effect-native host composition with addressed mail.
 readonly `Pick`\<`AssistantMessage`, ... \| ... \| ...\>[]; `toolCalls`:
 `number`; \}\> \| `undefined`, [`ShiitakeError`](index.md#shiitakeerror)\>;
 `agent`: [`ShiitakeEffectOwner`](#shiitakeeffectowner); `acceptMail`: (`mail`,
-`meta?`, `reply?`) => `Effect`\<`Readonly`\<\{ `status`: `"accepted"`;
-`commandId`: `string`; \}\>, [`ShiitakeError`](index.md#shiitakeerror)\>; \}\>,
+`meta?`, `reply?`, `stageAcceptedNotice?`) => `Effect`\<`Readonly`\<\{ `status`:
+`"accepted"`; `commandId`: `string`; `sessionId?`: `string`; \}\>,
+[`ShiitakeError`](index.md#shiitakeerror)\>; \}\>,
 [`ShiitakeError`](index.md#shiitakeerror)\>
 
 ---

package/docs/api/extensions.md

@@ -1081,6 +1081,7 @@ type SendInputV0 = Readonly<{
   }>;
   when: "now" | "idle";
   correlation?: string;
+  continuesWorkId?: string;
 }>;
 ```
 
@@ -1160,6 +1161,19 @@ session: string;
 
 ---
 
+### ExtensionCommandCallerV0
+
+```ts
+type ExtensionCommandCallerV0 = Readonly<{
+  agentId: string;
+  sessionId: string;
+}>;
+```
+
+Host-authenticated caller context; never decoded from command JSON or HTTP.
+
+---
+
 ### CommandHandlersV0
 
 ```ts
@@ -1168,6 +1182,7 @@ type CommandHandlersV0<C> = {
     call: Readonly<{
       sessionId: CommandSessionIdsV0[C[K]["scope"]];
       input: C[K]["input"]["Type"];
+      caller?: ExtensionCommandCallerV0;
     }>,
   ) =>
     | C[K]["output"]["Type"]
@@ -1197,6 +1212,9 @@ type AttentionV0 = Readonly<{
     sessionId,
     item,
   ) => Effect.Effect<void, ExtensionStateError, ExtensionTx>;
+  awaitsPerson: (
+    sessionId,
+  ) => Effect.Effect<boolean, ExtensionStateError, ExtensionRead>;
   clear: (
     sessionId,
     id,
@@ -1227,11 +1245,19 @@ type ExtensionContextV0<S, Config, D> = Readonly<{
   hasPendingSteer: (
     run,
   ) => Effect.Effect<boolean, ExtensionStateError, ExtensionRead>;
+  workSender: (
+    run,
+  ) => Effect.Effect<
+    AttentionRecipient | null,
+    ExtensionStateError,
+    ExtensionRead
+  >;
   hasSuccessfulToolResult: (
     run,
     toolCallId,
   ) => Effect.Effect<boolean, ExtensionStateError, ExtensionRead>;
   observe: (sessionId) => Effect.Effect<void, never, ExtensionTx>;
+  isObserved: (sessionId) => boolean;
   transact: <A, E>(body) => Effect.Effect<A, E | ExtensionStop | ShiitakeError>;
 }>;
 ```
@@ -1722,9 +1748,9 @@ A parsed invocation retains its typed handler until the transaction runs.
 
 #### Parameters
 
-| Parameter | Type                                                                           |
-| --------- | ------------------------------------------------------------------------------ |
-| `frame`   | `Readonly`\<\{ `sessionId`: `string` \| `null`; `input`: [`Json`](#json); \}\> |
+| Parameter | Type                                                                                                                                               |
+| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `frame`   | `Readonly`\<\{ `sessionId`: `string` \| `null`; `input`: [`Json`](#json); `caller?`: [`ExtensionCommandCallerV0`](#extensioncommandcallerv0); \}\> |
 
 #### Returns
 
@@ -1854,6 +1880,16 @@ Public state-update shape: infer the return _before_ rejecting async results.
 
 ---
 
+### AttentionRecipient
+
+```ts
+type AttentionRecipient = typeof AttentionRecipientSchema.Type;
+```
+
+Decoded Agent Session an attention item waits on.
+
+---
+
 ### AttentionItem
 
 ```ts
@@ -1894,6 +1930,22 @@ ASCII extension identity shared by the host definition and its clients.
 
 ---
 
+### AttentionRecipientSchema
+
+```ts
+const AttentionRecipientSchema: Struct<{
+  agentId: NonEmptyString;
+  sessionId: NonEmptyString;
+  name: NonEmptyString;
+}>;
+```
+
+The Agent Session that sent the work an item belongs to. The host derives it
+from the accepted mail; it is the only party the item waits on until it is
+escalated.
+
+---
+
 ### AttentionItemSchema
 
 ```ts
@@ -1904,11 +1956,20 @@ const AttentionItemSchema: Struct<{
   since: Int;
   expiresAt: optional<Int>;
   inbox: optional<Literal<false>>;
+  waitingOn: optional<
+    Struct<{
+      agentId: NonEmptyString;
+      sessionId: NonEmptyString;
+      name: NonEmptyString;
+    }>
+  >;
 }>;
 ```
 
 An extension-owned request for human attention; expiry is owned by its timer.
-Items marked `inbox: false` remain visible without changing the inbox state.
+Items marked `inbox: false` remain visible without changing the inbox state. An
+item with `waitingOn` waits on that Agent first and is never a person's inbox
+item until it is escalated past every Agent.
 
 ## Functions