@llamaindex/llama-cloud 2.9.0 → 2.10.0

package/src/resources/beta/directories/directories.ts

@@ -45,29 +45,6 @@ export class Directories extends APIResource {
     });
   }
 
-  /**
-   * Update directory metadata.
-   *
-   * @example
-   * ```ts
-   * const directory = await client.beta.directories.update(
-   *   'directory_id',
-   * );
-   * ```
-   */
-  update(
-    directoryID: string,
-    params: DirectoryUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<DirectoryUpdateResponse> {
-    const { organization_id, project_id, ...body } = params;
-    return this._client.patch(path`/api/v1/beta/directories/${directoryID}`, {
-      query: { organization_id, project_id },
-      body,
-      ...options,
-    });
-  }
-
   /**
    * List Directories
    *
@@ -90,42 +67,65 @@ export class Directories extends APIResource {
   }
 
   /**
-   * Permanently delete a directory.
+   * Retrieve a directory by its identifier.
    *
    * @example
    * ```ts
-   * await client.beta.directories.delete('directory_id');
+   * const directory = await client.beta.directories.get(
+   *   'directory_id',
+   * );
    * ```
    */
-  delete(
+  get(
     directoryID: string,
-    params: DirectoryDeleteParams | null | undefined = {},
+    query: DirectoryGetParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<void> {
-    const { organization_id, project_id } = params ?? {};
-    return this._client.delete(path`/api/v1/beta/directories/${directoryID}`, {
+  ): APIPromise<DirectoryGetResponse> {
+    return this._client.get(path`/api/v1/beta/directories/${directoryID}`, { query, ...options });
+  }
+
+  /**
+   * Update directory metadata.
+   *
+   * @example
+   * ```ts
+   * const directory = await client.beta.directories.update(
+   *   'directory_id',
+   * );
+   * ```
+   */
+  update(
+    directoryID: string,
+    params: DirectoryUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<DirectoryUpdateResponse> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.patch(path`/api/v1/beta/directories/${directoryID}`, {
       query: { organization_id, project_id },
+      body,
       ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
   /**
-   * Retrieve a directory by its identifier.
+   * Permanently delete a directory.
    *
    * @example
    * ```ts
-   * const directory = await client.beta.directories.get(
-   *   'directory_id',
-   * );
+   * await client.beta.directories.delete('directory_id');
    * ```
    */
-  get(
+  delete(
     directoryID: string,
-    query: DirectoryGetParams | null | undefined = {},
+    params: DirectoryDeleteParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<DirectoryGetResponse> {
-    return this._client.get(path`/api/v1/beta/directories/${directoryID}`, { query, ...options });
+  ): APIPromise<void> {
+    const { organization_id, project_id } = params ?? {};
+    return this._client.delete(path`/api/v1/beta/directories/${directoryID}`, {
+      query: { organization_id, project_id },
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
   }
 }
 
@@ -178,7 +178,7 @@ export interface DirectoryCreateResponse {
   /**
    * Directory type: 'user', 'index', 'ephemeral', or 'system_ephemeral'.
    */
-  type?: 'user' | 'index' | 'ephemeral' | 'system_ephemeral' | null;
+  type?: 'ephemeral' | 'index' | 'system_ephemeral' | 'user' | null;
 
   /**
    * Update datetime
@@ -233,7 +233,7 @@ export interface DirectoryUpdateResponse {
   /**
    * Directory type: 'user', 'index', 'ephemeral', or 'system_ephemeral'.
    */
-  type?: 'user' | 'index' | 'ephemeral' | 'system_ephemeral' | null;
+  type?: 'ephemeral' | 'index' | 'system_ephemeral' | 'user' | null;
 
   /**
    * Update datetime
@@ -288,7 +288,7 @@ export interface DirectoryListResponse {
   /**
    * Directory type: 'user', 'index', 'ephemeral', or 'system_ephemeral'.
    */
-  type?: 'user' | 'index' | 'ephemeral' | 'system_ephemeral' | null;
+  type?: 'ephemeral' | 'index' | 'system_ephemeral' | 'user' | null;
 
   /**
    * Update datetime
@@ -343,7 +343,7 @@ export interface DirectoryGetResponse {
   /**
    * Directory type: 'user', 'index', 'ephemeral', or 'system_ephemeral'.
    */
-  type?: 'user' | 'index' | 'ephemeral' | 'system_ephemeral' | null;
+  type?: 'ephemeral' | 'index' | 'system_ephemeral' | 'user' | null;
 
   /**
    * Update datetime
@@ -372,11 +372,6 @@ export interface DirectoryCreateParams {
    */
   description?: string | null;
 
-  /**
-   * Body param: When this directory expires. Required for ephemeral directories.
-   */
-  expires_at?: string | null;
-
   /**
    * Body param: Reserved system-managed metadata.
    */
@@ -386,50 +381,64 @@ export interface DirectoryCreateParams {
    * Body param: Directory type. Use 'ephemeral' for batch processing with automatic
    * cleanup.
    */
-  type?: 'user' | 'ephemeral';
+  type?: 'ephemeral' | 'user';
 }
 
-export interface DirectoryUpdateParams {
+export interface DirectoryListParams extends PaginatedCursorParams {
   /**
-   * Query param
+   * Include deleted directories.
    */
-  organization_id?: string | null;
+  include_deleted?: boolean;
 
   /**
-   * Query param
+   * Directory name to match.
    */
+  name?: string | null;
+
+  organization_id?: string | null;
+
   project_id?: string | null;
 
   /**
-   * Body param: Updated description for the directory.
+   * Directory type to include.
    */
-  description?: string | null;
+  type?: 'ephemeral' | 'index' | 'user' | null;
 
   /**
-   * Body param: Updated name for the directory.
+   * Filter by one or more directory types. Repeat the parameter for multiple values.
    */
-  name?: string | null;
+  types?: Array<'ephemeral' | 'index' | 'user'> | null;
 }
 
-export interface DirectoryListParams extends PaginatedCursorParams {
-  include_deleted?: boolean;
-
-  name?: string | null;
-
+export interface DirectoryGetParams {
   organization_id?: string | null;
 
   project_id?: string | null;
-
-  type?: 'user' | 'index' | 'ephemeral' | null;
 }
 
-export interface DirectoryDeleteParams {
+export interface DirectoryUpdateParams {
+  /**
+   * Query param
+   */
   organization_id?: string | null;
 
+  /**
+   * Query param
+   */
   project_id?: string | null;
+
+  /**
+   * Body param: Updated description for the directory.
+   */
+  description?: string | null;
+
+  /**
+   * Body param: Updated name for the directory.
+   */
+  name?: string | null;
 }
 
-export interface DirectoryGetParams {
+export interface DirectoryDeleteParams {
   organization_id?: string | null;
 
   project_id?: string | null;
@@ -445,10 +454,10 @@ export declare namespace Directories {
     type DirectoryGetResponse as DirectoryGetResponse,
     type DirectoryListResponsesPaginatedCursor as DirectoryListResponsesPaginatedCursor,
     type DirectoryCreateParams as DirectoryCreateParams,
-    type DirectoryUpdateParams as DirectoryUpdateParams,
     type DirectoryListParams as DirectoryListParams,
-    type DirectoryDeleteParams as DirectoryDeleteParams,
     type DirectoryGetParams as DirectoryGetParams,
+    type DirectoryUpdateParams as DirectoryUpdateParams,
+    type DirectoryDeleteParams as DirectoryDeleteParams,
   };
 
   export {
@@ -459,11 +468,11 @@ export declare namespace Directories {
     type FileGetResponse as FileGetResponse,
     type FileUploadResponse as FileUploadResponse,
     type FileListResponsesPaginatedCursor as FileListResponsesPaginatedCursor,
-    type FileUpdateParams as FileUpdateParams,
-    type FileListParams as FileListParams,
-    type FileDeleteParams as FileDeleteParams,
     type FileAddParams as FileAddParams,
+    type FileListParams as FileListParams,
     type FileGetParams as FileGetParams,
+    type FileUpdateParams as FileUpdateParams,
+    type FileDeleteParams as FileDeleteParams,
     type FileUploadParams as FileUploadParams,
   };
 }

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

@@ -12,25 +12,20 @@ import { path } from '../../../internal/utils/path';
 
 export class Files extends APIResource {
   /**
-   * Update directory-file metadata by `directory_file_id`; set `directory_id` to
-   * move the file to a different directory. To resolve from `unique_id`, list with a
-   * filter first.
+   * Create a new file within the specified directory; the directory must exist in
+   * the project and `file_id` must reference an existing file.
    *
    * @example
    * ```ts
-   * const file = await client.beta.directories.files.update(
-   *   'directory_file_id',
-   *   { directory_id: 'directory_id' },
+   * const response = await client.beta.directories.files.add(
+   *   'directory_id',
+   *   { file_id: 'file_id' },
    * );
    * ```
    */
-  update(
-    directoryFileID: string,
-    params: FileUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<FileUpdateResponse> {
-    const { directory_id, organization_id, project_id, ...body } = params;
-    return this._client.patch(path`/api/v1/beta/directories/${directory_id}/files/${directoryFileID}`, {
+  add(directoryID: string, params: FileAddParams, options?: RequestOptions): APIPromise<FileAddResponse> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.post(path`/api/v1/beta/directories/${directoryID}/files`, {
       query: { organization_id, project_id },
       body,
       ...options,
@@ -64,41 +59,45 @@ export class Files extends APIResource {
   }
 
   /**
-   * Delete a directory file by `directory_file_id`; to resolve from `unique_id`,
-   * list with a filter first.
+   * Get a directory file by `directory_file_id`; to look up by `unique_id`, use the
+   * list endpoint with a filter.
    *
    * @example
    * ```ts
-   * await client.beta.directories.files.delete(
+   * const file = await client.beta.directories.files.get(
    *   'directory_file_id',
    *   { directory_id: 'directory_id' },
    * );
    * ```
    */
-  delete(directoryFileID: string, params: FileDeleteParams, options?: RequestOptions): APIPromise<void> {
-    const { directory_id, organization_id, project_id } = params;
-    return this._client.delete(path`/api/v1/beta/directories/${directory_id}/files/${directoryFileID}`, {
-      query: { organization_id, project_id },
+  get(directoryFileID: string, params: FileGetParams, options?: RequestOptions): APIPromise<FileGetResponse> {
+    const { directory_id, ...query } = params;
+    return this._client.get(path`/api/v1/beta/directories/${directory_id}/files/${directoryFileID}`, {
+      query,
       ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
   /**
-   * Create a new file within the specified directory; the directory must exist in
-   * the project and `file_id` must reference an existing file.
+   * Update directory-file metadata by `directory_file_id`; set `directory_id` to
+   * move the file to a different directory. To resolve from `unique_id`, list with a
+   * filter first.
    *
    * @example
    * ```ts
-   * const response = await client.beta.directories.files.add(
-   *   'directory_id',
-   *   { file_id: 'file_id' },
+   * const file = await client.beta.directories.files.update(
+   *   'directory_file_id',
+   *   { directory_id: 'directory_id' },
    * );
    * ```
    */
-  add(directoryID: string, params: FileAddParams, options?: RequestOptions): APIPromise<FileAddResponse> {
-    const { organization_id, project_id, ...body } = params;
-    return this._client.post(path`/api/v1/beta/directories/${directoryID}/files`, {
+  update(
+    directoryFileID: string,
+    params: FileUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<FileUpdateResponse> {
+    const { directory_id, organization_id, project_id, ...body } = params;
+    return this._client.patch(path`/api/v1/beta/directories/${directory_id}/files/${directoryFileID}`, {
       query: { organization_id, project_id },
       body,
       ...options,
@@ -106,22 +105,23 @@ export class Files extends APIResource {
   }
 
   /**
-   * Get a directory file by `directory_file_id`; to look up by `unique_id`, use the
-   * list endpoint with a filter.
+   * Delete a directory file by `directory_file_id`; to resolve from `unique_id`,
+   * list with a filter first.
    *
    * @example
    * ```ts
-   * const file = await client.beta.directories.files.get(
+   * await client.beta.directories.files.delete(
    *   'directory_file_id',
    *   { directory_id: 'directory_id' },
    * );
    * ```
    */
-  get(directoryFileID: string, params: FileGetParams, options?: RequestOptions): APIPromise<FileGetResponse> {
-    const { directory_id, ...query } = params;
-    return this._client.get(path`/api/v1/beta/directories/${directory_id}/files/${directoryFileID}`, {
-      query,
+  delete(directoryFileID: string, params: FileDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { directory_id, organization_id, project_id } = params;
+    return this._client.delete(path`/api/v1/beta/directories/${directory_id}/files/${directoryFileID}`, {
+      query: { organization_id, project_id },
       ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
@@ -452,11 +452,11 @@ export interface FileUploadResponse {
   updated_at?: string | null;
 }
 
-export interface FileUpdateParams {
+export interface FileAddParams {
   /**
-   * Path param
+   * Body param: File ID for the storage location (required).
    */
-  directory_id: string;
+  file_id: string;
 
   /**
    * Query param
@@ -469,23 +469,19 @@ export interface FileUpdateParams {
   project_id?: string | null;
 
   /**
-   * Body param: Updated display name.
+   * Body param: Display name for the file. If not provided, will use the file's
+   * name.
    */
   display_name?: string | null;
 
   /**
-   * Body param: User-defined metadata key-value pairs. Replaces the user metadata
-   * layer.
+   * Body param: User-defined metadata key-value pairs to associate with the file.
    */
   metadata?: { [key: string]: string | number | number | boolean | null | Array<string> } | null;
 
   /**
-   * Body param: Move file to a different directory.
-   */
-  target_directory_id?: string | null;
-
-  /**
-   * Body param: Updated unique identifier.
+   * Body param: Unique identifier for the file in the directory. If not provided,
+   * will use the file's external_file_id or name.
    */
   unique_id?: string | null;
 }
@@ -521,12 +517,17 @@ export interface FileListParams extends PaginatedCursorParams {
   updated_at_on_or_before?: string | null;
 }
 
-export interface FileDeleteParams {
+export interface FileGetParams {
   /**
    * Path param
    */
   directory_id: string;
 
+  /**
+   * Query param: Fields to expand.
+   */
+  expand?: Array<string> | null;
+
   /**
    * Query param
    */
@@ -538,11 +539,11 @@ export interface FileDeleteParams {
   project_id?: string | null;
 }
 
-export interface FileAddParams {
+export interface FileUpdateParams {
   /**
-   * Body param: File ID for the storage location (required).
+   * Path param
    */
-  file_id: string;
+  directory_id: string;
 
   /**
    * Query param
@@ -555,34 +556,33 @@ export interface FileAddParams {
   project_id?: string | null;
 
   /**
-   * Body param: Display name for the file. If not provided, will use the file's
-   * name.
+   * Body param: Updated display name.
    */
   display_name?: string | null;
 
   /**
-   * Body param: User-defined metadata key-value pairs to associate with the file.
+   * Body param: User-defined metadata key-value pairs. Replaces the user metadata
+   * layer.
    */
   metadata?: { [key: string]: string | number | number | boolean | null | Array<string> } | null;
 
   /**
-   * Body param: Unique identifier for the file in the directory. If not provided,
-   * will use the file's external_file_id or name.
+   * Body param: Move file to a different directory.
+   */
+  target_directory_id?: string | null;
+
+  /**
+   * Body param: Updated unique identifier.
    */
   unique_id?: string | null;
 }
 
-export interface FileGetParams {
+export interface FileDeleteParams {
   /**
    * Path param
    */
   directory_id: string;
 
-  /**
-   * Query param: Fields to expand.
-   */
-  expand?: Array<string> | null;
-
   /**
    * Query param
    */
@@ -639,11 +639,11 @@ export declare namespace Files {
     type FileGetResponse as FileGetResponse,
     type FileUploadResponse as FileUploadResponse,
     type FileListResponsesPaginatedCursor as FileListResponsesPaginatedCursor,
-    type FileUpdateParams as FileUpdateParams,
-    type FileListParams as FileListParams,
-    type FileDeleteParams as FileDeleteParams,
     type FileAddParams as FileAddParams,
+    type FileListParams as FileListParams,
     type FileGetParams as FileGetParams,
+    type FileUpdateParams as FileUpdateParams,
+    type FileDeleteParams as FileDeleteParams,
     type FileUploadParams as FileUploadParams,
   };
 }

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

@@ -7,10 +7,10 @@ export {
   type DirectoryListResponse,
   type DirectoryGetResponse,
   type DirectoryCreateParams,
-  type DirectoryUpdateParams,
   type DirectoryListParams,
-  type DirectoryDeleteParams,
   type DirectoryGetParams,
+  type DirectoryUpdateParams,
+  type DirectoryDeleteParams,
   type DirectoryListResponsesPaginatedCursor,
 } from './directories';
 export {
@@ -20,11 +20,11 @@ export {
   type FileAddResponse,
   type FileGetResponse,
   type FileUploadResponse,
-  type FileUpdateParams,
-  type FileListParams,
-  type FileDeleteParams,
   type FileAddParams,
+  type FileListParams,
   type FileGetParams,
+  type FileUpdateParams,
+  type FileDeleteParams,
   type FileUploadParams,
   type FileListResponsesPaginatedCursor,
 } from './files';

package/src/resources/beta/index.ts

@@ -5,15 +5,15 @@ export {
   type AgentDataDeleteResponse,
   type AgentDataAggregateResponse,
   type AgentDataDeleteByQueryResponse,
-  type AgentDataCreateParams,
+  type AgentDataGetParams,
   type AgentDataUpdateParams,
   type AgentDataDeleteParams,
+  type AgentDataCreateParams,
+  type AgentDataSearchParams,
   type AgentDataAggregateParams,
   type AgentDataDeleteByQueryParams,
-  type AgentDataGetParams,
-  type AgentDataSearchParams,
-  type AgentDataAggregateResponsesPaginatedCursorPost,
   type AgentDataPaginatedCursorPost,
+  type AgentDataAggregateResponsesPaginatedCursorPost,
 } from './agent-data';
 export {
   Batch,
@@ -23,8 +23,8 @@ export {
   type BatchGetStatusResponse,
   type BatchCreateParams,
   type BatchListParams,
-  type BatchCancelParams,
   type BatchGetStatusParams,
+  type BatchCancelParams,
   type BatchListResponsesPaginatedBatchItems,
 } from './batch/index';
 export { Beta } from './beta';
@@ -35,9 +35,9 @@ export {
   type ChatListResponse,
   type ChatGetSummaryResponse,
   type ChatStreamResponse,
+  type ChatListParams,
   type ChatCreateParams,
   type ChatRetrieveParams,
-  type ChatListParams,
   type ChatDeleteParams,
   type ChatGetSummaryParams,
   type ChatStreamParams,
@@ -50,10 +50,10 @@ export {
   type DirectoryListResponse,
   type DirectoryGetResponse,
   type DirectoryCreateParams,
-  type DirectoryUpdateParams,
   type DirectoryListParams,
-  type DirectoryDeleteParams,
   type DirectoryGetParams,
+  type DirectoryUpdateParams,
+  type DirectoryDeleteParams,
   type DirectoryListResponsesPaginatedCursor,
 } from './directories/index';
 export {
@@ -62,11 +62,11 @@ export {
   type IndexListResponse,
   type IndexGetResponse,
   type IndexSyncResponse,
-  type IndexCreateParams,
-  type IndexListParams,
-  type IndexDeleteParams,
   type IndexGetParams,
+  type IndexDeleteParams,
+  type IndexCreateParams,
   type IndexSyncParams,
+  type IndexListParams,
   type IndexListResponsesPaginatedCursor,
 } from './indexes';
 export {
@@ -89,9 +89,9 @@ export {
   type SheetDeleteJobResponse,
   type SheetCreateParams,
   type SheetListParams,
-  type SheetDeleteJobParams,
   type SheetGetParams,
   type SheetGetResultTableParams,
+  type SheetDeleteJobParams,
   type SheetsJobsPaginatedCursor,
 } from './sheets';
 export {