@pixelml/agenticflow-cli 1.7.1 → 1.10.0

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

@@ -0,0 +1,67 @@
+/**
+ * Tier 1 blueprint → single-agent deploy.
+ *
+ * Translates a `CompanyBlueprint` with `tier: 1` into a SINGLE agent-create
+ * payload pre-wired with AgenticFlow-native plugins (web_search, web_retrieval,
+ * api_call, agenticflow_generate_image, string_to_json). No workforce, no MAS,
+ * no external connection — runs in any workspace on day 1.
+ *
+ * Output shape matches the server's `AgentCreateDTO` with a populated
+ * `plugins: AgentPluginToolConfig[]` array. For current built-in nodes
+ * (verified against `af node-types get --name <n>` + a live agent sample
+ * 2026-04-14) the plugin version is "v1.0.0" and connection-less nodes get
+ * `connection: null`.
+ *
+ * Why a separate file from blueprint-to-workforce.ts:
+ *   - different target resource (agent vs workforce)
+ *   - different side-effects (1 POST vs N+1 POSTs with rollback)
+ *   - different input shape (AgentPluginSpec per slot vs AgentSlot w/o plugins)
+ * Keeping them separate lets each translator stay a pure function.
+ */
+import type { CompanyBlueprint, AgentPluginSpec } from "./company-blueprints.js";
+/**
+ * AgentPluginToolConfig shape (matches openapi.json#/components/schemas/AgentPluginToolConfig).
+ * Required: plugin_id, plugin_version.
+ * Optional: run_behavior (default "auto_run"), connection, input_config.
+ */
+export interface AgentPluginToolConfig {
+    plugin_id: string;
+    plugin_version: string;
+    run_behavior: "auto_run" | "request_confirmation";
+    connection: string | null;
+    input_config: Record<string, {
+        value: unknown;
+        description?: string | null;
+    }> | null;
+}
+export interface AgentInitPayload {
+    /** POST body for /v1/agents/. Caller supplies project_id via options. */
+    body: Record<string, unknown>;
+    /** Human-facing next-step hints to print after success. */
+    suggested_next_steps: string[];
+}
+/**
+ * Translate an `AgentPluginSpec` (from the blueprint) into an
+ * `AgentPluginToolConfig` (what the server expects).
+ *
+ * Connection resolution is deferred to the caller — if a spec has
+ * `connectionCategory: "pixelml"`, the CLI is responsible for looking up the
+ * workspace's pixelml connection id and passing it in `connectionsByCategory`.
+ * For connection-less specs we just emit `connection: null`.
+ */
+export declare function pluginSpecToConfig(spec: AgentPluginSpec, connectionsByCategory?: Partial<Record<"pixelml", string>>): AgentPluginToolConfig;
+/**
+ * Build the body for `client.agents.create()` from a Tier 1 blueprint.
+ *
+ * Tier 1 blueprints are constrained to a single non-optional agent slot with
+ * a populated `plugins[]` array. If the blueprint doesn't match this shape
+ * we throw — callers should route Tier 3 blueprints to `blueprintToAgentSpecs`
+ * + `buildAgentWiredGraph` instead.
+ */
+export declare function tier1BlueprintToAgentPayload(blueprint: CompanyBlueprint, options: {
+    projectId: string;
+    agentName?: string;
+    model?: string;
+    connectionsByCategory?: Partial<Record<"pixelml", string>>;
+}): AgentInitPayload;
+//# sourceMappingURL=blueprint-to-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint-to-agent.d.ts","sourceRoot":"","sources":["../../src/cli/blueprint-to-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAUjF;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,UAAU,GAAG,sBAAsB,CAAC;IAClD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;CACtF;AAED,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,2DAA2D;IAC3D,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,eAAe,EACrB,qBAAqB,GAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAM,GAC7D,qBAAqB,CA+BvB;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE;IACP,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5D,GACA,gBAAgB,CAmDlB"}

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

