@farmslot/recipe-runner 0.23.0

package/dist/adapters/ui.js

@@ -0,0 +1,130 @@
+import { RecipeExecutionError } from '../core/failure.js';
+import { isRecord } from '../core/json.js';
+import { parseUiScrollToRequest, runUiScrollTo, UiScrollToError, uiScrollToRequestSummary, } from '../core/scroll-to.js';
+export const STANDARD_UI_ACTIONS = [
+    'ui.navigate',
+    'ui.press',
+    'ui.key_press',
+    'ui.set_input',
+    'ui.scroll',
+    'ui.scroll_to',
+    'ui.swipe',
+    'ui.pan',
+    'ui.drag',
+    'ui.long_press',
+    'ui.wait_for',
+    'ui.screenshot',
+    'ui.capture_surface',
+    'app.status',
+    'app.lifecycle',
+    'app.hud',
+    'app.trace',
+];
+export function createStandardUiAdapters(options) {
+    const requestedActions = options.actions ? new Set(options.actions) : null;
+    return STANDARD_UI_ACTIONS.filter((action) => !requestedActions || requestedActions.has(action)).map((action) => ({
+        action,
+        source: {
+            kind: 'bundled',
+            trust: 'trusted',
+            name: '@farmslot/recipe-runner',
+        },
+        async execute(node, context) {
+            if (action === 'ui.screenshot' &&
+                node.fullPage !== true &&
+                context.captureRecordingSnapshot) {
+                const file = typeof node.path === 'string'
+                    ? node.path
+                    : `screenshots/${context.nodeId.replaceAll('/', '-')}.png`;
+                const capture = await context.captureRecordingSnapshot(file);
+                const artifact = {
+                    path: file,
+                    type: 'screenshot',
+                    mimeType: 'image/png',
+                    nodeId: context.nodeId,
+                    label: typeof node.label === 'string' ? node.label : context.nodeId,
+                    category: typeof node.category === 'string' ? node.category : 'evidence',
+                    ...(Array.isArray(node.covers) ? { covers: node.covers } : {}),
+                    ...(typeof node.proofTarget === 'string' ? { proofTarget: node.proofTarget } : {}),
+                };
+                return {
+                    output: { ...capture, captured: true, path: file, artifact },
+                    artifacts: [artifact],
+                };
+            }
+            if (action === 'ui.scroll_to')
+                return executeScrollTo(options.transport, node, context);
+            if (action === 'ui.scroll')
+                assertScrollMovement(node);
+            return normalizeUiTransportResult(await options.transport.execute(action, node, context));
+        },
+        async observe(refs, node, context) {
+            if (!options.transport.observe) {
+                return {
+                    warnings: refs.map((ref) => ({
+                        ref,
+                        message: `UI transport does not implement passive observer ${ref}.`,
+                    })),
+                };
+            }
+            return options.transport.observe(refs, node, context);
+        },
+    }));
+}
+async function executeScrollTo(transport, node, context) {
+    const request = parseUiScrollToRequest(node);
+    if (!transport.withScrollSession) {
+        throw new UiScrollToError('SCROLL_UNSUPPORTED', 'this UI transport does not implement withScrollSession.', uiScrollToRequestSummary(request));
+    }
+    try {
+        return {
+            output: await transport.withScrollSession(request, node, context, (session) => runUiScrollTo(request, session)),
+        };
+    }
+    catch (error) {
+        // Provider errors raised before a session exists (for example a held device lock) carry
+        // only backend details; attach the request so the trace names the node's proof target.
+        if (error instanceof UiScrollToError) {
+            throw new UiScrollToError(error.code, error.reason, {
+                ...uiScrollToRequestSummary(request),
+                ...(isRecord(error.details) ? error.details : {}),
+            }, { cause: error });
+        }
+        throw error;
+    }
+}
+/** ui.scroll is raw movement only: offset_* sets an absolute position, delta_* moves relative to it. */
+function assertScrollMovement(node) {
+    const absolute = node.offset_x !== undefined || node.offset_y !== undefined;
+    const relative = node.delta_x !== undefined || node.delta_y !== undefined;
+    if (absolute && relative) {
+        throw new RecipeExecutionError('harness', 'ui.scroll accepts offset_x/offset_y (absolute) or delta_x/delta_y (relative), not both.');
+    }
+    if ((absolute || relative) && (node.scroll_into_view === true || node.into_view === true)) {
+        throw new RecipeExecutionError('harness', 'ui.scroll cannot combine scroll_into_view with raw movement; use ui.scroll_to to reveal a target.');
+    }
+}
+export function normalizeUiTransportResult(result) {
+    if (isUiTransportResult(result)) {
+        const output = result.settlementWarning === undefined
+            ? result.output
+            : typeof result.output === 'object' &&
+                result.output !== null &&
+                !Array.isArray(result.output)
+                ? { ...result.output, settlementWarning: result.settlementWarning }
+                : { result: result.output, settlementWarning: result.settlementWarning };
+        return {
+            case: result.control?.case,
+            artifacts: result.control?.artifacts,
+            output,
+            phases: result.phases,
+        };
+    }
+    return { output: result ?? { ok: true } };
+}
+function isUiTransportResult(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    return value.kind === 'ui-transport-result';
+}
+//# sourceMappingURL=ui.js.map

