@fungi.computer/shiitake 0.5.0 → 0.7.0

package/docs/api/client-entry.md

@@ -172,6 +172,7 @@ const clientTimelineCellSchemaV1: Struct<{
         id: String;
         label: String;
         input: optional<$Record<..., ...>>;
+        awaiting: optionalKey<Literal<...>>;
      }>>>;
   }>>;
 }>;
@@ -222,6 +223,7 @@ const clientContributionSchemaV1: Struct<{
         id: String;
         label: String;
         input: optional<$Record<..., ...>>;
+        awaiting: optionalKey<Literal<...>>;
      }>>>;
      inspection: optionalKey<Struct<{
         commandId: String;
@@ -261,6 +263,7 @@ const clientContributionSchemaV1: Struct<{
         id: String;
         label: String;
         input: optional<$Record<String, Codec<Json, Json, never, never>>>;
+        awaiting: optionalKey<Literal<"question">>;
      }>;
   }>>;
 }>;

package/docs/api/client.md

@@ -10,12 +10,67 @@
 
 ## Type Aliases
 
+### ParticipantPolicy
+
+```ts
+type ParticipantPolicy = Readonly<{
+  turnIsCurrent: (sessionId, commandId) => boolean;
+  deliverAgentReply: (sessionId, commandId, reply) => boolean;
+}>;
+```
+
+The host decides which Agent work may be delivered to this participant.
+
+---
+
+### VisitorView
+
+```ts
+type VisitorView = Readonly<{
+  status: "idle" | "working";
+  lines: readonly Readonly<{
+    id: string;
+    from: "visitor" | "agent" | "operator";
+    text: string;
+  }>[];
+  progress: string | null;
+}>;
+```
+
+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
+type VisitorPendingPrompt = Pick<
+  SessionPendingPrompt,
+  "commandId" | "requestId" | "text" | "delivery" | "images"
+>;
+```
+
+Public pending facts exclude the host's private metadata and admission origin.
+
+---
+
 ### Accepted
 
 ```ts
 type Accepted = Readonly<{
   status: "accepted";
   commandId: string;
+  sessionId?: string;
 }>;
 ```
 
@@ -115,6 +170,7 @@ type SessionCommandHandler = {
     Readonly<{
       status: "accepted";
       commandId: string;
+      sessionId?: string;
     }>
   >;
   (input): Promise<CancelResult>;
@@ -142,6 +198,7 @@ Execute one retained type-discriminated Session command.
 (input): Promise<Readonly<{
   status: "accepted";
   commandId: string;
+  sessionId?: string;
 }>>;
 ```
 
@@ -155,7 +212,8 @@ Accept a prompt or a compaction request as queued Session work.
 
 ##### Returns
 
-`Promise`\<`Readonly`\<\{ `status`: `"accepted"`; `commandId`: `string`; \}\>\>
+`Promise`\<`Readonly`\<\{ `status`: `"accepted"`; `commandId`: `string`;
+`sessionId?`: `string`; \}\>\>
 
 #### Call Signature
 
@@ -356,6 +414,7 @@ type AgentRunningWork =
       kind: "session";
       sessionId: string;
       commandId: string;
+      title: string;
     }>
   | Readonly<{
       kind: "host";
@@ -364,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.
 
 ---
 
@@ -421,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>;
 }>;
 ```
 
@@ -467,6 +526,8 @@ type SessionProgress = Readonly<{
   revision: number;
   text: string;
   thinking: string;
+  textOffset: number;
+  thinkingOffset: number;
   textTruncated: boolean;
   thinkingTruncated: boolean;
 }>;
@@ -476,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
@@ -631,7 +713,7 @@ type SessionFrame =
     }>
   | Readonly<{
       kind: "progress";
-      progress: SessionProgress;
+      progress: SessionProgressDelta;
       activity: SessionActivity;
     }>
   | Readonly<{
@@ -978,6 +1060,93 @@ A delegated send is accepted by its owner or held in durable mail custody.
 
 ## Functions
 
+### participantSnapshot()
+
+```ts
+function participantSnapshot(snapshot, owner): SessionSnapshot;
+```
+
+Filter participant delivery only; the holder's stored Session is unchanged.
+
+#### Parameters
+
+| Parameter  | Type                                      |
+| ---------- | ----------------------------------------- |
+| `snapshot` | [`SessionSnapshot`](#sessionsnapshot)     |
+| `owner`    | [`ParticipantPolicy`](#participantpolicy) |
+
+#### Returns
+
+[`SessionSnapshot`](#sessionsnapshot)
+
+---
+
+### visitorPendingPrompt()
+
+```ts
+function visitorPendingPrompt(prompt, visitorId): VisitorPendingPrompt;
+```
+
+Project one owner-selected prompt without exposing host identity or correlation
+metadata.
+
+#### Parameters
+
+| Parameter   | Type                                            |
+| ----------- | ----------------------------------------------- |
+| `prompt`    | [`SessionPendingPrompt`](#sessionpendingprompt) |
+| `visitorId` | `string`                                        |
+
+#### Returns
+
+[`VisitorPendingPrompt`](#visitorpendingprompt)
+
+---
+
+### visitorSnapshot()
+
+```ts
+function visitorSnapshot(snapshot, visitorId): SessionSnapshot;
+```
+
+Visitor-scoped Session facts use the visitor's public address, never the
+internal Session ID.
+
+#### Parameters
+
+| Parameter   | Type                                  |
+| ----------- | ------------------------------------- |
+| `snapshot`  | [`SessionSnapshot`](#sessionsnapshot) |
+| `visitorId` | `string`                              |
+
+#### Returns
+
+[`SessionSnapshot`](#sessionsnapshot)
+
+---
+
+### visitorView()
+
+```ts
+function visitorView(snapshot, visitorId): VisitorView;
+```
+
+Project only this visitor's host-attributed prompts, their replies, and explicit
+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`; `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
+
+[`VisitorView`](#visitorview)
+
+---
+
 ### parseDelegationReceipt()
 
 ```ts
@@ -1133,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,11 +427,30 @@ 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,
     ) => Promise<CommandSettlement | undefined>;
-    acceptMail: (mail, meta?, reply?) => Promise<Accepted>;
+    acceptMail: (
+      mail,
+      meta?,
+      reply?,
+      stageAcceptedNotice?,
+      sessionGrantDelivery?,
+    ) => Promise<Accepted>;
     alarm: () => Promise<void>;
     activeSessions: () => Promise<readonly string[]>;
     abortActive: () => Promise<void>;