@flowapt/flowiq-cli 0.1.5 → 0.1.7

package/src/data/scenarios.qa.json

@@ -0,0 +1,41 @@
+{
+  "name": "Generic agent smoke pack (org-agnostic)",
+  "note": "Universal FlowIQ-agent behaviours. Assertion-light on purpose — replies are dumped for inspection since exact copy varies per org. Safe to run against any org via `qa <org_id>`. For org-specific assertions, author a pack and run it with `scenario <org_id> <file>`.",
+  "scenarios": [
+    {
+      "id": "greeting",
+      "title": "Greeting / warmth",
+      "turns": [
+        { "text": "Hi there, how are you doing today?", "expectNot": ["👉"] }
+      ]
+    },
+    {
+      "id": "off-topic",
+      "title": "Off-topic request (should decline in one message)",
+      "turns": [
+        { "text": "What's the weather like today?" }
+      ]
+    },
+    {
+      "id": "product-basic",
+      "title": "Basic product question",
+      "turns": [
+        { "text": "What are your best-selling products?" }
+      ]
+    },
+    {
+      "id": "human-handover",
+      "title": "Request a human",
+      "turns": [
+        { "text": "This isn't helping. Can I please speak to a real person?" }
+      ]
+    },
+    {
+      "id": "rating-reply",
+      "title": "End-of-chat rating reply",
+      "turns": [
+        { "text": "I'd rate this chat a 3 out of 5." }
+      ]
+    }
+  ]
+}

package/src/index.js

@@ -12,6 +12,15 @@ import * as messagesCmd from "./commands/messages.js";
 import * as fineTuningCmd from "./commands/fine-tuning.js";
 import * as messagingWebhooksCmd from "./commands/messaging-webhooks.js";
 import * as webhooksCmd from "./commands/webhooks.js";
+import * as flowmodCmd from "./commands/flowmod.js";
+import * as groupsCmd from "./commands/groups.js";
+import * as pinboardCmd from "./commands/pinboard.js";
+import * as templatesCmd from "./commands/templates.js";
+import * as orgCmd from "./commands/org.js";
+import * as agentConfigCmd from "./commands/agent-config.js";
+import * as agentUpdatesCmd from "./commands/agent-updates.js";
+import * as exportCmd from "./commands/export.js";
+import * as testCmd from "./commands/agent-test.js";
 
 // Read version from package.json so it stays in sync with the published npm
 // version automatically (single source of truth — bumping package.json on each
