@respan/cli 0.14.0 → 0.14.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/dist/commands/integrate/pi.js +6 -6
  2. package/dist/lib/pi-integrate.d.ts +1 -1
  3. package/dist/lib/skill-refs.generated.d.ts +1 -1
  4. package/dist/lib/skill-refs.generated.js +1 -1
  5. package/oclif.manifest.json +772 -772
  6. package/package.json +1 -1
package/oclif.manifest.json CHANGED
@@ -1583,75 +1583,6 @@
1583
1583
  "index.js"
1584
1584
  ]
1585
1585
  },
1586
- "eval": {
1587
- "aliases": [],
1588
- "args": {
1589
- "file": {
1590
- "description": "Path to eval JSON file",
1591
- "name": "file",
1592
- "required": true
1593
- }
1594
- },
1595
- "description": "Run an eval defined in a JSON file (creates prompt + dataset on the platform)",
1596
- "flags": {
1597
- "api-key": {
1598
- "description": "API key (env: RESPAN_API_KEY)",
1599
- "env": "RESPAN_API_KEY",
1600
- "name": "api-key",
1601
- "hasDynamicHelp": false,
1602
- "multiple": false,
1603
- "type": "option"
1604
- },
1605
- "base-url": {
1606
- "description": "Temporary API base URL override for this command",
1607
- "name": "base-url",
1608
- "hasDynamicHelp": false,
1609
- "multiple": false,
1610
- "type": "option"
1611
- },
1612
- "profile": {
1613
- "description": "Named profile to use",
1614
- "name": "profile",
1615
- "hasDynamicHelp": false,
1616
- "multiple": false,
1617
- "type": "option"
1618
- },
1619
- "json": {
1620
- "description": "Output as JSON",
1621
- "name": "json",
1622
- "allowNo": false,
1623
- "type": "boolean"
1624
- },
1625
- "csv": {
1626
- "description": "Output as CSV",
1627
- "name": "csv",
1628
- "allowNo": false,
1629
- "type": "boolean"
1630
- },
1631
- "verbose": {
1632
- "char": "v",
1633
- "description": "Show verbose output",
1634
- "name": "verbose",
1635
- "allowNo": false,
1636
- "type": "boolean"
1637
- }
1638
- },
1639
- "hasDynamicHelp": false,
1640
- "hiddenAliases": [],
1641
- "id": "eval",
1642
- "pluginAlias": "@respan/cli",
1643
- "pluginName": "@respan/cli",
1644
- "pluginType": "core",
1645
- "strict": true,
1646
- "enableJsonFlag": false,
1647
- "isESM": true,
1648
- "relativePath": [
1649
- "dist",
1650
- "commands",
1651
- "eval",
1652
- "index.js"
1653
- ]
1654
- },
1655
1586
  "evaluators:create": {
1656
1587
  "aliases": [],
1657
1588
  "args": {},
@@ -2313,10 +2244,16 @@
2313
2244
  "list.js"
2314
2245
  ]
2315
2246
  },
