@farmslot/recipe-cli 0.4.1 → 0.6.0

package/dist/harness/catalog.js

@@ -0,0 +1,280 @@
+// The host's action catalog: where its bundled library lives, how an adapter's
+// action manifest resolves across library sources, and the risk each bundled
+// action carries. `run`, `call` and the discovery helpers below read actions
+// only through it.
+import { OFFICIAL_RECIPE_ACTIONS, officialRecipeActionCapabilities, } from '@farmslot/protocol';
+import { actionCapabilityMatrix, actionCategory, shortActionNames, } from '../action-catalog.js';
+import { harnessAdapters } from './adapters.js';
+import { color } from './cli-color.js';
+import { isSensitiveKey, redactStructuredValue } from './command-journal.js';
+import { harnessHost } from './host.js';
+import { isRecord, shellQuoteArg } from './parse-args.js';
+import { closest } from './suggest.js';
+const OFFICIAL_ACTIONS = new Set(OFFICIAL_RECIPE_ACTIONS);
+/** `--library` arguments that reproduce the non-bundled sources of a lookup. */
+export function actionLibraryContextArgs(catalog, librarySources) {
+    return (librarySources ?? [])
+        .filter((source) => source.name !== catalog.bundledLibrary.name)
+        .map((source) => {
+        const entry = source.name ? `${source.name}=${source.root}` : source.root;
+        return ` --library ${shellQuoteArg(entry)}`;
+    })
+        .join('');
+}
+/** Every action across the registered adapters, with the adapters that declare it. */
+export async function resolveActionCapabilityMatrix(catalog, librarySources) {
+    const catalogs = await Promise.all(harnessAdapters()
+        .list()
+        .map(async (adapter) => {
+        const { manifest, actionSources } = await catalog.resolveActionManifest(adapter, undefined, librarySources);
+        return { adapter, actions: describeManifestActions(catalog, manifest, actionSources) };
+    }));
+    return actionCapabilityMatrix(catalogs);
+}
+export function describeManifestActions(catalog, manifest, actionSources = new Map()) {
+    const manifestRecord = isRecord(manifest) ? manifest : {};
+    const actions = isRecord(manifestRecord.actions) ? manifestRecord.actions : {};
+    return Object.entries(actions).map(([name, metadata]) => describeManifestAction(catalog, name, OFFICIAL_ACTIONS.has(name) ? 'official' : 'custom', metadata, actionSources.get(name)));
+}
+function describeManifestAction(catalog, name, kind, metadata, source) {
+    const record = isRecord(metadata) ? metadata : {};
+    const schema = record.schema;
+    const schemaRecord = isRecord(schema) ? schema : {};
+    const properties = isRecord(schemaRecord.properties)
+        ? Object.keys(schemaRecord.properties)
+            .filter((field) => field !== 'action' && field !== 'next')
+            .sort()
+        : [];
+    return {
+        name,
+        kind,
+        category: actionCategory(name, [catalog.bundledLibrary.actionNamespace]),
+        description: typeof record.description === 'string' ? record.description : '',
+        fields: properties,
+        schema,
+        examples: record.examples,
+        ...(Array.isArray(record.result_cases)
+            ? {
+                result_cases: record.result_cases.filter((value) => typeof value === 'string'),
+            }
+            : {}),
+        source: source?.name ?? (kind === 'official' ? 'official' : catalog.bundledLibrary.name),
+        sourceTier: source?.tier ?? (kind === 'official' ? 'official' : 'canonical'),
+        sourceManifest: source?.manifestPath ?? '',
+        shadows: source?.shadows ?? [],
+        capabilities: [
+            ...new Set([
+                ...(Array.isArray(record.execution_capabilities)
+                    ? record.execution_capabilities.filter((value) => typeof value === 'string')
+                    : []),
+                ...(kind === 'official'
+                    ? officialRecipeActionCapabilities(name)
+                    : catalog.actionCapabilities(name)),
+            ]),
+        ],
+    };
+}
+/**
+ * One action in full, as `actions --action <name>` and `call <action> --help`
+ * print it: the call form, description, source and adapter, risk, result
+ * cases, fields with their types, up to two authored examples, and the first
+ * one as a runnable call with its recipe node. `actionNames` is the adapter's
+ * vocabulary, which decides whether the short name is unambiguous.
+ */
+export function renderActionDetail(entry, adapter, target, executable, actionNames) {
+    const host = harnessHost().name;
+    const schema = isRecord(entry.schema) ? entry.schema : {};
+    const properties = isRecord(schema.properties) ? schema.properties : {};
+    const required = new Set(Array.isArray(schema.required)
+        ? schema.required.filter((r) => typeof r === 'string')
+        : []);
+    const lines = [
+        `${host} call ${entry.name} [key=value ...] [--arg k=v ...] [flags]`,
+        '',
+    ];
+    if (entry.description)
+        lines.push(`  ${entry.description}`, '');
+    lines.push(`  Source: ${entry.source}${entry.sourceManifest ? ` (${entry.sourceManifest})` : ''} · adapter ${adapter}`);
+    if (entry.capabilities.length > 0)
+        lines.push(`  Risk: ${entry.capabilities.join(', ')}`);
+    if (entry.result_cases?.length)
+        lines.push(`  Result cases: ${entry.result_cases.join(', ')}`);
+    lines.push('');
+    if (entry.fields.length === 0) {
+        lines.push('  Fields: (none)');
+    }
+    else {
+        lines.push('  Fields (pass as <name>=<value> or --arg <name>=<value>):');
+        const width = Math.max(...entry.fields.map((name) => name.length));
+        for (const name of entry.fields) {
+            const prop = isRecord(properties[name]) ? properties[name] : {};
+            const type = typeof prop.type === 'string' ? prop.type : 'any';
+            const req = required.has(name) ? ' (required)' : '';
+            const desc = typeof prop.description === 'string' ? ` — ${prop.description}` : '';
+            const enumVals = Array.isArray(prop.enum) ? ` [one of: ${prop.enum.join(', ')}]` : '';
+            const defaultValue = Object.hasOwn(prop, 'default')
+                ? ` [default: ${JSON.stringify(prop.default)}]`
+                : '';
+            lines.push(`    ${name.padEnd(width)}  ${type}${req}${defaultValue}${desc}${enumVals}`);
+        }
+    }
+    const examples = shortExampleCalls(entry, actionNames);
+    if (examples.length > 0) {
+        lines.push('', '  Examples:');
+        for (const example of examples)
+            lines.push(`    ${example}`);
+    }
+    const runnable = renderHumanActionExample(entry, adapter, target, executable);
+    if (runnable)
+        lines.push('', runnable);
+    return lines.join('\n');
+}
+// Up to two authored examples as `call` lines: the short name where it is
+// unambiguous, and only the action's fields, quoted, as actionExampleCommand
+// renders them.
+function shortExampleCalls(entry, actionNames) {
+    if (!Array.isArray(entry.examples))
+        return [];
+    const name = shortActionNames(actionNames).get(entry.name) ?? entry.name;
+    const out = [];
+    for (const example of entry.examples.slice(0, 2)) {
+        const node = isRecord(example) ? example : undefined;
+        if (!node)
+            continue;
+        const tokens = entry.fields.flatMap((field) => Object.hasOwn(node, field)
+            ? [shellQuoteArg(`${field}=${safeActionCallValue(field, node[field])}`)]
+            : []);
+        out.push([harnessHost().name, 'call', shellQuoteArg(name), ...tokens].join(' '));
+    }
+    return out;
+}
+/** The authored example as a human block: the call that runs it and its recipe node. */
+export function renderHumanActionExample(entry, adapter, target, executable) {
+    const node = authoredExampleNode(entry.examples, undefined, entry.schema);
+    if (!node)
+        return undefined;
+    const out = (style, text) => color(style, text, { stream: process.stdout });
+    const command = actionExampleCommand(entry, adapter, target, executable);
+    if (!command)
+        return undefined;
+    const lines = [
+        out('label', 'Example call:'),
+        `  ${out('cmd', command)}`,
+        out('label', 'Recipe node:'),
+        ...JSON.stringify(node, null, 2)
+            .split('\n')
+            .map((line) => `  ${line}`),
+    ];
+    return lines.join('\n');
+}
+/**
+ * A runnable `call` for the action's authored example; `preferredValues` pick
+ * the closest example and override its values.
+ */
+export function actionExampleCommand(entry, adapter, target, executable, preferredValues) {
+    const node = authoredExampleNode(entry.examples, preferredValues, entry.schema);
+    if (!node)
+        return undefined;
+    const host = harnessHost().name;
+    const commandName = executable.endsWith(`/${host}`) ? host : executable;
+    const args = entry.fields.flatMap((field) => Object.hasOwn(node, field)
+        ? [shellQuoteArg(`${field}=${safeActionCallValue(field, node[field])}`)]
+        : []);
+    return [
+        shellQuoteArg(commandName),
+        'call',
+        shellQuoteArg(entry.name),
+        ...args,
+        '--adapter',
+        adapter,
+        '--target',
+        shellQuoteArg(target),
+    ].join(' ');
+}
+function authoredExampleNode(examples, preferredValues, schema) {
+    if (!Array.isArray(examples))
+        return undefined;
+    if (preferredValues && Object.keys(preferredValues).length > 0) {
+        const normalizedValues = normalizePreferredValues(preferredValues, schema);
+        const nodes = examples.filter(isRecord);
+        if (nodes.length === 0)
+            return undefined;
+        const ranked = nodes
+            .map((node) => ({
+            node,
+            completeness: Object.keys(node).filter((name) => !['action', 'intent', 'next'].includes(name)).length,
+            score: Object.entries(normalizedValues).reduce((score, [name, value]) => {
+                if (!Object.hasOwn(node, name))
+                    return score;
+                return score + (sameActionValue(name, node[name], value) ? 3 : -1);
+            }, 0),
+        }))
+            .sort((left, right) => right.score - left.score || right.completeness - left.completeness);
+        return { ...ranked[0].node, ...normalizedValues };
+    }
+    for (const example of examples) {
+        if (isRecord(example))
+            return example;
+    }
+    return undefined;
+}
+function normalizePreferredValues(preferredValues, schema) {
+    const properties = isRecord(schema) && isRecord(schema.properties) ? schema.properties : {};
+    return Object.fromEntries(Object.entries(preferredValues).flatMap(([name, value]) => {
+        const property = isRecord(properties[name]) ? properties[name] : undefined;
+        if (property && !matchesSchemaType(property.type, value))
+            return [];
+        const values = property && Array.isArray(property.enum) ? property.enum : undefined;
+        if (!values) {
+            return [[name, value]];
+        }
+        const compatibleValue = values.find((candidate) => sameActionValue(name, candidate, value));
+        if (compatibleValue !== undefined)
+            return [[name, compatibleValue]];
+        const strings = values.filter((candidate) => typeof candidate === 'string');
+        const suggestion = typeof value === 'string' ? closest(value, strings) : undefined;
+        return suggestion === undefined ? [] : [[name, suggestion]];
+    }));
+}
+function matchesSchemaType(type, value) {
+    const types = Array.isArray(type) ? type : [type];
+    if (types.every((candidate) => typeof candidate !== 'string'))
+        return true;
+    return types.some((candidate) => {
+        if (candidate === 'null')
+            return value === null;
+        if (candidate === 'array')
+            return Array.isArray(value);
+        if (candidate === 'object')
+            return isRecord(value);
+        if (candidate === 'integer')
+            return typeof value === 'number' && Number.isInteger(value);
+        return typeof value === candidate;
+    });
+}
+function sameActionValue(name, left, right) {
+    if (name === 'state') {
+        const canonicalState = (value) => {
+            if (value === 'present')
+                return 'open';
+            if (value === 'absent')
+                return 'none';
+            return value;
+        };
+        left = canonicalState(left);
+        right = canonicalState(right);
+    }
+    const scalar = (value) => typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean';
+    if (scalar(left) && scalar(right))
+        return String(left) === String(right);
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+function actionCallValue(value) {
+    return typeof value === 'string' ? value : JSON.stringify(value);
+}
+function safeActionCallValue(field, value) {
+    if (isSensitiveKey(field))
+        return `<${field}>`;
+    return actionCallValue(redactStructuredValue(value));
+}
+//# sourceMappingURL=catalog.js.map

package/dist/harness/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/harness/catalog.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6EAA6E;AAC7E,6EAA6E;AAC7E,mBAAmB;AACnB,OAAO,EACL,uBAAuB,EAEvB,gCAAgC,GAIjC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,cAAc,EAEd,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAsDvC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,uBAAuB,CAAC,CAAC;AAElE,gFAAgF;AAChF,MAAM,UAAU,wBAAwB,CACtC,OAAsB,EACtB,cAA+C;IAE/C,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC;SAC/D,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAC1E,OAAO,cAAc,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9C,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAAsB,EACtB,cAA+C;IAE/C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,eAAe,EAAE;SACd,IAAI,EAAE;SACN,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACrB,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,OAAO,CAAC,qBAAqB,CACrE,OAAO,EACP,SAAS,EACT,cAAc,CACf,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,uBAAuB,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,CAAC;IACzF,CAAC,CAAC,CACL,CAAC;IACF,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAsB,EACtB,QAAiB,EACjB,gBAA6D,IAAI,GAAG,EAAE;IAEtE,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CACtD,sBAAsB,CACpB,OAAO,EACP,IAAI,EACJ,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,EAClD,QAAQ,EACR,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CACxB,CACF,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,OAAsB,EACtB,IAAY,EACZ,IAA2B,EAC3B,QAAiB,EACjB,MAA0C;IAE1C,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,MAAM,UAAU,GAAG,QAAQ,CAAC,YAAY,CAAC,UAAU,CAAC;QAClD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;aACjC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,CAAC;aACzD,IAAI,EAAE;QACX,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,QAAQ,EAAE,cAAc,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACxE,WAAW,EAAE,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;QAC7E,MAAM,EAAE,UAAU;QAClB,MAAM;QACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;YACpC,CAAC,CAAC;gBACE,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM,CACtC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CACtD;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC;QACxF,UAAU,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;QAC5E,cAAc,EAAE,MAAM,EAAE,YAAY,IAAI,EAAE;QAC1C,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE;QAC9B,YAAY,EAAE;YACZ,GAAG,IAAI,GAAG,CAAC;gBACT,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAC;oBAC9C,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAClC,CAAC,KAAK,EAAsC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CACzE;oBACH,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,IAAI,KAAK,UAAU;oBACrB,CAAC,CAAC,gCAAgC,CAAC,IAA0B,CAAC;oBAC9D,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;aACtC,CAAC;SACH;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAsB,EACtB,OAAe,EACf,MAAc,EACd,UAAkB,EAClB,WAA8B;IAE9B,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC,IAAI,CAAC;IAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;QACnE,CAAC,CAAC,EAAE,CACP,CAAC;IACF,MAAM,KAAK,GAAa;QACtB,GAAG,IAAI,SAAS,KAAK,CAAC,IAAI,0CAA0C;QACpE,EAAE;KACH,CAAC;IACF,IAAI,KAAK,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CACR,aAAa,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,EAAE,cAAc,OAAO,EAAE,CAC5G,CAAC;IACF,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1F,IAAI,KAAK,CAAC,YAAY,EAAE,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QACzE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACnE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;YAC/D,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC;gBACjD,CAAC,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG;gBAC/C,CAAC,CAAC,EAAE,CAAC;YACP,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,GAAG,GAAG,YAAY,GAAG,IAAI,GAAG,QAAQ,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IACvD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,QAAQ,GAAG,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAC9E,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,0EAA0E;AAC1E,6EAA6E;AAC7E,gBAAgB;AAChB,SAAS,iBAAiB,CAAC,KAAsB,EAAE,WAA8B;IAC/E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;IACzE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACrD,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC5C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;YACxB,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,KAAK,IAAI,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACxE,CAAC,CAAC,EAAE,CACP,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,wBAAwB,CACtC,KAAsB,EACtB,OAAe,EACf,MAAc,EACd,UAAkB;IAElB,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1E,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACzE,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,KAAK,GAAG;QACZ,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC;QAC7B,KAAK,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE;QAC1B,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC;QAC5B,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aAC7B,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;KAC9B,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAsB,EACtB,OAAe,EACf,MAAc,EACd,UAAkB,EAClB,eAAyC;IAEzC,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChF,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC,IAAI,CAAC;IAChC,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;IACxE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAC1C,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;QACxB,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,KAAK,IAAI,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC,EAAE,CACP,CAAC;IACF,OAAO;QACL,aAAa,CAAC,WAAW,CAAC;QAC1B,MAAM;QACN,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;QACzB,GAAG,IAAI;QACP,WAAW;QACX,OAAO;QACP,UAAU;QACV,aAAa,CAAC,MAAM,CAAC;KACtB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAC1B,QAAiB,EACjB,eAAyC,EACzC,MAAgB;IAEhB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,eAAe,IAAI,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/D,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QAC3E,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACzC,MAAM,MAAM,GAAG,KAAK;aACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACd,IAAI;YACJ,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CACpC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CACvD,CAAC,MAAM;YACR,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;gBACtE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC;oBAAE,OAAO,KAAK,CAAC;gBAC7C,OAAO,KAAK,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACrE,CAAC,EAAE,CAAC,CAAC;SACN,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7F,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACrD,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,wBAAwB,CAC/B,eAAwC,EACxC,MAAe;IAEf,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5F,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QACxD,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3E,IAAI,QAAQ,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACpF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5F,IAAI,eAAe,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAC3B,CAAC,SAAS,EAAuB,EAAE,CAAC,OAAO,SAAS,KAAK,QAAQ,CAClE,CAAC;QACF,MAAM,UAAU,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAa,EAAE,KAAc;IACtD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QAC9B,IAAI,SAAS,KAAK,MAAM;YAAE,OAAO,KAAK,KAAK,IAAI,CAAC;QAChD,IAAI,SAAS,KAAK,OAAO;YAAE,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,SAAS,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzF,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,IAAa,EAAE,KAAc;IAClE,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,cAAc,GAAG,CAAC,KAAc,EAAE,EAAE;YACxC,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,MAAM,CAAC;YACvC,IAAI,KAAK,KAAK,QAAQ;gBAAE,OAAO,MAAM,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;QACF,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAC5B,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE,CAChC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,CAAC;IACvF,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa,EAAE,KAAc;IACxD,IAAI,cAAc,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,GAAG,CAAC;IAC/C,OAAO,eAAe,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/harness/commands/call.d.ts

@@ -0,0 +1,18 @@
+import { type RecipeCatalog } from '../catalog.js';
+import { type ConsoleAllowlist } from '../run-diagnostics.js';
+import { type RecipeEngine } from '../run-engine.js';
+import { type DeviceTargeting } from './run.js';
+export interface CallCommandOptions<TMutation, TAllowlist extends ConsoleAllowlist> {
+    engine: RecipeEngine<TMutation, TAllowlist>;
+    targetDevice?: DeviceTargeting;
+    exampleAction?(names: readonly string[]): string | undefined;
+}
+export declare function handleCall<TMutation, TAllowlist extends ConsoleAllowlist>(argv: string[], commandOptions: CallCommandOptions<TMutation, TAllowlist>): Promise<number>;
+/** A fresh artifacts directory per call, under the checkout's recipe calls. */
+export declare function defaultCallArtifactsDir(target: string, action: string): string;
+/** Call inputs and output with every sensitive-keyed value redacted. */
+export declare function redactCallValue(value: unknown, key?: string): unknown;
+export declare function handleCallHelp(argv: string[], genericHelp: string, commandOptions: {
+    catalog: RecipeCatalog;
+}): Promise<number>;
+//# sourceMappingURL=call.d.ts.map

package/dist/harness/commands/call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../../src/harness/commands/call.ts"],"names":[],"mappings":"AAaA,OAAO,EAKL,KAAK,aAAa,EAGnB,MAAM,eAAe,CAAC;AAsBvB,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAQL,KAAK,YAAY,EAIlB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAAE,KAAK,eAAe,EAAyC,MAAM,UAAU,CAAC;AAEvF,MAAM,WAAW,kBAAkB,CAAC,SAAS,EAAE,UAAU,SAAS,gBAAgB;IAChF,MAAM,EAAE,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC5C,YAAY,CAAC,EAAE,eAAe,CAAC;IAG/B,aAAa,CAAC,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAAC;CAC9D;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,UAAU,SAAS,gBAAgB,EAC7E,IAAI,EAAE,MAAM,EAAE,EACd,cAAc,EAAE,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,GACxD,OAAO,CAAC,MAAM,CAAC,CA0fjB;AAoGD,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG9E;AA0BD,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,SAAK,GAAG,OAAO,CAKjE;AAOD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EAAE,EACd,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE;IAAE,OAAO,EAAE,aAAa,CAAA;CAAE,GACzC,OAAO,CAAC,MAAM,CAAC,CA+CjB"}