@flowapt/flowiq-cli 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowapt/flowiq-cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Command-line tool for FlowIQ staff: round-trip agent prompts, questionnaires, webhooks, and more without ever touching service-role credentials.",
   "type": "module",
   "bin": {

package/src/commands/messages.js

@@ -0,0 +1,66 @@
+// `flowiq messages pull <contact_id> [--count N]`.
+// Read-only chat fetch (no push — chat history is the system of record).
+
+import fs from "node:fs/promises";
+import path from "node:path";
+import { http } from "../http.js";
+
+const MSG_DIR = path.resolve(process.cwd(), ".flowiq", "messages");
+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(contactId, opts = {}) {
+  if (!UUID_RE.test(contactId)) {
+    console.error(`Error: "${contactId}" is not a valid contact UUID.`);
+    process.exit(1);
+  }
+  const query = { contact_id: contactId };
+  if (opts.count) query.count = String(opts.count);
+
+  let resp;
+  try {
+    resp = await http.get("messages", query);
+  } catch (e) {
+    console.error(`Pull failed: ${e.message}`);
+    process.exit(1);
+  }
+
+  await fs.mkdir(MSG_DIR, { recursive: true });
+  const nameSlug = slugify(
+    resp.contact_name || resp.contact_whatsapp_id || resp.contact_id,
+    resp.contact_id
+  );
+  const orgSlug = resp.organization_name ? slugify(resp.organization_name, "") : "";
+  const slug = orgSlug ? `${nameSlug}-${orgSlug}` : nameSlug;
+  const filePath = path.join(MSG_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(`  contact:        ${resp.contact_name ?? "(no name)"} (${resp.contact_id})`);
+  if (resp.contact_whatsapp_id) {
+    console.log(`  whatsapp_id:    ${resp.contact_whatsapp_id}`);
+  }
+  if (resp.organization_name) {
+    console.log(`  organization:   ${resp.organization_name} (${resp.organization_id})`);
+  }
+  console.log(`  user msgs:      ${resp.user_messages_found}/${resp.user_messages_requested} requested`);
+  console.log(`  anchor:         ${resp.anchor_created_at}`);
+  console.log(`  total rows:     ${resp.total_rows}`);
+  console.log(`  by sender:`);
+  for (const [k, v] of Object.entries(resp.sender_breakdown).sort()) {
+    console.log(`    ${k.padEnd(16)} ${v}`);
+  }
+}

package/src/commands/prompts.js

@@ -65,6 +65,14 @@ export async function pull(orgId) {
   console.log(`  agent:     ${resp.agent_name} (${resp.agent_id})`);
   console.log(`  sections:  ${resp.prompt_sections.length}`);
   console.log(`  content:   ${totalChars.toLocaleString()} chars`);
+  if (resp.bootstrapped) {
+    console.log("");
+    console.log("  ⚠ this agent had no prompt_sections — seeded a single \"Main\"");
+    console.log("    section from settings.system_prompt. on push, system_prompt");
+    console.log("    will be regenerated with a \"## SECTION: Main\" header wrap.");
+    console.log("    split the JSON into proper sections before push if you want");
+    console.log("    different headers.");
+  }
 }
 
 export async function push(identifier) {

package/src/commands/questionnaires.js

@@ -0,0 +1,128 @@
+// `flowiq questionnaires pull <organization_id>` /
+// `flowiq questionnaires push <slug>`.
+// Round-trips an org's active WhatsApp agent's `agents.questionnaire`
+// jsonb column through a local JSON file. No DB credentials on disk.
+
+import fs from "node:fs/promises";
+import path from "node:path";
+import { http } from "../http.js";
+
+const QS_DIR = path.resolve(process.cwd(), ".flowiq", "questionnaires");
+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; }
+}
+
+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(QS_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  ")}`);
+}
+
+function countQuestions(sections) {
+  let total = 0, answered = 0;
+  if (!Array.isArray(sections)) return { total, answered };
+  for (const s of sections) {
+    if (!Array.isArray(s?.questions)) continue;
+    for (const q of s.questions) {
+      total += 1;
+      if ((q?.answer ?? "").trim().length > 0) answered += 1;
+    }
+  }
+  return { total, answered };
+}
+
+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("questionnaires", { organization_id: orgId });
+  } catch (e) {
+    console.error(`Pull failed: ${e.message}`);
+    process.exit(1);
+  }
+
+  await fs.mkdir(QS_DIR, { recursive: true });
+  const slug = slugify(resp.organization_name, resp.organization_id);
+  const filePath = path.join(QS_DIR, `${slug}.json`);
+  const overwriting = await fileExists(filePath);
+  await fs.writeFile(filePath, JSON.stringify(resp, null, 2) + "\n", "utf8");
+
+  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(`  sections:   ${resp.questionnaire?.sections?.length ?? 0}`);
+  console.log(`  questions:  ${answered}/${total} answered`);
+  if (resp.default_used) {
+    console.log(`  note:       DB had no questionnaire — seeded from DEFAULT_QUESTIONNAIRE.`);
+    console.log(`              Pushing the file unchanged will write the full default.`);
+  }
+}
+
+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.organization_id || !UUID_RE.test(data.organization_id)) {
+    console.error(`${filePath}: organization_id missing or invalid`);
+    process.exit(1);
+  }
+  if (!data.questionnaire || !Array.isArray(data.questionnaire.sections)) {
+    console.error(`${filePath}: questionnaire.sections must be an array`);
+    process.exit(1);
+  }
+
+  let resp;
+  try {
+    resp = await http.post("questionnaires", {
+      organization_id: data.organization_id,
+      questionnaire: data.questionnaire,
+    });
+  } catch (e) {
+    console.error(`Push failed: ${e.message}`);
+    process.exit(1);
+  }
+
+  console.log(`Pushed ${filePath}`);
+  console.log(`  org:        ${resp.organization_name} (${resp.organization_id})`);
+  console.log(`  agent:      ${resp.agent_name} (${resp.agent_id})`);
+  console.log(`  sections:   ${resp.sections}`);
+  console.log(`  questions:  ${resp.answered_questions}/${resp.total_questions} answered`);
+}

