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

package/resources/agents/files.d.mts

@@ -1,11 +1,12 @@
 import { APIResource } from "../../core/resource.mjs";
 import { APIPromise } from "../../core/api-promise.mjs";
+import { NextFilesPage, type NextFilesPageParams, PagePromise } from "../../core/pagination.mjs";
 import { RequestOptions } from "../../internal/request-options.mjs";
 export declare class Files extends APIResource {
     /**
-     * Get the files attached to an agent with their open/closed status (paginated).
+     * Get the files attached to an agent with their open/closed status.
      */
-    list(agentID: string, query?: FileListParams | null | undefined, options?: RequestOptions): APIPromise<FileListResponse>;
+    list(agentID: string, query?: FileListParams | null | undefined, options?: RequestOptions): PagePromise<FileListResponsesNextFilesPage, FileListResponse>;
     /**
      * Closes a specific file for a given agent.
      *
@@ -29,94 +30,79 @@ export declare class Files extends APIResource {
      */
     open(fileID: string, params: FileOpenParams, options?: RequestOptions): APIPromise<FileOpenResponse>;
 }
+export type FileListResponsesNextFilesPage = NextFilesPage<FileListResponse>;
 /**
- * Paginated response for agent files
+ * Response model for agent file attachments showing file status in agent context
  */
 export interface FileListResponse {
     /**
-     * List of file attachments for the agent
+     * Unique identifier of the file-agent relationship
      */
-    files: Array<FileListResponse.File>;
+    id: string;
     /**
-     * Whether more results exist after this page
+     * Unique identifier of the file
      */
-    has_more: boolean;
+    file_id: string;
     /**
-     * Cursor for fetching the next page (file-agent relationship ID)
+     * Name of the file
      */
-    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;
-    }
+    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 {
+export interface FileListParams extends NextFilesPageParams {
     /**
-     * Pagination cursor from previous response
+     * @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;
-    /**
-     * Number of items to return (1-100)
-     */
-    limit?: number;
 }
 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, };
+    export { type FileListResponse as FileListResponse, type FileCloseResponse as FileCloseResponse, type FileCloseAllResponse as FileCloseAllResponse, type FileOpenResponse as FileOpenResponse, type FileListResponsesNextFilesPage as FileListResponsesNextFilesPage, type FileListParams as FileListParams, type FileCloseParams as FileCloseParams, type FileOpenParams as FileOpenParams, };
 }
 //# sourceMappingURL=files.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"files.d.mts","sourceRoot":"","sources":["../../src/resources/agents/files.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,gBAAgB,CAAC;IAI/B;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAK7F;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAIrF;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC;CAIrG;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEpC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,yBAAiB,gBAAgB,CAAC;IAChC;;OAEG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,WAAW,EAAE,MAAM,CAAC;QAEpB;;WAEG;QACH,OAAO,EAAE,OAAO,CAAC;QAEjB;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEzB;;WAEG;QACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEjC;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC;CACF;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAExC,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}
