@airweave/sdk 0.4.10 → 0.4.12

package/dist/cjs/Client.js

@@ -48,8 +48,8 @@ class AirweaveSDKClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@airweave/sdk",
-                "X-Fern-SDK-Version": "v0.4.10",
-                "User-Agent": "@airweave/sdk/v0.4.10",
+                "X-Fern-SDK-Version": "v0.4.12",
+                "User-Agent": "@airweave/sdk/v0.4.12",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/resources/collections/client/Client.d.ts

@@ -138,7 +138,20 @@ export declare class Collections {
      * - Metadata filtering using Qdrant's native filter syntax
      * - Pagination with offset and limit
      * - Score threshold filtering
-     * - Query expansion strategies
+     * - Query expansion strategies (default: AUTO, generates up to 4 variations)
+     * - Automatic filter extraction from natural language (default: ON)
+     * - LLM-based result reranking (default: ON)
+     *
+     * Default behavior:
+     * - Query expansion: ON (AUTO strategy)
+     * - Query interpretation: ON (extracts filters from natural language)
+     * - Reranking: ON (improves relevance using LLM)
+     * - Score threshold: None (no filtering)
+     *
+     * To disable features, explicitly set:
+     * - enable_reranking: false
+     * - enable_query_interpretation: false
+     * - expansion_strategy: "no_expansion"
      *
      * @param {string} readableId - The unique readable identifier of the collection to search
      * @param {AirweaveSDK.SearchRequest} request
@@ -154,7 +167,7 @@ export declare class Collections {
      *                 key: "key"
      *             }
      *         },
-     *         limit: 50,
+     *         limit: 10,
      *         score_threshold: 0.7,
      *         response_type: "completion"
      *     })

package/dist/cjs/api/resources/collections/client/Client.js

