@llamaindex/llama-cloud 2.4.1 → 2.9.0

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

@@ -29,9 +29,6 @@ export class Directories extends APIResource {
   /**
    * Create a new directory within the specified project.
    *
-   * If data_source_id is provided, validates that the data source exists and belongs
-   * to the same project.
-   *
    * @example
    * ```ts
    * const directory = await client.beta.directories.create({
@@ -158,11 +155,6 @@ export interface DirectoryCreateResponse {
    */
   created_at?: string | null;
 
-  /**
-   * Optional data source id the directory syncs from. Null if just manual uploads.
-   */
-  data_source_id?: string | null;
-
   /**
    * Optional timestamp of when the directory was deleted. Null if not deleted.
    */
@@ -173,6 +165,21 @@ export interface DirectoryCreateResponse {
    */
   description?: string | null;
 
+  /**
+   * When this directory expires and is eligible for cleanup.
+   */
+  expires_at?: string | null;
+
+  /**
+   * Reserved system-managed metadata.
+   */
+  system_metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * Directory type: 'user', 'index', 'ephemeral', or 'system_ephemeral'.
+   */
+  type?: 'user' | 'index' | 'ephemeral' | 'system_ephemeral' | null;
+
   /**
    * Update datetime
    */
@@ -203,11 +210,6 @@ export interface DirectoryUpdateResponse {
    */
   created_at?: string | null;
 
-  /**
-   * Optional data source id the directory syncs from. Null if just manual uploads.
-   */
-  data_source_id?: string | null;
-
   /**
    * Optional timestamp of when the directory was deleted. Null if not deleted.
    */
@@ -218,6 +220,21 @@ export interface DirectoryUpdateResponse {
    */
   description?: string | null;
 
+  /**
+   * When this directory expires and is eligible for cleanup.
+   */
+  expires_at?: string | null;
+
+  /**
+   * Reserved system-managed metadata.
+   */
+  system_metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * Directory type: 'user', 'index', 'ephemeral', or 'system_ephemeral'.
+   */
+  type?: 'user' | 'index' | 'ephemeral' | 'system_ephemeral' | null;
+
   /**
    * Update datetime
    */
@@ -248,11 +265,6 @@ export interface DirectoryListResponse {
    */
   created_at?: string | null;
 
-  /**
-   * Optional data source id the directory syncs from. Null if just manual uploads.
-   */
-  data_source_id?: string | null;
-
   /**
    * Optional timestamp of when the directory was deleted. Null if not deleted.
    */
@@ -263,6 +275,21 @@ export interface DirectoryListResponse {
    */
   description?: string | null;
 
+  /**
+   * When this directory expires and is eligible for cleanup.
+   */
+  expires_at?: string | null;
+
+  /**
+   * Reserved system-managed metadata.
+   */
+  system_metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * Directory type: 'user', 'index', 'ephemeral', or 'system_ephemeral'.
+   */
+  type?: 'user' | 'index' | 'ephemeral' | 'system_ephemeral' | null;
+
   /**
    * Update datetime
    */
@@ -293,11 +320,6 @@ export interface DirectoryGetResponse {
    */
   created_at?: string | null;
 
-  /**
-   * Optional data source id the directory syncs from. Null if just manual uploads.
-   */
-  data_source_id?: string | null;
-
   /**
    * Optional timestamp of when the directory was deleted. Null if not deleted.
    */
@@ -308,6 +330,21 @@ export interface DirectoryGetResponse {
    */
   description?: string | null;
 
+  /**
+   * When this directory expires and is eligible for cleanup.
+   */
+  expires_at?: string | null;
+
+  /**
+   * Reserved system-managed metadata.
+   */
+  system_metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * Directory type: 'user', 'index', 'ephemeral', or 'system_ephemeral'.
+   */
+  type?: 'user' | 'index' | 'ephemeral' | 'system_ephemeral' | null;
+
   /**
    * Update datetime
    */
@@ -331,14 +368,25 @@ export interface DirectoryCreateParams {
   project_id?: string | null;
 
   /**
-   * Body param: Optional data source id the directory syncs from.
+   * Body param: Optional description shown to users.
    */
-  data_source_id?: string | null;
+  description?: string | null;
 
   /**
-   * Body param: Optional description shown to users.
+   * Body param: When this directory expires. Required for ephemeral directories.
    */
-  description?: string | null;
+  expires_at?: string | null;
+
+  /**
+   * Body param: Reserved system-managed metadata.
+   */
+  system_metadata?: { [key: string]: unknown } | null;
+
+  /**
+   * Body param: Directory type. Use 'ephemeral' for batch processing with automatic
+   * cleanup.
+   */
+  type?: 'user' | 'ephemeral';
 }
 
 export interface DirectoryUpdateParams {
@@ -364,8 +412,6 @@ export interface DirectoryUpdateParams {
 }
 
 export interface DirectoryListParams extends PaginatedCursorParams {
-  data_source_id?: string | null;
-
   include_deleted?: boolean;
 
   name?: string | null;
@@ -373,6 +419,8 @@ export interface DirectoryListParams extends PaginatedCursorParams {
   organization_id?: string | null;
 
   project_id?: string | null;
+
+  type?: 'user' | 'index' | 'ephemeral' | null;
 }
 
 export interface DirectoryDeleteParams {

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

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../core/resource';
+import * as FilesAPI from '../../files';
 import { APIPromise } from '../../../core/api-promise';
 import { PagePromise, PaginatedCursor, type PaginatedCursorParams } from '../../../core/pagination';
 import { type Uploadable } from '../../../core/uploads';
@@ -11,19 +12,15 @@ import { path } from '../../../internal/utils/path';
 
 export class Files extends APIResource {
   /**
-   * Update file metadata within the specified directory.
-   *
-   * Supports moving files to a different directory by setting directory_id.
-   *
-   * Note: This endpoint uses directory_file_id (the internal ID). If you're trying
-   * to update a file by its unique_id, use the list endpoint with a filter to find
-   * the directory_file_id first.
+   * 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 file = await client.beta.directories.files.update(
    *   'directory_file_id',
-   *   { path_directory_id: 'directory_id' },
+   *   { directory_id: 'directory_id' },
    * );
    * ```
    */
@@ -32,8 +29,8 @@ export class Files extends APIResource {
     params: FileUpdateParams,
     options?: RequestOptions,
   ): APIPromise<FileUpdateResponse> {
-    const { path_directory_id, organization_id, project_id, ...body } = params;
-    return this._client.patch(path`/api/v1/beta/directories/${path_directory_id}/files/${directoryFileID}`, {
+    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,
@@ -67,11 +64,8 @@ export class Files extends APIResource {
   }
 
   /**
-   * Delete a file from the specified directory.
-   *
-   * Note: This endpoint uses directory_file_id (the internal ID). If you're trying
-   * to delete a file by its unique_id, use the list endpoint with a filter to find
-   * the directory_file_id first.
+   * Delete a directory file by `directory_file_id`; to resolve from `unique_id`,
+   * list with a filter first.
    *
    * @example
    * ```ts
@@ -91,10 +85,8 @@ export class Files extends APIResource {
   }
 
   /**
-   * Create a new file within the specified directory.
-   *
-   * The directory must exist and belong to the project passed in. The file_id must
-   * be provided and exist in the project.
+   * 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
@@ -114,9 +106,8 @@ export class Files extends APIResource {
   }
 
   /**
-   * Get a file by its directory_file_id within the specified directory. If you're
-   * trying to get a file by its unique_id, use the list endpoint with a filter
-   * instead.
+   * Get a directory file by `directory_file_id`; to look up by `unique_id`, use the
+   * list endpoint with a filter.
    *
    * @example
    * ```ts
@@ -135,11 +126,8 @@ export class Files extends APIResource {
   }
 
   /**
-   * Upload a file directly to a directory.
-   *
-   * Uploads a file and creates a directory file entry in a single operation. If
-   * unique_id or display_name are not provided, they will be derived from the file
-   * metadata.
+   * Upload a file and create its directory entry in one call; `unique_id` /
+   * `display_name` default to values derived from file metadata.
    *
    * @example
    * ```ts
@@ -199,14 +187,14 @@ export interface FileUpdateResponse {
   created_at?: string | null;
 
   /**
-   * Optional data source credential associated with the file.
+   * Soft delete marker when the file is removed upstream or by user action.
    */
-  data_source_id?: string | null;
+  deleted_at?: string | null;
 
   /**
-   * Soft delete marker when the file is removed upstream or by user action.
+   * Schema for a presigned URL.
    */
-  deleted_at?: string | null;
+  download_url?: FilesAPI.PresignedURL | null;
 
   /**
    * File ID for the storage location.
@@ -216,7 +204,7 @@ export interface FileUpdateResponse {
   /**
    * Merged metadata from all sources. Higher-priority sources override lower.
    */
-  metadata?: { [key: string]: string | number | boolean | null };
+  metadata?: { [key: string]: string | number | number | boolean | null | Array<string> };
 
   /**
    * Update datetime
@@ -259,14 +247,14 @@ export interface FileListResponse {
   created_at?: string | null;
 
   /**
-   * Optional data source credential associated with the file.
+   * Soft delete marker when the file is removed upstream or by user action.
    */
-  data_source_id?: string | null;
+  deleted_at?: string | null;
 
   /**
-   * Soft delete marker when the file is removed upstream or by user action.
+   * Schema for a presigned URL.
    */
-  deleted_at?: string | null;
+  download_url?: FilesAPI.PresignedURL | null;
 
   /**
    * File ID for the storage location.
@@ -276,7 +264,7 @@ export interface FileListResponse {
   /**
    * Merged metadata from all sources. Higher-priority sources override lower.
    */
-  metadata?: { [key: string]: string | number | boolean | null };
+  metadata?: { [key: string]: string | number | number | boolean | null | Array<string> };
 
   /**
    * Update datetime
@@ -319,14 +307,14 @@ export interface FileAddResponse {
   created_at?: string | null;
 
   /**
-   * Optional data source credential associated with the file.
+   * Soft delete marker when the file is removed upstream or by user action.
    */
-  data_source_id?: string | null;
+  deleted_at?: string | null;
 
   /**
-   * Soft delete marker when the file is removed upstream or by user action.
+   * Schema for a presigned URL.
    */
-  deleted_at?: string | null;
+  download_url?: FilesAPI.PresignedURL | null;
 
   /**
    * File ID for the storage location.
@@ -336,7 +324,7 @@ export interface FileAddResponse {
   /**
    * Merged metadata from all sources. Higher-priority sources override lower.
    */
-  metadata?: { [key: string]: string | number | boolean | null };
+  metadata?: { [key: string]: string | number | number | boolean | null | Array<string> };
 
   /**
    * Update datetime
@@ -379,14 +367,14 @@ export interface FileGetResponse {
   created_at?: string | null;
 
   /**
-   * Optional data source credential associated with the file.
+   * Soft delete marker when the file is removed upstream or by user action.
    */
-  data_source_id?: string | null;
+  deleted_at?: string | null;
 
   /**
-   * Soft delete marker when the file is removed upstream or by user action.
+   * Schema for a presigned URL.
    */
-  deleted_at?: string | null;
+  download_url?: FilesAPI.PresignedURL | null;
 
   /**
    * File ID for the storage location.
@@ -396,7 +384,7 @@ export interface FileGetResponse {
   /**
    * Merged metadata from all sources. Higher-priority sources override lower.
    */
-  metadata?: { [key: string]: string | number | boolean | null };
+  metadata?: { [key: string]: string | number | number | boolean | null | Array<string> };
 
   /**
    * Update datetime
@@ -439,14 +427,14 @@ export interface FileUploadResponse {
   created_at?: string | null;
 
   /**
-   * Optional data source credential associated with the file.
+   * Soft delete marker when the file is removed upstream or by user action.
    */
-  data_source_id?: string | null;
+  deleted_at?: string | null;
 
   /**
-   * Soft delete marker when the file is removed upstream or by user action.
+   * Schema for a presigned URL.
    */
-  deleted_at?: string | null;
+  download_url?: FilesAPI.PresignedURL | null;
 
   /**
    * File ID for the storage location.
@@ -456,7 +444,7 @@ export interface FileUploadResponse {
   /**
    * Merged metadata from all sources. Higher-priority sources override lower.
    */
-  metadata?: { [key: string]: string | number | boolean | null };
+  metadata?: { [key: string]: string | number | number | boolean | null | Array<string> };
 
   /**
    * Update datetime
@@ -468,7 +456,7 @@ export interface FileUpdateParams {
   /**
    * Path param
    */
-  path_directory_id: string;
+  directory_id: string;
 
   /**
    * Query param
@@ -480,11 +468,6 @@ export interface FileUpdateParams {
    */
   project_id?: string | null;
 
-  /**
-   * Body param: Move file to a different directory.
-   */
-  body_directory_id?: string | null;
-
   /**
    * Body param: Updated display name.
    */
@@ -494,7 +477,12 @@ export interface FileUpdateParams {
    * Body param: User-defined metadata key-value pairs. Replaces the user metadata
    * layer.
    */
-  metadata?: { [key: string]: string | number | boolean | null } | null;
+  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.
@@ -507,6 +495,11 @@ export interface FileListParams extends PaginatedCursorParams {
 
   display_name_contains?: string | null;
 
+  /**
+   * Fields to expand on each directory file.
+   */
+  expand?: Array<string> | null;
+
   file_id?: string | null;
 
   include_deleted?: boolean;
@@ -516,6 +509,16 @@ export interface FileListParams extends PaginatedCursorParams {
   project_id?: string | null;
 
   unique_id?: string | null;
+
+  /**
+   * Include items updated at or after this timestamp (inclusive)
+   */
+  updated_at_on_or_after?: string | null;
+
+  /**
+   * Include items updated at or before this timestamp (inclusive)
+   */
+  updated_at_on_or_before?: string | null;
 }
 
 export interface FileDeleteParams {
@@ -560,7 +563,7 @@ export interface FileAddParams {
   /**
    * Body param: User-defined metadata key-value pairs to associate with the file.
    */
-  metadata?: { [key: string]: string | number | boolean | 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,
@@ -575,6 +578,11 @@ export interface FileGetParams {
    */
   directory_id: string;
 
+  /**
+   * Query param: Fields to expand.
+   */
+  expand?: Array<string> | null;
+
   /**
    * Query param
    */
@@ -612,6 +620,11 @@ export interface FileUploadParams {
    */
   external_file_id?: string | null;
 
+  /**
+   * Body param: User metadata as a JSON object string.
+   */
+  metadata?: string | null;
+
   /**
    * Body param
    */

package/src/resources/beta/index.ts

@@ -28,6 +28,21 @@ export {
   type BatchListResponsesPaginatedBatchItems,
 } from './batch/index';
 export { Beta } from './beta';
+export {
+  Chat,
+  type ChatCreateResponse,
+  type ChatRetrieveResponse,
+  type ChatListResponse,
+  type ChatGetSummaryResponse,
+  type ChatStreamResponse,
+  type ChatCreateParams,
+  type ChatRetrieveParams,
+  type ChatListParams,
+  type ChatDeleteParams,
+  type ChatGetSummaryParams,
+  type ChatStreamParams,
+  type ChatListResponsesPaginatedCursor,
+} from './chat';
 export {
   Directories,
   type DirectoryCreateResponse,
@@ -41,6 +56,32 @@ export {
   type DirectoryGetParams,
   type DirectoryListResponsesPaginatedCursor,
 } from './directories/index';
+export {
+  Indexes,
+  type IndexCreateResponse,
+  type IndexListResponse,
+  type IndexGetResponse,
+  type IndexSyncResponse,
+  type IndexCreateParams,
+  type IndexListParams,
+  type IndexDeleteParams,
+  type IndexGetParams,
+  type IndexSyncParams,
+  type IndexListResponsesPaginatedCursor,
+} from './indexes';
+export {
+  Retrieval,
+  type RetrievalRetrieveResponse,
+  type RetrievalFindResponse,
+  type RetrievalGrepResponse,
+  type RetrievalReadResponse,
+  type RetrievalRetrieveParams,
+  type RetrievalFindParams,
+  type RetrievalGrepParams,
+  type RetrievalReadParams,
+  type RetrievalFindResponsesPaginatedCursorPost,
+  type RetrievalGrepResponsesPaginatedCursorPost,
+} from './retrieval';
 export {
   Sheets,
   type SheetsJob,