@seanhogg/builderforce-sdk 0.5.2 → 0.7.0

package/README.md

@@ -309,6 +309,8 @@ try {
 | 429 | `plan_token_limit_exceeded` | Tenant hit daily plan budget. **`error.terminal === true`** — don't retry on a different model. |
 | 429 | `claw_token_limit_exceeded` | Per-claw daily cap exceeded (`clk_*` keys only). **`error.terminal === true`** — same caveat. |
 | 403 | `origin_not_authorized` | Browser request from an origin not in the key's allowlist (or key has no allowlist — server-only) |
+| 403 | `strict_pin_not_allowed` | `modelStrict: true` requested on a free tenant without a superadmin daily-limit override — upgrade or drop `modelStrict`. |
+| 503 | `model_unavailable` | `modelStrict: true` and the requested model is on cooldown / unconfigured. `error.details = { requestedModel, reason }`. |
 | 503 | (no code) | Vendor key not configured for the active plan tier |
 | 401 | `missing_api_key` | Auth issues |
 | 403 | (varied) | Wrong scope / wrong tenant for the URL |
@@ -365,7 +367,17 @@ Vendor prefixes (`openrouter/`, `cerebras/`, `ollama/`) explicitly route to that
 
 When `model` is unset the gateway picks from the tenant-plan pool with shape-based reordering — `tools` present → tool-capable models try first, `response_format: 'json_schema'` → structured-output models, image content blocks → vision models. Useful for callers that don't run their own model policy.
 
-If you need *strict* control (no substitution under any condition) — e.g. for evaluations or reproducibility — see the [strict-pin pattern in SCENARIOS.md](./docs/SCENARIOS.md#strict-model-pinning-eval--reproducibility). It's a thin client-side helper that throws when `_builderforce.resolvedModel` differs from the request. The gateway's job is availability; yours is policy.
+If you need *strict* control (no substitution under any condition) — e.g. for evaluations or reproducibility — pass `modelStrict: true` alongside `model`. The gateway runs on that model exactly and returns `503 model_unavailable` (with `details: { requestedModel, reason }`) instead of falling through to another model on cooldown / outage / plan-tier mismatch.
+
+```ts
+const res = await client.chat.completions.create({
+  model: 'openrouter/anthropic/claude-3-haiku',
+  modelStrict: true,
+  messages: [...],
+});
+```
+
+**Entitlement:** strict-pin is paid-plan only (Pro / Teams) — or a free tenant with a superadmin-issued daily-limit override. Free-tier requests with `modelStrict: true` get `403 strict_pin_not_allowed` so a single misbehaving model can't drain the daily budget. For a client-side equivalent that works on every plan, see the [strict-pin pattern in SCENARIOS.md](./docs/SCENARIOS.md#strict-model-pinning-eval--reproducibility).
 
 ## Multi-tenancy — one Builderforce key, many of *your* tenants
 

package/dist/index.cjs

@@ -169,6 +169,13 @@ var BuilderforceApiError = class extends Error {
   terminal;
   /** Seconds the consumer should wait before retrying — server-supplied. */
   retryAfter;
+  /**
+   * Cascade attempts that failed before this error was returned — populated
+   * when the gateway returns `429 cascade_exhausted` with a `details.failovers`
+   * array. Each entry includes the vendor that owns the model so callers can
+   * detect single-vendor saturation (e.g. all attempts on `openrouter`).
+   */
+  failovers;
   constructor(message, status, code, details, requestId, extras) {
     super(message);
     this.name = "BuilderforceApiError";
@@ -178,6 +185,21 @@ var BuilderforceApiError = class extends Error {
     this.requestId = requestId;
     this.terminal = extras?.terminal;
     this.retryAfter = extras?.retryAfter;
+    if (details && typeof details === "object") {
+      const f = details.failovers;
+      if (Array.isArray(f)) {
+        const cleaned = [];
+        for (const entry of f) {
+          if (entry && typeof entry === "object") {
+            const e = entry;
+            if (typeof e.model === "string" && typeof e.vendor === "string" && typeof e.code === "number") {
+              cleaned.push({ model: e.model, vendor: e.vendor, code: e.code });
+            }
+          }
+        }
+        if (cleaned.length > 0) this.failovers = cleaned;
+      }
+    }
   }
 };
 var HttpClient = class {
@@ -261,15 +283,18 @@ var HttpClient = class {
     const headerRetryAfter = parsePositiveInt(res.headers.get("retry-after"));
     try {
       const payload = await res.json();
+      const isNested = payload !== null && typeof payload === "object" && payload.success === false && typeof payload.error === "object" && payload.error !== null;
+      const inner = isNested ? payload.error : payload;
+      const message = typeof inner?.message === "string" && inner.message || typeof inner?.error === "string" && inner.error || fallback;
       return new BuilderforceApiError(
-        payload.error ?? fallback,
+        message,
         res.status,
-        payload.code,
-        payload.details,
+        inner?.code,
+        inner?.details,
         requestId,
         {
-          terminal: payload.terminal,
-          retryAfter: headerRetryAfter ?? payload.retryAfter
+          terminal: inner?.terminal,
+          retryAfter: headerRetryAfter ?? inner?.retryAfter
         }
       );
     } catch {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/infrastructure/sse.ts","../src/application/ChatCompletionsApi.ts","../src/application/EmbeddingsApi.ts","../src/application/ModelsApi.ts","../src/application/UsageApi.ts","../src/infrastructure/httpClient.ts","../src/BuilderforceClient.ts"],"sourcesContent":["export { BuilderforceClient, type BuilderforceClientOptions } from './BuilderforceClient';\n\nexport type {\n  // Roles & content\n  ChatRole,\n  ChatMessage,\n  ContentPart,\n  TextContentPart,\n  ImageUrlContentPart,\n  // Tool calling\n  ToolSpec,\n  ToolCall,\n  ToolCallFunction,\n  ToolCallDelta,\n  ToolChoice,\n  FunctionDefinition,\n  // Structured output\n  ResponseFormat,\n  JsonSchemaSpec,\n  // Per-call options\n  PerCallOptions,\n  // Chat completions\n  ChatCompletionCreateParams,\n  ChatCompletionChunk,\n  ChatCompletionResponse,\n  // Models / usage\n  ModelsListResponse,\n  UsageByModel,\n  UsageByDay,\n  UsageByUser,\n  UsageResponse,\n  UsageGetParams,\n  // Embeddings\n  EmbeddingsCreateParams,\n  EmbeddingsResponse,\n  EmbeddingObject,\n} from './domain/types';\n\nexport { ChatCompletionStream } from './application/ChatCompletionsApi';\nexport { EmbeddingsApi } from './application/EmbeddingsApi';\nexport { BuilderforceApiError } from './infrastructure/httpClient';\n","export async function* parseSseJson<T>(\n  stream: ReadableStream<Uint8Array>,\n): AsyncGenerator<T, void, unknown> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  let buffer = '';\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n\n    buffer += decoder.decode(value, { stream: true });\n    const lines = buffer.split('\\n');\n    buffer = lines.pop() ?? '';\n\n    for (const line of lines) {\n      const trimmed = line.trim();\n      if (!trimmed.startsWith('data: ')) continue;\n\n      const data = trimmed.slice(6).trim();\n      if (data === '[DONE]') return;\n\n      try {\n        yield JSON.parse(data) as T;\n      } catch {\n        // Skip malformed chunks instead of breaking the stream.\n      }\n    }\n  }\n}\n","import type { ChatCompletionChunk, ChatCompletionCreateParams, ChatCompletionResponse } from '../domain/types';\nimport { HttpClient, type RequestOptions } from '../infrastructure/httpClient';\nimport { parseSseJson } from '../infrastructure/sse';\n\nexport class ChatCompletionStream implements AsyncIterable<ChatCompletionChunk> {\n  private readonly stream: ReadableStream<Uint8Array>;\n\n  constructor(stream: ReadableStream<Uint8Array>) {\n    this.stream = stream;\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<ChatCompletionChunk, void, unknown> {\n    return parseSseJson<ChatCompletionChunk>(this.stream);\n  }\n\n  async toText(): Promise<string> {\n    let full = '';\n    for await (const chunk of this) {\n      const delta = chunk.choices?.[0]?.delta?.content;\n      if (typeof delta === 'string') {\n        full += delta;\n      }\n    }\n    return full;\n  }\n}\n\n/**\n * Pull SDK-level transport options (timeout, signal, idempotency key) out of\n * the params object so they don't get JSON-serialized into the request body.\n * Returns the request options AND the cleaned-up body.\n */\nfunction splitTransportOptions(params: ChatCompletionCreateParams): {\n  body: Record<string, unknown>;\n  request: RequestOptions;\n} {\n  const { timeoutMs, signal, idempotencyKey, ...rest } = params;\n  const headers: Record<string, string> = {};\n  if (idempotencyKey) headers['Idempotency-Key'] = idempotencyKey;\n  return {\n    body: rest as unknown as Record<string, unknown>,\n    request: {\n      timeoutMs,\n      signal,\n      ...(Object.keys(headers).length > 0 ? { headers } : {}),\n    },\n  };\n}\n\nexport class ChatCompletionsApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  async create(params: ChatCompletionCreateParams & { stream: true }): Promise<ChatCompletionStream>;\n  async create(params: ChatCompletionCreateParams & { stream?: false | undefined }): Promise<ChatCompletionResponse>;\n  async create(\n    params: ChatCompletionCreateParams,\n  ): Promise<ChatCompletionResponse | ChatCompletionStream> {\n    const { body, request } = splitTransportOptions(params);\n\n    if (params.stream) {\n      const response = await this.http.postRaw('/llm/v1/chat/completions', body, request);\n      if (!response.body) {\n        throw new Error('Streaming response body is missing');\n      }\n      return new ChatCompletionStream(response.body);\n    }\n\n    return this.http.postJson<ChatCompletionResponse>('/llm/v1/chat/completions', body, request);\n  }\n}\n","import type { EmbeddingsCreateParams, EmbeddingsResponse } from '../domain/types';\nimport { HttpClient, type RequestOptions } from '../infrastructure/httpClient';\n\n/**\n * Pull SDK-level transport options out of the params so they don't ride\n * along inside the JSON body. Same shape as ChatCompletionsApi (DRY pattern).\n */\nfunction splitTransportOptions(params: EmbeddingsCreateParams): {\n  body: Record<string, unknown>;\n  request: RequestOptions;\n} {\n  const { timeoutMs, signal, idempotencyKey, ...rest } = params;\n  const headers: Record<string, string> = {};\n  if (idempotencyKey) headers['Idempotency-Key'] = idempotencyKey;\n  return {\n    body: rest as unknown as Record<string, unknown>,\n    request: {\n      timeoutMs,\n      signal,\n      ...(Object.keys(headers).length > 0 ? { headers } : {}),\n    },\n  };\n}\n\nexport class EmbeddingsApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  /**\n   * Create one or more text embeddings. Wired to OpenRouter (default model\n   * `nvidia/llama-nemotron-embed-vl-1b-v2:free`). Override via `model`.\n   */\n  create(params: EmbeddingsCreateParams): Promise<EmbeddingsResponse> {\n    const { body, request } = splitTransportOptions(params);\n    return this.http.postJson<EmbeddingsResponse>('/llm/v1/embeddings', body, request);\n  }\n}\n","import type { ModelsListResponse } from '../domain/types';\nimport { HttpClient } from '../infrastructure/httpClient';\n\nexport class ModelsApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  list(): Promise<ModelsListResponse> {\n    return this.http.getJson<ModelsListResponse>('/llm/v1/models');\n  }\n}\n","import type { UsageGetParams, UsageResponse } from '../domain/types';\nimport { HttpClient } from '../infrastructure/httpClient';\n\nexport class UsageApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  get(params: UsageGetParams = {}): Promise<UsageResponse> {\n    const query = typeof params.days === 'number' ? `?days=${encodeURIComponent(String(params.days))}` : '';\n    return this.http.getJson<UsageResponse>(`/llm/v1/usage${query}`);\n  }\n}\n","export class BuilderforceApiError extends Error {\n  public readonly status: number;\n  public readonly code?: string;\n  public readonly details?: unknown;\n  public readonly requestId?: string;\n  /**\n   * `true` when the gateway has signalled this error will not resolve by\n   * retrying on a different model — e.g. plan or per-claw daily token cap\n   * exhausted (those caps are per-tenant, not per-model). Consumer-side\n   * fallback chains should short-circuit when this is set.\n   */\n  public readonly terminal?: boolean;\n  /** Seconds the consumer should wait before retrying — server-supplied. */\n  public readonly retryAfter?: number;\n\n  constructor(\n    message: string,\n    status: number,\n    code?: string,\n    details?: unknown,\n    requestId?: string,\n    extras?: { terminal?: boolean; retryAfter?: number },\n  ) {\n    super(message);\n    this.name = 'BuilderforceApiError';\n    this.status = status;\n    this.code = code;\n    this.details = details;\n    this.requestId = requestId;\n    this.terminal = extras?.terminal;\n    this.retryAfter = extras?.retryAfter;\n  }\n}\n\nexport interface HttpClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  fetchFn?: typeof fetch;\n  /** Default per-request timeout in ms. Overridable per call. */\n  timeoutMs?: number;\n}\n\n/** Per-request overrides — passed by the API layer, not by SDK consumers directly. */\nexport interface RequestOptions {\n  /** Override the client default timeout for just this request. */\n  timeoutMs?: number;\n  /** Caller-provided AbortSignal. Linked together with the SDK's internal timeout\n   *  signal — whichever fires first aborts the request. */\n  signal?: AbortSignal;\n  /** Extra headers to merge in (e.g. `Idempotency-Key`). */\n  headers?: Record<string, string>;\n}\n\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchFn: typeof fetch;\n  private readonly defaultTimeoutMs: number;\n\n  constructor(options: HttpClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '');\n    // Bind to `globalThis` so calling via `this.fetchFn(...)` doesn't trip\n    // Cloudflare Workers' \"Illegal invocation\" check — the platform's fetch\n    // requires the global receiver, not an instance method `this`. Affects\n    // any environment that ships a strict-receiver fetch (Workers, Bun, etc.)\n    // and is harmless on Node + browsers.\n    const fetchImpl = options.fetchFn ?? fetch;\n    this.fetchFn = fetchImpl.bind(globalThis);\n    this.defaultTimeoutMs = options.timeoutMs ?? 60_000;\n  }\n\n  async getJson<T>(path: string, options?: RequestOptions): Promise<T> {\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\n      method: 'GET',\n      headers: this.mergeHeaders(options),\n    }, options);\n    return this.parseJsonResponse<T>(res);\n  }\n\n  async postJson<T>(path: string, body: unknown, options?: RequestOptions): Promise<T> {\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\n      method: 'POST',\n      headers: this.mergeHeaders(options, { 'Content-Type': 'application/json' }),\n      body: JSON.stringify(body),\n    }, options);\n    return this.parseJsonResponse<T>(res);\n  }\n\n  async postRaw(path: string, body: unknown, options?: RequestOptions): Promise<Response> {\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\n      method: 'POST',\n      headers: this.mergeHeaders(options, { 'Content-Type': 'application/json' }),\n      body: JSON.stringify(body),\n    }, options);\n    if (!res.ok) {\n      throw await this.toApiError(res);\n    }\n    return res;\n  }\n\n  private mergeHeaders(options?: RequestOptions, base?: Record<string, string>): Record<string, string> {\n    return {\n      Authorization: `Bearer ${this.apiKey}`,\n      ...(base ?? {}),\n      ...(options?.headers ?? {}),\n    };\n  }\n\n  /**\n   * Wrap a fetch in a combined abort signal: an internal timeout AND any\n   * caller-provided signal. Either firing aborts the request. Single source of\n   * abort plumbing — every method routes through here (DRY).\n   */\n  private async fetchWithTimeout(\n    input: RequestInfo | URL,\n    init: RequestInit,\n    options?: RequestOptions,\n  ): Promise<Response> {\n    const timeoutMs = options?.timeoutMs ?? this.defaultTimeoutMs;\n    const timeoutCtl = new AbortController();\n    const timer = setTimeout(() => timeoutCtl.abort(), timeoutMs);\n\n    // Combine internal timeout signal + caller signal. Native AbortSignal.any\n    // (Node 20+ / modern Workers) is preferred; fall back to manual linking.\n    const signal = combineSignals(timeoutCtl.signal, options?.signal);\n\n    try {\n      return await this.fetchFn(input, { ...init, signal });\n    } catch (error) {\n      if (timeoutCtl.signal.aborted) {\n        throw new BuilderforceApiError(`Request timed out after ${timeoutMs}ms`, 408, 'timeout');\n      }\n      if (options?.signal?.aborted) {\n        throw new BuilderforceApiError('Request aborted by caller', 499, 'aborted');\n      }\n      throw error;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private async parseJsonResponse<T>(res: Response): Promise<T> {\n    if (!res.ok) {\n      throw await this.toApiError(res);\n    }\n    return res.json() as Promise<T>;\n  }\n\n  private async toApiError(res: Response): Promise<BuilderforceApiError> {\n    const fallback = `Request failed (${res.status})`;\n    const requestId = res.headers.get('x-request-id') ?? undefined;\n\n    // Prefer server-supplied `Retry-After` header (seconds) when present; the\n    // body's `retryAfter` is a fallback for environments that strip headers.\n    const headerRetryAfter = parsePositiveInt(res.headers.get('retry-after'));\n\n    try {\n      const payload = await res.json() as {\n        error?:      string;\n        code?:       string;\n        details?:    unknown;\n        terminal?:   boolean;\n        retryAfter?: number;\n      };\n      return new BuilderforceApiError(\n        payload.error ?? fallback,\n        res.status,\n        payload.code,\n        payload.details,\n        requestId,\n        {\n          terminal:   payload.terminal,\n          retryAfter: headerRetryAfter ?? payload.retryAfter,\n        },\n      );\n    } catch {\n      const text = await res.text().catch(() => '');\n      return new BuilderforceApiError(\n        text || fallback,\n        res.status,\n        undefined,\n        undefined,\n        requestId,\n        headerRetryAfter !== undefined ? { retryAfter: headerRetryAfter } : undefined,\n      );\n    }\n  }\n}\n\nfunction parsePositiveInt(s: string | null): number | undefined {\n  if (s == null) return undefined;\n  const n = Number(s);\n  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : undefined;\n}\n\n/**\n * Combine multiple AbortSignals into one. Uses native `AbortSignal.any` when\n * available (Node 20+, modern Workers); falls back to manual event linking.\n */\nfunction combineSignals(...signals: Array<AbortSignal | undefined>): AbortSignal {\n  const live = signals.filter((s): s is AbortSignal => s !== undefined);\n  if (live.length === 1) return live[0]!;\n\n  const anyImpl = (AbortSignal as unknown as { any?: (signals: AbortSignal[]) => AbortSignal }).any;\n  if (typeof anyImpl === 'function') {\n    return anyImpl(live);\n  }\n\n  const ctl = new AbortController();\n  for (const s of live) {\n    if (s.aborted) { ctl.abort(s.reason); break; }\n    s.addEventListener('abort', () => ctl.abort(s.reason), { once: true });\n  }\n  return ctl.signal;\n}\n","import { ChatCompletionsApi } from './application/ChatCompletionsApi';\nimport { EmbeddingsApi } from './application/EmbeddingsApi';\nimport { ModelsApi } from './application/ModelsApi';\nimport { UsageApi } from './application/UsageApi';\nimport { BuilderforceApiError, HttpClient } from './infrastructure/httpClient';\n\nexport interface BuilderforceClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof fetch;\n  /** Default request timeout in ms (default 60_000). Per-call override available\n   *  via `chat.completions.create({ timeoutMs })` and `embeddings.create({ timeoutMs })`. */\n  timeoutMs?: number;\n}\n\nexport class BuilderforceClient {\n  public readonly chat: {\n    completions: ChatCompletionsApi;\n  };\n  public readonly embeddings: EmbeddingsApi;\n  public readonly models: ModelsApi;\n  public readonly usage: UsageApi;\n\n  constructor(options: BuilderforceClientOptions) {\n    const apiKey = options.apiKey?.trim();\n    if (!apiKey) {\n      throw new BuilderforceApiError(\n        'BuilderforceClient requires a non-empty apiKey',\n        400,\n        'missing_api_key',\n      );\n    }\n\n    const http = new HttpClient({\n      apiKey,\n      baseUrl: options.baseUrl ?? 'https://api.builderforce.ai',\n      fetchFn: options.fetch,\n      timeoutMs: options.timeoutMs,\n    });\n\n    this.chat = {\n      completions: new ChatCompletionsApi(http),\n    };\n    this.embeddings = new EmbeddingsApi(http);\n    this.models = new ModelsApi(http);\n    this.usage = new UsageApi(http);\n  }\n}\n"],"mappings":"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","names":["splitTransportOptions"]}
+{"version":3,"sources":["../src/index.ts","../src/infrastructure/sse.ts","../src/application/ChatCompletionsApi.ts","../src/application/EmbeddingsApi.ts","../src/application/ModelsApi.ts","../src/application/UsageApi.ts","../src/infrastructure/httpClient.ts","../src/BuilderforceClient.ts"],"sourcesContent":["export { BuilderforceClient, type BuilderforceClientOptions } from './BuilderforceClient';\n\nexport type {\n  // Roles & content\n  ChatRole,\n  ChatMessage,\n  ContentPart,\n  TextContentPart,\n  ImageUrlContentPart,\n  // Tool calling\n  ToolSpec,\n  ToolCall,\n  ToolCallFunction,\n  ToolCallDelta,\n  ToolChoice,\n  FunctionDefinition,\n  // Structured output\n  ResponseFormat,\n  JsonSchemaSpec,\n  // Per-call options\n  PerCallOptions,\n  // Chat completions\n  ChatCompletionCreateParams,\n  ChatCompletionChunk,\n  ChatCompletionResponse,\n  FailoverEvent,\n  // Models / usage\n  ModelsListResponse,\n  UsageByModel,\n  UsageByDay,\n  UsageByUser,\n  UsageResponse,\n  UsageGetParams,\n  // Embeddings\n  EmbeddingsCreateParams,\n  EmbeddingsResponse,\n  EmbeddingObject,\n} from './domain/types';\n\nexport { ChatCompletionStream } from './application/ChatCompletionsApi';\nexport { EmbeddingsApi } from './application/EmbeddingsApi';\nexport { BuilderforceApiError } from './infrastructure/httpClient';\n","export async function* parseSseJson<T>(\n  stream: ReadableStream<Uint8Array>,\n): AsyncGenerator<T, void, unknown> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  let buffer = '';\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n\n    buffer += decoder.decode(value, { stream: true });\n    const lines = buffer.split('\\n');\n    buffer = lines.pop() ?? '';\n\n    for (const line of lines) {\n      const trimmed = line.trim();\n      if (!trimmed.startsWith('data: ')) continue;\n\n      const data = trimmed.slice(6).trim();\n      if (data === '[DONE]') return;\n\n      try {\n        yield JSON.parse(data) as T;\n      } catch {\n        // Skip malformed chunks instead of breaking the stream.\n      }\n    }\n  }\n}\n","import type { ChatCompletionChunk, ChatCompletionCreateParams, ChatCompletionResponse } from '../domain/types';\nimport { HttpClient, type RequestOptions } from '../infrastructure/httpClient';\nimport { parseSseJson } from '../infrastructure/sse';\n\nexport class ChatCompletionStream implements AsyncIterable<ChatCompletionChunk> {\n  private readonly stream: ReadableStream<Uint8Array>;\n\n  constructor(stream: ReadableStream<Uint8Array>) {\n    this.stream = stream;\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<ChatCompletionChunk, void, unknown> {\n    return parseSseJson<ChatCompletionChunk>(this.stream);\n  }\n\n  async toText(): Promise<string> {\n    let full = '';\n    for await (const chunk of this) {\n      const delta = chunk.choices?.[0]?.delta?.content;\n      if (typeof delta === 'string') {\n        full += delta;\n      }\n    }\n    return full;\n  }\n}\n\n/**\n * Pull SDK-level transport options (timeout, signal, idempotency key) out of\n * the params object so they don't get JSON-serialized into the request body.\n * Returns the request options AND the cleaned-up body.\n */\nfunction splitTransportOptions(params: ChatCompletionCreateParams): {\n  body: Record<string, unknown>;\n  request: RequestOptions;\n} {\n  const { timeoutMs, signal, idempotencyKey, ...rest } = params;\n  const headers: Record<string, string> = {};\n  if (idempotencyKey) headers['Idempotency-Key'] = idempotencyKey;\n  return {\n    body: rest as unknown as Record<string, unknown>,\n    request: {\n      timeoutMs,\n      signal,\n      ...(Object.keys(headers).length > 0 ? { headers } : {}),\n    },\n  };\n}\n\nexport class ChatCompletionsApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  async create(params: ChatCompletionCreateParams & { stream: true }): Promise<ChatCompletionStream>;\n  async create(params: ChatCompletionCreateParams & { stream?: false | undefined }): Promise<ChatCompletionResponse>;\n  async create(\n    params: ChatCompletionCreateParams,\n  ): Promise<ChatCompletionResponse | ChatCompletionStream> {\n    const { body, request } = splitTransportOptions(params);\n\n    if (params.stream) {\n      const response = await this.http.postRaw('/llm/v1/chat/completions', body, request);\n      if (!response.body) {\n        throw new Error('Streaming response body is missing');\n      }\n      return new ChatCompletionStream(response.body);\n    }\n\n    return this.http.postJson<ChatCompletionResponse>('/llm/v1/chat/completions', body, request);\n  }\n}\n","import type { EmbeddingsCreateParams, EmbeddingsResponse } from '../domain/types';\nimport { HttpClient, type RequestOptions } from '../infrastructure/httpClient';\n\n/**\n * Pull SDK-level transport options out of the params so they don't ride\n * along inside the JSON body. Same shape as ChatCompletionsApi (DRY pattern).\n */\nfunction splitTransportOptions(params: EmbeddingsCreateParams): {\n  body: Record<string, unknown>;\n  request: RequestOptions;\n} {\n  const { timeoutMs, signal, idempotencyKey, ...rest } = params;\n  const headers: Record<string, string> = {};\n  if (idempotencyKey) headers['Idempotency-Key'] = idempotencyKey;\n  return {\n    body: rest as unknown as Record<string, unknown>,\n    request: {\n      timeoutMs,\n      signal,\n      ...(Object.keys(headers).length > 0 ? { headers } : {}),\n    },\n  };\n}\n\nexport class EmbeddingsApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  /**\n   * Create one or more text embeddings. Wired to OpenRouter (default model\n   * `nvidia/llama-nemotron-embed-vl-1b-v2:free`). Override via `model`.\n   */\n  create(params: EmbeddingsCreateParams): Promise<EmbeddingsResponse> {\n    const { body, request } = splitTransportOptions(params);\n    return this.http.postJson<EmbeddingsResponse>('/llm/v1/embeddings', body, request);\n  }\n}\n","import type { ModelsListResponse } from '../domain/types';\nimport { HttpClient } from '../infrastructure/httpClient';\n\nexport class ModelsApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  list(): Promise<ModelsListResponse> {\n    return this.http.getJson<ModelsListResponse>('/llm/v1/models');\n  }\n}\n","import type { UsageGetParams, UsageResponse } from '../domain/types';\nimport { HttpClient } from '../infrastructure/httpClient';\n\nexport class UsageApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  get(params: UsageGetParams = {}): Promise<UsageResponse> {\n    const query = typeof params.days === 'number' ? `?days=${encodeURIComponent(String(params.days))}` : '';\n    return this.http.getJson<UsageResponse>(`/llm/v1/usage${query}`);\n  }\n}\n","import type { FailoverEvent } from '../domain/types';\n\nexport class BuilderforceApiError extends Error {\n  public readonly status: number;\n  public readonly code?: string;\n  public readonly details?: unknown;\n  public readonly requestId?: string;\n  /**\n   * `true` when the gateway has signalled this error will not resolve by\n   * retrying on a different model — e.g. plan or per-claw daily token cap\n   * exhausted (those caps are per-tenant, not per-model). Consumer-side\n   * fallback chains should short-circuit when this is set.\n   */\n  public readonly terminal?: boolean;\n  /** Seconds the consumer should wait before retrying — server-supplied. */\n  public readonly retryAfter?: number;\n  /**\n   * Cascade attempts that failed before this error was returned — populated\n   * when the gateway returns `429 cascade_exhausted` with a `details.failovers`\n   * array. Each entry includes the vendor that owns the model so callers can\n   * detect single-vendor saturation (e.g. all attempts on `openrouter`).\n   */\n  public readonly failovers?: FailoverEvent[];\n\n  constructor(\n    message: string,\n    status: number,\n    code?: string,\n    details?: unknown,\n    requestId?: string,\n    extras?: { terminal?: boolean; retryAfter?: number },\n  ) {\n    super(message);\n    this.name = 'BuilderforceApiError';\n    this.status = status;\n    this.code = code;\n    this.details = details;\n    this.requestId = requestId;\n    this.terminal = extras?.terminal;\n    this.retryAfter = extras?.retryAfter;\n    // Pull typed failovers out of `details.failovers` when the gateway\n    // supplied them. Validation is light — drop entries missing required\n    // fields so consumers never get a partially-populated row.\n    if (details && typeof details === 'object') {\n      const f = (details as { failovers?: unknown }).failovers;\n      if (Array.isArray(f)) {\n        const cleaned: FailoverEvent[] = [];\n        for (const entry of f) {\n          if (entry && typeof entry === 'object') {\n            const e = entry as { model?: unknown; vendor?: unknown; code?: unknown };\n            if (typeof e.model === 'string' && typeof e.vendor === 'string' && typeof e.code === 'number') {\n              cleaned.push({ model: e.model, vendor: e.vendor, code: e.code });\n            }\n          }\n        }\n        if (cleaned.length > 0) this.failovers = cleaned;\n      }\n    }\n  }\n}\n\nexport interface HttpClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  fetchFn?: typeof fetch;\n  /** Default per-request timeout in ms. Overridable per call. */\n  timeoutMs?: number;\n}\n\n/** Per-request overrides — passed by the API layer, not by SDK consumers directly. */\nexport interface RequestOptions {\n  /** Override the client default timeout for just this request. */\n  timeoutMs?: number;\n  /** Caller-provided AbortSignal. Linked together with the SDK's internal timeout\n   *  signal — whichever fires first aborts the request. */\n  signal?: AbortSignal;\n  /** Extra headers to merge in (e.g. `Idempotency-Key`). */\n  headers?: Record<string, string>;\n}\n\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchFn: typeof fetch;\n  private readonly defaultTimeoutMs: number;\n\n  constructor(options: HttpClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '');\n    // Bind to `globalThis` so calling via `this.fetchFn(...)` doesn't trip\n    // Cloudflare Workers' \"Illegal invocation\" check — the platform's fetch\n    // requires the global receiver, not an instance method `this`. Affects\n    // any environment that ships a strict-receiver fetch (Workers, Bun, etc.)\n    // and is harmless on Node + browsers.\n    const fetchImpl = options.fetchFn ?? fetch;\n    this.fetchFn = fetchImpl.bind(globalThis);\n    this.defaultTimeoutMs = options.timeoutMs ?? 60_000;\n  }\n\n  async getJson<T>(path: string, options?: RequestOptions): Promise<T> {\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\n      method: 'GET',\n      headers: this.mergeHeaders(options),\n    }, options);\n    return this.parseJsonResponse<T>(res);\n  }\n\n  async postJson<T>(path: string, body: unknown, options?: RequestOptions): Promise<T> {\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\n      method: 'POST',\n      headers: this.mergeHeaders(options, { 'Content-Type': 'application/json' }),\n      body: JSON.stringify(body),\n    }, options);\n    return this.parseJsonResponse<T>(res);\n  }\n\n  async postRaw(path: string, body: unknown, options?: RequestOptions): Promise<Response> {\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\n      method: 'POST',\n      headers: this.mergeHeaders(options, { 'Content-Type': 'application/json' }),\n      body: JSON.stringify(body),\n    }, options);\n    if (!res.ok) {\n      throw await this.toApiError(res);\n    }\n    return res;\n  }\n\n  private mergeHeaders(options?: RequestOptions, base?: Record<string, string>): Record<string, string> {\n    return {\n      Authorization: `Bearer ${this.apiKey}`,\n      ...(base ?? {}),\n      ...(options?.headers ?? {}),\n    };\n  }\n\n  /**\n   * Wrap a fetch in a combined abort signal: an internal timeout AND any\n   * caller-provided signal. Either firing aborts the request. Single source of\n   * abort plumbing — every method routes through here (DRY).\n   */\n  private async fetchWithTimeout(\n    input: RequestInfo | URL,\n    init: RequestInit,\n    options?: RequestOptions,\n  ): Promise<Response> {\n    const timeoutMs = options?.timeoutMs ?? this.defaultTimeoutMs;\n    const timeoutCtl = new AbortController();\n    const timer = setTimeout(() => timeoutCtl.abort(), timeoutMs);\n\n    // Combine internal timeout signal + caller signal. Native AbortSignal.any\n    // (Node 20+ / modern Workers) is preferred; fall back to manual linking.\n    const signal = combineSignals(timeoutCtl.signal, options?.signal);\n\n    try {\n      return await this.fetchFn(input, { ...init, signal });\n    } catch (error) {\n      if (timeoutCtl.signal.aborted) {\n        throw new BuilderforceApiError(`Request timed out after ${timeoutMs}ms`, 408, 'timeout');\n      }\n      if (options?.signal?.aborted) {\n        throw new BuilderforceApiError('Request aborted by caller', 499, 'aborted');\n      }\n      throw error;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private async parseJsonResponse<T>(res: Response): Promise<T> {\n    if (!res.ok) {\n      throw await this.toApiError(res);\n    }\n    return res.json() as Promise<T>;\n  }\n\n  private async toApiError(res: Response): Promise<BuilderforceApiError> {\n    const fallback = `Request failed (${res.status})`;\n    const requestId = res.headers.get('x-request-id') ?? undefined;\n\n    // Prefer server-supplied `Retry-After` header (seconds) when present; the\n    // body's `retryAfter` is a fallback for environments that strip headers.\n    const headerRetryAfter = parsePositiveInt(res.headers.get('retry-after'));\n\n    try {\n      const payload = await res.json() as Record<string, unknown> | null;\n\n      // Two envelope shapes are in the wild:\n      //\n      //   Flat   — { error: \"msg\", code, details, terminal?, retryAfter? }\n      //            (gateway's documented shape — plan_token_limit_exceeded etc.)\n      //   Nested — { success: false, error: { code, message, details } }\n      //            (consumer-side wrappers around the gateway, e.g. some\n      //             tenant proxies emit AI_RATE_LIMITED / AI_UNAVAILABLE\n      //             envelopes that re-wrap the upstream error)\n      //\n      // Detect via the `success: false` discriminator and unwrap when nested\n      // so `error.code` / `error.message` / `error.details` always populate.\n      const isNested =\n        payload !== null\n        && typeof payload === 'object'\n        && payload.success === false\n        && typeof payload.error === 'object'\n        && payload.error !== null;\n\n      const inner = (isNested ? payload.error : payload) as {\n        error?:      string;\n        message?:    string;\n        code?:       string;\n        details?:    unknown;\n        terminal?:   boolean;\n        retryAfter?: number;\n      } | null;\n\n      const message =\n        (typeof inner?.message === 'string' && inner.message)\n        || (typeof inner?.error === 'string' && inner.error)\n        || fallback;\n\n      return new BuilderforceApiError(\n        message,\n        res.status,\n        inner?.code,\n        inner?.details,\n        requestId,\n        {\n          terminal:   inner?.terminal,\n          retryAfter: headerRetryAfter ?? inner?.retryAfter,\n        },\n      );\n    } catch {\n      const text = await res.text().catch(() => '');\n      return new BuilderforceApiError(\n        text || fallback,\n        res.status,\n        undefined,\n        undefined,\n        requestId,\n        headerRetryAfter !== undefined ? { retryAfter: headerRetryAfter } : undefined,\n      );\n    }\n  }\n}\n\nfunction parsePositiveInt(s: string | null): number | undefined {\n  if (s == null) return undefined;\n  const n = Number(s);\n  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : undefined;\n}\n\n/**\n * Combine multiple AbortSignals into one. Uses native `AbortSignal.any` when\n * available (Node 20+, modern Workers); falls back to manual event linking.\n */\nfunction combineSignals(...signals: Array<AbortSignal | undefined>): AbortSignal {\n  const live = signals.filter((s): s is AbortSignal => s !== undefined);\n  if (live.length === 1) return live[0]!;\n\n  const anyImpl = (AbortSignal as unknown as { any?: (signals: AbortSignal[]) => AbortSignal }).any;\n  if (typeof anyImpl === 'function') {\n    return anyImpl(live);\n  }\n\n  const ctl = new AbortController();\n  for (const s of live) {\n    if (s.aborted) { ctl.abort(s.reason); break; }\n    s.addEventListener('abort', () => ctl.abort(s.reason), { once: true });\n  }\n  return ctl.signal;\n}\n","import { ChatCompletionsApi } from './application/ChatCompletionsApi';\nimport { EmbeddingsApi } from './application/EmbeddingsApi';\nimport { ModelsApi } from './application/ModelsApi';\nimport { UsageApi } from './application/UsageApi';\nimport { BuilderforceApiError, HttpClient } from './infrastructure/httpClient';\n\nexport interface BuilderforceClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof fetch;\n  /** Default request timeout in ms (default 60_000). Per-call override available\n   *  via `chat.completions.create({ timeoutMs })` and `embeddings.create({ timeoutMs })`. */\n  timeoutMs?: number;\n}\n\nexport class BuilderforceClient {\n  public readonly chat: {\n    completions: ChatCompletionsApi;\n  };\n  public readonly embeddings: EmbeddingsApi;\n  public readonly models: ModelsApi;\n  public readonly usage: UsageApi;\n\n  constructor(options: BuilderforceClientOptions) {\n    const apiKey = options.apiKey?.trim();\n    if (!apiKey) {\n      throw new BuilderforceApiError(\n        'BuilderforceClient requires a non-empty apiKey',\n        400,\n        'missing_api_key',\n      );\n    }\n\n    const http = new HttpClient({\n      apiKey,\n      baseUrl: options.baseUrl ?? 'https://api.builderforce.ai',\n      fetchFn: options.fetch,\n      timeoutMs: options.timeoutMs,\n    });\n\n    this.chat = {\n      completions: new ChatCompletionsApi(http),\n    };\n    this.embeddings = new EmbeddingsApi(http);\n    this.models = new ModelsApi(http);\n    this.usage = new UsageApi(http);\n  }\n}\n"],"mappings":"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","names":["splitTransportOptions"]}

package/dist/index.d.cts

@@ -1,4 +1,20 @@
 type ChatRole = 'system' | 'user' | 'assistant' | 'tool';
+/**
+ * One model attempt that failed before the resolved model succeeded.
+ * Surfaced on successful responses in `_builderforce.failovers` (when retries
+ * happened) and on cascade-exhausted errors in `error.details.failovers`.
+ *
+ * `vendor` lets callers detect when every failure concentrated on one
+ * upstream — e.g. all `openrouter` means a saturated shared key, not a
+ * model-specific issue.
+ */
+interface FailoverEvent {
+    model: string;
+    /** `'openrouter' | 'cerebras' | 'nvidia' | 'ollama'` */
+    vendor: string;
+    /** HTTP status code, or 0 for embedded errors / network failures. */
+    code: number;
+}
 interface TextContentPart {
     type: 'text';
     text: string;
@@ -91,11 +107,10 @@ interface PerCallOptions {
 }
 interface ChatCompletionCreateParams extends PerCallOptions {
     /**
-     * Model **hint** (not a hard pin). When set, the gateway puts this id at the
-     * head of its candidate chain so it's tried first — but the gateway retains
-     * the right to substitute on cooldown, vendor outage, or plan-tier mismatch.
-     * The actual model used is reported via `_builderforce.resolvedModel`; check
-     * it if you need to detect substitution.
+     * Model **hint** (not a hard pin by default). The gateway puts this id at
+     * the head of its candidate chain so it's tried first, but it retains the
+     * right to substitute on cooldown / outage / plan-tier mismatch. Read
+     * `_builderforce.resolvedModel` to detect substitution.
      *
      * Vendor prefixes (`openrouter/<id>`, `cerebras/<id>`, `ollama/<id>`) route
      * to the named vendor when that model is selected. Bare ids fall back to
@@ -103,8 +118,22 @@ interface ChatCompletionCreateParams extends PerCallOptions {
      *
      * When unset, the gateway picks from the tenant-plan model pool with
      * shape-based reordering (tools / response_format / vision content blocks).
+     *
+     * For *strict* pinning, see `modelStrict`.
      */
     model?: string;
+    /**
+     * When `true` and `model` is set, the gateway runs on `model` exactly —
+     * no substitution. If the model is on cooldown / unconfigured / unavailable,
+     * the gateway returns `503 model_unavailable` instead of falling through to
+     * another model. Use for reproducible eval / A-B-test runs.
+     *
+     * **Entitlement:** strict-pin requires a paid plan (Pro / Teams) OR a
+     * superadmin-issued daily-limit override. Free-tier requests with
+     * `modelStrict: true` get `403 strict_pin_not_allowed` so a single
+     * misbehaving model can't drain a free tenant's daily budget.
+     */
+    modelStrict?: boolean;
     messages: ChatMessage[];
     stream?: boolean;
     temperature?: number;
@@ -173,6 +202,13 @@ interface ChatCompletionResponse {
         resolvedModel?: string;
         /** How many vendor retries happened inside the failover chain. */
         retries?: number;
+        /**
+         * Per-attempt breakdown of the cascade — present only when `retries > 0`.
+         * Each entry is one model the gateway tried that failed before the
+         * resolved model succeeded. Use `vendor` to detect single-vendor
+         * concentration (e.g. all failures on `openrouter` = saturated key).
+         */
+        failovers?: FailoverEvent[];
         pool?: number;
         product?: string;
         effectivePlan?: string;
@@ -303,6 +339,13 @@ declare class BuilderforceApiError extends Error {
     readonly terminal?: boolean;
     /** Seconds the consumer should wait before retrying — server-supplied. */
     readonly retryAfter?: number;
+    /**
+     * Cascade attempts that failed before this error was returned — populated
+     * when the gateway returns `429 cascade_exhausted` with a `details.failovers`
+     * array. Each entry includes the vendor that owns the model so callers can
+     * detect single-vendor saturation (e.g. all attempts on `openrouter`).
+     */
+    readonly failovers?: FailoverEvent[];
     constructor(message: string, status: number, code?: string, details?: unknown, requestId?: string, extras?: {
         terminal?: boolean;
         retryAfter?: number;
@@ -402,4 +445,4 @@ declare class BuilderforceClient {
     constructor(options: BuilderforceClientOptions);
 }
 
-export { BuilderforceApiError, BuilderforceClient, type BuilderforceClientOptions, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatCompletionResponse, ChatCompletionStream, type ChatMessage, type ChatRole, type ContentPart, type EmbeddingObject, EmbeddingsApi, type EmbeddingsCreateParams, type EmbeddingsResponse, type FunctionDefinition, type ImageUrlContentPart, type JsonSchemaSpec, type ModelsListResponse, type PerCallOptions, type ResponseFormat, type TextContentPart, type ToolCall, type ToolCallDelta, type ToolCallFunction, type ToolChoice, type ToolSpec, type UsageByDay, type UsageByModel, type UsageByUser, type UsageGetParams, type UsageResponse };
+export { BuilderforceApiError, BuilderforceClient, type BuilderforceClientOptions, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatCompletionResponse, ChatCompletionStream, type ChatMessage, type ChatRole, type ContentPart, type EmbeddingObject, EmbeddingsApi, type EmbeddingsCreateParams, type EmbeddingsResponse, type FailoverEvent, type FunctionDefinition, type ImageUrlContentPart, type JsonSchemaSpec, type ModelsListResponse, type PerCallOptions, type ResponseFormat, type TextContentPart, type ToolCall, type ToolCallDelta, type ToolCallFunction, type ToolChoice, type ToolSpec, type UsageByDay, type UsageByModel, type UsageByUser, type UsageGetParams, type UsageResponse };

package/dist/index.d.ts

@@ -1,4 +1,20 @@
 type ChatRole = 'system' | 'user' | 'assistant' | 'tool';
+/**
+ * One model attempt that failed before the resolved model succeeded.
+ * Surfaced on successful responses in `_builderforce.failovers` (when retries
+ * happened) and on cascade-exhausted errors in `error.details.failovers`.
+ *
+ * `vendor` lets callers detect when every failure concentrated on one
+ * upstream — e.g. all `openrouter` means a saturated shared key, not a
+ * model-specific issue.
+ */
+interface FailoverEvent {
+    model: string;
+    /** `'openrouter' | 'cerebras' | 'nvidia' | 'ollama'` */
+    vendor: string;
+    /** HTTP status code, or 0 for embedded errors / network failures. */
+    code: number;
+}
 interface TextContentPart {
     type: 'text';
     text: string;
@@ -91,11 +107,10 @@ interface PerCallOptions {
 }
 interface ChatCompletionCreateParams extends PerCallOptions {
     /**
-     * Model **hint** (not a hard pin). When set, the gateway puts this id at the
-     * head of its candidate chain so it's tried first — but the gateway retains
-     * the right to substitute on cooldown, vendor outage, or plan-tier mismatch.
-     * The actual model used is reported via `_builderforce.resolvedModel`; check
-     * it if you need to detect substitution.
+     * Model **hint** (not a hard pin by default). The gateway puts this id at
+     * the head of its candidate chain so it's tried first, but it retains the
+     * right to substitute on cooldown / outage / plan-tier mismatch. Read
+     * `_builderforce.resolvedModel` to detect substitution.
      *
      * Vendor prefixes (`openrouter/<id>`, `cerebras/<id>`, `ollama/<id>`) route
      * to the named vendor when that model is selected. Bare ids fall back to
@@ -103,8 +118,22 @@ interface ChatCompletionCreateParams extends PerCallOptions {
      *
      * When unset, the gateway picks from the tenant-plan model pool with
      * shape-based reordering (tools / response_format / vision content blocks).
+     *
+     * For *strict* pinning, see `modelStrict`.
      */
     model?: string;
+    /**
+     * When `true` and `model` is set, the gateway runs on `model` exactly —
+     * no substitution. If the model is on cooldown / unconfigured / unavailable,
+     * the gateway returns `503 model_unavailable` instead of falling through to
+     * another model. Use for reproducible eval / A-B-test runs.
+     *
+     * **Entitlement:** strict-pin requires a paid plan (Pro / Teams) OR a
+     * superadmin-issued daily-limit override. Free-tier requests with
+     * `modelStrict: true` get `403 strict_pin_not_allowed` so a single
+     * misbehaving model can't drain a free tenant's daily budget.
+     */
+    modelStrict?: boolean;
     messages: ChatMessage[];
     stream?: boolean;
     temperature?: number;
@@ -173,6 +202,13 @@ interface ChatCompletionResponse {
         resolvedModel?: string;
         /** How many vendor retries happened inside the failover chain. */
         retries?: number;
+        /**
+         * Per-attempt breakdown of the cascade — present only when `retries > 0`.
+         * Each entry is one model the gateway tried that failed before the
+         * resolved model succeeded. Use `vendor` to detect single-vendor
+         * concentration (e.g. all failures on `openrouter` = saturated key).
+         */
+        failovers?: FailoverEvent[];
         pool?: number;
         product?: string;
         effectivePlan?: string;
@@ -303,6 +339,13 @@ declare class BuilderforceApiError extends Error {
     readonly terminal?: boolean;
     /** Seconds the consumer should wait before retrying — server-supplied. */
     readonly retryAfter?: number;
+    /**
+     * Cascade attempts that failed before this error was returned — populated
+     * when the gateway returns `429 cascade_exhausted` with a `details.failovers`
+     * array. Each entry includes the vendor that owns the model so callers can
+     * detect single-vendor saturation (e.g. all attempts on `openrouter`).
+     */
+    readonly failovers?: FailoverEvent[];
     constructor(message: string, status: number, code?: string, details?: unknown, requestId?: string, extras?: {
         terminal?: boolean;
         retryAfter?: number;
@@ -402,4 +445,4 @@ declare class BuilderforceClient {
     constructor(options: BuilderforceClientOptions);
 }
 
-export { BuilderforceApiError, BuilderforceClient, type BuilderforceClientOptions, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatCompletionResponse, ChatCompletionStream, type ChatMessage, type ChatRole, type ContentPart, type EmbeddingObject, EmbeddingsApi, type EmbeddingsCreateParams, type EmbeddingsResponse, type FunctionDefinition, type ImageUrlContentPart, type JsonSchemaSpec, type ModelsListResponse, type PerCallOptions, type ResponseFormat, type TextContentPart, type ToolCall, type ToolCallDelta, type ToolCallFunction, type ToolChoice, type ToolSpec, type UsageByDay, type UsageByModel, type UsageByUser, type UsageGetParams, type UsageResponse };
+export { BuilderforceApiError, BuilderforceClient, type BuilderforceClientOptions, type ChatCompletionChunk, type ChatCompletionCreateParams, type ChatCompletionResponse, ChatCompletionStream, type ChatMessage, type ChatRole, type ContentPart, type EmbeddingObject, EmbeddingsApi, type EmbeddingsCreateParams, type EmbeddingsResponse, type FailoverEvent, type FunctionDefinition, type ImageUrlContentPart, type JsonSchemaSpec, type ModelsListResponse, type PerCallOptions, type ResponseFormat, type TextContentPart, type ToolCall, type ToolCallDelta, type ToolCallFunction, type ToolChoice, type ToolSpec, type UsageByDay, type UsageByModel, type UsageByUser, type UsageGetParams, type UsageResponse };

package/dist/index.mjs

@@ -140,6 +140,13 @@ var BuilderforceApiError = class extends Error {
   terminal;
   /** Seconds the consumer should wait before retrying — server-supplied. */
   retryAfter;
+  /**
+   * Cascade attempts that failed before this error was returned — populated
+   * when the gateway returns `429 cascade_exhausted` with a `details.failovers`
+   * array. Each entry includes the vendor that owns the model so callers can
+   * detect single-vendor saturation (e.g. all attempts on `openrouter`).
+   */
+  failovers;
   constructor(message, status, code, details, requestId, extras) {
     super(message);
     this.name = "BuilderforceApiError";
@@ -149,6 +156,21 @@ var BuilderforceApiError = class extends Error {
     this.requestId = requestId;
     this.terminal = extras?.terminal;
     this.retryAfter = extras?.retryAfter;
+    if (details && typeof details === "object") {
+      const f = details.failovers;
+      if (Array.isArray(f)) {
+        const cleaned = [];
+        for (const entry of f) {
+          if (entry && typeof entry === "object") {
+            const e = entry;
+            if (typeof e.model === "string" && typeof e.vendor === "string" && typeof e.code === "number") {
+              cleaned.push({ model: e.model, vendor: e.vendor, code: e.code });
+            }
+          }
+        }
+        if (cleaned.length > 0) this.failovers = cleaned;
+      }
+    }
   }
 };
 var HttpClient = class {
@@ -232,15 +254,18 @@ var HttpClient = class {
     const headerRetryAfter = parsePositiveInt(res.headers.get("retry-after"));
     try {
       const payload = await res.json();
+      const isNested = payload !== null && typeof payload === "object" && payload.success === false && typeof payload.error === "object" && payload.error !== null;
+      const inner = isNested ? payload.error : payload;
+      const message = typeof inner?.message === "string" && inner.message || typeof inner?.error === "string" && inner.error || fallback;
       return new BuilderforceApiError(
-        payload.error ?? fallback,
+        message,
         res.status,
-        payload.code,
-        payload.details,
+        inner?.code,
+        inner?.details,
         requestId,
         {
-          terminal: payload.terminal,
-          retryAfter: headerRetryAfter ?? payload.retryAfter
+          terminal: inner?.terminal,
+          retryAfter: headerRetryAfter ?? inner?.retryAfter
         }
       );
     } catch {

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/infrastructure/sse.ts","../src/application/ChatCompletionsApi.ts","../src/application/EmbeddingsApi.ts","../src/application/ModelsApi.ts","../src/application/UsageApi.ts","../src/infrastructure/httpClient.ts","../src/BuilderforceClient.ts"],"sourcesContent":["export async function* parseSseJson<T>(\n  stream: ReadableStream<Uint8Array>,\n): AsyncGenerator<T, void, unknown> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  let buffer = '';\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n\n    buffer += decoder.decode(value, { stream: true });\n    const lines = buffer.split('\\n');\n    buffer = lines.pop() ?? '';\n\n    for (const line of lines) {\n      const trimmed = line.trim();\n      if (!trimmed.startsWith('data: ')) continue;\n\n      const data = trimmed.slice(6).trim();\n      if (data === '[DONE]') return;\n\n      try {\n        yield JSON.parse(data) as T;\n      } catch {\n        // Skip malformed chunks instead of breaking the stream.\n      }\n    }\n  }\n}\n","import type { ChatCompletionChunk, ChatCompletionCreateParams, ChatCompletionResponse } from '../domain/types';\nimport { HttpClient, type RequestOptions } from '../infrastructure/httpClient';\nimport { parseSseJson } from '../infrastructure/sse';\n\nexport class ChatCompletionStream implements AsyncIterable<ChatCompletionChunk> {\n  private readonly stream: ReadableStream<Uint8Array>;\n\n  constructor(stream: ReadableStream<Uint8Array>) {\n    this.stream = stream;\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<ChatCompletionChunk, void, unknown> {\n    return parseSseJson<ChatCompletionChunk>(this.stream);\n  }\n\n  async toText(): Promise<string> {\n    let full = '';\n    for await (const chunk of this) {\n      const delta = chunk.choices?.[0]?.delta?.content;\n      if (typeof delta === 'string') {\n        full += delta;\n      }\n    }\n    return full;\n  }\n}\n\n/**\n * Pull SDK-level transport options (timeout, signal, idempotency key) out of\n * the params object so they don't get JSON-serialized into the request body.\n * Returns the request options AND the cleaned-up body.\n */\nfunction splitTransportOptions(params: ChatCompletionCreateParams): {\n  body: Record<string, unknown>;\n  request: RequestOptions;\n} {\n  const { timeoutMs, signal, idempotencyKey, ...rest } = params;\n  const headers: Record<string, string> = {};\n  if (idempotencyKey) headers['Idempotency-Key'] = idempotencyKey;\n  return {\n    body: rest as unknown as Record<string, unknown>,\n    request: {\n      timeoutMs,\n      signal,\n      ...(Object.keys(headers).length > 0 ? { headers } : {}),\n    },\n  };\n}\n\nexport class ChatCompletionsApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  async create(params: ChatCompletionCreateParams & { stream: true }): Promise<ChatCompletionStream>;\n  async create(params: ChatCompletionCreateParams & { stream?: false | undefined }): Promise<ChatCompletionResponse>;\n  async create(\n    params: ChatCompletionCreateParams,\n  ): Promise<ChatCompletionResponse | ChatCompletionStream> {\n    const { body, request } = splitTransportOptions(params);\n\n    if (params.stream) {\n      const response = await this.http.postRaw('/llm/v1/chat/completions', body, request);\n      if (!response.body) {\n        throw new Error('Streaming response body is missing');\n      }\n      return new ChatCompletionStream(response.body);\n    }\n\n    return this.http.postJson<ChatCompletionResponse>('/llm/v1/chat/completions', body, request);\n  }\n}\n","import type { EmbeddingsCreateParams, EmbeddingsResponse } from '../domain/types';\nimport { HttpClient, type RequestOptions } from '../infrastructure/httpClient';\n\n/**\n * Pull SDK-level transport options out of the params so they don't ride\n * along inside the JSON body. Same shape as ChatCompletionsApi (DRY pattern).\n */\nfunction splitTransportOptions(params: EmbeddingsCreateParams): {\n  body: Record<string, unknown>;\n  request: RequestOptions;\n} {\n  const { timeoutMs, signal, idempotencyKey, ...rest } = params;\n  const headers: Record<string, string> = {};\n  if (idempotencyKey) headers['Idempotency-Key'] = idempotencyKey;\n  return {\n    body: rest as unknown as Record<string, unknown>,\n    request: {\n      timeoutMs,\n      signal,\n      ...(Object.keys(headers).length > 0 ? { headers } : {}),\n    },\n  };\n}\n\nexport class EmbeddingsApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  /**\n   * Create one or more text embeddings. Wired to OpenRouter (default model\n   * `nvidia/llama-nemotron-embed-vl-1b-v2:free`). Override via `model`.\n   */\n  create(params: EmbeddingsCreateParams): Promise<EmbeddingsResponse> {\n    const { body, request } = splitTransportOptions(params);\n    return this.http.postJson<EmbeddingsResponse>('/llm/v1/embeddings', body, request);\n  }\n}\n","import type { ModelsListResponse } from '../domain/types';\nimport { HttpClient } from '../infrastructure/httpClient';\n\nexport class ModelsApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  list(): Promise<ModelsListResponse> {\n    return this.http.getJson<ModelsListResponse>('/llm/v1/models');\n  }\n}\n","import type { UsageGetParams, UsageResponse } from '../domain/types';\nimport { HttpClient } from '../infrastructure/httpClient';\n\nexport class UsageApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  get(params: UsageGetParams = {}): Promise<UsageResponse> {\n    const query = typeof params.days === 'number' ? `?days=${encodeURIComponent(String(params.days))}` : '';\n    return this.http.getJson<UsageResponse>(`/llm/v1/usage${query}`);\n  }\n}\n","export class BuilderforceApiError extends Error {\n  public readonly status: number;\n  public readonly code?: string;\n  public readonly details?: unknown;\n  public readonly requestId?: string;\n  /**\n   * `true` when the gateway has signalled this error will not resolve by\n   * retrying on a different model — e.g. plan or per-claw daily token cap\n   * exhausted (those caps are per-tenant, not per-model). Consumer-side\n   * fallback chains should short-circuit when this is set.\n   */\n  public readonly terminal?: boolean;\n  /** Seconds the consumer should wait before retrying — server-supplied. */\n  public readonly retryAfter?: number;\n\n  constructor(\n    message: string,\n    status: number,\n    code?: string,\n    details?: unknown,\n    requestId?: string,\n    extras?: { terminal?: boolean; retryAfter?: number },\n  ) {\n    super(message);\n    this.name = 'BuilderforceApiError';\n    this.status = status;\n    this.code = code;\n    this.details = details;\n    this.requestId = requestId;\n    this.terminal = extras?.terminal;\n    this.retryAfter = extras?.retryAfter;\n  }\n}\n\nexport interface HttpClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  fetchFn?: typeof fetch;\n  /** Default per-request timeout in ms. Overridable per call. */\n  timeoutMs?: number;\n}\n\n/** Per-request overrides — passed by the API layer, not by SDK consumers directly. */\nexport interface RequestOptions {\n  /** Override the client default timeout for just this request. */\n  timeoutMs?: number;\n  /** Caller-provided AbortSignal. Linked together with the SDK's internal timeout\n   *  signal — whichever fires first aborts the request. */\n  signal?: AbortSignal;\n  /** Extra headers to merge in (e.g. `Idempotency-Key`). */\n  headers?: Record<string, string>;\n}\n\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchFn: typeof fetch;\n  private readonly defaultTimeoutMs: number;\n\n  constructor(options: HttpClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '');\n    // Bind to `globalThis` so calling via `this.fetchFn(...)` doesn't trip\n    // Cloudflare Workers' \"Illegal invocation\" check — the platform's fetch\n    // requires the global receiver, not an instance method `this`. Affects\n    // any environment that ships a strict-receiver fetch (Workers, Bun, etc.)\n    // and is harmless on Node + browsers.\n    const fetchImpl = options.fetchFn ?? fetch;\n    this.fetchFn = fetchImpl.bind(globalThis);\n    this.defaultTimeoutMs = options.timeoutMs ?? 60_000;\n  }\n\n  async getJson<T>(path: string, options?: RequestOptions): Promise<T> {\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\n      method: 'GET',\n      headers: this.mergeHeaders(options),\n    }, options);\n    return this.parseJsonResponse<T>(res);\n  }\n\n  async postJson<T>(path: string, body: unknown, options?: RequestOptions): Promise<T> {\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\n      method: 'POST',\n      headers: this.mergeHeaders(options, { 'Content-Type': 'application/json' }),\n      body: JSON.stringify(body),\n    }, options);\n    return this.parseJsonResponse<T>(res);\n  }\n\n  async postRaw(path: string, body: unknown, options?: RequestOptions): Promise<Response> {\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\n      method: 'POST',\n      headers: this.mergeHeaders(options, { 'Content-Type': 'application/json' }),\n      body: JSON.stringify(body),\n    }, options);\n    if (!res.ok) {\n      throw await this.toApiError(res);\n    }\n    return res;\n  }\n\n  private mergeHeaders(options?: RequestOptions, base?: Record<string, string>): Record<string, string> {\n    return {\n      Authorization: `Bearer ${this.apiKey}`,\n      ...(base ?? {}),\n      ...(options?.headers ?? {}),\n    };\n  }\n\n  /**\n   * Wrap a fetch in a combined abort signal: an internal timeout AND any\n   * caller-provided signal. Either firing aborts the request. Single source of\n   * abort plumbing — every method routes through here (DRY).\n   */\n  private async fetchWithTimeout(\n    input: RequestInfo | URL,\n    init: RequestInit,\n    options?: RequestOptions,\n  ): Promise<Response> {\n    const timeoutMs = options?.timeoutMs ?? this.defaultTimeoutMs;\n    const timeoutCtl = new AbortController();\n    const timer = setTimeout(() => timeoutCtl.abort(), timeoutMs);\n\n    // Combine internal timeout signal + caller signal. Native AbortSignal.any\n    // (Node 20+ / modern Workers) is preferred; fall back to manual linking.\n    const signal = combineSignals(timeoutCtl.signal, options?.signal);\n\n    try {\n      return await this.fetchFn(input, { ...init, signal });\n    } catch (error) {\n      if (timeoutCtl.signal.aborted) {\n        throw new BuilderforceApiError(`Request timed out after ${timeoutMs}ms`, 408, 'timeout');\n      }\n      if (options?.signal?.aborted) {\n        throw new BuilderforceApiError('Request aborted by caller', 499, 'aborted');\n      }\n      throw error;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private async parseJsonResponse<T>(res: Response): Promise<T> {\n    if (!res.ok) {\n      throw await this.toApiError(res);\n    }\n    return res.json() as Promise<T>;\n  }\n\n  private async toApiError(res: Response): Promise<BuilderforceApiError> {\n    const fallback = `Request failed (${res.status})`;\n    const requestId = res.headers.get('x-request-id') ?? undefined;\n\n    // Prefer server-supplied `Retry-After` header (seconds) when present; the\n    // body's `retryAfter` is a fallback for environments that strip headers.\n    const headerRetryAfter = parsePositiveInt(res.headers.get('retry-after'));\n\n    try {\n      const payload = await res.json() as {\n        error?:      string;\n        code?:       string;\n        details?:    unknown;\n        terminal?:   boolean;\n        retryAfter?: number;\n      };\n      return new BuilderforceApiError(\n        payload.error ?? fallback,\n        res.status,\n        payload.code,\n        payload.details,\n        requestId,\n        {\n          terminal:   payload.terminal,\n          retryAfter: headerRetryAfter ?? payload.retryAfter,\n        },\n      );\n    } catch {\n      const text = await res.text().catch(() => '');\n      return new BuilderforceApiError(\n        text || fallback,\n        res.status,\n        undefined,\n        undefined,\n        requestId,\n        headerRetryAfter !== undefined ? { retryAfter: headerRetryAfter } : undefined,\n      );\n    }\n  }\n}\n\nfunction parsePositiveInt(s: string | null): number | undefined {\n  if (s == null) return undefined;\n  const n = Number(s);\n  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : undefined;\n}\n\n/**\n * Combine multiple AbortSignals into one. Uses native `AbortSignal.any` when\n * available (Node 20+, modern Workers); falls back to manual event linking.\n */\nfunction combineSignals(...signals: Array<AbortSignal | undefined>): AbortSignal {\n  const live = signals.filter((s): s is AbortSignal => s !== undefined);\n  if (live.length === 1) return live[0]!;\n\n  const anyImpl = (AbortSignal as unknown as { any?: (signals: AbortSignal[]) => AbortSignal }).any;\n  if (typeof anyImpl === 'function') {\n    return anyImpl(live);\n  }\n\n  const ctl = new AbortController();\n  for (const s of live) {\n    if (s.aborted) { ctl.abort(s.reason); break; }\n    s.addEventListener('abort', () => ctl.abort(s.reason), { once: true });\n  }\n  return ctl.signal;\n}\n","import { ChatCompletionsApi } from './application/ChatCompletionsApi';\nimport { EmbeddingsApi } from './application/EmbeddingsApi';\nimport { ModelsApi } from './application/ModelsApi';\nimport { UsageApi } from './application/UsageApi';\nimport { BuilderforceApiError, HttpClient } from './infrastructure/httpClient';\n\nexport interface BuilderforceClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof fetch;\n  /** Default request timeout in ms (default 60_000). Per-call override available\n   *  via `chat.completions.create({ timeoutMs })` and `embeddings.create({ timeoutMs })`. */\n  timeoutMs?: number;\n}\n\nexport class BuilderforceClient {\n  public readonly chat: {\n    completions: ChatCompletionsApi;\n  };\n  public readonly embeddings: EmbeddingsApi;\n  public readonly models: ModelsApi;\n  public readonly usage: UsageApi;\n\n  constructor(options: BuilderforceClientOptions) {\n    const apiKey = options.apiKey?.trim();\n    if (!apiKey) {\n      throw new BuilderforceApiError(\n        'BuilderforceClient requires a non-empty apiKey',\n        400,\n        'missing_api_key',\n      );\n    }\n\n    const http = new HttpClient({\n      apiKey,\n      baseUrl: options.baseUrl ?? 'https://api.builderforce.ai',\n      fetchFn: options.fetch,\n      timeoutMs: options.timeoutMs,\n    });\n\n    this.chat = {\n      completions: new ChatCompletionsApi(http),\n    };\n    this.embeddings = new EmbeddingsApi(http);\n    this.models = new ModelsApi(http);\n    this.usage = new UsageApi(http);\n  }\n}\n"],"mappings":"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","names":["splitTransportOptions"]}
+{"version":3,"sources":["../src/infrastructure/sse.ts","../src/application/ChatCompletionsApi.ts","../src/application/EmbeddingsApi.ts","../src/application/ModelsApi.ts","../src/application/UsageApi.ts","../src/infrastructure/httpClient.ts","../src/BuilderforceClient.ts"],"sourcesContent":["export async function* parseSseJson<T>(\n  stream: ReadableStream<Uint8Array>,\n): AsyncGenerator<T, void, unknown> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  let buffer = '';\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n\n    buffer += decoder.decode(value, { stream: true });\n    const lines = buffer.split('\\n');\n    buffer = lines.pop() ?? '';\n\n    for (const line of lines) {\n      const trimmed = line.trim();\n      if (!trimmed.startsWith('data: ')) continue;\n\n      const data = trimmed.slice(6).trim();\n      if (data === '[DONE]') return;\n\n      try {\n        yield JSON.parse(data) as T;\n      } catch {\n        // Skip malformed chunks instead of breaking the stream.\n      }\n    }\n  }\n}\n","import type { ChatCompletionChunk, ChatCompletionCreateParams, ChatCompletionResponse } from '../domain/types';\nimport { HttpClient, type RequestOptions } from '../infrastructure/httpClient';\nimport { parseSseJson } from '../infrastructure/sse';\n\nexport class ChatCompletionStream implements AsyncIterable<ChatCompletionChunk> {\n  private readonly stream: ReadableStream<Uint8Array>;\n\n  constructor(stream: ReadableStream<Uint8Array>) {\n    this.stream = stream;\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<ChatCompletionChunk, void, unknown> {\n    return parseSseJson<ChatCompletionChunk>(this.stream);\n  }\n\n  async toText(): Promise<string> {\n    let full = '';\n    for await (const chunk of this) {\n      const delta = chunk.choices?.[0]?.delta?.content;\n      if (typeof delta === 'string') {\n        full += delta;\n      }\n    }\n    return full;\n  }\n}\n\n/**\n * Pull SDK-level transport options (timeout, signal, idempotency key) out of\n * the params object so they don't get JSON-serialized into the request body.\n * Returns the request options AND the cleaned-up body.\n */\nfunction splitTransportOptions(params: ChatCompletionCreateParams): {\n  body: Record<string, unknown>;\n  request: RequestOptions;\n} {\n  const { timeoutMs, signal, idempotencyKey, ...rest } = params;\n  const headers: Record<string, string> = {};\n  if (idempotencyKey) headers['Idempotency-Key'] = idempotencyKey;\n  return {\n    body: rest as unknown as Record<string, unknown>,\n    request: {\n      timeoutMs,\n      signal,\n      ...(Object.keys(headers).length > 0 ? { headers } : {}),\n    },\n  };\n}\n\nexport class ChatCompletionsApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  async create(params: ChatCompletionCreateParams & { stream: true }): Promise<ChatCompletionStream>;\n  async create(params: ChatCompletionCreateParams & { stream?: false | undefined }): Promise<ChatCompletionResponse>;\n  async create(\n    params: ChatCompletionCreateParams,\n  ): Promise<ChatCompletionResponse | ChatCompletionStream> {\n    const { body, request } = splitTransportOptions(params);\n\n    if (params.stream) {\n      const response = await this.http.postRaw('/llm/v1/chat/completions', body, request);\n      if (!response.body) {\n        throw new Error('Streaming response body is missing');\n      }\n      return new ChatCompletionStream(response.body);\n    }\n\n    return this.http.postJson<ChatCompletionResponse>('/llm/v1/chat/completions', body, request);\n  }\n}\n","import type { EmbeddingsCreateParams, EmbeddingsResponse } from '../domain/types';\nimport { HttpClient, type RequestOptions } from '../infrastructure/httpClient';\n\n/**\n * Pull SDK-level transport options out of the params so they don't ride\n * along inside the JSON body. Same shape as ChatCompletionsApi (DRY pattern).\n */\nfunction splitTransportOptions(params: EmbeddingsCreateParams): {\n  body: Record<string, unknown>;\n  request: RequestOptions;\n} {\n  const { timeoutMs, signal, idempotencyKey, ...rest } = params;\n  const headers: Record<string, string> = {};\n  if (idempotencyKey) headers['Idempotency-Key'] = idempotencyKey;\n  return {\n    body: rest as unknown as Record<string, unknown>,\n    request: {\n      timeoutMs,\n      signal,\n      ...(Object.keys(headers).length > 0 ? { headers } : {}),\n    },\n  };\n}\n\nexport class EmbeddingsApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  /**\n   * Create one or more text embeddings. Wired to OpenRouter (default model\n   * `nvidia/llama-nemotron-embed-vl-1b-v2:free`). Override via `model`.\n   */\n  create(params: EmbeddingsCreateParams): Promise<EmbeddingsResponse> {\n    const { body, request } = splitTransportOptions(params);\n    return this.http.postJson<EmbeddingsResponse>('/llm/v1/embeddings', body, request);\n  }\n}\n","import type { ModelsListResponse } from '../domain/types';\nimport { HttpClient } from '../infrastructure/httpClient';\n\nexport class ModelsApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  list(): Promise<ModelsListResponse> {\n    return this.http.getJson<ModelsListResponse>('/llm/v1/models');\n  }\n}\n","import type { UsageGetParams, UsageResponse } from '../domain/types';\nimport { HttpClient } from '../infrastructure/httpClient';\n\nexport class UsageApi {\n  private readonly http: HttpClient;\n\n  constructor(http: HttpClient) {\n    this.http = http;\n  }\n\n  get(params: UsageGetParams = {}): Promise<UsageResponse> {\n    const query = typeof params.days === 'number' ? `?days=${encodeURIComponent(String(params.days))}` : '';\n    return this.http.getJson<UsageResponse>(`/llm/v1/usage${query}`);\n  }\n}\n","import type { FailoverEvent } from '../domain/types';\n\nexport class BuilderforceApiError extends Error {\n  public readonly status: number;\n  public readonly code?: string;\n  public readonly details?: unknown;\n  public readonly requestId?: string;\n  /**\n   * `true` when the gateway has signalled this error will not resolve by\n   * retrying on a different model — e.g. plan or per-claw daily token cap\n   * exhausted (those caps are per-tenant, not per-model). Consumer-side\n   * fallback chains should short-circuit when this is set.\n   */\n  public readonly terminal?: boolean;\n  /** Seconds the consumer should wait before retrying — server-supplied. */\n  public readonly retryAfter?: number;\n  /**\n   * Cascade attempts that failed before this error was returned — populated\n   * when the gateway returns `429 cascade_exhausted` with a `details.failovers`\n   * array. Each entry includes the vendor that owns the model so callers can\n   * detect single-vendor saturation (e.g. all attempts on `openrouter`).\n   */\n  public readonly failovers?: FailoverEvent[];\n\n  constructor(\n    message: string,\n    status: number,\n    code?: string,\n    details?: unknown,\n    requestId?: string,\n    extras?: { terminal?: boolean; retryAfter?: number },\n  ) {\n    super(message);\n    this.name = 'BuilderforceApiError';\n    this.status = status;\n    this.code = code;\n    this.details = details;\n    this.requestId = requestId;\n    this.terminal = extras?.terminal;\n    this.retryAfter = extras?.retryAfter;\n    // Pull typed failovers out of `details.failovers` when the gateway\n    // supplied them. Validation is light — drop entries missing required\n    // fields so consumers never get a partially-populated row.\n    if (details && typeof details === 'object') {\n      const f = (details as { failovers?: unknown }).failovers;\n      if (Array.isArray(f)) {\n        const cleaned: FailoverEvent[] = [];\n        for (const entry of f) {\n          if (entry && typeof entry === 'object') {\n            const e = entry as { model?: unknown; vendor?: unknown; code?: unknown };\n            if (typeof e.model === 'string' && typeof e.vendor === 'string' && typeof e.code === 'number') {\n              cleaned.push({ model: e.model, vendor: e.vendor, code: e.code });\n            }\n          }\n        }\n        if (cleaned.length > 0) this.failovers = cleaned;\n      }\n    }\n  }\n}\n\nexport interface HttpClientOptions {\n  apiKey: string;\n  baseUrl: string;\n  fetchFn?: typeof fetch;\n  /** Default per-request timeout in ms. Overridable per call. */\n  timeoutMs?: number;\n}\n\n/** Per-request overrides — passed by the API layer, not by SDK consumers directly. */\nexport interface RequestOptions {\n  /** Override the client default timeout for just this request. */\n  timeoutMs?: number;\n  /** Caller-provided AbortSignal. Linked together with the SDK's internal timeout\n   *  signal — whichever fires first aborts the request. */\n  signal?: AbortSignal;\n  /** Extra headers to merge in (e.g. `Idempotency-Key`). */\n  headers?: Record<string, string>;\n}\n\nexport class HttpClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchFn: typeof fetch;\n  private readonly defaultTimeoutMs: number;\n\n  constructor(options: HttpClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl.replace(/\\/$/, '');\n    // Bind to `globalThis` so calling via `this.fetchFn(...)` doesn't trip\n    // Cloudflare Workers' \"Illegal invocation\" check — the platform's fetch\n    // requires the global receiver, not an instance method `this`. Affects\n    // any environment that ships a strict-receiver fetch (Workers, Bun, etc.)\n    // and is harmless on Node + browsers.\n    const fetchImpl = options.fetchFn ?? fetch;\n    this.fetchFn = fetchImpl.bind(globalThis);\n    this.defaultTimeoutMs = options.timeoutMs ?? 60_000;\n  }\n\n  async getJson<T>(path: string, options?: RequestOptions): Promise<T> {\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\n      method: 'GET',\n      headers: this.mergeHeaders(options),\n    }, options);\n    return this.parseJsonResponse<T>(res);\n  }\n\n  async postJson<T>(path: string, body: unknown, options?: RequestOptions): Promise<T> {\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\n      method: 'POST',\n      headers: this.mergeHeaders(options, { 'Content-Type': 'application/json' }),\n      body: JSON.stringify(body),\n    }, options);\n    return this.parseJsonResponse<T>(res);\n  }\n\n  async postRaw(path: string, body: unknown, options?: RequestOptions): Promise<Response> {\n    const res = await this.fetchWithTimeout(`${this.baseUrl}${path}`, {\n      method: 'POST',\n      headers: this.mergeHeaders(options, { 'Content-Type': 'application/json' }),\n      body: JSON.stringify(body),\n    }, options);\n    if (!res.ok) {\n      throw await this.toApiError(res);\n    }\n    return res;\n  }\n\n  private mergeHeaders(options?: RequestOptions, base?: Record<string, string>): Record<string, string> {\n    return {\n      Authorization: `Bearer ${this.apiKey}`,\n      ...(base ?? {}),\n      ...(options?.headers ?? {}),\n    };\n  }\n\n  /**\n   * Wrap a fetch in a combined abort signal: an internal timeout AND any\n   * caller-provided signal. Either firing aborts the request. Single source of\n   * abort plumbing — every method routes through here (DRY).\n   */\n  private async fetchWithTimeout(\n    input: RequestInfo | URL,\n    init: RequestInit,\n    options?: RequestOptions,\n  ): Promise<Response> {\n    const timeoutMs = options?.timeoutMs ?? this.defaultTimeoutMs;\n    const timeoutCtl = new AbortController();\n    const timer = setTimeout(() => timeoutCtl.abort(), timeoutMs);\n\n    // Combine internal timeout signal + caller signal. Native AbortSignal.any\n    // (Node 20+ / modern Workers) is preferred; fall back to manual linking.\n    const signal = combineSignals(timeoutCtl.signal, options?.signal);\n\n    try {\n      return await this.fetchFn(input, { ...init, signal });\n    } catch (error) {\n      if (timeoutCtl.signal.aborted) {\n        throw new BuilderforceApiError(`Request timed out after ${timeoutMs}ms`, 408, 'timeout');\n      }\n      if (options?.signal?.aborted) {\n        throw new BuilderforceApiError('Request aborted by caller', 499, 'aborted');\n      }\n      throw error;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  private async parseJsonResponse<T>(res: Response): Promise<T> {\n    if (!res.ok) {\n      throw await this.toApiError(res);\n    }\n    return res.json() as Promise<T>;\n  }\n\n  private async toApiError(res: Response): Promise<BuilderforceApiError> {\n    const fallback = `Request failed (${res.status})`;\n    const requestId = res.headers.get('x-request-id') ?? undefined;\n\n    // Prefer server-supplied `Retry-After` header (seconds) when present; the\n    // body's `retryAfter` is a fallback for environments that strip headers.\n    const headerRetryAfter = parsePositiveInt(res.headers.get('retry-after'));\n\n    try {\n      const payload = await res.json() as Record<string, unknown> | null;\n\n      // Two envelope shapes are in the wild:\n      //\n      //   Flat   — { error: \"msg\", code, details, terminal?, retryAfter? }\n      //            (gateway's documented shape — plan_token_limit_exceeded etc.)\n      //   Nested — { success: false, error: { code, message, details } }\n      //            (consumer-side wrappers around the gateway, e.g. some\n      //             tenant proxies emit AI_RATE_LIMITED / AI_UNAVAILABLE\n      //             envelopes that re-wrap the upstream error)\n      //\n      // Detect via the `success: false` discriminator and unwrap when nested\n      // so `error.code` / `error.message` / `error.details` always populate.\n      const isNested =\n        payload !== null\n        && typeof payload === 'object'\n        && payload.success === false\n        && typeof payload.error === 'object'\n        && payload.error !== null;\n\n      const inner = (isNested ? payload.error : payload) as {\n        error?:      string;\n        message?:    string;\n        code?:       string;\n        details?:    unknown;\n        terminal?:   boolean;\n        retryAfter?: number;\n      } | null;\n\n      const message =\n        (typeof inner?.message === 'string' && inner.message)\n        || (typeof inner?.error === 'string' && inner.error)\n        || fallback;\n\n      return new BuilderforceApiError(\n        message,\n        res.status,\n        inner?.code,\n        inner?.details,\n        requestId,\n        {\n          terminal:   inner?.terminal,\n          retryAfter: headerRetryAfter ?? inner?.retryAfter,\n        },\n      );\n    } catch {\n      const text = await res.text().catch(() => '');\n      return new BuilderforceApiError(\n        text || fallback,\n        res.status,\n        undefined,\n        undefined,\n        requestId,\n        headerRetryAfter !== undefined ? { retryAfter: headerRetryAfter } : undefined,\n      );\n    }\n  }\n}\n\nfunction parsePositiveInt(s: string | null): number | undefined {\n  if (s == null) return undefined;\n  const n = Number(s);\n  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : undefined;\n}\n\n/**\n * Combine multiple AbortSignals into one. Uses native `AbortSignal.any` when\n * available (Node 20+, modern Workers); falls back to manual event linking.\n */\nfunction combineSignals(...signals: Array<AbortSignal | undefined>): AbortSignal {\n  const live = signals.filter((s): s is AbortSignal => s !== undefined);\n  if (live.length === 1) return live[0]!;\n\n  const anyImpl = (AbortSignal as unknown as { any?: (signals: AbortSignal[]) => AbortSignal }).any;\n  if (typeof anyImpl === 'function') {\n    return anyImpl(live);\n  }\n\n  const ctl = new AbortController();\n  for (const s of live) {\n    if (s.aborted) { ctl.abort(s.reason); break; }\n    s.addEventListener('abort', () => ctl.abort(s.reason), { once: true });\n  }\n  return ctl.signal;\n}\n","import { ChatCompletionsApi } from './application/ChatCompletionsApi';\nimport { EmbeddingsApi } from './application/EmbeddingsApi';\nimport { ModelsApi } from './application/ModelsApi';\nimport { UsageApi } from './application/UsageApi';\nimport { BuilderforceApiError, HttpClient } from './infrastructure/httpClient';\n\nexport interface BuilderforceClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof fetch;\n  /** Default request timeout in ms (default 60_000). Per-call override available\n   *  via `chat.completions.create({ timeoutMs })` and `embeddings.create({ timeoutMs })`. */\n  timeoutMs?: number;\n}\n\nexport class BuilderforceClient {\n  public readonly chat: {\n    completions: ChatCompletionsApi;\n  };\n  public readonly embeddings: EmbeddingsApi;\n  public readonly models: ModelsApi;\n  public readonly usage: UsageApi;\n\n  constructor(options: BuilderforceClientOptions) {\n    const apiKey = options.apiKey?.trim();\n    if (!apiKey) {\n      throw new BuilderforceApiError(\n        'BuilderforceClient requires a non-empty apiKey',\n        400,\n        'missing_api_key',\n      );\n    }\n\n    const http = new HttpClient({\n      apiKey,\n      baseUrl: options.baseUrl ?? 'https://api.builderforce.ai',\n      fetchFn: options.fetch,\n      timeoutMs: options.timeoutMs,\n    });\n\n    this.chat = {\n      completions: new ChatCompletionsApi(http),\n    };\n    this.embeddings = new EmbeddingsApi(http);\n    this.models = new ModelsApi(http);\n    this.usage = new UsageApi(http);\n  }\n}\n"],"mappings":"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","names":["splitTransportOptions"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seanhogg/builderforce-sdk",
-  "version": "0.5.2",
+  "version": "0.7.0",
   "description": "Typed SDK for the Builderforce.ai LLM gateway — chat completions with tool-calling and structured output, embeddings, models, and usage analytics over an OpenAI-compatible surface.",
   "license": "MIT",
   "author": "Sean Hogg",