@respan/cli 0.5.2 → 0.5.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 (7) hide show
  1. package/dist/assets/codex_hook.py +897 -0
  2. package/dist/commands/integrate/codex-cli.d.ts +8 -0
  3. package/dist/commands/integrate/codex-cli.js +143 -64
  4. package/dist/lib/integrate.d.ts +4 -0
  5. package/dist/lib/integrate.js +8 -0
  6. package/oclif.manifest.json +502 -501
  7. package/package.json +2 -1
package/oclif.manifest.json CHANGED
@@ -428,16 +428,10 @@
428
428
  "set.js"
429
429
  ]
430
430
  },
431
- "datasets:add-spans": {
431
+ "evaluators:create": {
432
432
  "aliases": [],
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",
433
+ "args": {},
434
+ "description": "Create a new evaluator",
441
435
  "flags": {
442
436
  "api-key": {
443
437
  "description": "API key (env: RESPAN_API_KEY)",
@@ -473,18 +467,39 @@
473
467
  "allowNo": false,
474
468
  "type": "boolean"
475
469
  },
476
- "span-ids": {
477
- "description": "Comma-separated span IDs",
478
- "name": "span-ids",
470
+ "name": {
471
+ "description": "Evaluator name",
472
+ "name": "name",
479
473
  "required": true,
480
474
  "hasDynamicHelp": false,
481
475
  "multiple": false,
482
476
  "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"
483
498
  }
484
499
  },
485
500
  "hasDynamicHelp": false,
486
501
  "hiddenAliases": [],
487
- "id": "datasets:add-spans",
502
+ "id": "evaluators:create",
488
503
  "pluginAlias": "@respan/cli",
489
504
  "pluginName": "@respan/cli",
490
505
  "pluginType": "core",
@@ -494,20 +509,20 @@
494
509
  "relativePath": [
495
510
  "dist",
496
511
  "commands",
497
- "datasets",
498
- "add-spans.js"
512
+ "evaluators",
513
+ "create.js"
499
514
  ]
500
515
  },
501
- "datasets:create-span": {
516
+ "evaluators:get": {
502
517
  "aliases": [],
503
518
  "args": {
504
- "dataset-id": {
505
- "description": "Dataset ID",
506
- "name": "dataset-id",
519
+ "id": {
520
+ "description": "Evaluator ID",
521
+ "name": "id",
507
522
  "required": true
508
523
  }
509
524
  },
510
- "description": "Create a span in a dataset",
525
+ "description": "Get a specific evaluator",
511
526
  "flags": {
512
527
  "api-key": {
513
528
  "description": "API key (env: RESPAN_API_KEY)",
@@ -542,19 +557,11 @@
542
557
  "name": "verbose",
543
558
  "allowNo": false,
544
559
  "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"
553
560
  }
554
561
  },
555
562
  "hasDynamicHelp": false,
556
563
  "hiddenAliases": [],
557
- "id": "datasets:create-span",
564
+ "id": "evaluators:get",
558
565
  "pluginAlias": "@respan/cli",
559
566
  "pluginName": "@respan/cli",
560
567
  "pluginType": "core",
@@ -564,14 +571,14 @@
564
571
  "relativePath": [
565
572
  "dist",
566
573
  "commands",
567
- "datasets",
568
- "create-span.js"
574
+ "evaluators",
575
+ "get.js"
569
576
  ]
570
577
  },
571
- "datasets:create": {
578
+ "evaluators:list": {
572
579
  "aliases": [],
573
580
  "args": {},
574
- "description": "Create a new dataset",
581
+ "description": "List evaluators",
575
582
  "flags": {
576
583
  "api-key": {
577
584
  "description": "API key (env: RESPAN_API_KEY)",
@@ -607,17 +614,18 @@
607
614
  "allowNo": false,
608
615
  "type": "boolean"
609
616
  },
610
- "name": {
611
- "description": "Dataset name",
612
- "name": "name",
613
- "required": true,
617
+ "limit": {
618
+ "description": "Number of results per page",
619
+ "name": "limit",
620
+ "default": 20,
614
621
  "hasDynamicHelp": false,
615
622
  "multiple": false,
616
623
  "type": "option"
617
624
  },
618
- "description": {
619
- "description": "Dataset description",
620
- "name": "description",
625
+ "page": {
626
+ "description": "Page number",
627
+ "name": "page",
628
+ "default": 1,
621
629
  "hasDynamicHelp": false,
622
630
  "multiple": false,
623
631
  "type": "option"
@@ -625,7 +633,7 @@
625
633
  },
626
634
  "hasDynamicHelp": false,
627
635
  "hiddenAliases": [],
628
- "id": "datasets:create",
636
+ "id": "evaluators:list",
629
637
  "pluginAlias": "@respan/cli",
630
638
  "pluginName": "@respan/cli",
631
639
  "pluginType": "core",
@@ -635,25 +643,20 @@
635
643
  "relativePath": [
636
644
  "dist",
637
645
  "commands",
638
- "datasets",
639
- "create.js"
646
+ "evaluators",
647
+ "list.js"
640
648
  ]
641
649
  },
642
- "datasets:get-span": {
650
+ "evaluators:run": {
643
651
  "aliases": [],
644
652
  "args": {
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",
653
+ "id": {
654
+ "description": "Evaluator ID",
655
+ "name": "id",
653
656
  "required": true
654
657
  }
655
658
  },
656
- "description": "Get a specific span from a dataset",
659
+ "description": "Run an evaluator",
657
660
  "flags": {
658
661
  "api-key": {
659
662
  "description": "API key (env: RESPAN_API_KEY)",
@@ -688,11 +691,32 @@
688
691
  "name": "verbose",
689
692
  "allowNo": false,
690
693
  "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"
691
715
  }
692
716
  },
693
717
  "hasDynamicHelp": false,
694
718
  "hiddenAliases": [],
695
- "id": "datasets:get-span",
719
+ "id": "evaluators:run",
696
720
  "pluginAlias": "@respan/cli",
697
721
  "pluginName": "@respan/cli",
698
722
  "pluginType": "core",
@@ -702,20 +726,20 @@
702
726
  "relativePath": [
703
727
  "dist",
704
728
  "commands",
705
- "datasets",
706
- "get-span.js"
729
+ "evaluators",
730
+ "run.js"
707
731
  ]
708
732
  },
709
- "datasets:get": {
733
+ "evaluators:update": {
710
734
  "aliases": [],
711
735
  "args": {
712
736
  "id": {
713
- "description": "Dataset ID",
737
+ "description": "Evaluator ID",
714
738
  "name": "id",
715
739
  "required": true
716
740
  }
717
741
  },
718
- "description": "Get a specific dataset",
742
+ "description": "Update an evaluator",
719
743
  "flags": {
720
744
  "api-key": {
721
745
  "description": "API key (env: RESPAN_API_KEY)",
@@ -750,11 +774,32 @@
750
774
  "name": "verbose",
751
775
  "allowNo": false,
752
776
  "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"
753
798
  }
754
799
  },
755
800
  "hasDynamicHelp": false,
756
801
  "hiddenAliases": [],
757
- "id": "datasets:get",
802
+ "id": "evaluators:update",
758
803
  "pluginAlias": "@respan/cli",
759
804
  "pluginName": "@respan/cli",
760
805
  "pluginType": "core",
@@ -764,14 +809,20 @@
764
809
  "relativePath": [
765
810
  "dist",
766
811
  "commands",
767
- "datasets",
768
- "get.js"
812
+ "evaluators",
813
+ "update.js"
769
814
  ]
770
815
  },
771
- "datasets:list": {
816
+ "datasets:add-spans": {
772
817
  "aliases": [],
773
- "args": {},
774
- "description": "List datasets",
818
+ "args": {
819
+ "dataset-id": {
820
+ "description": "Dataset ID",
821
+ "name": "dataset-id",
822
+ "required": true
823
+ }
824
+ },
825
+ "description": "Add existing spans to a dataset",
775
826
  "flags": {
776
827
  "api-key": {
777
828
  "description": "API key (env: RESPAN_API_KEY)",
@@ -807,18 +858,10 @@
807
858
  "allowNo": false,
808
859
  "type": "boolean"
809
860
  },
810
- "limit": {
811
- "description": "Number of results per page",
812
- "name": "limit",
813
- "default": 50,
814
- "hasDynamicHelp": false,
815
- "multiple": false,
816
- "type": "option"
817
- },
818
- "page": {
819
- "description": "Page number",
820
- "name": "page",
821
- "default": 1,
861
+ "span-ids": {
862
+ "description": "Comma-separated span IDs",
863
+ "name": "span-ids",
864
+ "required": true,
822
865
  "hasDynamicHelp": false,
823
866
  "multiple": false,
824
867
  "type": "option"
@@ -826,7 +869,7 @@
826
869
  },
827
870
  "hasDynamicHelp": false,
828
871
  "hiddenAliases": [],
829
- "id": "datasets:list",
872
+ "id": "datasets:add-spans",
830
873
  "pluginAlias": "@respan/cli",
831
874
  "pluginName": "@respan/cli",
832
875
  "pluginType": "core",
@@ -837,10 +880,10 @@
837
880
  "dist",
838
881
  "commands",
839
882
  "datasets",
840
- "list.js"
883
+ "add-spans.js"
841
884
  ]
842
885
  },
843
- "datasets:spans": {
886
+ "datasets:create-span": {
844
887
  "aliases": [],
845
888
  "args": {
846
889
  "dataset-id": {
@@ -849,7 +892,7 @@
849
892
  "required": true
850
893
  }
851
894
  },
852
- "description": "List spans in a dataset",
895
+ "description": "Create a span in a dataset",
853
896
  "flags": {
854
897
  "api-key": {
855
898
  "description": "API key (env: RESPAN_API_KEY)",
@@ -884,11 +927,19 @@
884
927
  "name": "verbose",
885
928
  "allowNo": false,
886
929
  "type": "boolean"
930
+ },
931
+ "body": {
932
+ "description": "Span body as JSON string",
933
+ "name": "body",
934
+ "required": true,
935
+ "hasDynamicHelp": false,
936
+ "multiple": false,
937
+ "type": "option"
887
938
  }
888
939
  },
889
940
  "hasDynamicHelp": false,
890
941
  "hiddenAliases": [],
891
- "id": "datasets:spans",
942
+ "id": "datasets:create-span",
892
943
  "pluginAlias": "@respan/cli",
893
944
  "pluginName": "@respan/cli",
894
945
  "pluginType": "core",
@@ -899,19 +950,13 @@
899
950
  "dist",
900
951
  "commands",
901
952
  "datasets",
902
- "spans.js"
953
+ "create-span.js"
903
954
  ]
904
955
  },
905
- "datasets:update": {
956
+ "datasets:create": {
906
957
  "aliases": [],
907
- "args": {
908
- "id": {
909
- "description": "Dataset ID",
910
- "name": "id",
911
- "required": true
912
- }
913
- },
914
- "description": "Update a dataset",
958
+ "args": {},
959
+ "description": "Create a new dataset",
915
960
  "flags": {
916
961
  "api-key": {
917
962
  "description": "API key (env: RESPAN_API_KEY)",
@@ -950,6 +995,7 @@
950
995
  "name": {
951
996
  "description": "Dataset name",
952
997
  "name": "name",
998
+ "required": true,
953
999
  "hasDynamicHelp": false,
954
1000
  "multiple": false,
955
1001
  "type": "option"
@@ -964,7 +1010,7 @@
964
1010
  },
965
1011
  "hasDynamicHelp": false,
966
1012
  "hiddenAliases": [],
967
- "id": "datasets:update",
1013
+ "id": "datasets:create",
968
1014
  "pluginAlias": "@respan/cli",
969
1015
  "pluginName": "@respan/cli",
970
1016
  "pluginType": "core",
@@ -975,13 +1021,24 @@
975
1021
  "dist",
976
1022
  "commands",
977
1023
  "datasets",
978
- "update.js"
1024
+ "create.js"
979
1025
  ]
980
1026
  },
981
- "evaluators:create": {
1027
+ "datasets:get-span": {
982
1028
  "aliases": [],
983
- "args": {},
984
- "description": "Create a new evaluator",
1029
+ "args": {
1030
+ "dataset-id": {
1031
+ "description": "Dataset ID",
1032
+ "name": "dataset-id",
1033
+ "required": true
1034
+ },
1035
+ "span-id": {
1036
+ "description": "Span ID",
1037
+ "name": "span-id",
1038
+ "required": true
1039
+ }
1040
+ },
1041
+ "description": "Get a specific span from a dataset",
985
1042
  "flags": {
986
1043
  "api-key": {
987
1044
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1016,40 +1073,11 @@
1016
1073
  "name": "verbose",
1017
1074
  "allowNo": false,
1018
1075
  "type": "boolean"
1019
- },
1020
- "name": {
1021
- "description": "Evaluator name",
1022
- "name": "name",
1023
- "required": true,
1024
- "hasDynamicHelp": false,
1025
- "multiple": false,
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"
1048
1076
  }
1049
1077
  },
1050
1078
  "hasDynamicHelp": false,
1051
1079
  "hiddenAliases": [],
1052
- "id": "evaluators:create",
1080
+ "id": "datasets:get-span",
1053
1081
  "pluginAlias": "@respan/cli",
1054
1082
  "pluginName": "@respan/cli",
1055
1083
  "pluginType": "core",
@@ -1059,20 +1087,20 @@
1059
1087
  "relativePath": [
1060
1088
  "dist",
1061
1089
  "commands",
1062
- "evaluators",
1063
- "create.js"
1090
+ "datasets",
1091
+ "get-span.js"
1064
1092
  ]
1065
1093
  },
1066
- "evaluators:get": {
1094
+ "datasets:get": {
1067
1095
  "aliases": [],
1068
1096
  "args": {
1069
1097
  "id": {
1070
- "description": "Evaluator ID",
1098
+ "description": "Dataset ID",
1071
1099
  "name": "id",
1072
1100
  "required": true
1073
1101
  }
1074
1102
  },
1075
- "description": "Get a specific evaluator",
1103
+ "description": "Get a specific dataset",
1076
1104
  "flags": {
1077
1105
  "api-key": {
1078
1106
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1111,7 +1139,7 @@
1111
1139
  },
1112
1140
  "hasDynamicHelp": false,
1113
1141
  "hiddenAliases": [],
1114
- "id": "evaluators:get",
1142
+ "id": "datasets:get",
1115
1143
  "pluginAlias": "@respan/cli",
1116
1144
  "pluginName": "@respan/cli",
1117
1145
  "pluginType": "core",
@@ -1121,14 +1149,14 @@
1121
1149
  "relativePath": [
1122
1150
  "dist",
1123
1151
  "commands",
1124
- "evaluators",
1152
+ "datasets",
1125
1153
  "get.js"
1126
1154
  ]
1127
1155
  },
1128
- "evaluators:list": {
1156
+ "datasets:list": {
1129
1157
  "aliases": [],
1130
1158
  "args": {},
1131
- "description": "List evaluators",
1159
+ "description": "List datasets",
1132
1160
  "flags": {
1133
1161
  "api-key": {
1134
1162
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1167,7 +1195,7 @@
1167
1195
  "limit": {
1168
1196
  "description": "Number of results per page",
1169
1197
  "name": "limit",
1170
- "default": 20,
1198
+ "default": 50,
1171
1199
  "hasDynamicHelp": false,
1172
1200
  "multiple": false,
1173
1201
  "type": "option"
@@ -1183,7 +1211,7 @@
1183
1211
  },
1184
1212
  "hasDynamicHelp": false,
1185
1213
  "hiddenAliases": [],
1186
- "id": "evaluators:list",
1214
+ "id": "datasets:list",
1187
1215
  "pluginAlias": "@respan/cli",
1188
1216
  "pluginName": "@respan/cli",
1189
1217
  "pluginType": "core",
@@ -1193,20 +1221,20 @@
1193
1221
  "relativePath": [
1194
1222
  "dist",
1195
1223
  "commands",
1196
- "evaluators",
1224
+ "datasets",
1197
1225
  "list.js"
1198
1226
  ]
1199
1227
  },
1200
- "evaluators:run": {
1228
+ "datasets:spans": {
1201
1229
  "aliases": [],
1202
1230
  "args": {
1203
- "id": {
1204
- "description": "Evaluator ID",
1205
- "name": "id",
1231
+ "dataset-id": {
1232
+ "description": "Dataset ID",
1233
+ "name": "dataset-id",
1206
1234
  "required": true
1207
1235
  }
1208
1236
  },
1209
- "description": "Run an evaluator",
1237
+ "description": "List spans in a dataset",
1210
1238
  "flags": {
1211
1239
  "api-key": {
1212
1240
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1241,32 +1269,11 @@
1241
1269
  "name": "verbose",
1242
1270
  "allowNo": false,
1243
1271
  "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"
1265
1272
  }
1266
1273
  },
1267
1274
  "hasDynamicHelp": false,
1268
1275
  "hiddenAliases": [],
1269
- "id": "evaluators:run",
1276
+ "id": "datasets:spans",
1270
1277
  "pluginAlias": "@respan/cli",
1271
1278
  "pluginName": "@respan/cli",
1272
1279
  "pluginType": "core",
@@ -1276,20 +1283,20 @@
1276
1283
  "relativePath": [
1277
1284
  "dist",
1278
1285
  "commands",
1279
- "evaluators",
1280
- "run.js"
1286
+ "datasets",
1287
+ "spans.js"
1281
1288
  ]
1282
1289
  },
1283
- "evaluators:update": {
1290
+ "datasets:update": {
1284
1291
  "aliases": [],
1285
1292
  "args": {
1286
1293
  "id": {
1287
- "description": "Evaluator ID",
1294
+ "description": "Dataset ID",
1288
1295
  "name": "id",
1289
1296
  "required": true
1290
1297
  }
1291
1298
  },
1292
- "description": "Update an evaluator",
1299
+ "description": "Update a dataset",
1293
1300
  "flags": {
1294
1301
  "api-key": {
1295
1302
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1326,30 +1333,23 @@
1326
1333
  "type": "boolean"
1327
1334
  },
1328
1335
  "name": {
1329
- "description": "Evaluator name",
1336
+ "description": "Dataset name",
1330
1337
  "name": "name",
1331
1338
  "hasDynamicHelp": false,
1332
1339
  "multiple": false,
1333
1340
  "type": "option"
1334
1341
  },
1335
1342
  "description": {
1336
- "description": "Evaluator description",
1343
+ "description": "Dataset description",
1337
1344
  "name": "description",
1338
1345
  "hasDynamicHelp": false,
1339
1346
  "multiple": false,
1340
1347
  "type": "option"
1341
- },
1342
- "config": {
1343
- "description": "Evaluator config as JSON string",
1344
- "name": "config",
1345
- "hasDynamicHelp": false,
1346
- "multiple": false,
1347
- "type": "option"
1348
1348
  }
1349
1349
  },
1350
1350
  "hasDynamicHelp": false,
1351
1351
  "hiddenAliases": [],
1352
- "id": "evaluators:update",
1352
+ "id": "datasets:update",
1353
1353
  "pluginAlias": "@respan/cli",
1354
1354
  "pluginName": "@respan/cli",
1355
1355
  "pluginType": "core",
@@ -1359,7 +1359,7 @@
1359
1359
  "relativePath": [
1360
1360
  "dist",
1361
1361
  "commands",
1362
- "evaluators",
1362
+ "datasets",
1363
1363
  "update.js"
1364
1364
  ]
1365
1365
  },
@@ -1583,17 +1583,10 @@
1583
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,20 +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\nCodex CLI has native OTel traces (prompts, tool approvals, results)\nso we append an [otel] block to its TOML config.\n\nScope:\n --local Write to .codex/config.toml in project root (default)\n --global Write to ~/.codex/config.toml\n If [otel] already exists in the target file, warns and does not overwrite.",
1723
- "examples": [
1724
- "respan integrate codex-cli",
1725
- "respan integrate codex-cli --global",
1726
- "respan integrate codex-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
1727
- "respan integrate codex-cli --dry-run"
1728
- ],
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",
1729
1737
  "flags": {
1730
1738
  "api-key": {
1731
1739
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1761,80 +1769,75 @@
1761
1769
  "allowNo": false,
1762
1770
  "type": "boolean"
1763
1771
  },
1764
- "local": {
1765
- "description": "Write per-project config (default)",
1766
- "exclusive": [
1767
- "global"
1768
- ],
1769
- "name": "local",
1770
- "allowNo": false,
1771
- "type": "boolean"
1772
- },
1773
- "global": {
1774
- "description": "Write user-level global config",
1775
- "exclusive": [
1776
- "local"
1777
- ],
1778
- "name": "global",
1779
- "allowNo": false,
1780
- "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"
1781
1779
  },
1782
- "project-id": {
1783
- "description": "Respan project ID (added to metadata / resource attributes)",
1784
- "env": "RESPAN_PROJECT_ID",
1785
- "name": "project-id",
1780
+ "page": {
1781
+ "description": "Page number",
1782
+ "name": "page",
1783
+ "default": 1,
1786
1784
  "hasDynamicHelp": false,
1787
1785
  "multiple": false,
1788
1786
  "type": "option"
1789
1787
  },
1790
- "base-url": {
1791
- "description": "Respan API base URL (for enterprise deployments)",
1792
- "name": "base-url",
1793
- "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",
1794
1791
  "hasDynamicHelp": false,
1795
1792
  "multiple": false,
1796
1793
  "type": "option"
1797
1794
  },
1798
- "attrs": {
1799
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
1800
- "name": "attrs",
1801
- "default": "{}",
1795
+ "start-time": {
1796
+ "description": "Start time filter (ISO 8601)",
1797
+ "name": "start-time",
1802
1798
  "hasDynamicHelp": false,
1803
1799
  "multiple": false,
1804
1800
  "type": "option"
1805
1801
  },
1806
- "customer-id": {
1807
- "description": "Customer/user identifier for traces (e.g. your name or email)",
1808
- "env": "RESPAN_CUSTOMER_ID",
1809
- "name": "customer-id",
1802
+ "end-time": {
1803
+ "description": "End time filter (ISO 8601)",
1804
+ "name": "end-time",
1810
1805
  "hasDynamicHelp": false,
1811
1806
  "multiple": false,
1812
1807
  "type": "option"
1813
1808
  },
1814
- "span-name": {
1815
- "description": "Root span name for traces (default: claude-code)",
1816
- "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",
1817
1819
  "hasDynamicHelp": false,
1818
1820
  "multiple": false,
1819
1821
  "type": "option"
1820
1822
  },
1821
- "workflow-name": {
1822
- "description": "Workflow name for traces (default: claude-code)",
1823
- "name": "workflow-name",
1823
+ "is-test": {
1824
+ "description": "Filter by test (true) or production (false) environment",
1825
+ "name": "is-test",
1824
1826
  "hasDynamicHelp": false,
1825
1827
  "multiple": false,
1826
1828
  "type": "option"
1827
1829
  },
1828
- "dry-run": {
1829
- "description": "Preview changes without writing files",
1830
- "name": "dry-run",
1831
- "allowNo": false,
1832
- "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"
1833
1836
  }
1834
1837
  },
1835
1838
  "hasDynamicHelp": false,
1836
1839
  "hiddenAliases": [],
1837
- "id": "integrate:codex-cli",
1840
+ "id": "logs:list",
1838
1841
  "pluginAlias": "@respan/cli",
1839
1842
  "pluginName": "@respan/cli",
1840
1843
  "pluginType": "core",
@@ -1844,20 +1847,14 @@
1844
1847
  "relativePath": [
1845
1848
  "dist",
1846
1849
  "commands",
1847
- "integrate",
1848
- "codex-cli.js"
1850
+ "logs",
1851
+ "list.js"
1849
1852
  ]
1850
1853
  },
1851
- "integrate:gemini-cli": {
1854
+ "logs:summary": {
1852
1855
  "aliases": [],
1853
1856
  "args": {},
1854
- "description": "Integrate Respan with Gemini CLI.\n\nGemini CLI has native OTel traces (tool_call, llm_call, agent_call)\nso we configure it to send telemetry directly to the Respan OTLP\nendpoint.\n\nScope:\n --local Write to .gemini/settings.json in project root (default)\n --global Write to ~/.gemini/settings.json",
1855
- "examples": [
1856
- "respan integrate gemini-cli",
1857
- "respan integrate gemini-cli --global",
1858
- "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
1859
- "respan integrate gemini-cli --dry-run"
1860
- ],
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",
1861
1858
  "flags": {
1862
1859
  "api-key": {
1863
1860
  "description": "API key (env: RESPAN_API_KEY)",
@@ -1893,80 +1890,47 @@
1893
1890
  "allowNo": false,
1894
1891
  "type": "boolean"
1895
1892
  },
1896
- "local": {
1897
- "description": "Write per-project config (default)",
1898
- "exclusive": [
1899
- "global"
1900
- ],
1901
- "name": "local",
1902
- "allowNo": false,
1903
- "type": "boolean"
1904
- },
1905
- "global": {
1906
- "description": "Write user-level global config",
1907
- "exclusive": [
1908
- "local"
1909
- ],
1910
- "name": "global",
1911
- "allowNo": false,
1912
- "type": "boolean"
1913
- },
1914
- "project-id": {
1915
- "description": "Respan project ID (added to metadata / resource attributes)",
1916
- "env": "RESPAN_PROJECT_ID",
1917
- "name": "project-id",
1918
- "hasDynamicHelp": false,
1919
- "multiple": false,
1920
- "type": "option"
1921
- },
1922
- "base-url": {
1923
- "description": "Respan API base URL (for enterprise deployments)",
1924
- "name": "base-url",
1925
- "default": "https://api.respan.ai/api",
1893
+ "start-time": {
1894
+ "description": "Start time (ISO 8601)",
1895
+ "name": "start-time",
1896
+ "required": true,
1926
1897
  "hasDynamicHelp": false,
1927
1898
  "multiple": false,
1928
1899
  "type": "option"
1929
1900
  },
1930
- "attrs": {
1931
- "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
1932
- "name": "attrs",
1933
- "default": "{}",
1901
+ "end-time": {
1902
+ "description": "End time (ISO 8601)",
1903
+ "name": "end-time",
1904
+ "required": true,
1934
1905
  "hasDynamicHelp": false,
1935
1906
  "multiple": false,
1936
1907
  "type": "option"
1937
1908
  },
1938
- "customer-id": {
1939
- "description": "Customer/user identifier for traces (e.g. your name or email)",
1940
- "env": "RESPAN_CUSTOMER_ID",
1941
- "name": "customer-id",
1909
+ "filter": {
1910
+ "description": "Filter in field:operator:value format (repeatable)",
1911
+ "name": "filter",
1942
1912
  "hasDynamicHelp": false,
1943
- "multiple": false,
1913
+ "multiple": true,
1944
1914
  "type": "option"
1945
1915
  },
1946
- "span-name": {
1947
- "description": "Root span name for traces (default: claude-code)",
1948
- "name": "span-name",
1916
+ "all-envs": {
1917
+ "description": "Include all environments (true/false)",
1918
+ "name": "all-envs",
1949
1919
  "hasDynamicHelp": false,
1950
1920
  "multiple": false,
1951
1921
  "type": "option"
1952
1922
  },
1953
- "workflow-name": {
1954
- "description": "Workflow name for traces (default: claude-code)",
1955
- "name": "workflow-name",
1923
+ "is-test": {
1924
+ "description": "Filter by test (true) or production (false) environment",
1925
+ "name": "is-test",
1956
1926
  "hasDynamicHelp": false,
1957
1927
  "multiple": false,
1958
1928
  "type": "option"
1959
- },
1960
- "dry-run": {
1961
- "description": "Preview changes without writing files",
1962
- "name": "dry-run",
1963
- "allowNo": false,
1964
- "type": "boolean"
1965
1929
  }
1966
1930
  },
1967
1931
  "hasDynamicHelp": false,
1968
1932
  "hiddenAliases": [],
1969
- "id": "integrate:gemini-cli",
1933
+ "id": "logs:summary",
1970
1934
  "pluginAlias": "@respan/cli",
1971
1935
  "pluginName": "@respan/cli",
1972
1936
  "pluginType": "core",
@@ -1976,19 +1940,20 @@
1976
1940
  "relativePath": [
1977
1941
  "dist",
1978
1942
  "commands",
1979
- "integrate",
1980
- "gemini-cli.js"
1943
+ "logs",
1944
+ "summary.js"
1981
1945
  ]
1982
1946
  },
1983
- "integrate:opencode": {
1947
+ "integrate:claude-code": {
1984
1948
  "aliases": [],
1985
1949
  "args": {},
1986
- "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 (default) Both: install hook globally + enable for current project",
1987
1951
  "examples": [
1988
- "respan integrate opencode",
1989
- "respan integrate opencode --global",
1990
- "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
1991
- "respan integrate opencode --dry-run"
1952
+ "respan integrate claude-code",
1953
+ "respan integrate claude-code --global",
1954
+ "respan integrate claude-code --local --project-id my-project",
1955
+ "respan integrate claude-code --attrs '{\"env\":\"prod\"}'",
1956
+ "respan integrate claude-code --dry-run"
1992
1957
  ],
1993
1958
  "flags": {
1994
1959
  "api-key": {
@@ -2098,7 +2063,7 @@
2098
2063
  },
2099
2064
  "hasDynamicHelp": false,
2100
2065
  "hiddenAliases": [],
2101
- "id": "integrate:opencode",
2066
+ "id": "integrate:claude-code",
2102
2067
  "pluginAlias": "@respan/cli",
2103
2068
  "pluginName": "@respan/cli",
2104
2069
  "pluginType": "core",
@@ -2109,13 +2074,20 @@
2109
2074
  "dist",
2110
2075
  "commands",
2111
2076
  "integrate",
2112
- "opencode.js"
2077
+ "claude-code.js"
2113
2078
  ]
2114
2079
  },
2115
- "logs:create": {
2080
+ "integrate:codex-cli": {
2116
2081
  "aliases": [],
2117
2082
  "args": {},
2118
- "description": "Create a log span",
2083
+ "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",
2084
+ "examples": [
2085
+ "respan integrate codex-cli",
2086
+ "respan integrate codex-cli --global",
2087
+ "respan integrate codex-cli --local --customer-id frank",
2088
+ "respan integrate codex-cli --attrs '{\"env\":\"prod\"}'",
2089
+ "respan integrate codex-cli --dry-run"
2090
+ ],
2119
2091
  "flags": {
2120
2092
  "api-key": {
2121
2093
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2151,101 +2123,80 @@
2151
2123
  "allowNo": false,
2152
2124
  "type": "boolean"
2153
2125
  },
2154
- "input": {
2155
- "description": "Input text or JSON",
2156
- "name": "input",
2157
- "required": true,
2126
+ "local": {
2127
+ "description": "Write per-project config (default)",
2128
+ "exclusive": [
2129
+ "global"
2130
+ ],
2131
+ "name": "local",
2132
+ "allowNo": false,
2133
+ "type": "boolean"
2134
+ },
2135
+ "global": {
2136
+ "description": "Write user-level global config",
2137
+ "exclusive": [
2138
+ "local"
2139
+ ],
2140
+ "name": "global",
2141
+ "allowNo": false,
2142
+ "type": "boolean"
2143
+ },
2144
+ "project-id": {
2145
+ "description": "Respan project ID (added to metadata / resource attributes)",
2146
+ "env": "RESPAN_PROJECT_ID",
2147
+ "name": "project-id",
2158
2148
  "hasDynamicHelp": false,
2159
2149
  "multiple": false,
2160
2150
  "type": "option"
2161
2151
  },
2162
- "output": {
2163
- "description": "Output text or JSON",
2164
- "name": "output",
2152
+ "base-url": {
2153
+ "description": "Respan API base URL (for enterprise deployments)",
2154
+ "name": "base-url",
2155
+ "default": "https://api.respan.ai/api",
2165
2156
  "hasDynamicHelp": false,
2166
2157
  "multiple": false,
2167
2158
  "type": "option"
2168
2159
  },
2169
- "model": {
2170
- "description": "Model name",
2171
- "name": "model",
2160
+ "attrs": {
2161
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2162
+ "name": "attrs",
2163
+ "default": "{}",
2172
2164
  "hasDynamicHelp": false,
2173
2165
  "multiple": false,
2174
2166
  "type": "option"
2175
2167
  },
2176
- "metadata": {
2177
- "description": "Metadata as JSON string",
2178
- "name": "metadata",
2168
+ "customer-id": {
2169
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2170
+ "env": "RESPAN_CUSTOMER_ID",
2171
+ "name": "customer-id",
2179
2172
  "hasDynamicHelp": false,
2180
2173
  "multiple": false,
2181
2174
  "type": "option"
2182
- }
2183
- },
2184
- "hasDynamicHelp": false,
2185
- "hiddenAliases": [],
2186
- "id": "logs:create",
2187
- "pluginAlias": "@respan/cli",
2188
- "pluginName": "@respan/cli",
2189
- "pluginType": "core",
2190
- "strict": true,
2191
- "enableJsonFlag": false,
2192
- "isESM": true,
2193
- "relativePath": [
2194
- "dist",
2195
- "commands",
2196
- "logs",
2197
- "create.js"
2198
- ]
2199
- },
2200
- "logs:get": {
2201
- "aliases": [],
2202
- "args": {
2203
- "id": {
2204
- "description": "Span ID",
2205
- "name": "id",
2206
- "required": true
2207
- }
2208
- },
2209
- "description": "Get a specific log span",
2210
- "flags": {
2211
- "api-key": {
2212
- "description": "API key (env: RESPAN_API_KEY)",
2213
- "env": "RESPAN_API_KEY",
2214
- "name": "api-key",
2175
+ },
2176
+ "span-name": {
2177
+ "description": "Root span name for traces (default: claude-code)",
2178
+ "name": "span-name",
2215
2179
  "hasDynamicHelp": false,
2216
2180
  "multiple": false,
2217
2181
  "type": "option"
2218
2182
  },
2219
- "profile": {
2220
- "description": "Named profile to use",
2221
- "name": "profile",
2183
+ "workflow-name": {
2184
+ "description": "Workflow name for traces (default: claude-code)",
2185
+ "name": "workflow-name",
2222
2186
  "hasDynamicHelp": false,
2223
2187
  "multiple": false,
2224
2188
  "type": "option"
2225
2189
  },
2226
- "json": {
2227
- "description": "Output as JSON",
2228
- "name": "json",
2229
- "allowNo": false,
2230
- "type": "boolean"
2231
- },
2232
- "csv": {
2233
- "description": "Output as CSV",
2234
- "name": "csv",
2235
- "allowNo": false,
2236
- "type": "boolean"
2237
- },
2238
- "verbose": {
2239
- "char": "v",
2240
- "description": "Show verbose output",
2241
- "name": "verbose",
2190
+ "dry-run": {
2191
+ "description": "Preview changes without writing files",
2192
+ "name": "dry-run",
2242
2193
  "allowNo": false,
2243
2194
  "type": "boolean"
2244
2195
  }
2245
2196
  },
2246
2197
  "hasDynamicHelp": false,
2247
2198
  "hiddenAliases": [],
2248
- "id": "logs:get",
2199
+ "id": "integrate:codex-cli",
2249
2200
  "pluginAlias": "@respan/cli",
2250
2201
  "pluginName": "@respan/cli",
2251
2202
  "pluginType": "core",
@@ -2255,14 +2206,20 @@
2255
2206
  "relativePath": [
2256
2207
  "dist",
2257
2208
  "commands",
2258
- "logs",
2259
- "get.js"
2209
+ "integrate",
2210
+ "codex-cli.js"
2260
2211
  ]
2261
2212
  },
2262
- "logs:list": {
2213
+ "integrate:gemini-cli": {
2263
2214
  "aliases": [],
2264
2215
  "args": {},
2265
- "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",
2216
+ "description": "Integrate Respan with Gemini CLI.\n\nGemini CLI has native OTel traces (tool_call, llm_call, agent_call)\nso we configure it to send telemetry directly to the Respan OTLP\nendpoint.\n\nScope:\n --local Write to .gemini/settings.json in project root (default)\n --global Write to ~/.gemini/settings.json",
2217
+ "examples": [
2218
+ "respan integrate gemini-cli",
2219
+ "respan integrate gemini-cli --global",
2220
+ "respan integrate gemini-cli --project-id my-project --attrs '{\"env\":\"prod\"}'",
2221
+ "respan integrate gemini-cli --dry-run"
2222
+ ],
2266
2223
  "flags": {
2267
2224
  "api-key": {
2268
2225
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2298,75 +2255,80 @@
2298
2255
  "allowNo": false,
2299
2256
  "type": "boolean"
2300
2257
  },
2301
- "limit": {
2302
- "description": "Number of results per page (max 1000)",
2303
- "name": "limit",
2304
- "default": 50,
2305
- "hasDynamicHelp": false,
2306
- "multiple": false,
2307
- "type": "option"
2258
+ "local": {
2259
+ "description": "Write per-project config (default)",
2260
+ "exclusive": [
2261
+ "global"
2262
+ ],
2263
+ "name": "local",
2264
+ "allowNo": false,
2265
+ "type": "boolean"
2308
2266
  },
2309
- "page": {
2310
- "description": "Page number",
2311
- "name": "page",
2312
- "default": 1,
2313
- "hasDynamicHelp": false,
2314
- "multiple": false,
2315
- "type": "option"
2267
+ "global": {
2268
+ "description": "Write user-level global config",
2269
+ "exclusive": [
2270
+ "local"
2271
+ ],
2272
+ "name": "global",
2273
+ "allowNo": false,
2274
+ "type": "boolean"
2316
2275
  },
2317
- "sort-by": {
2318
- "description": "Sort field (prefix with - for descending, e.g. -cost, -latency)",
2319
- "name": "sort-by",
2276
+ "project-id": {
2277
+ "description": "Respan project ID (added to metadata / resource attributes)",
2278
+ "env": "RESPAN_PROJECT_ID",
2279
+ "name": "project-id",
2320
2280
  "hasDynamicHelp": false,
2321
2281
  "multiple": false,
2322
2282
  "type": "option"
2323
2283
  },
2324
- "start-time": {
2325
- "description": "Start time filter (ISO 8601)",
2326
- "name": "start-time",
2284
+ "base-url": {
2285
+ "description": "Respan API base URL (for enterprise deployments)",
2286
+ "name": "base-url",
2287
+ "default": "https://api.respan.ai/api",
2327
2288
  "hasDynamicHelp": false,
2328
2289
  "multiple": false,
2329
2290
  "type": "option"
2330
2291
  },
2331
- "end-time": {
2332
- "description": "End time filter (ISO 8601)",
2333
- "name": "end-time",
2292
+ "attrs": {
2293
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2294
+ "name": "attrs",
2295
+ "default": "{}",
2334
2296
  "hasDynamicHelp": false,
2335
2297
  "multiple": false,
2336
2298
  "type": "option"
2337
2299
  },
2338
- "filter": {
2339
- "description": "Filter in field:operator:value format (repeatable)",
2340
- "name": "filter",
2341
- "hasDynamicHelp": false,
2342
- "multiple": true,
2343
- "type": "option"
2344
- },
2345
- "all-envs": {
2346
- "description": "Include all environments (true/false)",
2347
- "name": "all-envs",
2300
+ "customer-id": {
2301
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2302
+ "env": "RESPAN_CUSTOMER_ID",
2303
+ "name": "customer-id",
2348
2304
  "hasDynamicHelp": false,
2349
2305
  "multiple": false,
2350
2306
  "type": "option"
2351
2307
  },
2352
- "is-test": {
2353
- "description": "Filter by test (true) or production (false) environment",
2354
- "name": "is-test",
2308
+ "span-name": {
2309
+ "description": "Root span name for traces (default: claude-code)",
2310
+ "name": "span-name",
2355
2311
  "hasDynamicHelp": false,
2356
2312
  "multiple": false,
2357
2313
  "type": "option"
2358
2314
  },
2359
- "include-fields": {
2360
- "description": "Comma-separated fields to include in response",
2361
- "name": "include-fields",
2315
+ "workflow-name": {
2316
+ "description": "Workflow name for traces (default: claude-code)",
2317
+ "name": "workflow-name",
2362
2318
  "hasDynamicHelp": false,
2363
2319
  "multiple": false,
2364
2320
  "type": "option"
2321
+ },
2322
+ "dry-run": {
2323
+ "description": "Preview changes without writing files",
2324
+ "name": "dry-run",
2325
+ "allowNo": false,
2326
+ "type": "boolean"
2365
2327
  }
2366
2328
  },
2367
2329
  "hasDynamicHelp": false,
2368
2330
  "hiddenAliases": [],
2369
- "id": "logs:list",
2331
+ "id": "integrate:gemini-cli",
2370
2332
  "pluginAlias": "@respan/cli",
2371
2333
  "pluginName": "@respan/cli",
2372
2334
  "pluginType": "core",
@@ -2376,14 +2338,20 @@
2376
2338
  "relativePath": [
2377
2339
  "dist",
2378
2340
  "commands",
2379
- "logs",
2380
- "list.js"
2341
+ "integrate",
2342
+ "gemini-cli.js"
2381
2343
  ]
2382
2344
  },
2383
- "logs:summary": {
2345
+ "integrate:opencode": {
2384
2346
  "aliases": [],
2385
2347
  "args": {},
2386
- "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",
2348
+ "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.",
2349
+ "examples": [
2350
+ "respan integrate opencode",
2351
+ "respan integrate opencode --global",
2352
+ "respan integrate opencode --project-id my-project --attrs '{\"env\":\"prod\"}'",
2353
+ "respan integrate opencode --dry-run"
2354
+ ],
2387
2355
  "flags": {
2388
2356
  "api-key": {
2389
2357
  "description": "API key (env: RESPAN_API_KEY)",
@@ -2419,47 +2387,80 @@
2419
2387
  "allowNo": false,
2420
2388
  "type": "boolean"
2421
2389
  },
2422
- "start-time": {
2423
- "description": "Start time (ISO 8601)",
2424
- "name": "start-time",
2425
- "required": true,
2390
+ "local": {
2391
+ "description": "Write per-project config (default)",
2392
+ "exclusive": [
2393
+ "global"
2394
+ ],
2395
+ "name": "local",
2396
+ "allowNo": false,
2397
+ "type": "boolean"
2398
+ },
2399
+ "global": {
2400
+ "description": "Write user-level global config",
2401
+ "exclusive": [
2402
+ "local"
2403
+ ],
2404
+ "name": "global",
2405
+ "allowNo": false,
2406
+ "type": "boolean"
2407
+ },
2408
+ "project-id": {
2409
+ "description": "Respan project ID (added to metadata / resource attributes)",
2410
+ "env": "RESPAN_PROJECT_ID",
2411
+ "name": "project-id",
2426
2412
  "hasDynamicHelp": false,
2427
2413
  "multiple": false,
2428
2414
  "type": "option"
2429
2415
  },
2430
- "end-time": {
2431
- "description": "End time (ISO 8601)",
2432
- "name": "end-time",
2433
- "required": true,
2416
+ "base-url": {
2417
+ "description": "Respan API base URL (for enterprise deployments)",
2418
+ "name": "base-url",
2419
+ "default": "https://api.respan.ai/api",
2434
2420
  "hasDynamicHelp": false,
2435
2421
  "multiple": false,
2436
2422
  "type": "option"
2437
2423
  },
2438
- "filter": {
2439
- "description": "Filter in field:operator:value format (repeatable)",
2440
- "name": "filter",
2424
+ "attrs": {
2425
+ "description": "Custom attributes JSON (e.g. '{\"env\":\"prod\"}')",
2426
+ "name": "attrs",
2427
+ "default": "{}",
2441
2428
  "hasDynamicHelp": false,
2442
- "multiple": true,
2429
+ "multiple": false,
2443
2430
  "type": "option"
2444
2431
  },
2445
- "all-envs": {
2446
- "description": "Include all environments (true/false)",
2447
- "name": "all-envs",
2432
+ "customer-id": {
2433
+ "description": "Customer/user identifier for traces (e.g. your name or email)",
2434
+ "env": "RESPAN_CUSTOMER_ID",
2435
+ "name": "customer-id",
2448
2436
  "hasDynamicHelp": false,
2449
2437
  "multiple": false,
2450
2438
  "type": "option"
2451
2439
  },
2452
- "is-test": {
2453
- "description": "Filter by test (true) or production (false) environment",
2454
- "name": "is-test",
2440
+ "span-name": {
2441
+ "description": "Root span name for traces (default: claude-code)",
2442
+ "name": "span-name",
2443
+ "hasDynamicHelp": false,
2444
+ "multiple": false,
2445
+ "type": "option"
2446
+ },
2447
+ "workflow-name": {
2448
+ "description": "Workflow name for traces (default: claude-code)",
2449
+ "name": "workflow-name",
2455
2450
  "hasDynamicHelp": false,
2456
2451
  "multiple": false,
2457
2452
  "type": "option"
2453
+ },
2454
+ "dry-run": {
2455
+ "description": "Preview changes without writing files",
2456
+ "name": "dry-run",
2457
+ "allowNo": false,
2458
+ "type": "boolean"
2458
2459
  }
2459
2460
  },
2460
2461
  "hasDynamicHelp": false,
2461
2462
  "hiddenAliases": [],
2462
- "id": "logs:summary",
2463
+ "id": "integrate:opencode",
2463
2464
  "pluginAlias": "@respan/cli",
2464
2465
  "pluginName": "@respan/cli",
2465
2466
  "pluginType": "core",
@@ -2469,8 +2470,8 @@
2469
2470
  "relativePath": [
2470
2471
  "dist",
2471
2472
  "commands",
2472
- "logs",
2473
- "summary.js"
2473
+ "integrate",
2474
+ "opencode.js"
2474
2475
  ]
2475
2476
  },
2476
2477
  "prompts:create-version": {
@@ -3458,5 +3459,5 @@
3458
3459
  ]
3459
3460
  }
3460
3461
  },
3461
- "version": "0.5.2"
3462
+ "version": "0.5.3"
3462
3463
  }