@flowapt/flowiq-cli 0.9.3 → 0.9.5

package/README.md

@@ -1607,7 +1607,7 @@ flowiq agent create <new_org_id> --name "Zara" --make-active
 flowiq prompts pull <new_org_id>   # edit → push
 ```
 (No `agent config` step any more — since 29 Aug 2026 a new agent is born on the
-house default: `gpt-5.6-luna`, `reasoning_effort high`, `use_settings_prompt` ON.)
+house default: `gpt-6-luna` (since 23 Sep 2026; was `gpt-5.6-luna`), `reasoning_effort high`, `use_settings_prompt` ON.)
 
 #### Feature flags — `flowiq org flags show|list|set|unset|keys` (v0.7.0)
 
@@ -1666,7 +1666,7 @@ flowiq agent create <organization_id> --name "Zara" \
 seeds its prompt into a single "Main" section, and — with `--make-active` — sets
 it as the org's `active_whatsapp_agent`.
 
-**Since 29 Aug 2026 a new agent is born configured** — `gpt-5.6-luna`,
+**Since 29 Aug 2026 a new agent is born configured** — `gpt-6-luna` (since 23 Sep 2026; was `gpt-5.6-luna`),
 `reasoning_effort high`, `use_settings_prompt` ON — the same house default the
 web UI's create button writes. You no longer have to follow `create` with an
 `agent config --model … --use-settings-prompt`; that step used to be the "silent
@@ -1684,7 +1684,7 @@ on the org's **active** agent. To target a **different** agent, pass `--agent <i
 ```bash
 flowiq prompts pull <org> --agent <agent_id>      # pull a NON-active agent's prompt
 flowiq prompts push <slug>                          # pushes back to that same agent (id is in the file)
-flowiq agent config <org> --agent <agent_id> --model gpt-5.6-luna
+flowiq agent config <org> --agent <agent_id> --model gpt-6-luna
 ```
 
 `pull` records the agent id in the JSON, so `push` always writes back to the exact
@@ -1702,10 +1702,10 @@ Set an allowlisted set of the active agent's config fields (the prompt-builder
 
 ```bash
 flowiq agent config <organization_id>                        # show current
-flowiq agent config <organization_id> --use-settings-prompt --model gpt-5.6-luna \
+flowiq agent config <organization_id> --use-settings-prompt --model gpt-6-luna \
   --rename Zara --tool woo_order_build=true --tool view_cart_tool=true --discount true
 flowiq agent config <organization_id> --test-contact-number 27000000001 --test-contact-name "QA Bot"
-flowiq agent config <organization_id> --model gpt-5.6-luna --reasoning-effort high
+flowiq agent config <organization_id> --model gpt-6-luna --reasoning-effort high   # the house pairing (23 Sep 2026)
 flowiq agent config <organization_id> --model claude-sonnet-5 --reasoning-effort medium   # Claude (needs the org's Claude key; warns if missing)
 flowiq agent config <organization_id> --disable-base-tool get_product_info
 flowiq agent config <organization_id> --enable-base-tool get_product_info
@@ -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

@@ -107,9 +107,9 @@ When you see it, run `npm i -g @flowapt/flowiq-cli` — a stale version also mea
 | Ask a client's WooCommerce store anything (read-only) | `flowiq woo get <org_id> orders --q status=completed --all` |
 | Pull every matching record, not just the first page | add `--all` (bounded — it prints `⚠ TRUNCATED` if it stops early, so a partial answer never looks complete) |
 | Feed store data into jq / a file | stdout is the payload only, banner goes to stderr: `flowiq shopify get <org> orders.json \| jq -r '.orders[].name'` · or `--out ./orders.json` |
-| See an org's agents / create one | `flowiq agent list <org_id>` / `flowiq agent create <org_id> --name "…"` — a new agent arrives ready to work (gpt-5.6-luna, high reasoning, prompt switched ON); no follow-up `agent config` needed |
+| See an org's agents / create one | `flowiq agent list <org_id>` / `flowiq agent create <org_id> --name "…"` — a new agent arrives ready to work (gpt-6-luna, high reasoning, prompt switched ON); no follow-up `agent config` needed |
 | Change agent model / tool flags | `flowiq agent config <org_id> --model … --tool view_cart_tool=true` |
-| Set the house model + reasoning tier | `flowiq agent config <org_id> --model gpt-5.6-luna --reasoning-effort high` |
+| Set the house model + reasoning tier | `flowiq agent config <org_id> --model gpt-6-luna --reasoning-effort high` |
 | Run the agent on Claude (org needs a Claude key in Settings → Integrations) | `flowiq agent config <org_id> --model claude-sonnet-5 --reasoning-effort medium` |
 | Remove a conflicting built-in tool from one agent | `flowiq agent config <org_id> --disable-base-tool get_product_info` (repeatable; safety/delivery tools cannot be disabled) |
 | Agent says an in-stock product "isn't showing" | `flowiq agent config <org_id> --tool collapse_product_variants=true` — the search cap counts VARIANT rows until this is on |
@@ -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.5",
   "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/agents.js

@@ -71,6 +71,9 @@ export async function create(orgId, opts = {}) {
   console.log(`  active:        ${resp.is_active ? "yes (set as the org's active agent)" : "no"}`);
   console.log(`  seeded prompt: ${resp.seeded_prompt ? "yes (single \"Main\" section)" : "no (default settings)"}`);
   if (resp.warning) console.log(`  ⚠ ${resp.warning}`);
-  console.log("\nNext: `agent config " + orgId + " --agent " + resp.agent_id + " --use-settings-prompt --model gpt-5.4-mini`");
-  console.log("      then `prompts pull " + orgId + " --agent " + resp.agent_id + "` to author the full prompt.");
+  // The agent is born on the house default (the server's DEFAULT_SETTINGS), so no
+  // `agent config` step is needed; the old hint told people to set gpt-5.4-mini,
+  // which DOWNGRADED a new agent (fixed 23 Sep 2026).
+  console.log("\nNext: `prompts pull " + orgId + " --agent " + resp.agent_id + "` to author the full prompt.");
+  console.log("      (No `agent config` needed: it is born on the house model, high reasoning, prompt switched on.)");
 }

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/commands/org.js

@@ -95,6 +95,5 @@ export async function create(opts = {}) {
   console.log("");
   console.log("Next steps:");
   console.log(`  flowiq agent create ${resp.id} --name "<AgentName>" --make-active`);
-  console.log(`  flowiq agent config ${resp.id} --model gpt-5.4-mini --use-settings-prompt`);
   console.log(`  flowiq prompts pull ${resp.id}   # then edit + push`);
 }

package/src/index.js

@@ -492,8 +492,8 @@ export function run(argv) {
     .description("Set allowlisted agent config (no write flags = show current; defaults to the active agent)")
     .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("--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("--discount [bool]", "agent.discount.enabled (true if bare)")