@happyvertical/ai 0.80.0 → 0.80.1

package/dist/chunks/rate-limit-BwyPGXFW.js

@@ -0,0 +1,199 @@
+import { s as RateLimitError } from "./types-FHs-KbGL.js";
+//#region src/shared/rate-limit.ts
+var RATE_LIMITED_METHODS = /* @__PURE__ */ new Set([
+	"chat",
+	"complete",
+	"message",
+	"embed",
+	"embedImage",
+	"describeImage",
+	"generateImage",
+	"getModels",
+	"synthesizeSpeech",
+	"cloneVoice",
+	"designVoice",
+	"getVoices"
+]);
+var MAX_BUDGET_COORDINATORS = 128;
+var BUDGET_COORDINATOR_TTL_MS = 900 * 1e3;
+var BudgetCoordinator = class {
+	nextAvailableAt = 0;
+	pendingSchedules = 0;
+	tail = Promise.resolve();
+	lastUsedAt = Date.now();
+	touch() {
+		this.lastUsedAt = Date.now();
+	}
+	schedule(work) {
+		this.pendingSchedules += 1;
+		this.touch();
+		const run = this.tail.then(work, work);
+		this.tail = run.then(() => void 0, () => void 0);
+		return run.finally(() => {
+			this.pendingSchedules = Math.max(0, this.pendingSchedules - 1);
+			this.touch();
+		});
+	}
+	async waitUntilReady() {
+		this.touch();
+		const delayMs = this.nextAvailableAt - Date.now();
+		if (delayMs > 0) await sleep(delayMs);
+	}
+	delayFor(delayMs) {
+		this.touch();
+		if (delayMs <= 0) return;
+		this.nextAvailableAt = Math.max(this.nextAvailableAt, Date.now() + delayMs);
+	}
+	isEvictable(now) {
+		return this.pendingSchedules === 0 && now >= this.nextAvailableAt;
+	}
+	isExpired(now) {
+		return this.isEvictable(now) && now - this.lastUsedAt >= BUDGET_COORDINATOR_TTL_MS;
+	}
+	getLastUsedAt() {
+		return this.lastUsedAt;
+	}
+};
+var budgetCoordinators = /* @__PURE__ */ new Map();
+function sleep(delayMs) {
+	return new Promise((resolve) => {
+		setTimeout(resolve, delayMs);
+	});
+}
+function pruneBudgetCoordinators() {
+	const now = Date.now();
+	for (const [key, coordinator] of budgetCoordinators.entries()) if (coordinator.isExpired(now)) budgetCoordinators.delete(key);
+	while (budgetCoordinators.size > MAX_BUDGET_COORDINATORS) {
+		const evictableEntries = [...budgetCoordinators.entries()].filter(([, coordinator]) => coordinator.isEvictable(now)).sort(([, leftCoordinator], [, rightCoordinator]) => leftCoordinator.getLastUsedAt() - rightCoordinator.getLastUsedAt());
+		if (evictableEntries.length === 0) break;
+		budgetCoordinators.delete(evictableEntries[0][0]);
+	}
+}
+function getBudgetCoordinator(key) {
+	pruneBudgetCoordinators();
+	let coordinator = budgetCoordinators.get(key);
+	if (!coordinator) {
+		coordinator = new BudgetCoordinator();
+		budgetCoordinators.set(key, coordinator);
+		pruneBudgetCoordinators();
+	}
+	coordinator.touch();
+	return coordinator;
+}
+function hasPacingConfig(rateLimit) {
+	if (!rateLimit || rateLimit.enabled === false) return false;
+	return rateLimit.enabled === true || rateLimit.key !== void 0 || rateLimit.cooldownMs !== void 0 || rateLimit.initialDelayMs !== void 0 || rateLimit.maxAttempts !== void 0;
+}
+function normalizeNonNegativeInteger(value, fallback) {
+	if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
+	return Math.max(0, Math.trunc(value));
+}
+function hashKey(value) {
+	let hash = 2166136261;
+	for (let index = 0; index < value.length; index += 1) {
+		hash ^= value.charCodeAt(index);
+		hash = Math.imul(hash, 16777619);
+	}
+	return (hash >>> 0).toString(36);
+}
+function deriveBudgetKey(options) {
+	const type = options.type;
+	const provider = typeof type === "string" && type ? type : "openai";
+	const seed = [
+		"apiKey" in options ? options.apiKey : void 0,
+		"apiToken" in options ? options.apiToken : void 0,
+		"credentials" in options ? options.credentials?.accessKeyId : void 0,
+		"endpoint" in options ? options.endpoint : void 0,
+		"baseUrl" in options ? options.baseUrl : void 0,
+		"cliPath" in options ? options.cliPath : void 0
+	].find((value) => typeof value === "string" && value.length > 0);
+	return seed ? `${provider}:${hashKey(seed)}` : `${provider}:default`;
+}
+function normalizeRateLimitConfig(options) {
+	const rateLimit = "rateLimit" in options ? options.rateLimit : void 0;
+	if (!hasPacingConfig(rateLimit)) return null;
+	return {
+		cooldownMs: normalizeNonNegativeInteger(rateLimit?.cooldownMs, 0),
+		initialDelayMs: normalizeNonNegativeInteger(rateLimit?.initialDelayMs, 5e3),
+		key: rateLimit?.key?.trim() || deriveBudgetKey(options),
+		maxAttempts: Math.max(1, normalizeNonNegativeInteger(rateLimit?.maxAttempts, 1))
+	};
+}
+function getRetryDelayMs(error, config) {
+	const hintedDelayMs = typeof error.retryAfter === "number" && Number.isFinite(error.retryAfter) ? Math.max(0, Math.ceil(error.retryAfter * 1e3)) : void 0;
+	if (hintedDelayMs !== void 0) return Math.max(config.cooldownMs, hintedDelayMs);
+	return Math.max(config.cooldownMs, config.initialDelayMs);
+}
+async function invokeWithPacing(execute, coordinator, config) {
+	let attempt = 1;
+	while (true) {
+		await coordinator.waitUntilReady();
+		try {
+			const result = await execute();
+			coordinator.delayFor(config.cooldownMs);
+			return result;
+		} catch (error) {
+			if (error instanceof RateLimitError) {
+				coordinator.delayFor(getRetryDelayMs(error, config));
+				if (error.retryable && attempt < config.maxAttempts) {
+					attempt += 1;
+					continue;
+				}
+			}
+			throw error;
+		}
+	}
+}
+function parseRetryAfterSeconds(retryAfter) {
+	if (typeof retryAfter === "number" && Number.isFinite(retryAfter)) return Math.max(0, retryAfter);
+	if (typeof retryAfter !== "string") return;
+	const trimmed = retryAfter.trim();
+	if (!trimmed) return;
+	const seconds = Number.parseFloat(trimmed);
+	if (!Number.isNaN(seconds)) return Math.max(0, seconds);
+	const retryAt = Date.parse(trimmed);
+	if (Number.isNaN(retryAt)) return;
+	return Math.max(0, Math.ceil((retryAt - Date.now()) / 1e3));
+}
+function getHeaderValue(headers, headerName) {
+	if (!headers || typeof headers !== "object") return;
+	if ("get" in headers && typeof headers.get === "function") return headers.get(headerName) ?? headers.get(headerName.toLowerCase());
+	const objectHeaders = headers;
+	return objectHeaders[headerName] ?? objectHeaders[headerName.toLowerCase()];
+}
+function extractRetryAfterSeconds(error) {
+	if (!error || typeof error !== "object") return;
+	if ("retryAfter" in error) {
+		const retryAfter = parseRetryAfterSeconds(error.retryAfter);
+		if (retryAfter !== void 0) return retryAfter;
+	}
+	if ("headers" in error) {
+		const retryAfter = parseRetryAfterSeconds(getHeaderValue(error.headers, "retry-after"));
+		if (retryAfter !== void 0) return retryAfter;
+	}
+	const message = "message" in error && typeof error.message === "string" ? error.message : "";
+	const retryAfterMatch = message.match(/retry after\s+(\d+(?:\.\d+)?)\s*s?/i) ?? message.match(/retryDelay[^\d]*(\d+(?:\.\d+)?)s/i);
+	return retryAfterMatch ? parseRetryAfterSeconds(retryAfterMatch[1]) : void 0;
+}
+function createRateLimitedAI(client, options) {
+	const config = normalizeRateLimitConfig(options);
+	if (!config) return client;
+	const wrappedMethods = /* @__PURE__ */ new Map();
+	return new Proxy(client, { get(target, property, receiver) {
+		const value = Reflect.get(target, property, receiver);
+		if (typeof value !== "function") return value;
+		if (!RATE_LIMITED_METHODS.has(property)) {
+			if (!wrappedMethods.has(property)) wrappedMethods.set(property, value.bind(target));
+			return wrappedMethods.get(property);
+		}
+		if (!wrappedMethods.has(property)) wrappedMethods.set(property, (...args) => {
+			const coordinator = getBudgetCoordinator(config.key);
+			return coordinator.schedule(() => invokeWithPacing(() => Reflect.apply(value, target, args), coordinator, config));
+		});
+		return wrappedMethods.get(property);
+	} });
+}
+//#endregion
+export { extractRetryAfterSeconds as n, createRateLimitedAI as t };
+
+//# sourceMappingURL=rate-limit-BwyPGXFW.js.map

