@deeeed/metamask-harness 0.79.0 → 0.81.0

package/dist/commands/manifest.js

@@ -1,488 +0,0 @@
-import { resolveActionManifest } from "../manifest.js";
-import { color } from "../cli-color.js";
-import { EXIT } from "./shared.js";
-import {
-  isRecord,
-  optionFlag,
-  optionString,
-  optionStrings,
-  resolveAdapter,
-  shellQuoteArg
-} from "./parse-args.js";
-import { resolveMetaMaskLibrarySources } from "./run-engine.js";
-import { isSensitiveKey, redactStructuredValue } from "../command-journal.js";
-import {
-  OFFICIAL_RECIPE_ACTIONS,
-  officialRecipeActionCapabilities
-} from "@farmslot/protocol";
-import { metaMaskActionExecutionCapabilities } from "../recipe-security.js";
-import { closest } from "../command-contract.js";
-import {
-  actionCapabilityMatrix,
-  actionCategory,
-  findRelatedActions,
-  fuzzyResolveActions,
-  resolveActionCapabilityRefusal,
-  searchActions,
-  summarizeActionCategories
-} from "@farmslot/recipe-cli";
-const OFFICIAL_ACTIONS = new Set(OFFICIAL_RECIPE_ACTIONS);
-const ACTION_MATRIX_ADAPTERS = ["mobile", "extension", "core", "terminal"];
-function actionLibraryContextArgs(librarySources) {
-  return (librarySources ?? []).filter((source) => source.name !== "metamask").map((source) => {
-    const entry = source.name ? `${source.name}=${source.root}` : source.root;
-    return ` --library ${shellQuoteArg(entry)}`;
-  }).join("");
-}
-async function handleActions({ options, positional }) {
-  const librarySources = await resolveMetaMaskLibrarySources(optionStrings(options, "library"));
-  const json = optionFlag(options, "json");
-  const action = optionString(options, "action");
-  const query = positional[0]?.trim();
-  const category = optionString(options, "category")?.toLowerCase();
-  if (optionFlag(options, "matrix")) {
-    return handleActionMatrix(options, { json, action, query, category, librarySources });
-  }
-  const { adapter, target } = resolveAdapter(options);
-  const actionManifestOverride = optionString(options, "actionManifest");
-  const { manifest, actionSources } = await resolveActionManifest(
-    adapter,
-    actionManifestOverride,
-    librarySources
-  );
-  if (optionFlag(options, "raw")) {
-    console.log(JSON.stringify(manifest, null, 2));
-    return EXIT.ok;
-  }
-  const categoriesOnly = optionFlag(options, "categories");
-  const all = describeManifestActions(manifest, actionSources);
-  const categories = summarizeActionCategories(all);
-  if (categoriesOnly && (action || category)) {
-    const message = "--categories cannot be combined with --action or --category.";
-    const userAction = `mm-harness actions --adapter ${adapter} --categories`;
-    if (json) {
-      console.log(JSON.stringify({ schemaVersion: 1, command: "actions", adapter, error: { code: "ACTION_FILTER_CONFLICT", message, userAction } }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness actions: ${message}
-  Next: ${userAction}`);
-    }
-    return EXIT.usage;
-  }
-  if (categoriesOnly) {
-    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "actions", adapter, categories }, null, 2));
-    else for (const entry of categories) console.log(`${entry.name} (${entry.count})`);
-    return EXIT.ok;
-  }
-  const categoryActions = category ? all.filter((entry) => entry.category === category) : all;
-  if (category && categoryActions.length === 0) {
-    const message = `no action category matches "${category}" for the ${adapter} adapter.`;
-    const userAction = `mm-harness actions --adapter ${adapter} --categories`;
-    if (json) {
-      console.log(JSON.stringify({ schemaVersion: 1, command: "actions", adapter, category, availableCategories: categories, error: { code: "ACTION_CATEGORY_UNKNOWN", message, userAction } }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness actions: ${message}
-  Next: ${userAction}`);
-    }
-    return EXIT.usage;
-  }
-  const actions = action ? fuzzyResolveActions(categoryActions, action) : query ? searchActions(categoryActions, query) : categoryActions;
-  if (action && actions.length === 0) {
-    const refusal = actionManifestOverride ? void 0 : resolveActionCapabilityRefusal(
-      action,
-      adapter,
-      await resolveActionCapabilityMatrix(librarySources)
-    );
-    if (refusal) {
-      const satisfying = refusal.satisfyingAdapters.join(", ");
-      const message2 = `missing action capability "${refusal.capability}" for the ${adapter} adapter.`;
-      const userAction2 = `Satisfying adapters for "${refusal.capability}": ${satisfying}. Inspect: mm-harness actions --matrix --action ${shellQuoteArg(refusal.capability)}${actionLibraryContextArgs(librarySources)} --json`;
-      if (json) {
-        console.log(JSON.stringify({
-          schemaVersion: 1,
-          command: "actions",
-          adapter,
-          action,
-          category,
-          error: {
-            code: "ACTION_CAPABILITY_UNAVAILABLE",
-            message: message2,
-            capability: refusal.capability,
-            satisfyingAdapters: refusal.satisfyingAdapters,
-            userAction: userAction2
-          }
-        }, null, 2));
-      } else {
-        console.error(`\u2717 mm-harness actions: ${message2}
-  Next: ${userAction2}`);
-      }
-      return EXIT.usage;
-    }
-    const message = `no action matches "${action}" for the ${adapter} adapter.`;
-    const userAction = `mm-harness actions --adapter ${adapter}`;
-    if (json) {
-      console.log(JSON.stringify({ schemaVersion: 1, command: "actions", adapter, action, category, error: { code: "ACTION_UNKNOWN", message, userAction } }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness actions: ${message}
-  Next: ${userAction}`);
-    }
-    return EXIT.usage;
-  }
-  if (query && actions.length === 0) {
-    const message = `no action matches search "${query}" for the ${adapter} adapter.`;
-    const userAction = `mm-harness actions --adapter ${adapter} --categories`;
-    if (json) {
-      console.log(JSON.stringify({
-        schemaVersion: 1,
-        command: "actions",
-        adapter,
-        query,
-        category,
-        error: { code: "ACTION_SEARCH_EMPTY", message, userAction }
-      }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness actions: ${message}
-  Next: ${userAction}`);
-    }
-    return EXIT.usage;
-  }
-  const relatedActions = action && actions.length === 1 ? findRelatedActions(all, actions[0]) : void 0;
-  if (json) {
-    const detailed = Boolean(action && actions.length === 1);
-    console.log(JSON.stringify({
-      schemaVersion: 1,
-      command: "actions",
-      adapter,
-      ...query ? { query } : {},
-      category,
-      detail: detailed ? "full" : "summary",
-      actions: detailed ? actions : actions.map(summarizeDescribedAction),
-      ...relatedActions?.length ? { relatedActions } : {}
-    }, null, 2));
-  } else {
-    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;
-}
-async function resolveActionCapabilityMatrix(librarySources) {
-  const catalogs = await Promise.all(
-    ACTION_MATRIX_ADAPTERS.map(async (adapter) => {
-      const { manifest, actionSources } = await resolveActionManifest(
-        adapter,
-        void 0,
-        librarySources
-      );
-      return { adapter, actions: describeManifestActions(manifest, actionSources) };
-    })
-  );
-  return actionCapabilityMatrix(catalogs);
-}
-function handleActionMatrixError(json, code, message, userAction, details = {}) {
-  if (json) {
-    console.log(JSON.stringify({
-      schemaVersion: 1,
-      command: "actions",
-      view: "matrix",
-      ...details,
-      error: { code, message, userAction }
-    }, null, 2));
-  } else {
-    console.error(`\u2717 mm-harness actions: ${message}
-  Next: ${userAction}`);
-  }
-  return EXIT.usage;
-}
-async function handleActionMatrix(options, input) {
-  const inspectCommand = `mm-harness actions --matrix${actionLibraryContextArgs(input.librarySources)} --json`;
-  const conflicts = [
-    optionFlag(options, "raw") ? "--raw" : void 0,
-    optionFlag(options, "categories") ? "--categories" : void 0,
-    optionString(options, "adapter") ? "--adapter" : void 0,
-    optionString(options, "platform") ? "--platform" : void 0,
-    optionString(options, "actionManifest") ? "--action-manifest" : void 0
-  ].filter((value) => Boolean(value));
-  if (conflicts.length > 0) {
-    return handleActionMatrixError(
-      input.json,
-      "ACTION_MATRIX_CONFLICT",
-      `--matrix cannot be combined with ${conflicts.join(", ")}.`,
-      inspectCommand
-    );
-  }
-  const matrix = await resolveActionCapabilityMatrix(input.librarySources);
-  const categories = summarizeActionCategories(matrix);
-  const categoryActions = input.category ? matrix.filter((entry) => entry.category === input.category) : matrix;
-  if (input.category && categoryActions.length === 0) {
-    return handleActionMatrixError(
-      input.json,
-      "ACTION_CATEGORY_UNKNOWN",
-      `no action category matches "${input.category}" across the adapter matrix.`,
-      inspectCommand,
-      { category: input.category, availableCategories: categories }
-    );
-  }
-  const actions = input.action ? fuzzyResolveActions(categoryActions, input.action) : input.query ? searchActions(categoryActions, input.query) : categoryActions;
-  if (input.action && actions.length === 0) {
-    return handleActionMatrixError(
-      input.json,
-      "ACTION_UNKNOWN",
-      `no action capability matches "${input.action}" across Mobile, Extension, or Core.`,
-      inspectCommand,
-      { action: input.action, category: input.category }
-    );
-  }
-  if (input.query && actions.length === 0) {
-    return handleActionMatrixError(
-      input.json,
-      "ACTION_SEARCH_EMPTY",
-      `no action capability matches search "${input.query}" across Mobile, Extension, or Core.`,
-      inspectCommand,
-      { query: input.query, category: input.category }
-    );
-  }
-  if (input.json) {
-    console.log(JSON.stringify({
-      schemaVersion: 1,
-      command: "actions",
-      view: "matrix",
-      adapters: ACTION_MATRIX_ADAPTERS,
-      ...input.query ? { query: input.query } : {},
-      ...input.category ? { category: input.category } : {},
-      actions
-    }, null, 2));
-  } else {
-    console.log(renderHumanActionMatrix(actions));
-  }
-  return EXIT.ok;
-}
-function renderHumanActionMatrix(actions) {
-  const out = (style, text) => color(style, text, { stream: process.stdout });
-  const width = Math.max("action capability".length, ...actions.map((action) => action.name.length));
-  const cell = (status, width2) => status === "available" ? out("accent", "yes".padEnd(width2)) : out("dim", "\u2014".padEnd(width2));
-  return [
-    out("bold", "action capability matrix"),
-    out("comment", "Inspect one: mm-harness actions --matrix --action <name> --json"),
-    `${"action capability".padEnd(width)}  mobile  extension  core  terminal`,
-    ...actions.map(
-      (action) => `${action.name.padEnd(width)}  ${cell(action.support.mobile, 6)}  ${cell(action.support.extension, 9)}  ${cell(action.support.core, 4)}  ${cell(action.support.terminal, 8)}`
-    )
-  ].join("\n");
-}
-function summarizeDescribedAction(entry) {
-  const { schema: _schema, examples: _examples, ...summary } = entry;
-  return summary;
-}
-function actionDomain(entry) {
-  return entry.category.replaceAll("_", "-");
-}
-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 = options.sort === "name" ? "" : options.sort === "library" ? `Library: ${entry.source}` : options.sort === "domain" ? actionDomain(entry) : actionDomainGroup(entry);
-    groups.set(group, [...groups.get(group) ?? [], entry]);
-  }
-  const lines = [out("bold", options.title), ...options.contextLines ?? [], out("comment", options.guidance)];
-  if (actions.length === 0) lines.push("No callable actions match.");
-  for (const [group, entries] of groups) {
-    const groupStyle = options.sort === "domain" ? options.domainStyles?.get(group) ?? "accent" : group === "official" ? "label" : "accent";
-    if (group) lines.push("", `${out(groupStyle, group)} ${out("dim", `(${entries.length})`)}`);
-    for (const entry of entries) {
-      const fieldNames = humanFieldNames(entry);
-      const fields = fieldNames.length ? ` ${out("dim", `fields=${fieldNames.join(",")}`)}` : "";
-      const cases = entry.result_cases?.length ? ` ${out("dim", `cases=${entry.result_cases.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(",")}`)}` : "";
-      const nameStyle = options.domainStyles?.get(actionDomain(entry)) ?? "cmd";
-      lines.push(`  ${out(nameStyle, options.displayName?.(entry) ?? entry.name)}${source}${fields}${cases}${risk}${description}`);
-    }
-  }
-  return lines.join("\n");
-}
-function renderHumanActionExample(entry, adapter, target, executable) {
-  const node = authoredExampleNode(entry.examples, void 0, entry.schema);
-  if (!node) return void 0;
-  const out = (style, text) => color(style, text, { stream: process.stdout });
-  const command = actionExampleCommand(entry, adapter, target, executable);
-  if (!command) return void 0;
-  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 actionExampleCommand(entry, adapter, target, executable, preferredValues) {
-  const node = authoredExampleNode(entry.examples, preferredValues, entry.schema);
-  if (!node) return void 0;
-  const commandName = executable.endsWith("/mm-harness") ? "mm-harness" : 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 void 0;
-  if (preferredValues && Object.keys(preferredValues).length > 0) {
-    const normalizedValues = normalizePreferredValues(preferredValues, schema);
-    const nodes = examples.filter(isRecord);
-    if (nodes.length === 0) return void 0;
-    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 void 0;
-}
-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] : void 0;
-      if (property && !matchesSchemaType(property.type, value)) return [];
-      const values = property && Array.isArray(property.enum) ? property.enum : void 0;
-      if (!values) {
-        return [[name, value]];
-      }
-      const compatibleValue = values.find(
-        (candidate) => sameActionValue(name, candidate, value)
-      );
-      if (compatibleValue !== void 0) return [[name, compatibleValue]];
-      const strings = values.filter((candidate) => typeof candidate === "string");
-      const suggestion = typeof value === "string" ? closest(value, strings) : void 0;
-      return suggestion === void 0 ? [] : [[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));
-}
-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 describeManifestActions(manifest, actionSources = /* @__PURE__ */ new Map()) {
-  const manifestRecord = isRecord(manifest) ? manifest : {};
-  const actions = isRecord(manifestRecord.actions) ? manifestRecord.actions : {};
-  return Object.entries(actions).map(
-    ([name, metadata]) => describeManifestAction(
-      name,
-      OFFICIAL_ACTIONS.has(name) ? "official" : "custom",
-      metadata,
-      actionSources.get(name)
-    )
-  );
-}
-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).filter((field) => field !== "action" && field !== "next").sort() : [];
-  return {
-    name,
-    kind,
-    category: actionCategory(name, ["metamask"]),
-    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" : "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)
-    ])]
-  };
-}
-export {
-  ACTION_MATRIX_ADAPTERS,
-  actionDomain,
-  actionExampleCommand,
-  actionLibraryContextArgs,
-  describeManifestActions,
-  handleActions,
-  renderHumanActionCatalog,
-  renderHumanActionExample,
-  renderHumanActionMatrix,
-  resolveActionCapabilityMatrix,
-  summarizeDescribedAction
-};