@flowapt/flowiq-cli 0.10.0 → 0.11.0

package/src/index.js

@@ -41,6 +41,9 @@ import * as broadcastCmd from "./commands/broadcast.js";
 import * as segmentsCmd from "./commands/segments.js";
 import * as tagCmd from "./commands/tag.js";
 import * as linksCmd from "./commands/links.js";
+import * as membersCmd from "./commands/members.js";
+import * as notesCmd from "./commands/notes.js";
+import * as productsCmd from "./commands/products.js";
 import * as keywordsCmd from "./commands/keywords.js";
 import * as guideCmd from "./commands/guide.js";
 import * as auditCmd from "./commands/audit.js";
@@ -116,7 +119,8 @@ export function run(argv) {
     .action((orgId, auditId, opts) => promptsCmd.restore(orgId, auditId, opts));
   prompts.command("push <slug-or-path>")
     .description("Apply a local JSON file's prompt_sections back to the agent it was pulled from (regenerates system_prompt server-side)")
-    .action((id) => promptsCmd.push(id));
+    .option("--dry-run", "print what would change (added / removed / changed sections against the live agent) and write nothing")
+    .action((id, opts) => promptsCmd.push(id, opts));
 
   // questionnaires
   const qs = program.command("questionnaires")
@@ -158,6 +162,13 @@ export function run(argv) {
     .option("--until <when>", "upper bound (default now)")
     .option("--json", "raw JSON")
     .action((orgId, opts) => messagesCmd.stats(orgId, opts));
+  msgs.command("delete <contact_id>")
+    .description("DELETE a contact's messages (all, older than --before, or only --sender-type). Dry run by default; --confirm asks you to type the contact id")
+    .option("--before <when>", "only rows older than this: 30d | 2w | YYYY-MM-DD | ISO time")
+    .option("--sender-type <list>", "only these sender types, e.g. tool-call,steer")
+    .option("--confirm", "actually delete (typed confirmation follows)")
+    .option("--json", "raw JSON")
+    .action((contactId, opts) => messagesCmd.remove(contactId, opts));
 
   // fine-tuning (agents.fine_tuning text + agents.fine_tuning_entries jsonb)
   const ft = program.command("fine-tuning")
@@ -428,10 +439,23 @@ export function run(argv) {
   // org (read-only org summary for the prompt-builder skill, creds stripped)
   const org = program.command("org").description("Org info (read), create a new organization, read/set its feature flags");
   org.command("list [search]")
-    .description("List organizations with their UUIDs — the lookup every other command needs (filter by name/slug)")
+    .description("List organizations with their UUIDs — the lookup every other command needs (filter by name/slug, or find by WhatsApp number)")
     .option("--all", "include inactive organizations")
+    .option("--number <digits>", "find the org by its WhatsApp number (any format), Meta phone id or WABA id")
     .option("--json", "raw JSON")
     .action((search, opts) => orgCmd.list(search, opts));
+  org.command("agent <organization_id> <on|off>")
+    .description("The agent master switch (wati_webhook_status): off = no customer gets the AI. Dry-run unless --commit; ON without test mode needs --yes")
+    .option("--commit", "write the change")
+    .option("--yes", "confirm switching ON for every customer (vert.active not false, no allowlist)")
+    .option("--json", "raw JSON")
+    .action((orgId, state, opts) => orgCmd.agentSwitch(orgId, state, opts));
+  org.command("park <organization_id>")
+    .description("Park an org (organizations.inactive = true: hidden from censuses and crons; nothing deleted). --unpark reverses it. Needs --confirm")
+    .option("--unpark", "set inactive = false")
+    .option("--confirm", "write the change")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => orgCmd.park(orgId, opts));
   org.command("create")
     .description("Create a NEW organization (org row + admin membership; owner defaults to you)")
     .requiredOption("--name <name>", "organization name")
@@ -558,6 +582,13 @@ export function run(argv) {
     .description("List the org's agents (★ = active); use an id as --agent <id> elsewhere")
     .option("--json", "print the raw JSON payload")
     .action((orgId, opts) => agentsCmd.list(orgId, opts));
+  agent.command("flags")
+    .description("Cross-org census of every active agent: model, reasoning, prompt switch, tool gates (product_lookup, tickets, postal, …)")
+    .option("--tool <flag[=bool]>", "only agents where this tool flag is on (or =false: off)")
+    .option("--model <substr>", "only agents whose model contains this")
+    .option("--all", "include inactive orgs")
+    .option("--json", "raw JSON")
+    .action((opts) => agentsCmd.flags(opts));
   agent.command("create <organization_id>")
     .description("Create a new agent (optionally seed its prompt + set it active)")
     .requiredOption("--name <name>", "agent name")
@@ -851,7 +882,8 @@ export function run(argv) {
     .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("--tools", "also print each tool's arguments and result (what the agent asked and got back)")
+    .option("--sender <name>", "the name the agent sees: renames a SYNTHETIC test contact (a real person's contact keeps their 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")
@@ -860,6 +892,7 @@ export function run(argv) {
   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("--tools", "also print each tool's arguments and result")
     .option("--no-clear-between", "do NOT clear between scenarios (one long thread)")
     .option("--force", "go ahead even though the test contact had real (non-web) messages in the last 6 h")
     .option("--sender <name>", "senderName")
@@ -1006,6 +1039,7 @@ export function run(argv) {
     .option("--all", "include fired / cancelled / failed rows too")
     .option("--status <s>", "filter to one status (pending|request|completed|cancelled|failed)")
     .option("--limit <n>", "max rows (default 25, max 200)")
+    .option("--detail", "also print each row's body / button values and header media (what the queued send will say)")
     .option("--json", "raw JSON")
     .action((orgId, opts) => broadcastCmd.scheduledList(orgId, opts));
   scheduled.command("approve <organization_id> <queue_id>")
@@ -1118,15 +1152,25 @@ export function run(argv) {
     .option("--raw-campaign", "use --campaign exactly as typed, bypassing the Date_Campaign normalisation")
     .option("--new-campaign", "confirm the tag is a NEW campaign even though a differently spelled one with the same name already runs")
     .option("--domain <host>", "short domain: chatcart.io (default) | linklnk.io | yapi.store")
+    .option("--slug <slug>", "readable code for ONE url (3-48 chars a-z 0-9 -); a taken slug falls back to a generated code and says so")
     .option("--commit", "actually mint the links (omit = dry-run preview)")
     .option("--json", "raw JSON output")
     .action((orgId, opts) => linksCmd.shorten(orgId, opts));
   links.command("list <organization_id>")
-    .description("List the org's short links, newest first")
+    .description("List the org's short links, newest first; look one up by code or by destination")
     .option("--campaign <value>", "only links carrying this exact utm_campaign")
-    .option("--limit <n>", "max rows (default 25, max 200)")
+    .option("--code <code>", "one link by its code (the part after the slash)")
+    .option("--to <substr>", "only links whose destination contains this text")
+    .option("--limit <n>", "max rows (default 25, max 500)")
+    .option("--all", "walk every page (500 a call) instead of the first")
     .option("--json", "raw JSON output")
     .action((orgId, opts) => linksCmd.list(orgId, opts));
+  links.command("repoint <organization_id> <code>")
+    .description("Move where a live short code sends people (the code, its clicks and every message carrying it stay). Dry-run unless --commit")
+    .requiredOption("--to <url>", "the new destination page")
+    .option("--commit", "write the change (audited with the old destination; undo is printed)")
+    .option("--json", "raw JSON output")
+    .action((orgId, code, opts) => linksCmd.repoint(orgId, code, opts));
 
   // tag (the Advanced Tagging dialog in the terminal — ONE named tag on a matched set; dry-run default)
   const tag = program.command("tag")
@@ -1136,11 +1180,28 @@ export function run(argv) {
     .option("--field <name>", "field to search", "order_history")
     .option("--any <csv>", "match ANY of these comma-separated keywords (OR)")
     .option("--all <csv>", "match ALL of these comma-separated keywords (AND)")
+    .option("--exact", "match the WHOLE value (whatsapp_id / phone_number / email / full_name), not a substring")
     .option("--case-sensitive", "case-sensitive match")
     .option("--tag <name>", "tag to apply (required with --commit)")
     .option("--commit", "write the tag (omit = dry-run count + sample)")
     .option("--yes", "skip the type-the-tag confirm on large (>2000) writes")
     .action((orgId, opts) => tagCmd.field(orgId, opts));
+  tag.command("ids <organization_id>")
+    .description("Apply one tag to an explicit list of contact ids (append-only, idempotent; ids outside the org are ignored)")
+    .option("--ids <csv>", "contact UUIDs, comma-separated")
+    .option("--ids-file <path>", "file of contact UUIDs (one per line or comma-separated)")
+    .option("--tag <name>", "tag to apply (required with --commit)")
+    .option("--commit", "write the tag (omit = dry-run count + sample)")
+    .option("--yes", "skip the type-the-tag confirm on large (>2000) writes")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => tagCmd.ids(orgId, opts));
+  tag.command("holders <organization_id> <tag>")
+    .description("Who carries a tag: name, number, id and the flags that keep them off a broadcast (read-only)")
+    .option("--limit <n>", "rows (default 200, max 1000)")
+    .option("--all", "walk every page")
+    .option("--csv", "CSV to stdout (id, name, number, email, allow_broadcast, archived, blocked)")
+    .option("--json", "raw JSON")
+    .action((orgId, tagName, opts) => tagCmd.holders(orgId, tagName, opts));
   tag.command("cohort <organization_id>")
     .description("Tag a ranked cohort (top-N). --type top_spenders|frequent_buyers|recent_buyers|high_value_low_frequency")
     .option("--type <t>", "cohort type", "top_spenders")
@@ -1194,10 +1255,90 @@ export function run(argv) {
     .option("--json", "raw JSON")
     .action((orgId, opts) => tagCmd.list(orgId, opts));
   tag.command("remove <organization_id> <tags>")
-    .description("Remove tag(s) (comma-separated) from ALL contacts in the org. Destructive — needs --confirm")
+    .description("Remove tag(s) (comma-separated) from ALL contacts in the org, or only from --contacts. Destructive — needs --confirm")
+    .option("--contacts <csv>", "only these contact UUIDs lose the tag(s)")
+    .option("--contacts-file <path>", "file of contact UUIDs that lose the tag(s)")
     .option("--confirm", "actually remove (omit = dry-run)")
     .action((orgId, tags, opts) => tagCmd.remove(orgId, tags, opts));
 
+  // members / users (organization_members + profiles + auth.users)
+  const members = program.command("members").description("An org's people: list, add an existing account, change a role, rename, remove");
+  members.command("list <organization_id>")
+    .description("Members with role, name, email, last sign-in; pending invitations")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => membersCmd.list(orgId, opts));
+  members.command("add <organization_id> <email>")
+    .description("Add an EXISTING account to the org (someone with no account must be invited from the app)")
+    .option("--role <role>", "admin | member | viewer", "member")
+    .option("--json", "raw JSON")
+    .action((orgId, email, opts) => membersCmd.add(orgId, email, opts));
+  members.command("role <organization_id> <email> <role>")
+    .description("Change a member's role: admin | member | viewer (the last admin cannot be demoted)")
+    .option("--json", "raw JSON")
+    .action((orgId, email, role, opts) => membersCmd.role(orgId, email, role, opts));
+  members.command("rename <email> <full_name>")
+    .description("Set the person's display name (profiles.full_name, shown in every org)")
+    .option("--json", "raw JSON")
+    .action((email, name, opts) => membersCmd.rename(email, name, opts));
+  members.command("remove <organization_id> <email>")
+    .description("Remove a member from the org (dry-run unless --confirm; the owner and the last admin are refused)")
+    .option("--confirm", "actually remove")
+    .option("--json", "raw JSON")
+    .action((orgId, email, opts) => membersCmd.remove(orgId, email, opts));
+  const users = program.command("users").description("One user across orgs");
+  users.command("lookup <email>")
+    .description("The account behind an email: sign-in method, confirmation, last sign-in, every org and role")
+    .option("--json", "raw JSON")
+    .action((email, opts) => membersCmd.lookup(email, opts));
+
+  // steer / notes (internal rows in a contact's chat)
+  const steer = program.command("steer").description("Supervisor steers for the agent on one contact: list, add, clear");
+  steer.command("list <contact_id>")
+    .description("Every steer on the contact (mode, consumed, active)")
+    .option("--limit <n>", "rows (default 50)")
+    .option("--json", "raw JSON")
+    .action((contactId, opts) => notesCmd.steerList(contactId, opts));
+  steer.command("add <contact_id> <text...>")
+    .description("Add a steer the agent applies on EVERY reply (ongoing), or --once for the next reply only")
+    .option("--once", "next reply only")
+    .option("--json", "raw JSON")
+    .action((contactId, text, opts) => notesCmd.steerAdd(contactId, text, opts));
+  steer.command("clear <contact_id>")
+    .description("Delete the contact's steers (all, or --id); the inbox has no delete for an ongoing steer. Dry-run unless --confirm")
+    .option("--id <steer_id>", "only this steer (repeatable)", (v, acc) => (acc || []).concat([v]), [])
+    .option("--confirm", "actually delete")
+    .option("--json", "raw JSON")
+    .action((contactId, opts) => notesCmd.steerClear(contactId, opts));
+  const notes = program.command("notes").description("Internal notes on a contact (the Customer panel's sticky notes)");
+  notes.command("list <contact_id>")
+    .description("Every internal note on the contact")
+    .option("--limit <n>", "rows (default 50)")
+    .option("--json", "raw JSON")
+    .action((contactId, opts) => notesCmd.notesList(contactId, opts));
+  notes.command("add <contact_id> <text...>")
+    .description("Add an internal note (team-only, never sent to the customer)")
+    .option("--json", "raw JSON")
+    .action((contactId, text, opts) => notesCmd.notesAdd(contactId, text, opts));
+
+  // products (the synced catalogue)
+  const products = program.command("products").description("The synced catalogue as the agent sees it: status, a search replay, a one-org reconcile");
+  products.command("status <organization_id>")
+    .description("Row counts by status, embeddings (missing = the agent cannot find them), images, prices, stock, the last syncs")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => productsCmd.status(orgId, opts));
+  products.command("search <organization_id> <text...>")
+    .description("Replay the agent's product_lookup match (fuzzy_match_products) for a phrase")
+    .option("--limit <n>", "matches (default 8, max 50)")
+    .option("--min-similarity <x>", "pg_trgm threshold (default 0.15)")
+    .option("--json", "raw JSON")
+    .action((orgId, text, opts) => productsCmd.search(orgId, text, opts));
+  products.command("reconcile <organization_id>")
+    .description("Trigger products-reconcile-scheduler for this org only (re-sync + re-embed). Dry-run unless --confirm")
+    .option("--platform <p>", "shopify | woo (default: the org's connected store)")
+    .option("--confirm", "actually trigger")
+    .option("--json", "raw JSON")
+    .action((orgId, opts) => productsCmd.reconcile(orgId, opts));
+
   // keywords (org auto-reply engine: keywords + keyword_actions; id-keyed diff push)
   const keywords = program.command("keywords")
     .alias("kw")