@flowapt/flowiq-cli 0.1.6 → 0.1.8

package/src/commands/agents.js

@@ -0,0 +1,76 @@
+// `flowiq agent list <org>` / `flowiq agent create <org> --name … [flags]`.
+// List an org's agents (to discover ids for --agent targeting) and create a
+// new agent via /cli/agents.
+
+import fs from "node:fs/promises";
+import path from "node:path";
+import { http } from "../http.js";
+
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+export async function list(orgId, opts = {}) {
+  if (!UUID_RE.test(orgId)) {
+    console.error(`Error: "${orgId}" is not a valid organization UUID.`);
+    process.exit(1);
+  }
+  let resp;
+  try {
+    resp = await http.get("agents", { organization_id: orgId });
+  } catch (e) {
+    console.error(`List failed: ${e.message}`);
+    process.exit(1);
+  }
+  if (opts.json) { console.log(JSON.stringify(resp, null, 2)); return; }
+
+  const agents = resp.agents || [];
+  console.log(`${resp.organization_name} (${resp.organization_id}) — ${agents.length} agent${agents.length === 1 ? "" : "s"}:`);
+  if (!agents.length) { console.log("  (none — create one with `agent create`)"); return; }
+  for (const a of agents) {
+    const created = a.created_at ? new Date(a.created_at).toISOString().slice(0, 10) : "?";
+    console.log(`  ${a.is_active ? "★" : " "} ${a.id}  ${created}  ${a.name}`);
+  }
+  console.log("\n★ = active agent. Pass any id as --agent <id> to prompts/questionnaires/fine-tuning/agent config.");
+}
+
+export async function create(orgId, opts = {}) {
+  if (!UUID_RE.test(orgId)) {
+    console.error(`Error: "${orgId}" is not a valid organization UUID.`);
+    process.exit(1);
+  }
+  if (!opts.name || !String(opts.name).trim()) {
+    console.error("Error: --name <name> is required.");
+    process.exit(1);
+  }
+
+  let systemPrompt;
+  if (opts.systemPromptFile) {
+    let fp = opts.systemPromptFile;
+    if (!path.isAbsolute(fp)) fp = path.resolve(fp);
+    try { systemPrompt = await fs.readFile(fp, "utf8"); }
+    catch (e) { console.error(`Cannot read --system-prompt-file ${fp}: ${e.message}`); process.exit(1); }
+  } else if (opts.systemPrompt !== undefined) {
+    systemPrompt = opts.systemPrompt;
+  }
+
+  let resp;
+  try {
+    resp = await http.post("agents", {
+      organization_id: orgId,
+      name: opts.name,
+      system_prompt: systemPrompt,
+      make_active: !!opts.makeActive,
+    });
+  } catch (e) {
+    console.error(`Create failed: ${e.message}`);
+    if (e.body?.error) console.error(`  ${e.body.error}`);
+    process.exit(1);
+  }
+
+  console.log(`Created agent "${resp.agent_name}" (${resp.agent_id})`);
+  console.log(`  org:           ${resp.organization_name} (${resp.organization_id})`);
+  console.log(`  active:        ${resp.is_active ? "yes (set as the org's active agent)" : "no"}`);
+  console.log(`  seeded prompt: ${resp.seeded_prompt ? "yes (single \"Main\" section)" : "no (default settings)"}`);
+  if (resp.warning) console.log(`  ⚠ ${resp.warning}`);
+  console.log("\nNext: `agent config " + orgId + " --agent " + resp.agent_id + " --use-settings-prompt --model gpt-5.4-mini`");
+  console.log("      then `prompts pull " + orgId + " --agent " + resp.agent_id + "` to author the full prompt.");
+}

package/src/commands/export.js