package/dist/chunks/rate-limit-BwyPGXFW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-BwyPGXFW.js","names":[],"sources":["../../src/shared/rate-limit.ts"],"sourcesContent":["import type { AIClientOptions } from './client';\nimport type { AIInterface, AIRateLimitOptions, GetAIOptions } from './types';\nimport { AIError, RateLimitError } from './types';\n\nconst RATE_LIMITED_METHODS = new Set<keyof AIInterface>([\n  'chat',\n  'complete',\n  'message',\n  'embed',\n  'embedImage',\n  'describeImage',\n  'generateImage',\n  'getModels',\n  'synthesizeSpeech',\n  'cloneVoice',\n  'designVoice',\n  'getVoices',\n]);\n\nconst MAX_BUDGET_COORDINATORS = 128;\nconst BUDGET_COORDINATOR_TTL_MS = 15 * 60 * 1000;\n\ninterface NormalizedRateLimitConfig {\n  cooldownMs: number;\n  initialDelayMs: number;\n  key: string;\n  maxAttempts: number;\n}\n\nclass BudgetCoordinator {\n  private nextAvailableAt = 0;\n  private pendingSchedules = 0;\n  private tail: Promise<void> = Promise.resolve();\n  private lastUsedAt = Date.now();\n\n  touch(): void {\n    this.lastUsedAt = Date.now();\n  }\n\n  schedule<T>(work: () => Promise<T>): Promise<T> {\n    this.pendingSchedules += 1;\n    this.touch();\n\n    const run = this.tail.then(work, work);\n    this.tail = run.then(\n      () => undefined,\n      () => undefined,\n    );\n\n    return run.finally(() => {\n      this.pendingSchedules = Math.max(0, this.pendingSchedules - 1);\n      this.touch();\n    });\n  }\n\n  async waitUntilReady(): Promise<void> {\n    this.touch();\n    const delayMs = this.nextAvailableAt - Date.now();\n    if (delayMs > 0) {\n      await sleep(delayMs);\n    }\n  }\n\n  delayFor(delayMs: number): void {\n    this.touch();\n    if (delayMs <= 0) {\n      return;\n    }\n\n    this.nextAvailableAt = Math.max(this.nextAvailableAt, Date.now() + delayMs);\n  }\n\n  isEvictable(now: number): boolean {\n    return this.pendingSchedules === 0 && now >= this.nextAvailableAt;\n  }\n\n  isExpired(now: number): boolean {\n    return (\n      this.isEvictable(now) &&\n      now - this.lastUsedAt >= BUDGET_COORDINATOR_TTL_MS\n    );\n  }\n\n  getLastUsedAt(): number {\n    return this.lastUsedAt;\n  }\n}\n\nconst budgetCoordinators = new Map<string, BudgetCoordinator>();\n\nfunction sleep(delayMs: number): Promise<void> {\n  return new Promise((resolve) => {\n    setTimeout(resolve, delayMs);\n  });\n}\n\nfunction pruneBudgetCoordinators(): void {\n  const now = Date.now();\n\n  for (const [key, coordinator] of budgetCoordinators.entries()) {\n    if (coordinator.isExpired(now)) {\n      budgetCoordinators.delete(key);\n    }\n  }\n\n  while (budgetCoordinators.size > MAX_BUDGET_COORDINATORS) {\n    const evictableEntries = [...budgetCoordinators.entries()]\n      .filter(([, coordinator]) => coordinator.isEvictable(now))\n      .sort(\n        ([, leftCoordinator], [, rightCoordinator]) =>\n          leftCoordinator.getLastUsedAt() - rightCoordinator.getLastUsedAt(),\n      );\n\n    if (evictableEntries.length === 0) {\n      break;\n    }\n\n    budgetCoordinators.delete(evictableEntries[0][0]);\n  }\n}\n\nfunction getBudgetCoordinator(key: string): BudgetCoordinator {\n  pruneBudgetCoordinators();\n\n  let coordinator = budgetCoordinators.get(key);\n  if (!coordinator) {\n    coordinator = new BudgetCoordinator();\n    budgetCoordinators.set(key, coordinator);\n    pruneBudgetCoordinators();\n  }\n\n  coordinator.touch();\n  return coordinator;\n}\n\nfunction hasPacingConfig(rateLimit?: AIRateLimitOptions): boolean {\n  if (!rateLimit || rateLimit.enabled === false) {\n    return false;\n  }\n\n  return (\n    rateLimit.enabled === true ||\n    rateLimit.key !== undefined ||\n    rateLimit.cooldownMs !== undefined ||\n    rateLimit.initialDelayMs !== undefined ||\n    rateLimit.maxAttempts !== undefined\n  );\n}\n\nfunction normalizeNonNegativeInteger(\n  value: number | undefined,\n  fallback: number,\n): number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    return fallback;\n  }\n\n  return Math.max(0, Math.trunc(value));\n}\n\nfunction hashKey(value: string): string {\n  let hash = 2166136261;\n\n  for (let index = 0; index < value.length; index += 1) {\n    hash ^= value.charCodeAt(index);\n    hash = Math.imul(hash, 16777619);\n  }\n\n  return (hash >>> 0).toString(36);\n}\n\nfunction deriveBudgetKey(options: GetAIOptions | AIClientOptions): string {\n  const type = (options as { type?: string }).type;\n  const provider = typeof type === 'string' && type ? type : 'openai';\n\n  const credentialLikeValues = [\n    'apiKey' in options ? options.apiKey : undefined,\n    'apiToken' in options ? options.apiToken : undefined,\n    'credentials' in options ? options.credentials?.accessKeyId : undefined,\n    'endpoint' in options ? options.endpoint : undefined,\n    'baseUrl' in options ? options.baseUrl : undefined,\n    'cliPath' in options ? options.cliPath : undefined,\n  ];\n\n  const seed = credentialLikeValues.find(\n    (value): value is string => typeof value === 'string' && value.length > 0,\n  );\n\n  return seed ? `${provider}:${hashKey(seed)}` : `${provider}:default`;\n}\n\nfunction normalizeRateLimitConfig(\n  options: GetAIOptions | AIClientOptions,\n): NormalizedRateLimitConfig | null {\n  const rateLimit = 'rateLimit' in options ? options.rateLimit : undefined;\n\n  if (!hasPacingConfig(rateLimit)) {\n    return null;\n  }\n\n  return {\n    cooldownMs: normalizeNonNegativeInteger(rateLimit?.cooldownMs, 0),\n    initialDelayMs: normalizeNonNegativeInteger(\n      rateLimit?.initialDelayMs,\n      5000,\n    ),\n    key: rateLimit?.key?.trim() || deriveBudgetKey(options),\n    maxAttempts: Math.max(\n      1,\n      normalizeNonNegativeInteger(rateLimit?.maxAttempts, 1),\n    ),\n  };\n}\n\nfunction getRetryDelayMs(\n  error: RateLimitError,\n  config: NormalizedRateLimitConfig,\n): number {\n  const hintedDelayMs =\n    typeof error.retryAfter === 'number' && Number.isFinite(error.retryAfter)\n      ? Math.max(0, Math.ceil(error.retryAfter * 1000))\n      : undefined;\n\n  if (hintedDelayMs !== undefined) {\n    return Math.max(config.cooldownMs, hintedDelayMs);\n  }\n\n  return Math.max(config.cooldownMs, config.initialDelayMs);\n}\n\nasync function invokeWithPacing<T>(\n  execute: () => Promise<T>,\n  coordinator: BudgetCoordinator,\n  config: NormalizedRateLimitConfig,\n): Promise<T> {\n  let attempt = 1;\n\n  while (true) {\n    await coordinator.waitUntilReady();\n\n    try {\n      const result = await execute();\n      coordinator.delayFor(config.cooldownMs);\n      return result;\n    } catch (error) {\n      if (error instanceof RateLimitError) {\n        coordinator.delayFor(getRetryDelayMs(error, config));\n\n        if (error.retryable && attempt < config.maxAttempts) {\n          attempt += 1;\n          continue;\n        }\n      }\n\n      throw error;\n    }\n  }\n}\n\nexport function parseRetryAfterSeconds(\n  retryAfter: number | string | null | undefined,\n): number | undefined {\n  if (typeof retryAfter === 'number' && Number.isFinite(retryAfter)) {\n    return Math.max(0, retryAfter);\n  }\n\n  if (typeof retryAfter !== 'string') {\n    return undefined;\n  }\n\n  const trimmed = retryAfter.trim();\n  if (!trimmed) {\n    return undefined;\n  }\n\n  const seconds = Number.parseFloat(trimmed);\n  if (!Number.isNaN(seconds)) {\n    return Math.max(0, seconds);\n  }\n\n  const retryAt = Date.parse(trimmed);\n  if (Number.isNaN(retryAt)) {\n    return undefined;\n  }\n\n  return Math.max(0, Math.ceil((retryAt - Date.now()) / 1000));\n}\n\nfunction getHeaderValue(\n  headers: unknown,\n  headerName: string,\n): number | string | undefined {\n  if (!headers || typeof headers !== 'object') {\n    return undefined;\n  }\n\n  if ('get' in headers && typeof headers.get === 'function') {\n    return headers.get(headerName) ?? headers.get(headerName.toLowerCase());\n  }\n\n  const objectHeaders = headers as Record<string, number | string | undefined>;\n  return objectHeaders[headerName] ?? objectHeaders[headerName.toLowerCase()];\n}\n\nexport function extractRetryAfterSeconds(error: unknown): number | undefined {\n  if (!error || typeof error !== 'object') {\n    return undefined;\n  }\n\n  if ('retryAfter' in error) {\n    const retryAfter = parseRetryAfterSeconds(\n      (error as { retryAfter?: number | string | null }).retryAfter,\n    );\n    if (retryAfter !== undefined) {\n      return retryAfter;\n    }\n  }\n\n  if ('headers' in error) {\n    const retryAfter = parseRetryAfterSeconds(\n      getHeaderValue((error as { headers?: unknown }).headers, 'retry-after'),\n    );\n    if (retryAfter !== undefined) {\n      return retryAfter;\n    }\n  }\n\n  const message =\n    'message' in error && typeof error.message === 'string'\n      ? error.message\n      : '';\n\n  const retryAfterMatch =\n    message.match(/retry after\\s+(\\d+(?:\\.\\d+)?)\\s*s?/i) ??\n    message.match(/retryDelay[^\\d]*(\\d+(?:\\.\\d+)?)s/i);\n\n  return retryAfterMatch\n    ? parseRetryAfterSeconds(retryAfterMatch[1])\n    : undefined;\n}\n\nexport function createRateLimitedAI<T extends AIInterface>(\n  client: T,\n  options: GetAIOptions | AIClientOptions,\n): T {\n  const config = normalizeRateLimitConfig(options);\n  if (!config) {\n    return client;\n  }\n\n  const wrappedMethods = new Map<PropertyKey, unknown>();\n\n  return new Proxy(client, {\n    get(target, property, receiver) {\n      const value = Reflect.get(target, property, receiver);\n\n      if (typeof value !== 'function') {\n        return value;\n      }\n\n      if (!RATE_LIMITED_METHODS.has(property as keyof AIInterface)) {\n        if (!wrappedMethods.has(property)) {\n          wrappedMethods.set(property, value.bind(target));\n        }\n\n        return wrappedMethods.get(property);\n      }\n\n      if (!wrappedMethods.has(property)) {\n        wrappedMethods.set(property, (...args: unknown[]) => {\n          const coordinator = getBudgetCoordinator(config.key);\n          return coordinator.schedule(() =>\n            invokeWithPacing(\n              () => Reflect.apply(value, target, args) as Promise<unknown>,\n              coordinator,\n              config,\n            ),\n          );\n        });\n      }\n\n      return wrappedMethods.get(property);\n    },\n  }) as T;\n}\n\nexport function __resetAIRateLimitStateForTests(): void {\n  budgetCoordinators.clear();\n}\n\nexport function __getAIRateLimitStateForTests(): {\n  count: number;\n  maxBudgetCoordinators: number;\n  ttlMs: number;\n} {\n  return {\n    count: budgetCoordinators.size,\n    maxBudgetCoordinators: MAX_BUDGET_COORDINATORS,\n    ttlMs: BUDGET_COORDINATOR_TTL_MS,\n  };\n}\n\nexport function isRetryableAIError(error: unknown): error is AIError {\n  return error instanceof AIError && error.retryable;\n}\n"],"mappings":"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"}

