@tambo-ai/typescript-sdk 0.80.0 → 0.83.0

package/src/resources/beta/beta.ts

@@ -27,7 +27,6 @@ import {
   Thread,
   ThreadAdvanceByIDParams,
   ThreadAdvanceByIDResponse,
-  ThreadAdvanceParams,
   ThreadAdvanceResponse,
   ThreadCreateParams,
   ThreadGenerateNameParams,
@@ -78,7 +77,6 @@ export declare namespace Beta {
     type ThreadRetrieveParams as ThreadRetrieveParams,
     type ThreadUpdateParams as ThreadUpdateParams,
     type ThreadListParams as ThreadListParams,
-    type ThreadAdvanceParams as ThreadAdvanceParams,
     type ThreadAdvanceByIDParams as ThreadAdvanceByIDParams,
     type ThreadGenerateNameParams as ThreadGenerateNameParams,
   };

package/src/resources/beta/index.ts

@@ -29,7 +29,6 @@ export {
   type ThreadRetrieveParams,
   type ThreadUpdateParams,
   type ThreadListParams,
-  type ThreadAdvanceParams,
   type ThreadAdvanceByIDParams,
   type ThreadGenerateNameParams,
   type ThreadsOffsetAndLimit,

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

@@ -31,7 +31,6 @@ export {
   type ThreadRetrieveParams,
   type ThreadUpdateParams,
   type ThreadListParams,
-  type ThreadAdvanceParams,
   type ThreadAdvanceByIDParams,
   type ThreadGenerateNameParams,
   type ThreadsOffsetAndLimit,

package/src/resources/beta/threads/messages.ts

@@ -59,7 +59,10 @@ export class Messages extends APIResource {
    * const threadMessage =
    *   await client.beta.threads.messages.updateComponentState(
    *     'msg_123.456',
-   *     { id: 'thr_123.456', state: { foo: 'bar' } },
+   *     {
+   *       id: 'thr_123.456',
+   *       state: { foo: 'bar' },
+   *     },
    *   );
    * ```
    */
@@ -150,7 +153,7 @@ export interface MessageUpdateComponentStateParams {
   id: string;
 
   /**
-   * Body param:
+   * Body param
    */
   state: { [key: string]: unknown };
 }

package/src/resources/beta/threads/threads.ts

@@ -107,37 +107,18 @@ export class Threads extends APIResource {
   }
 
   /**
-   * Creates a new thread and advances it
+   * This endpoint has been deprecated. Use POST /advancestream instead.
    *
-   * @example
-   * ```ts
-   * const response = await client.beta.threads.advance({
-   *   messageToAppend: {
-   *     content: [{ type: 'text' }],
-   *     role: 'user',
-   *   },
-   * });
-   * ```
+   * @deprecated
    */
-  advance(body: ThreadAdvanceParams, options?: RequestOptions): APIPromise<ThreadAdvanceResponse> {
-    return this._client.post('/threads/advance', { body, ...options });
+  advance(options?: RequestOptions): APIPromise<ThreadAdvanceResponse> {
+    return this._client.post('/threads/advance', options);
   }
 
   /**
-   * Generates the response message for an existing thread
+   * This endpoint has been deprecated. Use POST /:id/advancestream instead.
    *
-   * @example
-   * ```ts
-   * const response = await client.beta.threads.advanceByID(
-   *   'thr_123.456',
-   *   {
-   *     messageToAppend: {
-   *       content: [{ type: 'text' }],
-   *       role: 'user',
-   *     },
-   *   },
-   * );
-   * ```
+   * @deprecated
    */
   advanceByID(
     id: string,
@@ -498,137 +479,6 @@ export interface ThreadListParams extends OffsetAndLimitParams {
   contextKey?: string;
 }
 
-export interface ThreadAdvanceParams {
-  messageToAppend: ThreadAdvanceParams.MessageToAppend;
-
-  availableComponents?: Array<Shared.AvailableComponent>;
-
-  clientTools?: Array<Shared.ComponentContextToolMetadata>;
-
-  /**
-   * Unique user identifier for the thread
-   */
-  contextKey?: string;
-
-  forceToolChoice?: string;
-
-  /**
-   * Initial messages to include when creating a new thread
-   */
-  initialMessages?: Array<ThreadAdvanceParams.InitialMessage>;
-
-  /**
-   * Tool call counts
-   */
-  toolCallCounts?: { [key: string]: number };
-}
-
-export namespace ThreadAdvanceParams {
-  export interface MessageToAppend {
-    content: Array<ThreadsAPI.ChatCompletionContentPart>;
-
-    role: 'user' | 'assistant' | 'system' | 'tool';
-
-    /**
-     * @deprecated No longer used - instead set role and the tool call information
-     */
-    actionType?: 'tool_call' | 'tool_response';
-
-    /**
-     * Additional context to provide to the AI beyond the user query, such as the info
-     * about the current page the user is visiting.
-     */
-    additionalContext?: { [key: string]: unknown };
-
-    component?: ThreadsAPI.ComponentDecisionV2;
-
-    /**
-     * The initial state of the component
-     */
-    componentState?: { [key: string]: unknown };
-
-    error?: string;
-
-    /**
-     * Whether the message has been cancelled
-     */
-    isCancelled?: boolean;
-
-    metadata?: { [key: string]: unknown };
-
-    /**
-     * Reasoning text from the LLM, if the model supports it.
-     */
-    reasoning?: Array<string>;
-
-    /**
-     * Duration of reasoning in milliseconds
-     */
-    reasoningDurationMS?: number;
-
-    tool_call_id?: string;
-
-    toolCallRequest?: Shared.ToolCallRequest;
-
-    /**
-     * @deprecated Put the response in the content instead
-     */
-    toolResponse?: unknown;
-  }
-
-  export interface InitialMessage {
-    content: Array<ThreadsAPI.ChatCompletionContentPart>;
-
-    role: 'user' | 'assistant' | 'system' | 'tool';
-
-    /**
-     * @deprecated No longer used - instead set role and the tool call information
-     */
-    actionType?: 'tool_call' | 'tool_response';
-
-    /**
-     * Additional context to provide to the AI beyond the user query, such as the info
-     * about the current page the user is visiting.
-     */
-    additionalContext?: { [key: string]: unknown };
-
-    component?: ThreadsAPI.ComponentDecisionV2;
-
-    /**
-     * The initial state of the component
-     */
-    componentState?: { [key: string]: unknown };
-
-    error?: string;
-
-    /**
-     * Whether the message has been cancelled
-     */
-    isCancelled?: boolean;
-
-    metadata?: { [key: string]: unknown };
-
-    /**
-     * Reasoning text from the LLM, if the model supports it.
-     */
-    reasoning?: Array<string>;
-
-    /**
-     * Duration of reasoning in milliseconds
-     */
-    reasoningDurationMS?: number;
-
-    tool_call_id?: string;
-
-    toolCallRequest?: Shared.ToolCallRequest;
-
-    /**
-     * @deprecated Put the response in the content instead
-     */
-    toolResponse?: unknown;
-  }
-}
-
 export interface ThreadAdvanceByIDParams {
   messageToAppend: ThreadAdvanceByIDParams.MessageToAppend;
 
@@ -784,7 +634,6 @@ export declare namespace Threads {
     type ThreadRetrieveParams as ThreadRetrieveParams,
     type ThreadUpdateParams as ThreadUpdateParams,
     type ThreadListParams as ThreadListParams,
-    type ThreadAdvanceParams as ThreadAdvanceParams,
     type ThreadAdvanceByIDParams as ThreadAdvanceByIDParams,
     type ThreadGenerateNameParams as ThreadGenerateNameParams,
   };

package/src/resources/index.ts

@@ -2,3 +2,18 @@
 
 export * from './shared';
 export { Beta } from './beta/beta';
+export { Storage, type StoragePresignResponse, type StoragePresignParams } from './storage';
+export {
+  Threads,
+  type ComponentContent,
+  type ResourceContent,
+  type RunError,
+  type TextContent,
+  type ToolResultContent,
+  type ToolUseContent,
+  type ThreadCreateResponse,
+  type ThreadRetrieveResponse,
+  type ThreadListResponse,
+  type ThreadCreateParams,
+  type ThreadListParams,
+} from './threads/threads';

package/src/resources/shared.ts

@@ -7,6 +7,9 @@ export interface AvailableComponent {
 
   name: string;
 
+  /**
+   * JSON Schema for the component's props
+   */
   props: { [key: string]: unknown };
 }
 

package/src/resources/storage.ts

@@ -0,0 +1,59 @@
+// 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 Storage extends APIResource {
+  /**
+   * Returns a presigned URL that allows direct file upload to S3. The client should
+   * PUT the file directly to the returned uploadUrl.
+   *
+   * @example
+   * ```ts
+   * const response = await client.storage.presign({
+   *   contentType: 'application/pdf',
+   *   size: 1024000,
+   * });
+   * ```
+   */
+  presign(body: StoragePresignParams, options?: RequestOptions): APIPromise<StoragePresignResponse> {
+    return this._client.post('/storage/presign', { body, ...options });
+  }
+}
+
+export interface StoragePresignResponse {
+  /**
+   * The attachment URI to reference this file in messages
+   */
+  attachmentUri: string;
+
+  /**
+   * Time in seconds until the presigned URL expires
+   */
+  expiresIn: number;
+
+  /**
+   * The presigned URL to PUT the file directly to S3
+   */
+  uploadUrl: string;
+}
+
+export interface StoragePresignParams {
+  /**
+   * The MIME type of the file
+   */
+  contentType: string;
+
+  /**
+   * The file size in bytes (max 10MB)
+   */
+  size: number;
+}
+
+export declare namespace Storage {
+  export {
+    type StoragePresignResponse as StoragePresignResponse,
+    type StoragePresignParams as StoragePresignParams,
+  };
+}

package/src/resources/threads/index.ts

@@ -0,0 +1,31 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Messages,
+  type MessageListResponse,
+  type MessageGetResponse,
+  type MessageListParams,
+  type MessageGetParams,
+} from './messages';
+export {
+  Runs,
+  type InputMessage,
+  type RunDeleteResponse,
+  type RunCreateParams,
+  type RunDeleteParams,
+  type RunRunParams,
+} from './runs';
+export {
+  Threads,
+  type ComponentContent,
+  type ResourceContent,
+  type RunError,
+  type TextContent,
+  type ToolResultContent,
+  type ToolUseContent,
+  type ThreadCreateResponse,
+  type ThreadRetrieveResponse,
+  type ThreadListResponse,
+  type ThreadCreateParams,
+  type ThreadListParams,
+} from './threads';

package/src/resources/threads/messages.ts

@@ -0,0 +1,161 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ThreadsAPI from './threads';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Messages extends APIResource {
+  /**
+   * List messages in a thread. Supports cursor-based pagination and ordering.
+   *
+   * @example
+   * ```ts
+   * const messages = await client.threads.messages.list(
+   *   'thr_abc123xyz',
+   * );
+   * ```
+   */
+  list(
+    threadID: string,
+    query: MessageListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MessageListResponse> {
+    return this._client.get(path`/v1/threads/${threadID}/messages`, { query, ...options });
+  }
+
+  /**
+   * Get a specific message by ID from a thread.
+   *
+   * @example
+   * ```ts
+   * const message = await client.threads.messages.get(
+   *   'msg_xyz789abc',
+   *   { threadId: 'thr_abc123xyz' },
+   * );
+   * ```
+   */
+  get(messageID: string, params: MessageGetParams, options?: RequestOptions): APIPromise<MessageGetResponse> {
+    const { threadId } = params;
+    return this._client.get(path`/v1/threads/${threadId}/messages/${messageID}`, options);
+  }
+}
+
+export interface MessageListResponse {
+  /**
+   * Whether there are more results
+   */
+  hasMore: boolean;
+
+  /**
+   * List of messages in the thread
+   */
+  messages: Array<MessageListResponse.Message>;
+
+  /**
+   * Cursor for the next page of results
+   */
+  nextCursor?: string;
+}
+
+export namespace MessageListResponse {
+  export interface Message {
+    /**
+     * Unique identifier for this message
+     */
+    id: string;
+
+    /**
+     * Content blocks in this message
+     */
+    content: Array<
+      | ThreadsAPI.TextContent
+      | ThreadsAPI.ResourceContent
+      | ThreadsAPI.ToolUseContent
+      | ThreadsAPI.ToolResultContent
+      | ThreadsAPI.ComponentContent
+    >;
+
+    /**
+     * Message role
+     */
+    role: 'user' | 'assistant' | 'system';
+
+    /**
+     * When the message was created (ISO 8601)
+     */
+    createdAt?: string;
+
+    /**
+     * Additional metadata
+     */
+    metadata?: unknown;
+  }
+}
+
+export interface MessageGetResponse {
+  /**
+   * Unique identifier for this message
+   */
+  id: string;
+
+  /**
+   * Content blocks in this message
+   */
+  content: Array<
+    | ThreadsAPI.TextContent
+    | ThreadsAPI.ResourceContent
+    | ThreadsAPI.ToolUseContent
+    | ThreadsAPI.ToolResultContent
+    | ThreadsAPI.ComponentContent
+  >;
+
+  /**
+   * Message role
+   */
+  role: 'user' | 'assistant' | 'system';
+
+  /**
+   * When the message was created (ISO 8601)
+   */
+  createdAt?: string;
+
+  /**
+   * Additional metadata
+   */
+  metadata?: unknown;
+}
+
+export interface MessageListParams {
+  /**
+   * Cursor for pagination
+   */
+  cursor?: string;
+
+  /**
+   * Maximum number of messages to return
+   */
+  limit?: string;
+
+  /**
+   * Sort order: 'asc' for oldest first, 'desc' for newest first
+   */
+  order?: 'asc' | 'desc';
+}
+
+export interface MessageGetParams {
+  /**
+   * Thread ID
+   */
+  threadId: string;
+}
+
+export declare namespace Messages {
+  export {
+    type MessageListResponse as MessageListResponse,
+    type MessageGetResponse as MessageGetResponse,
+    type MessageListParams as MessageListParams,
+    type MessageGetParams as MessageGetParams,
+  };
+}