@paigy/harness 0.3.16 → 0.3.17

package/dist/cli.js

@@ -25059,7 +25059,13 @@ var init_dist = __esm({
          *  request Entry's author, as the same three facts the item's own `tokenId`/`name`/`voice`
          *  carry for the call's one agent, so the phone draws it with the same seed. Absent when the
          *  author is not an agent this account holds (unpaired since, or a person). */
-        agent: external_exports.object({ tokenId: external_exports.string(), name: external_exports.string(), voice: VoiceKeySchema.optional() }).optional()
+        agent: external_exports.object({ tokenId: external_exports.string(), name: external_exports.string(), voice: VoiceKeySchema.optional() }).optional(),
+        /** ITS OPTIONS, WHEN THERE IS SOMETHING TO SEE (owner, 2026-09-25: "Yes, add it"): the options
+         *  its need offers, exactly as its own card carries them, present only when one of them has a
+         *  preview (`html` or `image`). The call screen opens them from the agenda row, so a preview is
+         *  never re-sent as a second card to be seen mid-call. Words-only options are absent — the bot
+         *  says those, and the list stays small (an `html` is up to 16 KB). */
+        options: external_exports.array(OptionSchema).optional()
       })).optional(),
       visuals: external_exports.array(VisualSchema).optional(),
       /** The connected agent's name (the single pairing name — user-typed, or the
@@ -30926,6 +30932,7 @@ import { resolve, delimiter as delimiter2 } from "path";
 
 // src/harness/acp.ts
 var none = { events: [], writes: [] };
+var NOTHING_TO_RESUME = /* @__PURE__ */ new Set([-32002, -32601]);
 function optionFor(options, decision) {
   const want = decision.allow ? "allow_once" : "reject_once";
   return options.find((o) => o.kind === want)?.optionId ?? null;
@@ -31022,20 +31029,29 @@ var AcpDriver = class {
     if (msg.id === this.initId) {
       this.initId = void 0;
       if (msg.error) {
-        return { events: [{ kind: "error", message: `initialize failed: ${msg.error.message}` }], writes: [] };
+        return { events: [{ kind: "error", message: `initialize failed: ${msg.error.message}`, fatal: true }], writes: [] };
       }
       this.sessionNewId = this.nextId++;
       return {
         events: [],
-        writes: [frame2(this.resume ? { id: this.sessionNewId, method: "session/resume", params: { sessionId: this.resume, cwd: this.cwd, mcpServers: [] } } : { id: this.sessionNewId, method: "session/new", params: { cwd: this.cwd, mcpServers: [] } })]
+        writes: [frame2(this.resume ? { id: this.sessionNewId, method: "session/resume", params: { sessionId: this.resume, cwd: this.cwd, mcpServers: [] } } : this.sessionNew(this.sessionNewId))]
       };
     }
     if (msg.id === this.sessionNewId) {
       this.sessionNewId = void 0;
+      const resuming = this.resume !== void 0;
+      if (resuming && msg.error?.code !== void 0 && NOTHING_TO_RESUME.has(msg.error.code)) {
+        this.resume = void 0;
+        this.sessionNewId = this.nextId++;
+        return {
+          events: [{ kind: "error", message: `session/resume found nothing to resume (${msg.error.message}) \u2014 opening a new conversation` }],
+          writes: [frame2(this.sessionNew(this.sessionNewId))]
+        };
+      }
       const sessionId2 = msg.error ? void 0 : msg.result?.sessionId ?? this.resume;
       if (!sessionId2) {
         return {
-          events: [{ kind: "error", message: `${this.resume ? "session/resume" : "session/new"} failed: ${msg.error?.message ?? "no sessionId"}` }],
+          events: [{ kind: "error", message: `${resuming ? "session/resume" : "session/new"} failed: ${msg.error?.message ?? "no sessionId"}`, fatal: true }],
           writes: []
         };
       }
@@ -31128,6 +31144,9 @@ var AcpDriver = class {
       writes: []
     };
   }
+  sessionNew(id) {
+    return { id, method: "session/new", params: { cwd: this.cwd, mcpServers: [] } };
+  }
   /** Send the queued prompts as one turn, if the agent can take one right now. */
   flush() {
     if (!this.sessionId || this.promptId !== void 0 || !this.queued.length) return [];
@@ -31173,7 +31192,7 @@ function startSession(opts) {
       ...process.env,
       PATH: [process.env.PATH, ...probeDirs()].filter(Boolean).join(delimiter2),
       ...opts.token ? { PAIGY_TOKEN: opts.token } : {},
-      ...opts.resume ? { PAIGY_SESSION_ID: opts.resume } : {},
+      ...opts.resume ?? opts.session ? { PAIGY_SESSION_ID: opts.resume ?? opts.session } : {},
       // A PUMP DRIVES THIS PROCESS (2026-09-22, #2265): every run `runHarness` starts has the
       // bridge's pump typing answers in, so nothing inside it may start a second delivery path.
       // Exported on EVERY spawn — `PAIGY_SESSION_ID` above is the conversation to resume, and a
@@ -31183,7 +31202,11 @@ function startSession(opts) {
     },
     stdio: ["pipe", "pipe", "pipe"]
   });
+  let ended2 = false;
+  child.stdin?.on("error", () => {
+  });
   const write = (frames) => {
+    if (ended2) return;
     for (const f of frames) child.stdin?.write(`${f}
 `);
   };
@@ -31192,6 +31215,7 @@ function startSession(opts) {
     if (text) opts.onEvent({ kind: "error", message: text });
   });
   child.on("exit", (code) => {
+    ended2 = true;
     opts.onEvent({ kind: "idle", failed: code !== 0, ...code ? { result: `exited ${code}` } : {} });
     opts.onExit?.();
   });
@@ -31220,6 +31244,7 @@ function startSession(opts) {
     },
     stop() {
       write(driver.close());
+      ended2 = true;
       child.kill();
     }
   };
