@arcadeai/arcadejs 0.2.1 → 1.0.0-rc.1

package/resources/tools/tools.js

@@ -24,23 +24,25 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ToolDefinitionsOffsetPage = exports.Tools = void 0;
+exports.ToolExecutionsOffsetPage = exports.ToolListResponsesOffsetPage = exports.Tools = void 0;
 const resource_1 = require("../../resource.js");
 const core_1 = require("../../core.js");
-const shared_1 = require("../shared.js");
-Object.defineProperty(exports, "ToolDefinitionsOffsetPage", { enumerable: true, get: function () { return shared_1.ToolDefinitionsOffsetPage; } });
 const FormattedAPI = __importStar(require("./formatted.js"));
 const formatted_1 = require("./formatted.js");
+const ScheduledAPI = __importStar(require("./scheduled.js"));
+const scheduled_1 = require("./scheduled.js");
+const pagination_1 = require("../../pagination.js");
 class Tools extends resource_1.APIResource {
     constructor() {
         super(...arguments);
+        this.scheduled = new ScheduledAPI.Scheduled(this._client);
         this.formatted = new FormattedAPI.Formatted(this._client);
     }
     list(query = {}, options) {
         if ((0, core_1.isRequestOptions)(query)) {
             return this.list({}, query);
         }
-        return this._client.getAPIList('/v1/tools/list', shared_1.ToolDefinitionsOffsetPage, { query, ...options });
+        return this._client.getAPIList('/v1/tools', ToolListResponsesOffsetPage, { query, ...options });
     }
     /**
      * Authorizes a user for a specific tool by name
@@ -57,11 +59,19 @@ class Tools extends resource_1.APIResource {
     /**
      * Returns the arcade tool specification for a specific tool
      */
-    get(query, options) {
-        return this._client.get('/v1/tools/definition', { query, ...options });
+    get(name, options) {
+        return this._client.get(`/v1/tools/${name}`, options);
     }
 }
 exports.Tools = Tools;
+class ToolListResponsesOffsetPage extends pagination_1.OffsetPage {
+}
+exports.ToolListResponsesOffsetPage = ToolListResponsesOffsetPage;
+class ToolExecutionsOffsetPage extends pagination_1.OffsetPage {
+}
+exports.ToolExecutionsOffsetPage = ToolExecutionsOffsetPage;
+Tools.ToolListResponsesOffsetPage = ToolListResponsesOffsetPage;
+Tools.Scheduled = scheduled_1.Scheduled;
 Tools.Formatted = formatted_1.Formatted;
 Tools.FormattedListResponsesOffsetPage = formatted_1.FormattedListResponsesOffsetPage;
 //# sourceMappingURL=tools.js.map

package/resources/tools/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/resources/tools/tools.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtF,gDAA6C;AAC7C,wCAA8C;AAG9C,yCAAsD;AAiQ7C,0GAjQA,kCAAyB,OAiQA;AAhQlC,6DAA4C;AAC5C,8CAOqB;AAGrB,MAAa,KAAM,SAAQ,sBAAW;IAAtC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA2C/E,CAAC;IAjCC,IAAI,CACF,QAA8C,EAAE,EAChD,OAA6B;QAE7B,IAAI,IAAA,uBAAgB,EAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;SAC7B;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,kCAAyB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrG,CAAC;IAED;;OAEG;IACH,SAAS,CACP,IAAyB,EACzB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAuB,EAAE,OAA6B;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAoB,EAAE,OAA6B;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;CACF;AA5CD,sBA4CC;AA0KD,KAAK,CAAC,SAAS,GAAG,qBAAS,CAAC;AAC5B,KAAK,CAAC,gCAAgC,GAAG,4CAAgC,CAAC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/resources/tools/tools.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtF,gDAA6C;AAC7C,wCAA8C;AAI9C,6DAA4C;AAC5C,8CAOqB;AACrB,6DAA4C;AAC5C,8CAAmF;AACnF,oDAAqE;AAErE,MAAa,KAAM,SAAQ,sBAAW;IAAtC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA4C/E,CAAC;IAjCC,IAAI,CACF,QAA8C,EAAE,EAChD,OAA6B;QAE7B,IAAI,IAAA,uBAAgB,EAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;SAC7B;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,2BAA2B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;OAEG;IACH,SAAS,CACP,IAAyB,EACzB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAuB,EAAE,OAA6B;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY,EAAE,OAA6B;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;CACF;AA9CD,sBA8CC;AAED,MAAa,2BAA4B,SAAQ,uBAA4B;CAAG;AAAhF,kEAAgF;AAEhF,MAAa,wBAAyB,SAAQ,uBAAyB;CAAG;AAA1E,4DAA0E;AA8V1E,KAAK,CAAC,2BAA2B,GAAG,2BAA2B,CAAC;AAChE,KAAK,CAAC,SAAS,GAAG,qBAAS,CAAC;AAC5B,KAAK,CAAC,SAAS,GAAG,qBAAS,CAAC;AAC5B,KAAK,CAAC,gCAAgC,GAAG,4CAAgC,CAAC"}

package/resources/tools/tools.mjs

@@ -1,19 +1,22 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../resource.mjs";
 import { isRequestOptions } from "../../core.mjs";
-import { ToolDefinitionsOffsetPage } from "../shared.mjs";
 import * as FormattedAPI from "./formatted.mjs";
 import { Formatted, FormattedListResponsesOffsetPage, } from "./formatted.mjs";
+import * as ScheduledAPI from "./scheduled.mjs";
+import { Scheduled } from "./scheduled.mjs";
+import { OffsetPage } from "../../pagination.mjs";
 export class Tools extends APIResource {
     constructor() {
         super(...arguments);
+        this.scheduled = new ScheduledAPI.Scheduled(this._client);
         this.formatted = new FormattedAPI.Formatted(this._client);
     }
     list(query = {}, options) {
         if (isRequestOptions(query)) {
             return this.list({}, query);
         }
-        return this._client.getAPIList('/v1/tools/list', ToolDefinitionsOffsetPage, { query, ...options });
+        return this._client.getAPIList('/v1/tools', ToolListResponsesOffsetPage, { query, ...options });
     }
     /**
      * Authorizes a user for a specific tool by name
@@ -30,11 +33,16 @@ export class Tools extends APIResource {
     /**
      * Returns the arcade tool specification for a specific tool
      */
-    get(query, options) {
-        return this._client.get('/v1/tools/definition', { query, ...options });
+    get(name, options) {
+        return this._client.get(`/v1/tools/${name}`, options);
     }
 }
+export class ToolListResponsesOffsetPage extends OffsetPage {
+}
+export class ToolExecutionsOffsetPage extends OffsetPage {
+}
+Tools.ToolListResponsesOffsetPage = ToolListResponsesOffsetPage;
+Tools.Scheduled = Scheduled;
 Tools.Formatted = Formatted;
 Tools.FormattedListResponsesOffsetPage = FormattedListResponsesOffsetPage;
-export { ToolDefinitionsOffsetPage };
 //# sourceMappingURL=tools.mjs.map

package/resources/tools/tools.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tools.mjs","sourceRoot":"","sources":["../../src/resources/tools/tools.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,EAAE,gBAAgB,EAAE;OAGpB,EAAE,yBAAyB,EAAE;OAC7B,KAAK,YAAY;OACjB,EACL,SAAS,EAKT,gCAAgC,GACjC;AAGD,MAAM,OAAO,KAAM,SAAQ,WAAW;IAAtC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA2C/E,CAAC;IAjCC,IAAI,CACF,QAA8C,EAAE,EAChD,OAA6B;QAE7B,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;SAC7B;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,yBAAyB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrG,CAAC;IAED;;OAEG;IACH,SAAS,CACP,IAAyB,EACzB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAuB,EAAE,OAA6B;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAoB,EAAE,OAA6B;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;CACF;AA0KD,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;AAC5B,KAAK,CAAC,gCAAgC,GAAG,gCAAgC,CAAC;AA8B1E,OAAO,EAAE,yBAAyB,EAAE,CAAC"}
+{"version":3,"file":"tools.mjs","sourceRoot":"","sources":["../../src/resources/tools/tools.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,EAAE,gBAAgB,EAAE;OAIpB,KAAK,YAAY;OACjB,EACL,SAAS,EAKT,gCAAgC,GACjC;OACM,KAAK,YAAY;OACjB,EAAE,SAAS,EAA6C;OACxD,EAAE,UAAU,EAAyB;AAE5C,MAAM,OAAO,KAAM,SAAQ,WAAW;IAAtC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA4C/E,CAAC;IAjCC,IAAI,CACF,QAA8C,EAAE,EAChD,OAA6B;QAE7B,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE;YAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;SAC7B;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,2BAA2B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;OAEG;IACH,SAAS,CACP,IAAyB,EACzB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAuB,EAAE,OAA6B;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY,EAAE,OAA6B;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,UAA4B;CAAG;AAEhF,MAAM,OAAO,wBAAyB,SAAQ,UAAyB;CAAG;AA8V1E,KAAK,CAAC,2BAA2B,GAAG,2BAA2B,CAAC;AAChE,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;AAC5B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;AAC5B,KAAK,CAAC,gCAAgC,GAAG,gCAAgC,CAAC"}

package/src/core.ts

@@ -522,9 +522,19 @@ export abstract class APIClient {
 
     const timeout = setTimeout(() => controller.abort(), ms);
 
+    const fetchOptions = {
+      signal: controller.signal as any,
+      ...options,
+    };
+    if (fetchOptions.method) {
+      // Custom methods like 'patch' need to be uppercased
+      // See https://github.com/nodejs/undici/issues/2294
+      fetchOptions.method = fetchOptions.method.toUpperCase();
+    }
+
     return (
       // use undefined this binding; fetch errors if bound to something else in browser/cloudflare
-      this.fetch.call(undefined, url, { signal: controller.signal as any, ...options }).finally(() => {
+      this.fetch.call(undefined, url, fetchOptions).finally(() => {
         clearTimeout(timeout);
       })
     );

package/src/index.ts

@@ -13,17 +13,15 @@ import { Chat, ChatMessage, ChatRequest, ChatResponse, Choice, Usage } from './r
 import {
   AuthorizeToolRequest,
   ExecuteToolRequest,
-  Inputs,
-  Output,
-  Parameter,
-  Requirements,
-  Response,
-  ResponseOutput,
+  ExecuteToolResponse,
   ToolAuthorizeParams,
   ToolExecuteParams,
-  ToolGetParams,
+  ToolExecution,
+  ToolExecutionAttempt,
+  ToolGetResponse,
   ToolListParams,
-  ToolkitDefinition,
+  ToolListResponse,
+  ToolListResponsesOffsetPage,
   Tools,
   ValueSchema,
 } from './resources/tools/tools';
@@ -48,7 +46,7 @@ export interface ClientOptions {
    * Note that request timeouts are retried by default, so in a worst-case scenario you may wait
    * much longer than this timeout before the promise succeeds or fails.
    */
-  timeout?: number;
+  timeout?: number | undefined;
 
   /**
    * An HTTP agent used to manage HTTP(S) connections.
@@ -56,7 +54,7 @@ export interface ClientOptions {
    * If not provided, an agent will be constructed by default in the Node.js environment,
    * otherwise no agent is used.
    */
-  httpAgent?: Agent;
+  httpAgent?: Agent | undefined;
 
   /**
    * Specify a custom `fetch` function implementation.
@@ -72,7 +70,7 @@ export interface ClientOptions {
    *
    * @default 2
    */
-  maxRetries?: number;
+  maxRetries?: number | undefined;
 
   /**
    * Default headers to include with every request to the API.
@@ -80,7 +78,7 @@ export interface ClientOptions {
    * These can be removed in individual requests by explicitly setting the
    * header to `undefined` or `null` in request options.
    */
-  defaultHeaders?: Core.Headers;
+  defaultHeaders?: Core.Headers | undefined;
 
   /**
    * Default query parameters to include with every request to the API.
@@ -88,7 +86,7 @@ export interface ClientOptions {
    * These can be removed in individual requests by explicitly setting the
    * param to `undefined` in request options.
    */
-  defaultQuery?: Core.DefaultQuery;
+  defaultQuery?: Core.DefaultQuery | undefined;
 }
 
 /**
@@ -187,6 +185,7 @@ Arcade.Auth = Auth;
 Arcade.Health = Health;
 Arcade.Chat = Chat;
 Arcade.Tools = Tools;
+Arcade.ToolListResponsesOffsetPage = ToolListResponsesOffsetPage;
 export declare namespace Arcade {
   export type RequestOptions = Core.RequestOptions;
 
@@ -215,23 +214,21 @@ export declare namespace Arcade {
     Tools as Tools,
     type AuthorizeToolRequest as AuthorizeToolRequest,
     type ExecuteToolRequest as ExecuteToolRequest,
-    type Inputs as Inputs,
-    type Output as Output,
-    type Parameter as Parameter,
-    type Requirements as Requirements,
-    type Response as Response,
-    type ResponseOutput as ResponseOutput,
-    type ToolkitDefinition as ToolkitDefinition,
+    type ExecuteToolResponse as ExecuteToolResponse,
+    type ToolExecution as ToolExecution,
+    type ToolExecutionAttempt as ToolExecutionAttempt,
     type ValueSchema as ValueSchema,
+    type ToolListResponse as ToolListResponse,
+    type ToolGetResponse as ToolGetResponse,
+    ToolListResponsesOffsetPage as ToolListResponsesOffsetPage,
     type ToolListParams as ToolListParams,
     type ToolAuthorizeParams as ToolAuthorizeParams,
     type ToolExecuteParams as ToolExecuteParams,
-    type ToolGetParams as ToolGetParams,
   };
 
-  export type AuthorizationResponse = API.AuthorizationResponse;
+  export type AuthAuthorizationContext = API.AuthAuthorizationContext;
+  export type AuthAuthorizationResponse = API.AuthAuthorizationResponse;
   export type Error = API.Error;
-  export type ToolDefinition = API.ToolDefinition;
 }
 
 export { toFile, fileFromPath } from './uploads';

package/src/resources/auth.ts

@@ -1,17 +1,64 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../resource';
-import * as Core from '../core';
 import * as Shared from './shared';
+import * as Core from '../core';
+
+export const DEFAULT_LONGPOLL_WAIT_TIME = 45;
+
+/**
+ * Error thrown when authorization-related operations fail
+ */
+export class AuthorizationError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'AuthorizationError';
+  }
+}
 
 export class Auth extends APIResource {
+  /**
+   * Starts the authorization process for a given provider and scopes.
+   * @param userId - The user ID for which authorization is being requested
+   * @param provider - The authorization provider (e.g., 'github', 'google', 'linkedin', 'microsoft', 'slack', 'spotify', 'x', 'zoom')
+   * @param options - Optional parameters
+   * @param options.providerType - The type of authorization provider. Defaults to 'oauth2'
+   * @param options.scopes - A list of scopes required for authorization, if any. Defaults to []
+   * @returns The authorization response
+   *
+   * Example:
+   * ```ts
+   * const authResponse = await client.auth.start("user@example.com", "github");
+   * ```
+   */
+  start(
+    userId: string,
+    provider: string,
+    options: AuthStartOptions = {},
+  ): Core.APIPromise<Shared.AuthAuthorizationResponse> {
+    const { providerType = 'oauth2', scopes = [] } = options;
+
+    const authRequirement: AuthAuthorizeParams.AuthRequirement = {
+      provider_id: provider,
+      provider_type: providerType,
+      oauth2: {
+        scopes,
+      },
+    };
+
+    return this.authorize({
+      auth_requirement: authRequirement,
+      user_id: userId,
+    });
+  }
+
   /**
    * Starts the authorization process for given authorization requirements
    */
   authorize(
     body: AuthAuthorizeParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<Shared.AuthorizationResponse> {
+  ): Core.APIPromise<Shared.AuthAuthorizationResponse> {
     return this._client.post('/v1/auth/authorize', { body, ...options });
   }
 
@@ -23,9 +70,55 @@ export class Auth extends APIResource {
   status(
     query: AuthStatusParams,
     options?: Core.RequestOptions,
-  ): Core.APIPromise<Shared.AuthorizationResponse> {
+  ): Core.APIPromise<Shared.AuthAuthorizationResponse> {
     return this._client.get('/v1/auth/status', { query, ...options });
   }
+
+  /**
+   * Waits for the authorization process to complete.
+   * @param authResponseOrId - The authorization response or ID to wait for completion
+   * @returns The completed authorization response
+   * @throws {AuthorizationError} When the authorization ID is missing or invalid
+   *
+   * Example:
+   * ```ts
+   * const authResponse = await client.auth.start("user@example.com", "github");
+   * try {
+   *   const completedAuth = await client.auth.waitForCompletion(authResponse);
+   *   console.log('Authorization completed:', completedAuth);
+   * } catch (error) {
+   *   if (error instanceof AuthorizationError) {
+   *     console.error('Authorization failed:', error.message);
+   *   }
+   * }
+   * ```
+   */
+  async waitForCompletion(
+    authResponseOrId: Shared.AuthAuthorizationResponse | string,
+  ): Promise<Shared.AuthAuthorizationResponse> {
+    let authId: string;
+    let authResponse: Shared.AuthAuthorizationResponse;
+
+    if (typeof authResponseOrId === 'string') {
+      authId = authResponseOrId;
+      authResponse = { status: 'pending' } as Shared.AuthAuthorizationResponse;
+    } else {
+      if (!authResponseOrId.id) {
+        throw new AuthorizationError('Authorization ID is required');
+      }
+      authId = authResponseOrId.id;
+      authResponse = authResponseOrId;
+    }
+
+    while (authResponse.status !== 'completed') {
+      authResponse = await this.status({
+        id: authId,
+        wait: DEFAULT_LONGPOLL_WAIT_TIME,
+      });
+    }
+
+    return authResponse;
+  }
 }
 
 export interface AuthRequest {
@@ -36,8 +129,16 @@ export interface AuthRequest {
 
 export namespace AuthRequest {
   export interface AuthRequirement {
+    /**
+     * one of ID or ProviderID must be set
+     */
+    id?: string;
+
     oauth2?: AuthRequirement.Oauth2;
 
+    /**
+     * one of ID or ProviderID must be set
+     */
     provider_id?: string;
 
     provider_type?: string;
@@ -58,8 +159,16 @@ export interface AuthAuthorizeParams {
 
 export namespace AuthAuthorizeParams {
   export interface AuthRequirement {
+    /**
+     * one of ID or ProviderID must be set
+     */
+    id?: string;
+
     oauth2?: AuthRequirement.Oauth2;
 
+    /**
+     * one of ID or ProviderID must be set
+     */
     provider_id?: string;
 
     provider_type?: string;
@@ -76,17 +185,26 @@ export interface AuthStatusParams {
   /**
    * Authorization ID
    */
-  authorizationId: string;
+  id: string;
+
+  /**
+   * Timeout in seconds (max 59)
+   */
+  wait?: number;
+}
 
+export interface AuthStartOptions {
   /**
-   * Scopes
+   * The type of authorization provider
+   * @default 'oauth2'
    */
-  scopes?: string;
+  providerType?: string;
 
   /**
-   * Timeout in seconds (max 59)
+   * A list of scopes required for authorization
+   * @default []
    */
-  wait?: number;
+  scopes?: string[];
 }
 
 export declare namespace Auth {
@@ -94,5 +212,6 @@ export declare namespace Auth {
     type AuthRequest as AuthRequest,
     type AuthAuthorizeParams as AuthAuthorizeParams,
     type AuthStatusParams as AuthStatusParams,
+    type AuthStartOptions as AuthStartOptions,
   };
 }

package/src/resources/chat/chat.ts

@@ -88,7 +88,7 @@ export interface ChatRequest {
 
   presence_penalty?: number;
 
-  response_format?: 'json_object' | 'text';
+  response_format?: ChatRequest.ResponseFormat;
 
   seed?: number;
 
@@ -123,6 +123,10 @@ export interface ChatRequest {
 }
 
 export namespace ChatRequest {
+  export interface ResponseFormat {
+    type?: 'json_object' | 'text';
+  }
+
   /**
    * Options for streaming response. Only set this when you set stream: true.
    */
@@ -162,7 +166,7 @@ export interface Choice {
 
   message?: ChatMessage;
 
-  tool_authorizations?: Array<Shared.AuthorizationResponse>;
+  tool_authorizations?: Array<Shared.AuthAuthorizationResponse>;
 
   tool_messages?: Array<ChatMessage>;
 }

package/src/resources/chat/completions.ts

@@ -47,7 +47,7 @@ export interface CompletionCreateParams {
 
   presence_penalty?: number;
 
-  response_format?: 'json_object' | 'text';
+  response_format?: CompletionCreateParams.ResponseFormat;
 
   seed?: number;
 
@@ -82,6 +82,10 @@ export interface CompletionCreateParams {
 }
 
 export namespace CompletionCreateParams {
+  export interface ResponseFormat {
+    type?: 'json_object' | 'text';
+  }
+
   /**
    * Options for streaming response. Only set this when you set stream: true.
    */

package/src/resources/index.ts

@@ -12,19 +12,18 @@ export {
 } from './chat/chat';
 export { Health, type HealthSchema } from './health';
 export {
+  ToolExecutionsOffsetPage,
+  ToolListResponsesOffsetPage,
   Tools,
   type AuthorizeToolRequest,
   type ExecuteToolRequest,
-  type Inputs,
-  type Output,
-  type Parameter,
-  type Requirements,
-  type Response,
-  type ResponseOutput,
-  type ToolkitDefinition,
+  type ExecuteToolResponse,
+  type ToolExecution,
+  type ToolExecutionAttempt,
   type ValueSchema,
+  type ToolListResponse,
+  type ToolGetResponse,
   type ToolListParams,
   type ToolAuthorizeParams,
   type ToolExecuteParams,
-  type ToolGetParams,
 } from './tools/tools';

package/src/resources/shared.ts

@@ -1,14 +1,15 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import * as ToolsAPI from './tools/tools';
-import { OffsetPage } from '../pagination';
+export interface AuthAuthorizationContext {
+  token?: string;
 
-export interface AuthorizationResponse {
-  authorization_id?: string;
+  user_info?: Record<string, unknown>;
+}
 
-  authorization_url?: string;
+export interface AuthAuthorizationResponse {
+  id?: string;
 
-  context?: AuthorizationResponse.Context;
+  context?: AuthAuthorizationContext;
 
   provider_id?: string;
 
@@ -16,15 +17,9 @@ export interface AuthorizationResponse {
 
   status?: 'pending' | 'completed' | 'failed';
 
-  user_id?: string;
-}
-
-export namespace AuthorizationResponse {
-  export interface Context {
-    token?: string;
+  url?: string;
 
-    user_info?: Record<string, unknown>;
-  }
+  user_id?: string;
 }
 
 export interface Error {
@@ -32,19 +27,3 @@ export interface Error {
 
   name?: string;
 }
-
-export interface ToolDefinition {
-  inputs: ToolsAPI.Inputs;
-
-  name: string;
-
-  toolkit: ToolsAPI.ToolkitDefinition;
-
-  description?: string;
-
-  output?: ToolsAPI.Output;
-
-  requirements?: ToolsAPI.Requirements;
-}
-
-export class ToolDefinitionsOffsetPage extends OffsetPage<ToolDefinition> {}

package/src/resources/tools/formatted.ts

@@ -7,8 +7,8 @@ import { OffsetPage, type OffsetPageParams } from '../../pagination';
 
 export class Formatted extends APIResource {
   /**
-   * Returns a page of tools, optionally filtered by toolkit, formatted for a
-   * specific provider
+   * Returns a page of tools from the engine configuration, optionally filtered by
+   * toolkit, formatted for a specific provider
    */
   list(
     query?: FormattedListParams,
@@ -24,7 +24,7 @@ export class Formatted extends APIResource {
     if (isRequestOptions(query)) {
       return this.list({}, query);
     }
-    return this._client.getAPIList('/v1/tools/formatted/list', FormattedListResponsesOffsetPage, {
+    return this._client.getAPIList('/v1/formatted_tools', FormattedListResponsesOffsetPage, {
       query,
       ...options,
     });
@@ -33,8 +33,17 @@ export class Formatted extends APIResource {
   /**
    * Returns the formatted tool specification for a specific tool, given a provider
    */
-  get(query: FormattedGetParams, options?: Core.RequestOptions): Core.APIPromise<unknown> {
-    return this._client.get('/v1/tools/formatted/definition', { query, ...options });
+  get(name: string, query?: FormattedGetParams, options?: Core.RequestOptions): Core.APIPromise<unknown>;
+  get(name: string, options?: Core.RequestOptions): Core.APIPromise<unknown>;
+  get(
+    name: string,
+    query: FormattedGetParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<unknown> {
+    if (isRequestOptions(query)) {
+      return this.get(name, {}, query);
+    }
+    return this._client.get(`/v1/formatted_tools/${name}`, { query, ...options });
   }
 }
 
@@ -57,11 +66,6 @@ export interface FormattedListParams extends OffsetPageParams {
 }
 
 export interface FormattedGetParams {
-  /**
-   * Tool ID
-   */
-  toolId: string;
-
   /**
    * Provider format
    */

package/src/resources/tools/index.ts

@@ -8,20 +8,20 @@ export {
   type FormattedListParams,
   type FormattedGetParams,
 } from './formatted';
+export { Scheduled, type ScheduledGetResponse, type ScheduledListParams } from './scheduled';
 export {
+  ToolExecutionsOffsetPage,
+  ToolListResponsesOffsetPage,
   Tools,
   type AuthorizeToolRequest,
   type ExecuteToolRequest,
-  type Inputs,
-  type Output,
-  type Parameter,
-  type Requirements,
-  type Response,
-  type ResponseOutput,
-  type ToolkitDefinition,
+  type ExecuteToolResponse,
+  type ToolExecution,
+  type ToolExecutionAttempt,
   type ValueSchema,
+  type ToolListResponse,
+  type ToolGetResponse,
   type ToolListParams,
   type ToolAuthorizeParams,
   type ToolExecuteParams,
-  type ToolGetParams,
 } from './tools';