@@ -398,7 +398,7 @@ class Collections {
     __searchCollection(readableId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
-            const { query, response_type: responseType, limit, offset, score_threshold: scoreThreshold, expansion_strategy: expansionStrategy, } = request;
+            const { query, response_type: responseType, limit, offset, recency_bias: recencyBias } = request;
             const _queryParams = {};
             _queryParams["query"] = query;
             if (responseType != null) {
@@ -410,11 +410,8 @@ class Collections {
             if (offset != null) {
                 _queryParams["offset"] = offset.toString();
             }
-            if (scoreThreshold != null) {
-                _queryParams["score_threshold"] = scoreThreshold.toString();
-            }
-            if (expansionStrategy != null) {
-                _queryParams["expansion_strategy"] = expansionStrategy;
+            if (recencyBias != null) {
+                _queryParams["recency_bias"] = recencyBias.toString();
             }
             const _response = yield core.fetcher({
                 url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}/search`),
@@ -464,7 +461,20 @@ class Collections {
      * - Metadata filtering using Qdrant's native filter syntax
      * - Pagination with offset and limit
      * - Score threshold filtering
-     * - Query expansion strategies
+     * - Query expansion strategies (default: AUTO, generates up to 4 variations)
+     * - Automatic filter extraction from natural language (default: ON)
+     * - LLM-based result reranking (default: ON)
+     *
+     * Default behavior:
+     * - Query expansion: ON (AUTO strategy)
+     * - Query interpretation: ON (extracts filters from natural language)
+     * - Reranking: ON (improves relevance using LLM)
+     * - Score threshold: None (no filtering)
+     *
+     * To disable features, explicitly set:
+     * - enable_reranking: false
+     * - enable_query_interpretation: false
+     * - expansion_strategy: "no_expansion"
      *
      * @param {string} readableId - The unique readable identifier of the collection to search
      * @param {AirweaveSDK.SearchRequest} request
@@ -480,7 +490,7 @@ class Collections {
      *                 key: "key"
      *             }
      *         },
-     *         limit: 50,
+     *         limit: 10,
      *         score_threshold: 0.7,
      *         response_type: "completion"
      *     })

package/dist/cjs/api/resources/collections/client/requests/SearchCollectionCollectionsReadableIdSearchGetRequest.d.ts

@@ -26,11 +26,7 @@ export interface SearchCollectionCollectionsReadableIdSearchGetRequest {
      */
     offset?: number;
     /**
-     * Minimum similarity score threshold
+     * How much to weigh recency vs similarity (0..1). 0 = no recency effect; 1 = rank by recency only.
      */
-    score_threshold?: number;
-    /**
-     * Query expansion strategy (auto, llm, or no_expansion)
-     */
-    expansion_strategy?: AirweaveSDK.QueryExpansionStrategy;
+    recency_bias?: number;
 }

package/dist/cjs/api/resources/collections/client/requests/SearchRequest.d.ts

@@ -11,7 +11,7 @@ import * as AirweaveSDK from "../../../../index.js";
  *                 key: "key"
  *             }
  *         },
- *         limit: 50,
+ *         limit: 10,
  *         score_threshold: 0.7,
  *         response_type: "completion"
  *     }
@@ -21,16 +21,30 @@ export interface SearchRequest {
     query: string;
     /** Qdrant native filter for metadata-based filtering */
     filter?: AirweaveSDK.Filter;
-    /** Number of results to skip */
+    /** Number of results to skip (DEFAULT: 0) */
     offset?: number;
-    /** Maximum number of results to return */
+    /** Maximum number of results to return (DEFAULT: 20) */
     limit?: number;
-    /** Minimum similarity score threshold */
+    /** Minimum similarity score threshold (DEFAULT: None - no filtering) */
     score_threshold?: number;
-    /** Whether to summarize results */
-    summarize?: boolean;
-    /** Type of response (raw or completion) */
+    /** Type of response - 'raw' or 'completion' (DEFAULT: 'raw') */
     response_type?: AirweaveSDK.ResponseType;
-    /** Query expansion strategy. Enhances recall by expanding the query with synonyms, related terms, and other variations, but increases latency. */
+    /** Search method to use (DEFAULT: 'hybrid' - combines neural + BM25) */
+    search_method?: SearchRequest.SearchMethod;
+    /** How much document age penalizes the similarity score (0..1). 0 = no age penalty (pure similarity); 0.5 = old docs lose up to 50% of their score; 1 = old docs get zero score (pure recency). Applied as: score × (1 - bias + bias × age_factor). Works within top ~10,000 semantic matches. DEFAULT: 0.3 */
+    recency_bias?: number;
+    /** Query expansion strategy (DEFAULT: 'auto' - generates up to 4 query variations). Options: 'auto', 'llm', 'no_expansion' */
     expansion_strategy?: AirweaveSDK.QueryExpansionStrategy;
+    /** Enable LLM-based reranking to improve result relevance (DEFAULT: True - enabled, set to False to disable) */
+    enable_reranking?: boolean;
+    /** Enable automatic filter extraction from natural language query (DEFAULT: True - enabled, set to False to disable) */
+    enable_query_interpretation?: boolean;
+}
+export declare namespace SearchRequest {
+    type SearchMethod = "hybrid" | "neural" | "keyword";
+    const SearchMethod: {
+        readonly Hybrid: "hybrid";
+        readonly Neural: "neural";
+        readonly Keyword: "keyword";
+    };
 }

package/dist/cjs/api/resources/collections/client/requests/SearchRequest.js

@@ -3,3 +3,12 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchRequest = void 0;
+var SearchRequest;
+(function (SearchRequest) {
+    SearchRequest.SearchMethod = {
+        Hybrid: "hybrid",
+        Neural: "neural",
+        Keyword: "keyword",
+    };
+})(SearchRequest || (exports.SearchRequest = SearchRequest = {}));

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "v0.4.10";
+export declare const SDK_VERSION = "v0.4.12";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "v0.4.10";
+exports.SDK_VERSION = "v0.4.12";

package/dist/esm/Client.mjs

@@ -12,8 +12,8 @@ export class AirweaveSDKClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@airweave/sdk",
-                "X-Fern-SDK-Version": "v0.4.10",
-                "User-Agent": "@airweave/sdk/v0.4.10",
+                "X-Fern-SDK-Version": "v0.4.12",
+                "User-Agent": "@airweave/sdk/v0.4.12",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/resources/collections/client/Client.d.mts

@@ -138,7 +138,20 @@ export declare class Collections {
      * - Metadata filtering using Qdrant's native filter syntax
      * - Pagination with offset and limit
      * - Score threshold filtering
-     * - Query expansion strategies
+     * - Query expansion strategies (default: AUTO, generates up to 4 variations)
+     * - Automatic filter extraction from natural language (default: ON)
+     * - LLM-based result reranking (default: ON)
+     *
+     * Default behavior:
+     * - Query expansion: ON (AUTO strategy)
+     * - Query interpretation: ON (extracts filters from natural language)
+     * - Reranking: ON (improves relevance using LLM)
+     * - Score threshold: None (no filtering)
+     *
+     * To disable features, explicitly set:
+     * - enable_reranking: false
+     * - enable_query_interpretation: false
+     * - expansion_strategy: "no_expansion"
      *
      * @param {string} readableId - The unique readable identifier of the collection to search
      * @param {AirweaveSDK.SearchRequest} request
@@ -154,7 +167,7 @@ export declare class Collections {
      *                 key: "key"
      *             }
      *         },
-     *         limit: 50,
+     *         limit: 10,
      *         score_threshold: 0.7,
      *         response_type: "completion"
      *     })

package/dist/esm/api/resources/collections/client/Client.mjs

@@ -362,7 +362,7 @@ export class Collections {
     __searchCollection(readableId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
-            const { query, response_type: responseType, limit, offset, score_threshold: scoreThreshold, expansion_strategy: expansionStrategy, } = request;
+            const { query, response_type: responseType, limit, offset, recency_bias: recencyBias } = request;
             const _queryParams = {};
             _queryParams["query"] = query;
             if (responseType != null) {
@@ -374,11 +374,8 @@ export class Collections {
             if (offset != null) {
                 _queryParams["offset"] = offset.toString();
             }
-            if (scoreThreshold != null) {
-                _queryParams["score_threshold"] = scoreThreshold.toString();
-            }
-            if (expansionStrategy != null) {
-                _queryParams["expansion_strategy"] = expansionStrategy;
+            if (recencyBias != null) {
+                _queryParams["recency_bias"] = recencyBias.toString();
             }
             const _response = yield core.fetcher({
                 url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.AirweaveSDKEnvironment.Production, `collections/${encodeURIComponent(readableId)}/search`),
@@ -428,7 +425,20 @@ export class Collections {
      * - Metadata filtering using Qdrant's native filter syntax
      * - Pagination with offset and limit
      * - Score threshold filtering
-     * - Query expansion strategies
+     * - Query expansion strategies (default: AUTO, generates up to 4 variations)
+     * - Automatic filter extraction from natural language (default: ON)
+     * - LLM-based result reranking (default: ON)
+     *
+     * Default behavior:
+     * - Query expansion: ON (AUTO strategy)
+     * - Query interpretation: ON (extracts filters from natural language)
+     * - Reranking: ON (improves relevance using LLM)
+     * - Score threshold: None (no filtering)
+     *
+     * To disable features, explicitly set:
+     * - enable_reranking: false
+     * - enable_query_interpretation: false
+     * - expansion_strategy: "no_expansion"
      *
      * @param {string} readableId - The unique readable identifier of the collection to search
      * @param {AirweaveSDK.SearchRequest} request
@@ -444,7 +454,7 @@ export class Collections {
      *                 key: "key"
      *             }
      *         },
-     *         limit: 50,
+     *         limit: 10,
      *         score_threshold: 0.7,
      *         response_type: "completion"
      *     })

package/dist/esm/api/resources/collections/client/requests/SearchCollectionCollectionsReadableIdSearchGetRequest.d.mts

@@ -26,11 +26,7 @@ export interface SearchCollectionCollectionsReadableIdSearchGetRequest {
      */
     offset?: number;
     /**
-     * Minimum similarity score threshold
+     * How much to weigh recency vs similarity (0..1). 0 = no recency effect; 1 = rank by recency only.
      */
-    score_threshold?: number;
-    /**
-     * Query expansion strategy (auto, llm, or no_expansion)
-     */
-    expansion_strategy?: AirweaveSDK.QueryExpansionStrategy;
+    recency_bias?: number;
 }

package/dist/esm/api/resources/collections/client/requests/SearchRequest.d.mts

@@ -11,7 +11,7 @@ import * as AirweaveSDK from "../../../../index.mjs";
  *                 key: "key"
  *             }
  *         },
- *         limit: 50,
+ *         limit: 10,
  *         score_threshold: 0.7,
  *         response_type: "completion"
  *     }
@@ -21,16 +21,30 @@ export interface SearchRequest {
     query: string;
     /** Qdrant native filter for metadata-based filtering */
     filter?: AirweaveSDK.Filter;
-    /** Number of results to skip */
+    /** Number of results to skip (DEFAULT: 0) */
     offset?: number;
-    /** Maximum number of results to return */
+    /** Maximum number of results to return (DEFAULT: 20) */
     limit?: number;
-    /** Minimum similarity score threshold */
+    /** Minimum similarity score threshold (DEFAULT: None - no filtering) */
     score_threshold?: number;
-    /** Whether to summarize results */
-    summarize?: boolean;
-    /** Type of response (raw or completion) */
+    /** Type of response - 'raw' or 'completion' (DEFAULT: 'raw') */
     response_type?: AirweaveSDK.ResponseType;
-    /** Query expansion strategy. Enhances recall by expanding the query with synonyms, related terms, and other variations, but increases latency. */
+    /** Search method to use (DEFAULT: 'hybrid' - combines neural + BM25) */
+    search_method?: SearchRequest.SearchMethod;
+    /** How much document age penalizes the similarity score (0..1). 0 = no age penalty (pure similarity); 0.5 = old docs lose up to 50% of their score; 1 = old docs get zero score (pure recency). Applied as: score × (1 - bias + bias × age_factor). Works within top ~10,000 semantic matches. DEFAULT: 0.3 */
+    recency_bias?: number;
+    /** Query expansion strategy (DEFAULT: 'auto' - generates up to 4 query variations). Options: 'auto', 'llm', 'no_expansion' */
     expansion_strategy?: AirweaveSDK.QueryExpansionStrategy;
+    /** Enable LLM-based reranking to improve result relevance (DEFAULT: True - enabled, set to False to disable) */
+    enable_reranking?: boolean;
+    /** Enable automatic filter extraction from natural language query (DEFAULT: True - enabled, set to False to disable) */
+    enable_query_interpretation?: boolean;
+}
+export declare namespace SearchRequest {
+    type SearchMethod = "hybrid" | "neural" | "keyword";
+    const SearchMethod: {
+        readonly Hybrid: "hybrid";
+        readonly Neural: "neural";
+        readonly Keyword: "keyword";
+    };
 }

package/dist/esm/api/resources/collections/client/requests/SearchRequest.mjs

@@ -1,4 +1,11 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export {};
+export var SearchRequest;
+(function (SearchRequest) {
+    SearchRequest.SearchMethod = {
+        Hybrid: "hybrid",
+        Neural: "neural",
+        Keyword: "keyword",
+    };
+})(SearchRequest || (SearchRequest = {}));

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "v0.4.10";
+export declare const SDK_VERSION = "v0.4.12";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "v0.4.10";
+export const SDK_VERSION = "v0.4.12";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@airweave/sdk",
-    "version": "v0.4.10",
+    "version": "v0.4.12",
     "private": false,
     "repository": "github:airweave-ai/typescript-sdk",
     "type": "commonjs",

package/reference.md

@@ -559,7 +559,22 @@ This endpoint supports:
 - Metadata filtering using Qdrant's native filter syntax
 - Pagination with offset and limit
 - Score threshold filtering
-- Query expansion strategies
+- Query expansion strategies (default: AUTO, generates up to 4 variations)
+- Automatic filter extraction from natural language (default: ON)
+- LLM-based result reranking (default: ON)
+
+Default behavior:
+
+- Query expansion: ON (AUTO strategy)
+- Query interpretation: ON (extracts filters from natural language)
+- Reranking: ON (improves relevance using LLM)
+- Score threshold: None (no filtering)
+
+To disable features, explicitly set:
+
+- enable_reranking: false
+- enable_query_interpretation: false
+- expansion_strategy: "no_expansion"
   </dd>
   </dl>
   </dd>
@@ -581,7 +596,7 @@ await client.collections.searchCollectionAdvanced("readable_id", {
             key: "key",
         },
     },
-    limit: 50,
+    limit: 10,
     score_threshold: 0.7,
     response_type: "completion",
 });