@fungi.computer/corral 0.0.1 → 0.1.0

package/README.md

@@ -34,7 +34,7 @@ import { attachCorral } from "@fungi.computer/corral";
 
 const scope = await Effect.runPromise(Scope.make());
 await Effect.runPromise(
-  attachCorral(Stream.fromIterable(["idle", "working"]), {
+  attachCorral(Stream.fromIterable([{ state: "idle" }, { state: "working" }]), {
     environment: {
       HERDR_ENV: "1",
       HERDR_SOCKET_PATH: "/path/to/herdr.sock",
@@ -60,10 +60,11 @@ default entry borrows an AsyncIterable with an independent sliding latest-value
 subscription per iterator and a detach signal. `attachCorral` accepts an Effect
 stream, including a stream with typed `Error` failures. Source and socket errors
 reach `onError`; closing the scope still releases the pane report. Fungi borrows
-its existing Session observation and command interaction store. A pending
-question or browser hand-off reports `blocked`. Answering it restores the
-current activity. Question text, answers and credentials are never included in
-reports.
+its existing Session observation and command interaction store. An open agent
+question, a pending command question or a browser hand-off reports `blocked`.
+Answering it restores the current activity. An agent question may add its short
+header to the blocked message; question bodies, answer choices, answers and
+credentials are never included in reports.
 
 Herdr derives `done` when an unseen background turn returns to `idle`. It owns
 whether the user has seen that completion. Corral never guesses completion from
@@ -72,7 +73,7 @@ an unavailable observation.
 `attachCorral` needs an Effect scope. When that scope closes, Corral cancels its
 reporter, closes any in-flight socket, and releases the current pane report. It
 sends `pane.report_agent` and `pane.release_agent` over Herdr's API socket with
-the `fungi:shiitake:v1` source and `shiitake` agent label. A monotone timestamp
+the `fungi:agent:v1` source and `fungi` agent label. A monotone timestamp
 sequence orders reports across attachments and process restarts.
 
 ## API reference

package/dist/index.d.ts

@@ -22,7 +22,7 @@ export declare function attachCorral(activity: Stream.Stream<CorralActivity, Err
 declare const extension: Readonly<{
     protocol: "shiitake.client/v1";
     id: ExtensionId;
-    correlatedPrompts?: "note";
+    promptPresentation?: "footer";
     attach?: (context: import("@fungi.computer/shiitake/client-entry").ClientExtensionContextV1) => Effect.Effect<void, Error, Scope.Scope>;
     contribute?: (slot: import("@fungi.computer/shiitake/extensions").ExtensionSlotV0 | undefined) => import("@fungi.computer/shiitake/client-entry").ClientContributionV1;
 }>;

package/dist/index.js

@@ -7,7 +7,7 @@ import { ExtensionId, } from "@fungi.computer/shiitake/extensions";
 import * as Stream from "effect/Stream";
 import * as Effect from "effect/Effect";
 import * as Schema from "effect/Schema";
-const source = "fungi:shiitake:v1";
+const source = "fungi:agent:v1";
 let reportSequence = Date.now() * 1000;
 const decodeResponse = Schema.decodeUnknownSync(Schema.fromJsonString(Schema.Union([
     Schema.Struct({ id: Schema.String, result: Schema.Unknown }),
@@ -20,19 +20,23 @@ function nextSequence() {
     reportSequence = Math.max(reportSequence + 1, Date.now() * 1000);
     return reportSequence;
 }
-function request(endpoint, pane, state) {
+function request(endpoint, pane, activity) {
+    const state = activity?.state;
     const seq = nextSequence();
     const id = `${source}:${String(seq)}`;
     const params = {
         pane_id: pane,
         source,
-        agent: "shiitake",
+        agent: "fungi",
         seq,
     };
     if (state !== undefined)
         params.state = state;
     if (state === "blocked")
-        params.message = "Waiting for your response";
+        params.message =
+            activity?.header === undefined
+                ? "Waiting for your response"
+                : `Waiting for your response: ${activity.header}`;
     const body = {
         id,
         method: state === undefined ? "pane.release_agent" : "pane.report_agent",
@@ -74,12 +78,12 @@ export function attachCorral(activity, options) {
     const endpoint = process.platform === "win32"
         ? `\\\\.\\pipe\\${HERDR_SOCKET_PATH}`
         : HERDR_SOCKET_PATH;
-    const send = (state) => request(endpoint, HERDR_PANE_ID, state).pipe(Effect.catch((cause) => Effect.sync(() => {
+    const send = (activity) => request(endpoint, HERDR_PANE_ID, activity).pipe(Effect.catch((cause) => Effect.sync(() => {
         options.onError(cause);
     })));
     return Effect.gen(function* () {
         yield* Effect.acquireRelease(Effect.void, () => send(undefined));
-        yield* activity.pipe(Stream.changes, Stream.runForEach(send), Effect.catch((cause) => Effect.sync(() => {
+        yield* activity.pipe(Stream.changesWith((a, b) => a.state === b.state && a.header === b.header), Stream.runForEach(send), Effect.catch((cause) => Effect.sync(() => {
             options.onError(cause);
         })), Effect.forkScoped);
     });

package/docs/api/README.md

@@ -38,7 +38,7 @@ Activity supplied by the client; blocked means a human response is pending.
 const default: Readonly<{
   protocol: "shiitake.client/v1";
   id: string & Brand<"ExtensionId">;
-  correlatedPrompts?: "note";
+  promptPresentation?: "footer";
   attach?: (context) => Effect<void, Error, Scope>;
   contribute?: (slot) => object;
 }>;
@@ -60,7 +60,7 @@ Attach to borrowed activity; never opens a Session watch or starts Herdr.
 
 | Parameter  | Type                                                                                                          |
 | ---------- | ------------------------------------------------------------------------------------------------------------- |
-| `activity` | `Stream`\<`ClientActivityV0`, `Error`\>                                                                       |
+| `activity` | `Stream`\<`Readonly`\<\{ `state`: `ClientActivityStateV0`; `header?`: `string`; \}\>, `Error`\>               |
 | `options`  | `Readonly`\<\{ `environment`: [`CorralEnvironment`](#corralenvironment); `onError`: (`cause`) => `void`; \}\> |
 
 #### Returns

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/corral",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Optional Herdr activity reporting for Shiitake clients",
   "type": "module",
   "sideEffects": false,
@@ -18,7 +18,7 @@
   ],
   "dependencies": {
     "effect": "4.0.2",
-    "@fungi.computer/shiitake": "0.2.0"
+    "@fungi.computer/shiitake": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "24.13.3",