@deeeed/metamask-harness 0.76.0 → 0.77.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## 0.77.0 - 2026-10-04
+
+### Changed
+
+- The action catalog runs on `@farmslot/recipe-cli` 0.1.2: `actions` (lookup, search, related actions, categories, `--matrix`), `call` name lookup and `call --list` short names, and the missing-capability refusals in `call` and `run` use its catalog helpers instead of mm-harness's own copies. mm-harness still resolves the action manifest with its own policy, and flags and output are unchanged.
+
 ## 0.76.0 - 2026-10-04
 
 ### Changed

package/dist/commands/call.js

@@ -10,10 +10,9 @@ import {
   actionLibraryContextArgs,
   actionExampleCommand,
   describeManifestActions,
-  fuzzyResolveActions,
-  resolveActionCapabilityMatrix,
-  resolveActionCapabilityRefusal
+  resolveActionCapabilityMatrix
 } from "./manifest.js";
+import { fuzzyResolveActions, resolveActionCapabilityRefusal } from "@farmslot/recipe-cli";
 import {
   parseArgs,
   isRecord,
@@ -667,10 +666,7 @@ function normalizeFlagName(flag) {
   return flag.replace(/^--/u, "");
 }
 function resolveActionName(shortName, names) {
-  if (names.includes(shortName)) return { status: "ok", resolved: shortName, candidates: [shortName] };
-  const finalSegment = (name) => name.split(".").pop() ?? name;
-  const exactSegment = names.filter((name) => finalSegment(name) === shortName);
-  const tier = exactSegment.length > 0 ? exactSegment : names.filter((name) => finalSegment(name).includes(shortName));
+  const tier = fuzzyResolveActions(names.map((name) => ({ name })), shortName).map(({ name }) => name);
   if (tier.length === 1) return { status: "ok", resolved: tier[0], candidates: tier };
   if (tier.length > 1) return { status: "ambiguous", resolved: "", candidates: tier };
   return { status: "unknown", resolved: "", candidates: [] };

package/dist/commands/list-executables.js

@@ -6,12 +6,12 @@ import { color } from "../cli-color.js";
 import { EXIT } from "./shared.js";
 import { optionFlag, optionString, optionStrings, resolveAdapter, shellQuoteArg } from "./parse-args.js";
 import { actionDomain, describeManifestActions, renderHumanActionCatalog } from "./manifest.js";
+import { shortActionNames } from "@farmslot/recipe-cli";
 import {
   describeRunnableRecipe,
   listRunnableRecipes,
   resolveMetaMaskLibrarySources
 } from "./run-engine.js";
-const finalSegment = (name) => name.split(".").pop() ?? name;
 const recipeDomain = (name) => name.includes(".") ? name.split(".")[0].replaceAll("_", "-") : "general";
 function catalogDescription(description) {
   if (!description) return "";
@@ -91,27 +91,17 @@ ${out(sort === "domain" ? domainStyles.get(group) : "bold", label)} ${out("dim",
   const protocolNames = new Set(getRecipeActionManifestActionNames(manifest));
   const available = describeManifestActions(manifest, actionSources).filter((entry) => protocolNames.has(entry.name)).sort((left, right) => left.name.localeCompare(right.name));
   const described = select(available, actionDomain);
-  const shortCounts = /* @__PURE__ */ new Map();
-  for (const entry of available) {
-    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 shortByName = shortActionNames(available.map((entry) => entry.name));
+  const actions = described.map((entry) => ({
+    name: entry.name,
+    short: shortByName.get(entry.name) ?? null,
+    description: entry.description,
+    fields: entry.fields,
+    source: entry.source,
+    sourceTier: entry.sourceTier,
+    sourceManifest: entry.sourceManifest,
+    shadows: entry.shadows
+  }));
   if (json) {
     console.log(JSON.stringify({ schemaVersion: 1, command, action: "list", adapter, actions }, null, 2));
     return EXIT.ok;

package/dist/commands/manifest.js

@@ -17,6 +17,15 @@ import {
 } 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) {
@@ -178,51 +187,7 @@ async function resolveActionCapabilityMatrix(librarySources) {
       return { adapter, actions: describeManifestActions(manifest, actionSources) };
     })
   );
-  const actions = /* @__PURE__ */ new Map();
-  for (const catalog of catalogs) {
-    for (const action of catalog.actions) {
-      const entry = actions.get(action.name) ?? { entries: [], adapters: /* @__PURE__ */ new Set() };
-      entry.entries.push(action);
-      entry.adapters.add(catalog.adapter);
-      actions.set(action.name, entry);
-    }
-  }
-  return [...actions.entries()].map(([name, entry]) => {
-    const representative = entry.entries[0];
-    const satisfyingAdapters = ACTION_MATRIX_ADAPTERS.filter(
-      (adapter) => entry.adapters.has(adapter)
-    );
-    return {
-      name,
-      category: representative.category,
-      description: entry.entries.map((action) => action.description).find(Boolean) ?? "",
-      fields: [...new Set(entry.entries.flatMap((action) => action.fields))].sort(),
-      support: Object.fromEntries(
-        ACTION_MATRIX_ADAPTERS.map((adapter) => [
-          adapter,
-          entry.adapters.has(adapter) ? "available" : "unavailable"
-        ])
-      ),
-      satisfyingAdapters
-    };
-  }).sort((left, right) => left.name.localeCompare(right.name));
-}
-function resolveActionCapabilityRefusal(action, adapter, matrix) {
-  const matches = fuzzyResolveActions(matrix, action);
-  if (matches.length !== 1 || matches[0].satisfyingAdapters.includes(adapter)) {
-    return void 0;
-  }
-  return {
-    capability: matches[0].name,
-    satisfyingAdapters: matches[0].satisfyingAdapters
-  };
-}
-function missingActionCapabilities(adapter, actionNames, matrix) {
-  return [...new Set(actionNames)].flatMap((action) => {
-    const row = matrix.find((entry) => entry.name === action);
-    if (!row || row.satisfyingAdapters.includes(adapter)) return [];
-    return [{ capability: row.name, satisfyingAdapters: row.satisfyingAdapters }];
-  });
+  return actionCapabilityMatrix(catalogs);
 }
 function handleActionMatrixError(json, code, message, userAction, details = {}) {
   if (json) {
@@ -315,32 +280,6 @@ function renderHumanActionMatrix(actions) {
     )
   ].join("\n");
 }
-function fuzzyResolveActions(entries, query) {
-  const exactFull = entries.filter((e) => e.name === query);
-  if (exactFull.length > 0) return exactFull;
-  const finalSegment2 = (name) => name.split(".").pop() ?? name;
-  const exactSegment = entries.filter((e) => finalSegment2(e.name) === query);
-  if (exactSegment.length > 0) return exactSegment;
-  return entries.filter((e) => finalSegment2(e.name).includes(query));
-}
-function searchActions(entries, query) {
-  const terms = searchTerms(query);
-  if (terms.length === 0) return [];
-  return entries.map((entry) => {
-    const scores = terms.map((term) => actionSearchScore(entry, term));
-    return { entry, scores, score: scores.reduce((total, value) => total + value, 0) };
-  }).filter(({ score, scores }) => score > 0 && scores.every((value) => value > 0)).sort((left, right) => right.score - left.score || left.entry.name.localeCompare(right.entry.name)).map(({ entry }) => entry);
-}
-function findRelatedActions(entries, selected, limit = 5) {
-  const selectedNameTerms = searchTerms(finalSegment(selected.name).replaceAll("_", " "));
-  return entries.filter((entry) => entry.name !== selected.name).map((entry) => {
-    const nameTerms = new Set(searchTerms(finalSegment(entry.name).replaceAll("_", " ")));
-    const sharedScore = selectedNameTerms.filter((term) => nameTerms.has(term)).reduce((score2, term) => score2 + (GENERIC_OPERATION_TERMS.has(term) ? 5 : 30), 0);
-    const score = (entry.category === selected.category ? 100 : 0) + sharedScore;
-    return { name: entry.name, score };
-  }).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 summarizeDescribedAction(entry) {
   const { schema: _schema, examples: _examples, ...summary } = entry;
   return summary;
@@ -496,11 +435,6 @@ function actionDomainGroup(entry) {
   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, actionSources = /* @__PURE__ */ new Map()) {
   const manifestRecord = isRecord(manifest) ? manifest : {};
   const actions = isRecord(manifestRecord.actions) ? manifestRecord.actions : {};
@@ -521,7 +455,7 @@ function describeManifestAction(name, kind, metadata, source) {
   return {
     name,
     kind,
-    category: actionCategory(name),
+    category: actionCategory(name, ["metamask"]),
     description: typeof record.description === "string" ? record.description : "",
     fields: properties,
     schema,
@@ -539,72 +473,16 @@ function describeManifestAction(name, kind, metadata, source) {
     ])]
   };
 }
-function actionCategory(name) {
-  const segments = name.split(".");
-  if (segments[0] === "metamask" && segments.length > 2) return segments[1] ?? "metamask";
-  if (segments[0] === "app" || segments[0] === "cdp") return "runtime";
-  if (segments[0] === "ui") return "ui";
-  if (name.startsWith("assert_")) return "assertion";
-  if (name === "watch_logs" || name === "index_artifacts") return "evidence";
-  if (name === "command" || name === "wait" || name === "call" || name === "end") return "control";
-  return segments.length > 1 ? segments[0] || "utility" : "utility";
-}
-function actionSearchScore(entry, term) {
-  const name = entry.name.toLowerCase();
-  const segment = finalSegment(name);
-  const nameTerms = searchTerms(name.replaceAll(".", " ").replaceAll("_", " "));
-  const fields = entry.fields.map((field) => field.toLowerCase());
-  const description = entry.description.toLowerCase();
-  if (name === term) return 120;
-  if (segment === term) return 110;
-  if (entry.category === term) return 100;
-  if (fields.includes(term)) return 90;
-  if (nameTerms.includes(term)) return 80;
-  if (name.includes(term)) return 70;
-  if (fields.some((field) => field.includes(term))) return 60;
-  if (description.includes(term)) return 50;
-  if ([...nameTerms, ...fields].some((candidate) => fuzzyTermMatch(term, candidate))) return 40;
-  return 0;
-}
-function fuzzyTermMatch(term, candidate) {
-  if (term.length < 4 || candidate.length < 4) return false;
-  const threshold = Math.max(1, Math.floor(Math.max(term.length, candidate.length) / 4));
-  return levenshtein(term, candidate) <= threshold;
-}
-function searchTerms(value) {
-  return value.toLowerCase().match(/[a-z0-9]+/gu) ?? [];
-}
-function finalSegment(name) {
-  return name.split(".").pop() ?? name;
-}
-function levenshtein(left, right) {
-  const prior = Array.from({ length: right.length + 1 }, (_, index) => index);
-  for (let leftIndex = 1; leftIndex <= left.length; leftIndex += 1) {
-    const current = [leftIndex];
-    for (let rightIndex = 1; rightIndex <= right.length; rightIndex += 1) {
-      const substitution = (prior[rightIndex - 1] ?? 0) + (left[leftIndex - 1] === right[rightIndex - 1] ? 0 : 1);
-      current[rightIndex] = Math.min((current[rightIndex - 1] ?? 0) + 1, (prior[rightIndex] ?? 0) + 1, substitution);
-    }
-    for (let index = 0; index < current.length; index += 1) prior[index] = current[index] ?? 0;
-  }
-  return prior[right.length] ?? right.length;
-}
 export {
   ACTION_MATRIX_ADAPTERS,
   actionDomain,
   actionExampleCommand,
   actionLibraryContextArgs,
   describeManifestActions,
-  findRelatedActions,
-  fuzzyResolveActions,
   handleActions,
-  missingActionCapabilities,
   renderHumanActionCatalog,
   renderHumanActionExample,
   renderHumanActionMatrix,
   resolveActionCapabilityMatrix,
-  resolveActionCapabilityRefusal,
-  searchActions,
-  summarizeActionCategories,
   summarizeDescribedAction
 };

package/dist/commands/run.js

@@ -38,11 +38,8 @@ import { formatRunDiagnosticsForHuman, readRunDiagnosticsDocument } from "../run
 import { recipeTrustFailure } from "../recipe-security.js";
 import { ProvenanceDriftError } from "../execution-provenance.js";
 import { recordCommandEvidence } from "../command-journal.js";
-import {
-  actionLibraryContextArgs,
-  missingActionCapabilities,
-  resolveActionCapabilityMatrix
-} from "./manifest.js";
+import { actionLibraryContextArgs, resolveActionCapabilityMatrix } from "./manifest.js";
+import { missingActionCapabilities } from "@farmslot/recipe-cli";
 import {
   startRunNetworkObservation
 } from "../network-observation.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.76.0",
+  "version": "0.77.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -25,7 +25,7 @@
     "@farmslot/expo-recipe": "0.13.1",
     "@farmslot/handoff": "^0.3.1",
     "@farmslot/protocol": "0.34.0",
-    "@farmslot/recipe-cli": "0.1.1",
+    "@farmslot/recipe-cli": "0.1.2",
     "@farmslot/recipe-harness": "0.22.1",
     "agent-device": "0.19.3",
     "commander": "^12.0.0",