@llamaindex/llama-cloud 0.14.1

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

@@ -0,0 +1,554 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import { APIPromise } from '../../../core/api-promise';
+import {
+  PagePromise,
+  PaginatedClassifyJobs,
+  type PaginatedClassifyJobsParams,
+} from '../../../core/pagination';
+import { type Uploadable } from '../../../core/uploads';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { multipartFormRequestOptions } from '../../../internal/uploads';
+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(
+    directoryFileID: string,
+    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}`, {
+      query: { organization_id, project_id },
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * List all files within the specified directory with optional filtering and
+   * pagination.
+   */
+  list(
+    directoryID: string,
+    query: FileListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<FileListResponsesPaginatedClassifyJobs, FileListResponse> {
+    return this._client.getAPIList(
+      path`/api/v1/beta/directories/${directoryID}/files`,
+      PaginatedClassifyJobs<FileListResponse>,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * 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(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]),
+    });
+  }
+
+  /**
+   * 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.
+   */
+  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,
+    });
+  }
+
+  /**
+   * 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(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,
+    });
+  }
+
+  /**
+   * 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(
+    directoryID: string,
+    params: FileUploadParams,
+    options?: RequestOptions,
+  ): APIPromise<FileUploadResponse> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.post(
+      path`/api/v1/beta/directories/${directoryID}/files/upload`,
+      multipartFormRequestOptions({ query: { organization_id, project_id }, body, ...options }, this._client),
+    );
+  }
+}
+
+export type FileListResponsesPaginatedClassifyJobs = PaginatedClassifyJobs<FileListResponse>;
+
+/**
+ * API response schema for a directory file.
+ */
+export interface FileUpdateResponse {
+  /**
+   * Unique identifier for the directory file.
+   */
+  id: string;
+
+  /**
+   * Directory the file belongs to.
+   */
+  directory_id: string;
+
+  /**
+   * Display name for the file.
+   */
+  display_name: string;
+
+  /**
+   * Project the directory file belongs to.
+   */
+  project_id: string;
+
+  /**
+   * Unique identifier for the file in the directory
+   */
+  unique_id: string;
+
+  /**
+   * Creation datetime
+   */
+  created_at?: string | null;
+
+  /**
+   * Optional data source credential associated with the file.
+   */
+  data_source_id?: string | null;
+
+  /**
+   * Soft delete marker when the file is removed upstream or by user action.
+   */
+  deleted_at?: string | null;
+
+  /**
+   * File ID for the storage location.
+   */
+  file_id?: string | null;
+
+  /**
+   * Update datetime
+   */
+  updated_at?: string | null;
+}
+
+/**
+ * API response schema for a directory file.
+ */
+export interface FileListResponse {
+  /**
+   * Unique identifier for the directory file.
+   */
+  id: string;
+
+  /**
+   * Directory the file belongs to.
+   */
+  directory_id: string;
+
+  /**
+   * Display name for the file.
+   */
+  display_name: string;
+
+  /**
+   * Project the directory file belongs to.
+   */
+  project_id: string;
+
+  /**
+   * Unique identifier for the file in the directory
+   */
+  unique_id: string;
+
+  /**
+   * Creation datetime
+   */
+  created_at?: string | null;
+
+  /**
+   * Optional data source credential associated with the file.
+   */
+  data_source_id?: string | null;
+
+  /**
+   * Soft delete marker when the file is removed upstream or by user action.
+   */
+  deleted_at?: string | null;
+
+  /**
+   * File ID for the storage location.
+   */
+  file_id?: string | null;
+
+  /**
+   * Update datetime
+   */
+  updated_at?: string | null;
+}
+
+/**
+ * API response schema for a directory file.
+ */
+export interface FileAddResponse {
+  /**
+   * Unique identifier for the directory file.
+   */
+  id: string;
+
+  /**
+   * Directory the file belongs to.
+   */
+  directory_id: string;
+
+  /**
+   * Display name for the file.
+   */
+  display_name: string;
+
+  /**
+   * Project the directory file belongs to.
+   */
+  project_id: string;
+
+  /**
+   * Unique identifier for the file in the directory
+   */
+  unique_id: string;
+
+  /**
+   * Creation datetime
+   */
+  created_at?: string | null;
+
+  /**
+   * Optional data source credential associated with the file.
+   */
+  data_source_id?: string | null;
+
+  /**
+   * Soft delete marker when the file is removed upstream or by user action.
+   */
+  deleted_at?: string | null;
+
+  /**
+   * File ID for the storage location.
+   */
+  file_id?: string | null;
+
+  /**
+   * Update datetime
+   */
+  updated_at?: string | null;
+}
+
+/**
+ * API response schema for a directory file.
+ */
+export interface FileGetResponse {
+  /**
+   * Unique identifier for the directory file.
+   */
+  id: string;
+
+  /**
+   * Directory the file belongs to.
+   */
+  directory_id: string;
+
+  /**
+   * Display name for the file.
+   */
+  display_name: string;
+
+  /**
+   * Project the directory file belongs to.
+   */
+  project_id: string;
+
+  /**
+   * Unique identifier for the file in the directory
+   */
+  unique_id: string;
+
+  /**
+   * Creation datetime
+   */
+  created_at?: string | null;
+
+  /**
+   * Optional data source credential associated with the file.
+   */
+  data_source_id?: string | null;
+
+  /**
+   * Soft delete marker when the file is removed upstream or by user action.
+   */
+  deleted_at?: string | null;
+
+  /**
+   * File ID for the storage location.
+   */
+  file_id?: string | null;
+
+  /**
+   * Update datetime
+   */
+  updated_at?: string | null;
+}
+
+/**
+ * API response schema for a directory file.
+ */
+export interface FileUploadResponse {
+  /**
+   * Unique identifier for the directory file.
+   */
+  id: string;
+
+  /**
+   * Directory the file belongs to.
+   */
+  directory_id: string;
+
+  /**
+   * Display name for the file.
+   */
+  display_name: string;
+
+  /**
+   * Project the directory file belongs to.
+   */
+  project_id: string;
+
+  /**
+   * Unique identifier for the file in the directory
+   */
+  unique_id: string;
+
+  /**
+   * Creation datetime
+   */
+  created_at?: string | null;
+
+  /**
+   * Optional data source credential associated with the file.
+   */
+  data_source_id?: string | null;
+
+  /**
+   * Soft delete marker when the file is removed upstream or by user action.
+   */
+  deleted_at?: string | null;
+
+  /**
+   * File ID for the storage location.
+   */
+  file_id?: string | null;
+
+  /**
+   * Update datetime
+   */
+  updated_at?: string | null;
+}
+
+export interface FileUpdateParams {
+  /**
+   * Path param
+   */
+  path_directory_id: string;
+
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+
+  /**
+   * Body param: Move file to a different directory.
+   */
+  body_directory_id?: string | null;
+
+  /**
+   * Body param: Updated display name.
+   */
+  display_name?: string | null;
+
+  /**
+   * Body param: Updated unique identifier.
+   */
+  unique_id?: string | null;
+}
+
+export interface FileListParams extends PaginatedClassifyJobsParams {
+  display_name?: string | null;
+
+  display_name_contains?: string | null;
+
+  file_id?: string | null;
+
+  include_deleted?: boolean;
+
+  organization_id?: string | null;
+
+  project_id?: string | null;
+
+  unique_id?: string | null;
+}
+
+export interface FileDeleteParams {
+  /**
+   * Path param
+   */
+  directory_id: string;
+
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+}
+
+export interface FileAddParams {
+  /**
+   * Body param: File ID for the storage location (required).
+   */
+  file_id: string;
+
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+
+  /**
+   * Body param: Display name for the file. If not provided, will use the file's
+   * name.
+   */
+  display_name?: 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.
+   */
+  unique_id?: string | null;
+}
+
+export interface FileGetParams {
+  /**
+   * Path param
+   */
+  directory_id: string;
+
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+}
+
+export interface FileUploadParams {
+  /**
+   * Body param
+   */
+  upload_file: Uploadable;
+
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+
+  /**
+   * Body param
+   */
+  display_name?: string | null;
+
+  /**
+   * Body param
+   */
+  external_file_id?: string | null;
+
+  /**
+   * Body param
+   */
+  unique_id?: string | null;
+}
+
+export declare namespace Files {
+  export {
+    type FileUpdateResponse as FileUpdateResponse,
+    type FileListResponse as FileListResponse,
+    type FileAddResponse as FileAddResponse,
+    type FileGetResponse as FileGetResponse,
+    type FileUploadResponse as FileUploadResponse,
+    type FileListResponsesPaginatedClassifyJobs as FileListResponsesPaginatedClassifyJobs,
+    type FileUpdateParams as FileUpdateParams,
+    type FileListParams as FileListParams,
+    type FileDeleteParams as FileDeleteParams,
+    type FileAddParams as FileAddParams,
+    type FileGetParams as FileGetParams,
+    type FileUploadParams as FileUploadParams,
+  };
+}

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

@@ -0,0 +1,30 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Directories,
+  type DirectoryCreateResponse,
+  type DirectoryUpdateResponse,
+  type DirectoryListResponse,
+  type DirectoryGetResponse,
+  type DirectoryCreateParams,
+  type DirectoryUpdateParams,
+  type DirectoryListParams,
+  type DirectoryDeleteParams,
+  type DirectoryGetParams,
+  type DirectoryListResponsesPaginatedClassifyJobs,
+} from './directories';
+export {
+  Files,
+  type FileUpdateResponse,
+  type FileListResponse,
+  type FileAddResponse,
+  type FileGetResponse,
+  type FileUploadResponse,
+  type FileUpdateParams,
+  type FileListParams,
+  type FileDeleteParams,
+  type FileAddParams,
+  type FileGetParams,
+  type FileUploadParams,
+  type FileListResponsesPaginatedClassifyJobs,
+} from './files';

package/src/resources/beta/directories.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './directories/index';

package/src/resources/beta/index.ts

@@ -0,0 +1,79 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  AgentData,
+  type AgentDataDeleteResponse,
+  type AgentDataAggregateResponse,
+  type AgentDataDeleteByQueryResponse,
+  type AgentDataSearchResponse,
+  type AgentDataUpdateParams,
+  type AgentDataDeleteParams,
+  type AgentDataAgentDataParams,
+  type AgentDataAggregateParams,
+  type AgentDataDeleteByQueryParams,
+  type AgentDataGetParams,
+  type AgentDataSearchParams,
+} from './agent-data';
+export {
+  Batch,
+  type BatchCreateResponse,
+  type BatchListResponse,
+  type BatchCancelResponse,
+  type BatchGetStatusResponse,
+  type BatchCreateParams,
+  type BatchListParams,
+  type BatchCancelParams,
+  type BatchGetStatusParams,
+  type BatchListResponsesPaginatedBatchItems,
+} from './batch/index';
+export { Beta } from './beta';
+export {
+  Directories,
+  type DirectoryCreateResponse,
+  type DirectoryUpdateResponse,
+  type DirectoryListResponse,
+  type DirectoryGetResponse,
+  type DirectoryCreateParams,
+  type DirectoryUpdateParams,
+  type DirectoryListParams,
+  type DirectoryDeleteParams,
+  type DirectoryGetParams,
+  type DirectoryListResponsesPaginatedClassifyJobs,
+} from './directories/index';
+export {
+  ParseConfigurations,
+  type ParseConfiguration,
+  type ParseConfigurationCreate,
+  type ParseConfigurationQueryResponse,
+  type ParseConfigurationUpdateParams,
+  type ParseConfigurationDeleteParams,
+  type ParseConfigurationGetParams,
+  type ParseConfigurationGetParseConfigurationsParams,
+  type ParseConfigurationParseConfigurationsParams,
+} from './parse-configurations';
+export {
+  Sheets,
+  type SheetsJob,
+  type SheetsParsingConfig,
+  type SheetDeleteJobResponse,
+  type SheetCreateParams,
+  type SheetListParams,
+  type SheetDeleteJobParams,
+  type SheetGetParams,
+  type SheetGetResultTableParams,
+  type SheetsJobsPaginatedClassifyJobs,
+} from './sheets';
+export {
+  Split,
+  type SplitCategory,
+  type SplitDocumentInput,
+  type SplitResultResponse,
+  type SplitSegmentResponse,
+  type SplitCreateResponse,
+  type SplitListResponse,
+  type SplitGetResponse,
+  type SplitCreateParams,
+  type SplitListParams,
+  type SplitGetParams,
+  type SplitListResponsesPaginatedClassifyJobs,
+} from './split';