@farmslot/recipe-runner 0.23.0

package/dist/cli/support.js

@@ -0,0 +1,297 @@
+import { readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { applyRecipeParamDefaults, digestRecipeDocument, isRecord, mergeRecipeValidationResults, resolvedRecipeArtifactPath, validateArtifactManifestDocument, validateRecipeArtifactPackage, validateRecipeDocument, validateRecipeParams, validateRecipeWithManifest, } from '@farmslot/protocol';
+import { resolveRecipeDependencies, rootResolutionRef, validateRecipeDependencyParams, } from '../core/compose.js';
+import { recordedRecipeParams } from '../core/invocation.js';
+import { loadRecipeLibraries } from '../core/library.js';
+import { readFileWithinRoot } from '../core/path.js';
+import { RecipeResolutionError } from '../core/resolution-error.js';
+export function recipeCliBaseDir() {
+    return process.env.INIT_CWD ?? process.cwd();
+}
+export function resolveRecipeCliPath(filePath, baseDir = recipeCliBaseDir()) {
+    return path.resolve(baseDir, filePath);
+}
+export function parsePositiveInteger(value) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`Expected a positive integer, got ${JSON.stringify(value)}.`);
+    }
+    return parsed;
+}
+export function parseRecipeParamAssignments(values) {
+    const params = {};
+    for (const value of values) {
+        const separator = value.indexOf('=');
+        if (separator <= 0) {
+            throw new Error(`Recipe parameter ${JSON.stringify(value)} must use key=value.`);
+        }
+        const key = value.slice(0, separator).trim();
+        if (!key || Object.hasOwn(params, key)) {
+            throw new Error(Object.hasOwn(params, key)
+                ? `Recipe parameter ${key} was provided more than once.`
+                : `Recipe parameter ${JSON.stringify(value)} has an empty key.`);
+        }
+        const raw = value.slice(separator + 1);
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            parsed = raw;
+        }
+        Object.defineProperty(params, key, {
+            value: parsed,
+            enumerable: true,
+            configurable: true,
+            writable: true,
+        });
+    }
+    return params;
+}
+export function parseRecordingTarget(options) {
+    if (options.recordPid)
+        return { kind: 'pid', pid: parsePositiveInteger(options.recordPid) };
+    if (options.recordWindowId)
+        return { kind: 'window-id', windowId: options.recordWindowId };
+    if (options.recordAppName || options.recordWindowName) {
+        if (!options.recordAppName || !options.recordWindowName) {
+            throw new Error('--record-app-name and --record-window-name must be provided together.');
+        }
+        return {
+            kind: 'app-window',
+            appName: options.recordAppName,
+            windowName: options.recordWindowName,
+        };
+    }
+    return undefined;
+}
+export async function readRecipeCliJsonFile(filePath, baseDir = recipeCliBaseDir()) {
+    const resolvedPath = resolveRecipeCliPath(filePath, baseDir);
+    let text;
+    try {
+        text = await readFile(resolvedPath, 'utf-8');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read JSON from ${filePath}: ${message}`);
+    }
+    return parseRecipeCliJsonText(filePath, text);
+}
+export async function readRecipeCliJsonFileWithinRoot(root, relativePath) {
+    let text;
+    try {
+        text = (await readFileWithinRoot(root, relativePath)).toString('utf-8');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read JSON from ${relativePath}: ${message}`, { cause: error });
+    }
+    return parseRecipeCliJsonText(relativePath, text);
+}
+async function readOptionalRecipeCliJsonFileWithinRoot(root, relativePath) {
+    try {
+        return await readRecipeCliJsonFileWithinRoot(root, relativePath);
+    }
+    catch (error) {
+        if (error?.cause?.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+function parseRecipeCliJsonText(filePath, text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to parse JSON from ${filePath}: ${message}`);
+    }
+}
+export async function validateRecipeCliInput({ recipePath, actionManifestPath, adapter, artifactManifestPath, artifactDir, baseDir = recipeCliBaseDir(), librarySources, params = {}, packageVersions, }) {
+    const recipe = await readRecipeCliJsonFile(recipePath, baseDir);
+    const results = [];
+    const artifactRoot = artifactDir ? resolveRecipeCliPath(artifactDir, baseDir) : undefined;
+    const artifactPaths = artifactRoot ? await listRelativeRecipeCliFiles(artifactRoot) : undefined;
+    const recipeResolution = artifactRoot
+        ? await readOptionalRecipeCliJsonFileWithinRoot(artifactRoot, 'recipe-resolution.json')
+        : undefined;
+    const trace = artifactRoot
+        ? await readOptionalRecipeCliJsonFileWithinRoot(artifactRoot, 'trace.json')
+        : undefined;
+    const summary = artifactRoot
+        ? await readOptionalRecipeCliJsonFileWithinRoot(artifactRoot, 'summary.json')
+        : undefined;
+    const invocation = artifactRoot
+        ? await readOptionalRecipeCliJsonFileWithinRoot(artifactRoot, 'recipe-invocation.json')
+        : undefined;
+    let effectiveParams = isRecord(recipe)
+        ? applyRecipeParamDefaults(params, recipe.paramsSchema)
+        : params;
+    if (invocation !== undefined || (isRecord(summary) && summary.invocationDigest !== undefined)) {
+        try {
+            const recorded = recordedRecipeParams(recipe, invocation, summary);
+            if (Object.keys(params).length &&
+                digestRecipeDocument(effectiveParams) !== digestRecipeDocument(recorded)) {
+                throw new Error('Supplied parameters differ from the recorded execution inputs.');
+            }
+            effectiveParams = recorded;
+        }
+        catch (error) {
+            results.push({
+                status: 'invalid',
+                findings: [
+                    {
+                        severity: 'error',
+                        code: 'recipe.invalid_invocation',
+                        path: 'recipe-invocation.json',
+                        message: error instanceof Error ? error.message : 'Invalid recorded invocation.',
+                    },
+                ],
+                summary: { errors: 1, warnings: 0 },
+            });
+        }
+    }
+    if (isRecord(recipe))
+        results.push(validateRecipeParams(effectiveParams, recipe.paramsSchema));
+    const resolvedRecipes = {};
+    if (artifactRoot && isRecord(recipeResolution) && Array.isArray(recipeResolution.dependencies)) {
+        for (const dependency of recipeResolution.dependencies) {
+            if (!isRecord(dependency))
+                continue;
+            const artifact = resolvedRecipeArtifactPath(dependency.digest);
+            if (!artifact)
+                continue;
+            const document = await readOptionalRecipeCliJsonFileWithinRoot(artifactRoot, artifact);
+            if (document !== undefined)
+                resolvedRecipes[String(dependency.digest)] = document;
+        }
+    }
+    const libraryResolution = librarySources && librarySources.length > 0
+        ? await loadRecipeLibraries(librarySources, {
+            ...(adapter ? { adapter } : {}),
+            ...(packageVersions ? { packageVersions } : {}),
+        })
+        : undefined;
+    const externalRecipeIds = new Set(libraryResolution?.recipes.keys() ?? []);
+    if (isRecord(recipeResolution) && Array.isArray(recipeResolution.dependencies)) {
+        for (const dependency of recipeResolution.dependencies) {
+            if (isRecord(dependency) && typeof dependency.ref === 'string') {
+                externalRecipeIds.add(dependency.ref);
+            }
+        }
+    }
+    const validationOptions = externalRecipeIds.size > 0 || adapter ? { externalRecipeIds, adapter } : undefined;
+    if (actionManifestPath) {
+        const actionManifest = await readRecipeCliJsonFile(actionManifestPath, baseDir);
+        results.push(validateRecipeWithManifest(recipe, actionManifest, validationOptions));
+    }
+    else {
+        results.push(validateRecipeDocument(recipe, validationOptions));
+    }
+    if (!artifactDir &&
+        libraryResolution &&
+        isRecord(recipe) &&
+        results.every((result) => result.status === 'valid')) {
+        try {
+            const rootDigest = digestRecipeDocument(recipe);
+            resolveRecipeDependencies({
+                rootRef: rootResolutionRef(rootDigest),
+                root: recipe,
+                rootSource: {
+                    kind: 'operator',
+                    trust: 'unknown',
+                    path: resolveRecipeCliPath(recipePath, baseDir),
+                    digest: rootDigest,
+                },
+                recipes: libraryResolution.recipes,
+            });
+            validateRecipeDependencyParams({
+                root: recipe,
+                params: effectiveParams,
+                recipes: libraryResolution.recipes,
+            });
+        }
+        catch (error) {
+            results.push({
+                status: 'invalid',
+                findings: [
+                    {
+                        severity: 'error',
+                        code: error instanceof RecipeResolutionError
+                            ? error.code.toLowerCase()
+                            : 'recipe.unresolved_dependency_graph',
+                        path: 'workflow',
+                        message: error instanceof RecipeResolutionError
+                            ? `${error.message} Next: ${error.userAction}.`
+                            : error instanceof Error
+                                ? error.message
+                                : String(error),
+                    },
+                ],
+                summary: { errors: 1, warnings: 0 },
+            });
+        }
+    }
+    const manifestPath = artifactManifestPath ??
+        (artifactDir ? path.join(artifactDir, 'artifact-manifest.json') : undefined);
+    let manifest;
+    if (manifestPath) {
+        manifest = artifactManifestPath
+            ? await readRecipeCliJsonFile(manifestPath, baseDir)
+            : await readOptionalRecipeCliJsonFileWithinRoot(artifactRoot, 'artifact-manifest.json');
+        if (manifest !== undefined && !artifactDir) {
+            results.push(validateArtifactManifestDocument(manifest, {
+                recipe,
+                artifactPaths,
+            }));
+        }
+    }
+    if (artifactDir) {
+        if ((invocation !== undefined || (isRecord(summary) && summary.invocationDigest !== undefined)) &&
+            !(isRecord(manifest) &&
+                Array.isArray(manifest.artifacts) &&
+                manifest.artifacts.some((entry) => isRecord(entry) && entry.path === 'recipe-invocation.json' && entry.type === 'json'))) {
+            results.push({
+                status: 'invalid',
+                findings: [
+                    {
+                        severity: 'error',
+                        code: 'recipe.unindexed_invocation',
+                        path: 'artifact-manifest.json',
+                        message: 'The artifact manifest must index recipe-invocation.json as a JSON artifact.',
+                    },
+                ],
+                summary: { errors: 1, warnings: 0 },
+            });
+        }
+        results.push(validateRecipeArtifactPackage({
+            recipe,
+            manifest,
+            trace,
+            summary,
+            artifactPaths,
+            resolvedRecipes,
+            recipeResolution,
+        }));
+    }
+    return mergeRecipeValidationResults(results);
+}
+async function listRelativeRecipeCliFiles(root) {
+    const output = [];
+    async function visit(relativeDir) {
+        const entries = await readdir(path.join(root, relativeDir), { withFileTypes: true });
+        for (const entry of entries) {
+            const relativePath = path.join(relativeDir, entry.name);
+            if (entry.isDirectory()) {
+                await visit(relativePath);
+            }
+            else if (entry.isFile() || entry.isSymbolicLink()) {
+                output.push(relativePath.split(path.sep).join('/'));
+            }
+        }
+    }
+    await visit('');
+    return output.sort();
+}
+//# sourceMappingURL=support.js.map

package/dist/cli/support.js.map

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

package/dist/cli/validate-command.d.ts

@@ -0,0 +1,4 @@
+import { type Command } from 'commander';
+import type { RecipeCliCommandContext } from './run-command.js';
+export declare function registerValidateCommand(program: Command, context?: RecipeCliCommandContext): void;
+//# sourceMappingURL=validate-command.d.ts.map

package/dist/cli/validate-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-command.d.ts","sourceRoot":"","sources":["../../src/cli/validate-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAYhE,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,uBAA4B,GACpC,IAAI,CAiDN"}

package/dist/cli/validate-command.js

@@ -0,0 +1,52 @@
+import { resolveRecipeLibrarySources } from '../core/library.js';
+import { isRecipeCliError, reportRecipeCliError } from './error-output.js';
+import { validateRecipeCliInput } from './support.js';
+export function registerValidateCommand(program, context = {}) {
+    program
+        .command('validate')
+        .description('Validate a recipe and optional v1 artifact package')
+        .argument('<recipe>', 'Path to recipe.json')
+        .option('--action-manifest <manifest>', 'Runner action manifest JSON')
+        .option('--adapter <name>', 'Active adapter for manifest capability validation')
+        .option('--artifact-manifest <manifest>', 'Artifact manifest JSON')
+        .option('--artifact-dir <dir>', 'Artifact package directory')
+        .option('--library <entry>', 'Recipe library source as name=path or path (repeatable; earlier wins). Same resolution as run.', collectRepeatable, [])
+        .option('--json', 'Print validation result as JSON')
+        .action(async (recipePath, options) => {
+        try {
+            const librarySources = await resolveRecipeLibrarySources({
+                cliEntries: options.library,
+                recipePath,
+            });
+            const result = await validateRecipeCliInput({
+                recipePath,
+                actionManifestPath: options.actionManifest,
+                adapter: options.adapter,
+                artifactManifestPath: options.artifactManifest,
+                artifactDir: options.artifactDir,
+                ...(librarySources.length > 0 ? { librarySources } : {}),
+                ...(context.packageVersions ? { packageVersions: context.packageVersions } : {}),
+            });
+            if (options.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                console.log(`Recipe validation: ${result.status} (${result.summary.errors} errors, ${result.summary.warnings} warnings)`);
+                for (const finding of result.findings) {
+                    console.log(`- ${finding.severity} ${finding.code} ${finding.path}: ${finding.message}`);
+                }
+            }
+            if (result.status === 'invalid')
+                process.exitCode = 1;
+        }
+        catch (error) {
+            if (!isRecipeCliError(error))
+                throw error;
+            reportRecipeCliError(error, options.json === true);
+        }
+    });
+}
+function collectRepeatable(value, previous) {
+    return [...previous, value];
+}
+//# sourceMappingURL=validate-command.js.map

package/dist/cli/validate-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-command.js","sourceRoot":"","sources":["../../src/cli/validate-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAWtD,MAAM,UAAU,uBAAuB,CACrC,OAAgB,EAChB,UAAmC,EAAE;IAErC,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,oDAAoD,CAAC;SACjE,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;SAC3C,MAAM,CAAC,8BAA8B,EAAE,6BAA6B,CAAC;SACrE,MAAM,CAAC,kBAAkB,EAAE,mDAAmD,CAAC;SAC/E,MAAM,CAAC,gCAAgC,EAAE,wBAAwB,CAAC;SAClE,MAAM,CAAC,sBAAsB,EAAE,4BAA4B,CAAC;SAC5D,MAAM,CACL,mBAAmB,EACnB,gGAAgG,EAChG,iBAAiB,EACjB,EAAc,CACf;SACA,MAAM,CAAC,QAAQ,EAAE,iCAAiC,CAAC;SACnD,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,OAA+B,EAAE,EAAE;QACpE,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,MAAM,2BAA2B,CAAC;gBACvD,UAAU,EAAE,OAAO,CAAC,OAAO;gBAC3B,UAAU;aACX,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;gBAC1C,UAAU;gBACV,kBAAkB,EAAE,OAAO,CAAC,cAAc;gBAC1C,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,oBAAoB,EAAE,OAAO,CAAC,gBAAgB;gBAC9C,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxD,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjF,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CACT,sBAAsB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,CAAC,MAAM,YAAY,MAAM,CAAC,OAAO,CAAC,QAAQ,YAAY,CAC7G,CAAC;gBACF,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,OAAO,CAAC,GAAG,CACT,KAAK,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAC5E,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YAC1C,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa,EAAE,QAAkB;IAC1D,OAAO,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/core/compose.d.ts

@@ -0,0 +1,23 @@
+import { type RecipeResolutionDocument, type RecipeResolutionEdge, type RecipeSourceProvenance } from '@farmslot/protocol';
+import type { ResolvedLibraryRecipe } from './library.js';
+export interface ResolvedRecipeDependencies {
+    recipes: ReadonlyMap<string, ResolvedLibraryRecipe>;
+    edges: RecipeResolutionEdge[];
+    document: RecipeResolutionDocument;
+}
+export declare function rootResolutionRef(digest: string): string;
+/** Validate every static call boundary after parent defaults and parameters are applied. */
+export declare function validateRecipeDependencyParams(options: {
+    root: Record<string, unknown>;
+    params: Record<string, unknown>;
+    recipes: ReadonlyMap<string, ResolvedLibraryRecipe>;
+}): void;
+/** Resolve the exact static recipe call DAG before any side effect. */
+export declare function resolveRecipeDependencies(options: {
+    rootRef: string;
+    root: Record<string, unknown>;
+    rootSource: RecipeSourceProvenance;
+    recipes: ReadonlyMap<string, ResolvedLibraryRecipe>;
+    maxDepth?: number;
+}): ResolvedRecipeDependencies;
+//# sourceMappingURL=compose.d.ts.map

package/dist/core/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/core/compose.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAE5B,MAAM,oBAAoB,CAAC;AAK5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAI1D,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACpD,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,QAAQ,EAAE,wBAAwB,CAAC;CACpC;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,4FAA4F;AAC5F,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACrD,GAAG,IAAI,CAkBP;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,UAAU,EAAE,sBAAsB,CAAC;IACnC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,0BAA0B,CAuF7B"}

package/dist/core/compose.js

@@ -0,0 +1,104 @@
+import { normalizeRecipeRef, resolvedRecipeArtifactPath, } from '@farmslot/protocol';
+import { DEFAULT_MAX_RECIPE_CALL_DEPTH } from './execution.js';
+import { extractWorkflowGraph } from './graph.js';
+import { isRecord } from './json.js';
+import { resolveRecipeParams, resolveRecipeValue } from './parameters.js';
+import { RecipeResolutionError } from './resolution-error.js';
+export function rootResolutionRef(digest) {
+    return `$root:${digest}`;
+}
+/** Validate every static call boundary after parent defaults and parameters are applied. */
+export function validateRecipeDependencyParams(options) {
+    const visit = (document, params) => {
+        for (const rawNode of Object.values(extractWorkflowGraph(document).nodes)) {
+            if (rawNode.action !== 'call' || typeof rawNode.ref !== 'string')
+                continue;
+            const ref = normalizeRecipeRef(rawNode.ref);
+            const dependency = options.recipes.get(ref);
+            if (!dependency)
+                continue;
+            const node = resolveRecipeValue(rawNode, params);
+            const childParams = resolveRecipeParams(ref, dependency.document, isRecord(node) && isRecord(node.params) ? node.params : {}, { allowTemplates: true });
+            visit(dependency.document, childParams);
+        }
+    };
+    visit(options.root, options.params);
+}
+/** Resolve the exact static recipe call DAG before any side effect. */
+export function resolveRecipeDependencies(options) {
+    const maxDepth = options.maxDepth ?? DEFAULT_MAX_RECIPE_CALL_DEPTH;
+    const resolved = new Map();
+    const edges = [];
+    const visiting = [];
+    const visited = new Set();
+    const visit = (from, document, depth) => {
+        if (depth >= maxDepth) {
+            throw new RecipeResolutionError('RECIPE_CALL_DEPTH_EXCEEDED', `Recipe call depth exceeded maximum ${maxDepth}.`, `reduce nested recipe calls below ${maxDepth}`);
+        }
+        for (const ref of callRefs(document)) {
+            edges.push({ from, to: ref });
+            const cycleStart = visiting.indexOf(ref);
+            if (cycleStart >= 0 || ref === options.rootRef) {
+                const cycle = [...visiting.slice(Math.max(cycleStart, 0)), ref];
+                throw new RecipeResolutionError('RECIPE_CALL_CYCLE', `Recipe call cycle detected: ${cycle.join(' -> ')}.`, 'remove one call edge so the recipe dependency graph is acyclic');
+            }
+            const dependency = options.recipes.get(ref);
+            if (!dependency) {
+                throw new RecipeResolutionError('RECIPE_REFERENCE_NOT_FOUND', `Recipe ${ref} is not available from configured libraries.`, `add ${ref} to a configured recipe library or correct call.ref`);
+            }
+            resolved.set(ref, dependency);
+            if (visited.has(ref))
+                continue;
+            visiting.push(ref);
+            visit(ref, dependency.document, depth + 1);
+            visiting.pop();
+            visited.add(ref);
+        }
+    };
+    visiting.push(options.rootRef);
+    visit(options.rootRef, options.root, 0);
+    visiting.pop();
+    const rootDigest = options.rootSource.digest;
+    if (!rootDigest) {
+        throw new RecipeResolutionError('RECIPE_RESOLUTION_DIGEST_MISSING', 'Resolved root recipe source is missing its content digest.', 'reload the root recipe through the runner so its digest is computed');
+    }
+    const dependencies = [...resolved.values()]
+        .sort((left, right) => compareStrings(left.ref, right.ref))
+        .map((recipe) => {
+        const digest = recipe.provenance.digest;
+        if (!digest) {
+            throw new RecipeResolutionError('RECIPE_RESOLUTION_DIGEST_MISSING', `Resolved recipe ${recipe.ref} is missing its content digest.`, `reload ${recipe.ref} through the library resolver so its digest is computed`);
+        }
+        return {
+            ref: recipe.ref,
+            source: recipe.source,
+            file: recipe.file,
+            digest,
+            artifact: resolvedRecipeArtifactPath(digest),
+            ...(recipe.adapter ? { adapter: recipe.adapter } : {}),
+        };
+    });
+    return {
+        recipes: resolved,
+        edges,
+        document: {
+            schema_version: 1,
+            root: { ref: options.rootRef, digest: rootDigest },
+            dependencies,
+            edges: [...edges].sort((left, right) => compareStrings(`${left.from}:${left.to}`, `${right.from}:${right.to}`)),
+        },
+    };
+}
+function compareStrings(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function callRefs(recipe) {
+    const refs = [];
+    for (const node of Object.values(extractWorkflowGraph(recipe).nodes)) {
+        if (node.action === 'call' && typeof node.ref === 'string' && node.ref.trim()) {
+            refs.push(normalizeRecipeRef(node.ref));
+        }
+    }
+    return refs;
+}
+//# sourceMappingURL=compose.js.map

package/dist/core/compose.js.map

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

package/dist/core/execution.d.ts

@@ -0,0 +1,44 @@
+import { type RecipeActionManifestDocument, type RecipeFailureCause } from '@farmslot/protocol';
+import type { ResolvedLibraryRecipe } from './library.js';
+import { type DefaultObserverRefs } from './passive-observations.js';
+import type { ActionAdapter, ActionExecutionContext, ActionResult, RecipeLogger, RecipeRunStatus, TraceWriter } from './types.js';
+export declare const DEFAULT_MAX_RECIPE_CALL_DEPTH = 8;
+type HudPublisher = (status: 'running' | 'pass' | 'fail', event: {
+    nodeId: string;
+    action: string;
+    node: Record<string, unknown>;
+    recipe: unknown;
+    index: number;
+    total: number;
+    context: ActionExecutionContext;
+    error?: string;
+}) => Promise<boolean>;
+export interface ExecuteRecipeOptions {
+    ref: string;
+    adapter?: string;
+    recipe: Record<string, unknown>;
+    params: Record<string, unknown>;
+    prefix?: string;
+    callStack?: readonly string[];
+    maxCallDepth?: number;
+    recipes: ReadonlyMap<string, ResolvedLibraryRecipe>;
+    actionManifest: RecipeActionManifestDocument;
+    adapters: ReadonlyMap<string, ActionAdapter>;
+    traceWriter: TraceWriter;
+    logger: RecipeLogger;
+    defaultObserverRefs: DefaultObserverRefs;
+    createContext(nodeId: string, recipe: unknown, outputs: ReadonlyMap<string, unknown>, getOutput: (nodeId: string) => unknown): ActionExecutionContext;
+    registerArtifacts(artifacts: NonNullable<ActionResult['artifacts']>): void;
+    publishHudProgress?: HudPublisher;
+    /** Root-graph partial execution: stop after this node passes, then run teardown. */
+    stopAfterNode?: string;
+}
+export interface ExecuteRecipeResult {
+    status: RecipeRunStatus;
+    failureCause?: RecipeFailureCause;
+    output: Record<string, unknown>;
+    outputs: ReadonlyMap<string, unknown>;
+}
+export declare function executeRecipe(options: ExecuteRecipeOptions): Promise<ExecuteRecipeResult>;
+export {};
+//# sourceMappingURL=execution.d.ts.map

package/dist/core/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/core/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EAExB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EACL,KAAK,mBAAmB,EAIzB,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACtB,YAAY,EAEZ,YAAY,EACZ,eAAe,EACf,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,KAAK,YAAY,GAAG,CAClB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,EACnC,KAAK,EAAE;IACL,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,sBAAsB,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,KACE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACpD,cAAc,EAAE,4BAA4B,CAAC;IAC7C,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC7C,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,aAAa,CACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GACrC,sBAAsB,CAAC;IAC1B,iBAAiB,CAAC,SAAS,EAAE,WAAW,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3E,kBAAkB,CAAC,EAAE,YAAY,CAAC;IAClC,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsS/F"}