@llamaindex/llama-cloud 1.8.0 → 2.1.0

package/src/resources/extraction/extraction-agents/extraction-agents.ts

@@ -1,196 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { APIResource } from '../../../core/resource';
-import * as RunsAPI from '../runs';
-import * as SchemaAPI from './schema';
-import {
-  Schema,
-  SchemaGenerateSchemaParams,
-  SchemaGenerateSchemaResponse,
-  SchemaValidateSchemaParams,
-  SchemaValidateSchemaResponse,
-} from './schema';
-import { APIPromise } from '../../../core/api-promise';
-import { RequestOptions } from '../../../internal/request-options';
-import { path } from '../../../internal/utils/path';
-
-export class ExtractionAgents extends APIResource {
-  schema: SchemaAPI.Schema = new SchemaAPI.Schema(this._client);
-
-  /**
-   * Create Extraction Agent
-   */
-  create(params: ExtractionAgentCreateParams, options?: RequestOptions): APIPromise<ExtractAgent> {
-    const { organization_id, project_id, ...body } = params;
-    return this._client.post('/api/v1/extraction/extraction-agents', {
-      query: { organization_id, project_id },
-      body,
-      ...options,
-    });
-  }
-
-  /**
-   * Update Extraction Agent
-   */
-  update(
-    extractionAgentID: string,
-    body: ExtractionAgentUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<ExtractAgent> {
-    return this._client.put(path`/api/v1/extraction/extraction-agents/${extractionAgentID}`, {
-      body,
-      ...options,
-    });
-  }
-
-  /**
-   * List Extraction Agents
-   */
-  list(
-    query: ExtractionAgentListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ExtractionAgentListResponse> {
-    return this._client.get('/api/v1/extraction/extraction-agents', { query, ...options });
-  }
-
-  /**
-   * Delete Extraction Agent
-   */
-  delete(extractionAgentID: string, options?: RequestOptions): APIPromise<unknown> {
-    return this._client.delete(path`/api/v1/extraction/extraction-agents/${extractionAgentID}`, options);
-  }
-
-  /**
-   * Get Extraction Agent
-   */
-  get(extractionAgentID: string, options?: RequestOptions): APIPromise<ExtractAgent> {
-    return this._client.get(path`/api/v1/extraction/extraction-agents/${extractionAgentID}`, options);
-  }
-}
-
-/**
- * Schema and configuration for an extraction agent.
- */
-export interface ExtractAgent {
-  /**
-   * The id of the extraction agent.
-   */
-  id: string;
-
-  /**
-   * The configuration parameters for the extraction agent.
-   */
-  config: RunsAPI.ExtractConfig;
-
-  /**
-   * The schema of the data.
-   */
-  data_schema: {
-    [key: string]: { [key: string]: unknown } | Array<unknown> | string | number | boolean | null;
-  };
-
-  /**
-   * The name of the extraction agent.
-   */
-  name: string;
-
-  /**
-   * The ID of the project that the extraction agent belongs to.
-   */
-  project_id: string;
-
-  /**
-   * The creation time of the extraction agent.
-   */
-  created_at?: string | null;
-
-  /**
-   * Custom configuration type for the extraction agent. Currently supports
-   * 'default'.
-   */
-  custom_configuration?: 'default' | null;
-
-  /**
-   * The last update time of the extraction agent.
-   */
-  updated_at?: string | null;
-}
-
-export type ExtractionAgentListResponse = Array<ExtractAgent>;
-
-export type ExtractionAgentDeleteResponse = unknown;
-
-export interface ExtractionAgentCreateParams {
-  /**
-   * Body param: The configuration parameters for the extraction agent.
-   */
-  config: RunsAPI.ExtractConfig;
-
-  /**
-   * Body param: The schema of the data.
-   */
-  data_schema:
-    | { [key: string]: { [key: string]: unknown } | Array<unknown> | string | number | boolean | null }
-    | string;
-
-  /**
-   * Body param: The name of the extraction schema
-   */
-  name: string;
-
-  /**
-   * Query param
-   */
-  organization_id?: string | null;
-
-  /**
-   * Query param
-   */
-  project_id?: string | null;
-}
-
-export interface ExtractionAgentUpdateParams {
-  /**
-   * The configuration parameters for the extraction agent.
-   */
-  config: RunsAPI.ExtractConfig;
-
-  /**
-   * The schema of the data
-   */
-  data_schema:
-    | { [key: string]: { [key: string]: unknown } | Array<unknown> | string | number | boolean | null }
-    | string;
-}
-
-export interface ExtractionAgentListParams {
-  /**
-   * Whether to include default agents in the results
-   */
-  include_default?: boolean;
-
-  organization_id?: string | null;
-
-  project_id?: string | null;
-}
-
-ExtractionAgents.Schema = Schema;
-
-export declare namespace ExtractionAgents {
-  export {
-    type ExtractAgent as ExtractAgent,
-    type ExtractionAgentListResponse as ExtractionAgentListResponse,
-    type ExtractionAgentDeleteResponse as ExtractionAgentDeleteResponse,
-    type ExtractionAgentCreateParams as ExtractionAgentCreateParams,
-    type ExtractionAgentUpdateParams as ExtractionAgentUpdateParams,
-    type ExtractionAgentListParams as ExtractionAgentListParams,
-  };
-
-  export {
-    Schema as Schema,
-    type SchemaGenerateSchemaResponse as SchemaGenerateSchemaResponse,
-    type SchemaValidateSchemaResponse as SchemaValidateSchemaResponse,
-    type SchemaGenerateSchemaParams as SchemaGenerateSchemaParams,
-    type SchemaValidateSchemaParams as SchemaValidateSchemaParams,
-  };
-}

package/src/resources/extraction/extraction-agents/index.ts

@@ -1,18 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-export {
-  ExtractionAgents,
-  type ExtractAgent,
-  type ExtractionAgentListResponse,
-  type ExtractionAgentDeleteResponse,
-  type ExtractionAgentCreateParams,
-  type ExtractionAgentUpdateParams,
-  type ExtractionAgentListParams,
-} from './extraction-agents';
-export {
-  Schema,
-  type SchemaGenerateSchemaResponse,
-  type SchemaValidateSchemaResponse,
-  type SchemaGenerateSchemaParams,
-  type SchemaValidateSchemaParams,
-} from './schema';

package/src/resources/extraction/extraction-agents/schema.ts

@@ -1,100 +0,0 @@
-// 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 { RequestOptions } from '../../../internal/request-options';
-
-export class Schema extends APIResource {
-  /**
-   * Generates or refines an extraction agent's schema definition from a file,
-   * natural language prompt, or existing schema.
-   */
-  generateSchema(
-    params: SchemaGenerateSchemaParams,
-    options?: RequestOptions,
-  ): APIPromise<SchemaGenerateSchemaResponse> {
-    const { organization_id, project_id, ...body } = params;
-    return this._client.post('/api/v1/extraction/extraction-agents/schema/generate', {
-      query: { organization_id, project_id },
-      body,
-      ...options,
-    });
-  }
-
-  /**
-   * Validates an extraction agent's schema definition. Returns the normalized and
-   * validated schema if valid, otherwise raises an HTTP 400.
-   */
-  validateSchema(
-    body: SchemaValidateSchemaParams,
-    options?: RequestOptions,
-  ): APIPromise<SchemaValidateSchemaResponse> {
-    return this._client.post('/api/v1/extraction/extraction-agents/schema/validation', { body, ...options });
-  }
-}
-
-/**
- * Response schema for schema generation.
- */
-export interface SchemaGenerateSchemaResponse {
-  /**
-   * The generated JSON schema
-   */
-  data_schema: {
-    [key: string]: { [key: string]: unknown } | Array<unknown> | string | number | boolean | null;
-  };
-}
-
-/**
- * Response schema for schema validation.
- */
-export interface SchemaValidateSchemaResponse {
-  data_schema: {
-    [key: string]: { [key: string]: unknown } | Array<unknown> | string | number | boolean | null;
-  };
-}
-
-export interface SchemaGenerateSchemaParams {
-  /**
-   * Query param
-   */
-  organization_id?: string | null;
-
-  /**
-   * Query param
-   */
-  project_id?: string | null;
-
-  /**
-   * Body param: Optional schema to validate, refine, or extend during generation
-   */
-  data_schema?:
-    | { [key: string]: { [key: string]: unknown } | Array<unknown> | string | number | boolean | null }
-    | string
-    | null;
-
-  /**
-   * Body param: Optional file ID to analyze for schema generation
-   */
-  file_id?: string | null;
-
-  /**
-   * Body param: Natural language description of the data structure to extract
-   */
-  prompt?: string | null;
-}
-
-export interface SchemaValidateSchemaParams {
-  data_schema:
-    | { [key: string]: { [key: string]: unknown } | Array<unknown> | string | number | boolean | null }
-    | string;
-}
-
-export declare namespace Schema {
-  export {
-    type SchemaGenerateSchemaResponse as SchemaGenerateSchemaResponse,
-    type SchemaValidateSchemaResponse as SchemaValidateSchemaResponse,
-    type SchemaGenerateSchemaParams as SchemaGenerateSchemaParams,
-    type SchemaValidateSchemaParams as SchemaValidateSchemaParams,
-  };
-}

package/src/resources/extraction/extraction-agents.ts

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

package/src/resources/extraction/extraction.ts

@@ -1,224 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { APIResource } from '../../core/resource';
-import * as JobsAPI from './jobs';
-import {
-  ExtractJob,
-  JobCreateParams,
-  JobFileParams,
-  JobGetResultParams,
-  JobGetResultResponse,
-  JobListParams,
-  JobListResponse,
-  Jobs,
-  WebhookConfiguration,
-} from './jobs';
-import * as RunsAPI from './runs';
-import {
-  ExtractConfig,
-  ExtractRun,
-  ExtractRunsPaginatedExtractRuns,
-  RunDeleteParams,
-  RunDeleteResponse,
-  RunGetByJobParams,
-  RunGetParams,
-  RunListParams,
-  Runs,
-} from './runs';
-import * as ExtractionAgentsAPI from './extraction-agents/extraction-agents';
-import {
-  ExtractAgent,
-  ExtractionAgentCreateParams,
-  ExtractionAgentDeleteResponse,
-  ExtractionAgentListParams,
-  ExtractionAgentListResponse,
-  ExtractionAgentUpdateParams,
-  ExtractionAgents,
-} from './extraction-agents/extraction-agents';
-import { APIPromise } from '../../core/api-promise';
-import { RequestOptions } from '../../internal/request-options';
-import { PollingOptions, DEFAULT_TIMEOUT } from '../../core/polling';
-
-export class Extraction extends APIResource {
-  jobs: JobsAPI.Jobs = new JobsAPI.Jobs(this._client);
-  runs: RunsAPI.Runs = new RunsAPI.Runs(this._client);
-  extractionAgents: ExtractionAgentsAPI.ExtractionAgents = new ExtractionAgentsAPI.ExtractionAgents(
-    this._client,
-  );
-
-  /**
-   * Stateless extraction endpoint that uses a default extraction agent in the user's
-   * default project. Requires data_schema, config, and either file_id, text, or
-   * base64 encoded file data.
-   */
-  run(params: ExtractionRunParams, options?: RequestOptions): APIPromise<JobsAPI.ExtractJob> {
-    const { organization_id, project_id, ...body } = params;
-    return this._client.post('/api/v1/extraction/run', {
-      query: { organization_id, project_id },
-      body,
-      ...options,
-    });
-  }
-
-  /**
-   * Run a stateless extraction and wait for it to complete, returning the result.
-   *
-   * This is a convenience method that combines run(), waitForCompletion(),
-   * and getResult() into a single call for the most common end-to-end workflow.
-   *
-   * This endpoint uses a default extraction agent in the user's default project.
-   *
-   * @param params - Extraction parameters
-   * @param options - Polling configuration and request options
-   * @returns The extraction result (JobGetResultResponse)
-   * @throws {PollingTimeoutError} If the job doesn't complete within the timeout period
-   * @throws {PollingError} If the job fails or is cancelled
-   *
-   * @example
-   * ```typescript
-   * import { LlamaCloud } from 'llama-cloud';
-   *
-   * const client = new LlamaCloud({ apiKey: '...' });
-   *
-   * // One-shot: run stateless extraction, wait for completion, and get result
-   * const result = await client.extraction.extract({
-   *   config: {
-   *     chunk_mode: 'PAGE',
-   *     cite_sources: true,
-   *     extraction_target: 'PER_DOC',
-   *     extraction_mode: 'BALANCED'
-   *   },
-   *   data_schema: { model_names: { type: 'array', items: { type: 'string' } } },
-   *   file_id: 'file_id'
-   * }, { verbose: true });
-   *
-   * // Result is ready to use immediately
-   * console.log(result.data);
-   * ```
-   */
-  async extract(
-    params: ExtractionRunParams,
-    options?: PollingOptions & RequestOptions,
-  ): Promise<JobsAPI.JobGetResultResponse> {
-    const { pollingInterval, maxInterval, timeout, backoff, verbose, ...requestOptions } = options || {};
-
-    // Run the extraction job
-    const job = await this.run(params, requestOptions);
-
-    // Wait for completion
-    await this.jobs.waitForCompletion(job.id, {
-      pollingInterval,
-      maxInterval,
-      timeout: timeout || DEFAULT_TIMEOUT,
-      backoff,
-      verbose,
-      ...requestOptions,
-    });
-
-    // Get and return the result
-    return await this.jobs.getResult(job.id, {}, requestOptions);
-  }
-}
-
-export interface ExtractionRunParams {
-  /**
-   * Body param: The configuration parameters for the extraction
-   */
-  config: RunsAPI.ExtractConfig;
-
-  /**
-   * Body param: The schema of the data to extract
-   */
-  data_schema:
-    | { [key: string]: { [key: string]: unknown } | Array<unknown> | string | number | boolean | null }
-    | string;
-
-  /**
-   * Query param
-   */
-  organization_id?: string | null;
-
-  /**
-   * Query param
-   */
-  project_id?: string | null;
-
-  /**
-   * Body param: Schema for file data with base64 content and MIME type.
-   */
-  file?: ExtractionRunParams.File | null;
-
-  /**
-   * Body param: The ID of the file to extract from
-   */
-  file_id?: string | null;
-
-  /**
-   * Body param: The text content to extract from
-   */
-  text?: string | null;
-
-  /**
-   * Body param: The outbound webhook configurations
-   */
-  webhook_configurations?: Array<JobsAPI.WebhookConfiguration> | null;
-}
-
-export namespace ExtractionRunParams {
-  /**
-   * Schema for file data with base64 content and MIME type.
-   */
-  export interface File {
-    /**
-     * The file content as base64-encoded string
-     */
-    data: string;
-
-    /**
-     * The MIME type of the file (e.g., 'application/pdf', 'text/plain')
-     */
-    mime_type: string;
-  }
-}
-
-Extraction.Jobs = Jobs;
-Extraction.Runs = Runs;
-Extraction.ExtractionAgents = ExtractionAgents;
-
-export declare namespace Extraction {
-  export { type ExtractionRunParams as ExtractionRunParams };
-
-  export {
-    Jobs as Jobs,
-    type ExtractJob as ExtractJob,
-    type WebhookConfiguration as WebhookConfiguration,
-    type JobListResponse as JobListResponse,
-    type JobGetResultResponse as JobGetResultResponse,
-    type JobCreateParams as JobCreateParams,
-    type JobListParams as JobListParams,
-    type JobFileParams as JobFileParams,
-    type JobGetResultParams as JobGetResultParams,
-  };
-
-  export {
-    Runs as Runs,
-    type ExtractConfig as ExtractConfig,
-    type ExtractRun as ExtractRun,
-    type RunDeleteResponse as RunDeleteResponse,
-    type ExtractRunsPaginatedExtractRuns as ExtractRunsPaginatedExtractRuns,
-    type RunListParams as RunListParams,
-    type RunDeleteParams as RunDeleteParams,
-    type RunGetParams as RunGetParams,
-    type RunGetByJobParams as RunGetByJobParams,
-  };
-
-  export {
-    ExtractionAgents as ExtractionAgents,
-    type ExtractAgent as ExtractAgent,
-    type ExtractionAgentListResponse as ExtractionAgentListResponse,
-    type ExtractionAgentDeleteResponse as ExtractionAgentDeleteResponse,
-    type ExtractionAgentCreateParams as ExtractionAgentCreateParams,
-    type ExtractionAgentUpdateParams as ExtractionAgentUpdateParams,
-    type ExtractionAgentListParams as ExtractionAgentListParams,
-  };
-}

package/src/resources/extraction/index.ts

@@ -1,34 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-export { Extraction, type ExtractionRunParams } from './extraction';
-export {
-  ExtractionAgents,
-  type ExtractAgent,
-  type ExtractionAgentListResponse,
-  type ExtractionAgentDeleteResponse,
-  type ExtractionAgentCreateParams,
-  type ExtractionAgentUpdateParams,
-  type ExtractionAgentListParams,
-} from './extraction-agents/index';
-export {
-  Jobs,
-  type ExtractJob,
-  type WebhookConfiguration,
-  type JobListResponse,
-  type JobGetResultResponse,
-  type JobCreateParams,
-  type JobListParams,
-  type JobFileParams,
-  type JobGetResultParams,
-} from './jobs';
-export {
-  Runs,
-  type ExtractConfig,
-  type ExtractRun,
-  type RunDeleteResponse,
-  type RunListParams,
-  type RunDeleteParams,
-  type RunGetParams,
-  type RunGetByJobParams,
-  type ExtractRunsPaginatedExtractRuns,
-} from './runs';