mavenagi 1.2.4 → 1.2.6

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

@@ -314,6 +314,89 @@ class Analytics {
             }
         });
     }
+    /**
+     * Export the conversation analytics table to a CSV file.
+     *
+     * This outputs the current table view defined by the request. For most programmatic use cases, prefer `getConversationTable` and format client-side. The CSV format may change and should not be relied upon by code consumers. A maximum of 10,000 rows can be exported at a time.
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     */
+    exportConversationTable(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__exportConversationTable(request, requestOptions));
+    }
+    __exportConversationTable(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            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/tables/conversations/export"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.ConversationTableRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                responseType: "binary-response",
+                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: _response.body, 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/tables/conversations/export.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Retrieves structured feedback data formatted as a table, allowing users to group, filter,  and define specific metrics to display as columns.
      *

package/api/resources/analytics/types/ConversationBarChartRequest.d.ts

@@ -3,6 +3,16 @@ export interface ConversationBarChartRequest extends MavenAGI.ConversationAnalyt
     /**
      * Determines how data is grouped along the x-axis. Each unique value forms a separate bar.
      * The name of the bar is derived from the grouping field's value or range.
+     *
+     * **Label Formats by Field:**
+     * - `Sources`: Document title (e.g., "Product Documentation")
+     * - `Actions`: "Action Name - App Name" (e.g., "Create Ticket - Freshdesk")
+     * - `IncompleteActions`: "Action Name - App Name" (e.g., "Search Documents - Zendesk")
+     * - `Users`: User identifier value (e.g., "user@example.com")
+     * - `InboxItems`: Inbox item title
+     * - `HumanAgents`: Human agent display name
+     * - `HumanAgentsWithInserts`: Human agent display name (for agents who made inserts)
+     * - Other fields: Field value as stored (e.g., "GOOD", "NEEDS_IMPROVEMENT" for Quality)
      */
     barDefinition: MavenAGI.ConversationGroupBy;
     /** Metric defining the y-axis values for the bar chart. */
@@ -10,6 +20,16 @@ export interface ConversationBarChartRequest extends MavenAGI.ConversationAnalyt
     /**
      * Optionally defines vertical grouping within each bar, producing multiple series.
      * If omitted, a single series is generated.
+     *
+     * **Series Name Formats by Field:**
+     * - `Sources`: Document title (e.g., "Product Documentation")
+     * - `Actions`: "Action Name - App Name" (e.g., "Create Ticket - Freshdesk")
+     * - `IncompleteActions`: "Action Name - App Name" (e.g., "Search Documents - Zendesk")
+     * - `Users`: User identifier value (e.g., "user@example.com")
+     * - `InboxItems`: Inbox item title
+     * - `HumanAgents`: Human agent display name
+     * - `HumanAgentsWithInserts`: Human agent display name (for agents who made inserts)
+     * - Other fields: Field value as stored (e.g., "GOOD", "NEEDS_IMPROVEMENT" for Quality)
      */
     verticalGrouping?: MavenAGI.ConversationGroupBy;
 }

package/api/resources/analytics/types/ConversationDateHistogramRequest.d.ts

