@fastagent-sh/fastagent 0.22.0 → 0.22.1

package/dist/engines/pi/invoke-session.js

@@ -1,3 +1,4 @@
+import { contentText } from "@earendil-works/pi-ai";
 import * as Deferred from "effect/Deferred";
 import * as Effect from "effect/Effect";
 import * as Fiber from "effect/Fiber";
@@ -91,6 +92,28 @@ function trackExtensionTurns(session) {
     session.sendCustomMessage = (...args) => track(sendCustomMessage(...args));
     return pending;
 }
+/**
+ * Report each user message when it is WRITTEN, which is later than pi announces it: pi awaits extension `message_end`
+ * handlers before it appends. Emitting from the write is what makes `user_message.entryId` readable through
+ * `entries()` by the time the event arrives, so a reconnecting client's backfill cannot miss a message whose event
+ * fired before it subscribed. pi's agent awaits each listener before the next event, so the message still reports
+ * before the answer to it. The in-memory store reuses one record across runs, so the release restores the method.
+ */
+function reportUserMessages(session, report) {
+    const record = session.sessionManager;
+    const append = record.appendMessage;
+    return Effect.acquireRelease(Effect.sync(() => {
+        record.appendMessage = (message) => {
+            const entryId = append.call(record, message);
+            // The same text `entries()` publishes for this entry (session-control.ts toSessionEntry).
+            if (message.role === "user")
+                report(entryId, contentText(message.content, ""));
+            return entryId;
+        };
+    }), () => Effect.sync(() => {
+        record.appendMessage = append;
+    }));
+}
 export function createPiAgentFromSession(options) {
     const { sessionFactory, lease = inProcessLease(), observer } = options;
     async function* turn(scope, prompt, { onCancelReady, wasCancelled }) {
@@ -217,6 +240,7 @@ export function createPiAgentFromSession(options) {
                 if (OWED_BY_THE_RUN.has(error.event))
                     extensionFailure ??= `${error.event} failed (${error.extensionPath}): ${error.error}`;
             })), (unsubscribe) => Effect.sync(unsubscribe));
+            yield* reportUserMessages(session, (entryId, text) => observe({ type: "user_message", timestamp: Date.now(), runId, data: { entryId, text } }));
             const extensionTurns = trackExtensionTurns(session);
             // Completing the gate can run waiting controls synchronously; their queue events must be observed.
             yield* Deferred.succeed(bound, session);

package/dist/session.d.ts

@@ -280,6 +280,18 @@ export type RunSettledEvent = SessionEvent<"run_settled", {
 export type MessageStartedEvent = SessionEvent<"message_started", Record<never, never>> & {
     runId: string;
 };
+/**
+ * A user message entered the conversation: the run's opening prompt, a steer or follow-up leaving `pending`, or one an
+ * extension sent. It reports after the message is recorded, so `entries()` already holds `entryId` with the same
+ * `text` (a slash command expanded, images not included), and before the answer to it starts. The one live event a
+ * backfill can be deduplicated against exactly.
+ */
+export type UserMessageEvent = SessionEvent<"user_message", {
+    entryId: string;
+    text: string;
+}> & {
+    runId: string;
+};
 export type MessageDeltaEvent = SessionEvent<"message_delta", {
     channel: "text" | "thinking";
     delta: string;
@@ -368,4 +380,4 @@ export type ServingErrorEvent = SessionEvent<"serving_error", {
  * Every event the in-process observation plane emits today: L0, L1 `queue_changed`, and the L2 events
  * (`state_changed`, `compaction_*`, `retry_scheduled`).
  */
-export type KnownSessionEvent = RunStartedEvent | RunSettledEvent | MessageStartedEvent | MessageDeltaEvent | MessageFinishedEvent | ToolStartedEvent | ToolProgressEvent | ToolFinishedEvent | QueueChangedEvent | StateChangedEvent | CompactionStartedEvent | CompactionFinishedEvent | RetryScheduledEvent;
+export type KnownSessionEvent = RunStartedEvent | RunSettledEvent | MessageStartedEvent | UserMessageEvent | MessageDeltaEvent | MessageFinishedEvent | ToolStartedEvent | ToolProgressEvent | ToolFinishedEvent | QueueChangedEvent | StateChangedEvent | CompactionStartedEvent | CompactionFinishedEvent | RetryScheduledEvent;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fastagent-sh/fastagent",
-  "version": "0.22.0",
+  "version": "0.22.1",
   "description": "Vibe first. Then FastAgent: turn a local agent directory into a live service in your app, on Telegram, Slack, Feishu, or behind any channel.",
   "keywords": [
     "agent",