@respan/cli 0.12.0 → 0.13.0

package/oclif.manifest.json

@@ -470,6 +470,146 @@
         "set.js"
       ]
     },
+    "demo:clear": {
+      "aliases": [],
+      "args": {},
+      "description": "Delete the sample prompts, datasets, and evaluators created by `respan demo`. Demo traces are left in place (each run is timestamped history). Idempotent — safe to re-run.",
+      "examples": [
+        "<%= config.bin %> demo clear",
+        "<%= config.bin %> demo clear --yes"
+      ],
+      "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"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip the confirmation prompt",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "demo:clear",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "demo",
+        "clear.js"
+      ]
+    },
+    "demo": {
+      "aliases": [],
+      "args": {},
+      "description": "Seed your account with sample data (prompts and traces) so you have something to explore. Idempotent — safe to re-run.",
+      "examples": [
+        "<%= config.bin %> demo"
+      ],
+      "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": "demo",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "demo",
+        "index.js"
+      ]
+    },
     "datasets:create-span": {
       "aliases": [],
       "args": {
@@ -999,14 +1139,16 @@
         "update.js"
       ]
     },
-    "demo:clear": {
+    "eval": {
       "aliases": [],
-      "args": {},
-      "description": "Delete the sample prompts, datasets, and evaluators created by `respan demo`. Demo traces are left in place (each run is timestamped history). Idempotent — safe to re-run.",
-      "examples": [
-        "<%= config.bin %> demo clear",
-        "<%= config.bin %> demo clear --yes"
-      ],
+      "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)",
@@ -1048,18 +1190,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Skip the confirmation prompt",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "demo:clear",
+      "id": "eval",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1069,17 +1204,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "demo",
-        "clear.js"
+        "eval",
+        "index.js"
       ]
     },
-    "demo": {
+    "evaluators:create": {
       "aliases": [],
       "args": {},
-      "description": "Seed your account with sample data (prompts and traces) so you have something to explore. Idempotent — safe to re-run.",
-      "examples": [
-        "<%= config.bin %> demo"
-      ],
+      "description": "Create a new evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1121,11 +1253,40 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "name": {
+          "description": "Evaluator name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "description": "Evaluator type",
+          "name": "type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Evaluator description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "config": {
+          "description": "Evaluator config as JSON string",
+          "name": "config",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "demo",
+      "id": "evaluators:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1135,20 +1296,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "demo",
-        "index.js"
+        "evaluators",
+        "create.js"
       ]
     },
