mavenagi 1.2.4 → 1.2.5

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

@@ -24,6 +24,8 @@ export interface KnowledgeDocumentRequest extends MavenAGI.BaseKnowledgeDocument
     /** ID that uniquely identifies which knowledge base version to create the document in. If not provided will use the most recent version of the knowledge base. */
     versionId?: MavenAGI.EntityIdWithoutAgent;
     contentType: MavenAGI.KnowledgeDocumentContentType;
+    /** The title of the document. Will be shown as part of answers. */
+    title: string;
     /** The content of the document. Not shown directly to users. May be provided in HTML or markdown. HTML will be converted to markdown automatically. Images are not currently supported and will be ignored. */
     content: string;
     /** Metadata for the knowledge document. */

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

@@ -7,4 +7,6 @@ export interface KnowledgeDocumentSearchResponse extends MavenAGI.BaseKnowledgeD
      * This may be missing on legacy documents.
      */
     knowledgeBaseVersionId?: MavenAGI.EntityId;
+    /** The title of the document. Will be shown as part of answers. May be missing on legacy documents. */
+    title?: string;
 }

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

@@ -24,3 +24,4 @@ export * from "./KnowledgeDocumentSearchRequest";
 export * from "./KnowledgeDocumentSearchResponse";
 export * from "./KnowledgeDocumentsResponse";
 export * from "./KnowledgeBaseVersionsListResponse";
+export * from "./KnowledgeBaseRefreshRequest";

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

@@ -40,3 +40,4 @@ __exportStar(require("./KnowledgeDocumentSearchRequest"), exports);
 __exportStar(require("./KnowledgeDocumentSearchResponse"), exports);
 __exportStar(require("./KnowledgeDocumentsResponse"), exports);
 __exportStar(require("./KnowledgeBaseVersionsListResponse"), exports);
+__exportStar(require("./KnowledgeBaseRefreshRequest"), exports);

package/dist/Client.js

@@ -59,8 +59,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.4",
-                "User-Agent": "mavenagi/1.2.4",
+                "X-Fern-SDK-Version": "1.2.5",
+                "User-Agent": "mavenagi/1.2.5",
                 "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/actions/client/Client.d.ts

@@ -115,7 +115,17 @@ export declare class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.patch("actionReferenceId")
+     *     await client.actions.patch("get-balance", {
+     *         instructions: "Use this action when the user asks about their account balance or remaining credits.",
+     *         llmInclusionStatus: "WHEN_RELEVANT",
+     *         segmentId: {
+     *             referenceId: "premium-users",
+     *             appId: "my-billing-system",
+     *             organizationId: "acme",
+     *             agentId: "support",
+     *             type: "SEGMENT"
+     *         }
+     *     })
      */
     patch(actionReferenceId: string, request?: MavenAGI.ActionPatchRequest, requestOptions?: Actions.RequestOptions): core.HttpResponsePromise<MavenAGI.ActionResponse>;
     private __patch;

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