@@ -0,0 +1,167 @@
+/**
+ * Tier 1 blueprint → single-agent deploy.
+ *
+ * Translates a `CompanyBlueprint` with `tier: 1` into a SINGLE agent-create
+ * payload pre-wired with AgenticFlow-native plugins (web_search, web_retrieval,
+ * api_call, agenticflow_generate_image, string_to_json). No workforce, no MAS,
+ * no external connection — runs in any workspace on day 1.
+ *
+ * Output shape matches the server's `AgentCreateDTO` with a populated
+ * `plugins: AgentPluginToolConfig[]` array. For current built-in nodes
+ * (verified against `af node-types get --name <n>` + a live agent sample
+ * 2026-04-14) the plugin version is "v1.0.0" and connection-less nodes get
+ * `connection: null`.
+ *
+ * Why a separate file from blueprint-to-workforce.ts:
+ *   - different target resource (agent vs workforce)
+ *   - different side-effects (1 POST vs N+1 POSTs with rollback)
+ *   - different input shape (AgentPluginSpec per slot vs AgentSlot w/o plugins)
+ * Keeping them separate lets each translator stay a pure function.
+ */
+/**
+ * Default plugin version for built-in AgenticFlow nodes.
+ * Verified 2026-04-14 via `af agent get` on a Slide Agent — all built-ins
+ * currently ship at v1.0.0. If/when the backend introduces versioned plugins,
+ * this file is the single place to update.
+ */
+const DEFAULT_PLUGIN_VERSION = "v1.0.0";
+/**
+ * Translate an `AgentPluginSpec` (from the blueprint) into an
+ * `AgentPluginToolConfig` (what the server expects).
+ *
+ * Connection resolution is deferred to the caller — if a spec has
+ * `connectionCategory: "pixelml"`, the CLI is responsible for looking up the
+ * workspace's pixelml connection id and passing it in `connectionsByCategory`.
+ * For connection-less specs we just emit `connection: null`.
+ */
+export function pluginSpecToConfig(spec, connectionsByCategory = {}) {
+    let connection = null;
+    if (spec.connectionCategory === "pixelml") {
+        const resolved = connectionsByCategory.pixelml;
+        if (!resolved) {
+            throw new Error(`Plugin "${spec.nodeTypeName}" requires a pixelml connection, but none was supplied. ` +
+                `Run 'af connections list' to find the workspace's pixelml connection id, then pass it to the deploy flow.`);
+        }
+        connection = resolved;
+    }
+    // Convert our { value, description? } entries to the server's wire format
+    // (description: null when absent — the server accepts explicit null).
+    const inputConfig = spec.input
+        ? Object.fromEntries(Object.entries(spec.input).map(([k, v]) => [
+            k,
+            { value: v.value, description: v.description ?? null },
+        ]))
+        : null;
+    return {
+        plugin_id: spec.nodeTypeName,
+        plugin_version: DEFAULT_PLUGIN_VERSION,
+        run_behavior: "auto_run",
+        connection,
+        input_config: inputConfig,
+    };
+}
+/**
+ * Build the body for `client.agents.create()` from a Tier 1 blueprint.
+ *
+ * Tier 1 blueprints are constrained to a single non-optional agent slot with
+ * a populated `plugins[]` array. If the blueprint doesn't match this shape
+ * we throw — callers should route Tier 3 blueprints to `blueprintToAgentSpecs`
+ * + `buildAgentWiredGraph` instead.
+ */
+export function tier1BlueprintToAgentPayload(blueprint, options) {
+    if (blueprint.tier !== 1) {
+        throw new Error(`Blueprint "${blueprint.id}" is tier ${blueprint.tier ?? 3}, not tier 1. ` +
+            `Use 'af workforce init --blueprint ${blueprint.id}' instead.`);
+    }
+    const slots = blueprint.agents.filter((s) => !s.optional);
+    if (slots.length !== 1) {
+        throw new Error(`Tier 1 blueprint "${blueprint.id}" must have exactly one non-optional agent slot; got ${slots.length}.`);
+    }
+    const slot = slots[0];
+    const plugins = (slot.plugins ?? []).map((spec) => pluginSpecToConfig(spec, options.connectionsByCategory ?? {}));
+    if (plugins.length === 0) {
+        throw new Error(`Tier 1 blueprint "${blueprint.id}" agent slot "${slot.role}" has no plugins. ` +
+            `Tier 1 blueprints must declare at least one AgentPluginSpec; otherwise it's just a vanilla agent.`);
+    }
+    // Default model choice for Tier 1: PDCA round (2026-04-14) showed
+    // `agenticflow/gemini-2.0-flash` (our old default) REFUSES to call tools on
+    // "latest X?" prompts, even when the system prompt explicitly forbids
+    // cutoff-based refusals. `agenticflow/gpt-4o-mini` follows the system prompt
+    // and routes to web_search correctly. Callers can still override via --model.
+    const model = options.model ?? "agenticflow/gpt-4o-mini";
+    const agentName = options.agentName ?? blueprint.name;
+    const body = {
+        name: agentName,
+        project_id: options.projectId,
+        description: blueprint.description,
+        system_prompt: buildTier1SystemPrompt(blueprint, slot),
+        model,
+        tools: [],
+        plugins,
+    };
+    const pluginNames = plugins.map((p) => p.plugin_id).join(", ");
+    const suggested_next_steps = [
+        `af agent get --agent-id <id> --json  # inspect the created agent`,
+        `af agent run --agent-id <id> --message "<question>" --json  # smoke-test the agent`,
+        `The agent has ${plugins.length} built-in plugins attached: ${pluginNames}.`,
+        `To expose it externally: attach to a workforce, or use 'af agent stream --agent-id <id>' for direct calls.`,
+    ];
+    return { body, suggested_next_steps };
+}
+/**
+ * Tier 1 system prompt: single-agent, the blueprint goal is the whole job,
+ * plugins are the only tools — no "delegate to another role" framing like the
+ * workforce version uses.
+ *
+ * IMPORTANT — the rules below exist because of PDCA round 1+2 (2026-04-14)
+ * where the deployed research-assistant refused to call web_search on
+ * "latest OpenAI model" questions, citing its training cutoff, and on a
+ * vaguer "general tech news" prompt it returned off-topic stadium-tech
+ * links because the search query was poorly constructed. The rules below
+ * attack both failure modes directly:
+ *   - "your cutoff is stale" makes refusal-from-cutoff explicitly wrong
+ *   - query-construction guidance fights the off-topic result
+ */
+function buildTier1SystemPrompt(blueprint, slot) {
+    const plugins = slot.plugins ?? [];
+    const pluginIds = plugins.map((p) => p.nodeTypeName);
+    const pluginList = plugins.map((p) => `- ${p.nodeTypeName}`).join("\n");
+    const hasWebSearch = pluginIds.includes("web_search");
+    const hasWebRetrieval = pluginIds.includes("web_retrieval");
+    const hasApiCall = pluginIds.includes("api_call");
+    const hasImageGen = pluginIds.includes("agenticflow_generate_image");
+    const toolGuidance = [];
+    if (hasWebSearch) {
+        toolGuidance.push(`- **web_search**: Call this FIRST for any question involving current events, recent releases, "latest", dates, prices, news, people's current roles, or anything that might have changed since your training. DO NOT refuse with "my knowledge cutoff is X" — your cutoff is stale by definition, that's why you have web_search.`, `- When constructing a search_query, use SPECIFIC terms from the user's question. If the user asks about a topic in a domain, include the domain word. If they ask about a company, include the company name. Avoid generic queries like "tech news" — that returns noise.`);
+    }
+    if (hasWebRetrieval) {
+        toolGuidance.push(`- **web_retrieval**: Use this after web_search when you need the FULL content of a specific URL (the snippets from search are short). Also use when the user provides a URL directly.`);
+    }
+    if (hasApiCall) {
+        toolGuidance.push(`- **api_call**: Use for HTTP requests to JSON APIs. Set method, url, headers, body_type appropriately. Prefer this over web_search when the user provides an explicit API endpoint.`);
+    }
+    if (hasImageGen) {
+        toolGuidance.push(`- **agenticflow_generate_image**: Use for generating visuals when the user asks for an image, graphic, thumbnail, or visual accompaniment. Write a SPECIFIC, descriptive prompt — don't pass the user's message verbatim if it's vague.`);
+    }
+    return [
+        `You are the ${slot.title} — ${blueprint.name}.`,
+        ``,
+        `YOUR JOB: ${blueprint.goal}`,
+        ``,
+        `ROLE DETAIL: ${slot.description}`,
+        ``,
+        `AVAILABLE TOOLS (built-in AgenticFlow plugins):`,
+        pluginList,
+        ``,
+        `TOOL USAGE RULES:`,
+        ...toolGuidance,
+        ``,
+        `CORE RULES:`,
+        `- CALL A TOOL FIRST, then answer. Default to using your tools; only answer from prior knowledge when the question is genuinely about timeless facts.`,
+        `- NEVER say "I cannot provide information that far in the future" or "my knowledge cutoff is...". If the user is asking about something recent, that is exactly what your tools are for — use them.`,
+        `- Cite specific sources when you use web_search or web_retrieval results. Include the URLs you actually retrieved.`,
+        `- Keep responses concrete and actionable. No "I can help with..." filler.`,
+        `- If a user request is outside what your tools can do, say so plainly and suggest the right next step.`,
+    ].join("\n");
+}
+//# sourceMappingURL=blueprint-to-agent.js.map

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

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

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

