@sideboard-ai/core 0.1.275 → 0.1.276

package/dist/index.cjs

@@ -38738,12 +38738,61 @@ init_global_workspace();
 init_thread_store();
 init_implied_first_prompt();
 
+// src/remote/phone-media.ts
+init_diff();
+var PHONE_IMAGE_MAX_BYTES = 15e5;
+var IMAGE_MIME = {
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp",
+  bmp: "image/bmp"
+};
+function phoneWorktreeRelative(worktreePath, raw) {
+  let text6 = raw.trim();
+  if (!text6) return null;
+  if (/^file:\/\//i.test(text6)) {
+    try {
+      text6 = decodeURIComponent(new URL(text6).pathname);
+    } catch {
+      return null;
+    }
+  }
+  text6 = (text6.split("#")[0] ?? text6).replace(/\\/g, "/");
+  if (!text6 || text6.includes("\0") || text6.split("/").includes("..")) return null;
+  const root = worktreePath.replace(/\/+$/, "");
+  if (!root || root === "/") return null;
+  if (text6.startsWith("/")) {
+    if (text6 !== root && !text6.startsWith(`${root}/`)) return null;
+    text6 = text6 === root ? "" : text6.slice(root.length + 1);
+  }
+  text6 = text6.replace(/^\.\//, "").replace(/\/+$/, "");
+  if (!text6 || text6 === "." || text6.startsWith("/")) return null;
+  return text6;
+}
+function phoneImageMime(relativePath) {
+  const ext = relativePath.split(".").pop()?.toLowerCase() ?? "";
+  return IMAGE_MIME[ext] ?? null;
+}
+function phoneImageDataUrl(worktreePath, raw) {
+  const relative = phoneWorktreeRelative(worktreePath, raw);
+  if (!relative) return null;
+  const mime = phoneImageMime(relative);
+  if (!mime) return null;
+  try {
+    const file = readWorktreeFileForUpload(worktreePath, relative, { maxBytes: PHONE_IMAGE_MAX_BYTES });
+    return `data:${mime};base64,${file.contentBase64}`;
+  } catch {
+    return null;
+  }
+}
+
 // src/remote/phone-chats.ts
 var import_node_crypto25 = require("crypto");
 init_list_models();
 init_home_board();
 init_stage_files();
-init_worktree();
 init_worktree_labels();
 init_thinking_effort();
 init_app_settings();
@@ -38807,6 +38856,20 @@ function parsePhoneControl(value) {
   const chatId = typeof value.chatId === "string" ? value.chatId.trim() : "";
   if (!chatId) return "invalid";
   if (op === "open" || op === "archive" || op === "restore" || op === "stop") return { op, chatId };
+  if (op === "open-file" || op === "media") {
+    const path2 = textField(value, "path");
+    if (!path2 || path2.length > 2e3) return "invalid";
+    if (op === "media") return { op, chatId, path: path2 };
+    const startLine = lineField(value, "startLine");
+    const endLine = lineField(value, "endLine");
+    return {
+      op,
+      chatId,
+      path: path2,
+      ...startLine != null ? { startLine } : {},
+      ...endLine != null ? { endLine } : {}
+    };
+  }
   const draft = parsePhoneDraft(value);
   if (draft === "invalid") return "invalid";
   if (op === "options") return { op: "options", chatId, ...draft };
@@ -38822,6 +38885,11 @@ function textField(value, key) {
   const raw = value[key];
   return typeof raw === "string" ? raw.trim() : "";
 }
+function lineField(value, key) {
+  const raw = value[key];
+  if (typeof raw !== "number" || !Number.isInteger(raw) || raw < 1 || raw > 1e6) return void 0;
+  return raw;
+}
 function agentField(value) {
   const agent = textField(value, "agent");
   if (!agent) return void 0;
@@ -39061,13 +39129,28 @@ function listPhoneHistory(opts) {
     ...more && last ? { next: historyCursor(last) } : {}
   };
 }
-function readPhoneThread(chatId) {
+function matchPhoneThread(chatId) {
   const id = chatId.trim();
   if (!id) return null;
-  const thread = readThread(id);
+  const exact = readThread(id);
+  if (exact) return exact;
+  const match = findThreadByRef(id);
+  if (!match) return null;
+  if (match.id !== id && !match.id.startsWith(id)) return null;
+  return match;
+}
+function visiblePhoneThread(thread) {
+  if (isGlobalThread(thread)) return true;
+  return isProjectPath(thread.repoPath);
+}
+function findPhoneChat(chatId) {
+  const thread = matchPhoneThread(chatId);
+  if (!thread || !visiblePhoneThread(thread)) return null;
+  return thread;
+}
+function readPhoneThread(chatId) {
+  const thread = findPhoneChat(chatId);
   if (!thread || thread.status === "archived") return null;
-  if (isGlobalThread(thread)) return thread;
-  if (!isProjectPath(thread.repoPath)) return null;
   return thread;
 }
 function phoneComposerOptions(thread) {
@@ -39213,6 +39296,22 @@ async function createPhoneProjectWorktree(repoPathOrInput) {
   });
   return openedFrom(thread, projectPlace(thread));
 }
+async function listPhoneModels(agent) {
+  const catalogs = await listModelsForAgent(agent);
+  return (catalogs[0]?.models ?? []).slice(0, 40).map((model) => ({
+    id: model.id,
+    label: model.displayName || model.id
+  }));
+}
+function archivePhoneChat(chatId) {
+  const thread = readPhoneThread(chatId);
+  if (!thread) return false;
+  updateThread(thread.id, { status: "archived" });
+  return true;
+}
+
+// src/remote/phone-sources.ts
+init_worktree();
 function sourceWarning(label, err) {
   const message = err instanceof Error ? err.message : String(err);
   return message ? `${label}: ${message}` : `${label} failed.`;
@@ -39255,60 +39354,42 @@ async function listPhoneSources(repoPath, query) {
     ...warnings.length ? { warnings } : {}
   };
 }
-async function listPhoneModels(agent) {
-  const catalogs = await listModelsForAgent(agent);
-  return (catalogs[0]?.models ?? []).slice(0, 40).map((model) => ({
-    id: model.id,
-    label: model.displayName || model.id
-  }));
-}
-function archivePhoneChat(chatId) {
-  const thread = readPhoneThread(chatId);
-  if (!thread) return false;
-  updateThread(thread.id, { status: "archived" });
-  return true;
-}
 
-// src/remote/listen.ts
-var REMOTE_STOPPED_REPLY = "Sideboard stopped the in-progress turn.";
-function formatRemotePrompt(text6) {
-  return `Phone
+// src/remote/phone-live.ts
+init_orchestrator();
+init_thread_store();
 
-${text6.trim()}`;
+// src/remote/phone-stream.ts
+init_message_parts();
+var PHONE_STREAM_FLUSH_MS = 80;
+function phoneStreamFrame(parts) {
+  return {
+    text: visibleAssistantText(void 0, parts),
+    activity: liveActivitySummary(parts)
+  };
 }
-function isRemoteStopCommand(text6) {
-  return text6.trim().toLowerCase() === "stop";
+var SKIPPED = /* @__PURE__ */ new Set(["session_id", "usage", "stderr", "exit"]);
+function phoneStreamParts(parts, event) {
+  if (SKIPPED.has(event.type)) return null;
+  return applyAgentEvent(parts, event);
 }
-var handleChain2 = Promise.resolve();
-var inboundGeneration = 0;
+function phoneStreamFlushNow(event) {
+  return event.type === "tool_use" || event.type === "tool_result" && !event.partial;
+}
+
+// src/remote/phone-live.ts
+var REMOTE_STOPPED_REPLY = "Sideboard stopped the in-progress turn.";
 var chatChains = /* @__PURE__ */ new Map();
 var chatGeneration = /* @__PURE__ */ new Map();
-function enqueue(fn) {
-  const run2 = handleChain2.then(fn, fn);
-  handleChain2 = run2.then(
-    () => void 0,
-    () => void 0
-  );
-}
-function interruptRemoteCoordinator(deviceId, log = () => void 0) {
-  try {
-    const live = findRemoteCoordinator(deviceId);
-    if (!live) return false;
-    const fresh = readThread(live.id) ?? live;
-    if (fresh.status !== "running" && fresh.status !== "queued") return false;
-    getOrchestrator().stop(fresh.id, { clearQueue: true });
-    log(`interrupt phone \u2192 coordinator ${fresh.id.slice(0, 8)} (${fresh.status})`);
-    return true;
-  } catch (err) {
-    log(`interrupt: ${err instanceof Error ? err.message : String(err)}`);
-    return false;
-  }
-}
+var phoneTurnGen = /* @__PURE__ */ new Map();
 function bumpChat(chatId) {
   const next = (chatGeneration.get(chatId) ?? 0) + 1;
   chatGeneration.set(chatId, next);
   return next;
 }
+function finishPhoneTurn(chatId, generation) {
+  if (phoneTurnGen.get(chatId) === generation) phoneTurnGen.delete(chatId);
+}
 function enqueueChat(chatId, fn) {
   const prev = chatChains.get(chatId) ?? Promise.resolve();
   const run2 = prev.then(fn, fn);
@@ -39323,6 +39404,49 @@ function enqueueChat(chatId, fn) {
 function emitControl(opts, reply) {
   opts.onOutbound({ type: "assistant", text: encodePhoneControl(reply) });
 }
+function watchPhoneStream(opts, chatId, threadId, generation) {
+  let parts = [];
+  let timer = null;
+  let lastKey = "";
+  let closed = false;
+  const alive = () => !closed && chatGeneration.get(chatId) === generation;
+  const flush2 = () => {
+    timer = null;
+    if (!alive()) return;
+    const frame = phoneStreamFrame(parts);
+    const key = `${frame.activity}
+${frame.text}`;
+    if (key === lastKey) return;
+    if (!frame.text && !frame.activity) return;
+    lastKey = key;
+    emitControl(opts, { op: "stream", chatId, text: frame.text, activity: frame.activity });
+  };
+  const schedule = (event) => {
+    if (phoneStreamFlushNow(event) || lastKey === "") {
+      if (timer) {
+        clearTimeout(timer);
+        timer = null;
+      }
+      flush2();
+      return;
+    }
+    if (timer) return;
+    timer = setTimeout(flush2, PHONE_STREAM_FLUSH_MS);
+  };
+  const off = getOrchestrator().on((event) => {
+    if (!alive()) return;
+    if (event.type !== "turn_output" || event.threadId !== threadId) return;
+    const next = phoneStreamParts(parts, event.event);
+    if (!next) return;
+    parts = next;
+    schedule(event.event);
+  });
+  return () => {
+    closed = true;
+    if (timer) clearTimeout(timer);
+    off();
+  };
+}
 function interruptChat(chatId, log) {
   try {
     const thread = readPhoneThread(chatId);
@@ -39378,20 +39502,73 @@ function phoneError(err) {
 function deliverPhoneTurn(opts, chatId) {
   const thread = readPhoneThread(chatId);
   if (!thread || thread.status !== "running" && thread.status !== "queued") return;
-  const generation = bumpChat(chatId);
-  enqueueChat(chatId, async () => {
-    if (chatGeneration.get(chatId) !== generation) return;
+  const id = thread.id;
+  const claimed = phoneTurnGen.get(id);
+  if (claimed != null && claimed === chatGeneration.get(id)) return;
+  const generation = bumpChat(id);
+  phoneTurnGen.set(id, generation);
+  enqueueChat(id, async () => {
+    if (chatGeneration.get(id) !== generation) return;
+    const stopStream = watchPhoneStream(opts, id, id, generation);
     try {
-      await getOrchestrator().waitForTurn(chatId, 14 * 60 * 1e3);
+      await getOrchestrator().waitForTurn(id, 14 * 60 * 1e3);
     } catch (err) {
-      if (chatGeneration.get(chatId) !== generation) return;
-      emitControl(opts, { op: "error", chatId, message: `Sideboard failed: ${phoneError(err)}` });
+      stopStream();
+      finishPhoneTurn(id, generation);
+      if (chatGeneration.get(id) !== generation) return;
+      emitControl(opts, { op: "error", chatId: id, message: `Sideboard failed: ${phoneError(err)}` });
       return;
     }
-    if (chatGeneration.get(chatId) !== generation) return;
-    emitChatTurn(opts, chatId, chatId);
+    stopStream();
+    finishPhoneTurn(id, generation);
+    if (chatGeneration.get(id) !== generation) return;
+    emitChatTurn(opts, id, id);
   });
 }
+
+// src/remote/listen.ts
+function formatRemotePrompt(text6) {
+  return `Phone
+
+${text6.trim()}`;
+}
+function isRemoteStopCommand(text6) {
+  return text6.trim().toLowerCase() === "stop";
+}
+var handleChain2 = Promise.resolve();
+var inboundGeneration = 0;
+function enqueue(fn) {
+  const run2 = handleChain2.then(fn, fn);
+  handleChain2 = run2.then(
+    () => void 0,
+    () => void 0
+  );
+}
+function interruptRemoteCoordinator(deviceId, log = () => void 0) {
+  try {
+    const live = findRemoteCoordinator(deviceId);
+    if (!live) return false;
+    const fresh = readThread(live.id) ?? live;
+    if (fresh.status !== "running" && fresh.status !== "queued") return false;
+    getOrchestrator().stop(fresh.id, { clearQueue: true });
+    log(`interrupt phone \u2192 coordinator ${fresh.id.slice(0, 8)} (${fresh.status})`);
+    return true;
+  } catch (err) {
+    log(`interrupt: ${err instanceof Error ? err.message : String(err)}`);
+    return false;
+  }
+}
+function publishOpenedChat(opts, chatId) {
+  const opened = openPhoneChat(chatId);
+  if (!opened) {
+    emitControl(opts, { op: "error", message: "That agent is not on this Mac." });
+    return;
+  }
+  emitControl(opts, { op: "opened", ...opened });
+  if (opened.chat.status === "running" || opened.chat.status === "queued") {
+    deliverPhoneTurn(opts, opened.chat.id);
+  }
+}
 function applyPhoneOptions(chatId, draft) {
   const patch = {};
   if (draft.agent) patch.agent = draft.agent;
@@ -39542,12 +39719,21 @@ function handlePhoneControl(cmd, opts) {
     return;
   }
   if (cmd.op === "open") {
-    const opened = openPhoneChat(cmd.chatId);
-    if (!opened) {
+    const thread = findPhoneChat(cmd.chatId);
+    if (!thread) {
       emitControl(opts, { op: "error", message: "That agent is not on this Mac." });
       return;
     }
-    emitControl(opts, { op: "opened", ...opened });
+    if (thread.status === "archived") {
+      void getOrchestrator().restore(thread.id).then(() => {
+        emitControl(opts, { op: "sidebar", ...listPhoneSidebar() });
+        publishOpenedChat(opts, thread.id);
+      }).catch((err) => {
+        emitControl(opts, { op: "error", message: phoneError(err) });
+      });
+      return;
+    }
+    publishOpenedChat(opts, thread.id);
     return;
   }
   if (cmd.op === "archive") {
@@ -39576,6 +39762,41 @@ function handlePhoneControl(cmd, opts) {
     });
     return;
   }
+  if (cmd.op === "media") {
+    const thread = readPhoneThread(cmd.chatId);
+    const dataUrl = thread ? phoneImageDataUrl(thread.worktreePath, cmd.path) : null;
+    emitControl(opts, {
+      op: "media",
+      chatId: cmd.chatId,
+      path: cmd.path,
+      ...dataUrl ? { dataUrl } : {}
+    });
+    return;
+  }
+  if (cmd.op === "open-file") {
+    const thread = readPhoneThread(cmd.chatId);
+    const relative = thread ? phoneWorktreeRelative(thread.worktreePath, cmd.path) : null;
+    if (!thread || !relative) {
+      emitControl(opts, { op: "error", chatId: cmd.chatId, message: "That file is not in this worktree." });
+      return;
+    }
+    void getOrchestrator().statPath(thread.id, relative).then((kind) => {
+      if (kind === "missing") {
+        emitControl(opts, { op: "error", chatId: cmd.chatId, message: "That file is not in this worktree." });
+        return;
+      }
+      opts.onOpenWorktreeFile?.({
+        threadId: thread.id,
+        path: relative,
+        ...kind === "dir" ? { directory: true } : {},
+        ...cmd.startLine != null ? { startLine: cmd.startLine } : {},
+        ...cmd.endLine != null ? { endLine: cmd.endLine } : {}
+      });
+    }).catch(() => {
+      emitControl(opts, { op: "error", chatId: cmd.chatId, message: "That file is not in this worktree." });
+    });
+    return;
+  }
   if (cmd.op === "stop") {
     if (!readPhoneThread(cmd.chatId)) {
       emitControl(opts, { op: "error", chatId: cmd.chatId, message: "That agent is not on this Mac." });
@@ -39588,6 +39809,7 @@ function handlePhoneControl(cmd, opts) {
   }
   const chatId = cmd.chatId;
   const generation = bumpChat(chatId);
+  phoneTurnGen.set(chatId, generation);
   interruptChat(chatId, log);
   enqueueChat(chatId, async () => {
     if (chatGeneration.get(chatId) !== generation) return;
@@ -39603,6 +39825,7 @@ function handlePhoneControl(cmd, opts) {
       }
     }
     if (chatGeneration.get(chatId) !== generation) return;
+    const stopStream = watchPhoneStream(opts, chatId, thread.id, generation);
     try {
       try {
         applyPhoneOptions(thread.id, cmd);
@@ -39620,6 +39843,9 @@ function handlePhoneControl(cmd, opts) {
       const message = err instanceof Error ? err.message : String(err);
       emitControl(opts, { op: "error", chatId, message: `Sideboard failed: ${message}` });
       return;
+    } finally {
+      stopStream();
+      finishPhoneTurn(chatId, generation);
     }
     if (chatGeneration.get(chatId) !== generation) return;
     emitChatTurn(opts, chatId, thread.id);
@@ -39861,7 +40087,8 @@ function runRemoteHost(opts) {
       handleRemoteInbound("stop", {
         deviceId: opts.deviceId,
         onLog: log,
-        onOutbound: emit
+        onOutbound: emit,
+        onOpenWorktreeFile: opts.onOpenWorktreeFile
       });
       return;
     }
@@ -39870,7 +40097,8 @@ function runRemoteHost(opts) {
         deviceId: opts.deviceId,
         onLog: log,
         onOutbound: emit,
-        transcribeWav: opts.transcribeWav
+        transcribeWav: opts.transcribeWav,
+        onOpenWorktreeFile: opts.onOpenWorktreeFile
       });
     }
   };
@@ -40269,9 +40497,74 @@ function sendJson2(res, status, body) {
   res.writeHead(status, { "Content-Type": "application/json", "Cache-Control": "no-store" });
   res.end(JSON.stringify(body));
 }
+function relayOAuthReturnPage(title, body) {
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="robots" content="noindex">
+<title>${escapeHtml2(title)}</title>
+<style>
+  :root {
+    --bg: #09090b;
+    --card: #16171b;
+    --line: rgba(255, 255, 255, 0.08);
+    --text: #f4f5f7;
+    --muted: #9aa3ad;
+    --blue: #3b9eff;
+    --blue-fill: #0f7ed4;
+  }
+  * { box-sizing: border-box }
+  body {
+    margin: 0;
+    min-height: 100vh;
+    display: grid;
+    place-items: center;
+    padding: 48px 24px;
+    background:
+      radial-gradient(closest-side, rgba(15, 126, 212, 0.22), transparent 72%) center -120px / 720px 480px no-repeat,
+      var(--bg);
+    color: var(--text);
+    font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", "Helvetica Neue", sans-serif;
+    -webkit-font-smoothing: antialiased;
+  }
+  main {
+    width: min(28rem, 100%);
+    background: var(--card);
+    border: 1px solid var(--line);
+    border-radius: 16px;
+    padding: 28px 28px 32px;
+  }
+  .brand {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    margin: 0 0 22px;
+    font-weight: 650;
+    font-size: 17px;
+    letter-spacing: -0.02em;
+  }
+  .mark { position: relative; display: inline-block; width: 26px; height: 26px; flex: none }
+  .mark i { position: absolute; width: 18px; height: 18px; border-radius: 3px; transform: rotate(14deg) }
+  .mark i:first-child { left: 6px; top: 6px; background: var(--blue-fill) }
+  .mark i:last-child { left: 1px; top: 1px; border: 2px solid #d7dbdf }
+  h1 { margin: 0; font-size: 1.5rem; line-height: 1.2; letter-spacing: -0.03em; font-weight: 650 }
+  p { margin: 10px 0 0; line-height: 1.55; color: var(--muted) }
+  a { color: var(--blue) }
+</style>
+</head>
+<body>
+<main>
+  <div class="brand"><span class="mark" aria-hidden="true"><i></i><i></i></span>Sideboard</div>
+  ${body}
+</main>
+</body>
+</html>`;
+}
 function sendHtml(res, status, title, body) {
   res.writeHead(status, { "Content-Type": "text/html; charset=utf-8", "Cache-Control": "no-store" });
-  res.end(`<!DOCTYPE html><html><head><meta charset="utf-8"><title>${escapeHtml2(title)}</title></head><body>${body}</body></html>`);
+  res.end(relayOAuthReturnPage(title, body));
 }
 async function handleRelayAccountHttp(opts) {
   const reqUrl = opts.req.url || "/";

package/dist/index.d.cts

@@ -7151,6 +7151,14 @@ interface IpcApi {
     };
     /** Subscribe to orchestrator events; returns unsubscribe. */
     onEvent(listener: (event: OrchestratorEvent) => void): () => void;
+    /** Phone asked the Mac to open a worktree file or reveal a folder. */
+    onPhoneOpenFile(listener: (request: {
+        threadId: string;
+        path: string;
+        directory?: boolean;
+        startLine?: number;
+        endLine?: number;
+    }) => void): () => void;
     /** Subscribe to store directory changes (CLI threads appear live). */
     onThreadsChanged(listener: () => void): () => void;
     getRepoPath(): Promise<string>;
@@ -7767,6 +7775,14 @@ declare class RemoteHub {
     private fromHost;
 }
 
+type PhoneOpenFileRequest = {
+    threadId: string;
+    path: string;
+    directory?: boolean;
+    startLine?: number;
+    endLine?: number;
+};
+
 interface RemoteHostClientOptions {
     url: string;
     deviceId: string;
@@ -7783,6 +7799,8 @@ interface RemoteHostClientOptions {
     onLog?: (line: string) => void;
     /** Mac speech recognizer for a phone recording (wav base64). */
     transcribeWav?: (wavBase64: string) => Promise<string>;
+    /** Open a worktree file or folder in the desktop window. */
+    onOpenWorktreeFile?: (request: PhoneOpenFileRequest) => void;
     /** Tests: override keepalive cadence. */
     pingIntervalMs?: number;
     pongTimeoutMs?: number;
@@ -7858,8 +7876,6 @@ type RemoteServerMessage = {
     type: 'pong';
 };
 
-declare function formatRemotePrompt(text: string): string;
-declare function isRemoteStopCommand(text: string): boolean;
 type RemoteOutbound = {
     type: 'assistant';
     text: string;
@@ -7868,12 +7884,16 @@ type RemoteOutbound = {
     text: string;
     questions: RemoteAskQuestion[];
 };
+
+declare function formatRemotePrompt(text: string): string;
+declare function isRemoteStopCommand(text: string): boolean;
 declare function handleRemoteInbound(text: string, opts: {
     deviceId: string;
     agent?: AgentKind;
     onOutbound: (msg: RemoteOutbound) => void;
     onLog?: (line: string) => void;
     transcribeWav?: (wavBase64: string) => Promise<string>;
+    onOpenWorktreeFile?: (request: PhoneOpenFileRequest) => void;
 }): void;
 
 declare function isRemoteAccountLoginCancelled(err: unknown): boolean;

package/dist/index.d.ts

@@ -7151,6 +7151,14 @@ interface IpcApi {
     };
     /** Subscribe to orchestrator events; returns unsubscribe. */
     onEvent(listener: (event: OrchestratorEvent) => void): () => void;
+    /** Phone asked the Mac to open a worktree file or reveal a folder. */
+    onPhoneOpenFile(listener: (request: {
+        threadId: string;
+        path: string;
+        directory?: boolean;
+        startLine?: number;
+        endLine?: number;
+    }) => void): () => void;
     /** Subscribe to store directory changes (CLI threads appear live). */
     onThreadsChanged(listener: () => void): () => void;
     getRepoPath(): Promise<string>;
@@ -7767,6 +7775,14 @@ declare class RemoteHub {
     private fromHost;
 }
 
+type PhoneOpenFileRequest = {
+    threadId: string;
+    path: string;
+    directory?: boolean;
+    startLine?: number;
+    endLine?: number;
+};
+
 interface RemoteHostClientOptions {
     url: string;
     deviceId: string;
@@ -7783,6 +7799,8 @@ interface RemoteHostClientOptions {
     onLog?: (line: string) => void;
     /** Mac speech recognizer for a phone recording (wav base64). */
     transcribeWav?: (wavBase64: string) => Promise<string>;
+    /** Open a worktree file or folder in the desktop window. */
+    onOpenWorktreeFile?: (request: PhoneOpenFileRequest) => void;
     /** Tests: override keepalive cadence. */
     pingIntervalMs?: number;
     pongTimeoutMs?: number;
@@ -7858,8 +7876,6 @@ type RemoteServerMessage = {
     type: 'pong';
 };
 
-declare function formatRemotePrompt(text: string): string;
-declare function isRemoteStopCommand(text: string): boolean;
 type RemoteOutbound = {
     type: 'assistant';
     text: string;
@@ -7868,12 +7884,16 @@ type RemoteOutbound = {
     text: string;
     questions: RemoteAskQuestion[];
 };
+
+declare function formatRemotePrompt(text: string): string;
+declare function isRemoteStopCommand(text: string): boolean;
 declare function handleRemoteInbound(text: string, opts: {
     deviceId: string;
     agent?: AgentKind;
     onOutbound: (msg: RemoteOutbound) => void;
     onLog?: (line: string) => void;
     transcribeWav?: (wavBase64: string) => Promise<string>;
+    onOpenWorktreeFile?: (request: PhoneOpenFileRequest) => void;
 }): void;
 
 declare function isRemoteAccountLoginCancelled(err: unknown): boolean;

package/dist/index.js

@@ -9375,6 +9375,55 @@ var RemoteHub = class {
 // src/remote/client.ts
 import { WebSocket as WsWebSocket3 } from "ws";
 
+// src/remote/phone-media.ts
+var PHONE_IMAGE_MAX_BYTES = 15e5;
+var IMAGE_MIME = {
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp",
+  bmp: "image/bmp"
+};
+function phoneWorktreeRelative(worktreePath, raw) {
+  let text6 = raw.trim();
+  if (!text6) return null;
+  if (/^file:\/\//i.test(text6)) {
+    try {
+      text6 = decodeURIComponent(new URL(text6).pathname);
+    } catch {
+      return null;
+    }
+  }
+  text6 = (text6.split("#")[0] ?? text6).replace(/\\/g, "/");
+  if (!text6 || text6.includes("\0") || text6.split("/").includes("..")) return null;
+  const root = worktreePath.replace(/\/+$/, "");
+  if (!root || root === "/") return null;
+  if (text6.startsWith("/")) {
+    if (text6 !== root && !text6.startsWith(`${root}/`)) return null;
+    text6 = text6 === root ? "" : text6.slice(root.length + 1);
+  }
+  text6 = text6.replace(/^\.\//, "").replace(/\/+$/, "");
+  if (!text6 || text6 === "." || text6.startsWith("/")) return null;
+  return text6;
+}
+function phoneImageMime(relativePath) {
+  const ext = relativePath.split(".").pop()?.toLowerCase() ?? "";
+  return IMAGE_MIME[ext] ?? null;
+}
+function phoneImageDataUrl(worktreePath, raw) {
+  const relative = phoneWorktreeRelative(worktreePath, raw);
+  if (!relative) return null;
+  const mime = phoneImageMime(relative);
+  if (!mime) return null;
+  try {
+    const file = readWorktreeFileForUpload(worktreePath, relative, { maxBytes: PHONE_IMAGE_MAX_BYTES });
+    return `data:${mime};base64,${file.contentBase64}`;
+  } catch {
+    return null;
+  }
+}
+
 // src/remote/phone-chats.ts
 import { randomUUID as randomUUID7 } from "crypto";
 var PHONE_CONTROL_PREFIX = "\0sb.phone\n";
@@ -9431,6 +9480,20 @@ function parsePhoneControl(value) {
   const chatId = typeof value.chatId === "string" ? value.chatId.trim() : "";
   if (!chatId) return "invalid";
   if (op === "open" || op === "archive" || op === "restore" || op === "stop") return { op, chatId };
+  if (op === "open-file" || op === "media") {
+    const path2 = textField(value, "path");
+    if (!path2 || path2.length > 2e3) return "invalid";
+    if (op === "media") return { op, chatId, path: path2 };
+    const startLine = lineField(value, "startLine");
+    const endLine = lineField(value, "endLine");
+    return {
+      op,
+      chatId,
+      path: path2,
+      ...startLine != null ? { startLine } : {},
+      ...endLine != null ? { endLine } : {}
+    };
+  }
   const draft = parsePhoneDraft(value);
   if (draft === "invalid") return "invalid";
   if (op === "options") return { op: "options", chatId, ...draft };
@@ -9446,6 +9509,11 @@ function textField(value, key) {
   const raw = value[key];
   return typeof raw === "string" ? raw.trim() : "";
 }
+function lineField(value, key) {
+  const raw = value[key];
+  if (typeof raw !== "number" || !Number.isInteger(raw) || raw < 1 || raw > 1e6) return void 0;
+  return raw;
+}
 function agentField(value) {
   const agent = textField(value, "agent");
   if (!agent) return void 0;
@@ -9685,13 +9753,28 @@ function listPhoneHistory(opts) {
     ...more && last ? { next: historyCursor(last) } : {}
   };
 }
-function readPhoneThread(chatId) {
+function matchPhoneThread(chatId) {
   const id = chatId.trim();
   if (!id) return null;
-  const thread = readThread(id);
+  const exact = readThread(id);
+  if (exact) return exact;
+  const match = findThreadByRef(id);
+  if (!match) return null;
+  if (match.id !== id && !match.id.startsWith(id)) return null;
+  return match;
+}
+function visiblePhoneThread(thread) {
+  if (isGlobalThread(thread)) return true;
+  return isProjectPath(thread.repoPath);
+}
+function findPhoneChat(chatId) {
+  const thread = matchPhoneThread(chatId);
+  if (!thread || !visiblePhoneThread(thread)) return null;
+  return thread;
+}
+function readPhoneThread(chatId) {
+  const thread = findPhoneChat(chatId);
   if (!thread || thread.status === "archived") return null;
-  if (isGlobalThread(thread)) return thread;
-  if (!isProjectPath(thread.repoPath)) return null;
   return thread;
 }
 function phoneComposerOptions(thread) {
@@ -9837,6 +9920,21 @@ async function createPhoneProjectWorktree(repoPathOrInput) {
   });
   return openedFrom(thread, projectPlace(thread));
 }
+async function listPhoneModels(agent) {
+  const catalogs = await listModelsForAgent(agent);
+  return (catalogs[0]?.models ?? []).slice(0, 40).map((model) => ({
+    id: model.id,
+    label: model.displayName || model.id
+  }));
+}
+function archivePhoneChat(chatId) {
+  const thread = readPhoneThread(chatId);
+  if (!thread) return false;
+  updateThread(thread.id, { status: "archived" });
+  return true;
+}
+
+// src/remote/phone-sources.ts
 function sourceWarning(label, err) {
   const message = err instanceof Error ? err.message : String(err);
   return message ? `${label}: ${message}` : `${label} failed.`;
@@ -9879,60 +9977,37 @@ async function listPhoneSources(repoPath, query) {
     ...warnings.length ? { warnings } : {}
   };
 }
-async function listPhoneModels(agent) {
-  const catalogs = await listModelsForAgent(agent);
-  return (catalogs[0]?.models ?? []).slice(0, 40).map((model) => ({
-    id: model.id,
-    label: model.displayName || model.id
-  }));
+
+// src/remote/phone-stream.ts
+var PHONE_STREAM_FLUSH_MS = 80;
+function phoneStreamFrame(parts) {
+  return {
+    text: visibleAssistantText(void 0, parts),
+    activity: liveActivitySummary(parts)
+  };
 }
-function archivePhoneChat(chatId) {
-  const thread = readPhoneThread(chatId);
-  if (!thread) return false;
-  updateThread(thread.id, { status: "archived" });
-  return true;
+var SKIPPED = /* @__PURE__ */ new Set(["session_id", "usage", "stderr", "exit"]);
+function phoneStreamParts(parts, event) {
+  if (SKIPPED.has(event.type)) return null;
+  return applyAgentEvent(parts, event);
+}
+function phoneStreamFlushNow(event) {
+  return event.type === "tool_use" || event.type === "tool_result" && !event.partial;
 }
 
-// src/remote/listen.ts
+// src/remote/phone-live.ts
 var REMOTE_STOPPED_REPLY = "Sideboard stopped the in-progress turn.";
-function formatRemotePrompt(text6) {
-  return `Phone
-
-${text6.trim()}`;
-}
-function isRemoteStopCommand(text6) {
-  return text6.trim().toLowerCase() === "stop";
-}
-var handleChain2 = Promise.resolve();
-var inboundGeneration = 0;
 var chatChains = /* @__PURE__ */ new Map();
 var chatGeneration = /* @__PURE__ */ new Map();
-function enqueue(fn) {
-  const run2 = handleChain2.then(fn, fn);
-  handleChain2 = run2.then(
-    () => void 0,
-    () => void 0
-  );
-}
-function interruptRemoteCoordinator(deviceId, log = () => void 0) {
-  try {
-    const live = findRemoteCoordinator(deviceId);
-    if (!live) return false;
-    const fresh = readThread(live.id) ?? live;
-    if (fresh.status !== "running" && fresh.status !== "queued") return false;
-    getOrchestrator().stop(fresh.id, { clearQueue: true });
-    log(`interrupt phone \u2192 coordinator ${fresh.id.slice(0, 8)} (${fresh.status})`);
-    return true;
-  } catch (err) {
-    log(`interrupt: ${err instanceof Error ? err.message : String(err)}`);
-    return false;
-  }
-}
+var phoneTurnGen = /* @__PURE__ */ new Map();
 function bumpChat(chatId) {
   const next = (chatGeneration.get(chatId) ?? 0) + 1;
   chatGeneration.set(chatId, next);
   return next;
 }
+function finishPhoneTurn(chatId, generation) {
+  if (phoneTurnGen.get(chatId) === generation) phoneTurnGen.delete(chatId);
+}
 function enqueueChat(chatId, fn) {
   const prev = chatChains.get(chatId) ?? Promise.resolve();
   const run2 = prev.then(fn, fn);
@@ -9947,6 +10022,49 @@ function enqueueChat(chatId, fn) {
 function emitControl(opts, reply) {
   opts.onOutbound({ type: "assistant", text: encodePhoneControl(reply) });
 }
+function watchPhoneStream(opts, chatId, threadId, generation) {
+  let parts = [];
+  let timer = null;
+  let lastKey = "";
+  let closed = false;
+  const alive = () => !closed && chatGeneration.get(chatId) === generation;
+  const flush = () => {
+    timer = null;
+    if (!alive()) return;
+    const frame = phoneStreamFrame(parts);
+    const key = `${frame.activity}
+${frame.text}`;
+    if (key === lastKey) return;
+    if (!frame.text && !frame.activity) return;
+    lastKey = key;
+    emitControl(opts, { op: "stream", chatId, text: frame.text, activity: frame.activity });
+  };
+  const schedule = (event) => {
+    if (phoneStreamFlushNow(event) || lastKey === "") {
+      if (timer) {
+        clearTimeout(timer);
+        timer = null;
+      }
+      flush();
+      return;
+    }
+    if (timer) return;
+    timer = setTimeout(flush, PHONE_STREAM_FLUSH_MS);
+  };
+  const off = getOrchestrator().on((event) => {
+    if (!alive()) return;
+    if (event.type !== "turn_output" || event.threadId !== threadId) return;
+    const next = phoneStreamParts(parts, event.event);
+    if (!next) return;
+    parts = next;
+    schedule(event.event);
+  });
+  return () => {
+    closed = true;
+    if (timer) clearTimeout(timer);
+    off();
+  };
+}
 function interruptChat(chatId, log) {
   try {
     const thread = readPhoneThread(chatId);
@@ -10002,20 +10120,73 @@ function phoneError(err) {
 function deliverPhoneTurn(opts, chatId) {
   const thread = readPhoneThread(chatId);
   if (!thread || thread.status !== "running" && thread.status !== "queued") return;
-  const generation = bumpChat(chatId);
-  enqueueChat(chatId, async () => {
-    if (chatGeneration.get(chatId) !== generation) return;
+  const id = thread.id;
+  const claimed = phoneTurnGen.get(id);
+  if (claimed != null && claimed === chatGeneration.get(id)) return;
+  const generation = bumpChat(id);
+  phoneTurnGen.set(id, generation);
+  enqueueChat(id, async () => {
+    if (chatGeneration.get(id) !== generation) return;
+    const stopStream = watchPhoneStream(opts, id, id, generation);
     try {
-      await getOrchestrator().waitForTurn(chatId, 14 * 60 * 1e3);
+      await getOrchestrator().waitForTurn(id, 14 * 60 * 1e3);
     } catch (err) {
-      if (chatGeneration.get(chatId) !== generation) return;
-      emitControl(opts, { op: "error", chatId, message: `Sideboard failed: ${phoneError(err)}` });
+      stopStream();
+      finishPhoneTurn(id, generation);
+      if (chatGeneration.get(id) !== generation) return;
+      emitControl(opts, { op: "error", chatId: id, message: `Sideboard failed: ${phoneError(err)}` });
       return;
     }
-    if (chatGeneration.get(chatId) !== generation) return;
-    emitChatTurn(opts, chatId, chatId);
+    stopStream();
+    finishPhoneTurn(id, generation);
+    if (chatGeneration.get(id) !== generation) return;
+    emitChatTurn(opts, id, id);
   });
 }
+
+// src/remote/listen.ts
+function formatRemotePrompt(text6) {
+  return `Phone
+
+${text6.trim()}`;
+}
+function isRemoteStopCommand(text6) {
+  return text6.trim().toLowerCase() === "stop";
+}
+var handleChain2 = Promise.resolve();
+var inboundGeneration = 0;
+function enqueue(fn) {
+  const run2 = handleChain2.then(fn, fn);
+  handleChain2 = run2.then(
+    () => void 0,
+    () => void 0
+  );
+}
+function interruptRemoteCoordinator(deviceId, log = () => void 0) {
+  try {
+    const live = findRemoteCoordinator(deviceId);
+    if (!live) return false;
+    const fresh = readThread(live.id) ?? live;
+    if (fresh.status !== "running" && fresh.status !== "queued") return false;
+    getOrchestrator().stop(fresh.id, { clearQueue: true });
+    log(`interrupt phone \u2192 coordinator ${fresh.id.slice(0, 8)} (${fresh.status})`);
+    return true;
+  } catch (err) {
+    log(`interrupt: ${err instanceof Error ? err.message : String(err)}`);
+    return false;
+  }
+}
+function publishOpenedChat(opts, chatId) {
+  const opened = openPhoneChat(chatId);
+  if (!opened) {
+    emitControl(opts, { op: "error", message: "That agent is not on this Mac." });
+    return;
+  }
+  emitControl(opts, { op: "opened", ...opened });
+  if (opened.chat.status === "running" || opened.chat.status === "queued") {
+    deliverPhoneTurn(opts, opened.chat.id);
+  }
+}
 function applyPhoneOptions(chatId, draft) {
   const patch = {};
   if (draft.agent) patch.agent = draft.agent;
@@ -10166,12 +10337,21 @@ function handlePhoneControl(cmd, opts) {
     return;
   }
   if (cmd.op === "open") {
-    const opened = openPhoneChat(cmd.chatId);
-    if (!opened) {
+    const thread = findPhoneChat(cmd.chatId);
+    if (!thread) {
       emitControl(opts, { op: "error", message: "That agent is not on this Mac." });
       return;
     }
-    emitControl(opts, { op: "opened", ...opened });
+    if (thread.status === "archived") {
+      void getOrchestrator().restore(thread.id).then(() => {
+        emitControl(opts, { op: "sidebar", ...listPhoneSidebar() });
+        publishOpenedChat(opts, thread.id);
+      }).catch((err) => {
+        emitControl(opts, { op: "error", message: phoneError(err) });
+      });
+      return;
+    }
+    publishOpenedChat(opts, thread.id);
     return;
   }
   if (cmd.op === "archive") {
@@ -10200,6 +10380,41 @@ function handlePhoneControl(cmd, opts) {
     });
     return;
   }
+  if (cmd.op === "media") {
+    const thread = readPhoneThread(cmd.chatId);
+    const dataUrl = thread ? phoneImageDataUrl(thread.worktreePath, cmd.path) : null;
+    emitControl(opts, {
+      op: "media",
+      chatId: cmd.chatId,
+      path: cmd.path,
+      ...dataUrl ? { dataUrl } : {}
+    });
+    return;
+  }
+  if (cmd.op === "open-file") {
+    const thread = readPhoneThread(cmd.chatId);
+    const relative = thread ? phoneWorktreeRelative(thread.worktreePath, cmd.path) : null;
+    if (!thread || !relative) {
+      emitControl(opts, { op: "error", chatId: cmd.chatId, message: "That file is not in this worktree." });
+      return;
+    }
+    void getOrchestrator().statPath(thread.id, relative).then((kind) => {
+      if (kind === "missing") {
+        emitControl(opts, { op: "error", chatId: cmd.chatId, message: "That file is not in this worktree." });
+        return;
+      }
+      opts.onOpenWorktreeFile?.({
+        threadId: thread.id,
+        path: relative,
+        ...kind === "dir" ? { directory: true } : {},
+        ...cmd.startLine != null ? { startLine: cmd.startLine } : {},
+        ...cmd.endLine != null ? { endLine: cmd.endLine } : {}
+      });
+    }).catch(() => {
+      emitControl(opts, { op: "error", chatId: cmd.chatId, message: "That file is not in this worktree." });
+    });
+    return;
+  }
   if (cmd.op === "stop") {
     if (!readPhoneThread(cmd.chatId)) {
       emitControl(opts, { op: "error", chatId: cmd.chatId, message: "That agent is not on this Mac." });
@@ -10212,6 +10427,7 @@ function handlePhoneControl(cmd, opts) {
   }
   const chatId = cmd.chatId;
   const generation = bumpChat(chatId);
+  phoneTurnGen.set(chatId, generation);
   interruptChat(chatId, log);
   enqueueChat(chatId, async () => {
     if (chatGeneration.get(chatId) !== generation) return;
@@ -10227,6 +10443,7 @@ function handlePhoneControl(cmd, opts) {
       }
     }
     if (chatGeneration.get(chatId) !== generation) return;
+    const stopStream = watchPhoneStream(opts, chatId, thread.id, generation);
     try {
       try {
         applyPhoneOptions(thread.id, cmd);
@@ -10244,6 +10461,9 @@ function handlePhoneControl(cmd, opts) {
       const message = err instanceof Error ? err.message : String(err);
       emitControl(opts, { op: "error", chatId, message: `Sideboard failed: ${message}` });
       return;
+    } finally {
+      stopStream();
+      finishPhoneTurn(chatId, generation);
     }
     if (chatGeneration.get(chatId) !== generation) return;
     emitChatTurn(opts, chatId, thread.id);
@@ -10485,7 +10705,8 @@ function runRemoteHost(opts) {
       handleRemoteInbound("stop", {
         deviceId: opts.deviceId,
         onLog: log,
-        onOutbound: emit
+        onOutbound: emit,
+        onOpenWorktreeFile: opts.onOpenWorktreeFile
       });
       return;
     }
@@ -10494,7 +10715,8 @@ function runRemoteHost(opts) {
         deviceId: opts.deviceId,
         onLog: log,
         onOutbound: emit,
-        transcribeWav: opts.transcribeWav
+        transcribeWav: opts.transcribeWav,
+        onOpenWorktreeFile: opts.onOpenWorktreeFile
       });
     }
   };
@@ -10893,9 +11115,74 @@ function sendJson2(res, status, body) {
   res.writeHead(status, { "Content-Type": "application/json", "Cache-Control": "no-store" });
   res.end(JSON.stringify(body));
 }
+function relayOAuthReturnPage(title, body) {
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="robots" content="noindex">
+<title>${escapeHtml(title)}</title>
+<style>
+  :root {
+    --bg: #09090b;
+    --card: #16171b;
+    --line: rgba(255, 255, 255, 0.08);
+    --text: #f4f5f7;
+    --muted: #9aa3ad;
+    --blue: #3b9eff;
+    --blue-fill: #0f7ed4;
+  }
+  * { box-sizing: border-box }
+  body {
+    margin: 0;
+    min-height: 100vh;
+    display: grid;
+    place-items: center;
+    padding: 48px 24px;
+    background:
+      radial-gradient(closest-side, rgba(15, 126, 212, 0.22), transparent 72%) center -120px / 720px 480px no-repeat,
+      var(--bg);
+    color: var(--text);
+    font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", "Helvetica Neue", sans-serif;
+    -webkit-font-smoothing: antialiased;
+  }
+  main {
+    width: min(28rem, 100%);
+    background: var(--card);
+    border: 1px solid var(--line);
+    border-radius: 16px;
+    padding: 28px 28px 32px;
+  }
+  .brand {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    margin: 0 0 22px;
+    font-weight: 650;
+    font-size: 17px;
+    letter-spacing: -0.02em;
+  }
+  .mark { position: relative; display: inline-block; width: 26px; height: 26px; flex: none }
+  .mark i { position: absolute; width: 18px; height: 18px; border-radius: 3px; transform: rotate(14deg) }
+  .mark i:first-child { left: 6px; top: 6px; background: var(--blue-fill) }
+  .mark i:last-child { left: 1px; top: 1px; border: 2px solid #d7dbdf }
+  h1 { margin: 0; font-size: 1.5rem; line-height: 1.2; letter-spacing: -0.03em; font-weight: 650 }
+  p { margin: 10px 0 0; line-height: 1.55; color: var(--muted) }
+  a { color: var(--blue) }
+</style>
+</head>
+<body>
+<main>
+  <div class="brand"><span class="mark" aria-hidden="true"><i></i><i></i></span>Sideboard</div>
+  ${body}
+</main>
+</body>
+</html>`;
+}
 function sendHtml(res, status, title, body) {
   res.writeHead(status, { "Content-Type": "text/html; charset=utf-8", "Cache-Control": "no-store" });
-  res.end(`<!DOCTYPE html><html><head><meta charset="utf-8"><title>${escapeHtml(title)}</title></head><body>${body}</body></html>`);
+  res.end(relayOAuthReturnPage(title, body));
 }
 async function handleRelayAccountHttp(opts) {
   const reqUrl = opts.req.url || "/";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sideboard-ai/core",
-  "version": "0.1.275",
+  "version": "0.1.276",
   "description": "Sideboard core — orchestration, agents, git worktrees, MCP server",
   "license": "Apache-2.0",
   "type": "module",