@tambo-ai/typescript-sdk 0.70.0 → 0.71.0

package/src/pagination.ts

@@ -1,73 +1,2 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { AbstractPage, Response, APIClient, FinalRequestOptions, PageInfo } from './core';
-
-export interface OffsetAndLimitResponse<Item> {
-  items: Array<Item>;
-
-  total: number;
-
-  count: number;
-}
-
-export interface OffsetAndLimitParams {
-  offset?: number;
-
-  limit?: number;
-}
-
-export class OffsetAndLimit<Item> extends AbstractPage<Item> implements OffsetAndLimitResponse<Item> {
-  items: Array<Item>;
-
-  total: number;
-
-  count: number;
-
-  constructor(
-    client: APIClient,
-    response: Response,
-    body: OffsetAndLimitResponse<Item>,
-    options: FinalRequestOptions,
-  ) {
-    super(client, response, body, options);
-
-    this.items = body.items || [];
-    this.total = body.total || 0;
-    this.count = body.count || 0;
-  }
-
-  getPaginatedItems(): Item[] {
-    return this.items ?? [];
-  }
-
-  // @deprecated Please use `nextPageInfo()` instead
-  nextPageParams(): Partial<OffsetAndLimitParams> | null {
-    const info = this.nextPageInfo();
-    if (!info) return null;
-    if ('params' in info) return info.params;
-    const params = Object.fromEntries(info.url.searchParams);
-    if (!Object.keys(params).length) return null;
-    return params;
-  }
-
-  nextPageInfo(): PageInfo | null {
-    const offset = (this.options.query as OffsetAndLimitParams).offset ?? 0;
-    if (!offset) {
-      return null;
-    }
-
-    const length = this.getPaginatedItems().length;
-    const currentCount = offset + length;
-
-    const totalCount = this.total;
-    if (!totalCount) {
-      return null;
-    }
-
-    if (currentCount < totalCount) {
-      return { params: { offset: currentCount } };
-    }
-
-    return null;
-  }
-}
+/** @deprecated Import from ./core/pagination instead */
+export * from './core/pagination';

package/src/resource.ts

@@ -1,11 +1,2 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import type { TamboAI } from './index';
-
-export abstract class APIResource {
-  protected _client: TamboAI;
-
-  constructor(client: TamboAI) {
-    this._client = client;
-  }
-}
+/** @deprecated Import from ./core/resource instead */
+export * from './core/resource';

