@moda-ai/cli 1.54.0 → 1.55.1

package/dist/cli.js

@@ -410,6 +410,7 @@ var SearchSchema = z.object({
   q: z.string().min(1).max(500),
   mode: z.enum(SEARCH_MODES).default("hybrid").optional(),
   user_id: z.string().optional(),
+  conversation_id: z.string().min(1).max(256).optional(),
   time_range: z.enum(TIME_RANGES).default("all").optional(),
   limit: z.number().min(1).max(100).default(20).optional(),
   include_tool_io: boolFlag(),
@@ -8049,6 +8050,7 @@ Traces flags:
 Search flags:
   --mode=keyword|semantic|hybrid   Search mode (default hybrid)
   --user-id=ID                     Filter to a single user
+  --conversation-id=ID             Search inside one trace only
   --time-range=RANGE               Time range filter (all|1h|3d|7d|24h|30d|90d)
   --limit=N                        Maximum results to return (1-100, default 20)
 
@@ -8808,6 +8810,23 @@ function shellArg(value) {
     return `"${value}"`;
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
+function searchCoverageWarnings(coverage, timeRange) {
+  const record = asRecord(coverage);
+  if (!record)
+    return [];
+  const warnings = [];
+  const freshness = asRecord(record.index_freshness);
+  const originalUsed = record.original_messages_search === "used" || record.keyword_source === "original_messages";
+  if (freshness?.window_extends_beyond_index === true) {
+    const indexedAt = asString(freshness.latest_indexed_message_at) ?? "none in the last 7 days";
+    const originalAt = asString(freshness.latest_original_message_at) ?? "unknown";
+    warnings.push(`The search index trails ingestion for --time-range=${timeRange}: newest indexed message ${indexedAt}, newest message ${originalAt}. ` + (originalUsed ? "Literal matches were read from the original messages, but semantic ranking cannot see messages after the index cutoff." : "Messages after the index cutoff are missing from these results; retry with --mode=keyword for exact text."));
+  }
+  if (record.results_only_from_original_messages === true) {
+    warnings.push("Every result came from the original-message fallback: the search index returned no literal match (it may lag ingestion or not tokenize this text). Scores are literal match counts.");
+  }
+  return warnings;
+}
 async function searchFallbackToTraces(params) {
   const limit = Math.min(params.limit ?? 20, 100);
   const offset = params.offset ?? 0;
@@ -9354,7 +9373,7 @@ async function runCommand(command, positional, flags, positionals = positional ?
     }
     case "search": {
       if (!positional || positional.trim() === "") {
-        throw new CliInputError("<query> is required", 'Usage: moda search "<query>" [--mode=keyword|semantic|hybrid] [--user-id=ID] [--time-range=RANGE] [--include-tool-io] [--limit=N]');
+        throw new CliInputError("<query> is required", 'Usage: moda search "<query>" [--mode=keyword|semantic|hybrid] [--user-id=ID] [--conversation-id=ID] [--time-range=RANGE] [--include-tool-io] [--limit=N]');
       }
       const args = withStringIdFlags(flagsToArgs(flags, "q", positional), flags);
       const params = parseCommandFlags(SearchSchema, args, command, { positionalKey: "q" });
@@ -9364,6 +9383,8 @@ async function runCommand(command, positional, flags, positionals = positional ?
         query2.set("mode", params.mode);
       if (params.user_id)
         query2.set("user_id", params.user_id);
+      if (params.conversation_id)
+        query2.set("conversation_id", params.conversation_id);
       if (params.time_range)
         query2.set("time_range", params.time_range);
       if (params.limit)
@@ -9381,11 +9402,12 @@ async function runCommand(command, positional, flags, positionals = positional ?
       } else if (params.mode && actualMode && actualMode !== params.mode && params.mode !== "hybrid") {
         warnings.push(`Search ran in ${actualMode} mode instead of the requested ${params.mode} mode.`);
       }
+      warnings.push(...searchCoverageWarnings(searchRecord.coverage, params.time_range ?? "all"));
       const results = Array.isArray(searchRecord.results) ? searchRecord.results : [];
       if (results.length > 0 && (params.offset ?? 0) > 0) {
         warnings.push(`--offset=${params.offset} was not applied: message-level search is not pageable (it returns the top --limit hits). ` + "--offset only pages the trace-level fallback. Narrow with --time-range/--user-id or raise --limit instead.");
       }
-      if (results.length === 0) {
+      if (results.length === 0 && !params.conversation_id) {
         const fallback = await searchFallbackToTraces({ ...params, offset: params.offset });
         if (fallback?.kind === "notice") {
           warnings.push(fallback.warning);
@@ -11511,6 +11533,7 @@ if (isMain) {
 export {
   telemetryCommandName,
   stripLoneSurrogates,
+  searchCoverageWarnings,
   runCommand,
   resolveTailSignal,
   printCliError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moda-ai/cli",
-  "version": "1.54.0",
+  "version": "1.55.1",
   "description": "CLI for Moda - AI agent analytics and observability",
   "type": "module",
   "bin": {

package/skills/integration/index.json

@@ -1,7 +1,7 @@
 {
   "schema_version": "moda.skill_index.v1",
-  "bundled_at": "2026-10-12T07:41:12.130Z",
-  "cli_version": "1.54.0",
+  "bundled_at": "2026-10-13T00:08:16.766Z",
+  "cli_version": "1.55.1",
   "skills": [
     {
       "id": "integration-cloudflare-think",

package/skills/moda-cli/SKILL.md

@@ -506,6 +506,7 @@ moda search "customer asked for a refund" --mode=semantic
 moda search "SEARCH_NO_RESULTS" --mode=keyword
 moda search "checkout error" --time-range=7d --limit=10
 moda search "stripe.charges.create failed" --user-id=<id>
+moda search "Иван" --conversation-id=<id> --mode=keyword   # inside one trace
 ```
 
 Searches trace messages at message grain. Pass `--include-tool-io` to
@@ -514,9 +515,17 @@ output previews), so it finds where an agent *did* something, not just where
 it talked about it — tool-IO search is opt-in, not the default.
 
 Flags: `--mode=keyword|semantic|hybrid` (default `hybrid`), `--user-id`,
+`--conversation-id` (search inside one trace; no trace fallback),
 `--time-range` (`all|1h|3d|7d|24h|30d|90d`, default `all`), `--limit` (1–100,
 default 20). The query is a positional arg (max 500 chars).
 
+**Index freshness.** Keyword matches (and hybrid's keyword half) fall back to
+the original messages when the search index returns too few literal matches,
+so recent, Cyrillic and partial-word text is still found. `coverage` reports
+which source served the keyword leg (`keyword_source`) and how far the index
+trails ingestion (`index_freshness`); a warning says so when your
+`--time-range` reaches past the newest indexed message.
+
 **Fallback.** If message-level search finds nothing but whole traces match
 (same as `moda traces --search`), those traces come back in `results` with
 `match_grain: "trace"`, plus `fallback.source: "traces_search"` and a warning.