@snokam/mcp-api 2.3.0 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -163,6 +163,45 @@
163
163
  ]
164
164
  }
165
165
  ]
166
+ },
167
+ "post": {
168
+ "tags": [
169
+ "Documents"
170
+ ],
171
+ "summary": "Upload a new document to a tender",
172
+ "operationId": "UploadTenderDocument",
173
+ "parameters": [
174
+ {
175
+ "name": "id",
176
+ "in": "path",
177
+ "required": true,
178
+ "schema": {
179
+ "type": "string"
180
+ }
181
+ }
182
+ ],
183
+ "responses": {
184
+ "200": {
185
+ "description": "Payload of TenderDocument",
186
+ "content": {
187
+ "application/json": {
188
+ "schema": {
189
+ "$ref": "#/components/schemas/tenderDocument"
190
+ }
191
+ }
192
+ }
193
+ },
194
+ "404": {
195
+ "description": "No description"
196
+ }
197
+ },
198
+ "security": [
199
+ {
200
+ "Implicit": [
201
+ "api://d7f15838-af74-4048-88b3-503089de0064/.default"
202
+ ]
203
+ }
204
+ ]
166
205
  }
167
206
  },
168
207
  "/v1.0/tenders/{id}/documents/{docId}/download-url": {
@@ -306,13 +345,161 @@
306
345
  ]
307
346
  }
308
347
  },
