mavenagi 1.2.5 → 1.2.6

package/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.5",
-                "User-Agent": "mavenagi/1.2.5",
+                "X-Fern-SDK-Version": "1.2.6",
+                "User-Agent": "mavenagi/1.2.6",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/README.md

@@ -107,7 +107,7 @@ try {
 You can consume binary data from endpoints using the `BinaryResponse` type which lets you choose how to consume the data:
 
 ```typescript
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 const stream: ReadableStream<Uint8Array> = response.stream();
 // const arrayBuffer: ArrayBuffer = await response.arrayBuffer();
 // const blob: Blob = response.blob();
@@ -133,7 +133,7 @@ import { createWriteStream } from 'fs';
 import { Readable } from 'stream';
 import { pipeline } from 'stream/promises';
 
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const stream = response.stream();
 const nodeStream = Readable.fromWeb(stream);
@@ -152,7 +152,7 @@ await pipeline(nodeStream, writeStream);
 ```ts
 import { writeFile } from 'fs/promises';
 
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const arrayBuffer = await response.arrayBuffer();
 await writeFile('path/to/file', Buffer.from(arrayBuffer));
@@ -168,7 +168,7 @@ await writeFile('path/to/file', Buffer.from(arrayBuffer));
 ```ts
 import { writeFile } from 'fs/promises';
 
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const blob = await response.blob();
 const arrayBuffer = await blob.arrayBuffer();
@@ -185,7 +185,7 @@ await writeFile('output.bin', Buffer.from(arrayBuffer));
 ```ts
 import { writeFile } from 'fs/promises';
 
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const bytes = await response.bytes();
 await writeFile('path/to/file', bytes);
@@ -206,7 +206,7 @@ await writeFile('path/to/file', bytes);
 <summary>ReadableStream (most-efficient)</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const stream = response.stream();
 await Bun.write('path/to/file', stream);
@@ -220,7 +220,7 @@ await Bun.write('path/to/file', stream);
 <summary>ArrayBuffer</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const arrayBuffer = await response.arrayBuffer();
 await Bun.write('path/to/file', arrayBuffer);
@@ -234,7 +234,7 @@ await Bun.write('path/to/file', arrayBuffer);
 <summary>Blob</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const blob = await response.blob();
 await Bun.write('path/to/file', blob);
@@ -248,7 +248,7 @@ await Bun.write('path/to/file', blob);
 <summary>Bytes (UIntArray8)</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const bytes = await response.bytes();
 await Bun.write('path/to/file', bytes);
@@ -269,7 +269,7 @@ await Bun.write('path/to/file', bytes);
 <summary>ReadableStream (most-efficient)</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const stream = response.stream();
 const file = await Deno.open('path/to/file', { write: true, create: true });
@@ -284,7 +284,7 @@ await stream.pipeTo(file.writable);
 <summary>ArrayBuffer</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const arrayBuffer = await response.arrayBuffer();
 await Deno.writeFile('path/to/file', new Uint8Array(arrayBuffer));
@@ -298,7 +298,7 @@ await Deno.writeFile('path/to/file', new Uint8Array(arrayBuffer));
 <summary>Blob</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const blob = await response.blob();
 const arrayBuffer = await blob.arrayBuffer();
@@ -313,7 +313,7 @@ await Deno.writeFile('path/to/file', new Uint8Array(arrayBuffer));
 <summary>Bytes (UIntArray8)</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const bytes = await response.bytes();
 await Deno.writeFile('path/to/file', bytes);
@@ -334,7 +334,7 @@ await Deno.writeFile('path/to/file', bytes);
 <summary>Blob (most-efficient)</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const blob = await response.blob();
 const url = URL.createObjectURL(blob);
@@ -355,7 +355,7 @@ URL.revokeObjectURL(url);
 <summary>ReadableStream</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const stream = response.stream();
 const reader = stream.getReader();
@@ -386,7 +386,7 @@ URL.revokeObjectURL(url);
 <summary>ArrayBuffer</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const arrayBuffer = await response.arrayBuffer();
 const blob = new Blob([arrayBuffer]);
@@ -408,7 +408,7 @@ URL.revokeObjectURL(url);
 <summary>Bytes (UIntArray8)</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const bytes = await response.bytes();
 const blob = new Blob([bytes]);
@@ -439,7 +439,7 @@ URL.revokeObjectURL(url);
 <summary>ReadableStream</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const stream = response.stream();
 const text = await new Response(stream).text();
@@ -453,7 +453,7 @@ const text = await new Response(stream).text();
 <summary>ArrayBuffer</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const arrayBuffer = await response.arrayBuffer();
 const text = new TextDecoder().decode(arrayBuffer);
@@ -467,7 +467,7 @@ const text = new TextDecoder().decode(arrayBuffer);
 <summary>Blob</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const blob = await response.blob();
 const text = await blob.text();
@@ -481,7 +481,7 @@ const text = await blob.text();
 <summary>Bytes (UIntArray8)</summary>
 
 ```ts
-const response = await client.conversation.export(...);
+const response = await client.analytics.exportConversationTable(...);
 
 const bytes = await response.bytes();
 const text = new TextDecoder().decode(bytes);

package/api/resources/agentCapabilities/types/ActionCapability.d.ts

@@ -2,7 +2,7 @@ import * as MavenAGI from "../../../index";
 export interface ActionCapability extends MavenAGI.AgentCapabilityBase {
     userInteractionRequired: boolean;
     /** When user interaction is required, the name of the button that is shown to the end user to confirm execution of the action. Defaults to "Submit" if not supplied. */
-    buttonName: string | null;
+    buttonName?: string;
     /** The parameters that the action uses as input. An action will only be executed when all of the required parameters are provided. Parameter values may be inferred from the user's conversation by the LLM. */
     userFormParameters: MavenAGI.ActionParameter[];
     precondition?: MavenAGI.Precondition;

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

@@ -136,6 +136,16 @@ export declare class Analytics {
      */
     getConversationChart(request: MavenAGI.ConversationChartRequest, requestOptions?: Analytics.RequestOptions): core.HttpResponsePromise<MavenAGI.ChartResponse>;
     private __getConversationChart;
+    /**
+     * 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: MavenAGI.ConversationTableRequest, requestOptions?: Analytics.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    private __exportConversationTable;
     /**
      * 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/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/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/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/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.5",
-                "User-Agent": "mavenagi/1.2.5",
+                "X-Fern-SDK-Version": "1.2.6",
+                "User-Agent": "mavenagi/1.2.6",
                 "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/agentCapabilities/types/ActionCapability.d.ts

@@ -2,7 +2,7 @@ import * as MavenAGI from "../../../index";
 export interface ActionCapability extends MavenAGI.AgentCapabilityBase {
     userInteractionRequired: boolean;
     /** When user interaction is required, the name of the button that is shown to the end user to confirm execution of the action. Defaults to "Submit" if not supplied. */
-    buttonName: string | null;
+    buttonName?: string;
     /** The parameters that the action uses as input. An action will only be executed when all of the required parameters are provided. Parameter values may be inferred from the user's conversation by the LLM. */
     userFormParameters: MavenAGI.ActionParameter[];
     precondition?: MavenAGI.Precondition;

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

@@ -136,6 +136,16 @@ export declare class Analytics {
      */
     getConversationChart(request: MavenAGI.ConversationChartRequest, requestOptions?: Analytics.RequestOptions): core.HttpResponsePromise<MavenAGI.ChartResponse>;
     private __getConversationChart;
+    /**
+     * 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: MavenAGI.ConversationTableRequest, requestOptions?: Analytics.RequestOptions): core.HttpResponsePromise<core.BinaryResponse>;
+    private __exportConversationTable;
     /**
      * Retrieves structured feedback data formatted as a table, allowing users to group, filter,  and define specific metrics to display as columns.
      *

package/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/serialization/resources/agentCapabilities/types/ActionCapability.js

@@ -42,7 +42,7 @@ const AgentCapabilityBase_1 = require("./AgentCapabilityBase");
 exports.ActionCapability = core.serialization
     .object({
     userInteractionRequired: core.serialization.boolean(),
-    buttonName: core.serialization.string().nullable(),
+    buttonName: core.serialization.string().optional(),
     userFormParameters: core.serialization.list(ActionParameter_1.ActionParameter),
     precondition: core.serialization.lazy(() => serializers.Precondition).optional(),
     descriptionOverride: core.serialization.string().optional(),

package/dist/serialization/resources/commons/types/AppUserResponse.d.ts

@@ -2,6 +2,7 @@ import * as serializers from "../../../index";
 import * as MavenAGI from "../../../../api/index";
 import * as core from "../../../../core";
 import { EntityId } from "./EntityId";
+import { UserDataWithReference } from "./UserDataWithReference";
 import { AppUser } from "./AppUser";
 export declare const AppUserResponse: core.serialization.ObjectSchema<serializers.AppUserResponse.Raw, MavenAGI.AppUserResponse>;
 export declare namespace AppUserResponse {
@@ -10,5 +11,6 @@ export declare namespace AppUserResponse {
         agentUserId: string;
         allUserData: Record<string, Record<string, string>>;
         defaultUserData: Record<string, string>;
+        agentUserData: Record<string, UserDataWithReference.Raw[]>;
     }
 }

package/dist/serialization/resources/commons/types/AppUserResponse.js

@@ -37,6 +37,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppUserResponse = void 0;
 const core = __importStar(require("../../../../core"));
 const EntityId_1 = require("./EntityId");
+const UserDataWithReference_1 = require("./UserDataWithReference");
 const AppUser_1 = require("./AppUser");
 exports.AppUserResponse = core.serialization
     .object({
@@ -44,5 +45,6 @@ exports.AppUserResponse = core.serialization
     agentUserId: core.serialization.string(),
     allUserData: core.serialization.record(core.serialization.string(), core.serialization.record(core.serialization.string(), core.serialization.string())),
     defaultUserData: core.serialization.record(core.serialization.string(), core.serialization.string()),
+    agentUserData: core.serialization.record(core.serialization.string(), core.serialization.list(UserDataWithReference_1.UserDataWithReference)),
 })
     .extend(AppUser_1.AppUser);

package/dist/serialization/resources/commons/types/ConversationSummary.d.ts

@@ -17,5 +17,7 @@ export declare namespace ConversationSummary {
         humanAgents: string[];
         humanAgentsWithInserts: string[];
         users: string[];
+        lastUserMessage?: string | null;
+        lastBotMessage?: string | null;
     }
 }

package/dist/serialization/resources/commons/types/ConversationSummary.js

@@ -50,4 +50,6 @@ exports.ConversationSummary = core.serialization.object({
     humanAgents: core.serialization.list(core.serialization.string()),
     humanAgentsWithInserts: core.serialization.list(core.serialization.string()),
     users: core.serialization.list(core.serialization.string()),
+    lastUserMessage: core.serialization.string().optional(),
+    lastBotMessage: core.serialization.string().optional(),
 });

package/dist/serialization/resources/commons/types/UserDataWithReference.d.ts

@@ -0,0 +1,11 @@
+import * as serializers from "../../../index";
+import * as MavenAGI from "../../../../api/index";
+import * as core from "../../../../core";
+import { EntityIdFilter } from "./EntityIdFilter";
+import { UserData } from "./UserData";
+export declare const UserDataWithReference: core.serialization.ObjectSchema<serializers.UserDataWithReference.Raw, MavenAGI.UserDataWithReference>;
+export declare namespace UserDataWithReference {
+    interface Raw extends UserData.Raw {
+        userId: EntityIdFilter.Raw;
+    }
+}

package/dist/serialization/resources/commons/types/UserDataWithReference.js

@@ -0,0 +1,45 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserDataWithReference = void 0;
+const core = __importStar(require("../../../../core"));
+const EntityIdFilter_1 = require("./EntityIdFilter");
+const UserData_1 = require("./UserData");
+exports.UserDataWithReference = core.serialization
+    .object({
+    userId: EntityIdFilter_1.EntityIdFilter,
+})
+    .extend(UserData_1.UserData);

package/dist/serialization/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/dist/serialization/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/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.2.5";
+export declare const SDK_VERSION = "1.2.6";

package/dist/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "1.2.5";
+exports.SDK_VERSION = "1.2.6";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mavenagi",
-    "version": "1.2.5",
+    "version": "1.2.6",
     "private": false,
     "repository": "github:mavenagi/mavenagi-node",
     "main": "./index.js",

package/reference.md

@@ -1234,6 +1234,94 @@ await client.analytics.getConversationChart({
 </dl>
 </details>
 
+<details><summary><code>client.analytics.<a href="/src/api/resources/analytics/client/Client.ts">exportConversationTable</a>({ ...params }) -> core.BinaryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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.
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.analytics.exportConversationTable({
+    fieldGroupings: [
+        {
+            field: "Category",
+        },
+        {
+            field: "Category",
+        },
+    ],
+    columnDefinitions: [
+        {
+            metric: {
+                type: "count",
+            },
+            header: "header",
+        },
+        {
+            metric: {
+                type: "count",
+            },
+            header: "header",
+        },
+    ],
+});
+```
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `MavenAGI.ConversationTableRequest`
+
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Analytics.RequestOptions`
+
+</dd>
+</dl>
+</dd>
+</dl>
+
+</dd>
+</dl>
+</details>
+
 <details><summary><code>client.analytics.<a href="/src/api/resources/analytics/client/Client.ts">getFeedbackTable</a>({ ...params }) -> MavenAGI.FeedbackTableResponse</code></summary>
 <dl>
 <dd>

package/serialization/resources/agentCapabilities/types/ActionCapability.js

@@ -42,7 +42,7 @@ const AgentCapabilityBase_1 = require("./AgentCapabilityBase");
 exports.ActionCapability = core.serialization
     .object({
     userInteractionRequired: core.serialization.boolean(),
-    buttonName: core.serialization.string().nullable(),
+    buttonName: core.serialization.string().optional(),
     userFormParameters: core.serialization.list(ActionParameter_1.ActionParameter),
     precondition: core.serialization.lazy(() => serializers.Precondition).optional(),
     descriptionOverride: core.serialization.string().optional(),

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

@@ -2,6 +2,7 @@ import * as serializers from "../../../index";
 import * as MavenAGI from "../../../../api/index";
 import * as core from "../../../../core";
 import { EntityId } from "./EntityId";
+import { UserDataWithReference } from "./UserDataWithReference";
 import { AppUser } from "./AppUser";
 export declare const AppUserResponse: core.serialization.ObjectSchema<serializers.AppUserResponse.Raw, MavenAGI.AppUserResponse>;
 export declare namespace AppUserResponse {
@@ -10,5 +11,6 @@ export declare namespace AppUserResponse {
         agentUserId: string;
         allUserData: Record<string, Record<string, string>>;
         defaultUserData: Record<string, string>;
+        agentUserData: Record<string, UserDataWithReference.Raw[]>;
     }
 }

package/serialization/resources/commons/types/AppUserResponse.js

@@ -37,6 +37,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppUserResponse = void 0;
 const core = __importStar(require("../../../../core"));
 const EntityId_1 = require("./EntityId");
+const UserDataWithReference_1 = require("./UserDataWithReference");
 const AppUser_1 = require("./AppUser");
 exports.AppUserResponse = core.serialization
     .object({
@@ -44,5 +45,6 @@ exports.AppUserResponse = core.serialization
     agentUserId: core.serialization.string(),
     allUserData: core.serialization.record(core.serialization.string(), core.serialization.record(core.serialization.string(), core.serialization.string())),
     defaultUserData: core.serialization.record(core.serialization.string(), core.serialization.string()),
+    agentUserData: core.serialization.record(core.serialization.string(), core.serialization.list(UserDataWithReference_1.UserDataWithReference)),
 })
     .extend(AppUser_1.AppUser);

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

@@ -17,5 +17,7 @@ export declare namespace ConversationSummary {
         humanAgents: string[];
         humanAgentsWithInserts: string[];
         users: string[];
+        lastUserMessage?: string | null;
+        lastBotMessage?: string | null;
     }
 }

package/serialization/resources/commons/types/ConversationSummary.js

@@ -50,4 +50,6 @@ exports.ConversationSummary = core.serialization.object({
     humanAgents: core.serialization.list(core.serialization.string()),
     humanAgentsWithInserts: core.serialization.list(core.serialization.string()),
     users: core.serialization.list(core.serialization.string()),
+    lastUserMessage: core.serialization.string().optional(),
+    lastBotMessage: core.serialization.string().optional(),
 });

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

@@ -0,0 +1,11 @@
+import * as serializers from "../../../index";
+import * as MavenAGI from "../../../../api/index";
+import * as core from "../../../../core";
+import { EntityIdFilter } from "./EntityIdFilter";
+import { UserData } from "./UserData";
+export declare const UserDataWithReference: core.serialization.ObjectSchema<serializers.UserDataWithReference.Raw, MavenAGI.UserDataWithReference>;
+export declare namespace UserDataWithReference {
+    interface Raw extends UserData.Raw {
+        userId: EntityIdFilter.Raw;
+    }
+}

package/serialization/resources/commons/types/UserDataWithReference.js

@@ -0,0 +1,45 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserDataWithReference = void 0;
+const core = __importStar(require("../../../../core"));
+const EntityIdFilter_1 = require("./EntityIdFilter");
+const UserData_1 = require("./UserData");
+exports.UserDataWithReference = core.serialization
+    .object({
+    userId: EntityIdFilter_1.EntityIdFilter,
+})
+    .extend(UserData_1.UserData);

package/serialization/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/serialization/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/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.2.5";
+export declare const SDK_VERSION = "1.2.6";

package/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "1.2.5";
+exports.SDK_VERSION = "1.2.6";