@llamaindex/llama-cloud 2.4.1 → 2.9.0

package/src/resources/beta/beta.ts

@@ -17,6 +17,50 @@ import {
   AgentDataSearchParams,
   AgentDataUpdateParams,
 } from './agent-data';
+import * as ChatAPI from './chat';
+import {
+  Chat,
+  ChatCreateParams,
+  ChatCreateResponse,
+  ChatDeleteParams,
+  ChatGetSummaryParams,
+  ChatGetSummaryResponse,
+  ChatListParams,
+  ChatListResponse,
+  ChatListResponsesPaginatedCursor,
+  ChatRetrieveParams,
+  ChatRetrieveResponse,
+  ChatStreamParams,
+  ChatStreamResponse,
+} from './chat';
+import * as IndexesAPI from './indexes';
+import {
+  IndexCreateParams,
+  IndexCreateResponse,
+  IndexDeleteParams,
+  IndexGetParams,
+  IndexGetResponse,
+  IndexListParams,
+  IndexListResponse,
+  IndexListResponsesPaginatedCursor,
+  IndexSyncParams,
+  IndexSyncResponse,
+  Indexes,
+} from './indexes';
+import * as RetrievalAPI from './retrieval';
+import {
+  Retrieval,
+  RetrievalFindParams,
+  RetrievalFindResponse,
+  RetrievalFindResponsesPaginatedCursorPost,
+  RetrievalGrepParams,
+  RetrievalGrepResponse,
+  RetrievalGrepResponsesPaginatedCursorPost,
+  RetrievalReadParams,
+  RetrievalReadResponse,
+  RetrievalRetrieveParams,
+  RetrievalRetrieveResponse,
+} from './retrieval';
 import * as SheetsAPI from './sheets';
 import {
   SheetCreateParams,
@@ -74,6 +118,9 @@ import {
 } from './directories/directories';
 
 export class Beta extends APIResource {
+  indexes: IndexesAPI.Indexes = new IndexesAPI.Indexes(this._client);
+  retrieval: RetrievalAPI.Retrieval = new RetrievalAPI.Retrieval(this._client);
+  chat: ChatAPI.Chat = new ChatAPI.Chat(this._client);
   agentData: AgentDataAPI.AgentData = new AgentDataAPI.AgentData(this._client);
   sheets: SheetsAPI.Sheets = new SheetsAPI.Sheets(this._client);
   directories: DirectoriesAPI.Directories = new DirectoriesAPI.Directories(this._client);
@@ -81,12 +128,59 @@ export class Beta extends APIResource {
   split: SplitAPI.Split = new SplitAPI.Split(this._client);
 }
 
+Beta.Indexes = Indexes;
+Beta.Retrieval = Retrieval;
+Beta.Chat = Chat;
 Beta.Sheets = Sheets;
 Beta.Directories = Directories;
 Beta.Batch = Batch;
 Beta.Split = Split;
 
 export declare namespace Beta {
+  export {
+    Indexes as Indexes,
+    type IndexCreateResponse as IndexCreateResponse,
+    type IndexListResponse as IndexListResponse,
+    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 IndexSyncParams as IndexSyncParams,
+  };
+
+  export {
+    Retrieval as Retrieval,
+    type RetrievalRetrieveResponse as RetrievalRetrieveResponse,
+    type RetrievalFindResponse as RetrievalFindResponse,
+    type RetrievalGrepResponse as RetrievalGrepResponse,
+    type RetrievalReadResponse as RetrievalReadResponse,
+    type RetrievalFindResponsesPaginatedCursorPost as RetrievalFindResponsesPaginatedCursorPost,
+    type RetrievalGrepResponsesPaginatedCursorPost as RetrievalGrepResponsesPaginatedCursorPost,
+    type RetrievalRetrieveParams as RetrievalRetrieveParams,
+    type RetrievalFindParams as RetrievalFindParams,
+    type RetrievalGrepParams as RetrievalGrepParams,
+    type RetrievalReadParams as RetrievalReadParams,
+  };
+
+  export {
+    Chat as Chat,
+    type ChatCreateResponse as ChatCreateResponse,
+    type ChatRetrieveResponse as ChatRetrieveResponse,
+    type ChatListResponse as ChatListResponse,
+    type ChatGetSummaryResponse as ChatGetSummaryResponse,
+    type ChatStreamResponse as ChatStreamResponse,
+    type ChatListResponsesPaginatedCursor as ChatListResponsesPaginatedCursor,
+    type ChatCreateParams as ChatCreateParams,
+    type ChatRetrieveParams as ChatRetrieveParams,
+    type ChatListParams as ChatListParams,
+    type ChatDeleteParams as ChatDeleteParams,
+    type ChatGetSummaryParams as ChatGetSummaryParams,
+    type ChatStreamParams as ChatStreamParams,
+  };
+
   export {
     type AgentData as AgentData,
     type AgentDataDeleteResponse as AgentDataDeleteResponse,

package/src/resources/beta/chat.ts

@@ -0,0 +1,523 @@
+// 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, PaginatedCursor, type PaginatedCursorParams } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Chat extends APIResource {
+  /**
+   * Create a chat session, optionally bound to indexes (locked after the first
+   * message).
+   *
+   * @example
+   * ```ts
+   * const chat = await client.beta.chat.create();
+   * ```
+   */
+  create(
+    params: ChatCreateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ChatCreateResponse> {
+    const { organization_id, project_id, ...body } = params ?? {};
+    return this._client.post('/api/v1/chat', { query: { organization_id, project_id }, body, ...options });
+  }
+
+  /**
+   * Retrieve a full session by ID, including its event history.
+   *
+   * @example
+   * ```ts
+   * const chat = await client.beta.chat.retrieve('session_id');
+   * ```
+   */
+  retrieve(
+    sessionID: string,
+    query: ChatRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ChatRetrieveResponse> {
+    return this._client.get(path`/api/v1/chat/${sessionID}`, { query, ...options });
+  }
+
+  /**
+   * List all chat sessions for the current project.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const chatListResponse of client.beta.chat.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: ChatListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ChatListResponsesPaginatedCursor, ChatListResponse> {
+    return this._client.getAPIList('/api/v1/chat', PaginatedCursor<ChatListResponse>, { query, ...options });
+  }
+
+  /**
+   * Delete a session.
+   *
+   * @example
+   * ```ts
+   * await client.beta.chat.delete('session_id');
+   * ```
+   */
+  delete(
+    sessionID: string,
+    params: ChatDeleteParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    const { organization_id, project_id } = params ?? {};
+    return this._client.delete(path`/api/v1/chat/${sessionID}`, {
+      query: { organization_id, project_id },
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Retrieve a session summary by ID.
+   *
+   * @example
+   * ```ts
+   * const response = await client.beta.chat.getSummary(
+   *   'session_id',
+   * );
+   * ```
+   */
+  getSummary(
+    sessionID: string,
+    query: ChatGetSummaryParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ChatGetSummaryResponse> {
+    return this._client.get(path`/api/v1/chat/${sessionID}/summary`, { query, ...options });
+  }
+
+  /**
+   * Stream agent events for a chat turn as Server-Sent Events.
+   *
+   * @example
+   * ```ts
+   * const response = await client.beta.chat.stream(
+   *   'session_id',
+   *   {
+   *     index_ids: ['idx-abc123', 'idx-def456'],
+   *     prompt: 'What were the main findings in Q3?',
+   *   },
+   * );
+   * ```
+   */
+  stream(sessionID: string, params: ChatStreamParams, options?: RequestOptions): APIPromise<unknown> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.post(path`/api/v1/chat/${sessionID}/messages/stream`, {
+      query: { organization_id, project_id },
+      body,
+      ...options,
+    });
+  }
+}
+
+export type ChatListResponsesPaginatedCursor = PaginatedCursor<ChatListResponse>;
+
+/**
+ * Summary of a chat session, including its title and last run metadata.
+ */
+export interface ChatCreateResponse {
+  /**
+   * ISO-format timestamp showing when the session was last updated.
+   */
+  last_updated_at: string;
+
+  /**
+   * Unique session identifier.
+   */
+  session_id: string;
+
+  /**
+   * Auto-generated title derived from the first user message.
+   */
+  generated_title?: string | null;
+
+  /**
+   * Indexes this session is bound to. Null on unbound sessions.
+   */
+  index_ids?: Array<string> | null;
+
+  /**
+   * Token usage and status from the most recent run. Null if the session has not
+   * been run yet.
+   */
+  job_metadata?: ChatCreateResponse.JobMetadata | null;
+}
+
+export namespace ChatCreateResponse {
+  /**
+   * Token usage and status from the most recent run. Null if the session has not
+   * been run yet.
+   */
+  export interface JobMetadata {
+    duration_ms?: number;
+
+    error?: string | null;
+
+    export_config_ids?: Array<string> | null;
+
+    is_error?: boolean;
+
+    total_input_tokens?: number | null;
+
+    total_output_tokens?: number | null;
+
+    turns?: number;
+  }
+}
+
+/**
+ * Full chat session including its complete event history.
+ */
+export interface ChatRetrieveResponse {
+  /**
+   * Ordered list of events that make up the conversation history.
+   */
+  events: Array<
+    | ChatRetrieveResponse.ThinkingDeltaEvent
+    | ChatRetrieveResponse.TextDeltaEvent
+    | ChatRetrieveResponse.ThinkingEvent
+    | ChatRetrieveResponse.TextEvent
+    | ChatRetrieveResponse.ToolCallEvent
+    | ChatRetrieveResponse.ToolResultEvent
+    | ChatRetrieveResponse.StopEvent
+    | ChatRetrieveResponse.UserInputEvent
+  >;
+
+  /**
+   * ISO-format timestamp showing when the session was last updated.
+   */
+  last_updated_at: string;
+
+  /**
+   * Unique session identifier.
+   */
+  session_id: string;
+
+  /**
+   * Auto-generated title derived from the first user message.
+   */
+  generated_title?: string | null;
+
+  /**
+   * Indexes this session is bound to. Null on unbound sessions.
+   */
+  index_ids?: Array<string> | null;
+
+  /**
+   * Token usage and status from the most recent run. Null if the session has not
+   * been run yet.
+   */
+  job_metadata?: ChatRetrieveResponse.JobMetadata | null;
+}
+
+export namespace ChatRetrieveResponse {
+  export interface ThinkingDeltaEvent {
+    content: string;
+
+    type?: 'thinking_delta';
+  }
+
+  export interface TextDeltaEvent {
+    content: string;
+
+    type?: 'text_delta';
+  }
+
+  export interface ThinkingEvent {
+    content: string;
+
+    type?: 'thinking';
+  }
+
+  export interface TextEvent {
+    content: string;
+
+    type?: 'text';
+  }
+
+  export interface ToolCallEvent {
+    arguments: { [key: string]: unknown };
+
+    call_id: string;
+
+    name: string;
+
+    type?: 'tool_call';
+  }
+
+  export interface ToolResultEvent {
+    call_id: string;
+
+    name: string;
+
+    result: unknown;
+
+    /**
+     * Coordinates for lazily resolving a page screenshot presigned URL.
+     */
+    image_attachment?: ToolResultEvent.ImageAttachment | null;
+
+    type?: 'tool_result';
+  }
+
+  export namespace ToolResultEvent {
+    /**
+     * Coordinates for lazily resolving a page screenshot presigned URL.
+     */
+    export interface ImageAttachment {
+      attachment_name: string;
+
+      source_id: string;
+    }
+  }
+
+  export interface StopEvent {
+    error: string | null;
+
+    is_error: boolean;
+
+    usage: StopEvent.Usage;
+
+    type?: 'stop';
+  }
+
+  export namespace StopEvent {
+    export interface Usage {
+      duration_ms?: number;
+
+      total_input_tokens?: number | null;
+
+      total_output_tokens?: number | null;
+
+      turns?: number;
+    }
+  }
+
+  export interface UserInputEvent {
+    content: string;
+
+    type?: 'user_input';
+  }
+
+  /**
+   * Token usage and status from the most recent run. Null if the session has not
+   * been run yet.
+   */
+  export interface JobMetadata {
+    duration_ms?: number;
+
+    error?: string | null;
+
+    export_config_ids?: Array<string> | null;
+
+    is_error?: boolean;
+
+    total_input_tokens?: number | null;
+
+    total_output_tokens?: number | null;
+
+    turns?: number;
+  }
+}
+
+/**
+ * Summary of a chat session, including its title and last run metadata.
+ */
+export interface ChatListResponse {
+  /**
+   * ISO-format timestamp showing when the session was last updated.
+   */
+  last_updated_at: string;
+
+  /**
+   * Unique session identifier.
+   */
+  session_id: string;
+
+  /**
+   * Auto-generated title derived from the first user message.
+   */
+  generated_title?: string | null;
+
+  /**
+   * Indexes this session is bound to. Null on unbound sessions.
+   */
+  index_ids?: Array<string> | null;
+
+  /**
+   * Token usage and status from the most recent run. Null if the session has not
+   * been run yet.
+   */
+  job_metadata?: ChatListResponse.JobMetadata | null;
+}
+
+export namespace ChatListResponse {
+  /**
+   * Token usage and status from the most recent run. Null if the session has not
+   * been run yet.
+   */
+  export interface JobMetadata {
+    duration_ms?: number;
+
+    error?: string | null;
+
+    export_config_ids?: Array<string> | null;
+
+    is_error?: boolean;
+
+    total_input_tokens?: number | null;
+
+    total_output_tokens?: number | null;
+
+    turns?: number;
+  }
+}
+
+/**
+ * Summary of a chat session, including its title and last run metadata.
+ */
+export interface ChatGetSummaryResponse {
+  /**
+   * ISO-format timestamp showing when the session was last updated.
+   */
+  last_updated_at: string;
+
+  /**
+   * Unique session identifier.
+   */
+  session_id: string;
+
+  /**
+   * Auto-generated title derived from the first user message.
+   */
+  generated_title?: string | null;
+
+  /**
+   * Indexes this session is bound to. Null on unbound sessions.
+   */
+  index_ids?: Array<string> | null;
+
+  /**
+   * Token usage and status from the most recent run. Null if the session has not
+   * been run yet.
+   */
+  job_metadata?: ChatGetSummaryResponse.JobMetadata | null;
+}
+
+export namespace ChatGetSummaryResponse {
+  /**
+   * Token usage and status from the most recent run. Null if the session has not
+   * been run yet.
+   */
+  export interface JobMetadata {
+    duration_ms?: number;
+
+    error?: string | null;
+
+    export_config_ids?: Array<string> | null;
+
+    is_error?: boolean;
+
+    total_input_tokens?: number | null;
+
+    total_output_tokens?: number | null;
+
+    turns?: number;
+  }
+}
+
+export type ChatStreamResponse = unknown;
+
+export interface ChatCreateParams {
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+
+  /**
+   * Body param: Indexes this session will retrieve from. Once set and the first
+   * message has been sent, the source set is locked for the session's lifetime.
+   * Leave null to create an unbound session.
+   */
+  index_ids?: Array<string> | null;
+}
+
+export interface ChatRetrieveParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
+export interface ChatListParams extends PaginatedCursorParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
+export interface ChatDeleteParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
+export interface ChatGetSummaryParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
+export interface ChatStreamParams {
+  /**
+   * Body param: Indexes to retrieve data from.
+   */
+  index_ids: Array<string>;
+
+  /**
+   * Body param: User message for this chat turn.
+   */
+  prompt: string;
+
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+}
+
+export declare namespace Chat {
+  export {
+    type ChatCreateResponse as ChatCreateResponse,
+    type ChatRetrieveResponse as ChatRetrieveResponse,
+    type ChatListResponse as ChatListResponse,
+    type ChatGetSummaryResponse as ChatGetSummaryResponse,
+    type ChatStreamResponse as ChatStreamResponse,
+    type ChatListResponsesPaginatedCursor as ChatListResponsesPaginatedCursor,
+    type ChatCreateParams as ChatCreateParams,
+    type ChatRetrieveParams as ChatRetrieveParams,
+    type ChatListParams as ChatListParams,
+    type ChatDeleteParams as ChatDeleteParams,
+    type ChatGetSummaryParams as ChatGetSummaryParams,
+    type ChatStreamParams as ChatStreamParams,
+  };
+}