beddel 1.0.0 → 1.0.2

package/README.md

@@ -14,6 +14,7 @@
 - 🔌 **Extensible Primitives** — Register custom step types, tools, and callbacks
 - 🔒 **Security First** — YAML parsing with `FAILSAFE_SCHEMA` prevents code execution
 - 📦 **Bundle Separation** — Three entry points for server, client, and full API access
+- 🌐 **Multi-Provider** — Built-in support for Google Gemini and Amazon Bedrock
 
 ## Installation
 
@@ -40,6 +41,8 @@ export const POST = createBeddelHandler({
 
 ### 2. Create YAML Agent
 
+#### Example 1: Google Gemini (Default Provider)
+
 ```yaml
 # src/agents/assistant.yaml
 metadata:
@@ -50,16 +53,47 @@ workflow:
   - id: "chat-interaction"
     type: "llm"
     config:
+      provider: "google"
       model: "gemini-2.0-flash-exp"
       stream: true
       system: "You are a helpful assistant."
       messages: "$input.messages"
 ```
 
-### 3. Set Environment Variable
+#### Example 2: Amazon Bedrock (Llama 3.2)
+
+```yaml
+# src/agents/assistant-bedrock.yaml
+metadata:
+  name: "Bedrock Assistant"
+  version: "1.0.0"
+  description: "Simple assistant using Llama 3.2 1B (lightweight)"
+
+workflow:
+  - id: "chat"
+    type: "llm"
+    config:
+      provider: "bedrock"
+      model: "us.meta.llama3-2-1b-instruct-v1:0"
+      stream: true
+      system: |
+        You are a helpful, friendly assistant. Be concise and direct.
+        Answer in the same language the user writes to you.
+      messages: "$input.messages"
+```
+
+### 3. Set Environment Variables
 
 ```bash
+# For Google Gemini
 GEMINI_API_KEY=your_api_key_here
+
+# For Amazon Bedrock
+AWS_REGION=us-east-1
+AWS_BEARER_TOKEN_BEDROCK=your_bedrock_api_key
+# Or use standard AWS credentials:
+# AWS_ACCESS_KEY_ID=your_access_key
+# AWS_SECRET_ACCESS_KEY=your_secret_key
 ```
 
 ### 4. Use with React (useChat)
@@ -71,7 +105,7 @@ import { useChat } from '@ai-sdk/react';
 export default function Chat() {
   const { messages, input, handleInputChange, handleSubmit } = useChat({
     api: '/api/beddel/chat',
-    body: { agentId: 'assistant' },
+    body: { agentId: 'assistant' },  // or 'assistant-bedrock'
   });
 
   return (
@@ -88,6 +122,15 @@ export default function Chat() {
 }
 ```
 
+## Built-in Providers
+
+| Provider | Environment Variables | Default Model |
+|----------|----------------------|---------------|
+| `google` | `GEMINI_API_KEY` | `gemini-1.5-flash` |
+| `bedrock` | `AWS_REGION`, `AWS_BEARER_TOKEN_BEDROCK` (or AWS credentials) | `anthropic.claude-3-haiku-20240307-v1:0` |
+
+> **Note:** The Bedrock provider requires `AWS_REGION` to be set (defaults to `us-east-1` if not provided).
+
 ## Entry Points
 
 | Import Path | Purpose | Environment |
@@ -188,6 +231,7 @@ Beddel is fully compatible with Vercel AI SDK v6:
 | Runtime | Node.js / Edge | 20+ |
 | AI Core | `ai` | 6.x |
 | AI Provider | `@ai-sdk/google` | 3.x |
+| AI Provider | `@ai-sdk/amazon-bedrock` | 4.x |
 | Validation | `zod` | 3.x |
 | YAML Parser | `js-yaml` | 4.x |
 

package/dist/index.d.ts

@@ -14,5 +14,7 @@ export { createBeddelHandler } from './server/handler';
 export { handlerRegistry, registerPrimitive } from './primitives';
 export { toolRegistry, registerTool } from './tools';
 export type { ToolImplementation } from './tools';
+export { providerRegistry, registerProvider, createModel } from './providers';
+export type { ProviderImplementation, ProviderConfig } from './providers';
 export type { ParsedYaml, WorkflowStep, StepConfig, YamlMetadata, ExecutionContext, PrimitiveHandler, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAIvD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,YAAY,EACR,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAIvD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9E,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG1E,YAAY,EACR,UAAU,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -16,3 +16,5 @@ export { createBeddelHandler } from './server/handler';
 export { handlerRegistry, registerPrimitive } from './primitives';
 // Tools registry (for custom tool registration)
 export { toolRegistry, registerTool } from './tools';
+// Providers registry (for custom LLM provider registration)
+export { providerRegistry, registerProvider, createModel } from './providers';

package/dist/primitives/llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/primitives/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAaH,OAAO,KAAK,EAAgC,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAI/E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAM,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI,CAKzE;AA0DD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,EAAE,gBA4E1B,CAAC"}
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/primitives/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,OAAO,KAAK,EAAgC,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAK/E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAM,CAAC;AAE/D;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI,CAKzE;AA2DD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,EAAE,gBA2E1B,CAAC"}

package/dist/primitives/llm.js

@@ -16,9 +16,9 @@
  * - convertToModelMessages() bridges this gap automatically
  */
 import { streamText, generateText, dynamicTool, stepCountIs, convertToModelMessages, } from 'ai';
-import { createGoogleGenerativeAI } from '@ai-sdk/google';
 import { toolRegistry } from '../tools';
 import { resolveVariables } from '../core/variable-resolver';
+import { createModel } from '../providers';
 /**
  * Registry for consumer-registered callbacks.
  * Populated by the application using Beddel.
@@ -87,11 +87,10 @@ function mapTools(toolDefinitions) {
  */
 export const llmPrimitive = async (config, context) => {
     const llmConfig = config;
-    // Initialize Google Generative AI provider
-    const google = createGoogleGenerativeAI({
-        apiKey: process.env.GEMINI_API_KEY,
+    // Create model from provider registry (defaults to 'google')
+    const model = createModel(llmConfig.provider || 'google', {
+        model: llmConfig.model || 'gemini-1.5-flash',
     });
-    const model = google(llmConfig.model || 'gemini-1.5-flash');
     // Resolve messages from context (e.g., $input.messages)
     // AI SDK v6: Frontend sends UIMessage[], we convert to ModelMessage[]
     const rawMessages = resolveVariables(llmConfig.messages, context);

package/dist/providers/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Beddel Protocol - Provider Registry
+ *
+ * This registry maps provider names to their implementations.
+ * Following Expansion Pack Pattern from BMAD-METHOD™ for extensibility.
+ * See: https://github.com/bmadcode/bmad-method
+ *
+ * Server-only: Providers may use Node.js APIs and external services.
+ */
+import type { LanguageModel } from 'ai';
+/**
+ * Configuration passed to provider's createModel method.
+ */
+export interface ProviderConfig {
+    model: string;
+    [key: string]: unknown;
+}
+/**
+ * Provider implementation interface.
+ * Each provider must implement createModel to return an AI SDK LanguageModel.
+ */
+export interface ProviderImplementation {
+    createModel: (config: ProviderConfig) => LanguageModel;
+}
+/**
+ * Registry of provider implementations keyed by provider name.
+ *
+ * Built-in Providers:
+ * - 'google': Google Gemini via @ai-sdk/google
+ * - 'bedrock': Amazon Bedrock via @ai-sdk/amazon-bedrock
+ */
+export declare const providerRegistry: Record<string, ProviderImplementation>;
+/**
+ * Register a custom provider implementation in the registry.
+ * Allows consumers to extend Beddel with additional LLM providers.
+ *
+ * @param name - Provider identifier (e.g., 'openai', 'anthropic')
+ * @param implementation - ProviderImplementation with createModel method
+ *
+ * @example
+ * import { registerProvider } from 'beddel';
+ *
+ * registerProvider('openai', {
+ *   createModel: (config) => {
+ *     const openai = createOpenAI({ apiKey: process.env.OPENAI_API_KEY });
+ *     return openai(config.model || 'gpt-4');
+ *   },
+ * });
+ */
+export declare function registerProvider(name: string, implementation: ProviderImplementation): void;
+/**
+ * Create a LanguageModel instance from a registered provider.
+ *
+ * @param provider - Provider name (must be registered in providerRegistry)
+ * @param config - Configuration including model name and provider-specific options
+ * @returns LanguageModel instance from the AI SDK
+ * @throws Error if provider is not found, listing available providers
+ *
+ * @example
+ * const model = createModel('google', { model: 'gemini-1.5-flash' });
+ */
+export declare function createModel(provider: string, config: ProviderConfig): LanguageModel;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAIxC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACnC,WAAW,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,aAAa,CAAC;CAC1D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAM,CAAC;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC5B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,sBAAsB,GACvC,IAAI,CAKN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,aAAa,CAOnF"}

package/dist/providers/index.js

@@ -0,0 +1,94 @@
+/**
+ * Beddel Protocol - Provider Registry
+ *
+ * This registry maps provider names to their implementations.
+ * Following Expansion Pack Pattern from BMAD-METHOD™ for extensibility.
+ * See: https://github.com/bmadcode/bmad-method
+ *
+ * Server-only: Providers may use Node.js APIs and external services.
+ */
+import { createGoogleGenerativeAI } from '@ai-sdk/google';
+import { bedrock } from '@ai-sdk/amazon-bedrock';
+/**
+ * Registry of provider implementations keyed by provider name.
+ *
+ * Built-in Providers:
+ * - 'google': Google Gemini via @ai-sdk/google
+ * - 'bedrock': Amazon Bedrock via @ai-sdk/amazon-bedrock
+ */
+export const providerRegistry = {};
+/**
+ * Register a custom provider implementation in the registry.
+ * Allows consumers to extend Beddel with additional LLM providers.
+ *
+ * @param name - Provider identifier (e.g., 'openai', 'anthropic')
+ * @param implementation - ProviderImplementation with createModel method
+ *
+ * @example
+ * import { registerProvider } from 'beddel';
+ *
+ * registerProvider('openai', {
+ *   createModel: (config) => {
+ *     const openai = createOpenAI({ apiKey: process.env.OPENAI_API_KEY });
+ *     return openai(config.model || 'gpt-4');
+ *   },
+ * });
+ */
+export function registerProvider(name, implementation) {
+    if (providerRegistry[name]) {
+        console.warn(`[Beddel] Provider '${name}' already registered, overwriting.`);
+    }
+    providerRegistry[name] = implementation;
+}
+/**
+ * Create a LanguageModel instance from a registered provider.
+ *
+ * @param provider - Provider name (must be registered in providerRegistry)
+ * @param config - Configuration including model name and provider-specific options
+ * @returns LanguageModel instance from the AI SDK
+ * @throws Error if provider is not found, listing available providers
+ *
+ * @example
+ * const model = createModel('google', { model: 'gemini-1.5-flash' });
+ */
+export function createModel(provider, config) {
+    const impl = providerRegistry[provider];
+    if (!impl) {
+        const available = Object.keys(providerRegistry).join(', ') || 'none';
+        throw new Error(`Unknown provider: '${provider}'. Available: ${available}`);
+    }
+    return impl.createModel(config);
+}
+// =============================================================================
+// Built-in Providers
+// =============================================================================
+/**
+ * Google Gemini Provider (Built-in)
+ *
+ * Uses @ai-sdk/google with GEMINI_API_KEY environment variable.
+ * Default model: gemini-1.5-flash
+ *
+ * Requirements: 1.2, 4.1
+ */
+registerProvider('google', {
+    createModel: (config) => {
+        const google = createGoogleGenerativeAI({
+            apiKey: process.env.GEMINI_API_KEY,
+        });
+        return google(config.model || 'gemini-1.5-flash');
+    },
+});
+/**
+ * Amazon Bedrock Provider (Built-in)
+ *
+ * Uses @ai-sdk/amazon-bedrock with AWS_BEARER_TOKEN_BEDROCK environment variable.
+ * SDK auto-detects credentials from environment.
+ * Default model: anthropic.claude-3-haiku-20240307-v1:0
+ *
+ * Requirements: 1.3, 4.2
+ */
+registerProvider('bedrock', {
+    createModel: (config) => {
+        return bedrock(config.model || 'anthropic.claude-3-haiku-20240307-v1:0');
+    },
+});

package/dist/validation/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Beddel Protocol - Validation Module
+ * Schema validation using Zod with stream/output constraint enforcement
+ */
+import { ZodSchema } from 'zod';
+import type { SchemaSpec, ParsedYaml } from '../types';
+/**
+ * Validation error with detailed issue list
+ */
+export declare class ValidationError extends Error {
+    details: string[];
+    constructor(message: string, details: string[]);
+}
+/**
+ * Convert SchemaSpec to Zod schema
+ */
+export declare function schemaSpecToZod(spec: SchemaSpec): ZodSchema;
+/**
+ * Validate data against SchemaSpec
+ */
+export declare function validateSchema(spec: SchemaSpec, data: unknown): {
+    success: true;
+    data: unknown;
+} | {
+    success: false;
+    error: ValidationError;
+};
+/**
+ * Validate YAML structure for stream/output constraint
+ * @throws ValidationError if stream: true AND output schema is defined
+ */
+export declare function validateYamlConstraints(yaml: ParsedYaml): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAK,SAAS,EAAE,MAAM,KAAK,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACF,OAAO,EAAE,MAAM,EAAE;gBAAzC,OAAO,EAAE,MAAM,EAAS,OAAO,EAAE,MAAM,EAAE;CAIxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAqB3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC1B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,OAAO,GACd;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAa/E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAiB9D"}

package/dist/validation/index.js

@@ -0,0 +1,74 @@
+/**
+ * Beddel Protocol - Validation Module
+ * Schema validation using Zod with stream/output constraint enforcement
+ */
+import { z } from 'zod';
+/**
+ * Validation error with detailed issue list
+ */
+export class ValidationError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Convert SchemaSpec to Zod schema
+ */
+export function schemaSpecToZod(spec) {
+    switch (spec.type) {
+        case 'string':
+            return z.string();
+        case 'number':
+            return z.number();
+        case 'boolean':
+            return z.boolean();
+        case 'array':
+            return z.array(spec.items ? schemaSpecToZod(spec.items) : z.unknown());
+        case 'object': {
+            const shape = {};
+            for (const [key, value] of Object.entries(spec.properties || {})) {
+                const fieldSchema = schemaSpecToZod(value);
+                shape[key] = spec.required?.includes(key) ? fieldSchema : fieldSchema.optional();
+            }
+            return z.object(shape);
+        }
+        default:
+            return z.unknown();
+    }
+}
+/**
+ * Validate data against SchemaSpec
+ */
+export function validateSchema(spec, data) {
+    const schema = schemaSpecToZod(spec);
+    const result = schema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    const details = result.error.issues.map(i => `${i.path.join('.')}: ${i.message}`);
+    return {
+        success: false,
+        error: new ValidationError('Validation failed', details)
+    };
+}
+/**
+ * Validate YAML structure for stream/output constraint
+ * @throws ValidationError if stream: true AND output schema is defined
+ */
+export function validateYamlConstraints(yaml) {
+    for (const step of yaml.workflow) {
+        const config = step.config;
+        if (step.type === 'llm' && config.stream === true && config.output) {
+            const error = new ValidationError(`Step '${step.id}' has incompatible config: stream=true with output schema`, [
+                'Streaming mode does not support structured output validation.',
+                'Either set stream: false, or remove the output schema.'
+            ]);
+            // Log to server before throwing
+            console.error('[Beddel] YAML Constraint Violation:', error.message, error.details);
+            throw error;
+        }
+    }
+}

package/docs/architecture/api-reference.md

@@ -88,6 +88,14 @@ Map of tool names to their implementations for LLM function calling.
 - `calculator` — Evaluate mathematical expressions
 - `getCurrentTime` — Get current ISO timestamp
 
+#### `providerRegistry: Record<string, ProviderImplementation>`
+
+Map of provider names to their implementations for LLM model creation.
+
+**Built-in providers:**
+- `google` — Google Gemini via `@ai-sdk/google` (requires `GEMINI_API_KEY`)
+- `bedrock` — Amazon Bedrock via `@ai-sdk/amazon-bedrock` (auto-detects AWS credentials)
+
 ---
 
 ### Extensibility Functions
@@ -132,6 +140,36 @@ registerCallback('persistConversation', async ({ text, usage }) => {
 });
 ```
 
+#### `registerProvider(name: string, implementation: ProviderImplementation): void`
+
+Register a custom LLM provider for dynamic model selection.
+
+```typescript
+import { registerProvider } from 'beddel';
+import { createOpenAI } from '@ai-sdk/openai';
+
+registerProvider('openai', {
+  createModel: (config) => {
+    const openai = createOpenAI({ apiKey: process.env.OPENAI_API_KEY });
+    return openai(config.model || 'gpt-4');
+  },
+});
+```
+
+#### `createModel(provider: string, config: ProviderConfig): LanguageModel`
+
+Create a LanguageModel instance from a registered provider.
+
+```typescript
+import { createModel } from 'beddel';
+
+const model = createModel('google', { model: 'gemini-1.5-flash' });
+// Or use bedrock
+const bedrockModel = createModel('bedrock', { model: 'anthropic.claude-3-haiku-20240307-v1:0' });
+```
+
+**Throws:** Error if provider is not found, listing available providers.
+
 ---
 
 ## `beddel/server`
@@ -267,6 +305,23 @@ interface ToolImplementation {
 type CallbackFn = (payload: Record<string, unknown>) => void | Promise<void>;
 ```
 
+### `ProviderImplementation`
+
+```typescript
+interface ProviderImplementation {
+  createModel: (config: ProviderConfig) => LanguageModel;
+}
+```
+
+### `ProviderConfig`
+
+```typescript
+interface ProviderConfig {
+  model: string;
+  [key: string]: unknown;
+}
+```
+
 ---
 
 ## AI SDK v6 Compatibility
@@ -305,3 +360,4 @@ return result.toUIMessageStreamResponse();
 |------|---------|-------------|
 | 2024-12-24 | 1.0.0 | Initial API reference |
 | 2024-12-24 | 1.0.1 | AI SDK v6 compatibility: UIMessage/ModelMessage conversion |
+| 2024-12-25 | 1.0.2 | Provider registry: registerProvider, createModel, bedrock support |

package/docs/architecture/components.md

@@ -66,7 +66,7 @@
 - `registerCallback(name: string, fn: CallbackFn): void` - Register lifecycle callbacks
 - `callbackRegistry: Record<string, CallbackFn>` - Stores registered callbacks
 
-**Dependencies:** `ai`, `@ai-sdk/google`, `toolRegistry`, `callbackRegistry`
+**Dependencies:** `ai`, `providerRegistry`, `toolRegistry`, `callbackRegistry`
 
 **Technology Stack (AI SDK v6):**
 - `streamText()` for streaming mode → `result.toUIMessageStreamResponse()`
@@ -75,6 +75,7 @@
 - `dynamicTool()` for registry-based tool creation
 - `stopWhen: stepCountIs(5)` for multi-step tool loops
 - `onFinish` / `onError` lifecycle callbacks
+- `createModel()` from provider registry for dynamic provider selection
 
 **AI SDK v6 Message Format Compatibility:**
 - Frontend (`useChat`) sends `UIMessage[]` with `{ parts: [...] }` format
@@ -84,6 +85,35 @@
 
 ---
 
+### Provider Registry (`src/providers/index.ts`)
+
+**Responsibility:** Register and provide LLM provider implementations for dynamic model creation.
+
+**Key Interfaces:**
+- `providerRegistry: Record<string, ProviderImplementation>`
+- `registerProvider(name: string, implementation: ProviderImplementation): void`
+- `createModel(provider: string, config: ProviderConfig): LanguageModel`
+- `ProviderImplementation: { createModel: (config) => LanguageModel }`
+- `ProviderConfig: { model: string, [key: string]: unknown }`
+
+**Built-in Providers:**
+- `google` - Google Gemini via `@ai-sdk/google` (requires `GEMINI_API_KEY`)
+- `bedrock` - Amazon Bedrock via `@ai-sdk/amazon-bedrock` (requires `AWS_REGION`, defaults to `us-east-1`)
+
+**Environment Variables:**
+
+| Provider | Variable | Description |
+|----------|----------|-------------|
+| `google` | `GEMINI_API_KEY` | Google Gemini API key |
+| `bedrock` | `AWS_REGION` | AWS region (defaults to `us-east-1`) |
+| `bedrock` | `AWS_BEARER_TOKEN_BEDROCK` | Bedrock API key (or use standard AWS credentials) |
+
+**Dependencies:** `ai`, `@ai-sdk/google`, `@ai-sdk/amazon-bedrock`
+
+**Technology Stack:** Registry pattern with Vercel AI SDK LanguageModel interface.
+
+---
+
 ### Output Primitive (`src/primitives/output.ts`)
 
 **Responsibility:** Deterministic JSON transform using variable resolution.
@@ -192,6 +222,22 @@ registerCallback('persistConversation', async ({ text, usage }) => {
 });
 ```
 
+### `registerProvider(name, implementation)`
+
+Add custom LLM providers for dynamic model selection.
+
+```typescript
+import { registerProvider } from 'beddel';
+import { createOpenAI } from '@ai-sdk/openai';
+
+registerProvider('openai', {
+  createModel: (config) => {
+    const openai = createOpenAI({ apiKey: process.env.OPENAI_API_KEY });
+    return openai(config.model || 'gpt-4');
+  },
+});
+```
+
 ---
 
 ## Component Diagram
@@ -217,6 +263,12 @@ graph TB
         CallAgent["call-agent (placeholder)"]
     end
     
+    subgraph "Providers"
+        ProvReg["index.ts (providerRegistry)"]
+        Google["google"]
+        Bedrock["bedrock"]
+    end
+    
     subgraph "Tools"
         ToolReg["index.ts (toolRegistry)"]
         Calc["calculator"]
@@ -231,6 +283,7 @@ graph TB
     Index --> Executor
     Index --> Registry
     Index --> ToolReg
+    Index --> ProvReg
     Server --> Handler
     Handler --> Parser
     Handler --> Executor
@@ -240,6 +293,9 @@ graph TB
     Registry --> OutputPrim
     Registry --> CallAgent
     LLMPrim --> ToolReg
+    LLMPrim --> ProvReg
+    ProvReg --> Google
+    ProvReg --> Bedrock
     ToolReg --> Calc
     ToolReg --> Time
 ```

package/docs/architecture/core-workflows.md

@@ -35,19 +35,48 @@ workflow:
   - id: "chat-interaction"
     type: "llm"
     config:
+      provider: "google"          # Optional: 'google' (default) or 'bedrock'
       model: "gemini-2.0-flash-exp"
       stream: true
       system: "You are a helpful and concise assistant."
       messages: "$input.messages"
 ```
 
+**Using Amazon Bedrock:**
+
+```yaml
+# src/agents/bedrock-assistant.yaml
+metadata:
+  name: "Bedrock Assistant"
+  version: "1.0.0"
+
+workflow:
+  - id: "chat-interaction"
+    type: "llm"
+    config:
+      provider: "bedrock"
+      model: "anthropic.claude-3-haiku-20240307-v1:0"
+      stream: true
+      system: "You are a helpful assistant."
+      messages: "$input.messages"
+```
+
 ### 4. (Optional) Register Custom Extensions
 
 ```typescript
 // app/api/beddel/chat/route.ts
 import { createBeddelHandler } from 'beddel/server';
-import { registerTool, registerCallback } from 'beddel';
+import { registerTool, registerCallback, registerProvider } from 'beddel';
 import { z } from 'zod';
+import { createOpenAI } from '@ai-sdk/openai';
+
+// Register custom LLM provider
+registerProvider('openai', {
+  createModel: (config) => {
+    const openai = createOpenAI({ apiKey: process.env.OPENAI_API_KEY });
+    return openai(config.model || 'gpt-4');
+  },
+});
 
 // Register custom tool
 registerTool('myTool', {
@@ -79,6 +108,7 @@ workflow:
   - id: "step-1"
     type: "llm"           # Primitive type
     config:
+      provider: "google"  # Optional: 'google' (default) or 'bedrock' or custom
       model: "gemini-2.0-flash-exp"
       stream: true        # true = streaming, false = blocking
       system: "System prompt"

package/docs/architecture/high-level-architecture.md

@@ -43,18 +43,22 @@ graph TD
     Executor --> Output["output-generator Primitive"]
     Executor --> CallAgent["call-agent (placeholder)"]
     LLM --> SDK["Vercel AI SDK (streamText/generateText)"]
-    SDK --> Provider["@ai-sdk/google (Gemini)"]
+    SDK --> Provider["Provider Registry"]
+    Provider --> Google["@ai-sdk/google (Gemini)"]
+    Provider --> Bedrock["@ai-sdk/amazon-bedrock"]
     LLM --> Tools["Tool Registry"]
     
     subgraph "Expansion Pack Pattern"
         PrimitiveRegistry["handlerRegistry"]
         ToolRegistry["toolRegistry"]
         CallbackRegistry["callbackRegistry"]
+        ProviderRegistry["providerRegistry"]
     end
     
     Executor --> PrimitiveRegistry
     LLM --> ToolRegistry
     LLM --> CallbackRegistry
+    LLM --> ProviderRegistry
 ```
 
 ---
@@ -63,10 +67,11 @@ graph TD
 
 - **Sequential Pipeline Pattern:** Workflow steps execute in order; first `Response` return breaks the loop — *Rationale:* Enables streaming without blocking subsequent steps
 
-- **Expansion Pack Pattern:** Primitives, tools, and callbacks are registered in extensible maps — *Rationale:* Inspired by BMAD-METHOD™, allows community extensions without core changes
+- **Expansion Pack Pattern:** Primitives, tools, callbacks, and providers are registered in extensible maps — *Rationale:* Inspired by BMAD-METHOD™, allows community extensions without core changes
   - `registerPrimitive(type, handler)` — Add custom step types
   - `registerTool(name, impl)` — Add custom LLM tools
   - `registerCallback(name, fn)` — Add lifecycle hooks
+  - `registerProvider(name, impl)` — Add custom LLM providers
 
 - **Early Return Pattern:** When `llmPrimitive` returns `Response`, executor immediately returns to client — *Rationale:* Prevents buffering of streaming responses
 

package/docs/architecture/source-tree.md

@@ -14,6 +14,8 @@ packages/beddel/
 │   │   ├── index.ts              # Handler registry (handlerRegistry)
 │   │   ├── llm.ts                # streamText/generateText wrapper
 │   │   └── output.ts             # JSON transform primitive
+│   ├── providers/
+│   │   └── index.ts              # Provider registry (google, bedrock)
 │   ├── server/
 │   │   └── handler.ts            # createBeddelHandler factory
 │   ├── tools/
@@ -50,7 +52,7 @@ Beddel exports three distinct bundles to support different runtime environments:
 
 | Import Path | Entry File | Contents | Use Case |
 |-------------|------------|----------|----------|
-| `beddel` | `index.ts` | Full API: `loadYaml`, `WorkflowExecutor`, `handlerRegistry`, `toolRegistry`, `registerPrimitive`, `registerTool` | Internal Beddel usage, custom handlers |
+| `beddel` | `index.ts` | Full API: `loadYaml`, `WorkflowExecutor`, `handlerRegistry`, `toolRegistry`, `providerRegistry`, `registerPrimitive`, `registerTool`, `registerProvider` | Internal Beddel usage, custom handlers |
 | `beddel/server` | `server.ts` | `createBeddelHandler`, `BeddelHandlerOptions` | Next.js API Routes (Consumer) |
 | `beddel/client` | `client.ts` | Types only: `ParsedYaml`, `ExecutionContext`, `PrimitiveHandler`, etc. | Client Components, type-checking |
 

package/docs/architecture/tech-stack.md

@@ -8,6 +8,7 @@
 | **Runtime**    | Node.js / Edge       | 20+     | JavaScript runtime                   | Next.js App Router Edge compatibility        |
 | **AI Core**    | `ai`                 | 6.x     | Vercel AI SDK Core                   | Native `streamText`/`generateText` support   |
 | **AI Provider**| `@ai-sdk/google`     | 3.x     | Google Gemini integration            | Default LLM provider (requires v3+ for AI SDK 6.x) |
+| **AI Provider**| `@ai-sdk/amazon-bedrock` | 4.x | Amazon Bedrock integration           | Alternative LLM provider for AWS environments |
 | **Validation** | `zod`                | 3.x     | Schema validation for tools          | Type-safe runtime validation                 |
 | **YAML Parser**| `js-yaml`            | 4.x     | Secure YAML parsing                  | FAILSAFE_SCHEMA prevents code execution      |
 | **Framework**  | Next.js App Router   | 14+     | API route hosting                    | Required by consumers, not bundled           |

package/package.json

@@ -1,6 +1,14 @@
 {
     "name": "beddel",
-    "version": "1.0.0",
+    "version": "1.0.2",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/botanarede/beddel.git"
+    },
+    "homepage": "https://beddel.com.br",
+    "bugs": {
+        "url": "https://github.com/botanarede/beddel/issues"
+    },
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
@@ -25,6 +33,7 @@
     "dependencies": {
         "ai": "^6.0.3",
         "@ai-sdk/google": "^3.0.1",
+        "@ai-sdk/amazon-bedrock": "^4.0.3",
         "zod": "^3.23.8",
         "js-yaml": "^4.1.0"
     },
@@ -33,4 +42,4 @@
         "@types/node": "^22.10.2",
         "@types/js-yaml": "^4.0.9"
     }
-}
+}

package/src/index.ts

@@ -22,6 +22,10 @@ export { handlerRegistry, registerPrimitive } from './primitives';
 export { toolRegistry, registerTool } from './tools';
 export type { ToolImplementation } from './tools';
 
+// Providers registry (for custom LLM provider registration)
+export { providerRegistry, registerProvider, createModel } from './providers';
+export type { ProviderImplementation, ProviderConfig } from './providers';
+
 // Types (re-exported for convenience, also available via beddel/client)
 export type {
     ParsedYaml,

package/src/primitives/llm.ts

@@ -26,10 +26,10 @@ import {
     type UIMessage,
     type ToolSet,
 } from 'ai';
-import { createGoogleGenerativeAI } from '@ai-sdk/google';
 import type { StepConfig, ExecutionContext, PrimitiveHandler } from '../types';
 import { toolRegistry, type ToolImplementation } from '../tools';
 import { resolveVariables } from '../core/variable-resolver';
+import { createModel } from '../providers';
 
 /**
  * Callback function type for lifecycle hooks (onFinish, onError).
@@ -74,6 +74,7 @@ interface YamlToolDefinition {
  * LLM step configuration from YAML.
  */
 interface LlmConfig extends StepConfig {
+    provider?: string;
     model?: string;
     stream?: boolean;
     system?: string;
@@ -137,11 +138,10 @@ export const llmPrimitive: PrimitiveHandler = async (
 ): Promise<Response | Record<string, unknown>> => {
     const llmConfig = config as LlmConfig;
 
-    // Initialize Google Generative AI provider
-    const google = createGoogleGenerativeAI({
-        apiKey: process.env.GEMINI_API_KEY,
+    // Create model from provider registry (defaults to 'google')
+    const model = createModel(llmConfig.provider || 'google', {
+        model: llmConfig.model || 'gemini-1.5-flash',
     });
-    const model = google(llmConfig.model || 'gemini-1.5-flash');
 
     // Resolve messages from context (e.g., $input.messages)
     // AI SDK v6: Frontend sends UIMessage[], we convert to ModelMessage[]

package/src/providers/index.ts

@@ -0,0 +1,124 @@
+/**
+ * Beddel Protocol - Provider Registry
+ * 
+ * This registry maps provider names to their implementations.
+ * Following Expansion Pack Pattern from BMAD-METHOD™ for extensibility.
+ * See: https://github.com/bmadcode/bmad-method
+ * 
+ * Server-only: Providers may use Node.js APIs and external services.
+ */
+
+import type { LanguageModel } from 'ai';
+import { createGoogleGenerativeAI } from '@ai-sdk/google';
+import { createAmazonBedrock } from '@ai-sdk/amazon-bedrock';
+
+/**
+ * Configuration passed to provider's createModel method.
+ */
+export interface ProviderConfig {
+    model: string;
+    [key: string]: unknown;
+}
+
+/**
+ * Provider implementation interface.
+ * Each provider must implement createModel to return an AI SDK LanguageModel.
+ */
+export interface ProviderImplementation {
+    createModel: (config: ProviderConfig) => LanguageModel;
+}
+
+/**
+ * Registry of provider implementations keyed by provider name.
+ * 
+ * Built-in Providers:
+ * - 'google': Google Gemini via @ai-sdk/google
+ * - 'bedrock': Amazon Bedrock via @ai-sdk/amazon-bedrock
+ */
+export const providerRegistry: Record<string, ProviderImplementation> = {};
+
+/**
+ * Register a custom provider implementation in the registry.
+ * Allows consumers to extend Beddel with additional LLM providers.
+ * 
+ * @param name - Provider identifier (e.g., 'openai', 'anthropic')
+ * @param implementation - ProviderImplementation with createModel method
+ * 
+ * @example
+ * import { registerProvider } from 'beddel';
+ * 
+ * registerProvider('openai', {
+ *   createModel: (config) => {
+ *     const openai = createOpenAI({ apiKey: process.env.OPENAI_API_KEY });
+ *     return openai(config.model || 'gpt-4');
+ *   },
+ * });
+ */
+export function registerProvider(
+    name: string,
+    implementation: ProviderImplementation
+): void {
+    if (providerRegistry[name]) {
+        console.warn(`[Beddel] Provider '${name}' already registered, overwriting.`);
+    }
+    providerRegistry[name] = implementation;
+}
+
+/**
+ * Create a LanguageModel instance from a registered provider.
+ * 
+ * @param provider - Provider name (must be registered in providerRegistry)
+ * @param config - Configuration including model name and provider-specific options
+ * @returns LanguageModel instance from the AI SDK
+ * @throws Error if provider is not found, listing available providers
+ * 
+ * @example
+ * const model = createModel('google', { model: 'gemini-1.5-flash' });
+ */
+export function createModel(provider: string, config: ProviderConfig): LanguageModel {
+    const impl = providerRegistry[provider];
+    if (!impl) {
+        const available = Object.keys(providerRegistry).join(', ') || 'none';
+        throw new Error(`Unknown provider: '${provider}'. Available: ${available}`);
+    }
+    return impl.createModel(config);
+}
+
+// =============================================================================
+// Built-in Providers
+// =============================================================================
+
+/**
+ * Google Gemini Provider (Built-in)
+ * 
+ * Uses @ai-sdk/google with GEMINI_API_KEY environment variable.
+ * Default model: gemini-1.5-flash
+ * 
+ * Requirements: 1.2, 4.1
+ */
+registerProvider('google', {
+    createModel: (config: ProviderConfig): LanguageModel => {
+        const google = createGoogleGenerativeAI({
+            apiKey: process.env.GEMINI_API_KEY,
+        });
+        return google(config.model || 'gemini-1.5-flash');
+    },
+});
+
+/**
+ * Amazon Bedrock Provider (Built-in)
+ * 
+ * Uses @ai-sdk/amazon-bedrock with AWS_BEARER_TOKEN_BEDROCK environment variable.
+ * Region is configured via AWS_REGION env var or defaults to 'us-east-1'.
+ * Default model: anthropic.claude-3-haiku-20240307-v1:0
+ * 
+ * Requirements: 1.3, 4.2
+ */
+registerProvider('bedrock', {
+    createModel: (config: ProviderConfig): LanguageModel => {
+        const bedrock = createAmazonBedrock({
+            region: process.env.AWS_REGION || 'us-east-1',
+        });
+        return bedrock(config.model || 'anthropic.claude-3-haiku-20240307-v1:0');
+    },
+});