@@ -375,7 +375,17 @@ class Actions {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.actions.patch("actionReferenceId")
+     *     await client.actions.patch("get-balance", {
+     *         instructions: "Use this action when the user asks about their account balance or remaining credits.",
+     *         llmInclusionStatus: "WHEN_RELEVANT",
+     *         segmentId: {
+     *             referenceId: "premium-users",
+     *             appId: "my-billing-system",
+     *             organizationId: "acme",
+     *             agentId: "support",
+     *             type: "SEGMENT"
+     *         }
+     *     })
      */
     patch(actionReferenceId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__patch(actionReferenceId, request, requestOptions));

package/dist/api/resources/actions/client/requests/ActionPatchRequest.d.ts

@@ -1,7 +1,17 @@
 import * as MavenAGI from "../../../../index";
 /**
  * @example
- *     {}
+ *     {
+ *         instructions: "Use this action when the user asks about their account balance or remaining credits.",
+ *         llmInclusionStatus: "WHEN_RELEVANT",
+ *         segmentId: {
+ *             referenceId: "premium-users",
+ *             appId: "my-billing-system",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: "SEGMENT"
+ *         }
+ *     }
  */
 export interface ActionPatchRequest {
     /** The App ID of the action to patch. If not provided the ID of the calling app will be used. */

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

@@ -128,9 +128,9 @@ export declare class Agents {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.agents.patch("organizationReferenceId", "agentReferenceId", {})
+     *     await client.agents.patch("organizationReferenceId", "agentReferenceId")
      */
-    patch(organizationReferenceId: string, agentReferenceId: string, request: MavenAGI.AgentPatchRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<MavenAGI.Agent>;
+    patch(organizationReferenceId: string, agentReferenceId: string, request?: MavenAGI.AgentPatchRequest, requestOptions?: Agents.RequestOptions): core.HttpResponsePromise<MavenAGI.Agent>;
     private __patch;
     /**
      * Delete an agent.

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

@@ -460,13 +460,13 @@ class Agents {
      * @throws {@link MavenAGI.ServerError}
      *
      * @example
-     *     await client.agents.patch("organizationReferenceId", "agentReferenceId", {})
+     *     await client.agents.patch("organizationReferenceId", "agentReferenceId")
      */
-    patch(organizationReferenceId, agentReferenceId, request, requestOptions) {
+    patch(organizationReferenceId, agentReferenceId, request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__patch(organizationReferenceId, agentReferenceId, request, requestOptions));
     }
-    __patch(organizationReferenceId, agentReferenceId, request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __patch(organizationReferenceId_1, agentReferenceId_1) {
+        return __awaiter(this, arguments, void 0, function* (organizationReferenceId, agentReferenceId, request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h;
             let _headers = (0, headers_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({
                 Authorization: yield this._getAuthorizationHeader(),
@@ -477,7 +477,7 @@ class Agents {
                 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/organizations/${encodeURIComponent(organizationReferenceId)}/agents/${encodeURIComponent(agentReferenceId)}`),
                 method: "PATCH",
                 headers: _headers,
-                contentType: "application/json",
+                contentType: "application/merge-patch+json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
                 body: serializers.AgentPatchRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),

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

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

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

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

package/dist/api/resources/agents/client/requests/AgentPatchRequest.d.ts

@@ -0,0 +1,27 @@
+import * as MavenAGI from "../../../../index";
+/**
+ * @example
+ *     {}
+ */
+export interface AgentPatchRequest {
+    /** The name of the agent. */
+    name?: string;
+    /** The environment of the agent. */
+    environment?: MavenAGI.AgentEnvironment;
+    /** The agent's default timezone. This is used when a timezone is not set on a conversation. */
+    defaultTimezone?: string;
+    /** The PII categories that are enabled for the agent. */
+    enabledPiiCategories?: Set<MavenAGI.PiiCategory>;
+    /** The system fallback message. */
+    systemFallbackMessage?: string | null;
+    /** The overall persona of the agent. */
+    persona?: MavenAGI.LlmPersona;
+    /** Additional text directly appended to the prompt. */
+    additionalPromptText?: string | null;
+    /** LLM prompt for category generation. */
+    categoryGenerationPromptText?: string | null;
+    /** LLM prompt for generating a response when the user's question has been detected as unsafe. */
+    contentSafetyViolationResponsePromptText?: string | null;
+    /** Return the system fallback message on all questions that have no relevant knowledge bases or actions. */
+    rejectQuestionsWithoutKnowledge?: boolean;
+}

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

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

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

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

package/dist/api/resources/agents/types/Agent.d.ts

@@ -20,4 +20,12 @@ export interface Agent {
      * `UsUkPassportNumber`, `UsSocialSecurityNumber`.
      */
     enabledPiiCategories: Set<MavenAGI.PiiCategory>;
+    /**
+     * Text shown to end users when the system encounters an error while generating a bot response message.
+     *
+     * This text is also used when a content safety violation is detected, unless `contentSafetyViolationPromptText` is set.
+     */
+    systemFallbackMessage?: string;
+    /** Agent prompting settings. */
+    prompting: MavenAGI.AgentPrompting;
 }

package/dist/api/resources/agents/types/AgentPrompting.d.ts

@@ -0,0 +1,23 @@
+import * as MavenAGI from "../../../index";
+export interface AgentPrompting {
+    /** The overall persona of the agent. */
+    persona: MavenAGI.LlmPersona;
+    /** Additional text directly appended to the prompt. This field is replaced by Knowledge Documents with `llmInclusionsStatus` set to `ALWAYS`. */
+    additionalPromptText?: string;
+    /**
+     * LLM prompt for category generation.
+     *
+     * Use this to specify a fixed set of categories that an LLM should choose from when analyzing a conversation.
+     * When not set uses a default prompt which gives the LLM flexibility to determine appropriate categories on its own.
+     */
+    categoryGenerationPromptText?: string;
+    /**
+     * LLM prompt for generating a response when the user's question has been detected as unsafe.
+     *
+     * Use this to provide custom LLM generated replies when dealing with content safety violations.
+     * When not set, the system fallback message will be used and replies will not be personalized by the LLM as it will not be involved.
+     */
+    contentSafetyViolationResponsePromptText?: string;
+    /** Return the system fallback message on all questions that have no relevant knowledge bases or actions. */
+    rejectQuestionsWithoutKnowledge: boolean;
+}

package/dist/api/resources/agents/types/AgentPrompting.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/dist/api/resources/agents/types/index.d.ts

@@ -2,8 +2,8 @@ export * from "./PiiCategory";
 export * from "./AgentEnvironment";
 export * from "./Agent";
 export * from "./CreateAgentRequest";
-export * from "./AgentPatchRequest";
 export * from "./AgentsSearchRequest";
 export * from "./AgentField";
 export * from "./AgentFilter";
 export * from "./AgentsSearchResponse";
+export * from "./AgentPrompting";

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

@@ -18,8 +18,8 @@ __exportStar(require("./PiiCategory"), exports);
 __exportStar(require("./AgentEnvironment"), exports);
 __exportStar(require("./Agent"), exports);
 __exportStar(require("./CreateAgentRequest"), exports);
-__exportStar(require("./AgentPatchRequest"), exports);
 __exportStar(require("./AgentsSearchRequest"), exports);
 __exportStar(require("./AgentField"), exports);
 __exportStar(require("./AgentFilter"), exports);
 __exportStar(require("./AgentsSearchResponse"), exports);
+__exportStar(require("./AgentPrompting"), exports);

package/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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;