@fungi.computer/shiitake 0.8.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/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

@@ -678,6 +678,9 @@ Bounded Session baseline at one opaque owner cursor.
 
 ```ts
 type SessionFrame =
+  | Readonly<{
+      kind: "heartbeat";
+    }>
   | Readonly<{
       kind: "activity";
       activity: SessionActivity;
@@ -1049,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/shiitake",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "author": "Levi <levi@technomancy.dev>",
   "description": "Effect-native durable Session acceptance and bounded run orchestration",
   "type": "module",
@@ -89,9 +89,9 @@
     "@fungi.computer/bird-dog": "0.3.1",
     "@fungi.computer/cairn": "0.1.0",
     "@fungi.computer/carrier": "0.2.0",
-    "@fungi.computer/knapsack": "0.4.2",
-    "@fungi.computer/mule": "0.2.1",
-    "@fungi.computer/mycelium": "0.3.1",
+    "@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",