agent-board-runner 0.1.18 → 0.1.20

package/dist/cli.js

@@ -320,7 +320,7 @@ var BOX_DRAWING_PATTERN = /[─-╿]/g;
 var WORKING_PATTERN = /esc to interrupt/i;
 var BACKGROUND_SHELL_PATTERN = /\b[1-9]\d*\s+shells?\b/i;
 function isAgentHookMoment(value) {
-  return value === "implementing" || value === "tool_active" || value === "waiting_plan_approval" || value === "waiting_prototype_review" || value === "commit_detected" || value === "turn_stopped" || value === "notification";
+  return value === "implementing" || value === "tool_active" || value === "waiting_plan_approval" || value === "waiting_prototype_review" || value === "waiting_workflow_answer" || value === "commit_detected" || value === "turn_stopped" || value === "notification";
 }
 var USAGE_LIMIT_PATTERN = /(usage limit reached|limit reached[^\n]{0,60}resets|reached your (?:usage|session) limit|out of (?:weekly|session) (?:usage|limit))/i;
 var PLAN_APPROVAL_PATTERN = /would you like to proceed\??/i;
@@ -372,6 +372,8 @@ var AgentActivityWatcher = class {
    * "waiting_user" — see the guard in reportHookMoment's "turn_stopped" case.
    */
   prototypeReviewPending = false;
+  /** Same shape as prototypeReviewPending, for ask_workflow_question (see docs/ai-knowledges/workflows-visuais-mecanismo.md). */
+  workflowAnswerPending = false;
   toolCallPending = false;
   commitDetected = false;
   timer;
@@ -414,6 +416,7 @@ var AgentActivityWatcher = class {
         this.usageLimited = false;
         this.planApprovalPending = false;
         this.prototypeReviewPending = false;
+        this.workflowAnswerPending = false;
         this.commitDetected = false;
         this.setState("implementing");
         break;
@@ -429,12 +432,17 @@ var AgentActivityWatcher = class {
         this.prototypeReviewPending = true;
         this.setState("waiting_prototype_review");
         break;
+      case "waiting_workflow_answer":
+        this.workflowAnswerPending = true;
+        this.setState("waiting_workflow_answer");
+        break;
       case "commit_detected":
         this.commitDetected = true;
         break;
       case "turn_stopped":
         if (this.usageLimited) break;
         if (this.prototypeReviewPending) break;
+        if (this.workflowAnswerPending) break;
         if (BACKGROUND_SHELL_PATTERN.test(this.recentOutput())) {
           this.setState("waiting_background");
           break;
@@ -1255,6 +1263,11 @@ function detectMoment(input) {
   // prototypeReviewPending latch in agentActivity.ts's reportHookMoment.
   if (eventName === "PostToolUse" && input.tool_name === "mcp__agent-board__publish_prototype") return "waiting_prototype_review";
 
+  // Same shape as publish_prototype above, but for a workflow graph's "ask" node (see
+  // ask_workflow_question in boardTools.ts and docs/ai-knowledges/workflows-visuais-mecanismo.md)
+  // \u2014 see the workflowAnswerPending latch in agentActivity.ts's reportHookMoment.
+  if (eventName === "PostToolUse" && input.tool_name === "mcp__agent-board__ask_workflow_question") return "waiting_workflow_answer";
+
   // A commit that actually succeeded, read off the Bash tool's own structured result instead
   // of guessing from scrollback text (exact, and immune to locale/color/format changes to
   // git's own banner). Any other Bash completion still reports "tool_active" below, same as
@@ -3229,7 +3242,7 @@ async function dispatchRunnerQueue(supabase, config) {
     for (const project of config.registeredProjects) {
       const running = await getRunningSessionForProject(supabase, project.id, config.runnerId);
       if (!running) continue;
-      if ((running.agentState === "done" || running.agentState === "waiting_prototype_review") && queuedProjectIds.has(project.id)) {
+      if ((running.agentState === "done" || running.agentState === "waiting_prototype_review" || running.agentState === "waiting_workflow_answer") && queuedProjectIds.has(project.id)) {
         await pauseFinishedSession(supabase, config, project.id, running.cardId, running.id);
         continue;
       }
@@ -3294,6 +3307,14 @@ async function publishQueueSnapshots(supabase, config, queued, promotedCardIds)
 function buildPrototypeReviewFollowUp(prototypeApproved, prototypeUrl) {
   return prototypeApproved ? "O prot\xF3tipo foi revisado e aprovado \u2014 prossiga para a implementa\xE7\xE3o real, usando-o como refer\xEAncia." : `O prot\xF3tipo ainda n\xE3o foi aprovado${prototypeUrl ? ` (${prototypeUrl})` : ""} \u2014 confira os coment\xE1rios deixados nele (e, se for um prot\xF3tipo de marca\xE7\xE3o de pontos, os pontos salvos) e ajuste, publicando a nova vers\xE3o com publish_prototype. Depois, pare o turno de novo: a sess\xE3o ser\xE1 retomada quando houver outra revis\xE3o.`;
 }
+async function buildWorkflowAnswerFollowUp(supabase, cardId) {
+  const { data } = await supabase.from("card_workflow_questions").select("question, answer").eq("card_id", cardId).eq("status", "answered").order("answered_at", { ascending: false }).limit(1).maybeSingle();
+  if (!data) return "A pergunta foi respondida \u2014 confira os coment\xE1rios do card e prossiga.";
+  return `Pergunta: "${data.question}"
+Resposta do humano: "${data.answer}"
+
+Prossiga com o workflow a partir daqui.`;
+}
 async function promoteQueuedSession(supabase, config, entry) {
   const existingHandle = getPtySession(entry.id);
   if (existingHandle) {
@@ -3313,6 +3334,9 @@ async function promoteQueuedSession(supabase, config, entry) {
         buildPrototypeReviewFollowUp(entry.cards.prototype_approved, entry.cards.prototype_url)
       );
     }
+    if (entry.agent_state === "waiting_workflow_answer" && !existingHandle.exited) {
+      sendMessageToIdleSession(existingHandle.pty, entry.card_id, await buildWorkflowAnswerFollowUp(supabase, entry.card_id));
+    }
     return;
   }
   const spawned = await spawnSessionPty(supabase, config, entry);
@@ -3431,7 +3455,7 @@ function watchAgentActivity(supabase, config, projectId, cardId, sessionId, pty)
     } else {
       cancelUsageResume(sessionId);
     }
-    if (state === "done" || state === "waiting_prototype_review") void dispatchRunnerQueue(supabase, config);
+    if (state === "done" || state === "waiting_prototype_review" || state === "waiting_workflow_answer") void dispatchRunnerQueue(supabase, config);
   });
   pty.onData((chunk) => watcher.push(chunk));
   registerAgentActivityWatcher(sessionId, watcher);
@@ -3466,6 +3490,14 @@ async function requeuePausedCard(supabase, config, card) {
       logger.card.info(card.id, `Session ${active.id} was never paused (alone in its project) \u2014 sent the prototype review follow-up directly.`);
     }
   }
+  if (active.status === "running" && active.agentState === "waiting_workflow_answer") {
+    const handle = getPtySession(active.id);
+    await updateCard(supabase, card.id, { requeueRequestedAt: null });
+    if (handle && !handle.exited) {
+      sendMessageToIdleSession(handle.pty, card.id, await buildWorkflowAnswerFollowUp(supabase, card.id));
+      logger.card.info(card.id, `Session ${active.id} was never paused (alone in its project) \u2014 sent the workflow answer follow-up directly.`);
+    }
+  }
 }
 async function reconcileOrphanedSessions(supabase, config) {
   for (const project of config.registeredProjects) {

package/dist/index.js

@@ -40,7 +40,7 @@ var BOX_DRAWING_PATTERN = /[─-╿]/g;
 var WORKING_PATTERN = /esc to interrupt/i;
 var BACKGROUND_SHELL_PATTERN = /\b[1-9]\d*\s+shells?\b/i;
 function isAgentHookMoment(value) {
-  return value === "implementing" || value === "tool_active" || value === "waiting_plan_approval" || value === "waiting_prototype_review" || value === "commit_detected" || value === "turn_stopped" || value === "notification";
+  return value === "implementing" || value === "tool_active" || value === "waiting_plan_approval" || value === "waiting_prototype_review" || value === "waiting_workflow_answer" || value === "commit_detected" || value === "turn_stopped" || value === "notification";
 }
 var USAGE_LIMIT_PATTERN = /(usage limit reached|limit reached[^\n]{0,60}resets|reached your (?:usage|session) limit|out of (?:weekly|session) (?:usage|limit))/i;
 var PLAN_APPROVAL_PATTERN = /would you like to proceed\??/i;
@@ -92,6 +92,8 @@ var AgentActivityWatcher = class {
    * "waiting_user" — see the guard in reportHookMoment's "turn_stopped" case.
    */
   prototypeReviewPending = false;
+  /** Same shape as prototypeReviewPending, for ask_workflow_question (see docs/ai-knowledges/workflows-visuais-mecanismo.md). */
+  workflowAnswerPending = false;
   toolCallPending = false;
   commitDetected = false;
   timer;
@@ -134,6 +136,7 @@ var AgentActivityWatcher = class {
         this.usageLimited = false;
         this.planApprovalPending = false;
         this.prototypeReviewPending = false;
+        this.workflowAnswerPending = false;
         this.commitDetected = false;
         this.setState("implementing");
         break;
@@ -149,12 +152,17 @@ var AgentActivityWatcher = class {
         this.prototypeReviewPending = true;
         this.setState("waiting_prototype_review");
         break;
+      case "waiting_workflow_answer":
+        this.workflowAnswerPending = true;
+        this.setState("waiting_workflow_answer");
+        break;
       case "commit_detected":
         this.commitDetected = true;
         break;
       case "turn_stopped":
         if (this.usageLimited) break;
         if (this.prototypeReviewPending) break;
+        if (this.workflowAnswerPending) break;
         if (BACKGROUND_SHELL_PATTERN.test(this.recentOutput())) {
           this.setState("waiting_background");
           break;
@@ -975,6 +983,11 @@ function detectMoment(input) {
   // prototypeReviewPending latch in agentActivity.ts's reportHookMoment.
   if (eventName === "PostToolUse" && input.tool_name === "mcp__agent-board__publish_prototype") return "waiting_prototype_review";
 
+  // Same shape as publish_prototype above, but for a workflow graph's "ask" node (see
+  // ask_workflow_question in boardTools.ts and docs/ai-knowledges/workflows-visuais-mecanismo.md)
+  // \u2014 see the workflowAnswerPending latch in agentActivity.ts's reportHookMoment.
+  if (eventName === "PostToolUse" && input.tool_name === "mcp__agent-board__ask_workflow_question") return "waiting_workflow_answer";
+
   // A commit that actually succeeded, read off the Bash tool's own structured result instead
   // of guessing from scrollback text (exact, and immune to locale/color/format changes to
   // git's own banner). Any other Bash completion still reports "tool_active" below, same as
@@ -3117,7 +3130,7 @@ async function dispatchRunnerQueue(supabase, config) {
     for (const project of config.registeredProjects) {
       const running = await getRunningSessionForProject(supabase, project.id, config.runnerId);
       if (!running) continue;
-      if ((running.agentState === "done" || running.agentState === "waiting_prototype_review") && queuedProjectIds.has(project.id)) {
+      if ((running.agentState === "done" || running.agentState === "waiting_prototype_review" || running.agentState === "waiting_workflow_answer") && queuedProjectIds.has(project.id)) {
         await pauseFinishedSession(supabase, config, project.id, running.cardId, running.id);
         continue;
       }
@@ -3182,6 +3195,14 @@ async function publishQueueSnapshots(supabase, config, queued, promotedCardIds)
 function buildPrototypeReviewFollowUp(prototypeApproved, prototypeUrl) {
   return prototypeApproved ? "O prot\xF3tipo foi revisado e aprovado \u2014 prossiga para a implementa\xE7\xE3o real, usando-o como refer\xEAncia." : `O prot\xF3tipo ainda n\xE3o foi aprovado${prototypeUrl ? ` (${prototypeUrl})` : ""} \u2014 confira os coment\xE1rios deixados nele (e, se for um prot\xF3tipo de marca\xE7\xE3o de pontos, os pontos salvos) e ajuste, publicando a nova vers\xE3o com publish_prototype. Depois, pare o turno de novo: a sess\xE3o ser\xE1 retomada quando houver outra revis\xE3o.`;
 }
+async function buildWorkflowAnswerFollowUp(supabase, cardId) {
+  const { data } = await supabase.from("card_workflow_questions").select("question, answer").eq("card_id", cardId).eq("status", "answered").order("answered_at", { ascending: false }).limit(1).maybeSingle();
+  if (!data) return "A pergunta foi respondida \u2014 confira os coment\xE1rios do card e prossiga.";
+  return `Pergunta: "${data.question}"
+Resposta do humano: "${data.answer}"
+
+Prossiga com o workflow a partir daqui.`;
+}
 async function promoteQueuedSession(supabase, config, entry) {
   const existingHandle = getPtySession(entry.id);
   if (existingHandle) {
@@ -3201,6 +3222,9 @@ async function promoteQueuedSession(supabase, config, entry) {
         buildPrototypeReviewFollowUp(entry.cards.prototype_approved, entry.cards.prototype_url)
       );
     }
+    if (entry.agent_state === "waiting_workflow_answer" && !existingHandle.exited) {
+      sendMessageToIdleSession(existingHandle.pty, entry.card_id, await buildWorkflowAnswerFollowUp(supabase, entry.card_id));
+    }
     return;
   }
   const spawned = await spawnSessionPty(supabase, config, entry);
@@ -3319,7 +3343,7 @@ function watchAgentActivity(supabase, config, projectId, cardId, sessionId, pty)
     } else {
       cancelUsageResume(sessionId);
     }
-    if (state === "done" || state === "waiting_prototype_review") void dispatchRunnerQueue(supabase, config);
+    if (state === "done" || state === "waiting_prototype_review" || state === "waiting_workflow_answer") void dispatchRunnerQueue(supabase, config);
   });
   pty.onData((chunk) => watcher.push(chunk));
   registerAgentActivityWatcher(sessionId, watcher);
@@ -3354,6 +3378,14 @@ async function requeuePausedCard(supabase, config, card) {
       logger.card.info(card.id, `Session ${active.id} was never paused (alone in its project) \u2014 sent the prototype review follow-up directly.`);
     }
   }
+  if (active.status === "running" && active.agentState === "waiting_workflow_answer") {
+    const handle = getPtySession(active.id);
+    await updateCard(supabase, card.id, { requeueRequestedAt: null });
+    if (handle && !handle.exited) {
+      sendMessageToIdleSession(handle.pty, card.id, await buildWorkflowAnswerFollowUp(supabase, card.id));
+      logger.card.info(card.id, `Session ${active.id} was never paused (alone in its project) \u2014 sent the workflow answer follow-up directly.`);
+    }
+  }
 }
 async function reconcileOrphanedSessions(supabase, config) {
   for (const project of config.registeredProjects) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-board-runner",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "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": {