@tambo-ai/typescript-sdk 0.85.0 → 0.87.0

package/src/resources/threads/index.ts

@@ -17,6 +17,7 @@ export {
   type RunDeleteParams,
   type RunRunParams,
 } from './runs';
+export { State, type StateUpdateStateResponse, type StateUpdateStateParams } from './state';
 export {
   Threads,
   type ComponentContent,
@@ -29,5 +30,6 @@ export {
   type ThreadRetrieveResponse,
   type ThreadListResponse,
   type ThreadCreateParams,
+  type ThreadRetrieveParams,
   type ThreadListParams,
 } from './threads';

package/src/resources/threads/runs.ts

@@ -188,6 +188,11 @@ export interface RunCreateParams {
    * Client-side tools the model can call
    */
   tools?: Array<RunCreateParams.Tool>;
+
+  /**
+   * Optional user key for thread organization
+   */
+  userKey?: string;
 }
 
 export namespace RunCreateParams {
@@ -217,11 +222,6 @@ export namespace RunCreateParams {
    * Thread configuration
    */
   export interface Thread {
-    /**
-     * Optional context key for thread organization
-     */
-    contextKey?: string;
-
     /**
      * Initial messages to seed the thread with
      */
@@ -231,6 +231,11 @@ export namespace RunCreateParams {
      * Additional metadata to attach to the thread
      */
     metadata?: unknown;
+
+    /**
+     * Optional user key for thread organization
+     */
+    userKey?: string;
   }
 
   export interface Name {
@@ -318,6 +323,11 @@ export interface RunRunParams {
    * Client-side tools the model can call
    */
   tools?: Array<RunRunParams.Tool>;
+
+  /**
+   * Optional user key for thread organization
+   */
+  userKey?: string;
 }
 
 export namespace RunRunParams {

package/src/resources/threads/state.ts

@@ -0,0 +1,87 @@
+// 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';
+import { path } from '../../internal/utils/path';
+
+export class State extends APIResource {
+  /**
+   * Update the state of a component in a thread. Supports both full replacement and
+   * JSON Patch operations. Thread must not have an active run.
+   *
+   * @example
+   * ```ts
+   * const response = await client.threads.state.updateState(
+   *   'comp_xyz789abc',
+   *   { threadId: 'thr_abc123xyz' },
+   * );
+   * ```
+   */
+  updateState(
+    componentID: string,
+    params: StateUpdateStateParams,
+    options?: RequestOptions,
+  ): APIPromise<StateUpdateStateResponse> {
+    const { threadId, ...body } = params;
+    return this._client.post(path`/v1/threads/${threadId}/components/${componentID}/state`, {
+      body,
+      ...options,
+    });
+  }
+}
+
+export interface StateUpdateStateResponse {
+  /**
+   * New complete state of the component
+   */
+  state: unknown;
+}
+
+export interface StateUpdateStateParams {
+  /**
+   * Path param: Thread ID
+   */
+  threadId: string;
+
+  /**
+   * Body param: JSON Patch operations to apply to current state
+   */
+  patch?: Array<StateUpdateStateParams.Patch>;
+
+  /**
+   * Body param: Full replacement state object
+   */
+  state?: unknown;
+}
+
+export namespace StateUpdateStateParams {
+  export interface Patch {
+    /**
+     * Operation type
+     */
+    op: 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test';
+
+    /**
+     * JSON Pointer path to the target location
+     */
+    path: string;
+
+    /**
+     * Source path for move and copy operations
+     */
+    from?: string;
+
+    /**
+     * Value to add, replace, or test (required for add, replace, test)
+     */
+    value?: unknown;
+  }
+}
+
+export declare namespace State {
+  export {
+    type StateUpdateStateResponse as StateUpdateStateResponse,
+    type StateUpdateStateParams as StateUpdateStateParams,
+  };
+}

package/src/resources/threads/threads.ts

@@ -22,12 +22,15 @@ import {
   RunRunResponse,
   Runs,
 } from './runs';
+import * as StateAPI from './state';
+import { State, StateUpdateStateParams, StateUpdateStateResponse } from './state';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 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);
 
@@ -55,13 +58,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
@@ -220,11 +227,6 @@ export interface ThreadCreateResponse {
    */
   updatedAt: string;
 
-  /**
-   * Optional context key for thread organization
-   */
-  contextKey?: string;
-
   /**
    * ID of the currently active run (when not idle)
    */
@@ -261,6 +263,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 {
@@ -290,11 +297,6 @@ export interface ThreadRetrieveResponse {
    */
   updatedAt: string;
 
-  /**
-   * Optional context key for thread organization
-   */
-  contextKey?: string;
-
   /**
    * ID of the currently active run (when not idle)
    */
@@ -331,6 +333,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 {
@@ -408,11 +415,6 @@ export namespace ThreadListResponse {
      */
     updatedAt: string;
 
-    /**
-     * Optional context key for thread organization
-     */
-    contextKey?: string;
-
     /**
      * ID of the currently active run (when not idle)
      */
@@ -449,15 +451,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
    */
@@ -467,14 +469,21 @@ export interface ThreadCreateParams {
    * Additional metadata to attach to the thread
    */
   metadata?: unknown;
+
+  /**
+   * Optional user key for thread organization
+   */
+  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
    */
@@ -484,8 +493,14 @@ 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;
 
@@ -501,9 +516,16 @@ export declare namespace Threads {
     type ThreadRetrieveResponse as ThreadRetrieveResponse,
     type ThreadListResponse as ThreadListResponse,
     type ThreadCreateParams as ThreadCreateParams,
+    type ThreadRetrieveParams as ThreadRetrieveParams,
     type ThreadListParams as ThreadListParams,
   };
 
+  export {
+    State as State,
+    type StateUpdateStateResponse as StateUpdateStateResponse,
+    type StateUpdateStateParams as StateUpdateStateParams,
+  };
+
   export {
     Messages as Messages,
     type MessageListResponse as MessageListResponse,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.85.0'; // x-release-please-version
+export const VERSION = '0.87.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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