mavenagi 1.2.24 → 1.2.26

package/Client.js

@@ -62,8 +62,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.24",
-                "User-Agent": "mavenagi/1.2.24",
+                "X-Fern-SDK-Version": "1.2.26",
+                "User-Agent": "mavenagi/1.2.26",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

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

@@ -2,4 +2,18 @@ import type * as MavenAGI from "../../../index";
 export interface InboxItemCustom extends MavenAGI.InboxItemBase {
     /** Additional metadata associated with the inbox item. */
     metadata: Record<string, string>;
+    /** Title of the inbox item. */
+    title?: string;
+    /** Description of the inbox item. */
+    description?: string;
+    /** An optional URL that can be associated with the inbox item. */
+    externalUrl?: string;
+    /** An optional deadline for the inbox item. */
+    deadline?: Date;
+    /** An optional timestamp until which the inbox item is snoozed. */
+    snoozedUntil?: Date;
+    /** An optional assignee for the inbox item. */
+    assignee?: string;
+    /** An optional list of references to other entities that are related to this inbox item. */
+    references?: MavenAGI.ScopedEntity[];
 }

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

@@ -14,5 +14,8 @@ export declare const UserEventName: {
     /**
      * A text was inserted into a field */
     readonly TextInserted: "TEXT_INSERTED";
+    /**
+     * A CSAT rating was submitted */
+    readonly CsatSubmitted: "CSAT_SUBMITTED";
 };
 export type UserEventName = (typeof UserEventName)[keyof typeof UserEventName];

package/api/resources/commons/types/UserEventName.js

@@ -18,4 +18,7 @@ exports.UserEventName = {
     /**
      * A text was inserted into a field */
     TextInserted: "TEXT_INSERTED",
+    /**
+     * A CSAT rating was submitted */
+    CsatSubmitted: "CSAT_SUBMITTED",
 };

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