+{"version":3,"file":"files.d.mts","sourceRoot":"","sources":["../../src/resources/agents/files.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,WAAW,EAAE;OACxD,EAAE,cAAc,EAAE;AAGzB,qBAAa,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,8BAA8B,EAAE,gBAAgB,CAAC;IAOhE;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAK7F;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAIrF;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC;CAIrG;AAED,MAAM,MAAM,8BAA8B,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAExC,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAE7C,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}

package/resources/agents/files.d.ts

@@ -1,11 +1,12 @@
 import { APIResource } from "../../core/resource.js";
 import { APIPromise } from "../../core/api-promise.js";
+import { NextFilesPage, type NextFilesPageParams, PagePromise } from "../../core/pagination.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 (paginated).
+     * Get the files attached to an agent with their open/closed status.
      */
-    list(agentID: string, query?: FileListParams | null | undefined, options?: RequestOptions): APIPromise<FileListResponse>;
+    list(agentID: string, query?: FileListParams | null | undefined, options?: RequestOptions): PagePromise<FileListResponsesNextFilesPage, FileListResponse>;
     /**
      * Closes a specific file for a given agent.
      *
@@ -29,94 +30,79 @@ export declare class Files extends APIResource {
      */
     open(fileID: string, params: FileOpenParams, options?: RequestOptions): APIPromise<FileOpenResponse>;
 }
+export type FileListResponsesNextFilesPage = NextFilesPage<FileListResponse>;
 /**
- * Paginated response for agent files
+ * Response model for agent file attachments showing file status in agent context
  */
 export interface FileListResponse {
     /**
-     * List of file attachments for the agent
+     * Unique identifier of the file-agent relationship
      */
-    files: Array<FileListResponse.File>;
+    id: string;
     /**
-     * Whether more results exist after this page
+     * Unique identifier of the file
      */
-    has_more: boolean;
+    file_id: string;
     /**
-     * Cursor for fetching the next page (file-agent relationship ID)
+     * Name of the file
      */
-    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;
-    }
+    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 {
+export interface FileListParams extends NextFilesPageParams {
     /**
-     * Pagination cursor from previous response
+     * @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;
-    /**
-     * Number of items to return (1-100)
-     */
-    limit?: number;
 }
 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, };
+    export { type FileListResponse as FileListResponse, type FileCloseResponse as FileCloseResponse, type FileCloseAllResponse as FileCloseAllResponse, type FileOpenResponse as FileOpenResponse, type FileListResponsesNextFilesPage as FileListResponsesNextFilesPage, type FileListParams as FileListParams, type FileCloseParams as FileCloseParams, type FileOpenParams as FileOpenParams, };
 }
 //# sourceMappingURL=files.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/resources/agents/files.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,gBAAgB,CAAC;IAI/B;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAK7F;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAIrF;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC;CAIrG;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEpC;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,yBAAiB,gBAAgB,CAAC;IAChC;;OAEG;IACH,UAAiB,IAAI;QACnB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,WAAW,EAAE,MAAM,CAAC;QAEpB;;WAEG;QACH,OAAO,EAAE,OAAO,CAAC;QAEjB;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEzB;;WAEG;QACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEjC;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAE3B;;WAEG;QACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC;CACF;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAExC,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/resources/agents/files.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,WAAW,EAAE;OACxD,EAAE,cAAc,EAAE;AAGzB,qBAAa,KAAM,SAAQ,WAAW;IACpC;;OAEG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,cAAc,GAAG,IAAI,GAAG,SAAc,EAC7C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,8BAA8B,EAAE,gBAAgB,CAAC;IAOhE;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAK7F;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,oBAAoB,CAAC;IAIrF;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC;CAIrG;AAED,MAAM,MAAM,8BAA8B,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAExC,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAE7C,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}

package/resources/agents/files.js

@@ -3,13 +3,17 @@
 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 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 (paginated).
+     * 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 });
+        return this._client.getAPIList((0, path_1.path) `/v1/agents/${agentID}/files`, (pagination_1.NextFilesPage), {
+            query,
+            ...options,
+        });
     }
     /**
      * Closes a specific file for a given agent.

package/resources/agents/files.js.map

@@ -1 +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"}
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/resources/agents/files.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,yDAA6F;AAE7F,uDAAiD;AAEjD,MAAa,KAAM,SAAQ,sBAAW;IACpC;;OAEG;IACH,IAAI,CACF,OAAe,EACf,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAA,WAAI,EAAA,cAAc,OAAO,QAAQ,EAAE,CAAA,0BAA+B,CAAA,EAAE;YACjG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,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;AA/CD,sBA+CC"}

package/resources/agents/files.mjs

@@ -1,12 +1,16 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../core/resource.mjs";
+import { NextFilesPage } from "../../core/pagination.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 (paginated).
+     * 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 });
+        return this._client.getAPIList(path `/v1/agents/${agentID}/files`, (NextFilesPage), {
+            query,
+            ...options,
+        });
     }
     /**
      * Closes a specific file for a given agent.

package/resources/agents/files.mjs.map

@@ -1 +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"}
+{"version":3,"file":"files.mjs","sourceRoot":"","sources":["../../src/resources/agents/files.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,aAAa,EAAyC;OAExD,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,UAAU,CAAC,IAAI,CAAA,cAAc,OAAO,QAAQ,EAAE,CAAA,aAA+B,CAAA,EAAE;YACjG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,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

@@ -1,30 +1,92 @@
 import { APIResource } from "../../core/resource.mjs";
 import * as AgentsAPI from "./agents.mjs";
-import * as SourcesAPI from "../sources/sources.mjs";
+import * as ArchivesAPI from "../archives/archives.mjs";
+import * as ModelsAPI from "../models/models.mjs";
 import { APIPromise } from "../../core/api-promise.mjs";
+import { ArrayPage, type ArrayPageParams, PagePromise } from "../../core/pagination.mjs";
 import { RequestOptions } from "../../internal/request-options.mjs";
 export declare class Folders extends APIResource {
     /**
      * Get the folders associated with an agent.
      */
