@prestyj/cli 5.10.0 → 5.12.0

package/dist/core/session-notification-visibility.test.js

@@ -0,0 +1,113 @@
+/**
+ * Pushed background-status updates ride the steering path into the model's
+ * context, so they are persisted as `user` messages. But the LIVE transcript
+ * never shows a bubble for them — the loop yields `steering_message`, which no
+ * host forwards to the UI.
+ *
+ * That asymmetry was the bug: a session looked clean while you worked in it and
+ * came back full of "Background process … exited with code 0" lines the moment
+ * you reopened it. Every surface that reconstructs a transcript from the
+ * session file must therefore skip them, exactly as it already skips autopilot
+ * injections.
+ */
+import { describe, expect, it } from "vitest";
+import { restoreUserRow } from "./session-history.js";
+import { findUserSessionPrompt, getUserSessionPrompt } from "./session-preview.js";
+import { sessionToMarkdown } from "./session-export.js";
+import { buildNotificationSteeringText, STEERING_PREFIX } from "./steering.js";
+const DEV_SERVER_NOTIFICATION = buildNotificationSteeringText([
+    'Background process c1c45a8d (pnpm dev) exited with code 0 after 40s. Last output: …ELIFECYCLE Command failed. Read it with task_output id="c1c45a8d".',
+]);
+const PROGRESS_NOTIFICATION = buildNotificationSteeringText([
+    "Background process c1c45a8d (pnpm dev) is still running after 3.2m, 48210 bytes logged. Latest: [electron] compiled ok",
+]);
+/** A realistic resumed transcript: real work, with status updates interleaved. */
+function transcript() {
+    return [
+        { role: "user", content: "start the dev server and fix the login bug" },
+        { role: "assistant", content: "Starting it now." },
+        { role: "user", content: PROGRESS_NOTIFICATION },
+        { role: "assistant", content: "Still building. Meanwhile, here's the fix." },
+        { role: "user", content: DEV_SERVER_NOTIFICATION },
+        { role: "assistant", content: "The server exited; I'll restart it." },
+        { role: "user", content: `${STEERING_PREFIX}also add dark mode` },
+        { role: "assistant", content: "Done." },
+    ];
+}
+describe("resumed transcript", () => {
+    it("hides pushed status updates but keeps everything the user sent", () => {
+        const visible = transcript()
+            .filter((m) => m.role === "user")
+            .map((m) => restoreUserRow(m.content))
+            .filter((row) => !row.notification)
+            .map((row) => row.text);
+        expect(visible).toEqual(["start the dev server and fix the login bug", "also add dark mode"]);
+    });
+    it("hides them whether the process is still running or has exited", () => {
+        expect(restoreUserRow(PROGRESS_NOTIFICATION).notification).toBe(true);
+        expect(restoreUserRow(DEV_SERVER_NOTIFICATION).notification).toBe(true);
+    });
+});
+describe("session title", () => {
+    it("never uses a status update as the title", () => {
+        // Otherwise a session is listed as "Background process c1c45a8d (pnpm dev)
+        // exited with code 0" — unrecognisable and unsearchable.
+        expect(getUserSessionPrompt(DEV_SERVER_NOTIFICATION)).toBeNull();
+        expect(getUserSessionPrompt(PROGRESS_NOTIFICATION)).toBeNull();
+    });
+    it("falls through a leading status update to the real prompt", () => {
+        const title = findUserSessionPrompt([
+            { role: "user", content: DEV_SERVER_NOTIFICATION },
+            { role: "user", content: "fix the login bug" },
+        ]);
+        expect(title).toBe("fix the login bug");
+    });
+});
+describe("session export", () => {
+    it("omits status updates from exported markdown", () => {
+        const markdown = sessionToMarkdown({ mode: "code", cwd: "/tmp/project", provider: "anthropic", model: "claude-test" }, transcript());
+        // The user's own words survive.
+        expect(markdown).toContain("start the dev server and fix the login bug");
+        expect(markdown).toContain("also add dark mode");
+        // The machine framing and its payload do not — an export must match the
+        // conversation the user actually had.
+        expect(markdown).not.toContain("Status update on background work");
+        expect(markdown).not.toContain("c1c45a8d");
+        expect(markdown).not.toContain("still running after");
+    });
+});
+describe("provenance-first visibility", () => {
+    const human = { source: "human", kind: "prompt", visibility: "transcript" };
+    const hiddenRuntime = {
+        source: "runtime",
+        kind: "notification",
+        visibility: "hidden",
+    };
+    it("trusts metadata over misleading message text for titles and exports", () => {
+        const messages = [
+            { role: "user", content: "ordinary-looking generated context", provenance: hiddenRuntime },
+            { role: "user", content: DEV_SERVER_NOTIFICATION, provenance: human },
+        ];
+        expect(findUserSessionPrompt(messages)).toBe(DEV_SERVER_NOTIFICATION);
+        const markdown = sessionToMarkdown({ mode: "code", cwd: "/tmp/project", provider: "anthropic", model: "claude-test" }, messages);
+        expect(markdown).not.toContain("ordinary-looking generated context");
+        expect(markdown).toContain(DEV_SERVER_NOTIFICATION);
+    });
+    it("renders tagged summaries as compaction markers without exporting their payload", () => {
+        const markdown = sessionToMarkdown({ mode: "code", cwd: "/tmp/project", provider: "anthropic", model: "claude-test" }, [
+            {
+                role: "user",
+                content: "summary payload without a legacy prefix",
+                provenance: {
+                    source: "runtime",
+                    kind: "compaction_summary",
+                    visibility: "summary",
+                },
+            },
+        ]);
+        expect(markdown).toContain("conversation compacted here");
+        expect(markdown).not.toContain("summary payload without a legacy prefix");
+        expect(markdown).not.toContain("no messages yet");
+    });
+});
+//# sourceMappingURL=session-notification-visibility.test.js.map

