@tambo-ai/typescript-sdk 0.86.0 → 0.88.0

package/src/resources/threads/suggestions.ts

@@ -0,0 +1,170 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ThreadsSuggestionsAPI from '../beta/threads/suggestions';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Suggestions extends APIResource {
+  /**
+   * Generate AI-powered suggestions for the next action based on the thread context.
+   * Suggestions are persisted and can be retrieved later via the list endpoint.
+   * Calling this endpoint replaces any existing suggestions for the message.
+   *
+   * @example
+   * ```ts
+   * const suggestion = await client.threads.suggestions.create(
+   *   'msg_xyz789abc',
+   *   { threadId: 'thr_abc123xyz' },
+   * );
+   * ```
+   */
+  create(
+    messageID: string,
+    params: SuggestionCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<SuggestionCreateResponse> {
+    const { threadId, ...body } = params;
+    return this._client.post(path`/v1/threads/${threadId}/messages/${messageID}/suggestions`, {
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * List suggestions that have been generated for a specific message. Supports
+   * cursor-based pagination.
+   *
+   * @example
+   * ```ts
+   * const suggestions = await client.threads.suggestions.list(
+   *   'msg_xyz789abc',
+   *   { threadId: 'thr_abc123xyz' },
+   * );
+   * ```
+   */
+  list(
+    messageID: string,
+    params: SuggestionListParams,
+    options?: RequestOptions,
+  ): APIPromise<SuggestionListResponse> {
+    const { threadId, ...query } = params;
+    return this._client.get(path`/v1/threads/${threadId}/messages/${messageID}/suggestions`, {
+      query,
+      ...options,
+    });
+  }
+}
+
+export interface SuggestionCreateResponse {
+  /**
+   * Whether there are more results
+   */
+  hasMore: boolean;
+
+  /**
+   * List of suggestions for the message
+   */
+  suggestions: Array<ThreadsSuggestionsAPI.Suggestion>;
+
+  /**
+   * Cursor for the next page of results
+   */
+  nextCursor?: string;
+}
+
+export interface SuggestionListResponse {
+  /**
+   * Whether there are more results
+   */
+  hasMore: boolean;
+
+  /**
+   * List of suggestions for the message
+   */
+  suggestions: Array<ThreadsSuggestionsAPI.Suggestion>;
+
+  /**
+   * Cursor for the next page of results
+   */
+  nextCursor?: string;
+}
+
+export interface SuggestionCreateParams {
+  /**
+   * Path param: Thread ID
+   */
+  threadId: string;
+
+  /**
+   * Body param: Available components that suggestions can reference
+   */
+  availableComponents?: Array<SuggestionCreateParams.AvailableComponent>;
+
+  /**
+   * Body param: Maximum number of suggestions to generate (1-10)
+   */
+  maxSuggestions?: number;
+
+  /**
+   * Body param: Identifier for a user in your system. Required if no bearer token is
+   * provided.
+   */
+  userKey?: string;
+}
+
+export namespace SuggestionCreateParams {
+  export interface AvailableComponent {
+    /**
+     * Description of what this component displays
+     */
+    description: string;
+
+    /**
+     * Component name (e.g., 'StockChart')
+     */
+    name: string;
+
+    /**
+     * JSON Schema for component props
+     */
+    propsSchema: unknown;
+
+    /**
+     * Optional JSON Schema for component state
+     */
+    stateSchema?: unknown;
+  }
+}
+
+export interface SuggestionListParams {
+  /**
+   * Path param: Thread ID
+   */
+  threadId: string;
+
+  /**
+   * Query param: Cursor for pagination
+   */
+  cursor?: string;
+
+  /**
+   * Query param: Maximum number of suggestions to return
+   */
+  limit?: string;
+
+  /**
+   * Query param: Optional user key for thread organization
+   */
+  userKey?: string;
+}
+
+export declare namespace Suggestions {
+  export {
+    type SuggestionCreateResponse as SuggestionCreateResponse,
+    type SuggestionListResponse as SuggestionListResponse,
+    type SuggestionCreateParams as SuggestionCreateParams,
+    type SuggestionListParams as SuggestionListParams,
+  };
+}

package/src/resources/threads/threads.ts

@@ -24,6 +24,14 @@ import {
 } from './runs';
 import * as StateAPI from './state';
 import { State, StateUpdateStateParams, StateUpdateStateResponse } from './state';
+import * as SuggestionsAPI from './suggestions';
+import {
+  SuggestionCreateParams,
+  SuggestionCreateResponse,
+  SuggestionListParams,
+  SuggestionListResponse,
+  Suggestions,
+} from './suggestions';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -33,6 +41,7 @@ export class Threads extends APIResource {
   state: StateAPI.State = new StateAPI.State(this._client);
   messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
   runs: RunsAPI.Runs = new RunsAPI.Runs(this._client);
+  suggestions: SuggestionsAPI.Suggestions = new SuggestionsAPI.Suggestions(this._client);
 
   /**
    * Create a new empty thread. Note: initialMessages is not supported yet; create
@@ -58,13 +67,17 @@ export class Threads extends APIResource {
    * );
    * ```
    */
-  retrieve(threadID: string, options?: RequestOptions): APIPromise<ThreadRetrieveResponse> {
-    return this._client.get(path`/v1/threads/${threadID}`, options);
+  retrieve(
+    threadID: string,
+    query: ThreadRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ThreadRetrieveResponse> {
+    return this._client.get(path`/v1/threads/${threadID}`, { query, ...options });
   }
 
   /**
    * List all threads for the authenticated project. Supports cursor-based pagination
-   * and filtering by context key.
+   * and filtering by user key.
    *
    * @example
    * ```ts
@@ -223,11 +236,6 @@ export interface ThreadCreateResponse {
    */
   updatedAt: string;
 
-  /**
-   * Optional context key for thread organization
-   */
-  contextKey?: string;
-
   /**
    * ID of the currently active run (when not idle)
    */
@@ -264,6 +272,11 @@ export interface ThreadCreateResponse {
    * Human-readable status message (e.g., 'Fetching weather data...')
    */
   statusMessage?: string;
+
+  /**
+   * Optional user key for thread organization
+   */
+  userKey?: string;
 }
 
 export interface ThreadRetrieveResponse {
@@ -293,11 +306,6 @@ export interface ThreadRetrieveResponse {
    */
   updatedAt: string;
 
-  /**
-   * Optional context key for thread organization
-   */
-  contextKey?: string;
-
   /**
    * ID of the currently active run (when not idle)
    */
@@ -334,6 +342,11 @@ export interface ThreadRetrieveResponse {
    * Human-readable status message (e.g., 'Fetching weather data...')
    */
   statusMessage?: string;
+
+  /**
+   * Optional user key for thread organization
+   */
+  userKey?: string;
 }
 
 export namespace ThreadRetrieveResponse {
@@ -411,11 +424,6 @@ export namespace ThreadListResponse {
      */
     updatedAt: string;
 
-    /**
-     * Optional context key for thread organization
-     */
-    contextKey?: string;
-
     /**
      * ID of the currently active run (when not idle)
      */
@@ -452,15 +460,15 @@ export namespace ThreadListResponse {
      * Human-readable status message (e.g., 'Fetching weather data...')
      */
     statusMessage?: string;
+
+    /**
+     * Optional user key for thread organization
+     */
+    userKey?: string;
   }
 }
 
 export interface ThreadCreateParams {
-  /**
-   * Optional context key for thread organization
-   */
-  contextKey?: string;
-
   /**
    * Initial messages to seed the thread with
    */
@@ -470,14 +478,21 @@ export interface ThreadCreateParams {
    * Additional metadata to attach to the thread
    */
   metadata?: unknown;
+
+  /**
+   * Identifier for a user in your system. Required if no bearer token is provided.
+   */
+  userKey?: string;
 }
 
-export interface ThreadListParams {
+export interface ThreadRetrieveParams {
   /**
-   * Filter by context key
+   * Optional user key for thread organization
    */
-  contextKey?: string;
+  userKey?: string;
+}
 
+export interface ThreadListParams {
   /**
    * Cursor for pagination
    */
@@ -487,11 +502,17 @@ export interface ThreadListParams {
    * Maximum number of threads to return
    */
   limit?: string;
+
+  /**
+   * Filter by user key
+   */
+  userKey?: string;
 }
 
 Threads.State = State;
 Threads.Messages = Messages;
 Threads.Runs = Runs;
+Threads.Suggestions = Suggestions;
 
 export declare namespace Threads {
   export {
@@ -505,6 +526,7 @@ export declare namespace Threads {
     type ThreadRetrieveResponse as ThreadRetrieveResponse,
     type ThreadListResponse as ThreadListResponse,
     type ThreadCreateParams as ThreadCreateParams,
+    type ThreadRetrieveParams as ThreadRetrieveParams,
     type ThreadListParams as ThreadListParams,
   };
 
@@ -532,4 +554,12 @@ export declare namespace Threads {
     type RunDeleteParams as RunDeleteParams,
     type RunRunParams as RunRunParams,
   };
+
+  export {
+    Suggestions as Suggestions,
+    type SuggestionCreateResponse as SuggestionCreateResponse,
+    type SuggestionListResponse as SuggestionListResponse,
+    type SuggestionCreateParams as SuggestionCreateParams,
+    type SuggestionListParams as SuggestionListParams,
+  };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.86.0'; // x-release-please-version
+export const VERSION = '0.88.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.86.0";
+export declare const VERSION = "0.88.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.86.0";
+export declare const VERSION = "0.88.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.86.0'; // x-release-please-version
+exports.VERSION = '0.88.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.86.0'; // x-release-please-version
+export const VERSION = '0.88.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map