@sideboard-ai/core 0.1.32 → 0.1.34

package/dist/index.cjs

@@ -3607,6 +3607,120 @@ var init_brightsy_targets = __esm({
   }
 });
 
+// src/agents/error-detail.ts
+function formatUnknownDetail(err) {
+  if (err == null) return "";
+  if (typeof err === "string") return err.trim();
+  if (err instanceof Error) {
+    const base = err.message.trim() || err.name;
+    const code = "code" in err && typeof err.code === "string" ? err.code.trim() : "";
+    return code && !base.includes(code) ? `${base} (${code})` : base;
+  }
+  if (typeof err === "object") {
+    const o = err;
+    const nested = o.error != null && typeof o.error === "object" ? formatUnknownDetail(o.error) : "";
+    const message = typeof o.message === "string" ? o.message.trim() : typeof o.error === "string" ? o.error.trim() : typeof o.result === "string" ? o.result.trim() : nested;
+    const code = typeof o.code === "string" ? o.code.trim() : "";
+    if (message) return code && !message.includes(code) ? `${message} (${code})` : message;
+    try {
+      const json = JSON.stringify(err);
+      if (json && json !== "{}" && json !== "null") return json;
+    } catch {
+    }
+  }
+  const fallback = String(err);
+  return fallback === "[object Object]" ? "" : fallback;
+}
+function extractJsonErrorMessage(obj) {
+  const nested = obj.error != null && typeof obj.error === "object" ? obj.error : null;
+  const candidates = [
+    typeof obj.message === "string" ? obj.message : null,
+    typeof obj.error === "string" ? obj.error : null,
+    nested && typeof nested.message === "string" ? nested.message : null,
+    typeof obj.result === "string" ? obj.result : null,
+    typeof obj.detail === "string" ? obj.detail : null
+  ];
+  for (const c of candidates) {
+    const t = c?.trim();
+    if (t) return t;
+  }
+  if (Array.isArray(obj.errors)) {
+    const parts = obj.errors.map((e) => formatUnknownDetail(e)).map((s) => s.trim()).filter(Boolean);
+    if (parts.length) return parts.join("; ");
+  }
+  return null;
+}
+function pushTurnStderr(tail, line, maxLines = 12) {
+  const trimmed = line.trim();
+  if (!trimmed) return;
+  if (NODE_VERSION_FOOTER.test(trimmed)) return;
+  if (/^reconnecting\.\.\./i.test(trimmed)) return;
+  tail.push(trimmed);
+  while (tail.length > maxLines) tail.shift();
+}
+function summarizeTurnStderr(tail, maxChars = 500) {
+  if (tail.length === 0) return "";
+  const joined = tail.slice(-6).join("\n").trim();
+  if (joined.length <= maxChars) return joined;
+  return joined.slice(joined.length - maxChars);
+}
+function looksLikeAgentFailureMessage(text) {
+  const lower = text.trim().toLowerCase();
+  if (!lower) return false;
+  return /you've hit your|hit your (session|weekly|opus) limit|usage limit/.test(lower) || /credit balance is too low|out of credits|insufficient.?quota|quota.?exceeded/.test(lower) || /invalid user api key|invalid api key|not logged in|not authenticated|unauthorized/.test(
+    lower
+  ) || /\b429\b|too many requests|rate.?limit/.test(lower) || /prompt is too long|context.*(too long|exceed)|conversation too long/.test(lower);
+}
+function fallbackTurnFailDetail(assistantText) {
+  const t = assistantText.trim();
+  if (!t) return "";
+  if (looksLikeAgentFailureMessage(t)) return t;
+  if (t.length <= 400 && !/\n\n/.test(t)) return t;
+  return "";
+}
+function humanizeAgentFailDetail(detail) {
+  const raw = detail.trim();
+  if (!raw) return raw;
+  const lower = raw.toLowerCase();
+  if (/credit balance is too low|out of credits|insufficient.?quota|quota.?exceeded|billing/.test(lower)) {
+    return `${raw} \u2014 add credits or switch auth, then retry.`;
+  }
+  if (/hit your (session|weekly|opus) limit|usage limit|you've hit your/.test(lower)) {
+    return raw.includes("reset") ? raw : `${raw} \u2014 wait for the limit window to reset, then retry.`;
+  }
+  if (/\b429\b|rate.?limit|too many requests/.test(lower)) {
+    return `${raw} \u2014 wait a moment and retry.`;
+  }
+  if (/invalid user api key|invalid api key|not logged in|not authenticated|unauthorized|authentication|please run.*login|codex login|claude auth|cursor api/.test(
+    lower
+  )) {
+    return `${raw} \u2014 check agent login / API key in Settings.`;
+  }
+  if (/model .{0,80}(not found|unavailable|unknown|invalid)/.test(lower)) {
+    return `${raw} \u2014 pick another model in the agent options.`;
+  }
+  if (/context.*(too long|exceed)|prompt is too long|conversation too long/.test(lower)) {
+    return `${raw} \u2014 start a new chat or compact context, then retry.`;
+  }
+  return raw;
+}
+function formatTurnExitError(exitCode, stderrSummary) {
+  const code = exitCode ?? 1;
+  const detail = humanizeAgentFailDetail(stderrSummary);
+  if (!detail) {
+    return `exit ${code}: agent exited without details (credits, auth, rate limits, or a CLI error)`;
+  }
+  if (looksLikeAgentFailureMessage(stderrSummary)) return detail;
+  return `exit ${code}: ${detail}`;
+}
+var NODE_VERSION_FOOTER;
+var init_error_detail = __esm({
+  "src/agents/error-detail.ts"() {
+    "use strict";
+    NODE_VERSION_FOOTER = /^Node\.js v\d+/i;
+  }
+});
+
 // src/agents/turn-input.ts
 function normalizeTurnInput(input) {
   if (typeof input === "string") return { prompt: input };
@@ -3697,7 +3811,7 @@ function parseBrightsyCliLine(line) {
       return { type: "thinking", data: obj.text };
     }
     if (obj.type === "error") {
-      const msg = String(obj.error ?? trimmed);
+      const msg = extractJsonErrorMessage(obj) || formatUnknownDetail(obj.error) || formatUnknownDetail(obj.message) || trimmed;
       return [
         { type: "stderr", data: msg },
         { type: "stdout", data: `Error: ${msg}` }
@@ -3734,6 +3848,12 @@ function parseBrightsyCliLine(line) {
     if (trimmed.startsWith("{") && /"type"\s*:\s*"(tool_use|tool_result|tool|text|thinking|usage|done|error)"/.test(trimmed)) {
       return null;
     }
+    if (/error|failed|unauthorized|quota|limit|not logged in/i.test(trimmed)) {
+      return [
+        { type: "stderr", data: trimmed },
+        { type: "stdout", data: `Error: ${trimmed}` }
+      ];
+    }
     return { type: "stdout", data: line };
   }
 }
@@ -3888,6 +4008,7 @@ var init_brightsy = __esm({
     init_connected_teams();
     init_config();
     init_brightsy_targets();
+    init_error_detail();
     init_turn_input();
     init_brightsy_targets();
     brightsyAdapter = {
@@ -4226,6 +4347,30 @@ function usageFromClaude(usage) {
     cacheWriteTokens: usage.cache_creation_input_tokens ? Number(usage.cache_creation_input_tokens) : void 0
   };
 }
+function claudeResultErrorDetail(obj) {
+  const isError = Boolean(obj.is_error) || typeof obj.subtype === "string" && /^error/i.test(obj.subtype);
+  const fromResult = typeof obj.result === "string" ? obj.result.trim() : "";
+  if (fromResult && (isError || looksLikeAgentFailureMessage(fromResult))) {
+    return fromResult;
+  }
+  if (!isError) return null;
+  const errors = obj.errors;
+  if (Array.isArray(errors)) {
+    const parts = errors.map((e) => {
+      if (typeof e === "string") return e.trim();
+      if (e && typeof e === "object" && typeof e.message === "string") {
+        return e.message.trim();
+      }
+      return "";
+    }).filter(Boolean);
+    if (parts.length) return parts.join("; ");
+  }
+  if (typeof obj.error === "string" && obj.error.trim()) return obj.error.trim();
+  if (typeof obj.subtype === "string" && obj.subtype) {
+    return obj.subtype.replace(/^error[_-]?/i, "").replace(/_/g, " ") || "Claude turn failed";
+  }
+  return "Claude turn failed";
+}
 function eventsFromContentBlocks(blocks) {
   if (!blocks?.length) return [];
   const out = [];
@@ -4295,6 +4440,7 @@ var init_claude = __esm({
     init_run();
     init_app_settings();
     init_claude_mcp();
+    init_error_detail();
     init_injected_mcp();
     init_turn_input();
     init_types();
@@ -4489,8 +4635,13 @@ var init_claude = __esm({
           }
           if (obj.type === "result") {
             const events = [];
-            const text = obj.result;
-            if (typeof text === "string" && text) events.push({ type: "stdout", data: text });
+            const errorDetail = claudeResultErrorDetail(obj);
+            if (errorDetail) {
+              events.push({ type: "stderr", data: errorDetail });
+            } else {
+              const text = obj.result;
+              if (typeof text === "string" && text) events.push({ type: "stdout", data: text });
+            }
             const usage = usageFromClaude(obj.usage);
             if (usage) events.push({ type: "usage", data: usage });
             if (events.length === 0) return null;
@@ -4598,6 +4749,7 @@ var init_codex = __esm({
     import_node_os7 = require("os");
     import_node_path12 = require("path");
     init_run();
+    init_error_detail();
     init_turn_input();
     init_types();
     CODEX_PROMPT_ARG_MAX = 2e5;
@@ -4682,23 +4834,49 @@ var init_codex = __esm({
         if (!trimmed) return null;
         try {
           const obj = JSON.parse(trimmed);
-          const sid = typeof obj.session_id === "string" && obj.session_id || typeof obj.thread_id === "string" && obj.thread_id || typeof obj.session?.id === "string" && obj.session.id;
-          if (sid) return { type: "session_id", data: sid };
-          if (obj.type === "turn.completed" || obj.type === "turn_completed") {
-            const usage = usageFromCodex(obj.usage);
-            return usage ? { type: "usage", data: usage } : null;
+          const type = typeof obj.type === "string" ? obj.type : "";
+          if (type === "turn.failed" || type === "turn_failed") {
+            const detail = extractJsonErrorMessage(obj) || extractJsonErrorMessage(obj.error ?? {}) || "Codex turn failed";
+            return { type: "stderr", data: detail };
+          }
+          if (type === "error") {
+            const detail = extractJsonErrorMessage(obj) || trimmed;
+            if (/^reconnecting\.\.\./i.test(detail)) return null;
+            return { type: "stderr", data: detail };
           }
           if (typeof obj.item === "object" && obj.item !== null) {
             const item = obj.item;
+            if (item.type === "error") {
+              const detail = item.message?.trim() || extractJsonErrorMessage(obj) || "Codex item error";
+              return { type: "stderr", data: detail };
+            }
             if (item.type === "agent_message" && item.text) {
               return { type: "stdout", data: item.text };
             }
+            if (item.status === "failed") {
+              const detail = item.message?.trim() || extractJsonErrorMessage(item) || `Codex ${item.type ?? "item"} failed`;
+              return { type: "stderr", data: detail };
+            }
+          }
+          const sid = typeof obj.session_id === "string" && obj.session_id || typeof obj.thread_id === "string" && obj.thread_id || typeof obj.session?.id === "string" && obj.session.id;
+          if (sid && (type === "thread.started" || type === "session" || !type)) {
+            return { type: "session_id", data: sid };
+          }
+          if (sid && type.endsWith(".started")) {
+            return { type: "session_id", data: sid };
           }
-          if (typeof obj.content === "string") {
+          if (type === "turn.completed" || type === "turn_completed") {
+            const usage = usageFromCodex(obj.usage);
+            return usage ? { type: "usage", data: usage } : null;
+          }
+          if (typeof obj.content === "string" && obj.content.trim()) {
             return { type: "stdout", data: obj.content };
           }
-          return { type: "stdout", data: trimmed };
+          return null;
         } catch {
+          if (/error|failed|unauthorized|quota|limit/i.test(trimmed)) {
+            return { type: "stderr", data: trimmed };
+          }
           return { type: "stdout", data: line };
         }
       },
@@ -4814,7 +4992,12 @@ function cursorSdkMessageToEvents(msg) {
     if (usage) return [{ type: "usage", data: usage }];
   }
   if (msg.type === "status" && msg.status === "ERROR") {
-    const detail = msg.message || msg.text || "Cursor run entered ERROR status";
+    const rawMessage = msg.message;
+    const detail = (typeof rawMessage === "string" ? rawMessage.trim() : "") || extractJsonErrorMessage(msg) || formatUnknownDetail(msg.error) || msg.text || "Cursor run entered ERROR status";
+    return [{ type: "stderr", data: detail }];
+  }
+  if (msg.type === "error") {
+    const detail = extractJsonErrorMessage(msg) || formatUnknownDetail(msg.error) || msg.text || "Cursor run error";
     return [{ type: "stderr", data: detail }];
   }
   return [];
@@ -4839,6 +5022,7 @@ function parseCursorRunnerLine(line) {
 var init_cursor_events = __esm({
   "src/agents/cursor-events.ts"() {
     "use strict";
+    init_error_detail();
   }
 });
 
@@ -5071,6 +5255,7 @@ var init_opencode = __esm({
   "src/agents/opencode.ts"() {
     "use strict";
     init_run();
+    init_error_detail();
     init_turn_input();
     init_types();
     FALLBACK_OPENCODE_MODELS = [
@@ -5148,6 +5333,10 @@ var init_opencode = __esm({
         if (!trimmed) return null;
         try {
           const obj = JSON.parse(trimmed);
+          if (obj.type === "error") {
+            const detail = extractJsonErrorMessage(obj) || formatUnknownDetail(obj.error) || formatUnknownDetail(obj.message) || trimmed;
+            return { type: "stderr", data: detail };
+          }
           const sid = typeof obj.sessionID === "string" && obj.sessionID || typeof obj.sessionId === "string" && obj.sessionId || typeof obj.session_id === "string" && obj.session_id;
           if (sid) return { type: "session_id", data: sid };
           if (obj.type === "text") {
@@ -5171,12 +5360,6 @@ var init_opencode = __esm({
               content: part?.output ?? part?.content ?? obj.output ?? obj.content
             };
           }
-          if (obj.type === "error") {
-            return {
-              type: "stderr",
-              data: String(obj.error ?? trimmed)
-            };
-          }
           if (obj.type === "step_finish" || obj.type === "step-finish") {
             const part = obj.part;
             const usage = usageFromOpencode(
@@ -5184,8 +5367,11 @@ var init_opencode = __esm({
             );
             return usage ? { type: "usage", data: usage } : null;
           }
-          return { type: "stdout", data: trimmed };
+          return null;
         } catch {
+          if (/error|failed|unauthorized|quota|limit/i.test(trimmed)) {
+            return { type: "stderr", data: trimmed };
+          }
           return { type: "stdout", data: line };
         }
       },
@@ -6667,6 +6853,49 @@ function pipeLines(stream, onLine) {
   const rl = (0, import_node_readline2.createInterface)({ input: stream });
   rl.on("line", onLine);
 }
+function killScriptTree(child, ports = []) {
+  const pid = child.pid;
+  if (pid) {
+    try {
+      if (process.platform === "win32") {
+        void (0, import_execa3.execa)("taskkill", ["/pid", String(pid), "/T", "/F"], { reject: false });
+      } else {
+        process.kill(-pid, "SIGTERM");
+        setTimeout(() => {
+          try {
+            process.kill(-pid, "SIGKILL");
+          } catch {
+          }
+        }, 2500).unref?.();
+      }
+    } catch {
+      try {
+        child.kill("SIGTERM");
+      } catch {
+      }
+    }
+  }
+  for (const port of ports) {
+    if (!Number.isFinite(port) || port <= 0) continue;
+    if (process.platform === "win32") {
+      void (0, import_execa3.execa)(
+        "powershell",
+        [
+          "-NoProfile",
+          "-Command",
+          `Get-NetTCPConnection -LocalPort ${port} -ErrorAction SilentlyContinue | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force -ErrorAction SilentlyContinue }`
+        ],
+        { reject: false }
+      );
+    } else {
+      void (0, import_execa3.execa)(
+        "zsh",
+        ["-lc", `pids=$(lsof -tiTCP:${port} -sTCP:LISTEN 2>/dev/null); [ -n "$pids" ] && kill -TERM $pids 2>/dev/null; true`],
+        { reject: false }
+      );
+    }
+  }
+}
 async function spawnWorkspaceScript(command, opts) {
   const loginEnv = await captureLoginEnv();
   const env = buildWorkspaceScriptEnv(
@@ -6683,18 +6912,17 @@ async function spawnWorkspaceScript(command, opts) {
   const child = (0, import_execa3.execa)(shell, ["-lc", command], {
     cwd: opts.worktreePath,
     reject: false,
-    env
+    env,
+    // Own process group so Stop can tear down the whole tree (not just the shell).
+    // There is no settings.toml `stop=` / teardown hook for run scripts.
+    ...process.platform === "win32" ? {} : { detached: true }
   });
   pipeLines(child.stdout, opts.onLine);
   pipeLines(child.stderr, opts.onLine);
+  const ports = opts.ports ?? [];
   return {
     pid: child.pid,
-    kill: () => {
-      try {
-        child.kill("SIGTERM");
-      } catch {
-      }
-    },
+    kill: () => killScriptTree(child, ports),
     done: child.then((r) => r.exitCode ?? null),
     child
   };
@@ -8860,6 +9088,7 @@ async function importConductorWorkspaceAsync(workspaceId) {
 // src/orchestrator/orchestrator.ts
 var import_node_events = require("events");
 var import_node_fs24 = require("fs");
+init_error_detail();
 init_agents();
 init_worktree();
 
@@ -9155,6 +9384,11 @@ var Orchestrator = class {
    * the killed turn's handle.done resolves.
    */
   stoppedTurns = /* @__PURE__ */ new Set();
+  /**
+   * Pause drainQueue after the in-flight turn unwinds (Stop with a preserved
+   * queue). Cleared when the user sends or promotes a queued message again.
+   */
+  haltDrain = /* @__PURE__ */ new Set();
   /** WIP snapshot SHA at the start of the latest agent turn (per thread). */
   turnBaselines = /* @__PURE__ */ new Map();
   maxConcurrent;
@@ -9222,7 +9456,7 @@ var Orchestrator = class {
     } catch {
     }
     for (const thread of listThreads()) {
-      if (thread.queue.length > 0) {
+      if (thread.queue.length > 0 && thread.status !== "stopped") {
         void this.drainQueue(thread.id);
       }
     }
@@ -9283,6 +9517,7 @@ var Orchestrator = class {
     return withThreadLock(thread.id, async () => {
       const current = this.requireThread(thread.id);
       const queue = [...current.queue, prompt];
+      this.haltDrain.delete(thread.id);
       updateThread(thread.id, { queue, status: "queued" });
       this.emit({ type: "queue_changed", threadId: thread.id, queue });
       this.emit({ type: "status_changed", threadId: thread.id, status: "queued" });
@@ -9297,11 +9532,75 @@ var Orchestrator = class {
     }
     return results;
   }
+  /** Edit the text of a not-yet-started queued message. */
+  async editQueuedMessage(threadRef, index, text) {
+    const thread = this.requireThread(threadRef);
+    return withThreadLock(thread.id, async () => {
+      const current = this.requireThread(thread.id);
+      const trimmed = text.trim();
+      if (!trimmed || index < 0 || index >= current.queue.length) {
+        return current;
+      }
+      const queue = current.queue.map((p, i) => i === index ? trimmed : p);
+      updateThread(thread.id, { queue });
+      this.emit({ type: "queue_changed", threadId: thread.id, queue });
+      return this.requireThread(thread.id);
+    });
+  }
+  /** Remove a not-yet-started queued message. */
+  async removeQueuedMessage(threadRef, index) {
+    const thread = this.requireThread(threadRef);
+    return withThreadLock(thread.id, async () => {
+      const current = this.requireThread(thread.id);
+      if (index < 0 || index >= current.queue.length) return current;
+      const queue = current.queue.filter((_, i) => i !== index);
+      const stillQueued = queue.length > 0;
+      const inFlight = this.activeTurns.has(thread.id) || this.startingTurns.has(thread.id);
+      updateThread(thread.id, {
+        queue,
+        status: !stillQueued && !inFlight && current.status === "queued" ? "idle" : current.status
+      });
+      this.emit({ type: "queue_changed", threadId: thread.id, queue });
+      const next = this.requireThread(thread.id);
+      this.emit({ type: "status_changed", threadId: thread.id, status: next.status });
+      return next;
+    });
+  }
+  /**
+   * Promote a queued message to run next, interrupting the in-flight turn (if any).
+   * The current turn is stopped without clearing the rest of the queue — drainQueue
+   * picks the promoted message up as soon as the interrupted turn unwinds.
+   */
+  async sendQueuedMessageNow(threadRef, index) {
+    const thread = this.requireThread(threadRef);
+    const promoted = await withThreadLock(thread.id, async () => {
+      const current = this.requireThread(thread.id);
+      if (index < 0 || index >= current.queue.length) return false;
+      const item = current.queue[index];
+      const rest = current.queue.filter((_, i) => i !== index);
+      const queue = [item, ...rest];
+      this.haltDrain.delete(thread.id);
+      updateThread(thread.id, { queue });
+      this.emit({ type: "queue_changed", threadId: thread.id, queue });
+      return true;
+    });
+    if (!promoted) return this.requireThread(thread.id);
+    const inFlight = this.activeTurns.has(thread.id) || this.startingTurns.has(thread.id);
+    if (inFlight) {
+      this.stop(thread.id, { clearQueue: false, continueQueue: true });
+    } else {
+      void this.drainQueue(thread.id);
+    }
+    return this.requireThread(thread.id);
+  }
   async drainQueue(threadId) {
     if (this.draining.has(threadId)) return;
     this.draining.add(threadId);
     try {
       while (true) {
+        if (this.haltDrain.has(threadId)) {
+          break;
+        }
         const thread = readThread(threadId);
         if (!thread || thread.queue.length === 0) {
           if (thread && thread.status === "queued") {
@@ -9314,7 +9613,7 @@ var Orchestrator = class {
           await new Promise((r) => setTimeout(r, 250));
           continue;
         }
-        if (this.activeTurns.has(threadId)) {
+        if (this.activeTurns.has(threadId) || this.startingTurns.has(threadId)) {
           await new Promise((r) => setTimeout(r, 100));
           continue;
         }
@@ -9449,7 +9748,7 @@ var Orchestrator = class {
       ...fresh.agent === "claude" && fresh.sessionId ? [] : [instructions, seed]
     ].filter(Boolean).join("\n\n---\n\n");
     try {
-      let lastStderr = "";
+      const stderrTail = [];
       const handle = await spawnAgentTurn(
         fresh,
         { cachedPrefix, prompt: agentPrompt },
@@ -9458,8 +9757,8 @@ var Orchestrator = class {
           if (event.type === "session_id") {
             updateThread(threadId, { sessionId: event.data });
           }
-          if (event.type === "stderr" && typeof event.data === "string" && event.data.trim()) {
-            lastStderr = event.data.trim();
+          if (event.type === "stderr" && typeof event.data === "string") {
+            pushTurnStderr(stderrTail, event.data);
           }
         }
       );
@@ -9484,10 +9783,12 @@ var Orchestrator = class {
       if (result.sessionId) {
         updateThread(threadId, { sessionId: result.sessionId });
       }
-      if (result.assistantText.trim() || result.parts.length > 0) {
+      const assistantText = result.assistantText.trim();
+      const failureOnlyMessage = result.exitCode !== 0 && looksLikeAgentFailureMessage(assistantText) && !result.parts.some((p) => p.type === "tool" || p.type === "thinking");
+      if (!failureOnlyMessage && (assistantText || result.parts.length > 0)) {
         appendMessage(threadId, {
           role: "agent",
-          text: result.assistantText.trim(),
+          text: assistantText,
           parts: result.parts.length > 0 ? result.parts : void 0,
           durationMs: Math.max(0, Date.now() - turnStartedAt),
           usage: result.usage ?? void 0,
@@ -9506,7 +9807,9 @@ var Orchestrator = class {
         this.emit({ type: "status_changed", threadId, status: "stopped" });
         this.emit({ type: "turn_finished", threadId, exitCode: result.exitCode });
       } else {
-        const failDetail = lastStderr ? `exit ${result.exitCode}: ${lastStderr.slice(0, 500)}` : `exit ${result.exitCode}`;
+        const lastStderr = summarizeTurnStderr(stderrTail);
+        const detail = lastStderr || (result.exitCode !== 0 ? fallbackTurnFailDetail(assistantText) : "");
+        const failDetail = formatTurnExitError(result.exitCode, detail);
         setStatus(
           threadId,
           result.exitCode === 0 ? "idle" : "error",
@@ -9542,20 +9845,30 @@ var Orchestrator = class {
   }
   /**
    * Stop an in-flight agent turn.
-   * Default `clearQueue: true` (force-stop): kills the turn AND empties queued prompts
-   * so drainQueue cannot continue / re-start work after an intentional stop. Desktop,
-   * CLI, MCP, and cloud-connect all share this default.
+   *
+   * - Default `clearQueue: true` (force-stop): empties queued prompts so nothing
+   *   resumes. Used by MCP force-stop, archive, and cloud-connect.
+   * - Desktop Stop uses `{ clearQueue: false }` so follow-ups stay editable.
+   * - `continueQueue: true` (Send now): keep the queue and let drainQueue resume
+   *   after the interrupted turn unwinds. Without it, drain pauses until send /
+   *   promote.
    */
   stop(threadRef, opts) {
     const clearQueue = opts?.clearQueue !== false;
+    const continueQueue = opts?.continueQueue === true;
     const thread = this.requireThread(threadRef);
     const inFlight = this.activeTurns.has(thread.id) || this.startingTurns.has(thread.id);
     if (inFlight) {
       this.stoppedTurns.add(thread.id);
     }
     if (clearQueue && thread.queue.length > 0) {
+      this.haltDrain.delete(thread.id);
       updateThread(thread.id, { queue: [] });
       this.emit({ type: "queue_changed", threadId: thread.id, queue: [] });
+    } else if (!clearQueue && !continueQueue) {
+      this.haltDrain.add(thread.id);
+    } else if (continueQueue) {
+      this.haltDrain.delete(thread.id);
     }
     const handle = this.activeTurns.get(thread.id);
     if (handle) handle.kill();
@@ -10150,9 +10463,11 @@ function getOrchestrator() {
 }
 async function startOrchestration(opts) {
   const repoPath = opts.repoPath?.trim();
+  const goal = opts.goal.trim();
+  const orch = getOrchestrator();
   if (!repoPath || isGlobalRepoPath(repoPath)) {
-    return createGlobalChat({
-      sourceRef: opts.goal,
+    const thread2 = createGlobalChat({
+      sourceRef: goal,
       agent: opts.agent,
       autonomy: opts.autonomy,
       model: opts.model,
@@ -10160,9 +10475,13 @@ async function startOrchestration(opts) {
       planMode: opts.planMode,
       attachments: opts.attachments
     });
+    if (goal) {
+      return orch.send(thread2.id, goal);
+    }
+    return thread2;
   }
   const { titleFromPrompt: titleFromPrompt2 } = await Promise.resolve().then(() => (init_title(), title_exports));
-  const title = titleFromPrompt2(opts.goal) || "Orchestration";
+  const title = titleFromPrompt2(goal) || "Orchestration";
   const createOpts = {
     agent: opts.agent,
     repoPath,
@@ -10189,10 +10508,14 @@ async function startOrchestration(opts) {
     });
   });
   const { updateThread: upd } = await Promise.resolve().then(() => (init_thread_store(), thread_store_exports));
-  return upd(thread.id, {
+  const updated = upd(thread.id, {
     sourceType: "orchestration",
-    sourceRef: opts.goal
+    sourceRef: goal
   });
+  if (goal) {
+    return orch.send(updated.id, goal);
+  }
+  return updated;
 }
 
 // src/index.ts
@@ -10288,11 +10611,15 @@ async function startMcpServer() {
   );
   server.tool(
     "present_artifact",
-    "Show an HTML, SVG, or markdown document in Sideboard\u2019s Claude-style side column (desktop). Use instead of claude.ai\u2019s artifact tool \u2014 pass the full document content. Prefer type=html for interactive pages.",
+    "Show an HTML, SVG, markdown, or React document in Sideboard\u2019s Claude-style side column (desktop). Use instead of claude.ai\u2019s artifact tool \u2014 pass the full document content. Prefer type=html for interactive pages. For type=react, pass a single component module that `export default`s a component (JSX/TSX ok) \u2014 Sideboard bootstraps React/ReactDOM/Babel and renders it; only `react`/`react-dom` imports are available, no other npm packages.",
     {
       title: import_zod.z.string().describe("Short title shown in the artifact pane header"),
-      type: import_zod.z.enum(["html", "svg", "markdown"]).describe("Artifact kind \u2014 html opens an iframe preview"),
-      content: import_zod.z.string().describe("Full document body (complete HTML page, SVG markup, or markdown)"),
+      type: import_zod.z.enum(["html", "svg", "markdown", "react"]).describe(
+        "Artifact kind \u2014 html opens an iframe preview; react transpiles and renders a default-exported component in a sandboxed iframe"
+      ),
+      content: import_zod.z.string().describe(
+        "Full document body (complete HTML page, SVG markup, markdown, or a React component module with a default export)"
+      ),
       artifact_id: import_zod.z.string().optional().describe("Stable id when updating the same artifact across turns")
     },
     async ({ title, type, content, artifact_id }) => {