Release v3.7.4

.github/workflows/update-api-md.yml

@@ -0,0 +1,57 @@
+name: Update API Reference
+
+on:
+  push:
+    branches: [ "main" ]
+    paths:
+      - 'src/praisonai-agents/praisonaiagents/**/*.py'
+      - 'src/praisonai/praisonai/**/*.py'
+      - 'src/praisonai-ts/src/**/*.ts'
+      - '.github/workflows/update-api-md.yml'
+
+permissions:
+  contents: write
+
+jobs:
+  update-api-md:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        ref: main
+        persist-credentials: true
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Generate api.md
+      run: |
+        cd $GITHUB_WORKSPACE
+        python3 src/praisonai/scripts/generate_api_md.py
+        
+    - name: Check for changes
+      id: check_changes
+      run: |
+        if git diff --quiet api.md; then
+          echo "changes=false" >> $GITHUB_OUTPUT
+          echo "No changes to api.md"
+        else
+          echo "changes=true" >> $GITHUB_OUTPUT
+          echo "api.md has been updated"
+          git diff api.md | head -50
+        fi
+
+    - name: Commit and push changes
+      if: steps.check_changes.outputs.changes == 'true'
+      uses: stefanzweifel/git-auto-commit-action@v5
+      with:
+        commit_message: "docs: auto-update api.md [skip ci]"
+        file_pattern: 'api.md'
+        commit_user_name: "github-actions[bot]"
+        commit_user_email: "41898282+github-actions[bot]@users.noreply.github.com"
+        commit_author: "github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>"

api.md

@@ -552,7 +552,7 @@ Methods:
 
 Types:
 ```python
-from praisonaiagents import AutoRagConfig, Citation, CodeExecutionStep, DeepResearchResponse, ExpandResult, ExpandStrategy, FileSearchCall, MCPCall, Provider, RagRetrievalPolicy, ReasoningStep, RewriteResult, RewriteStrategy, Task, WebSearchCall
+from praisonaiagents import AutoRagConfig, Citation, CodeExecutionStep, DeepResearchResponse, ExpandResult, ExpandStrategy, FileSearchCall, MCPCall, Provider, RagRetrievalPolicy, ReasoningStep, RewriteResult, RewriteStrategy, Task, WebSearchCall, warmup
 ```
 
 Methods:
@@ -569,6 +569,7 @@ Methods:
 * <code title="class Task">Task.<a href="./src/praisonai-agents/praisonaiagents/task/task.py">execute_callback_sync</a>(task_output: TaskOutput) -> None</code>
 * <code title="class Task">Task.<a href="./src/praisonai-agents/praisonaiagents/task/task.py">initialize_memory</a>()</code>
 * <code title="class Task">Task.<a href="./src/praisonai-agents/praisonaiagents/task/task.py">store_in_memory</a>(content: str, agent_name: str = None, task_id: str = None)</code>
+* <code title="function">praisonaiagents.<a href="./src/praisonai-agents/praisonaiagents/__init__.py">warmup</a>(include_litellm: bool = False, include_openai: bool = True) -> dict</code>
 
 # Wrapper (praisonai)
 
@@ -731,6 +732,10 @@ Methods:
 * <code title="cli">praisonai skills install <a href="./src/praisonai/praisonai/cli/commands/skills.py">--help</a></code>
 * <code title="cli">praisonai skills list <a href="./src/praisonai/praisonai/cli/commands/skills.py">--help</a></code>
 * <code title="cli">praisonai skills validate <a href="./src/praisonai/praisonai/cli/commands/skills.py">--help</a></code>
+* <code title="cli">praisonai standardise check <a href="./src/praisonai/praisonai/cli/commands/standardise.py">--help</a></code>
+* <code title="cli">praisonai standardise fix <a href="./src/praisonai/praisonai/cli/commands/standardise.py">--help</a></code>
+* <code title="cli">praisonai standardise init <a href="./src/praisonai/praisonai/cli/commands/standardise.py">--help</a></code>
+* <code title="cli">praisonai standardise report <a href="./src/praisonai/praisonai/cli/commands/standardise.py">--help</a></code>
 * <code title="cli">praisonai templates create <a href="./src/praisonai/praisonai/cli/commands/templates.py">--help</a></code>
 * <code title="cli">praisonai templates list <a href="./src/praisonai/praisonai/cli/commands/templates.py">--help</a></code>
 * <code title="cli">praisonai test info <a href="./src/praisonai/praisonai/cli/commands/test.py">--help</a></code>

