@pixelml/agenticflow-cli 1.5.3 → 1.6.1

package/dist/cli/blueprint-to-workforce.d.ts

@@ -1,30 +1,24 @@
 /**
- * Pure translator: CompanyBlueprint → MAS workforce graph (skeleton).
- *
- * Converts a Paperclip-era blueprint (agent role slots + starter tasks) into
- * a MINIMAL VALID AgenticFlow workforce graph that the user can then fill in
- * with real agents via the UI or follow-up CLI commands.
- *
- * Why a skeleton, not a full agent graph:
- *   MAS `agent` nodes require a real `agent_id` (verified 400 on live attempt
- *   2026-04-14). The CLI cannot synthesize agents during init without either
- *   creating real agent entities (heavyweight: N API calls, model/prompt picks)
- *   or matching against marketplace templates (requires a search flow).
- *   A skeleton avoids the chicken-and-egg: deploy succeeds, user knows exactly
- *   what to wire next.
- *
- * What the skeleton contains:
- *   - One `trigger` node carrying the full blueprint metadata (slots, tasks,
- *     goal) so downstream tooling can materialize agents later.
- *   - One `output` node that echoes the message from the triggering run.
- *   - A `next_step` edge from trigger → output.
- *
- * What callers of this translator should then do:
- *   1. POST the workforce (metadata only).
- *   2. PUT the skeleton schema from this translator.
- *   3. Surface `next_steps` in the response telling the user:
- *      "Open the UI, add one Agent node per slot in trigger.input.planned_agents,
- *       connect them from the trigger, and publish."
+ * CompanyBlueprint → MAS workforce deploy.
+ *
+ * Two modes:
+ *
+ *   1. SKELETON (original, `blueprintToWorkforce`)
+ *      Produces a minimal trigger+output graph with blueprint metadata on the
+ *      trigger. User fills in agent nodes afterwards. Fast, no agent creation,
+ *      safe for --dry-run.
+ *
+ *   2. FULL DEPLOY (new, `blueprintToAgentSpecs` + `buildAgentWiredGraph`)
+ *      Produces agent-create specs AND a graph stub parameterised by
+ *      {slotRole → agentId}. Caller creates the agents, then feeds the map
+ *      into `buildAgentWiredGraph` to produce a fully-wired graph ready for
+ *      PUT /schema.
+ *
+ * The two-phase design exists because MAS `agent` nodes require a real
+ * `agent_id` (the backend 400s otherwise), so we can't one-shot the graph
+ * without first materialising agents. Splitting keeps the pure translator
+ * pure and leaves the side-effectful agent-creation to the CLI command which
+ * can handle error-rollback.
  */
 import type { CompanyBlueprint, AgentSlot } from "./company-blueprints.js";
 import type { WorkforceSchema } from "@pixelml/agenticflow-sdk";
@@ -48,4 +42,53 @@ export declare function blueprintToWorkforce(blueprint: CompanyBlueprint, option
     name?: string;
     description?: string;
 }): BlueprintTranslation;