@@ -33067,7 +33092,13 @@ var InboxItemSchema2 = external_exports.object({
      *  request Entry's author, as the same three facts the item's own `tokenId`/`name`/`voice`
      *  carry for the call's one agent, so the phone draws it with the same seed. Absent when the
      *  author is not an agent this account holds (unpaired since, or a person). */
-    agent: external_exports.object({ tokenId: external_exports.string(), name: external_exports.string(), voice: VoiceKeySchema2.optional() }).optional()
+    agent: external_exports.object({ tokenId: external_exports.string(), name: external_exports.string(), voice: VoiceKeySchema2.optional() }).optional(),
+    /** ITS OPTIONS, WHEN THERE IS SOMETHING TO SEE (owner, 2026-09-25: "Yes, add it"): the options
+     *  its need offers, exactly as its own card carries them, present only when one of them has a
+     *  preview (`html` or `image`). The call screen opens them from the agenda row, so a preview is
+     *  never re-sent as a second card to be seen mid-call. Words-only options are absent — the bot
+     *  says those, and the list stays small (an `html` is up to 16 KB). */
+    options: external_exports.array(OptionSchema2).optional()
   })).optional(),
   visuals: external_exports.array(VisualSchema2).optional(),
   /** The connected agent's name (the single pairing name — user-typed, or the
@@ -33900,6 +33931,23 @@ async function finish(result, state, rail, opts) {
     opts?.log?.(`\u26A0 finish contact failed: ${error.message}`);
   }
 }
+async function failedToStart(reason, state, rail, opts) {
+  try {
+    const goalId = state.goal?.id ?? (await rail.claim()).goalId;
+    state.goal = void 0;
+    state.resting = true;
+    if (!goalId) return;
+    await rail.contact({
+      asks: [{ ask: `The session could not start, so nothing is working on this yet.
+
+${reason}`, parentId: goalId }],
+      waiting: "none",
+      channel: "notification"
+    });
+  } catch (error) {
+    opts?.log?.(`\u26A0 could not report the failed start: ${error.message}`);
+  }
+}
 async function afterTurn(event, state, rail, opts) {
   if (!event.failed && !endsWithQuestion(event.result)) {
     await finish(event.result, state, rail, opts);
@@ -33924,10 +33972,16 @@ function runHarness(opts) {
   let tail = [];
   const state = { resting: true };
   let session = null;
-  const rail = railFor({ token: opts.token, ...opts.resume ? { reach: reachAs(opts.resume) } : {} });
+  const speaksAs = opts.resume ?? opts.session;
+  const rail = railFor({ token: opts.token, ...speaksAs ? { reach: reachAs(speaksAs) } : {} });
   async function handle(event) {
     if (event.kind === "error") {
       opts.log(`\u26A0 ${event.message}`);
+      if (event.fatal && running) {
+        opts.log(`\u2716 could not start: ${event.message}`);
+        await failedToStart(event.message, state, rail, { log: opts.log });
+        stop2();
+      }
       return;
     }
     if (event.kind === "permission") {
@@ -33973,6 +34027,7 @@ function runHarness(opts) {
     mode: opts.mode,
     ...opts.token ? { token: opts.token } : {},
     ...opts.resume ? { resume: opts.resume } : {},
+    ...opts.session ? { session: opts.session } : {},
     ...opts.bin ? { bin: opts.bin } : {},
     ...opts.onExit ? { onExit: opts.onExit } : {},
     onEvent: (event) => void handle(event).catch((err) => opts.log(`\u26A0 ${err.message}`))
@@ -33981,20 +34036,21 @@ function runHarness(opts) {
     (e) => opts.log(`\u26A0 conversation loop stopped: ${e.message}`)
   );
   opts.log(`\u25B6 started ${opts.harness} in ${opts.cwd} (${opts.mode} mode)`);
+  function stop2() {
+    running = false;
+    tail = [];
+    cancelAsks(state);
+    session?.stop();
+    session = null;
+    opts.log("\u25A0 stopped");
+  }
   return {
     send(text) {
       session?.send(text);
     },
     working: () => running && state.resting !== true,
     tail: () => [...tail],
-    stop() {
-      running = false;
-      tail = [];
-      cancelAsks(state);
-      session?.stop();
-      session = null;
-      opts.log("\u25A0 stopped");
-    }
+    stop: stop2
   };
 }
 
@@ -34185,6 +34241,7 @@ var claimedRun = (sessionId2) => {
   const slot = sessionSlot(sessionId2);
   return { slot, key: runKey(slot) };
 };
+var launchRun = (spec) => ({ session: spec.sessionId });
 async function slotHasWaitingWork(token, session) {
   return (await checkReplies({ token, ...session ? { reach: reachAs(session) } : {} })).deliveries.length > 0;
 }
@@ -34243,7 +34300,7 @@ function startHost(opts) {
         mode: "bypass",
         prompt: "",
         token: spec.token,
-        resume: spec.sessionId,
+        ...launchRun(spec),
         onExit: () => {
           runs.delete(key);
           opts.log(`\u2716 ${label} ended`);
@@ -34799,7 +34856,11 @@ async function main() {
   if (parsed.hatch) {
     overrideToken(readToken("Desktop") || null);
     const minted = await hatch(parsed.hatch, parsed.voice ?? null);
-    saveToken({ access_token: minted.token, name: minted.name, device: null }, parsed.slot ?? minted.name);
+    saveToken({ access_token: minted.token, name: minted.name ?? parsed.hatch, device: null }, parsed.slot ?? minted.name ?? parsed.hatch);
+    if (!minted.name) {
+      console.log(`\u2713 hatched, unnamed \u2014 you already have an agent called "${parsed.hatch}". Pick another name in the app's Agents screen.`);
+      return;
+    }
     console.log(`\u2713 hatched "${minted.name}" \u2014 it's on your phone's Agents screen now.`);
     console.log(`  speak as it:  PAIGY_AGENT="${minted.name}" <any paigy tool>`);
     console.log(`  run with it:  paigy-harness --identity "${minted.name}" --harness codex "\u2026"`);

package/dist/main.js

@@ -10449,7 +10449,13 @@ var InboxItemSchema = external_exports.object({
      *  request Entry's author, as the same three facts the item's own `tokenId`/`name`/`voice`
      *  carry for the call's one agent, so the phone draws it with the same seed. Absent when the
      *  author is not an agent this account holds (unpaired since, or a person). */
