@moda-ai/cli 1.55.16 → 1.55.18

package/dist/{cli-b3cxcxgn.js → cli-3ezzeqcy.js}

@@ -678,6 +678,427 @@ function resetApiRequestCount() {
   apiRequestCount = 0;
 }
 
+// src/batch-reads.ts
+import { readFile } from "node:fs/promises";
+var BATCH_MAX_TARGETS = 25;
+var BATCH_CONCURRENCY = 4;
+var ANCHOR_SUFFIX = /^(.+)@(\d+)$/;
+function parseBatchTarget(text, anchors, usage) {
+  const raw = text.trim();
+  if (raw.startsWith("{")) {
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      throw new CliInputError(`Could not parse the JSON target ${JSON.stringify(raw)}.`, usage, "bad_batch_target");
+    }
+    const record = parsed;
+    const id = record?.id ?? record?.conversation_id ?? record?.trace_id;
+    if (typeof id !== "string" || id.trim() === "") {
+      throw new CliInputError(`JSON target ${JSON.stringify(raw)} has no "id" string.`, usage, "bad_batch_target");
+    }
+    const index = record.msg_index ?? record.message_index;
+    if (index !== undefined && index !== null) {
+      if (!anchors) {
+        throw new CliInputError(`JSON target ${JSON.stringify(raw)} has a msg_index, which this command does not take.`, usage, "bad_batch_target");
+      }
+      if (typeof index !== "number" || !Number.isSafeInteger(index) || index < 0) {
+        throw new CliInputError(`JSON target ${JSON.stringify(raw)} has an invalid msg_index (want an integer >= 0).`, usage, "bad_batch_target");
+      }
+      return { raw, id, msgIndex: index };
+    }
+    return { raw, id };
+  }
+  if (anchors) {
+    const match = ANCHOR_SUFFIX.exec(raw);
+    if (match) {
+      const msgIndex = Number(match[2]);
+      if (!Number.isSafeInteger(msgIndex)) {
+        throw new CliInputError(`Target ${JSON.stringify(raw)} has an @msg_index past ${Number.MAX_SAFE_INTEGER}. ` + 'If the id itself ends in @<digits>, pass it as {"id": "..."}.', usage, "bad_batch_target");
+      }
+      return { raw, id: match[1], msgIndex };
+    }
+  }
+  return { raw, id: raw };
+}
+function parseTargetLines(text, anchors, usage) {
+  return text.split(/\r?\n/).map((line) => line.trim()).filter((line) => line !== "").map((line) => parseBatchTarget(line, anchors, usage));
+}
+async function readStdinText() {
+  if (process.stdin.isTTY) {
+    throw new CliInputError("--ids-from=- reads targets from stdin, but stdin is a terminal. Pipe ids in (one per line) or pass a file path.", undefined, "ids_from_tty");
+  }
+  const chunks = [];
+  for await (const chunk of process.stdin)
+    chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+  return Buffer.concat(chunks).toString("utf8");
+}
+async function readIdsFrom(source, usage) {
+  if (source === "" || source === "true") {
+    throw new CliInputError("--ids-from needs a value: - (stdin) or a file path.", usage, "missing_flag_value");
+  }
+  if (source === "-")
+    return readStdinText();
+  try {
+    return await readFile(source, "utf8");
+  } catch (error) {
+    const code = error.code;
+    throw new CliInputError(`Could not read --ids-from file ${JSON.stringify(source)}${typeof code === "string" ? ` (${code})` : ""}.`, usage, "ids_from_unreadable");
+  }
+}
+async function collectBatchTargets(positionals, idsFrom, options) {
+  const targets = positionals.map((value) => parseBatchTarget(value, options.anchors, options.usage));
+  if (idsFrom !== undefined) {
+    targets.push(...parseTargetLines(await readIdsFrom(idsFrom, options.usage), options.anchors, options.usage));
+  }
+  const seen = new Set;
+  const unique = targets.filter((target) => {
+    const key = `${target.id}\x00${target.msgIndex ?? ""}`;
+    if (seen.has(key))
+      return false;
+    seen.add(key);
+    return true;
+  });
+  if (unique.length === 0) {
+    throw new CliInputError(`No targets: --ids-from gave no ids (one per line).`, options.usage, "missing_positional");
+  }
+  if (unique.length > BATCH_MAX_TARGETS) {
+    throw new CliInputError(`Got ${unique.length} targets; 'moda ${options.command}' reads at most ${BATCH_MAX_TARGETS} per call, so nothing was read. ` + `Split the ids into calls of ${BATCH_MAX_TARGETS} or fewer.`, options.usage, "batch_too_large");
+  }
+  return unique;
+}
+async function mapWithConcurrency(items, limit, fn) {
+  const results = new Array(items.length);
+  let next = 0;
+  let failure;
+  const worker = async () => {
+    while (!failure && next < items.length) {
+      const index = next++;
+      try {
+        results[index] = await fn(items[index], index);
+      } catch (error) {
+        failure ??= { error };
+      }
+    }
+  };
+  await Promise.all(Array.from({ length: Math.max(1, Math.min(limit, items.length)) }, worker));
+  if (failure)
+    throw failure.error;
+  return results;
+}
+function idNeedsJsonTarget(id) {
+  return ANCHOR_SUFFIX.test(id);
+}
+function contextTarget(id) {
+  const verbatim = id === id.trim() && !id.startsWith("{") && !idNeedsJsonTarget(id);
+  return verbatim ? id : JSON.stringify({ id });
+}
+
+// src/transforms.ts
+function asRecord(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return null;
+}
+function asString(value) {
+  return typeof value === "string" ? value : null;
+}
+function asNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function frustrationAnchorIndex(row) {
+  if (!row)
+    return null;
+  const userQuotes = Array.isArray(row.user_quotes) ? row.user_quotes : [];
+  const firstQuote = asRecord(userQuotes[0]);
+  const resolved = asNumber(firstQuote?.msg_index) ?? asNumber(row.anchor_msg_index);
+  if (resolved !== null)
+    return resolved;
+  const keyTurns = Array.isArray(row.key_turns) ? row.key_turns : [];
+  const firstTurn = keyTurns.find((t) => typeof t === "number");
+  if (firstTurn !== undefined)
+    return firstTurn;
+  return asNumber(firstQuote?.turn);
+}
+function buildFrustrationAnchor(row) {
+  const conversation_id = asString(row.conversation_id) ?? "";
+  const userQuotes = Array.isArray(row.user_quotes) ? row.user_quotes : [];
+  const firstQuote = asRecord(userQuotes[0]);
+  const keyTurnsRaw = Array.isArray(row.key_turns) ? row.key_turns : [];
+  const all_turns = keyTurnsRaw.filter((t) => typeof t === "number");
+  const msg_index = frustrationAnchorIndex(row);
+  let signal = null;
+  let quote_preview = null;
+  if (firstQuote) {
+    signal = asString(firstQuote.signal);
+    const quote = asString(firstQuote.quote);
+    if (quote !== null) {
+      let end = 0;
+      let points = 0;
+      for (const ch of quote) {
+        if (points++ === 200)
+          break;
+        end += ch.length;
+      }
+      quote_preview = quote.slice(0, end);
+    }
+  }
+  return {
+    kind: "frustration",
+    conversation_id,
+    msg_index,
+    signal,
+    quote_preview,
+    all_turns,
+    no_anchor: msg_index === null
+  };
+}
+function buildToolFailureAnchor(row, toolName) {
+  const conversation_id = asString(row.conversation_id) ?? "";
+  const msg_index = asNumber(row.msg_index);
+  const tool_use_id = asString(row.tool_use_id);
+  const error_subtype = asString(row.error_subtype);
+  return {
+    kind: "tool_failure",
+    conversation_id,
+    msg_index,
+    tool_name: toolName,
+    tool_use_id,
+    error_subtype,
+    no_anchor: msg_index === null
+  };
+}
+function frustrationsFromEmotions(response) {
+  if (!Array.isArray(response.detections) || Array.isArray(response.frustrations))
+    return response;
+  const summary = asRecord(response.summary) ?? {};
+  const pagination = asRecord(response.pagination) ?? {};
+  const byFamily = asRecord(summary.by_family) ?? {};
+  const totalAnalyzed = asNumber(summary.conversations_analyzed) ?? 0;
+  const byFamilyConversations = asRecord(summary.conversations_by_family);
+  const frustrated = asNumber(byFamilyConversations?.frustration) ?? asNumber(byFamily.frustration) ?? 0;
+  const frustrations = response.detections.map((item) => asRecord(item)).filter((row) => row !== null && (row.family === undefined || row.family === "frustration")).map(({ conversation_context, score, is_detected, ...row }) => ({
+    ...row,
+    is_frustrated: is_detected === true,
+    frustration_score: score,
+    target: row.elicitor === "bot" || row.elicitor === "external" ? row.elicitor : "ambiguous",
+    conversation: conversation_context ?? null
+  }));
+  const atRisk = asNumber(pagination.at_risk) ?? Math.max(0, (asNumber(pagination.total) ?? 0) - frustrated);
+  const signalBreakdown = {};
+  for (const item of Array.isArray(response.signal_breakdown) ? response.signal_breakdown : []) {
+    const row = asRecord(item);
+    if (row?.family === "frustration" && typeof row.signal === "string") {
+      signalBreakdown[row.signal] = asNumber(row.count) ?? 0;
+    }
+  }
+  const { detections: _detections, ...rest } = response;
+  return {
+    ...rest,
+    summary: {
+      total_analyzed: totalAnalyzed,
+      frustrated_count: frustrated,
+      at_risk_count: atRisk,
+      frustration_rate_pct: totalAnalyzed > 0 ? Math.round(frustrated / totalAnalyzed * 1000) / 10 : 0
+    },
+    signal_breakdown: signalBreakdown,
+    frustrations,
+    source: "emotion_detections"
+  };
+}
+function withFrustrationAnchors(response) {
+  if (!Array.isArray(response.frustrations))
+    return response;
+  const frustrations = response.frustrations.map((item) => {
+    const row = asRecord(item);
+    if (!row)
+      return item;
+    const anchor = buildFrustrationAnchor(row);
+    return { ...row, anchor };
+  });
+  return { ...response, frustrations };
+}
+var TOOL_FAILURE_CONTEXT_RADIUS = 2;
+function shellWord(value) {
+  return /^[\w@%+=:,./-]+$/.test(value) ? value : `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function trimFailureWindow(value, radius, fallbackCenter) {
+  const conv = asRecord(value);
+  if (!conv)
+    return value ?? null;
+  const { coverage: _coverage, context, ...convRest } = conv;
+  const ctx = asRecord(context);
+  if (!ctx)
+    return convRest;
+  const center = asNumber(ctx.center_index) ?? fallbackCenter;
+  const messages = (Array.isArray(ctx.messages) ? ctx.messages : []).map((message) => asRecord(message)).filter((message) => {
+    const index = asNumber(message?.index);
+    return message !== null && (center === null || index === null || Math.abs(index - center) <= radius);
+  }).map(({ content_blocks, ...message }) => {
+    const covered = typeof message.content === "string" && message.content.length > 0 || Array.isArray(message.tool_calls) && message.tool_calls.length > 0 || Array.isArray(message.tool_results) && message.tool_results.length > 0;
+    return covered || content_blocks === undefined ? message : { ...message, content_blocks };
+  });
+  const indexes = messages.map((message) => asNumber(message.index)).filter((index) => index !== null);
+  return {
+    ...convRest,
+    context: {
+      ...ctx,
+      ...indexes.length > 0 ? { from_index: Math.min(...indexes), to_index: Math.max(...indexes) } : {},
+      messages
+    }
+  };
+}
+function trimToolFailureConversations(response, opts) {
+  if (!Array.isArray(response.examples))
+    return response;
+  const examples = response.examples.map((item) => {
+    const row = asRecord(item);
+    if (!row)
+      return item;
+    const { conversation, window, ...rest } = row;
+    const conversationId = asString(row.conversation_id);
+    const msgIndex = asNumber(asRecord(row.anchor)?.msg_index) ?? asNumber(row.msg_index);
+    return {
+      ...rest,
+      ...conversationId && msgIndex !== null ? { context_command: `moda context ${shellWord(contextTarget(conversationId))} --msg-index=${msgIndex} --window=${TOOL_FAILURE_CONTEXT_RADIUS}` } : {},
+      ...opts.drop ? {} : { conversation: trimFailureWindow(conversation, TOOL_FAILURE_CONTEXT_RADIUS, msgIndex) },
+      ..."window" in row ? { window: trimFailureWindow(window, opts.windowRadius ?? TOOL_FAILURE_CONTEXT_RADIUS, msgIndex) } : {}
+    };
+  });
+  return { ...response, examples };
+}
+function withToolFailureAnchors(response) {
+  if (!Array.isArray(response.examples))
+    return response;
+  const toolName = asString(response.tool_name) ?? "";
+  const examples = response.examples.map((item) => {
+    const row = asRecord(item);
+    if (!row)
+      return item;
+    const anchor = buildToolFailureAnchor(row, toolName);
+    return { ...row, anchor };
+  });
+  return { ...response, examples };
+}
+function embeddedWindowSize(conversation) {
+  if (!conversation)
+    return null;
+  const ctx = asRecord(conversation.context);
+  if (!ctx)
+    return null;
+  const center = asNumber(ctx.center_index);
+  const from = asNumber(ctx.from_index);
+  const to = asNumber(ctx.to_index);
+  if (center === null || from === null || to === null)
+    return null;
+  return Math.min(center - from, to - center);
+}
+var DETECTION_CONTEXT_RADIUS = 2;
+function withoutDetectionWindows(response, listKey, windowKey) {
+  const list = response[listKey];
+  if (!Array.isArray(list))
+    return response;
+  const rows = list.map((item) => {
+    const row = asRecord(item);
+    if (!row)
+      return item;
+    const { [windowKey]: _window, ...rest } = row;
+    const conversationId = asString(row.conversation_id);
+    const msgIndex = asNumber(asRecord(row.anchor)?.msg_index) ?? frustrationAnchorIndex(row);
+    return {
+      ...rest,
+      ...conversationId && msgIndex !== null ? { context_command: `moda context ${shellWord(contextTarget(conversationId))} --msg-index=${msgIndex} --window=${DETECTION_CONTEXT_RADIUS}` } : {}
+    };
+  });
+  return { ...response, [listKey]: rows };
+}
+var PROBLEM_COMPACT_EVIDENCE = 5;
+var PROBLEM_COMPACT_OMITTED_BLOCKS = [
+  "rubric",
+  "trend",
+  "sub_problems",
+  "affected_conversations",
+  "remainder",
+  "confidence",
+  "change_history",
+  "stories"
+];
+function readCommand(command, purpose) {
+  return { command, purpose, mutability: "read", requires_approval: false };
+}
+function evidenceMsgIndex(row) {
+  return asNumber(row.anchor_msg_index) ?? asNumber(asRecord(asRecord(row.snippet_parsed)?.anchor)?.msg_index);
+}
+function compactProblemDossier(response, problemId) {
+  const id = shellWord(asString(response.problem_id) ?? problemId);
+  const evidence = (Array.isArray(response.evidence) ? response.evidence : []).map((item) => asRecord(item)).filter((row) => row !== null);
+  const topEvidence = evidence.slice(0, PROBLEM_COMPACT_EVIDENCE).map((row) => {
+    const conversationId = asString(row.conversation_id);
+    const msgIndex = evidenceMsgIndex(row);
+    return {
+      attribution_id: row.attribution_id ?? null,
+      conversation_id: conversationId,
+      msg_index: msgIndex,
+      signal_family: row.signal_family ?? null,
+      signal_type: row.signal_type ?? null,
+      confidence: row.confidence ?? null,
+      causal_rationale: row.causal_rationale ?? null,
+      door: row.door ?? null,
+      replay_verified: row.replay_verified ?? null,
+      ...conversationId && msgIndex !== null ? { context_command: `moda context ${shellWord(contextTarget(conversationId))} --msg-index=${msgIndex}` } : {}
+    };
+  });
+  const reportsBlock = asRecord(response.investigation_reports);
+  const reports = (Array.isArray(reportsBlock?.items) ? reportsBlock.items : []).map((item) => asRecord(item)).filter((row) => row !== null).map((row) => ({
+    report_id: row.report_id ?? null,
+    conversation_id: row.conversation_id ?? null,
+    mechanism: row.mechanism ?? null,
+    suspected_surface: row.suspected_surface ?? null,
+    severity: row.severity ?? null,
+    problem_found: row.problem_found ?? null
+  }));
+  const verification = asRecord(response.verification);
+  const { samples: _samples, ...verificationCounts } = verification ?? {};
+  const dossier = asRecord(response.dossier);
+  const { representative_story_keys: _storyKeys, ...dossierSummary } = dossier ?? {};
+  const trend = Array.isArray(response.trend) ? response.trend : [];
+  const data = {
+    found: response.found ?? true,
+    problem_id: response.problem_id ?? problemId,
+    requested_problem_id: response.requested_problem_id ?? problemId,
+    alias_resolved: response.alias_resolved ?? false,
+    view: "compact",
+    header: response.header ?? null,
+    dossier: dossier ? dossierSummary : null,
+    verification: verification ? verificationCounts : null,
+    ...response.impact_identity !== undefined ? { impact_identity: response.impact_identity } : {},
+    ...response.hierarchy !== undefined ? { hierarchy: response.hierarchy } : {},
+    ...trend.length > 0 ? { trend_latest: trend[trend.length - 1], trend_points: trend.length } : {},
+    top_evidence: topEvidence,
+    evidence_in_dossier: evidence.length,
+    reports,
+    omitted: {
+      evidence_rows: Math.max(0, evidence.length - topEvidence.length),
+      report_narratives: reports.length,
+      reports_has_more: reportsBlock?.has_more === true,
+      blocks: PROBLEM_COMPACT_OMITTED_BLOCKS.filter((key) => (key in response))
+    },
+    full_command: `moda problem ${id} --full`
+  };
+  const nextCommands = [
+    readCommand(`moda problem ${id} --evidence --limit=20`, "Page every evidence row with its anchor (follow next_cursor)."),
+    readCommand(`moda problem ${id} --reports`, "Page investigation reports with narratives and citations."),
+    readCommand(`moda problem ${id} --traces`, "Page affected traces with their latest anchor."),
+    readCommand(`moda problem ${id} --full`, "The complete dossier, every block (large).")
+  ];
+  const first = topEvidence.find((row) => typeof row.context_command === "string");
+  if (first?.context_command) {
+    nextCommands.push(readCommand(first.context_command, "Read the trace around the top evidence anchor."));
+  }
+  return { data, nextCommands };
+}
+
 // ../../packages/harness-snapshot/src/policy.ts
 var MAX_SCANNED_FILE_BYTES = 512 * 1024;
 var DEFAULT_MAX_INVENTORY_FILES = 12000;
@@ -1053,6 +1474,25 @@ var AGENT_ERROR_CODES = [
   "output_error",
   "not_found"
 ];
+var MODA_COMMAND = /^(?:moda |.*\| moda )/;
+function withProfileFlag(command, flag) {
+  return MODA_COMMAND.test(command) && !/(?:^|\s)--profile(?:[=\s]|$)/.test(command) ? `${command} ${flag}` : command;
+}
+function withProfileOnCommands(value, profile) {
+  const flag = `--profile=${shellWord(profile)}`;
+  const visit = (node, key) => {
+    const isCommandKey = key !== undefined && /commands?$/.test(key);
+    if (typeof node === "string")
+      return isCommandKey ? withProfileFlag(node, flag) : node;
+    if (Array.isArray(node))
+      return node.map((item) => visit(item, isCommandKey ? key : undefined));
+    const record = asRecord2(node);
+    if (!record)
+      return node;
+    return Object.fromEntries(Object.entries(record).map(([entryKey, entry]) => [entryKey, visit(entry, entryKey)]));
+  };
+  return visit(value, undefined);
+}
 var FALLBACK_RUN_ID = randomUUID();
 var fallbackSeq = 0;
 var stdoutClosed = false;
@@ -1217,7 +1657,8 @@ function createCliOutput(options) {
       nextCommands: writeOptions.nextCommands,
       artifacts: writeOptions.artifacts,
       warnings: writeOptions.warnings,
-      errors: writeOptions.errors
+      errors: writeOptions.errors,
+      invocation: options.invocation
     });
   };
   const output = {
@@ -1227,6 +1668,12 @@ function createCliOutput(options) {
       const bypassQuiet = writeOptions.bypassQuiet === true;
       if (options.quiet && !bypassQuiet)
         return;
+      const profile = options.invocation?.flags.profile;
+      if (profile) {
+        data = withProfileOnCommands(data, profile);
+        if (writeOptions.nextCommands)
+          writeOptions = { ...writeOptions, nextCommands: withProfileOnCommands(writeOptions.nextCommands, profile) };
+      }
       if (options.mode === "agent" || options.mode === "agent-stream") {
         if (state.terminal)
           return;
@@ -1368,7 +1815,7 @@ function createAgentEnvelope(options) {
     findings: text.findings,
     evidence_refs: text.evidence_refs,
     recommended_actions: text.recommended_actions,
-    next_commands: text.next_commands,
+    next_commands: [...text.next_commands, ...bounded.nextCommands ?? []],
     artifacts: [
       ...options.artifacts ?? [],
       ...bounded.fullOutputPath ? [{ kind: "full_output", path: bounded.fullOutputPath, description: "Complete command output (the same JSON --json prints); data in this envelope was bounded." }] : [],
@@ -1396,9 +1843,9 @@ function createAgentEnvelope(options) {
   const sizeOf = (value) => Buffer.byteLength(JSON.stringify(value) ?? "", "utf8");
   const rebound = (current) => {
     const overhead = sizeOf(current) - sizeOf(current.data);
-    return build(boundForAgent(safeData, Math.max(1024, maxBytes - overhead - 1024), { writeFullOutput }));
+    return build(boundForAgent(safeData, Math.max(1024, maxBytes - overhead - 1024), { writeFullOutput, invocation: options.invocation }));
   };
-  let envelope = build(boundForAgent(safeData, maxBytes, { writeFullOutput }));
+  let envelope = build(boundForAgent(safeData, maxBytes, { writeFullOutput, invocation: options.invocation }));
   if (sizeOf(envelope) > maxBytes)
     envelope = rebound(envelope);
   if (sizeOf(envelope) > maxBytes && !saveFailed) {
@@ -1750,11 +2197,11 @@ function normalizeSummary(summary, command, status, data) {
   return inferSummary(command, status, data);
 }
 function inferSummary(command, status, data) {
-  const record = asRecord(data);
+  const record = asRecord2(data);
   if (status === "error") {
     return { text: `${command} failed.`, confidence: "high" };
   }
-  const summary = asRecord(record?.summary);
+  const summary = asRecord2(record?.summary);
   if (summary) {
     const statusValue = typeof summary.status === "string" ? summary.status : undefined;
     const fail = typeof summary.fail === "number" ? summary.fail : undefined;
@@ -1806,18 +2253,21 @@ function inferMutability(command) {
   return "read";
 }
 function inferWarnings(data) {
-  const record = asRecord(data);
+  const record = asRecord2(data);
   const direct = record?.warnings;
   if (Array.isArray(direct))
     return direct.filter((item) => typeof item === "string");
-  const validation = asRecord(record?.validation);
+  const validation = asRecord2(record?.validation);
   if (Array.isArray(validation?.warnings)) {
     return validation.warnings.filter((item) => typeof item === "string");
   }
   return [];
 }
+var DEFAULT_AGENT_MAX_OUTPUT_BYTES = 24000;
 function agentMaxOutputBytes() {
-  return Number(process.env.MODA_AGENT_MAX_OUTPUT_BYTES ?? 200000);
+  const raw = process.env.MODA_AGENT_MAX_OUTPUT_BYTES;
+  const value = raw === undefined || raw.trim() === "" ? Number.NaN : Number(raw);
+  return Number.isFinite(value) && value > 0 ? value : DEFAULT_AGENT_MAX_OUTPUT_BYTES;
 }
 var AGENT_FULL_OUTPUT_FILE = /-\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z-[0-9a-f]{8}\.json$/;
 function agentOutputRetentionMs() {
@@ -1860,6 +2310,158 @@ function writeAgentFullOutput(command, data) {
     return;
   }
 }
+function contentBlocksRedundant(message) {
+  const blocks = message.content_blocks;
+  if (!Array.isArray(blocks))
+    return false;
+  const content = typeof message.content === "string" ? message.content : typeof message.text === "string" ? message.text : "";
+  const hasToolCalls = Array.isArray(message.tool_calls) && message.tool_calls.length > 0;
+  const hasToolResults = Array.isArray(message.tool_results) && message.tool_results.length > 0;
+  const texts = [];
+  for (const item of blocks) {
+    const block = asRecord2(item);
+    if (!block)
+      return false;
+    if (block.type === "text") {
+      if (typeof block.text !== "string")
+        return false;
+      texts.push(block.text);
+      continue;
+    }
+    if (block.type === "tool_use" && hasToolCalls)
+      continue;
+    if (block.type === "tool_result" && hasToolResults)
+      continue;
+    return false;
+  }
+  if (texts.length === 0)
+    return true;
+  const trimmed = content.trim();
+  return [texts.join(""), texts.join(`
+`), texts.join(`
+
+`)].some((joined) => joined.trim() === trimmed);
+}
+function shedRedundantContentBlocks(value) {
+  let shed = 0;
+  const visit = (node) => {
+    if (Array.isArray(node)) {
+      for (const item of node)
+        if (item && typeof item === "object")
+          visit(item);
+      return;
+    }
+    const record = asRecord2(node);
+    if (!record)
+      return;
+    if ("content_blocks" in record && contentBlocksRedundant(record)) {
+      delete record.content_blocks;
+      shed += 1;
+    }
+    for (const item of Object.values(record))
+      if (item && typeof item === "object")
+        visit(item);
+  };
+  visit(value);
+  return shed;
+}
+var CONTINUATION_SECRET_FLAGS = new Set(["api-key", "api_key", "token"]);
+function continuationCommand(invocation, overrides) {
+  const normalize2 = (key) => key.replace(/_/g, "-");
+  const overridden = new Set(Object.keys(overrides).map(normalize2));
+  const bare = new Set((invocation.bareFlags ?? []).map(normalize2));
+  const parts = ["moda", invocation.command, ...invocation.positionals.map((value) => shellWord(value))];
+  for (const [key, value] of Object.entries(invocation.flags)) {
+    const flag = normalize2(key);
+    if (overridden.has(flag) || CONTINUATION_SECRET_FLAGS.has(flag))
+      continue;
+    parts.push(bare.has(flag) && value === "true" ? `--${flag}` : `--${flag}=${shellWord(String(value))}`);
+  }
+  for (const [key, value] of Object.entries(overrides))
+    parts.push(`--${normalize2(key)}=${shellWord(String(value))}`);
+  return parts.join(" ");
+}
+var PAGED_LIST_BY_COMMAND = {
+  "tool-failure-detail": "examples",
+  emotions: "detections",
+  frustrations: "frustrations",
+  "problems remainder": "groups"
+};
+function pagedListFor(invocation) {
+  const subcommand = invocation.positionals[0];
+  return (subcommand !== undefined ? PAGED_LIST_BY_COMMAND[`${invocation.command} ${subcommand}`] : undefined) ?? PAGED_LIST_BY_COMMAND[invocation.command];
+}
+var MAX_PAGE_OFFSET = 1e4;
+function rewritePagination(list, isTopLevel, invocation) {
+  const { parent, array, originalLength } = list;
+  if (!parent)
+    return;
+  const nested = asRecord2(parent.pagination);
+  const inline = !nested && !isTopLevel && (("has_more" in parent) || ("next_cursor" in parent)) ? parent : undefined;
+  const pagination = nested ?? inline;
+  if (!pagination)
+    return;
+  const listKey = list.path.split(".").pop() ?? list.path;
+  const arrayKeys = Object.keys(parent).filter((key) => Array.isArray(parent[key]));
+  if (arrayKeys.length > 1) {
+    const paged = invocation ? pagedListFor(invocation) : undefined;
+    if (paged === undefined || paged !== listKey)
+      return;
+  }
+  if (typeof pagination.returned === "number" ? pagination.returned !== originalLength : typeof pagination.limit === "number" && originalLength > pagination.limit) {
+    return;
+  }
+  const kept = array.length;
+  const omitted = originalLength - kept;
+  const offset = typeof pagination.offset === "number" && Number.isFinite(pagination.offset) ? pagination.offset : undefined;
+  const hadCursor = typeof pagination.next_cursor === "string" && pagination.next_cursor.length > 0;
+  if (typeof pagination.limit === "number") {
+    pagination.requested_limit = pagination.limit;
+    pagination.limit = kept;
+  }
+  pagination.returned = kept;
+  pagination.omitted_for_byte_limit = omitted;
+  pagination.has_more = true;
+  const pastOffsetCap = offset !== undefined && offset + kept > MAX_PAGE_OFFSET;
+  if (offset !== undefined && !pastOffsetCap)
+    pagination.next_offset = offset + kept;
+  if (hadCursor)
+    pagination.next_cursor = null;
+  const where = `data.${list.path}`;
+  if (pastOffsetCap) {
+    return {
+      note: `${where} holds ${kept} of ${originalLength} row(s); the omitted rows start past --offset=${MAX_PAGE_OFFSET}, ` + "the deepest offset the API pages to, so no --offset command can fetch them. Read them from the saved full output " + "(truncation.data.full_output_path) or rerun this page with --json"
+    };
+  }
+  if (!isTopLevel || !invocation) {
+    return { note: `${where} holds ${kept} of ${originalLength} row(s)` };
+  }
+  if (offset !== undefined) {
+    const command = continuationCommand(invocation, { offset: offset + kept, limit: omitted });
+    return {
+      note: `${where} holds ${kept} of ${originalLength} row(s); pagination.next_offset=${offset + kept}. Fetch the ${omitted} omitted row(s) with: ${command}`,
+      nextCommand: {
+        command,
+        purpose: `Fetch the ${omitted} row(s) of this page that were left out to fit the agent byte limit.`,
+        mutability: "read",
+        requires_approval: false
+      }
+    };
+  }
+  if (hadCursor || "next_cursor" in pagination || "cursor" in invocation.flags) {
+    const command = continuationCommand(invocation, { limit: kept });
+    return {
+      note: `${where} holds ${kept} of ${originalLength} row(s); next_cursor was cleared because it skipped the omitted rows. Rerun ${command} for a next_cursor that starts at the first omitted row`,
+      nextCommand: {
+        command,
+        purpose: `Re-read this page at --limit=${kept} (what fits) to get a next_cursor that starts at the first omitted row.`,
+        mutability: "read",
+        requires_approval: false
+      }
+    };
+  }
+  return { note: `${where} holds ${kept} of ${originalLength} row(s)` };
+}
 function boundForAgent(data, maxBytes = agentMaxOutputBytes(), options = {}) {
   const sizeOf = (value) => Buffer.byteLength(JSON.stringify(value) ?? "", "utf8");
   const serialized = JSON.stringify(data) ?? "";
@@ -1870,46 +2472,56 @@ function boundForAgent(data, maxBytes = agentMaxOutputBytes(), options = {}) {
   if (options.writeFullOutput && !fullOutputPath)
     return { data, saveFailed: true };
   const bounded = JSON.parse(serialized);
-  let boundedBytes = originalBytes;
+  const shedContentBlocks = shedRedundantContentBlocks(bounded);
+  const shedFields = shedContentBlocks > 0 ? { content_blocks: shedContentBlocks } : {};
+  let boundedBytes = shedContentBlocks > 0 ? sizeOf(bounded) : originalBytes;
   const droppedItems = {};
-  const collectArrays = (value, path, out) => {
+  const droppedLists = new Map;
+  const collectArrays = (value, path, parent, out) => {
     if (Array.isArray(value)) {
       if (value.length > 1)
-        out.push({ path, array: value, itemBytes: value.map((item) => sizeOf(item) + 1) });
+        out.push({ path, array: value, itemBytes: value.map((item) => sizeOf(item) + 1), parent });
       value.forEach((item, index) => {
         if (item && typeof item === "object")
-          collectArrays(item, `${path}[${index}]`, out);
+          collectArrays(item, `${path}[${index}]`, undefined, out);
       });
     } else if (value && typeof value === "object") {
-      for (const [key, item] of Object.entries(value)) {
+      const record = value;
+      for (const [key, item] of Object.entries(record)) {
         if (item && typeof item === "object")
-          collectArrays(item, path ? `${path}.${key}` : key, out);
+          collectArrays(item, path ? `${path}.${key}` : key, record, out);
       }
     }
   };
-  for (let round = 0;round < 25 && boundedBytes > maxBytes; round++) {
-    const arrays = [];
-    collectArrays(bounded, "", arrays);
-    const largest = arrays.map((entry) => ({ ...entry, total: entry.itemBytes.reduce((sum, bytes) => sum + bytes, 0) })).sort((left, right) => right.total - left.total)[0];
-    if (!largest)
-      break;
-    let overshoot = boundedBytes - maxBytes;
-    let drop = 0;
-    for (let index = largest.array.length - 1;index >= 1 && overshoot > 0; index--) {
-      overshoot -= largest.itemBytes[index];
-      drop += 1;
+  if (boundedBytes > maxBytes) {
+    for (let round = 0;round < 25 && boundedBytes > maxBytes; round++) {
+      const arrays = [];
+      collectArrays(bounded, "", undefined, arrays);
+      const largest = arrays.map((entry) => ({ ...entry, total: entry.itemBytes.reduce((sum, bytes) => sum + bytes, 0) })).sort((left, right) => right.total - left.total)[0];
+      if (!largest)
+        break;
+      let overshoot = boundedBytes - maxBytes;
+      let drop = 0;
+      for (let index = largest.array.length - 1;index >= 1 && overshoot > 0; index--) {
+        overshoot -= largest.itemBytes[index];
+        drop += 1;
+      }
+      if (drop === 0)
+        break;
+      const key = largest.path || "(root)";
+      if (!droppedLists.has(key)) {
+        droppedLists.set(key, { path: key, parent: largest.parent, array: largest.array, originalLength: largest.array.length });
+      }
+      largest.array.splice(largest.array.length - drop, drop);
+      droppedItems[key] = (droppedItems[key] ?? 0) + drop;
+      boundedBytes = sizeOf(bounded);
     }
-    if (drop === 0)
-      break;
-    largest.array.splice(largest.array.length - drop, drop);
-    const key = largest.path || "(root)";
-    droppedItems[key] = (droppedItems[key] ?? 0) + drop;
-    boundedBytes = sizeOf(bounded);
   }
   const dropped = Object.entries(droppedItems);
   const whereIsTheRest = fullOutputPath ? `The complete output (every item, no text shortened) is in ${fullOutputPath}; read it in line ranges or query it with jq. ` : "The complete output could not be saved to a file. ";
   const howToGetMore = whereIsTheRest + "Alternatively narrow the query (a smaller --limit, with --offset or --cursor paging where the command supports it), " + "rerun with --json (no byte limit), or raise MODA_AGENT_MAX_OUTPUT_BYTES.";
   const pathField = fullOutputPath ? { full_output_path: fullOutputPath } : {};
+  const shedNote = shedContentBlocks > 0 ? `removed content_blocks from ${shedContentBlocks} message(s) whose content already holds the same text` : "";
   if (boundedBytes > maxBytes) {
     return {
       data: { truncated: true, original_bytes: originalBytes, max_bytes: maxBytes, ...pathField },
@@ -1920,25 +2532,45 @@ function boundForAgent(data, maxBytes = agentMaxOutputBytes(), options = {}) {
       fullOutputPath
     };
   }
+  const root = asRecord2(bounded);
+  const notes = [];
+  const nextCommands = [];
+  for (const list of droppedLists.values()) {
+    const rewritten = rewritePagination(list, root !== undefined && list.parent === root, options.invocation);
+    if (!rewritten)
+      continue;
+    notes.push(rewritten.note);
+    if (rewritten.nextCommand)
+      nextCommands.push(rewritten.nextCommand);
+  }
+  const omittedTotal = dropped.reduce((sum, [, count]) => sum + count, 0);
+  const actions = [
+    ...shedNote ? [shedNote] : [],
+    ...dropped.map(([path, count]) => `dropped the last ${count} item(s) of data.${path}`)
+  ];
+  const warning = `Output was ${originalBytes} bytes, over the ${maxBytes}-byte agent limit: ${actions.join("; ")}.` + (notes.length > 0 ? ` ${notes.join(". ")}.` : "") + (omittedTotal > 0 ? ` ${howToGetMore}` : ` Nothing else was left out. ${whereIsTheRest}`);
   return {
     data: bounded,
-    warning: `Output was ${originalBytes} bytes, over the ${maxBytes}-byte agent limit: ${dropped.map(([path, count]) => `dropped the last ${count} item(s) of data.${path}`).join("; ")}. ${howToGetMore}`,
+    warning,
     truncation: {
       data: {
         original_bytes: originalBytes,
         bounded_bytes: boundedBytes,
         max_bytes: maxBytes,
         reason: "agent_output_byte_limit",
+        ...Object.keys(shedFields).length > 0 ? { shed_fields: shedFields } : {},
         dropped_items: droppedItems,
+        ...omittedTotal > 0 ? { omitted_rows: omittedTotal } : {},
         structure_preserved: true,
-        complete: false,
+        complete: omittedTotal === 0,
         ...pathField
       }
     },
-    fullOutputPath
+    fullOutputPath,
+    ...nextCommands.length > 0 ? { nextCommands } : {}
   };
 }
-function asRecord(value) {
+function asRecord2(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
 }
 function extractSuggestedCommands(text) {
@@ -1946,4 +2578,4 @@ function extractSuggestedCommands(text) {
   return commands.length > 0 ? commands : undefined;
 }
 
-export { PROD_BASE_URL, DEFAULT_INGEST_URL, getModaPaths, getModaDir, isLoopbackBaseUrl, describeBaseUrlSource, loadProfileConfig, saveProfileConfig, getActiveProfile, setActiveProfile, upsertProfile, clearStoredApiKeyCredentials, secretFilePathFromRef, resolveSecretReference, resolveApiKeyFromActiveProfile, resolveTenantIdFromActiveProfile, ensureSecretFilePermissions, writeSecretJsonFile, CliInputError, CliAccessError, CliInputRequiredError, CliAuthError, CliNotFoundError, CliCancellationError, isNetworkLikeError, isApiLikeError, apiErrorStatus, VERSION, MODA_BASE_URL, loadCliConfig, saveCliConfig, resolveApiKey, embeddedTenantIdFromApiKey, resolveIngestUrl2 as resolveIngestUrl, resolveTenantId, resolveApiTenantId, resolveModaBaseUrl, validateConfig, recordApiRequest, getApiRequestCount, resetApiRequestCount, MAX_SCANNED_FILE_BYTES, DEFAULT_MAX_INVENTORY_FILES, DEFAULT_MAX_INVENTORY_TEXT_BYTES, MAX_RECORDED_SKIPS, SKIPPED_DIRS, isSkippedDir, isSkippedPathPrefix, isEvalLikePath, shouldInventoryFile, isTextFile, isSecretishPath, SECRET_KEYS, redactDeep, redactString, packSnapshot, setAgentUpdateNotice, EXIT_OK, EXIT_ERROR, EXIT_DEGRADED, EXIT_AUTH_REQUIRED, EXIT_INPUT_REQUIRED, EXIT_CANCELLED, AGENT_ERROR_CODES, wasOutputCancelled, safeWriteStdout, safeWriteStderr, explicitOutputMode, outputModeFromFlags, resolveOutputMode, createCliOutput, agentEnvelopeFits, errorToAgentError, agentMaxOutputBytes };
+export { PROD_BASE_URL, DEFAULT_INGEST_URL, getModaPaths, getModaDir, isLoopbackBaseUrl, describeBaseUrlSource, loadProfileConfig, saveProfileConfig, getActiveProfile, setActiveProfile, upsertProfile, clearStoredApiKeyCredentials, secretFilePathFromRef, resolveSecretReference, resolveApiKeyFromActiveProfile, resolveTenantIdFromActiveProfile, ensureSecretFilePermissions, writeSecretJsonFile, CliInputError, CliAccessError, CliInputRequiredError, CliAuthError, CliNotFoundError, CliCancellationError, isNetworkLikeError, isApiLikeError, apiErrorStatus, VERSION, MODA_BASE_URL, loadCliConfig, saveCliConfig, resolveApiKey, embeddedTenantIdFromApiKey, resolveIngestUrl2 as resolveIngestUrl, resolveTenantId, resolveApiTenantId, resolveModaBaseUrl, validateConfig, recordApiRequest, getApiRequestCount, resetApiRequestCount, BATCH_MAX_TARGETS, BATCH_CONCURRENCY, parseBatchTarget, collectBatchTargets, mapWithConcurrency, contextTarget, asRecord, asString, asNumber, frustrationAnchorIndex, frustrationsFromEmotions, withFrustrationAnchors, shellWord, trimToolFailureConversations, withToolFailureAnchors, embeddedWindowSize, withoutDetectionWindows, compactProblemDossier, MAX_SCANNED_FILE_BYTES, DEFAULT_MAX_INVENTORY_FILES, DEFAULT_MAX_INVENTORY_TEXT_BYTES, MAX_RECORDED_SKIPS, SKIPPED_DIRS, isSkippedDir, isSkippedPathPrefix, isEvalLikePath, shouldInventoryFile, isTextFile, isSecretishPath, SECRET_KEYS, redactDeep, redactString, packSnapshot, setAgentUpdateNotice, EXIT_OK, EXIT_ERROR, EXIT_DEGRADED, EXIT_AUTH_REQUIRED, EXIT_INPUT_REQUIRED, EXIT_CANCELLED, AGENT_ERROR_CODES, wasOutputCancelled, safeWriteStdout, safeWriteStderr, explicitOutputMode, outputModeFromFlags, resolveOutputMode, createCliOutput, agentEnvelopeFits, errorToAgentError, agentMaxOutputBytes };