patchwork-os 0.2.0-alpha.3 → 0.2.0-alpha.31

package/dist/recipes/dependencyGraph.js

@@ -0,0 +1,199 @@
+/**
+ * DependencyGraph — builds and executes recipe step dependencies.
+ *
+ * Supports:
+ *   - Parallel execution up to maxConcurrency
+ *   - Explicit dependencies (awaits: [stepA, stepB])
+ *   - Conditional execution (when: condition)
+ *   - Cycle detection
+ */
+/** Build dependency graph from step definitions */
+export function buildDependencyGraph(steps) {
+    const nodes = steps.map((s, index) => ({
+        stepId: s.id,
+        awaits: s.awaits ?? [],
+        index,
+    }));
+    // Detect cycles using DFS
+    const visited = new Set();
+    const visiting = new Set();
+    const cycles = [];
+    function visit(node, path) {
+        if (visiting.has(node.stepId)) {
+            // Found cycle - extract cycle from path
+            const cycleStart = path.indexOf(node.stepId);
+            cycles.push(path.slice(cycleStart).concat(node.stepId));
+            return;
+        }
+        if (visited.has(node.stepId))
+            return;
+        visiting.add(node.stepId);
+        path.push(node.stepId);
+        for (const depId of node.awaits) {
+            const dep = nodes.find((n) => n.stepId === depId);
+            if (dep)
+                visit(dep, path);
+        }
+        path.pop();
+        visiting.delete(node.stepId);
+        visited.add(node.stepId);
+    }
+    for (const node of nodes) {
+        if (!visited.has(node.stepId)) {
+            visit(node, []);
+        }
+    }
+    // Calculate topological order (Kahn's algorithm)
+    const inDegree = new Map();
+    const adjacency = new Map();
+    for (const node of nodes) {
+        inDegree.set(node.stepId, node.awaits.length);
+        for (const dep of node.awaits) {
+            if (!adjacency.has(dep))
+                adjacency.set(dep, []);
+            adjacency.get(dep)?.push(node.stepId);
+        }
+    }
+    const queue = [];
+    for (const [stepId, degree] of inDegree) {
+        if (degree === 0)
+            queue.push(stepId);
+    }
+    const topologicalOrder = [];
+    while (queue.length > 0) {
+        const stepId = queue.shift();
+        topologicalOrder.push(stepId);
+        const dependents = adjacency.get(stepId) ?? [];
+        for (const dep of dependents) {
+            const newDegree = (inDegree.get(dep) ?? 0) - 1;
+            inDegree.set(dep, newDegree);
+            if (newDegree === 0)
+                queue.push(dep);
+        }
+    }
+    return {
+        steps: nodes,
+        hasCycles: cycles.length > 0,
+        topologicalOrder,
+    };
+}
+/** Format cycle for error message */
+export function formatCycle(cycles) {
+    if (cycles.length === 0)
+        return "No cycles detected";
+    return cycles
+        .map((cycle, i) => `  Cycle ${i + 1}: ${cycle.join(" → ")}`)
+        .join("\n");
+}
+/** Execute steps respecting dependencies with limited concurrency */
+export async function executeWithDependencies(graph, executeStep, options) {
+    if (graph.hasCycles) {
+        throw new Error(`Dependency graph has cycles - cannot execute`);
+    }
+    const results = new Map();
+    const completed = new Set();
+    const failed = new Set(); // C1: track which completed steps failed
+    const inProgress = new Set();
+    // Store resolver functions to signal when steps complete
+    const resolvers = new Map();
+    // Track which steps are waiting for which dependencies
+    const waitingFor = new Map();
+    for (const node of graph.steps) {
+        waitingFor.set(node.stepId, [...node.awaits]);
+    }
+    function waitForStep(stepId) {
+        if (completed.has(stepId))
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            const list = resolvers.get(stepId);
+            if (list) {
+                list.push(resolve);
+            }
+            else {
+                resolvers.set(stepId, [resolve]);
+            }
+        });
+    }
+    async function runStep(stepId) {
+        if (inProgress.has(stepId) || completed.has(stepId))
+            return;
+        // Check if all dependencies are satisfied
+        const deps = waitingFor.get(stepId) ?? [];
+        const unresolved = deps.filter((d) => !completed.has(d));
+        if (unresolved.length > 0) {
+            await Promise.all(unresolved.map(waitForStep));
+        }
+        // C1: skip if any upstream dependency failed
+        const failedDep = deps.find((d) => failed.has(d));
+        if (failedDep) {
+            const err = new Error(`Skipped: upstream step "${failedDep}" failed`);
+            results.set(stepId, { success: false, error: err });
+            completed.add(stepId);
+            failed.add(stepId);
+            options.onStepComplete?.(stepId, err);
+            // Unblock any steps waiting on this one
+            const waiting = resolvers.get(stepId) ?? [];
+            for (const resolve of waiting)
+                resolve();
+            resolvers.delete(stepId);
+            return;
+        }
+        inProgress.add(stepId);
+        options.onStepStart?.(stepId);
+        let stepErr;
+        try {
+            await executeStep(stepId);
+            results.set(stepId, { success: true });
+            completed.add(stepId);
+        }
+        catch (error) {
+            stepErr = error instanceof Error ? error : new Error(String(error));
+            results.set(stepId, { success: false, error: stepErr });
+            completed.add(stepId);
+            failed.add(stepId); // C1: record failure so dependents are skipped
+        }
+        finally {
+            options.onStepComplete?.(stepId, stepErr);
+            inProgress.delete(stepId);
+            // Signal dependents
+            const waiting = resolvers.get(stepId) ?? [];
+            for (const resolve of waiting) {
+                resolve();
+            }
+            resolvers.delete(stepId);
+        }
+    }
+    // Execute with concurrency limit
+    const executing = [];
+    const queue = [...graph.topologicalOrder];
+    async function processQueue() {
+        while (queue.length > 0 || executing.length > 0) {
+            // Start new steps if under concurrency limit
+            while (executing.length < options.maxConcurrency && queue.length > 0) {
+                const stepId = queue.shift();
+                // C2: push before attaching .then() so indexOf is never -1
+                let resolveSlot;
+                const slot = new Promise((r) => {
+                    resolveSlot = r;
+                });
+                executing.push(slot);
+                runStep(stepId).then(() => {
+                    executing.splice(executing.indexOf(slot), 1);
+                    resolveSlot();
+                });
+            }
+            if (executing.length > 0) {
+                await Promise.race(executing);
+            }
+        }
+    }
+    await processQueue();
+    return results;
+}
+/** Get steps that can run immediately (no unresolved dependencies) */
+export function getReadySteps(graph, completed) {
+    return graph.steps
+        .filter((s) => !completed.has(s.stepId) && s.awaits.every((dep) => completed.has(dep)))
+        .map((s) => s.stepId);
+}
+//# sourceMappingURL=dependencyGraph.js.map

