@letta-ai/letta-client 0.1.211 → 1.0.0-alpha.10

package/resources/agents/files.d.ts

@@ -0,0 +1,148 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Files extends APIResource {
+    /**
+     * Get the files attached to an agent with their open/closed status.
+     */
+    list(agentID: string, query?: FileListParams | null | undefined, options?: RequestOptions): APIPromise<FileListResponse>;
+    /**
+     * Closes a specific file for a given agent.
+     *
+     * This endpoint marks a specific file as closed in the agent's file state. The
+     * file will be removed from the agent's working memory view.
+     */
+    close(fileID: string, params: FileCloseParams, options?: RequestOptions): APIPromise<unknown>;
+    /**
+     * Closes all currently open files for a given agent.
+     *
+     * This endpoint updates the file state for the agent so that no files are marked
+     * as open. Typically used to reset the working memory view for the agent.
+     */
+    closeAll(agentID: string, options?: RequestOptions): APIPromise<FileCloseAllResponse>;
+    /**
+     * Opens a specific file for a given agent.
+     *
+     * This endpoint marks a specific file as open in the agent's file state. The file
+     * will be included in the agent's working memory view. Returns a list of file
+     * names that were closed due to LRU eviction.
+     */
+    open(fileID: string, params: FileOpenParams, options?: RequestOptions): APIPromise<FileOpenResponse>;
+}
+/**
+ * Paginated response for agent files
+ */
+export interface FileListResponse {
+    /**
+     * List of file attachments for the agent
+     */
+    files: Array<FileListResponse.File>;
+    /**
+     * Whether more results exist after this page
+     */
+    has_more: boolean;
+    /**
+     * Cursor for fetching the next page (file-agent relationship ID)
+     */
+    next_cursor?: string | null;
+}
+export declare namespace FileListResponse {
+    /**
+     * Response model for agent file attachments showing file status in agent context
+     */
+    interface File {
+        /**
+         * Unique identifier of the file-agent relationship
+         */
+        id: string;
+        /**
+         * Unique identifier of the file
+         */
+        file_id: string;
+        /**
+         * Name of the file
+         */
+        file_name: string;
+        /**
+         * Unique identifier of the folder/source
+         */
+        folder_id: string;
+        /**
+         * Name of the folder/source
+         */
+        folder_name: string;
+        /**
+         * Whether the file is currently open in the agent's context
+         */
+        is_open: boolean;
+        /**
+         * Ending line number if file was opened with line range
+         */
+        end_line?: number | null;
+        /**
+         * Timestamp of last access by the agent
+         */
+        last_accessed_at?: string | null;
+        /**
+         * Starting line number if file was opened with line range
+         */
+        start_line?: number | null;
+        /**
+         * Portion of the file visible to the agent if open
+         */
+        visible_content?: string | null;
+    }
+}
+export type FileCloseResponse = unknown;
+export type FileCloseAllResponse = Array<string>;
+export type FileOpenResponse = Array<string>;
+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;
+    /**
+     * @deprecated Pagination cursor from previous response (deprecated, use
+     * before/after)
+     */
+    cursor?: string | null;
+    /**
+     * Filter by open status (true for open files, false for closed files)
+     */
+    is_open?: boolean | null;
+    /**
+     * 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 FileCloseParams {
+    /**
+     * The ID of the agent in the format 'agent-<uuid4>'
+     */
+    agent_id: string;
+}
+export interface FileOpenParams {
+    /**
+     * The ID of the agent in the format 'agent-<uuid4>'
+     */
+    agent_id: string;
+}
+export declare namespace Files {
+    export { type FileListResponse as FileListResponse, type FileCloseResponse as FileCloseResponse, type FileCloseAllResponse as FileCloseAllResponse, type FileOpenResponse as FileOpenResponse, type FileListParams as FileListParams, type FileCloseParams as FileCloseParams, type FileOpenParams as FileOpenParams, };
+}
+//# sourceMappingURL=files.d.ts.map

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

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

package/resources/agents/files.js

