mavenagi 1.2.6 → 1.2.8

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

@@ -291,5 +291,29 @@ export declare class Knowledge {
      */
     getKnowledgeDocument(knowledgeBaseVersionReferenceId: string, knowledgeDocumentReferenceId: string, request: MavenAGI.KnowledgeDocumentGetRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<MavenAGI.KnowledgeDocumentResponse>;
     private __getKnowledgeDocument;
+    /**
+     * Update mutable knowledge document fields that can be set independently of a knowledge base version.
+     *
+     * For any changes in document content see the `createKnowledgeBaseVersion` and `createKnowledgeDocument` endpoints.
+     *
+     * The `knowledgeBaseAppId` field can be provided to update a knowledge document in a knowledge base owned by a different app.
+     * All other fields will overwrite the existing value on the knowledge document only if provided.
+     *
+     * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to patch.
+     * @param {string} knowledgeDocumentReferenceId - The reference ID of the knowledge document to patch.
+     * @param {MavenAGI.KnowledgeDocumentPatchRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.patchKnowledgeDocument("help-center", "how-it-works", {
+     *         llmInclusionStatus: "ALWAYS"
+     *     })
+     */
+    patchKnowledgeDocument(knowledgeBaseReferenceId: string, knowledgeDocumentReferenceId: string, request?: MavenAGI.KnowledgeDocumentPatchRequest, requestOptions?: Knowledge.RequestOptions): core.HttpResponsePromise<MavenAGI.KnowledgeDocumentResponse>;
+    private __patchKnowledgeDocument;
     protected _getAuthorizationHeader(): Promise<string | undefined>;
 }

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

@@ -1259,6 +1259,110 @@ class Knowledge {
             }
         });
     }
