@tambo-ai/typescript-sdk 0.80.0 → 0.83.0

package/resources/threads/threads.d.ts

@@ -0,0 +1,391 @@
+import { APIResource } from "../../core/resource.js";
+import * as ThreadsAPI from "./threads.js";
+import * as Shared from "../shared.js";
+import * as MessagesAPI from "./messages.js";
+import { MessageGetParams, MessageGetResponse, MessageListParams, MessageListResponse, Messages } from "./messages.js";
+import * as RunsAPI from "./runs.js";
+import { InputMessage, RunCreateParams, RunDeleteParams, RunDeleteResponse, RunRunParams, Runs } from "./runs.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Threads extends APIResource {
+    messages: MessagesAPI.Messages;
+    runs: RunsAPI.Runs;
+    /**
+     * Create a new empty thread. Note: initialMessages is not supported yet; create
+     * the thread first, then add messages via runs/message endpoints.
+     *
+     * @example
+     * ```ts
+     * const thread = await client.threads.create();
+     * ```
+     */
+    create(body: ThreadCreateParams, options?: RequestOptions): APIPromise<ThreadCreateResponse>;
+    /**
+     * Get a thread by ID with all its messages. The thread must belong to the
+     * authenticated project.
+     *
+     * @example
+     * ```ts
+     * const thread = await client.threads.retrieve(
+     *   'thr_abc123xyz',
+     * );
+     * ```
+     */
+    retrieve(threadID: string, options?: RequestOptions): APIPromise<ThreadRetrieveResponse>;
+    /**
+     * List all threads for the authenticated project. Supports cursor-based pagination
+     * and filtering by context key.
+     *
+     * @example
+     * ```ts
+     * const threads = await client.threads.list();
+     * ```
+     */
+    list(query?: ThreadListParams | null | undefined, options?: RequestOptions): APIPromise<ThreadListResponse>;
+    /**
+     * Delete a thread and all its messages. This action cannot be undone.
+     *
+     * @example
+     * ```ts
+     * await client.threads.delete('thr_abc123xyz');
+     * ```
+     */
+    delete(threadID: string, options?: RequestOptions): APIPromise<void>;
+}
+export interface ComponentContent {
+    /**
+     * Unique identifier for this component instance
+     */
+    id: string;
+    /**
+     * Name of the component to render
+     */
+    name: string;
+    /**
+     * Props to pass to the component
+     */
+    props: unknown;
+    /**
+     * Content block type identifier
+     */
+    type: 'component';
+    /**
+     * Current state of the component
+     */
+    state?: unknown;
+}
+export interface ResourceContent {
+    /**
+     * Resource data containing URI, text, or blob
+     */
+    resource: Shared.Resource;
+    /**
+     * Content block type identifier
+     */
+    type: 'resource';
+}
+export interface RunError {
+    /**
+     * Error message
+     */
+    message: string;
+    /**
+     * Error code
+     */
+    code?: string;
+}
+export interface TextContent {
+    /**
+     * The text content
+     */
+    text: string;
+    /**
+     * Content block type identifier
+     */
+    type: 'text';
+}
+export interface ToolResultContent {
+    /**
+     * Result content (text or resource blocks)
+     */
+    content: Array<TextContent | ResourceContent>;
+    /**
+     * ID of the tool call this result responds to
+     */
+    toolUseId: string;
+    /**
+     * Content block type identifier
+     */
+    type: 'tool_result';
+    /**
+     * Whether the tool call resulted in an error
+     */
+    isError?: boolean;
+}
+export interface ToolUseContent {
+    /**
+     * Unique identifier for this tool call
+     */
+    id: string;
+    /**
+     * Input arguments for the tool
+     */
+    input: unknown;
+    /**
+     * Name of the tool being called
+     */
+    name: string;
+    /**
+     * Content block type identifier
+     */
+    type: 'tool_use';
+}
+export interface ThreadCreateResponse {
+    /**
+     * Unique identifier for this thread
+     */
+    id: string;
+    /**
+     * When the thread was created (ISO 8601)
+     */
+    createdAt: string;
+    /**
+     * Project this thread belongs to
+     */
+    projectId: string;
+    /**
+     * Current run status: idle (no run), waiting (run started, awaiting content),
+     * streaming (receiving content)
+     */
+    runStatus: 'idle' | 'waiting' | 'streaming';
+    /**
+     * When the thread was last updated (ISO 8601)
+     */
+    updatedAt: string;
+    /**
+     * Optional context key for thread organization
+     */
+    contextKey?: string;
+    /**
+     * ID of the currently active run (when not idle)
+     */
+    currentRunId?: string;
+    /**
+     * ID of the last completed run. Required as previousRunId when continuing after
+     * tool calls.
+     */
+    lastCompletedRunId?: string;
+    /**
+     * Whether the last run was cancelled
+     */
+    lastRunCancelled?: boolean;
+    /**
+     * Error information from the last run
+     */
+    lastRunError?: RunError;
+    /**
+     * Additional metadata
+     */
+    metadata?: unknown;
+    /**
+     * Tool call IDs awaiting client-side results. If non-empty, next run must provide
+     * tool_result content with previousRunId set.
+     */
+    pendingToolCallIds?: Array<string>;
+    /**
+     * Human-readable status message (e.g., 'Fetching weather data...')
+     */
+    statusMessage?: string;
+}
+export interface ThreadRetrieveResponse {
+    /**
+     * Unique identifier for this thread
+     */
+    id: string;
+    /**
+     * When the thread was created (ISO 8601)
+     */
+    createdAt: string;
+    /**
+     * Messages in this thread
+     */
+    messages: Array<ThreadRetrieveResponse.Message>;
+    /**
+     * Project this thread belongs to
+     */
+    projectId: string;
+    /**
+     * Current run status: idle (no run), waiting (run started, awaiting content),
+     * streaming (receiving content)
+     */
+    runStatus: 'idle' | 'waiting' | 'streaming';
+    /**
+     * When the thread was last updated (ISO 8601)
+     */
+    updatedAt: string;
+    /**
+     * Optional context key for thread organization
+     */
+    contextKey?: string;
+    /**
+     * ID of the currently active run (when not idle)
+     */
+    currentRunId?: string;
+    /**
+     * ID of the last completed run. Required as previousRunId when continuing after
+     * tool calls.
+     */
+    lastCompletedRunId?: string;
+    /**
+     * Whether the last run was cancelled
+     */
+    lastRunCancelled?: boolean;
+    /**
+     * Error information from the last run
+     */
+    lastRunError?: RunError;
+    /**
+     * Additional metadata
+     */
+    metadata?: unknown;
+    /**
+     * Tool call IDs awaiting client-side results. If non-empty, next run must provide
+     * tool_result content with previousRunId set.
+     */
+    pendingToolCallIds?: Array<string>;
+    /**
+     * Human-readable status message (e.g., 'Fetching weather data...')
+     */
+    statusMessage?: string;
+}
+export declare namespace ThreadRetrieveResponse {
+    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 ThreadListResponse {
+    /**
+     * Whether there are more results
+     */
+    hasMore: boolean;
+    /**
+     * List of threads
+     */
+    threads: Array<ThreadListResponse.Thread>;
+    /**
+     * Cursor for the next page of results
+     */
+    nextCursor?: string;
+}
+export declare namespace ThreadListResponse {
+    interface Thread {
+        /**
+         * Unique identifier for this thread
+         */
+        id: string;
+        /**
+         * When the thread was created (ISO 8601)
+         */
+        createdAt: string;
+        /**
+         * Project this thread belongs to
+         */
+        projectId: string;
+        /**
+         * Current run status: idle (no run), waiting (run started, awaiting content),
+         * streaming (receiving content)
+         */
+        runStatus: 'idle' | 'waiting' | 'streaming';
+        /**
+         * When the thread was last updated (ISO 8601)
+         */
+        updatedAt: string;
+        /**
+         * Optional context key for thread organization
+         */
+        contextKey?: string;
+        /**
+         * ID of the currently active run (when not idle)
+         */
+        currentRunId?: string;
+        /**
+         * ID of the last completed run. Required as previousRunId when continuing after
+         * tool calls.
+         */
+        lastCompletedRunId?: string;
+        /**
+         * Whether the last run was cancelled
+         */
+        lastRunCancelled?: boolean;
+        /**
+         * Error information from the last run
+         */
+        lastRunError?: ThreadsAPI.RunError;
+        /**
+         * Additional metadata
+         */
+        metadata?: unknown;
+        /**
+         * Tool call IDs awaiting client-side results. If non-empty, next run must provide
+         * tool_result content with previousRunId set.
+         */
+        pendingToolCallIds?: Array<string>;
+        /**
+         * Human-readable status message (e.g., 'Fetching weather data...')
+         */
+        statusMessage?: string;
+    }
+}
+export interface ThreadCreateParams {
+    /**
+     * Optional context key for thread organization
+     */
+    contextKey?: string;
+    /**
+     * Initial messages to seed the thread with
+     */
+    initialMessages?: Array<RunsAPI.InputMessage>;
+    /**
+     * Additional metadata to attach to the thread
+     */
+    metadata?: unknown;
+}
+export interface ThreadListParams {
+    /**
+     * Filter by context key
+     */
+    contextKey?: string;
+    /**
+     * Cursor for pagination
+     */
+    cursor?: string;
+    /**
+     * Maximum number of threads to return
+     */
+    limit?: string;
+}
+export declare namespace Threads {
+    export { type ComponentContent as ComponentContent, type ResourceContent as ResourceContent, type RunError as RunError, type TextContent as TextContent, type ToolResultContent as ToolResultContent, type ToolUseContent as ToolUseContent, type ThreadCreateResponse as ThreadCreateResponse, type ThreadRetrieveResponse as ThreadRetrieveResponse, type ThreadListResponse as ThreadListResponse, type ThreadCreateParams as ThreadCreateParams, type ThreadListParams as ThreadListParams, };
+    export { Messages as Messages, type MessageListResponse as MessageListResponse, type MessageGetResponse as MessageGetResponse, type MessageListParams as MessageListParams, type MessageGetParams as MessageGetParams, };
+    export { Runs as Runs, type InputMessage as InputMessage, type RunDeleteResponse as RunDeleteResponse, type RunCreateParams as RunCreateParams, type RunDeleteParams as RunDeleteParams, type RunRunParams as RunRunParams, };
+}
+//# sourceMappingURL=threads.d.ts.map

package/resources/threads/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/resources/threads/threads.ts"],"names":[],"mappings":"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"}

package/resources/threads/threads.js

@@ -0,0 +1,75 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Threads = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const MessagesAPI = tslib_1.__importStar(require("./messages.js"));
+const messages_1 = require("./messages.js");
+const RunsAPI = tslib_1.__importStar(require("./runs.js"));
+const runs_1 = require("./runs.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+class Threads extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.messages = new MessagesAPI.Messages(this._client);
+        this.runs = new RunsAPI.Runs(this._client);
+    }
+    /**
+     * Create a new empty thread. Note: initialMessages is not supported yet; create
+     * the thread first, then add messages via runs/message endpoints.
+     *
+     * @example
+     * ```ts
+     * const thread = await client.threads.create();
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v1/threads', { body, ...options });
+    }
+    /**
+     * Get a thread by ID with all its messages. The thread must belong to the
+     * authenticated project.
+     *
+     * @example
+     * ```ts
+     * const thread = await client.threads.retrieve(
+     *   'thr_abc123xyz',
+     * );
+     * ```
+     */
+    retrieve(threadID, options) {
+        return this._client.get((0, path_1.path) `/v1/threads/${threadID}`, options);
+    }
+    /**
+     * List all threads for the authenticated project. Supports cursor-based pagination
+     * and filtering by context key.
+     *
+     * @example
+     * ```ts
+     * const threads = await client.threads.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/v1/threads', { query, ...options });
+    }
+    /**
+     * Delete a thread and all its messages. This action cannot be undone.
+     *
+     * @example
+     * ```ts
+     * await client.threads.delete('thr_abc123xyz');
+     * ```
+     */
+    delete(threadID, options) {
+        return this._client.delete((0, path_1.path) `/v1/threads/${threadID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Threads = Threads;
+Threads.Messages = messages_1.Messages;
+Threads.Runs = runs_1.Runs;
+//# sourceMappingURL=threads.js.map

package/resources/threads/threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../../src/resources/threads/threads.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAGlD,mEAA0C;AAC1C,4CAMoB;AACpB,2DAAkC;AAClC,oCAOgB;AAEhB,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,OAAQ,SAAQ,sBAAW;IAAxC;;QACE,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;IA4DtD,CAAC;IA1DC;;;;;;;;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,CAAC,QAAgB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,eAAe,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,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,IAAA,WAAI,EAAA,eAAe,QAAQ,EAAE,EAAE;YACxD,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AA9DD,0BA8DC;AA4ZD,OAAO,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC5B,OAAO,CAAC,IAAI,GAAG,WAAI,CAAC"}

package/resources/threads/threads.mjs

@@ -0,0 +1,70 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as MessagesAPI from "./messages.mjs";
+import { Messages, } from "./messages.mjs";
+import * as RunsAPI from "./runs.mjs";
+import { Runs, } from "./runs.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Threads extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.messages = new MessagesAPI.Messages(this._client);
+        this.runs = new RunsAPI.Runs(this._client);
+    }
+    /**
+     * Create a new empty thread. Note: initialMessages is not supported yet; create
+     * the thread first, then add messages via runs/message endpoints.
+     *
+     * @example
+     * ```ts
+     * const thread = await client.threads.create();
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v1/threads', { body, ...options });
+    }
+    /**
+     * Get a thread by ID with all its messages. The thread must belong to the
+     * authenticated project.
+     *
+     * @example
+     * ```ts
+     * const thread = await client.threads.retrieve(
+     *   'thr_abc123xyz',
+     * );
+     * ```
+     */
+    retrieve(threadID, options) {
+        return this._client.get(path `/v1/threads/${threadID}`, options);
+    }
+    /**
+     * List all threads for the authenticated project. Supports cursor-based pagination
+     * and filtering by context key.
+     *
+     * @example
+     * ```ts
+     * const threads = await client.threads.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/v1/threads', { query, ...options });
+    }
+    /**
+     * Delete a thread and all its messages. This action cannot be undone.
+     *
+     * @example
+     * ```ts
+     * await client.threads.delete('thr_abc123xyz');
+     * ```
+     */
+    delete(threadID, options) {
+        return this._client.delete(path `/v1/threads/${threadID}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+Threads.Messages = Messages;
+Threads.Runs = Runs;
+//# sourceMappingURL=threads.mjs.map

package/resources/threads/threads.mjs.map

@@ -0,0 +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,EAML,IAAI,GACL;OAEM,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,OAAQ,SAAQ,WAAW;IAAxC;;QACE,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;IA4DtD,CAAC;IA1DC;;;;;;;;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,CAAC,QAAgB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,eAAe,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,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;AA4ZD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC5B,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC"}

package/resources/threads.d.mts

@@ -0,0 +1,2 @@
+export * from "./threads/index.mjs";
+//# sourceMappingURL=threads.d.mts.map

package/resources/threads.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.mts","sourceRoot":"","sources":["../src/resources/threads.ts"],"names":[],"mappings":""}

package/resources/threads.d.ts

@@ -0,0 +1,2 @@
+export * from "./threads/index.js";
+//# sourceMappingURL=threads.d.ts.map

package/resources/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../src/resources/threads.ts"],"names":[],"mappings":""}

package/resources/threads.js

@@ -0,0 +1,6 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./threads/index.js"), exports);
+//# sourceMappingURL=threads.js.map

package/resources/threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../src/resources/threads.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,6DAAgC"}

package/resources/threads.mjs

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export * from "./threads/index.mjs";
+//# sourceMappingURL=threads.mjs.map

package/resources/threads.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.mjs","sourceRoot":"","sources":["../src/resources/threads.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/src/client.ts

@@ -18,7 +18,22 @@ import { AbstractPage, type OffsetAndLimitParams, OffsetAndLimitResponse } from
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
+import { Storage, StoragePresignParams, StoragePresignResponse } from './resources/storage';
 import { Beta } from './resources/beta/beta';
+import {
+  ComponentContent,
+  ResourceContent,
+  RunError,
+  TextContent,
+  ThreadCreateParams,
+  ThreadCreateResponse,
+  ThreadListParams,
+  ThreadListResponse,
+  ThreadRetrieveResponse,
+  Threads,
+  ToolResultContent,
+  ToolUseContent,
+} from './resources/threads/threads';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -795,9 +810,13 @@ export class TamboAI {
   static toFile = Uploads.toFile;
 
   beta: API.Beta = new API.Beta(this);
+  storage: API.Storage = new API.Storage(this);
+  threads: API.Threads = new API.Threads(this);
 }
 
 TamboAI.Beta = Beta;
+TamboAI.Storage = Storage;
+TamboAI.Threads = Threads;
 
 export declare namespace TamboAI {
   export type RequestOptions = Opts.RequestOptions;
@@ -810,6 +829,27 @@ export declare namespace TamboAI {
 
   export { Beta as Beta };
 
+  export {
+    Storage as Storage,
+    type StoragePresignResponse as StoragePresignResponse,
+    type StoragePresignParams as StoragePresignParams,
+  };
+
+  export {
+    Threads as Threads,
+    type ComponentContent as ComponentContent,
+    type ResourceContent as ResourceContent,
+    type RunError as RunError,
+    type TextContent as TextContent,
+    type ToolResultContent as ToolResultContent,
+    type ToolUseContent as ToolUseContent,
+    type ThreadCreateResponse as ThreadCreateResponse,
+    type ThreadRetrieveResponse as ThreadRetrieveResponse,
+    type ThreadListResponse as ThreadListResponse,
+    type ThreadCreateParams as ThreadCreateParams,
+    type ThreadListParams as ThreadListParams,
+  };
+
   export type AvailableComponent = API.AvailableComponent;
   export type ComponentContextToolMetadata = API.ComponentContextToolMetadata;
   export type Resource = API.Resource;

package/src/lib/advance-stream.ts

@@ -1,11 +1,11 @@
 import { type TamboAI } from '../client';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
-import { ThreadAdvanceParams, ThreadAdvanceResponse } from '../resources/beta';
+import { ThreadAdvanceByIDParams, ThreadAdvanceResponse } from '../resources/beta';
 
 export async function advanceStream(
   client: TamboAI,
-  body: ThreadAdvanceParams,
+  body: ThreadAdvanceByIDParams,
   threadId?: string,
   options?: RequestOptions,
 ): Promise<AsyncIterable<ThreadAdvanceResponse>> {