@fungi.computer/shiitake 0.7.0 → 0.9.0

package/dist/remote-client.js

@@ -10,6 +10,7 @@ import * as Schema from "effect/Schema";
 import * as Scope from "effect/Scope";
 import * as Sink from "effect/Sink";
 import * as Stream from "effect/Stream";
+import { sessionSilenceDeadlineMs } from "./session-liveness.js";
 import { parseAccepted, parseCommandSettlement, parseWithdrawResult, parseCancelResult, parseLatestPendingPrompt, parseForkedSession, parseCreatedSession, parseDeletedSession, parseExtensionOutput, parseExtensionStatus, parseExtensionStatuses, parseSessionFrame, parseSessionSnapshot, parseSessionSummaryPage, parseShiitakeError, } from "./client-wire.js";
 import { ShiitakeError } from "./errors.js";
 import { decodeClientReadOptions, decodeClientSessionCreationRequestId, decodeClientPageCursor, decodeClientSessionId, decodeClientSubscribeOptions, } from "./internal/client-boundary.js";
@@ -96,7 +97,10 @@ function remoteEvents(url, clientClosed, sources, eventSource) {
             return active;
         },
         catch: () => unavailable("Session stream could not open"),
-    }), (active) => closeRemoteSource(active, sources)), { bufferSize: 256, strategy: "dropping" }).pipe(Stream.mapEffect(decodeRemoteEvent), Stream.interruptWhen(clientClosed.await));
+    }), (active) => closeRemoteSource(active, sources)), { bufferSize: 256, strategy: "dropping" }).pipe(Stream.mapEffect(decodeRemoteEvent), Stream.timeoutOrElse({
+        duration: sessionSilenceDeadlineMs,
+        orElse: () => Stream.fail(unavailable("Session feed is connected but silent; the service may be busy")),
+    }), Stream.interruptWhen(clientClosed.await));
 }
 function sessionUrl(baseUrl, sessionId) {
     return `${baseUrl}/sessions/${encodeURIComponent(sessionId)}`;

package/dist/server-visitor-stream.js

@@ -1,5 +1,6 @@
 import { SSEStreamingApi } from "hono/streaming";
 import { visitorSnapshot } from "./client-visitor.js";
+import { encodeSessionFrame } from "./internal/observation-kernel.js";
 export function visitorStream(options) {
     const { readable, writable } = new TransformStream();
     const stream = new SSEStreamingApi(writable, readable);
@@ -43,7 +44,7 @@ export function visitorStream(options) {
             await close();
             return;
         }
-        await stream.write(": heartbeat\n\n");
+        // Keep the visitor authorization/expiry check, not a second liveness clock.
         if (!ending)
             heartbeat = setTimeout(() => {
                 void beat().catch((cause) => {
@@ -77,6 +78,15 @@ export function visitorStream(options) {
             for await (const frame of options.watch.changes) {
                 if (ending)
                     break;
+                if (frame.kind === "heartbeat") {
+                    if (!(await admitted()))
+                        break;
+                    await stream.writeSSE({
+                        event: "frame",
+                        data: encodeSessionFrame(frame).data,
+                    });
+                    continue;
+                }
                 if (frame.kind === "tool_output")
                     continue;
                 if (frame.kind === "progress" || frame.kind === "activity") {

package/dist/session-liveness.d.ts

@@ -0,0 +1,4 @@
+/** Process-local liveness cadence, not a durable Session fact. */
+export declare const sessionHeartbeatIntervalMs = 15000;
+/** Silence loses observation; only the service owner's lease check proves death. */
+export declare const sessionSilenceDeadlineMs = 45000;

package/dist/session-liveness.js

@@ -0,0 +1,4 @@
+/** Process-local liveness cadence, not a durable Session fact. */
+export const sessionHeartbeatIntervalMs = 15_000;
+/** Silence loses observation; only the service owner's lease check proves death. */
+export const sessionSilenceDeadlineMs = 45_000;

package/dist/testing.d.ts

@@ -1,6 +1,8 @@
 import { type FauxResponseStep } from "@fungi.computer/mule/testing";
 import type { ExtensionRosterV0, Json, RosteredExtensionV0 } from "./extensions.js";
 import { type ModelSource, type SessionSnapshot, type ShiitakeOwnerAgent, type ShiitakeOptions, type SqliteOwner } from "./index.js";
+/** Product finalizer grace, exposed for tests that wait for durable queue settlement. */
+export { runFinalizerGraceMs } from "./internal/run-scope.js";
 /** A deterministic model source for trusted tests; no provider account or I/O. */
 export declare function fauxModelSource(replies: readonly FauxResponseStep[]): ModelSource;
 /** One scripted model tool call; the scripted sandbox runs exactly this call. */

package/dist/testing.js

@@ -7,6 +7,8 @@ import * as z from "zod";
 import { fauxAssistantMessage, fauxToolCall, } from "@earendil-works/pi-ai/providers/faux";
 import { GuestThrew } from "@fungi.computer/mycelium";
 import { Shiitake, } from "./index.js";
+/** Product finalizer grace, exposed for tests that wait for durable queue settlement. */
+export { runFinalizerGraceMs } from "./internal/run-scope.js";
 const settlementBudgetSchema = z.int().min(1).max(1_000).default(1_000);
 /** A deterministic model source for trusted tests; no provider account or I/O. */
 export function fauxModelSource(replies) {

package/docs/api/agent-control.md

@@ -471,7 +471,7 @@ function waitForAgentSettlement(
     delegator: string | null;
     terminal: SessionTerminal;
     content: string;
-    usage: readonly Pick<AssistantMessage, "model" | "provider" | "usage">[];
+    usage: readonly Pick<AssistantMessage, "model" | "usage" | "provider">[];
     toolCalls: number;
     waitingOnYou: readonly Readonly<{
       itemId: string;
@@ -499,7 +499,7 @@ Await one exact durable terminal without opening a transcript observation.
 `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
+`"usage"` \| `"provider"`\>[]; `toolCalls`: `number`; `waitingOnYou`: readonly
 `Readonly`\<\{ `itemId`: `string`; `kind`: `string`; `summary`: `string`;
 \}\>[]; \}\>\>
 

package/docs/api/client.md

@@ -409,22 +409,13 @@ Durable outcome for one accepted work item on the selected Session lineage.
 ### AgentRunningWork
 
 ```ts
-type AgentRunningWork =
-  | Readonly<{
-      kind: "session";
-      sessionId: string;
-      commandId: string;
-      title: string;
-    }>
-  | Readonly<{
-      kind: "host";
-      lane: string;
-      jobId: string;
-    }>;
+type AgentRunningWork = Readonly<{
+  phase:
+    "thinking" | "streaming" | "running_tool" | "waiting_on_you" | "cancelling";
+}>;
 ```
 
-Blocking executor identity and Session display metadata, never messages or
-provider data.
+The occupying work's current phase; never its identity or transcript.
 
 ---
 
@@ -687,6 +678,9 @@ Bounded Session baseline at one opaque owner cursor.
 
 ```ts
 type SessionFrame =
+  | Readonly<{
+      kind: "heartbeat";
+    }>
   | Readonly<{
       kind: "activity";
       activity: SessionActivity;
@@ -1058,6 +1052,26 @@ const DelegationReceiptSchema: Schema.Codec<DelegationReceipt>;
 
 A delegated send is accepted by its owner or held in durable mail custody.
 
+---
+
+### sessionHeartbeatIntervalMs
+
+```ts
+const sessionHeartbeatIntervalMs: 15000 = 15_000;
+```
+
+Process-local liveness cadence, not a durable Session fact.
+
+---
+
+### sessionSilenceDeadlineMs
+
+```ts
+const sessionSilenceDeadlineMs: 45000 = 45_000;
+```
+
+Silence loses observation; only the service owner's lease check proves death.
+
 ## Functions
 
 ### participantSnapshot()

package/docs/api/delegation.md

@@ -68,7 +68,7 @@ settlement(
   delegator: string | null;
   terminal: SessionTerminal;
   content: string;
-  usage: readonly Pick<AssistantMessage, "model" | "provider" | "usage">[];
+  usage: readonly Pick<AssistantMessage, "model" | "usage" | "provider">[];
   toolCalls: number;
   waitingOnYou: readonly Readonly<{
      itemId: string;
@@ -95,7 +95,7 @@ Recipient-local disclosure through the public host, never another Agent's RPC.
 `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
+`"usage"` \| `"provider"`\>[]; `toolCalls`: `number`; `waitingOnYou`: readonly
 `Readonly`\<\{ `itemId`: `string`; `kind`: `string`; `summary`: `string`;
 \}\>[]; \}\> \| `undefined`\>
 

package/docs/api/fleet.md

@@ -28,9 +28,9 @@ new AgentGrantError(reason): AgentGrantError;
 
 ###### Parameters
 
-| Parameter | Type                                                                                  |
-| --------- | ------------------------------------------------------------------------------------- |
-| `reason`  | `"agent"` \| `"expired"` \| `"action"` \| `"delegation_loop"` \| `"delegation_depth"` |
+| Parameter | Type                                                                                                              |
+| --------- | ----------------------------------------------------------------------------------------------------------------- |
+| `reason`  | \| `"agent"` \| `"expired"` \| `"action"` \| `"delegation_loop"` \| `"delegation_depth"` \| `"delegator_missing"` |
 
 ###### Returns
 
@@ -47,7 +47,13 @@ Error.constructor;
 ##### reason
 
 ```ts
-readonly reason: "agent" | "expired" | "action" | "delegation_loop" | "delegation_depth";
+readonly reason:
+  | "agent"
+  | "expired"
+  | "action"
+  | "delegation_loop"
+  | "delegation_depth"
+  | "delegator_missing";
 ```
 
 ---
@@ -554,6 +560,7 @@ const agentDelegationTaskSchema: ZodLazy<
           steer: "steer";
         }>
       >;
+      goal: ZodOptional<ZodUnion<readonly [ZodString, ZodLiteral<false>]>>;
       text: ZodString;
     },
     $strict
@@ -759,6 +766,28 @@ the verified reply retains the failed recipient's identity.
 
 ---
 
+### isOneWayAncestorNotice()
+
+```ts
+function isOneWayAncestorNotice(mail): boolean;
+```
+
+Shape check for a one-way ancestor notice, not sender provenance. The Local mail
+receiver checks mesh membership before calling it. This addressed mail is still
+work and may steer the parent's running turn when admitted.
+
+#### Parameters
+
+| Parameter | Type          |
+| --------- | ------------- |
+| `mail`    | `BirdDogMail` |
+
+#### Returns
+
+`boolean`
+
+---
+
 ### readOutstandingDelegationSync()
 
 ```ts

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()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/shiitake",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "author": "Levi <levi@technomancy.dev>",
   "description": "Effect-native durable Session acceptance and bounded run orchestration",
   "type": "module",
@@ -89,16 +89,16 @@
     "@fungi.computer/bird-dog": "0.3.1",
     "@fungi.computer/cairn": "0.1.0",
     "@fungi.computer/carrier": "0.2.0",
-    "@fungi.computer/knapsack": "0.4.1",
-    "@fungi.computer/mule": "0.2.1",
-    "@fungi.computer/mycelium": "0.3.0",
+    "@fungi.computer/knapsack": "0.4.3",
+    "@fungi.computer/mule": "0.2.2",
+    "@fungi.computer/mycelium": "0.3.2",
     "@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.6.0"
+    "@fungi.computer/agar": "0.6.1"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "5.20260828.1",