+    /**
+     * Update mutable knowledge document fields that can be set independently of a knowledge base version.
+     *
+     * For any changes in document content see the `createKnowledgeBaseVersion` and `createKnowledgeDocument` endpoints.
+     *
+     * The `knowledgeBaseAppId` field can be provided to update a knowledge document in a knowledge base owned by a different app.
+     * All other fields will overwrite the existing value on the knowledge document only if provided.
+     *
+     * @param {string} knowledgeBaseReferenceId - The reference ID of the knowledge base to patch.
+     * @param {string} knowledgeDocumentReferenceId - The reference ID of the knowledge document to patch.
+     * @param {MavenAGI.KnowledgeDocumentPatchRequest} request
+     * @param {Knowledge.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link MavenAGI.NotFoundError}
+     * @throws {@link MavenAGI.BadRequestError}
+     * @throws {@link MavenAGI.ServerError}
+     *
+     * @example
+     *     await client.knowledge.patchKnowledgeDocument("help-center", "how-it-works", {
+     *         llmInclusionStatus: "ALWAYS"
+     *     })
+     */
+    patchKnowledgeDocument(knowledgeBaseReferenceId, knowledgeDocumentReferenceId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__patchKnowledgeDocument(knowledgeBaseReferenceId, knowledgeDocumentReferenceId, request, requestOptions));
+    }
+    __patchKnowledgeDocument(knowledgeBaseReferenceId_1, knowledgeDocumentReferenceId_1) {
+        return __awaiter(this, arguments, void 0, function* (knowledgeBaseReferenceId, knowledgeDocumentReferenceId, request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            let _headers = (0, headers_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({
+                Authorization: yield this._getAuthorizationHeader(),
+                "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/knowledge/${encodeURIComponent(knowledgeBaseReferenceId)}/${encodeURIComponent(knowledgeDocumentReferenceId)}/document`),
+                method: "PATCH",
+                headers: _headers,
+                contentType: "application/merge-patch+json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.KnowledgeDocumentPatchRequest.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.KnowledgeDocumentResponse.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 PATCH /v1/knowledge/{knowledgeBaseReferenceId}/{knowledgeDocumentReferenceId}/document.");
+                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;

package/api/resources/knowledge/client/requests/KnowledgeDocumentPatchRequest.d.ts

@@ -0,0 +1,13 @@
+import * as MavenAGI from "../../../../index";
+/**
+ * @example
+ *     {
+ *         llmInclusionStatus: "ALWAYS"
+ *     }
+ */
+export interface KnowledgeDocumentPatchRequest {
+    /** The App ID of the knowledge base that contains the knowledge document to patch. If not provided the ID of the calling app will be used. */
+    knowledgeBaseAppId?: string;
+    /** Determines whether this document is sent to the LLM as part of a conversation. */
+    llmInclusionStatus?: MavenAGI.LlmInclusionStatus;
+}

package/api/resources/knowledge/client/requests/index.d.ts

@@ -2,3 +2,4 @@ export { type KnowledgeBaseGetRequest } from "./KnowledgeBaseGetRequest";
 export { type KnowledgeBasePatchRequest } from "./KnowledgeBasePatchRequest";
 export { type KnowledgeBaseVersionsListRequest } from "./KnowledgeBaseVersionsListRequest";
 export { type KnowledgeDocumentGetRequest } from "./KnowledgeDocumentGetRequest";
+export { type KnowledgeDocumentPatchRequest } from "./KnowledgeDocumentPatchRequest";

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

@@ -3,10 +3,6 @@ export interface BaseKnowledgeDocument {
     url?: string;
     /** The document language. Must be a valid ISO 639-1 language code. */
     language?: string;
-    /** The time at which this document was created. */
-    createdAt?: Date;
-    /** The time at which this document was last modified. */
-    updatedAt?: Date;
     /** The name of the author who created this document. */
     author?: string;
 }

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

@@ -58,7 +58,7 @@ export interface KnowledgeBaseResponse extends MavenAGI.KnowledgeBaseProperties
     /** The tags of the knowledge base. */
     tags: Set<string>;
     /** Determines whether documents in the knowledge base are sent to the LLM as part of a conversation. */
-    llmInclusionStatus?: MavenAGI.LlmInclusionStatus;
+    llmInclusionStatus: MavenAGI.LlmInclusionStatus;
     /** How often the knowledge base should be refreshed. */
     refreshFrequency: MavenAGI.KnowledgeBaseRefreshFrequency;
     /**

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

@@ -10,7 +10,9 @@ import * as MavenAGI from "../../../index";
  *             agentId: "support"
  *         },
  *         type: MavenAGI.KnowledgeBaseVersionType.Full,
- *         status: MavenAGI.KnowledgeBaseVersionStatus.InProgress
+ *         status: MavenAGI.KnowledgeBaseVersionStatus.InProgress,
+ *         createdAt: new Date("2024-01-01T00:00:00.000Z"),
+ *         updatedAt: new Date("2024-02-02T00:00:00.000Z")
  *     }
  */
 export interface KnowledgeBaseVersion extends MavenAGI.KnowledgeBaseVersionRequest {
@@ -20,4 +22,8 @@ export interface KnowledgeBaseVersion extends MavenAGI.KnowledgeBaseVersionReque
     status: MavenAGI.KnowledgeBaseVersionStatus;
     /** A user-facing error message that provides more details about a version failure. */
     errorMessage?: string;
+    /** The date and time the knowledge base version was created. */
+    createdAt: Date;
+    /** The date and time the knowledge base version was last updated. */
+    updatedAt: Date;
 }

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

@@ -17,6 +17,8 @@ export interface KnowledgeDocumentFilter {
     search?: string;
     /** Filter by title */
     title?: string;
+    /** Filter by url */
+    url?: string;
     /** Filter knowledge documents created on or after this timestamp */
     createdAfter?: Date;
     /** Filter knowledge documents created on or before this timestamp */
@@ -28,4 +30,6 @@ export interface KnowledgeDocumentFilter {
      * If not provided all active knowledge base versions within the agent will be searched.
      */
     knowledgeBaseVersionId?: MavenAGI.EntityIdWithoutAgent;
+    /** Filter by the LLM inclusion status */
+    llmInclusionStatus?: MavenAGI.LlmInclusionStatus[];
 }

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

@@ -23,11 +23,18 @@ export interface KnowledgeDocumentRequest extends MavenAGI.BaseKnowledgeDocument
     knowledgeDocumentId: MavenAGI.EntityIdBase;
     /** ID that uniquely identifies which knowledge base version to create the document in. If not provided will use the most recent version of the knowledge base. */
     versionId?: MavenAGI.EntityIdWithoutAgent;
+    /** Type of knowledge document content, if content is provided. This does not need to be set if content is not provided */
     contentType: MavenAGI.KnowledgeDocumentContentType;
     /** The title of the document. Will be shown as part of answers. */
     title: string;
-    /** The content of the document. Not shown directly to users. May be provided in HTML or markdown. HTML will be converted to markdown automatically. Images are not currently supported and will be ignored. */
-    content: string;
+    /** ID of the asset associated with this document. Either this or content is required, but not both */
+    assetId?: MavenAGI.EntityIdBase;
+    /** The content of the document. Not shown directly to users. May be provided in HTML or markdown. HTML will be converted to markdown automatically. Images are not currently supported and will be ignored. Either this or assetId is required, but not both */
+    content?: string;
     /** Metadata for the knowledge document. */
     metadata?: Record<string, string>;
+    /** The time at which this document was created. */
+    createdAt?: Date;
+    /** The time at which this document was last modified. */
+    updatedAt?: Date;
 }

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

@@ -20,12 +20,19 @@ import * as MavenAGI from "../../../index";
  *         title: "Getting started",
  *         metadata: {
  *             "category": "getting-started"
- *         }
+ *         },
+ *         createdAt: new Date("2024-01-01T00:00:00.000Z"),
+ *         updatedAt: new Date("2024-02-02T00:00:00.000Z"),
+ *         llmInclusionStatus: MavenAGI.LlmInclusionStatus.WhenRelevant
  *     }
  */
 export interface KnowledgeDocumentResponse extends MavenAGI.KnowledgeDocumentSearchResponse {
+    /** The current processing status of the knowledge document */
+    processingStatus?: MavenAGI.KnowledgeDocumentStatus;
     /** The content of the document in markdown format. Not shown directly to users. */
     content: string;
+    /** If the document is associated with an asset, this will contain the asset metadata */
+    asset?: MavenAGI.AttachmentResponse;
     /** Metadata for the knowledge document. */
     metadata: Record<string, string>;
 }

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

@@ -1,4 +1,28 @@
 import * as MavenAGI from "../../../index";
+/**
+ * @example
+ *     {
+ *         knowledgeDocumentId: {
+ *             referenceId: "how-it-works",
+ *             appId: "help-center",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: MavenAGI.EntityType.KnowledgeDocument
+ *         },
+ *         knowledgeBaseVersionId: {
+ *             referenceId: "version-1",
+ *             appId: "help-center",
+ *             organizationId: "acme",
+ *             agentId: "support",
+ *             type: MavenAGI.EntityType.KnowledgeBaseVersion
+ *         },
+ *         title: "How it works",
+ *         llmInclusionStatus: MavenAGI.LlmInclusionStatus.WhenRelevant,
+ *         url: "https://help-center.acme.com/how-it-works",
+ *         createdAt: new Date("2024-01-01T00:00:00.000Z"),
+ *         updatedAt: new Date("2024-02-02T00:00:00.000Z")
+ *     }
+ */
 export interface KnowledgeDocumentSearchResponse extends MavenAGI.BaseKnowledgeDocument {
     /** ID that uniquely identifies this knowledge document within its knowledge base */
     knowledgeDocumentId: MavenAGI.EntityId;
@@ -9,4 +33,10 @@ export interface KnowledgeDocumentSearchResponse extends MavenAGI.BaseKnowledgeD
     knowledgeBaseVersionId?: MavenAGI.EntityId;
     /** The title of the document. Will be shown as part of answers. May be missing on legacy documents. */
     title?: string;
+    /** Whether the document is included in the agent's knowledge. */
+    llmInclusionStatus: MavenAGI.LlmInclusionStatus;
+    /** The time at which this document was created. */
+    createdAt: Date;
+    /** The time at which this document was last modified. */
+    updatedAt: Date;
 }

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

@@ -0,0 +1,6 @@
+/** The current processing status of the knowledge document */
+export declare const KnowledgeDocumentStatus: {
+    readonly Succeeded: "SUCCEEDED";
+    readonly InProgress: "IN_PROGRESS";
+};
+export type KnowledgeDocumentStatus = (typeof KnowledgeDocumentStatus)[keyof typeof KnowledgeDocumentStatus];

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

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeDocumentStatus = void 0;
+/** The current processing status of the knowledge document */
+exports.KnowledgeDocumentStatus = {
+    Succeeded: "SUCCEEDED",
+    InProgress: "IN_PROGRESS",
+};

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

@@ -14,6 +14,7 @@ export * from "./KnowledgeDocumentContentType";
 export * from "./KnowledgeDeleteRequest";
 export * from "./KnowledgeDocumentRequest";
 export * from "./KnowledgeDocumentResponse";
+export * from "./KnowledgeDocumentStatus";
 export * from "./KnowledgeBaseField";
 export * from "./KnowledgeDocumentField";
 export * from "./KnowledgeBaseFilter";

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

@@ -30,6 +30,7 @@ __exportStar(require("./KnowledgeDocumentContentType"), exports);
 __exportStar(require("./KnowledgeDeleteRequest"), exports);
 __exportStar(require("./KnowledgeDocumentRequest"), exports);
 __exportStar(require("./KnowledgeDocumentResponse"), exports);
+__exportStar(require("./KnowledgeDocumentStatus"), exports);
 __exportStar(require("./KnowledgeBaseField"), exports);
 __exportStar(require("./KnowledgeDocumentField"), exports);
 __exportStar(require("./KnowledgeBaseFilter"), exports);

package/api/resources/users/types/AgentUserFilter.d.ts

@@ -6,6 +6,11 @@ export interface AgentUserFilter {
     search?: string;
     /** Filter by identifiers */
     identifiers?: string[];
+    /**
+     * Full-text search query for matching agent users by display name.
+     * When you search with this parameter, you're performing a full-text search across the user display names.
+     */
+    displayName?: string;
     /**
      * Filter by anonymous users. When true, only anonymous users are returned.
      * When false, only non-anonymous users are returned. An anonymous user is one without any identifiers or name data.

package/core/exports.d.ts

@@ -0,0 +1 @@
+export * from "./file/exports";

package/{api/resources/agentCapabilities/index.js → core/exports.js}

@@ -14,5 +14,4 @@ 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);
+__exportStar(require("./file/exports"), exports);

package/core/file/exports.d.ts

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

package/core/file/file.d.ts

@@ -0,0 +1,5 @@
+import { Uploadable } from "./types";
+export declare function toBinaryUploadRequest(file: Uploadable): Promise<{
+    body: Uploadable.FileLike;
+    headers?: Record<string, string>;
+}>;

package/core/file/file.js

@@ -0,0 +1,203 @@
+"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 __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.toBinaryUploadRequest = toBinaryUploadRequest;
+function toBinaryUploadRequest(file) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { data, filename, contentLength, contentType } = yield getFileWithMetadata(file);
+        const request = {
+            body: data,
+            headers: {},
+        };
+        if (filename) {
+            request.headers["Content-Disposition"] = `attachment; filename="${filename}"`;
+        }
+        if (contentType) {
+            request.headers["Content-Type"] = contentType;
+        }
+        if (contentLength != null) {
+            request.headers["Content-Length"] = contentLength.toString();
+        }
+        return request;
+    });
+}
+function getFileWithMetadata(file) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e;
+        if (isFileLike(file)) {
+            return getFileWithMetadata({
+                data: file,
+            });
+        }
+        if ("path" in file) {
+            const fs = yield Promise.resolve().then(() => __importStar(require("fs")));
+            if (!fs || !fs.createReadStream) {
+                throw new Error("File path uploads are not supported in this environment.");
+            }
+            const data = fs.createReadStream(file.path);
+            const contentLength = (_a = file.contentLength) !== null && _a !== void 0 ? _a : (yield tryGetFileSizeFromPath(file.path));
+            const filename = (_b = file.filename) !== null && _b !== void 0 ? _b : getNameFromPath(file.path);
+            return {
+                data,
+                filename,
+                contentType: file.contentType,
+                contentLength,
+            };
+        }
+        if ("data" in file) {
+            const data = file.data;
+            const contentLength = (_c = file.contentLength) !== null && _c !== void 0 ? _c : (yield tryGetContentLengthFromFileLike(data));
+            const filename = (_d = file.filename) !== null && _d !== void 0 ? _d : tryGetNameFromFileLike(data);
+            return {
+                data,
+                filename,
+                contentType: (_e = file.contentType) !== null && _e !== void 0 ? _e : tryGetContentTypeFromFileLike(data),
+                contentLength,
+            };
+        }
+        throw new Error(`Invalid FileUpload of type ${typeof file}: ${JSON.stringify(file)}`);
+    });
+}
+function isFileLike(value) {
+    return (isBuffer(value) ||
+        isArrayBufferView(value) ||
+        isArrayBuffer(value) ||
+        isUint8Array(value) ||
+        isBlob(value) ||
+        isFile(value) ||
+        isStreamLike(value) ||
+        isReadableStream(value));
+}
+function tryGetFileSizeFromPath(path) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const fs = yield Promise.resolve().then(() => __importStar(require("fs")));
+            if (!fs || !fs.promises || !fs.promises.stat) {
+                return undefined;
+            }
+            const fileStat = yield fs.promises.stat(path);
+            return fileStat.size;
+        }
+        catch (fallbackError) {
+            return undefined;
+        }
+    });
+}
+function tryGetNameFromFileLike(data) {
+    if (isNamedValue(data)) {
+        return data.name;
+    }
+    if (isPathedValue(data)) {
+        return getNameFromPath(data.path.toString());
+    }
+    return undefined;
+}
+function tryGetContentLengthFromFileLike(data) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (isBuffer(data)) {
+            return data.length;
+        }
+        if (isArrayBufferView(data)) {
+            return data.byteLength;
+        }
+        if (isArrayBuffer(data)) {
+            return data.byteLength;
+        }
+        if (isBlob(data)) {
+            return data.size;
+        }
+        if (isFile(data)) {
+            return data.size;
+        }
+        if (isPathedValue(data)) {
+            return yield tryGetFileSizeFromPath(data.path.toString());
+        }
+        return undefined;
+    });
+}
+function tryGetContentTypeFromFileLike(data) {
+    if (isBlob(data)) {
+        return data.type;
+    }
+    if (isFile(data)) {
+        return data.type;
+    }
+    return undefined;
+}
+function getNameFromPath(path) {
+    const lastForwardSlash = path.lastIndexOf("/");
+    const lastBackSlash = path.lastIndexOf("\\");
+    const lastSlashIndex = Math.max(lastForwardSlash, lastBackSlash);
+    return lastSlashIndex >= 0 ? path.substring(lastSlashIndex + 1) : path;
+}
+function isNamedValue(value) {
+    return typeof value === "object" && value != null && "name" in value;
+}
+function isPathedValue(value) {
+    return typeof value === "object" && value != null && "path" in value;
+}
+function isStreamLike(value) {
+    return typeof value === "object" && value != null && ("read" in value || "pipe" in value);
+}
+function isReadableStream(value) {
+    return typeof value === "object" && value != null && "getReader" in value;
+}
+function isBuffer(value) {
+    return typeof Buffer !== "undefined" && Buffer.isBuffer && Buffer.isBuffer(value);
+}
+function isArrayBufferView(value) {
+    return typeof ArrayBuffer !== "undefined" && ArrayBuffer.isView(value);
+}
+function isArrayBuffer(value) {
+    return typeof ArrayBuffer !== "undefined" && value instanceof ArrayBuffer;
+}
+function isUint8Array(value) {
+    return typeof Uint8Array !== "undefined" && value instanceof Uint8Array;
+}
+function isBlob(value) {
+    return typeof Blob !== "undefined" && value instanceof Blob;
+}
+function isFile(value) {
+    return typeof File !== "undefined" && value instanceof File;
+}

package/{dist/serialization/resources/agentCapabilities → core/file}/index.d.ts

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

package/{dist/serialization/resources/agentCapabilities → core/file}/index.js

@@ -14,4 +14,5 @@ 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("./file"), exports);
 __exportStar(require("./types"), exports);