@respan/cli 0.7.1 → 0.7.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (20) hide show
  1. package/dist/commands/integrate/claude-code.d.ts +2 -0
  2. package/dist/commands/integrate/claude-code.js +35 -5
  3. package/dist/commands/integrate/codex-cli.d.ts +2 -0
  4. package/dist/commands/integrate/codex-cli.js +23 -2
  5. package/dist/commands/integrate/gemini-cli.d.ts +2 -0
  6. package/dist/commands/integrate/gemini-cli.js +36 -4
  7. package/dist/commands/integrate/opencode.d.ts +2 -0
  8. package/dist/commands/integrate/opencode.js +25 -2
  9. package/dist/hooks/claude-code.cjs +3 -1
  10. package/dist/hooks/claude-code.js +1 -0
  11. package/dist/hooks/codex-cli.cjs +3 -1
  12. package/dist/hooks/codex-cli.js +1 -0
  13. package/dist/hooks/gemini-cli.cjs +3 -1
  14. package/dist/hooks/gemini-cli.js +1 -0
  15. package/dist/hooks/shared.d.ts +1 -0
  16. package/dist/hooks/shared.js +3 -1
  17. package/dist/lib/integrate.d.ts +2 -0
  18. package/dist/lib/integrate.js +10 -0
  19. package/oclif.manifest.json +657 -581
  20. package/package.json +10 -2
package/oclif.manifest.json CHANGED
@@ -428,10 +428,16 @@
428
428
  "set.js"
429
429
  ]
430
430
  },
