@letta-ai/letta-client 1.0.0-alpha.6 → 1.0.0-alpha.7

package/resources/folders/files.d.ts

@@ -0,0 +1,216 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { type Uploadable } from "../../core/uploads.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Files extends APIResource {
+    /**
+     * List paginated files associated with a data folder.
+     */
+    list(folderID: string, query?: FileListParams | null | undefined, options?: RequestOptions): APIPromise<FileListResponse>;
+    /**
+     * Delete a file from a folder.
+     */
+    delete(fileID: string, params: FileDeleteParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Upload a file to a data folder.
+     */
+    upload(folderID: string, params: FileUploadParams, options?: RequestOptions): APIPromise<FileUploadResponse>;
+}
+export type FileListResponse = Array<FileListResponse.FileListResponseItem>;
+export declare namespace FileListResponse {
+    /**
+     * Representation of a single FileMetadata
+     */
+    interface FileListResponseItem {
+        /**
+         * The unique identifier of the source associated with the document.
+         */
+        source_id: string;
+        /**
+         * The human-friendly ID of the File
+         */
+        id?: string;
+        /**
+         * Number of chunks that have been embedded.
+         */
+        chunks_embedded?: number | null;
+        /**
+         * Optional full-text content of the file; only populated on demand due to its
+         * size.
+         */
+        content?: string | null;
+        /**
+         * The creation date of the file.
+         */
+        created_at?: string | null;
+        /**
+         * Optional error message if the file failed processing.
+         */
+        error_message?: string | null;
+        /**
+         * The creation date of the file.
+         */
+        file_creation_date?: string | null;
+        /**
+         * The last modified date of the file.
+         */
+        file_last_modified_date?: string | null;
+        /**
+         * The name of the file.
+         */
+        file_name?: string | null;
+        /**
+         * The path to the file.
+         */
+        file_path?: string | null;
+        /**
+         * The size of the file in bytes.
+         */
+        file_size?: number | null;
+        /**
+         * The type of the file (MIME type).
+         */
+        file_type?: string | null;
+        /**
+         * The original name of the file as uploaded.
+         */
+        original_file_name?: string | null;
+        /**
+         * The current processing status of the file (e.g. pending, parsing, embedding,
+         * completed, error).
+         */
+        processing_status?: 'pending' | 'parsing' | 'embedding' | 'completed' | 'error';
+        /**
+         * Total number of chunks for the file.
+         */
+        total_chunks?: number | null;
+        /**
+         * The update date of the file.
+         */
+        updated_at?: string | null;
+    }
+}
+/**
+ * Representation of a single FileMetadata
+ */
+export interface FileUploadResponse {
+    /**
+     * The unique identifier of the source associated with the document.
+     */
+    source_id: string;
+    /**
+     * The human-friendly ID of the File
+     */
+    id?: string;
+    /**
+     * Number of chunks that have been embedded.
+     */
+    chunks_embedded?: number | null;
+    /**
+     * Optional full-text content of the file; only populated on demand due to its
+     * size.
+     */
+    content?: string | null;
+    /**
+     * The creation date of the file.
+     */
+    created_at?: string | null;
+    /**
+     * Optional error message if the file failed processing.
+     */
+    error_message?: string | null;
+    /**
+     * The creation date of the file.
+     */
+    file_creation_date?: string | null;
+    /**
+     * The last modified date of the file.
+     */
+    file_last_modified_date?: string | null;
+    /**
+     * The name of the file.
+     */
+    file_name?: string | null;
+    /**
+     * The path to the file.
+     */
+    file_path?: string | null;
+    /**
+     * The size of the file in bytes.
+     */
+    file_size?: number | null;
+    /**
+     * The type of the file (MIME type).
+     */
+    file_type?: string | null;
+    /**
+     * The original name of the file as uploaded.
+     */
+    original_file_name?: string | null;
+    /**
+     * The current processing status of the file (e.g. pending, parsing, embedding,
+     * completed, error).
+     */
+    processing_status?: 'pending' | 'parsing' | 'embedding' | 'completed' | 'error';
+    /**
+     * Total number of chunks for the file.
+     */
+    total_chunks?: number | null;
+    /**
+     * The update date of the file.
+     */
+    updated_at?: string | null;
+}
+export interface FileListParams {
+    /**
+     * File ID cursor for pagination. Returns files that come after this file ID in the
+     * specified sort order
+     */
+    after?: string | null;
+    /**
+     * File ID cursor for pagination. Returns files that come before this file ID in
+     * the specified sort order
+     */
+    before?: string | null;
+    /**
+     * Whether to include full file content
+     */
+    include_content?: boolean;
+    /**
+     * Maximum number of files to return
+     */
+    limit?: number | null;
+    /**
+     * Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest
+     * first
+     */
+    order?: 'asc' | 'desc';
+    /**
+     * Field to sort by
+     */
+    order_by?: 'created_at';
+}
+export interface FileDeleteParams {
+    /**
+     * The ID of the source in the format 'source-<uuid4>'
+     */
+    folder_id: string;
+}
+export interface FileUploadParams {
+    /**
+     * Body param:
+     */
+    file: Uploadable;
+    /**
+     * Query param: How to handle duplicate filenames
+     */
+    duplicate_handling?: 'skip' | 'error' | 'suffix' | 'replace';
+    /**
+     * Query param: Optional custom name to override the uploaded file's name
+     */
+    name?: string | null;
+}
+export declare namespace Files {
+    export { type FileListResponse as FileListResponse, type FileUploadResponse as FileUploadResponse, type FileListParams as FileListParams, type FileDeleteParams as FileDeleteParams, type FileUploadParams as FileUploadParams, };
+}
+//# sourceMappingURL=files.d.ts.map

