@knowledge-stack/ksapi 1.70.3 → 1.72.0

package/.openapi-generator/FILES

@@ -76,6 +76,7 @@ docs/GroupPermissionResponse.md
 docs/GroupResponse.md
 docs/HTTPValidationError.md
 docs/HealthCheckResponse.md
+docs/HybridSearchProfile.md
 docs/IdpConfig.md
 docs/IdpType.md
 docs/ImageTaxonomy.md
@@ -296,6 +297,7 @@ src/models/GroupPermissionResponse.ts
 src/models/GroupResponse.ts
 src/models/HTTPValidationError.ts
 src/models/HealthCheckResponse.ts
+src/models/HybridSearchProfile.ts
 src/models/IdpConfig.ts
 src/models/IdpType.ts
 src/models/ImageTaxonomy.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@1.70.3
+# @knowledge-stack/ksapi@1.72.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -255,6 +255,7 @@ All URIs are relative to *http://localhost:8000*
 - [GroupResponse](docs/GroupResponse.md)
 - [HTTPValidationError](docs/HTTPValidationError.md)
 - [HealthCheckResponse](docs/HealthCheckResponse.md)
+- [HybridSearchProfile](docs/HybridSearchProfile.md)
 - [IdpConfig](docs/IdpConfig.md)
 - [IdpType](docs/IdpType.md)
 - [ImageTaxonomy](docs/ImageTaxonomy.md)
@@ -385,7 +386,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `1.70.3`
+- Package version: `1.72.0`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/ChunksApi.d.ts