package/dist/adapters/ui.js.map

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

package/dist/cli/error-output.d.ts

@@ -0,0 +1,6 @@
+import { RecipeResolutionError } from '../core/resolution-error.js';
+import { RecipeTrustError } from '../core/trust-error.js';
+export type RecipeCliError = RecipeResolutionError | RecipeTrustError;
+export declare function isRecipeCliError(error: unknown): error is RecipeCliError;
+export declare function reportRecipeCliError(error: RecipeCliError, json: boolean): void;
+//# sourceMappingURL=error-output.d.ts.map

package/dist/cli/error-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-output.d.ts","sourceRoot":"","sources":["../../src/cli/error-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,MAAM,cAAc,GAAG,qBAAqB,GAAG,gBAAgB,CAAC;AAEtE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAiB/E"}

package/dist/cli/error-output.js

@@ -0,0 +1,19 @@
+import { RecipeResolutionError } from '../core/resolution-error.js';
+import { RecipeTrustError } from '../core/trust-error.js';
+export function isRecipeCliError(error) {
+    return error instanceof RecipeResolutionError || error instanceof RecipeTrustError;
+}
+export function reportRecipeCliError(error, json) {
+    if (json) {
+        console.log(JSON.stringify(error instanceof RecipeTrustError
+            ? error.failure
+            : { code: error.code, message: error.message, userAction: error.userAction }, null, 2));
+    }
+    else {
+        console.error(`Error [${error.code}]: ${error.message}`);
+        console.error(`Next: ${error.userAction}`);
+    }
+    // A malformed --library or RECIPE_LIBRARY_PATH entry is a usage error, as in discovery.
+    process.exitCode = error.code === 'RECIPE_LIBRARY_PATH_INVALID' ? 2 : 1;
+}
+//# sourceMappingURL=error-output.js.map