docker/Dockerfile.chat

@@ -16,7 +16,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=3.7.3" \
+    "praisonai>=3.7.4" \
     "praisonai[chat]" \
     "embedchain[github,youtube]"
 

docker/Dockerfile.dev

@@ -20,7 +20,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=3.7.3" \
+    "praisonai>=3.7.4" \
     "praisonai[ui]" \
     "praisonai[chat]" \
     "praisonai[realtime]" \

docker/Dockerfile.ui

@@ -16,7 +16,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=3.7.3" \
+    "praisonai>=3.7.4" \
     "praisonai[ui]" \
     "praisonai[crewai]"
 

src/praisonai/praisonai.rb

@@ -3,8 +3,8 @@ class Praisonai < Formula
   
     desc "AI tools for various AI applications"
     homepage "https://github.com/MervinPraison/PraisonAI"
-    url "https://github.com/MervinPraison/PraisonAI/archive/refs/tags/v3.7.3.tar.gz"
-    sha256 `curl -sL https://github.com/MervinPraison/PraisonAI/archive/refs/tags/v3.7.3.tar.gz | shasum -a 256`.split.first
+    url "https://github.com/MervinPraison/PraisonAI/archive/refs/tags/v3.7.4.tar.gz"
+    sha256 `curl -sL https://github.com/MervinPraison/PraisonAI/archive/refs/tags/v3.7.4.tar.gz | shasum -a 256`.split.first
     license "MIT"
   
     depends_on "[email protected]"

src/praisonai/praisonai/deploy.py

@@ -57,7 +57,7 @@ class CloudDeployer:
             file.write("FROM python:3.11-slim\n")
             file.write("WORKDIR /app\n")
             file.write("COPY . .\n")
-            file.write("RUN pip install flask praisonai==3.7.3 gunicorn markdown\n")
+            file.write("RUN pip install flask praisonai==3.7.4 gunicorn markdown\n")
             file.write("EXPOSE 8080\n")
             file.write('CMD ["gunicorn", "-b", "0.0.0.0:8080", "api:app"]\n')
             

src/praisonai/praisonai/standardise/ai_generator.py

@@ -358,6 +358,69 @@ class AIGenerator:
                 pass
         return self._fast_context_handler
     
+    def _detect_feature_capabilities(self, slug_str: str, source_info: Dict[str, Any]) -> Dict[str, Any]:
+        """Detect feature capabilities from source analysis."""
+        caps = {
+            "supports_bool": True,
+            "supports_list": False,
+            "supports_dict": False,
+            "supports_presets": [],
+            "supports_url": False,
+            "usage_forms": [],
+            "decorator": None,
+            "built_in_items": [],
+        }
+        
+        # Feature-specific detection based on slug
+        if slug_str == "tools":
+            caps["supports_list"] = True
+            caps["supports_bool"] = False
+            caps["decorator"] = "@tool"
+            caps["built_in_items"] = ["duckduckgo", "wikipedia_tools", "read_file", "execute_command"]
+            caps["usage_forms"] = [
+                "- List of tools: `tools=[my_func, another_func]`",
+                "- Using @tool decorator to create custom tools",
+                "- Using built-in tools: duckduckgo, wikipedia_tools, etc.",
+            ]
+        elif slug_str == "memory":
+            caps["supports_dict"] = True
+            caps["supports_presets"] = ["sqlite", "redis", "postgres", "qdrant", "chroma"]
+            caps["supports_url"] = True
+            caps["usage_forms"] = [
+                "- Boolean: `memory=True`",
+                "- Preset: `memory=\"sqlite\"` or `memory=\"redis\"`",
+                "- URL: `memory=\"redis://localhost:6379\"`",
+                "- Dict: `memory={\"provider\": \"qdrant\"}`",
+            ]
+        elif slug_str == "knowledge":
+            caps["supports_dict"] = True
+            caps["supports_list"] = True
+            caps["usage_forms"] = [
+                "- Boolean: `knowledge=True`",
+                "- List of sources: `knowledge=[\"file.pdf\", \"doc.txt\"]`",
+                "- Dict config: `knowledge={\"sources\": [...]}`",
+            ]
+        elif slug_str == "guardrails":
+            caps["supports_list"] = True
+            caps["decorator"] = "guardrail function"
+            caps["usage_forms"] = [
+                "- Boolean: `guardrails=True`",
+                "- List of functions: `guardrails=[my_guardrail_func]`",
+                "- Custom guardrail function returning GuardrailResult",
+            ]
+        elif slug_str == "streaming":
+            caps["supports_bool"] = True
+            caps["usage_forms"] = [
+                "- Boolean: `output=\"stream\"` or iterate over agent.start()",
+                "- Streaming with callbacks",
+            ]
+        else:
+            # Generic detection from source
+            caps["usage_forms"] = [f"- Boolean: `{slug_str}=True`"]
+        
+        logger.debug(f"Feature '{slug_str}' capabilities: {caps}")
+        return caps
+    
     def _get_agent(self):
         """Lazy-load the generation agent."""
         if self._agent is None:
