@todoforai/cli 0.1.20 → 0.1.21

package/dist/todoai.js

@@ -42825,6 +42825,9 @@ class ApiClient {
   deleteTodo(todoId) {
     return this.request("DELETE", `/api/v1/todos/${todoId}`);
   }
+  listModels() {
+    return this.request("GET", "/api/v1/models");
+  }
   listAgentSettings(filters) {
     const params = new URLSearchParams;
     if (filters?.workspacePath)
@@ -42923,7 +42926,7 @@ function normalizeApiUrl(url) {
     return `https://${url}`;
   return url;
 }
-var SUBCOMMANDS = new Set(["login", "logout"]);
+var SUBCOMMANDS = new Set(["login", "logout", "update"]);
 function credentialsPath() {
   const sys = os2.platform();
   if (sys === "win32") {
@@ -44095,18 +44098,27 @@ Usage:
   todoforai-cli --inspect <todo-id>[@<slice>] # Read chat log. <slice> = -3:, :1, 5:10, 7  (Python-style)
   todoforai-cli --template <id> [--input k=v] # Start from a registry template
   todoforai-cli --list-agents                 # List available agents and exit
+  todoforai-cli --list-models [filter]        # List models usable with --model and exit
   todoforai-cli agent update <agent> model=<model>    # Update agent settings (see 'agent --help')
   todoforai-cli list [-n 30] [--cursor N] [--all] [--status S]  # List todos (paginated); see 'list --help'
   todoforai-cli status <todo-id> <STATUS>     # Update a todo's status (run 'status --help' for the full list)
   todoforai-cli delete <todo-id>              # Permanently delete a todo
   todoforai-cli addmessage <todo-id> "text"  # Add a message to an existing todo
   todoforai-cli recommend --template <id>    # Add a template as a NEXT-column card (see 'todoregistry-cli create')
+  todoforai-cli claim mint --seed <projectId> [--emails a@x,b@y] [--ttl <sec>]  # Mint /claim/<token> ownership links for a project you own
+  todoforai-cli steering get                 # Show recommendation steering (direction + boosted/muted categories)
+  todoforai-cli steering direction "<text>"  # Set the direction the generator should follow
+  todoforai-cli steering boost|mute <cat>    # Favour / avoid a category
+  todoforai-cli next                         # Generate steered NEXT-column recommendations
 
 Options:
   --path <dir>                    Workspace path (default: cwd)
   --project <id>                  Project ID
   --agent, -a <name>              Agent name (partial match)
+  --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
+  --list-models                   List models usable with --model (optional substring filter) and exit
   --api-url <url>                 API URL
   --api-key <key>                 API key
   --user-id <id>                  Admin HTTP impersonation; requires --no-watch
@@ -44163,6 +44175,7 @@ function parseCliArgs() {
       agent: { type: "string", short: "a" },
       model: { type: "string" },
       "list-agents": { type: "boolean", default: false },
+      "list-models": { type: "boolean", default: false },
       "api-url": { type: "string" },
       "api-key": { type: "string" },
       "user-id": { type: "string" },
@@ -44173,6 +44186,9 @@ function parseCliArgs() {
       priority: { type: "string" },
       title: { type: "string" },
       "business-context": { type: "string" },
+      seed: { type: "string" },
+      emails: { type: "string" },
+      ttl: { type: "string" },
       resume: { type: "string", short: "r" },
       continue: { type: "boolean", short: "c", default: false },
       "non-interactive": { type: "boolean", short: "n", default: false },
@@ -46065,6 +46081,20 @@ 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(`
@@ -46374,6 +46404,92 @@ async function listTodosCommand(api, defaultProjectId, argv) {
 `);
 }
 
+// src/steering-command.ts
+var RED2 = "\x1B[31m";
+var GREEN2 = "\x1B[32m";
+var DIM2 = "\x1B[2m";
+var RESET2 = "\x1B[0m";
+async function rest(ctx, method, path4, body) {
+  const res = await fetch(`${ctx.apiUrl}/api/v1${path4}`, {
+    method,
+    headers: { "content-type": "application/json", "x-api-key": ctx.apiKey },
+    ...body ? { body: JSON.stringify(body) } : {},
+    signal: AbortSignal.timeout(30000)
+  });
+  const text = await res.text();
+  if (!res.ok)
+    throw new Error(`${method} ${path4} failed: ${res.status} ${text}`);
+  return text ? JSON.parse(text) : null;
+}
+function printSteering(s) {
+  process.stderr.write(`${GREEN2}Direction:${RESET2} ${s.direction || DIM2 + "(none)" + RESET2}
+`);
+  process.stderr.write(`${GREEN2}Boosted:${RESET2}   ${s.boostedCategoryIds?.join(", ") || DIM2 + "(none)" + RESET2}
+`);
+  process.stderr.write(`${GREEN2}Muted:${RESET2}     ${s.mutedCategoryIds?.join(", ") || DIM2 + "(none)" + RESET2}
+`);
+}
+var USAGE = `${RED2}Usage:
+  todoforai-cli steering get [--project <id>]
+  todoforai-cli steering direction "<text>" [--project <id>]   (empty text clears it)
+  todoforai-cli steering boost <categoryId> [--project <id>]
+  todoforai-cli steering mute  <categoryId> [--project <id>]
+  todoforai-cli steering clear [--project <id>]                (clears all steering)${RESET2}`;
+async function steeringCommand(ctx, argv) {
+  const sub = argv[0];
+  const path4 = `/projects/${ctx.projectId}/recommendation-steering`;
+  if (!sub || sub === "get") {
+    const s = await rest(ctx, "GET", path4);
+    if (ctx.json)
+      console.log(JSON.stringify(s, null, 2));
+    else
+      printSteering(s);
+    return;
+  }
+  if (sub === "direction") {
+    const text = argv.slice(1).join(" ").trim();
+    const s = await rest(ctx, "PATCH", path4, { projectId: ctx.projectId, direction: text || null });
+    if (ctx.json)
+      console.log(JSON.stringify(s, null, 2));
+    else
+      process.stderr.write(`${GREEN2}\u2705 ${text ? `Direction set: ${text}` : "Direction cleared"}${RESET2}
+`);
+    return;
+  }
+  if (sub === "boost" || sub === "mute") {
+    const categoryId = argv[1];
+    if (!categoryId) {
+      process.stderr.write(USAGE + `
+`);
+      process.exit(2);
+    }
+    const current = await rest(ctx, "GET", path4);
+    const key = sub === "boost" ? "boostedCategoryIds" : "mutedCategoryIds";
+    const other = sub === "boost" ? "mutedCategoryIds" : "boostedCategoryIds";
+    const next = Array.from(new Set([...current[key] ?? [], categoryId]));
+    const nextOther = (current[other] ?? []).filter((c2) => c2 !== categoryId);
+    const s = await rest(ctx, "PATCH", path4, { projectId: ctx.projectId, [key]: next, [other]: nextOther });
+    if (ctx.json)
+      console.log(JSON.stringify(s, null, 2));
+    else
+      process.stderr.write(`${GREEN2}\u2705 ${sub === "boost" ? "Boosted" : "Muted"} ${categoryId}${RESET2}
+`);
+    return;
+  }
+  if (sub === "clear") {
+    const s = await rest(ctx, "PATCH", path4, { projectId: ctx.projectId, direction: null, boostedCategoryIds: [], mutedCategoryIds: [] });
+    if (ctx.json)
+      console.log(JSON.stringify(s, null, 2));
+    else
+      process.stderr.write(`${GREEN2}\u2705 Steering cleared${RESET2}
+`);
+    return;
+  }
+  process.stderr.write(USAGE + `
+`);
+  process.exit(2);
+}
+
 // src/index.ts
 try {
   const pkgPath = path4.resolve(fileURLToPath(import.meta.url), "../../package.json");
@@ -46565,7 +46681,8 @@ Cancelled by user (Ctrl+C)
     await deviceLogin();
     return;
   }
-  let apiKey = args["api-key"] || readCredential(apiUrl) || getEnv("API_TOKEN") || "";
+  const notDst = (t) => t.startsWith("dst_") ? "" : t;
+  let apiKey = args["api-key"] || notDst(readCredential(apiUrl)) || notDst(getEnv("API_TOKEN")) || "";
   if (!apiKey) {
     apiKey = await deviceLogin();
   }
@@ -46609,8 +46726,8 @@ Cancelled by user (Ctrl+C)
     return;
   }
   if (positionals[0] === "addmessage") {
-    const [, todoId, ...rest] = positionals;
-    const content2 = rest.join(" ") || await readStdin();
+    const [, todoId, ...rest2] = positionals;
+    const content2 = rest2.join(" ") || await readStdin();
     if (!todoId || !content2) {
       process.stderr.write(`${RED}Usage: todoforai-cli addmessage <todo-id> "content"${RESET}
 `);
@@ -46665,10 +46782,92 @@ Cancelled by user (Ctrl+C)
 `);
     return;
   }
+  if (positionals[0] === "claim" && positionals[1] === "mint") {
+    let seedProjectId = args.seed || args.project || cfgScope.data.default_project_id;
+    if (!seedProjectId) {
+      const projects2 = await api.listProjects();
+      seedProjectId = projects2.find((p) => p.project?.isDefault)?.project?.id || projects2[0]?.project?.id;
+    }
+    if (!seedProjectId) {
+      process.stderr.write(`${RED}Usage: todoforai-cli claim mint --seed <projectId> [--emails a@x,b@y] [--ttl <sec>]${RESET}
+`);
+      process.exit(2);
+    }
+    const emails = args.emails?.split(",").map((e) => e.trim()).filter(Boolean);
+    let ttlSec;
+    if (args.ttl !== undefined) {
+      ttlSec = Number(args.ttl);
+      if (!Number.isFinite(ttlSec)) {
+        process.stderr.write(`${RED}--ttl must be a number (seconds)${RESET}
+`);
+        process.exit(2);
+      }
+    }
+    const res = await fetch(`${apiUrl}/api/v1/claims/mint`, {
+      method: "POST",
+      headers: { "content-type": "application/json", "x-api-key": apiKey },
+      body: JSON.stringify({ seedProjectId, ...emails?.length ? { emails } : {}, ...ttlSec !== undefined ? { ttlSec } : {} }),
+      signal: AbortSignal.timeout(30000)
+    });
+    const text = await res.text();
+    if (!res.ok) {
+      process.stderr.write(`${RED}Mint failed: ${res.status} ${text}${RESET}
+`);
+      process.exit(1);
+    }
+    const out = JSON.parse(text);
+    if (args.json)
+      console.log(JSON.stringify(out, null, 2));
+    else
+      for (const l of out.links)
+        process.stdout.write(`${l.email ? `${l.email}	` : ""}${CYAN}${l.url}${RESET}
+`);
+    return;
+  }
+  if (positionals[0] === "steering" || positionals[0] === "next") {
+    let projectId2 = args.project || cfgScope.data.default_project_id;
+    if (!projectId2) {
+      const projects2 = await api.listProjects();
+      projectId2 = projects2.find((p) => p.project?.isDefault)?.project?.id || projects2[0]?.project?.id;
+    }
+    if (!projectId2) {
+      process.stderr.write(`${RED}No project found \u2014 pass --project <id>${RESET}
+`);
+      process.exit(2);
+    }
+    const sctx = { apiUrl, apiKey, projectId: projectId2, json: !!args.json };
+    if (positionals[0] === "next") {
+      const res = await fetch(`${apiUrl}/api/v1/projects/${projectId2}/recommendations/generate`, {
+        method: "POST",
+        headers: { "content-type": "application/json", "x-api-key": apiKey },
+        body: JSON.stringify({ projectId: projectId2, ...args["business-context"] ? { businessContextId: args["business-context"] } : {} }),
+        signal: AbortSignal.timeout(30000)
+      });
+      const text = await res.text();
+      if (!res.ok) {
+        process.stderr.write(`${RED}Generate failed: ${res.status} ${text}${RESET}
+`);
+        process.exit(1);
+      }
+      const out = JSON.parse(text);
+      if (args.json)
+        console.log(JSON.stringify(out, null, 2));
+      else
+        process.stderr.write(`${GREEN}\u2705 Generating recommendations \u2014 analyzer todo ${out.todoId}${RESET}
+`);
+      return;
+    }
+    await steeringCommand(sctx, positionals.slice(1));
+    return;
+  }
   if (args["list-agents"]) {
     await listAgentsCommand(api, { json: !!args.json, formatPath: formatPathWithTilde });
     return;
   }
+  if (args["list-models"]) {
+    await listModelsCommand(api, { json: !!args.json, filter: positionals[0] });
+    return;
+  }
   if (positionals[0] === "agent") {
     await agentCommand(api, positionals, args, formatPathWithTilde);
     return;
@@ -46768,6 +46967,8 @@ Cancelled by user (Ctrl+C)
     const frontendUrl2 = getFrontendUrl(apiUrl, projectId2, todoId);
     if (args.json) {
       console.log(JSON.stringify({ ...todo2, frontend_url: frontendUrl2 }, null, 2));
+    } else if (args["no-watch"]) {
+      console.log(`created ${todoId}`);
     } else {
       process.stderr.write(`${DIM}TODO:${RESET} ${CYAN}${frontendUrl2}${RESET}
 `);
@@ -46962,6 +47163,8 @@ Resumed: ${CYAN}${getFrontendUrl(apiUrl, projectId2, todoId)}${RESET}
   const frontendUrl = getFrontendUrl(apiUrl, projectId, actualTodoId);
   if (args.json) {
     console.log(JSON.stringify({ ...todo, frontend_url: frontendUrl }, null, 2));
+  } else if (!ws) {
+    console.log(`created ${actualTodoId}`);
   } else {
     process.stderr.write(`${DIM}TODO:${RESET} ${CYAN}${frontendUrl}${RESET}
 `);

package/package.json

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