@modelrelay/sdk 1.29.0 → 1.37.0

package/dist/index.cjs

@@ -41,7 +41,6 @@ __export(index_exports, {
   CustomerResponsesClient: () => CustomerResponsesClient,
   CustomerScopedModelRelay: () => CustomerScopedModelRelay,
   CustomerTokenProvider: () => CustomerTokenProvider,
-  CustomersClient: () => CustomersClient,
   DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
   DEFAULT_CLIENT_HEADER: () => DEFAULT_CLIENT_HEADER,
   DEFAULT_CONNECT_TIMEOUT_MS: () => DEFAULT_CONNECT_TIMEOUT_MS,
@@ -77,7 +76,6 @@ __export(index_exports, {
   MessageRoles: () => MessageRoles,
   ModelRelay: () => ModelRelay,
   ModelRelayError: () => ModelRelayError,
-  ModelsClient: () => ModelsClient,
   OIDCExchangeTokenProvider: () => OIDCExchangeTokenProvider,
   OutputFormatTypes: () => OutputFormatTypes,
   OutputItemTypes: () => OutputItemTypes,
@@ -140,6 +138,7 @@ __export(index_exports, {
   createUserMessage: () => createUserMessage,
   createWebTool: () => createWebTool,
   defaultRetryHandler: () => defaultRetryHandler,
+  defaultTierModelId: () => defaultTierModelId,
   executeWithRetry: () => executeWithRetry,
   firstToolCall: () => firstToolCall,
   formatToolErrorForModel: () => formatToolErrorForModel,
@@ -516,6 +515,205 @@ function isSecretKey(key) {
   return key.startsWith(SECRET_PREFIX);
 }
 
+// package.json
+var package_default = {
+  name: "@modelrelay/sdk",
+  version: "1.37.0",
+  description: "TypeScript SDK for the ModelRelay API",
+  type: "module",
+  main: "dist/index.cjs",
+  module: "dist/index.js",
+  types: "dist/index.d.ts",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js",
+      require: "./dist/index.cjs"
+    },
+    "./billing": {
+      types: "./dist/billing/index.d.ts",
+      import: "./dist/billing/index.js",
+      require: "./dist/billing/index.cjs"
+    },
+    "./node": {
+      types: "./dist/node.d.ts",
+      import: "./dist/node.js",
+      require: "./dist/node.cjs"
+    }
+  },
+  publishConfig: {
+    access: "public"
+  },
+  files: [
+    "dist"
+  ],
+  scripts: {
+    build: "tsup src/index.ts src/node.ts src/billing/index.ts --format esm,cjs --dts --external playwright",
+    dev: "tsup src/index.ts src/node.ts src/billing/index.ts --format esm,cjs --dts --watch",
+    lint: "tsc --noEmit --project tsconfig.lint.json",
+    test: "vitest run",
+    "generate:types": "openapi-typescript ../../api/openapi/api.json -o src/generated/api.ts"
+  },
+  keywords: [
+    "modelrelay",
+    "llm",
+    "sdk",
+    "typescript"
+  ],
+  author: "Shane Vitarana",
+  license: "Apache-2.0",
+  dependencies: {
+    "fast-json-patch": "^3.1.1",
+    zod: "^3.25.76"
+  },
+  peerDependencies: {
+    playwright: ">=1.40.0"
+  },
+  peerDependenciesMeta: {
+    playwright: {
+      optional: true
+    }
+  },
+  devDependencies: {
+    "@types/node": "^25.0.3",
+    "openapi-typescript": "^7.10.1",
+    playwright: "^1.57.0",
+    tsup: "^8.5.1",
+    typescript: "^5.9.3",
+    vitest: "^2.1.9"
+  }
+};
+
+// src/types.ts
+var SDK_VERSION = package_default.version || "0.0.0";
+var DEFAULT_BASE_URL = "https://api.modelrelay.ai/api/v1";
+var DEFAULT_CLIENT_HEADER = `modelrelay-ts/${SDK_VERSION}`;
+var DEFAULT_CONNECT_TIMEOUT_MS = 5e3;
+var DEFAULT_REQUEST_TIMEOUT_MS = 6e4;
+var StopReasons = {
+  Completed: "completed",
+  Stop: "stop",
+  StopSequence: "stop_sequence",
+  EndTurn: "end_turn",
+  MaxTokens: "max_tokens",
+  MaxLength: "max_len",
+  MaxContext: "max_context",
+  ToolCalls: "tool_calls",
+  TimeLimit: "time_limit",
+  ContentFilter: "content_filter",
+  Incomplete: "incomplete",
+  Unknown: "unknown"
+};
+function asProviderId(value) {
+  return value;
+}
+function asModelId(value) {
+  return value;
+}
+function asTierCode(value) {
+  return value;
+}
+var SubscriptionStatuses = {
+  Active: "active",
+  Trialing: "trialing",
+  PastDue: "past_due",
+  Canceled: "canceled",
+  Unpaid: "unpaid",
+  Incomplete: "incomplete",
+  IncompleteExpired: "incomplete_expired",
+  Paused: "paused"
+};
+var BillingProviders = {
+  Stripe: "stripe",
+  Crypto: "crypto",
+  AppStore: "app_store",
+  External: "external"
+};
+function createUsage(inputTokens, outputTokens, totalTokens) {
+  return {
+    inputTokens,
+    outputTokens,
+    totalTokens: totalTokens ?? inputTokens + outputTokens
+  };
+}
+var MessageRoles = {
+  User: "user",
+  Assistant: "assistant",
+  System: "system",
+  Tool: "tool"
+};
+var ContentPartTypes = {
+  Text: "text"
+};
+var InputItemTypes = {
+  Message: "message"
+};
+var OutputItemTypes = {
+  Message: "message"
+};
+var ToolTypes = {
+  Function: "function",
+  Web: "web",
+  XSearch: "x_search",
+  CodeExecution: "code_execution"
+};
+var WebToolIntents = {
+  Auto: "auto",
+  SearchWeb: "search_web",
+  FetchURL: "fetch_url"
+};
+var ToolChoiceTypes = {
+  Auto: "auto",
+  Required: "required",
+  None: "none"
+};
+var OutputFormatTypes = {
+  Text: "text",
+  JsonSchema: "json_schema"
+};
+function mergeMetrics(base, override) {
+  if (!base && !override) return void 0;
+  return {
+    ...base || {},
+    ...override || {}
+  };
+}
+function mergeTrace(base, override) {
+  if (!base && !override) return void 0;
+  return {
+    ...base || {},
+    ...override || {}
+  };
+}
+function normalizeStopReason(value) {
+  if (value === void 0 || value === null) return void 0;
+  const str = String(value).trim();
+  const lower = str.toLowerCase();
+  for (const reason of Object.values(StopReasons)) {
+    if (lower === reason) return reason;
+  }
+  switch (lower) {
+    case "length":
+      return StopReasons.MaxLength;
+    default:
+      return { other: str };
+  }
+}
+function stopReasonToString(value) {
+  if (!value) return void 0;
+  if (typeof value === "string") return value;
+  return value.other?.trim() || void 0;
+}
+function normalizeModelId(value) {
+  if (value === void 0 || value === null) return void 0;
+  const str = String(value).trim();
+  if (!str) return void 0;
+  return str;
+}
+function modelToString(value) {
+  return String(value).trim();
+}
+
 // src/auth.ts
 function createApiKeyAuth(apiKey) {
   return { apiKey };
@@ -700,7 +898,7 @@ var AuthClient = class {
       projectId: apiResp.project_id,
       customerId: apiResp.customer_id,
       customerExternalId: apiResp.customer_external_id,
-      tierCode: apiResp.tier_code
+      tierCode: apiResp.tier_code ? asTierCode(apiResp.tier_code) : void 0
     };
   }
   /**
@@ -732,7 +930,7 @@ var AuthClient = class {
       projectId: apiResp.project_id,
       customerId: apiResp.customer_id,
       customerExternalId: apiResp.customer_external_id,
-      tierCode: apiResp.tier_code
+      tierCode: apiResp.tier_code ? asTierCode(apiResp.tier_code) : void 0
     };
   }
   /**
@@ -844,7 +1042,7 @@ var AuthClient = class {
           projectId: apiResp.project_id,
           customerId: apiResp.customer_id,
           customerExternalId: apiResp.customer_external_id,
-          tierCode: apiResp.tier_code
+          tierCode: apiResp.tier_code ? asTierCode(apiResp.tier_code) : void 0
         }
       };
     } catch (err) {
@@ -896,200 +1094,6 @@ function isTokenReusable(token) {
   return token.expiresAt.getTime() - Date.now() > 6e4;
 }
 
-// package.json
-var package_default = {
-  name: "@modelrelay/sdk",
-  version: "1.29.0",
-  description: "TypeScript SDK for the ModelRelay API",
-  type: "module",
-  main: "dist/index.cjs",
-  module: "dist/index.js",
-  types: "dist/index.d.ts",
-  exports: {
-    ".": {
-      types: "./dist/index.d.ts",
-      import: "./dist/index.js",
-      require: "./dist/index.cjs"
-    },
-    "./node": {
-      types: "./dist/node.d.ts",
-      import: "./dist/node.js",
-      require: "./dist/node.cjs"
-    }
-  },
-  publishConfig: {
-    access: "public"
-  },
-  files: [
-    "dist"
-  ],
-  scripts: {
-    build: "tsup src/index.ts src/node.ts --format esm,cjs --dts --external playwright",
-    dev: "tsup src/index.ts src/node.ts --format esm,cjs --dts --watch",
-    lint: "tsc --noEmit --project tsconfig.lint.json",
-    test: "vitest run",
-    "generate:types": "openapi-typescript ../../api/openapi/api.json -o src/generated/api.ts"
-  },
-  keywords: [
-    "modelrelay",
-    "llm",
-    "sdk",
-    "typescript"
-  ],
-  author: "Shane Vitarana",
-  license: "Apache-2.0",
-  dependencies: {
-    "fast-json-patch": "^3.1.1",
-    zod: "^3.23.0"
-  },
-  peerDependencies: {
-    playwright: ">=1.40.0"
-  },
-  peerDependenciesMeta: {
-    playwright: {
-      optional: true
-    }
-  },
-  devDependencies: {
-    "@types/node": "^25.0.3",
-    "openapi-typescript": "^7.4.4",
-    playwright: "^1.49.0",
-    tsup: "^8.2.4",
-    typescript: "^5.6.3",
-    vitest: "^2.1.4"
-  }
-};
-
-// src/types.ts
-var SDK_VERSION = package_default.version || "0.0.0";
-var DEFAULT_BASE_URL = "https://api.modelrelay.ai/api/v1";
-var DEFAULT_CLIENT_HEADER = `modelrelay-ts/${SDK_VERSION}`;
-var DEFAULT_CONNECT_TIMEOUT_MS = 5e3;
-var DEFAULT_REQUEST_TIMEOUT_MS = 6e4;
-var StopReasons = {
-  Completed: "completed",
-  Stop: "stop",
-  StopSequence: "stop_sequence",
-  EndTurn: "end_turn",
-  MaxTokens: "max_tokens",
-  MaxLength: "max_len",
-  MaxContext: "max_context",
-  ToolCalls: "tool_calls",
-  TimeLimit: "time_limit",
-  ContentFilter: "content_filter",
-  Incomplete: "incomplete",
-  Unknown: "unknown"
-};
-function asProviderId(value) {
-  return value;
-}
-function asModelId(value) {
-  return value;
-}
-function asTierCode(value) {
-  return value;
-}
-var SubscriptionStatuses = {
-  Active: "active",
-  Trialing: "trialing",
-  PastDue: "past_due",
-  Canceled: "canceled",
-  Unpaid: "unpaid",
-  Incomplete: "incomplete",
-  IncompleteExpired: "incomplete_expired",
-  Paused: "paused"
-};
-var BillingProviders = {
-  Stripe: "stripe",
-  Crypto: "crypto",
-  AppStore: "app_store",
-  External: "external"
-};
-function createUsage(inputTokens, outputTokens, totalTokens) {
-  return {
-    inputTokens,
-    outputTokens,
-    totalTokens: totalTokens ?? inputTokens + outputTokens
-  };
-}
-var MessageRoles = {
-  User: "user",
-  Assistant: "assistant",
-  System: "system",
-  Tool: "tool"
-};
-var ContentPartTypes = {
-  Text: "text"
-};
-var InputItemTypes = {
-  Message: "message"
-};
-var OutputItemTypes = {
-  Message: "message"
-};
-var ToolTypes = {
-  Function: "function",
-  Web: "web",
-  XSearch: "x_search",
-  CodeExecution: "code_execution"
-};
-var WebToolIntents = {
-  Auto: "auto",
-  SearchWeb: "search_web",
-  FetchURL: "fetch_url"
-};
-var ToolChoiceTypes = {
-  Auto: "auto",
-  Required: "required",
-  None: "none"
-};
-var OutputFormatTypes = {
-  Text: "text",
-  JsonSchema: "json_schema"
-};
-function mergeMetrics(base, override) {
-  if (!base && !override) return void 0;
-  return {
-    ...base || {},
-    ...override || {}
-  };
-}
-function mergeTrace(base, override) {
-  if (!base && !override) return void 0;
-  return {
-    ...base || {},
-    ...override || {}
-  };
-}
-function normalizeStopReason(value) {
-  if (value === void 0 || value === null) return void 0;
-  const str = String(value).trim();
-  const lower = str.toLowerCase();
-  for (const reason of Object.values(StopReasons)) {
-    if (lower === reason) return reason;
-  }
-  switch (lower) {
-    case "length":
-      return StopReasons.MaxLength;
-    default:
-      return { other: str };
-  }
-}
-function stopReasonToString(value) {
-  if (!value) return void 0;
-  if (typeof value === "string") return value;
-  return value.other?.trim() || void 0;
-}
-function normalizeModelId(value) {
-  if (value === void 0 || value === null) return void 0;
-  const str = String(value).trim();
-  if (!str) return void 0;
-  return str;
-}
-function modelToString(value) {
-  return String(value).trim();
-}
-
 // src/tools.ts
 function createUserMessage(content) {
   return {
@@ -3880,510 +3884,146 @@ var RunsClient = class {
       trace,
       context: { method: "GET", path }
     });
-    return {
-      ...out,
-      run_id: parseRunId(out.run_id),
-      pending: out.pending.map((p) => ({
-        ...p,
-        node_id: parseNodeId(p.node_id),
-        tool_calls: p.tool_calls
-      }))
-    };
-  }
-};
-
-// src/workflows_request.ts
-var WORKFLOWS_COMPILE_PATH = "/workflows/compile";
-
-// src/workflows_client.ts
-var WorkflowsClient = class {
-  constructor(http, auth, cfg = {}) {
-    this.http = http;
-    this.auth = auth;
-    this.metrics = cfg.metrics;
-    this.trace = cfg.trace;
-  }
-  async compileV0(spec, options = {}) {
-    const metrics = mergeMetrics(this.metrics, options.metrics);
-    const trace = mergeTrace(this.trace, options.trace);
-    const authHeaders = await this.auth.authForResponses();
-    const headers = { ...options.headers || {} };
-    const customerId = options.customerId?.trim();
-    if (customerId) {
-      headers[CUSTOMER_ID_HEADER] = customerId;
-    }
-    try {
-      const out = await this.http.json(
-        WORKFLOWS_COMPILE_PATH,
-        {
-          method: "POST",
-          headers,
-          body: spec,
-          signal: options.signal,
-          apiKey: authHeaders.apiKey,
-          accessToken: authHeaders.accessToken,
-          timeoutMs: options.timeoutMs,
-          connectTimeoutMs: options.connectTimeoutMs,
-          retry: options.retry,
-          metrics,
-          trace,
-          context: { method: "POST", path: WORKFLOWS_COMPILE_PATH }
-        }
-      );
-      return {
-        ok: true,
-        plan_json: out.plan_json,
-        plan_hash: parsePlanHash(out.plan_hash)
-      };
-    } catch (err) {
-      if (err instanceof WorkflowValidationError) {
-        return { ok: false, error_type: "validation_error", issues: err.issues };
-      }
-      if (err instanceof APIError) {
-        return {
-          ok: false,
-          error_type: "internal_error",
-          status: err.status ?? 0,
-          message: err.message,
-          code: err.code,
-          requestId: err.requestId
-        };
-      }
-      if (err instanceof ModelRelayError && err.category === "api") {
-        return {
-          ok: false,
-          error_type: "internal_error",
-          status: err.status ?? 0,
-          message: err.message,
-          code: err.code,
-          requestId: err.requestId
-        };
-      }
-      throw err;
-    }
-  }
-  async compileV1(spec, options = {}) {
-    const metrics = mergeMetrics(this.metrics, options.metrics);
-    const trace = mergeTrace(this.trace, options.trace);
-    const authHeaders = await this.auth.authForResponses();
-    const headers = { ...options.headers || {} };
-    const customerId = options.customerId?.trim();
-    if (customerId) {
-      headers[CUSTOMER_ID_HEADER] = customerId;
-    }
-    try {
-      const out = await this.http.json(
-        WORKFLOWS_COMPILE_PATH,
-        {
-          method: "POST",
-          headers,
-          body: spec,
-          signal: options.signal,
-          apiKey: authHeaders.apiKey,
-          accessToken: authHeaders.accessToken,
-          timeoutMs: options.timeoutMs,
-          connectTimeoutMs: options.connectTimeoutMs,
-          retry: options.retry,
-          metrics,
-          trace,
-          context: { method: "POST", path: WORKFLOWS_COMPILE_PATH }
-        }
-      );
-      return {
-        ok: true,
-        plan_json: out.plan_json,
-        plan_hash: parsePlanHash(out.plan_hash)
-      };
-    } catch (err) {
-      if (err instanceof WorkflowValidationError) {
-        return { ok: false, error_type: "validation_error", issues: err.issues };
-      }
-      if (err instanceof APIError) {
-        return {
-          ok: false,
-          error_type: "internal_error",
-          status: err.status ?? 0,
-          message: err.message,
-          code: err.code,
-          requestId: err.requestId
-        };
-      }
-      if (err instanceof ModelRelayError && err.category === "api") {
-        return {
-          ok: false,
-          error_type: "internal_error",
-          status: err.status ?? 0,
-          message: err.message,
-          code: err.code,
-          requestId: err.requestId
-        };
-      }
-      throw err;
-    }
-  }
-};
-
-// src/customers.ts
-var EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-function isValidEmail(email) {
-  return EMAIL_REGEX.test(email);
-}
-var CustomersClient = class {
-  constructor(http, cfg) {
-    this.http = http;
-    this.apiKey = cfg.apiKey ? parseApiKey(cfg.apiKey) : void 0;
-    this.hasSecretKey = this.apiKey ? isSecretKey(this.apiKey) : false;
-    this.accessToken = cfg.accessToken;
-    this.tokenProvider = cfg.tokenProvider;
-  }
-  ensureSecretKey() {
-    if (!this.apiKey || !this.hasSecretKey) {
-      throw new ConfigError(
-        "Secret key (mr_sk_*) required for customer operations"
-      );
-    }
-  }
-  ensureApiKey() {
-    if (!this.apiKey) {
-      throw new ConfigError(
-        "API key (mr_pk_* or mr_sk_*) required for claim operation"
-      );
-    }
-  }
-  async customerAccessToken() {
-    if (this.accessToken?.trim()) {
-      return this.accessToken.trim();
-    }
-    if (this.tokenProvider) {
-      const token = (await this.tokenProvider.getToken())?.trim();
-      if (!token) {
-        throw new ConfigError("tokenProvider returned an empty token");
-      }
-      return token;
-    }
-    throw new ConfigError("Access token or tokenProvider required for customers.me()");
-  }
-  /**
-   * Get the authenticated customer from a customer-scoped bearer token.
-   *
-   * This endpoint requires a customer bearer token. API keys are not accepted.
-   */
-  async me() {
-    const token = await this.customerAccessToken();
-    const response = await this.http.json("/customers/me", {
-      method: "GET",
-      accessToken: token
-    });
-    if (!response.customer) {
-      throw new ConfigError("missing customer in response");
-    }
-    return response.customer;
-  }
-  /**
-   * Get the authenticated customer's subscription details.
-   *
-   * This endpoint requires a customer bearer token. API keys are not accepted.
-   */
-  async meSubscription() {
-    const token = await this.customerAccessToken();
-    const response = await this.http.json("/customers/me/subscription", {
-      method: "GET",
-      accessToken: token
-    });
-    if (!response.subscription) {
-      throw new ConfigError("missing subscription in response");
-    }
-    return response.subscription;
-  }
-  /**
-   * Get the authenticated customer's usage metrics for the current billing window.
-   *
-   * This endpoint requires a customer bearer token. API keys are not accepted.
-   */
-  async meUsage() {
-    const token = await this.customerAccessToken();
-    const response = await this.http.json("/customers/me/usage", {
-      method: "GET",
-      accessToken: token
-    });
-    if (!response.usage) {
-      throw new ConfigError("missing usage in response");
-    }
-    return response.usage;
-  }
-  /**
-   * List all customers in the project.
-   */
-  async list() {
-    this.ensureSecretKey();
-    const response = await this.http.json("/customers", {
-      method: "GET",
-      apiKey: this.apiKey
-    });
-    return response.customers;
-  }
-  /**
-   * Create a new customer in the project.
-   */
-  async create(request) {
-    this.ensureSecretKey();
-    if (!request.external_id?.trim()) {
-      throw new ConfigError("external_id is required");
-    }
-    if (!request.email?.trim()) {
-      throw new ConfigError("email is required");
-    }
-    if (!isValidEmail(request.email)) {
-      throw new ConfigError("invalid email format");
-    }
-    const response = await this.http.json("/customers", {
-      method: "POST",
-      body: request,
-      apiKey: this.apiKey
-    });
-    return response.customer;
-  }
-  /**
-   * Get a customer by ID.
-   */
-  async get(customerId) {
-    this.ensureSecretKey();
-    if (!customerId?.trim()) {
-      throw new ConfigError("customerId is required");
-    }
-    const response = await this.http.json(
-      `/customers/${customerId}`,
-      {
-        method: "GET",
-        apiKey: this.apiKey
-      }
-    );
-    return response.customer;
-  }
-  /**
-   * Upsert a customer by external_id.
-   * If a customer with the given external_id exists, it is updated.
-   * Otherwise, a new customer is created.
-   */
-  async upsert(request) {
-    this.ensureSecretKey();
-    if (!request.external_id?.trim()) {
-      throw new ConfigError("external_id is required");
-    }
-    if (!request.email?.trim()) {
-      throw new ConfigError("email is required");
-    }
-    if (!isValidEmail(request.email)) {
-      throw new ConfigError("invalid email format");
-    }
-    const response = await this.http.json("/customers", {
-      method: "PUT",
-      body: request,
-      apiKey: this.apiKey
-    });
-    return response.customer;
-  }
-  /**
-   * Link a customer identity (provider + subject) to a customer found by email.
-   * Used when a customer subscribes via Stripe Checkout (email only) and later authenticates to the app.
-   *
-   * This is a user self-service operation that works with publishable keys,
-   * allowing CLI tools and frontends to link subscriptions to user identities.
-   *
-   * Works with both publishable keys (mr_pk_*) and secret keys (mr_sk_*).
-   *
-   * @throws {APIError} with status 404 if customer not found by email
-   * @throws {APIError} with status 409 if the identity is already linked to a different customer
-   */
-  async claim(request) {
-    this.ensureApiKey();
-    if (!request.email?.trim()) {
-      throw new ConfigError("email is required");
-    }
-    if (!isValidEmail(request.email)) {
-      throw new ConfigError("invalid email format");
-    }
-    if (!request.provider?.trim()) {
-      throw new ConfigError("provider is required");
-    }
-    if (!request.subject?.trim()) {
-      throw new ConfigError("subject is required");
-    }
-    await this.http.request("/customers/claim", {
-      method: "POST",
-      body: request,
-      apiKey: this.apiKey
-    });
-  }
-  /**
-   * Delete a customer by ID.
-   */
-  async delete(customerId) {
-    this.ensureSecretKey();
-    if (!customerId?.trim()) {
-      throw new ConfigError("customerId is required");
-    }
-    await this.http.request(`/customers/${customerId}`, {
-      method: "DELETE",
-      apiKey: this.apiKey
-    });
-  }
-  /**
-   * Create a Stripe checkout session for a customer subscription.
-   */
-  async subscribe(customerId, request) {
-    this.ensureSecretKey();
-    if (!customerId?.trim()) {
-      throw new ConfigError("customerId is required");
-    }
-    if (!request.tier_id?.trim()) {
-      throw new ConfigError("tier_id is required");
-    }
-    if (!request.success_url?.trim() || !request.cancel_url?.trim()) {
-      throw new ConfigError("success_url and cancel_url are required");
-    }
-    return await this.http.json(
-      `/customers/${customerId}/subscribe`,
-      {
-        method: "POST",
-        body: request,
-        apiKey: this.apiKey
-      }
-    );
-  }
-  /**
-   * Get the subscription details for a customer.
-   */
-  async getSubscription(customerId) {
-    this.ensureSecretKey();
-    if (!customerId?.trim()) {
-      throw new ConfigError("customerId is required");
-    }
-    const response = await this.http.json(
-      `/customers/${customerId}/subscription`,
-      {
-        method: "GET",
-        apiKey: this.apiKey
-      }
-    );
-    return response.subscription;
-  }
-  /**
-   * Cancel a customer's subscription at period end.
-   */
-  async unsubscribe(customerId) {
-    this.ensureSecretKey();
-    if (!customerId?.trim()) {
-      throw new ConfigError("customerId is required");
-    }
-    await this.http.request(`/customers/${customerId}/subscription`, {
-      method: "DELETE",
-      apiKey: this.apiKey
-    });
-  }
-};
-
-// src/tiers.ts
-var TiersClient = class {
-  constructor(http, cfg) {
-    this.http = http;
-    this.apiKey = cfg.apiKey ? parseApiKey(cfg.apiKey) : void 0;
-    this.hasSecretKey = this.apiKey ? isSecretKey(this.apiKey) : false;
-  }
-  ensureApiKey() {
-    if (!this.apiKey) {
-      throw new ConfigError(
-        "API key (mr_pk_* or mr_sk_*) required for tier operations"
-      );
-    }
-  }
-  ensureSecretKey() {
-    if (!this.apiKey || !this.hasSecretKey) {
-      throw new ConfigError(
-        "Secret key (mr_sk_*) required for checkout operations"
-      );
-    }
-  }
-  /**
-   * List all tiers in the project.
-   */
-  async list() {
-    this.ensureApiKey();
-    const response = await this.http.json("/tiers", {
-      method: "GET",
-      apiKey: this.apiKey
-    });
-    return response.tiers;
-  }
-  /**
-   * Get a tier by ID.
-   */
-  async get(tierId) {
-    this.ensureApiKey();
-    if (!tierId?.trim()) {
-      throw new ConfigError("tierId is required");
-    }
-    const response = await this.http.json(`/tiers/${tierId}`, {
-      method: "GET",
-      apiKey: this.apiKey
-    });
-    return response.tier;
-  }
-  /**
-   * Create a Stripe checkout session for a tier (Stripe-first flow).
-   *
-   * This enables users to subscribe before authenticating. Stripe collects
-   * the customer's email during checkout. After checkout completes, a
-   * customer record is created with the email from Stripe. The customer
-   * can later be linked to an identity via POST /customers/claim.
-   *
-   * Requires a secret key (mr_sk_*).
-   *
-   * @param tierId - The tier ID to create a checkout session for
-   * @param request - Checkout session request with redirect URLs
-   * @returns Checkout session with Stripe URL
-   */
-  async checkout(tierId, request) {
-    this.ensureSecretKey();
-    if (!tierId?.trim()) {
-      throw new ConfigError("tierId is required");
-    }
-    if (!request.success_url?.trim()) {
-      throw new ConfigError("success_url is required");
-    }
-    if (!request.cancel_url?.trim()) {
-      throw new ConfigError("cancel_url is required");
-    }
-    return await this.http.json(
-      `/tiers/${tierId}/checkout`,
-      {
-        method: "POST",
-        apiKey: this.apiKey,
-        body: request
-      }
-    );
+    return {
+      ...out,
+      run_id: parseRunId(out.run_id),
+      pending: out.pending.map((p) => ({
+        ...p,
+        node_id: parseNodeId(p.node_id),
+        tool_calls: p.tool_calls
+      }))
+    };
   }
 };
 
-// src/models.ts
-var ModelsClient = class {
-  constructor(http) {
+// src/workflows_request.ts
+var WORKFLOWS_COMPILE_PATH = "/workflows/compile";
+
+// src/workflows_client.ts
+var WorkflowsClient = class {
+  constructor(http, auth, cfg = {}) {
     this.http = http;
+    this.auth = auth;
+    this.metrics = cfg.metrics;
+    this.trace = cfg.trace;
   }
-  /**
-   * List active models with rich metadata.
-   */
-  async list(params = {}) {
-    const qs = new URLSearchParams();
-    if (params.provider?.trim()) {
-      qs.set("provider", params.provider.trim());
+  async compileV0(spec, options = {}) {
+    const metrics = mergeMetrics(this.metrics, options.metrics);
+    const trace = mergeTrace(this.trace, options.trace);
+    const authHeaders = await this.auth.authForResponses();
+    const headers = { ...options.headers || {} };
+    const customerId = options.customerId?.trim();
+    if (customerId) {
+      headers[CUSTOMER_ID_HEADER] = customerId;
+    }
+    try {
+      const out = await this.http.json(
+        WORKFLOWS_COMPILE_PATH,
+        {
+          method: "POST",
+          headers,
+          body: spec,
+          signal: options.signal,
+          apiKey: authHeaders.apiKey,
+          accessToken: authHeaders.accessToken,
+          timeoutMs: options.timeoutMs,
+          connectTimeoutMs: options.connectTimeoutMs,
+          retry: options.retry,
+          metrics,
+          trace,
+          context: { method: "POST", path: WORKFLOWS_COMPILE_PATH }
+        }
+      );
+      return {
+        ok: true,
+        plan_json: out.plan_json,
+        plan_hash: parsePlanHash(out.plan_hash)
+      };
+    } catch (err) {
+      if (err instanceof WorkflowValidationError) {
+        return { ok: false, error_type: "validation_error", issues: err.issues };
+      }
+      if (err instanceof APIError) {
+        return {
+          ok: false,
+          error_type: "internal_error",
+          status: err.status ?? 0,
+          message: err.message,
+          code: err.code,
+          requestId: err.requestId
+        };
+      }
+      if (err instanceof ModelRelayError && err.category === "api") {
+        return {
+          ok: false,
+          error_type: "internal_error",
+          status: err.status ?? 0,
+          message: err.message,
+          code: err.code,
+          requestId: err.requestId
+        };
+      }
+      throw err;
     }
-    if (params.capability) {
-      qs.set("capability", params.capability);
+  }
+  async compileV1(spec, options = {}) {
+    const metrics = mergeMetrics(this.metrics, options.metrics);
+    const trace = mergeTrace(this.trace, options.trace);
+    const authHeaders = await this.auth.authForResponses();
+    const headers = { ...options.headers || {} };
+    const customerId = options.customerId?.trim();
+    if (customerId) {
+      headers[CUSTOMER_ID_HEADER] = customerId;
+    }
+    try {
+      const out = await this.http.json(
+        WORKFLOWS_COMPILE_PATH,
+        {
+          method: "POST",
+          headers,
+          body: spec,
+          signal: options.signal,
+          apiKey: authHeaders.apiKey,
+          accessToken: authHeaders.accessToken,
+          timeoutMs: options.timeoutMs,
+          connectTimeoutMs: options.connectTimeoutMs,
+          retry: options.retry,
+          metrics,
+          trace,
+          context: { method: "POST", path: WORKFLOWS_COMPILE_PATH }
+        }
+      );
+      return {
+        ok: true,
+        plan_json: out.plan_json,
+        plan_hash: parsePlanHash(out.plan_hash)
+      };
+    } catch (err) {
+      if (err instanceof WorkflowValidationError) {
+        return { ok: false, error_type: "validation_error", issues: err.issues };
+      }
+      if (err instanceof APIError) {
+        return {
+          ok: false,
+          error_type: "internal_error",
+          status: err.status ?? 0,
+          message: err.message,
+          code: err.code,
+          requestId: err.requestId
+        };
+      }
+      if (err instanceof ModelRelayError && err.category === "api") {
+        return {
+          ok: false,
+          error_type: "internal_error",
+          status: err.status ?? 0,
+          message: err.message,
+          code: err.code,
+          requestId: err.requestId
+        };
+      }
+      throw err;
     }
-    const path = qs.toString() ? `/models?${qs.toString()}` : "/models";
-    const resp = await this.http.json(path, { method: "GET" });
-    return resp.models;
   }
 };
 
@@ -4683,8 +4323,8 @@ function getModelContextCacheEntry(client) {
 async function populateModelContextCache(client, entry) {
   if (!entry.listPromise) {
     entry.listPromise = (async () => {
-      const models = await client.models.list();
-      for (const model of models) {
+      const response = await client.http.json("/models");
+      for (const model of response.models) {
         entry.byId.set(String(model.model_id), {
           contextWindow: model.context_window,
           maxOutputTokens: model.max_output_tokens
@@ -5828,6 +5468,94 @@ var SessionsClient = class {
   }
 };
 
+// src/tiers.ts
+function defaultTierModelId(tier) {
+  const def = tier.models.find((m) => m.is_default);
+  if (def) return def.model_id;
+  if (tier.models.length === 1) return tier.models[0].model_id;
+  return void 0;
+}
+var TiersClient = class {
+  constructor(http, cfg) {
+    this.http = http;
+    this.apiKey = cfg.apiKey ? parseApiKey(cfg.apiKey) : void 0;
+    this.hasSecretKey = this.apiKey ? isSecretKey(this.apiKey) : false;
+  }
+  ensureApiKey() {
+    if (!this.apiKey) {
+      throw new ConfigError(
+        "API key (mr_pk_* or mr_sk_*) required for tier operations"
+      );
+    }
+  }
+  ensureSecretKey() {
+    if (!this.apiKey || !this.hasSecretKey) {
+      throw new ConfigError(
+        "Secret key (mr_sk_*) required for checkout operations"
+      );
+    }
+  }
+  /**
+   * List all tiers in the project.
+   */
+  async list() {
+    this.ensureApiKey();
+    const response = await this.http.json("/tiers", {
+      method: "GET",
+      apiKey: this.apiKey
+    });
+    return response.tiers;
+  }
+  /**
+   * Get a tier by ID.
+   */
+  async get(tierId) {
+    this.ensureApiKey();
+    if (!tierId?.trim()) {
+      throw new ConfigError("tierId is required");
+    }
+    const response = await this.http.json(`/tiers/${tierId}`, {
+      method: "GET",
+      apiKey: this.apiKey
+    });
+    return response.tier;
+  }
+  /**
+   * Create a Stripe checkout session for a tier (Stripe-first flow).
+   *
+   * This enables users to subscribe before authenticating. Stripe collects
+   * the customer's email during checkout. After checkout completes, a
+   * customer record is created with the email from Stripe. The customer
+   * can later be linked to an identity via POST /customers/claim.
+   *
+   * Requires a secret key (mr_sk_*).
+   *
+   * @param tierId - The tier ID to create a checkout session for
+   * @param request - Checkout session request with redirect URLs
+   * @returns Checkout session with Stripe URL
+   */
+  async checkout(tierId, request) {
+    this.ensureSecretKey();
+    if (!tierId?.trim()) {
+      throw new ConfigError("tierId is required");
+    }
+    if (!request.success_url?.trim()) {
+      throw new ConfigError("success_url is required");
+    }
+    if (!request.cancel_url?.trim()) {
+      throw new ConfigError("cancel_url is required");
+    }
+    return await this.http.json(
+      `/tiers/${tierId}/checkout`,
+      {
+        method: "POST",
+        apiKey: this.apiKey,
+        body: request
+      }
+    );
+  }
+};
+
 // src/http.ts
 var HTTPClient = class {
   constructor(cfg) {
@@ -9403,10 +9131,8 @@ var ModelRelay = class _ModelRelay {
       trace: cfg.trace
     });
     this.images = new ImagesClient(this.http, auth);
-    this.customers = new CustomersClient(this.http, { apiKey, accessToken, tokenProvider });
-    this.tiers = new TiersClient(this.http, { apiKey });
-    this.models = new ModelsClient(this.http);
     this.sessions = new SessionsClient(this, this.http, auth);
+    this.tiers = new TiersClient(this.http, { apiKey });
   }
   forCustomer(customerId) {
     return new CustomerScopedModelRelay(this.responses, customerId, this.baseUrl);
@@ -9429,7 +9155,6 @@ function resolveBaseUrl(override) {
   CustomerResponsesClient,
   CustomerScopedModelRelay,
   CustomerTokenProvider,
-  CustomersClient,
   DEFAULT_BASE_URL,
   DEFAULT_CLIENT_HEADER,
   DEFAULT_CONNECT_TIMEOUT_MS,
@@ -9465,7 +9190,6 @@ function resolveBaseUrl(override) {
   MessageRoles,
   ModelRelay,
   ModelRelayError,
-  ModelsClient,
   OIDCExchangeTokenProvider,
   OutputFormatTypes,
   OutputItemTypes,
@@ -9528,6 +9252,7 @@ function resolveBaseUrl(override) {
   createUserMessage,
   createWebTool,
   defaultRetryHandler,
+  defaultTierModelId,
   executeWithRetry,
   firstToolCall,
   formatToolErrorForModel,