@fungi.computer/shiitake 0.5.0 → 0.7.0

package/docs/api/fleet.md

@@ -30,7 +30,7 @@ new AgentGrantError(reason): AgentGrantError;
 
 | Parameter | Type                                                                                  |
 | --------- | ------------------------------------------------------------------------------------- |
-| `reason`  | `"agent"` \| `"action"` \| `"expired"` \| `"delegation_loop"` \| `"delegation_depth"` |
+| `reason`  | `"agent"` \| `"expired"` \| `"action"` \| `"delegation_loop"` \| `"delegation_depth"` |
 
 ###### Returns
 
@@ -47,7 +47,7 @@ Error.constructor;
 ##### reason
 
 ```ts
-readonly reason: "agent" | "action" | "expired" | "delegation_loop" | "delegation_depth";
+readonly reason: "agent" | "expired" | "action" | "delegation_loop" | "delegation_depth";
 ```
 
 ---
@@ -73,7 +73,7 @@ new DirectoryError(status, code): DirectoryError;
 | Parameter | Type                                                                                                                              |
 | --------- | --------------------------------------------------------------------------------------------------------------------------------- |
 | `status`  | `400` \| `403` \| `404` \| `409` \| `503`                                                                                         |
-| `code`    | \| `"not_found"` \| `"invalid_input"` \| `"name_taken"` \| `"request_conflict"` \| `"computer_team_conflict"` \| `"partial_init"` |
+| `code`    | \| `"not_found"` \| `"request_conflict"` \| `"invalid_input"` \| `"name_taken"` \| `"computer_team_conflict"` \| `"partial_init"` |
 
 ###### Returns
 
@@ -98,15 +98,39 @@ readonly status: 400 | 403 | 404 | 409 | 503;
 ```ts
 readonly code:
   | "not_found"
+  | "request_conflict"
   | "invalid_input"
   | "name_taken"
-  | "request_conflict"
   | "computer_team_conflict"
   | "partial_init";
 ```
 
 ## Type Aliases
 
+### AgentDelegationRequestKeyInput
+
+```ts
+type AgentDelegationRequestKeyInput = Readonly<{
+  owner:
+    | Readonly<{
+        kind: "local";
+        agentId: string;
+      }>
+    | Readonly<{
+        kind: "hosted";
+        scopeId: string;
+        agentId: string;
+      }>;
+  sourceSessionId: string;
+  targetAgentId: string;
+  requestId: string;
+}>;
+```
+
+Inputs shared by Local and hosted delegation request identity.
+
+---
+
 ### AgentAction
 
 ```ts
@@ -524,6 +548,12 @@ const agentDelegationTaskSchema: ZodLazy<
       requestId: ZodString;
       agentId: ZodString;
       sessionId: ZodOptional<ZodString>;
+      delivery: ZodOptional<
+        ZodEnum<{
+          followUp: "followUp";
+          steer: "steer";
+        }>
+      >;
       text: ZodString;
     },
     $strict
@@ -535,6 +565,28 @@ Replay identity and work, with the parent supplied exclusively by the grant.
 
 ## Functions
 
+### agentDelegationRequestKey()
+
+```ts
+function agentDelegationRequestKey(input): Promise<string>;
+```
+
+One idempotency identity for a caller-owned delegation request. The target
+Session is deliberately excluded: a sessionless send learns it only after
+acceptance, when recall must still resolve the original receipt.
+
+#### Parameters
+
+| Parameter | Type                                                                |
+| --------- | ------------------------------------------------------------------- |
+| `input`   | [`AgentDelegationRequestKeyInput`](#agentdelegationrequestkeyinput) |
+
+#### Returns
+
+`Promise`\<`string`\>
+
+---
+
 ### assertAgentGrant()
 
 ```ts
@@ -601,6 +653,30 @@ together. Physical table names retain the existing Hub store layout.
 
 ---
 
