@fungi.computer/shiitake 0.6.0 → 0.8.0

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.
@@ -577,6 +578,9 @@ type ShiitakeOptions = Readonly<{
   meta?: HostMetaOptions;
   store: SqliteOwner;
   storagePressure?: StoragePressureCheck;
+  admission?: Readonly<{
+    assertOpen: () => void;
+  }>;
   compaction?: CompactionOptions;
   runtime: RuntimeHost;
   model: ModelSource;
@@ -635,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;
+  }>[];
 }>;
 ```
 
@@ -926,10 +936,16 @@ 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;
@@ -953,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?`, `stageAcceptedNotice?`) => `Promise`\<`Readonly`\<\{ `status`:
-`"accepted"`; `commandId`: `string`; `sessionId?`: `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
 
@@ -1047,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

@@ -91,6 +91,17 @@ type MemoryHost = Readonly<{
 
 Explicitly driven in-process host for trusted tests and runnable examples.
 
+## Variables
+
+### runFinalizerGraceMs
+
+```ts
+const runFinalizerGraceMs: 1000 = 1_000;
+```
+
+Product finalizer grace, exposed for tests that wait for durable queue
+settlement.
+
 ## Functions
 
 ### fauxModelSource()
@@ -200,6 +211,8 @@ function memoryHost(options?): Promise<Readonly<{
         revision: number;
         text: string;
         thinking: string;
+        textOffset: number;
+        thinkingOffset: number;
         textTruncated: boolean;
         thinkingTruncated: boolean;
       }>
@@ -253,10 +266,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.6.0",
+  "version": "0.8.0",
   "author": "Levi <levi@technomancy.dev>",
   "description": "Effect-native durable Session acceptance and bounded run orchestration",
   "type": "module",
@@ -86,19 +86,19 @@
     "node": ">=22.13"
   },
   "dependencies": {
-    "@fungi.computer/bird-dog": "0.3.0",
+    "@fungi.computer/bird-dog": "0.3.1",
     "@fungi.computer/cairn": "0.1.0",
     "@fungi.computer/carrier": "0.2.0",
-    "@fungi.computer/knapsack": "0.4.0",
+    "@fungi.computer/knapsack": "0.4.2",
     "@fungi.computer/mule": "0.2.1",
-    "@fungi.computer/mycelium": "0.2.3",
+    "@fungi.computer/mycelium": "0.3.1",
     "@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.5.0"
+    "@fungi.computer/agar": "0.6.1"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "5.20260828.1",