-    list(agentID: string, options?: RequestOptions): APIPromise<FolderListResponse>;
+    list(agentID: string, query?: FolderListParams | null | undefined, options?: RequestOptions): PagePromise<FolderListResponsesArrayPage, FolderListResponse>;
     /**
      * Attach a folder to an agent.
      */
-    attach(folderID: string, params: FolderAttachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState>;
+    attach(folderID: string, params: FolderAttachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState | null>;
     /**
      * Detach a folder from an agent.
      */
-    detach(folderID: string, params: FolderDetachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState>;
+    detach(folderID: string, params: FolderDetachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState | null>;
+}
+export type FolderListResponsesArrayPage = ArrayPage<FolderListResponse>;
+/**
+ * (Deprecated: Use Folder) Representation of a source, which is a collection of
+ * files and passages.
+ */
+export interface FolderListResponse {
+    /**
+     * The human-friendly ID of the Source
+     */
+    id: string;
+    /**
+     * The embedding configuration used by the source.
+     */
+    embedding_config: ModelsAPI.EmbeddingConfig;
+    /**
+     * The name of the source.
+     */
+    name: 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 extends ArrayPageParams {
 }
-export type FolderListResponse = Array<SourcesAPI.Source>;
 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 FolderAttachParams as FolderAttachParams, type FolderDetachParams as FolderDetachParams, };
+    export { type FolderListResponse as FolderListResponse, type FolderListResponsesArrayPage as FolderListResponsesArrayPage, type FolderListParams as FolderListParams, type FolderAttachParams as FolderAttachParams, type FolderDetachParams as FolderDetachParams, };
 }
 //# sourceMappingURL=folders.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"folders.d.mts","sourceRoot":"","sources":["../../src/resources/agents/folders.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,SAAS;OACd,KAAK,UAAU;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAI/E;;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,UAAU,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}
+{"version":3,"file":"folders.d.mts","sourceRoot":"","sources":["../../src/resources/agents/folders.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,SAAS;OACd,KAAK,WAAW;OAChB,KAAK,SAAS;OACd,EAAE,UAAU,EAAE;OACd,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,WAAW,EAAE;OAChD,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,WAAW,CAAC,4BAA4B,EAAE,kBAAkB,CAAC;IAOhE;;OAEG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC;IAK1C;;OAEG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC;CAI3C;AAED,MAAM,MAAM,4BAA4B,GAAG,SAAS,CAAC,kBAAkB,CAAC,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,gBAAgB,EAAE,SAAS,CAAC,eAAe,CAAC;IAE5C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;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;IAE3B;;OAEG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC;CACnD;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;CAAG;AAE5D,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,4BAA4B,IAAI,4BAA4B,EACjE,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/agents/folders.d.ts

@@ -1,30 +1,92 @@
 import { APIResource } from "../../core/resource.js";
 import * as AgentsAPI from "./agents.js";
-import * as SourcesAPI from "../sources/sources.js";
+import * as ArchivesAPI from "../archives/archives.js";
+import * as ModelsAPI from "../models/models.js";
 import { APIPromise } from "../../core/api-promise.js";
+import { ArrayPage, type ArrayPageParams, PagePromise } from "../../core/pagination.js";
 import { RequestOptions } from "../../internal/request-options.js";
 export declare class Folders extends APIResource {
     /**
      * Get the folders associated with an agent.
      */
-    list(agentID: string, options?: RequestOptions): APIPromise<FolderListResponse>;
+    list(agentID: string, query?: FolderListParams | null | undefined, options?: RequestOptions): PagePromise<FolderListResponsesArrayPage, FolderListResponse>;
     /**
      * Attach a folder to an agent.
      */
-    attach(folderID: string, params: FolderAttachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState>;
+    attach(folderID: string, params: FolderAttachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState | null>;
     /**
      * Detach a folder from an agent.
      */
-    detach(folderID: string, params: FolderDetachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState>;
+    detach(folderID: string, params: FolderDetachParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState | null>;
+}
+export type FolderListResponsesArrayPage = ArrayPage<FolderListResponse>;
+/**
+ * (Deprecated: Use Folder) Representation of a source, which is a collection of
+ * files and passages.
+ */
+export interface FolderListResponse {
+    /**
+     * The human-friendly ID of the Source
+     */
+    id: string;
+    /**
+     * The embedding configuration used by the source.
+     */
+    embedding_config: ModelsAPI.EmbeddingConfig;
+    /**
+     * The name of the source.
+     */
+    name: 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 extends ArrayPageParams {
 }
-export type FolderListResponse = Array<SourcesAPI.Source>;
 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 FolderAttachParams as FolderAttachParams, type FolderDetachParams as FolderDetachParams, };
+    export { type FolderListResponse as FolderListResponse, type FolderListResponsesArrayPage as FolderListResponsesArrayPage, type FolderListParams as FolderListParams, type FolderAttachParams as FolderAttachParams, type FolderDetachParams as FolderDetachParams, };
 }
 //# sourceMappingURL=folders.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/resources/agents/folders.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,SAAS;OACd,KAAK,UAAU;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAI/E;;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,UAAU,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/resources/agents/folders.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,SAAS;OACd,KAAK,WAAW;OAChB,KAAK,SAAS;OACd,EAAE,UAAU,EAAE;OACd,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,WAAW,EAAE;OAChD,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,WAAW,CAAC,4BAA4B,EAAE,kBAAkB,CAAC;IAOhE;;OAEG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC;IAK1C;;OAEG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC;CAI3C;AAED,MAAM,MAAM,4BAA4B,GAAG,SAAS,CAAC,kBAAkB,CAAC,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,gBAAgB,EAAE,SAAS,CAAC,eAAe,CAAC;IAE5C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;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;IAE3B;;OAEG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC;CACnD;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;CAAG;AAE5D,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,4BAA4B,IAAI,4BAA4B,EACjE,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,GAC9C,CAAC;CACH"}

package/resources/agents/folders.js

@@ -3,13 +3,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Folders = 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 Folders extends resource_1.APIResource {
     /**
      * Get the folders associated with an agent.
      */
-    list(agentID, options) {
-        return this._client.get((0, path_1.path) `/v1/agents/${agentID}/folders`, options);
+    list(agentID, query = {}, options) {
+        return this._client.getAPIList((0, path_1.path) `/v1/agents/${agentID}/folders`, (pagination_1.ArrayPage), {
+            query,
+            ...options,
+        });
     }
     /**
      * Attach a folder to an agent.

package/resources/agents/folders.js.map

@@ -1 +1 @@
-{"version":3,"file":"folders.js","sourceRoot":"","sources":["../../src/resources/agents/folders.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAKlD,uDAAiD;AAEjD,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE,OAAwB;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,cAAc,OAAO,UAAU,EAAE,OAAO,CAAC,CAAC;IACxE,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;AA/BD,0BA+BC"}
+{"version":3,"file":"folders.js","sourceRoot":"","sources":["../../src/resources/agents/folders.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAKlD,yDAAqF;AAErF,uDAAiD;AAEjD,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;OAEG;IACH,IAAI,CACF,OAAe,EACf,QAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAA,WAAI,EAAA,cAAc,OAAO,UAAU,EAAE,CAAA,sBAA6B,CAAA,EAAE;YACjG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,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;AAtCD,0BAsCC"}