@@ -103,5 +112,167 @@ export function run(argv) {
     .description("WooCommerce-only: flip a webhook back to status=active (WC auto-disables after delivery failures)")
     .action((id, webhookId) => webhooksCmd.reconnect(id, webhookId));
 
+  // flowmod (FlowMod master-group prompts + config: flowmod_master_groups + flowmod_prompts)
+  const flowmod = program.command("flowmod")
+    .alias("fm")
+    .description("Round-trip a FlowMod org's master-group prompts + config (flowmod_master_groups + flowmod_prompts)");
+  flowmod.command("pull <organization_id>")
+    .description("Fetch all master_groups + their flowmod_prompts into a local JSON file")
+    .action((orgId) => flowmodCmd.pull(orgId));
+  flowmod.command("push <slug-or-path>")
+    .description("Apply a local JSON file's master_group + prompt edits (text, config, pre_filter_prompt, signatures)")
+    .action((id) => flowmodCmd.push(id));
+
+  // groups (read-only: pull WhatsApp GROUP chat history from the FlowMod Evolution DB)
+  const groups = program.command("groups")
+    .alias("grp")
+    .description("Read WhatsApp group chat history from the FlowMod Evolution DB (set FLOWMOD_EVO_DB_URL env). Read-only.");
+  groups.command("list")
+    .description("List an Evolution instance's group chats with message counts + last activity")
+    .option("--instance <name>", "Evolution instance name", "flowapt")
+    .action((opts) => groupsCmd.list(opts));
+  groups.command("pull <name-or-jid>")
+    .description("Pull a group's messages in a time window into a local JSON file + print a timeline")
+    .option("--instance <name>", "Evolution instance name", "flowapt")
+    .option("--last <window>", "rolling window back from now, e.g. 48h, 7d, 2w, 90m", "48h")
+    .option("--since <date>", "window start (SAST), YYYY-MM-DD or \"YYYY-MM-DD HH:MM\" (overrides --last)")
+    .option("--until <date>", "window end (SAST), defaults to now")
+    .option("--limit <n>", "max messages to keep (most-recent in window)", String(1000))
+    .option("--json", "print the full JSON payload to stdout instead of the timeline")
+    .action((nameOrJid, opts) => groupsCmd.pull(nameOrJid, opts));
+
+  // pinboard (one flowapt_tasks row: Pin Board team task board)
+  const pinboard = program.command("pinboard")
+    .alias("pin")
+    .description("Round-trip a single Pin Board task (flowapt_tasks row)");
+  pinboard.command("pull <task_id>")
+    .description("Fetch one task into a local JSON file")
+    .action((taskId) => pinboardCmd.pull(taskId));
+  pinboard.command("push <slug-or-path>")
+    .description("Apply a local JSON file's editable fields back to the task row (stamps updated_at)")
+    .action((id) => pinboardCmd.push(id));
+  pinboard.command("list")
+    .description("List local task JSON files")
+    .action(() => pinboardCmd.list());
+  pinboard.command("list-remote [status]")
+    .description("List every task in the DB (optionally filter: open | in_progress | done) to find an id")
+    .action((status) => pinboardCmd.listRemote(status));
+
+  // templates (read WhatsApp templates from Meta; create via /cli/meta-templates)
+  const templates = program.command("templates")
+    .alias("tpl")
+    .description("Read an org's WhatsApp templates from Meta (pull/list); create + submit to Meta (create/status)");
+  templates.command("pull <organization_id>")
+    .description("Fetch every live WhatsApp template from Meta into a local JSON snapshot")
+    .action((orgId) => templatesCmd.pull(orgId));
+  templates.command("list")
+    .description("List local template snapshots")
+    .action(() => templatesCmd.list());
+  templates.command("create [organization_id]")
+    .description("Submit a new WhatsApp template to Meta via the create-meta-template edge fn")
+    .requiredOption("--request-file <path>", "JSON file with template_request (+ optional template_data/media_header/cards_media)")
+    .action((orgId, opts) => templatesCmd.create(orgId, opts));
+  templates.command("status <organization_id>")
+    .description("List the org's template rows (name + status) to poll Meta approval")
+    .option("--name <substr>", "filter by template name substring")
+    .action((orgId, opts) => templatesCmd.status(orgId, opts));
+
+  // org (read-only org summary for the prompt-builder skill, creds stripped)
+  const org = program.command("org").description("Read-only org info (platform detect + active agent)");
+  org.command("info <organization_id>")
+    .description("Show the org's platform, storefront url + active agent (raw creds stripped)")
+    .option("--json", "print the raw JSON payload")
+    .action((orgId, opts) => orgCmd.info(orgId, opts));
+
+  // agent (agent-level config writes: the prompt-builder skill's Step 5)
+  const agent = program.command("agent").description("Configure the org's active agent");
+  agent.command("config <organization_id>")
+    .description("Set allowlisted agent config (no flags = show current)")
+    .option("--use-settings-prompt [bool]", "settings.use_settings_prompt (true if bare)")
+    .option("--model <model>", "settings.model (e.g. gpt-5.4-mini)")
+    .option("--rename <name>", "rename the agent")
+    .option("--tool <flag=bool>", "toggle a tool flag (repeatable): woo_order_build/woo_tip_field/woo_order_note_field/view_cart_tool/restock_tool/block_tool_status/postal_code_tool_status/shopify_products_web_chat", agentConfigCmd.collectTool, [])
+    .option("--discount [bool]", "agent.discount.enabled (true if bare)")
+    .action((orgId, opts) => agentConfigCmd.config(orgId, opts));
+
+  // agent-updates (pending client change-requests + chat context; read-only)
+  const au = program.command("agent-updates")
+    .alias("au")
+    .description("Pull pending agent_updates + the chat context around each (read-only)");
+  au.command("pull <organization_id>")
+    .description("Fetch updates + linked contact + trigger-message window; downloads attachments locally")
+    .option("--status <status>", "pending (default) | resolved | in_progress | all")
+    .option("--titles <list>", "only updates whose title contains any of these (comma-separated, ci substring)")
+    .option("--before <n>", "context messages before the trigger (default 12)")
+    .option("--after <n>", "context messages after the trigger (default 8)")
+    .option("--recent <n>", "fallback window when no linked message but a contact exists (default 20)")
+    .option("--no-files", "do NOT download attachments (default: download is ON)")
+    .option("--max-mb <n>", "skip attachments larger than N MB (default 25)")
+    .action((orgId, opts) => agentUpdatesCmd.pull(orgId, opts));
+  au.command("list")
+    .description("List local agent-updates snapshots")
+    .action(() => agentUpdatesCmd.list());
+
+  // export (full chat history → TXT, byte-identical to the in-app export)
+  const exp = program.command("export").description("Export data to local files");
+  exp.command("chats <organization_id>")
+    .description("Export the org's full chat history to a TXT file (keyset-paginated, byte-matches the in-app export)")
+    .option("--out <path>", "output path (default .flowiq/exports/<slug>-chats.txt)")
+    .action((orgId, opts) => exportCmd.chats(orgId, opts));
+
+  // test (drive the org's LIVE agent through the web/test channel; no real WhatsApp)
+  const test = program.command("test").description("Test an org's live agent via the web/test channel (never sends a real WhatsApp)");
+  test.command("resolve <organization_id>")
+    .description("Print the resolved agent + test contact + endpoint")
+    .option("--agent <id>", "test a specific (non-active) agent in the org")
+    .action((orgId, opts) => testCmd.resolve(orgId, opts));
+  test.command("send <organization_id> <message...>")
+    .description("Send one message, print the reply + any tool calls")
+    .option("--agent <id>", "test a specific (non-active) agent")
+    .option("--clear", "clear the conversation before the run")
+    .option("--sender <name>", "senderName in the payload (default the test contact's name)")
+    .option("--image <url>", "attach a publicly-fetchable image URL (text is the caption)")
+    .option("--timeout <ms>", "per-turn HTTP timeout (default 120000)")
+    .option("--json", "print raw JSON instead of the transcript")
+    .action((orgId, message, opts) => testCmd.send(orgId, message, opts));
+  test.command("scenario <organization_id> <file>")
+    .description("Run a scenario pack (JSON: {scenarios:[{id,title,turns:[{text,expect?,expectNot?}]}]})")
+    .option("--agent <id>", "test a specific agent")
+    .option("--no-clear-between", "do NOT clear between scenarios (one long thread)")
+    .option("--sender <name>", "senderName")
+    .option("--timeout <ms>", "per-turn HTTP timeout (default 120000)")
+    .option("--json", "print raw JSON results")
+    .action((orgId, file, opts) => testCmd.scenario(orgId, file, opts));
+  test.command("qa <organization_id>")
+    .description("Run the bundled generic smoke pack")
+    .option("--agent <id>", "test a specific agent")
+    .option("--no-clear-between", "do NOT clear between scenarios")
+    .option("--sender <name>", "senderName")
+    .option("--timeout <ms>", "per-turn HTTP timeout")
+    .option("--json", "print raw JSON results")
+    .action((orgId, opts) => testCmd.qa(orgId, opts));
+  test.command("clear <organization_id>")
+    .description("Clear the test conversation (hide history via memory_cutoff)")
+    .option("--agent <id>", "target a specific agent's test contact")
+    .action((orgId, opts) => testCmd.clear(orgId, opts));
+  test.command("stress <organization_id> [pack]")
+    .description("Run an adversarial pack in parallel, one isolated contact per scenario (phase 2)")
+    .option("--agent <id>", "test a specific agent")
+    .option("--concurrency <n>", "parallel scenarios (default 6)")
+    .option("--timeout <ms>", "per-turn HTTP timeout")
+    .option("--out <path>", "results file (default .flowiq/agent-test/stress-results.json)")
+    .option("--contact <id>", "use a fixed real contact instead of isolated ones (forces concurrency 1)")
+    .action((orgId, pack, opts) => testCmd.stress(orgId, pack, opts));
+  test.command("cleanup <organization_id>")
+    .description("DELETE the stress test contacts + their messages/sessions")
+    .option("--agent <id>", "target a specific agent's stress contacts")
+    .option("--confirm", "required — confirms the destructive delete")
+    .action((orgId, opts) => testCmd.cleanup(orgId, opts));
+  test.command("extract <organization_id>")
+    .description("Rebuild full stress transcripts from the DB (for an LLM judge)")
+    .option("--agent <id>", "target a specific agent's stress contacts")
+    .option("--out <path>", "output file (default .flowiq/agent-test/judge_input.json)")
+    .action((orgId, opts) => testCmd.extract(orgId, opts));
+
   program.parseAsync(argv);
 }