@@ -0,0 +1,72 @@
+/**
+ * Workflow-kind blueprints → workflow create payload.
+ *
+ * Workflows chain nodes deterministically. Rungs 0-2 on the composition ladder:
+ *   0: trigger → llm → output                 (hello world)
+ *   1: llm_plan → llm_execute (chained via output template refs)
+ *   2: web_retrieval → llm_summarize          (enriched w/ real-world data)
+ *
+ * Node wiring in workflows is IMPLICIT via template references in
+ * input_config. Unlike workforce DAGs, there are no explicit edges —
+ * `{{trigger_field}}` pulls from trigger inputs, `{{node_name.output_field}}`
+ * pulls from a previously-executed node's output. The engine infers execution
+ * order from these references.
+ *
+ * The `llm` node type requires an LLM-provider `connection` (typically a
+ * Straico / OpenAI / Anthropic / etc. category connection in the workspace).
+ * `findWorkspaceLLMConnection()` auto-discovers one and returns a warning if
+ * none exists.
+ */
+import type { CompanyBlueprint } from "./company-blueprints.js";
+export interface WorkflowCreatePayload {
+    name: string;
+    description?: string | null;
+    project_id: string;
+    nodes: WorkflowCreateNode[];
+    input_schema: {
+        type: "object";
+        title: string;
+        required: string[];
+        properties: Record<string, unknown>;
+    };
+    output_mapping: Record<string, unknown>;
+    variables?: Record<string, unknown> | null;
+}
+interface WorkflowCreateNode {
+    name: string;
+    title: string;
+    description: string;
+    node_type_name: string;
+    input_config: Record<string, unknown>;
+    output_mapping: Record<string, unknown> | null;
+    connection: string | null;
+    cost: number | null;
+    metadata: Record<string, unknown> | null;
+}
+export interface WorkflowBlueprintTranslation {
+    payload: WorkflowCreatePayload;
+    /** Warnings to surface — e.g. no LLM connection found. */
+    warnings: string[];
+    /** Required connection categories that weren't found in workspace (if any). */
+    missing_connections: string[];
+    suggested_next_steps: string[];
+}
+/**
+ * Resolve an LLM-provider connection id from the workspace's existing
+ * connections. Returns null if none found.
+ */
+export declare function findWorkspaceLLMConnection(connections: Array<{
+    id: string;
+    category?: string;
+}>): string | null;
+/**
+ * Convert a blueprint's workflowNodes into the workflow-create payload shape
+ * the backend expects. Pure function — no side effects.
+ */
+export declare function workflowBlueprintToPayload(blueprint: CompanyBlueprint, options: {
+    projectId: string;
+    workflowName?: string;
+    llmConnectionId?: string | null;
+}): WorkflowBlueprintTranslation;
+export {};
+//# sourceMappingURL=blueprint-to-workflow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint-to-workflow.d.ts","sourceRoot":"","sources":["../../src/cli/blueprint-to-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,yBAAyB,CAAC;AAQlF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IAInB,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;IACF,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5C;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,qBAAqB,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+EAA+E;IAC/E,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACpD,MAAM,GAAG,IAAI,CAMf;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE;IACP,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,GACA,4BAA4B,CAuF9B"}

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