@@ -0,0 +1,131 @@
+// `flowiq export chats <organization_id> [--out <path>]`.
+// Full chat export → TXT, byte-identical to the in-app "Export Settings TXT".
+// The server (/cli/export-chats) supplies keyset pages (ordered, whatsapp_id
+// resolved); ALL grouping + formatting happens here, verbatim from the legacy
+// export-chats.mjs, so the output matches the deployed feature exactly.
+
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import path from "node:path";
+import { http } from "../http.js";
+
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+function slugify(name, fallback) {
+  const s = String(name || "")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
+  return s || fallback;
+}
+
+// Verbatim from export-chats.mjs.
+function getSenderLabel(senderType) {
+  if (senderType.startsWith("user-")) return "customer";
+  if (senderType.startsWith("bot-")) return "bot";
+  if (senderType.startsWith("human-")) return "agent";
+  if (senderType.startsWith("flowmod-")) return "flowmod";
+  if (senderType.startsWith("call-")) return "call";
+  if (senderType === "tool-call") return "tool";
+  return senderType;
+}
+
+export async function chats(orgId, opts = {}) {
+  if (!UUID_RE.test(orgId)) {
+    console.error(`Error: "${orgId}" is not a valid organization UUID.`);
+    process.exit(1);
+  }
+
+  const t0 = Date.now();
+
+  // --- Drive the keyset page loop, accumulating messages in global order ---
+  const messages = [];
+  let organizationName = null;
+  let cursor = null;
+  let pages = 0;
+  for (;;) {
+    const query = { organization_id: orgId };
+    if (cursor) {
+      query.cursor_created_at = cursor.created_at;
+      query.cursor_id = cursor.id;
+    }
+    let resp;
+    try {
+      resp = await http.get("export-chats", query);
+    } catch (e) {
+      console.error(`Export failed on page ${pages + 1}: ${e.message}`);
+      process.exit(1);
+    }
+    if (resp.organization_name != null) organizationName = resp.organization_name;
+    const page = resp.page || [];
+    for (const r of page) messages.push(r);
+    pages++;
+    if (pages % 20 === 0) {
+      console.log(`  ...${messages.length.toLocaleString("en-US")} messages (${pages} pages)`);
+    }
+    if (resp.done || !resp.next_cursor) break;
+    cursor = resp.next_cursor;
+  }
+  console.log(`Messages fetched: ${messages.length} in ${pages} page${pages === 1 ? "" : "s"}`);
+
+  // --- Group exactly like the deployed exportTXT: plain object, waId key ---
+  const grouped = {};
+  for (const row of messages) {
+    const whatsappId = row.whatsapp_id ?? null;
+    const waId = (whatsappId || "unknown").replace(/[+ ]/g, "");
+    if (!grouped[waId]) grouped[waId] = [];
+    grouped[waId].push(row);
+  }
+  const uniqueContacts = Object.keys(grouped).length;
+
+  // --- Resolve output path ---
+  let outPath = opts.out;
+  if (!outPath) {
+    const dir = path.resolve(process.cwd(), ".flowiq", "exports");
+    await fsp.mkdir(dir, { recursive: true });
+    outPath = path.join(dir, `${slugify(organizationName, orgId)}-chats.txt`);
+  } else {
+    outPath = path.resolve(outPath);
+    await fsp.mkdir(path.dirname(outPath), { recursive: true });
+  }
+
+  // --- Write the TXT (streamed; content identical to the deployed string build) ---
+  const out = fs.createWriteStream(outPath, { encoding: "utf8" });
+  const write = (s) =>
+    new Promise((resolve, reject) => {
+      if (out.write(s)) resolve();
+      else out.once("drain", resolve);
+      out.once("error", reject);
+    });
+
+  let header = `${organizationName || "Organization"} — Chat Export\n`;
+  header += `Total messages: ${messages.length.toLocaleString()} | Contacts: ${uniqueContacts}\n`;
+  header += `Exported: ${new Date().toLocaleString("en-ZA", { timeZone: "Africa/Johannesburg" })}\n`;
+  header += `${"=".repeat(60)}\n\n`;
+  await write(header);
+
+  for (const [waId, msgs] of Object.entries(grouped)) {
+    let chunk = `--- ${waId} ---\n`;
+    for (const msg of msgs) {
+      const date = msg.created_at
+        ? new Date(msg.created_at).toLocaleString("en-ZA", { timeZone: "Africa/Johannesburg" })
+        : "unknown";
+      const label = getSenderLabel(msg.sender_type || "");
+      let line = `[${date}] (${label}) ${msg.message || ""}`;
+      if (msg.media_url) line += ` [Media: ${msg.media_type || "file"} - ${msg.media_url}]`;
+      if (msg.voice_note_transcription) line += ` [Voice: ${msg.voice_note_transcription}]`;
+      chunk += `${line}\n`;
+    }
+    chunk += `\n`;
+    await write(chunk);
+  }
+
+  await new Promise((resolve, reject) => out.end((err) => (err ? reject(err) : resolve())));
+
+  const secs = ((Date.now() - t0) / 1000).toFixed(1);
+  console.log(`\nDone in ${secs}s`);
+  console.log(`  total messages: ${messages.length.toLocaleString()}`);
+  console.log(`  groups:         ${uniqueContacts}`);
+  console.log(`  file:           ${outPath}`);
+}