package/dist/core/session-notification-visibility.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-notification-visibility.test.js","sourceRoot":"","sources":["../../src/core/session-notification-visibility.test.ts"],"names":[],"mappings":"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"}

package/dist/core/session-preview.d.ts

@@ -1,11 +1,12 @@
-import type { Message } from "@prestyj/ai";
+import type { Message, MessageProvenance } from "@prestyj/ai";
 /** Extract visible text from a persisted message content value. */
 export declare function extractSessionText(content: Message["content"] | unknown): string;
 /**
  * Return user-authored prompt text suitable for a stable session title.
- * Compaction summaries and Nolan's autopilot injections are model-owned context,
- * not new conversations, so they must never replace the user's title.
+ * Compaction summaries, Nolan's autopilot injections, and background-status
+ * updates are model-owned context, not new conversations, so they must never
+ * replace the user's title.
  */
-export declare function getUserSessionPrompt(content: Message["content"] | unknown): string | null;
+export declare function getUserSessionPrompt(content: Message["content"] | unknown, provenance?: MessageProvenance): string | null;
 export declare function findUserSessionPrompt(messages: readonly Message[]): string;
 //# sourceMappingURL=session-preview.d.ts.map

package/dist/core/session-preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-preview.d.ts","sourceRoot":"","sources":["../../src/core/session-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAO3C,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,GAAG,MAAM,CAWhF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAazF;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAO1E"}
+{"version":3,"file":"session-preview.d.ts","sourceRoot":"","sources":["../../src/core/session-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAQ9D,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,GAAG,MAAM,CAWhF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,EACrC,UAAU,CAAC,EAAE,iBAAiB,GAC7B,MAAM,GAAG,IAAI,CAmBf;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAO1E"}

package/dist/core/session-preview.js

@@ -1,3 +1,4 @@
+import { NOTIFICATION_PREFIX } from "./steering.js";
 const COMPACTION_SUMMARY_PREFIX = "[Previous conversation summary]";
 const AUTOPILOT_PROMPT_PREFIX = "[Autopilot] This turn was triggered by Nolan, EZ Coder's automated reviewer";
 const STEERING_PREFIX_START = "[The user added this while you were working";
@@ -19,14 +20,20 @@ export function extractSessionText(content) {
 }
 /**
  * Return user-authored prompt text suitable for a stable session title.
- * Compaction summaries and Nolan's autopilot injections are model-owned context,
- * not new conversations, so they must never replace the user's title.
+ * Compaction summaries, Nolan's autopilot injections, and background-status
+ * updates are model-owned context, not new conversations, so they must never
+ * replace the user's title.
  */
-export function getUserSessionPrompt(content) {
+export function getUserSessionPrompt(content, provenance) {
+    if (provenance && provenance.source !== "human")
+        return null;
     let text = extractSessionText(content).trim();
     if (!text)
         return null;
-    if (text.startsWith(COMPACTION_SUMMARY_PREFIX) || text.startsWith(AUTOPILOT_PROMPT_PREFIX)) {
+    if (!provenance &&
+        (text.startsWith(COMPACTION_SUMMARY_PREFIX) ||
+            text.startsWith(AUTOPILOT_PROMPT_PREFIX) ||
+            text.startsWith(NOTIFICATION_PREFIX))) {
         return null;
     }
     // A queued steering note is still user-authored; remove only its machine frame.
@@ -41,7 +48,7 @@ export function findUserSessionPrompt(messages) {
     for (const message of messages) {
         if (message.role !== "user")
             continue;
-        const text = getUserSessionPrompt(message.content);
+        const text = getUserSessionPrompt(message.content, message.provenance);
         if (text)
             return text;
     }

package/dist/core/session-preview.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-preview.js","sourceRoot":"","sources":["../../src/core/session-preview.ts"],"names":[],"mappings":"AAEA,MAAM,yBAAyB,GAAG,iCAAiC,CAAC;AACpE,MAAM,uBAAuB,GAC3B,6EAA6E,CAAC;AAChF,MAAM,qBAAqB,GAAG,6CAA6C,CAAC;AAE5E,mEAAmE;AACnE,MAAM,UAAU,kBAAkB,CAAC,OAAqC;IACtE,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACzE,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;QAChD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAqC;IACxE,IAAI,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,IAAI,CAAC,UAAU,CAAC,yBAAyB,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,EAAE,CAAC;QAC3F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gFAAgF;IAChF,IAAI,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,OAAO,IAAI,CAAC;YAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAA4B;IAChE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS;QACtC,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"session-preview.js","sourceRoot":"","sources":["../../src/core/session-preview.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,yBAAyB,GAAG,iCAAiC,CAAC;AACpE,MAAM,uBAAuB,GAC3B,6EAA6E,CAAC;AAChF,MAAM,qBAAqB,GAAG,6CAA6C,CAAC;AAE5E,mEAAmE;AACnE,MAAM,UAAU,kBAAkB,CAAC,OAAqC;IACtE,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACzE,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;QAChD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAqC,EACrC,UAA8B;IAE9B,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IACE,CAAC,UAAU;QACX,CAAC,IAAI,CAAC,UAAU,CAAC,yBAAyB,CAAC;YACzC,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC;YACxC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,EACvC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gFAAgF;IAChF,IAAI,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,OAAO,IAAI,CAAC;YAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAA4B;IAChE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS;QACtC,MAAM,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACvE,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/core/session-restore-display.test.js

@@ -74,5 +74,30 @@ describe("continued session replay display filtering", () => {
         expect(replayedText).toContain("/help");
         expect(replayedText).toContain("Here are the available commands.");
     });
+    it("uses provenance before role or legacy prefixes", () => {
+        const persisted = [
+            {
+                role: "user",
+                content: "generated control with ordinary text",
+                provenance: { source: "runtime", kind: "automation", visibility: "hidden" },
+            },
+            {
+                role: "user",
+                content: "queued follow-up",
+                provenance: { source: "human", kind: "steering", visibility: "transcript" },
+            },
+            {
+                role: "assistant",
+                content: "generated acknowledgement",
+                provenance: { source: "runtime", kind: "compaction_ack", visibility: "hidden" },
+            },
+            {
+                role: "user",
+                content: "summary without prefix",
+                provenance: { source: "runtime", kind: "compaction_summary", visibility: "summary" },
+            },
+        ];
+        expect(replayTexts(persisted)).toEqual(["queued follow-up", "summary without prefix"]);
+    });
 });
 //# sourceMappingURL=session-restore-display.test.js.map

package/dist/core/session-restore-display.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-restore-display.test.js","sourceRoot":"","sources":["../../src/core/session-restore-display.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-restore-display.test.js","sourceRoot":"","sources":["../../src/core/session-restore-display.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAqB,MAAM,sBAAsB,CAAC;AACnG,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAExE,SAAS,WAAW,CAAC,OAA2B;IAC9C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,OAAO;SACX,MAAM,CACL,CAAC,KAAK,EAA2C,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,IAAI,KAAK,CAC7F;SACA,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,QAA4B;IAC/C,OAAO,6BAA6B,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,aAAa,CAAC,QAAmB;IACxC,OAAO,sBAAsB,CAAC,6BAA6B,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;QACzD,MAAM,SAAS,GAAmB;YAChC;gBACE,IAAI,EAAE,SAAS;gBACf,EAAE,EAAE,OAAO;gBACX,QAAQ,EAAE,IAAI;gBACd,SAAS,EAAE,0BAA0B;gBACrC,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE;aAC5D;YACD;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,wBAAwB;gBAC9B,IAAI,EAAE;oBACJ,OAAO,EAAE,CAAC;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,kBAAkB;wBACxB,EAAE,EAAE,cAAc;qBACnB;iBACF;gBACD,EAAE,EAAE,WAAW;gBACf,QAAQ,EAAE,IAAI;gBACd,SAAS,EAAE,0BAA0B;aACtC;SACF,CAAC;QAEF,MAAM,CAAC,cAAc,CAAC,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACjE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,cAAc,EAAE;SAC/D,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;YACtC,MAAM,SAAS,GAAc;gBAC3B;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,8CAA8C;iBACzE;aACF,CAAC;YAEF,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;gBAC7C,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,IAAI,mBAAmB,EAAE;aAC5D,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6FAA6F,EAAE,GAAG,EAAE;QACrG,MAAM,SAAS,GAAc;YAC3B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,8CAA8C,EAAE;YAC3E,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE;YAClC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,kCAAkC,EAAE;SACnE,CAAC;QAEF,MAAM,YAAY,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvD,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QAC9D,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,SAAS,GAAc;YAC3B;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,sCAAsC;gBAC/C,UAAU,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE;aAC5E;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,kBAAkB;gBAC3B,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE;aAC5E;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,2BAA2B;gBACpC,UAAU,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE;aAChF;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,wBAAwB;gBACjC,UAAU,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,oBAAoB,EAAE,UAAU,EAAE,SAAS,EAAE;aACrF;SACF,CAAC;QAEF,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,kBAAkB,EAAE,wBAAwB,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/session-storage-fd-leak.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-storage-fd-leak.test.d.ts.map

package/dist/core/session-storage-fd-leak.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-storage-fd-leak.test.d.ts","sourceRoot":"","sources":["../../src/core/session-storage-fd-leak.test.ts"],"names":[],"mappings":""}

package/dist/core/session-storage-fd-leak.test.js

@@ -0,0 +1,116 @@
+import { execFileSync } from "node:child_process";
+import { createWriteStream } from "node:fs";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { createInterface } from "node:readline";
+import { createGzip } from "node:zlib";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { openSessionReadStream } from "./session-storage.js";
+/**
+ * Regression cover for a file-descriptor leak in archived session reads.
+ *
+ * `openSessionReadStream` returns `source.pipe(createGunzip())`. `.pipe()` does
+ * not propagate destroy() upstream, so tearing down only the returned stream —
+ * the intuitive cleanup, and what the session listing used to do — leaves the
+ * source ReadStream's fd open with no reference able to close it.
+ *
+ * It leaked one fd per archived session per listing, and session listing walks
+ * every session on the machine: a real install was found holding 814 stranded
+ * descriptors across 211 archives. Nothing failed loudly, it just accrued until
+ * the process hit its descriptor ceiling.
+ *
+ * The test asserts on real open descriptors rather than stream state, because
+ * the bug is precisely that the stream object *looks* destroyed while its fd
+ * is not.
+ */
+describe("openSessionReadStream fd hygiene", () => {
+    let dir;
+    let archivePath;
+    const openFdCount = () => {
+        // lsof is POSIX-only; the suite skips elsewhere.
+        const out = execFileSync("lsof", ["-p", String(process.pid)], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        return out.split("\n").filter((line) => line.includes(archivePath)).length;
+    };
+    beforeAll(async () => {
+        dir = await fs.mkdtemp(path.join(os.tmpdir(), "ez-session-fd-"));
+        archivePath = path.join(dir, "leak-probe.jsonl.gz");
+        await new Promise((resolve, reject) => {
+            const gzip = createGzip();
+            const out = createWriteStream(archivePath);
+            out.on("close", () => resolve());
+            out.on("error", reject);
+            gzip.on("error", reject);
+            gzip.pipe(out);
+            gzip.write(`${JSON.stringify({ type: "session", id: "probe" })}\n`);
+            // Comfortably more than the reader consumes, so the early exit is real
+            // and backpressure leaves the source mid-file rather than drained.
+            for (let i = 0; i < 20_000; i++) {
+                gzip.write(`${JSON.stringify({ type: "message", i, pad: "x".repeat(120) })}\n`);
+            }
+            gzip.end();
+        });
+    });
+    afterAll(async () => {
+        await fs.rm(dir, { recursive: true, force: true });
+    });
+    it.skipIf(process.platform === "win32")("leaves no descriptor behind when a partial read stops early", async () => {
+        const before = openFdCount();
+        for (let i = 0; i < 40; i++) {
+            const { stream, close } = await openSessionReadStream(archivePath);
+            const rl = createInterface({ input: stream, crlfDelay: Infinity });
+            try {
+                let lines = 0;
+                for await (const _line of rl) {
+                    if (++lines > 5)
+                        break;
+                }
+            }
+            finally {
+                rl.close();
+                close();
+            }
+        }
+        // Destroy is synchronous to request but the 'close' event is not.
+        await new Promise((resolve) => setTimeout(resolve, 500));
+        expect(openFdCount()).toBe(before);
+    });
+    it.skipIf(process.platform === "win32")("leaves no descriptor behind when the whole archive is read", async () => {
+        const before = openFdCount();
+        for (let i = 0; i < 10; i++) {
+            const { stream, close } = await openSessionReadStream(archivePath);
+            const rl = createInterface({ input: stream, crlfDelay: Infinity });
+            try {
+                for await (const _line of rl) {
+                    // Drain.
+                }
+            }
+            finally {
+                rl.close();
+                close(); // Idempotent after a natural end-of-stream.
+            }
+        }
+        await new Promise((resolve) => setTimeout(resolve, 500));
+        expect(openFdCount()).toBe(before);
+    });
+    it("yields the archive's decompressed contents", async () => {
+        const { stream, close } = await openSessionReadStream(archivePath);
+        const rl = createInterface({ input: stream, crlfDelay: Infinity });
+        let header;
+        try {
+            for await (const line of rl) {
+                header = JSON.parse(line);
+                break;
+            }
+        }
+        finally {
+            rl.close();
+            close();
+        }
+        expect(header).toEqual({ type: "session", id: "probe" });
+    });
+});
+//# sourceMappingURL=session-storage-fd-leak.test.js.map

package/dist/core/session-storage-fd-leak.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-storage-fd-leak.test.js","sourceRoot":"","sources":["../../src/core/session-storage-fd-leak.test.ts"],"names":[],"mappings":"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"}

package/dist/core/session-storage.d.ts

@@ -7,8 +7,8 @@ export declare const SESSION_MEDIA_MARKER_VERSION = 1;
 export declare const SESSION_PLAIN_SUFFIX = ".jsonl";
 export declare const SESSION_ARCHIVE_SUFFIX = ".jsonl.gz";
 export declare const SESSION_ASSET_SUFFIX = ".jsonl.assets";
-export declare const SESSION_TEMP_MARKER = ".gg-session-tmp-";
-declare const REDIRECT_TYPE = "gg_session_redirect";
+export declare const SESSION_TEMP_MARKER = ".ez-session-tmp-";
+declare const REDIRECT_TYPE = "ez_session_redirect";
 export interface SessionRedirect {
     type: typeof REDIRECT_TYPE;
     version: typeof SESSION_REDIRECT_VERSION;
@@ -41,9 +41,29 @@ export declare function sessionGroupPaths(filePath: string): {
 export declare function temporarySiblingPath(filePath: string): string;
 export declare function resolveSessionPath(filePath: string): Promise<string>;
 export declare function isGzipSessionPath(filePath: string): Promise<boolean>;
+/**
+ * Open a session transcript for reading, transparently gunzipping archives.
+ *
+ * Returns `close()` alongside the stream because tearing down a gzip read is a
+ * trap: `source.pipe(gunzip)` leaves the source unreachable, and `.pipe()` does
+ * NOT propagate destroy() upstream. Destroying only the returned stream — the
+ * intuitive cleanup — severs the pipe before the source can be torn down and
+ * orphans its file descriptor forever.
+ *
+ * Measured on the shipped Node 22.12 runtime, 100 partial reads:
+ *   destroy(gunzip) only ....... 10 leaked fds
+ *   destroy(gunzip) + source ... 0 leaked fds
+ *
+ * A bare `break` out of `for await` is safe on its own (readline's iterator
+ * return() tears down the whole chain), but any explicit teardown must go
+ * through `close()` so both ends are destroyed together. Callers that stop
+ * early should always call it; destroy() is idempotent, so calling it after a
+ * natural end-of-stream is harmless.
+ */
 export declare function openSessionReadStream(filePath: string): Promise<{
     path: string;
     stream: Readable;
+    close: () => void;
 }>;
 export declare function thawSessionArchive(filePath: string): Promise<string>;
 export declare function normalizeSessionEntryForStorage<T>(entry: T, sessionPath: string, metrics?: StorageNormalizationMetrics): Promise<T | null>;

package/dist/core/session-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-storage.d.ts","sourceRoot":"","sources":["../../src/core/session-storage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-storage.d.ts","sourceRoot":"","sources":["../../src/core/session-storage.ts"],"names":[],"mappings":"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"}

package/dist/core/session-storage.js

@@ -13,9 +13,9 @@ export const SESSION_MEDIA_MARKER_VERSION = 1;
 export const SESSION_PLAIN_SUFFIX = ".jsonl";
 export const SESSION_ARCHIVE_SUFFIX = ".jsonl.gz";
 export const SESSION_ASSET_SUFFIX = ".jsonl.assets";
-export const SESSION_TEMP_MARKER = ".gg-session-tmp-";
-const REDIRECT_TYPE = "gg_session_redirect";
-const MEDIA_MARKER_PREFIX = `gg-session-asset:v${SESSION_MEDIA_MARKER_VERSION}:`;
+export const SESSION_TEMP_MARKER = ".ez-session-tmp-";
+const REDIRECT_TYPE = "ez_session_redirect";
+const MEDIA_MARKER_PREFIX = `ez-session-asset:v${SESSION_MEDIA_MARKER_VERSION}:`;
 const SHA256_PATTERN = /^[a-f0-9]{64}$/;
 const MAX_REDIRECT_BYTES = 4096;
 export function emptyStorageNormalizationMetrics() {
@@ -112,13 +112,40 @@ export async function isGzipSessionPath(filePath) {
         await handle.close();
     }
 }
+/**
+ * Open a session transcript for reading, transparently gunzipping archives.
+ *
+ * Returns `close()` alongside the stream because tearing down a gzip read is a
+ * trap: `source.pipe(gunzip)` leaves the source unreachable, and `.pipe()` does
+ * NOT propagate destroy() upstream. Destroying only the returned stream — the
+ * intuitive cleanup — severs the pipe before the source can be torn down and
+ * orphans its file descriptor forever.
+ *
+ * Measured on the shipped Node 22.12 runtime, 100 partial reads:
+ *   destroy(gunzip) only ....... 10 leaked fds
+ *   destroy(gunzip) + source ... 0 leaked fds
+ *
+ * A bare `break` out of `for await` is safe on its own (readline's iterator
+ * return() tears down the whole chain), but any explicit teardown must go
+ * through `close()` so both ends are destroyed together. Callers that stop
+ * early should always call it; destroy() is idempotent, so calling it after a
+ * natural end-of-stream is harmless.
+ */
 export async function openSessionReadStream(filePath) {
     const resolved = await resolveSessionPath(filePath);
     const input = createReadStream(resolved);
     if (await isGzipSessionPath(resolved)) {
-        return { path: resolved, stream: input.pipe(createGunzip()) };
+        const stream = input.pipe(createGunzip());
+        return {
+            path: resolved,
+            stream,
+            close: () => {
+                stream.destroy();
+                input.destroy();
+            },
+        };
     }
-    return { path: resolved, stream: input };
+    return { path: resolved, stream: input, close: () => input.destroy() };
 }
 /**
  * Flush a file's contents to disk before it is renamed into place.
@@ -153,12 +180,48 @@ async function syncFile(filePath) {
         await handle.close();
     }
 }
+const WINDOWS_REPLACE_RETRY_CODES = new Set(["EACCES", "EBUSY", "EPERM"]);
+async function retryWindowsReplace(operation) {
+    const maxAttempts = process.platform === "win32" ? 10 : 1;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            await operation();
+            return;
+        }
+        catch (error) {
+            const code = error.code;
+            if (!code || !WINDOWS_REPLACE_RETRY_CODES.has(code) || attempt === maxAttempts)
+                throw error;
+            await new Promise((resolve) => setTimeout(resolve, attempt * 25));
+        }
+    }
+}
+async function replaceFile(tempPath, filePath) {
+    try {
+        await retryWindowsReplace(() => fs.rename(tempPath, filePath));
+    }
+    catch (error) {
+        const code = error.code;
+        if (process.platform !== "win32" || !code || !WINDOWS_REPLACE_RETRY_CODES.has(code)) {
+            throw error;
+        }
+        // Windows cannot atomically replace some existing/open files. Once the
+        // destination lock clears, remove the old copy and install the durable temp.
+        await retryWindowsReplace(async () => {
+            await fs.unlink(filePath).catch((unlinkError) => {
+                if (unlinkError.code !== "ENOENT")
+                    throw unlinkError;
+            });
+        });
+        await retryWindowsReplace(() => fs.rename(tempPath, filePath));
+    }
+}
 async function atomicWrite(filePath, content) {
     const tempPath = temporarySiblingPath(filePath);
     try {
         await fs.writeFile(tempPath, content, { encoding: "utf8", flag: "wx" });
         await syncFile(tempPath);
-        await fs.rename(tempPath, filePath);
+        await replaceFile(tempPath, filePath);
     }
     finally {
         await fs.unlink(tempPath).catch(() => { });
@@ -235,7 +298,7 @@ export async function thawSessionArchive(filePath) {
         if (after.size !== before.size || after.mtimeMs !== before.mtimeMs) {
             throw new Error(`Session archive changed while thawing: ${archivePath}`);
         }
-        await fs.rename(tempPath, plainPath);
+        await replaceFile(tempPath, plainPath);
         await fs.utimes(plainPath, before.atime, before.mtime);
         await writeRedirect(archivePath, plainPath);
         return plainPath;
@@ -258,7 +321,7 @@ function mediaMarker(sha256) {
     return `${MEDIA_MARKER_PREFIX}${sha256}`;
 }
 function parseMediaMarker(value) {
-    if (typeof value !== "string" || !value.startsWith("gg-session-asset:"))
+    if (typeof value !== "string" || !value.startsWith("ez-session-asset:"))
         return null;
     if (!value.startsWith(MEDIA_MARKER_PREFIX))
         return { valid: false };
@@ -544,7 +607,7 @@ export async function archiveColdSession(sessionPath) {
         if (after.size !== before.size || after.mtimeMs !== before.mtimeMs) {
             throw new Error(`Session changed while archiving: ${plainPath}`);
         }
-        await fs.rename(gzipTemp, archivePath);
+        await replaceFile(gzipTemp, archivePath);
         await fs.utimes(archivePath, before.atime, before.mtime);
         await writeRedirect(plainPath, archivePath);
         const archiveStat = await fs.stat(archivePath);