@typesafe-ai/sdk 0.0.0-bootstrap.0 → 0.5.7

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/api-promise.ts","../src/env.ts","../src/retry.ts","../src/errors.ts","../src/logging.ts","../src/questions.ts","../src/resources/models.ts","../src/runtime.ts","../src/version.ts","../src/client.ts"],"sourcesContent":["export const REQUEST_ID_HEADER = \"x-typesafe-request-id\";\n\nexport const requestIdFrom = (headers: Headers): string | undefined =>\n  headers.get(REQUEST_ID_HEADER) ?? undefined;\n\n/** Parsed data with its HTTP response and request ID. */\nexport interface WithResponse<T> {\n  /** The parsed response body. */\n  data: T;\n  /** The HTTP response, with its body consumed by parsing. */\n  response: Response;\n  /** Request ID from `x-typesafe-request-id`, or `undefined` when absent. */\n  requestId: string | undefined;\n}\n\n/**\n * A promise for the parsed result with access to the HTTP response.\n *\n * Non-2xx responses reject with an `APIError`, including through `asResponse()`.\n */\nexport class APIPromise<T> extends Promise<T> {\n  readonly #responsePromise: Promise<Response>;\n  readonly #parseResponse: (response: Response) => Promise<T>;\n  #parsed: Promise<T> | undefined;\n\n  constructor(\n    responsePromise: Promise<Response>,\n    parseResponse: (response: Response) => Promise<T>,\n  ) {\n    // The inherited promise is never used; all consumers go through `parse()`.\n    super((resolve) => resolve(undefined as T));\n    this.#responsePromise = responsePromise;\n    this.#parseResponse = parseResponse;\n  }\n\n  /**\n   * Resolves to the raw `Response` without parsing the body. SDK requests buffer the full\n   * body under the request timeout before handoff; reading it afterwards is caller-owned.\n   * The caller owns the body; don't also `await` the parsed result on the same promise.\n   */\n  asResponse(): Promise<Response> {\n    return this.#responsePromise;\n  }\n\n  /** Return the parsed result, HTTP response, and request ID. */\n  async withResponse(): Promise<WithResponse<T>> {\n    const [data, response] = await Promise.all([this.#parse(), this.#responsePromise]);\n    return { data, response, requestId: requestIdFrom(response.headers) };\n  }\n\n  /** Transform the parsed result, sharing the HTTP response and a single body parse. */\n  map<U>(fn: (data: T) => U): APIPromise<U> {\n    return new APIPromise<U>(this.#responsePromise, () => this.#parse().then(fn));\n  }\n\n  #parse(): Promise<T> {\n    this.#parsed ??= this.#responsePromise.then(this.#parseResponse);\n    return this.#parsed;\n  }\n\n  // biome-ignore lint/suspicious/noThenProperty: this is a Promise subclass; overriding then is the point\n  override then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,\n  ): Promise<TResult1 | TResult2> {\n    return this.#parse().then(onfulfilled, onrejected);\n  }\n\n  override catch<TResult = never>(\n    onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null,\n  ): Promise<T | TResult> {\n    return this.#parse().catch(onrejected);\n  }\n\n  override finally(onfinally?: (() => void) | null): Promise<T> {\n    return this.#parse().finally(onfinally);\n  }\n}\n","/** Environment variable names for client configuration. Explicit options take precedence. */\nexport const ENV = {\n  /** Required API key; used when `apiKey` is omitted. */\n  apiKey: \"TYPESAFE_API_KEY\",\n  /** API root; defaults to `https://api.typesafe.ai`. */\n  baseURL: \"TYPESAFE_BASE_URL\",\n  /** Default model name; defaults to `jev-latest`. */\n  defaultModel: \"TYPESAFE_DEFAULT_MODEL\",\n  /** Log level; defaults to `warn`. */\n  logLevel: \"TYPESAFE_LOG_LEVEL\",\n} as const;\n\nexport type EnvVar = (typeof ENV)[keyof typeof ENV];\n\n/** Read a trimmed environment value, returning `undefined` for missing or blank values. */\nexport const readEnv = (name: EnvVar): string | undefined => {\n  if (typeof process === \"undefined\" || !process.env) return undefined;\n  return process.env[name]?.trim() || undefined;\n};\n\n/** Return the explicit value, falling back to the environment. */\nexport const fromCodeOrEnv = (fromCode: string | undefined, envVar: EnvVar): string | undefined =>\n  fromCode ?? readEnv(envVar);\n","/** Retry defaults, delay calculation, and cancellable waits. */\n\nimport type { RetryPolicy } from \"./types\";\n\nexport const DEFAULT_TIMEOUT_MS = 10_000;\n\nconst range = (from: number, to: number): number[] =>\n  Array.from({ length: to - from }, (_, i) => from + i);\n\n/** Default SDK retry policy. */\nexport const DEFAULT_RETRY_POLICY: RetryPolicy = {\n  maxRetries: 2,\n  backoffInitialMs: 500,\n  backoffMaxMs: 5_000,\n  backoffJitter: 0.25,\n  /** HTTP 408, 429, and 5xx responses. */\n  httpStatuses: new Set([408, 429, ...range(500, 600)]),\n  respectRetryAfter: true,\n  /** Maximum server retry delay before falling back to backoff. */\n  maxRetryAfterMs: 60_000,\n  apiConnectionError: true,\n  apiTimeoutError: true,\n};\n\nexport const DEFAULT_MAX_RETRIES: number = DEFAULT_RETRY_POLICY.maxRetries;\n\n/** Whether the policy retries an HTTP status code. */\nexport const isRetryableStatus = (\n  status: number,\n  policy: RetryPolicy = DEFAULT_RETRY_POLICY,\n): boolean => policy.httpStatuses.has(status);\n\n/**\n * Parse `retry-after-ms` or `Retry-After` into milliseconds, preferring `retry-after-ms`.\n *\n * Return `undefined` when neither header contains a valid delay.\n */\nexport const parseRetryAfter = (headers: Headers, now: number = Date.now()): number | undefined => {\n  const ms = Number(headers.get(\"retry-after-ms\"));\n  if (headers.has(\"retry-after-ms\") && Number.isFinite(ms) && ms >= 0) return ms;\n\n  const raw = headers.get(\"retry-after\");\n  if (raw === null) return undefined;\n  const seconds = Number(raw);\n  if (Number.isFinite(seconds)) return seconds >= 0 ? seconds * 1000 : undefined;\n  const date = Date.parse(raw);\n  if (!Number.isNaN(date)) return Math.max(0, date - now);\n  return undefined;\n};\n\n/**\n * Calculate the delay in milliseconds for a zero-based retry attempt.\n *\n * Use an allowed server delay; otherwise use capped exponential backoff with jitter.\n */\nexport const retryDelayMs = (\n  attempt: number,\n  headers?: Headers,\n  policy: RetryPolicy = DEFAULT_RETRY_POLICY,\n  random: () => number = Math.random,\n): number => {\n  if (policy.respectRetryAfter && headers !== undefined) {\n    const retryAfter = parseRetryAfter(headers);\n    if (retryAfter !== undefined && retryAfter <= policy.maxRetryAfterMs) return retryAfter;\n  }\n  const exponential = Math.min(policy.backoffInitialMs * 2 ** attempt, policy.backoffMaxMs);\n  return Math.round(exponential * (1 - random() * policy.backoffJitter));\n};\n\n/** Wait `ms` milliseconds, rejecting with `signal.reason` on cancellation. */\nexport const sleep = (ms: number, signal?: AbortSignal): Promise<void> =>\n  new Promise((resolve, reject) => {\n    if (signal?.aborted) return reject(signal.reason);\n    const onAbort = (): void => {\n      clearTimeout(timer);\n      reject(signal?.reason);\n    };\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n","import { requestIdFrom } from \"./api-promise\";\nimport { parseRetryAfter } from \"./retry\";\n\n/** Base class for SDK errors. */\nexport class TypeSafeError extends Error {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = new.target.name;\n  }\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null;\n\n/** Extract a message from a text, error, or validation response body. */\nconst extractMessage = (body: unknown): string | undefined => {\n  if (typeof body === \"string\") return body || undefined;\n  if (!isRecord(body)) return undefined;\n  const { error, message, detail } = body;\n  if (typeof error === \"string\") return error;\n  if (isRecord(error) && typeof error.message === \"string\") return error.message;\n  if (typeof message === \"string\") return message;\n  if (typeof detail === \"string\") return detail;\n  if (isRecord(detail) && typeof detail.message === \"string\") return detail.message;\n  if (Array.isArray(detail)) return describeValidationErrors(detail);\n  return undefined;\n};\n\n/** Format validation errors as semicolon-separated `path: message` entries. */\nconst describeValidationErrors = (errors: unknown[]): string | undefined => {\n  const parts = errors.flatMap((e) => {\n    if (!isRecord(e) || typeof e.msg !== \"string\") return [];\n    const loc = Array.isArray(e.loc) ? e.loc.filter((x) => x !== \"body\").join(\".\") : \"\";\n    return [loc ? `${loc}: ${e.msg}` : e.msg];\n  });\n  return parts.length > 0 ? parts.join(\"; \") : undefined;\n};\n\nconst MAX_RAW_BODY_IN_MESSAGE = 200;\n\n/** An unsuccessful HTTP response from the API. */\nexport class APIError extends TypeSafeError {\n  /** HTTP response status code. */\n  readonly status: number;\n  /** HTTP response headers. */\n  readonly headers: Headers;\n  /** Parsed JSON, response text, or `undefined` for an empty body. */\n  readonly body: unknown;\n  /** Request ID from `x-typesafe-request-id`, or `undefined` when absent. */\n  readonly requestId: string | undefined;\n\n  constructor(status: number, body: unknown, headers: Headers, message?: string) {\n    super(message ?? APIError.describe(status, body));\n    this.status = status;\n    this.body = body;\n    this.headers = headers;\n    this.requestId = requestIdFrom(headers);\n  }\n\n  private static describe(status: number, body: unknown): string {\n    const detail = extractMessage(body);\n    if (detail) return `${status} ${detail}`;\n    if (body === undefined) return `${status} status code (no body)`;\n    const raw = typeof body === \"string\" ? body : JSON.stringify(body);\n    return `${status} ${raw.length > MAX_RAW_BODY_IN_MESSAGE ? `${raw.slice(0, MAX_RAW_BODY_IN_MESSAGE)}…` : raw}`;\n  }\n\n  /** Create the error subclass for an HTTP status code. */\n  static fromResponse(status: number, body: unknown, headers: Headers): APIError {\n    if (status === 400) return new BadRequestError(status, body, headers);\n    if (status === 401) return new AuthenticationError(status, body, headers);\n    if (status === 403) return new PermissionDeniedError(status, body, headers);\n    if (status === 404) return new NotFoundError(status, body, headers);\n    if (status === 422) return new UnprocessableEntityError(status, body, headers);\n    if (status === 429) return new RateLimitError(status, body, headers);\n    if (status >= 500) return new InternalServerError(status, body, headers);\n    return new APIError(status, body, headers);\n  }\n}\n\n/** HTTP 400: the request is invalid. */\nexport class BadRequestError extends APIError {}\n/** HTTP 401: authentication failed. */\nexport class AuthenticationError extends APIError {}\n/** HTTP 403: access is denied. */\nexport class PermissionDeniedError extends APIError {}\n/** HTTP 404: the resource was not found. */\nexport class NotFoundError extends APIError {}\n/** HTTP 422: request validation failed. */\nexport class UnprocessableEntityError extends APIError {}\n/** HTTP 429: the rate limit was exceeded. */\nexport class RateLimitError extends APIError {\n  /** Server retry delay in milliseconds, or `undefined` when absent or invalid. */\n  readonly retryAfterMs: number | undefined = parseRetryAfter(this.headers);\n}\n/** HTTP 5xx: the server failed to handle the request. */\nexport class InternalServerError extends APIError {}\n\n/** The request or response-body delivery failed (DNS, TLS, connection closed, etc.). */\nexport class APIConnectionError extends TypeSafeError {\n  constructor(message = \"Connection error.\", options?: ErrorOptions) {\n    super(message, options);\n  }\n}\n\n/** The full response did not arrive within the timeout. A kind of `APIConnectionError`. */\nexport class APITimeoutError extends APIConnectionError {\n  /** Configured timeout in milliseconds. */\n  readonly timeoutMs: number;\n\n  constructor(timeoutMs: number, options?: ErrorOptions) {\n    super(`Request timed out after ${timeoutMs}ms.`, options);\n    this.timeoutMs = timeoutMs;\n  }\n}\n\n/** The caller cancelled the request through an `AbortSignal`. */\nexport class APIUserAbortError extends TypeSafeError {\n  constructor(message = \"Request was aborted.\", options?: ErrorOptions) {\n    super(message, options);\n  }\n}\n","import { TypeSafeError } from \"./errors\";\nimport type { Logger, LogLevel } from \"./types\";\n\n/** Supported log levels, from most to least verbose. */\nexport const LOG_LEVELS: readonly LogLevel[] = [\"debug\", \"info\", \"warn\", \"error\", \"off\"];\n\nexport const DEFAULT_LOG_LEVEL: LogLevel = \"warn\";\n\nconst isLogLevel = (value: string): value is LogLevel =>\n  (LOG_LEVELS as readonly string[]).includes(value);\n\n/** Validate a configured log level, throwing `TypeSafeError` for unknown values. */\nexport const parseLogLevel = (value: string, source: string): LogLevel => {\n  if (isLogLevel(value)) return value;\n  throw new TypeSafeError(\n    `Invalid log level \"${value}\" from ${source}. Expected one of: ${LOG_LEVELS.join(\", \")}.`,\n  );\n};\n\n// ---------------------------------------------------------------------------\n// Loggers\n// ---------------------------------------------------------------------------\n\nconst PREFIX = \"[typesafe-sdk]\";\n\n/** Default console logger with the `[typesafe-sdk]` prefix. */\nexport const consoleLogger: Logger = {\n  debug: (message, ...args) => console.debug(`${PREFIX} ${message}`, ...args),\n  info: (message, ...args) => console.info(`${PREFIX} ${message}`, ...args),\n  warn: (message, ...args) => console.warn(`${PREFIX} ${message}`, ...args),\n  error: (message, ...args) => console.error(`${PREFIX} ${message}`, ...args),\n};\n\nconst RANK: Record<LogLevel, number> = { debug: 0, info: 1, warn: 2, error: 3, off: 4 };\n\nconst drop = (): void => {};\n\n/** Filter logger calls to the configured level and above. */\nexport const withLevel = (sink: Logger, level: LogLevel): Logger => {\n  const enabled = (at: LogLevel): boolean => RANK[at] >= RANK[level];\n  return {\n    debug: enabled(\"debug\") ? (message, ...args) => sink.debug(message, ...args) : drop,\n    info: enabled(\"info\") ? (message, ...args) => sink.info(message, ...args) : drop,\n    warn: enabled(\"warn\") ? (message, ...args) => sink.warn(message, ...args) : drop,\n    error: enabled(\"error\") ? (message, ...args) => sink.error(message, ...args) : drop,\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Redaction\n// ---------------------------------------------------------------------------\n\n/** Credential headers that retain a key suffix for identification. */\nconst KEY_HEADERS: ReadonlySet<string> = new Set([\n  \"authorization\",\n  \"proxy-authorization\",\n  \"x-api-key\",\n]);\n\n/** Headers whose values are redacted in full. */\nconst OPAQUE_HEADERS: ReadonlySet<string> = new Set([\"cookie\", \"set-cookie\"]);\n\n/** Mask a key, preserving its scheme and the last four characters of secrets longer than eight. */\nconst redactKey = (value: string): string => {\n  const [scheme, secret] = value.includes(\" \") ? value.split(/\\s+/, 2) : [undefined, value];\n  const tail = secret && secret.length > 8 ? secret.slice(-4) : \"\";\n  return `${scheme ? `${scheme} ` : \"\"}***${tail}`;\n};\n\nconst redact = (name: string, value: string): string => {\n  const lower = name.toLowerCase();\n  if (KEY_HEADERS.has(lower)) return redactKey(value);\n  if (OPAQUE_HEADERS.has(lower)) return \"***\";\n  return value;\n};\n\n/** Copy headers with known credential values redacted. */\nexport const redactHeaders = (headers: Record<string, string>): Record<string, string> =>\n  Object.fromEntries(Object.entries(headers).map(([name, value]) => [name, redact(name, value)]));\n","import { TypeSafeError } from \"./errors\";\nimport type {\n  ChoiceCriteria,\n  ChoiceQuestion,\n  EntryType,\n  NoulQuestion,\n  Questions,\n  ScoreCriteria,\n  ScoreList,\n  ScoreMap,\n  ScoreQuestion,\n} from \"./types\";\n\n// ---------------------------------------------------------------------------\n// Builders\n// ---------------------------------------------------------------------------\n\n/**\n * Create a yes/no question with optional descriptions for either outcome.\n *\n * @param instructions - The question as text, a JSON object or array; defaults to `null`.\n * @param criteria - Optional descriptions of the yes and no outcomes.\n */\nexport const noul = (\n  instructions: EntryType = null,\n  criteria?: NoulQuestion[\"criteria\"],\n): NoulQuestion => ({\n  type: \"noul\",\n  instructions,\n  criteria,\n});\n\n/**\n * Create a score question using an ordered rubric.\n *\n * @param instructions - The question as text, a JSON object or array, or `null`.\n * @param criteria - A nonempty array or map indexed from zero with no gaps; descriptions may be `null`.\n */\nexport const score = <const T extends ScoreCriteria>(\n  instructions: EntryType,\n  criteria: T,\n): ScoreQuestion<T> => ({\n  type: \"score\",\n  instructions,\n  criteria,\n});\n\n/**\n * Create a question that selects between named alternatives.\n *\n * @param instructions - The question as text, a JSON object or array, or `null`.\n * @param criteria - Labels mapped to descriptions, or `null` for undescribed labels.\n */\nexport const choice = <const T extends ChoiceCriteria>(\n  instructions: EntryType,\n  criteria: T,\n): ChoiceQuestion<T> => {\n  if (Array.isArray(criteria)) {\n    throw new TypeSafeError(\"Choice criteria must be a map of labels to descriptions, not a list.\");\n  }\n  return { type: \"choice\", instructions, criteria };\n};\n\n// ---------------------------------------------------------------------------\n// Wire normalization\n// ---------------------------------------------------------------------------\n\nconst isScoreList = (criteria: ScoreCriteria): criteria is ScoreList => Array.isArray(criteria);\n\n/** Validate score keys and convert the map to a nonempty array indexed from zero. */\nexport const scoreMapToList = (map: ScoreMap, name: string): ScoreList => {\n  const keys = Object.keys(map)\n    .map((key) => {\n      const n = Number(key);\n      if (!Number.isInteger(n) || n < 0) {\n        throw new TypeSafeError(\n          `Score question \"${name}\" has criteria key \"${key}\"; keys must be non-negative integers.`,\n        );\n      }\n      return n;\n    })\n    .sort((a, b) => a - b);\n  if (keys.length === 0) throw noScores(name);\n\n  const expected = keys.map((_, i) => i);\n  if (keys.some((k, i) => k !== expected[i])) {\n    throw new TypeSafeError(\n      `Score question \"${name}\" defines scores ${keys.join(\", \")}, but scores must run from 0 ` +\n        `with no gaps (expected ${expected.join(\", \")}).`,\n    );\n  }\n  return keys.map((k) => map[k]) as unknown as ScoreList;\n};\n\nconst noScores = (name: string): TypeSafeError =>\n  new TypeSafeError(`Score question \"${name}\" has no criteria; at least one score is required.`);\n\n/** Validate nonempty questions and score criteria, converting score maps to arrays. */\nexport const toWireQuestions = <Q extends Questions>(questions: Q): Q => {\n  if (Object.keys(questions).length === 0) {\n    throw new TypeSafeError(\"At least one question is required.\");\n  }\n  let changed = false;\n  const wire: Questions = Object.create(null);\n  for (const [name, question] of Object.entries(questions)) {\n    if (question.type !== \"score\") {\n      wire[name] = question;\n    } else if (isScoreList(question.criteria)) {\n      if (question.criteria.length === 0) throw noScores(name);\n      wire[name] = question;\n    } else {\n      wire[name] = { ...question, criteria: scoreMapToList(question.criteria, name) };\n      changed = true;\n    }\n  }\n  return changed ? (wire as Q) : questions;\n};\n","import type { APIPromise } from \"../api-promise\";\nimport type { Transport } from \"../client\";\nimport { TypeSafeError } from \"../errors\";\nimport type { ModelCard, RequestOptions } from \"../types\";\n\n/** Access to the Models API resource. */\nexport class Models {\n  readonly #transport: Transport;\n\n  constructor(transport: Transport) {\n    this.#transport = transport;\n  }\n\n  /** List the models available to the account. */\n  list(options: RequestOptions = {}): APIPromise<ModelCard[]> {\n    return this.#transport.request<ModelsWire>(\"GET\", \"/v1/models\", options).map(unwrapModels);\n  }\n}\n\n/** Model list response from `GET /v1/models`. */\ntype ModelsWire = { models: ModelCard[] };\n\nconst unwrapModels = (wire: ModelsWire): ModelCard[] => {\n  if (Array.isArray(wire?.models)) return wire.models;\n  throw new TypeSafeError(\n    \"Unexpected response shape from GET /v1/models; expected { models: [...] }.\",\n  );\n};\n","/** Runtime detection for browser guards and request headers. */\n\ninterface RuntimeGlobals {\n  window?: { document?: unknown };\n  navigator?: { userAgent?: string };\n  process?: { versions?: Record<string, string | undefined>; platform?: string; arch?: string };\n  Deno?: { version?: { deno?: string } };\n  Bun?: { version?: string };\n  EdgeRuntime?: unknown;\n}\n\nconst g = globalThis as RuntimeGlobals;\n\n/** Whether browser page globals are present. */\nexport const isBrowser = (): boolean =>\n  typeof g.window !== \"undefined\" &&\n  typeof g.window.document !== \"undefined\" &&\n  typeof g.navigator !== \"undefined\";\n\n/** Runtime name, version, and platform for the `X-TypeSafe-Runtime` header. */\nexport const describeRuntime = (): string => {\n  const platform =\n    g.process?.platform && g.process?.arch ? ` (${g.process.platform}; ${g.process.arch})` : \"\";\n  if (g.Bun?.version) return `bun/${g.Bun.version}${platform}`;\n  if (g.Deno?.version?.deno) return `deno/${g.Deno.version.deno}${platform}`;\n  if (g.EdgeRuntime !== undefined) return \"vercel-edge\";\n  if (g.navigator?.userAgent === \"Cloudflare-Workers\") return \"cloudflare-workers\";\n  if (g.process?.versions?.node) return `node/${g.process.versions.node}${platform}`;\n  if (isBrowser()) return \"browser\";\n  return \"unknown\";\n};\n","// Keep in sync with package.json \"version\". Checked by `npm run check:version`.\nexport const VERSION = \"0.5.7\";\n","import { APIPromise, requestIdFrom } from \"./api-promise\";\nimport { ENV, fromCodeOrEnv, readEnv } from \"./env\";\nimport {\n  APIConnectionError,\n  APIError,\n  APITimeoutError,\n  APIUserAbortError,\n  TypeSafeError,\n} from \"./errors\";\nimport {\n  consoleLogger,\n  DEFAULT_LOG_LEVEL,\n  parseLogLevel,\n  redactHeaders,\n  withLevel,\n} from \"./logging\";\nimport { toWireQuestions } from \"./questions\";\nimport { Models } from \"./resources/models\";\nimport {\n  DEFAULT_RETRY_POLICY,\n  DEFAULT_TIMEOUT_MS,\n  isRetryableStatus,\n  retryDelayMs,\n  sleep,\n} from \"./retry\";\nimport { describeRuntime, isBrowser } from \"./runtime\";\nimport type {\n  Fetch,\n  Logger,\n  LogLevel,\n  Questions,\n  RequestOptions,\n  RetryPolicy,\n  SystemOneRequest,\n  SystemOneRequestPayload,\n  SystemOneResult,\n  TypeSafeClientConfig,\n} from \"./types\";\nimport { VERSION } from \"./version\";\n\nexport const DEFAULT_BASE_URL = \"https://api.typesafe.ai\";\nexport const DEFAULT_MODEL = \"jev-latest\";\n\n// ---------------------------------------------------------------------------\n// Construction-time checks\n// ---------------------------------------------------------------------------\n\nconst missingApiKey = (): never => {\n  throw new TypeSafeError(\n    `No API key was provided. Pass \\`apiKey\\` to the TypeSafeClient constructor or set the ${ENV.apiKey} environment variable.`,\n  );\n};\n\nconst missingFetch = (): never => {\n  throw new TypeSafeError(\n    \"No global `fetch` is available in this runtime. Pass a `fetch` implementation to the TypeSafeClient constructor.\",\n  );\n};\n\nconst refuseBrowser = (): never => {\n  throw new TypeSafeError(\n    \"TypeSafeClient is running in a browser, which would expose your API key to anyone using the page. \" +\n      \"Call the API from a server instead, or pass `dangerouslyAllowBrowser: true` if you understand the risk.\",\n  );\n};\n\n/** Call global `fetch` with its required receiver in browsers. */\nconst defaultFetch: Fetch = (input, init) => globalThis.fetch(input, init);\n\nconst assertNonNegativeInteger = (name: string, value: number): number => {\n  if (!Number.isInteger(value) || value < 0) {\n    throw new TypeSafeError(`\\`${name}\\` must be a non-negative integer, got ${String(value)}.`);\n  }\n  return value;\n};\n\nconst assertPositiveMs = (name: string, value: number): number => {\n  if (!Number.isFinite(value) || value <= 0) {\n    throw new TypeSafeError(\n      `\\`${name}\\` must be a positive number of milliseconds, got ${String(value)}.`,\n    );\n  }\n  return value;\n};\n\nconst assertNonNegativeMs = (name: string, value: number): number => {\n  if (!Number.isFinite(value) || value < 0) {\n    throw new TypeSafeError(\n      `\\`${name}\\` must be a non-negative number of milliseconds, got ${String(value)}.`,\n    );\n  }\n  return value;\n};\n\nconst assertFraction = (name: string, value: number): number => {\n  if (!Number.isFinite(value) || value < 0 || value > 1) {\n    throw new TypeSafeError(`\\`${name}\\` must be between 0 and 1, got ${String(value)}.`);\n  }\n  return value;\n};\n\nconst assertStatusSet = (name: string, statuses: ReadonlySet<number>): ReadonlySet<number> => {\n  for (const status of statuses) {\n    if (!Number.isInteger(status) || status < 100 || status > 999) {\n      throw new TypeSafeError(`\\`${name}\\` must contain HTTP status codes, got ${String(status)}.`);\n    }\n  }\n  return statuses;\n};\n\n/** Merge and validate retry overrides, copying the status set to isolate later mutations. */\nconst resolveRetryPolicy = (\n  base: RetryPolicy,\n  overrides: Partial<RetryPolicy> | undefined,\n): RetryPolicy => {\n  const o = overrides ?? {};\n  return {\n    maxRetries:\n      o.maxRetries === undefined\n        ? base.maxRetries\n        : assertNonNegativeInteger(\"retry.maxRetries\", o.maxRetries),\n    backoffInitialMs:\n      o.backoffInitialMs === undefined\n        ? base.backoffInitialMs\n        : assertNonNegativeMs(\"retry.backoffInitialMs\", o.backoffInitialMs),\n    backoffMaxMs:\n      o.backoffMaxMs === undefined\n        ? base.backoffMaxMs\n        : assertNonNegativeMs(\"retry.backoffMaxMs\", o.backoffMaxMs),\n    backoffJitter:\n      o.backoffJitter === undefined\n        ? base.backoffJitter\n        : assertFraction(\"retry.backoffJitter\", o.backoffJitter),\n    httpStatuses: new Set(\n      o.httpStatuses === undefined\n        ? base.httpStatuses\n        : assertStatusSet(\"retry.httpStatuses\", o.httpStatuses),\n    ),\n    respectRetryAfter: o.respectRetryAfter ?? base.respectRetryAfter,\n    maxRetryAfterMs:\n      o.maxRetryAfterMs === undefined\n        ? base.maxRetryAfterMs\n        : assertNonNegativeMs(\"retry.maxRetryAfterMs\", o.maxRetryAfterMs),\n    apiConnectionError: o.apiConnectionError ?? base.apiConnectionError,\n    apiTimeoutError: o.apiTimeoutError ?? base.apiTimeoutError,\n  };\n};\n\n/** Whether the policy retries a connection error or timeout. */\nconst isRetryableError = (err: unknown, policy: RetryPolicy): boolean => {\n  if (err instanceof APITimeoutError) return policy.apiTimeoutError;\n  if (err instanceof APIConnectionError) return policy.apiConnectionError;\n  return false;\n};\n\n/** Resolve and validate the log level from configuration or the environment. */\nconst resolveLogLevel = (fromCode: LogLevel | undefined): LogLevel => {\n  if (fromCode !== undefined) return parseLogLevel(fromCode, \"the `logLevel` option\");\n  const fromEnv = readEnv(ENV.logLevel);\n  if (fromEnv !== undefined) return parseLogLevel(fromEnv, ENV.logLevel);\n  return DEFAULT_LOG_LEVEL;\n};\n\nconst stripTrailingSlashes = (url: string): string => url.replace(/\\/+$/, \"\");\n\n/** Last value wins regardless of casing; undefined removes a protected header. */\nconst mergeHeaders = (\n  ...sources: Readonly<Record<string, string | undefined>>[]\n): Record<string, string> => {\n  const entries = new Map<string, [string, string]>();\n  for (const source of sources) {\n    for (const [name, value] of Object.entries(source)) {\n      if (value === undefined) entries.delete(name.toLowerCase());\n      else entries.set(name.toLowerCase(), [name, value]);\n    }\n  }\n  return Object.fromEntries(entries.values());\n};\n\n/** Drain a clone so the original response retains its metadata and a readable, buffered body. */\nconst bufferResponse = async (response: Response, signal: AbortSignal): Promise<void> => {\n  const reader = response.clone().body?.getReader();\n  if (!reader) return;\n  const cancel = (): void => {\n    // Cancel both tee branches without waiting for an underlying source to acknowledge it.\n    void reader.cancel(signal.reason).catch(() => {});\n    void response.body?.cancel(signal.reason).catch(() => {});\n  };\n  signal.addEventListener(\"abort\", cancel, { once: true });\n  try {\n    if (signal.aborted) cancel();\n    signal.throwIfAborted();\n    while (!(await reader.read()).done) {\n      signal.throwIfAborted();\n    }\n    signal.throwIfAborted();\n  } finally {\n    signal.removeEventListener(\"abort\", cancel);\n    reader.releaseLock();\n  }\n};\n\n// ---------------------------------------------------------------------------\n// Client\n// ---------------------------------------------------------------------------\n\ntype Method = \"GET\" | \"POST\";\n\n/** Per-call transport options with an optional JSON body. */\nexport interface RawRequestOptions extends RequestOptions {\n  body?: unknown;\n}\n\n/** Internal transport interface used by API resources. */\nexport interface Transport {\n  request<T>(method: \"GET\" | \"POST\", path: string, options?: RawRequestOptions): APIPromise<T>;\n  readonly defaultModel: string;\n}\n\ninterface ResolvedRequest {\n  method: Method;\n  path: string;\n  body: unknown;\n  headers: Record<string, string>;\n  signal: AbortSignal | undefined;\n  timeout: number;\n  retry: RetryPolicy;\n}\n\n/** Runtime description cached for the process lifetime. */\nconst RUNTIME = describeRuntime();\n\n/** Client for the TypeSafe AI API. */\nexport class TypeSafeClient {\n  /** API key excluded from serialization and public properties. */\n  readonly #apiKey: string;\n  /** API root with trailing slashes removed. */\n  readonly baseURL: string;\n  /** Model used when a request omits `model`. */\n  readonly defaultModel: string;\n  /** Configured log verbosity. */\n  readonly logLevel: LogLevel;\n  /** The configured logger, filtered to `logLevel`. */\n  readonly logger: Logger;\n  /** Retry settings with constructor overrides applied. */\n  readonly retry: RetryPolicy;\n  /** Timeout per attempt in milliseconds. */\n  readonly timeout: number;\n  /** Additional headers sent with each request. */\n  readonly defaultHeaders: Readonly<Record<string, string>>;\n  /** HTTP fetch implementation. */\n  readonly fetch: Fetch;\n\n  /** The models available to the account. */\n  readonly models: Models;\n\n  #requestCount = 0;\n\n  /**\n   * Create a client for the TypeSafe AI API.\n   *\n   * Explicit options take precedence over environment variables, then SDK defaults.\n   * Empty or whitespace-only environment values are ignored.\n   *\n   * @throws {TypeSafeError} The API key is missing, configuration is invalid, or the runtime is unsupported.\n   */\n  constructor(config: TypeSafeClientConfig = {}) {\n    if (isBrowser() && !config.dangerouslyAllowBrowser) refuseBrowser();\n\n    this.#apiKey = fromCodeOrEnv(config.apiKey, ENV.apiKey) ?? missingApiKey();\n    this.baseURL = stripTrailingSlashes(\n      fromCodeOrEnv(config.baseURL, ENV.baseURL) ?? DEFAULT_BASE_URL,\n    );\n    this.defaultModel = fromCodeOrEnv(config.defaultModel, ENV.defaultModel) ?? DEFAULT_MODEL;\n    this.logLevel = resolveLogLevel(config.logLevel);\n    this.logger = withLevel(config.logger ?? consoleLogger, this.logLevel);\n    this.retry = resolveRetryPolicy(DEFAULT_RETRY_POLICY, config.retry);\n    this.timeout = assertPositiveMs(\"timeout\", config.timeout ?? DEFAULT_TIMEOUT_MS);\n    this.defaultHeaders = { ...config.defaultHeaders };\n\n    if (config.fetch === undefined && typeof globalThis.fetch !== \"function\") missingFetch();\n    this.fetch = config.fetch ?? defaultFetch;\n\n    const transport: Transport = {\n      request: (method, path, options) => this.#request(method, path, options),\n      defaultModel: this.defaultModel,\n    };\n    this.models = new Models(transport);\n  }\n\n  /**\n   * Answer named questions about text or structured state.\n   *\n   * @param request - State, questions, and an optional model override.\n   * @param options - Per-call timeout, retry, headers, and cancellation settings.\n   * @returns Answers typed by question name and criteria, with model and token usage.\n   * @throws {TypeSafeError} Questions or score criteria are empty, or score keys are invalid.\n   * @throws {APIError} The server returns a non-2xx response after retries.\n   * @throws {APIConnectionError} The request cannot connect or times out after retries.\n   * @throws {APIUserAbortError} The caller aborts the request.\n   *\n   * @example\n   * ```ts\n   * const { answers } = await client.systemOne({\n   *   state: \"I was charged twice. Please help.\",\n   *   questions: { billing: noul(\"Is this about billing?\") },\n   * });\n   * console.log(answers.billing.noul);\n   * ```\n   */\n  systemOne<const Q extends Questions>(\n    request: SystemOneRequest<Q>,\n    options: RequestOptions = {},\n  ): APIPromise<SystemOneResult<Q>> {\n    const body = {\n      ...request,\n      model: request.model ?? this.defaultModel,\n      questions: toWireQuestions(request.questions),\n    } satisfies SystemOneRequestPayload;\n\n    return this.#request<SystemOneResult<Q>>(\"POST\", \"/v1/systemone\", {\n      ...options,\n      body,\n    });\n  }\n\n  /** Send a request and parse its response body. */\n  #request<T>(method: Method, path: string, options: RawRequestOptions = {}): APIPromise<T> {\n    const resolved: ResolvedRequest = {\n      method,\n      path,\n      body: options.body,\n      headers: mergeHeaders(this.defaultHeaders, options.headers ?? {}),\n      signal: options.signal,\n      timeout:\n        options.timeout === undefined ? this.timeout : assertPositiveMs(\"timeout\", options.timeout),\n      retry: resolveRetryPolicy(this.retry, options.retry),\n    };\n    // Numbered so concurrent requests, and the attempts within one, can be told apart in the logs.\n    const tag = `#${++this.#requestCount} ${method} ${path}`;\n\n    return new APIPromise<T>(this.fetchWithRetries(tag, resolved), async (res) => {\n      const parsed = await parseBody(res);\n      this.logger.debug(`${tag} <- body`, parsed);\n      return parsed as T;\n    });\n  }\n\n  /** Retry eligible failures, logging attempt summaries at `info` and headers and bodies at `debug`. */\n  private async fetchWithRetries(tag: string, req: ResolvedRequest): Promise<Response> {\n    const url = `${this.baseURL}${req.path}`;\n    // User-supplied headers go first so they can't clobber auth or the JSON content type.\n    const headers = mergeHeaders(req.headers, {\n      Authorization: `Bearer ${this.#apiKey}`,\n      Accept: \"application/json\",\n      \"User-Agent\": `typesafe-sdk/${VERSION}`,\n      \"X-TypeSafe-SDK\": `typesafe-sdk/${VERSION}`,\n      \"X-TypeSafe-Runtime\": RUNTIME,\n      \"Content-Type\": req.body === undefined ? undefined : \"application/json\",\n      \"X-TypeSafe-Retry-Count\": undefined,\n    });\n    const body = req.body === undefined ? undefined : JSON.stringify(req.body);\n\n    for (let attempt = 0; ; attempt++) {\n      const retriesLeft = req.retry.maxRetries - attempt;\n      const attemptHeaders =\n        attempt === 0 ? headers : { ...headers, \"X-TypeSafe-Retry-Count\": String(attempt) };\n      this.logger.debug(`${tag} -> ${url}`, {\n        headers: redactHeaders(attemptHeaders),\n        body: req.body,\n      });\n\n      const started = Date.now();\n      let res: Response;\n      try {\n        res = await this.attempt(\n          tag,\n          url,\n          { method: req.method, headers: attemptHeaders, body },\n          req,\n        );\n      } catch (err) {\n        if (err instanceof APIUserAbortError || retriesLeft <= 0) throw err;\n        if (!isRetryableError(err, req.retry)) throw err;\n        await this.backOff(tag, attempt, retriesLeft, (err as Error).message, undefined, req);\n        continue;\n      }\n\n      const requestId = requestIdFrom(res.headers);\n      this.logger.info(\n        `${tag} <- ${res.status} in ${Date.now() - started}ms${requestId ? ` (request ${requestId})` : \"\"}`,\n      );\n      if (res.ok) return res;\n\n      const errorBody = await parseBody(res);\n      this.logger.debug(`${tag} <- error body`, errorBody);\n      const error = APIError.fromResponse(res.status, errorBody, res.headers);\n      if (retriesLeft <= 0 || !isRetryableStatus(res.status, req.retry)) throw error;\n      await this.backOff(tag, attempt, retriesLeft, `${res.status}`, res.headers, req);\n    }\n  }\n\n  /**\n   * One HTTP round trip, including body delivery, with a timeout. The caller's signal and our\n   * timer both abort the same controller; we check which fired to choose the error class.\n   */\n  private async attempt(\n    tag: string,\n    url: string,\n    init: { method: Method; headers: Record<string, string>; body: string | undefined },\n    { signal, timeout }: ResolvedRequest,\n  ): Promise<Response> {\n    const controller = new AbortController();\n    const abortFromCaller = (): void => controller.abort(signal?.reason);\n    if (signal?.aborted) abortFromCaller();\n    signal?.addEventListener(\"abort\", abortFromCaller, { once: true });\n\n    let timedOut = false;\n    const timer = setTimeout(() => {\n      timedOut = true;\n      controller.abort();\n    }, timeout);\n\n    const started = Date.now();\n    const elapsed = (): string => `${Date.now() - started}ms`;\n    try {\n      const response = await this.fetch(url, { ...init, signal: controller.signal });\n      await bufferResponse(response, controller.signal);\n      return response;\n    } catch (err) {\n      if (signal?.aborted) {\n        this.logger.info(`${tag} aborted by caller after ${elapsed()}`);\n        throw new APIUserAbortError(undefined, { cause: err });\n      }\n      if (timedOut) {\n        this.logger.info(`${tag} timed out after ${elapsed()}`);\n        throw new APITimeoutError(timeout, { cause: err });\n      }\n      this.logger.info(`${tag} connection error after ${elapsed()}`, err);\n      throw new APIConnectionError(\n        err instanceof Error ? `Connection error: ${err.message}` : undefined,\n        { cause: err },\n      );\n    } finally {\n      clearTimeout(timer);\n      signal?.removeEventListener(\"abort\", abortFromCaller);\n    }\n  }\n\n  /** Wait before retrying; caller cancellation throws `APIUserAbortError`. */\n  private async backOff(\n    tag: string,\n    attempt: number,\n    retriesLeft: number,\n    reason: string,\n    headers: Headers | undefined,\n    { retry, signal }: ResolvedRequest,\n  ): Promise<void> {\n    const delay = retryDelayMs(attempt, headers, retry);\n    const nth = attempt + 1;\n    const total = attempt + retriesLeft;\n    this.logger.info(`${tag} retrying in ${delay}ms (retry ${nth}/${total}) after ${reason}`);\n    try {\n      await sleep(delay, signal);\n    } catch (err) {\n      this.logger.info(`${tag} aborted by caller while waiting to retry`);\n      throw new APIUserAbortError(undefined, { cause: err });\n    }\n  }\n}\n\nconst parseBody = async (res: Response): Promise<unknown> => {\n  const text = await res.text();\n  if (text.length === 0) return undefined;\n  const contentType = res.headers.get(\"content-type\") ?? \"\";\n  if (contentType.includes(\"application/json\")) {\n    try {\n      return JSON.parse(text);\n    } catch {\n      return text;\n    }\n  }\n  // Be lenient: servers and proxies don't always set content-type.\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n};\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,415 @@
+//#region src/api-promise.d.ts
+/** Parsed data with its HTTP response and request ID. */
+interface WithResponse<T> {
+  /** The parsed response body. */
+  data: T;
+  /** The HTTP response, with its body consumed by parsing. */
+  response: Response;
+  /** Request ID from `x-typesafe-request-id`, or `undefined` when absent. */
+  requestId: string | undefined;
+}
+/**
+ * A promise for the parsed result with access to the HTTP response.
+ *
+ * Non-2xx responses reject with an `APIError`, including through `asResponse()`.
+ */
+declare class APIPromise<T> extends Promise<T> {
+  #private;
+  constructor(responsePromise: Promise<Response>, parseResponse: (response: Response) => Promise<T>);
+  /**
+   * Resolves to the raw `Response` without parsing the body. SDK requests buffer the full
+   * body under the request timeout before handoff; reading it afterwards is caller-owned.
+   * The caller owns the body; don't also `await` the parsed result on the same promise.
+   */
+  asResponse(): Promise<Response>;
+  /** Return the parsed result, HTTP response, and request ID. */
+  withResponse(): Promise<WithResponse<T>>;
+  /** Transform the parsed result, sharing the HTTP response and a single body parse. */
+  map<U>(fn: (data: T) => U): APIPromise<U>;
+  override then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+  override catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<T | TResult>;
+  override finally(onfinally?: (() => void) | null): Promise<T>;
+}
+//#endregion
+//#region src/types.d.ts
+/** A JSON-compatible value. */
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+  [key: string]: JsonValue;
+};
+/** Text, a JSON object or array, or `null` for state, instructions, and criteria. */
+type EntryType = string | {
+  [key: string]: JsonValue;
+} | JsonValue[] | null;
+/** A criterion description; `null` leaves the label undescribed. */
+type Description = EntryType;
+/** A yes/no question with optional descriptions for either outcome. */
+interface NoulQuestion {
+  type: "noul";
+  /** The question as text, a JSON object, or an array; optional or `null`. */
+  instructions?: EntryType;
+  /** Optional descriptions of the yes and no outcomes. */
+  criteria?: {
+    /** Description of the yes outcome. */
+    true?: EntryType;
+    /** Description of the no outcome. */
+    false?: EntryType;
+  } | null;
+}
+/** Labels mapped to descriptions, or `null` for undescribed labels. */
+type ChoiceCriteria = {
+  [label: string]: Description;
+};
+/** A question that selects between named alternatives. */
+interface ChoiceQuestion<T extends ChoiceCriteria = ChoiceCriteria> {
+  type: "choice";
+  /** The question as text, a JSON object, or an array; optional or `null`. */
+  instructions?: EntryType;
+  /** Descriptions of the available outcomes. */
+  criteria: T;
+}
+/** A nonempty array indexed by score from zero; `null` leaves a score undescribed. */
+type ScoreList = readonly [EntryType, ...EntryType[]];
+/** Score descriptions keyed from zero with no gaps; `null` leaves a score undescribed. */
+type ScoreMap = {
+  readonly [score: number]: EntryType;
+};
+/** An ordered rubric expressed as an array or score map. */
+type ScoreCriteria = ScoreList | ScoreMap;
+/** A question that assigns a score using an ordered rubric. */
+interface ScoreQuestion<T extends ScoreCriteria = ScoreCriteria> {
+  type: "score";
+  /** The question as text, a JSON object, or an array; optional or `null`. */
+  instructions?: EntryType;
+  /** Descriptions of the available outcomes. */
+  criteria: T;
+}
+/** A question identified by its `type` field. */
+type Question = NoulQuestion | ScoreQuestion | ChoiceQuestion;
+/** Questions keyed by the names used to identify their answers. */
+interface Questions {
+  [name: string]: Question;
+}
+/** A yes/no answer. */
+interface NoulResponse {
+  readonly type: "noul";
+  /** Probability of a yes answer, from zero to one. */
+  readonly noul: number;
+}
+/** A selected label and its probabilities. */
+interface ChoiceResponse<T extends ChoiceCriteria = ChoiceCriteria> {
+  readonly type: "choice";
+  /** The selected label. */
+  readonly choice: keyof T & string;
+  /** Reported confidence in the selected label. */
+  readonly confidence: number;
+  /** Probabilities keyed by label. */
+  readonly probabilities: { readonly [label in keyof T]: number; };
+}
+/** Score keys inferred from the rubric; tuple keys are numeric strings, map keys are numbers. */
+type ScoreOf<T extends ScoreCriteria> = T extends readonly unknown[] ? number extends T["length"] ? number : Extract<keyof T, `${number}`> : Extract<keyof T, number>;
+/** Rubric descriptions keyed by score. */
+type ScoreLegend<T extends ScoreCriteria> = { readonly [score in ScoreOf<T>]: T[score]; };
+/** An expected score with its rubric and probabilities. */
+interface ScoreResponse<T extends ScoreCriteria = ScoreCriteria> {
+  readonly type: "score";
+  /** Expected score, which may fall between integer rubric levels. */
+  readonly score: number;
+  /** Reported confidence in the score. */
+  readonly confidence: number;
+  /** Rubric descriptions keyed by score. */
+  readonly legend: ScoreLegend<T>;
+  /** Probabilities keyed by score. */
+  readonly probabilities: { readonly [score in ScoreOf<T>]: number; };
+}
+/** The answer type for a question, preserving its criteria keys. */
+type ResultFor<T extends Question> = T extends NoulQuestion ? NoulResponse : T extends ScoreQuestion<infer S> ? ScoreResponse<S> : T extends ChoiceQuestion<infer E> ? ChoiceResponse<E> : never;
+/** Token usage for a request. */
+interface Usage {
+  /** Number of input tokens used. */
+  readonly input_tokens: number;
+  /** Number of output tokens used. */
+  readonly output_tokens: number;
+}
+/** Answers keyed by question name, with model and usage metadata. */
+interface SystemOneResult<Q extends Questions> {
+  /** The model used to answer the request. */
+  readonly model: string;
+  /** Answers with types inferred from the supplied questions. */
+  readonly answers: { readonly [K in keyof Q]: ResultFor<Q[K]>; };
+  /** Token usage for the request. */
+  readonly usage: Usage;
+}
+/** Metadata for an available model. */
+interface ModelCard {
+  readonly name: string;
+  readonly description: string;
+  readonly release_date: string;
+}
+/**
+ * State and named questions for `systemOne`.
+ *
+ * Additional properties on a request variable are forwarded, including `null` values.
+ * Score maps are converted to arrays before sending.
+ */
+interface SystemOneRequest<Q extends Questions = Questions> {
+  /** Text, a JSON object or array, or `null` to evaluate. */
+  state: EntryType;
+  /** Nonempty questions keyed by the names used to identify their answers. */
+  questions: Q;
+  /** Model override; omitted values inherit `defaultModel`. */
+  model?: string;
+}
+/** Request body for `POST /v1/systemone`, with the model resolved. */
+interface SystemOneRequestPayload extends SystemOneRequest {
+  model: string;
+}
+/** Retry configuration. Partial overrides inherit unset fields from the client or SDK defaults. */
+interface RetryPolicy {
+  /** Maximum retries after the initial attempt; `0` disables retries. Default: 2. */
+  readonly maxRetries: number;
+  /** First backoff delay in milliseconds, doubled up to `backoffMaxMs`. Default: 500. */
+  readonly backoffInitialMs: number;
+  /** Maximum backoff delay in milliseconds. Default: 5000. */
+  readonly backoffMaxMs: number;
+  /** Fraction of each backoff delay randomly subtracted, from 0 to 1. Default: 0.25. */
+  readonly backoffJitter: number;
+  /** HTTP status codes to retry. Default: 408, 429, and 500–599. */
+  readonly httpStatuses: ReadonlySet<number>;
+  /** Honor `Retry-After` and `retry-after-ms` up to `maxRetryAfterMs`. Default: true. */
+  readonly respectRetryAfter: boolean;
+  /** Maximum server retry delay in milliseconds; longer delays use backoff. Default: 60000. */
+  readonly maxRetryAfterMs: number;
+  /** Retry connection failures, including interrupted response bodies (`APIConnectionError`). Default: true. */
+  readonly apiConnectionError: boolean;
+  /** Whether to retry `APITimeoutError`. Default: true. */
+  readonly apiTimeoutError: boolean;
+}
+/** Per-call options that override client settings. */
+interface RequestOptions {
+  /** Cancellation signal for the request and pending retries. */
+  signal?: AbortSignal;
+  /** Timeout per attempt in milliseconds; there is no total retry budget. */
+  timeout?: number;
+  /** Retry overrides for this call; omitted fields inherit client settings. */
+  retry?: Partial<RetryPolicy>;
+  /** Additional headers, merged over `defaultHeaders`. */
+  headers?: Record<string, string>;
+}
+/** HTTP fetch implementation compatible with the global `fetch`. */
+type Fetch = (input: string, init?: RequestInit) => Promise<Response>;
+/** Log verbosity; `off` disables logging. */
+type LogLevel = "debug" | "info" | "warn" | "error" | "off";
+/** Log methods accepting a message and structured values; compatible with `console`. */
+interface Logger {
+  debug(message: string, ...args: unknown[]): void;
+  info(message: string, ...args: unknown[]): void;
+  warn(message: string, ...args: unknown[]): void;
+  error(message: string, ...args: unknown[]): void;
+}
+/** Client options. Explicit values take precedence over environment variables, then SDK defaults. */
+interface TypeSafeClientConfig {
+  /** Required API key; falls back to `TYPESAFE_API_KEY`. */
+  apiKey?: string;
+  /** API root; falls back to `TYPESAFE_BASE_URL`, then `https://api.typesafe.ai`. */
+  baseURL?: string;
+  /** Default model; falls back to `TYPESAFE_DEFAULT_MODEL`, then `jev-latest`. */
+  defaultModel?: string;
+  /**
+   * Log level; falls back to `TYPESAFE_LOG_LEVEL`, then `warn`.
+   * `info` logs request summaries; `debug` adds headers and bodies.
+   * Known credential headers are redacted; bodies are not.
+   */
+  logLevel?: LogLevel;
+  /** Logger filtered to `logLevel` and above. Default: prefixed `console`. */
+  logger?: Logger;
+  /** Retry overrides; omitted fields use the defaults in `RetryPolicy`. */
+  retry?: Partial<RetryPolicy>;
+  /** Timeout per attempt in milliseconds, without a total retry budget. Default: 10000. */
+  timeout?: number;
+  /** Additional request headers; per-call headers take precedence. */
+  defaultHeaders?: Record<string, string>;
+  /** Allow browser use, exposing the API key to page users. Default: false. */
+  dangerouslyAllowBrowser?: boolean;
+  /** Custom HTTP fetch implementation for transport configuration or tests. Default: global `fetch`. */
+  fetch?: Fetch;
+}
+//#endregion
+//#region src/resources/models.d.ts
+/** Access to the Models API resource. */
+declare class Models {
+  #private;
+  constructor(transport: Transport);
+  /** List the models available to the account. */
+  list(options?: RequestOptions): APIPromise<ModelCard[]>;
+}
+//#endregion
+//#region src/client.d.ts
+/** Per-call transport options with an optional JSON body. */
+interface RawRequestOptions extends RequestOptions {
+  body?: unknown;
+}
+/** Internal transport interface used by API resources. */
+interface Transport {
+  request<T>(method: "GET" | "POST", path: string, options?: RawRequestOptions): APIPromise<T>;
+  readonly defaultModel: string;
+}
+/** Client for the TypeSafe AI API. */
+declare class TypeSafeClient {
+  #private;
+  /** API root with trailing slashes removed. */
+  readonly baseURL: string;
+  /** Model used when a request omits `model`. */
+  readonly defaultModel: string;
+  /** Configured log verbosity. */
+  readonly logLevel: LogLevel;
+  /** The configured logger, filtered to `logLevel`. */
+  readonly logger: Logger;
+  /** Retry settings with constructor overrides applied. */
+  readonly retry: RetryPolicy;
+  /** Timeout per attempt in milliseconds. */
+  readonly timeout: number;
+  /** Additional headers sent with each request. */
+  readonly defaultHeaders: Readonly<Record<string, string>>;
+  /** HTTP fetch implementation. */
+  readonly fetch: Fetch;
+  /** The models available to the account. */
+  readonly models: Models;
+  /**
+   * Create a client for the TypeSafe AI API.
+   *
+   * Explicit options take precedence over environment variables, then SDK defaults.
+   * Empty or whitespace-only environment values are ignored.
+   *
+   * @throws {TypeSafeError} The API key is missing, configuration is invalid, or the runtime is unsupported.
+   */
+  constructor(config?: TypeSafeClientConfig);
+  /**
+   * Answer named questions about text or structured state.
+   *
+   * @param request - State, questions, and an optional model override.
+   * @param options - Per-call timeout, retry, headers, and cancellation settings.
+   * @returns Answers typed by question name and criteria, with model and token usage.
+   * @throws {TypeSafeError} Questions or score criteria are empty, or score keys are invalid.
+   * @throws {APIError} The server returns a non-2xx response after retries.
+   * @throws {APIConnectionError} The request cannot connect or times out after retries.
+   * @throws {APIUserAbortError} The caller aborts the request.
+   *
+   * @example
+   * ```ts
+   * const { answers } = await client.systemOne({
+   *   state: "I was charged twice. Please help.",
+   *   questions: { billing: noul("Is this about billing?") },
+   * });
+   * console.log(answers.billing.noul);
+   * ```
+   */
+  systemOne<const Q extends Questions>(request: SystemOneRequest<Q>, options?: RequestOptions): APIPromise<SystemOneResult<Q>>;
+  /** Retry eligible failures, logging attempt summaries at `info` and headers and bodies at `debug`. */
+  private fetchWithRetries;
+  /**
+   * One HTTP round trip, including body delivery, with a timeout. The caller's signal and our
+   * timer both abort the same controller; we check which fired to choose the error class.
+   */
+  private attempt;
+  /** Wait before retrying; caller cancellation throws `APIUserAbortError`. */
+  private backOff;
+}
+//#endregion
+//#region src/env.d.ts
+/** Environment variable names for client configuration. Explicit options take precedence. */
+declare const ENV: {
+  /** Required API key; used when `apiKey` is omitted. */
+  readonly apiKey: "TYPESAFE_API_KEY";
+  /** API root; defaults to `https://api.typesafe.ai`. */
+  readonly baseURL: "TYPESAFE_BASE_URL";
+  /** Default model name; defaults to `jev-latest`. */
+  readonly defaultModel: "TYPESAFE_DEFAULT_MODEL";
+  /** Log level; defaults to `warn`. */
+  readonly logLevel: "TYPESAFE_LOG_LEVEL";
+};
+type EnvVar = (typeof ENV)[keyof typeof ENV];
+//#endregion
+//#region src/errors.d.ts
+/** Base class for SDK errors. */
+declare class TypeSafeError extends Error {
+  constructor(message: string, options?: ErrorOptions);
+}
+/** An unsuccessful HTTP response from the API. */
+declare class APIError extends TypeSafeError {
+  /** HTTP response status code. */
+  readonly status: number;
+  /** HTTP response headers. */
+  readonly headers: Headers;
+  /** Parsed JSON, response text, or `undefined` for an empty body. */
+  readonly body: unknown;
+  /** Request ID from `x-typesafe-request-id`, or `undefined` when absent. */
+  readonly requestId: string | undefined;
+  constructor(status: number, body: unknown, headers: Headers, message?: string);
+  private static describe;
+  /** Create the error subclass for an HTTP status code. */
+  static fromResponse(status: number, body: unknown, headers: Headers): APIError;
+}
+/** HTTP 400: the request is invalid. */
+declare class BadRequestError extends APIError {}
+/** HTTP 401: authentication failed. */
+declare class AuthenticationError extends APIError {}
+/** HTTP 403: access is denied. */
+declare class PermissionDeniedError extends APIError {}
+/** HTTP 404: the resource was not found. */
+declare class NotFoundError extends APIError {}
+/** HTTP 422: request validation failed. */
+declare class UnprocessableEntityError extends APIError {}
+/** HTTP 429: the rate limit was exceeded. */
+declare class RateLimitError extends APIError {
+  /** Server retry delay in milliseconds, or `undefined` when absent or invalid. */
+  readonly retryAfterMs: number | undefined;
+}
+/** HTTP 5xx: the server failed to handle the request. */
+declare class InternalServerError extends APIError {}
+/** The request or response-body delivery failed (DNS, TLS, connection closed, etc.). */
+declare class APIConnectionError extends TypeSafeError {
+  constructor(message?: string, options?: ErrorOptions);
+}
+/** The full response did not arrive within the timeout. A kind of `APIConnectionError`. */
+declare class APITimeoutError extends APIConnectionError {
+  /** Configured timeout in milliseconds. */
+  readonly timeoutMs: number;
+  constructor(timeoutMs: number, options?: ErrorOptions);
+}
+/** The caller cancelled the request through an `AbortSignal`. */
+declare class APIUserAbortError extends TypeSafeError {
+  constructor(message?: string, options?: ErrorOptions);
+}
+//#endregion
+//#region src/logging.d.ts
+/** Supported log levels, from most to least verbose. */
+declare const LOG_LEVELS: readonly LogLevel[];
+//#endregion
+//#region src/questions.d.ts
+/**
+ * Create a yes/no question with optional descriptions for either outcome.
+ *
+ * @param instructions - The question as text, a JSON object or array; defaults to `null`.
+ * @param criteria - Optional descriptions of the yes and no outcomes.
+ */
+declare const noul: (instructions?: EntryType, criteria?: NoulQuestion["criteria"]) => NoulQuestion;
+/**
+ * Create a score question using an ordered rubric.
+ *
+ * @param instructions - The question as text, a JSON object or array, or `null`.
+ * @param criteria - A nonempty array or map indexed from zero with no gaps; descriptions may be `null`.
+ */
+declare const score$1: <const T extends ScoreCriteria>(instructions: EntryType, criteria: T) => ScoreQuestion<T>;
+/**
+ * Create a question that selects between named alternatives.
+ *
+ * @param instructions - The question as text, a JSON object or array, or `null`.
+ * @param criteria - Labels mapped to descriptions, or `null` for undescribed labels.
+ */
+declare const choice: <const T extends ChoiceCriteria>(instructions: EntryType, criteria: T) => ChoiceQuestion<T>;
+//#endregion
+//#region src/version.d.ts
+declare const VERSION = "0.5.7";
+//#endregion
+export { APIConnectionError, APIError, APIPromise, APITimeoutError, APIUserAbortError, AuthenticationError, BadRequestError, type ChoiceCriteria, type ChoiceQuestion, type ChoiceResponse, type Description, ENV, type EntryType, type EnvVar, type Fetch, InternalServerError, type JsonValue, LOG_LEVELS, type LogLevel, type Logger, type ModelCard, type Models, NotFoundError, type NoulQuestion, type NoulResponse, PermissionDeniedError, type Question, type Questions, RateLimitError, type RequestOptions, type ResultFor, type RetryPolicy, type ScoreCriteria, type ScoreLegend, type ScoreList, type ScoreMap, type ScoreOf, type ScoreQuestion, type ScoreResponse, type SystemOneRequest, type SystemOneRequestPayload, type SystemOneResult, TypeSafeClient, type TypeSafeClientConfig, TypeSafeError, UnprocessableEntityError, type Usage, VERSION, type WithResponse, choice, noul, score$1 as score };
+//# sourceMappingURL=index.d.cts.map