@@ -0,0 +1,46 @@
+"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 path_1 = require("../../internal/utils/path.js");
+class Files extends resource_1.APIResource {
+    /**
+     * Get the files attached to an agent with their open/closed status.
+     */
+    list(agentID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/v1/agents/${agentID}/files`, { query, ...options });
+    }
+    /**
+     * Closes a specific file for a given agent.
+     *
+     * This endpoint marks a specific file as closed in the agent's file state. The
+     * file will be removed from the agent's working memory view.
+     */
+    close(fileID, params, options) {
+        const { agent_id } = params;
+        return this._client.patch((0, path_1.path) `/v1/agents/${agent_id}/files/${fileID}/close`, options);
+    }
+    /**
+     * Closes all currently open files for a given agent.
+     *
+     * This endpoint updates the file state for the agent so that no files are marked
+     * as open. Typically used to reset the working memory view for the agent.
+     */
+    closeAll(agentID, options) {
+        return this._client.patch((0, path_1.path) `/v1/agents/${agentID}/files/close-all`, options);
+    }
+    /**
+     * Opens a specific file for a given agent.
+     *
+     * This endpoint marks a specific file as open in the agent's file state. The file
+     * will be included in the agent's working memory view. Returns a list of file
+     * names that were closed due to LRU eviction.
+     */
+    open(fileID, params, options) {
+        const { agent_id } = params;
+        return this._client.patch((0, path_1.path) `/v1/agents/${agent_id}/files/${fileID}/open`, options);
+    }
+}
+exports.Files = Files;
+//# sourceMappingURL=files.js.map

package/resources/agents/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/resources/agents/files.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,uDAAiD;AAEjD,MAAa,KAAM,SAAQ,sBAAW;IACpC;;OAEG;IACH,IAAI,CACF,OAAe,EACf,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,cAAc,OAAO,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAc,EAAE,MAAuB,EAAE,OAAwB;QACrE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,cAAc,QAAQ,UAAU,MAAM,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAe,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,cAAc,OAAO,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAClF,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAAc,EAAE,MAAsB,EAAE,OAAwB;QACnE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,cAAc,QAAQ,UAAU,MAAM,OAAO,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;CACF;AA5CD,sBA4CC"}

package/resources/agents/files.mjs

@@ -0,0 +1,42 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Files extends APIResource {
+    /**
+     * Get the files attached to an agent with their open/closed status.
+     */
+    list(agentID, query = {}, options) {
+        return this._client.get(path `/v1/agents/${agentID}/files`, { query, ...options });
+    }
+    /**
+     * Closes a specific file for a given agent.
+     *
+     * This endpoint marks a specific file as closed in the agent's file state. The
+     * file will be removed from the agent's working memory view.
+     */
+    close(fileID, params, options) {
+        const { agent_id } = params;
+        return this._client.patch(path `/v1/agents/${agent_id}/files/${fileID}/close`, options);
+    }
+    /**
+     * Closes all currently open files for a given agent.
+     *
+     * This endpoint updates the file state for the agent so that no files are marked
+     * as open. Typically used to reset the working memory view for the agent.
+     */
+    closeAll(agentID, options) {
+        return this._client.patch(path `/v1/agents/${agentID}/files/close-all`, options);
+    }
+    /**
+     * Opens a specific file for a given agent.
+     *
+     * This endpoint marks a specific file as open in the agent's file state. The file
+     * will be included in the agent's working memory view. Returns a list of file
+     * names that were closed due to LRU eviction.
+     */
+    open(fileID, params, options) {
+        const { agent_id } = params;
+        return this._client.patch(path `/v1/agents/${agent_id}/files/${fileID}/open`, options);
+    }
+}
+//# sourceMappingURL=files.mjs.map

package/resources/agents/files.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../../src/resources/agents/files.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,IAAI,CACF,OAAe,EACf,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,cAAc,OAAO,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAc,EAAE,MAAuB,EAAE,OAAwB;QACrE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,cAAc,QAAQ,UAAU,MAAM,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAe,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,cAAc,OAAO,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAClF,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,MAAc,EAAE,MAAsB,EAAE,OAAwB;QACnE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,cAAc,QAAQ,UAAU,MAAM,OAAO,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;CACF"}

package/resources/agents/folders.d.mts

@@ -0,0 +1,121 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as ArchivesAPI from "../archives.mjs";
+import * as AgentsAPI from "./agents.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 {
+    /**
+     * Get the folders associated with an agent.
+     */
+    list(agentID: string, query?: FolderListParams | null | undefined, options?: RequestOptions): APIPromise<FolderListResponse>;
+    /**
+     * Attach a folder to an agent.
+     */
+    attach(folderID: string, params: FolderAttachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState>;
+    /**
+     * Detach a folder from an agent.
+     */
+    detach(folderID: string, params: FolderDetachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState>;
+}
+export type FolderListResponse = Array<FolderListResponse.FolderListResponseItem>;
+export declare namespace FolderListResponse {
+    /**
+     * Representation of a source, which is a collection of files and passages.
+     *
+     * Parameters: id (str): The ID of the source name (str): The name of the source.
+     * embedding_config (EmbeddingConfig): The embedding configuration used by the
+     * source. user_id (str): The ID of the user that created the source. metadata
+     * (dict): Metadata associated with the source. description (str): The description
+     * of the source.
+     */
+    interface FolderListResponseItem {
+        /**
+         * The embedding configuration used by the source.
+         */
+        embedding_config: ModelsAPI.EmbeddingConfig;
+        /**
+         * The name of the source.
+         */
+        name: string;
+        /**
+         * The human-friendly ID of the Source
+         */
+        id?: string;
+        /**
+         * The timestamp when the source was created.
+         */
+        created_at?: string | null;
+        /**
+         * The id of the user that made this Tool.
+         */
+        created_by_id?: string | null;
+        /**
+         * The description of the source.
+         */
+        description?: string | null;
+        /**
+         * Instructions for how to use the source.
+         */
+        instructions?: string | null;
+        /**
+         * The id of the user that made this Tool.
+         */
+        last_updated_by_id?: string | null;
+        /**
+         * Metadata associated with the source.
+         */
+        metadata?: {
+            [key: string]: unknown;
+        } | null;
+        /**
+         * The timestamp when the source was last updated.
+         */
+        updated_at?: string | null;
+        /**
+         * The vector database provider used for this source's passages
+         */
+        vector_db_provider?: ArchivesAPI.VectorDBProvider;
+    }
+}
+export interface FolderListParams {
+    /**
+     * Source ID cursor for pagination. Returns sources that come after this source ID
+     * in the specified sort order
+     */
+    after?: string | null;
+    /**
+     * Source ID cursor for pagination. Returns sources that come before this source ID
+     * in the specified sort order
+     */
+    before?: string | null;
+    /**
+     * Maximum number of sources to return
+     */
+    limit?: number | null;
+    /**
+     * Sort order for sources by creation time. 'asc' for oldest first, 'desc' for
+     * newest first
+     */
+    order?: 'asc' | 'desc';
+    /**
+     * Field to sort by
+     */
+    order_by?: 'created_at';
+}
+export interface FolderAttachParams {
+    /**
+     * The ID of the agent in the format 'agent-<uuid4>'
+     */
+    agent_id: string;
+}
+export interface FolderDetachParams {
+    /**
+     * The ID of the agent in the format 'agent-<uuid4>'
+     */
+    agent_id: string;
+}
+export declare namespace Folders {
+    export { type FolderListResponse as FolderListResponse, type FolderListParams as FolderListParams, type FolderAttachParams as FolderAttachParams, type FolderDetachParams as FolderDetachParams, };
+}
+//# sourceMappingURL=folders.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.mts","sourceRoot":"","sources":["../../src/resources/agents/folders.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,KAAK,SAAS;OACd,KAAK,SAAS;OACd,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,gBAAgB,GAAG,IAAI,GAAG,SAAc,EAC/C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,kBAAkB,CAAC;IAIjC;;OAEG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC;IAKnC;;OAEG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC;CAIpC;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;AAElF,yBAAiB,kBAAkB,CAAC;IAClC;;;;;;;;OAQG;IACH,UAAiB,sBAAsB;QACrC;;WAEG;QACH,gBAAgB,EAAE,SAAS,CAAC,eAAe,CAAC;QAE5C;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;QAEZ;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE9B;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE5B;;WAEG;QACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE7B;;WAEG;QACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEnC;;WAEG;QACH,QAAQ,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,GAAG,IAAI,CAAC;QAE7C;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,kBAAkB,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC;KACnD;CACF;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;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/agents/folders.d.ts

@@ -0,0 +1,121 @@
+import { APIResource } from "../../core/resource.js";
+import * as ArchivesAPI from "../archives.js";
+import * as AgentsAPI from "./agents.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 {
+    /**
+     * Get the folders associated with an agent.
+     */
+    list(agentID: string, query?: FolderListParams | null | undefined, options?: RequestOptions): APIPromise<FolderListResponse>;
+    /**
+     * Attach a folder to an agent.
+     */
+    attach(folderID: string, params: FolderAttachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState>;
+    /**
+     * Detach a folder from an agent.
+     */
+    detach(folderID: string, params: FolderDetachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState>;
+}
+export type FolderListResponse = Array<FolderListResponse.FolderListResponseItem>;
+export declare namespace FolderListResponse {
+    /**
+     * Representation of a source, which is a collection of files and passages.
+     *
+     * Parameters: id (str): The ID of the source name (str): The name of the source.
+     * embedding_config (EmbeddingConfig): The embedding configuration used by the
+     * source. user_id (str): The ID of the user that created the source. metadata
+     * (dict): Metadata associated with the source. description (str): The description
+     * of the source.
+     */
+    interface FolderListResponseItem {
+        /**
+         * The embedding configuration used by the source.
+         */
+        embedding_config: ModelsAPI.EmbeddingConfig;
+        /**
+         * The name of the source.
+         */
+        name: string;
+        /**
+         * The human-friendly ID of the Source
+         */
+        id?: string;
+        /**
+         * The timestamp when the source was created.
+         */
+        created_at?: string | null;
+        /**
+         * The id of the user that made this Tool.
+         */
+        created_by_id?: string | null;
+        /**
+         * The description of the source.
+         */
+        description?: string | null;
+        /**
+         * Instructions for how to use the source.
+         */
+        instructions?: string | null;
+        /**
+         * The id of the user that made this Tool.
+         */
+        last_updated_by_id?: string | null;
+        /**
+         * Metadata associated with the source.
+         */
+        metadata?: {
+            [key: string]: unknown;
+        } | null;
+        /**
+         * The timestamp when the source was last updated.
+         */
+        updated_at?: string | null;
+        /**
+         * The vector database provider used for this source's passages
+         */
+        vector_db_provider?: ArchivesAPI.VectorDBProvider;
+    }
+}
+export interface FolderListParams {
+    /**
+     * Source ID cursor for pagination. Returns sources that come after this source ID
+     * in the specified sort order
+     */
+    after?: string | null;
+    /**
+     * Source ID cursor for pagination. Returns sources that come before this source ID
+     * in the specified sort order
+     */
+    before?: string | null;
+    /**
+     * Maximum number of sources to return
+     */
+    limit?: number | null;
+    /**
+     * Sort order for sources by creation time. 'asc' for oldest first, 'desc' for
+     * newest first
+     */
+    order?: 'asc' | 'desc';
+    /**
+     * Field to sort by
+     */
+    order_by?: 'created_at';
+}
+export interface FolderAttachParams {
+    /**
+     * The ID of the agent in the format 'agent-<uuid4>'
+     */
+    agent_id: string;
+}
+export interface FolderDetachParams {
+    /**
+     * The ID of the agent in the format 'agent-<uuid4>'
+     */
+    agent_id: string;
+}
+export declare namespace Folders {
+    export { type FolderListResponse as FolderListResponse, type FolderListParams as FolderListParams, type FolderAttachParams as FolderAttachParams, type FolderDetachParams as FolderDetachParams, };
+}
+//# sourceMappingURL=folders.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/resources/agents/folders.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,KAAK,SAAS;OACd,KAAK,SAAS;OACd,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,gBAAgB,GAAG,IAAI,GAAG,SAAc,EAC/C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,kBAAkB,CAAC;IAIjC;;OAEG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC;IAKnC;;OAEG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC;CAIpC;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;AAElF,yBAAiB,kBAAkB,CAAC;IAClC;;;;;;;;OAQG;IACH,UAAiB,sBAAsB;QACrC;;WAEG;QACH,gBAAgB,EAAE,SAAS,CAAC,eAAe,CAAC;QAE5C;;WAEG;QACH,IAAI,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;QAEZ;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE9B;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE5B;;WAEG;QACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE7B;;WAEG;QACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEnC;;WAEG;QACH,QAAQ,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,GAAG,IAAI,CAAC;QAE7C;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,kBAAkB,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC;KACnD;CACF;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;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/agents/folders.js

@@ -0,0 +1,30 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Folders = void 0;
+const resource_1 = require("../../core/resource.js");
+const path_1 = require("../../internal/utils/path.js");
+class Folders extends resource_1.APIResource {
+    /**
+     * Get the folders associated with an agent.
+     */
+    list(agentID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/v1/agents/${agentID}/folders`, { query, ...options });
+    }
+    /**
+     * Attach a folder to an agent.
+     */
+    attach(folderID, params, options) {
+        const { agent_id } = params;
+        return this._client.patch((0, path_1.path) `/v1/agents/${agent_id}/folders/attach/${folderID}`, options);
+    }
+    /**
+     * Detach a folder from an agent.
+     */
+    detach(folderID, params, options) {
+        const { agent_id } = params;
+        return this._client.patch((0, path_1.path) `/v1/agents/${agent_id}/folders/detach/${folderID}`, options);
+    }
+}
+exports.Folders = Folders;
+//# sourceMappingURL=folders.js.map