@@ -591,14 +654,19 @@ ISSUES: List any issues found (or "None")
         context = {}
         slug_str = slug.normalised
         
+        logger.debug(f"Gathering context for feature '{slug_str}', artifact '{artifact_type.value}'")
+        
         # Use FastContext to find relevant code in SDK
         fast_context = self._get_fast_context_handler()
         if fast_context and self.sdk_root:
+            logger.debug(f"FastContext available, searching in {self.sdk_root}")
             try:
                 # Search for feature-related code
                 query = f"Find {slug_str} implementation, usage examples, and API"
                 matches = fast_context.search_context(query, str(self.sdk_root), use_llm_keywords=False)
                 
+                logger.debug(f"FastContext found {len(matches)} matches for '{query}'")
+                
                 # Read matched files
                 for match in matches[:3]:
                     file_path = self.sdk_root / match.get('file', '')
@@ -606,10 +674,11 @@ ISSUES: List any issues found (or "None")
                         try:
                             content = file_path.read_text(encoding="utf-8")[:2000]
                             context[f"sdk_{file_path.stem}"] = content
+                            logger.debug(f"Added SDK context: {file_path.name} ({len(content)} chars)")
                         except Exception:
                             pass
-            except Exception:
-                pass
+            except Exception as e:
+                logger.debug(f"FastContext search failed: {e}")
         
         # Get SDK module info (fallback)
         if self.sdk_root and not context:
@@ -653,6 +722,7 @@ ISSUES: List any issues found (or "None")
                 if doc_path.exists():
                     context[f"existing_{doc_type}"] = doc_path.read_text(encoding="utf-8")[:2000]
         
+        logger.debug(f"Context gathered for '{slug_str}': {list(context.keys())}")
         return context
     
     def _read_sdk_module(self, sdk_path: Path) -> str:
@@ -866,17 +936,26 @@ print(result)
             "",
         ]
         
-        # Add usage forms guidance (common patterns for all features)
-        param_name = slug_str.replace("-", "_")
-        prompt_parts.extend([
-            "## USAGE FORMS TO DEMONSTRATE (MUST cover ALL these progressively):",
-            f"- Boolean: `{param_name}=True` - Enable with defaults",
-            f"- String preset: `{param_name}=\"sqlite\"` or `{param_name}=\"redis\"` - Use predefined backend",
-            f"- URL: `{param_name}=\"redis://localhost:6379\"` - Backend-specific connection",
-            f"- Dict config: `{param_name}={{\"backend\": \"postgres\", \"user_id\": \"u1\"}}` - Custom config",
-            f"- Array + overrides: `{param_name}=[\"redis\", {{\"user_id\": \"u1\"}}]` - Preset + customization",
-            "",
-        ])
+        # Get dynamic feature capabilities - NO hardcoded usage forms
+        capabilities = self._detect_feature_capabilities(slug_str, source_info)
+        
+        # Add ONLY the usage forms this feature actually supports
+        prompt_parts.append("## USAGE FORMS TO DEMONSTRATE (cover these progressively):")
+        for usage_form in capabilities["usage_forms"]:
+            prompt_parts.append(usage_form)
+        
+        # Add decorator info if applicable
+        if capabilities.get("decorator"):
+            prompt_parts.append(f"- MUST demonstrate the {capabilities['decorator']} pattern")
+        
+        # Add built-in items if applicable
+        if capabilities.get("built_in_items"):
+            items = ", ".join(capabilities["built_in_items"][:4])
+            prompt_parts.append(f"- Built-in options to show: {items}")
+        
+        prompt_parts.append("")
+        
+        logger.debug(f"Feature '{slug_str}' usage forms: {capabilities['usage_forms']}")
         
         # Add dynamically extracted parameters if available
         main_class = source_info.get("main_class")

src/praisonai/praisonai/version.py

@@ -1 +1 @@
-__version__ = "3.7.3"
+__version__ = "3.7.4"