@llamaindex/llama-cloud 0.14.1

package/resources/beta/directories/files.d.ts

@@ -0,0 +1,394 @@
+import { APIResource } from "../../../core/resource.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { PagePromise, PaginatedClassifyJobs, type PaginatedClassifyJobsParams } from "../../../core/pagination.js";
+import { type Uploadable } from "../../../core/uploads.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+export declare class Files extends APIResource {
+    /**
+     * Update file metadata within the specified directory.
+     *
+     * Supports moving files to a different directory by setting directory_id.
+     *
+     * Note: This endpoint uses directory_file_id (the internal ID). If you're trying
+     * to update a file by its unique_id, use the list endpoint with a filter to find
+     * the directory_file_id first.
+     */
+    update(directoryFileID: string, params: FileUpdateParams, options?: RequestOptions): APIPromise<FileUpdateResponse>;
+    /**
+     * List all files within the specified directory with optional filtering and
+     * pagination.
+     */
+    list(directoryID: string, query?: FileListParams | null | undefined, options?: RequestOptions): PagePromise<FileListResponsesPaginatedClassifyJobs, FileListResponse>;
+    /**
+     * Delete a file from the specified directory.
+     *
+     * Note: This endpoint uses directory_file_id (the internal ID). If you're trying
+     * to delete a file by its unique_id, use the list endpoint with a filter to find
+     * the directory_file_id first.
+     */
+    delete(directoryFileID: string, params: FileDeleteParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Create a new file within the specified directory.
+     *
+     * The directory must exist and belong to the project passed in. The file_id must
+     * be provided and exist in the project.
+     */
+    add(directoryID: string, params: FileAddParams, options?: RequestOptions): APIPromise<FileAddResponse>;
+    /**
+     * Get a file by its directory_file_id within the specified directory. If you're
+     * trying to get a file by its unique_id, use the list endpoint with a filter
+     * instead.
+     */
+    get(directoryFileID: string, params: FileGetParams, options?: RequestOptions): APIPromise<FileGetResponse>;
+    /**
+     * Upload a file directly to a directory.
+     *
+     * Uploads a file and creates a directory file entry in a single operation. If
+     * unique_id or display_name are not provided, they will be derived from the file
+     * metadata.
+     */
+    upload(directoryID: string, params: FileUploadParams, options?: RequestOptions): APIPromise<FileUploadResponse>;
+}
+export type FileListResponsesPaginatedClassifyJobs = PaginatedClassifyJobs<FileListResponse>;
+/**
+ * API response schema for a directory file.
+ */
+export interface FileUpdateResponse {
+    /**
+     * Unique identifier for the directory file.
+     */
+    id: string;
+    /**
+     * Directory the file belongs to.
+     */
+    directory_id: string;
+    /**
+     * Display name for the file.
+     */
+    display_name: string;
+    /**
+     * Project the directory file belongs to.
+     */
+    project_id: string;
+    /**
+     * Unique identifier for the file in the directory
+     */
+    unique_id: string;
+    /**
+     * Creation datetime
+     */
+    created_at?: string | null;
+    /**
+     * Optional data source credential associated with the file.
+     */
+    data_source_id?: string | null;
+    /**
+     * Soft delete marker when the file is removed upstream or by user action.
+     */
+    deleted_at?: string | null;
+    /**
+     * File ID for the storage location.
+     */
+    file_id?: string | null;
+    /**
+     * Update datetime
+     */
+    updated_at?: string | null;
+}
+/**
+ * API response schema for a directory file.
+ */
+export interface FileListResponse {
+    /**
+     * Unique identifier for the directory file.
+     */
+    id: string;
+    /**
+     * Directory the file belongs to.
+     */
+    directory_id: string;
+    /**
+     * Display name for the file.
+     */
+    display_name: string;
+    /**
+     * Project the directory file belongs to.
+     */
+    project_id: string;
+    /**
+     * Unique identifier for the file in the directory
+     */
+    unique_id: string;
+    /**
+     * Creation datetime
+     */
+    created_at?: string | null;
+    /**
+     * Optional data source credential associated with the file.
+     */
+    data_source_id?: string | null;
+    /**
+     * Soft delete marker when the file is removed upstream or by user action.
+     */
+    deleted_at?: string | null;
+    /**
+     * File ID for the storage location.
+     */
+    file_id?: string | null;
+    /**
+     * Update datetime
+     */
+    updated_at?: string | null;
+}
+/**
+ * API response schema for a directory file.
+ */
+export interface FileAddResponse {
+    /**
+     * Unique identifier for the directory file.
+     */
+    id: string;
+    /**
+     * Directory the file belongs to.
+     */
+    directory_id: string;
+    /**
+     * Display name for the file.
+     */
+    display_name: string;
+    /**
+     * Project the directory file belongs to.
+     */
+    project_id: string;
+    /**
+     * Unique identifier for the file in the directory
+     */
+    unique_id: string;
+    /**
+     * Creation datetime
+     */
+    created_at?: string | null;
+    /**
+     * Optional data source credential associated with the file.
+     */
+    data_source_id?: string | null;
+    /**
+     * Soft delete marker when the file is removed upstream or by user action.
+     */
+    deleted_at?: string | null;
+    /**
+     * File ID for the storage location.
+     */
+    file_id?: string | null;
+    /**
+     * Update datetime
+     */
+    updated_at?: string | null;
+}
+/**
+ * API response schema for a directory file.
+ */
+export interface FileGetResponse {
+    /**
+     * Unique identifier for the directory file.
+     */
+    id: string;
+    /**
+     * Directory the file belongs to.
+     */
+    directory_id: string;
+    /**
+     * Display name for the file.
+     */
+    display_name: string;
+    /**
+     * Project the directory file belongs to.
+     */
+    project_id: string;
+    /**
+     * Unique identifier for the file in the directory
+     */
+    unique_id: string;
+    /**
+     * Creation datetime
+     */
+    created_at?: string | null;
+    /**
+     * Optional data source credential associated with the file.
+     */
+    data_source_id?: string | null;
+    /**
+     * Soft delete marker when the file is removed upstream or by user action.
+     */
+    deleted_at?: string | null;
+    /**
+     * File ID for the storage location.
+     */
+    file_id?: string | null;
+    /**
+     * Update datetime
+     */
+    updated_at?: string | null;
+}
+/**
+ * API response schema for a directory file.
+ */
+export interface FileUploadResponse {
+    /**
+     * Unique identifier for the directory file.
+     */
+    id: string;
+    /**
+     * Directory the file belongs to.
+     */
+    directory_id: string;
+    /**
+     * Display name for the file.
+     */
+    display_name: string;
+    /**
+     * Project the directory file belongs to.
+     */
+    project_id: string;
+    /**
+     * Unique identifier for the file in the directory
+     */
+    unique_id: string;
+    /**
+     * Creation datetime
+     */
+    created_at?: string | null;
+    /**
+     * Optional data source credential associated with the file.
+     */
+    data_source_id?: string | null;
+    /**
+     * Soft delete marker when the file is removed upstream or by user action.
+     */
+    deleted_at?: string | null;
+    /**
+     * File ID for the storage location.
+     */
+    file_id?: string | null;
+    /**
+     * Update datetime
+     */
+    updated_at?: string | null;
+}
+export interface FileUpdateParams {
+    /**
+     * Path param
+     */
+    path_directory_id: string;
+    /**
+     * Query param
+     */
+    organization_id?: string | null;
+    /**
+     * Query param
+     */
+    project_id?: string | null;
+    /**
+     * Body param: Move file to a different directory.
+     */
+    body_directory_id?: string | null;
+    /**
+     * Body param: Updated display name.
+     */
+    display_name?: string | null;
+    /**
+     * Body param: Updated unique identifier.
+     */
+    unique_id?: string | null;
+}
+export interface FileListParams extends PaginatedClassifyJobsParams {
+    display_name?: string | null;
+    display_name_contains?: string | null;
+    file_id?: string | null;
+    include_deleted?: boolean;
+    organization_id?: string | null;
+    project_id?: string | null;
+    unique_id?: string | null;
+}
+export interface FileDeleteParams {
+    /**
+     * Path param
+     */
+    directory_id: string;
+    /**
+     * Query param
+     */
+    organization_id?: string | null;
+    /**
+     * Query param
+     */
+    project_id?: string | null;
+}
+export interface FileAddParams {
+    /**
+     * Body param: File ID for the storage location (required).
+     */
+    file_id: string;
+    /**
+     * Query param
+     */
+    organization_id?: string | null;
+    /**
+     * Query param
+     */
+    project_id?: string | null;
+    /**
+     * Body param: Display name for the file. If not provided, will use the file's
+     * name.
+     */
+    display_name?: string | null;
+    /**
+     * Body param: Unique identifier for the file in the directory. If not provided,
+     * will use the file's external_file_id or name.
+     */
+    unique_id?: string | null;
+}
+export interface FileGetParams {
+    /**
+     * Path param
+     */
+    directory_id: string;
+    /**
+     * Query param
+     */
+    organization_id?: string | null;
+    /**
+     * Query param
+     */
+    project_id?: string | null;
+}
+export interface FileUploadParams {
+    /**
+     * Body param
+     */
+    upload_file: Uploadable;
+    /**
+     * Query param
+     */
+    organization_id?: string | null;
+    /**
+     * Query param
+     */
+    project_id?: string | null;
+    /**
+     * Body param
+     */
+    display_name?: string | null;
+    /**
+     * Body param
+     */
+    external_file_id?: string | null;
+    /**
+     * Body param
+     */
+    unique_id?: string | null;
+}
+export declare namespace Files {
+    export { type FileUpdateResponse as FileUpdateResponse, type FileListResponse as FileListResponse, type FileAddResponse as FileAddResponse, type FileGetResponse as FileGetResponse, type FileUploadResponse as FileUploadResponse, type FileListResponsesPaginatedClassifyJobs as FileListResponsesPaginatedClassifyJobs, type FileUpdateParams as FileUpdateParams, type FileListParams as FileListParams, type FileDeleteParams as FileDeleteParams, type FileAddParams as FileAddParams, type FileGetParams as FileGetParams, type FileUploadParams as FileUploadParams, };
+}
+//# sourceMappingURL=files.d.ts.map

