mavenagi 1.2.20 → 1.2.22

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

@@ -829,114 +829,6 @@ class Conversation {
             }
         });
     }
-    /**
-     * Generate a structured object response based on a provided schema and user prompt with a streaming response.
-     * The response will be sent as a stream of events containing text, start, and end events.
-     * The text portions of stream responses should be concatenated to form the full response text.
-     *
-     * If the user question and object response already exist, they will be reused and not updated.
-     *
-     * Concurrency Behavior:
-     * - If another API call is made for the same user question while a response is mid-stream, partial answers may be returned.
-     * - The second caller will receive a truncated or partial response depending on where the first stream is in its processing. The first caller's stream will remain unaffected and continue delivering the full response.
-     *
-     * Known Limitations:
-     * - Schema enforcement is best-effort and may not guarantee exact conformity.
-     * - The API does not currently expose metadata indicating whether a response or message is incomplete. This will be addressed in a future update.
-     */
-    askObjectStream(conversationId, request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__askObjectStream(conversationId, request, requestOptions));
-    }
-    __askObjectStream(conversationId, 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/conversations/${core.url.encodePathParam(conversationId)}/ask_object_stream`),
-                method: "POST",
-                headers: _headers,
-                contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
-                requestType: "json",
-                body: serializers.AskObjectRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
-                responseType: "sse",
-                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: new core.Stream({
-                        stream: _response.body,
-                        parse: (data) => __awaiter(this, void 0, void 0, function* () {
-                            return serializers.ObjectStreamResponse.parseOrThrow(data, {
-                                unrecognizedObjectKeys: "passthrough",
-                                allowUnrecognizedUnionMembers: true,
-                                allowUnrecognizedEnumValues: true,
-                                breadcrumbsPrefix: ["response"],
-                            });
-                        }),
-                        signal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-                        eventShape: {
-                            type: "sse",
-                            streamTerminator: "[DONE]",
-                        },
-                    }),
-                    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/{conversationId}/ask_object_stream.");
-                case "unknown":
-                    throw new errors.MavenAGIError({
-                        message: _response.error.errorMessage,
-                        rawResponse: _response.rawResponse,
-                    });
-            }
-        });
-    }
     /**
      * Uses an LLM flow to categorize the conversation. Experimental.
      *

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

@@ -1,6 +1,5 @@
 export * from "./ActionFormAttachment";
 export * from "./ActionFormRequestParamValue";
-export * from "./AskObjectRequest";
 export * from "./AskRequest";
 export * from "./AskStreamActionEvent";
 export * from "./AskStreamChartEvent";
@@ -27,7 +26,6 @@ export * from "./FeedbackField";
 export * from "./FeedbackFilter";
 export * from "./FeedbackRequest";
 export * from "./NumericConversationField";
-export * from "./ObjectStreamResponse";
 export * from "./ResolutionStatus";
 export * from "./SimulationFilter";
 export * from "./StreamResponse";

package/dist/api/resources/conversation/types/index.js

@@ -16,7 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ActionFormAttachment"), exports);
 __exportStar(require("./ActionFormRequestParamValue"), exports);
-__exportStar(require("./AskObjectRequest"), exports);
 __exportStar(require("./AskRequest"), exports);
 __exportStar(require("./AskStreamActionEvent"), exports);
 __exportStar(require("./AskStreamChartEvent"), exports);
@@ -43,7 +42,6 @@ __exportStar(require("./FeedbackField"), exports);
 __exportStar(require("./FeedbackFilter"), exports);
 __exportStar(require("./FeedbackRequest"), exports);
 __exportStar(require("./NumericConversationField"), exports);
-__exportStar(require("./ObjectStreamResponse"), exports);
 __exportStar(require("./ResolutionStatus"), exports);
 __exportStar(require("./SimulationFilter"), exports);
 __exportStar(require("./StreamResponse"), exports);

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

@@ -25,6 +25,24 @@ export declare class Inbox {
      */
     search(request: MavenAGI.InboxSearchRequest, requestOptions?: Inbox.RequestOptions): core.HttpResponsePromise<MavenAGI.InboxSearchResponse>;
     private __search;
+    /**
+     * Update inbox item tag fields. All tags provided will overwrite the existing tags on the inbox item.
+     *
+     * @param {string} inboxItemId - The ID of the inbox item to add tags to.
+     * @param {MavenAGI.InboxItemApplyTagsRequest} request
+     * @param {Inbox.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.inbox.applyTags("custom-item-1", {
+     *         tags: new Set(["tag1", "tag2"])
+     *     })
+     */
+    applyTags(inboxItemId: string, request: MavenAGI.InboxItemApplyTagsRequest, requestOptions?: Inbox.RequestOptions): core.HttpResponsePromise<MavenAGI.InboxItem>;
+    private __applyTags;
     /**
      * Retrieve details of a specific inbox item by its ID.
      *

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

@@ -149,6 +149,104 @@ class Inbox {
             }
         });
     }
+    /**
+     * Update inbox item tag fields. All tags provided will overwrite the existing tags on the inbox item.
+     *
+     * @param {string} inboxItemId - The ID of the inbox item to add tags to.
+     * @param {MavenAGI.InboxItemApplyTagsRequest} request
+     * @param {Inbox.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.inbox.applyTags("custom-item-1", {
+     *         tags: new Set(["tag1", "tag2"])
+     *     })
+     */
+    applyTags(inboxItemId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__applyTags(inboxItemId, request, requestOptions));
+    }
+    __applyTags(inboxItemId, 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/${core.url.encodePathParam(inboxItemId)}/tags`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.InboxItemApplyTagsRequest.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 PATCH /v1/inbox/{inboxItemId}/tags.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Retrieve details of a specific inbox item by its ID.
      *

package/dist/api/resources/inbox/client/requests/InboxItemApplyTagsRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @example
+ *     {
+ *         tags: new Set(["tag1", "tag2"])
+ *     }
+ */
+export interface InboxItemApplyTagsRequest {
+    /** The App ID of a custom inbox item to patch tags for. For server-managed inbox items such as Missing Knowledge and Duplicate Documents, the appId field is not required and will be ignored. */
+    appId?: string;
+    /** A set of tags associated with the inbox item that are used for filtering. */
+    tags: Set<string>;
+}

package/dist/api/resources/inbox/client/requests/index.d.ts

@@ -1,3 +1,4 @@
+export type { InboxItemApplyTagsRequest } from "./InboxItemApplyTagsRequest";
 export type { InboxItemFixRequest } from "./InboxItemFixRequest";
 export type { InboxItemIgnoreRequest } from "./InboxItemIgnoreRequest";
 export type { InboxItemRequest } from "./InboxItemRequest";

package/dist/api/resources/inbox/types/InboxFilter.d.ts

@@ -4,6 +4,8 @@ export interface InboxFilter {
     statuses?: MavenAGI.InboxItemStatus[];
     /** List of inbox item types to filter by. */
     type?: MavenAGI.InboxItemType[];
+    /** Filter for items that have at least one of these tags. */
+    tags?: Set<string>;
     /** Filter for items created after this timestamp. */
     createdAfter?: Date;
     /** Filter for items created before this timestamp. */

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

@@ -11,8 +11,6 @@ export * from "./appSettings/client/requests";
 export * from "./appSettings/types";
 export * as assets from "./assets";
 export * from "./assets/types";
-export * as auth from "./auth";
-export * from "./auth/types";
 export * as commons from "./commons";
 export * from "./commons/errors";
 export * from "./commons/types";
@@ -47,5 +45,7 @@ export * from "./triggers/types";
 export * as users from "./users";
 export * from "./users/client/requests";
 export * from "./users/types";
-export * as websockets from "./websockets";
-export * from "./websockets/types";
+export * as voice from "./voice";
+export * from "./voice/types";
+export * as voiceConversations from "./voiceConversations";
+export * from "./voiceConversations/types";

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.websockets = exports.users = exports.triggers = exports.translations = exports.segments = exports.organizations = exports.knowledge = exports.integrations = exports.inbox = exports.events = exports.developersCommons = exports.customers = exports.conversation = exports.commons = exports.auth = exports.assets = exports.appSettings = exports.analytics = exports.agents = exports.actions = void 0;
+exports.voiceConversations = exports.voice = exports.users = exports.triggers = exports.translations = exports.segments = exports.organizations = exports.knowledge = exports.integrations = exports.inbox = exports.events = exports.developersCommons = exports.customers = exports.conversation = exports.commons = exports.assets = exports.appSettings = exports.analytics = exports.agents = exports.actions = void 0;
 exports.actions = __importStar(require("./actions"));
 __exportStar(require("./actions/client/requests"), exports);
 __exportStar(require("./actions/types"), exports);
@@ -50,8 +50,6 @@ __exportStar(require("./appSettings/client/requests"), exports);
 __exportStar(require("./appSettings/types"), exports);
 exports.assets = __importStar(require("./assets"));
 __exportStar(require("./assets/types"), exports);
-exports.auth = __importStar(require("./auth"));
-__exportStar(require("./auth/types"), exports);
 exports.commons = __importStar(require("./commons"));
 __exportStar(require("./commons/errors"), exports);
 __exportStar(require("./commons/types"), exports);
@@ -86,5 +84,7 @@ __exportStar(require("./triggers/types"), exports);
 exports.users = __importStar(require("./users"));
 __exportStar(require("./users/client/requests"), exports);
 __exportStar(require("./users/types"), exports);
-exports.websockets = __importStar(require("./websockets"));
-__exportStar(require("./websockets/types"), exports);
+exports.voice = __importStar(require("./voice"));
+__exportStar(require("./voice/types"), exports);
+exports.voiceConversations = __importStar(require("./voiceConversations"));
+__exportStar(require("./voiceConversations/types"), exports);

package/dist/api/resources/segments/types/SegmentFilter.d.ts

@@ -0,0 +1,21 @@
+import type * as MavenAGI from "../../../index";
+/**
+ * Filter criteria for searching segments.
+ */
+export interface SegmentFilter {
+    /**
+     * Filter segments by name. Case-insensitive substring match.
+     * Empty string returns all results.
+     */
+    name?: string;
+    /**
+     * Filter segments by description. Case-insensitive substring match.
+     * Empty string returns all results.
+     */
+    description?: string;
+    /**
+     * Filter segments by status. Returns segments matching any of the provided statuses.
+     * Empty list returns all non-deleted results.
+     */
+    statuses?: MavenAGI.SegmentStatus[];
+}

package/dist/api/resources/segments/types/SegmentRequest.d.ts

@@ -22,4 +22,6 @@ import type * as MavenAGI from "../../../index";
 export interface SegmentRequest extends MavenAGI.SegmentBase {
     /** ID that uniquely identifies this segment */
     segmentId: MavenAGI.EntityIdBase;
+    /** Desired status for the segment. If omitted, defaults to ACTIVE. In the future this will become required, so specify ACTIVE or INACTIVE if possible. */
+    status?: MavenAGI.SegmentStatus;
 }

package/dist/api/resources/segments/types/SegmentResponse.d.ts

@@ -14,6 +14,7 @@ import type * as MavenAGI from "../../../index";
  *         updatedAt: new Date("2025-01-15T12:30:00.000Z"),
  *         referencedKnowledgeBaseCount: 5,
  *         referencedDocumentCount: 34,
+ *         referencedActionCount: 3,
  *         status: MavenAGI.SegmentStatus.Active,
  *         precondition: {
  *             preconditionType: "group",
@@ -39,6 +40,8 @@ export interface SegmentResponse extends MavenAGI.SegmentBase {
     referencedKnowledgeBaseCount?: number;
     /** The number of active documents that reference this segment. */
     referencedDocumentCount?: number;
+    /** The number of active actions that reference this segment. */
+    referencedActionCount?: number;
     /**
      * The status of the segment.
      *

package/dist/api/resources/segments/types/SegmentsSearchRequest.d.ts

@@ -2,4 +2,6 @@ import type * as MavenAGI from "../../../index";
 export interface SegmentsSearchRequest extends MavenAGI.BasePaginatedRequest {
     /** The field to sort by, defaults to created timestamp */
     sort?: MavenAGI.SegmentField;
+    /** The filter to apply to the segments. */
+    filter?: MavenAGI.SegmentFilter;
 }

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

@@ -1,5 +1,6 @@
 export * from "./SegmentBase";
 export * from "./SegmentField";
+export * from "./SegmentFilter";
 export * from "./SegmentPatchRequest";
 export * from "./SegmentRequest";
 export * from "./SegmentResponse";

package/dist/api/resources/segments/types/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./SegmentBase"), exports);
 __exportStar(require("./SegmentField"), exports);
+__exportStar(require("./SegmentFilter"), exports);
 __exportStar(require("./SegmentPatchRequest"), exports);
 __exportStar(require("./SegmentRequest"), exports);
 __exportStar(require("./SegmentResponse"), exports);

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

@@ -0,0 +1,38 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient";
+import * as core from "../../../../core";
+import * as MavenAGI from "../../../index";
+export declare namespace Voice {
+    interface Options extends BaseClientOptions {
+    }
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class Voice {
+    protected readonly _options: Voice.Options;
+    constructor(_options: Voice.Options);
+    /**
+     * Creates a short-lived session token for authenticating voice connections.
+     *
+     * 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
+     *
+     * Session tokens are required before establishing any voice connection.
+     *
+     * @param {MavenAGI.VoiceSessionTokenRequest} request
+     * @param {Voice.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.voice.sessionToken({
+     *         appUserId: "appUserId",
+     *         type: "webrtc"
+     *     })
+     */
+    sessionToken(request: MavenAGI.VoiceSessionTokenRequest, requestOptions?: Voice.RequestOptions): core.HttpResponsePromise<MavenAGI.VoiceSessionTokenResponse>;
+    private __sessionToken;
+    protected _getAuthorizationHeader(): Promise<string | undefined>;
+}

package/dist/api/resources/{auth → voice}/client/Client.js

@@ -43,32 +43,37 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Auth = void 0;
+exports.Voice = void 0;
 const core = __importStar(require("../../../../core"));
 const headers_1 = require("../../../../core/headers");
 const environments = __importStar(require("../../../../environments"));
 const errors = __importStar(require("../../../../errors/index"));
 const serializers = __importStar(require("../../../../serialization/index"));
 const MavenAGI = __importStar(require("../../../index"));
-class Auth {
+class Voice {
     constructor(_options) {
         this._options = _options;
     }
     /**
-     * Creates a short-lived session token that can be used to authenticate
-     * WebSocket connections. Session tokens are useful for client-side applications where
-     * you don’t want to expose your API key.
+     * Creates a short-lived session token for authenticating voice connections.
      *
-     * @param {MavenAGI.SessionTokenRequest} request
-     * @param {Auth.RequestOptions} requestOptions - Request-specific configuration.
+     * 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
+     *
+     * Session tokens are required before establishing any voice connection.
+     *
+     * @param {MavenAGI.VoiceSessionTokenRequest} request
+     * @param {Voice.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link MavenAGI.NotFoundError}
      * @throws {@link MavenAGI.BadRequestError}
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.auth.sessionToken({
-     *         ttlSeconds: 3600
+     *     await client.voice.sessionToken({
+     *         appUserId: "appUserId",
+     *         type: "webrtc"
      *     })
      */
     sessionToken(request, requestOptions) {
@@ -83,20 +88,20 @@ class Auth {
                 "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/auth/session-token"),
+                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/voice/session-token"),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
-                body: serializers.SessionTokenRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                body: serializers.VoiceSessionTokenRequest.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.SessionTokenResponse.parseOrThrow(_response.body, {
+                    data: serializers.VoiceSessionTokenResponse.parseOrThrow(_response.body, {
                         unrecognizedObjectKeys: "passthrough",
                         allowUnrecognizedUnionMembers: true,
                         allowUnrecognizedEnumValues: true,
@@ -144,7 +149,7 @@ class Auth {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.MavenAGITimeoutError("Timeout exceeded when calling POST /v1/auth/session-token.");
+                    throw new errors.MavenAGITimeoutError("Timeout exceeded when calling POST /v1/voice/session-token.");
                 case "unknown":
                     throw new errors.MavenAGIError({
                         message: _response.error.errorMessage,
@@ -168,4 +173,4 @@ class Auth {
         });
     }
 }
-exports.Auth = Auth;
+exports.Voice = Voice;

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

@@ -0,0 +1,17 @@
+import type * as MavenAGI from "../../../index";
+export interface VoiceSessionTokenRequest {
+    /** The end user identity for the voice session. */
+    appUserId: string;
+    /**
+     * The type of session token to generate.
+     * Use "webrtc" for browser-based calls via Twilio, or "websocket" for direct WebSocket connections.
+     */
+    type: MavenAGI.VoiceTokenType;
+    /**
+     * Arbitrary key-value metadata to associate with this session (e.g., conversationId, topic).
+     * 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.
+     */
+    customData?: Record<string, string>;
+}

package/dist/api/resources/voice/types/VoiceSessionTokenResponse.d.ts

@@ -0,0 +1,11 @@
+import type * as MavenAGI from "../../../index";
+export interface VoiceSessionTokenResponse {
+    /** Opaque JWT session token. Pass this in the Authorization header when connecting. */
+    token: string;
+    /** The identity string associated with this token (echoes appUserId). */
+    identity: string;
+    /** The type of token that was generated. */
+    type: MavenAGI.VoiceTokenType;
+    /** Time in seconds until the token expires. */
+    expiresIn: number;
+}

package/dist/api/resources/voice/types/VoiceTokenType.d.ts

@@ -0,0 +1,5 @@
+export declare const VoiceTokenType: {
+    readonly Webrtc: "webrtc";
+    readonly Websocket: "websocket";
+};
+export type VoiceTokenType = (typeof VoiceTokenType)[keyof typeof VoiceTokenType];

package/dist/api/resources/voice/types/VoiceTokenType.js

@@ -0,0 +1,8 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoiceTokenType = void 0;
+exports.VoiceTokenType = {
+    Webrtc: "webrtc",
+    Websocket: "websocket",
+};

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

@@ -0,0 +1,3 @@
+export * from "./VoiceSessionTokenRequest";
+export * from "./VoiceSessionTokenResponse";
+export * from "./VoiceTokenType";

package/dist/api/resources/voice/types/index.js

@@ -0,0 +1,19 @@
+"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("./VoiceSessionTokenRequest"), exports);
+__exportStar(require("./VoiceSessionTokenResponse"), exports);
+__exportStar(require("./VoiceTokenType"), exports);