@flowapt/flowiq-cli 0.9.4 → 0.9.6

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
@@ -1845,9 +1845,13 @@ flowiq plans status <plan_id> --to sent --commit
   timestamps instead of the send date (SAST day start) — "what did a client
   submit today", "what has moved since Friday", which `--since` cannot answer.
 - **`show`** prints the plan the way the dialog does: message copy, the
-  second message sent when a button is tapped, buttons with their URLs, the
-  creative (file name + link), audience, template link, the response to the
-  client, internal notes and the notes thread.
+  second message sent when a button is tapped (named by the button's text),
+  buttons with their targets, the creative (file name + link), audience,
+  template link, the response to the client, internal notes and the notes
+  thread. A marketing plan carries 0-10 buttons in any mix WhatsApp allows:
+  `quick_reply`, `url` (up to 2, `→ link`), `phone` (1, `→ call +27…`) and
+  `copy_code` (1, `→ code SPRING20`); each quick reply may have its own
+  follow-up message (`slide2a`, `slide2b`, `slide2c` … by button position).
 - **`status`** is a dry run until `--commit`. `--comment` is the response the
   **client reads**; `--internal` is staff-only. `approved` and `rejected`
   record you as the reviewer; `rejected` requires `--comment`. Every commit is
@@ -1894,6 +1898,12 @@ flowiq test cleanup <organization_id> --confirm      # delete the stress contact
 `--agent <id>` targets a specific (non-active) agent. `test stress cleanup` is
 destructive and requires `--confirm`.
 
+`test clear` (and `--clear` on `send`, and the clear between scenario turns) hides the
+messages (`memory_cutoff`) AND sets aside the agent's remembered tool results
+(`more_data.tool_usage_history`, which the agent reads as TOOL USAGE HISTORY) under
+`more_data.tool_usage_history_cleared`, so a cleared test really starts fresh. Since 0.9.6;
+before that earlier tool results and escalation reasons leaked into "cleared" tests.
+
 ### Guide — `flowiq guide`
 
 Read the bundled docs in the terminal — no digging through node_modules.

package/TEAM-GUIDE.md

@@ -107,15 +107,16 @@ 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 |
 | Agent can't quote ANY price / "I can't pull the live menu" | `flowiq agent config <org_id> --tool product_lookup=true` — name-based fuzzy lookup that works without embeddings or a live OpenAI key (semantic `get_product_info` needs both) |
 | Client wants leads/requests emailed to their team instead of a human escalation | `flowiq agent config <org_id> --tool email_request_tool=true`, then set the recipient list in Agents → Tool Library → Email Request to Team (no CLI path for the addresses yet) |
 | Talk to the live agent safely (no real WhatsApp ever sent) | `flowiq test send <org_id> "hi, do you sell X?"` |
+| Start a test chat from scratch (agent forgets the earlier test messages AND its earlier tool results) | `flowiq test clear <org_id>` (or `flowiq test send <org_id> "…" --clear`) |
 | **Tell the team what shipped** (the FlowIQ team update email) | `flowiq updates draft` → enrich the JSON (screenshots via `flowiq updates asset`, a *For the team* note per headline) → `flowiq updates preview <file> --open` → `flowiq updates send <file> --test` → `flowiq updates send <file> --yes` |
 | Can I use `flowiq updates`? | Yes: `status`, `uncovered`, `draft`, `preview` and `send --test` (a copy to yourself) work for everyone. Only the real `send --yes` to the whole team is Matt's; anyone else gets a 403 there |
 | Which changelog rows has nobody emailed the team about yet? | `flowiq updates status` / `flowiq updates uncovered` — anything left 20h+ goes out automatically at 08:30 SAST as a plain digest |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowapt/flowiq-cli",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "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/agent-test.js

@@ -146,7 +146,8 @@ export async function clear(orgId, opts = {}) {
   let resp;
   try { resp = await clearConv(orgId, opts.agent); }
   catch (e) { console.error(`Clear failed: ${e.message}`); process.exit(1); }
-  console.log(`Cleared web conversation for contact ${resp.contact_id} (history hidden via memory_cutoff; onboarding/disclaimer state NOT reset).`);
+  const tools = Number(resp.tools_cleared || 0);
+  console.log(`Cleared web conversation for contact ${resp.contact_id} (history hidden via memory_cutoff; ${tools} remembered tool result(s) set aside in more_data.tool_usage_history_cleared; onboarding/disclaimer state NOT reset).`);
 }
 
 // ---------- phase 2: stress + extract ----------

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

@@ -182,7 +182,9 @@ export async function show(planId, opts = {}) {
   if (more.slides && typeof more.slides === "object") {
     for (const [key, slide] of Object.entries(more.slides)) {
       if (!slide || typeof slide !== "object") continue;
-      console.log(`\n${key}${slide.triggered_by ? ` (after ${slide.triggered_by})` : ""}`);
+      const idx = /^button_(\d+)$/.exec(slide.triggered_by ?? "")?.[1];
+      const tapped = idx !== undefined && Array.isArray(more.buttons) ? more.buttons[Number(idx)]?.text : null;
+      console.log(`\n${key}${tapped ? ` (sent when "${tapped}" is tapped)` : slide.triggered_by ? ` (after ${slide.triggered_by})` : ""}`);
       if (slide.message) console.log(indent(slide.message));
       if (slide.media_url) console.log(`  media: ${slide.media_url}`);
     }
@@ -191,7 +193,11 @@ export async function show(planId, opts = {}) {
   const buttons = Array.isArray(more.buttons) ? more.buttons : [];
   if (buttons.length) {
     console.log("\nButtons");
-    for (const b of buttons) console.log(`  [${b?.type ?? "?"}] ${b?.text ?? ""}${b?.url ? ` → ${b.url}` : ""}`);
+    // Marketing plans carry 0-10 buttons: quick_reply, url, phone, copy_code (app src/lib/broadcastPlanButtons.ts).
+    for (const b of buttons) {
+      const target = b?.url ? ` → ${b.url}` : b?.phone_number ? ` → call ${b.phone_number}` : b?.code ? ` → code ${b.code}` : "";
+      console.log(`  [${b?.type ?? "?"}] ${b?.text ?? ""}${target}`);
+    }
   }
 
   console.log("\nCreative");

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 = 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("--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)")