package/resources/beta/directories/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/resources/beta/directories/files.ts"],"names":[],"mappings":"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"}

package/resources/beta/directories/files.js

@@ -0,0 +1,89 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Files = void 0;
+const resource_1 = require("../../../core/resource.js");
+const pagination_1 = require("../../../core/pagination.js");
+const headers_1 = require("../../../internal/headers.js");
+const uploads_1 = require("../../../internal/uploads.js");
+const path_1 = require("../../../internal/utils/path.js");
+class Files extends resource_1.APIResource {
+    /**
+     * Update file metadata within the specified directory.
+     *
+     * Supports moving files to a different directory by setting directory_id.
+     *
+     * Note: This endpoint uses directory_file_id (the internal ID). If you're trying
+     * to update a file by its unique_id, use the list endpoint with a filter to find
+     * the directory_file_id first.
+     */
+    update(directoryFileID, params, options) {
+        const { path_directory_id, organization_id, project_id, ...body } = params;
+        return this._client.patch((0, path_1.path) `/api/v1/beta/directories/${path_directory_id}/files/${directoryFileID}`, {
+            query: { organization_id, project_id },
+            body,
+            ...options,
+        });
+    }
+    /**
+     * List all files within the specified directory with optional filtering and
+     * pagination.
+     */
+    list(directoryID, query = {}, options) {
+        return this._client.getAPIList((0, path_1.path) `/api/v1/beta/directories/${directoryID}/files`, (pagination_1.PaginatedClassifyJobs), { query, ...options });
+    }
+    /**
+     * Delete a file from the specified directory.
+     *
+     * Note: This endpoint uses directory_file_id (the internal ID). If you're trying
+     * to delete a file by its unique_id, use the list endpoint with a filter to find
+     * the directory_file_id first.
+     */
+    delete(directoryFileID, params, options) {
+        const { directory_id, organization_id, project_id } = params;
+        return this._client.delete((0, path_1.path) `/api/v1/beta/directories/${directory_id}/files/${directoryFileID}`, {
+            query: { organization_id, project_id },
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Create a new file within the specified directory.
+     *
+     * The directory must exist and belong to the project passed in. The file_id must
+     * be provided and exist in the project.
+     */
+    add(directoryID, params, options) {
+        const { organization_id, project_id, ...body } = params;
+        return this._client.post((0, path_1.path) `/api/v1/beta/directories/${directoryID}/files`, {
+            query: { organization_id, project_id },
+            body,
+            ...options,
+        });
+    }
+    /**
+     * Get a file by its directory_file_id within the specified directory. If you're
+     * trying to get a file by its unique_id, use the list endpoint with a filter
+     * instead.
+     */
+    get(directoryFileID, params, options) {
+        const { directory_id, ...query } = params;
+        return this._client.get((0, path_1.path) `/api/v1/beta/directories/${directory_id}/files/${directoryFileID}`, {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Upload a file directly to a directory.
+     *
+     * Uploads a file and creates a directory file entry in a single operation. If
+     * unique_id or display_name are not provided, they will be derived from the file
+     * metadata.
+     */
+    upload(directoryID, params, options) {
+        const { organization_id, project_id, ...body } = params;
+        return this._client.post((0, path_1.path) `/api/v1/beta/directories/${directoryID}/files/upload`, (0, uploads_1.multipartFormRequestOptions)({ query: { organization_id, project_id }, body, ...options }, this._client));
+    }
+}
+exports.Files = Files;
+//# sourceMappingURL=files.js.map

package/resources/beta/directories/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/resources/beta/directories/files.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAErD,4DAIkC;AAElC,0DAAyD;AAEzD,0DAAwE;AACxE,0DAAoD;AAEpD,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;OAQG;IACH,MAAM,CACJ,eAAuB,EACvB,MAAwB,EACxB,OAAwB;QAExB,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,4BAA4B,iBAAiB,UAAU,eAAe,EAAE,EAAE;YACtG,KAAK,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE;YACtC,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,WAAmB,EACnB,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,4BAA4B,WAAW,QAAQ,EACnD,CAAA,kCAAuC,CAAA,EACvC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,eAAuB,EAAE,MAAwB,EAAE,OAAwB;QAChF,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,4BAA4B,YAAY,UAAU,eAAe,EAAE,EAAE;YAClG,KAAK,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE;YACtC,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,WAAmB,EAAE,MAAqB,EAAE,OAAwB;QACtE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,4BAA4B,WAAW,QAAQ,EAAE;YAC5E,KAAK,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE;YACtC,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,eAAuB,EAAE,MAAqB,EAAE,OAAwB;QAC1E,MAAM,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,4BAA4B,YAAY,UAAU,eAAe,EAAE,EAAE;YAC/F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CACJ,WAAmB,EACnB,MAAwB,EACxB,OAAwB;QAExB,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,IAAA,WAAI,EAAA,4BAA4B,WAAW,eAAe,EAC1D,IAAA,qCAA2B,EAAC,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CACxG,CAAC;IACJ,CAAC;CACF;AArGD,sBAqGC"}

package/resources/beta/directories/files.mjs

@@ -0,0 +1,85 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import { PaginatedClassifyJobs, } from "../../../core/pagination.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+import { multipartFormRequestOptions } from "../../../internal/uploads.mjs";
+import { path } from "../../../internal/utils/path.mjs";
+export class Files extends APIResource {
+    /**
+     * Update file metadata within the specified directory.
+     *
+     * Supports moving files to a different directory by setting directory_id.
+     *
+     * Note: This endpoint uses directory_file_id (the internal ID). If you're trying
+     * to update a file by its unique_id, use the list endpoint with a filter to find
+     * the directory_file_id first.
+     */
+    update(directoryFileID, params, options) {
+        const { path_directory_id, organization_id, project_id, ...body } = params;
+        return this._client.patch(path `/api/v1/beta/directories/${path_directory_id}/files/${directoryFileID}`, {
+            query: { organization_id, project_id },
+            body,
+            ...options,
+        });
+    }
+    /**
+     * List all files within the specified directory with optional filtering and
+     * pagination.
+     */
+    list(directoryID, query = {}, options) {
+        return this._client.getAPIList(path `/api/v1/beta/directories/${directoryID}/files`, (PaginatedClassifyJobs), { query, ...options });
+    }
+    /**
+     * Delete a file from the specified directory.
+     *
+     * Note: This endpoint uses directory_file_id (the internal ID). If you're trying
+     * to delete a file by its unique_id, use the list endpoint with a filter to find
+     * the directory_file_id first.
+     */
+    delete(directoryFileID, params, options) {
+        const { directory_id, organization_id, project_id } = params;
+        return this._client.delete(path `/api/v1/beta/directories/${directory_id}/files/${directoryFileID}`, {
+            query: { organization_id, project_id },
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Create a new file within the specified directory.
+     *
+     * The directory must exist and belong to the project passed in. The file_id must
+     * be provided and exist in the project.
+     */
+    add(directoryID, params, options) {
+        const { organization_id, project_id, ...body } = params;
+        return this._client.post(path `/api/v1/beta/directories/${directoryID}/files`, {
+            query: { organization_id, project_id },
+            body,
+            ...options,
+        });
+    }
+    /**
+     * Get a file by its directory_file_id within the specified directory. If you're
+     * trying to get a file by its unique_id, use the list endpoint with a filter
+     * instead.
+     */
+    get(directoryFileID, params, options) {
+        const { directory_id, ...query } = params;
+        return this._client.get(path `/api/v1/beta/directories/${directory_id}/files/${directoryFileID}`, {
+            query,
+            ...options,
+        });
+    }
+    /**
+     * Upload a file directly to a directory.
+     *
+     * Uploads a file and creates a directory file entry in a single operation. If
+     * unique_id or display_name are not provided, they will be derived from the file
+     * metadata.
+     */
+    upload(directoryID, params, options) {
+        const { organization_id, project_id, ...body } = params;
+        return this._client.post(path `/api/v1/beta/directories/${directoryID}/files/upload`, multipartFormRequestOptions({ query: { organization_id, project_id }, body, ...options }, this._client));
+    }
+}
+//# sourceMappingURL=files.mjs.map

package/resources/beta/directories/files.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../../../src/resources/beta/directories/files.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAEL,qBAAqB,GAEtB;OAEM,EAAE,YAAY,EAAE;OAEhB,EAAE,2BAA2B,EAAE;OAC/B,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;;;OAQG;IACH,MAAM,CACJ,eAAuB,EACvB,MAAwB,EACxB,OAAwB;QAExB,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,4BAA4B,iBAAiB,UAAU,eAAe,EAAE,EAAE;YACtG,KAAK,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE;YACtC,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,WAAmB,EACnB,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,4BAA4B,WAAW,QAAQ,EACnD,CAAA,qBAAuC,CAAA,EACvC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,eAAuB,EAAE,MAAwB,EAAE,OAAwB;QAChF,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,4BAA4B,YAAY,UAAU,eAAe,EAAE,EAAE;YAClG,KAAK,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE;YACtC,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,WAAmB,EAAE,MAAqB,EAAE,OAAwB;QACtE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,4BAA4B,WAAW,QAAQ,EAAE;YAC5E,KAAK,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE;YACtC,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,eAAuB,EAAE,MAAqB,EAAE,OAAwB;QAC1E,MAAM,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,4BAA4B,YAAY,UAAU,eAAe,EAAE,EAAE;YAC/F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CACJ,WAAmB,EACnB,MAAwB,EACxB,OAAwB;QAExB,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,IAAI,CAAA,4BAA4B,WAAW,eAAe,EAC1D,2BAA2B,CAAC,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CACxG,CAAC;IACJ,CAAC;CACF"}

package/resources/beta/directories/index.d.mts

@@ -0,0 +1,3 @@
+export { Directories, type DirectoryCreateResponse, type DirectoryUpdateResponse, type DirectoryListResponse, type DirectoryGetResponse, type DirectoryCreateParams, type DirectoryUpdateParams, type DirectoryListParams, type DirectoryDeleteParams, type DirectoryGetParams, type DirectoryListResponsesPaginatedClassifyJobs, } from "./directories.mjs";
+export { Files, type FileUpdateResponse, type FileListResponse, type FileAddResponse, type FileGetResponse, type FileUploadResponse, type FileUpdateParams, type FileListParams, type FileDeleteParams, type FileAddParams, type FileGetParams, type FileUploadParams, type FileListResponsesPaginatedClassifyJobs, } from "./files.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/beta/directories/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/resources/beta/directories/index.ts"],"names":[],"mappings":"OAEO,EACL,WAAW,EACX,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,2CAA2C,GACjD;OACM,EACL,KAAK,EACL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,sCAAsC,GAC5C"}

package/resources/beta/directories/index.d.ts

@@ -0,0 +1,3 @@
+export { Directories, type DirectoryCreateResponse, type DirectoryUpdateResponse, type DirectoryListResponse, type DirectoryGetResponse, type DirectoryCreateParams, type DirectoryUpdateParams, type DirectoryListParams, type DirectoryDeleteParams, type DirectoryGetParams, type DirectoryListResponsesPaginatedClassifyJobs, } from "./directories.js";
+export { Files, type FileUpdateResponse, type FileListResponse, type FileAddResponse, type FileGetResponse, type FileUploadResponse, type FileUpdateParams, type FileListParams, type FileDeleteParams, type FileAddParams, type FileGetParams, type FileUploadParams, type FileListResponsesPaginatedClassifyJobs, } from "./files.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/beta/directories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/beta/directories/index.ts"],"names":[],"mappings":"OAEO,EACL,WAAW,EACX,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,2CAA2C,GACjD;OACM,EACL,KAAK,EACL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,sCAAsC,GAC5C"}

package/resources/beta/directories/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Files = exports.Directories = void 0;
+var directories_1 = require("./directories.js");
+Object.defineProperty(exports, "Directories", { enumerable: true, get: function () { return directories_1.Directories; } });
+var files_1 = require("./files.js");
+Object.defineProperty(exports, "Files", { enumerable: true, get: function () { return files_1.Files; } });
+//# sourceMappingURL=index.js.map

package/resources/beta/directories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/beta/directories/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,gDAYuB;AAXrB,0GAAA,WAAW,OAAA;AAYb,oCAciB;AAbf,8FAAA,KAAK,OAAA"}

package/resources/beta/directories/index.mjs

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Directories, } from "./directories.mjs";
+export { Files, } from "./files.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/beta/directories/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/resources/beta/directories/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,WAAW,GAWZ;OACM,EACL,KAAK,GAaN"}

package/resources/beta/directories.d.mts

@@ -0,0 +1,2 @@
+export * from "./directories/index.mjs";
+//# sourceMappingURL=directories.d.mts.map

package/resources/beta/directories.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directories.d.mts","sourceRoot":"","sources":["../../src/resources/beta/directories.ts"],"names":[],"mappings":""}

package/resources/beta/directories.d.ts

@@ -0,0 +1,2 @@
+export * from "./directories/index.js";
+//# sourceMappingURL=directories.d.ts.map

package/resources/beta/directories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directories.d.ts","sourceRoot":"","sources":["../../src/resources/beta/directories.ts"],"names":[],"mappings":""}

package/resources/beta/directories.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../../internal/tslib.js");
+tslib_1.__exportStar(require("./directories/index.js"), exports);
+//# sourceMappingURL=directories.js.map

package/resources/beta/directories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directories.js","sourceRoot":"","sources":["../../src/resources/beta/directories.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,iEAAoC"}

package/resources/beta/directories.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./directories/index.mjs";
+//# sourceMappingURL=directories.mjs.map

package/resources/beta/directories.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"directories.mjs","sourceRoot":"","sources":["../../src/resources/beta/directories.ts"],"names":[],"mappings":"AAAA,sFAAsF"}