@todoforai/cli 0.1.24 → 0.1.26

package/dist/todoai.js

@@ -42859,6 +42859,36 @@ class ApiClient {
       payload.scheduledTimestamp = scheduledTimestamp;
     return this.request("POST", `/api/v1/projects/${projectId}/todos`, payload);
   }
+  async showFile(todoId, file, filename, opts = {}) {
+    const form = new FormData;
+    form.append("file", file, filename);
+    form.append("todoId", todoId);
+    for (const [k, v] of Object.entries(opts))
+      if (v)
+        form.append(k, v);
+    const url = `${this.apiUrl}${restBasePath(this.apiKey)}/resources/show`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: { "x-api-key": this.apiKey },
+      body: form,
+      signal: AbortSignal.timeout(120000)
+    });
+    if (!res.ok)
+      throw new Error(`API POST /resources/show failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
+  async showUrl(todoId, url, opts = {}) {
+    const endpoint = `${this.apiUrl}${restBasePath(this.apiKey)}/resources/open`;
+    const res = await fetch(endpoint, {
+      method: "POST",
+      headers: { "x-api-key": this.apiKey, "Content-Type": "application/json" },
+      body: JSON.stringify({ todoId, url, ...opts }),
+      signal: AbortSignal.timeout(30000)
+    });
+    if (!res.ok)
+      throw new Error(`API POST /resources/open failed: ${res.status} ${await res.text()}`);
+    return res.json();
+  }
   patchEdgeConfig(edgeId, updates) {
     return this.request("PATCH", `/api/v1/edges/${edgeId}`, { updates });
   }
@@ -43465,6 +43495,7 @@ var SERVER_TO_FRONTENDS = {
     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}`,
+    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}`,
@@ -43896,16 +43927,23 @@ 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. FIND OR CREATE A TEMPLATE (todoregistry-cli):
-   - \`todoregistry-cli search <query>\` / \`todoregistry-cli list -c <category>\` / \`todoregistry-cli get <id>\` \u2014 prefer a matching existing template (proven playbook).
-   - If none fits, CREATE one right there (auth is inherited from your shell):
+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.
+
+   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.
+
+   Body structure (REQUIRED \u2014 the body is split into the agent's system prompt and the first user turn by section headings, so follow this exactly):
+   - Start with the persona/expertise and any Rules as plain prose/paragraphs at the top (no heading needed) \u2014 this becomes the agent's system prompt.
+   - 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.
 
-3. Recommend 3-6 cards (highest priority first). When creating a spec for a business-specific action, write the body so the positioning angle and what to track are part of the task. Then reply with a one-line summary per card and tell the user they're waiting in the Recommendations column for review.`,
+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: {},
   edgesMcpConfigs: {},
   permissions: {
@@ -43981,6 +44019,10 @@ var TOPICS = {
     channel: (p) => SERVER_TO_FRONTENDS.todo.context_info_updated(p.todoId),
     audience: "frontend"
   },
+  ["predict:reply_updated" /* PREDICTED_REPLY_UPDATED */]: {
+    channel: (p) => SERVER_TO_FRONTENDS.todo.predicted_reply_updated(p.todoId),
+    audience: "frontend"
+  },
   ["hexgrid:updated" /* HEXGRID_UPDATED */]: {
     channel: (p) => SERVER_TO_FRONTENDS.hexGrid.updated(p.projectId),
     audience: "frontend"
@@ -44113,12 +44155,13 @@ Usage:
   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 show <file|-> [todo-id]     # Show a file in the chat (rendered by mimetype; - reads stdin)
+                                            #   [--title T] [--alias A] [--mime M] [--json]
+  todoforai-cli open <url> [todo-id]        # Show a live http(s) url in the chat as a preview
+                                            #   [--title T] [--alias A] [--json]
   todoforai-cli recommend --template <id>    # Add a template as a recommendation 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 recommendation cards
+  todoforai-cli next [--direction "<text>"]  # Ask the analyzer for growth recommendation cards (optional free-text steer)
 
 Options:
   --path <dir>                    Workspace path (default: cwd)
@@ -44192,6 +44235,9 @@ function parseCliArgs() {
       note: { type: "string" },
       priority: { type: "string" },
       title: { type: "string" },
+      alias: { type: "string" },
+      mime: { type: "string" },
+      direction: { type: "string" },
       "business-context": { type: "string" },
       seed: { type: "string" },
       emails: { type: "string" },
@@ -46405,92 +46451,6 @@ 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}${restBasePath(ctx.apiKey)}${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");
@@ -46735,8 +46695,8 @@ Cancelled by user (Ctrl+C)
     return;
   }
   if (positionals[0] === "addmessage") {
-    const [, todoId, ...rest2] = positionals;
-    const content2 = rest2.join(" ") || await readStdin();
+    const [, todoId, ...rest] = positionals;
+    const content2 = rest.join(" ") || await readStdin();
     if (!todoId || !content2) {
       process.stderr.write(`${RED}Usage: todoforai-cli addmessage <todo-id> "content"${RESET}
 `);
@@ -46751,6 +46711,55 @@ Cancelled by user (Ctrl+C)
 `);
     return;
   }
+  if (positionals[0] === "show") {
+    const [, filePath, todoArg] = positionals;
+    const todoId = todoArg || getEnv("TODO_ID") || cfgScope.data.last_todo_id;
+    if (!filePath || !todoId) {
+      process.stderr.write(`${RED}Usage: todoforai-cli show <file|-> [todo-id]${RESET}
+`);
+      process.exit(2);
+    }
+    let blob, name;
+    if (filePath === "-") {
+      blob = new Blob([await Bun.readableStreamToArrayBuffer(Bun.stdin.stream())]);
+      if (blob.size === 0) {
+        process.stderr.write(`${RED}No data on stdin${RESET}
+`);
+        process.exit(1);
+      }
+      name = "stdin";
+    } else {
+      const file = Bun.file(resolve3(filePath));
+      if (!await file.exists()) {
+        process.stderr.write(`${RED}File not found: ${filePath}${RESET}
+`);
+        process.exit(1);
+      }
+      blob = file;
+      name = path4.basename(filePath);
+    }
+    const res = await api.showFile(todoId, blob, name, { title: args.title, alias: args.alias, mime: args.mime });
+    if (args.json)
+      console.log(JSON.stringify(res, null, 2));
+    else
+      console.log(res.ref);
+    return;
+  }
+  if (positionals[0] === "open") {
+    const [, url, todoArg] = positionals;
+    const todoId = todoArg || getEnv("TODO_ID") || cfgScope.data.last_todo_id;
+    if (!url || !todoId) {
+      process.stderr.write(`${RED}Usage: todoforai-cli open <url> [todo-id]${RESET}
+`);
+      process.exit(2);
+    }
+    const res = await api.showUrl(todoId, url, { title: args.title, alias: args.alias });
+    if (args.json)
+      console.log(JSON.stringify(res, null, 2));
+    else
+      console.log(res.ref);
+    return;
+  }
   if (positionals[0] === "recommend") {
     const templateId = args.template || positionals[1];
     if (!templateId) {
@@ -46833,7 +46842,7 @@ Cancelled by user (Ctrl+C)
 `);
     return;
   }
-  if (positionals[0] === "steering" || positionals[0] === "next") {
+  if (positionals[0] === "next") {
     let projectId2 = args.project || cfgScope.data.default_project_id;
     if (!projectId2) {
       const projects2 = await api.listProjects();
@@ -46844,29 +46853,25 @@ Cancelled by user (Ctrl+C)
 `);
       process.exit(2);
     }
-    const sctx = { apiUrl, apiKey, projectId: projectId2, json: !!args.json };
-    if (positionals[0] === "next") {
-      const res = await fetch(`${apiUrl}${restBasePath(apiKey)}/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}
+    const direction = args.direction || positionals.slice(1).join(" ").trim() || undefined;
+    const res = await fetch(`${apiUrl}${restBasePath(apiKey)}/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"] } : {}, ...direction ? { direction } : {} }),
+      signal: AbortSignal.timeout(30000)
+    });
+    const text = await res.text();
+    if (!res.ok) {
+      process.stderr.write(`${RED}Generate failed: ${res.status} ${text}${RESET}
 `);
-      return;
+      process.exit(1);
     }
-    await steeringCommand(sctx, positionals.slice(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;
   }
   if (args["list-agents"]) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@todoforai/cli",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "type": "module",
   "bin": {
     "todoforai-cli": "bin/todoforai-cli.js",
@@ -14,8 +14,7 @@
     "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"
+    "dev": "bun run src/index.ts"
   },
   "dependencies": {
     "@shared/credentials": "file:../packages/shared-credentials",
@@ -25,7 +24,7 @@
     "ws": "^8.18.0"
   },
   "peerDependencies": {
-    "@todoforai/edge": "file:../edge/bun"
+    "@todoforai/edge": ">=0.12.0"
   },
   "peerDependenciesMeta": {
     "@todoforai/edge": {
@@ -34,7 +33,6 @@
   },
   "devDependencies": {
     "@types/ws": "^8.5.13",
-    "@todoforai/edge": "file:../edge/bun",
     "typescript": "^5.7.0"
   }
 }