npm - @respan/cli - Versions diffs - 0.13.3 → 0.14.1 - Mend

@respan/cli 0.13.3 → 0.14.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/dist/commands/collector/config.d.ts +21 -0
package/dist/commands/collector/config.js +73 -0
package/dist/commands/collector/start.d.ts +26 -0
package/dist/commands/collector/start.js +198 -0
package/dist/commands/collector/status.d.ts +17 -0
package/dist/commands/collector/status.js +113 -0
package/dist/commands/collector/stop.d.ts +18 -0
package/dist/commands/collector/stop.js +91 -0
package/dist/commands/integrate/pi.d.ts +28 -0
package/dist/commands/integrate/pi.js +198 -0
package/dist/lib/collector-runtime.d.ts +93 -0
package/dist/lib/collector-runtime.js +361 -0
package/dist/lib/collector.d.ts +135 -0
package/dist/lib/collector.js +289 -0
package/dist/lib/pi-integrate.d.ts +49 -0
package/dist/lib/pi-integrate.js +74 -0
package/dist/lib/skill-refs.generated.d.ts +1 -1
package/dist/lib/skill-refs.generated.js +7 -0
package/oclif.manifest.json +1286 -664
package/package.json +7 -2

package/oclif.manifest.json CHANGED Viewed

@@ -264,16 +264,16 @@
         "status.js"
       ]
     },
