@airweave/sdk 0.9.41 → 0.9.43

package/dist/cjs/api/types/ErrorToolStats.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/FinishToolStats.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Stats from return_results_to_user.
+ */
+export interface FinishToolStats {
+    /** Whether the agent accepted the result set. */
+    accepted?: boolean;
+    total_collected?: number;
+    /** Warning if very few results collected relative to seen. */
+    warning?: string;
+}

package/dist/cjs/api/types/FinishToolStats.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/NavigateToolStats.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AirweaveSDK from "../index.js";
+/**
+ * Stats from get_children, get_siblings, or get_parent.
+ */
+export interface NavigateToolStats {
+    result_count?: number;
+    /** Human-readable label, e.g. 'children of chan-engineering'. */
+    context_label?: string;
+    first_results?: AirweaveSDK.EntitySummary[];
+}

package/dist/cjs/api/types/NavigateToolStats.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/ReadToolStats.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AirweaveSDK from "../index.js";
+/**
+ * Stats from a read tool call.
+ */
+export interface ReadToolStats {
+    /** Entities successfully read. */
+    found?: number;
+    /** Entity IDs that weren't found. */
+    not_found?: number;
+    entities?: AirweaveSDK.EntitySummary[];
+    context_label?: string;
+}

package/dist/cjs/api/types/ReadToolStats.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/ReviewToolStats.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AirweaveSDK from "../index.js";
+/**
+ * Stats from review_results.
+ */
+export interface ReviewToolStats {
+    total_collected?: number;
+    entity_count?: number;
+    first_results?: AirweaveSDK.EntitySummary[];
+}

package/dist/cjs/api/types/ReviewToolStats.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SearchToolStats.d.ts

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AirweaveSDK from "../index.js";
+/**
+ * Stats from a search tool call.
+ */
+export interface SearchToolStats {
+    /** Total results returned. */
+    result_count?: number;
+    /** Results not seen in previous searches. */
+    new_results?: number;
+    first_results?: AirweaveSDK.EntitySummary[];
+}

package/dist/cjs/api/types/SearchToolStats.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/index.d.ts

@@ -26,7 +26,6 @@ export * from "./BrowseTreeResponse.js";
 export * from "./CheckStatus.js";
 export * from "./CheckoutSessionRequest.js";
 export * from "./CheckoutSessionResponse.js";
-export * from "./ClassicSearchRequest.js";
 export * from "./Collection.js";
 export * from "./CollectionStatus.js";
 export * from "./ConfigField.js";
@@ -57,7 +56,6 @@ export * from "./FilterableField.js";
 export * from "./HttpValidationError.js";
 export * from "./HandlerConfig.js";
 export * from "./HealthStatus.js";
-export * from "./InstantSearchRequest.js";
 export * from "./InternalAgenticSearchRequest.js";
 export * from "./InvitationCreate.js";
 export * from "./InvitationResponse.js";
@@ -120,3 +118,18 @@ export * from "./WebhookMessageWithAttempts.js";
 export * from "./WebhookSubscription.js";
 export * from "./WebhookSubscriptionDetail.js";
 export * from "./RetrievalStrategy.js";
+export * from "./AgenticSearchEvent.js";
+export * from "./AgenticSearchStartedEvent.js";
+export * from "./AgenticSearchThinkingEvent.js";
+export * from "./AgenticSearchToolCallEvent.js";
+export * from "./SearchToolStats.js";
+export * from "./ReadToolStats.js";
+export * from "./CollectToolStats.js";
+export * from "./CountToolStats.js";
+export * from "./NavigateToolStats.js";
+export * from "./ReviewToolStats.js";
+export * from "./FinishToolStats.js";
+export * from "./ErrorToolStats.js";
+export * from "./AgenticSearchRerankingEvent.js";
+export * from "./AgenticSearchDoneEvent.js";
+export * from "./AgenticSearchErrorEvent.js";

package/dist/cjs/api/types/index.js