431
- "evaluators:create": {
431
+ "datasets:add-spans": {
432
432
  "aliases": [],
433
- "args": {},
434
- "description": "Create a new evaluator",
433
+ "args": {
434
+ "dataset-id": {
435
+ "description": "Dataset ID",
436
+ "name": "dataset-id",
437
+ "required": true
438
+ }
439
+ },
440
+ "description": "Add existing spans to a dataset",
435
441
  "flags": {
436
442
  "api-key": {
437
443
  "description": "API key (env: RESPAN_API_KEY)",
@@ -467,39 +473,18 @@
467
473
  "allowNo": false,
468
474
  "type": "boolean"
469
475
  },
470
- "name": {
471
- "description": "Evaluator name",
472
- "name": "name",
476
+ "span-ids": {
477
+ "description": "Comma-separated span IDs",
478
+ "name": "span-ids",
473
479
  "required": true,
474
480
  "hasDynamicHelp": false,
475
481
  "multiple": false,
476
482
  "type": "option"
477
- },
478
- "type": {
479
- "description": "Evaluator type",
480
- "name": "type",
481
- "hasDynamicHelp": false,
482
- "multiple": false,
483
- "type": "option"
484
- },
485
- "description": {
486
- "description": "Evaluator description",
487
- "name": "description",
488
- "hasDynamicHelp": false,
489
- "multiple": false,
490
- "type": "option"
491
- },
492
- "config": {
493
- "description": "Evaluator config as JSON string",
494
- "name": "config",
495
- "hasDynamicHelp": false,
496
- "multiple": false,
497
- "type": "option"
498
483
  }
499
484
  },
500
485
  "hasDynamicHelp": false,
501
486
  "hiddenAliases": [],
502
- "id": "evaluators:create",
487
+ "id": "datasets:add-spans",
503
488
  "pluginAlias": "@respan/cli",
504
489
  "pluginName": "@respan/cli",
505
490
  "pluginType": "core",
@@ -509,20 +494,20 @@
509
494
  "relativePath": [
510
495
  "dist",
511
496
  "commands",
512
- "evaluators",
513
- "create.js"
497
+ "datasets",
498
+ "add-spans.js"
514
499
  ]
515
500
  },
516
- "evaluators:get": {
501
+ "datasets:create-span": {
517
502
  "aliases": [],
518
503
  "args": {
519
- "id": {
520
- "description": "Evaluator ID",
521
- "name": "id",
504
+ "dataset-id": {
505
+ "description": "Dataset ID",
506
+ "name": "dataset-id",
522
507
  "required": true
523
508
  }
524
509
  },
525
- "description": "Get a specific evaluator",
510
+ "description": "Create a span in a dataset",
526
511
  "flags": {
527
512
  "api-key": {
528
513
  "description": "API key (env: RESPAN_API_KEY)",
@@ -557,11 +542,19 @@
557
542
  "name": "verbose",
558
543
  "allowNo": false,
559
544
  "type": "boolean"
545
+ },
546
+ "body": {
547
+ "description": "Span body as JSON string",
548
+ "name": "body",
549
+ "required": true,
550
+ "hasDynamicHelp": false,
551
+ "multiple": false,
552
+ "type": "option"
560
553
  }
561
554
  },
562
555
  "hasDynamicHelp": false,
563
556
  "hiddenAliases": [],
564
- "id": "evaluators:get",
557
+ "id": "datasets:create-span",
565
558
  "pluginAlias": "@respan/cli",
566
559
  "pluginName": "@respan/cli",
567
560
  "pluginType": "core",
@@ -571,14 +564,14 @@
571
564
  "relativePath": [
572
565
  "dist",
573
566
  "commands",
574
- "evaluators",
575
- "get.js"
567
+ "datasets",
568
+ "create-span.js"
576
569
  ]
577
570
  },
578
- "evaluators:list": {
571
+ "datasets:create": {
579
572
  "aliases": [],
580
573
  "args": {},
581
- "description": "List evaluators",
574
+ "description": "Create a new dataset",
582
575
  "flags": {
583
576
  "api-key": {
584
577
  "description": "API key (env: RESPAN_API_KEY)",
@@ -614,18 +607,17 @@
614
607
  "allowNo": false,
615
608
  "type": "boolean"
616
609
  },
617
- "limit": {
618
- "description": "Number of results per page",
619
- "name": "limit",
620
- "default": 20,
610
+ "name": {
611
+ "description": "Dataset name",
612
+ "name": "name",
613
+ "required": true,
621
614
  "hasDynamicHelp": false,
622
615
  "multiple": false,
623
616
  "type": "option"
624
617
  },
625
- "page": {
626
- "description": "Page number",
627
- "name": "page",
628
- "default": 1,
618
+ "description": {
619
+ "description": "Dataset description",
620
+ "name": "description",
629
621
  "hasDynamicHelp": false,
630
622
  "multiple": false,
631
623
  "type": "option"
@@ -633,7 +625,7 @@
633
625
  },
634
626
  "hasDynamicHelp": false,
635
627
  "hiddenAliases": [],
636
- "id": "evaluators:list",
628
+ "id": "datasets:create",
637
629
  "pluginAlias": "@respan/cli",
638
630
  "pluginName": "@respan/cli",
639
631
  "pluginType": "core",
@@ -643,20 +635,25 @@
643
635
  "relativePath": [
644
636
  "dist",
645
637
  "commands",
646
- "evaluators",
647
- "list.js"
638
+ "datasets",
639
+ "create.js"
648
640
  ]
649
641
  },
650
- "evaluators:run": {
642
+ "datasets:get-span": {
651
643
  "aliases": [],
652
644
  "args": {
653
- "id": {
654
- "description": "Evaluator ID",
655
- "name": "id",
645
+ "dataset-id": {
646
+ "description": "Dataset ID",
647
+ "name": "dataset-id",
648
+ "required": true
649
+ },
650
+ "span-id": {
651
+ "description": "Span ID",
652
+ "name": "span-id",
656
653
  "required": true
657
654
  }
658
655
  },
659
- "description": "Run an evaluator",
656
+ "description": "Get a specific span from a dataset",
660
657
  "flags": {
661
658
  "api-key": {
662
659
  "description": "API key (env: RESPAN_API_KEY)",
@@ -691,32 +688,11 @@
691
688
  "name": "verbose",
692
689
  "allowNo": false,
693
690
  "type": "boolean"
694
- },
695
- "dataset-id": {
696
- "description": "Dataset ID to evaluate against",
697
- "name": "dataset-id",
698
- "hasDynamicHelp": false,
699
- "multiple": false,
700
- "type": "option"
701
- },
702
- "log-ids": {
703
- "description": "Comma-separated log/span IDs to evaluate",
704
- "name": "log-ids",
705
- "hasDynamicHelp": false,
706
- "multiple": false,
707
- "type": "option"
708
- },
709
- "params": {
710
- "description": "Additional parameters as JSON string",
711
- "name": "params",
712
- "hasDynamicHelp": false,
713
- "multiple": false,
714
- "type": "option"
715
691
  }
716
692
  },
717
693
  "hasDynamicHelp": false,
718
694
  "hiddenAliases": [],
719
- "id": "evaluators:run",
695
+ "id": "datasets:get-span",
720
696
  "pluginAlias": "@respan/cli",
721
697
  "pluginName": "@respan/cli",
722
698
  "pluginType": "core",
@@ -726,20 +702,20 @@
726
702
  "relativePath": [
727
703
  "dist",
728
704
  "commands",
729
- "evaluators",
730
- "run.js"
705
+ "datasets",
706
+ "get-span.js"
731
707
  ]
732
708
  },
733
- "evaluators:update": {
709
+ "datasets:get": {
734
710
  "aliases": [],
735
711
  "args": {
736
712
  "id": {
737
- "description": "Evaluator ID",
713
+ "description": "Dataset ID",
738
714
  "name": "id",
739
715
  "required": true
740
716
  }
741
717
  },
742
- "description": "Update an evaluator",
718
+ "description": "Get a specific dataset",
743
719
  "flags": {
744
720
  "api-key": {
745
721
  "description": "API key (env: RESPAN_API_KEY)",
@@ -774,32 +750,11 @@
774
750
  "name": "verbose",
775
751
  "allowNo": false,
776
752
  "type": "boolean"
777
- },
778
- "name": {
779
- "description": "Evaluator name",
780
- "name": "name",
781
- "hasDynamicHelp": false,
782
- "multiple": false,
783
- "type": "option"
784
- },
785
- "description": {
786
- "description": "Evaluator description",
787
- "name": "description",
788
- "hasDynamicHelp": false,
789
- "multiple": false,
790
- "type": "option"
791
- },
792
- "config": {
793
- "description": "Evaluator config as JSON string",
794
- "name": "config",
795
- "hasDynamicHelp": false,
796
- "multiple": false,
797
- "type": "option"
798
753
  }
799
754
  },
800
755
  "hasDynamicHelp": false,
801
756
  "hiddenAliases": [],
802
- "id": "evaluators:update",
757
+ "id": "datasets:get",
803
758
  "pluginAlias": "@respan/cli",
804
759
  "pluginName": "@respan/cli",
805
760
  "pluginType": "core",
@@ -809,14 +764,14 @@
809
764
  "relativePath": [
810
765
  "dist",
811
766
  "commands",
812
- "evaluators",
813
- "update.js"
767
+ "datasets",
768
+ "get.js"
814
769
  ]
815
770
  },
816
- "experiments:create": {
771
+ "datasets:list": {
817
772
  "aliases": [],
818
773
  "args": {},
819
- "description": "Create a new experiment",
774
+ "description": "List datasets",
820
775
  "flags": {
821
776
  "api-key": {
822
777
  "description": "API key (env: RESPAN_API_KEY)",
@@ -852,32 +807,18 @@
852
807
  "allowNo": false,
853
808
  "type": "boolean"
854
809
  },
855
- "name": {
856
- "description": "Experiment name",
857
- "name": "name",
858
- "required": true,
859
- "hasDynamicHelp": false,
860
- "multiple": false,
861
- "type": "option"
862
- },
863
- "dataset-id": {
864
- "description": "Dataset ID",
865
- "name": "dataset-id",
866
- "required": true,
867
- "hasDynamicHelp": false,
868
- "multiple": false,
869
- "type": "option"
870
- },
871
- "description": {
872
- "description": "Experiment description",
873
- "name": "description",
810
+ "limit": {
811
+ "description": "Number of results per page",
812
+ "name": "limit",
813
+ "default": 50,
874
814
  "hasDynamicHelp": false,
875
815
  "multiple": false,
876
816
  "type": "option"
877
817
  },
878
- "workflows": {
879
- "description": "Workflows configuration as JSON string",
880
- "name": "workflows",
818
+ "page": {
819
+ "description": "Page number",
820
+ "name": "page",
821
+ "default": 1,
881
822
  "hasDynamicHelp": false,
882
823
  "multiple": false,
883
824
  "type": "option"
@@ -885,7 +826,7 @@
885
826
  },
886
827
  "hasDynamicHelp": false,
887
828
  "hiddenAliases": [],
888
- "id": "experiments:create",
829
+ "id": "datasets:list",
889
830
  "pluginAlias": "@respan/cli",
890
831
  "pluginName": "@respan/cli",
891
832
  "pluginType": "core",
@@ -895,20 +836,20 @@
895
836
  "relativePath": [
896
837
  "dist",
897
838
  "commands",
898
- "experiments",
899
- "create.js"
839
+ "datasets",
840
+ "list.js"
900
841
  ]
901
842
  },
902
- "experiments:get": {
843
+ "datasets:spans": {
903
844
  "aliases": [],
904
845
  "args": {
905
- "id": {
906
- "description": "Experiment ID",
907
- "name": "id",
846
+ "dataset-id": {
847
+ "description": "Dataset ID",
848
+ "name": "dataset-id",
908
849
  "required": true
909
850
  }
910
851
  },
911
- "description": "Get a specific experiment",
852
+ "description": "List spans in a dataset",
912
853
  "flags": {
913
854
  "api-key": {
914
855
  "description": "API key (env: RESPAN_API_KEY)",
@@ -947,7 +888,7 @@
947
888
  },
948
889
  "hasDynamicHelp": false,
949
890
  "hiddenAliases": [],
950
- "id": "experiments:get",
891
+ "id": "datasets:spans",
951
892
  "pluginAlias": "@respan/cli",
952
893
  "pluginName": "@respan/cli",
953
894
  "pluginType": "core",
@@ -957,14 +898,20 @@
957
898
  "relativePath": [
958
899
  "dist",
959
900
  "commands",
960
- "experiments",
961
- "get.js"
901
+ "datasets",
902
+ "spans.js"
962
903
  ]
963
904
  },
964
- "experiments:list": {
905
+ "datasets:update": {
965
906
  "aliases": [],
966
- "args": {},
967
- "description": "List experiments",
907
+ "args": {
908
+ "id": {
909
+ "description": "Dataset ID",
910
+ "name": "id",
911
+ "required": true
912
+ }
913
+ },
914
+ "description": "Update a dataset",
968
915
  "flags": {
969
916
  "api-key": {
970
917
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1000,18 +947,16 @@
1000
947
  "allowNo": false,
1001
948
  "type": "boolean"
1002
949
  },
1003
- "limit": {
1004
- "description": "Number of results per page",
1005
- "name": "limit",
1006
- "default": 20,
950
+ "name": {
951
+ "description": "Dataset name",
952
+ "name": "name",
1007
953
  "hasDynamicHelp": false,
1008
954
  "multiple": false,
1009
955
  "type": "option"
1010
956
  },
1011
- "page": {
1012
- "description": "Page number",
1013
- "name": "page",
1014
- "default": 1,
957
+ "description": {
958
+ "description": "Dataset description",
959
+ "name": "description",
1015
960
  "hasDynamicHelp": false,
1016
961
  "multiple": false,
1017
962
  "type": "option"
@@ -1019,7 +964,7 @@
1019
964
  },
1020
965
  "hasDynamicHelp": false,
1021
966
  "hiddenAliases": [],
1022
- "id": "experiments:list",
967
+ "id": "datasets:update",
1023
968
  "pluginAlias": "@respan/cli",
1024
969
  "pluginName": "@respan/cli",
1025
970
  "pluginType": "core",
@@ -1029,20 +974,14 @@
1029
974
  "relativePath": [
1030
975
  "dist",
1031
976
  "commands",
1032
- "experiments",
1033
- "list.js"
1034
- ]
977
+ "datasets",
978
+ "update.js"
979
+ ]
1035
980
  },
1036
- "datasets:add-spans": {
981
+ "evaluators:create": {
1037
982
  "aliases": [],
1038
- "args": {
1039
- "dataset-id": {
1040
- "description": "Dataset ID",
1041
- "name": "dataset-id",
1042
- "required": true
1043
- }
1044
- },
1045
- "description": "Add existing spans to a dataset",
983
+ "args": {},
984
+ "description": "Create a new evaluator",
1046
985
  "flags": {
1047
986
  "api-key": {
1048
987
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1078,18 +1017,39 @@
1078
1017
  "allowNo": false,
1079
1018
  "type": "boolean"
1080
1019
  },
1081
- "span-ids": {
1082
- "description": "Comma-separated span IDs",
1083
- "name": "span-ids",
1020
+ "name": {
1021
+ "description": "Evaluator name",
1022
+ "name": "name",
1084
1023
  "required": true,
1085
1024
  "hasDynamicHelp": false,
1086
1025
  "multiple": false,
1087
1026
  "type": "option"
1027
+ },
1028
+ "type": {
1029
+ "description": "Evaluator type",
1030
+ "name": "type",
1031
+ "hasDynamicHelp": false,
1032
+ "multiple": false,
1033
+ "type": "option"
1034
+ },
1035
+ "description": {
1036
+ "description": "Evaluator description",
1037
+ "name": "description",
1038
+ "hasDynamicHelp": false,
1039
+ "multiple": false,
1040
+ "type": "option"
1041
+ },
1042
+ "config": {
1043
+ "description": "Evaluator config as JSON string",
1044
+ "name": "config",
1045
+ "hasDynamicHelp": false,
1046
+ "multiple": false,
1047
+ "type": "option"
1088
1048
  }
1089
1049
  },
1090
1050
  "hasDynamicHelp": false,
1091
1051
  "hiddenAliases": [],
1092
- "id": "datasets:add-spans",
1052
+ "id": "evaluators:create",
1093
1053
  "pluginAlias": "@respan/cli",
1094
1054
  "pluginName": "@respan/cli",
1095
1055
  "pluginType": "core",
@@ -1099,20 +1059,20 @@
1099
1059
  "relativePath": [
1100
1060
  "dist",
1101
1061
  "commands",
1102
- "datasets",
1103
- "add-spans.js"
1062
+ "evaluators",
1063
+ "create.js"
1104
1064
  ]
1105
1065
  },
1106
- "datasets:create-span": {
1066
+ "evaluators:get": {
1107
1067
  "aliases": [],
1108
1068
  "args": {
1109
- "dataset-id": {
1110
- "description": "Dataset ID",
1111
- "name": "dataset-id",
1069
+ "id": {
1070
+ "description": "Evaluator ID",
1071
+ "name": "id",
1112
1072
  "required": true
1113
1073
  }
1114
1074
  },
1115
- "description": "Create a span in a dataset",
1075
+ "description": "Get a specific evaluator",
1116
1076
  "flags": {
1117
1077
  "api-key": {
1118
1078
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1147,19 +1107,11 @@
1147
1107
  "name": "verbose",
1148
1108
  "allowNo": false,
1149
1109
  "type": "boolean"
1150
- },
1151
- "body": {
1152
- "description": "Span body as JSON string",
1153
- "name": "body",
1154
- "required": true,
1155
- "hasDynamicHelp": false,
1156
- "multiple": false,
1157
- "type": "option"
1158
1110
  }
1159
1111
  },
1160
1112
  "hasDynamicHelp": false,
1161
1113
  "hiddenAliases": [],
1162
- "id": "datasets:create-span",
1114
+ "id": "evaluators:get",
1163
1115
  "pluginAlias": "@respan/cli",
1164
1116
  "pluginName": "@respan/cli",
1165
1117
  "pluginType": "core",
@@ -1169,14 +1121,14 @@
1169
1121
  "relativePath": [
1170
1122
  "dist",
1171
1123
  "commands",
1172
- "datasets",
1173
- "create-span.js"
1124
+ "evaluators",
1125
+ "get.js"
1174
1126
  ]
1175
1127
  },
1176
- "datasets:create": {
1128
+ "evaluators:list": {
1177
1129
  "aliases": [],
1178
1130
  "args": {},
1179
- "description": "Create a new dataset",
1131
+ "description": "List evaluators",
1180
1132
  "flags": {
1181
1133
  "api-key": {
1182
1134
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1212,17 +1164,18 @@
1212
1164
  "allowNo": false,
1213
1165
  "type": "boolean"
1214
1166
  },
1215
- "name": {
1216
- "description": "Dataset name",
1217
- "name": "name",
1218
- "required": true,
1167
+ "limit": {
1168
+ "description": "Number of results per page",
1169
+ "name": "limit",
1170
+ "default": 20,
1219
1171
  "hasDynamicHelp": false,
1220
1172
  "multiple": false,
1221
1173
  "type": "option"
1222
1174
  },
1223
- "description": {
1224
- "description": "Dataset description",
1225
- "name": "description",
1175
+ "page": {
1176
+ "description": "Page number",
1177
+ "name": "page",
1178
+ "default": 1,
1226
1179
  "hasDynamicHelp": false,
1227
1180
  "multiple": false,
1228
1181
  "type": "option"
@@ -1230,7 +1183,7 @@
1230
1183
  },
1231
1184
  "hasDynamicHelp": false,
1232
1185
  "hiddenAliases": [],
1233
- "id": "datasets:create",
1186
+ "id": "evaluators:list",
1234
1187
  "pluginAlias": "@respan/cli",
1235
1188
  "pluginName": "@respan/cli",
1236
1189
  "pluginType": "core",
@@ -1240,25 +1193,20 @@
1240
1193
  "relativePath": [
1241
1194
  "dist",
1242
1195
  "commands",
1243
- "datasets",
1244
- "create.js"
1196
+ "evaluators",
1197
+ "list.js"
1245
1198
  ]
1246
1199
  },
1247
- "datasets:get-span": {
1200
+ "evaluators:run": {
1248
1201
  "aliases": [],
1249
1202
  "args": {
1250
- "dataset-id": {
1251
- "description": "Dataset ID",
1252
- "name": "dataset-id",
1253
- "required": true
1254
- },
1255
- "span-id": {
1256
- "description": "Span ID",
1257
- "name": "span-id",
1203
+ "id": {
1204
+ "description": "Evaluator ID",
1205
+ "name": "id",
1258
1206
  "required": true
1259
1207
  }
1260
1208
  },
1261
- "description": "Get a specific span from a dataset",
1209
+ "description": "Run an evaluator",
1262
1210
  "flags": {
1263
1211
  "api-key": {
1264
1212
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1293,11 +1241,32 @@
1293
1241
  "name": "verbose",
1294
1242
  "allowNo": false,
1295
1243
  "type": "boolean"
1244
+ },
1245
+ "dataset-id": {
1246
+ "description": "Dataset ID to evaluate against",
1247
+ "name": "dataset-id",
1248
+ "hasDynamicHelp": false,
1249
+ "multiple": false,
1250
+ "type": "option"
1251
+ },
1252
+ "log-ids": {
1253
+ "description": "Comma-separated log/span IDs to evaluate",
1254
+ "name": "log-ids",
1255
+ "hasDynamicHelp": false,
1256
+ "multiple": false,
1257
+ "type": "option"
1258
+ },
1259
+ "params": {
1260
+ "description": "Additional parameters as JSON string",
1261
+ "name": "params",
1262
+ "hasDynamicHelp": false,
1263
+ "multiple": false,
1264
+ "type": "option"
1296
1265
  }
1297
1266
  },
1298
1267
  "hasDynamicHelp": false,
1299
1268
  "hiddenAliases": [],
1300
- "id": "datasets:get-span",
1269
+ "id": "evaluators:run",
1301
1270
  "pluginAlias": "@respan/cli",
1302
1271
  "pluginName": "@respan/cli",
1303
1272
  "pluginType": "core",
@@ -1307,20 +1276,20 @@
1307
1276
  "relativePath": [
1308
1277
  "dist",
1309
1278
  "commands",
1310
- "datasets",
1311
- "get-span.js"
1279
+ "evaluators",
1280
+ "run.js"
1312
1281
  ]
1313
1282
  },
1314
- "datasets:get": {
1283
+ "evaluators:update": {
1315
1284
  "aliases": [],
1316
1285
  "args": {
1317
1286
  "id": {
1318
- "description": "Dataset ID",
1287
+ "description": "Evaluator ID",
1319
1288
  "name": "id",
1320
1289
  "required": true
1321
1290
  }
1322
1291
  },
1323
- "description": "Get a specific dataset",
1292
+ "description": "Update an evaluator",
1324
1293
  "flags": {
1325
1294
  "api-key": {
1326
1295
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1355,11 +1324,32 @@
1355
1324
  "name": "verbose",
1356
1325
  "allowNo": false,
1357
1326
  "type": "boolean"
1327
+ },
1328
+ "name": {
1329
+ "description": "Evaluator name",
1330
+ "name": "name",
1331
+ "hasDynamicHelp": false,
1332
+ "multiple": false,
1333
+ "type": "option"
1334
+ },
1335
+ "description": {
1336
+ "description": "Evaluator description",
1337
+ "name": "description",
1338
+ "hasDynamicHelp": false,
1339
+ "multiple": false,
1340
+ "type": "option"
1341
+ },
1342
+ "config": {
1343
+ "description": "Evaluator config as JSON string",
1344
+ "name": "config",
1345
+ "hasDynamicHelp": false,
1346
+ "multiple": false,
1347
+ "type": "option"
1358
1348
  }
1359
1349
  },
1360
1350
  "hasDynamicHelp": false,
1361
1351
  "hiddenAliases": [],
1362
- "id": "datasets:get",
1352
+ "id": "evaluators:update",
1363
1353
  "pluginAlias": "@respan/cli",
1364
1354
  "pluginName": "@respan/cli",
1365
1355
  "pluginType": "core",
@@ -1369,14 +1359,14 @@
1369
1359
  "relativePath": [
1370
1360
  "dist",
1371
1361
  "commands",
1372
- "datasets",
1373
- "get.js"
1362
+ "evaluators",
1363
+ "update.js"
1374
1364
  ]
1375
1365
  },
1376
- "datasets:list": {
1366
+ "experiments:create": {
1377
1367
  "aliases": [],
1378
1368
  "args": {},
1379
- "description": "List datasets",
1369
+ "description": "Create a new experiment",
1380
1370
  "flags": {
1381
1371
  "api-key": {
1382
1372
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1412,18 +1402,32 @@
1412
1402
  "allowNo": false,
1413
1403
  "type": "boolean"
1414
1404
  },
1415
- "limit": {
1416
- "description": "Number of results per page",
1417
- "name": "limit",
1418
- "default": 50,
1405
+ "name": {
1406
+ "description": "Experiment name",
1407
+ "name": "name",
1408
+ "required": true,
1419
1409
  "hasDynamicHelp": false,
1420
1410
  "multiple": false,
1421
1411
  "type": "option"
1422
1412
  },
1423
- "page": {
1424
- "description": "Page number",
1425
- "name": "page",
1426
- "default": 1,
1413
+ "dataset-id": {
1414
+ "description": "Dataset ID",
1415
+ "name": "dataset-id",
1416
+ "required": true,
1417
+ "hasDynamicHelp": false,
1418
+ "multiple": false,
1419
+ "type": "option"
1420
+ },
1421
+ "description": {
1422
+ "description": "Experiment description",
1423
+ "name": "description",
1424
+ "hasDynamicHelp": false,
1425
+ "multiple": false,
1426
+ "type": "option"
1427
+ },
1428
+ "workflows": {
1429
+ "description": "Workflows configuration as JSON string",
1430
+ "name": "workflows",
1427
1431
  "hasDynamicHelp": false,
1428
1432
  "multiple": false,
1429
1433
  "type": "option"
@@ -1431,7 +1435,7 @@
1431
1435
  },
1432
1436
  "hasDynamicHelp": false,
1433
1437
  "hiddenAliases": [],
1434
- "id": "datasets:list",
1438
+ "id": "experiments:create",
1435
1439
  "pluginAlias": "@respan/cli",
1436
1440
  "pluginName": "@respan/cli",
1437
1441
  "pluginType": "core",
@@ -1441,20 +1445,20 @@
1441
1445
  "relativePath": [
1442
1446
  "dist",
1443
1447
  "commands",
1444
- "datasets",
1445
- "list.js"
1448
+ "experiments",
1449
+ "create.js"
1446
1450
  ]
1447
1451
  },
1448
- "datasets:spans": {
1452
+ "experiments:get": {
1449
1453
  "aliases": [],
1450
1454
  "args": {
1451
- "dataset-id": {
1452
- "description": "Dataset ID",
1453
- "name": "dataset-id",
1455
+ "id": {
1456
+ "description": "Experiment ID",
1457
+ "name": "id",
1454
1458
  "required": true
1455
1459
  }
1456
1460
  },
1457
- "description": "List spans in a dataset",
1461
+ "description": "Get a specific experiment",
1458
1462
  "flags": {
1459
1463
  "api-key": {
1460
1464
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1493,7 +1497,7 @@
1493
1497
  },
1494
1498
  "hasDynamicHelp": false,
1495
1499
  "hiddenAliases": [],
1496
- "id": "datasets:spans",
1500
+ "id": "experiments:get",
1497
1501
  "pluginAlias": "@respan/cli",
1498
1502
  "pluginName": "@respan/cli",
1499
1503
  "pluginType": "core",
@@ -1503,20 +1507,14 @@
1503
1507
  "relativePath": [
1504
1508
  "dist",
1505
1509
  "commands",
1506
- "datasets",
1507
- "spans.js"
1510
+ "experiments",
1511
+ "get.js"
1508
1512
  ]
1509
1513
  },
1510
- "datasets:update": {
1514
+ "experiments:list": {
1511
1515
  "aliases": [],
1512
- "args": {
1513
- "id": {
1514
- "description": "Dataset ID",
1515
- "name": "id",
1516
- "required": true
1517
- }
1518
- },
1519
- "description": "Update a dataset",
1516
+ "args": {},
1517
+ "description": "List experiments",
1520
1518
  "flags": {
1521
1519
  "api-key": {
1522
1520
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1552,16 +1550,18 @@
1552
1550
  "allowNo": false,
1553
1551
  "type": "boolean"
1554
1552
  },
1555
- "name": {
1556
- "description": "Dataset name",
1557
- "name": "name",
1553
+ "limit": {
1554
+ "description": "Number of results per page",
1555
+ "name": "limit",
1556
+ "default": 20,
1558
1557
  "hasDynamicHelp": false,
1559
1558
  "multiple": false,
1560
1559
  "type": "option"
1561
1560
  },
1562
- "description": {
1563
- "description": "Dataset description",
1564
- "name": "description",
1561
+ "page": {
1562
+ "description": "Page number",
1563
+ "name": "page",
1564
+ "default": 1,
1565
1565
  "hasDynamicHelp": false,
1566
1566
  "multiple": false,
1567
1567
  "type": "option"
@@ -1569,7 +1569,7 @@
1569
1569
  },
1570
1570
  "hasDynamicHelp": false,
1571
1571
  "hiddenAliases": [],
1572
- "id": "datasets:update",
1572
+ "id": "experiments:list",
1573
1573
  "pluginAlias": "@respan/cli",
1574
1574
  "pluginName": "@respan/cli",
1575
1575
  "pluginType": "core",
@@ -1579,21 +1579,14 @@
1579
1579
  "relativePath": [
1580
1580
  "dist",
1581
1581
  "commands",
1582
- "datasets",
1583
- "update.js"
1582
+ "experiments",
1583
+ "list.js"
1584
1584
  ]
1585
1585
  },
1586
- "integrate:claude-code": {
1586
+ "logs:create": {
1587
1587
  "aliases": [],
1588
1588
  "args": {},
1589
- "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 (default) Both: install hook globally + enable for current project",
1590
- "examples": [
1591
- "respan integrate claude-code",
1592
- "respan integrate claude-code --global",
1593
- "respan integrate claude-code --local --project-id my-project",
1594
- "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
1595
- "respan integrate claude-code --dry-run"
1596
- ],
1589
+ "description": "Create a log span",
1597
1590
  "flags": {
1598
1591
  "api-key": {
1599
1592
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1629,80 +1622,101 @@
1629
1622
  "allowNo": false,
1630
1623
  "type": "boolean"
1631
1624
  },
1632
- "local": {
1633
- "description": "Write per-project config (default)",
1634
- "exclusive": [
1635
- "global"
1636
- ],
1637
- "name": "local",
1638
- "allowNo": false,
1639
- "type": "boolean"
1640
- },
1641
- "global": {
1642
- "description": "Write user-level global config",
1643
- "exclusive": [
1644
- "local"
1645
- ],
1646
- "name": "global",
1647
- "allowNo": false,
1648
- "type": "boolean"
1649
- },
1650
- "project-id": {
1651
- "description": "Respan project ID (added to metadata / resource attributes)",
1652
- "env": "RESPAN_PROJECT_ID",
1653
- "name": "project-id",
1625
+ "input": {
1626
+ "description": "Input text or JSON",
1627
+ "name": "input",
1628
+ "required": true,
1654
1629
  "hasDynamicHelp": false,
1655
1630
  "multiple": false,
1656
1631
  "type": "option"
1657
1632
  },
1658
- "base-url": {
1659
- "description": "Respan API base URL (for enterprise deployments)",
1660
- "name": "base-url",
1661
- "default": "https://api.respan.ai/api",
1633
+ "output": {
1634
+ "description": "Output text or JSON",
1635
+ "name": "output",
1662
1636
  "hasDynamicHelp": false,
1663
1637
  "multiple": false,
1664
1638
  "type": "option"
1665
1639
  },
1666
- "attrs": {
1667
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
1668
- "name": "attrs",
1669
- "default": "{}",
1640
+ "model": {
1641
+ "description": "Model name",
1642
+ "name": "model",
1670
1643
  "hasDynamicHelp": false,
1671
1644
  "multiple": false,
1672
1645
  "type": "option"
1673
1646
  },
1674
- "customer-id": {
1675
- "description": "Customer/user identifier for traces (e.g. your name or email)",
1676
- "env": "RESPAN_CUSTOMER_ID",
1677
- "name": "customer-id",
1647
+ "metadata": {
1648
+ "description": "Metadata as JSON string",
1649
+ "name": "metadata",
1678
1650
  "hasDynamicHelp": false,
1679
1651
  "multiple": false,
1680
1652
  "type": "option"
1681
- },
1682
- "span-name": {
1683
- "description": "Root span name for traces (default: claude-code)",
1684
- "name": "span-name",
1653
+ }
1654
+ },
1655
+ "hasDynamicHelp": false,
1656
+ "hiddenAliases": [],
1657
+ "id": "logs:create",
1658
+ "pluginAlias": "@respan/cli",
1659
+ "pluginName": "@respan/cli",
1660
+ "pluginType": "core",
1661
+ "strict": true,
1662
+ "enableJsonFlag": false,
1663
+ "isESM": true,
1664
+ "relativePath": [
1665
+ "dist",
1666
+ "commands",
1667
+ "logs",
1668
+ "create.js"
1669
+ ]
1670
+ },
1671
+ "logs:get": {
1672
+ "aliases": [],
1673
+ "args": {
1674
+ "id": {
1675
+ "description": "Span ID",
1676
+ "name": "id",
1677
+ "required": true
1678
+ }
1679
+ },
1680
+ "description": "Get a specific log span",
1681
+ "flags": {
1682
+ "api-key": {
1683
+ "description": "API key (env: RESPAN_API_KEY)",
1684
+ "env": "RESPAN_API_KEY",
1685
+ "name": "api-key",
1685
1686
  "hasDynamicHelp": false,
1686
1687
  "multiple": false,
1687
1688
  "type": "option"
1688
1689
  },
1689
- "workflow-name": {
1690
- "description": "Workflow name for traces (default: claude-code)",
1691
- "name": "workflow-name",
1690
+ "profile": {
1691
+ "description": "Named profile to use",
1692
+ "name": "profile",
1692
1693
  "hasDynamicHelp": false,
1693
1694
  "multiple": false,
1694
1695
  "type": "option"
1695
1696
  },
1696
- "dry-run": {
1697
- "description": "Preview changes without writing files",
1698
- "name": "dry-run",
1697
+ "json": {
1698
+ "description": "Output as JSON",
1699
+ "name": "json",
1700
+ "allowNo": false,
1701
+ "type": "boolean"
1702
+ },
1703
+ "csv": {
1704
+ "description": "Output as CSV",
1705
+ "name": "csv",
1706
+ "allowNo": false,
1707
+ "type": "boolean"
1708
+ },
1709
+ "verbose": {
1710
+ "char": "v",
1711
+ "description": "Show verbose output",
1712
+ "name": "verbose",
1699
1713
  "allowNo": false,
1700
1714
  "type": "boolean"
1701
1715
  }
1702
1716
  },
1703
1717
  "hasDynamicHelp": false,
1704
1718
  "hiddenAliases": [],
1705
- "id": "integrate:claude-code",
1719
+ "id": "logs:get",
1706
1720
  "pluginAlias": "@respan/cli",
1707
1721
  "pluginName": "@respan/cli",
1708
1722
  "pluginType": "core",
@@ -1712,21 +1726,14 @@
1712
1726
  "relativePath": [
1713
1727
  "dist",
1714
1728
  "commands",
1715
- "integrate",
1716
- "claude-code.js"
1729
+ "logs",
1730
+ "get.js"
1717
1731
  ]
1718
1732
  },
1719
- "integrate:codex-cli": {
1733
+ "logs:list": {
1720
1734
  "aliases": [],
1721
1735
  "args": {},
1722
- "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 (default) Both: install hook globally + config for current project",
1723
- "examples": [
1724
- "respan integrate codex-cli",
1725
- "respan integrate codex-cli --global",
1726
- "respan integrate codex-cli --local --customer-id frank",
1727
- "respan integrate codex-cli --attrs '{\"env\":\"prod\"}'",
1728
- "respan integrate codex-cli --dry-run"
1729
- ],
1736
+ "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",
1730
1737
  "flags": {
1731
1738
  "api-key": {
1732
1739
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1762,80 +1769,75 @@
1762
1769
  "allowNo": false,
1763
1770
  "type": "boolean"
1764
1771
  },
1765
- "local": {
1766
- "description": "Write per-project config (default)",
1767
- "exclusive": [
1768
- "global"
1769
- ],
1770
- "name": "local",
1771
- "allowNo": false,
1772
- "type": "boolean"
1773
- },
1774
- "global": {
1775
- "description": "Write user-level global config",
1776
- "exclusive": [
1777
- "local"
1778
- ],
1779
- "name": "global",
1780
- "allowNo": false,
1781
- "type": "boolean"
1772
+ "limit": {
1773
+ "description": "Number of results per page (max 1000)",
1774
+ "name": "limit",
1775
+ "default": 50,
1776
+ "hasDynamicHelp": false,
1777
+ "multiple": false,
1778
+ "type": "option"
1782
1779
  },
1783
- "project-id": {
1784
- "description": "Respan project ID (added to metadata / resource attributes)",
1785
- "env": "RESPAN_PROJECT_ID",
1786
- "name": "project-id",
1780
+ "page": {
1781
+ "description": "Page number",
1782
+ "name": "page",
1783
+ "default": 1,
1787
1784
  "hasDynamicHelp": false,
1788
1785
  "multiple": false,
1789
1786
  "type": "option"
1790
1787
  },
1791
- "base-url": {
1792
- "description": "Respan API base URL (for enterprise deployments)",
1793
- "name": "base-url",
1794
- "default": "https://api.respan.ai/api",
1788
+ "sort-by": {
1789
+ "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
1790
+ "name": "sort-by",
1795
1791
  "hasDynamicHelp": false,
1796
1792
  "multiple": false,
1797
1793
  "type": "option"
1798
1794
  },
1799
- "attrs": {
1800
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
1801
- "name": "attrs",
1802
- "default": "{}",
1795
+ "start-time": {
1796
+ "description": "Start time filter (ISO 8601)",
1797
+ "name": "start-time",
1803
1798
  "hasDynamicHelp": false,
1804
1799
  "multiple": false,
1805
1800
  "type": "option"
1806
1801
  },
1807
- "customer-id": {
1808
- "description": "Customer/user identifier for traces (e.g. your name or email)",
1809
- "env": "RESPAN_CUSTOMER_ID",
1810
- "name": "customer-id",
1802
+ "end-time": {
1803
+ "description": "End time filter (ISO 8601)",
1804
+ "name": "end-time",
1811
1805
  "hasDynamicHelp": false,
1812
1806
  "multiple": false,
1813
1807
  "type": "option"
1814
1808
  },
1815
- "span-name": {
1816
- "description": "Root span name for traces (default: claude-code)",
1817
- "name": "span-name",
1809
+ "filter": {
1810
+ "description": "Filter in field:operator:value format (repeatable)",
1811
+ "name": "filter",
1812
+ "hasDynamicHelp": false,
1813
+ "multiple": true,
1814
+ "type": "option"
1815
+ },
1816
+ "all-envs": {
1817
+ "description": "Include all environments (true/false)",
1818
+ "name": "all-envs",
1818
1819
  "hasDynamicHelp": false,
1819
1820
  "multiple": false,
1820
1821
  "type": "option"
1821
1822
  },
1822
- "workflow-name": {
1823
- "description": "Workflow name for traces (default: claude-code)",
1824
- "name": "workflow-name",
1823
+ "is-test": {
1824
+ "description": "Filter by test (true) or production (false) environment",
1825
+ "name": "is-test",
1825
1826
  "hasDynamicHelp": false,
1826
1827
  "multiple": false,
1827
1828
  "type": "option"
1828
1829
  },
1829
- "dry-run": {
1830
- "description": "Preview changes without writing files",
1831
- "name": "dry-run",
1832
- "allowNo": false,
1833
- "type": "boolean"
1830
+ "include-fields": {
1831
+ "description": "Comma-separated fields to include in response",
1832
+ "name": "include-fields",
1833
+ "hasDynamicHelp": false,
1834
+ "multiple": false,
1835
+ "type": "option"
1834
1836
  }
1835
1837
  },
1836
1838
  "hasDynamicHelp": false,
1837
1839
  "hiddenAliases": [],
1838
- "id": "integrate:codex-cli",
1840
+ "id": "logs:list",
1839
1841
  "pluginAlias": "@respan/cli",
1840
1842
  "pluginName": "@respan/cli",
1841
1843
  "pluginType": "core",
@@ -1845,20 +1847,14 @@
1845
1847
  "relativePath": [
1846
1848
  "dist",
1847
1849
  "commands",
1848
- "integrate",
1849
- "codex-cli.js"
1850
+ "logs",
1851
+ "list.js"
1850
1852
  ]
1851
1853
  },
1852
- "integrate:gemini-cli": {
1854
+ "logs:summary": {
1853
1855
  "aliases": [],
1854
1856
  "args": {},
1855
- "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\nNote: Gemini CLI ignores workspace-level telemetry settings, so\n--global is the default.",
1856
- "examples": [
1857
- "respan integrate gemini-cli",
1858
- "respan integrate gemini-cli --local",
1859
- "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
1860
- "respan integrate gemini-cli --dry-run"
1861
- ],
1857
+ "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",
1862
1858
  "flags": {
1863
1859
  "api-key": {
1864
1860
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1894,80 +1890,47 @@
1894
1890
  "allowNo": false,
1895
1891
  "type": "boolean"
1896
1892
  },
1897
- "local": {
1898
- "description": "Write per-project config (default)",
1899
- "exclusive": [
1900
- "global"
1901
- ],
1902
- "name": "local",
1903
- "allowNo": false,
1904
- "type": "boolean"
1893
+ "start-time": {
1894
+ "description": "Start time (ISO 8601)",
1895
+ "name": "start-time",
1896
+ "required": true,
1897
+ "hasDynamicHelp": false,
1898
+ "multiple": false,
1899
+ "type": "option"
1905
1900
  },
1906
- "global": {
1907
- "description": "Write user-level global config",
1908
- "exclusive": [
1909
- "local"
1910
- ],
1911
- "name": "global",
1912
- "allowNo": false,
1913
- "type": "boolean"
1914
- },
1915
- "project-id": {
1916
- "description": "Respan project ID (added to metadata / resource attributes)",
1917
- "env": "RESPAN_PROJECT_ID",
1918
- "name": "project-id",
1919
- "hasDynamicHelp": false,
1920
- "multiple": false,
1921
- "type": "option"
1922
- },
1923
- "base-url": {
1924
- "description": "Respan API base URL (for enterprise deployments)",
1925
- "name": "base-url",
1926
- "default": "https://api.respan.ai/api",
1927
- "hasDynamicHelp": false,
1928
- "multiple": false,
1929
- "type": "option"
1930
- },
1931
- "attrs": {
1932
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
1933
- "name": "attrs",
1934
- "default": "{}",
1901
+ "end-time": {
1902
+ "description": "End time (ISO 8601)",
1903
+ "name": "end-time",
1904
+ "required": true,
1935
1905
  "hasDynamicHelp": false,
1936
1906
  "multiple": false,
1937
1907
  "type": "option"
1938
1908
  },
1939
- "customer-id": {
1940
- "description": "Customer/user identifier for traces (e.g. your name or email)",
1941
- "env": "RESPAN_CUSTOMER_ID",
1942
- "name": "customer-id",
1909
+ "filter": {
1910
+ "description": "Filter in field:operator:value format (repeatable)",
1911
+ "name": "filter",
1943
1912
  "hasDynamicHelp": false,
1944
- "multiple": false,
1913
+ "multiple": true,
1945
1914
  "type": "option"
1946
1915
  },
1947
- "span-name": {
1948
- "description": "Root span name for traces (default: claude-code)",
1949
- "name": "span-name",
1916
+ "all-envs": {
1917
+ "description": "Include all environments (true/false)",
1918
+ "name": "all-envs",
1950
1919
  "hasDynamicHelp": false,
1951
1920
  "multiple": false,
1952
1921
  "type": "option"
1953
1922
  },
1954
- "workflow-name": {
1955
- "description": "Workflow name for traces (default: claude-code)",
1956
- "name": "workflow-name",
1923
+ "is-test": {
1924
+ "description": "Filter by test (true) or production (false) environment",
1925
+ "name": "is-test",
1957
1926
  "hasDynamicHelp": false,
1958
1927
  "multiple": false,
1959
1928
  "type": "option"
1960
- },
1961
- "dry-run": {
1962
- "description": "Preview changes without writing files",
1963
- "name": "dry-run",
1964
- "allowNo": false,
1965
- "type": "boolean"
1966
1929
  }
1967
1930
  },
1968
1931
  "hasDynamicHelp": false,
1969
1932
  "hiddenAliases": [],
1970
- "id": "integrate:gemini-cli",
1933
+ "id": "logs:summary",
1971
1934
  "pluginAlias": "@respan/cli",
1972
1935
  "pluginName": "@respan/cli",
1973
1936
  "pluginType": "core",
@@ -1977,19 +1940,21 @@
1977
1940
  "relativePath": [
1978
1941
  "dist",
1979
1942
  "commands",
1980
- "integrate",
1981
- "gemini-cli.js"
1943
+ "logs",
1944
+ "summary.js"
1982
1945
  ]
1983
1946
  },
1984
- "integrate:opencode": {
1947
+ "integrate:claude-code": {
1985
1948
  "aliases": [],
1986
1949
  "args": {},
1987
- "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.",
1950
+ "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.",
1988
1951
  "examples": [
1989
- "respan integrate opencode",
1990
- "respan integrate opencode --global",
1991
- "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
1992
- "respan integrate opencode --dry-run"
1952
+ "respan integrate claude-code",
1953
+ "respan integrate claude-code --disable",
1954
+ "respan integrate claude-code --global",
1955
+ "respan integrate claude-code --local --project-id my-project",
1956
+ "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
1957
+ "respan integrate claude-code --dry-run"
1993
1958
  ],
1994
1959
  "flags": {
1995
1960
  "api-key": {
@@ -2044,6 +2009,24 @@
2044
2009
  "allowNo": false,
2045
2010
  "type": "boolean"
2046
2011
  },
2012
+ "enable": {
2013
+ "description": "Enable tracing (default)",
2014
+ "exclusive": [
2015
+ "disable"
2016
+ ],
2017
+ "name": "enable",
2018
+ "allowNo": false,
2019
+ "type": "boolean"
2020
+ },
2021
+ "disable": {
2022
+ "description": "Disable tracing",
2023
+ "exclusive": [
2024
+ "enable"
2025
+ ],
2026
+ "name": "disable",
2027
+ "allowNo": false,
2028
+ "type": "boolean"
2029
+ },
2047
2030
  "project-id": {
2048
2031
  "description": "Respan project ID (added to metadata / resource attributes)",
2049
2032
  "env": "RESPAN_PROJECT_ID",
@@ -2099,7 +2082,7 @@
2099
2082
  },
2100
2083
  "hasDynamicHelp": false,
2101
2084
  "hiddenAliases": [],
2102
- "id": "integrate:opencode",
2085
+ "id": "integrate:claude-code",
2103
2086
  "pluginAlias": "@respan/cli",
2104
2087
  "pluginName": "@respan/cli",
2105
2088
  "pluginType": "core",
@@ -2110,13 +2093,21 @@
2110
2093
  "dist",
2111
2094
  "commands",
2112
2095
  "integrate",
2113
- "opencode.js"
2096
+ "claude-code.js"
2114
2097
  ]
2115
2098
  },
2116
- "logs:create": {
2099
+ "integrate:codex-cli": {
2117
2100
  "aliases": [],
2118
2101
  "args": {},
2119
- "description": "Create a log span",
2102
+ "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.",
2103
+ "examples": [
2104
+ "respan integrate codex-cli",
2105
+ "respan integrate codex-cli --disable",
2106
+ "respan integrate codex-cli --global",
2107
+ "respan integrate codex-cli --local --customer-id frank",
2108
+ "respan integrate codex-cli --attrs '{\"env\":\"prod\"}'",
2109
+ "respan integrate codex-cli --dry-run"
2110
+ ],
2120
2111
  "flags": {
2121
2112
  "api-key": {
2122
2113
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2152,101 +2143,98 @@
2152
2143
  "allowNo": false,
2153
2144
  "type": "boolean"
2154
2145
  },
2155
- "input": {
2156
- "description": "Input text or JSON",
2157
- "name": "input",
2158
- "required": true,
2146
+ "local": {
2147
+ "description": "Write per-project config (default)",
2148
+ "exclusive": [
2149
+ "global"
2150
+ ],
2151
+ "name": "local",
2152
+ "allowNo": false,
2153
+ "type": "boolean"
2154
+ },
2155
+ "global": {
2156
+ "description": "Write user-level global config",
2157
+ "exclusive": [
2158
+ "local"
2159
+ ],
2160
+ "name": "global",
2161
+ "allowNo": false,
2162
+ "type": "boolean"
2163
+ },
2164
+ "enable": {
2165
+ "description": "Enable tracing (default)",
2166
+ "exclusive": [
2167
+ "disable"
2168
+ ],
2169
+ "name": "enable",
2170
+ "allowNo": false,
2171
+ "type": "boolean"
2172
+ },
2173
+ "disable": {
2174
+ "description": "Disable tracing",
2175
+ "exclusive": [
2176
+ "enable"
2177
+ ],
2178
+ "name": "disable",
2179
+ "allowNo": false,
2180
+ "type": "boolean"
2181
+ },
2182
+ "project-id": {
2183
+ "description": "Respan project ID (added to metadata / resource attributes)",
2184
+ "env": "RESPAN_PROJECT_ID",
2185
+ "name": "project-id",
2159
2186
  "hasDynamicHelp": false,
2160
2187
  "multiple": false,
2161
2188
  "type": "option"
2162
2189
  },
2163
- "output": {
2164
- "description": "Output text or JSON",
2165
- "name": "output",
2190
+ "base-url": {
2191
+ "description": "Respan API base URL (for enterprise deployments)",
2192
+ "name": "base-url",
2193
+ "default": "https://api.respan.ai/api",
2166
2194
  "hasDynamicHelp": false,
2167
2195
  "multiple": false,
2168
2196
  "type": "option"
2169
2197
  },
2170
- "model": {
2171
- "description": "Model name",
2172
- "name": "model",
2198
+ "attrs": {
2199
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2200
+ "name": "attrs",
2201
+ "default": "{}",
2173
2202
  "hasDynamicHelp": false,
2174
2203
  "multiple": false,
2175
2204
  "type": "option"
2176
2205
  },
2177
- "metadata": {
2178
- "description": "Metadata as JSON string",
2179
- "name": "metadata",
2206
+ "customer-id": {
2207
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2208
+ "env": "RESPAN_CUSTOMER_ID",
2209
+ "name": "customer-id",
2180
2210
  "hasDynamicHelp": false,
2181
2211
  "multiple": false,
2182
2212
  "type": "option"
2183
- }
2184
- },
2185
- "hasDynamicHelp": false,
2186
- "hiddenAliases": [],
2187
- "id": "logs:create",
2188
- "pluginAlias": "@respan/cli",
2189
- "pluginName": "@respan/cli",
2190
- "pluginType": "core",
2191
- "strict": true,
2192
- "enableJsonFlag": false,
2193
- "isESM": true,
2194
- "relativePath": [
2195
- "dist",
2196
- "commands",
2197
- "logs",
2198
- "create.js"
2199
- ]
2200
- },
2201
- "logs:get": {
2202
- "aliases": [],
2203
- "args": {
2204
- "id": {
2205
- "description": "Span ID",
2206
- "name": "id",
2207
- "required": true
2208
- }
2209
- },
2210
- "description": "Get a specific log span",
2211
- "flags": {
2212
- "api-key": {
2213
- "description": "API key (env: RESPAN_API_KEY)",
2214
- "env": "RESPAN_API_KEY",
2215
- "name": "api-key",
2213
+ },
2214
+ "span-name": {
2215
+ "description": "Root span name for traces (default: claude-code)",
2216
+ "name": "span-name",
2216
2217
  "hasDynamicHelp": false,
2217
2218
  "multiple": false,
2218
2219
  "type": "option"
2219
2220
  },
2220
- "profile": {
2221
- "description": "Named profile to use",
2222
- "name": "profile",
2221
+ "workflow-name": {
2222
+ "description": "Workflow name for traces (default: claude-code)",
2223
+ "name": "workflow-name",
2223
2224
  "hasDynamicHelp": false,
2224
2225
  "multiple": false,
2225
2226
  "type": "option"
2226
2227
  },
2227
- "json": {
2228
- "description": "Output as JSON",
2229
- "name": "json",
2230
- "allowNo": false,
2231
- "type": "boolean"
2232
- },
2233
- "csv": {
2234
- "description": "Output as CSV",
2235
- "name": "csv",
2236
- "allowNo": false,
2237
- "type": "boolean"
2238
- },
2239
- "verbose": {
2240
- "char": "v",
2241
- "description": "Show verbose output",
2242
- "name": "verbose",
2228
+ "dry-run": {
2229
+ "description": "Preview changes without writing files",
2230
+ "name": "dry-run",
2243
2231
  "allowNo": false,
2244
2232
  "type": "boolean"
2245
2233
  }
2246
2234
  },
2247
2235
  "hasDynamicHelp": false,
2248
2236
  "hiddenAliases": [],
2249
- "id": "logs:get",
2237
+ "id": "integrate:codex-cli",
2250
2238
  "pluginAlias": "@respan/cli",
2251
2239
  "pluginName": "@respan/cli",
2252
2240
  "pluginType": "core",
@@ -2256,14 +2244,21 @@
2256
2244
  "relativePath": [
2257
2245
  "dist",
2258
2246
  "commands",
2259
- "logs",
2260
- "get.js"
2247
+ "integrate",
2248
+ "codex-cli.js"
2261
2249
  ]
2262
2250
  },
2263
- "logs:list": {
2251
+ "integrate:gemini-cli": {
2264
2252
  "aliases": [],
2265
2253
  "args": {},
2266
- "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",
2254
+ "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.",
2255
+ "examples": [
2256
+ "respan integrate gemini-cli",
2257
+ "respan integrate gemini-cli --disable",
2258
+ "respan integrate gemini-cli --local",
2259
+ "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
2260
+ "respan integrate gemini-cli --dry-run"
2261
+ ],
2267
2262
  "flags": {
2268
2263
  "api-key": {
2269
2264
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2299,75 +2294,98 @@
2299
2294
  "allowNo": false,
2300
2295
  "type": "boolean"
2301
2296
  },
2302
- "limit": {
2303
- "description": "Number of results per page (max 1000)",
2304
- "name": "limit",
2305
- "default": 50,
2306
- "hasDynamicHelp": false,
2307
- "multiple": false,
2308
- "type": "option"
2297
+ "local": {
2298
+ "description": "Write per-project config (default)",
2299
+ "exclusive": [
2300
+ "global"
2301
+ ],
2302
+ "name": "local",
2303
+ "allowNo": false,
2304
+ "type": "boolean"
2309
2305
  },
2310
- "page": {
2311
- "description": "Page number",
2312
- "name": "page",
2313
- "default": 1,
2314
- "hasDynamicHelp": false,
2315
- "multiple": false,
2316
- "type": "option"
2306
+ "global": {
2307
+ "description": "Write user-level global config",
2308
+ "exclusive": [
2309
+ "local"
2310
+ ],
2311
+ "name": "global",
2312
+ "allowNo": false,
2313
+ "type": "boolean"
2317
2314
  },
2318
- "sort-by": {
2319
- "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
2320
- "name": "sort-by",
2321
- "hasDynamicHelp": false,
2322
- "multiple": false,
2323
- "type": "option"
2315
+ "enable": {
2316
+ "description": "Enable tracing (default)",
2317
+ "exclusive": [
2318
+ "disable"
2319
+ ],
2320
+ "name": "enable",
2321
+ "allowNo": false,
2322
+ "type": "boolean"
2324
2323
  },
2325
- "start-time": {
2326
- "description": "Start time filter (ISO 8601)",
2327
- "name": "start-time",
2324
+ "disable": {
2325
+ "description": "Disable tracing",
2326
+ "exclusive": [
2327
+ "enable"
2328
+ ],
2329
+ "name": "disable",
2330
+ "allowNo": false,
2331
+ "type": "boolean"
2332
+ },
2333
+ "project-id": {
2334
+ "description": "Respan project ID (added to metadata / resource attributes)",
2335
+ "env": "RESPAN_PROJECT_ID",
2336
+ "name": "project-id",
2328
2337
  "hasDynamicHelp": false,
2329
2338
  "multiple": false,
2330
2339
  "type": "option"
2331
2340
  },
2332
- "end-time": {
2333
- "description": "End time filter (ISO 8601)",
2334
- "name": "end-time",
2341
+ "base-url": {
2342
+ "description": "Respan API base URL (for enterprise deployments)",
2343
+ "name": "base-url",
2344
+ "default": "https://api.respan.ai/api",
2335
2345
  "hasDynamicHelp": false,
2336
2346
  "multiple": false,
2337
2347
  "type": "option"
2338
2348
  },
2339
- "filter": {
2340
- "description": "Filter in field:operator:value format (repeatable)",
2341
- "name": "filter",
2349
+ "attrs": {
2350
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2351
+ "name": "attrs",
2352
+ "default": "{}",
2342
2353
  "hasDynamicHelp": false,
2343
- "multiple": true,
2354
+ "multiple": false,
2344
2355
  "type": "option"
2345
2356
  },
2346
- "all-envs": {
2347
- "description": "Include all environments (true/false)",
2348
- "name": "all-envs",
2357
+ "customer-id": {
2358
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2359
+ "env": "RESPAN_CUSTOMER_ID",
2360
+ "name": "customer-id",
2349
2361
  "hasDynamicHelp": false,
2350
2362
  "multiple": false,
2351
2363
  "type": "option"
2352
2364
  },
2353
- "is-test": {
2354
- "description": "Filter by test (true) or production (false) environment",
2355
- "name": "is-test",
2365
+ "span-name": {
2366
+ "description": "Root span name for traces (default: claude-code)",
2367
+ "name": "span-name",
2356
2368
  "hasDynamicHelp": false,
2357
2369
  "multiple": false,
2358
2370
  "type": "option"
2359
2371
  },
2360
- "include-fields": {
2361
- "description": "Comma-separated fields to include in response",
2362
- "name": "include-fields",
2372
+ "workflow-name": {
2373
+ "description": "Workflow name for traces (default: claude-code)",
2374
+ "name": "workflow-name",
2363
2375
  "hasDynamicHelp": false,
2364
2376
  "multiple": false,
2365
2377
  "type": "option"
2378
+ },
2379
+ "dry-run": {
2380
+ "description": "Preview changes without writing files",
2381
+ "name": "dry-run",
2382
+ "allowNo": false,
2383
+ "type": "boolean"
2366
2384
  }
2367
2385
  },
2368
2386
  "hasDynamicHelp": false,
2369
2387
  "hiddenAliases": [],
2370
- "id": "logs:list",
2388
+ "id": "integrate:gemini-cli",
2371
2389
  "pluginAlias": "@respan/cli",
2372
2390
  "pluginName": "@respan/cli",
2373
2391
  "pluginType": "core",
@@ -2377,14 +2395,21 @@
2377
2395
  "relativePath": [
2378
2396
  "dist",
2379
2397
  "commands",
2380
- "logs",
2381
- "list.js"
2398
+ "integrate",
2399
+ "gemini-cli.js"
2382
2400
  ]
2383
2401
  },
2384
- "logs:summary": {
2402
+ "integrate:opencode": {
2385
2403
  "aliases": [],
2386
2404
  "args": {},
2387
- "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",
2405
+ "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.",
2406
+ "examples": [
2407
+ "respan integrate opencode",
2408
+ "respan integrate opencode --disable",
2409
+ "respan integrate opencode --global",
2410
+ "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
2411
+ "respan integrate opencode --dry-run"
2412
+ ],
2388
2413
  "flags": {
2389
2414
  "api-key": {
2390
2415
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2420,47 +2445,98 @@
2420
2445
  "allowNo": false,
2421
2446
  "type": "boolean"
2422
2447
  },
2423
- "start-time": {
2424
- "description": "Start time (ISO 8601)",
2425
- "name": "start-time",
2426
- "required": true,
2448
+ "local": {
2449
+ "description": "Write per-project config (default)",
2450
+ "exclusive": [
2451
+ "global"
2452
+ ],
2453
+ "name": "local",
2454
+ "allowNo": false,
2455
+ "type": "boolean"
2456
+ },
2457
+ "global": {
2458
+ "description": "Write user-level global config",
2459
+ "exclusive": [
2460
+ "local"
2461
+ ],
2462
+ "name": "global",
2463
+ "allowNo": false,
2464
+ "type": "boolean"
2465
+ },
2466
+ "enable": {
2467
+ "description": "Enable tracing (default)",
2468
+ "exclusive": [
2469
+ "disable"
2470
+ ],
2471
+ "name": "enable",
2472
+ "allowNo": false,
2473
+ "type": "boolean"
2474
+ },
2475
+ "disable": {
2476
+ "description": "Disable tracing",
2477
+ "exclusive": [
2478
+ "enable"
2479
+ ],
2480
+ "name": "disable",
2481
+ "allowNo": false,
2482
+ "type": "boolean"
2483
+ },
2484
+ "project-id": {
2485
+ "description": "Respan project ID (added to metadata / resource attributes)",
2486
+ "env": "RESPAN_PROJECT_ID",
2487
+ "name": "project-id",
2427
2488
  "hasDynamicHelp": false,
2428
2489
  "multiple": false,
2429
2490
  "type": "option"
2430
2491
  },
2431
- "end-time": {
2432
- "description": "End time (ISO 8601)",
2433
- "name": "end-time",
2434
- "required": true,
2492
+ "base-url": {
2493
+ "description": "Respan API base URL (for enterprise deployments)",
2494
+ "name": "base-url",
2495
+ "default": "https://api.respan.ai/api",
2435
2496
  "hasDynamicHelp": false,
2436
2497
  "multiple": false,
2437
2498
  "type": "option"
2438
2499
  },
2439
- "filter": {
2440
- "description": "Filter in field:operator:value format (repeatable)",
2441
- "name": "filter",
2500
+ "attrs": {
2501
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2502
+ "name": "attrs",
2503
+ "default": "{}",
2442
2504
  "hasDynamicHelp": false,
2443
- "multiple": true,
2505
+ "multiple": false,
2444
2506
  "type": "option"
2445
2507
  },
2446
- "all-envs": {
2447
- "description": "Include all environments (true/false)",
2448
- "name": "all-envs",
2508
+ "customer-id": {
2509
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2510
+ "env": "RESPAN_CUSTOMER_ID",
2511
+ "name": "customer-id",
2449
2512
  "hasDynamicHelp": false,
2450
2513
  "multiple": false,
2451
2514
  "type": "option"
2452
2515
  },
2453
- "is-test": {
2454
- "description": "Filter by test (true) or production (false) environment",
2455
- "name": "is-test",
2516
+ "span-name": {
2517
+ "description": "Root span name for traces (default: claude-code)",
2518
+ "name": "span-name",
2519
+ "hasDynamicHelp": false,
2520
+ "multiple": false,
2521
+ "type": "option"
2522
+ },
2523
+ "workflow-name": {
2524
+ "description": "Workflow name for traces (default: claude-code)",
2525
+ "name": "workflow-name",
2456
2526
  "hasDynamicHelp": false,
2457
2527
  "multiple": false,
2458
2528
  "type": "option"
2529
+ },
2530
+ "dry-run": {
2531
+ "description": "Preview changes without writing files",
2532
+ "name": "dry-run",
2533
+ "allowNo": false,
2534
+ "type": "boolean"
2459
2535
  }
2460
2536
  },
2461
2537
  "hasDynamicHelp": false,
2462
2538
  "hiddenAliases": [],
2463
- "id": "logs:summary",
2539
+ "id": "integrate:opencode",
2464
2540
  "pluginAlias": "@respan/cli",
2465
2541
  "pluginName": "@respan/cli",
2466
2542
  "pluginType": "core",
@@ -2470,8 +2546,8 @@
2470
2546
  "relativePath": [
2471
2547
  "dist",
2472
2548
  "commands",
2473
- "logs",
2474
- "summary.js"
2549
+ "integrate",
2550
+ "opencode.js"
2475
2551
  ]
2476
2552
  },
2477
2553
  "prompts:create-version": {
@@ -3459,5 +3535,5 @@
3459
3535
  ]
3460
3536
  }
3461
3537
  },
3462
- "version": "0.7.1"
3538
+ "version": "0.7.3"
3463
3539
  }