309
- "/v1.0/tenders/{id}/competence-matrix": {
348
+ "/v1.0/tenders/{id}/documents/{docId}": {
349
+ "patch": {
350
+ "tags": [
351
+ "Documents"
352
+ ],
353
+ "summary": "Patch tender document flags (e.g. set as competence matrix source)",
354
+ "operationId": "PatchTenderDocument",
355
+ "parameters": [
356
+ {
357
+ "name": "id",
358
+ "in": "path",
359
+ "required": true,
360
+ "schema": {
361
+ "type": "string"
362
+ }
363
+ },
364
+ {
365
+ "name": "docId",
366
+ "in": "path",
367
+ "required": true,
368
+ "schema": {
369
+ "type": "string"
370
+ }
371
+ }
372
+ ],
373
+ "requestBody": {
374
+ "content": {
375
+ "application/json": {
376
+ "schema": {
377
+ "$ref": "#/components/schemas/patchDocumentRequest"
378
+ }
379
+ }
380
+ },
381
+ "required": true
382
+ },
383
+ "responses": {
384
+ "200": {
385
+ "description": "Payload of PatchDocumentResponse",
386
+ "content": {
387
+ "application/json": {
388
+ "schema": {
389
+ "$ref": "#/components/schemas/patchDocumentResponse"
390
+ }
391
+ }
392
+ }
393
+ },
394
+ "404": {
395
+ "description": "No description"
396
+ }
397
+ },
398
+ "security": [
399
+ {
400
+ "Implicit": [
401
+ "api://d7f15838-af74-4048-88b3-503089de0064/.default"
402
+ ]
403
+ }
404
+ ]
405
+ },
406
+ "delete": {
407
+ "tags": [
408
+ "Documents"
409
+ ],
410
+ "summary": "Delete a tender document (and its blob + related answers)",
411
+ "operationId": "DeleteTenderDocument",
412
+ "parameters": [
413
+ {
414
+ "name": "id",
415
+ "in": "path",
416
+ "required": true,
417
+ "schema": {
418
+ "type": "string"
419
+ }
420
+ },
421
+ {
422
+ "name": "docId",
423
+ "in": "path",
424
+ "required": true,
425
+ "schema": {
426
+ "type": "string"
427
+ }
428
+ }
429
+ ],
430
+ "responses": {
431
+ "204": {
432
+ "description": "No description"
433
+ },
434
+ "404": {
435
+ "description": "No description"
436
+ }
437
+ },
438
+ "security": [
439
+ {
440
+ "Implicit": [
441
+ "api://d7f15838-af74-4048-88b3-503089de0064/.default"
442
+ ]
443
+ }
444
+ ]
445
+ }
446
+ },
447
+ "/v1.0/tenders/{id}/documents/{docId}/extract-questions": {
448
+ "post": {
449
+ "tags": [
450
+ "Documents"
451
+ ],
452
+ "summary": "Start extraction of fillable questions from a document",
453
+ "operationId": "StartQuestionExtraction",
454
+ "parameters": [
455
+ {
456
+ "name": "id",
457
+ "in": "path",
458
+ "required": true,
459
+ "schema": {
460
+ "type": "string"
461
+ }
462
+ },
463
+ {
464
+ "name": "docId",
465
+ "in": "path",
466
+ "required": true,
467
+ "schema": {
468
+ "type": "string"
469
+ }
470
+ }
471
+ ],
472
+ "responses": {
473
+ "202": {
474
+ "description": "Payload of Object",
475
+ "content": {
476
+ "application/json": {
477
+ "schema": {
478
+ "type": "object"
479
+ }
480
+ }
481
+ }
482
+ },
483
+ "404": {
484
+ "description": "No description"
485
+ }
486
+ },
487
+ "security": [
488
+ {
489
+ "Implicit": [
490
+ "api://d7f15838-af74-4048-88b3-503089de0064/.default"
491
+ ]
492
+ }
493
+ ]
494
+ }
495
+ },
496
+ "/v1.0/tenders/{id}/documents/{docId}/fill-questions": {
310
497
  "post": {
311
498
  "tags": [
312
499
  "Documents"
313
500
  ],
314
- "summary": "Start a competence matrix generation job",
315
- "operationId": "StartCompetenceMatrix",
501
+ "summary": "Start filling tender question answers per consultant",
502
+ "operationId": "StartQuestionFill",
316
503
  "parameters": [
317
504
  {
318
505
  "name": "id",
@@ -321,13 +508,21 @@
321
508
  "schema": {
322
509
  "type": "string"
323
510
  }
511
+ },
512
+ {
513
+ "name": "docId",
514
+ "in": "path",
515
+ "required": true,
516
+ "schema": {
517
+ "type": "string"
518
+ }
324
519
  }
325
520
  ],
326
521
  "requestBody": {
327
522
  "content": {
328
523
  "application/json": {
329
524
  "schema": {
330
- "$ref": "#/components/schemas/competenceMatrixRequest"
525
+ "$ref": "#/components/schemas/questionFillRequest"
331
526
  }
332
527
  }
333
528
  },
@@ -357,6 +552,46 @@
357
552
  ]
358
553
  }
359
554
  },
555
+ "/v1.0/consultants": {
556
+ "get": {
557
+ "tags": [
558
+ "Consultants"
559
+ ],
560
+ "summary": "List all known consultants (for manual selection)",
561
+ "operationId": "ListConsultants",
562
+ "parameters": [
563
+ {
564
+ "name": "query",
565
+ "in": "query",
566
+ "schema": {
567
+ "type": "string"
568
+ }
569
+ }
570
+ ],
571
+ "responses": {
572
+ "200": {
573
+ "description": "Payload of Array of ConsultantSummary",
574
+ "content": {
575
+ "application/json": {
576
+ "schema": {
577
+ "type": "array",
578
+ "items": {
579
+ "$ref": "#/components/schemas/consultantSummary"
580
+ }
581
+ }
582
+ }
583
+ }
584
+ }
585
+ },
586
+ "security": [
587
+ {
588
+ "Implicit": [
589
+ "api://d7f15838-af74-4048-88b3-503089de0064/.default"
590
+ ]
591
+ }
592
+ ]
593
+ }
594
+ },
360
595
  "/v1.0/tenders": {
361
596
  "get": {
362
597
  "tags": [
@@ -604,101 +839,83 @@
604
839
  }
605
840
  ]
606
841
  }
607
- },
608
- "/v1.0/tenders/{id}/runs": {
609
- "get": {
610
- "tags": [
611
- "Tenders"
612
- ],
613
- "summary": "List parser runs for a tender",
614
- "operationId": "ListParseRuns",
615
- "parameters": [
616
- {
617
- "name": "id",
618
- "in": "path",
619
- "required": true,
620
- "schema": {
621
- "type": "string"
622
- }
623
- }
624
- ],
625
- "responses": {
626
- "200": {
627
- "description": "Payload of Array of ParseRun",
628
- "content": {
629
- "application/json": {
630
- "schema": {
631
- "type": "array",
632
- "items": {
633
- "$ref": "#/components/schemas/parseRun"
634
- }
635
- }
636
- }
637
- }
638
- }
639
- },
640
- "security": [
641
- {
642
- "Implicit": [
643
- "api://d7f15838-af74-4048-88b3-503089de0064/.default"
644
- ]
645
- }
646
- ]
647
- },
648
- "post": {
649
- "tags": [
650
- "Tenders"
651
- ],
652
- "summary": "Trigger a new parser run on a tender's source files",
653
- "operationId": "CreateParseRun",
654
- "parameters": [
655
- {
656
- "name": "id",
657
- "in": "path",
658
- "required": true,
659
- "schema": {
660
- "type": "string"
661
- }
662
- }
663
- ],
664
- "responses": {
665
- "201": {
666
- "description": "Payload of ParseRun",
667
- "content": {
668
- "application/json": {
669
- "schema": {
670
- "$ref": "#/components/schemas/parseRun"
671
- }
672
- }
673
- }
674
- },
675
- "404": {
676
- "description": "No description"
677
- }
678
- },
679
- "security": [
680
- {
681
- "Implicit": [
682
- "api://d7f15838-af74-4048-88b3-503089de0064/.default"
683
- ]
684
- }
685
- ]
686
- }
687
842
  }
