@respan/cli 0.12.0 → 0.13.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 (6) hide show
  1. package/dist/lib/setup-base-command.d.ts +41 -8
  2. package/dist/lib/setup-base-command.js +140 -31
  3. package/dist/lib/skill-refs.generated.d.ts +1 -1
  4. package/dist/lib/skill-refs.generated.js +65 -14
  5. package/oclif.manifest.json +625 -625
  6. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -1628,6 +1628,247 @@
1628
1628
  "update.js"
1629
1629
  ]
1630
1630
  },
1631
+ "experiments:create": {
1632
+ "aliases": [],
1633
+ "args": {},
1634
+ "description": "Create a new experiment",
1635
+ "flags": {
1636
+ "api-key": {
1637
+ "description": "API key (env: RESPAN_API_KEY)",
1638
+ "env": "RESPAN_API_KEY",
1639
+ "name": "api-key",
1640
+ "hasDynamicHelp": false,
1641
+ "multiple": false,
1642
+ "type": "option"
1643
+ },
1644
+ "base-url": {
1645
+ "description": "Temporary API base URL override for this command",
1646
+ "name": "base-url",
1647
+ "hasDynamicHelp": false,
1648
+ "multiple": false,
1649
+ "type": "option"
1650
+ },
1651
+ "profile": {
1652
+ "description": "Named profile to use",
1653
+ "name": "profile",
1654
+ "hasDynamicHelp": false,
1655
+ "multiple": false,
1656
+ "type": "option"
1657
+ },
1658
+ "json": {
1659
+ "description": "Output as JSON",
1660
+ "name": "json",
1661
+ "allowNo": false,
1662
+ "type": "boolean"
1663
+ },
1664
+ "csv": {
1665
+ "description": "Output as CSV",
1666
+ "name": "csv",
1667
+ "allowNo": false,
1668
+ "type": "boolean"
1669
+ },
1670
+ "verbose": {
1671
+ "char": "v",
1672
+ "description": "Show verbose output",
1673
+ "name": "verbose",
1674
+ "allowNo": false,
1675
+ "type": "boolean"
1676
+ },
1677
+ "name": {
1678
+ "description": "Experiment name",
1679
+ "name": "name",
1680
+ "required": true,
1681
+ "hasDynamicHelp": false,
1682
+ "multiple": false,
1683
+ "type": "option"
1684
+ },
1685
+ "dataset-id": {
1686
+ "description": "Dataset ID",
1687
+ "name": "dataset-id",
1688
+ "required": true,
1689
+ "hasDynamicHelp": false,
1690
+ "multiple": false,
1691
+ "type": "option"
1692
+ },
1693
+ "description": {
1694
+ "description": "Experiment description",
1695
+ "name": "description",
1696
+ "hasDynamicHelp": false,
1697
+ "multiple": false,
1698
+ "type": "option"
1699
+ },
1700
+ "workflows": {
1701
+ "description": "Workflows configuration as JSON string",
1702
+ "name": "workflows",
1703
+ "hasDynamicHelp": false,
1704
+ "multiple": false,
1705
+ "type": "option"
1706
+ }
1707
+ },
1708
+ "hasDynamicHelp": false,
1709
+ "hiddenAliases": [],
1710
+ "id": "experiments:create",
1711
+ "pluginAlias": "@respan/cli",
1712
+ "pluginName": "@respan/cli",
1713
+ "pluginType": "core",
1714
+ "strict": true,
1715
+ "enableJsonFlag": false,
1716
+ "isESM": true,
1717
+ "relativePath": [
1718
+ "dist",
1719
+ "commands",
1720
+ "experiments",
1721
+ "create.js"
1722
+ ]
1723
+ },
1724
+ "experiments:get": {
1725
+ "aliases": [],
1726
+ "args": {
1727
+ "id": {
1728
+ "description": "Experiment ID",
1729
+ "name": "id",
1730
+ "required": true
1731
+ }
1732
+ },
1733
+ "description": "Get a specific experiment",
1734
+ "flags": {
1735
+ "api-key": {
1736
+ "description": "API key (env: RESPAN_API_KEY)",
1737
+ "env": "RESPAN_API_KEY",
1738
+ "name": "api-key",
1739
+ "hasDynamicHelp": false,
1740
+ "multiple": false,
1741
+ "type": "option"
1742
+ },
1743
+ "base-url": {
1744
+ "description": "Temporary API base URL override for this command",
1745
+ "name": "base-url",
1746
+ "hasDynamicHelp": false,
1747
+ "multiple": false,
1748
+ "type": "option"
1749
+ },
1750
+ "profile": {
1751
+ "description": "Named profile to use",
1752
+ "name": "profile",
1753
+ "hasDynamicHelp": false,
1754
+ "multiple": false,
1755
+ "type": "option"
1756
+ },
1757
+ "json": {
1758
+ "description": "Output as JSON",
1759
+ "name": "json",
1760
+ "allowNo": false,
1761
+ "type": "boolean"
1762
+ },
1763
+ "csv": {
1764
+ "description": "Output as CSV",
1765
+ "name": "csv",
1766
+ "allowNo": false,
1767
+ "type": "boolean"
1768
+ },
1769
+ "verbose": {
1770
+ "char": "v",
1771
+ "description": "Show verbose output",
1772
+ "name": "verbose",
1773
+ "allowNo": false,
1774
+ "type": "boolean"
1775
+ }
1776
+ },
1777
+ "hasDynamicHelp": false,
1778
+ "hiddenAliases": [],
1779
+ "id": "experiments:get",
1780
+ "pluginAlias": "@respan/cli",
1781
+ "pluginName": "@respan/cli",
1782
+ "pluginType": "core",
1783
+ "strict": true,
1784
+ "enableJsonFlag": false,
1785
+ "isESM": true,
1786
+ "relativePath": [
1787
+ "dist",
1788
+ "commands",
1789
+ "experiments",
1790
+ "get.js"
1791
+ ]
1792
+ },
1793
+ "experiments:list": {
1794
+ "aliases": [],
1795
+ "args": {},
1796
+ "description": "List experiments",
1797
+ "flags": {
1798
+ "api-key": {
1799
+ "description": "API key (env: RESPAN_API_KEY)",
1800
+ "env": "RESPAN_API_KEY",
1801
+ "name": "api-key",
1802
+ "hasDynamicHelp": false,
1803
+ "multiple": false,
1804
+ "type": "option"
1805
+ },
1806
+ "base-url": {
1807
+ "description": "Temporary API base URL override for this command",
1808
+ "name": "base-url",
1809
+ "hasDynamicHelp": false,
1810
+ "multiple": false,
1811
+ "type": "option"
1812
+ },
1813
+ "profile": {
1814
+ "description": "Named profile to use",
1815
+ "name": "profile",
1816
+ "hasDynamicHelp": false,
1817
+ "multiple": false,
1818
+ "type": "option"
1819
+ },
1820
+ "json": {
1821
+ "description": "Output as JSON",
1822
+ "name": "json",
1823
+ "allowNo": false,
1824
+ "type": "boolean"
1825
+ },
1826
+ "csv": {
1827
+ "description": "Output as CSV",
1828
+ "name": "csv",
1829
+ "allowNo": false,
1830
+ "type": "boolean"
1831
+ },
1832
+ "verbose": {
1833
+ "char": "v",
1834
+ "description": "Show verbose output",
1835
+ "name": "verbose",
1836
+ "allowNo": false,
1837
+ "type": "boolean"
1838
+ },
1839
+ "limit": {
1840
+ "description": "Number of results per page",
1841
+ "name": "limit",
1842
+ "default": 20,
1843
+ "hasDynamicHelp": false,
1844
+ "multiple": false,
1845
+ "type": "option"
1846
+ },
1847
+ "page": {
1848
+ "description": "Page number",
1849
+ "name": "page",
1850
+ "default": 1,
1851
+ "hasDynamicHelp": false,
1852
+ "multiple": false,
1853
+ "type": "option"
1854
+ }
1855
+ },
1856
+ "hasDynamicHelp": false,
1857
+ "hiddenAliases": [],
1858
+ "id": "experiments:list",
1859
+ "pluginAlias": "@respan/cli",
1860
+ "pluginName": "@respan/cli",
1861
+ "pluginType": "core",
1862
+ "strict": true,
1863
+ "enableJsonFlag": false,
1864
+ "isESM": true,
1865
+ "relativePath": [
1866
+ "dist",
1867
+ "commands",
1868
+ "experiments",
1869
+ "list.js"
1870
+ ]
1871
+ },
1631
1872
  "integrate:claude-code": {
1632
1873
  "aliases": [],
1633
1874
  "args": {},
@@ -2234,10 +2475,10 @@
2234
2475
  "opencode.js"
2235
2476
  ]
