@farmslot/recipe-runner 0.23.0

package/dist/core/invocation.d.ts

@@ -0,0 +1,13 @@
+export interface RecipeInvocationDocument {
+    version: 1;
+    recipeDigest: string;
+    startedAt: string;
+    params: Record<string, unknown>;
+    redactedPaths: string[];
+}
+/** Retain typed public inputs without recording credential-bearing fields. */
+export declare function redactRecipeParams(params: Record<string, unknown>, schema: unknown): Pick<RecipeInvocationDocument, 'params' | 'redactedPaths'>;
+export declare function createRecipeInvocation(recipe: unknown, params: Record<string, unknown>, startedAt: string): RecipeInvocationDocument;
+/** Reject mismatched or redacted inputs instead of validating a different execution. */
+export declare function recordedRecipeParams(recipe: unknown, invocation: unknown, summary: unknown): Record<string, unknown>;
+//# sourceMappingURL=invocation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.d.ts","sourceRoot":"","sources":["../../src/core/invocation.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,CAAC,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,OAAO,GACd,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,eAAe,CAAC,CA0C5D;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,MAAM,GAChB,wBAAwB,CAO1B;AAED,wFAAwF;AACxF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,OAAO,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzB"}

package/dist/core/invocation.js

@@ -0,0 +1,68 @@
+import { digestRecipeDocument, isRecord } from '@farmslot/protocol';
+const SENSITIVE_KEY = /(?:api[-_]?key|auth|credential|mnemonic|pass(?:word)?|private[-_]?key|secret|seed|srp|token|vault)/iu;
+const PUBLIC_KEY_INDEX = /^(?:api_key_index|apiKeyIndex)$/u;
+/** Retain typed public inputs without recording credential-bearing fields. */
+export function redactRecipeParams(params, schema) {
+    const redactedPaths = [];
+    function visit(value, definition, pointer) {
+        if (Array.isArray(value)) {
+            return value.map((entry, index) => visit(entry, isRecord(definition) ? definition.items : undefined, `${pointer}/${index}`));
+        }
+        if (isRecord(value)) {
+            const properties = isRecord(definition) && isRecord(definition.properties) ? definition.properties : {};
+            return Object.fromEntries(Object.entries(value).map(([key, entry]) => {
+                const child = properties[key];
+                const childPath = `${pointer}/${key.replace(/~/gu, '~0').replace(/\//gu, '~1')}`;
+                const publicIndex = PUBLIC_KEY_INDEX.test(key) &&
+                    isRecord(child) &&
+                    child.type === 'integer' &&
+                    Number.isSafeInteger(entry) &&
+                    Number(entry) >= 0;
+                if (SENSITIVE_KEY.test(key) && !publicIndex) {
+                    redactedPaths.push(childPath);
+                    return [key, '<redacted>'];
+                }
+                return [key, visit(entry, child, childPath)];
+            }));
+        }
+        if (typeof value === 'string') {
+            const redacted = value
+                .replace(/(\w+:\/\/)[^/@\s:]+:[^/@\s]+@/gu, '$1<redacted>@')
+                .replace(/((?:api[-_]?key|auth|credential|mnemonic|pass(?:word)?|private[-_]?key|secret|seed|srp|token|vault)=)[^\s]+/giu, '$1<redacted>');
+            if (redacted !== value)
+                redactedPaths.push(pointer);
+            return redacted;
+        }
+        return value;
+    }
+    return { params: visit(params, schema, ''), redactedPaths };
+}
+export function createRecipeInvocation(recipe, params, startedAt) {
+    return {
+        version: 1,
+        recipeDigest: digestRecipeDocument(recipe),
+        startedAt,
+        ...redactRecipeParams(params, isRecord(recipe) ? recipe.paramsSchema : undefined),
+    };
+}
+/** Reject mismatched or redacted inputs instead of validating a different execution. */
+export function recordedRecipeParams(recipe, invocation, summary) {
+    if (!isRecord(invocation) ||
+        invocation.version !== 1 ||
+        !isRecord(invocation.params) ||
+        !Array.isArray(invocation.redactedPaths) ||
+        !invocation.redactedPaths.every((entry) => typeof entry === 'string') ||
+        !isRecord(summary) ||
+        typeof invocation.startedAt !== 'string' ||
+        invocation.startedAt !== summary.startedAt ||
+        invocation.recipeDigest !== digestRecipeDocument(recipe) ||
+        summary.invocationDigest !== digestRecipeDocument(invocation)) {
+        throw new Error('Recipe invocation does not match the recorded recipe and execution summary.');
+    }
+    const safe = redactRecipeParams(invocation.params, isRecord(recipe) ? recipe.paramsSchema : undefined);
+    if (invocation.redactedPaths.length || safe.redactedPaths.length) {
+        throw new Error('Recipe invocation contains redacted parameters; use fixture references instead of credentials in recipe inputs.');
+    }
+    return invocation.params;
+}
+//# sourceMappingURL=invocation.js.map

