@moda-ai/cli 1.55.25 → 1.55.27

package/dist/{cli-dn91fb56.js → cli-wzds257x.js}

@@ -2,16 +2,18 @@ import {
   ApiError,
   callControlAPI,
   callDataAPI
-} from "./cli-9btx12wp.js";
+} from "./cli-pg5qfmqc.js";
 import {
   CliAccessError,
   CliInputError,
+  continuationCommand,
   embeddedTenantIdFromApiKey,
   isPlatformApiKey,
   resolveApiKey,
   resolveApiTenantId,
-  setPlatformTenantOverride
-} from "./cli-dve50x7p.js";
+  setPlatformTenantOverride,
+  shellArg
+} from "./cli-r5pp7qny.js";
 
 // src/schemas.ts
 import { z } from "zod";
@@ -41,12 +43,12 @@ var ClustersSchema = z.object({
   search: z.string().min(2).max(200).optional().describe("Find clusters by name or meaning"),
   node_id: z.string().min(1).max(512).optional().describe("Resolve one cluster node by id (deep link)"),
   mode: z.enum(["fuzzy", "semantic", "hybrid"]).optional().describe("Cluster search mode (server default hybrid)"),
-  limit: z.number().min(1).max(50).optional().describe("Maximum clusters to return (with --search/--node-id)")
+  limit: z.number().int().min(1).max(50).optional().describe("Maximum clusters to return (with --search/--node-id)")
 });
 var ClusterConversationsSchema = z.object({
   node_id: z.string().describe("Cluster node id (from moda clusters)"),
-  limit: z.number().min(1).max(100).default(10).optional().describe("Maximum traces to return"),
-  offset: z.number().min(0).default(0).optional().describe("Number of traces to skip")
+  limit: z.number().int().min(1).max(100).default(10).optional().describe("Maximum traces to return"),
+  offset: z.number().int().min(0).default(0).optional().describe("Number of traces to skip")
 });
 var ConversationsSchema = z.object({
   search: z.string().optional().describe("Ranked trace search (hybrid when embeddings exist, else keyword)"),
@@ -60,20 +62,20 @@ var ConversationsSchema = z.object({
   outcome: z.enum(["any", "positive", "negative"]).default("any").optional().describe("Filter by trace outcome (trajectory + frustration)"),
   include_world_state: boolFlag().describe("Attach each result's world-state summary"),
   sort: z.enum(["recent", "longest", "slowest"]).optional().describe("recent = newest activity, longest = most messages, slowest = longest span"),
-  limit: z.number().min(1).max(100).default(20).optional().describe("Maximum traces to return"),
-  offset: z.number().min(0).default(0).optional().describe("Number of traces to skip")
+  limit: z.number().int().min(1).max(100).default(20).optional().describe("Maximum traces to return"),
+  offset: z.number().int().min(0).default(0).optional().describe("Number of traces to skip")
 });
 var WorldStateSchema = z.object({
   conversation_id: z.string().describe("Trace ID"),
   summary_only: boolFlag().describe("Segment summaries only (omit the event stream)"),
-  event_limit: z.number().min(1).max(5000).default(2000).optional().describe("Maximum world-state events to return"),
+  event_limit: z.number().int().min(1).max(5000).default(2000).optional().describe("Maximum world-state events to return"),
   snapshot: boolFlag().describe("Folded slots at one tick (what the agent believed at that turn)"),
-  msg_index: z.number().min(0).max(1e5).optional().describe("Snapshot tick: message index (default 0)"),
-  block_index: z.number().min(0).max(1e5).optional().describe("Snapshot tick: content block index (default 0)"),
-  segment_index: z.number().min(0).max(65535).optional().describe("Scope the snapshot to one segment"),
+  msg_index: z.number().int().min(0).max(1e5).optional().describe("Snapshot tick: message index (default 0)"),
+  block_index: z.number().int().min(0).max(1e5).optional().describe("Snapshot tick: content block index (default 0)"),
+  segment_index: z.number().int().min(0).max(65535).optional().describe("Scope the snapshot to one segment"),
   replay: boolFlag().describe("State-over-time replay (frames mode needs --message-count)"),
   format: z.enum(["frames", "fold-inputs"]).optional().describe("Replay format (default frames)"),
-  message_count: z.number().min(1).max(1e6).optional().describe("Messages to fold in frames mode")
+  message_count: z.number().int().min(1).max(1e6).optional().describe("Messages to fold in frames mode")
 });
 var ContextSchema = z.object({
   conversation_id: z.string().min(1).describe("Trace ID"),
@@ -87,10 +89,10 @@ var ContextSchema = z.object({
 });
 var FrustrationsSchema = z.object({
   days_back: daysBackFlag(7),
-  limit: z.number().min(1).max(20).default(10).optional().describe("Maximum detections to return"),
-  offset: z.number().min(0).default(0).optional().describe("Number of detections to skip"),
+  limit: z.number().int().min(1).max(20).default(10).optional().describe("Maximum detections to return"),
+  offset: z.number().int().min(0).default(0).optional().describe("Number of detections to skip"),
   include_window: boolFlag().describe("Attach the surrounding messages to each detection (agent output omits them by default)"),
-  window: z.number().min(1).max(5).default(1).optional().describe("Messages on each side with --include-window"),
+  window: z.number().int().min(1).max(5).default(1).optional().describe("Messages on each side with --include-window"),
   user_id: z.string().min(1).max(256).optional().describe("Scope everything to one end user"),
   conversation_id: z.string().min(1).max(256).optional().describe("Scope everything to one trace ID")
 });
@@ -99,7 +101,7 @@ var ToolFailuresSchema = z.object({
 });
 var ProblemsSchema = z.object({
   days_back: daysBackFlag(30),
-  limit: z.number().min(1).max(25).default(25).optional().describe("Maximum Problems to return")
+  limit: z.number().int().min(1).max(25).default(25).optional().describe("Maximum Problems to return")
 });
 var REMAINDER_FAMILIES = [
   "tool_failure",
@@ -112,7 +114,7 @@ var REMAINDER_FAMILIES = [
 ];
 var ProblemsRemainderSchema = z.object({
   days_back: daysBackFlag(30),
-  limit: z.number().min(1).max(25).default(25).optional().describe("Maximum groups to return"),
+  limit: z.number().int().min(1).max(25).default(25).optional().describe("Maximum groups to return"),
   family: z.enum(REMAINDER_FAMILIES).optional().describe("Only this signal family (frustration is under emotion)"),
   cursor: z.string().min(1).max(4096).optional().describe("next_cursor from the previous page, verbatim")
 });
@@ -150,7 +152,7 @@ var ProblemSchema = z.object({
   conversations: boolFlag().describe("Legacy alias of --traces"),
   feedback: boolFlag().describe("Feedback history page"),
   full: boolFlag().describe("Complete dossier in agent output (default is a compact dossier)"),
-  limit: z.number().min(1).max(50).optional().describe("Page size for a sub-resource page"),
+  limit: z.number().int().min(1).max(50).optional().describe("Page size for a sub-resource page"),
   cursor: z.string().optional().describe("next_cursor from the previous page, verbatim"),
   family: z.enum(PROBLEM_FAMILIES).optional().describe("With --traces: only this signal family"),
   door: z.enum(PROBLEM_DOORS).optional().describe("With --traces: only this attribution door")
@@ -180,8 +182,8 @@ var SignalSchema = z.object({
   id: z.string().min(1).max(255).describe("Custom signal id"),
   detections: boolFlag().describe("List recent hits instead of the summary"),
   days_back: daysBackFlag(),
-  limit: z.number().min(1).max(20).optional().describe("Hits page size (server default 10)"),
-  offset: z.number().min(0).max(1e4).optional().describe("Number of hits to skip")
+  limit: z.number().int().min(1).max(20).optional().describe("Hits page size (server default 10)"),
+  offset: z.number().int().min(0).max(1e4).optional().describe("Number of hits to skip")
 });
 var SIGNAL_LABELS = ["fits", "does_not_fit"];
 var SignalLabelSchema = z.object({
@@ -251,8 +253,8 @@ var EMOTION_FAMILIES = [
 ];
 var EmotionsSchema = z.object({
   days_back: daysBackFlag(7),
-  limit: z.number().min(1).max(20).default(10).optional().describe("Maximum detections to return"),
-  offset: z.number().min(0).max(1e4).optional().describe("Number of detections to skip"),
+  limit: z.number().int().min(1).max(20).default(10).optional().describe("Maximum detections to return"),
+  offset: z.number().int().min(0).max(1e4).optional().describe("Number of detections to skip"),
   family: z.enum(EMOTION_FAMILIES).optional().describe("Only this family in the detections list (summary covers all)"),
   user_id: z.string().min(1).max(256).optional().describe("Scope everything to one end user"),
   conversation_id: z.string().min(1).max(256).optional().describe("Scope everything to one trace ID"),
@@ -260,8 +262,8 @@ var EmotionsSchema = z.object({
 });
 var HallucinationsSchema = z.object({
   days_back: daysBackFlag(7),
-  limit: z.number().min(1).max(20).default(10).optional().describe("Maximum detections to return"),
-  offset: z.number().min(0).max(1e4).optional().describe("Number of detections to skip"),
+  limit: z.number().int().min(1).max(20).default(10).optional().describe("Maximum detections to return"),
+  offset: z.number().int().min(0).max(1e4).optional().describe("Number of detections to skip"),
   conversation_id: z.string().max(200).optional().describe("Scope summary and list to one trace ID"),
   kind: z.enum(["contradicted", "verified"]).optional().describe("Only this kind in the detections list")
 });
@@ -288,8 +290,8 @@ var LAZINESS_FAMILIES = [
 ];
 var LazinessSchema = z.object({
   days_back: daysBackFlag(7),
-  limit: z.number().min(1).max(50).default(10).optional().describe("Maximum detections to return"),
-  offset: z.number().min(0).max(1e4).optional().describe("Number of detections to skip"),
+  limit: z.number().int().min(1).max(50).default(10).optional().describe("Maximum detections to return"),
+  offset: z.number().int().min(0).max(1e4).optional().describe("Number of detections to skip"),
   conversation_id: z.string().max(200).optional().describe("One trace's detections"),
   family: z.enum(LAZINESS_FAMILIES).optional().describe("Only this laziness family")
 });
@@ -298,30 +300,32 @@ var StepScoresSchema = z.object({
 });
 var TAIL_SIGNALS = ["traces", "conversations", "emotions", "all"];
 var TailSchema = z.object({
-  interval: z.number().min(5).max(3600).default(15).optional().describe("Seconds between polls"),
+  interval: z.number().int().min(5).max(3600).default(15).optional().describe("Seconds between polls"),
   signal: z.enum(TAIL_SIGNALS).default("traces").optional().describe("What to tail (conversations = legacy alias of traces)"),
   once: boolFlag().describe("Poll once, then exit (baseline page)"),
-  limit: z.number().min(1).max(50).default(20).optional().describe("Page size per poll"),
-  max_events: z.number().min(1).max(1e5).optional().describe("Stop after this many stdout records"),
+  limit: z.number().int().min(1).max(50).default(20).optional().describe("Page size per poll"),
+  max_events: z.number().int().min(1).max(1e5).optional().describe("Stop after this many stdout records"),
   full_scan: boolFlag().describe("Emotions: scan the whole window, not the top-scoring prefix (many more requests)")
 });
 var ToolFailureDetailSchema = z.object({
   tool_name: z.string().describe("Tool name (from moda detections tools)"),
   subtype: z.string().optional().describe("Only this failure subtype"),
   days_back: daysBackFlag(7),
-  limit: z.number().min(1).max(20).default(5).optional().describe("Maximum examples to return"),
-  offset: z.number().min(0).default(0).optional().describe("Number of examples to skip"),
+  limit: z.number().int().min(1).max(20).default(5).optional().describe("Maximum examples to return"),
+  offset: z.number().int().min(0).default(0).optional().describe("Number of examples to skip"),
   include_window: boolFlag().describe("Embed each example's surrounding messages (on by default)"),
   compact: boolFlag().describe("Drop each example's embedded messages (same as --include-window=false)"),
-  window: z.number().min(1).max(5).default(1).optional().describe("Messages on each side of the anchor")
+  window: z.number().int().min(1).max(5).default(1).optional().describe("Messages on each side of the anchor")
 });
 var AuditSchema = z.object({
   id: z.string().min(1).describe("Trace ID or OTLP trace_id"),
   kind: z.enum(["auto", "trace", "conversation"]).default("auto").optional().describe("How to read the id (auto tries trace, then conversation)"),
   include_raw: boolFlag().describe("Include raw span rows"),
   include_bodies: boolFlag().describe("Keep prompt/response bodies (omitted by default; long strings truncated)"),
-  limit: z.number().min(1).max(1000).default(200).optional().describe("Ingest rows to read; warns when capped"),
+  limit: z.number().int().min(1).max(1000).default(200).optional().describe("Ingest rows to read; warns when capped"),
   cursor: z.string().min(1).max(512).optional().describe("next_cursor from the previous page"),
+  span_offset: z.number().int().min(0).max(1e5).optional().describe("Skip this many spans of the page (continues a page cut to the agent output limit)"),
+  page_bytes: z.number().int().min(1).max(1e7).optional().describe("Server page size in bytes (keeps a --span-offset continuation on the same page)"),
   ids_from: z.string().min(1).optional().describe("Read several trace ids, one per line, from a file or - for stdin (batch mode, up to 25)")
 });
 var TIME_RANGES = ["all", "1h", "3d", "7d", "24h", "30d", "90d"];
@@ -334,9 +338,9 @@ var SearchSchema = z.object({
   time_range: z.enum(TIME_RANGES).default("all").optional().describe("Time window"),
   since: isoBoundFlag().describe("Absolute UTC start, inclusive (ISO date or datetime); intersected with --time-range"),
   until: isoBoundFlag().describe("Absolute UTC end, inclusive (ISO date or datetime; a date covers that whole day)"),
-  limit: z.number().min(1).max(100).default(20).optional().describe("Maximum results to return"),
+  limit: z.number().int().min(1).max(100).default(20).optional().describe("Maximum results to return"),
   include_tool_io: boolFlag().describe("Also search tool inputs and outputs"),
-  offset: z.number().min(0).max(1e4).optional().describe("Skip results (pages the trace-level fallback only)")
+  offset: z.number().int().min(0).max(1e4).optional().describe("Skip results (pages the trace-level fallback only)")
 });
 var InvestigateSchema = z.object({
   days_back: daysBackFlag(7),
@@ -500,19 +504,58 @@ function dedicatedCommandHint(category, rawCategory) {
   return "Feedback is read by the Moda team but does not change the problem. To act on it directly, use " + "`moda problems feedback <problem_id> --action=flag_attribution --attribution-id=<uuid> --reason=TEXT` (a trace wrongly " + "attributed to a problem), `moda review <kind> <target> --reason=TEXT` (a detection that should not " + "have fired), or `moda fix dismiss <fix_id> --reason=TEXT` (a fix aimed at the wrong problem).";
 }
 
+// src/dry-run.ts
+function plannedEndpoint(plane, path) {
+  return plane === "data" ? `/api/v1/data${path}` : `/api${path}`;
+}
+function realRunCommand(context) {
+  const invocation = context.invocation ?? {
+    command: context.command,
+    positionals: context.positionals,
+    flags: context.rawFlags,
+    ...context.bareFlags ? { bareFlags: context.bareFlags } : {}
+  };
+  const flags = Object.fromEntries(Object.entries(invocation.flags).filter(([key]) => key.replace(/_/g, "-") !== "dry-run"));
+  return continuationCommand({ ...invocation, flags }, {});
+}
+function writeDryRun(context, request) {
+  const endpoint = plannedEndpoint(request.plane, request.path);
+  const command = realRunCommand(context);
+  context.output.writeData({
+    dryRun: true,
+    planned: {
+      method: request.method,
+      endpoint,
+      ...request.body !== undefined ? { body: request.body } : {},
+      ...request.generatedFields?.length ? { generated_at_send: request.generatedFields } : {}
+    }
+  }, {
+    summary: { text: `Dry run: would ${request.method} ${endpoint}. Nothing was sent.`, confidence: "high" },
+    nextCommands: [{
+      command,
+      purpose: "Send this write for real (the same command without --dry-run).",
+      mutability: "write",
+      requires_approval: true
+    }]
+  });
+}
+
 // src/command-flags.ts
 import { z as z3 } from "zod";
+var DRY_RUN = z3.object({
+  dry_run: z3.boolean().optional().describe("Validate and print the exact request (method, path, body); send nothing")
+});
 var TRACE_ID = { name: "conversation_id", key: "conversation_id", required: true };
 var PROBLEM_ID = { name: "problem_id", key: "id", required: true };
 var COMMAND_FLAG_SPECS = {
   overview: { schema: OverviewSchema, extra: z3.object({ raw: z3.boolean().optional().describe("Print the raw briefing data") }) },
   investigate: { schema: InvestigateSchema, handParsed: true },
   failures: { schema: FailuresSchema, handParsed: true },
-  ask: { schema: AskSchema, handParsed: true, positionals: [{ name: "question", key: "question", required: true }] },
+  ask: { schema: AskSchema, handParsed: true, positionals: [{ name: "question", key: "question", required: true, variadic: true }] },
   clusters: { schema: ClustersSchema },
   "cluster-traces": { schema: ClusterConversationsSchema, positionals: [{ name: "node_id", key: "node_id", required: true }] },
   traces: { schema: ConversationsSchema },
-  search: { schema: SearchSchema, positionals: [{ name: "query", key: "q", required: true }] },
+  search: { schema: SearchSchema, positionals: [{ name: "query", key: "q", required: true, variadic: true }] },
   "world-state": { schema: WorldStateSchema, positionals: [TRACE_ID] },
   context: {
     schema: ContextSchema,
@@ -529,14 +572,15 @@ var COMMAND_FLAG_SPECS = {
   },
   "problem-impact": { schema: ProblemImpactSchema, handParsed: true },
   problem: { schema: ProblemSchema, positionals: [PROBLEM_ID] },
-  "problem-feedback": { schema: ProblemFeedbackSchema, handParsed: true, positionals: [PROBLEM_ID] },
+  "problem-feedback": { schema: ProblemFeedbackSchema, extra: DRY_RUN, handParsed: true, positionals: [PROBLEM_ID] },
   "problem-reopen": { schema: ProblemReopenSchema, handParsed: true, positionals: [PROBLEM_ID] },
   "problem-linear": { schema: ProblemLinearSchema, handParsed: true, positionals: [PROBLEM_ID] },
-  "problem-linear-file": { schema: ProblemLinearFileSchema, handParsed: true, positionals: [PROBLEM_ID] },
+  "problem-linear-file": { schema: ProblemLinearFileSchema, extra: DRY_RUN, handParsed: true, positionals: [PROBLEM_ID] },
   "detection-reviews": { schema: DetectionReviewsSchema, handParsed: true, positionals: [TRACE_ID] },
-  "detection-review": { schema: DetectionReviewSchema, handParsed: true, positionals: [PROBLEM_ID] },
+  "detection-review": { schema: DetectionReviewSchema, extra: DRY_RUN, handParsed: true, positionals: [PROBLEM_ID] },
   "false-positive": {
     schema: FalsePositiveSchema,
+    extra: DRY_RUN,
     handParsed: true,
     positionals: [
       { name: "kind", key: "kind", required: true },
@@ -551,7 +595,7 @@ var COMMAND_FLAG_SPECS = {
   signals: { schema: SignalsListSchema, handParsed: true },
   signal: { schema: SignalSchema, positionals: [{ name: "signal_id", key: "id", required: true }] },
   "trace-signals": { schema: TraceSignalsSchema, handParsed: true, positionals: [TRACE_ID] },
-  "signal-label": { schema: SignalLabelSchema, handParsed: true, positionals: [{ name: "signal_id", key: "id", required: true }] },
+  "signal-label": { schema: SignalLabelSchema, extra: DRY_RUN, handParsed: true, positionals: [{ name: "signal_id", key: "id", required: true }] },
   emotions: { schema: EmotionsSchema },
   laziness: { schema: LazinessSchema },
   hallucinations: { schema: HallucinationsSchema },
@@ -559,6 +603,7 @@ var COMMAND_FLAG_SPECS = {
   tail: { schema: TailSchema },
   feedback: {
     schema: FeedbackSchema,
+    extra: DRY_RUN,
     handParsed: true,
     idRefFlags: true,
     positionals: [{ name: "note", key: "note", required: true, variadic: true, alsoFlag: true }]
@@ -878,7 +923,8 @@ function assertFlags(command, flags, allowed) {
     "stream",
     "no-stream",
     "tui",
-    "no-tui"
+    "no-tui",
+    "pretty"
   ];
   const known = new Set([...allowed, ...globals]);
   const unknown = Object.keys(flags).filter((flag) => !known.has(flag));
@@ -939,10 +985,7 @@ var LLM_WRITE_TIMEOUT_MS = 180000;
 async function send(context, plane, method, endpoint, body, options = {}) {
   const init = { method, ...body !== undefined ? { body: JSON.stringify(body) } : {} };
   if (method !== "GET" && context.dryRun) {
-    context.output.writeData({
-      dryRun: true,
-      planned: { method, endpoint: plane === "data" ? `/api/v1/data${endpoint}` : `/api${endpoint}`, ...body !== undefined ? { body } : {} }
-    }, { summary: { text: `Dry run: would ${method} ${endpoint}. Nothing was sent.`, confidence: "high" } });
+    writeDryRun(context, { plane, method, path: endpoint, ...body !== undefined ? { body } : {} });
     return;
   }
   const requestOptions = method === "GET" ? {} : { retries: 0, ...options.slow ? { timeoutMs: LLM_WRITE_TIMEOUT_MS } : {} };
@@ -1290,11 +1333,11 @@ var SIGNALS_MANAGEMENT_SUBCOMMANDS = new Set([
 ]);
 function unknownSignalsSubcommandError(sub, args = []) {
   if (sub === "archive") {
-    const id = args[0] ?? "<signal_id>";
+    const id = args[0] ? shellArg(args[0]) : "<signal_id>";
     return new CliInputError(`Unknown signals subcommand 'archive': archiving a signal is dashboard-only, so nothing was sent.`, `To stop a signal from running, pause it: moda signals pause ${id}. Drafts can be deleted with moda signals delete ${id}.`);
   }
   return new CliInputError(`Unknown signals subcommand '${sub}', so nothing was sent. Valid subcommands: ${[...SIGNALS_MANAGEMENT_SUBCOMMANDS].join(", ")}.`, `Bare 'moda signals' lists custom signals; 'moda signal <signal_id>' opens one. Usage:
   ${SIGNAL_USAGE}`);
 }
 
-export { ProblemsRemainderSchema, UUID_RE, ProblemImpactSchema, PROBLEM_FEEDBACK_ACTIONS, ProblemFeedbackSchema, ProblemLinearFileSchema, SignalLabelSchema, DETECTION_VERDICTS, DetectionReviewSchema, FALSE_POSITIVE_KINDS, FalsePositiveSchema, EMOTION_FAMILIES, LAZINESS_FAMILIES, StepScoresSchema, AuditSchema, FEEDBACK_USAGE, isFeedbackRefFlag, buildFeedbackRequest, COMMAND_FLAG_SPECS, flagSpecFor, kebabFlag, schemaShape, specFlagKeys, specFlagNames, describeSpecFlags, closestMatches, renderFlagHelp, subcommandHelpFlags, manifestFlagFields, requireTenant, assertFlags, assertPositionals, runUsersCommand, runUserCommand, runProblemReopenCommand, runSignalsManagementCommand, SIGNALS_MANAGEMENT_SUBCOMMANDS, unknownSignalsSubcommandError };
+export { ProblemsRemainderSchema, UUID_RE, ProblemImpactSchema, PROBLEM_FEEDBACK_ACTIONS, ProblemFeedbackSchema, ProblemLinearFileSchema, SignalLabelSchema, DETECTION_VERDICTS, DetectionReviewSchema, FALSE_POSITIVE_KINDS, FalsePositiveSchema, EMOTION_FAMILIES, LAZINESS_FAMILIES, StepScoresSchema, AuditSchema, FEEDBACK_USAGE, isFeedbackRefFlag, buildFeedbackRequest, writeDryRun, COMMAND_FLAG_SPECS, flagSpecFor, kebabFlag, schemaShape, describeField, specFlagKeys, specFlagNames, describeSpecFlags, closestMatches, usageLine, renderFlagHelp, subcommandHelpFlags, manifestFlagFields, requireTenant, assertFlags, assertPositionals, runUsersCommand, runUserCommand, runProblemReopenCommand, runSignalsManagementCommand, SIGNALS_MANAGEMENT_SUBCOMMANDS, unknownSignalsSubcommandError };