@@ -25,6 +25,51 @@ export declare class Inbox {
      */
     search(request: MavenAGI.InboxSearchRequest, requestOptions?: Inbox.RequestOptions): core.HttpResponsePromise<MavenAGI.InboxSearchResponse>;
     private __search;
+    /**
+     * Update an inbox item or create it if it doesn't exist.
+     *
+     * @param {MavenAGI.InboxItemCreateRequest} request
+     * @param {Inbox.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.inbox.createOrUpdate({
+     *         inboxItemId: {
+     *             referenceId: "todo-item-1"
+     *         },
+     *         status: "OPEN",
+     *         severity: "HIGH",
+     *         title: "Todo Item",
+     *         description: "This is the first todo item.",
+     *         metadata: {
+     *             "key": "value"
+     *         },
+     *         externalUrl: "todo.com",
+     *         deadline: new Date("2026-12-31T23:59:59.000Z"),
+     *         snoozedUntil: new Date("2026-12-25T23:59:59.000Z"),
+     *         references: [{
+     *                 entityId: {
+     *                     type: "CONVERSATION_MESSAGE",
+     *                     appId: "app1",
+     *                     referenceId: "msgRef1201",
+     *                     organizationId: "acme",
+     *                     agentId: "support"
+     *                 },
+     *                 scopeEntityId: {
+     *                     type: "CONVERSATION",
+     *                     appId: "app1",
+     *                     referenceId: "ref1200",
+     *                     organizationId: "acme",
+     *                     agentId: "support"
+     *                 }
+     *             }]
+     *     })
+     */
+    createOrUpdate(request: MavenAGI.InboxItemCreateRequest, requestOptions?: Inbox.RequestOptions): core.HttpResponsePromise<MavenAGI.InboxItem>;
+    private __createOrUpdate;
     /**
      * Update inbox item tag fields. All tags provided will overwrite the existing tags on the inbox item.
      *

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

@@ -149,6 +149,131 @@ class Inbox {
             }
         });
     }
+    /**
+     * Update an inbox item or create it if it doesn't exist.
+     *
+     * @param {MavenAGI.InboxItemCreateRequest} request
+     * @param {Inbox.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.inbox.createOrUpdate({
+     *         inboxItemId: {
+     *             referenceId: "todo-item-1"
+     *         },
+     *         status: "OPEN",
+     *         severity: "HIGH",
+     *         title: "Todo Item",
+     *         description: "This is the first todo item.",
+     *         metadata: {
+     *             "key": "value"
+     *         },
+     *         externalUrl: "todo.com",
+     *         deadline: new Date("2026-12-31T23:59:59.000Z"),
+     *         snoozedUntil: new Date("2026-12-25T23:59:59.000Z"),
+     *         references: [{
+     *                 entityId: {
+     *                     type: "CONVERSATION_MESSAGE",
+     *                     appId: "app1",
+     *                     referenceId: "msgRef1201",
+     *                     organizationId: "acme",
+     *                     agentId: "support"
+     *                 },
+     *                 scopeEntityId: {
+     *                     type: "CONVERSATION",
+     *                     appId: "app1",
+     *                     referenceId: "ref1200",
+     *                     organizationId: "acme",
+     *                     agentId: "support"
+     *                 }
+     *             }]
+     *     })
+     */
+    createOrUpdate(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createOrUpdate(request, requestOptions));
+    }
+    __createOrUpdate(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+            const _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/inbox"),
+                method: "PUT",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.InboxItemCreateRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                timeoutMs: ((_l = (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.timeoutInSeconds) !== null && _l !== void 0 ? _l : 60) * 1000,
+                maxRetries: (_m = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _m !== void 0 ? _m : (_o = this._options) === null || _o === void 0 ? void 0 : _o.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.InboxItem.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 PUT /v1/inbox.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Update inbox item tag fields. All tags provided will overwrite the existing tags on the inbox item.
      *

package/api/resources/inbox/types/InboxItemCreateRequest.d.ts

@@ -0,0 +1,59 @@
+import type * as MavenAGI from "../../../index";
+/**
+ * @example
+ *     {
+ *         inboxItemId: {
+ *             referenceId: "todo-item-1"
+ *         },
+ *         status: MavenAGI.InboxItemStatus.Open,
+ *         severity: MavenAGI.InboxItemSeverity.High,
+ *         title: "Todo Item",
+ *         description: "This is the first todo item.",
+ *         metadata: {
+ *             "key": "value"
+ *         },
+ *         externalUrl: "todo.com",
+ *         deadline: new Date("2026-12-31T23:59:59.000Z"),
+ *         snoozedUntil: new Date("2026-12-25T23:59:59.000Z"),
+ *         references: [{
+ *                 entityId: {
+ *                     type: MavenAGI.EntityType.ConversationMessage,
+ *                     appId: "app1",
+ *                     referenceId: "msgRef1201",
+ *                     organizationId: "acme",
+ *                     agentId: "support"
+ *                 },
+ *                 scopeEntityId: {
+ *                     type: MavenAGI.EntityType.Conversation,
+ *                     appId: "app1",
+ *                     referenceId: "ref1200",
+ *                     organizationId: "acme",
+ *                     agentId: "support"
+ *                 }
+ *             }]
+ *     }
+ */
+export interface InboxItemCreateRequest {
+    /** ID that uniquely identifies this inbox item */
+    inboxItemId: MavenAGI.EntityIdBase;
+    /** Status of the inbox item. */
+    status: MavenAGI.InboxItemStatus;
+    /** Severity of the inbox item. */
+    severity: MavenAGI.InboxItemSeverity;
+    /** Additional metadata associated with the inbox item. */
+    metadata: Record<string, string>;
+    /** Title of the inbox item. */
+    title?: string;
+    /** Description of the inbox item. */
+    description?: string;
+    /** An optional URL that can be associated with the inbox item. */
+    externalUrl?: string;
+    /** An optional deadline for the inbox item. */
+    deadline?: Date;
+    /** An optional timestamp until which the inbox item is snoozed. */
+    snoozedUntil?: Date;
+    /** An optional assignee for the inbox item. */
+    assignee?: string;
+    /** An optional list of references to other entities that are related to this inbox item. */
+    references?: MavenAGI.ScopedEntity[];
+}

package/api/resources/inbox/types/InboxItemCreateRequest.js

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

package/api/resources/inbox/types/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./AddDocumentFixRequest";
 export * from "./ApplyFixesRequest";
 export * from "./InboxFilter";
+export * from "./InboxItemCreateRequest";
 export * from "./InboxSearchRequest";
 export * from "./InboxSearchResponse";

package/api/resources/inbox/types/index.js

@@ -17,5 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./AddDocumentFixRequest"), exports);
 __exportStar(require("./ApplyFixesRequest"), exports);
 __exportStar(require("./InboxFilter"), exports);
+__exportStar(require("./InboxItemCreateRequest"), exports);
 __exportStar(require("./InboxSearchRequest"), exports);
 __exportStar(require("./InboxSearchResponse"), exports);

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

@@ -82,6 +82,25 @@ export declare class Knowledge {
      */
     refreshKnowledgeBase(knowledgeBaseReferenceId: string, request: MavenAGI.KnowledgeBaseRefreshRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<void>;
     private __refreshKnowledgeBase;
+    /**
+     * in-progress knowledge base version.
+     *
+     * If the knowledge base has a version that is currently being ingested,
+     * this will cancel the ingestion workflow and set the version status to FAILED.
+     *
+     * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to cancel ingestion for. All other entity ID fields are inferred from the request.
+     * @param {MavenAGI.CancelKnowledgeBaseVersionRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.cancelKnowledgeBaseVersion("knowledgeBaseReferenceId", {})
+     */
+    cancelKnowledgeBaseVersion(knowledgeBaseReferenceId: string, request: MavenAGI.CancelKnowledgeBaseVersionRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<void>;
+    private __cancelKnowledgeBaseVersion;
     /**
      * Update mutable knowledge base fields
      *

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

@@ -440,6 +440,99 @@ class Knowledge {
             }
         });
     }
+    /**
+     * in-progress knowledge base version.
+     *
+     * If the knowledge base has a version that is currently being ingested,
+     * this will cancel the ingestion workflow and set the version status to FAILED.
+     *
+     * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to cancel ingestion for. All other entity ID fields are inferred from the request.
+     * @param {MavenAGI.CancelKnowledgeBaseVersionRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.cancelKnowledgeBaseVersion("knowledgeBaseReferenceId", {})
+     */
+    cancelKnowledgeBaseVersion(knowledgeBaseReferenceId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__cancelKnowledgeBaseVersion(knowledgeBaseReferenceId, request, requestOptions));
+    }
+    __cancelKnowledgeBaseVersion(knowledgeBaseReferenceId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+            const _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/${core.url.encodePathParam(knowledgeBaseReferenceId)}/cancel`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.CancelKnowledgeBaseVersionRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                }),
+                timeoutMs: ((_l = (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.timeoutInSeconds) !== null && _l !== void 0 ? _l : 60) * 1000,
+                maxRetries: (_m = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _m !== void 0 ? _m : (_o = this._options) === null || _o === void 0 ? void 0 : _o.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/knowledge/{knowledgeBaseReferenceId}/cancel.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Update mutable knowledge base fields
      *

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

@@ -0,0 +1,5 @@
+import type * as MavenAGI from "../../../index";
+export interface CancelKnowledgeBaseVersionRequest {
+    /** ID that uniquely identifies which knowledge base version to cancel. If not provided will use the most recent version of the knowledge base. */
+    versionId?: MavenAGI.EntityIdWithoutAgent;
+}

package/api/resources/knowledge/types/CancelKnowledgeBaseVersionRequest.js

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

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

@@ -1,4 +1,5 @@
 export * from "./BaseKnowledgeDocument";
+export * from "./CancelKnowledgeBaseVersionRequest";
 export * from "./FinalizeKnowledgeBaseVersionRequest";
 export * from "./KnowledgeBaseField";
 export * from "./KnowledgeBaseFilter";

package/api/resources/knowledge/types/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./BaseKnowledgeDocument"), exports);
+__exportStar(require("./CancelKnowledgeBaseVersionRequest"), exports);
 __exportStar(require("./FinalizeKnowledgeBaseVersionRequest"), exports);
 __exportStar(require("./KnowledgeBaseField"), exports);
 __exportStar(require("./KnowledgeBaseFilter"), exports);

package/api/resources/triggers/types/EventTriggerBase.d.ts

@@ -1,5 +1,7 @@
 import type * as MavenAGI from "../../../index";
 export interface EventTriggerBase {
+    /** The name of the trigger, displayed to end users. If not set, a name is derived from the app ID and trigger type. */
+    name?: string;
     /** The description of what the event trigger does, shown in the Maven Dashboard */
     description: string;
     /**

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

@@ -15,7 +15,7 @@ export declare class Voice {
      *
      * Supports two token types:
      * - **webrtc**: A Twilio-compatible access token for browser-based WebRTC calls
-     * - **websocket**: An RS256 JWT for direct WebSocket connections to /v1/voice/conversations
+     * - **websocket**: An ES256 JWT for direct WebSocket connections to /v1/voice/conversations
      *
      * Session tokens are required before establishing any voice connection.
      *
@@ -28,7 +28,7 @@ export declare class Voice {
      *
      * @example
      *     await client.voice.sessionToken({
-     *         appUserId: "appUserId",
+     *         appUserId: "x",
      *         type: "webrtc"
      *     })
      */

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

@@ -59,7 +59,7 @@ class Voice {
      *
      * Supports two token types:
      * - **webrtc**: A Twilio-compatible access token for browser-based WebRTC calls
-     * - **websocket**: An RS256 JWT for direct WebSocket connections to /v1/voice/conversations
+     * - **websocket**: An ES256 JWT for direct WebSocket connections to /v1/voice/conversations
      *
      * Session tokens are required before establishing any voice connection.
      *
@@ -72,7 +72,7 @@ class Voice {
      *
      * @example
      *     await client.voice.sessionToken({
-     *         appUserId: "appUserId",
+     *         appUserId: "x",
      *         type: "webrtc"
      *     })
      */

package/api/resources/voice/types/VoiceSessionTokenRequest.d.ts

@@ -1,6 +1,9 @@
 import type * as MavenAGI from "../../../index";
 export interface VoiceSessionTokenRequest {
-    /** The end user identity for the voice session. */
+    /**
+     * The end user identity for the voice session.
+     * Must contain only alphanumeric characters, dots, hyphens, or underscores.
+     */
     appUserId: string;
     /**
      * The type of session token to generate.
@@ -9,6 +12,10 @@ export interface VoiceSessionTokenRequest {
     type: MavenAGI.VoiceTokenType;
     /**
      * Arbitrary key-value metadata to associate with this session (e.g., conversationId, topic).
+     *
+     * **Constraints**: at most 50 keys, each key up to 256 characters, each value up to 4096 characters.
+     * Values are stored as-is — for small data, embed the value directly (e.g., `"callerName": "John Doe"`).
+     *
      * For WebRTC tokens, this data is stored server-side and referenced by a secure ID
      * encoded in the token identity, ensuring it cannot be tampered with by the client.
      * For WebSocket tokens, clients can also pass data directly in the Config message.

package/dist/Client.js

@@ -62,8 +62,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.24",
-                "User-Agent": "mavenagi/1.2.24",
+                "X-Fern-SDK-Version": "1.2.26",
+                "User-Agent": "mavenagi/1.2.26",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/api/resources/commons/types/InboxItemCustom.d.ts

@@ -2,4 +2,18 @@ import type * as MavenAGI from "../../../index";
 export interface InboxItemCustom extends MavenAGI.InboxItemBase {
     /** Additional metadata associated with the inbox item. */
     metadata: Record<string, string>;
+    /** Title of the inbox item. */
+    title?: string;
+    /** Description of the inbox item. */
+    description?: string;
+    /** An optional URL that can be associated with the inbox item. */
+    externalUrl?: string;
+    /** An optional deadline for the inbox item. */
+    deadline?: Date;
+    /** An optional timestamp until which the inbox item is snoozed. */
+    snoozedUntil?: Date;
+    /** An optional assignee for the inbox item. */
+    assignee?: string;
+    /** An optional list of references to other entities that are related to this inbox item. */
+    references?: MavenAGI.ScopedEntity[];
 }

package/dist/api/resources/commons/types/UserEventName.d.ts

@@ -14,5 +14,8 @@ export declare const UserEventName: {
     /**
      * A text was inserted into a field */
     readonly TextInserted: "TEXT_INSERTED";
+    /**
+     * A CSAT rating was submitted */
+    readonly CsatSubmitted: "CSAT_SUBMITTED";
 };
 export type UserEventName = (typeof UserEventName)[keyof typeof UserEventName];

package/dist/api/resources/commons/types/UserEventName.js

@@ -18,4 +18,7 @@ exports.UserEventName = {
     /**
      * A text was inserted into a field */
     TextInserted: "TEXT_INSERTED",
+    /**
+     * A CSAT rating was submitted */
+    CsatSubmitted: "CSAT_SUBMITTED",
 };

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

@@ -25,6 +25,51 @@ export declare class Inbox {
      */
     search(request: MavenAGI.InboxSearchRequest, requestOptions?: Inbox.RequestOptions): core.HttpResponsePromise<MavenAGI.InboxSearchResponse>;
     private __search;
+    /**
+     * Update an inbox item or create it if it doesn't exist.
+     *
+     * @param {MavenAGI.InboxItemCreateRequest} request
+     * @param {Inbox.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.inbox.createOrUpdate({
+     *         inboxItemId: {
+     *             referenceId: "todo-item-1"
+     *         },
+     *         status: "OPEN",
+     *         severity: "HIGH",
+     *         title: "Todo Item",
+     *         description: "This is the first todo item.",
+     *         metadata: {
+     *             "key": "value"
+     *         },
+     *         externalUrl: "todo.com",
+     *         deadline: new Date("2026-12-31T23:59:59.000Z"),
+     *         snoozedUntil: new Date("2026-12-25T23:59:59.000Z"),
+     *         references: [{
+     *                 entityId: {
+     *                     type: "CONVERSATION_MESSAGE",
+     *                     appId: "app1",
+     *                     referenceId: "msgRef1201",
+     *                     organizationId: "acme",
+     *                     agentId: "support"
+     *                 },
+     *                 scopeEntityId: {
+     *                     type: "CONVERSATION",
+     *                     appId: "app1",
+     *                     referenceId: "ref1200",
+     *                     organizationId: "acme",
+     *                     agentId: "support"
+     *                 }
+     *             }]
+     *     })
+     */
+    createOrUpdate(request: MavenAGI.InboxItemCreateRequest, requestOptions?: Inbox.RequestOptions): core.HttpResponsePromise<MavenAGI.InboxItem>;
+    private __createOrUpdate;
     /**
      * Update inbox item tag fields. All tags provided will overwrite the existing tags on the inbox item.
      *