@flowapt/flowiq-cli 0.1.1 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowapt/flowiq-cli",
-  "version": "0.1.1",
+  "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/index.js

@@ -5,6 +5,7 @@ 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();
@@ -43,5 +44,14 @@ export function run(argv) {
     .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);
 }