@@ -42,7 +42,6 @@ __exportStar(require("./BrowseTreeResponse.js"), exports);
 __exportStar(require("./CheckStatus.js"), exports);
 __exportStar(require("./CheckoutSessionRequest.js"), exports);
 __exportStar(require("./CheckoutSessionResponse.js"), exports);
-__exportStar(require("./ClassicSearchRequest.js"), exports);
 __exportStar(require("./Collection.js"), exports);
 __exportStar(require("./CollectionStatus.js"), exports);
 __exportStar(require("./ConfigField.js"), exports);
@@ -73,7 +72,6 @@ __exportStar(require("./FilterableField.js"), exports);
 __exportStar(require("./HttpValidationError.js"), exports);
 __exportStar(require("./HandlerConfig.js"), exports);
 __exportStar(require("./HealthStatus.js"), exports);
-__exportStar(require("./InstantSearchRequest.js"), exports);
 __exportStar(require("./InternalAgenticSearchRequest.js"), exports);
 __exportStar(require("./InvitationCreate.js"), exports);
 __exportStar(require("./InvitationResponse.js"), exports);
@@ -136,3 +134,18 @@ __exportStar(require("./WebhookMessageWithAttempts.js"), exports);
 __exportStar(require("./WebhookSubscription.js"), exports);
 __exportStar(require("./WebhookSubscriptionDetail.js"), exports);
 __exportStar(require("./RetrievalStrategy.js"), exports);
+__exportStar(require("./AgenticSearchEvent.js"), exports);
+__exportStar(require("./AgenticSearchStartedEvent.js"), exports);
+__exportStar(require("./AgenticSearchThinkingEvent.js"), exports);
+__exportStar(require("./AgenticSearchToolCallEvent.js"), exports);
+__exportStar(require("./SearchToolStats.js"), exports);
+__exportStar(require("./ReadToolStats.js"), exports);
+__exportStar(require("./CollectToolStats.js"), exports);
+__exportStar(require("./CountToolStats.js"), exports);
+__exportStar(require("./NavigateToolStats.js"), exports);
+__exportStar(require("./ReviewToolStats.js"), exports);
+__exportStar(require("./FinishToolStats.js"), exports);
+__exportStar(require("./ErrorToolStats.js"), exports);
+__exportStar(require("./AgenticSearchRerankingEvent.js"), exports);
+__exportStar(require("./AgenticSearchDoneEvent.js"), exports);
+__exportStar(require("./AgenticSearchErrorEvent.js"), exports);

package/dist/cjs/core/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./fetcher/index.js";
 export * from "./runtime/index.js";
 export * as url from "./url/index.js";
+export * from "./stream/index.js";

package/dist/cjs/core/index.js

@@ -40,3 +40,4 @@ exports.url = void 0;
 __exportStar(require("./fetcher/index.js"), exports);
 __exportStar(require("./runtime/index.js"), exports);
 exports.url = __importStar(require("./url/index.js"));
+__exportStar(require("./stream/index.js"), exports);

package/dist/cjs/core/stream/Stream.d.ts

@@ -0,0 +1,46 @@
+export declare namespace Stream {
+    interface Args {
+        /**
+         * The HTTP response stream to read from.
+         */
+        stream: ReadableStream;
+        /**
+         * The event shape to use for parsing the stream data.
+         */
+        eventShape: JsonEvent | SseEvent;
+        /**
+         * An abort signal to stop the stream.
+         */
+        signal?: AbortSignal;
+    }
+    interface JsonEvent {
+        type: "json";
+        messageTerminator: string;
+    }
+    interface SseEvent {
+        type: "sse";
+        streamTerminator?: string;
+    }
+}
+export declare class Stream<T> implements AsyncIterable<T> {
+    private stream;
+    private parse;
+    /**
+     * The prefix to use for each message. For example,
+     * for SSE, the prefix is "data: ".
+     */
+    private prefix;
+    private messageTerminator;
+    private streamTerminator;
+    private controller;
+    constructor({ stream, parse, eventShape, signal }: Stream.Args & {
+        parse: (val: unknown) => Promise<T>;
+    });
+    private iterMessages;
+    [Symbol.asyncIterator](): AsyncIterator<T, void, unknown>;
+    private decodeChunk;
+}
+/**
+ * Browser polyfill for ReadableStream
+ */
+export declare function readableStreamAsyncIterable<T>(stream: any): AsyncIterableIterator<T>;