-    agent: external_exports.object({ tokenId: external_exports.string(), name: external_exports.string(), voice: VoiceKeySchema.optional() }).optional()
+    agent: external_exports.object({ tokenId: external_exports.string(), name: external_exports.string(), voice: VoiceKeySchema.optional() }).optional(),
+    /** ITS OPTIONS, WHEN THERE IS SOMETHING TO SEE (owner, 2026-09-25: "Yes, add it"): the options
+     *  its need offers, exactly as its own card carries them, present only when one of them has a
+     *  preview (`html` or `image`). The call screen opens them from the agenda row, so a preview is
+     *  never re-sent as a second card to be seen mid-call. Words-only options are absent — the bot
+     *  says those, and the list stays small (an `html` is up to 16 KB). */
+    options: external_exports.array(OptionSchema).optional()
   })).optional(),
   visuals: external_exports.array(VisualSchema).optional(),
   /** The connected agent's name (the single pairing name — user-typed, or the
@@ -13572,7 +13578,13 @@ var InboxItemSchema2 = external_exports.object({
      *  request Entry's author, as the same three facts the item's own `tokenId`/`name`/`voice`
      *  carry for the call's one agent, so the phone draws it with the same seed. Absent when the
      *  author is not an agent this account holds (unpaired since, or a person). */