@@ -0,0 +1,120 @@
+/**
+ * Workflow-kind blueprints → workflow create payload.
+ *
+ * Workflows chain nodes deterministically. Rungs 0-2 on the composition ladder:
+ *   0: trigger → llm → output                 (hello world)
+ *   1: llm_plan → llm_execute (chained via output template refs)
+ *   2: web_retrieval → llm_summarize          (enriched w/ real-world data)
+ *
+ * Node wiring in workflows is IMPLICIT via template references in
+ * input_config. Unlike workforce DAGs, there are no explicit edges —
+ * `{{trigger_field}}` pulls from trigger inputs, `{{node_name.output_field}}`
+ * pulls from a previously-executed node's output. The engine infers execution
+ * order from these references.
+ *
+ * The `llm` node type requires an LLM-provider `connection` (typically a
+ * Straico / OpenAI / Anthropic / etc. category connection in the workspace).
+ * `findWorkspaceLLMConnection()` auto-discovers one and returns a warning if
+ * none exists.
+ */
+/**
+ * Connection categories the `llm` workflow node can use. Order = preference.
+ * Adjust if the backend adds categories.
+ */
+const LLM_PROVIDER_CATEGORIES = ["straico", "openai", "anthropic", "google", "deepseek", "groq"];
+/**
+ * Resolve an LLM-provider connection id from the workspace's existing
+ * connections. Returns null if none found.
+ */
+export function findWorkspaceLLMConnection(connections) {
+    for (const cat of LLM_PROVIDER_CATEGORIES) {
+        const match = connections.find((c) => c.category === cat);
+        if (match)
+            return match.id;
+    }
+    return null;
+}
+/**
+ * Convert a blueprint's workflowNodes into the workflow-create payload shape
+ * the backend expects. Pure function — no side effects.
+ */
+export function workflowBlueprintToPayload(blueprint, options) {
+    if (!blueprint.workflowNodes || blueprint.workflowNodes.length === 0) {
+        throw new Error(`Blueprint "${blueprint.id}" is not a workflow blueprint (workflowNodes is empty). ` +
+            `Use 'af agent init' or 'af workforce init' instead.`);
+    }
+    const warnings = [];
+    const missingConnections = [];
+    const nodes = blueprint.workflowNodes.map((spec) => {
+        const needsLLMConnection = spec.nodeType === "llm";
+        let connection = null;
+        if (needsLLMConnection) {
+            if (options.llmConnectionId) {
+                connection = `{{__app_connections__['${options.llmConnectionId}']}}`;
+            }
+            else {
+                missingConnections.push("llm-provider (straico/openai/anthropic/etc.)");
+            }
+        }
+        return {
+            name: spec.name,
+            title: spec.title ?? spec.name,
+            description: spec.description ?? `${spec.nodeType} node`,
+            node_type_name: spec.nodeType,
+            input_config: spec.inputConfig ?? {},
+            output_mapping: spec.outputMapping ?? null,
+            connection,
+            cost: null,
+            metadata: null,
+        };
+    });
+    if (missingConnections.length > 0) {
+        warnings.push(`This workflow needs a connection: ${missingConnections.join(", ")}. ` +
+            `Create one in the UI (Connections → New) or via \`af connections create\`, then re-run init.`);
+    }
+    // Compose input schema from blueprint.workflowInputSchema
+    const schemaSpec = blueprint.workflowInputSchema;
+    const properties = {};
+    const required = [];
+    let schemaTitle = schemaSpec?.title ?? "Workflow inputs";
+    if (schemaSpec) {
+        schemaSpec.fields.forEach((f, idx) => {
+            properties[f.name] = {
+                type: "string",
+                title: f.title ?? f.name,
+                description: f.description ?? "",
+                ui_metadata: {
+                    type: "long_text",
+                    order: idx,
+                    value: f.defaultValue ?? null,
+                },
+            };
+            if (f.required)
+                required.push(f.name);
+        });
+    }
+    const payload = {
+        name: options.workflowName ?? blueprint.name,
+        description: blueprint.description,
+        project_id: options.projectId,
+        nodes,
+        input_schema: {
+            type: "object",
+            title: schemaTitle,
+            required,
+            properties,
+        },
+        output_mapping: {},
+    };
+    const suggested_next_steps = [
+        `af workflow run --workflow-id <id> --body '{"input":{...}}' --json  # run the workflow`,
+        `af workflow get --workflow-id <id> --json  # inspect what was created`,
+    ];
+    return {
+        payload,
+        warnings,
+        missing_connections: missingConnections,
+        suggested_next_steps,
+    };
+}
+//# sourceMappingURL=blueprint-to-workflow.js.map

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

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

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;;;;;;;;;;;;;;;;;;;;;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,CAmG1F"}
+{"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,CA+Cb;AAwDD;;;;;;;;;;;;;;;;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,CAsK1F"}