@todoforai/cli 0.1.15 → 0.1.17

package/README.md

@@ -6,11 +6,13 @@ CLI for [TODOforAI](https://todofor.ai) — create, watch, and inspect AI-powere
 
 ```bash
 bun install -g @todoforai/cli
+# Install the native bridge once, if it is not already on PATH:
+curl -fsSL https://raw.githubusercontent.com/todoforai/bridge/main/install.sh | sh
 ```
 
 ## Setup
 
-Just run `todoforai-cli` — on first use it opens a browser for **device login** and saves the API key to `~/.todoforai/credentials.json` (shared with the edge daemon).
+Just run `todoforai-cli` — on first use it opens a browser for **device login** and saves the CLI API key in the shared TODOforAI credentials file. The bridge uses the same file for its own device credentials.
 
 ```bash
 todoforai-cli                # prompts device login if no key found
@@ -19,15 +21,15 @@ todoforai-cli login          # explicit login
 
 API URL resolution: `--api-url` flag → `TODOFORAI_API_URL` env → `https://api.todofor.ai`.
 
-Auth resolution: `--api-key` flag → `TODOFORAI_API_KEY` env → shared credentials (`~/.todoforai/credentials.json`) → device login.
+Auth resolution: `--api-key` flag → `TODOFORAI_API_KEY` env → shared credentials file → device login.
 
 Project, agent, and last-todo state are stored **per API URL** under `per_api_url[<url>]` in the config — switching between e.g. `https://api.todofor.ai` and `http://localhost:4000` keeps each environment's defaults isolated. Legacy top-level fields are auto-migrated on first run.
 
-## Edge daemon
+## Bridge
 
-The CLI talks to the backend over WebSocket; **shell execution, file I/O, and tool calls happen in the edge daemon** running locally. On every run `todoforai-cli` spawns a detached edge process if none is running (PID-locked at `~/.todoforai/edge-<hash>.lock`, logs at `~/.todoforai/edge.log`). It keeps running after the CLI exits, so long-running tasks survive `Ctrl+D`.
+The CLI talks to the backend over WebSocket; **shell execution, file I/O, and tool calls happen in the bridge** running locally. On create/resume/template runs, `todoforai-cli` starts a detached `todoforai-bridge` process if needed (the bridge enforces its own single-instance lock, logs at `~/.todoforai/bridge.log`). If bridge credentials are missing, the CLI runs `todoforai-bridge login` in the foreground first so you can see and approve the device-login URL. The bridge keeps running after the CLI exits, so long-running tasks survive `Ctrl+D`.
 
-Disable with `--no-edge` if you manage the edge yourself (e.g. systemd, separate terminal).
+Disable with `--no-bridge` if you manage the bridge yourself (e.g. systemd, separate terminal). `--no-edge` remains supported as a deprecated alias.
 
 ## Usage
 
@@ -82,7 +84,8 @@ todoforai-cli --resume <todo-id>     # resume specific todo
 --dangerously-skip-permissions  Auto-approve all blocks (CI/benchmarks)
 --allow-all                     Set permissions to allow all tools (no approval needed)
 --no-watch                      Create todo and exit
---no-edge                       Do not auto-spawn edge daemon
+--no-bridge                     Do not auto-spawn bridge
+--no-edge                       Deprecated alias for --no-bridge
 --json                          Output as JSON
 --safe                          Validate API key upfront
 --debug, -d                     Debug output

package/dist/todoai.js

@@ -41805,15 +41805,15 @@ var require_route = __commonJS((exports, module) => {
     };
   }
   function wrapConversion(toModel, graph) {
-    const path3 = [graph[toModel].parent, toModel];
+    const path4 = [graph[toModel].parent, toModel];
     let fn = conversions[graph[toModel].parent][toModel];
     let cur = graph[toModel].parent;
     while (graph[cur].parent) {
-      path3.unshift(graph[cur].parent);
+      path4.unshift(graph[cur].parent);
       fn = link(conversions[graph[cur].parent][cur], fn);
       cur = graph[cur].parent;
     }
-    fn.conversion = path3;
+    fn.conversion = path4;
     return fn;
   }
   module.exports = function(fromModel) {
@@ -42039,7 +42039,7 @@ var require_has_flag = __commonJS((exports, module) => {
 
 // node_modules/supports-color/index.js
 var require_supports_color = __commonJS((exports, module) => {
-  var os3 = __require("os");
+  var os4 = __require("os");
   var tty = __require("tty");
   var hasFlag = require_has_flag();
   var { env } = process;
@@ -42087,7 +42087,7 @@ var require_supports_color = __commonJS((exports, module) => {
       return min;
     }
     if (process.platform === "win32") {
-      const osRelease = os3.release().split(".");
+      const osRelease = os4.release().split(".");
       if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
         return Number(osRelease[2]) >= 14931 ? 3 : 2;
       }
@@ -42866,6 +42866,12 @@ class ApiClient {
   listEdges() {
     return this.request("GET", "/api/v1/edges");
   }
+  setAgentDeviceConfig(agentId, agentSettingsId, deviceId, config) {
+    return this.request("PUT", `/api/v1/agents/${agentId}/device-config`, { agentSettingsId, deviceId, config });
+  }
+  listDevices() {
+    return this.request("GET", "/api/v1/devices");
+  }
   startFromTemplate(projectId, templateId, opts) {
     return this.request("POST", `/api/v1/projects/${projectId}/todos/from-template`, {
       templateId,
@@ -43327,50 +43333,6 @@ var EDGE_TOOL_TYPES = new Set([
   "grep" /* Grep */,
   "list" /* List */
 ]);
-var BROWSER_TOOL_TYPES = new Set([
-  "browser_interactable" /* BrowserInteractable */,
-  "browser_dom_tree" /* BrowserDomTree */,
-  "browser_navigate" /* BrowserNavigate */,
-  "browser_screenshot" /* BrowserScreenshot */,
-  "browser_click" /* BrowserClick */,
-  "browser_type" /* BrowserType */,
-  "browser_fill" /* BrowserFill */,
-  "browser_scroll" /* BrowserScroll */,
-  "browser_mouse_move" /* BrowserMouseMove */,
-  "browser_key" /* BrowserKey */,
-  "browser_evaluate" /* BrowserEvaluate */,
-  "browser_select" /* BrowserSelect */,
-  "browser_hover" /* BrowserHover */,
-  "browser_text_content" /* BrowserTextContent */,
-  "browser_back" /* BrowserBack */,
-  "browser_forward" /* BrowserForward */,
-  "browser_reload" /* BrowserReload */,
-  "browser_upload_file" /* BrowserUploadFile */,
-  "browser_find_text" /* BrowserFindText */,
-  "browser_find_role" /* BrowserFindRole */,
-  "browser_find_label" /* BrowserFindLabel */,
-  "browser_find_placeholder" /* BrowserFindPlaceholder */,
-  "browser_wait" /* BrowserWait */,
-  "browser_drag" /* BrowserDrag */,
-  "browser_dialog" /* BrowserDialog */,
-  "browser_network_wait" /* BrowserNetworkWait */,
-  "browser_check" /* BrowserCheck */,
-  "browser_uncheck" /* BrowserUncheck */,
-  "browser_focus" /* BrowserFocus */,
-  "browser_find_test_id" /* BrowserFindTestId */,
-  "browser_cookies" /* BrowserCookies */,
-  "browser_storage" /* BrowserStorage */,
-  "browser_pdf" /* BrowserPdf */,
-  "browser_clipboard_read" /* BrowserClipboardRead */,
-  "browser_clipboard_write" /* BrowserClipboardWrite */,
-  "browser_snapshot" /* BrowserSnapshot */,
-  "browser_iframe" /* BrowserIframe */,
-  "browser_console" /* BrowserConsole */,
-  "browser_scroll_into_view" /* BrowserScrollIntoView */,
-  "browser_network_requests" /* BrowserNetworkRequests */,
-  "browser_tap" /* BrowserTap */,
-  "browser_swipe" /* BrowserSwipe */
-]);
 var API_TOOL_TYPES = new Set([
   "api_get_current_context" /* ApiGetCurrentContext */,
   "api_get_todo" /* ApiGetTodo */,
@@ -43461,6 +43423,8 @@ var SERVER_TO_FRONTENDS = {
     frontend_file_chunk_result: (todoId) => `${"frontend:file_chunk_result" /* FRONTEND_FILE_CHUNK_RESULT */}:${todoId}`,
     status: (todoId) => `todo:${todoId}:status`,
     block_update: (todoId) => `todo:${todoId}:block_update`,
+    context_summary_updated: (todoId) => `${"context:summary_updated" /* CONTEXT_SUMMARY_UPDATED */}:${todoId}`,
+    context_info_updated: (todoId) => `${"context:info_updated" /* CONTEXT_INFO_UPDATED */}:${todoId}`,
     error_result: (todoId) => `${"block:error_result" /* BLOCK_ERROR_RESULT */}:${todoId}`,
     meta_result: (todoId) => `${"block:meta_result" /* BLOCK_META_RESULT */}:${todoId}`,
     file_changed: (edgeId, path3) => `${"block:file_changed" /* BLOCK_FILE_CHANGED */}:${edgeId}:${path3}`,
@@ -43863,6 +43827,14 @@ var TOPICS = {
     channel: (p) => SERVER_TO_FRONTENDS.resource.contentUpdated(p.userId),
     audience: "frontend"
   },
+  ["context:summary_updated" /* CONTEXT_SUMMARY_UPDATED */]: {
+    channel: (p) => SERVER_TO_FRONTENDS.todo.context_summary_updated(p.todoId),
+    audience: "frontend"
+  },
+  ["context:info_updated" /* CONTEXT_INFO_UPDATED */]: {
+    channel: (p) => SERVER_TO_FRONTENDS.todo.context_info_updated(p.todoId),
+    audience: "frontend"
+  },
   ["hexgrid:updated" /* HEXGRID_UPDATED */]: {
     channel: (p) => SERVER_TO_FRONTENDS.hexGrid.updated(p.projectId),
     audience: "frontend"
@@ -44008,7 +43980,8 @@ Options:
   --allow-all                     Set permissions to allow all tools (no approval needed)
   --raw-sysmsg <file>             Use file contents verbatim as system prompt (new TODO only)
   --no-watch                      Create todo and exit
-  --no-edge                       Do not auto-spawn edge daemon
+  --no-bridge                     Do not auto-spawn bridge
+  --no-edge                       Deprecated alias for --no-bridge
   --json                          Output as JSON
   --detailed                      'inspect --json': keep ids, timestamps, agentSettingsId, scheduledTimestamp
   --format-anthropic              'inspect --json': Anthropic-style shape (tool_result in next user msg); attachment sources are uri-typed, so not a 1:1 messages.create input
@@ -44062,6 +44035,7 @@ function parseCliArgs() {
       "allow-all": { type: "boolean", default: false },
       "raw-sysmsg": { type: "string" },
       "no-watch": { type: "boolean", default: false },
+      "no-bridge": { type: "boolean", default: false },
       "no-edge": { type: "boolean", default: false },
       json: { type: "boolean", default: false },
       detailed: { type: "boolean", default: false },
@@ -44077,6 +44051,8 @@ function parseCliArgs() {
     allowPositionals: true,
     strict: false
   });
+  if (values["no-edge"])
+    values["no-bridge"] = true;
   return { values, positionals };
 }
 
@@ -44423,12 +44399,134 @@ Cancelled
 
 // src/agent.ts
 import { resolve, basename } from "path";
+
+// src/ensure-bridge.ts
+import { spawn, spawnSync } from "child_process";
+import fs2 from "fs";
+import path3 from "path";
+import os3 from "os";
+function hasBridge() {
+  const probe = spawnSync("todoforai-bridge", ["--version"], { stdio: "ignore" });
+  return probe.status === 0;
+}
+function isLocalHost(hostname) {
+  return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1" || hostname === "[::1]";
+}
+function parseApiUrl(apiUrl) {
+  try {
+    return new URL(apiUrl);
+  } catch {
+    return null;
+  }
+}
+function bridgeProfile(apiUrl) {
+  const url = parseApiUrl(apiUrl);
+  if (!url)
+    return null;
+  if (isLocalHost(url.hostname))
+    return "dev";
+  if (!url.hostname || url.hostname === "api.todofor.ai")
+    return null;
+  return `api_${url.hostname.replace(/[^a-zA-Z0-9_]+/g, "_").replace(/^_+|_+$/g, "")}`;
+}
+function withProfile(args, apiUrl) {
+  const profile = bridgeProfile(apiUrl);
+  return profile ? [...args, "--profile", profile] : args;
+}
+function bridgeRunArgs(apiUrl) {
+  const url = parseApiUrl(apiUrl);
+  if (!url)
+    return [];
+  if (isLocalHost(url.hostname)) {
+    const args = ["--host", url.hostname];
+    if (url.port)
+      args.push("--port", url.port);
+    return withProfile(args, apiUrl);
+  }
+  if (url.hostname && url.hostname !== "api.todofor.ai")
+    return withProfile(["--host", url.hostname], apiUrl);
+  return [];
+}
+function bridgeLoginArgs(apiUrl) {
+  const url = parseApiUrl(apiUrl);
+  if (!url)
+    return ["login"];
+  if (url.hostname && url.hostname !== "api.todofor.ai")
+    return withProfile(["login", "--host", url.hostname], apiUrl);
+  return ["login"];
+}
+function bridgeWhoamiArgs(apiUrl) {
+  return withProfile(["whoami"], apiUrl);
+}
+function bridgeDeviceId(apiUrl) {
+  const r = spawnSync("todoforai-bridge", bridgeWhoamiArgs(apiUrl), { encoding: "utf-8" });
+  if (r.status !== 0)
+    return null;
+  const m = (r.stdout || "").match(/^Device:.*\(id:\s*([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\)/im);
+  return m ? m[1] : null;
+}
+function ensureBridgeCredentials(apiUrl) {
+  const whoami = spawnSync("todoforai-bridge", bridgeWhoamiArgs(apiUrl), { stdio: "ignore" });
+  if (whoami.status === 0)
+    return true;
+  console.error("\x1B[2mBridge credentials not found. Starting `todoforai-bridge login`...\x1B[0m");
+  const login = spawnSync("todoforai-bridge", bridgeLoginArgs(apiUrl), { stdio: "inherit" });
+  return login.status === 0;
+}
+function ensureBridgeRunning(apiUrl, _apiKey) {
+  if (!hasBridge()) {
+    console.error("\x1B[2mBridge not started: `todoforai-bridge` was not found on PATH. Install TODOforAI Bridge, or pass --no-bridge (or deprecated --no-edge) to silence this.\x1B[0m");
+    return;
+  }
+  if (!ensureBridgeCredentials(apiUrl)) {
+    console.error("\x1B[33mBridge not started: `todoforai-bridge login` did not complete successfully.\x1B[0m");
+    return;
+  }
+  const logDir = path3.join(os3.homedir(), ".todoforai");
+  fs2.mkdirSync(logDir, { recursive: true });
+  const logFile = path3.join(logDir, "bridge.log");
+  const out = fs2.openSync(logFile, "a");
+  const child = spawn("todoforai-bridge", bridgeRunArgs(apiUrl), {
+    detached: true,
+    stdio: ["ignore", out, out]
+  });
+  child.on("error", (err) => {
+    console.error(`\x1B[33mFailed to start bridge: ${err.message}\x1B[0m`);
+  });
+  let exited = false;
+  let exitCode = null;
+  child.on("exit", (code) => {
+    exited = true;
+    exitCode = code;
+  });
+  child.unref();
+  const pid = child.pid;
+  if (!pid)
+    return;
+  const shortLog = logFile.replace(os3.homedir(), "~");
+  setTimeout(() => {
+    if (!exited) {
+      console.error(`\x1B[2mStarted bridge (pid ${pid}), logs: ${shortLog}\x1B[0m`);
+      return;
+    }
+    if (exitCode === 0) {
+      console.error(`\x1B[2mBridge exited cleanly. Logs: ${shortLog}\x1B[0m`);
+    } else {
+      console.error(`\x1B[33mBridge exited early (exit ${exitCode}). Check logs: ${shortLog}. Another instance may already be running.\x1B[0m`);
+    }
+  }, 500);
+}
+
+// src/agent.ts
 function getAgentWorkspacePaths(agent) {
   const paths = [];
   for (const ec of Object.values(agent.edgesMcpConfigs || {})) {
     const tc = ec?.todoai_edge || ec?.todoai || {};
     paths.push(...tc.workspacePaths || []);
   }
+  for (const dc of Object.values(agent.devicesConfig || {})) {
+    paths.push(...dc?.workspacePaths || []);
+  }
   return paths;
 }
 async function autoCreateAgent(api, resolvedPath) {
@@ -44439,10 +44537,20 @@ async function autoCreateAgent(api, resolvedPath) {
     throw new Error(`Failed to create agent: ${JSON.stringify(resp)}`);
   const agentSettingsId = resp.agentSettingsId || agentId;
   await api.updateAgentSettings(agentId, agentSettingsId, { name: folderName });
+  const deviceId = bridgeDeviceId(api.apiUrl);
+  if (deviceId) {
+    await api.setAgentDeviceConfig(agentId, agentSettingsId, deviceId, { workspacePaths: [resolvedPath] });
+    const matches2 = await api.listAgentSettings({ workspacePath: resolvedPath });
+    if (matches2.length)
+      return matches2[0];
+    resp.name = folderName;
+    resp.devicesConfig = { [deviceId]: { workspacePaths: [resolvedPath] } };
+    return resp;
+  }
   const edges = await api.listEdges();
   const edgeId = Array.isArray(edges) && edges.length ? edges[0].id : null;
   if (!edgeId)
-    throw new Error("No edge available to configure workspace path");
+    throw new Error("No bridge device or edge available to configure workspace path");
   await api.setAgentEdgeMcpConfig(agentId, agentSettingsId, edgeId, "todoai_edge", { workspacePaths: [resolvedPath] });
   const matches = await api.listAgentSettings({ workspacePath: resolvedPath });
   if (matches.length)
@@ -46118,55 +46226,6 @@ async function listTodosCommand(api, defaultProjectId, argv) {
 `);
 }
 
-// src/ensure-edge.ts
-import { spawn, spawnSync } from "child_process";
-import fs2 from "fs";
-import path3 from "path";
-import os3 from "os";
-function hasBunx() {
-  const probe = spawnSync(process.platform === "win32" ? "where" : "which", ["bunx"], { stdio: "ignore" });
-  return probe.status === 0;
-}
-function ensureEdgeRunning(apiUrl, apiKey) {
-  if (!hasBunx()) {
-    console.error("\x1B[2mEdge daemon not started: `bunx` is missing. Install Bun from https://bun.sh to enable it, or pass --no-edge to silence this.\x1B[0m");
-    return;
-  }
-  const logDir = path3.join(os3.homedir(), ".todoforai");
-  fs2.mkdirSync(logDir, { recursive: true });
-  const logFile = path3.join(logDir, "edge.log");
-  const out = fs2.openSync(logFile, "a");
-  const child = spawn("bunx", ["@todoforai/edge", "--api-url", apiUrl, "--api-key", apiKey], {
-    detached: true,
-    stdio: ["ignore", out, out]
-  });
-  child.on("error", (err) => {
-    console.error(`\x1B[33mFailed to start edge daemon: ${err.message}\x1B[0m`);
-  });
-  let exited = false;
-  let exitCode = null;
-  child.on("exit", (code) => {
-    exited = true;
-    exitCode = code;
-  });
-  child.unref();
-  const pid = child.pid;
-  if (!pid)
-    return;
-  const shortLog = logFile.replace(os3.homedir(), "~");
-  setTimeout(() => {
-    if (!exited) {
-      console.error(`\x1B[2mStarted edge daemon (pid ${pid}), logs: ${shortLog}\x1B[0m`);
-      return;
-    }
-    if (exitCode === 0) {
-      console.error(`\x1B[2mEdge daemon exited cleanly (another instance likely already running). Logs: ${shortLog}\x1B[0m`);
-    } else {
-      console.error(`\x1B[31mEdge daemon died (exit ${exitCode}). Check logs: ${shortLog}\x1B[0m`);
-    }
-  }, 500);
-}
-
 // src/index.ts
 try {
   const pkgPath = path4.resolve(fileURLToPath(import.meta.url), "../../package.json");
@@ -46448,8 +46507,8 @@ Cancelled by user (Ctrl+C)
   if (process.stderr.isTTY)
     printLogo();
   if (args.template) {
-    if (!args["no-edge"] && !args["no-watch"])
-      ensureEdgeRunning(apiUrl, apiKey);
+    if (!args["no-bridge"] && !args["no-watch"])
+      ensureBridgeRunning(apiUrl, apiKey);
     const templateId = args.template;
     const inputValues = {};
     for (const kv of args.input || []) {
@@ -46536,8 +46595,8 @@ ${"\u2500".repeat(40)}
 `);
   }
   if (args.resume || args.continue) {
-    if (!args["no-edge"])
-      ensureEdgeRunning(apiUrl, apiKey);
+    if (!args["no-bridge"])
+      ensureBridgeRunning(apiUrl, apiKey);
     const todoId = args.resume || cfgScope.data.last_todo_id;
     if (!todoId) {
       process.stderr.write(`Error: No recent todo found
@@ -46622,8 +46681,8 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   }
   process.stderr.write(`${DIM}Tip: ${randomTip()}${RESET}
 `);
-  if (!args["no-edge"] && !args["no-watch"])
-    ensureEdgeRunning(apiUrl, apiKey);
+  if (!args["no-bridge"] && !args["no-watch"])
+    ensureBridgeRunning(apiUrl, apiKey);
   let content;
   if (positionals.length > 0) {
     content = positionals.join(" ");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@todoforai/cli",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "type": "module",
   "bin": {
     "todoforai-cli": "dist/todoai.js",