+/**
+ * Create-payload specification for one agent slot.
+ * Caller passes each to `client.agents.create()`, then maps the returned
+ * agent ids back into `buildAgentWiredGraph()`.
+ */
+export interface AgentSpec {
+    /** Stable slot identifier (= slot.role) used as the map key. */
+    slotKey: string;
+    /** The body to POST to /v1/agents/. Includes project_id, name, tools, etc. */
+    body: Record<string, unknown>;
+    /** Reference to the source slot, for graph wiring + failure reporting. */
+    slot: AgentSlot;
+}
+/**
+ * Build N agent-create payloads from a blueprint. Each agent:
+ *   - `name` prefixed with workforce name for identification
+ *   - `system_prompt` derived from slot.title + slot.description + blueprint goal
+ *   - `model` defaulted (overridable via options.model)
+ *   - `tools: []` (user attaches MCPs/tools afterwards)
+ *
+ * `project_id` is REQUIRED — caller supplies from `af bootstrap > auth.project_id`.
+ */
+export declare function blueprintToAgentSpecs(blueprint: CompanyBlueprint, options: {
+    projectId: string;
+    workforceName: string;
+    model?: string;
+    includeOptionalSlots?: boolean;
+}): AgentSpec[];
+/**
+ * Build a full workforce graph that references real agent_ids.
+ *
+ * Shape:
+ *   trigger ──► coordinator_agent ──► worker_agent_1
+ *                                  ├─► worker_agent_2
+ *                                  ├─► worker_agent_3
+ *                                  └─► output (from coordinator)
+ *
+ * The first non-optional slot (typically "ceo") becomes the coordinator.
+ * Coordinator receives the trigger event, and all other agents receive
+ * their handoff from the coordinator. `output` listens on the coordinator.
+ *
+ * `agentIdBySlot` MUST contain an id for every slot in `specs` — callers
+ * produce this map by creating agents and pairing the returned ids back
+ * with `spec.slotKey`.
+ */
+export declare function buildAgentWiredGraph(blueprint: CompanyBlueprint, specs: AgentSpec[], agentIdBySlot: Record<string, string>): {
+    nodes: WorkforceSchema["nodes"][number][];
+    edges: WorkforceSchema["edges"][number][];
+};
 //# sourceMappingURL=blueprint-to-workforce.d.ts.map