package/dist/cli/error-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-output.js","sourceRoot":"","sources":["../../src/cli/error-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI1D,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,qBAAqB,IAAI,KAAK,YAAY,gBAAgB,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAqB,EAAE,IAAa;IACvE,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ,KAAK,YAAY,gBAAgB;YAC/B,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,EAC9E,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,wFAAwF;IACxF,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,KAAK,6BAA6B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,12 @@
+import { Command } from 'commander';
+export interface RecipeRunnerCliOptions {
+    commandName?: string;
+    description?: string;
+    /** Version printed by --version; a host CLI reports its own. */
+    version?: string;
+    /** Package versions the host provides, checked against each library's `requires`. */
+    packageVersions?: Readonly<Record<string, string>>;
+}
+export declare function createRecipeRunnerProgram(options?: RecipeRunnerCliOptions): Command;
+export declare function runRecipeRunnerCli(argv: string[], options?: RecipeRunnerCliOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAWvF;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/cli/index.js

@@ -0,0 +1,29 @@
+import { pathToFileURL } from 'node:url';
+import { Command } from 'commander';
+import { RECIPE_RUNNER_VERSION } from '../version.js';
+import { registerRunCommand } from './run-command.js';
+import { registerValidateCommand } from './validate-command.js';
+export function createRecipeRunnerProgram(options = {}) {
+    const program = new Command();
+    program
+        .name(options.commandName ?? 'farmslot-recipe')
+        .description(options.description ?? 'Farmslot v1 recipe runner CLI')
+        .version(options.version ?? RECIPE_RUNNER_VERSION);
+    const context = options.packageVersions ? { packageVersions: options.packageVersions } : {};
+    registerValidateCommand(program, context);
+    registerRunCommand(program, context);
+    return program;
+}
+export async function runRecipeRunnerCli(argv, options = {}) {
+    await createRecipeRunnerProgram(options).parseAsync(argv, { from: 'user' });
+}
+// No top-level await: this module is a library entry too, and a CommonJS consumer can only
+// require() an ES module that loads synchronously.
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    runRecipeRunnerCli(process.argv.slice(2)).catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(message);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAWhE,MAAM,UAAU,yBAAyB,CAAC,UAAkC,EAAE;IAC5E,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,iBAAiB,CAAC;SAC9C,WAAW,CAAC,OAAO,CAAC,WAAW,IAAI,+BAA+B,CAAC;SACnE,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,qBAAqB,CAAC,CAAC;IAErD,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5F,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAc,EACd,UAAkC,EAAE;IAEpC,MAAM,yBAAyB,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,2FAA2F;AAC3F,mDAAmD;AACnD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/E,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACjE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,8 @@
+import { type Command } from 'commander';
+import { type RecipePackageVersions } from '../core/library-manifest.js';
+export interface RecipeCliCommandContext {
+    /** Package versions the host CLI provides for checking each library's `requires`. */
+    packageVersions?: RecipePackageVersions;
+}
+export declare function registerRunCommand(program: Command, context?: RecipeCliCommandContext): void;
+//# sourceMappingURL=run-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../../src/cli/run-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,6BAA6B,CAAC;AAsCrC,MAAM,WAAW,uBAAuB;IACtC,qFAAqF;IACrF,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,uBAA4B,GAAG,IAAI,CA8JhG"}

package/dist/cli/run-command.js

@@ -0,0 +1,253 @@
+import { getRecipeActionManifestActionNames, isRecord, } from '@farmslot/protocol';
+import { createStandardCoreAdapters } from '../adapters/core.js';
+import { applyTaskLocalInvocationTrust, findLibraryRecipe, loadRecipeLibraries, resolveRecipeLibrarySources, } from '../core/library.js';
+import { digestRecipeLibrary, readRecipeLibraryManifest, } from '../core/library-manifest.js';
+import { createRecipeRunner } from '../core/runner.js';
+import { resolveRecipeTrustInput } from '../core/trust-input.js';
+import { isRecipeCliError, reportRecipeCliError } from './error-output.js';
+import { parsePositiveInteger, parseRecipeParamAssignments, parseRecordingTarget, readRecipeCliJsonFile, resolveRecipeCliPath, } from './support.js';
+export function registerRunCommand(program, context = {}) {
+    program
+        .command('run')
+        .description('Run a recipe and write a v1 artifact package')
+        .argument('[recipe]', 'Recipe ref, platform alias or <library>.<ref> id from the active libraries, or a recipe.json path')
+        .argument('[params...]', 'Recipe parameters as key=value')
+        .option('--artifacts-dir <dir>', 'Directory where artifacts are written')
+        .option('--action-manifest <manifest>', 'Runner action manifest JSON')
+        .option('--project-root <dir>', 'Project root used by command/artifact adapters')
+        .option('--library <entry>', 'Recipe library source as name=path or path (repeatable; earlier wins). Entries go before RECIPE_LIBRARY_PATH and replace its entry with the same name; the personal library is used only when neither is set.', collectRepeatable, [])
+        .option('--record-video [mode]', 'Record one whole-recipe MP4 when visual motion proof helps')
+        .option('--record-max-fps <fps>', 'Maximum video frame rate')
+        .option('--record-max-size <px>', 'Maximum recorded video dimension')
+        .option('--record-app-name <name>', 'macOS app name for recording target')
+        .option('--record-window-name <substring>', 'macOS window title substring for recording target')
+        .option('--record-window-id <id>', 'macOS window id from `capture-helper list --json`')
+        .option('--record-pid <pid>', 'macOS process id for recording target')
+        .option('--source-trust <trust>', 'Recipe source trust: trusted, untrusted, or unknown')
+        .option('--source-kind <kind>', 'Recipe source kind supplied by the caller')
+        .option('--source-name <name>', 'Human-readable recipe source name')
+        .option('--source-digest <digest>', 'Caller-computed source digest')
+        .option('--approve-plan <digest>', 'Approve exactly one resolved execution-plan digest')
+        .option('--adapter <name>', 'Select adapter-specific recipe variants')
+        .option('--list', 'List runnable recipes from the active libraries')
+        .option('--describe', 'Describe the selected recipe and its parameters without running it')
+        .option('--stop-after-node <node-id>', 'Run the graph through this node, then run the declared teardown (partial proof of one node)')
+        .option('--json', 'Print run result as JSON')
+        .action(async (recipeInput, params, options) => {
+        try {
+            const loadOptions = {
+                ...(options.adapter ? { adapter: options.adapter } : {}),
+                ...(context.packageVersions ? { packageVersions: context.packageVersions } : {}),
+            };
+            let librarySources = await resolveRecipeLibrarySources({
+                cliEntries: options.library,
+            });
+            let library = await loadRecipeLibraries(librarySources, loadOptions);
+            let match = recipeInput
+                ? await findLibraryRecipe(recipeInput, librarySources, library, loadOptions)
+                : undefined;
+            if (recipeInput && !match) {
+                librarySources = await resolveRecipeLibrarySources({
+                    cliEntries: options.library,
+                    recipePath: resolveRecipeCliPath(recipeInput),
+                });
+                library = await loadRecipeLibraries(librarySources, loadOptions);
+                match = await findLibraryRecipe(recipeInput, librarySources, library, loadOptions);
+            }
+            librarySources = await Promise.all(librarySources.map(async (source) => ({
+                ...source,
+                provenance: {
+                    ...(source.provenance ?? {
+                        kind: 'library',
+                        trust: 'unknown',
+                        name: source.name,
+                        path: source.root,
+                    }),
+                    digest: await digestRecipeLibrary(source.root, await readRecipeLibraryManifest(source.root)),
+                },
+            })));
+            if (options.list) {
+                printRecipeList(library.recipes, options.json === true);
+                return;
+            }
+            if (!recipeInput)
+                throw new Error('Missing recipe. Use --list to discover recipes.');
+            const selected = match?.recipe;
+            if (options.describe) {
+                const document = selected
+                    ? selected.document
+                    : await readRecipeCliJsonFile(recipeInput);
+                printRecipeDescription(recipeInput, document, selected, options.json === true);
+                return;
+            }
+            if (!options.artifactsDir)
+                throw new Error('Missing --artifacts-dir.');
+            if (!options.actionManifest)
+                throw new Error('Missing --action-manifest.');
+            const manifest = await readRecipeCliJsonFile(options.actionManifest);
+            const runner = createRecipeRunner({
+                actionManifest: manifest,
+                adapters: createStandardCoreAdapters({
+                    actions: getRecipeActionManifestActionNames(manifest),
+                }),
+                defaultSource: {
+                    kind: 'operator',
+                    trust: 'trusted',
+                    name: '@farmslot/recipe-runner CLI',
+                },
+                logger: console,
+            });
+            const trust = resolveRecipeTrustInput({
+                sourceTrust: options.sourceTrust,
+                sourceKind: options.sourceKind,
+                sourceName: options.sourceName,
+                sourceDigest: options.sourceDigest,
+                approvalDigest: options.approvePlan,
+            });
+            const invocationTrust = trust.source?.trust ?? 'trusted';
+            const executionLibrarySources = applyTaskLocalInvocationTrust(librarySources, invocationTrust);
+            const result = await runner.run({
+                recipePath: selected ? selected.path : resolveRecipeCliPath(recipeInput),
+                artifactsDir: resolveRecipeCliPath(options.artifactsDir),
+                projectRoot: options.projectRoot
+                    ? resolveRecipeCliPath(options.projectRoot)
+                    : resolveRecipeCliPath('.'),
+                recordVideo: parseRecordVideoOptions(options),
+                params: parseRecipeParamAssignments(params),
+                ...(options.adapter ? { adapter: options.adapter } : {}),
+                ...(options.stopAfterNode ? { stopAfterNode: options.stopAfterNode } : {}),
+                ...(context.packageVersions ? { packageVersions: context.packageVersions } : {}),
+                ...(match
+                    ? {
+                        selection: {
+                            name: recipeInput,
+                            resolvedBy: match.resolvedBy,
+                            source: match.recipe.source,
+                            file: match.recipe.file,
+                            path: match.recipe.path,
+                        },
+                    }
+                    : {}),
+                ...trust,
+                ...(!trust.source && selected ? { source: selected.provenance } : {}),
+                ...(executionLibrarySources.length > 0
+                    ? { librarySources: executionLibrarySources }
+                    : {}),
+            });
+            if (options.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                console.log(`Recipe run: ${result.status}`);
+                console.log(`Artifacts: ${result.artifactManifestPath}`);
+            }
+            if (result.status !== 'pass')
+                process.exitCode = 1;
+        }
+        catch (error) {
+            if (!isRecipeCliError(error))
+                throw error;
+            reportRecipeCliError(error, options.json === true);
+        }
+    });
+}
+function recipeParameters(document) {
+    if (!isRecord(document) || !isRecord(document.paramsSchema))
+        return [];
+    const schema = document.paramsSchema;
+    const required = new Set(Array.isArray(schema.required)
+        ? schema.required.filter((entry) => typeof entry === 'string')
+        : []);
+    if (!isRecord(schema.properties))
+        return [];
+    return Object.entries(schema.properties).map(([name, value]) => {
+        const property = isRecord(value) ? value : {};
+        return {
+            name,
+            ...(typeof property.type === 'string' ? { type: property.type } : {}),
+            required: required.has(name),
+            ...(Object.hasOwn(property, 'default') ? { default: property.default } : {}),
+            ...(typeof property.description === 'string' ? { description: property.description } : {}),
+        };
+    });
+}
+function recipeSummary(ref, document, selected) {
+    const record = isRecord(document) ? document : {};
+    return {
+        ref,
+        ...(typeof record.title === 'string' ? { title: record.title } : {}),
+        ...(typeof record.description === 'string' ? { description: record.description } : {}),
+        parameters: recipeParameters(document),
+        ...(selected
+            ? {
+                source: selected.source,
+                file: selected.file,
+                adapter: selected.adapter ?? null,
+                shadows: selected.shadows,
+            }
+            : {}),
+    };
+}
+function printRecipeList(recipes, json) {
+    const entries = [...recipes.values()]
+        .filter((recipe) => !recipe.aliasFor)
+        .sort((left, right) => left.ref.localeCompare(right.ref))
+        .map((entry) => recipeSummary(entry.ref, entry.document, entry));
+    if (json) {
+        console.log(JSON.stringify(entries, null, 2));
+        return;
+    }
+    console.log(`Runnable recipes (${entries.length})`);
+    for (const entry of entries) {
+        const shadows = entry.shadows?.length ? ` (shadows: ${entry.shadows.join(', ')})` : '';
+        console.log(`  ${entry.ref}${entry.description ? ` — ${entry.description}` : ''}${shadows}`);
+    }
+}
+function printRecipeDescription(ref, document, selected, json) {
+    const entry = recipeSummary(ref, document, selected);
+    if (json) {
+        console.log(JSON.stringify(entry, null, 2));
+        return;
+    }
+    console.log(entry.title ? `${entry.ref} — ${entry.title}` : entry.ref);
+    if (entry.description)
+        console.log(entry.description);
+    if (entry.shadows?.length)
+        console.log(`Shadows: ${entry.shadows.join(', ')}`);
+    if (entry.parameters.length === 0) {
+        console.log('Parameters: none');
+        return;
+    }
+    console.log('Parameters:');
+    for (const parameter of entry.parameters) {
+        const defaultValue = Object.hasOwn(parameter, 'default')
+            ? ` default=${JSON.stringify(parameter.default)}`
+            : '';
+        const requirement = parameter.required ? ' required' : '';
+        console.log(`  ${parameter.name}${parameter.type ? ` (${parameter.type})` : ''}${requirement}${defaultValue}${parameter.description ? ` — ${parameter.description}` : ''}`);
+    }
+}
+function collectRepeatable(value, previous) {
+    return [...previous, value];
+}
+function parseRecordVideoOptions(options) {
+    if (!options.recordVideo)
+        return false;
+    const mode = typeof options.recordVideo === 'string' && options.recordVideo !== 'true'
+        ? options.recordVideo
+        : 'full-run';
+    if (mode === 'proof-window' || mode === 'proof_window') {
+        throw new Error('--record-video=proof-window is reserved for future focused clips; use --record-video=full-run for phase 1.');
+    }
+    if (mode !== 'full-run' && mode !== 'off') {
+        throw new Error('--record-video must be full-run or off.');
+    }
+    const target = parseRecordingTarget(options);
+    return {
+        mode,
+        ...(options.recordMaxFps ? { maxFps: parsePositiveInteger(options.recordMaxFps) } : {}),
+        ...(options.recordMaxSize ? { maxSize: parsePositiveInteger(options.recordMaxSize) } : {}),
+        ...(target ? { target } : {}),
+    };
+}
+//# sourceMappingURL=run-command.js.map

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

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

package/dist/cli/support.d.ts

@@ -0,0 +1,31 @@
+import { type RecipeValidationResult } from '@farmslot/protocol';
+import type { RecipeLibrarySource, RecordingTarget } from '../core/types.js';
+interface RecipeValidationInputOptions {
+    recipePath: string;
+    actionManifestPath?: string;
+    adapter?: string;
+    artifactManifestPath?: string;
+    artifactDir?: string;
+    baseDir?: string;
+    /** Library sources whose recipe refs count as resolvable, mirroring run resolution. */
+    librarySources?: RecipeLibrarySource[];
+    params?: Record<string, unknown>;
+    /** Package versions the host provides for checking each library's `requires`. */
+    packageVersions?: Readonly<Record<string, string>>;
+}
+interface RecipeCliRecordingTargetOptions {
+    recordAppName?: string;
+    recordWindowName?: string;
+    recordWindowId?: string;
+    recordPid?: string;
+}
+export declare function recipeCliBaseDir(): string;
+export declare function resolveRecipeCliPath(filePath: string, baseDir?: string): string;
+export declare function parsePositiveInteger(value: string): number;
+export declare function parseRecipeParamAssignments(values: readonly string[]): Record<string, unknown>;
+export declare function parseRecordingTarget(options: RecipeCliRecordingTargetOptions): RecordingTarget | undefined;
+export declare function readRecipeCliJsonFile(filePath: string, baseDir?: string): Promise<unknown>;
+export declare function readRecipeCliJsonFileWithinRoot(root: string, relativePath: string): Promise<unknown>;
+export declare function validateRecipeCliInput({ recipePath, actionManifestPath, adapter, artifactManifestPath, artifactDir, baseDir, librarySources, params, packageVersions, }: RecipeValidationInputOptions): Promise<RecipeValidationResult>;
+export {};
+//# sourceMappingURL=support.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../../src/cli/support.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,sBAAsB,EAO5B,MAAM,oBAAoB,CAAC;AAW5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE7E,UAAU,4BAA4B;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,cAAc,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,iFAAiF;IACjF,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,UAAU,+BAA+B;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAqB,GAAG,MAAM,CAE3F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8B9F;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,+BAA+B,GACvC,eAAe,GAAG,SAAS,CAc7B;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,SAAqB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CASlB;AAuBD,wBAAsB,sBAAsB,CAAC,EAC3C,UAAU,EACV,kBAAkB,EAClB,OAAO,EACP,oBAAoB,EACpB,WAAW,EACX,OAA4B,EAC5B,cAAc,EACd,MAAW,EACX,eAAe,GAChB,EAAE,4BAA4B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA2LhE"}