package/src/index.js

@@ -4,6 +4,8 @@
 import { Command } from "commander";
 import * as authCmd from "./commands/auth.js";
 import * as promptsCmd from "./commands/prompts.js";
+import * as questionnairesCmd from "./commands/questionnaires.js";
+import * as messagesCmd from "./commands/messages.js";
 
 export function run(argv) {
   const program = new Command();
@@ -31,5 +33,25 @@ export function run(argv) {
     .description("Apply a local JSON file's prompt_sections to the agent (regenerates system_prompt server-side)")
     .action((id) => promptsCmd.push(id));
 
+  // questionnaires
+  const qs = program.command("questionnaires")
+    .alias("q")
+    .description("Round-trip an org's active WhatsApp agent's questionnaire answers (agents.questionnaire JSONB)");
+  qs.command("pull <organization_id>")
+    .description("Fetch the active agent's questionnaire into a local JSON file (seeds from DEFAULT_QUESTIONNAIRE if the DB column is empty)")
+    .action((orgId) => questionnairesCmd.pull(orgId));
+  qs.command("push <slug-or-path>")
+    .description("Apply a local JSON file's questionnaire to the agent")
+    .action((id) => questionnairesCmd.push(id));
+
+  // messages (read-only: pull a contact's helpdesk_messages history)
+  const msgs = program.command("messages")
+    .alias("m")
+    .description("Pull a contact's helpdesk_messages history (read-only)");
+  msgs.command("pull <contact_id>")
+    .description("Pull last N user-message windows of conversation for a contact (default N=25, max 200)")
+    .option("--count <n>", "number of most-recent user-* messages to anchor on", "25")
+    .action((contactId, opts) => messagesCmd.pull(contactId, opts));
+
   program.parseAsync(argv);
 }