@moda-ai/cli 1.8.0 → 1.8.1

package/dist/cli.js

@@ -2,7 +2,7 @@
 import { z } from 'zod';
 import { validateConfig, VERSION, resolveApiKey } from './config.js';
 import { callDataAPI, ApiError, getApiRequestCount, resetApiRequestCount, } from './api-client.js';
-import { OverviewSchema, ClustersSchema, ClusterConversationsSchema, ConversationsSchema, WorldStateSchema, ContextSchema, FrustrationsSchema, ToolFailuresSchema, ToolFailureDetailSchema, WorkflowsSchema, RunsSchema, RunDetailSchema, LoopsSchema, LoopDetailSchema, } from './schemas.js';
+import { OverviewSchema, ClustersSchema, ClusterConversationsSchema, ConversationsSchema, SearchSchema, WorldStateSchema, ContextSchema, FrustrationsSchema, ToolFailuresSchema, ToolFailureDetailSchema, WorkflowsSchema, RunsSchema, RunDetailSchema, LoopsSchema, LoopDetailSchema, } from './schemas.js';
 import { withFrustrationAnchors, withToolFailureAnchors, embeddedWindowSize, asRecord, asString, asNumber } from './transforms.js';
 import { runPromptsCommand } from './prompts.js';
 // Coding-agent capture (shadow workspace / Shadow Spark / trace hooks) is temporarily
@@ -137,6 +137,7 @@ Commands:
   clusters                         Browse topic cluster hierarchy
   cluster-conversations <node_id>  List conversations in a cluster
   conversations                    Search and filter conversations
+  search "<query>"                 Search conversation messages (keyword/semantic/hybrid)
   world-state <conversation_id>    Get a conversation's world state (slots/threads/events)
   context <conversation_id>        Get windowed conversation context
   frustrations                     Get user frustration detections
@@ -192,6 +193,12 @@ Conversations flags:
   --user-id=ID                     Filter to a single user
   --environment=ENV                Filter by environment (all|development|staging|production)
 
+Search flags:
+  --mode=keyword|semantic|hybrid   Search mode (default hybrid)
+  --user-id=ID                     Filter to a single user
+  --time-range=RANGE               Time range filter (all|1h|3d|7d|24h|30d|90d)
+  --limit=N                        Maximum results to return (1-100, default 20)
+
 World-state flags:
   --summary-only                   Return segment summaries only (omit the event stream)
   --event-limit=N                  Max world-state events to return (1-5000, default 2000)
@@ -249,6 +256,8 @@ Examples:
   moda conversations --search="error" --limit=5
   moda conversations --world-state="enterprise" --outcome=positive
   moda conversations --world-state="refund,billing" --include-world-state
+  moda search "billing error" --mode=hybrid
+  moda search "refund flow" --mode=semantic --time-range=7d --limit=10
   moda world-state <conversation_id> --summary-only
   moda frustrations --days-back=14 --limit=20
   moda context <conversation_id> --window=3
@@ -415,6 +424,29 @@ export async function runCommand(command, positional, flags, positionals = posit
             }
             break;
         }