2236
2477
  },
2237
- "experiments:create": {
2478
+ "logs:create": {
2238
2479
  "aliases": [],
2239
2480
  "args": {},
2240
- "description": "Create a new experiment",
2481
+ "description": "Create a log span",
2241
2482
  "flags": {
2242
2483
  "api-key": {
2243
2484
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2280,250 +2521,9 @@
2280
2521
  "allowNo": false,
2281
2522
  "type": "boolean"
2282
2523
  },
2283
- "name": {
2284
- "description": "Experiment name",
2285
- "name": "name",
2286
- "required": true,
2287
- "hasDynamicHelp": false,
2288
- "multiple": false,
2289
- "type": "option"
2290
- },
2291
- "dataset-id": {
2292
- "description": "Dataset ID",
2293
- "name": "dataset-id",
2294
- "required": true,
2295
- "hasDynamicHelp": false,
2296
- "multiple": false,
2297
- "type": "option"
2298
- },
2299
- "description": {
2300
- "description": "Experiment description",
2301
- "name": "description",
2302
- "hasDynamicHelp": false,
2303
- "multiple": false,
2304
- "type": "option"
2305
- },
2306
- "workflows": {
2307
- "description": "Workflows configuration as JSON string",
2308
- "name": "workflows",
2309
- "hasDynamicHelp": false,
2310
- "multiple": false,
2311
- "type": "option"
2312
- }
2313
- },
2314
- "hasDynamicHelp": false,
2315
- "hiddenAliases": [],
2316
- "id": "experiments:create",
2317
- "pluginAlias": "@respan/cli",
2318
- "pluginName": "@respan/cli",
2319
- "pluginType": "core",
2320
- "strict": true,
2321
- "enableJsonFlag": false,
2322
- "isESM": true,
2323
- "relativePath": [
2324
- "dist",
2325
- "commands",
2326
- "experiments",
2327
- "create.js"
2328
- ]
2329
- },
2330
- "experiments:get": {
2331
- "aliases": [],
2332
- "args": {
2333
- "id": {
2334
- "description": "Experiment ID",
2335
- "name": "id",
2336
- "required": true
2337
- }
2338
- },
2339
- "description": "Get a specific experiment",
2340
- "flags": {
2341
- "api-key": {
2342
- "description": "API key (env: RESPAN_API_KEY)",
2343
- "env": "RESPAN_API_KEY",
2344
- "name": "api-key",
2345
- "hasDynamicHelp": false,
2346
- "multiple": false,
2347
- "type": "option"
2348
- },
2349
- "base-url": {
2350
- "description": "Temporary API base URL override for this command",
2351
- "name": "base-url",
2352
- "hasDynamicHelp": false,
2353
- "multiple": false,
2354
- "type": "option"
2355
- },
2356
- "profile": {
2357
- "description": "Named profile to use",
2358
- "name": "profile",
2359
- "hasDynamicHelp": false,
2360
- "multiple": false,
2361
- "type": "option"
2362
- },
2363
- "json": {
2364
- "description": "Output as JSON",
2365
- "name": "json",
2366
- "allowNo": false,
2367
- "type": "boolean"
2368
- },
2369
- "csv": {
2370
- "description": "Output as CSV",
2371
- "name": "csv",
2372
- "allowNo": false,
2373
- "type": "boolean"
2374
- },
2375
- "verbose": {
2376
- "char": "v",
2377
- "description": "Show verbose output",
2378
- "name": "verbose",
2379
- "allowNo": false,
2380
- "type": "boolean"
2381
- }
2382
- },
2383
- "hasDynamicHelp": false,
2384
- "hiddenAliases": [],
2385
- "id": "experiments:get",
2386
- "pluginAlias": "@respan/cli",
2387
- "pluginName": "@respan/cli",
2388
- "pluginType": "core",
2389
- "strict": true,
2390
- "enableJsonFlag": false,
2391
- "isESM": true,
2392
- "relativePath": [
2393
- "dist",
2394
- "commands",
2395
- "experiments",
2396
- "get.js"
2397
- ]
2398
- },
2399
- "experiments:list": {
2400
- "aliases": [],
2401
- "args": {},
2402
- "description": "List experiments",
2403
- "flags": {
2404
- "api-key": {
2405
- "description": "API key (env: RESPAN_API_KEY)",
2406
- "env": "RESPAN_API_KEY",
2407
- "name": "api-key",
2408
- "hasDynamicHelp": false,
2409
- "multiple": false,
2410
- "type": "option"
2411
- },
2412
- "base-url": {
2413
- "description": "Temporary API base URL override for this command",
2414
- "name": "base-url",
2415
- "hasDynamicHelp": false,
2416
- "multiple": false,
2417
- "type": "option"
2418
- },
2419
- "profile": {
2420
- "description": "Named profile to use",
2421
- "name": "profile",
2422
- "hasDynamicHelp": false,
2423
- "multiple": false,
2424
- "type": "option"
2425
- },
2426
- "json": {
2427
- "description": "Output as JSON",
2428
- "name": "json",
2429
- "allowNo": false,
2430
- "type": "boolean"
2431
- },
2432
- "csv": {
2433
- "description": "Output as CSV",
2434
- "name": "csv",
2435
- "allowNo": false,
2436
- "type": "boolean"
2437
- },
2438
- "verbose": {
2439
- "char": "v",
2440
- "description": "Show verbose output",
2441
- "name": "verbose",
2442
- "allowNo": false,
2443
- "type": "boolean"
2444
- },
2445
- "limit": {
2446
- "description": "Number of results per page",
2447
- "name": "limit",
2448
- "default": 20,
2449
- "hasDynamicHelp": false,
2450
- "multiple": false,
2451
- "type": "option"
2452
- },
2453
- "page": {
2454
- "description": "Page number",
2455
- "name": "page",
2456
- "default": 1,
2457
- "hasDynamicHelp": false,
2458
- "multiple": false,
2459
- "type": "option"
2460
- }
2461
- },
2462
- "hasDynamicHelp": false,
2463
- "hiddenAliases": [],
2464
- "id": "experiments:list",
2465
- "pluginAlias": "@respan/cli",
2466
- "pluginName": "@respan/cli",
2467
- "pluginType": "core",
2468
- "strict": true,
2469
- "enableJsonFlag": false,
2470
- "isESM": true,
2471
- "relativePath": [
2472
- "dist",
2473
- "commands",
2474
- "experiments",
2475
- "list.js"
2476
- ]
2477
- },
2478
- "logs:create": {
2479
- "aliases": [],
2480
- "args": {},
2481
- "description": "Create a log span",
2482
- "flags": {
2483
- "api-key": {
2484
- "description": "API key (env: RESPAN_API_KEY)",
2485
- "env": "RESPAN_API_KEY",
2486
- "name": "api-key",
2487
- "hasDynamicHelp": false,
2488
- "multiple": false,
2489
- "type": "option"
2490
- },
2491
- "base-url": {
2492
- "description": "Temporary API base URL override for this command",
2493
- "name": "base-url",
2494
- "hasDynamicHelp": false,
2495
- "multiple": false,
2496
- "type": "option"
2497
- },
2498
- "profile": {
2499
- "description": "Named profile to use",
2500
- "name": "profile",
2501
- "hasDynamicHelp": false,
2502
- "multiple": false,
2503
- "type": "option"
2504
- },
2505
- "json": {
2506
- "description": "Output as JSON",
2507
- "name": "json",
2508
- "allowNo": false,
2509
- "type": "boolean"
2510
- },
2511
- "csv": {
2512
- "description": "Output as CSV",
2513
- "name": "csv",
2514
- "allowNo": false,
2515
- "type": "boolean"
2516
- },
2517
- "verbose": {
2518
- "char": "v",
2519
- "description": "Show verbose output",
2520
- "name": "verbose",
2521
- "allowNo": false,
2522
- "type": "boolean"
2523
- },
2524
- "input": {
2525
- "description": "Input text or JSON",
2526
- "name": "input",
2524
+ "input": {
2525
+ "description": "Input text or JSON",
2526
+ "name": "input",
2527
2527
  "required": true,
2528
2528
  "hasDynamicHelp": false,
2529
2529
  "multiple": false,
@@ -2864,16 +2864,16 @@
2864
2864
  "summary.js"
2865
2865
  ]
2866
2866
  },
2867
- "traces:get": {
2867
+ "prompts:create-version": {
2868
2868
  "aliases": [],
2869
2869
  "args": {
2870
- "id": {
2871
- "description": "Trace ID",
2872
- "name": "id",
2870
+ "prompt-id": {
2871
+ "description": "Prompt ID",
2872
+ "name": "prompt-id",
2873
2873
  "required": true
2874
2874
  }
2875
2875
  },
2876
- "description": "Get a specific trace",
2876
+ "description": "Create a new version of a prompt",
2877
2877
  "flags": {
2878
2878
  "api-key": {
2879
2879
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2915,28 +2915,57 @@
2915
2915
  "name": "verbose",
2916
2916
  "allowNo": false,
2917
2917
  "type": "boolean"
2918
- }
2919
- },
2920
- "hasDynamicHelp": false,
2921
- "hiddenAliases": [],
2922
- "id": "traces:get",
2923
- "pluginAlias": "@respan/cli",
2924
- "pluginName": "@respan/cli",
2925
- "pluginType": "core",
2926
- "strict": true,
2927
- "enableJsonFlag": false,
2918
+ },
2919
+ "messages": {
2920
+ "description": "Messages as JSON array string",
2921
+ "name": "messages",
2922
+ "required": true,
2923
+ "hasDynamicHelp": false,
2924
+ "multiple": false,
2925
+ "type": "option"
2926
+ },
2927
+ "model": {
2928
+ "description": "Model name",
2929
+ "name": "model",
2930
+ "hasDynamicHelp": false,
2931
+ "multiple": false,
2932
+ "type": "option"
2933
+ },
2934
+ "temperature": {
2935
+ "description": "Temperature value",
2936
+ "name": "temperature",
2937
+ "hasDynamicHelp": false,
2938
+ "multiple": false,
2939
+ "type": "option"
2940
+ },
2941
+ "max-tokens": {
2942
+ "description": "Max tokens",
2943
+ "name": "max-tokens",
2944
+ "hasDynamicHelp": false,
2945
+ "multiple": false,
2946
+ "type": "option"
2947
+ }
2948
+ },
2949
+ "hasDynamicHelp": false,
2950
+ "hiddenAliases": [],
2951
+ "id": "prompts:create-version",
2952
+ "pluginAlias": "@respan/cli",
2953
+ "pluginName": "@respan/cli",
2954
+ "pluginType": "core",
2955
+ "strict": true,
2956
+ "enableJsonFlag": false,
2928
2957
  "isESM": true,
2929
2958
  "relativePath": [
2930
2959
  "dist",
2931
2960
  "commands",
2932
- "traces",
2933
- "get.js"
2961
+ "prompts",
2962
+ "create-version.js"
2934
2963
  ]
2935
2964
  },
2936
- "traces:list": {
2965
+ "prompts:create": {
2937
2966
  "aliases": [],
2938
2967
  "args": {},
2939
- "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",
2968
+ "description": "Create a new prompt",
2940
2969
  "flags": {
2941
2970
  "api-key": {
2942
2971
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2979,62 +3008,25 @@
2979
3008
  "allowNo": false,
2980
3009
  "type": "boolean"
2981
3010
  },
2982
- "limit": {
2983
- "description": "Number of results per page",
2984
- "name": "limit",
2985
- "default": 10,
2986
- "hasDynamicHelp": false,
2987
- "multiple": false,
2988
- "type": "option"
2989
- },
2990
- "page": {
2991
- "description": "Page number",
2992
- "name": "page",
2993
- "default": 1,
2994
- "hasDynamicHelp": false,
2995
- "multiple": false,
2996
- "type": "option"
2997
- },
2998
- "sort-by": {
2999
- "description": "Sort field (prefix with - for descending)",
3000
- "name": "sort-by",
3001
- "default": "-timestamp",
3002
- "hasDynamicHelp": false,
3003
- "multiple": false,
3004
- "type": "option"
3005
- },
3006
- "start-time": {
3007
- "description": "Start time filter (ISO 8601)",
3008
- "name": "start-time",
3009
- "hasDynamicHelp": false,
3010
- "multiple": false,
3011
- "type": "option"
3012
- },
3013
- "end-time": {
3014
- "description": "End time filter (ISO 8601)",
3015
- "name": "end-time",
3011
+ "name": {
3012
+ "description": "Prompt name",
3013
+ "name": "name",
3014
+ "required": true,
3016
3015
  "hasDynamicHelp": false,
3017
3016
  "multiple": false,
3018
3017
  "type": "option"
3019
3018
  },
3020
- "environment": {
3021
- "description": "Environment filter",
3022
- "name": "environment",
3019
+ "description": {
3020
+ "description": "Prompt description",
3021
+ "name": "description",
3023
3022
  "hasDynamicHelp": false,
3024
3023
  "multiple": false,
3025
3024
  "type": "option"
3026
- },
3027
- "filter": {
3028
- "description": "Filter in field:operator:value format (repeatable)",
3029
- "name": "filter",
3030
- "hasDynamicHelp": false,
3031
- "multiple": true,
3032
- "type": "option"
3033
3025
  }
3034
3026
  },
3035
3027
  "hasDynamicHelp": false,
3036
3028
  "hiddenAliases": [],
3037
- "id": "traces:list",
3029
+ "id": "prompts:create",
3038
3030
  "pluginAlias": "@respan/cli",
3039
3031
  "pluginName": "@respan/cli",
3040
3032
  "pluginType": "core",
@@ -3044,14 +3036,20 @@
3044
3036
  "relativePath": [
3045
3037
  "dist",
3046
3038
  "commands",
3047
- "traces",
3048
- "list.js"
3039
+ "prompts",
3040
+ "create.js"
3049
3041
  ]
3050
3042
  },
3051
- "traces:summary": {
3043
+ "prompts:get": {
3052
3044
  "aliases": [],
3053
- "args": {},
3054
- "description": "Get a span-level summary of activity for a time range (counts, latency, cost, errors aggregated across spans)",
3045
+ "args": {
3046
+ "id": {
3047
+ "description": "Prompt ID",
3048
+ "name": "id",
3049
+ "required": true
3050
+ }
3051
+ },
3052
+ "description": "Get a specific prompt",
3055
3053
  "flags": {
3056
3054
  "api-key": {
3057
3055
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3093,27 +3091,11 @@
3093
3091
  "name": "verbose",
3094
3092
  "allowNo": false,
3095
3093
  "type": "boolean"
3096
- },
3097
- "start-time": {
3098
- "description": "Start time (ISO 8601)",
3099
- "name": "start-time",
3100
- "required": true,
3101
- "hasDynamicHelp": false,
3102
- "multiple": false,
3103
- "type": "option"
3104
- },
3105
- "end-time": {
3106
- "description": "End time (ISO 8601)",
3107
- "name": "end-time",
3108
- "required": true,
3109
- "hasDynamicHelp": false,
3110
- "multiple": false,
3111
- "type": "option"
3112
3094
  }
3113
3095
  },
3114
3096
  "hasDynamicHelp": false,
3115
3097
  "hiddenAliases": [],
3116
- "id": "traces:summary",
3098
+ "id": "prompts:get",
3117
3099
  "pluginAlias": "@respan/cli",
3118
3100
  "pluginName": "@respan/cli",
3119
3101
  "pluginType": "core",
@@ -3123,18 +3105,14 @@
3123
3105
  "relativePath": [
3124
3106
  "dist",
3125
3107
  "commands",
3126
- "traces",
3127
- "summary.js"
3108
+ "prompts",
3109
+ "get.js"
3128
3110
  ]
3129
3111
  },
3130
- "setup:doctor": {
3112
+ "prompts:list": {
3131
3113
  "aliases": [],
3132
3114
  "args": {},
3133
- "description": "Diagnose coding-agent setup for Respan",
3134
- "examples": [
3135
- "respan setup doctor",
3136
- "respan setup doctor --global"
3137
- ],
3115
+ "description": "List prompts",
3138
3116
  "flags": {
3139
3117
  "api-key": {
3140
3118
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3177,28 +3155,18 @@
3177
3155
  "allowNo": false,
3178
3156
  "type": "boolean"
3179
3157
  },
3180
- "local": {
3181
- "description": "Check local project setup",
3182
- "exclusive": [
3183
- "global"
3184
- ],
3185
- "name": "local",
3186
- "allowNo": false,
3187
- "type": "boolean"
3188
- },
3189
- "global": {
3190
- "description": "Check global setup",
3191
- "exclusive": [
3192
- "local"
3193
- ],
3194
- "name": "global",
3195
- "allowNo": false,
3196
- "type": "boolean"
3158
+ "limit": {
3159
+ "description": "Number of results per page",
3160
+ "name": "limit",
3161
+ "default": 50,
3162
+ "hasDynamicHelp": false,
3163
+ "multiple": false,
3164
+ "type": "option"
3197
3165
  }
3198
3166
  },
3199
3167
  "hasDynamicHelp": false,
3200
3168
  "hiddenAliases": [],
3201
- "id": "setup:doctor",
3169
+ "id": "prompts:list",
3202
3170
  "pluginAlias": "@respan/cli",
3203
3171
  "pluginName": "@respan/cli",
3204
3172
  "pluginType": "core",
@@ -3208,19 +3176,20 @@
3208
3176
  "relativePath": [
3209
3177
  "dist",
3210
3178
  "commands",
3211
- "setup",
3212
- "doctor.js"
3179
+ "prompts",
3180
+ "list.js"
3213
3181
  ]
3214
3182
  },
3215
- "setup:gateway": {
3183
+ "prompts:update": {
3216
3184
  "aliases": [],
3217
- "args": {},
3218
- "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.",
3219
- "examples": [
3220
- "respan setup gateway",
3221
- "respan setup gateway --agent claude-code",
3222
- "respan setup gateway --no-instrument"
3223
- ],
3185
+ "args": {
3186
+ "id": {
3187
+ "description": "Prompt ID",
3188
+ "name": "id",
3189
+ "required": true
3190
+ }
3191
+ },
3192
+ "description": "Update a prompt",
3224
3193
  "flags": {
3225
3194
  "api-key": {
3226
3195
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3245,13 +3214,13 @@
3245
3214
  "type": "option"
3246
3215
  },
3247
3216
  "json": {
3248
- "hidden": true,
3217
+ "description": "Output as JSON",
3249
3218
  "name": "json",
3250
3219
  "allowNo": false,
3251
3220
  "type": "boolean"
3252
3221
  },
3253
3222
  "csv": {
3254
- "hidden": true,
3223
+ "description": "Output as CSV",
3255
3224
  "name": "csv",
3256
3225
  "allowNo": false,
3257
3226
  "type": "boolean"
@@ -3263,23 +3232,24 @@
3263
3232
  "allowNo": false,
3264
3233
  "type": "boolean"
3265
3234
  },
3266
- "agent": {
3267
- "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
3268
- "name": "agent",
3235
+ "name": {
3236
+ "description": "Prompt name",
3237
+ "name": "name",
3269
3238
  "hasDynamicHelp": false,
3270
3239
  "multiple": false,
3271
3240
  "type": "option"
3272
3241
  },
3273
- "no-instrument": {
3274
- "description": "Skip opening the agent after setup",
3275
- "name": "no-instrument",
3276
- "allowNo": false,
3277
- "type": "boolean"
3242
+ "description": {
3243
+ "description": "Prompt description",
3244
+ "name": "description",
3245
+ "hasDynamicHelp": false,
3246
+ "multiple": false,
3247
+ "type": "option"
3278
3248
  }
3279
3249
  },
3280
3250
  "hasDynamicHelp": false,
3281
3251
  "hiddenAliases": [],
3282
- "id": "setup:gateway",
3252
+ "id": "prompts:update",
3283
3253
  "pluginAlias": "@respan/cli",
3284
3254
  "pluginName": "@respan/cli",
3285
3255
  "pluginType": "core",
@@ -3289,22 +3259,20 @@
3289
3259
  "relativePath": [
3290
3260
  "dist",
3291
3261
  "commands",
3292
- "setup",
3293
- "gateway.js"
3262
+ "prompts",
3263
+ "update.js"
3294
3264
  ]
3295
3265
  },
3296
- "setup": {
3266
+ "prompts:versions": {
3297
3267
  "aliases": [],
3298
- "args": {},
3299
- "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.",
3300
- "examples": [
3301
- "npx @respan/cli setup",
3302
- "respan setup",
3303
- "respan setup tracing",
3304
- "respan setup gateway",
3305
- "respan setup --agent claude-code",
3306
- "respan setup --no-instrument"
3307
- ],
3268
+ "args": {
3269
+ "prompt-id": {
3270
+ "description": "Prompt ID",
3271
+ "name": "prompt-id",
3272
+ "required": true
3273
+ }
3274
+ },
3275
+ "description": "List versions of a prompt",
3308
3276
  "flags": {
3309
3277
  "api-key": {
3310
3278
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3329,13 +3297,13 @@
3329
3297
  "type": "option"
3330
3298
  },
3331
3299
  "json": {
3332
- "hidden": true,
3300
+ "description": "Output as JSON",
3333
3301
  "name": "json",
3334
3302
  "allowNo": false,
3335
3303
  "type": "boolean"
3336
3304
  },
3337
3305
  "csv": {
3338
- "hidden": true,
3306
+ "description": "Output as CSV",
3339
3307
  "name": "csv",
3340
3308
  "allowNo": false,
3341
3309
  "type": "boolean"
@@ -3346,24 +3314,11 @@
3346
3314
  "name": "verbose",
3347
3315
  "allowNo": false,
3348
3316
  "type": "boolean"
3349
- },
3350
- "agent": {
3351
- "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
3352
- "name": "agent",
3353
- "hasDynamicHelp": false,
3354
- "multiple": false,
3355
- "type": "option"
3356
- },
3357
- "no-instrument": {
3358
- "description": "Skip opening the agent after setup",
3359
- "name": "no-instrument",
3360
- "allowNo": false,
3361
- "type": "boolean"
3362
3317
  }
3363
3318
  },
3364
3319
  "hasDynamicHelp": false,
3365
3320
  "hiddenAliases": [],
3366
- "id": "setup",
3321
+ "id": "prompts:versions",
3367
3322
  "pluginAlias": "@respan/cli",
3368
3323
  "pluginName": "@respan/cli",
3369
3324
  "pluginType": "core",
@@ -3373,18 +3328,17 @@
3373
3328
  "relativePath": [
3374
3329
  "dist",
3375
3330
  "commands",
3376
- "setup",
3377
- "index.js"
3331
+ "prompts",
3332
+ "versions.js"
3378
3333
  ]
3379
3334
  },
3380
- "setup:tracing": {
3335
+ "setup:doctor": {
3381
3336
  "aliases": [],
3382
3337
  "args": {},
3383
- "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.",
3338
+ "description": "Diagnose coding-agent setup for Respan",
3384
3339
  "examples": [
3385
- "respan setup tracing",
3386
- "respan setup tracing --agent claude-code",
3387
- "respan setup tracing --no-instrument"
3340
+ "respan setup doctor",
3341
+ "respan setup doctor --global"
3388
3342
  ],
3389
3343
  "flags": {
3390
3344
  "api-key": {
@@ -3410,13 +3364,13 @@
3410
3364
  "type": "option"
3411
3365
  },
3412
3366
  "json": {
3413
- "hidden": true,
3367
+ "description": "Output as JSON",
3414
3368
  "name": "json",
3415
3369
  "allowNo": false,
3416
3370
  "type": "boolean"
3417
3371
  },
3418
3372
  "csv": {
3419
- "hidden": true,
3373
+ "description": "Output as CSV",
3420
3374
  "name": "csv",
3421
3375
  "allowNo": false,
3422
3376
  "type": "boolean"
@@ -3428,23 +3382,28 @@
3428
3382
  "allowNo": false,
3429
3383
  "type": "boolean"
3430
3384
  },
3431
- "agent": {
3432
- "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
3433
- "name": "agent",
3434
- "hasDynamicHelp": false,
3435
- "multiple": false,
3436
- "type": "option"
3385
+ "local": {
3386
+ "description": "Check local project setup",
3387
+ "exclusive": [
3388
+ "global"
3389
+ ],
3390
+ "name": "local",
3391
+ "allowNo": false,
3392
+ "type": "boolean"
3437
3393
  },
3438
- "no-instrument": {
3439
- "description": "Skip opening the agent after setup",
3440
- "name": "no-instrument",
3394
+ "global": {
3395
+ "description": "Check global setup",
3396
+ "exclusive": [
3397
+ "local"
3398
+ ],
3399
+ "name": "global",
3441
3400
  "allowNo": false,
3442
3401
  "type": "boolean"
3443
3402
  }
3444
3403
  },
3445
3404
  "hasDynamicHelp": false,
3446
3405
  "hiddenAliases": [],
3447
- "id": "setup:tracing",
3406
+ "id": "setup:doctor",
3448
3407
  "pluginAlias": "@respan/cli",
3449
3408
  "pluginName": "@respan/cli",
3450
3409
  "pluginType": "core",
@@ -3455,13 +3414,18 @@
3455
3414
  "dist",
3456
3415
  "commands",
3457
3416
  "setup",
3458
- "tracing.js"
3417
+ "doctor.js"
3459
3418
  ]
3460
3419
  },
3461
- "users:create": {
3420
+ "setup:gateway": {
3462
3421
  "aliases": [],
3463
3422
  "args": {},
3464
- "description": "Create a new user (customer)",
3423
+ "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.",
3424
+ "examples": [
3425
+ "respan setup gateway",
3426
+ "respan setup gateway --agent claude-code",
3427
+ "respan setup gateway --no-instrument"
3428
+ ],
3465
3429
  "flags": {
3466
3430
  "api-key": {
3467
3431
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3486,13 +3450,13 @@
3486
3450
  "type": "option"
3487
3451
  },
3488
3452
  "json": {
3489
- "description": "Output as JSON",
3453
+ "hidden": true,
3490
3454
  "name": "json",
3491
3455
  "allowNo": false,
3492
3456
  "type": "boolean"
3493
3457
  },
3494
3458
  "csv": {
3495
- "description": "Output as CSV",
3459
+ "hidden": true,
3496
3460
  "name": "csv",
3497
3461
  "allowNo": false,
3498
3462
  "type": "boolean"
@@ -3504,39 +3468,23 @@
3504
3468
  "allowNo": false,
3505
3469
  "type": "boolean"
3506
3470
  },
3507
- "identifier": {
3508
- "description": "Customer identifier",
3509
- "name": "identifier",
3510
- "required": true,
3511
- "hasDynamicHelp": false,
3512
- "multiple": false,
3513
- "type": "option"
3514
- },
3515
- "name": {
3516
- "description": "Customer name",
3517
- "name": "name",
3518
- "hasDynamicHelp": false,
3519
- "multiple": false,
3520
- "type": "option"
3521
- },
3522
- "email": {
3523
- "description": "Customer email",
3524
- "name": "email",
3471
+ "agent": {
3472
+ "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
3473
+ "name": "agent",
3525
3474
  "hasDynamicHelp": false,
3526
3475
  "multiple": false,
3527
3476
  "type": "option"
3528
3477
  },
3529
- "metadata": {
3530
- "description": "Metadata as JSON string",
3531
- "name": "metadata",
3532
- "hasDynamicHelp": false,
3533
- "multiple": false,
3534
- "type": "option"
3478
+ "no-instrument": {
3479
+ "description": "Skip opening the agent after setup",
3480
+ "name": "no-instrument",
3481
+ "allowNo": false,
3482
+ "type": "boolean"
3535
3483
  }
3536
3484
  },
3537
3485
  "hasDynamicHelp": false,
3538
3486
  "hiddenAliases": [],
3539
- "id": "users:create",
3487
+ "id": "setup:gateway",
3540
3488
  "pluginAlias": "@respan/cli",
3541
3489
  "pluginName": "@respan/cli",
3542
3490
  "pluginType": "core",
@@ -3546,20 +3494,22 @@
3546
3494
  "relativePath": [
3547
3495
  "dist",
3548
3496
  "commands",
3549
- "users",
3550
- "create.js"
3497
+ "setup",
3498
+ "gateway.js"
3551
3499
  ]
3552
3500
  },
3553
- "users:get": {
3501
+ "setup": {
3554
3502
  "aliases": [],
3555
- "args": {
3556
- "id": {
3557
- "description": "Customer identifier",
3558
- "name": "id",
3559
- "required": true
3560
- }
3561
- },
3562
- "description": "Get a specific user (customer)",
3503
+ "args": {},
3504
+ "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.",
3505
+ "examples": [
3506
+ "npx @respan/cli setup",
3507
+ "respan setup",
3508
+ "respan setup tracing",
3509
+ "respan setup gateway",
3510
+ "respan setup --agent claude-code",
3511
+ "respan setup --no-instrument"
3512
+ ],
3563
3513
  "flags": {
3564
3514
  "api-key": {
3565
3515
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3584,13 +3534,13 @@
3584
3534
  "type": "option"
3585
3535
  },
3586
3536
  "json": {
3587
- "description": "Output as JSON",
3537
+ "hidden": true,
3588
3538
  "name": "json",
3589
3539
  "allowNo": false,
3590
3540
  "type": "boolean"
3591
3541
  },
3592
3542
  "csv": {
3593
- "description": "Output as CSV",
3543
+ "hidden": true,
3594
3544
  "name": "csv",
3595
3545
  "allowNo": false,
3596
3546
  "type": "boolean"
@@ -3601,11 +3551,24 @@
3601
3551
  "name": "verbose",
3602
3552
  "allowNo": false,
3603
3553
  "type": "boolean"
3554
+ },
3555
+ "agent": {
3556
+ "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
3557
+ "name": "agent",
3558
+ "hasDynamicHelp": false,
3559
+ "multiple": false,
3560
+ "type": "option"
3561
+ },
3562
+ "no-instrument": {
3563
+ "description": "Skip opening the agent after setup",
3564
+ "name": "no-instrument",
3565
+ "allowNo": false,
3566
+ "type": "boolean"
3604
3567
  }
3605
3568
  },
3606
3569
  "hasDynamicHelp": false,
3607
3570
  "hiddenAliases": [],
3608
- "id": "users:get",
3571
+ "id": "setup",
3609
3572
  "pluginAlias": "@respan/cli",
3610
3573
  "pluginName": "@respan/cli",
3611
3574
  "pluginType": "core",
@@ -3615,14 +3578,19 @@
3615
3578
  "relativePath": [
3616
3579
  "dist",
3617
3580
  "commands",
3618
- "users",
3619
- "get.js"
3581
+ "setup",
3582
+ "index.js"
3620
3583
  ]
3621
3584
  },
3622
- "users:list": {
3585
+ "setup:tracing": {
3623
3586
  "aliases": [],
3624
3587
  "args": {},
3625
- "description": "List users (customers)",
3588
+ "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.",
3589
+ "examples": [
3590
+ "respan setup tracing",
3591
+ "respan setup tracing --agent claude-code",
3592
+ "respan setup tracing --no-instrument"
3593
+ ],
3626
3594
  "flags": {
3627
3595
  "api-key": {
3628
3596
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3647,13 +3615,13 @@
3647
3615
  "type": "option"
3648
3616
  },
3649
3617
  "json": {
3650
- "description": "Output as JSON",
3618
+ "hidden": true,
3651
3619
  "name": "json",
3652
3620
  "allowNo": false,
3653
3621
  "type": "boolean"
3654
3622
  },
3655
3623
  "csv": {
3656
- "description": "Output as CSV",
3624
+ "hidden": true,
3657
3625
  "name": "csv",
3658
3626
  "allowNo": false,
3659
3627
  "type": "boolean"
@@ -3665,40 +3633,23 @@
3665
3633
  "allowNo": false,
3666
3634
  "type": "boolean"
3667
3635
  },
3668
- "limit": {
3669
- "description": "Number of results per page",
3670
- "name": "limit",
3671
- "default": 20,
3672
- "hasDynamicHelp": false,
3673
- "multiple": false,
3674
- "type": "option"
3675
- },
3676
- "page": {
3677
- "description": "Page number",
3678
- "name": "page",
3679
- "default": 1,
3680
- "hasDynamicHelp": false,
3681
- "multiple": false,
3682
- "type": "option"
3683
- },
3684
- "sort-by": {
3685
- "description": "Sort field",
3686
- "name": "sort-by",
3636
+ "agent": {
3637
+ "description": "Agent to configure (claude-code, cursor, codex-cli, gemini-cli, opencode)",
3638
+ "name": "agent",
3687
3639
  "hasDynamicHelp": false,
3688
3640
  "multiple": false,
3689
3641
  "type": "option"
3690
3642
  },
3691
- "environment": {
3692
- "description": "Environment filter",
3693
- "name": "environment",
3694
- "hasDynamicHelp": false,
3695
- "multiple": false,
3696
- "type": "option"
3643
+ "no-instrument": {
3644
+ "description": "Skip opening the agent after setup",
3645
+ "name": "no-instrument",
3646
+ "allowNo": false,
3647
+ "type": "boolean"
3697
3648
  }
3698
3649
  },
3699
3650
  "hasDynamicHelp": false,
3700
3651
  "hiddenAliases": [],
3701
- "id": "users:list",
3652
+ "id": "setup:tracing",
3702
3653
  "pluginAlias": "@respan/cli",
3703
3654
  "pluginName": "@respan/cli",
3704
3655
  "pluginType": "core",
@@ -3708,20 +3659,20 @@
3708
3659
  "relativePath": [
3709
3660
  "dist",
3710
3661
  "commands",
3711
- "users",
3712
- "list.js"
3662
+ "setup",
3663
+ "tracing.js"
3713
3664
  ]
3714
3665
  },
3715
- "users:update": {
3666
+ "traces:get": {
3716
3667
  "aliases": [],
3717
3668
  "args": {
3718
3669
  "id": {
3719
- "description": "Customer identifier",
3670
+ "description": "Trace ID",
3720
3671
  "name": "id",
3721
3672
  "required": true
3722
3673
  }
3723
3674
  },
3724
- "description": "Update a user (customer)",
3675
+ "description": "Get a specific trace",
3725
3676
  "flags": {
3726
3677
  "api-key": {
3727
3678
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3759,36 +3710,15 @@
3759
3710
  },
3760
3711
  "verbose": {
3761
3712
  "char": "v",
3762
- "description": "Show verbose output",
3763
- "name": "verbose",
3764
- "allowNo": false,
3765
- "type": "boolean"
3766
- },
3767
- "name": {
3768
- "description": "Customer name",
3769
- "name": "name",
3770
- "hasDynamicHelp": false,
3771
- "multiple": false,
3772
- "type": "option"
3773
- },
3774
- "email": {
3775
- "description": "Customer email",
3776
- "name": "email",
3777
- "hasDynamicHelp": false,
3778
- "multiple": false,
3779
- "type": "option"
3780
- },
3781
- "metadata": {
3782
- "description": "Metadata as JSON string",
3783
- "name": "metadata",
3784
- "hasDynamicHelp": false,
3785
- "multiple": false,
3786
- "type": "option"
3713
+ "description": "Show verbose output",
3714
+ "name": "verbose",
3715
+ "allowNo": false,
3716
+ "type": "boolean"
3787
3717
  }
3788
3718
  },
3789
3719
  "hasDynamicHelp": false,
3790
3720
  "hiddenAliases": [],
3791
- "id": "users:update",
3721
+ "id": "traces:get",
3792
3722
  "pluginAlias": "@respan/cli",
3793
3723
  "pluginName": "@respan/cli",
3794
3724
  "pluginType": "core",
@@ -3798,20 +3728,14 @@
3798
3728
  "relativePath": [
3799
3729
  "dist",
3800
3730
  "commands",
3801
- "users",
3802
- "update.js"
3731
+ "traces",
3732
+ "get.js"
3803
3733
  ]
3804
3734
  },
3805
- "prompts:create-version": {
3735
+ "traces:list": {
3806
3736
  "aliases": [],
3807
- "args": {
3808
- "prompt-id": {
3809
- "description": "Prompt ID",
3810
- "name": "prompt-id",
3811
- "required": true
3812
- }
3813
- },
3814
- "description": "Create a new version of a prompt",
3737
+ "args": {},
3738
+ "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",
3815
3739
  "flags": {
3816
3740
  "api-key": {
3817
3741
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3854,39 +3778,62 @@
3854
3778
  "allowNo": false,
3855
3779
  "type": "boolean"
3856
3780
  },
3857
- "messages": {
3858
- "description": "Messages as JSON array string",
3859
- "name": "messages",
3860
- "required": true,
3781
+ "limit": {
3782
+ "description": "Number of results per page",
3783
+ "name": "limit",
3784
+ "default": 10,
3861
3785
  "hasDynamicHelp": false,
3862
3786
  "multiple": false,
3863
3787
  "type": "option"
3864
3788
  },
3865
- "model": {
3866
- "description": "Model name",
3867
- "name": "model",
3789
+ "page": {
3790
+ "description": "Page number",
3791
+ "name": "page",
3792
+ "default": 1,
3868
3793
  "hasDynamicHelp": false,
3869
3794
  "multiple": false,
3870
3795
  "type": "option"
3871
3796
  },
3872
- "temperature": {
3873
- "description": "Temperature value",
3874
- "name": "temperature",
3797
+ "sort-by": {
3798
+ "description": "Sort field (prefix with - for descending)",
3799
+ "name": "sort-by",
3800
+ "default": "-timestamp",
3875
3801
  "hasDynamicHelp": false,
3876
3802
  "multiple": false,
3877
3803
  "type": "option"
3878
3804
  },
3879
- "max-tokens": {
3880
- "description": "Max tokens",
3881
- "name": "max-tokens",
3805
+ "start-time": {
3806
+ "description": "Start time filter (ISO 8601)",
3807
+ "name": "start-time",
3808
+ "hasDynamicHelp": false,
3809
+ "multiple": false,
3810
+ "type": "option"
3811
+ },
3812
+ "end-time": {
3813
+ "description": "End time filter (ISO 8601)",
3814
+ "name": "end-time",
3815
+ "hasDynamicHelp": false,
3816
+ "multiple": false,
3817
+ "type": "option"
3818
+ },
3819
+ "environment": {
3820
+ "description": "Environment filter",
3821
+ "name": "environment",
3882
3822
  "hasDynamicHelp": false,
3883
3823
  "multiple": false,
3884
3824
  "type": "option"
3825
+ },
3826
+ "filter": {
3827
+ "description": "Filter in field:operator:value format (repeatable)",
3828
+ "name": "filter",
3829
+ "hasDynamicHelp": false,
3830
+ "multiple": true,
3831
+ "type": "option"
3885
3832
  }
3886
3833
  },
3887
3834
  "hasDynamicHelp": false,
3888
3835
  "hiddenAliases": [],
3889
- "id": "prompts:create-version",
3836
+ "id": "traces:list",
3890
3837
  "pluginAlias": "@respan/cli",
3891
3838
  "pluginName": "@respan/cli",
3892
3839
  "pluginType": "core",
@@ -3896,14 +3843,14 @@
3896
3843
  "relativePath": [
3897
3844
  "dist",
3898
3845
  "commands",
3899
- "prompts",
3900
- "create-version.js"
3846
+ "traces",
3847
+ "list.js"
3901
3848
  ]
3902
3849
  },
3903
- "prompts:create": {
3850
+ "traces:summary": {
3904
3851
  "aliases": [],
3905
3852
  "args": {},
3906
- "description": "Create a new prompt",
3853
+ "description": "Get a span-level summary of activity for a time range (counts, latency, cost, errors aggregated across spans)",
3907
3854
  "flags": {
3908
3855
  "api-key": {
3909
3856
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3946,17 +3893,18 @@
3946
3893
  "allowNo": false,
3947
3894
  "type": "boolean"
3948
3895
  },
3949
- "name": {
3950
- "description": "Prompt name",
3951
- "name": "name",
3896
+ "start-time": {
3897
+ "description": "Start time (ISO 8601)",
3898
+ "name": "start-time",
3952
3899
  "required": true,
3953
3900
  "hasDynamicHelp": false,
3954
3901
  "multiple": false,
3955
3902
  "type": "option"
3956
3903
  },
3957
- "description": {
3958
- "description": "Prompt description",
3959
- "name": "description",
3904
+ "end-time": {
3905
+ "description": "End time (ISO 8601)",
3906
+ "name": "end-time",
3907
+ "required": true,
3960
3908
  "hasDynamicHelp": false,
3961
3909
  "multiple": false,
3962
3910
  "type": "option"
@@ -3964,7 +3912,7 @@
3964
3912
  },
3965
3913
  "hasDynamicHelp": false,
3966
3914
  "hiddenAliases": [],
3967
- "id": "prompts:create",
3915
+ "id": "traces:summary",
3968
3916
  "pluginAlias": "@respan/cli",
3969
3917
  "pluginName": "@respan/cli",
3970
3918
  "pluginType": "core",
@@ -3974,20 +3922,14 @@
3974
3922
  "relativePath": [
3975
3923
  "dist",
3976
3924
  "commands",
3977
- "prompts",
3978
- "create.js"
3925
+ "traces",
3926
+ "summary.js"
3979
3927
  ]
3980
3928
  },
3981
- "prompts:get": {
3929
+ "users:create": {
3982
3930
  "aliases": [],
3983
- "args": {
3984
- "id": {
3985
- "description": "Prompt ID",
3986
- "name": "id",
3987
- "required": true
3988
- }
3989
- },
3990
- "description": "Get a specific prompt",
3931
+ "args": {},
3932
+ "description": "Create a new user (customer)",
3991
3933
  "flags": {
3992
3934
  "api-key": {
3993
3935
  "description": "API key (env: RESPAN_API_KEY)",
@@ -4029,11 +3971,40 @@
4029
3971
  "name": "verbose",
4030
3972
  "allowNo": false,
4031
3973
  "type": "boolean"
3974
+ },
3975
+ "identifier": {
3976
+ "description": "Customer identifier",
3977
+ "name": "identifier",
3978
+ "required": true,
3979
+ "hasDynamicHelp": false,
3980
+ "multiple": false,
3981
+ "type": "option"
3982
+ },
3983
+ "name": {
3984
+ "description": "Customer name",
3985
+ "name": "name",
3986
+ "hasDynamicHelp": false,
3987
+ "multiple": false,
3988
+ "type": "option"
3989
+ },
3990
+ "email": {
3991
+ "description": "Customer email",
3992
+ "name": "email",
3993
+ "hasDynamicHelp": false,
3994
+ "multiple": false,
3995
+ "type": "option"
3996
+ },
3997
+ "metadata": {
3998
+ "description": "Metadata as JSON string",
3999
+ "name": "metadata",
4000
+ "hasDynamicHelp": false,
4001
+ "multiple": false,
4002
+ "type": "option"
4032
4003
  }
4033
4004
  },
4034
4005
  "hasDynamicHelp": false,
4035
4006
  "hiddenAliases": [],
4036
- "id": "prompts:get",
4007
+ "id": "users:create",
4037
4008
  "pluginAlias": "@respan/cli",
4038
4009
  "pluginName": "@respan/cli",
4039
4010
  "pluginType": "core",
@@ -4043,14 +4014,20 @@
4043
4014
  "relativePath": [
4044
4015
  "dist",
4045
4016
  "commands",
4046
- "prompts",
4047
- "get.js"
4017
+ "users",
4018
+ "create.js"
4048
4019
  ]
4049
4020
  },
4050
- "prompts:list": {
4021
+ "users:get": {
4051
4022
  "aliases": [],
4052
- "args": {},
4053
- "description": "List prompts",
4023
+ "args": {
4024
+ "id": {
4025
+ "description": "Customer identifier",
4026
+ "name": "id",
4027
+ "required": true
4028
+ }
4029
+ },
4030
+ "description": "Get a specific user (customer)",
4054
4031
  "flags": {
4055
4032
  "api-key": {
4056
4033
  "description": "API key (env: RESPAN_API_KEY)",
@@ -4092,19 +4069,11 @@
4092
4069
  "name": "verbose",
4093
4070
  "allowNo": false,
4094
4071
  "type": "boolean"
4095
- },
4096
- "limit": {
4097
- "description": "Number of results per page",
4098
- "name": "limit",
4099
- "default": 50,
4100
- "hasDynamicHelp": false,
4101
- "multiple": false,
4102
- "type": "option"
4103
4072
  }
4104
4073
  },
4105
4074
  "hasDynamicHelp": false,
4106
4075
  "hiddenAliases": [],
4107
- "id": "prompts:list",
4076
+ "id": "users:get",
4108
4077
  "pluginAlias": "@respan/cli",
4109
4078
  "pluginName": "@respan/cli",
4110
4079
  "pluginType": "core",
@@ -4114,20 +4083,14 @@
4114
4083
  "relativePath": [
4115
4084
  "dist",
4116
4085
  "commands",
4117
- "prompts",
4118
- "list.js"
4086
+ "users",
4087
+ "get.js"
4119
4088
  ]
4120
4089
  },
4121
- "prompts:update": {
4090
+ "users:list": {
4122
4091
  "aliases": [],
4123
- "args": {
4124
- "id": {
4125
- "description": "Prompt ID",
4126
- "name": "id",
4127
- "required": true
4128
- }
4129
- },
4130
- "description": "Update a prompt",
4092
+ "args": {},
4093
+ "description": "List users (customers)",
4131
4094
  "flags": {
4132
4095
  "api-key": {
4133
4096
  "description": "API key (env: RESPAN_API_KEY)",
@@ -4170,16 +4133,32 @@
4170
4133
  "allowNo": false,
4171
4134
  "type": "boolean"
4172
4135
  },
4173
- "name": {
4174
- "description": "Prompt name",
4175
- "name": "name",
4136
+ "limit": {
4137
+ "description": "Number of results per page",
4138
+ "name": "limit",
4139
+ "default": 20,
4176
4140
  "hasDynamicHelp": false,
4177
4141
  "multiple": false,
4178
4142
  "type": "option"
4179
4143
  },
4180
- "description": {
4181
- "description": "Prompt description",
4182
- "name": "description",
4144
+ "page": {
4145
+ "description": "Page number",
4146
+ "name": "page",
4147
+ "default": 1,
4148
+ "hasDynamicHelp": false,
4149
+ "multiple": false,
4150
+ "type": "option"
4151
+ },
4152
+ "sort-by": {
4153
+ "description": "Sort field",
4154
+ "name": "sort-by",
4155
+ "hasDynamicHelp": false,
4156
+ "multiple": false,
4157
+ "type": "option"
4158
+ },
4159
+ "environment": {
4160
+ "description": "Environment filter",
4161
+ "name": "environment",
4183
4162
  "hasDynamicHelp": false,
4184
4163
  "multiple": false,
4185
4164
  "type": "option"
@@ -4187,7 +4166,7 @@
4187
4166
  },
4188
4167
  "hasDynamicHelp": false,
4189
4168
  "hiddenAliases": [],
4190
- "id": "prompts:update",
4169
+ "id": "users:list",
4191
4170
  "pluginAlias": "@respan/cli",
4192
4171
  "pluginName": "@respan/cli",
4193
4172
  "pluginType": "core",
@@ -4197,20 +4176,20 @@
4197
4176
  "relativePath": [
4198
4177
  "dist",
4199
4178
  "commands",
4200
- "prompts",
4201
- "update.js"
4179
+ "users",
4180
+ "list.js"
4202
4181
  ]
4203
4182
  },
4204
- "prompts:versions": {
4183
+ "users:update": {
4205
4184
  "aliases": [],
4206
4185
  "args": {
4207
- "prompt-id": {
4208
- "description": "Prompt ID",
4209
- "name": "prompt-id",
4186
+ "id": {
4187
+ "description": "Customer identifier",
4188
+ "name": "id",
4210
4189
  "required": true
4211
4190
  }
4212
4191
  },
4213
- "description": "List versions of a prompt",
4192
+ "description": "Update a user (customer)",
4214
4193
  "flags": {
4215
4194
  "api-key": {
4216
4195
  "description": "API key (env: RESPAN_API_KEY)",
@@ -4252,11 +4231,32 @@
4252
4231
  "name": "verbose",
4253
4232
  "allowNo": false,
4254
4233
  "type": "boolean"
4234
+ },
4235
+ "name": {
4236
+ "description": "Customer name",
4237
+ "name": "name",
4238
+ "hasDynamicHelp": false,
4239
+ "multiple": false,
4240
+ "type": "option"
4241
+ },
4242
+ "email": {
4243
+ "description": "Customer email",
4244
+ "name": "email",
4245
+ "hasDynamicHelp": false,
4246
+ "multiple": false,
4247
+ "type": "option"
4248
+ },
4249
+ "metadata": {
4250
+ "description": "Metadata as JSON string",
4251
+ "name": "metadata",
4252
+ "hasDynamicHelp": false,
4253
+ "multiple": false,
4254
+ "type": "option"
4255
4255
  }
4256
4256
  },
4257
4257
  "hasDynamicHelp": false,
4258
4258
  "hiddenAliases": [],
4259
- "id": "prompts:versions",
4259
+ "id": "users:update",
4260
4260
  "pluginAlias": "@respan/cli",
4261
4261
  "pluginName": "@respan/cli",
4262
4262
  "pluginType": "core",
@@ -4266,10 +4266,10 @@
4266
4266
  "relativePath": [
4267
4267
  "dist",
4268
4268
  "commands",
4269
- "prompts",
4270
- "versions.js"
4269
+ "users",
4270
+ "update.js"
4271
4271
  ]
4272
4272
  }
4273
4273
  },
4274
- "version": "0.12.0"
4274
+ "version": "0.13.1"
4275
4275
  }