package/dist/recipes/dependencyGraph.js.map

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

package/dist/recipes/legacyRecipeCompat.d.ts

@@ -0,0 +1,2 @@
+export type WarnFn = (msg: string) => void;
+export declare function normalizeRecipeForRuntime(recipe: unknown, warn?: WarnFn): unknown;

package/dist/recipes/legacyRecipeCompat.js

@@ -0,0 +1,112 @@
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function normalizeRecipeForRuntime(recipe, warn) {
+    if (!isRecord(recipe)) {
+        return recipe;
+    }
+    const normalized = {
+        ...recipe,
+    };
+    if (isRecord(normalized.trigger)) {
+        normalized.trigger = normalizeLegacyTriggerForRuntime(normalized.trigger, warn);
+    }
+    if (Array.isArray(normalized.steps)) {
+        normalized.steps = normalized.steps.map((step) => normalizeLegacyRuntimeStep(step, warn));
+    }
+    return normalized;
+}
+function normalizeLegacyTriggerForRuntime(trigger, warn) {
+    const normalized = { ...trigger };
+    if (normalized.type === "cron" &&
+        typeof normalized.schedule === "string" &&
+        typeof normalized.at !== "string") {
+        warn?.("Deprecated recipe field: trigger.schedule — rename to trigger.at (will be removed in a future major version)");
+        normalized.at = normalized.schedule;
+    }
+    delete normalized.schedule;
+    return normalized;
+}
+function normalizeLegacyRuntimeStep(step, warn) {
+    if (!isRecord(step)) {
+        return step;
+    }
+    const normalized = {};
+    for (const [key, value] of Object.entries(step)) {
+        if (key === "params" || key === "output" || key === "prompt") {
+            continue;
+        }
+        if (key === "agent" && typeof value === "boolean") {
+            continue;
+        }
+        if (key === "parallel" && Array.isArray(value)) {
+            normalized.parallel = value.map((entry) => normalizeLegacyRuntimeStep(entry, warn));
+            continue;
+        }
+        if (key === "branch" && Array.isArray(value)) {
+            normalized.branch = value.map((entry) => normalizeLegacyBranchEntry(entry, warn));
+            continue;
+        }
+        normalized[key] = value;
+    }
+    if (step.agent === true || isRecord(step.agent)) {
+        const agentConfig = isRecord(step.agent)
+            ? { ...step.agent }
+            : {};
+        if (typeof step.prompt === "string" &&
+            typeof agentConfig.prompt !== "string") {
+            warn?.("Deprecated recipe step field: prompt at step level — move to step.agent.prompt (will be removed in a future major version)");
+            agentConfig.prompt = step.prompt;
+        }
+        if (typeof step.output === "string" &&
+            typeof agentConfig.into !== "string") {
+            warn?.("Deprecated recipe step field: output — use step.agent.into instead (will be removed in a future major version)");
+            agentConfig.into = step.output;
+        }
+        if (step.agent === true) {
+            warn?.("Deprecated recipe step field: agent: true — use agent: { prompt, into } object instead (will be removed in a future major version)");
+        }
+        normalized.agent = agentConfig;
+        return normalized;
+    }
+    if (isRecord(step.params)) {
+        warn?.("Deprecated recipe step field: params — inline fields directly on the step (will be removed in a future major version)");
+        Object.assign(normalized, step.params);
+    }
+    if (typeof normalized.recipe !== "string" &&
+        typeof normalized.chain === "string") {
+        warn?.("Deprecated recipe step field: chain — rename to recipe (will be removed in a future major version)");
+        normalized.recipe = normalized.chain;
+    }
+    delete normalized.chain;
+    if (typeof normalized.into !== "string" && typeof step.output === "string") {
+        warn?.("Deprecated recipe step field: output — rename to into (will be removed in a future major version)");
+        normalized.into = step.output;
+    }
+    if (normalized.tool === "file.append" &&
+        typeof normalized.content !== "string" &&
+        typeof normalized.line === "string") {
+        warn?.("Deprecated recipe step field: line (file.append) — rename to content (will be removed in a future major version)");
+        normalized.content = normalized.line;
+        delete normalized.line;
+    }
+    return normalized;
+}
+function normalizeLegacyBranchEntry(entry, warn) {
+    if (!isRecord(entry)) {
+        return entry;
+    }
+    const normalized = {};
+    for (const [key, value] of Object.entries(entry)) {
+        if (key === "otherwise" && isRecord(value)) {
+            normalized.otherwise = normalizeLegacyRuntimeStep(value, warn);
+            continue;
+        }
+        normalized[key] = value;
+    }
+    if (Object.hasOwn(normalized, "otherwise")) {
+        return normalized;
+    }
+    return normalizeLegacyRuntimeStep(entry, warn);
+}
+//# sourceMappingURL=legacyRecipeCompat.js.map

