mavenagi 1.1.0 → 1.2.0

package/dist/api/resources/index.d.ts

@@ -6,6 +6,8 @@ export * as analytics from "./analytics";
 export * from "./analytics/types";
 export * as appSettings from "./appSettings";
 export * from "./appSettings/types";
+export * as assets from "./assets";
+export * from "./assets/types";
 export * as commons from "./commons";
 export * from "./commons/types";
 export * as conversation from "./conversation";
@@ -16,15 +18,21 @@ export * as inbox from "./inbox";
 export * from "./inbox/types";
 export * as knowledge from "./knowledge";
 export * from "./knowledge/types";
+export * as segments from "./segments";
+export * from "./segments/types";
 export * as translations from "./translations";
 export * from "./translations/types";
 export * as triggers from "./triggers";
 export * from "./triggers/types";
+export * as users from "./users";
+export * from "./users/types";
 export * from "./commons/errors";
 export * as organizations from "./organizations";
-export * as users from "./users";
+export * from "./actions/client/requests";
 export * from "./appSettings/client/requests";
 export * from "./conversation/client/requests";
 export * from "./inbox/client/requests";
+export * from "./knowledge/client/requests";
+export * from "./segments/client/requests";
 export * from "./triggers/client/requests";
 export * from "./users/client/requests";

package/dist/api/resources/index.js

@@ -36,7 +36,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.users = exports.organizations = exports.triggers = exports.translations = exports.knowledge = exports.inbox = exports.events = exports.conversation = exports.commons = exports.appSettings = exports.analytics = exports.agents = exports.actions = void 0;
+exports.organizations = exports.users = exports.triggers = exports.translations = exports.segments = exports.knowledge = exports.inbox = exports.events = exports.conversation = exports.commons = exports.assets = exports.appSettings = exports.analytics = exports.agents = exports.actions = void 0;
 exports.actions = __importStar(require("./actions"));
 __exportStar(require("./actions/types"), exports);
 exports.agents = __importStar(require("./agents"));
@@ -45,6 +45,8 @@ exports.analytics = __importStar(require("./analytics"));
 __exportStar(require("./analytics/types"), exports);
 exports.appSettings = __importStar(require("./appSettings"));
 __exportStar(require("./appSettings/types"), exports);
+exports.assets = __importStar(require("./assets"));
+__exportStar(require("./assets/types"), exports);
 exports.commons = __importStar(require("./commons"));
 __exportStar(require("./commons/types"), exports);
 exports.conversation = __importStar(require("./conversation"));
@@ -55,15 +57,21 @@ exports.inbox = __importStar(require("./inbox"));
 __exportStar(require("./inbox/types"), exports);
 exports.knowledge = __importStar(require("./knowledge"));
 __exportStar(require("./knowledge/types"), exports);
+exports.segments = __importStar(require("./segments"));
+__exportStar(require("./segments/types"), exports);
 exports.translations = __importStar(require("./translations"));
 __exportStar(require("./translations/types"), exports);
 exports.triggers = __importStar(require("./triggers"));
 __exportStar(require("./triggers/types"), exports);
+exports.users = __importStar(require("./users"));
+__exportStar(require("./users/types"), exports);
 __exportStar(require("./commons/errors"), exports);
 exports.organizations = __importStar(require("./organizations"));
-exports.users = __importStar(require("./users"));
+__exportStar(require("./actions/client/requests"), exports);
 __exportStar(require("./appSettings/client/requests"), exports);
 __exportStar(require("./conversation/client/requests"), exports);
 __exportStar(require("./inbox/client/requests"), exports);
+__exportStar(require("./knowledge/client/requests"), exports);
+__exportStar(require("./segments/client/requests"), exports);
 __exportStar(require("./triggers/client/requests"), exports);
 __exportStar(require("./users/client/requests"), exports);

package/dist/api/resources/knowledge/client/Client.d.ts