@@ -237,7 +237,7 @@ export interface ChunksApiInterface {
      */
     searchChunksRequestOpts(requestParameters: SearchChunksRequest): Promise<runtime.RequestOpts>;
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * @summary Search Chunks Handler
      * @param {ChunkSearchRequest} chunkSearchRequest
      * @param {string} [authorization]
@@ -248,7 +248,7 @@ export interface ChunksApiInterface {
      */
     searchChunksRaw(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ScoredChunkResponse>>>;
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     searchChunks(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ScoredChunkResponse>>;
@@ -400,12 +400,12 @@ export declare class ChunksApi extends runtime.BaseAPI implements ChunksApiInter
      */
     searchChunksRequestOpts(requestParameters: SearchChunksRequest): Promise<runtime.RequestOpts>;
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     searchChunksRaw(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ScoredChunkResponse>>>;
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     searchChunks(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ScoredChunkResponse>>;

package/dist/apis/ChunksApi.js

@@ -364,7 +364,7 @@ class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     searchChunksRaw(requestParameters, initOverrides) {
@@ -375,7 +375,7 @@ class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     searchChunks(requestParameters, initOverrides) {

package/dist/esm/apis/ChunksApi.d.ts

@@ -237,7 +237,7 @@ export interface ChunksApiInterface {
      */
     searchChunksRequestOpts(requestParameters: SearchChunksRequest): Promise<runtime.RequestOpts>;
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * @summary Search Chunks Handler
      * @param {ChunkSearchRequest} chunkSearchRequest
      * @param {string} [authorization]
@@ -248,7 +248,7 @@ export interface ChunksApiInterface {
      */
     searchChunksRaw(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ScoredChunkResponse>>>;
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     searchChunks(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ScoredChunkResponse>>;
@@ -400,12 +400,12 @@ export declare class ChunksApi extends runtime.BaseAPI implements ChunksApiInter
      */
     searchChunksRequestOpts(requestParameters: SearchChunksRequest): Promise<runtime.RequestOpts>;
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     searchChunksRaw(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ScoredChunkResponse>>>;
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     searchChunks(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ScoredChunkResponse>>;

package/dist/esm/apis/ChunksApi.js

@@ -328,7 +328,7 @@ export class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     searchChunksRaw(requestParameters, initOverrides) {
@@ -339,7 +339,7 @@ export class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     searchChunks(requestParameters, initOverrides) {

package/dist/esm/models/ChunkSearchRequest.d.ts

@@ -9,10 +9,11 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import type { HybridSearchProfile } from './HybridSearchProfile';
 import type { ChunkType } from './ChunkType';
 import type { SearchType } from './SearchType';
 /**
- * Request body for chunk search (dense vector or full-text BM25).
+ * Request body for chunk search (dense vector, full-text BM25, or hybrid).
  * @export
  * @interface ChunkSearchRequest
  */
@@ -29,6 +30,24 @@ export interface ChunkSearchRequest {
      * @memberof ChunkSearchRequest
      */
     searchType?: SearchType;
+    /**
+     *
+     * @type {HybridSearchProfile}
+     * @memberof ChunkSearchRequest
+     */
+    hybridProfile?: HybridSearchProfile;
+    /**
+     * Optional explicit weight for the dense branch. Must be provided together with sparse_weight and overrides hybrid_profile.
+     * @type {number}
+     * @memberof ChunkSearchRequest
+     */
+    denseWeight?: number | null;
+    /**
+     * Optional explicit weight for the sparse branch. Must be provided together with dense_weight and overrides hybrid_profile.
+     * @type {number}
+     * @memberof ChunkSearchRequest
+     */
+    sparseWeight?: number | null;
     /**
      * Path part IDs to search within (non-CHUNK types). Defaults to tenant's /shared.
      * @type {Array<string>}

package/dist/esm/models/ChunkSearchRequest.js

@@ -11,6 +11,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import { HybridSearchProfileFromJSON, HybridSearchProfileToJSON, } from './HybridSearchProfile';
 import { ChunkTypeFromJSON, ChunkTypeToJSON, } from './ChunkType';
 import { SearchTypeFromJSON, SearchTypeToJSON, } from './SearchType';
 export const ChunkSearchRequestPropertyValidationAttributesMap = {
@@ -46,6 +47,9 @@ export function ChunkSearchRequestFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'query': json['query'],
         'searchType': json['search_type'] == null ? undefined : SearchTypeFromJSON(json['search_type']),
+        'hybridProfile': json['hybrid_profile'] == null ? undefined : HybridSearchProfileFromJSON(json['hybrid_profile']),
+        'denseWeight': json['dense_weight'] == null ? undefined : json['dense_weight'],
+        'sparseWeight': json['sparse_weight'] == null ? undefined : json['sparse_weight'],
         'parentPathIds': json['parent_path_ids'] == null ? undefined : json['parent_path_ids'],
         'tagIds': json['tag_ids'] == null ? undefined : json['tag_ids'],
         'chunkTypes': json['chunk_types'] == null ? undefined : (json['chunk_types'].map(ChunkTypeFromJSON)),
@@ -66,6 +70,9 @@ export function ChunkSearchRequestToJSONTyped(value, ignoreDiscriminator = false
     return {
         'query': value['query'],
         'search_type': SearchTypeToJSON(value['searchType']),
+        'hybrid_profile': HybridSearchProfileToJSON(value['hybridProfile']),
+        'dense_weight': value['denseWeight'],
+        'sparse_weight': value['sparseWeight'],
         'parent_path_ids': value['parentPathIds'],
         'tag_ids': value['tagIds'],
         'chunk_types': value['chunkTypes'] == null ? undefined : (value['chunkTypes'].map(ChunkTypeToJSON)),

package/dist/esm/models/HybridSearchProfile.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Supported hybrid search weighting presets.
+ * @export
+ */
+export declare const HybridSearchProfile: {
+    readonly Hybrid: "hybrid";
+    readonly Dense: "dense";
+    readonly Sparse: "sparse";
+};
+export type HybridSearchProfile = typeof HybridSearchProfile[keyof typeof HybridSearchProfile];
+export declare function instanceOfHybridSearchProfile(value: any): boolean;
+export declare function HybridSearchProfileFromJSON(json: any): HybridSearchProfile;
+export declare function HybridSearchProfileFromJSONTyped(json: any, ignoreDiscriminator: boolean): HybridSearchProfile;
+export declare function HybridSearchProfileToJSON(value?: HybridSearchProfile | null): any;
+export declare function HybridSearchProfileToJSONTyped(value: any, ignoreDiscriminator: boolean): HybridSearchProfile;

package/dist/esm/models/HybridSearchProfile.js

@@ -0,0 +1,44 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Supported hybrid search weighting presets.
+ * @export
+ */
+export const HybridSearchProfile = {
+    Hybrid: 'hybrid',
+    Dense: 'dense',
+    Sparse: 'sparse'
+};
+export function instanceOfHybridSearchProfile(value) {
+    for (const key in HybridSearchProfile) {
+        if (Object.prototype.hasOwnProperty.call(HybridSearchProfile, key)) {
+            if (HybridSearchProfile[key] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+export function HybridSearchProfileFromJSON(json) {
+    return HybridSearchProfileFromJSONTyped(json, false);
+}
+export function HybridSearchProfileFromJSONTyped(json, ignoreDiscriminator) {
+    return json;
+}
+export function HybridSearchProfileToJSON(value) {
+    return value;
+}
+export function HybridSearchProfileToJSONTyped(value, ignoreDiscriminator) {
+    return value;
+}

package/dist/esm/models/ScoredChunkResponse.d.ts

@@ -14,7 +14,7 @@ import type { ChunkMetadataOutput } from './ChunkMetadataOutput';
 import type { ChunkType } from './ChunkType';
 import type { ChunkDocumentVersionResponse } from './ChunkDocumentVersionResponse';
 /**
- * Chunk response with similarity score.
+ * Chunk response with search ranking score.
  * @export
  * @interface ScoredChunkResponse
  */
@@ -128,7 +128,7 @@ export interface ScoredChunkResponse {
      */
     documentVersion?: ChunkDocumentVersionResponse;
     /**
-     * Cosine similarity score (1 - cosine_distance)
+     * Search ranking score returned by Qdrant
      * @type {number}
      * @memberof ScoredChunkResponse
      */

package/dist/esm/models/SearchType.d.ts

@@ -16,6 +16,7 @@
 export declare const SearchType: {
     readonly DenseOnly: "dense_only";
     readonly FullText: "full_text";
+    readonly Hybrid: "hybrid";
 };
 export type SearchType = typeof SearchType[keyof typeof SearchType];
 export declare function instanceOfSearchType(value: any): boolean;

package/dist/esm/models/SearchType.js

@@ -17,7 +17,8 @@
  */
 export const SearchType = {
     DenseOnly: 'dense_only',
-    FullText: 'full_text'
+    FullText: 'full_text',
+    Hybrid: 'hybrid'
 };
 export function instanceOfSearchType(value) {
     for (const key in SearchType) {

package/dist/esm/models/index.d.ts

@@ -62,6 +62,7 @@ export * from './GroupPermissionResponse';
 export * from './GroupResponse';
 export * from './HTTPValidationError';
 export * from './HealthCheckResponse';
+export * from './HybridSearchProfile';
 export * from './IdpConfig';
 export * from './IdpType';
 export * from './ImageTaxonomy';

package/dist/esm/models/index.js

@@ -64,6 +64,7 @@ export * from './GroupPermissionResponse';
 export * from './GroupResponse';
 export * from './HTTPValidationError';
 export * from './HealthCheckResponse';
+export * from './HybridSearchProfile';
 export * from './IdpConfig';
 export * from './IdpType';
 export * from './ImageTaxonomy';

package/dist/models/ChunkSearchRequest.d.ts

@@ -9,10 +9,11 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import type { HybridSearchProfile } from './HybridSearchProfile';
 import type { ChunkType } from './ChunkType';
 import type { SearchType } from './SearchType';
 /**
- * Request body for chunk search (dense vector or full-text BM25).
+ * Request body for chunk search (dense vector, full-text BM25, or hybrid).
  * @export
  * @interface ChunkSearchRequest
  */
@@ -29,6 +30,24 @@ export interface ChunkSearchRequest {
      * @memberof ChunkSearchRequest
      */
     searchType?: SearchType;
+    /**
+     *
+     * @type {HybridSearchProfile}
+     * @memberof ChunkSearchRequest
+     */
+    hybridProfile?: HybridSearchProfile;
+    /**
+     * Optional explicit weight for the dense branch. Must be provided together with sparse_weight and overrides hybrid_profile.
+     * @type {number}
+     * @memberof ChunkSearchRequest
+     */
+    denseWeight?: number | null;
+    /**
+     * Optional explicit weight for the sparse branch. Must be provided together with dense_weight and overrides hybrid_profile.
+     * @type {number}
+     * @memberof ChunkSearchRequest
+     */
+    sparseWeight?: number | null;
     /**
      * Path part IDs to search within (non-CHUNK types). Defaults to tenant's /shared.
      * @type {Array<string>}

package/dist/models/ChunkSearchRequest.js

@@ -19,6 +19,7 @@ exports.ChunkSearchRequestFromJSON = ChunkSearchRequestFromJSON;
 exports.ChunkSearchRequestFromJSONTyped = ChunkSearchRequestFromJSONTyped;
 exports.ChunkSearchRequestToJSON = ChunkSearchRequestToJSON;
 exports.ChunkSearchRequestToJSONTyped = ChunkSearchRequestToJSONTyped;
+const HybridSearchProfile_1 = require("./HybridSearchProfile");
 const ChunkType_1 = require("./ChunkType");
 const SearchType_1 = require("./SearchType");
 exports.ChunkSearchRequestPropertyValidationAttributesMap = {
@@ -54,6 +55,9 @@ function ChunkSearchRequestFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'query': json['query'],
         'searchType': json['search_type'] == null ? undefined : (0, SearchType_1.SearchTypeFromJSON)(json['search_type']),
+        'hybridProfile': json['hybrid_profile'] == null ? undefined : (0, HybridSearchProfile_1.HybridSearchProfileFromJSON)(json['hybrid_profile']),
+        'denseWeight': json['dense_weight'] == null ? undefined : json['dense_weight'],
+        'sparseWeight': json['sparse_weight'] == null ? undefined : json['sparse_weight'],
         'parentPathIds': json['parent_path_ids'] == null ? undefined : json['parent_path_ids'],
         'tagIds': json['tag_ids'] == null ? undefined : json['tag_ids'],
         'chunkTypes': json['chunk_types'] == null ? undefined : (json['chunk_types'].map(ChunkType_1.ChunkTypeFromJSON)),
@@ -74,6 +78,9 @@ function ChunkSearchRequestToJSONTyped(value, ignoreDiscriminator = false) {
     return {
         'query': value['query'],
         'search_type': (0, SearchType_1.SearchTypeToJSON)(value['searchType']),
+        'hybrid_profile': (0, HybridSearchProfile_1.HybridSearchProfileToJSON)(value['hybridProfile']),
+        'dense_weight': value['denseWeight'],
+        'sparse_weight': value['sparseWeight'],
         'parent_path_ids': value['parentPathIds'],
         'tag_ids': value['tagIds'],
         'chunk_types': value['chunkTypes'] == null ? undefined : (value['chunkTypes'].map(ChunkType_1.ChunkTypeToJSON)),

package/dist/models/HybridSearchProfile.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Supported hybrid search weighting presets.
+ * @export
+ */
+export declare const HybridSearchProfile: {
+    readonly Hybrid: "hybrid";
+    readonly Dense: "dense";
+    readonly Sparse: "sparse";
+};
+export type HybridSearchProfile = typeof HybridSearchProfile[keyof typeof HybridSearchProfile];
+export declare function instanceOfHybridSearchProfile(value: any): boolean;
+export declare function HybridSearchProfileFromJSON(json: any): HybridSearchProfile;
+export declare function HybridSearchProfileFromJSONTyped(json: any, ignoreDiscriminator: boolean): HybridSearchProfile;
+export declare function HybridSearchProfileToJSON(value?: HybridSearchProfile | null): any;
+export declare function HybridSearchProfileToJSONTyped(value: any, ignoreDiscriminator: boolean): HybridSearchProfile;

package/dist/models/HybridSearchProfile.js

@@ -0,0 +1,52 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HybridSearchProfile = void 0;
+exports.instanceOfHybridSearchProfile = instanceOfHybridSearchProfile;
+exports.HybridSearchProfileFromJSON = HybridSearchProfileFromJSON;
+exports.HybridSearchProfileFromJSONTyped = HybridSearchProfileFromJSONTyped;
+exports.HybridSearchProfileToJSON = HybridSearchProfileToJSON;
+exports.HybridSearchProfileToJSONTyped = HybridSearchProfileToJSONTyped;
+/**
+ * Supported hybrid search weighting presets.
+ * @export
+ */
+exports.HybridSearchProfile = {
+    Hybrid: 'hybrid',
+    Dense: 'dense',
+    Sparse: 'sparse'
+};
+function instanceOfHybridSearchProfile(value) {
+    for (const key in exports.HybridSearchProfile) {
+        if (Object.prototype.hasOwnProperty.call(exports.HybridSearchProfile, key)) {
+            if (exports.HybridSearchProfile[key] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+function HybridSearchProfileFromJSON(json) {
+    return HybridSearchProfileFromJSONTyped(json, false);
+}
+function HybridSearchProfileFromJSONTyped(json, ignoreDiscriminator) {
+    return json;
+}
+function HybridSearchProfileToJSON(value) {
+    return value;
+}
+function HybridSearchProfileToJSONTyped(value, ignoreDiscriminator) {
+    return value;
+}

package/dist/models/ScoredChunkResponse.d.ts

@@ -14,7 +14,7 @@ import type { ChunkMetadataOutput } from './ChunkMetadataOutput';
 import type { ChunkType } from './ChunkType';
 import type { ChunkDocumentVersionResponse } from './ChunkDocumentVersionResponse';
 /**
- * Chunk response with similarity score.
+ * Chunk response with search ranking score.
  * @export
  * @interface ScoredChunkResponse
  */
@@ -128,7 +128,7 @@ export interface ScoredChunkResponse {
      */
     documentVersion?: ChunkDocumentVersionResponse;
     /**
-     * Cosine similarity score (1 - cosine_distance)
+     * Search ranking score returned by Qdrant
      * @type {number}
      * @memberof ScoredChunkResponse
      */

package/dist/models/SearchType.d.ts

@@ -16,6 +16,7 @@
 export declare const SearchType: {
     readonly DenseOnly: "dense_only";
     readonly FullText: "full_text";
+    readonly Hybrid: "hybrid";
 };
 export type SearchType = typeof SearchType[keyof typeof SearchType];
 export declare function instanceOfSearchType(value: any): boolean;

package/dist/models/SearchType.js

@@ -25,7 +25,8 @@ exports.SearchTypeToJSONTyped = SearchTypeToJSONTyped;
  */
 exports.SearchType = {
     DenseOnly: 'dense_only',
-    FullText: 'full_text'
+    FullText: 'full_text',
+    Hybrid: 'hybrid'
 };
 function instanceOfSearchType(value) {
     for (const key in exports.SearchType) {

package/dist/models/index.d.ts

@@ -62,6 +62,7 @@ export * from './GroupPermissionResponse';
 export * from './GroupResponse';
 export * from './HTTPValidationError';
 export * from './HealthCheckResponse';
+export * from './HybridSearchProfile';
 export * from './IdpConfig';
 export * from './IdpType';
 export * from './ImageTaxonomy';

package/dist/models/index.js

@@ -80,6 +80,7 @@ __exportStar(require("./GroupPermissionResponse"), exports);
 __exportStar(require("./GroupResponse"), exports);
 __exportStar(require("./HTTPValidationError"), exports);
 __exportStar(require("./HealthCheckResponse"), exports);
+__exportStar(require("./HybridSearchProfile"), exports);
 __exportStar(require("./IdpConfig"), exports);
 __exportStar(require("./IdpType"), exports);
 __exportStar(require("./ImageTaxonomy"), exports);

package/docs/ChunkSearchRequest.md

@@ -1,7 +1,7 @@
 
 # ChunkSearchRequest
 
-Request body for chunk search (dense vector or full-text BM25).
+Request body for chunk search (dense vector, full-text BM25, or hybrid).
 
 ## Properties
 
@@ -9,6 +9,9 @@ Name | Type
 ------------ | -------------
 `query` | string
 `searchType` | [SearchType](SearchType.md)
+`hybridProfile` | [HybridSearchProfile](HybridSearchProfile.md)
+`denseWeight` | number
+`sparseWeight` | number
 `parentPathIds` | Array<string>
 `tagIds` | Array<string>
 `chunkTypes` | [Array<ChunkType>](ChunkType.md)
@@ -27,6 +30,9 @@ import type { ChunkSearchRequest } from '@knowledge-stack/ksapi'
 const example = {
   "query": null,
   "searchType": null,
+  "hybridProfile": null,
+  "denseWeight": null,
+  "sparseWeight": null,
   "parentPathIds": null,
   "tagIds": null,
   "chunkTypes": null,

package/docs/ChunksApi.md

@@ -478,7 +478,7 @@ No authorization required
 
 Search Chunks Handler
 
-Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
 
 ### Example
 

package/docs/HybridSearchProfile.md

@@ -0,0 +1,33 @@
+
+# HybridSearchProfile
+
+Supported hybrid search weighting presets.
+
+## Properties
+
+Name | Type
+------------ | -------------
+
+## Example
+
+```typescript
+import type { HybridSearchProfile } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+} satisfies HybridSearchProfile
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as HybridSearchProfile
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/ScoredChunkResponse.md

@@ -1,7 +1,7 @@
 
 # ScoredChunkResponse
 
-Chunk response with similarity score.
+Chunk response with search ranking score.
 
 ## Properties
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowledge-stack/ksapi",
-  "version": "1.70.3",
+  "version": "1.72.0",
   "description": "OpenAPI client for @knowledge-stack/ksapi",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/ChunksApi.ts

@@ -303,7 +303,7 @@ export interface ChunksApiInterface {
     searchChunksRequestOpts(requestParameters: SearchChunksRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * @summary Search Chunks Handler
      * @param {ChunkSearchRequest} chunkSearchRequest 
      * @param {string} [authorization] 
@@ -315,7 +315,7 @@ export interface ChunksApiInterface {
     searchChunksRaw(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ScoredChunkResponse>>>;
 
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     searchChunks(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ScoredChunkResponse>>;
@@ -743,7 +743,7 @@ export class ChunksApi extends runtime.BaseAPI implements ChunksApiInterface {
     }
 
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     async searchChunksRaw(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ScoredChunkResponse>>> {
@@ -754,7 +754,7 @@ export class ChunksApi extends runtime.BaseAPI implements ChunksApiInterface {
     }
 
     /**
-     * Search over chunks using dense vector similarity or BM25 full-text.  Combines vector/keyword search with path-based authorization and optional metadata filters. Uses Qdrant for search and hydrates results from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
      * Search Chunks Handler
      */
     async searchChunks(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ScoredChunkResponse>> {

package/src/models/ChunkSearchRequest.ts

@@ -13,6 +13,13 @@
  */
 
 import { mapValues } from '../runtime';
+import type { HybridSearchProfile } from './HybridSearchProfile';
+import {
+    HybridSearchProfileFromJSON,
+    HybridSearchProfileFromJSONTyped,
+    HybridSearchProfileToJSON,
+    HybridSearchProfileToJSONTyped,
+} from './HybridSearchProfile';
 import type { ChunkType } from './ChunkType';
 import {
     ChunkTypeFromJSON,
@@ -29,7 +36,7 @@ import {
 } from './SearchType';
 
 /**
- * Request body for chunk search (dense vector or full-text BM25).
+ * Request body for chunk search (dense vector, full-text BM25, or hybrid).
  * @export
  * @interface ChunkSearchRequest
  */
@@ -46,6 +53,24 @@ export interface ChunkSearchRequest {
      * @memberof ChunkSearchRequest
      */
     searchType?: SearchType;
+    /**
+     * 
+     * @type {HybridSearchProfile}
+     * @memberof ChunkSearchRequest
+     */
+    hybridProfile?: HybridSearchProfile;
+    /**
+     * Optional explicit weight for the dense branch. Must be provided together with sparse_weight and overrides hybrid_profile.
+     * @type {number}
+     * @memberof ChunkSearchRequest
+     */
+    denseWeight?: number | null;
+    /**
+     * Optional explicit weight for the sparse branch. Must be provided together with dense_weight and overrides hybrid_profile.
+     * @type {number}
+     * @memberof ChunkSearchRequest
+     */
+    sparseWeight?: number | null;
     /**
      * Path part IDs to search within (non-CHUNK types). Defaults to tenant's /shared.
      * @type {Array<string>}
@@ -148,6 +173,9 @@ export function ChunkSearchRequestFromJSONTyped(json: any, ignoreDiscriminator:
         
         'query': json['query'],
         'searchType': json['search_type'] == null ? undefined : SearchTypeFromJSON(json['search_type']),
+        'hybridProfile': json['hybrid_profile'] == null ? undefined : HybridSearchProfileFromJSON(json['hybrid_profile']),
+        'denseWeight': json['dense_weight'] == null ? undefined : json['dense_weight'],
+        'sparseWeight': json['sparse_weight'] == null ? undefined : json['sparse_weight'],
         'parentPathIds': json['parent_path_ids'] == null ? undefined : json['parent_path_ids'],
         'tagIds': json['tag_ids'] == null ? undefined : json['tag_ids'],
         'chunkTypes': json['chunk_types'] == null ? undefined : ((json['chunk_types'] as Array<any>).map(ChunkTypeFromJSON)),
@@ -172,6 +200,9 @@ export function ChunkSearchRequestToJSONTyped(value?: ChunkSearchRequest | null,
         
         'query': value['query'],
         'search_type': SearchTypeToJSON(value['searchType']),
+        'hybrid_profile': HybridSearchProfileToJSON(value['hybridProfile']),
+        'dense_weight': value['denseWeight'],
+        'sparse_weight': value['sparseWeight'],
         'parent_path_ids': value['parentPathIds'],
         'tag_ids': value['tagIds'],
         'chunk_types': value['chunkTypes'] == null ? undefined : ((value['chunkTypes'] as Array<any>).map(ChunkTypeToJSON)),

package/src/models/HybridSearchProfile.ts

@@ -0,0 +1,54 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+/**
+ * Supported hybrid search weighting presets.
+ * @export
+ */
+export const HybridSearchProfile = {
+    Hybrid: 'hybrid',
+    Dense: 'dense',
+    Sparse: 'sparse'
+} as const;
+export type HybridSearchProfile = typeof HybridSearchProfile[keyof typeof HybridSearchProfile];
+
+
+export function instanceOfHybridSearchProfile(value: any): boolean {
+    for (const key in HybridSearchProfile) {
+        if (Object.prototype.hasOwnProperty.call(HybridSearchProfile, key)) {
+            if (HybridSearchProfile[key as keyof typeof HybridSearchProfile] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+
+export function HybridSearchProfileFromJSON(json: any): HybridSearchProfile {
+    return HybridSearchProfileFromJSONTyped(json, false);
+}
+
+export function HybridSearchProfileFromJSONTyped(json: any, ignoreDiscriminator: boolean): HybridSearchProfile {
+    return json as HybridSearchProfile;
+}
+
+export function HybridSearchProfileToJSON(value?: HybridSearchProfile | null): any {
+    return value as any;
+}
+
+export function HybridSearchProfileToJSONTyped(value: any, ignoreDiscriminator: boolean): HybridSearchProfile {
+    return value as HybridSearchProfile;
+}
+

package/src/models/ScoredChunkResponse.ts

@@ -43,7 +43,7 @@ import {
 } from './ChunkDocumentVersionResponse';
 
 /**
- * Chunk response with similarity score.
+ * Chunk response with search ranking score.
  * @export
  * @interface ScoredChunkResponse
  */
@@ -157,7 +157,7 @@ export interface ScoredChunkResponse {
      */
     documentVersion?: ChunkDocumentVersionResponse;
     /**
-     * Cosine similarity score (1 - cosine_distance)
+     * Search ranking score returned by Qdrant
      * @type {number}
      * @memberof ScoredChunkResponse
      */

package/src/models/SearchType.ts

@@ -19,7 +19,8 @@
  */
 export const SearchType = {
     DenseOnly: 'dense_only',
-    FullText: 'full_text'
+    FullText: 'full_text',
+    Hybrid: 'hybrid'
 } as const;
 export type SearchType = typeof SearchType[keyof typeof SearchType];
 

package/src/models/index.ts

@@ -64,6 +64,7 @@ export * from './GroupPermissionResponse';
 export * from './GroupResponse';
 export * from './HTTPValidationError';
 export * from './HealthCheckResponse';
+export * from './HybridSearchProfile';
 export * from './IdpConfig';
 export * from './IdpType';
 export * from './ImageTaxonomy';