@respan/cli 0.15.0 → 0.16.0

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 (18) hide show
  1. package/dist/commands/tools/call.d.ts +19 -0
  2. package/dist/commands/tools/call.js +31 -0
  3. package/dist/commands/tools/list.d.ts +14 -0
  4. package/dist/commands/tools/list.js +22 -0
  5. package/dist/lib/mcp-client.d.ts +38 -0
  6. package/dist/lib/mcp-client.js +52 -0
  7. package/oclif.manifest.json +167 -785
  8. package/package.json +2 -1
  9. package/dist/commands/integrate/claude-code.d.ts +0 -25
  10. package/dist/commands/integrate/claude-code.js +0 -210
  11. package/dist/commands/integrate/codex-cli.d.ts +0 -33
  12. package/dist/commands/integrate/codex-cli.js +0 -191
  13. package/dist/commands/integrate/gemini-cli.d.ts +0 -25
  14. package/dist/commands/integrate/gemini-cli.js +0 -189
  15. package/dist/commands/integrate/opencode.d.ts +0 -25
  16. package/dist/commands/integrate/opencode.js +0 -123
  17. package/dist/commands/integrate/pi.d.ts +0 -28
  18. package/dist/commands/integrate/pi.js +0 -198
package/oclif.manifest.json CHANGED
@@ -2313,790 +2313,6 @@
2313
2313
  "list.js"
2314
2314
  ]
2315
2315
  },
