mavenagi 1.0.12 → 1.1.0

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

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

package/api/resources/conversation/types/Attachment.d.ts

@@ -2,8 +2,25 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 export interface Attachment {
-    /** The mime-type of the attachment. Supported types are {image/jpeg, image/jpg, image/png, image/gif, image/webp}. */
+    /**
+     * The mime-type of the attachment. Supported types are:
+     * - image/jpeg
+     * - image/jpg
+     * - image/png
+     * - image/gif
+     * - image/webp
+     * - application/pdf
+     * - audio/aac
+     * - audio/mpeg
+     * - audio/mp4
+     * - video/mp4
+     *
+     * Image attachments will be sent to the LLM as additional data.
+     * Non-image attachments can be stored and downloaded from the API but will not be sent to the LLM.
+     */
     type: string;
     /** The attachment data, up to 5MB. */
     content: string;
+    /** The name of the attachment, if one was provided. */
+    name?: string;
 }

package/api/resources/conversation/types/ConversationField.d.ts

@@ -1,12 +1,13 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export type ConversationField = "Category" | "FirstResponseTime" | "HandleTime" | "HumanAgents" | "App" | "Sentiment" | "QualityReason" | "ResolutionStatus" | "Quality" | "Users" | "ResponseLength" | "ThumbsUpCount" | "ThumbsDownCount" | "InsertCount" | "Tags" | "UserMessageCount" | "Languages" | "Actions" | "IncompleteActions" | "Sources" | "CreatedAt";
+export type ConversationField = "Category" | "FirstResponseTime" | "HandleTime" | "HumanAgents" | "HumanAgentsWithInserts" | "App" | "Sentiment" | "QualityReason" | "ResolutionStatus" | "Quality" | "Users" | "ResponseLength" | "ThumbsUpCount" | "ThumbsDownCount" | "InsertCount" | "Tags" | "UserMessageCount" | "Languages" | "Actions" | "IncompleteActions" | "Sources" | "CreatedAt";
 export declare const ConversationField: {
     readonly Category: "Category";
     readonly FirstResponseTime: "FirstResponseTime";
     readonly HandleTime: "HandleTime";
     readonly HumanAgents: "HumanAgents";
+    readonly HumanAgentsWithInserts: "HumanAgentsWithInserts";
     readonly App: "App";
     readonly Sentiment: "Sentiment";
     readonly QualityReason: "QualityReason";

package/api/resources/conversation/types/ConversationField.js

@@ -9,6 +9,7 @@ exports.ConversationField = {
     FirstResponseTime: "FirstResponseTime",
     HandleTime: "HandleTime",
     HumanAgents: "HumanAgents",
+    HumanAgentsWithInserts: "HumanAgentsWithInserts",
     App: "App",
     Sentiment: "Sentiment",
     QualityReason: "QualityReason",

package/api/resources/conversation/types/ConversationFilter.d.ts

@@ -3,21 +3,42 @@
  */
 import * as MavenAGI from "../../../index";
 export interface ConversationFilter {
+    /** Full-text search query for matching conversations by content. When you search with this parameter, you're performing a full-text search across all textual content in the conversations, including both the user's messages and the AI's responses. */
     search?: string;
+    /** Filter conversations created on or after this timestamp */
     createdAfter?: Date;
+    /** Filter conversations created on or before this timestamp */
     createdBefore?: Date;
+    /** Filter by app IDs */
     apps?: string[];
+    /** Filter by conversation categories */
     categories?: string[];
+    /** Filter by actions that were executed in the conversation */
     actions?: MavenAGI.EntityIdFilter[];
+    /** Filter by actions that were suggested but not completed by the AI agent */
     incompleteActions?: MavenAGI.EntityIdFilter[];
+    /** Filter by user feedback types received in the conversation */
     feedback?: MavenAGI.FeedbackType[];
+    /** Filter by human agents who participated in the conversation */
     humanAgents?: string[];
+    /** Filter by human agents who inserted a maven AI generated suggestion in the conversation */
+    humanAgentsWithInserts?: string[];
+    /** Filter by conversation languages */
     languages?: string[];
+    /** Filter by AI assessed conversation quality classification */
     quality?: MavenAGI.Quality[];
+    /** Filter by AI assessed quality reason classification */
     qualityReason?: MavenAGI.QualityReason[];
+    /** Filter by AI response length classification */
     responseLength?: MavenAGI.ResponseLength[];
+    /** Filter by AI assessed sentiment analysis */
     sentiment?: MavenAGI.Sentiment[];
+    /** Filter by tags applied to the conversation */
     tags?: string[];
+    /** Filter by conversation resolution status which is determined by AI based on the conversation content. */
     resolutionStatus?: MavenAGI.ResolutionStatus[];
+    /** Filter conversations based on whether they were resolved by Maven AI */
     resolvedByMaven?: boolean;
+    /** Filter by the number of messages sent by the user in the conversation */
+    userMessageCount?: MavenAGI.NumberRange;
 }

package/api/resources/conversation/types/ConversationMessageRequest.d.ts

@@ -5,4 +5,6 @@ import * as MavenAGI from "../../../index";
 export interface ConversationMessageRequest extends MavenAGI.UserMessageBase {
     /** The ID that uniquely identifies this message within the conversation */
     conversationMessageId: MavenAGI.EntityIdBase;
+    /** The attachments to the message. */
+    attachments?: MavenAGI.Attachment[];
 }

package/api/resources/conversation/types/FeedbackField.d.ts

@@ -1,9 +1,10 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export type FeedbackField = "Type" | "CreatedBy" | "CreatedAt";
+export type FeedbackField = "Type" | "CreatedBy" | "CreatedAt" | "App";
 export declare const FeedbackField: {
     readonly Type: "Type";
     readonly CreatedBy: "CreatedBy";
     readonly CreatedAt: "CreatedAt";
+    readonly App: "App";
 };

package/api/resources/conversation/types/FeedbackField.js

@@ -8,4 +8,5 @@ exports.FeedbackField = {
     Type: "Type",
     CreatedBy: "CreatedBy",
     CreatedAt: "CreatedAt",
+    App: "App",
 };

package/api/resources/conversation/types/FeedbackFilter.d.ts

@@ -6,5 +6,7 @@ export interface FeedbackFilter {
     search?: string;
     createdAfter?: Date;
     createdBefore?: Date;
+    users?: string[];
+    apps?: string[];
     types?: MavenAGI.FeedbackType[];
 }

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

@@ -15,6 +15,8 @@ export declare namespace Events {
         organizationId: core.Supplier<string>;
         /** Override the X-Agent-Id header */
         agentId: core.Supplier<string>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
         fetcher?: core.FetchFunction;
     }
     interface RequestOptions {
@@ -29,7 +31,7 @@ export declare namespace Events {
         /** Override the X-Agent-Id header */
         agentId?: string;
         /** Additional headers to include in the request. */
-        headers?: Record<string, string>;
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
 }
 export declare class Events {
@@ -48,6 +50,7 @@ export declare class Events {
      * @example
      *     await client.events.search({})
      */
-    search(request: MavenAGI.EventsSearchRequest, requestOptions?: Events.RequestOptions): Promise<MavenAGI.EventsSearchResponse>;
+    search(request: MavenAGI.EventsSearchRequest, requestOptions?: Events.RequestOptions): core.HttpResponsePromise<MavenAGI.EventsSearchResponse>;
+    private __search;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -44,16 +44,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Events = void 0;
 const environments = __importStar(require("../../../../environments"));
 const core = __importStar(require("../../../../core"));
 const MavenAGI = __importStar(require("../../../index"));
+const headers_1 = require("../../../../core/headers");
 const serializers = __importStar(require("../../../../serialization/index"));
-const url_join_1 = __importDefault(require("url-join"));
 const errors = __importStar(require("../../../../errors/index"));
 class Events {
     constructor(_options) {
@@ -73,12 +70,19 @@ class Events {
      *     await client.events.search({})
      */
     search(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__search(request, requestOptions));
+    }
+    __search(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c;
+            var _a, _b, _c, _d;
             const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
-                url: (0, url_join_1.default)((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.MavenAGIEnvironment.Production, "/v1/events/search"),
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.MavenAGIEnvironment.Production, "/v1/events/search"),
                 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.12", "User-Agent": "mavenagi/1.0.12", "X-Fern-Runtime": core.RUNTIME.type, "X-Fern-Runtime-Version": core.RUNTIME.version }, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                headers: (0, headers_1.mergeHeaders)((_d = this._options) === null || _d === void 0 ? void 0 : _d.headers, (0, headers_1.mergeOnlyDefinedHeaders)({
+                    Authorization: yield this._getAuthorizationHeader(),
+                    "X-Organization-Id": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.organizationId,
+                    "X-Agent-Id": requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.agentId,
+                }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
                 contentType: "application/json",
                 requestType: "json",
                 body: serializers.EventsSearchRequest.jsonOrThrow(request, { unrecognizedObjectKeys: "strip" }),
@@ -87,12 +91,15 @@ class Events {
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
-                return serializers.EventsSearchResponse.parseOrThrow(_response.body, {
-                    unrecognizedObjectKeys: "passthrough",
-                    allowUnrecognizedUnionMembers: true,
-                    allowUnrecognizedEnumValues: true,
-                    breadcrumbsPrefix: ["response"],
-                });
+                return {
+                    data: serializers.EventsSearchResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {
@@ -102,25 +109,26 @@ class Events {
                             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,
                         });
                 }
             }
@@ -129,12 +137,14 @@ class Events {
                     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/search.");
                 case "unknown":
                     throw new errors.MavenAGIError({
                         message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
                     });
             }
         });

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

@@ -15,6 +15,8 @@ export declare namespace Inbox {
         organizationId: core.Supplier<string>;
         /** Override the X-Agent-Id header */
         agentId: core.Supplier<string>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
         fetcher?: core.FetchFunction;
     }
     interface RequestOptions {
@@ -29,7 +31,7 @@ export declare namespace Inbox {
         /** Override the X-Agent-Id header */
         agentId?: string;
         /** Additional headers to include in the request. */
-        headers?: Record<string, string>;
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
     }
 }
 export declare class Inbox {
@@ -48,7 +50,8 @@ export declare class Inbox {
      * @example
      *     await client.inbox.search({})
      */
-    search(request: MavenAGI.InboxSearchRequest, requestOptions?: Inbox.RequestOptions): Promise<MavenAGI.InboxSearchResponse>;
+    search(request: MavenAGI.InboxSearchRequest, requestOptions?: Inbox.RequestOptions): core.HttpResponsePromise<MavenAGI.InboxSearchResponse>;
+    private __search;
     /**
      * Retrieve details of a specific inbox item by its ID.
      *
@@ -62,10 +65,12 @@ export declare class Inbox {
      *
      * @example
      *     await client.inbox.get("inboxItemId", {
-     *         appId: "appId"
+     *         appId: "appId",
+     *         itemType: "DUPLICATE_DOCUMENT"
      *     })
      */
-    get(inboxItemId: string, request: MavenAGI.InboxItemRequest, requestOptions?: Inbox.RequestOptions): Promise<MavenAGI.InboxItem>;
+    get(inboxItemId: string, request: MavenAGI.InboxItemRequest, requestOptions?: Inbox.RequestOptions): core.HttpResponsePromise<MavenAGI.InboxItem>;
+    private __get;
     /**
      * Retrieve a suggested fix. Includes document information if the fix is a Missing Knowledge suggestion.
      *
@@ -79,10 +84,12 @@ export declare class Inbox {
      *
      * @example
      *     await client.inbox.getFix("inboxItemFixId", {
-     *         appId: "appId"
+     *         appId: "appId",
+     *         fixType: "REMOVE_DOCUMENT"
      *     })
      */
-    getFix(inboxItemFixId: string, request: MavenAGI.InboxItemFixRequest, requestOptions?: Inbox.RequestOptions): Promise<MavenAGI.InboxItemFix>;
+    getFix(inboxItemFixId: string, request: MavenAGI.InboxItemFixRequest, requestOptions?: Inbox.RequestOptions): core.HttpResponsePromise<MavenAGI.InboxItemFix>;
+    private __getFix;
     /**
      * Apply a fix to an inbox item with a specific document.
      *
@@ -96,10 +103,12 @@ export declare class Inbox {
      *
      * @example
      *     await client.inbox.applyFix("inboxItemFixId", {
-     *         appId: "appId"
+     *         appId: "appId",
+     *         fixType: "REMOVE_DOCUMENT"
      *     })
      */
-    applyFix(inboxItemFixId: string, request: MavenAGI.ApplyInboxItemFixRequest, requestOptions?: Inbox.RequestOptions): Promise<void>;
+    applyFix(inboxItemFixId: string, request: MavenAGI.ApplyInboxItemFixRequest, requestOptions?: Inbox.RequestOptions): core.HttpResponsePromise<void>;
+    private __applyFix;
     /**
      * Ignore a specific inbox item by its ID.
      *
@@ -113,9 +122,11 @@ export declare class Inbox {
      *
      * @example
      *     await client.inbox.ignore("inboxItemId", {
-     *         appId: "appId"
+     *         appId: "appId",
+     *         itemType: "DUPLICATE_DOCUMENT"
      *     })
      */
-    ignore(inboxItemId: string, request: MavenAGI.InboxItemIgnoreRequest, requestOptions?: Inbox.RequestOptions): Promise<void>;
+    ignore(inboxItemId: string, request: MavenAGI.InboxItemIgnoreRequest, requestOptions?: Inbox.RequestOptions): core.HttpResponsePromise<void>;
+    private __ignore;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }