@pi-harness/pi-harness 0.1.90 → 0.1.92

package/packages/api-gateway/src/index.ts

@@ -2303,6 +2303,15 @@ export default {
             sendJson(response, 400, { error: "Invalid session path" });
             return;
           }
+          // Pi defers creating a JSONL file for a new empty session until its first assistant response. A duplicate is still a durable action, so materialize the active session before listing it; missing non-active paths remain a 404.
+          if (sourcePath === services.runtime.session.sessionFile && !existsSync(sourcePath)) {
+            try {
+              persistSessionBeforeFirstAssistant(manager);
+            } catch (error) {
+              // Another tab may win the first-persistence race between existsSync and writeFileSync; its file is the same fork source, so continue with the list.
+              if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error;
+            }
+          }
           const sessions = await SessionManager.list(activeCwd(services), manager.getSessionDir());
           const source = sessions.find((item) => item.path === sourcePath);
           if (!source) {
@@ -2397,6 +2406,15 @@ export default {
             sendJson(response, 400, { error: "Invalid session path" });
             return;
           }
+          // Pi defers creating the JSONL file for a new empty session until its first entry. Exporting that active session is still a durable user action, so materialize its in-memory header and entries before reading it; missing non-active paths remain a 404.
+          if (path === services.runtime.session.sessionFile && !existsSync(path)) {
+            try {
+              persistSessionBeforeFirstAssistant(manager);
+            } catch (error) {
+              // Another tab may win the first-persistence race between existsSync and writeFileSync; its file is the same export target, so continue with the read.
+              if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error;
+            }
+          }
           const content = await readFile(path, "utf8");
           response.writeHead(200, {
             "content-type": "application/x-ndjson; charset=utf-8",

package/packages/api-gateway/test/index.test.ts

@@ -2093,6 +2093,51 @@ describe("API gateway plugin", () => {
     expect(sessionPayload.items).toEqual(expect.arrayContaining([expect.objectContaining({ sessionId: fork.sessionId, forked: true })]));
   });
 
+  test("forks an empty active session before its JSONL file is created", async () => {
+    const context = new Context();
+    contexts.push(context);
+    await context.plugin(webServerPlugin, { host: "127.0.0.1", port: 0 });
+    const directory = await mkdtemp(join(tmpdir(), "pi-harness-api-active-empty-fork-"));
+    temporaryDirectories.push(directory);
+    const launchCwd = join(directory, "launch");
+    const activeCwd = join(directory, "active");
+    const manager = SessionManager.create(activeCwd, directory);
+    const sourcePath = manager.getSessionFile();
+    expect(sourcePath).toBeDefined();
+    const session = {
+      get sessionId() {
+        return manager.getSessionId();
+      },
+      get sessionFile() {
+        return manager.getSessionFile();
+      },
+      get messages() {
+        return manager.buildSessionContext().messages;
+      },
+      isStreaming: false,
+      sessionManager: manager,
+      subscribe: () => () => {},
+    };
+    context.provide("piRuntime", { session, sessionRuntime: { cwd: activeCwd }, prompt: () => Promise.resolve() } as never);
+    context.provide("piModels", { model: { provider: "test", id: "model" } } as never);
+    context.provide("piHarnessLaunch", { cwd: launchCwd, agentDir: directory, args: [], requestExit() {} });
+    await context.plugin(apiPlugin);
+
+    const response = await fetch(context.webServer.url + "/api/session/fork", {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ path: sourcePath }),
+    });
+
+    expect(response.status).toBe(200);
+    const fork = (await response.json()) as { sessionId: string; sessionFile?: string; cwd: string };
+    expect(fork).toMatchObject({ cwd: activeCwd });
+    expect(fork.sessionFile).toBeDefined();
+    expect(fork.sessionFile).not.toBe(sourcePath);
+    const sourceContent = await readFile(sourcePath ?? "", "utf8");
+    expect(sourceContent).toContain('"type":"session"');
+  });
+
   test("opens a forked persisted session from the session list and exposes its relationship", async () => {
     const context = new Context();
     contexts.push(context);
@@ -3805,6 +3850,39 @@ describe("API gateway plugin", () => {
     await expect(stat(target)).rejects.toMatchObject({ code: "ENOENT" });
   });
 
+  test("exports an empty active session by persisting its in-memory header", async () => {
+    const context = new Context();
+    contexts.push(context);
+    const directory = await mkdtemp(join(tmpdir(), "pi-harness-api-empty-session-export-"));
+    temporaryDirectories.push(directory);
+    const sessionDir = join(directory, "sessions");
+    await mkdir(sessionDir);
+    await context.plugin(webServerPlugin, { host: "127.0.0.1", port: 0 });
+    const manager = SessionManager.create("/tmp", sessionDir);
+    const target = manager.getSessionFile();
+    if (!target) throw new Error("Expected a new session path");
+    const session = {
+      sessionId: manager.getSessionId(),
+      get sessionFile() {
+        return manager.getSessionFile();
+      },
+      messages: [],
+      isStreaming: false,
+      sessionManager: manager,
+      subscribe: () => () => {},
+    };
+    context.provide("piRuntime", { session, prompt: () => Promise.resolve() } as never);
+    context.provide("piModels", { model: { provider: "test", id: "model" } } as never);
+    context.provide("piHarnessLaunch", { cwd: "/tmp", agentDir: "/tmp/agent", args: [], requestExit() {} });
+    await context.plugin(apiPlugin);
+
+    const response = await fetch(context.webServer.url + "/api/session/export");
+    expect(response.status).toBe(200);
+    expect(response.headers.get("content-type")).toContain("application/x-ndjson");
+    expect(await response.text()).toContain('"type":"session"');
+    await expect(stat(target)).resolves.toBeDefined();
+  });
+
   test("keeps batch deletion going past a failing session and persists the metadata it did remove", async () => {
     const context = new Context();
     contexts.push(context);

package/packages/bundle-web-app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/web-app",
-  "version": "0.1.90",
+  "version": "0.1.92",
   "private": true,
   "description": "Patchable Web application bundle for Pi Harness",
   "homepage": "https://github.com/pi-harness/pi-harness#readme",

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/cli",
-  "version": "0.1.90",
+  "version": "0.1.92",
   "private": true,
   "description": "Plugin-first Pi Harness CLI",
   "homepage": "https://github.com/pi-harness/pi-harness#readme",

package/packages/host-webserver/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/host-webserver",
-  "version": "0.1.90",
+  "version": "0.1.92",
   "private": true,
   "description": "Cordis route-registration service for the Pi Harness web host",
   "homepage": "https://github.com/pi-harness/pi-harness#readme",