+### settlementReadableBy()
+
+```ts
+function settlementReadableBy(facts, agentId): boolean;
+```
+
+Whether an Agent may read one command's settlement: the Agent whose mail the
+command answered, or the Session's delegator of record for work no Agent's mail
+admitted (goal, loop and person turns, the work its reports carry). Another
+Agent's correspondence stays with that Agent.
+
+#### Parameters
+
+| Parameter | Type                                                                                             |
+| --------- | ------------------------------------------------------------------------------------------------ |
+| `facts`   | `Pick`\<[`CommandSettlement`](index.md#commandsettlement), `"acceptedSender"` \| `"delegator"`\> |
+| `agentId` | `string`                                                                                         |
+
+#### Returns
+
+`boolean`
+
+---
+
 ### delegationProvenance()
 
 ```ts
@@ -666,8 +742,9 @@ that reply's own line and never travel onward.
 function delegationReplyMeta(delegation, replierName): DelegationReplyMeta;
 ```
 
-The host metadata for one authenticated reply line: the replying Agent is its
-author, and the verified reply rides beside the caller's own path.
+The host metadata for one authenticated reply line. An ordinary reply is
+authored by its replying Agent; a delivery failure is a Hub/system fact, while
+the verified reply retains the failed recipient's identity.
 
 #### Parameters
 
@@ -682,6 +759,36 @@ author, and the verified reply rides beside the caller's own path.
 
 ---
 
+### readOutstandingDelegationSync()
+
+```ts
+function readOutstandingDelegationSync(storage):
+  | Readonly<{
+      agentId: string;
+      sessionId: string;
+      commandId: string;
+      unreadable?: string;
+    }>
+  | undefined;
+```
+
+Read confirmed sender receipts that have no locally observed settlement. Call
+inside the Agent owner's transaction that also changes archived state. Remote
+reads happen separately; an unobserved settlement remains busy.
+
+#### Parameters
+
+| Parameter | Type                  |
+| --------- | --------------------- |
+| `storage` | `WatchdogSqliteOwner` |
+
+#### Returns
+
+\| `Readonly`\<\{ `agentId`: `string`; `sessionId`: `string`; `commandId`:
+`string`; `unreadable?`: `string`; \}\> \| `undefined`
+
+---
+
 ### createFleetCorrespondence()
 
 ```ts
@@ -700,11 +807,14 @@ Shiitake owns work deduplication, execution and settlement; Post owns replies.
 
 #### Returns
 
-| Name                  | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `start()`             | (`grant`, `raw`) => `Promise`\<[`DelegationReceipt`](client.md#delegationreceipt)\>                                                                                                                                                                                                                                                                                                                                                                                   | Submit frozen mail or reuse its recorded Session admission receipt.                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| `authenticateReply()` | (`mail`) => \| `Readonly`\<\{ `ancestors`: readonly `string`[]; `maxDepth`: `number`; `reply`: \| \{ `commandId`: `string`; `outcome`: `"completed"` \| `"failed"` \| `"cancelled"` \| `"interrupted"` \| `"outcome_unknown"`; `diagnostic?`: `string`; `agentId`: `string`; `sessionId`: `string`; \} \| \{ `outcome`: `"undeliverable"`; `reason`: `"recipient_offline"` \| `"recipient_left"`; `agentId`: `string`; `sessionId`: `string`; \}; \}\> \| `undefined` | Match a reply to frozen mail and restore the caller's delegation path. Authenticate one arriving reply against the frozen mail this owner sent. It must be BirdDog's single reply key for that mail, mirror its sender and recipient exactly, carry BirdDog's settlement facts and, once the send's receipt is recorded, name that receipt's `commandId`. The result restores the caller's own delegation path and the verified reply; it never reads the reply's text or any settlement metadata. |
-| `receipt()`           | (`requestId`) => \| `Readonly`\<\{ `status`: `"accepted"`; `commandId`: `string`; \}\> \| `undefined`                                                                                                                                                                                                                                                                                                                                                                 | Read an existing acceptance receipt without reserving or delivering mail. Read only the existing acceptance receipt; do not reserve or deliver mail.                                                                                                                                                                                                                                                                                                                                               |
+| Name                         | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `start()`                    | (`grant`, `raw`) => `Promise`\<[`DelegationReceipt`](client.md#delegationreceipt)\>                                                                                                                                                                                                                                                                                                                                                                                                                          | Submit frozen mail or reuse its recorded Session admission receipt.                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `authenticateReply()`        | (`mail`) => \| `Readonly`\<\{ `ancestors`: readonly `string`[]; `maxDepth`: `number`; `reply`: \| \{ `commandId`: `string`; `outcome`: `"completed"` \| `"failed"` \| `"cancelled"` \| `"interrupted"` \| `"outcome_unknown"`; `diagnostic?`: `string`; `waitingOnYou?`: readonly `object`[]; `agentId`: `string`; `sessionId`: `string`; \} \| \{ `outcome`: `"undeliverable"`; `reason`: `"recipient_offline"` \| `"recipient_left"`; `agentId`: `string`; `sessionId?`: `string`; \}; \}\> \| `undefined` | Match a reply to frozen mail and restore the caller's delegation path. Authenticate one arriving reply against the frozen mail this owner sent. It must be BirdDog's single reply key for that mail, mirror its sender and recipient exactly, carry BirdDog's settlement facts and, once the send's receipt is recorded, name that receipt's `commandId`. The result restores the caller's own delegation path and the verified reply; it never reads the reply's text or any settlement metadata. |
+| `recordLocalUndeliverable()` | (`original`, `reply`) => `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Bind exhausted local delivery to its frozen sender correspondence. Bind an exhausted local Carrier row to its frozen sender correspondence.                                                                                                                                                                                                                                                                                                                                                        |
+| `recordUndeliverableReply()` | (`mailKey`) => `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Prevent replay after a system undeliverable reply is admitted. Make a successfully admitted system disposition replay-ineligible.                                                                                                                                                                                                                                                                                                                                                                  |
+| `receipt()`                  | (`requestId`) => \| `Readonly`\<\{ `status`: `"accepted"`; `commandId`: `string`; `sessionId?`: `string`; \}\> \| `undefined`                                                                                                                                                                                                                                                                                                                                                                                | Read an existing acceptance receipt without reserving or delivering mail. Read only the existing acceptance receipt; do not reserve or deliver mail.                                                                                                                                                                                                                                                                                                                                               |
+| `recordAcceptedNotice()`     | (`mail`) => \| `Readonly`\<\{ `status`: `"accepted"`; `commandId`: `string`; `sessionId?`: `string`; \}\> \| `undefined`                                                                                                                                                                                                                                                                                                                                                                                     | Consume a recipient's stable `<mailKey>:accepted` notice. Atomically bind the recipient Session carried by a late acceptance notice.                                                                                                                                                                                                                                                                                                                                                               |
 
 ---
 
@@ -725,13 +835,16 @@ it.
 
 #### Returns
 
-| Name                  | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
-| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `start()`             | (`grant`, `raw`) => `Promise`\<[`DelegationReceipt`](client.md#delegationreceipt)\>                                                                                                                                                                                                                                                                                                                                                                                   | Submit frozen mail or reuse its recorded Session admission receipt.                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| `authenticateReply()` | (`mail`) => \| `Readonly`\<\{ `ancestors`: readonly `string`[]; `maxDepth`: `number`; `reply`: \| \{ `commandId`: `string`; `outcome`: `"completed"` \| `"failed"` \| `"cancelled"` \| `"interrupted"` \| `"outcome_unknown"`; `diagnostic?`: `string`; `agentId`: `string`; `sessionId`: `string`; \} \| \{ `outcome`: `"undeliverable"`; `reason`: `"recipient_offline"` \| `"recipient_left"`; `agentId`: `string`; `sessionId`: `string`; \}; \}\> \| `undefined` | Match a reply to frozen mail and restore the caller's delegation path. Authenticate one arriving reply against the frozen mail this owner sent. It must be BirdDog's single reply key for that mail, mirror its sender and recipient exactly, carry BirdDog's settlement facts and, once the send's receipt is recorded, name that receipt's `commandId`. The result restores the caller's own delegation path and the verified reply; it never reads the reply's text or any settlement metadata. |
-| `receipt()`           | (`requestId`) => \| `Readonly`\<\{ `status`: `"accepted"`; `commandId`: `string`; \}\> \| `undefined`                                                                                                                                                                                                                                                                                                                                                                 | Read an existing acceptance receipt without reserving or delivering mail. Read only the existing acceptance receipt; do not reserve or deliver mail.                                                                                                                                                                                                                                                                                                                                               |
-| `outstanding()`       | () => `Promise`\< \| `Readonly`\<\{ `agentId`: `string`; `sessionId`: `string`; `commandId`: `string`; `unreadable?`: `string`; \}\> \| `undefined`\>                                                                                                                                                                                                                                                                                                                 | The delegated work this owner still waits on, if any. The newest delegation this owner sent whose work has not settled at its target, so the owner is still waiting for a reply; undefined when none.                                                                                                                                                                                                                                                                                              |
-| `delegate()`          | (`grant`, `task`) => `Promise`\< \| `Readonly`\<\{ `kind`: `"pending"`; `retryAfterMs`: `number`; \}\> \| [`AgentDelegationOutcome`](#agentdelegationoutcome)\>                                                                                                                                                                                                                                                                                                       | Submit or poll the exact turn, yielding Agar Pending until settled.                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| Name                         | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `start()`                    | (`grant`, `raw`) => `Promise`\<[`DelegationReceipt`](client.md#delegationreceipt)\>                                                                                                                                                                                                                                                                                                                                                                                                                          | Submit frozen mail or reuse its recorded Session admission receipt.                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `authenticateReply()`        | (`mail`) => \| `Readonly`\<\{ `ancestors`: readonly `string`[]; `maxDepth`: `number`; `reply`: \| \{ `commandId`: `string`; `outcome`: `"completed"` \| `"failed"` \| `"cancelled"` \| `"interrupted"` \| `"outcome_unknown"`; `diagnostic?`: `string`; `waitingOnYou?`: readonly `object`[]; `agentId`: `string`; `sessionId`: `string`; \} \| \{ `outcome`: `"undeliverable"`; `reason`: `"recipient_offline"` \| `"recipient_left"`; `agentId`: `string`; `sessionId?`: `string`; \}; \}\> \| `undefined` | Match a reply to frozen mail and restore the caller's delegation path. Authenticate one arriving reply against the frozen mail this owner sent. It must be BirdDog's single reply key for that mail, mirror its sender and recipient exactly, carry BirdDog's settlement facts and, once the send's receipt is recorded, name that receipt's `commandId`. The result restores the caller's own delegation path and the verified reply; it never reads the reply's text or any settlement metadata. |
+| `recordLocalUndeliverable()` | (`original`, `reply`) => `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Bind exhausted local delivery to its frozen sender correspondence. Bind an exhausted local Carrier row to its frozen sender correspondence.                                                                                                                                                                                                                                                                                                                                                        |
+| `recordUndeliverableReply()` | (`mailKey`) => `boolean`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Prevent replay after a system undeliverable reply is admitted. Make a successfully admitted system disposition replay-ineligible.                                                                                                                                                                                                                                                                                                                                                                  |
+| `receipt()`                  | (`requestId`) => \| `Readonly`\<\{ `status`: `"accepted"`; `commandId`: `string`; `sessionId?`: `string`; \}\> \| `undefined`                                                                                                                                                                                                                                                                                                                                                                                | Read an existing acceptance receipt without reserving or delivering mail. Read only the existing acceptance receipt; do not reserve or deliver mail.                                                                                                                                                                                                                                                                                                                                               |
+| `recordAcceptedNotice()`     | (`mail`) => \| `Readonly`\<\{ `status`: `"accepted"`; `commandId`: `string`; `sessionId?`: `string`; \}\> \| `undefined`                                                                                                                                                                                                                                                                                                                                                                                     | Consume a recipient's stable `<mailKey>:accepted` notice. Atomically bind the recipient Session carried by a late acceptance notice.                                                                                                                                                                                                                                                                                                                                                               |
+| `outstanding()`              | () => `Promise`\< \| `Readonly`\<\{ `agentId`: `string`; `sessionId`: `string`; `commandId`: `string`; `unreadable?`: `string`; \}\> \| `undefined`\>                                                                                                                                                                                                                                                                                                                                                        | The delegated work this owner still waits on, if any. The newest delegation this owner sent whose work has not settled at its target, so the owner is still waiting for a reply; undefined when none.                                                                                                                                                                                                                                                                                              |
+| `delegate()`                 | (`grant`, `task`) => `Promise`\< \| `Readonly`\<\{ `kind`: `"pending"`; `retryAfterMs`: `number`; \}\> \| [`AgentDelegationOutcome`](#agentdelegationoutcome)\>                                                                                                                                                                                                                                                                                                                                              | Submit or poll the exact turn, yielding Agar Pending until settled.                                                                                                                                                                                                                                                                                                                                                                                                                                |
 
 ---
 
@@ -752,10 +865,10 @@ checks a fresh supplied grant and releases its transport without stopping work.
 
 #### Returns
 
-| Name       | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Description                                                              |
-| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
-| `list()`   | (`grant`, `agentId`, `after?`) => `Promise`\<`Readonly`\<\{ `sessions`: readonly [`SessionSummaryRow`](client.md#sessionsummaryrow)[]; `next`: `string` \| `undefined`; \}\>\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Enumerate existing Sessions through the owner's bounded cursor.          |
-| `read()`   | (`grant`, `agentId`, `sessionId`) => `Promise`\<`Readonly`\<\{ `sessionId`: `string`; `cursor`: `string` \| `null`; `hasMore`: `boolean`; `oldestCursor?`: `string` \| `null`; `messages`: readonly `Readonly`\<\{ `requestId?`: `string`; `meta?`: [`Json`](extensions.md#json); `data?`: [`Json`](extensions.md#json); `origin?`: `Readonly`\<\{ `extensionId`: ...; `correlation`: ...; \}\>; `id`: `string`; `sequence`: `number`; `commandId`: `string` \| `null`; `value`: [`ModelMessage`](client.md#modelmessage); \}\>[]; `terminals`: readonly `Readonly`\<\{ `commandId`: `string`; `outcome`: `"completed"` \| `"failed"` \| `"cancelled"` \| `"interrupted"`; `sequence`: `number`; `diagnostic`: `string` \| `null`; `meta?`: [`Json`](extensions.md#json); \}\>[]; `compactions?`: readonly `Readonly`\<\{ `id`: `string`; `sequence`: `number`; `at`: `number`; `tokensBefore`: `number`; `tokensAfter`: `number` \| `null`; `trigger`: [`SessionCompactionTrigger`](client.md#sessioncompactiontrigger) \| `null`; \}\>[]; `compactionNotices?`: readonly `Readonly`\<\{ `id`: `string`; `sequence`: `number`; `at`: `number`; `trigger`: [`SessionCompactionTrigger`](client.md#sessioncompactiontrigger); `result`: `"failed"` \| `"nothing_to_compact"` \| `"stale"` \| `"insufficient"`; `diagnostic`: `string` \| `null`; \}\>[]; `sandboxFailures?`: readonly `object`[]; `pending`: [`SessionPendingPrompts`](client.md#sessionpendingprompts); `activity`: [`SessionActivity`](client.md#sessionactivity); `progress`: \| `Readonly`\<\{ `messageId`: `string`; `revision`: `number`; `text`: `string`; `thinking`: `string`; `textTruncated`: `boolean`; `thinkingTruncated`: `boolean`; \}\> \| `null`; `toolOutput`: readonly `Readonly`\<\{ `toolCallId`: `string`; `revision`: `number`; `tail`: `string`; `droppedBytes`: `number`; `totalBytes`: `number`; \}\>[]; `extensions`: [`SessionExtensionSlots`](client.md#sessionextensionslots); `attention`: readonly `object`[]; `context?`: `Readonly`\<\{ `tokens`: `number`; `window`: `number` \| `null`; \}\>; \}\>\> | Open the exact saved conversation without creating work.                 |
-| `create()` | (`grant`, `agentId`, `requestId`) => `Promise`\<`string`\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Create a Session once under the caller's replay identity.                |
-| `remove()` | (`grant`, `agentId`, `sessionId`) => `Promise`\<`boolean`\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Remove a Session through its runtime owner.                              |
-| `send()`   | (`grant`, `agentId`, `sessionId`, `message`) => `Promise`\<\{ `status`: `"accepted"`; `commandId`: `string`; `sessionId`: `string`; \}\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Send once; an omitted Session is created under the same replay identity. |
+| Name       | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Description                                                              |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
+| `list()`   | (`grant`, `agentId`, `after?`) => `Promise`\<`Readonly`\<\{ `sessions`: readonly [`SessionSummaryRow`](client.md#sessionsummaryrow)[]; `next`: `string` \| `undefined`; \}\>\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Enumerate existing Sessions through the owner's bounded cursor.          |
+| `read()`   | (`grant`, `agentId`, `sessionId`) => `Promise`\<`Readonly`\<\{ `sessionId`: `string`; `cursor`: `string` \| `null`; `hasMore`: `boolean`; `oldestCursor?`: `string` \| `null`; `messages`: readonly `Readonly`\<\{ `requestId?`: `string`; `meta?`: [`Json`](extensions.md#json); `data?`: [`Json`](extensions.md#json); `origin?`: `Readonly`\<\{ `extensionId`: ...; `correlation`: ...; \}\>; `id`: `string`; `sequence`: `number`; `commandId`: `string` \| `null`; `value`: [`ModelMessage`](client.md#modelmessage); \}\>[]; `terminals`: readonly `Readonly`\<\{ `commandId`: `string`; `outcome`: `"completed"` \| `"failed"` \| `"cancelled"` \| `"interrupted"`; `sequence`: `number`; `diagnostic`: `string` \| `null`; `meta?`: [`Json`](extensions.md#json); \}\>[]; `compactions?`: readonly `Readonly`\<\{ `id`: `string`; `sequence`: `number`; `at`: `number`; `tokensBefore`: `number`; `tokensAfter`: `number` \| `null`; `trigger`: [`SessionCompactionTrigger`](client.md#sessioncompactiontrigger) \| `null`; \}\>[]; `compactionNotices?`: readonly `Readonly`\<\{ `id`: `string`; `sequence`: `number`; `at`: `number`; `trigger`: [`SessionCompactionTrigger`](client.md#sessioncompactiontrigger); `result`: `"failed"` \| `"nothing_to_compact"` \| `"stale"` \| `"insufficient"`; `diagnostic`: `string` \| `null`; \}\>[]; `sandboxFailures?`: readonly `object`[]; `pending`: [`SessionPendingPrompts`](client.md#sessionpendingprompts); `activity`: [`SessionActivity`](client.md#sessionactivity); `progress`: \| `Readonly`\<\{ `messageId`: `string`; `revision`: `number`; `text`: `string`; `thinking`: `string`; `textOffset`: `number`; `thinkingOffset`: `number`; `textTruncated`: `boolean`; `thinkingTruncated`: `boolean`; \}\> \| `null`; `toolOutput`: readonly `Readonly`\<\{ `toolCallId`: `string`; `revision`: `number`; `tail`: `string`; `droppedBytes`: `number`; `totalBytes`: `number`; \}\>[]; `extensions`: [`SessionExtensionSlots`](client.md#sessionextensionslots); `attention`: readonly `object`[]; `context?`: `Readonly`\<\{ `tokens`: `number`; `window`: `number` \| `null`; \}\>; \}\>\> | Open the exact saved conversation without creating work.                 |
+| `create()` | (`grant`, `agentId`, `requestId`) => `Promise`\<`string`\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Create a Session once under the caller's replay identity.                |
+| `remove()` | (`grant`, `agentId`, `sessionId`) => `Promise`\<`boolean`\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Remove a Session through its runtime owner.                              |
+| `send()`   | (`grant`, `agentId`, `sessionId`, `message`) => `Promise`\<\{ `status`: `"accepted"`; `commandId`: `string`; `sessionId`: `string`; \}\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Send once; an omitted Session is created under the same replay identity. |

package/docs/api/http.md

@@ -64,6 +64,34 @@ it.
 
 ## Functions
 
+### toShiitakeErrorWire()
+
+```ts
+function toShiitakeErrorWire(cause): object;
+```
+
+Sanitize one caught host failure for Shiitake's public wire.
+
+#### Parameters
+
+| Parameter | Type      |
+| --------- | --------- |
+| `cause`   | `unknown` |
+
+#### Returns
+
+`object`
+
+| Name         | Type                                                                                                                                                                    | Default value                 |
+| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
+| `_tag`       | `"ShiitakeError"`                                                                                                                                                       | -                             |
+| `boundary`   | \| `"contract"` \| `"extensions"` \| `"instructions"` \| `"model"` \| `"runtime"` \| `"store"` \| `"tools"`                                                             | `ShiitakeErrorBoundarySchema` |
+| `cause`      | \| `"closed"` \| `"conflict"` \| `"incompatible"` \| `"invalid"` \| `"rejected"` \| `"unavailable"` \| `"state_reset_required"` \| `"storage_pressure"` \| `"archived"` | `ShiitakeErrorCauseSchema`    |
+| `message`    | `string`                                                                                                                                                                | `Schema.String`               |
+| `requestId?` | `string`                                                                                                                                                                | -                             |
+
+---
+
 ### createShiitakeHttpRoutes()
 
 ```ts

package/docs/api/index.md

@@ -36,13 +36,13 @@ Construct a sanitized boundary failure.
 
 ###### Parameters
 
-| Parameter    | Type                                                                                                                                                    | Description                                                                                                                        |
-| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-| `boundary`   | \| `"contract"` \| `"extensions"` \| `"instructions"` \| `"model"` \| `"runtime"` \| `"store"` \| `"tools"`                                             | Boundary that rejected the operation.                                                                                              |
-| `category`   | \| `"closed"` \| `"conflict"` \| `"incompatible"` \| `"invalid"` \| `"rejected"` \| `"unavailable"` \| `"state_reset_required"` \| `"storage_pressure"` | Safe category describing why it was rejected.                                                                                      |
-| `message`    | `string`                                                                                                                                                | Human-readable message safe for callers to display.                                                                                |
-| `requestId?` | `string`                                                                                                                                                | Request identity recoverable when a send may have reached the owner.                                                               |
-| `cause?`     | `unknown`                                                                                                                                               | The original thrown value, kept for server-side diagnosis only. It is never serialized: the wire encoder copies named fields only. |
+| Parameter    | Type                                                                                                                                                                    | Description                                                                                                                        |
+| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `boundary`   | \| `"contract"` \| `"extensions"` \| `"instructions"` \| `"model"` \| `"runtime"` \| `"store"` \| `"tools"`                                                             | Boundary that rejected the operation.                                                                                              |
+| `category`   | \| `"closed"` \| `"conflict"` \| `"incompatible"` \| `"invalid"` \| `"rejected"` \| `"unavailable"` \| `"state_reset_required"` \| `"storage_pressure"` \| `"archived"` | Safe category describing why it was rejected.                                                                                      |
+| `message`    | `string`                                                                                                                                                                | Human-readable message safe for callers to display.                                                                                |
+| `requestId?` | `string`                                                                                                                                                                | Request identity recoverable when a send may have reached the owner.                                                               |
+| `cause?`     | `unknown`                                                                                                                                                               | The original thrown value, kept for server-side diagnosis only. It is never serialized: the wire encoder copies named fields only. |
 
 ###### Returns
 
@@ -75,7 +75,8 @@ readonly cause:
   | "rejected"
   | "unavailable"
   | "state_reset_required"
-  | "storage_pressure";
+  | "storage_pressure"
+  | "archived";
 ```
 
 Safe category describing why it was rejected.
@@ -224,7 +225,7 @@ type ShiitakeHost = Readonly<{
     commandId,
   ) => Promise<CommandSettlement | undefined>;
   agent: ShiitakeOwnerAgent;
-  acceptMail: (mail, meta?, reply?) => Promise<Accepted>;
+  acceptMail: (mail, meta?, reply?, stageAcceptedNotice?) => Promise<Accepted>;
 }>;
 ```
 
@@ -415,6 +416,7 @@ type ModelAcquisition = Readonly<{
   retryable: (message) => boolean;
   retryAfterMs?: (message) => number | undefined;
   failureReason?: (message) => string | undefined;
+  rejection?: (message) => ProviderRejection | undefined;
   providerError?: (message) => string | undefined;
   release: () => Promise<void>;
 }>;
@@ -576,6 +578,9 @@ type ShiitakeOptions = Readonly<{
   meta?: HostMetaOptions;
   store: SqliteOwner;
   storagePressure?: StoragePressureCheck;
+  admission?: Readonly<{
+    assertOpen: () => void;
+  }>;
   compaction?: CompactionOptions;
   runtime: RuntimeHost;
   model: ModelSource;
@@ -634,10 +639,16 @@ can.
 ```ts
 type CommandSettlement = Readonly<{
   acceptedSender: string | null;
+  delegator: string | null;
   terminal: SessionTerminal;
   content: string;
   usage: readonly Pick<AssistantMessage, "provider" | "model" | "usage">[];
   toolCalls: number;
+  waitingOnYou: readonly Readonly<{
+    itemId: string;
+    kind: string;
+    summary: string;
+  }>[];
 }>;
 ```
 
@@ -925,16 +936,23 @@ function makeHost(options, mailRoom): Promise<Readonly<{
   readSettlement: (sessionId, commandId) => Promise<
      | Readonly<{
      acceptedSender: string | null;
+     delegator: string | null;
      terminal: SessionTerminal;
      content: string;
      usage: readonly Pick<AssistantMessage, ... | ... | ...>[];
      toolCalls: number;
+     waitingOnYou: readonly Readonly<{
+        itemId: ...;
+        kind: ...;
+        summary: ...;
+     }>[];
    }>
     | undefined>;
   agent: ShiitakeOwnerAgent;
-  acceptMail: (mail, meta?, reply?) => Promise<Readonly<{
+  acceptMail: (mail, meta?, reply?, stageAcceptedNotice?) => Promise<Readonly<{
      status: "accepted";
      commandId: string;
+     sessionId?: string;
   }>>;
 }>>;
 ```
@@ -951,13 +969,15 @@ Construct the host-only Promise facade over the canonical Effect program.
 #### Returns
 
 `Promise`\<`Readonly`\<\{ `readSettlement`: (`sessionId`, `commandId`) =>
-`Promise`\< \| `Readonly`\<\{ `acceptedSender`: `string` \| `null`; `terminal`:
-[`SessionTerminal`](client.md#sessionterminal); `content`: `string`; `usage`:
-readonly `Pick`\<`AssistantMessage`, ... \| ... \| ...\>[]; `toolCalls`:
-`number`; \}\> \| `undefined`\>; `agent`:
-[`ShiitakeOwnerAgent`](#shiitakeowneragent); `acceptMail`: (`mail`, `meta?`,
-`reply?`) => `Promise`\<`Readonly`\<\{ `status`: `"accepted"`; `commandId`:
-`string`; \}\>\>; \}\>\>
+`Promise`\< \| `Readonly`\<\{ `acceptedSender`: `string` \| `null`; `delegator`:
+`string` \| `null`; `terminal`: [`SessionTerminal`](client.md#sessionterminal);
+`content`: `string`; `usage`: readonly `Pick`\<`AssistantMessage`, ... \| ... \|
+...\>[]; `toolCalls`: `number`; `waitingOnYou`: readonly `Readonly`\<\{
+`itemId`: ...; `kind`: ...; `summary`: ...; \}\>[]; \}\> \| `undefined`\>;
+`agent`: [`ShiitakeOwnerAgent`](#shiitakeowneragent); `acceptMail`: (`mail`,
+`meta?`, `reply?`, `stageAcceptedNotice?`) => `Promise`\<`Readonly`\<\{
+`status`: `"accepted"`; `commandId`: `string`; `sessionId?`: `string`; \}\>\>;
+\}\>\>
 
 ## References
 
@@ -1045,6 +1065,12 @@ Re-exports [SessionProgress](client.md#sessionprogress)
 
 ---
 
+### SessionProgressDelta
+
+Re-exports [SessionProgressDelta](client.md#sessionprogressdelta)
+
+---
+
 ### SessionToolOutput
 
 Re-exports [SessionToolOutput](client.md#sessiontooloutput)

package/docs/api/testing.md

@@ -200,6 +200,8 @@ function memoryHost(options?): Promise<Readonly<{
         revision: number;
         text: string;
         thinking: string;
+        textOffset: number;
+        thinkingOffset: number;
         textTruncated: boolean;
         thinkingTruncated: boolean;
       }>
@@ -253,10 +255,10 @@ privileges. No submitted JavaScript is evaluated by this helper.
 [`SessionPendingPrompts`](client.md#sessionpendingprompts); `activity`:
 [`SessionActivity`](client.md#sessionactivity); `progress`: \| `Readonly`\<\{
 `messageId`: `string`; `revision`: `number`; `text`: `string`; `thinking`:
-`string`; `textTruncated`: `boolean`; `thinkingTruncated`: `boolean`; \}\> \|
-`null`; `toolOutput`: readonly `Readonly`\<\{ `toolCallId`: `string`;
-`revision`: `number`; `tail`: `string`; `droppedBytes`: `number`; `totalBytes`:
-`number`; \}\>[]; `extensions`:
-[`SessionExtensionSlots`](client.md#sessionextensionslots); `attention`:
-readonly `object`[]; `context?`: `Readonly`\<\{ `tokens`: `number`; `window`:
-... \| ...; \}\>; \}\>\>; `close`: () => `Promise`\<`void`\>; \}\>\>
+`string`; `textOffset`: `number`; `thinkingOffset`: `number`; `textTruncated`:
+`boolean`; `thinkingTruncated`: `boolean`; \}\> \| `null`; `toolOutput`:
+readonly `Readonly`\<\{ `toolCallId`: `string`; `revision`: `number`; `tail`:
+`string`; `droppedBytes`: `number`; `totalBytes`: `number`; \}\>[];
+`extensions`: [`SessionExtensionSlots`](client.md#sessionextensionslots);
+`attention`: readonly `object`[]; `context?`: `Readonly`\<\{ `tokens`: `number`;
+`window`: ... \| ...; \}\>; \}\>\>; `close`: () => `Promise`\<`void`\>; \}\>\>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/shiitake",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "author": "Levi <levi@technomancy.dev>",
   "description": "Effect-native durable Session acceptance and bounded run orchestration",
   "type": "module",
@@ -19,6 +19,10 @@
       "types": "./dist/client.d.ts",
       "import": "./dist/client.js"
     },
+    "./server-visitor-stream": {
+      "types": "./dist/server-visitor-stream.d.ts",
+      "import": "./dist/server-visitor-stream.js"
+    },
     "./agent-control": {
       "types": "./dist/agent-control.d.ts",
       "import": "./dist/agent-control.js"
@@ -82,19 +86,19 @@
     "node": ">=22.13"
   },
   "dependencies": {
-    "@fungi.computer/bird-dog": "0.2.1",
+    "@fungi.computer/bird-dog": "0.3.1",
     "@fungi.computer/cairn": "0.1.0",
     "@fungi.computer/carrier": "0.2.0",
-    "@fungi.computer/knapsack": "0.3.1",
-    "@fungi.computer/mule": "0.2.0",
-    "@fungi.computer/mycelium": "0.2.2",
+    "@fungi.computer/knapsack": "0.4.1",
+    "@fungi.computer/mule": "0.2.1",
+    "@fungi.computer/mycelium": "0.3.0",
     "@fungi.computer/seam": "0.2.0",
     "@fungi.computer/watchdog": "0.1.0",
     "effect": "4.0.2",
     "zod": "4.4.3",
     "@earendil-works/pi-ai": "1.3.0",
     "@fungi.computer/gills": "0.2.0",
-    "@fungi.computer/agar": "0.4.0"
+    "@fungi.computer/agar": "0.6.0"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "5.20260828.1",