@genui-a3/providers 0.0.4 → 0.0.6

package/dist/openai/index.cjs

@@ -2,6 +2,7 @@
 
 var openai = require('@ai-sdk/openai');
 var ai = require('ai');
+var core = require('@genui-a3/core');
 var client = require('@ag-ui/client');
 
 // openai/index.ts
@@ -69,20 +70,119 @@ function extractDelta(partial, prevLength) {
   return chatbotMessage.slice(prevLength);
 }
 
+// utils/backoff.ts
+function calculateBackoff(attempt, config) {
+  let delay;
+  switch (config.strategy) {
+    case "exponential":
+      delay = config.baseDelayMs * Math.pow(2, attempt);
+      break;
+    case "linear":
+      delay = config.baseDelayMs * (attempt + 1);
+      break;
+    case "fixed":
+      delay = config.baseDelayMs;
+      break;
+  }
+  delay = Math.min(delay, config.maxDelayMs);
+  if (config.jitter) {
+    delay = Math.random() * delay;
+  }
+  return delay;
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(signal.reason);
+      return;
+    }
+    const timer = setTimeout(resolve, ms);
+    signal?.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(timer);
+        reject(signal.reason);
+      },
+      { once: true }
+    );
+  });
+}
+
 // utils/executeWithFallback.ts
-async function executeWithFallback(models, action) {
-  for (let i = 0; i < models.length; i++) {
-    const model = models[i];
-    try {
-      return await action(model);
-    } catch (error) {
-      const errorObj = error;
-      if (i === models.length - 1) {
-        throw errorObj;
+function buildSignal(requestTimeoutMs, totalAbort) {
+  const signals = [];
+  if (requestTimeoutMs !== void 0) {
+    signals.push(AbortSignal.timeout(requestTimeoutMs));
+  }
+  if (totalAbort) {
+    signals.push(totalAbort);
+  }
+  if (signals.length === 0) return void 0;
+  if (signals.length === 1) return signals[0];
+  return AbortSignal.any(signals);
+}
+async function attemptAction(action, model, signal, attempt, errors) {
+  try {
+    const value = await action(model, signal);
+    return { ok: true, value };
+  } catch (error) {
+    const errorObj = error;
+    errors.push({ model, attempt, error: errorObj });
+    return { ok: false, error: errorObj };
+  }
+}
+function checkTotalTimeout(totalAbort, timeoutMs, errors) {
+  if (totalAbort?.signal.aborted) {
+    throw new core.A3TimeoutError(`Total timeout of ${timeoutMs}ms exceeded`, errors);
+  }
+}
+async function handleAttemptError(errorObj, attempt, maxRetries, retryAll, resolved, totalAbort) {
+  const isLastAttempt = attempt === 1 + maxRetries;
+  const isRetryable = retryAll || resolved.isRetryableError(errorObj);
+  if (isRetryable && !isLastAttempt) {
+    const delay = calculateBackoff(attempt - 1, resolved.backoff);
+    await sleep(delay, totalAbort?.signal).catch(() => {
+    });
+    return "retry";
+  }
+  return "next-model";
+}
+async function executeWithFallback(models, action, config) {
+  const resolved = config ?? core.DEFAULT_RESILIENCE_CONFIG;
+  const errors = [];
+  const maxRetries = resolved.retry === false ? 0 : resolved.retry.maxAttempts;
+  const retryAll = resolved.retry !== false && resolved.retry.retryOn === "all";
+  let totalAbort;
+  let totalTimer;
+  if (resolved.timeout.totalTimeoutMs !== void 0) {
+    totalAbort = new AbortController();
+    totalTimer = setTimeout(
+      () => totalAbort.abort(new Error("Total timeout exceeded")),
+      resolved.timeout.totalTimeoutMs
+    );
+  }
+  try {
+    for (let modelIndex = 0; modelIndex < models.length; modelIndex++) {
+      const model = models[modelIndex];
+      for (let attempt = 1; attempt <= 1 + maxRetries; attempt++) {
+        checkTotalTimeout(totalAbort, resolved.timeout.totalTimeoutMs, errors);
+        const signal = buildSignal(resolved.timeout.requestTimeoutMs, totalAbort?.signal);
+        const result = await attemptAction(action, model, signal, attempt, errors);
+        if (result.ok) return result.value;
+        checkTotalTimeout(totalAbort, resolved.timeout.totalTimeoutMs, errors);
+        const decision = await handleAttemptError(result.error, attempt, maxRetries, retryAll, resolved, totalAbort);
+        if (decision === "next-model") break;
       }
     }
+    throw new core.A3ResilienceError(
+      `All models failed after ${errors.length} total attempt(s): ${models.join(", ")}`,
+      errors
+    );
+  } finally {
+    if (totalTimer !== void 0) {
+      clearTimeout(totalTimer);
+    }
   }
-  throw new Error("All models failed");
 }
 
 // openai/index.ts
@@ -158,20 +258,23 @@ function createOpenAIProvider(config) {
     organization: config.organization
   });
   const models = config.models;
+  const resilience = core.resolveResilienceConfig(config.resilience);
   return {
     name: "openai",
     async sendRequest(request) {
       const messages = toAIMessages(request.messages);
       return executeWithFallback(
         models,
-        (model) => sendWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema)
+        (model) => sendWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema),
+        resilience
       );
     },
     async *sendRequestStream(request) {
       const messages = toAIMessages(request.messages);
       const { result, reader, first } = await executeWithFallback(
         models,
-        (model) => sendStreamWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema)
+        (model) => sendStreamWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema),
+        resilience
       );
       yield* processOpenAIStream(result, reader, first, "openai", request.responseSchema);
     }

