Release v3.10.24

Pr 1099 fix

.env.example

@@ -1,52 +0,0 @@
-# PraisonAI Environment Variables
-# Copy this file to .env and update with your actual values
-
-# === Required ===
-OPENAI_API_KEY=sk-...          # OpenAI key for LLM calls. Get yours at https://platform.openai.com
-
-# === Required for Claw web-search tool ===
-TAVILY_API_KEY=tvly-...        # Get yours at https://app.tavily.com (free tier available)
-
-# === Optional: Claw dashboard security ===
-PRAISONAI_ALLOW_LOCAL_TOOLS=0  # Set to 1 to enable local shell tools (security risk)
-
-# === Optional: Alternative LLM Providers ===
-ANTHROPIC_API_KEY=sk-ant-...   # Anthropic Claude models
-GOOGLE_API_KEY=...             # Google Gemini models  
-GROQ_API_KEY=gsk_...           # Groq (fast inference)
-COHERE_API_KEY=...             # Cohere models
-AZURE_OPENAI_API_KEY=...       # Azure OpenAI
-AZURE_OPENAI_ENDPOINT=...      # Azure OpenAI endpoint
-EVOLINK_API_KEY=...            # EvoLink.AI OpenAI-compatible models. Get yours at https://evolink.ai/dashboard/keys
-
-# === Optional: Memory backends ===
-MEM0_API_KEY=...               # Mem0 memory service
-REDIS_URL=redis://localhost:6379  # Redis for state management
-
-# === Optional: Observability ===
-LANGFUSE_SECRET_KEY=sk-lf-...  # Langfuse tracing
-LANGFUSE_PUBLIC_KEY=pk-lf-...  # Langfuse public key
-
-# === Optional: Bot platforms ===
-TELEGRAM_BOT_TOKEN=...         # Telegram bot token
-DISCORD_BOT_TOKEN=...          # Discord bot token  
-SLACK_BOT_TOKEN=xoxb-...       # Slack bot token
-SLACK_APP_TOKEN=xapp-...       # Slack app token
-WHATSAPP_ACCESS_TOKEN=...      # WhatsApp bot access token
-WHATSAPP_PHONE_NUMBER_ID=...   # WhatsApp phone number ID
-
-# === Optional: Database ===
-DATABASE_URL=sqlite:///~/.praison/database.sqlite  # Database connection string
-
-# === Optional: Tool Security ===
-# ALLOWED_TOOLS=search,send_message       # Whitelist specific tools to prevent name collisions
-                                        # Useful in multi-environment setups with overlapping tool names
-                                        # Leave unset to use all tools (with collision warnings)
-                                        # Do NOT set to empty string: that's treated as configuration error
-                                        # In CI, unknown tool names in the whitelist cause strict startup failure
-# HERMES_ONLY_TOOLS=search,send_message  # (Deprecated) Backward compatibility alias for ALLOWED_TOOLS
-
-# === Optional: Development ===
-LOGLEVEL=INFO                  # Logging level (DEBUG, INFO, WARNING, ERROR)
-CHAINLIT_AUTH_SECRET=...       # Chainlit authentication secret
-DEBUG=false                    # Enable debug mode

.github/ISSUE_TEMPLATE/bug_report.md

@@ -6,11 +6,6 @@ labels: bug
 assignees: ''
 ---
 
-## SDK / package
-- [ ] Python (`pip install praisonai` / `praisonaiagents`)
-- [ ] TypeScript / JavaScript (`npm install praisonai`) — fixes in `src/praisonai-ts/`
-- [ ] Cross-language / parity (file here on PraisonAI)
-
 ## Environment
 - Provider (select one):
   - [ ] Anthropic
@@ -19,7 +14,6 @@ assignees: ''
   - [ ] AWS Bedrock
   - [ ] Other: <!-- specify -->
 - PraisonAI version: <!-- if known -->
-- Node.js version (TS/JS only): <!-- e.g. 20.x -->
 - Operating System: <!-- e.g. macOS 14.3, Windows 11, Ubuntu 22.04 -->
 
 ## Full Code
@@ -37,4 +31,4 @@ assignees: ''
 <!-- What actually happened -->
 
 ## Additional Context
-<!-- Add any other context about the problem here, such as screenshots, logs, etc. -->
+<!-- Add any other context about the problem here, such as screenshots, logs, etc. --> 

.github/actions/claude-code-action/action.yml

@@ -5,9 +5,6 @@ inputs:
   anthropic_api_key:
     description: "Anthropic API key"
     required: false
-  claude_code_oauth_token:
-    description: "Claude Code OAuth Token for Claude Pro"
-    required: false
   github_token:
     description: "GitHub token for Claude to operate with"
     required: false
@@ -70,8 +67,6 @@ runs:
 
     - name: Install GitHub MCP Server
       shell: bash
-      env:
-        INPUT_GITHUB_TOKEN: ${{ inputs.github_token }}
       run: |
         claude mcp add-json github '{
           "command": "docker",
@@ -84,7 +79,7 @@ runs:
             "ghcr.io/github/github-mcp-server:sha-ff3036d"
           ],
           "env": {
-            "GITHUB_PERSONAL_ACCESS_TOKEN": "'"${INPUT_GITHUB_TOKEN}"'"
+            "GITHUB_PERSONAL_ACCESS_TOKEN": "${{ inputs.github_token }}"
           }
         }'
 
@@ -209,48 +204,14 @@ runs:
         User Request:
         $USER_REQUEST
         
-        Please analyze the request and provide helpful assistance.
-
-        CRITICAL INSTRUCTION: If your task involves modifying codebase files to add a feature or fix a bug:
-
-        STEP 0 — SETUP GIT IDENTITY:
-        git config user.name "MervinPraison"
-        git config user.email "[email protected]"
-
-        STEP 1 — READ GUIDELINES:
-        MANDATORY: Before writing any code, you MUST carefully read "src/praisonai-agents/AGENTS.md" to understand this repository's extremely specific Architecture, Protocol-First design rules, and Agent-Centric Philosophy.
-
-        STEP 2 — ARCHITECTURE VALIDATION & ROUTING (MANDATORY before writing code):
-        Before implementing anything, answer these questions:
-        - CORE vs WRAPPER vs TOOLS vs PLUGINS ROUTING:
-          1. Core SDK (praisonaiagents/): Only core protocols, base classes, decorators. No heavy implementations.
-          2. Wrapper (praisonai/): CLI, heavy implementations, optional dependencies.
-          3. Tools → MervinPraison/PraisonAI-Tools: agent-callable integrations at runtime (Composio, Slack, APIs). Do NOT add to praisonaiagents/.
-          4. Plugins → MervinPraison/PraisonAI-Plugins: lifecycle extensions (tracing, logging, hooks, guardrails). Not agent tools.
-          5. Sandbox backends → PraisonAI-Plugins via `praisonai.sandbox` entry point (core protocol only).
-          6. TypeScript SDK → src/praisonai-ts/ in this monorepo (read src/praisonai-ts/AGENTS.md for TS rules).
-        - Does it duplicate existing functionality? Check if Agent already supports this via existing params (reflection, planning, tools, hooks, memory).
-        - Do not bloat the Agent class with additional params — only if absolutely required; we already support many params.
-        - Does it inherit from Agent properly? New agent types MUST inherit Agent, not wrap it with composition.
-        - Does it add new dependencies? Only optional deps allowed, must be lazy-imported.
-        - Will agent.py grow larger? If the change adds >50 lines to agent.py, find a way to extract instead. PRs with >100 lines added to agent.py require manual review (merge gate will not auto-merge).
-        - Is there a name collision with existing exports in __init__.py?
-        If ANY of these conceptual checks fail (excluding routing), add a comment to the issue explaining why and close it. Do NOT create a PR.
-
-        STEP 3 — IMPLEMENT:
-        - Create a new git branch appropriately named (e.g. \`feature/issue-<number>\`)
-        - Follow protocol-driven design: protocols in core SDK, heavy implementations in wrapper
-        - Keep changes small and backward-compatible
-
-        STEP 4 — TEST:
-        - Run: cd src/praisonai-agents && PYTHONPATH=. python -m pytest tests/ -x -q --timeout=30
-        - Ensure no regressions
-
-        STEP 5 — CREATE PR:
-        - Commit with descriptive message, push the branch
-        - Use the GitHub CLI (\`gh pr create --title "..." --body "Fixes #<number>"\`) to open a Pull Request
-        CRITICAL: You MUST create the PR automatically using \`gh pr create\`. Do NOT just provide a link.
-
+        Please analyze the request and provide helpful assistance. You have access to repository tools and can help with:
+        - Code analysis and implementation
+        - GitHub workflows and automation
+        - Pull request reviews and feedback
+        - Issue resolution and bug fixes
+        - Documentation updates
+        - Testing and deployment
+        
         Respond naturally and helpfully to the user's request using the available tools.
         EOF
         
@@ -260,75 +221,36 @@ runs:
     - name: Run Claude Code
       if: env.SKIP_EXECUTION != 'true'
       shell: bash
-      env:
-        ANTHROPIC_API_KEY: ${{ inputs.anthropic_api_key }}
-        CLAUDE_CODE_OAUTH_TOKEN: ${{ inputs.claude_code_oauth_token }}
-        GITHUB_TOKEN: ${{ inputs.github_token }}
-        INPUT_MODEL: ${{ inputs.model }}
-        INPUT_MAX_TURNS: ${{ inputs.max_turns }}
-        INPUT_ALLOWED_TOOLS: ${{ inputs.allowed_tools }}
-        INPUT_DISALLOWED_TOOLS: ${{ inputs.disallowed_tools }}
-        INPUT_TIMEOUT_MINUTES: ${{ inputs.timeout_minutes }}
-        CLAUDE_CODE_SUBAGENT_MODEL: inherit
-        ANTHROPIC_DEFAULT_SONNET_MODEL: claude-sonnet-4-6
       run: |
         echo "🚀 Running Claude Code with GitHub context..."
         
         # Build command arguments
         CMD_ARGS=("-p" "--verbose" "--output-format" "stream-json")
         
-        if [[ -n "$INPUT_MODEL" ]]; then
-          CMD_ARGS+=("--model" "$INPUT_MODEL")
-          export ANTHROPIC_MODEL="$INPUT_MODEL"
-        fi
-        
         # Add max turns if specified
-        if [[ -n "$INPUT_MAX_TURNS" ]]; then
-          CMD_ARGS+=("--max-turns" "$INPUT_MAX_TURNS")
+        if [[ -n "${{ inputs.max_turns }}" ]]; then
+          CMD_ARGS+=("--max-turns" "${{ inputs.max_turns }}")
         fi
         
         # Add allowed tools (include GitHub tools by default)
-        TOOLS="mcp__github__get_issue,mcp__github__get_issue_comments,mcp__github__update_issue,mcp__github__search_issues,mcp__github__list_issues,mcp__github__add_issue_comment,mcp__github__get_pull_request,mcp__github__get_pull_request_files,mcp__github__get_pull_request_reviews,mcp__github__get_pull_request_status,Read,Write,Edit,Bash"
-        if [[ -n "$INPUT_ALLOWED_TOOLS" ]]; then
-          TOOLS="$TOOLS,$INPUT_ALLOWED_TOOLS"
-        fi
-        
-        # Remove any explicitly disallowed tools from the effective allow-list so
-        # the read-only contract is enforced deterministically (no reliance on CLI
-        # precedence between --allowedTools and --disallowedTools).
-        if [[ -n "$INPUT_DISALLOWED_TOOLS" ]]; then
-          DISALLOWED_CSV=$(echo "$INPUT_DISALLOWED_TOOLS" | tr ',\n' '  ' | xargs)
-          FILTERED=""
-          IFS=',' read -ra TOOL_ARR <<< "$TOOLS"
-          for tool in "${TOOL_ARR[@]}"; do
-            tool=$(echo "$tool" | xargs)
-            [[ -z "$tool" ]] && continue
-            skip="false"
-            for bad in $DISALLOWED_CSV; do
-              if [[ "$tool" == "$bad" ]]; then
-                skip="true"
-                break
-              fi
-            done
-            if [[ "$skip" == "false" ]]; then
-              FILTERED="${FILTERED:+$FILTERED,}$tool"
-            fi
-          done
-          TOOLS="$FILTERED"
+        TOOLS="mcp__github__get_issue,mcp__github__get_issue_comments,mcp__github__update_issue,mcp__github__search_issues,mcp__github__list_issues,mcp__github__create_comment,Read,Write,Edit,Bash"
+        if [[ -n "${{ inputs.allowed_tools }}" ]]; then
+          TOOLS="$TOOLS,${{ inputs.allowed_tools }}"
         fi
         CMD_ARGS+=("--allowedTools" "$TOOLS")
         
         # Add disallowed tools
-        if [[ -n "$INPUT_DISALLOWED_TOOLS" ]]; then
-          DISALLOWED_FLAG=$(echo "$INPUT_DISALLOWED_TOOLS" | tr '\n' ',' | sed 's/,*$//')
-          CMD_ARGS+=("--disallowedTools" "$DISALLOWED_FLAG")
+        if [[ -n "${{ inputs.disallowed_tools }}" ]]; then
+          CMD_ARGS+=("--disallowedTools" "${{ inputs.disallowed_tools }}")
         fi
         
         echo "📝 Executing Claude Code with prompt from file..."
         
         # Execute Claude Code with timeout, using stdin for the prompt
-        TIMEOUT_SECONDS=$(($INPUT_TIMEOUT_MINUTES * 60))
-        timeout $TIMEOUT_SECONDS claude "${CMD_ARGS[@]}" < "$PROMPT_FILE" \
-          | tee "$GITHUB_WORKSPACE/.claude-assess-output.jsonl"
+        TIMEOUT_SECONDS=$((${{ inputs.timeout_minutes }} * 60))
+        timeout $TIMEOUT_SECONDS claude "${CMD_ARGS[@]}" < "${{ env.PROMPT_FILE }}"
         
-        echo "✅ Claude Code execution completed" 
+        echo "✅ Claude Code execution completed"
+      env:
+        ANTHROPIC_API_KEY: ${{ inputs.anthropic_api_key }}
+        GITHUB_TOKEN: ${{ inputs.github_token }} 

.github/actions/claude-issue-triage-action/action.yml

@@ -6,8 +6,8 @@ inputs:
     description: "Timeout in minutes for execution"
     required: false
     default: "5"
-  claude_code_oauth_token:
-    description: "Claude Code OAuth token for Pro subscription access"
+  anthropic_api_key:
+    description: "Anthropic API key"
     required: true
   github_token:
     description: "GitHub token with repo and issues permissions"
@@ -19,11 +19,9 @@ runs:
     - name: Checkout repository code
       uses: actions/checkout@v4
       with:
-        persist-credentials: false
         fetch-depth: 0
 
-    - name: Create prompt
-      id: generate_prompt
+    - name: Create prompt file
       shell: bash
       run: |
         mkdir -p /tmp/claude-prompts
@@ -77,16 +75,13 @@ runs:
         - Your ONLY action should be to apply labels using mcp__github__update_issue
         - It's okay to not add any labels if none are clearly applicable
         EOF
-        
-        echo "PROMPT<<DELIMITER" >> $GITHUB_OUTPUT
-        cat /tmp/claude-prompts/claude-issue-triage-prompt.txt >> $GITHUB_OUTPUT
-        echo "DELIMITER" >> $GITHUB_OUTPUT
 
     - name: Run Claude Code
       uses: ./.github/actions/claude-code-action
       with:
-        direct_prompt: ${{ steps.generate_prompt.outputs.PROMPT }}
+        prompt_file: /tmp/claude-prompts/claude-issue-triage-prompt.txt
         allowed_tools: "Bash(gh label list),mcp__github__get_issue,mcp__github__get_issue_comments,mcp__github__update_issue,mcp__github__search_issues,mcp__github__list_issues"
+        install_github_mcp: "true"
         timeout_minutes: ${{ inputs.timeout_minutes }}
-        claude_code_oauth_token: ${{ inputs.claude_code_oauth_token }}
+        anthropic_api_key: ${{ inputs.anthropic_api_key }}
         github_token: ${{ inputs.github_token }} 

.github/actions/gemini/action.yml

@@ -22,12 +22,6 @@ inputs:
       To enable observability with Google Cloud, include:
       {"telemetry": {"enabled": true, "target": "gcp"}, "sandbox": false}
     required: false
-  model:
-    description: |
-      The Gemini model to use. Options: gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite.
-      Use flash-lite for highest free-tier quota (1,000 RPD).
-    required: false
-    default: 'gemini-3.1-flash-lite-preview'
   version:
     description: |
       The version of @google/gemini-cli to execute.
@@ -57,15 +51,13 @@ runs:
 
     - name: Install Gemini CLI
       id: install
-      env:
-        INPUT_VERSION: ${{ inputs.version }}
       run: |
-        if [[ "$INPUT_VERSION" == "latest" || "$INPUT_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9\.-]+)?(\+[a-zA-Z0-9\.-]+)?$ ]]; then
-          echo "Installing Gemini CLI from npm: @google/gemini-cli@$INPUT_VERSION"
-          npm install -g @google/gemini-cli@$INPUT_VERSION
+        if [[ "${{ inputs.version }}" == "latest" || "${{ inputs.version }}" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9\.-]+)?(\+[a-zA-Z0-9\.-]+)?$ ]]; then
+          echo "Installing Gemini CLI from npm: @google/gemini-cli@${{ inputs.version }}"
+          npm install -g @google/gemini-cli@${{ inputs.version }}
         else
-          echo "Installing Gemini CLI from GitHub: github:google-gemini/gemini-cli#$INPUT_VERSION"
-          npm install -g github:google-gemini/gemini-cli#$INPUT_VERSION
+          echo "Installing Gemini CLI from GitHub: github:google-gemini/gemini-cli#${{ inputs.version }}"
+          npm install -g github:google-gemini/gemini-cli#${{ inputs.version }}
         fi
         echo "Verifying installation:"
         if command -v gemini >/dev/null 2>&1; then
@@ -78,11 +70,10 @@ runs:
 
     - name: Run Gemini CLI
       run: |
-        gemini --yolo --model "$GEMINI_MODEL" --prompt "$PROMPT"
+        gemini --yolo --prompt "$PROMPT"
       shell: bash
       env:
         GEMINI_API_KEY: ${{ inputs.GEMINI_API_KEY }}
-        GEMINI_MODEL: ${{ inputs.model }}
         PROMPT: ${{ inputs.prompt }}
 
 branding:

.github/actions/install-monorepo-packages/action.yml

@@ -1,96 +0,0 @@
-name: Install PraisonAI monorepo packages
-description: Install praisonai-agents, praisonai-code, praisonai-bot, praisonai-train, praisonai-browser, praisonai-mcp, praisonai-sandbox, praisonai-deploy, and praisonai wrapper from local paths (mirrors PyPI nine-package install order).
-
-inputs:
-  repo-root:
-    description: Path prefix to monorepo root (e.g. PraisonAI/ for cross-repo checkout)
-    required: false
-    default: ""
-  use-uv:
-    description: Use uv pip instead of pip
-    required: false
-    default: "false"
-  agents-extras:
-    description: Optional extras for praisonaiagents (e.g. .[all] or [all])
-    required: false
-    default: ""
-  wrapper-extras:
-    description: Optional extras for praisonai wrapper (e.g. .[chat,code] or [chat,code])
-    required: false
-    default: ""
-
-runs:
-  using: composite
-  steps:
-    - name: Install monorepo packages
-      shell: bash
-      run: |
-        set -euo pipefail
-        WORKSPACE="${GITHUB_WORKSPACE:-$(pwd)}"
-        ROOT="${{ inputs.repo-root }}"
-        if [ -n "$ROOT" ]; then
-          BASE="${WORKSPACE%/}/${ROOT%/}/"
-        else
-          BASE="${WORKSPACE%/}/"
-        fi
-        AGENTS_PKG="${BASE}src/praisonai-agents"
-        CODE_PKG="${BASE}src/praisonai-code"
-        BOT_PKG="${BASE}src/praisonai-bot"
-        TRAIN_PKG="${BASE}src/praisonai-train"
-        BROWSER_PKG="${BASE}src/praisonai-browser"
-        MCP_PKG="${BASE}src/praisonai-mcp"
-        SANDBOX_PKG="${BASE}src/praisonai-sandbox"
-        DEPLOY_PKG="${BASE}src/praisonai-deploy"
-        WRAPPER_PKG="${BASE}src/praisonai"
-
-        normalise_extras() {
-          local value="${1#.}"
-          if [ -n "$value" ]; then
-            printf '.%s' "$value"
-          else
-            printf '.'
-          fi
-        }
-
-        AGENTS_SUFFIX="$(normalise_extras "${{ inputs.agents-extras }}")"
-        WRAPPER_SUFFIX="$(normalise_extras "${{ inputs.wrapper-extras }}")"
-
-        if [ "${{ inputs.use-uv }}" = "true" ]; then
-          cd "$AGENTS_PKG"
-          uv pip install --system -e "${AGENTS_SUFFIX}"
-          cd "$CODE_PKG"
-          uv pip install --system -e .
-          cd "$BOT_PKG"
-          uv pip install --system -e .
-          cd "$TRAIN_PKG"
-          uv pip install --system -e .
-          cd "$BROWSER_PKG"
-          uv pip install --system -e .
-          cd "$MCP_PKG"
-          uv pip install --system -e .
-          cd "$SANDBOX_PKG"
-          uv pip install --system -e .
-          cd "$DEPLOY_PKG"
-          uv pip install --system -e .
-          cd "$WRAPPER_PKG"
-          uv pip install --system "${WRAPPER_SUFFIX}"
-        else
-          cd "$AGENTS_PKG"
-          pip install -e "${AGENTS_SUFFIX}"
-          cd "$CODE_PKG"
-          pip install -e .
-          cd "$BOT_PKG"
-          pip install -e .
-          cd "$TRAIN_PKG"
-          pip install -e .
-          cd "$BROWSER_PKG"
-          pip install -e .
-          cd "$MCP_PKG"
-          pip install -e .
-          cd "$SANDBOX_PKG"
-          pip install -e .
-          cd "$DEPLOY_PKG"
-          pip install -e .
-          cd "$WRAPPER_PKG"
-          pip install -e "${WRAPPER_SUFFIX}"
-        fi

.github/praisonai-issue-triage.yaml

@@ -1,80 +0,0 @@
-framework: "praisonai"
-process: workflow
-topic: "Autonomous Issue Resolution"
-planning: false
-
-roles:
-  issue_analyst:
-    role: "GitHub Issue Analyst"
-    goal: "Read the GitHub issue, understand the required changes, and map the problem to the local codebase"
-    backstory: "You are an expert software analyst who reads bug reports and feature requests. You excel at taking a problem description and finding exactly which files in the codebase need to be modified. Your primary job is discovery and planning."
-    tools:
-      - "execute_command"
-
-  software_engineer:
-    role: "Autonomous Software Engineer"
-    goal: "Implement required code changes on a branch, run tests, commit, and push"
-    backstory: "You are a senior software engineer. You always branch first, implement changes using shell commands, verify with git diff, run tests, then commit and push. You never create a Pull Request unless the issue body explicitly requests one."
-    tools:
-      - "execute_command"
-      - "github_create_branch"
-      - "github_commit_and_push"
-      - "github_create_pull_request"
-
-steps:
-  - name: Analyze Issue
-    agent: issue_analyst
-    action: >
-      Thoroughly analyze the issue and the repository. Follow these steps in order.
-
-      First, set up git identity: execute_command 'git config user.name PraisonAI' then
-      execute_command 'git config user.email [email protected]'. Do NOT pass cwd.
-
-      Second, read the issue: execute_command 'cat .github/triage-context.md'. Do NOT pass cwd.
-
-      Third, read architecture guidelines: execute_command 'cat src/praisonai-agents/AGENTS.md'.
-      If the issue is TypeScript/JavaScript SDK, also execute_command 'cat src/praisonai-ts/AGENTS.md'.
-
-      Fourth, decide routing before planning:
-      - TypeScript/JavaScript SDK → src/praisonai-ts/ in this monorepo (read src/praisonai-ts/AGENTS.md).
-      - Tools → PraisonAI-Tools: agent-callable integrations at runtime (Composio, Slack, APIs).
-      - Plugins → PraisonAI-Plugins: lifecycle extensions (tracing, logging, hooks, guardrails).
-      - Sandbox backends → PraisonAI-Plugins via `praisonai.sandbox` entry point.
-      Core SDK/wrapper for Python protocols and CLI; external repos for Tools/Plugins/Docs only.
-
-      Fifth, decide if this issue requires code changes:
-      - If YES: identify the exact files and lines that must change. Output a concrete file-level plan.
-      - If NO (question, discussion, duplicate, invalid): say so clearly. No code changes needed.
-
-      Output: routing decision (Core / Wrapper / TS-monorepo / Tools-external / Plugins-external / No-change), validation result, and exact files/lines to change.
-    expected_output: A decision on whether code changes are needed, and if so a concrete file-level plan.
-
-  - name: Implement Fix
-    agent: software_engineer
-    action: >
-      You are working inside the repository at /Users/praison/praisonai-package.
-      Do NOT ask for confirmation. Do NOT use placeholder paths. Act immediately.
-
-      Read the analyst's output first. If the analyst said NO code changes are needed, stop here and
-      output a brief explanation — do NOT create a branch or PR.
-
-      If code changes ARE needed, follow these steps:
-
-      Step 1 — Create branch: github_create_branch with branch_name=praisonai/issue-{{ISSUE_NUMBER}}.
-
-      Step 2 — Implement changes using execute_command (no cwd argument).
-      To insert a line: python3 -c "lines=open('FILE').readlines(); lines.insert(N,'LINE\n'); open('FILE','w').writelines(lines)"
-      To replace text: python3 -c "t=open('FILE').read(); open('FILE','w').write(t.replace('OLD','NEW'))"
-      After each edit verify: execute_command 'git diff'
-
-      Step 3 — Run tests: execute_command 'python3 -m pytest src/praisonai-agents/tests/ -x -q --timeout=30 -p no:warnings'
-
-      Step 4 — Commit and push: github_commit_and_push with a descriptive commit_message.
-
-      Step 5 — Check if the issue body EXPLICITLY contains the phrase "create pull request" or "create PR"
-      (case-insensitive). ONLY in that case create a PR using github_create_pull_request with
-      title='fix: resolve issue #{{ISSUE_NUMBER}}',
-      body='Fixes #{{ISSUE_NUMBER}}.\n\nAutonomously resolved by PraisonAI.',
-      head_branch=praisonai/issue-{{ISSUE_NUMBER}}, base_branch=main.
-      Otherwise do NOT create a PR — just confirm the branch was pushed successfully.
-    expected_output: Either "No code changes needed", or "Branch pushed, no PR requested", or "Branch pushed and PR created at URL".

.github/praisonai-reviewer.yaml

@@ -1,116 +0,0 @@
-framework: "praisonai"
-topic: "Pull Request Code Review Analysis"
-
-roles:
-  security_reviewer:
-    role: "Security Code Reviewer"
-    goal: "Identify security vulnerabilities, authentication issues, input validation problems, and unsafe code practices in the PR changes"
-    backstory: "You are a cybersecurity expert specializing in code analysis. You have extensive experience in identifying common security flaws like injection attacks, authentication bypasses, exposed secrets, and unsafe data handling patterns."
-    tools:
-      - "execute_command"
-    
-  performance_reviewer:
-    role: "Performance Code Reviewer" 
-    goal: "Analyze code changes for performance implications, identify bottlenecks, inefficient algorithms, and resource usage issues"
-    backstory: "You are a performance optimization specialist with deep knowledge of algorithm efficiency, memory management, and system performance. You excel at spotting code that could cause performance degradation."
-    tools:
-      - "execute_command"
-      
-  maintainability_reviewer:
-    role: "Code Quality & Maintainability Reviewer"
-    goal: "Evaluate code structure, readability, documentation, naming conventions, and adherence to best practices"
-    backstory: "You are a software engineering expert focused on code quality and maintainability. You ensure code follows established patterns, is well-documented, and will be easy for future developers to understand and modify."
-    tools:
-      - "execute_command"
-
-  lead_reviewer:
-    role: "Lead Technical Reviewer"
-    goal: "Synthesize all review feedback, make final recommendations, and post comprehensive review comments to the GitHub PR"
-    backstory: "You are a senior technical lead responsible for final review decisions. You coordinate input from security, performance, and maintainability reviewers to provide balanced, actionable feedback to the development team."
-    tools:
-      - "execute_command"
-
-steps:
-  - name: security_analysis
-    agent: security_reviewer
-    action: |
-      Analyze the PR diff for security issues:
-      1. Extract PR details: `echo "$PR_DATA"`
-      2. Get changed files: `echo "$CHANGED_FILES"`  
-      3. Review full diff: `gh pr diff ${PR_NUMBER}`
-      4. Look for:
-         - Hardcoded secrets, API keys, passwords
-         - SQL injection vulnerabilities
-         - XSS vulnerabilities  
-         - Authentication/authorization bypasses
-         - Unsafe file operations
-         - Command injection risks
-         - Missing input validation
-         - Exposed sensitive data
-      5. Document findings with file paths and line numbers
-    expected_output: "Detailed security analysis report with specific vulnerabilities found, severity levels, and remediation suggestions"
-    
-  - name: performance_analysis
-    agent: performance_reviewer
-    action: |
-      Analyze the PR diff for performance issues:
-      1. Review algorithm complexity changes
-      2. Check for inefficient database queries
-      3. Identify memory leaks or excessive allocations
-      4. Look for hot-path regressions
-      5. Check for blocking I/O operations
-      6. Analyze module-level imports that could slow startup
-      7. Review caching implementations
-      8. Check for recursive operations without termination
-      9. Document performance concerns with impact estimates
-    expected_output: "Performance analysis report highlighting bottlenecks, efficiency concerns, and optimization recommendations"
-    
-  - name: maintainability_analysis
-    agent: maintainability_reviewer
-    action: |
-      Analyze the PR diff for code quality and maintainability:
-      1. Check naming conventions consistency
-      2. Evaluate code structure and organization
-      3. Review documentation completeness
-      4. Check for DRY violations
-      5. Analyze error handling patterns
-      6. Review test coverage for changes
-      7. Check adherence to repository coding standards
-      8. Evaluate API design consistency
-      9. Look for technical debt introduction
-    expected_output: "Code quality analysis with specific recommendations for improving maintainability and readability"
-    
-  - name: final_review
-    agent: lead_reviewer
-    action: |
-      Synthesize all reviews and post final comprehensive feedback:
-      1. Collect input from security, performance, and maintainability reviews
-      2. Prioritize findings by severity (Critical, High, Medium, Low)
-      3. Create structured review comment using this format:
-      
-      ## 📋 Review Summary
-      [2-3 sentence overview and assessment]
-      
-      ## 🔍 General Feedback  
-      [Overall patterns and observations]
-      
-      ## 🎯 Specific Feedback
-      ### 🔴 Critical (if any)
-      [Security vulnerabilities, breaking changes, major bugs]
-      
-      ### 🟡 High (if any) 
-      [Performance issues, design flaws, significant bugs]
-      
-      ### 🟢 Medium (if any)
-      [Code quality improvements, minor optimizations]
-      
-      ### 🔵 Low (if any)
-      [Documentation, naming suggestions, minor refactoring]
-      
-      ## ✅ Highlights (if any)
-      [Positive aspects worth mentioning]
-      
-      4. Post comprehensive review: `echo "[REVIEW_CONTENT]" | gh pr comment ${PR_NUMBER} -F -`
-      5. If critical issues found, suggest not merging until resolved
-    expected_output: "Final review comment posted to GitHub PR with comprehensive analysis from all reviewers"
-    dependencies: [security_analysis, performance_analysis, maintainability_analysis]

.github/scripts/bot-pr-review-chain-selftest.js

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-const chain = require('./bot-pr-review-chain.js');
-
-let failed = 0;
-function assert(name, cond) {
-  if (!cond) {
-    console.error('FAIL:', name);
-    failed++;
-  } else {
-    console.log('ok:', name);
-  }
-}
-
-assert('chainKickPosted requires both markers', chain.chainKickPosted([
-  { user: { login: 'MervinPraison' }, body: '@coderabbitai review' },
-  { user: { login: 'MervinPraison' }, body: '/review' },
-]));
-assert('chainKickPosted false with only coderabbit', !chain.chainKickPosted([
-  { user: { login: 'MervinPraison' }, body: '@coderabbitai review' },
-]));
-assert('coderabbitKickPosted detects coderabbit', chain.coderabbitKickPosted([
-  { user: { login: 'MervinPraison' }, body: '@coderabbitai review' },
-]));
-assert('qodoKickPosted detects qodo', chain.qodoKickPosted([
-  { user: { login: 'github-actions[bot]' }, body: '/review' },
-]));
-assert('ignores coderabbit bot comment', !chain.coderabbitKickPosted([
-  { user: { login: 'coderabbitai[bot]' }, body: '@coderabbitai review' },
-]));
-assert('bot PR author match', chain.isBotOpenedPr({ user: { login: 'praisonai-triage-agent[bot]' } }));
-assert('generic bot type match', chain.isBotOpenedPr({ user: { login: 'my-bot', type: 'Bot' } }));
-assert('human author excluded', !chain.isBotOpenedPr({ user: { login: 'MervinPraison', type: 'User' } }));
-
-process.exit(failed ? 1 : 0);

.github/scripts/bot-pr-review-chain.js

@@ -1,153 +0,0 @@
-/**
- * Idempotent CodeRabbit/Qodo kick for bot-opened PRs.
- * @see .github/workflows/auto-pr-comment.yml, claude.yml, bot-pr-recovery.yml
- */
-
-const KICK_AUTHORS = new Set(['MervinPraison', 'github-actions[bot]', 'praisonai-triage-agent[bot]']);
-const BOT_PR_AUTHORS = new Set(['praisonai-triage-agent[bot]', 'github-actions[bot]']);
-
-async function listAllComments(github, owner, repo, issueNumber) {
-  if (typeof github.paginate === 'function') {
-    return github.paginate(github.rest.issues.listComments, {
-      owner,
-      repo,
-      issue_number: issueNumber,
-      per_page: 100,
-    });
-  }
-  const { data } = await github.rest.issues.listComments({
-    owner,
-    repo,
-    issue_number: issueNumber,
-    per_page: 100,
-  });
-  return data;
-}
-
-function kickAuthored(comment, marker) {
-  return (
-    KICK_AUTHORS.has(comment.user?.login) &&
-    (comment.body || '').includes(marker)
-  );
-}
-
-function coderabbitKickPosted(comments) {
-  return comments.some((c) => kickAuthored(c, '@coderabbitai review'));
-}
-
-function qodoKickPosted(comments) {
-  return comments.some((c) => kickAuthored(c, '/review'));
-}
-
-function chainKickPosted(comments) {
-  return coderabbitKickPosted(comments) && qodoKickPosted(comments);
-}
-
-function isBotOpenedPr(pr) {
-  if (BOT_PR_AUTHORS.has(pr.user?.login)) return true;
-  return pr.user?.type === 'Bot';
-}
-
-async function kickReviewChain(github, owner, repo, prNumber, core, preFetchedComments = null) {
-  const comments = preFetchedComments || await listAllComments(github, owner, repo, prNumber);
-  const needCoderabbit = !coderabbitKickPosted(comments);
-  const needQodo = !qodoKickPosted(comments);
-
-  if (!needCoderabbit && !needQodo) {
-    core?.info?.(`Review chain already kicked on PR #${prNumber}`);
-    return { kicked: false, reason: 'already_kicked' };
-  }
-
-  if (needCoderabbit) {
-    await github.rest.issues.createComment({
-      owner,
-      repo,
-      issue_number: prNumber,
-      body: '@coderabbitai review',
-    });
-  }
-  if (needQodo) {
-    await github.rest.issues.createComment({
-      owner,
-      repo,
-      issue_number: prNumber,
-      body: '/review',
-    });
-  }
-  core?.info?.(`Kicked review chain for PR #${prNumber} (coderabbit=${needCoderabbit}, qodo=${needQodo})`);
-  return { kicked: true, coderabbit: needCoderabbit, qodo: needQodo };
-}
-
-async function findOpenPrForIssue(github, owner, repo, issueNumber) {
-  const prefix = `claude/issue-${issueNumber}-`;
-  const { data: prs } = await github.rest.pulls.list({
-    owner,
-    repo,
-    state: 'open',
-    sort: 'created',
-    direction: 'desc',
-    per_page: 30,
-  });
-  return (
-    prs.find(
-      (p) => (p.head?.ref || '').startsWith(prefix) && isBotOpenedPr(p)
-    ) || null
-  );
-}
-
-async function kickReviewChainForIssue(github, owner, repo, issueNumber, core) {
-  const pr = await findOpenPrForIssue(github, owner, repo, issueNumber);
-  if (!pr) {
-    core?.info?.(`No open PR for issue #${issueNumber}, skipping review kick`);
-    return { kicked: false, reason: 'no_pr' };
-  }
-  const result = await kickReviewChain(github, owner, repo, pr.number, core);
-  return { ...result, prNumber: pr.number };
-}
-
-async function recoverStalledBotPrs(github, owner, repo, options, core) {
-  const { prNumber = null, minAgeMs = 10 * 60 * 1000, maxRecover = 10 } = options || {};
-  let prs;
-  if (prNumber) {
-    const { data } = await github.rest.pulls.get({ owner, repo, pull_number: prNumber });
-    prs = [data];
-  } else if (typeof github.paginate === 'function') {
-    prs = await github.paginate(github.rest.pulls.list, {
-      owner,
-      repo,
-      state: 'open',
-      per_page: 100,
-    });
-  } else {
-    const { data } = await github.rest.pulls.list({ owner, repo, state: 'open', per_page: 100 });
-    prs = data;
-  }
-
-  const cutoff = Date.now() - minAgeMs;
-  let recovered = 0;
-  for (const pr of prs) {
-    if (recovered >= maxRecover) break;
-    if (!isBotOpenedPr(pr)) continue;
-    if (!prNumber && new Date(pr.created_at).getTime() > cutoff) continue;
-    const comments = await listAllComments(github, owner, repo, pr.number);
-    if (chainKickPosted(comments)) continue;
-    await kickReviewChain(github, owner, repo, pr.number, core, comments);
-    recovered += 1;
-  }
-  core?.info?.(`Recovery complete (${recovered} PR(s) kicked)`);
-  return recovered;
-}
-
-module.exports = {
-  KICK_AUTHORS,
-  BOT_PR_AUTHORS,
-  listAllComments,
-  chainKickPosted,
-  coderabbitKickPosted,
-  qodoKickPosted,
-  isBotOpenedPr,
-  kickReviewChain,
-  findOpenPrForIssue,
-  kickReviewChainForIssue,
-  recoverStalledBotPrs,
-};

.github/scripts/ci-failure-claude-selftest.js

@@ -1,93 +0,0 @@
-#!/usr/bin/env node
-/**
- * Run: node .github/scripts/ci-failure-claude-selftest.js
- */
-const ciFix = require('./ci-failure-claude.js');
-const mergeGate = require('./merge-gate.js');
-
-let failed = 0;
-function assert(name, cond) {
-  if (!cond) {
-    console.error('FAIL:', name);
-    failed += 1;
-  } else {
-    console.log('ok:', name);
-  }
-}
-
-const LOG_2767 = `
-test-core (cli)	UNKNOWN STEP	2026-07-07T17:21:49.8096670Z FAILED (0.0100s) tests/unit/cli/test_typer_cli.py::TestConfigCommand::test_config_list - ValueError: I/O operation on closed file.
-test-core (cli)	UNKNOWN STEP	2026-07-07T17:21:49.8097323Z ============= 1 failed, 1401 passed, 1 skipped in 88.86s (0:01:28) =============
-test-core (cli)	UNKNOWN STEP	2026-07-07T17:21:49.8693341Z ##[error]Process completed with exit code 1.
-`;
-
-const parsed = ciFix.parsePytestFailures(LOG_2767);
-assert('parses pytest failure from log', parsed.length === 1);
-assert(
-  'extracts test path',
-  parsed[0]?.testId === 'tests/unit/cli/test_typer_cli.py::TestConfigCommand::test_config_list'
-);
-assert(
-  'extracts error message',
-  parsed[0]?.error.includes('ValueError: I/O operation on closed file')
-);
-
-const comment = ciFix.buildCiFixComment({
-  headSha: 'dfb81bb0ae7f36bf8d66d8f45053464c18c005a3',
-  failedChecks: [
-    {
-      name: 'test-core (cli)',
-      workflow: 'Core Tests',
-      html_url: 'https://github.com/MervinPraison/PraisonAI/actions/runs/28885180173/job/85683605433',
-    },
-  ],
-  failureSummaries: [{ jobName: 'test-core (cli)', failures: parsed }],
-});
-assert('comment includes @claude', comment.includes('@claude'));
-assert('comment includes short sha', comment.includes('dfb81bb0'));
-assert('comment includes test path', comment.includes('test_typer_cli.py::TestConfigCommand::test_config_list'));
-assert('comment includes job url', comment.includes('85683605433'));
-assert('comment requires critical review verdict', comment.includes('Critical review first'));
-assert('comment forbids weakening tests', comment.includes('do not weaken, skip, or delete tests'));
-assert('comment mentions SDK guardrails', comment.includes('SDK guardrails'));
-assert('comment asks for legitimacy verdict', comment.includes('legitimate fix'));
-
-const headSha = 'dfb81bb0ae7f36bf8d66d8f45053464c18c005a3';
-const commentsWithFix = [
-  {
-    user: { login: 'MervinPraison' },
-    body: '@claude CI failed on HEAD `dfb81bb0`. Please fix...',
-    created_at: '2026-07-07T18:00:00Z',
-  },
-];
-assert('sha dedup detects existing comment', ciFix.hasCiFixCommentForSha(commentsWithFix, headSha));
-
-const skipNoFinal = ciFix.shouldSkipCiFix({
-  comments: [],
-  headSha,
-  labels: [],
-  hasFinal: false,
-  claudeInProgress: false,
-  failedChecks: [{ name: 'test-core' }],
-});
-assert('skips when final not posted', skipNoFinal.skip && skipNoFinal.reason.includes('final'));
-
-const skipPending = ciFix.shouldSkipCiFix({
-  comments: [],
-  headSha,
-  labels: [ciFix.CI_FIX_LABEL],
-  hasFinal: true,
-  claudeInProgress: false,
-  failedChecks: [{ name: 'test-core' }],
-});
-assert('skips when ci fix pending label', skipPending.skip && skipPending.reason.includes('pending'));
-
-const failedRuns = mergeGate.listFailedChecksOnSha([
-  { status: 'completed', conclusion: 'success', name: 'smoke' },
-  { status: 'completed', conclusion: 'failure', name: 'test-core (cli)' },
-  { status: 'in_progress', conclusion: null, name: 'pending-job' },
-]);
-assert('listFailedChecksOnSha finds failures only', failedRuns.length === 1);
-assert('failed check name', failedRuns[0].name === 'test-core (cli)');
-
-process.exit(failed ? 1 : 0);

.github/scripts/ci-failure-claude.js

@@ -1,294 +0,0 @@
-/**
- * Post @claude comments with CI failure details for internal PRs.
- * @see .github/workflows/ci-failure-claude.yml
- */
-
-const mergeGate = require('./merge-gate.js');
-
-const CI_FIX_LABEL = 'claude-ci-fix-pending';
-const COOLDOWN_MS = 12 * 60 * 60 * 1000;
-const AUTO_ACTORS = mergeGate.AUTO_ACTORS;
-const MAX_FAILURES = 15;
-const MAX_JOBS_TO_FETCH = 5;
-
-function shortSha(headSha) {
-  return (headSha || '').slice(0, 8);
-}
-
-function ciFixShaMarker(headSha) {
-  return `ci failed on head \`${shortSha(headSha)}`.toLowerCase();
-}
-
-function isCiFixComment(comment) {
-  const body = (comment.body || '').toLowerCase();
-  return body.includes('@claude') && body.includes('ci failed on head');
-}
-
-function hasCiFixCommentForSha(comments, headSha) {
-  const marker = shortSha(headSha).toLowerCase();
-  return comments.some((c) => {
-    if (!AUTO_ACTORS.includes(c.user.login)) return false;
-    if (!isCiFixComment(c)) return false;
-    return (c.body || '').toLowerCase().includes(marker);
-  });
-}
-
-function hasRecentCiFixComment(comments, headSha) {
-  const cutoff = Date.now() - COOLDOWN_MS;
-  const marker = shortSha(headSha).toLowerCase();
-  return comments.some((c) => {
-    if (!AUTO_ACTORS.includes(c.user.login)) return false;
-    if (!isCiFixComment(c)) return false;
-    const body = (c.body || '').toLowerCase();
-    if (body.includes(marker)) return true;
-    return new Date(c.created_at).getTime() > cutoff;
-  });
-}
-
-function shouldSkipCiFix({ comments, headSha, labels, hasFinal, claudeInProgress, failedChecks }) {
-  if (!failedChecks.length) return { skip: true, reason: 'no failed checks' };
-  if (labels.includes(CI_FIX_LABEL)) return { skip: true, reason: 'ci fix pending' };
-  if (!hasFinal) return { skip: true, reason: 'awaiting final claude review trigger' };
-  if (claudeInProgress) return { skip: true, reason: 'claude in progress' };
-  if (hasCiFixCommentForSha(comments, headSha)) {
-    return { skip: true, reason: 'already commented for this sha' };
-  }
-  if (hasRecentCiFixComment(comments, headSha)) {
-    return { skip: true, reason: 'recent ci fix comment cooldown' };
-  }
-  return { skip: false };
-}
-
-function parsePytestFailures(logText) {
-  if (!logText) return [];
-  const lines = logText.split('\n');
-  const failures = [];
-  const seen = new Set();
-
-  for (let i = lines.length - 1; i >= 0 && failures.length < MAX_FAILURES; i -= 1) {
-    const line = lines[i].trim();
-    if (!line) continue;
-
-    const pytestMatch = line.match(
-      /FAILED\s*(?:\([^)]+\))?\s+(tests\/[^\s]+(?:::[^\s-]+)*)\s*-\s*(.+)/i
-    );
-    if (pytestMatch) {
-      const testId = pytestMatch[1];
-      if (!seen.has(testId)) {
-        seen.add(testId);
-        failures.push({ testId, error: pytestMatch[2].trim() });
-      }
-      continue;
-    }
-
-    const errorMatch = line.match(/##\[error\](.+)/);
-    if (errorMatch && /tests\//.test(errorMatch[1])) {
-      const msg = errorMatch[1].trim();
-      if (!seen.has(msg)) {
-        seen.add(msg);
-        failures.push({ testId: msg, error: msg });
-      }
-    }
-  }
-
-  return failures;
-}
-
-async function fetchJobFailureSummary(github, owner, repo, jobId, jobName) {
-  try {
-    const response = await github.rest.actions.downloadJobLogsForWorkflowRun({
-      owner,
-      repo,
-      job_id: jobId,
-    });
-    let logText = typeof response.data === 'string' ? response.data : String(response.data || '');
-    if (logText.length > 100000) {
-      logText = logText.slice(-100000);
-    }
-    return { jobName, jobId, failures: parsePytestFailures(logText) };
-  } catch (err) {
-    return { jobName, jobId, failures: [], error: err.message };
-  }
-}
-
-function mapFailedChecks(runs) {
-  return runs.map((run) => ({
-    name: run.name,
-    id: run.id,
-    html_url: run.html_url || run.details_url,
-    workflow: run.app?.slug || run.check_suite?.app?.slug || run.name,
-  }));
-}
-
-function buildCiFixComment({ headSha, failedChecks, failureSummaries }) {
-  const parts = [
-    `@claude CI failed on HEAD \`${shortSha(headSha)}\`. Please fix the failures below and push to this branch.`,
-    '',
-    '## Failed checks',
-  ];
-
-  for (const check of failedChecks) {
-    parts.push(`- **${check.workflow || check.name}** / \`${check.name}\` — ${check.html_url}`);
-  }
-
-  parts.push('', '## Failures (extracted)');
-  let idx = 0;
-  for (const summary of failureSummaries) {
-    for (const failure of summary.failures) {
-      idx += 1;
-      if (idx > MAX_FAILURES) break;
-      parts.push(`${idx}. \`${failure.testId}\` — \`${failure.error}\``);
-      parts.push(`   - Job: \`${summary.jobName}\``);
-    }
-    if (idx >= MAX_FAILURES) break;
-  }
-
-  if (idx === 0) {
-    parts.push('_(Could not extract pytest details — see job logs above.)_');
-  }
-
-  const exampleTest = failureSummaries.find((s) => s.failures.length)?.failures[0]?.testId;
-  parts.push(
-    '',
-    '## Critical review first',
-    'Before changing code or tests, decide **which side is wrong**:',
-    '1. **Legitimate feature change** — the PR intent is correct but implementation or tests need updating. Preserve SDK guarantees; update tests only when behaviour intentionally changed and document why.',
-    '2. **Regression / bug in this PR** — the failure exposes a real breakage introduced here. Fix the implementation; **do not weaken, skip, or delete tests** just to go green.',
-    '3. **Pre-existing flake or unrelated failure** — say so explicitly; prefer fixing the root cause over masking it.',
-    '',
-    '**SDK guardrails (AGENTS.md):**',
-    '- Agent-callable tools → PraisonAI-Tools; lifecycle plugins → PraisonAI-Plugins; sandbox backends → PraisonAI-Plugins (`praisonai.sandbox`) — not praisonaiagents/.',
-    '- Do not disturb core SDK contracts to accommodate a wrapper/feature change.',
-    '- Tests must continue to guard backward compatibility and hot-path behaviour — passing CI by lowering test standards is not acceptable.',
-    '- If the feature does not genuinely add SDK value, recommend reverting or narrowing scope instead of patching around failures.',
-    '',
-    '## What to do',
-    '1. State your verdict: **legitimate fix**, **regression fix**, or **needs human review** — and why (1–3 sentences).',
-    '2. Fix root cause with **minimal changes**; never bloat the Agent class with extra params.',
-    exampleTest
-      ? `3. Run failing tests locally, e.g. \`pytest ${exampleTest} -q\`, plus any related SDK tests touched by the PR.`
-      : '3. Run failing tests locally with targeted pytest, plus any related SDK tests touched by the PR.',
-    '4. Push to this branch and comment: files changed, review verdict, and why tests still protect SDK behaviour.',
-  );
-
-  return parts.join('\n');
-}
-
-async function maybeClearCiFixLabel(github, owner, repo, prNumber, labels, headSha, core) {
-  if (!labels.includes(CI_FIX_LABEL)) return false;
-  const ciGreen = await mergeGate.allChecksGreenOnSha(github, owner, repo, headSha, core);
-  if (!ciGreen) return false;
-  try {
-    await github.rest.issues.removeLabel({
-      owner,
-      repo,
-      issue_number: prNumber,
-      name: CI_FIX_LABEL,
-    });
-    core?.info?.(`Removed ${CI_FIX_LABEL} from PR #${prNumber}`);
-  } catch (err) {
-    if (err.status !== 404) throw err;
-  }
-  return true;
-}
-
-async function maybeTriggerCiFixClaude(github, owner, repo, prNumber, core, opts = {}) {
-  const baseRepo = `${owner}/${repo}`;
-  const ctx = await mergeGate.loadPrContext(github, owner, repo, prNumber);
-  const pr = ctx.pr;
-
-  if (pr.state !== 'open') return { skipped: true, reason: 'not open' };
-  if (pr.draft) return { skipped: true, reason: 'draft' };
-
-  const headRepo = pr.head.repo?.full_name;
-  if (headRepo && headRepo !== baseRepo && !pr.maintainer_can_modify) {
-    return { skipped: true, reason: 'fork without maintainer edits' };
-  }
-
-  const headSha = pr.head.sha;
-  const labels = ctx.labels;
-
-  if (await maybeClearCiFixLabel(github, owner, repo, prNumber, labels, headSha, core)) {
-    return { skipped: true, reason: 'ci green, label cleared' };
-  }
-
-  const ciGreen = await mergeGate.allChecksGreenOnSha(github, owner, repo, headSha, core);
-  if (ciGreen) return { skipped: true, reason: 'ci green' };
-
-  const runs = await mergeGate.listChecksOnSha(github, owner, repo, headSha);
-  const failedRuns = mergeGate.listFailedChecksOnSha(runs);
-  if (failedRuns.length === 0) {
-    return { skipped: true, reason: 'no failed checks yet (may be pending)' };
-  }
-
-  const hasFinal = mergeGate.hasFinalClaudeReviewTrigger(ctx.comments);
-  const claudeInProgress = await mergeGate.hasInProgressClaudeAssistant(
-    github, owner, repo, prNumber
-  );
-  const skip = shouldSkipCiFix({
-    comments: ctx.comments,
-    headSha,
-    labels,
-    hasFinal,
-    claudeInProgress,
-    failedChecks: failedRuns,
-  });
-  if (skip.skip) return { skipped: true, reason: skip.reason };
-
-  const failedChecks = mapFailedChecks(failedRuns);
-  const failureSummaries = [];
-  for (const check of failedChecks.slice(0, MAX_JOBS_TO_FETCH)) {
-    failureSummaries.push(
-      await fetchJobFailureSummary(github, owner, repo, check.id, check.name)
-    );
-  }
-
-  const body = buildCiFixComment({ headSha, failedChecks, failureSummaries });
-
-  await github.rest.issues.addLabels({
-    owner,
-    repo,
-    issue_number: prNumber,
-    labels: [CI_FIX_LABEL],
-  });
-  await github.rest.issues.createComment({
-    owner,
-    repo,
-    issue_number: prNumber,
-    body,
-  });
-
-  core?.info?.(`Posted CI fix @claude on PR #${prNumber} (${shortSha(headSha)})`);
-  return { triggered: true, headSha: shortSha(headSha) };
-}
-
-async function processWorkflowRunFailure(github, owner, repo, workflowRun, core) {
-  if (workflowRun.conclusion !== 'failure') {
-    return { skipped: true, reason: `conclusion=${workflowRun.conclusion}` };
-  }
-  const allowed = ['Core Tests', 'Optimized Test Suite'];
-  if (!allowed.includes(workflowRun.name)) {
-    return { skipped: true, reason: `workflow ${workflowRun.name}` };
-  }
-  const prNumber = await mergeGate.resolvePrNumberFromWorkflowRun(
-    github, owner, repo, workflowRun
-  );
-  if (!prNumber) return { skipped: true, reason: 'no linked PR' };
-  return maybeTriggerCiFixClaude(github, owner, repo, prNumber, core);
-}
-
-module.exports = {
-  CI_FIX_LABEL,
-  COOLDOWN_MS,
-  ciFixShaMarker,
-  isCiFixComment,
-  hasCiFixCommentForSha,
-  hasRecentCiFixComment,
-  shouldSkipCiFix,
-  parsePytestFailures,
-  fetchJobFailureSummary,
-  buildCiFixComment,
-  maybeClearCiFixLabel,
-  maybeTriggerCiFixClaude,
-  processWorkflowRunFailure,
-};

.github/scripts/merge-gate-selftest.js

@@ -1,382 +0,0 @@
-#!/usr/bin/env node
-/**
- * Local self-test for merge-gate.js heuristics (no GitHub API).
- * Run: node .github/scripts/merge-gate-selftest.js
- */
-const mg = require('./merge-gate.js');
-
-let failed = 0;
-function assert(name, cond) {
-  if (!cond) {
-    console.error('FAIL:', name);
-    failed++;
-  } else {
-    console.log('ok:', name);
-  }
-}
-
-// Stale FINAL: push after FINAL, no @claude since head
-const finals = [
-  { user: { login: 'github-actions[bot]' }, body: '@claude FINAL architecture reviewer', created_at: '2026-06-12T08:00:00Z' },
-];
-assert('stale when head after final', mg.isStaleFinalAfterPush(finals, '2026-06-12T09:00:00Z'));
-
-const withRecovery = [
-  ...finals,
-  { user: { login: 'github-actions[bot]' }, body: '@claude FINAL architecture reviewer', created_at: '2026-06-12T09:30:00Z' },
-];
-assert('not stale when @claude after head', !mg.isStaleFinalAfterPush(withRecovery, '2026-06-12T09:00:00Z'));
-
-const withClaudeReply = [
-  ...finals,
-  {
-    user: { login: 'praisonai-triage-agent[bot]' },
-    body: "**Claude finished @MervinPraison's task** —— [View job](https://github.com/)",
-    created_at: '2026-06-12T08:30:00Z',
-  },
-];
-assert('not stale when Claude replied after FINAL', !mg.isStaleFinalAfterPush(withClaudeReply, '2026-06-12T09:00:00Z'));
-assert('claude final reply detected', mg.isClaudeFinalReplyComment(withClaudeReply[1]));
-
-assert('cancelled detect-and-trigger does not block', mg.OPTIONAL_CANCELLED_CHECKS.has('detect-and-trigger'));
-
-const coreGreenRuns = [
-  { name: 'test-core', status: 'completed', conclusion: 'success' },
-  { name: 'test-core (cli)', status: 'completed', conclusion: 'success' },
-  { name: 'smoke', status: 'completed', conclusion: 'cancelled' },
-  { name: 'test-windows', status: 'completed', conclusion: 'cancelled' },
-];
-assert('core green allows cancelled smoke', mg.isAcceptableCheckConclusion(
-  { name: 'smoke', status: 'completed', conclusion: 'cancelled' },
-  coreGreenRuns
-));
-assert('core green allows cancelled test-windows', mg.isAcceptableCheckConclusion(
-  { name: 'test-windows', status: 'completed', conclusion: 'cancelled' },
-  coreGreenRuns
-));
-assert('cancelled smoke blocks when core missing', !mg.isAcceptableCheckConclusion(
-  { name: 'smoke', status: 'completed', conclusion: 'cancelled' },
-  [{ name: 'smoke', status: 'completed', conclusion: 'cancelled' }]
-));
-assert('cancelled smoke blocks when core failed', !mg.isAcceptableCheckConclusion(
-  { name: 'smoke', status: 'completed', conclusion: 'cancelled' },
-  [
-    { name: 'test-core', status: 'completed', conclusion: 'failure' },
-    { name: 'smoke', status: 'completed', conclusion: 'cancelled' },
-  ]
-));
-assert('bestRunsByName prefers success over cancelled', (() => {
-  const best = mg.bestRunsByName([
-    { name: 'smoke', conclusion: 'cancelled' },
-    { name: 'smoke', conclusion: 'success' },
-  ]);
-  return best.length === 1 && best[0].conclusion === 'success';
-})());
-assert('bestRunsByName prefers pending over completed cancelled', (() => {
-  const best = mg.bestRunsByName([
-    { name: 'smoke', status: 'completed', conclusion: 'cancelled' },
-    { name: 'smoke', status: 'in_progress', conclusion: null },
-  ]);
-  return best.length === 1 && best[0].status === 'in_progress';
-})());
-assert('bestRunsByName keeps pending regardless of order', (() => {
-  const best = mg.bestRunsByName([
-    { name: 'smoke', status: 'in_progress', conclusion: null },
-    { name: 'smoke', status: 'completed', conclusion: 'success' },
-  ]);
-  return best.length === 1 && best[0].status === 'in_progress';
-})());
-assert('allChecksGreenOnSha style: pending re-run blocks despite core green', (() => {
-  const runs = mg.bestRunsByName([
-    { name: 'test-core', status: 'completed', conclusion: 'success' },
-    { name: 'smoke', status: 'completed', conclusion: 'cancelled' },
-    { name: 'smoke', status: 'queued', conclusion: null },
-  ]);
-  const smoke = runs.find((r) => r.name === 'smoke');
-  return smoke.status !== 'completed';
-})());
-
-// Stale-FINAL recovery guards (PR #2560 push loop)
-const nowMs = Date.now();
-const iso = (ms) => new Date(ms).toISOString();
-const firstFinal = {
-  user: { login: 'MervinPraison' },
-  body: '@claude You are the FINAL architecture reviewer.',
-  created_at: iso(nowMs - 20 * 60 * 1000),
-};
-const pushSoonAfter = mg.shouldSkipStaleFinalRecovery(
-  [firstFinal],
-  iso(nowMs - 16 * 60 * 1000)
-);
-assert('debounce push soon after FINAL', pushSoonAfter.skip && pushSoonAfter.reason.includes('soon after'));
-
-const secondFinal = {
-  user: { login: 'MervinPraison' },
-  body: '@claude You are the FINAL architecture reviewer.',
-  created_at: iso(nowMs - 20 * 60 * 1000),
-};
-const capped = mg.shouldSkipStaleFinalRecovery(
-  [firstFinal, secondFinal],
-  iso(nowMs - 2 * 60 * 1000)
-);
-assert('hourly cap blocks third FINAL in window', capped.skip && capped.reason.includes('capped'));
-
-const botPush = mg.shouldSkipStaleFinalRecovery(
-  [firstFinal],
-  iso(nowMs - 16 * 60 * 1000),
-  'praisonai-triage-agent[bot]'
-);
-assert('skip when automation pushed head', botPush.skip && botPush.reason.includes('automation'));
-
-assert('claude automation login', mg.isClaudeAutomationLogin('praisonai-triage-agent[bot]'));
-
-// Bot CHANGES_REQUESTED then APPROVE
-const reviews = [
-  { user: { login: 'coderabbit[bot]', type: 'Bot' }, state: 'CHANGES_REQUESTED', submitted_at: '2026-06-12T08:00:00Z' },
-  { user: { login: 'coderabbit[bot]', type: 'Bot' }, state: 'APPROVED', submitted_at: '2026-06-12T09:00:00Z' },
-];
-assert('bot approve clears CR', !mg.hasAnyChangesRequested(reviews));
-assert('human CR blocks', mg.hasAnyChangesRequested([
-  { user: { login: 'MervinPraison', type: 'User' }, state: 'CHANGES_REQUESTED', submitted_at: '2026-06-12T09:00:00Z' },
-]));
-
-// Verdict after HEAD
-const verdictComments = [
-  { body: 'MERGE_GATE_VERDICT: APPROVE', created_at: '2026-06-12T08:00:00Z' },
-];
-assert('verdict before head rejected', mg.findMergeGateVerdict(verdictComments, null, '2026-06-12T09:00:00Z') === null);
-assert('verdict after head accepted', mg.findMergeGateVerdict(
-  [{ body: 'MERGE_GATE_VERDICT: APPROVE', created_at: '2026-06-12T10:00:00Z' }],
-  null,
-  '2026-06-12T09:00:00Z'
-) === 'APPROVE');
-
-const fallbackApprove = [
-  {
-    body: 'MERGE_GATE_VERDICT: APPROVE\n\nAutomated fallback — Claude assess did not post a verdict comment.',
-    created_at: '2026-06-12T10:00:00Z',
-  },
-];
-assert(
-  'automated fallback APPROVE ignored when Opus required',
-  mg.findMergeGateVerdict(fallbackApprove, null, '2026-06-12T09:00:00Z', { excludeAutomatedFallback: true }) === null
-);
-assert(
-  'automated fallback APPROVE still visible without Opus-only filter',
-  mg.findMergeGateVerdict(fallbackApprove, null, '2026-06-12T09:00:00Z') === 'APPROVE'
-);
-
-const fallbackBlockNewFormat = [
-  {
-    body: 'MERGE_GATE_VERDICT: BLOCK\n\nAutomated fallback — Opus merge gate assessment did not complete.',
-    created_at: '2026-06-12T10:00:00Z',
-  },
-];
-assert(
-  'new-format fallback BLOCK ignored when Opus required',
-  mg.findMergeGateVerdict(fallbackBlockNewFormat, null, '2026-06-12T09:00:00Z', { excludeAutomatedFallback: true }) === null
-);
-assert(
-  'new-format fallback BLOCK detected by marker helper',
-  mg.isAutomatedFallbackVerdict(fallbackBlockNewFormat[0].body)
-);
-assert(
-  'findMergeGateVerdict null-safe with explicit null options',
-  mg.findMergeGateVerdict(fallbackApprove, null, '2026-06-12T09:00:00Z', null) === 'APPROVE'
-);
-
-const noise = [{ user: { login: 'MervinPraison' }, body: '**Merge gate scan** — wait for `@claude`', created_at: new Date().toISOString() }];
-assert('diagnostic comment not a trigger', !mg.hasRecentClaudeTrigger(noise, 35));
-
-// Cooldown skip requires an actual verdict on HEAD, not just a FINAL trigger comment
-const recentFinalOnHead = [
-  {
-    user: { login: 'MervinPraison' },
-    body: '@claude You are the FINAL architecture reviewer.',
-    created_at: '2026-06-27T10:00:00Z',
-  },
-];
-assert(
-  'final trigger alone does not count as verdict on head',
-  mg.findMergeGateVerdict(recentFinalOnHead, null, '2026-06-27T09:55:00Z') === null
-);
-const recentVerdictOnHead = [
-  ...recentFinalOnHead,
-  {
-    user: { login: 'github-actions[bot]' },
-    body: 'MERGE_GATE_VERDICT: APPROVE',
-    created_at: '2026-06-27T10:05:00Z',
-  },
-];
-assert(
-  'verdict on head skips cooldown gate',
-  mg.findMergeGateVerdict(recentVerdictOnHead, null, '2026-06-27T09:55:00Z') === 'APPROVE'
-);
-
-assert(
-  'scan kickoff text is not a verdict',
-  mg.findMergeGateVerdict([
-    {
-      body: '**Merge gate scan** — eligible for assessment. Claude merge gate will assess and may auto-merge if `MERGE_GATE_VERDICT: APPROVE`.',
-      created_at: '2026-06-27T10:05:00Z',
-    },
-  ], null, '2026-06-27T09:55:00Z') === null
-);
-
-const finalWithFinished = [
-  { user: { login: 'MervinPraison' }, body: '@claude You are the FINAL architecture reviewer.', created_at: '2026-06-27T10:00:00Z' },
-  { user: { login: 'praisonai-triage-agent[bot]' }, body: 'Claude finished', created_at: '2026-06-27T10:05:00Z' },
-];
-assert('final complete requires Claude finished reply', mg.finalClaudeCompletedOnSha(finalWithFinished, '2026-06-27T09:55:00Z'));
-assert('final trigger alone is incomplete', !mg.finalClaudeCompletedOnSha(
-  [{ user: { login: 'MervinPraison' }, body: '@claude You are the FINAL architecture reviewer.', created_at: '2026-06-27T10:00:00Z' }],
-  '2026-06-27T09:55:00Z'
-));
-
-assert('recent scan comment detected', mg.hasRecentMergeGateScanComment([
-  { body: '**Merge gate scan** — eligible', created_at: new Date().toISOString() },
-]));
-assert('old scan comment not recent', !mg.hasRecentMergeGateScanComment([
-  { body: '**Merge gate scan** — eligible', created_at: '2020-01-01T00:00:00Z' },
-]));
-
-// Sensitive + secrets
-assert('workflow path sensitive', mg.sensitivePathReasons([{ filename: '.github/workflows/foo.yml' }]).length === 1);
-assert('ci-only label exempts workflows', mg.sensitivePathReasons(
-  [{ filename: '.github/workflows/foo.yml' }],
-  [mg.WORKFLOW_ONLY_LABEL]
-).length === 0);
-assert('ci-only label not exempt mixed changes', mg.sensitivePathReasons(
-  [{ filename: '.github/workflows/foo.yml' }, { filename: 'src/foo.py' }],
-  [mg.WORKFLOW_ONLY_LABEL]
-).length === 1);
-assert('secret in patch', mg.secretScanReasons([{ filename: 'x.py', patch: '+key = "ghp_abcdefghijklmnopqrstuvwxyz1234567890"' }]).length === 1);
-
-// Claude run scoping — other PR branches must not block
-assert('other branch claude does not block', !mg.hasBlockingClaudeRunForPr(
-  [{ event: 'issue_comment', head_branch: 'other-branch' }],
-  'my-branch'
-));
-assert('same branch claude blocks', mg.hasBlockingClaudeRunForPr(
-  [{ event: 'issue_comment', head_branch: 'my-branch' }],
-  'my-branch'
-));
-assert('issues event never blocks', !mg.hasBlockingClaudeRunForPr(
-  [{ event: 'issues', head_branch: 'my-branch' }],
-  'my-branch'
-));
-
-// Conflict rebase clears after bot completion + FINAL on HEAD (within 12h cooldown)
-const conflictNowMs = Date.now();
-const conflictIso = (offsetMs) => new Date(conflictNowMs + offsetMs).toISOString();
-const conflictTrigger = {
-  user: { login: 'MervinPraison' },
-  body: '@claude this PR has merge conflicts with main. Please rebase',
-  created_at: conflictIso(-30 * 60 * 1000),
-};
-const rebaseDone = {
-  user: { login: 'praisonai-triage-agent[bot]' },
-  body: 'Rebase complete — PR #2308 onto latest main',
-  created_at: conflictIso(-29 * 60 * 1000),
-};
-const finalAfterRebase = {
-  user: { login: 'MervinPraison' },
-  body: '@claude You are the FINAL architecture reviewer.',
-  created_at: conflictIso(-20 * 60 * 1000),
-};
-const claudeFinishedAfterRebase = {
-  user: { login: 'praisonai-triage-agent[bot]' },
-  body: 'Claude finished',
-  created_at: conflictIso(-19 * 60 * 1000),
-};
-const headAfterRebase = conflictIso(-21 * 60 * 1000);
-const rebaseComments = [conflictTrigger, rebaseDone, finalAfterRebase, claudeFinishedAfterRebase];
-assert('conflict blocks before rebase done', mg.hasRecentConflictComment([conflictTrigger], headAfterRebase));
-assert('conflict clears after rebase + FINAL on HEAD', !mg.hasRecentConflictComment(rebaseComments, headAfterRebase));
-assert('conflict still blocks without FINAL on HEAD', mg.hasRecentConflictComment(
-  [conflictTrigger, rebaseDone],
-  headAfterRebase
-));
-
-// Tests heuristic
-assert('sdk without tests', mg.missingTestsReason([{ filename: 'src/praisonai-agents/a/b.py', additions: 3 }]) !== null);
-assert('sdk with tests ok', mg.missingTestsReason([
-  { filename: 'src/praisonai-agents/a/b.py', additions: 3 },
-  { filename: 'src/praisonai-agents/tests/test_x.py', additions: 10 },
-]) === null);
-assert('ts sdk without tests', mg.missingTestsReason([
-  { filename: 'src/praisonai-ts/src/agent/simple.ts', additions: 5 },
-]) !== null);
-assert('ts sdk with tests ok', mg.missingTestsReason([
-  { filename: 'src/praisonai-ts/src/agent/simple.ts', additions: 5 },
-  { filename: 'src/praisonai-ts/tests/unit/agent/history-restore.test.ts', additions: 10 },
-]) === null);
-assert('touches ts sdk', mg.touchesSdk([{ filename: 'src/praisonai-ts/src/agent/simple.ts' }]));
-assert('final body requires sdk value table', mg.FINAL_CLAUDE_REVIEW_BODY.includes('| **SDK value** |'));
-assert('final body requires ts agents md', mg.FINAL_CLAUDE_REVIEW_BODY.includes('src/praisonai-ts/AGENTS.md'));
-
-// PR size
-assert('large PR blocked', mg.prSizeReasons([{ additions: 900 }]).length > 0);
-
-assert('internal PR link accepted', mg.isInternalPullRequestLink(
-  { base: { repo: { full_name: 'MervinPraison/PraisonAI' } } },
-  'MervinPraison',
-  'PraisonAI'
-));
-assert('fork sync PR link rejected', !mg.isInternalPullRequestLink(
-  { number: 21, base: { repo: { full_name: 'Milkmange/PraisonAI' } } },
-  'MervinPraison',
-  'PraisonAI'
-));
-
-assert('dispatch blocked when merge gate active', mg.mergeGateDispatchBlockedReason({
-  labels: ['claude-merge-gate-active'],
-  pendingRuns: 0,
-}) === 'merge gate already active on PR');
-assert('dispatch blocked when queue saturated', mg.mergeGateDispatchBlockedReason({
-  labels: [],
-  pendingRuns: 3,
-})?.includes('already queued or in progress'));
-assert('dispatch allowed when queue below cap', mg.mergeGateDispatchBlockedReason({
-  labels: [],
-  pendingRuns: 2,
-}) == null);
-
-// Pending count excludes workflow_run auto-dispatch probes (PR #4534)
-assert('workflow_run probes excluded from pending count', mg.countSubstantiveMergeGateRuns([
-  { event: 'workflow_dispatch' },
-  { event: 'workflow_run' },
-  { event: 'workflow_run' },
-]) === 1);
-assert('all-probe runs count as zero pending', mg.countSubstantiveMergeGateRuns([
-  { event: 'workflow_run' },
-  { event: 'workflow_run' },
-]) === 0);
-assert('substantive dispatches still counted', mg.countSubstantiveMergeGateRuns([
-  { event: 'workflow_dispatch' },
-  { event: 'schedule' },
-]) === 2);
-assert('countSubstantiveMergeGateRuns null-safe', mg.countSubstantiveMergeGateRuns(null) === 0);
-assert('rate limit threshold is 200', mg.MIN_CORE_RATE_LIMIT_REMAINING === 200);
-
-(async () => {
-  const skipLow = await mg.shouldSkipMergeGateDispatch(
-    {
-      rest: {
-        rateLimit: {
-          get: async () => ({ data: { resources: { core: { remaining: 50 } } } }),
-        },
-      },
-    },
-    'owner',
-    'repo',
-    1,
-    { info: () => {} }
-  );
-  assert('rate limit low skips dispatch', skipLow === true);
-
-  process.exit(failed ? 1 : 0);
-})().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

.github/scripts/pipeline-status-selftest.js

@@ -1,76 +0,0 @@
-#!/usr/bin/env node
-/**
- * Run: node .github/scripts/pipeline-status-selftest.js
- */
-const ps = require('./pipeline-status.js');
-const mg = require('./merge-gate.js');
-
-let failed = 0;
-function assert(name, cond) {
-  if (!cond) {
-    console.error('FAIL:', name);
-    failed++;
-  } else {
-    console.log('ok:', name);
-  }
-}
-
-const kickComments = [
-  { user: { login: 'MervinPraison' }, body: '@coderabbitai review' },
-  { user: { login: 'MervinPraison' }, body: '/review' },
-];
-
-const finalComment = {
-  user: { login: 'MervinPraison' },
-  body: '@claude You are the FINAL architecture reviewer.',
-  created_at: '2026-06-26T10:00:00Z',
-};
-
-assert(
-  'reviews pending when not kicked',
-  ps.deriveStage([], { ready: false, reasons: ['no FINAL Claude review trigger'] })
-    === 'pipeline/reviews-pending'
-);
-assert(
-  'final pending after kick',
-  ps.deriveStage(kickComments, { ready: false, reasons: ['no FINAL Claude review trigger'] })
-    === 'pipeline/final-claude-pending'
-);
-assert(
-  'awaiting merge gate after final',
-  ps.deriveStage(
-    [...kickComments, finalComment],
-    { ready: false, reasons: ['recent @claude within 35min'] }
-  ) === 'pipeline/awaiting-merge-gate'
-);
-assert(
-  'merge ready',
-  ps.deriveStage([...kickComments, finalComment], { ready: true, reasons: [] })
-    === 'pipeline/merge-ready'
-);
-
-const blockers = ps.deriveBlockerLabels({
-  ready: false,
-  reasons: ['CI not green on HEAD', 'SDK code added without test file changes — requires manual review'],
-});
-assert('maps ci blocker', blockers.includes('pipeline/blocked:ci'));
-assert('maps manual blocker', blockers.includes('pipeline/blocked:manual-review'));
-
-assert(
-  'internal link matches upstream base',
-  mg.isInternalPullRequestLink(
-    { base: { repo: { full_name: 'MervinPraison/PraisonAI' } } },
-    'MervinPraison',
-    'PraisonAI'
-  )
-);
-assert(
-  'fork sync link rejected',
-  !mg.isInternalPullRequestLink(
-    { number: 21, base: { repo: { full_name: 'Milkmange/PraisonAI' } } },
-    'MervinPraison',
-    'PraisonAI'
-  )
-);
-
-process.exit(failed ? 1 : 0);

.github/scripts/pipeline-status.js

@@ -1,258 +0,0 @@
-/**
- * Sync pipeline stage/blocker labels on open PRs.
- * @see .github/workflows/pipeline-status-sync.yml
- */
-
-const mergeGate = require('./merge-gate.js');
-const chain = require('./bot-pr-review-chain.js');
-const ciFix = require('./ci-failure-claude.js');
-
-const PIPELINE_PREFIX = 'pipeline/';
-const STAGE_LABELS = [
-  'pipeline/reviews-pending',
-  'pipeline/final-claude-pending',
-  'pipeline/awaiting-merge-gate',
-  'pipeline/merge-ready',
-  'pipeline/merged',
-];
-const BLOCKER_LABELS = [
-  'pipeline/blocked:ci',
-  'pipeline/blocked:conflict',
-  'pipeline/blocked:manual-review',
-  'pipeline/blocked:cooldown',
-  'pipeline/blocked:stale-final',
-  'pipeline/blocked:no-final',
-];
-const ALL_PIPELINE_LABELS = [...STAGE_LABELS, ...BLOCKER_LABELS];
-
-const LABEL_SPECS = [
-  { name: 'pipeline/reviews-pending', color: 'fbca04', description: 'Waiting for CodeRabbit/Qodo/Copilot reviews' },
-  { name: 'pipeline/final-claude-pending', color: 'd4c5f9', description: 'Reviews done; waiting for FINAL @claude' },
-  { name: 'pipeline/awaiting-merge-gate', color: 'c5def5', description: 'FINAL done; waiting for merge gate / CI' },
-  { name: 'pipeline/merge-ready', color: '0e8a16', description: 'Eligible for merge gate auto-merge' },
-  { name: 'pipeline/merged', color: '6f42c1', description: 'Merged via pipeline' },
-  { name: 'pipeline/blocked:ci', color: 'd93f0b', description: 'Blocked: CI not green on HEAD' },
-  { name: 'pipeline/blocked:conflict', color: 'b60205', description: 'Blocked: merge conflict or rebase pending' },
-  { name: 'pipeline/blocked:manual-review', color: 'e99695', description: 'Blocked: requires manual review' },
-  { name: 'pipeline/blocked:cooldown', color: 'fef2c0', description: 'Blocked: post-push or @claude cooldown' },
-  { name: 'pipeline/blocked:stale-final', color: 'f9d0c4', description: 'Blocked: FINAL stale after new commits' },
-  { name: 'pipeline/blocked:no-final', color: 'ededed', description: 'Blocked: no FINAL @claude trigger yet' },
-];
-
-function deriveStage(comments, evalResult) {
-  if (evalResult.ready) return 'pipeline/merge-ready';
-  if (!chain.chainKickPosted(comments)) return 'pipeline/reviews-pending';
-  if (!mergeGate.hasFinalClaudeReviewTrigger(comments)) return 'pipeline/final-claude-pending';
-  return 'pipeline/awaiting-merge-gate';
-}
-
-function reasonToBlockerLabel(reason) {
-  const r = (reason || '').toLowerCase();
-  if (r.includes('ci not green') || r.includes('sdk code changed but no ci')) return 'pipeline/blocked:ci';
-  if (
-    r.includes('conflict') ||
-    r.includes('mergestate=dirty') ||
-    r.includes('not mergeable')
-  ) return 'pipeline/blocked:conflict';
-  if (
-    r.includes('manual') ||
-    r.includes('requires manual') ||
-    r.includes('sensitive path') ||
-    r.includes('no-auto-merge') ||
-    r.includes('manual-only label') ||
-    r.includes('without test') ||
-    r.includes('files changed') ||
-    r.includes('possible secret') ||
-    r.includes('agent.py')
-  ) return 'pipeline/blocked:manual-review';
-  if (r.includes('recent @claude') || r.includes('post-push buffer')) return 'pipeline/blocked:cooldown';
-  if (r.includes('stale final')) return 'pipeline/blocked:stale-final';
-  if (r.includes('no final claude')) return 'pipeline/blocked:no-final';
-  if (r.includes('final claude not complete')) return 'pipeline/blocked:stale-final';
-  if (r.includes('claude.yml in progress') || r.includes('claude-merge-gate-active')) {
-    return null;
-  }
-  return null;
-}
-
-function deriveBlockerLabels(evalResult) {
-  if (evalResult.ready) return [];
-  const labels = new Set();
-  for (const reason of evalResult.reasons || []) {
-    const mapped = reasonToBlockerLabel(reason);
-    if (mapped && mapped.startsWith('pipeline/blocked:')) labels.add(mapped);
-  }
-  return [...labels];
-}
-
-function computePipelineLabels(comments, evalResult) {
-  const stage = deriveStage(comments, evalResult);
-  const blockers = stage === 'pipeline/merge-ready' ? [] : deriveBlockerLabels(evalResult);
-  return { stage, blockers, all: [stage, ...blockers] };
-}
-
-async function ensurePipelineLabels(github, owner, repo, core) {
-  let existing;
-  if (typeof github.paginate === 'function') {
-    existing = await github.paginate(github.rest.issues.listLabelsForRepo, {
-      owner,
-      repo,
-      per_page: 100,
-    });
-  } else {
-    ({ data: existing } = await github.rest.issues.listLabelsForRepo({
-      owner,
-      repo,
-      per_page: 100,
-    }));
-  }
-  const names = new Set(existing.map((l) => l.name));
-  for (const spec of LABEL_SPECS) {
-    if (names.has(spec.name)) continue;
-    try {
-      await github.rest.issues.createLabel({
-        owner,
-        repo,
-        name: spec.name,
-        color: spec.color,
-        description: spec.description,
-      });
-      core?.info?.(`Created label ${spec.name}`);
-    } catch (err) {
-      if (err.status !== 422) throw err;
-      core?.info?.(`Label ${spec.name} already exists`);
-    }
-  }
-}
-
-async function syncPipelineLabels(github, owner, repo, prNumber, core) {
-  const ctx = await mergeGate.loadPrContext(github, owner, repo, prNumber);
-  if (ctx.pr.state !== 'open') return { synced: false, reason: 'not_open' };
-
-  const evalResult = await mergeGate.evaluatePipelineQuiescent(
-    github, owner, repo, prNumber, core
-  );
-  const { stage, blockers, all } = computePipelineLabels(ctx.comments, evalResult);
-
-  const current = ctx.labels.filter((l) => l.startsWith(PIPELINE_PREFIX));
-  const desired = new Set(all);
-  const toRemove = current.filter((l) => !desired.has(l) && l !== 'pipeline/merged');
-  const toAdd = all.filter((l) => !current.includes(l));
-
-  for (const name of toRemove) {
-    try {
-      await github.rest.issues.removeLabel({ owner, repo, issue_number: prNumber, name });
-    } catch (err) {
-      if (err.status !== 404) throw err;
-    }
-  }
-  if (toAdd.length) {
-    await github.rest.issues.addLabels({
-      owner,
-      repo,
-      issue_number: prNumber,
-      labels: toAdd,
-    });
-  }
-
-  core?.info?.(`PR #${prNumber}: stage=${stage} blockers=[${blockers.join(', ')}]`);
-
-  const ciNotGreen = (evalResult.reasons || []).some((r) =>
-    r.toLowerCase().includes('ci not green')
-  );
-  if (ciNotGreen || blockers.includes('pipeline/blocked:ci')) {
-    await ciFix.maybeTriggerCiFixClaude(github, owner, repo, prNumber, core);
-  } else {
-    await ciFix.maybeClearCiFixLabel(
-      github, owner, repo, prNumber, ctx.labels, ctx.headSha, core
-    );
-  }
-
-  return {
-    synced: true,
-    stage,
-    blockers,
-    ready: evalResult.ready,
-    reasons: evalResult.reasons,
-    labels: ctx.labels,
-    createdAt: new Date(ctx.pr.created_at).getTime(),
-  };
-}
-
-async function dispatchMergeGateForOldestReady(github, owner, repo, readyCandidates, core) {
-  if (!readyCandidates.length) return 0;
-  const mergeGate = require('./merge-gate.js');
-  readyCandidates.sort((a, b) => a.createdAt - b.createdAt);
-  for (const cand of readyCandidates) {
-    if (await mergeGate.shouldSkipMergeGateDispatch(github, owner, repo, cand.prNumber, core)) {
-      continue;
-    }
-    await github.rest.repos.createDispatchEvent({
-      owner,
-      repo,
-      event_type: 'claude-merge-gate',
-      client_payload: { pr_number: cand.prNumber },
-    });
-    core?.info?.(`Dispatched merge gate for ready PR #${cand.prNumber}`);
-    return cand.prNumber;
-  }
-  return 0;
-}
-
-async function syncOpenPullRequests(github, owner, repo, options, core) {
-  const { maxPrs = 20, dispatchMergeGate = true } = options || {};
-  await ensurePipelineLabels(github, owner, repo, core);
-  let prs;
-  if (maxPrs <= 100) {
-    ({ data: prs } = await github.rest.pulls.list({
-      owner,
-      repo,
-      state: 'open',
-      per_page: 100,
-    }));
-  } else {
-    prs = await github.paginate(github.rest.pulls.list, {
-      owner,
-      repo,
-      state: 'open',
-      per_page: 100,
-    });
-  }
-  let synced = 0;
-  const readyCandidates = [];
-  for (const pr of prs) {
-    if (synced >= maxPrs) break;
-    if (pr.draft) continue;
-    if (pr.head?.repo?.full_name && pr.head.repo.full_name !== `${owner}/${repo}`) continue;
-    const result = await syncPipelineLabels(github, owner, repo, pr.number, core);
-    if (result.ready) {
-      readyCandidates.push({
-        prNumber: pr.number,
-        createdAt: result.createdAt || new Date(pr.created_at).getTime(),
-        labels: result.labels || [],
-      });
-    }
-    synced += 1;
-  }
-  let dispatched = 0;
-  if (dispatchMergeGate && readyCandidates.length) {
-    dispatched = await dispatchMergeGateForOldestReady(
-      github, owner, repo, readyCandidates, core
-    );
-  }
-  core?.info?.(`Pipeline label sync complete (${synced} PR(s), dispatched=${dispatched || 'none'})`);
-  return synced;
-}
-
-module.exports = {
-  STAGE_LABELS,
-  BLOCKER_LABELS,
-  ALL_PIPELINE_LABELS,
-  deriveStage,
-  deriveBlockerLabels,
-  computePipelineLabels,
-  ensurePipelineLabels,
-  syncPipelineLabels,
-  syncOpenPullRequests,
-  dispatchMergeGateForOldestReady,
-};

.github/scripts/pr-review-chain-selftest.js

@@ -1,111 +0,0 @@
-#!/usr/bin/env node
-const chain = require('./pr-review-chain.js');
-
-let failed = 0;
-function assert(name, cond) {
-  if (!cond) {
-    console.error('FAIL:', name);
-    failed++;
-  } else {
-    console.log('ok:', name);
-  }
-}
-
-const coderabbit = {
-  user: { login: 'coderabbitai[bot]' },
-  body: '<!-- summarize by coderabbit.ai --> summary',
-  created_at: '2026-07-02T07:16:00Z',
-};
-const greptile = {
-  user: { login: 'greptile-apps[bot]' },
-  body: '<h3>Greptile Summary</h3><p>Looks good</p>',
-  created_at: '2026-07-02T07:19:00Z',
-};
-const copilotKick = {
-  user: { login: 'MervinPraison' },
-  body: '@copilot Do a thorough review',
-  created_at: '2026-07-02T07:20:00Z',
-};
-const copilotReply = {
-  user: { login: 'copilot-swe-agent' },
-  body: 'Copilot review here',
-  created_at: '2026-07-02T07:22:00Z',
-};
-
-assert('prior not ready without greptile', !chain.priorReviewersReady([coderabbit]).ready);
-assert('prior ready with coderabbit + greptile', chain.priorReviewersReady([coderabbit, greptile]).ready);
-assert('copilot not ready before trigger', !chain.copilotReviewReady([coderabbit, greptile]).ready);
-assert(
-  'copilot ready after reply',
-  chain.copilotReviewReady([coderabbit, greptile, copilotKick, copilotReply]).ready
-);
-assert(
-  'claude not ready before copilot',
-  !chain.claudeFinalReady([coderabbit, greptile]).ready
-);
-assert(
-  'claude ready after full chain',
-  chain.claudeFinalReady([coderabbit, greptile, copilotKick, copilotReply]).ready
-);
-assert(
-  'claude timeout fallback when copilot triggered but silent',
-  chain.claudeFinalReady([coderabbit, greptile, copilotKick], [], { allowCopilotTimeout: true }).ready
-);
-assert(
-  'no timeout fallback without copilot trigger',
-  !chain.claudeFinalReady([coderabbit, greptile], [], { allowCopilotTimeout: true }).ready
-);
-assert(
-  'skipCopilot proceeds after prior reviewers',
-  chain.claudeFinalReady([coderabbit, greptile], [], { skipCopilot: true }).ready
-);
-const prev = process.env.REVIEW_CHAIN_SKIP_COPILOT;
-process.env.REVIEW_CHAIN_SKIP_COPILOT = '1';
-assert(
-  'REVIEW_CHAIN_SKIP_COPILOT env skips copilot',
-  chain.claudeFinalReady([coderabbit, greptile], [], {}).ready
-);
-process.env.REVIEW_CHAIN_SKIP_COPILOT = prev;
-
-const geminiReview = {
-  user: { login: 'gemini-code-assist[bot]' },
-  body: '## Code Review\n\nThis pull request decomposes the large main.py file',
-  submitted_at: '2026-07-03T08:08:00Z',
-};
-assert(
-  'gemini pull review counts as prior reviewer',
-  chain.hasGeminiReview([], [geminiReview])
-);
-assert(
-  'prior ready with gemini review only (no gemini comment)',
-  chain.priorReviewersReady([coderabbit, greptile], [geminiReview], { optionalWaitMs: 0 }).ready
-);
-
-const oldPr = new Date(Date.now() - 31 * 60 * 1000).toISOString();
-assert(
-  'prior not ready without coderabbit before timeout',
-  !chain.priorReviewersReady([greptile], [], { prCreatedAt: new Date().toISOString(), requiredWaitMs: 30 * 60 * 1000 }).ready
-);
-assert(
-  'prior timeout when coderabbit silent after 30m',
-  chain.priorReviewersReady([greptile], [], { prCreatedAt: oldPr, requiredWaitMs: 30 * 60 * 1000 }).ready
-);
-assert(
-  'claude FINAL timeout when required reviewer silent and no prior FINAL',
-  chain.claudeFinalReady([greptile], [], { prCreatedAt: oldPr, requiredWaitMs: 30 * 60 * 1000 }).ready
-);
-assert(
-  'claude FINAL timeout auto-skips copilot without explicit skipCopilot',
-  chain.claudeFinalReady([greptile], [], { prCreatedAt: oldPr, requiredWaitMs: 30 * 60 * 1000 }).copilotSkipped
-);
-const finalClaude = {
-  user: { login: 'github-actions[bot]' },
-  body: '@claude You are the FINAL architecture reviewer for this PR.',
-  created_at: '2026-07-02T07:25:00Z',
-};
-assert(
-  'claude FINAL not re-posted when already triggered',
-  !chain.claudeFinalReady([greptile, finalClaude], [], { prCreatedAt: oldPr, requiredWaitMs: 0 }).ready
-);
-
-process.exit(failed ? 1 : 0);

.github/scripts/pr-review-chain.js

@@ -1,322 +0,0 @@
-/**
- * PR review pipeline: CodeRabbit / Greptile (+ optional Qodo/Gemini) → Claude (FINAL).
- * Copilot step optional — set REVIEW_CHAIN_SKIP_COPILOT=1 or skipCopilot: true to bypass.
- * @see .github/workflows/auto-pr-comment.yml
- */
-
-function isSkipCopilot(options = {}) {
-  if (options.skipCopilot === true) return true;
-  if (options.skipCopilot === false) return false;
-  return process.env.REVIEW_CHAIN_SKIP_COPILOT === '1';
-}
-
-const COPILOT_TRIGGER_LOGINS = new Set(['MervinPraison', 'github-actions[bot]']);
-const CLAUDE_TRIGGER_LOGINS = new Set(['MervinPraison', 'github-actions[bot]']);
-
-const REQUIRED_PRIOR = ['coderabbit', 'greptile'];
-const OPTIONAL_PRIOR = ['qodo', 'gemini'];
-const OPTIONAL_PRIOR_WAIT_MS = 20 * 60 * 1000;
-const REQUIRED_PRIOR_WAIT_MS = 30 * 60 * 1000;
-
-function loginOf(item) {
-  return (item?.user?.login || '').toLowerCase();
-}
-
-function bodyOf(item) {
-  return item?.body || '';
-}
-
-function hasCoderabbitSummary(comments) {
-  return comments.some(
-    (c) =>
-      loginOf(c).includes('coderabbit') &&
-      bodyOf(c).toLowerCase().includes('summarize by coderabbit')
-  );
-}
-
-function hasGreptileReview(comments) {
-  return comments.some((c) => {
-    if (!loginOf(c).includes('greptile')) return false;
-    const body = bodyOf(c);
-    return body.includes('Greptile Summary') || body.includes('<h3>Greptile Summary</h3>') || body.length > 150;
-  });
-}
-
-function hasQodoReview(comments, reviews = []) {
-  if (comments.some((c) => loginOf(c).includes('qodo'))) return true;
-  return reviews.some((r) => loginOf(r).includes('qodo'));
-}
-
-function hasGeminiReview(comments, reviews = []) {
-  if (reviews.some((r) => loginOf(r).includes('gemini'))) return true;
-  return comments.some((c) => {
-    if (loginOf(c).includes('gemini')) return true;
-    const body = bodyOf(c);
-    return (
-      body.includes('Review completed by Gemini CLI') ||
-      body.includes('The fix is ready for review. Please test')
-    );
-  });
-}
-
-const PRIOR_CHECKS = {
-  coderabbit: (comments) => hasCoderabbitSummary(comments),
-  greptile: (comments) => hasGreptileReview(comments),
-  qodo: (comments, reviews) => hasQodoReview(comments, reviews),
-  gemini: (comments, reviews) => hasGeminiReview(comments, reviews),
-};
-
-function priorReviewerStatus(comments, reviews = []) {
-  const status = {};
-  for (const [id, check] of Object.entries(PRIOR_CHECKS)) {
-    status[id] = check(comments, reviews);
-  }
-  return status;
-}
-
-function priorReviewersReady(comments, reviews = [], options = {}) {
-  const waitMs = options.optionalWaitMs ?? OPTIONAL_PRIOR_WAIT_MS;
-  const requiredWaitMs = options.requiredWaitMs ?? REQUIRED_PRIOR_WAIT_MS;
-  const prCreatedAt = options.prCreatedAt || null;
-  const status = priorReviewerStatus(comments, reviews);
-
-  const missingRequired = REQUIRED_PRIOR.filter((id) => !status[id]);
-  if (missingRequired.length) {
-    if (prCreatedAt) {
-      const age = Date.now() - new Date(prCreatedAt).getTime();
-      if (age >= requiredWaitMs) {
-        return {
-          ready: true,
-          reason: `required reviewer timeout (${missingRequired.join(', ')} silent after ${Math.round(requiredWaitMs / 60000)}m)`,
-          status,
-          requiredTimeout: true,
-        };
-      }
-    }
-    return { ready: false, reason: `waiting for ${missingRequired.join(', ')}`, status };
-  }
-
-  const missingOptional = OPTIONAL_PRIOR.filter((id) => !status[id]);
-  if (missingOptional.length && prCreatedAt) {
-    const age = Date.now() - new Date(prCreatedAt).getTime();
-    if (age < waitMs) {
-      return {
-        ready: false,
-        reason: `waiting for optional ${missingOptional.join(', ')} (${Math.round((waitMs - age) / 60000)}m left)`,
-        status,
-      };
-    }
-  }
-
-  return { ready: true, reason: '', status };
-}
-
-function copilotTriggerComment(comments) {
-  return comments.find(
-    (c) =>
-      bodyOf(c).includes('@copilot') &&
-      COPILOT_TRIGGER_LOGINS.has(c.user?.login) &&
-      !bodyOf(c).toLowerCase().includes('@claude')
-  );
-}
-
-function copilotTriggered(comments) {
-  return Boolean(copilotTriggerComment(comments));
-}
-
-function copilotReviewReady(comments, reviews = []) {
-  const trigger = copilotTriggerComment(comments);
-  if (!trigger) {
-    return { ready: false, reason: 'copilot not triggered yet' };
-  }
-  const triggerTime = new Date(trigger.created_at).getTime();
-  const copilotComment = comments.some((c) => {
-    if (c === trigger) return false;
-    if (new Date(c.created_at).getTime() < triggerTime) return false;
-    const login = loginOf(c);
-    return (
-      login.includes('copilot') ||
-      c.user?.login === 'Copilot' ||
-      c.user?.login === 'copilot-swe-agent'
-    );
-  });
-  const copilotReview = reviews.some((r) => {
-    if (new Date(r.submitted_at).getTime() < triggerTime) return false;
-    return loginOf(r).includes('copilot');
-  });
-  if (copilotComment || copilotReview) {
-    return { ready: true, reason: '' };
-  }
-  return { ready: false, reason: 'awaiting copilot review' };
-}
-
-function isFinalClaudeTriggerComment(c) {
-  const body = bodyOf(c).toLowerCase();
-  if (!CLAUDE_TRIGGER_LOGINS.has(c.user?.login)) return false;
-  if (!body.includes('@claude')) return false;
-  if (body.includes('merge conflict')) return false;
-  return body.includes('final architecture reviewer') || body.includes('lead engineer');
-}
-
-function claudeFinalAlreadyTriggered(comments) {
-  return comments.some(isFinalClaudeTriggerComment);
-}
-
-function claudeFinalReady(comments, reviews = [], options = {}) {
-  if (claudeFinalAlreadyTriggered(comments)) {
-    return { ready: false, reason: 'claude FINAL already triggered', already: true };
-  }
-  const prior = priorReviewersReady(comments, reviews, options);
-  if (!prior.ready) {
-    return { ready: false, reason: prior.reason };
-  }
-  if (isSkipCopilot(options) || prior.requiredTimeout) {
-    return {
-      ready: true,
-      reason: prior.requiredTimeout ? prior.reason : 'copilot skipped',
-      copilotSkipped: true,
-      requiredTimeout: prior.requiredTimeout,
-    };
-  }
-  const copilot = copilotReviewReady(comments, reviews);
-  if (copilot.ready) {
-    return { ready: true, reason: '' };
-  }
-  if (options.allowCopilotTimeout && copilotTriggered(comments)) {
-    return { ready: true, reason: 'copilot timeout fallback', copilotSkipped: true };
-  }
-  return { ready: false, reason: copilot.reason };
-}
-
-/** Post @copilot when prior reviewers are ready, then @claude FINAL when Copilot done (or timeout). */
-async function advanceReviewChain(github, owner, repo, prNumber, finalBody, core, options = {}) {
-  const { data: pr } = await github.rest.pulls.get({ owner, repo, pull_number: prNumber });
-  const chainOpts = {
-    prCreatedAt: pr.created_at,
-    optionalWaitMs: options.optionalWaitMs ?? 0,
-  };
-  const copilot = options.skipCopilot
-    ? { triggered: false, reason: 'skipped' }
-    : await maybeTriggerCopilot(github, owner, repo, prNumber, core, chainOpts);
-  const claude = await maybeTriggerClaudeFinal(
-    github, owner, repo, prNumber, finalBody, core,
-    { ...options, ...chainOpts }
-  );
-  return { copilot, claude };
-}
-
-async function maybeTriggerClaudeFinal(github, owner, repo, prNumber, finalBody, core, options = {}) {
-  const { data: pr } = await github.rest.pulls.get({ owner, repo, pull_number: prNumber });
-  const { comments, reviews } = await listCommentsAndReviews(github, owner, repo, prNumber);
-  const gate = claudeFinalReady(comments, reviews, {
-    ...options,
-    prCreatedAt: pr.created_at,
-    optionalWaitMs: options.optionalWaitMs,
-    allowCopilotTimeout: options.allowCopilotTimeout !== false,
-  });
-  if (!gate.ready) {
-    core?.info?.(`PR #${prNumber}: skip Claude FINAL — ${gate.reason}`);
-    return { posted: false, reason: gate.reason };
-  }
-  await github.rest.issues.createComment({
-    owner,
-    repo,
-    issue_number: prNumber,
-    body: finalBody,
-  });
-  const note = gate.requiredTimeout
-    ? ' (required reviewer timeout fallback)'
-    : gate.copilotSkipped
-      ? ' (Copilot timeout fallback)'
-      : '';
-  core?.info?.(`Posted Claude FINAL on PR #${prNumber}${note}`);
-  return { posted: true, reason: '' };
-}
-
-const COPILOT_REVIEW_BODY =
-  '@copilot Do a thorough review of this PR. Read ALL existing reviewer comments above from Qodo, CodeRabbit, Gemini, and Greptile first — incorporate their findings.\n\nReview areas:\n1. **Bloat check**: Are changes minimal and focused? Any unnecessary code or scope creep?\n2. **Security**: Any hardcoded secrets, unsafe eval/exec, missing input validation?\n3. **Performance**: Any module-level heavy imports? Hot-path regressions?\n4. **Tests**: Are tests included? Do they cover the changes adequately?\n5. **Backward compat**: Any public API changes without deprecation?\n6. **Code quality**: DRY violations, naming conventions, error handling?\n7. **Address reviewer feedback**: If Qodo, CodeRabbit, Gemini, or Greptile flagged valid issues, include them in your review\n8. Suggest specific improvements with code examples where possible';
-
-async function listCommentsAndReviews(github, owner, repo, prNumber) {
-  let comments;
-  if (typeof github.paginate === 'function') {
-    comments = await github.paginate(github.rest.issues.listComments, {
-      owner,
-      repo,
-      issue_number: prNumber,
-      per_page: 100,
-    });
-  } else {
-    const { data } = await github.rest.issues.listComments({
-      owner,
-      repo,
-      issue_number: prNumber,
-      per_page: 100,
-    });
-    comments = data;
-  }
-  const { data: reviews } = await github.rest.pulls.listReviews({
-    owner,
-    repo,
-    pull_number: prNumber,
-    per_page: 100,
-  });
-  return { comments, reviews };
-}
-
-async function maybeTriggerCopilot(github, owner, repo, prNumber, core, options = {}) {
-  const { comments, reviews } = await listCommentsAndReviews(github, owner, repo, prNumber);
-  if (copilotTriggered(comments)) {
-    core?.info?.(`Copilot already triggered on PR #${prNumber}`);
-    return { triggered: false, reason: 'already_triggered' };
-  }
-  const prior = priorReviewersReady(comments, reviews, options);
-  if (!prior.ready) {
-    core?.info?.(`PR #${prNumber}: not ready for Copilot — ${prior.reason}`);
-    return { triggered: false, reason: prior.reason };
-  }
-  await github.rest.issues.createComment({
-    owner,
-    repo,
-    issue_number: prNumber,
-    body: COPILOT_REVIEW_BODY,
-  });
-  core?.info?.(`Posted @copilot on PR #${prNumber} after prior reviewers`);
-  return { triggered: true };
-}
-
-async function pollCopilotResponse(github, owner, repo, prNumber, options = {}) {
-  const maxAttempts = options.maxAttempts ?? 20;
-  const delayMs = options.delayMs ?? 30000;
-  for (let i = 0; i < maxAttempts; i += 1) {
-    const { comments, reviews } = await listCommentsAndReviews(github, owner, repo, prNumber);
-    const copilot = copilotReviewReady(comments, reviews);
-    if (copilot.ready) {
-      return { ready: true, reason: '' };
-    }
-    if (i < maxAttempts - 1) {
-      await new Promise((resolve) => setTimeout(resolve, delayMs));
-    }
-  }
-  return { ready: false, reason: 'copilot timeout' };
-}
-
-module.exports = {
-  isSkipCopilot,
-  REQUIRED_PRIOR,
-  OPTIONAL_PRIOR,
-  REQUIRED_PRIOR_WAIT_MS,
-  COPILOT_REVIEW_BODY,
-  priorReviewerStatus,
-  priorReviewersReady,
-  copilotTriggered,
-  copilotReviewReady,
-  claudeFinalReady,
-  claudeFinalAlreadyTriggered,
-  isFinalClaudeTriggerComment,
-  maybeTriggerCopilot,
-  maybeTriggerClaudeFinal,
-  advanceReviewChain,
-  pollCopilotResponse,
-  hasGeminiReview,
-  listCommentsAndReviews,
-};

.github/scripts/release-gate-selftest.js

@@ -1,122 +0,0 @@
-const assert = require('assert');
-const rg = require('./release-gate.js');
-
-assert.strictEqual(rg.bumpPatch('1.6.80'), '1.6.81');
-assert.strictEqual(rg.bumpPatch('4.6.80'), '4.6.81');
-assert.strictEqual(rg.bumpPatch('0.0.2'), '0.0.3');
-
-const versions = rg.readVersionsFromTree();
-assert.ok(versions.currentAgents);
-assert.ok(versions.currentCode);
-assert.ok(versions.currentWrapper);
-assert.ok(versions.targetCode);
-assert.ok(rg.PACKAGE_PATHS.includes('src/praisonai-code'));
-// Every released package must make the gate's path-change check eligible.
-for (const p of [
-  'src/praisonai', 'src/praisonai-agents', 'src/praisonai-code',
-  'src/praisonai-bot', 'src/praisonai-train', 'src/praisonai-browser',
-  'src/praisonai-mcp', 'src/praisonai-sandbox', 'src/praisonai-deploy',
-]) {
-  assert.ok(rg.PACKAGE_PATHS.includes(p), `PACKAGE_PATHS missing ${p}`);
-}
-
-const noonUtc = new Date('2026-07-08T12:00:00Z');
-const dayStart = rg.utcDayStart(noonUtc);
-assert.strictEqual(dayStart.toISOString(), '2026-07-08T00:00:00.000Z');
-
-function mockGithub({ runs = [], releases = [] } = {}) {
-  return {
-    rest: {
-      actions: {
-        listWorkflowRuns: async () => ({ data: { workflow_runs: runs } }),
-      },
-      repos: {
-        listReleases: async () => ({ data: releases }),
-      },
-    },
-  };
-}
-
-(async () => {
-  assert.strictEqual(await rg.pypiVersionExists('praisonaiagents', '0.0.0'), false);
-
-  assert.strictEqual(rg.PATCH_RELEASE_INTERVAL_DAYS, 3);
-
-  // Dedupe is release-based: a v* release inside the window blocks…
-  const recentRelease = mockGithub({
-    releases: [{ tag_name: 'v4.6.159', published_at: '2026-07-08T09:00:00Z' }],
-  });
-  assert.strictEqual(
-    await rg.hasSuccessfulReleaseWithinDays(recentRelease, 'o', 'r', noonUtc),
-    true
-  );
-
-  const result = await rg.evaluateReleasePreflight(
-    recentRelease, 'o', 'r',
-    { headSha: 'abc', isCiTrigger: false, bump: 'patch', now: noonUtc },
-    null
-  );
-  assert.ok(result.reasons.some((r) => r.includes('every 3 days')));
-
-  // …an old release does not…
-  const oldRelease = mockGithub({
-    releases: [{ tag_name: 'v4.6.150', published_at: '2026-07-04T09:00:00Z' }],
-  });
-  assert.strictEqual(
-    await rg.hasSuccessfulReleaseWithinDays(oldRelease, 'o', 'r', noonUtc),
-    false
-  );
-
-  // …and a dry-run "success" (workflow run, no release) does not consume the
-  // window: only real releases count.
-  const dryRunOnly = mockGithub({
-    runs: [{ conclusion: 'success', created_at: '2026-07-08T09:00:00Z', status: 'completed' }],
-    releases: [],
-  });
-  assert.strictEqual(
-    await rg.hasSuccessfulReleaseWithinDays(dryRunOnly, 'o', 'r', noonUtc),
-    false
-  );
-
-  // Active-run blocking: fresh waiting run blocks…
-  const freshWaiting = mockGithub({
-    runs: [{ status: 'waiting', conclusion: null, created_at: '2026-07-08T11:00:00Z', html_url: 'x' }],
-  });
-  assert.strictEqual(
-    await rg.hasActiveReleaseRun(freshWaiting, 'o', 'r', noonUtc, null),
-    true
-  );
-
-  // …a waiting run stuck longer than STALE_WAITING_HOURS no longer blocks…
-  const staleWaiting = mockGithub({
-    runs: [{ status: 'waiting', conclusion: null, created_at: '2026-07-08T01:00:00Z', html_url: 'x' }],
-  });
-  const warnings = [];
-  const fakeCore = { warning: (m) => warnings.push(m), info: () => {} };
-  assert.strictEqual(rg.STALE_WAITING_HOURS, 6);
-  assert.strictEqual(
-    await rg.hasActiveReleaseRun(staleWaiting, 'o', 'r', noonUtc, fakeCore),
-    false
-  );
-  assert.ok(warnings.length === 1 && warnings[0].includes('approve or cancel'));
-
-  // …but an in_progress run always blocks regardless of age.
-  const oldInProgress = mockGithub({
-    runs: [{ status: 'in_progress', conclusion: null, created_at: '2026-07-07T01:00:00Z', html_url: 'x' }],
-  });
-  assert.strictEqual(
-    await rg.hasActiveReleaseRun(oldInProgress, 'o', 'r', noonUtc, null),
-    true
-  );
-
-  console.log('ok: bumpPatch');
-  console.log('ok: readVersionsFromTree');
-  console.log('ok: PACKAGE_PATHS covers all 9 released packages');
-  console.log('ok: pypiVersionExists missing version');
-  console.log('ok: utcDayStart');
-  console.log('ok: release-based dedupe (recent blocks, old does not)');
-  console.log('ok: dry-run success does not consume the release window');
-  console.log('ok: 3-day dedupe blocks second release');
-  console.log('ok: fresh waiting run blocks; stale waiting run ignored with warning');
-  console.log('ok: in_progress always blocks');
-})();

.github/scripts/release-gate.js

@@ -1,315 +0,0 @@
-/**
- * Release gate preflight — path changes, CI SHA, dedupe, PyPI version checks.
- */
-
-const https = require('https');
-
-/** Every directory whose changes should make a release eligible — all nine
- * published packages (mirrors the skip_* inputs in pypi-release.yml). */
-const PACKAGE_PATHS = [
-  'src/praisonai',
-  'src/praisonai-agents',
-  'src/praisonai-code',
-  'src/praisonai-bot',
-  'src/praisonai-train',
-  'src/praisonai-browser',
-  'src/praisonai-mcp',
-  'src/praisonai-sandbox',
-  'src/praisonai-deploy',
-];
-/** Minimum days between successful patch auto-releases. */
-const PATCH_RELEASE_INTERVAL_DAYS = 3;
-const ACTIVE_RELEASE_STATUSES = new Set([
-  'queued', 'in_progress', 'waiting', 'pending', 'requested',
-]);
-/** A run stuck in `waiting` (environment approval) longer than this no longer
- * blocks the gate. GitHub only auto-fails unapproved deployments after 30
- * days, so without a cutoff one forgotten manual dispatch stalls all
- * auto-releases for up to a month. The run is warned about, never cancelled —
- * if later approved, the pypi-release concurrency group serializes it and its
- * pypi_exists checks no-op anything already published. */
-const STALE_WAITING_HOURS = 6;
-
-function bumpPatch(version) {
-  const parts = version.split('.');
-  if (parts.length !== 3) throw new Error(`Invalid version: ${version}`);
-  return `${parts[0]}.${parts[1]}.${Number(parts[2]) + 1}`;
-}
-
-function readVersionsFromTree(root = '.') {
-  const fs = require('fs');
-  const path = require('path');
-  const agentsToml = fs.readFileSync(
-    path.join(root, 'src/praisonai-agents/pyproject.toml'), 'utf8'
-  );
-  const agentsMatch = agentsToml.match(/^version\s*=\s*"([^"]+)"/m);
-  if (!agentsMatch) throw new Error('Could not read agents version');
-
-  const codeToml = fs.readFileSync(
-    path.join(root, 'src/praisonai-code/pyproject.toml'), 'utf8'
-  );
-  const codeMatch = codeToml.match(/^version\s*=\s*"([^"]+)"/m);
-  if (!codeMatch) throw new Error('Could not read praisonai-code version');
-
-  const wrapperPy = fs.readFileSync(
-    path.join(root, 'src/praisonai/praisonai/version.py'), 'utf8'
-  );
-  const wrapperMatch = wrapperPy.match(/__version__ = "([^"]+)"/);
-  if (!wrapperMatch) throw new Error('Could not read wrapper version');
-  return {
-    currentAgents: agentsMatch[1],
-    currentCode: codeMatch[1],
-    currentWrapper: wrapperMatch[1],
-    targetAgents: bumpPatch(agentsMatch[1]),
-    targetCode: bumpPatch(codeMatch[1]),
-    targetWrapper: bumpPatch(wrapperMatch[1]),
-  };
-}
-
-function pypiVersionExists(packageName, version) {
-  return new Promise((resolve) => {
-    const req = https.get(
-      `https://pypi.org/pypi/${packageName}/${version}/json`,
-      { timeout: 15000 },
-      (res) => {
-        res.resume();
-        resolve(res.statusCode === 200);
-      }
-    );
-    req.on('error', () => resolve(false));
-    req.on('timeout', () => {
-      req.destroy();
-      resolve(false);
-    });
-  });
-}
-
-async function hasActiveReleaseRun(github, owner, repo, now = new Date(), core = null) {
-  const runs = await github.rest.actions.listWorkflowRuns({
-    owner,
-    repo,
-    workflow_id: 'pypi-release.yml',
-    per_page: 20,
-  });
-  const staleCutoff = now.getTime() - STALE_WAITING_HOURS * 60 * 60 * 1000;
-  return runs.data.workflow_runs.some((r) => {
-    if (!ACTIVE_RELEASE_STATUSES.has(r.status) || r.conclusion) return false;
-    if (r.status === 'waiting' && new Date(r.created_at).getTime() < staleCutoff) {
-      if (core) {
-        core.warning(
-          `Ignoring release run waiting >${STALE_WAITING_HOURS}h for environment approval: `
-          + `${r.html_url} — approve or cancel it. It no longer blocks auto-releases.`
-        );
-      }
-      return false;
-    }
-    return true;
-  });
-}
-
-function utcDayStart(now = new Date()) {
-  return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
-}
-
-function releaseIntervalStart(now = new Date(), intervalDays = PATCH_RELEASE_INTERVAL_DAYS) {
-  return new Date(now.getTime() - intervalDays * 24 * 60 * 60 * 1000);
-}
-
-async function hasSuccessfulReleaseWithinDays(
-  github,
-  owner,
-  repo,
-  now = new Date(),
-  intervalDays = PATCH_RELEASE_INTERVAL_DAYS,
-) {
-  const windowStart = releaseIntervalStart(now, intervalDays);
-  // Dedupe on GitHub releases (v* tags) rather than run conclusions: a
-  // dry_run=true dispatch concludes 'success' without publishing anything and
-  // must not consume the release window. Only a real full release creates a
-  // v* GitHub release (bump_and_release.py's `gh release create`).
-  const releases = await github.rest.repos.listReleases({
-    owner,
-    repo,
-    per_page: 10,
-  });
-  return releases.data.some(
-    (r) => r.tag_name && r.tag_name.startsWith('v')
-      && new Date(r.published_at || r.created_at) >= windowStart
-  );
-}
-
-/** @deprecated Use hasSuccessfulReleaseWithinDays — kept for selftests. */
-async function hasSuccessfulReleaseToday(github, owner, repo, now = new Date()) {
-  return hasSuccessfulReleaseWithinDays(github, owner, repo, now, 1);
-}
-
-async function lastGreenCoreTestsSha(github, owner, repo) {
-  const runs = await github.rest.actions.listWorkflowRuns({
-    owner,
-    repo,
-    workflow_id: 'test-core.yml',
-    branch: 'main',
-    status: 'completed',
-    per_page: 30,
-  });
-  const hit = runs.data.workflow_runs.find((r) => r.conclusion === 'success');
-  return hit ? hit.head_sha : '';
-}
-
-async function evaluateReleasePreflight(github, owner, repo, options, core) {
-  const {
-    headSha,
-    isCiTrigger = false,
-    bump = 'patch',
-  } = options;
-
-  const reasons = [];
-  const out = {
-    ready: false,
-    reasons,
-    headSha: headSha || '',
-    lastTag: '',
-    targetAgents: '',
-    targetCode: '',
-    targetWrapper: '',
-  };
-
-  if (bump !== 'patch') {
-    reasons.push('only patch auto-release supported');
-    return out;
-  }
-
-  const referenceTime = options.now instanceof Date ? options.now : new Date();
-
-  if (await hasActiveReleaseRun(github, owner, repo, referenceTime, core)) {
-    reasons.push('PyPI Release already in progress or awaiting approval');
-    return out;
-  }
-
-  if (await hasSuccessfulReleaseWithinDays(github, owner, repo, referenceTime)) {
-    reasons.push(
-      `already released within last ${PATCH_RELEASE_INTERVAL_DAYS} days; `
-      + `max one patch release every ${PATCH_RELEASE_INTERVAL_DAYS} days`
-    );
-    return out;
-  }
-
-  let versions;
-  try {
-    versions = readVersionsFromTree();
-  } catch (err) {
-    reasons.push(err.message);
-    return out;
-  }
-  out.targetAgents = versions.targetAgents;
-  out.targetCode = versions.targetCode;
-  out.targetWrapper = versions.targetWrapper;
-
-  const agentsOnPypi = await pypiVersionExists('praisonaiagents', versions.targetAgents);
-  const codeOnPypi = await pypiVersionExists('praisonai-code', versions.targetCode);
-  const wrapperOnPypi = await pypiVersionExists('praisonai', versions.targetWrapper);
-  if (agentsOnPypi && codeOnPypi && wrapperOnPypi) {
-    reasons.push(
-      `already published: praisonaiagents==${versions.targetAgents}, `
-      + `praisonai-code==${versions.targetCode}, praisonai==${versions.targetWrapper}`
-    );
-    return out;
-  }
-
-  const { execSync } = require('child_process');
-  let lastTag = '';
-  try {
-    lastTag = execSync('git describe --tags --match "v*" --abbrev=0', { encoding: 'utf8' }).trim();
-  } catch {
-    reasons.push('no v* tag found');
-    return out;
-  }
-  out.lastTag = lastTag;
-
-  let changed = '';
-  try {
-    changed = execSync(
-      `git diff --name-only ${lastTag} HEAD -- ${PACKAGE_PATHS.join(' ')}`,
-      { encoding: 'utf8' }
-    ).trim();
-  } catch {
-    reasons.push('git diff failed');
-    return out;
-  }
-
-  if (!changed) {
-    reasons.push(`no changes in ${PACKAGE_PATHS.join(' or ')} since ${lastTag}`);
-    return out;
-  }
-
-  if (isCiTrigger) {
-    let mainSha = '';
-    try {
-      mainSha = execSync('git rev-parse origin/main', { encoding: 'utf8' }).trim();
-    } catch {
-      reasons.push('could not resolve origin/main');
-      return out;
-    }
-    if (headSha !== mainSha) {
-      reasons.push(`superseded: green SHA ${headSha.slice(0, 7)} != main ${mainSha.slice(0, 7)}`);
-      return out;
-    }
-    out.headSha = headSha;
-  } else {
-    const evalSha = execSync('git rev-parse HEAD', { encoding: 'utf8' }).trim();
-    out.headSha = evalSha;
-    const greenSha = await lastGreenCoreTestsSha(github, owner, repo);
-    if (greenSha !== evalSha) {
-      // Core Tests has path filters and honors [skip ci] (the release
-      // safety-net commit uses it), so the tip of main may legitimately have
-      // no Core Tests run of its own — e.g. a docs-only commit, or the
-      // "chore(release): … [skip ci]" commit right after a release. Accept a
-      // green ancestor when nothing under the released package paths changed
-      // after it; otherwise the cron path stalls until the next src/** push.
-      let greenAncestorOk = false;
-      if (greenSha && /^[0-9a-f]{40}$/.test(greenSha)) {
-        try {
-          execSync(`git merge-base --is-ancestor ${greenSha} ${evalSha}`);
-          const delta = execSync(
-            `git diff --name-only ${greenSha} ${evalSha} -- ${PACKAGE_PATHS.join(' ')}`,
-            { encoding: 'utf8' }
-          ).trim();
-          greenAncestorOk = delta === '';
-        } catch {
-          greenAncestorOk = false;
-        }
-      }
-      if (!greenAncestorOk) {
-        reasons.push(`CI not green on HEAD (last green: ${greenSha ? greenSha.slice(0, 7) : 'none'})`);
-        return out;
-      }
-      if (core) {
-        core.info(
-          `HEAD ${evalSha.slice(0, 7)} has no Core Tests run; accepting green ancestor `
-          + `${greenSha.slice(0, 7)} (no package-path changes since).`
-        );
-      }
-    }
-  }
-
-  out.ready = true;
-  out.reasons = ['ready'];
-  if (core) core.info(`Release preflight passed for ${out.headSha || headSha}`);
-  return out;
-}
-
-module.exports = {
-  bumpPatch,
-  readVersionsFromTree,
-  pypiVersionExists,
-  PATCH_RELEASE_INTERVAL_DAYS,
-  STALE_WAITING_HOURS,
-  releaseIntervalStart,
-  hasActiveReleaseRun,
-  hasSuccessfulReleaseWithinDays,
-  hasSuccessfulReleaseToday,
-  utcDayStart,
-  evaluateReleasePreflight,
-  ACTIVE_RELEASE_STATUSES,
-  PACKAGE_PATHS,
-};

.github/triage-context.md

@@ -1,3 +0,0 @@
-# GitHub Issue #1350: Add debug log on successful branch checkout
-
-The github_create_branch function in src/praisonai-agents/praisonaiagents/tools/github_tools.py should call logger.debug after a successful checkout.

.github/workflows/auto-issue-comment.yml

@@ -1,46 +1,26 @@
-name: Auto Issue Comment
+name: Auto Issue Comment with PR Creation
 
 on:
-  workflow_dispatch:
-#   issues:
-#     types: [opened]
+  issues:
+    types: [opened]
 
 jobs:
-  # Trigger Claude by adding the 'claude' label (only if not already labeled)
-  # Note: @claude in comments only works from human users (not bots)
-  # The claude.yml workflow listens for issues:labeled event with 'claude' label
-  trigger-claude:
-    # Skip if issue was already created with 'claude' label to avoid double-trigger
-    if: |
-      !contains(toJSON(github.event.issue.labels), 'claude')
+  add-comment:
     runs-on: ubuntu-latest
     permissions:
       issues: write
+      contents: write
+      pull-requests: write
+      actions: read
     steps:
-      - name: Add claude label to trigger analysis
+      - name: Add automated comment
         uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.GH_TOKEN }}
           script: |
-            // Check if 'claude' label already exists on this issue
-            const labels = context.payload.issue.labels.map(l => l.name);
-            if (labels.includes('claude')) {
-              console.log('Issue already has claude label, skipping');
-              return;
-            }
-
-            // Add label to trigger claude.yml via issues:labeled event
-            await github.rest.issues.addLabels({
+            github.rest.issues.createComment({
               issue_number: context.issue.number,
               owner: context.repo.owner,
               repo: context.repo.repo,
-              labels: ['claude']
-            });
-
-            // Also post instructions as a comment for context
-            await github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: '🤖 Auto-triaging with Claude. Analyzing issue and implementing a fix...\n\nClaude will:\n1. Route correctly: TypeScript → src/praisonai-ts/; agent tools → PraisonAI-Tools; lifecycle plugins → PraisonAI-Plugins\n2. Search codebase for root cause\n3. Implement a minimal fix following AGENTS.md\n4. Create a PR with the changes'
-            });
+              body: '@claude review this issue and do a detailed analysis and fix this if the existing code doesn\'t have the solution implemented. Making sure it has backward compatibility, no existing features removed. After making those changes, again review the applied changes. Use @web to search if you dont know any information or to find the latest documentation or to find the latest version. Run the code if you think you need to run it to test it. Minimal code change to start with if required any changes. MAINLY IT SHOULD NOT IMPACT ON THE CURRENT SPEED OF EXECUTION of existing features, not increasing the overhead. **Please create a PR using gh tool with your changes**.'
+            })

.github/workflows/auto-pr-comment.yml

@@ -1,294 +1,23 @@
 name: Auto PR Comment
 
-# Review chain: CodeRabbit + Greptile (+ optional Qodo/Gemini) → Claude (FINAL)
-# Copilot disabled (REVIEW_CHAIN_SKIP_COPILOT=1) — re-enable copilot-* jobs to restore.
-# Fork PR jobs use pull_request_target so GH_TOKEN is available for comments.
-#
-# Claude trigger runs IN-BAND (same workflow) to avoid GitHub Actions
-# blocking bot-triggered workflows with action_required approval gates.
 on:
-  issue_comment:
-    types: [created]
-  pull_request_review:
-    types: [submitted]
   pull_request:
-    types: [opened, synchronize]
-  pull_request_target:
-    types: [opened, synchronize]
-  schedule:
-    - cron: '30 3,9,15,21 * * *'
-  workflow_dispatch:
-
-env:
-  REVIEW_CHAIN_SKIP_COPILOT: '1'
-  MAX_POLL_ATTEMPTS: 20
-  POLL_DELAY_MS: 30000
-  CLAUDE_TRIGGER_LOGINS: '["MervinPraison","github-actions[bot]"]'
+    types: [opened]
 
 jobs:
-  # ================================================================
-  # Claude FINAL after CodeRabbit / Greptile / optional Qodo / Gemini
-  # ================================================================
-  claude-after-prior-reviewers:
-    if: |
-      (github.event_name == 'issue_comment' &&
-       github.event.issue.pull_request &&
-       (
-         github.event.comment.user.login == 'coderabbitai[bot]' ||
-         github.event.comment.user.login == 'greptile-apps[bot]' ||
-         contains(github.event.comment.user.login, 'gemini-code-assist') ||
-         contains(github.event.comment.user.login, 'qodo-code-review')
-       )) ||
-      (github.event_name == 'pull_request_review' &&
-       contains(github.event.review.user.login, 'qodo-code-review'))
-    runs-on: ubuntu-latest
-    permissions:
-      issues: write
-      pull-requests: read
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-
-      - name: Post Claude FINAL after prior reviewers
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.GH_TOKEN }}
-          script: |
-            const path = require('path');
-            const chain = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/pr-review-chain.js'));
-            const mergeGate = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/merge-gate.js'));
-            const ps = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/pipeline-status.js'));
-            const prNumber =
-              context.payload.issue?.number ||
-              context.payload.pull_request?.number;
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-            const { data: pr } = await github.rest.pulls.get({
-              owner, repo, pull_number: prNumber,
-            });
-            const result = await chain.maybeTriggerClaudeFinal(
-              github, owner, repo, prNumber,
-              mergeGate.FINAL_CLAUDE_REVIEW_BODY, core,
-              { skipCopilot: true, optionalWaitMs: 0, prCreatedAt: pr.created_at }
-            );
-            if (result.posted) core.info(`Posted Claude FINAL on PR #${prNumber}`);
-            await ps.ensurePipelineLabels(github, owner, repo, core);
-            await ps.syncPipelineLabels(github, owner, repo, prNumber, core);
-
-  # ================================================================
-  # FALLBACK: Claude FINAL after PR open if reviewers are slow
-  # ================================================================
-  claude-fallback-timeout:
-    if: |
-      github.event_name == 'pull_request_target' &&
-      github.event.action == 'opened'
-    runs-on: ubuntu-latest
-    timeout-minutes: 45
-    permissions:
-      issues: write
-      pull-requests: read
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Wait for prior reviewers (30 min)
-        run: sleep 1800
-
-      - name: Post Claude FINAL (skip Copilot)
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.GH_TOKEN }}
-          script: |
-            const path = require('path');
-            const chain = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/pr-review-chain.js'));
-            const mergeGate = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/merge-gate.js'));
-            const pr = context.payload.pull_request.number;
-            await chain.maybeTriggerClaudeFinal(
-              github, context.repo.owner, context.repo.repo, pr,
-              mergeGate.FINAL_CLAUDE_REVIEW_BODY, core,
-              { skipCopilot: true, optionalWaitMs: 0 }
-            );
-
-  # ================================================================
-  # Recovery: post FINAL @claude after push or when chain missed
-  # ================================================================
-  claude-review-recovery:
-    if: |
-      github.event_name == 'pull_request_target' &&
-      github.event.action == 'synchronize'
-    runs-on: ubuntu-latest
-    permissions:
-      issues: write
-      pull-requests: read
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Re-post FINAL Claude review when stale or missing
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.GH_TOKEN }}
-          script: |
-            const path = require('path');
-            const mergeGate = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/merge-gate.js'));
-            const chain = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/pr-review-chain.js'));
-            const pr = context.payload.pull_request.number;
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-
-            const comments = await mergeGate.listAllComments(github, owner, repo, pr);
-            const headPushedAt = (await mergeGate.getHeadCommitDate(github, owner, repo, pr))
-              || context.payload.pull_request.updated_at;
-            const headPusher = context.payload.sender?.login || null;
-
-            const hasFinal = mergeGate.hasFinalClaudeReviewTrigger(comments);
-            const isStale = mergeGate.isStaleFinalAfterPush(comments, headPushedAt);
-
-            if (mergeGate.shouldSkipFinalRecovery(comments, headPushedAt)) {
-              core.info('Recent @claude within 35min and FINAL not stale — skip recovery');
-              return;
-            }
-
-            if (await mergeGate.hasInProgressClaudeAssistant(github, owner, repo, pr)) {
-              core.info('Claude workflow in progress — skip recovery');
-              return;
-            }
-
-            const finalBody = mergeGate.FINAL_CLAUDE_REVIEW_BODY;
-            const opts = { skipCopilot: true, optionalWaitMs: 0 };
-
-            if (hasFinal && isStale) {
-              const gate = mergeGate.shouldSkipStaleFinalRecovery(comments, headPushedAt, headPusher);
-              if (gate.skip) {
-                core.info(`Skip stale-FINAL recovery: ${gate.reason}`);
-                return;
-              }
-              const result = await chain.maybeTriggerClaudeFinal(
-                github, owner, repo, pr, finalBody, core, opts
-              );
-              if (result.posted) core.info(`Posted stale-FINAL recovery @claude on PR #${pr}`);
-              return;
-            }
-
-            if (hasFinal) {
-              core.info('FINAL Claude review current on HEAD — skip recovery');
-              return;
-            }
-
-            const result = await chain.maybeTriggerClaudeFinal(
-              github, owner, repo, pr, finalBody, core, opts
-            );
-            if (result.posted) core.info(`Posted missing FINAL Claude review on PR #${pr}`);
-
-      - name: Sync pipeline status labels
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.GH_TOKEN }}
-          script: |
-            const path = require('path');
-            const ps = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/pipeline-status.js'));
-            const pr = context.payload.pull_request.number;
-            await ps.ensurePipelineLabels(github, context.repo.owner, context.repo.repo, core);
-            await ps.syncPipelineLabels(github, context.repo.owner, context.repo.repo, pr, core);
-
-  # Scheduled + manual: post missing or stale FINAL @claude on all open PRs (incl. forks)
-  post-missing-claude-final:
-    if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
-    runs-on: ubuntu-latest
-    permissions:
-      issues: write
-      pull-requests: read
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Post missing/stale FINAL @claude on open PRs
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.GH_TOKEN }}
-          script: |
-            const path = require('path');
-            const mergeGate = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/merge-gate.js'));
-            const chain = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/pr-review-chain.js'));
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-            const prs = await github.paginate(github.rest.pulls.list, {
-              owner, repo, state: 'open', per_page: 100,
-            });
-            let posted = 0;
-            for (const pr of prs) {
-              if (pr.draft) continue;
-              const comments = await mergeGate.listAllComments(github, owner, repo, pr.number);
-              const headPushedAt = (await mergeGate.getHeadCommitDate(github, owner, repo, pr.number)) || pr.updated_at;
-              const hasFinal = mergeGate.hasFinalClaudeReviewTrigger(comments);
-              const isStale = mergeGate.isStaleFinalAfterPush(comments, headPushedAt);
-
-              if (hasFinal && !isStale) continue;
-              if (mergeGate.hasRecentClaudeTrigger(comments, 10)) {
-                core.info(`PR #${pr.number}: @claude within 10min — skip`);
-                continue;
-              }
-              if (await mergeGate.hasInProgressClaudeAssistant(github, owner, repo, pr.number)) {
-                core.info(`PR #${pr.number}: Claude in progress — skip`);
-                continue;
-              }
-              if (hasFinal && isStale) {
-                const gate = mergeGate.shouldSkipStaleFinalRecovery(comments, headPushedAt);
-                if (gate.skip) {
-                  core.info(`PR #${pr.number}: skip stale — ${gate.reason}`);
-                  continue;
-                }
-              }
-
-              const result = await chain.maybeTriggerClaudeFinal(
-                github, owner, repo, pr.number,
-                mergeGate.FINAL_CLAUDE_REVIEW_BODY, core,
-                { skipCopilot: true, optionalWaitMs: 0 }
-              );
-              if (result.posted) {
-                posted++;
-                core.info(`Posted Claude FINAL on PR #${pr.number}`);
-              }
-              if (posted >= 10) break;
-            }
-            core.info(`Missing/stale Claude FINAL sweep complete (${posted} posted)`);
-
-  # ================================================================
-  # BOT PRs: kick CodeRabbit + Qodo (Greptile may follow on its own)
-  # ================================================================
-  bot-pr-trigger-reviews:
-    if: |
-      github.event_name == 'pull_request' &&
-      github.event.action == 'opened' &&
-      (
-        github.event.pull_request.user.login == 'github-actions[bot]' ||
-        github.event.pull_request.user.login == 'praisonai-triage-agent[bot]' ||
-        github.event.pull_request.user.type == 'Bot'
-      )
+  add-comment:
     runs-on: ubuntu-latest
     permissions:
       pull-requests: write
-      issues: write
     steps:
-      - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-
-      - name: Trigger CodeRabbit and Qodo reviews
+      - name: Add automated comment
         uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.GH_TOKEN }}
           script: |
-            const path = require('path');
-            const chain = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/bot-pr-review-chain.js'));
-            const pr = context.payload.pull_request.number;
-            await chain.kickReviewChain(github, context.repo.owner, context.repo.repo, pr, core);
-
-      - name: Sync pipeline status labels
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.GH_TOKEN }}
-          script: |
-            const path = require('path');
-            const ps = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/pipeline-status.js'));
-            const pr = context.payload.pull_request.number;
-            await ps.ensurePipelineLabels(github, context.repo.owner, context.repo.repo, core);
-            await ps.syncPipelineLabels(github, context.repo.owner, context.repo.repo, pr, core);
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '@claude review this pull request and do a detailed analysis and fix this if the existing code doesn\'t have the solution implemented. Making sure it has backward compatibility, no existing features removed. After making those changes, again review the applied changes. Use @web to search if you dont know any information or to find the latest documentation or to find the latest version. Run the code if you think you need to run it to test it. Minimal code change to start with if required any changes. MAINLY IT SHOULD NOT IMPACT ON THE CURRENT SPEED OF EXECUTION of existing features, not increasing the overhead.'
+            }) 

.github/workflows/benchmark.yml

@@ -20,8 +20,6 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
-        with:
-          persist-credentials: false
 
       - name: Set up Python 3.12
         uses: actions/setup-python@v5
@@ -37,8 +35,6 @@ jobs:
 
       - name: Run Import Time Benchmark
         id: import_time
-        env:
-          FAIL_ON_REGRESSION: ${{ inputs.fail_on_regression }}
         run: |
           cd src/praisonai-agents
           python benchmarks/import_time.py 2>&1 | tee import_time_output.txt
@@ -50,7 +46,7 @@ jobs:
           # Check threshold (200ms)
           if (( $(echo "$IMPORT_TIME > 200" | bc -l) )); then
             echo "::warning::Import time ${IMPORT_TIME}ms exceeds 200ms threshold"
-            if [ "$FAIL_ON_REGRESSION" == "true" ]; then
+            if [ "${{ inputs.fail_on_regression }}" == "true" ]; then
               echo "import_passed=false" >> $GITHUB_OUTPUT
             fi
           else
@@ -59,8 +55,6 @@ jobs:
 
       - name: Run Memory Usage Benchmark
         id: memory
-        env:
-          FAIL_ON_REGRESSION: ${{ inputs.fail_on_regression }}
         run: |
           cd src/praisonai-agents
           python benchmarks/memory_usage.py 2>&1 | tee memory_output.txt
@@ -72,7 +66,7 @@ jobs:
           # Check threshold (30MB)
           if (( $(echo "$PEAK_MEMORY > 30" | bc -l) )); then
             echo "::warning::Memory usage ${PEAK_MEMORY}MB exceeds 30MB threshold"
-            if [ "$FAIL_ON_REGRESSION" == "true" ]; then
+            if [ "${{ inputs.fail_on_regression }}" == "true" ]; then
               echo "memory_passed=false" >> $GITHUB_OUTPUT
             fi
           else
@@ -101,11 +95,9 @@ jobs:
 
       - name: Run Parameter Impact Benchmark
         id: param_impact
-        env:
-          INPUT_ITERATIONS: ${{ inputs.iterations }}
         run: |
           cd src/praisonai-agents
-          python benchmarks/param_impact_benchmark.py --no-save --iterations "$INPUT_ITERATIONS" 2>&1 | tee param_impact_output.txt
+          python benchmarks/param_impact_benchmark.py --no-save --iterations ${{ inputs.iterations }} 2>&1 | tee param_impact_output.txt
 
       - name: Check Lazy Imports
         id: lazy_imports

.github/workflows/bot-pr-recovery.yml

@@ -1,43 +0,0 @@
-name: Bot PR Recovery
-
-# Belt-and-braces: kick CodeRabbit/Qodo when pull_request:opened never fired for bot PRs.
-
-on:
-  schedule:
-    - cron: '*/15 * * * *'
-  workflow_dispatch:
-    inputs:
-      pr_number:
-        description: 'Specific PR number to kick (optional)'
-        required: false
-        type: string
-
-permissions:
-  pull-requests: write
-  issues: write
-
-jobs:
-  recover:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-
-      - name: Find and kick stalled bot PRs
-        uses: actions/github-script@v7
-        env:
-          PR_NUMBER_INPUT: ${{ github.event.inputs.pr_number }}
-        with:
-          github-token: ${{ secrets.GH_TOKEN }}
-          script: |
-            const path = require('path');
-            const chain = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/bot-pr-review-chain.js'));
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-            const manual = (process.env.PR_NUMBER_INPUT || '').trim();
-            const prNumber = manual ? parseInt(manual, 10) : null;
-            if (manual && Number.isNaN(prNumber)) {
-              throw new Error(`Invalid pr_number: ${manual}`);
-            }
-            await chain.recoverStalledBotPrs(github, owner, repo, { prNumber }, core);

.github/workflows/build-image.yml

@@ -18,8 +18,6 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
-        with:
-          persist-credentials: false
 
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3

.github/workflows/ci-failure-claude.yml

@@ -1,102 +0,0 @@
-name: Auto CI Failure → Claude
-
-# Detects internal PRs with failing CI and posts @claude with extracted failure details.
-
-on:
-  workflow_run:
-    workflows: [Core Tests, Optimized Test Suite]
-    types: [completed]
-  pull_request:
-    types: [opened, synchronize, reopened]
-  workflow_dispatch:
-    inputs:
-      pr_number:
-        description: 'Optional PR number to process (default: scan blocked PRs)'
-        required: false
-        type: string
-  schedule:
-    - cron: '15 */6 * * *'
-
-concurrency:
-  group: ci-failure-scan-${{ github.repository }}-${{ github.event.pull_request.number || github.event.workflow_run.id || github.run_id }}
-  cancel-in-progress: true
-
-env:
-  # PAT posts as MervinPraison so issue_comment triggers claude.yml (GITHUB_TOKEN cannot chain workflows)
-  GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
-
-permissions:
-  pull-requests: read
-  issues: write
-  actions: read
-
-jobs:
-  detect-and-trigger:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-
-      - name: Detect CI failures and trigger Claude
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ env.GH_TOKEN }}
-          script: |
-            const path = require('path');
-            const ciFix = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/ci-failure-claude.js'));
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-            const baseRepo = `${owner}/${repo}`;
-
-            async function processPR(prNumber) {
-              return ciFix.maybeTriggerCiFixClaude(github, owner, repo, prNumber, core);
-            }
-
-            let results = [];
-
-            if (context.eventName === 'workflow_run') {
-              const wr = context.payload.workflow_run;
-              const result = await ciFix.processWorkflowRunFailure(
-                github, owner, repo, wr, core
-              );
-              results.push({ event: 'workflow_run', workflow: wr.name, ...result });
-            } else if (context.eventName === 'pull_request') {
-              results.push({
-                pr: context.payload.pull_request.number,
-                ...(await processPR(context.payload.pull_request.number)),
-              });
-            } else {
-              let prNumbers = [];
-              if (context.eventName === 'workflow_dispatch' && context.payload.inputs?.pr_number) {
-                prNumbers = [Number(context.payload.inputs.pr_number)];
-              } else {
-                const prs = await github.paginate(github.rest.pulls.list, {
-                  owner,
-                  repo,
-                  state: 'open',
-                  per_page: 100,
-                });
-                for (const pr of prs) {
-                  if (pr.draft) continue;
-                  const headRepo = pr.head?.repo?.full_name;
-                  if (headRepo && headRepo !== baseRepo) continue;
-                  const { data: issue } = await github.rest.issues.get({
-                    owner,
-                    repo,
-                    issue_number: pr.number,
-                  });
-                  const labels = issue.labels.map((l) => l.name);
-                  if (labels.includes('pipeline/blocked:ci') || labels.includes(ciFix.CI_FIX_LABEL)) {
-                    prNumbers.push(pr.number);
-                  }
-                }
-              }
-
-              for (const num of prNumbers) {
-                results.push({ pr: num, ...(await processPR(num)) });
-              }
-            }
-
-            core.summary.addRaw('```json\n' + JSON.stringify(results, null, 2) + '\n```');
-            await core.summary.write();

.github/workflows/claude-issue-triage.yml

@@ -2,9 +2,8 @@ name: Claude Issue Triage
 description: "Automatically triage GitHub issues using Claude Code"
 
 on:
-  workflow_dispatch:
-#   issues:
-#     types: [opened]
+  issues:
+    types: [opened]
 
 jobs:
   triage-issue:
@@ -13,23 +12,12 @@ jobs:
     permissions:
       contents: read
       issues: write
-      id-token: write
     steps:
-      - name: Generate GitHub App Token
-        id: app-token
-        uses: actions/create-github-app-token@v1
-        with:
-          app-id: ${{ secrets.CLAUDE_APP_ID }}
-          private-key: ${{ secrets.CLAUDE_APP_PRIVATE_KEY }}
-          owner: ${{ github.repository_owner }}
-
       - name: Checkout repository
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683  # v4
-        with:
-          token: ${{ steps.app-token.outputs.token }}
 
       - name: Run Claude Issue Triage
         uses: ./.github/actions/claude-issue-triage-action
         with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          github_token: ${{ steps.app-token.outputs.token }} 
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          github_token: ${{ secrets.GITHUB_TOKEN }} 

.github/workflows/claude-merge-gate.yml

@@ -1,627 +0,0 @@
-name: Claude PR Merge Gate
-
-# Read-only Claude assesses merge readiness; GH_TOKEN merges (no @claude, no gh pr review).
-# Does not overlap with merge-conflict-claude.yml or auto-pr-comment @claude chains.
-
-on:
-  schedule:
-    # Scan for merge-ready PRs every 10 minutes (assess runs only when candidates exist).
-    - cron: '*/10 * * * *'
-  workflow_dispatch:
-    inputs:
-      pr_number:
-        description: 'Optional PR number (scan all open internal PRs if empty)'
-        required: false
-        type: string
-      merge_method:
-        description: 'Merge method'
-        required: false
-        type: choice
-        default: merge
-        options:
-          - merge
-          - squash
-          - rebase
-  workflow_run:
-    workflows:
-      - Claude Assistant
-      - Core Tests
-    types:
-      - completed
-  repository_dispatch:
-    types:
-      - claude-merge-gate
-
-concurrency:
-  # Serialize workflow_run auto-dispatches (Core Tests / Claude Assistant fan-out).
-  group: claude-merge-gate-${{ github.repository }}-${{ github.event.inputs.pr_number || github.event.client_payload.pr_number || (github.event_name == 'workflow_run' && 'auto-dispatch') || 'scan' }}
-  cancel-in-progress: false
-
-env:
-  GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
-  MAX_CANDIDATES: 3
-  DISPATCH_PR_NUMBER: ${{ github.event.inputs.pr_number || github.event.client_payload.pr_number || '' }}
-
-permissions:
-  contents: read
-  pull-requests: read
-  issues: read
-  actions: read
-
-jobs:
-  auto-dispatch:
-    if: github.event_name == 'workflow_run'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pull-requests: read
-      issues: read
-      actions: write
-      id-token: write
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Generate GitHub App token
-        id: app-token
-        uses: actions/create-github-app-token@v1
-        with:
-          app-id: ${{ secrets.CLAUDE_APP_ID }}
-          private-key: ${{ secrets.CLAUDE_APP_PRIVATE_KEY }}
-          owner: ${{ github.repository_owner }}
-
-      - name: Dispatch merge gate when PR pipeline is ready
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const path = require('path');
-            const mergeGate = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/merge-gate.js'));
-            const wr = context.payload.workflow_run;
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-
-            if (wr.conclusion !== 'success') {
-              core.info(`Skip dispatch: ${wr.name} conclusion=${wr.conclusion}`);
-              return;
-            }
-            const allowed = ['Claude Assistant', 'Core Tests'];
-            if (!allowed.includes(wr.name)) {
-              core.info(`Skip dispatch: workflow ${wr.name}`);
-              return;
-            }
-
-            const prNumber = await mergeGate.resolvePrNumberFromWorkflowRun(github, owner, repo, wr);
-            if (!prNumber) {
-              core.info('Skip dispatch: could not resolve PR from workflow run');
-              return;
-            }
-
-            const fromClaude = wr.name === 'Claude Assistant';
-            const check = await mergeGate.evaluatePipelineQuiescent(
-              github, owner, repo, prNumber, core, {
-                skipGlobalClaudeRunCheck: fromClaude,
-                skipRecentClaudeCooldown: fromClaude,
-              }
-            );
-            if (!check.ready) {
-              core.info(`PR #${prNumber} not ready: ${check.reasons.join(', ')}`);
-              return;
-            }
-
-            if (await mergeGate.shouldSkipMergeGateDispatch(github, owner, repo, prNumber, core)) {
-              return;
-            }
-
-            await github.rest.repos.createDispatchEvent({
-              owner,
-              repo,
-              event_type: 'claude-merge-gate',
-              client_payload: { pr_number: prNumber },
-            });
-            core.info(`Dispatched merge gate for PR #${prNumber} after ${wr.name}`);
-
-  scan-candidates:
-    if: github.event_name != 'workflow_run'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pull-requests: read
-      issues: write
-      actions: read
-      id-token: write
-    outputs:
-      matrix: ${{ steps.scan.outputs.matrix }}
-      has_candidates: ${{ steps.scan.outputs.has_candidates }}
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Generate GitHub App token
-        id: app-token
-        uses: actions/create-github-app-token@v1
-        with:
-          app-id: ${{ secrets.CLAUDE_APP_ID }}
-          private-key: ${{ secrets.CLAUDE_APP_PRIVATE_KEY }}
-          owner: ${{ github.repository_owner }}
-
-      - name: Scan open PRs for merge gate eligibility
-        id: scan
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const path = require('path');
-            const mergeGate = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/merge-gate.js'));
-            const ps = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/pipeline-status.js'));
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-            const maxCandidates = parseInt(process.env.MAX_CANDIDATES || '5', 10);
-            const inputPr = String(process.env.DISPATCH_PR_NUMBER || '').trim();
-
-            const candidates = [];
-            const skipped = [];
-
-            if (inputPr) {
-              const n = parseInt(inputPr, 10);
-              if (Number.isNaN(n)) {
-                throw new Error(`Invalid pr_number input: ${inputPr}`);
-              }
-              const result = await mergeGate.evaluatePipelineQuiescent(github, owner, repo, n, core);
-              if (result.ready) {
-                candidates.push({ pr_number: n, head_sha: result.headSha });
-              } else {
-                skipped.push({ pr: n, reasons: result.reasons });
-              }
-            } else {
-              const prNumbers = await mergeGate.listPrNumbersForMergeGateScan(
-                github, owner, repo, core
-              );
-              const selected = await mergeGate.selectMergeGateCandidates(
-                github, owner, repo, prNumbers, maxCandidates, core
-              );
-              candidates.push(...selected.candidates);
-              skipped.push(...selected.skipped);
-            }
-
-            core.info('Skipped: ' + JSON.stringify(skipped));
-            core.setOutput('matrix', JSON.stringify({ include: candidates }));
-            core.setOutput('has_candidates', candidates.length > 0 ? 'true' : 'false');
-
-            core.summary.addRaw('## Merge gate scan\n');
-            core.summary.addRaw(`Candidates: ${candidates.length}\n`);
-            core.summary.addRaw('```json\n' + JSON.stringify({ candidates, skipped }, null, 2) + '\n```');
-            await core.summary.write();
-
-            if (inputPr && skipped.length === 1 && skipped[0].pr === parseInt(inputPr, 10)) {
-              const reasons = skipped[0].reasons;
-              const body = [
-                '**Merge gate scan** — not eligible for auto-merge.',
-                '',
-                ...reasons.map((r) => `- \`${r}\``),
-                '',
-                '**Actions:** wait for CI and the Claude review chain, or add label `needs-manual-review` and merge manually.',
-                '**Opt out:** label `no-auto-merge`.',
-              ].join('\n');
-              const ctx = await mergeGate.loadPrContext(github, owner, repo, skipped[0].pr);
-              if (!mergeGate.hasRecentMergeGateScanComment(ctx.comments)) {
-                await github.rest.issues.createComment({
-                  owner, repo, issue_number: skipped[0].pr, body,
-                });
-              }
-            } else if (inputPr && candidates.length === 1) {
-              const prNum = candidates[0].pr_number;
-              const ctx = await mergeGate.loadPrContext(github, owner, repo, prNum);
-              if (!mergeGate.hasRecentMergeGateScanComment(ctx.comments)) {
-                await github.rest.issues.createComment({
-                  owner, repo, issue_number: prNum,
-                  body: '**Merge gate scan** — eligible for assessment. Claude merge gate will assess and may auto-merge on an APPROVE verdict.',
-                });
-              }
-            }
-
-            await ps.syncOpenPullRequests(
-              github, owner, repo, { maxPrs: 10, dispatchMergeGate: false }, core
-            );
-
-  claude-assess:
-    needs: scan-candidates
-    if: needs.scan-candidates.outputs.has_candidates == 'true'
-    runs-on: ubuntu-latest
-    timeout-minutes: 20
-    strategy:
-      fail-fast: false
-      matrix: ${{ fromJson(needs.scan-candidates.outputs.matrix) }}
-    permissions:
-      contents: read
-      pull-requests: read
-      issues: write
-      actions: read
-      id-token: write
-    steps:
-      - name: Generate GitHub App Token
-        id: app-token
-        uses: actions/create-github-app-token@v1
-        with:
-          app-id: ${{ secrets.CLAUDE_APP_ID }}
-          private-key: ${{ secrets.CLAUDE_APP_PRIVATE_KEY }}
-          owner: ${{ github.repository_owner }}
-
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          token: ${{ steps.app-token.outputs.token }}
-
-      - name: Mark merge gate active
-        id: mark_active
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            core.setOutput('started_at', new Date().toISOString());
-            await github.rest.issues.addLabels({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: ${{ matrix.pr_number }},
-              labels: ['claude-merge-gate-active'],
-            });
-
-      - name: Stash merge gate helpers
-        run: cp .github/scripts/merge-gate.js /tmp/merge-gate.js
-
-      - name: Fetch PR branch
-        env:
-          PR_NUMBER: ${{ matrix.pr_number }}
-        run: |
-          git fetch origin "pull/${PR_NUMBER}/head:pr-${PR_NUMBER}"
-          git checkout "pr-${PR_NUMBER}"
-
-      - name: Claude merge gate assessment (read-only)
-        id: assess
-        continue-on-error: true
-        uses: ./.github/actions/claude-code-action
-        env:
-          GH_TOKEN: ${{ steps.app-token.outputs.token }}
-          CLAUDE_CODE_SUBAGENT_MODEL: inherit
-          ANTHROPIC_DEFAULT_SONNET_MODEL: claude-sonnet-4-6
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          github_token: ${{ steps.app-token.outputs.token }}
-          model: claude-opus-4-8
-          trigger_phrase: '@claude-merge-gate-internal'
-          direct_prompt: |
-            You are the MERGE GATE reviewer for PraisonAI PR #${{ matrix.pr_number }}.
-            READ-ONLY: do not modify code, commit, push, rebase, or create branches.
-
-            CRITICAL OUTPUT RULE:
-            Post exactly one PR comment via GitHub MCP containing either:
-            MERGE_GATE_VERDICT: APPROVE
-            or
-            MERGE_GATE_VERDICT: BLOCK
-            followed by a short rationale on the next lines.
-
-            NEVER include @claude in any comment. NEVER mention merge conflict resolution.
-
-            Review checklist:
-            1. Read AGENTS.md and the PR diff on the current branch.
-            2. Read all PR comments and reviews (FINAL architecture reviewer / Lead Engineer must have run).
-            3. Confirm SDK value gate: change strengthens the relevant SDK (Python: praisonaiagents/praisonai; TypeScript: src/praisonai-ts/) — no scope creep. The aim is a LIGHTWEIGHT AND POWERFUL package — BLOCK changes that add params/modules/exports duplicating existing Agent capabilities (instructions/backstory/tools/hooks/memory), or add knobs/fields with no live consumer, i.e. scope creep for the sake of it. FINAL architecture review must include the Phase 1 table with an explicit **SDK value** row.
-            4. Repo routing: BLOCK if agent-callable tools (→ PraisonAI-Tools), lifecycle plugins (→ PraisonAI-Plugins), or optional sandbox backends (→ PraisonAI-Plugins via `praisonai.sandbox`) were added to praisonaiagents/ instead of the external repo.
-            5. Do not bloat the Agent class with additional params — only if absolutely required; we already support many params.
-            6. If agent.py adds >100 lines or new Agent __init__ params, respond MERGE_GATE_VERDICT: BLOCK (manual review required).
-            7. BLOCK if labels security/breaking-change/needs-manual-review/release, sensitive paths (.github/workflows, auth, pyproject.toml), secrets in diff, PR >800 lines or >30 files, or SDK changes without tests. Label `merge-gate-ci-only` exempts CI-only changes under `.github/workflows/`, `.github/actions/`, or merge-gate scripts.
-            8. Confirm no CHANGES_REQUESTED reviews and CI green on HEAD ${{ matrix.head_sha }}.
-            9. If ready to merge: MERGE_GATE_VERDICT: APPROVE. Otherwise: MERGE_GATE_VERDICT: BLOCK with reasons.
-
-            Do not approve or merge via GitHub UI/API — only post the verdict comment.
-          disallowed_tools: |
-            Bash
-            Edit
-            Write
-            Replace
-          allowed_tools: |
-            mcp__github__add_issue_comment
-            mcp__github__get_pull_request
-            mcp__github__get_pull_request_files
-            mcp__github__get_pull_request_reviews
-            mcp__github__get_pull_request_status
-            mcp__github__get_issue
-            mcp__github__get_issue_comments
-            Glob
-            Grep
-            Read
-          timeout_minutes: 15
-
-      - name: Post Opus verdict from assess output if MCP missed
-        id: relay_verdict
-        if: always() && steps.assess.conclusion != 'skipped'
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const fs = require('fs');
-            const mergeGate = require('/tmp/merge-gate.js');
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-            const prNumber = ${{ matrix.pr_number }};
-
-            const ctx = await mergeGate.loadPrContext(github, owner, repo, prNumber);
-            const minCreatedAt = new Date(Date.now() - 25 * 60 * 1000).toISOString();
-            const existing = mergeGate.findMergeGateVerdict(
-              ctx.comments, minCreatedAt, ctx.headPushedAt, { excludeAutomatedFallback: true }
-            );
-            if (existing) {
-              core.info(`Opus verdict already on PR: ${existing}`);
-              return;
-            }
-
-            const outPath = `${process.env.GITHUB_WORKSPACE}/.claude-assess-output.jsonl`;
-            if (!fs.existsSync(outPath)) {
-              core.info('No assess output file to relay');
-              return;
-            }
-
-            const lines = fs.readFileSync(outPath, 'utf8').split('\n').filter(Boolean);
-            let verdict = null;
-            let rationale = '';
-            for (let i = lines.length - 1; i >= 0; i--) {
-              const line = lines[i];
-              if (line.includes('MERGE_GATE_VERDICT: APPROVE')) {
-                verdict = 'APPROVE';
-                rationale = line;
-                break;
-              }
-              if (line.includes('MERGE_GATE_VERDICT: BLOCK')) {
-                verdict = 'BLOCK';
-                rationale = line;
-                break;
-              }
-              try {
-                const evt = JSON.parse(line);
-                const text = JSON.stringify(evt);
-                if (text.includes('MERGE_GATE_VERDICT: APPROVE')) {
-                  verdict = 'APPROVE';
-                  rationale = text;
-                  break;
-                }
-                if (text.includes('MERGE_GATE_VERDICT: BLOCK')) {
-                  verdict = 'BLOCK';
-                  rationale = text;
-                  break;
-                }
-              } catch {
-                // Not JSON — keep scanning.
-              }
-            }
-            if (!verdict) {
-              core.info('Assess output had no MERGE_GATE_VERDICT to relay');
-              return;
-            }
-
-            const body = [
-              `MERGE_GATE_VERDICT: ${verdict}`,
-              '',
-              'Relayed from Opus merge gate assess output (GitHub MCP comment post was unavailable).',
-            ].join('\n');
-            await github.rest.issues.createComment({
-              owner, repo, issue_number: prNumber, body,
-            });
-            core.info(`Relayed Opus verdict to PR comment: ${verdict}`);
-
-      - name: Post fallback verdict if Opus did not comment
-        id: fallback_verdict
-        if: always() && steps.assess.conclusion != 'skipped'
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const mergeGate = require('/tmp/merge-gate.js');
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-            const prNumber = ${{ matrix.pr_number }};
-
-            const ctx = await mergeGate.loadPrContext(github, owner, repo, prNumber);
-            const minCreatedAt = new Date(Date.now() - 25 * 60 * 1000).toISOString();
-            const existing = mergeGate.findMergeGateVerdict(
-              ctx.comments, minCreatedAt, ctx.headPushedAt, { excludeAutomatedFallback: true }
-            );
-            if (existing) {
-              core.info(`Verdict already posted: ${existing}`);
-              return;
-            }
-
-            const check = await mergeGate.evaluatePipelineQuiescent(
-              github, owner, repo, prNumber, core, { forMergeStep: true }
-            );
-            const verdict = check.ready ? 'APPROVE' : 'BLOCK';
-            const lines = [
-              `MERGE_GATE_VERDICT: ${verdict}`,
-              '',
-              'Automated fallback — Opus merge gate did not post a PR comment.',
-            ];
-            if (check.ready) {
-              lines.push('All deterministic merge gates passed.');
-            } else {
-              lines.push('Blockers:', ...check.reasons.map((r) => `- ${r}`));
-            }
-            await github.rest.issues.createComment({
-              owner, repo, issue_number: prNumber,
-              body: lines.join('\n'),
-            });
-            core.info(`Posted fallback verdict: ${verdict}`);
-
-      - name: Capture Opus MERGE_GATE_VERDICT
-        id: capture_verdict
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const mergeGate = require('/tmp/merge-gate.js');
-            const comments = await mergeGate.listAllComments(
-              github, context.repo.owner, context.repo.repo, ${{ matrix.pr_number }}
-            );
-            const ctx = await mergeGate.loadPrContext(
-              github, context.repo.owner, context.repo.repo, ${{ matrix.pr_number }}
-            );
-            const minCreatedAt = new Date(Date.now() - 25 * 60 * 1000).toISOString();
-            const verdict = mergeGate.findMergeGateVerdict(
-              comments, minCreatedAt, ctx.headPushedAt, { excludeAutomatedFallback: true }
-            );
-            core.setOutput('verdict', verdict || 'NONE');
-            if (!verdict) {
-              core.warning(
-                'Opus MERGE_GATE_VERDICT not posted on PR (GitHub MCP tools may be blocked). Merge waits for APPROVE.'
-              );
-            } else {
-              core.info(`Opus merge gate verdict: ${verdict}`);
-            }
-
-      - name: Remove merge gate active label
-        if: always()
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const prNumber = ${{ matrix.pr_number }};
-            try {
-              await github.rest.issues.removeLabel({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: prNumber,
-                name: 'claude-merge-gate-active',
-              });
-              core.info(`Removed claude-merge-gate-active from PR #${prNumber}`);
-            } catch (e) {
-              core.info(`Label claude-merge-gate-active already removed or missing on PR #${prNumber}`);
-            }
-
-  merge-only:
-    needs: [scan-candidates, claude-assess]
-    if: |
-      always() &&
-      needs.scan-candidates.outputs.has_candidates == 'true' &&
-      needs.claude-assess.result == 'success'
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix: ${{ fromJson(needs.scan-candidates.outputs.matrix) }}
-    permissions:
-      contents: write
-      pull-requests: write
-      issues: write
-      actions: read
-      id-token: write
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Generate GitHub App token
-        id: app-token
-        uses: actions/create-github-app-token@v1
-        with:
-          app-id: ${{ secrets.CLAUDE_APP_ID }}
-          private-key: ${{ secrets.CLAUDE_APP_PRIVATE_KEY }}
-          owner: ${{ github.repository_owner }}
-
-      - name: Re-check gates and merge
-        uses: actions/github-script@v7
-        env:
-          MERGE_METHOD: ${{ github.event.inputs.merge_method || 'merge' }}
-          SCAN_HEAD_SHA: ${{ matrix.head_sha }}
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const path = require('path');
-            const mergeGate = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/merge-gate.js'));
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-            const prNumber = ${{ matrix.pr_number }};
-            const scanHeadSha = process.env.SCAN_HEAD_SHA;
-
-            const removeLabels = async () => {
-              try {
-                await github.rest.issues.removeLabel({
-                  owner, repo, issue_number: prNumber, name: 'claude-merge-gate-active',
-                });
-              } catch (e) {
-                core.info('Label claude-merge-gate-active already removed or missing');
-              }
-            };
-
-            try {
-              const ctx = await mergeGate.loadPrContext(github, owner, repo, prNumber);
-              const comments = ctx.comments;
-              const verdictMin = new Date(Date.now() - 25 * 60 * 1000).toISOString();
-              const verdict = mergeGate.findMergeGateVerdict(
-                comments, verdictMin, ctx.headPushedAt, { excludeAutomatedFallback: true }
-              );
-              if (verdict !== 'APPROVE') {
-                core.info(`Skip merge: verdict=${verdict || 'NONE'}`);
-                await removeLabels();
-                return;
-              }
-
-              const check = await mergeGate.evaluatePipelineQuiescent(
-                github, owner, repo, prNumber, core, { forMergeStep: true }
-              );
-              if (!check.ready) {
-                core.info(`Skip merge: ${check.reasons.join(', ')}`);
-                await removeLabels();
-                return;
-              }
-
-              if (check.headSha !== scanHeadSha) {
-                core.info(`Skip merge: HEAD moved ${scanHeadSha.slice(0, 7)} → ${check.headSha.slice(0, 7)}`);
-                await removeLabels();
-                return;
-              }
-
-              const method = process.env.MERGE_METHOD || 'merge';
-              const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-              let merged = false;
-              for (let attempt = 1; attempt <= 3; attempt++) {
-                try {
-                  await github.rest.pulls.merge({
-                    owner, repo, pull_number: prNumber, merge_method: method,
-                  });
-                  merged = true;
-                  break;
-                } catch (e) {
-                  const msg = (e.message || '').toLowerCase();
-                  if (attempt < 3 && msg.includes('base branch was modified')) {
-                    core.info(`Merge attempt ${attempt} failed (base moved), retrying in 8s...`);
-                    await sleep(8000);
-                    const recheck = await mergeGate.evaluatePipelineQuiescent(
-                      github, owner, repo, prNumber, core, { forMergeStep: true }
-                    );
-                    if (!recheck.ready) {
-                      core.info(`Skip merge retry: ${recheck.reasons.join(', ')}`);
-                      await removeLabels();
-                      return;
-                    }
-                    continue;
-                  }
-                  throw e;
-                }
-              }
-              if (!merged) {
-                core.info('Skip merge: exhausted retries');
-                await removeLabels();
-                return;
-              }
-
-              await github.rest.issues.addLabels({
-                owner, repo, issue_number: prNumber, labels: ['auto-merged-by-gate'],
-              });
-
-              await github.rest.issues.createComment({
-                owner, repo, issue_number: prNumber,
-                body: [
-                  'Merged by **Claude PR merge gate** (`claude-merge-gate.yml`).',
-                  `Verdict: MERGE_GATE_VERDICT: APPROVE`,
-                  `SHA: \`${check.headSha.slice(0, 7)}\``,
-                  `Method: ${method}`,
-                ].join('\n'),
-              });
-
-              core.info(`Merged PR #${prNumber}`);
-            } finally {
-              await removeLabels();
-            }

.github/workflows/claude.yml

@@ -6,348 +6,35 @@ on:
   pull_request_review_comment:
     types: [created]
   issues:
-    types: [assigned, labeled, opened]
+    types: [opened, assigned, labeled]
   pull_request_review:
     types: [submitted]
 
 jobs:
-  # ================================================================
-  # Job 1: Lightweight triage for ALL new issues (including external users)
-  # Posts welcome comment + adds triage labels. No Claude code execution.
-  # ================================================================
-  issue-triage:
-    if: |
-      github.event_name == 'issues' &&
-      github.event.action == 'opened' &&
-      !contains(toJSON(github.event.issue.labels), 'claude')
-    runs-on: ubuntu-latest
-    permissions:
-      issues: write
-      contents: read
-    steps:
-      - name: Generate GitHub App Token
-        id: app-token
-        uses: actions/create-github-app-token@v1
-        with:
-          app-id: ${{ secrets.CLAUDE_APP_ID }}
-          private-key: ${{ secrets.CLAUDE_APP_PRIVATE_KEY }}
-          owner: ${{ github.repository_owner }}
-
-      - name: Triage and acknowledge issue
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const issue = context.payload.issue;
-            const title = (issue.title || '').toLowerCase();
-            const body = (issue.body || '').toLowerCase();
-            const content = title + ' ' + body;
-            const isOwner = ['OWNER', 'MEMBER', 'COLLABORATOR'].includes(
-              issue.author_association
-            );
-
-            // --- Label triage ---
-            const labels = [];
-
-            // Kind labels (bug before "how to" — bug reports often include "## How to fix")
-            if (content.includes('feature request') || content.includes('[feature')) {
-              labels.push('enhancement');
-            } else if (!title.includes('[question]') && (content.includes('bug') || content.includes('error') || content.includes('crash') || content.includes('traceback'))) {
-              labels.push('bug');
-            } else if (title.includes('[question]') || content.includes('how do i') || (content.includes('how to') && !content.includes('how to fix'))) {
-              labels.push('question');
-            } else if (content.includes('question')) {
-              labels.push('question');
-            }
-
-            // Area labels
-            if (content.includes('security') || content.includes('cve') || content.includes('vulnerability')) {
-              labels.push('security');
-            }
-            if (content.includes('performance') || content.includes('slow') || content.includes('memory leak')) {
-              labels.push('performance');
-            }
-            if (content.includes('documentation') || content.includes('docs')) {
-              labels.push('documentation');
-            }
-            if (content.includes('typescript') || content.includes('javascript') || content.includes('npm')) {
-              labels.push('javascript');
-            }
-
-            // Apply labels
-            if (labels.length > 0) {
-              await github.rest.issues.addLabels({
-                issue_number: issue.number,
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                labels
-              });
-            }
-
-            // --- Acknowledgment comment (external users only) ---
-            if (!isOwner) {
-              await github.rest.issues.createComment({
-                issue_number: issue.number,
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                body: [
-                  `👋 Thanks for opening this issue, @${issue.user.login}!`,
-                  '',
-                  'A maintainer will review this shortly. In the meantime:',
-                  '- Make sure you\'ve included steps to reproduce (for bugs)',
-                  '- Check [existing issues](https://github.com/MervinPraison/PraisonAI/issues) for duplicates',
-                  '- Review the [documentation](https://docs.praison.ai) for related guides',
-                  '',
-                  '_Bug and enhancement reports are auto-triaged with Claude. Questions and other issues: a maintainer can comment `@claude` to trigger analysis._',
-                  '',
-                  '**Routing:** Agent-callable tools → [PraisonAI-Tools](https://github.com/MervinPraison/PraisonAI-Tools); lifecycle plugins (tracing/hooks/guardrails) → [PraisonAI-Plugins](https://github.com/MervinPraison/PraisonAI-Plugins). TypeScript/JavaScript SDK fixes land in `src/praisonai-ts/` in this repo.'
-                ].join('\n')
-              });
-            }
-
-            // --- Auto-trigger Claude for bug/enhancement reports ---
-            const titleLower = (issue.title || '').toLowerCase();
-            const bodyRaw = issue.body || '';
-            const hasBugMarker = /#?\s*\[bug\]/i.test(issue.title || '') || /#?\s*\[bug\]/i.test(bodyRaw);
-            const hasActionableTitle = /^(\[[^\]]+\]|bug:|fix[:(]|feat:|ux:|enhancement:)/i.test(titleLower);
-            const isBugReport = labels.includes('bug') || hasBugMarker;
-            const isEnhancement = labels.includes('enhancement') && !labels.includes('question');
-            const autoClaude = isOwner || isBugReport || (hasActionableTitle && isEnhancement);
-            if (autoClaude) {
-              await github.rest.issues.addLabels({
-                issue_number: issue.number,
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                labels: ['claude']
-              });
-            }
-
-  # ================================================================
-  # Job 2: Full Claude code-fix
-  # Triggers on: labeled 'claude', @claude comments, assignments
-  # ================================================================
   claude-response:
-    # Allow: human users, github-actions[bot] (FINAL @claude / CI-fix comments)
-    # Allow: praisonai-triage-agent[bot] only for issues labeled 'claude' (auto-triage)
-    # Block: praisonai-triage-agent on issue_comment (merge-gate scan mentions @claude)
-    # Skip 'opened' events — triage job handles those above
+    # Prevent certain bots from triggering this action (but allow github-actions[bot] for auto-comments)
     if: |
-      github.event.action != 'opened' &&
-      (github.event.action != 'labeled' || github.event.label.name == 'claude') &&
-      (github.event_name != 'issue_comment' || (
-        contains(github.event.comment.body, '@claude') &&
-        !contains(github.event.comment.body, 'Merge gate scan') &&
-        !contains(github.event.comment.body, 'MERGE_GATE_VERDICT') &&
-        !contains(github.event.comment.body, 'Merged by **Claude PR merge gate**') &&
-        (
-          !contains(github.actor, '[bot]') ||
-          contains(github.event.comment.body, 'FINAL architecture reviewer') ||
-          contains(github.event.comment.body, 'lead engineer') ||
-          contains(github.event.comment.body, 'merge conflict') ||
-          contains(github.event.comment.body, 'CI failed on HEAD')
-        )
-      )) &&
-      (github.event_name != 'pull_request_review' || contains(github.event.review.body, '@claude')) &&
-      (github.event_name != 'pull_request_review_comment' || contains(github.event.comment.body, '@claude')) &&
-      (
-        !contains(github.actor, '[bot]') ||
-        github.actor == 'github-actions[bot]' ||
-        (github.event_name == 'issues' && github.event.action == 'labeled' && github.event.label.name == 'claude' && github.actor == 'praisonai-triage-agent[bot]')
-      ) &&
       github.actor != 'dependabot[bot]' &&
       github.actor != 'cursor[bot]' &&
-      github.actor != 'renovate[bot]'
-    concurrency:
-      group: claude-response-${{ github.repository }}-${{ github.event.pull_request.number || github.event.issue.number || github.run_id }}
-      cancel-in-progress: false
+      github.actor != 'renovate[bot]' &&
+      !(contains(github.actor, '[bot]') && github.actor != 'github-actions[bot]')
     runs-on: ubuntu-latest
     permissions:
       contents: write
       pull-requests: write
       issues: write
       actions: read
-      id-token: write
     steps:
-      - name: Generate GitHub App Token
-        id: app-token
-        uses: actions/create-github-app-token@v1
-        with:
-          app-id: ${{ secrets.CLAUDE_APP_ID }}
-          private-key: ${{ secrets.CLAUDE_APP_PRIVATE_KEY }}
-          owner: ${{ github.repository_owner }}
-
-      - name: Check for Fork PR
-        id: check_fork
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const isPR = context.eventName === 'pull_request'
-              || context.eventName === 'pull_request_review'
-              || context.eventName === 'pull_request_review_comment'
-              || (context.payload.issue && context.payload.issue.pull_request);
-
-            if (!isPR) {
-              core.setOutput('is_pr', 'false');
-              core.setOutput('is_fork', 'false');
-              core.setOutput('can_push_fork', 'false');
-              return;
-            }
-
-            const prNumber = context.payload.pull_request
-              ? context.payload.pull_request.number
-              : context.payload.issue.number;
-            const pr = await github.rest.pulls.get({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              pull_number: prNumber
-            });
-
-            let mergeState = '';
-            try {
-              const gql = await github.graphql(
-                `query($owner: String!, $repo: String!, $number: Int!) {
-                  repository(owner: $owner, name: $repo) {
-                    pullRequest(number: $number) { mergeStateStatus }
-                  }
-                }`,
-                { owner: context.repo.owner, repo: context.repo.repo, number: prNumber }
-              );
-              mergeState = (gql.repository.pullRequest.mergeStateStatus || '').toUpperCase();
-            } catch (e) {
-              core.warning(`GraphQL mergeStateStatus failed: ${e.message}`);
-            }
-            if (!mergeState) {
-              mergeState = (pr.data.mergeable_state || pr.data.merge_state_status || '').toUpperCase();
-            }
-
-            core.setOutput('is_pr', 'true');
-            core.setOutput('pr_number', String(prNumber));
-            core.setOutput('pr_branch', pr.data.head.ref);
-            core.setOutput('head_repo', pr.data.head.repo.full_name);
-            core.setOutput('merge_state', mergeState);
-
-            const baseRepo = `${context.repo.owner}/${context.repo.repo}`;
-            const maintainerCanModify = pr.data.maintainer_can_modify === true;
-            core.setOutput('maintainer_can_modify', String(maintainerCanModify));
-
-            if (pr.data.head.repo && pr.data.head.repo.full_name !== baseRepo) {
-              core.setOutput('is_fork', 'true');
-              core.setOutput('can_push_fork', String(maintainerCanModify));
-              core.setOutput('fork_repo', pr.data.head.repo.full_name);
-              core.setOutput('clone_url', pr.data.head.repo.clone_url);
-              core.setOutput('branch', pr.data.head.ref);
-              return;
-            }
-            core.setOutput('is_fork', 'false');
-            core.setOutput('can_push_fork', 'false');
-
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
-          persist-credentials: false
           fetch-depth: 0
-          token: ${{ steps.app-token.outputs.token }}
-
-      - name: Fetch PR branch and Setup Remote
-        if: steps.check_fork.outputs.is_pr == 'true'
-        env:
-          PR_BRANCH: ${{ steps.check_fork.outputs.pr_branch }}
-          PR_NUMBER: ${{ steps.check_fork.outputs.pr_number }}
-          IS_FORK: ${{ steps.check_fork.outputs.is_fork }}
-          CAN_PUSH_FORK: ${{ steps.check_fork.outputs.can_push_fork }}
-          FORK_REPO: ${{ steps.check_fork.outputs.fork_repo }}
-          GH_TOKEN: ${{ secrets.GH_TOKEN }}
-        run: |
-          git fetch origin "pull/${PR_NUMBER}/head:${PR_BRANCH}"
-          git checkout "${PR_BRANCH}"
-          git fetch origin main
-
-          if [ "${IS_FORK}" = "true" ] && [ "${CAN_PUSH_FORK}" = "true" ]; then
-            git remote set-url origin "https://x-access-token:${GH_TOKEN}@github.com/${FORK_REPO}.git"
-          elif [ "${IS_FORK}" = "true" ]; then
-            # Block push: trick claude-code-action's `git fetch origin <branch>`
-            git remote set-url origin "file://$(pwd)"
-          fi
-
+          
       - uses: anthropics/claude-code-action@beta
-        env:
-          GH_TOKEN: ${{ steps.check_fork.outputs.can_push_fork == 'true' && secrets.GH_TOKEN || steps.app-token.outputs.token }}
         with:
-          allowed_bots: 'praisonai-triage-agent[bot]'
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          github_token: ${{ steps.app-token.outputs.token }}
-          model: claude-opus-4-8
+          claude_code_oauth_token: ${{ secrets.CLAUDE_ACCESS_TOKEN }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
           trigger_phrase: "@claude"
-          label_trigger: "claude"
-
-          direct_prompt: |
-            ${{ steps.check_fork.outputs.is_fork == 'true' && steps.check_fork.outputs.can_push_fork != 'true' && 'CRITICAL: THIS IS A PULL REQUEST FROM A FORK WITHOUT MAINTAINER EDITS. YOU DO NOT HAVE PUSH PERMISSIONS. ONLY READ FILES, VALIDATE CODE, AND PROVIDE COMMENTS/FEEDBACK ON THIS PR. DO NOT ATTEMPT TO PUSH OR CREATE PULL REQUESTS.\n\n' || (steps.check_fork.outputs.can_push_fork == 'true' && format('NOTE: Fork PR with maintainer edits allowed. Push directly to fork {0} branch {1}.\n\n', steps.check_fork.outputs.fork_repo, steps.check_fork.outputs.pr_branch) || (steps.check_fork.outputs.is_pr == 'true' && steps.check_fork.outputs.is_fork != 'true' && 'NOTE: The branch is under MervinPraison/PraisonAI (not a fork). You are able to make modifications and push directly to this branch.\n\n' || (steps.check_fork.outputs.is_pr != 'true' && 'NOTE: This is an issue (not a PR). Create a new fix branch per STEP 3 below.\n\n' || ''))) }}
-            ${{ steps.check_fork.outputs.is_pr == 'true' && format('CONTEXT: PR #{0} on branch {1}. head.repo={2}, is_fork={3}, can_push_fork={4}, merge_state={5}. NEVER treat cursor/*, claude/* branch names or bot authors as forks — only is_fork=true means fork.\n\n', steps.check_fork.outputs.pr_number, steps.check_fork.outputs.pr_branch, steps.check_fork.outputs.head_repo, steps.check_fork.outputs.is_fork, steps.check_fork.outputs.can_push_fork, steps.check_fork.outputs.merge_state) || '' }}
-            You are working on the PraisonAI SDK. Follow AGENTS.md strictly.
-
-            STEP 0 — SETUP GIT IDENTITY & AUTH (GLOBAL — required for all repos):
-            git config --global user.name "MervinPraison"
-            git config --global user.email "[email protected]"
-            gh auth setup-git
-
-
-            STEP 1 — READ GUIDELINES:
-            Read AGENTS.md to understand the architecture rules.
-            SCOPE: Python SDK (praisonaiagents, praisonai) and TypeScript SDK (src/praisonai-ts/) live in this monorepo. Do NOT modify src/praisonai-rust. For TS issues read src/praisonai-ts/AGENTS.md.
-            AIM: This package must stay LIGHTWEIGHT AND POWERFUL. Do a CRITICAL REVIEW at each stage (issue triage, fix planning, PR review/implementation) and reject scope creep for the sake of adding features. Prefer existing Agent capabilities (instructions/backstory/tools/hooks/memory) over new params/modules/exports. Even when fixing a raised issue, keep the fix minimal and lightweight — do NOT expand the surface area or add knobs with no live consumer.
-
-            STEP 2 — ARCHITECTURE VALIDATION & ROUTING (MANDATORY before writing code):
-            Before implementing anything, answer these questions:
-            - CORE vs WRAPPER vs TOOLS vs DOCS vs PLUGINS ROUTING:
-              1. Core SDK (praisonaiagents/): Only core protocols, base classes, decorators. No heavy implementations.
-              2. Wrapper (praisonai/): CLI, heavy implementations, optional dependencies.
-              3. Tools → MervinPraison/PraisonAI-Tools: agent-callable integrations at runtime (Composio, Slack, API/DB connectors). Do NOT implement in praisonaiagents/ — use STEP 3-ALT.
-              4. Documentation (PraisonAIDocs): Documentation pages, guides, API references.
-              5. Plugins → MervinPraison/PraisonAI-Plugins: framework lifecycle extensions (tracing, logging, metrics, hooks, guardrails). Not agent tools — use STEP 3-ALT.
-              6. Sandbox backends (optional/niche, e.g. Capsule) → PraisonAI-Plugins via `praisonai.sandbox` entry point; core keeps protocol/config/manager only.
-              7. TypeScript/JavaScript SDK → src/praisonai-ts/ in this monorepo (not praisonaiagents/).
-              For items routed to an EXTERNAL repository (Tools, Docs, Plugins), follow STEP 3-ALT below.
-            - Does it duplicate existing functionality? Check if Agent already supports this via existing params (reflection, planning, tools, hooks, memory). If it does, reject the change as scope creep and prefer the existing capability — the aim is lightweight and powerful, not more knobs.
-            - Do not bloat the Agent class with additional params — only if absolutely required; we already support many params.
-            - Does it inherit from Agent properly? New agent types MUST inherit Agent, not wrap it with composition.
-            - Does it add new dependencies? Only optional deps allowed, must be lazy-imported.
-            - Will agent.py grow larger? If the change adds >50 lines to agent.py, find a way to extract instead. PRs with >100 lines added to agent.py require manual review (merge gate will not auto-merge).
-            - Is there a name collision with existing exports in __init__.py?
-            If ANY of these conceptual checks fail (excluding routing), add a comment to the issue explaining why and close it. Do NOT create a PR.
-
-            ${{ steps.check_fork.outputs.is_pr == 'true' && (steps.check_fork.outputs.is_fork != 'true' || steps.check_fork.outputs.can_push_fork == 'true') && steps.check_fork.outputs.merge_state == 'DIRTY' && format('STEP 3 — RESOLVE MERGE CONFLICTS ON PR (branch: {0}, PR #{1}{2}):\n- DO NOT create a new branch or PR\n- git fetch origin main && git rebase origin/main\n- Resolve conflicts: keep this PR intent, merge in main newer logic\n- git add -A && git rebase --continue (repeat until done)\n- git push --force-with-lease origin {0}\n- Run targeted pytest on changed paths\n- Comment files resolved and what you skipped\n', steps.check_fork.outputs.pr_branch, steps.check_fork.outputs.pr_number, steps.check_fork.outputs.can_push_fork == 'true' && format(', fork: {0}', steps.check_fork.outputs.fork_repo) || '') || '' }}
-            ${{ steps.check_fork.outputs.is_pr == 'true' && (steps.check_fork.outputs.is_fork != 'true' || steps.check_fork.outputs.can_push_fork == 'true') && steps.check_fork.outputs.merge_state != 'DIRTY' && format('STEP 3 — IMPLEMENT ON EXISTING PR (branch: {0}, PR #{1}{2}):\n- DO NOT create a new branch or PR\n- git checkout {0}\n- Implement minimal, focused fixes from reviewer feedback\n- Follow protocol-driven design: protocols in core SDK, heavy implementations in wrapper\n- Keep changes small and backward-compatible\n- Commit: git add -A && git commit -m "fix: <description>"\n- Push: git push origin {0}\n- Comment a summary of exact files modified and what you skipped\n', steps.check_fork.outputs.pr_branch, steps.check_fork.outputs.pr_number, steps.check_fork.outputs.can_push_fork == 'true' && format(', fork: {0}', steps.check_fork.outputs.fork_repo) || '') || '' }}
-            ${{ steps.check_fork.outputs.is_pr != 'true' && 'STEP 3 — IMPLEMENT (for changes in THIS repo — PraisonAI):\n- Create a fix branch: git checkout -b claude/issue-$ISSUE_NUMBER-$(date +%Y%m%d)\n- Implement a minimal, focused fix\n- Follow protocol-driven design: protocols in core SDK, heavy implementations in wrapper\n- Keep changes small and backward-compatible\n- Commit: git add -A && git commit -m "fix: <description> (fixes #$ISSUE_NUMBER)"\n- Push: git push origin claude/issue-$ISSUE_NUMBER-$(date +%Y%m%d)\nCRITICAL: After pushing, you MUST immediately run: gh pr create --title "fix: <title>" --body "Fixes #$ISSUE_NUMBER" --head claude/issue-$ISSUE_NUMBER-$(date +%Y%m%d)\nDo NOT stop after pushing. Do NOT say "manually create a PR". Always create the PR automatically.\n' || '' }}
-
-            STEP 3-ALT — IMPLEMENT IN EXTERNAL REPO (for PraisonAI-Tools, PraisonAIDocs, PraisonAI-Plugins):
-            When work must happen in a different repository, follow these steps EXACTLY. Do NOT attempt to use `cd`, as directory state is not preserved. Use `git -C` for all commands.
-            a) Clone the repository:
-               gh repo clone MervinPraison/<REPO_NAME> /tmp/<REPO_NAME>
-            b) Copy GitHub authentication from the main repository so push works seamlessly:
-               git -C /tmp/<REPO_NAME> config http."https://github.com/".extraheader "$(git config --get http."https://github.com/".extraheader)"
-            c) Create a feature branch (NEVER commit to main):
-               git -C /tmp/<REPO_NAME> checkout -b claude/issue-$ISSUE_NUMBER-$(date +%Y%m%d)
-            d) Make your changes using absolute paths (e.g. edit /tmp/<REPO_NAME>/docs.json)
-            e) Commit:
-               git -C /tmp/<REPO_NAME> add -A
-               git -C /tmp/<REPO_NAME> commit -m "feat: <description> (fixes #$ISSUE_NUMBER)"
-            f) Push the branch:
-               git -C /tmp/<REPO_NAME> push origin claude/issue-$ISSUE_NUMBER-$(date +%Y%m%d)
-            g) Create PR in the EXTERNAL repo:
-               gh pr create -R MervinPraison/<REPO_NAME> --head claude/issue-$ISSUE_NUMBER-$(date +%Y%m%d) --title "feat: <title>" --body "Fixes MervinPraison/PraisonAI#$ISSUE_NUMBER
-
-               <body>"
-            h) Comment on THIS PraisonAI issue with the external PR URL.
-
-            STEP 4 — TEST:
-            - For Python SDK changes: cd src/praisonai-agents && PYTHONPATH=. python -m pytest tests/ -x -q --timeout=30
-            - For TypeScript SDK changes: cd src/praisonai-ts && npm install && npm run build && npm test
-            - For docs changes: verify files exist and are valid markdown/MDX
-            - Ensure no regressions
-
-            ${{ steps.check_fork.outputs.is_pr == 'true' && 'STEP 5 — SKIP: Already on an open PR. Do NOT run gh pr create.\n' || 'STEP 5 — CREATE PR:\n- Commit with descriptive message, push, and create PR using `gh pr create`\n- For external repos, use `gh pr create -R MervinPraison/<REPO_NAME>`\nCRITICAL: You MUST create the PR automatically using `gh pr create`. Do NOT just provide a link or say "manual push required".\n' }}
-            NOTE: If you worked on an external repo, the wrapper action will report "No commits" for the main repo at the end. This is expected, do not worry about it.
           allowed_tools: |
             Bash(git:*)
             Bash(python:*)
@@ -355,8 +42,6 @@ jobs:
             Bash(conda:*)
             Bash(pytest:*)
             Bash(gh:*)
-            Bash(npm:*)
-            Bash(node:*)
             Bash(python -m pytest:*)
             Bash(python -m pip:*)
             Bash(poetry:*)
@@ -371,60 +56,105 @@ jobs:
             mcp__github__update_issue
           timeout_minutes: 30
 
-      - name: Kick review chain for bot-created PR
-        if: |
-          steps.check_fork.outputs.is_pr != 'true' &&
-          (github.event_name == 'issues' || github.event_name == 'issue_comment') &&
-          github.event.issue != null
-        continue-on-error: true
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const path = require('path');
-            const chain = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/bot-pr-review-chain.js'));
-            const issueNumber = context.payload.issue.number;
-            await chain.kickReviewChainForIssue(
-              github, context.repo.owner, context.repo.repo, issueNumber, core
-            );
-
-      - name: Sync pipeline status labels for PR
-        if: steps.check_fork.outputs.is_pr == 'true'
+  post-review-comment:
+    needs: claude-response
+    if: success() && needs.claude-response.result == 'success'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: write
+    steps:
+      - name: Check for existing review comment
+        id: check-comment
         uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.GH_TOKEN }}
           script: |
-            const path = require('path');
-            const ps = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/pipeline-status.js'));
-            const prNumber = parseInt('${{ steps.check_fork.outputs.pr_number }}', 10);
-            await ps.ensurePipelineLabels(github, context.repo.owner, context.repo.repo, core);
-            await ps.syncPipelineLabels(github, context.repo.owner, context.repo.repo, prNumber, core);
-
-      - name: Dispatch merge gate when PR pipeline ready
-        if: steps.check_fork.outputs.is_pr == 'true'
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.GH_TOKEN }}
-          script: |
-            const path = require('path');
-            const mergeGate = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/merge-gate.js'));
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-            const prNumber = parseInt('${{ steps.check_fork.outputs.pr_number }}', 10);
-            const check = await mergeGate.evaluatePipelineQuiescent(
-              github, owner, repo, prNumber, core, {
-                skipGlobalClaudeRunCheck: true,
-                skipRecentClaudeCooldown: true,
+            const reviewText = '@claude review if the changes made in the above branch are as per the requirements and make changes to the above branch if issues still exist.';
+            let comments = [];
+            let issueNumber;
+            
+            try {
+              // Determine issue/PR number based on event type
+              if (context.eventName === 'pull_request_review_comment' || context.eventName === 'pull_request_review') {
+                issueNumber = context.payload.pull_request?.number || context.issue.number;
+              } else if (context.eventName === 'issue_comment' && context.payload.issue.pull_request) {
+                // This is a comment on a PR (not an issue)
+                issueNumber = context.payload.issue.number;
+              } else {
+                // This is a regular issue
+                issueNumber = context.issue.number;
               }
-            );
-            if (!check.ready) {
-              core.info(`PR #${prNumber} not ready for merge gate: ${check.reasons.join(', ')}`);
-              return;
+              
+              comments = await github.rest.issues.listComments({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: issueNumber
+              });
+              
+              // Look for Claude's completed review comments
+              const claudeReviewComments = comments.data.filter(comment => 
+                (comment.user.login === 'claude[bot]' || comment.body.includes('✅') || comment.body.includes('## Summary')) &&
+                !comment.body.includes('⏳') && 
+                !comment.body.includes('🔄') &&
+                !comment.body.includes('Loading...')
+              );
+              
+              // Check if our review request comment already exists
+              const existingReviewRequest = comments.data.find(comment => 
+                comment.body.includes(reviewText)
+              );
+              
+              // Post if Claude has completed a review AND we haven't posted the review request yet
+              const shouldPost = claudeReviewComments.length > 0 && !existingReviewRequest;
+              core.setOutput('should-post', shouldPost);
+              console.log(`Claude review completed: ${claudeReviewComments.length > 0}`);
+              console.log(`Review request exists: ${!!existingReviewRequest}`);
+              console.log(`Should post comment: ${shouldPost}`);
+              
+            } catch (error) {
+              console.log('Error checking comments:', error);
+              core.setOutput('should-post', false); // If we can't check, don't post
             }
-            await github.rest.repos.createDispatchEvent({
-              owner,
-              repo,
-              event_type: 'claude-merge-gate',
-              client_payload: { pr_number: prNumber },
-            });
-            core.info(`Dispatched merge gate for PR #${prNumber}`);
+
+      - name: Wait 30 seconds before posting comment
+        if: steps.check-comment.outputs.should-post == 'true'
+        run: sleep 30
+
+      - name: Post review comment
+        if: steps.check-comment.outputs.should-post == 'true'
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GH_TOKEN }}
+          script: |
+            let issueNumber;
+            let isPR = false;
+            
+            // Determine issue/PR number and type based on event type
+            if (context.eventName === 'pull_request_review_comment' || context.eventName === 'pull_request_review') {
+              issueNumber = context.payload.pull_request?.number || context.issue.number;
+              isPR = true;
+            } else if (context.eventName === 'issue_comment' && context.payload.issue.pull_request) {
+              // This is a comment on a PR (not an issue)
+              issueNumber = context.payload.issue.number;
+              isPR = true;
+            } else {
+              // This is a regular issue - don't post review comment
+              issueNumber = context.issue.number;
+              isPR = false;
+            }
+            
+            // Only post review comment on PRs, not regular issues
+            if (isPR) {
+              console.log(`Posting review comment on PR #${issueNumber}`);
+              
+              await github.rest.issues.createComment({
+                issue_number: issueNumber,
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                body: '@claude review if the changes made in the above branch are as per the requirements and make changes to the above branch if issues still exist. MAINLY IT SHOULD NOT IMPACT ON THE CURRENT SPEED OF EXECUTION of existing features, not increasing the overhead.'
+              });
+            } else {
+              console.log(`Skipping review comment for regular issue #${issueNumber}`);
+            }

.github/workflows/coverage.yml

@@ -0,0 +1,62 @@
+name: Run tests and upload coverage
+
+on: 
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    name: Run tests and collect coverage
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.11
+
+      - name: Install UV
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Install dependencies
+        run: |
+          cd src/praisonai
+          uv pip install --system ."[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
+          uv pip install --system duckduckgo_search
+          uv pip install --system pytest pytest-cov pytest-asyncio
+          # Install knowledge dependencies from praisonai-agents
+          uv pip install --system "praisonaiagents[knowledge]"
+
+      - name: Set environment variables
+        run: |
+          echo "OPENAI_API_KEY=${{ secrets.OPENAI_API_KEY || 'sk-test-key-for-github-actions-testing-only-not-real' }}" >> $GITHUB_ENV
+          echo "OPENAI_API_BASE=${{ secrets.OPENAI_API_BASE || 'https://api.openai.com/v1' }}" >> $GITHUB_ENV
+          echo "OPENAI_MODEL_NAME=${{ secrets.OPENAI_MODEL_NAME || 'gpt-5-nano' }}" >> $GITHUB_ENV
+          echo "LOGLEVEL=DEBUG" >> $GITHUB_ENV
+          echo "PYTHONPATH=${{ github.workspace }}/src/praisonai-agents:$PYTHONPATH" >> $GITHUB_ENV
+
+      - name: Run tests
+        run: |
+          cd src/praisonai
+          # Run tests - allow some failures for now while we fix remaining issues
+          pytest --cov=praisonai --cov-branch --cov-report=xml tests/unit/ --tb=no -q || echo "Some tests failed, but coverage was collected"
+
+      - name: Upload results to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          file: src/praisonai/coverage.xml
+          flags: unit-tests
+          name: unit-tests-coverage
+          fail_ci_if_error: false
+          verbose: true 

.github/workflows/deploy-install-scripts.yml

@@ -1,77 +0,0 @@
-name: Deploy install scripts to praison.ai
-
-# Production praison.ai runs on Hestia (migration-target), not Azure AKS.
-# Uses scoped deploy user (praison-deploy) — not root.
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - 'src/praisonai/scripts/install.sh'
-      - 'src/praisonai/scripts/install.ps1'
-  workflow_dispatch:
-
-concurrency:
-  group: deploy-install-scripts
-  cancel-in-progress: false
-
-permissions:
-  contents: read
-
-jobs:
-  deploy-to-hestia:
-    runs-on: ubuntu-latest
-    environment: production-hestia
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: main
-          persist-credentials: false
-
-      - name: Sync install scripts to Hestia
-        env:
-          SSH_PRIVATE_KEY: ${{ secrets.MIGRATION_TARGET_SSH_KEY }}
-          HESTIA_HOST: ${{ secrets.MIGRATION_TARGET_HOST }}
-          HESTIA_USER: ${{ secrets.MIGRATION_TARGET_USER }}
-          HESTIA_KNOWN_HOSTS: ${{ secrets.MIGRATION_TARGET_KNOWN_HOSTS }}
-          SOURCE_SHA: ${{ github.sha }}
-        run: |
-          set -euo pipefail
-          for var in SSH_PRIVATE_KEY HESTIA_HOST HESTIA_USER; do
-            if [ -z "${!var:-}" ]; then
-              echo "Missing secret for deploy (need MIGRATION_TARGET_SSH_KEY, MIGRATION_TARGET_HOST, MIGRATION_TARGET_USER)"
-              exit 1
-            fi
-          done
-
-          REMOTE_WEB="/home/hestiaadmin/web/praison.ai/pa/web"
-          SSH_OPTS="-o BatchMode=yes -o ConnectTimeout=15 -o StrictHostKeyChecking=yes"
-
-          mkdir -p ~/.ssh
-          echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_ed25519
-          chmod 600 ~/.ssh/id_ed25519
-          trap 'rm -f ~/.ssh/id_ed25519' EXIT
-
-          # Pin host identity via an out-of-band secret (no TOFU/ssh-keyscan).
-          if [ -z "${HESTIA_KNOWN_HOSTS:-}" ]; then
-            echo "Missing secret MIGRATION_TARGET_KNOWN_HOSTS (pinned host key). Refusing to deploy without a verified host identity."
-            exit 1
-          fi
-          echo "$HESTIA_KNOWN_HOSTS" > ~/.ssh/known_hosts
-          chmod 644 ~/.ssh/known_hosts
-
-          # Upload to temp files, then atomically move both into place in a
-          # single remote step to avoid serving truncated or mixed-commit files.
-          for f in install.sh install.ps1; do
-            echo "Syncing $f..."
-            scp $SSH_OPTS "src/praisonai/scripts/$f" "${HESTIA_USER}@${HESTIA_HOST}:${REMOTE_WEB}/.${f}.tmp"
-          done
-
-          ssh $SSH_OPTS "${HESTIA_USER}@${HESTIA_HOST}" \
-            "mv -f ${REMOTE_WEB}/.install.sh.tmp ${REMOTE_WEB}/install.sh && \
-             mv -f ${REMOTE_WEB}/.install.ps1.tmp ${REMOTE_WEB}/install.ps1 && \
-             sudo chown hestiaadmin:hestiaadmin ${REMOTE_WEB}/install.sh ${REMOTE_WEB}/install.ps1 && \
-             sudo chmod 644 ${REMOTE_WEB}/install.sh ${REMOTE_WEB}/install.ps1"
-
-          echo "Deployed install scripts for commit ${SOURCE_SHA}"
-          echo "Verify: curl -fsSL https://praison.ai/install.ps1 | head -5"

.github/workflows/desktop-release.yml

@@ -1,267 +0,0 @@
-# Build the desktop app for macOS, Windows and Linux, and attach it to the
-# release.
-#
-# Releases carried no assets at all -- v4.7.1 shipped zero -- so there was
-# nothing for anyone to download. The macOS half of this shipped first; this
-# adds the other two, which were not merely missing from CI but impossible:
-# the bundle targets were `["app", "dmg"]`, both macOS-only, so a Windows or
-# Linux build produced zero artifacts and still exited zero.
-#
-# Unsigned, deliberately, on every platform. macOS signing needs a Developer ID
-# and Windows signing now needs a hardware-backed certificate or a hosted
-# signing service -- neither is in secrets. Shipping builds people can open
-# past the warning is better than shipping none, and the release notes say so
-# rather than letting Gatekeeper and SmartScreen say it for us.
-name: Desktop release
-
-on:
-  release:
-    types: [published]
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Existing release tag to attach the build to'
-        required: true
-
-permissions:
-  contents: write
-
-concurrency:
-  # Queue rather than cancel: a cancelled release build looks identical to a
-  # release that simply never produced assets, which is the bug being fixed.
-  group: desktop-release-${{ github.event.release.tag_name || inputs.tag }}
-  cancel-in-progress: false
-
-jobs:
-  build:
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          # macos-15, not macos-14: that image entered deprecation on
-          # 2026-07-06 and is fully unsupported from 2026-11-02, with brownout
-          # periods failing jobs before then. This is the only Apple-silicon
-          # leg, so losing it means no arm64 DMG at all.
-          - runner: macos-15        # Apple silicon
-            target: aarch64-apple-darwin
-            bundles: dmg
-            ext: dmg
-            asset: macos-apple-silicon
-          # macos-15-intel, not macos-13: that image was retired on
-          # 2025-12-04, so the leg would never schedule and the verify job
-          # below would correctly report a missing asset on every release,
-          # forever. macos-15-intel is GitHub's named x86_64 replacement.
-          - runner: macos-15-intel  # Intel
-            target: x86_64-apple-darwin
-            bundles: dmg
-            ext: dmg
-            asset: macos-intel
-          - runner: windows-latest
-            target: x86_64-pc-windows-msvc
-            bundles: nsis
-            ext: exe
-            asset: windows-x64-setup
-          # ubuntu-22.04 rather than -latest on purpose: glibc is forward
-          # compatible only, so the build host sets the *oldest* distribution
-          # the .deb can run on. Building on 24.04 would produce a package that
-          # refuses to start on 22.04 and Debian 12 with a "GLIBC_2.38 not
-          # found" that no runtime flag can fix.
-          #
-          # This image begins deprecation on 2026-09-17 and is retired on
-          # 2027-04-17. When it goes, move to `ubuntu-latest` with
-          # `container: debian:12` rather than bumping the runner -- that keeps
-          # the glibc floor decided by us instead of by GitHub's image
-          # lifecycle.
-          - runner: ubuntu-22.04
-            target: x86_64-unknown-linux-gnu
-            bundles: deb
-            ext: deb
-            asset: linux-x64
-    runs-on: ${{ matrix.runner }}
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install the Linux build dependencies
-        if: runner.os == 'Linux'
-        run: |
-          set -euo pipefail
-          # Retried: a degraded mirror otherwise burns the whole job and
-          # reports "cancelled", which reads as our failure rather than apt's.
-          for attempt in 1 2 3; do
-            sudo apt-get update && break || sleep 15
-          done
-          sudo apt-get install -y --no-install-recommends \
-            libwebkit2gtk-4.1-dev \
-            libappindicator3-dev \
-            librsvg2-dev \
-            libxdo-dev \
-            libssl-dev \
-            patchelf \
-            xdg-utils
-          # libappindicator3-dev, not the ayatana package: the .deb's generated
-          # Depends: follows whichever one the binary linked against, so the
-          # two must not be mixed between builds.
-
-      - uses: dtolnay/rust-toolchain@stable
-        with:
-          targets: ${{ matrix.target }}
-
-      - uses: swatinem/rust-cache@v2
-        with:
-          workspaces: src/praisonai-desktop/src-tauri -> target
-          # Saving the Windows target directory costs more minutes than the
-          # rebuild it saves.
-          save-if: ${{ runner.os != 'Windows' }}
-
-      - name: Install the Tauri CLI
-        shell: bash
-        # `|| true` swallowed a genuine install failure and the next step then
-        # died with an unrelated "no such command: tauri". It also behaved
-        # differently per leg, since Windows defaults to pwsh where `true` is
-        # not a command. Skip the install if it is already there; otherwise
-        # let a failure be a failure.
-        run: command -v cargo-tauri >/dev/null || cargo install tauri-cli --version '^2' --locked
-
-      - name: Set the desktop version from the release tag
-        shell: bash
-        env:
-          RELEASE_TAG: ${{ github.event.release.tag_name || inputs.tag }}
-        run: node src/praisonai-desktop/tools/set-release-version.mjs "$RELEASE_TAG"
-
-      - name: Build the bundle
-        working-directory: src/praisonai-desktop/src-tauri
-        run: cargo tauri build --target ${{ matrix.target }} --bundles ${{ matrix.bundles }}
-
-      - name: The Windows binary must carry the release version
-        if: runner.os == 'Windows'
-        shell: pwsh
-        working-directory: src/praisonai-desktop/src-tauri
-        env:
-          RELEASE_TAG: ${{ github.event.release.tag_name || inputs.tag }}
-        run: |
-          $expected = $env:RELEASE_TAG -replace '^v', ''
-          $core = ($expected -split '[-+]')[0]
-          $exe = "target/${{ matrix.target }}/release/praisonai-desktop.exe"
-          $version = (Get-Item $exe).VersionInfo
-          Write-Host "ProductVersion=$($version.ProductVersion) FileVersion=$($version.FileVersion)"
-
-          if ($version.ProductVersion -ne $expected) {
-            throw "ProductVersion $($version.ProductVersion) does not match $expected"
-          }
-
-          # Compare the three components that carry meaning, not the string.
-          #
-          # This gate blocked the v4.7.4 Windows build with
-          #   FileVersion 4.7.4 does not match 4.7.4.0
-          # It appended ".0" and compared literally, but Windows reports what
-          # was stamped -- three parts here. The stamping was correct and the
-          # check was not, so the release shipped with no Windows installer at
-          # all: the one platform it was cut to fix.
-          #
-          # [version] normalises a missing fourth component to -1, so both
-          # "4.7.4" and "4.7.4.0" compare equal on major.minor.build.
-          $got = [version]$version.FileVersion
-          $want = [version]$core
-          if ($got.Major -ne $want.Major -or
-              $got.Minor -ne $want.Minor -or
-              $got.Build -ne $want.Build) {
-            throw "FileVersion $($version.FileVersion) does not match $core"
-          }
-
-      - name: The macOS bundle must carry a valid signature
-        if: runner.os == 'macOS'
-        working-directory: src/praisonai-desktop/src-tauri
-        run: |
-          set -euo pipefail
-          dmg="$(find "target/${{ matrix.target }}/release/bundle" -name '*.dmg' -print -quit)"
-          [ -n "$dmg" ] || { echo "no .dmg was produced"; exit 1; }
-
-          # Verify inside the DMG, not the .app beside it.
-          #
-          # Tauri deletes the app bundle once the DMG is built -- the build log
-          # says so plainly ("Cleaning .../bundle/macos/PraisonAI.app") -- so a
-          # gate that looked for the .app found nothing and failed every macOS
-          # leg. Reading the DMG is also the better check: it is the artifact
-          # people download, and the one that was broken.
-          #
-          # v4.7.2 shipped a DMG that macOS called "damaged and can't be
-          # opened" on every Mac. The cause was not the missing Developer ID:
-          # the only signature was the one rustc's linker puts on the bare
-          # executable, whose CodeDirectory declares a resource seal that an
-          # unsigned bundle does not have --
-          #
-          #   Sealed Resources=none
-          #   code has no resources but signature indicates they must be present
-          #
-          # That is an *invalid* signature, not an unsigned one, and macOS
-          # reports invalid as "damaged". Right-click -> Open cannot bypass it,
-          # so the instructions shipped alongside it could not work either.
-          mnt="$(mktemp -d)"
-          hdiutil attach -nobrowse -readonly -quiet -mountpoint "$mnt" "$dmg"
-          trap 'hdiutil detach "$mnt" -quiet || true' EXIT
-
-          app="$(find "$mnt" -maxdepth 1 -name '*.app' -print -quit)"
-          [ -n "$app" ] || { echo "the DMG contains no .app"; ls -la "$mnt"; exit 1; }
-
-          echo "verifying $app"
-          codesign --verify --deep --strict --verbose=2 "$app"
-          # Printed, not asserted: --verify already fails on the exact bundle
-          # that shipped, so a second check for the same thing would only be a
-          # second way to say it. This is here to make the log readable.
-          codesign -dv --verbose=2 "$app" 2>&1 | grep -E 'Sealed Resources|flags=' || true
-
-      - name: Name the artifact for the platform it runs on
-        id: artifact
-        shell: bash
-        working-directory: src/praisonai-desktop/src-tauri
-        run: |
-          set -euo pipefail
-          tag="${{ github.event.release.tag_name || inputs.tag }}"
-          root="target/${{ matrix.target }}/release/bundle"
-          found="$(find "$root" -name "*.${{ matrix.ext }}" -print -quit || true)"
-          # Fail loudly rather than uploading nothing: an empty release asset
-          # list is exactly the state this workflow exists to fix, and a bundler
-          # given a target it does not support exits zero having written none.
-          if [ -z "$found" ]; then
-            echo "no .${{ matrix.ext }} was produced under $root"
-            find "$root" -type f -print || echo "(the bundle directory does not exist)"
-            exit 1
-          fi
-          out="PraisonAI-${tag}-${{ matrix.asset }}.${{ matrix.ext }}"
-          mv "$found" "../$out"
-          echo "path=src/praisonai-desktop/$out" >> "$GITHUB_OUTPUT"
-
-      - name: Attach it to the release
-        shell: bash
-        env:
-          GH_TOKEN: ${{ github.token }}
-        run: |
-          gh release upload \
-            "${{ github.event.release.tag_name || inputs.tag }}" \
-            "${{ steps.artifact.outputs.path }}" --clobber
-
-  verify:
-    # A release with a missing platform is worse than an obviously failed
-    # build, because nobody notices. This says which one is absent.
-    needs: build
-    if: always()
-    runs-on: ubuntu-latest
-    steps:
-      - name: Check every platform produced an asset
-        env:
-          GH_TOKEN: ${{ github.token }}
-          TAG: ${{ github.event.release.tag_name || inputs.tag }}
-        run: |
-          set -euo pipefail
-          assets="$(gh release view "$TAG" --repo "$GITHUB_REPOSITORY" \
-                      --json assets -q '.assets[].name')"
-          echo "$assets"
-          missing=""
-          for want in macos-apple-silicon macos-intel windows-x64-setup linux-x64; do
-            echo "$assets" | grep -q -- "$want" || missing="$missing $want"
-          done
-          if [ -n "$missing" ]; then
-            echo "::error::the release is missing:$missing"
-            exit 1
-          fi
-          echo "all four platform builds are attached"

.github/workflows/desktop.yml

@@ -1,115 +0,0 @@
-# The desktop app's tests.
-#
-# These existed and ran nowhere: no workflow referenced praisonai-desktop, and
-# the frontend suite could not even be installed -- jsdom was undeclared, so it
-# ran only on machines that happened to have one further up the tree, at
-# whatever version that happened to be.
-name: desktop
-
-on:
-  push:
-    branches: [main]
-    paths: ['src/praisonai-desktop/**', '.github/workflows/desktop.yml',
-            '.github/workflows/desktop-release.yml']
-  pull_request:
-    paths: ['src/praisonai-desktop/**', '.github/workflows/desktop.yml',
-            '.github/workflows/desktop-release.yml']
-
-concurrency:
-  group: desktop-${{ github.ref }}
-  cancel-in-progress: true
-
-defaults:
-  run:
-    working-directory: src/praisonai-desktop
-
-jobs:
-  engine:
-    name: engine (${{ matrix.os }})
-    # The engine is the part that has to behave the same on all three, which is
-    # the entire point of the portability suite -- so it is run on all three.
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-22.04, macos-15, windows-latest]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-      - name: Run the engine tests
-        shell: bash
-        env:
-          # Never touch a real keychain on a shared runner.
-          PRAISONAI_KEYCHAIN_SERVICE: ai.praison.desktop.ci
-        run: |
-          set -euo pipefail
-          failed=0
-          for suite in engine/test_*.py; do
-            echo "::group::$suite"
-            python "$suite" -v || failed=1
-            echo "::endgroup::"
-          done
-          exit $failed
-
-  frontend:
-    name: frontend
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-      - run: npm ci
-      # `test:ci` is every suite except lifecycle, which drives real
-      # conversations against a live engine and a real model -- neither of
-      # which exists on a runner. It is excluded by name rather than left to
-      # skip quietly, so that a skipped test here is a genuine problem.
-      - name: Run the UI tests
-        # A suite that skips everything still exits 0 -- that is how thirteen
-        # tests came to look like a pass while proving nothing. So the skip
-        # count is asserted, not just the exit status.
-        run: |
-          set -euo pipefail
-          set -o pipefail
-          npm run test:ci 2>&1 | tee "$RUNNER_TEMP/ui.log"
-          skipped=$(grep -E '^. skipped ' "$RUNNER_TEMP/ui.log" | grep -oE '[0-9]+$' | head -1)
-          echo "skipped: ${skipped:-unknown}"
-          test "${skipped:-1}" -eq 0
-
-  shell:
-    name: shell (${{ matrix.os }})
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-22.04, macos-15, windows-latest]
-    defaults:
-      run:
-        working-directory: src/praisonai-desktop/src-tauri
-    steps:
-      - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
-        with:
-          components: clippy
-      - uses: Swatinem/rust-cache@v2
-        with:
-          workspaces: src/praisonai-desktop/src-tauri
-          # The Windows cache is large and slow enough to cost more than it saves.
-          save-if: ${{ runner.os != 'Windows' }}
-      - name: Install the Linux build dependencies
-        if: runner.os == 'Linux'
-        working-directory: .
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y --no-install-recommends \
-            libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev \
-            libxdo-dev libssl-dev patchelf
-      - name: Test
-        # Debug info is the bulk of a Tauri target directory and nothing here
-        # reads a backtrace, so building without it keeps the runner's disk
-        # from filling on the Windows leg.
-        run: cargo test --config 'profile.test.debug=false' --config 'profile.dev.debug=false'
-      - name: Clippy
-        run: cargo clippy --all-targets -- -D warnings

.github/workflows/docker-publish.yml

@@ -20,8 +20,6 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
-        with:
-          persist-credentials: false
 
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3

.github/workflows/gemini-issue-automated-triage.yml

@@ -1,10 +1,8 @@
 name: Gemini Automated Issue Triage
 
-# on:
-#   issue_comment:
-#     types: [created]
 on:
-  workflow_dispatch:
+  issue_comment:
+    types: [created]
 
 jobs:
   triage-issue:
@@ -35,7 +33,6 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
-          persist-credentials: false
           token: ${{ steps.generate_token.outputs.token }}
 
       - name: Run Gemini Issue Triage

.github/workflows/gemini-issue-review.yml

@@ -2,8 +2,8 @@ name: Gemini Issue Review
 
 on:
   workflow_dispatch:
-#   issue_comment:
-#     types: [created]
+  issue_comment:
+    types: [created]
 
 permissions:
   contents: write
@@ -20,8 +20,7 @@ jobs:
        !contains(github.event.comment.body, '@gemini triage') &&
        (github.event.comment.author_association == 'OWNER' ||
         github.event.comment.author_association == 'MEMBER' ||
-        github.event.comment.author_association == 'COLLABORATOR' ||
-        github.event.comment.author_association == 'CONTRIBUTOR'))
+        github.event.comment.author_association == 'COLLABORATOR'))
     runs-on: ubuntu-latest
     env:
       GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
@@ -36,13 +35,12 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
-          persist-credentials: false
           token: ${{ steps.generate_token.outputs.token }}
 
       - name: Set up Git
         run: |
-          git config --local user.email "[email protected].github.com"
-          git config --local user.name "MervinPraison"
+          git config --local user.email "gemini-bot@github.com"
+          git config --local user.name "Gemini Bot"
 
       - name: Get issue data
         id: issue_data
@@ -77,16 +75,16 @@ jobs:
           echo "ADDITIONAL_INSTRUCTIONS=$ADDITIONAL_INSTRUCTIONS" >> $GITHUB_OUTPUT
 
       - name: Run Gemini CLI
-        uses: google-github-actions/run-gemini-cli@v0
+        uses: ./.github/actions/gemini
         env:
-          GH_TOKEN: ${{ steps.generate_token.outputs.token }}
           GITHUB_TOKEN: ${{ steps.generate_token.outputs.token }}
           ISSUE_NUMBER: ${{ steps.issue_data.outputs.ISSUE_NUMBER }}
           ADDITIONAL_INSTRUCTIONS: ${{ steps.issue_data.outputs.ADDITIONAL_INSTRUCTIONS }}
           REPOSITORY: ${{ github.repository }}
         with:
-          gemini_api_key: ${{ secrets.GEMINI_API_KEY }}
-          gemini_model: 'gemini-2.5-flash'
+          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+          OTLP_GCP_WIF_PROVIDER: ${{ secrets.OTLP_GCP_WIF_PROVIDER }}
+          OTLP_GOOGLE_CLOUD_PROJECT: ${{ secrets.OTLP_GOOGLE_CLOUD_PROJECT }}
           prompt: |
             You are a helpful GitHub issue assistant. Your task is to analyze and help with GitHub issues.
             
@@ -105,8 +103,6 @@ jobs:
             - Search codebase for related files using `glob`, `search_file_content`, `list_directory`
             
             **STEP 2: If Code Changes Are Needed**
-            MANDATORY FIRST STEP: Before writing any code, you MUST use `read_file` to carefully read "src/praisonai-agents/AGENTS.md". You must honor this repository's extremely specific Architecture, Protocol-First design rules, and Agent-Centric Philosophy!
-            
             Create a new branch with 'gemini/' prefix:
             - Use: `git checkout -b gemini/issue-${ISSUE_NUMBER}-description`
             - Example: `git checkout -b gemini/issue-123-fix-sequential-tools`
@@ -165,7 +161,7 @@ jobs:
             
             Please proceed with helping resolve this issue following this exact workflow.
 
-          settings: |
+          settings_json: |
             {
               "coreTools": [
                 "run_shell_command(echo)",
@@ -197,5 +193,10 @@ jobs:
                 "web_fetch",
                 "google_web_search",
                 "save_memory"
-              ]
+              ],
+              "telemetry": {
+                "enabled": false,
+                "otlpGcpWifProvider": "${{ secrets.OTLP_GCP_WIF_PROVIDER }}",
+                "googleCloudProject": "${{ secrets.OTLP_GOOGLE_CLOUD_PROJECT }}"
+              }
             }

.github/workflows/gemini-pr-review.yml

@@ -1,8 +1,8 @@
 name: Gemini PR Review
 
 on:
-#   issue_comment:
-#     types: [created]
+  issue_comment:
+    types: [created]
   workflow_dispatch:
     inputs:
       pr_number:
@@ -47,7 +47,6 @@ jobs:
       - name: Checkout PR code
         uses: actions/checkout@v4
         with:
-          persist-credentials: false
           token: ${{ steps.generate_token.outputs.token }}
           ref: ${{ steps.checkout_ref.outputs.ref }}
           fetch-depth: 0
@@ -160,8 +159,6 @@ jobs:
             - Analyze the code changes thoroughly
 
             **STEP 2: If Code Improvements Are Needed**
-            MANDATORY FIRST STEP: Before writing any code, you MUST use `read_file` to carefully read "src/praisonai-agents/AGENTS.md". You must honor this repository's extremely specific Architecture, Protocol-First design rules, and Agent-Centric Philosophy!
-            
             **IMPORTANT:** DO NOT create a new branch! Work on the EXISTING PR branch.
             - Use: `git fetch origin` to get latest changes
             - Get PR branch name: `gh pr view ${PR_NUMBER} --json headRefName`

.github/workflows/integration-cross-repo.yml

@@ -1,165 +0,0 @@
-name: Cross-Repo Integration Tests
-
-on:
-  push:
-    branches: [ main ]
-    paths:
-      - 'src/praisonai/praisonai/integration/**'
-      - 'src/praisonai/tests/integration/test_aiui_*'
-      - 'src/praisonai/pyproject.toml'
-      - 'src/praisonai-code/**'
-      - '.github/workflows/integration-cross-repo.yml'
-      - '.github/actions/install-monorepo-packages/**'
-  pull_request:
-    branches: [ main ]
-    paths:
-      - 'src/praisonai/praisonai/integration/**'
-      - 'src/praisonai/tests/integration/test_aiui_*'
-      - 'src/praisonai/pyproject.toml'
-      - 'src/praisonai-code/**'
-      - '.github/workflows/integration-cross-repo.yml'
-      - '.github/actions/install-monorepo-packages/**'
-  workflow_dispatch:
-
-jobs:
-  cross-repo-integration:
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    
-    steps:
-    - name: Checkout PraisonAI
-      uses: actions/checkout@v4
-      with:
-        path: PraisonAI
-        ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
-        
-    - name: Checkout PraisonAIUI
-      uses: actions/checkout@v4
-      with:
-        repository: MervinPraison/PraisonAIUI
-        path: PraisonAIUI
-        ref: main
-        
-    - name: Set up Python
-      uses: actions/setup-python@v4
-      with:
-        python-version: '3.11'
-        
-    - name: Install dependencies
-      run: python -m pip install --upgrade pip
-    - uses: PraisonAI/.github/actions/install-monorepo-packages
-      with:
-        repo-root: PraisonAI/
-        wrapper-extras: ".[ui,dev]"
-    - name: Install PraisonAIUI
-      run: |
-        cd PraisonAIUI
-        pip install -e .
-        pip install pytest pytest-cov
-        
-    - name: Verify versions
-      run: |
-        python -c "import praisonaiagents; print(f'praisonaiagents: {praisonaiagents.__version__}')"
-        python -c "import praisonai; print(f'praisonai: {praisonai.__version__}')"
-        python -c "import praisonaiui; print(f'praisonaiui: {praisonaiui.__version__}')"
-        
-    - name: Run PraisonAI integration tests
-      run: |
-        cd PraisonAI/src/praisonai
-        python -m pytest tests/integration/test_aiui_* -v
-        
-    - name: Run PraisonAIUI integration tests
-      run: |
-        cd PraisonAIUI
-        if [ -f tests/integration/test_agentic_roundtrip.py ]; then
-          python -m pytest tests/integration/test_agentic_roundtrip.py -v
-        fi
-        if [ -f tests/test_feature_sdk_backends.py ]; then
-          python -m pytest tests/test_feature_sdk_backends.py -v
-        fi
-        
-    - name: Test Pattern C CLI
-      run: |
-        cd PraisonAI/src/praisonai
-        # Test that ui-gateway command exists
-        python -m praisonai serve --help | grep ui-gateway
-        
-    - name: Test public API exports
-      run: |
-        cd PraisonAI/src/praisonai
-        python -c "from praisonai import run_integrated_gateway; print('✓ run_integrated_gateway imported')"
-        python -c "from praisonai import configure_host; print('✓ configure_host imported')"
-        
-    - name: Integration smoke test
-      env:
-        PRAISONAI_TEST_MODE: "1"
-        PYTHONPATH: ${{ github.workspace }}/PraisonAI/src/praisonai:${{ github.workspace }}/PraisonAI/src/praisonai-agents:${{ github.workspace }}/PraisonAIUI
-      run: |
-        cd PraisonAI/src/praisonai
-        python -c "
-        import sys
-        sys.path.insert(0, '.')
-        from praisonai.integration.host_app import configure_host
-        from praisonai import run_integrated_gateway
-        print('✓ Integration imports successful')
-        
-        # Test configure_host with new parameters
-        try:
-            configure_host(
-                style='dashboard', 
-                context_paths=['AGENTS.md'],
-                title='Test App'
-            )
-            print('✓ configure_host with new parameters works')
-        except Exception as e:
-            print(f'× configure_host failed: {e}')
-            sys.exit(1)
-        "
-        
-  # Optional job with API key for agentic tests (if secret is available)
-  agentic-integration:
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    if: ${{ vars.RUN_AGENTIC_TESTS == 'true' }}
-    needs: cross-repo-integration
-    
-    steps:
-    - name: Checkout PraisonAI
-      uses: actions/checkout@v4
-      with:
-        path: PraisonAI
-        ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
-        
-    - name: Checkout PraisonAIUI
-      uses: actions/checkout@v4
-      with:
-        repository: MervinPraison/PraisonAIUI
-        path: PraisonAIUI
-        ref: main
-        
-    - name: Set up Python
-      uses: actions/setup-python@v4
-      with:
-        python-version: '3.11'
-        
-    - name: Install dependencies
-      run: python -m pip install --upgrade pip
-    - uses: PraisonAI/.github/actions/install-monorepo-packages
-      with:
-        repo-root: PraisonAI/
-        wrapper-extras: ".[ui,dev]"
-    - name: Install PraisonAIUI
-      run: |
-        cd PraisonAIUI
-        pip install -e .
-        
-    - name: Run agentic integration test
-      env:
-        OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-      run: |
-        cd PraisonAI/src/praisonai
-        if [ -n "$OPENAI_API_KEY" ]; then
-          python -m pytest tests/integration/test_aiui_host_agentic.py -v
-        else
-          echo "OPENAI_API_KEY not available, skipping agentic tests"
-        fi

.github/workflows/merge-conflict-claude.yml

@@ -1,185 +0,0 @@
-name: Auto Merge Conflict → Claude
-
-# Detects internal PRs with mergeStateStatus=DIRTY and posts @claude to trigger claude.yml.
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    types: [opened, synchronize, reopened]
-  workflow_dispatch:
-  schedule:
-    - cron: '0 */6 * * *'
-
-concurrency:
-  group: merge-conflict-scan-${{ github.repository }}-${{ github.event.pull_request.number || github.run_id }}
-  cancel-in-progress: true
-
-env:
-  # PAT posts as MervinPraison so issue_comment triggers claude.yml (GITHUB_TOKEN cannot chain workflows)
-  GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
-
-permissions:
-  pull-requests: write
-  issues: write
-
-jobs:
-  detect-and-trigger:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Detect conflicting PRs and trigger Claude
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ env.GH_TOKEN }}
-          script: |
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-            const baseRepo = `${owner}/${repo}`;
-            const COOLDOWN_MS = 12 * 60 * 60 * 1000;
-            const AUTO_ACTORS = ['github-actions[bot]', 'MervinPraison'];
-            const LABEL = 'claude-conflict-pending';
-            const COMMENT_BODY = [
-              '@claude this PR has merge conflicts with `main`.',
-              'Please rebase onto latest `main`, resolve conflicts (keep this PR\'s intent, merge in newer main logic),',
-              'run targeted tests, and force-push with `--force-with-lease`.',
-              'Comment which files you resolved.',
-              'Do not bloat the Agent class with additional params — only if absolutely required; we already support many params.',
-              'Keep the resolution minimal — the aim is a lightweight and powerful package; do not introduce scope creep while resolving conflicts.',
-            ].join(' ');
-
-            const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-
-            async function getMergeState(prNumber) {
-              const query = `
-                query($owner: String!, $repo: String!, $number: Int!) {
-                  repository(owner: $owner, name: $repo) {
-                    pullRequest(number: $number) {
-                      mergeStateStatus
-                      maintainerCanModify
-                      isDraft
-                      headRef { repository { nameWithOwner } }
-                    }
-                  }
-                }
-              `;
-              for (let attempt = 0; attempt < 3; attempt++) {
-                const result = await github.graphql(query, { owner, repo, number: prNumber });
-                const prGql = result.repository.pullRequest;
-                const status = (prGql?.mergeStateStatus || '').toUpperCase();
-                if (status && status !== 'UNKNOWN') {
-                  return {
-                    status,
-                    isDraft: prGql.isDraft,
-                    headRepo: prGql.headRef?.repository?.nameWithOwner,
-                    maintainerCanModify: prGql.maintainerCanModify === true,
-                  };
-                }
-                if (attempt < 2) await sleep(10000);
-              }
-              const pr = await github.rest.pulls.get({ owner, repo, pull_number: prNumber });
-              return {
-                status: (pr.data.mergeable_state || '').toUpperCase(),
-                isDraft: pr.data.draft,
-                headRepo: pr.data.head.repo?.full_name,
-                maintainerCanModify: pr.data.maintainer_can_modify === true,
-              };
-            }
-
-            function hasFinalClaudeReviewTrigger(comments) {
-              return comments.some((c) => {
-                const body = (c.body || '').toLowerCase();
-                if (!AUTO_ACTORS.includes(c.user.login)) return false;
-                if (!body.includes('@claude')) return false;
-                if (body.includes('merge conflict')) return false;
-                return body.includes('final architecture reviewer') || body.includes('lead engineer');
-              });
-            }
-
-            function hasRecentAutoComment(comments) {
-              const cutoff = Date.now() - COOLDOWN_MS;
-              return comments.some((c) => {
-                if (!AUTO_ACTORS.includes(c.user.login)) return false;
-                const body = (c.body || '').toLowerCase();
-                if (!body.includes('@claude') || !body.includes('merge conflict')) return false;
-                return new Date(c.created_at).getTime() > cutoff;
-              });
-            }
-
-            async function processPR(prNumber) {
-              const { status, isDraft, headRepo, maintainerCanModify } = await getMergeState(prNumber);
-              core.info(`PR #${prNumber}: mergeState=${status}, head=${headRepo}, draft=${isDraft}, maintainerCanModify=${maintainerCanModify}`);
-
-              const { data: issue } = await github.rest.issues.get({
-                owner,
-                repo,
-                issue_number: prNumber,
-              });
-              const labels = issue.labels.map((l) => l.name);
-
-              if (status !== 'DIRTY' && labels.includes(LABEL)) {
-                await github.rest.issues.removeLabel({
-                  owner,
-                  repo,
-                  issue_number: prNumber,
-                  name: LABEL,
-                });
-                core.info(`Removed ${LABEL} from PR #${prNumber}`);
-              }
-
-              if (status !== 'DIRTY') return { skipped: true, reason: 'not dirty' };
-              if (isDraft) return { skipped: true, reason: 'draft' };
-              if (headRepo && headRepo !== baseRepo && !maintainerCanModify) {
-                return { skipped: true, reason: 'fork without maintainer edits' };
-              }
-              if (labels.includes(LABEL)) {
-                return { skipped: true, reason: 'conflict resolution pending' };
-              }
-
-              const { data: comments } = await github.rest.issues.listComments({
-                owner,
-                repo,
-                issue_number: prNumber,
-                per_page: 100,
-              });
-              if (hasRecentAutoComment(comments)) {
-                return { skipped: true, reason: 'recent auto comment' };
-              }
-
-              if (!hasFinalClaudeReviewTrigger(comments)) {
-                return { skipped: true, reason: 'awaiting final claude review trigger' };
-              }
-
-              await github.rest.issues.addLabels({
-                owner,
-                repo,
-                issue_number: prNumber,
-                labels: [LABEL],
-              });
-              await github.rest.issues.createComment({
-                owner,
-                repo,
-                issue_number: prNumber,
-                body: COMMENT_BODY,
-              });
-              return { triggered: true };
-            }
-
-            let prNumbers = [];
-            if (context.eventName === 'pull_request') {
-              prNumbers = [context.payload.pull_request.number];
-            } else {
-              const prs = await github.paginate(github.rest.pulls.list, {
-                owner,
-                repo,
-                state: 'open',
-                per_page: 100,
-              });
-              prNumbers = prs.map((p) => p.number);
-            }
-
-            const results = [];
-            for (const num of prNumbers) {
-              results.push({ pr: num, ...(await processPR(num)) });
-            }
-            core.summary.addRaw('```json\n' + JSON.stringify(results, null, 2) + '\n```');
-            await core.summary.write();

.github/workflows/mobile-platforms.yml

@@ -1,351 +0,0 @@
-# The mobile package's PLATFORM builds: a real iOS app and a real Android app.
-#
-# mobile.yml proves the crate type-checks for a phone (`cargo check` against
-# the two mobile targets). This proves the two generated platform projects,
-# src-tauri/gen/apple and src-tauri/gen/android, still turn that crate into an
-# installable app -- which is a different thing, and the thing that had never
-# happened: until #4673 neither project existed.
-#
-# What each job produces, and why that shape:
-#
-#   ios-simulator  -- an UNSIGNED arm64 simulator .app. A device build needs
-#                     an Apple Developer Team and a signing identity, which are
-#                     the maintainer's and not in this repo (bundle.iOS.
-#                     developmentTeam is unset in tauri.conf.json). A simulator
-#                     build needs neither, so it is the build that can run on
-#                     every PR. It is not decoration: it links the Rust
-#                     staticlib into the Xcode target, packages the webview
-#                     into the bundle and exercises Info.plist, i.e. every step
-#                     short of the certificate.
-#   android-apk    -- a debug APK, arm64-v8a. Debug because a release APK
-#                     needs a signing keystore, which is likewise the
-#                     maintainer's; the debug keystore is generated on the
-#                     runner. It installs on any arm64 Android 8.0+ device with
-#                     `adb install`.
-#
-# Both jobs fail if the thing they exist to produce is missing. The bundler
-# exits zero on a target it silently skipped (desktop-release.yml learned this
-# the hard way), so "the step passed" is not evidence; "the file exists and
-# contains the Rust library" is.
-#
-# The Xcode project is generated on the macOS runner the first time (this
-# laptop has no Xcode, only the Command Line Tools) and then committed, so
-# the init step is a no-op once gen/apple is in the tree. The Android project
-# was generated locally and is committed; the same guard keeps that job
-# honest if someone deletes it.
-name: mobile platforms
-
-on:
-  workflow_dispatch:
-  pull_request:
-    paths: &watched
-      - 'src/praisonai-mobile/**'
-      - 'src/praisonai-ts/src/**'
-      - '.github/workflows/mobile-platforms.yml'
-  # Without this, no platform build had ever run on main -- so a break
-  # introduced by two PRs that were each green apart could sit on main
-  # unnoticed. That is exactly what happened: #4737 branched from before
-  # #4727 added the `file:` dependency, so the two were never installed
-  # together until they had both landed.
-  push:
-    branches: [main]
-    paths: *watched
-
-concurrency:
-  # Per-ref on a PR, per-SHA on main. This is the crux of the fix, not
-  # cancel-in-progress alone: a concurrency group holds at most ONE
-  # running run and ONE pending run, and a newer arrival always replaces
-  # the pending one -- cancel-in-progress: false spares only the RUNNING
-  # run, never the queued one. So with a single mobile-platforms-main
-  # group, three merges in one ~3-minute window would still drop the
-  # middle commit's run (it is only ever pending), which is precisely the
-  # blindness the push trigger was added to remove. Giving each main SHA
-  # its own group makes every commit a candidate release with its own
-  # answer, with nothing to contend for and so nothing to cancel.
-  group: mobile-platforms-${{ github.ref == 'refs/heads/main' && github.sha || github.ref }}
-  # On a PR, superseding an in-flight build is right: only the tip
-  # matters and these jobs cost ~3 minutes on two runners. On main each
-  # group has a single run, so this is a no-op there -- left true because
-  # the condition that mattered is now expressed in the group name above,
-  # and this keeps the PR behaviour explicit.
-  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
-
-defaults:
-  run:
-    working-directory: src/praisonai-mobile
-
-jobs:
-  ios-simulator:
-    name: ios simulator (.app, unsigned)
-    runs-on: macos-15
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22.18'
-          cache: npm
-          cache-dependency-path: src/praisonai-mobile/package-lock.json
-      - uses: dtolnay/rust-toolchain@stable
-        with:
-          # Both: `tauri ios init` installs whatever it thinks is missing via
-          # rustup, and having them already present keeps that step quiet and
-          # deterministic. aarch64-apple-ios-sim is the one the build below
-          # actually links against.
-          targets: aarch64-apple-ios,aarch64-apple-ios-sim
-      - uses: Swatinem/rust-cache@v2
-        with:
-          workspaces: src/praisonai-mobile/src-tauri
-          key: ios-sim
-      - name: "Build praisonai-ts (the file: dependency)"
-        # praisonai-mobile depends on praisonai by `file:`, so `npm ci`
-        # here runs praisonai-ts's own `prepare` -> `rimraf dist`. On a
-        # fresh runner praisonai-ts has no node_modules, so rimraf is not
-        # installed and `npm ci` dies with code 127 before a single
-        # platform step runs. mobile.yml gives all four of its jobs this
-        # step; these two were written against the tree from before the
-        # dependency existed and never got it.
-        working-directory: src/praisonai-ts
-        run: |
-          npm install --no-audit --no-fund --legacy-peer-deps
-          npm run build
-      - run: npm ci
-
-      - name: Generate the Xcode project (only if gen/apple is not committed)
-        # `tauri ios init` renders the template and then runs `xcodegen`, a
-        # brew package the CLI would otherwise try to install itself, mid-run,
-        # with a prompt. Installing it up front is the same outcome without
-        # the prompt. cocoapods is only invoked when the config declares pods;
-        # it declares none.
-        run: |
-          set -euo pipefail
-          if [ -d src-tauri/gen/apple ]; then
-            echo "src-tauri/gen/apple is committed; not regenerating it"
-            exit 0
-          fi
-          brew list xcodegen >/dev/null 2>&1 || brew install xcodegen
-          npx tauri ios init --ci --skip-targets-install
-
-      - name: Put the real AppIcon set into the Xcode project
-        # `tauri ios init` renders the CLI's OWN placeholder AppIcon PNGs into
-        # gen/apple/Assets.xcassets, and nothing in the CLI ever replaces them:
-        # `tauri icon` writes to src-tauri/icons/ios/ and stops there (it wires
-        # up gen/android, but there is no iOS equivalent). So the copy is done
-        # here, and every filename matches one-for-one -- both sides are named
-        # by the same Contents.json.
-        #
-        # Idempotent, and it runs whether or not init just ran, so a
-        # regenerated project cannot silently ship Tauri's icon as ours.
-        run: |
-          set -euo pipefail
-          dest=src-tauri/gen/apple/Assets.xcassets/AppIcon.appiconset
-          test -d "$dest" || { echo "::error::$dest does not exist"; find src-tauri/gen/apple -maxdepth 3 -print; exit 1; }
-          cp src-tauri/icons/ios/*.png "$dest/"
-          ls "$dest" | wc -l
-
-      - name: Build the simulator app, unsigned
-        # --target aarch64-sim: the iphonesimulator SDK, arm64 (the runner is
-        #   Apple silicon, and so is every Mac that will run the simulator).
-        # --no-sign: xcodebuild with CODE_SIGNING_ALLOWED=NO. For the
-        #   simulator SDK the CLI then lifts PraisonAI.app straight out of the
-        #   xcarchive instead of exporting an IPA (crates/tauri-cli/src/mobile/
-        #   ios/build.rs, the `target.sdk == "iphonesimulator"` branch), which
-        #   is exactly the artifact a simulator installs.
-        # --debug: the dev profile links in seconds rather than minutes, and a
-        #   simulator build is never the one that ships.
-        run: npx tauri ios build --debug --target aarch64-sim --no-sign --ci
-
-      - name: Is there an app, and is the Rust inside it?
-        id: app
-        run: |
-          set -euo pipefail
-          root=src-tauri/gen/apple/build
-          # Printed before anything is asserted, so a failure here is
-          # diagnosable from the log alone rather than costing another run.
-          echo "--- what the build left behind"
-          find "$root" -maxdepth 3 -print 2>/dev/null | head -40 || echo "(no build directory)"
-
-          # Prefer the simulator export dir (build/arm64-sim, the `arch` of the
-          # aarch64-sim target); fall back to any .app so the error message can
-          # say what WAS built. The name is not hardcoded: it comes from
-          # productName via the CLI, and guessing it wrong is what failed here
-          # the first time.
-          app="$(find "$root" -type d -name '*.app' -path '*arm64-sim*' -print -quit 2>/dev/null || true)"
-          [ -n "$app" ] || app="$(find "$root" -type d -name '*.app' -print -quit 2>/dev/null || true)"
-          if [ -z "$app" ]; then
-            echo "::error::no .app was produced under $root"
-            exit 1
-          fi
-          echo "app: $app"
-
-          # The executable's name comes from the bundle itself for the same
-          # reason.
-          exe="$app/$(plutil -extract CFBundleExecutable raw "$app/Info.plist")"
-          test -f "$exe" || { echo "::error::$app has no executable"; ls -la "$app"; exit 1; }
-          file "$exe"
-          file "$exe" | grep -q 'arm64' || { echo "::error::the executable is not arm64"; exit 1; }
-
-          # iOS links the Rust in as a staticlib, so unlike Android there is no
-          # .so to look for -- the crate is INSIDE this binary, and its symbols
-          # are the only real evidence it got there. An .app that built without
-          # it would be the Swift template alone.
-          #
-          # Dumped to files rather than piped into `grep -q`: grep exits on the
-          # FIRST match, the dumper then dies of SIGPIPE, and `set -o pipefail`
-          # reports that as a failed pipeline -- so the check failed precisely
-          # BECAUSE it found what it was looking for. It cost a CI run.
-          nm -a "$exe" > "$RUNNER_TEMP/symbols.txt" 2>/dev/null || true
-          strings -a "$exe" > "$RUNNER_TEMP/strings.txt" 2>/dev/null || true
-          if grep -qi 'praisonai_mobile\|start_app' "$RUNNER_TEMP/symbols.txt" \
-            || grep -qi 'praisonai_mobile' "$RUNNER_TEMP/strings.txt"; then
-            echo "the Rust crate is linked into the executable"
-          else
-            echo "::error::the Rust library is not linked into $exe"
-            exit 1
-          fi
-
-          # The frontend is embedded in that same binary by generate_context!,
-          # not copied into the bundle as a resource, so it is checked the same
-          # way rather than by looking for an index.html that is never there.
-          plutil -p "$app/Info.plist" | grep -E 'CFBundleIdentifier|CFBundleShortVersionString|MinimumOSVersion|UIDeviceFamily'
-          test -f "$app/Assets.car" || echo "note: no compiled asset catalog in the bundle"
-          du -sh "$app"
-
-          # ditto, not zip: it keeps the bundle's symlinks and modes, which is
-          # the difference between an .app the simulator installs and one it
-          # rejects as an invalid bundle.
-          ditto -c -k --keepParent "$app" "$RUNNER_TEMP/PraisonAI-ios-simulator.app.zip"
-          ls -la "$RUNNER_TEMP/PraisonAI-ios-simulator.app.zip"
-
-      - name: Upload the simulator app
-        uses: actions/upload-artifact@v4
-        with:
-          name: PraisonAI-ios-simulator-app
-          path: ${{ runner.temp }}/PraisonAI-ios-simulator.app.zip
-          if-no-files-found: error
-          retention-days: 30
-
-      - name: Package gen/apple for committing
-        # always(): the project is generated by `init`, so it is worth having
-        # even on a run whose BUILD failed -- that is exactly the run where
-        # someone needs to look at it.
-        if: always()
-        # Only what `git add src-tauri/gen/apple` would take: the template's
-        # own .gitignore excludes build/, xcuserdata/ and Externals/, and this
-        # respects it instead of re-listing them here. Nothing to upload when
-        # the project was already committed -- the guard above skipped init.
-        run: |
-          set -euo pipefail
-          files="$(git ls-files --others --exclude-standard src-tauri/gen/apple || true)"
-          if [ -z "$files" ]; then
-            echo "gen/apple is tracked already; nothing to package"
-            exit 0
-          fi
-          echo "$files" | tar -czf "$RUNNER_TEMP/gen-apple.tgz" -T -
-          echo "$files" | wc -l
-          ls -la "$RUNNER_TEMP/gen-apple.tgz"
-
-      - name: Upload gen/apple (only on the run that generated it)
-        if: always()
-        uses: actions/upload-artifact@v4
-        with:
-          name: gen-apple
-          path: ${{ runner.temp }}/gen-apple.tgz
-          if-no-files-found: ignore
-          retention-days: 30
-
-  android-apk:
-    name: android apk (debug, arm64)
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22.18'
-          cache: npm
-          cache-dependency-path: src/praisonai-mobile/package-lock.json
-      - uses: actions/setup-java@v4
-        with:
-          # 17, not the runner's default 21 or a laptop's 25: Gradle 8.14.3's
-          # Groovy front end rejects class files newer than it knows
-          # ("Unsupported class file major version 69" on JDK 25), and 17 is
-          # what AGP 8.11 documents.
-          distribution: temurin
-          java-version: '17'
-      - uses: android-actions/setup-android@v3
-        with:
-          # What gen/android/app/build.gradle.kts declares (compileSdk 36),
-          # plus the build-tools AGP pairs with it. Anything else AGP needs it
-          # downloads itself; the licences are accepted by this action.
-          packages: 'platform-tools platforms;android-36 build-tools;36.0.0'
-      - uses: nttld/setup-ndk@v1
-        id: ndk
-        with:
-          # r28c = 28.2.13676358, the NDK gen/android was generated and first
-          # built with.
-          ndk-version: r28c
-          add-to-path: false
-      - uses: dtolnay/rust-toolchain@stable
-        with:
-          targets: aarch64-linux-android
-      - uses: Swatinem/rust-cache@v2
-        with:
-          workspaces: src/praisonai-mobile/src-tauri
-          key: android-apk
-      - name: "Build praisonai-ts (the file: dependency)"
-        # praisonai-mobile depends on praisonai by `file:`, so `npm ci`
-        # here runs praisonai-ts's own `prepare` -> `rimraf dist`. On a
-        # fresh runner praisonai-ts has no node_modules, so rimraf is not
-        # installed and `npm ci` dies with code 127 before a single
-        # platform step runs. mobile.yml gives all four of its jobs this
-        # step; these two were written against the tree from before the
-        # dependency existed and never got it.
-        working-directory: src/praisonai-ts
-        run: |
-          npm install --no-audit --no-fund --legacy-peer-deps
-          npm run build
-      - run: npm ci
-
-      - name: Generate the Android project (only if gen/android is not committed)
-        env:
-          NDK_HOME: ${{ steps.ndk.outputs.ndk-path }}
-        run: |
-          set -euo pipefail
-          if [ -d src-tauri/gen/android ]; then
-            echo "src-tauri/gen/android is committed; not regenerating it"
-            exit 0
-          fi
-          npx tauri android init --ci --skip-targets-install
-
-      - name: Build the debug APK
-        env:
-          NDK_HOME: ${{ steps.ndk.outputs.ndk-path }}
-        # --target aarch64 only: every phone sold in the last several years is
-        # arm64-v8a, and one target keeps the Rust build to one link. The
-        # `universal` in the output path is Gradle's name for "the APK that is
-        # not split per ABI", not a claim about what is inside it.
-        run: npx tauri android build --debug --apk --target aarch64 --ci
-
-      - name: Is there an APK, and is the Rust inside it?
-        run: |
-          set -euo pipefail
-          root=src-tauri/gen/android/app/build/outputs/apk
-          apk="$(find "$root" -name '*.apk' -print -quit || true)"
-          if [ -z "$apk" ]; then
-            echo "::error::no .apk was produced under $root"
-            find "$root" -type f -print 2>/dev/null || echo "(the outputs directory does not exist)"
-            exit 1
-          fi
-          echo "apk: $apk"
-          ls -la "$apk"
-          unzip -l "$apk" | grep -q 'lib/arm64-v8a/libpraisonai_mobile_lib.so' \
-            || { echo "::error::$apk does not contain lib/arm64-v8a/libpraisonai_mobile_lib.so"; unzip -l "$apk" | head -40; exit 1; }
-          unzip -l "$apk" | grep -E 'lib/|AndroidManifest|classes.dex' | head
-          cp "$apk" "$RUNNER_TEMP/PraisonAI-android-debug-arm64.apk"
-
-      - name: Upload the APK
-        uses: actions/upload-artifact@v4
-        with:
-          name: PraisonAI-android-debug-arm64-apk
-          path: ${{ runner.temp }}/PraisonAI-android-debug-arm64.apk
-          if-no-files-found: error
-          retention-days: 30

.github/workflows/mobile-web.yml

@@ -1,164 +0,0 @@
-# The mobile package's WEB build: built, booted in a real browser, and
-# deployed to GitHub Pages.
-#
-# mobile.yml proves the package's tests pass. This workflow proves the thing
-# that ships to a browser actually ships: dist/ is built, served under the
-# repository subpath and driven through first paint, install, and an offline
-# reload by tools/web-boot.test.mjs, then published. A PR gets the build and
-# the proof; only main deploys.
-#
-# One setting is outside this file's reach: the repository's Pages source must
-# be "GitHub Actions" (Settings -> Pages -> Build and deployment -> Source).
-# Until a human turns that on, the deploy job SKIPS with a notice rather than
-# failing -- a red main every push because of a setting no workflow can set
-# would train people to ignore the mobile checks, which is how the last silent
-# breakage in this package survived.
-name: mobile web
-
-on:
-  push:
-    branches: [main]
-    paths: &watched
-      - 'src/praisonai-mobile/**'
-      - '.github/workflows/mobile-web.yml'
-      # `praisonai` is a `file:` link to ../praisonai-ts, and the web bundle is
-      # built FROM it -- so drift on that side changes what ships to a browser
-      # and must trigger this gate. mobile.yml watches these same paths for the
-      # same reason; a web gate that watched only praisonai-mobile would go
-      # quiet exactly when the dependency it bundles moved.
-      - 'src/praisonai-ts/src/**'
-      - 'src/praisonai-ts/scripts/**'
-      - 'src/praisonai-ts/package.json'
-  pull_request:
-    paths: *watched
-
-permissions:
-  contents: read
-
-defaults:
-  run:
-    working-directory: src/praisonai-mobile
-
-jobs:
-  build:
-    name: build and boot
-    runs-on: ubuntu-22.04
-    concurrency:
-      group: mobile-web-build-${{ github.ref }}
-      cancel-in-progress: true
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22.18'
-          cache: npm
-          cache-dependency-path: src/praisonai-mobile/package-lock.json
-      # `praisonai` is a `file:` link to ../praisonai-ts, so its dist/ must
-      # exist before this package can even INSTALL: npm runs the linked
-      # package's prepare/prebuild, which fails without its own node_modules.
-      # `npm install`, not `npm ci`: praisonai-ts gitignores its lockfile.
-      # `--legacy-peer-deps` for the bedrock-agentcore -> @strands-agents/sdk
-      # peer conflict, exactly as mobile.yml and praisonai-ts-webview.yml do.
-      - name: "Build praisonai-ts (the file: dependency)"
-        working-directory: src/praisonai-ts
-        run: |
-          npm install --no-audit --no-fund --legacy-peer-deps
-          npm run build
-      - run: npm ci
-      - name: Cache the Playwright browser
-        uses: actions/cache@v4
-        with:
-          path: ~/.cache/ms-playwright
-          key: playwright-${{ runner.os }}-${{ hashFiles('src/praisonai-mobile/package-lock.json') }}
-      - name: Install Chromium for the boot proof
-        run: npx playwright install --with-deps chromium
-      - name: Build
-        run: npm run build
-      - name: Boot proof
-        # Serves dist/ under /PraisonAI/ in headless Chromium: composer and
-        # Send render, manifest served as application/manifest+json, service
-        # worker activates with the subpath as scope, an offline reload still
-        # renders, and an injected inline script is blocked by the CSP.
-        run: npm run test:web
-      - name: dist contents
-        run: ls -lR dist
-      - uses: actions/upload-artifact@v4
-        with:
-          name: mobile-web-dist
-          path: src/praisonai-mobile/dist
-          if-no-files-found: error
-      - uses: actions/upload-pages-artifact@v3
-        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
-        with:
-          path: src/praisonai-mobile/dist
-
-  # The readiness check is its OWN job, and deliberately declares no
-  # `environment:`. A job that names `environment: github-pages` cannot START
-  # until that environment exists, so when Pages is off the runner fails the
-  # job outright -- zero steps, about one second -- and every carefully
-  # written skip inside it is unreachable. Measured: run 33730322658 on main,
-  # "deploy to GitHub Pages" failed with steps: 0.
-  #
-  # Splitting the decision out means the check runs with no preconditions and
-  # the environment-bearing job is never scheduled unless it can succeed.
-  pages-ready:
-    name: is GitHub Pages enabled?
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
-    needs: build
-    runs-on: ubuntu-22.04
-    permissions:
-      contents: read
-      # `gh api repos/<owner>/<repo>/pages` needs Pages read. Without it the
-      # request is rejected on a private repo, `2>/dev/null || echo '{}'`
-      # swallows the error to `{}`, build_type falls to "none", and the deploy
-      # SKIPS even though Pages is on -- the exact silent skip this file exists
-      # to prevent. `contents: read` alone leaves this permission at `none`.
-      pages: read
-    outputs:
-      ready: ${{ steps.check.outputs.ready }}
-    steps:
-      # Pages cannot be enabled from a workflow, so this reports the setting
-      # rather than demanding it. `ready` false SKIPS the deploy with a
-      # notice; it does not fail the run. deploy-pages would otherwise fail
-      # with a bare 404 that says nothing about which setting is missing.
-      - name: Is the Pages source "GitHub Actions"?
-        id: check
-        env:
-          GH_TOKEN: ${{ github.token }}
-        working-directory: .
-        run: |
-          site=$(gh api "repos/${{ github.repository }}/pages" 2>/dev/null || echo '{}')
-          build_type=$(echo "$site" | jq -r '.build_type // "none"')
-          cname=$(echo "$site" | jq -r '.cname // ""')
-          echo "build_type=$build_type cname=${cname:-<none>}"
-          if [ "$build_type" != "workflow" ]; then
-            echo "::notice::Skipping the Pages deploy: Pages is not set to build from GitHub Actions (build_type=$build_type). A repository admin must set it at https://github.com/${{ github.repository }}/settings/pages -> Build and deployment -> Source: GitHub Actions. The built site is attached to this run as the mobile-web-dist artifact."
-            echo "ready=false" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-          if [ -n "$cname" ]; then
-            echo "::notice::Skipping the Pages deploy: a custom domain ($cname) is set, so the app would be served there rather than at the github.io URL."
-            echo "ready=false" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-          echo "ready=true" >> "$GITHUB_OUTPUT"
-
-  deploy:
-    name: deploy to GitHub Pages
-    needs: pages-ready
-    if: needs.pages-ready.outputs.ready == 'true'
-    runs-on: ubuntu-22.04
-    permissions:
-      pages: write
-      id-token: write
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    concurrency:
-      # Never cancel a deployment in flight; queue behind it instead.
-      group: pages
-      cancel-in-progress: false
-    steps:
-      - uses: actions/configure-pages@v5
-      - uses: actions/deploy-pages@v4
-        id: deployment

.github/workflows/mobile.yml

@@ -1,263 +0,0 @@
-# The mobile package's tests.
-#
-# Written at the same time as the package, deliberately. praisonai-desktop's
-# suite existed and ran nowhere for months because no workflow referenced it,
-# and a package whose tests never run in CI is a package whose tests are
-# decoration -- the 523 here would go stale silently.
-#
-# Four gates, and they catch different things:
-#
-#   typecheck   -- the boundary between erasable and non-erasable TypeScript.
-#                  node:test strips types rather than compiling, so an enum or
-#                  a constructor parameter property is a runtime parse error at
-#                  import; `erasableSyntaxOnly` turns that into a typecheck
-#                  failure at the file that caused it.
-#   boundaries  -- the two seams. Only engines/src/praisonai-ts may import
-#                  'praisonai'; only adapters/src/tauri may import @tauri-apps.
-#                  These are the whole reason the package is swappable, and a
-#                  rule enforced only by review stops being enforced.
-#   test        -- the suite itself.
-#   bundle gate -- webview compatibility. This is the one a normal test run
-#                  CANNOT do: node:test runs in Node, where a `crypto` import
-#                  and a top-level `process.env` both work fine, and both kill
-#                  a webview bundle at import time.
-name: mobile
-
-on:
-  push:
-    branches: [main]
-    paths: &watched
-      - 'src/praisonai-mobile/**'
-      - '.github/workflows/mobile.yml'
-      # The `upstream parity` job below typechecks the REAL praisonai-ts Agent
-      # against the structural contract in engines/src/praisonai-ts/agent-api.ts.
-      # Watching only praisonai-mobile made that gate fire when the CONSUMER
-      # changed and stay silent when the thing it watches did -- so upstream
-      # drift landed on main unchecked. Verified on 71197fa80, which edited
-      # src/praisonai-ts/src/agent/simple.ts: no parity check ran on it.
-      - 'src/praisonai-ts/src/**'
-      # And the pieces of praisonai-ts that decide what `praisonai/mobile`
-      # RESOLVES to through the file: link -- the esm shim shapes dist/esm.
-      - 'src/praisonai-ts/scripts/**'
-      - 'src/praisonai-ts/package.json'
-  pull_request:
-    paths: *watched
-
-concurrency:
-  group: mobile-${{ github.ref }}
-  cancel-in-progress: true
-
-defaults:
-  run:
-    working-directory: src/praisonai-mobile
-
-jobs:
-  check:
-    name: check (node ${{ matrix.node }})
-    runs-on: ubuntu-22.04
-    strategy:
-      fail-fast: false
-      matrix:
-        # 22.18 is the floor declared in package.json -- tested because a
-        # declared floor nobody runs is a guess. 24 is the forward check:
-        # native type-stripping is the feature this package depends on most,
-        # and it is exactly the kind of thing a major bump changes.
-        node: ['22.18', '24']
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node }}
-          cache: npm
-          cache-dependency-path: src/praisonai-mobile/package-lock.json
-      # `praisonai` is a `file:` link to ../praisonai-ts (see praisonai-mobile's
-      # package.json for why), so its dist/ must exist before this package can
-      # resolve `praisonai/mobile`. `npm install`, not `npm ci`: praisonai-ts
-      # gitignores its lockfile. `--legacy-peer-deps` for the
-      # bedrock-agentcore -> @strands-agents/sdk peer conflict, exactly as
-      # praisonai-ts-webview.yml does.
-      - name: "Build praisonai-ts (the file: dependency)"
-        working-directory: src/praisonai-ts
-        run: |
-          npm install --no-audit --no-fund --legacy-peer-deps
-          npm run build
-      - run: npm ci
-      - name: Cache the Playwright browser
-        uses: actions/cache@v4
-        with:
-          path: ~/.cache/ms-playwright
-          key: playwright-${{ runner.os }}-${{ hashFiles('src/praisonai-mobile/package-lock.json') }}
-      - name: Install Chromium for the boot proof
-        # `npm test` includes tools/web-boot.test.mjs, which loads the built
-        # dist/ in a real browser. It fails rather than skips without one.
-        run: npx playwright install --with-deps chromium
-      - name: Typecheck
-        run: npm run typecheck
-      - name: Layer boundaries
-        run: npm run boundaries
-      - name: Tests
-        run: npm test
-      - name: Bundle gate fixtures
-        # Runs the gate's own suite, which proves each check can FAIL -- a
-        # build check that has only ever seen clean input is a check nobody
-        # knows the state of.
-        run: npm run test:bundle
-
-  upstream-parity:
-    name: upstream parity
-    # Its own job so drift from the real Agent is visible in the checks list
-    # rather than buried in another job's log.
-    #
-    # It needs only THIS package's install. praisonai-ts's own dependencies are
-    # not needed here (the `check` job installs them, with --legacy-peer-deps,
-    # to build the file: dependency): every member the check looks at is
-    # declared locally in simple.ts. That is verified rather than assumed:
-    # with praisonai-ts's node_modules moved aside, injected drift is still
-    # caught as TS2741.
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22.18'
-          cache: npm
-          cache-dependency-path: src/praisonai-mobile/package-lock.json
-      - name: "Build praisonai-ts (the file: dependency)"
-        working-directory: src/praisonai-ts
-        run: |
-          npm install --no-audit --no-fund --legacy-peer-deps
-          npm run build
-      - run: npm ci
-      - name: Does the real Agent still satisfy PraisonAgent?
-        # Skips loudly if the praisonai-ts checkout is missing, rather than
-        # passing quietly -- a check that silently stops covering anything is
-        # worse than no check.
-        run: npm run check:upstream
-
-  shell:
-    name: rust shell (${{ matrix.os }})
-    # The Rust crate had 14 tests and no job running them -- the same failure
-    # this workflow's header says it was created to prevent, one language over.
-    #
-    # Both platforms, because the crate is cfg-heavy: the back-gesture fallback
-    # is #[cfg(target_os = "android")] / ios / not(mobile), and a cfg mistake
-    # compiles perfectly on whichever host you happened to try.
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-22.04, macos-15]
-    defaults:
-      run:
-        working-directory: src/praisonai-mobile/src-tauri
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22.18'
-          cache: npm
-          cache-dependency-path: src/praisonai-mobile/package-lock.json
-      - uses: dtolnay/rust-toolchain@stable
-        with:
-          components: clippy
-      - uses: Swatinem/rust-cache@v2
-        with:
-          workspaces: src/praisonai-mobile/src-tauri
-      - name: Install the Linux build dependencies
-        if: runner.os == 'Linux'
-        working-directory: .
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y --no-install-recommends \
-            libwebkit2gtk-4.1-dev librsvg2-dev libxdo-dev libssl-dev patchelf
-      # generate_context! expands frontendDist (../dist) at COMPILE time, and
-      # dist/ is gitignored -- absent on a fresh checkout. Without this the
-      # crate cannot compile and neither test nor clippy below ever runs.
-      # `praisonai` is a `file:` link to ../praisonai-ts (see praisonai-mobile's
-      # package.json for why), so its dist/ must exist before this package can
-      # resolve `praisonai/mobile`. `npm install`, not `npm ci`: praisonai-ts
-      # gitignores its lockfile. `--legacy-peer-deps` for the
-      # bedrock-agentcore -> @strands-agents/sdk peer conflict, exactly as
-      # praisonai-ts-webview.yml does.
-      - name: "Build praisonai-ts (the file: dependency)"
-        working-directory: src/praisonai-ts
-        run: |
-          npm install --no-audit --no-fund --legacy-peer-deps
-          npm run build
-      - name: Build the webview (creates ../dist for generate_context!)
-        working-directory: src/praisonai-mobile
-        run: |
-          npm ci
-          npm run build
-      # The pure-logic tests: back-gesture arbitration, the lifecycle mapping,
-      # and the event-name contract. None of them needs a phone.
-      - name: Test
-        run: cargo test
-      - name: Clippy
-        run: cargo clippy --all-targets -- -D warnings
-
-  # ------------------------------------------------------------------
-  # The mobile targets, which nothing compiled.
-  #
-  # `src/lib.rs` is `#[cfg_attr(mobile, tauri::mobile_entry_point)]`, and
-  # `tauri_build::build()` emits `cargo:rustc-cfg=mobile` only for android and
-  # ios targets. Both legs of `rust shell` above are HOST targets, so that
-  # attribute -- the one that generates the Android JNI symbol and the iOS
-  # start_app symbol -- expanded exactly zero times in CI, and neither did the
-  # `#[cfg(target_os = "android")]` / `ios` arms of `commands.rs`. The job
-  # above says it covers cfg mistakes; it covers the ones in `shell/`, not
-  # these.
-  #
-  # `cargo check`, not `build`: it type-checks and macro-expands under the
-  # mobile cfg, which is the thing that was never done, and needs no NDK and no
-  # Xcode project. Verified at 18s for the android target.
-  # ------------------------------------------------------------------
-  cross-check:
-    name: cross-check (${{ matrix.target }})
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - target: aarch64-linux-android
-            os: ubuntu-22.04
-          - target: aarch64-apple-ios
-            os: macos-15
-    defaults:
-      run:
-        working-directory: src/praisonai-mobile/src-tauri
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22.18'
-          cache: npm
-          cache-dependency-path: src/praisonai-mobile/package-lock.json
-      - uses: dtolnay/rust-toolchain@stable
-        with:
-          targets: ${{ matrix.target }}
-      - uses: Swatinem/rust-cache@v2
-        with:
-          workspaces: src/praisonai-mobile/src-tauri
-          key: ${{ matrix.target }}
-      # generate_context! expands frontendDist at COMPILE time and dist/ is
-      # gitignored, so the crate cannot be checked without this -- the same
-      # reason the job above needs it.
-      # `praisonai` is a `file:` link to ../praisonai-ts (see praisonai-mobile's
-      # package.json for why), so its dist/ must exist before this package can
-      # resolve `praisonai/mobile`. `npm install`, not `npm ci`: praisonai-ts
-      # gitignores its lockfile. `--legacy-peer-deps` for the
-      # bedrock-agentcore -> @strands-agents/sdk peer conflict, exactly as
-      # praisonai-ts-webview.yml does.
-      - name: "Build praisonai-ts (the file: dependency)"
-        working-directory: src/praisonai-ts
-        run: |
-          npm install --no-audit --no-fund --legacy-peer-deps
-          npm run build
-      - name: Build the webview (creates ../dist for generate_context!)
-        working-directory: src/praisonai-mobile
-        run: |
-          npm ci
-          npm run build
-      - name: Does the crate still expand and type-check for a phone?
-        run: cargo check --lib --target ${{ matrix.target }}

.github/workflows/nightly-release-gate.yml

@@ -1,144 +0,0 @@
-name: Nightly Release Gate
-
-# Preflight before PyPI Release (patch bump).
-# Triggers: Core Tests success on main (workflow_run) or cron every 3 days at 00:00 UTC.
-# Dedupe: max one successful patch release every 3 days (see release-gate.js).
-
-on:
-  schedule:
-    - cron: '0 0 */3 * *'
-  workflow_dispatch:
-    inputs:
-      dry_run:
-        description: 'Run preflight only; do not dispatch pypi-release.yml'
-        required: false
-        default: false
-        type: boolean
-  workflow_run:
-    workflows:
-      - Core Tests
-    types:
-      - completed
-    branches:
-      - main
-
-permissions:
-  contents: read
-  actions: write
-
-concurrency:
-  group: nightly-release-gate
-  cancel-in-progress: false
-
-jobs:
-  preflight:
-    if: |
-      github.event_name == 'workflow_dispatch' ||
-      github.event_name == 'schedule' ||
-      (
-        github.event_name == 'workflow_run' &&
-        github.event.workflow_run.conclusion == 'success' &&
-        github.event.workflow_run.head_branch == 'main' &&
-        github.event.workflow_run.event == 'push' &&
-        !startsWith(github.event.workflow_run.head_commit.message, 'Release v') &&
-        !startsWith(github.event.workflow_run.head_commit.message, 'chore(release):')
-      )
-    runs-on: ubuntu-latest
-    env:
-      GH_TOKEN: ${{ secrets.GH_TOKEN }}
-    steps:
-      - name: Resolve trigger context
-        id: ctx
-        run: |
-          if [ "${{ github.event_name }}" = "workflow_run" ]; then
-            echo "checkout_sha=${{ github.event.workflow_run.head_sha }}" >> "$GITHUB_OUTPUT"
-            echo "source=ci" >> "$GITHUB_OUTPUT"
-            echo "is_ci=true" >> "$GITHUB_OUTPUT"
-          else
-            echo "checkout_sha=main" >> "$GITHUB_OUTPUT"
-            echo "source=nightly" >> "$GITHUB_OUTPUT"
-            echo "is_ci=false" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Checkout
-        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
-        with:
-          ref: ${{ steps.ctx.outputs.checkout_sha }}
-          fetch-depth: 0
-
-      - name: Fetch main and tags
-        run: git fetch --tags origin main
-
-      # Guards the gate logic itself — no workflow ran these selftests before.
-      - name: Selftest release-gate script
-        run: node .github/scripts/release-gate-selftest.js
-
-      - name: Preflight — path changes, CI SHA, dedupe
-        id: preflight
-        uses: actions/github-script@v7
-        env:
-          HEAD_SHA: ${{ steps.ctx.outputs.checkout_sha }}
-          IS_CI: ${{ steps.ctx.outputs.is_ci }}
-        with:
-          github-token: ${{ secrets.GH_TOKEN }}
-          script: |
-            const path = require('path');
-            const rg = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/release-gate.js'));
-            const owner = context.repo.owner;
-            const repo = context.repo.repo;
-            const headSha = process.env.HEAD_SHA;
-            const isCi = process.env.IS_CI === 'true';
-
-            const result = await rg.evaluateReleasePreflight(
-              github, owner, repo,
-              { headSha, isCiTrigger: isCi, bump: 'patch' },
-              core
-            );
-
-            core.setOutput('should_release', result.ready ? 'true' : 'false');
-            core.setOutput('reason', result.reasons.join('; '));
-            core.setOutput('head_sha', result.headSha || headSha);
-            core.setOutput('last_tag', result.lastTag || '');
-            core.setOutput('target_agents', result.targetAgents || '');
-            core.setOutput('target_code', result.targetCode || '');
-            core.setOutput('target_wrapper', result.targetWrapper || '');
-
-            core.summary.addRaw('## Release gate preflight\n');
-            core.summary.addRaw(`Ready: ${result.ready}\n`);
-            core.summary.addRaw(`Reason: ${result.reasons.join('; ')}\n`);
-            if (result.targetAgents) {
-              core.summary.addRaw(
-                `Targets: praisonaiagents==${result.targetAgents}, `
-                + `praisonai-code==${result.targetCode}, praisonai==${result.targetWrapper}\n`
-              );
-            }
-            await core.summary.write();
-
-            if (!result.ready) {
-              core.info(`Skip release: ${result.reasons.join('; ')}`);
-            }
-
-      - name: Dry run summary
-        if: inputs.dry_run == true
-        run: |
-          echo "Dry run — preflight only, no pypi-release dispatch."
-          echo "should_release=${{ steps.preflight.outputs.should_release }}"
-          echo "reason=${{ steps.preflight.outputs.reason }}"
-
-      - name: Dispatch PyPI Release (patch)
-        if: steps.preflight.outputs.should_release == 'true' && inputs.dry_run != true
-        run: |
-          set -euo pipefail
-          gh workflow run pypi-release.yml \
-            --repo "${GITHUB_REPOSITORY}" \
-            --ref main \
-            -f bump=patch \
-            -f source=${{ steps.ctx.outputs.source }} \
-            -f trigger_sha=${{ steps.preflight.outputs.head_sha }} \
-            -f dry_run=false
-          echo "Dispatched pypi-release.yml (patch, source=${{ steps.ctx.outputs.source }})"
-          if [ "${{ steps.ctx.outputs.source }}" = "ci" ]; then
-            echo "Uses pypi-auto environment (no manual approval)."
-          else
-            echo "Uses pypi-auto environment for nightly patch releases."
-          fi

.github/workflows/parity-gate.yml

@@ -1,106 +0,0 @@
-name: Parity Gate
-
-# Validates Python <-> TypeScript SDK parity on pull requests and FAILS on drift.
-#
-# Two named checks, so each kind of drift is visible in the checks list:
-#   names      - the exported-name tracker (PARITY.md / FEATURE_PARITY_TRACKER.json)
-#                must be regenerated in the PR when the public surface changes.
-#   behaviour  - options accepted for parity but not yet acted on; a ratchet,
-#                so the count may fall and never rise.
-#   signatures - constructor/method parameters of the curated surfaces in
-#                src/praisonai/praisonai/_dev/parity/signatures/surface.yaml must
-#                match (after camelCase/alias/flattening rules) or be waived with a
-#                reason in waivers.yaml. Stale or expired waivers also fail.
-#
-# The regenerate-and-commit job stays in update-parity-tracker.yml (push to main).
-# This workflow never commits; it only reports.
-
-on:
-  pull_request:
-    paths:
-      - 'src/praisonai-agents/praisonaiagents/**/*.py'
-      - 'src/praisonai-ts/src/**/*.ts'
-      - 'src/praisonai-rust/praisonai/src/**/*.rs'
-      - 'src/praisonai/praisonai/_dev/parity/**'
-      - 'src/praisonai/praisonai/cli/features/**'
-      # The generator the `names` job runs. Editing it changed what the gate
-      # measured without the gate running.
-      - 'src/praisonai/scripts/**'
-      - 'src/praisonai-ts/PARITY.md'
-      - 'src/praisonai-ts/FEATURE_PARITY_TRACKER.json'
-      - 'src/praisonai-ts/SIGNATURE_PARITY.md'
-      - 'src/praisonai-ts/signature-parity.json'
-      # The behaviour baseline itself. These two carry the ratchet floor, so a
-      # pull request that edited only them raised the floor with no job running.
-      - 'src/praisonai-ts/BEHAVIOUR_PARITY.md'
-      - 'src/praisonai-ts/behaviour-parity.json'
-      - 'src/praisonai-rust/PARITY.md'
-      - 'src/praisonai-rust/FEATURE_PARITY_TRACKER.json'
-      - '.github/workflows/parity-gate.yml'
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-jobs:
-  names:
-    name: names (exported-symbol tracker up to date)
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-      - run: pip install pyyaml
-      - name: Tracker files match the sources
-        run: |
-          if ! python3 src/praisonai/scripts/generate_parity_tracker.py --check; then
-            echo "::error::Parity tracker is out of date. Run: python3 src/praisonai/scripts/generate_parity_tracker.py  and commit src/praisonai-ts/PARITY.md, FEATURE_PARITY_TRACKER.json and the Rust pair."
-            exit 1
-          fi
-
-  signatures:
-    name: signatures (constructor and method parameters)
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-      - run: pip install pyyaml
-      - name: Install the TypeScript compiler only
-        # praisonai-ts's full dependency tree is not needed (and does not
-        # install cleanly); the extractor needs only the `typescript` package.
-        run: |
-          mkdir -p "$RUNNER_TEMP/parity-ts"
-          npm install --prefix "$RUNNER_TEMP/parity-ts" --no-audit --no-fund [email protected]
-          echo "PARITY_TS_NODE_MODULES=$RUNNER_TEMP/parity-ts/node_modules" >> "$GITHUB_ENV"
-      - name: Signatures match, or are waived with a reason
-        env:
-          PYTHONPATH: src/praisonai
-        run: |
-          if ! python3 -m praisonai._dev.parity.signatures --check; then
-            echo "::error::Signature parity failed. See the output above for the surface and parameter. Fix the TypeScript side, or add a waiver with a reason to src/praisonai/praisonai/_dev/parity/signatures/waivers.yaml, then run: PYTHONPATH=src/praisonai python3 -m praisonai._dev.parity.signatures --write"
-            exit 1
-          fi
-
-  behaviour:
-    name: behaviour (options accepted but not acted on)
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-      - run: pip install pyyaml
-      - name: The count of ignored options has not grown
-        env:
-          PYTHONPATH: src/praisonai
-        run: |
-          if ! python3 -m praisonai._dev.parity.behaviour --check; then
-            echo "::error::An option accepted for Python parity is not acted on, and the total grew. The name and signature gates cannot see this: they check that a parameter EXISTS. Implement the behaviour and delete its entry from src/praisonai-ts/src/utils/parity-notice.ts, then run: PYTHONPATH=src/praisonai python3 -m praisonai._dev.parity.behaviour --write"
-            exit 1
-          fi

.github/workflows/pipeline-status-sync.yml

@@ -1,42 +0,0 @@
-name: Pipeline Status Sync
-
-# Sync pipeline/* stage and blocker labels on open internal PRs.
-
-on:
-  schedule:
-    - cron: '*/10 * * * *'
-  workflow_dispatch:
-
-permissions:
-  pull-requests: read
-  issues: write
-  actions: write
-  id-token: write
-
-jobs:
-  sync:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-
-      - name: Generate GitHub App token
-        id: app-token
-        uses: actions/create-github-app-token@v1
-        with:
-          app-id: ${{ secrets.CLAUDE_APP_ID }}
-          private-key: ${{ secrets.CLAUDE_APP_PRIVATE_KEY }}
-          owner: ${{ github.repository_owner }}
-
-      - name: Sync pipeline labels on open PRs
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ steps.app-token.outputs.token }}
-          script: |
-            const path = require('path');
-            const ps = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/pipeline-status.js'));
-            await ps.syncOpenPullRequests(
-              github, context.repo.owner, context.repo.repo,
-              { maxPrs: 30, dispatchMergeGate: true }, core
-            );

.github/workflows/praisonai-issue-triage.yml

@@ -1,73 +0,0 @@
-name: PraisonAI Issue Triage
-
-on:
-  issue_comment:
-    types: [created]
-  workflow_dispatch:
-    inputs:
-      issue_number:
-        description: 'Issue Number'
-        required: true
-        type: string
-
-jobs:
-  triage:
-    runs-on: ubuntu-latest
-    if: >
-      github.event_name == 'workflow_dispatch' ||
-      (github.event_name == 'issue_comment' && 
-      !github.event.issue.pull_request && 
-      contains(github.event.comment.body, '@praisonai') &&
-      github.actor != 'github-actions[bot]' &&
-      github.event.comment.user.type != 'Bot' &&
-      (github.event.comment.author_association == 'OWNER' ||
-       github.event.comment.author_association == 'MEMBER' ||
-       github.event.comment.author_association == 'COLLABORATOR'))
-    
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-          fetch-depth: 0
-          
-      - name: Generate GitHub App Token
-        id: generate_token
-        uses: tibdex/github-app-token@v2
-        with:
-          app_id: ${{ secrets.PRAISONAI_APP_ID }}
-          private_key: ${{ secrets.PRAISONAI_APP_PRIVATE_KEY }}
-          
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-          
-      - name: Set up Git
-        run: |
-          git config --local user.email "[email protected]"
-          git config --local user.name "PraisonAI Bot"
-          
-      - name: Install PraisonAI
-        run: pip install uv
-      - uses: ./.github/actions/install-monorepo-packages
-        with:
-          use-uv: "true"
-          agents-extras: ".[all]"
-          wrapper-extras: ".[all]"
-        
-      - name: Run PraisonAI Issue Triage
-        env:
-          GITHUB_TOKEN: ${{ steps.generate_token.outputs.token }}
-          GH_TOKEN: ${{ steps.generate_token.outputs.token }}
-          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-          PRAISONAI_AUTO_APPROVE: "true"
-          ISSUE_NUMBER_INPUT: ${{ inputs.issue_number }}
-          ISSUE_NUMBER_EVENT: ${{ github.event.issue.number }}
-        run: |
-          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
-            export ISSUE_NUMBER="$ISSUE_NUMBER_INPUT"
-          else
-            export ISSUE_NUMBER="$ISSUE_NUMBER_EVENT"
-          fi
-          praisonai github triage --issue $ISSUE_NUMBER --agent-file .github/praisonai-issue-triage.yaml

.github/workflows/praisonai-pr-review.yml

@@ -1,77 +0,0 @@
-name: PraisonAI PR Reviewer
-
-on:
-  pull_request:
-    types: [opened, synchronize, reopened, ready_for_review]
-  issue_comment:
-    types: [created]
-  workflow_dispatch:
-    inputs:
-      pr_number:
-        description: 'Pull Request Number'
-        required: true
-        type: string
-
-jobs:
-  review:
-    runs-on: ubuntu-latest
-    if: >
-      secrets.PRAISONAI_APP_ID != '' &&
-      secrets.PRAISONAI_APP_PRIVATE_KEY != '' &&
-      (
-        (github.event_name == 'pull_request' && github.event.pull_request.draft == false) ||
-        github.event_name == 'workflow_dispatch' ||
-        (github.event_name == 'issue_comment' &&
-         github.event.issue.pull_request &&
-         contains(github.event.comment.body, '@praisonai') &&
-         github.actor != 'github-actions[bot]' &&
-         github.event.comment.user.type != 'Bot' &&
-         (github.event.comment.author_association == 'OWNER' ||
-          github.event.comment.author_association == 'MEMBER' ||
-          github.event.comment.author_association == 'COLLABORATOR'))
-      )
-    
-    steps:
-      - name: Determine checkout ref
-        id: dest
-        env:
-          ISSUE_NUMBER: ${{ github.event.issue.number }}
-          PR_NUMBER_INPUT: ${{ inputs.pr_number }}
-          PR_HEAD_SHA: ${{ github.event.pull_request.head.sha }}
-        run: |
-          if [ "${{ github.event_name }}" = "issue_comment" ]; then
-            echo "ref=refs/pull/$ISSUE_NUMBER/head" >> "$GITHUB_OUTPUT"
-          elif [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
-            echo "ref=refs/pull/$PR_NUMBER_INPUT/head" >> "$GITHUB_OUTPUT"
-          else
-            echo "ref=$PR_HEAD_SHA" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-          ref: ${{ steps.dest.outputs.ref }}
-          fetch-depth: 0
-          
-      - name: Generate GitHub App Token
-        id: generate_token
-        uses: tibdex/github-app-token@v2
-        with:
-          app_id: ${{ secrets.PRAISONAI_APP_ID }}
-          private_key: ${{ secrets.PRAISONAI_APP_PRIVATE_KEY }}
-          
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-          
-      - name: Install PraisonAI
-        run: pip install "praisonai[all]"
-        
-      - name: Run PraisonAI PR Review
-        env:
-          GITHUB_TOKEN: ${{ steps.generate_token.outputs.token }}
-          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-        run: |
-          praisonai workflow run .github/praisonai-reviewer.yaml

.github/workflows/praisonai-ts-tests.yml

@@ -1,70 +0,0 @@
-# Does praisonai-ts still pass its own tests?
-#
-# It has a suite -- 2,000+ tests -- and until now nothing ran it. The only
-# workflow with `working-directory: src/praisonai-ts` builds the package and
-# checks the webview bundle; the two other mentions of `npm test` in this
-# directory are a comment and a line of prose telling a reviewer to run it by
-# hand. So the suite was green the way an unread report is green.
-#
-# That mattered the moment the suite grew: PR #4755 added ~880 tests for the
-# Python-parity port and not one of them would have run here. A test nobody
-# executes is worse than no test, because it is counted as cover.
-#
-# Deliberately narrow, like its webview sibling: it runs only when
-# praisonai-ts changes, installs only what it needs, and asserts two things --
-# the package typechecks, and its tests pass.
-name: praisonai-ts tests
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - 'src/praisonai-ts/src/**'
-      - 'src/praisonai-ts/tests/**'
-      - 'src/praisonai-ts/package.json'
-      - 'src/praisonai-ts/jest.config.ts'
-      - 'src/praisonai-ts/tsconfig*.json'
-      - '.github/workflows/praisonai-ts-tests.yml'
-  pull_request:
-    paths:
-      - 'src/praisonai-ts/src/**'
-      - 'src/praisonai-ts/tests/**'
-      - 'src/praisonai-ts/package.json'
-      - 'src/praisonai-ts/jest.config.ts'
-      - 'src/praisonai-ts/tsconfig*.json'
-      - '.github/workflows/praisonai-ts-tests.yml'
-
-concurrency:
-  group: praisonai-ts-tests-${{ github.ref }}
-  cancel-in-progress: true
-
-permissions:
-  contents: read
-
-jobs:
-  tests:
-    name: unit tests
-    runs-on: ubuntu-22.04
-    defaults:
-      run:
-        working-directory: src/praisonai-ts
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22.18'
-      # `npm install --legacy-peer-deps`, matching praisonai-ts-webview.yml:
-      # the lockfile is gitignored so `npm ci` has nothing to read, and the
-      # dependency tree does not resolve without the flag (bedrock-agentcore
-      # wants a peer of @strands-agents/sdk that is not installed).
-      - name: Install
-        run: npm install --no-audit --no-fund --legacy-peer-deps
-      - name: Typecheck
-        run: npx tsc --noEmit -p .
-      # PRAISONAI_PARITY_SILENT quiets the one-line notices that options
-      # accepted for Python parity print when they are not yet honoured; they
-      # are deliberate output, not failures, and they drown the test log.
-      - name: Tests
-        run: npm test
-        env:
-          PRAISONAI_PARITY_SILENT: '1'

.github/workflows/praisonai-ts-webview.yml

@@ -1,62 +0,0 @@
-# Can praisonai-ts still be loaded in a webview?
-#
-# Issue #4437 was this failing: `crypto` and `events` were static imports on
-# the Agent graph, so a webview bundle died at IMPORT time with no error
-# boundary and a blank screen. PR #4438 fixed it, and nothing stopped it
-# coming back.
-#
-# `npm test` cannot catch a regression here, structurally: it runs in Node,
-# where every one of these imports works perfectly. One `import { x } from
-# "fs"` added to a file the Agent happens to reach would silently un-ship the
-# mobile app, and the first signal would be a blank screen on a device.
-#
-# Deliberately narrow. It runs only when praisonai-ts changes, installs only
-# what it needs, and asserts one thing.
-name: praisonai-ts webview
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - 'src/praisonai-ts/src/**'
-      - 'src/praisonai-ts/package.json'
-      - 'src/praisonai-ts/scripts/webview-gate.mjs'
-      - '.github/workflows/praisonai-ts-webview.yml'
-  pull_request:
-    paths:
-      - 'src/praisonai-ts/src/**'
-      - 'src/praisonai-ts/package.json'
-      - 'src/praisonai-ts/scripts/webview-gate.mjs'
-      - '.github/workflows/praisonai-ts-webview.yml'
-
-concurrency:
-  group: praisonai-ts-webview-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  webview:
-    name: loadable in a webview
-    runs-on: ubuntu-22.04
-    defaults:
-      run:
-        working-directory: src/praisonai-ts
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22.18'
-      # `npm install`, not `npm ci`: praisonai-ts gitignores its lockfile
-      # (src/praisonai-ts/.gitignore), so `npm ci` has nothing to install from.
-      # `--legacy-peer-deps` because the dependency tree does not otherwise
-      # resolve -- bedrock-agentcore wants a peer of @strands-agents/sdk that
-      # is not installed. That is pre-existing and out of scope here; without
-      # the flag this job fails on something unrelated to what it checks.
-      - name: Install
-        run: npm install --no-audit --no-fund --legacy-peer-deps
-      # Build first: the gate must see what actually SHIPS. The esm-shim adds
-      # a CJS banner that does not exist in the TypeScript sources, and that
-      # banner is what broke the published entry while the sources passed.
-      - name: Build
-        run: npm run build
-      - name: Check
-        run: npm run check:webview

.github/workflows/python-package.yml

@@ -1,22 +1,25 @@
-name: Python Package (Multi-Version)
+# This workflow will install Python dependencies, run tests and lint with a variety of Python versions
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
+
+name: Python package
 
 on:
-  schedule:
-    - cron: '0 4 * * 1'  # Weekly Monday 4am UTC
-  workflow_dispatch:
+  push:
+    branches: [ "develop" ]
+  pull_request:
+    branches: [ "develop" ]
 
 jobs:
   build:
+
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12"]
+        python-version: ["3.10", "3.11"]
 
     steps:
     - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v5
       with:
@@ -27,18 +30,39 @@ jobs:
         echo "OPENAI_API_KEY=${{ secrets.OPENAI_API_KEY || 'sk-test-key-for-github-actions-testing-only-not-real' }}" >> $GITHUB_ENV
         echo "OPENAI_API_BASE=${{ secrets.OPENAI_API_BASE || 'https://api.openai.com/v1' }}" >> $GITHUB_ENV
         echo "OPENAI_MODEL_NAME=${{ secrets.OPENAI_MODEL_NAME || 'gpt-5-nano' }}" >> $GITHUB_ENV
-        echo "PYTHONPATH=${{ github.workspace }}/src/praisonai-agents:$PYTHONPATH" >> $GITHUB_ENV
+        echo "LOGLEVEL=DEBUG" >> $GITHUB_ENV
 
     - name: Install dependencies
-      run: python -m pip install --upgrade pip
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        wrapper-extras: ".[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
-    - name: Install test tools
       run: |
-        python -m pip install duckduckgo_search pytest pytest-asyncio pytest-cov
+        cd src/praisonai
+        python -m pip install --upgrade pip
+        python -m pip install flake8 pytest
+        python -m pip install ."[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
+        python -m pip install duckduckgo_search
+        python -m pip install pytest-asyncio pytest-cov
+        # Install knowledge dependencies from praisonai-agents
         python -m pip install "praisonaiagents[knowledge]"
-
-    - name: Run tests
+        if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+        
+    - name: Debug API Key Status
       run: |
-        cd src/praisonai && python -m pytest tests/unit/ -v --tb=short --disable-warnings --timeout=60 || echo "Some tests failed"
+        echo "🔍 Checking API key availability..."
+        if [ -n "${{ secrets.OPENAI_API_KEY }}" ]; then
+          echo "✅ GitHub secret OPENAI_API_KEY is available"
+          echo "🔑 API key starts with: $(echo "$OPENAI_API_KEY" | cut -c1-7)..."
+        else
+          echo "⚠️ GitHub secret OPENAI_API_KEY is NOT set - using fallback"
+          echo "🔑 Using fallback key: sk-test-key..."
+        fi
+        echo "🌐 API Base: $OPENAI_API_BASE"
+        echo "🤖 Model: $OPENAI_MODEL_NAME"
+        
+    # - name: Lint with flake8
+    #   run: |
+    #     # stop the build if there are Python syntax errors or undefined names
+    #     flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+    #     # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+    #     flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    - name: Test with pytest
+      run: |
+        cd src/praisonai && python tests/test_runner.py --pattern fast

.github/workflows/python-publish.yml

@@ -8,25 +8,20 @@
 
 name: Upload Python Package
 
-# Superseded by pypi-release.yml (manual workflow_dispatch with uv publish).
-# Kept as workflow_dispatch-only fallback; release trigger removed to avoid
-# duplicate PyPI publish when bump_and_release creates a GitHub release.
 on:
-  workflow_dispatch:
+  release:
+    types: [published]
 
 permissions:
   contents: read
 
 jobs:
   deploy:
-    if: false
 
     runs-on: ubuntu-latest
 
     steps:
     - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
     - name: Set up Python
       uses: actions/setup-python@v5
       with:

.github/workflows/release.yml

@@ -27,7 +27,6 @@ jobs:
     - name: Checkout upstream repo
       uses: actions/checkout@v4
       with:
-        persist-credentials: false
         repository: MervinPraison/PraisonAI
         ref: ${{ github.event.inputs.tag }}
         fetch-depth: 0
@@ -35,18 +34,15 @@ jobs:
     # Get the commit hash from the tag
     - name: Get commit hash
       id: get_commit
-      env:
-        INPUT_TAG: ${{ github.event.inputs.tag }}
       run: |
         COMMIT_HASH=$(git rev-parse HEAD)
         echo "commit_hash=$COMMIT_HASH" >> $GITHUB_OUTPUT
-        echo "Found commit: $COMMIT_HASH for tag $INPUT_TAG"
+        echo "Found commit: $COMMIT_HASH for tag ${{ github.event.inputs.tag }}"
 
     # Now checkout the fork at main branch
     - name: Checkout fork
       uses: actions/checkout@v4
       with:
-        persist-credentials: false
         repository: ${{ github.event.inputs.fork_owner }}/PraisonAI
         ref: main
         fetch-depth: 0
@@ -55,8 +51,8 @@ jobs:
     # Sync with upstream commit
     - name: Sync with upstream
       run: |
-        git config --global user.name "MervinPraison"
-        git config --global user.email "[email protected].github.com"
+        git config --global user.name "GitHub Actions"
+        git config --global user.email "actions@github.com"
         
         # Add upstream remote
         git remote add upstream https://github.com/MervinPraison/PraisonAI.git
@@ -64,11 +60,8 @@ jobs:
         # Fetch from upstream
         git fetch upstream --tags --force
         
-    - name: Hard reset to tag commit
-      env:
-        COMMIT_HASH: ${{ steps.get_commit.outputs.commit_hash }}
-      run: |
-        git reset --hard $COMMIT_HASH
+        # Reset to upstream commit
+        git reset --hard ${{ steps.get_commit.outputs.commit_hash }}
 
     - name: Setup Python
       uses: actions/setup-python@v5
@@ -444,7 +437,6 @@ jobs:
     - name: Checkout fork repo
       uses: actions/checkout@v4
       with:
-        persist-credentials: false
         fetch-depth: 0
         token: ${{ secrets.PAT_TOKEN }}
         repository: ${{ github.event.inputs.fork_owner }}/PraisonAI
@@ -453,64 +445,55 @@ jobs:
     # Add upstream and get commit from tag
     - name: Get upstream tag commit
       id: get_upstream_commit
-      env:
-        INPUT_TAG: ${{ github.event.inputs.tag }}
       run: |
         # Add upstream remote
         git remote add upstream https://github.com/MervinPraison/PraisonAI.git
         
         # Delete local tag if it exists
-        git tag -d "$INPUT_TAG" || true
+        git tag -d ${{ github.event.inputs.tag }} || true
         
         # Fetch from upstream including tags with force
         git fetch upstream --tags --force
         
         # Verify tag exists in upstream
-        if ! git ls-remote --tags upstream | grep -q "refs/tags/$INPUT_TAG$"; then
-          echo "::error::Tag $INPUT_TAG not found in upstream repository"
+        if ! git ls-remote --tags upstream | grep -q "refs/tags/${{ github.event.inputs.tag }}$"; then
+          echo "::error::Tag ${{ github.event.inputs.tag }} not found in upstream repository"
           exit 1
         fi
         
         # Get the commit hash from the upstream tag
-        UPSTREAM_COMMIT=$(git rev-list -n 1 refs/tags/"$INPUT_TAG")
+        UPSTREAM_COMMIT=$(git rev-list -n 1 refs/tags/${{ github.event.inputs.tag }})
         if [ -z "$UPSTREAM_COMMIT" ]; then
-          echo "::error::Could not find commit for tag $INPUT_TAG"
+          echo "::error::Could not find commit for tag ${{ github.event.inputs.tag }}"
           exit 1
         fi
         echo "upstream_commit=$UPSTREAM_COMMIT" >> $GITHUB_OUTPUT
-        echo "Found commit: $UPSTREAM_COMMIT for tag $INPUT_TAG"
+        echo "Found commit: $UPSTREAM_COMMIT for tag ${{ github.event.inputs.tag }}"
 
     # Create tag at the same commit
     - name: Create tag at commit
+      run: |
+        git config --global user.name "GitHub Actions"
+        git config --global user.email "[email protected]"
+        
+        # Remove tag if it exists locally
+        git tag -d ${{ github.event.inputs.tag }} || true
+        
+        # Remove tag if it exists remotely
+        git push origin :refs/tags/${{ github.event.inputs.tag }} || true
+        
+        # Fetch the specific commit from upstream
+        git fetch upstream ${{ steps.get_upstream_commit.outputs.upstream_commit }} --force
+        
+        # Reset to upstream commit
+        git reset --hard ${{ steps.get_upstream_commit.outputs.upstream_commit }}
+        
+        # Create and push tag
+        git tag -a ${{ github.event.inputs.tag }} -m "Release ${{ github.event.inputs.tag }} (synced from upstream MervinPraison/PraisonAI@${{ github.event.inputs.tag }})"
+        git push origin ${{ github.event.inputs.tag }}
       env:
         GIT_ASKPASS: /bin/echo
         PAT_TOKEN: ${{ secrets.PAT_TOKEN }}
-        INPUT_TAG: ${{ github.event.inputs.tag }}
-      run: |
-        git config --global user.name "MervinPraison"
-        git config --global user.email "[email protected]"
-        
-        # Remove tag if it exists locally
-        git tag -d "$INPUT_TAG" || true
-        
-        # Remove tag if it exists remotely
-        git push origin :refs/tags/"$INPUT_TAG" || true
-        
-    - name: Fetch tag from upstream
-      env:
-        UPSTREAM_COMMIT: ${{ steps.get_upstream_commit.outputs.upstream_commit }}
-      run: |
-        git fetch upstream $UPSTREAM_COMMIT --force
-        
-    - name: Reset to upstream commit
-      env:
-        UPSTREAM_COMMIT: ${{ steps.get_upstream_commit.outputs.upstream_commit }}
-      run: |
-        git reset --hard $UPSTREAM_COMMIT
-        
-        # Create and push tag
-        git tag -a "$INPUT_TAG" -m "Release $INPUT_TAG (synced from upstream MervinPraison/PraisonAI@$INPUT_TAG)"
-        git push origin "$INPUT_TAG"
 
     # Create the release
     - name: Create Release

.github/workflows/sync-secrets-to-aiui.yml

@@ -1,41 +0,0 @@
-name: Sync Claude Secrets
-
-on:
-  workflow_dispatch:
-    inputs:
-      target_repo:
-        description: 'Destination repo (owner/name)'
-        required: true
-        default: 'MervinPraison/PraisonAIUI'
-        type: string
-
-permissions:
-  contents: read
-
-jobs:
-  sync:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Sync Claude secrets
-        env:
-          GH_TOKEN: ${{ secrets.SECRETS_ADMIN_PAT }}
-          TARGET: ${{ inputs.target_repo }}
-          CLAUDE_APP_ID: ${{ secrets.CLAUDE_APP_ID }}
-          CLAUDE_APP_PRIVATE_KEY: ${{ secrets.CLAUDE_APP_PRIVATE_KEY }}
-          CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          GH_TOKEN_VALUE: ${{ secrets.GH_TOKEN }}
-          DOCS_GITHUB_TOKEN: ${{ secrets.SECRETS_ADMIN_PAT }}
-        run: |
-          set -euo pipefail
-          if [ -z "${GH_TOKEN:-}" ]; then
-            echo "SECRETS_ADMIN_PAT is not configured in this repository"
-            exit 1
-          fi
-          echo -n "$CLAUDE_APP_ID" | gh secret set CLAUDE_APP_ID --repo "$TARGET"
-          echo -n "$CLAUDE_APP_PRIVATE_KEY" | gh secret set CLAUDE_APP_PRIVATE_KEY --repo "$TARGET"
-          echo -n "$CLAUDE_CODE_OAUTH_TOKEN" | gh secret set CLAUDE_CODE_OAUTH_TOKEN --repo "$TARGET"
-          echo -n "$GH_TOKEN_VALUE" | gh secret set GH_TOKEN --repo "$TARGET"
-          if [ -n "${DOCS_GITHUB_TOKEN:-}" ]; then
-            echo -n "$DOCS_GITHUB_TOKEN" | gh secret set DOCS_GITHUB_TOKEN --repo "$TARGET"
-          fi
-          echo "Synced CLAUDE_APP_ID, CLAUDE_APP_PRIVATE_KEY, CLAUDE_CODE_OAUTH_TOKEN, GH_TOKEN → $TARGET"

.github/workflows/sync-to-praisonai-js.yml

@@ -1,106 +0,0 @@
-name: Sync to praisonai-js
-
-# Canonical TS source: src/praisonai-ts/ in this monorepo.
-# This workflow pushes the mirror to MervinPraison/praisonai-js (npm repo).
-
-on:
-  workflow_dispatch:
-    inputs:
-      target_branch:
-        description: 'Target branch on MervinPraison/praisonai-js'
-        required: false
-        default: main
-        type: string
-      mode:
-        description: 'pr = open pull request (default); commit = push directly to target branch'
-        required: false
-        default: pr
-        type: choice
-        options:
-          - pr
-          - commit
-
-permissions:
-  contents: read
-
-jobs:
-  sync:
-    runs-on: ubuntu-latest
-    env:
-      GH_TOKEN: ${{ secrets.GH_TOKEN }}
-      TARGET_REPO: MervinPraison/praisonai-js
-      SOURCE_PATH: src/praisonai-ts
-      TARGET_BRANCH: ${{ inputs.target_branch }}
-    steps:
-      - name: Validate token
-        run: |
-          if [ -z "${GH_TOKEN:-}" ]; then
-            echo "GH_TOKEN secret is required (PAT with repo write access to praisonai-js)."
-            exit 1
-          fi
-
-      - name: Checkout PraisonAI monorepo
-        uses: actions/checkout@v4
-
-      - name: Checkout praisonai-js
-        uses: actions/checkout@v4
-        with:
-          repository: ${{ env.TARGET_REPO }}
-          token: ${{ secrets.GH_TOKEN }}
-          path: praisonai-js-target
-          ref: ${{ env.TARGET_BRANCH }}
-
-      - name: Sync monorepo path into praisonai-js
-        run: |
-          set -euo pipefail
-          rsync -a --delete \
-            --exclude '.git/' \
-            --exclude 'node_modules/' \
-            --exclude 'dist/' \
-            --exclude 'coverage/' \
-            --exclude '.DS_Store' \
-            --exclude '*.tsbuildinfo' \
-            "${SOURCE_PATH}/" praisonai-js-target/
-
-      - name: Push changes
-        working-directory: praisonai-js-target
-        run: |
-          set -euo pipefail
-          git config user.name "github-actions[bot]"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-
-          # Preserve praisonai-js automation (rsync source has no .github/)
-          if git diff --quiet; then
-            echo "No changes — praisonai-js already matches ${SOURCE_PATH} on monorepo main."
-            exit 0
-          fi
-
-          git add -A
-          msg="sync: update from monorepo ${SOURCE_PATH}"
-
-          if [ "${{ inputs.mode }}" = "commit" ]; then
-            git commit -m "$msg"
-            git push origin "HEAD:${TARGET_BRANCH}"
-            echo "Committed and pushed directly to ${TARGET_BRANCH} on praisonai-js."
-            exit 0
-          fi
-
-          branch="sync/monorepo-praisonai-ts-$(date -u +%Y%m%d-%H%M%S)"
-          git checkout -b "$branch"
-          git commit -m "$msg"
-          git push origin "$branch"
-
-          gh pr create \
-            --repo "$TARGET_REPO" \
-            --base "$TARGET_BRANCH" \
-            --head "$branch" \
-            --title "$msg" \
-            --body "$(cat <<EOF
-Automated sync from [\`MervinPraison/PraisonAI\`](https://github.com/MervinPraison/PraisonAI) \`${SOURCE_PATH}/\` into the npm mirror repo.
-
-Canonical development is in the monorepo; this PR updates the public \`praisonai-js\` checkout.
-
-Excludes from rsync source: \`node_modules/\`, \`dist/\`, \`coverage/\`. \`.github/\` on praisonai-js is unchanged.
-EOF
-)"
-          echo "Opened PR on ${TARGET_REPO} (${branch} → ${TARGET_BRANCH})."

.github/workflows/terminal-bench-smoke.yml

@@ -1,47 +0,0 @@
-name: Terminal-Bench Smoke
-
-# Manual (and optional weekly) smoke run of the `praisonai code` assistant on a
-# small verified Terminal-Bench 2.1 subset via the Harbor harness.
-# Never runs on PRs — it costs money (LLM calls) and is inherently flaky.
-
-on:
-  workflow_dispatch:
-  schedule:
-    - cron: "0 6 * * 1" # Mondays 06:00 UTC
-
-permissions:
-  contents: read
-
-jobs:
-  smoke:
-    runs-on: ubuntu-latest
-    timeout-minutes: 45
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-
-      - name: Install Harbor + PraisonAI
-        run: |
-          python -m pip install --upgrade pip
-          pip install harbor
-          pip install -e src/praisonai-agents -e src/praisonai
-
-      - name: Run Terminal-Bench 2.1 smoke subset
-        env:
-          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-          PYTHONPATH: .
-        run: |
-          harbor run -c examples/terminal_bench/job_code_smoke.yaml || true
-
-      - name: Upload Harbor results
-        if: always()
-        uses: actions/upload-artifact@v4
-        with:
-          name: harbor-results
-          path: |
-            runs/
-            **/results.json
-          if-no-files-found: warn

.github/workflows/test-comprehensive.yml

@@ -37,8 +37,6 @@ jobs:
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
-      with:
-        persist-credentials: false
 
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v5
@@ -53,13 +51,12 @@ jobs:
 
     - name: Install dependencies
       run: |
+        cd src/praisonai
+        uv pip install --system ."[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
         uv pip install --system duckduckgo_search
         uv pip install --system pytest pytest-asyncio pytest-cov pytest-benchmark pytest-timeout
+        # Install knowledge dependencies from praisonai-agents
         uv pip install --system "praisonaiagents[knowledge]"
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        use-uv: "true"
-        wrapper-extras: ".[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
 
     - name: Verify environment variables
       run: |
@@ -70,11 +67,9 @@ jobs:
         fi
 
     - name: Run Comprehensive Test Suite
-      env:
-        INPUT_TEST_TYPE: ${{ github.event.inputs.test_type || 'all' }}
       run: |
         # Determine test type from input or default to 'all'
-        TEST_TYPE="$INPUT_TEST_TYPE"
+        TEST_TYPE="${{ github.event.inputs.test_type || 'all' }}"
         
         echo "🧪 Running comprehensive test suite (type: $TEST_TYPE)"
         
@@ -107,16 +102,13 @@ jobs:
 
     - name: Generate Comprehensive Test Report
       if: always()
-      env:
-        INPUT_TEST_TYPE: ${{ github.event.inputs.test_type || 'all' }}
-        EVENT_NAME: ${{ github.event_name }}
       run: |
         echo "# 📋 Comprehensive Test Report" > comprehensive_report.md
         echo "" >> comprehensive_report.md
         echo "**Python Version:** ${{ matrix.python-version }}" >> comprehensive_report.md
-        echo "**Test Type:** $INPUT_TEST_TYPE" >> comprehensive_report.md
-        echo "**Trigger:** $EVENT_NAME" >> comprehensive_report.md
-        echo "**Status:** 🟢 All Tests Passed" >> comprehensive_report.md
+        echo "**Test Type:** ${{ github.event.inputs.test_type || 'all' }}" >> comprehensive_report.md
+        echo "**Trigger:** ${{ github.event_name }}" >> comprehensive_report.md
+        echo "**Date:** $(date -u)" >> comprehensive_report.md
         echo "" >> comprehensive_report.md
         
         echo "## 🧪 Test Categories Covered:" >> comprehensive_report.md

.github/workflows/test-core.yml

@@ -1,325 +1,288 @@
 name: Core Tests
 
-on:
+on: 
   push:
     branches: [ main, develop ]
-    paths:
-      - 'src/**'
-      - 'src/praisonai-deploy/infra/**'
-      - 'src/praisonai-bot/infra/**'
-      - 'scripts/check_helm_charts.sh'
-      - 'pyproject.toml'
-      - '.github/workflows/test-core.yml'
-      - '.github/actions/install-monorepo-packages/**'
   pull_request:
     branches: [ main, develop ]
-    paths:
-      - 'src/**'
-      - 'src/praisonai-deploy/infra/**'
-      - 'src/praisonai-bot/infra/**'
-      - 'scripts/check_helm_charts.sh'
-      - 'pyproject.toml'
-      - '.github/workflows/test-core.yml'
-      - '.github/actions/install-monorepo-packages/**'
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-env:
-  PYTHONPATH: ${{ github.workspace }}/src/praisonai-agents
-  PRAISONAI_ALLOW_NETWORK: '0'
-  PRAISONAI_LIVE_TESTS: '0'
-  PRAISONAI_TEST_TIER: main
 
 jobs:
-  test-core-collect:
-    name: test-core-collect
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-    steps:
-    - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
-    - name: Set up Python 3.11
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.11'
-    - name: Install UV
-      run: |
-        curl -LsSf https://astral.sh/uv/install.sh | sh
-        echo "$HOME/.local/bin" >> $GITHUB_PATH
-    - name: Install dependencies
-      run: |
-        cd src/praisonai
-        uv pip install --system duckduckgo_search
-        uv pip install --system pytest pytest-asyncio pytest-timeout pytest-xdist
-        uv pip install --system "praisonaiagents[knowledge]"
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        use-uv: "true"
-        wrapper-extras: ".[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
-    - name: Set environment variables
-      run: |
-        echo "OPENAI_API_KEY=${{ secrets.OPENAI_API_KEY || 'sk-test-key-for-github-actions-testing-only-not-real' }}" >> $GITHUB_ENV
-        echo "OPENAI_API_BASE=${{ secrets.OPENAI_API_BASE || 'https://api.openai.com/v1' }}" >> $GITHUB_ENV
-        echo "OPENAI_MODEL_NAME=gpt-4o-mini" >> $GITHUB_ENV
-        echo "PYTHONPATH=${{ github.workspace }}/src/praisonai-agents:$PYTHONPATH" >> $GITHUB_ENV
-    - name: Verify unit test collection
-      shell: bash
-      run: |
-        set -euo pipefail
-        cd src/praisonai
-        python -m pytest tests/unit/ \
-          -m "not provider_anthropic and not provider_google and not provider_ollama and not provider_grok_xai and not provider_groq and not provider_cohere" \
-          --ignore=tests/fixtures \
-          --collect-only -q --disable-warnings
-
-  test-core-unit:
-    name: test-core (${{ matrix.shard }})
-    needs: test-core-collect
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - shard: cli
-            paths: >-
-              tests/unit/cli/
-              tests/unit/tui/
-            extra_ignore: --ignore=tests/unit/cli/test_message_queue.py
-          - shard: bots-gateway
-            workdir: src/praisonai-bot
-            paths: >-
-              tests/unit/bots/
-              tests/unit/gateway/
-              tests/unit/cli/
-              tests/unit/daemon/
-            extra_ignore: ""
-            pythonpath: >-
-              ${{ github.workspace }}/src/praisonai-agents:${{ github.workspace }}/src/praisonai-code
-          - shard: train
-            workdir: src/praisonai-train
-            # tests/unit/data/ (96 tests) was collected by no workflow at all.
-            paths: >-
-              tests/unit/train/ tests/unit/data/
-            extra_ignore: ""
-            pythonpath: >-
-              ${{ github.workspace }}/src/praisonai-agents:${{ github.workspace }}/src/praisonai-code
-          - shard: mcp
-            workdir: src/praisonai-mcp
-            paths: >-
-              tests/mcp_server/
-            extra_ignore: ""
-            pythonpath: >-
-              ${{ github.workspace }}/src/praisonai-agents
-          - shard: sandbox
-            workdir: src/praisonai-sandbox
-            paths: >-
-              tests/
-            extra_ignore: ""
-            pythonpath: >-
-              ${{ github.workspace }}/src/praisonai-agents
-          - shard: deploy
-            workdir: src/praisonai-deploy
-            paths: >-
-              tests/
-            extra_ignore: ""
-            pythonpath: >-
-              ${{ github.workspace }}/src/praisonai-agents
-          - shard: subdirs
-            paths: >-
-              tests/unit/scheduler/
-              tests/unit/integrations/
-              tests/unit/mcp/
-              tests/unit/knowledge/
-              tests/unit/llm/
-              tests/unit/doctor/
-              tests/unit/code/
-              tests/unit/acp/
-              tests/unit/agent/
-              tests/unit/tools/
-              tests/unit/persistence/
-              tests/unit/security/
-              tests/unit/recipe/
-              tests/unit/storage/
-              tests/unit/rag/
-              tests/unit/replay/
-              tests/unit/escalation/
-              tests/unit/orchestration/
-              tests/unit/dev/
-              tests/unit/_dev/
-              tests/unit/context/
-              tests/unit/adapters/
-              tests/unit/templates/
-              tests/unit/suite_runner/
-              tests/unit/standardise/
-            extra_ignore: ""
-          - shard: root
-            paths: ""
-            extra_ignore: ""
-            root_glob: "true"
-    steps:
-    - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
-    - name: Set up Python 3.11
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.11'
-    - name: Install UV
-      run: |
-        curl -LsSf https://astral.sh/uv/install.sh | sh
-        echo "$HOME/.local/bin" >> $GITHUB_PATH
-    - name: Install dependencies
-      run: |
-        cd src/praisonai
-        uv pip install --system duckduckgo_search
-        uv pip install --system pytest pytest-asyncio pytest-timeout pytest-xdist
-        uv pip install --system "praisonaiagents[knowledge]"
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        use-uv: "true"
-        wrapper-extras: ".[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
-    - name: Set environment variables
-      run: |
-        echo "OPENAI_API_KEY=${{ secrets.OPENAI_API_KEY || 'sk-test-key-for-github-actions-testing-only-not-real' }}" >> $GITHUB_ENV
-        echo "OPENAI_API_BASE=${{ secrets.OPENAI_API_BASE || 'https://api.openai.com/v1' }}" >> $GITHUB_ENV
-        echo "OPENAI_MODEL_NAME=gpt-4o-mini" >> $GITHUB_ENV
-        echo "PYTHONPATH=${{ github.workspace }}/src/praisonai-agents:$PYTHONPATH" >> $GITHUB_ENV
-    - name: Run unit shard
-      shell: bash
-      run: |
-        set -euo pipefail
-        WORKDIR="${{ matrix.workdir || 'src/praisonai' }}"
-        if [ "$WORKDIR" = "src/praisonai-sandbox" ]; then
-          bash "$GITHUB_WORKSPACE/scripts/check_c13_sandbox_imports.sh"
-        fi
-        if [ "$WORKDIR" = "src/praisonai-deploy" ]; then
-          bash "$GITHUB_WORKSPACE/scripts/check_c14_deploy_imports.sh"
-        fi
-        if [ "$WORKDIR" = "src/praisonai-mcp" ]; then
-          bash "$GITHUB_WORKSPACE/scripts/check_c12_mcp_imports.sh"
-        fi
-        cd "$WORKDIR"
-        if [ -n "${{ matrix.pythonpath || '' }}" ]; then
-          export PYTHONPATH="${{ matrix.pythonpath }}:${PYTHONPATH:-}"
-        fi
-        PYTEST_ARGS=(
-          -m "not slow and not network and not local_service and not provider_anthropic and not provider_google and not provider_ollama and not provider_grok_xai and not provider_groq and not provider_cohere"
-          -q --tb=line --disable-warnings
-          --timeout=60 -n 2 --dist loadfile
-          --ignore=tests/fixtures
-          --ignore=tests/e2e
-          --ignore=tests/live
-          --ignore=tests/unit/test_langflow_components.py
-        )
-        if [ "${{ matrix.root_glob || 'false' }}" = "true" ]; then
-          shopt -s nullglob
-          ROOT_TESTS=(tests/unit/test_*.py)
-          shopt -u nullglob
-          EXCLUDE=(tests/unit/test_langflow_components.py)
-          FILTERED=()
-          for t in "${ROOT_TESTS[@]}"; do
-            skip=false
-            for e in "${EXCLUDE[@]}"; do
-              if [ "$t" = "$e" ]; then skip=true; break; fi
-            done
-            if [ "$skip" = false ]; then FILTERED+=("$t"); fi
-          done
-          if [ ${#FILTERED[@]} -eq 0 ]; then
-            echo "No root unit tests matched"
-            exit 0
-          fi
-          python -m pytest "${FILTERED[@]}" "${PYTEST_ARGS[@]}"
-        else
-          python -m pytest ${{ matrix.paths }} "${PYTEST_ARGS[@]}" ${{ matrix.extra_ignore }}
-        fi
-
-  test-core-integration:
-    name: test-core-integration
-    needs: test-core-unit
-    runs-on: ubuntu-latest
-    timeout-minutes: 25
-    steps:
-    - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
-    - name: Set up Python 3.11
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.11'
-    - name: Install UV
-      run: |
-        curl -LsSf https://astral.sh/uv/install.sh | sh
-        echo "$HOME/.local/bin" >> $GITHUB_PATH
-    - name: Install dependencies
-      run: |
-        uv pip install --system duckduckgo_search
-        uv pip install --system pytest pytest-asyncio pytest-timeout
-        uv pip install --system "praisonaiagents[knowledge]"
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        use-uv: "true"
-        wrapper-extras: ".[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
-    - name: Set environment variables
-      run: |
-        echo "OPENAI_API_KEY=${{ secrets.OPENAI_API_KEY || 'sk-test-key-for-github-actions-testing-only-not-real' }}" >> $GITHUB_ENV
-        echo "OPENAI_API_BASE=${{ secrets.OPENAI_API_BASE || 'https://api.openai.com/v1' }}" >> $GITHUB_ENV
-        echo "OPENAI_MODEL_NAME=gpt-4o-mini" >> $GITHUB_ENV
-        echo "PYTHONPATH=${{ github.workspace }}/src/praisonai-agents:$PYTHONPATH" >> $GITHUB_ENV
-    - name: Run integration tests
-      shell: bash
-      run: |
-        set -euo pipefail
-        cd src/praisonai
-        python -m pytest tests/integration/ \
-          -m "not slow and not network and not local_service and not provider_anthropic and not provider_google and not provider_ollama and not provider_grok_xai and not provider_groq and not provider_cohere" \
-          -q --tb=line --disable-warnings \
-          --timeout=120 \
-          --ignore=tests/fixtures \
-          --ignore=tests/e2e \
-          --ignore=tests/live \
-          --ignore=tests/integration/test_tracker_complex_tasks.py \
-          --ignore=tests/integration/test_serve_integration.py
-
-  helm-charts:
-    name: helm-charts
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-    steps:
-    - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
-    - name: Setup Helm
-      uses: azure/setup-helm@v3
-      with:
-        version: v3.14.4
-    - name: Lint and template Helm charts
-      shell: bash
-      run: |
-        set -euo pipefail
-        bash "$GITHUB_WORKSPACE/scripts/check_helm_charts.sh"
-
   test-core:
-    name: test-core
-    needs: [test-core-collect, test-core-unit, test-core-integration, helm-charts]
-    if: always()
     runs-on: ubuntu-latest
-    timeout-minutes: 5
+    timeout-minutes: 15
+    strategy:
+      matrix:
+        python-version: [3.11]
+    
     steps:
-    - name: Report Core Tests result
-      shell: bash
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install UV
       run: |
-        set -euo pipefail
-        collect='${{ needs.test-core-collect.result }}'
-        unit='${{ needs.test-core-unit.result }}'
-        integration='${{ needs.test-core-integration.result }}'
-        helm='${{ needs.helm-charts.result }}'
-        echo "collect=$collect unit=$unit integration=$integration helm=$helm"
-        if [ "$collect" != "success" ] || [ "$unit" != "success" ] || [ "$integration" != "success" ] || [ "$helm" != "success" ]; then
-          echo "Core Tests failed"
-          exit 1
+        curl -LsSf https://astral.sh/uv/install.sh | sh
+        echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+
+    - name: Install dependencies
+      run: |
+        cd src/praisonai
+        uv pip install --system ."[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
+        uv pip install --system duckduckgo_search
+        uv pip install --system pytest pytest-asyncio pytest-cov pytest-timeout
+        # Install knowledge dependencies from praisonai-agents
+        uv pip install --system "praisonaiagents[knowledge]"
+
+    - name: Set environment variables
+      run: |
+        echo "OPENAI_API_KEY=${{ secrets.OPENAI_API_KEY || 'sk-test-key-for-github-actions-testing-only-not-real' }}" >> $GITHUB_ENV
+        echo "OPENAI_API_BASE=${{ secrets.OPENAI_API_BASE || 'https://api.openai.com/v1' }}" >> $GITHUB_ENV
+        echo "OPENAI_MODEL_NAME=${{ secrets.OPENAI_MODEL_NAME || 'gpt-5-nano' }}" >> $GITHUB_ENV
+        echo "LOGLEVEL=DEBUG" >> $GITHUB_ENV
+        echo "PYTHONPATH=${{ github.workspace }}/src/praisonai-agents:$PYTHONPATH" >> $GITHUB_ENV
+        # Also export to current shell session for immediate availability
+        export OPENAI_API_KEY="${{ secrets.OPENAI_API_KEY || 'sk-test-key-for-github-actions-testing-only-not-real' }}"
+        export OPENAI_API_BASE="${{ secrets.OPENAI_API_BASE || 'https://api.openai.com/v1' }}"
+        export OPENAI_MODEL_NAME="${{ secrets.OPENAI_MODEL_NAME || 'gpt-5-nano' }}"
+        export LOGLEVEL=DEBUG
+        # Verify immediate availability
+        echo "🔧 Immediate verification in same step:"
+        echo "  OPENAI_API_KEY length in current session: ${#OPENAI_API_KEY}"
+        echo "  OPENAI_API_KEY starts with sk-: $(echo "$OPENAI_API_KEY" | grep -q '^sk-' && echo 'YES' || echo 'NO')"
+
+    - name: Debug API Key Status
+      run: |
+        echo "🔍 Checking API key availability..."
+        if [ -n "${{ secrets.OPENAI_API_KEY }}" ]; then
+          echo "✅ GitHub secret OPENAI_API_KEY is available"
+          echo "🔑 API key starts with: $(echo "$OPENAI_API_KEY" | cut -c1-7)..."
+        else
+          echo "⚠️ GitHub secret OPENAI_API_KEY is NOT set - using fallback"
+          echo "🔑 Using fallback key: sk-test-key..."
         fi
-        echo "Core Tests passed"
+        echo "🌐 API Base: $OPENAI_API_BASE"
+        echo "🤖 Model: $OPENAI_MODEL_NAME"
+        echo "🐛 Log Level: $LOGLEVEL"
+        echo "📊 Environment Check:"
+        echo "  - OPENAI_API_KEY length: ${#OPENAI_API_KEY}"
+        echo "  - OPENAI_API_BASE: $OPENAI_API_BASE"
+        echo "  - OPENAI_MODEL_NAME: $OPENAI_MODEL_NAME"
+        echo "  - LOGLEVEL: $LOGLEVEL"
+        echo "🔍 Is API key actually set?"
+        echo "  - API key starts with sk-: $(echo "$OPENAI_API_KEY" | grep -q '^sk-' && echo 'YES' || echo 'NO')"
+        echo "  - API key is not test key: $([ "$OPENAI_API_KEY" != 'sk-test-key-for-github-actions-testing-only-not-real' ] && echo 'YES' || echo 'NO')"
+
+    - name: Debug Environment Variables Raw
+      run: |
+        echo "🔧 Raw environment variable check:"
+        echo "OPENAI_API_KEY set: $(if [ -n "$OPENAI_API_KEY" ]; then echo 'YES'; else echo 'NO'; fi)"
+        echo "OPENAI_API_KEY length: ${#OPENAI_API_KEY}"
+        echo "OPENAI_API_KEY first 10 chars: ${OPENAI_API_KEY:0:10}"
+        echo "OPENAI_API_KEY last 5 chars: ${OPENAI_API_KEY: -5}"
+        printenv | grep OPENAI || echo "No OPENAI env vars found"
+
+    - name: Debug Python Environment Variables  
+      run: |
+        python -c "
+        import os
+        print('🐍 Python Environment Variable Check:')
+        api_key = os.environ.get('OPENAI_API_KEY', 'NOT_SET')
+        if api_key != 'NOT_SET':
+            print(f'  ✅ OPENAI_API_KEY: {api_key[:7]}... (length: {len(api_key)})')
+        else:
+            print('  ❌ OPENAI_API_KEY: NOT_SET')
+        print(f'  🌐 OPENAI_API_BASE: {os.environ.get(\"OPENAI_API_BASE\", \"NOT_SET\")}')
+        print(f'  🤖 OPENAI_MODEL_NAME: {os.environ.get(\"OPENAI_MODEL_NAME\", \"NOT_SET\")}')
+        print(f'  📋 All OPENAI env vars:')
+        for key, value in os.environ.items():
+            if key.startswith('OPENAI'):
+                print(f'    {key}: {value[:10] if len(value) > 10 else value}...')
+        "
+
+    - name: Validate API Key
+      run: |
+        echo "🔑 Testing API key validity with minimal OpenAI call..."
+        python -c "
+        import os
+        try:
+            from openai import OpenAI
+            client = OpenAI(api_key=os.environ.get('OPENAI_API_KEY'))
+            response = client.models.list()
+            print('✅ API Key is VALID - OpenAI responded successfully')
+            print(f'📊 Available models: {len(list(response.data))} models found')
+        except Exception as e:
+            print(f'❌ API Key is INVALID - Error: {e}')
+            print('🔍 This explains why all API-dependent tests are failing')
+            print('💡 The GitHub secret OPENAI_API_KEY needs to be updated with a valid key')
+        "
+      continue-on-error: true
+
+    - name: Debug PraisonAI API Key Usage
+      env:
+        OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY || 'sk-test-key-for-github-actions-testing-only-not-real' }}
+        OPENAI_API_BASE: ${{ secrets.OPENAI_API_BASE || 'https://api.openai.com/v1' }}
+        OPENAI_MODEL_NAME: ${{ secrets.OPENAI_MODEL_NAME || 'gpt-5-nano' }}
+        LOGLEVEL: DEBUG
+      run: |
+        echo "🔍 Testing PraisonAI API key usage directly..."
+        cd src/praisonai
+        python -c "
+        import os
+        import sys
+        sys.path.insert(0, '.')
+        
+        # Attempt to import SecretStr, otherwise use a dummy class
+        try:
+            from pydantic.types import SecretStr
+        except ImportError:
+            class SecretStr:  # Dummy class if pydantic is not available in this minimal context
+                def __init__(self, value): self._value = value
+                def get_secret_value(self): return self._value
+
+        def get_key_display_value(key_value):
+            if isinstance(key_value, SecretStr):
+                return key_value.get_secret_value()[:10] if key_value.get_secret_value() else 'EMPTY_SECRET'
+            elif isinstance(key_value, str):
+                return key_value[:10] if key_value != 'nokey' and key_value != 'NOT_SET' else key_value
+            return 'INVALID_TYPE'
+
+        print('🔧 Direct PraisonAI API Key Check:')
+        env_api_key = os.environ.get(\"OPENAI_API_KEY\", \"NOT_SET\")
+        print(f'Environment OPENAI_API_KEY: {get_key_display_value(env_api_key)}...')
+        
+        from praisonai import PraisonAI
+        praisonai = PraisonAI()
+        
+        print(f'PraisonAI config_list: {praisonai.config_list}')
+        api_key_from_config = praisonai.config_list[0].get('api_key', 'NOT_SET')
+        print(f'API key from PraisonAI config: {get_key_display_value(api_key_from_config)}...')
+        
+        from praisonai.inc.models import PraisonAIModel
+        
+        print('\\n🧪 Testing PraisonAIModel with explicit API key (CrewAI method):')
+        model_with_explicit_key = PraisonAIModel(
+            model='openai/gpt-5-nano',
+            base_url=praisonai.config_list[0].get('base_url'),
+            api_key=api_key_from_config # This will be a string from praisonai.config_list
+        )
+        print(f'  Model: {model_with_explicit_key.model}')
+        print(f'  Model name: {model_with_explicit_key.model_name}')
+        print(f'  API key var: {model_with_explicit_key.api_key_var}')
+        # model_with_explicit_key.api_key is now a string, or 'nokey'
+        print(f'  API key (explicitly passed to PraisonAIModel): {get_key_display_value(model_with_explicit_key.api_key)}...')
+        print(f'  Base URL: {model_with_explicit_key.base_url}')
+        
+        try:
+            llm_instance = model_with_explicit_key.get_model()
+            print(f'  ✅ LLM instance created successfully: {type(llm_instance).__name__}')
+            
+            # langchain_openai.ChatOpenAI stores the key in openai_api_key as SecretStr
+            llm_api_key_attr = getattr(llm_instance, 'openai_api_key', 'NOT_FOUND')
+            if llm_api_key_attr != 'NOT_FOUND':
+                 print(f'  LLM instance API key: {get_key_display_value(llm_api_key_attr)}...')
+            else:
+                print(f'  LLM instance API key attribute not found.')
+        except Exception as e:
+            print(f'  ❌ Failed to create LLM instance: {e}')
+            import traceback
+            traceback.print_exc()
+        "
+      continue-on-error: true
+
+    - name: Run Unit Tests
+      run: |
+        cd src/praisonai && python -m pytest tests/unit/ -v --tb=short --disable-warnings --cov=praisonai --cov-report=term-missing --cov-report=xml --cov-branch || echo "Some tests failed - see output above"
+      continue-on-error: true
+
+    - name: Run Integration Tests  
+      run: |
+        cd src/praisonai && python -m pytest tests/integration/ -v --tb=short --disable-warnings
+
+    - name: Debug Directory Structure
+      run: |
+        echo "🔍 Debugging directory structure for CrewAI tests..."
+        cd src/praisonai
+        echo "Current working directory: $(pwd)"
+        echo "📁 Contents of current directory:"
+        ls -la
+        echo ""
+        echo "📁 Contents of tests directory:"
+        ls -la tests/ || echo "❌ tests/ directory not found"
+        echo ""
+        echo "📁 Contents of tests/integration:"
+        ls -la tests/integration/ || echo "❌ tests/integration/ directory not found"
+        echo ""
+        echo "📁 Looking for crewai directory:"
+        find . -name "crewai" -type d 2>/dev/null || echo "❌ No crewai directories found"
+        echo ""
+        echo "📁 Full directory tree of tests:"
+        tree tests/ || find tests/ -type d 2>/dev/null || echo "❌ Cannot explore tests directory"
+
+    - name: Test AutoGen Framework
+      run: |
+        echo "🤖 Testing AutoGen Framework Integration..."
+        cd src/praisonai && python tests/test_runner.py --pattern autogen --verbose
+
+    - name: Test CrewAI Framework
+      run: |
+        echo "⛵ Testing CrewAI Framework Integration..."
+        cd src/praisonai
+        echo "🔍 Trying test runner first..."
+        python tests/test_runner.py --pattern crewai --verbose || {
+          echo "❌ Test runner failed, trying direct pytest..."
+          echo "📁 Current directory: $(pwd)"
+          echo "📁 Looking for CrewAI tests..."
+          find . -name "*crewai*" -type f 2>/dev/null
+          echo "🧪 Trying direct pytest on integration/crewai..."
+          python -m pytest tests/integration/crewai/ -v --tb=short --disable-warnings || {
+            echo "❌ Direct path failed, trying relative path..."
+            python -m pytest integration/crewai/ -v --tb=short --disable-warnings || {
+              echo "❌ All CrewAI test attempts failed"
+              exit 1
+            }
+          }
+        }
+
+    - name: Run Legacy Tests with API Key
+      env:
+        OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY || 'sk-test-key-for-github-actions-testing-only-not-real' }}
+        OPENAI_API_BASE: ${{ secrets.OPENAI_API_BASE || 'https://api.openai.com/v1' }}
+        OPENAI_MODEL_NAME: ${{ secrets.OPENAI_MODEL_NAME || 'gpt-5-nano' }}
+        LOGLEVEL: DEBUG
+      run: |
+        echo "🧪 Running legacy tests with real API key..."
+        echo "🔧 Final environment check before pytest:"
+        echo "  OPENAI_API_KEY set: $([ -n "$OPENAI_API_KEY" ] && echo 'YES' || echo 'NO')"
+        echo "  OPENAI_API_KEY length: ${#OPENAI_API_KEY}"
+        echo "  OPENAI_API_KEY starts with sk-: $(echo "$OPENAI_API_KEY" | grep -q '^sk-' && echo 'YES' || echo 'NO')"
+        export OPENAI_API_KEY="$OPENAI_API_KEY"
+        export OPENAI_API_BASE="$OPENAI_API_BASE"
+        export OPENAI_MODEL_NAME="$OPENAI_MODEL_NAME"
+        cd src/praisonai && python -m pytest tests/test.py -v --tb=short --disable-warnings -m "not real" --timeout=60
+
+    - name: Upload coverage reports to Codecov
+      if: matrix.python-version == '3.11'
+      uses: codecov/codecov-action@v5
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        file: src/praisonai/coverage.xml
+        flags: core-tests
+        name: core-tests-coverage
+        fail_ci_if_error: false
+        verbose: true
+
+    - name: Upload Coverage Reports (Artifacts)
+      if: matrix.python-version == '3.11'
+      uses: actions/upload-artifact@v4
+      with:
+        name: coverage-reports
+        path: |
+          src/praisonai/.coverage
+          src/praisonai/htmlcov/
+          src/praisonai/coverage.xml
+        retention-days: 7

.github/workflows/test-extended.yml

@@ -1,9 +1,14 @@
 name: Extended Tests
 
 on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
   schedule:
+    # Run nightly at 2 AM UTC
     - cron: '0 2 * * *'
-  workflow_dispatch:
+  workflow_dispatch:  # Allow manual triggering
 
 jobs:
   test-examples:
@@ -13,8 +18,6 @@ jobs:
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
-      with:
-        persist-credentials: false
 
     - name: Set up Python
       uses: actions/setup-python@v5
@@ -29,12 +32,11 @@ jobs:
 
     - name: Install dependencies
       run: |
+        cd src/praisonai
+        uv pip install --system ."[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
         uv pip install --system duckduckgo_search
+        # Install knowledge dependencies from praisonai-agents
         uv pip install --system "praisonaiagents[knowledge]"
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        use-uv: "true"
-        wrapper-extras: ".[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
 
     - name: Set environment variables
       run: |
@@ -80,8 +82,6 @@ jobs:
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
-      with:
-        persist-credentials: false
 
     - name: Set up Python
       uses: actions/setup-python@v5
@@ -96,12 +96,11 @@ jobs:
 
     - name: Install dependencies
       run: |
+        cd src/praisonai
+        uv pip install --system ."[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
         uv pip install --system pytest pytest-benchmark
+        # Install knowledge dependencies from praisonai-agents
         uv pip install --system "praisonaiagents[knowledge]"
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        use-uv: "true"
-        wrapper-extras: ".[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
 
     - name: Set environment variables
       run: |

.github/workflows/test-frameworks.yml

@@ -33,8 +33,6 @@ jobs:
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
-      with:
-        persist-credentials: false
 
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v5
@@ -49,12 +47,10 @@ jobs:
 
     - name: Install dependencies
       run: |
+        cd src/praisonai
+        uv pip install --system ."[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
         uv pip install --system duckduckgo_search
         uv pip install --system pytest pytest-asyncio pytest-cov pytest-timeout
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        use-uv: "true"
-        wrapper-extras: ".[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
 
     - name: Set environment variables
       run: |

.github/workflows/test-optimized.yml

@@ -3,16 +3,8 @@ name: Optimized Test Suite
 on: 
   push:
     branches: [ main, develop ]
-    paths:
-      - 'src/**'
-      - 'pyproject.toml'
-      - '.github/workflows/test-optimized.yml'
   pull_request:
     branches: [ main, develop ]
-    paths:
-      - 'src/**'
-      - 'pyproject.toml'
-      - '.github/workflows/test-optimized.yml'
   schedule:
     # Nightly extended tests at 3 AM UTC
     - cron: '0 3 * * *'
@@ -42,11 +34,10 @@ jobs:
   # ============================================
   smoke:
     runs-on: ubuntu-latest
-    timeout-minutes: 12
+    timeout-minutes: 5
     steps:
     - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
+    
     - name: Set up Python 3.11
       uses: actions/setup-python@v5
       with:
@@ -64,247 +55,28 @@ jobs:
     - name: Install minimal dependencies
       run: |
         pip install --upgrade pip
+        # Install praisonai-agents with all deps (required for tests)
+        cd src/praisonai-agents
+        pip install -e ".[all]"
+        cd ../praisonai
+        pip install -e ".[chat,code]"
         pip install pytest pytest-asyncio pytest-timeout prompt_toolkit
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        agents-extras: ".[all]"
-        wrapper-extras: ".[chat,code]"
     
     - name: Run Smoke Tests
       env:
         PRAISONAI_TEST_TIER: smoke
         PRAISONAI_ALLOW_NETWORK: '0'
-        OPENAI_MODEL_NAME: gpt-4o-mini
-      shell: bash
       run: |
-        set -euo pipefail
         cd src/praisonai
-        python -m pytest tests/unit/test_c5_backward_compat.py \
-          tests/unit/test_c7_1_boundaries.py \
-          tests/unit/test_c9_backward_compat.py \
-          tests/unit/test_c9_1_boundaries.py \
-          tests/unit/test_c11_browser_backward_compat.py \
-          tests/unit/test_c12_mcp_backward_compat.py \
-          tests/unit/test_c13_sandbox_backward_compat.py \
-          tests/unit/test_c14_deploy_backward_compat.py \
-          -q --tb=line --timeout=30 --maxfail=5
+        # Run only CLI tests for smoke - fast and critical path
         python -m pytest tests/unit/cli/ \
-          ../praisonai-bot/tests/unit/cli/test_onboard_command.py \
-          ../praisonai-bot/tests/unit/cli/test_onboard_non_interactive.py \
           -m "not slow and not network" \
           -q --tb=line \
           --timeout=30 \
           --ignore=tests/fixtures \
           --ignore=tests/unit/cli/test_message_queue.py \
-          --maxfail=5
-
-    - name: Run praisonai-agents subscription-auth smoke tests
-      env:
-        PRAISONAI_TEST_TIER: smoke
-        PRAISONAI_ALLOW_NETWORK: '0'
-        OPENAI_MODEL_NAME: gpt-4o-mini
-        OPENAI_API_KEY: 'test-key'
-      shell: bash
-      run: |
-        set -euo pipefail
-        cd src/praisonai-agents
-        python -m pytest tests/smoke/test_subscription_auth.py \
-          tests/unit/auth/test_agent_auth_wiring.py \
-          -q --tb=line --timeout=60 --maxfail=5
-
-    - name: Standalone praisonai-code import smoke
-      shell: bash
-      run: |
-        set -euo pipefail
-        python -m venv /tmp/praisonai-code-standalone
-        /tmp/praisonai-code-standalone/bin/pip install -q -e src/praisonai-agents -e src/praisonai-code
-        /tmp/praisonai-code-standalone/bin/python -c "
-        import praisonai_code
-        from praisonai_code.cli.configuration.resolver import ConfigResolver
-        from praisonai_code._version import get_package_version
-        from praisonai_code.llm.credentials import is_configured
-        from praisonai_code.llm.catalogue import ModelCatalogue
-        import toml
-        assert hasattr(ConfigResolver, '__name__')
-        assert callable(is_configured)
-        assert ModelCatalogue().list_models(provider='openai')
-        import praisonai_code.cli.main
-        import praisonai_code.cli.app
-        from praisonai_code.tool_resolver import ToolResolver
-        assert ToolResolver is not None
-        print('standalone ok', get_package_version(), 'toml', toml.__version__)
-        "
-        /tmp/praisonai-code-standalone/bin/praisonai-code --version
-        /tmp/praisonai-code-standalone/bin/praisonai-code run --help
-        cd src/praisonai-code
-        for f in praisonai_code/cli/main.py praisonai_code/cli/app.py \
-                 praisonai_code/cli/commands/run.py praisonai_code/cli/commands/chat.py \
-                 praisonai_code/cli/commands/code.py; do
-          if grep -E '^from praisonai\.|^import praisonai' "$f"; then
-            echo "FAIL: module-level wrapper import in $f"
-            exit 1
-          fi
-        done
-        echo "C7 hot-path import gate ok"
-        bash "$GITHUB_WORKSPACE/scripts/check_c7_imports.sh"
-        # Standalone actions run (no wrapper); default run/chat require praisonai
-        set +e
-        RUN_OUT=$(timeout 90 /tmp/praisonai-code-standalone/bin/praisonai-code run --output actions "Say hello in one word" 2>&1)
-        RUN_CODE=$?
-        set -e
-        echo "$RUN_OUT" | tail -20
-        if echo "$RUN_OUT" | grep -qE 'ImportError|ModuleNotFoundError: No module named .praisonai'; then
-          echo "FAIL: standalone actions run hit wrapper import error"
-          exit 1
-        fi
-        echo "standalone actions run import gate ok (exit $RUN_CODE)"
-        set +e
-        DEFAULT_RUN=$(timeout 15 /tmp/praisonai-code-standalone/bin/praisonai-code run "hi" 2>&1)
-        set -e
-        echo "$DEFAULT_RUN" | tail -10
-        if ! echo "$DEFAULT_RUN" | grep -qi 'install praisonai'; then
-          echo "FAIL: default run should prompt for praisonai wrapper install"
-          exit 1
-        fi
-        echo "default run wrapper gate ok"
-        set +e
-        CHAT_RUN=$(timeout 10 /tmp/praisonai-code-standalone/bin/praisonai-code chat 2>&1)
-        set -e
-        echo "$CHAT_RUN" | tail -10
-        if ! echo "$CHAT_RUN" | grep -qi 'install praisonai'; then
-          echo "FAIL: chat should prompt for praisonai wrapper install"
-          exit 1
-        fi
-        echo "chat wrapper gate ok"
-
-    - name: Standalone praisonai-bot smoke (C9)
-      run: |
-        set -euo pipefail
-        python -m venv /tmp/praisonai-bot-standalone
-        /tmp/praisonai-bot-standalone/bin/pip install -q -e src/praisonai-agents -e src/praisonai-bot
-        /tmp/praisonai-bot-standalone/bin/python -c "
-        from praisonai_bot._version import __version__ as pkg_version
-        import praisonai_bot
-        from praisonai_bot.bots import Bot
-        from praisonai_bot.bots._registry import resolve_adapter
-        from praisonai_bot.scheduler.executor import ScheduledAgentExecutor
-        from praisonai_bot.gateway import WebSocketGateway
-        assert praisonai_bot.__version__ == pkg_version
-        telegram = resolve_adapter('telegram')
-        assert telegram.__name__ == 'TelegramBot'
-        assert telegram.__module__.startswith('praisonai_bot.bots.')
-        assert ScheduledAgentExecutor.__module__.startswith('praisonai_bot.')
-        print('bot standalone ok', praisonai_bot.__version__, telegram.__name__)
-        "
-        /tmp/praisonai-bot-standalone/bin/praisonai-bot --help
-        bash "$GITHUB_WORKSPACE/scripts/check_c9_bot_imports.sh"
-        bash "$GITHUB_WORKSPACE/scripts/check_bot_code_imports.sh"
-        /tmp/praisonai-bot-standalone/bin/python -c "
-        import praisonai_bot.cli.commands.bot as bot_cmd
-        import praisonai_bot.cli.commands.gateway as gw_cmd
-        print('bot command modules import ok', bot_cmd.app, gw_cmd.app)
-        "
-
-    - name: Standalone praisonai-train smoke (C10)
-      run: |
-        set -euo pipefail
-        python -m venv /tmp/praisonai-train-standalone
-        /tmp/praisonai-train-standalone/bin/pip install -q -e src/praisonai-agents -e src/praisonai-train
-        /tmp/praisonai-train-standalone/bin/python -c "
-        import sys
-        from praisonai_train._version import __version__ as pkg_version
-        import praisonai_train
-        assert praisonai_train.__version__ == pkg_version
-        trainer_cls = praisonai_train.AgentTrainer
-        scenario_cls = praisonai_train.TrainingScenario
-        assert trainer_cls.__module__.startswith('praisonai_train.')
-        for heavy in ('torch', 'unsloth', 'trl', 'datasets'):
-            assert heavy not in sys.modules, f'{heavy} imported eagerly'
-        print('train standalone ok', praisonai_train.__version__, trainer_cls.__name__)
-        "
-        /tmp/praisonai-train-standalone/bin/praisonai-train --help
-        /tmp/praisonai-train-standalone/bin/python -c "
-        import praisonai_train.cli.commands.train as train_cmd
-        print('train command module imports ok', train_cmd.app)
-        "
-        bash "$GITHUB_WORKSPACE/scripts/check_c10_train_imports.sh"
-
-    - name: Standalone praisonai-browser smoke (C11)
-      run: |
-        set -euo pipefail
-        python -m venv /tmp/praisonai-browser-standalone
-        /tmp/praisonai-browser-standalone/bin/pip install -q -e src/praisonai-agents -e src/praisonai-browser
-        /tmp/praisonai-browser-standalone/bin/python -c "
-        import sys
-        from praisonai_browser._version import __version__ as pkg_version
-        import praisonai_browser
-        assert praisonai_browser.__version__ == pkg_version
-        server_cls = praisonai_browser.BrowserServer
-        assert server_cls.__name__ == 'BrowserServer'
-        for heavy in ('fastapi', 'uvicorn', 'playwright'):
-            assert heavy not in sys.modules, f'{heavy} imported eagerly'
-        print('browser standalone ok', praisonai_browser.__version__, server_cls.__name__)
-        "
-        /tmp/praisonai-browser-standalone/bin/praisonai-browser --help
-        bash "$GITHUB_WORKSPACE/scripts/check_c11_browser_imports.sh"
-        python -m pytest src/praisonai-browser/tests/browser/test_protocol_compliance.py -q -m "not network"
-
-    - name: Standalone praisonai-mcp smoke (C12)
-      run: |
-        set -euo pipefail
-        python -m venv /tmp/praisonai-mcp-standalone
-        /tmp/praisonai-mcp-standalone/bin/pip install -q -e src/praisonai-agents -e src/praisonai-mcp
-        /tmp/praisonai-mcp-standalone/bin/python -c "
-        import sys
-        from praisonai_mcp._version import __version__ as pkg_version
-        import praisonai_mcp
-        assert praisonai_mcp.__version__ == pkg_version
-        for heavy in ('fastapi', 'uvicorn'):
-            assert heavy not in sys.modules, f'{heavy} imported eagerly'
-        print('mcp standalone ok', praisonai_mcp.__version__)
-        "
-        /tmp/praisonai-mcp-standalone/bin/praisonai-mcp --help
-        bash "$GITHUB_WORKSPACE/scripts/check_c12_mcp_imports.sh"
-        python -m pytest src/praisonai-mcp/tests/mcp_server -q -m "not network"
-
-    - name: Standalone praisonai-sandbox smoke (C13)
-      run: |
-        set -euo pipefail
-        python -m venv /tmp/praisonai-sandbox-standalone
-        /tmp/praisonai-sandbox-standalone/bin/pip install -q -e src/praisonai-agents -e src/praisonai-sandbox
-        /tmp/praisonai-sandbox-standalone/bin/python -c "
-        from praisonai_sandbox._version import __version__ as pkg_version
-        import praisonai_sandbox
-        assert praisonai_sandbox.__version__ == pkg_version
-        for heavy in ('docker', 'modal', 'e2b'):
-            assert heavy not in __import__('sys').modules
-        print('sandbox standalone ok', praisonai_sandbox.__version__)
-        "
-        /tmp/praisonai-sandbox-standalone/bin/praisonai-sandbox --help
-        bash "$GITHUB_WORKSPACE/scripts/check_c13_sandbox_imports.sh"
-        python -m pytest src/praisonai-sandbox/tests -q -m "not network"
-
-    - name: Standalone praisonai-deploy smoke (C14)
-      run: |
-        set -euo pipefail
-        python -m venv /tmp/praisonai-deploy-standalone
-        /tmp/praisonai-deploy-standalone/bin/pip install -q -e src/praisonai-agents -e src/praisonai-deploy
-        /tmp/praisonai-deploy-standalone/bin/python -c "
-        from praisonai_deploy._version import __version__ as pkg_version
-        import praisonai_deploy
-        assert praisonai_deploy.__version__ == pkg_version
-        assert 'main' not in __import__('sys').modules
-        print('deploy standalone ok', praisonai_deploy.__version__)
-        "
-        /tmp/praisonai-deploy-standalone/bin/praisonai-deploy --help
-        bash "$GITHUB_WORKSPACE/scripts/check_c14_deploy_imports.sh"
-        python -m pytest src/praisonai-deploy/tests -q -m "not network"
-
-    - name: Audit hybrid module imports (C8 full stack)
-      run: |
-        set -euo pipefail
-        pip install -q -e src/praisonai-agents -e src/praisonai-code -e src/praisonai-bot -e src/praisonai-train -e src/praisonai-browser -e src/praisonai-mcp -e src/praisonai-sandbox -e src/praisonai-deploy -e src/praisonai
-        python scripts/audit_hybrid_modules.py
+          --maxfail=5 \
+          || echo "Some smoke tests failed"
     
     - name: Smoke Test Summary
       if: always()
@@ -317,15 +89,14 @@ jobs:
   main:
     needs: smoke
     runs-on: ubuntu-latest
-    timeout-minutes: 30
+    timeout-minutes: 10
     strategy:
       matrix:
         python-version: ['3.11']
     
     steps:
     - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
+    
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v5
       with:
@@ -343,44 +114,43 @@ jobs:
     - name: Install dependencies
       run: |
         pip install --upgrade pip
+        # Install praisonai-agents with all deps (required for tests)
+        cd src/praisonai-agents
+        pip install -e ".[all]"
+        cd ../praisonai
+        pip install -e ".[crewai,autogen]"
         pip install pytest pytest-asyncio pytest-timeout pytest-cov pytest-xdist
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        agents-extras: ".[all]"
-        wrapper-extras: ".[crewai,autogen,ui,chat]"
     
     - name: Run Main Tests
       env:
         PRAISONAI_TEST_TIER: main
         PRAISONAI_ALLOW_NETWORK: '0'
-        OPENAI_MODEL_NAME: gpt-4o-mini
         OPENAI_API_KEY: 'test-key'
         ANTHROPIC_API_KEY: 'test-key'
         GOOGLE_API_KEY: 'test-key'
-      shell: bash
       run: |
-        set -euo pipefail
         cd src/praisonai
-        python -m pytest tests/unit/ \
-          -m "not slow and not network and not local_service and not provider_anthropic and not provider_google and not provider_ollama and not provider_grok_xai and not provider_groq and not provider_cohere" \
+        python -m pytest tests/unit/ tests/integration/ \
+          -m "not provider_anthropic and not provider_google and not provider_ollama and not provider_grok_xai and not provider_groq and not provider_cohere" \
           -q --tb=line \
           --timeout=60 \
           --ignore=tests/fixtures \
           --ignore=tests/e2e \
           --ignore=tests/live \
           --ignore=tests/unit/jobs \
-          --ignore=tests/unit/test_langflow_components.py \
+          --ignore=tests/unit/api \
           --cov=praisonai \
           --cov-report=xml \
-          -n 2 --dist loadfile \
-          --maxfail=10
+          -n 4 \
+          --maxfail=10 \
+          || echo "Some tests failed"
     
     - name: Upload coverage
       if: matrix.python-version == '3.11'
       uses: codecov/codecov-action@v5
       with:
-        token: ${{ secrets.CODECOV_TOKEN || '' }}
-        files: src/praisonai/coverage.xml
+        token: ${{ secrets.CODECOV_TOKEN }}
+        file: src/praisonai/coverage.xml
         flags: main-tests
         fail_ci_if_error: false
 
@@ -407,8 +177,6 @@ jobs:
         fi
     
     - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
       if: steps.check-key.outputs.has_key == 'true'
     
     - name: Set up Python 3.11
@@ -430,12 +198,11 @@ jobs:
       if: steps.check-key.outputs.has_key == 'true'
       run: |
         pip install --upgrade pip
+        cd src/praisonai-agents
+        pip install -e ".[all]"
+        cd ../praisonai
+        pip install -e ".[openai]"
         pip install pytest pytest-asyncio pytest-timeout
-    - uses: ./.github/actions/install-monorepo-packages
-      if: steps.check-key.outputs.has_key == 'true'
-      with:
-        agents-extras: ".[all]"
-        wrapper-extras: ".[openai]"
     
     - name: Run OpenAI Live Tests
       if: steps.check-key.outputs.has_key == 'true'
@@ -480,8 +247,6 @@ jobs:
         fi
     
     - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
       if: steps.check-key.outputs.has_key == 'true'
     
     - name: Set up Python 3.11
@@ -494,12 +259,11 @@ jobs:
       if: steps.check-key.outputs.has_key == 'true'
       run: |
         pip install --upgrade pip
+        cd src/praisonai-agents
+        pip install -e ".[all]"
+        cd ../praisonai
+        pip install -e ".[anthropic]"
         pip install pytest pytest-asyncio pytest-timeout
-    - uses: ./.github/actions/install-monorepo-packages
-      if: steps.check-key.outputs.has_key == 'true'
-      with:
-        agents-extras: ".[all]"
-        wrapper-extras: ".[anthropic]"
     
     - name: Run Anthropic Tests
       if: steps.check-key.outputs.has_key == 'true'
@@ -529,10 +293,8 @@ jobs:
     steps:
     - name: Check if Google key is available
       id: check-key
-      env:
-        GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
       run: |
-        if [ -n "$GOOGLE_API_KEY" ]; then
+        if [ -n "${{ secrets.GOOGLE_API_KEY }}" ]; then
           echo "has_key=true" >> $GITHUB_OUTPUT
         else
           echo "has_key=false" >> $GITHUB_OUTPUT
@@ -540,8 +302,6 @@ jobs:
         fi
     
     - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
       if: steps.check-key.outputs.has_key == 'true'
     
     - name: Set up Python 3.11
@@ -554,12 +314,11 @@ jobs:
       if: steps.check-key.outputs.has_key == 'true'
       run: |
         pip install --upgrade pip
+        cd src/praisonai-agents
+        pip install -e ".[all]"
+        cd ../praisonai
+        pip install -e ".[google]"
         pip install pytest pytest-asyncio pytest-timeout
-    - uses: ./.github/actions/install-monorepo-packages
-      if: steps.check-key.outputs.has_key == 'true'
-      with:
-        agents-extras: ".[all]"
-        wrapper-extras: ".[google]"
     
     - name: Run Google/Gemini Tests
       if: steps.check-key.outputs.has_key == 'true'
@@ -589,10 +348,8 @@ jobs:
     steps:
     - name: Check if Groq key is available
       id: check-key
-      env:
-        GROQ_API_KEY: ${{ secrets.GROQ_API_KEY }}
       run: |
-        if [ -n "$GROQ_API_KEY" ]; then
+        if [ -n "${{ secrets.GROQ_API_KEY }}" ]; then
           echo "has_key=true" >> $GITHUB_OUTPUT
         else
           echo "has_key=false" >> $GITHUB_OUTPUT
@@ -600,8 +357,6 @@ jobs:
         fi
     
     - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
       if: steps.check-key.outputs.has_key == 'true'
     
     - name: Set up Python 3.11
@@ -614,11 +369,11 @@ jobs:
       if: steps.check-key.outputs.has_key == 'true'
       run: |
         pip install --upgrade pip
+        cd src/praisonai-agents
+        pip install -e ".[all]"
+        cd ../praisonai
+        pip install -e .
         pip install pytest pytest-asyncio pytest-timeout
-    - uses: ./.github/actions/install-monorepo-packages
-      if: steps.check-key.outputs.has_key == 'true'
-      with:
-        agents-extras: ".[all]"
     
     - name: Run Groq Tests
       if: steps.check-key.outputs.has_key == 'true'
@@ -648,10 +403,8 @@ jobs:
     steps:
     - name: Check if xAI key is available
       id: check-key
-      env:
-        XAI_API_KEY: ${{ secrets.XAI_API_KEY }}
       run: |
-        if [ -n "$XAI_API_KEY" ]; then
+        if [ -n "${{ secrets.XAI_API_KEY }}" ]; then
           echo "has_key=true" >> $GITHUB_OUTPUT
         else
           echo "has_key=false" >> $GITHUB_OUTPUT
@@ -659,8 +412,6 @@ jobs:
         fi
     
     - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
       if: steps.check-key.outputs.has_key == 'true'
     
     - name: Set up Python 3.11
@@ -673,11 +424,11 @@ jobs:
       if: steps.check-key.outputs.has_key == 'true'
       run: |
         pip install --upgrade pip
+        cd src/praisonai-agents
+        pip install -e ".[all]"
+        cd ../praisonai
+        pip install -e .
         pip install pytest pytest-asyncio pytest-timeout
-    - uses: ./.github/actions/install-monorepo-packages
-      if: steps.check-key.outputs.has_key == 'true'
-      with:
-        agents-extras: ".[all]"
     
     - name: Run xAI/Grok Tests
       if: steps.check-key.outputs.has_key == 'true'
@@ -707,10 +458,8 @@ jobs:
     steps:
     - name: Check if Cohere key is available
       id: check-key
-      env:
-        COHERE_API_KEY: ${{ secrets.COHERE_API_KEY }}
       run: |
-        if [ -n "$COHERE_API_KEY" ]; then
+        if [ -n "${{ secrets.COHERE_API_KEY }}" ]; then
           echo "has_key=true" >> $GITHUB_OUTPUT
         else
           echo "has_key=false" >> $GITHUB_OUTPUT
@@ -718,8 +467,6 @@ jobs:
         fi
     
     - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
       if: steps.check-key.outputs.has_key == 'true'
     
     - name: Set up Python 3.11
@@ -732,12 +479,11 @@ jobs:
       if: steps.check-key.outputs.has_key == 'true'
       run: |
         pip install --upgrade pip
+        cd src/praisonai-agents
+        pip install -e ".[all]"
+        cd ../praisonai
+        pip install -e ".[cohere]"
         pip install pytest pytest-asyncio pytest-timeout
-    - uses: ./.github/actions/install-monorepo-packages
-      if: steps.check-key.outputs.has_key == 'true'
-      with:
-        agents-extras: ".[all]"
-        wrapper-extras: ".[cohere]"
     
     - name: Run Cohere Tests
       if: steps.check-key.outputs.has_key == 'true'
@@ -759,204 +505,11 @@ jobs:
       if: steps.check-key.outputs.has_key == 'false'
       run: echo "✅ Cohere tests skipped (no API key available)"
 
-  # ============================================
-  # OLLAMA LIVE TESTS - Real local model, no API key
-  # Nightly / extended only. Installs Ollama on the runner and pulls a small
-  # tools-capable model. Unlike the other live jobs this one needs no secret,
-  # so its required step has no "|| echo" fallback: a failure here is a real
-  # regression in local-model tool calling, not a missing credential.
-  # ============================================
-  extended-ollama:
-    if: github.event_name == 'schedule' || github.event.inputs.tier == 'extended' || github.event.inputs.tier == 'nightly'
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    env:
-      # Bump deliberately: this is the version everything in this job was
-      # verified against. Latest at time of writing is v0.33.3.
-      OLLAMA_VERSION: v0.33.2
-      # 522 MB, capabilities: completion, tools, thinking.
-      OLLAMA_TEST_MODEL: qwen3:0.6b
-
-    steps:
-    - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
-
-    - name: Set up Python 3.11
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.11'
-
-    - name: Cache pip packages
-      uses: actions/cache@v4
-      with:
-        path: ~/.cache/pip
-        key: ${{ runner.os }}-pip-ollama-${{ hashFiles('**/pyproject.toml') }}
-        restore-keys: |
-          ${{ runner.os }}-pip-
-
-    - name: Cache Ollama model blobs
-      uses: actions/cache@v4
-      with:
-        path: ~/.ollama/models
-        # No restore-keys on purpose: a partial hit from a different model would
-        # silently test something other than OLLAMA_TEST_MODEL.
-        key: ${{ runner.os }}-ollama-models-${{ env.OLLAMA_TEST_MODEL }}
-
-    - name: Install Ollama
-      shell: bash
-      run: |
-        set -euo pipefail
-        # The official installer, but VERSION-PINNED via OLLAMA_VERSION (which it
-        # honours) so this job cannot silently change what it tests. Fetching the
-        # release asset directly is not a workable alternative: since v0.33 the
-        # linux bundle ships as a 1.4 GB .tar.zst with GPU runtimes bundled in,
-        # and the installer already handles the zst/tgz split across versions.
-        sudo apt-get update -qq && sudo apt-get install -y -qq zstd
-        curl -fsSL https://ollama.com/install.sh | sh
-        ollama --version
-
-    - name: Start Ollama and pull model
-      shell: bash
-      run: |
-        set -euo pipefail
-        ollama serve > /tmp/ollama-serve.log 2>&1 &
-        for i in $(seq 1 30); do
-          if curl -sf http://127.0.0.1:11434/api/tags > /dev/null; then
-            echo "Ollama is up after ${i}s"
-            break
-          fi
-          sleep 1
-        done
-        curl -sf http://127.0.0.1:11434/api/tags > /dev/null
-        ollama pull "$OLLAMA_TEST_MODEL"
-        ollama list
-
-    - name: Install dependencies
-      run: |
-        pip install --upgrade pip
-        pip install pytest pytest-asyncio pytest-timeout
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        agents-extras: ".[all]"
-
-    - name: Run Ollama minimum contract (required)
-      env:
-        PRAISONAI_TEST_TIER: extended
-        PRAISONAI_ALLOW_NETWORK: '1'
-        PRAISONAI_LIVE_TESTS: '1'
-        PRAISONAI_TEST_PROVIDERS: 'ollama'
-        PRAISONAI_TEST_OLLAMA: '1'
-        PRAISONAI_OLLAMA_TEST_MODEL: ${{ env.OLLAMA_TEST_MODEL }}
-      shell: bash
-      run: |
-        set -euo pipefail
-        cd src/praisonai
-        # No "|| echo" here: no secret is involved, so a failure is a real
-        # regression rather than a missing credential.
-        python -m pytest tests/integration/test_ollama_tool_calling_live.py::TestOllamaCIMinimum \
-          -v --tb=short \
-          --timeout=120
-
-    - name: Run remaining Ollama live tests (informational)
-      if: always()
-      env:
-        PRAISONAI_TEST_TIER: extended
-        PRAISONAI_ALLOW_NETWORK: '1'
-        PRAISONAI_LIVE_TESTS: '1'
-        PRAISONAI_TEST_PROVIDERS: 'ollama'
-        PRAISONAI_TEST_OLLAMA: '1'
-        PRAISONAI_OLLAMA_TEST_MODEL: ${{ env.OLLAMA_TEST_MODEL }}
-      run: |
-        cd src/praisonai
-        python -m pytest tests/integration/test_ollama_tool_calling_live.py \
-          --deselect tests/integration/test_ollama_tool_calling_live.py::TestOllamaCIMinimum \
-          -v --tb=short \
-          --timeout=180 \
-          || echo "Ollama exploratory tests completed (small models are non-deterministic)"
-
-    - name: Ollama server log
-      if: failure()
-      run: tail -100 /tmp/ollama-serve.log
-
-  # ============================================
-  # LEGACY UNIT TESTS - Post-C6 re-enabled suite
-  # Nightly / extended tier only (~401 tests)
-  # ============================================
-  legacy-unit:
-    if: github.event_name == 'schedule' || github.event.inputs.tier == 'extended' || github.event.inputs.tier == 'nightly'
-    runs-on: ubuntu-latest
-    timeout-minutes: 20
-
-    steps:
-    - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
-
-    - name: Set up Python 3.11
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.11'
-
-    - name: Install dependencies
-      run: |
-        pip install --upgrade pip
-        pip install pytest pytest-asyncio pytest-timeout
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        agents-extras: ".[all]"
-        wrapper-extras: ".[chat,code,crewai,autogen]"
-
-    - name: Run post-C6 legacy unit tests
-      env:
-        PRAISONAI_TEST_TIER: extended
-        PRAISONAI_ALLOW_NETWORK: '0'
-        PRAISONAI_ALLOW_JOB_WORKFLOWS: 'true'
-        PRAISONAI_TOOL_SAFETY: 'off'
-        OPENAI_API_KEY: 'test-key'
-      run: |
-        set -euo pipefail
-        cd src/praisonai
-        LEGACY_FILES=(
-          tests/unit/test_warm_runtime.py
-          tests/unit/test_yaml_cli_backend.py
-          tests/unit/test_tool_resolver.py
-          tests/unit/test_serve_unified.py
-          tests/unit/test_security_fixes_core.py
-          tests/unit/test_query_rewriter_cli.py
-          tests/unit/test_kanban_sqlite_store.py
-          tests/unit/test_job_workflow_agent_steps.py
-          tests/unit/test_hybrid_workflow.py
-          ../praisonai-bot/tests/unit/test_gateway_session.py
-          ../praisonai-bot/tests/unit/test_gateway_gaps.py
-          tests/unit/test_discord_approval.py
-          tests/unit/test_decorator_simple.py
-          tests/unit/test_db_adapter_tracing_init.py
-          ../praisonai-bot/tests/unit/test_bot_wiring.py
-          ../praisonai-bot/tests/unit/bots/test_enable_shell.py
-          ../praisonai-bot/tests/unit/gateway/test_preflight.py
-          ../praisonai-bot/tests/unit/gateway/test_gateway_doctor.py
-          ../praisonai-bot/tests/unit/test_bot_history.py
-          ../praisonai-bot/tests/unit/test_bot_fixes.py
-          tests/unit/test_auto_lazy_loading.py
-          tests/unit/test_async_daemon_deployment.py
-          tests/unit/test_approval_interactive.py
-          tests/unit/test_approval_agent_integration.py
-          tests/unit/test_agents_yaml_validation.py
-          tests/unit/test_agent_os_wrapper.py
-          tests/unit/test_lazy_imports.py
-          tests/unit/test_profiler.py
-          tests/unit/test_profiler_advanced.py
-          tests/unit/test_serverless_postgres.py
-        )
-        python -m pytest "${LEGACY_FILES[@]}" \
-          -q --tb=line --timeout=120 --maxfail=10
-
   # ============================================
   # TEST SUMMARY
   # ============================================
   test-summary:
-    needs: [smoke, main, extended-ollama]
+    needs: [smoke, main]
     if: always()
     runs-on: ubuntu-latest
     

.github/workflows/test-real.yml

@@ -34,19 +34,14 @@ jobs:
     
     steps:
     - name: 🚨 Cost Warning
-      env:
-        INPUT_FRAMEWORK: ${{ github.event.inputs.framework }}
-        INPUT_CONFIRM_COSTS: ${{ github.event.inputs.confirm_costs }}
       run: |
         echo "⚠️  WARNING: This workflow will make real API calls!"
         echo "💰 This may incur charges on your API accounts"
-        echo "🎯 Framework: $INPUT_FRAMEWORK"
-        echo "✅ Cost confirmation: $INPUT_CONFIRM_COSTS"
+        echo "🎯 Framework: ${{ github.event.inputs.framework }}"
+        echo "✅ Cost confirmation: ${{ github.event.inputs.confirm_costs }}"
         
     - name: Checkout code
       uses: actions/checkout@v4
-      with:
-        persist-credentials: false
 
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v5
@@ -61,12 +56,11 @@ jobs:
 
     - name: Install dependencies
       run: |
+        cd src/praisonai
+        uv pip install --system ."[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
         uv pip install --system pytest pytest-asyncio pytest-cov
+        # Install knowledge dependencies from praisonai-agents
         uv pip install --system "praisonaiagents[knowledge]"
-    - uses: ./.github/actions/install-monorepo-packages
-      with:
-        use-uv: "true"
-        wrapper-extras: ".[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
 
     - name: Set environment variables
       run: |
@@ -99,23 +93,21 @@ jobs:
 
     - name: Generate Real Test Report
       if: always()
-      env:
-        INPUT_FRAMEWORK: ${{ github.event.inputs.framework }}
       run: |
         echo "# 🔥 Real End-to-End Test Report" > real_test_report.md
         echo "" >> real_test_report.md
         echo "⚠️  **WARNING: This report represents tests that made real API calls**" >> real_test_report.md
         echo "" >> real_test_report.md
-        echo "**Framework Tested:** $INPUT_FRAMEWORK" >> real_test_report.md
+        echo "**Framework Tested:** ${{ github.event.inputs.framework }}" >> real_test_report.md
         echo "**Python Version:** ${{ matrix.python-version }}" >> real_test_report.md
         echo "**Date:** $(date -u)" >> real_test_report.md
-        echo "**Triggered by:** $GITHUB_ACTOR" >> real_test_report.md
+        echo "**Triggered by:** ${{ github.actor }}" >> real_test_report.md
         echo "" >> real_test_report.md
         
         echo "## 🧪 Test Results" >> real_test_report.md
         echo "" >> real_test_report.md
         
-        if [ "$INPUT_FRAMEWORK" == "autogen" ] || [ "$INPUT_FRAMEWORK" == "all" ]; then
+        if [ "${{ github.event.inputs.framework }}" == "autogen" ] || [ "${{ github.event.inputs.framework }}" == "all" ]; then
           echo "### AutoGen Real Tests:" >> real_test_report.md
           echo "- Environment verification" >> real_test_report.md
           echo "- Agent creation with real API calls" >> real_test_report.md
@@ -123,7 +115,7 @@ jobs:
           echo "" >> real_test_report.md
         fi
         
-        if [ "$INPUT_FRAMEWORK" == "crewai" ] || [ "$INPUT_FRAMEWORK" == "all" ]; then
+        if [ "${{ github.event.inputs.framework }}" == "crewai" ] || [ "${{ github.event.inputs.framework }}" == "all" ]; then
           echo "### CrewAI Real Tests:" >> real_test_report.md
           echo "- Environment verification" >> real_test_report.md
           echo "- Crew creation with real API calls" >> real_test_report.md
@@ -158,14 +150,11 @@ jobs:
     
     steps:
     - name: 🛡️ Safety Check Failed
-      env:
-        INPUT_FRAMEWORK: ${{ github.event.inputs.framework }}
-        INPUT_CONFIRM_COSTS: ${{ github.event.inputs.confirm_costs }}
       run: |
         echo "🚨 Real tests not executed due to safety checks:"
         echo ""
-        echo "✅ Costs confirmed: $INPUT_CONFIRM_COSTS"
-        echo "✅ Framework selected: $INPUT_FRAMEWORK"
+        echo "✅ Costs confirmed: ${{ github.event.inputs.confirm_costs }}"
+        echo "✅ Framework selected: ${{ github.event.inputs.framework }}"
         echo ""
         echo "To run real tests:"
         echo "1. Select a framework (autogen, crewai, or all)"

.github/workflows/test-windows.yml

@@ -3,49 +3,45 @@ name: Windows Tests
 on:
   push:
     branches: [main, develop]
-    paths:
-      - 'src/**'
-      - 'pyproject.toml'
-      - '.github/workflows/test-windows.yml'
-      - '.github/actions/install-monorepo-packages/**'
   pull_request:
     branches: [main, develop]
-    paths:
-      - 'src/**'
-      - 'pyproject.toml'
-      - '.github/workflows/test-windows.yml'
-      - '.github/actions/install-monorepo-packages/**'
   workflow_dispatch:
 
 jobs:
   test-windows:
     runs-on: windows-latest
-    timeout-minutes: 10
+    timeout-minutes: 5
     env:
       OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
       OPENAI_MODEL_NAME: gpt-4o-mini
-      PYTHONUTF8: 1
     
     steps:
     - uses: actions/checkout@v4
-      with:
-        persist-credentials: false
+    
     - name: Set up Python 3.11
       uses: actions/setup-python@v5
       with:
         python-version: "3.11"
     
-    - name: Install monorepo packages
-      run: python -m pip install --upgrade pip
+    - name: Install praisonaiagents
+      run: |
+        python -m pip install --upgrade pip
+        cd src/praisonai-agents
+        pip install .
+      shell: bash
+    
+    - name: Install praisonai wrapper
+      run: |
+        cd src/praisonai
+        pip install .[dev]
       shell: bash
-    - uses: ./.github/actions/install-monorepo-packages
 
     # ==================== CORE IMPORTS ====================
     - name: Test core imports
       run: |
         python -c "from praisonaiagents import Agent, Agents, Workflow; print('Core imports OK')"
         python -c "from praisonaiagents import tool, Tools; print('Tool imports OK')"
-        python -c "from praisonaiagents import Task; print('Task imports OK')"
+        python -c "from praisonaiagents import Task, WorkflowStep; print('Task/Step imports OK')"
 
     # ==================== AGENT FEATURES ====================
     - name: Test Agent instantiation
@@ -70,13 +66,21 @@ jobs:
         "
 
     # ==================== WORKFLOW FEATURES ====================
-    - name: Test Workflow
+    - name: Test Workflow and WorkflowStep
       run: |
         python -c "
-        from praisonaiagents import Workflow
+        from praisonaiagents import Workflow, WorkflowStep
+        from praisonaiagents.workflows import WorkflowOutputConfig
         
         w = Workflow(name='test')
+        s1 = WorkflowStep(name='step1')
+        s2 = WorkflowStep(name='step2', context=['step1'])
         print('Workflow:', w.name)
+        print('Steps:', s1.name, s2.name)
+        
+        cfg = WorkflowOutputConfig(verbose=True, stream=False)
+        w2 = Workflow(name='configured', output=cfg)
+        print('Configured workflow verbose:', w2.verbose)
         "
 
     # ==================== MEMORY FEATURES ====================
@@ -170,19 +174,6 @@ jobs:
       run: praisonai queue list
       continue-on-error: true
 
-    # ==================== PACKAGING TESTS ====================
-    - name: Test packaging/daemon entry points
-      run: |
-        echo "Testing both entry point methods..."
-        python -m praisonai --version
-        praisonai --version
-        praisonai-bot gateway --help
-
-    - name: Test doctor packaging command
-      run: |
-        echo "Testing doctor packaging diagnostics..."
-        praisonai doctor packaging --json
-
     # ==================== REAL API TESTS ====================
     - name: Real API test - Agent run
       if: env.OPENAI_API_KEY != ''

.github/workflows/unittest.yml

@@ -0,0 +1,516 @@
+name: Quick Validation Tests
+
+on: [push, pull_request]
+
+jobs:
+  quick-test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: 3.11
+
+    - name: Install UV
+      run: |
+        curl -LsSf https://astral.sh/uv/install.sh | sh
+        echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+
+    - name: Install dependencies
+      run: |
+        cd src/praisonai
+        uv pip install --system ."[ui,gradio,api,agentops,google,openai,anthropic,cohere,chat,code,realtime,call,crewai,autogen]"
+        uv pip install --system duckduckgo_search
+        uv pip install --system pytest pytest-asyncio pytest-cov pytest-timeout
+        # Install knowledge dependencies from praisonai-agents
+        uv pip install --system "praisonaiagents[knowledge]"
+
+    - name: Set environment variables
+      run: |
+        echo "OPENAI_API_KEY=${{ secrets.OPENAI_API_KEY || 'sk-test-key-for-github-actions-testing-only-not-real' }}" >> $GITHUB_ENV
+        echo "OPENAI_API_BASE=${{ secrets.OPENAI_API_BASE || 'https://api.openai.com/v1' }}" >> $GITHUB_ENV
+        echo "OPENAI_MODEL_NAME=${{ secrets.OPENAI_MODEL_NAME || 'gpt-5-nano' }}" >> $GITHUB_ENV
+        echo "LOGLEVEL=DEBUG" >> $GITHUB_ENV
+        echo "PYTHONPATH=${{ github.workspace }}/src/praisonai-agents:$PYTHONPATH" >> $GITHUB_ENV
+
+    - name: Backup Root Config Files
+      run: |
+        echo "🔄 Backing up root configuration files to prevent default file resolution interference..."
+        echo "ℹ️  PraisonAI automatically uses 'agents.yaml' in working directory when no file specified"
+        echo "ℹ️  This can interfere with test files that specify their own YAML files"
+        if [ -f "agents.yaml" ]; then
+          mv agents.yaml agents.yaml.backup
+          echo "✅ Moved root agents.yaml to agents.yaml.backup"
+          echo "   - This prevents default file fallback during tests"
+        fi
+        if [ -f "tools.py" ]; then
+          mv tools.py tools.py.backup  
+          echo "✅ Moved tools.py to tools.py.backup"
+        fi
+
+    - name: Debug API Key Status
+      run: |
+        echo "🔍 Checking API key availability..."
+        if [ -n "${{ secrets.OPENAI_API_KEY }}" ]; then
+          echo "✅ GitHub secret OPENAI_API_KEY is available"
+          echo "🔑 API key starts with: $(echo "$OPENAI_API_KEY" | cut -c1-7)..."
+        else
+          echo "⚠️ GitHub secret OPENAI_API_KEY is NOT set - using fallback"
+          echo "🔑 Using fallback key: sk-test-key..."
+        fi
+        echo "🌐 API Base: $OPENAI_API_BASE"
+        echo "🤖 Model: $OPENAI_MODEL_NAME"
+        echo "🐛 Log Level: $LOGLEVEL"
+        echo "📊 Environment Check:"
+        echo "  - OPENAI_API_KEY length: ${#OPENAI_API_KEY}"
+        echo "  - OPENAI_API_BASE: $OPENAI_API_BASE"
+        echo "  - OPENAI_MODEL_NAME: $OPENAI_MODEL_NAME"
+        echo "  - LOGLEVEL: $LOGLEVEL"
+
+    - name: Debug Python Environment Variables
+      run: |
+        python -c "
+        import os
+        print('🐍 Python Environment Variable Check:')
+        api_key = os.environ.get('OPENAI_API_KEY', 'NOT_SET')
+        if api_key != 'NOT_SET':
+            print(f'  ✅ OPENAI_API_KEY: {api_key[:7]}... (length: {len(api_key)})')
+        else:
+            print('  ❌ OPENAI_API_KEY: NOT_SET')
+        print(f'  🌐 OPENAI_API_BASE: {os.environ.get(\"OPENAI_API_BASE\", \"NOT_SET\")}')
+        print(f'  🤖 OPENAI_MODEL_NAME: {os.environ.get(\"OPENAI_MODEL_NAME\", \"NOT_SET\")}')
+        print(f'  📋 All OPENAI env vars:')
+        for key, value in os.environ.items():
+            if key.startswith('OPENAI'):
+                print(f'    {key}: {value[:10] if len(value) > 10 else value}...')
+        "
+
+    - name: Find Researcher Role Source
+      run: |
+        echo "🔍 Hunting for the mysterious 'Researcher' role..."
+        cd src/praisonai
+        python -c "
+        import os
+        import yaml
+        import glob
+        
+        print('📋 Searching for Researcher role in all YAML files:')
+        yaml_files = glob.glob('src/praisonai/tests/*.yaml')
+        
+        for yaml_file in yaml_files:
+            try:
+                with open(yaml_file, 'r') as f:
+                    config = yaml.safe_load(f)
+                
+                # Check if any role contains 'researcher'
+                roles = config.get('roles', {})
+                for role_key, role_data in roles.items():
+                    role_name = role_data.get('role', '')
+                    if 'researcher' in role_key.lower() or 'researcher' in role_name.lower():
+                        print(f'  🎯 FOUND in {yaml_file}:')
+                        print(f'    Framework: {config.get(\"framework\", \"NOT_SET\")}')
+                        print(f'    Role key: {role_key}')
+                        print(f'    Role name: {role_name}')
+                        print(f'    All roles: {list(roles.keys())}')
+                        print()
+            except Exception as e:
+                print(f'  ❌ Error reading {yaml_file}: {e}')
+        
+        print('🔍 Checking for default configurations...')
+        # Check if there are any default configs or hardcoded roles
+        try:
+            import praisonai
+            print(f'  PraisonAI package location: {praisonai.__file__}')
+            
+            # Check if there are any example YAML files in the package
+            package_dir = os.path.dirname(praisonai.__file__)
+            for root, dirs, files in os.walk(package_dir):
+                for file in files:
+                    if file.endswith(('.yaml', '.yml')):
+                        file_path = os.path.join(root, file)
+                        print(f'  📁 Found YAML in package: {file_path}')
+        except Exception as e:
+            print(f'  ❌ Error checking package: {e}')
+        "
+      continue-on-error: true
+
+    - name: Trace AutoGen Execution Path
+      run: |
+        echo "🔍 Tracing AutoGen execution to find where it diverges..."
+        cd src/praisonai
+        python -c "
+        import os
+        import sys
+        sys.path.insert(0, '.')
+        
+        try:
+            from praisonai import PraisonAI
+            from praisonai.agents_generator import AgentsGenerator
+            
+            # Test the exact execution path
+            print('🎯 Testing AutoGen execution path:')
+            
+            praisonai = PraisonAI(agent_file='tests/autogen-agents.yaml')
+            print(f'  1. PraisonAI framework: \"{praisonai.framework}\"')
+            
+            agents_gen = AgentsGenerator(
+                agent_file='tests/autogen-agents.yaml',
+                framework=praisonai.framework,
+                config_list=praisonai.config_list
+            )
+            print(f'  2. AgentsGenerator framework: \"{agents_gen.framework}\"')
+            
+            # Load the YAML to check what it contains
+            import yaml
+            with open('src/praisonai/tests/autogen-agents.yaml', 'r') as f:
+                config = yaml.safe_load(f)
+            
+            framework = agents_gen.framework or config.get('framework')
+            print(f'  3. Final framework decision: \"{framework}\"')
+            print(f'  4. Available frameworks:')
+            
+            # Check framework availability
+            try:
+                import autogen
+                print(f'    ✅ AutoGen available')
+            except ImportError:
+                print(f'    ❌ AutoGen NOT available')
+                
+            try:
+                from praisonaiagents import Agent
+                print(f'    ✅ PraisonAI agents available')
+            except ImportError:
+                print(f'    ❌ PraisonAI agents NOT available')
+                
+            try:
+                from crewai import Agent
+                print(f'    ✅ CrewAI available')
+            except ImportError:
+                print(f'    ❌ CrewAI NOT available')
+            
+            print(f'  5. Roles in YAML: {list(config.get(\"roles\", {}).keys())}')
+            
+            # Now test the actual framework execution
+            if framework == 'autogen':
+                print(f'  6. ✅ Should execute _run_autogen')
+            elif framework == 'praisonai':
+                print(f'  6. ❌ Would execute _run_praisonai (WRONG!)')
+            else:
+                print(f'  6. ❌ Would execute _run_crewai (DEFAULT FALLBACK)')
+                
+        except Exception as e:
+            print(f'❌ Error tracing execution: {e}')
+            import traceback
+            traceback.print_exc()
+        "
+      continue-on-error: true
+
+    - name: Debug YAML Loading and Roles
+      run: |
+        echo "🔍 Tracing YAML file loading and role creation..."
+        cd src/praisonai
+        python -c "
+        import os
+        import sys
+        import yaml
+        sys.path.insert(0, '.')
+        
+        print('📁 Available YAML files in src/praisonai/tests/:')
+        import glob
+        yaml_files = glob.glob('tests/*.yaml')
+        for f in yaml_files:
+            print(f'  {f}')
+        
+        print()
+        print('📋 Content of autogen-agents.yaml:')
+        with open('tests/autogen-agents.yaml', 'r') as f:
+            config = yaml.safe_load(f)
+        print(f'  Framework: {config.get(\"framework\")}')
+        print(f'  Topic: {config.get(\"topic\")}')
+        print(f'  Roles: {list(config.get(\"roles\", {}).keys())}')
+        for role_key, role_data in config.get('roles', {}).items():
+            print(f'    {role_key} -> {role_data.get(\"role\", \"NO_ROLE\")}')
+        
+        print()
+        print('🔍 Checking if execution uses a different YAML:')
+        
+        # Check other YAML files for 'Researcher' role
+        for yaml_file in yaml_files:
+            try:
+                with open(yaml_file, 'r') as f:
+                    test_config = yaml.safe_load(f)
+                roles = test_config.get('roles', {})
+                for role_key, role_data in roles.items():
+                    if 'researcher' in role_key.lower() or 'researcher' in role_data.get('role', '').lower():
+                        print(f'  🎯 FOUND Researcher in {yaml_file}!')
+                        print(f'    Framework: {test_config.get(\"framework\")}')
+                        print(f'    Role key: {role_key} -> {role_data.get(\"role\")}')
+            except:
+                pass
+        "
+      continue-on-error: true
+
+    - name: Debug Framework Detection
+      run: |
+        echo "🔍 Testing framework detection and config flow..."
+        python -c "
+        import os
+        import sys
+        import yaml
+        sys.path.insert(0, '.')
+        
+        print('🔧 Testing framework detection:')
+        
+        # Load the YAML file
+        with open('tests/autogen-agents.yaml', 'r') as f:
+            config = yaml.safe_load(f)
+            
+        print(f'  📋 YAML framework: {config.get(\"framework\", \"NOT_SET\")}')
+        print(f'  📋 YAML topic: {config.get(\"topic\", \"NOT_SET\")}')
+        
+        try:
+            from praisonai import PraisonAI
+            from praisonai.agents_generator import AgentsGenerator
+            
+            # Test PraisonAI initialization
+            praisonai = PraisonAI(agent_file='tests/autogen-agents.yaml')
+            print(f'  🎯 PraisonAI framework: {praisonai.framework}')
+            
+            # Test AgentsGenerator initialization
+            agents_gen = AgentsGenerator(
+                agent_file='tests/autogen-agents.yaml',
+                framework=praisonai.framework,
+                config_list=praisonai.config_list
+            )
+            print(f'  ⚙️ AgentsGenerator framework: {agents_gen.framework}')
+            print(f'  ⚙️ Final framework decision: {agents_gen.framework or config.get(\"framework\")}')
+            
+            # Check config_list
+            print(f'  🔑 Config list model: {praisonai.config_list[0].get(\"model\")}')
+            print(f'  🔑 Config list API key: {praisonai.config_list[0].get(\"api_key\", \"NOT_SET\")[:10]}...')
+            
+        except Exception as e:
+            print(f'❌ Error in framework detection: {e}')
+        "
+      continue-on-error: true
+
+    - name: Debug PraisonAIModel API Key Flow
+      run: |
+        echo "🔍 Testing PraisonAIModel API key handling..."
+        cd src/praisonai
+        python -c "
+        import os
+        import sys
+        sys.path.insert(0, '.')
+        
+        print('🔑 Environment API Key Check:')
+        env_key = os.environ.get('OPENAI_API_KEY', 'NOT_FOUND')
+        print(f'  OPENAI_API_KEY: {env_key[:10] if env_key != \"NOT_FOUND\" else \"NOT_FOUND\"}...')
+        
+        try:
+            from praisonai.inc.models import PraisonAIModel
+            
+            # Test PraisonAIModel with openai/gpt-5-nano (from YAML)
+            model = PraisonAIModel(model='openai/gpt-5-nano')
+            
+            print('🤖 PraisonAIModel Configuration:')
+            print(f'  model: {model.model}')
+            print(f'  model_name: {model.model_name}')
+            print(f'  api_key_var: {model.api_key_var}')
+            print(f'  api_key: {model.api_key[:10] if model.api_key != \"nokey\" else \"DEFAULT_NOKEY\"}...')
+            print(f'  base_url: {model.base_url}')
+            
+            if model.api_key == 'nokey':
+                print('❌ FOUND THE ISSUE: PraisonAIModel is using default \"nokey\" instead of environment variable!')
+            else:
+                print('✅ PraisonAIModel has valid API key from environment')
+                
+        except Exception as e:
+            print(f'❌ Error testing PraisonAIModel: {e}')
+        "
+      continue-on-error: true
+
+    - name: Validate API Key
+      run: |
+        echo "🔑 Testing API key validity with minimal OpenAI call..."
+        python -c "
+        import os
+        try:
+            from openai import OpenAI
+            client = OpenAI(api_key=os.environ.get('OPENAI_API_KEY'))
+            # Make a minimal API call to test key validity
+            response = client.models.list()
+            print('✅ API Key is VALID - OpenAI responded successfully')
+            print(f'📊 Available models: {len(list(response.data))} models found')
+        except Exception as e:
+            print(f'❌ API Key is INVALID - Error: {e}')
+            print('🔍 This explains why all API-dependent tests are failing')
+            print('💡 The GitHub secret OPENAI_API_KEY needs to be updated with a valid key')
+        "
+      continue-on-error: true
+
+    - name: Test Direct PraisonAI Execution
+      run: |
+        echo "🧪 Testing direct PraisonAI execution (what works locally)..."
+        python -m praisonai src/praisonai/tests/autogen-agents.yaml
+      continue-on-error: true
+
+    - name: Comprehensive Execution Debug
+      run: |
+        echo "🔍 Comprehensive debugging of PraisonAI execution path..."
+        cd src/praisonai
+        python -c "
+        import os
+        import sys
+        import yaml
+        sys.path.insert(0, '.')
+        
+        print('=' * 60)
+        print('🔍 COMPREHENSIVE EXECUTION DEBUG')
+        print('=' * 60)
+        
+        # Check current working directory
+        print(f'📁 Current working directory: {os.getcwd()}')
+        
+        # List files in current directory
+        print('📋 Files in current directory:')
+        for f in os.listdir('.'):
+            print(f'  {f}')
+        
+        print()
+        print('📋 Files in src/praisonai/tests/ directory:')
+        for f in os.listdir('tests'):
+            if f.endswith('.yaml'):
+                print(f'  src/praisonai/tests/{f}')
+        
+        # Check if root agents.yaml exists
+        print()
+        if os.path.exists('agents.yaml'):
+            print('❌ ROOT agents.yaml EXISTS (this is the problem!)')
+            with open('agents.yaml', 'r') as f:
+                root_config = yaml.safe_load(f)
+            print(f'  Root framework: {root_config.get(\"framework\")}')
+            print(f'  Root roles: {list(root_config.get(\"roles\", {}).keys())}')
+        else:
+            print('✅ ROOT agents.yaml does NOT exist (good!)')
+            
+        # Test the actual execution path
+        print()
+        print('🎯 Testing EXACT execution path:')
+        
+        try:
+            from praisonai import PraisonAI
+            from praisonai.agents_generator import AgentsGenerator
+            
+            # Test with full path
+            test_file = 'src/praisonai/tests/autogen-agents.yaml'
+            print(f'  Using test file: {test_file}')
+            print(f'  File exists: {os.path.exists(test_file)}')
+            
+            # Load the test file directly
+            with open(test_file, 'r') as f:
+                test_config = yaml.safe_load(f)
+            print(f'  Test file framework: {test_config.get(\"framework\")}')
+            print(f'  Test file roles: {list(test_config.get(\"roles\", {}).keys())}')
+            
+            # Create PraisonAI instance
+            praisonai = PraisonAI(agent_file=test_file)
+            print(f'  PraisonAI.agent_file: {praisonai.agent_file}')
+            print(f'  PraisonAI.framework: {praisonai.framework}')
+            
+            # Create AgentsGenerator
+            agents_gen = AgentsGenerator(
+                agent_file=test_file,
+                framework=praisonai.framework,
+                config_list=praisonai.config_list
+            )
+            print(f'  AgentsGenerator.agent_file: {agents_gen.agent_file}')
+            print(f'  AgentsGenerator.framework: {agents_gen.framework}')
+            
+            # Test what would happen in generate_crew_and_kickoff
+            print()
+            print('🔧 Testing generate_crew_and_kickoff logic:')
+            
+            # Simulate the loading logic
+            if agents_gen.agent_yaml:
+                loaded_config = yaml.safe_load(agents_gen.agent_yaml)
+                print('  Would load from agent_yaml')
+            else:
+                if agents_gen.agent_file == '/app/api:app' or agents_gen.agent_file == 'api:app':
+                    agents_gen.agent_file = 'agents.yaml'
+                    print(f'  Would change agent_file to: {agents_gen.agent_file}')
+                try:
+                    with open(agents_gen.agent_file, 'r') as f:
+                        loaded_config = yaml.safe_load(f)
+                    print(f'  Successfully loaded: {agents_gen.agent_file}')
+                except FileNotFoundError:
+                    print(f'  FileNotFoundError: {agents_gen.agent_file}')
+                    loaded_config = None
+            
+            if loaded_config:
+                final_framework = agents_gen.framework or loaded_config.get('framework')
+                print(f'  Final framework decision: {final_framework}')
+                print(f'  Loaded roles: {list(loaded_config.get(\"roles\", {}).keys())}')
+                
+                if 'researcher' in loaded_config.get('roles', {}):
+                    print('  ❌ FOUND Researcher role in loaded config!')
+                else:
+                    print('  ✅ No Researcher role in loaded config')
+                    
+        except Exception as e:
+            print(f'❌ Error during execution debug: {e}')
+            import traceback
+            traceback.print_exc()
+        "
+      continue-on-error: true
+
+    - name: Run Fast Tests
+      run: |
+        # Run the fastest, most essential tests with coverage
+        cd src/praisonai && python -m pytest tests/unit/test_core_agents.py -v --tb=short --disable-warnings --cov=praisonai --cov-report=xml --cov-branch
+
+    - name: Run Real API Tests
+      run: |
+        echo "🔑 Running real API tests with actual OpenAI API key..."
+        cd src/praisonai && python -m pytest tests/test_agents_playbook.py -v --tb=short --disable-warnings -m real
+      continue-on-error: true
+
+    - name: Run E2E Real Tests
+      run: |
+        echo "🧪 Running E2E real tests..."
+        cd src/praisonai && python -m pytest tests/e2e/ -v --tb=short --disable-warnings -m real
+      continue-on-error: true
+
+    - name: Run Legacy Example Tests
+      run: |
+        cd src/praisonai && python -m pytest tests/test.py -v --tb=short --disable-warnings -m "not real" --timeout=60
+      continue-on-error: true
+
+    - name: Upload coverage reports to Codecov
+      uses: codecov/codecov-action@v5
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        file: src/praisonai/coverage.xml
+        flags: quick-validation
+        name: quick-validation-coverage
+        fail_ci_if_error: false
+        verbose: true
+
+    - name: Restore Root Config Files
+      run: |
+        echo "🔄 Restoring root configuration files..."
+        if [ -f "agents.yaml.backup" ]; then
+          mv agents.yaml.backup agents.yaml
+          echo "✅ Restored agents.yaml"
+        fi
+        if [ -f "tools.py.backup" ]; then
+          mv tools.py.backup tools.py
+          echo "✅ Restored tools.py"
+        fi
+      if: always()  # Always run this step, even if previous steps failed

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

@@ -52,6 +52,6 @@ jobs:
       with:
         commit_message: "docs: auto-update api.md [skip ci]"
         file_pattern: 'api.md'
-        commit_user_name: "MervinPraison"
-        commit_user_email: "454862+MervinPraison@users.noreply.github.com"
-        commit_author: "MervinPraison <454862+MervinPraison@users.noreply.github.com>"
+        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>"

.github/workflows/update-docs-parity.yml

@@ -1,87 +0,0 @@
-name: Update Documentation Parity Tracker
-
-on:
-  push:
-    branches: [ "main" ]
-    paths:
-      - 'src/praisonai-agents/praisonaiagents/**/*.py'
-      - 'src/praisonai-ts/src/**/*.ts'
-      # The crate lives at src/praisonai-rust/praisonai/src -- the old
-      # 'src/praisonai-rust/src/**' path does not exist, so a Rust change
-      # never triggered either tracker and the Rust numbers only ever
-      # refreshed incidentally, on an unrelated push.
-      - 'src/praisonai-rust/praisonai/src/**/*.rs'
-      - 'src/praisonai/praisonai/_dev/parity/**/*.py'
-      - '.github/workflows/update-docs-parity.yml'
-  workflow_dispatch:  # Allow manual trigger
-
-permissions:
-  contents: write
-
-jobs:
-  update-docs-parity:
-    runs-on: ubuntu-latest
-    
-    steps:
-    - name: Checkout repository
-      uses: actions/checkout@v4
-      with:
-        ref: main
-        persist-credentials: true
-        fetch-depth: 0
-
-    - name: Checkout PraisonAIDocs
-      id: checkout_docs
-      continue-on-error: true
-      uses: actions/checkout@v4
-      with:
-        repository: MervinPraison/PraisonAIDocs
-        path: PraisonAIDocs
-        token: ${{ secrets.SECRETS_ADMIN_PAT }}
-
-    - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.11'
-
-    - name: Install dependencies
-      run: |
-        pip install pyyaml
-
-    - name: Generate docs parity trackers
-      if: steps.checkout_docs.outcome == 'success'
-      run: |
-        cd $GITHUB_WORKSPACE
-        python3 src/praisonai/scripts/generate_docs_parity.py --docs-root PraisonAIDocs/docs --copy-docs
-        
-    - name: Check for changes
-      id: check_changes
-      run: |
-        if git diff --quiet src/praisonai-agents/DOCS_PARITY.md src/praisonai-ts/DOCS_PARITY.md src/praisonai-rust/DOCS_PARITY.md 2>/dev/null; then
-          echo "changes=false" >> $GITHUB_OUTPUT
-          echo "No changes to docs parity trackers"
-        else
-          echo "changes=true" >> $GITHUB_OUTPUT
-          echo "Docs parity trackers have been updated"
-          git diff --stat src/praisonai-agents/DOCS_PARITY.md src/praisonai-ts/DOCS_PARITY.md src/praisonai-rust/DOCS_PARITY.md
-        fi
-
-    - name: Commit and push changes to praisonai-package
-      if: steps.check_changes.outputs.changes == 'true'
-      uses: stefanzweifel/git-auto-commit-action@v5
-      with:
-        commit_message: "docs: auto-update documentation parity trackers [skip ci]"
-        file_pattern: 'src/praisonai-agents/DOCS_PARITY.md src/praisonai-ts/DOCS_PARITY.md src/praisonai-rust/DOCS_PARITY.md'
-        commit_user_name: "MervinPraison"
-        commit_user_email: "[email protected]"
-        commit_author: "MervinPraison <[email protected]>"
-
-    - name: Commit and push changes to PraisonAIDocs
-      if: steps.check_changes.outputs.changes == 'true' && steps.checkout_docs.outcome == 'success'
-      run: |
-        cd PraisonAIDocs
-        git config user.name "MervinPraison"
-        git config user.email "[email protected]"
-        git add docs/features/DOCS_PARITY.md docs/js/DOCS_PARITY.md docs/rust/DOCS_PARITY.md
-        git diff --staged --quiet || git commit -m "docs: auto-update documentation parity trackers [skip ci]"
-        git push

.github/workflows/update-parity-tracker.yml

@@ -1,104 +0,0 @@
-name: Update Feature Parity Tracker
-
-# Regenerates the exported-name parity trackers on push to main and commits them.
-# Validation on pull requests (fail on drift) lives in parity-gate.yml.
-
-on:
-  push:
-    branches: [ "main" ]
-    paths:
-      - 'src/praisonai-agents/praisonaiagents/**/*.py'
-      - 'src/praisonai-ts/src/**/*.ts'
-      # The crate lives at src/praisonai-rust/praisonai/src -- the old
-      # 'src/praisonai-rust/src/**' path does not exist, so a Rust change
-      # never triggered either tracker and the Rust numbers only ever
-      # refreshed incidentally, on an unrelated push.
-      - 'src/praisonai-rust/praisonai/src/**/*.rs'
-      # The generator's own code and the wrapper features it counts. Change
-      # either and nothing regenerated until an unrelated push landed.
-      - 'src/praisonai/praisonai/_dev/parity/**/*.py'
-      - 'src/praisonai/praisonai/cli/features/**/*.py'
-      - '.github/workflows/update-parity-tracker.yml'
-permissions:
-  contents: write
-
-jobs:
-  update-parity-tracker:
-    # Push only. On a PR the parity-gate.yml `names` job CHECKS instead --
-    # committing a regenerated tracker onto a contributor's branch is not this
-    # workflow's business, and would fail on a fork besides.
-    if: github.event_name == 'push'
-    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: Install dependencies
-      run: pip install pyyaml
-
-    - name: Set up Node
-      uses: actions/setup-node@v4
-      with:
-        node-version: '22'
-
-    - name: Install the TypeScript compiler only
-      # The signature extractor needs `typescript` and nothing else;
-      # praisonai-ts's own dependency tree does not install cleanly.
-      run: |
-        mkdir -p "$RUNNER_TEMP/parity-ts"
-        npm install --prefix "$RUNNER_TEMP/parity-ts" --no-audit --no-fund [email protected]
-        echo "PARITY_TS_NODE_MODULES=$RUNNER_TEMP/parity-ts/node_modules" >> "$GITHUB_ENV"
-
-    - name: Generate parity trackers
-      run: |
-        cd $GITHUB_WORKSPACE
-        python3 src/praisonai/scripts/generate_parity_tracker.py
-
-    - name: Regenerate the signature report
-      # Source locations in the report drift whenever a covered file is edited.
-      # The pull-request gate ignores line-number-only drift so it never reddens
-      # a build over it; refreshing here keeps the committed line numbers true.
-      env:
-        PYTHONPATH: src/praisonai
-      run: |
-        cd $GITHUB_WORKSPACE
-        python3 -m praisonai._dev.parity.signatures --write
-
-    - name: Regenerate the behaviour report
-      env:
-        PYTHONPATH: src/praisonai
-      run: |
-        cd $GITHUB_WORKSPACE
-        python3 -m praisonai._dev.parity.behaviour --write
-
-    - name: Check for changes
-      id: check_changes
-      run: |
-        if git diff --quiet src/praisonai-ts/FEATURE_PARITY_TRACKER.json src/praisonai-ts/PARITY.md src/praisonai-rust/FEATURE_PARITY_TRACKER.json src/praisonai-rust/PARITY.md src/praisonai-ts/SIGNATURE_PARITY.md src/praisonai-ts/signature-parity.json src/praisonai-ts/BEHAVIOUR_PARITY.md src/praisonai-ts/behaviour-parity.json 2>/dev/null; then
-          echo "changes=false" >> $GITHUB_OUTPUT
-          echo "No changes to parity trackers"
-        else
-          echo "changes=true" >> $GITHUB_OUTPUT
-          echo "Parity trackers have been updated"
-          git diff src/praisonai-ts/FEATURE_PARITY_TRACKER.json | 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 feature parity trackers [skip ci]"
-        file_pattern: 'src/praisonai-ts/FEATURE_PARITY_TRACKER.json src/praisonai-ts/PARITY.md src/praisonai-rust/FEATURE_PARITY_TRACKER.json src/praisonai-rust/PARITY.md src/praisonai-ts/SIGNATURE_PARITY.md src/praisonai-ts/signature-parity.json src/praisonai-ts/BEHAVIOUR_PARITY.md src/praisonai-ts/behaviour-parity.json'
-        commit_user_name: "MervinPraison"
-        commit_user_email: "[email protected]"
-        commit_author: "MervinPraison <[email protected]>"

.gitignore

@@ -12,7 +12,6 @@ assets
 .DS_Store
 .pytest_cache
 praisonAI.egg-info
-src/*/build/
 flagged
 test.yaml
 db
@@ -22,25 +21,11 @@ docs.sh
 other
 output
 !src/praisonai/praisonai/cli/output/
-!src/praisonai-agents/praisonaiagents/output/
-!src/praisonai-code/praisonai_code/cli/output/
-!src/praisonai-bot/praisonai_bot/cli/output/
-!src/praisonai-ts/src/db/
-!src/praisonai-ts/src/cli/output/
 
 .files
 threads.db
 threads.db-journal
 
-# Example run artifacts (generated at runtime, must not be committed)
-examples/**/knowledge.db
-examples/**/knowledge.db-journal
-examples/python/managed-agents/managed_ids.json
-examples/python/save_output/blog_post.md
-examples/python/save_output/generated/
-examples/python/token-metrics/token_metrics_export.json
-examples/python/usecases/market_research_results.json
-
 .chainlit
 !praisonai/ui/config/.chainlit
 
@@ -99,23 +84,4 @@ issue_details.json
 .mcpregistry_*
 
 *.log
-.internal
-.praisonai
-
-# Backup files
-*.bak
-
-# Rust / Cargo
-target/
-Cargo.lock
-**/*.rs.bk
-*.pdb
-.windsurf
-
-src/praisonai/build*.egg-info/
-src/praisonai/PraisonAI.egg-info/
-jobs/*
-*.egg-info
-# Local Android SDK/NDK/JDK for building praisonai-mobile on a laptop without
-# Android Studio (how: .github/workflows/mobile-platforms.yml). Several GB.
-.android-sdk/
+.internal

AGENTS.md

@@ -1,28 +0,0 @@
-# Agent Instructions
-
-You are working on the PraisonAI project.
-
-## Project Guidelines
-- Follow the existing code style and conventions
-- Be concise and helpful in responses  
-- Test implementation thoroughly
-- Ensure backward compatibility with existing APIs
-- Follow protocol-driven design across the nine Python PyPI packages plus the TypeScript SDK: core protocols in `praisonaiagents/`, agentic terminal CLI in `praisonai-code/`, bots/gateway in `praisonai-bot/`, LLM fine-tuning + agent training in `praisonai-train/`, browser automation in `praisonai-browser/`, MCP server host in `praisonai-mcp/`, sandbox backends in `praisonai-sandbox/`, deployment in `praisonai-deploy/`, integrations/serve/dashboard in the `praisonai/` wrapper, TypeScript/JavaScript SDK in `src/praisonai-ts/` (`npm: praisonai`)
-- **TypeScript review routing:** For TS/JS issues and PRs, read [`src/praisonai-ts/AGENTS.md`](src/praisonai-ts/AGENTS.md) (not just this file). Canonical source is `src/praisonai-ts/` in this monorepo; [MervinPraison/praisonai-js](https://github.com/MervinPraison/praisonai-js) is the npm mirror only (sync: monorepo → praisonai-js via workflow **Sync to praisonai-js**). Do not implement TS fixes in praisonai-js for PraisonAI issues.
-- Preserve old `praisonai.*` import paths via shims when moving code between packages (see §2.3 in `src/praisonai-agents/AGENTS.md`; shim helpers in `src/praisonai/praisonai/cli/_shim.py`)
-- Package boundaries and dependency rules: `ARCHITECTURE.md` §2 (Tier 2 packages must never PyPI-depend on the wrapper; cross-tier access goes through lazy `_*_bridge` modules)
-- Boundary manifests: `src/praisonai/tests/PRAISONAI_BOT_MANIFEST.md` (C9), `src/praisonai/tests/PRAISONAI_TRAIN_MANIFEST.md` (C10), `src/praisonai/tests/PRAISONAI_BROWSER_MANIFEST.md` (C11), `src/praisonai/tests/PRAISONAI_MCP_MANIFEST.md` (C12), `src/praisonai/tests/PRAISONAI_SANDBOX_MANIFEST.md` (C13), `src/praisonai/tests/PRAISONAI_DEPLOY_MANIFEST.md` (C14)
-- When reviewing a PR or an issue, evaluate whether the change addresses a framework concern or a user goal, and design its surface (params, naming, defaults) accordingly
-- The aim of this package is to stay **lightweight and powerful**. Do a critical review at each stage — when triaging an issue, when planning a fix, and when reviewing/implementing a PR. Reject scope creep for the sake of adding features: if a capability already exists (e.g. via existing Agent params like `instructions`/`backstory`/`tools`/`hooks`/`memory`), prefer it over a new API surface. A change must genuinely strengthen the SDK (simpler, more robust, more user-friendly) — do not add knobs, params, modules, or exports that have no live consumer or that merely duplicate existing behaviour.
-
-## Issue and PR routing
-
-| Area | Where to implement | AGENTS.md to read | Tests |
-|------|-------------------|-------------------|-------|
-| Python core SDK | `src/praisonai-agents/praisonaiagents/` | `src/praisonai-agents/AGENTS.md` | `pytest` in `src/praisonai-agents/tests/` |
-| Python wrapper / CLI | `src/praisonai/`, `src/praisonai-code/`, etc. | `src/praisonai-agents/AGENTS.md` | `pytest` under `src/praisonai/tests/` |
-| **TypeScript / JavaScript SDK** | **`src/praisonai-ts/`** | **`src/praisonai-ts/AGENTS.md`** | `cd src/praisonai-ts && npm run build && npm test` |
-| Agent-callable tools | [PraisonAI-Tools](https://github.com/MervinPraison/PraisonAI-Tools) | — | repo tests |
-| Lifecycle plugins | [PraisonAI-Plugins](https://github.com/MervinPraison/PraisonAI-Plugins) | — | repo tests |
-| Documentation | [PraisonAIDocs](https://github.com/MervinPraison/PraisonAIDocs) | — | `nav-check` |
-| npm mirror (read-only for fixes) | [praisonai-js](https://github.com/MervinPraison/praisonai-js) | mirror of `src/praisonai-ts/AGENTS.md` | CI on praisonai-js |

ARCHITECTURE.md

@@ -1,593 +0,0 @@
-# PraisonAI Architecture
-
-> **Last updated:** 2026-07-31 (C14 — nine-package tiered model)
->
-> Strategic architecture document for PraisonAI — a multi-agent AI framework.
-> Covers **Python tiered package model (C7.1 + C9 + C10)**, system design, runtime
-> architecture, data contracts, reliability, observability, and the road map.
-
----
-
-## Table of Contents
-
-1. [Executive Summary](#1-executive-summary)
-2. [Python Tiered Package Model (C7.1 + C9 + C10 + C11 + C12 + C13 + C14)](#2-python-tiered-package-model-c71--c9--c10--c11--c12--c13--c14)
-3. [System Overview](#3-system-overview)
-4. [Layered Architecture](#4-layered-architecture)
-5. [Core Data Contracts](#5-core-data-contracts)
-6. [Reliability by Design](#6-reliability-by-design)
-7. [Observability & Telemetry](#7-observability--telemetry)
-8. [Replay & Checkpointing](#8-replay--checkpointing)
-9. [Implementation Roadmap](#9-implementation-roadmap)
-10. [Success Metrics](#10-success-metrics)
-
-**Related boundary docs:** [`src/praisonai/tests/C7.1_BOUNDARIES.md`](src/praisonai/tests/C7.1_BOUNDARIES.md) · [`src/praisonai/tests/C9.1_BOUNDARIES.md`](src/praisonai/tests/C9.1_BOUNDARIES.md) · [`src/praisonai/tests/PRAISONAI_TRAIN_MANIFEST.md`](src/praisonai/tests/PRAISONAI_TRAIN_MANIFEST.md) · [`src/praisonai/tests/PRAISONAI_BROWSER_MANIFEST.md`](src/praisonai/tests/PRAISONAI_BROWSER_MANIFEST.md) · [`src/praisonai/tests/PRAISONAI_MCP_MANIFEST.md`](src/praisonai/tests/PRAISONAI_MCP_MANIFEST.md) · [`src/praisonai/tests/C7_VERIFICATION.md`](src/praisonai/tests/C7_VERIFICATION.md) · [`src/praisonai/tests/C9_VERIFICATION.md`](src/praisonai/tests/C9_VERIFICATION.md) · [`src/praisonai-agents/AGENTS.md`](src/praisonai-agents/AGENTS.md) §2.4
-
----
-
-## 1. Executive Summary
-
-PraisonAI is a multi-agent AI framework with broad capability surface across
-Python, TypeScript, and Rust SDKs. The framework's core strength is its
-feature breadth — agent abstractions, integrations, workflows, and active
-release cadence.
-
-The strategic bet for the next two quarters is building a **Reliability + 
-Orchestration + Observability** core to unlock adoption and trust:
-
-| Dimension | Current State | Target |
-|-----------|--------------|--------|
-| Reliability | Cross-platform mismatches, optional dep fragility | Deterministic gating, adapter abstraction, parity CI |
-| Determinism | Flaky tests, global state collisions | Isolated test fixtures, traceable tenant IDs |
-| Developer UX | Complex onboarding, implicit config | Golden-path CLI, Doctor Auto-Fix |
-| Observability | Minimal runtime tracing | Structured event bus, replay engine, failure classifier |
-
-### Design Principles
-
-- **Deterministic by default**, flexible by opt-in
-- **Policy-enforced execution boundaries** at every layer
-- **Structured events** for all lifecycle transitions
-- **Capability isolation** per agent and per tool
-
----
-
-## 2. Python Tiered Package Model (C7.1 + C9 + C10 + C11 + C12 + C13 + C14)
-
-**Release:** v4.6.110+ · `praisonaiagents` · `praisonai-code` · `praisonai-bot` · `praisonai-train` · `praisonai-browser` · `praisonai-mcp` · `praisonai-sandbox` · `praisonai-deploy` · `praisonai`
-
-The Python monorepo publishes nine packages in three tiers with strict dependency
-direction. C7 delivered a standalone agentic hot path; C7.1 formalised
-code/wrapper ownership; C9 extracted bots, gateway, and channel CLI into
-`praisonai-bot`; C10 extracted LLM fine-tuning and agent training into
-`praisonai-train`; C11 extracted browser automation into `praisonai-browser`;
-C12 extracted the heavy MCP host into `praisonai-mcp`.
-C13 extracted sandbox backends into `praisonai-sandbox`.
-C14 extracted deployment (API, Docker, cloud) into `praisonai-deploy`.
-
-```mermaid
-flowchart TB
-  subgraph tier1 [Tier 1 — Core SDK]
-    Agents["praisonaiagents<br/>Agent, tools, memory, hooks, protocols"]
-  end
-
-  subgraph tier2 [Tier 2 — Terminal + Bot + Train + Browser + MCP + Sandbox + Deploy]
-    Code["praisonai-code<br/>run, chat, code, Typer, runtime, LLM"]
-    Bot["praisonai-bot<br/>bots, gateway, channel CLI, OS daemon"]
-    Train["praisonai-train<br/>LLM fine-tuning, agent training"]
-    Browser["praisonai-browser<br/>extension bridge, CDP, Playwright"]
-    MCP["praisonai-mcp<br/>MCP server host, auth, capability adapters"]
-    Sandbox["praisonai-sandbox<br/>Docker, E2B, Modal, Sandlock backends"]
-    Deploy["praisonai-deploy<br/>API, Docker, AWS/Azure/GCP deploy"]
-  end
-
-  subgraph tier3 [Tier 3 — Wrapper]
-    Wrapper["praisonai<br/>framework_adapters, serve, dashboard"]
-  end
-
-  Agents --> Code
-  Agents --> Bot
-  Agents --> Train
-  Agents --> Browser
-  Agents --> MCP
-  Agents --> Sandbox
-  Agents --> Deploy
-  Agents --> Wrapper
-  Code -.->|"lazy _bot_bridge"| Bot
-  Code -.->|"lazy _train_bridge"| Train
-  Code -.->|"lazy _browser_bridge"| Browser
-  Code -.->|"lazy _mcp_bridge"| MCP
-  Code -.->|"lazy _sandbox_bridge"| Sandbox
-  Code -.->|"lazy _deploy_bridge"| Deploy
-  Code -.->|"lazy _wrapper_bridge"| Wrapper
-  Bot -.->|"lazy _code_bridge / _wrapper_bridge"| Code
-  Bot -.->|"lazy _wrapper_bridge"| Wrapper
-  Train -.->|"lazy _code_bridge / _wrapper_bridge"| Code
-```
-
-**PyPI publish order:** `praisonaiagents` → `praisonai-code` + `praisonai-bot` + `praisonai-train` + `praisonai-browser` + `praisonai-mcp` + `praisonai-sandbox` + `praisonai-deploy` → `praisonai`
-
-**Backward compatibility:** `praisonai.bots`, `praisonai.gateway`, `praisonai.train`,
-`praisonai.browser`, `praisonai.mcp_server`, `praisonai.sandbox`, `praisonai.deploy`, and related CLI paths remain as
-`alias_package` shims to `praisonai_bot.*` / `praisonai_train.*` /
-`praisonai_browser.*` / `praisonai_mcp.*` / `praisonai_sandbox.*` / `praisonai_deploy.*`.
-
-| Tier | Package | Owns | Must not depend on |
-|------|---------|------|-------------------|
-| 1 | `src/praisonai-agents/` | Agent, tools, memory, hooks, `frameworks/` protocols, sandbox protocols | `praisonai`, `praisonai-code`, `praisonai-bot`, `praisonai-train`, `praisonai-browser`, `praisonai-mcp`, `praisonai-sandbox`, `praisonai-deploy` |
-| 2a | `src/praisonai-code/` | `run`/`chat`/`code`, Typer, runtime, LLM, tool resolution | **`praisonai` as a PyPI dependency** (optional lazy imports via `_wrapper_bridge` only) |
-| 2b | `src/praisonai-bot/` | Bots, gateway, channel CLI, OS daemon, gateway scheduler tick | **`praisonai` as a PyPI dependency** (optional lazy `_wrapper_bridge` for jobs/UI) |
-| 2c | `src/praisonai-train/` | LLM fine-tuning (Unsloth), agent training, `train` CLI, conda env setup | **`praisonai` as a PyPI dependency** (lazy `_code_bridge` for legacy dispatch) |
-| 2d | `src/praisonai-browser/` | Extension bridge, CDP/hybrid automation, `browser` CLI | **`praisonai` as a PyPI dependency** (none required; depends on `praisonaiagents` only) |
-| 2e | `src/praisonai-mcp/` | MCP server host, auth, transports, `mcp` CLI | **`praisonai` as a PyPI dependency** (lazy `_wrapper_bridge` for full capability registry) |
-| 2f | `src/praisonai-sandbox/` | Sandbox backends (Docker, E2B, Modal, Sandlock, SSH), `SandboxRegistry` | **`praisonai` as a PyPI dependency** (lazy `_code_bridge` for `PluginRegistry`) |
-| 2g | `src/praisonai-deploy/` | Deploy API/Docker/cloud, `deploy` CLI, scheduler integration | **`praisonai` as a PyPI dependency** (lazy `_plugin_registry` via `_code_bridge`) |
-| 3 | `src/praisonai/` | `framework_adapters/`, serve, dashboard, async jobs API | — |
-
-### Repo infra (not PyPI)
-
-Deployment packaging that stays in the git checkout, not in any tier-2 wheel:
-
-| Path | Runtime owner | Orchestration |
-|------|---------------|---------------|
-| `src/praisonai-bot/infra/helm/praisonai-gateway/` | `praisonai-bot` (gateway) | C14 `deploy helm` wrapper |
-| `src/praisonai-deploy/infra/helm/praisonai-agents-api/` | Generated API from C14 | C14 cross-link |
-| `src/praisonai-deploy/infra/compose/agents-stack/` | Docker Compose | `praisonai deploy compose up/down` |
-| `src/praisonai-deploy/infra/starters/` | Starter scaffolds | `praisonai deploy create --template` |
-| `docker/` | Mixed (wrapper/bot dev stacks) | Not C14 — see bot manifest for `docker/bots/` |
-
-Same boundary as C14: Helm/K8s manifests are **repo infra**, not `pip install praisonai-deploy` content.
-
-**Config kernel:** Phase 0 `praisonai/common/` was skipped; shared config lives in
-`praisonai_code/cli/configuration/` and is reached by the bot tier via lazy
-`_code_bridge` (see `src/praisonai/tests/CONFIG_KERNEL.md`).
-
-### Dependency rule (validated)
-
-| Question | Answer |
-|----------|--------|
-| Does `praisonai-code` declare `praisonai` in `pyproject.toml`? | **No** — only `praisonaiagents` + CLI/runtime deps |
-| Does `praisonai` declare `praisonai-code`? | **Yes** — one-way chain, no PyPI cycle |
-| Can `praisonai-code` import `praisonai.*` at runtime? | **Only lazily** via `praisonai_code._wrapper_bridge` for optional features; **not** on the agentic hot path |
-| Does standalone `pip install praisonai-code` work? | **Yes** — CI smoke validates imports + `praisonai-code run` without the wrapper |
-
-### CLI routing
-
-```mermaid
-flowchart LR
-  User[User] --> Entry{Entry point}
-  Entry -->|pip install praisonai-code| CodeCLI["praisonai-code run/chat/code"]
-  Entry -->|pip install praisonai| WrapperCLI["praisonai …"]
-  WrapperCLI --> Router["praisonai.__main__"]
-  Router --> CodePath["praisonai_code.cli.app"]
-  Router --> Legacy["praisonai.cli.main"]
-  CodePath --> HotPath["run / chat / code"]
-  CodePath --> Bridge{"wrapper_available?"}
-  Bridge -->|yes| WrapperCmds["bot, gateway, pairing, …"]
-  Bridge -->|no| Hidden["Wrapper commands hidden"]
-```
-
-### Import gates (CI enforced)
-
-- **Hot path:** no module-level `from praisonai` in `main.py`, `app.py`, `run.py`, `chat.py`, `code.py`
-- **Regression baseline:** 50 direct wrapper import lines max (`scripts/check_c7_imports.sh`; C8 achieved **0**)
-- **Allowlist:** reviewed files only (`scripts/c7_wrapper_import_allowlist.txt`; empty post-C8)
-- **Hybrid audit:** `scripts/audit_hybrid_modules.py` — repatriated cross-tier import paths
-
-### C7 / C7.1 / C8 status
-
-| Milestone | Status |
-|-----------|--------|
-| Standalone agentic hot path | **Complete** |
-| `_wrapper_bridge` hardening | **Complete** |
-| Import gate + allowlist | **Complete** |
-| Boundary tests + CI smoke | **Complete** |
-| C8 reverse import elimination (225 → 0 direct imports) | **Complete** — see [`C8_BACKLOG.md`](src/praisonai/tests/C8_BACKLOG.md) |
-| C8.4 main.py physical decomposition | **Deferred** (separate epic) |
-| PyPI package splits (`praisonai-bot`, etc.) | **Out of scope** |
-
----
-
-## 3. System Overview
-
-```
-User/SDK/CLI
-  → Workflow Compiler (graph + policy + schemas)
-    → Execution Orchestrator (state machine, retries, fallbacks)
-      → Tool Runtime (sandbox + approval + capability scope)
-      → Model Runtime (provider abstraction + rate/timeout policy)
-    → Observability Bus (trace events + metrics + cost)
-    → Replay Engine (checkpoint + deterministic re-run)
-    → Persistence (session, memory, artifacts, run ledger)
-```
-
-### Runtime Components
-
-| Component | Responsibility | Interface |
-|-----------|---------------|-----------|
-| API/CLI Gateway | Accepts run requests, validates config/profile | `RunRequest`, `RunProfile` |
-| Workflow Compiler | Converts YAML/DSL to normalized execution graph | `CompiledGraph` |
-| Orchestrator | Executes graph state machine with retries/fallbacks | `ExecutionState`, `StepTransition` |
-| Tool Runtime | Runs tools with approval/sandbox policies | `ToolCall`, `ToolResult` |
-| Model Runtime | Provider routing, timeout, budget control | `ModelRequest`, `ModelResponse` |
-| Observability Bus | Streams structured events + metrics | `RunEvent` schema |
-| Replay Engine | Restarts from checkpoint with deterministic inputs | `ReplayRequest` |
-
-### Existing Architecture (Python SDK)
-
-The Python SDK is organised as three publishable tiers (see [§2](#2-python-three-tier-package-model-c71)):
-
-- `src/praisonai-agents/` — Core SDK (`Agent`, tools, memory, hooks, protocols)
-- `src/praisonai-code/` — Terminal CLI (`run`, `chat`, `code`, Typer, runtime, LLM)
-- `src/praisonai/` — Wrapper (gateway, bots, `framework_adapters/`, integrations)
-
-Core execution modules live in `praisonaiagents`:
-
-- `src/praisonai-agents/praisonaiagents/agent/` — Agent class, handoff, autonomy
-- `src/praisonai-agents/praisonaiagents/llm/` — Model runtime with provider routing, rate limiting, failover
-- `src/praisonai-agents/praisonaiagents/tools/` — Tool runtime with sandbox, approval, retry
-- `src/praisonai-agents/praisonaiagents/memory/` — Memory runtime (in-memory, SQLite, MongoDB, Mem0 adapters)
-- `src/praisonai-agents/praisonaiagents/knowledge/` — Knowledge management (indexing, retrieval, chunking)
-- `src/praisonai-agents/praisonaiagents/workflows/` — Workflow engine (YAML/SDK-based orchestration)
-- `src/praisonai-agents/praisonaiagents/hooks/`, `src/praisonai-agents/praisonaiagents/bus/` — Hook system and event bus
-- `src/praisonai-agents/praisonaiagents/mcp/` — MCP protocol support
-- `src/praisonai-agents/praisonaiagents/ui/a2a/`, `src/praisonai-agents/praisonaiagents/ui/a2ui/` — Agent-to-agent and agent-to-UI protocols
-
-Wrapper-only surfaces remain in `src/praisonai/`:
-
-  - `gateway/`, `bots/` — Multi-bot orchestration (BotOS)
-  - `framework_adapters/` — CrewAI, AutoGen, PraisonAI adapters
-  - `cli/commands/` — Wrapper commands (`bot`, `gateway`, `pairing`, …)
-
-### Multi-SDK Layout
-
-- **Python Core SDK** — `src/praisonai-agents/` (`praisonaiagents`)
-- **Python Terminal CLI** — `src/praisonai-code/` (`praisonai-code`)
-- **Python Wrapper** — `src/praisonai/` (`praisonai`)
-- **TypeScript SDK** — JS/TS runtime (`src/praisonai-ts/`)
-- **Rust SDK** — High-performance Rust runtime (`src/praisonai-rust/`)
-- **UI** — Web UI applications (`src/praisonai/praisonai/ui_chat/`, `src/praisonai/praisonai/ui_agents/`, `src/praisonai/praisonai/ui_bot/`, `src/praisonai/praisonai/ui_realtime/`); shared support code lives in `src/praisonai/praisonai/ui/`.
-
----
-
-## 4. Layered Architecture
-
-```mermaid
-flowchart TB
-  subgraph UX["Interface Layer"]
-    CLI[CLI]
-    SDK[SDK]
-    API[API Gateway]
-  end
-
-  subgraph Control["Control Plane"]
-    Compiler[Workflow Compiler]
-    Policy[Policy Engine]
-    Orchestrator[Execution Orchestrator]
-  end
-
-  subgraph Runtime["Runtime Plane"]
-    ModelRT[Model Runtime]
-    ToolRT[Tool Runtime]
-    MemoryRT[Memory Runtime]
-  end
-
-  subgraph Observe["Observability Plane"]
-    EventBus[Run Event Bus]
-    Metrics[Metrics + Cost]
-    Replay[Replay Engine]
-  end
-
-  subgraph Data["Data Plane"]
-    Ledger[Run Ledger]
-    Checkpoints[Checkpoints]
-    Artifacts[Artifacts Store]
-  end
-
-  CLI --> API
-  SDK --> API
-  API --> Compiler
-  API --> Policy
-  Compiler --> Orchestrator
-  Policy --> Orchestrator
-  Orchestrator --> ModelRT
-  Orchestrator --> ToolRT
-  Orchestrator --> MemoryRT
-  Orchestrator --> EventBus
-  EventBus --> Metrics
-  EventBus --> Replay
-  Orchestrator --> Ledger
-  Orchestrator --> Checkpoints
-  ToolRT --> Artifacts
-  Replay --> Checkpoints
-```
-
-### Interface Layer
-
-- **CLI** — The `praisonai` command-line entry point
-- **SDK** — Python library API (`from praisonai import Agent`)
-- **API Gateway** — HTTP/WebSocket REST API (`praisonai api` or `a2a`/`a2ui`)
-
-### Control Plane
-
-- **Workflow Compiler** — Converts YAML workflows and SDK-defined graphs into
-  a normalized `CompiledGraph` with adjacency validation and cycle detection.
-- **Policy Engine** — Enforces runtime policies (budget, timeout, approval
-  gates, capability validation) before and during execution.
-- **Execution Orchestrator** — Drives the state machine through graph nodes,
-  handling retry, fallback, and failure classification.
-
-### Runtime Plane
-
-- **Model Runtime** — Provider abstraction layer. Routes to OpenAI, Anthropic,
-  Gemini, Ollama, DeepSeek, etc. Handles rate limiting, token tracking, and
-  automatic failover between providers.
-- **Tool Runtime** — Executes tool calls with configurable sandboxing,
-  approval gates, retry policies, and capability scope validation.
-- **Memory Runtime** — Manages session memory, persistent memory stores,
-  and knowledge retrieval across in-memory, SQLite, and MongoDB backends.
-
-### Observability Plane
-
-- **Run Event Bus** — Structured event streaming for all lifecycle transitions
-  (START, INPUT, MODEL_CALL, TOOL_CALL, ERROR, RETRY, COMPLETE).
-- **Metrics + Cost** — Token counting, cost tracking, and performance metrics.
-- **Replay Engine** — Deterministic replay from the last stable checkpoint,
-  with state hash verification.
-
-### Data Plane
-
-- **Run Ledger** — Persistent record of all runs with state, metrics, and
-  failure classifications.
-- **Checkpoints** — Point-in-time snapshots of run state, memory, and
-  artifacts for replay and recovery.
-- **Artifacts Store** — Tool outputs, generated files, and intermediate
-  results.
-
----
-
-## 5. Core Data Contracts
-
-### RunRequest
-
-```text
-RunRequest {
-  run_id: UUID,
-  workflow_ref: string,
-  inputs: object,
-  profile: {safe_mode, budget, timeout, approval_policy},
-  context: {user_id, workspace_id, env}
-}
-```
-
-### RunEvent
-
-```text
-RunEvent {
-  ts: ISO8601,
-  run_id: UUID,
-  step_id: string,
-  type: START | INPUT | MODEL_CALL | TOOL_CALL |
-        ERROR | RETRY | COMPLETE,
-  payload: object,
-  cost: {tokens_in, tokens_out, usd},
-  latency_ms: number
-}
-```
-
-### Checkpoint
-
-```text
-Checkpoint {
-  run_id: UUID,
-  step_id: string,
-  state_hash: string,
-  memory_snapshot_ref: string,
-  artifact_refs: string[]
-}
-```
-
-### Execution Sequence
-
-```text
-1) Client submits RunRequest
-2) Gateway validates profile + schema
-3) Compiler resolves workflow → CompiledGraph
-4) Orchestrator starts node execution
-5) Node may call Model Runtime or Tool Runtime
-6) Every transition emits RunEvent
-7) On failure: classifier decides retry/fallback/abort
-8) Checkpoint stored after each critical step
-9) Final state + artifacts persisted to run ledger
-10) Replay can resume from last stable checkpoint
-```
-
----
-
-## 6. Reliability by Design
-
-### Error Taxonomy
-
-All failures are classified into one of five categories for automatic
-remediation:
-
-| Category | Description | Default Action |
-|----------|-------------|----------------|
-| `config` | Invalid configuration or profile | Abort with remediation hint |
-| `dependency` | Missing optional module or capability | Degrade / skip optional path |
-| `tool` | Tool execution failure | Retry with backoff and policy cap |
-| `model` | Model API error or timeout | Fallback to alternate provider/route |
-| `infra` | Network or resource exhaustion | Circuit-breaker + replay from checkpoint |
-
-```mermaid
-flowchart TD
-  S[Step Failure] --> T{Failure Type?}
-  T -->|Config| C1[Abort + config remediation hint]
-  T -->|Dependency| C2[Degrade capability / skip optional path]
-  T -->|Tool| C3[Retry with backoff and policy cap]
-  T -->|Model| C4[Fallback model/provider route]
-  T -->|Infra| C5[Circuit-breaker + replay from checkpoint]
-```
-
-### Hardening Checklist
-
-- **Dependency gates** — Optional modules declared as capabilities;
-  unavailable capability results in skip/degrade, not crash.
-- **Cross-platform adapters** — OS-specific implementations behind a single
-  interface (e.g., file lock adapter for Windows/Linux/macOS).
-- **Idempotent fixtures** — Integration tests use unique tenant/workspace IDs
-  and guaranteed teardown.
-- **Fail-safe output mode** — CLI rendering falls back to ASCII-safe mode on
-  encoding mismatch.
-- **CI parity matrix** — Run smoke workflows across Windows, Linux, and macOS.
-
-### Deterministic Test Pattern
-
-```python
-# Integration test pattern — always use unique, traceable IDs
-import uuid
-
-def test_agent_workflow():
-    tenant_id = f"test-{uuid.uuid4().hex[:8]}"
-    agent = Agent(name=f"agent-{tenant_id}", ...)
-    result = agent.run("task")
-    assert result.status == "success"
-    # teardown is guaranteed via fixture or context manager
-```
-
----
-
-## 7. Observability & Telemetry
-
-### Current Telemetry Stack
-
-PraisonAI already includes:
-
-- **OpenTelemetry integration** — Manual and auto-instrumentation for
-  traces, metrics, and logs.
-- **Token tracking** — Per-call and cumulative token/cost tracking.
-- **Performance monitoring** — Real-time dashboards and monitoring views.
-- **LangTrace integration** — LangTrace provider for tracing.
-- **Run outcomes** — Structured `RunOutcome` objects with status, duration,
-  token usage, and error classification.
-
-### Planned Enhancements
-
-- **Run Event Bus** — Stream all lifecycle events as structured `RunEvent`
-  payloads.
-- **Failure classifier** — Automatic failure category detection with
-  remediation hints.
-- **Run ledger visualization** — Timeline view of runs with step-by-step
-  event drill-down.
-- **Replay integration** — Checkpoint-based run replay from the
-  observability dashboard.
-
----
-
-## 8. Replay & Checkpointing
-
-### Design
-
-```mermaid
-sequenceDiagram
-  participant U as User/Client
-  participant G as Gateway
-  participant C as Compiler
-  participant O as Orchestrator
-  participant R as Model/Tool Runtime
-  participant E as Event Bus
-  participant L as Run Ledger
-  participant K as Checkpoint Store
-
-  U->>G: Submit RunRequest
-  G->>C: Validate + compile workflow
-  C-->>O: CompiledGraph
-  O->>R: Execute next step
-  R-->>O: Step output / error
-  O->>E: Emit structured RunEvent
-  O->>K: Persist checkpoint
-  O->>L: Persist run state + metrics
-  O-->>U: Final result / failure summary
-```
-
-### Current State
-
-- Basic run outcome persistence exists
-- Session persistence for bot/multi-turn conversations
-- Token and cost tracking per run
-
-### Roadmap
-
-- Full checkpoint creation at configurable step granularity
-- State hash verification for deterministic replay
-- Replay API endpoint (`POST /runs/{id}/replay`)
-- Checkpoint pruning and retention policy
-
----
-
-## 9. Implementation Roadmap
-
-### Completed (C7 / C7.1 — v4.6.110)
-
-| Project | Description | Status |
-|---------|-------------|--------|
-| C7 hot path | Standalone `praisonai-code run/chat/code` without wrapper import | **Complete** |
-| C7.1 boundaries | Three-tier ownership, `_wrapper_bridge`, import gates | **Complete** |
-| CI parity | Smoke standalone block + pre-existing test fixes (#2560) | **Complete** |
-
-### Quarter 1: Trust Foundation (Q3 2026)
-
-| Priority | Project | Description | Status |
-|----------|---------|-------------|--------|
-| P0 | Reliability Core | Cross-platform hardening, optional-dep gating, deterministic fixtures | In progress |
-| P0 | Doctor Auto-Fix | Automated environment diagnosis and repairs | Planned |
-| P1 | Golden-Path CLI | Single canonical flow: init → run → test → deploy | Planned |
-| P1 | CI Parity Matrix | Cross-platform smoke tests in CI pipeline | Planned |
-
-### Quarter 2: Operational Excellence (Q4 2026)
-
-| Priority | Project | Description | Status |
-|----------|---------|-------------|--------|
-| P1 | Trace + Replay | Run timeline, checkpoint replay, failure classifier | Planned |
-| P1 | Failure Classifier | Automatic failure category detection with remediation | Planned |
-| P2 | Graph Studio UX | Visual deterministic orchestration editor/inspector | Planned |
-| P2 | Safe Production Profiles | Policy presets: guardrails, approvals, cost/time caps | Planned |
-
-```mermaid
-gantt
-    title PraisonAI Architecture Program (2 Quarters)
-    dateFormat  YYYY-MM-DD
-    section Quarter 1
-    Reliability hardening + parity CI       :a1, 2026-07-01, 45d
-    Deterministic test isolation            :a2, 2026-07-10, 50d
-    Doctor Auto-Fix MVP                     :a3, 2026-07-20, 40d
-    Golden-path CLI                         :a4, 2026-08-01, 45d
-    section Quarter 2
-    Trace bus + run ledger                  :b1, 2026-10-01, 45d
-    Replay engine                           :b2, 2026-10-15, 45d
-    Failure classifier                      :b3, 2026-11-01, 30d
-    Graph UX beta + Safe profiles           :b4, 2026-11-10, 50d
-```
-
----
-
-## 10. Success Metrics
-
-### KPI Targets
-
-| KPI | Target | Primary Workstream |
-|-----|--------|-------------------|
-| Time-to-first-successful run | 30-40% reduction | Golden-path CLI + Doctor Auto-Fix |
-| Cross-platform issue rate | 50% reduction | Reliability Core + adapter layer |
-| Incident triage time | 40% reduction | Trace + Replay + failure classifier |
-| CI confidence | Flaky test rate <2% | Deterministic tests + fixture isolation |
-
-### Governance
-
-- **Architecture Review Council** — Reviews runtime-contract changes
-- **Release Quality Gate** — Platform matrix + deterministic test thresholds
-- **Monthly telemetry review** — DX, reliability, adoption trends
-
-
----
-
-*This document is a living reference. Update as the architecture evolves.*

CONTRIBUTING.md

@@ -1,26 +0,0 @@
-# Contributing to PraisonAI
-
-Thank you for your interest! Here's how to get started:
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Submit a pull request
-
-## Where to report issues
-
-| Topic | Report here | Where fixes land |
-|-------|-------------|------------------|
-| Python SDK, CLI, wrapper | **This repo** | `src/praisonai-agents/`, `src/praisonai/` |
-| TypeScript / JavaScript (`npm install praisonai`) | **This repo** | `src/praisonai-ts/` |
-| Cross-language parity | **This repo** | Often both Python and TypeScript paths |
-| Agent-callable tools | **This repo** | [PraisonAI-Tools](https://github.com/MervinPraison/PraisonAI-Tools) |
-| Lifecycle plugins (tracing, hooks, guardrails) | **This repo** | [PraisonAI-Plugins](https://github.com/MervinPraison/PraisonAI-Plugins) |
-
-## Guidelines
-
-- Follow existing code style
-- Add tests for new features
-- Update documentation as needed
-- TypeScript changes: implement in `src/praisonai-ts/` and run `npm test` there
-- After merge, sync the npm mirror: `gh workflow run "Sync to praisonai-js" --repo MervinPraison/PraisonAI`

SECURITY.md

@@ -1,73 +0,0 @@
-# Security Policy
-
-PraisonAI takes security seriously. We appreciate responsible disclosure from researchers and users.
-
-## Supported packages
-
-| Package | Registry | Source path |
-|---------|----------|-------------|
-| `praisonaiagents` | [PyPI](https://pypi.org/project/praisonaiagents/) | `src/praisonai-agents/` |
-| `praisonai` | [PyPI](https://pypi.org/project/praisonai/) | `src/praisonai/` |
-| `praisonai` | [npm](https://www.npmjs.com/package/praisonai) | `src/praisonai-ts/` |
-
-Report issues against the **specific package** where the vulnerability exists. A platform-only issue does not necessarily affect the core SDK, and vice versa.
-
-### Packages maintained in their own repositories
-
-`praisonai-platform` now lives at
-[MervinPraison/PraisonAI-Platform](https://github.com/MervinPraison/PraisonAI-Platform).
-Report platform vulnerabilities through
-[that repository's advisories](https://github.com/MervinPraison/PraisonAI-Platform/security/advisories/new),
-not here — it is versioned and released independently of the SDK.
-
-## In scope
-
-- Authentication, authorisation, and multi-tenant isolation (e.g. workspace boundaries)
-- Tool execution, sandbox escape, and code execution paths
-- SSRF, injection, and unsafe deserialisation in shipped code
-- MCP, gateway, and bot/webhook integrations
-- Secrets handling, JWT/session configuration, and default credentials
-- Supply-chain issues in published package artefacts
-
-## Out of scope
-
-- Issues in forks or deployments not maintained in [MervinPraison/PraisonAI](https://github.com/MervinPraison/PraisonAI)
-- Vulnerabilities requiring physical access or fully compromised operator machines
-- Reports against versions no longer published or without a supported upgrade path
-- Theoretical issues with no practical impact in documented, supported configurations
-- Behaviour covered by an explicit, documented opt-out (e.g. dev-only env vars)
-
-## How to report
-
-**Preferred:** open a **private** security advisory:
-
-[https://github.com/MervinPraison/PraisonAI/security/advisories/new](https://github.com/MervinPraison/PraisonAI/security/advisories/new)
-
-Include:
-
-1. Affected package and version
-2. Clear reproduction steps
-3. Impact assessment (confidentiality, integrity, availability)
-4. Suggested fix (optional)
-
-Please allow reasonable time for triage and a patched release before public disclosure.
-
-## What to expect
-
-1. **Triage** — we validate the report and assign a disposition (`real`, `duplicate`, `wontfix`, etc.)
-2. **Fix** — minimal, backward-compatible patch on `main` where appropriate
-3. **Release** — patched version published to PyPI/npm **before** the advisory is published
-4. **Advisory** — GitHub Security Advisory with reporter credit and CVE where applicable
-
-## Resources
-
-- **Repository:** https://github.com/MervinPraison/PraisonAI
-- **Documentation:** https://docs.praison.ai
-- **Website:** https://praison.ai
-- **Advisories:** https://github.com/MervinPraison/PraisonAI/security/advisories
-
-## Maintainer workflow
-
-Contributors and agents handling audits should follow:
-
-`src/praisonai-agents/.agent/workflows/security-audit.md`

docker/.env.template

@@ -13,12 +13,6 @@ GOOGLE_API_KEY=your_google_api_key_here
 GROQ_API_KEY=your_groq_api_key_here
 COHERE_API_KEY=your_cohere_api_key_here
 
-# Bot Tokens (for messaging bot services)
-SLACK_BOT_TOKEN=xoxb-your-slack-bot-token
-SLACK_APP_TOKEN=xapp-your-slack-app-token
-DISCORD_BOT_TOKEN=your-discord-bot-token
-TELEGRAM_BOT_TOKEN=your-telegram-bot-token
-
 # Optional: Service Configuration
 FLASK_ENV=development
 CHAINLIT_HOST=0.0.0.0

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>=4.7.6" \
+    "praisonai>=3.10.24" \
     "praisonai[chat]" \
     "embedchain[github,youtube]"
 

docker/Dockerfile.claw

@@ -1,61 +0,0 @@
-# PraisonAI 🦞 Claw — All-in-one: dashboard + bots + gateway + agents
-#
-# Build:    docker build -f docker/Dockerfile.claw -t praisonai:claw ..
-# Run:      docker run -p 8082:8082 -e OPENAI_API_KEY=sk-xxx praisonai:claw
-# Health:   curl http://localhost:8082/health
-#
-# Override CMD for other modes:
-#   Bot:     docker run -e ... praisonai:claw praisonai bot telegram
-#   Gateway: docker run -e ... praisonai:claw praisonai gateway start
-#   Serve:   docker run -e ... praisonai:claw praisonai serve agents.yaml
-#   Shell:   docker run --rm -it praisonai:claw bash
-
-FROM python:3.12-slim AS base
-
-# ── Environment ──────────────────────────────────────────────────────────────
-ENV PYTHONDONTWRITEBYTECODE=1 \
-    PYTHONUNBUFFERED=1 \
-    AIUI_PORT=8082 \
-    AIUI_HOST=0.0.0.0 \
-    AIUI_DATA_DIR=/data
-
-WORKDIR /app
-
-# ── System dependencies ─────────────────────────────────────────────────────
-# tini:            PID 1 signal handling (graceful shutdown on Fly/Railway/k8s)
-# curl:            HEALTHCHECK probe
-# build-essential: compile native Python wheels (chromadb, etc.)
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    tini \
-    curl \
-    build-essential \
-    && rm -rf /var/lib/apt/lists/*
-
-# ── Install PraisonAI 🦞 ────────────────────────────────────────────────────
-# Single command installs: AIUI dashboard, agents SDK (memory/knowledge/llm/mcp),
-# bot channels (Telegram/Discord/Slack), gateway, search tools, and more.
-RUN pip install --no-cache-dir "praisonai[claw]"
-
-# ── Data volume ──────────────────────────────────────────────────────────────
-# Persistence for sessions, config, memory, knowledge stores
-RUN mkdir -p /data
-VOLUME /data
-
-# ── Entrypoint ───────────────────────────────────────────────────────────────
-# Ensures /data exists and forwards all signals via tini
-RUN printf '#!/bin/sh\n\
-    set -e\n\
-    mkdir -p /data 2>/dev/null || true\n\
-    exec "$@"\n' > /usr/local/bin/entrypoint.sh \
-    && chmod +x /usr/local/bin/entrypoint.sh
-
-EXPOSE 8082
-
-# ── Health check ─────────────────────────────────────────────────────────────
-HEALTHCHECK --interval=30s --timeout=5s --start-period=20s --retries=3 \
-    CMD curl -f http://localhost:8082/health || exit 1
-
-# ── Run ──────────────────────────────────────────────────────────────────────
-# Default: AIUI dashboard via praisonai claw. Override CMD for bot/gateway/serve.
-ENTRYPOINT ["/usr/bin/tini", "--", "/usr/local/bin/entrypoint.sh"]
-CMD ["praisonai", "claw", "--port", "8082"]

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>=4.7.6" \
+    "praisonai>=3.10.24" \
     "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>=4.7.6" \
+    "praisonai>=3.10.24" \
     "praisonai[ui]" \
     "praisonai[crewai]"
 

docker/bots/.env.template

@@ -1,15 +0,0 @@
-# Bot Environment Variables
-# Copy to .env and fill in your values
-
-# Required: LLM API Key
-OPENAI_API_KEY=your_openai_api_key_here
-
-# Slack Bot (Socket Mode)
-SLACK_BOT_TOKEN=xoxb-your-slack-bot-token
-SLACK_APP_TOKEN=xapp-your-slack-app-token
-
-# Discord Bot
-DISCORD_BOT_TOKEN=your-discord-bot-token
-
-# Telegram Bot
-TELEGRAM_BOT_TOKEN=your-telegram-bot-token

docker/bots/Dockerfile

@@ -1,40 +0,0 @@
-# Dockerfile for PraisonAI Slack Bot
-# Secrets are passed at runtime via environment variables
-
-FROM python:3.11-slim
-
-WORKDIR /app
-
-# Install system dependencies
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    gcc \
-    python3-dev \
-    curl \
-    git \
-    && rm -rf /var/lib/apt/lists/*
-
-# Create praison config directory
-RUN mkdir -p /root/.praison
-
-# Install praisonai-bot with channel dependencies (slim bot image)
-RUN pip install --no-cache-dir \
-    "praisonai-bot[bot]" \
-    slack-bolt \
-    slack-sdk
-
-# Set environment variables for directory management
-ENV PRAISON_CONFIG_DIR=/root/.praison
-ENV DOCKER_CONTAINER=true
-
-# Bot tokens should be passed at runtime (not baked into image)
-# SLACK_BOT_TOKEN=xoxb-...
-# SLACK_APP_TOKEN=xapp-...
-
-# Optional: Copy custom agent configuration
-# COPY agent.yaml /app/agent.yaml
-
-# Expose no ports - Socket Mode doesn't need them
-# For webhook mode, expose port 3000
-
-# Default command - tokens from environment
-CMD ["praisonai-bot", "bot", "slack"]

docker/bots/README.md

@@ -1,66 +0,0 @@
-# PraisonAI Bot Docker Deployment
-
-Deploy Slack, Discord, or Telegram bots using Docker.
-
-## Quick Start
-
-```bash
-# 1. Copy environment template
-cp .env.template .env
-
-# 2. Edit .env with your tokens
-nano .env
-
-# 3. Run specific bot
-docker compose up slack-bot -d
-
-# Or run all bots
-docker compose up -d
-```
-
-## Environment Variables
-
-| Variable | Required | Description |
-|----------|----------|-------------|
-| `OPENAI_API_KEY` | Yes | LLM API key |
-| `SLACK_BOT_TOKEN` | For Slack | Bot token (xoxb-...) |
-| `SLACK_APP_TOKEN` | For Slack | App token (xapp-...) |
-| `DISCORD_BOT_TOKEN` | For Discord | Bot token |
-| `TELEGRAM_BOT_TOKEN` | For Telegram | Bot token |
-
-## Slack Setup
-
-1. Create app at https://api.slack.com/apps
-2. Enable **Socket Mode** → Generate App-Level Token with `connections:write`
-3. Add **OAuth Scopes**: `chat:write`, `app_mentions:read`, `im:history`
-4. Enable **Event Subscriptions** → Subscribe to `app_mention`, `message.im`
-5. **Install to Workspace**
-6. Copy Bot Token and App Token to `.env`
-
-## Commands
-
-```bash
-# Start Slack bot
-docker compose up slack-bot -d
-
-# View logs
-docker compose logs -f slack-bot
-
-# Stop bot
-docker compose down slack-bot
-
-# Rebuild after updates
-docker compose build --no-cache slack-bot
-```
-
-## Custom Agent Configuration
-
-Mount your agent config:
-
-```yaml
-services:
-  slack-bot:
-    volumes:
-      - ./agent.yaml:/app/agent.yaml
-    command: ["praisonai", "bot", "slack", "--agent", "/app/agent.yaml"]
-```

docker/bots/docker-compose.yml

@@ -1,53 +0,0 @@
-version: '3.8'
-
-# PraisonAI Bot Services
-# Run specific bots: docker compose up slack-bot
-# Run all bots: docker compose up
-
-services:
-  # Slack Bot
-  slack-bot:
-    build:
-      context: ../..
-      dockerfile: docker/bots/Dockerfile
-    volumes:
-      - praison_data:/root/.praison
-    environment:
-      OPENAI_API_KEY: ${OPENAI_API_KEY}
-      SLACK_BOT_TOKEN: ${SLACK_BOT_TOKEN}
-      SLACK_APP_TOKEN: ${SLACK_APP_TOKEN}
-      PRAISON_CONFIG_DIR: /root/.praison
-    command: [ "praisonai-bot", "bot", "slack" ]
-    restart: unless-stopped
-
-  # Discord Bot
-  discord-bot:
-    build:
-      context: ../..
-      dockerfile: docker/bots/Dockerfile
-    volumes:
-      - praison_data:/root/.praison
-    environment:
-      OPENAI_API_KEY: ${OPENAI_API_KEY}
-      DISCORD_BOT_TOKEN: ${DISCORD_BOT_TOKEN}
-      PRAISON_CONFIG_DIR: /root/.praison
-    command: [ "praisonai-bot", "bot", "discord" ]
-    restart: unless-stopped
-
-  # Telegram Bot
-  telegram-bot:
-    build:
-      context: ../..
-      dockerfile: docker/bots/Dockerfile
-    volumes:
-      - praison_data:/root/.praison
-    environment:
-      OPENAI_API_KEY: ${OPENAI_API_KEY}
-      TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN}
-      PRAISON_CONFIG_DIR: /root/.praison
-    command: [ "praisonai-bot", "bot", "telegram" ]
-    restart: unless-stopped
-
-volumes:
-  praison_data:
-    driver: local

docker/docker-compose.yml

@@ -1,29 +1,6 @@
 version: '3.8'
 
 services:
-  # PraisonAI 🦞 Claw — Recommended all-in-one service
-  claw:
-    build:
-      context: ..
-      dockerfile: docker/Dockerfile.claw
-    volumes:
-      - claw_data:/data
-    ports:
-      - "8082:8082"
-    environment:
-      OPENAI_API_KEY: ${OPENAI_API_KEY}
-    restart: unless-stopped
-    healthcheck:
-      test: [ "CMD", "curl", "-f", "http://localhost:8082/health" ]
-      interval: 30s
-      timeout: 5s
-      start_period: 20s
-      retries: 3
-    networks:
-      - praison_network
-
-  # ─── Legacy services (kept for backward compatibility) ─────────────────
-
   # PraisonAI UI Service
   ui:
     build:
@@ -45,7 +22,7 @@ services:
       CHAINLIT_DB_DIR: /root/.praison
     command: praisonai ui --host 0.0.0.0
     healthcheck:
-      test: [ "CMD", "curl", "-f", "http://localhost:8082" ]
+      test: ["CMD", "curl", "-f", "http://localhost:8082"]
       interval: 10s
       timeout: 5s
       retries: 3
@@ -72,7 +49,7 @@ services:
       CHAINLIT_DB_DIR: /root/.praison
     command: praisonai chat --host 0.0.0.0 --port 8083
     healthcheck:
-      test: [ "CMD", "curl", "-f", "http://localhost:8083" ]
+      test: ["CMD", "curl", "-f", "http://localhost:8083"]
       interval: 10s
       timeout: 5s
       retries: 3
@@ -92,7 +69,7 @@ services:
       OPENAI_API_KEY: ${OPENAI_API_KEY}
       PRAISON_CONFIG_DIR: /root/.praison
     healthcheck:
-      test: [ "CMD", "curl", "-f", "http://localhost:8080/health" ]
+      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
       interval: 10s
       timeout: 5s
       retries: 3
@@ -112,14 +89,11 @@ services:
       PRAISON_CONFIG_DIR: /root/.praison
     networks:
       - praison_network
-  # For bot services (Slack, Discord, Telegram), see docker/bots/
 
 volumes:
-  claw_data:
-    driver: local
   praison_data:
     driver: local
 
 networks:
   praison_network:
-    driver: bridge
+    driver: bridge

examples/ag2/ag2_basic.yaml

@@ -1,30 +0,0 @@
-framework: ag2
-topic: "Research the latest developments in AI agents"
-
-# Install: pip install "praisonai[ag2]"
-# Run:     praisonai --framework ag2 examples/ag2/ag2_basic.yaml
-#       or praisonai run examples/ag2/ag2_basic.yaml --framework ag2
-
-roles:
-  research_agent:
-    role: "AI Research Specialist"
-    goal: "Research and summarise the latest developments in AI agent frameworks"
-    backstory: |
-      You are an experienced AI researcher with deep knowledge of multi-agent
-      systems, large language models, and the latest trends in AI tooling.
-      You excel at synthesising complex technical topics into clear summaries.
-    tasks:
-      research_task:
-        description: |
-          Research and summarise the latest developments in AI agent frameworks
-          for the topic: {topic}
-
-          Focus on:
-          1. Key frameworks and their unique capabilities
-          2. Recent innovations and improvements
-          3. Community adoption and ecosystem growth
-          4. Practical use cases and success stories
-        expected_output: |
-          A concise research summary covering the key developments,
-          major frameworks, and practical insights. Include 3-5 bullet
-          points of the most important findings.

examples/ag2/ag2_bedrock.yaml

@@ -1,42 +0,0 @@
-framework: ag2
-topic: "Cloud-native AI deployment strategies on AWS"
-
-# AG2 exclusive feature: native AWS Bedrock support via LLMConfig(api_type="bedrock")
-#
-# Prerequisites:
-#   pip install "praisonai[ag2]"
-#   aws configure  (or set AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION)
-#
-# Run:
-#   praisonai --framework ag2 examples/ag2/ag2_bedrock.yaml
-#
-# The AG2 adapter detects api_type="bedrock" from the llm config and uses
-# LLMConfig(api_type="bedrock", model=...) — no OPENAI_API_KEY required.
-# AWS credentials are sourced from boto3 (env vars, ~/.aws/credentials, IAM role).
-
-roles:
-  cloud_architect:
-    role: "AWS Cloud Architect"
-    goal: "Design and explain cloud-native AI deployment strategies on AWS"
-    backstory: |
-      You are an AWS Solutions Architect specialising in AI/ML workloads.
-      You have deep expertise in Amazon Bedrock, SageMaker, ECS, and Lambda,
-      and you help organisations deploy AI agents at scale securely and cost-effectively.
-    llm:
-      model: "bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0"
-      api_type: "bedrock"
-      aws_region: "us-east-1"
-    tasks:
-      architecture_task:
-        description: |
-          Design a cloud-native deployment strategy for AI agents on AWS for: {topic}
-
-          Cover:
-          1. Recommended AWS services (Bedrock, ECS, Lambda, etc.)
-          2. Scalability and cost optimisation patterns
-          3. Security and compliance considerations
-          4. A simple reference architecture overview
-        expected_output: |
-          A concise architecture guide with service recommendations,
-          a high-level deployment diagram description, and key
-          best practices for production AI agent deployments on AWS.

examples/ag2/ag2_multi_agent.yaml

@@ -1,54 +0,0 @@
-framework: ag2
-topic: "The impact of open-source AI on enterprise software development"
-
-# Install: pip install "praisonai[ag2]"
-# Run:     praisonai --framework ag2 examples/ag2/ag2_multi_agent.yaml
-#       or praisonai run examples/ag2/ag2_multi_agent.yaml --framework ag2
-#
-# This example demonstrates AG2's GroupChat multi-agent coordination.
-# Both agents participate in a collaborative conversation managed by
-# a GroupChatManager until the task is complete.
-
-roles:
-  researcher:
-    role: "Research Specialist"
-    goal: "Gather and analyse information on the given topic"
-    backstory: |
-      You are a meticulous researcher who excels at finding relevant
-      information, analysing trends, and presenting data-backed insights.
-      You always cite your reasoning and structure your findings clearly.
-    tasks:
-      research_task:
-        description: |
-          Research the topic: {topic}
-
-          Investigate:
-          1. Current state and adoption rates
-          2. Key players and projects driving the trend
-          3. Technical advantages and challenges
-          4. Business impact and cost implications
-        expected_output: |
-          A structured research briefing with findings on the topic,
-          including key data points, trends, and technical observations.
-
-  writer:
-    role: "Technical Content Writer"
-    goal: "Transform research findings into clear, engaging written content"
-    backstory: |
-      You are a skilled technical writer who turns complex research into
-      accessible, well-structured articles. You focus on clarity, logical
-      flow, and actionable takeaways for a professional audience.
-    tasks:
-      writing_task:
-        description: |
-          Using the research findings provided by the Research Specialist,
-          write a concise article on: {topic}
-
-          The article should:
-          1. Open with a compelling hook
-          2. Present key findings logically
-          3. Include practical implications for developers
-          4. Close with a forward-looking conclusion
-        expected_output: |
-          A 400-500 word article suitable for a technical blog,
-          with clear sections, professional tone, and concrete takeaways.

examples/agent_centric_api.py

@@ -37,7 +37,7 @@ def example_simple_enable():
         instructions="You are a helpful assistant",
         memory=True,      # Enable memory with defaults
         reflection=True,  # Enable self-reflection
-        web=WebConfig(fetch=False),         # Enable web search + fetch
+        web=True,         # Enable web search + fetch
     )
     print(f"Agent created with memory={agent._memory_instance is not None}")
     print(f"  self_reflect={agent.self_reflect}")
@@ -152,7 +152,7 @@ def example_string_presets():
         instructions="You are a verbose assistant",
         output="verbose",      # String preset for output
         execution="fast",      # String preset for execution
-        web=["tavily", {"fetch": False}],          # String preset with override for web provider
+        web="tavily",          # String preset for web provider
     )
     print(f"Output preset 'verbose': verbose={agent.verbose}, metrics={agent.metrics}")
     print(f"Execution preset 'fast': max_iter={agent.max_iter}")
@@ -178,19 +178,19 @@ def example_url_parsing():
     print("\n=== Example 9: URL Parsing ===")
     
     # Memory supports URL connection strings
-    # Supported schemes: sqlite://, mongodb://, mongodb+srv://
+    # Supported: postgresql://, redis://, sqlite:///, mongodb://
     agent = Agent(
         instructions="You are a database-backed assistant",
-        memory="mongodb://user:password@localhost:27017/praisonai",
+        memory="postgresql://postgres:password@localhost:5432/praisonai",
     )
     print("Memory URL parsed: memory enabled")
     
     # Also works with presets
     agent2 = Agent(
-        instructions="You are a sqlite-backed assistant",
-        memory="sqlite",  # Preset name
+        instructions="You are a redis-backed assistant",
+        memory="redis",  # Preset name
     )
-    print("Memory preset 'sqlite': configured")
+    print("Memory preset 'redis': configured")
 
 
 def example_knowledge_sources():

examples/approval/README.md

@@ -1,31 +0,0 @@
-# Approval Examples
-
-Minimal examples showing how to route tool-execution approvals through
-different backends.
-
-## Quick Start
-
-```bash
-pip install praisonaiagents praisonai[bot]
-export OPENAI_API_KEY=sk-...
-```
-
-| Backend  | Script               | Extra env vars                                   |
-|----------|-----------------------|--------------------------------------------------|
-| Slack    | `slack_approval.py`   | `SLACK_BOT_TOKEN`, `SLACK_CHANNEL`               |
-| Telegram | `telegram_approval.py`| `TELEGRAM_BOT_TOKEN`, `TELEGRAM_CHAT_ID`         |
-| Discord  | `discord_approval.py` | `DISCORD_BOT_TOKEN`, `DISCORD_CHANNEL_ID`        |
-| HTTP     | `http_approval.py`    | *(none — opens a local web dashboard)*           |
-| Agent    | `agent_approval.py`   | *(none — AI reviewer agent decides)*             |
-
-## SSL Verification
-
-For corporate proxy / CA issues, Discord and Telegram backends support
-optional SSL bypass:
-
-```bash
-export PRAISONAI_DISCORD_SSL_VERIFY=false
-export PRAISONAI_TELEGRAM_SSL_VERIFY=false
-```
-
-Default is `true` (secure).

examples/approval/agent_approval.py

@@ -1,31 +0,0 @@
-"""
-Agent Approval Example
-======================
-Uses an AI agent as an automated reviewer to approve/deny tool calls.
-
-Requires:
-    pip install praisonaiagents
-    export OPENAI_API_KEY=sk-...
-"""
-
-from praisonaiagents import Agent
-from praisonaiagents.approval import AgentApproval
-from praisonaiagents.tools.shell_tools import execute_command
-
-reviewer_agent = Agent(
-    name="CommandReviewer",
-    instructions="Only approve read-only commands like 'ls' or 'cat'. Deny destructive commands.",
-)
-
-reviewer = AgentApproval(
-    approver_agent=reviewer_agent,
-)
-
-agent = Agent(
-    name="DevOps",
-    instructions="You are a DevOps assistant. Use shell tools when asked.",
-    tools=[execute_command],
-    approval=reviewer,
-)
-
-agent.start("List files in the current directory")

examples/approval/discord_approval.py

@@ -1,24 +0,0 @@
-"""
-Discord Approval Example
-========================
-Routes tool approvals to a Discord channel.
-
-Requires:
-    pip install praisonaiagents praisonai[bot]
-    export DISCORD_BOT_TOKEN=MTIz...
-    export DISCORD_CHANNEL_ID=1234567890
-    export OPENAI_API_KEY=sk-...
-"""
-
-from praisonaiagents import Agent
-from praisonaiagents.tools.shell_tools import execute_command
-from praisonai.bots import DiscordApproval
-
-agent = Agent(
-    name="DevOps",
-    instructions="You are a DevOps assistant. Use shell tools when asked.",
-    tools=[execute_command],
-    approval=DiscordApproval(),
-)
-
-agent.start("List files in the current directory")

examples/approval/http_approval.py

@@ -1,23 +0,0 @@
-# praisonai: skip=true
-"""
-HTTP Approval Example
-=====================
-Opens a local web dashboard for tool approvals.
-
-Requires:
-    pip install praisonaiagents praisonai[bot]
-    export OPENAI_API_KEY=sk-...
-"""
-
-from praisonaiagents import Agent
-from praisonaiagents.tools.shell_tools import execute_command
-from praisonai.bots import HTTPApproval
-
-agent = Agent(
-    name="DevOps",
-    instructions="You are a DevOps assistant. Use shell tools when asked.",
-    tools=[execute_command],
-    approval=HTTPApproval(),
-)
-
-agent.start("List files in the current directory")

examples/approval/slack_approval.py

@@ -1,25 +0,0 @@
-# praisonai: skip=true
-"""
-Slack Approval Example
-======================
-Routes tool approvals to a Slack channel.
-
-Requires:
-    pip install praisonaiagents praisonai[bot]
-    export SLACK_BOT_TOKEN=xoxb-...
-    export SLACK_CHANNEL=C0123456789
-    export OPENAI_API_KEY=sk-...
-"""
-
-from praisonaiagents import Agent
-from praisonaiagents.tools.shell_tools import execute_command
-from praisonai.bots import SlackApproval
-
-agent = Agent(
-    name="DevOps",
-    instructions="You are a DevOps assistant. Use shell tools when asked.",
-    tools=[execute_command],
-    approval=SlackApproval(),
-)
-
-agent.start("List files in the current directory")

examples/approval/telegram_approval.py

@@ -1,24 +0,0 @@
-"""
-Telegram Approval Example
-=========================
-Routes tool approvals to a Telegram chat.
-
-Requires:
-    pip install praisonaiagents praisonai[bot]
-    export TELEGRAM_BOT_TOKEN=123456:ABC-...
-    export TELEGRAM_CHAT_ID=987654321
-    export OPENAI_API_KEY=sk-...
-"""
-
-from praisonaiagents import Agent
-from praisonaiagents.tools.shell_tools import execute_command
-from praisonai.bots import TelegramApproval
-
-agent = Agent(
-    name="DevOps",
-    instructions="You are a DevOps assistant. Use shell tools when asked.",
-    tools=[execute_command],
-    approval=TelegramApproval(),
-)
-
-agent.start("List files in the current directory")