package/dist/cli/blueprint-to-workforce.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blueprint-to-workforce.d.ts","sourceRoot":"","sources":["../../src/cli/blueprint-to-workforce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,sBAAsB,CAAC;IAClC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAC1C,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAC1C,+EAA+E;IAC/E,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,gBAAgB,EAC3B,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,oBAAoB,CAuEtB"}
+{"version":3,"file":"blueprint-to-workforce.d.ts","sourceRoot":"","sources":["../../src/cli/blueprint-to-workforce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,sBAAsB,CAAC;IAClC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAC1C,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAC1C,+EAA+E;IAC/E,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,gBAAgB,EAC3B,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,oBAAoB,CAuEtB;AAMD;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,0EAA0E;IAC1E,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE;IACP,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GACA,SAAS,EAAE,CAiBb;AAuBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,SAAS,EAAE,EAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC;IAAE,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAA;CAAE,CAgF1F"}

package/dist/cli/blueprint-to-workforce.js

@@ -1,30 +1,24 @@
 /**
- * Pure translator: CompanyBlueprint → MAS workforce graph (skeleton).
+ * CompanyBlueprint → MAS workforce deploy.
  *
- * Converts a Paperclip-era blueprint (agent role slots + starter tasks) into
- * a MINIMAL VALID AgenticFlow workforce graph that the user can then fill in
- * with real agents via the UI or follow-up CLI commands.
+ * Two modes:
  *
- * Why a skeleton, not a full agent graph:
- *   MAS `agent` nodes require a real `agent_id` (verified 400 on live attempt
- *   2026-04-14). The CLI cannot synthesize agents during init without either
- *   creating real agent entities (heavyweight: N API calls, model/prompt picks)
- *   or matching against marketplace templates (requires a search flow).
- *   A skeleton avoids the chicken-and-egg: deploy succeeds, user knows exactly
- *   what to wire next.
+ *   1. SKELETON (original, `blueprintToWorkforce`)
+ *      Produces a minimal trigger+output graph with blueprint metadata on the
+ *      trigger. User fills in agent nodes afterwards. Fast, no agent creation,
+ *      safe for --dry-run.
  *
- * What the skeleton contains:
- *   - One `trigger` node carrying the full blueprint metadata (slots, tasks,
- *     goal) so downstream tooling can materialize agents later.
- *   - One `output` node that echoes the message from the triggering run.
- *   - A `next_step` edge from trigger → output.
+ *   2. FULL DEPLOY (new, `blueprintToAgentSpecs` + `buildAgentWiredGraph`)
+ *      Produces agent-create specs AND a graph stub parameterised by
+ *      {slotRole → agentId}. Caller creates the agents, then feeds the map
+ *      into `buildAgentWiredGraph` to produce a fully-wired graph ready for
+ *      PUT /schema.
  *
- * What callers of this translator should then do:
- *   1. POST the workforce (metadata only).
- *   2. PUT the skeleton schema from this translator.
- *   3. Surface `next_steps` in the response telling the user:
- *      "Open the UI, add one Agent node per slot in trigger.input.planned_agents,
- *       connect them from the trigger, and publish."
+ * The two-phase design exists because MAS `agent` nodes require a real
+ * `agent_id` (the backend 400s otherwise), so we can't one-shot the graph
+ * without first materialising agents. Splitting keeps the pure translator
+ * pure and leaves the side-effectful agent-creation to the CLI command which
+ * can handle error-rollback.
  */
 /** Stable, URL-safe node name for an AgentSlot. */
 export function slotToNodeName(slot) {
@@ -94,4 +88,143 @@ export function blueprintToWorkforce(blueprint, options = {}) {
         suggested_next_steps,
     };
 }
+/**
+ * Build N agent-create payloads from a blueprint. Each agent:
+ *   - `name` prefixed with workforce name for identification
+ *   - `system_prompt` derived from slot.title + slot.description + blueprint goal
+ *   - `model` defaulted (overridable via options.model)
+ *   - `tools: []` (user attaches MCPs/tools afterwards)
+ *
+ * `project_id` is REQUIRED — caller supplies from `af bootstrap > auth.project_id`.
+ */
+export function blueprintToAgentSpecs(blueprint, options) {
+    const model = options.model ?? "agenticflow/gemini-2.0-flash";
+    const slots = options.includeOptionalSlots
+        ? blueprint.agents
+        : blueprint.agents.filter((s) => !s.optional);
+    return slots.map((slot) => ({
+        slotKey: slot.role,
+        slot,
+        body: {
+            name: `${options.workforceName} — ${slot.title}`,
+            project_id: options.projectId,
+            tools: [],
+            model,
+            description: `${slot.role} for "${blueprint.name}" workforce`,
+            system_prompt: buildSystemPrompt(blueprint, slot),
+        },
+    }));
+}
+function buildSystemPrompt(blueprint, slot) {
+    return [
+        `You are the ${slot.title} for "${blueprint.name}".`,
+        ``,
+        `YOUR ROLE: ${slot.description}`,
+        ``,
+        `TEAM GOAL: ${blueprint.goal}`,
+        ``,
+        slot.suggestedTemplate
+            ? `REFERENCE: Behave like the AgenticFlow marketplace template "${slot.suggestedTemplate}" for this role.`
+            : null,
+        ``,
+        `OPERATING RULES:`,
+        `- Stay in your role; do not do work outside ${slot.role} scope.`,
+        `- When you need input from another role, name the role in your response rather than acting for them.`,
+        `- Produce concrete, structured output the downstream node in the workforce can act on.`,
+    ]
+        .filter((l) => l !== null)
+        .join("\n");
+}
+/**
+ * Build a full workforce graph that references real agent_ids.
+ *
+ * Shape:
+ *   trigger ──► coordinator_agent ──► worker_agent_1
+ *                                  ├─► worker_agent_2
+ *                                  ├─► worker_agent_3
+ *                                  └─► output (from coordinator)
+ *
+ * The first non-optional slot (typically "ceo") becomes the coordinator.
+ * Coordinator receives the trigger event, and all other agents receive
+ * their handoff from the coordinator. `output` listens on the coordinator.
+ *
+ * `agentIdBySlot` MUST contain an id for every slot in `specs` — callers
+ * produce this map by creating agents and pairing the returned ids back
+ * with `spec.slotKey`.
+ */
+export function buildAgentWiredGraph(blueprint, specs, agentIdBySlot) {
+    if (specs.length === 0) {
+        throw new Error("No agent specs provided to buildAgentWiredGraph");
+    }
+    const coordinatorSpec = specs[0];
+    const coordinatorId = agentIdBySlot[coordinatorSpec.slotKey];
+    if (!coordinatorId) {
+        throw new Error(`Missing agent_id for coordinator slot "${coordinatorSpec.slotKey}"`);
+    }
+    const coordinatorNodeName = slotToNodeName(coordinatorSpec.slot);
+    const GRID_X = 320;
+    const GRID_Y = 180;
+    const nodes = [
+        {
+            name: "trigger",
+            type: "trigger",
+            position: { x: 0, y: GRID_Y },
+            input: {},
+            meta: {
+                source_blueprint: blueprint.id,
+                blueprint_name: blueprint.name,
+                blueprint_goal: blueprint.goal,
+                starter_tasks: blueprint.starterTasks,
+            },
+        },
+        {
+            name: coordinatorNodeName,
+            type: "agent",
+            position: { x: GRID_X, y: GRID_Y },
+            input: { agent_id: coordinatorId },
+            meta: {
+                role: coordinatorSpec.slot.role,
+                title: coordinatorSpec.slot.title,
+                is_coordinator: true,
+            },
+        },
+    ];
+    // Worker agent nodes, laid out to the right of the coordinator, stacked vertically
+    specs.slice(1).forEach((spec, i) => {
+        const nodeName = slotToNodeName(spec.slot);
+        const agentId = agentIdBySlot[spec.slotKey];
+        if (!agentId) {
+            throw new Error(`Missing agent_id for slot "${spec.slotKey}"`);
+        }
+        nodes.push({
+            name: nodeName,
+            type: "agent",
+            position: { x: GRID_X * 2, y: i * GRID_Y },
+            input: { agent_id: agentId },
+            meta: { role: spec.slot.role, title: spec.slot.title },
+        });
+    });
+    // Output node listens on the coordinator's result
+    nodes.push({
+        name: "output",
+        type: "output",
+        position: { x: GRID_X * 3, y: GRID_Y },
+        input: { message: `${blueprint.name} team response` },
+    });
+    const edges = [
+        // trigger → coordinator
+        { source_node_name: "trigger", target_node_name: coordinatorNodeName, connection_type: "next_step" },
+        // coordinator → output
+        { source_node_name: coordinatorNodeName, target_node_name: "output", connection_type: "next_step" },
+    ];
+    // coordinator → each worker agent (fan-out)
+    for (const spec of specs.slice(1)) {
+        edges.push({
+            source_node_name: coordinatorNodeName,
+            target_node_name: slotToNodeName(spec.slot),
+            connection_type: "next_step",
+        });
+    }
+    return { nodes, edges };
+}
 //# sourceMappingURL=blueprint-to-workforce.js.map

package/dist/cli/blueprint-to-workforce.js.map

@@ -1 +1 @@
-{"version":3,"file":"blueprint-to-workforce.js","sourceRoot":"","sources":["../../src/cli/blueprint-to-workforce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAqBH,mDAAmD;AACnD,MAAM,UAAU,cAAc,CAAC,IAAe;IAC5C,OAAO,SAAS,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAA2B,EAC3B,UAAmD,EAAE;IAErD,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC;IACrD,MAAM,oBAAoB,GAAG,OAAO,CAAC,WAAW,IAAI,SAAS,CAAC,WAAW,CAAC;IAE1E,sEAAsE;IACtE,4EAA4E;IAC5E,2BAA2B;IAC3B,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,kBAAkB,EAAE,IAAI,CAAC,iBAAiB,IAAI,IAAI;QAClD,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAChC,kBAAkB,EAAE,cAAc,CAAC,IAAI,CAAC;KACzC,CAAC,CAAC,CAAC;IAEJ,MAAM,KAAK,GAAuC;QAChD;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;YACxB,KAAK,EAAE,EAAE;YACT,IAAI,EAAE;gBACJ,gBAAgB,EAAE,SAAS,CAAC,EAAE;gBAC9B,cAAc,EAAE,SAAS,CAAC,IAAI;gBAC9B,cAAc,EAAE,SAAS,CAAC,IAAI;gBAC9B,cAAc,EAAE,aAAa;gBAC7B,aAAa,EAAE,SAAS,CAAC,YAAY;gBACrC,aAAa,EAAE,WAAW;aAC3B;SACF;QACD;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE;YAC1B,KAAK,EAAE;gBACL,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,0FAA0F;aACrH;SACF;KACF,CAAC;IAEF,MAAM,KAAK,GAAuC;QAChD;YACE,gBAAgB,EAAE,SAAS;YAC3B,gBAAgB,EAAE,QAAQ;YAC1B,eAAe,EAAE,WAAW;SAC7B;KACF,CAAC;IAEF,MAAM,oBAAoB,GAAG;QAC3B,2FAA2F,SAAS,CAAC,MAAM,CAAC,MAAM,UAAU;QAC5H,GAAG,aAAa;aACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;aAC1B,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,sBAAsB,CAAC,CAAC,kBAAkB,eAAe,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,GAAG;YAC/E,CAAC,CAAC,CAAC,kBAAkB;gBACnB,CAAC,CAAC,uCAAuC,CAAC,CAAC,kBAAkB,IAAI;gBACjE,CAAC,CAAC,GAAG,CAAC,CACX;QACH,4DAA4D;QAC5D,yFAAyF;QACzF,yEAAyE;KAC1E,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACrE,KAAK;QACL,KAAK;QACL,oBAAoB;KACrB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"blueprint-to-workforce.js","sourceRoot":"","sources":["../../src/cli/blueprint-to-workforce.ts"],"names":[],"mappings":"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"}

package/dist/cli/changelog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/cli/changelog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,eAAO,MAAM,SAAS,EAAE,cAAc,EAoJrC,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,cAAc,CAEnD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAInE"}
+{"version":3,"file":"changelog.d.ts","sourceRoot":"","sources":["../../src/cli/changelog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,eAAO,MAAM,SAAS,EAAE,cAAc,EAqLrC,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,cAAc,CAEnD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAInE"}

package/dist/cli/changelog.js

@@ -5,6 +5,39 @@
  * and displayed after upgrade.
  */
 export const CHANGELOG = [
+    {
+        version: "1.6.1",
+        date: "2026-04-14",
+        highlights: [
+            "Playbook freshness pass — three onboarding playbooks (`first-touch`, `amazon-seller`, `company-from-scratch`) now lead with `af workforce init` (v1.6 native deploy) and show the deprecated `af paperclip init` path as a secondary option with a sunset date",
+            "`deploy-to-paperclip` playbook got a prominent `⚠️ DEPRECATED` header pointing at `af playbook migrate-from-paperclip` and the sunset 2026-10-14",
+            "`amazon-seller` playbook expanded: shows `--include-optional-slots` to create all 5 agents, attach-MCP-per-agent recipe pointing at `mcp-client-quirks`, and smoke-run/publish commands",
+            "Verified: all 6 blueprints translate cleanly through `--dry-run` (node/edge math correct). Full e2e `content-studio` deploy creates + wires + validates + tears down cleanly",
+        ],
+        for_ai: [
+            "When `af bootstrap --json` returns workforces=0 and the user wants a team, the FIRST thing to show them is `af workforce init --blueprint <id> --dry-run --json` — the playbooks now lead with this, no longer with paperclip",
+            "For Amazon Singapore sellers, run `af playbook amazon-seller` — it shows the one-command native deploy path first, with `--include-optional-slots` for the full 5-agent team",
+            "`af playbook deploy-to-paperclip` now explicitly flags itself deprecated and points at `migrate-from-paperclip` — follow that path unless the user has an existing Paperclip instance",
+        ],
+    },
+    {
+        version: "1.6.0",
+        date: "2026-04-14",
+        highlights: [
+            "`af workforce init --blueprint <slug>` now deploys a RUNNABLE TEAM by default — creates one real agent per non-optional blueprint slot, then wires them into a DAG (trigger → coordinator → worker agents → output). Previously it produced a skeleton the user had to finish manually",
+            "Atomic rollback on failure: if workforce init fails at any step, every agent created so far is deleted and the workforce is removed. No orphans",
+            "`--skeleton-only` preserves the v1.5 behavior for users who want to wire agents manually (e.g. re-use existing agents rather than auto-create)",
+            "`--model` flag lets you pick the model for all auto-created agents (default: agenticflow/gemini-2.0-flash). `--include-optional-slots` fills every slot, not just the required ones",
+            "`--dry-run` shows both the agent-create plan AND the graph shape without touching the workspace — preview the full team before committing",
+        ],
+        for_ai: [
+            "NEW DEFAULT FLOW: `af workforce init --blueprint amazon-seller --name \"My Team\" --json` gives you a fully runnable workforce in one command. Returns {workforce_id, agents:[{slot_role, agent_id, title}], node_count, edge_count, next_steps}",
+            "Each auto-created agent starts with tools:[] — attach MCP clients or tools with `af agent update --agent-id <id> --patch --body '{\"mcp_clients\":[...]}'` after init",
+            "If init fails, the error details carry `rolled_back_agents` and `rolled_back_workforce` so you know what was undone. If rollback itself fails, `rollback_errors` lists what needs manual cleanup",
+            "Use `--dry-run` first to preview: you'll see the model per slot, a preview of each agent's system prompt, and the estimated node/edge count — no side effects",
+            "Set `--project-id` explicitly if your shell doesn't have AGENTICFLOW_PROJECT_ID — full init needs it for agent creation (server doesn't auto-inject for agent endpoints)",
+        ],
+    },
     {
         version: "1.5.3",
         date: "2026-04-14",

package/dist/cli/changelog.js.map

@@ -1 +1 @@
-{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../../src/cli/changelog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../../src/cli/changelog.ts"],"names":[],"mappings":"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"}

package/dist/cli/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAi8BpC,wBAAgB,aAAa,IAAI,OAAO,CAs2KvC;AAED,wBAAsB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB3D"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAi8BpC,wBAAgB,aAAa,IAAI,OAAO,CAu/KvC;AAED,wBAAsB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB3D"}

package/dist/cli/main.js

@@ -4604,54 +4604,181 @@ export function createProgram() {
     // Blueprint-based native init -----------------------------------------
     workforceCmd
         .command("init")
-        .description("Deploy a blueprint as an AgenticFlow-native workforce (no Paperclip). " +
-        "Translates the blueprint's agent slots into MAS nodes + edges, then PUTs the graph.")
+        .description("Deploy a blueprint as an AgenticFlow-native workforce. Default behavior " +
+        "(v1.6+): creates a real agent per non-optional blueprint slot, then wires " +
+        "them into a runnable DAG. Use --skeleton-only for the old v1.5 behavior " +
+        "(trigger + output + blueprint metadata, no agents).")
         .requiredOption("--blueprint <slug>", "Blueprint id (run `af paperclip blueprints` to list)")
         .option("--name <name>", "Workforce name (defaults to blueprint name)")
         .option("--workspace-id <id>", "Workspace ID (overrides env)")
-        .option("--dry-run", "Show the graph that would be deployed without writing")
+        .option("--project-id <id>", "Project ID to use for agent creation (defaults to env / client config)")
+        .option("--model <model>", "Model to use for all agent slots (default: agenticflow/gemini-2.0-flash). Pass --include-optional-slots to fill every slot", "agenticflow/gemini-2.0-flash")
+        .option("--include-optional-slots", "Also create agents for slots marked optional in the blueprint")
+        .option("--skeleton-only", "Create a skeleton (trigger + output + blueprint metadata) WITHOUT materializing agents. The v1.5 behavior; use when you plan to wire agents yourself")
+        .option("--dry-run", "Show the graph + agent specs that would be created without writing")
         .action(async (opts) => {
-        const { blueprintToWorkforce } = await import("./blueprint-to-workforce.js");
+        const { blueprintToWorkforce, blueprintToAgentSpecs, buildAgentWiredGraph } = await import("./blueprint-to-workforce.js");
         const blueprint = getBlueprint(opts.blueprint);
         if (!blueprint) {
             fail("invalid_option_value", `Unknown blueprint id: ${opts.blueprint}`, "Run `af paperclip blueprints` to see available ids.");
         }
-        const translated = blueprintToWorkforce(blueprint, { name: opts.name });
+        // ── Skeleton-only fast path (v1.5 behavior preserved) ────────────────
+        if (opts.skeletonOnly) {
+            const translated = blueprintToWorkforce(blueprint, { name: opts.name });
+            if (opts.dryRun) {
+                printResult({
+                    schema: "agenticflow.dry_run.v1",
+                    valid: true,
+                    target: "workforce.init",
+                    mode: "skeleton",
+                    blueprint: blueprint.id,
+                    workforce: translated.workforce,
+                    node_count: translated.nodes.length,
+                    edge_count: translated.edges.length,
+                    nodes: translated.nodes,
+                    edges: translated.edges,
+                });
+                return;
+            }
+            const client = buildClient(program.opts());
+            await run(async () => {
+                const created = (await client.workforces.create(translated.workforce, { workspaceId: opts.workspaceId }));
+                const workforceId = created["id"];
+                if (!workforceId)
+                    throw new Error("Workforce create did not return an id.");
+                await client.workforces.putSchema(workforceId, { nodes: translated.nodes, edges: translated.edges }, { workspaceId: opts.workspaceId });
+                return {
+                    schema: "agenticflow.workforce.init.v1",
+                    workforce_id: workforceId,
+                    blueprint: blueprint.id,
+                    mode: "skeleton",
+                    node_count: translated.nodes.length,
+                    edge_count: translated.edges.length,
+                    skeleton: true,
+                    next_steps: translated.suggested_next_steps,
+                };
+            });
+            return;
+        }
+        // ── Full deploy path (v1.6+ default) ─────────────────────────────────
+        // Resolve project_id (required for agent create — server doesn't auto-inject on agents)
+        // Build the client eagerly so we can read its auth-config-derived projectId
+        // (auth.json > env > flag). Callers that override with --project-id win.
+        const fullClient = buildClient(program.opts());
+        const projectId = opts.projectId ??
+            program.opts().projectId ??
+            process.env["AGENTICFLOW_PROJECT_ID"] ??
+            fullClient.sdk.projectId;
+        if (!projectId) {
+            fail("missing_required_option", "Full workforce init requires a project_id for agent creation.", "Pass --project-id <id>, set AGENTICFLOW_PROJECT_ID, or run `af bootstrap --json` and copy `auth.project_id`. Alternatively use --skeleton-only to skip agent materialization.");
+        }
+        const workforceName = opts.name ?? blueprint.name;
+        const specs = blueprintToAgentSpecs(blueprint, {
+            projectId: projectId,
+            workforceName,
+            model: opts.model,
+            includeOptionalSlots: Boolean(opts.includeOptionalSlots),
+        });
         if (opts.dryRun) {
-            printResult({
+            // Show plan without side effects
+            const plan = {
                 schema: "agenticflow.dry_run.v1",
                 valid: true,
                 target: "workforce.init",
+                mode: "full",
                 blueprint: blueprint.id,
-                workforce: translated.workforce,
-                node_count: translated.nodes.length,
-                edge_count: translated.edges.length,
-                nodes: translated.nodes,
-                edges: translated.edges,
-            });
+                workforce: { name: workforceName, description: blueprint.description },
+                agents_to_create: specs.map((s) => ({
+                    slot_role: s.slotKey,
+                    title: s.slot.title,
+                    model: s.body["model"],
+                    preview_system_prompt: s.body["system_prompt"].slice(0, 120) + "…",
+                })),
+                estimated_node_count: specs.length + 2, // + trigger + output
+                estimated_edge_count: specs.length + 1, // trigger→coordinator + coordinator→{workers,output}
+            };
+            printResult(plan);
             return;
         }
-        const client = buildClient(program.opts());
-        await run(async () => {
-            const created = (await client.workforces.create(translated.workforce, { workspaceId: opts.workspaceId }));
-            const workforceId = created["id"];
-            if (!workforceId) {
+        const client = fullClient;
+        // Track created IDs so we can roll back on failure
+        let workforceId = null;
+        const createdAgentIds = [];
+        try {
+            // 1. Create the workforce shell (metadata only)
+            const wfCreated = (await client.workforces.create({ name: workforceName, description: blueprint.description }, { workspaceId: opts.workspaceId, projectId: projectId }));
+            workforceId = wfCreated["id"];
+            if (!workforceId)
                 throw new Error("Workforce create did not return an id.");
-            }
-            await client.workforces.putSchema(workforceId, { nodes: translated.nodes, edges: translated.edges }, { workspaceId: opts.workspaceId });
-            return {
+            // 2. Create agents serially (easier error handling than parallel; N is small — 3-5)
+            const agentIdBySlot = {};
+            for (const spec of specs) {
+                const agent = (await client.agents.create(spec.body));
+                const agentId = agent["id"];
+                if (!agentId)
+                    throw new Error(`Agent create for slot "${spec.slotKey}" did not return an id.`);
+                createdAgentIds.push(agentId);
+                agentIdBySlot[spec.slotKey] = agentId;
+            }
+            // 3. Build the fully-wired graph + PUT schema
+            const graph = buildAgentWiredGraph(blueprint, specs, agentIdBySlot);
+            await client.workforces.putSchema(workforceId, graph, { workspaceId: opts.workspaceId });
+            // 4. Return structured deploy report
+            printResult({
                 schema: "agenticflow.workforce.init.v1",
                 workforce_id: workforceId,
                 blueprint: blueprint.id,
-                node_count: translated.nodes.length,
-                edge_count: translated.edges.length,
-                skeleton: true,
-                next_steps: translated.suggested_next_steps.concat([
-                    `af workforce schema --workforce-id ${workforceId} --json  # inspect current graph`,
-                    `af workforce run --workforce-id ${workforceId} --trigger-data '{}'  # smoke-test the skeleton`,
-                ]),
+                mode: "full",
+                node_count: graph.nodes.length,
+                edge_count: graph.edges.length,
+                skeleton: false,
+                agents: specs.map((s) => ({
+                    slot_role: s.slotKey,
+                    agent_id: agentIdBySlot[s.slotKey],
+                    title: s.slot.title,
+                })),
+                next_steps: [
+                    `af workforce schema --workforce-id ${workforceId} --json  # inspect the wired graph`,
+                    `af workforce run --workforce-id ${workforceId} --trigger-data '{"message":"..."}'  # smoke-test`,
+                    `af workforce publish --workforce-id ${workforceId} --json  # mint a public URL`,
+                    `Each agent was created blank-tools; attach MCP clients or tools via 'af agent update --agent-id <id> --patch --body '{"mcp_clients":[...]}' as needed`,
+                ],
+            });
+        }
+        catch (err) {
+            // Atomic rollback: delete any agents + workforce created so far, then re-throw
+            const rollbackErrors = [];
+            for (const agentId of createdAgentIds) {
+                try {
+                    await client.agents.delete(agentId);
+                }
+                catch (rbErr) {
+                    rollbackErrors.push(`agent ${agentId}: ${rbErr instanceof Error ? rbErr.message : String(rbErr)}`);
+                }
+            }
+            if (workforceId) {
+                try {
+                    await client.workforces.delete(workforceId, { workspaceId: opts.workspaceId });
+                }
+                catch (rbErr) {
+                    rollbackErrors.push(`workforce ${workforceId}: ${rbErr instanceof Error ? rbErr.message : String(rbErr)}`);
+                }
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            const details = {
+                rolled_back_agents: createdAgentIds,
+                rolled_back_workforce: workforceId,
             };
-        });
+            if (rollbackErrors.length > 0)
+                details["rollback_errors"] = rollbackErrors;
+            if (err instanceof APIError && err.payload !== null && err.payload !== undefined) {
+                details["payload"] = err.payload;
+                details["status_code"] = err.statusCode;
+            }
+            fail("workforce_init_failed", `Workforce init failed: ${message}`, rollbackErrors.length > 0
+                ? "Rollback partially failed — check rollback_errors and delete stray resources manually."
+                : "All resources created so far were rolled back. Fix the underlying issue and retry.", details);
+        }
     });
     // triggers  (SDK-based)
     // ═════════════════════════════════════════════════════════════════