package/dist/core/invocation.js.map

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

package/dist/core/json.d.ts

@@ -0,0 +1,9 @@
+export declare function readJsonFile(filePath: string): Promise<unknown>;
+export declare function writeJsonFile(filePath: string, value: unknown): Promise<void>;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function asString(value: unknown, label: string): string;
+export declare function asOptionalString(value: unknown, label: string): string | undefined;
+export declare function asNumber(value: unknown, label: string): number;
+export declare function normalizeRelativePath(relativePath: string): string;
+export declare function getJsonPathValue(value: unknown, jsonPath: string): unknown;
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/core/json.ts"],"names":[],"mappings":"AAGA,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQrE;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGlF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CASlE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuB1E"}

package/dist/core/json.js

@@ -0,0 +1,74 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+export async function readJsonFile(filePath) {
+    const text = await readFile(filePath, 'utf-8');
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to parse JSON file ${filePath}: ${message}`);
+    }
+}
+export async function writeJsonFile(filePath, value) {
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf-8');
+}
+export function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+export function asString(value, label) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new Error(`${label} must be a non-empty string.`);
+    }
+    return value;
+}
+export function asOptionalString(value, label) {
+    if (value == null)
+        return undefined;
+    return asString(value, label);
+}
+export function asNumber(value, label) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new Error(`${label} must be a finite number.`);
+    }
+    return value;
+}
+export function normalizeRelativePath(relativePath) {
+    if (path.isAbsolute(relativePath) || /^[A-Za-z]:/.test(relativePath)) {
+        throw new Error(`Path ${relativePath} must be relative.`);
+    }
+    const normalized = path.normalize(relativePath);
+    if (normalized === '..' || normalized.startsWith(`..${path.sep}`)) {
+        throw new Error(`Path ${relativePath} must not escape its root.`);
+    }
+    return normalized;
+}
+export function getJsonPathValue(value, jsonPath) {
+    if (jsonPath === '$')
+        return value;
+    if (!jsonPath.startsWith('$.')) {
+        throw new Error(`Only simple $.path JSON paths are supported, received ${jsonPath}.`);
+    }
+    const parts = jsonPath
+        .slice(2)
+        .replaceAll('[', '.')
+        .replaceAll(']', '')
+        .split('.')
+        .filter(Boolean);
+    let current = value;
+    for (const part of parts) {
+        if (Array.isArray(current)) {
+            const index = Number(part);
+            if (!Number.isInteger(index))
+                return undefined;
+            current = current[index];
+            continue;
+        }
+        if (!isRecord(current))
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+//# sourceMappingURL=json.js.map

package/dist/core/json.js.map

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

package/dist/core/library-manifest.d.ts

@@ -0,0 +1,53 @@
+export declare const RECIPE_LIBRARY_MANIFEST_FILE = "recipe-library.json";
+/** Recipe folder scope that applies to every platform. */
+export declare const SHARED_RECIPE_SCOPE = "shared";
+/** Library folders that discovery and runs read; the digest covers exactly these plus declared files. */
+export declare const RECIPE_LIBRARY_DIRECTORIES: readonly ["recipes", "manifests", "actions"];
+export interface RecipeLibraryAdapterDeclaration {
+    /** Module path relative to the library root. */
+    module: string;
+    /** Named export holding the adapter; defaults to the module's default export. */
+    export?: string;
+    /** Platform adapter id this adapter extends. */
+    extends?: string;
+}
+/** `recipe-library.json`. Every key is optional; unknown keys are ignored for forward compatibility. */
+export interface RecipeLibraryManifest {
+    /** Platform variant folders under recipes/, in addition to the built-in platforms. */
+    platforms?: string[];
+    /** Platform adapter plugins this library ships. Declared and digested; not loaded yet. */
+    adapters?: Record<string, RecipeLibraryAdapterDeclaration>;
+    /** Action manifest files keyed by platform or `shared`, relative to the library root. */
+    actions?: Record<string, string>;
+    /** Package version ranges this library needs, e.g. `{ "@farmslot/recipe-cli": ">=0.1.0" }`. */
+    requires?: Record<string, string>;
+}
+/** Installed package versions a host provides for checking `requires`. */
+export type RecipePackageVersions = Readonly<Record<string, string>>;
+export interface RecipeLibraryRequirement {
+    package: string;
+    range: string;
+    installed: string;
+}
+/** Real path of a configured library root; a missing root is a configuration error, not a crash. */
+export declare function libraryRootReal(root: string): Promise<string>;
+/** Read and validate a library's recipe-library.json; undefined when the library has none. */
+export declare function readRecipeLibraryManifest(root: string): Promise<RecipeLibraryManifest | undefined>;
+/**
+ * Check a library's `requires` against the versions the host provides. Fails closed: a package
+ * the host cannot vouch for is as unsatisfied as an out-of-range version.
+ */
+export declare function checkRecipeLibraryRequirements(library: string, manifest: RecipeLibraryManifest | undefined, packageVersions?: RecipePackageVersions): RecipeLibraryRequirement[];
+/**
+ * Regular files under `<root>/<directory>`, as sorted `/`-separated paths relative to the root.
+ * The one walker for loading and digesting: it skips dot-entries, `node_modules` and symlinked
+ * directories, and rejects any file that resolves outside the library root.
+ */
+export declare function listLibraryFiles(root: string, directory: string): Promise<string[]>;
+/**
+ * Content digest of what a library contributes to discovery and runs: recipe-library.json,
+ * recipes/, manifests/, actions/, and the files it declares. Text files hash with LF line
+ * endings, so a CRLF checkout of the same content has the same digest.
+ */
+export declare function digestRecipeLibrary(root: string, manifest?: RecipeLibraryManifest): Promise<string>;
+//# sourceMappingURL=library-manifest.d.ts.map

package/dist/core/library-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library-manifest.d.ts","sourceRoot":"","sources":["../../src/core/library-manifest.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,4BAA4B,wBAAwB,CAAC;AAClE,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAG5C,yGAAyG;AACzG,eAAO,MAAM,0BAA0B,8CAA+C,CAAC;AAEvF,MAAM,WAAW,+BAA+B;IAC9C,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wGAAwG;AACxG,MAAM,WAAW,qBAAqB;IACpC,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,+BAA+B,CAAC,CAAC;IAC3D,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,0EAA0E;AAC1E,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAErE,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oGAAoG;AACpG,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWnE;AAED,8FAA8F;AAC9F,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CA0F5C;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,qBAAqB,GAAG,SAAS,EAC3C,eAAe,GAAE,qBAA0B,GAC1C,wBAAwB,EAAE,CAuB5B;AAgCD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA4CzF;AAID;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,MAAM,CAAC,CA4BjB"}

package/dist/core/library-manifest.js

@@ -0,0 +1,263 @@
+import { createHash } from 'node:crypto';
+import { readdir, readFile, realpath, stat } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { RECIPE_RUNNER_VERSION } from '../version.js';
+import { isRecord } from './json.js';
+import { isPathWithin } from './path.js';
+import { RecipeResolutionError } from './resolution-error.js';
+import { invalidRecipeSource } from './trust-error.js';
+const require = createRequire(import.meta.url);
+const semver = require('semver');
+export const RECIPE_LIBRARY_MANIFEST_FILE = 'recipe-library.json';
+/** Recipe folder scope that applies to every platform. */
+export const SHARED_RECIPE_SCOPE = 'shared';
+const PLATFORM_ID = /^[a-z][a-z0-9-]*$/u;
+/** Library folders that discovery and runs read; the digest covers exactly these plus declared files. */
+export const RECIPE_LIBRARY_DIRECTORIES = ['recipes', 'manifests', 'actions'];
+/** Real path of a configured library root; a missing root is a configuration error, not a crash. */
+export async function libraryRootReal(root) {
+    try {
+        return await realpath(root);
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+        throw new RecipeResolutionError('RECIPE_LIBRARY_PATH_INVALID', `Recipe library root ${root} does not exist.`, 'fix the --library or RECIPE_LIBRARY_PATH entry so it names a library directory');
+    }
+}
+/** Read and validate a library's recipe-library.json; undefined when the library has none. */
+export async function readRecipeLibraryManifest(root) {
+    const rootReal = await libraryRootReal(root);
+    const file = path.join(root, RECIPE_LIBRARY_MANIFEST_FILE);
+    let manifestReal;
+    try {
+        manifestReal = await realpath(file);
+    }
+    catch (error) {
+        // A library without recipe-library.json uses the folder conventions only.
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+    if (!isPathWithin(rootReal, manifestReal))
+        throw invalidRecipeSource('Recipe library manifest resolves outside its root.', 'move recipe-library.json inside its library root');
+    const invalid = (detail) => new RecipeResolutionError('RECIPE_LIBRARY_MANIFEST_INVALID', `${file} is invalid: ${detail}`, `fix ${RECIPE_LIBRARY_MANIFEST_FILE} in ${root}`);
+    if (!(await stat(manifestReal)).isFile())
+        throw invalid('it is not a regular file.');
+    let value;
+    try {
+        value = JSON.parse(await readFile(manifestReal, 'utf8'));
+    }
+    catch (error) {
+        if (!(error instanceof SyntaxError))
+            throw error;
+        throw invalid(`not valid JSON (${error.message}).`);
+    }
+    if (!isRecord(value))
+        throw invalid('it must contain a JSON object.');
+    const manifest = {};
+    if (value.platforms !== undefined) {
+        if (!Array.isArray(value.platforms) ||
+            value.platforms.some((platform) => typeof platform !== 'string' ||
+                !PLATFORM_ID.test(platform) ||
+                platform === SHARED_RECIPE_SCOPE))
+            throw invalid('platforms must be an array of platform ids.');
+        manifest.platforms = [...value.platforms];
+    }
+    if (value.adapters !== undefined) {
+        if (!isRecord(value.adapters))
+            throw invalid('adapters must be an object.');
+        manifest.adapters = {};
+        for (const [id, entry] of Object.entries(value.adapters)) {
+            if (!PLATFORM_ID.test(id))
+                throw invalid(`adapter id ${id} is not a platform id.`);
+            if (!isRecord(entry) || typeof entry.module !== 'string' || !entry.module.trim())
+                throw invalid(`adapters.${id}.module must be a path.`);
+            for (const key of ['export', 'extends']) {
+                if (entry[key] !== undefined && (typeof entry[key] !== 'string' || !entry[key].trim()))
+                    throw invalid(`adapters.${id}.${key} must be a non-empty string.`);
+            }
+            await declaredLibraryFile(rootReal, root, entry.module, `adapters.${id}.module`, invalid);
+            manifest.adapters[id] = {
+                module: entry.module,
+                ...(typeof entry.export === 'string' ? { export: entry.export } : {}),
+                ...(typeof entry.extends === 'string' ? { extends: entry.extends } : {}),
+            };
+        }
+    }
+    if (value.actions !== undefined) {
+        if (!isRecord(value.actions))
+            throw invalid('actions must be an object.');
+        manifest.actions = {};
+        for (const [scope, manifestPath] of Object.entries(value.actions)) {
+            if (!PLATFORM_ID.test(scope))
+                throw invalid(`actions key ${scope} must be a platform id or shared.`);
+            if (typeof manifestPath !== 'string' || !manifestPath.trim())
+                throw invalid(`actions.${scope} must be a path.`);
+            await declaredLibraryFile(rootReal, root, manifestPath, `actions.${scope}`, invalid);
+            manifest.actions[scope] = manifestPath;
+        }
+    }
+    if (value.requires !== undefined) {
+        if (!isRecord(value.requires))
+            throw invalid('requires must be an object.');
+        manifest.requires = {};
+        for (const [name, range] of Object.entries(value.requires)) {
+            if (typeof range !== 'string' || semver.validRange(range) === null)
+                throw invalid(`requires.${name} must be a semver range.`);
+            manifest.requires[name] = range;
+        }
+    }
+    return manifest;
+}
+/**
+ * Check a library's `requires` against the versions the host provides. Fails closed: a package
+ * the host cannot vouch for is as unsatisfied as an out-of-range version.
+ */
+export function checkRecipeLibraryRequirements(library, manifest, packageVersions = {}) {
+    const installed = {
+        '@farmslot/recipe-runner': RECIPE_RUNNER_VERSION,
+        ...packageVersions,
+    };
+    return Object.entries(manifest?.requires ?? {}).map(([name, range]) => {
+        const version = installed[name];
+        if (version === undefined) {
+            throw new RecipeResolutionError('RECIPE_LIBRARY_REQUIREMENT_UNSATISFIED', `Library ${library} requires ${name} ${range}, which this host cannot provide or check.`, `use a CLI that provides ${name}, or remove ${name} from the requires of ${library}`);
+        }
+        if (!semver.satisfies(version, range)) {
+            throw new RecipeResolutionError('RECIPE_LIBRARY_REQUIREMENT_UNSATISFIED', `Library ${library} requires ${name} ${range}; this host has ${version}.`, `upgrade ${name} to a version matching ${range}, or pin an older ${library} library`);
+        }
+        return { package: name, range, installed: version };
+    });
+}
+/** Resolve a path declared by recipe-library.json; it must be a regular file inside the library. */
+async function declaredLibraryFile(rootReal, root, relativePath, key, invalid) {
+    if (path.isAbsolute(relativePath))
+        throw invalidRecipeSource(`${RECIPE_LIBRARY_MANIFEST_FILE} ${key} must be relative to the library root.`, `make ${key} a path inside ${root}`);
+    let fileReal;
+    try {
+        fileReal = await realpath(path.resolve(root, relativePath));
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+        throw invalid(`${key} names ${relativePath}, which does not exist.`);
+    }
+    if (!isPathWithin(rootReal, fileReal))
+        throw invalidRecipeSource(`${RECIPE_LIBRARY_MANIFEST_FILE} ${key} resolves outside its library root.`, `move ${relativePath} inside ${root}`);
+    if (!(await stat(fileReal)).isFile())
+        throw invalid(`${key} names ${relativePath}, which is not a regular file.`);
+    return fileReal;
+}
+/**
+ * Regular files under `<root>/<directory>`, as sorted `/`-separated paths relative to the root.
+ * The one walker for loading and digesting: it skips dot-entries, `node_modules` and symlinked
+ * directories, and rejects any file that resolves outside the library root.
+ */
+export async function listLibraryFiles(root, directory) {
+    const rootReal = await libraryRootReal(root);
+    const visit = async (relativeDir) => {
+        let entries;
+        try {
+            entries = await readdir(path.join(root, relativeDir), { withFileTypes: true });
+        }
+        catch (error) {
+            // Every library folder is optional.
+            if (error.code === 'ENOENT' && relativeDir === directory)
+                return [];
+            throw error;
+        }
+        // Entries are checked concurrently: discovery walks a library several times per command.
+        const nested = await Promise.all(entries.map(async (entry) => {
+            if (entry.name.startsWith('.') || entry.name === 'node_modules')
+                return [];
+            const relativePath = path.join(relativeDir, entry.name);
+            if (entry.isDirectory())
+                return visit(relativePath);
+            if (!entry.isFile() && !entry.isSymbolicLink())
+                return [];
+            const portable = relativePath.split(path.sep).join('/');
+            let fileReal;
+            try {
+                fileReal = await realpath(path.join(root, relativePath));
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+                throw invalidRecipeSource(`Library file ${portable} is a broken symlink.`, 'remove the symlink or restore its target inside the library root');
+            }
+            // Symlinked directories are not followed, so a link cannot pull another tree in.
+            if (entry.isSymbolicLink() && !(await stat(fileReal)).isFile())
+                return [];
+            if (!isPathWithin(rootReal, fileReal)) {
+                throw invalidRecipeSource(`Library file ${portable} resolves outside its library root.`, 'move the file inside the library root or remove the escaping symlink');
+            }
+            return [portable];
+        }));
+        return nested.flat();
+    };
+    return (await visit(directory)).sort();
+}
+const fileDigests = new Map();
+/**
+ * Content digest of what a library contributes to discovery and runs: recipe-library.json,
+ * recipes/, manifests/, actions/, and the files it declares. Text files hash with LF line
+ * endings, so a CRLF checkout of the same content has the same digest.
+ */
+export async function digestRecipeLibrary(root, manifest) {
+    const files = new Set();
+    const declared = [
+        RECIPE_LIBRARY_MANIFEST_FILE,
+        ...Object.values(manifest?.actions ?? {}),
+        ...Object.values(manifest?.adapters ?? {}).map((adapter) => adapter.module),
+    ];
+    const rootReal = await libraryRootReal(root);
+    for (const file of declared) {
+        const relative = path.relative(root, path.resolve(root, file)).split(path.sep).join('/');
+        // Declared files are checked here too, so the digest never covers content outside the library.
+        const fileReal = await existingRealpath(path.join(root, relative));
+        if (!fileReal)
+            continue;
+        if (!isPathWithin(rootReal, fileReal))
+            throw invalidRecipeSource(`Library file ${relative} resolves outside its library root.`, 'move the file inside the library root or remove the escaping symlink');
+        if ((await stat(fileReal)).isFile())
+            files.add(relative);
+    }
+    for (const directory of RECIPE_LIBRARY_DIRECTORIES) {
+        for (const file of await listLibraryFiles(root, directory))
+            files.add(file);
+    }
+    const sorted = [...files].sort();
+    const digests = await Promise.all(sorted.map((file) => fileDigest(path.join(root, file))));
+    const hash = createHash('sha256');
+    sorted.forEach((file, index) => hash.update(`${file}\0${digests[index]}\n`));
+    return `sha256:${hash.digest('hex')}`;
+}
+/** Per-file content hash, cached per process while size and mtime are unchanged. */
+async function fileDigest(file) {
+    const info = await stat(file);
+    const cached = fileDigests.get(file);
+    if (cached && cached.mtimeMs === info.mtimeMs && cached.size === info.size)
+        return cached.digest;
+    const content = await readFile(file);
+    // Binary files hash byte-exact; text files hash with normalized line endings.
+    const normalized = content.includes(0)
+        ? content
+        : Buffer.from(content.toString('utf8').replaceAll('\r\n', '\n'), 'utf8');
+    const digest = createHash('sha256').update(normalized).digest('hex');
+    fileDigests.set(file, { mtimeMs: info.mtimeMs, size: info.size, digest });
+    return digest;
+}
+async function existingRealpath(file) {
+    try {
+        return await realpath(file);
+    }
+    catch (error) {
+        // recipe-library.json is optional; a missing declared file was already rejected by the reader.
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+//# sourceMappingURL=library-manifest.js.map

package/dist/core/library-manifest.js.map

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

package/dist/core/library.d.ts

@@ -0,0 +1,80 @@
+import { type RecipeSourceProvenance } from '@farmslot/protocol';
+import { type RecipePackageVersions } from './library-manifest.js';
+import type { LoadedRecipeLibrarySource, RecipeLibrarySource, RecipeLogger } from './types.js';
+/** Platforms whose variant folders every library recognizes without declaring them. */
+export declare const BUILT_IN_RECIPE_PLATFORMS: readonly string[];
+/** Platform variant folders a library recognizes: the built-in set plus its declared platforms. */
+export declare function listRecipeLibraryPlatforms(root: string): Promise<string[]>;
+export interface RecipeLibraryLoadOptions {
+    /** Active platform: selects platform variants. */
+    adapter?: string;
+    logger?: RecipeLogger;
+    /** Package versions the host provides for checking each library's `requires`. */
+    packageVersions?: RecipePackageVersions;
+}
+export type RecipeLibraryEnv = Record<string, string | undefined>;
+export interface ResolvedLibraryRecipe {
+    ref: string;
+    document: Record<string, unknown>;
+    source: string;
+    /** Recipe file path relative to the library root. */
+    file: string;
+    path: string;
+    adapter?: string;
+    provenance: RecipeSourceProvenance;
+    /** Source names that also declare this ref at lower precedence. */
+    shadows: string[];
+    /** Qualified compatibility reference; excluded from catalogs. */
+    aliasFor?: string;
+}
+export interface RecipeLibraryResolution {
+    sources: LoadedRecipeLibrarySource[];
+    recipes: ReadonlyMap<string, ResolvedLibraryRecipe>;
+}
+export declare function parseRecipeLibraryPath(value: string): RecipeLibrarySource[];
+export declare function personalRecipeLibraryRoot(env?: RecipeLibraryEnv): string;
+export declare function defaultRecipeLibrarySources(env?: RecipeLibraryEnv): Promise<RecipeLibrarySource[]>;
+/**
+ * Ordered library sources: --library entries, then RECIPE_LIBRARY_PATH, or the personal
+ * library when neither is set. A --library entry replaces the RECIPE_LIBRARY_PATH entry
+ * with the same name instead of conflicting with it.
+ */
+export declare function resolveRecipeLibrarySources(options?: {
+    cliEntries?: string[];
+    env?: RecipeLibraryEnv;
+    recipePath?: string;
+}): Promise<RecipeLibrarySource[]>;
+export declare function applyTaskLocalInvocationTrust(sources: readonly RecipeLibrarySource[], invocationTrust: RecipeSourceProvenance['trust']): RecipeLibrarySource[];
+/**
+ * Load ordered library sources into one recipe index. The first source wins;
+ * within one source an exact adapter variant wins over the generic recipe.
+ */
+export declare function loadRecipeLibraries(sources: readonly RecipeLibrarySource[], options?: RecipeLibraryLoadOptions): Promise<RecipeLibraryResolution>;
+export interface LibraryRecipeMatch {
+    recipe: ResolvedLibraryRecipe;
+    /**
+     * `ref`: the precedence winner; `alias`: a qualified platform alias such as `web.greet`;
+     * `id`: a namespaced `<library>.<ref>` that selects that library's recipe even when shadowed.
+     */
+    resolvedBy: 'ref' | 'alias' | 'id';
+}
+/**
+ * Resolve a recipe name the way `run` and discovery both do: a ref or alias in the resolution
+ * first, then a namespaced `<library>.<ref>` id against that one library.
+ */
+export declare function findLibraryRecipe(name: string, sources: readonly RecipeLibrarySource[], resolution: RecipeLibraryResolution, options?: RecipeLibraryLoadOptions & {
+    /** Loader for a single library, so callers can reuse loads they already made. */
+    load?: (source: RecipeLibrarySource) => Promise<RecipeLibraryResolution>;
+}): Promise<LibraryRecipeMatch | undefined>;
+/** Recipe files under recipes/, relative to it, from the shared library walker. */
+export declare function listRecipeFiles(root: string): Promise<string[]>;
+/**
+ * Log the resolved sources and shadowed recipes. With `refs`, only shadows among those refs are
+ * reported, so a run does not warn about a winner it never executes.
+ */
+export declare function logRecipeLibraryResolution(logger: RecipeLogger, resolution: RecipeLibraryResolution, refs?: ReadonlySet<string>): void;
+/** The `Recipe libraries: …` line; log it as soon as libraries load, before anything can fail. */
+export declare function logRecipeLibrarySources(logger: RecipeLogger, resolution: RecipeLibraryResolution): void;
+/** Shadow warnings, limited to `refs` when given. */
+export declare function logRecipeLibraryShadows(logger: RecipeLogger, resolution: RecipeLibraryResolution, refs?: ReadonlySet<string>): void;
+//# sourceMappingURL=library.d.ts.map

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

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