-    "config:get": {
+    "collector:config": {
       "aliases": [],
-      "args": {
-        "key": {
-          "description": "Config key",
-          "name": "key",
-          "required": true
-        }
-      },
-      "description": "Get a configuration value",
+      "args": {},
+      "description": "Write the Respan collector configuration.\n\nThe Respan collector is the upstream OpenTelemetry Collector (contrib\n0.160.0) with a config that receives OTLP/HTTP from the Respan SDKs\non localhost and forwards it to Respan through a bounded, persistent\n(write-ahead-log) queue — spans survive Respan outages and collector\nrestarts without unbounded local growth.\n\nThe written file never contains your API key: it reads RESPAN_API_KEY from\nthe environment. Use \"respan collector start\" to run it, or run\notelcol-contrib yourself with --config <file>.",
+      "examples": [
+        "respan collector config",
+        "respan collector config --print",
+        "respan collector config --output ./collector.yaml --max-size-mib 1024",
+        "respan collector config --export-url https://respan.internal/api/v2/traces"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -315,11 +315,63 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "export-url": {
+          "description": "Respan ingest URL (default: <base URL>/api/v2/traces from your auth config)",
+          "env": "RESPAN_COLLECTOR_EXPORT_URL",
+          "name": "export-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "data-dir": {
+          "description": "Persistent queue directory, binary mode only (default: ~/.respan/collector/data)",
+          "name": "data-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "max-size-mib": {
+          "description": "Disk cap for the persistent queue in MiB (minimum 100)",
+          "name": "max-size-mib",
+          "default": 512,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "queue-size": {
+          "description": "Batches kept while Respan is unreachable",
+          "name": "queue-size",
+          "default": 10000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "port": {
+          "description": "Local OTLP/HTTP port the SDKs send to",
+          "name": "port",
+          "default": 4318,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "description": "Where to write the config (default: ~/.respan/collector/config.yaml)",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "print": {
+          "description": "Print the config to stdout instead of writing it",
+          "name": "print",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:get",
+      "id": "collector:config",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -329,14 +381,21 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "get.js"
+        "collector",
+        "config.js"
       ]
     },
-    "config:list": {
+    "collector:start": {
       "aliases": [],
       "args": {},
-      "description": "List all configuration",
+      "description": "Start a local Respan collector.\n\nRuns the OpenTelemetry Collector (contrib) with the Respan config: the SDKs\nsend to http://127.0.0.1:4318, and the collector forwards to Respan through\na bounded, persistent queue so traces survive outages and restarts.\n\nModes:\n  --docker   docker run otel/opentelemetry-collector-contrib with the queue in\n             the respan-collector-queue volume (default when Docker is available)\n  --binary   download otelcol-contrib to ~/.respan/collector/bin and run it\n             detached, logging to ~/.respan/collector/collector.log\n\nThe API key is passed to the collector through its environment only; the\nconfig file never contains it.",
+      "examples": [
+        "respan collector start",
+        "respan collector start --binary",
+        "respan collector start --docker --max-size-mib 1024 --queue-size 20000",
+        "respan collector start --export-url https://respan.internal/api/v2/traces",
+        "respan collector start --dry-run"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -378,11 +437,74 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "docker": {
+          "description": "Use the Docker container (default when Docker is available)",
+          "exclusive": [
+            "binary"
+          ],
+          "name": "docker",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "binary": {
+          "description": "Use the otelcol-contrib binary in ~/.respan/collector/bin",
+          "exclusive": [
+            "docker"
+          ],
+          "name": "binary",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "export-url": {
+          "description": "Respan ingest URL (default: <base URL>/api/v2/traces from your auth config)",
+          "env": "RESPAN_COLLECTOR_EXPORT_URL",
+          "name": "export-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "data-dir": {
+          "description": "Persistent queue directory, binary mode only (default: ~/.respan/collector/data)",
+          "name": "data-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "max-size-mib": {
+          "description": "Disk cap for the persistent queue in MiB (minimum 100)",
+          "name": "max-size-mib",
+          "default": 512,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "queue-size": {
+          "description": "Batches kept while Respan is unreachable",
+          "name": "queue-size",
+          "default": 10000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "port": {
+          "description": "Local OTLP/HTTP port the SDKs send to",
+          "name": "port",
+          "default": 4318,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Show what would be done without starting anything",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:list",
+      "id": "collector:start",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -392,25 +514,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "list.js"
+        "collector",
+        "start.js"
       ]
     },
-    "config:set": {
+    "collector:status": {
       "aliases": [],
-      "args": {
-        "key": {
-          "description": "Config key",
-          "name": "key",
-          "required": true
-        },
-        "value": {
-          "description": "Config value",
-          "name": "value",
-          "required": true
-        }
-      },
-      "description": "Set a configuration value",
+      "args": {},
+      "description": "Show the local Respan collector's health and queue.\n\nReports how the collector is running (Docker container or binary), the\nhealth_check result, and the exporter metrics that matter for delivery:\nqueued batches, spans sent, spans dropped because the queue was full\n(enqueue-failed) and spans rejected by Respan (send-failed).",
+      "examples": [
+        "respan collector status",
+        "respan collector status --json"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -452,11 +567,37 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "docker": {
+          "description": "Use the Docker container (default when Docker is available)",
+          "exclusive": [
+            "binary"
+          ],
+          "name": "docker",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "binary": {
+          "description": "Use the otelcol-contrib binary in ~/.respan/collector/bin",
+          "exclusive": [
+            "docker"
+          ],
+          "name": "binary",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "port": {
+          "description": "Local OTLP/HTTP port used in the SDK hint",
+          "name": "port",
+          "default": 4318,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "config:set",
+      "id": "collector:status",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -466,20 +607,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "config",
-        "set.js"
+        "collector",
+        "status.js"
       ]
     },
-    "datasets:create-span": {
+    "collector:stop": {
       "aliases": [],
-      "args": {
-        "dataset-id": {
-          "description": "Dataset ID",
-          "name": "dataset-id",
-          "required": true
-        }
-      },
-      "description": "Create a span in a dataset",
+      "args": {},
+      "description": "Stop the local Respan collector.\n\nRemoves the respan-collector container or stops the detached binary. Spans\nstill queued on disk are kept and delivered the next time the collector\nstarts; pass --purge --yes to delete them.",
+      "examples": [
+        "respan collector stop",
+        "respan collector stop --purge --yes"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -522,18 +661,40 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "body": {
-          "description": "Span body as JSON string",
-          "name": "body",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "docker": {
+          "description": "Use the Docker container (default when Docker is available)",
+          "exclusive": [
+            "binary"
+          ],
+          "name": "docker",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "binary": {
+          "description": "Use the otelcol-contrib binary in ~/.respan/collector/bin",
+          "exclusive": [
+            "docker"
+          ],
+          "name": "binary",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "purge": {
+          "description": "Also delete the queued data (the respan-collector-queue volume / data dir). Requires --yes",
+          "name": "purge",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "description": "Confirm deleting queued spans with --purge",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:create-span",
+      "id": "collector:stop",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -543,14 +704,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "datasets",
-        "create-span.js"
+        "collector",
+        "stop.js"
       ]
     },
-    "datasets:create": {
+    "config:get": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new dataset",
+      "args": {
+        "key": {
+          "description": "Config key",
+          "name": "key",
+          "required": true
+        }
+      },
+      "description": "Get a configuration value",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -592,26 +759,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "name": {
-          "description": "Dataset name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Dataset description",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:create",
+      "id": "config:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -621,25 +773,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "datasets",
-        "create.js"
+        "config",
+        "get.js"
       ]
     },
-    "datasets:get-span": {
+    "config:list": {
       "aliases": [],
-      "args": {
-        "dataset-id": {
-          "description": "Dataset ID",
-          "name": "dataset-id",
-          "required": true
-        },
-        "span-id": {
-          "description": "Span ID",
-          "name": "span-id",
-          "required": true
-        }
-      },
-      "description": "Get a specific span from a dataset",
+      "args": {},
+      "description": "List all configuration",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -685,7 +826,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:get-span",
+      "id": "config:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -695,20 +836,25 @@
       "relativePath": [
         "dist",
         "commands",
-        "datasets",
-        "get-span.js"
+        "config",
+        "list.js"
       ]
     },
-    "datasets:get": {
+    "config:set": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Dataset ID",
-          "name": "id",
+        "key": {
+          "description": "Config key",
+          "name": "key",
+          "required": true
+        },
+        "value": {
+          "description": "Config value",
+          "name": "value",
           "required": true
         }
       },
-      "description": "Get a specific dataset",
+      "description": "Set a configuration value",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -754,7 +900,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:get",
+      "id": "config:set",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -764,14 +910,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "datasets",
-        "get.js"
+        "config",
+        "set.js"
       ]
     },
-    "datasets:list": {
+    "datasets:create-span": {
       "aliases": [],
-      "args": {},
-      "description": "List datasets",
+      "args": {
+        "dataset-id": {
+          "description": "Dataset ID",
+          "name": "dataset-id",
+          "required": true
+        }
+      },
+      "description": "Create a span in a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -814,18 +966,10 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 50,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
+        "body": {
+          "description": "Span body as JSON string",
+          "name": "body",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -833,7 +977,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:list",
+      "id": "datasets:create-span",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -844,19 +988,13 @@
         "dist",
         "commands",
         "datasets",
-        "list.js"
+        "create-span.js"
       ]
     },
-    "datasets:spans": {
+    "datasets:create": {
       "aliases": [],
-      "args": {
-        "dataset-id": {
-          "description": "Dataset ID",
-          "name": "dataset-id",
-          "required": true
-        }
-      },
-      "description": "List spans in a dataset",
+      "args": {},
+      "description": "Create a new dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -898,11 +1036,26 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "name": {
+          "description": "Dataset name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "Dataset description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:spans",
+      "id": "datasets:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -913,19 +1066,24 @@
         "dist",
         "commands",
         "datasets",
-        "spans.js"
+        "create.js"
       ]
     },
-    "datasets:update": {
+    "datasets:get-span": {
       "aliases": [],
       "args": {
-        "id": {
+        "dataset-id": {
           "description": "Dataset ID",
-          "name": "id",
+          "name": "dataset-id",
+          "required": true
+        },
+        "span-id": {
+          "description": "Span ID",
+          "name": "span-id",
           "required": true
         }
       },
-      "description": "Update a dataset",
+      "description": "Get a specific span from a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -967,25 +1125,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "name": {
-          "description": "Dataset name",
-          "name": "name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "description": "Dataset description",
-          "name": "description",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "datasets:update",
+      "id": "datasets:get-span",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -996,17 +1140,19 @@
         "dist",
         "commands",
         "datasets",
-        "update.js"
+        "get-span.js"
       ]
     },
-    "demo:clear": {
+    "datasets:get": {
       "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": {
+        "id": {
+          "description": "Dataset ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1048,18 +1194,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": "datasets:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1069,17 +1208,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "demo",
-        "clear.js"
+        "datasets",
+        "get.js"
       ]
     },
-    "demo": {
+    "datasets:list": {
       "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": "List datasets",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1121,11 +1257,27 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "page": {
+          "description": "Page number",
+          "name": "page",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "demo",
+      "id": "datasets:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1135,20 +1287,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "demo",
-        "index.js"
+        "datasets",
+        "list.js"
       ]
     },
-    "eval": {
+    "datasets:spans": {
       "aliases": [],
       "args": {
-        "file": {
-          "description": "Path to eval JSON file",
-          "name": "file",
+        "dataset-id": {
+          "description": "Dataset ID",
+          "name": "dataset-id",
           "required": true
         }
       },
-      "description": "Run an eval defined in a JSON file (creates prompt + dataset on the platform)",
+      "description": "List spans in a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1194,7 +1346,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "eval",
+      "id": "datasets:spans",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1204,14 +1356,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "eval",
-        "index.js"
+        "datasets",
+        "spans.js"
       ]
     },
-    "evaluators:create": {
+    "datasets:update": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new evaluator",
+      "args": {
+        "id": {
+          "description": "Dataset ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a dataset",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1255,38 +1413,23 @@
           "type": "boolean"
         },
         "name": {
-          "description": "Evaluator name",
+          "description": "Dataset 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",
+          "description": "Dataset 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": "evaluators:create",
+      "id": "datasets:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1296,20 +1439,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "create.js"
+        "datasets",
+        "update.js"
       ]
     },
-    "evaluators:get": {
+    "demo:clear": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Evaluator ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get a specific evaluator",
+      "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)",
@@ -1351,11 +1492,18 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip the confirmation prompt",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:get",
+      "id": "demo:clear",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1365,14 +1513,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "get.js"
+        "demo",
+        "clear.js"
       ]
     },
-    "evaluators:list": {
+    "demo": {
       "aliases": [],
       "args": {},
-      "description": "List evaluators",
+      "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)",
@@ -1414,27 +1565,11 @@
           "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "evaluators:list",
+      "id": "demo",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -1444,20 +1579,260 @@
       "relativePath": [
         "dist",
         "commands",
-        "evaluators",
-        "list.js"
+        "demo",
+        "index.js"
       ]
     },
-    "evaluators:run": {
+    "evaluators:create": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Evaluator ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Run an evaluator",
+      "args": {},
+      "description": "Create a new evaluator",
+      "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"
+        },
+        "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": "evaluators:create",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "evaluators",
+        "create.js"
+      ]
+    },
+    "evaluators:get": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Evaluator ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific evaluator",
+      "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": "evaluators:get",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "evaluators",
+        "get.js"
+      ]
+    },
+    "evaluators:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List evaluators",
+      "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",
+          "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": "evaluators:list",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "evaluators",
+        "list.js"
+      ]
+    },
+    "evaluators:run": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Evaluator ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Run an evaluator",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -1869,16 +2244,85 @@
         "list.js"
       ]
     },
-    "integrate:claude-code": {
+    "eval": {
       "aliases": [],
-      "args": {},
-      "description": "Integrate Respan with Claude Code.\n\nInstalls a Stop hook that reads conversation transcripts and sends\nthem to Respan as structured spans (chat, tool, thinking).\n\nScope:\n  --global   Install hook script + register in ~/.claude/settings.json\n  --local    Write credentials + enable flag to .claude/settings.local.json\n\nDefault behavior installs the global hook and writes local project config.",
-      "examples": [
-        "respan integrate claude-code",
-        "respan integrate claude-code --disable",
-        "respan integrate claude-code --global",
-        "respan integrate claude-code --local --project-id my-project",
-        "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
+      "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": {},
+      "description": "Integrate Respan with Claude Code.\n\nInstalls a Stop hook that reads conversation transcripts and sends\nthem to Respan as structured spans (chat, tool, thinking).\n\nScope:\n  --global   Install hook script + register in ~/.claude/settings.json\n  --local    Write credentials + enable flag to .claude/settings.local.json\n\nDefault behavior installs the global hook and writes local project config.",
+      "examples": [
+        "respan integrate claude-code",
+        "respan integrate claude-code --disable",
+        "respan integrate claude-code --global",
+        "respan integrate claude-code --local --project-id my-project",
+        "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
         "respan integrate claude-code --dry-run"
       ],
       "flags": {
@@ -2475,10 +2919,20 @@
         "opencode.js"
       ]
     },
-    "logs:create": {
+    "integrate:pi": {
       "aliases": [],
       "args": {},
-      "description": "Create a log span",
+      "description": "Integrate Respan with the pi coding agent (https://pi.dev).\n\nInstalls the @respan/instrumentation-pi pi package — a pi extension that\ntraces every agent run as one turn span per prompt with chat and tool spans underneath,\ncorrelating all runs of a pi session by its session id — and writes a\nnon-secret respan.json config for it.\n\nScope:\n  --global   pi install npm:@respan/instrumentation-pi + ~/.pi/agent/respan.json (default)\n  --local    pi install -l npm:@respan/instrumentation-pi + .pi/respan.json in the project root\n\nTrace scope (--trace-scope, \"trace_scope\" in respan.json):\n  session    one multi-root trace per pi session, across processes and pauses (default)\n  run        one trace per agent run; runs of a session share a thread id\n\nDurable delivery (--with-collector):\n  Sets base_url to a local Respan collector (http://127.0.0.1:4318) so traces\n  go through its persistent queue and survive Respan outages. Run\n  \"respan collector start\" once per machine.\n\nCredentials are never written to these files: the extension reads\nRESPAN_API_KEY or ~/.respan/credentials.json (from \"respan auth login\").",
+      "examples": [
+        "respan integrate pi",
+        "respan integrate pi --disable",
+        "respan integrate pi --local",
+        "respan integrate pi --customer-id frank --workflow-name email-agent",
+        "respan integrate pi --trace-scope run",
+        "respan integrate pi --with-collector",
+        "respan integrate pi --project-id my-project --attrs '{\"env\":\"prod\"}'",
+        "respan integrate pi --dry-run"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2489,8 +2943,9 @@
           "type": "option"
         },
         "base-url": {
-          "description": "Temporary API base URL override for this command",
+          "description": "Respan API base URL (for enterprise deployments)",
           "name": "base-url",
+          "default": "https://api.respan.ai/api",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2521,31 +2976,106 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "input": {
-          "description": "Input text or JSON",
-          "name": "input",
-          "required": true,
+        "local": {
+          "description": "Write per-project config (default)",
+          "exclusive": [
+            "global"
+          ],
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "global": {
+          "description": "Write user-level global config",
+          "exclusive": [
+            "local"
+          ],
+          "name": "global",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "enable": {
+          "description": "Enable tracing (default)",
+          "exclusive": [
+            "disable"
+          ],
+          "name": "enable",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "disable": {
+          "description": "Disable tracing",
+          "exclusive": [
+            "enable"
+          ],
+          "name": "disable",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project-id": {
+          "description": "Respan project ID (added to metadata / resource attributes)",
+          "env": "RESPAN_PROJECT_ID",
+          "name": "project-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "output": {
-          "description": "Output text or JSON",
-          "name": "output",
+        "attrs": {
+          "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
+          "name": "attrs",
+          "default": "{}",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "model": {
-          "description": "Model name",
-          "name": "model",
+        "customer-id": {
+          "description": "Customer/user identifier for traces (e.g. your name or email)",
+          "env": "RESPAN_CUSTOMER_ID",
+          "name": "customer-id",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "metadata": {
-          "description": "Metadata as JSON string",
-          "name": "metadata",
+        "span-name": {
+          "description": "Alias of --workflow-name (default: pi)",
+          "name": "span-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workflow-name": {
+          "description": "traceloop.workflow.name on pi turn spans (default: pi)",
+          "name": "workflow-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Preview changes without writing files",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "trace-scope": {
+          "description": "Trace scope: \"session\" = one multi-root trace per pi session (default), \"run\" = one trace per agent run",
+          "name": "trace-scope",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "run",
+            "session"
+          ],
+          "type": "option"
+        },
+        "with-collector": {
+          "description": "Send traces through a local Respan collector (respan collector start) for durable delivery",
+          "name": "with-collector",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "collector-port": {
+          "description": "Port of the local collector, with --with-collector (default: 4318)",
+          "name": "collector-port",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2553,7 +3083,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:create",
+      "id": "integrate:pi",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2563,20 +3093,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
-        "create.js"
+        "integrate",
+        "pi.js"
       ]
     },
-    "logs:get": {
+    "prompts:create-version": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Span ID",
-          "name": "id",
+        "prompt-id": {
+          "description": "Prompt ID",
+          "name": "prompt-id",
           "required": true
         }
       },
-      "description": "Get a specific log span",
+      "description": "Create a new version of a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2618,11 +3148,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": "logs:get",
+      "id": "prompts:create-version",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2632,14 +3191,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
-        "get.js"
+        "prompts",
+        "create-version.js"
       ]
     },
-    "logs:list": {
+    "prompts:create": {
       "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": "Create a new prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2682,67 +3241,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page (max 1000)",
-          "name": "limit",
-          "default": 50,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "page": {
-          "description": "Page number",
-          "name": "page",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "sort-by": {
-          "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
-          "name": "sort-by",
+        "name": {
+          "description": "Prompt name",
+          "name": "name",
+          "required": true,
           "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",
+        "description": {
+          "description": "Prompt description",
+          "name": "description",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2750,7 +3259,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:list",
+      "id": "prompts:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2760,14 +3269,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
-        "list.js"
+        "prompts",
+        "create.js"
       ]
     },
-    "logs:summary": {
+    "prompts:get": {
       "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": "Prompt ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2809,48 +3324,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"
-        },
-        "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "logs:summary",
+      "id": "prompts:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2860,20 +3338,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "logs",
-        "summary.js"
+        "prompts",
+        "get.js"
       ]
     },
-    "prompts:create-version": {
+    "prompts:list": {
       "aliases": [],
-      "args": {
-        "prompt-id": {
-          "description": "Prompt ID",
-          "name": "prompt-id",
-          "required": true
-        }
-      },
-      "description": "Create a new version of a prompt",
+      "args": {},
+      "description": "List prompts",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -2916,31 +3388,10 @@
           "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",
+        "limit": {
+          "description": "Number of results per page",
+          "name": "limit",
+          "default": 50,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2948,7 +3399,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:create-version",
+      "id": "prompts:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -2959,13 +3410,19 @@
         "dist",
         "commands",
         "prompts",
-        "create-version.js"
+        "list.js"
       ]
     },
-    "prompts:create": {
+    "prompts:update": {
       "aliases": [],
-      "args": {},
-      "description": "Create a new prompt",
+      "args": {
+        "id": {
+          "description": "Prompt ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3011,7 +3468,6 @@
         "name": {
           "description": "Prompt name",
           "name": "name",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3026,7 +3482,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:create",
+      "id": "prompts:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3037,19 +3493,19 @@
         "dist",
         "commands",
         "prompts",
-        "create.js"
+        "update.js"
       ]
     },
-    "prompts:get": {
+    "prompts:versions": {
       "aliases": [],
       "args": {
-        "id": {
+        "prompt-id": {
           "description": "Prompt ID",
-          "name": "id",
+          "name": "prompt-id",
           "required": true
         }
       },
-      "description": "Get a specific prompt",
+      "description": "List versions of a prompt",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3095,7 +3551,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:get",
+      "id": "prompts:versions",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3106,13 +3562,17 @@
         "dist",
         "commands",
         "prompts",
-        "get.js"
+        "versions.js"
       ]
     },
-    "prompts:list": {
+    "setup:doctor": {
       "aliases": [],
       "args": {},
-      "description": "List prompts",
+      "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)",
@@ -3155,18 +3615,28 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of results per page",
-          "name": "limit",
-          "default": 50,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "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": "prompts:list",
+      "id": "setup:doctor",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3176,20 +3646,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "list.js"
+        "setup",
+        "doctor.js"
       ]
     },
-    "prompts:update": {
+    "setup:gateway": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Prompt ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a prompt",
+      "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"
+      ],
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3214,13 +3683,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"
@@ -3232,24 +3701,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Prompt name",
-          "name": "name",
+        "agent": {
+          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
+          "name": "agent",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
-          "description": "Prompt description",
-          "name": "description",
-          "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": "prompts:update",
+      "id": "setup:gateway",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3259,20 +3727,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "update.js"
+        "setup",
+        "gateway.js"
       ]
     },
-    "prompts:versions": {
+    "setup": {
       "aliases": [],
-      "args": {
-        "prompt-id": {
-          "description": "Prompt ID",
-          "name": "prompt-id",
-          "required": true
-        }
-      },
-      "description": "List versions of a prompt",
+      "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)",
@@ -3297,13 +3767,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"
@@ -3314,11 +3784,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 agent selection and opening after setup",
+          "name": "no-instrument",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "prompts:versions",
+      "id": "setup",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3328,17 +3811,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "prompts",
-        "versions.js"
+        "setup",
+        "index.js"
       ]
     },
-    "setup:doctor": {
+    "setup:tracing": {
       "aliases": [],
       "args": {},
-      "description": "Diagnose coding-agent setup for Respan",
+      "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 doctor",
-        "respan setup doctor --global"
+        "respan setup tracing",
+        "respan setup tracing --agent claude-code",
+        "respan setup tracing --no-instrument"
       ],
       "flags": {
         "api-key": {
@@ -3364,13 +3848,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"
@@ -3382,28 +3866,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "local": {
-          "description": "Check local project setup",
-          "exclusive": [
-            "global"
-          ],
-          "name": "local",
-          "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"
         },
-        "global": {
-          "description": "Check global setup",
-          "exclusive": [
-            "local"
-          ],
-          "name": "global",
+        "no-instrument": {
+          "description": "Skip agent selection and opening after setup",
+          "name": "no-instrument",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "setup:doctor",
+      "id": "setup:tracing",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3414,18 +3893,19 @@
         "dist",
         "commands",
         "setup",
-        "doctor.js"
+        "tracing.js"
       ]
     },
-    "setup:gateway": {
+    "traces:get": {
       "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": "Trace ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get a specific trace",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3450,13 +3930,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"
@@ -3467,24 +3947,126 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "traces:get",
+      "pluginAlias": "@respan/cli",
+      "pluginName": "@respan/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "traces",
+        "get.js"
+      ]
+    },
+    "traces:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List and filter traces.\n\nA trace represents a complete workflow execution containing multiple spans.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (traces):\n  trace_unique_id, customer_identifier, environment, span_count,\n  llm_call_count, error_count, total_cost, total_tokens,\n  total_prompt_tokens, total_completion_tokens, duration,\n  span_workflow_name, metadata__<key>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
+      "flags": {
+        "api-key": {
+          "description": "API key (env: RESPAN_API_KEY)",
+          "env": "RESPAN_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "agent": {
-          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
-          "name": "agent",
+        "base-url": {
+          "description": "Temporary API base URL override for this command",
+          "name": "base-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-instrument": {
-          "description": "Skip agent selection and opening after setup",
-          "name": "no-instrument",
+        "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",
+          "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",
+          "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": "setup:gateway",
+      "id": "traces:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3494,22 +4076,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "setup",
-        "gateway.js"
+        "traces",
+        "list.js"
       ]
     },
-    "setup": {
+    "traces:summary": {
       "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"
-      ],
+      "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)",
@@ -3534,13 +4108,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"
@@ -3552,23 +4126,26 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "agent": {
-          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
-          "name": "agent",
+        "start-time": {
+          "description": "Start time (ISO 8601)",
+          "name": "start-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-instrument": {
-          "description": "Skip agent selection and opening after setup",
-          "name": "no-instrument",
-          "allowNo": false,
-          "type": "boolean"
+        "end-time": {
+          "description": "End time (ISO 8601)",
+          "name": "end-time",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "setup",
+      "id": "traces:summary",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3578,19 +4155,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "setup",
-        "index.js"
+        "traces",
+        "summary.js"
       ]
     },
-    "setup:tracing": {
+    "users:create": {
       "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"
-      ],
+      "description": "Create a new user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3615,13 +4187,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"
@@ -3633,23 +4205,39 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "agent": {
-          "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
-          "name": "agent",
+        "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"
         },
-        "no-instrument": {
-          "description": "Skip agent selection and opening after setup",
-          "name": "no-instrument",
-          "allowNo": false,
-          "type": "boolean"
+        "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": "setup:tracing",
+      "id": "users:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3659,20 +4247,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "setup",
-        "tracing.js"
+        "users",
+        "create.js"
       ]
     },
-    "traces:get": {
+    "users:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Trace ID",
+          "description": "Customer identifier",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific trace",
+      "description": "Get a specific user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3718,7 +4306,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:get",
+      "id": "users:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3728,14 +4316,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
+        "users",
         "get.js"
       ]
     },
-    "traces:list": {
+    "users:list": {
       "aliases": [],
       "args": {},
-      "description": "List and filter traces.\n\nA trace represents a complete workflow execution containing multiple spans.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (traces):\n  trace_unique_id, customer_identifier, environment, span_count,\n  llm_call_count, error_count, total_cost, total_tokens,\n  total_prompt_tokens, total_completion_tokens, duration,\n  span_workflow_name, metadata__<key>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
+      "description": "List users (customers)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3781,7 +4369,7 @@
         "limit": {
           "description": "Number of results per page",
           "name": "limit",
-          "default": 10,
+          "default": 20,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3795,23 +4383,8 @@
           "type": "option"
         },
         "sort-by": {
-          "description": "Sort field (prefix with - for descending)",
+          "description": "Sort field",
           "name": "sort-by",
-          "default": "-timestamp",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "start-time": {
-          "description": "Start time filter (ISO 8601)",
-          "name": "start-time",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "end-time": {
-          "description": "End time filter (ISO 8601)",
-          "name": "end-time",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3822,18 +4395,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "filter": {
-          "description": "Filter in field:operator:value format (repeatable)",
-          "name": "filter",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:list",
+      "id": "users:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3843,14 +4409,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
+        "users",
         "list.js"
       ]
     },
-    "traces:summary": {
+    "users:update": {
       "aliases": [],
-      "args": {},
-      "description": "Get a span-level summary of activity for a time range (counts, latency, cost, errors aggregated across spans)",
+      "args": {
+        "id": {
+          "description": "Customer identifier",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Update a user (customer)",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3893,18 +4465,23 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "start-time": {
-          "description": "Start time (ISO 8601)",
-          "name": "start-time",
-          "required": true,
+        "name": {
+          "description": "Customer name",
+          "name": "name",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "end-time": {
-          "description": "End time (ISO 8601)",
-          "name": "end-time",
-          "required": true,
+        "email": {
+          "description": "Customer email",
+          "name": "email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "metadata": {
+          "description": "Metadata as JSON string",
+          "name": "metadata",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3912,7 +4489,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "traces:summary",
+      "id": "users:update",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -3922,14 +4499,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "traces",
-        "summary.js"
+        "users",
+        "update.js"
       ]
     },
-    "users:create": {
+    "logs:create": {
       "aliases": [],
       "args": {},
-      "description": "Create a new user (customer)",
+      "description": "Create a log span",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -3972,24 +4549,24 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "identifier": {
-          "description": "Customer identifier",
-          "name": "identifier",
+        "input": {
+          "description": "Input text or JSON",
+          "name": "input",
           "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "description": "Customer name",
-          "name": "name",
+        "output": {
+          "description": "Output text or JSON",
+          "name": "output",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "email": {
-          "description": "Customer email",
-          "name": "email",
+        "model": {
+          "description": "Model name",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4004,7 +4581,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:create",
+      "id": "logs:create",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4014,20 +4591,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
+        "logs",
         "create.js"
       ]
     },
-    "users:get": {
+    "logs:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Customer identifier",
+          "description": "Span ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get a specific user (customer)",
+      "description": "Get a specific log span",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4073,7 +4650,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:get",
+      "id": "logs:get",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4083,14 +4660,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
+        "logs",
         "get.js"
       ]
     },
-    "users:list": {
+    "logs:list": {
       "aliases": [],
       "args": {},
-      "description": "List users (customers)",
+      "description": "List and filter LLM request logs (spans).\n\nSupports pagination, sorting, time range, and server-side filtering.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (logs):\n  model, status_code, status, cost, latency, prompt_tokens,\n  completion_tokens, customer_identifier, custom_identifier,\n  thread_identifier, trace_unique_id, span_name, span_workflow_name,\n  environment, log_type, error_message, failed, provider_id,\n  deployment_name, prompt_name, prompt_id, unique_id, stream,\n  temperature, max_tokens, tokens_per_second, time_to_first_token,\n  total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4134,9 +4711,9 @@
           "type": "boolean"
         },
         "limit": {
-          "description": "Number of results per page",
+          "description": "Number of results per page (max 1000)",
           "name": "limit",
-          "default": 20,
+          "default": 50,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4150,15 +4727,50 @@
           "type": "option"
         },
         "sort-by": {
-          "description": "Sort field",
+          "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
           "name": "sort-by",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment": {
-          "description": "Environment filter",
-          "name": "environment",
+        "start-time": {
+          "description": "Start time filter (ISO 8601)",
+          "name": "start-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "end-time": {
+          "description": "End time filter (ISO 8601)",
+          "name": "end-time",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "description": "Filter in field:operator:value format (repeatable)",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "all-envs": {
+          "description": "Include all environments (true/false)",
+          "name": "all-envs",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "is-test": {
+          "description": "Filter by test (true) or production (false) environment",
+          "name": "is-test",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "include-fields": {
+          "description": "Comma-separated fields to include in response",
+          "name": "include-fields",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4166,7 +4778,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:list",
+      "id": "logs:list",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4176,20 +4788,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
+        "logs",
         "list.js"
       ]
     },
-    "users:update": {
+    "logs:summary": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Customer identifier",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Update a user (customer)",
+      "args": {},
+      "description": "Get aggregated summary statistics for log spans in a time range.\n\nReturns total cost, total tokens, request count, and score summaries.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n  (empty)     Exact match         model::gpt-4\n  not         Not equal           status_code:not:200\n  gt          Greater than        cost:gt:0.01\n  gte         Greater than/equal  latency:gte:1.0\n  lt          Less than           cost:lt:0.5\n  lte         Less than/equal     prompt_tokens:lte:100\n  contains    Contains substring  error_message:contains:timeout\n  icontains   Case-insensitive    model:icontains:gpt\n  startswith  Starts with         model:startswith:gpt\n  endswith    Ends with           model:endswith:mini\n  in          Value in list       model:in:gpt-4,gpt-4o\n  isnull      Is null             error_message:isnull:true\n  iexact      Case-insens. exact  status:iexact:success\n\nFILTERABLE FIELDS (logs):\n  model, status_code, status, cost, latency, prompt_tokens,\n  completion_tokens, customer_identifier, custom_identifier,\n  thread_identifier, trace_unique_id, span_name, span_workflow_name,\n  environment, log_type, error_message, failed, provider_id,\n  deployment_name, prompt_name, prompt_id, unique_id, stream,\n  temperature, max_tokens, tokens_per_second, time_to_first_token,\n  total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n  --filter model::gpt-4o --filter cost:gt:0.01\n  --filter status_code:not:200\n  --filter metadata__env::production\n  --filter model:in:gpt-4,gpt-4o",
       "flags": {
         "api-key": {
           "description": "API key (env: RESPAN_API_KEY)",
@@ -4232,23 +4838,39 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Customer name",
-          "name": "name",
+        "start-time": {
+          "description": "Start time (ISO 8601)",
+          "name": "start-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "email": {
-          "description": "Customer email",
-          "name": "email",
+        "end-time": {
+          "description": "End time (ISO 8601)",
+          "name": "end-time",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "metadata": {
-          "description": "Metadata as JSON string",
-          "name": "metadata",
+        "filter": {
+          "description": "Filter in field:operator:value format (repeatable)",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "all-envs": {
+          "description": "Include all environments (true/false)",
+          "name": "all-envs",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "is-test": {
+          "description": "Filter by test (true) or production (false) environment",
+          "name": "is-test",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -4256,7 +4878,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "users:update",
+      "id": "logs:summary",
       "pluginAlias": "@respan/cli",
       "pluginName": "@respan/cli",
       "pluginType": "core",
@@ -4266,10 +4888,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "users",
-        "update.js"
+        "logs",
+        "summary.js"
       ]
     }
   },
-  "version": "0.13.3"
+  "version": "0.14.1"
 }