package/dist/cjs/core/stream/Stream.js

@@ -0,0 +1,169 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Stream = void 0;
+exports.readableStreamAsyncIterable = readableStreamAsyncIterable;
+const index_js_1 = require("../runtime/index.js");
+const DATA_PREFIX = "data:";
+class Stream {
+    constructor({ stream, parse, eventShape, signal }) {
+        this.controller = new AbortController();
+        this.stream = stream;
+        this.parse = parse;
+        if (eventShape.type === "sse") {
+            this.prefix = DATA_PREFIX;
+            this.messageTerminator = "\n";
+            this.streamTerminator = eventShape.streamTerminator;
+        }
+        else {
+            this.messageTerminator = eventShape.messageTerminator;
+        }
+        signal === null || signal === void 0 ? void 0 : signal.addEventListener("abort", () => this.controller.abort());
+    }
+    iterMessages() {
+        return __asyncGenerator(this, arguments, function* iterMessages_1() {
+            var _a, e_1, _b, _c;
+            this.controller.signal;
+            const stream = readableStreamAsyncIterable(this.stream);
+            let buf = "";
+            let prefixSeen = false;
+            try {
+                for (var _d = true, stream_1 = __asyncValues(stream), stream_1_1; stream_1_1 = yield __await(stream_1.next()), _a = stream_1_1.done, !_a; _d = true) {
+                    _c = stream_1_1.value;
+                    _d = false;
+                    const chunk = _c;
+                    buf += this.decodeChunk(chunk);
+                    let terminatorIndex;
+                    while ((terminatorIndex = buf.indexOf(this.messageTerminator)) >= 0) {
+                        let line = buf.slice(0, terminatorIndex + 1);
+                        buf = buf.slice(terminatorIndex + this.messageTerminator.length);
+                        if (!line.trim()) {
+                            continue;
+                        }
+                        if (!prefixSeen && this.prefix != null) {
+                            const prefixIndex = line.indexOf(this.prefix);
+                            if (prefixIndex === -1) {
+                                continue;
+                            }
+                            prefixSeen = true;
+                            line = line.slice(prefixIndex + this.prefix.length);
+                        }
+                        if (this.streamTerminator != null && line.includes(this.streamTerminator)) {
+                            return yield __await(void 0);
+                        }
+                        const message = yield __await(this.parse(JSON.parse(line)));
+                        yield yield __await(message);
+                        prefixSeen = false;
+                    }
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = stream_1.return)) yield __await(_b.call(stream_1));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        });
+    }
+    [Symbol.asyncIterator]() {
+        return __asyncGenerator(this, arguments, function* _a() {
+            var _b, e_2, _c, _d;
+            try {
+                for (var _e = true, _f = __asyncValues(this.iterMessages()), _g; _g = yield __await(_f.next()), _b = _g.done, !_b; _e = true) {
+                    _d = _g.value;
+                    _e = false;
+                    const message = _d;
+                    yield yield __await(message);
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (!_e && !_b && (_c = _f.return)) yield __await(_c.call(_f));
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+        });
+    }
+    decodeChunk(chunk) {
+        let decoded = "";
+        // If TextDecoder is present, use it
+        if (typeof TextDecoder !== "undefined") {
+            const decoder = new TextDecoder("utf8");
+            decoded += decoder.decode(chunk);
+        }
+        // Buffer is present in Node.js environment
+        else if (index_js_1.RUNTIME.type === "node" && typeof chunk !== "undefined") {
+            decoded += Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        }
+        return decoded;
+    }
+}
+exports.Stream = Stream;
+/**
+ * Browser polyfill for ReadableStream
+ */
+// biome-ignore lint/suspicious/noExplicitAny: allow explicit any
+function readableStreamAsyncIterable(stream) {
+    if (stream[Symbol.asyncIterator]) {
+        return stream;
+    }
+    const reader = stream.getReader();
+    return {
+        next() {
+            return __awaiter(this, void 0, void 0, function* () {
+                try {
+                    const result = yield reader.read();
+                    if (result === null || result === void 0 ? void 0 : result.done) {
+                        reader.releaseLock();
+                    } // release lock when stream becomes closed
+                    return result;
+                }
+                catch (e) {
+                    reader.releaseLock(); // release lock when stream becomes errored
+                    throw e;
+                }
+            });
+        },
+        return() {
+            return __awaiter(this, void 0, void 0, function* () {
+                const cancelPromise = reader.cancel();
+                reader.releaseLock();
+                yield cancelPromise;
+                return { done: true, value: undefined };
+            });
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+    };
+}

package/dist/cjs/core/stream/index.d.ts

@@ -0,0 +1 @@
+export { Stream } from "./Stream.js";

package/dist/cjs/core/stream/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Stream = void 0;
+var Stream_js_1 = require("./Stream.js");
+Object.defineProperty(exports, "Stream", { enumerable: true, get: function () { return Stream_js_1.Stream; } });

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "v0.9.41";
+export declare const SDK_VERSION = "v0.9.43";

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.9.41";
+exports.SDK_VERSION = "v0.9.43";

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.9.41",
-                "User-Agent": "@airweave/sdk/v0.9.41",
+                "X-Fern-SDK-Version": "v0.9.43",
+                "User-Agent": "@airweave/sdk/v0.9.43",
                 "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

@@ -149,5 +149,58 @@ export declare class Collections {
      */
     update(readableId: string, request?: AirweaveSDK.CollectionUpdate, requestOptions?: Collections.RequestOptions): core.HttpResponsePromise<AirweaveSDK.Collection>;
     private __update;
+    /**
+     * Direct vector search.
+     *
+     * @param {string} readableId
+     * @param {AirweaveSDK.InstantSearchRequest} request
+     * @param {Collections.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.collections.instantSearch("readable_id", {
+     *         query: "query"
+     *     })
+     */
+    instantSearch(readableId: string, request: AirweaveSDK.InstantSearchRequest, requestOptions?: Collections.RequestOptions): core.HttpResponsePromise<AirweaveSDK.SearchV2Response>;
+    private __instantSearch;
+    /**
+     * AI-optimized search.
+     *
+     * @param {string} readableId
+     * @param {AirweaveSDK.ClassicSearchRequest} request
+     * @param {Collections.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.collections.classicSearch("readable_id", {
+     *         query: "query"
+     *     })
+     */
+    classicSearch(readableId: string, request: AirweaveSDK.ClassicSearchRequest, requestOptions?: Collections.RequestOptions): core.HttpResponsePromise<AirweaveSDK.SearchV2Response>;
+    private __classicSearch;
+    /**
+     * Agent that iteratively searches, reads, navigates hierarchies, and collects results.
+     *
+     * @param {string} readableId
+     * @param {AirweaveSDK.AgenticSearchRequest} request
+     * @param {Collections.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AirweaveSDK.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.collections.agenticSearch("readable_id", {
+     *         query: "query"
+     *     })
+     */
+    agenticSearch(readableId: string, request: AirweaveSDK.AgenticSearchRequest, requestOptions?: Collections.RequestOptions): core.HttpResponsePromise<AirweaveSDK.SearchV2Response>;
+    private __agenticSearch;
+    /**
+     * Streaming agentic search via Server-Sent Events. Returns real-time events as the agent searches.
+     */
+    streamAgenticSearch(readableId: string, request: AirweaveSDK.AgenticSearchRequest, requestOptions?: Collections.RequestOptions): core.HttpResponsePromise<core.Stream<AirweaveSDK.AgenticSearchEvent>>;
+    private __streamAgenticSearch;
     protected _getCustomAuthorizationHeaders(): Promise<Record<string, string | undefined>>;
 }