package/dist/chunks/safety-CEnoJS6X.js

@@ -0,0 +1,260 @@
+import { t as AIError } from "./types-FHs-KbGL.js";
+//#region src/shared/safety.ts
+var DEFAULT_AI_TIMEOUT_MS = 12e4;
+var DEFAULT_AI_MAX_RETRIES = 0;
+var DEFAULT_AI_GENERATION_LIMITS = Object.freeze({
+	maxOutputTokens: 4096,
+	maxReasoningTokens: 1024,
+	maxImagesPerRequest: 1,
+	onExceeded: "error"
+});
+function positiveInteger(value, fallback, field) {
+	if (value === void 0) return fallback;
+	if (!Number.isFinite(value) || value <= 0) throw new AIError(`${field} must be a positive finite number`, "AI_LIMIT_INVALID");
+	return Math.trunc(value);
+}
+function normalizeBaseAIOptions(options) {
+	const configuredLimits = options.generationLimits || {};
+	const generationLimits = {
+		maxOutputTokens: positiveInteger(configuredLimits.maxOutputTokens, DEFAULT_AI_GENERATION_LIMITS.maxOutputTokens, "generationLimits.maxOutputTokens"),
+		maxReasoningTokens: positiveInteger(configuredLimits.maxReasoningTokens, DEFAULT_AI_GENERATION_LIMITS.maxReasoningTokens, "generationLimits.maxReasoningTokens"),
+		maxImagesPerRequest: positiveInteger(configuredLimits.maxImagesPerRequest, DEFAULT_AI_GENERATION_LIMITS.maxImagesPerRequest, "generationLimits.maxImagesPerRequest"),
+		onExceeded: configuredLimits.onExceeded || DEFAULT_AI_GENERATION_LIMITS.onExceeded
+	};
+	if (!["error", "clamp"].includes(generationLimits.onExceeded)) throw new AIError("generationLimits.onExceeded must be \"error\" or \"clamp\"", "AI_LIMIT_INVALID");
+	return {
+		...options,
+		timeout: positiveInteger(options.timeout, DEFAULT_AI_TIMEOUT_MS, "timeout"),
+		maxRetries: (() => {
+			if (options.maxRetries === void 0) return 0;
+			if (!Number.isFinite(options.maxRetries) || options.maxRetries < 0) throw new AIError("maxRetries must be a non-negative finite number", "AI_LIMIT_INVALID");
+			return Math.trunc(options.maxRetries);
+		})(),
+		generationLimits
+	};
+}
+function reasoningTokensForEffort(effort) {
+	switch (effort) {
+		case false:
+		case "none": return 0;
+		case "minimal": return 1024;
+		case "low": return 2048;
+		case "medium": return 4096;
+		case "high": return 8192;
+		default: return;
+	}
+}
+function enforceLimit(requested, limit, behavior, label, provider, model) {
+	if (!Number.isFinite(requested) || requested < 0) throw new AIError(`${label} must be a non-negative finite number`, "AI_LIMIT_INVALID", provider, model);
+	const normalized = Math.trunc(requested);
+	if (normalized <= limit) return normalized;
+	if (behavior === "clamp") return limit;
+	throw new AIError(`${label} ${normalized} exceeds configured ceiling ${limit}`, "AI_LIMIT_EXCEEDED", provider, model);
+}
+function normalizeChatOptions(providerOptions, options, provider, model) {
+	const limits = normalizeBaseAIOptions(providerOptions).generationLimits;
+	const requestedOutput = options.maxTokens ?? limits.maxOutputTokens;
+	const legacyEffort = options.thinkingLevel ?? providerOptions.thinkingLevel;
+	const requestedReasoning = options.reasoning !== void 0 || legacyEffort !== void 0 || options.includeThoughts === true ? options.reasoning?.maxTokens ?? reasoningTokensForEffort(options.reasoning?.effort ?? legacyEffort) ?? limits.maxReasoningTokens : 0;
+	return {
+		...options,
+		maxTokens: enforceLimit(requestedOutput, limits.maxOutputTokens, limits.onExceeded, "maxTokens", provider, model),
+		reasoning: {
+			...options.reasoning,
+			maxTokens: enforceLimit(requestedReasoning, limits.maxReasoningTokens, limits.onExceeded, "reasoning.maxTokens", provider, model),
+			includeThoughts: options.reasoning?.includeThoughts ?? options.includeThoughts
+		}
+	};
+}
+function normalizeImageGenerationOptions(providerOptions, options, provider, model) {
+	const limits = normalizeBaseAIOptions(providerOptions).generationLimits;
+	return {
+		...options,
+		n: enforceLimit(options.n ?? 1, limits.maxImagesPerRequest, limits.onExceeded, "n", provider, model)
+	};
+}
+function prepareRequestControls(providerOptions, requestOptions = {}) {
+	const normalized = normalizeBaseAIOptions(providerOptions);
+	const timeout = positiveInteger(requestOptions.timeout, normalized.timeout, "timeout");
+	const controller = new AbortController();
+	let timedOut = false;
+	const abortFromCaller = () => controller.abort(requestOptions.signal?.reason);
+	if (requestOptions.signal?.aborted) abortFromCaller();
+	else requestOptions.signal?.addEventListener("abort", abortFromCaller, { once: true });
+	const timer = setTimeout(() => {
+		timedOut = true;
+		controller.abort(/* @__PURE__ */ new Error(`AI request timed out after ${timeout}ms`));
+	}, timeout);
+	return {
+		signal: controller.signal,
+		timeout,
+		didTimeout: () => timedOut,
+		cleanup: () => {
+			clearTimeout(timer);
+			requestOptions.signal?.removeEventListener("abort", abortFromCaller);
+		}
+	};
+}
+function mergeTags(providerOptions, callTags) {
+	return providerOptions.usageTags || callTags ? {
+		...providerOptions.usageTags,
+		...callTags
+	} : void 0;
+}
+function emitRequestEvent(providerOptions, event) {
+	if (!providerOptions.onRequest) return;
+	try {
+		providerOptions.onRequest({
+			...event,
+			tags: mergeTags(providerOptions, event.tags)
+		});
+	} catch {}
+}
+function classifyRequestFailure(error, didTimeout = false) {
+	const code = error instanceof AIError ? error.code : void 0;
+	if (code === "AI_LIMIT_EXCEEDED" || code === "AI_LIMIT_INVALID") return {
+		status: "rejected",
+		errorCode: code
+	};
+	if (didTimeout || code === "AI_TIMEOUT" || code === "TIMEOUT") return {
+		status: "timed_out",
+		errorCode: code || "AI_TIMEOUT"
+	};
+	if (error instanceof Error && error.name === "AbortError") return {
+		status: "aborted",
+		errorCode: "ABORTED"
+	};
+	if (code === "AI_ABORTED") return {
+		status: "aborted",
+		errorCode: code
+	};
+	return {
+		status: "failed",
+		errorCode: code || (error instanceof Error ? error.name : void 0)
+	};
+}
+function requestEventBase(options) {
+	const normalized = normalizeBaseAIOptions(options.providerOptions);
+	return {
+		provider: options.provider,
+		model: options.model,
+		operation: options.operation,
+		attempts: normalized.maxRetries + 1,
+		requestedMaxOutputTokens: options.callOptions?.maxTokens,
+		effectiveMaxOutputTokens: options.operation === "generateImage" ? void 0 : options.effectiveMaxOutputTokens ?? normalized.generationLimits.maxOutputTokens,
+		tags: options.callOptions?.usageTags
+	};
+}
+var OBSERVED_OPERATIONS = /* @__PURE__ */ new Set([
+	"chat",
+	"complete",
+	"message",
+	"describeImage",
+	"generateImage",
+	"stream"
+]);
+function callOptionsFor(operation, args) {
+	const value = args[operation === "describeImage" ? 2 : 1];
+	return value && typeof value === "object" ? value : void 0;
+}
+function providerName(options) {
+	return options.type || "openai";
+}
+function effectiveOutputTokens(operation, providerOptions, callOptions) {
+	if (operation === "generateImage") {
+		normalizeImageGenerationOptions(providerOptions, callOptions || {}, providerName(providerOptions), callOptions?.model);
+		return;
+	}
+	return normalizeChatOptions(providerOptions, callOptions || {}, providerName(providerOptions), callOptions?.model || providerOptions.defaultModel).maxTokens;
+}
+/**
+* Wrap a public provider instance with prompt-free lifecycle observation.
+* Provider adapters still enforce limits internally so direct construction is
+* protected; this wrapper adds one terminal event to the public getAI() path.
+*/
+function createObservedAI(client, providerOptions) {
+	if (!providerOptions.onRequest) return client;
+	return new Proxy(client, { get(target, property, receiver) {
+		const value = Reflect.get(target, property, receiver);
+		if (typeof property !== "string" || typeof value !== "function" || !OBSERVED_OPERATIONS.has(property)) return typeof value === "function" ? value.bind(target) : value;
+		const operation = property;
+		if (operation === "stream") return async function* (...args) {
+			const startedAt = Date.now();
+			const callOptions = callOptionsFor(operation, args);
+			let base;
+			try {
+				base = requestEventBase({
+					providerOptions,
+					provider: providerName(providerOptions),
+					model: callOptions?.model || providerOptions.defaultModel || "unknown",
+					operation,
+					callOptions,
+					effectiveMaxOutputTokens: effectiveOutputTokens(operation, providerOptions, callOptions)
+				});
+				const iterable = Reflect.apply(value, target, args);
+				for await (const chunk of iterable) yield chunk;
+				emitRequestEvent(providerOptions, {
+					...base,
+					status: "succeeded",
+					duration: Date.now() - startedAt
+				});
+			} catch (error) {
+				const failure = classifyRequestFailure(error);
+				base ||= requestEventBase({
+					providerOptions,
+					provider: providerName(providerOptions),
+					model: callOptions?.model || providerOptions.defaultModel || "unknown",
+					operation,
+					callOptions
+				});
+				emitRequestEvent(providerOptions, {
+					...base,
+					...failure,
+					duration: Date.now() - startedAt
+				});
+				throw error;
+			}
+		};
+		return async (...args) => {
+			const startedAt = Date.now();
+			const callOptions = callOptionsFor(operation, args);
+			let base;
+			try {
+				base = requestEventBase({
+					providerOptions,
+					provider: providerName(providerOptions),
+					model: callOptions?.model || providerOptions.defaultModel || "unknown",
+					operation,
+					callOptions,
+					effectiveMaxOutputTokens: effectiveOutputTokens(operation, providerOptions, callOptions)
+				});
+				const result = await Reflect.apply(value, target, args);
+				emitRequestEvent(providerOptions, {
+					...base,
+					status: "succeeded",
+					duration: Date.now() - startedAt
+				});
+				return result;
+			} catch (error) {
+				const failure = classifyRequestFailure(error);
+				base ||= requestEventBase({
+					providerOptions,
+					provider: providerName(providerOptions),
+					model: callOptions?.model || providerOptions.defaultModel || "unknown",
+					operation,
+					callOptions
+				});
+				emitRequestEvent(providerOptions, {
+					...base,
+					...failure,
+					duration: Date.now() - startedAt
+				});
+				throw error;
+			}
+		};
+	} });
+}
+//#endregion
+export { normalizeBaseAIOptions as a, prepareRequestControls as c, createObservedAI as i, DEFAULT_AI_MAX_RETRIES as n, normalizeChatOptions as o, DEFAULT_AI_TIMEOUT_MS as r, normalizeImageGenerationOptions as s, DEFAULT_AI_GENERATION_LIMITS as t };
+
+//# sourceMappingURL=safety-CEnoJS6X.js.map