package/resources/agents/folders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.js","sourceRoot":"","sources":["../../src/resources/agents/folders.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAMlD,uDAAiD;AAEjD,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;OAEG;IACH,IAAI,CACF,OAAe,EACf,QAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,cAAc,OAAO,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,QAAgB,EAChB,MAA0B,EAC1B,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,cAAc,QAAQ,mBAAmB,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9F,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,QAAgB,EAChB,MAA0B,EAC1B,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,cAAc,QAAQ,mBAAmB,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9F,CAAC;CACF;AAnCD,0BAmCC"}

package/resources/agents/folders.mjs

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Folders extends APIResource {
+    /**
+     * Get the folders associated with an agent.
+     */
+    list(agentID, query = {}, options) {
+        return this._client.get(path `/v1/agents/${agentID}/folders`, { query, ...options });
+    }
+    /**
+     * Attach a folder to an agent.
+     */
+    attach(folderID, params, options) {
+        const { agent_id } = params;
+        return this._client.patch(path `/v1/agents/${agent_id}/folders/attach/${folderID}`, options);
+    }
+    /**
+     * Detach a folder from an agent.
+     */
+    detach(folderID, params, options) {
+        const { agent_id } = params;
+        return this._client.patch(path `/v1/agents/${agent_id}/folders/detach/${folderID}`, options);
+    }
+}
+//# sourceMappingURL=folders.mjs.map