@@ -2,7 +2,19 @@ import * as MavenAGI from "../../../index";
 export interface ConversationDateHistogramRequest extends MavenAGI.ConversationAnalyticsRequest {
     /** Time-based grouping interval (e.g., HOUR, DAY, WEEK) for the date histogram. */
     timeInterval: MavenAGI.TimeInterval;
-    /** Groups data before applying calculations, forming a separate time series for each group. */
+    /**
+     * Groups data before applying calculations, forming a separate time series for each group.
+     *
+     * **Series Name Formats by Field:**
+     * - `Sources`: Document title (e.g., "Product Documentation")
+     * - `Actions`: "Action Name - App Name" (e.g., "Create Ticket - Freshdesk")
+     * - `IncompleteActions`: "Action Name - App Name" (e.g., "Search Documents - Zendesk")
+     * - `Users`: User identifier value (e.g., "user@example.com")
+     * - `InboxItems`: Inbox item title
+     * - `HumanAgents`: Human agent display name
+     * - `HumanAgentsWithInserts`: Human agent display name (for agents who made inserts)
+     * - Other fields: Field value as stored (e.g., "GOOD", "NEEDS_IMPROVEMENT" for Quality)
+     */
     groupBy?: MavenAGI.ConversationGroupBy;
     /** Defines the y-axis values for the date histogram. */
     metric: MavenAGI.ConversationMetric;

package/api/resources/analytics/types/ConversationPieChartRequest.d.ts

@@ -1,6 +1,18 @@
 import * as MavenAGI from "../../../index";
 export interface ConversationPieChartRequest extends MavenAGI.ConversationAnalyticsRequest {
-    /** Field used to group data into slices for the pie chart. */
+    /**
+     * Field used to group data into slices for the pie chart.
+     *
+     * **Series Name Formats by Field:**
+     * - `Sources`: Document title (e.g., "Product Documentation")
+     * - `Actions`: "Action Name - App Name" (e.g., "Create Ticket - Freshdesk")
+     * - `IncompleteActions`: "Action Name - App Name" (e.g., "Search Documents - Zendesk")
+     * - `Users`: User identifier value (e.g., "user@example.com")
+     * - `InboxItems`: Inbox item title
+     * - `HumanAgents`: Human agent display name
+     * - `HumanAgentsWithInserts`: Human agent display name (for agents who made inserts)
+     * - Other fields: Field value as stored (e.g., "GOOD", "NEEDS_IMPROVEMENT" for Quality)
+     */
     groupBy: MavenAGI.ConversationGroupBy;
     /** Metric defining the value for each pie slice, stored in the y-axis value. */
     metric: MavenAGI.ConversationMetric;

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

@@ -26,6 +26,13 @@ import * as MavenAGI from "../../../index";
  *                     key: "userKey2"
  *                 }]
  *         },
+ *         segmentId: {
+ *             referenceId: "premium-users",
+ *             appId: "my-billing-system",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: MavenAGI.EntityType.Segment
+ *         },
  *         language: "en",
  *         deleted: false
  *     }

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

@@ -27,6 +27,16 @@ import * as MavenAGI from "../../../index";
  *         },
  *         defaultUserData: {
  *             "name": "Joe"
+ *         },
+ *         agentUserData: {
+ *             "name": [{
+ *                     value: "Joe",
+ *                     visibility: MavenAGI.VisibilityType.Visible,
+ *                     userId: {
+ *                         appId: "myapp",
+ *                         referenceId: "user0"
+ *                     }
+ *                 }]
  *         }
  *     }
  */
@@ -39,4 +49,6 @@ export interface AppUserResponse extends MavenAGI.AppUser {
     allUserData: Record<string, Record<string, string>>;
     /** Default data for this user */
     defaultUserData: Record<string, string>;
+    /** All user data for this user, including reverse indexable user data */
+    agentUserData: Record<string, MavenAGI.UserDataWithReference[]>;
 }

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

@@ -33,4 +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 text of the last user message in the conversation. */
+    lastUserMessage?: string;
+    /** The text of the last bot message in the conversation. */
+    lastBotMessage?: string;
 }

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