-    agent: external_exports.object({ tokenId: external_exports.string(), name: external_exports.string(), voice: VoiceKeySchema2.optional() }).optional()
+    agent: external_exports.object({ tokenId: external_exports.string(), name: external_exports.string(), voice: VoiceKeySchema2.optional() }).optional(),
+    /** ITS OPTIONS, WHEN THERE IS SOMETHING TO SEE (owner, 2026-09-25: "Yes, add it"): the options
+     *  its need offers, exactly as its own card carries them, present only when one of them has a
+     *  preview (`html` or `image`). The call screen opens them from the agenda row, so a preview is
+     *  never re-sent as a second card to be seen mid-call. Words-only options are absent — the bot
+     *  says those, and the list stays small (an `html` is up to 16 KB). */
+    options: external_exports.array(OptionSchema2).optional()
   })).optional(),
   visuals: external_exports.array(VisualSchema2).optional(),
   /** The connected agent's name (the single pairing name — user-typed, or the
@@ -14173,6 +14185,7 @@ import { resolve as resolve2, delimiter as delimiter2 } from "path";
 
 // src/harness/acp.ts
 var none = { events: [], writes: [] };
+var NOTHING_TO_RESUME = /* @__PURE__ */ new Set([-32002, -32601]);
 function optionFor(options, decision) {
   const want = decision.allow ? "allow_once" : "reject_once";
   return options.find((o) => o.kind === want)?.optionId ?? null;
@@ -14269,20 +14282,29 @@ var AcpDriver = class {
     if (msg.id === this.initId) {
       this.initId = void 0;
       if (msg.error) {
-        return { events: [{ kind: "error", message: `initialize failed: ${msg.error.message}` }], writes: [] };
+        return { events: [{ kind: "error", message: `initialize failed: ${msg.error.message}`, fatal: true }], writes: [] };
       }
       this.sessionNewId = this.nextId++;
       return {
         events: [],
-        writes: [frame2(this.resume ? { id: this.sessionNewId, method: "session/resume", params: { sessionId: this.resume, cwd: this.cwd, mcpServers: [] } } : { id: this.sessionNewId, method: "session/new", params: { cwd: this.cwd, mcpServers: [] } })]
+        writes: [frame2(this.resume ? { id: this.sessionNewId, method: "session/resume", params: { sessionId: this.resume, cwd: this.cwd, mcpServers: [] } } : this.sessionNew(this.sessionNewId))]
       };
     }
     if (msg.id === this.sessionNewId) {
       this.sessionNewId = void 0;
+      const resuming = this.resume !== void 0;
+      if (resuming && msg.error?.code !== void 0 && NOTHING_TO_RESUME.has(msg.error.code)) {
+        this.resume = void 0;
+        this.sessionNewId = this.nextId++;
+        return {
+          events: [{ kind: "error", message: `session/resume found nothing to resume (${msg.error.message}) \u2014 opening a new conversation` }],
+          writes: [frame2(this.sessionNew(this.sessionNewId))]
+        };
+      }
       const sessionId2 = msg.error ? void 0 : msg.result?.sessionId ?? this.resume;
       if (!sessionId2) {
         return {
-          events: [{ kind: "error", message: `${this.resume ? "session/resume" : "session/new"} failed: ${msg.error?.message ?? "no sessionId"}` }],
+          events: [{ kind: "error", message: `${resuming ? "session/resume" : "session/new"} failed: ${msg.error?.message ?? "no sessionId"}`, fatal: true }],
           writes: []
         };
       }
@@ -14375,6 +14397,9 @@ var AcpDriver = class {
       writes: []
     };
   }
+  sessionNew(id) {
+    return { id, method: "session/new", params: { cwd: this.cwd, mcpServers: [] } };
+  }
   /** Send the queued prompts as one turn, if the agent can take one right now. */
   flush() {
     if (!this.sessionId || this.promptId !== void 0 || !this.queued.length) return [];
@@ -14419,7 +14444,7 @@ function startSession(opts) {
       ...process.env,
       PATH: [process.env.PATH, ...probeDirs()].filter(Boolean).join(delimiter2),
       ...opts.token ? { PAIGY_TOKEN: opts.token } : {},
-      ...opts.resume ? { PAIGY_SESSION_ID: opts.resume } : {},
+      ...opts.resume ?? opts.session ? { PAIGY_SESSION_ID: opts.resume ?? opts.session } : {},
       // A PUMP DRIVES THIS PROCESS (2026-09-22, #2265): every run `runHarness` starts has the
       // bridge's pump typing answers in, so nothing inside it may start a second delivery path.
       // Exported on EVERY spawn — `PAIGY_SESSION_ID` above is the conversation to resume, and a
@@ -14429,7 +14454,11 @@ function startSession(opts) {
     },
     stdio: ["pipe", "pipe", "pipe"]
   });
+  let ended2 = false;
+  child.stdin?.on("error", () => {
+  });
   const write = (frames) => {
+    if (ended2) return;
     for (const f of frames) child.stdin?.write(`${f}
 `);
   };
@@ -14438,6 +14467,7 @@ function startSession(opts) {
     if (text) opts.onEvent({ kind: "error", message: text });
   });
   child.on("exit", (code) => {
+    ended2 = true;
     opts.onEvent({ kind: "idle", failed: code !== 0, ...code ? { result: `exited ${code}` } : {} });
     opts.onExit?.();
   });
@@ -14466,6 +14496,7 @@ function startSession(opts) {
     },
     stop() {
       write(driver.close());
+      ended2 = true;
       child.kill();
     }
   };
