mavenagi 1.2.6 → 1.2.7

package/Client.d.ts

@@ -1,7 +1,6 @@
 import * as environments from "./environments";
 import * as core from "./core";
 import { Actions } from "./api/resources/actions/client/Client";
-import { AgentCapabilities } from "./api/resources/agentCapabilities/client/Client";
 import { Agents } from "./api/resources/agents/client/Client";
 import { Analytics } from "./api/resources/analytics/client/Client";
 import { AppSettings } from "./api/resources/appSettings/client/Client";
@@ -50,7 +49,6 @@ export declare namespace MavenAGIClient {
 export declare class MavenAGIClient {
     protected readonly _options: MavenAGIClient.Options;
     protected _actions: Actions | undefined;
-    protected _agentCapabilities: AgentCapabilities | undefined;
     protected _agents: Agents | undefined;
     protected _analytics: Analytics | undefined;
     protected _appSettings: AppSettings | undefined;
@@ -66,7 +64,6 @@ export declare class MavenAGIClient {
     protected _users: Users | undefined;
     constructor(_options: MavenAGIClient.Options);
     get actions(): Actions;
-    get agentCapabilities(): AgentCapabilities;
     get agents(): Agents;
     get analytics(): Analytics;
     get appSettings(): AppSettings;

package/Client.js

@@ -38,20 +38,19 @@ exports.MavenAGIClient = void 0;
 const core = __importStar(require("./core"));
 const headers_1 = require("./core/headers");
 const Client_1 = require("./api/resources/actions/client/Client");
-const Client_2 = require("./api/resources/agentCapabilities/client/Client");
-const Client_3 = require("./api/resources/agents/client/Client");
-const Client_4 = require("./api/resources/analytics/client/Client");
-const Client_5 = require("./api/resources/appSettings/client/Client");
-const Client_6 = require("./api/resources/assets/client/Client");
-const Client_7 = require("./api/resources/conversation/client/Client");
-const Client_8 = require("./api/resources/events/client/Client");
-const Client_9 = require("./api/resources/inbox/client/Client");
-const Client_10 = require("./api/resources/knowledge/client/Client");
-const Client_11 = require("./api/resources/organizations/client/Client");
-const Client_12 = require("./api/resources/segments/client/Client");
-const Client_13 = require("./api/resources/translations/client/Client");
-const Client_14 = require("./api/resources/triggers/client/Client");
-const Client_15 = require("./api/resources/users/client/Client");
+const Client_2 = require("./api/resources/agents/client/Client");
+const Client_3 = require("./api/resources/analytics/client/Client");
+const Client_4 = require("./api/resources/appSettings/client/Client");
+const Client_5 = require("./api/resources/assets/client/Client");
+const Client_6 = require("./api/resources/conversation/client/Client");
+const Client_7 = require("./api/resources/events/client/Client");
+const Client_8 = require("./api/resources/inbox/client/Client");
+const Client_9 = require("./api/resources/knowledge/client/Client");
+const Client_10 = require("./api/resources/organizations/client/Client");
+const Client_11 = require("./api/resources/segments/client/Client");
+const Client_12 = require("./api/resources/translations/client/Client");
+const Client_13 = require("./api/resources/triggers/client/Client");
+const Client_14 = require("./api/resources/users/client/Client");
 class MavenAGIClient {
     constructor(_options) {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_1.mergeHeaders)({
@@ -59,8 +58,8 @@ class MavenAGIClient {
                 "X-Agent-Id": _options === null || _options === void 0 ? void 0 : _options.agentId,
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "mavenagi",
-                "X-Fern-SDK-Version": "1.2.6",
-                "User-Agent": "mavenagi/1.2.6",
+                "X-Fern-SDK-Version": "1.2.7",
+                "User-Agent": "mavenagi/1.2.7",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });
@@ -69,61 +68,57 @@ class MavenAGIClient {
         var _a;
         return ((_a = this._actions) !== null && _a !== void 0 ? _a : (this._actions = new Client_1.Actions(this._options)));
     }
-    get agentCapabilities() {
-        var _a;
-        return ((_a = this._agentCapabilities) !== null && _a !== void 0 ? _a : (this._agentCapabilities = new Client_2.AgentCapabilities(this._options)));
-    }
     get agents() {
         var _a;
-        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Client_3.Agents(this._options)));
+        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Client_2.Agents(this._options)));
     }
     get analytics() {
         var _a;
-        return ((_a = this._analytics) !== null && _a !== void 0 ? _a : (this._analytics = new Client_4.Analytics(this._options)));
+        return ((_a = this._analytics) !== null && _a !== void 0 ? _a : (this._analytics = new Client_3.Analytics(this._options)));
     }
     get appSettings() {
         var _a;
-        return ((_a = this._appSettings) !== null && _a !== void 0 ? _a : (this._appSettings = new Client_5.AppSettings(this._options)));
+        return ((_a = this._appSettings) !== null && _a !== void 0 ? _a : (this._appSettings = new Client_4.AppSettings(this._options)));
     }
     get assets() {
         var _a;
-        return ((_a = this._assets) !== null && _a !== void 0 ? _a : (this._assets = new Client_6.Assets(this._options)));
+        return ((_a = this._assets) !== null && _a !== void 0 ? _a : (this._assets = new Client_5.Assets(this._options)));
     }
     get conversation() {
         var _a;
-        return ((_a = this._conversation) !== null && _a !== void 0 ? _a : (this._conversation = new Client_7.Conversation(this._options)));
+        return ((_a = this._conversation) !== null && _a !== void 0 ? _a : (this._conversation = new Client_6.Conversation(this._options)));
     }
     get events() {
         var _a;
-        return ((_a = this._events) !== null && _a !== void 0 ? _a : (this._events = new Client_8.Events(this._options)));
+        return ((_a = this._events) !== null && _a !== void 0 ? _a : (this._events = new Client_7.Events(this._options)));
     }
     get inbox() {
         var _a;
-        return ((_a = this._inbox) !== null && _a !== void 0 ? _a : (this._inbox = new Client_9.Inbox(this._options)));
+        return ((_a = this._inbox) !== null && _a !== void 0 ? _a : (this._inbox = new Client_8.Inbox(this._options)));
     }
     get knowledge() {
         var _a;
-        return ((_a = this._knowledge) !== null && _a !== void 0 ? _a : (this._knowledge = new Client_10.Knowledge(this._options)));
+        return ((_a = this._knowledge) !== null && _a !== void 0 ? _a : (this._knowledge = new Client_9.Knowledge(this._options)));
     }
     get organizations() {
         var _a;
-        return ((_a = this._organizations) !== null && _a !== void 0 ? _a : (this._organizations = new Client_11.Organizations(this._options)));
+        return ((_a = this._organizations) !== null && _a !== void 0 ? _a : (this._organizations = new Client_10.Organizations(this._options)));
     }
     get segments() {
         var _a;
-        return ((_a = this._segments) !== null && _a !== void 0 ? _a : (this._segments = new Client_12.Segments(this._options)));
+        return ((_a = this._segments) !== null && _a !== void 0 ? _a : (this._segments = new Client_11.Segments(this._options)));
     }
     get translations() {
         var _a;
-        return ((_a = this._translations) !== null && _a !== void 0 ? _a : (this._translations = new Client_13.Translations(this._options)));
+        return ((_a = this._translations) !== null && _a !== void 0 ? _a : (this._translations = new Client_12.Translations(this._options)));
     }
     get triggers() {
         var _a;
-        return ((_a = this._triggers) !== null && _a !== void 0 ? _a : (this._triggers = new Client_14.Triggers(this._options)));
+        return ((_a = this._triggers) !== null && _a !== void 0 ? _a : (this._triggers = new Client_13.Triggers(this._options)));
     }
     get users() {
         var _a;
-        return ((_a = this._users) !== null && _a !== void 0 ? _a : (this._users = new Client_15.Users(this._options)));
+        return ((_a = this._users) !== null && _a !== void 0 ? _a : (this._users = new Client_14.Users(this._options)));
     }
 }
 exports.MavenAGIClient = MavenAGIClient;