@@ -1,5 +1,11 @@
 import * as MavenAGI from "../../../index";
 export interface SimulationContext {
+    /**
+     * If provided, overrides the agent's default additional prompt text during the simulation.
+     * Note that this field is provided for backwards compatibility and will be removed in a future release.
+     * Instead please use the `availableKnowledgeBases` field to include a knowledge base with a document `llmInclusionStatus` set to `ALWAYS`.
+     */
+    additionalPromptText?: string;
     /** The persona to use during the simulation. If not provided, the agent's default persona will be used. */
     persona?: MavenAGI.LlmPersona;
     /** If provided, knowledge search will be restricted to the provided list of knowledge bases. Otherwise, all active knowledge bases will be used. An empty list means no knowledge bases will be used. */

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

@@ -0,0 +1,5 @@
+import * as MavenAGI from "../../../index";
+export interface UserDataWithReference extends MavenAGI.UserData {
+    /** Reverse index containing appId and referenceId data that identifies this app user */
+    userId: MavenAGI.EntityIdFilter;
+}

package/api/resources/commons/types/UserDataWithReference.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/commons/types/index.d.ts

@@ -46,6 +46,7 @@ export * from "./AppUserIdentifier";
 export * from "./AppUserIdentifyingPropertyType";
 export * from "./AppUser";
 export * from "./UserData";
+export * from "./UserDataWithReference";
 export * from "./VisibilityType";
 export * from "./AppUserRequest";
 export * from "./AppUserResponse";

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

@@ -62,6 +62,7 @@ __exportStar(require("./AppUserIdentifier"), exports);
 __exportStar(require("./AppUserIdentifyingPropertyType"), exports);
 __exportStar(require("./AppUser"), exports);
 __exportStar(require("./UserData"), exports);
+__exportStar(require("./UserDataWithReference"), exports);
 __exportStar(require("./VisibilityType"), exports);
 __exportStar(require("./AppUserRequest"), exports);
 __exportStar(require("./AppUserResponse"), exports);

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

@@ -300,7 +300,11 @@ export declare class Conversation {
     createFeedback(request: MavenAGI.FeedbackRequest, requestOptions?: Conversation.RequestOptions): core.HttpResponsePromise<MavenAGI.Feedback>;
     private __createFeedback;
     /**
-     * Submit a filled out action form
+     * Submit a filled out action form.
+     * Action forms can not be submitted more than once, attempting to do so will result in an error.
+     *
+     * Additionally, form submission is only allowed when the form is the last message in the conversation.
+     * Forms should be disabled in surface UI if a conversation continues and they remain unsubmitted.
      *
      * @param {string} conversationId - The ID of a conversation the form being submitted belongs to
      * @param {MavenAGI.SubmitActionFormRequest} request
@@ -384,6 +388,19 @@ export declare class Conversation {
      */
     search(request: MavenAGI.ConversationsSearchRequest, requestOptions?: Conversation.RequestOptions): core.HttpResponsePromise<MavenAGI.ConversationsResponse>;
     private __search;
+    /**
+     * Export conversations to a CSV file.
+     *
+     * This will output a summary of each conversation that matches the supplied filter. A maximum of 10,000 conversations can be exported at a time.
+     *
+     * For most use cases it is recommended to use the `search` API instead and convert the JSON response to your desired format.
+     * The CSV format may change over time and should not be relied upon by code consumers.
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     */
+    export(request: MavenAGI.ConversationsSearchRequest, requestOptions?: Conversation.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    private __export;
     /**
      * Deliver a message to a user or conversation.
      *

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

@@ -1139,7 +1139,11 @@ class Conversation {
         });
     }
     /**
-     * Submit a filled out action form
+     * Submit a filled out action form.
+     * Action forms can not be submitted more than once, attempting to do so will result in an error.
+     *
+     * Additionally, form submission is only allowed when the form is the last message in the conversation.
+     * Forms should be disabled in surface UI if a conversation continues and they remain unsubmitted.
      *
      * @param {string} conversationId - The ID of a conversation the form being submitted belongs to
      * @param {MavenAGI.SubmitActionFormRequest} request
@@ -1545,6 +1549,92 @@ class Conversation {
             }
         });
     }
+    /**
+     * Export conversations to a CSV file.
+     *
+     * This will output a summary of each conversation that matches the supplied filter. A maximum of 10,000 conversations can be exported at a time.
+     *
+     * For most use cases it is recommended to use the `search` API instead and convert the JSON response to your desired format.
+     * The CSV format may change over time and should not be relied upon by code consumers.
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     */
+    export(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__export(request, requestOptions));
+    }
+    __export(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            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/conversations/export"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.ConversationsSearchRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                responseType: "binary-response",
+                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: _response.body, 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/export.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Deliver a message to a user or conversation.
      *

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

@@ -95,5 +95,15 @@ export declare class Events {
      */
     get(eventId: string, request: MavenAGI.EventGetRequest, requestOptions?: Events.RequestOptions): core.HttpResponsePromise<MavenAGI.EventResponse>;
     private __get;
+    /**
+     * Export events to a CSV file.
+     *
+     * This will output a summary of each event that matches the supplied filter. A maximum of 10,000 events can be exported at a time. For most use cases it is recommended to use the search API instead and convert the JSON response to your desired format. The CSV format may change over time and should not be relied upon by code consumers.
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     */
+    export(request: MavenAGI.EventsSearchRequest, requestOptions?: Events.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    private __export;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -353,6 +353,89 @@ class Events {
             }
         });
     }
+    /**
+     * Export events to a CSV file.
+     *
+     * This will output a summary of each event that matches the supplied filter. A maximum of 10,000 events can be exported at a time. For most use cases it is recommended to use the search API instead and convert the JSON response to your desired format. The CSV format may change over time and should not be relied upon by code consumers.
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     */
+    export(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__export(request, requestOptions));
+    }
+    __export(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            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/events/export"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.EventsSearchRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                responseType: "binary-response",
+                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: _response.body, 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/events/export.");
+                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/index.d.ts

@@ -31,6 +31,7 @@ export * from "./users/types";
 export * from "./commons/errors";
 export * as events from "./events";
 export * from "./actions/client/requests";
+export * from "./agents/client/requests";
 export * from "./appSettings/client/requests";
 export * from "./conversation/client/requests";
 export * from "./events/client/requests";

package/api/resources/index.js

@@ -70,6 +70,7 @@ __exportStar(require("./users/types"), exports);
 __exportStar(require("./commons/errors"), exports);
 exports.events = __importStar(require("./events"));
 __exportStar(require("./actions/client/requests"), exports);
+__exportStar(require("./agents/client/requests"), exports);
 __exportStar(require("./appSettings/client/requests"), exports);
 __exportStar(require("./conversation/client/requests"), exports);
 __exportStar(require("./events/client/requests"), exports);

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

@@ -87,6 +87,27 @@ export declare class Knowledge {
      */
     getKnowledgeBase(knowledgeBaseReferenceId: string, request?: MavenAGI.KnowledgeBaseGetRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<MavenAGI.KnowledgeBaseResponse>;
     private __getKnowledgeBase;
+    /**
+     * Request that a knowledge base refresh itself.
+     *
+     * Knowledge bases refresh on a schedule determined by the `refreshFrequency` field.
+     * They can also be refreshed on demand by calling this endpoint.
+     *
+     * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to refresh. All other entity ID fields are inferred from the request.
+     * @param {MavenAGI.KnowledgeBaseRefreshRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.refreshKnowledgeBase("help-center", {
+     *         appId: "readme"
+     *     })
+     */
+    refreshKnowledgeBase(knowledgeBaseReferenceId: string, request: MavenAGI.KnowledgeBaseRefreshRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<void>;
+    private __refreshKnowledgeBase;
     /**
      * Update mutable knowledge base fields
      *
@@ -102,7 +123,17 @@ export declare class Knowledge {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.knowledge.patchKnowledgeBase("knowledgeBaseReferenceId")
+     *     await client.knowledge.patchKnowledgeBase("help-center", {
+     *         name: "Updated Help Center",
+     *         tags: new Set(["tag1", "tag2", "tag3"]),
+     *         segmentId: {
+     *             referenceId: "premium-users",
+     *             appId: "readme",
+     *             organizationId: "acme",
+     *             agentId: "support",
+     *             type: "SEGMENT"
+     *         }
+     *     })
      */
     patchKnowledgeBase(knowledgeBaseReferenceId: string, request?: MavenAGI.KnowledgeBasePatchRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<MavenAGI.KnowledgeBaseResponse>;
     private __patchKnowledgeBase;