@@ -14708,6 +14739,23 @@ async function finish(result, state, rail, opts) {
     opts?.log?.(`\u26A0 finish contact failed: ${error.message}`);
   }
 }
+async function failedToStart(reason, state, rail, opts) {
+  try {
+    const goalId = state.goal?.id ?? (await rail.claim()).goalId;
+    state.goal = void 0;
+    state.resting = true;
+    if (!goalId) return;
+    await rail.contact({
+      asks: [{ ask: `The session could not start, so nothing is working on this yet.
+
+${reason}`, parentId: goalId }],
+      waiting: "none",
+      channel: "notification"
+    });
+  } catch (error) {
+    opts?.log?.(`\u26A0 could not report the failed start: ${error.message}`);
+  }
+}
 async function afterTurn(event, state, rail, opts) {
   if (!event.failed && !endsWithQuestion(event.result)) {
     await finish(event.result, state, rail, opts);
@@ -14732,10 +14780,16 @@ function runHarness(opts) {
   let tail = [];
   const state = { resting: true };
   let session = null;
-  const rail = railFor({ token: opts.token, ...opts.resume ? { reach: reachAs(opts.resume) } : {} });
+  const speaksAs = opts.resume ?? opts.session;
+  const rail = railFor({ token: opts.token, ...speaksAs ? { reach: reachAs(speaksAs) } : {} });
   async function handle(event) {
     if (event.kind === "error") {
       opts.log(`\u26A0 ${event.message}`);
+      if (event.fatal && running) {
+        opts.log(`\u2716 could not start: ${event.message}`);
+        await failedToStart(event.message, state, rail, { log: opts.log });
+        stop2();
+      }
       return;
     }
     if (event.kind === "permission") {
@@ -14781,6 +14835,7 @@ function runHarness(opts) {
     mode: opts.mode,
     ...opts.token ? { token: opts.token } : {},
     ...opts.resume ? { resume: opts.resume } : {},
+    ...opts.session ? { session: opts.session } : {},
     ...opts.bin ? { bin: opts.bin } : {},
     ...opts.onExit ? { onExit: opts.onExit } : {},
     onEvent: (event) => void handle(event).catch((err) => opts.log(`\u26A0 ${err.message}`))
@@ -14789,20 +14844,21 @@ function runHarness(opts) {
     (e) => opts.log(`\u26A0 conversation loop stopped: ${e.message}`)
   );
   opts.log(`\u25B6 started ${opts.harness} in ${opts.cwd} (${opts.mode} mode)`);
+  function stop2() {
+    running = false;
+    tail = [];
+    cancelAsks(state);
+    session?.stop();
+    session = null;
+    opts.log("\u25A0 stopped");
+  }
   return {
     send(text) {
       session?.send(text);
     },
     working: () => running && state.resting !== true,
     tail: () => [...tail],
-    stop() {
-      running = false;
-      tail = [];
-      cancelAsks(state);
-      session?.stop();
-      session = null;
-      opts.log("\u25A0 stopped");
-    }
+    stop: stop2
   };
 }
 
@@ -14911,6 +14967,7 @@ var claimedRun = (sessionId2) => {
   const slot = sessionSlot(sessionId2);
   return { slot, key: runKey(slot) };
 };
+var launchRun = (spec) => ({ session: spec.sessionId });
 async function slotHasWaitingWork(token, session) {
   return (await checkReplies({ token, ...session ? { reach: reachAs(session) } : {} })).deliveries.length > 0;
 }
@@ -14969,7 +15026,7 @@ function startHost(opts) {
         mode: "bypass",
         prompt: "",
         token: spec.token,
-        resume: spec.sessionId,
+        ...launchRun(spec),
         onExit: () => {
           runs.delete(key);
           opts.log(`\u2716 ${label} ended`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paigy/harness",
-  "version": "0.3.16",
+  "version": "0.3.17",
   "description": "Run Claude Code / Codex on this machine, bridged to Paigy — launchable from your phone.",
   "license": "MIT",
   "type": "module",