mavenagi 1.0.6 → 1.0.7

package/README.md

@@ -57,7 +57,7 @@ await client.analytics.getConversationTable({
             metric: {
                 type: "percentile",
                 targetField: "HandleTime",
-                percentiles: [25, 75],
+                percentile: 25,
             },
         },
     ],

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

@@ -87,7 +87,7 @@ class Actions {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, "/v1/actions"),
                 method: "PUT",
-                headers: Object.assign({ Authorization: yield this._getAuthorizationHeader(), "X-Organization-Id": yield core.Supplier.get(this._options.organizationId), "X-Agent-Id": yield core.Supplier.get(this._options.agentId), "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "mavenagi", "X-Fern-SDK-Version": "1.0.6", "User-Agent": "mavenagi/1.0.6", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign({ Authorization: yield this._getAuthorizationHeader(), "X-Organization-Id": yield core.Supplier.get(this._options.organizationId), "X-Agent-Id": yield core.Supplier.get(this._options.agentId), "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "mavenagi", "X-Fern-SDK-Version": "1.0.7", "User-Agent": "mavenagi/1.0.7", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.ActionRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -167,7 +167,7 @@ class Actions {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, `/v1/actions/${encodeURIComponent(actionReferenceId)}`),
                 method: "GET",
-                headers: Object.assign({ Authorization: yield this._getAuthorizationHeader(), "X-Organization-Id": yield core.Supplier.get(this._options.organizationId), "X-Agent-Id": yield core.Supplier.get(this._options.agentId), "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "mavenagi", "X-Fern-SDK-Version": "1.0.6", "User-Agent": "mavenagi/1.0.6", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign({ Authorization: yield this._getAuthorizationHeader(), "X-Organization-Id": yield core.Supplier.get(this._options.organizationId), "X-Agent-Id": yield core.Supplier.get(this._options.agentId), "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "mavenagi", "X-Fern-SDK-Version": "1.0.7", "User-Agent": "mavenagi/1.0.7", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
@@ -246,7 +246,7 @@ class Actions {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, `/v1/actions/${encodeURIComponent(actionReferenceId)}`),
                 method: "DELETE",
-                headers: Object.assign({ Authorization: yield this._getAuthorizationHeader(), "X-Organization-Id": yield core.Supplier.get(this._options.organizationId), "X-Agent-Id": yield core.Supplier.get(this._options.agentId), "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "mavenagi", "X-Fern-SDK-Version": "1.0.6", "User-Agent": "mavenagi/1.0.6", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign({ Authorization: yield this._getAuthorizationHeader(), "X-Organization-Id": yield core.Supplier.get(this._options.organizationId), "X-Agent-Id": yield core.Supplier.get(this._options.agentId), "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "mavenagi", "X-Fern-SDK-Version": "1.0.7", "User-Agent": "mavenagi/1.0.7", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,

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

@@ -68,11 +68,95 @@ export declare class Analytics {
      *                 metric: {
      *                     type: "percentile",
      *                     targetField: "HandleTime",
-     *                     percentiles: [25, 75]
+     *                     percentile: 25
      *                 }
      *             }]
      *     })
      */
     getConversationTable(request: MavenAGI.ConversationTableRequest, requestOptions?: Analytics.RequestOptions): Promise<MavenAGI.ConversationTableResponse>;
+    /**
+     * Fetches conversation data visualized in a chart format. Supported chart types include pie chart, date histogram, and stacked bar charts.
+     *
+     * @param {MavenAGI.ConversationChartRequest} request
+     * @param {Analytics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.analytics.getConversationChart({
+     *         type: "pieChart",
+     *         conversationFilter: {
+     *             languages: ["en", "es"]
+     *         },
+     *         groupBy: {
+     *             field: "Category"
+     *         },
+     *         metric: {
+     *             type: "count"
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.analytics.getConversationChart({
+     *         type: "dateHistogram",
+     *         conversationFilter: {
+     *             languages: ["en", "es"]
+     *         },
+     *         timeInterval: "DAY",
+     *         groupBy: {
+     *             field: "Category"
+     *         },
+     *         metric: {
+     *             type: "count"
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.analytics.getConversationChart({
+     *         type: "barChart",
+     *         conversationFilter: {
+     *             languages: ["en", "es"]
+     *         },
+     *         barDefinition: {
+     *             field: "Category"
+     *         },
+     *         metric: {
+     *             type: "count"
+     *         },
+     *         verticalGrouping: {
+     *             field: "ResolutionStatus"
+     *         }
+     *     })
+     */
+    getConversationChart(request: MavenAGI.ConversationChartRequest, requestOptions?: Analytics.RequestOptions): Promise<MavenAGI.ChartResponse>;
+    /**
+     * Retrieves structured feedback data formatted as a table, allowing users to group, filter,  and define specific metrics to display as columns.
+     *
+     * @param {MavenAGI.FeedbackTableRequest} request
+     * @param {Analytics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.analytics.getFeedbackTable({
+     *         feedbackFilter: {
+     *             types: ["THUMBS_UP", "INSERT"]
+     *         },
+     *         fieldGroupings: [{
+     *                 field: "CreatedBy"
+     *             }],
+     *         columnDefinitions: [{
+     *                 header: "feedback_count",
+     *                 metric: {
+     *                     type: "count"
+     *                 }
+     *             }]
+     *     })
+     */
+    getFeedbackTable(request: MavenAGI.FeedbackTableRequest, requestOptions?: Analytics.RequestOptions): Promise<MavenAGI.FeedbackTableResponse>;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -84,7 +84,7 @@ class Analytics {
      *                 metric: {
      *                     type: "percentile",
      *                     targetField: "HandleTime",
-     *                     percentiles: [25, 75]
+     *                     percentile: 25
      *                 }
      *             }]
      *     })