688
843
  },
689
844
  "components": {
690
845
  "schemas": {
691
- "competenceMatrixRequest": {
846
+ "agentJob": {
692
847
  "type": "object",
693
848
  "properties": {
694
- "consultantIds": {
695
- "type": "array",
696
- "items": {
697
- "type": "string"
698
- },
849
+ "id": {
850
+ "type": "string",
851
+ "nullable": true
852
+ },
853
+ "type": {
854
+ "type": "string",
855
+ "nullable": true
856
+ },
857
+ "jobType": {
858
+ "type": "string",
859
+ "nullable": true
860
+ },
861
+ "tenderId": {
862
+ "type": "string",
863
+ "nullable": true
864
+ },
865
+ "status": {
866
+ "type": "string",
867
+ "nullable": true
868
+ },
869
+ "error": {
870
+ "type": "string",
871
+ "nullable": true
872
+ },
873
+ "result": {
874
+ "type": "string",
875
+ "nullable": true
876
+ },
877
+ "startedAt": {
878
+ "type": "string",
879
+ "format": "date-time",
880
+ "nullable": true
881
+ },
882
+ "completedAt": {
883
+ "type": "string",
884
+ "format": "date-time",
885
+ "nullable": true
886
+ },
887
+ "triggeredBy": {
888
+ "type": "string",
889
+ "nullable": true
890
+ },
891
+ "orchestrationId": {
892
+ "type": "string",
893
+ "nullable": true
894
+ }
895
+ },
896
+ "nullable": true
897
+ },
898
+ "consultantAnswers": {
899
+ "type": "object",
900
+ "properties": {
901
+ "consultantId": {
902
+ "type": "string",
903
+ "nullable": true
904
+ },
905
+ "email": {
906
+ "type": "string",
907
+ "nullable": true
908
+ },
909
+ "name": {
910
+ "type": "string",
699
911
  "nullable": true
700
912
  },
701
- "templateDocumentId": {
913
+ "generatedAt": {
914
+ "type": "string",
915
+ "format": "date-time",
916
+ "nullable": true
917
+ },
918
+ "filledDocumentId": {
702
919
  "type": "string",
703
920
  "nullable": true
704
921
  }
@@ -764,63 +981,177 @@
764
981
  }
765
982
  }
766
983
  },
767
- "parseRun": {
984
+ "consultantSummary": {
768
985
  "type": "object",
769
986
  "properties": {
770
- "id": {
987
+ "userId": {
771
988
  "type": "string",
772
989
  "nullable": true
773
990
  },
774
- "type": {
991
+ "email": {
775
992
  "type": "string",
776
993
  "nullable": true
777
994
  },
778
- "tenderId": {
995
+ "name": {
779
996
  "type": "string",
780
997
  "nullable": true
781
998
  },
782
- "sourceFiles": {
999
+ "technologies": {
783
1000
  "type": "array",
784
1001
  "items": {
785
- "$ref": "#/components/schemas/sourceFile"
1002
+ "type": "string"
786
1003
  },
787
1004
  "nullable": true
788
1005
  },
789
- "status": {
1006
+ "roles": {
1007
+ "type": "array",
1008
+ "items": {
1009
+ "type": "string"
1010
+ },
1011
+ "nullable": true
1012
+ },
1013
+ "yearsExperience": {
1014
+ "type": "integer",
1015
+ "format": "int32",
1016
+ "nullable": true
1017
+ }
1018
+ }
1019
+ },
1020
+ "extractedQuestion": {
1021
+ "type": "object",
1022
+ "properties": {
1023
+ "id": {
790
1024
  "type": "string",
791
1025
  "nullable": true
792
1026
  },
793
- "version": {
1027
+ "text": {
794
1028
  "type": "string",
795
1029
  "nullable": true
796
1030
  },
797
- "confidence": {
798
- "type": "number",
799
- "format": "double",
1031
+ "kind": {
1032
+ "type": "string",
800
1033
  "nullable": true
801
1034
  },
802
- "warnings": {
1035
+ "expectedAnswerShape": {
1036
+ "type": "string",
1037
+ "nullable": true
1038
+ },
1039
+ "section": {
1040
+ "type": "string",
1041
+ "nullable": true
1042
+ },
1043
+ "sourceExcerpt": {
1044
+ "type": "string",
1045
+ "nullable": true
1046
+ },
1047
+ "placeholder": {
1048
+ "type": "string",
1049
+ "nullable": true
1050
+ },
1051
+ "currentValue": {
1052
+ "type": "string",
1053
+ "nullable": true
1054
+ },
1055
+ "sourceStrategy": {
1056
+ "type": "string",
1057
+ "nullable": true
1058
+ },
1059
+ "suggestedDataSource": {
1060
+ "type": "string",
1061
+ "nullable": true
1062
+ },
1063
+ "location": {
1064
+ "$ref": "#/components/schemas/questionLocation"
1065
+ }
1066
+ }
1067
+ },
1068
+ "extractedQuestionSet": {
1069
+ "type": "object",
1070
+ "properties": {
1071
+ "isFillable": {
1072
+ "type": "boolean",
1073
+ "nullable": true
1074
+ },
1075
+ "questions": {
803
1076
  "type": "array",
804
1077
  "items": {
805
- "type": "string"
1078
+ "$ref": "#/components/schemas/extractedQuestion"
806
1079
  },
807
1080
  "nullable": true
808
1081
  },
809
- "startedAt": {
1082
+ "extractedAt": {
810
1083
  "type": "string",
811
1084
  "format": "date-time",
812
1085
  "nullable": true
1086
+ }
1087
+ },
1088
+ "nullable": true
1089
+ },
1090
+ "patchDocumentRequest": {
1091
+ "type": "object",
1092
+ "properties": {
1093
+ "isCompetenceMatrixSource": {
1094
+ "type": "boolean",
1095
+ "nullable": true
1096
+ }
1097
+ }
1098
+ },
1099
+ "patchDocumentResponse": {
1100
+ "type": "object",
1101
+ "properties": {
1102
+ "document": {
1103
+ "$ref": "#/components/schemas/tenderDocument"
813
1104
  },
814
- "completedAt": {
1105
+ "extractionJob": {
1106
+ "$ref": "#/components/schemas/agentJob"
1107
+ }
1108
+ }
1109
+ },
1110
+ "questionFillRequest": {
1111
+ "type": "object",
1112
+ "properties": {
1113
+ "consultantEmails": {
1114
+ "type": "array",
1115
+ "items": {
1116
+ "type": "string"
1117
+ },
1118
+ "nullable": true
1119
+ }
1120
+ }
1121
+ },
1122
+ "questionLocation": {
1123
+ "type": "object",
1124
+ "properties": {
1125
+ "xmlPart": {
815
1126
  "type": "string",
816
- "format": "date-time",
817
1127
  "nullable": true
818
1128
  },
819
- "triggeredBy": {
1129
+ "bodyIndex": {
1130
+ "type": "integer",
1131
+ "format": "int32",
1132
+ "nullable": true
1133
+ },
1134
+ "tableIndex": {
1135
+ "type": "integer",
1136
+ "format": "int32",
1137
+ "nullable": true
1138
+ },
1139
+ "rowIndex": {
1140
+ "type": "integer",
1141
+ "format": "int32",
1142
+ "nullable": true
1143
+ },
1144
+ "colIndex": {
1145
+ "type": "integer",
1146
+ "format": "int32",
1147
+ "nullable": true
1148
+ },
1149
+ "sdtId": {
820
1150
  "type": "string",
821
1151
  "nullable": true
822
1152
  }
823
- }
1153
+ },
1154
+ "nullable": true
824
1155
  },
825
1156
  "sourceFile": {
826
1157
  "type": "object",
@@ -1073,6 +1404,37 @@
1073
1404
  "textContent": {
1074
1405
  "type": "string",
1075
1406
  "nullable": true
1407
+ },
1408
+ "isCompetenceMatrixSource": {
1409
+ "type": "boolean",
1410
+ "nullable": true
1411
+ },
1412
+ "classificationReasoning": {
1413
+ "type": "string",
1414
+ "nullable": true
1415
+ },
1416
+ "extractedQuestions": {
1417
+ "$ref": "#/components/schemas/extractedQuestionSet"
1418
+ },
1419
+ "questionAnswers": {
1420
+ "type": "array",
1421
+ "items": {
1422
+ "$ref": "#/components/schemas/consultantAnswers"
1423
+ },
1424
+ "nullable": true
1425
+ },
1426
+ "extractionStatus": {
1427
+ "type": "string",
1428
+ "nullable": true
1429
+ },
1430
+ "extractionError": {
1431
+ "type": "string",
1432
+ "nullable": true
1433
+ },
1434
+ "extractionStartedAt": {
1435
+ "type": "string",
1436
+ "format": "date-time",
1437
+ "nullable": true
1076
1438
  }
1077
1439
  }
1078
1440
  },