package/resources/folders/files.d.ts.map

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

package/resources/folders/files.js

@@ -0,0 +1,35 @@
+"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 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 {
+    /**
+     * List paginated files associated with a data folder.
+     */
+    list(folderID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/v1/folders/${folderID}/files`, { query, ...options });
+    }
+    /**
+     * Delete a file from a folder.
+     */
+    delete(fileID, params, options) {
+        const { folder_id } = params;
+        return this._client.delete((0, path_1.path) `/v1/folders/${folder_id}/${fileID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Upload a file to a data folder.
+     */
+    upload(folderID, params, options) {
+        const { duplicate_handling, name, ...body } = params;
+        return this._client.post((0, path_1.path) `/v1/folders/${folderID}/upload`, (0, uploads_1.multipartFormRequestOptions)({ query: { duplicate_handling, name }, body, ...options }, this._client));
+    }
+}
+exports.Files = Files;
+//# sourceMappingURL=files.js.map

package/resources/folders/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/resources/folders/files.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,uDAAsD;AAEtD,uDAAqE;AACrE,uDAAiD;AAEjD,MAAa,KAAM,SAAQ,sBAAW;IACpC;;OAEG;IACH,IAAI,CACF,QAAgB,EAChB,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,MAAwB,EAAE,OAAwB;QACvE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,eAAe,SAAS,IAAI,MAAM,EAAE,EAAE;YACnE,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;;OAEG;IACH,MAAM,CACJ,QAAgB,EAChB,MAAwB,EACxB,OAAwB;QAExB,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,IAAA,WAAI,EAAA,eAAe,QAAQ,SAAS,EACpC,IAAA,qCAA2B,EAAC,EAAE,KAAK,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CACrG,CAAC;IACJ,CAAC;CACF;AArCD,sBAqCC"}

package/resources/folders/files.mjs

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.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 {
+    /**
+     * List paginated files associated with a data folder.
+     */
+    list(folderID, query = {}, options) {
+        return this._client.get(path `/v1/folders/${folderID}/files`, { query, ...options });
+    }
+    /**
+     * Delete a file from a folder.
+     */
+    delete(fileID, params, options) {
+        const { folder_id } = params;
+        return this._client.delete(path `/v1/folders/${folder_id}/${fileID}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Upload a file to a data folder.
+     */
+    upload(folderID, params, options) {
+        const { duplicate_handling, name, ...body } = params;
+        return this._client.post(path `/v1/folders/${folderID}/upload`, multipartFormRequestOptions({ query: { duplicate_handling, name }, body, ...options }, this._client));
+    }
+}
+//# sourceMappingURL=files.mjs.map

package/resources/folders/files.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../../src/resources/folders/files.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,YAAY,EAAE;OAEhB,EAAE,2BAA2B,EAAE;OAC/B,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,IAAI,CACF,QAAgB,EAChB,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,eAAe,QAAQ,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc,EAAE,MAAwB,EAAE,OAAwB;QACvE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,eAAe,SAAS,IAAI,MAAM,EAAE,EAAE;YACnE,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;;OAEG;IACH,MAAM,CACJ,QAAgB,EAChB,MAAwB,EACxB,OAAwB;QAExB,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,IAAI,CAAA,eAAe,QAAQ,SAAS,EACpC,2BAA2B,CAAC,EAAE,KAAK,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CACrG,CAAC;IACJ,CAAC;CACF"}

package/resources/folders/folders.d.mts

@@ -0,0 +1,183 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as AgentsAPI from "./agents.mjs";
+import { AgentListParams, AgentListResponse, Agents } from "./agents.mjs";
+import * as FilesAPI from "./files.mjs";
+import { FileDeleteParams, FileListParams, FileListResponse, FileUploadParams, FileUploadResponse, Files } from "./files.mjs";
+import * as ModelsAPI from "../models/models.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Folders extends APIResource {
+    files: FilesAPI.Files;
+    agents: AgentsAPI.Agents;
+    /**
+     * Create a new data folder.
+     */
+    create(body: FolderCreateParams, options?: RequestOptions): APIPromise<Folder>;
+    /**
+     * Get a folder by ID
+     */
+    retrieve(folderID: string, options?: RequestOptions): APIPromise<Folder>;
+    /**
+     * Update the name or documentation of an existing data folder.
+     */
+    update(folderID: string, body: FolderUpdateParams, options?: RequestOptions): APIPromise<Folder>;
+    /**
+     * List all data folders created by a user.
+     */
+    list(query?: FolderListParams | null | undefined, options?: RequestOptions): APIPromise<FolderListResponse>;
+    /**
+     * Delete a data folder.
+     */
+    delete(folderID: string, options?: RequestOptions): APIPromise<unknown>;
+    /**
+     * Count all data folders created by a user.
+     */
+    count(options?: RequestOptions): APIPromise<FolderCountResponse>;
+}
+/**
+ * Representation of a folder, which is a collection of files and passages.
+ *
+ * Parameters: id (str): The ID of the folder name (str): The name of the folder.
+ * embedding_config (EmbeddingConfig): The embedding configuration used by the
+ * folder. user_id (str): The ID of the user that created the folder. metadata
+ * (dict): Metadata associated with the folder. description (str): The description
+ * of the folder.
+ */
+export interface Folder {
+    /**
+     * The embedding configuration used by the folder.
+     */
+    embedding_config: ModelsAPI.EmbeddingConfig;
+    /**
+     * The name of the folder.
+     */
+    name: string;
+    /**
+     * The human-friendly ID of the Source
+     */
+    id?: string;
+    /**
+     * The timestamp when the folder was created.
+     */
+    created_at?: string | null;
+    /**
+     * The id of the user that made this Tool.
+     */
+    created_by_id?: string | null;
+    /**
+     * The description of the folder.
+     */
+    description?: string | null;
+    /**
+     * Instructions for how to use the folder.
+     */
+    instructions?: string | null;
+    /**
+     * The id of the user that made this Tool.
+     */
+    last_updated_by_id?: string | null;
+    /**
+     * Metadata associated with the folder.
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The timestamp when the folder was last updated.
+     */
+    updated_at?: string | null;
+}
+export type FolderListResponse = Array<Folder>;
+export type FolderDeleteResponse = unknown;
+export type FolderCountResponse = number;
+export interface FolderCreateParams {
+    /**
+     * The name of the source.
+     */
+    name: string;
+    /**
+     * The description of the source.
+     */
+    description?: string | null;
+    /**
+     * The handle for the embedding config used by the source.
+     */
+    embedding?: string | null;
+    /**
+     * The chunk size of the embedding.
+     */
+    embedding_chunk_size?: number | null;
+    /**
+     * Configuration for embedding model connection and processing parameters.
+     */
+    embedding_config?: ModelsAPI.EmbeddingConfig | null;
+    /**
+     * Instructions for how to use the source.
+     */
+    instructions?: string | null;
+    /**
+     * Metadata associated with the source.
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+}
+export interface FolderUpdateParams {
+    /**
+     * The description of the source.
+     */
+    description?: string | null;
+    /**
+     * Configuration for embedding model connection and processing parameters.
+     */
+    embedding_config?: ModelsAPI.EmbeddingConfig | null;
+    /**
+     * Instructions for how to use the source.
+     */
+    instructions?: string | null;
+    /**
+     * Metadata associated with the source.
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The name of the source.
+     */
+    name?: string | null;
+}
+export interface FolderListParams {
+    /**
+     * Folder ID cursor for pagination. Returns folders that come after this folder ID
+     * in the specified sort order
+     */
+    after?: string | null;
+    /**
+     * Folder ID cursor for pagination. Returns folders that come before this folder ID
+     * in the specified sort order
+     */
+    before?: string | null;
+    /**
+     * Maximum number of folders to return
+     */
+    limit?: number | null;
+    /**
+     * Folder name to filter by
+     */
+    name?: string | null;
+    /**
+     * Sort order for folders by creation time. 'asc' for oldest first, 'desc' for
+     * newest first
+     */
+    order?: 'asc' | 'desc';
+    /**
+     * Field to sort by
+     */
+    order_by?: 'created_at';
+}
+export declare namespace Folders {
+    export { type Folder as Folder, type FolderListResponse as FolderListResponse, type FolderDeleteResponse as FolderDeleteResponse, type FolderCountResponse as FolderCountResponse, type FolderCreateParams as FolderCreateParams, type FolderUpdateParams as FolderUpdateParams, type FolderListParams as FolderListParams, };
+    export { Files as Files, type FileListResponse as FileListResponse, type FileUploadResponse as FileUploadResponse, type FileListParams as FileListParams, type FileDeleteParams as FileDeleteParams, type FileUploadParams as FileUploadParams, };
+    export { Agents as Agents, type AgentListResponse as AgentListResponse, type AgentListParams as AgentListParams, };
+}
+//# sourceMappingURL=folders.d.mts.map

package/resources/folders/folders.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.mts","sourceRoot":"","sources":["../../src/resources/folders/folders.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,SAAS;OACd,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,EAAE;OAC9C,KAAK,QAAQ;OACb,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,EACN;OACM,KAAK,SAAS;OACd,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAoC;IACzD,MAAM,EAAE,SAAS,CAAC,MAAM,CAAsC;IAE9D;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;IAI9E;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;IAIxE;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;IAIhG;;OAEG;IACH,IAAI,CACF,KAAK,GAAE,gBAAgB,GAAG,IAAI,GAAG,SAAc,EAC/C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,kBAAkB,CAAC;IAIjC;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAIvE;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;CAGjE;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,gBAAgB,EAAE,SAAS,CAAC,eAAe,CAAC;IAE5C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAE/C,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE3C,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC,eAAe,GAAG,IAAI,CAAC;IAEpD;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC,eAAe,GAAG,IAAI,CAAC;IAEpD;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAKD,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,MAAM,IAAI,MAAM,EACrB,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,GAC1C,CAAC;IAEF,OAAO,EACL,KAAK,IAAI,KAAK,EACd,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,gBAAgB,IAAI,gBAAgB,GAC1C,CAAC;IAEF,OAAO,EACL,MAAM,IAAI,MAAM,EAChB,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/folders/folders.d.ts

@@ -0,0 +1,183 @@
+import { APIResource } from "../../core/resource.js";
+import * as AgentsAPI from "./agents.js";
+import { AgentListParams, AgentListResponse, Agents } from "./agents.js";
+import * as FilesAPI from "./files.js";
+import { FileDeleteParams, FileListParams, FileListResponse, FileUploadParams, FileUploadResponse, Files } from "./files.js";
+import * as ModelsAPI from "../models/models.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Folders extends APIResource {
+    files: FilesAPI.Files;
+    agents: AgentsAPI.Agents;
+    /**
+     * Create a new data folder.
+     */
+    create(body: FolderCreateParams, options?: RequestOptions): APIPromise<Folder>;
+    /**
+     * Get a folder by ID
+     */
+    retrieve(folderID: string, options?: RequestOptions): APIPromise<Folder>;
+    /**
+     * Update the name or documentation of an existing data folder.
+     */
+    update(folderID: string, body: FolderUpdateParams, options?: RequestOptions): APIPromise<Folder>;
+    /**
+     * List all data folders created by a user.
+     */
+    list(query?: FolderListParams | null | undefined, options?: RequestOptions): APIPromise<FolderListResponse>;
+    /**
+     * Delete a data folder.
+     */
+    delete(folderID: string, options?: RequestOptions): APIPromise<unknown>;
+    /**
+     * Count all data folders created by a user.
+     */
+    count(options?: RequestOptions): APIPromise<FolderCountResponse>;
+}
+/**
+ * Representation of a folder, which is a collection of files and passages.
+ *
+ * Parameters: id (str): The ID of the folder name (str): The name of the folder.
+ * embedding_config (EmbeddingConfig): The embedding configuration used by the
+ * folder. user_id (str): The ID of the user that created the folder. metadata
+ * (dict): Metadata associated with the folder. description (str): The description
+ * of the folder.
+ */
+export interface Folder {
+    /**
+     * The embedding configuration used by the folder.
+     */
+    embedding_config: ModelsAPI.EmbeddingConfig;
+    /**
+     * The name of the folder.
+     */
+    name: string;
+    /**
+     * The human-friendly ID of the Source
+     */
+    id?: string;
+    /**
+     * The timestamp when the folder was created.
+     */
+    created_at?: string | null;
+    /**
+     * The id of the user that made this Tool.
+     */
+    created_by_id?: string | null;
+    /**
+     * The description of the folder.
+     */
+    description?: string | null;
+    /**
+     * Instructions for how to use the folder.
+     */
+    instructions?: string | null;
+    /**
+     * The id of the user that made this Tool.
+     */
+    last_updated_by_id?: string | null;
+    /**
+     * Metadata associated with the folder.
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The timestamp when the folder was last updated.
+     */
+    updated_at?: string | null;
+}
+export type FolderListResponse = Array<Folder>;
+export type FolderDeleteResponse = unknown;
+export type FolderCountResponse = number;
+export interface FolderCreateParams {
+    /**
+     * The name of the source.
+     */
+    name: string;
+    /**
+     * The description of the source.
+     */
+    description?: string | null;
+    /**
+     * The handle for the embedding config used by the source.
+     */
+    embedding?: string | null;
+    /**
+     * The chunk size of the embedding.
+     */
+    embedding_chunk_size?: number | null;
+    /**
+     * Configuration for embedding model connection and processing parameters.
+     */
+    embedding_config?: ModelsAPI.EmbeddingConfig | null;
+    /**
+     * Instructions for how to use the source.
+     */
+    instructions?: string | null;
+    /**
+     * Metadata associated with the source.
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+}
+export interface FolderUpdateParams {
+    /**
+     * The description of the source.
+     */
+    description?: string | null;
+    /**
+     * Configuration for embedding model connection and processing parameters.
+     */
+    embedding_config?: ModelsAPI.EmbeddingConfig | null;
+    /**
+     * Instructions for how to use the source.
+     */
+    instructions?: string | null;
+    /**
+     * Metadata associated with the source.
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * The name of the source.
+     */
+    name?: string | null;
+}
+export interface FolderListParams {
+    /**
+     * Folder ID cursor for pagination. Returns folders that come after this folder ID
+     * in the specified sort order
+     */
+    after?: string | null;
+    /**
+     * Folder ID cursor for pagination. Returns folders that come before this folder ID
+     * in the specified sort order
+     */
+    before?: string | null;
+    /**
+     * Maximum number of folders to return
+     */
+    limit?: number | null;
+    /**
+     * Folder name to filter by
+     */
+    name?: string | null;
+    /**
+     * Sort order for folders by creation time. 'asc' for oldest first, 'desc' for
+     * newest first
+     */
+    order?: 'asc' | 'desc';
+    /**
+     * Field to sort by
+     */
+    order_by?: 'created_at';
+}
+export declare namespace Folders {
+    export { type Folder as Folder, type FolderListResponse as FolderListResponse, type FolderDeleteResponse as FolderDeleteResponse, type FolderCountResponse as FolderCountResponse, type FolderCreateParams as FolderCreateParams, type FolderUpdateParams as FolderUpdateParams, type FolderListParams as FolderListParams, };
+    export { Files as Files, type FileListResponse as FileListResponse, type FileUploadResponse as FileUploadResponse, type FileListParams as FileListParams, type FileDeleteParams as FileDeleteParams, type FileUploadParams as FileUploadParams, };
+    export { Agents as Agents, type AgentListResponse as AgentListResponse, type AgentListParams as AgentListParams, };
+}
+//# sourceMappingURL=folders.d.ts.map

package/resources/folders/folders.d.ts.map

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