markdown-flow 0.2.16__tar.gz → 0.2.18__tar.gz

{markdown_flow-0.2.16 → markdown_flow-0.2.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-flow
-Version: 0.2.16
+Version: 0.2.18
 Summary: An agent library designed to parse and process MarkdownFlow documents
 Project-URL: Homepage, https://github.com/ai-shifu/markdown-flow-agent-py
 Project-URL: Bug Tracker, https://github.com/ai-shifu/markdown-flow-agent-py/issues
@@ -73,7 +73,7 @@ llm_provider = YourLLMProvider(api_key="your-key")
 mf = MarkdownFlow(document, llm_provider=llm_provider)
 
 # Process with different modes
-result = mf.process(
+result = await mf.process(
     block_index=0,
     mode=ProcessMode.COMPLETE,
     variables={'name': 'Alice', 'level': 'Intermediate'}
@@ -84,7 +84,7 @@ result = mf.process(
 
 ```python
 # Stream processing for real-time responses
-for chunk in mf.process(
+async for chunk in mf.process(
     block_index=0,
     mode=ProcessMode.STREAM,
     variables={'name': 'Bob'}
@@ -92,36 +92,6 @@ for chunk in mf.process(
     print(chunk.content, end='')
 ```
 
-### Dynamic Interaction Generation ✨
-
-Transform natural language content into interactive elements automatically:
-
-```python
-from markdown_flow import MarkdownFlow, ProcessMode
-
-# Dynamic interaction generation works automatically
-mf = MarkdownFlow(
-    document="询问用户的菜品偏好，并记录到变量{{菜品选择}}",
-    llm_provider=llm_provider,
-    document_prompt="你是中餐厅服务员，提供川菜、粤菜、鲁菜等选项"
-)
-
-# Process with Function Calling
-result = mf.process(0, ProcessMode.COMPLETE)
-
-if result.transformed_to_interaction:
-    print(f"Generated interaction: {result.content}")
-    # Output: ?[%{{菜品选择}} 宫保鸡丁||麻婆豆腐||水煮鱼||...其他菜品]
-
-# Continue with user input
-user_result = mf.process(
-    block_index=0,
-    mode=ProcessMode.COMPLETE,
-    user_input={"菜品选择": ["宫保鸡丁", "麻婆豆腐"]},
-    dynamic_interaction_format=result.content
-)
-```
-
 ### Interactive Elements
 
 ```python
@@ -152,66 +122,13 @@ user_input = {
     'skills': ['Python', 'JavaScript', 'Go']  # Multi-selection
 }
 
-result = mf.process(
+result = await mf.process(
     block_index=1,  # Process skills interaction
     user_input=user_input,
     mode=ProcessMode.COMPLETE
 )
 ```
 
-## ✨ Key Features
-
-### 🏗️ Three-Layer Architecture
-
-- **Document Level**: Parse `---` separators and `?[]` interaction patterns
-- **Block Level**: Categorize as CONTENT, INTERACTION, or PRESERVED_CONTENT
-- **Interaction Level**: Handle 6 different interaction types with smart validation
-
-### 🔄 Dynamic Interaction Generation
-
-- **Natural Language Input**: Write content in plain language
-- **AI-Powered Conversion**: LLM automatically detects interaction needs using Function Calling
-- **Structured Data Generation**: LLM returns structured data, core builds MarkdownFlow format
-- **Language Agnostic**: Support for any language with proper document prompts
-- **Context Awareness**: Both original and resolved variable contexts provided to LLM
-
-### 🤖 Unified LLM Integration
-
-- **Single Interface**: One `complete()` method for both regular and Function Calling modes
-- **Automatic Detection**: Tools parameter determines processing mode automatically
-- **Consistent Returns**: Always returns `LLMResult` with structured metadata
-- **Error Handling**: Automatic fallback from Function Calling to regular completion
-- **Provider Agnostic**: Abstract interface supports any LLM service
-
-### 📝 Variable System
-
-- **Replaceable Variables**: `{{variable}}` for content personalization
-- **Preserved Variables**: `%{{variable}}` for LLM understanding in interactions
-- **Multi-Value Support**: Handle both single values and arrays
-- **Smart Extraction**: Automatic detection from document content
-
-### 🎯 Interaction Types
-
-- **Text Input**: `?[%{{var}}...question]` - Free text entry
-- **Single Select**: `?[%{{var}} A|B|C]` - Choose one option
-- **Multi Select**: `?[%{{var}} A||B||C]` - Choose multiple options
-- **Mixed Mode**: `?[%{{var}} A||B||...custom]` - Predefined + custom input
-- **Display Buttons**: `?[Continue|Cancel]` - Action buttons without assignment
-- **Value Separation**: `?[%{{var}} Display//value|...]` - Different display/stored values
-
-### 🔒 Content Preservation
-
-- **Multiline Format**: `!===content!===` blocks output exactly as written
-- **Inline Format**: `===content===` for single-line preserved content
-- **Variable Support**: Preserved content can contain variables for substitution
-
-### ⚡ Performance Optimized
-
-- **Pre-compiled Regex**: All patterns compiled once for maximum performance
-- **Synchronous Interface**: Clean synchronous operations with optional streaming
-- **Stream Processing**: Real-time streaming responses supported
-- **Memory Efficient**: Lazy evaluation and generator patterns
-
 ## 📖 API Reference
 
 ### Core Classes
@@ -231,7 +148,7 @@ class MarkdownFlow:
     def get_all_blocks(self) -> List[Block]: ...
     def extract_variables(self) -> Set[str]: ...
 
-    def process(
+    async def process(
         self,
         block_index: int,
         mode: ProcessMode = ProcessMode.COMPLETE,
@@ -276,15 +193,15 @@ class ProcessMode(Enum):
 
 ```python
 # Generate prompt only
-prompt_result = mf.process(0, ProcessMode.PROMPT_ONLY)
+prompt_result = await mf.process(0, ProcessMode.PROMPT_ONLY)
 print(prompt_result.content)  # Raw prompt text
 
 # Complete response
-complete_result = mf.process(0, ProcessMode.COMPLETE)
+complete_result = await mf.process(0, ProcessMode.COMPLETE)
 print(complete_result.content)  # Full LLM response
 
 # Streaming response
-for chunk in mf.process(0, ProcessMode.STREAM):
+async for chunk in mf.process(0, ProcessMode.STREAM):
     print(chunk.content, end='')
 ```
 
@@ -294,14 +211,14 @@ Abstract base class for implementing LLM providers.
 
 ```python
 from abc import ABC, abstractmethod
-from typing import Generator
+from typing import AsyncGenerator
 
 class LLMProvider(ABC):
     @abstractmethod
-    def complete(self, prompt: str) -> LLMResult: ...
+    async def complete(self, prompt: str) -> LLMResult: ...
 
     @abstractmethod
-    def stream(self, prompt: str) -> Generator[str, None, None]: ...
+    async def stream(self, prompt: str) -> AsyncGenerator[str, None]: ...
 ```
 
 **Custom Implementation:**
@@ -309,23 +226,23 @@ class LLMProvider(ABC):
 ```python
 class OpenAIProvider(LLMProvider):
     def __init__(self, api_key: str):
-        self.client = openai.OpenAI(api_key=api_key)
+        self.client = openai.AsyncOpenAI(api_key=api_key)
 
-    def complete(self, prompt: str) -> LLMResult:
-        response = self.client.completions.create(
+    async def complete(self, prompt: str) -> LLMResult:
+        response = await self.client.completions.create(
             model="gpt-3.5-turbo",
             prompt=prompt,
             max_tokens=500
         )
         return LLMResult(content=response.choices[0].text.strip())
 
-    def stream(self, prompt: str):
-        stream = self.client.completions.create(
+    async def stream(self, prompt: str):
+        stream = await self.client.completions.create(
             model="gpt-3.5-turbo",
             prompt=prompt,
             stream=True
         )
-        for chunk in stream:
+        async for chunk in stream:
             if chunk.choices[0].text:
                 yield chunk.choices[0].text
 ```
@@ -485,7 +402,7 @@ The new version introduces multi-select interaction support with improvements to
 user_input = "Python"
 
 # Process interaction
-result = mf.process(
+result = await mf.process(
     block_index=1,
     user_input=user_input,
     mode=ProcessMode.COMPLETE
@@ -502,7 +419,7 @@ user_input = {
 }
 
 # Process interaction
-result = mf.process(
+result = await mf.process(
     block_index=1,
     user_input=user_input,
     mode=ProcessMode.COMPLETE
@@ -545,10 +462,10 @@ class CustomAPIProvider(LLMProvider):
     def __init__(self, base_url: str, api_key: str):
         self.base_url = base_url
         self.api_key = api_key
-        self.client = httpx.Client()
+        self.client = httpx.AsyncClient()
 
-    def complete(self, prompt: str) -> LLMResult:
-        response = self.client.post(
+    async def complete(self, prompt: str) -> LLMResult:
+        response = await self.client.post(
             f"{self.base_url}/complete",
             headers={"Authorization": f"Bearer {self.api_key}"},
             json={"prompt": prompt, "max_tokens": 1000}
@@ -556,14 +473,14 @@ class CustomAPIProvider(LLMProvider):
         data = response.json()
         return LLMResult(content=data["text"])
 
-    def stream(self, prompt: str):
-        with self.client.stream(
+    async def stream(self, prompt: str):
+        async with self.client.stream(
             "POST",
             f"{self.base_url}/stream",
             headers={"Authorization": f"Bearer {self.api_key}"},
             json={"prompt": prompt}
         ) as response:
-            for chunk in response.iter_text():
+            async for chunk in response.aiter_text():
                 if chunk.strip():
                     yield chunk
 
@@ -575,7 +492,7 @@ mf = MarkdownFlow(document, llm_provider=provider)
 ### Multi-Block Document Processing
 
 ```python
-def process_conversation():
+async def process_conversation():
     conversation = """
 # AI Assistant
 
@@ -612,7 +529,7 @@ Would you like to start with the basics?
     for i, block in enumerate(blocks):
         if block.block_type == BlockType.CONTENT:
             print(f"\n--- Processing Block {i} ---")
-            result = mf.process(
+            result = await mf.process(
                 block_index=i,
                 mode=ProcessMode.COMPLETE,
                 variables=variables
@@ -627,8 +544,9 @@ Would you like to start with the basics?
 
 ```python
 from markdown_flow import MarkdownFlow, ProcessMode
+import asyncio
 
-def stream_with_progress():
+async def stream_with_progress():
     document = """
 Generate a comprehensive Python tutorial for {{user_name}}
 focusing on {{topic}} with practical examples.
@@ -642,7 +560,7 @@ Include code samples, explanations, and practice exercises.
     content = ""
     chunk_count = 0
 
-    for chunk in mf.process(
+    async for chunk in mf.process(
         block_index=0,
         mode=ProcessMode.STREAM,
         variables={
@@ -681,13 +599,13 @@ class InteractiveDocumentBuilder:
         self.user_responses = {}
         self.current_block = 0
 
-    def start_interaction(self):
+    async def start_interaction(self):
         blocks = self.mf.get_all_blocks()
 
         for i, block in enumerate(blocks):
             if block.block_type == BlockType.CONTENT:
                 # Process content block with current variables
-                result = self.mf.process(
+                result = await self.mf.process(
                     block_index=i,
                     mode=ProcessMode.COMPLETE,
                     variables=self.user_responses
@@ -696,11 +614,11 @@ class InteractiveDocumentBuilder:
 
             elif block.block_type == BlockType.INTERACTION:
                 # Handle user interaction
-                response = self.handle_interaction(block.content)
+                response = await self.handle_interaction(block.content)
                 if response:
                     self.user_responses.update(response)
 
-    def handle_interaction(self, interaction_content: str):
+    async def handle_interaction(self, interaction_content: str):
         from markdown_flow.utils import InteractionParser
 
         interaction = InteractionParser.parse(interaction_content)
@@ -717,7 +635,7 @@ class InteractiveDocumentBuilder:
                 return {interaction.variable: selected}
             except (ValueError, IndexError):
                 print("Invalid choice")
-                return self.handle_interaction(interaction_content)
+                return await self.handle_interaction(interaction_content)
 
         elif interaction.name == "TEXT_ONLY":
             response = input(f"{interaction.question}: ")
@@ -739,7 +657,7 @@ Great choice, {{name}}! {{subject}} is an excellent field to study.
 """
 
 builder = InteractiveDocumentBuilder(template, your_llm_provider)
-builder.start_interaction()
+await builder.start_interaction()
 ```
 
 ### Variable System Deep Dive

{markdown_flow-0.2.16 → markdown_flow-0.2.18}/README.md

@@ -55,7 +55,7 @@ llm_provider = YourLLMProvider(api_key="your-key")
 mf = MarkdownFlow(document, llm_provider=llm_provider)
 
 # Process with different modes
-result = mf.process(
+result = await mf.process(
     block_index=0,
     mode=ProcessMode.COMPLETE,
     variables={'name': 'Alice', 'level': 'Intermediate'}
@@ -66,7 +66,7 @@ result = mf.process(
 
 ```python
 # Stream processing for real-time responses
-for chunk in mf.process(
+async for chunk in mf.process(
     block_index=0,
     mode=ProcessMode.STREAM,
     variables={'name': 'Bob'}
@@ -74,36 +74,6 @@ for chunk in mf.process(
     print(chunk.content, end='')
 ```
 
-### Dynamic Interaction Generation ✨
-
-Transform natural language content into interactive elements automatically:
-
-```python
-from markdown_flow import MarkdownFlow, ProcessMode
-
-# Dynamic interaction generation works automatically
-mf = MarkdownFlow(
-    document="询问用户的菜品偏好，并记录到变量{{菜品选择}}",
-    llm_provider=llm_provider,
-    document_prompt="你是中餐厅服务员，提供川菜、粤菜、鲁菜等选项"
-)
-
-# Process with Function Calling
-result = mf.process(0, ProcessMode.COMPLETE)
-
-if result.transformed_to_interaction:
-    print(f"Generated interaction: {result.content}")
-    # Output: ?[%{{菜品选择}} 宫保鸡丁||麻婆豆腐||水煮鱼||...其他菜品]
-
-# Continue with user input
-user_result = mf.process(
-    block_index=0,
-    mode=ProcessMode.COMPLETE,
-    user_input={"菜品选择": ["宫保鸡丁", "麻婆豆腐"]},
-    dynamic_interaction_format=result.content
-)
-```
-
 ### Interactive Elements
 
 ```python
@@ -134,66 +104,13 @@ user_input = {
     'skills': ['Python', 'JavaScript', 'Go']  # Multi-selection
 }
 
-result = mf.process(
+result = await mf.process(
     block_index=1,  # Process skills interaction
     user_input=user_input,
     mode=ProcessMode.COMPLETE
 )
 ```
 
-## ✨ Key Features
-
-### 🏗️ Three-Layer Architecture
-
-- **Document Level**: Parse `---` separators and `?[]` interaction patterns
-- **Block Level**: Categorize as CONTENT, INTERACTION, or PRESERVED_CONTENT
-- **Interaction Level**: Handle 6 different interaction types with smart validation
-
-### 🔄 Dynamic Interaction Generation
-
-- **Natural Language Input**: Write content in plain language
-- **AI-Powered Conversion**: LLM automatically detects interaction needs using Function Calling
-- **Structured Data Generation**: LLM returns structured data, core builds MarkdownFlow format
-- **Language Agnostic**: Support for any language with proper document prompts
-- **Context Awareness**: Both original and resolved variable contexts provided to LLM
-
-### 🤖 Unified LLM Integration
-
-- **Single Interface**: One `complete()` method for both regular and Function Calling modes
-- **Automatic Detection**: Tools parameter determines processing mode automatically
-- **Consistent Returns**: Always returns `LLMResult` with structured metadata
-- **Error Handling**: Automatic fallback from Function Calling to regular completion
-- **Provider Agnostic**: Abstract interface supports any LLM service
-
-### 📝 Variable System
-
-- **Replaceable Variables**: `{{variable}}` for content personalization
-- **Preserved Variables**: `%{{variable}}` for LLM understanding in interactions
-- **Multi-Value Support**: Handle both single values and arrays
-- **Smart Extraction**: Automatic detection from document content
-
-### 🎯 Interaction Types
-
-- **Text Input**: `?[%{{var}}...question]` - Free text entry
-- **Single Select**: `?[%{{var}} A|B|C]` - Choose one option
-- **Multi Select**: `?[%{{var}} A||B||C]` - Choose multiple options
-- **Mixed Mode**: `?[%{{var}} A||B||...custom]` - Predefined + custom input
-- **Display Buttons**: `?[Continue|Cancel]` - Action buttons without assignment
-- **Value Separation**: `?[%{{var}} Display//value|...]` - Different display/stored values
-
-### 🔒 Content Preservation
-
-- **Multiline Format**: `!===content!===` blocks output exactly as written
-- **Inline Format**: `===content===` for single-line preserved content
-- **Variable Support**: Preserved content can contain variables for substitution
-
-### ⚡ Performance Optimized
-
-- **Pre-compiled Regex**: All patterns compiled once for maximum performance
-- **Synchronous Interface**: Clean synchronous operations with optional streaming
-- **Stream Processing**: Real-time streaming responses supported
-- **Memory Efficient**: Lazy evaluation and generator patterns
-
 ## 📖 API Reference
 
 ### Core Classes
@@ -213,7 +130,7 @@ class MarkdownFlow:
     def get_all_blocks(self) -> List[Block]: ...
     def extract_variables(self) -> Set[str]: ...
 
-    def process(
+    async def process(
         self,
         block_index: int,
         mode: ProcessMode = ProcessMode.COMPLETE,
@@ -258,15 +175,15 @@ class ProcessMode(Enum):
 
 ```python
 # Generate prompt only
-prompt_result = mf.process(0, ProcessMode.PROMPT_ONLY)
+prompt_result = await mf.process(0, ProcessMode.PROMPT_ONLY)
 print(prompt_result.content)  # Raw prompt text
 
 # Complete response
-complete_result = mf.process(0, ProcessMode.COMPLETE)
+complete_result = await mf.process(0, ProcessMode.COMPLETE)
 print(complete_result.content)  # Full LLM response
 
 # Streaming response
-for chunk in mf.process(0, ProcessMode.STREAM):
+async for chunk in mf.process(0, ProcessMode.STREAM):
     print(chunk.content, end='')
 ```
 
@@ -276,14 +193,14 @@ Abstract base class for implementing LLM providers.
 
 ```python
 from abc import ABC, abstractmethod
-from typing import Generator
+from typing import AsyncGenerator
 
 class LLMProvider(ABC):
     @abstractmethod
-    def complete(self, prompt: str) -> LLMResult: ...
+    async def complete(self, prompt: str) -> LLMResult: ...
 
     @abstractmethod
-    def stream(self, prompt: str) -> Generator[str, None, None]: ...
+    async def stream(self, prompt: str) -> AsyncGenerator[str, None]: ...
 ```
 
 **Custom Implementation:**
@@ -291,23 +208,23 @@ class LLMProvider(ABC):
 ```python
 class OpenAIProvider(LLMProvider):
     def __init__(self, api_key: str):
-        self.client = openai.OpenAI(api_key=api_key)
+        self.client = openai.AsyncOpenAI(api_key=api_key)
 
-    def complete(self, prompt: str) -> LLMResult:
-        response = self.client.completions.create(
+    async def complete(self, prompt: str) -> LLMResult:
+        response = await self.client.completions.create(
             model="gpt-3.5-turbo",
             prompt=prompt,
             max_tokens=500
         )
         return LLMResult(content=response.choices[0].text.strip())
 
-    def stream(self, prompt: str):
-        stream = self.client.completions.create(
+    async def stream(self, prompt: str):
+        stream = await self.client.completions.create(
             model="gpt-3.5-turbo",
             prompt=prompt,
             stream=True
         )
-        for chunk in stream:
+        async for chunk in stream:
             if chunk.choices[0].text:
                 yield chunk.choices[0].text
 ```
@@ -467,7 +384,7 @@ The new version introduces multi-select interaction support with improvements to
 user_input = "Python"
 
 # Process interaction
-result = mf.process(
+result = await mf.process(
     block_index=1,
     user_input=user_input,
     mode=ProcessMode.COMPLETE
@@ -484,7 +401,7 @@ user_input = {
 }
 
 # Process interaction
-result = mf.process(
+result = await mf.process(
     block_index=1,
     user_input=user_input,
     mode=ProcessMode.COMPLETE
@@ -527,10 +444,10 @@ class CustomAPIProvider(LLMProvider):
     def __init__(self, base_url: str, api_key: str):
         self.base_url = base_url
         self.api_key = api_key
-        self.client = httpx.Client()
+        self.client = httpx.AsyncClient()
 
-    def complete(self, prompt: str) -> LLMResult:
-        response = self.client.post(
+    async def complete(self, prompt: str) -> LLMResult:
+        response = await self.client.post(
             f"{self.base_url}/complete",
             headers={"Authorization": f"Bearer {self.api_key}"},
             json={"prompt": prompt, "max_tokens": 1000}
@@ -538,14 +455,14 @@ class CustomAPIProvider(LLMProvider):
         data = response.json()
         return LLMResult(content=data["text"])
 
-    def stream(self, prompt: str):
-        with self.client.stream(
+    async def stream(self, prompt: str):
+        async with self.client.stream(
             "POST",
             f"{self.base_url}/stream",
             headers={"Authorization": f"Bearer {self.api_key}"},
             json={"prompt": prompt}
         ) as response:
-            for chunk in response.iter_text():
+            async for chunk in response.aiter_text():
                 if chunk.strip():
                     yield chunk
 
@@ -557,7 +474,7 @@ mf = MarkdownFlow(document, llm_provider=provider)
 ### Multi-Block Document Processing
 
 ```python
-def process_conversation():
+async def process_conversation():
     conversation = """
 # AI Assistant
 
@@ -594,7 +511,7 @@ Would you like to start with the basics?
     for i, block in enumerate(blocks):
         if block.block_type == BlockType.CONTENT:
             print(f"\n--- Processing Block {i} ---")
-            result = mf.process(
+            result = await mf.process(
                 block_index=i,
                 mode=ProcessMode.COMPLETE,
                 variables=variables
@@ -609,8 +526,9 @@ Would you like to start with the basics?
 
 ```python
 from markdown_flow import MarkdownFlow, ProcessMode
+import asyncio
 
-def stream_with_progress():
+async def stream_with_progress():
     document = """
 Generate a comprehensive Python tutorial for {{user_name}}
 focusing on {{topic}} with practical examples.
@@ -624,7 +542,7 @@ Include code samples, explanations, and practice exercises.
     content = ""
     chunk_count = 0
 
-    for chunk in mf.process(
+    async for chunk in mf.process(
         block_index=0,
         mode=ProcessMode.STREAM,
         variables={
@@ -663,13 +581,13 @@ class InteractiveDocumentBuilder:
         self.user_responses = {}
         self.current_block = 0
 
-    def start_interaction(self):
+    async def start_interaction(self):
         blocks = self.mf.get_all_blocks()
 
         for i, block in enumerate(blocks):
             if block.block_type == BlockType.CONTENT:
                 # Process content block with current variables
-                result = self.mf.process(
+                result = await self.mf.process(
                     block_index=i,
                     mode=ProcessMode.COMPLETE,
                     variables=self.user_responses
@@ -678,11 +596,11 @@ class InteractiveDocumentBuilder:
 
             elif block.block_type == BlockType.INTERACTION:
                 # Handle user interaction
-                response = self.handle_interaction(block.content)
+                response = await self.handle_interaction(block.content)
                 if response:
                     self.user_responses.update(response)
 
-    def handle_interaction(self, interaction_content: str):
+    async def handle_interaction(self, interaction_content: str):
         from markdown_flow.utils import InteractionParser
 
         interaction = InteractionParser.parse(interaction_content)
@@ -699,7 +617,7 @@ class InteractiveDocumentBuilder:
                 return {interaction.variable: selected}
             except (ValueError, IndexError):
                 print("Invalid choice")
-                return self.handle_interaction(interaction_content)
+                return await self.handle_interaction(interaction_content)
 
         elif interaction.name == "TEXT_ONLY":
             response = input(f"{interaction.question}: ")
@@ -721,7 +639,7 @@ Great choice, {{name}}! {{subject}} is an excellent field to study.
 """
 
 builder = InteractiveDocumentBuilder(template, your_llm_provider)
-builder.start_interaction()
+await builder.start_interaction()
 ```
 
 ### Variable System Deep Dive

{markdown_flow-0.2.16 → markdown_flow-0.2.18}/markdown_flow/__init__.py

@@ -32,12 +32,12 @@ Basic Usage:
     blocks = mf.get_all_blocks()
 
     # Process blocks using unified interface
-    result = await mf.process(0, variables={'name': 'John'}, mode=ProcessMode.COMPLETE)
+    result = mf.process(0, variables={'name': 'John'}, mode=ProcessMode.COMPLETE)
 
     # Different processing modes
-    prompt_result = await mf.process(0, mode=ProcessMode.PROMPT_ONLY)
-    complete_result = await mf.process(0, mode=ProcessMode.COMPLETE)
-    stream_result = await mf.process(0, mode=ProcessMode.STREAM)
+    prompt_result = mf.process(0, mode=ProcessMode.PROMPT_ONLY)
+    complete_result = mf.process(0, mode=ProcessMode.COMPLETE)
+    stream_result = mf.process(0, mode=ProcessMode.STREAM)
 
 Variable System:
     - {{variable}} - Regular variables, replaced with actual values
@@ -83,4 +83,4 @@ __all__ = [
     "replace_variables_in_text",
 ]
 
-__version__ = "0.2.16"
+__version__ = "0.2.18"