@flowapt/flowiq-cli 0.9.3 → 0.9.4

package/README.md

@@ -1713,7 +1713,7 @@ flowiq agent config <organization_id> --enable-base-tool get_product_info
 
 Settable: `settings.use_settings_prompt`, `settings.model`,
 `settings.reasoning_effort` (`--reasoning-effort low|medium|high|xhigh|max`, `""` clears it —
-pairs with reasoning models like `gpt-5.6-luna`; `max` is Claude only), agent `--rename`,
+pairs with reasoning models like `gpt-5.6-luna`; `max` is GPT-6 and Claude only), agent `--rename`,
 the tool-flag columns (`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`,
@@ -1865,6 +1865,15 @@ flowiq export chats <organization_id>                      # → ./.flowiq/expor
 flowiq export chats <organization_id> --out ./phyto-chats.txt
 ```
 
+Pages are 1,000 messages; the server resolves each page's contacts in chunks
+of 250 ids (fixed 23 Sep 2026: a page of broadcast sends can hold 700+ distinct
+contacts, and one `in.(…)` list that long was refused by the gateway, which
+surfaced as `Export failed on page N: contacts resolve failed: Bad Request`).
+A 502/503/504 on a page is retried twice (v0.9.4); any other failure names the
+page, how many messages were fetched before it, and that nothing was written,
+because the file is only opened once every page is in. Re-run it; there is no
+partial file to clean up.
+
 ### Agent testing — `flowiq test <subcommand>`
 
 Drive an org's **live** agent through the web/test channel and read the reply

package/TEAM-GUIDE.md

@@ -193,7 +193,7 @@ several.
 | See exactly what a change looked like (before → after) | `flowiq audit show <audit_id> --content` (or `--out entry.json`) |
 | Know what the log does and doesn't keep | Anything that CHANGES something is logged — including `flowiq test` (it creates the test contact and clears conversations) and `flowiq auth refresh`. Reads and dry-runs are not. The log never stores the content itself: chats, store data and agent replies are recorded as "who read what", never copied. |
 | Read a contact's chat | `flowiq m pull <contact_id>` then open the JSON. Ask for more than exists (`--count 100`) and you get the entire history — it says "that is ALL of them" when there is nothing older |
-| Export an org's full chat history | `flowiq export chats <org_id>` |
+| Export an org's full chat history | `flowiq export chats <org_id>`. If it stops mid-way it says which page failed and nothing is written, so just re-run it (a 502/503/504 page retries on its own) |
 | Check / create WhatsApp templates | `flowiq tpl pull <org_id>` / `flowiq tpl create <org_id> --request-file req.json` |
 | **Read a template you have not submitted yet (a DRAFT)** | `flowiq tpl show <org_id> <template_name>` — the ONLY way to see a draft from the terminal (`pull` reads Meta, and a draft never gets there). Renders the message as the customer will read it, every carousel card, and a **Checks** list of the things Meta would bounce it for |
 | Check a carousel before submitting it | `flowiq tpl show <org_id> <name>` and read **Checks**. It catches a card link using the wrong `{{n}}`, a missing greeting example, a bold/italic marker against a space (WhatsApp shows the literal `_`), wrong card counts and over-length text. It cannot know a card names a product you do not stock — read the card text against the shop yourself |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowapt/flowiq-cli",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "description": "Command-line tool for FlowIQ staff: round-trip agent prompts, questionnaires, fine-tuning, pin-board tasks, webhooks, templates, agent-updates, chat exports, and live agent testing without ever touching service-role credentials.",
   "type": "module",
   "bin": {

package/src/commands/export.js

@@ -31,6 +31,24 @@ function getSenderLabel(senderType) {
   return senderType;
 }
 
+// A full export is dozens of requests, and one transient 502/503/504 used to
+// throw away every page fetched before it. Those are retried twice; any other
+// failure (a 400, a 500 carrying a real message) fails at once.
+const RETRYABLE = new Set([502, 503, 504]);
+const RETRIES = 2;
+
+async function fetchPage(query, pageNo) {
+  for (let attempt = 1; ; attempt++) {
+    try {
+      return await http.get("export-chats", query);
+    } catch (e) {
+      if (!RETRYABLE.has(e.status) || attempt > RETRIES) throw e;
+      console.log(`  page ${pageNo}: ${e.message}; retrying (${attempt}/${RETRIES})`);
+      await new Promise((resolve) => setTimeout(resolve, 1500 * attempt));
+    }
+  }
+}
+
 export async function chats(orgId, opts = {}) {
   if (!UUID_RE.test(orgId)) {
     console.error(`Error: "${orgId}" is not a valid organization UUID.`);
@@ -52,9 +70,15 @@ export async function chats(orgId, opts = {}) {
     }
     let resp;
     try {
-      resp = await http.get("export-chats", query);
+      resp = await fetchPage(query, pages + 1);
     } catch (e) {
-      console.error(`Export failed on page ${pages + 1}: ${e.message}`);
+      // The file is only opened once every page is in, so a mid-run failure
+      // leaves nothing on disk; say so, and how far it got, in the one line
+      // the person will paste into a bug report.
+      console.error(
+        `Export failed on page ${pages + 1} (${messages.length.toLocaleString("en-US")} messages fetched in ` +
+        `${pages} page${pages === 1 ? "" : "s"} before it; nothing written): ${e.message}`,
+      );
       process.exit(1);
     }
     if (resp.organization_name != null) organizationName = resp.organization_name;

package/src/index.js

@@ -493,7 +493,7 @@ export function run(argv) {
     .option("--agent <id>", "target a specific agent instead of the org's active one")
     .option("--use-settings-prompt [bool]", "settings.use_settings_prompt (true if bare)")
     .option("--model <model>", "settings.model (e.g. gpt-5.4-mini)")
-    .option("--reasoning-effort <level>", "settings.reasoning_effort — low|medium|high|xhigh|max (\"\" clears it; max = Claude only); pairs with reasoning models (e.g. gpt-5.6-luna + high, claude-sonnet-5 + medium)")
+    .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-5.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("--discount [bool]", "agent.discount.enabled (true if bare)")