package/dist/recipes/legacyRecipeCompat.js.map

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

package/dist/recipes/manifest.d.ts

@@ -0,0 +1,47 @@
+/**
+ * RecipeManifest — recipe.json format for the Patchwork recipe marketplace.
+ *
+ * Each recipe package directory contains a recipe.json manifest describing
+ * the package metadata, entry-point recipe file, child recipes, required
+ * connectors, and configurable variables.
+ */
+export interface RecipeManifest {
+    name: string;
+    version: string;
+    description: string;
+    author?: string;
+    license?: string;
+    tags?: string[];
+    connectors?: string[];
+    recipes: {
+        main: string;
+        children?: string[];
+    };
+    variables?: Record<string, {
+        description: string;
+        required?: boolean;
+        default?: string;
+    }>;
+    homepage?: string;
+    repository?: string;
+}
+/**
+ * Validate an unknown value as a RecipeManifest.
+ * Throws a descriptive Error if any required field is missing or invalid.
+ */
+export declare function validateManifest(manifest: unknown): RecipeManifest;
+/**
+ * Parse and validate a recipe.json string.
+ * Throws with a clear error message if invalid JSON or schema violations.
+ */
+export declare function parseManifest(json: string): RecipeManifest;
+/**
+ * Load and parse recipe.json from a directory.
+ * Returns null if the file does not exist (not a recipe package dir).
+ * Throws if file exists but is invalid.
+ */
+export declare function loadManifestFromDir(dir: string): RecipeManifest | null;
+/**
+ * Returns all recipe filenames declared in the manifest: [main, ...children].
+ */
+export declare function getManifestRecipeFiles(manifest: RecipeManifest): string[];

