agent-board-runner 0.1.20 → 0.1.22

package/dist/cli.js

@@ -572,7 +572,15 @@ async function savePastedImage(sessionId, extCode, bytes) {
   return path;
 }
 function registerPtySession(sessionId, pty, ticket) {
-  const handle = { pty, ticket, outputBuffer: [], sockets: /* @__PURE__ */ new Set(), readOnly: false, exited: false };
+  const handle = {
+    pty,
+    ticket,
+    outputBuffer: [],
+    sockets: /* @__PURE__ */ new Set(),
+    readOnly: false,
+    exited: false,
+    lastAssistantMessage: null
+  };
   pty.onExit(() => {
     handle.exited = true;
   });
@@ -588,6 +596,10 @@ function registerPtySession(sessionId, pty, ticket) {
 function getPtySession(sessionId) {
   return registry.get(sessionId);
 }
+function recordLastAssistantMessage(sessionId, message) {
+  const handle = registry.get(sessionId);
+  if (handle) handle.lastAssistantMessage = message;
+}
 function setPtySessionReadOnly(sessionId, readOnly) {
   const handle = registry.get(sessionId);
   if (handle) handle.readOnly = readOnly;
@@ -1297,10 +1309,10 @@ function detectMoment(input) {
   return null;
 }
 
-function reportToRunner(sessionId, ticket, port, moment) {
+function reportToRunner(sessionId, ticket, port, moment, lastAssistantMessage) {
   return new Promise((resolve) => {
     try {
-      const body = JSON.stringify({ sessionId, ticket, moment });
+      const body = JSON.stringify({ sessionId, ticket, moment, lastAssistantMessage });
       const req = http.request(
         {
           host: "127.0.0.1",
@@ -1349,7 +1361,10 @@ function reportToRunner(sessionId, ticket, port, moment) {
       const sessionId = process.env.AGENT_BOARD_SESSION_ID;
       const ticket = process.env.AGENT_BOARD_STATUSLINE_TICKET;
       const port = Number(process.env.AGENT_BOARD_STATUSLINE_PORT);
-      if (sessionId && ticket && port) await reportToRunner(sessionId, ticket, port, moment);
+      if (sessionId && ticket && port) {
+        const lastAssistantMessage = moment === "turn_stopped" && typeof input.lastAssistantMessage === "string" ? input.lastAssistantMessage : undefined;
+        await reportToRunner(sessionId, ticket, port, moment, lastAssistantMessage);
+      }
     }
   } catch {
     // A malformed/unexpected hook payload must never block the agent's own turn.
@@ -2088,6 +2103,7 @@ async function handleStatuslineReport(req, res, supabase, config) {
     sendJson(res, 500, { error: "Erro interno do runner." });
   }
 }
+var MAX_LAST_ASSISTANT_MESSAGE_CHARS = 4e3;
 async function handleAgentHookReport(req, res) {
   let body;
   try {
@@ -2106,6 +2122,9 @@ async function handleAgentHookReport(req, res) {
     sendJson(res, 403, { error: "Ticket inv\xE1lido para esta sess\xE3o." });
     return;
   }
+  if (typeof body.lastAssistantMessage === "string" && body.lastAssistantMessage.length > 0) {
+    recordLastAssistantMessage(body.sessionId, body.lastAssistantMessage.slice(0, MAX_LAST_ASSISTANT_MESSAGE_CHARS));
+  }
   handleAgentHookEvent(body.sessionId, body.moment);
   res.writeHead(204, { "Access-Control-Allow-Origin": "*" });
   res.end();
@@ -2666,30 +2685,14 @@ import { randomUUID as randomUUID7 } from "node:crypto";
 import { randomUUID as randomUUID6 } from "node:crypto";
 import { spawn as spawn3 } from "node-pty";
 
-// src/sessionName.ts
-var MAX_LENGTH = 60;
-var FALLBACK_NAME = "card";
-function toSessionName(title) {
-  const slug = title.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-  if (slug.length === 0) return FALLBACK_NAME;
-  if (slug.length <= MAX_LENGTH) return slug;
-  const truncated = slug.slice(0, MAX_LENGTH);
-  const lastHyphen = truncated.lastIndexOf("-");
-  return (lastHyphen > 0 ? truncated.slice(0, lastHyphen) : truncated).replace(/-+$/, "");
-}
-
-// src/agentSession.ts
+// src/ptyMessaging.ts
 var TUI_IDLE_MS = 1500;
 var TUI_READY_TIMEOUT_MS = 6e4;
 var PASTE_SETTLE_MS = 200;
 var PASTE_SETTLE_TIMEOUT_MS = 5e3;
 var PASTE_START = "\x1B[200~";
 var PASTE_END = "\x1B[201~";
-var SHIFT_TAB = "\x1B[Z";
-var SHIFT_TAB_PRESSES_TO_PLAN_MODE = 4;
-var SHIFT_TAB_DELAY_MS = 400;
-var PLAN_MODE_INDICATOR = /plan mode on/i;
-function writePasteAndSubmit(pty, cardId, message, context) {
+function writePasteAndSubmit(pty, logId, message, context, log) {
   pty.write(`${PASTE_START}${message}${PASTE_END}`);
   let settleTimer;
   let ceilingTimer;
@@ -2706,7 +2709,7 @@ function writePasteAndSubmit(pty, cardId, message, context) {
     try {
       pty.write("\r");
     } catch (err) {
-      logger.card.error(cardId, `Failed to submit ${context} to the agent:`, err);
+      log.error(logId, `Failed to submit ${context} to the agent:`, err);
     }
   };
   const cancel = () => {
@@ -2724,6 +2727,48 @@ function writePasteAndSubmit(pty, cardId, message, context) {
   ceilingTimer = setTimeout(submit, PASTE_SETTLE_TIMEOUT_MS);
   exitSubscription = pty.onExit(cancel);
 }
+function waitForIdleThenRun(pty, run) {
+  let idleTimer;
+  let deadlineTimer;
+  let dataSubscription;
+  let settled = false;
+  const stopWaiting = () => {
+    if (settled) return false;
+    settled = true;
+    clearTimeout(idleTimer);
+    clearTimeout(deadlineTimer);
+    dataSubscription?.dispose();
+    return true;
+  };
+  const fire = () => {
+    if (!stopWaiting()) return;
+    void run();
+  };
+  deadlineTimer = setTimeout(fire, TUI_READY_TIMEOUT_MS);
+  dataSubscription = pty.onData(() => {
+    clearTimeout(idleTimer);
+    idleTimer = setTimeout(fire, TUI_IDLE_MS);
+  });
+  pty.onExit(() => stopWaiting());
+}
+
+// src/sessionName.ts
+var MAX_LENGTH = 60;
+var FALLBACK_NAME = "card";
+function toSessionName(title) {
+  const slug = title.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  if (slug.length === 0) return FALLBACK_NAME;
+  if (slug.length <= MAX_LENGTH) return slug;
+  const truncated = slug.slice(0, MAX_LENGTH);
+  const lastHyphen = truncated.lastIndexOf("-");
+  return (lastHyphen > 0 ? truncated.slice(0, lastHyphen) : truncated).replace(/-+$/, "");
+}
+
+// src/agentSession.ts
+var SHIFT_TAB = "\x1B[Z";
+var SHIFT_TAB_PRESSES_TO_PLAN_MODE = 4;
+var SHIFT_TAB_DELAY_MS = 400;
+var PLAN_MODE_INDICATOR = /plan mode on/i;
 function spawnAgentPty(repoPath, cardId, cardTitle, instructions, sessionId, ticket, planFirst) {
   ensureDirTrusted(repoPath);
   ensureMcpServersTrusted(repoPath);
@@ -2751,33 +2796,14 @@ function spawnAgentPty(repoPath, cardId, cardTitle, instructions, sessionId, tic
   return { pty, claudeSessionId };
 }
 function sendMessageWhenIdle(pty, cardId, message, planFirst) {
-  let idleTimer;
-  let deadlineTimer;
-  let dataSubscription;
-  let settled = false;
-  const stopWaiting = () => {
-    if (settled) return false;
-    settled = true;
-    clearTimeout(idleTimer);
-    clearTimeout(deadlineTimer);
-    dataSubscription?.dispose();
-    return true;
-  };
-  const send = async () => {
-    if (!stopWaiting()) return;
+  waitForIdleThenRun(pty, async () => {
     if (planFirst) await enterPlanMode(pty, cardId);
     try {
-      writePasteAndSubmit(pty, cardId, message, "the card instructions");
+      writePasteAndSubmit(pty, cardId, message, "the card instructions", logger.card);
     } catch (err) {
       logger.card.error(cardId, "Failed to send the card instructions to the agent:", err);
     }
-  };
-  deadlineTimer = setTimeout(send, TUI_READY_TIMEOUT_MS);
-  dataSubscription = pty.onData(() => {
-    clearTimeout(idleTimer);
-    idleTimer = setTimeout(send, TUI_IDLE_MS);
   });
-  pty.onExit(() => stopWaiting());
 }
 async function enterPlanMode(pty, cardId) {
   let recentOutput = "";
@@ -2803,7 +2829,7 @@ async function enterPlanMode(pty, cardId) {
 }
 function sendMessageToIdleSession(pty, cardId, message) {
   try {
-    writePasteAndSubmit(pty, cardId, message, "a message");
+    writePasteAndSubmit(pty, cardId, message, "a message", logger.card);
   } catch (err) {
     logger.card.error(cardId, "Failed to send a message to the idle session:", err);
   }
@@ -4327,6 +4353,88 @@ async function stopTerminalTunnel(supabase, config) {
   await publishHostname(supabase, config, null);
 }
 
+// src/workflowShell.ts
+import { randomUUID as randomUUID8 } from "node:crypto";
+import { spawn as spawn6 } from "node-pty";
+function registerWorkflowShellRpcHandler(supabase, config) {
+  registerRunnerRpcHandler("open_workflow_shell", (payload) => openWorkflowShell(supabase, config, payload));
+}
+function isOpenWorkflowShellPayload(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return typeof candidate.projectId === "string" && typeof candidate.executionId === "string" && typeof candidate.instructions === "string" && candidate.instructions.length > 0;
+}
+async function openWorkflowShell(supabase, config, payload) {
+  if (!isOpenWorkflowShellPayload(payload)) throw new Error("Malformed open_workflow_shell payload.");
+  const { projectId, executionId, instructions } = payload;
+  const registered = config.registeredProjects.find((project) => project.id === projectId);
+  if (!registered) throw new Error("This runner does not have that project registered.");
+  ensureDirTrusted(registered.repoPath);
+  ensureMcpServersTrusted(registered.repoPath);
+  const claudeSessionId = randomUUID8();
+  const shellTicket = randomUUID8();
+  const pty = spawn6(
+    CLAUDE_BINARY,
+    [
+      "--dangerously-skip-permissions",
+      "--model",
+      "claude-sonnet-5",
+      "--session-id",
+      claudeSessionId,
+      ...claudeCliSettingsArgs()
+    ],
+    {
+      name: "xterm-color",
+      cols: 120,
+      rows: 32,
+      cwd: registered.repoPath,
+      env: statuslineEnv(executionId, shellTicket)
+    }
+  );
+  registerPtySession(executionId, pty, shellTicket);
+  pty.onExit(({ exitCode }) => void handleWorkflowShellExit(supabase, executionId, exitCode));
+  waitForIdleThenRun(pty, () => {
+    try {
+      writePasteAndSubmit(pty, executionId, instructions, "the workflow runbook", logger.runner);
+    } catch (err) {
+      logger.runner.error(executionId, "Failed to send the workflow runbook to the agent:", err);
+    }
+  });
+  return { claudeSessionId, shellTicket };
+}
+async function handleWorkflowShellExit(supabase, executionId, exitCode) {
+  const status = exitCode === 0 ? "done" : "failed";
+  const summary = getPtySession(executionId)?.lastAssistantMessage ?? null;
+  const { error } = await supabase.rpc("complete_workflow_execution", { p_execution_id: executionId, p_status: status, p_summary: summary });
+  if (error) {
+    logger.runner.error("WORKFLOW_SHELL", `Failed to record exit status for workflow execution ${executionId}:`, error);
+  }
+}
+async function reconcileOrphanedWorkflowExecutions(supabase, config) {
+  const { data, error } = await supabase.from("workflow_executions").select("id, project_id, claude_session_id, shell_ticket").eq("runner_id", config.runnerId).in("status", ["running", "paused_on_question"]);
+  if (error) {
+    logger.runner.error("WORKFLOW_SHELL", "Failed to scan orphaned workflow executions:", error.message);
+    return;
+  }
+  for (const execution of data ?? []) {
+    const { id: executionId, project_id: projectId, claude_session_id: claudeSessionId, shell_ticket: shellTicket } = execution;
+    if (getPtySession(executionId)) continue;
+    if (!claudeSessionId || !shellTicket) {
+      logger.runner.warn("WORKFLOW_SHELL", `Workflow execution ${executionId} is missing claude_session_id/shell_ticket \u2014 cannot resume it.`);
+      continue;
+    }
+    const registered = config.registeredProjects.find((project) => project.id === projectId);
+    if (!registered) {
+      logger.runner.warn("WORKFLOW_SHELL", `Workflow execution ${executionId}: project ${projectId} is not registered on this runner \u2014 skipping.`);
+      continue;
+    }
+    const pty = resumeAgentPty(registered.repoPath, claudeSessionId, executionId, shellTicket);
+    registerPtySession(executionId, pty, shellTicket);
+    pty.onExit(({ exitCode }) => void handleWorkflowShellExit(supabase, executionId, exitCode));
+    logger.runner.info("WORKFLOW_SHELL", `Re-spawned orphaned workflow execution ${executionId} (runner restarted while it was still active).`);
+  }
+}
+
 // src/runner.ts
 async function startRunner() {
   const loadedConfig = loadConfig();
@@ -4403,6 +4511,9 @@ async function startRunner() {
     await reconcileStaleSessions(supabase, config, project.id).catch((err) => logger.runner.error("ORCHESTRATOR", "reconcileStaleSessions failed:", err));
   }
   await reconcileOrphanedSessions(supabase, config).catch((err) => logger.runner.error("ORCHESTRATOR", "reconcileOrphanedSessions failed:", err));
+  await reconcileOrphanedWorkflowExecutions(supabase, config).catch(
+    (err) => logger.runner.error("WORKFLOW_SHELL", "reconcileOrphanedWorkflowExecutions failed:", err)
+  );
   await reconcileUsageLimitedSessions(supabase, config).catch((err) => logger.runner.error("ORCHESTRATOR", "reconcileUsageLimitedSessions failed:", err));
   const terminalPort = Number(process.env.AGENT_BOARD_TERMINAL_PORT ?? 8787);
   ensureStatuslineScriptWritten();
@@ -4413,6 +4524,7 @@ async function startRunner() {
   const agentEventsWss = attachAgentEventsServer();
   const runnerRpcWss = attachRunnerRpcServer();
   registerProjectCommandRpcHandler(supabase, config);
+  registerWorkflowShellRpcHandler(supabase, config);
   attachFilesServer(httpServer, supabase, config);
   httpServer.on("upgrade", (request, socket, head) => {
     const pathname = (request.url ?? "").split("?")[0];

package/dist/index.js

@@ -292,7 +292,15 @@ async function savePastedImage(sessionId, extCode, bytes) {
   return path;
 }
 function registerPtySession(sessionId, pty, ticket) {
-  const handle = { pty, ticket, outputBuffer: [], sockets: /* @__PURE__ */ new Set(), readOnly: false, exited: false };
+  const handle = {
+    pty,
+    ticket,
+    outputBuffer: [],
+    sockets: /* @__PURE__ */ new Set(),
+    readOnly: false,
+    exited: false,
+    lastAssistantMessage: null
+  };
   pty.onExit(() => {
     handle.exited = true;
   });
@@ -308,6 +316,10 @@ function registerPtySession(sessionId, pty, ticket) {
 function getPtySession(sessionId) {
   return registry.get(sessionId);
 }
+function recordLastAssistantMessage(sessionId, message) {
+  const handle = registry.get(sessionId);
+  if (handle) handle.lastAssistantMessage = message;
+}
 function setPtySessionReadOnly(sessionId, readOnly) {
   const handle = registry.get(sessionId);
   if (handle) handle.readOnly = readOnly;
@@ -1017,10 +1029,10 @@ function detectMoment(input) {
   return null;
 }
 
-function reportToRunner(sessionId, ticket, port, moment) {
+function reportToRunner(sessionId, ticket, port, moment, lastAssistantMessage) {
   return new Promise((resolve) => {
     try {
-      const body = JSON.stringify({ sessionId, ticket, moment });
+      const body = JSON.stringify({ sessionId, ticket, moment, lastAssistantMessage });
       const req = http.request(
         {
           host: "127.0.0.1",
@@ -1069,7 +1081,10 @@ function reportToRunner(sessionId, ticket, port, moment) {
       const sessionId = process.env.AGENT_BOARD_SESSION_ID;
       const ticket = process.env.AGENT_BOARD_STATUSLINE_TICKET;
       const port = Number(process.env.AGENT_BOARD_STATUSLINE_PORT);
-      if (sessionId && ticket && port) await reportToRunner(sessionId, ticket, port, moment);
+      if (sessionId && ticket && port) {
+        const lastAssistantMessage = moment === "turn_stopped" && typeof input.lastAssistantMessage === "string" ? input.lastAssistantMessage : undefined;
+        await reportToRunner(sessionId, ticket, port, moment, lastAssistantMessage);
+      }
     }
   } catch {
     // A malformed/unexpected hook payload must never block the agent's own turn.
@@ -1808,6 +1823,7 @@ async function handleStatuslineReport(req, res, supabase, config) {
     sendJson(res, 500, { error: "Erro interno do runner." });
   }
 }
+var MAX_LAST_ASSISTANT_MESSAGE_CHARS = 4e3;
 async function handleAgentHookReport(req, res) {
   let body;
   try {
@@ -1826,6 +1842,9 @@ async function handleAgentHookReport(req, res) {
     sendJson(res, 403, { error: "Ticket inv\xE1lido para esta sess\xE3o." });
     return;
   }
+  if (typeof body.lastAssistantMessage === "string" && body.lastAssistantMessage.length > 0) {
+    recordLastAssistantMessage(body.sessionId, body.lastAssistantMessage.slice(0, MAX_LAST_ASSISTANT_MESSAGE_CHARS));
+  }
   handleAgentHookEvent(body.sessionId, body.moment);
   res.writeHead(204, { "Access-Control-Allow-Origin": "*" });
   res.end();
@@ -2554,30 +2573,14 @@ import { randomUUID as randomUUID7 } from "node:crypto";
 import { randomUUID as randomUUID6 } from "node:crypto";
 import { spawn as spawn3 } from "node-pty";
 
-// src/sessionName.ts
-var MAX_LENGTH = 60;
-var FALLBACK_NAME = "card";
-function toSessionName(title) {
-  const slug = title.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-  if (slug.length === 0) return FALLBACK_NAME;
-  if (slug.length <= MAX_LENGTH) return slug;
-  const truncated = slug.slice(0, MAX_LENGTH);
-  const lastHyphen = truncated.lastIndexOf("-");
-  return (lastHyphen > 0 ? truncated.slice(0, lastHyphen) : truncated).replace(/-+$/, "");
-}
-
-// src/agentSession.ts
+// src/ptyMessaging.ts
 var TUI_IDLE_MS = 1500;
 var TUI_READY_TIMEOUT_MS = 6e4;
 var PASTE_SETTLE_MS = 200;
 var PASTE_SETTLE_TIMEOUT_MS = 5e3;
 var PASTE_START = "\x1B[200~";
 var PASTE_END = "\x1B[201~";
-var SHIFT_TAB = "\x1B[Z";
-var SHIFT_TAB_PRESSES_TO_PLAN_MODE = 4;
-var SHIFT_TAB_DELAY_MS = 400;
-var PLAN_MODE_INDICATOR = /plan mode on/i;
-function writePasteAndSubmit(pty, cardId, message, context) {
+function writePasteAndSubmit(pty, logId, message, context, log) {
   pty.write(`${PASTE_START}${message}${PASTE_END}`);
   let settleTimer;
   let ceilingTimer;
@@ -2594,7 +2597,7 @@ function writePasteAndSubmit(pty, cardId, message, context) {
     try {
       pty.write("\r");
     } catch (err) {
-      logger.card.error(cardId, `Failed to submit ${context} to the agent:`, err);
+      log.error(logId, `Failed to submit ${context} to the agent:`, err);
     }
   };
   const cancel = () => {
@@ -2612,6 +2615,48 @@ function writePasteAndSubmit(pty, cardId, message, context) {
   ceilingTimer = setTimeout(submit, PASTE_SETTLE_TIMEOUT_MS);
   exitSubscription = pty.onExit(cancel);
 }
+function waitForIdleThenRun(pty, run) {
+  let idleTimer;
+  let deadlineTimer;
+  let dataSubscription;
+  let settled = false;
+  const stopWaiting = () => {
+    if (settled) return false;
+    settled = true;
+    clearTimeout(idleTimer);
+    clearTimeout(deadlineTimer);
+    dataSubscription?.dispose();
+    return true;
+  };
+  const fire = () => {
+    if (!stopWaiting()) return;
+    void run();
+  };
+  deadlineTimer = setTimeout(fire, TUI_READY_TIMEOUT_MS);
+  dataSubscription = pty.onData(() => {
+    clearTimeout(idleTimer);
+    idleTimer = setTimeout(fire, TUI_IDLE_MS);
+  });
+  pty.onExit(() => stopWaiting());
+}
+
+// src/sessionName.ts
+var MAX_LENGTH = 60;
+var FALLBACK_NAME = "card";
+function toSessionName(title) {
+  const slug = title.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  if (slug.length === 0) return FALLBACK_NAME;
+  if (slug.length <= MAX_LENGTH) return slug;
+  const truncated = slug.slice(0, MAX_LENGTH);
+  const lastHyphen = truncated.lastIndexOf("-");
+  return (lastHyphen > 0 ? truncated.slice(0, lastHyphen) : truncated).replace(/-+$/, "");
+}
+
+// src/agentSession.ts
+var SHIFT_TAB = "\x1B[Z";
+var SHIFT_TAB_PRESSES_TO_PLAN_MODE = 4;
+var SHIFT_TAB_DELAY_MS = 400;
+var PLAN_MODE_INDICATOR = /plan mode on/i;
 function spawnAgentPty(repoPath, cardId, cardTitle, instructions, sessionId, ticket, planFirst) {
   ensureDirTrusted(repoPath);
   ensureMcpServersTrusted(repoPath);
@@ -2639,33 +2684,14 @@ function spawnAgentPty(repoPath, cardId, cardTitle, instructions, sessionId, tic
   return { pty, claudeSessionId };
 }
 function sendMessageWhenIdle(pty, cardId, message, planFirst) {
-  let idleTimer;
-  let deadlineTimer;
-  let dataSubscription;
-  let settled = false;
-  const stopWaiting = () => {
-    if (settled) return false;
-    settled = true;
-    clearTimeout(idleTimer);
-    clearTimeout(deadlineTimer);
-    dataSubscription?.dispose();
-    return true;
-  };
-  const send = async () => {
-    if (!stopWaiting()) return;
+  waitForIdleThenRun(pty, async () => {
     if (planFirst) await enterPlanMode(pty, cardId);
     try {
-      writePasteAndSubmit(pty, cardId, message, "the card instructions");
+      writePasteAndSubmit(pty, cardId, message, "the card instructions", logger.card);
     } catch (err) {
       logger.card.error(cardId, "Failed to send the card instructions to the agent:", err);
     }
-  };
-  deadlineTimer = setTimeout(send, TUI_READY_TIMEOUT_MS);
-  dataSubscription = pty.onData(() => {
-    clearTimeout(idleTimer);
-    idleTimer = setTimeout(send, TUI_IDLE_MS);
   });
-  pty.onExit(() => stopWaiting());
 }
 async function enterPlanMode(pty, cardId) {
   let recentOutput = "";
@@ -2691,7 +2717,7 @@ async function enterPlanMode(pty, cardId) {
 }
 function sendMessageToIdleSession(pty, cardId, message) {
   try {
-    writePasteAndSubmit(pty, cardId, message, "a message");
+    writePasteAndSubmit(pty, cardId, message, "a message", logger.card);
   } catch (err) {
     logger.card.error(cardId, "Failed to send a message to the idle session:", err);
   }
@@ -4215,6 +4241,88 @@ async function stopTerminalTunnel(supabase, config) {
   await publishHostname(supabase, config, null);
 }
 
+// src/workflowShell.ts
+import { randomUUID as randomUUID8 } from "node:crypto";
+import { spawn as spawn6 } from "node-pty";
+function registerWorkflowShellRpcHandler(supabase, config) {
+  registerRunnerRpcHandler("open_workflow_shell", (payload) => openWorkflowShell(supabase, config, payload));
+}
+function isOpenWorkflowShellPayload(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return typeof candidate.projectId === "string" && typeof candidate.executionId === "string" && typeof candidate.instructions === "string" && candidate.instructions.length > 0;
+}
+async function openWorkflowShell(supabase, config, payload) {
+  if (!isOpenWorkflowShellPayload(payload)) throw new Error("Malformed open_workflow_shell payload.");
+  const { projectId, executionId, instructions } = payload;
+  const registered = config.registeredProjects.find((project) => project.id === projectId);
+  if (!registered) throw new Error("This runner does not have that project registered.");
+  ensureDirTrusted(registered.repoPath);
+  ensureMcpServersTrusted(registered.repoPath);
+  const claudeSessionId = randomUUID8();
+  const shellTicket = randomUUID8();
+  const pty = spawn6(
+    CLAUDE_BINARY,
+    [
+      "--dangerously-skip-permissions",
+      "--model",
+      "claude-sonnet-5",
+      "--session-id",
+      claudeSessionId,
+      ...claudeCliSettingsArgs()
+    ],
+    {
+      name: "xterm-color",
+      cols: 120,
+      rows: 32,
+      cwd: registered.repoPath,
+      env: statuslineEnv(executionId, shellTicket)
+    }
+  );
+  registerPtySession(executionId, pty, shellTicket);
+  pty.onExit(({ exitCode }) => void handleWorkflowShellExit(supabase, executionId, exitCode));
+  waitForIdleThenRun(pty, () => {
+    try {
+      writePasteAndSubmit(pty, executionId, instructions, "the workflow runbook", logger.runner);
+    } catch (err) {
+      logger.runner.error(executionId, "Failed to send the workflow runbook to the agent:", err);
+    }
+  });
+  return { claudeSessionId, shellTicket };
+}
+async function handleWorkflowShellExit(supabase, executionId, exitCode) {
+  const status = exitCode === 0 ? "done" : "failed";
+  const summary = getPtySession(executionId)?.lastAssistantMessage ?? null;
+  const { error } = await supabase.rpc("complete_workflow_execution", { p_execution_id: executionId, p_status: status, p_summary: summary });
+  if (error) {
+    logger.runner.error("WORKFLOW_SHELL", `Failed to record exit status for workflow execution ${executionId}:`, error);
+  }
+}
+async function reconcileOrphanedWorkflowExecutions(supabase, config) {
+  const { data, error } = await supabase.from("workflow_executions").select("id, project_id, claude_session_id, shell_ticket").eq("runner_id", config.runnerId).in("status", ["running", "paused_on_question"]);
+  if (error) {
+    logger.runner.error("WORKFLOW_SHELL", "Failed to scan orphaned workflow executions:", error.message);
+    return;
+  }
+  for (const execution of data ?? []) {
+    const { id: executionId, project_id: projectId, claude_session_id: claudeSessionId, shell_ticket: shellTicket } = execution;
+    if (getPtySession(executionId)) continue;
+    if (!claudeSessionId || !shellTicket) {
+      logger.runner.warn("WORKFLOW_SHELL", `Workflow execution ${executionId} is missing claude_session_id/shell_ticket \u2014 cannot resume it.`);
+      continue;
+    }
+    const registered = config.registeredProjects.find((project) => project.id === projectId);
+    if (!registered) {
+      logger.runner.warn("WORKFLOW_SHELL", `Workflow execution ${executionId}: project ${projectId} is not registered on this runner \u2014 skipping.`);
+      continue;
+    }
+    const pty = resumeAgentPty(registered.repoPath, claudeSessionId, executionId, shellTicket);
+    registerPtySession(executionId, pty, shellTicket);
+    pty.onExit(({ exitCode }) => void handleWorkflowShellExit(supabase, executionId, exitCode));
+    logger.runner.info("WORKFLOW_SHELL", `Re-spawned orphaned workflow execution ${executionId} (runner restarted while it was still active).`);
+  }
+}
+
 // src/runner.ts
 async function startRunner() {
   const loadedConfig = loadConfig();
@@ -4291,6 +4399,9 @@ async function startRunner() {
     await reconcileStaleSessions(supabase, config, project.id).catch((err) => logger.runner.error("ORCHESTRATOR", "reconcileStaleSessions failed:", err));
   }
   await reconcileOrphanedSessions(supabase, config).catch((err) => logger.runner.error("ORCHESTRATOR", "reconcileOrphanedSessions failed:", err));
+  await reconcileOrphanedWorkflowExecutions(supabase, config).catch(
+    (err) => logger.runner.error("WORKFLOW_SHELL", "reconcileOrphanedWorkflowExecutions failed:", err)
+  );
   await reconcileUsageLimitedSessions(supabase, config).catch((err) => logger.runner.error("ORCHESTRATOR", "reconcileUsageLimitedSessions failed:", err));
   const terminalPort = Number(process.env.AGENT_BOARD_TERMINAL_PORT ?? 8787);
   ensureStatuslineScriptWritten();
@@ -4301,6 +4412,7 @@ async function startRunner() {
   const agentEventsWss = attachAgentEventsServer();
   const runnerRpcWss = attachRunnerRpcServer();
   registerProjectCommandRpcHandler(supabase, config);
+  registerWorkflowShellRpcHandler(supabase, config);
   attachFilesServer(httpServer, supabase, config);
   httpServer.on("upgrade", (request, socket, head) => {
     const pathname = (request.url ?? "").split("?")[0];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-board-runner",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "description": "Local runner for Agent Board — signs in with your own Supabase account (no shared secrets) and drives Claude Code against repos under your local repos root.",
   "type": "module",
   "bin": {