markdown-flow 0.2.10__py3-none-any.whl → 0.2.30__py3-none-any.whl

{markdown_flow-0.2.10.dist-info → markdown_flow-0.2.30.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-flow
-Version: 0.2.10
+Version: 0.2.30
 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
@@ -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
@@ -159,59 +129,6 @@ result = mf.process(
 )
 ```
 
-## ✨ 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
@@ -237,7 +154,7 @@ class MarkdownFlow:
         mode: ProcessMode = ProcessMode.COMPLETE,
         variables: Optional[Dict[str, str]] = None,
         user_input: Optional[str] = None
-    ) -> LLMResult: ...
+    ) -> LLMResult | Generator[LLMResult, None, None]: ...
 ```
 
 **Methods:**
@@ -267,18 +184,13 @@ Processing mode enumeration for different use cases.
 
 ```python
 class ProcessMode(Enum):
-    PROMPT_ONLY = "prompt_only"  # Generate prompts without LLM calls
-    COMPLETE = "complete"        # Non-streaming LLM processing
-    STREAM = "stream"           # Streaming LLM responses
+    COMPLETE = "complete"  # Non-streaming LLM processing
+    STREAM = "stream"      # Streaming LLM responses
 ```
 
 **Usage:**
 
 ```python
-# Generate prompt only
-prompt_result = mf.process(0, ProcessMode.PROMPT_ONLY)
-print(prompt_result.content)  # Raw prompt text
-
 # Complete response
 complete_result = mf.process(0, ProcessMode.COMPLETE)
 print(complete_result.content)  # Full LLM response
@@ -298,10 +210,10 @@ from typing import Generator
 
 class LLMProvider(ABC):
     @abstractmethod
-    def complete(self, prompt: str) -> LLMResult: ...
+    def complete(self, messages: list[dict[str, str]]) -> str: ...
 
     @abstractmethod
-    def stream(self, prompt: str) -> Generator[str, None, None]: ...
+    def stream(self, messages: list[dict[str, str]]) -> Generator[str, None, None]: ...
 ```
 
 **Custom Implementation:**
@@ -311,23 +223,22 @@ class OpenAIProvider(LLMProvider):
     def __init__(self, api_key: str):
         self.client = openai.OpenAI(api_key=api_key)
 
-    def complete(self, prompt: str) -> LLMResult:
-        response = self.client.completions.create(
+    def complete(self, messages: list[dict[str, str]]) -> str:
+        response = self.client.chat.completions.create(
             model="gpt-3.5-turbo",
-            prompt=prompt,
-            max_tokens=500
+            messages=messages
         )
-        return LLMResult(content=response.choices[0].text.strip())
+        return response.choices[0].message.content
 
-    def stream(self, prompt: str):
-        stream = self.client.completions.create(
+    def stream(self, messages: list[dict[str, str]]):
+        stream = self.client.chat.completions.create(
             model="gpt-3.5-turbo",
-            prompt=prompt,
+            messages=messages,
             stream=True
         )
         for chunk in stream:
-            if chunk.choices[0].text:
-                yield chunk.choices[0].text
+            if chunk.choices[0].delta.content:
+                yield chunk.choices[0].delta.content
 ```
 
 ### Block Types
@@ -647,7 +558,7 @@ Include code samples, explanations, and practice exercises.
         mode=ProcessMode.STREAM,
         variables={
             'user_name': 'developer',
-            'topic': 'async programming'
+            'topic': 'synchronous programming'
         }
     ):
         content += chunk.content
@@ -701,9 +612,9 @@ class InteractiveDocumentBuilder:
                     self.user_responses.update(response)
 
     def handle_interaction(self, interaction_content: str):
-        from markdown_flow.utils import InteractionParser
+        from markdown_flow.parser import InteractionParser
 
-        interaction = InteractionParser.parse(interaction_content)
+        interaction = InteractionParser().parse(interaction_content)
         print(f"\n{interaction_content}")
 
         if interaction.name == "BUTTONS_ONLY":

markdown_flow-0.2.30.dist-info/RECORD

@@ -0,0 +1,24 @@
+markdown_flow/__init__.py,sha256=E-P0SvBLJKQSwj2ZijjjXsDFl9axsrX8oTfTl7YBO7w,2808
+markdown_flow/constants.py,sha256=aroEBhrOGY6JxofRxPFe87vesEJFY1Srm0_jRHVdtig,14274
+markdown_flow/core.py,sha256=bwUdblJPPWqV_Utwn3ijmjpauI_FXcZUlVG30BIa7nw,47831
+markdown_flow/enums.py,sha256=Wr41zt0Ce5b3fyLtOTE2erEVp1n92g9OVaBF_BZg_l8,820
+markdown_flow/exceptions.py,sha256=9sUZ-Jd3CPLdSRqG8Pw7eMm7cv_S3VZM6jmjUU8OhIc,976
+markdown_flow/llm.py,sha256=MJRbXKj35AjLCAhWpFhS07s-m3YU2qO1HOFff05HG2I,2239
+markdown_flow/models.py,sha256=EJtZ-EQffKHmNbKJXVsHxGXHV0ywOgdAzopWDSjyVmM,2417
+markdown_flow/utils.py,sha256=TlQan3rNIcbIzgOa-kpphFKpw9IXblFKhIesac_lu3Y,28769
+markdown_flow/parser/__init__.py,sha256=zhLc8m7OvkdKk7K70Db9u3EgTGGcPG1_Cxj5EC2Fnwo,1144
+markdown_flow/parser/code_fence_utils.py,sha256=DdkZDTXSCNMfDfODYVOopWd4-5Enci5siplt8JTFs1g,5074
+markdown_flow/parser/interaction.py,sha256=T4W7iO-iyNJnpM7SmvOH_DRlLuWSDcFyIrN2fH6cv7w,12653
+markdown_flow/parser/json_parser.py,sha256=78GhyyOjlg0l4UmKKNc4zrg-4pSHzrJEt7VKqbz3uyE,1305
+markdown_flow/parser/output.py,sha256=LgxvH6-RINM50p58miQtw_fHER1JEWDGucHk5-sZ-gk,8087
+markdown_flow/parser/preprocessor.py,sha256=YO2znQo7biYAxZZIO5oyrH4h88LZPIe3SidX7ZEOS88,4877
+markdown_flow/parser/validation.py,sha256=fc5-zL4_vsgFQuQ0BHXlJRH5Vkx102SKJy-H72tpLK8,3647
+markdown_flow/parser/variable.py,sha256=eJLbVOyZT8uYM5eJNv5kHLqdRoNz5iNlxHhhi2oDW94,2986
+markdown_flow/providers/__init__.py,sha256=QMr8H9gxoLr6pWXoAb11oZX_She6KWPxnRips537nQ4,319
+markdown_flow/providers/config.py,sha256=Y4Nihqj3KxI6_RyvVKF_mv4mBoPNXeLgYQgv0FqxQfU,2057
+markdown_flow/providers/openai.py,sha256=KgExRJ8QsCeU_c-Yx3IhxG2hBbYN5uZ-uf0VTMvD1LE,12326
+markdown_flow-0.2.30.dist-info/licenses/LICENSE,sha256=qz3BziejhHPd1xa5eVtYEU5Qp6L2pn4otuj194uGxmc,1069
+markdown_flow-0.2.30.dist-info/METADATA,sha256=LEehzrEIw6Q_TyvGFuAG-m0fPEKgO-QcaLgD8LcvyYM,20686
+markdown_flow-0.2.30.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+markdown_flow-0.2.30.dist-info/top_level.txt,sha256=DpigGvQuIt2L0TTLnDU5sylhiTGiZS7MmAMa2hi-AJs,14
+markdown_flow-0.2.30.dist-info/RECORD,,

markdown_flow-0.2.10.dist-info/RECORD

@@ -1,13 +0,0 @@
-markdown_flow/__init__.py,sha256=BVUJBlr7xrT6ctNgYHPFynvY7bPXcptugNDAsTp4oJU,2875
-markdown_flow/constants.py,sha256=pd_KCpTEVlz_IXYekrByqb9VWCQR_XHXoGsFYdLW1Eg,8006
-markdown_flow/core.py,sha256=HNeSbVBuiu03NF6m_jSo1o7V-W_FbdPsth62VLsG7Nw,49170
-markdown_flow/enums.py,sha256=Wr41zt0Ce5b3fyLtOTE2erEVp1n92g9OVaBF_BZg_l8,820
-markdown_flow/exceptions.py,sha256=9sUZ-Jd3CPLdSRqG8Pw7eMm7cv_S3VZM6jmjUU8OhIc,976
-markdown_flow/llm.py,sha256=7DjOL2h2N1g0L4NF9kn0M5mR45ZL0vPsW3TzuOGy1bw,2547
-markdown_flow/models.py,sha256=ENcvXMVXwpFN-RzbeVHhXTjBN0bbmRpJ96K-XS2rizI,2893
-markdown_flow/utils.py,sha256=cVi0zDRK_rCMAr3EDhgITmx6Po5fSvYjqrprYaitYE0,28450
-markdown_flow-0.2.10.dist-info/licenses/LICENSE,sha256=qz3BziejhHPd1xa5eVtYEU5Qp6L2pn4otuj194uGxmc,1069
-markdown_flow-0.2.10.dist-info/METADATA,sha256=QLL_76xo6kwnmH6_6RdpZ5NuFT8MTAZavmHpCFPQ54A,24287
-markdown_flow-0.2.10.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-markdown_flow-0.2.10.dist-info/top_level.txt,sha256=DpigGvQuIt2L0TTLnDU5sylhiTGiZS7MmAMa2hi-AJs,14
-markdown_flow-0.2.10.dist-info/RECORD,,