-    "eval": {
+    "evaluators:get": {
       "aliases": [],
       "args": {
-        "file": {
-          "description": "Path to eval JSON file",
-          "name": "file",
+        "id": {
+          "description": "Evaluator ID",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Run an eval defined in a JSON file (creates prompt + dataset on the platform)",
+      "description": "Get a specific evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1194,7 +1355,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "eval",
+      "id": "evaluators:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1204,14 +1365,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "eval",
-        "index.js"
+        "evaluators",
+        "get.js"
       ]
     },
-    "evaluators:create": {
+    "evaluators:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a new evaluator",
+      "description": "List evaluators",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1254,31 +1415,18 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Evaluator name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "type": {
-          "description": "Evaluator type",
-          "name": "type",
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Evaluator description",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "config": {
-          "description": "Evaluator config as JSON string",
-          "name": "config",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1286,7 +1434,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:create",
+      "id": "evaluators:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1297,10 +1445,10 @@
         "dist",
         "commands",
         "evaluators",
-        "create.js"
+        "list.js"
       ]
     },
-    "evaluators:get": {
+    "evaluators:run": {
       "aliases": [],
       "args": {
         "id": {
@@ -1309,7 +1457,7 @@
           "required": true
         }
       },
-      "description": "Get a specific evaluator",
+      "description": "Run an evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1351,11 +1499,32 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "dataset-id": {
+          "description": "Dataset ID to evaluate against",
+          "name": "dataset-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "log-ids": {
+          "description": "Comma-separated log/span IDs to evaluate",
+          "name": "log-ids",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "params": {
+          "description": "Additional parameters as JSON string",
+          "name": "params",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:get",
+      "id": "evaluators:run",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1366,13 +1535,19 @@
         "dist",
         "commands",
         "evaluators",
-        "get.js"
+        "run.js"
       ]
     },
-    "evaluators:list": {
+    "evaluators:update": {
       "aliases": [],
-      "args": {},
-      "description": "List evaluators",
+      "args": {
+        "id": {
+          "description": "Evaluator ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update an evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1415,18 +1590,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 20,
+        "name": {
+          "description": "Evaluator name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "description": {
+          "description": "Evaluator description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "config": {
+          "description": "Evaluator config as JSON string",
+          "name": "config",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1434,7 +1614,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:list",
+      "id": "evaluators:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1445,19 +1625,13 @@
         "dist",
         "commands",
         "evaluators",
-        "list.js"
+        "update.js"
       ]
     },
-    "evaluators:run": {
+    "experiments:create": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Evaluator ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Run an evaluator",
+      "args": {},
+      "description": "Create a new experiment",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1500,23 +1674,32 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "name": {
+          "description": "Experiment name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "dataset-id": {
-          "description": "Dataset ID to evaluate against",
+          "description": "Dataset ID",
           "name": "dataset-id",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "log-ids": {
-          "description": "Comma-separated log/span IDs to evaluate",
-          "name": "log-ids",
+        "description": {
+          "description": "Experiment description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "params": {
-          "description": "Additional parameters as JSON string",
-          "name": "params",
+        "workflows": {
+          "description": "Workflows configuration as JSON string",
+          "name": "workflows",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1524,7 +1707,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:run",
+      "id": "experiments:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1534,20 +1717,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "run.js"
+        "experiments",
+        "create.js"
       ]
     },
-    "evaluators:update": {
+    "experiments:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Evaluator ID",
+          "description": "Experiment ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Update an evaluator",
+      "description": "Get a specific experiment",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1589,24 +1772,82 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "experiments:get",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "experiments",
+        "get.js"
+      ]
+    },
+    "experiments:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List experiments",
+      "flags": {
+        "api-key": {
+          "description": "API key (env: RESPAN_API_KEY)",
+          "env": "RESPAN_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "name": {
-          "description": "Evaluator name",
-          "name": "name",
+        "base-url": {
+          "description": "Temporary API base URL override for this command",
+          "name": "base-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Evaluator description",
-          "name": "description",
+        "profile": {
+          "description": "Named profile to use",
+          "name": "profile",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "config": {
-          "description": "Evaluator config as JSON string",
-          "name": "config",
+        "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"
+        },
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1614,7 +1855,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:update",
+      "id": "experiments:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1624,8 +1865,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "update.js"
+        "experiments",
+        "list.js"
       ]
     },
     "integrate:claude-code": {
@@ -2234,10 +2475,10 @@
         "opencode.js"
       ]
     },
-    "experiments:create": {
+    "logs:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a new experiment",
+      "description": "Create a log span",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2280,32 +2521,31 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Experiment name",
-          "name": "name",
+        "input": {
+          "description": "Input text or JSON",
+          "name": "input",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "dataset-id": {
-          "description": "Dataset ID",
-          "name": "dataset-id",
-          "required": true,
+        "output": {
+          "description": "Output text or JSON",
+          "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Experiment description",
-          "name": "description",
+        "model": {
+          "description": "Model name",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "workflows": {
-          "description": "Workflows configuration as JSON string",
-          "name": "workflows",
+        "metadata": {
+          "description": "Metadata as JSON string",
+          "name": "metadata",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2313,7 +2553,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "experiments:create",
+      "id": "logs:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2323,20 +2563,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "experiments",
+        "logs",
         "create.js"
       ]
     },
-    "experiments:get": {
+    "logs:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Experiment ID",
+          "description": "Span ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific experiment",
+      "description": "Get a specific log span",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2382,7 +2622,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "experiments:get",
+      "id": "logs:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2392,14 +2632,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "experiments",
+        "logs",
         "get.js"
       ]
     },
-    "experiments:list": {
+    "logs:list": {
       "aliases": [],
       "args": {},
-      "description": "List experiments",
+      "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)",
@@ -2443,249 +2683,9 @@
           "type": "boolean"
         },
         "limit": {
-          "description": "Number of results per page",
+          "description": "Number of results per page (max 1000)",
           "name": "limit",
-          "default": 20,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "experiments:list",
-      "pluginAlias": "@respan/cli",
-      "pluginName": "@respan/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "experiments",
-        "list.js"
-      ]
-    },
-    "logs:create": {
-      "aliases": [],
-      "args": {},
-      "description": "Create a log span",
-      "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"
-        },
-        "input": {
-          "description": "Input text or JSON",
-          "name": "input",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "output": {
-          "description": "Output text or JSON",
-          "name": "output",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "model": {
-          "description": "Model name",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "metadata": {
-          "description": "Metadata as JSON string",
-          "name": "metadata",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "logs:create",
-      "pluginAlias": "@respan/cli",
-      "pluginName": "@respan/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "logs",
-        "create.js"
-      ]
-    },
-    "logs:get": {
-      "aliases": [],
-      "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)",
-          "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": "logs:get",
-      "pluginAlias": "@respan/cli",
-      "pluginName": "@respan/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "logs",
-        "get.js"
-      ]
-    },
-    "logs: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",
-      "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"
-        },
-        "limit": {
-          "description": "Number of results per page (max 1000)",
-          "name": "limit",
-          "default": 50,
+          "default": 50,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2864,16 +2864,16 @@
         "summary.js"
       ]
     },
-    "traces:get": {
+    "prompts:create-version": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Trace ID",
-          "name": "id",
+        "prompt-id": {
+          "description": "Prompt ID",
+          "name": "prompt-id",
           "required": true
         }
       },
-      "description": "Get a specific trace",
+      "description": "Create a new version of a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2915,11 +2915,40 @@
           "name": "verbose",
           "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",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "max-tokens": {
+          "description": "Max tokens",
+          "name": "max-tokens",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:get",
+      "id": "prompts:create-version",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2929,14 +2958,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
-        "get.js"
+        "prompts",
+        "create-version.js"
       ]
     },
-    "traces:list": {
+    "prompts:create": {
       "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": "Create a new prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2979,62 +3008,25 @@
           "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",
+        "name": {
+          "description": "Prompt name",
+          "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment": {
-          "description": "Environment filter",
-          "name": "environment",
+        "description": {
+          "description": "Prompt description",
+          "name": "description",
           "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": "prompts:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3044,14 +3036,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
-        "list.js"
+        "prompts",
+        "create.js"
       ]
     },
-    "traces:summary": {
+    "prompts:get": {
       "aliases": [],
-      "args": {},
-      "description": "Get a span-level summary of activity for a time range (counts, latency, cost, errors aggregated across spans)",
+      "args": {
+        "id": {
+          "description": "Prompt ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3093,27 +3091,11 @@
           "name": "verbose",
           "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:summary",
+      "id": "prompts:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3123,18 +3105,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
-        "summary.js"
+        "prompts",
+        "get.js"
       ]
     },
-    "setup:doctor": {
+    "prompts:list": {
       "aliases": [],
       "args": {},
-      "description": "Diagnose coding-agent setup for Respan",
-      "examples": [
-        "respan setup doctor",
-        "respan setup doctor --global"
-      ],
+      "description": "List prompts",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3177,28 +3155,18 @@
           "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"
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "setup:doctor",
+      "id": "prompts:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3208,19 +3176,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "setup",
-        "doctor.js"
+        "prompts",
+        "list.js"
       ]
     },
-    "setup:gateway": {
+    "prompts:update": {
       "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"
-      ],
+      "args": {
+        "id": {
+          "description": "Prompt ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3245,13 +3214,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"
@@ -3263,23 +3232,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 opening the agent 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:gateway",
+      "id": "prompts:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3287,24 +3257,22 @@
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
-        "dist",
-        "commands",
-        "setup",
-        "gateway.js"
-      ]
-    },
-    "setup": {
-      "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"
-      ],
+        "dist",
+        "commands",
+        "prompts",
+        "update.js"
+      ]
+    },
+    "prompts:versions": {
+      "aliases": [],
+      "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)",
@@ -3329,13 +3297,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"
@@ -3346,24 +3314,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 opening the agent after setup",
-          "name": "no-instrument",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "setup",
+      "id": "prompts:versions",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3373,18 +3328,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "setup",
-        "index.js"
+        "prompts",
+        "versions.js"
       ]
     },
-    "setup:tracing": {
+    "setup:doctor": {
       "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.",
+      "description": "Diagnose coding-agent setup for Respan",
       "examples": [
-        "respan setup tracing",
-        "respan setup tracing --agent claude-code",
-        "respan setup tracing --no-instrument"
+        "respan setup doctor",
+        "respan setup doctor --global"
       ],
       "flags": {
         "api-key": {
@@ -3410,13 +3364,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"
@@ -3428,23 +3382,28 @@
           "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"
+        "local": {
+          "description": "Check local project setup",
+          "exclusive": [
+            "global"
+          ],
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "no-instrument": {
-          "description": "Skip opening the agent after setup",
-          "name": "no-instrument",
+        "global": {
+          "description": "Check global setup",
+          "exclusive": [
+            "local"
+          ],
+          "name": "global",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "setup:tracing",
+      "id": "setup:doctor",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3455,13 +3414,18 @@
         "dist",
         "commands",
         "setup",
-        "tracing.js"
+        "doctor.js"
       ]
     },
-    "users:create": {
+    "setup:gateway": {
       "aliases": [],
       "args": {},
-      "description": "Create a new user (customer)",
+      "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"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3486,13 +3450,13 @@
           "type": "option"
         },
         "json": {
-          "description": "Output as JSON",
+          "hidden": true,
           "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
         "csv": {
-          "description": "Output as CSV",
+          "hidden": true,
           "name": "csv",
           "allowNo": false,
           "type": "boolean"
@@ -3504,39 +3468,23 @@
           "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",
+        "agent": {
+          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
+          "name": "agent",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "metadata": {
-          "description": "Metadata as JSON string",
-          "name": "metadata",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "no-instrument": {
+          "description": "Skip opening the agent after setup",
+          "name": "no-instrument",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:create",
+      "id": "setup:gateway",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3546,20 +3494,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "create.js"
+        "setup",
+        "gateway.js"
       ]
     },
-    "users:get": {
+    "setup": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Customer identifier",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get a specific user (customer)",
+      "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"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3584,13 +3534,13 @@
           "type": "option"
         },
         "json": {
-          "description": "Output as JSON",
+          "hidden": true,
           "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
         "csv": {
-          "description": "Output as CSV",
+          "hidden": true,
           "name": "csv",
           "allowNo": false,
           "type": "boolean"
@@ -3601,11 +3551,24 @@
           "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 opening the agent after setup",
+          "name": "no-instrument",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:get",
+      "id": "setup",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3615,14 +3578,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "get.js"
+        "setup",
+        "index.js"
       ]
     },
-    "users:list": {
+    "setup:tracing": {
       "aliases": [],
       "args": {},
-      "description": "List users (customers)",
+      "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"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3647,13 +3615,13 @@
           "type": "option"
         },
         "json": {
-          "description": "Output as JSON",
+          "hidden": true,
           "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
         "csv": {
-          "description": "Output as CSV",
+          "hidden": true,
           "name": "csv",
           "allowNo": false,
           "type": "boolean"
@@ -3665,40 +3633,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 20,
-          "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",
-          "name": "sort-by",
+        "agent": {
+          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
+          "name": "agent",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment": {
-          "description": "Environment filter",
-          "name": "environment",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "no-instrument": {
+          "description": "Skip opening the agent after setup",
+          "name": "no-instrument",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:list",
+      "id": "setup:tracing",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3708,20 +3659,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "list.js"
+        "setup",
+        "tracing.js"
       ]
     },
-    "users:update": {
+    "traces:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Customer identifier",
+          "description": "Trace ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Update a user (customer)",
+      "description": "Get a specific trace",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3759,36 +3710,15 @@
         },
         "verbose": {
           "char": "v",
-          "description": "Show verbose output",
-          "name": "verbose",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "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"
+          "description": "Show verbose output",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:update",
+      "id": "traces:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3798,20 +3728,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "update.js"
+        "traces",
+        "get.js"
       ]
     },
-    "prompts:create-version": {
+    "traces:list": {
       "aliases": [],
-      "args": {
-        "prompt-id": {
-          "description": "Prompt ID",
-          "name": "prompt-id",
-          "required": true
-        }
-      },
-      "description": "Create a new version of a prompt",
+      "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",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3854,39 +3778,62 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "messages": {
-          "description": "Messages as JSON array string",
-          "name": "messages",
-          "required": true,
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 10,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "model": {
-          "description": "Model name",
-          "name": "model",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "temperature": {
-          "description": "Temperature value",
-          "name": "temperature",
+        "sort-by": {
+          "description": "Sort field (prefix with - for descending)",
+          "name": "sort-by",
+          "default": "-timestamp",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "max-tokens": {
-          "description": "Max tokens",
-          "name": "max-tokens",
+        "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:create-version",
+      "id": "traces:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3896,14 +3843,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "create-version.js"
+        "traces",
+        "list.js"
       ]
     },
-    "prompts:create": {
+    "traces:summary": {
       "aliases": [],
       "args": {},
-      "description": "Create a new prompt",
+      "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)",
@@ -3946,17 +3893,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"
@@ -3964,7 +3912,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:create",
+      "id": "traces:summary",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3974,20 +3922,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "create.js"
+        "traces",
+        "summary.js"
       ]
     },
-    "prompts:get": {
+    "users:create": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Prompt ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get a specific prompt",
+      "args": {},
+      "description": "Create a new user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4029,11 +3971,40 @@
           "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:get",
+      "id": "users:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4043,14 +4014,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "get.js"
+        "users",
+        "create.js"
       ]
     },
-    "prompts:list": {
+    "users:get": {
       "aliases": [],
-      "args": {},
-      "description": "List prompts",
+      "args": {
+        "id": {
+          "description": "Customer identifier",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4092,19 +4069,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 50,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:list",
+      "id": "users:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4114,20 +4083,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "list.js"
+        "users",
+        "get.js"
       ]
     },
-    "prompts:update": {
+    "users:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Prompt ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a prompt",
+      "args": {},
+      "description": "List users (customers)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4170,16 +4133,32 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Prompt name",
-          "name": "name",
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Prompt description",
-          "name": "description",
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sort-by": {
+          "description": "Sort field",
+          "name": "sort-by",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment": {
+          "description": "Environment filter",
+          "name": "environment",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4187,7 +4166,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:update",
+      "id": "users:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4197,20 +4176,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "update.js"
+        "users",
+        "list.js"
       ]
     },
-    "prompts:versions": {
+    "users:update": {
       "aliases": [],
       "args": {
-        "prompt-id": {
-          "description": "Prompt ID",
-          "name": "prompt-id",
+        "id": {
+          "description": "Customer identifier",
+          "name": "id",
           "required": true
         }
       },
-      "description": "List versions of a prompt",
+      "description": "Update a user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4252,11 +4231,32 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "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:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4266,10 +4266,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "versions.js"
+        "users",
+        "update.js"
       ]
     }
   },
-  "version": "0.12.0"
+  "version": "0.13.0"
 }