@fungi.computer/shiitake 0.6.0 → 0.7.0

package/dist/server-visitor-stream.js

@@ -54,26 +54,17 @@ export function visitorStream(options) {
                 });
             }, 30_000);
     };
-    const publish = async (snapshot, progressOnly) => {
+    const publish = async (snapshot) => {
         if (!(await admitted()))
             return false;
         const baseline = visitorSnapshot(options.filter(snapshot), options.visitorId);
-        await stream.writeSSE(progressOnly
-            ? {
-                event: "frame",
-                data: JSON.stringify({
-                    kind: "progress",
-                    progress: baseline.progress,
-                    activity: baseline.activity,
-                }),
-            }
-            : { event: "session", data: JSON.stringify(baseline) });
+        await stream.writeSSE({ event: "session", data: JSON.stringify(baseline) });
         return !ending;
     };
     const pump = async () => {
         try {
             let snapshot = options.watch.snapshot;
-            if (!(await publish(snapshot, false)))
+            if (!(await publish(snapshot)))
                 return;
             heartbeat = setTimeout(() => {
                 void beat().catch((cause) => {
@@ -88,19 +79,37 @@ export function visitorStream(options) {
                     break;
                 if (frame.kind === "tool_output")
                     continue;
+                if (frame.kind === "progress" || frame.kind === "activity") {
+                    if (!(await admitted()))
+                        break;
+                    snapshot = { ...snapshot, activity: frame.activity };
+                    const baseline = visitorSnapshot(options.filter(snapshot), options.visitorId);
+                    if (baseline.activity.queue.state === "idle") {
+                        if (frame.kind === "activity")
+                            await stream.writeSSE({
+                                event: "session",
+                                data: JSON.stringify(baseline),
+                            });
+                        continue;
+                    }
+                    await stream.writeSSE({
+                        event: "frame",
+                        data: JSON.stringify(frame.kind === "activity"
+                            ? { kind: "activity", activity: baseline.activity }
+                            : {
+                                ...frame,
+                                progress: {
+                                    ...frame.progress,
+                                    thinking: { offset: 0, append: "" },
+                                },
+                                activity: baseline.activity,
+                            }),
+                    });
+                    continue;
+                }
                 snapshot =
-                    frame.kind === "progress"
-                        ? {
-                            ...snapshot,
-                            progress: frame.progress,
-                            activity: frame.activity,
-                        }
-                        : frame.kind === "activity"
-                            ? { ...snapshot, activity: frame.activity }
-                            : frame.kind === "reset"
-                                ? frame.baseline
-                                : await options.read();
-                if (!(await publish(snapshot, frame.kind === "progress")))
+                    frame.kind === "reset" ? frame.baseline : await options.read();
+                if (!(await publish(snapshot)))
                     break;
             }
         }

package/docs/api/agent-control.md

@@ -31,7 +31,7 @@ new AgentArchiveRefused(reason, message): AgentArchiveRefused;
 
 | Parameter | Type                                                                                           |
 | --------- | ---------------------------------------------------------------------------------------------- |
-| `reason`  | \| `"running"` \| `"pending"` \| `"archived"` \| `"not_creator"` \| `"self"` \| `"unreadable"` |
+| `reason`  | \| `"archived"` \| `"running"` \| `"pending"` \| `"not_creator"` \| `"self"` \| `"unreadable"` |
 | `message` | `string`                                                                                       |
 
 ###### Returns
@@ -62,9 +62,9 @@ Error.name;
 
 ```ts
 readonly reason:
+  | "archived"
   | "running"
   | "pending"
-  | "archived"
   | "not_creator"
   | "self"
   | "unreadable";
@@ -235,6 +235,7 @@ type AgentDelegationInput = Readonly<{
   | Readonly<{
   sessionId?: string;
   delivery: "followUp";
+  goal?: string | false;
 }>;
 ```
 

package/docs/api/client.md

@@ -41,6 +41,16 @@ What a visitor may see of their own conversation Session.
 
 ---
 
+### VisitorLine
+
+```ts
+type VisitorLine = VisitorView["lines"][number];
+```
+
+One visitor-visible line without internal attribution or tool metadata.
+
+---
+
 ### VisitorPendingPrompt
 
 ```ts
@@ -404,6 +414,7 @@ type AgentRunningWork =
       kind: "session";
       sessionId: string;
       commandId: string;
+      title: string;
     }>
   | Readonly<{
       kind: "host";
@@ -412,8 +423,8 @@ type AgentRunningWork =
     }>;
 ```
 
-Work occupying the executor partition that this queued command requires, without
-message or provider data.
+Blocking executor identity and Session display metadata, never messages or
+provider data.
 
 ---
 
@@ -469,7 +480,7 @@ Encoded extension slots keyed by extension identity; absent means unavailable.
 
 ```ts
 type SessionExtensionControls = Readonly<{
-  call: (command, input) => Promise<Json>;
+  call: (command, input, caller?) => Promise<Json>;
 }>;
 ```
 
@@ -515,6 +526,8 @@ type SessionProgress = Readonly<{
   revision: number;
   text: string;
   thinking: string;
+  textOffset: number;
+  thinkingOffset: number;
   textTruncated: boolean;
   thinkingTruncated: boolean;
 }>;
@@ -524,6 +537,27 @@ Process-local assistant progress; never a durable Session fact.
 
 ---
 
+### SessionProgressDelta
+
+```ts
+type SessionProgressDelta = Readonly<{
+  messageId: string;
+  revision: number;
+  text: Readonly<{
+    offset: number;
+    append: string;
+  }>;
+  thinking: Readonly<{
+    offset: number;
+    append: string;
+  }>;
+}>;
+```
+
+Append-only progress on the wire. Offsets count JavaScript string units.
+
+---
+
 ### SessionPendingPrompt
 
 ```ts
@@ -679,7 +713,7 @@ type SessionFrame =
     }>
   | Readonly<{
       kind: "progress";
-      progress: SessionProgress;
+      progress: SessionProgressDelta;
       activity: SessionActivity;
     }>
   | Readonly<{
@@ -1102,10 +1136,10 @@ operator replies.
 
 #### Parameters
 
-| Parameter   | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `snapshot`  | \| `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`: `string`; `correlation`: `string` \| `null`; \}\>; `id`: `string`; `sequence`: `number`; `commandId`: `string` \| `null`; `value`: [`ModelMessage`](#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`](#sessioncompactiontrigger) \| `null`; \}\>[]; `compactionNotices?`: readonly `Readonly`\<\{ `id`: `string`; `sequence`: `number`; `at`: `number`; `trigger`: [`SessionCompactionTrigger`](#sessioncompactiontrigger); `result`: `"failed"` \| `"nothing_to_compact"` \| `"stale"` \| `"insufficient"`; `diagnostic`: `string` \| `null`; \}\>[]; `sandboxFailures?`: readonly `object`[]; `pending`: [`SessionPendingPrompts`](#sessionpendingprompts); `activity`: [`SessionActivity`](#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`](#sessionextensionslots); `attention`: readonly `object`[]; `context?`: `Readonly`\<\{ `tokens`: `number`; `window`: `number` \| `null`; \}\>; \}\> \| `null` |
-| `visitorId` | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| Parameter   | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `snapshot`  | \| `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`: `string`; `correlation`: `string` \| `null`; \}\>; `id`: `string`; `sequence`: `number`; `commandId`: `string` \| `null`; `value`: [`ModelMessage`](#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`](#sessioncompactiontrigger) \| `null`; \}\>[]; `compactionNotices?`: readonly `Readonly`\<\{ `id`: `string`; `sequence`: `number`; `at`: `number`; `trigger`: [`SessionCompactionTrigger`](#sessioncompactiontrigger); `result`: `"failed"` \| `"nothing_to_compact"` \| `"stale"` \| `"insufficient"`; `diagnostic`: `string` \| `null`; \}\>[]; `sandboxFailures?`: readonly `object`[]; `pending`: [`SessionPendingPrompts`](#sessionpendingprompts); `activity`: [`SessionActivity`](#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`](#sessionextensionslots); `attention`: readonly `object`[]; `context?`: `Readonly`\<\{ `tokens`: `number`; `window`: `number` \| `null`; \}\>; \}\> \| `null` |
+| `visitorId` | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 
 #### Returns
 
@@ -1268,6 +1302,41 @@ Decode the existing bounded saved-conversation projection.
 
 ---
 
+### appendSessionProgress()
+
+```ts
+function appendSessionProgress(
+  current,
+  delta,
+): Readonly<{
+  messageId: string;
+  revision: number;
+  text: string;
+  thinking: string;
+  textOffset: number;
+  thinkingOffset: number;
+  textTruncated: boolean;
+  thinkingTruncated: boolean;
+}> | null;
+```
+
+Fold a decoded append once; a missing prefix waits for an owner reset.
+
+#### Parameters
+
+| Parameter | Type                                                                                                                                                                                                                                  |
+| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `current` | \| `Readonly`\<\{ `messageId`: `string`; `revision`: `number`; `text`: `string`; `thinking`: `string`; `textOffset`: `number`; `thinkingOffset`: `number`; `textTruncated`: `boolean`; `thinkingTruncated`: `boolean`; \}\> \| `null` |
+| `delta`   | [`SessionProgressDelta`](#sessionprogressdelta)                                                                                                                                                                                       |
+
+#### Returns
+
+\| `Readonly`\<\{ `messageId`: `string`; `revision`: `number`; `text`: `string`;
+`thinking`: `string`; `textOffset`: `number`; `thinkingOffset`: `number`;
+`textTruncated`: `boolean`; `thinkingTruncated`: `boolean`; \}\> \| `null`
+
+---
+
 ### bindSessionExtension()
 
 ```ts

package/docs/api/cloudflare.md

@@ -405,6 +405,9 @@ type CloudflareShiitakeOptions = Readonly<{
   instructions: InstructionSource;
   tools?: readonly [] | CloudflareShiitakeTools;
   storagePressure?: StoragePressureCheck;
+  admission?: Readonly<{
+    assertOpen: () => void;
+  }>;
   compaction?: CompactionOptions;
   extensions: ExtensionRosterV0;
   initialize?: (agent) => Promise<void>;
@@ -424,6 +427,19 @@ Cloudflare host inputs; the model owner resolves one frozen run selection.
 ```ts
 type CloudflareShiitake = ShiitakeOwnerAgent &
   Readonly<{
+    busySync: () =>
+      | Readonly<{
+          kind: "session";
+          sessionId: string;
+          commandId: string;
+        }>
+      | Readonly<{
+          kind: "delegation";
+          agentId: string;
+          sessionId: string;
+          commandId: string;
+        }>
+      | undefined;
     readSettlement: (
       sessionId,
       commandId,

package/docs/api/delegation.md

@@ -34,6 +34,26 @@ new AgentDelegation(deps): AgentDelegation;
 
 #### Methods
 
+##### refreshOutstanding()
+
+```ts
+refreshOutstanding(readSettlement): Promise<void>;
+```
+
+Best-effort remote refresh before an owner-local archive transaction. Confirmed
+settlements are recorded by Shiitake; unreadable targets leave their local
+accepted receipt outstanding for busySync to refuse.
+
+###### Parameters
+
+| Parameter        | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `readSettlement` | (`agentId`, `sessionId`, `commandId`) => `Promise`\< \| `Readonly`\<\{ `acceptedSender`: `string` \| `null`; `delegator`: `string` \| `null`; `terminal`: [`SessionTerminal`](client.md#sessionterminal); `content`: `string`; `usage`: readonly `Pick`\<`AssistantMessage`, `"model"` \| `"provider"` \| `"usage"`\>[]; `toolCalls`: `number`; `waitingOnYou`: readonly `Readonly`\<\{ `itemId`: `string`; `kind`: `string`; `summary`: `string`; \}\>[]; \}\> \| `undefined`\> |
+
+###### Returns
+
+`Promise`\<`void`\>
+
 ##### settlement()
 
 ```ts
@@ -45,10 +65,16 @@ settlement(
 ): Promise<
   | Readonly<{
   acceptedSender: string | null;
+  delegator: string | null;
   terminal: SessionTerminal;
   content: string;
   usage: readonly Pick<AssistantMessage, "model" | "provider" | "usage">[];
   toolCalls: number;
+  waitingOnYou: readonly Readonly<{
+     itemId: string;
+     kind: string;
+     summary: string;
+  }>[];
 }>
 | undefined>;
 ```
@@ -66,10 +92,12 @@ Recipient-local disclosure through the public host, never another Agent's RPC.
 
 ###### Returns
 
-`Promise`\< \| `Readonly`\<\{ `acceptedSender`: `string` \| `null`; `terminal`:
-[`SessionTerminal`](client.md#sessionterminal); `content`: `string`; `usage`:
-readonly `Pick`\<`AssistantMessage`, `"model"` \| `"provider"` \| `"usage"`\>[];
-`toolCalls`: `number`; \}\> \| `undefined`\>
+`Promise`\< \| `Readonly`\<\{ `acceptedSender`: `string` \| `null`; `delegator`:
+`string` \| `null`; `terminal`: [`SessionTerminal`](client.md#sessionterminal);
+`content`: `string`; `usage`: readonly `Pick`\<`AssistantMessage`, `"model"` \|
+`"provider"` \| `"usage"`\>[]; `toolCalls`: `number`; `waitingOnYou`: readonly
+`Readonly`\<\{ `itemId`: `string`; `kind`: `string`; `summary`: `string`;
+\}\>[]; \}\> \| `undefined`\>
 
 ##### send()
 
@@ -82,8 +110,8 @@ send(
 ): Promise<DelegationReceipt>;
 ```
 
-Delegate work to an in-scope Agent: steer its Session, or start fleet
-correspondence.
+Delegate work to an in-scope Agent through fleet correspondence; a steer rides
+the mail.
 
 ###### Parameters
 
@@ -366,6 +394,7 @@ function agentMailRoute(namespace, replySettlement): PostRoute<AgentMailAddress,
      commandId: string;
      outcome: "completed" | "failed" | "cancelled" | "interrupted" | "outcome_unknown";
      diagnostic?: string;
+     waitingOnYou?: readonly object[];
    }
      | {
      outcome: "accepted";
@@ -416,6 +445,7 @@ function agentMailRoute(namespace, replySettlement): PostRoute<AgentMailAddress,
      commandId: string;
      outcome: "completed" | "failed" | "cancelled" | "interrupted" | "outcome_unknown";
      diagnostic?: string;
+     waitingOnYou?: readonly object[];
    }
      | {
      outcome: "accepted";
@@ -466,6 +496,7 @@ function agentMailRoute(namespace, replySettlement): PostRoute<AgentMailAddress,
      commandId: string;
      outcome: "completed" | "failed" | "cancelled" | "interrupted" | "outcome_unknown";
      diagnostic?: string;
+     waitingOnYou?: readonly object[];
    }
      | {
      outcome: "accepted";
@@ -516,6 +547,7 @@ function agentMailRoute(namespace, replySettlement): PostRoute<AgentMailAddress,
      commandId: string;
      outcome: "completed" | "failed" | "cancelled" | "interrupted" | "outcome_unknown";
      diagnostic?: string;
+     waitingOnYou?: readonly object[];
    }
      | {
      outcome: "accepted";
@@ -595,7 +627,33 @@ retries.
 `PostRoute`\<`AgentMailAddress`, \| \{ `from`: \{ `kind`: `"agent"`; `agentId`:
 `string`; `sessionId`: `string`; \}; `reply?`: \| \{ `commandId`: `string`;
 `outcome`: `"completed"` \| `"failed"` \| `"cancelled"` \| `"interrupted"` \|
-`"outcome_unknown"`; `diagnostic?`: `string`; \} \| \{ `outcome`: `"accepted"`;
+`"outcome_unknown"`; `diagnostic?`: `string`; `waitingOnYou?`: readonly
+`object`[]; \} \| \{ `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`; `waitingOnYou?`: readonly `object`[]; \} \| \{ `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`;
+`waitingOnYou?`: readonly `object`[]; \} \| \{ `outcome`: `"accepted"`;
 `commandId`: `string`; \} \| \{ `outcome`: `"undeliverable"`; `reason`:
 `"recipient_left"`; \}; `key`: `string`; `to`: \{ `kind`: `"agent"`; `agentId`:
 `string`; `sessionId?`: `string`; \}; `replyTo`: readonly `object`[]; `content`:
@@ -607,50 +665,26 @@ retries.
 `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`; \};
+`"outcome_unknown"`; `diagnostic?`: `string`; `waitingOnYou?`: readonly
+`object`[]; \} \| \{ `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; \}, `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; \}\> & `Omit`\<`Readonly`\<\{
-`addressKind`: `string`; `deadlineMs?`: `number`; `address`: `Codec`\<`unknown`,
-`unknown`\>; `event`: `Codec`\<`unknown`, `unknown`\>; `encodeEnvelope`:
-(`envelope`) => `object`; `parseDelivery`: (`envelope`) => `object`;
-`prepareEnvelope?`: (`envelope`, `signal`) => `Promise`\<\{ `key`: `string`;
-`kind`: `string`; `address`: `unknown`; `event`: `unknown`; \}\>;
-`recordDelivered?`: (`envelope`) => `void`; `nameOf`: (`envelope`) => `string`;
-`namespace`: `Readonly`\<\{ `getByName`: (`name`) => `Readonly`\<\{ `deliver`:
-(`envelope`) => `Promise`\<...\>; \}\>; \}\>; `recordCursor?`: (`envelope`,
-`cursor`) => `void`; `recordRefused?`: (`envelope`) => `void`; \}\>, `"event"`
-\| `"address"`\>
+`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`;
+`address`: `Codec`\<`unknown`, `unknown`\>; `event`: `Codec`\<`unknown`,
+`unknown`\>; `encodeEnvelope`: (`envelope`) => `object`; `parseDelivery`:
+(`envelope`) => `object`; `prepareEnvelope?`: (`envelope`, `signal`) =>
+`Promise`\<\{ `key`: `string`; `kind`: `string`; `address`: `unknown`; `event`:
+`unknown`; \}\>; `recordDelivered?`: (`envelope`) => `void`; `nameOf`:
+(`envelope`) => `string`; `namespace`: `Readonly`\<\{ `getByName`: (`name`) =>
+`Readonly`\<\{ `deliver`: (`envelope`) => `Promise`\<...\>; \}\>; \}\>;
+`recordCursor?`: (`envelope`, `cursor`) => `void`; `recordRefused?`:
+(`envelope`) => `void`; \}\>, `"event"` \| `"address"`\>
 
 ---
 

package/docs/api/effect.md

@@ -120,6 +120,9 @@ type ShiitakeEffectOptions = Readonly<{
   meta?: HostMetaOptions;
   store: SqliteOwner;
   storagePressure?: StoragePressureCheck;
+  admission?: Readonly<{
+    assertOpen: () => void;
+  }>;
   compaction?: CompactionOptions;
   hostJobs?: Readonly<{
     lane: string;
@@ -348,7 +351,7 @@ Effect-native addressable Session handle.
 
 ```ts
 type ShiitakeEffectSessionExtension = Readonly<{
-  call: (command, input) => Effect.Effect<Json, ShiitakeError>;
+  call: (command, input, caller?) => Effect.Effect<Json, ShiitakeError>;
 }>;
 ```
 
@@ -490,10 +493,16 @@ function openHost(options, mailRoom): Effect<Readonly<{
   readSettlement: (sessionId, commandId) => Effect<
      | Readonly<{
      acceptedSender: string | null;
+     delegator: string | null;
      terminal: SessionTerminal;
      content: string;
      usage: readonly Pick<AssistantMessage, ... | ... | ...>[];
      toolCalls: number;
+     waitingOnYou: readonly Readonly<{
+        itemId: ...;
+        kind: ...;
+        summary: ...;
+     }>[];
    }>
     | undefined, ShiitakeError>;
   agent: ShiitakeEffectOwner;
@@ -517,12 +526,14 @@ Open the Effect-native host composition with addressed mail.
 #### Returns
 
 `Effect`\<`Readonly`\<\{ `readSettlement`: (`sessionId`, `commandId`) =>
-`Effect`\< \| `Readonly`\<\{ `acceptedSender`: `string` \| `null`; `terminal`:
-[`SessionTerminal`](client.md#sessionterminal); `content`: `string`; `usage`:
-readonly `Pick`\<`AssistantMessage`, ... \| ... \| ...\>[]; `toolCalls`:
-`number`; \}\> \| `undefined`, [`ShiitakeError`](index.md#shiitakeerror)\>;
-`agent`: [`ShiitakeEffectOwner`](#shiitakeeffectowner); `acceptMail`: (`mail`,
-`meta?`, `reply?`, `stageAcceptedNotice?`) => `Effect`\<`Readonly`\<\{ `status`:
+`Effect`\< \| `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`,
+[`ShiitakeError`](index.md#shiitakeerror)\>; `agent`:
+[`ShiitakeEffectOwner`](#shiitakeeffectowner); `acceptMail`: (`mail`, `meta?`,
+`reply?`, `stageAcceptedNotice?`) => `Effect`\<`Readonly`\<\{ `status`:
 `"accepted"`; `commandId`: `string`; `sessionId?`: `string`; \}\>,
 [`ShiitakeError`](index.md#shiitakeerror)\>; \}\>,
 [`ShiitakeError`](index.md#shiitakeerror)\>
@@ -562,6 +573,67 @@ for it. An unreadable Session is its own `unavailable` row.
 [`StoredSessionSummaryRow`](#storedsessionsummaryrow)[]; `next`: `string` \|
 `undefined`; \}\>, [`ShiitakeError`](index.md#shiitakeerror), `never`\>
 
+---
+
+### readStoredSessionStates()
+
+```ts
+function readStoredSessionStates(
+  owner,
+  after?,
+): Effect<
+  Readonly<{
+    sessions: readonly SessionSummaryRow[];
+    next: string | undefined;
+  }>,
+  ShiitakeError,
+  never
+>;
+```
+
+One page of saved conversations with their stored run state (needs_you, running,
+errored, done), in tier then newest-activity order, read from the store alone:
+no Agent runtime starts. The state is as the runtime last wrote it, so it can
+lag work a stopped runtime left behind.
+
+#### Parameters
+
+| Parameter | Type                                  |
+| --------- | ------------------------------------- |
+| `owner`   | [`SqliteOwner`](index.md#sqliteowner) |
+| `after?`  | `string`                              |
+
+#### Returns
+
+`Effect`\<`Readonly`\<\{ `sessions`: readonly
+[`SessionSummaryRow`](client.md#sessionsummaryrow)[]; `next`: `string` \|
+`undefined`; \}\>, [`ShiitakeError`](index.md#shiitakeerror), `never`\>
+
+---
+
+### readStoredAttention()
+
+```ts
+function readStoredAttention(
+  owner,
+  sessionId,
+): Effect<readonly object[], ShiitakeError, never>;
+```
+
+One saved conversation's open attention items, read from the store alone.
+
+#### Parameters
+
+| Parameter   | Type                                  |
+| ----------- | ------------------------------------- |
+| `owner`     | [`SqliteOwner`](index.md#sqliteowner) |
+| `sessionId` | `string`                              |
+
+#### Returns
+
+`Effect`\<readonly `object`[], [`ShiitakeError`](index.md#shiitakeerror),
+`never`\>
+
 ## References
 
 ### AbortCommand
@@ -660,6 +732,12 @@ Re-exports [SessionProgress](client.md#sessionprogress)
 
 ---
 
+### SessionProgressDelta
+
+Re-exports [SessionProgressDelta](client.md#sessionprogressdelta)
+
+---
+
 ### SessionToolOutput
 
 Re-exports [SessionToolOutput](client.md#sessiontooloutput)