@tambo-ai/typescript-sdk 0.70.0 → 0.72.0

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

@@ -1,8 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../resource';
-import * as Core from '../../../core';
+import { APIResource } from '../../../core/resource';
 import * as Shared from '../../shared';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
 
 export class Suggestions extends APIResource {
   /**
@@ -12,17 +14,18 @@ export class Suggestions extends APIResource {
    * ```ts
    * const suggestions =
    *   await client.beta.threads.suggestions.list(
-   *     'thread_123456789',
    *     'msg_123456789',
+   *     { id: 'thread_123456789' },
    *   );
    * ```
    */
   list(
-    id: string,
-    messageId: string,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<SuggestionListResponse> {
-    return this._client.get(`/threads/${id}/messages/${messageId}/suggestions`, options);
+    messageID: string,
+    params: SuggestionListParams,
+    options?: RequestOptions,
+  ): APIPromise<SuggestionListResponse> {
+    const { id } = params;
+    return this._client.get(path`/threads/${id}/messages/${messageID}/suggestions`, options);
   }
 
   /**
@@ -32,18 +35,18 @@ export class Suggestions extends APIResource {
    * ```ts
    * const suggestions =
    *   await client.beta.threads.suggestions.generate(
-   *     'thread_123456789',
    *     'msg_123456789',
+   *     { id: 'thread_123456789' },
    *   );
    * ```
    */
   generate(
-    id: string,
-    messageId: string,
-    body: SuggestionGenerateParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<SuggestionGenerateResponse> {
-    return this._client.post(`/threads/${id}/messages/${messageId}/suggestions`, { body, ...options });
+    messageID: string,
+    params: SuggestionGenerateParams,
+    options?: RequestOptions,
+  ): APIPromise<SuggestionGenerateResponse> {
+    const { id, ...body } = params;
+    return this._client.post(path`/threads/${id}/messages/${messageID}/suggestions`, { body, ...options });
   }
 }
 
@@ -90,14 +93,26 @@ export type SuggestionListResponse = Array<Suggestion>;
 
 export type SuggestionGenerateResponse = Array<Suggestion>;
 
+export interface SuggestionListParams {
+  /**
+   * ID of the thread to get suggestions for
+   */
+  id: string;
+}
+
 export interface SuggestionGenerateParams {
   /**
-   * Available components that can be used with this suggestion
+   * Path param: ID of the thread to generate suggestions for
+   */
+  id: string;
+
+  /**
+   * Body param: Available components that can be used with this suggestion
    */
   availableComponents?: Array<Shared.AvailableComponent>;
 
   /**
-   * Maximum number of suggestions to generate
+   * Body param: Maximum number of suggestions to generate
    */
   maxSuggestions?: number;
 }
@@ -108,6 +123,7 @@ export declare namespace Suggestions {
     type SuggestionsGenerate as SuggestionsGenerate,
     type SuggestionListResponse as SuggestionListResponse,
     type SuggestionGenerateResponse as SuggestionGenerateResponse,
+    type SuggestionListParams as SuggestionListParams,
     type SuggestionGenerateParams as SuggestionGenerateParams,
   };
 }

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

@@ -1,14 +1,13 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../resource';
-import { isRequestOptions } from '../../../core';
-import * as Core from '../../../core';
+import { APIResource } from '../../../core/resource';
 import * as ThreadsAPI from './threads';
 import * as Shared from '../../shared';
 import * as MessagesAPI from './messages';
 import {
   MessageCreateParams,
   MessageCreateResponse,
+  MessageDeleteParams,
   MessageListParams,
   MessageListResponse,
   MessageUpdateComponentStateParams,
@@ -19,11 +18,16 @@ import {
   Suggestion,
   SuggestionGenerateParams,
   SuggestionGenerateResponse,
+  SuggestionListParams,
   SuggestionListResponse,
   Suggestions,
   SuggestionsGenerate,
 } from './suggestions';
-import { OffsetAndLimit, type OffsetAndLimitParams } from '../../../pagination';
+import { APIPromise } from '../../../core/api-promise';
+import { OffsetAndLimit, type OffsetAndLimitParams, PagePromise } from '../../../core/pagination';
+import { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
 
 export class Threads extends APIResource {
   messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
@@ -37,7 +41,7 @@ export class Threads extends APIResource {
    * });
    * ```
    */
-  create(body: ThreadCreateParams, options?: Core.RequestOptions): Core.APIPromise<Thread> {
+  create(body: ThreadCreateParams, options?: RequestOptions): APIPromise<Thread> {
     return this._client.post('/threads', { body, ...options });
   }
 
@@ -49,19 +53,10 @@ export class Threads extends APIResource {
    */
   retrieve(
     id: string,
-    query?: ThreadRetrieveParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<ThreadRetrieveResponse>;
-  retrieve(id: string, options?: Core.RequestOptions): Core.APIPromise<ThreadRetrieveResponse>;
-  retrieve(
-    id: string,
-    query: ThreadRetrieveParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<ThreadRetrieveResponse> {
-    if (isRequestOptions(query)) {
-      return this.retrieve(id, {}, query);
-    }
-    return this._client.get(`/threads/${id}`, { query, ...options });
+    query: ThreadRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ThreadRetrieveResponse> {
+    return this._client.get(path`/threads/${id}`, { query, ...options });
   }
 
   /**
@@ -72,8 +67,8 @@ export class Threads extends APIResource {
    * });
    * ```
    */
-  update(id: string, body: ThreadUpdateParams, options?: Core.RequestOptions): Core.APIPromise<Thread> {
-    return this._client.put(`/threads/${id}`, { body, ...options });
+  update(id: string, body: ThreadUpdateParams, options?: RequestOptions): APIPromise<Thread> {
+    return this._client.put(path`/threads/${id}`, { body, ...options });
   }
 
   /**
@@ -88,20 +83,11 @@ export class Threads extends APIResource {
    * ```
    */
   list(
-    projectId: string,
-    query?: ThreadListParams,
-    options?: Core.RequestOptions,
-  ): Core.PagePromise<ThreadsOffsetAndLimit, Thread>;
-  list(projectId: string, options?: Core.RequestOptions): Core.PagePromise<ThreadsOffsetAndLimit, Thread>;
-  list(
-    projectId: string,
-    query: ThreadListParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
-  ): Core.PagePromise<ThreadsOffsetAndLimit, Thread> {
-    if (isRequestOptions(query)) {
-      return this.list(projectId, {}, query);
-    }
-    return this._client.getAPIList(`/threads/project/${projectId}`, ThreadsOffsetAndLimit, {
+    projectID: string,
+    query: ThreadListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ThreadsOffsetAndLimit, Thread> {
+    return this._client.getAPIList(path`/threads/project/${projectID}`, OffsetAndLimit<Thread>, {
       query,
       ...options,
     });
@@ -113,10 +99,10 @@ export class Threads extends APIResource {
    * await client.beta.threads.delete('id');
    * ```
    */
-  delete(id: string, options?: Core.RequestOptions): Core.APIPromise<void> {
-    return this._client.delete(`/threads/${id}`, {
+  delete(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/threads/${id}`, {
       ...options,
-      headers: { Accept: '*/*', ...options?.headers },
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
@@ -131,14 +117,14 @@ export class Threads extends APIResource {
    * });
    * ```
    */
-  advance(body: ThreadAdvanceParams, options?: Core.RequestOptions): Core.APIPromise<ThreadAdvanceResponse> {
+  advance(body: ThreadAdvanceParams, options?: RequestOptions): APIPromise<ThreadAdvanceResponse> {
     return this._client.post('/threads/advance', { body, ...options });
   }
 
   /**
    * @example
    * ```ts
-   * const response = await client.beta.threads.advanceById(
+   * const response = await client.beta.threads.advanceByID(
    *   'id',
    *   {
    *     messageToAppend: {
@@ -149,12 +135,12 @@ export class Threads extends APIResource {
    * );
    * ```
    */
-  advanceById(
+  advanceByID(
     id: string,
     body: ThreadAdvanceByIDParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<ThreadAdvanceByIDResponse> {
-    return this._client.post(`/threads/${id}/advance`, { body, ...options });
+    options?: RequestOptions,
+  ): APIPromise<ThreadAdvanceByIDResponse> {
+    return this._client.post(path`/threads/${id}/advance`, { body, ...options });
   }
 
   /**
@@ -167,8 +153,8 @@ export class Threads extends APIResource {
    * );
    * ```
    */
-  cancel(id: string, options?: Core.RequestOptions): Core.APIPromise<Thread> {
-    return this._client.post(`/threads/${id}/cancel`, options);
+  cancel(id: string, options?: RequestOptions): APIPromise<Thread> {
+    return this._client.post(path`/threads/${id}/cancel`, options);
   }
 
   /**
@@ -184,24 +170,15 @@ export class Threads extends APIResource {
    */
   generateName(
     id: string,
-    params?: ThreadGenerateNameParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<Thread>;
-  generateName(id: string, options?: Core.RequestOptions): Core.APIPromise<Thread>;
-  generateName(
-    id: string,
-    params: ThreadGenerateNameParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<Thread> {
-    if (isRequestOptions(params)) {
-      return this.generateName(id, {}, params);
-    }
-    const { contextKey } = params;
-    return this._client.post(`/threads/${id}/generate-name`, { query: { contextKey }, ...options });
+    params: ThreadGenerateNameParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<Thread> {
+    const { contextKey } = params ?? {};
+    return this._client.post(path`/threads/${id}/generate-name`, { query: { contextKey }, ...options });
   }
 }
 
-export class ThreadsOffsetAndLimit extends OffsetAndLimit<Thread> {}
+export type ThreadsOffsetAndLimit = OffsetAndLimit<Thread>;
 
 export interface ChatCompletionContentPart {
   type: 'text' | 'image_url' | 'input_audio';
@@ -236,8 +213,6 @@ export interface ComponentDecisionV2 {
 
   props: { [key: string]: unknown };
 
-  reasoning: string;
-
   completionStatusMessage?: string;
 
   statusMessage?: string;
@@ -317,6 +292,11 @@ export interface ThreadMessage {
 
   metadata?: { [key: string]: unknown };
 
+  /**
+   * Reasoning text from the LLM, if the model supports it.
+   */
+  reasoning?: Array<string>;
+
   /**
    * The unique id of the tool call. This is filled in only if the tool call is a
    * client-side tool call.
@@ -479,6 +459,11 @@ export interface ThreadAdvanceParams {
 
   forceToolChoice?: string;
 
+  /**
+   * Initial messages to include when creating a new thread
+   */
+  initialMessages?: Array<ThreadAdvanceParams.InitialMessage>;
+
   /**
    * Tool call counts
    */
@@ -518,6 +503,58 @@ export namespace ThreadAdvanceParams {
 
     metadata?: { [key: string]: unknown };
 
+    /**
+     * Reasoning text from the LLM, if the model supports it.
+     */
+    reasoning?: Array<string>;
+
+    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' | 'hydra';
+
+    /**
+     * @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>;
+
     tool_call_id?: string;
 
     toolCallRequest?: Shared.ToolCallRequest;
@@ -540,6 +577,11 @@ export interface ThreadAdvanceByIDParams {
 
   forceToolChoice?: string;
 
+  /**
+   * Initial messages to include when creating a new thread
+   */
+  initialMessages?: Array<ThreadAdvanceByIDParams.InitialMessage>;
+
   /**
    * Tool call counts
    */
@@ -579,6 +621,58 @@ export namespace ThreadAdvanceByIDParams {
 
     metadata?: { [key: string]: unknown };
 
+    /**
+     * Reasoning text from the LLM, if the model supports it.
+     */
+    reasoning?: Array<string>;
+
+    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' | 'hydra';
+
+    /**
+     * @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>;
+
     tool_call_id?: string;
 
     toolCallRequest?: Shared.ToolCallRequest;
@@ -594,7 +688,6 @@ export interface ThreadGenerateNameParams {
   contextKey?: string;
 }
 
-Threads.ThreadsOffsetAndLimit = ThreadsOffsetAndLimit;
 Threads.Messages = Messages;
 Threads.Suggestions = Suggestions;
 
@@ -607,7 +700,7 @@ export declare namespace Threads {
     type ThreadRetrieveResponse as ThreadRetrieveResponse,
     type ThreadAdvanceResponse as ThreadAdvanceResponse,
     type ThreadAdvanceByIDResponse as ThreadAdvanceByIDResponse,
-    ThreadsOffsetAndLimit as ThreadsOffsetAndLimit,
+    type ThreadsOffsetAndLimit as ThreadsOffsetAndLimit,
     type ThreadCreateParams as ThreadCreateParams,
     type ThreadRetrieveParams as ThreadRetrieveParams,
     type ThreadUpdateParams as ThreadUpdateParams,
@@ -623,6 +716,7 @@ export declare namespace Threads {
     type MessageListResponse as MessageListResponse,
     type MessageCreateParams as MessageCreateParams,
     type MessageListParams as MessageListParams,
+    type MessageDeleteParams as MessageDeleteParams,
     type MessageUpdateComponentStateParams as MessageUpdateComponentStateParams,
   };
 
@@ -632,6 +726,7 @@ export declare namespace Threads {
     type SuggestionsGenerate as SuggestionsGenerate,
     type SuggestionListResponse as SuggestionListResponse,
     type SuggestionGenerateResponse as SuggestionGenerateResponse,
+    type SuggestionListParams as SuggestionListParams,
     type SuggestionGenerateParams as SuggestionGenerateParams,
   };
 }

package/src/tsconfig.json

@@ -9,7 +9,8 @@
     "target": "es2020",
     "lib": [
       "DOM",
-      "ES2020"
+      "DOM.Iterable",
+      "ES2018"
     ],
     "moduleResolution": "node"
   }