+        case 'search': {
+            // Positional query mirrors world-state/context/cluster-conversations:
+            // reject an empty/whitespace query with the shared CLI input error before
+            // it reaches the schema (which also guards via q.min(1)).
+            if (!positional || positional.trim() === '') {
+                throw new CliInputError('<query> is required', 'Usage: moda search "<query>" [--mode=keyword|semantic|hybrid] [--user-id=ID] [--time-range=RANGE] [--limit=N]');
+            }
+            const args = flagsToArgs(flags, 'q', positional);
+            const params = SearchSchema.parse(args);
+            const query = new URLSearchParams();
+            query.set('q', params.q);
+            if (params.mode)
+                query.set('mode', params.mode);
+            if (params.user_id)
+                query.set('user_id', params.user_id);
+            if (params.time_range)
+                query.set('time_range', params.time_range);
+            if (params.limit)
+                query.set('limit', params.limit.toString());
+            const data = await callDataAPI(`/search?${query.toString()}`);
+            context.output.writeData(data);
+            break;
+        }
         case 'world-state': {
             if (!positional) {
                 throw new CliInputError('<conversation_id> is required', 'Usage: moda world-state <conversation_id> [--summary-only] [--event-limit=N]');
@@ -856,6 +888,15 @@ export const commandRegistry = createCommandRegistry([
         ],
         ...dataApiDefaults,
     }),
+    legacyCommand({
+        name: 'search',
+        description: 'Search conversation messages (keyword, semantic, or hybrid)',
+        examples: [
+            'moda search "billing error"',
+            'moda search "refund flow" --mode=semantic --time-range=7d --limit=10',
+        ],
+        ...dataApiDefaults,
+    }),
     legacyCommand({
         name: 'world-state',
         description: "Get a conversation's world state (slots, threads, events)",

package/dist/schemas.d.ts

@@ -141,6 +141,30 @@ export declare const ToolFailureDetailSchema: z.ZodObject<{
     include_window?: unknown;
     subtype?: string | undefined;
 }>;
+/**
+ * moda search "<query>" — keyword/semantic/hybrid search across conversation
+ * messages. `q` arrives as a positional arg; the runCommand handler rejects an
+ * empty/whitespace query before parsing, and min(1) guards the schema path too.
+ */
+export declare const SearchSchema: z.ZodObject<{
+    q: z.ZodString;
+    mode: z.ZodOptional<z.ZodDefault<z.ZodEnum<["keyword", "semantic", "hybrid"]>>>;
+    user_id: z.ZodOptional<z.ZodString>;
+    time_range: z.ZodOptional<z.ZodDefault<z.ZodEnum<["all", "1h", "3d", "7d", "24h", "30d", "90d"]>>>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    q: string;
+    mode?: "keyword" | "semantic" | "hybrid" | undefined;
+    time_range?: "all" | "1h" | "3d" | "7d" | "24h" | "30d" | "90d" | undefined;
+    limit?: number | undefined;
+    user_id?: string | undefined;
+}, {
+    q: string;
+    mode?: "keyword" | "semantic" | "hybrid" | undefined;
+    time_range?: "all" | "1h" | "3d" | "7d" | "24h" | "30d" | "90d" | undefined;
+    limit?: number | undefined;
+    user_id?: string | undefined;
+}>;
 /** moda workflows — recurring workflow catalog (read from agent_job_classes). */
 export declare const WorkflowsSchema: z.ZodObject<{
     time_range: z.ZodOptional<z.ZodDefault<z.ZodEnum<["all", "1h", "3d", "7d", "24h", "30d", "90d"]>>>;

package/dist/schemas.js

@@ -76,6 +76,19 @@ export const ToolFailureDetailSchema = z.object({
 // `moda workflows` lists the catalog; `moda runs` lists executions.
 const RUN_OUTCOMES = ['running', 'succeeded', 'partial', 'failed', 'loop', 'abandoned', 'unknown'];
 const TIME_RANGES = ['all', '1h', '3d', '7d', '24h', '30d', '90d'];
+const SEARCH_MODES = ['keyword', 'semantic', 'hybrid'];
+/**
+ * moda search "<query>" — keyword/semantic/hybrid search across conversation
+ * messages. `q` arrives as a positional arg; the runCommand handler rejects an
+ * empty/whitespace query before parsing, and min(1) guards the schema path too.
+ */
+export const SearchSchema = z.object({
+    q: z.string().min(1).max(500),
+    mode: z.enum(SEARCH_MODES).default('hybrid').optional(),
+    user_id: z.string().optional(),
+    time_range: z.enum(TIME_RANGES).default('all').optional(),
+    limit: z.number().min(1).max(100).default(20).optional(),
+});
 /** moda workflows — recurring workflow catalog (read from agent_job_classes). */
 export const WorkflowsSchema = z.object({
     time_range: z.enum(TIME_RANGES).default('all').optional(),

package/package.json

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