@genui-a3/providers 0.0.0 → 0.0.2

package/README.md

@@ -0,0 +1,186 @@
+# @genui-a3/providers
+
+[![npm version](https://img.shields.io/npm/v/@genui-a3/providers)](https://www.npmjs.com/package/@genui-a3/providers)
+[![license](https://img.shields.io/npm/l/@genui-a3/providers)](https://github.com/generalui/a3/blob/main/LICENSE)
+
+**LLM provider implementations for the [A3 agentic framework](https://www.npmjs.com/package/@genui-a3/core).**
+
+Ships with **AWS Bedrock**, **Anthropic** and **OpenAI** providers out of the box.
+Both support blocking and streaming modes, model fallback, and structured output via Zod schemas.
+
+## Install
+
+```bash
+npm install @genui-a3/providers @genui-a3/core
+```
+
+`@genui-a3/core` is a **peer dependency** — it must be installed alongside this package.
+
+## Quick Start
+
+### AWS Bedrock
+
+```typescript
+import { createBedrockProvider } from '@genui-a3/providers/bedrock'
+
+const provider = createBedrockProvider({
+  models: ['us.anthropic.claude-sonnet-4-5-20250929-v1:0'],
+  region: 'us-east-1', // optional, defaults to AWS SDK default
+})
+```
+
+### OpenAI
+
+```typescript
+import { createOpenAIProvider } from '@genui-a3/providers/openai'
+
+const provider = createOpenAIProvider({
+  models: ['gpt-4o', 'gpt-4o-mini'],
+  apiKey: process.env.OPENAI_API_KEY, // optional, defaults to OPENAI_API_KEY env var
+})
+```
+
+### Use with A3
+
+```typescript
+import { ChatSession, MemorySessionStore } from '@genui-a3/core'
+
+const session = new ChatSession({
+  sessionId: 'user-123',
+  store: new MemorySessionStore(),
+  initialAgentId: 'greeting',
+  initialState: {},
+  provider, // any provider from above
+})
+
+// Blocking
+const response = await session.send({ message: 'Hello!' })
+
+// Streaming
+for await (const event of session.send({ message: 'Hello!', stream: true })) {
+  console.log(event)
+}
+```
+
+## Providers
+
+### Bedrock — `createBedrockProvider(config)`
+
+Communicates with AWS Bedrock via the [Converse API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html).
+
+| Option | Type | Required | Description |
+|---|---|---|---|
+| `models` | `string[]` | Yes | Model IDs in preference order (first = primary, rest = fallbacks) |
+| `region` | `string` | No | AWS region. Defaults to AWS SDK default |
+
+**Behaviour:**
+
+- Uses **tool-based JSON extraction** (`structuredResponse` tool) for reliable structured output
+- **Streaming** yields text deltas in real-time, then emits a validated tool-call result at the end
+- **Merges sequential same-role messages** to satisfy Bedrock's alternating-role requirement
+- **Prepends an initial user message** (`"Hi"`) so the conversation always starts with a user turn
+
+**Prerequisites:** AWS credentials configured via environment variables, IAM role, or AWS profile — the same setup the AWS SDK expects.
+
+---
+
+### OpenAI — `createOpenAIProvider(config)`
+
+Communicates with the OpenAI Chat Completions API using [structured output](https://platform.openai.com/docs/guides/structured-outputs) (`response_format: json_schema`).
+
+| Option | Type | Required | Description |
+|---|---|---|---|
+| `models` | `string[]` | Yes | Model IDs in preference order (first = primary, rest = fallbacks) |
+| `apiKey` | `string` | No | API key. Defaults to `OPENAI_API_KEY` env var |
+| `baseURL` | `string` | No | Custom base URL for Azure OpenAI or compatible endpoints |
+| `organization` | `string` | No | OpenAI organization ID |
+
+**Behaviour:**
+
+- Uses **structured output** (`response_format` with `json_schema`) — no tool calls required
+- **Enforces strict schemas** automatically (`additionalProperties: false`, all properties `required`)
+- **Streaming** extracts `chatbotMessage` text progressively from the JSON response via a character-level state machine, yielding text deltas in real-time
+- Detects **truncated responses** (`finish_reason: length`) and surfaces them as errors
+
+**Prerequisites:** An OpenAI API key, either passed directly or set as `OPENAI_API_KEY`.
+
+## Model Fallback
+
+Both providers support automatic model fallback. List models in order of preference:
+
+```typescript
+const provider = createBedrockProvider({
+  models: [
+    'us.anthropic.claude-sonnet-4-5-20250929-v1:0',  // primary
+    'us.anthropic.claude-haiku-4-5-20251001-v1:0',   // fallback
+  ],
+})
+```
+
+If the primary model fails, the provider automatically retries with the next model in the list. If all models fail, the last error is thrown.
+
+## Per-Agent Provider Override
+
+Each agent can override the session-level provider:
+
+```typescript
+import { createOpenAIProvider } from '@genui-a3/providers/openai'
+import { createBedrockProvider } from '@genui-a3/providers/bedrock'
+
+// Session uses Bedrock by default
+const session = new ChatSession({
+  provider: createBedrockProvider({ models: ['us.anthropic.claude-sonnet-4-5-20250929-v1:0'] }),
+  // ...
+})
+
+// This agent uses OpenAI instead
+const premiumAgent = {
+  id: 'premium',
+  provider: createOpenAIProvider({ models: ['gpt-4o'] }),
+  // ...
+}
+```
+
+## Provider Interface
+
+Both providers implement the `Provider` interface from `@genui-a3/core`:
+
+| Member | Description |
+|---|---|
+| `sendRequest(request)` | Blocking request → `Promise<ProviderResponse>` |
+| `sendRequestStream(request)` | Streaming request → `AsyncGenerator<StreamEvent>` |
+| `name` | Human-readable name (`'bedrock'` or `'openai'`) |
+
+To create a custom provider, implement this interface and pass it to `ChatSession` or an individual agent.
+
+## Exports
+
+This package uses [subpath exports](https://nodejs.org/api/packages.html#subpath-exports). Import from the specific provider entry point:
+
+```typescript
+// ✅ Correct
+import { createBedrockProvider } from '@genui-a3/providers/bedrock'
+import { createOpenAIProvider } from '@genui-a3/providers/openai'
+
+// ❌ No bare import
+import { ... } from '@genui-a3/providers'
+```
+
+| Entry point | Export | Description |
+|---|---|---|
+| `@genui-a3/providers/bedrock` | `createBedrockProvider` | Factory function returning a Bedrock `Provider` |
+| `@genui-a3/providers/bedrock` | `BedrockProviderConfig` | TypeScript config interface |
+| `@genui-a3/providers/openai` | `createOpenAIProvider` | Factory function returning an OpenAI `Provider` |
+| `@genui-a3/providers/openai` | `OpenAIProviderConfig` | TypeScript config interface |
+
+## Requirements
+
+- Node.js 20.19.0+
+- TypeScript 5.9+
+- `@genui-a3/core` ≥ 0.1.5 (peer dependency)
+- **Bedrock**: AWS credentials configured in the environment
+- **OpenAI**: `OPENAI_API_KEY` environment variable or `apiKey` config option
+
+## License
+
+ISC

package/dist/anthropic/index.cjs

@@ -0,0 +1,162 @@
+'use strict';
+
+var anthropic = require('@ai-sdk/anthropic');
+var ai = require('ai');
+var client = require('@ag-ui/client');
+
+// anthropic/index.ts
+async function* processAnthropicStream(streamResult, reader, first, agentId, schema) {
+  let prevMessageLength = 0;
+  try {
+    if (!first.done) {
+      const partial = first.value;
+      const delta = extractDelta(partial, prevMessageLength);
+      if (delta) {
+        prevMessageLength += delta.length;
+        yield {
+          type: client.EventType.TEXT_MESSAGE_CONTENT,
+          messageId: "",
+          delta,
+          agentId
+        };
+      }
+    }
+    let next = await reader.next();
+    while (!next.done) {
+      const partial = next.value;
+      const delta = extractDelta(partial, prevMessageLength);
+      if (delta) {
+        prevMessageLength += delta.length;
+        yield {
+          type: client.EventType.TEXT_MESSAGE_CONTENT,
+          messageId: "",
+          delta,
+          agentId
+        };
+      }
+      next = await reader.next();
+    }
+    const finalObject = await streamResult.output;
+    if (finalObject === null) {
+      yield {
+        type: client.EventType.RUN_ERROR,
+        message: "Anthropic stream completed with null output",
+        agentId
+      };
+      return;
+    }
+    const validated = schema.parse(finalObject);
+    yield {
+      type: client.EventType.TOOL_CALL_RESULT,
+      toolCallId: "",
+      messageId: "",
+      content: JSON.stringify(validated),
+      agentId
+    };
+  } catch (err) {
+    yield {
+      type: client.EventType.RUN_ERROR,
+      message: `Anthropic stream error: ${err.message}`,
+      agentId
+    };
+  }
+}
+function extractDelta(partial, prevLength) {
+  const chatbotMessage = partial.chatbotMessage;
+  if (typeof chatbotMessage !== "string" || chatbotMessage.length <= prevLength) {
+    return null;
+  }
+  return chatbotMessage.slice(prevLength);
+}
+
+// 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;
+      }
+    }
+  }
+  throw new Error("All models failed");
+}
+
+// anthropic/index.ts
+function toAIMessages(messages) {
+  return messages.map((msg) => ({
+    role: msg.role,
+    content: msg.content
+  }));
+}
+function prepareMessages(messages) {
+  if (messages.length === 0) return messages;
+  const lastMessage = messages[messages.length - 1];
+  if (lastMessage.role === "assistant") {
+    return [...messages, { role: "user", content: "Continue" }];
+  }
+  return messages;
+}
+async function sendWithModel(anthropicProvider, model, system, messages, schema) {
+  const preparedMessages = prepareMessages(messages);
+  const result = await ai.generateText({
+    model: anthropicProvider(model),
+    system,
+    messages: preparedMessages,
+    output: ai.Output.object({ schema })
+  });
+  return {
+    content: JSON.stringify(result.output),
+    usage: {
+      inputTokens: result.usage.inputTokens ?? 0,
+      outputTokens: result.usage.outputTokens ?? 0,
+      totalTokens: (result.usage.inputTokens ?? 0) + (result.usage.outputTokens ?? 0)
+    }
+  };
+}
+async function sendStreamWithModel(anthropicProvider, model, system, messages, schema) {
+  const preparedMessages = prepareMessages(messages);
+  const result = ai.streamText({
+    model: anthropicProvider(model),
+    system,
+    messages: preparedMessages,
+    output: ai.Output.object({ schema })
+  });
+  const partialStream = result.partialOutputStream;
+  const reader = partialStream[Symbol.asyncIterator]();
+  const first = await reader.next();
+  return { result, reader, first };
+}
+function createAnthropicProvider(config) {
+  const anthropicProvider = anthropic.createAnthropic({
+    apiKey: config.apiKey,
+    baseURL: config.baseURL
+  });
+  const models = config.models;
+  return {
+    name: "anthropic",
+    async sendRequest(request) {
+      const messages = toAIMessages(request.messages);
+      return executeWithFallback(
+        models,
+        (model) => sendWithModel(anthropicProvider, model, request.systemPrompt, messages, request.responseSchema)
+      );
+    },
+    async *sendRequestStream(request) {
+      const messages = toAIMessages(request.messages);
+      const { result, reader, first } = await executeWithFallback(
+        models,
+        (model) => sendStreamWithModel(anthropicProvider, model, request.systemPrompt, messages, request.responseSchema)
+      );
+      yield* processAnthropicStream(result, reader, first, "anthropic", request.responseSchema);
+    }
+  };
+}
+
+exports.createAnthropicProvider = createAnthropicProvider;
+exports.prepareMessages = prepareMessages;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/anthropic/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../anthropic/streamProcessor.ts","../../utils/executeWithFallback.ts","../../anthropic/index.ts"],"names":["EventType","generateText","Output","streamText","createAnthropic"],"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 Anthropic 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* processAnthropicStream<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: 'Anthropic 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: `Anthropic 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 { createAnthropic } from '@ai-sdk/anthropic'\nimport { generateText, streamText, Output, ModelMessage } from 'ai'\nimport type {\n  Provider,\n  ProviderRequest,\n  ProviderResponse,\n  ProviderMessage,\n  BaseState,\n  StreamEvent,\n} from '@genui-a3/core'\nimport { processAnthropicStream } from './streamProcessor'\nimport { executeWithFallback } from '../utils/executeWithFallback'\n\n/**\n * Configuration for creating an Anthropic provider.\n */\nexport interface AnthropicProviderConfig {\n  /** Anthropic API key. Defaults to ANTHROPIC_API_KEY env var. */\n  apiKey?: string\n  /**\n   * Model identifiers in order of preference (first = primary, rest = fallbacks).\n   * e.g. ['claude-sonnet-4-5-20250929', 'claude-haiku-4-5-20251001']\n   */\n  models: string[]\n  /** Optional custom base URL for the Anthropic API */\n  baseURL?: string\n}\n\nfunction toAIMessages(messages: ProviderMessage[]): ModelMessage[] {\n  return messages.map((msg) => ({\n    role: msg.role,\n    content: msg.content,\n  }))\n}\n\nexport function prepareMessages(messages: ModelMessage[]): ModelMessage[] {\n  if (messages.length === 0) return messages\n  const lastMessage = messages[messages.length - 1]\n  if (lastMessage.role === 'assistant') {\n    return [...messages, { role: 'user', content: 'Continue' }]\n  }\n  return messages\n}\n\nasync function sendWithModel(\n  anthropicProvider: ReturnType<typeof createAnthropic>,\n  model: string,\n  system: string,\n  messages: ModelMessage[],\n  schema: ProviderRequest['responseSchema'],\n): Promise<ProviderResponse> {\n  const preparedMessages = prepareMessages(messages)\n  const result = await generateText({\n    model: anthropicProvider(model),\n    system,\n    messages: preparedMessages,\n    output: Output.object({ 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  anthropicProvider: ReturnType<typeof createAnthropic>,\n  model: string,\n  system: string,\n  messages: ModelMessage[],\n  schema: ProviderRequest['responseSchema'],\n) {\n  const preparedMessages = prepareMessages(messages)\n  const result = streamText({\n    model: anthropicProvider(model),\n    system,\n    messages: preparedMessages,\n    output: Output.object({ 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 Anthropic provider instance.\n *\n * Uses the Vercel AI SDK (`ai` + `@ai-sdk/anthropic`) 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 - Anthropic provider configuration\n * @returns A Provider implementation using Anthropic\n *\n * @example\n * ```typescript\n * const provider = createAnthropicProvider({\n *   models: ['claude-sonnet-4-5-20250929', 'claude-haiku-4-5-20251001'],\n * })\n * ```\n */\nexport function createAnthropicProvider(config: AnthropicProviderConfig): Provider {\n  const anthropicProvider = createAnthropic({\n    apiKey: config.apiKey,\n    baseURL: config.baseURL,\n  })\n  const models = config.models\n\n  return {\n    name: 'anthropic',\n\n    async sendRequest(request: ProviderRequest): Promise<ProviderResponse> {\n      const messages = toAIMessages(request.messages)\n\n      return executeWithFallback(models, (model) =>\n        sendWithModel(anthropicProvider, 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(anthropicProvider, model, request.systemPrompt, messages, request.responseSchema),\n      )\n\n      yield* processAnthropicStream<TState>(result, reader, first, 'anthropic', request.responseSchema)\n    },\n  }\n}\n"]}

package/dist/anthropic/index.d.cts

@@ -0,0 +1,39 @@
+import { ModelMessage } from 'ai';
+import { Provider } from '@genui-a3/core';
+
+/**
+ * Configuration for creating an Anthropic provider.
+ */
+interface AnthropicProviderConfig {
+    /** Anthropic API key. Defaults to ANTHROPIC_API_KEY env var. */
+    apiKey?: string;
+    /**
+     * Model identifiers in order of preference (first = primary, rest = fallbacks).
+     * e.g. ['claude-sonnet-4-5-20250929', 'claude-haiku-4-5-20251001']
+     */
+    models: string[];
+    /** Optional custom base URL for the Anthropic API */
+    baseURL?: string;
+}
+declare function prepareMessages(messages: ModelMessage[]): ModelMessage[];
+/**
+ * Creates an Anthropic provider instance.
+ *
+ * Uses the Vercel AI SDK (`ai` + `@ai-sdk/anthropic`) for structured output via
+ * `generateText` + `Output.object()` (blocking) and `streamText` + `Output.object()`
+ * (streaming). The AI SDK handles Zod-to-JSON-schema conversion, partial JSON
+ * parsing, and validation internally.
+ *
+ * @param config - Anthropic provider configuration
+ * @returns A Provider implementation using Anthropic
+ *
+ * @example
+ * ```typescript
+ * const provider = createAnthropicProvider({
+ *   models: ['claude-sonnet-4-5-20250929', 'claude-haiku-4-5-20251001'],
+ * })
+ * ```
+ */
+declare function createAnthropicProvider(config: AnthropicProviderConfig): Provider;
+
+export { type AnthropicProviderConfig, createAnthropicProvider, prepareMessages };

package/dist/anthropic/index.d.ts

@@ -0,0 +1,39 @@
+import { ModelMessage } from 'ai';
+import { Provider } from '@genui-a3/core';
+
+/**
+ * Configuration for creating an Anthropic provider.
+ */
+interface AnthropicProviderConfig {
+    /** Anthropic API key. Defaults to ANTHROPIC_API_KEY env var. */
+    apiKey?: string;
+    /**
+     * Model identifiers in order of preference (first = primary, rest = fallbacks).
+     * e.g. ['claude-sonnet-4-5-20250929', 'claude-haiku-4-5-20251001']
+     */
+    models: string[];
+    /** Optional custom base URL for the Anthropic API */
+    baseURL?: string;
+}
+declare function prepareMessages(messages: ModelMessage[]): ModelMessage[];
+/**
+ * Creates an Anthropic provider instance.
+ *
+ * Uses the Vercel AI SDK (`ai` + `@ai-sdk/anthropic`) for structured output via
+ * `generateText` + `Output.object()` (blocking) and `streamText` + `Output.object()`
+ * (streaming). The AI SDK handles Zod-to-JSON-schema conversion, partial JSON
+ * parsing, and validation internally.
+ *
+ * @param config - Anthropic provider configuration
+ * @returns A Provider implementation using Anthropic
+ *
+ * @example
+ * ```typescript
+ * const provider = createAnthropicProvider({
+ *   models: ['claude-sonnet-4-5-20250929', 'claude-haiku-4-5-20251001'],
+ * })
+ * ```
+ */
+declare function createAnthropicProvider(config: AnthropicProviderConfig): Provider;
+
+export { type AnthropicProviderConfig, createAnthropicProvider, prepareMessages };

package/dist/anthropic/index.js

@@ -0,0 +1,159 @@
+import { createAnthropic } from '@ai-sdk/anthropic';
+import { streamText, Output, generateText } from 'ai';
+import { EventType } from '@ag-ui/client';
+
+// anthropic/index.ts
+async function* processAnthropicStream(streamResult, reader, first, agentId, schema) {
+  let prevMessageLength = 0;
+  try {
+    if (!first.done) {
+      const partial = first.value;
+      const delta = extractDelta(partial, prevMessageLength);
+      if (delta) {
+        prevMessageLength += delta.length;
+        yield {
+          type: EventType.TEXT_MESSAGE_CONTENT,
+          messageId: "",
+          delta,
+          agentId
+        };
+      }
+    }
+    let next = await reader.next();
+    while (!next.done) {
+      const partial = next.value;
+      const delta = extractDelta(partial, prevMessageLength);
+      if (delta) {
+        prevMessageLength += delta.length;
+        yield {
+          type: EventType.TEXT_MESSAGE_CONTENT,
+          messageId: "",
+          delta,
+          agentId
+        };
+      }
+      next = await reader.next();
+    }
+    const finalObject = await streamResult.output;
+    if (finalObject === null) {
+      yield {
+        type: EventType.RUN_ERROR,
+        message: "Anthropic stream completed with null output",
+        agentId
+      };
+      return;
+    }
+    const validated = schema.parse(finalObject);
+    yield {
+      type: EventType.TOOL_CALL_RESULT,
+      toolCallId: "",
+      messageId: "",
+      content: JSON.stringify(validated),
+      agentId
+    };
+  } catch (err) {
+    yield {
+      type: EventType.RUN_ERROR,
+      message: `Anthropic stream error: ${err.message}`,
+      agentId
+    };
+  }
+}
+function extractDelta(partial, prevLength) {
+  const chatbotMessage = partial.chatbotMessage;
+  if (typeof chatbotMessage !== "string" || chatbotMessage.length <= prevLength) {
+    return null;
+  }
+  return chatbotMessage.slice(prevLength);
+}
+
+// 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;
+      }
+    }
+  }
+  throw new Error("All models failed");
+}
+
+// anthropic/index.ts
+function toAIMessages(messages) {
+  return messages.map((msg) => ({
+    role: msg.role,
+    content: msg.content
+  }));
+}
+function prepareMessages(messages) {
+  if (messages.length === 0) return messages;
+  const lastMessage = messages[messages.length - 1];
+  if (lastMessage.role === "assistant") {
+    return [...messages, { role: "user", content: "Continue" }];
+  }
+  return messages;
+}
+async function sendWithModel(anthropicProvider, model, system, messages, schema) {
+  const preparedMessages = prepareMessages(messages);
+  const result = await generateText({
+    model: anthropicProvider(model),
+    system,
+    messages: preparedMessages,
+    output: Output.object({ schema })
+  });
+  return {
+    content: JSON.stringify(result.output),
+    usage: {
+      inputTokens: result.usage.inputTokens ?? 0,
+      outputTokens: result.usage.outputTokens ?? 0,
+      totalTokens: (result.usage.inputTokens ?? 0) + (result.usage.outputTokens ?? 0)
+    }
+  };
+}
+async function sendStreamWithModel(anthropicProvider, model, system, messages, schema) {
+  const preparedMessages = prepareMessages(messages);
+  const result = streamText({
+    model: anthropicProvider(model),
+    system,
+    messages: preparedMessages,
+    output: Output.object({ schema })
+  });
+  const partialStream = result.partialOutputStream;
+  const reader = partialStream[Symbol.asyncIterator]();
+  const first = await reader.next();
+  return { result, reader, first };
+}
+function createAnthropicProvider(config) {
+  const anthropicProvider = createAnthropic({
+    apiKey: config.apiKey,
+    baseURL: config.baseURL
+  });
+  const models = config.models;
+  return {
+    name: "anthropic",
+    async sendRequest(request) {
+      const messages = toAIMessages(request.messages);
+      return executeWithFallback(
+        models,
+        (model) => sendWithModel(anthropicProvider, model, request.systemPrompt, messages, request.responseSchema)
+      );
+    },
+    async *sendRequestStream(request) {
+      const messages = toAIMessages(request.messages);
+      const { result, reader, first } = await executeWithFallback(
+        models,
+        (model) => sendStreamWithModel(anthropicProvider, model, request.systemPrompt, messages, request.responseSchema)
+      );
+      yield* processAnthropicStream(result, reader, first, "anthropic", request.responseSchema);
+    }
+  };
+}
+
+export { createAnthropicProvider, prepareMessages };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/anthropic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../anthropic/streamProcessor.ts","../../utils/executeWithFallback.ts","../../anthropic/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 Anthropic 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* processAnthropicStream<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: 'Anthropic 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: `Anthropic 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 { createAnthropic } from '@ai-sdk/anthropic'\nimport { generateText, streamText, Output, ModelMessage } from 'ai'\nimport type {\n  Provider,\n  ProviderRequest,\n  ProviderResponse,\n  ProviderMessage,\n  BaseState,\n  StreamEvent,\n} from '@genui-a3/core'\nimport { processAnthropicStream } from './streamProcessor'\nimport { executeWithFallback } from '../utils/executeWithFallback'\n\n/**\n * Configuration for creating an Anthropic provider.\n */\nexport interface AnthropicProviderConfig {\n  /** Anthropic API key. Defaults to ANTHROPIC_API_KEY env var. */\n  apiKey?: string\n  /**\n   * Model identifiers in order of preference (first = primary, rest = fallbacks).\n   * e.g. ['claude-sonnet-4-5-20250929', 'claude-haiku-4-5-20251001']\n   */\n  models: string[]\n  /** Optional custom base URL for the Anthropic API */\n  baseURL?: string\n}\n\nfunction toAIMessages(messages: ProviderMessage[]): ModelMessage[] {\n  return messages.map((msg) => ({\n    role: msg.role,\n    content: msg.content,\n  }))\n}\n\nexport function prepareMessages(messages: ModelMessage[]): ModelMessage[] {\n  if (messages.length === 0) return messages\n  const lastMessage = messages[messages.length - 1]\n  if (lastMessage.role === 'assistant') {\n    return [...messages, { role: 'user', content: 'Continue' }]\n  }\n  return messages\n}\n\nasync function sendWithModel(\n  anthropicProvider: ReturnType<typeof createAnthropic>,\n  model: string,\n  system: string,\n  messages: ModelMessage[],\n  schema: ProviderRequest['responseSchema'],\n): Promise<ProviderResponse> {\n  const preparedMessages = prepareMessages(messages)\n  const result = await generateText({\n    model: anthropicProvider(model),\n    system,\n    messages: preparedMessages,\n    output: Output.object({ 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  anthropicProvider: ReturnType<typeof createAnthropic>,\n  model: string,\n  system: string,\n  messages: ModelMessage[],\n  schema: ProviderRequest['responseSchema'],\n) {\n  const preparedMessages = prepareMessages(messages)\n  const result = streamText({\n    model: anthropicProvider(model),\n    system,\n    messages: preparedMessages,\n    output: Output.object({ 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 Anthropic provider instance.\n *\n * Uses the Vercel AI SDK (`ai` + `@ai-sdk/anthropic`) 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 - Anthropic provider configuration\n * @returns A Provider implementation using Anthropic\n *\n * @example\n * ```typescript\n * const provider = createAnthropicProvider({\n *   models: ['claude-sonnet-4-5-20250929', 'claude-haiku-4-5-20251001'],\n * })\n * ```\n */\nexport function createAnthropicProvider(config: AnthropicProviderConfig): Provider {\n  const anthropicProvider = createAnthropic({\n    apiKey: config.apiKey,\n    baseURL: config.baseURL,\n  })\n  const models = config.models\n\n  return {\n    name: 'anthropic',\n\n    async sendRequest(request: ProviderRequest): Promise<ProviderResponse> {\n      const messages = toAIMessages(request.messages)\n\n      return executeWithFallback(models, (model) =>\n        sendWithModel(anthropicProvider, 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(anthropicProvider, model, request.systemPrompt, messages, request.responseSchema),\n      )\n\n      yield* processAnthropicStream<TState>(result, reader, first, 'anthropic', request.responseSchema)\n    },\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genui-a3/providers",
-  "version": "0.0.0",
+  "version": "0.0.2",
   "description": "Provider implementations for the A3 agentic framework",
   "type": "module",
   "exports": {
@@ -13,6 +13,11 @@
       "types": "./dist/openai/index.d.ts",
       "import": "./dist/openai/index.js",
       "require": "./dist/openai/index.cjs"
+    },
+    "./anthropic": {
+      "types": "./dist/anthropic/index.d.ts",
+      "import": "./dist/anthropic/index.js",
+      "require": "./dist/anthropic/index.cjs"
     }
   },
   "files": [
@@ -29,6 +34,7 @@
     "providers",
     "bedrock",
     "openai",
+    "anthropic",
     "ai",
     "llm"
   ],
@@ -42,7 +48,9 @@
   },
   "dependencies": {
     "@ag-ui/client": "0.0.47",
+    "@ai-sdk/anthropic": "^3.0.58",
     "@aws-sdk/client-bedrock-runtime": "3.975.0",
+    "ai": "^6.0.116",
     "openai": "6.27.0",
     "zod": "4.3.6"
   },