{ "commands": { "whoami": { "aliases": [], "args": {}, "description": "Show current user information", "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": "whoami", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "whoami.js" ] }, "auth:login": { "aliases": [], "args": {}, "description": "Log in to Respan", "flags": { "api-key": { "description": "API key to store (skips interactive prompt)", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "base-url": { "description": "API base URL (auto-detected from login method if not set)", "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" }, "profile-name": { "description": "Profile name", "name": "profile-name", "default": "default", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "enterprise": { "description": "Use enterprise SSO login", "name": "enterprise", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "auth:login", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "auth", "login.js" ] }, "auth:logout": { "aliases": [], "args": {}, "description": "Log out and remove stored credentials", "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": "Profile to log out", "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": "auth:logout", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "auth", "logout.js" ] }, "auth:status": { "aliases": [], "args": {}, "description": "Show current authentication status", "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": "auth:status", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "auth", "status.js" ] }, "collector:config": { "aliases": [], "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 .", "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)", "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" }, "export-url": { "description": "Respan ingest URL (default: /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": "collector:config", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "collector", "config.js" ] }, "collector:start": { "aliases": [], "args": {}, "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)", "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" }, "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: /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": "collector:start", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "collector", "start.js" ] }, "collector:status": { "aliases": [], "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)", "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" }, "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": "collector:status", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "collector", "status.js" ] }, "collector:stop": { "aliases": [], "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)", "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" }, "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": "collector:stop", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "collector", "stop.js" ] }, "config:get": { "aliases": [], "args": { "key": { "description": "Config key", "name": "key", "required": true } }, "description": "Get a configuration value", "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": "config:get", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "config", "get.js" ] }, "config:list": { "aliases": [], "args": {}, "description": "List all configuration", "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": "config:list", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "config", "list.js" ] }, "config:set": { "aliases": [], "args": { "key": { "description": "Config key", "name": "key", "required": true }, "value": { "description": "Config value", "name": "value", "required": true } }, "description": "Set a configuration value", "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": "config:set", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "config", "set.js" ] }, "datasets:create-span": { "aliases": [], "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)", "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" }, "body": { "description": "Span body as JSON string", "name": "body", "required": true, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "datasets:create-span", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "datasets", "create-span.js" ] }, "datasets:create": { "aliases": [], "args": {}, "description": "Create a new dataset", "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": "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", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "datasets", "create.js" ] }, "datasets:get-span": { "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", "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": "datasets:get-span", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "datasets", "get-span.js" ] }, "datasets:get": { "aliases": [], "args": { "id": { "description": "Dataset ID", "name": "id", "required": true } }, "description": "Get a specific dataset", "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": "datasets:get", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "datasets", "get.js" ] }, "datasets:list": { "aliases": [], "args": {}, "description": "List datasets", "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": 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": "datasets:list", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "datasets", "list.js" ] }, "datasets:spans": { "aliases": [], "args": { "dataset-id": { "description": "Dataset ID", "name": "dataset-id", "required": true } }, "description": "List spans in a dataset", "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": "datasets:spans", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "datasets", "spans.js" ] }, "datasets:update": { "aliases": [], "args": { "id": { "description": "Dataset ID", "name": "id", "required": true } }, "description": "Update a dataset", "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": "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", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "datasets", "update.js" ] }, "demo:clear": { "aliases": [], "args": {}, "description": "Delete the sample prompts, datasets, and evaluators created by `respan demo`. Demo traces are left in place (each run is timestamped history). Idempotent — safe to re-run.", "examples": [ "<%= config.bin %> demo clear", "<%= config.bin %> demo clear --yes" ], "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "env": "RESPAN_API_KEY", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "base-url": { "description": "Temporary API base URL override for this command", "name": "base-url", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "description": "Named profile to use", "name": "profile", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "json": { "description": "Output as JSON", "name": "json", "allowNo": false, "type": "boolean" }, "csv": { "description": "Output as CSV", "name": "csv", "allowNo": false, "type": "boolean" }, "verbose": { "char": "v", "description": "Show verbose output", "name": "verbose", "allowNo": false, "type": "boolean" }, "yes": { "char": "y", "description": "Skip the confirmation prompt", "name": "yes", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "demo:clear", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "demo", "clear.js" ] }, "demo": { "aliases": [], "args": {}, "description": "Seed your account with sample data (prompts and traces) so you have something to explore. Idempotent — safe to re-run.", "examples": [ "<%= config.bin %> demo" ], "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "env": "RESPAN_API_KEY", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "base-url": { "description": "Temporary API base URL override for this command", "name": "base-url", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "description": "Named profile to use", "name": "profile", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "json": { "description": "Output as JSON", "name": "json", "allowNo": false, "type": "boolean" }, "csv": { "description": "Output as CSV", "name": "csv", "allowNo": false, "type": "boolean" }, "verbose": { "char": "v", "description": "Show verbose output", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "demo", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "demo", "index.js" ] }, "eval": { "aliases": [], "args": { "file": { "description": "Path to eval JSON file", "name": "file", "required": true } }, "description": "Run an eval defined in a JSON file (creates prompt + dataset on the platform)", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "env": "RESPAN_API_KEY", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "base-url": { "description": "Temporary API base URL override for this command", "name": "base-url", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "description": "Named profile to use", "name": "profile", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "json": { "description": "Output as JSON", "name": "json", "allowNo": false, "type": "boolean" }, "csv": { "description": "Output as CSV", "name": "csv", "allowNo": false, "type": "boolean" }, "verbose": { "char": "v", "description": "Show verbose output", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "eval", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "eval", "index.js" ] }, "evaluators:create": { "aliases": [], "args": {}, "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)", "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" }, "dataset-id": { "description": "Dataset ID to evaluate against", "name": "dataset-id", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "log-ids": { "description": "Comma-separated log/span IDs to evaluate", "name": "log-ids", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "params": { "description": "Additional parameters as JSON string", "name": "params", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "evaluators:run", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "evaluators", "run.js" ] }, "evaluators:update": { "aliases": [], "args": { "id": { "description": "Evaluator ID", "name": "id", "required": true } }, "description": "Update an 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", "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:update", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "evaluators", "update.js" ] }, "experiments:create": { "aliases": [], "args": {}, "description": "Create a new experiment", "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": "Experiment name", "name": "name", "required": true, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "dataset-id": { "description": "Dataset ID", "name": "dataset-id", "required": true, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "description": { "description": "Experiment description", "name": "description", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "workflows": { "description": "Workflows configuration as JSON string", "name": "workflows", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "experiments:create", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "experiments", "create.js" ] }, "experiments:get": { "aliases": [], "args": { "id": { "description": "Experiment ID", "name": "id", "required": true } }, "description": "Get a specific experiment", "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": "experiments:get", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "experiments", "get.js" ] }, "experiments:list": { "aliases": [], "args": {}, "description": "List experiments", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "env": "RESPAN_API_KEY", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "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": "experiments:list", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "experiments", "list.js" ] }, "logs:create": { "aliases": [], "args": {}, "description": "Create a log span", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "env": "RESPAN_API_KEY", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "base-url": { "description": "Temporary API base URL override for this command", "name": "base-url", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "description": "Named profile to use", "name": "profile", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "json": { "description": "Output as JSON", "name": "json", "allowNo": false, "type": "boolean" }, "csv": { "description": "Output as CSV", "name": "csv", "allowNo": false, "type": "boolean" }, "verbose": { "char": "v", "description": "Show verbose output", "name": "verbose", "allowNo": false, "type": "boolean" }, "input": { "description": "Input text or JSON", "name": "input", "required": true, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "output": { "description": "Output text or JSON", "name": "output", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "model": { "description": "Model name", "name": "model", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "metadata": { "description": "Metadata as JSON string", "name": "metadata", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "logs:create", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "logs", "create.js" ] }, "logs:get": { "aliases": [], "args": { "id": { "description": "Span ID", "name": "id", "required": true } }, "description": "Get a specific log span", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "env": "RESPAN_API_KEY", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "base-url": { "description": "Temporary API base URL override for this command", "name": "base-url", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "description": "Named profile to use", "name": "profile", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "json": { "description": "Output as JSON", "name": "json", "allowNo": false, "type": "boolean" }, "csv": { "description": "Output as CSV", "name": "csv", "allowNo": false, "type": "boolean" }, "verbose": { "char": "v", "description": "Show verbose output", "name": "verbose", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "logs:get", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "logs", "get.js" ] }, "logs:list": { "aliases": [], "args": {}, "description": "List and filter LLM request logs (spans).\n\nSupports pagination, sorting, time range, and server-side filtering.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n (empty) Exact match model::gpt-4\n not Not equal status_code:not:200\n gt Greater than cost:gt:0.01\n gte Greater than/equal latency:gte:1.0\n lt Less than cost:lt:0.5\n lte Less than/equal prompt_tokens:lte:100\n contains Contains substring error_message:contains:timeout\n icontains Case-insensitive model:icontains:gpt\n startswith Starts with model:startswith:gpt\n endswith Ends with model:endswith:mini\n in Value in list model:in:gpt-4,gpt-4o\n isnull Is null error_message:isnull:true\n iexact Case-insens. exact status:iexact:success\n\nFILTERABLE FIELDS (logs):\n model, status_code, status, cost, latency, prompt_tokens,\n completion_tokens, customer_identifier, custom_identifier,\n thread_identifier, trace_unique_id, span_name, span_workflow_name,\n environment, log_type, error_message, failed, provider_id,\n deployment_name, prompt_name, prompt_id, unique_id, stream,\n temperature, max_tokens, tokens_per_second, time_to_first_token,\n total_request_tokens, metadata__, scores__\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "env": "RESPAN_API_KEY", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "base-url": { "description": "Temporary API base URL override for this command", "name": "base-url", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "description": "Named profile to use", "name": "profile", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "json": { "description": "Output as JSON", "name": "json", "allowNo": false, "type": "boolean" }, "csv": { "description": "Output as CSV", "name": "csv", "allowNo": false, "type": "boolean" }, "verbose": { "char": "v", "description": "Show verbose output", "name": "verbose", "allowNo": false, "type": "boolean" }, "limit": { "description": "Number of results per page (max 1000)", "name": "limit", "default": 50, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "page": { "description": "Page number", "name": "page", "default": 1, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "sort-by": { "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)", "name": "sort-by", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "start-time": { "description": "Start time filter (ISO 8601)", "name": "start-time", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "end-time": { "description": "End time filter (ISO 8601)", "name": "end-time", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "filter": { "description": "Filter in field:operator:value format (repeatable)", "name": "filter", "hasDynamicHelp": false, "multiple": true, "type": "option" }, "all-envs": { "description": "Include all environments (true/false)", "name": "all-envs", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "is-test": { "description": "Filter by test (true) or production (false) environment", "name": "is-test", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "include-fields": { "description": "Comma-separated fields to include in response", "name": "include-fields", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "logs:list", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "logs", "list.js" ] }, "logs:summary": { "aliases": [], "args": {}, "description": "Get aggregated summary statistics for log spans in a time range.\n\nReturns total cost, total tokens, request count, and score summaries.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n (empty) Exact match model::gpt-4\n not Not equal status_code:not:200\n gt Greater than cost:gt:0.01\n gte Greater than/equal latency:gte:1.0\n lt Less than cost:lt:0.5\n lte Less than/equal prompt_tokens:lte:100\n contains Contains substring error_message:contains:timeout\n icontains Case-insensitive model:icontains:gpt\n startswith Starts with model:startswith:gpt\n endswith Ends with model:endswith:mini\n in Value in list model:in:gpt-4,gpt-4o\n isnull Is null error_message:isnull:true\n iexact Case-insens. exact status:iexact:success\n\nFILTERABLE FIELDS (logs):\n model, status_code, status, cost, latency, prompt_tokens,\n completion_tokens, customer_identifier, custom_identifier,\n thread_identifier, trace_unique_id, span_name, span_workflow_name,\n environment, log_type, error_message, failed, provider_id,\n deployment_name, prompt_name, prompt_id, unique_id, stream,\n temperature, max_tokens, tokens_per_second, time_to_first_token,\n total_request_tokens, metadata__, scores__\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "env": "RESPAN_API_KEY", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "base-url": { "description": "Temporary API base URL override for this command", "name": "base-url", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "description": "Named profile to use", "name": "profile", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "json": { "description": "Output as JSON", "name": "json", "allowNo": false, "type": "boolean" }, "csv": { "description": "Output as CSV", "name": "csv", "allowNo": false, "type": "boolean" }, "verbose": { "char": "v", "description": "Show verbose output", "name": "verbose", "allowNo": false, "type": "boolean" }, "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", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "logs", "summary.js" ] }, "prompts:create-version": { "aliases": [], "args": { "prompt-id": { "description": "Prompt ID", "name": "prompt-id", "required": true } }, "description": "Create a new version of a prompt", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "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" }, "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": "prompts:create-version", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "prompts", "create-version.js" ] }, "prompts:create": { "aliases": [], "args": {}, "description": "Create a new prompt", "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": "Prompt name", "name": "name", "required": true, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "description": { "description": "Prompt description", "name": "description", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "prompts:create", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "prompts", "create.js" ] }, "prompts:get": { "aliases": [], "args": { "id": { "description": "Prompt ID", "name": "id", "required": true } }, "description": "Get a specific prompt", "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": "prompts:get", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "prompts", "get.js" ] }, "prompts:list": { "aliases": [], "args": {}, "description": "List prompts", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "env": "RESPAN_API_KEY", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "base-url": { "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": 50, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "prompts:list", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "prompts", "list.js" ] }, "prompts:update": { "aliases": [], "args": { "id": { "description": "Prompt ID", "name": "id", "required": true } }, "description": "Update a prompt", "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": "Prompt name", "name": "name", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "description": { "description": "Prompt description", "name": "description", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "prompts:update", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "prompts", "update.js" ] }, "prompts:versions": { "aliases": [], "args": { "prompt-id": { "description": "Prompt ID", "name": "prompt-id", "required": true } }, "description": "List versions of a prompt", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "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": "prompts:versions", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "prompts", "versions.js" ] }, "setup:doctor": { "aliases": [], "args": {}, "description": "Diagnose coding-agent setup for Respan", "examples": [ "respan setup doctor", "respan setup doctor --global" ], "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "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" }, "local": { "description": "Check local project setup", "exclusive": [ "global" ], "name": "local", "allowNo": false, "type": "boolean" }, "global": { "description": "Check global setup", "exclusive": [ "local" ], "name": "global", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "setup:doctor", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "setup", "doctor.js" ] }, "setup:gateway": { "aliases": [], "args": {}, "description": "Deprecated gateway setup entry point. Prints the official gateway setup prompt.", "examples": [ "respan setup gateway", "respan setup gateway --agent claude-code", "respan setup gateway --no-instrument" ], "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "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" }, "agent": { "description": "Deprecated compatibility flag; no agent is launched", "name": "agent", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "no-instrument": { "description": "Deprecated compatibility flag; setup only prints a prompt", "name": "no-instrument", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "setup:gateway", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "setup", "gateway.js" ] }, "setup": { "aliases": [], "args": {}, "description": "Deprecated setup entry point. Prints tracing and gateway setup prompts.", "examples": [ "npx @respan/cli setup", "respan setup", "respan setup tracing", "respan setup gateway", "respan setup --agent claude-code", "respan setup --no-instrument" ], "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "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" }, "agent": { "description": "Deprecated compatibility flag; no agent is launched", "name": "agent", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "no-instrument": { "description": "Deprecated compatibility flag; setup only prints a prompt", "name": "no-instrument", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "setup", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "setup", "index.js" ] }, "setup:tracing": { "aliases": [], "args": {}, "description": "Deprecated tracing setup entry point. Prints the official tracing setup prompt.", "examples": [ "respan setup tracing", "respan setup tracing --agent claude-code", "respan setup tracing --no-instrument" ], "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "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" }, "agent": { "description": "Deprecated compatibility flag; no agent is launched", "name": "agent", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "no-instrument": { "description": "Deprecated compatibility flag; setup only prints a prompt", "name": "no-instrument", "allowNo": false, "type": "boolean" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "setup:tracing", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "isESM": true, "relativePath": [ "dist", "commands", "setup", "tracing.js" ] }, "tools:call": { "aliases": [], "args": { "name": { "description": "MCP tool name, e.g. log_list or trace_get", "name": "name", "required": true } }, "description": "Call a Respan MCP tool with its exact tool name and JSON arguments. Writes execute immediately; inspect tools list --json before calling.", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "env": "RESPAN_API_KEY", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "base-url": { "description": "Temporary API base URL override for this command", "name": "base-url", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "description": "Named profile to use", "name": "profile", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "json": { "description": "Output as JSON", "name": "json", "allowNo": false, "type": "boolean" }, "csv": { "description": "Output as CSV", "name": "csv", "allowNo": false, "type": "boolean" }, "verbose": { "char": "v", "description": "Show verbose output", "name": "verbose", "allowNo": false, "type": "boolean" }, "input": { "description": "JSON object of MCP tool arguments", "exclusive": [ "input-file" ], "name": "input", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "input-file": { "description": "File containing a JSON object of MCP tool arguments", "exclusive": [ "input" ], "name": "input-file", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "mcp-url": { "description": "Custom MCP server URL (defaults to the active Platform or Enterprise server)", "name": "mcp-url", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "tools:call", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "tools", "call.js" ] }, "tools:list": { "aliases": [], "args": {}, "description": "List the current Respan MCP tools, their input schemas, and annotations.", "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" }, "category": { "description": "Filter by a category returned by the MCP server", "name": "category", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "categories": { "description": "List available categories and tool counts instead of tools", "name": "categories", "allowNo": false, "type": "boolean" }, "mcp-url": { "description": "Custom MCP server URL (defaults to the active Platform or Enterprise server)", "name": "mcp-url", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "tools:list", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "tools", "list.js" ] }, "traces:get": { "aliases": [], "args": { "id": { "description": "Trace ID", "name": "id", "required": true } }, "description": "Get a specific trace", "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": "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__\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "env": "RESPAN_API_KEY", "name": "api-key", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "base-url": { "description": "Temporary API base URL override for this command", "name": "base-url", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "profile": { "description": "Named profile to use", "name": "profile", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "json": { "description": "Output as JSON", "name": "json", "allowNo": false, "type": "boolean" }, "csv": { "description": "Output as CSV", "name": "csv", "allowNo": false, "type": "boolean" }, "verbose": { "char": "v", "description": "Show verbose output", "name": "verbose", "allowNo": false, "type": "boolean" }, "limit": { "description": "Number of results per page", "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": "traces:list", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "traces", "list.js" ] }, "traces:summary": { "aliases": [], "args": {}, "description": "Get a span-level summary of activity for a time range (counts, latency, cost, errors aggregated across spans)", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "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" }, "start-time": { "description": "Start time (ISO 8601)", "name": "start-time", "required": true, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "end-time": { "description": "End time (ISO 8601)", "name": "end-time", "required": true, "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "traces:summary", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "traces", "summary.js" ] }, "users:create": { "aliases": [], "args": {}, "description": "Create a new user (customer)", "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" }, "identifier": { "description": "Customer identifier", "name": "identifier", "required": true, "hasDynamicHelp": false, "multiple": false, "type": "option" }, "name": { "description": "Customer name", "name": "name", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "email": { "description": "Customer email", "name": "email", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "metadata": { "description": "Metadata as JSON string", "name": "metadata", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "users:create", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "users", "create.js" ] }, "users:get": { "aliases": [], "args": { "id": { "description": "Customer identifier", "name": "id", "required": true } }, "description": "Get a specific user (customer)", "flags": { "api-key": { "description": "API key (env: RESPAN_API_KEY)", "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": "users:get", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "users", "get.js" ] }, "users:list": { "aliases": [], "args": {}, "description": "List users (customers)", "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" }, "sort-by": { "description": "Sort field", "name": "sort-by", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "environment": { "description": "Environment filter", "name": "environment", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "users:list", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "users", "list.js" ] }, "users:update": { "aliases": [], "args": { "id": { "description": "Customer identifier", "name": "id", "required": true } }, "description": "Update a user (customer)", "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": "Customer name", "name": "name", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "email": { "description": "Customer email", "name": "email", "hasDynamicHelp": false, "multiple": false, "type": "option" }, "metadata": { "description": "Metadata as JSON string", "name": "metadata", "hasDynamicHelp": false, "multiple": false, "type": "option" } }, "hasDynamicHelp": false, "hiddenAliases": [], "id": "users:update", "pluginAlias": "@respan/cli", "pluginName": "@respan/cli", "pluginType": "core", "strict": true, "enableJsonFlag": false, "isESM": true, "relativePath": [ "dist", "commands", "users", "update.js" ] } }, "version": "0.17.0" }