2316
- "logs:create": {
2247
+ "eval": {
2317
2248
  "aliases": [],
2318
- "args": {},
2319
- "description": "Create a log span",
2249
+ "args": {
2250
+ "file": {
2251
+ "description": "Path to eval JSON file",
2252
+ "name": "file",
2253
+ "required": true
2254
+ }
2255
+ },
2256
+ "description": "Run an eval defined in a JSON file (creates prompt + dataset on the platform)",
2320
2257
  "flags": {
2321
2258
  "api-key": {
2322
2259
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2358,40 +2295,11 @@
2358
2295
  "name": "verbose",
2359
2296
  "allowNo": false,
2360
2297
  "type": "boolean"
2361
- },
2362
- "input": {
2363
- "description": "Input text or JSON",
2364
- "name": "input",
2365
- "required": true,
2366
- "hasDynamicHelp": false,
2367
- "multiple": false,
2368
- "type": "option"
2369
- },
2370
- "output": {
2371
- "description": "Output text or JSON",
2372
- "name": "output",
2373
- "hasDynamicHelp": false,
2374
- "multiple": false,
2375
- "type": "option"
2376
- },
2377
- "model": {
2378
- "description": "Model name",
2379
- "name": "model",
2380
- "hasDynamicHelp": false,
2381
- "multiple": false,
2382
- "type": "option"
2383
- },
2384
- "metadata": {
2385
- "description": "Metadata as JSON string",
2386
- "name": "metadata",
2387
- "hasDynamicHelp": false,
2388
- "multiple": false,
2389
- "type": "option"
2390
2298
  }
2391
2299
  },
2392
2300
  "hasDynamicHelp": false,
2393
2301
  "hiddenAliases": [],
2394
- "id": "logs:create",
2302
+ "id": "eval",
2395
2303
  "pluginAlias": "@respan/cli",
2396
2304
  "pluginName": "@respan/cli",
2397
2305
  "pluginType": "core",
@@ -2401,20 +2309,22 @@
2401
2309
  "relativePath": [
2402
2310
  "dist",
2403
2311
  "commands",
2404
- "logs",
2405
- "create.js"
2312
+ "eval",
2313
+ "index.js"
2406
2314
  ]
2407
2315
  },
2408
- "logs:get": {
2316
+ "integrate:claude-code": {
2409
2317
  "aliases": [],
2410
- "args": {
2411
- "id": {
2412
- "description": "Span ID",
2413
- "name": "id",
2414
- "required": true
2415
- }
2416
- },
2417
- "description": "Get a specific log span",
2318
+ "args": {},
2319
+ "description": "Integrate Respan with Claude Code.\n\nInstalls a Stop hook that reads conversation transcripts and sends\nthem to Respan as structured spans (chat, tool, thinking).\n\nScope:\n --global Install hook script + register in ~/.claude/settings.json\n --local Write credentials + enable flag to .claude/settings.local.json\n\nDefault behavior installs the global hook and writes local project config.",
2320
+ "examples": [
2321
+ "respan integrate claude-code",
2322
+ "respan integrate claude-code --disable",
2323
+ "respan integrate claude-code --global",
2324
+ "respan integrate claude-code --local --project-id my-project",
2325
+ "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
2326
+ "respan integrate claude-code --dry-run"
2327
+ ],
2418
2328
  "flags": {
2419
2329
  "api-key": {
2420
2330
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2425,8 +2335,9 @@
2425
2335
  "type": "option"
2426
2336
  },
2427
2337
  "base-url": {
2428
- "description": "Temporary API base URL override for this command",
2338
+ "description": "Respan API base URL (for enterprise deployments)",
2429
2339
  "name": "base-url",
2340
+ "default": "https://api.respan.ai/api",
2430
2341
  "hasDynamicHelp": false,
2431
2342
  "multiple": false,
2432
2343
  "type": "option"
@@ -2456,11 +2367,91 @@
2456
2367
  "name": "verbose",
2457
2368
  "allowNo": false,
2458
2369
  "type": "boolean"
2370
+ },
2371
+ "local": {
2372
+ "description": "Write per-project config (default)",
2373
+ "exclusive": [
2374
+ "global"
2375
+ ],
2376
+ "name": "local",
2377
+ "allowNo": false,
2378
+ "type": "boolean"
2379
+ },
2380
+ "global": {
2381
+ "description": "Write user-level global config",
2382
+ "exclusive": [
2383
+ "local"
2384
+ ],
2385
+ "name": "global",
2386
+ "allowNo": false,
2387
+ "type": "boolean"
2388
+ },
2389
+ "enable": {
2390
+ "description": "Enable tracing (default)",
2391
+ "exclusive": [
2392
+ "disable"
2393
+ ],
2394
+ "name": "enable",
2395
+ "allowNo": false,
2396
+ "type": "boolean"
2397
+ },
2398
+ "disable": {
2399
+ "description": "Disable tracing",
2400
+ "exclusive": [
2401
+ "enable"
2402
+ ],
2403
+ "name": "disable",
2404
+ "allowNo": false,
2405
+ "type": "boolean"
2406
+ },
2407
+ "project-id": {
2408
+ "description": "Respan project ID (added to metadata / resource attributes)",
2409
+ "env": "RESPAN_PROJECT_ID",
2410
+ "name": "project-id",
2411
+ "hasDynamicHelp": false,
2412
+ "multiple": false,
2413
+ "type": "option"
2414
+ },
2415
+ "attrs": {
2416
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2417
+ "name": "attrs",
2418
+ "default": "{}",
2419
+ "hasDynamicHelp": false,
2420
+ "multiple": false,
2421
+ "type": "option"
2422
+ },
2423
+ "customer-id": {
2424
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2425
+ "env": "RESPAN_CUSTOMER_ID",
2426
+ "name": "customer-id",
2427
+ "hasDynamicHelp": false,
2428
+ "multiple": false,
2429
+ "type": "option"
2430
+ },
2431
+ "span-name": {
2432
+ "description": "Root span name for traces (default: claude-code)",
2433
+ "name": "span-name",
2434
+ "hasDynamicHelp": false,
2435
+ "multiple": false,
2436
+ "type": "option"
2437
+ },
2438
+ "workflow-name": {
2439
+ "description": "Workflow name for traces (default: claude-code)",
2440
+ "name": "workflow-name",
2441
+ "hasDynamicHelp": false,
2442
+ "multiple": false,
2443
+ "type": "option"
2444
+ },
2445
+ "dry-run": {
2446
+ "description": "Preview changes without writing files",
2447
+ "name": "dry-run",
2448
+ "allowNo": false,
2449
+ "type": "boolean"
2459
2450
  }
2460
2451
  },
2461
2452
  "hasDynamicHelp": false,
2462
2453
  "hiddenAliases": [],
2463
- "id": "logs:get",
2454
+ "id": "integrate:claude-code",
2464
2455
  "pluginAlias": "@respan/cli",
2465
2456
  "pluginName": "@respan/cli",
2466
2457
  "pluginType": "core",
@@ -2470,14 +2461,22 @@
2470
2461
  "relativePath": [
2471
2462
  "dist",
2472
2463
  "commands",
2473
- "logs",
2474
- "get.js"
2464
+ "integrate",
2465
+ "claude-code.js"
2475
2466
  ]
2476
2467
  },
2477
- "logs:list": {
2468
+ "integrate:codex-cli": {
2478
2469
  "aliases": [],
2479
2470
  "args": {},
2480
- "description": "List and filter LLM request logs (spans).\n\nSupports pagination, sorting, time range, and server-side filtering.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n (empty) Exact match model::gpt-4\n not Not equal status_code:not:200\n gt Greater than cost:gt:0.01\n gte Greater than/equal latency:gte:1.0\n lt Less than cost:lt:0.5\n lte Less than/equal prompt_tokens:lte:100\n contains Contains substring error_message:contains:timeout\n icontains Case-insensitive model:icontains:gpt\n startswith Starts with model:startswith:gpt\n endswith Ends with model:endswith:mini\n in Value in list model:in:gpt-4,gpt-4o\n isnull Is null error_message:isnull:true\n iexact Case-insens. exact status:iexact:success\n\nFILTERABLE FIELDS (logs):\n model, status_code, status, cost, latency, prompt_tokens,\n completion_tokens, customer_identifier, custom_identifier,\n thread_identifier, trace_unique_id, span_name, span_workflow_name,\n environment, log_type, error_message, failed, provider_id,\n deployment_name, prompt_name, prompt_id, unique_id, stream,\n temperature, max_tokens, tokens_per_second, time_to_first_token,\n total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o",
2471
+ "description": "Integrate Respan with Codex CLI.\n\nInstalls a notify hook that reads session JSONL files and sends\nthem to Respan as structured spans (chat, tool, reasoning).\n\nScope:\n --global Install hook script + register notify in ~/.codex/config.toml\n --local Write .codex/respan.json with customer_id, span_name, etc.\n\nDefault behavior installs the global notify hook and writes local project config.",
2472
+ "examples": [
2473
+ "respan integrate codex-cli",
2474
+ "respan integrate codex-cli --disable",
2475
+ "respan integrate codex-cli --global",
2476
+ "respan integrate codex-cli --local --customer-id frank",
2477
+ "respan integrate codex-cli --attrs '{\"env\":\"prod\"}'",
2478
+ "respan integrate codex-cli --dry-run"
2479
+ ],
2481
2480
  "flags": {
2482
2481
  "api-key": {
2483
2482
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2488,8 +2487,9 @@
2488
2487
  "type": "option"
2489
2488
  },
2490
2489
  "base-url": {
2491
- "description": "Temporary API base URL override for this command",
2490
+ "description": "Respan API base URL (for enterprise deployments)",
2492
2491
  "name": "base-url",
2492
+ "default": "https://api.respan.ai/api",
2493
2493
  "hasDynamicHelp": false,
2494
2494
  "multiple": false,
2495
2495
  "type": "option"
@@ -2520,75 +2520,90 @@
2520
2520
  "allowNo": false,
2521
2521
  "type": "boolean"
2522
2522
  },
2523
- "limit": {
2524
- "description": "Number of results per page (max 1000)",
2525
- "name": "limit",
2526
- "default": 50,
2527
- "hasDynamicHelp": false,
2528
- "multiple": false,
2529
- "type": "option"
2523
+ "local": {
2524
+ "description": "Write per-project config (default)",
2525
+ "exclusive": [
2526
+ "global"
2527
+ ],
2528
+ "name": "local",
2529
+ "allowNo": false,
2530
+ "type": "boolean"
2530
2531
  },
2531
- "page": {
2532
- "description": "Page number",
2533
- "name": "page",
2534
- "default": 1,
2535
- "hasDynamicHelp": false,
2536
- "multiple": false,
2537
- "type": "option"
2532
+ "global": {
2533
+ "description": "Write user-level global config",
2534
+ "exclusive": [
2535
+ "local"
2536
+ ],
2537
+ "name": "global",
2538
+ "allowNo": false,
2539
+ "type": "boolean"
2538
2540
  },
2539
- "sort-by": {
2540
- "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
2541
- "name": "sort-by",
2542
- "hasDynamicHelp": false,
2543
- "multiple": false,
2544
- "type": "option"
2541
+ "enable": {
2542
+ "description": "Enable tracing (default)",
2543
+ "exclusive": [
2544
+ "disable"
2545
+ ],
2546
+ "name": "enable",
2547
+ "allowNo": false,
2548
+ "type": "boolean"
2545
2549
  },
2546
- "start-time": {
2547
- "description": "Start time filter (ISO 8601)",
2548
- "name": "start-time",
2549
- "hasDynamicHelp": false,
2550
- "multiple": false,
2551
- "type": "option"
2550
+ "disable": {
2551
+ "description": "Disable tracing",
2552
+ "exclusive": [
2553
+ "enable"
2554
+ ],
2555
+ "name": "disable",
2556
+ "allowNo": false,
2557
+ "type": "boolean"
2552
2558
  },
2553
- "end-time": {
2554
- "description": "End time filter (ISO 8601)",
2555
- "name": "end-time",
2559
+ "project-id": {
2560
+ "description": "Respan project ID (added to metadata / resource attributes)",
2561
+ "env": "RESPAN_PROJECT_ID",
2562
+ "name": "project-id",
2556
2563
  "hasDynamicHelp": false,
2557
2564
  "multiple": false,
2558
2565
  "type": "option"
2559
2566
  },
2560
- "filter": {
2561
- "description": "Filter in field:operator:value format (repeatable)",
2562
- "name": "filter",
2567
+ "attrs": {
2568
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2569
+ "name": "attrs",
2570
+ "default": "{}",
2563
2571
  "hasDynamicHelp": false,
2564
- "multiple": true,
2572
+ "multiple": false,
2565
2573
  "type": "option"
2566
2574
  },
2567
- "all-envs": {
2568
- "description": "Include all environments (true/false)",
2569
- "name": "all-envs",
2575
+ "customer-id": {
2576
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2577
+ "env": "RESPAN_CUSTOMER_ID",
2578
+ "name": "customer-id",
2570
2579
  "hasDynamicHelp": false,
2571
2580
  "multiple": false,
2572
2581
  "type": "option"
2573
2582
  },
2574
- "is-test": {
2575
- "description": "Filter by test (true) or production (false) environment",
2576
- "name": "is-test",
2583
+ "span-name": {
2584
+ "description": "Root span name for traces (default: claude-code)",
2585
+ "name": "span-name",
2577
2586
  "hasDynamicHelp": false,
2578
2587
  "multiple": false,
2579
2588
  "type": "option"
2580
2589
  },
2581
- "include-fields": {
2582
- "description": "Comma-separated fields to include in response",
2583
- "name": "include-fields",
2590
+ "workflow-name": {
2591
+ "description": "Workflow name for traces (default: claude-code)",
2592
+ "name": "workflow-name",
2584
2593
  "hasDynamicHelp": false,
2585
2594
  "multiple": false,
2586
2595
  "type": "option"
2596
+ },
2597
+ "dry-run": {
2598
+ "description": "Preview changes without writing files",
2599
+ "name": "dry-run",
2600
+ "allowNo": false,
2601
+ "type": "boolean"
2587
2602
  }
2588
2603
  },
2589
2604
  "hasDynamicHelp": false,
2590
2605
  "hiddenAliases": [],
2591
- "id": "logs:list",
2606
+ "id": "integrate:codex-cli",
2592
2607
  "pluginAlias": "@respan/cli",
2593
2608
  "pluginName": "@respan/cli",
2594
2609
  "pluginType": "core",
@@ -2598,14 +2613,21 @@
2598
2613
  "relativePath": [
2599
2614
  "dist",
2600
2615
  "commands",
2601
- "logs",
2602
- "list.js"
2616
+ "integrate",
2617
+ "codex-cli.js"
2603
2618
  ]
2604
2619
  },
2605
- "logs:summary": {
2620
+ "integrate:gemini-cli": {
2606
2621
  "aliases": [],
2607
2622
  "args": {},
2608
- "description": "Get aggregated summary statistics for log spans in a time range.\n\nReturns total cost, total tokens, request count, and score summaries.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n (empty) Exact match model::gpt-4\n not Not equal status_code:not:200\n gt Greater than cost:gt:0.01\n gte Greater than/equal latency:gte:1.0\n lt Less than cost:lt:0.5\n lte Less than/equal prompt_tokens:lte:100\n contains Contains substring error_message:contains:timeout\n icontains Case-insensitive model:icontains:gpt\n startswith Starts with model:startswith:gpt\n endswith Ends with model:endswith:mini\n in Value in list model:in:gpt-4,gpt-4o\n isnull Is null error_message:isnull:true\n iexact Case-insens. exact status:iexact:success\n\nFILTERABLE FIELDS (logs):\n model, status_code, status, cost, latency, prompt_tokens,\n completion_tokens, customer_identifier, custom_identifier,\n thread_identifier, trace_unique_id, span_name, span_workflow_name,\n environment, log_type, error_message, failed, provider_id,\n deployment_name, prompt_name, prompt_id, unique_id, stream,\n temperature, max_tokens, tokens_per_second, time_to_first_token,\n total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o",
2623
+ "description": "Integrate Respan with Gemini CLI.\n\nInstalls an AfterModel hook that captures LLM request/response data\nand sends it to Respan as structured spans with model, token counts,\nand input/output.\n\nScope:\n --global Write to ~/.gemini/settings.json (default)\n --local Write to .gemini/settings.json in project root\n\nGemini CLI ignores workspace-level telemetry settings, so --global is the default.",
2624
+ "examples": [
2625
+ "respan integrate gemini-cli",
2626
+ "respan integrate gemini-cli --disable",
2627
+ "respan integrate gemini-cli --local",
2628
+ "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
2629
+ "respan integrate gemini-cli --dry-run"
2630
+ ],
2609
2631
  "flags": {
2610
2632
  "api-key": {
2611
2633
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2616,8 +2638,9 @@
2616
2638
  "type": "option"
2617
2639
  },
2618
2640
  "base-url": {
2619
- "description": "Temporary API base URL override for this command",
2641
+ "description": "Respan API base URL (for enterprise deployments)",
2620
2642
  "name": "base-url",
2643
+ "default": "https://api.respan.ai/api",
2621
2644
  "hasDynamicHelp": false,
2622
2645
  "multiple": false,
2623
2646
  "type": "option"
@@ -2648,47 +2671,90 @@
2648
2671
  "allowNo": false,
2649
2672
  "type": "boolean"
2650
2673
  },
2651
- "start-time": {
2652
- "description": "Start time (ISO 8601)",
2653
- "name": "start-time",
2654
- "required": true,
2674
+ "local": {
2675
+ "description": "Write per-project config (default)",
2676
+ "exclusive": [
2677
+ "global"
2678
+ ],
2679
+ "name": "local",
2680
+ "allowNo": false,
2681
+ "type": "boolean"
2682
+ },
2683
+ "global": {
2684
+ "description": "Write user-level global config",
2685
+ "exclusive": [
2686
+ "local"
2687
+ ],
2688
+ "name": "global",
2689
+ "allowNo": false,
2690
+ "type": "boolean"
2691
+ },
2692
+ "enable": {
2693
+ "description": "Enable tracing (default)",
2694
+ "exclusive": [
2695
+ "disable"
2696
+ ],
2697
+ "name": "enable",
2698
+ "allowNo": false,
2699
+ "type": "boolean"
2700
+ },
2701
+ "disable": {
2702
+ "description": "Disable tracing",
2703
+ "exclusive": [
2704
+ "enable"
2705
+ ],
2706
+ "name": "disable",
2707
+ "allowNo": false,
2708
+ "type": "boolean"
2709
+ },
2710
+ "project-id": {
2711
+ "description": "Respan project ID (added to metadata / resource attributes)",
2712
+ "env": "RESPAN_PROJECT_ID",
2713
+ "name": "project-id",
2655
2714
  "hasDynamicHelp": false,
2656
2715
  "multiple": false,
2657
2716
  "type": "option"
2658
2717
  },
2659
- "end-time": {
2660
- "description": "End time (ISO 8601)",
2661
- "name": "end-time",
2662
- "required": true,
2718
+ "attrs": {
2719
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2720
+ "name": "attrs",
2721
+ "default": "{}",
2663
2722
  "hasDynamicHelp": false,
2664
2723
  "multiple": false,
2665
2724
  "type": "option"
2666
2725
  },
2667
- "filter": {
2668
- "description": "Filter in field:operator:value format (repeatable)",
2669
- "name": "filter",
2726
+ "customer-id": {
2727
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2728
+ "env": "RESPAN_CUSTOMER_ID",
2729
+ "name": "customer-id",
2670
2730
  "hasDynamicHelp": false,
2671
- "multiple": true,
2731
+ "multiple": false,
2672
2732
  "type": "option"
2673
2733
  },
2674
- "all-envs": {
2675
- "description": "Include all environments (true/false)",
2676
- "name": "all-envs",
2734
+ "span-name": {
2735
+ "description": "Root span name for traces (default: claude-code)",
2736
+ "name": "span-name",
2677
2737
  "hasDynamicHelp": false,
2678
2738
  "multiple": false,
2679
2739
  "type": "option"
2680
2740
  },
2681
- "is-test": {
2682
- "description": "Filter by test (true) or production (false) environment",
2683
- "name": "is-test",
2741
+ "workflow-name": {
2742
+ "description": "Workflow name for traces (default: claude-code)",
2743
+ "name": "workflow-name",
2684
2744
  "hasDynamicHelp": false,
2685
2745
  "multiple": false,
2686
2746
  "type": "option"
2747
+ },
2748
+ "dry-run": {
2749
+ "description": "Preview changes without writing files",
2750
+ "name": "dry-run",
2751
+ "allowNo": false,
2752
+ "type": "boolean"
2687
2753
  }
2688
2754
  },
2689
2755
  "hasDynamicHelp": false,
2690
2756
  "hiddenAliases": [],
2691
- "id": "logs:summary",
2757
+ "id": "integrate:gemini-cli",
2692
2758
  "pluginAlias": "@respan/cli",
2693
2759
  "pluginName": "@respan/cli",
2694
2760
  "pluginType": "core",
@@ -2698,20 +2764,21 @@
2698
2764
  "relativePath": [
2699
2765
  "dist",
2700
2766
  "commands",
2701
- "logs",
2702
- "summary.js"
2767
+ "integrate",
2768
+ "gemini-cli.js"
2703
2769
  ]
2704
2770
  },
2705
- "prompts:create-version": {
2771
+ "integrate:opencode": {
2706
2772
  "aliases": [],
2707
- "args": {
2708
- "prompt-id": {
2709
- "description": "Prompt ID",
2710
- "name": "prompt-id",
2711
- "required": true
2712
- }
2713
- },
2714
- "description": "Create a new version of a prompt",
2773
+ "args": {},
2774
+ "description": "Integrate Respan with OpenCode.\n\nOpenCode's built-in OTel does not work reliably, so this uses the\ncommunity opencode-otel plugin instead.\n\nScope:\n --local Write plugin config to project root (default)\n --global Write to ~/.config/opencode/plugins/otel.json\n The opencode-otel package is always installed globally.",
2775
+ "examples": [
2776
+ "respan integrate opencode",
2777
+ "respan integrate opencode --disable",
2778
+ "respan integrate opencode --global",
2779
+ "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
2780
+ "respan integrate opencode --dry-run"
2781
+ ],
2715
2782
  "flags": {
2716
2783
  "api-key": {
2717
2784
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2722,8 +2789,9 @@
2722
2789
  "type": "option"
2723
2790
  },
2724
2791
  "base-url": {
2725
- "description": "Temporary API base URL override for this command",
2792
+ "description": "Respan API base URL (for enterprise deployments)",
2726
2793
  "name": "base-url",
2794
+ "default": "https://api.respan.ai/api",
2727
2795
  "hasDynamicHelp": false,
2728
2796
  "multiple": false,
2729
2797
  "type": "option"
@@ -2754,39 +2822,90 @@
2754
2822
  "allowNo": false,
2755
2823
  "type": "boolean"
2756
2824
  },
2757
- "messages": {
2758
- "description": "Messages as JSON array string",
2759
- "name": "messages",
2760
- "required": true,
2825
+ "local": {
2826
+ "description": "Write per-project config (default)",
2827
+ "exclusive": [
2828
+ "global"
2829
+ ],
2830
+ "name": "local",
2831
+ "allowNo": false,
2832
+ "type": "boolean"
2833
+ },
2834
+ "global": {
2835
+ "description": "Write user-level global config",
2836
+ "exclusive": [
2837
+ "local"
2838
+ ],
2839
+ "name": "global",
2840
+ "allowNo": false,
2841
+ "type": "boolean"
2842
+ },
2843
+ "enable": {
2844
+ "description": "Enable tracing (default)",
2845
+ "exclusive": [
2846
+ "disable"
2847
+ ],
2848
+ "name": "enable",
2849
+ "allowNo": false,
2850
+ "type": "boolean"
2851
+ },
2852
+ "disable": {
2853
+ "description": "Disable tracing",
2854
+ "exclusive": [
2855
+ "enable"
2856
+ ],
2857
+ "name": "disable",
2858
+ "allowNo": false,
2859
+ "type": "boolean"
2860
+ },
2861
+ "project-id": {
2862
+ "description": "Respan project ID (added to metadata / resource attributes)",
2863
+ "env": "RESPAN_PROJECT_ID",
2864
+ "name": "project-id",
2761
2865
  "hasDynamicHelp": false,
2762
2866
  "multiple": false,
2763
2867
  "type": "option"
2764
2868
  },
2765
- "model": {
2766
- "description": "Model name",
2767
- "name": "model",
2869
+ "attrs": {
2870
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2871
+ "name": "attrs",
2872
+ "default": "{}",
2768
2873
  "hasDynamicHelp": false,
2769
2874
  "multiple": false,
2770
2875
  "type": "option"
2771
2876
  },
2772
- "temperature": {
2773
- "description": "Temperature value",
2774
- "name": "temperature",
2877
+ "customer-id": {
2878
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2879
+ "env": "RESPAN_CUSTOMER_ID",
2880
+ "name": "customer-id",
2775
2881
  "hasDynamicHelp": false,
2776
2882
  "multiple": false,
2777
2883
  "type": "option"
2778
2884
  },
2779
- "max-tokens": {
2780
- "description": "Max tokens",
2781
- "name": "max-tokens",
2885
+ "span-name": {
2886
+ "description": "Root span name for traces (default: claude-code)",
2887
+ "name": "span-name",
2888
+ "hasDynamicHelp": false,
2889
+ "multiple": false,
2890
+ "type": "option"
2891
+ },
2892
+ "workflow-name": {
2893
+ "description": "Workflow name for traces (default: claude-code)",
2894
+ "name": "workflow-name",
2782
2895
  "hasDynamicHelp": false,
2783
2896
  "multiple": false,
2784
2897
  "type": "option"
2898
+ },
2899
+ "dry-run": {
2900
+ "description": "Preview changes without writing files",
2901
+ "name": "dry-run",
2902
+ "allowNo": false,
2903
+ "type": "boolean"
2785
2904
  }
2786
2905
  },
2787
2906
  "hasDynamicHelp": false,
2788
2907
  "hiddenAliases": [],
2789
- "id": "prompts:create-version",
2908
+ "id": "integrate:opencode",
2790
2909
  "pluginAlias": "@respan/cli",
2791
2910
  "pluginName": "@respan/cli",
2792
2911
  "pluginType": "core",
@@ -2796,14 +2915,24 @@
2796
2915
  "relativePath": [
2797
2916
  "dist",
2798
2917
  "commands",
2799
- "prompts",
2800
- "create-version.js"
2918
+ "integrate",
2919
+ "opencode.js"
2801
2920
  ]
2802
2921
  },
2803
- "prompts:create": {
2922
+ "integrate:pi": {
2804
2923
  "aliases": [],
2805
2924
  "args": {},
2806
- "description": "Create a new prompt",
2925
+ "description": "Integrate Respan with the pi coding agent (https://pi.dev).\n\nInstalls the @respan/instrumentation-pi pi package — a pi extension that\ntraces every agent run as one turn span per prompt with chat and tool spans underneath,\ncorrelating all runs of a pi session by its session id — and writes a\nnon-secret respan.json config for it.\n\nScope:\n --global pi install npm:@respan/instrumentation-pi + ~/.pi/agent/respan.json (default)\n --local pi install -l npm:@respan/instrumentation-pi + .pi/respan.json in the project root\n\nTrace scope (--trace-scope, \"trace_scope\" in respan.json):\n session one multi-root trace per pi session, across processes and pauses (default)\n run one trace per agent run; runs of a session share a thread id\n\nDurable delivery (--with-collector):\n Sets base_url to a local Respan collector (http://127.0.0.1:4318) so traces\n go through its persistent queue and survive Respan outages. Run\n \"respan collector start\" once per machine.\n\nCredentials are never written to these files: the extension reads\nRESPAN_API_KEY or ~/.respan/credentials.json (from \"respan auth login\").",
2926
+ "examples": [
2927
+ "respan integrate pi",
2928
+ "respan integrate pi --disable",
2929
+ "respan integrate pi --local",
2930
+ "respan integrate pi --customer-id frank --workflow-name email-agent",
2931
+ "respan integrate pi --trace-scope run",
2932
+ "respan integrate pi --with-collector",
2933
+ "respan integrate pi --project-id my-project --attrs '{\"env\":\"prod\"}'",
2934
+ "respan integrate pi --dry-run"
2935
+ ],
2807
2936
  "flags": {
2808
2937
  "api-key": {
2809
2938
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2814,8 +2943,9 @@
2814
2943
  "type": "option"
2815
2944
  },
2816
2945
  "base-url": {
2817
- "description": "Temporary API base URL override for this command",
2946
+ "description": "Respan API base URL (for enterprise deployments)",
2818
2947
  "name": "base-url",
2948
+ "default": "https://api.respan.ai/api",
2819
2949
  "hasDynamicHelp": false,
2820
2950
  "multiple": false,
2821
2951
  "type": "option"
@@ -2846,17 +2976,106 @@
2846
2976
  "allowNo": false,
2847
2977
  "type": "boolean"
2848
2978
  },
2849
- "name": {
2850
- "description": "Prompt name",
2851
- "name": "name",
2852
- "required": true,
2979
+ "local": {
2980
+ "description": "Write per-project config (default)",
2981
+ "exclusive": [
2982
+ "global"
2983
+ ],
2984
+ "name": "local",
2985
+ "allowNo": false,
2986
+ "type": "boolean"
2987
+ },
2988
+ "global": {
2989
+ "description": "Write user-level global config",
2990
+ "exclusive": [
2991
+ "local"
2992
+ ],
2993
+ "name": "global",
2994
+ "allowNo": false,
2995
+ "type": "boolean"
2996
+ },
2997
+ "enable": {
2998
+ "description": "Enable tracing (default)",
2999
+ "exclusive": [
3000
+ "disable"
3001
+ ],
3002
+ "name": "enable",
3003
+ "allowNo": false,
3004
+ "type": "boolean"
3005
+ },
3006
+ "disable": {
3007
+ "description": "Disable tracing",
3008
+ "exclusive": [
3009
+ "enable"
3010
+ ],
3011
+ "name": "disable",
3012
+ "allowNo": false,
3013
+ "type": "boolean"
3014
+ },
3015
+ "project-id": {
3016
+ "description": "Respan project ID (added to metadata / resource attributes)",
3017
+ "env": "RESPAN_PROJECT_ID",
3018
+ "name": "project-id",
2853
3019
  "hasDynamicHelp": false,
2854
3020
  "multiple": false,
2855
3021
  "type": "option"
2856
3022
  },
2857
- "description": {
2858
- "description": "Prompt description",
2859
- "name": "description",
3023
+ "attrs": {
3024
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
3025
+ "name": "attrs",
3026
+ "default": "{}",
3027
+ "hasDynamicHelp": false,
3028
+ "multiple": false,
3029
+ "type": "option"
3030
+ },
3031
+ "customer-id": {
3032
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
3033
+ "env": "RESPAN_CUSTOMER_ID",
3034
+ "name": "customer-id",
3035
+ "hasDynamicHelp": false,
3036
+ "multiple": false,
3037
+ "type": "option"
3038
+ },
3039
+ "span-name": {
3040
+ "description": "Alias of --workflow-name (default: pi)",
3041
+ "name": "span-name",
3042
+ "hasDynamicHelp": false,
3043
+ "multiple": false,
3044
+ "type": "option"
3045
+ },
3046
+ "workflow-name": {
3047
+ "description": "traceloop.workflow.name on pi turn spans (default: pi)",
3048
+ "name": "workflow-name",
3049
+ "hasDynamicHelp": false,
3050
+ "multiple": false,
3051
+ "type": "option"
3052
+ },
3053
+ "dry-run": {
3054
+ "description": "Preview changes without writing files",
3055
+ "name": "dry-run",
3056
+ "allowNo": false,
3057
+ "type": "boolean"
3058
+ },
3059
+ "trace-scope": {
3060
+ "description": "Trace scope: \"session\" = one multi-root trace per pi session (default), \"run\" = one trace per agent run",
3061
+ "name": "trace-scope",
3062
+ "hasDynamicHelp": false,
3063
+ "multiple": false,
3064
+ "options": [
3065
+ "run",
3066
+ "session"
3067
+ ],
3068
+ "type": "option"
3069
+ },
3070
+ "with-collector": {
3071
+ "description": "Send traces through a local Respan collector (respan collector start) for durable delivery",
3072
+ "name": "with-collector",
3073
+ "allowNo": false,
3074
+ "type": "boolean"
3075
+ },
3076
+ "collector-port": {
3077
+ "description": "Port of the local collector, with --with-collector (default: 4318)",
3078
+ "name": "collector-port",
2860
3079
  "hasDynamicHelp": false,
2861
3080
  "multiple": false,
2862
3081
  "type": "option"
@@ -2864,7 +3083,7 @@
2864
3083
  },
2865
3084
  "hasDynamicHelp": false,
2866
3085
  "hiddenAliases": [],
2867
- "id": "prompts:create",
3086
+ "id": "integrate:pi",
2868
3087
  "pluginAlias": "@respan/cli",
2869
3088
  "pluginName": "@respan/cli",
2870
3089
  "pluginType": "core",
@@ -2874,20 +3093,20 @@
2874
3093
  "relativePath": [
2875
3094
  "dist",
2876
3095
  "commands",
2877
- "prompts",
2878
- "create.js"
3096
+ "integrate",
3097
+ "pi.js"
2879
3098
  ]
2880
3099
  },
2881
- "prompts:get": {
3100
+ "prompts:create-version": {
2882
3101
  "aliases": [],
2883
3102
  "args": {
2884
- "id": {
3103
+ "prompt-id": {
2885
3104
  "description": "Prompt ID",
2886
- "name": "id",
3105
+ "name": "prompt-id",
2887
3106
  "required": true
2888
3107
  }
2889
3108
  },
2890
- "description": "Get a specific prompt",
3109
+ "description": "Create a new version of a prompt",
2891
3110
  "flags": {
2892
3111
  "api-key": {
2893
3112
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2929,11 +3148,40 @@
2929
3148
  "name": "verbose",
2930
3149
  "allowNo": false,
2931
3150
  "type": "boolean"
3151
+ },
3152
+ "messages": {
3153
+ "description": "Messages as JSON array string",
3154
+ "name": "messages",
3155
+ "required": true,
3156
+ "hasDynamicHelp": false,
3157
+ "multiple": false,
3158
+ "type": "option"
3159
+ },
3160
+ "model": {
3161
+ "description": "Model name",
3162
+ "name": "model",
3163
+ "hasDynamicHelp": false,
3164
+ "multiple": false,
3165
+ "type": "option"
3166
+ },
3167
+ "temperature": {
3168
+ "description": "Temperature value",
3169
+ "name": "temperature",
3170
+ "hasDynamicHelp": false,
3171
+ "multiple": false,
3172
+ "type": "option"
3173
+ },
3174
+ "max-tokens": {
3175
+ "description": "Max tokens",
3176
+ "name": "max-tokens",
3177
+ "hasDynamicHelp": false,
3178
+ "multiple": false,
3179
+ "type": "option"
2932
3180
  }
2933
3181
  },
2934
3182
  "hasDynamicHelp": false,
2935
3183
  "hiddenAliases": [],
2936
- "id": "prompts:get",
3184
+ "id": "prompts:create-version",
2937
3185
  "pluginAlias": "@respan/cli",
2938
3186
  "pluginName": "@respan/cli",
2939
3187
  "pluginType": "core",
@@ -2944,13 +3192,13 @@
2944
3192
  "dist",
2945
3193
  "commands",
2946
3194
  "prompts",
2947
- "get.js"
3195
+ "create-version.js"
2948
3196
  ]
2949
3197
  },
2950
- "prompts:list": {
3198
+ "prompts:create": {
2951
3199
  "aliases": [],
2952
3200
  "args": {},
2953
- "description": "List prompts",
3201
+ "description": "Create a new prompt",
2954
3202
  "flags": {
2955
3203
  "api-key": {
2956
3204
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2993,10 +3241,17 @@
2993
3241
  "allowNo": false,
2994
3242
  "type": "boolean"
2995
3243
  },
2996
- "limit": {
2997
- "description": "Number of results per page",
2998
- "name": "limit",
2999
- "default": 50,
3244
+ "name": {
3245
+ "description": "Prompt name",
3246
+ "name": "name",
3247
+ "required": true,
3248
+ "hasDynamicHelp": false,
3249
+ "multiple": false,
3250
+ "type": "option"
3251
+ },
3252
+ "description": {
3253
+ "description": "Prompt description",
3254
+ "name": "description",
3000
3255
  "hasDynamicHelp": false,
3001
3256
  "multiple": false,
3002
3257
  "type": "option"
@@ -3004,7 +3259,7 @@
3004
3259
  },
3005
3260
  "hasDynamicHelp": false,
3006
3261
  "hiddenAliases": [],
3007
- "id": "prompts:list",
3262
+ "id": "prompts:create",
3008
3263
  "pluginAlias": "@respan/cli",
3009
3264
  "pluginName": "@respan/cli",
3010
3265
  "pluginType": "core",
@@ -3015,10 +3270,10 @@
3015
3270
  "dist",
3016
3271
  "commands",
3017
3272
  "prompts",
3018
- "list.js"
3273
+ "create.js"
3019
3274
  ]
3020
3275
  },
3021
- "prompts:update": {
3276
+ "prompts:get": {
3022
3277
  "aliases": [],
3023
3278
  "args": {
3024
3279
  "id": {
@@ -3027,7 +3282,7 @@
3027
3282
  "required": true
3028
3283
  }
3029
3284
  },
3030
- "description": "Update a prompt",
3285
+ "description": "Get a specific prompt",
3031
3286
  "flags": {
3032
3287
  "api-key": {
3033
3288
  "description": "API key (env: RESPAN_API_KEY)",
@@ -3069,25 +3324,11 @@
3069
3324
  "name": "verbose",
3070
3325
  "allowNo": false,
3071
3326
  "type": "boolean"
3072
- },
3073
- "name": {
3074
- "description": "Prompt name",
3075
- "name": "name",
3076
- "hasDynamicHelp": false,
3077
- "multiple": false,
3078
- "type": "option"
3079
- },
3080
- "description": {
3081
- "description": "Prompt description",
3082
- "name": "description",
3083
- "hasDynamicHelp": false,
3084
- "multiple": false,
3085
- "type": "option"
3086
3327
  }
3087
3328
  },
3088
3329
  "hasDynamicHelp": false,
3089
3330
  "hiddenAliases": [],
3090
- "id": "prompts:update",
3331
+ "id": "prompts:get",
3091
3332
  "pluginAlias": "@respan/cli",
3092
3333
  "pluginName": "@respan/cli",
3093
3334
  "pluginType": "core",
@@ -3098,19 +3339,173 @@
3098
3339
  "dist",
3099
3340
  "commands",
3100
3341
  "prompts",
3101
- "update.js"
3342
+ "get.js"
3102
3343
  ]
3103
3344
  },
3104
- "prompts:versions": {
3345
+ "prompts:list": {
3105
3346
  "aliases": [],
3106
- "args": {
3107
- "prompt-id": {
3108
- "description": "Prompt ID",
3109
- "name": "prompt-id",
3110
- "required": true
3111
- }
3112
- },
3113
- "description": "List versions of a prompt",
3347
+ "args": {},
3348
+ "description": "List prompts",
3349
+ "flags": {
3350
+ "api-key": {
3351
+ "description": "API key (env: RESPAN_API_KEY)",
3352
+ "env": "RESPAN_API_KEY",
3353
+ "name": "api-key",
3354
+ "hasDynamicHelp": false,
3355
+ "multiple": false,
3356
+ "type": "option"
3357
+ },
3358
+ "base-url": {
3359
+ "description": "Temporary API base URL override for this command",
3360
+ "name": "base-url",
3361
+ "hasDynamicHelp": false,
3362
+ "multiple": false,
3363
+ "type": "option"
3364
+ },
3365
+ "profile": {
3366
+ "description": "Named profile to use",
3367
+ "name": "profile",
3368
+ "hasDynamicHelp": false,
3369
+ "multiple": false,
3370
+ "type": "option"
3371
+ },
3372
+ "json": {
3373
+ "description": "Output as JSON",
3374
+ "name": "json",
3375
+ "allowNo": false,
3376
+ "type": "boolean"
3377
+ },
3378
+ "csv": {
3379
+ "description": "Output as CSV",
3380
+ "name": "csv",
3381
+ "allowNo": false,
3382
+ "type": "boolean"
3383
+ },
3384
+ "verbose": {
3385
+ "char": "v",
3386
+ "description": "Show verbose output",
3387
+ "name": "verbose",
3388
+ "allowNo": false,
3389
+ "type": "boolean"
3390
+ },
3391
+ "limit": {
3392
+ "description": "Number of results per page",
3393
+ "name": "limit",
3394
+ "default": 50,
3395
+ "hasDynamicHelp": false,
3396
+ "multiple": false,
3397
+ "type": "option"
3398
+ }
3399
+ },
3400
+ "hasDynamicHelp": false,
3401
+ "hiddenAliases": [],
3402
+ "id": "prompts:list",
3403
+ "pluginAlias": "@respan/cli",
3404
+ "pluginName": "@respan/cli",
3405
+ "pluginType": "core",
3406
+ "strict": true,
3407
+ "enableJsonFlag": false,
3408
+ "isESM": true,
3409
+ "relativePath": [
3410
+ "dist",
3411
+ "commands",
3412
+ "prompts",
3413
+ "list.js"
3414
+ ]
3415
+ },
3416
+ "prompts:update": {
3417
+ "aliases": [],
3418
+ "args": {
3419
+ "id": {
3420
+ "description": "Prompt ID",
3421
+ "name": "id",
3422
+ "required": true
3423
+ }
3424
+ },
3425
+ "description": "Update a prompt",
3426
+ "flags": {
3427
+ "api-key": {
3428
+ "description": "API key (env: RESPAN_API_KEY)",
3429
+ "env": "RESPAN_API_KEY",
3430
+ "name": "api-key",
3431
+ "hasDynamicHelp": false,
3432
+ "multiple": false,
3433
+ "type": "option"
3434
+ },
3435
+ "base-url": {
3436
+ "description": "Temporary API base URL override for this command",
3437
+ "name": "base-url",
3438
+ "hasDynamicHelp": false,
3439
+ "multiple": false,
3440
+ "type": "option"
3441
+ },
3442
+ "profile": {
3443
+ "description": "Named profile to use",
3444
+ "name": "profile",
3445
+ "hasDynamicHelp": false,
3446
+ "multiple": false,
3447
+ "type": "option"
3448
+ },
3449
+ "json": {
3450
+ "description": "Output as JSON",
3451
+ "name": "json",
3452
+ "allowNo": false,
3453
+ "type": "boolean"
3454
+ },
3455
+ "csv": {
3456
+ "description": "Output as CSV",
3457
+ "name": "csv",
3458
+ "allowNo": false,
3459
+ "type": "boolean"
3460
+ },
3461
+ "verbose": {
3462
+ "char": "v",
3463
+ "description": "Show verbose output",
3464
+ "name": "verbose",
3465
+ "allowNo": false,
3466
+ "type": "boolean"
3467
+ },
3468
+ "name": {
3469
+ "description": "Prompt name",
3470
+ "name": "name",
3471
+ "hasDynamicHelp": false,
3472
+ "multiple": false,
3473
+ "type": "option"
3474
+ },
3475
+ "description": {
3476
+ "description": "Prompt description",
3477
+ "name": "description",
3478
+ "hasDynamicHelp": false,
3479
+ "multiple": false,
3480
+ "type": "option"
3481
+ }
3482
+ },
3483
+ "hasDynamicHelp": false,
3484
+ "hiddenAliases": [],
3485
+ "id": "prompts:update",
3486
+ "pluginAlias": "@respan/cli",
3487
+ "pluginName": "@respan/cli",
3488
+ "pluginType": "core",
3489
+ "strict": true,
3490
+ "enableJsonFlag": false,
3491
+ "isESM": true,
3492
+ "relativePath": [
3493
+ "dist",
3494
+ "commands",
3495
+ "prompts",
3496
+ "update.js"
3497
+ ]
3498
+ },
3499
+ "prompts:versions": {
3500
+ "aliases": [],
3501
+ "args": {
3502
+ "prompt-id": {
3503
+ "description": "Prompt ID",
3504
+ "name": "prompt-id",
3505
+ "required": true
3506
+ }
3507
+ },
3508
+ "description": "List versions of a prompt",
3114
3509
  "flags": {
3115
3510
  "api-key": {
3116
3511
  "description": "API key (env: RESPAN_API_KEY)",
@@ -4108,18 +4503,10 @@
4108
4503
  "update.js"
4109
4504
  ]
4110
4505
  },
4111
- "integrate:claude-code": {
4506
+ "logs:create": {
4112
4507
  "aliases": [],
4113
4508
  "args": {},
4114
- "description": "Integrate Respan with Claude Code.\n\nInstalls a Stop hook that reads conversation transcripts and sends\nthem to Respan as structured spans (chat, tool, thinking).\n\nScope:\n --global Install hook script + register in ~/.claude/settings.json\n --local Write credentials + enable flag to .claude/settings.local.json\n\nDefault behavior installs the global hook and writes local project config.",
4115
- "examples": [
4116
- "respan integrate claude-code",
4117
- "respan integrate claude-code --disable",
4118
- "respan integrate claude-code --global",
4119
- "respan integrate claude-code --local --project-id my-project",
4120
- "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
4121
- "respan integrate claude-code --dry-run"
4122
- ],
4509
+ "description": "Create a log span",
4123
4510
  "flags": {
4124
4511
  "api-key": {
4125
4512
  "description": "API key (env: RESPAN_API_KEY)",
@@ -4130,9 +4517,8 @@
4130
4517
  "type": "option"
4131
4518
  },
4132
4519
  "base-url": {
4133
- "description": "Respan API base URL (for enterprise deployments)",
4520
+ "description": "Temporary API base URL override for this command",
4134
4521
  "name": "base-url",
4135
- "default": "https://api.respan.ai/api",
4136
4522
  "hasDynamicHelp": false,
4137
4523
  "multiple": false,
4138
4524
  "type": "option"
@@ -4163,90 +4549,39 @@
4163
4549
  "allowNo": false,
4164
4550
  "type": "boolean"
4165
4551
  },
4166
- "local": {
4167
- "description": "Write per-project config (default)",
4168
- "exclusive": [
4169
- "global"
4170
- ],
4171
- "name": "local",
4172
- "allowNo": false,
4173
- "type": "boolean"
4174
- },
4175
- "global": {
4176
- "description": "Write user-level global config",
4177
- "exclusive": [
4178
- "local"
4179
- ],
4180
- "name": "global",
4181
- "allowNo": false,
4182
- "type": "boolean"
4183
- },
4184
- "enable": {
4185
- "description": "Enable tracing (default)",
4186
- "exclusive": [
4187
- "disable"
4188
- ],
4189
- "name": "enable",
4190
- "allowNo": false,
4191
- "type": "boolean"
4192
- },
4193
- "disable": {
4194
- "description": "Disable tracing",
4195
- "exclusive": [
4196
- "enable"
4197
- ],
4198
- "name": "disable",
4199
- "allowNo": false,
4200
- "type": "boolean"
4201
- },
4202
- "project-id": {
4203
- "description": "Respan project ID (added to metadata / resource attributes)",
4204
- "env": "RESPAN_PROJECT_ID",
4205
- "name": "project-id",
4206
- "hasDynamicHelp": false,
4207
- "multiple": false,
4208
- "type": "option"
4209
- },
4210
- "attrs": {
4211
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
4212
- "name": "attrs",
4213
- "default": "{}",
4552
+ "input": {
4553
+ "description": "Input text or JSON",
4554
+ "name": "input",
4555
+ "required": true,
4214
4556
  "hasDynamicHelp": false,
4215
4557
  "multiple": false,
4216
4558
  "type": "option"
4217
4559
  },
4218
- "customer-id": {
4219
- "description": "Customer/user identifier for traces (e.g. your name or email)",
4220
- "env": "RESPAN_CUSTOMER_ID",
4221
- "name": "customer-id",
4560
+ "output": {
4561
+ "description": "Output text or JSON",
4562
+ "name": "output",
4222
4563
  "hasDynamicHelp": false,
4223
4564
  "multiple": false,
4224
4565
  "type": "option"
4225
4566
  },
4226
- "span-name": {
4227
- "description": "Root span name for traces (default: claude-code)",
4228
- "name": "span-name",
4567
+ "model": {
4568
+ "description": "Model name",
4569
+ "name": "model",
4229
4570
  "hasDynamicHelp": false,
4230
4571
  "multiple": false,
4231
4572
  "type": "option"
4232
4573
  },
4233
- "workflow-name": {
4234
- "description": "Workflow name for traces (default: claude-code)",
4235
- "name": "workflow-name",
4574
+ "metadata": {
4575
+ "description": "Metadata as JSON string",
4576
+ "name": "metadata",
4236
4577
  "hasDynamicHelp": false,
4237
4578
  "multiple": false,
4238
4579
  "type": "option"
4239
- },
4240
- "dry-run": {
4241
- "description": "Preview changes without writing files",
4242
- "name": "dry-run",
4243
- "allowNo": false,
4244
- "type": "boolean"
4245
4580
  }
4246
4581
  },
4247
4582
  "hasDynamicHelp": false,
4248
4583
  "hiddenAliases": [],
4249
- "id": "integrate:claude-code",
4584
+ "id": "logs:create",
4250
4585
  "pluginAlias": "@respan/cli",
4251
4586
  "pluginName": "@respan/cli",
4252
4587
  "pluginType": "core",
@@ -4256,173 +4591,20 @@
4256
4591
  "relativePath": [
4257
4592
  "dist",
4258
4593
  "commands",
4259
- "integrate",
4260
- "claude-code.js"
4594
+ "logs",
4595
+ "create.js"
4261
4596
  ]
4262
4597
  },
4263
- "integrate:codex-cli": {
4598
+ "logs:get": {
4264
4599
  "aliases": [],
4265
- "args": {},
4266
- "description": "Integrate Respan with Codex CLI.\n\nInstalls a notify hook that reads session JSONL files and sends\nthem to Respan as structured spans (chat, tool, reasoning).\n\nScope:\n --global Install hook script + register notify in ~/.codex/config.toml\n --local Write .codex/respan.json with customer_id, span_name, etc.\n\nDefault behavior installs the global notify hook and writes local project config.",
4267
- "examples": [
4268
- "respan integrate codex-cli",
4269
- "respan integrate codex-cli --disable",
4270
- "respan integrate codex-cli --global",
4271
- "respan integrate codex-cli --local --customer-id frank",
4272
- "respan integrate codex-cli --attrs '{\"env\":\"prod\"}'",
4273
- "respan integrate codex-cli --dry-run"
4274
- ],
4275
- "flags": {
4276
- "api-key": {
4277
- "description": "API key (env: RESPAN_API_KEY)",
4278
- "env": "RESPAN_API_KEY",
4279
- "name": "api-key",
4280
- "hasDynamicHelp": false,
4281
- "multiple": false,
4282
- "type": "option"
4283
- },
4284
- "base-url": {
4285
- "description": "Respan API base URL (for enterprise deployments)",
4286
- "name": "base-url",
4287
- "default": "https://api.respan.ai/api",
4288
- "hasDynamicHelp": false,
4289
- "multiple": false,
4290
- "type": "option"
4291
- },
4292
- "profile": {
4293
- "description": "Named profile to use",
4294
- "name": "profile",
4295
- "hasDynamicHelp": false,
4296
- "multiple": false,
4297
- "type": "option"
4298
- },
4299
- "json": {
4300
- "description": "Output as JSON",
4301
- "name": "json",
4302
- "allowNo": false,
4303
- "type": "boolean"
4304
- },
4305
- "csv": {
4306
- "description": "Output as CSV",
4307
- "name": "csv",
4308
- "allowNo": false,
4309
- "type": "boolean"
4310
- },
4311
- "verbose": {
4312
- "char": "v",
4313
- "description": "Show verbose output",
4314
- "name": "verbose",
4315
- "allowNo": false,
4316
- "type": "boolean"
4317
- },
4318
- "local": {
4319
- "description": "Write per-project config (default)",
4320
- "exclusive": [
4321
- "global"
4322
- ],
4323
- "name": "local",
4324
- "allowNo": false,
4325
- "type": "boolean"
4326
- },
4327
- "global": {
4328
- "description": "Write user-level global config",
4329
- "exclusive": [
4330
- "local"
4331
- ],
4332
- "name": "global",
4333
- "allowNo": false,
4334
- "type": "boolean"
4335
- },
4336
- "enable": {
4337
- "description": "Enable tracing (default)",
4338
- "exclusive": [
4339
- "disable"
4340
- ],
4341
- "name": "enable",
4342
- "allowNo": false,
4343
- "type": "boolean"
4344
- },
4345
- "disable": {
4346
- "description": "Disable tracing",
4347
- "exclusive": [
4348
- "enable"
4349
- ],
4350
- "name": "disable",
4351
- "allowNo": false,
4352
- "type": "boolean"
4353
- },
4354
- "project-id": {
4355
- "description": "Respan project ID (added to metadata / resource attributes)",
4356
- "env": "RESPAN_PROJECT_ID",
4357
- "name": "project-id",
4358
- "hasDynamicHelp": false,
4359
- "multiple": false,
4360
- "type": "option"
4361
- },
4362
- "attrs": {
4363
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
4364
- "name": "attrs",
4365
- "default": "{}",
4366
- "hasDynamicHelp": false,
4367
- "multiple": false,
4368
- "type": "option"
4369
- },
4370
- "customer-id": {
4371
- "description": "Customer/user identifier for traces (e.g. your name or email)",
4372
- "env": "RESPAN_CUSTOMER_ID",
4373
- "name": "customer-id",
4374
- "hasDynamicHelp": false,
4375
- "multiple": false,
4376
- "type": "option"
4377
- },
4378
- "span-name": {
4379
- "description": "Root span name for traces (default: claude-code)",
4380
- "name": "span-name",
4381
- "hasDynamicHelp": false,
4382
- "multiple": false,
4383
- "type": "option"
4384
- },
4385
- "workflow-name": {
4386
- "description": "Workflow name for traces (default: claude-code)",
4387
- "name": "workflow-name",
4388
- "hasDynamicHelp": false,
4389
- "multiple": false,
4390
- "type": "option"
4391
- },
4392
- "dry-run": {
4393
- "description": "Preview changes without writing files",
4394
- "name": "dry-run",
4395
- "allowNo": false,
4396
- "type": "boolean"
4600
+ "args": {
4601
+ "id": {
4602
+ "description": "Span ID",
4603
+ "name": "id",
4604
+ "required": true
4397
4605
  }
4398
4606
  },
4399
- "hasDynamicHelp": false,
4400
- "hiddenAliases": [],
4401
- "id": "integrate:codex-cli",
4402
- "pluginAlias": "@respan/cli",
4403
- "pluginName": "@respan/cli",
4404
- "pluginType": "core",
4405
- "strict": true,
4406
- "enableJsonFlag": false,
4407
- "isESM": true,
4408
- "relativePath": [
4409
- "dist",
4410
- "commands",
4411
- "integrate",
4412
- "codex-cli.js"
4413
- ]
4414
- },
4415
- "integrate:gemini-cli": {
4416
- "aliases": [],
4417
- "args": {},
4418
- "description": "Integrate Respan with Gemini CLI.\n\nInstalls an AfterModel hook that captures LLM request/response data\nand sends it to Respan as structured spans with model, token counts,\nand input/output.\n\nScope:\n --global Write to ~/.gemini/settings.json (default)\n --local Write to .gemini/settings.json in project root\n\nGemini CLI ignores workspace-level telemetry settings, so --global is the default.",
4419
- "examples": [
4420
- "respan integrate gemini-cli",
4421
- "respan integrate gemini-cli --disable",
4422
- "respan integrate gemini-cli --local",
4423
- "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
4424
- "respan integrate gemini-cli --dry-run"
4425
- ],
4607
+ "description": "Get a specific log span",
4426
4608
  "flags": {
4427
4609
  "api-key": {
4428
4610
  "description": "API key (env: RESPAN_API_KEY)",
@@ -4433,9 +4615,8 @@
4433
4615
  "type": "option"
4434
4616
  },
4435
4617
  "base-url": {
4436
- "description": "Respan API base URL (for enterprise deployments)",
4618
+ "description": "Temporary API base URL override for this command",
4437
4619
  "name": "base-url",
4438
- "default": "https://api.respan.ai/api",
4439
4620
  "hasDynamicHelp": false,
4440
4621
  "multiple": false,
4441
4622
  "type": "option"
@@ -4457,99 +4638,19 @@
4457
4638
  "description": "Output as CSV",
4458
4639
  "name": "csv",
4459
4640
  "allowNo": false,
4460
- "type": "boolean"
4461
- },
4462
- "verbose": {
4463
- "char": "v",
4464
- "description": "Show verbose output",
4465
- "name": "verbose",
4466
- "allowNo": false,
4467
- "type": "boolean"
4468
- },
4469
- "local": {
4470
- "description": "Write per-project config (default)",
4471
- "exclusive": [
4472
- "global"
4473
- ],
4474
- "name": "local",
4475
- "allowNo": false,
4476
- "type": "boolean"
4477
- },
4478
- "global": {
4479
- "description": "Write user-level global config",
4480
- "exclusive": [
4481
- "local"
4482
- ],
4483
- "name": "global",
4484
- "allowNo": false,
4485
- "type": "boolean"
4486
- },
4487
- "enable": {
4488
- "description": "Enable tracing (default)",
4489
- "exclusive": [
4490
- "disable"
4491
- ],
4492
- "name": "enable",
4493
- "allowNo": false,
4494
- "type": "boolean"
4495
- },
4496
- "disable": {
4497
- "description": "Disable tracing",
4498
- "exclusive": [
4499
- "enable"
4500
- ],
4501
- "name": "disable",
4502
- "allowNo": false,
4503
- "type": "boolean"
4504
- },
4505
- "project-id": {
4506
- "description": "Respan project ID (added to metadata / resource attributes)",
4507
- "env": "RESPAN_PROJECT_ID",
4508
- "name": "project-id",
4509
- "hasDynamicHelp": false,
4510
- "multiple": false,
4511
- "type": "option"
4512
- },
4513
- "attrs": {
4514
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
4515
- "name": "attrs",
4516
- "default": "{}",
4517
- "hasDynamicHelp": false,
4518
- "multiple": false,
4519
- "type": "option"
4520
- },
4521
- "customer-id": {
4522
- "description": "Customer/user identifier for traces (e.g. your name or email)",
4523
- "env": "RESPAN_CUSTOMER_ID",
4524
- "name": "customer-id",
4525
- "hasDynamicHelp": false,
4526
- "multiple": false,
4527
- "type": "option"
4528
- },
4529
- "span-name": {
4530
- "description": "Root span name for traces (default: claude-code)",
4531
- "name": "span-name",
4532
- "hasDynamicHelp": false,
4533
- "multiple": false,
4534
- "type": "option"
4535
- },
4536
- "workflow-name": {
4537
- "description": "Workflow name for traces (default: claude-code)",
4538
- "name": "workflow-name",
4539
- "hasDynamicHelp": false,
4540
- "multiple": false,
4541
- "type": "option"
4641
+ "type": "boolean"
4542
4642
  },
4543
- "dry-run": {
4544
- "description": "Preview changes without writing files",
4545
- "name": "dry-run",
4643
+ "verbose": {
4644
+ "char": "v",
4645
+ "description": "Show verbose output",
4646
+ "name": "verbose",
4546
4647
  "allowNo": false,
4547
4648
  "type": "boolean"
4548
4649
  }
4549
4650
  },
4550
4651
  "hasDynamicHelp": false,
4551
4652
  "hiddenAliases": [],
4552
- "id": "integrate:gemini-cli",
4653
+ "id": "logs:get",
4553
4654
  "pluginAlias": "@respan/cli",
4554
4655
  "pluginName": "@respan/cli",
4555
4656
  "pluginType": "core",
@@ -4559,21 +4660,14 @@
4559
4660
  "relativePath": [
4560
4661
  "dist",
4561
4662
  "commands",
4562
- "integrate",
4563
- "gemini-cli.js"
4663
+ "logs",
4664
+ "get.js"
4564
4665
  ]
4565
4666
  },
4566
- "integrate:opencode": {
4667
+ "logs:list": {
4567
4668
  "aliases": [],
4568
4669
  "args": {},
4569
- "description": "Integrate Respan with OpenCode.\n\nOpenCode's built-in OTel does not work reliably, so this uses the\ncommunity opencode-otel plugin instead.\n\nScope:\n --local Write plugin config to project root (default)\n --global Write to ~/.config/opencode/plugins/otel.json\n The opencode-otel package is always installed globally.",
4570
- "examples": [
4571
- "respan integrate opencode",
4572
- "respan integrate opencode --disable",
4573
- "respan integrate opencode --global",
4574
- "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
4575
- "respan integrate opencode --dry-run"
4576
- ],
4670
+ "description": "List and filter LLM request logs (spans).\n\nSupports pagination, sorting, time range, and server-side filtering.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n (empty) Exact match model::gpt-4\n not Not equal status_code:not:200\n gt Greater than cost:gt:0.01\n gte Greater than/equal latency:gte:1.0\n lt Less than cost:lt:0.5\n lte Less than/equal prompt_tokens:lte:100\n contains Contains substring error_message:contains:timeout\n icontains Case-insensitive model:icontains:gpt\n startswith Starts with model:startswith:gpt\n endswith Ends with model:endswith:mini\n in Value in list model:in:gpt-4,gpt-4o\n isnull Is null error_message:isnull:true\n iexact Case-insens. exact status:iexact:success\n\nFILTERABLE FIELDS (logs):\n model, status_code, status, cost, latency, prompt_tokens,\n completion_tokens, customer_identifier, custom_identifier,\n thread_identifier, trace_unique_id, span_name, span_workflow_name,\n environment, log_type, error_message, failed, provider_id,\n deployment_name, prompt_name, prompt_id, unique_id, stream,\n temperature, max_tokens, tokens_per_second, time_to_first_token,\n total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o",
4577
4671
  "flags": {
4578
4672
  "api-key": {
4579
4673
  "description": "API key (env: RESPAN_API_KEY)",
@@ -4584,9 +4678,8 @@
4584
4678
  "type": "option"
4585
4679
  },
4586
4680
  "base-url": {
4587
- "description": "Respan API base URL (for enterprise deployments)",
4681
+ "description": "Temporary API base URL override for this command",
4588
4682
  "name": "base-url",
4589
- "default": "https://api.respan.ai/api",
4590
4683
  "hasDynamicHelp": false,
4591
4684
  "multiple": false,
4592
4685
  "type": "option"
@@ -4617,90 +4710,75 @@
4617
4710
  "allowNo": false,
4618
4711
  "type": "boolean"
4619
4712
  },
4620
- "local": {
4621
- "description": "Write per-project config (default)",
4622
- "exclusive": [
4623
- "global"
4624
- ],
4625
- "name": "local",
4626
- "allowNo": false,
4627
- "type": "boolean"
4628
- },
4629
- "global": {
4630
- "description": "Write user-level global config",
4631
- "exclusive": [
4632
- "local"
4633
- ],
4634
- "name": "global",
4635
- "allowNo": false,
4636
- "type": "boolean"
4637
- },
4638
- "enable": {
4639
- "description": "Enable tracing (default)",
4640
- "exclusive": [
4641
- "disable"
4642
- ],
4643
- "name": "enable",
4644
- "allowNo": false,
4645
- "type": "boolean"
4713
+ "limit": {
4714
+ "description": "Number of results per page (max 1000)",
4715
+ "name": "limit",
4716
+ "default": 50,
4717
+ "hasDynamicHelp": false,
4718
+ "multiple": false,
4719
+ "type": "option"
4646
4720
  },
4647
- "disable": {
4648
- "description": "Disable tracing",
4649
- "exclusive": [
4650
- "enable"
4651
- ],
4652
- "name": "disable",
4653
- "allowNo": false,
4654
- "type": "boolean"
4721
+ "page": {
4722
+ "description": "Page number",
4723
+ "name": "page",
4724
+ "default": 1,
4725
+ "hasDynamicHelp": false,
4726
+ "multiple": false,
4727
+ "type": "option"
4655
4728
  },
4656
- "project-id": {
4657
- "description": "Respan project ID (added to metadata / resource attributes)",
4658
- "env": "RESPAN_PROJECT_ID",
4659
- "name": "project-id",
4729
+ "sort-by": {
4730
+ "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
4731
+ "name": "sort-by",
4660
4732
  "hasDynamicHelp": false,
4661
4733
  "multiple": false,
4662
4734
  "type": "option"
4663
4735
  },
4664
- "attrs": {
4665
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
4666
- "name": "attrs",
4667
- "default": "{}",
4736
+ "start-time": {
4737
+ "description": "Start time filter (ISO 8601)",
4738
+ "name": "start-time",
4668
4739
  "hasDynamicHelp": false,
4669
4740
  "multiple": false,
4670
4741
  "type": "option"
4671
4742
  },
4672
- "customer-id": {
4673
- "description": "Customer/user identifier for traces (e.g. your name or email)",
4674
- "env": "RESPAN_CUSTOMER_ID",
4675
- "name": "customer-id",
4743
+ "end-time": {
4744
+ "description": "End time filter (ISO 8601)",
4745
+ "name": "end-time",
4676
4746
  "hasDynamicHelp": false,
4677
4747
  "multiple": false,
4678
4748
  "type": "option"
4679
4749
  },
4680
- "span-name": {
4681
- "description": "Root span name for traces (default: claude-code)",
4682
- "name": "span-name",
4750
+ "filter": {
4751
+ "description": "Filter in field:operator:value format (repeatable)",
4752
+ "name": "filter",
4753
+ "hasDynamicHelp": false,
4754
+ "multiple": true,
4755
+ "type": "option"
4756
+ },
4757
+ "all-envs": {
4758
+ "description": "Include all environments (true/false)",
4759
+ "name": "all-envs",
4683
4760
  "hasDynamicHelp": false,
4684
4761
  "multiple": false,
4685
4762
  "type": "option"
4686
4763
  },
4687
- "workflow-name": {
4688
- "description": "Workflow name for traces (default: claude-code)",
4689
- "name": "workflow-name",
4764
+ "is-test": {
4765
+ "description": "Filter by test (true) or production (false) environment",
4766
+ "name": "is-test",
4690
4767
  "hasDynamicHelp": false,
4691
4768
  "multiple": false,
4692
4769
  "type": "option"
4693
4770
  },
4694
- "dry-run": {
4695
- "description": "Preview changes without writing files",
4696
- "name": "dry-run",
4697
- "allowNo": false,
4698
- "type": "boolean"
4771
+ "include-fields": {
4772
+ "description": "Comma-separated fields to include in response",
4773
+ "name": "include-fields",
4774
+ "hasDynamicHelp": false,
4775
+ "multiple": false,
4776
+ "type": "option"
4699
4777
  }
4700
4778
  },
4701
4779
  "hasDynamicHelp": false,
4702
4780
  "hiddenAliases": [],
4703
- "id": "integrate:opencode",
4781
+ "id": "logs:list",
4704
4782
  "pluginAlias": "@respan/cli",
4705
4783
  "pluginName": "@respan/cli",
4706
4784
  "pluginType": "core",
@@ -4710,24 +4788,14 @@
4710
4788
  "relativePath": [
4711
4789
  "dist",
4712
4790
  "commands",
4713
- "integrate",
4714
- "opencode.js"
4791
+ "logs",
4792
+ "list.js"
4715
4793
  ]
4716
4794
  },
4717
- "integrate:pi": {
4795
+ "logs:summary": {
4718
4796
  "aliases": [],
4719
4797
  "args": {},
4720
- "description": "Integrate Respan with the pi coding agent (https://pi.dev).\n\nInstalls the @respan/instrumentation-pi pi package — a pi extension that\ntraces every agent run as one turn span per prompt with chat and tool spans underneath,\ncorrelating all runs of a pi session by its session id — and writes a\nnon-secret respan.json config for it.\n\nScope:\n --global pi install npm:@respan/instrumentation-pi + ~/.pi/agent/respan.json (default)\n --local pi install -l npm:@respan/instrumentation-pi + .pi/respan.json in the project root\n\nTrace scope (--trace-scope, \"trace_scope\" in respan.json):\n run one trace per agent run; runs of a session share a thread id (default)\n session one multi-root trace per pi session (long-lived, resumed sessions)\n\nDurable delivery (--with-collector):\n Sets base_url to a local Respan collector (http://127.0.0.1:4318) so traces\n go through its persistent queue and survive Respan outages. Run\n \"respan collector start\" once per machine.\n\nCredentials are never written to these files: the extension reads\nRESPAN_API_KEY or ~/.respan/credentials.json (from \"respan auth login\").",
4721
- "examples": [
4722
- "respan integrate pi",
4723
- "respan integrate pi --disable",
4724
- "respan integrate pi --local",
4725
- "respan integrate pi --customer-id frank --workflow-name email-agent",
4726
- "respan integrate pi --trace-scope session",
4727
- "respan integrate pi --with-collector",
4728
- "respan integrate pi --project-id my-project --attrs '{\"env\":\"prod\"}'",
4729
- "respan integrate pi --dry-run"
4730
- ],
4798
+ "description": "Get aggregated summary statistics for log spans in a time range.\n\nReturns total cost, total tokens, request count, and score summaries.\n\nFILTER SYNTAX: field:operator:value\n\nOPERATORS:\n (empty) Exact match model::gpt-4\n not Not equal status_code:not:200\n gt Greater than cost:gt:0.01\n gte Greater than/equal latency:gte:1.0\n lt Less than cost:lt:0.5\n lte Less than/equal prompt_tokens:lte:100\n contains Contains substring error_message:contains:timeout\n icontains Case-insensitive model:icontains:gpt\n startswith Starts with model:startswith:gpt\n endswith Ends with model:endswith:mini\n in Value in list model:in:gpt-4,gpt-4o\n isnull Is null error_message:isnull:true\n iexact Case-insens. exact status:iexact:success\n\nFILTERABLE FIELDS (logs):\n model, status_code, status, cost, latency, prompt_tokens,\n completion_tokens, customer_identifier, custom_identifier,\n thread_identifier, trace_unique_id, span_name, span_workflow_name,\n environment, log_type, error_message, failed, provider_id,\n deployment_name, prompt_name, prompt_id, unique_id, stream,\n temperature, max_tokens, tokens_per_second, time_to_first_token,\n total_request_tokens, metadata__<key>, scores__<evaluator_id>\n\nEXAMPLES:\n --filter model::gpt-4o --filter cost:gt:0.01\n --filter status_code:not:200\n --filter metadata__env::production\n --filter model:in:gpt-4,gpt-4o",
4731
4799
  "flags": {
4732
4800
  "api-key": {
4733
4801
  "description": "API key (env: RESPAN_API_KEY)",
@@ -4738,9 +4806,8 @@
4738
4806
  "type": "option"
4739
4807
  },
4740
4808
  "base-url": {
4741
- "description": "Respan API base URL (for enterprise deployments)",
4809
+ "description": "Temporary API base URL override for this command",
4742
4810
  "name": "base-url",
4743
- "default": "https://api.respan.ai/api",
4744
4811
  "hasDynamicHelp": false,
4745
4812
  "multiple": false,
4746
4813
  "type": "option"
@@ -4771,106 +4838,39 @@
4771
4838
  "allowNo": false,
4772
4839
  "type": "boolean"
4773
4840
  },
4774
- "local": {
4775
- "description": "Write per-project config (default)",
4776
- "exclusive": [
4777
- "global"
4778
- ],
4779
- "name": "local",
4780
- "allowNo": false,
4781
- "type": "boolean"
4782
- },
4783
- "global": {
4784
- "description": "Write user-level global config",
4785
- "exclusive": [
4786
- "local"
4787
- ],
4788
- "name": "global",
4789
- "allowNo": false,
4790
- "type": "boolean"
4791
- },
4792
- "enable": {
4793
- "description": "Enable tracing (default)",
4794
- "exclusive": [
4795
- "disable"
4796
- ],
4797
- "name": "enable",
4798
- "allowNo": false,
4799
- "type": "boolean"
4800
- },
4801
- "disable": {
4802
- "description": "Disable tracing",
4803
- "exclusive": [
4804
- "enable"
4805
- ],
4806
- "name": "disable",
4807
- "allowNo": false,
4808
- "type": "boolean"
4809
- },
4810
- "project-id": {
4811
- "description": "Respan project ID (added to metadata / resource attributes)",
4812
- "env": "RESPAN_PROJECT_ID",
4813
- "name": "project-id",
4814
- "hasDynamicHelp": false,
4815
- "multiple": false,
4816
- "type": "option"
4817
- },
4818
- "attrs": {
4819
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
4820
- "name": "attrs",
4821
- "default": "{}",
4822
- "hasDynamicHelp": false,
4823
- "multiple": false,
4824
- "type": "option"
4825
- },
4826
- "customer-id": {
4827
- "description": "Customer/user identifier for traces (e.g. your name or email)",
4828
- "env": "RESPAN_CUSTOMER_ID",
4829
- "name": "customer-id",
4841
+ "start-time": {
4842
+ "description": "Start time (ISO 8601)",
4843
+ "name": "start-time",
4844
+ "required": true,
4830
4845
  "hasDynamicHelp": false,
4831
4846
  "multiple": false,
4832
4847
  "type": "option"
4833
4848
  },
4834
- "span-name": {
4835
- "description": "Alias of --workflow-name (default: pi)",
4836
- "name": "span-name",
4849
+ "end-time": {
4850
+ "description": "End time (ISO 8601)",
4851
+ "name": "end-time",
4852
+ "required": true,
4837
4853
  "hasDynamicHelp": false,
4838
4854
  "multiple": false,
4839
4855
  "type": "option"
4840
4856
  },
4841
- "workflow-name": {
4842
- "description": "traceloop.workflow.name on pi turn spans (default: pi)",
4843
- "name": "workflow-name",
4857
+ "filter": {
4858
+ "description": "Filter in field:operator:value format (repeatable)",
4859
+ "name": "filter",
4844
4860
  "hasDynamicHelp": false,
4845
- "multiple": false,
4861
+ "multiple": true,
4846
4862
  "type": "option"
4847
4863
  },
4848
- "dry-run": {
4849
- "description": "Preview changes without writing files",
4850
- "name": "dry-run",
4851
- "allowNo": false,
4852
- "type": "boolean"
4853
- },
4854
- "trace-scope": {
4855
- "description": "Trace scope: \"run\" = one trace per agent run (default), \"session\" = one multi-root trace per pi session",
4856
- "name": "trace-scope",
4864
+ "all-envs": {
4865
+ "description": "Include all environments (true/false)",
4866
+ "name": "all-envs",
4857
4867
  "hasDynamicHelp": false,
4858
4868
  "multiple": false,
4859
- "options": [
4860
- "run",
4861
- "session"
4862
- ],
4863
4869
  "type": "option"
4864
4870
  },
4865
- "with-collector": {
4866
- "description": "Send traces through a local Respan collector (respan collector start) for durable delivery",
4867
- "name": "with-collector",
4868
- "allowNo": false,
4869
- "type": "boolean"
4870
- },
4871
- "collector-port": {
4872
- "description": "Port of the local collector, with --with-collector (default: 4318)",
4873
- "name": "collector-port",
4871
+ "is-test": {
4872
+ "description": "Filter by test (true) or production (false) environment",
4873
+ "name": "is-test",
4874
4874
  "hasDynamicHelp": false,
4875
4875
  "multiple": false,
4876
4876
  "type": "option"
@@ -4878,7 +4878,7 @@
4878
4878
  },
4879
4879
  "hasDynamicHelp": false,
4880
4880
  "hiddenAliases": [],
4881
- "id": "integrate:pi",
4881
+ "id": "logs:summary",
4882
4882
  "pluginAlias": "@respan/cli",
4883
4883
  "pluginName": "@respan/cli",
4884
4884
  "pluginType": "core",
@@ -4888,10 +4888,10 @@
4888
4888
  "relativePath": [
4889
4889
  "dist",
4890
4890
  "commands",
4891
- "integrate",
4892
- "pi.js"
4891
+ "logs",
4892
+ "summary.js"
4893
4893
  ]
4894
4894
  }
4895
4895
  },
4896
- "version": "0.14.0"
4896
+ "version": "0.14.1"
4897
4897
  }