@fungi.computer/shiitake 0.7.0 → 0.8.0

package/dist/client-wire.js

@@ -28,19 +28,15 @@ const SessionActivitySchema = Schema.Struct({
         Schema.Struct({
             state: Schema.Literal("queued"),
             commandId: Schema.NonEmptyString,
-            runningWork: Schema.NullOr(Schema.Union([
-                Schema.Struct({
-                    kind: Schema.Literal("session"),
-                    sessionId: Schema.NonEmptyString,
-                    commandId: Schema.NonEmptyString,
-                    title: Schema.String,
-                }),
-                Schema.Struct({
-                    kind: Schema.Literal("host"),
-                    lane: Schema.NonEmptyString,
-                    jobId: Schema.NonEmptyString,
-                }),
-            ])),
+            runningWork: Schema.NullOr(Schema.Struct({
+                phase: Schema.Literals([
+                    "thinking",
+                    "streaming",
+                    "running_tool",
+                    "waiting_on_you",
+                    "cancelling",
+                ]),
+            })),
         }),
         Schema.Struct({
             state: Schema.Literal("running"),

package/dist/client.d.ts

@@ -132,17 +132,9 @@ export type SessionTerminal = Readonly<{
      */
     meta?: Json;
 }>;
-/** Blocking executor identity and Session display metadata, never messages or provider data. */
+/** The occupying work's current phase; never its identity or transcript. */
 export type AgentRunningWork = Readonly<{
-    kind: "session";
-    sessionId: string;
-    commandId: string;
-    /** Owner-issued display title; empty when no title is known. */
-    title: string;
-}> | Readonly<{
-    kind: "host";
-    lane: string;
-    jobId: string;
+    phase: "thinking" | "streaming" | "running_tool" | "waiting_on_you" | "cancelling";
 }>;
 /**
  * Raw facts about what a Session is doing now. Shiitake publishes facts only;

package/dist/fleet.d.ts

@@ -272,7 +272,11 @@ export declare function delegationSendMeta(sender: Readonly<{
  * while the verified reply retains the failed recipient's identity.
  */
 export declare function delegationReplyMeta(delegation: AuthenticatedDelegationReply, replierName: string): DelegationReplyMeta;
-/** An original one-way report can only name an ancestor of its Agent sender. */
+/**
+ * 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.
+ */
 export declare function isOneWayAncestorNotice(mail: BirdDogMail): boolean;
 /**
  * Delegated work an owner still waits on; `unreadable` says why its state

package/dist/fleet.js

@@ -361,7 +361,11 @@ export function delegationReplyMeta(delegation, replierName) {
 const delegationMetadata = z.object({
     delegation: FungiMessageMetaSchema.shape.delegation,
 });
-/** An original one-way report can only name an ancestor of its Agent sender. */
+/**
+ * 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.
+ */
 export function isOneWayAncestorNotice(mail) {
     if (mail.reply !== undefined ||
         mail.replyTo.length !== 0 ||

package/dist/http-routes.d.ts

@@ -818,14 +818,7 @@ export declare function createShiitakeHttpRoutes(resolveSession: ShiitakeSession
                         readonly state: "queued";
                         readonly commandId: string;
                         readonly runningWork: {
-                            readonly kind: "session";
-                            readonly sessionId: string;
-                            readonly commandId: string;
-                            readonly title: string;
-                        } | {
-                            readonly kind: "host";
-                            readonly lane: string;
-                            readonly jobId: string;
+                            readonly phase: "thinking" | "streaming" | "running_tool" | "waiting_on_you" | "cancelling";
                         } | null;
                     } | {
                         readonly state: "running";

package/dist/internal/observation-kernel.js

@@ -57,6 +57,14 @@ function deliverObservation(listener, reason) {
         listener.reset = true;
     }
 }
+/** Queued views reconcile occupancy without replaying another Session's facts. */
+function notifyQueuedViews(listeners, sourceSessionId) {
+    for (const listener of listeners)
+        if (listener.queued &&
+            !listener.settlementOnly &&
+            listener.sessionId !== sourceSessionId)
+            deliverObservation(listener, "activity");
+}
 /** Notify observers of one Session's durable or process-local change. */
 export function publishOwnerObservation(store, sessionId, reason = "durable") {
     const publishers = ownerPublishers.get(store);
@@ -131,11 +139,12 @@ export function openObservationKernel(store) {
     };
     const publish = (publication) => {
         if (publication.kind === "agent-execution") {
-            for (const listener of active)
-                if (listener.queued && !listener.settlementOnly)
-                    deliverObservation(listener, "activity");
+            notifyQueuedViews(active, null);
             return;
         }
+        // Reuse bounded activity hints for the occupant's changing phase.
+        if (publication.sessionId !== null && publication.reason !== "settlement")
+            notifyQueuedViews(active, publication.sessionId);
         const listeners = publication.sessionId === null
             ? active
             : sessions.get(publication.sessionId);

package/dist/internal/run-scope.d.ts

@@ -7,6 +7,7 @@ import type { ShiitakeEffectOptions } from "./effect-contracts.js";
 import type { CompactionHandoffV0, PromptSectionV0 } from "../extensions.js";
 import { type ManualCompactionOutcome } from "./compaction/session-compaction.js";
 import { type PreparedSessionRun, type RunContract } from "./woodstock/index.js";
+export declare const runFinalizerGraceMs = 1000;
 declare const toolSetupMessages: {
     readonly missing: "Instruction capabilities have no tool runtime";
     readonly runtime: "Tool runtime failed";

package/dist/internal/run-scope.js

@@ -12,9 +12,11 @@ import { openCompactionSettings } from "./compaction/settings.js";
 import { acquireOwnedModel } from "./model-acquisition.js";
 import { returnedFailureReason, unavailableRunReason, } from "./run-failure-reason.js";
 import { isCompactCommand, openMuleRecorder, readSessionGrants, recordLiveRetryEvent, recordSandboxFailure, takeSessionControls, } from "./woodstock/index.js";
-// A run writes its terminal before scope release. Give each foreign release
-// one second to clean up without blocking the next Watchdog job indefinitely.
-const runFinalizerGraceMs = 1_000;
+// A run writes its terminal before scope release. Allow one second per foreign
+// release before detaching it: the held-model regression exercises the full
+// grace and proves Watchdog can settle and claim the next priority-1 steer.
+// Keep the test's eventual queue-idle budget tied to this product bound.
+export const runFinalizerGraceMs = 1_000;
 function boundedRunFinalizer(name, workId, release) {
     return Effect.gen(function* () {
         // A detached release may finish later; interrupting a finalizer itself

package/dist/internal/runtime-coordinator.js

@@ -3,6 +3,7 @@ import { WatchdogError } from "@fungi.computer/watchdog";
 import { makeRuntime as makeWatchdogRuntime, } from "@fungi.computer/watchdog/effect";
 import * as Effect from "effect/Effect";
 import * as Latch from "effect/Latch";
+import { readSessionPhase } from "./session-status.js";
 import { readOutstandingDelegationSync } from "../fleet.js";
 import { publishAgentExecutionChange } from "./observation-kernel.js";
 import { ShiitakeError } from "../errors.js";
@@ -12,7 +13,7 @@ import { openCompactionSettings } from "./compaction/settings.js";
 import { admitExtensionRosterV0, } from "./extension-roster.js";
 import { coreConsumer, reportConsumer, openExtensionRuntime, } from "./extension-runtime.js";
 import { reconcileRuntime } from "./runtime-reconciliation.js";
-import { advanceCursor, createSessionWithinTransaction, deliverSessionGrants, prepareExtensionStore, recordSessionDelegator, projectSessionRun, openStorageAdmission, readCursor, readSessionInboxPage, readSessionSummary, } from "./woodstock/index.js";
+import { advanceCursor, createSessionWithinTransaction, deliverSessionGrants, prepareExtensionStore, recordSessionDelegator, projectSessionRun, openStorageAdmission, readCursor, readSessionInboxPage, } from "./woodstock/index.js";
 function runtimeFailure(message) {
     return new ShiitakeError("runtime", "rejected", message);
 }
@@ -285,12 +286,16 @@ export function openRuntimeCoordinator(options, coreDigest, admitted, mailRoom)
                         ? "host"
                         : "serial")
                     : undefined;
-                if (work === undefined || work.kind === "host")
-                    return Effect.succeed(work ?? null);
-                return readSessionSummary(options.store, work.sessionId).pipe(Effect.map((summary) => ({
-                    ...work,
-                    title: summary?.title ?? "",
-                })));
+                if (work === undefined)
+                    return Effect.succeed(null);
+                if (work.kind === "host")
+                    return Effect.succeed({ phase: "thinking" });
+                return Effect.try({
+                    try: () => ({
+                        phase: readSessionPhase(options.store, work.sessionId, watchdog.transactional.readQueueHead(work.sessionId)),
+                    }),
+                    catch: (cause) => new ShiitakeError("runtime", "rejected", "Running phase is unavailable", undefined, cause),
+                });
             }), Effect.mapError((cause) => new ShiitakeError("runtime", "rejected", "Running work is unavailable", undefined, cause))),
             extensions,
             commit: bound.commit,

package/dist/internal/session-status.d.ts

@@ -7,5 +7,7 @@ export type ObservedActivity = Readonly<{
     readProgress: () => SessionProgress | null;
     toolOutput: readonly SessionToolOutput[];
 }>;
+/** Project only the occupying Session's activity, without disclosing its data. */
+export declare function readSessionPhase(owner: SqliteOwner, sessionId: string, head: WatchdogQueueHead): AgentRunningWork["phase"];
 /** Join Watchdog authority with Woodstock facts and process-local progress. */
 export declare function readSessionActivity(owner: SqliteOwner, sessionId: string, head: WatchdogQueueHead, runningWork: AgentRunningWork | null): ObservedActivity;

package/dist/internal/session-status.js

@@ -1,4 +1,20 @@
-import { readProcessProgressForWork, readProcessToolOutputForWork, readProcessCompaction, readLatestLiveRetryForWork, readActiveToolForWork, readLastModelChoiceSequence, } from "./woodstock/index.js";
+import { readProcessProgressForWork, readProcessToolOutputForWork, readProcessCompaction, readLatestLiveRetryForWork, readActiveToolForWork, readLastModelChoiceSequence, readSessionAttention, hasProcessTextForWork, } from "./woodstock/index.js";
+/** Project only the occupying Session's activity, without disclosing its data. */
+export function readSessionPhase(owner, sessionId, head) {
+    const { facts } = readSessionActivity(owner, sessionId, head, null);
+    if (facts.cancellationRequested)
+        return "cancelling";
+    if (readSessionAttention(owner, sessionId).some((item) => item.inbox !== false && item.waitingOn === undefined))
+        return "waiting_on_you";
+    if (facts.compaction !== null || facts.retry !== null)
+        return "thinking";
+    if (facts.activeTool !== null)
+        return "running_tool";
+    if (head.state === "running" &&
+        hasProcessTextForWork(owner, sessionId, head.jobId))
+        return "streaming";
+    return "thinking";
+}
 /** Join Watchdog authority with Woodstock facts and process-local progress. */
 export function readSessionActivity(owner, sessionId, head, runningWork) {
     const lastModelChoiceSequence = readLastModelChoiceSequence(owner, sessionId);

package/dist/internal/woodstock/index.js

@@ -533,10 +533,11 @@ export function recordLiveRetryEvent(owner, accepted, event, turn) {
             sameIdentity(current.event.run, event.run));
     }).pipe(Effect.mapError(listenerFailure));
 }
-const listenerFailure = () => ({
+const listenerFailure = (cause) => ({
     _tag: "MuleError",
     phase: "listener",
     message: "Woodstock could not record the Mule event",
+    cause,
 });
 /**
  * Open the one scoped listener that projects Mule's exact event stream into

package/dist/internal/woodstock/progress.d.ts

@@ -32,6 +32,8 @@ export declare function openToolProgress(owner: SqliteOwner, accepted: AcceptedC
 export declare function readProcessProgress(owner: SqliteOwner, sessionId: string): SessionProgress | null;
 /** Read progress only when it belongs to the current durable work head. */
 export declare function readProcessProgressForWork(owner: SqliteOwner, sessionId: string, workId: string): SessionProgress | null;
+/** Read a phase fact without flattening another Session's private text tails. */
+export declare function hasProcessTextForWork(owner: SqliteOwner, sessionId: string, workId: string): boolean;
 export type ProgressMessageStart = Extract<MuleEvent, {
     type: "message_start";
 }>;

package/dist/internal/woodstock/progress.js

@@ -189,6 +189,11 @@ export function readProcessProgressForWork(owner, sessionId, workId) {
     const current = progressFor(owner).get(sessionId);
     return snapshot(current?.workId === workId ? current.value : null);
 }
+/** Read a phase fact without flattening another Session's private text tails. */
+export function hasProcessTextForWork(owner, sessionId, workId) {
+    const current = progressByOwner.get(owner)?.get(sessionId);
+    return current?.workId === workId && (current.value?.text.length ?? 0) > 0;
+}
 /**
  * Keep live model progress in the current process only.
  *

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/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.
 
 ---
 

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.8.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/knapsack": "0.4.2",
     "@fungi.computer/mule": "0.2.1",
-    "@fungi.computer/mycelium": "0.3.0",
+    "@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.6.0"
+    "@fungi.computer/agar": "0.6.1"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "5.20260828.1",