@@ -95,7 +95,7 @@ class Analytics {
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
                 url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, "/v1/tables/conversations"),
                 method: "POST",
-                headers: Object.assign({ Authorization: yield this._getAuthorizationHeader(), "X-Organization-Id": yield core.Supplier.get(this._options.organizationId), "X-Agent-Id": yield core.Supplier.get(this._options.agentId), "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "mavenagi", "X-Fern-SDK-Version": "1.0.6", "User-Agent": "mavenagi/1.0.6", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: Object.assign({ Authorization: yield this._getAuthorizationHeader(), "X-Organization-Id": yield core.Supplier.get(this._options.organizationId), "X-Agent-Id": yield core.Supplier.get(this._options.agentId), "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "mavenagi", "X-Fern-SDK-Version": "1.0.7", "User-Agent": "mavenagi/1.0.7", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.ConversationTableRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -156,6 +156,222 @@ class Analytics {
             }
         });
     }
+    /**
+     * Fetches conversation data visualized in a chart format. Supported chart types include pie chart, date histogram, and stacked bar charts.
+     *
+     * @param {MavenAGI.ConversationChartRequest} request
+     * @param {Analytics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.analytics.getConversationChart({
+     *         type: "pieChart",
+     *         conversationFilter: {
+     *             languages: ["en", "es"]
+     *         },
+     *         groupBy: {
+     *             field: "Category"
+     *         },
+     *         metric: {
+     *             type: "count"
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.analytics.getConversationChart({
+     *         type: "dateHistogram",
+     *         conversationFilter: {
+     *             languages: ["en", "es"]
+     *         },
+     *         timeInterval: "DAY",
+     *         groupBy: {
+     *             field: "Category"
+     *         },
+     *         metric: {
+     *             type: "count"
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.analytics.getConversationChart({
+     *         type: "barChart",
+     *         conversationFilter: {
+     *             languages: ["en", "es"]
+     *         },
+     *         barDefinition: {
+     *             field: "Category"
+     *         },
+     *         metric: {
+     *             type: "count"
+     *         },
+     *         verticalGrouping: {
+     *             field: "ResolutionStatus"
+     *         }
+     *     })
+     */
+    getConversationChart(request, requestOptions) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, "/v1/charts/conversations"),
+                method: "POST",
+                headers: Object.assign({ Authorization: yield this._getAuthorizationHeader(), "X-Organization-Id": yield core.Supplier.get(this._options.organizationId), "X-Agent-Id": yield core.Supplier.get(this._options.agentId), "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "mavenagi", "X-Fern-SDK-Version": "1.0.7", "User-Agent": "mavenagi/1.0.7", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.ConversationChartRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                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 serializers.ChartResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    breadcrumbsPrefix: ["response"],
+                });
+            }
+            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"],
+                        }));
+                    case 400:
+                        throw new MavenAGI.BadRequestError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    case 500:
+                        throw new MavenAGI.ServerError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    default:
+                        throw new errors.MavenAGIError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.MavenAGIError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                    });
+                case "timeout":
+                    throw new errors.MavenAGITimeoutError("Timeout exceeded when calling POST /v1/charts/conversations.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                    });
+            }
+        });
+    }
+    /**
+     * Retrieves structured feedback data formatted as a table, allowing users to group, filter,  and define specific metrics to display as columns.
+     *
+     * @param {MavenAGI.FeedbackTableRequest} request
+     * @param {Analytics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.analytics.getFeedbackTable({
+     *         feedbackFilter: {
+     *             types: ["THUMBS_UP", "INSERT"]
+     *         },
+     *         fieldGroupings: [{
+     *                 field: "CreatedBy"
+     *             }],
+     *         columnDefinitions: [{
+     *                 header: "feedback_count",
+     *                 metric: {
+     *                     type: "count"
+     *                 }
+     *             }]
+     *     })
+     */
+    getFeedbackTable(request, requestOptions) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: (0, url_join_1.default)((_b = (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, "/v1/tables/feedback"),
+                method: "POST",
+                headers: Object.assign({ Authorization: yield this._getAuthorizationHeader(), "X-Organization-Id": yield core.Supplier.get(this._options.organizationId), "X-Agent-Id": yield core.Supplier.get(this._options.agentId), "X-Fern-Language": "JavaScript", "X-Fern-SDK-Name": "mavenagi", "X-Fern-SDK-Version": "1.0.7", "User-Agent": "mavenagi/1.0.7", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                requestType: "json",
+                body: serializers.FeedbackTableRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
+                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 serializers.FeedbackTableResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    breadcrumbsPrefix: ["response"],
+                });
+            }
+            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"],
+                        }));
+                    case 400:
+                        throw new MavenAGI.BadRequestError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    case 500:
+                        throw new MavenAGI.ServerError(serializers.ErrorMessage.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            breadcrumbsPrefix: ["response"],
+                        }));
+                    default:
+                        throw new errors.MavenAGIError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.MavenAGIError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                    });
+                case "timeout":
+                    throw new errors.MavenAGITimeoutError("Timeout exceeded when calling POST /v1/tables/feedback.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                    });
+            }
+        });
+    }
     _getAuthorizationHeader() {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {

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

@@ -0,0 +1,18 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface BarChartRequest extends MavenAGI.ConversationAnalyticsRequest {
+    /**
+     * 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.
+     */
+    barDefinition: MavenAGI.ConversationGroupBy;
+    /** Metric defining the y-axis values for the bar chart. */
+    metric: MavenAGI.ConversationMetric;
+    /**
+     * Optionally defines vertical grouping within each bar, producing multiple series.
+     * If omitted, a single series is generated.
+     */
+    verticalGrouping?: MavenAGI.ConversationGroupBy;
+}

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

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface BarChartResponse {
+    /**
+     * Each LabeledPoint in the series represents a value for the bar, where the name serves as the bar's label.
+     * If vertical grouping is defined, multiple series will be created, each representing a group.
+     * In such cases, the bars can be stacked to reflect the grouped data distribution.
+     */
+    series: MavenAGI.Series[];
+}

package/api/resources/{analyticsCommons → analytics}/types/CellData.d.ts

@@ -2,12 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as MavenAGI from "../../../index";
-export declare type CellData = MavenAGI.CellData.Double | MavenAGI.CellData.Long | MavenAGI.CellData.Millisecond | MavenAGI.CellData.String
-/**
- * A map containing percentile values computed based on the percentile metric request.
- * Keys represent percentile levels, and values are their corresponding computed results.
- *  */
- | MavenAGI.CellData.PercentileMap;
+export declare type CellData = MavenAGI.CellData.Double | MavenAGI.CellData.Long | MavenAGI.CellData.Millisecond | MavenAGI.CellData.String;
 export declare namespace CellData {
     interface Double {
         type: "double";
@@ -25,8 +20,4 @@ export declare namespace CellData {
         type: "string";
         value: string;
     }
-    interface PercentileMap {
-        type: "percentileMap";
-        value: Record<string, number>;
-    }
 }

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

@@ -0,0 +1,80 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+/**
+ * @example
+ *     {
+ *         type: "pieChart",
+ *         series: {
+ *             name: "Series",
+ *             data: [{
+ *                     label: "Sales",
+ *                     y: 5
+ *                 }, {
+ *                     label: "Support",
+ *                     y: 10
+ *                 }]
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         type: "dateHistogram",
+ *         timeSeries: [{
+ *                 name: "Sales",
+ *                 data: [{
+ *                         x: 1633046400000,
+ *                         y: 5
+ *                     }, {
+ *                         x: 1633132800000,
+ *                         y: 7
+ *                     }]
+ *             }, {
+ *                 name: "Support",
+ *                 data: [{
+ *                         x: 1633046400000,
+ *                         y: 10
+ *                     }, {
+ *                         x: 1633132800000,
+ *                         y: 8
+ *                     }]
+ *             }]
+ *     }
+ *
+ * @example
+ *     {
+ *         type: "barChart",
+ *         series: [{
+ *                 name: "Resolved",
+ *                 data: [{
+ *                         label: "Sales",
+ *                         y: 5
+ *                     }, {
+ *                         label: "Support",
+ *                         y: 10
+ *                     }]
+ *             }, {
+ *                 name: "Escalated",
+ *                 data: [{
+ *                         label: "Sales",
+ *                         y: 7
+ *                     }, {
+ *                         label: "Support",
+ *                         y: 8
+ *                     }]
+ *             }]
+ *     }
+ */
+export declare type ChartResponse = MavenAGI.ChartResponse.PieChart | MavenAGI.ChartResponse.DateHistogram | MavenAGI.ChartResponse.BarChart;
+export declare namespace ChartResponse {
+    interface PieChart extends MavenAGI.PieChartResponse {
+        type: "pieChart";
+    }
+    interface DateHistogram extends MavenAGI.DateHistogramResponse {
+        type: "dateHistogram";
+    }
+    interface BarChart extends MavenAGI.BarChartResponse {
+        type: "barChart";
+    }
+}

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

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface ColumnDefinitionBase {
+    /** Unique column header, serving as the key for corresponding metric values. */
+    header: string;
+}

package/api/resources/analytics/types/{Average.d.ts → ConversationAverage.d.ts}

@@ -5,5 +5,5 @@ import * as MavenAGI from "../../../index";
 /**
  * Calculates the average value of the specified field.
  */
-export interface Average extends MavenAGI.BasicMetric {
+export interface ConversationAverage extends MavenAGI.ConversationNumericMetric {
 }

package/{dist/api/resources/analytics/types/BasicMetric.d.ts → api/resources/analytics/types/ConversationBasicMetric.d.ts}

@@ -2,7 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as MavenAGI from "../../../index";
-export interface BasicMetric {
-    /** Field to apply the metric to. The field should be numeric for all metrics except for Count (no field) and DistinctCount. */
+export interface ConversationBasicMetric {
+    /** Field to apply the metric to. */
     targetField: MavenAGI.ConversationField;
 }

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

@@ -0,0 +1,63 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+/**
+ * @example
+ *     {
+ *         type: "pieChart",
+ *         conversationFilter: {
+ *             languages: ["en", "es"]
+ *         },
+ *         groupBy: {
+ *             field: MavenAGI.ConversationField.Category
+ *         },
+ *         metric: {
+ *             type: "count"
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         type: "dateHistogram",
+ *         conversationFilter: {
+ *             languages: ["en", "es"]
+ *         },
+ *         timeInterval: MavenAGI.TimeInterval.Day,
+ *         groupBy: {
+ *             field: MavenAGI.ConversationField.Category
+ *         },
+ *         metric: {
+ *             type: "count"
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         type: "barChart",
+ *         conversationFilter: {
+ *             languages: ["en", "es"]
+ *         },
+ *         barDefinition: {
+ *             field: MavenAGI.ConversationField.Category
+ *         },
+ *         metric: {
+ *             type: "count"
+ *         },
+ *         verticalGrouping: {
+ *             field: MavenAGI.ConversationField.ResolutionStatus
+ *         }
+ *     }
+ */
+export declare type ConversationChartRequest = MavenAGI.ConversationChartRequest.PieChart | MavenAGI.ConversationChartRequest.DateHistogram | MavenAGI.ConversationChartRequest.BarChart;
+export declare namespace ConversationChartRequest {
+    interface PieChart extends MavenAGI.PieChartRequest {
+        type: "pieChart";
+    }
+    interface DateHistogram extends MavenAGI.DateHistogramRequest {
+        type: "dateHistogram";
+    }
+    interface BarChart extends MavenAGI.BarChartRequest {
+        type: "barChart";
+    }
+}

package/{dist/api/resources/analytics/types/ColumnDefinition.d.ts → api/resources/analytics/types/ConversationColumnDefinition.d.ts}

@@ -2,9 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as MavenAGI from "../../../index";
-export interface ColumnDefinition {
-    /** Unique column header, serving as the key for corresponding metric values. */
-    header: string;
+export interface ConversationColumnDefinition extends MavenAGI.ColumnDefinitionBase {
     /** The metric calculated for this column, stored in the row data under the specified header. */
-    metric: MavenAGI.Metric;
+    metric: MavenAGI.ConversationMetric;
 }

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Returns the total count of records in a group.
+ */
+export interface ConversationCount {
+}

package/{dist/api/resources/analytics/types/DistinctCount.d.ts → api/resources/analytics/types/ConversationDistinctCount.d.ts}

@@ -3,8 +3,8 @@
  */
 import * as MavenAGI from "../../../index";
 /**
- * Estimates the number of unique values in the specified field.
+ * Calculates the number of unique values in the specified field.
  * Supports fields with list values as well.
  */
-export interface DistinctCount extends MavenAGI.BasicMetric {
+export interface ConversationDistinctCount extends MavenAGI.ConversationBasicMetric {
 }

package/api/resources/analytics/types/{GroupBy.d.ts → ConversationGroupBy.d.ts}

@@ -2,11 +2,9 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as MavenAGI from "../../../index";
-export interface GroupBy {
+export interface ConversationGroupBy extends MavenAGI.GroupByBase {
     /** Field used for data grouping. */
     field: MavenAGI.ConversationField;
-    /** Limits the number of groups returned (defaults to 100 if omitted). */
-    limit?: number;
     /** Numeric ranges for grouping data into predefined buckets. Applies only to numeric fields. */
     ranges?: MavenAGI.Range[];
 }