@todoforai/cli 0.1.26 → 0.1.28

package/bin/todoforai-cli.js

@@ -5,5 +5,5 @@ import { existsSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 
 const src = fileURLToPath(new URL("../src/index.ts", import.meta.url));
-const dist = fileURLToPath(new URL("../dist/todoai.js", import.meta.url));
+const dist = fileURLToPath(new URL("../dist/todoforai-cli.js", import.meta.url));
 await import(existsSync(src) ? src : dist);

package/dist/{todoai.js → todoforai-cli.js}

@@ -41771,9 +41771,9 @@ var require_route = __commonJS((exports, module) => {
   var conversions = require_conversions();
   function buildGraph() {
     const graph = {};
-    const models = Object.keys(conversions);
-    for (let len = models.length, i = 0;i < len; i++) {
-      graph[models[i]] = {
+    const models2 = Object.keys(conversions);
+    for (let len = models2.length, i = 0;i < len; i++) {
+      graph[models2[i]] = {
         distance: -1,
         parent: null
       };
@@ -41805,23 +41805,23 @@ var require_route = __commonJS((exports, module) => {
     };
   }
   function wrapConversion(toModel, graph) {
-    const path4 = [graph[toModel].parent, toModel];
+    const path3 = [graph[toModel].parent, toModel];
     let fn = conversions[graph[toModel].parent][toModel];
     let cur = graph[toModel].parent;
     while (graph[cur].parent) {
-      path4.unshift(graph[cur].parent);
+      path3.unshift(graph[cur].parent);
       fn = link(conversions[graph[cur].parent][cur], fn);
       cur = graph[cur].parent;
     }
-    fn.conversion = path4;
+    fn.conversion = path3;
     return fn;
   }
   module.exports = function(fromModel) {
     const graph = deriveBFS(fromModel);
     const conversion = {};
-    const models = Object.keys(graph);
-    for (let len = models.length, i = 0;i < len; i++) {
-      const toModel = models[i];
+    const models2 = Object.keys(graph);
+    for (let len = models2.length, i = 0;i < len; i++) {
+      const toModel = models2[i];
       const node = graph[toModel];
       if (node.parent === null) {
         continue;
@@ -41837,7 +41837,7 @@ var require_color_convert = __commonJS((exports, module) => {
   var conversions = require_conversions();
   var route = require_route();
   var convert = {};
-  var models = Object.keys(conversions);
+  var models2 = Object.keys(conversions);
   function wrapRaw(fn) {
     const wrappedFn = function(...args) {
       const arg0 = args[0];
@@ -41876,7 +41876,7 @@ var require_color_convert = __commonJS((exports, module) => {
     }
     return wrappedFn;
   }
-  models.forEach((fromModel) => {
+  models2.forEach((fromModel) => {
     convert[fromModel] = {};
     Object.defineProperty(convert[fromModel], "channels", { value: conversions[fromModel].channels });
     Object.defineProperty(convert[fromModel], "labels", { value: conversions[fromModel].labels });
@@ -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 os4 = __require("os");
+  var os3 = __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 = os4.release().split(".");
+      const osRelease = os3.release().split(".");
       if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
         return Number(osRelease[2]) >= 14931 ? 3 : 2;
       }
@@ -42665,7 +42665,7 @@ import { realpathSync, readFileSync as readFileSync3 } from "fs";
 import { resolve as resolve3 } from "path";
 import { fileURLToPath } from "url";
 import { homedir as homedir3 } from "os";
-import path4 from "path";
+import path3 from "path";
 
 // node_modules/@todoforai/update-notifier/src/index.ts
 import fs from "fs";
@@ -42731,7 +42731,7 @@ function randomTip() {
   return TIPS[Math.floor(Math.random() * TIPS.length)];
 }
 
-// ../edge/bun/src/api.ts
+// ../packages/shared-api/src/api.ts
 function restBasePath(apiKey) {
   return apiKey.startsWith("dst_") ? "/dst/v1" : "/api/v1";
 }
@@ -42812,8 +42812,8 @@ class ApiClient {
   deleteProject(projectId) {
     return this.request("DELETE", `/api/v1/projects/${projectId}`);
   }
-  createTodo(projectId, content, agentSettings) {
-    return this.request("POST", `/api/v1/projects/${projectId}/todos`, { content, agentSettings });
+  createTodo(projectId, content, agentSettings, groupTag, groupName) {
+    return this.request("POST", `/api/v1/projects/${projectId}/todos`, { content, agentSettings, groupTag, groupName });
   }
   listTodos(projectId, opts) {
     if (!projectId)
@@ -42851,12 +42851,16 @@ class ApiClient {
   getAgentSettings(id) {
     return this.request("GET", `/api/v1/agents/${id}`);
   }
-  addMessage(projectId, content, agentSettings, todoId, attachments, scheduledTimestamp) {
+  addMessage(projectId, content, agentSettings, todoId, attachments, scheduledTimestamp, groupTag, groupName) {
     const payload = { content, agentSettings, attachments: attachments || [] };
     if (todoId)
       payload.todoId = todoId;
     if (scheduledTimestamp)
       payload.scheduledTimestamp = scheduledTimestamp;
+    if (!todoId && groupTag)
+      payload.groupTag = groupTag;
+    if (!todoId && groupName)
+      payload.groupName = groupName;
     return this.request("POST", `/api/v1/projects/${projectId}/todos`, payload);
   }
   async showFile(todoId, file, filename, opts = {}) {
@@ -42898,6 +42902,9 @@ class ApiClient {
   updateAgentSettings(agentId, agentSettingsId, updates) {
     return this.request("PUT", `/api/v1/agents/${agentId}/settings`, { agentSettingsId, updates });
   }
+  deleteAgentSettings(agentSettingsId) {
+    return this.request("DELETE", `/api/v1/agents/${agentSettingsId}`);
+  }
   getGlobalAgentSettings() {
     return this.request("GET", "/api/v1/agents/global");
   }
@@ -42933,11 +42940,11 @@ class ApiClient {
       throw new Error(`Spec '${specId}' not found (${res.status})`);
     return res.json();
   }
-  async initDeviceLogin(clientName = "edge") {
+  async initDeviceLogin(clientName = "edge", opts = {}) {
     const res = await fetch(`${this.apiUrl}/api/v1/cli/login/init`, {
       method: "POST",
       headers: { "content-type": "application/json" },
-      body: JSON.stringify({ clientName })
+      body: JSON.stringify({ clientName, ...opts })
     });
     if (!res.ok)
       throw new Error(`Device login init failed: ${res.status}`);
@@ -42957,35 +42964,50 @@ class ApiClient {
     return res.json();
   }
 }
-
-// ../edge/bun/src/frontend-ws.ts
+// ../packages/shared-api/src/frontend-ws.ts
 import WebSocket from "ws";
 
-// ../edge/bun/src/config.ts
-import path2 from "path";
-import os2 from "os";
+// ../packages/shared-credentials/src/index.ts
+import { readFileSync, writeFileSync, mkdirSync, chmodSync } from "fs";
+import { join, dirname } from "path";
+import { homedir, platform } from "os";
 function normalizeApiUrl(url) {
   if (url.startsWith("localhost"))
     return `http://${url}`;
   if (!url.startsWith("http://") && !url.startsWith("https://"))
     return `https://${url}`;
-  return url;
+  return url.replace(/\/+$/, "");
 }
-var SUBCOMMANDS = new Set(["login", "logout", "update"]);
 function credentialsPath() {
-  const sys = os2.platform();
-  if (sys === "win32") {
-    return path2.join(os2.homedir(), "AppData", "Roaming", "todoforai", "credentials.json");
-  }
-  if (sys === "darwin") {
-    return path2.join(os2.homedir(), "Library", "Application Support", "todoforai", "credentials.json");
+  return platform() === "win32" ? join(homedir(), "AppData", "Roaming", "todoforai", "credentials.json") : platform() === "darwin" ? join(homedir(), "Library", "Application Support", "todoforai", "credentials.json") : join(process.env.XDG_CONFIG_HOME || join(homedir(), ".config"), "todoforai", "credentials.json");
+}
+function read() {
+  try {
+    return JSON.parse(readFileSync(credentialsPath(), "utf-8"));
+  } catch {
+    return {};
   }
-  const xdg = process.env.XDG_CONFIG_HOME || path2.join(os2.homedir(), ".config");
-  return path2.join(xdg, "todoforai", "credentials.json");
 }
-var CREDENTIALS_PATH = credentialsPath();
+function writeSecure(data) {
+  const p = credentialsPath();
+  mkdirSync(dirname(p), { recursive: true });
+  writeFileSync(p, JSON.stringify(data, null, 2), { encoding: "utf-8", mode: 384 });
+  try {
+    chmodSync(p, 384);
+  } catch {}
+}
+function readCredential(apiUrl) {
+  const c = read();
+  const v = c[apiUrl] || c.apiToken || c.apiKey;
+  return typeof v === "string" ? v : "";
+}
+function writeCredential(apiUrl, apiKey) {
+  const c = read();
+  c[apiUrl] = apiKey;
+  writeSecure(c);
+}
 
-// ../edge/bun/src/frontend-ws.ts
+// ../packages/shared-api/src/frontend-ws.ts
 var log = (level, ...args) => console.log(`[frontend-ws:${level}]`, ...args);
 
 class FrontendWebSocket {
@@ -43174,50 +43196,6 @@ class FrontendWebSocket {
     });
   }
 }
-
-// src/args.ts
-import { parseArgs } from "util";
-// package.json
-var package_default = {
-  name: "@todoforai/cli",
-  version: "0.1.24",
-  type: "module",
-  bin: {
-    "todoforai-cli": "bin/todoforai-cli.js",
-    todoai: "bin/todoforai-cli.js"
-  },
-  files: [
-    "bin",
-    "dist/todoai.js"
-  ],
-  scripts: {
-    build: "bun build src/index.ts --target=bun --outfile dist/todoai.js --external ws",
-    prepublishOnly: "bun run build",
-    start: "bun run src/index.ts",
-    dev: "bun run src/index.ts",
-    postinstall: "rm -rf node_modules/@todoforai/edge && ln -s ../../../edge/bun node_modules/@todoforai/edge"
-  },
-  dependencies: {
-    "@shared/credentials": "file:../packages/shared-credentials",
-    "@todoforai/update-notifier": "^0.1.0",
-    "cli-highlight": "^2.1.11",
-    "diff-match-patch": "^1.0.5",
-    ws: "^8.18.0"
-  },
-  peerDependencies: {
-    "@todoforai/edge": "file:../edge/bun"
-  },
-  peerDependenciesMeta: {
-    "@todoforai/edge": {
-      optional: true
-    }
-  },
-  devDependencies: {
-    "@types/ws": "^8.5.13",
-    "@todoforai/edge": "file:../edge/bun",
-    typescript: "^5.7.0"
-  }
-};
 // ../packages/shared-fbe/src/enums.ts
 var TodoStatus;
 ((TodoStatus2) => {
@@ -43240,6 +43218,59 @@ var TodoStatus;
   TodoStatus2["ARCHIVED"] = "ARCHIVED";
   TodoStatus2["DELETED"] = "DELETED";
 })(TodoStatus ||= {});
+// ../packages/shared-fbe/src/models.ts
+var DEFAULT_MODEL = "anthropic:anthropic/claude-sonnet-5";
+var MODEL_ALIASES = {
+  claude: DEFAULT_MODEL
+};
+var PROVIDER_BY_AUTHOR = {
+  anthropic: "anthropic",
+  openai: "openai",
+  deepseek: "deepseek",
+  poolside: "poolside",
+  "x-ai": "xai",
+  "z-ai": "z.ai",
+  google: "google-ai-studio",
+  moonshotai: "opencode_go"
+};
+function isQualifiedModel(model) {
+  const id = model.trim();
+  const colon = id.indexOf(":");
+  const slash = id.indexOf("/");
+  return colon > 0 && colon < id.length - 1 && (slash === -1 || colon < slash);
+}
+function qualifyModel(model) {
+  const id = model?.trim();
+  if (!id)
+    return { model: DEFAULT_MODEL };
+  if (isQualifiedModel(id))
+    return { model: id };
+  const suffix = id.match(/\([^)]+\)$/)?.[0] ?? "";
+  const bare = suffix ? id.slice(0, -suffix.length) : id;
+  const aliased = MODEL_ALIASES[bare.toLowerCase()];
+  if (aliased)
+    return { model: aliased + suffix };
+  const lower = bare.toLowerCase();
+  const provider = PROVIDER_BY_AUTHOR[lower.split("/")[0]];
+  if (provider && lower.includes("/"))
+    return { model: `${provider}:${lower}${suffix}` };
+  return { model: DEFAULT_MODEL, fallback: id };
+}
+function qualifiedModelIds(listing, filter) {
+  const q = filter?.toLowerCase();
+  const ids = [];
+  for (const m of listing?.data ?? []) {
+    const id = String(m.id);
+    if (m.provider) {
+      ids.push(`${m.provider.toLowerCase()}:${id}`);
+      continue;
+    }
+    const r = qualifyModel(id);
+    if (!r.fallback)
+      ids.push(r.model);
+  }
+  return q ? ids.filter((id) => id.toLowerCase().includes(q)) : ids;
+}
 // ../packages/shared-fbe/src/billing.ts
 var USAGE_WINDOWS = {
   SESSION_MS: 5 * 60 * 60 * 1000,
@@ -43290,7 +43321,7 @@ var mimetypes_default = {
     gif: { mime: "image/gif", type: "image" },
     webp: { mime: "image/webp", type: "image" },
     bmp: { mime: "image/bmp", type: "image" },
-    svg: { mime: "image/svg+xml", type: "text" },
+    svg: { mime: "image/svg+xml", type: "image" },
     heic: { mime: "image/heic", type: "image", conversionProfile: "to_jpeg_90" },
     heif: { mime: "image/heif", type: "image", conversionProfile: "to_jpeg_90" },
     mp3: { mime: "audio/mpeg", type: "audio" },
@@ -43498,7 +43529,7 @@ var SERVER_TO_FRONTENDS = {
     predicted_reply_updated: (todoId) => `${"predict:reply_updated" /* PREDICTED_REPLY_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}`,
+    file_changed: (edgeId, path2) => `${"block:file_changed" /* BLOCK_FILE_CHANGED */}:${edgeId}:${path2}`,
     notify: (todoId) => `${"NOTIFY" /* NOTIFY */}:${todoId}`
   },
   notify: {
@@ -43746,13 +43777,10 @@ function getBlockServerPrefix(block) {
   const prefixMatch = agentPattern.match(/^(.*?:)BASH(?:\(|$)/);
   return prefixMatch ? prefixMatch[1] : "";
 }
-var BASH_LIKE_BLOCK_TYPES = new Set(["bash", "machine_exec"]);
 function getBlockPatterns(block) {
   if (Array.isArray(block.generalized_pattern))
     return block.generalized_pattern;
-  const agentPattern = typeof block.generalized_pattern === "string" ? block.generalized_pattern : "";
-  const isBashLike = BASH_LIKE_BLOCK_TYPES.has(block.type.toLowerCase()) || /:BASH(\(|$)/.test(agentPattern);
-  if (isBashLike && block.cmd) {
+  if (block.type.toLowerCase() === "bash" && block.cmd) {
     const prefix = getBlockServerPrefix(block);
     return generalizeBashCmd(block.cmd).map((p) => prefix + p);
   }
@@ -43850,8 +43878,7 @@ function getBlockNewPatterns(block, permissions) {
   if (Array.isArray(block.generalized_pattern)) {
     return getNewPatterns(block.generalized_pattern, permissions);
   }
-  const agentPattern = typeof block.generalized_pattern === "string" ? block.generalized_pattern : "";
-  const isBash = (block.type.toLowerCase() === "bash" || agentPattern.includes(":BASH(")) && !!block.cmd;
+  const isBash = block.type.toLowerCase() === "bash" && !!block.cmd;
   if (!isBash) {
     return getBlockPatterns(block).filter((p) => !isPatternAllowed(permissions, p));
   }
@@ -43927,10 +43954,9 @@ When the user asks you to recommend how to grow (e.g. "recommend growth TODOs",
 Recommending actionable TODOs from your recommendations:
 To materialize growth recommendations, create recommendation cards in the project's Recommendations column. You NEVER create running todos \u2014 you only recommend templates by reference. Two tools, strict roles:
 
-1. GET A TEMPLATE (todoregistry-cli) \u2014 generate-first, reuse only on a close fit:
-   - Default: CREATE a template tailored to THIS business, right there (auth is inherited from your shell):
-     \`todoregistry-cli create --name "<name>" --description "<one line>" --body @<prompt-file>\` (or \`--body -\` for stdin). It prints the new template id on stdout.
-   - Before creating, you MAY \`todoregistry-cli search <query>\` / \`list -c <category>\` / \`get <id>\`; reuse an existing template ONLY when it already fits this business closely with no meaningful edits. If it needs tailoring, create a new one instead \u2014 do not recommend a generic playbook that ignores this company's specifics.
+1. GET A TEMPLATE (api_create_template) \u2014 generate-first, reuse only on a close fit:
+   - Default: CREATE a template tailored to THIS business with the \`api_create_template\` tool. It returns the new template id.
+   - Reuse an existing registry template ONLY when it already fits this business closely with no meaningful edits \u2014 pass its id straight to \`api_recommend_template\`. If it needs tailoring, create a new one instead \u2014 do not recommend a generic playbook that ignores this company's specifics.
 
    Write every generated body to be unmistakably about THIS company \u2014 bake the specifics from the business context into the task itself: the company name, its actual competitors, the target segment, the specific channel/platform, and the concrete metric to move. A reader should never mistake it for a generic template.
 
@@ -43939,9 +43965,10 @@ To materialize growth recommendations, create recommendation cards in the projec
    - Then the request, using these exact standalone heading lines (letters only, each on its own line, ending with a colon): \`Your task:\`, \`Steps:\`, \`Data needed:\`. Everything under these headings becomes the first user turn.
    - Headings must match exactly (e.g. \`Your task:\`, not \`Your task (SEO):\`) or the split breaks. Put the business-specific detail in the body text under each heading, never in the heading itself.
 
-2. RECOMMEND (todoforai-cli \u2014 references a template id onto the project; never creates a running todo):
-   \`todoforai-cli recommend --template <id> --project <projectId> --business-context <businessContextId> --note "<why>" --priority high|medium|low\`
-   Take <projectId> and <businessContextId> from your current session context and pass them explicitly. Put the one-line WHY for THIS business in --note (the card's tooltip). The card appears in the Recommendations column for the user to review before any credits are spent.
+2. RECOMMEND (api_recommend_template \u2014 references a template id onto the project; never creates a running todo):
+   Call \`api_recommend_template\` with the template id, a one-line \`note\` (the WHY for THIS business \u2014 it becomes the card's tooltip) and a \`priority\` of high, medium or low. Project and business context default to the current session, so pass them only when targeting a different one. The card appears in the Recommendations column for the user to review before any credits are spent.
+
+   Both tools run in-process and need no machine or shell \u2014 never shell out to \`todoregistry-cli\` / \`todoforai-cli\` for this.
 
 3. Recommend 3-6 cards (highest priority first). Then reply with a one-line summary per card and tell the user they're waiting in the Recommendations column for review.`,
   mcpConfigs: {},
@@ -43953,8 +43980,6 @@ To materialize growth recommendations, create recommendation cards in the projec
       "cloud:google_rag",
       "builtin:todoforai_api",
       "builtin:question",
-      "cloud:BASH(cmd: todoregistry-cli *)",
-      "cloud:BASH(cmd: todoforai-cli *)",
       "cloud:BASH(cmd: curl *)"
     ],
     ask: [],
@@ -44128,6 +44153,40 @@ var TOPICS = {
     audience: "frontend"
   }
 };
+// src/args.ts
+import { parseArgs } from "util";
+// package.json
+var package_default = {
+  name: "@todoforai/cli",
+  version: "0.1.28",
+  type: "module",
+  bin: {
+    "todoforai-cli": "bin/todoforai-cli.js",
+    "tfa-cli": "bin/todoforai-cli.js",
+    todoai: "bin/todoforai-cli.js"
+  },
+  files: [
+    "bin",
+    "dist/todoforai-cli.js"
+  ],
+  scripts: {
+    build: "bun build src/index.ts --target=bun --outfile dist/todoforai-cli.js --external ws",
+    prepublishOnly: "bun run build",
+    start: "bun run src/index.ts",
+    dev: "bun run src/index.ts"
+  },
+  dependencies: {
+    "@todoforai/update-notifier": "^0.1.0",
+    "cli-highlight": "^2.1.11",
+    "diff-match-patch": "^1.0.5",
+    ws: "^8.18.0"
+  },
+  devDependencies: {
+    "@types/ws": "^8.5.13",
+    typescript: "^5.7.0"
+  }
+};
+
 // src/args.ts
 var DEFAULT_API_URL = "https://api.todofor.ai";
 var VERSION = package_default.version;
@@ -44136,7 +44195,7 @@ function getEnv(name) {
 }
 function printUsage() {
   process.stderr.write(`
-todoforai-cli \u2014 TODOforAI CLI (Bun)
+todoforai-cli \u2014 TODOforAI CLI (Bun). Aliases: tfa-cli, todoai.
 
 Usage:
   todoforai-cli login                          # Browser-based device auth
@@ -44167,6 +44226,8 @@ Options:
   --path <dir>                    Workspace path (default: cwd)
   --project <id>                  Project ID
   --agent, -a <name>              Agent name (partial match)
+  --group <slug>                 Group new todo; omitted inherits TODOFORAI_GROUP_ID
+  --group-name <name>            Display name for --group (last write wins)
   --model <model>                 Override the agent's model for this todo
                                   (e.g. anthropic:anthropic/claude-opus-5, openai:openai/gpt-5.6-sol)
   --list-agents                   List available agents (name, id, workspace paths) and exit
@@ -44225,6 +44286,8 @@ function parseCliArgs() {
       project: { type: "string" },
       agent: { type: "string", short: "a" },
       model: { type: "string" },
+      group: { type: "string" },
+      "group-name": { type: "string" },
       "list-agents": { type: "boolean", default: false },
       "list-models": { type: "boolean", default: false },
       "api-url": { type: "string" },
@@ -44605,8 +44668,8 @@ 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";
+import path2 from "path";
+import os2 from "os";
 function hasBridge() {
   const probe = spawnSync("todoforai-bridge", ["--version"], { stdio: "ignore" });
   return probe.status === 0;
@@ -44675,31 +44738,44 @@ function ensureBridgeCredentials(apiUrl) {
   const login = spawnSync("todoforai-bridge", bridgeLoginArgs(apiUrl), { stdio: "inherit" });
   return login.status === 0;
 }
-function bridgeAlreadyRunning() {
-  if (process.platform === "win32")
-    return Promise.resolve(false);
-  return new Promise((resolve) => {
-    const r = spawn("pgrep", ["-f", "todoforai-bridge"]);
-    let out = "";
-    r.stdout.on("data", (d) => out += d);
-    r.on("error", () => resolve(false));
-    r.on("close", (code) => resolve(code === 0 && out.trim().length > 0));
-  });
+async function bridgeState(apiUrl, apiKey, deviceId) {
+  try {
+    const devices = await new ApiClient(apiUrl, apiKey).listDevices();
+    return Array.isArray(devices) && devices.some((device) => device.id === deviceId && device.status === "ONLINE") ? "online" : "offline";
+  } catch {
+    return "unknown";
+  }
 }
-async function ensureBridgeRunning(apiUrl, _apiKey) {
-  if (await bridgeAlreadyRunning())
-    return;
+async function waitForBridgeOnline(apiUrl, apiKey, deviceId, timeoutMs = 5000) {
+  const deadline = Date.now() + timeoutMs;
+  do {
+    const state = await bridgeState(apiUrl, apiKey, deviceId);
+    if (state !== "offline")
+      return state === "online";
+    await new Promise((resolve) => setTimeout(resolve, 150));
+  } while (Date.now() < deadline);
+  return false;
+}
+async 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;
+    return false;
   }
   if (!ensureBridgeCredentials(apiUrl)) {
     console.error("\x1B[33mBridge not started: `todoforai-bridge login` did not complete successfully.\x1B[0m");
-    return;
+    return false;
   }
-  const logDir = path3.join(os3.homedir(), ".todoforai");
+  const deviceId = bridgeDeviceId(apiUrl);
+  if (!deviceId) {
+    console.error("\x1B[33mBridge not started: could not determine this device's id.\x1B[0m");
+    return false;
+  }
+  const initialState = await bridgeState(apiUrl, apiKey, deviceId);
+  if (initialState === "online" || initialState === "unknown")
+    return initialState === "online";
+  const logDir = path2.join(os2.homedir(), ".todoforai");
   fs2.mkdirSync(logDir, { recursive: true });
-  const logFile = path3.join(logDir, "bridge.log");
+  const logFile = path2.join(logDir, "bridge.log");
   const out = fs2.openSync(logFile, "a");
   const child = spawn("todoforai-bridge", bridgeRunArgs(apiUrl), {
     detached: true,
@@ -44716,13 +44792,13 @@ async function ensureBridgeRunning(apiUrl, _apiKey) {
   });
   child.unref();
   if (!child.pid)
-    return;
-  const shortLog = logFile.replace(os3.homedir(), "~");
-  setTimeout(() => {
-    if (exited && exitCode !== 0) {
-      console.error(`\x1B[2mBridge not running (exit ${exitCode}), see ${shortLog}\x1B[0m`);
-    }
-  }, 500);
+    return false;
+  if (await waitForBridgeOnline(apiUrl, apiKey, deviceId))
+    return true;
+  const shortLog = logFile.replace(os2.homedir(), "~");
+  const reason = exited ? `exit ${exitCode}` : "startup timed out";
+  console.error(`\x1B[33mBridge not ready (${reason}), see ${shortLog}\x1B[0m`);
+  return false;
 }
 
 // src/agent.ts
@@ -44756,9 +44832,13 @@ async function autoCreateAgent(api, resolvedPath) {
     return resp;
   }
   const edges = await api.listEdges();
-  const edgeId = Array.isArray(edges) && edges.length ? edges[0].id : null;
-  if (!edgeId)
+  if (!Array.isArray(edges) || edges.length === 0) {
     throw new Error("No bridge device or edge available to configure workspace path");
+  }
+  if (edges.length > 1) {
+    throw new Error("No local bridge device found and multiple legacy edges are available; choose an existing agent explicitly");
+  }
+  const edgeId = edges[0].id;
   await api.setAgentEdgeMcpConfig(agentId, agentSettingsId, edgeId, "todoai_edge", { workspacePaths: [resolvedPath] });
   const matches = await api.listAgentSettings({ workspacePath: resolvedPath });
   if (matches.length)
@@ -44769,20 +44849,20 @@ async function autoCreateAgent(api, resolvedPath) {
 }
 
 // src/config.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname, join, resolve as resolve2 } from "path";
-import { homedir, platform } from "os";
+import { existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname2, join as join2, resolve as resolve2 } from "path";
+import { homedir as homedir2, platform as platform2 } from "os";
 function getConfigDir() {
-  const sys = platform();
+  const sys = platform2();
   if (sys === "win32") {
-    const base = process.env.APPDATA || join(homedir(), "AppData", "Roaming");
-    return join(base, "todoai-cli");
+    const base = process.env.APPDATA || join2(homedir2(), "AppData", "Roaming");
+    return join2(base, "todoai-cli");
   }
   if (sys === "darwin") {
-    return join(homedir(), "Library", "Application Support", "todoai-cli");
+    return join2(homedir2(), "Library", "Application Support", "todoai-cli");
   }
-  const xdg = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
-  return join(xdg, "todoai-cli");
+  const xdg = process.env.XDG_CONFIG_HOME || join2(homedir2(), ".config");
+  return join2(xdg, "todoai-cli");
 }
 function defaultScope() {
   return {
@@ -44834,10 +44914,10 @@ class ConfigStore {
   data;
   constructor(pathArg) {
     if (pathArg) {
-      const p = resolve2(pathArg.replace(/^~/, homedir()));
-      this.path = p.endsWith(".json") ? p : join(p, "config.json");
+      const p = resolve2(pathArg.replace(/^~/, homedir2()));
+      this.path = p.endsWith(".json") ? p : join2(p, "config.json");
     } else {
-      this.path = join(getConfigDir(), "config.json");
+      this.path = join2(getConfigDir(), "config.json");
     }
     this.data = this.load();
   }
@@ -44845,7 +44925,7 @@ class ConfigStore {
     if (!existsSync(this.path))
       return defaultConfig();
     try {
-      const raw = JSON.parse(readFileSync(this.path, "utf-8"));
+      const raw = JSON.parse(readFileSync2(this.path, "utf-8"));
       delete raw.default_api_key;
       const cfg = migrate(raw);
       const needsMigration = raw.per_api_url == null;
@@ -44860,8 +44940,8 @@ class ConfigStore {
   }
   save() {
     try {
-      mkdirSync(dirname(this.path), { recursive: true });
-      writeFileSync(this.path, JSON.stringify(this.data, null, 2), "utf-8");
+      mkdirSync2(dirname2(this.path), { recursive: true });
+      writeFileSync2(this.path, JSON.stringify(this.data, null, 2), "utf-8");
     } catch {}
   }
   scope(apiUrl) {
@@ -44921,39 +45001,6 @@ class ScopedConfig {
     this.store.save();
   }
 }
-
-// ../packages/shared-credentials/src/index.ts
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2, chmodSync } from "fs";
-import { join as join2, dirname as dirname2 } from "path";
-import { homedir as homedir2, platform as platform2 } from "os";
-function credentialsPath2() {
-  return platform2() === "win32" ? join2(homedir2(), "AppData", "Roaming", "todoforai", "credentials.json") : platform2() === "darwin" ? join2(homedir2(), "Library", "Application Support", "todoforai", "credentials.json") : join2(process.env.XDG_CONFIG_HOME || join2(homedir2(), ".config"), "todoforai", "credentials.json");
-}
-function read() {
-  try {
-    return JSON.parse(readFileSync2(credentialsPath2(), "utf-8"));
-  } catch {
-    return {};
-  }
-}
-function writeSecure(data) {
-  const p = credentialsPath2();
-  mkdirSync2(dirname2(p), { recursive: true });
-  writeFileSync2(p, JSON.stringify(data, null, 2), { encoding: "utf-8", mode: 384 });
-  try {
-    chmodSync(p, 384);
-  } catch {}
-}
-function readCredential(apiUrl) {
-  const c2 = read();
-  const v = c2[apiUrl] || c2.apiToken || c2.apiKey;
-  return typeof v === "string" ? v : "";
-}
-function writeCredential(apiUrl, apiKey) {
-  const c2 = read();
-  c2[apiUrl] = apiKey;
-  writeSecure(c2);
-}
 // src/logo.ts
 var LETTERS = {
   t: [" x  ", "xxxx", " x  ", " xll", " xll", " xxx"],
@@ -45027,6 +45074,12 @@ function printLogo() {
 `);
 }
 
+// src/urls.ts
+function getFrontendUrl(apiUrl, todoId) {
+  const local = apiUrl.includes("localhost:4000") || apiUrl.includes("127.0.0.1:4000");
+  return `${local ? "http://localhost:3000" : "https://todofor.ai"}/t/${todoId}`;
+}
+
 // src/inspect.ts
 var xmlAttr = (v) => JSON.stringify(String(v));
 var DROP_IF_EMPTY = new Set(["runMeta", "meta", "attachments", "blocks"]);
@@ -45858,17 +45911,6 @@ async function watchTodo(ws, todoId, projectId, opts = {}) {
     "block:start_catfile"
   ]);
   const signalActivity = () => opts.activityEvent?.set();
-  let edgeId;
-  let rootPath = "";
-  if (opts.agentSettings) {
-    const emc = opts.agentSettings.edgesMcpConfigs || {};
-    edgeId = Object.keys(emc)[0];
-    if (edgeId) {
-      const ec = emc[edgeId];
-      const tc = ec?.todoai_edge || ec?.todoai || {};
-      rootPath = (tc.workspacePaths || [])[0] || "";
-    }
-  }
   const blocksStore = new Map;
   const diffStore = diffStoreByWs.get(ws) ?? new Map;
   diffStoreByWs.set(ws, diffStore);
@@ -46055,6 +46097,12 @@ ${YELLOW}*${RESET} ${YELLOW}${blockType}${RESET}${extra}
 `);
         signalActivity();
       }
+    } else if (msgType === "NOTIFY") {
+      const sevColor = payload.severity === "error" ? RED : YELLOW;
+      process.stderr.write(`
+${sevColor}\u26A0 ${payload.title || "Notice"}${RESET}${payload.message ? ` ${DIM}${payload.message}${RESET}` : ""}
+`);
+      signalActivity();
     } else if (msgType === "todo:status") {
       const status = payload.status || "";
       process.stderr.write(`
@@ -46085,6 +46133,9 @@ ${DIM}[todo:status] ${status}${RESET}
       const status = result?.payload?.status || result?.type || "unknown";
       process.stderr.write(`Warning: Stopped: ${status}
 `);
+      process.exitCode = 1;
+    } else {
+      process.exitCode = 0;
     }
     return true;
   } catch (e) {
@@ -46128,20 +46179,6 @@ async function listAgentsCommand(api, opts) {
   }
 }
 
-// src/list-models.ts
-async function listModelsCommand(api, opts) {
-  const res = await api.listModels();
-  const q = opts.filter?.toLowerCase();
-  const ids = (res?.data || []).map((m) => String(m.id).includes("/") ? `${String(m.id).split("/")[0]}:${m.id}` : String(m.id)).filter((id) => !q || id.toLowerCase().includes(q));
-  if (opts.json) {
-    console.log(JSON.stringify(ids, null, 2));
-    return;
-  }
-  for (const id of ids)
-    process.stderr.write(`${BRAND}${id}${RESET}
-`);
-}
-
 // src/agent-command.ts
 function printAgentHelp() {
   process.stderr.write(`
@@ -46151,6 +46188,7 @@ Usage:
   todoforai-cli agent list                            List agents (name, model, id, paths)
   todoforai-cli agent get <agent>                     Show a single agent's settings
   todoforai-cli agent update <agent> <field=value>\u2026   Update one or more settings
+  todoforai-cli agent delete <agent>                  Delete an agent configuration (asks to confirm)
 
 <agent> is a name or id (unique partial name also works).
 Fields map directly to agent settings; values are parsed as JSON when possible
@@ -46248,6 +46286,32 @@ async function agentCommand(api, positionals, args, formatPath) {
     }
     const summary = Object.keys(updates).map((k) => `${k}=${JSON.stringify(updated[k])}`).join(" ");
     process.stderr.write(`${GREEN}\u2705 ${getDisplayName(agent)} updated: ${summary}${RESET}
+`);
+    return;
+  }
+  if (sub === "delete" || sub === "rm") {
+    const query = positionals[2];
+    if (!query) {
+      process.stderr.write(`${RED}Usage: todoforai-cli agent delete <name|id>${RESET}
+`);
+      process.exit(2);
+    }
+    const agents = await api.listAgentSettings();
+    const agent = resolveAgent(agents, query);
+    const name = getDisplayName(agent);
+    if (!process.stdin.isTTY) {
+      process.stderr.write(`${RED}Refusing to delete '${name}' non-interactively (delete needs an interactive confirm).${RESET}
+`);
+      process.exit(2);
+    }
+    const ok = await singleChar(`${RED}Delete agent '${name}'? [y/N] ${RESET}`);
+    if (ok !== "y") {
+      process.stderr.write(`Aborted
+`);
+      return;
+    }
+    await api.deleteAgentSettings(getItemId(agent));
+    process.stderr.write(`${GREEN}\u2705 Deleted ${name}${RESET}
 `);
     return;
   }
@@ -46453,18 +46517,12 @@ async function listTodosCommand(api, defaultProjectId, argv) {
 
 // src/index.ts
 try {
-  const pkgPath = path4.resolve(fileURLToPath(import.meta.url), "../../package.json");
+  const pkgPath = path3.resolve(fileURLToPath(import.meta.url), "../../package.json");
   checkForUpdates(JSON.parse(readFileSync3(pkgPath, "utf-8")));
 } catch {}
-function formatPathWithTilde(path5) {
+function formatPathWithTilde(path4) {
   const home = homedir3();
-  return path5.startsWith(home) ? path5.replace(home, "~") : path5;
-}
-function getFrontendUrl(apiUrl, projectId, todoId) {
-  if (apiUrl.includes("localhost:4000") || apiUrl.includes("127.0.0.1:4000")) {
-    return `http://localhost:3000/${projectId}/${todoId}`;
-  }
-  return `https://todofor.ai/${projectId}/${todoId}`;
+  return path4.startsWith(home) ? path4.replace(home, "~") : path4;
 }
 async function interactiveLoop(ws, api, todoId, projectId, agent, json, autoApprove, cfg) {
   while (true) {
@@ -46541,6 +46599,8 @@ Cancelled by user (Ctrl+C)
     process.exit(130);
   });
   const { values: args, positionals } = parseCliArgs();
+  const groupTag = args.group === undefined ? getEnv("GROUP_ID") : String(args.group);
+  const groupName = args["group-name"] === undefined ? undefined : String(args["group-name"]);
   if (positionals[0] === "start") {
     if (!positionals[1] && !args.template) {
       process.stderr.write(`${RED}Usage: todoforai-cli start <todo-id>${RESET}
@@ -46703,7 +46763,8 @@ Cancelled by user (Ctrl+C)
       process.exit(2);
     }
     const todo2 = await api.getTodo(todoId);
-    const msg = await api.addMessage(todo2.projectId, content2, todo2.agentSettings || { id: todo2.agentSettingsId }, todoId);
+    const agent2 = todo2.agentSettings || await api.getAgentSettings(todo2.agentSettingsId);
+    const msg = await api.addMessage(todo2.projectId, content2, agent2, todoId);
     if (args.json)
       console.log(JSON.stringify(msg, null, 2));
     else
@@ -46736,7 +46797,7 @@ Cancelled by user (Ctrl+C)
         process.exit(1);
       }
       blob = file;
-      name = path4.basename(filePath);
+      name = path3.basename(filePath);
     }
     const res = await api.showFile(todoId, blob, name, { title: args.title, alias: args.alias, mime: args.mime });
     if (args.json)
@@ -46879,7 +46940,13 @@ Cancelled by user (Ctrl+C)
     return;
   }
   if (args["list-models"]) {
-    await listModelsCommand(api, { json: !!args.json, filter: positionals[0] });
+    const ids = qualifiedModelIds(await api.listModels(), positionals[0]);
+    if (args.json)
+      console.log(JSON.stringify(ids, null, 2));
+    else
+      for (const id of ids)
+        process.stderr.write(`${BRAND}${id}${RESET}
+`);
     return;
   }
   if (positionals[0] === "agent") {
@@ -46926,14 +46993,14 @@ Cancelled by user (Ctrl+C)
     }
     const mode = args.debug ? "debug" : args.detailed ? "detailed" : "default";
     const format = args["format-anthropic"] ? "anthropic" : "compact";
-    printFullChat(todo2, getFrontendUrl(apiUrl, todo2.projectId, todoId), slice, mode, format);
+    printFullChat(todo2, getFrontendUrl(apiUrl, todoId), slice, mode, format);
     return;
   }
   if (process.stderr.isTTY)
     printLogo();
   if (args.template) {
     if (!args["no-bridge"] && !args["no-watch"])
-      ensureBridgeRunning(apiUrl, apiKey);
+      await ensureBridgeRunning(apiUrl, apiKey);
     const templateId = args.template;
     const spec = await api.getRegistrySpec(templateId);
     process.stderr.write(`${DIM}Template:${RESET} ${BRAND}${spec.name}${RESET}
@@ -46952,10 +47019,13 @@ Cancelled by user (Ctrl+C)
 `);
       process.exit(1);
     }
-    const todo2 = await api.startFromSpec(projectId2, templateId);
+    const todo2 = await api.startFromSpec(projectId2, templateId, {
+      ...groupTag ? { groupTag } : {},
+      ...groupName ? { groupName } : {}
+    });
     const todoId = todo2.id;
     cfgScope.setLastTodoId(todoId);
-    const frontendUrl2 = getFrontendUrl(apiUrl, projectId2, todoId);
+    const frontendUrl2 = getFrontendUrl(apiUrl, todoId);
     if (args.json) {
       console.log(JSON.stringify({ ...todo2, frontend_url: frontendUrl2 }, null, 2));
     } else if (args["no-watch"]) {
@@ -47000,7 +47070,7 @@ ${"\u2500".repeat(40)}
   }
   if (args.resume || args.continue) {
     if (!args["no-bridge"])
-      ensureBridgeRunning(apiUrl, apiKey);
+      await ensureBridgeRunning(apiUrl, apiKey);
     const todoId = args.resume || cfgScope.data.last_todo_id;
     if (!todoId) {
       process.stderr.write(`Error: No recent todo found
@@ -47017,7 +47087,7 @@ ${"\u2500".repeat(40)}
     }
     process.stderr.write(`
 ${"\u2500".repeat(40)}
-Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
+Resumed: ${CYAN}${getFrontendUrl(apiUrl, todoId)}${RESET}
 `);
     const ws2 = new FrontendWebSocket(apiUrl, apiKey);
     await ws2.connect();
@@ -47041,8 +47111,7 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   }
   const ws = args["no-watch"] ? null : new FrontendWebSocket(apiUrl, apiKey);
   const wsReady = ws ? ws.connect() : null;
-  if (!args["no-bridge"] && !args["no-watch"])
-    ensureBridgeRunning(apiUrl, apiKey);
+  const bridgeReady = !args["no-bridge"] && !args["no-watch"] ? ensureBridgeRunning(apiUrl, apiKey) : null;
   let preMatchedAgent = null;
   let agents = null;
   if (args.agent) {
@@ -47137,6 +47206,8 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   }
   if (wsReady)
     await wsReady;
+  if (bridgeReady)
+    await bridgeReady;
   if (args.model)
     agent = { ...agent, model: args.model };
   if (args["raw-sysmsg"]) {
@@ -47150,7 +47221,7 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   cfg.addToHistory(content);
   let todo;
   try {
-    todo = await api.addMessage(projectId, content, agent);
+    todo = await api.addMessage(projectId, content, agent, undefined, undefined, undefined, groupTag || undefined, groupName);
   } catch (e) {
     if (!args.project && cfgScope.data.default_project_id === projectId && /failed: 403/.test(e.message || "")) {
       cfgScope.clearDefaultProject();
@@ -47162,7 +47233,7 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   }
   const actualTodoId = todo.id || crypto.randomUUID();
   cfgScope.setLastTodoId(actualTodoId);
-  const frontendUrl = getFrontendUrl(apiUrl, projectId, actualTodoId);
+  const frontendUrl = getFrontendUrl(apiUrl, actualTodoId);
   if (args.json) {
     console.log(JSON.stringify({ ...todo, frontend_url: frontendUrl }, null, 2));
   } else if (!ws) {
@@ -47187,7 +47258,7 @@ ${"\u2500".repeat(40)}
     await ws.close();
   }
 }
-main().then(() => process.exit(0)).catch((e) => {
+main().then(() => process.exit(process.exitCode ?? 0)).catch((e) => {
   process.stderr.write(`Error: ${e.message}
 `);
   process.exit(1);

package/package.json

@@ -1,36 +1,28 @@
 {
   "name": "@todoforai/cli",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "type": "module",
   "bin": {
     "todoforai-cli": "bin/todoforai-cli.js",
+    "tfa-cli": "bin/todoforai-cli.js",
     "todoai": "bin/todoforai-cli.js"
   },
   "files": [
     "bin",
-    "dist/todoai.js"
+    "dist/todoforai-cli.js"
   ],
   "scripts": {
-    "build": "bun build src/index.ts --target=bun --outfile dist/todoai.js --external ws",
+    "build": "bun build src/index.ts --target=bun --outfile dist/todoforai-cli.js --external ws",
     "prepublishOnly": "bun run build",
     "start": "bun run src/index.ts",
     "dev": "bun run src/index.ts"
   },
   "dependencies": {
-    "@shared/credentials": "file:../packages/shared-credentials",
     "@todoforai/update-notifier": "^0.1.0",
     "cli-highlight": "^2.1.11",
     "diff-match-patch": "^1.0.5",
     "ws": "^8.18.0"
   },
-  "peerDependencies": {
-    "@todoforai/edge": ">=0.12.0"
-  },
-  "peerDependenciesMeta": {
-    "@todoforai/edge": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@types/ws": "^8.5.13",
     "typescript": "^5.7.0"