@llamaindex/llama-cloud 2.8.0 → 2.9.1

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]),
     });
   }
 
@@ -204,7 +204,7 @@ export interface FileUpdateResponse {
   /**
    * Merged metadata from all sources. Higher-priority sources override lower.
    */
-  metadata?: { [key: string]: string | number | boolean | Array<string> | null };
+  metadata?: { [key: string]: string | number | number | boolean | null | Array<string> };
 
   /**
    * Update datetime
@@ -264,7 +264,7 @@ export interface FileListResponse {
   /**
    * Merged metadata from all sources. Higher-priority sources override lower.
    */
-  metadata?: { [key: string]: string | number | boolean | Array<string> | null };
+  metadata?: { [key: string]: string | number | number | boolean | null | Array<string> };
 
   /**
    * Update datetime
@@ -324,7 +324,7 @@ export interface FileAddResponse {
   /**
    * Merged metadata from all sources. Higher-priority sources override lower.
    */
-  metadata?: { [key: string]: string | number | boolean | Array<string> | null };
+  metadata?: { [key: string]: string | number | number | boolean | null | Array<string> };
 
   /**
    * Update datetime
@@ -384,7 +384,7 @@ export interface FileGetResponse {
   /**
    * Merged metadata from all sources. Higher-priority sources override lower.
    */
-  metadata?: { [key: string]: string | number | boolean | Array<string> | null };
+  metadata?: { [key: string]: string | number | number | boolean | null | Array<string> };
 
   /**
    * Update datetime
@@ -444,7 +444,7 @@ export interface FileUploadResponse {
   /**
    * Merged metadata from all sources. Higher-priority sources override lower.
    */
-  metadata?: { [key: string]: string | number | boolean | Array<string> | null };
+  metadata?: { [key: string]: string | number | number | boolean | null | Array<string> };
 
   /**
    * Update datetime
@@ -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.
-   */
-  metadata?: { [key: string]: string | number | boolean | Array<string> | null } | null;
-
-  /**
-   * Body param: Move file to a different directory.
+   * Body param: User-defined metadata key-value pairs to associate with the file.
    */
-  target_directory_id?: string | null;
+  metadata?: { [key: string]: string | number | number | boolean | null | Array<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 | boolean | Array<string> | null } | null;
+  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 {

package/src/resources/beta/indexes.ts

@@ -9,39 +9,19 @@ import { path } from '../../internal/utils/path';
 
 export class Indexes extends APIResource {
   /**
-   * Create a searchable index over a source directory.
-   *
-   * @example
-   * ```ts
-   * const index = await client.beta.indexes.create({
-   *   source_directory_id: 'dir-abc123',
-   * });
-   * ```
-   */
-  create(params: IndexCreateParams, options?: RequestOptions): APIPromise<IndexCreateResponse> {
-    const { organization_id, project_id, ...body } = params;
-    return this._client.post('/api/v1/indexes', { query: { organization_id, project_id }, body, ...options });
-  }
-
-  /**
-   * List indexes for the current project.
+   * Get an index by ID.
    *
    * @example
    * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const indexListResponse of client.beta.indexes.list()) {
-   *   // ...
-   * }
+   * const index = await client.beta.indexes.get('index_id');
    * ```
    */
-  list(
-    query: IndexListParams | null | undefined = {},
+  get(
+    indexID: string,
+    query: IndexGetParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<IndexListResponsesPaginatedCursor, IndexListResponse> {
-    return this._client.getAPIList('/api/v1/indexes', PaginatedCursor<IndexListResponse>, {
-      query,
-      ...options,
-    });
+  ): APIPromise<IndexGetResponse> {
+    return this._client.get(path`/api/v1/indexes/${indexID}`, { query, ...options });
   }
 
   /**
@@ -66,19 +46,18 @@ export class Indexes extends APIResource {
   }
 
   /**
-   * Get an index by ID.
+   * Create a searchable index over a source directory.
    *
    * @example
    * ```ts
-   * const index = await client.beta.indexes.get('index_id');
+   * const index = await client.beta.indexes.create({
+   *   source_directory_id: 'dir-abc123',
+   * });
    * ```
    */
-  get(
-    indexID: string,
-    query: IndexGetParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<IndexGetResponse> {
-    return this._client.get(path`/api/v1/indexes/${indexID}`, { query, ...options });
+  create(params: IndexCreateParams, options?: RequestOptions): APIPromise<IndexCreateResponse> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.post('/api/v1/indexes', { query: { organization_id, project_id }, body, ...options });
   }
 
   /**
@@ -101,6 +80,27 @@ export class Indexes extends APIResource {
       ...options,
     });
   }
+
+  /**
+   * List indexes for the current project.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const indexListResponse of client.beta.indexes.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: IndexListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<IndexListResponsesPaginatedCursor, IndexListResponse> {
+    return this._client.getAPIList('/api/v1/indexes', PaginatedCursor<IndexListResponse>, {
+      query,
+      ...options,
+    });
+  }
 }
 
 export type IndexListResponsesPaginatedCursor = PaginatedCursor<IndexListResponse>;
@@ -302,6 +302,18 @@ export interface IndexGetResponse {
 
 export type IndexSyncResponse = unknown;
 
+export interface IndexGetParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
+export interface IndexDeleteParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
 export interface IndexCreateParams {
   /**
    * Body param: ID of the source directory containing your documents.
@@ -379,30 +391,18 @@ export namespace IndexCreateParams {
   }
 }
 
-export interface IndexListParams extends PaginatedCursorParams {
-  organization_id?: string | null;
-
-  project_id?: string | null;
-
-  source_directory_id?: string | null;
-}
-
-export interface IndexDeleteParams {
+export interface IndexSyncParams {
   organization_id?: string | null;
 
   project_id?: string | null;
 }
 
-export interface IndexGetParams {
+export interface IndexListParams extends PaginatedCursorParams {
   organization_id?: string | null;
 
   project_id?: string | null;
-}
 
-export interface IndexSyncParams {
-  organization_id?: string | null;
-
-  project_id?: string | null;
+  source_directory_id?: string | null;
 }
 
 export declare namespace Indexes {
@@ -412,10 +412,10 @@ export declare namespace Indexes {
     type IndexGetResponse as IndexGetResponse,
     type IndexSyncResponse as IndexSyncResponse,
     type IndexListResponsesPaginatedCursor as IndexListResponsesPaginatedCursor,
-    type IndexCreateParams as IndexCreateParams,
-    type IndexListParams as IndexListParams,
-    type IndexDeleteParams as IndexDeleteParams,
     type IndexGetParams as IndexGetParams,
+    type IndexDeleteParams as IndexDeleteParams,
+    type IndexCreateParams as IndexCreateParams,
     type IndexSyncParams as IndexSyncParams,
+    type IndexListParams as IndexListParams,
   };
 }

package/src/resources/beta/retrieval.ts

@@ -129,7 +129,7 @@ export namespace RetrievalRetrieveResponse {
     /**
      * User-defined metadata associated with the chunk.
      */
-    metadata?: { [key: string]: string | number | boolean | Array<string> | null } | null;
+    metadata?: { [key: string]: string | number | number | boolean | null | Array<string> } | null;
 
     /**
      * Relevance score from the reranker, if reranking was applied.
@@ -333,13 +333,13 @@ export interface RetrievalRetrieveParams {
 
 export namespace RetrievalRetrieveParams {
   export interface FilterTypeUnionStrIntBoolFloat {
-    operator: 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'in' | 'nin';
+    operator: 'eq' | 'gt' | 'gte' | 'in' | 'lt' | 'lte' | 'ne' | 'nin';
 
     value: string | boolean | number | Array<string | boolean | number>;
   }
 
   export interface UnionMember1 {
-    operator: 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'in' | 'nin';
+    operator: 'eq' | 'gt' | 'gte' | 'in' | 'lt' | 'lte' | 'ne' | 'nin';
 
     value: number | Array<number>;
   }
@@ -368,7 +368,7 @@ export namespace RetrievalRetrieveParams {
 
   export namespace StaticFilters {
     export interface ParsedDirectoryFileID {
-      operator: 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'in' | 'nin';
+      operator: 'eq' | 'gt' | 'gte' | 'in' | 'lt' | 'lte' | 'ne' | 'nin';
 
       value: string | Array<string>;
     }