@deeeed/metamask-harness 0.17.4 → 0.18.0

package/dist/commands/launch/index.js

@@ -1,7 +1,7 @@
 import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
-import { color } from "../../cli-color.js";
+import { color, colorHumanMessage } from "../../cli-color.js";
 import { handleHarness } from "../../harness.js";
 import { recipeRuntimePath, runnerDir } from "../../paths.js";
 import { getAdapterSurface } from "../../adapters/surface.js";
@@ -36,6 +36,7 @@ import { applyDeviceTargeting } from "../device-target.js";
 import { acquireCheckoutLock } from "../../checkout-lock.js";
 import { JsonStreamWriter } from "../../json-stream.js";
 import { ensureExtensionConsoleCapture } from "../../adapters/extension/console-capture.js";
+import { extensionProductConfigBlock } from "../../adapters/extension/product-config.js";
 const LAUNCH_BOOLEANS = /* @__PURE__ */ new Set([
   "build",
   "watch",
@@ -150,9 +151,9 @@ async function handleLaunchLocked(argv, stream) {
   if (!machine && adapter === "extension") {
     const modeNote = displayMode === "sidepanel" ? `sidepanel \xB7 dapp ${process.env.EXTENSION_START_URL ?? DEFAULT_EXTENSION_DAPP_URL}` : "fullscreen";
     const workNote = wantWatch ? "watch only" : tier === "build" ? "clean build" : "quick reuse probe";
-    console.error(
+    console.error(colorHumanMessage(
       `\u2192 extension launch \u2014 ${modeNote} \xB7 CDP :${process.env.CDP_PORT ?? "default"} \xB7 ${workNote}`
-    );
+    ));
   }
   if (adapter === "mobile") {
     const device = str(options, "device") ?? (mobileTarget === "android" ? process.env.ADB_SERIAL ?? process.env.ANDROID_SERIAL : process.env.IOS_SIMULATOR ?? process.env.SIM_UDID) ?? "configured device";
@@ -185,6 +186,16 @@ async function handleLaunchLocked(argv, stream) {
   if (adapter === "extension") {
     const willBuild = wantWatch || tier === "build" || !await extensionRuntimeReusable(target);
     if (willBuild) {
+      const productConfigBlock = extensionProductConfigBlock(target);
+      if (productConfigBlock) {
+        return launchFail(jsonOutput, stream, adapter, mobileTarget, tier, state, target, {
+          code: "EXTENSION_PRODUCT_CONFIG_REQUIRED",
+          message: productConfigBlock.message,
+          recoverable: false,
+          userAction: productConfigBlock.userAction,
+          exitCode: EXIT.infra
+        });
+      }
       const depsBlock = extensionDepsBlock(target);
       if (depsBlock) {
         if (heal === "off") {
@@ -214,6 +225,25 @@ async function handleLaunchLocked(argv, stream) {
   if (attempt.status === 0) {
     return await finishLaunch(jsonOutput, machine, stream, adapter, mobileTarget, tier, displayMode, target, state, wantWatch, wantVerify);
   }
+  if (adapter === "extension" && extensionProductConfigMissing(attempt.output)) {
+    const block = extensionProductConfigBlock(target);
+    return launchFail(jsonOutput, stream, adapter, mobileTarget, tier, state, target, {
+      code: "EXTENSION_PRODUCT_CONFIG_REQUIRED",
+      message: block?.message ?? "Extension product configuration was not ready when the build started.",
+      recoverable: false,
+      userAction: block?.userAction ?? `mm-harness launch --adapter extension --target ${shellQuote(target)}`,
+      exitCode: EXIT.infra
+    });
+  }
+  if (adapter === "extension" && extensionBrowserMissing(attempt.output)) {
+    return launchFail(jsonOutput, stream, adapter, mobileTarget, tier, state, target, {
+      code: "EXTENSION_BROWSER_REQUIRED",
+      message: "the checkout Playwright browser is not installed; system Chrome is not a compatible unpacked-extension fallback. Installing the browser cache requires user approval.",
+      recoverable: false,
+      userAction: `ask the user for approval, then run: cd ${shellQuote(target)} && yarn playwright install chromium`,
+      exitCode: EXIT.infra
+    });
+  }
   if (heal === "off") {
     return launchFail(jsonOutput, stream, adapter, mobileTarget, tier, state, target, {
       code: "LAUNCH_FAILED",
@@ -282,6 +312,12 @@ function extensionQuickReattachFailed(output) {
 function extensionRuntimeBlocked(output) {
   return /ERR_BLOCKED_BY_CLIENT|has been blocked by Chromium/u.test(output);
 }
+function extensionBrowserMissing(output) {
+  return /Playwright Chromium is not installed|No compatible Chromium binary selected/u.test(output);
+}
+function extensionProductConfigMissing(output) {
+  return /EXTENSION_PRODUCT_CONFIG_REQUIRED:/u.test(output);
+}
 function mobileProvisioningBlocked(output) {
   return /open-device: configured iOS simulator '.+' does not exist|open-device: no MetaMask bundle found|fast mode requires an installed (?:iOS dev client|Android dev client)/u.test(output);
 }
@@ -561,13 +597,13 @@ function launchFail(json, stream, adapter, mobileTarget, tier, state, target, fa
       )
     );
   } else {
-    console.error(
+    console.error(colorHumanMessage(
       `\u2717 launch ${adapter}${mobileTarget ? ` ${mobileTarget}` : ""} failed
   ${failure.message}` + (failure.originalError ? `
   --- original failure ---
 ${failure.originalError}` : "") + `
   Next: ${userAction}`
-    );
+    ));
   }
   return failure.exitCode;
 }

package/dist/commands/list-executables.js

@@ -1,48 +1,170 @@
-import { loadActionManifest } from "../manifest.js";
-import { importRecipeHarness, importRecipeProtocol } from "../paths.js";
+import path from "node:path";
+import { resolveActionManifest } from "../manifest.js";
+import { importRecipeProtocol } from "../paths.js";
+import { color } from "../cli-color.js";
 import { EXIT } from "./shared.js";
-import { optionFlag, optionString, resolveAdapter } from "./parse-args.js";
-import { resolveMetaMaskLibrarySources } from "./run-engine.js";
+import { optionFlag, optionString, resolveAdapter, shellQuoteArg } from "./parse-args.js";
+import { describeManifestActions, renderHumanActionCatalog } from "./manifest.js";
+import {
+  describeRunnableRecipe,
+  listRunnableRecipes,
+  resolveMetaMaskLibrarySources
+} from "./run-engine.js";
 const finalSegment = (name) => name.split(".").pop() ?? name;
-async function listFlowIds() {
-  try {
-    const sources = await resolveMetaMaskLibrarySources(void 0);
-    if (!sources || sources.length === 0) return [];
-    const harness = await importRecipeHarness();
-    const resolution = await harness.loadRecipeLibraries(sources);
-    return [...resolution.flows.keys()].sort();
-  } catch {
-    return [];
-  }
+function catalogDescription(description) {
+  if (!description) return "";
+  const firstSentence = description.match(/^.*?[.!?](?:\s|$)/u)?.[0]?.trim() ?? description;
+  return firstSentence.length <= 180 ? firstSentence : `${firstSentence.slice(0, 177).trimEnd()}\u2026`;
 }
 async function handleListExecutables(command, options) {
   const json = optionFlag(options, "json");
   const { adapter } = resolveAdapter(options);
-  const manifest = loadActionManifest(adapter, optionString(options, "actionManifest"));
+  const librarySources = await resolveMetaMaskLibrarySources(optionString(options, "library"));
+  if (command === "run") {
+    const recipes = listRunnableRecipes(adapter, librarySources);
+    if (json) {
+      console.log(JSON.stringify({ schemaVersion: 1, command, action: "list", adapter, recipes }, null, 2));
+      return EXIT.ok;
+    }
+    const out = (style, text) => color(style, text, { stream: process.stdout });
+    console.log(out("bold", `runnable recipes (${adapter})`));
+    console.log(out("comment", "Inspect: mm-harness run <recipe> --describe"));
+    for (const recipe of recipes) {
+      const shadowed = recipe.shadows.length > 0 ? ` shadows=${recipe.shadows.join(",")}` : "";
+      const summary = catalogDescription(recipe.description);
+      const description = summary ? ` \u2014 ${summary}` : "";
+      console.log(`  ${out("cmd", recipe.name)} ${out("dim", `[${recipe.source}]${shadowed}`)}${description}`);
+    }
+    return EXIT.ok;
+  }
+  const { manifest, actionSources } = await resolveActionManifest(
+    adapter,
+    optionString(options, "actionManifest"),
+    librarySources
+  );
   const { getRecipeActionManifestActionNames } = await importRecipeProtocol();
-  const names = getRecipeActionManifestActionNames(manifest).slice().sort();
+  const protocolNames = new Set(getRecipeActionManifestActionNames(manifest));
+  const described = describeManifestActions(manifest, actionSources).filter((entry) => protocolNames.has(entry.name)).sort((left, right) => left.name.localeCompare(right.name));
   const shortCounts = /* @__PURE__ */ new Map();
-  for (const name of names) shortCounts.set(finalSegment(name), (shortCounts.get(finalSegment(name)) ?? 0) + 1);
-  const actions = names.map((name) => {
-    const short = finalSegment(name);
-    return { name, short: shortCounts.get(short) === 1 ? short : null };
+  for (const entry of described) {
+    const short = finalSegment(entry.name);
+    shortCounts.set(short, (shortCounts.get(short) ?? 0) + 1);
+  }
+  const shortByName = /* @__PURE__ */ new Map();
+  const actions = described.map((entry) => {
+    const short = finalSegment(entry.name);
+    const usableShort = shortCounts.get(short) === 1 ? short : null;
+    shortByName.set(entry.name, usableShort);
+    return {
+      name: entry.name,
+      short: usableShort,
+      description: entry.description,
+      fields: entry.fields,
+      source: entry.source,
+      sourceTier: entry.sourceTier,
+      sourceManifest: entry.sourceManifest,
+      shadows: entry.shadows
+    };
   });
-  const flows = await listFlowIds();
   if (json) {
-    console.log(JSON.stringify({ schemaVersion: 1, command, action: "list", adapter, actions, flows }, null, 2));
+    console.log(JSON.stringify({ schemaVersion: 1, command, action: "list", adapter, actions }, null, 2));
     return EXIT.ok;
   }
-  console.log(`invocable for ${adapter}:`);
-  console.log(`  actions (mm-harness call <name> \u2014 short or full):`);
-  for (const entry of actions) {
-    console.log(entry.short ? `    ${entry.short}  (${entry.name})` : `    ${entry.name}  (full name only \u2014 ambiguous short)`);
+  console.log(renderHumanActionCatalog(described, {
+    title: `invocable actions (${adapter})`,
+    guidance: "Use: mm-harness call <name>  \xB7  short names shown first where unambiguous",
+    displayName: (entry) => {
+      const short = shortByName.get(entry.name);
+      return short ? `${short} (${entry.name})` : `${entry.name} (full name only \u2014 ambiguous short)`;
+    }
+  }));
+  return EXIT.ok;
+}
+async function handleDescribeRecipe(recipeArg, options) {
+  const json = optionFlag(options, "json");
+  const { adapter } = resolveAdapter(options);
+  const libraryEntry = optionString(options, "library");
+  const librarySources = await resolveMetaMaskLibrarySources(libraryEntry);
+  const result = describeRunnableRecipe(recipeArg, adapter, librarySources);
+  const targetEntry = optionString(options, "target") ?? optionString(options, "projectRoot");
+  const replayTarget = targetEntry ? path.resolve(targetEntry) : void 0;
+  const contextFlags = [
+    `--adapter ${adapter}`,
+    ...libraryEntry ? [`--library ${shellQuoteArg(libraryEntry)}`] : [],
+    ...replayTarget ? [`--target ${shellQuoteArg(replayTarget)}`] : []
+  ].join(" ");
+  const discoveryCommand = `mm-harness run --list ${contextFlags}`;
+  if ("notFound" in result || "unreadable" in result) {
+    const code = "notFound" in result ? "RECIPE_NOT_FOUND" : "RECIPE_UNPARSEABLE";
+    const message = "notFound" in result ? result.notFound : result.unreadable;
+    const userAction = "notFound" in result ? discoveryCommand : `fix ${shellQuoteArg(recipeArg)}, then retry: mm-harness run ${shellQuoteArg(recipeArg)} --describe ${contextFlags}`;
+    if (json) {
+      console.log(JSON.stringify({
+        schemaVersion: 1,
+        command: "run",
+        action: "describe",
+        status: "fail",
+        error: { code, message, userAction },
+        exitCode: EXIT.usage
+      }, null, 2));
+    } else {
+      console.error(`\u2717 run: ${message}
+  Next: ${userAction}`);
+    }
+    return EXIT.usage;
   }
-  if (flows.length > 0) {
-    console.log(`  flows (mm-harness run <flow>):`);
-    for (const flow of flows) console.log(`    ${flow}`);
+  const recipe = result.recipe;
+  const nextCommand = `mm-harness run ${shellQuoteArg(recipeArg)} --plan ${contextFlags}`;
+  if (json) {
+    console.log(JSON.stringify({
+      schemaVersion: 1,
+      command: "run",
+      action: "describe",
+      status: "pass",
+      recipe,
+      nextCommand
+    }, null, 2));
+    return EXIT.ok;
+  }
+  const out = (style, text) => color(style, text, { stream: process.stdout });
+  console.log(out("bold", `recipe ${recipe.name}`));
+  if (recipe.title) console.log(`  ${out("label", "title:")} ${recipe.title}`);
+  if (recipe.description) console.log(`  ${out("label", "description:")} ${recipe.description}`);
+  console.log(`  ${out("label", "adapter:")} ${recipe.adapter}`);
+  console.log(`  ${out("label", "source:")} ${recipe.source} \xB7 ${recipe.file}`);
+  console.log(`  ${out("label", "path:")} ${out("path", recipe.path)}`);
+  const inputEntries = Object.entries(recipe.inputs);
+  if (inputEntries.length === 0) {
+    console.log(`  ${out("label", "declared inputs:")} none`);
+  } else {
+    console.log(`  ${out("label", "input overrides:")} unavailable \u2014 declared inputs are recipe-owned`);
+    console.log(`  ${out("label", `declared inputs (${inputEntries.length})`)}`);
+    for (const [name, declaration] of inputEntries) {
+      console.log(`    ${out("cmd", name)} = ${compactValue(declaration)}`);
+    }
+  }
+  renderComposition("actions", recipe.actions, out);
+  if (!recipe.actionsComplete) {
+    console.log(`  ${out("comment", "Note: actions inside external library flows are not expanded.")}`);
   }
+  renderComposition("flows", recipe.flows, out);
+  console.log(`  ${out("comment", `Next: ${nextCommand}`)}`);
   return EXIT.ok;
 }
+function compactValue(value) {
+  const rendered = JSON.stringify(value);
+  if (rendered === void 0) return String(value);
+  return rendered.length <= 180 ? rendered : `${rendered.slice(0, 177)}\u2026`;
+}
+function renderComposition(label, values, out) {
+  if (values.length === 0) {
+    console.log(`  ${out("label", `${label}:`)} none`);
+    return;
+  }
+  console.log(`  ${out("label", `${label} (${values.length})`)}`);
+  for (const value of values) console.log(`    ${out("cmd", value)}`);
+}
 export {
+  handleDescribeRecipe,
   handleListExecutables
 };

package/dist/commands/manifest.js

@@ -1,10 +1,26 @@
-import { loadActionManifest, validateManifest } from "../manifest.js";
+import { resolveActionManifest } from "../manifest.js";
+import { color } from "../cli-color.js";
 import { EXIT } from "./shared.js";
-import { isRecord, optionFlag, optionString, resolveAdapter } from "./parse-args.js";
+import {
+  isRecord,
+  optionFlag,
+  optionString,
+  resolveAdapter,
+  shellQuoteArg
+} from "./parse-args.js";
+import { resolveMetaMaskLibrarySources } from "./run-engine.js";
+import {
+  officialRecipeActionCapabilities
+} from "@farmslot/protocol";
+import { metaMaskActionExecutionCapabilities } from "../recipe-security.js";
 async function handleActions({ options, positional }) {
-  const { adapter } = resolveAdapter(options);
-  const manifest = loadActionManifest(adapter, optionString(options, "actionManifest"));
-  await validateManifest(manifest);
+  const { adapter, target } = resolveAdapter(options);
+  const librarySources = await resolveMetaMaskLibrarySources(optionString(options, "library"));
+  const { manifest, actionSources } = await resolveActionManifest(
+    adapter,
+    optionString(options, "actionManifest"),
+    librarySources
+  );
   if (optionFlag(options, "raw")) {
     console.log(JSON.stringify(manifest, null, 2));
     return EXIT.ok;
@@ -14,7 +30,7 @@ async function handleActions({ options, positional }) {
   const query = positional[0]?.trim();
   const category = optionString(options, "category")?.toLowerCase();
   const categoriesOnly = optionFlag(options, "categories");
-  const all = describeManifestActions(manifest);
+  const all = describeManifestActions(manifest, actionSources);
   const categories = summarizeActionCategories(all);
   if (categoriesOnly && (action || category)) {
     const message = "--categories cannot be combined with --action or --category.";
@@ -83,14 +99,23 @@ async function handleActions({ options, positional }) {
       ...query ? { query } : {},
       category,
       actions,
-      ...relatedActions ? { relatedActions } : {}
+      ...relatedActions?.length ? { relatedActions } : {}
     }, null, 2));
   } else {
-    for (const entry of actions) {
-      const fields = entry.fields.length ? ` fields=${entry.fields.join(",")}` : "";
-      console.log(`${entry.name} (${entry.kind})${fields}${entry.description ? ` \u2014 ${entry.description}` : ""}`);
-    }
-    if (relatedActions) console.log(`Related: ${relatedActions.join(", ")}`);
+    console.log(renderHumanActionCatalog(actions, {
+      title: `actions (${adapter})`,
+      guidance: "Inspect: mm-harness actions --action <name>  \xB7  Run: mm-harness call <name>"
+    }));
+    const example = action && actions.length === 1 ? renderHumanActionExample(
+      actions[0],
+      adapter,
+      target,
+      process.env.MM_HARNESS_INVOKED_AS ?? process.env.MM_HARNESS_EXECUTABLE ?? "mm-harness"
+    ) : void 0;
+    if (example) console.log(`
+${example}`);
+    if (relatedActions?.length) console.log(`
+${color("label", "Related:", { stream: process.stdout })} ${relatedActions.join(", ")}`);
   }
   return 0;
 }
@@ -120,12 +145,84 @@ function findRelatedActions(entries, selected, limit = 5) {
   }).filter(({ score }) => score > 0).sort((left, right) => right.score - left.score || left.name.localeCompare(right.name)).slice(0, limit).map(({ name }) => name);
 }
 const GENERIC_OPERATION_TERMS = /* @__PURE__ */ new Set(["assert", "call", "close", "ensure", "place", "read", "start", "teardown"]);
+function renderHumanActionCatalog(actions, options) {
+  const out = (style, text) => color(style, text, { stream: process.stdout });
+  const groups = /* @__PURE__ */ new Map();
+  for (const entry of actions) {
+    const group = actionDomainGroup(entry);
+    groups.set(group, [...groups.get(group) ?? [], entry]);
+  }
+  const lines = [out("bold", options.title), out("comment", options.guidance)];
+  for (const [group, entries] of groups) {
+    lines.push("", `${out(group === "official" ? "label" : "accent", group)} ${out("dim", `(${entries.length})`)}`);
+    for (const entry of entries) {
+      const fieldNames = humanFieldNames(entry);
+      const fields = fieldNames.length ? ` ${out("dim", `fields=${fieldNames.join(",")}`)}` : "";
+      const description = entry.description ? ` ${out("comment", `\u2014 ${entry.description}`)}` : "";
+      const source = ` ${out("dim", `[${entry.source}]`)}`;
+      const risk = entry.capabilities.length ? ` ${out("dim", `risk=${entry.capabilities.join(",")}`)}` : "";
+      lines.push(`  ${out("cmd", options.displayName?.(entry) ?? entry.name)}${source}${fields}${risk}${description}`);
+    }
+  }
+  return lines.join("\n");
+}
+function renderHumanActionExample(entry, adapter, target, executable) {
+  const node = authoredExampleNode(entry.examples);
+  if (!node) return void 0;
+  const out = (style, text) => color(style, text, { stream: process.stdout });
+  const args = entry.fields.flatMap(
+    (field) => Object.hasOwn(node, field) ? [shellQuoteArg(`${field}=${actionCallValue(node[field])}`)] : []
+  );
+  const command = [
+    shellQuoteArg(executable),
+    "call",
+    shellQuoteArg(entry.name),
+    ...args,
+    "--adapter",
+    adapter,
+    "--target",
+    shellQuoteArg(target)
+  ].join(" ");
+  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");
+}
+function authoredExampleNode(examples) {
+  if (!Array.isArray(examples)) return void 0;
+  for (const example of examples) {
+    if (isRecord(example) && isRecord(example.node)) return example.node;
+  }
+  return void 0;
+}
+function actionCallValue(value) {
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
+function humanFieldNames(entry) {
+  const schema = isRecord(entry.schema) ? entry.schema : void 0;
+  const properties = schema && isRecord(schema.properties) ? schema.properties : void 0;
+  if (!properties) return entry.fields;
+  return entry.fields.map((field) => {
+    const property = properties[field];
+    if (!isRecord(property) || !Array.isArray(property.enum)) return field;
+    const values = property.enum.filter((value) => typeof value === "string" || typeof value === "number" || typeof value === "boolean");
+    return values.length > 0 ? `${field}=${values.join("|")}` : field;
+  });
+}
+function actionDomainGroup(entry) {
+  if (entry.kind === "official") return "official";
+  const match = /^metamask[.]([^.]+)[.]/u.exec(entry.name);
+  return match ? `metamask \xB7 ${match[1]}` : "custom";
+}
 function summarizeActionCategories(actions) {
   const counts = /* @__PURE__ */ new Map();
   for (const action of actions) counts.set(action.category, (counts.get(action.category) ?? 0) + 1);
   return [...counts.entries()].map(([name, count]) => ({ name, count })).sort((left, right) => left.name.localeCompare(right.name));
 }
-function describeManifestActions(manifest) {
+function describeManifestActions(manifest, actionSources = /* @__PURE__ */ new Map()) {
   const manifestRecord = isRecord(manifest) ? manifest : {};
   const metadata = isRecord(manifestRecord.action_metadata) ? manifestRecord.action_metadata : {};
   const official = Array.isArray(manifestRecord.supported_official_actions) ? manifestRecord.supported_official_actions.filter((value) => typeof value === "string") : [];
@@ -140,15 +237,15 @@ function describeManifestActions(manifest) {
     return [];
   }) : [];
   return [
-    ...official.map((name) => describeManifestAction(name, "official", metadata[name])),
-    ...custom.map((entry) => describeManifestAction(entry.name, "custom", entry.metadata))
+    ...official.map((name) => describeManifestAction(name, "official", metadata[name], actionSources.get(name))),
+    ...custom.map((entry) => describeManifestAction(entry.name, "custom", entry.metadata, actionSources.get(entry.name)))
   ];
 }
-function describeManifestAction(name, kind, metadata) {
+function describeManifestAction(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).sort() : [];
+  const properties = isRecord(schemaRecord.properties) ? Object.keys(schemaRecord.properties).filter((field) => field !== "action" && field !== "next").sort() : [];
   return {
     name,
     kind,
@@ -156,7 +253,17 @@ function describeManifestAction(name, kind, metadata) {
     description: typeof record.description === "string" ? record.description : "",
     fields: properties,
     schema,
-    examples: record.examples
+    examples: record.examples,
+    source: source?.name ?? (kind === "official" ? "official" : "metamask"),
+    sourceTier: source?.tier ?? (kind === "official" ? "official" : "canonical"),
+    sourceManifest: source?.manifestPath ?? "",
+    shadows: source?.shadows ?? [],
+    capabilities: [.../* @__PURE__ */ new Set([
+      ...Array.isArray(record.execution_capabilities) ? record.execution_capabilities.filter(
+        (value) => typeof value === "string"
+      ) : [],
+      ...kind === "official" ? officialRecipeActionCapabilities(name) : metaMaskActionExecutionCapabilities(name)
+    ])]
   };
 }
 function actionCategory(name, configured) {
@@ -215,6 +322,8 @@ export {
   findRelatedActions,
   fuzzyResolveActions,
   handleActions,
+  renderHumanActionCatalog,
+  renderHumanActionExample,
   searchActions,
   summarizeActionCategories
 };

package/dist/commands/parse-args.js

@@ -1,6 +1,7 @@
 import path from "node:path";
 import { detectAdapter } from "../harness.js";
 import { assertAdapter, manifestPath } from "../paths.js";
+import { explicitRecipeTrustOptions } from "../recipe-security.js";
 import { ADAPTER_DETECT_NEXT } from "./shared.js";
 import { EXIT } from "./shared.js";
 class CliError extends Error {
@@ -25,6 +26,7 @@ function parseArgs(argv, command) {
     "record",
     "plan",
     "list",
+    "describe",
     "raw",
     "categories",
     "fix",
@@ -142,13 +144,21 @@ function parsePort(value, errorMessage) {
 }
 function runtimeOptionsFromCli(options) {
   const recordVideo = options.recordVideo;
+  const trust = explicitRecipeTrustOptions({
+    sourceTrust: optionString(options, "sourceTrust"),
+    sourceKind: optionString(options, "sourceKind"),
+    sourceName: optionString(options, "sourceName"),
+    sourceDigest: optionString(options, "sourceDigest"),
+    approvalDigest: optionString(options, "approvePlan")
+  });
   return {
     cdpPort: optionString(options, "cdpPort"),
     watcherPort: optionString(options, "watcherPort") ?? optionString(options, "metroPort"),
     launchExistingDist: optionFlag(options, "launchExistingDist"),
     slot: optionString(options, "slot"),
     validationRuntimeDir: optionString(options, "validationRuntimeDir"),
-    recordVideo: recordVideo === "full-run" ? "full-run" : false
+    recordVideo: recordVideo === "full-run" ? "full-run" : false,
+    ...trust
   };
 }
 function resolveAdapter(options) {