@respan/cli 0.6.2 → 0.6.3

package/dist/hooks/gemini-cli.cjs

@@ -721,17 +721,6 @@ function processChunk(hookData) {
         }
       }
     }
-    const grounding = candidates[0].groundingMetadata ?? llmResp.groundingMetadata;
-    if (grounding && typeof grounding === "object") {
-      const queries = grounding.webSearchQueries ?? grounding.searchQueries ?? [];
-      if (queries.length > 0) {
-        chunkToolDetails.push({
-          name: "google_web_search",
-          args: { queries },
-          output: truncate(queries.join(", "), MAX_CHARS)
-        });
-      }
-    }
   }
   const messages = hookData.llm_request?.messages ?? [];
   const currentMsgCount = messages.length;
@@ -741,8 +730,17 @@ function processChunk(hookData) {
   let toolCallDetected = false;
   if (savedMsgCount > 0 && currentMsgCount > savedMsgCount) {
     const newMsgs = messages.slice(savedMsgCount);
-    const hasNewUserMsg = newMsgs.some((m) => m.role === "user");
-    if (hasNewUserMsg) {
+    const hasRealUserMsg = newMsgs.some((m) => {
+      if (String(m.role ?? "") !== "user") return false;
+      const parts = m.parts ?? m.content;
+      if (Array.isArray(parts)) {
+        return !parts.some(
+          (p) => typeof p === "object" && p !== null && (p.functionResponse || p.toolResponse)
+        );
+      }
+      return true;
+    });
+    if (hasRealUserMsg) {
       debug(`New user message detected (msgs ${savedMsgCount} \u2192 ${currentMsgCount}), starting fresh turn`);
       clearStreamState(sessionId);
       state = { accumulated_text: "", last_tokens: 0, first_chunk_time: "" };
@@ -760,13 +758,7 @@ function processChunk(hookData) {
     state.last_tokens = completionTokens || state.last_tokens;
     if (thoughtsTokens > 0) state.thoughts_tokens = thoughtsTokens;
   }
-  const groundingDetails = chunkToolDetails.filter((d) => d.name === "google_web_search");
-  if (groundingDetails.length) {
-    state.tool_details = [...state.tool_details ?? [], ...groundingDetails];
-    state.tool_turns = (state.tool_turns ?? 0) + groundingDetails.length;
-    debug(`Grounding search detected: ${groundingDetails.length} queries`);
-  }
-  if (chunkText || groundingDetails.length) {
+  if (chunkText) {
     saveStreamState(sessionId, state);
     debug(`Accumulated chunk: +${chunkText.length} chars, total=${state.accumulated_text.length}`);
   }

package/dist/hooks/gemini-cli.js

@@ -449,18 +449,6 @@ function processChunk(hookData) {
                 }
             }
         }
-        // Detect server-side grounding (google_web_search) from groundingMetadata
-        const grounding = (candidates[0].groundingMetadata ?? llmResp.groundingMetadata);
-        if (grounding && typeof grounding === 'object') {
-            const queries = (grounding.webSearchQueries ?? grounding.searchQueries ?? []);
-            if (queries.length > 0) {
-                chunkToolDetails.push({
-                    name: 'google_web_search',
-                    args: { queries },
-                    output: truncate(queries.join(', '), MAX_CHARS),
-                });
-            }
-        }
     }
     const messages = (hookData.llm_request?.messages ?? []);
     const currentMsgCount = messages.length;
@@ -471,8 +459,19 @@ function processChunk(hookData) {
     let toolCallDetected = false;
     if (savedMsgCount > 0 && currentMsgCount > savedMsgCount) {
         const newMsgs = messages.slice(savedMsgCount);
-        const hasNewUserMsg = newMsgs.some((m) => m.role === 'user');
-        if (hasNewUserMsg) {
+        // Distinguish real user messages from tool-result messages injected by Gemini.
+        // Tool results contain functionResponse / toolResponse objects in their parts.
+        const hasRealUserMsg = newMsgs.some((m) => {
+            if (String(m.role ?? '') !== 'user')
+                return false;
+            const parts = (m.parts ?? m.content);
+            if (Array.isArray(parts)) {
+                // If any part has functionResponse/toolResponse, it's a tool result, not a user message
+                return !parts.some((p) => typeof p === 'object' && p !== null && (p.functionResponse || p.toolResponse));
+            }
+            return true; // plain text user message
+        });
+        if (hasRealUserMsg) {
             debug(`New user message detected (msgs ${savedMsgCount} → ${currentMsgCount}), starting fresh turn`);
             clearStreamState(sessionId);
             state = { accumulated_text: '', last_tokens: 0, first_chunk_time: '' };
@@ -494,14 +493,7 @@ function processChunk(hookData) {
         if (thoughtsTokens > 0)
             state.thoughts_tokens = thoughtsTokens;
     }
-    // Save grounding tool details (these arrive with text, not as separate tool turns)
-    const groundingDetails = chunkToolDetails.filter(d => d.name === 'google_web_search');
-    if (groundingDetails.length) {
-        state.tool_details = [...(state.tool_details ?? []), ...groundingDetails];
-        state.tool_turns = (state.tool_turns ?? 0) + groundingDetails.length;
-        debug(`Grounding search detected: ${groundingDetails.length} queries`);
-    }
-    if (chunkText || groundingDetails.length) {
+    if (chunkText) {
         saveStreamState(sessionId, state);
         debug(`Accumulated chunk: +${chunkText.length} chars, total=${state.accumulated_text.length}`);
     }

package/oclif.manifest.json

@@ -2113,10 +2113,16 @@
         "opencode.js"
       ]
     },
-    "logs:create": {
+    "prompts:create-version": {
       "aliases": [],
-      "args": {},
-      "description": "Create a log span",
+      "args": {
+        "prompt-id": {
+          "description": "Prompt ID",
+          "name": "prompt-id",
+          "required": true
+        }
+      },
+      "description": "Create a new version of a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2152,31 +2158,31 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "input": {
-          "description": "Input text or JSON",
-          "name": "input",
+        "messages": {
+          "description": "Messages as JSON array string",
+          "name": "messages",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output": {
-          "description": "Output text or JSON",
-          "name": "output",
+        "model": {
+          "description": "Model name",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "model": {
-          "description": "Model name",
-          "name": "model",
+        "temperature": {
+          "description": "Temperature value",
+          "name": "temperature",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "metadata": {
-          "description": "Metadata as JSON string",
-          "name": "metadata",
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2184,7 +2190,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:create",
+      "id": "prompts:create-version",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2194,20 +2200,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
-        "create.js"
+        "prompts",
+        "create-version.js"
       ]
     },
-    "logs:get": {
+    "prompts:create": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Span ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get a specific log span",
+      "args": {},
+      "description": "Create a new prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2242,11 +2242,26 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "name": {
+          "description": "Prompt name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Prompt description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:get",
+      "id": "prompts:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2256,14 +2271,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
-        "get.js"
+        "prompts",
+        "create.js"
       ]
     },
-    "logs:list": {
+    "prompts:get": {
       "aliases": [],
-      "args": {},
-      "description": "List and filter LLM request logs (spans).\n\nSupports pagination, sorting, time range, and server-side filtering.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (logs):\n  model, status_code, status, cost, latency, prompt_tokens,\n  completion_tokens, customer_identifier, custom_identifier,\n  thread_identifier, trace_unique_id, span_name, span_workflow_name,\n  environment, log_type, error_message, failed, provider_id,\n  deployment_name, prompt_name, prompt_id, unique_id, stream,\n  temperature, max_tokens, tokens_per_second, time_to_first_token,\n  total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
+      "args": {
+        "id": {
+          "description": "Prompt ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2298,76 +2319,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "limit": {
-          "description": "Number of results per page (max 1000)",
-          "name": "limit",
-          "default": 50,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sort-by": {
-          "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
-          "name": "sort-by",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start-time": {
-          "description": "Start time filter (ISO 8601)",
-          "name": "start-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end-time": {
-          "description": "End time filter (ISO 8601)",
-          "name": "end-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "filter": {
-          "description": "Filter in field:operator:value format (repeatable)",
-          "name": "filter",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "all-envs": {
-          "description": "Include all environments (true/false)",
-          "name": "all-envs",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "is-test": {
-          "description": "Filter by test (true) or production (false) environment",
-          "name": "is-test",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "include-fields": {
-          "description": "Comma-separated fields to include in response",
-          "name": "include-fields",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:list",
+      "id": "prompts:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2377,14 +2333,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
-        "list.js"
+        "prompts",
+        "get.js"
       ]
     },
-    "logs:summary": {
+    "prompts:list": {
       "aliases": [],
       "args": {},
-      "description": "Get aggregated summary statistics for log spans in a time range.\n\nReturns total cost, total tokens, request count, and score summaries.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (logs):\n  model, status_code, status, cost, latency, prompt_tokens,\n  completion_tokens, customer_identifier, custom_identifier,\n  thread_identifier, trace_unique_id, span_name, span_workflow_name,\n  environment, log_type, error_message, failed, provider_id,\n  deployment_name, prompt_name, prompt_id, unique_id, stream,\n  temperature, max_tokens, tokens_per_second, time_to_first_token,\n  total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
+      "description": "List prompts",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2420,39 +2376,10 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "start-time": {
-          "description": "Start time (ISO 8601)",
-          "name": "start-time",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end-time": {
-          "description": "End time (ISO 8601)",
-          "name": "end-time",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "filter": {
-          "description": "Filter in field:operator:value format (repeatable)",
-          "name": "filter",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "all-envs": {
-          "description": "Include all environments (true/false)",
-          "name": "all-envs",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "is-test": {
-          "description": "Filter by test (true) or production (false) environment",
-          "name": "is-test",
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 50,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2460,7 +2387,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:summary",
+      "id": "prompts:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2470,20 +2397,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
-        "summary.js"
+        "prompts",
+        "list.js"
       ]
     },
-    "prompts:create-version": {
+    "prompts:update": {
       "aliases": [],
       "args": {
-        "prompt-id": {
+        "id": {
           "description": "Prompt ID",
-          "name": "prompt-id",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Create a new version of a prompt",
+      "description": "Update a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2519,31 +2446,16 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "messages": {
-          "description": "Messages as JSON array string",
-          "name": "messages",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "model": {
-          "description": "Model name",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "temperature": {
-          "description": "Temperature value",
-          "name": "temperature",
+        "name": {
+          "description": "Prompt name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
+        "description": {
+          "description": "Prompt description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2551,7 +2463,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:create-version",
+      "id": "prompts:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2562,13 +2474,19 @@
         "dist",
         "commands",
         "prompts",
-        "create-version.js"
+        "update.js"
       ]
     },
-    "prompts:create": {
+    "prompts:versions": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new prompt",
+      "args": {
+        "prompt-id": {
+          "description": "Prompt ID",
+          "name": "prompt-id",
+          "required": true
+        }
+      },
+      "description": "List versions of a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2603,26 +2521,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "name": {
-          "description": "Prompt name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Prompt description",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:create",
+      "id": "prompts:versions",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2633,19 +2536,19 @@
         "dist",
         "commands",
         "prompts",
-        "create.js"
+        "versions.js"
       ]
     },
-    "prompts:get": {
+    "traces:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Prompt ID",
+          "description": "Trace ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific prompt",
+      "description": "Get a specific trace",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2684,7 +2587,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:get",
+      "id": "traces:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2694,14 +2597,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
+        "traces",
         "get.js"
       ]
     },
-    "prompts:list": {
+    "traces:list": {
       "aliases": [],
       "args": {},
-      "description": "List prompts",
+      "description": "List and filter traces.\n\nA trace represents a complete workflow execution containing multiple spans.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (traces):\n  trace_unique_id, customer_identifier, environment, span_count,\n  llm_call_count, error_count, total_cost, total_tokens,\n  total_prompt_tokens, total_completion_tokens, duration,\n  span_workflow_name, metadata__<key>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2740,15 +2643,59 @@
         "limit": {
           "description": "Number of results per page",
           "name": "limit",
-          "default": 50,
+          "default": 10,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort-by": {
+          "description": "Sort field (prefix with - for descending)",
+          "name": "sort-by",
+          "default": "-timestamp",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "start-time": {
+          "description": "Start time filter (ISO 8601)",
+          "name": "start-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "end-time": {
+          "description": "End time filter (ISO 8601)",
+          "name": "end-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment": {
+          "description": "Environment filter",
+          "name": "environment",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "filter": {
+          "description": "Filter in field:operator:value format (repeatable)",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:list",
+      "id": "traces:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2758,20 +2705,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
+        "traces",
         "list.js"
       ]
     },
-    "prompts:update": {
+    "traces:summary": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Prompt ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a prompt",
+      "args": {},
+      "description": "Get a summary of traces for a time range",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2807,16 +2748,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Prompt name",
-          "name": "name",
+        "start-time": {
+          "description": "Start time (ISO 8601)",
+          "name": "start-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Prompt description",
-          "name": "description",
+        "end-time": {
+          "description": "End time (ISO 8601)",
+          "name": "end-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2824,7 +2767,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:update",
+      "id": "traces:summary",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2834,20 +2777,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "update.js"
+        "traces",
+        "summary.js"
       ]
     },
-    "prompts:versions": {
+    "users:create": {
       "aliases": [],
-      "args": {
-        "prompt-id": {
-          "description": "Prompt ID",
-          "name": "prompt-id",
-          "required": true
-        }
-      },
-      "description": "List versions of a prompt",
+      "args": {},
+      "description": "Create a new user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2864,29 +2801,58 @@
           "multiple": false,
           "type": "option"
         },
-        "json": {
-          "description": "Output as JSON",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "csv": {
-          "description": "Output as CSV",
-          "name": "csv",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "verbose": {
-          "char": "v",
-          "description": "Show verbose output",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
+        "json": {
+          "description": "Output as JSON",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "csv": {
+          "description": "Output as CSV",
+          "name": "csv",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show verbose output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "identifier": {
+          "description": "Customer identifier",
+          "name": "identifier",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "description": "Customer name",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "email": {
+          "description": "Customer email",
+          "name": "email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata": {
+          "description": "Metadata as JSON string",
+          "name": "metadata",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:versions",
+      "id": "users:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2896,20 +2862,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "versions.js"
+        "users",
+        "create.js"
       ]
     },
-    "traces:get": {
+    "users:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Trace ID",
+          "description": "Customer identifier",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific trace",
+      "description": "Get a specific user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2948,7 +2914,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:get",
+      "id": "users:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2958,14 +2924,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
+        "users",
         "get.js"
       ]
     },
-    "traces:list": {
+    "users:list": {
       "aliases": [],
       "args": {},
-      "description": "List and filter traces.\n\nA trace represents a complete workflow execution containing multiple spans.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (traces):\n  trace_unique_id, customer_identifier, environment, span_count,\n  llm_call_count, error_count, total_cost, total_tokens,\n  total_prompt_tokens, total_completion_tokens, duration,\n  span_workflow_name, metadata__<key>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
+      "description": "List users (customers)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3004,7 +2970,7 @@
         "limit": {
           "description": "Number of results per page",
           "name": "limit",
-          "default": 10,
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3018,23 +2984,8 @@
           "type": "option"
         },
         "sort-by": {
-          "description": "Sort field (prefix with - for descending)",
+          "description": "Sort field",
           "name": "sort-by",
-          "default": "-timestamp",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start-time": {
-          "description": "Start time filter (ISO 8601)",
-          "name": "start-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end-time": {
-          "description": "End time filter (ISO 8601)",
-          "name": "end-time",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3045,18 +2996,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "filter": {
-          "description": "Filter in field:operator:value format (repeatable)",
-          "name": "filter",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:list",
+      "id": "users:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3066,14 +3010,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
+        "users",
         "list.js"
       ]
     },
-    "traces:summary": {
+    "users:update": {
       "aliases": [],
-      "args": {},
-      "description": "Get a summary of traces for a time range",
+      "args": {
+        "id": {
+          "description": "Customer identifier",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3109,18 +3059,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "start-time": {
-          "description": "Start time (ISO 8601)",
-          "name": "start-time",
-          "required": true,
+        "name": {
+          "description": "Customer name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "end-time": {
-          "description": "End time (ISO 8601)",
-          "name": "end-time",
-          "required": true,
+        "email": {
+          "description": "Customer email",
+          "name": "email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata": {
+          "description": "Metadata as JSON string",
+          "name": "metadata",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3128,7 +3083,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:summary",
+      "id": "users:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3138,14 +3093,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
-        "summary.js"
+        "users",
+        "update.js"
       ]
     },
-    "users:create": {
+    "logs:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a new user (customer)",
+      "description": "Create a log span",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3181,24 +3136,24 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "identifier": {
-          "description": "Customer identifier",
-          "name": "identifier",
+        "input": {
+          "description": "Input text or JSON",
+          "name": "input",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Customer name",
-          "name": "name",
+        "output": {
+          "description": "Output text or JSON",
+          "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "email": {
-          "description": "Customer email",
-          "name": "email",
+        "model": {
+          "description": "Model name",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3213,7 +3168,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:create",
+      "id": "logs:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3223,20 +3178,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
+        "logs",
         "create.js"
       ]
     },
-    "users:get": {
+    "logs:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Customer identifier",
+          "description": "Span ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific user (customer)",
+      "description": "Get a specific log span",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3275,7 +3230,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:get",
+      "id": "logs:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3285,14 +3240,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
+        "logs",
         "get.js"
       ]
     },
-    "users:list": {
+    "logs:list": {
       "aliases": [],
       "args": {},
-      "description": "List users (customers)",
+      "description": "List and filter LLM request logs (spans).\n\nSupports pagination, sorting, time range, and server-side filtering.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (logs):\n  model, status_code, status, cost, latency, prompt_tokens,\n  completion_tokens, customer_identifier, custom_identifier,\n  thread_identifier, trace_unique_id, span_name, span_workflow_name,\n  environment, log_type, error_message, failed, provider_id,\n  deployment_name, prompt_name, prompt_id, unique_id, stream,\n  temperature, max_tokens, tokens_per_second, time_to_first_token,\n  total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3329,9 +3284,9 @@
           "type": "boolean"
         },
         "limit": {
-          "description": "Number of results per page",
+          "description": "Number of results per page (max 1000)",
           "name": "limit",
-          "default": 20,
+          "default": 50,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3345,15 +3300,50 @@
           "type": "option"
         },
         "sort-by": {
-          "description": "Sort field",
+          "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
           "name": "sort-by",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment": {
-          "description": "Environment filter",
-          "name": "environment",
+        "start-time": {
+          "description": "Start time filter (ISO 8601)",
+          "name": "start-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "end-time": {
+          "description": "End time filter (ISO 8601)",
+          "name": "end-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "description": "Filter in field:operator:value format (repeatable)",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "all-envs": {
+          "description": "Include all environments (true/false)",
+          "name": "all-envs",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "is-test": {
+          "description": "Filter by test (true) or production (false) environment",
+          "name": "is-test",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "include-fields": {
+          "description": "Comma-separated fields to include in response",
+          "name": "include-fields",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3361,7 +3351,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:list",
+      "id": "logs:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3371,20 +3361,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
+        "logs",
         "list.js"
       ]
     },
-    "users:update": {
+    "logs:summary": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Customer identifier",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a user (customer)",
+      "args": {},
+      "description": "Get aggregated summary statistics for log spans in a time range.\n\nReturns total cost, total tokens, request count, and score summaries.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (logs):\n  model, status_code, status, cost, latency, prompt_tokens,\n  completion_tokens, customer_identifier, custom_identifier,\n  thread_identifier, trace_unique_id, span_name, span_workflow_name,\n  environment, log_type, error_message, failed, provider_id,\n  deployment_name, prompt_name, prompt_id, unique_id, stream,\n  temperature, max_tokens, tokens_per_second, time_to_first_token,\n  total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3420,23 +3404,39 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Customer name",
-          "name": "name",
+        "start-time": {
+          "description": "Start time (ISO 8601)",
+          "name": "start-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "email": {
-          "description": "Customer email",
-          "name": "email",
+        "end-time": {
+          "description": "End time (ISO 8601)",
+          "name": "end-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "metadata": {
-          "description": "Metadata as JSON string",
-          "name": "metadata",
+        "filter": {
+          "description": "Filter in field:operator:value format (repeatable)",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "all-envs": {
+          "description": "Include all environments (true/false)",
+          "name": "all-envs",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "is-test": {
+          "description": "Filter by test (true) or production (false) environment",
+          "name": "is-test",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3444,7 +3444,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:update",
+      "id": "logs:summary",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3454,10 +3454,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "update.js"
+        "logs",
+        "summary.js"
       ]
     }
   },
-  "version": "0.6.2"
+  "version": "0.6.3"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@respan/cli",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Respan CLI - manage your LLM observability from the command line",
   "type": "module",
   "main": "dist/index.js",