mavenagi 1.1.0 → 1.2.3

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

@@ -0,0 +1,257 @@
+"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;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Assets = 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 errors = __importStar(require("../../../../errors/index"));
+class Assets {
+    constructor(_options) {
+        this._options = _options;
+    }
+    /**
+     * Initiate an upload.
+     * Returns a pre-signed URL for direct file upload and an asset ID for subsequent operations.
+     *
+     * @param {MavenAGI.InitiateAssetUploadRequest} request
+     * @param {Assets.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.assets.initiateUpload({
+     *         type: "type"
+     *     })
+     */
+    initiateUpload(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__initiateUpload(request, requestOptions));
+    }
+    __initiateUpload(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                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/assets"),
+                method: "POST",
+                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.InitiateAssetUploadRequest.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 {
+                    data: serializers.InitiateAssetUploadResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    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/assets.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Commit an upload after successful file transfer.
+     * Updates the asset status and makes it available for use.
+     *
+     * @param {string} assetReferenceId - The reference ID of the asset to commit (provided by the initiate call). All other entity ID fields are inferred from the API request.
+     * @param {MavenAGI.CommitAssetUploadRequest} request
+     * @param {Assets.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.assets.commitUpload("assetReferenceId", {})
+     */
+    commitUpload(assetReferenceId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__commitUpload(assetReferenceId, request, requestOptions));
+    }
+    __commitUpload(assetReferenceId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                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/assets/${encodeURIComponent(assetReferenceId)}/commit`),
+                method: "POST",
+                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.CommitAssetUploadRequest.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 { data: undefined, 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/assets/{assetReferenceId}/commit.");
+                case "unknown":
+                    throw new errors.MavenAGIError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    _getAuthorizationHeader() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const appId = (_a = (yield core.Supplier.get(this._options.appId))) !== null && _a !== void 0 ? _a : process === null || process === void 0 ? void 0 : process.env["MAVENAGI_APP_ID"];
+            const appSecret = (_b = (yield core.Supplier.get(this._options.appSecret))) !== null && _b !== void 0 ? _b : process === null || process === void 0 ? void 0 : process.env["MAVENAGI_APP_SECRET"];
+            if (appId != null && appSecret != null) {
+                return core.BasicAuth.toAuthorizationHeader({
+                    username: appId,
+                    password: appSecret,
+                });
+            }
+            return undefined;
+        });
+    }
+}
+exports.Assets = Assets;

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

@@ -0,0 +1 @@
+export {};

package/api/resources/assets/client/index.js

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

package/api/resources/assets/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./client";

package/api/resources/assets/index.js

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

package/api/resources/assets/types/CommitAssetUploadRequest.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface CommitAssetUploadRequest {
+    /** Checksum of the uploaded file (optional verification) */
+    checksum?: string;
+}

package/api/resources/assets/types/InitiateAssetUploadRequest.d.ts

@@ -0,0 +1,6 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface InitiateAssetUploadRequest extends MavenAGI.BaseAttachment {
+}

package/api/resources/assets/types/InitiateAssetUploadResponse.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface InitiateAssetUploadResponse {
+    /** The ID of the asset. Use this ID to commit the asset after upload. */
+    assetId: MavenAGI.EntityIdBase;
+    /** Pre-signed URL for file upload. Use this URL to upload the file directly to storage. */
+    uploadUrl: string;
+    /** The expiration time for the upload URL */
+    expiresAt: Date;
+}

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

@@ -0,0 +1,3 @@
+export * from "./InitiateAssetUploadRequest";
+export * from "./InitiateAssetUploadResponse";
+export * from "./CommitAssetUploadRequest";

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export type ActionExecutionParamValue = MavenAGI.ActionExecutionParamValue.Primitive | MavenAGI.ActionExecutionParamValue.Attachment;
+export declare namespace ActionExecutionParamValue {
+    interface Primitive {
+        valueType: "primitive";
+        value?: unknown;
+    }
+    interface Attachment extends MavenAGI.AttachmentResponse {
+        valueType: "attachment";
+    }
+}

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

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface ActionOAuthConfiguration {
+    authorizationUrl: string;
+    tokenUrl: string;
+    clientId: string;
+    clientSecret: string;
+    scopes: string[];
+    extraAuthParams?: Record<string, string>;
+    extraTokenParams?: Record<string, string>;
+}

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

@@ -11,10 +11,29 @@ export interface ActionParameter {
     description: string;
     /** Whether the field is required for action execution. */
     required: boolean;
+    /** When user interaction is required, whether this parameter should be excluded from forms. Hidden parameters are not displayed to users but their values are still populated by the LLM and sent to actions. Defaults to false. */
+    hidden?: boolean;
     /** The parameter type. Values provided to `executeAction` will conform to this type. Defaults to `STRING`. */
     type?: MavenAGI.ActionParameterType;
     /** Restricts the action parameter to only the options in this list. Valid for type `STRING`, `BOOLEAN`, and `NUMBER`. Should not be used when type is `SCHEMA`. */
     enumOptions?: MavenAGI.ActionEnumOption[];
-    /** JSON schema for validating the parameter value. Only valid when type is `SCHEMA`. */
+    /**
+     * JSON schema for validating the parameter value. Only valid when type is `SCHEMA`.
+     *
+     * **Schema Requirements:**
+     * - Root type must be "object" - The top-level schema must define an object type
+     * - Supported types: string, number, boolean, integer, object, array, enum, anyOf
+     * - Unsupported features: oneOf, allOf, const, not, if/then/else, pattern, maxLength, minLength
+     * - Required fields: All fields must be required (no optional properties)
+     * - Additional properties: Must be set to false
+     *
+     * **Limits:**
+     * - Maximum nesting depth: 5 levels
+     * - Maximum total properties: 100
+     * - Maximum total string length: 15,000 characters
+     * - Maximum total enum values: 500
+     */
     schema?: string;
+    /** OAuth configuration required to start an OAuth authorization flow when this parameter's type is `OAUTH`. */
+    oauthConfiguration?: MavenAGI.ActionOAuthConfiguration;
 }

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

@@ -13,10 +13,18 @@ export type ActionParameterType =
  | "NUMBER"
 /**
  * Schema parameter type for complex structured data that adheres to a JSON schema definition. When this type is used this should be the only action parameter (all other parameters should be omitted), the `schema` field must be set and `enumOptions` should not be used. */
- | "SCHEMA";
+ | "SCHEMA"
+/**
+ * File parameter type for file uploads. */
+ | "FILE"
+/**
+ * OAuth authorization parameter type used to pass an access token at execution time. When this type is used it should be the only action parameter. This parameter is not sent to the LLM or shown on forms. */
+ | "OAUTH";
 export declare const ActionParameterType: {
     readonly String: "STRING";
     readonly Boolean: "BOOLEAN";
     readonly Number: "NUMBER";
     readonly Schema: "SCHEMA";
+    readonly File: "FILE";
+    readonly Oauth: "OAUTH";
 };

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

@@ -9,4 +9,6 @@ exports.ActionParameterType = {
     Boolean: "BOOLEAN",
     Number: "NUMBER",
     Schema: "SCHEMA",
+    File: "FILE",
+    Oauth: "OAUTH",
 };

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

@@ -14,6 +14,8 @@ import * as MavenAGI from "../../../index";
  *         },
  *         name: "Get the user's balance",
  *         description: "This action calls an API to get the user's current balance.",
+ *         instructions: "This action calls an API to get the user's current balance.",
+ *         llmInclusionStatus: MavenAGI.LlmInclusionStatus.WhenRelevant,
  *         userInteractionRequired: false,
  *         userFormParameters: [],
  *         precondition: {
@@ -27,10 +29,34 @@ import * as MavenAGI from "../../../index";
  *                     key: "userKey2"
  *                 }]
  *         },
- *         language: "en"
+ *         language: "en",
+ *         deleted: false
  *     }
  */
 export interface ActionResponse extends MavenAGI.ActionBase {
     /** ID that uniquely identifies this action */
     actionId: MavenAGI.EntityId;
+    /**
+     * The instructions given to the LLM when determining whether to execute the action.
+     * This field defaults to the `description` field if not provided. Use the `patch` API to update.
+     */
+    instructions?: string;
+    /**
+     * Determines whether the action is sent to the LLM as part of a conversation.
+     *
+     * - `ALWAYS`: The action is always available for use in conversations, textual relevance is not considered.
+     * - `WHEN_RELEVANT`: The action is available only in conversations where the action is determined to be relevant to the user's question.
+     * - `NEVER`: The action is not available for use in conversations.
+     */
+    llmInclusionStatus: MavenAGI.LlmInclusionStatus;
+    /**
+     * The IDs of the segment that must be matched for the action to be relevant to a conversation.
+     * Segments are replacing inline preconditions - an Action may not have both an inline precondition and a segment.
+     * Inline precondition support will be removed in a future release.
+     */
+    segmentId?: MavenAGI.EntityId;
+    /** A human-readable explanation of the precondition associated with this action, if present. */
+    preconditionExplanation?: string;
+    /** Whether the action has been deleted. Deleted actions will not sent to the LLM nor returned in search results. */
+    deleted: boolean;
 }

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

@@ -0,0 +1,22 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+/**
+ * Attachments can be created either with inline data (up to 5MB) using the `content` field or by
+ * referencing an asynchronously uploaded asset using the `assetId` field.
+ *
+ * See the Assets APIs for more details on how to upload assets and get an asset ID.
+ *
+ * <Tip>
+ *   Due to backwards compatibility, both the `type` field and the `name` field are present when attaching an Asset by ID.
+ *   These fields will be ignored in favor of the values supplied during the initial Asset upload.
+ *   They are only used for inline content uploads.
+ * </Tip>
+ */
+export interface AttachmentRequest extends MavenAGI.BaseAttachment {
+    /** Inline attachment data, up to 5MB. */
+    content?: string;
+    /** The ID of an asynchronously uploaded asset. */
+    assetId?: MavenAGI.EntityIdBase;
+}

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

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface AttachmentResponse extends MavenAGI.BaseAttachment {
+    /** The URL to access the attachment, The URL will be valid for 20 minutes. Only present when status is `ACCEPTED`. */
+    url?: string;
+    /** The size of the attachment in bytes */
+    sizeBytes?: number;
+    /** The processing status of the attachment. */
+    status: MavenAGI.AttachmentStatus;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export type AttachmentStatus = "PENDING" | "PROCESSING" | "ACCEPTED" | "REJECTED";
+export declare const AttachmentStatus: {
+    readonly Pending: "PENDING";
+    readonly Processing: "PROCESSING";
+    readonly Accepted: "ACCEPTED";
+    readonly Rejected: "REJECTED";
+};

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

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttachmentStatus = void 0;
+exports.AttachmentStatus = {
+    Pending: "PENDING",
+    Processing: "PROCESSING",
+    Accepted: "ACCEPTED",
+    Rejected: "REJECTED",
+};

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

@@ -0,0 +1,32 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface BaseAttachment {
+    /**
+     * The mime-type of the attachment. Supported types are:
+     * - image/jpeg
+     * - image/jpg
+     * - image/png
+     * - image/gif
+     * - image/webp
+     * - application/pdf
+     * - text/plain
+     * - text/csv
+     * - application/vnd.openxmlformats-officedocument.wordprocessingml.document
+     * - application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
+     * - application/vnd.openxmlformats-officedocument.presentationml.presentation
+     * - application/msword
+     * - application/vnd.ms-excel
+     * - application/vnd.ms-powerpoint
+     * - audio/aac
+     * - audio/mpeg
+     * - audio/mp4
+     * - audio/wav
+     * - audio/ogg
+     * - video/mp4
+     * - video/webm
+     */
+    type: string;
+    /** An optional name for the attachment. */
+    name?: string;
+}

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

@@ -27,4 +27,15 @@ export interface BaseConversationResponse {
     summary: MavenAGI.ConversationSummary;
     /** Whether the conversation user-specific data has been deleted. See `deleteConversation` for details. */
     deleted: boolean;
+    /**
+     * Whether the conversation is able to receive asynchronous messages.
+     * Only applicable if a conversation is initialized with the `ASYNC` capability. Defaults to true. Can be closed using the `PATCH` API.
+     */
+    open: boolean;
+    /**
+     * Whether the LLM is enabled for this conversation.
+     * If true, `USER` messages sent via the ask API will be sent to the LLM and a `BOT_RESPONSE` or `BOT_SUGGESTION` message will be generated.
+     * If false, `USER` messages will not be sent to the LLM.
+     */
+    llmEnabled: boolean;
 }

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

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface BotLogic {
+    items: MavenAGI.BotLogicItem[];
+}

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

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface BotLogicActionExecutedDetail extends MavenAGI.BotLogicActionReviewedDetail {
+    actionParameters: Record<string, MavenAGI.ActionExecutionParamValue>;
+    executionResult?: string;
+    executionError?: string;
+}

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface BotLogicActionItem {
+    actionsReviewed: MavenAGI.BotLogicActionReviewedDetail[];
+    actionsExecuted: MavenAGI.BotLogicActionExecutedDetail[];
+}

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface BotLogicActionReviewedDetail {
+    actionId: MavenAGI.EntityIdWithoutAgent;
+    actionName: string;
+}

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

@@ -0,0 +1,6 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as MavenAGI from "../../../index";
+export interface BotLogicFormSubmissionItem extends MavenAGI.BotLogicActionExecutedDetail {
+}