2316
- "integrate:claude-code": {
2317
- "aliases": [],
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
- ],
2328
- "flags": {
2329
- "api-key": {
2330
- "description": "API key (env: RESPAN_API_KEY)",
2331
- "env": "RESPAN_API_KEY",
2332
- "name": "api-key",
2333
- "hasDynamicHelp": false,
2334
- "multiple": false,
2335
- "type": "option"
2336
- },
2337
- "base-url": {
2338
- "description": "Respan API base URL (for enterprise deployments)",
2339
- "name": "base-url",
2340
- "default": "https://api.respan.ai/api",
2341
- "hasDynamicHelp": false,
2342
- "multiple": false,
2343
- "type": "option"
2344
- },
2345
- "profile": {
2346
- "description": "Named profile to use",
2347
- "name": "profile",
2348
- "hasDynamicHelp": false,
2349
- "multiple": false,
2350
- "type": "option"
2351
- },
2352
- "json": {
2353
- "description": "Output as JSON",
2354
- "name": "json",
2355
- "allowNo": false,
2356
- "type": "boolean"
2357
- },
2358
- "csv": {
2359
- "description": "Output as CSV",
2360
- "name": "csv",
2361
- "allowNo": false,
2362
- "type": "boolean"
2363
- },
2364
- "verbose": {
2365
- "char": "v",
2366
- "description": "Show verbose output",
2367
- "name": "verbose",
2368
- "allowNo": false,
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"
2450
- }
2451
- },
2452
- "hasDynamicHelp": false,
2453
- "hiddenAliases": [],
2454
- "id": "integrate:claude-code",
2455
- "pluginAlias": "@respan/cli",
2456
- "pluginName": "@respan/cli",
2457
- "pluginType": "core",
2458
- "strict": true,
2459
- "enableJsonFlag": false,
2460
- "isESM": true,
2461
- "relativePath": [
2462
- "dist",
2463
- "commands",
2464
- "integrate",
2465
- "claude-code.js"
2466
- ]
2467
- },
2468
- "integrate:codex-cli": {
2469
- "aliases": [],
2470
- "args": {},
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
- ],
2480
- "flags": {
2481
- "api-key": {
2482
- "description": "API key (env: RESPAN_API_KEY)",
2483
- "env": "RESPAN_API_KEY",
2484
- "name": "api-key",
2485
- "hasDynamicHelp": false,
2486
- "multiple": false,
2487
- "type": "option"
2488
- },
2489
- "base-url": {
2490
- "description": "Respan API base URL (for enterprise deployments)",
2491
- "name": "base-url",
2492
- "default": "https://api.respan.ai/api",
2493
- "hasDynamicHelp": false,
2494
- "multiple": false,
2495
- "type": "option"
2496
- },
2497
- "profile": {
2498
- "description": "Named profile to use",
2499
- "name": "profile",
2500
- "hasDynamicHelp": false,
2501
- "multiple": false,
2502
- "type": "option"
2503
- },
2504
- "json": {
2505
- "description": "Output as JSON",
2506
- "name": "json",
2507
- "allowNo": false,
2508
- "type": "boolean"
2509
- },
2510
- "csv": {
2511
- "description": "Output as CSV",
2512
- "name": "csv",
2513
- "allowNo": false,
2514
- "type": "boolean"
2515
- },
2516
- "verbose": {
2517
- "char": "v",
2518
- "description": "Show verbose output",
2519
- "name": "verbose",
2520
- "allowNo": false,
2521
- "type": "boolean"
2522
- },
2523
- "local": {
2524
- "description": "Write per-project config (default)",
2525
- "exclusive": [
2526
- "global"
2527
- ],
2528
- "name": "local",
2529
- "allowNo": false,
2530
- "type": "boolean"
2531
- },
2532
- "global": {
2533
- "description": "Write user-level global config",
2534
- "exclusive": [
2535
- "local"
2536
- ],
2537
- "name": "global",
2538
- "allowNo": false,
2539
- "type": "boolean"
2540
- },
2541
- "enable": {
2542
- "description": "Enable tracing (default)",
2543
- "exclusive": [
2544
- "disable"
2545
- ],
2546
- "name": "enable",
2547
- "allowNo": false,
2548
- "type": "boolean"
2549
- },
2550
- "disable": {
2551
- "description": "Disable tracing",
2552
- "exclusive": [
2553
- "enable"
2554
- ],
2555
- "name": "disable",
2556
- "allowNo": false,
2557
- "type": "boolean"
2558
- },
2559
- "project-id": {
2560
- "description": "Respan project ID (added to metadata / resource attributes)",
2561
- "env": "RESPAN_PROJECT_ID",
2562
- "name": "project-id",
2563
- "hasDynamicHelp": false,
2564
- "multiple": false,
2565
- "type": "option"
2566
- },
2567
- "attrs": {
2568
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2569
- "name": "attrs",
2570
- "default": "{}",
2571
- "hasDynamicHelp": false,
2572
- "multiple": false,
2573
- "type": "option"
2574
- },
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",
2579
- "hasDynamicHelp": false,
2580
- "multiple": false,
2581
- "type": "option"
2582
- },
2583
- "span-name": {
2584
- "description": "Root span name for traces (default: claude-code)",
2585
- "name": "span-name",
2586
- "hasDynamicHelp": false,
2587
- "multiple": false,
2588
- "type": "option"
2589
- },
2590
- "workflow-name": {
2591
- "description": "Workflow name for traces (default: claude-code)",
2592
- "name": "workflow-name",
2593
- "hasDynamicHelp": false,
2594
- "multiple": false,
2595
- "type": "option"
2596
- },
2597
- "dry-run": {
2598
- "description": "Preview changes without writing files",
2599
- "name": "dry-run",
2600
- "allowNo": false,
2601
- "type": "boolean"
2602
- }
2603
- },
2604
- "hasDynamicHelp": false,
2605
- "hiddenAliases": [],
2606
- "id": "integrate:codex-cli",
2607
- "pluginAlias": "@respan/cli",
2608
- "pluginName": "@respan/cli",
2609
- "pluginType": "core",
2610
- "strict": true,
2611
- "enableJsonFlag": false,
2612
- "isESM": true,
2613
- "relativePath": [
2614
- "dist",
2615
- "commands",
2616
- "integrate",
2617
- "codex-cli.js"
2618
- ]
2619
- },
2620
- "integrate:gemini-cli": {
2621
- "aliases": [],
2622
- "args": {},
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
- ],
2631
- "flags": {
2632
- "api-key": {
2633
- "description": "API key (env: RESPAN_API_KEY)",
2634
- "env": "RESPAN_API_KEY",
2635
- "name": "api-key",
2636
- "hasDynamicHelp": false,
2637
- "multiple": false,
2638
- "type": "option"
2639
- },
2640
- "base-url": {
2641
- "description": "Respan API base URL (for enterprise deployments)",
2642
- "name": "base-url",
2643
- "default": "https://api.respan.ai/api",
2644
- "hasDynamicHelp": false,
2645
- "multiple": false,
2646
- "type": "option"
2647
- },
2648
- "profile": {
2649
- "description": "Named profile to use",
2650
- "name": "profile",
2651
- "hasDynamicHelp": false,
2652
- "multiple": false,
2653
- "type": "option"
2654
- },
2655
- "json": {
2656
- "description": "Output as JSON",
2657
- "name": "json",
2658
- "allowNo": false,
2659
- "type": "boolean"
2660
- },
2661
- "csv": {
2662
- "description": "Output as CSV",
2663
- "name": "csv",
2664
- "allowNo": false,
2665
- "type": "boolean"
2666
- },
2667
- "verbose": {
2668
- "char": "v",
2669
- "description": "Show verbose output",
2670
- "name": "verbose",
2671
- "allowNo": false,
2672
- "type": "boolean"
2673
- },
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",
2714
- "hasDynamicHelp": false,
2715
- "multiple": false,
2716
- "type": "option"
2717
- },
2718
- "attrs": {
2719
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2720
- "name": "attrs",
2721
- "default": "{}",
2722
- "hasDynamicHelp": false,
2723
- "multiple": false,
2724
- "type": "option"
2725
- },
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",
2730
- "hasDynamicHelp": false,
2731
- "multiple": false,
2732
- "type": "option"
2733
- },
2734
- "span-name": {
2735
- "description": "Root span name for traces (default: claude-code)",
2736
- "name": "span-name",
2737
- "hasDynamicHelp": false,
2738
- "multiple": false,
2739
- "type": "option"
2740
- },
2741
- "workflow-name": {
2742
- "description": "Workflow name for traces (default: claude-code)",
2743
- "name": "workflow-name",
2744
- "hasDynamicHelp": false,
2745
- "multiple": false,
2746
- "type": "option"
2747
- },
2748
- "dry-run": {
2749
- "description": "Preview changes without writing files",
2750
- "name": "dry-run",
2751
- "allowNo": false,
2752
- "type": "boolean"
2753
- }
2754
- },
2755
- "hasDynamicHelp": false,
2756
- "hiddenAliases": [],
2757
- "id": "integrate:gemini-cli",
2758
- "pluginAlias": "@respan/cli",
2759
- "pluginName": "@respan/cli",
2760
- "pluginType": "core",
2761
- "strict": true,
2762
- "enableJsonFlag": false,
2763
- "isESM": true,
2764
- "relativePath": [
2765
- "dist",
2766
- "commands",
2767
- "integrate",
2768
- "gemini-cli.js"
2769
- ]
2770
- },
2771
- "integrate:opencode": {
2772
- "aliases": [],
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
- ],
2782
- "flags": {
2783
- "api-key": {
2784
- "description": "API key (env: RESPAN_API_KEY)",
2785
- "env": "RESPAN_API_KEY",
2786
- "name": "api-key",
2787
- "hasDynamicHelp": false,
2788
- "multiple": false,
2789
- "type": "option"
2790
- },
2791
- "base-url": {
2792
- "description": "Respan API base URL (for enterprise deployments)",
2793
- "name": "base-url",
2794
- "default": "https://api.respan.ai/api",
2795
- "hasDynamicHelp": false,
2796
- "multiple": false,
2797
- "type": "option"
2798
- },
2799
- "profile": {
2800
- "description": "Named profile to use",
2801
- "name": "profile",
2802
- "hasDynamicHelp": false,
2803
- "multiple": false,
2804
- "type": "option"
2805
- },
2806
- "json": {
2807
- "description": "Output as JSON",
2808
- "name": "json",
2809
- "allowNo": false,
2810
- "type": "boolean"
2811
- },
2812
- "csv": {
2813
- "description": "Output as CSV",
2814
- "name": "csv",
2815
- "allowNo": false,
2816
- "type": "boolean"
2817
- },
2818
- "verbose": {
2819
- "char": "v",
2820
- "description": "Show verbose output",
2821
- "name": "verbose",
2822
- "allowNo": false,
2823
- "type": "boolean"
2824
- },
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",
2865
- "hasDynamicHelp": false,
2866
- "multiple": false,
2867
- "type": "option"
2868
- },
2869
- "attrs": {
2870
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2871
- "name": "attrs",
2872
- "default": "{}",
2873
- "hasDynamicHelp": false,
2874
- "multiple": false,
2875
- "type": "option"
2876
- },
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",
2881
- "hasDynamicHelp": false,
2882
- "multiple": false,
2883
- "type": "option"
2884
- },
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",
2895
- "hasDynamicHelp": false,
2896
- "multiple": false,
2897
- "type": "option"
2898
- },
2899
- "dry-run": {
2900
- "description": "Preview changes without writing files",
2901
- "name": "dry-run",
2902
- "allowNo": false,
2903
- "type": "boolean"
2904
- }
2905
- },
2906
- "hasDynamicHelp": false,
2907
- "hiddenAliases": [],
2908
- "id": "integrate:opencode",
2909
- "pluginAlias": "@respan/cli",
2910
- "pluginName": "@respan/cli",
2911
- "pluginType": "core",
2912
- "strict": true,
2913
- "enableJsonFlag": false,
2914
- "isESM": true,
2915
- "relativePath": [
2916
- "dist",
2917
- "commands",
2918
- "integrate",
2919
- "opencode.js"
2920
- ]
2921
- },
2922
- "integrate:pi": {
2923
- "aliases": [],
2924
- "args": {},
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
- ],
2936
- "flags": {
2937
- "api-key": {
2938
- "description": "API key (env: RESPAN_API_KEY)",
2939
- "env": "RESPAN_API_KEY",
2940
- "name": "api-key",
2941
- "hasDynamicHelp": false,
2942
- "multiple": false,
2943
- "type": "option"
2944
- },
2945
- "base-url": {
2946
- "description": "Respan API base URL (for enterprise deployments)",
2947
- "name": "base-url",
2948
- "default": "https://api.respan.ai/api",
2949
- "hasDynamicHelp": false,
2950
- "multiple": false,
2951
- "type": "option"
2952
- },
2953
- "profile": {
2954
- "description": "Named profile to use",
2955
- "name": "profile",
2956
- "hasDynamicHelp": false,
2957
- "multiple": false,
2958
- "type": "option"
2959
- },
2960
- "json": {
2961
- "description": "Output as JSON",
2962
- "name": "json",
2963
- "allowNo": false,
2964
- "type": "boolean"
2965
- },
2966
- "csv": {
2967
- "description": "Output as CSV",
2968
- "name": "csv",
2969
- "allowNo": false,
2970
- "type": "boolean"
2971
- },
2972
- "verbose": {
2973
- "char": "v",
2974
- "description": "Show verbose output",
2975
- "name": "verbose",
2976
- "allowNo": false,
2977
- "type": "boolean"
2978
- },
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",
3019
- "hasDynamicHelp": false,
3020
- "multiple": false,
3021
- "type": "option"
3022
- },
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",
3079
- "hasDynamicHelp": false,
3080
- "multiple": false,
3081
- "type": "option"
3082
- }
3083
- },
3084
- "hasDynamicHelp": false,
3085
- "hiddenAliases": [],
3086
- "id": "integrate:pi",
3087
- "pluginAlias": "@respan/cli",
3088
- "pluginName": "@respan/cli",
3089
- "pluginType": "core",
3090
- "strict": true,
3091
- "enableJsonFlag": false,
3092
- "isESM": true,
3093
- "relativePath": [
3094
- "dist",
3095
- "commands",
3096
- "integrate",
3097
- "pi.js"
3098
- ]
3099
- },
3100
2316
  "logs:create": {
3101
2317
  "aliases": [],
3102
2318
  "args": {},
@@ -4282,6 +3498,172 @@
4282
3498
  "tracing.js"
4283
3499
  ]
4284
3500
  },
3501
+ "tools:call": {
3502
+ "aliases": [],
3503
+ "args": {
3504
+ "name": {
3505
+ "description": "MCP tool name, e.g. log_list or trace_get",
3506
+ "name": "name",
3507
+ "required": true
3508
+ }
3509
+ },
3510
+ "description": "Call a Respan MCP tool with its exact tool name and JSON arguments. Writes execute immediately; inspect tools list --json before calling.",
3511
+ "flags": {
3512
+ "api-key": {
3513
+ "description": "API key (env: RESPAN_API_KEY)",
3514
+ "env": "RESPAN_API_KEY",
3515
+ "name": "api-key",
3516
+ "hasDynamicHelp": false,
3517
+ "multiple": false,
3518
+ "type": "option"
3519
+ },
3520
+ "base-url": {
3521
+ "description": "Temporary API base URL override for this command",
3522
+ "name": "base-url",
3523
+ "hasDynamicHelp": false,
3524
+ "multiple": false,
3525
+ "type": "option"
3526
+ },
3527
+ "profile": {
3528
+ "description": "Named profile to use",
3529
+ "name": "profile",
3530
+ "hasDynamicHelp": false,
3531
+ "multiple": false,
3532
+ "type": "option"
3533
+ },
3534
+ "json": {
3535
+ "description": "Output as JSON",
3536
+ "name": "json",
3537
+ "allowNo": false,
3538
+ "type": "boolean"
3539
+ },
3540
+ "csv": {
3541
+ "description": "Output as CSV",
3542
+ "name": "csv",
3543
+ "allowNo": false,
3544
+ "type": "boolean"
3545
+ },
3546
+ "verbose": {
3547
+ "char": "v",
3548
+ "description": "Show verbose output",
3549
+ "name": "verbose",
3550
+ "allowNo": false,
3551
+ "type": "boolean"
3552
+ },
3553
+ "input": {
3554
+ "description": "JSON object of MCP tool arguments",
3555
+ "exclusive": [
3556
+ "input-file"
3557
+ ],
3558
+ "name": "input",
3559
+ "hasDynamicHelp": false,
3560
+ "multiple": false,
3561
+ "type": "option"
3562
+ },
3563
+ "input-file": {
3564
+ "description": "File containing a JSON object of MCP tool arguments",
3565
+ "exclusive": [
3566
+ "input"
3567
+ ],
3568
+ "name": "input-file",
3569
+ "hasDynamicHelp": false,
3570
+ "multiple": false,
3571
+ "type": "option"
3572
+ },
3573
+ "mcp-url": {
3574
+ "description": "Custom MCP server URL (defaults to the active Platform or Enterprise server)",
3575
+ "name": "mcp-url",
3576
+ "hasDynamicHelp": false,
3577
+ "multiple": false,
3578
+ "type": "option"
3579
+ }
3580
+ },
3581
+ "hasDynamicHelp": false,
3582
+ "hiddenAliases": [],
3583
+ "id": "tools:call",
3584
+ "pluginAlias": "@respan/cli",
3585
+ "pluginName": "@respan/cli",
3586
+ "pluginType": "core",
3587
+ "strict": true,
3588
+ "enableJsonFlag": false,
3589
+ "isESM": true,
3590
+ "relativePath": [
3591
+ "dist",
3592
+ "commands",
3593
+ "tools",
3594
+ "call.js"
3595
+ ]
3596
+ },
3597
+ "tools:list": {
3598
+ "aliases": [],
3599
+ "args": {},
3600
+ "description": "List the current Respan MCP tools, their input schemas, and annotations.",
3601
+ "flags": {
3602
+ "api-key": {
3603
+ "description": "API key (env: RESPAN_API_KEY)",
3604
+ "env": "RESPAN_API_KEY",
3605
+ "name": "api-key",
3606
+ "hasDynamicHelp": false,
3607
+ "multiple": false,
3608
+ "type": "option"
3609
+ },
3610
+ "base-url": {
3611
+ "description": "Temporary API base URL override for this command",
3612
+ "name": "base-url",
3613
+ "hasDynamicHelp": false,
3614
+ "multiple": false,
3615
+ "type": "option"
3616
+ },
3617
+ "profile": {
3618
+ "description": "Named profile to use",
3619
+ "name": "profile",
3620
+ "hasDynamicHelp": false,
3621
+ "multiple": false,
3622
+ "type": "option"
3623
+ },
3624
+ "json": {
3625
+ "description": "Output as JSON",
3626
+ "name": "json",
3627
+ "allowNo": false,
3628
+ "type": "boolean"
3629
+ },
3630
+ "csv": {
3631
+ "description": "Output as CSV",
3632
+ "name": "csv",
3633
+ "allowNo": false,
3634
+ "type": "boolean"
3635
+ },
3636
+ "verbose": {
3637
+ "char": "v",
3638
+ "description": "Show verbose output",
3639
+ "name": "verbose",
3640
+ "allowNo": false,
3641
+ "type": "boolean"
3642
+ },
3643
+ "mcp-url": {
3644
+ "description": "Custom MCP server URL (defaults to the active Platform or Enterprise server)",
3645
+ "name": "mcp-url",
3646
+ "hasDynamicHelp": false,
3647
+ "multiple": false,
3648
+ "type": "option"
3649
+ }
3650
+ },
3651
+ "hasDynamicHelp": false,
3652
+ "hiddenAliases": [],
3653
+ "id": "tools:list",
3654
+ "pluginAlias": "@respan/cli",
3655
+ "pluginName": "@respan/cli",
3656
+ "pluginType": "core",
3657
+ "strict": true,
3658
+ "enableJsonFlag": false,
3659
+ "isESM": true,
3660
+ "relativePath": [
3661
+ "dist",
3662
+ "commands",
3663
+ "tools",
3664
+ "list.js"
3665
+ ]
3666
+ },
4285
3667
  "traces:get": {
4286
3668
  "aliases": [],
4287
3669
  "args": {
@@ -4890,5 +4272,5 @@
4890
4272
  ]
4891
4273
  }
4892
4274
  },
4893
- "version": "0.15.0"
4275
+ "version": "0.16.0"
4894
4276
  }