@moda-ai/cli 1.55.36 → 1.55.38

package/dist/{cli-5fstvkva.js → cli-xtyszvq1.js}

@@ -1,10 +1,10 @@
 import {
   isAuthSessionValid,
   loadAuthSession
-} from "./cli-9bgnvth2.js";
+} from "./cli-sk1p71wr.js";
 import {
   inspectPromptManifest
-} from "./cli-6j8h2ave.js";
+} from "./cli-dmnayt2r.js";
 import {
   readHarnessSyncState,
   renderDoctorHuman,
@@ -12,7 +12,7 @@ import {
 } from "./cli-xq45etg1.js";
 import {
   callDataAPI
-} from "./cli-e23g9ywa.js";
+} from "./cli-3n040fp2.js";
 import {
   ensureSecretFilePermissions,
   getActiveProfile,
@@ -26,7 +26,7 @@ import {
   resolveSecretReference,
   resolveTenantId,
   secretFilePathFromRef
-} from "./cli-99p2jh28.js";
+} from "./cli-rcjhfts4.js";
 import {
   __require
 } from "./cli-0v6na3yp.js";
@@ -376,7 +376,7 @@ async function harnessCurrentCheck(cwd, manifestPath, manifestExists, tenantId)
     };
   }
   try {
-    const { scanHarness } = await import("./harness-6vwehf47.js");
+    const { scanHarness } = await import("./harness-qatnwxrz.js");
     const current = scanHarness({
       rootDir: cwd,
       scannerVersion: "doctor",

package/dist/cli.js

@@ -13,11 +13,14 @@ import {
   frustrationsFromEmotions,
   mapWithConcurrency,
   parseBatchTarget,
+  shapeToolCatalogDetail,
+  toolCatalogGetCommand,
+  toolFailureExamplesCommand,
   trimToolFailureConversations,
   withFrustrationAnchors,
   withToolFailureAnchors,
   withoutDetectionWindows
-} from "./cli-fwpqghgc.js";
+} from "./cli-n311b8g0.js";
 import {
   createCommandContext,
   envOptOutSet,
@@ -25,7 +28,7 @@ import {
   optOutFlagSet,
   parseBooleanFlagValue,
   withoutFlag
-} from "./cli-dr6x0zv7.js";
+} from "./cli-b7nyw498.js";
 import {
   AuditSchema,
   COMMAND_FLAG_SPECS,
@@ -44,6 +47,7 @@ import {
   SIGNALS_MANAGEMENT_SUBCOMMANDS,
   SignalLabelSchema,
   StepScoresSchema,
+  TRACE_GRAIN_FLAGS,
   UUID_RE,
   assertFlags,
   assertPositionals,
@@ -67,12 +71,12 @@ import {
   unknownSignalsSubcommandError,
   usageLine,
   writeDryRun
-} from "./cli-n2hng3gv.js";
+} from "./cli-xheg54qc.js";
 import {
   ApiError,
   callControlAPI,
   callDataAPI
-} from "./cli-e23g9ywa.js";
+} from "./cli-3n040fp2.js";
 import {
   AGENT_ERROR_CODES,
   EXIT_AUTH_REQUIRED,
@@ -109,7 +113,7 @@ import {
   shellArg,
   validateConfig,
   wasOutputCancelled
-} from "./cli-99p2jh28.js";
+} from "./cli-rcjhfts4.js";
 import {
   CliAccessError,
   CliAuthError,
@@ -1242,6 +1246,24 @@ var CANONICAL_LEAVES = [
     summary: "Tool failure leaderboard, or one tool's failure examples",
     examples: ["moda detections tools --days-back=14", "moda detections tools <tool_name> --limit=3"]
   },
+  {
+    noun: "tools",
+    verb: "list",
+    path: "tools list",
+    args: "",
+    handler: "tool-catalog",
+    summary: "Every tool called in the window: calls, failed calls, success rate, effect direction, last seen",
+    examples: ["moda tools list --days-back=7", "moda tools list --sort=failure_rate --limit=10", "moda tools list --search=calendar --direction=write"]
+  },
+  {
+    noun: "tools",
+    verb: "get",
+    path: "tools get",
+    args: "<tool_name>",
+    handler: "tool-catalog-detail",
+    summary: "One tool: calls, recorded schema and payload fields, usage over time, top failure categories",
+    examples: ["moda tools get <tool_name>", "moda tools get <tool_name> --days-back=30 --full"]
+  },
   {
     noun: "review",
     verb: "",
@@ -1275,11 +1297,12 @@ var CANONICAL_LEAVES = [
     examples: ["moda skills push --dry-run", "moda skills push"]
   }
 ];
-var CANONICAL_NOUNS = ["traces", "problems", "detections", "review", "reviews", "skills"];
+var CANONICAL_NOUNS = ["traces", "problems", "detections", "tools", "review", "reviews", "skills"];
 var NOUN_SUMMARIES = {
   traces: "Traces (agent runs): list, search, read, world state, raw spans",
   problems: "Problems ranked by root cause, their evidence, impact and lifecycle",
   detections: "Detections of every family, and the tool failure leaderboard",
+  tools: "The Tool catalog: every tool with calls and success rate, and one tool's schema, usage and failure categories",
   review: "Mark a detection a false positive, correct, or clear the mark",
   reviews: "List false-positive marks and detection reviews",
   skills: "Generate, pull, push, and install agent skills"
@@ -2959,46 +2982,46 @@ function leafManifestFields(leaf, commands) {
 import { fileURLToPath } from "url";
 import { realpathSync } from "fs";
 async function runPromptsCommand(...args) {
-  return (await import("./prompts-b8qx3mrv.js")).runPromptsCommand(...args);
+  return (await import("./prompts-cwqn8a57.js")).runPromptsCommand(...args);
 }
 async function runSkillsCommand(...args) {
-  return (await import("./skills-96z55tj4.js")).runSkillsCommand(...args);
+  return (await import("./skills-btn9r48v.js")).runSkillsCommand(...args);
 }
 async function runFixCommand(...args) {
-  return (await import("./fix-w5z02wt4.js")).runFixCommand(...args);
+  return (await import("./fix-kvszavm1.js")).runFixCommand(...args);
 }
 async function runFixesCommand(...args) {
-  return (await import("./fix-w5z02wt4.js")).runFixesCommand(...args);
+  return (await import("./fix-kvszavm1.js")).runFixesCommand(...args);
 }
 async function runHarnessCommand(...args) {
-  return (await import("./harness-6vwehf47.js")).runHarnessCommand(...args);
+  return (await import("./harness-qatnwxrz.js")).runHarnessCommand(...args);
 }
 async function runSyncCommand(...args) {
-  return (await import("./sync-drz7req6.js")).runSyncCommand(...args);
+  return (await import("./sync-ye7nxeen.js")).runSyncCommand(...args);
 }
 async function runRegistryCommand(...args) {
-  return (await import("./registry-ctnn8e26.js")).runRegistryCommand(...args);
+  return (await import("./registry-76sngjw6.js")).runRegistryCommand(...args);
 }
 async function runDoctorCommand(...args) {
-  return (await import("./doctor-tvre7zvk.js")).runDoctorCommand(...args);
+  return (await import("./doctor-xq5bjvpq.js")).runDoctorCommand(...args);
 }
 async function runStatusCommand(...args) {
-  return (await import("./doctor-tvre7zvk.js")).runStatusCommand(...args);
+  return (await import("./doctor-xq5bjvpq.js")).runStatusCommand(...args);
 }
 async function runAuthCommand(...args) {
-  return (await import("./profile-commands-h8evz9x0.js")).runAuthCommand(...args);
+  return (await import("./profile-commands-skdxe17v.js")).runAuthCommand(...args);
 }
 async function runConfigCommand(...args) {
-  return (await import("./profile-commands-h8evz9x0.js")).runConfigCommand(...args);
+  return (await import("./profile-commands-skdxe17v.js")).runConfigCommand(...args);
 }
 async function runProfilesCommand(...args) {
-  return (await import("./profile-commands-h8evz9x0.js")).runProfilesCommand(...args);
+  return (await import("./profile-commands-skdxe17v.js")).runProfilesCommand(...args);
 }
 async function runAgentCommand(...args) {
-  return (await import("./agent-g07tg64w.js")).runAgentCommand(...args);
+  return (await import("./agent-9r58v0bc.js")).runAgentCommand(...args);
 }
 async function runProductionCommand(...args) {
-  return (await import("./production-intelligence-7wb1djy2.js")).runProductionCommand(...args);
+  return (await import("./production-intelligence-j55vaw6t.js")).runProductionCommand(...args);
 }
 function parseArgs(argv) {
   const args = argv.slice(2);
@@ -3285,6 +3308,7 @@ Start here (goal -> command):
   read one trace                   moda traces get <conversation_id>   (whole trace: --all)
   what is broken                   moda overview, then moda problems list
   tool errors                      moda detections tools, then moda detections tools <tool_name>
+  tool calls, success rate, schema moda tools list, then moda tools get <tool_name>
   user emotion and frustration     moda detections list --family=emotion   (or --family=frustration)
   raw spans for one trace          moda traces spans <conversation_id|trace_id>
   a detection is wrong             moda review <kind> <target> --reason=TEXT
@@ -3300,7 +3324,7 @@ Production data:
   users / user <user_id>           End users with health and activity (the dashboard Users page)
   tail                             Live-tail new traces/detections as NDJSON (one line per item)
 
-Traces, Problems, detections and review (moda <noun> --help lists the verbs):
+Traces, Problems, detections, tools and review (moda <noun> --help lists the verbs):
 ${canonicalTreeHelpLines().join(`
 `)}
 
@@ -3650,7 +3674,9 @@ async function attachWindows(rows, windowSize, budgetBytes) {
 }
 var TOOL_FAILURE_DETAIL_DEFAULT_LIMIT = 5;
 var TOOL_FAILURE_AGENT_SUBTYPES = 20;
-async function printWithOptionalWindows(enriched, listKey, includeWindow, windowSize, output, warnings, finalize) {
+var TOOL_FAILURE_CATALOG_LINKS = 3;
+var TOOL_CATALOG_DEFAULT_LIMIT = 25;
+async function printWithOptionalWindows(enriched, listKey, includeWindow, windowSize, output, warnings, finalize, nextCommands = [], summary) {
   const allWarnings = [...warnings ?? []];
   let data = enriched;
   if (includeWindow) {
@@ -3660,7 +3686,12 @@ async function printWithOptionalWindows(enriched, listKey, includeWindow, window
   }
   if (finalize)
     data = finalize(data, allWarnings);
-  output.writeData(data, allWarnings.length > 0 ? { warnings: allWarnings } : undefined);
+  const options = {
+    ...summary ? { summary } : {},
+    ...allWarnings.length > 0 ? { warnings: allWarnings } : {},
+    ...nextCommands.length > 0 ? { nextCommands } : {}
+  };
+  output.writeData(data, Object.keys(options).length > 0 ? options : undefined);
 }
 function withoutRepeatedFrustrationWindow(data) {
   if (!Array.isArray(data.frustrations))
@@ -4506,6 +4537,91 @@ function processingDisabledWarning(data, family) {
     `${family === "emotion" ? "Emotion" : "Frustration"} analysis is disabled for this tenant (${setting} = false), ` + "so zero results do NOT mean users are not frustrated. Enable it in Settings → Account → Signal processing; " + "only traces ingested after enabling are analyzed."
   ];
 }
+function readsPerTrace(command, params, perRowScopes) {
+  const filters = TRACE_GRAIN_FLAGS[command].filter((key) => params[key] !== undefined);
+  const grain = params.group_by;
+  if (grain !== undefined && grain !== "trace" && filters.length > 0) {
+    rejectInapplicableFlags(command, params, filters, `with --group-by=${grain}; they filter the per-trace list (--group-by=trace)`);
+  }
+  const perTrace = grain === "trace" || filters.length > 0;
+  if (perTrace) {
+    rejectInapplicableFlags(command, params, perRowScopes, "to the per-trace list (--group-by=trace, or a filter that implies it); drop --group-by and the trace filters to use them");
+  }
+  return perTrace;
+}
+function setTraceFilters(query2, params, keys) {
+  query2.set("group_by", "trace");
+  for (const key of keys) {
+    const value = params[key];
+    if (value === undefined)
+      continue;
+    if (key === "signal")
+      query2.set("signals", String(value).split(",").map((part) => part.trim()).join(","));
+    else
+      query2.set(key, String(value));
+  }
+}
+function countingSummary(data) {
+  const record = asRecord(data);
+  const counting = asString(record?.counting);
+  const total = asNumber(asRecord(record?.pagination)?.total);
+  if (!counting || total === null)
+    return;
+  switch (counting) {
+    case "per_trace":
+      return `${total} trace(s) match. Counting: per trace, as the dashboard counts (pagination.total = traces).`;
+    case "per_detection":
+      return `${total} detection(s) match. Counting: per detection (one row per trace and family), not per trace; add --group-by=trace for the dashboard's per-trace count.`;
+    case "per_message":
+      return `${total} message detection(s) match. Counting: per scored message, not per trace; add --group-by=trace for the dashboard's per-trace count.`;
+    default:
+      return;
+  }
+}
+function traceStateWarnings(data) {
+  const record = asRecord(data);
+  if (asString(record?.trace_state) === "unavailable") {
+    return ["Trace processing state could not be read, so processing_status is null on every row; do not read missing detections as clean."];
+  }
+  const rows = Array.isArray(record?.conversations) ? record.conversations.map(asRecord) : [];
+  const pending = rows.filter((row) => asString(row?.processing_status) === "pending").length;
+  const errored = rows.filter((row) => asString(row?.error_message)).length;
+  const warnings = [];
+  if (pending > 0) {
+    warnings.push(`${pending} of ${rows.length} trace(s) on this page are not fully processed yet (processing_status=pending), so their detections may be incomplete; missing detections do not mean they are clean.`);
+  }
+  if (errored > 0) {
+    warnings.push(`${errored} trace(s) on this page have a processing error (error_message); their detections may be missing.`);
+  }
+  return warnings;
+}
+function singleTraceStateWarnings(value) {
+  const traceState = asRecord(value);
+  const warnings = [];
+  if (asString(traceState?.processing_status) === "pending") {
+    warnings.push("This trace is not fully processed yet (trace_state.processing_status=pending), so its detections may be incomplete; missing detections do not mean it is clean.");
+  }
+  if (asString(traceState?.error_message)) {
+    warnings.push("This trace has a processing error (trace_state.error_message); its detections may be missing.");
+  }
+  return warnings;
+}
+function customSignalProcessingWarning(data, rows) {
+  const record = asRecord(data);
+  const processing = asRecord(record?.processing);
+  const list = record?.[rows];
+  if (!processing || !Array.isArray(list) || list.length > 0)
+    return [];
+  if (processing.enabled === false) {
+    return [
+      "Custom-signal judging is disabled for this tenant (signals.custom_signals = false), so no hits does NOT mean the traces are clean. " + "Enable it in Settings → Account → Signal processing; only conversations judged after enabling get hits."
+    ];
+  }
+  if (processing.enabled === null) {
+    return ["Could not confirm whether custom-signal judging is enabled for this tenant, so treat no hits with caution."];
+  }
+  return [];
+}
 var CONTEXT_USAGE = "Usage: moda traces get <conversation_id> [--msg-index=N (alias --message-index)] [--window=0-5 | --metadata-only]";
 var CONTEXT_ALL_USAGE = "Usage: moda traces get <conversation_id> --all [--from=N] [--max-messages=N]";
 var CONTEXT_BATCH_USAGE = `Usage: moda traces get <id>[@msg_index] <id>[@msg_index] ... | --ids-from=-|<file> [--window=0-5 | --metadata-only | --all [--from=N] [--max-messages=N]] (max ${BATCH_MAX_TARGETS} targets)`;
@@ -4611,6 +4727,7 @@ async function readFullTranscript(conversationId, opts = {}) {
   let total = 0;
   let summary = null;
   let ordering;
+  let traceState;
   let nextFrom = null;
   let cursor = start;
   let readBytes = 0;
@@ -4627,6 +4744,7 @@ async function readFullTranscript(conversationId, opts = {}) {
       total = asNumber(page.total_messages) ?? 0;
       summary = stripLoneSurrogates(page.summary ?? null);
       ordering = stripLoneSurrogates(asRecord(page.ordering) ?? undefined);
+      traceState = page.trace_state;
     }
     const batch = stripLoneSurrogates(pageMessages(page));
     messages.push(...batch);
@@ -4678,6 +4796,7 @@ async function readFullTranscript(conversationId, opts = {}) {
         next_from: next,
         summary,
         ...ordering ? { ordering } : {},
+        ...traceState !== undefined ? { trace_state: traceState } : {},
         messages: returned
       },
       warnings: out,
@@ -4699,7 +4818,7 @@ async function readContextItem(params, inputWarnings, budget) {
       fits: fits ? (page) => fits(page.data, { warnings: page.warnings, nextCommands: page.nextCommands }) : undefined,
       maxBytes: budget?.maxBytes
     });
-    const fullWarnings = [...inputWarnings, ...full.warnings];
+    const fullWarnings = [...inputWarnings, ...singleTraceStateWarnings(asRecord(full.data)?.trace_state), ...full.warnings];
     return {
       data: full.data,
       options: {
@@ -4721,7 +4840,7 @@ async function readContextItem(params, inputWarnings, budget) {
   const data = params.metadata_only === true ? await readContextMetadataOnly(contextPath, query2) : await callDataAPI(`${contextPath}${queryString}`);
   const ctxRecord = asRecord(data) ?? {};
   throwIfNotFound("trace", params.conversation_id, asNumber(ctxRecord.total_messages) === 0);
-  const warnings = [...inputWarnings];
+  const warnings = [...inputWarnings, ...singleTraceStateWarnings(ctxRecord.trace_state)];
   const nextCommands = [];
   if (params.window !== undefined && params.window > CONTEXT_MAX_WINDOW) {
     const center = asNumber(asRecord(ctxRecord.context)?.center_index) ?? params.msg_index ?? 0;
@@ -5160,6 +5279,7 @@ async function runCommand(command, positional, flags, positionals = positional ?
           searchWarnings.push("--sort=slowest: no trace in this page has a known duration (synthetic timestamps), so the order is not by duration. Use --sort=longest (message count) instead.");
         }
       }
+      searchWarnings.push(...traceStateWarnings(data));
       const writeOptions = searchWarnings.length > 0 ? { warnings: searchWarnings } : undefined;
       if (params.include_world_state === true) {
         const enriched = asRecord(data) ?? {};
@@ -5327,6 +5447,15 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("limit", params.limit.toString());
       if (params.offset !== undefined)
         query2.set("offset", params.offset.toString());
+      if (readsPerTrace("frustrations", params, ["user_id", "conversation_id", "include_window"])) {
+        query2.set("family", "frustration");
+        setTraceFilters(query2, params, TRACE_GRAIN_FLAGS.frustrations);
+        const data2 = await callDataAPI(`/emotions?${query2.toString()}`);
+        const warnings = processingDisabledWarning(data2, "frustration");
+        const summary = countingSummary(data2);
+        context.output.writeData(data2, { ...summary ? { summary } : {}, ...warnings.length > 0 ? { warnings } : {} });
+        break;
+      }
       if (params.user_id)
         query2.set("user_id", params.user_id);
       if (params.conversation_id)
@@ -5338,7 +5467,7 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("include_context", "0");
       const data = frustrationsFromEmotions(await callDataAPI(`/emotions?${query2.toString()}`));
       const anchored = withFrustrationAnchors(data);
-      await printWithOptionalWindows(agentMode && !includeWindow ? withoutDetectionWindows(anchored, "frustrations", "conversation") : anchored, "frustrations", includeWindow, params.window ?? 1, context.output, processingDisabledWarning(data, "frustration"), agentMode && includeWindow ? (payload) => withoutRepeatedFrustrationWindow(payload) : undefined);
+      await printWithOptionalWindows(agentMode && !includeWindow ? withoutDetectionWindows(anchored, "frustrations", "conversation") : anchored, "frustrations", includeWindow, params.window ?? 1, context.output, processingDisabledWarning(data, "frustration"), agentMode && includeWindow ? (payload) => withoutRepeatedFrustrationWindow(payload) : undefined, [], countingSummary(data));
       break;
     }
     case "tool-failures": {
@@ -5346,7 +5475,98 @@ async function runCommand(command, positional, flags, positionals = positional ?
       const params = parseSpecFlags("tool-failures", args, command);
       const queryString = params.days_back ? `?days_back=${params.days_back}` : "";
       const data = await callDataAPI(`/tool-failures${queryString}`);
-      context.output.writeData(data);
+      const daysBack = params.days_back ?? 7;
+      const failing = (Array.isArray(asRecord(data)?.tools) ? asRecord(data).tools : []).map((row) => asString(asRecord(row)?.tool_name)).filter((name) => Boolean(name)).slice(0, TOOL_FAILURE_CATALOG_LINKS);
+      const nextCommands = failing.flatMap((name, index) => [
+        ...index === 0 ? [{ command: toolFailureExamplesCommand(name, daysBack), purpose: `Read failure examples of ${name}, the tool with the most failures.`, mutability: "read", requires_approval: false }] : [],
+        { command: toolCatalogGetCommand(name, daysBack), purpose: `Calls, recorded schema, usage over time and failure categories of ${name}.`, mutability: "read", requires_approval: false }
+      ]);
+      context.output.writeData(data, nextCommands.length > 0 ? { nextCommands } : undefined);
+      break;
+    }
+    case "tool-catalog": {
+      const params = parseSpecFlags("tool-catalog", flagsToArgs(flags), command);
+      const daysBack = params.days_back ?? 7;
+      const limit = params.limit ?? TOOL_CATALOG_DEFAULT_LIMIT;
+      const offset = params.offset ?? 0;
+      const sort = params.sort ?? "calls";
+      const query2 = new URLSearchParams({ days_back: String(daysBack), sort, limit: String(limit), offset: String(offset) });
+      if (params.search)
+        query2.set("search", params.search);
+      if (params.direction)
+        query2.set("direction", params.direction);
+      const data = asRecord(await callDataAPI(`/tools?${query2.toString()}`)) ?? {};
+      const pagination = asRecord(data.pagination);
+      const tools = Array.isArray(data.tools) ? data.tools.map((row) => asRecord(row)).filter((row) => row !== null) : [];
+      const listFlags = [
+        `--days-back=${daysBack}`,
+        ...sort !== "calls" ? [`--sort=${sort}`] : [],
+        ...params.search ? [`--search=${shellArg(params.search)}`] : [],
+        ...params.direction ? [`--direction=${params.direction}`] : []
+      ];
+      const nextCommands = [];
+      const nextOffset = asNumber(pagination?.next_offset);
+      if (pagination?.has_more === true && nextOffset !== null && nextOffset <= 1e4) {
+        nextCommands.push({
+          command: ["moda tools list", ...listFlags, `--limit=${limit}`, `--offset=${nextOffset}`].join(" "),
+          purpose: `Read the next page: tools ${nextOffset + 1}-${Math.min(nextOffset + limit, asNumber(pagination.total) ?? nextOffset + limit)} of ${asNumber(pagination.total) ?? "more"}.`,
+          mutability: "read",
+          requires_approval: false
+        });
+      }
+      const top = asString(tools[0]?.tool_name);
+      if (top) {
+        nextCommands.push({ command: toolCatalogGetCommand(top, daysBack), purpose: `Recorded schema, usage over time and failure categories of ${top}, the first tool on this page.`, mutability: "read", requires_approval: false });
+      }
+      const warnings = tools.length === 0 ? [`No tool calls recorded in the last ${daysBack} day(s)${params.search || params.direction ? " that match the filters" : ""}. Widen --days-back${params.search || params.direction ? " or drop --search/--direction" : ""}.`] : [];
+      context.output.writeData(data, {
+        ...warnings.length > 0 ? { warnings } : {},
+        ...nextCommands.length > 0 ? { nextCommands } : {}
+      });
+      break;
+    }
+    case "tool-catalog-detail": {
+      if (!positional) {
+        throw new CliInputError("<tool_name> is required", "Usage: moda tools get <tool_name> [--days-back=N] [--full]", "missing_positional", {
+          field: "<tool_name>",
+          suggestedCommands: ["moda tools list"]
+        });
+      }
+      const params = parseSpecFlags("tool-catalog-detail", flagsToArgs(flags, "tool_name", positional), command);
+      const daysBack = params.days_back ?? 7;
+      const agentMode = context.output.mode === "agent" || context.output.mode === "agent-stream";
+      let raw;
+      try {
+        raw = asRecord(await callDataAPI(`/tools/${encodeURIComponent(params.tool_name)}?days_back=${daysBack}`)) ?? {};
+      } catch (error) {
+        if (!(error instanceof ApiError) || error.statusCode !== 404)
+          throw error;
+        throw new CliNotFoundError("tool", params.tool_name, `Tool "${params.tool_name}" has no recorded calls in the last ${daysBack} day(s): the name may be mistyped, or the tool was not called in this window.`, `moda tools list --search=${shellArg(params.tool_name)} --days-back=${daysBack}`);
+      }
+      const { data, shortened } = shapeToolCatalogDetail(raw, { daysBack, shorten: agentMode && params.full !== true });
+      const warnings = [];
+      if (shortened > 0) {
+        warnings.push(`Agent output capped ${shortened} list(s) or value(s): at most 20 observed fields with 3 common values each, 5 recent calls, and 200 characters per input or sample error (the *_total fields give the full counts). Add --full for everything. The registered schema is never cut.`);
+      }
+      const definition = asRecord(data.definition);
+      if (definition && definition.registered === null) {
+        warnings.push(`No registered definition for "${params.tool_name}"; definition.observed_fields is the payload shape seen in recorded calls. Register tools with \`moda registry push\`.`);
+      }
+      const failureBlock = asRecord(data.failure_categories);
+      const totalFailures = asNumber(failureBlock?.total_failures) ?? 0;
+      const nextCommands = [];
+      if (totalFailures > 0) {
+        nextCommands.push({ command: toolFailureExamplesCommand(params.tool_name, daysBack), purpose: `Read the ${totalFailures} failure detection row(s) of ${params.tool_name}, with error text and tool input.`, mutability: "read", requires_approval: false });
+        const first = asRecord(Array.isArray(failureBlock?.categories) ? failureBlock.categories[0] : undefined);
+        const contextCommand = asString(first?.context_command);
+        if (contextCommand) {
+          nextCommands.push({ command: contextCommand, purpose: `Open the newest failure of the top category (${asString(first?.category) ?? "unknown"}) in its trace.`, mutability: "read", requires_approval: false });
+        }
+      }
+      context.output.writeData(data, {
+        ...warnings.length > 0 ? { warnings } : {},
+        ...nextCommands.length > 0 ? { nextCommands } : {}
+      });
       break;
     }
     case "tool-failure-detail": {
@@ -5401,7 +5621,12 @@ async function runCommand(command, positional, flags, positionals = positional ?
           out.push(`Showing the ${TOOL_FAILURE_AGENT_SUBTYPES} most frequent of ${subtypes.length} failure subtypes; --json lists all of them.`);
         }
         return trimmed;
-      });
+      }, [{
+        command: toolCatalogGetCommand(params.tool_name, params.days_back ?? 7),
+        purpose: subtypeCount === 0 && exampleCount === 0 ? `Check whether ${params.tool_name} was called at all in this window (it answers not found when it was not).` : `Call count, success rate, recorded schema and usage over time of ${params.tool_name}.`,
+        mutability: "read",
+        requires_approval: false
+      }]);
       break;
     }
     case "problem-impact": {
@@ -5678,7 +5903,8 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("offset", params.offset.toString());
       const queryString = query2.toString() ? `?${query2.toString()}` : "";
       const data = await callDataAPI(`/custom-signals/${id}/detections${queryString}`);
-      context.output.writeData(data);
+      const warnings = customSignalProcessingWarning(data, "detections");
+      context.output.writeData(data, warnings.length > 0 ? { warnings } : undefined);
       break;
     }
     case "trace-signals": {
@@ -5686,7 +5912,8 @@ async function runCommand(command, positional, flags, positionals = positional ?
         throw new CliInputError("<conversation_id> is required", "Usage: moda detections list --family=custom_signal --conversation-id=<conversation_id>");
       }
       const data = await callDataAPI(`/conversations/${encodeURIComponent(positional)}/custom-signals`);
-      context.output.writeData(data);
+      const warnings = customSignalProcessingWarning(data, "detections");
+      context.output.writeData(data, warnings.length > 0 ? { warnings } : undefined);
       break;
     }
     case "signal-label": {
@@ -5904,6 +6131,14 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("offset", params.offset.toString());
       if (params.family)
         query2.set("family", params.family);
+      if (readsPerTrace("emotions", params, ["user_id", "conversation_id", "include_window"])) {
+        setTraceFilters(query2, params, TRACE_GRAIN_FLAGS.emotions);
+        const data2 = await callDataAPI(`/emotions?${query2.toString()}`);
+        const warnings = processingDisabledWarning(data2, "emotion");
+        const summary2 = countingSummary(data2);
+        context.output.writeData(data2, { ...summary2 ? { summary: summary2 } : {}, ...warnings.length > 0 ? { warnings } : {} });
+        break;
+      }
       if (params.user_id)
         query2.set("user_id", params.user_id);
       if (params.conversation_id)
@@ -5916,7 +6151,8 @@ async function runCommand(command, positional, flags, positionals = positional ?
       const processingWarnings = processingDisabledWarning(raw, "emotion");
       const record = asRecord(raw);
       const data = agentMode && params.include_window !== true && record ? withoutDetectionWindows(record, "detections", "conversation_context") : raw;
-      context.output.writeData(data, processingWarnings.length > 0 ? { warnings: processingWarnings } : undefined);
+      const summary = countingSummary(data);
+      context.output.writeData(data, summary || processingWarnings.length > 0 ? { ...summary ? { summary } : {}, ...processingWarnings.length > 0 ? { warnings: processingWarnings } : {} } : undefined);
       break;
     }
     case "laziness": {
@@ -5933,9 +6169,21 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("conversation_id", params.conversation_id);
       if (params.family)
         query2.set("family", params.family);
+      if (params.conversation_id) {
+        rejectInapplicableFlags(command, params, ["search", "status", "sort", "order"], "to one trace's detections (--conversation-id); they filter and order the trace list");
+      }
+      if (params.search)
+        query2.set("search", params.search);
+      if (params.status)
+        query2.set("status", params.status);
+      if (params.sort)
+        query2.set("sort", params.sort);
+      if (params.order)
+        query2.set("order", params.order);
       const queryString = query2.toString() ? `?${query2.toString()}` : "";
       const data = await callDataAPI(`/laziness${queryString}`);
-      context.output.writeData(data);
+      const summary = countingSummary(data);
+      context.output.writeData(data, summary ? { summary } : undefined);
       break;
     }
     case "hallucinations": {
@@ -5948,13 +6196,18 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("limit", params.limit.toString());
       if (params.offset !== undefined)
         query2.set("offset", params.offset.toString());
-      if (params.conversation_id)
-        query2.set("conversation_id", params.conversation_id);
-      if (params.kind)
-        query2.set("kind", params.kind);
+      if (readsPerTrace("hallucinations", params, ["conversation_id", "kind"])) {
+        setTraceFilters(query2, params, TRACE_GRAIN_FLAGS.hallucinations);
+      } else {
+        if (params.conversation_id)
+          query2.set("conversation_id", params.conversation_id);
+        if (params.kind)
+          query2.set("kind", params.kind);
+      }
       const queryString = query2.toString() ? `?${query2.toString()}` : "";
       const data = await callDataAPI(`/hallucinations${queryString}`);
-      context.output.writeData(data);
+      const summary = countingSummary(data);
+      context.output.writeData(data, summary ? { summary } : undefined);
       break;
     }
     case "step-scores": {
@@ -6143,7 +6396,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result-and-error",
     handler: async (context) => {
-      const { runInit } = await import("./index-75vcntpe.js");
+      const { runInit } = await import("./index-y5jnz2t2.js");
       if (context.outputMode === "agent-stream") {
         context.output.writeEvent({
           event: "started",
@@ -6193,7 +6446,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result-and-error",
     handler: async (context) => {
-      const { runProvision } = await import("./provision-y5bdbh4y.js");
+      const { runProvision } = await import("./provision-ghca9d54.js");
       return runProvision(context, {
         resumeCommand: buildResumeCommand("provision", context.rawFlags)
       });
@@ -6919,6 +7172,33 @@ var commandRegistry = createCommandRegistry([
     telemetry: "result-and-error",
     handler: canonicalNounHandler
   },
+  {
+    name: "tools",
+    description: NOUN_SUMMARIES.tools,
+    examples: [...leavesOf("tools").flatMap((leaf) => leaf.examples.slice(0, 2))],
+    subcommands: treeSubcommandHelp("tools"),
+    auth: "api-key",
+    outputModes: ["human", "json", "agent"],
+    mutability: "read",
+    validateConfigBeforeRun: false,
+    resetApiRequestCountBeforeRun: false,
+    telemetry: "result-and-error",
+    handler: canonicalNounHandler
+  },
+  legacyCommand({
+    name: "tool-catalog",
+    description: "The Tool catalog: every tool called in the window with calls, failed calls, success rate, effect direction and last seen",
+    examples: ["moda tools list --sort=failure_rate --limit=10"],
+    hidden: true,
+    ...dataApiDefaults
+  }),
+  legacyCommand({
+    name: "tool-catalog-detail",
+    description: "One tool's calls, recorded schema and observed payload fields, usage over time and top failure categories",
+    examples: ["moda tools get <tool_name>"],
+    hidden: true,
+    ...dataApiDefaults
+  }),
   {
     name: "review",
     description: NOUN_SUMMARIES.review,