package/dist/openai/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../openai/streamProcessor.ts","../../utils/executeWithFallback.ts","../../openai/index.ts"],"names":["EventType","jsonSchema","generateText","Output","streamText","createOpenAI"],"mappings":"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","file":"index.cjs","sourcesContent":["import { EventType } from '@ag-ui/client'\nimport { ZodType } from 'zod'\nimport type { AgentId, StreamEvent, BaseState } from '@genui-a3/core'\nimport type { StreamTextResult, ToolSet } from 'ai'\n\n/**\n * Processes an OpenAI streaming response (via Vercel AI SDK) into AG-UI events.\n *\n * Uses `partialOutputStream` from `streamText` + `Output.object()` to receive\n * progressively-built partial objects. Tracks `chatbotMessage` growth to yield\n * TEXT_MESSAGE_CONTENT deltas. After the stream completes, validates the final\n * object and yields TOOL_CALL_RESULT.\n *\n * @param streamResult - The streamText result containing partialOutputStream and output promise\n * @param reader - Pre-started async iterator for the partial object stream\n * @param first - The first iteration result (already consumed to trigger the API call)\n * @param agentId - Agent identifier for event tagging\n * @param schema - Zod schema for final response validation\n * @returns Async generator of AG-UI stream events\n */\nexport async function* processOpenAIStream<TState extends BaseState = BaseState>(\n  streamResult: StreamTextResult<ToolSet, never>,\n  reader: AsyncIterator<unknown>,\n  first: IteratorResult<unknown>,\n  agentId: AgentId,\n  schema: ZodType,\n): AsyncGenerator<StreamEvent<TState>> {\n  let prevMessageLength = 0\n\n  try {\n    // Process the first partial (already consumed to trigger the API call)\n    if (!first.done) {\n      const partial = first.value as Record<string, unknown>\n      const delta = extractDelta(partial, prevMessageLength)\n      if (delta) {\n        prevMessageLength += delta.length\n        yield {\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: '',\n          delta,\n          agentId,\n        } as StreamEvent<TState>\n      }\n    }\n\n    // Process remaining partials\n    let next = await reader.next()\n    while (!next.done) {\n      const partial = next.value as Record<string, unknown>\n      const delta = extractDelta(partial, prevMessageLength)\n      if (delta) {\n        prevMessageLength += delta.length\n        yield {\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: '',\n          delta,\n          agentId,\n        } as StreamEvent<TState>\n      }\n      // eslint-disable-next-line no-await-in-loop\n      next = await reader.next()\n    }\n\n    // Stream complete — await and validate the final object\n    const finalObject = await streamResult.output\n\n    if (finalObject === null) {\n      yield {\n        type: EventType.RUN_ERROR,\n        message: 'OpenAI stream completed with null output',\n        agentId,\n      } as StreamEvent<TState>\n      return\n    }\n\n    const validated = schema.parse(finalObject)\n    yield {\n      type: EventType.TOOL_CALL_RESULT,\n      toolCallId: '',\n      messageId: '',\n      content: JSON.stringify(validated),\n      agentId,\n    } as StreamEvent<TState>\n  } catch (err) {\n    yield {\n      type: EventType.RUN_ERROR,\n      message: `OpenAI stream error: ${(err as Error).message}`,\n      agentId,\n    } as StreamEvent<TState>\n  }\n}\n\n/**\n * Extracts the new portion of chatbotMessage from a partial object.\n */\nfunction extractDelta(partial: Record<string, unknown>, prevLength: number): string | null {\n  const chatbotMessage = partial.chatbotMessage\n  if (typeof chatbotMessage !== 'string' || chatbotMessage.length <= prevLength) {\n    return null\n  }\n  return chatbotMessage.slice(prevLength)\n}\n","/**\n * Executes an action with model fallback support.\n * Tries each model in order; if one fails, falls back to the next.\n * Throws the last error if all models fail.\n *\n * @param models - Model identifiers in priority order\n * @param action - Async action to attempt with each model\n * @returns The result from the first successful model\n * @throws The error from the last model if all fail\n *\n * @example\n * ```typescript\n * const result = await executeWithFallback(\n *   ['model-primary', 'model-fallback'],\n *   (model) => provider.call(model, params),\n * )\n * ```\n */\nexport async function executeWithFallback<T>(models: string[], action: (model: string) => Promise<T>): Promise<T> {\n  const errors: Array<{ model: string; error: Error }> = []\n\n  for (let i = 0; i < models.length; i++) {\n    const model = models[i]\n\n    try {\n      // eslint-disable-next-line no-await-in-loop\n      return await action(model)\n    } catch (error) {\n      const errorObj = error as Error\n      errors.push({ model, error: errorObj })\n\n      if (i === models.length - 1) {\n        throw errorObj\n      }\n    }\n  }\n\n  throw new Error('All models failed')\n}\n","import { createOpenAI } from '@ai-sdk/openai'\nimport { generateText, streamText, Output, ModelMessage, jsonSchema } from 'ai'\nimport type {\n  Provider,\n  ProviderRequest,\n  ProviderResponse,\n  ProviderMessage,\n  BaseState,\n  StreamEvent,\n} from '@genui-a3/core'\nimport { processOpenAIStream } from './streamProcessor'\nimport { executeWithFallback } from '../utils/executeWithFallback'\n\n/**\n * Configuration for creating an OpenAI provider.\n */\nexport interface OpenAIProviderConfig {\n  /** OpenAI API key. Defaults to OPENAI_API_KEY env var (OpenAI SDK default). */\n  apiKey?: string\n  /**\n   * Model identifiers in order of preference (first = primary, rest = fallbacks).\n   * e.g. ['gpt-4o', 'gpt-4o-mini']\n   */\n  models: string[]\n  /** Optional base URL for Azure OpenAI or compatible endpoints */\n  baseURL?: string\n  /** Optional OpenAI organization ID */\n  organization?: string\n}\n\ntype JsonSchema = Record<string, unknown>\n\n/**\n * Enforces strict JSON schema constraints required by OpenAI's structured output API.\n * OpenAI requires all object properties — including optional ones — to be in the `required` array.\n * This function recursively adds `required` and `additionalProperties: false` to all objects.\n *\n * @param schema - JSON schema to enforce\n * @returns Enforced JSON schema\n */\nfunction enforceStrictSchema(schema: JsonSchema): JsonSchema {\n  const result = { ...schema }\n  if (result.type === 'object' && result.properties) {\n    result.additionalProperties = false\n    result.required = Object.keys(result.properties as Record<string, unknown>)\n    const props = result.properties as Record<string, JsonSchema>\n    const strictProps: Record<string, JsonSchema> = {}\n    for (const [key, value] of Object.entries(props)) {\n      strictProps[key] = enforceStrictSchema(value)\n    }\n    result.properties = strictProps\n  }\n  if (result.items && typeof result.items === 'object') {\n    result.items = enforceStrictSchema(result.items as JsonSchema)\n  }\n  for (const keyword of ['anyOf', 'oneOf', 'allOf'] as const) {\n    if (Array.isArray(result[keyword])) {\n      result[keyword] = (result[keyword] as JsonSchema[]).map((s) => enforceStrictSchema(s))\n    }\n  }\n  return result\n}\n\n/**\n * Converts a Zod schema to an OpenAI-compatible strict JSON schema wrapped for the Vercel AI SDK.\n *\n * @param zodSchema - Zod schema to convert\n * @returns JSON schema wrapped for Vercel AI SDK\n */\nfunction toOpenAISchema(zodSchema: ProviderRequest['responseSchema']) {\n  const strict = enforceStrictSchema(zodSchema.toJSONSchema() as JsonSchema)\n  return jsonSchema(strict as never, {\n    validate: (value: unknown) => {\n      const result = zodSchema.safeParse(value)\n      return result.success\n        ? { success: true as const, value: result.data }\n        : { success: false as const, error: result.error }\n    },\n  })\n}\n\nfunction toAIMessages(messages: ProviderMessage[]): ModelMessage[] {\n  return messages.map((msg) => ({\n    role: msg.role,\n    content: msg.content,\n  }))\n}\n\nasync function sendWithModel(\n  openaiProvider: ReturnType<typeof createOpenAI>,\n  model: string,\n  system: string,\n  messages: ModelMessage[],\n  schema: ProviderRequest['responseSchema'],\n): Promise<ProviderResponse> {\n  const result = await generateText({\n    model: openaiProvider(model),\n    system,\n    messages,\n    output: Output.object({ schema: toOpenAISchema(schema) }),\n  })\n\n  return {\n    content: JSON.stringify(result.output),\n    usage: {\n      inputTokens: result.usage.inputTokens ?? 0,\n      outputTokens: result.usage.outputTokens ?? 0,\n      totalTokens: (result.usage.inputTokens ?? 0) + (result.usage.outputTokens ?? 0),\n    },\n  }\n}\n\nasync function sendStreamWithModel(\n  openaiProvider: ReturnType<typeof createOpenAI>,\n  model: string,\n  system: string,\n  messages: ModelMessage[],\n  schema: ProviderRequest['responseSchema'],\n) {\n  const result = streamText({\n    model: openaiProvider(model),\n    system,\n    messages,\n    output: Output.object({ schema: toOpenAISchema(schema) }),\n  })\n\n  // Force the API call to start so executeWithFallback can catch connection errors\n  const partialStream = result.partialOutputStream\n  const reader = partialStream[Symbol.asyncIterator]()\n  const first = await reader.next()\n\n  return { result, reader, first }\n}\n\n/**\n * Creates an OpenAI provider instance.\n *\n * Uses the Vercel AI SDK (`ai` + `@ai-sdk/openai`) for structured output via\n * `generateText` + `Output.object()` (blocking) and `streamText` + `Output.object()`\n * (streaming). The AI SDK handles Zod-to-JSON-schema conversion, partial JSON\n * parsing, and validation internally.\n *\n * @param config - OpenAI provider configuration\n * @returns A Provider implementation using OpenAI\n *\n * @example\n * ```typescript\n * const provider = createOpenAIProvider({\n *   models: ['gpt-4o', 'gpt-4o-mini'],\n * })\n * ```\n */\nexport function createOpenAIProvider(config: OpenAIProviderConfig): Provider {\n  const openaiProvider = createOpenAI({\n    apiKey: config.apiKey,\n    baseURL: config.baseURL,\n    organization: config.organization,\n  })\n  const models = config.models\n\n  return {\n    name: 'openai',\n\n    async sendRequest(request: ProviderRequest): Promise<ProviderResponse> {\n      const messages = toAIMessages(request.messages)\n\n      return executeWithFallback(models, (model) =>\n        sendWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema),\n      )\n    },\n\n    async *sendRequestStream<TState extends BaseState = BaseState>(\n      request: ProviderRequest,\n    ): AsyncGenerator<StreamEvent<TState>> {\n      const messages = toAIMessages(request.messages)\n\n      const { result, reader, first } = await executeWithFallback(models, (model) =>\n        sendStreamWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema),\n      )\n\n      yield* processOpenAIStream<TState>(result, reader, first, 'openai', request.responseSchema)\n    },\n  }\n}\n"]}
+{"version":3,"sources":["../../openai/streamProcessor.ts","../../utils/backoff.ts","../../utils/executeWithFallback.ts","../../openai/index.ts"],"names":["EventType","A3TimeoutError","DEFAULT_RESILIENCE_CONFIG","A3ResilienceError","jsonSchema","generateText","Output","streamText","createOpenAI","resolveResilienceConfig"],"mappings":"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","file":"index.cjs","sourcesContent":["import { EventType } from '@ag-ui/client'\nimport { ZodType } from 'zod'\nimport type { AgentId, StreamEvent, BaseState } from '@genui-a3/core'\nimport type { StreamTextResult, ToolSet } from 'ai'\n\n/**\n * Processes an OpenAI streaming response (via Vercel AI SDK) into AG-UI events.\n *\n * Uses `partialOutputStream` from `streamText` + `Output.object()` to receive\n * progressively-built partial objects. Tracks `chatbotMessage` growth to yield\n * TEXT_MESSAGE_CONTENT deltas. After the stream completes, validates the final\n * object and yields TOOL_CALL_RESULT.\n *\n * @param streamResult - The streamText result containing partialOutputStream and output promise\n * @param reader - Pre-started async iterator for the partial object stream\n * @param first - The first iteration result (already consumed to trigger the API call)\n * @param agentId - Agent identifier for event tagging\n * @param schema - Zod schema for final response validation\n * @returns Async generator of AG-UI stream events\n */\nexport async function* processOpenAIStream<TState extends BaseState = BaseState>(\n  streamResult: StreamTextResult<ToolSet, never>,\n  reader: AsyncIterator<unknown>,\n  first: IteratorResult<unknown>,\n  agentId: AgentId,\n  schema: ZodType,\n): AsyncGenerator<StreamEvent<TState>> {\n  let prevMessageLength = 0\n\n  try {\n    // Process the first partial (already consumed to trigger the API call)\n    if (!first.done) {\n      const partial = first.value as Record<string, unknown>\n      const delta = extractDelta(partial, prevMessageLength)\n      if (delta) {\n        prevMessageLength += delta.length\n        yield {\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: '',\n          delta,\n          agentId,\n        } as StreamEvent<TState>\n      }\n    }\n\n    // Process remaining partials\n    let next = await reader.next()\n    while (!next.done) {\n      const partial = next.value as Record<string, unknown>\n      const delta = extractDelta(partial, prevMessageLength)\n      if (delta) {\n        prevMessageLength += delta.length\n        yield {\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: '',\n          delta,\n          agentId,\n        } as StreamEvent<TState>\n      }\n      // eslint-disable-next-line no-await-in-loop\n      next = await reader.next()\n    }\n\n    // Stream complete — await and validate the final object\n    const finalObject = await streamResult.output\n\n    if (finalObject === null) {\n      yield {\n        type: EventType.RUN_ERROR,\n        message: 'OpenAI stream completed with null output',\n        agentId,\n      } as StreamEvent<TState>\n      return\n    }\n\n    const validated = schema.parse(finalObject)\n    yield {\n      type: EventType.TOOL_CALL_RESULT,\n      toolCallId: '',\n      messageId: '',\n      content: JSON.stringify(validated),\n      agentId,\n    } as StreamEvent<TState>\n  } catch (err) {\n    yield {\n      type: EventType.RUN_ERROR,\n      message: `OpenAI stream error: ${(err as Error).message}`,\n      agentId,\n    } as StreamEvent<TState>\n  }\n}\n\n/**\n * Extracts the new portion of chatbotMessage from a partial object.\n */\nfunction extractDelta(partial: Record<string, unknown>, prevLength: number): string | null {\n  const chatbotMessage = partial.chatbotMessage\n  if (typeof chatbotMessage !== 'string' || chatbotMessage.length <= prevLength) {\n    return null\n  }\n  return chatbotMessage.slice(prevLength)\n}\n","import type { BackoffConfig } from '@genui-a3/core'\n\n/**\n * Calculates the backoff delay for a given retry attempt.\n *\n * @param attempt - Zero-based attempt index (0 = first retry)\n * @param config - Backoff configuration with all fields required\n * @returns Delay in milliseconds\n */\nexport function calculateBackoff(attempt: number, config: Required<BackoffConfig>): number {\n  let delay: number\n\n  switch (config.strategy) {\n    case 'exponential':\n      delay = config.baseDelayMs * Math.pow(2, attempt)\n      break\n    case 'linear':\n      delay = config.baseDelayMs * (attempt + 1)\n      break\n    case 'fixed':\n      delay = config.baseDelayMs\n      break\n  }\n\n  delay = Math.min(delay, config.maxDelayMs)\n\n  if (config.jitter) {\n    delay = Math.random() * delay\n  }\n\n  return delay\n}\n\n/**\n * Sleeps for the specified duration. Can be aborted via an AbortSignal.\n *\n * @param ms - Duration in milliseconds\n * @param signal - Optional AbortSignal to cancel the sleep early\n */\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(signal.reason as Error)\n      return\n    }\n\n    const timer = setTimeout(resolve, ms)\n\n    signal?.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(timer)\n        reject(signal.reason as Error)\n      },\n      { once: true },\n    )\n  })\n}\n","import {\n  A3ResilienceError,\n  A3TimeoutError,\n  DEFAULT_RESILIENCE_CONFIG,\n  type ResilienceErrorEntry,\n  type ResolvedResilienceConfig,\n} from '@genui-a3/core'\nimport { calculateBackoff, sleep } from './backoff'\n\n/**\n * Builds an AbortSignal that fires when either the per-request timeout or total timeout expires.\n */\nfunction buildSignal(requestTimeoutMs?: number, totalAbort?: AbortSignal): AbortSignal | undefined {\n  const signals: AbortSignal[] = []\n\n  if (requestTimeoutMs !== undefined) {\n    signals.push(AbortSignal.timeout(requestTimeoutMs))\n  }\n\n  if (totalAbort) {\n    signals.push(totalAbort)\n  }\n\n  if (signals.length === 0) return undefined\n  if (signals.length === 1) return signals[0]\n  return AbortSignal.any(signals)\n}\n\ntype AttemptResult<T> = { ok: true; value: T } | { ok: false; error: Error }\n\nasync function attemptAction<T>(\n  action: (model: string, signal?: AbortSignal) => Promise<T>,\n  model: string,\n  signal: AbortSignal | undefined,\n  attempt: number,\n  errors: ResilienceErrorEntry[],\n): Promise<AttemptResult<T>> {\n  try {\n    const value = await action(model, signal)\n    return { ok: true, value }\n  } catch (error) {\n    const errorObj = error as Error\n    errors.push({ model, attempt, error: errorObj })\n    return { ok: false, error: errorObj }\n  }\n}\n\nfunction checkTotalTimeout(totalAbort: AbortController | undefined, timeoutMs: number | undefined, errors: ResilienceErrorEntry[]): void {\n  if (totalAbort?.signal.aborted) {\n    throw new A3TimeoutError(`Total timeout of ${timeoutMs}ms exceeded`, errors)\n  }\n}\n\nasync function handleAttemptError(\n  errorObj: Error,\n  attempt: number,\n  maxRetries: number,\n  retryAll: boolean,\n  resolved: ResolvedResilienceConfig,\n  totalAbort: AbortController | undefined,\n): Promise<'retry' | 'next-model'> {\n  const isLastAttempt = attempt === 1 + maxRetries\n  const isRetryable = retryAll || resolved.isRetryableError(errorObj)\n\n  if (isRetryable && !isLastAttempt) {\n    const delay = calculateBackoff(attempt - 1, resolved.backoff)\n    await sleep(delay, totalAbort?.signal).catch(() => {\n      // Sleep was aborted by total timeout — will be caught at top of loop\n    })\n    return 'retry'\n  }\n\n  return 'next-model'\n}\n\n/**\n * Executes an action with model fallback, retry, backoff, and timeout support.\n *\n * For each model (in priority order):\n * 1. Attempts the action up to `1 + maxAttempts` times\n * 2. On transient errors, waits with backoff before retrying\n * 3. On non-retryable errors (or after exhausting retries), falls back to the next model\n *\n * Throws `A3ResilienceError` with full error history when all models are exhausted.\n * Throws `A3TimeoutError` when the total timeout is exceeded.\n *\n * @param models - Model identifiers in priority order\n * @param action - Async action to attempt with each model. Receives an optional AbortSignal.\n * @param config - Resolved resilience configuration (defaults applied if omitted)\n * @returns The result from the first successful attempt\n * @throws {A3ResilienceError} When all models and retries are exhausted\n * @throws {A3TimeoutError} When the total timeout is exceeded\n *\n * @example\n * ```typescript\n * const result = await executeWithFallback(\n *   ['model-primary', 'model-fallback'],\n *   (model, signal) => provider.call(model, params, { abortSignal: signal }),\n *   resolvedConfig,\n * )\n * ```\n */\nexport async function executeWithFallback<T>(\n  models: string[],\n  action: (model: string, signal?: AbortSignal) => Promise<T>,\n  config?: ResolvedResilienceConfig,\n): Promise<T> {\n  const resolved = config ?? DEFAULT_RESILIENCE_CONFIG\n  const errors: ResilienceErrorEntry[] = []\n  const maxRetries = resolved.retry === false ? 0 : resolved.retry.maxAttempts\n  const retryAll = resolved.retry !== false && resolved.retry.retryOn === 'all'\n\n  // Total timeout controller\n  let totalAbort: AbortController | undefined\n  let totalTimer: ReturnType<typeof setTimeout> | undefined\n\n  if (resolved.timeout.totalTimeoutMs !== undefined) {\n    totalAbort = new AbortController()\n    totalTimer = setTimeout(\n      () => totalAbort!.abort(new Error('Total timeout exceeded')),\n      resolved.timeout.totalTimeoutMs,\n    )\n  }\n\n  try {\n    for (let modelIndex = 0; modelIndex < models.length; modelIndex++) {\n      const model = models[modelIndex]\n\n      for (let attempt = 1; attempt <= 1 + maxRetries; attempt++) {\n        checkTotalTimeout(totalAbort, resolved.timeout.totalTimeoutMs, errors)\n\n        const signal = buildSignal(resolved.timeout.requestTimeoutMs, totalAbort?.signal)\n        // eslint-disable-next-line no-await-in-loop\n        const result = await attemptAction(action, model, signal, attempt, errors)\n        if (result.ok) return result.value\n\n        checkTotalTimeout(totalAbort, resolved.timeout.totalTimeoutMs, errors)\n\n        // eslint-disable-next-line no-await-in-loop\n        const decision = await handleAttemptError(result.error, attempt, maxRetries, retryAll, resolved, totalAbort)\n        if (decision === 'next-model') break\n      }\n    }\n\n    // All models exhausted\n    throw new A3ResilienceError(\n      `All models failed after ${errors.length} total attempt(s): ${models.join(', ')}`,\n      errors,\n    )\n  } finally {\n    if (totalTimer !== undefined) {\n      clearTimeout(totalTimer)\n    }\n  }\n}\n","import { createOpenAI } from '@ai-sdk/openai'\nimport { generateText, streamText, Output, ModelMessage, jsonSchema } from 'ai'\nimport {\n  resolveResilienceConfig,\n  type Provider,\n  type ProviderRequest,\n  type ProviderResponse,\n  type ProviderMessage,\n  type BaseState,\n  type StreamEvent,\n  type ResilienceConfig,\n  type ResolvedResilienceConfig,\n} from '@genui-a3/core'\nimport { processOpenAIStream } from './streamProcessor'\nimport { executeWithFallback } from '@providers/utils/executeWithFallback'\n\n/**\n * Configuration for creating an OpenAI provider.\n */\nexport interface OpenAIProviderConfig {\n  /** OpenAI API key. Defaults to OPENAI_API_KEY env var (OpenAI SDK default). */\n  apiKey?: string\n  /**\n   * Model identifiers in order of preference (first = primary, rest = fallbacks).\n   * e.g. ['gpt-4o', 'gpt-4o-mini']\n   */\n  models: string[]\n  /** Optional base URL for Azure OpenAI or compatible endpoints */\n  baseURL?: string\n  /** Optional OpenAI organization ID */\n  organization?: string\n  /** Resilience configuration (retry, backoff, timeout). Uses industry-standard defaults if omitted. */\n  resilience?: ResilienceConfig\n}\n\ntype JsonSchema = Record<string, unknown>\n\n/**\n * Enforces strict JSON schema constraints required by OpenAI's structured output API.\n * OpenAI requires all object properties — including optional ones — to be in the `required` array.\n * This function recursively adds `required` and `additionalProperties: false` to all objects.\n *\n * @param schema - JSON schema to enforce\n * @returns Enforced JSON schema\n */\nfunction enforceStrictSchema(schema: JsonSchema): JsonSchema {\n  const result = { ...schema }\n  if (result.type === 'object' && result.properties) {\n    result.additionalProperties = false\n    result.required = Object.keys(result.properties as Record<string, unknown>)\n    const props = result.properties as Record<string, JsonSchema>\n    const strictProps: Record<string, JsonSchema> = {}\n    for (const [key, value] of Object.entries(props)) {\n      strictProps[key] = enforceStrictSchema(value)\n    }\n    result.properties = strictProps\n  }\n  if (result.items && typeof result.items === 'object') {\n    result.items = enforceStrictSchema(result.items as JsonSchema)\n  }\n  for (const keyword of ['anyOf', 'oneOf', 'allOf'] as const) {\n    if (Array.isArray(result[keyword])) {\n      result[keyword] = (result[keyword] as JsonSchema[]).map((s) => enforceStrictSchema(s))\n    }\n  }\n  return result\n}\n\n/**\n * Converts a Zod schema to an OpenAI-compatible strict JSON schema wrapped for the Vercel AI SDK.\n *\n * @param zodSchema - Zod schema to convert\n * @returns JSON schema wrapped for Vercel AI SDK\n */\nfunction toOpenAISchema(zodSchema: ProviderRequest['responseSchema']) {\n  const strict = enforceStrictSchema(zodSchema.toJSONSchema() as JsonSchema)\n  return jsonSchema(strict as never, {\n    validate: (value: unknown) => {\n      const result = zodSchema.safeParse(value)\n      return result.success\n        ? { success: true as const, value: result.data }\n        : { success: false as const, error: result.error }\n    },\n  })\n}\n\nfunction toAIMessages(messages: ProviderMessage[]): ModelMessage[] {\n  return messages.map((msg) => ({\n    role: msg.role,\n    content: msg.content,\n  }))\n}\n\nasync function sendWithModel(\n  openaiProvider: ReturnType<typeof createOpenAI>,\n  model: string,\n  system: string,\n  messages: ModelMessage[],\n  schema: ProviderRequest['responseSchema'],\n): Promise<ProviderResponse> {\n  const result = await generateText({\n    model: openaiProvider(model),\n    system,\n    messages,\n    output: Output.object({ schema: toOpenAISchema(schema) }),\n  })\n\n  return {\n    content: JSON.stringify(result.output),\n    usage: {\n      inputTokens: result.usage.inputTokens ?? 0,\n      outputTokens: result.usage.outputTokens ?? 0,\n      totalTokens: (result.usage.inputTokens ?? 0) + (result.usage.outputTokens ?? 0),\n    },\n  }\n}\n\nasync function sendStreamWithModel(\n  openaiProvider: ReturnType<typeof createOpenAI>,\n  model: string,\n  system: string,\n  messages: ModelMessage[],\n  schema: ProviderRequest['responseSchema'],\n) {\n  const result = streamText({\n    model: openaiProvider(model),\n    system,\n    messages,\n    output: Output.object({ schema: toOpenAISchema(schema) }),\n  })\n\n  // Force the API call to start so executeWithFallback can catch connection errors\n  const partialStream = result.partialOutputStream\n  const reader = partialStream[Symbol.asyncIterator]()\n  const first = await reader.next()\n\n  return { result, reader, first }\n}\n\n/**\n * Creates an OpenAI provider instance.\n *\n * Uses the Vercel AI SDK (`ai` + `@ai-sdk/openai`) for structured output via\n * `generateText` + `Output.object()` (blocking) and `streamText` + `Output.object()`\n * (streaming). The AI SDK handles Zod-to-JSON-schema conversion, partial JSON\n * parsing, and validation internally.\n *\n * @param config - OpenAI provider configuration\n * @returns A Provider implementation using OpenAI\n *\n * @example\n * ```typescript\n * const provider = createOpenAIProvider({\n *   models: ['gpt-4o', 'gpt-4o-mini'],\n * })\n * ```\n */\nexport function createOpenAIProvider(config: OpenAIProviderConfig): Provider {\n  const openaiProvider = createOpenAI({\n    apiKey: config.apiKey,\n    baseURL: config.baseURL,\n    organization: config.organization,\n  })\n  const models = config.models\n  const resilience: ResolvedResilienceConfig = resolveResilienceConfig(config.resilience)\n\n  return {\n    name: 'openai',\n\n    async sendRequest(request: ProviderRequest): Promise<ProviderResponse> {\n      const messages = toAIMessages(request.messages)\n\n      return executeWithFallback(\n        models,\n        (model) => sendWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema),\n        resilience,\n      )\n    },\n\n    async *sendRequestStream<TState extends BaseState = BaseState>(\n      request: ProviderRequest,\n    ): AsyncGenerator<StreamEvent<TState>> {\n      const messages = toAIMessages(request.messages)\n\n      const { result, reader, first } = await executeWithFallback(\n        models,\n        (model) => sendStreamWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema),\n        resilience,\n      )\n\n      yield* processOpenAIStream<TState>(result, reader, first, 'openai', request.responseSchema)\n    },\n  }\n}\n"]}

package/dist/openai/index.d.cts

@@ -1,4 +1,4 @@
-import { Provider } from '@genui-a3/core';
+import { ResilienceConfig, Provider } from '@genui-a3/core';
 
 /**
  * Configuration for creating an OpenAI provider.
@@ -15,6 +15,8 @@ interface OpenAIProviderConfig {
     baseURL?: string;
     /** Optional OpenAI organization ID */
     organization?: string;
+    /** Resilience configuration (retry, backoff, timeout). Uses industry-standard defaults if omitted. */
+    resilience?: ResilienceConfig;
 }
 /**
  * Creates an OpenAI provider instance.

package/dist/openai/index.d.ts

@@ -1,4 +1,4 @@
-import { Provider } from '@genui-a3/core';
+import { ResilienceConfig, Provider } from '@genui-a3/core';
 
 /**
  * Configuration for creating an OpenAI provider.
@@ -15,6 +15,8 @@ interface OpenAIProviderConfig {
     baseURL?: string;
     /** Optional OpenAI organization ID */
     organization?: string;
+    /** Resilience configuration (retry, backoff, timeout). Uses industry-standard defaults if omitted. */
+    resilience?: ResilienceConfig;
 }
 /**
  * Creates an OpenAI provider instance.

package/dist/openai/index.js

@@ -1,5 +1,6 @@
 import { createOpenAI } from '@ai-sdk/openai';
 import { streamText, Output, jsonSchema, generateText } from 'ai';
+import { resolveResilienceConfig, DEFAULT_RESILIENCE_CONFIG, A3ResilienceError, A3TimeoutError } from '@genui-a3/core';
 import { EventType } from '@ag-ui/client';
 
 // openai/index.ts
@@ -67,20 +68,119 @@ function extractDelta(partial, prevLength) {
   return chatbotMessage.slice(prevLength);
 }
 
+// utils/backoff.ts
+function calculateBackoff(attempt, config) {
+  let delay;
+  switch (config.strategy) {
+    case "exponential":
+      delay = config.baseDelayMs * Math.pow(2, attempt);
+      break;
+    case "linear":
+      delay = config.baseDelayMs * (attempt + 1);
+      break;
+    case "fixed":
+      delay = config.baseDelayMs;
+      break;
+  }
+  delay = Math.min(delay, config.maxDelayMs);
+  if (config.jitter) {
+    delay = Math.random() * delay;
+  }
+  return delay;
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+      reject(signal.reason);
+      return;
+    }
+    const timer = setTimeout(resolve, ms);
+    signal?.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(timer);
+        reject(signal.reason);
+      },
+      { once: true }
+    );
+  });
+}
+
 // utils/executeWithFallback.ts
-async function executeWithFallback(models, action) {
-  for (let i = 0; i < models.length; i++) {
-    const model = models[i];
-    try {
-      return await action(model);
-    } catch (error) {
-      const errorObj = error;
-      if (i === models.length - 1) {
-        throw errorObj;
+function buildSignal(requestTimeoutMs, totalAbort) {
+  const signals = [];
+  if (requestTimeoutMs !== void 0) {
+    signals.push(AbortSignal.timeout(requestTimeoutMs));
+  }
+  if (totalAbort) {
+    signals.push(totalAbort);
+  }
+  if (signals.length === 0) return void 0;
+  if (signals.length === 1) return signals[0];
+  return AbortSignal.any(signals);
+}
+async function attemptAction(action, model, signal, attempt, errors) {
+  try {
+    const value = await action(model, signal);
+    return { ok: true, value };
+  } catch (error) {
+    const errorObj = error;
+    errors.push({ model, attempt, error: errorObj });
+    return { ok: false, error: errorObj };
+  }
+}
+function checkTotalTimeout(totalAbort, timeoutMs, errors) {
+  if (totalAbort?.signal.aborted) {
+    throw new A3TimeoutError(`Total timeout of ${timeoutMs}ms exceeded`, errors);
+  }
+}
+async function handleAttemptError(errorObj, attempt, maxRetries, retryAll, resolved, totalAbort) {
+  const isLastAttempt = attempt === 1 + maxRetries;
+  const isRetryable = retryAll || resolved.isRetryableError(errorObj);
+  if (isRetryable && !isLastAttempt) {
+    const delay = calculateBackoff(attempt - 1, resolved.backoff);
+    await sleep(delay, totalAbort?.signal).catch(() => {
+    });
+    return "retry";
+  }
+  return "next-model";
+}
+async function executeWithFallback(models, action, config) {
+  const resolved = config ?? DEFAULT_RESILIENCE_CONFIG;
+  const errors = [];
+  const maxRetries = resolved.retry === false ? 0 : resolved.retry.maxAttempts;
+  const retryAll = resolved.retry !== false && resolved.retry.retryOn === "all";
+  let totalAbort;
+  let totalTimer;
+  if (resolved.timeout.totalTimeoutMs !== void 0) {
+    totalAbort = new AbortController();
+    totalTimer = setTimeout(
+      () => totalAbort.abort(new Error("Total timeout exceeded")),
+      resolved.timeout.totalTimeoutMs
+    );
+  }
+  try {
+    for (let modelIndex = 0; modelIndex < models.length; modelIndex++) {
+      const model = models[modelIndex];
+      for (let attempt = 1; attempt <= 1 + maxRetries; attempt++) {
+        checkTotalTimeout(totalAbort, resolved.timeout.totalTimeoutMs, errors);
+        const signal = buildSignal(resolved.timeout.requestTimeoutMs, totalAbort?.signal);
+        const result = await attemptAction(action, model, signal, attempt, errors);
+        if (result.ok) return result.value;
+        checkTotalTimeout(totalAbort, resolved.timeout.totalTimeoutMs, errors);
+        const decision = await handleAttemptError(result.error, attempt, maxRetries, retryAll, resolved, totalAbort);
+        if (decision === "next-model") break;
       }
     }
+    throw new A3ResilienceError(
+      `All models failed after ${errors.length} total attempt(s): ${models.join(", ")}`,
+      errors
+    );
+  } finally {
+    if (totalTimer !== void 0) {
+      clearTimeout(totalTimer);
+    }
   }
-  throw new Error("All models failed");
 }
 
 // openai/index.ts
@@ -156,20 +256,23 @@ function createOpenAIProvider(config) {
     organization: config.organization
   });
   const models = config.models;
+  const resilience = resolveResilienceConfig(config.resilience);
   return {
     name: "openai",
     async sendRequest(request) {
       const messages = toAIMessages(request.messages);
       return executeWithFallback(
         models,
-        (model) => sendWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema)
+        (model) => sendWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema),
+        resilience
       );
     },
     async *sendRequestStream(request) {
       const messages = toAIMessages(request.messages);
       const { result, reader, first } = await executeWithFallback(
         models,
-        (model) => sendStreamWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema)
+        (model) => sendStreamWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema),
+        resilience
       );
       yield* processOpenAIStream(result, reader, first, "openai", request.responseSchema);
     }

package/dist/openai/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../openai/streamProcessor.ts","../../utils/executeWithFallback.ts","../../openai/index.ts"],"names":[],"mappings":";;;;;AAoBA,gBAAuB,mBAAA,CACrB,YAAA,EACA,MAAA,EACA,KAAA,EACA,SACA,MAAA,EACqC;AACrC,EAAA,IAAI,iBAAA,GAAoB,CAAA;AAExB,EAAA,IAAI;AAEF,IAAA,IAAI,CAAC,MAAM,IAAA,EAAM;AACf,MAAA,MAAM,UAAU,KAAA,CAAM,KAAA;AACtB,MAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,OAAA,EAAS,iBAAiB,CAAA;AACrD,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,iBAAA,IAAqB,KAAA,CAAM,MAAA;AAC3B,QAAA,MAAM;AAAA,UACJ,MAAM,SAAA,CAAU,oBAAA;AAAA,UAChB,SAAA,EAAW,EAAA;AAAA,UACX,KAAA;AAAA,UACA;AAAA,SACF;AAAA,MACF;AAAA,IACF;AAGA,IAAA,IAAI,IAAA,GAAO,MAAM,MAAA,CAAO,IAAA,EAAK;AAC7B,IAAA,OAAO,CAAC,KAAK,IAAA,EAAM;AACjB,MAAA,MAAM,UAAU,IAAA,CAAK,KAAA;AACrB,MAAA,MAAM,KAAA,GAAQ,YAAA,CAAa,OAAA,EAAS,iBAAiB,CAAA;AACrD,MAAA,IAAI,KAAA,EAAO;AACT,QAAA,iBAAA,IAAqB,KAAA,CAAM,MAAA;AAC3B,QAAA,MAAM;AAAA,UACJ,MAAM,SAAA,CAAU,oBAAA;AAAA,UAChB,SAAA,EAAW,EAAA;AAAA,UACX,KAAA;AAAA,UACA;AAAA,SACF;AAAA,MACF;AAEA,MAAA,IAAA,GAAO,MAAM,OAAO,IAAA,EAAK;AAAA,IAC3B;AAGA,IAAA,MAAM,WAAA,GAAc,MAAM,YAAA,CAAa,MAAA;AAEvC,IAAA,IAAI,gBAAgB,IAAA,EAAM;AACxB,MAAA,MAAM;AAAA,QACJ,MAAM,SAAA,CAAU,SAAA;AAAA,QAChB,OAAA,EAAS,0CAAA;AAAA,QACT;AAAA,OACF;AACA,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,SAAA,GAAY,MAAA,CAAO,KAAA,CAAM,WAAW,CAAA;AAC1C,IAAA,MAAM;AAAA,MACJ,MAAM,SAAA,CAAU,gBAAA;AAAA,MAChB,UAAA,EAAY,EAAA;AAAA,MACZ,SAAA,EAAW,EAAA;AAAA,MACX,OAAA,EAAS,IAAA,CAAK,SAAA,CAAU,SAAS,CAAA;AAAA,MACjC;AAAA,KACF;AAAA,EACF,SAAS,GAAA,EAAK;AACZ,IAAA,MAAM;AAAA,MACJ,MAAM,SAAA,CAAU,SAAA;AAAA,MAChB,OAAA,EAAS,CAAA,qBAAA,EAAyB,GAAA,CAAc,OAAO,CAAA,CAAA;AAAA,MACvD;AAAA,KACF;AAAA,EACF;AACF;AAKA,SAAS,YAAA,CAAa,SAAkC,UAAA,EAAmC;AACzF,EAAA,MAAM,iBAAiB,OAAA,CAAQ,cAAA;AAC/B,EAAA,IAAI,OAAO,cAAA,KAAmB,QAAA,IAAY,cAAA,CAAe,UAAU,UAAA,EAAY;AAC7E,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,cAAA,CAAe,MAAM,UAAU,CAAA;AACxC;;;ACnFA,eAAsB,mBAAA,CAAuB,QAAkB,MAAA,EAAmD;AAGhH,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,MAAA,CAAO,QAAQ,CAAA,EAAA,EAAK;AACtC,IAAA,MAAM,KAAA,GAAQ,OAAO,CAAC,CAAA;AAEtB,IAAA,IAAI;AAEF,MAAA,OAAO,MAAM,OAAO,KAAK,CAAA;AAAA,IAC3B,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,QAAA,GAAW,KAAA;AAGjB,MAAA,IAAI,CAAA,KAAM,MAAA,CAAO,MAAA,GAAS,CAAA,EAAG;AAC3B,QAAA,MAAM,QAAA;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,EAAA,MAAM,IAAI,MAAM,mBAAmB,CAAA;AACrC;;;ACEA,SAAS,oBAAoB,MAAA,EAAgC;AAC3D,EAAA,MAAM,MAAA,GAAS,EAAE,GAAG,MAAA,EAAO;AAC3B,EAAA,IAAI,MAAA,CAAO,IAAA,KAAS,QAAA,IAAY,MAAA,CAAO,UAAA,EAAY;AACjD,IAAA,MAAA,CAAO,oBAAA,GAAuB,KAAA;AAC9B,IAAA,MAAA,CAAO,QAAA,GAAW,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,UAAqC,CAAA;AAC1E,IAAA,MAAM,QAAQ,MAAA,CAAO,UAAA;AACrB,IAAA,MAAM,cAA0C,EAAC;AACjD,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,KAAK,CAAA,EAAG;AAChD,MAAA,WAAA,CAAY,GAAG,CAAA,GAAI,mBAAA,CAAoB,KAAK,CAAA;AAAA,IAC9C;AACA,IAAA,MAAA,CAAO,UAAA,GAAa,WAAA;AAAA,EACtB;AACA,EAAA,IAAI,MAAA,CAAO,KAAA,IAAS,OAAO,MAAA,CAAO,UAAU,QAAA,EAAU;AACpD,IAAA,MAAA,CAAO,KAAA,GAAQ,mBAAA,CAAoB,MAAA,CAAO,KAAmB,CAAA;AAAA,EAC/D;AACA,EAAA,KAAA,MAAW,OAAA,IAAW,CAAC,OAAA,EAAS,OAAA,EAAS,OAAO,CAAA,EAAY;AAC1D,IAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,MAAA,CAAO,OAAO,CAAC,CAAA,EAAG;AAClC,MAAA,MAAA,CAAO,OAAO,CAAA,GAAK,MAAA,CAAO,OAAO,CAAA,CAAmB,IAAI,CAAC,CAAA,KAAM,mBAAA,CAAoB,CAAC,CAAC,CAAA;AAAA,IACvF;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;AAQA,SAAS,eAAe,SAAA,EAA8C;AACpE,EAAA,MAAM,MAAA,GAAS,mBAAA,CAAoB,SAAA,CAAU,YAAA,EAA4B,CAAA;AACzE,EAAA,OAAO,WAAW,MAAA,EAAiB;AAAA,IACjC,QAAA,EAAU,CAAC,KAAA,KAAmB;AAC5B,MAAA,MAAM,MAAA,GAAS,SAAA,CAAU,SAAA,CAAU,KAAK,CAAA;AACxC,MAAA,OAAO,MAAA,CAAO,OAAA,GACV,EAAE,OAAA,EAAS,MAAe,KAAA,EAAO,MAAA,CAAO,IAAA,EAAK,GAC7C,EAAE,OAAA,EAAS,KAAA,EAAgB,KAAA,EAAO,OAAO,KAAA,EAAM;AAAA,IACrD;AAAA,GACD,CAAA;AACH;AAEA,SAAS,aAAa,QAAA,EAA6C;AACjE,EAAA,OAAO,QAAA,CAAS,GAAA,CAAI,CAAC,GAAA,MAAS;AAAA,IAC5B,MAAM,GAAA,CAAI,IAAA;AAAA,IACV,SAAS,GAAA,CAAI;AAAA,GACf,CAAE,CAAA;AACJ;AAEA,eAAe,aAAA,CACb,cAAA,EACA,KAAA,EACA,MAAA,EACA,UACA,MAAA,EAC2B;AAC3B,EAAA,MAAM,MAAA,GAAS,MAAM,YAAA,CAAa;AAAA,IAChC,KAAA,EAAO,eAAe,KAAK,CAAA;AAAA,IAC3B,MAAA;AAAA,IACA,QAAA;AAAA,IACA,MAAA,EAAQ,OAAO,MAAA,CAAO,EAAE,QAAQ,cAAA,CAAe,MAAM,GAAG;AAAA,GACzD,CAAA;AAED,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,IAAA,CAAK,SAAA,CAAU,MAAA,CAAO,MAAM,CAAA;AAAA,IACrC,KAAA,EAAO;AAAA,MACL,WAAA,EAAa,MAAA,CAAO,KAAA,CAAM,WAAA,IAAe,CAAA;AAAA,MACzC,YAAA,EAAc,MAAA,CAAO,KAAA,CAAM,YAAA,IAAgB,CAAA;AAAA,MAC3C,cAAc,MAAA,CAAO,KAAA,CAAM,eAAe,CAAA,KAAM,MAAA,CAAO,MAAM,YAAA,IAAgB,CAAA;AAAA;AAC/E,GACF;AACF;AAEA,eAAe,mBAAA,CACb,cAAA,EACA,KAAA,EACA,MAAA,EACA,UACA,MAAA,EACA;AACA,EAAA,MAAM,SAAS,UAAA,CAAW;AAAA,IACxB,KAAA,EAAO,eAAe,KAAK,CAAA;AAAA,IAC3B,MAAA;AAAA,IACA,QAAA;AAAA,IACA,MAAA,EAAQ,OAAO,MAAA,CAAO,EAAE,QAAQ,cAAA,CAAe,MAAM,GAAG;AAAA,GACzD,CAAA;AAGD,EAAA,MAAM,gBAAgB,MAAA,CAAO,mBAAA;AAC7B,EAAA,MAAM,MAAA,GAAS,aAAA,CAAc,MAAA,CAAO,aAAa,CAAA,EAAE;AACnD,EAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,CAAO,IAAA,EAAK;AAEhC,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAM;AACjC;AAoBO,SAAS,qBAAqB,MAAA,EAAwC;AAC3E,EAAA,MAAM,iBAAiB,YAAA,CAAa;AAAA,IAClC,QAAQ,MAAA,CAAO,MAAA;AAAA,IACf,SAAS,MAAA,CAAO,OAAA;AAAA,IAChB,cAAc,MAAA,CAAO;AAAA,GACtB,CAAA;AACD,EAAA,MAAM,SAAS,MAAA,CAAO,MAAA;AAEtB,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,QAAA;AAAA,IAEN,MAAM,YAAY,OAAA,EAAqD;AACrE,MAAA,MAAM,QAAA,GAAW,YAAA,CAAa,OAAA,CAAQ,QAAQ,CAAA;AAE9C,MAAA,OAAO,mBAAA;AAAA,QAAoB,MAAA;AAAA,QAAQ,CAAC,UAClC,aAAA,CAAc,cAAA,EAAgB,OAAO,OAAA,CAAQ,YAAA,EAAc,QAAA,EAAU,OAAA,CAAQ,cAAc;AAAA,OAC7F;AAAA,IACF,CAAA;AAAA,IAEA,OAAO,kBACL,OAAA,EACqC;AACrC,MAAA,MAAM,QAAA,GAAW,YAAA,CAAa,OAAA,CAAQ,QAAQ,CAAA;AAE9C,MAAA,MAAM,EAAE,MAAA,EAAQ,MAAA,EAAQ,KAAA,KAAU,MAAM,mBAAA;AAAA,QAAoB,MAAA;AAAA,QAAQ,CAAC,UACnE,mBAAA,CAAoB,cAAA,EAAgB,OAAO,OAAA,CAAQ,YAAA,EAAc,QAAA,EAAU,OAAA,CAAQ,cAAc;AAAA,OACnG;AAEA,MAAA,OAAO,oBAA4B,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,QAAA,EAAU,QAAQ,cAAc,CAAA;AAAA,IAC5F;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import { EventType } from '@ag-ui/client'\nimport { ZodType } from 'zod'\nimport type { AgentId, StreamEvent, BaseState } from '@genui-a3/core'\nimport type { StreamTextResult, ToolSet } from 'ai'\n\n/**\n * Processes an OpenAI streaming response (via Vercel AI SDK) into AG-UI events.\n *\n * Uses `partialOutputStream` from `streamText` + `Output.object()` to receive\n * progressively-built partial objects. Tracks `chatbotMessage` growth to yield\n * TEXT_MESSAGE_CONTENT deltas. After the stream completes, validates the final\n * object and yields TOOL_CALL_RESULT.\n *\n * @param streamResult - The streamText result containing partialOutputStream and output promise\n * @param reader - Pre-started async iterator for the partial object stream\n * @param first - The first iteration result (already consumed to trigger the API call)\n * @param agentId - Agent identifier for event tagging\n * @param schema - Zod schema for final response validation\n * @returns Async generator of AG-UI stream events\n */\nexport async function* processOpenAIStream<TState extends BaseState = BaseState>(\n  streamResult: StreamTextResult<ToolSet, never>,\n  reader: AsyncIterator<unknown>,\n  first: IteratorResult<unknown>,\n  agentId: AgentId,\n  schema: ZodType,\n): AsyncGenerator<StreamEvent<TState>> {\n  let prevMessageLength = 0\n\n  try {\n    // Process the first partial (already consumed to trigger the API call)\n    if (!first.done) {\n      const partial = first.value as Record<string, unknown>\n      const delta = extractDelta(partial, prevMessageLength)\n      if (delta) {\n        prevMessageLength += delta.length\n        yield {\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: '',\n          delta,\n          agentId,\n        } as StreamEvent<TState>\n      }\n    }\n\n    // Process remaining partials\n    let next = await reader.next()\n    while (!next.done) {\n      const partial = next.value as Record<string, unknown>\n      const delta = extractDelta(partial, prevMessageLength)\n      if (delta) {\n        prevMessageLength += delta.length\n        yield {\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: '',\n          delta,\n          agentId,\n        } as StreamEvent<TState>\n      }\n      // eslint-disable-next-line no-await-in-loop\n      next = await reader.next()\n    }\n\n    // Stream complete — await and validate the final object\n    const finalObject = await streamResult.output\n\n    if (finalObject === null) {\n      yield {\n        type: EventType.RUN_ERROR,\n        message: 'OpenAI stream completed with null output',\n        agentId,\n      } as StreamEvent<TState>\n      return\n    }\n\n    const validated = schema.parse(finalObject)\n    yield {\n      type: EventType.TOOL_CALL_RESULT,\n      toolCallId: '',\n      messageId: '',\n      content: JSON.stringify(validated),\n      agentId,\n    } as StreamEvent<TState>\n  } catch (err) {\n    yield {\n      type: EventType.RUN_ERROR,\n      message: `OpenAI stream error: ${(err as Error).message}`,\n      agentId,\n    } as StreamEvent<TState>\n  }\n}\n\n/**\n * Extracts the new portion of chatbotMessage from a partial object.\n */\nfunction extractDelta(partial: Record<string, unknown>, prevLength: number): string | null {\n  const chatbotMessage = partial.chatbotMessage\n  if (typeof chatbotMessage !== 'string' || chatbotMessage.length <= prevLength) {\n    return null\n  }\n  return chatbotMessage.slice(prevLength)\n}\n","/**\n * Executes an action with model fallback support.\n * Tries each model in order; if one fails, falls back to the next.\n * Throws the last error if all models fail.\n *\n * @param models - Model identifiers in priority order\n * @param action - Async action to attempt with each model\n * @returns The result from the first successful model\n * @throws The error from the last model if all fail\n *\n * @example\n * ```typescript\n * const result = await executeWithFallback(\n *   ['model-primary', 'model-fallback'],\n *   (model) => provider.call(model, params),\n * )\n * ```\n */\nexport async function executeWithFallback<T>(models: string[], action: (model: string) => Promise<T>): Promise<T> {\n  const errors: Array<{ model: string; error: Error }> = []\n\n  for (let i = 0; i < models.length; i++) {\n    const model = models[i]\n\n    try {\n      // eslint-disable-next-line no-await-in-loop\n      return await action(model)\n    } catch (error) {\n      const errorObj = error as Error\n      errors.push({ model, error: errorObj })\n\n      if (i === models.length - 1) {\n        throw errorObj\n      }\n    }\n  }\n\n  throw new Error('All models failed')\n}\n","import { createOpenAI } from '@ai-sdk/openai'\nimport { generateText, streamText, Output, ModelMessage, jsonSchema } from 'ai'\nimport type {\n  Provider,\n  ProviderRequest,\n  ProviderResponse,\n  ProviderMessage,\n  BaseState,\n  StreamEvent,\n} from '@genui-a3/core'\nimport { processOpenAIStream } from './streamProcessor'\nimport { executeWithFallback } from '../utils/executeWithFallback'\n\n/**\n * Configuration for creating an OpenAI provider.\n */\nexport interface OpenAIProviderConfig {\n  /** OpenAI API key. Defaults to OPENAI_API_KEY env var (OpenAI SDK default). */\n  apiKey?: string\n  /**\n   * Model identifiers in order of preference (first = primary, rest = fallbacks).\n   * e.g. ['gpt-4o', 'gpt-4o-mini']\n   */\n  models: string[]\n  /** Optional base URL for Azure OpenAI or compatible endpoints */\n  baseURL?: string\n  /** Optional OpenAI organization ID */\n  organization?: string\n}\n\ntype JsonSchema = Record<string, unknown>\n\n/**\n * Enforces strict JSON schema constraints required by OpenAI's structured output API.\n * OpenAI requires all object properties — including optional ones — to be in the `required` array.\n * This function recursively adds `required` and `additionalProperties: false` to all objects.\n *\n * @param schema - JSON schema to enforce\n * @returns Enforced JSON schema\n */\nfunction enforceStrictSchema(schema: JsonSchema): JsonSchema {\n  const result = { ...schema }\n  if (result.type === 'object' && result.properties) {\n    result.additionalProperties = false\n    result.required = Object.keys(result.properties as Record<string, unknown>)\n    const props = result.properties as Record<string, JsonSchema>\n    const strictProps: Record<string, JsonSchema> = {}\n    for (const [key, value] of Object.entries(props)) {\n      strictProps[key] = enforceStrictSchema(value)\n    }\n    result.properties = strictProps\n  }\n  if (result.items && typeof result.items === 'object') {\n    result.items = enforceStrictSchema(result.items as JsonSchema)\n  }\n  for (const keyword of ['anyOf', 'oneOf', 'allOf'] as const) {\n    if (Array.isArray(result[keyword])) {\n      result[keyword] = (result[keyword] as JsonSchema[]).map((s) => enforceStrictSchema(s))\n    }\n  }\n  return result\n}\n\n/**\n * Converts a Zod schema to an OpenAI-compatible strict JSON schema wrapped for the Vercel AI SDK.\n *\n * @param zodSchema - Zod schema to convert\n * @returns JSON schema wrapped for Vercel AI SDK\n */\nfunction toOpenAISchema(zodSchema: ProviderRequest['responseSchema']) {\n  const strict = enforceStrictSchema(zodSchema.toJSONSchema() as JsonSchema)\n  return jsonSchema(strict as never, {\n    validate: (value: unknown) => {\n      const result = zodSchema.safeParse(value)\n      return result.success\n        ? { success: true as const, value: result.data }\n        : { success: false as const, error: result.error }\n    },\n  })\n}\n\nfunction toAIMessages(messages: ProviderMessage[]): ModelMessage[] {\n  return messages.map((msg) => ({\n    role: msg.role,\n    content: msg.content,\n  }))\n}\n\nasync function sendWithModel(\n  openaiProvider: ReturnType<typeof createOpenAI>,\n  model: string,\n  system: string,\n  messages: ModelMessage[],\n  schema: ProviderRequest['responseSchema'],\n): Promise<ProviderResponse> {\n  const result = await generateText({\n    model: openaiProvider(model),\n    system,\n    messages,\n    output: Output.object({ schema: toOpenAISchema(schema) }),\n  })\n\n  return {\n    content: JSON.stringify(result.output),\n    usage: {\n      inputTokens: result.usage.inputTokens ?? 0,\n      outputTokens: result.usage.outputTokens ?? 0,\n      totalTokens: (result.usage.inputTokens ?? 0) + (result.usage.outputTokens ?? 0),\n    },\n  }\n}\n\nasync function sendStreamWithModel(\n  openaiProvider: ReturnType<typeof createOpenAI>,\n  model: string,\n  system: string,\n  messages: ModelMessage[],\n  schema: ProviderRequest['responseSchema'],\n) {\n  const result = streamText({\n    model: openaiProvider(model),\n    system,\n    messages,\n    output: Output.object({ schema: toOpenAISchema(schema) }),\n  })\n\n  // Force the API call to start so executeWithFallback can catch connection errors\n  const partialStream = result.partialOutputStream\n  const reader = partialStream[Symbol.asyncIterator]()\n  const first = await reader.next()\n\n  return { result, reader, first }\n}\n\n/**\n * Creates an OpenAI provider instance.\n *\n * Uses the Vercel AI SDK (`ai` + `@ai-sdk/openai`) for structured output via\n * `generateText` + `Output.object()` (blocking) and `streamText` + `Output.object()`\n * (streaming). The AI SDK handles Zod-to-JSON-schema conversion, partial JSON\n * parsing, and validation internally.\n *\n * @param config - OpenAI provider configuration\n * @returns A Provider implementation using OpenAI\n *\n * @example\n * ```typescript\n * const provider = createOpenAIProvider({\n *   models: ['gpt-4o', 'gpt-4o-mini'],\n * })\n * ```\n */\nexport function createOpenAIProvider(config: OpenAIProviderConfig): Provider {\n  const openaiProvider = createOpenAI({\n    apiKey: config.apiKey,\n    baseURL: config.baseURL,\n    organization: config.organization,\n  })\n  const models = config.models\n\n  return {\n    name: 'openai',\n\n    async sendRequest(request: ProviderRequest): Promise<ProviderResponse> {\n      const messages = toAIMessages(request.messages)\n\n      return executeWithFallback(models, (model) =>\n        sendWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema),\n      )\n    },\n\n    async *sendRequestStream<TState extends BaseState = BaseState>(\n      request: ProviderRequest,\n    ): AsyncGenerator<StreamEvent<TState>> {\n      const messages = toAIMessages(request.messages)\n\n      const { result, reader, first } = await executeWithFallback(models, (model) =>\n        sendStreamWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema),\n      )\n\n      yield* processOpenAIStream<TState>(result, reader, first, 'openai', request.responseSchema)\n    },\n  }\n}\n"]}
+{"version":3,"sources":["../../openai/streamProcessor.ts","../../utils/backoff.ts","../../utils/executeWithFallback.ts","../../openai/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { EventType } from '@ag-ui/client'\nimport { ZodType } from 'zod'\nimport type { AgentId, StreamEvent, BaseState } from '@genui-a3/core'\nimport type { StreamTextResult, ToolSet } from 'ai'\n\n/**\n * Processes an OpenAI streaming response (via Vercel AI SDK) into AG-UI events.\n *\n * Uses `partialOutputStream` from `streamText` + `Output.object()` to receive\n * progressively-built partial objects. Tracks `chatbotMessage` growth to yield\n * TEXT_MESSAGE_CONTENT deltas. After the stream completes, validates the final\n * object and yields TOOL_CALL_RESULT.\n *\n * @param streamResult - The streamText result containing partialOutputStream and output promise\n * @param reader - Pre-started async iterator for the partial object stream\n * @param first - The first iteration result (already consumed to trigger the API call)\n * @param agentId - Agent identifier for event tagging\n * @param schema - Zod schema for final response validation\n * @returns Async generator of AG-UI stream events\n */\nexport async function* processOpenAIStream<TState extends BaseState = BaseState>(\n  streamResult: StreamTextResult<ToolSet, never>,\n  reader: AsyncIterator<unknown>,\n  first: IteratorResult<unknown>,\n  agentId: AgentId,\n  schema: ZodType,\n): AsyncGenerator<StreamEvent<TState>> {\n  let prevMessageLength = 0\n\n  try {\n    // Process the first partial (already consumed to trigger the API call)\n    if (!first.done) {\n      const partial = first.value as Record<string, unknown>\n      const delta = extractDelta(partial, prevMessageLength)\n      if (delta) {\n        prevMessageLength += delta.length\n        yield {\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: '',\n          delta,\n          agentId,\n        } as StreamEvent<TState>\n      }\n    }\n\n    // Process remaining partials\n    let next = await reader.next()\n    while (!next.done) {\n      const partial = next.value as Record<string, unknown>\n      const delta = extractDelta(partial, prevMessageLength)\n      if (delta) {\n        prevMessageLength += delta.length\n        yield {\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: '',\n          delta,\n          agentId,\n        } as StreamEvent<TState>\n      }\n      // eslint-disable-next-line no-await-in-loop\n      next = await reader.next()\n    }\n\n    // Stream complete — await and validate the final object\n    const finalObject = await streamResult.output\n\n    if (finalObject === null) {\n      yield {\n        type: EventType.RUN_ERROR,\n        message: 'OpenAI stream completed with null output',\n        agentId,\n      } as StreamEvent<TState>\n      return\n    }\n\n    const validated = schema.parse(finalObject)\n    yield {\n      type: EventType.TOOL_CALL_RESULT,\n      toolCallId: '',\n      messageId: '',\n      content: JSON.stringify(validated),\n      agentId,\n    } as StreamEvent<TState>\n  } catch (err) {\n    yield {\n      type: EventType.RUN_ERROR,\n      message: `OpenAI stream error: ${(err as Error).message}`,\n      agentId,\n    } as StreamEvent<TState>\n  }\n}\n\n/**\n * Extracts the new portion of chatbotMessage from a partial object.\n */\nfunction extractDelta(partial: Record<string, unknown>, prevLength: number): string | null {\n  const chatbotMessage = partial.chatbotMessage\n  if (typeof chatbotMessage !== 'string' || chatbotMessage.length <= prevLength) {\n    return null\n  }\n  return chatbotMessage.slice(prevLength)\n}\n","import type { BackoffConfig } from '@genui-a3/core'\n\n/**\n * Calculates the backoff delay for a given retry attempt.\n *\n * @param attempt - Zero-based attempt index (0 = first retry)\n * @param config - Backoff configuration with all fields required\n * @returns Delay in milliseconds\n */\nexport function calculateBackoff(attempt: number, config: Required<BackoffConfig>): number {\n  let delay: number\n\n  switch (config.strategy) {\n    case 'exponential':\n      delay = config.baseDelayMs * Math.pow(2, attempt)\n      break\n    case 'linear':\n      delay = config.baseDelayMs * (attempt + 1)\n      break\n    case 'fixed':\n      delay = config.baseDelayMs\n      break\n  }\n\n  delay = Math.min(delay, config.maxDelayMs)\n\n  if (config.jitter) {\n    delay = Math.random() * delay\n  }\n\n  return delay\n}\n\n/**\n * Sleeps for the specified duration. Can be aborted via an AbortSignal.\n *\n * @param ms - Duration in milliseconds\n * @param signal - Optional AbortSignal to cancel the sleep early\n */\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(signal.reason as Error)\n      return\n    }\n\n    const timer = setTimeout(resolve, ms)\n\n    signal?.addEventListener(\n      'abort',\n      () => {\n        clearTimeout(timer)\n        reject(signal.reason as Error)\n      },\n      { once: true },\n    )\n  })\n}\n","import {\n  A3ResilienceError,\n  A3TimeoutError,\n  DEFAULT_RESILIENCE_CONFIG,\n  type ResilienceErrorEntry,\n  type ResolvedResilienceConfig,\n} from '@genui-a3/core'\nimport { calculateBackoff, sleep } from './backoff'\n\n/**\n * Builds an AbortSignal that fires when either the per-request timeout or total timeout expires.\n */\nfunction buildSignal(requestTimeoutMs?: number, totalAbort?: AbortSignal): AbortSignal | undefined {\n  const signals: AbortSignal[] = []\n\n  if (requestTimeoutMs !== undefined) {\n    signals.push(AbortSignal.timeout(requestTimeoutMs))\n  }\n\n  if (totalAbort) {\n    signals.push(totalAbort)\n  }\n\n  if (signals.length === 0) return undefined\n  if (signals.length === 1) return signals[0]\n  return AbortSignal.any(signals)\n}\n\ntype AttemptResult<T> = { ok: true; value: T } | { ok: false; error: Error }\n\nasync function attemptAction<T>(\n  action: (model: string, signal?: AbortSignal) => Promise<T>,\n  model: string,\n  signal: AbortSignal | undefined,\n  attempt: number,\n  errors: ResilienceErrorEntry[],\n): Promise<AttemptResult<T>> {\n  try {\n    const value = await action(model, signal)\n    return { ok: true, value }\n  } catch (error) {\n    const errorObj = error as Error\n    errors.push({ model, attempt, error: errorObj })\n    return { ok: false, error: errorObj }\n  }\n}\n\nfunction checkTotalTimeout(totalAbort: AbortController | undefined, timeoutMs: number | undefined, errors: ResilienceErrorEntry[]): void {\n  if (totalAbort?.signal.aborted) {\n    throw new A3TimeoutError(`Total timeout of ${timeoutMs}ms exceeded`, errors)\n  }\n}\n\nasync function handleAttemptError(\n  errorObj: Error,\n  attempt: number,\n  maxRetries: number,\n  retryAll: boolean,\n  resolved: ResolvedResilienceConfig,\n  totalAbort: AbortController | undefined,\n): Promise<'retry' | 'next-model'> {\n  const isLastAttempt = attempt === 1 + maxRetries\n  const isRetryable = retryAll || resolved.isRetryableError(errorObj)\n\n  if (isRetryable && !isLastAttempt) {\n    const delay = calculateBackoff(attempt - 1, resolved.backoff)\n    await sleep(delay, totalAbort?.signal).catch(() => {\n      // Sleep was aborted by total timeout — will be caught at top of loop\n    })\n    return 'retry'\n  }\n\n  return 'next-model'\n}\n\n/**\n * Executes an action with model fallback, retry, backoff, and timeout support.\n *\n * For each model (in priority order):\n * 1. Attempts the action up to `1 + maxAttempts` times\n * 2. On transient errors, waits with backoff before retrying\n * 3. On non-retryable errors (or after exhausting retries), falls back to the next model\n *\n * Throws `A3ResilienceError` with full error history when all models are exhausted.\n * Throws `A3TimeoutError` when the total timeout is exceeded.\n *\n * @param models - Model identifiers in priority order\n * @param action - Async action to attempt with each model. Receives an optional AbortSignal.\n * @param config - Resolved resilience configuration (defaults applied if omitted)\n * @returns The result from the first successful attempt\n * @throws {A3ResilienceError} When all models and retries are exhausted\n * @throws {A3TimeoutError} When the total timeout is exceeded\n *\n * @example\n * ```typescript\n * const result = await executeWithFallback(\n *   ['model-primary', 'model-fallback'],\n *   (model, signal) => provider.call(model, params, { abortSignal: signal }),\n *   resolvedConfig,\n * )\n * ```\n */\nexport async function executeWithFallback<T>(\n  models: string[],\n  action: (model: string, signal?: AbortSignal) => Promise<T>,\n  config?: ResolvedResilienceConfig,\n): Promise<T> {\n  const resolved = config ?? DEFAULT_RESILIENCE_CONFIG\n  const errors: ResilienceErrorEntry[] = []\n  const maxRetries = resolved.retry === false ? 0 : resolved.retry.maxAttempts\n  const retryAll = resolved.retry !== false && resolved.retry.retryOn === 'all'\n\n  // Total timeout controller\n  let totalAbort: AbortController | undefined\n  let totalTimer: ReturnType<typeof setTimeout> | undefined\n\n  if (resolved.timeout.totalTimeoutMs !== undefined) {\n    totalAbort = new AbortController()\n    totalTimer = setTimeout(\n      () => totalAbort!.abort(new Error('Total timeout exceeded')),\n      resolved.timeout.totalTimeoutMs,\n    )\n  }\n\n  try {\n    for (let modelIndex = 0; modelIndex < models.length; modelIndex++) {\n      const model = models[modelIndex]\n\n      for (let attempt = 1; attempt <= 1 + maxRetries; attempt++) {\n        checkTotalTimeout(totalAbort, resolved.timeout.totalTimeoutMs, errors)\n\n        const signal = buildSignal(resolved.timeout.requestTimeoutMs, totalAbort?.signal)\n        // eslint-disable-next-line no-await-in-loop\n        const result = await attemptAction(action, model, signal, attempt, errors)\n        if (result.ok) return result.value\n\n        checkTotalTimeout(totalAbort, resolved.timeout.totalTimeoutMs, errors)\n\n        // eslint-disable-next-line no-await-in-loop\n        const decision = await handleAttemptError(result.error, attempt, maxRetries, retryAll, resolved, totalAbort)\n        if (decision === 'next-model') break\n      }\n    }\n\n    // All models exhausted\n    throw new A3ResilienceError(\n      `All models failed after ${errors.length} total attempt(s): ${models.join(', ')}`,\n      errors,\n    )\n  } finally {\n    if (totalTimer !== undefined) {\n      clearTimeout(totalTimer)\n    }\n  }\n}\n","import { createOpenAI } from '@ai-sdk/openai'\nimport { generateText, streamText, Output, ModelMessage, jsonSchema } from 'ai'\nimport {\n  resolveResilienceConfig,\n  type Provider,\n  type ProviderRequest,\n  type ProviderResponse,\n  type ProviderMessage,\n  type BaseState,\n  type StreamEvent,\n  type ResilienceConfig,\n  type ResolvedResilienceConfig,\n} from '@genui-a3/core'\nimport { processOpenAIStream } from './streamProcessor'\nimport { executeWithFallback } from '@providers/utils/executeWithFallback'\n\n/**\n * Configuration for creating an OpenAI provider.\n */\nexport interface OpenAIProviderConfig {\n  /** OpenAI API key. Defaults to OPENAI_API_KEY env var (OpenAI SDK default). */\n  apiKey?: string\n  /**\n   * Model identifiers in order of preference (first = primary, rest = fallbacks).\n   * e.g. ['gpt-4o', 'gpt-4o-mini']\n   */\n  models: string[]\n  /** Optional base URL for Azure OpenAI or compatible endpoints */\n  baseURL?: string\n  /** Optional OpenAI organization ID */\n  organization?: string\n  /** Resilience configuration (retry, backoff, timeout). Uses industry-standard defaults if omitted. */\n  resilience?: ResilienceConfig\n}\n\ntype JsonSchema = Record<string, unknown>\n\n/**\n * Enforces strict JSON schema constraints required by OpenAI's structured output API.\n * OpenAI requires all object properties — including optional ones — to be in the `required` array.\n * This function recursively adds `required` and `additionalProperties: false` to all objects.\n *\n * @param schema - JSON schema to enforce\n * @returns Enforced JSON schema\n */\nfunction enforceStrictSchema(schema: JsonSchema): JsonSchema {\n  const result = { ...schema }\n  if (result.type === 'object' && result.properties) {\n    result.additionalProperties = false\n    result.required = Object.keys(result.properties as Record<string, unknown>)\n    const props = result.properties as Record<string, JsonSchema>\n    const strictProps: Record<string, JsonSchema> = {}\n    for (const [key, value] of Object.entries(props)) {\n      strictProps[key] = enforceStrictSchema(value)\n    }\n    result.properties = strictProps\n  }\n  if (result.items && typeof result.items === 'object') {\n    result.items = enforceStrictSchema(result.items as JsonSchema)\n  }\n  for (const keyword of ['anyOf', 'oneOf', 'allOf'] as const) {\n    if (Array.isArray(result[keyword])) {\n      result[keyword] = (result[keyword] as JsonSchema[]).map((s) => enforceStrictSchema(s))\n    }\n  }\n  return result\n}\n\n/**\n * Converts a Zod schema to an OpenAI-compatible strict JSON schema wrapped for the Vercel AI SDK.\n *\n * @param zodSchema - Zod schema to convert\n * @returns JSON schema wrapped for Vercel AI SDK\n */\nfunction toOpenAISchema(zodSchema: ProviderRequest['responseSchema']) {\n  const strict = enforceStrictSchema(zodSchema.toJSONSchema() as JsonSchema)\n  return jsonSchema(strict as never, {\n    validate: (value: unknown) => {\n      const result = zodSchema.safeParse(value)\n      return result.success\n        ? { success: true as const, value: result.data }\n        : { success: false as const, error: result.error }\n    },\n  })\n}\n\nfunction toAIMessages(messages: ProviderMessage[]): ModelMessage[] {\n  return messages.map((msg) => ({\n    role: msg.role,\n    content: msg.content,\n  }))\n}\n\nasync function sendWithModel(\n  openaiProvider: ReturnType<typeof createOpenAI>,\n  model: string,\n  system: string,\n  messages: ModelMessage[],\n  schema: ProviderRequest['responseSchema'],\n): Promise<ProviderResponse> {\n  const result = await generateText({\n    model: openaiProvider(model),\n    system,\n    messages,\n    output: Output.object({ schema: toOpenAISchema(schema) }),\n  })\n\n  return {\n    content: JSON.stringify(result.output),\n    usage: {\n      inputTokens: result.usage.inputTokens ?? 0,\n      outputTokens: result.usage.outputTokens ?? 0,\n      totalTokens: (result.usage.inputTokens ?? 0) + (result.usage.outputTokens ?? 0),\n    },\n  }\n}\n\nasync function sendStreamWithModel(\n  openaiProvider: ReturnType<typeof createOpenAI>,\n  model: string,\n  system: string,\n  messages: ModelMessage[],\n  schema: ProviderRequest['responseSchema'],\n) {\n  const result = streamText({\n    model: openaiProvider(model),\n    system,\n    messages,\n    output: Output.object({ schema: toOpenAISchema(schema) }),\n  })\n\n  // Force the API call to start so executeWithFallback can catch connection errors\n  const partialStream = result.partialOutputStream\n  const reader = partialStream[Symbol.asyncIterator]()\n  const first = await reader.next()\n\n  return { result, reader, first }\n}\n\n/**\n * Creates an OpenAI provider instance.\n *\n * Uses the Vercel AI SDK (`ai` + `@ai-sdk/openai`) for structured output via\n * `generateText` + `Output.object()` (blocking) and `streamText` + `Output.object()`\n * (streaming). The AI SDK handles Zod-to-JSON-schema conversion, partial JSON\n * parsing, and validation internally.\n *\n * @param config - OpenAI provider configuration\n * @returns A Provider implementation using OpenAI\n *\n * @example\n * ```typescript\n * const provider = createOpenAIProvider({\n *   models: ['gpt-4o', 'gpt-4o-mini'],\n * })\n * ```\n */\nexport function createOpenAIProvider(config: OpenAIProviderConfig): Provider {\n  const openaiProvider = createOpenAI({\n    apiKey: config.apiKey,\n    baseURL: config.baseURL,\n    organization: config.organization,\n  })\n  const models = config.models\n  const resilience: ResolvedResilienceConfig = resolveResilienceConfig(config.resilience)\n\n  return {\n    name: 'openai',\n\n    async sendRequest(request: ProviderRequest): Promise<ProviderResponse> {\n      const messages = toAIMessages(request.messages)\n\n      return executeWithFallback(\n        models,\n        (model) => sendWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema),\n        resilience,\n      )\n    },\n\n    async *sendRequestStream<TState extends BaseState = BaseState>(\n      request: ProviderRequest,\n    ): AsyncGenerator<StreamEvent<TState>> {\n      const messages = toAIMessages(request.messages)\n\n      const { result, reader, first } = await executeWithFallback(\n        models,\n        (model) => sendStreamWithModel(openaiProvider, model, request.systemPrompt, messages, request.responseSchema),\n        resilience,\n      )\n\n      yield* processOpenAIStream<TState>(result, reader, first, 'openai', request.responseSchema)\n    },\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genui-a3/providers",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "Provider implementations for the A3 agentic framework",
   "type": "module",
   "exports": {