package/src/resources/beta/auth.ts

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../resource';
-import * as Core from '../../core';
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
 
 export class Auth extends APIResource {
   /**
@@ -15,10 +17,7 @@ export class Auth extends APIResource {
    * });
    * ```
    */
-  getMcpToken(
-    body: AuthGetMcpTokenParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<AuthGetMcpTokenResponse> {
+  getMcpToken(body: AuthGetMcpTokenParams, options?: RequestOptions): APIPromise<AuthGetMcpTokenResponse> {
     return this._client.post('/auth/mcp-access-token', { body, ...options });
   }
 
@@ -39,11 +38,11 @@ export class Auth extends APIResource {
    * });
    * ```
    */
-  getToken(body: AuthGetTokenParams, options?: Core.RequestOptions): Core.APIPromise<AuthGetTokenResponse> {
+  getToken(body: AuthGetTokenParams, options?: RequestOptions): APIPromise<AuthGetTokenResponse> {
     return this._client.post('/oauth/token', {
       body,
       ...options,
-      headers: { 'Content-Type': 'application/x-www-form-urlencoded', ...options?.headers },
+      headers: buildHeaders([{ 'Content-Type': 'application/x-www-form-urlencoded' }, options?.headers]),
     });
   }
 }

package/src/resources/beta/beta.ts

@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../resource';
+import { APIResource } from '../../core/resource';
 import * as AuthAPI from './auth';
 import {
   Auth,
@@ -48,7 +48,6 @@ export class Beta extends APIResource {
 Beta.Registry = Registry;
 Beta.Projects = Projects;
 Beta.Threads = Threads;
-Beta.ThreadsOffsetAndLimit = ThreadsOffsetAndLimit;
 Beta.Auth = Auth;
 
 export declare namespace Beta {
@@ -70,7 +69,7 @@ export declare namespace Beta {
     type ThreadRetrieveResponse as ThreadRetrieveResponse,
     type ThreadAdvanceResponse as ThreadAdvanceResponse,
     type ThreadAdvanceByIDResponse as ThreadAdvanceByIDResponse,
-    ThreadsOffsetAndLimit as ThreadsOffsetAndLimit,
+    type ThreadsOffsetAndLimit as ThreadsOffsetAndLimit,
     type ThreadCreateParams as ThreadCreateParams,
     type ThreadRetrieveParams as ThreadRetrieveParams,
     type ThreadUpdateParams as ThreadUpdateParams,

package/src/resources/beta/index.ts

@@ -16,7 +16,6 @@ export {
 } from './projects/index';
 export { Registry, type RegistryRetrieveResponse } from './registry';
 export {
-  ThreadsOffsetAndLimit,
   Threads,
   type ChatCompletionContentPart,
   type ComponentDecisionV2,
@@ -32,4 +31,5 @@ export {
   type ThreadAdvanceParams,
   type ThreadAdvanceByIDParams,
   type ThreadGenerateNameParams,
+  type ThreadsOffsetAndLimit,
 } from './threads/index';

package/src/resources/beta/projects/api-key.ts

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../resource';
-import * as Core from '../../../core';
+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 APIKey extends APIResource {
   /**
@@ -12,21 +14,26 @@ export class APIKey extends APIResource {
    * );
    * ```
    */
-  list(id: string, options?: Core.RequestOptions): Core.APIPromise<APIKeyListResponse> {
-    return this._client.get(`/projects/${id}/api-keys`, options);
+  list(id: string, options?: RequestOptions): APIPromise<APIKeyListResponse> {
+    return this._client.get(path`/projects/${id}/api-keys`, options);
   }
 
   /**
    * @example
    * ```ts
    * const apiKey = await client.beta.projects.apiKey.delete(
-   *   'id',
    *   'apiKeyId',
+   *   { id: 'id' },
    * );
    * ```
    */
-  delete(id: string, apiKeyId: string, options?: Core.RequestOptions): Core.APIPromise<APIKeyDeleteResponse> {
-    return this._client.delete(`/projects/${id}/api-key/${apiKeyId}`, options);
+  delete(
+    apiKeyID: string,
+    params: APIKeyDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<APIKeyDeleteResponse> {
+    const { id } = params;
+    return this._client.delete(path`/projects/${id}/api-key/${apiKeyID}`, options);
   }
 }
 
@@ -50,6 +57,14 @@ export namespace APIKeyListResponse {
 
 export type APIKeyDeleteResponse = boolean;
 
+export interface APIKeyDeleteParams {
+  id: string;
+}
+
 export declare namespace APIKey {
-  export { type APIKeyListResponse as APIKeyListResponse, type APIKeyDeleteResponse as APIKeyDeleteResponse };
+  export {
+    type APIKeyListResponse as APIKeyListResponse,
+    type APIKeyDeleteResponse as APIKeyDeleteResponse,
+    type APIKeyDeleteParams as APIKeyDeleteParams,
+  };
 }

package/src/resources/beta/projects/index.ts

@@ -1,10 +1,20 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export { APIKey, type APIKeyListResponse, type APIKeyDeleteResponse } from './api-key';
+export {
+  APIKey,
+  type APIKeyListResponse,
+  type APIKeyDeleteResponse,
+  type APIKeyDeleteParams,
+} from './api-key';
 export {
   Projects,
   type ProjectRetrieveResponse,
   type ProjectDeleteResponse,
   type ProjectGetCurrentResponse,
 } from './projects';
-export { ProviderKey, type ProviderKeyListResponse, type ProviderKeyDeleteResponse } from './provider-key';
+export {
+  ProviderKey,
+  type ProviderKeyListResponse,
+  type ProviderKeyDeleteResponse,
+  type ProviderKeyDeleteParams,
+} from './provider-key';

package/src/resources/beta/projects/projects.ts

@@ -1,11 +1,18 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../resource';
-import * as Core from '../../../core';
+import { APIResource } from '../../../core/resource';
 import * as APIKeyAPI from './api-key';
-import { APIKey, APIKeyDeleteResponse, APIKeyListResponse } from './api-key';
+import { APIKey, APIKeyDeleteParams, APIKeyDeleteResponse, APIKeyListResponse } from './api-key';
 import * as ProviderKeyAPI from './provider-key';
-import { ProviderKey, ProviderKeyDeleteResponse, ProviderKeyListResponse } from './provider-key';
+import {
+  ProviderKey,
+  ProviderKeyDeleteParams,
+  ProviderKeyDeleteResponse,
+  ProviderKeyListResponse,
+} from './provider-key';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
 
 export class Projects extends APIResource {
   apiKey: APIKeyAPI.APIKey = new APIKeyAPI.APIKey(this._client);
@@ -17,8 +24,8 @@ export class Projects extends APIResource {
    * const project = await client.beta.projects.retrieve('id');
    * ```
    */
-  retrieve(id: string, options?: Core.RequestOptions): Core.APIPromise<ProjectRetrieveResponse> {
-    return this._client.get(`/projects/${id}`, options);
+  retrieve(id: string, options?: RequestOptions): APIPromise<ProjectRetrieveResponse> {
+    return this._client.get(path`/projects/${id}`, options);
   }
 
   /**
@@ -27,8 +34,8 @@ export class Projects extends APIResource {
    * const project = await client.beta.projects.delete('id');
    * ```
    */
-  delete(id: string, options?: Core.RequestOptions): Core.APIPromise<ProjectDeleteResponse> {
-    return this._client.delete(`/projects/${id}`, options);
+  delete(id: string, options?: RequestOptions): APIPromise<ProjectDeleteResponse> {
+    return this._client.delete(path`/projects/${id}`, options);
   }
 
   /**
@@ -37,7 +44,7 @@ export class Projects extends APIResource {
    * const response = await client.beta.projects.getCurrent();
    * ```
    */
-  getCurrent(options?: Core.RequestOptions): Core.APIPromise<ProjectGetCurrentResponse> {
+  getCurrent(options?: RequestOptions): APIPromise<ProjectGetCurrentResponse> {
     return this._client.get('/projects', options);
   }
 }
@@ -118,11 +125,13 @@ export declare namespace Projects {
     APIKey as APIKey,
     type APIKeyListResponse as APIKeyListResponse,
     type APIKeyDeleteResponse as APIKeyDeleteResponse,
+    type APIKeyDeleteParams as APIKeyDeleteParams,
   };
 
   export {
     ProviderKey as ProviderKey,
     type ProviderKeyListResponse as ProviderKeyListResponse,
     type ProviderKeyDeleteResponse as ProviderKeyDeleteResponse,
+    type ProviderKeyDeleteParams as ProviderKeyDeleteParams,
   };
 }

package/src/resources/beta/projects/provider-key.ts

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../resource';
-import * as Core from '../../../core';
+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 ProviderKey extends APIResource {
   /**
@@ -11,8 +13,8 @@ export class ProviderKey extends APIResource {
    *   await client.beta.projects.providerKey.list('id');
    * ```
    */
-  list(id: string, options?: Core.RequestOptions): Core.APIPromise<ProviderKeyListResponse> {
-    return this._client.get(`/projects/${id}/provider-keys`, options);
+  list(id: string, options?: RequestOptions): APIPromise<ProviderKeyListResponse> {
+    return this._client.get(path`/projects/${id}/provider-keys`, options);
   }
 
   /**
@@ -20,17 +22,18 @@ export class ProviderKey extends APIResource {
    * ```ts
    * const providerKey =
    *   await client.beta.projects.providerKey.delete(
-   *     'id',
    *     'providerKeyId',
+   *     { id: 'id' },
    *   );
    * ```
    */
   delete(
-    id: string,
-    providerKeyId: string,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<ProviderKeyDeleteResponse> {
-    return this._client.delete(`/projects/${id}/provider-key/${providerKeyId}`, options);
+    providerKeyID: string,
+    params: ProviderKeyDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<ProviderKeyDeleteResponse> {
+    const { id } = params;
+    return this._client.delete(path`/projects/${id}/provider-key/${providerKeyID}`, options);
   }
 }
 
@@ -54,9 +57,14 @@ export interface ProviderKeyDeleteResponse {
   name: string;
 }
 
+export interface ProviderKeyDeleteParams {
+  id: string;
+}
+
 export declare namespace ProviderKey {
   export {
     type ProviderKeyListResponse as ProviderKeyListResponse,
     type ProviderKeyDeleteResponse as ProviderKeyDeleteResponse,
+    type ProviderKeyDeleteParams as ProviderKeyDeleteParams,
   };
 }

package/src/resources/beta/registry.ts

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../resource';
-import * as Core from '../../core';
+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 Registry extends APIResource {
   /**
@@ -12,8 +14,8 @@ export class Registry extends APIResource {
    * );
    * ```
    */
-  retrieve(componentname: string, options?: Core.RequestOptions): Core.APIPromise<unknown> {
-    return this._client.get(`/registry/${componentname}`, options);
+  retrieve(componentname: string, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.get(path`/registry/${componentname}`, options);
   }
 }
 

package/src/resources/beta/threads/index.ts

@@ -6,6 +6,7 @@ export {
   type MessageListResponse,
   type MessageCreateParams,
   type MessageListParams,
+  type MessageDeleteParams,
   type MessageUpdateComponentStateParams,
 } from './messages';
 export {
@@ -14,10 +15,10 @@ export {
   type SuggestionsGenerate,
   type SuggestionListResponse,
   type SuggestionGenerateResponse,
+  type SuggestionListParams,
   type SuggestionGenerateParams,
 } from './suggestions';
 export {
-  ThreadsOffsetAndLimit,
   Threads,
   type ChatCompletionContentPart,
   type ComponentDecisionV2,
@@ -33,4 +34,5 @@ export {
   type ThreadAdvanceParams,
   type ThreadAdvanceByIDParams,
   type ThreadGenerateNameParams,
+  type ThreadsOffsetAndLimit,
 } from './threads';

package/src/resources/beta/threads/messages.ts

@@ -1,10 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../resource';
-import { isRequestOptions } from '../../../core';
-import * as Core from '../../../core';
+import { APIResource } from '../../../core/resource';
 import * as Shared from '../../shared';
 import * as ThreadsAPI from './threads';
+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 Messages extends APIResource {
   /**
@@ -16,8 +18,8 @@ export class Messages extends APIResource {
    * );
    * ```
    */
-  create(id: string, body: MessageCreateParams, options?: Core.RequestOptions): Core.APIPromise<unknown> {
-    return this._client.post(`/threads/${id}/messages`, { body, ...options });
+  create(id: string, body: MessageCreateParams, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.post(path`/threads/${id}/messages`, { body, ...options });
   }
 
   /**
@@ -29,34 +31,25 @@ export class Messages extends APIResource {
    */
   list(
     id: string,
-    query?: MessageListParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<MessageListResponse>;
-  list(id: string, options?: Core.RequestOptions): Core.APIPromise<MessageListResponse>;
-  list(
-    id: string,
-    query: MessageListParams | Core.RequestOptions = {},
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<MessageListResponse> {
-    if (isRequestOptions(query)) {
-      return this.list(id, {}, query);
-    }
-    return this._client.get(`/threads/${id}/messages`, { query, ...options });
+    query: MessageListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MessageListResponse> {
+    return this._client.get(path`/threads/${id}/messages`, { query, ...options });
   }
 
   /**
    * @example
    * ```ts
-   * await client.beta.threads.messages.delete(
-   *   'id',
-   *   'messageId',
-   * );
+   * await client.beta.threads.messages.delete('messageId', {
+   *   id: 'id',
+   * });
    * ```
    */
-  delete(id: string, messageId: string, options?: Core.RequestOptions): Core.APIPromise<void> {
-    return this._client.delete(`/threads/${id}/messages/${messageId}`, {
+  delete(messageID: string, params: MessageDeleteParams, options?: RequestOptions): APIPromise<void> {
+    const { id } = params;
+    return this._client.delete(path`/threads/${id}/messages/${messageID}`, {
       ...options,
-      headers: { Accept: '*/*', ...options?.headers },
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
@@ -65,19 +58,18 @@ export class Messages extends APIResource {
    * ```ts
    * const threadMessage =
    *   await client.beta.threads.messages.updateComponentState(
-   *     'id',
    *     'messageId',
-   *     { state: { foo: 'bar' } },
+   *     { id: 'id', state: { foo: 'bar' } },
    *   );
    * ```
    */
   updateComponentState(
-    id: string,
-    messageId: string,
-    body: MessageUpdateComponentStateParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<ThreadsAPI.ThreadMessage> {
-    return this._client.put(`/threads/${id}/messages/${messageId}/component-state`, { body, ...options });
+    messageID: string,
+    params: MessageUpdateComponentStateParams,
+    options?: RequestOptions,
+  ): APIPromise<ThreadsAPI.ThreadMessage> {
+    const { id, ...body } = params;
+    return this._client.put(path`/threads/${id}/messages/${messageID}/component-state`, { body, ...options });
   }
 }
 
@@ -134,7 +126,19 @@ export interface MessageListParams {
   includeInternal?: boolean;
 }
 
+export interface MessageDeleteParams {
+  id: string;
+}
+
 export interface MessageUpdateComponentStateParams {
+  /**
+   * Path param:
+   */
+  id: string;
+
+  /**
+   * Body param:
+   */
   state: { [key: string]: unknown };
 }
 
@@ -144,6 +148,7 @@ export declare namespace Messages {
     type MessageListResponse as MessageListResponse,
     type MessageCreateParams as MessageCreateParams,
     type MessageListParams as MessageListParams,
+    type MessageDeleteParams as MessageDeleteParams,
     type MessageUpdateComponentStateParams as MessageUpdateComponentStateParams,
   };
 }

package/src/resources/beta/threads/suggestions.ts

@@ -1,8 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { APIResource } from '../../../resource';
-import * as Core from '../../../core';
+import { APIResource } from '../../../core/resource';
 import * as Shared from '../../shared';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
 
 export class Suggestions extends APIResource {
   /**
@@ -12,17 +14,18 @@ export class Suggestions extends APIResource {
    * ```ts
    * const suggestions =
    *   await client.beta.threads.suggestions.list(
-   *     'thread_123456789',
    *     'msg_123456789',
+   *     { id: 'thread_123456789' },
    *   );
    * ```
    */
   list(
-    id: string,
-    messageId: string,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<SuggestionListResponse> {
-    return this._client.get(`/threads/${id}/messages/${messageId}/suggestions`, options);
+    messageID: string,
+    params: SuggestionListParams,
+    options?: RequestOptions,
+  ): APIPromise<SuggestionListResponse> {
+    const { id } = params;
+    return this._client.get(path`/threads/${id}/messages/${messageID}/suggestions`, options);
   }
 
   /**
@@ -32,18 +35,18 @@ export class Suggestions extends APIResource {
    * ```ts
    * const suggestions =
    *   await client.beta.threads.suggestions.generate(
-   *     'thread_123456789',
    *     'msg_123456789',
+   *     { id: 'thread_123456789' },
    *   );
    * ```
    */
   generate(
-    id: string,
-    messageId: string,
-    body: SuggestionGenerateParams,
-    options?: Core.RequestOptions,
-  ): Core.APIPromise<SuggestionGenerateResponse> {
-    return this._client.post(`/threads/${id}/messages/${messageId}/suggestions`, { body, ...options });
+    messageID: string,
+    params: SuggestionGenerateParams,
+    options?: RequestOptions,
+  ): APIPromise<SuggestionGenerateResponse> {
+    const { id, ...body } = params;
+    return this._client.post(path`/threads/${id}/messages/${messageID}/suggestions`, { body, ...options });
   }
 }
 
@@ -90,14 +93,26 @@ export type SuggestionListResponse = Array<Suggestion>;
 
 export type SuggestionGenerateResponse = Array<Suggestion>;
 
+export interface SuggestionListParams {
+  /**
+   * ID of the thread to get suggestions for
+   */
+  id: string;
+}
+
 export interface SuggestionGenerateParams {
   /**
-   * Available components that can be used with this suggestion
+   * Path param: ID of the thread to generate suggestions for
+   */
+  id: string;
+
+  /**
+   * Body param: Available components that can be used with this suggestion
    */
   availableComponents?: Array<Shared.AvailableComponent>;
 
   /**
-   * Maximum number of suggestions to generate
+   * Body param: Maximum number of suggestions to generate
    */
   maxSuggestions?: number;
 }
@@ -108,6 +123,7 @@ export declare namespace Suggestions {
     type SuggestionsGenerate as SuggestionsGenerate,
     type SuggestionListResponse as SuggestionListResponse,
     type SuggestionGenerateResponse as SuggestionGenerateResponse,
+    type SuggestionListParams as SuggestionListParams,
     type SuggestionGenerateParams as SuggestionGenerateParams,
   };
 }