@respan/cli 0.14.1 → 0.15.0

package/oclif.manifest.json

@@ -1583,6 +1583,75 @@
         "index.js"
       ]
     },
+    "eval": {
+      "aliases": [],
+      "args": {
+        "file": {
+          "description": "Path to eval JSON file",
+          "name": "file",
+          "required": true
+        }
+      },
+      "description": "Run an eval defined in a JSON file (creates prompt + dataset on the platform)",
+      "flags": {
+        "api-key": {
+          "description": "API key (env: RESPAN_API_KEY)",
+          "env": "RESPAN_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "Temporary API base URL override for this command",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "description": "Named profile to use",
+          "name": "profile",
+          "hasDynamicHelp": false,
+          "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "eval",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "eval",
+        "index.js"
+      ]
+    },
     "evaluators:create": {
       "aliases": [],
       "args": {},
@@ -2244,75 +2313,6 @@
         "list.js"
       ]
     },
-    "eval": {
-      "aliases": [],
-      "args": {
-        "file": {
-          "description": "Path to eval JSON file",
-          "name": "file",
-          "required": true
-        }
-      },
-      "description": "Run an eval defined in a JSON file (creates prompt + dataset on the platform)",
-      "flags": {
-        "api-key": {
-          "description": "API key (env: RESPAN_API_KEY)",
-          "env": "RESPAN_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "base-url": {
-          "description": "Temporary API base URL override for this command",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "profile": {
-          "description": "Named profile to use",
-          "name": "profile",
-          "hasDynamicHelp": false,
-          "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"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "eval",
-      "pluginAlias": "@respan/cli",
-      "pluginName": "@respan/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "eval",
-        "index.js"
-      ]
-    },
     "integrate:claude-code": {
       "aliases": [],
       "args": {},
@@ -3097,16 +3097,10 @@
         "pi.js"
       ]
     },
-    "prompts:create-version": {
+    "logs:create": {
       "aliases": [],
-      "args": {
-        "prompt-id": {
-          "description": "Prompt ID",
-          "name": "prompt-id",
-          "required": true
-        }
-      },
-      "description": "Create a new version of a prompt",
+      "args": {},
+      "description": "Create a log span",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3149,31 +3143,31 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "messages": {
-          "description": "Messages as JSON array string",
-          "name": "messages",
+        "input": {
+          "description": "Input text or JSON",
+          "name": "input",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "model": {
-          "description": "Model name",
-          "name": "model",
+        "output": {
+          "description": "Output text or JSON",
+          "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "temperature": {
-          "description": "Temperature value",
-          "name": "temperature",
+        "model": {
+          "description": "Model name",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
+        "metadata": {
+          "description": "Metadata as JSON string",
+          "name": "metadata",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3181,7 +3175,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:create-version",
+      "id": "logs:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3191,14 +3185,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "create-version.js"
+        "logs",
+        "create.js"
       ]
     },
-    "prompts:create": {
+    "logs:get": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new prompt",
+      "args": {
+        "id": {
+          "description": "Span ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific log span",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3240,26 +3240,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": "logs:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3269,20 +3254,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "create.js"
+        "logs",
+        "get.js"
       ]
     },
-    "prompts:get": {
+    "logs:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Prompt ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get a specific prompt",
+      "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",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3324,38 +3303,103 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "prompts:get",
-      "pluginAlias": "@respan/cli",
-      "pluginName": "@respan/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "prompts",
-        "get.js"
-      ]
-    },
-    "prompts:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List prompts",
-      "flags": {
-        "api-key": {
-          "description": "API key (env: RESPAN_API_KEY)",
-          "env": "RESPAN_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         },
-        "base-url": {
+        "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",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "logs",
+        "list.js"
+      ]
+    },
+    "logs:summary": {
+      "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",
+      "flags": {
+        "api-key": {
+          "description": "API key (env: RESPAN_API_KEY)",
+          "env": "RESPAN_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
           "description": "Temporary API base URL override for this command",
           "name": "base-url",
           "hasDynamicHelp": false,
@@ -3388,10 +3432,39 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 50,
+        "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",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3399,7 +3472,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:list",
+      "id": "logs:summary",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3409,20 +3482,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "list.js"
+        "logs",
+        "summary.js"
       ]
     },
-    "prompts:update": {
+    "prompts:create-version": {
       "aliases": [],
       "args": {
-        "id": {
+        "prompt-id": {
           "description": "Prompt ID",
-          "name": "id",
+          "name": "prompt-id",
           "required": true
         }
       },
-      "description": "Update a prompt",
+      "description": "Create a new version of a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3465,16 +3538,31 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Prompt name",
-          "name": "name",
+        "messages": {
+          "description": "Messages as JSON array string",
+          "name": "messages",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Prompt description",
-          "name": "description",
+        "model": {
+          "description": "Model name",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "temperature": {
+          "description": "Temperature value",
+          "name": "temperature",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3482,7 +3570,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:update",
+      "id": "prompts:create-version",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3493,19 +3581,13 @@
         "dist",
         "commands",
         "prompts",
-        "update.js"
+        "create-version.js"
       ]
     },
-    "prompts:versions": {
+    "prompts:create": {
       "aliases": [],
-      "args": {
-        "prompt-id": {
-          "description": "Prompt ID",
-          "name": "prompt-id",
-          "required": true
-        }
-      },
-      "description": "List versions of a prompt",
+      "args": {},
+      "description": "Create a new prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3547,11 +3629,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": "prompts:versions",
+      "id": "prompts:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3562,17 +3659,19 @@
         "dist",
         "commands",
         "prompts",
-        "versions.js"
+        "create.js"
       ]
     },
-    "setup:doctor": {
+    "prompts:get": {
       "aliases": [],
-      "args": {},
-      "description": "Diagnose coding-agent setup for Respan",
-      "examples": [
-        "respan setup doctor",
-        "respan setup doctor --global"
-      ],
+      "args": {
+        "id": {
+          "description": "Prompt ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3614,29 +3713,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "local": {
-          "description": "Check local project setup",
-          "exclusive": [
-            "global"
-          ],
-          "name": "local",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "global": {
-          "description": "Check global setup",
-          "exclusive": [
-            "local"
-          ],
-          "name": "global",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "setup:doctor",
+      "id": "prompts:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3646,19 +3727,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "setup",
-        "doctor.js"
+        "prompts",
+        "get.js"
       ]
     },
-    "setup:gateway": {
+    "prompts:list": {
       "aliases": [],
       "args": {},
-      "description": "Set up Respan gateway routing in this project.\n\nRuns the gateway setup flow directly (skips the \"Tracing or Gateway?\"\nquestion). Sets up your API key, installs the Respan skill, and optionally\nopens your coding agent to route the detected framework through the gateway.",
-      "examples": [
-        "respan setup gateway",
-        "respan setup gateway --agent claude-code",
-        "respan setup gateway --no-instrument"
-      ],
+      "description": "List prompts",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3683,13 +3759,13 @@
           "type": "option"
         },
         "json": {
-          "hidden": true,
+          "description": "Output as JSON",
           "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
         "csv": {
-          "hidden": true,
+          "description": "Output as CSV",
           "name": "csv",
           "allowNo": false,
           "type": "boolean"
@@ -3701,23 +3777,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "agent": {
-          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
-          "name": "agent",
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 50,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "no-instrument": {
-          "description": "Skip agent selection and opening after setup",
-          "name": "no-instrument",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "setup:gateway",
+      "id": "prompts:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3727,22 +3798,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "setup",
-        "gateway.js"
+        "prompts",
+        "list.js"
       ]
     },
-    "setup": {
+    "prompts:update": {
       "aliases": [],
-      "args": {},
-      "description": "Interactive setup wizard for Respan.\n\nSets up your API key, installs skills and SDK docs for your preferred\ncoding agents, and optionally runs a setup agent. Asks whether you want\nto set up tracing or gateway routing.\n\nThis is the recommended way to get started with Respan.",
-      "examples": [
-        "npx @respan/cli setup",
-        "respan setup",
-        "respan setup tracing",
-        "respan setup gateway",
-        "respan setup --agent claude-code",
-        "respan setup --no-instrument"
-      ],
+      "args": {
+        "id": {
+          "description": "Prompt ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3767,13 +3836,13 @@
           "type": "option"
         },
         "json": {
-          "hidden": true,
+          "description": "Output as JSON",
           "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
         "csv": {
-          "hidden": true,
+          "description": "Output as CSV",
           "name": "csv",
           "allowNo": false,
           "type": "boolean"
@@ -3785,23 +3854,24 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "agent": {
-          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
-          "name": "agent",
+        "name": {
+          "description": "Prompt name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-instrument": {
-          "description": "Skip agent selection and opening after setup",
-          "name": "no-instrument",
-          "allowNo": false,
-          "type": "boolean"
+        "description": {
+          "description": "Prompt description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "setup",
+      "id": "prompts:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3811,19 +3881,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "setup",
-        "index.js"
+        "prompts",
+        "update.js"
       ]
     },
-    "setup:tracing": {
+    "prompts:versions": {
       "aliases": [],
-      "args": {},
-      "description": "Set up Respan SDK tracing in this project.\n\nRuns the tracing setup flow directly (skips the \"Tracing or Gateway?\"\nquestion). Sets up your API key, installs the Respan skill, and optionally\nopens your coding agent to instrument the project.",
-      "examples": [
-        "respan setup tracing",
-        "respan setup tracing --agent claude-code",
-        "respan setup tracing --no-instrument"
-      ],
+      "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)",
@@ -3848,13 +3919,13 @@
           "type": "option"
         },
         "json": {
-          "hidden": true,
+          "description": "Output as JSON",
           "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
         "csv": {
-          "hidden": true,
+          "description": "Output as CSV",
           "name": "csv",
           "allowNo": false,
           "type": "boolean"
@@ -3865,24 +3936,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "agent": {
-          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
-          "name": "agent",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-instrument": {
-          "description": "Skip agent selection and opening after setup",
-          "name": "no-instrument",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "setup:tracing",
+      "id": "prompts:versions",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3892,20 +3950,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "setup",
-        "tracing.js"
+        "prompts",
+        "versions.js"
       ]
     },
-    "traces:get": {
+    "setup:doctor": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Trace ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get a specific trace",
+      "args": {},
+      "description": "Diagnose coding-agent setup for Respan",
+      "examples": [
+        "respan setup doctor",
+        "respan setup doctor --global"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3947,11 +4003,29 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "local": {
+          "description": "Check local project setup",
+          "exclusive": [
+            "global"
+          ],
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "global": {
+          "description": "Check global setup",
+          "exclusive": [
+            "local"
+          ],
+          "name": "global",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:get",
+      "id": "setup:doctor",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3961,14 +4035,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
-        "get.js"
+        "setup",
+        "doctor.js"
       ]
     },
-    "traces:list": {
+    "setup:gateway": {
       "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": "Deprecated gateway setup entry point. Prints the official gateway setup prompt.",
+      "examples": [
+        "respan setup gateway",
+        "respan setup gateway --agent claude-code",
+        "respan setup gateway --no-instrument"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4011,79 +4090,47 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "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",
+        "agent": {
+          "description": "Deprecated compatibility flag; no agent is launched",
+          "name": "agent",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "filter": {
-          "description": "Filter in field:operator:value format (repeatable)",
-          "name": "filter",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
+        "no-instrument": {
+          "description": "Deprecated compatibility flag; setup only prints a prompt",
+          "name": "no-instrument",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:list",
+      "id": "setup:gateway",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "traces",
-        "list.js"
+        "setup",
+        "gateway.js"
       ]
     },
-    "traces:summary": {
+    "setup": {
       "aliases": [],
       "args": {},
-      "description": "Get a span-level summary of activity for a time range (counts, latency, cost, errors aggregated across spans)",
+      "description": "Deprecated setup entry point. Prints tracing and gateway setup prompts.",
+      "examples": [
+        "npx @respan/cli setup",
+        "respan setup",
+        "respan setup tracing",
+        "respan setup gateway",
+        "respan setup --agent claude-code",
+        "respan setup --no-instrument"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4126,43 +4173,44 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "start-time": {
-          "description": "Start time (ISO 8601)",
-          "name": "start-time",
-          "required": true,
+        "agent": {
+          "description": "Deprecated compatibility flag; no agent is launched",
+          "name": "agent",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "end-time": {
-          "description": "End time (ISO 8601)",
-          "name": "end-time",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "no-instrument": {
+          "description": "Deprecated compatibility flag; setup only prints a prompt",
+          "name": "no-instrument",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:summary",
+      "id": "setup",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "traces",
-        "summary.js"
+        "setup",
+        "index.js"
       ]
     },
-    "users:create": {
+    "setup:tracing": {
       "aliases": [],
       "args": {},
-      "description": "Create a new user (customer)",
+      "description": "Deprecated tracing setup entry point. Prints the official tracing setup prompt.",
+      "examples": [
+        "respan setup tracing",
+        "respan setup tracing --agent claude-code",
+        "respan setup tracing --no-instrument"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4196,71 +4244,54 @@
           "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"
+          "type": "boolean"
         },
-        "email": {
-          "description": "Customer email",
-          "name": "email",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "verbose": {
+          "char": "v",
+          "description": "Show verbose output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "metadata": {
-          "description": "Metadata as JSON string",
-          "name": "metadata",
+        "agent": {
+          "description": "Deprecated compatibility flag; no agent is launched",
+          "name": "agent",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "no-instrument": {
+          "description": "Deprecated compatibility flag; setup only prints a prompt",
+          "name": "no-instrument",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:create",
+      "id": "setup:tracing",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "create.js"
+        "setup",
+        "tracing.js"
       ]
     },
-    "users:get": {
+    "traces:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Customer identifier",
+          "description": "Trace ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific user (customer)",
+      "description": "Get a specific trace",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4306,7 +4337,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:get",
+      "id": "traces:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4316,14 +4347,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
+        "traces",
         "get.js"
       ]
     },
-    "users:list": {
+    "traces:list": {
       "aliases": [],
       "args": {},
-      "description": "List users (customers)",
+      "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)",
@@ -4369,7 +4400,7 @@
         "limit": {
           "description": "Number of results per page",
           "name": "limit",
-          "default": 20,
+          "default": 10,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4383,8 +4414,23 @@
           "type": "option"
         },
         "sort-by": {
-          "description": "Sort field",
+          "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"
@@ -4395,11 +4441,18 @@
           "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": "users:list",
+      "id": "traces:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4409,20 +4462,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
+        "traces",
         "list.js"
       ]
     },
-    "users:update": {
+    "traces:summary": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Customer identifier",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a user (customer)",
+      "args": {},
+      "description": "Get a span-level summary of activity for a time range (counts, latency, cost, errors aggregated across spans)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4465,23 +4512,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Customer name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "email": {
-          "description": "Customer email",
-          "name": "email",
+        "start-time": {
+          "description": "Start time (ISO 8601)",
+          "name": "start-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "metadata": {
-          "description": "Metadata as JSON string",
-          "name": "metadata",
+        "end-time": {
+          "description": "End time (ISO 8601)",
+          "name": "end-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4489,7 +4531,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:update",
+      "id": "traces:summary",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4499,14 +4541,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "update.js"
+        "traces",
+        "summary.js"
       ]
     },
-    "logs:create": {
+    "users:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a log span",
+      "description": "Create a new user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4549,24 +4591,24 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "input": {
-          "description": "Input text or JSON",
-          "name": "input",
+        "identifier": {
+          "description": "Customer identifier",
+          "name": "identifier",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output": {
-          "description": "Output text or JSON",
-          "name": "output",
+        "name": {
+          "description": "Customer name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "model": {
-          "description": "Model name",
-          "name": "model",
+        "email": {
+          "description": "Customer email",
+          "name": "email",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4581,7 +4623,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:create",
+      "id": "users:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4591,20 +4633,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "users",
         "create.js"
       ]
     },
-    "logs:get": {
+    "users:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Span ID",
+          "description": "Customer identifier",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific log span",
+      "description": "Get a specific user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4650,7 +4692,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:get",
+      "id": "users:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4660,14 +4702,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "users",
         "get.js"
       ]
     },
-    "logs:list": {
+    "users:list": {
       "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",
+      "description": "List users (customers)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4711,9 +4753,9 @@
           "type": "boolean"
         },
         "limit": {
-          "description": "Number of results per page (max 1000)",
+          "description": "Number of results per page",
           "name": "limit",
-          "default": 50,
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4727,50 +4769,15 @@
           "type": "option"
         },
         "sort-by": {
-          "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
+          "description": "Sort field",
           "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",
+        "environment": {
+          "description": "Environment filter",
+          "name": "environment",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4778,7 +4785,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:list",
+      "id": "users:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4788,14 +4795,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
+        "users",
         "list.js"
       ]
     },
-    "logs:summary": {
+    "users:update": {
       "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",
+      "args": {
+        "id": {
+          "description": "Customer identifier",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4838,39 +4851,23 @@
           "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,
+        "name": {
+          "description": "Customer name",
+          "name": "name",
           "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",
+        "email": {
+          "description": "Customer email",
+          "name": "email",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "is-test": {
-          "description": "Filter by test (true) or production (false) environment",
-          "name": "is-test",
+        "metadata": {
+          "description": "Metadata as JSON string",
+          "name": "metadata",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4878,7 +4875,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:summary",
+      "id": "users:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4888,10 +4885,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
-        "summary.js"
+        "users",
+        "update.js"
       ]
     }
   },
-  "version": "0.14.1"
+  "version": "0.15.0"
 }