@tambo-ai/typescript-sdk 0.87.0 → 0.89.0

package/resources/threads/threads.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"threads.mjs","sourceRoot":"","sources":["../../src/resources/threads/threads.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,KAAK,WAAW;OAChB,EAKL,QAAQ,GACT;OACM,KAAK,OAAO;OACZ,EAQL,IAAI,GACL;OACM,KAAK,QAAQ;OACb,EAAE,KAAK,EAAoD;OAE3D,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,SAAI,GAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAgEtD,CAAC;IA9DC;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAwB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CACN,QAAgB,EAChB,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,eAAe,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CACF,QAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,QAAgB,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,eAAe,QAAQ,EAAE,EAAE;YACxD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAoZD,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;AACtB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC5B,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC"}
+{"version":3,"file":"threads.mjs","sourceRoot":"","sources":["../../src/resources/threads/threads.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,KAAK,WAAW;OAChB,EAKL,QAAQ,GACT;OACM,KAAK,OAAO;OACZ,EAQL,IAAI,GACL;OACM,KAAK,QAAQ;OACb,EAAE,KAAK,EAAoD;OAC3D,KAAK,cAAc;OACnB,EAKL,WAAW,GACZ;OAEM,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,SAAI,GAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,gBAAW,GAA+B,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAgEzF,CAAC;IA9DC;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAwB,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;;;;OAUG;IACH,QAAQ,CACN,QAAgB,EAChB,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,eAAe,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CACF,QAA6C,EAAE,EAC/C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,QAAgB,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,eAAe,QAAQ,EAAE,EAAE;YACxD,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAoZD,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;AACtB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC5B,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;AACpB,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC"}

package/src/client.ts

@@ -585,9 +585,10 @@ export class TamboAI {
     controller: AbortController,
   ): Promise<Response> {
     const { signal, method, ...options } = init || {};
-    if (signal) signal.addEventListener('abort', () => controller.abort());
+    const abort = controller.abort.bind(controller);
+    if (signal) signal.addEventListener('abort', abort, { once: true });
 
-    const timeout = setTimeout(() => controller.abort(), ms);
+    const timeout = setTimeout(abort, ms);
 
     const isReadableBody =
       ((globalThis as any).ReadableStream && options.body instanceof (globalThis as any).ReadableStream) ||

package/src/internal/parse.ts

@@ -43,6 +43,12 @@ export async function defaultParseResponse<T>(client: TamboAI, props: APIRespons
     const mediaType = contentType?.split(';')[0]?.trim();
     const isJSON = mediaType?.includes('application/json') || mediaType?.endsWith('+json');
     if (isJSON) {
+      const contentLength = response.headers.get('content-length');
+      if (contentLength === '0') {
+        // if there is no content we can't do anything
+        return undefined as T;
+      }
+
       const json = await response.json();
       return json as T;
     }

package/src/resources/threads/index.ts

@@ -18,6 +18,13 @@ export {
   type RunRunParams,
 } from './runs';
 export { State, type StateUpdateStateResponse, type StateUpdateStateParams } from './state';
+export {
+  Suggestions,
+  type SuggestionCreateResponse,
+  type SuggestionListResponse,
+  type SuggestionCreateParams,
+  type SuggestionListParams,
+} from './suggestions';
 export {
   Threads,
   type ComponentContent,

package/src/resources/threads/messages.ts

@@ -136,7 +136,7 @@ export interface MessageListParams {
   /**
    * Maximum number of messages to return
    */
-  limit?: string;
+  limit?: number;
 
   /**
    * Sort order: 'asc' for oldest first, 'desc' for newest first

package/src/resources/threads/runs.ts

@@ -88,6 +88,12 @@ export interface InputMessage {
    */
   role: 'user';
 
+  /**
+   * Additional context to provide to the AI beyond the user query, such as current
+   * page URL or application state
+   */
+  additionalContext?: unknown;
+
   /**
    * Additional metadata to attach to the message
    */
@@ -190,7 +196,7 @@ export interface RunCreateParams {
   tools?: Array<RunCreateParams.Tool>;
 
   /**
-   * Optional user key for thread organization
+   * Identifier for a user in your system. Required if no bearer token is provided.
    */
   userKey?: string;
 }
@@ -233,7 +239,7 @@ export namespace RunCreateParams {
     metadata?: unknown;
 
     /**
-     * Optional user key for thread organization
+     * Identifier for a user in your system. Required if no bearer token is provided.
      */
     userKey?: string;
   }
@@ -325,7 +331,7 @@ export interface RunRunParams {
   tools?: Array<RunRunParams.Tool>;
 
   /**
-   * Optional user key for thread organization
+   * Identifier for a user in your system. Required if no bearer token is provided.
    */
   userKey?: string;
 }

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?: number;
+
+  /**
+   * 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
@@ -471,7 +480,7 @@ export interface ThreadCreateParams {
   metadata?: unknown;
 
   /**
-   * Optional user key for thread organization
+   * Identifier for a user in your system. Required if no bearer token is provided.
    */
   userKey?: string;
 }
@@ -492,7 +501,7 @@ export interface ThreadListParams {
   /**
    * Maximum number of threads to return
    */
-  limit?: string;
+  limit?: number;
 
   /**
    * Filter by user key
@@ -503,6 +512,7 @@ export interface ThreadListParams {
 Threads.State = State;
 Threads.Messages = Messages;
 Threads.Runs = Runs;
+Threads.Suggestions = Suggestions;
 
 export declare namespace Threads {
   export {
@@ -544,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.87.0'; // x-release-please-version
+export const VERSION = '0.89.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.87.0";
+export declare const VERSION = "0.89.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.87.0'; // x-release-please-version
+exports.VERSION = '0.89.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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