@@ -37,6 +37,21 @@ export declare namespace Knowledge {
 export declare class Knowledge {
     protected readonly _options: Knowledge.Options;
     constructor(_options: Knowledge.Options);
+    /**
+     * Search knowledge bases
+     *
+     * @param {MavenAGI.KnowledgeBaseSearchRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.searchKnowledgeBases({})
+     */
+    searchKnowledgeBases(request: MavenAGI.KnowledgeBaseSearchRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<MavenAGI.KnowledgeBasesResponse>;
+    private __searchKnowledgeBases;
     /**
      * Update a knowledge base or create it if it doesn't exist.
      *
@@ -61,6 +76,7 @@ export declare class Knowledge {
      * Get an existing knowledge base by its supplied ID
      *
      * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to get. All other entity ID fields are inferred from the request.
+     * @param {MavenAGI.KnowledgeBaseGetRequest} request
      * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -70,8 +86,27 @@ export declare class Knowledge {
      * @example
      *     await client.knowledge.getKnowledgeBase("help-center")
      */
-    getKnowledgeBase(knowledgeBaseReferenceId: string, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<MavenAGI.KnowledgeBaseResponse>;
+    getKnowledgeBase(knowledgeBaseReferenceId: string, request?: MavenAGI.KnowledgeBaseGetRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<MavenAGI.KnowledgeBaseResponse>;
     private __getKnowledgeBase;
+    /**
+     * Update mutable knowledge base fields
+     *
+     * The `appId` field can be provided to update a knowledge base owned by a different app.
+     * All other fields will overwrite the existing value on the knowledge base only if provided.
+     *
+     * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to patch.
+     * @param {MavenAGI.KnowledgeBasePatchRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.patchKnowledgeBase("knowledgeBaseReferenceId", {})
+     */
+    patchKnowledgeBase(knowledgeBaseReferenceId: string, request: MavenAGI.KnowledgeBasePatchRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<MavenAGI.KnowledgeBaseResponse>;
+    private __patchKnowledgeBase;
     /**
      * Create a new knowledge base version.
      *
@@ -123,6 +158,21 @@ export declare class Knowledge {
      */
     finalizeKnowledgeBaseVersion(knowledgeBaseReferenceId: string, request: MavenAGI.FinalizeKnowledgeBaseVersionRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<MavenAGI.KnowledgeBaseVersion>;
     private __finalizeKnowledgeBaseVersion;
+    /**
+     * Search knowledge documents
+     *
+     * @param {MavenAGI.KnowledgeDocumentSearchRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.searchKnowledgeDocuments({})
+     */
+    searchKnowledgeDocuments(request: MavenAGI.KnowledgeDocumentSearchRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<MavenAGI.KnowledgeDocumentsResponse>;
+    private __searchKnowledgeDocuments;
     /**
      * Create knowledge document. Requires an existing knowledge base with an in progress version. Will throw an exception if the latest version is not in progress.
      *

package/dist/api/resources/knowledge/client/Client.js

@@ -56,6 +56,99 @@ class Knowledge {
     constructor(_options) {
         this._options = _options;
     }
+    /**
+     * Search knowledge bases
+     *
+     * @param {MavenAGI.KnowledgeBaseSearchRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.searchKnowledgeBases({})
+     */
+    searchKnowledgeBases(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__searchKnowledgeBases(request, requestOptions));
+    }
+    __searchKnowledgeBases(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.MavenAGIEnvironment.Production, "/v1/knowledge/search"),
+                method: "POST",
+                headers: (0, headers_1.mergeHeaders)((_d = this._options) === null || _d === void 0 ? void 0 : _d.headers, (0, headers_1.mergeOnlyDefinedHeaders)({
+                    Authorization: yield this._getAuthorizationHeader(),
+                    "X-Organization-Id": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationId,
+                    "X-Agent-Id": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.agentId,
+                }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.KnowledgeBaseSearchRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.KnowledgeBasesResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new MavenAGI.NotFoundError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 400:
+                        throw new MavenAGI.BadRequestError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 500:
+                        throw new MavenAGI.ServerError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.MavenAGIError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.MavenAGIError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.MavenAGITimeoutError("Timeout exceeded when calling POST /v1/knowledge/search.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Update a knowledge base or create it if it doesn't exist.
      *
@@ -158,6 +251,7 @@ class Knowledge {
      * Get an existing knowledge base by its supplied ID
      *
      * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to get. All other entity ID fields are inferred from the request.
+     * @param {MavenAGI.KnowledgeBaseGetRequest} request
      * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
@@ -167,12 +261,17 @@ class Knowledge {
      * @example
      *     await client.knowledge.getKnowledgeBase("help-center")
      */
-    getKnowledgeBase(knowledgeBaseReferenceId, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__getKnowledgeBase(knowledgeBaseReferenceId, requestOptions));
+    getKnowledgeBase(knowledgeBaseReferenceId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getKnowledgeBase(knowledgeBaseReferenceId, request, requestOptions));
     }
-    __getKnowledgeBase(knowledgeBaseReferenceId, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __getKnowledgeBase(knowledgeBaseReferenceId_1) {
+        return __awaiter(this, arguments, void 0, function* (knowledgeBaseReferenceId, request = {}, requestOptions) {
             var _a, _b, _c, _d;
+            const { appId } = request;
+            const _queryParams = {};
+            if (appId != null) {
+                _queryParams["appId"] = appId;
+            }
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.MavenAGIEnvironment.Production, `/v1/knowledge/${encodeURIComponent(knowledgeBaseReferenceId)}`),
                 method: "GET",
@@ -181,6 +280,7 @@ class Knowledge {
                     "X-Organization-Id": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationId,
                     "X-Agent-Id": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.agentId,
                 }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                queryParameters: _queryParams,
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
                 maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -244,6 +344,103 @@ class Knowledge {
             }
         });
     }
+    /**
+     * Update mutable knowledge base fields
+     *
+     * The `appId` field can be provided to update a knowledge base owned by a different app.
+     * All other fields will overwrite the existing value on the knowledge base only if provided.
+     *
+     * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to patch.
+     * @param {MavenAGI.KnowledgeBasePatchRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.patchKnowledgeBase("knowledgeBaseReferenceId", {})
+     */
+    patchKnowledgeBase(knowledgeBaseReferenceId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__patchKnowledgeBase(knowledgeBaseReferenceId, request, requestOptions));
+    }
+    __patchKnowledgeBase(knowledgeBaseReferenceId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.MavenAGIEnvironment.Production, `/v1/knowledge/${encodeURIComponent(knowledgeBaseReferenceId)}`),
+                method: "PATCH",
+                headers: (0, headers_1.mergeHeaders)((_d = this._options) === null || _d === void 0 ? void 0 : _d.headers, (0, headers_1.mergeOnlyDefinedHeaders)({
+                    Authorization: yield this._getAuthorizationHeader(),
+                    "X-Organization-Id": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationId,
+                    "X-Agent-Id": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.agentId,
+                }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.KnowledgeBasePatchRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.KnowledgeBaseResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new MavenAGI.NotFoundError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 400:
+                        throw new MavenAGI.BadRequestError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 500:
+                        throw new MavenAGI.ServerError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.MavenAGIError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.MavenAGIError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.MavenAGITimeoutError("Timeout exceeded when calling PATCH /v1/knowledge/{knowledgeBaseReferenceId}.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Create a new knowledge base version.
      *
@@ -453,6 +650,99 @@ class Knowledge {
             }
         });
     }
+    /**
+     * Search knowledge documents
+     *
+     * @param {MavenAGI.KnowledgeDocumentSearchRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.searchKnowledgeDocuments({})
+     */
+    searchKnowledgeDocuments(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__searchKnowledgeDocuments(request, requestOptions));
+    }
+    __searchKnowledgeDocuments(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.MavenAGIEnvironment.Production, "/v1/knowledge/documents/search"),
+                method: "POST",
+                headers: (0, headers_1.mergeHeaders)((_d = this._options) === null || _d === void 0 ? void 0 : _d.headers, (0, headers_1.mergeOnlyDefinedHeaders)({
+                    Authorization: yield this._getAuthorizationHeader(),
+                    "X-Organization-Id": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationId,
+                    "X-Agent-Id": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.agentId,
+                }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.KnowledgeDocumentSearchRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.KnowledgeDocumentsResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new MavenAGI.NotFoundError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 400:
+                        throw new MavenAGI.BadRequestError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 500:
+                        throw new MavenAGI.ServerError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.MavenAGIError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.MavenAGIError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.MavenAGITimeoutError("Timeout exceeded when calling POST /v1/knowledge/documents/search.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Create knowledge document. Requires an existing knowledge base with an in progress version. Will throw an exception if the latest version is not in progress.
      *

package/dist/api/resources/knowledge/client/index.d.ts

@@ -1 +1,2 @@
 export {};
+export * from "./requests";

package/dist/api/resources/knowledge/client/index.js

@@ -1,2 +1,17 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests"), exports);

package/dist/api/resources/knowledge/client/requests/KnowledgeBaseGetRequest.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {}
+ */
+export interface KnowledgeBaseGetRequest {
+    /**
+     * The App ID of the knowledge base to get. If not provided the ID of the calling app will be used.
+     */
+    appId?: string;
+}

package/dist/api/resources/knowledge/client/requests/KnowledgeBaseGetRequest.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/api/resources/knowledge/client/requests/index.d.ts

@@ -0,0 +1 @@
+export { type KnowledgeBaseGetRequest } from "./KnowledgeBaseGetRequest";

package/dist/api/resources/knowledge/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/resources/knowledge/types/KnowledgeBaseField.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type KnowledgeBaseField = "Title" | "UpdatedAt";
+export declare const KnowledgeBaseField: {
+    readonly Title: "Title";
+    readonly UpdatedAt: "UpdatedAt";
+};

package/dist/api/resources/knowledge/types/KnowledgeBaseField.js

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

package/dist/api/resources/knowledge/types/KnowledgeBaseFilter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface KnowledgeBaseFilter {
+    /**
+     * Full-text search query for matching knowledge bases by content.
+     * When you search with this parameter, you're performing a full-text search across the knowledge title, tags and metadata.
+     *
+     * This field also supports a syntax for advanced filtering the `metadata` field.
+     *
+     * Metadata examples:
+     * - `metadata:myvalue` - matches knowledge bases with any metadata field set to `myvalue`
+     * - `metadata.mykey:myvalue` - matches knowledge bases with a metadata field `mykey` set to `myvalue`
+     * - `metadata.mykey:myvalue OR anothervalue` - matches knowledge bases with a metadata field `mykey` set to `myvalue` or `anothervalue`
+     * - `metadata.mykey:*` - matches knowledge bases with a metadata field `mykey`
+     * - `-metadata:myvalue` - matches knowledge bases that do not have any metadata field set to `myvalue`
+     * - `_exists_:metadata` - matches knowledge bases that have any metadata field set
+     */
+    search?: string;
+    /** Filter by title */
+    title?: string;
+    /** Filter knowledge bases created on or after this timestamp */
+    createdAfter?: Date;
+    /** Filter knowledge bases created on or before this timestamp */
+    createdBefore?: Date;
+}

package/dist/api/resources/knowledge/types/KnowledgeBaseFilter.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/api/resources/knowledge/types/KnowledgeBasePatchRequest.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface KnowledgeBasePatchRequest {
+    /** The App ID of the knowledge base to patch. If not provided the ID of the calling app will be used. */
+    appId?: string;
+    /** The name of the knowledge base. */
+    name?: string;
+    /** The tags of the knowledge base. */
+    tags?: Set<string>;
+    /** Determines whether documents in the knowledge base are sent to the LLM as part of a conversation. Note that at this time knowledge bases can not be set to `ALWAYS`. */
+    llmInclusionStatus?: MavenAGI.LlmInclusionStatus;
+    /** How often the knowledge base should be refreshed. */
+    refreshFrequency?: MavenAGI.KnowledgeBaseRefreshFrequency;
+}

package/dist/api/resources/knowledge/types/KnowledgeBasePatchRequest.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/api/resources/knowledge/types/KnowledgeBaseProperties.d.ts

@@ -5,6 +5,6 @@ import * as MavenAGI from "../../../index";
 export interface KnowledgeBaseProperties {
     /** The name of the knowledge base */
     name: string;
-    /** (Beta) The preconditions that must be met for knowledge base be relevant to a conversation. Can be used to limit knowledge to certain types of users. */
+    /** The preconditions that must be met for knowledge base be relevant to a conversation. Can be used to restrict knowledge bases to certain types of users. */
     precondition?: MavenAGI.Precondition;
 }

package/dist/api/resources/knowledge/types/KnowledgeBaseRefreshFrequency.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type KnowledgeBaseRefreshFrequency = "NONE" | "DAILY" | "WEEKLY" | "MONTHLY";
+export declare const KnowledgeBaseRefreshFrequency: {
+    readonly None: "NONE";
+    readonly Daily: "DAILY";
+    readonly Weekly: "WEEKLY";
+    readonly Monthly: "MONTHLY";
+};