@deeeed/metamask-harness 0.80.0 → 0.82.0

package/dist/commands/call.js

@@ -1,671 +0,0 @@
-import fs from "node:fs";
-import { randomUUID } from "node:crypto";
-import path from "node:path";
-import { resolveActionManifest } from "../manifest.js";
-import { importRecipeProtocol } from "../paths.js";
-import { color, acquireCheckoutLock, isSensitiveKey, recordCommandEvidence, redactStructuredValue, conciseFailureForHuman, recipeRunning, checkoutBusyOut, EXIT, usageOut, parseArgs, isRecord, optionFlag, optionString, optionStrings, resolveAdapter, shellQuote, usageError } from "@farmslot/recipe-cli/harness";
-import {
-  actionLibraryContextArgs,
-  actionExampleCommand,
-  describeManifestActions,
-  resolveActionCapabilityMatrix
-} from "./manifest.js";
-import { fuzzyResolveActions, resolveActionCapabilityRefusal } from "@farmslot/recipe-cli";
-import { getAdapterSurface } from "../adapters/surface.js";
-import { handleListExecutables } from "./list-executables.js";
-import { applyDeviceTargeting } from "./device-target.js";
-import {
-  emitHealViolation,
-  executeWithHealBounds,
-  prepareHeal,
-  persistRunEffects,
-  resolveMetaMaskLibrarySources,
-  preflightRecipe,
-  runRecipe,
-  synthesizeOneNodeRecipe,
-  validateRecipeAdapterAware
-} from "./run-engine.js";
-import {
-  startRunNetworkObservation
-} from "../network-observation.js";
-import {
-  startRunPerformanceObservation
-} from "../performance-observation.js";
-import { closest, formatRunDiagnosticsForHuman, ProvenanceDriftError, readRunDiagnosticsDocument, recipeRunOptionsFromCli, recipeTrustFailure } from "@farmslot/recipe-cli/harness";
-import { fundingOptionsFromCli } from "../funding-execution-context.js";
-async function handleCall(argv) {
-  if (argv.includes("--list")) {
-    const { options: options2 } = parseArgs(argv);
-    return handleListExecutables("call", options2);
-  }
-  if (argv.length > 0 && argv[0].startsWith("--")) {
-    const message = "call requires <action> first: mm-harness call <action> [key=value ...] [--arg k=v ...] [flags]";
-    console.error(message);
-    return EXIT.usage;
-  }
-  const { action: shortName, args, rest } = parseCallArgs(argv);
-  const { options } = parseArgs(rest);
-  if (["domain", "source", "sort"].some((name) => optionString(options, name) !== void 0)) {
-    throw usageError("--domain, --source, and --sort require call --list.");
-  }
-  const json = optionFlag(options, "json");
-  if (!shortName) {
-    let example = "mm-harness call <action>";
-    let discovery = "mm-harness actions";
-    try {
-      const { adapter: adapter2 } = resolveAdapter(options);
-      const librarySources2 = await resolveMetaMaskLibrarySources(optionStrings(options, "library"));
-      const { manifest: manifest2 } = await resolveActionManifest(adapter2, optionString(options, "actionManifest"), librarySources2);
-      const { getRecipeActionManifestActionNames: getRecipeActionManifestActionNames2 } = await importRecipeProtocol();
-      const exampleAction = pickCallExampleAction(getRecipeActionManifestActionNames2(manifest2));
-      example = `mm-harness call ${exampleAction} --adapter ${adapter2}`;
-      discovery = `mm-harness actions --adapter ${adapter2}`;
-    } catch {
-    }
-    const message = `call requires <action>. Example: ${example}`;
-    const userAction = `${example}   # see the vocabulary: ${discovery}`;
-    if (json) console.log(JSON.stringify({
-      schemaVersion: 1,
-      command: "call",
-      status: "fail",
-      error: { code: "CLI_MISSING_POSITIONAL", message, userAction },
-      exitCode: EXIT.usage
-    }, null, 2));
-    else console.error(`${message}
-  See the vocabulary: ${discovery}`);
-    return EXIT.usage;
-  }
-  const { adapter, target } = resolveAdapter(options);
-  if (!fs.existsSync(target)) {
-    return usageOut(
-      json,
-      "call",
-      `target does not exist: ${target}`,
-      "pass --target <metamask-checkout> pointing to an existing checkout"
-    );
-  }
-  getAdapterSurface(adapter).resolveSlotPorts(target);
-  const dtResult = applyDeviceTargeting("call", adapter, options, { gate: true, rerun: "" });
-  if ("code" in dtResult) {
-    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, error: { code: dtResult.code, message: dtResult.message, userAction: dtResult.userAction } }, null, 2));
-    else console.error(`\u2717 call: ${dtResult.message}
-  Next: ${dtResult.userAction}`);
-    return EXIT.usage;
-  }
-  if (recipeRunning(target)) {
-    const msg = "a recipe is currently running \u2014 refusing to start while another recipe executes.";
-    const userAction = `inspect the checkout state with: mm-harness status --target ${shellQuote(target)} --json; retry after the active recipe finishes`;
-    if (json) {
-      console.log(JSON.stringify({ schemaVersion: 1, command: "call", status: "fail", recoverable: false, error: { code: "RECIPE_RUNNING", message: msg, userAction } }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness call: ${msg}
-  Next: ${userAction}`);
-    }
-    return EXIT.bounded;
-  }
-  const actionManifestOverride = optionString(options, "actionManifest");
-  const librarySources = await resolveMetaMaskLibrarySources(optionStrings(options, "library"));
-  const { manifest, actionSources } = await resolveActionManifest(adapter, actionManifestOverride, librarySources);
-  const { getRecipeActionManifestActionNames } = await importRecipeProtocol();
-  const names = getRecipeActionManifestActionNames(manifest);
-  const resolution = resolveActionName(shortName, names);
-  if (resolution.status === "unknown") {
-    const refusal = actionManifestOverride ? void 0 : resolveActionCapabilityRefusal(
-      shortName,
-      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 ${shellQuote(refusal.capability)}${actionLibraryContextArgs(librarySources)} --json`;
-      const error = {
-        code: "ACTION_CAPABILITY_UNAVAILABLE",
-        message: message2,
-        capability: refusal.capability,
-        satisfyingAdapters: refusal.satisfyingAdapters,
-        userAction: userAction2
-      };
-      if (json) {
-        console.log(JSON.stringify({
-          schemaVersion: 1,
-          command: "call",
-          adapter,
-          action: shortName,
-          error
-        }, null, 2));
-      } else {
-        console.error(`\u2717 call: ${message2}
-  Next: ${userAction2}`);
-      }
-      return EXIT.usage;
-    }
-    const message = `unknown action "${shortName}" for the ${adapter} adapter.`;
-    const userAction = `mm-harness actions --adapter ${adapter} --json`;
-    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, action: shortName, error: { code: "ACTION_UNKNOWN", message, userAction } }, null, 2));
-    else console.error(`\u2717 call: ${message}
-  Next: ${userAction}`);
-    return EXIT.usage;
-  }
-  if (resolution.status === "ambiguous") {
-    const message = `"${shortName}" is ambiguous: ${resolution.candidates.join(", ")} \u2014 use the full name.`;
-    const userAction = `mm-harness actions --action ${resolution.candidates[0]} --adapter ${adapter} --json`;
-    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, action: shortName, error: { code: "ACTION_AMBIGUOUS", message, candidates: resolution.candidates, userAction } }, null, 2));
-    else console.error(`\u2717 call: ${message}
-  Next: ${userAction}`);
-    return EXIT.usage;
-  }
-  const resolvedAction = resolution.resolved;
-  const describedAction = describeManifestActions(manifest, actionSources).find((entry) => entry.name === resolvedAction);
-  const defaultsUsed = actionDefaultsUsed(describedAction, args);
-  const depsBlock = await getAdapterSurface(adapter).run?.dependencyBlock?.(target, { action: resolvedAction }) ?? null;
-  if (depsBlock) {
-    if (json) {
-      console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, status: "fail", exitCode: EXIT.usage, error: depsBlock }, null, 2));
-    } else {
-      console.error(`\u2717 call: ${depsBlock.message}`);
-      console.error(`  Next: ${depsBlock.userAction}`);
-    }
-    return EXIT.usage;
-  }
-  const recipe = synthesizeOneNodeRecipe(resolvedAction, args);
-  const validation = await validateRecipeAdapterAware(adapter, recipe, manifest, librarySources);
-  if (validation.status === "invalid") {
-    const message = `call ${resolvedAction}: recipe validation failed`;
-    const parameterHelp = parameterValidationHelp(describedAction, validation.findings, args);
-    const userAction = describedAction ? actionExampleCommand(
-      describedAction,
-      adapter,
-      target,
-      process.env.MM_HARNESS_INVOKED_AS ?? process.env.MM_HARNESS_EXECUTABLE ?? "mm-harness",
-      args
-    ) ?? `mm-harness actions --action ${resolvedAction} --adapter ${adapter}` : `mm-harness actions --action ${resolvedAction} --adapter ${adapter}`;
-    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, action: shortName, resolvedAction, args: redactCallValue(args), findings: validation.findings, ...parameterHelp.length > 0 ? { parameterHelp } : {}, error: { code: "RECIPE_VALIDATION_FAILED", message, userAction } }, null, 2));
-    else {
-      console.error(`\u2717 ${message}`);
-      const taught = new Set(parameterHelp.map((entry) => `${entry.issue}:${entry.name}`));
-      for (const entry of parameterHelp) console.error(renderParameterValidationHelp(entry));
-      for (const finding of validation.findings) {
-        const name = finding.path.split(".").at(-1);
-        const issue = parameterIssue(finding.code);
-        if (issue && name && taught.has(`${issue}:${name}`)) continue;
-        console.error(`  ${finding.code} ${finding.path} \u2014 ${finding.message}`);
-      }
-      console.error(`  Next: ${userAction}`);
-    }
-    return EXIT.validation;
-  }
-  const artifactsDir = optionString(options, "artifactsDir") ?? defaultCallArtifactsDir(target, resolvedAction);
-  recordCommandEvidence(artifactsDir);
-  const requestedRuntimeOptions = {
-    ...recipeRunOptionsFromCli(adapter, options),
-    ...fundingOptionsFromCli(options)
-  };
-  const inheritedSource = process.env.FARMSLOT_RECIPE_SOURCE_TRUST || process.env.FARMSLOT_RECIPE_SOURCE_KIND || process.env.FARMSLOT_RECIPE_SOURCE_NAME || process.env.FARMSLOT_RECIPE_SOURCE_DIGEST;
-  let networkObservation;
-  let performanceObservation;
-  const callRuntimeOptions = {
-    ...requestedRuntimeOptions,
-    ...librarySources ? { librarySources } : {},
-    autoHud: false,
-    suppressLibraryResolutionLogs: true,
-    stdoutIsMachineContract: json,
-    onActionEvent: ({ nodeId, action, status }) => {
-      networkObservation?.onActionEvent({ nodeId, action, status });
-      performanceObservation?.onActionEvent({ nodeId, action, status });
-    },
-    ...requestedRuntimeOptions.source ? { source: requestedRuntimeOptions.source } : inheritedSource ? {} : {
-      source: {
-        kind: "operator",
-        trust: "trusted",
-        name: "mm-harness call"
-      }
-    }
-  };
-  let preflightedExecution;
-  try {
-    preflightedExecution = await preflightRecipe(
-      adapter,
-      recipe,
-      artifactsDir,
-      target,
-      actionManifestOverride,
-      callRuntimeOptions
-    );
-  } catch (error) {
-    const trustFailure = recipeTrustFailure(error);
-    if (!trustFailure) throw error;
-    const planDigest = trustFailure.details?.recipeDigest;
-    if (planDigest) {
-      trustFailure.userAction = `review the plan, then rerun this call with --artifacts-dir ${shellQuote(artifactsDir)} --approve-plan ${shellQuote(planDigest)}; managed callers must keep the same artifact directory and execution environment, then set FARMSLOT_RECIPE_APPROVE_PLAN=${shellQuote(planDigest)}`;
-    }
-    if (json) {
-      console.log(JSON.stringify({
-        schemaVersion: 1,
-        command: "call",
-        status: "fail",
-        error: trustFailure,
-        exitCode: EXIT.validation
-      }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness call: ${trustFailure.message}`);
-      const blocked = trustFailure.details?.blocked;
-      if (blocked?.length) {
-        console.error("  Restricted plan nodes:");
-        for (const node of blocked.slice(0, 10)) {
-          const implementation = node.implementation?.digest ? ` implementation=${node.implementation.kind ?? "custom"}@${node.implementation.digest}` : "";
-          console.error(
-            `  - ${node.nodeId}: ${node.action} [${node.capabilities.join(", ")}] source=${node.source}${implementation}`
-          );
-        }
-        if (blocked.length > 10) console.error(`  - \u2026 ${blocked.length - 10} more (use --json)`);
-      }
-      console.error(`  Next: ${trustFailure.userAction}`);
-    }
-    return EXIT.validation;
-  }
-  const lock = acquireCheckoutLock(target, "call");
-  if ("message" in lock) {
-    return checkoutBusyOut(json, "call", lock.message, lock.path);
-  }
-  try {
-    const prepared = await prepareHeal(adapter, target, options, json, {
-      appRestartAuthored: resolvedAction === "app.lifecycle" && args.command === "restart"
-    });
-    if (typeof prepared === "number") return prepared;
-    const { state } = prepared;
-    preflightedExecution = await preflightRecipe(
-      adapter,
-      recipe,
-      artifactsDir,
-      target,
-      actionManifestOverride,
-      callRuntimeOptions
-    );
-    networkObservation = await startRunNetworkObservation(
-      adapter,
-      target,
-      artifactsDir,
-      process.env,
-      {
-        cdpPort: callRuntimeOptions.cdpPort,
-        watcherPort: callRuntimeOptions.watcherPort
-      }
-    );
-    performanceObservation = startRunPerformanceObservation(
-      adapter,
-      target,
-      artifactsDir,
-      process.env,
-      {
-        cdpPort: callRuntimeOptions.cdpPort,
-        watcherPort: callRuntimeOptions.watcherPort
-      }
-    );
-    let executionResult;
-    try {
-      executionResult = await executeWithHealBounds(
-        () => {
-          const execution = preflightedExecution;
-          preflightedExecution = void 0;
-          return runRecipe(
-            adapter,
-            recipe,
-            artifactsDir,
-            target,
-            actionManifestOverride,
-            callRuntimeOptions,
-            execution,
-            state
-          );
-        },
-        target,
-        state
-      );
-    } catch (error) {
-      await networkObservation?.finalize().catch(() => void 0);
-      networkObservation = void 0;
-      await performanceObservation?.finalize().catch(() => void 0);
-      performanceObservation = void 0;
-      if (error instanceof ProvenanceDriftError) {
-        const failure = {
-          code: error.code,
-          message: error.message,
-          userAction: error.userAction,
-          provenancePath: error.provenancePath,
-          drift: error.drift
-        };
-        if (json) {
-          console.log(JSON.stringify({
-            schemaVersion: 1,
-            command: "call",
-            adapter,
-            action: shortName,
-            resolvedAction,
-            status: "fail",
-            error: failure,
-            exitCode: error.exitCode
-          }, null, 2));
-        } else {
-          console.error(`\u2717 mm-harness call: ${error.message}`);
-          console.error(`  Next: ${error.userAction}`);
-        }
-        return error.exitCode;
-      }
-      throw error;
-    }
-    const { result, violation } = executionResult;
-    await networkObservation?.finalize(result.artifactManifestPath);
-    networkObservation = void 0;
-    await performanceObservation?.finalize(result.artifactManifestPath);
-    performanceObservation = void 0;
-    persistRunEffects(result.summaryPath, result.artifactManifestPath, state);
-    if (violation !== null) {
-      const conciseFailure = violation.originalError ? conciseFailureForHuman(violation.originalError) : "";
-      const taughtViolation = violation.code === "APP_LOGIC_FAILURE" && conciseFailure.includes(" requires ") && describedAction ? { ...violation, userAction: `mm-harness actions ${resolvedAction} --adapter ${adapter} --json` } : violation;
-      return emitHealViolation(json, "call", result, taughtViolation, state, adapter);
-    }
-    const callOutput = readCallOutput(result.tracePath);
-    const safeArgs = redactCallValue(args);
-    const safeCallOutput = redactCallValue(callOutput);
-    const failureUserAction = `mm-harness last --target ${shellQuote(target)} --json`;
-    if (json) {
-      console.log(
-        JSON.stringify(
-          {
-            schemaVersion: 1,
-            command: "call",
-            adapter,
-            action: shortName,
-            resolvedAction,
-            args: safeArgs,
-            ...Object.keys(defaultsUsed).length > 0 ? { defaultsUsed } : {},
-            status: result.status,
-            summaryPath: result.summaryPath,
-            tracePath: result.tracePath,
-            artifactManifestPath: result.artifactManifestPath,
-            ...result.diagnosticsPath ? { diagnosticsPath: result.diagnosticsPath } : {},
-            ...result.sideFindings ? { sideFindings: result.sideFindings } : {},
-            ...callOutput !== void 0 ? { output: safeCallOutput } : {},
-            recovered: state.recovered,
-            mutations: state.mutations,
-            exitCode: result.status === "pass" ? EXIT.ok : EXIT.runtime,
-            ...result.status === "fail" ? { error: { code: "ACTION_EXECUTION_FAILED", message: `${resolvedAction} failed; inspect the persisted result and evidence paths`, userAction: failureUserAction } } : {}
-          },
-          null,
-          2
-        )
-      );
-    } else {
-      const renderedInputs = Object.keys(args).length > 0 ? formatCallOutput(safeArgs) : "";
-      const out = (style, text) => color(style, text, { stream: process.stdout });
-      const diagnostics = formatRunDiagnosticsForHuman(
-        readRunDiagnosticsDocument(result.diagnosticsPath),
-        adapter
-      );
-      const renderedDiagnostics = `${out("label", "Diagnostics:")}
-${diagnostics.map((line) => `  ${line}`).join("\n")}
-`;
-      console.log(
-        `${out("label", "call")} ${out("cmd", resolvedAction)}: ${out(result.status === "pass" ? "ok" : "err", result.status)}${renderedInputs ? `
-${out("label", "Inputs:")}
-${renderedInputs}` : ""}${Object.keys(defaultsUsed).length > 0 ? `
-${renderDefaultsUsed(defaultsUsed, process.stdout)}` : ""}${callOutput !== void 0 ? `
-${out("label", "Result:")}
-${formatCallOutput(safeCallOutput)}` : ""}
-` + renderedDiagnostics + `${out("label", "Artifacts:")} ${out("path", result.artifactManifestPath)}` + (result.status === "fail" ? `
-  Next: ${failureUserAction}` : "")
-      );
-    }
-    return result.status === "pass" ? EXIT.ok : EXIT.runtime;
-  } finally {
-    lock.release();
-  }
-}
-function parameterValidationHelp(action, findings, args) {
-  const schema = isRecord(action?.schema) ? action.schema : {};
-  const properties = isRecord(schema.properties) ? schema.properties : {};
-  return findings.flatMap((finding) => {
-    const issue = parameterIssue(finding.code);
-    if (!issue) return [];
-    const name = finding.path.split(".").at(-1);
-    const property = name && isRecord(properties[name]) ? properties[name] : void 0;
-    if (!name || !property) return [];
-    const validValues = Array.isArray(property.enum) ? property.enum : void 0;
-    const type = typeof property.type === "string" ? property.type : Array.isArray(property.type) ? property.type.filter((value) => typeof value === "string").join("|") : void 0;
-    const received = Object.hasOwn(args, name) ? args[name] : void 0;
-    const suggestion = issue === "invalid" && received !== void 0 && validValues ? closest(String(received), validValues.map(String)) : void 0;
-    return [{
-      issue,
-      name,
-      ...type ? { type } : {},
-      ...validValues ? { validValues } : {},
-      ...typeof property.description === "string" ? { description: property.description } : {},
-      ...issue === "invalid" && received !== void 0 ? { received } : {},
-      ...suggestion ? { suggestion } : {}
-    }];
-  });
-}
-function parameterIssue(code) {
-  if (code === "recipe.missing_param") return "missing";
-  if (code === "recipe.invalid_param_value_enum") return "invalid";
-  return void 0;
-}
-function renderParameterValidationHelp(parameter) {
-  const out = (style, text) => color(style, text, { stream: process.stderr });
-  const heading = parameter.issue === "missing" ? `${out("cmd", parameter.name)}${parameter.type ? ` (${parameter.type}, required)` : " (required)"}` : `${out("cmd", parameter.name)} received ${out("err", JSON.stringify(parameter.received) ?? String(parameter.received))}`;
-  const values = parameter.validValues?.length ? ` Valid values: ${parameter.validValues.map((value) => out("accent", String(value))).join(", ")}.` : "";
-  const suggestion = parameter.suggestion ? ` Did you mean ${out("accent", JSON.stringify(parameter.suggestion))}?` : "";
-  const description = parameter.description ? ` ${parameter.description}` : "";
-  return `  ${heading}.${values}${suggestion}${description}`;
-}
-function actionDefaultsUsed(action, args) {
-  const schema = isRecord(action?.schema) ? action.schema : {};
-  const properties = isRecord(schema.properties) ? schema.properties : {};
-  return Object.fromEntries(
-    Object.entries(properties).filter(([name, entry]) => !Object.hasOwn(args, name) && isRecord(entry) && Object.hasOwn(entry, "default")).map(([name, entry]) => [name, entry.default])
-  );
-}
-function renderDefaultsUsed(defaults, stream) {
-  const out = (style, text) => color(style, text, { stream });
-  const values = Object.entries(defaults).map(([name, value]) => `${out("cmd", name)}=${out("accent", JSON.stringify(value) ?? String(value))}`).join(", ");
-  return `${out("label", "Defaults used:")} ${values}`;
-}
-function defaultCallArtifactsDir(target, action) {
-  const actionStem = action.replace(/[^a-zA-Z0-9._-]/gu, "_");
-  return path.join(target, "temp", "recipe", "calls", `${actionStem}-${randomUUID()}`);
-}
-function readCallOutput(tracePath) {
-  try {
-    const trace = JSON.parse(fs.readFileSync(tracePath, "utf8"));
-    const entries = Array.isArray(trace) ? trace : isRecord(trace) && Array.isArray(trace.entries) ? trace.entries : [];
-    const entry = entries.find((item) => isRecord(item) && item.nodeId === "call");
-    return isRecord(entry) && Object.prototype.hasOwnProperty.call(entry, "output") ? entry.output : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function formatCallOutput(value) {
-  if (typeof value === "string") return value;
-  if (typeof value === "number" || typeof value === "boolean" || value === null) return String(value);
-  return JSON.stringify(value, null, 2);
-}
-function redactCallValue(value, key = "") {
-  return key && isSensitiveKey(key) ? "<redacted>" : redactStructuredValue(value);
-}
-async function handleCallHelp(argv, genericHelp) {
-  const { action: shortName, rest } = parseCallArgs(argv.filter((arg) => arg !== "--help" && arg !== "-h"));
-  const { options } = parseArgs(rest);
-  let adapter;
-  let manifest;
-  let actionSources = /* @__PURE__ */ new Map();
-  try {
-    ({ adapter } = resolveAdapter(options));
-    const librarySources = await resolveMetaMaskLibrarySources(optionStrings(options, "library"));
-    const resolution = await resolveActionManifest(adapter, optionString(options, "actionManifest"), librarySources);
-    manifest = resolution.manifest;
-    actionSources = resolution.actionSources;
-  } catch {
-    process.stdout.write(`${genericHelp}
-`);
-    return EXIT.ok;
-  }
-  const matches = shortName ? fuzzyResolveActions(describeManifestActions(manifest, actionSources), shortName) : [];
-  if (matches.length === 0) {
-    process.stdout.write(`${genericHelp}
-`);
-    if (shortName) {
-      process.stdout.write(
-        `
-No action matches "${shortName}" for the ${adapter} adapter.
-  Next: mm-harness actions --adapter ${adapter}   # list the action vocabulary
-`
-      );
-    }
-    return EXIT.ok;
-  }
-  for (const entry of matches) process.stdout.write(renderCallActionHelp(entry));
-  process.stdout.write(`${genericHelp}
-`);
-  return EXIT.ok;
-}
-function renderCallActionHelp(entry) {
-  const short = entry.name.split(".").pop() ?? entry.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 = [`mm-harness 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})` : ""}`, "");
-  const names = Object.keys(properties).filter((name) => name !== "action" && name !== "next").sort();
-  if (names.length === 0) {
-    lines.push("  Fields: (none)");
-  } else {
-    lines.push("  Fields (pass as <name>=<value> or --arg <name>=<value>):");
-    const width = Math.max(...names.map((name) => name.length));
-    for (const name of names) {
-      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" ? ` \u2014 ${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 = renderCallExamples(short, entry.examples);
-  if (examples.length > 0) {
-    lines.push("", "  Examples:");
-    for (const example of examples) lines.push(`    ${example}`);
-  }
-  return `${lines.join("\n")}
-
-`;
-}
-function renderCallExamples(short, examples) {
-  if (!Array.isArray(examples)) return [];
-  const out = [];
-  for (const example of examples.slice(0, 2)) {
-    const node = isRecord(example) ? example : void 0;
-    if (!node) continue;
-    const tokens = Object.entries(node).filter(([key]) => key !== "action" && key !== "intent").map(([key, value]) => `${key}=${typeof value === "string" ? value : JSON.stringify(value)}`);
-    out.push(`mm-harness call ${short} ${tokens.join(" ")}`.trim());
-  }
-  return out;
-}
-function parseCallArgs(argv) {
-  const args = {};
-  const rest = [];
-  let action;
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg === "--arg" || arg.startsWith("--arg=")) {
-      const pair = arg === "--arg" ? argv[i += 1] : arg.slice("--arg=".length);
-      if (pair === void 0) throw usageError("--arg requires k=v.");
-      const eq = pair.indexOf("=");
-      if (eq === -1) throw usageError(`--arg must be k=v: ${pair}`);
-      args[pair.slice(0, eq)] = parseCallValue(pair.slice(eq + 1));
-      continue;
-    }
-    if (!arg.startsWith("--") && action === void 0) {
-      action = arg;
-      continue;
-    }
-    if (action !== void 0 && !isForwardedOptionValue(argv, i) && isArgPair(arg)) {
-      const eq = arg.indexOf("=");
-      args[arg.slice(0, eq)] = parseCallValue(arg.slice(eq + 1));
-      continue;
-    }
-    rest.push(arg);
-  }
-  return { action, args, rest };
-}
-function parseCallValue(value) {
-  if (value === "true") return true;
-  if (value === "false") return false;
-  if (value === "null") return null;
-  if (/^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/u.test(value)) {
-    const number = Number(value);
-    if (Number.isFinite(number)) return number;
-  }
-  if (value.startsWith("[") && value.endsWith("]") || value.startsWith("{") && value.endsWith("}") || value.startsWith('"') && value.endsWith('"')) {
-    try {
-      return JSON.parse(value);
-    } catch {
-    }
-  }
-  return value;
-}
-function isArgPair(value) {
-  const eq = value.indexOf("=");
-  return eq > 0;
-}
-function isForwardedOptionValue(argv, index) {
-  if (index === 0) return false;
-  const previous = argv[index - 1];
-  if (!previous.startsWith("--") || previous.includes("=")) return false;
-  return VALUE_TAKING_CALL_FLAGS.has(normalizeFlagName(previous));
-}
-const VALUE_TAKING_CALL_FLAGS = /* @__PURE__ */ new Set([
-  "action-manifest",
-  "approve-plan",
-  "adapter",
-  "artifacts-dir",
-  "cdp-port",
-  "device",
-  "heal",
-  "library",
-  "metro-port",
-  "platform",
-  "slot",
-  "source-digest",
-  "source-kind",
-  "source-name",
-  "source-trust",
-  "target",
-  "validation-runtime-dir",
-  "watcher-port"
-]);
-function normalizeFlagName(flag) {
-  return flag.replace(/^--/u, "");
-}
-function resolveActionName(shortName, names) {
-  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: [] };
-}
-function pickCallExampleAction(names) {
-  const walletish = names.find((name) => /wallet|unlock/u.test(name));
-  if (walletish) return walletish;
-  if (names.includes("command")) return "command";
-  return names[0] ?? "command";
-}
-export {
-  defaultCallArtifactsDir,
-  handleCall,
-  handleCallHelp,
-  redactCallValue
-};