package/resources/agents/folders.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.mjs","sourceRoot":"","sources":["../../src/resources/agents/folders.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAMf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,IAAI,CACF,OAAe,EACf,QAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,cAAc,OAAO,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,QAAgB,EAChB,MAA0B,EAC1B,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,cAAc,QAAQ,mBAAmB,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9F,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,QAAgB,EAChB,MAA0B,EAC1B,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,cAAc,QAAQ,mBAAmB,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9F,CAAC;CACF"}

package/resources/agents/groups.d.mts

@@ -0,0 +1,22 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as GroupsGroupsAPI from "../groups/groups.mjs";
+import { GroupsArrayPage } from "../groups/groups.mjs";
+import { type ArrayPageParams, PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Groups extends APIResource {
+    /**
+     * Lists the groups for an agent.
+     */
+    list(agentID: string, query?: GroupListParams | null | undefined, options?: RequestOptions): PagePromise<GroupsArrayPage, GroupsGroupsAPI.Group>;
+}
+export interface GroupListParams extends ArrayPageParams {
+    /**
+     * Manager type to filter groups by
+     */
+    manager_type?: string | null;
+}
+export declare namespace Groups {
+    export { type GroupListParams as GroupListParams };
+}
+export { type GroupsArrayPage };
+//# sourceMappingURL=groups.d.mts.map

package/resources/agents/groups.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.mts","sourceRoot":"","sources":["../../src/resources/agents/groups.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,eAAe;OACpB,EAAE,eAAe,EAAE;OACnB,EAAa,KAAK,eAAe,EAAE,WAAW,EAAE;OAChD,EAAE,cAAc,EAAE;AAGzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,eAAe,EAAE,eAAe,CAAC,KAAK,CAAC;CAMvD;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EAAE,KAAK,eAAe,IAAI,eAAe,EAAE,CAAC;CACpD;AAED,OAAO,EAAE,KAAK,eAAe,EAAE,CAAC"}

package/resources/agents/groups.d.ts

@@ -0,0 +1,22 @@
+import { APIResource } from "../../core/resource.js";
+import * as GroupsGroupsAPI from "../groups/groups.js";
+import { GroupsArrayPage } from "../groups/groups.js";
+import { type ArrayPageParams, PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Groups extends APIResource {
+    /**
+     * Lists the groups for an agent.
+     */
+    list(agentID: string, query?: GroupListParams | null | undefined, options?: RequestOptions): PagePromise<GroupsArrayPage, GroupsGroupsAPI.Group>;
+}
+export interface GroupListParams extends ArrayPageParams {
+    /**
+     * Manager type to filter groups by
+     */
+    manager_type?: string | null;
+}
+export declare namespace Groups {
+    export { type GroupListParams as GroupListParams };
+}
+export { type GroupsArrayPage };
+//# sourceMappingURL=groups.d.ts.map

package/resources/agents/groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../src/resources/agents/groups.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,eAAe;OACpB,EAAE,eAAe,EAAE;OACnB,EAAa,KAAK,eAAe,EAAE,WAAW,EAAE;OAChD,EAAE,cAAc,EAAE;AAGzB,qBAAa,MAAO,SAAQ,WAAW;IACrC;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,eAAe,GAAG,IAAI,GAAG,SAAc,EAC9C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,eAAe,EAAE,eAAe,CAAC,KAAK,CAAC;CAMvD;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EAAE,KAAK,eAAe,IAAI,eAAe,EAAE,CAAC;CACpD;AAED,OAAO,EAAE,KAAK,eAAe,EAAE,CAAC"}

package/resources/agents/groups.js

@@ -0,0 +1,20 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Groups = void 0;
+const resource_1 = require("../../core/resource.js");
+const pagination_1 = require("../../core/pagination.js");
+const path_1 = require("../../internal/utils/path.js");
+class Groups extends resource_1.APIResource {
+    /**
+     * Lists the groups for an agent.
+     */
+    list(agentID, query = {}, options) {
+        return this._client.getAPIList((0, path_1.path) `/v1/agents/${agentID}/groups`, (pagination_1.ArrayPage), {
+            query,
+            ...options,
+        });
+    }
+}
+exports.Groups = Groups;
+//# sourceMappingURL=groups.js.map

package/resources/agents/groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.js","sourceRoot":"","sources":["../../src/resources/agents/groups.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,yDAAqF;AAErF,uDAAiD;AAEjD,MAAa,MAAO,SAAQ,sBAAW;IACrC;;OAEG;IACH,IAAI,CACF,OAAe,EACf,QAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAA,WAAI,EAAA,cAAc,OAAO,SAAS,EAAE,CAAA,sBAAgC,CAAA,EAAE;YACnG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF;AAdD,wBAcC"}