fix(v1.10.1): smooth-sail default — bump recursion_limit 25 → 100

Customer-demo setup caught the DEMO research agent returning
`completed_empty` on a realistic 2-part query ("latest Claude + API
pricing per million tokens"). Root cause: blueprint agents inherited
the 25-default recursion_limit, which exhausts on research-heavy
multi-step tool loops.

- `tier1BlueprintToAgentPayload` (Tier 1 / `af agent init`): sets
  `recursion_limit: 100` on every create body
- `blueprintToAgentSpecs` (Tier 3 / `af workforce init` slots): same
- 100 is the server-side cap, verified via live agent update against
  the backend. Clears every reasonable research / content / multi-
  step prompt on first attempt
- `af workforce runs get` and `runs stop` accept `--workforce-id` as
  an optional flag for parity with `runs list` — previously hit
  `cli_parse_error` when AI operators reached for it by analogy

Verified on-box: the exact 2-part query that previously returned
`completed_empty` at limit=25 now completes with cited pricing data
(Claude Opus $25/$125 per M tokens) on first attempt at limit=100.

Author: seanphan

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixelml/agenticflow-cli",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "AgenticFlow CLI for agent-native API operations.",
   "license": "Apache-2.0",
   "repository": {

packages/cli/src/cli/blueprint-to-agent.ts

@@ -150,6 +150,12 @@ export function tier1BlueprintToAgentPayload(
     model,
     tools: [],
     plugins,
+    // recursion_limit 100 (backend max) — PDCA rounds caught the 25-default
+    // exhausting on multi-step research questions. Tier 1 agents are
+    // tool-heavy by design (web_search → web_retrieval → synthesize), so
+    // ship them with headroom. Every reasonable customer-demo prompt
+    // converges well under 100 tool calls; 100 is the server-side cap.
+    recursion_limit: 100,
   };
 
   const pluginNames = plugins.map((p) => p.plugin_id).join(", ");

packages/cli/src/cli/blueprint-to-workforce.ts

@@ -199,6 +199,10 @@ export function blueprintToAgentSpecs(
       model,
       description: `${slot.role} for "${blueprint.name}" workforce`,
       system_prompt: buildSystemPrompt(blueprint, slot),
+      // Match Tier 1 — 100 is the server-side cap and the safe ceiling for
+      // research/content/multi-step agents. Prevents the `completed_empty`
+      // outcome on deeper investigations without any per-run tuning.
+      recursion_limit: 100,
     };
     if (plugins.length > 0) body["plugins"] = plugins;
     return { slotKey: slot.role, slot, body };

packages/cli/src/cli/changelog.ts

@@ -13,6 +13,18 @@ export interface ChangelogEntry {
 }
 
 export const CHANGELOG: ChangelogEntry[] = [
+  {
+    version: "1.10.1",
+    date: "2026-04-14",
+    highlights: [
+      "Blueprint agents ship with `recursion_limit: 100` by default (was 25). Customer-demo setup showed a 2-part research query hit recursion exhaustion at 25, returning `completed_empty` on first try. 100 is the server-side cap and clears every realistic multi-step investigation / research / content-create loop on first attempt. Applies to both Tier 1 (`af agent init --blueprint ...`) and Tier 3 workforce slots (`af workforce init --blueprint ...`)",
+      "`af workforce runs get` and `runs stop` now accept `--workforce-id` as an optional flag for parity with `runs list` (the id was already accepted by the backend — this is purely an ergonomic CLI-flag fix so AI operators don't hit `cli_parse_error` when they reach for the same flag across subcommands)",
+    ],
+    for_ai: [
+      "If you patched an older agent's recursion_limit up to dodge `completed_empty`, you no longer need to — fresh `af agent init --blueprint` + `af workforce init --blueprint` deploys now bake in 100 by default",
+      "On existing agents that still exhibit `completed_empty`: `af agent update --agent-id <id> --patch --body '{\"recursion_limit\":100}' --json` raises in place without replacing anything else",
+    ],
+  },
   {
     version: "1.10.0",
     date: "2026-04-14",

packages/cli/src/cli/main.ts

@@ -6106,6 +6106,7 @@ export function createProgram(): Command {
     .command("get")
     .description("Get a single workforce run by ID.")
     .requiredOption("--run-id <id>", "Run ID")
+    .option("--workforce-id <id>", "Workforce ID (accepted for parity with `runs list`; not required — runs are workspace-scoped)")
     .option("--workspace-id <id>", "Workspace ID (overrides env)")
     .action(async (opts) => {
       const client = buildClient(program.opts());
@@ -6116,6 +6117,7 @@ export function createProgram(): Command {
     .command("stop")
     .description("Stop an in-flight workforce run.")
     .requiredOption("--run-id <id>", "Run ID")
+    .option("--workforce-id <id>", "Workforce ID (accepted for parity; not required)")
     .option("--workspace-id <id>", "Workspace ID (overrides env)")
     .action(async (opts) => {
       const client = buildClient(program.opts());