@tambo-ai/typescript-sdk 0.86.0 → 0.88.0

package/resources/threads/threads.d.mts

@@ -7,12 +7,15 @@ import * as RunsAPI from "./runs.mjs";
 import { InputMessage, RunCreateParams, RunCreateResponse, RunDeleteParams, RunDeleteResponse, RunRunParams, RunRunResponse, Runs } from "./runs.mjs";
 import * as StateAPI from "./state.mjs";
 import { State, StateUpdateStateParams, StateUpdateStateResponse } from "./state.mjs";
+import * as SuggestionsAPI from "./suggestions.mjs";
+import { SuggestionCreateParams, SuggestionCreateResponse, SuggestionListParams, SuggestionListResponse, Suggestions } from "./suggestions.mjs";
 import { APIPromise } from "../../core/api-promise.mjs";
 import { RequestOptions } from "../../internal/request-options.mjs";
 export declare class Threads extends APIResource {
     state: StateAPI.State;
     messages: MessagesAPI.Messages;
     runs: RunsAPI.Runs;
+    suggestions: SuggestionsAPI.Suggestions;
     /**
      * Create a new empty thread. Note: initialMessages is not supported yet; create
      * the thread first, then add messages via runs/message endpoints.
@@ -34,10 +37,10 @@ export declare class Threads extends APIResource {
      * );
      * ```
      */
-    retrieve(threadID: string, options?: RequestOptions): APIPromise<ThreadRetrieveResponse>;
+    retrieve(threadID: string, query?: ThreadRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<ThreadRetrieveResponse>;
     /**
      * List all threads for the authenticated project. Supports cursor-based pagination
-     * and filtering by context key.
+     * and filtering by user key.
      *
      * @example
      * ```ts
@@ -161,10 +164,6 @@ export interface ThreadCreateResponse {
      * 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)
      */
@@ -195,6 +194,10 @@ 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 {
     /**
@@ -218,10 +221,6 @@ export interface ThreadRetrieveResponse {
      * 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)
      */
@@ -252,6 +251,10 @@ export interface ThreadRetrieveResponse {
      * Human-readable status message (e.g., 'Fetching weather data...')
      */
     statusMessage?: string;
+    /**
+     * Optional user key for thread organization
+     */
+    userKey?: string;
 }
 export declare namespace ThreadRetrieveResponse {
     interface Message {
@@ -310,10 +313,6 @@ export declare namespace ThreadListResponse {
          * 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)
          */
@@ -344,13 +343,13 @@ export declare 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
      */
@@ -359,12 +358,18 @@ 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
      */
@@ -373,11 +378,16 @@ export interface ThreadListParams {
      * Maximum number of threads to return
      */
     limit?: string;
+    /**
+     * Filter by user key
+     */
+    userKey?: 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 { 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 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, type MessageGetResponse as MessageGetResponse, type MessageListParams as MessageListParams, type MessageGetParams as MessageGetParams, };
     export { Runs as Runs, type InputMessage as InputMessage, type RunCreateResponse as RunCreateResponse, type RunDeleteResponse as RunDeleteResponse, type RunRunResponse as RunRunResponse, type RunCreateParams as RunCreateParams, 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, };
 }
 //# sourceMappingURL=threads.d.mts.map

package/resources/threads/threads.d.mts.map

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

package/resources/threads/threads.d.ts

@@ -7,12 +7,15 @@ import * as RunsAPI from "./runs.js";
 import { InputMessage, RunCreateParams, RunCreateResponse, RunDeleteParams, RunDeleteResponse, RunRunParams, RunRunResponse, Runs } from "./runs.js";
 import * as StateAPI from "./state.js";
 import { State, StateUpdateStateParams, StateUpdateStateResponse } from "./state.js";
+import * as SuggestionsAPI from "./suggestions.js";
+import { SuggestionCreateParams, SuggestionCreateResponse, SuggestionListParams, SuggestionListResponse, Suggestions } from "./suggestions.js";
 import { APIPromise } from "../../core/api-promise.js";
 import { RequestOptions } from "../../internal/request-options.js";
 export declare class Threads extends APIResource {
     state: StateAPI.State;
     messages: MessagesAPI.Messages;
     runs: RunsAPI.Runs;
+    suggestions: SuggestionsAPI.Suggestions;
     /**
      * Create a new empty thread. Note: initialMessages is not supported yet; create
      * the thread first, then add messages via runs/message endpoints.
@@ -34,10 +37,10 @@ export declare class Threads extends APIResource {
      * );
      * ```
      */
-    retrieve(threadID: string, options?: RequestOptions): APIPromise<ThreadRetrieveResponse>;
+    retrieve(threadID: string, query?: ThreadRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<ThreadRetrieveResponse>;
     /**
      * List all threads for the authenticated project. Supports cursor-based pagination
-     * and filtering by context key.
+     * and filtering by user key.
      *
      * @example
      * ```ts
@@ -161,10 +164,6 @@ export interface ThreadCreateResponse {
      * 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)
      */
@@ -195,6 +194,10 @@ 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 {
     /**
@@ -218,10 +221,6 @@ export interface ThreadRetrieveResponse {
      * 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)
      */
@@ -252,6 +251,10 @@ export interface ThreadRetrieveResponse {
      * Human-readable status message (e.g., 'Fetching weather data...')
      */
     statusMessage?: string;
+    /**
+     * Optional user key for thread organization
+     */
+    userKey?: string;
 }
 export declare namespace ThreadRetrieveResponse {
     interface Message {
@@ -310,10 +313,6 @@ export declare namespace ThreadListResponse {
          * 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)
          */
@@ -344,13 +343,13 @@ export declare 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
      */
@@ -359,12 +358,18 @@ 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
      */
@@ -373,11 +378,16 @@ export interface ThreadListParams {
      * Maximum number of threads to return
      */
     limit?: string;
+    /**
+     * Filter by user key
+     */
+    userKey?: 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 { 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 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, type MessageGetResponse as MessageGetResponse, type MessageListParams as MessageListParams, type MessageGetParams as MessageGetParams, };
     export { Runs as Runs, type InputMessage as InputMessage, type RunCreateResponse as RunCreateResponse, type RunDeleteResponse as RunDeleteResponse, type RunRunResponse as RunRunResponse, type RunCreateParams as RunCreateParams, 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, };
 }
 //# sourceMappingURL=threads.d.ts.map

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

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

package/resources/threads/threads.js

@@ -10,6 +10,8 @@ const RunsAPI = tslib_1.__importStar(require("./runs.js"));
 const runs_1 = require("./runs.js");
 const StateAPI = tslib_1.__importStar(require("./state.js"));
 const state_1 = require("./state.js");
+const SuggestionsAPI = tslib_1.__importStar(require("./suggestions.js"));
+const suggestions_1 = require("./suggestions.js");
 const headers_1 = require("../../internal/headers.js");
 const path_1 = require("../../internal/utils/path.js");
 class Threads extends resource_1.APIResource {
@@ -18,6 +20,7 @@ class Threads extends resource_1.APIResource {
         this.state = new StateAPI.State(this._client);
         this.messages = new MessagesAPI.Messages(this._client);
         this.runs = new RunsAPI.Runs(this._client);
+        this.suggestions = new SuggestionsAPI.Suggestions(this._client);
     }
     /**
      * Create a new empty thread. Note: initialMessages is not supported yet; create
@@ -42,12 +45,12 @@ class Threads extends resource_1.APIResource {
      * );
      * ```
      */
-    retrieve(threadID, options) {
-        return this._client.get((0, path_1.path) `/v1/threads/${threadID}`, options);
+    retrieve(threadID, query = {}, options) {
+        return this._client.get((0, path_1.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
@@ -76,4 +79,5 @@ exports.Threads = Threads;
 Threads.State = state_1.State;
 Threads.Messages = messages_1.Messages;
 Threads.Runs = runs_1.Runs;
+Threads.Suggestions = suggestions_1.Suggestions;
 //# sourceMappingURL=threads.js.map

package/resources/threads/threads.js.map

@@ -1 +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,oCASgB;AAChB,6DAAoC;AACpC,sCAAkF;AAElF,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,OAAQ,SAAQ,sBAAW;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;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;AA/DD,0BA+DC;AA6YD,OAAO,CAAC,KAAK,GAAG,aAAK,CAAC;AACtB,OAAO,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC5B,OAAO,CAAC,IAAI,GAAG,WAAI,CAAC"}
+{"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,oCASgB;AAChB,6DAAoC;AACpC,sCAAkF;AAClF,yEAAgD;AAChD,kDAMuB;AAEvB,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,OAAQ,SAAQ,sBAAW;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,IAAA,WAAI,EAAA,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,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;AApED,0BAoEC;AAoZD,OAAO,CAAC,KAAK,GAAG,aAAK,CAAC;AACtB,OAAO,CAAC,QAAQ,GAAG,mBAAQ,CAAC;AAC5B,OAAO,CAAC,IAAI,GAAG,WAAI,CAAC;AACpB,OAAO,CAAC,WAAW,GAAG,yBAAW,CAAC"}

package/resources/threads/threads.mjs

@@ -6,6 +6,8 @@ import * as RunsAPI from "./runs.mjs";
 import { Runs, } from "./runs.mjs";
 import * as StateAPI from "./state.mjs";
 import { State } from "./state.mjs";
+import * as SuggestionsAPI from "./suggestions.mjs";
+import { Suggestions, } from "./suggestions.mjs";
 import { buildHeaders } from "../../internal/headers.mjs";
 import { path } from "../../internal/utils/path.mjs";
 export class Threads extends APIResource {
@@ -14,6 +16,7 @@ export class Threads extends APIResource {
         this.state = new StateAPI.State(this._client);
         this.messages = new MessagesAPI.Messages(this._client);
         this.runs = new RunsAPI.Runs(this._client);
+        this.suggestions = new SuggestionsAPI.Suggestions(this._client);
     }
     /**
      * Create a new empty thread. Note: initialMessages is not supported yet; create
@@ -38,12 +41,12 @@ export class Threads extends APIResource {
      * );
      * ```
      */
-    retrieve(threadID, options) {
-        return this._client.get(path `/v1/threads/${threadID}`, options);
+    retrieve(threadID, query = {}, options) {
+        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
@@ -71,4 +74,5 @@ export class Threads extends APIResource {
 Threads.State = State;
 Threads.Messages = Messages;
 Threads.Runs = Runs;
+Threads.Suggestions = Suggestions;
 //# sourceMappingURL=threads.mjs.map

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;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;AA6YD,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

@@ -29,6 +29,7 @@ import {
   ThreadCreateResponse,
   ThreadListParams,
   ThreadListResponse,
+  ThreadRetrieveParams,
   ThreadRetrieveResponse,
   Threads,
   ToolResultContent,
@@ -847,6 +848,7 @@ export declare namespace TamboAI {
     type ThreadRetrieveResponse as ThreadRetrieveResponse,
     type ThreadListResponse as ThreadListResponse,
     type ThreadCreateParams as ThreadCreateParams,
+    type ThreadRetrieveParams as ThreadRetrieveParams,
     type ThreadListParams as ThreadListParams,
   };
 

package/src/resources/index.ts

@@ -15,5 +15,6 @@ export {
   type ThreadRetrieveResponse,
   type ThreadListResponse,
   type ThreadCreateParams,
+  type ThreadRetrieveParams,
   type ThreadListParams,
 } from './threads/threads';

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,
@@ -30,5 +37,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>;
+
+  /**
+   * Identifier for a user in your system. Required if no bearer token is provided.
+   */
+  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;
+
+    /**
+     * Identifier for a user in your system. Required if no bearer token is provided.
+     */
+    userKey?: string;
   }
 
   export interface Name {
@@ -318,6 +323,11 @@ export interface RunRunParams {
    * Client-side tools the model can call
    */
   tools?: Array<RunRunParams.Tool>;
+
+  /**
+   * Identifier for a user in your system. Required if no bearer token is provided.
+   */
+  userKey?: string;
 }
 
 export namespace RunRunParams {

package/src/resources/threads/state.ts

@@ -14,10 +14,7 @@ export class State extends APIResource {
    * ```ts
    * const response = await client.threads.state.updateState(
    *   'comp_xyz789abc',
-   *   {
-   *     threadId: 'thr_abc123xyz',
-   *     state: { foo: 'bar' },
-   *   },
+   *   { threadId: 'thr_abc123xyz' },
    * );
    * ```
    */
@@ -41,55 +38,44 @@ export interface StateUpdateStateResponse {
   state: unknown;
 }
 
-export type StateUpdateStateParams = StateUpdateStateParams.Variant0 | StateUpdateStateParams.Variant1;
+export interface StateUpdateStateParams {
+  /**
+   * Path param: Thread ID
+   */
+  threadId: string;
+
+  /**
+   * Body param: JSON Patch operations to apply to current state
+   */
+  patch?: Array<StateUpdateStateParams.Patch>;
 
-export declare namespace StateUpdateStateParams {
-  export interface Variant0 {
+  /**
+   * Body param: Full replacement state object
+   */
+  state?: unknown;
+}
+
+export namespace StateUpdateStateParams {
+  export interface Patch {
     /**
-     * Path param: Thread ID
+     * Operation type
      */
-    threadId: string;
+    op: 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test';
 
     /**
-     * Body param
+     * JSON Pointer path to the target location
      */
-    state: { [key: string]: unknown };
-  }
+    path: string;
 
-  export interface Variant1 {
     /**
-     * Path param: Thread ID
+     * Source path for move and copy operations
      */
-    threadId: string;
+    from?: string;
 
     /**
-     * Body param
+     * Value to add, replace, or test (required for add, replace, test)
      */
-    patch: Array<Variant1.Patch>;
-  }
-
-  export namespace Variant1 {
-    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;
-    }
+    value?: unknown;
   }
 }