package/dist/recipes/manifest.js

@@ -0,0 +1,141 @@
+/**
+ * RecipeManifest — recipe.json format for the Patchwork recipe marketplace.
+ *
+ * Each recipe package directory contains a recipe.json manifest describing
+ * the package metadata, entry-point recipe file, child recipes, required
+ * connectors, and configurable variables.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+const NAME_RE = /^(@[a-z0-9-]+\/)?[a-z0-9][a-z0-9\-_.]*$/;
+const VERSION_RE = /^\d+\.\d+\.\d+/;
+const YAML_EXT_RE = /\.ya?ml$/;
+function isYamlFile(filename) {
+    return typeof filename === "string" && YAML_EXT_RE.test(filename);
+}
+/**
+ * Validate an unknown value as a RecipeManifest.
+ * Throws a descriptive Error if any required field is missing or invalid.
+ */
+export function validateManifest(manifest) {
+    if (typeof manifest !== "object" || manifest === null) {
+        throw new Error("recipe.json must be a JSON object");
+    }
+    const m = manifest;
+    // name
+    if (typeof m.name !== "string" || !m.name) {
+        throw new Error('recipe.json: "name" is required and must be a string');
+    }
+    if (!NAME_RE.test(m.name)) {
+        throw new Error(`recipe.json: "name" must match pattern (@scope/)?[a-z0-9][a-z0-9-_.]*  — got "${m.name}"`);
+    }
+    // version
+    if (typeof m.version !== "string" || !m.version) {
+        throw new Error('recipe.json: "version" is required and must be a string');
+    }
+    if (!VERSION_RE.test(m.version)) {
+        throw new Error(`recipe.json: "version" must be valid semver (e.g. "1.0.0") — got "${m.version}"`);
+    }
+    // description
+    if (typeof m.description !== "string" || !m.description) {
+        throw new Error('recipe.json: "description" is required and must be a non-empty string');
+    }
+    // recipes
+    if (typeof m.recipes !== "object" || m.recipes === null) {
+        throw new Error('recipe.json: "recipes" is required and must be an object');
+    }
+    const recipes = m.recipes;
+    if (!isYamlFile(recipes.main)) {
+        throw new Error(`recipe.json: "recipes.main" must be a .yaml or .yml filename — got "${recipes.main}"`);
+    }
+    if (recipes.children !== undefined) {
+        if (!Array.isArray(recipes.children)) {
+            throw new Error('recipe.json: "recipes.children" must be an array');
+        }
+        for (let i = 0; i < recipes.children.length; i++) {
+            if (!isYamlFile(recipes.children[i])) {
+                throw new Error(`recipe.json: "recipes.children[${i}]" must be a .yaml or .yml filename — got "${recipes.children[i]}"`);
+            }
+        }
+    }
+    // optional string fields
+    for (const field of [
+        "author",
+        "license",
+        "homepage",
+        "repository",
+    ]) {
+        if (m[field] !== undefined && typeof m[field] !== "string") {
+            throw new Error(`recipe.json: "${field}" must be a string`);
+        }
+    }
+    // optional string[] fields
+    for (const field of ["tags", "connectors"]) {
+        if (m[field] !== undefined) {
+            if (!Array.isArray(m[field])) {
+                throw new Error(`recipe.json: "${field}" must be an array of strings`);
+            }
+            for (let i = 0; i < m[field].length; i++) {
+                if (typeof m[field][i] !== "string") {
+                    throw new Error(`recipe.json: "${field}[${i}]" must be a string`);
+                }
+            }
+        }
+    }
+    // variables
+    if (m.variables !== undefined) {
+        if (typeof m.variables !== "object" || m.variables === null) {
+            throw new Error('recipe.json: "variables" must be an object');
+        }
+        for (const [key, val] of Object.entries(m.variables)) {
+            if (typeof val !== "object" || val === null) {
+                throw new Error(`recipe.json: "variables.${key}" must be an object with a "description" field`);
+            }
+            const v = val;
+            if (typeof v.description !== "string" || !v.description) {
+                throw new Error(`recipe.json: "variables.${key}.description" is required and must be a non-empty string`);
+            }
+            if (v.required !== undefined && typeof v.required !== "boolean") {
+                throw new Error(`recipe.json: "variables.${key}.required" must be a boolean`);
+            }
+            if (v.default !== undefined && typeof v.default !== "string") {
+                throw new Error(`recipe.json: "variables.${key}.default" must be a string`);
+            }
+        }
+    }
+    return m;
+}
+/**
+ * Parse and validate a recipe.json string.
+ * Throws with a clear error message if invalid JSON or schema violations.
+ */
+export function parseManifest(json) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch (err) {
+        throw new Error(`recipe.json: invalid JSON — ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return validateManifest(parsed);
+}
+/**
+ * Load and parse recipe.json from a directory.
+ * Returns null if the file does not exist (not a recipe package dir).
+ * Throws if file exists but is invalid.
+ */
+export function loadManifestFromDir(dir) {
+    const manifestPath = path.join(dir, "recipe.json");
+    if (!existsSync(manifestPath)) {
+        return null;
+    }
+    const raw = readFileSync(manifestPath, "utf-8");
+    return parseManifest(raw);
+}
+/**
+ * Returns all recipe filenames declared in the manifest: [main, ...children].
+ */
+export function getManifestRecipeFiles(manifest) {
+    return [manifest.recipes.main, ...(manifest.recipes.children ?? [])];
+}
+//# sourceMappingURL=manifest.js.map

package/dist/recipes/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/recipes/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AA0B7B,MAAM,OAAO,GAAG,yCAAyC,CAAC;AAC1D,MAAM,UAAU,GAAG,gBAAgB,CAAC;AACpC,MAAM,WAAW,GAAG,UAAU,CAAC;AAE/B,SAAS,UAAU,CAAC,QAAiB;IACnC,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,GAAG,QAAmC,CAAC;IAE9C,OAAO;IACP,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,iFAAiF,CAAC,CAAC,IAAI,GAAG,CAC3F,CAAC;IACJ,CAAC;IAED,UAAU;IACV,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,qEAAqE,CAAC,CAAC,OAAO,GAAG,CAClF,CAAC;IACJ,CAAC;IAED,cAAc;IACd,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,UAAU;IACV,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAkC,CAAC;IAErD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,uEAAuE,OAAO,CAAC,IAAI,GAAG,CACvF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CACb,kCAAkC,CAAC,8CAA8C,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CACxG,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,KAAK,MAAM,KAAK,IAAI;QAClB,QAAQ;QACR,SAAS;QACT,UAAU;QACV,YAAY;KACJ,EAAE,CAAC;QACX,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,oBAAoB,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,KAAK,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,YAAY,CAAU,EAAE,CAAC;QACpD,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,+BAA+B,CAAC,CAAC;YACzE,CAAC;YACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAI,CAAC,CAAC,KAAK,CAAe,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxD,IAAI,OAAQ,CAAC,CAAC,KAAK,CAAe,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;oBACnD,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,IAAI,CAAC,qBAAqB,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,YAAY;IACZ,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CACrC,CAAC,CAAC,SAAoC,CACvC,EAAE,CAAC;YACF,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,gDAAgD,CAC/E,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,GAAG,GAA8B,CAAC;YACzC,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;gBACxD,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,0DAA0D,CACzF,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAChE,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,8BAA8B,CAC7D,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC7D,MAAM,IAAI,KAAK,CACb,2BAA2B,GAAG,4BAA4B,CAC3D,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAA8B,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,+BAA+B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAwB;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/recipes/nestedRecipeStep.d.ts

@@ -0,0 +1,58 @@
+/**
+ * NestedRecipeStep — handler for calling recipes from within recipes.
+ *
+ * Supports:
+ *   - Variable passing via template resolution
+ *   - Isolated OutputRegistry for child
+ *   - Risk escalation (child risk > parent risk uses child's)
+ *   - Depth limiting (prevent infinite recursion)
+ */
+import type { OutputRegistry } from "./outputRegistry.js";
+import type { TemplateContext, TemplateError } from "./templateEngine.js";
+export interface NestedRecipeConfig {
+    recipe: string;
+    vars: Record<string, string>;
+    output?: string;
+    risk?: "low" | "medium" | "high";
+    id: string;
+}
+export interface NestedRecipeContext {
+    parentRegistry: OutputRegistry;
+    parentEnv: Record<string, string | undefined>;
+    recipeMaxDepth: number;
+    currentDepth: number;
+    dryRun: boolean;
+}
+export interface NestedRecipeResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    childOutputs?: Record<string, unknown>;
+}
+export interface RecipeLoader {
+    loadRecipe(name: string): Promise<{
+        steps: unknown[];
+    } | null>;
+}
+/** Resolve template variables against parent context */
+export declare function resolveNestedVars(vars: Record<string, string>, context: TemplateContext): {
+    resolved: Record<string, string>;
+    errors: TemplateError[];
+};
+/** Validate nested recipe call before execution */
+export declare function validateNestedRecipe(config: NestedRecipeConfig, context: NestedRecipeContext): {
+    valid: boolean;
+    error?: string;
+};
+/** Calculate effective risk tier */
+export declare function calculateNestedRisk(parentRisk: "low" | "medium" | "high" | undefined, childRisk: "low" | "medium" | "high" | undefined): "low" | "medium" | "high";
+/** Format nested recipe result for parent registry */
+export declare function formatNestedOutput(result: NestedRecipeResult, config: NestedRecipeConfig): {
+    stepId: string;
+    output: {
+        status: "success" | "error" | "skipped";
+        data: unknown;
+    };
+};
+/** Mock nested recipe execution for dry-run mode */
+export declare function mockNestedRecipe(config: NestedRecipeConfig, context: NestedRecipeContext): Promise<NestedRecipeResult>;