@to11ai/sdk 2.0.0-rc.3 → 2.0.0-rc.5

package/src/transport.ts

@@ -1,8 +1,7 @@
 import type { BehaviorStore } from "./behaviors/store";
 import {
-	AmbiguousEnvLabelsError,
 	EnvNotEnabledForProviderError,
-	EnvNotFoundError,
+	LabelNotFoundError,
 	NoActiveReleaseError,
 	NoApplicableRouteError,
 	PromptLabelNotRegisteredError,
@@ -108,14 +107,11 @@ function mapPromptResolveError(
 		);
 	}
 	if (detailsCode === "ENV_NOT_FOUND") {
-		// Server-side unknown-env. (The client-eager "missing" variant is
-		// raised in resource.ts before any request — never here.)
-		return new EnvNotFoundError(
-			message,
-			{ env, source: "unknown" },
-			details,
-			status,
-		);
+		// Server-side unknown-label. (The client-side MissingLabelError — no
+		// label supplied at all — is raised in resource.ts before any request.)
+		// Prefer `details.label`, falling back to `details.env`.
+		const label = typeof d.label === "string" ? d.label : env;
+		return new LabelNotFoundError(message, label, details, status);
 	}
 	if (detailsCode === "NO_ACTIVE_RELEASE") {
 		return new NoActiveReleaseError(
@@ -125,9 +121,6 @@ function mapPromptResolveError(
 			status,
 		);
 	}
-	if (detailsCode === "AMBIGUOUS_ENV_LABELS") {
-		return new AmbiguousEnvLabelsError(message, { env, slug }, details, status);
-	}
 	if (PROMPT_POLICY_VIOLATION_DETAILS_CODES.has(detailsCode)) {
 		const policy = typeof d.policy === "string" ? d.policy : undefined;
 		return new PromptPolicyViolationError(
@@ -140,9 +133,9 @@ function mapPromptResolveError(
 	return undefined;
 }
 
-export type AuthConfig =
-	| { readonly apiKey: string; readonly getAccessToken?: never }
-	| { readonly getAccessToken: () => Promise<string>; readonly apiKey?: never };
+export interface AuthConfig {
+	readonly apiKey: string;
+}
 
 export interface TransportConfig {
 	readonly baseUrl: string;
@@ -248,12 +241,25 @@ function mapHttpError(
 	}
 	if (status === 429) {
 		const retryAfterHeader = headers?.get("retry-after");
-		const retryAfterSeconds = retryAfterHeader
-			? Number(retryAfterHeader)
-			: undefined;
+		let retryAfterSeconds: number | undefined;
+		if (retryAfterHeader) {
+			const numeric = Number(retryAfterHeader);
+			if (Number.isFinite(numeric)) {
+				retryAfterSeconds = Math.max(0, numeric);
+			} else {
+				// RFC 9110 HTTP-date form → seconds until that instant.
+				const when = Date.parse(retryAfterHeader);
+				if (!Number.isNaN(when)) {
+					retryAfterSeconds = Math.max(
+						0,
+						Math.round((when - Date.now()) / 1000),
+					);
+				}
+			}
+		}
 		return new To11aiRateLimitError(
 			message,
-			Number.isFinite(retryAfterSeconds) ? retryAfterSeconds : undefined,
+			retryAfterSeconds,
 			errorCode,
 			details,
 		);
@@ -395,25 +401,20 @@ export class Transport {
 	private readonly behaviorStore: BehaviorStore | undefined;
 
 	constructor(config: TransportConfig) {
-		this.baseUrl = config.baseUrl.replace(/\/$/, "");
+		this.baseUrl = config.baseUrl.replace(/\/+$/, "");
 		this.auth = config.auth;
 		this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
 		this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
 		this.behaviorStore = config.behaviorStore;
 	}
 
-	private async buildHeaders(): Promise<Record<string, string>> {
+	private buildHeaders(): Record<string, string> {
 		const headers: Record<string, string> = {
 			"content-type": "application/json",
 			accept: "application/json",
 		};
 
-		if (this.auth.apiKey !== undefined) {
-			headers.authorization = `Bearer ${this.auth.apiKey}`;
-		} else if (this.auth.getAccessToken) {
-			const token = await this.auth.getAccessToken();
-			headers.authorization = `Bearer ${token}`;
-		}
+		headers.authorization = `Bearer ${this.auth.apiKey}`;
 
 		const tp = activeTraceContext();
 		if (tp) {
@@ -452,7 +453,7 @@ export class Transport {
 		let attempt = 0;
 
 		while (true) {
-			const headers = await this.buildHeaders();
+			const headers = this.buildHeaders();
 			const controller = new AbortController();
 			const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
 
@@ -495,16 +496,28 @@ export class Transport {
 				let json: ApiEnvelope<T> | undefined;
 				const text = await response.text();
 
-				try {
-					json = JSON.parse(text) as ApiEnvelope<T>;
-				} catch {
-					// Not a JSON body — treat as generic API error
-					throw mapHttpError(
-						response.status,
-						null,
-						text || response.statusText,
-						response.headers,
-					);
+				if (text === "" && response.ok) {
+					// A successful empty body (e.g. 204): synthesize an empty-data
+					// envelope rather than mis-mapping it to an API error.
+					json = {
+						success: true,
+						code: response.status,
+						data: null,
+						error: null,
+						pagination: null,
+					} as ApiEnvelope<T>;
+				} else {
+					try {
+						json = JSON.parse(text) as ApiEnvelope<T>;
+					} catch {
+						// Not a JSON body — treat as generic API error
+						throw mapHttpError(
+							response.status,
+							null,
+							text || response.statusText,
+							response.headers,
+						);
+					}
 				}
 
 				if (!response.ok) {
@@ -554,7 +567,7 @@ export class Transport {
 				const isTimeout =
 					err instanceof DOMException && err.name === "AbortError";
 				// Only retry on genuine network failures (fetch throws TypeError) or timeouts.
-				// Unexpected errors (e.g. getAccessToken rejections) propagate immediately.
+				// Other unexpected errors propagate immediately.
 				const isNetworkError = err instanceof TypeError;
 
 				if (

package/dist/prompts/cache.d.ts

@@ -1,58 +0,0 @@
-import type { RenderedPrompt } from "./types";
-export interface CacheConfig {
-    /** Time-to-live in seconds. Default: 300 (5 minutes) */
-    ttlSeconds?: number;
-    /** Maximum number of entries. Default: 100 */
-    maxEntries?: number;
-}
-/**
- * The cache stores enriched `render()` results, which are JSON-cloneable.
- */
-export type CacheableRendered = RenderedPrompt;
-/**
- * Build a canonical base cache key from project/slug/labels/variables.
- *
- * - projectId is included to prevent cross-project cache collisions: a single
- *   PromptResource can serve multiple projects, so the same slug+labels must
- *   not share a cache entry across different projects.
- * - Labels are sorted alphabetically so ["production", "en"] and ["en", "production"]
- *   map to the same key.
- * - Variables are canonicalized with deterministic sorted-keys JSON before hashing.
- * - Each segment is JSON-encoded so that separator characters in slug or label
- *   values cannot cause key collisions (e.g. a slug containing "|" or ",").
- */
-export declare function buildCacheKey(projectId: string, slug: string, labels: string[], variables?: Record<string, unknown>): string;
-/**
- * Build a cache key for an env-aware `render()` call.
- *
- * Folds in `env` and `subject` ON TOP of the base
- * project/slug/labels/variables key so two calls that differ only by
- * env/subject do not return a stale cross-env / cross-cohort hit
- * (spec §3 "Caching key changes"). The env slug is also forwarded as the
- * single resolution label (env→label mapping, correction #3), so it appears
- * in the `labels` segment too; including it explicitly here keeps the key
- * unambiguous and self-documenting.
- *
- * `subject` participates in the key so a `subject`-keyed weighted assignment
- * caches as the same deterministic variant on repeat (D8); the
- * weighted-no-subject bypass is handled in the resource, not here.
- */
-export declare function buildRenderCacheKey(projectId: string, slug: string, env: string, subject?: string, variables?: Record<string, unknown>): string;
-/**
- * In-memory LRU cache for RenderedPrompt objects.
- *
- * Uses a Map (insertion-ordered) as the backing store. On every access, the
- * entry is deleted and re-inserted to maintain LRU order — oldest entries sit
- * at the front of the Map.
- */
-export declare class PromptCache {
-    private readonly ttlMs;
-    private readonly maxEntries;
-    private readonly store;
-    constructor(config?: CacheConfig);
-    get(key: string): CacheableRendered | undefined;
-    set(key: string, value: CacheableRendered): void;
-    delete(key: string): void;
-    clear(): void;
-    get size(): number;
-}

package/dist/routingRules/resource.cjs

@@ -1,138 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-function __accessProp(key) {
-  return this[key];
-}
-var __toCommonJS = (from) => {
-  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (var key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(entry, key))
-        __defProp(entry, key, {
-          get: __accessProp.bind(from, key),
-          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-        });
-  }
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __moduleCache;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: __exportSetter.bind(all, name)
-    });
-};
-
-// src/routingRules/resource.ts
-var exports_resource = {};
-__export(exports_resource, {
-  RoutingRulesResource: () => RoutingRulesResource,
-  RoutingRuleVersionResource: () => RoutingRuleVersionResource,
-  RoutingRuleReleaseResource: () => RoutingRuleReleaseResource
-});
-module.exports = __toCommonJS(exports_resource);
-var import_zod = require("zod");
-var import_zod2 = require("../generated/zod.gen");
-function unwrap(envelope) {
-  if (envelope.data === null || envelope.data === undefined) {
-    throw new Error("API returned success but data is null");
-  }
-  return envelope.data;
-}
-function rulePath(projectId, ruleId) {
-  return `/v1/projects/${encodeURIComponent(projectId)}/routing/rules/${encodeURIComponent(ruleId)}`;
-}
-function versionsPath(projectId, ruleId) {
-  return `${rulePath(projectId, ruleId)}/versions`;
-}
-function versionPath(projectId, ruleId, versionId) {
-  return `${versionsPath(projectId, ruleId)}/${encodeURIComponent(versionId)}`;
-}
-function releasesPath(projectId, ruleId) {
-  return `${rulePath(projectId, ruleId)}/releases`;
-}
-function releasePath(projectId, ruleId, envSlug) {
-  return `${releasesPath(projectId, ruleId)}/${encodeURIComponent(envSlug)}`;
-}
-function releaseRollbackPath(projectId, ruleId, envSlug) {
-  return `${releasePath(projectId, ruleId, envSlug)}/rollback`;
-}
-
-class RoutingRuleVersionResource {
-  transport;
-  constructor(transport) {
-    this.transport = transport;
-  }
-  async create(input) {
-    const { projectId, ruleId, ...body } = input;
-    const envelope = await this.transport.request("POST", versionsPath(projectId, ruleId), { body });
-    return unwrap(envelope);
-  }
-  async list(input) {
-    const query = {};
-    if (input.cursor !== undefined)
-      query.cursor = input.cursor;
-    if (input.limit !== undefined)
-      query.limit = input.limit;
-    const envelope = await this.transport.request("GET", versionsPath(input.projectId, input.ruleId), { query });
-    return unwrap(envelope);
-  }
-  async get(input) {
-    const envelope = await this.transport.request("GET", versionPath(input.projectId, input.ruleId, input.versionId), {
-      decode: (data) => import_zod2.zRuleVersion.parse(data)
-    });
-    return unwrap(envelope);
-  }
-}
-
-class RoutingRuleReleaseResource {
-  transport;
-  constructor(transport) {
-    this.transport = transport;
-  }
-  async set(input) {
-    const { projectId, ruleId, envSlug, ...body } = input;
-    const envelope = await this.transport.request("PUT", releasePath(projectId, ruleId, envSlug), { body });
-    return unwrap(envelope);
-  }
-  async rollback(input) {
-    const { projectId, ruleId, envSlug, ...body } = input;
-    const envelope = await this.transport.request("POST", releaseRollbackPath(projectId, ruleId, envSlug), { body });
-    return unwrap(envelope);
-  }
-  async list(input) {
-    const query = {};
-    if (input.cursor !== undefined)
-      query.cursor = input.cursor;
-    if (input.limit !== undefined)
-      query.limit = input.limit;
-    const path = input.envSlug !== undefined ? releasePath(input.projectId, input.ruleId, input.envSlug) : releasesPath(input.projectId, input.ruleId);
-    const envelope = await this.transport.request("GET", path, {
-      query,
-      decode: (data) => import_zod.z.array(import_zod2.zRuleRelease).parse(data)
-    });
-    return unwrap(envelope);
-  }
-}
-
-class RoutingRulesResource {
-  versions;
-  releases;
-  constructor(transport) {
-    this.versions = new RoutingRuleVersionResource(transport);
-    this.releases = new RoutingRuleReleaseResource(transport);
-  }
-}

package/dist/routingRules/resource.js

@@ -1,98 +0,0 @@
-// src/routingRules/resource.ts
-import { z } from "zod";
-import { zRuleRelease, zRuleVersion } from "../generated/zod.gen";
-function unwrap(envelope) {
-  if (envelope.data === null || envelope.data === undefined) {
-    throw new Error("API returned success but data is null");
-  }
-  return envelope.data;
-}
-function rulePath(projectId, ruleId) {
-  return `/v1/projects/${encodeURIComponent(projectId)}/routing/rules/${encodeURIComponent(ruleId)}`;
-}
-function versionsPath(projectId, ruleId) {
-  return `${rulePath(projectId, ruleId)}/versions`;
-}
-function versionPath(projectId, ruleId, versionId) {
-  return `${versionsPath(projectId, ruleId)}/${encodeURIComponent(versionId)}`;
-}
-function releasesPath(projectId, ruleId) {
-  return `${rulePath(projectId, ruleId)}/releases`;
-}
-function releasePath(projectId, ruleId, envSlug) {
-  return `${releasesPath(projectId, ruleId)}/${encodeURIComponent(envSlug)}`;
-}
-function releaseRollbackPath(projectId, ruleId, envSlug) {
-  return `${releasePath(projectId, ruleId, envSlug)}/rollback`;
-}
-
-class RoutingRuleVersionResource {
-  transport;
-  constructor(transport) {
-    this.transport = transport;
-  }
-  async create(input) {
-    const { projectId, ruleId, ...body } = input;
-    const envelope = await this.transport.request("POST", versionsPath(projectId, ruleId), { body });
-    return unwrap(envelope);
-  }
-  async list(input) {
-    const query = {};
-    if (input.cursor !== undefined)
-      query.cursor = input.cursor;
-    if (input.limit !== undefined)
-      query.limit = input.limit;
-    const envelope = await this.transport.request("GET", versionsPath(input.projectId, input.ruleId), { query });
-    return unwrap(envelope);
-  }
-  async get(input) {
-    const envelope = await this.transport.request("GET", versionPath(input.projectId, input.ruleId, input.versionId), {
-      decode: (data) => zRuleVersion.parse(data)
-    });
-    return unwrap(envelope);
-  }
-}
-
-class RoutingRuleReleaseResource {
-  transport;
-  constructor(transport) {
-    this.transport = transport;
-  }
-  async set(input) {
-    const { projectId, ruleId, envSlug, ...body } = input;
-    const envelope = await this.transport.request("PUT", releasePath(projectId, ruleId, envSlug), { body });
-    return unwrap(envelope);
-  }
-  async rollback(input) {
-    const { projectId, ruleId, envSlug, ...body } = input;
-    const envelope = await this.transport.request("POST", releaseRollbackPath(projectId, ruleId, envSlug), { body });
-    return unwrap(envelope);
-  }
-  async list(input) {
-    const query = {};
-    if (input.cursor !== undefined)
-      query.cursor = input.cursor;
-    if (input.limit !== undefined)
-      query.limit = input.limit;
-    const path = input.envSlug !== undefined ? releasePath(input.projectId, input.ruleId, input.envSlug) : releasesPath(input.projectId, input.ruleId);
-    const envelope = await this.transport.request("GET", path, {
-      query,
-      decode: (data) => z.array(zRuleRelease).parse(data)
-    });
-    return unwrap(envelope);
-  }
-}
-
-class RoutingRulesResource {
-  versions;
-  releases;
-  constructor(transport) {
-    this.versions = new RoutingRuleVersionResource(transport);
-    this.releases = new RoutingRuleReleaseResource(transport);
-  }
-}
-export {
-  RoutingRulesResource,
-  RoutingRuleVersionResource,
-  RoutingRuleReleaseResource
-};

package/src/prompts/cache.ts

@@ -1,153 +0,0 @@
-import type { RenderedPrompt } from "./types";
-
-export interface CacheConfig {
-	/** Time-to-live in seconds. Default: 300 (5 minutes) */
-	ttlSeconds?: number;
-	/** Maximum number of entries. Default: 100 */
-	maxEntries?: number;
-}
-
-/**
- * The cache stores enriched `render()` results, which are JSON-cloneable.
- */
-export type CacheableRendered = RenderedPrompt;
-
-interface CacheEntry {
-	value: CacheableRendered;
-	expiresAt: number;
-}
-
-/**
- * Build a canonical base cache key from project/slug/labels/variables.
- *
- * - projectId is included to prevent cross-project cache collisions: a single
- *   PromptResource can serve multiple projects, so the same slug+labels must
- *   not share a cache entry across different projects.
- * - Labels are sorted alphabetically so ["production", "en"] and ["en", "production"]
- *   map to the same key.
- * - Variables are canonicalized with deterministic sorted-keys JSON before hashing.
- * - Each segment is JSON-encoded so that separator characters in slug or label
- *   values cannot cause key collisions (e.g. a slug containing "|" or ",").
- */
-export function buildCacheKey(
-	projectId: string,
-	slug: string,
-	labels: string[],
-	variables?: Record<string, unknown>,
-): string {
-	const sortedLabels = [...labels].sort();
-	const varsPart =
-		variables !== undefined ? JSON.stringify(sortObjectKeys(variables)) : null;
-	// JSON.stringify each segment to prevent separator-character collisions
-	return `${JSON.stringify(projectId)}|${JSON.stringify(slug)}|${JSON.stringify(sortedLabels)}|${JSON.stringify(varsPart)}`;
-}
-
-/**
- * Build a cache key for an env-aware `render()` call.
- *
- * Folds in `env` and `subject` ON TOP of the base
- * project/slug/labels/variables key so two calls that differ only by
- * env/subject do not return a stale cross-env / cross-cohort hit
- * (spec §3 "Caching key changes"). The env slug is also forwarded as the
- * single resolution label (env→label mapping, correction #3), so it appears
- * in the `labels` segment too; including it explicitly here keeps the key
- * unambiguous and self-documenting.
- *
- * `subject` participates in the key so a `subject`-keyed weighted assignment
- * caches as the same deterministic variant on repeat (D8); the
- * weighted-no-subject bypass is handled in the resource, not here.
- */
-export function buildRenderCacheKey(
-	projectId: string,
-	slug: string,
-	env: string,
-	subject?: string,
-	variables?: Record<string, unknown>,
-): string {
-	const base = buildCacheKey(projectId, slug, [env], variables);
-	return `render|${base}|${JSON.stringify(env)}|${JSON.stringify(subject ?? null)}`;
-}
-
-function sortObjectKeys(obj: unknown): unknown {
-	if (obj === null || typeof obj !== "object") return obj;
-	if (Array.isArray(obj)) return obj.map(sortObjectKeys);
-	const sorted: Record<string, unknown> = {};
-	for (const key of Object.keys(obj as Record<string, unknown>).sort()) {
-		sorted[key] = sortObjectKeys((obj as Record<string, unknown>)[key]);
-	}
-	return sorted;
-}
-
-/**
- * In-memory LRU cache for RenderedPrompt objects.
- *
- * Uses a Map (insertion-ordered) as the backing store. On every access, the
- * entry is deleted and re-inserted to maintain LRU order — oldest entries sit
- * at the front of the Map.
- */
-export class PromptCache {
-	private readonly ttlMs: number;
-	private readonly maxEntries: number;
-	private readonly store: Map<string, CacheEntry>;
-
-	constructor(config?: CacheConfig) {
-		this.ttlMs = (config?.ttlSeconds ?? 300) * 1000;
-		this.maxEntries = config?.maxEntries ?? 100;
-		this.store = new Map();
-	}
-
-	get(key: string): CacheableRendered | undefined {
-		const entry = this.store.get(key);
-		if (!entry) return undefined;
-
-		if (Date.now() > entry.expiresAt) {
-			this.store.delete(key);
-			return undefined;
-		}
-
-		// Refresh LRU order — move to end
-		this.store.delete(key);
-		this.store.set(key, entry);
-
-		return entry.value;
-	}
-
-	set(key: string, value: CacheableRendered): void {
-		// maxEntries: 0 (or negative) means caching is disabled — drop the entry.
-		if (this.maxEntries <= 0) {
-			return;
-		}
-
-		// Remove existing entry so re-insertion moves it to the end
-		if (this.store.has(key)) {
-			this.store.delete(key);
-		}
-
-		// Evict least-recently-used entry if at capacity
-		while (this.store.size >= this.maxEntries) {
-			const lruKey = this.store.keys().next().value;
-			if (lruKey !== undefined) {
-				this.store.delete(lruKey);
-			} else {
-				break;
-			}
-		}
-
-		this.store.set(key, {
-			value,
-			expiresAt: Date.now() + this.ttlMs,
-		});
-	}
-
-	delete(key: string): void {
-		this.store.delete(key);
-	}
-
-	clear(): void {
-		this.store.clear();
-	}
-
-	get size(): number {
-		return this.store.size;
-	}
-}