@vibexp/api-client 0.9.0 → 0.11.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.
@@ -671,6 +671,14 @@ export type EmbeddingProvider = {
671
671
  * Maximum number of simultaneous embedding requests VibeXP issues to this provider. Keep at 1 for single-threaded providers.
672
672
  */
673
673
  concurrency: number;
674
+ /**
675
+ * Instruction prefix prepended to search queries before they are embedded (only the text sent to the provider; nothing extra is stored). Asymmetric models require this — e.g. mxbai/BGE English expect "Represent this sentence for searching relevant passages: ", E5 expects "query: ". Empty/null means no prefix (default behaviour).
676
+ */
677
+ query_prefix?: string | null;
678
+ /**
679
+ * Instruction prefix prepended to document chunks before they are embedded (applied only to the text sent to the provider; the stored chunk content is unchanged). E5 expects "passage: "; mxbai/BGE embed documents raw. Changing this invalidates stored vectors and triggers a team re-embed. Empty/null means no prefix (default behaviour).
680
+ */
681
+ document_prefix?: string | null;
674
682
  is_default: boolean;
675
683
  base_url?: string | null;
676
684
  configuration: string;
@@ -703,6 +711,14 @@ export type CreateEmbeddingProviderRequest = {
703
711
  * Optional max simultaneous embedding requests to this provider; defaults to 1 when omitted.
704
712
  */
705
713
  concurrency?: number;
714
+ /**
715
+ * Optional instruction prefix prepended to search queries before embedding. Defaults to empty (no prefix) when omitted.
716
+ */
717
+ query_prefix?: string | null;
718
+ /**
719
+ * Optional instruction prefix prepended to document chunks before embedding. Defaults to empty (no prefix) when omitted.
720
+ */
721
+ document_prefix?: string | null;
706
722
  is_default?: boolean;
707
723
  base_url?: string;
708
724
  api_key?: string | null;
@@ -717,6 +733,14 @@ export type UpdateEmbeddingProviderRequest = {
717
733
  chunk_size?: number;
718
734
  chunk_overlap?: number;
719
735
  concurrency?: number;
736
+ /**
737
+ * Instruction prefix prepended to search queries before embedding. Send an empty string to clear a previously configured prefix.
738
+ */
739
+ query_prefix?: string | null;
740
+ /**
741
+ * Instruction prefix prepended to document chunks before embedding. Changing it triggers a team re-embed. Send an empty string to clear.
742
+ */
743
+ document_prefix?: string | null;
720
744
  is_default?: boolean;
721
745
  base_url?: string;
722
746
  api_key?: string;
@@ -798,6 +822,86 @@ export type EmbeddingCoverageResponse = {
798
822
  */
799
823
  coverage: Array<EmbeddingCoverageItem>;
800
824
  };
825
+ export type ModelProvider = {
826
+ id: string;
827
+ user_id: string;
828
+ /**
829
+ * Team that owns this provider.
830
+ */
831
+ team_id?: string | null;
832
+ name: string;
833
+ provider_type: string;
834
+ /**
835
+ * Chat/completion model this provider requests.
836
+ */
837
+ model: string;
838
+ is_default: boolean;
839
+ base_url?: string | null;
840
+ configuration: string;
841
+ created_at: string;
842
+ updated_at: string;
843
+ /**
844
+ * Optimistic-concurrency version counter, incremented on each update. Note: create responses currently return 0 (the persisted row starts at 1) — read it from get/list/update responses instead.
845
+ */
846
+ version: number;
847
+ };
848
+ export type ModelProviderResponse = ModelProvider & {
849
+ has_api_key: boolean;
850
+ };
851
+ export type CreateModelProviderRequest = {
852
+ name: string;
853
+ provider_type: string;
854
+ /**
855
+ * Chat/completion model to use.
856
+ */
857
+ model: string;
858
+ is_default?: boolean;
859
+ base_url?: string;
860
+ api_key?: string | null;
861
+ configuration?: {
862
+ [key: string]: unknown;
863
+ };
864
+ };
865
+ export type UpdateModelProviderRequest = {
866
+ name?: string;
867
+ provider_type?: string;
868
+ model?: string;
869
+ is_default?: boolean;
870
+ base_url?: string;
871
+ api_key?: string;
872
+ configuration?: {
873
+ [key: string]: unknown;
874
+ };
875
+ };
876
+ export type ModelProviderListResponse = {
877
+ model_providers: Array<ModelProviderResponse>;
878
+ total_count: number;
879
+ page: number;
880
+ per_page: number;
881
+ total_pages: number;
882
+ };
883
+ export type ModelProviderResponseList = Array<ModelProviderResponse>;
884
+ export type ValidateModelProviderRequest = {
885
+ provider_type: string;
886
+ /**
887
+ * Chat/completion model to probe for reachability and auth.
888
+ */
889
+ model: string;
890
+ base_url: string;
891
+ api_key?: string | null;
892
+ configuration?: {
893
+ [key: string]: unknown;
894
+ };
895
+ };
896
+ export type ValidateModelProviderResponse = {
897
+ is_valid: boolean;
898
+ message: string;
899
+ details?: {
900
+ response_time_ms?: number;
901
+ status_code?: number;
902
+ error_details?: string;
903
+ };
904
+ };
801
905
  export type ResourceUsageItem = {
802
906
  /**
803
907
  * Type of resource (e.g., prompt, memory, artifact)
@@ -10525,6 +10629,442 @@ export type ValidateEmbeddingProviderSettingsResponses = {
10525
10629
  200: ValidateEmbeddingProviderResponse;
10526
10630
  };
10527
10631
  export type ValidateEmbeddingProviderSettingsResponse = ValidateEmbeddingProviderSettingsResponses[keyof ValidateEmbeddingProviderSettingsResponses];
10632
+ export type ListModelProvidersData = {
10633
+ body?: never;
10634
+ path: {
10635
+ /**
10636
+ * Team that owns the model provider(s).
10637
+ */
10638
+ team_id: string;
10639
+ };
10640
+ query?: never;
10641
+ url: '/api/v1/{team_id}/model-providers';
10642
+ };
10643
+ export type ListModelProvidersErrors = {
10644
+ /**
10645
+ * Unauthorized
10646
+ */
10647
+ 401: ErrorResponse;
10648
+ /**
10649
+ * Failed to retrieve model providers (`DATABASE_ERROR`)
10650
+ */
10651
+ 500: ErrorResponse;
10652
+ };
10653
+ export type ListModelProvidersError = ListModelProvidersErrors[keyof ListModelProvidersErrors];
10654
+ export type ListModelProvidersResponses = {
10655
+ /**
10656
+ * Model providers retrieved successfully
10657
+ */
10658
+ 200: ModelProviderResponseList;
10659
+ };
10660
+ export type ListModelProvidersResponse = ListModelProvidersResponses[keyof ListModelProvidersResponses];
10661
+ export type CreateModelProviderData = {
10662
+ body: CreateModelProviderRequest;
10663
+ path: {
10664
+ /**
10665
+ * Team that owns the model provider(s).
10666
+ */
10667
+ team_id: string;
10668
+ };
10669
+ query?: never;
10670
+ url: '/api/v1/{team_id}/model-providers';
10671
+ };
10672
+ export type CreateModelProviderErrors = {
10673
+ /**
10674
+ * Malformed JSON body (`BAD_REQUEST`) or missing required fields (`MODEL_PROVIDER_VALIDATION_FAILED` with `validation_errors`)
10675
+ */
10676
+ 400: ErrorResponse;
10677
+ /**
10678
+ * Unauthorized
10679
+ */
10680
+ 401: ErrorResponse;
10681
+ /**
10682
+ * A provider with the same name already exists (`MODEL_PROVIDER_ALREADY_EXISTS`)
10683
+ */
10684
+ 409: ErrorResponse;
10685
+ /**
10686
+ * Provider creation failed (`MODEL_PROVIDER_CREATE_FAILED`)
10687
+ */
10688
+ 500: ErrorResponse;
10689
+ };
10690
+ export type CreateModelProviderError = CreateModelProviderErrors[keyof CreateModelProviderErrors];
10691
+ export type CreateModelProviderResponses = {
10692
+ /**
10693
+ * Model provider created successfully
10694
+ */
10695
+ 200: ModelProviderResponse;
10696
+ };
10697
+ export type CreateModelProviderResponse = CreateModelProviderResponses[keyof CreateModelProviderResponses];
10698
+ export type DeleteModelProviderData = {
10699
+ body?: never;
10700
+ path: {
10701
+ /**
10702
+ * Team that owns the model provider(s).
10703
+ */
10704
+ team_id: string;
10705
+ /**
10706
+ * Model provider ID
10707
+ */
10708
+ id: string;
10709
+ };
10710
+ query?: never;
10711
+ url: '/api/v1/{team_id}/model-providers/{id}';
10712
+ };
10713
+ export type DeleteModelProviderErrors = {
10714
+ /**
10715
+ * Cannot delete the last model provider (`MODEL_PROVIDER_LAST_DELETE_BLOCKED`)
10716
+ */
10717
+ 400: ErrorResponse;
10718
+ /**
10719
+ * Unauthorized
10720
+ */
10721
+ 401: ErrorResponse;
10722
+ /**
10723
+ * Model provider not found (`MODEL_PROVIDER_NOT_FOUND`)
10724
+ */
10725
+ 404: ErrorResponse;
10726
+ /**
10727
+ * Provider deletion failed (`MODEL_PROVIDER_DELETE_FAILED`)
10728
+ */
10729
+ 500: ErrorResponse;
10730
+ };
10731
+ export type DeleteModelProviderError = DeleteModelProviderErrors[keyof DeleteModelProviderErrors];
10732
+ export type DeleteModelProviderResponses = {
10733
+ /**
10734
+ * Model provider deleted successfully (no body)
10735
+ */
10736
+ 204: void;
10737
+ };
10738
+ export type DeleteModelProviderResponse = DeleteModelProviderResponses[keyof DeleteModelProviderResponses];
10739
+ export type GetModelProviderData = {
10740
+ body?: never;
10741
+ path: {
10742
+ /**
10743
+ * Team that owns the model provider(s).
10744
+ */
10745
+ team_id: string;
10746
+ /**
10747
+ * Model provider ID
10748
+ */
10749
+ id: string;
10750
+ };
10751
+ query?: never;
10752
+ url: '/api/v1/{team_id}/model-providers/{id}';
10753
+ };
10754
+ export type GetModelProviderErrors = {
10755
+ /**
10756
+ * Unauthorized
10757
+ */
10758
+ 401: ErrorResponse;
10759
+ /**
10760
+ * Model provider not found (`MODEL_PROVIDER_NOT_FOUND`)
10761
+ */
10762
+ 404: ErrorResponse;
10763
+ /**
10764
+ * Failed to retrieve model provider (`DATABASE_ERROR`)
10765
+ */
10766
+ 500: ErrorResponse;
10767
+ };
10768
+ export type GetModelProviderError = GetModelProviderErrors[keyof GetModelProviderErrors];
10769
+ export type GetModelProviderResponses = {
10770
+ /**
10771
+ * Model provider retrieved successfully
10772
+ */
10773
+ 200: ModelProviderResponse;
10774
+ };
10775
+ export type GetModelProviderResponse = GetModelProviderResponses[keyof GetModelProviderResponses];
10776
+ export type UpdateModelProviderData = {
10777
+ body: UpdateModelProviderRequest;
10778
+ path: {
10779
+ /**
10780
+ * Team that owns the model provider(s).
10781
+ */
10782
+ team_id: string;
10783
+ /**
10784
+ * Model provider ID
10785
+ */
10786
+ id: string;
10787
+ };
10788
+ query?: never;
10789
+ url: '/api/v1/{team_id}/model-providers/{id}';
10790
+ };
10791
+ export type UpdateModelProviderErrors = {
10792
+ /**
10793
+ * Malformed JSON body (`BAD_REQUEST`)
10794
+ */
10795
+ 400: ErrorResponse;
10796
+ /**
10797
+ * Unauthorized
10798
+ */
10799
+ 401: ErrorResponse;
10800
+ /**
10801
+ * Model provider not found (`MODEL_PROVIDER_NOT_FOUND`)
10802
+ */
10803
+ 404: ErrorResponse;
10804
+ /**
10805
+ * Provider update failed (`MODEL_PROVIDER_UPDATE_FAILED`)
10806
+ */
10807
+ 500: ErrorResponse;
10808
+ };
10809
+ export type UpdateModelProviderError = UpdateModelProviderErrors[keyof UpdateModelProviderErrors];
10810
+ export type UpdateModelProviderResponses = {
10811
+ /**
10812
+ * Model provider updated successfully
10813
+ */
10814
+ 200: ModelProviderResponse;
10815
+ };
10816
+ export type UpdateModelProviderResponse = UpdateModelProviderResponses[keyof UpdateModelProviderResponses];
10817
+ export type ValidateModelProviderData = {
10818
+ body: ValidateModelProviderRequest;
10819
+ path: {
10820
+ /**
10821
+ * Team that owns the model provider(s).
10822
+ */
10823
+ team_id: string;
10824
+ };
10825
+ query?: never;
10826
+ url: '/api/v1/{team_id}/model-providers/validate';
10827
+ };
10828
+ export type ValidateModelProviderErrors = {
10829
+ /**
10830
+ * Malformed JSON body (`BAD_REQUEST`) or missing required fields (`MODEL_PROVIDER_VALIDATION_FAILED` with `validation_errors`)
10831
+ */
10832
+ 400: ErrorResponse;
10833
+ /**
10834
+ * Unauthorized
10835
+ */
10836
+ 401: ErrorResponse;
10837
+ /**
10838
+ * Validation failed due to an internal service error (`INTERNAL_ERROR`)
10839
+ */
10840
+ 500: ErrorResponse;
10841
+ };
10842
+ export type ValidateModelProviderError = ValidateModelProviderErrors[keyof ValidateModelProviderErrors];
10843
+ export type ValidateModelProviderResponses = {
10844
+ /**
10845
+ * Validation completed (check `is_valid` for the outcome)
10846
+ */
10847
+ 200: ValidateModelProviderResponse;
10848
+ };
10849
+ export type ValidateModelProviderResponse2 = ValidateModelProviderResponses[keyof ValidateModelProviderResponses];
10850
+ export type ListModelProvidersSettingsData = {
10851
+ body?: never;
10852
+ path: {
10853
+ /**
10854
+ * Team that owns the model provider(s).
10855
+ */
10856
+ team_id: string;
10857
+ };
10858
+ query?: never;
10859
+ url: '/api/v1/{team_id}/settings/model-providers';
10860
+ };
10861
+ export type ListModelProvidersSettingsErrors = {
10862
+ /**
10863
+ * Unauthorized
10864
+ */
10865
+ 401: ErrorResponse;
10866
+ /**
10867
+ * Failed to retrieve model providers (`DATABASE_ERROR`)
10868
+ */
10869
+ 500: ErrorResponse;
10870
+ };
10871
+ export type ListModelProvidersSettingsError = ListModelProvidersSettingsErrors[keyof ListModelProvidersSettingsErrors];
10872
+ export type ListModelProvidersSettingsResponses = {
10873
+ /**
10874
+ * Model providers retrieved successfully
10875
+ */
10876
+ 200: ModelProviderResponseList;
10877
+ };
10878
+ export type ListModelProvidersSettingsResponse = ListModelProvidersSettingsResponses[keyof ListModelProvidersSettingsResponses];
10879
+ export type CreateModelProviderSettingsData = {
10880
+ body: CreateModelProviderRequest;
10881
+ path: {
10882
+ /**
10883
+ * Team that owns the model provider(s).
10884
+ */
10885
+ team_id: string;
10886
+ };
10887
+ query?: never;
10888
+ url: '/api/v1/{team_id}/settings/model-providers';
10889
+ };
10890
+ export type CreateModelProviderSettingsErrors = {
10891
+ /**
10892
+ * Malformed JSON body (`BAD_REQUEST`) or missing required fields (`MODEL_PROVIDER_VALIDATION_FAILED` with `validation_errors`)
10893
+ */
10894
+ 400: ErrorResponse;
10895
+ /**
10896
+ * Unauthorized
10897
+ */
10898
+ 401: ErrorResponse;
10899
+ /**
10900
+ * A provider with the same name already exists (`MODEL_PROVIDER_ALREADY_EXISTS`)
10901
+ */
10902
+ 409: ErrorResponse;
10903
+ /**
10904
+ * Provider creation failed (`MODEL_PROVIDER_CREATE_FAILED`)
10905
+ */
10906
+ 500: ErrorResponse;
10907
+ };
10908
+ export type CreateModelProviderSettingsError = CreateModelProviderSettingsErrors[keyof CreateModelProviderSettingsErrors];
10909
+ export type CreateModelProviderSettingsResponses = {
10910
+ /**
10911
+ * Model provider created successfully
10912
+ */
10913
+ 200: ModelProviderResponse;
10914
+ };
10915
+ export type CreateModelProviderSettingsResponse = CreateModelProviderSettingsResponses[keyof CreateModelProviderSettingsResponses];
10916
+ export type DeleteModelProviderSettingsData = {
10917
+ body?: never;
10918
+ path: {
10919
+ /**
10920
+ * Team that owns the model provider(s).
10921
+ */
10922
+ team_id: string;
10923
+ /**
10924
+ * Model provider ID
10925
+ */
10926
+ id: string;
10927
+ };
10928
+ query?: never;
10929
+ url: '/api/v1/{team_id}/settings/model-providers/{id}';
10930
+ };
10931
+ export type DeleteModelProviderSettingsErrors = {
10932
+ /**
10933
+ * Cannot delete the last model provider (`MODEL_PROVIDER_LAST_DELETE_BLOCKED`)
10934
+ */
10935
+ 400: ErrorResponse;
10936
+ /**
10937
+ * Unauthorized
10938
+ */
10939
+ 401: ErrorResponse;
10940
+ /**
10941
+ * Model provider not found (`MODEL_PROVIDER_NOT_FOUND`)
10942
+ */
10943
+ 404: ErrorResponse;
10944
+ /**
10945
+ * Provider deletion failed (`MODEL_PROVIDER_DELETE_FAILED`)
10946
+ */
10947
+ 500: ErrorResponse;
10948
+ };
10949
+ export type DeleteModelProviderSettingsError = DeleteModelProviderSettingsErrors[keyof DeleteModelProviderSettingsErrors];
10950
+ export type DeleteModelProviderSettingsResponses = {
10951
+ /**
10952
+ * Model provider deleted successfully (no body)
10953
+ */
10954
+ 204: void;
10955
+ };
10956
+ export type DeleteModelProviderSettingsResponse = DeleteModelProviderSettingsResponses[keyof DeleteModelProviderSettingsResponses];
10957
+ export type GetModelProviderSettingsData = {
10958
+ body?: never;
10959
+ path: {
10960
+ /**
10961
+ * Team that owns the model provider(s).
10962
+ */
10963
+ team_id: string;
10964
+ /**
10965
+ * Model provider ID
10966
+ */
10967
+ id: string;
10968
+ };
10969
+ query?: never;
10970
+ url: '/api/v1/{team_id}/settings/model-providers/{id}';
10971
+ };
10972
+ export type GetModelProviderSettingsErrors = {
10973
+ /**
10974
+ * Unauthorized
10975
+ */
10976
+ 401: ErrorResponse;
10977
+ /**
10978
+ * Model provider not found (`MODEL_PROVIDER_NOT_FOUND`)
10979
+ */
10980
+ 404: ErrorResponse;
10981
+ /**
10982
+ * Failed to retrieve model provider (`DATABASE_ERROR`)
10983
+ */
10984
+ 500: ErrorResponse;
10985
+ };
10986
+ export type GetModelProviderSettingsError = GetModelProviderSettingsErrors[keyof GetModelProviderSettingsErrors];
10987
+ export type GetModelProviderSettingsResponses = {
10988
+ /**
10989
+ * Model provider retrieved successfully
10990
+ */
10991
+ 200: ModelProviderResponse;
10992
+ };
10993
+ export type GetModelProviderSettingsResponse = GetModelProviderSettingsResponses[keyof GetModelProviderSettingsResponses];
10994
+ export type UpdateModelProviderSettingsData = {
10995
+ body: UpdateModelProviderRequest;
10996
+ path: {
10997
+ /**
10998
+ * Team that owns the model provider(s).
10999
+ */
11000
+ team_id: string;
11001
+ /**
11002
+ * Model provider ID
11003
+ */
11004
+ id: string;
11005
+ };
11006
+ query?: never;
11007
+ url: '/api/v1/{team_id}/settings/model-providers/{id}';
11008
+ };
11009
+ export type UpdateModelProviderSettingsErrors = {
11010
+ /**
11011
+ * Malformed JSON body (`BAD_REQUEST`)
11012
+ */
11013
+ 400: ErrorResponse;
11014
+ /**
11015
+ * Unauthorized
11016
+ */
11017
+ 401: ErrorResponse;
11018
+ /**
11019
+ * Model provider not found (`MODEL_PROVIDER_NOT_FOUND`)
11020
+ */
11021
+ 404: ErrorResponse;
11022
+ /**
11023
+ * Provider update failed (`MODEL_PROVIDER_UPDATE_FAILED`)
11024
+ */
11025
+ 500: ErrorResponse;
11026
+ };
11027
+ export type UpdateModelProviderSettingsError = UpdateModelProviderSettingsErrors[keyof UpdateModelProviderSettingsErrors];
11028
+ export type UpdateModelProviderSettingsResponses = {
11029
+ /**
11030
+ * Model provider updated successfully
11031
+ */
11032
+ 200: ModelProviderResponse;
11033
+ };
11034
+ export type UpdateModelProviderSettingsResponse = UpdateModelProviderSettingsResponses[keyof UpdateModelProviderSettingsResponses];
11035
+ export type ValidateModelProviderSettingsData = {
11036
+ body: ValidateModelProviderRequest;
11037
+ path: {
11038
+ /**
11039
+ * Team that owns the model provider(s).
11040
+ */
11041
+ team_id: string;
11042
+ };
11043
+ query?: never;
11044
+ url: '/api/v1/{team_id}/settings/model-providers/validate';
11045
+ };
11046
+ export type ValidateModelProviderSettingsErrors = {
11047
+ /**
11048
+ * Malformed JSON body (`BAD_REQUEST`) or missing required fields (`MODEL_PROVIDER_VALIDATION_FAILED` with `validation_errors`)
11049
+ */
11050
+ 400: ErrorResponse;
11051
+ /**
11052
+ * Unauthorized
11053
+ */
11054
+ 401: ErrorResponse;
11055
+ /**
11056
+ * Validation failed due to an internal service error (`INTERNAL_ERROR`)
11057
+ */
11058
+ 500: ErrorResponse;
11059
+ };
11060
+ export type ValidateModelProviderSettingsError = ValidateModelProviderSettingsErrors[keyof ValidateModelProviderSettingsErrors];
11061
+ export type ValidateModelProviderSettingsResponses = {
11062
+ /**
11063
+ * Validation completed (check `is_valid` for the outcome)
11064
+ */
11065
+ 200: ValidateModelProviderResponse;
11066
+ };
11067
+ export type ValidateModelProviderSettingsResponse = ValidateModelProviderSettingsResponses[keyof ValidateModelProviderSettingsResponses];
10528
11068
  export type ListProjectsData = {
10529
11069
  body?: never;
10530
11070
  path: {