@flowapt/flowiq-cli 0.9.7 → 0.9.8

package/src/index.js

@@ -96,6 +96,7 @@ export function run(argv) {
   prompts.command("pull <organization_id>")
     .description("Fetch an agent's prompt_sections into a local JSON file (default: active agent)")
     .option("--agent <id>", "target a specific agent instead of the org's active one")
+    .option("--out <file>", "write the JSON here instead of .flowiq/prompts/<slug>.json")
     .action((orgId, opts) => promptsCmd.pull(orgId, opts));
   prompts.command("history <organization_id>")
     .description("Every recorded prompt push (who / when / size) — the version list for `restore`")
@@ -381,8 +382,10 @@ export function run(argv) {
     .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")
+    .description("Template status: FlowIQ's record by default, or straight from Meta with --live (incl. rejection reasons)")
     .option("--name <substr>", "filter by template name substring")
+    .option("--live", "read Meta directly (one cheap call with --name; no snapshot file written)")
+    .option("--watch", "with --live: re-check every 15 s until every match is decided (max 15 min)")
     .action((orgId, opts) => templatesCmd.status(orgId, opts));
   templates.command("show <organization_id> <name>")
     .description("Render ONE template row in full — including a DRAFT, which `pull` cannot see (drafts never reach Meta)")
@@ -514,12 +517,27 @@ export function run(argv) {
     .option("--model <model>", "settings.model (e.g. gpt-6-luna, the house default)")
     .option("--reasoning-effort <level>", "settings.reasoning_effort — low|medium|high|xhigh|max (\"\" clears it; max = GPT-6 and Claude only); pairs with reasoning models (e.g. gpt-6-luna + high, gpt-6-luna + high, claude-sonnet-5 + medium)")
     .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/ticket_tool_status/product_lookup/email_request_tool/collapse_product_variants", agentConfigCmd.collectTool, [])
+    .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/ticket_tool_status/product_lookup/email_request_tool/collapse_product_variants/silent_option", agentConfigCmd.collectTool, [])
     .option("--discount [bool]", "agent.discount.enabled (true if bare)")
     .option("--test-contact-number <number>", "settings.test_contact_number — the contact `flowiq test` uses (use a FAKE number; \"\" clears it → synthetic fallback)")
     .option("--test-contact-name <name>", "settings.test_contact_name — display name for the test contact (\"\" clears it)")
     .option("--disable-base-tool <name>", "hide a disableable built-in tool from this agent (repeatable)", agentConfigCmd.collectToolName, [])
     .option("--enable-base-tool <name>", "restore a previously disabled built-in tool (repeatable)", agentConfigCmd.collectToolName, [])
+    .option("--tool-instruction <tool=text>", "settings.tool_instructions: text APPENDED to that tool's description (repeatable; text or @file; \"tool=\" removes it)", agentConfigCmd.collectTool, [])
+    .option("--shorten-links <channel=on|off|default>", "per-channel link shortening (repeatable): whatsapp/web/messenger/instagram/tiktok/email/call; default = on for whatsapp only", agentConfigCmd.collectTool, [])
+    .option("--email-from-name <name>", "settings.email_from_name: the From display name on agent emails (\"\" clears)")
+    .option("--email-signature-name <name>", "settings.email_signature_name: name printed in the email signature (\"\" clears → agent name)")
+    .option("--email-signature-title <title>", "settings.email_signature_title: title line under the signature name (\"\" clears)")
+    .option("--email-request-to <addresses>", "settings.email_request.to: comma-separated recipients for email_request_to_team (\"\" clears)")
+    .option("--email-request-subject-prefix <text>", "settings.email_request.subject_prefix (\"\" clears)")
+    .option("--send-success-rule <when=text>", "send_message_success_instructions rule, one per condition: media/image/video/document/audio/text/always (repeatable; text or @file; \"when=\" removes it)", agentConfigCmd.collectTool, [])
+    .option("--send-success [bool]", "send_message_success_instructions.enabled (true if bare)")
+    .option("--after-escalation <text>", "human_notify.success_instructions: the NEXT STEP appended to the handover tool's reply (text or @file; \"\" clears)")
+    .option("--knowledge <pairs>", "knowledge_config: enabled=true,match_count=8,min_similarity=0.3 (\"default\" clears a key)")
+    .option("--human-notify <json>", "merge keys into human_notify (JSON or @file.json; null deletes a key; unknown keys refused)")
+    .option("--order-notify <json>", "merge keys into order_notify (JSON or @file.json; null deletes a key; unknown keys refused)")
+    .option("--full", "show long values in full (show mode and the before/after diff)")
+    .option("--json", "show mode: print the raw response as JSON")
     .action((orgId, opts) => agentConfigCmd.config(orgId, opts));
 
   // agent-updates (pending client change-requests + chat context; pull + resolve)
@@ -563,11 +581,11 @@ export function run(argv) {
     .description("List local agent-updates snapshots")
     .action(() => agentUpdatesCmd.list());
   au.command("resolve <update_id>")
-    .description("Flip a client-raised ticket to resolved/declined + write the client-facing note (the client reads \"FlowIQ: <note>\")")
+    .description("Flip a client-raised ticket to resolved/declined (or back to in_progress) + write the client-facing note (the client reads \"FlowIQ: <note>\")")
     .option("--note <text>", "client-facing note (required when resolving)")
     .option("--internal <text>", "staff-only note (never shown to the client)")
     .option("--image <url>", "client-facing response image URL")
-    .option("--status <status>", "resolved (default) | declined", "resolved")
+    .option("--status <status>", "resolved (default) | declined | in_progress (open, fix not yet proven; note optional)", "resolved")
     .option("--yes", "skip the interactive confirm gate (the --note requirement still applies)")
     .action((updateId, opts) => agentUpdatesCmd.resolve(updateId, opts));
 
@@ -662,9 +680,10 @@ export function run(argv) {
     .option("--agent <id>", "scope to one agent")
     .option("--target <id>", "scope to one target (task id, tool name, tag, broadcast id)")
     .option("--user <substr>", "filter by staff email (substring)")
-    .option("--since <date>", "YYYY-MM-DD or ISO")
-    .option("--until <date>", "YYYY-MM-DD or ISO")
-    .option("--limit <n>", "max entries (default 50, max 200)")
+    .option("--since <when>", "YYYY-MM-DD (SAST day start), ISO, or a window: 14d / 12h / 2w")
+    .option("--until <when>", "YYYY-MM-DD, ISO, or a window: 14d / 12h / 2w")
+    .option("--before <created_at>", "page back: only entries older than this (the listing prints the value to use)")
+    .option("--limit <n>", "max entries (default 50, max 200; above 200 is clamped and the total is shown)")
     .option("--json", "raw JSON")
     .action((orgId, opts) => auditCmd.list(orgId, opts));
   audit.command("show <audit_id>")
@@ -695,11 +714,13 @@ export function run(argv) {
     .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")
+    .option("--force", "go ahead even though the test contact had real (non-web) messages in the last 6 h")
     .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("--force", "go ahead even though the test contact had real (non-web) messages in the last 6 h")
     .option("--sender <name>", "senderName")
     .option("--timeout <ms>", "per-turn HTTP timeout (default 120000)")
     .option("--json", "print raw JSON results")
@@ -708,6 +729,7 @@ export function run(argv) {
     .description("Run the bundled generic smoke pack")
     .option("--agent <id>", "test a specific agent")
     .option("--no-clear-between", "do NOT clear between scenarios")
+    .option("--force", "go ahead even though the test contact had real (non-web) messages in the last 6 h")
     .option("--sender <name>", "senderName")
     .option("--timeout <ms>", "per-turn HTTP timeout")
     .option("--json", "print raw JSON results")
@@ -715,6 +737,7 @@ export function run(argv) {
   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")
+    .option("--force", "go ahead even though the test contact had real (non-web) messages in the last 6 h")
     .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)")
@@ -870,10 +893,11 @@ export function run(argv) {
     .option("--limit <n>", "how many to show (default 25, max 200)")
     .option("--template <substr>", "filter: template_name contains this (case-insensitive)")
     .option("--since <date>", "filter: created on/after this date, e.g. 2026-07-01")
+    .option("--min-recipients <n>", "filter: only sends to at least N recipients (2 hides welcomes and cart reminders)")
     .option("--json", "raw JSON")
     .action((orgId, opts) => broadcastCmd.listRemote(orgId, opts));
   broadcast.command("status <organization_id> <broadcast_id>")
-    .description("Live delivery counts (read/delivered/sent/failed) for a broadcast by its broadcastId — e.g. from a --python fire-and-forget send")
+    .description("Live delivery counts (read/delivered/sent/failed) for a broadcast by its broadcastId, plus what it sent (slot values, button code and the link's destination)")
     .option("--failures", "also list each FAILED recipient + the Meta error reason (makes a python send auditable)")
     .option("--limit <n>", "with --failures: how many failed rows to print", "40")
     .option("--json", "raw JSON")
@@ -951,6 +975,7 @@ export function run(argv) {
     .option("--content <value>", "utm_content, the per-link tag (e.g. ViewMore); defaults to the campaign")
     .option("--date <value>", "send date for the campaign tag when it is not today: 9Sep | 2026-09-24 | 24/9/2026")
     .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("--commit", "actually mint the links (omit = dry-run preview)")
     .option("--json", "raw JSON output")