beddel 1.0.3 → 1.0.5

package/README.md

@@ -1,7 +1,7 @@
 # Beddel Protocol
 
 [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![npm version](https://img.shields.io/badge/npm-1.0.0-brightgreen.svg)](https://www.npmjs.com/package/beddel)
+[![npm version](https://img.shields.io/badge/npm-1.0.4-brightgreen.svg)](https://www.npmjs.com/package/beddel)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
 [![AI SDK](https://img.shields.io/badge/AI%20SDK-v6-purple.svg)](https://sdk.vercel.ai/)
 
@@ -10,11 +10,12 @@
 ## Features
 
 - 🔄 **Sequential Pipeline Execution** — Define workflows as YAML, execute steps in order
-- 🌊 **Native Streaming** — First-class `streamText` support with `useChat` compatibility
+- 🌊 **Native Streaming** — First-class `streamText` support via `chat` primitive with `useChat` compatibility
 - 🔌 **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, Amazon Bedrock, and OpenRouter (400+ models)
+- 🔀 **Semantic Primitives** — `chat` for streaming frontend, `llm` for blocking workflows
 
 ## Installation
 
@@ -51,11 +52,10 @@ metadata:
 
 workflow:
   - id: "chat-interaction"
-    type: "llm"
+    type: "chat"
     config:
       provider: "google"
       model: "gemini-2.0-flash-exp"
-      stream: true
       system: "You are a helpful assistant."
       messages: "$input.messages"
 ```
@@ -71,17 +71,34 @@ metadata:
 
 workflow:
   - id: "chat"
-    type: "llm"
+    type: "chat"
     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"
 ```
 
+#### Example 3: OpenRouter (400+ Models)
+
+```yaml
+# src/agents/assistant-openrouter.yaml
+metadata:
+  name: "OpenRouter Assistant"
+  version: "1.0.0"
+
+workflow:
+  - id: "chat"
+    type: "chat"
+    config:
+      provider: "openrouter"
+      model: "qwen/qwen3-14b:free"  # or any model from openrouter.ai/models
+      system: "You are a helpful assistant."
+      messages: "$input.messages"
+```
+
 ### 3. Set Environment Variables
 
 ```bash
@@ -94,6 +111,9 @@ 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
+
+# For OpenRouter
+OPENROUTER_API_KEY=your_openrouter_api_key
 ```
 
 ### 4. Use with React (useChat)
@@ -132,25 +152,6 @@ export default function Chat() {
 
 > **Note:** The Bedrock provider requires `AWS_REGION` to be set (defaults to `us-east-1` if not provided).
 
-### Example: OpenRouter (400+ Models)
-
-```yaml
-# src/agents/assistant-openrouter.yaml
-metadata:
-  name: "OpenRouter Assistant"
-  version: "1.0.0"
-
-workflow:
-  - id: "chat"
-    type: "llm"
-    config:
-      provider: "openrouter"
-      model: "qwen/qwen3-14b:free"  # or any model from openrouter.ai/models
-      stream: true
-      system: "You are a helpful assistant."
-      messages: "$input.messages"
-```
-
 ## Entry Points
 
 | Import Path | Purpose | Environment |
@@ -208,10 +209,9 @@ metadata:
 
 workflow:
   - id: "step-1"
-    type: "llm"
+    type: "chat"          # or "llm" for non-streaming workflows
     config:
       model: "gemini-2.0-flash-exp"
-      stream: true
       system: "System prompt"
       messages: "$input.messages"
       tools:
@@ -220,6 +220,16 @@ workflow:
     result: "stepOutput"
 ```
 
+### Primitive Types
+
+| Type | Behavior | Use Case |
+|------|----------|----------|
+| `chat` | Always streaming, converts UIMessage | Frontend chat interfaces (`useChat`) |
+| `llm` | Never streaming, returns complete result | Multi-step workflows, variable passing |
+| `call-agent` | Invokes another agent | Sub-agent orchestration |
+| `output-generator` | JSON template transform | Structured output generation |
+| `mcp-tool` | Connects to MCP servers via SSE | External tool integration (GitMCP, Context7) |
+
 ### Variable Resolution
 
 | Pattern | Description | Example |
@@ -240,8 +250,9 @@ Beddel is fully compatible with Vercel AI SDK v6:
 
 - **Frontend:** `useChat` sends `UIMessage[]` with `{ parts: [...] }` format
 - **Backend:** `streamText`/`generateText` expects `ModelMessage[]` with `{ content: ... }`
-- **Automatic Conversion:** `convertToModelMessages()` bridges the gap
-- **Streaming:** `toUIMessageStreamResponse()` returns the correct format for `useChat`
+- **Automatic Conversion:** `chat` primitive uses `convertToModelMessages()` to bridge the gap
+- **Streaming:** `chat` primitive returns `toUIMessageStreamResponse()` for `useChat`
+- **Blocking:** `llm` primitive uses `generateText()` for workflow steps
 
 ## Technology Stack
 
@@ -253,6 +264,7 @@ Beddel is fully compatible with Vercel AI SDK v6:
 | AI Provider | `@ai-sdk/google` | 3.x |
 | AI Provider | `@ai-sdk/amazon-bedrock` | 4.x |
 | AI Provider | `@ai-sdk/openai` | 1.x |
+| MCP Client | `@modelcontextprotocol/sdk` | 1.x |
 | Validation | `zod` | 3.x |
 | YAML Parser | `js-yaml` | 4.x |
 

package/dist/agents/assistant-bedrock.yaml

@@ -9,11 +9,10 @@ metadata:
 
 workflow:
   - id: "chat"
-    type: "llm"
+    type: "chat"
     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.

package/dist/agents/assistant-gitmcp.yaml

@@ -0,0 +1,38 @@
+# GitMCP Documentation Assistant
+# Fetches documentation from GitHub repos via GitMCP and answers questions
+
+metadata:
+  name: "GitMCP Documentation Assistant"
+  version: "1.0.0"
+  builtin: true
+  description: "Assistant that fetches documentation from GitHub repos via GitMCP MCP server"
+
+workflow:
+  # Step 1: Fetch documentation from GitMCP
+  # GitMCP URL format: https://gitmcp.io/{owner}/{repo}
+  # Default: Beddel Protocol docs
+  - id: "fetch-docs"
+    type: "mcp-tool"
+    config:
+      url: "https://gitmcp.io/botanarede/beddel"
+      tool: "fetch_beddel_documentation"
+      arguments: {}
+    result: "mcpDocs"
+
+  # Step 2: Respond using the fetched documentation as context
+  - id: "respond"
+    type: "chat"
+    config:
+      provider: "google"
+      model: "gemini-2.0-flash-exp"
+      system: |
+        You are a helpful assistant specialized in the Beddel Protocol.
+        You have access to the official documentation below.
+        
+        Use this documentation to answer questions accurately.
+        If the documentation doesn't cover the topic, say so clearly.
+        
+        ## Documentation
+        
+        $stepResult.mcpDocs.data
+      messages: "$input.messages"

package/dist/agents/assistant-openrouter.yaml

@@ -8,10 +8,9 @@ metadata:
 
 workflow:
   - id: "chat-interaction"
-    type: "llm"
+    type: "chat"
     config:
       provider: "openrouter"
       model: "qwen/qwen3-coder:free"
-      stream: true
       system: "You are a helpful assistant."
       messages: "$input.messages"

package/dist/agents/assistant.yaml

@@ -8,10 +8,9 @@ metadata:
 
 workflow:
   - id: "chat-interaction"
-    type: "llm"
+    type: "chat"
     config:
       provider: "google"
       model: "gemini-2.0-flash-exp"
-      stream: true
       system: "You are a helpful assistant."
       messages: "$input.messages"

package/dist/agents/index.d.ts

@@ -7,7 +7,7 @@
 /**
  * List of built-in agent IDs available in the package
  */
-export declare const BUILTIN_AGENTS: readonly ["assistant", "assistant-bedrock", "assistant-openrouter"];
+export declare const BUILTIN_AGENTS: readonly ["assistant", "assistant-bedrock", "assistant-openrouter", "assistant-gitmcp", "text-generator", "multi-step-assistant"];
 export type BuiltinAgentId = typeof BUILTIN_AGENTS[number];
 /**
  * Get the absolute path to the built-in agents directory

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;GAEG;AACH,eAAO,MAAM,cAAc,qEAIjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAE3D;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,cAAc,CAEzE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAEnE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;GAEG;AACH,eAAO,MAAM,cAAc,mIAOjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAE3D;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,cAAc,CAEzE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAEnE"}

package/dist/agents/index.js

@@ -16,6 +16,9 @@ export const BUILTIN_AGENTS = [
     'assistant',
     'assistant-bedrock',
     'assistant-openrouter',
+    'assistant-gitmcp',
+    'text-generator',
+    'multi-step-assistant',
 ];
 /**
  * Get the absolute path to the built-in agents directory

package/dist/agents/multi-step-assistant.yaml

@@ -0,0 +1,67 @@
+# Multi-Step Text Analyzer
+# Pipeline: Generate Text → Extract Entities → Classify Sentiment → Structured Summary
+
+metadata:
+  name: "Multi-Step Text Analyzer"
+  version: "1.0.0"
+  builtin: true
+  description: "4-step pipeline demonstrating variable passing between steps"
+
+workflow:
+  # Step 1: Generate sample text using text-generator agent
+  # Input: { messages: [{ role: "user", content: "Generate 200 chars about space exploration" }] }
+  - id: "generate-text"
+    type: "call-agent"
+    config:
+      agentId: "text-generator"
+      input:
+        messages: "$input.messages"
+    result: "generatedText"
+
+  # Step 2: Extract entities and topics from the generated text
+  - id: "extract-entities"
+    type: "llm"
+    config:
+      provider: "google"
+      model: "gemini-2.0-flash-exp"
+      system: |
+        You are an entity extraction specialist. Analyze the given text and extract:
+        - Named entities (people, places, organizations, dates)
+        - Main topics/themes
+        - Key concepts
+        
+        Output ONLY valid JSON (no markdown, no explanation):
+        {"entities":{"people":[],"places":[],"organizations":[],"dates":[]},"topics":[],"concepts":[]}
+      messages:
+        - role: "user"
+          content: "$stepResult.generatedText.generatedText.text"
+    result: "entities"
+
+  # Step 3: Classify sentiment of the text
+  - id: "classify-sentiment"
+    type: "llm"
+    config:
+      provider: "google"
+      model: "gemini-2.0-flash-exp"
+      system: |
+        You are a sentiment analysis expert. Analyze the emotional tone of the text.
+        
+        Output ONLY valid JSON (no markdown, no explanation):
+        {"overall":"positive|negative|neutral|mixed","confidence":0.8,"emotions":["joy"],"tone":"formal"}
+      messages:
+        - role: "user"
+          content: "$stepResult.generatedText.generatedText.text"
+    result: "sentiment"
+
+  # Step 4: Generate structured summary combining all analysis
+  - id: "final-summary"
+    type: "output-generator"
+    config:
+      template:
+        originalText: "$stepResult.generatedText.generatedText.text"
+        entities: "$stepResult.entities.text"
+        sentiment: "$stepResult.sentiment.text"
+        pipeline:
+          steps: 4
+          status: "completed"
+    result: "finalReport"

package/dist/agents/text-generator.yaml

@@ -0,0 +1,27 @@
+# Text Generator Agent
+# Generates text based on length and subject parameters
+# Uses lightweight model for efficiency
+
+metadata:
+  name: "Text Generator"
+  version: "1.0.0"
+  builtin: true
+  description: "Generates text with specified length and subject"
+
+workflow:
+  - id: "generate-text"
+    type: "llm"
+    config:
+      provider: "google"
+      model: "gemini-2.0-flash-exp"
+      system: |
+        You are a text generator. Generate creative, coherent text based on the given parameters.
+        
+        RULES:
+        - Generate approximately the requested number of characters (can vary ±20%)
+        - Stay focused on the given subject/theme
+        - Write in a natural, engaging style
+        - Output ONLY the generated text, no explanations or meta-commentary
+        - Do not use markdown formatting unless specifically requested
+      messages: "$input.messages"
+    result: "generatedText"

package/dist/core/variable-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"variable-resolver.d.ts","sourceRoot":"","sources":["../../src/core/variable-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAwBjD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAoEtF"}
+{"version":3,"file":"variable-resolver.d.ts","sourceRoot":"","sources":["../../src/core/variable-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AA6EjD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAsEtF"}

package/dist/core/variable-resolver.js

@@ -26,6 +26,52 @@ function resolvePath(obj, path) {
     }
     return current;
 }
+/**
+ * Interpolate variable references within a string.
+ * Replaces $input.*, $stepResult.*, and $varName.* patterns.
+ *
+ * @param template - String containing variable references
+ * @param context - Execution context
+ * @returns String with variables replaced by their values
+ */
+function interpolateVariables(template, context) {
+    // Pattern to match $input.path, $stepResult.varName.path, or $varName.path
+    // Matches: $word.word.word... (stops at whitespace, newline, or end)
+    const variablePattern = /\$([a-zA-Z_][a-zA-Z0-9_]*(?:\.[a-zA-Z_][a-zA-Z0-9_]*)*)/g;
+    return template.replace(variablePattern, (match, fullPath) => {
+        // Handle $input.* pattern
+        if (fullPath.startsWith('input.')) {
+            const path = fullPath.slice(6); // Remove "input."
+            const value = resolvePath(context.input, path);
+            return value !== undefined ? String(value) : match;
+        }
+        // Handle $stepResult.* pattern
+        if (fullPath.startsWith('stepResult.')) {
+            const restPath = fullPath.slice(11); // Remove "stepResult."
+            const dotIndex = restPath.indexOf('.');
+            if (dotIndex === -1) {
+                const value = context.variables.get(restPath);
+                return value !== undefined ? String(value) : match;
+            }
+            const varName = restPath.slice(0, dotIndex);
+            const valuePath = restPath.slice(dotIndex + 1);
+            const varValue = context.variables.get(varName);
+            const value = resolvePath(varValue, valuePath);
+            return value !== undefined ? String(value) : match;
+        }
+        // Handle legacy $varName.* pattern
+        const dotIndex = fullPath.indexOf('.');
+        if (dotIndex === -1) {
+            const value = context.variables.get(fullPath);
+            return value !== undefined ? String(value) : match;
+        }
+        const varName = fullPath.slice(0, dotIndex);
+        const valuePath = fullPath.slice(dotIndex + 1);
+        const varValue = context.variables.get(varName);
+        const value = resolvePath(varValue, valuePath);
+        return value !== undefined ? String(value) : match;
+    });
+}
 /**
  * Resolve variable references in a template value.
  *
@@ -45,39 +91,40 @@ export function resolveVariables(template, context) {
     }
     // Handle string patterns
     if (typeof template === 'string') {
-        // Check for $input.* pattern
-        if (template.startsWith('$input.')) {
+        // Check if entire string is a single variable reference
+        // Check for $input.* pattern (entire string)
+        if (template.startsWith('$input.') && !template.includes(' ') && !template.includes('\n')) {
             const path = template.slice(7); // Remove "$input."
             return resolvePath(context.input, path);
         }
-        // Check for $stepResult.* pattern (references step.result names)
-        if (template.startsWith('$stepResult.')) {
+        // Check for $stepResult.* pattern (entire string)
+        if (template.startsWith('$stepResult.') && !template.includes(' ') && !template.includes('\n')) {
             const fullPath = template.slice(12); // Remove "$stepResult."
             const dotIndex = fullPath.indexOf('.');
             if (dotIndex === -1) {
-                // Just the variable name, e.g., "$stepResult.llmOutput"
                 return context.variables.get(fullPath);
             }
-            // Variable name + path, e.g., "$stepResult.llmOutput.text"
             const varName = fullPath.slice(0, dotIndex);
             const restPath = fullPath.slice(dotIndex + 1);
             const varValue = context.variables.get(varName);
             return resolvePath(varValue, restPath);
         }
-        // Check for legacy $varName.* pattern (direct variable reference)
-        if (template.startsWith('$') && !template.startsWith('$$')) {
+        // Check for legacy $varName.* pattern (entire string)
+        if (template.startsWith('$') && !template.startsWith('$$') && !template.includes(' ') && !template.includes('\n')) {
             const fullPath = template.slice(1); // Remove "$"
             const dotIndex = fullPath.indexOf('.');
             if (dotIndex === -1) {
-                // Just the variable name, e.g., "$llmOutput"
                 return context.variables.get(fullPath);
             }
-            // Variable name + path, e.g., "$llmOutput.text"
             const varName = fullPath.slice(0, dotIndex);
             const restPath = fullPath.slice(dotIndex + 1);
             const varValue = context.variables.get(varName);
             return resolvePath(varValue, restPath);
         }
+        // String interpolation: replace $variable.path patterns within larger strings
+        if (template.includes('$')) {
+            return interpolateVariables(template, context);
+        }
         // No pattern match, return as-is
         return template;
     }

package/dist/primitives/call-agent.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Beddel Protocol - Call Agent Primitive
+ *
+ * Enables recursive workflow execution by calling other agents.
+ * This primitive loads and executes another agent's workflow,
+ * passing input and returning the result.
+ *
+ * Server-only: Uses loadYaml and WorkflowExecutor.
+ */
+import type { PrimitiveHandler } from '../types';
+/**
+ * Call Agent Primitive Handler
+ *
+ * Loads another agent's YAML and executes its workflow.
+ *
+ * IMPORTANT: If the called agent returns a Response (streaming),
+ * this primitive will return that Response, causing the parent
+ * workflow to also return immediately.
+ *
+ * For multi-step workflows, ensure called agents use stream: false
+ * so their results can be captured and passed to subsequent steps.
+ *
+ * @param config - Step configuration (agentId, input)
+ * @param context - Execution context with input and variables
+ * @returns Result from called agent (Response or Record)
+ */
+export declare const callAgentPrimitive: PrimitiveHandler;
+//# sourceMappingURL=call-agent.d.ts.map

package/dist/primitives/call-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-agent.d.ts","sourceRoot":"","sources":["../../src/primitives/call-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAgC,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAwD/E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAyBhC,CAAC"}

package/dist/primitives/call-agent.js

@@ -0,0 +1,79 @@
+/**
+ * Beddel Protocol - Call Agent Primitive
+ *
+ * Enables recursive workflow execution by calling other agents.
+ * This primitive loads and executes another agent's workflow,
+ * passing input and returning the result.
+ *
+ * Server-only: Uses loadYaml and WorkflowExecutor.
+ */
+import { loadYaml } from '../core/parser';
+import { WorkflowExecutor } from '../core/workflow';
+import { resolveVariables } from '../core/variable-resolver';
+import { join } from 'path';
+import { access } from 'fs/promises';
+import { getBuiltinAgentsPath } from '../agents';
+/**
+ * Check if a file exists at the given path
+ */
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve agent path with fallback chain:
+ * 1. User agents (agentsPath) - allows override
+ * 2. Built-in agents (package) - fallback
+ */
+async function resolveAgentPath(agentId, agentsPath) {
+    // 1. First: try user agents
+    const userPath = join(process.cwd(), agentsPath, `${agentId}.yaml`);
+    if (await fileExists(userPath)) {
+        return userPath;
+    }
+    // 2. Fallback: built-in agents from package
+    const builtinPath = join(getBuiltinAgentsPath(), `${agentId}.yaml`);
+    if (await fileExists(builtinPath)) {
+        return builtinPath;
+    }
+    throw new Error(`[Beddel] Agent not found: ${agentId}`);
+}
+/**
+ * Call Agent Primitive Handler
+ *
+ * Loads another agent's YAML and executes its workflow.
+ *
+ * IMPORTANT: If the called agent returns a Response (streaming),
+ * this primitive will return that Response, causing the parent
+ * workflow to also return immediately.
+ *
+ * For multi-step workflows, ensure called agents use stream: false
+ * so their results can be captured and passed to subsequent steps.
+ *
+ * @param config - Step configuration (agentId, input)
+ * @param context - Execution context with input and variables
+ * @returns Result from called agent (Response or Record)
+ */
+export const callAgentPrimitive = async (config, context) => {
+    const callConfig = config;
+    if (!callConfig.agentId) {
+        throw new Error('[Beddel] call-agent requires agentId in config');
+    }
+    // Resolve the input to pass to the agent
+    const agentInput = callConfig.input
+        ? resolveVariables(callConfig.input, context)
+        : context.input;
+    // Resolve agent path
+    const agentsPath = callConfig.agentsPath || 'src/agents';
+    const agentPath = await resolveAgentPath(callConfig.agentId, agentsPath);
+    // Load and execute the agent
+    const yaml = await loadYaml(agentPath);
+    const executor = new WorkflowExecutor(yaml);
+    const result = await executor.execute(agentInput);
+    return result;
+};

package/dist/primitives/chat.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Beddel Protocol - Chat Primitive
+ *
+ * DESIGN DECISION: This primitive ALWAYS streams. There is no `stream` config option.
+ * Streaming behavior is semantically determined by primitive type:
+ * - `chat` → Always streams (frontend UX)
+ * - `llm` → Never streams (workflow chaining)
+ *
+ * MESSAGE CONVERSION: Uses `convertToModelMessages()` because input comes from
+ * `useChat` hook which sends `UIMessage[]` format. The AI SDK v6 `streamText`
+ * expects `ModelMessage[]` format.
+ *
+ * Use this primitive when:
+ * - Input comes from useChat frontend hook
+ * - You need streaming responses to the client
+ *
+ * Server-only: Uses Vercel AI SDK Core.
+ */
+import type { PrimitiveHandler } from '../types';
+/**
+ * Chat Primitive Handler
+ *
+ * Converts UIMessage[] (from useChat) to ModelMessage[] and streams response.
+ * Always uses streaming mode for responsive frontend UX.
+ *
+ * @param config - Step configuration from YAML
+ * @param context - Execution context with input and variables
+ * @returns Response (always streaming)
+ */
+export declare const chatPrimitive: PrimitiveHandler;
+//# sourceMappingURL=chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/primitives/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,OAAO,KAAK,EAAgC,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAK/E;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE,gBA8C3B,CAAC"}