package/src/commands/fine-tuning.js

@@ -53,14 +53,14 @@ function countEntries(entries) {
   return { total: entries.length, pending, resolved, byCategory };
 }
 
-export async function pull(orgId) {
+export async function pull(orgId, opts = {}) {
   if (!UUID_RE.test(orgId)) {
     console.error(`Error: "${orgId}" is not a valid organization UUID.`);
     process.exit(1);
   }
   let resp;
   try {
-    resp = await http.get("fine-tuning", { organization_id: orgId });
+    resp = await http.get("fine-tuning", { organization_id: orgId, agent_id: opts.agent });
   } catch (e) {
     console.error(`Pull failed: ${e.message}`);
     process.exit(1);
@@ -75,7 +75,7 @@ export async function pull(orgId) {
   const stats = countEntries(resp.fine_tuning_entries);
   console.log(`${overwriting ? "Overwrote" : "Wrote"} ${filePath}`);
   console.log(`  org:           ${resp.organization_name} (${resp.organization_id})`);
-  console.log(`  agent:         ${resp.agent_name} (${resp.agent_id})`);
+  console.log(`  agent:         ${resp.agent_name} (${resp.agent_id})${resp.is_active === false ? " [NON-active]" : ""}`);
   console.log(`  instructions:  ${resp.fine_tuning.length} chars`);
   console.log(`  entries:       ${stats.total} (${stats.pending} pending, ${stats.resolved} resolved)`);
   if (stats.total > 0) {
@@ -118,6 +118,7 @@ export async function push(identifier) {
       organization_id: data.organization_id,
       fine_tuning: data.fine_tuning,
       fine_tuning_entries: data.fine_tuning_entries ?? [],
+      agent_id: data.agent_id, // push back to the agent this file was pulled from
     });
   } catch (e) {
     console.error(`Push failed: ${e.message}`);

package/src/commands/org.js

@@ -0,0 +1,33 @@
+// `flowiq org info <organization_id>` — read-only org summary (platform detect
+// + active agent) for the prompt-builder skill's Step 0. Raw store/Meta creds
+// are stripped server-side; this only prints derived booleans + public urls.
+
+import { http } from "../http.js";
+
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+export async function info(orgId, opts = {}) {
+  if (!UUID_RE.test(orgId)) {
+    console.error(`Error: "${orgId}" is not a valid organization UUID.`);
+    process.exit(1);
+  }
+  let resp;
+  try {
+    resp = await http.get("org", { organization_id: orgId });
+  } catch (e) {
+    console.error(`Lookup failed: ${e.message}`);
+    process.exit(1);
+  }
+
+  if (opts.json) {
+    console.log(JSON.stringify(resp, null, 2));
+    return;
+  }
+
+  console.log(`${resp.name} (${resp.id})`);
+  console.log(`  platform:      ${resp.platform || "(neither shopify nor woo)"}${resp.ip_whitelist ? " [ip_whitelist]" : ""}`);
+  if (resp.shopify_domain) console.log(`  shopify:       ${resp.shopify_domain}`);
+  if (resp.woo_store_url) console.log(`  woo store:     ${resp.woo_store_url}`);
+  console.log(`  provider:      ${resp.provider || "(unset → meta)"}`);
+  console.log(`  active agent:  ${resp.active_whatsapp_agent || "(NONE — set one before building a prompt)"}`);
+}

package/src/commands/pinboard.js

@@ -0,0 +1,174 @@
+// `flowiq pinboard pull <task_id>` / `push <slug>` / `list` / `list-remote [status]`.
+// Round-trips a single Pin Board task (flowapt_tasks row) via /cli/pinboard.
+// No DB credentials on disk — all work happens server-side.
+
+import fs from "node:fs/promises";
+import path from "node:path";
+import { http } from "../http.js";
+
+const PIN_DIR = path.resolve(process.cwd(), ".flowiq", "pinboard");
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const VALID_STATUS = ["open", "in_progress", "done"];
+
+function slugify(name, fallback) {
+  const s = String(name || "")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
+  return (s || fallback).slice(0, 60);
+}
+
+async function fileExists(p) {
+  try { await fs.access(p); return true; } catch { return false; }
+}
+
+async function resolvePushPath(identifier) {
+  const candidates = [];
+  if (path.isAbsolute(identifier)) {
+    candidates.push(identifier);
+  } else if (identifier.includes("/") || identifier.includes("\\")) {
+    candidates.push(path.resolve(identifier));
+  } else {
+    const base = identifier.endsWith(".json") ? identifier : `${identifier}.json`;
+    candidates.push(path.join(PIN_DIR, base));
+    candidates.push(path.resolve(base));
+  }
+  for (const c of candidates) {
+    if (await fileExists(c)) return c;
+  }
+  throw new Error(`File not found. Tried:\n  ${candidates.join("\n  ")}`);
+}
+
+export async function pull(taskId) {
+  if (!UUID_RE.test(taskId)) {
+    console.error(`Error: "${taskId}" is not a valid task UUID.`);
+    process.exit(1);
+  }
+  let resp;
+  try {
+    resp = await http.get("pinboard", { task_id: taskId });
+  } catch (e) {
+    console.error(`Pull failed: ${e.message}`);
+    process.exit(1);
+  }
+
+  await fs.mkdir(PIN_DIR, { recursive: true });
+  const slug = slugify(resp.name, resp.id);
+  const filePath = path.join(PIN_DIR, `${slug}.json`);
+  const overwriting = await fileExists(filePath);
+  await fs.writeFile(filePath, JSON.stringify(resp, null, 2) + "\n", "utf8");
+
+  const orgs = resp.organizations_resolved || [];
+  console.log(`${overwriting ? "Overwrote" : "Wrote"} ${filePath}`);
+  console.log(`  id:        ${resp.id}`);
+  console.log(`  name:      ${resp.name}`);
+  console.log(`  status:    ${resp.status} / ${resp.urgency}`);
+  console.log(`  due:       ${resp.preferred_due_date || "(none)"}`);
+  console.log(`  orgs:      ${(resp.organizations || []).length}${orgs.length ? " (" + orgs.map((o) => o.name || o.id.slice(0, 8)).join(", ") + ")" : ""}`);
+  console.log(`  media:     ${(resp.media || []).length}`);
+  console.log(`  messages:  ${(resp.messages || []).length}`);
+  console.log(`  created:   ${resp.created_by} @ ${resp.created_at}`);
+}
+
+export async function push(identifier) {
+  let filePath;
+  try {
+    filePath = await resolvePushPath(identifier);
+  } catch (e) {
+    console.error(`Error: ${e.message}`);
+    process.exit(1);
+  }
+  const raw = await fs.readFile(filePath, "utf8");
+  let data;
+  try { data = JSON.parse(raw); }
+  catch (e) {
+    console.error(`Invalid JSON in ${filePath}: ${e.message}`);
+    process.exit(1);
+  }
+  if (!data.id || !UUID_RE.test(data.id)) {
+    console.error(`${filePath}: id missing or invalid`);
+    process.exit(1);
+  }
+
+  let resp;
+  try {
+    resp = await http.post("pinboard", {
+      id: data.id,
+      name: data.name,
+      description: data.description ?? null,
+      status: data.status,
+      urgency: data.urgency,
+      preferred_due_date: data.preferred_due_date ?? null,
+      organizations: data.organizations ?? [],
+      media: data.media ?? [],
+      messages: data.messages ?? [],
+      created_by: data.created_by,
+    });
+  } catch (e) {
+    console.error(`Push failed: ${e.message}`);
+    process.exit(1);
+  }
+
+  console.log(`Pushed ${filePath}`);
+  console.log(`  id:        ${resp.id}`);
+  console.log(`  name:      ${resp.name}`);
+  console.log(`  status:    ${resp.status} / ${resp.urgency}`);
+  console.log(`  due:       ${resp.preferred_due_date || "(none)"}`);
+  console.log(`  orgs:      ${resp.orgs}`);
+  console.log(`  media:     ${resp.media}`);
+  console.log(`  messages:  ${resp.messages}`);
+}
+
+export async function list() {
+  let files;
+  try {
+    files = (await fs.readdir(PIN_DIR)).filter((f) => f.endsWith(".json"));
+  } catch {
+    console.log("(no local task files; run `pinboard pull <task_id>`, or `pinboard list-remote` to see ids)");
+    return;
+  }
+  if (!files.length) {
+    console.log("(no local task files; run `pinboard pull <task_id>`, or `pinboard list-remote` to see ids)");
+    return;
+  }
+  files.sort();
+  for (const f of files) {
+    const fp = path.join(PIN_DIR, f);
+    try {
+      const d = JSON.parse(await fs.readFile(fp, "utf8"));
+      console.log(f);
+      console.log(`  id:       ${d.id || "?"}`);
+      console.log(`  name:     ${d.name || "(unknown)"}`);
+      console.log(`  status:   ${d.status || "?"} / ${d.urgency || "?"}`);
+      console.log(`  msgs:     ${Array.isArray(d.messages) ? d.messages.length : "?"}`);
+      console.log(`  pulled:   ${d.pulled_at || "(unknown)"}`);
+    } catch (e) {
+      console.log(`${f}  [invalid JSON: ${e.message}]`);
+    }
+  }
+}
+
+export async function listRemote(statusFilter) {
+  if (statusFilter && !VALID_STATUS.includes(statusFilter)) {
+    console.error(`Invalid status filter "${statusFilter}". Use one of ${VALID_STATUS.join(" | ")}.`);
+    process.exit(1);
+  }
+  let resp;
+  try {
+    resp = await http.get("pinboard", { list: "1", status: statusFilter });
+  } catch (e) {
+    console.error(`List failed: ${e.message}`);
+    process.exit(1);
+  }
+  const tasks = resp.tasks || [];
+  if (!tasks.length) {
+    console.log(statusFilter ? `(no tasks with status=${statusFilter})` : "(no tasks in flowapt_tasks)");
+    return;
+  }
+  console.log(`Found ${tasks.length} task${tasks.length === 1 ? "" : "s"}${statusFilter ? ` (status=${statusFilter})` : ""}:\n`);
+  for (const t of tasks) {
+    const updated = t.updated_at ? new Date(t.updated_at).toISOString().replace("T", " ").slice(0, 16) : "?";
+    console.log(`  ${t.id}  [${String(t.status).padEnd(11)}] [${String(t.urgency).padEnd(8)}]  ${updated}  ${t.created_by} — ${t.name}`);
+  }
+}

package/src/commands/prompts.js

@@ -40,14 +40,14 @@ async function resolvePushPath(identifier) {
   throw new Error(`File not found. Tried:\n  ${candidates.join("\n  ")}`);
 }
 
-export async function pull(orgId) {
+export async function pull(orgId, opts = {}) {
   if (!UUID_RE.test(orgId)) {
     console.error(`Error: "${orgId}" is not a valid organization UUID.`);
     process.exit(1);
   }
   let resp;
   try {
-    resp = await http.get("prompts", { organization_id: orgId });
+    resp = await http.get("prompts", { organization_id: orgId, agent_id: opts.agent });
   } catch (e) {
     console.error(`Pull failed: ${e.message}`);
     process.exit(1);
@@ -62,7 +62,7 @@ export async function pull(orgId) {
   const totalChars = resp.prompt_sections.reduce((a, s) => a + (s.content?.length || 0), 0);
   console.log(`${overwriting ? "Overwrote" : "Wrote"} ${filePath}`);
   console.log(`  org:       ${resp.organization_name} (${resp.organization_id})`);
-  console.log(`  agent:     ${resp.agent_name} (${resp.agent_id})`);
+  console.log(`  agent:     ${resp.agent_name} (${resp.agent_id})${resp.is_active === false ? " [NON-active]" : ""}`);
   console.log(`  sections:  ${resp.prompt_sections.length}`);
   console.log(`  content:   ${totalChars.toLocaleString()} chars`);
   if (resp.bootstrapped) {
@@ -105,6 +105,7 @@ export async function push(identifier) {
     resp = await http.post("prompts", {
       organization_id: data.organization_id,
       prompt_sections: data.prompt_sections,
+      agent_id: data.agent_id, // push back to the agent this file was pulled from
     });
   } catch (e) {
     console.error(`Push failed: ${e.message}`);

package/src/commands/questionnaires.js

@@ -53,14 +53,14 @@ function countQuestions(sections) {
   return { total, answered };
 }
 
-export async function pull(orgId) {
+export async function pull(orgId, opts = {}) {
   if (!UUID_RE.test(orgId)) {
     console.error(`Error: "${orgId}" is not a valid organization UUID.`);
     process.exit(1);
   }
   let resp;
   try {
-    resp = await http.get("questionnaires", { organization_id: orgId });
+    resp = await http.get("questionnaires", { organization_id: orgId, agent_id: opts.agent });
   } catch (e) {
     console.error(`Pull failed: ${e.message}`);
     process.exit(1);
@@ -75,7 +75,7 @@ export async function pull(orgId) {
   const { total, answered } = countQuestions(resp.questionnaire?.sections);
   console.log(`${overwriting ? "Overwrote" : "Wrote"} ${filePath}`);
   console.log(`  org:        ${resp.organization_name} (${resp.organization_id})`);
-  console.log(`  agent:      ${resp.agent_name} (${resp.agent_id})`);
+  console.log(`  agent:      ${resp.agent_name} (${resp.agent_id})${resp.is_active === false ? " [NON-active]" : ""}`);
   console.log(`  sections:   ${resp.questionnaire?.sections?.length ?? 0}`);
   console.log(`  questions:  ${answered}/${total} answered`);
   if (resp.default_used) {
@@ -114,6 +114,7 @@ export async function push(identifier) {
     resp = await http.post("questionnaires", {
       organization_id: data.organization_id,
       questionnaire: data.questionnaire,
+      agent_id: data.agent_id, // push back to the agent this file was pulled from
     });
   } catch (e) {
     console.error(`Push failed: ${e.message}`);

package/src/commands/templates.js

@@ -0,0 +1,156 @@
+// `flowiq templates pull <org_id>` / `list` — read WhatsApp templates from Meta.
+// `flowiq templates create <org> --request-file f.json` / `status` — §12 (create).
+// Pull is read-only via /cli/templates; create proxies /cli/meta-templates.
+
+import fs from "node:fs/promises";
+import path from "node:path";
+import { http } from "../http.js";
+
+const TPL_DIR = path.resolve(process.cwd(), ".flowiq", "templates");
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+function slugify(name, fallback) {
+  const s = String(name || "")
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
+  return s || fallback;
+}
+
+async function fileExists(p) {
+  try { await fs.access(p); return true; } catch { return false; }
+}
+
+export async function pull(orgId) {
+  if (!UUID_RE.test(orgId)) {
+    console.error(`Error: "${orgId}" is not a valid organization UUID.`);
+    process.exit(1);
+  }
+  let resp;
+  try {
+    resp = await http.get("templates", { organization_id: orgId });
+  } catch (e) {
+    console.error(`Pull failed: ${e.message}`);
+    process.exit(1);
+  }
+
+  await fs.mkdir(TPL_DIR, { recursive: true });
+  const slug = slugify(resp.organization_name, resp.organization_id);
+  const filePath = path.join(TPL_DIR, `${slug}.json`);
+  const overwriting = await fileExists(filePath);
+  await fs.writeFile(filePath, JSON.stringify(resp, null, 2) + "\n", "utf8");
+
+  console.log(`${overwriting ? "Overwrote" : "Wrote"} ${filePath}`);
+  console.log(`  org:       ${resp.organization_name} (${resp.organization_id})`);
+  console.log(`  waba:      ${resp.waba_id}`);
+  if (resp.meta_phone_number) console.log(`  phone:     ${resp.meta_phone_number}`);
+  console.log(`  templates: ${resp.template_count}`);
+  console.log(`  status:    ${JSON.stringify(resp.summary?.byStatus || {})}`);
+  console.log(`  category:  ${JSON.stringify(resp.summary?.byCategory || {})}`);
+  console.log(`  language:  ${JSON.stringify(resp.summary?.byLanguage || {})}`);
+}
+
+export async function create(orgId, opts = {}) {
+  if (!opts.requestFile) {
+    console.error("Error: --request-file <path> is required (JSON with template_request, optional template_data/media_header/cards_media).");
+    process.exit(1);
+  }
+  let filePath = opts.requestFile;
+  if (!path.isAbsolute(filePath)) filePath = path.resolve(filePath);
+  let data;
+  try {
+    data = JSON.parse(await fs.readFile(filePath, "utf8"));
+  } catch (e) {
+    console.error(`Cannot read request file ${filePath}: ${e.message}`);
+    process.exit(1);
+  }
+
+  // The file may be the full edge-fn body, or just the inner template_request.
+  const organizationId = orgId || data.organization_id;
+  if (!organizationId || !UUID_RE.test(organizationId)) {
+    console.error("Error: organization_id missing/invalid (pass <org_id> or include it in the request file).");
+    process.exit(1);
+  }
+  const templateRequest = data.template_request || (data.name ? data : null);
+  if (!templateRequest) {
+    console.error("Error: request file must contain a `template_request` object (or be one, with a `name`).");
+    process.exit(1);
+  }
+
+  let resp;
+  try {
+    resp = await http.post("meta-templates", {
+      organization_id: organizationId,
+      template_request: templateRequest,
+      template_data: data.template_data,
+      media_header: data.media_header,
+      cards_media: data.cards_media,
+    });
+  } catch (e) {
+    console.error(`Create failed: ${e.message}`);
+    if (e.body) console.error(JSON.stringify(e.body, null, 2));
+    process.exit(1);
+  }
+
+  console.log(`Submitted template "${templateRequest.name}" for org ${organizationId}`);
+  console.log(JSON.stringify(resp, null, 2));
+}
+
+export async function status(orgId, opts = {}) {
+  if (!UUID_RE.test(orgId)) {
+    console.error(`Error: "${orgId}" is not a valid organization UUID.`);
+    process.exit(1);
+  }
+  let resp;
+  try {
+    resp = await http.get("meta-templates", { organization_id: orgId, name: opts.name });
+  } catch (e) {
+    console.error(`Status lookup failed: ${e.message}`);
+    process.exit(1);
+  }
+  const rows = resp.templates || [];
+  if (!rows.length) {
+    console.log(opts.name ? `(no templates matching "${opts.name}")` : "(no templates on record for this org)");
+    return;
+  }
+  console.log(`${rows.length} template row${rows.length === 1 ? "" : "s"}${opts.name ? ` matching "${opts.name}"` : ""}:`);
+  for (const t of rows) {
+    const name = t.template_name || t.name || "(unnamed)";
+    const st = t.status || "(no status)";
+    const cat = t.category ? ` [${t.category}]` : "";
+    console.log(`  ${name.padEnd(40)} ${String(st).padEnd(16)}${cat}`);
+  }
+  console.log("\nNote: status is captured at submit time (older rows may be null). For the live");
+  console.log("Meta-side status + rejection reasons, run `templates pull <org_id>`.");
+}
+
+export async function list() {
+  let files;
+  try {
+    files = (await fs.readdir(TPL_DIR)).filter((f) => f.endsWith(".json"));
+  } catch {
+    console.log("(no local template files; run `templates pull <org_id>`)");
+    return;
+  }
+  if (!files.length) {
+    console.log("(no local template files; run `templates pull <org_id>`)");
+    return;
+  }
+  files.sort();
+  for (const f of files) {
+    const fp = path.join(TPL_DIR, f);
+    try {
+      const d = JSON.parse(await fs.readFile(fp, "utf8"));
+      console.log(f);
+      console.log(`  org:       ${d.organization_name ?? "(unknown)"} (${d.organization_id ?? "?"})`);
+      console.log(`  waba:      ${d.waba_id ?? "?"}`);
+      console.log(`  phone:     ${d.meta_phone_number ?? "(none)"}`);
+      console.log(`  templates: ${d.template_count ?? (Array.isArray(d.templates) ? d.templates.length : "?")}`);
+      if (d.summary?.byStatus) console.log(`  status:    ${JSON.stringify(d.summary.byStatus)}`);
+      console.log(`  pulled:    ${d.pulled_at ?? "(unknown)"}`);
+    } catch (e) {
+      console.log(`${f}  [invalid JSON: ${e.message}]`);
+    }
+  }
+}