package/dist/chunks/safety-CEnoJS6X.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-CEnoJS6X.js","names":[],"sources":["../../src/shared/safety.ts"],"sourcesContent":["import type {\n  AIGenerationLimits,\n  AIInterface,\n  AIReasoningOptions,\n  AIRequestControls,\n  AIRequestEvent,\n  AIRequestOperation,\n  AIRequestStatus,\n  BaseAIOptions,\n  ChatOptions,\n  ImageGenerationOptions,\n} from './types';\nimport { AIError } from './types';\n\nexport const DEFAULT_AI_TIMEOUT_MS = 120_000;\nexport const DEFAULT_AI_MAX_RETRIES = 0;\n\nexport const DEFAULT_AI_GENERATION_LIMITS: Readonly<AIGenerationLimits> =\n  Object.freeze({\n    maxOutputTokens: 4096,\n    maxReasoningTokens: 1024,\n    maxImagesPerRequest: 1,\n    onExceeded: 'error',\n  });\n\nexport interface NormalizedBaseAIOptions extends BaseAIOptions {\n  timeout: number;\n  maxRetries: number;\n  generationLimits: AIGenerationLimits;\n}\n\nexport interface PreparedRequestControls {\n  signal: AbortSignal;\n  timeout: number;\n  cleanup(): void;\n  didTimeout(): boolean;\n}\n\nfunction positiveInteger(\n  value: number | undefined,\n  fallback: number,\n  field: string,\n): number {\n  if (value === undefined) return fallback;\n  if (!Number.isFinite(value) || value <= 0) {\n    throw new AIError(\n      `${field} must be a positive finite number`,\n      'AI_LIMIT_INVALID',\n    );\n  }\n  return Math.trunc(value);\n}\n\nexport function normalizeBaseAIOptions<T extends BaseAIOptions>(\n  options: T,\n): T & NormalizedBaseAIOptions {\n  const configuredLimits = options.generationLimits || {};\n  const generationLimits: AIGenerationLimits = {\n    maxOutputTokens: positiveInteger(\n      configuredLimits.maxOutputTokens,\n      DEFAULT_AI_GENERATION_LIMITS.maxOutputTokens,\n      'generationLimits.maxOutputTokens',\n    ),\n    maxReasoningTokens: positiveInteger(\n      configuredLimits.maxReasoningTokens,\n      DEFAULT_AI_GENERATION_LIMITS.maxReasoningTokens,\n      'generationLimits.maxReasoningTokens',\n    ),\n    maxImagesPerRequest: positiveInteger(\n      configuredLimits.maxImagesPerRequest,\n      DEFAULT_AI_GENERATION_LIMITS.maxImagesPerRequest,\n      'generationLimits.maxImagesPerRequest',\n    ),\n    onExceeded:\n      configuredLimits.onExceeded || DEFAULT_AI_GENERATION_LIMITS.onExceeded,\n  };\n\n  if (!['error', 'clamp'].includes(generationLimits.onExceeded)) {\n    throw new AIError(\n      'generationLimits.onExceeded must be \"error\" or \"clamp\"',\n      'AI_LIMIT_INVALID',\n    );\n  }\n\n  return {\n    ...options,\n    timeout: positiveInteger(options.timeout, DEFAULT_AI_TIMEOUT_MS, 'timeout'),\n    maxRetries: (() => {\n      if (options.maxRetries === undefined) return DEFAULT_AI_MAX_RETRIES;\n      if (!Number.isFinite(options.maxRetries) || options.maxRetries < 0) {\n        throw new AIError(\n          'maxRetries must be a non-negative finite number',\n          'AI_LIMIT_INVALID',\n        );\n      }\n      return Math.trunc(options.maxRetries);\n    })(),\n    generationLimits,\n  };\n}\n\nfunction reasoningTokensForEffort(\n  effort: AIReasoningOptions['effort'] | false | undefined,\n): number | undefined {\n  switch (effort) {\n    case false:\n    case 'none':\n      return 0;\n    case 'minimal':\n      return 1024;\n    case 'low':\n      return 2048;\n    case 'medium':\n      return 4096;\n    case 'high':\n      return 8192;\n    default:\n      return undefined;\n  }\n}\n\nfunction enforceLimit(\n  requested: number,\n  limit: number,\n  behavior: AIGenerationLimits['onExceeded'],\n  label: string,\n  provider?: string,\n  model?: string,\n): number {\n  if (!Number.isFinite(requested) || requested < 0) {\n    throw new AIError(\n      `${label} must be a non-negative finite number`,\n      'AI_LIMIT_INVALID',\n      provider,\n      model,\n    );\n  }\n  const normalized = Math.trunc(requested);\n  if (normalized <= limit) return normalized;\n  if (behavior === 'clamp') return limit;\n  throw new AIError(\n    `${label} ${normalized} exceeds configured ceiling ${limit}`,\n    'AI_LIMIT_EXCEEDED',\n    provider,\n    model,\n  );\n}\n\nexport function normalizeChatOptions<\n  T extends AIRequestControls & {\n    maxTokens?: number;\n    thinkingLevel?: ChatOptions['thinkingLevel'];\n    includeThoughts?: boolean;\n  },\n>(\n  providerOptions: BaseAIOptions,\n  options: T,\n  provider?: string,\n  model?: string,\n): T & { maxTokens: number; reasoning: AIReasoningOptions } {\n  const normalizedProvider = normalizeBaseAIOptions(providerOptions);\n  const limits = normalizedProvider.generationLimits;\n  const requestedOutput = options.maxTokens ?? limits.maxOutputTokens;\n  const legacyEffort =\n    options.thinkingLevel ??\n    (\n      providerOptions as BaseAIOptions & {\n        thinkingLevel?: ChatOptions['thinkingLevel'];\n      }\n    ).thinkingLevel;\n  const reasoningWasRequested =\n    options.reasoning !== undefined ||\n    legacyEffort !== undefined ||\n    options.includeThoughts === true;\n  const requestedReasoning = reasoningWasRequested\n    ? (options.reasoning?.maxTokens ??\n      reasoningTokensForEffort(options.reasoning?.effort ?? legacyEffort) ??\n      limits.maxReasoningTokens)\n    : 0;\n\n  return {\n    ...options,\n    maxTokens: enforceLimit(\n      requestedOutput,\n      limits.maxOutputTokens,\n      limits.onExceeded,\n      'maxTokens',\n      provider,\n      model,\n    ),\n    reasoning: {\n      ...options.reasoning,\n      maxTokens: enforceLimit(\n        requestedReasoning,\n        limits.maxReasoningTokens,\n        limits.onExceeded,\n        'reasoning.maxTokens',\n        provider,\n        model,\n      ),\n      includeThoughts:\n        options.reasoning?.includeThoughts ?? options.includeThoughts,\n    },\n  };\n}\n\nexport function normalizeImageGenerationOptions<\n  T extends ImageGenerationOptions,\n>(\n  providerOptions: BaseAIOptions,\n  options: T,\n  provider?: string,\n  model?: string,\n): T & { n: number } {\n  const normalizedProvider = normalizeBaseAIOptions(providerOptions);\n  const limits = normalizedProvider.generationLimits;\n  return {\n    ...options,\n    n: enforceLimit(\n      options.n ?? 1,\n      limits.maxImagesPerRequest,\n      limits.onExceeded,\n      'n',\n      provider,\n      model,\n    ),\n  };\n}\n\nexport function prepareRequestControls(\n  providerOptions: BaseAIOptions,\n  requestOptions: AIRequestControls = {},\n): PreparedRequestControls {\n  const normalized = normalizeBaseAIOptions(providerOptions);\n  const timeout = positiveInteger(\n    requestOptions.timeout,\n    normalized.timeout,\n    'timeout',\n  );\n  const controller = new AbortController();\n  let timedOut = false;\n\n  const abortFromCaller = () => controller.abort(requestOptions.signal?.reason);\n  if (requestOptions.signal?.aborted) {\n    abortFromCaller();\n  } else {\n    requestOptions.signal?.addEventListener('abort', abortFromCaller, {\n      once: true,\n    });\n  }\n\n  const timer = setTimeout(() => {\n    timedOut = true;\n    controller.abort(new Error(`AI request timed out after ${timeout}ms`));\n  }, timeout);\n\n  return {\n    signal: controller.signal,\n    timeout,\n    didTimeout: () => timedOut,\n    cleanup: () => {\n      clearTimeout(timer);\n      requestOptions.signal?.removeEventListener('abort', abortFromCaller);\n    },\n  };\n}\n\nfunction mergeTags(\n  providerOptions: BaseAIOptions,\n  callTags?: Record<string, string>,\n): Record<string, string> | undefined {\n  return providerOptions.usageTags || callTags\n    ? { ...providerOptions.usageTags, ...callTags }\n    : undefined;\n}\n\nexport function emitRequestEvent(\n  providerOptions: BaseAIOptions,\n  event: Omit<AIRequestEvent, 'tags'> & {\n    tags?: Record<string, string>;\n  },\n): void {\n  if (!providerOptions.onRequest) return;\n  try {\n    providerOptions.onRequest({\n      ...event,\n      tags: mergeTags(providerOptions, event.tags),\n    });\n  } catch {\n    // Consumer telemetry must never affect an AI request.\n  }\n}\n\nexport function classifyRequestFailure(\n  error: unknown,\n  didTimeout = false,\n): { status: AIRequestStatus; errorCode?: string } {\n  const code = error instanceof AIError ? error.code : undefined;\n  if (code === 'AI_LIMIT_EXCEEDED' || code === 'AI_LIMIT_INVALID') {\n    return { status: 'rejected', errorCode: code };\n  }\n  if (didTimeout || code === 'AI_TIMEOUT' || code === 'TIMEOUT') {\n    return { status: 'timed_out', errorCode: code || 'AI_TIMEOUT' };\n  }\n  if (error instanceof Error && error.name === 'AbortError') {\n    return { status: 'aborted', errorCode: 'ABORTED' };\n  }\n  if (code === 'AI_ABORTED') {\n    return { status: 'aborted', errorCode: code };\n  }\n  return {\n    status: 'failed',\n    errorCode: code || (error instanceof Error ? error.name : undefined),\n  };\n}\n\nexport function requestEventBase(options: {\n  providerOptions: BaseAIOptions;\n  provider: string;\n  model: string;\n  operation: AIRequestOperation;\n  callOptions?: { maxTokens?: number; usageTags?: Record<string, string> };\n  effectiveMaxOutputTokens?: number;\n}): Omit<AIRequestEvent, 'status' | 'duration'> & {\n  tags?: Record<string, string>;\n} {\n  const normalized = normalizeBaseAIOptions(options.providerOptions);\n  return {\n    provider: options.provider,\n    model: options.model,\n    operation: options.operation,\n    attempts: normalized.maxRetries + 1,\n    requestedMaxOutputTokens: options.callOptions?.maxTokens,\n    effectiveMaxOutputTokens:\n      options.operation === 'generateImage'\n        ? undefined\n        : (options.effectiveMaxOutputTokens ??\n          normalized.generationLimits.maxOutputTokens),\n    tags: options.callOptions?.usageTags,\n  };\n}\n\nconst OBSERVED_OPERATIONS = new Set<AIRequestOperation>([\n  'chat',\n  'complete',\n  'message',\n  'describeImage',\n  'generateImage',\n  'stream',\n]);\n\nfunction callOptionsFor(\n  operation: AIRequestOperation,\n  args: unknown[],\n):\n  | (AIRequestControls & {\n      model?: string;\n      maxTokens?: number;\n      usageTags?: Record<string, string>;\n    })\n  | undefined {\n  const index = operation === 'describeImage' ? 2 : 1;\n  const value = args[index];\n  return value && typeof value === 'object'\n    ? (value as AIRequestControls & {\n        model?: string;\n        maxTokens?: number;\n        usageTags?: Record<string, string>;\n      })\n    : undefined;\n}\n\nfunction providerName(options: BaseAIOptions): string {\n  const configured = (options as BaseAIOptions & { type?: string }).type;\n  return configured || 'openai';\n}\n\nfunction effectiveOutputTokens(\n  operation: AIRequestOperation,\n  providerOptions: BaseAIOptions,\n  callOptions:\n    | (AIRequestControls & {\n        model?: string;\n        maxTokens?: number;\n        n?: number;\n      })\n    | undefined,\n): number | undefined {\n  if (operation === 'generateImage') {\n    normalizeImageGenerationOptions(\n      providerOptions,\n      callOptions || {},\n      providerName(providerOptions),\n      callOptions?.model,\n    );\n    return undefined;\n  }\n\n  return normalizeChatOptions(\n    providerOptions,\n    callOptions || {},\n    providerName(providerOptions),\n    callOptions?.model || providerOptions.defaultModel,\n  ).maxTokens;\n}\n\n/**\n * Wrap a public provider instance with prompt-free lifecycle observation.\n * Provider adapters still enforce limits internally so direct construction is\n * protected; this wrapper adds one terminal event to the public getAI() path.\n */\nexport function createObservedAI<T extends AIInterface>(\n  client: T,\n  providerOptions: BaseAIOptions,\n): T {\n  if (!providerOptions.onRequest) return client;\n\n  return new Proxy(client, {\n    get(target, property, receiver) {\n      const value = Reflect.get(target, property, receiver);\n      if (\n        typeof property !== 'string' ||\n        typeof value !== 'function' ||\n        !OBSERVED_OPERATIONS.has(property as AIRequestOperation)\n      ) {\n        return typeof value === 'function' ? value.bind(target) : value;\n      }\n\n      const operation = property as AIRequestOperation;\n      if (operation === 'stream') {\n        return async function* (...args: unknown[]) {\n          const startedAt = Date.now();\n          const callOptions = callOptionsFor(operation, args);\n          let base: ReturnType<typeof requestEventBase> | undefined;\n          try {\n            base = requestEventBase({\n              providerOptions,\n              provider: providerName(providerOptions),\n              model:\n                callOptions?.model || providerOptions.defaultModel || 'unknown',\n              operation,\n              callOptions,\n              effectiveMaxOutputTokens: effectiveOutputTokens(\n                operation,\n                providerOptions,\n                callOptions,\n              ),\n            });\n            const iterable = Reflect.apply(\n              value,\n              target,\n              args,\n            ) as AsyncIterable<string>;\n            for await (const chunk of iterable) yield chunk;\n            emitRequestEvent(providerOptions, {\n              ...base,\n              status: 'succeeded',\n              duration: Date.now() - startedAt,\n            });\n          } catch (error) {\n            const failure = classifyRequestFailure(error);\n            base ||= requestEventBase({\n              providerOptions,\n              provider: providerName(providerOptions),\n              model:\n                callOptions?.model || providerOptions.defaultModel || 'unknown',\n              operation,\n              callOptions,\n            });\n            emitRequestEvent(providerOptions, {\n              ...base,\n              ...failure,\n              duration: Date.now() - startedAt,\n            });\n            throw error;\n          }\n        };\n      }\n\n      return async (...args: unknown[]) => {\n        const startedAt = Date.now();\n        const callOptions = callOptionsFor(operation, args);\n        let base: ReturnType<typeof requestEventBase> | undefined;\n        try {\n          base = requestEventBase({\n            providerOptions,\n            provider: providerName(providerOptions),\n            model:\n              callOptions?.model || providerOptions.defaultModel || 'unknown',\n            operation,\n            callOptions,\n            effectiveMaxOutputTokens: effectiveOutputTokens(\n              operation,\n              providerOptions,\n              callOptions,\n            ),\n          });\n          const result = await Reflect.apply(value, target, args);\n          emitRequestEvent(providerOptions, {\n            ...base,\n            status: 'succeeded',\n            duration: Date.now() - startedAt,\n          });\n          return result;\n        } catch (error) {\n          const failure = classifyRequestFailure(error);\n          base ||= requestEventBase({\n            providerOptions,\n            provider: providerName(providerOptions),\n            model:\n              callOptions?.model || providerOptions.defaultModel || 'unknown',\n            operation,\n            callOptions,\n          });\n          emitRequestEvent(providerOptions, {\n            ...base,\n            ...failure,\n            duration: Date.now() - startedAt,\n          });\n          throw error;\n        }\n      };\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/chunks/types-FHs-KbGL.js

@@ -0,0 +1,117 @@
+//#region src/shared/types.ts
+/**
+* Supported AI provider types
+*/
+var AI_PROVIDER_TYPES = [
+	"openai",
+	"litellm",
+	"bifrost",
+	"ollama",
+	"gemini",
+	"anthropic",
+	"huggingface",
+	"bedrock",
+	"claude-cli",
+	"qwen3-tts"
+];
+/**
+* Extract text content from a message content field.
+*
+* Handles both simple string content and multimodal content arrays,
+* extracting only the text parts and concatenating them.
+*
+* @param content - The message content (string or ContentPart array)
+* @returns The extracted text content
+*/
+function extractTextContent(content) {
+	if (typeof content === "string") return content;
+	return content.filter((part) => part.type === "text").map((part) => part.text).join("\n");
+}
+/**
+* Base error class for all AI operations.
+* Provider-specific errors are mapped to subclasses for structured error handling.
+*
+* @param message - Human-readable error description
+* @param code - Machine-readable error code (e.g., 'AUTH_ERROR', 'RATE_LIMIT')
+* @param provider - Provider that raised the error (e.g., 'openai', 'anthropic')
+* @param model - Model involved in the error, if applicable
+*/
+var AIError = class extends Error {
+	code;
+	provider;
+	model;
+	retryable;
+	constructor(message, code, provider, model, retryable = false) {
+		super(message);
+		this.code = code;
+		this.provider = provider;
+		this.model = model;
+		this.retryable = retryable;
+		this.name = "AIError";
+	}
+};
+/**
+* Thrown when API key or credentials are invalid or missing.
+*
+* @param provider - Provider that rejected authentication
+*/
+var AuthenticationError = class extends AIError {
+	constructor(provider) {
+		super("Authentication failed", "AUTH_ERROR", provider, void 0, false);
+		this.name = "AuthenticationError";
+	}
+};
+/**
+* Thrown when the provider's rate limit has been exceeded.
+*
+* @param provider - Provider that enforced the rate limit
+* @param retryAfter - Seconds to wait before retrying, if provided by the API
+*/
+var RateLimitError = class extends AIError {
+	retryAfter;
+	constructor(provider, retryAfter) {
+		super(`Rate limit exceeded${retryAfter ? `, retry after ${retryAfter}s` : ""}`, "RATE_LIMIT", provider, void 0, true);
+		this.name = "RateLimitError";
+		this.retryAfter = retryAfter;
+	}
+};
+/**
+* Thrown when the requested model does not exist or is not available.
+*
+* @param model - The model identifier that was not found
+* @param provider - Provider that was queried
+*/
+var ModelNotFoundError = class extends AIError {
+	constructor(model, provider) {
+		super(`Model not found: ${model}`, "MODEL_NOT_FOUND", provider, model, false);
+		this.name = "ModelNotFoundError";
+	}
+};
+/**
+* Thrown when the input exceeds the model's maximum context window.
+*
+* @param provider - Provider that reported the error
+* @param model - Model whose context limit was exceeded
+*/
+var ContextLengthError = class extends AIError {
+	constructor(provider, model) {
+		super("Input exceeds maximum context length", "CONTEXT_LENGTH_EXCEEDED", provider, model, false);
+		this.name = "ContextLengthError";
+	}
+};
+/**
+* Thrown when content is blocked by the provider's safety/content filters.
+*
+* @param provider - Provider that filtered the content
+* @param model - Model that triggered the filter
+*/
+var ContentFilterError = class extends AIError {
+	constructor(provider, model) {
+		super("Content filtered by safety systems", "CONTENT_FILTERED", provider, model, false);
+		this.name = "ContentFilterError";
+	}
+};
+//#endregion
+export { ContextLengthError as a, extractTextContent as c, ContentFilterError as i, AI_PROVIDER_TYPES as n, ModelNotFoundError as o, AuthenticationError as r, RateLimitError as s, AIError as t };
+
+//# sourceMappingURL=types-FHs-KbGL.js.map