package/api/resources/commons/types/ConversationResponse.d.ts

@@ -27,7 +27,8 @@ import * as MavenAGI from "../../../index";
  *             userMessageCount: 1,
  *             humanAgents: [],
  *             humanAgentsWithInserts: [],
- *             users: []
+ *             users: [],
+ *             userIdentifiers: []
  *         },
  *         metadata: {},
  *         allMetadata: {},

package/api/resources/commons/types/ConversationSummary.d.ts

@@ -33,6 +33,8 @@ export interface ConversationSummary {
     humanAgentsWithInserts: string[];
     /** The names of all users that have a message of type `USER` on the conversation. */
     users: string[];
+    /** The user identifiers (typically email addresses or phone numbers) of all users that have a message of type `USER` on the conversation. */
+    userIdentifiers: string[];
     /** The text of the last user message in the conversation. */
     lastUserMessage?: string;
     /** The text of the last bot message in the conversation. */

package/api/resources/conversation/client/Client.d.ts

@@ -401,6 +401,25 @@ export declare class Conversation {
      */
     export(request: MavenAGI.ConversationsSearchRequest, requestOptions?: Conversation.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
     private __export;
+    /**
+     * Import simulation conversations from a CSV file.
+     *
+     * This CSV format is very simple and only allows for one column: `question`. A header containing this column is required.
+     * Each row will generate one simulation conversation, using the provided response config, if present.
+     *
+     * This API is offered for backwards compatibility.
+     * Most API callers should create simulations programmatically to allow for more flexibility.
+     *
+     * @param {core.file.Uploadable.FileLike} file
+     * @param {MavenAGI.SimulationImportRequest} request
+     * @param {Conversation.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     */
+    importSimulations(file: core.file.Uploadable.FileLike, request: MavenAGI.SimulationImportRequest, requestOptions?: Conversation.RequestOptions): core.HttpResponsePromise<void>;
+    private __importSimulations;
     /**
      * Deliver a message to a user or conversation.
      *

package/api/resources/conversation/client/Client.js

@@ -50,6 +50,7 @@ const MavenAGI = __importStar(require("../../../index"));
 const headers_1 = require("../../../../core/headers");
 const serializers = __importStar(require("../../../../serialization/index"));
 const errors = __importStar(require("../../../../errors/index"));
+const json_1 = require("../../../../core/json");
 class Conversation {
     constructor(_options) {
         this._options = _options;
@@ -1635,6 +1636,99 @@ class Conversation {
             }
         });
     }
+    /**
+     * Import simulation conversations from a CSV file.
+     *
+     * This CSV format is very simple and only allows for one column: `question`. A header containing this column is required.
+     * Each row will generate one simulation conversation, using the provided response config, if present.
+     *
+     * This API is offered for backwards compatibility.
+     * Most API callers should create simulations programmatically to allow for more flexibility.
+     *
+     * @param {core.file.Uploadable.FileLike} file
+     * @param {MavenAGI.SimulationImportRequest} request
+     * @param {Conversation.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     */
+    importSimulations(file, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__importSimulations(file, request, requestOptions));
+    }
+    __importSimulations(file, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const _request = yield core.newFormData();
+            yield _request.appendFile("file", file);
+            if (request.responseConfig != null) {
+                _request.append("responseConfig", (0, json_1.toJson)(serializers.ResponseConfig.jsonOrThrow(request.responseConfig, { unrecognizedObjectKeys: "strip" })));
+            }
+            const _maybeEncodedRequest = yield _request.getRequest();
+            let _headers = (0, headers_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)(Object.assign({ Authorization: yield this._getAuthorizationHeader(), "X-Organization-Id": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationId) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.organizationId, "X-Agent-Id": (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.agentId) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.agentId }, _maybeEncodedRequest.headers)), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_f = this._options.fetcher) !== null && _f !== void 0 ? _f : core.fetcher)({
+                url: core.url.join((_h = (_g = (yield core.Supplier.get(this._options.baseUrl))) !== null && _g !== void 0 ? _g : (yield core.Supplier.get(this._options.environment))) !== null && _h !== void 0 ? _h : environments.MavenAGIEnvironment.Production, "/v1/conversations/import_simulations"),
+                method: "POST",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "file",
+                duplex: _maybeEncodedRequest.duplex,
+                body: _maybeEncodedRequest.body,
+                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: undefined, 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/conversations/import_simulations.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Deliver a message to a user or conversation.
      *

package/api/resources/conversation/client/requests/SimulationImportRequest.d.ts

@@ -0,0 +1,5 @@
+import * as MavenAGI from "../../../../index";
+export interface SimulationImportRequest {
+    /** The response config to use for all of the created simulations. */
+    responseConfig?: MavenAGI.ResponseConfig;
+}

package/api/resources/conversation/client/requests/index.d.ts

@@ -1,2 +1,3 @@
 export { type ConversationGetRequest } from "./ConversationGetRequest";
 export { type ConversationDeleteRequest } from "./ConversationDeleteRequest";
+export { type SimulationImportRequest } from "./SimulationImportRequest";

package/api/resources/index.d.ts

@@ -1,7 +1,5 @@
 export * as actions from "./actions";
 export * from "./actions/types";
-export * as agentCapabilities from "./agentCapabilities";
-export * from "./agentCapabilities/types";
 export * as agents from "./agents";
 export * from "./agents/types";
 export * as analytics from "./analytics";

package/api/resources/index.js

@@ -36,11 +36,9 @@ 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.events = exports.users = exports.triggers = exports.translations = exports.segments = exports.organizations = exports.knowledge = exports.inbox = exports.conversation = exports.commons = exports.assets = exports.appSettings = exports.analytics = exports.agents = exports.agentCapabilities = exports.actions = void 0;
+exports.events = exports.users = exports.triggers = exports.translations = exports.segments = exports.organizations = exports.knowledge = exports.inbox = 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.agentCapabilities = __importStar(require("./agentCapabilities"));
-__exportStar(require("./agentCapabilities/types"), exports);
 exports.agents = __importStar(require("./agents"));
 __exportStar(require("./agents/types"), exports);
 exports.analytics = __importStar(require("./analytics"));

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

@@ -291,5 +291,29 @@ export declare class Knowledge {
      */
     getKnowledgeDocument(knowledgeBaseVersionReferenceId: string, knowledgeDocumentReferenceId: string, request: MavenAGI.KnowledgeDocumentGetRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<MavenAGI.KnowledgeDocumentResponse>;
     private __getKnowledgeDocument;
+    /**
+     * Update mutable knowledge document fields that can be set independently of a knowledge base version.
+     *
+     * For any changes in document content see the `createKnowledgeBaseVersion` and `createKnowledgeDocument` endpoints.
+     *
+     * The `knowledgeBaseAppId` field can be provided to update a knowledge document in a knowledge base owned by a different app.
+     * All other fields will overwrite the existing value on the knowledge document only if provided.
+     *
+     * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to patch.
+     * @param {string} knowledgeDocumentReferenceId - The reference ID of the knowledge document to patch.
+     * @param {MavenAGI.KnowledgeDocumentPatchRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.patchKnowledgeDocument("help-center", "how-it-works", {
+     *         llmInclusionStatus: "ALWAYS"
+     *     })
+     */
+    patchKnowledgeDocument(knowledgeBaseReferenceId: string, knowledgeDocumentReferenceId: string, request?: MavenAGI.KnowledgeDocumentPatchRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<MavenAGI.KnowledgeDocumentResponse>;
+    private __patchKnowledgeDocument;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -1259,6 +1259,110 @@ class Knowledge {
             }
         });
     }
+    /**
+     * Update mutable knowledge document fields that can be set independently of a knowledge base version.
+     *
+     * For any changes in document content see the `createKnowledgeBaseVersion` and `createKnowledgeDocument` endpoints.
+     *
+     * The `knowledgeBaseAppId` field can be provided to update a knowledge document in a knowledge base owned by a different app.
+     * All other fields will overwrite the existing value on the knowledge document only if provided.
+     *
+     * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to patch.
+     * @param {string} knowledgeDocumentReferenceId - The reference ID of the knowledge document to patch.
+     * @param {MavenAGI.KnowledgeDocumentPatchRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.patchKnowledgeDocument("help-center", "how-it-works", {
+     *         llmInclusionStatus: "ALWAYS"
+     *     })
+     */
+    patchKnowledgeDocument(knowledgeBaseReferenceId, knowledgeDocumentReferenceId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__patchKnowledgeDocument(knowledgeBaseReferenceId, knowledgeDocumentReferenceId, request, requestOptions));
+    }
+    __patchKnowledgeDocument(knowledgeBaseReferenceId_1, knowledgeDocumentReferenceId_1) {
+        return __awaiter(this, arguments, void 0, function* (knowledgeBaseReferenceId, knowledgeDocumentReferenceId, request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            let _headers = (0, headers_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({
+                Authorization: yield this._getAuthorizationHeader(),
+                "X-Organization-Id": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationId) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.organizationId,
+                "X-Agent-Id": (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.agentId) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.agentId,
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_f = this._options.fetcher) !== null && _f !== void 0 ? _f : core.fetcher)({
+                url: core.url.join((_h = (_g = (yield core.Supplier.get(this._options.baseUrl))) !== null && _g !== void 0 ? _g : (yield core.Supplier.get(this._options.environment))) !== null && _h !== void 0 ? _h : environments.MavenAGIEnvironment.Production, `/v1/knowledge/${encodeURIComponent(knowledgeBaseReferenceId)}/${encodeURIComponent(knowledgeDocumentReferenceId)}/document`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/merge-patch+json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.KnowledgeDocumentPatchRequest.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.KnowledgeDocumentResponse.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}/{knowledgeDocumentReferenceId}/document.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getAuthorizationHeader() {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b;

package/api/resources/knowledge/client/requests/KnowledgeDocumentPatchRequest.d.ts

@@ -0,0 +1,13 @@
+import * as MavenAGI from "../../../../index";
+/**
+ * @example
+ *     {
+ *         llmInclusionStatus: "ALWAYS"
+ *     }
+ */
+export interface KnowledgeDocumentPatchRequest {
+    /** The App ID of the knowledge base that contains the knowledge document to patch. If not provided the ID of the calling app will be used. */
+    knowledgeBaseAppId?: string;
+    /** Determines whether this document is sent to the LLM as part of a conversation. */
+    llmInclusionStatus?: MavenAGI.LlmInclusionStatus;
+}

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

@@ -2,3 +2,4 @@ export { type KnowledgeBaseGetRequest } from "./KnowledgeBaseGetRequest";
 export { type KnowledgeBasePatchRequest } from "./KnowledgeBasePatchRequest";
 export { type KnowledgeBaseVersionsListRequest } from "./KnowledgeBaseVersionsListRequest";
 export { type KnowledgeDocumentGetRequest } from "./KnowledgeDocumentGetRequest";
+export { type KnowledgeDocumentPatchRequest } from "./KnowledgeDocumentPatchRequest";

package/api/resources/knowledge/types/BaseKnowledgeDocument.d.ts

@@ -3,10 +3,6 @@ export interface BaseKnowledgeDocument {
     url?: string;
     /** The document language. Must be a valid ISO 639-1 language code. */
     language?: string;
-    /** The time at which this document was created. */
-    createdAt?: Date;
-    /** The time at which this document was last modified. */
-    updatedAt?: Date;
     /** The name of the author who created this document. */
     author?: string;
 }

package/api/resources/knowledge/types/KnowledgeBaseResponse.d.ts

@@ -58,7 +58,7 @@ export interface KnowledgeBaseResponse extends MavenAGI.KnowledgeBaseProperties
     /** 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. */
-    llmInclusionStatus?: MavenAGI.LlmInclusionStatus;
+    llmInclusionStatus: MavenAGI.LlmInclusionStatus;
     /** How often the knowledge base should be refreshed. */
     refreshFrequency: MavenAGI.KnowledgeBaseRefreshFrequency;
     /**

package/api/resources/knowledge/types/KnowledgeBaseVersion.d.ts

@@ -10,7 +10,9 @@ import * as MavenAGI from "../../../index";
  *             agentId: "support"
  *         },
  *         type: MavenAGI.KnowledgeBaseVersionType.Full,
- *         status: MavenAGI.KnowledgeBaseVersionStatus.InProgress
+ *         status: MavenAGI.KnowledgeBaseVersionStatus.InProgress,
+ *         createdAt: new Date("2024-01-01T00:00:00.000Z"),
+ *         updatedAt: new Date("2024-02-02T00:00:00.000Z")
  *     }
  */
 export interface KnowledgeBaseVersion extends MavenAGI.KnowledgeBaseVersionRequest {
@@ -20,4 +22,8 @@ export interface KnowledgeBaseVersion extends MavenAGI.KnowledgeBaseVersionReque
     status: MavenAGI.KnowledgeBaseVersionStatus;
     /** A user-facing error message that provides more details about a version failure. */
     errorMessage?: string;
+    /** The date and time the knowledge base version was created. */
+    createdAt: Date;
+    /** The date and time the knowledge base version was last updated. */
+    updatedAt: Date;
 }

package/api/resources/knowledge/types/KnowledgeDocumentFilter.d.ts

@@ -17,6 +17,8 @@ export interface KnowledgeDocumentFilter {
     search?: string;
     /** Filter by title */
     title?: string;
+    /** Filter by url */
+    url?: string;
     /** Filter knowledge documents created on or after this timestamp */
     createdAfter?: Date;
     /** Filter knowledge documents created on or before this timestamp */
@@ -28,4 +30,6 @@ export interface KnowledgeDocumentFilter {
      * If not provided all active knowledge base versions within the agent will be searched.
      */
     knowledgeBaseVersionId?: MavenAGI.EntityIdWithoutAgent;
+    /** Filter by the LLM inclusion status */
+    llmInclusionStatus?: MavenAGI.LlmInclusionStatus[];
 }

package/api/resources/knowledge/types/KnowledgeDocumentRequest.d.ts

@@ -30,4 +30,8 @@ export interface KnowledgeDocumentRequest extends MavenAGI.BaseKnowledgeDocument
     content: string;
     /** Metadata for the knowledge document. */
     metadata?: Record<string, string>;
+    /** The time at which this document was created. */
+    createdAt?: Date;
+    /** The time at which this document was last modified. */
+    updatedAt?: Date;
 }

package/api/resources/knowledge/types/KnowledgeDocumentResponse.d.ts

@@ -20,7 +20,10 @@ import * as MavenAGI from "../../../index";
  *         title: "Getting started",
  *         metadata: {
  *             "category": "getting-started"
- *         }
+ *         },
+ *         createdAt: new Date("2024-01-01T00:00:00.000Z"),
+ *         updatedAt: new Date("2024-02-02T00:00:00.000Z"),
+ *         llmInclusionStatus: MavenAGI.LlmInclusionStatus.WhenRelevant
  *     }
  */
 export interface KnowledgeDocumentResponse extends MavenAGI.KnowledgeDocumentSearchResponse {

package/api/resources/knowledge/types/KnowledgeDocumentSearchResponse.d.ts

@@ -1,4 +1,28 @@
 import * as MavenAGI from "../../../index";
+/**
+ * @example
+ *     {
+ *         knowledgeDocumentId: {
+ *             referenceId: "how-it-works",
+ *             appId: "help-center",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: MavenAGI.EntityType.KnowledgeDocument
+ *         },
+ *         knowledgeBaseVersionId: {
+ *             referenceId: "version-1",
+ *             appId: "help-center",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: MavenAGI.EntityType.KnowledgeBaseVersion
+ *         },
+ *         title: "How it works",
+ *         llmInclusionStatus: MavenAGI.LlmInclusionStatus.WhenRelevant,
+ *         url: "https://help-center.acme.com/how-it-works",
+ *         createdAt: new Date("2024-01-01T00:00:00.000Z"),
+ *         updatedAt: new Date("2024-02-02T00:00:00.000Z")
+ *     }
+ */
 export interface KnowledgeDocumentSearchResponse extends MavenAGI.BaseKnowledgeDocument {
     /** ID that uniquely identifies this knowledge document within its knowledge base */
     knowledgeDocumentId: MavenAGI.EntityId;
@@ -9,4 +33,10 @@ export interface KnowledgeDocumentSearchResponse extends MavenAGI.BaseKnowledgeD
     knowledgeBaseVersionId?: MavenAGI.EntityId;
     /** The title of the document. Will be shown as part of answers. May be missing on legacy documents. */
     title?: string;
+    /** Whether the document is included in the agent's knowledge. */
+    llmInclusionStatus: MavenAGI.LlmInclusionStatus;
+    /** The time at which this document was created. */
+    createdAt: Date;
+    /** The time at which this document was last modified. */
+    updatedAt: Date;
 }

package/core/exports.d.ts

@@ -0,0 +1 @@
+export * from "./file/exports";

package/{api/resources/agentCapabilities/index.js → core/exports.js}

@@ -14,5 +14,4 @@ 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("./types"), exports);
-__exportStar(require("./client"), exports);
+__exportStar(require("./file/exports"), exports);