Release v4.6.121

.agent/mer-vin-architecture-v4.6.110.html

@@ -0,0 +1,239 @@
+<!-- wp:paragraph -->
+<p><strong>v4.6.113</strong> — three Python packages, strict dependency direction, and <strong>C8 complete</strong>: reverse wrapper imports eliminated from <code>praisonai-code</code>. Tap the diagrams; tables hold the rules.</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:quote -->
+<blockquote class="wp-block-quote"><p><strong>One rule (unchanged):</strong> <code>praisonai-code</code> never lists <code>praisonai</code> in <code>pyproject.toml</code>. Wrapper access is <strong>bridge-only</strong> via <code>_wrapper_bridge</code> — zero direct <code>from praisonai</code> imports remain.</p></blockquote>
+<!-- /wp:quote -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">✅ C8 validation summary</h2>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Plan target</th><th>Before (C7.1)</th><th>After (C8 / v4.6.113)</th><th>Verdict</th></tr></thead><tbody><tr><td>Wrapper import lines</td><td>225</td><td><strong>0</strong></td><td>✅ Exceeded (~40–60 floor)</td></tr><tr><td>Allowlisted files</td><td>47</td><td><strong>0</strong> (empty)</td><td>✅</td></tr><tr><td>Regression baseline</td><td>225</td><td><strong>50</strong> (headroom gate)</td><td>✅</td></tr><tr><td>No PyPI dep on wrapper</td><td>Yes</td><td>Yes</td><td>✅</td></tr><tr><td>Hot path standalone</td><td>Yes</td><td>Yes</td><td>✅</td></tr><tr><td><code>main.py</code> ≤ 300 lines</td><td>7,454 lines</td><td>~7,492 lines</td><td>⏳ Partial — legacy helpers extracted; full decompose deferred</td></tr><tr><td>PyPI splits (bot/frameworks)</td><td>Out of scope</td><td>Out of scope</td><td>—</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:paragraph -->
+<p><strong>Shipped:</strong> PR <a href="https://github.com/MervinPraison/PraisonAI/pull/2590">#2590</a> merged · Release <a href="https://github.com/MervinPraison/PraisonAI/releases/tag/v4.6.113">v4.6.113</a></p>
+<!-- /wp:paragraph -->
+
+<!-- wp:heading {"level":3} -->
+<h3 class="wp-block-heading">What C8 moved (repatriation)</h3>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Phase</th><th>What happened</th><th>Status</th></tr></thead><tbody><tr><td><strong>C8.1</strong></td><td><code>_WRAPPER_RESIDENT_COMMANDS</code>, import-gate regex fix, boundary tests</td><td>✅ Done</td></tr><tr><td><strong>C8.2</strong></td><td>Commands → wrapper: langfuse, train, docs, serve bridge, n8n, replay, …</td><td>✅ Done</td></tr><tr><td><strong>C8.3</strong></td><td>Features → wrapper: recipe, templates, deploy, eval, registry, …</td><td>✅ Done</td></tr><tr><td><strong>C8.4</strong></td><td><code>praisonai/cli/legacy/</code> + <code>prompt_dispatch.py</code> in code</td><td>✅ Partial</td></tr><tr><td><strong>C8.5</strong></td><td>Bridge normalisation + <code>TemplateStore</code> / <code>SessionStore</code> / <code>ServeHandler</code> protocols</td><td>✅ Done</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:separator -->
+<hr class="wp-block-separator has-alpha-channel-opacity"/>
+<!-- /wp:separator -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">📦 Three tiers at a glance</h2>
+<!-- /wp:heading -->
+
+<!-- wp:merpress/mermaidjs {"align":"full"} -->
+<div class="wp-block-merpress-mermaidjs diagram-source-mermaid alignfull"><pre class="mermaid">%%{init: {"theme": "base", "themeVariables": {"background": "transparent", "lineColor": "#000000"}}}%%
+flowchart TB
+  subgraph tier1 ["Tier 1 — Core SDK"]
+    Agents["praisonaiagents<br/>Agent, tools, memory, hooks, protocols"]
+  end
+  subgraph tier2 ["Tier 2 — Terminal CLI"]
+    Code["praisonai-code<br/>run, chat, code, Typer, runtime"]
+  end
+  subgraph tier3 ["Tier 3 — Wrapper"]
+    Wrapper["praisonai<br/>gateway, bots, framework_adapters, repatriated CLI"]
+  end
+  Agents --> Code
+  Agents --> Wrapper
+  Code -.->|"bridge only<br/>0 direct imports"| Wrapper
+  classDef agent fill:#8B0000,color:#fff
+  classDef tool fill:#189AB4,color:#fff
+  classDef decision fill:#444,color:#fff
+  class Agents agent
+  class Code tool
+  class Wrapper decision
+</pre></div>
+<!-- /wp:merpress/mermaidjs -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Tier</th><th>Package</th><th>Owns</th><th>Version (v4.6.113)</th></tr></thead><tbody><tr><td><strong>1</strong></td><td><code>praisonaiagents</code></td><td>Agent, tools, memory, hooks, CLI protocols (C8.5)</td><td>1.6.113</td></tr><tr><td><strong>2</strong></td><td><code>praisonai-code</code></td><td><code>run</code>, <code>chat</code>, <code>code</code>, Typer hot path, bridge</td><td>0.0.11</td></tr><tr><td><strong>3</strong></td><td><code>praisonai</code></td><td>bots, gateway, adapters, repatriated commands/features</td><td>4.6.113</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:heading {"level":3} -->
+<h3 class="wp-block-heading">Tier 1 — <code>praisonaiagents</code></h3>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Module</th><th>What it does</th></tr></thead><tbody><tr><td><code>agent/</code></td><td>Agent class, execution, handoffs</td></tr><tr><td><code>tools/</code></td><td><code>@tool</code>, BaseTool, registry</td></tr><tr><td><code>memory/</code>, <code>hooks/</code>, <code>llm/</code></td><td>Memory, events, model routing</td></tr><tr><td><code>frameworks/</code></td><td>Protocols only — not CrewAI/AutoGen impls</td></tr><tr><td><code>cli/protocols.py</code></td><td><strong>C8.5:</strong> TemplateStore, SessionStore, ServeHandler protocols</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:heading {"level":3} -->
+<h3 class="wp-block-heading">Tier 2 — <code>praisonai-code</code></h3>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Component</th><th>What it does</th></tr></thead><tbody><tr><td><code>run/chat/code</code></td><td>Agentic hot path — standalone, strict gate</td></tr><tr><td><code>cli/app.py</code></td><td>Typer router + <code>_WRAPPER_RESIDENT_COMMANDS</code></td></tr><tr><td><code>_wrapper_bridge.py</code></td><td><strong>Only</strong> path to wrapper modules (string-based lazy import)</td></tr><tr><td><code>cli/commands/serve.py</code></td><td>SDK serve + bridge to wrapper gateway/endpoints</td></tr><tr><td><code>cli/features/doctor/</code></td><td>Health checks; wrapper checks SKIP if standalone</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:heading {"level":3} -->
+<h3 class="wp-block-heading">Tier 3 — <code>praisonai</code> (now owns repatriated CLI)</h3>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Component</th><th>What it does</th></tr></thead><tbody><tr><td><code>cli/commands/*</code></td><td>bot, gateway, train, langfuse, docs, n8n, replay, …</td></tr><tr><td><code>cli/features/*</code></td><td>recipe, templates, deploy, eval, serve orchestration</td></tr><tr><td><code>cli/legacy/</code></td><td>inbuilt_tools, framework_run (C8.4)</td></tr><tr><td><code>bots/</code>, <code>gateway/</code></td><td>Multi-platform bot orchestration</td></tr><tr><td><code>framework_adapters/</code></td><td>CrewAI, AutoGen, registry</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:separator -->
+<hr class="wp-block-separator has-alpha-channel-opacity"/>
+<!-- /wp:separator -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">🔀 CLI routing</h2>
+<!-- /wp:heading -->
+
+<!-- wp:merpress/mermaidjs {"align":"full"} -->
+<div class="wp-block-merpress-mermaidjs diagram-source-mermaid alignfull"><pre class="mermaid">%%{init: {"theme": "base", "themeVariables": {"background": "transparent", "lineColor": "#000000"}}}%%
+flowchart LR
+  User[User] --> Entry{Entry}
+  Entry -->|praisonai-code| Hot["run / chat / code"]
+  Entry -->|praisonai| Router[Typer router]
+  Router --> App[praisonai_code.cli.app]
+  Router --> Legacy[Legacy YAML]
+  App --> Resident{_WRAPPER_RESIDENT?}
+  Resident -->|yes + wrapper| WrapCmd[praisonai.cli.commands.*]
+  Resident -->|no| CodeCmd[praisonai_code.cli.commands.*]
+  Resident -->|no wrapper| Hide[Hidden from help]
+  classDef agent fill:#8B0000,color:#fff
+  classDef tool fill:#189AB4,color:#fff
+  classDef decision fill:#444,color:#fff
+  class Hot tool
+  class WrapCmd decision
+  class Resident decision
+</pre></div>
+<!-- /wp:merpress/mermaidjs -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Command type</th><th>Loaded from</th><th>Standalone?</th></tr></thead><tbody><tr><td><code>run</code>, <code>chat</code>, <code>code</code></td><td><code>praisonai_code</code></td><td>✅</td></tr><tr><td><code>bot</code>, <code>gateway</code>, <code>train</code>, …</td><td><code>praisonai.cli.commands.*</code></td><td>❌ hidden</td></tr><tr><td>Legacy YAML / <code>--framework crewai</code></td><td><code>cli/main.py</code> + bridge</td><td>❌</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:quote -->
+<blockquote class="wp-block-quote"><p><strong>C8 change:</strong> 30+ commands are <code>_WRAPPER_RESIDENT</code> — implementation lives only in the wrapper; code package routes lazily with no duplicate modules.</p></blockquote>
+<!-- /wp:quote -->
+
+<!-- wp:separator -->
+<hr class="wp-block-separator has-alpha-channel-opacity"/>
+<!-- /wp:separator -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">🌉 Bridge-only access (post-C8)</h2>
+<!-- /wp:heading -->
+
+<!-- wp:merpress/mermaidjs {"align":"full"} -->
+<div class="wp-block-merpress-mermaidjs diagram-source-mermaid alignfull"><pre class="mermaid">%%{init: {"theme": "base", "themeVariables": {"background": "transparent", "lineColor": "#000000"}}}%%
+sequenceDiagram
+  participant Code as praisonai_code
+  participant Bridge as _wrapper_bridge
+  participant Wrap as praisonai
+  Code->>Bridge: import_wrapper_module("praisonai.cli.features.serve")
+  alt wrapper installed
+    Bridge->>Wrap: importlib.import_module
+    Wrap-->>Code: module handle
+  else standalone
+    Bridge-->>Code: ImportError + pip install praisonai hint
+  end
+</pre></div>
+<!-- /wp:merpress/mermaidjs -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Before C8</th><th>After C8</th></tr></thead><tbody><tr><td>225 direct <code>from praisonai</code> lines</td><td><strong>0</strong> — all bridge string imports</td></tr><tr><td>47 allowlisted files</td><td><strong>0</strong> — empty allowlist</td></tr><tr><td>Duplicate command copies in code + wrapper</td><td>Single impl in wrapper; code routes only</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:separator -->
+<hr class="wp-block-separator has-alpha-channel-opacity"/>
+<!-- /wp:separator -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">🛡️ Import gates (CI)</h2>
+<!-- /wp:heading -->
+
+<!-- wp:merpress/mermaidjs {"align":"full"} -->
+<div class="wp-block-merpress-mermaidjs diagram-source-mermaid alignfull"><pre class="mermaid">%%{init: {"theme": "base", "themeVariables": {"background": "transparent", "lineColor": "#000000"}}}%%
+flowchart TD
+  CI[CI smoke] --> Venv[Standalone venv]
+  Venv --> Hot[Hot-path gate]
+  Venv --> Script[check_c7_imports.sh]
+  Script --> Strict[Strict: run/chat/code/app]
+  Script --> Base["Baseline max 50 lines"]
+  Script --> Allow[Empty allowlist enforced]
+  Venv --> Run[praisonai-code run]
+  classDef tool fill:#189AB4,color:#fff
+  classDef agent fill:#8B0000,color:#fff
+  class CI agent
+  class Script tool
+</pre></div>
+<!-- /wp:merpress/mermaidjs -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Gate</th><th>Check</th><th>Status</th></tr></thead><tbody><tr><td>Hot path</td><td>No module-level wrapper import in main/app/run/chat/code</td><td>✅</td></tr><tr><td>Strict</td><td>Zero wrapper imports in app/run/chat/code</td><td>✅</td></tr><tr><td>Baseline</td><td>≤ <strong>50</strong> direct import lines (current: <strong>0</strong>)</td><td>✅</td></tr><tr><td>Allowlist</td><td>Any offender must be listed (list is empty)</td><td>✅</td></tr><tr><td>Smoke</td><td>Standalone <code>praisonai-code run</code></td><td>✅</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:code -->
+<pre class="wp-block-code"><code>bash scripts/check_c7_imports.sh
+pytest src/praisonai/tests/unit/test_c7_1_boundaries.py
+pytest src/praisonai/tests/unit/test_c5_backward_compat.py</code></pre>
+<!-- /wp:code -->
+
+<!-- wp:separator -->
+<hr class="wp-block-separator has-alpha-channel-opacity"/>
+<!-- /wp:separator -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">🔌 Framework adapters</h2>
+<!-- /wp:heading -->
+
+<!-- wp:merpress/mermaidjs {"align":"full"} -->
+<div class="wp-block-merpress-mermaidjs diagram-source-mermaid alignfull"><pre class="mermaid">%%{init: {"theme": "base", "themeVariables": {"background": "transparent", "lineColor": "#000000"}}}%%
+flowchart TB
+  subgraph sdk [praisonaiagents]
+    P[frameworks protocols]
+    CP[cli protocols C8.5]
+  end
+  subgraph wrap [praisonai]
+    R[framework_adapters registry]
+    C[CrewAI AutoGen]
+  end
+  subgraph code [praisonai-code]
+    B[_wrapper_bridge]
+  end
+  P -.-> R
+  CP -.-> wrap
+  B -->|lazy| R
+  classDef agent fill:#8B0000,color:#fff
+  classDef tool fill:#189AB4,color:#fff
+  class P agent
+  class B tool
+</pre></div>
+<!-- /wp:merpress/mermaidjs -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Layer</th><th>Location</th></tr></thead><tbody><tr><td>Framework protocols</td><td><code>praisonaiagents/frameworks/</code></td></tr><tr><td>CLI protocols (C8.5)</td><td><code>praisonaiagents/cli/protocols.py</code></td></tr><tr><td>Implementations</td><td><code>praisonai/framework_adapters/</code></td></tr><tr><td>Access from code</td><td><code>_wrapper_bridge</code> only</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:separator -->
+<hr class="wp-block-separator has-alpha-channel-opacity"/>
+<!-- /wp:separator -->
+
+<!-- wp:heading -->
+<h2 class="wp-block-heading">📋 Milestone status</h2>
+<!-- /wp:heading -->
+
+<!-- wp:table -->
+<figure class="wp-block-table"><table><thead><tr><th>Milestone</th><th>State</th><th>Release</th></tr></thead><tbody><tr><td>C7 hot path</td><td>✅ Complete</td><td>—</td></tr><tr><td>C7.1 boundaries</td><td>✅ Complete</td><td>v4.6.110</td></tr><tr><td><strong>C8 reverse imports</strong></td><td>✅ Complete</td><td><strong>v4.6.113</strong></td></tr><tr><td>C8.4 full main.py split</td><td>⏳ Deferred</td><td>Future</td></tr><tr><td>PyPI splits (bot / frameworks)</td><td>⏳ Out of scope</td><td>—</td></tr></tbody></table></figure>
+<!-- /wp:table -->
+
+<!-- wp:paragraph -->
+<p><a href="https://github.com/MervinPraison/PraisonAI/blob/main/ARCHITECTURE.md">ARCHITECTURE.md</a> · <a href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai/tests/C7.1_BOUNDARIES.md">C7.1 boundaries</a> · <a href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai/tests/C8_BACKLOG.md">C8 backlog</a> · <a href="https://github.com/MervinPraison/PraisonAI/releases/tag/v4.6.113">v4.6.113 release</a> · <a href="https://github.com/MervinPraison/PraisonAI/pull/2590">PR #2590</a></p>
+<!-- /wp:paragraph -->

.agent/mer-vin-praisonai-mcp.html

@@ -1,330 +0,0 @@
-<!-- wp:paragraph -->
-<p>praisonai-mcp is Tier 2e — the heavy MCP server host: full <code>MCPServer</code>, tool/resource/prompt registries, recipe bridge, HTTP-stream auth, and MCP client config management. Depends only on <code>praisonaiagents</code>. v0.0.2. Protocol: MCP 2025-11-25.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:merpress/mermaidjs {"align":"full"} -->
-<div class="wp-block-merpress-mermaidjs diagram-source-mermaid alignfull"><pre class="mermaid">%%{init: {"theme": "base", "themeVariables": {"background": "transparent", "lineColor": "#000000"}}}%%
-flowchart TB
-  CLIENT[Cursor Claude Desktop]
-  subgraph T1 [praisonaiagents]
-    SDK[MCP client ToolsMCPServer]
-    SEC[mcp_security shared]
-  end
-  subgraph T2e [praisonai-mcp]
-    HOST[MCPServer]
-    REG[tool resource prompt registry]
-    TR[stdio http-stream]
-    AUTH[api-key oauth scopes]
-    CFG[mcp list add sync]
-  end
-  subgraph T2a [praisonai-code optional]
-    LIGHT[serve mcp light]
-    BRIDGE[_mcp_bridge]
-  end
-  subgraph T3 [praisonai wrapper optional]
-    CAP[capabilities recipe]
-  end
-  CLIENT --> TR
-  TR --> HOST
-  HOST --> REG
-  REG -.->|adapters| CAP
-  CFG -.->|_code_bridge| LIGHT
-  BRIDGE --> CFG
-  SDK --> LIGHT
-  SEC --> TR
-  classDef agent fill:#8B0000,color:#fff
-  classDef tool fill:#189AB4,color:#fff
-  class CLIENT agent
-  class SDK agent
-  class HOST agent
-  class REG tool
-  class TR tool
-  class AUTH tool
-  class CFG tool
-  class LIGHT tool
-  class SEC tool
-</pre></div>
-<!-- /wp:merpress/mermaidjs -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Three MCP layers (do not conflate)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Layer</th><th>Package</th><th>Role</th><th>Entry</th></tr></thead><tbody><tr><td>Client</td><td><code>praisonaiagents/mcp/</code></td><td>Connect agents to external MCP servers; OAuth storage</td><td><code>pip install "praisonaiagents[mcp]"</code></td></tr><tr><td>Light server</td><td><code>praisonai-code</code></td><td>Config-driven basic tool hosting</td><td><code>praisonai serve mcp</code></td></tr><tr><td>Heavy host</td><td><code>praisonai-mcp</code></td><td>Full server, adapters, recipe bridge, HTTP auth</td><td><code>praisonai mcp serve</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Install matrix</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Install</th><th><code>praisonai mcp</code></th><th><code>praisonai serve mcp</code></th><th><code>praisonai-mcp</code> script</th></tr></thead><tbody><tr><td><code>pip install praisonai-mcp</code></td><td>—</td><td>—</td><td>✅</td></tr><tr><td><code>pip install "praisonai-mcp[all]"</code></td><td>—</td><td>—</td><td>✅ HTTP + auth</td></tr><tr><td><code>pip install praisonai-code</code> only</td><td>hidden</td><td>✅ light</td><td>—</td></tr><tr><td><code>pip install "praisonai[mcp]"</code></td><td>✅</td><td>✅</td><td>✅</td></tr><tr><td><code>pip install praisonai</code></td><td>✅</td><td>✅</td><td>✅</td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:paragraph -->
-<p>1. Standalone heavy host</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>pip install "praisonai-mcp[all]"
-export OPENAI_API_KEY=sk-...
-
-praisonai-mcp --version
-praisonai-mcp serve --transport stdio
-praisonai-mcp list-tools
-praisonai-mcp doctor</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>2. Full stack (same commands via <code>praisonai mcp …</code>)</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>pip install praisonai
-# or MCP-only extra
-pip install "praisonai[mcp]"
-
-praisonai mcp serve --transport stdio
-praisonai mcp list-tools
-praisonai mcp doctor</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>3. Light server only (no praisonai-mcp required)</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>pip install praisonai-code "praisonaiagents[mcp]"
-
-praisonai serve mcp --port 8080
-# Uses agents ToolsMCPServer — not the heavy MCPServer</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:separator -->
-<hr class="wp-block-separator has-alpha-channel-opacity"/>
-<!-- /wp:separator -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 1 — STDIO host (Cursor / Claude Desktop)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code># Heavy host — full PraisonAI tool registry
-praisonai-mcp serve --transport stdio
-# or
-praisonai mcp serve --transport stdio
-
-# Generate client config
-praisonai mcp config-generate --client cursor --transport stdio
-praisonai mcp config-generate --client claude-desktop --transport stdio</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>STDIO uses JSON-RPC over stdin/stdout. Logs go to stderr only — never corrupt the protocol stream.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 2 — HTTP Stream host</h2>
-<!-- /wp:heading -->
-
-<!-- wp:paragraph -->
-<p>Streamable HTTP (MCP 2025-11-25) — not legacy standalone SSE. Requires <code>[server]</code> extra (starlette + uvicorn).</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>praisonai mcp serve \
-  --transport http-stream \
-  --host 127.0.0.1 \
-  --port 8080 \
-  --endpoint /mcp \
-  --api-key my-secret-key \
-  --response-mode batch
-
-# Endpoints: POST/GET/DELETE /mcp, plus /health</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Non-localhost binds require <code>--api-key</code> or <code>--keys-file</code>. Origin validation uses shared helpers from <code>praisonaiagents.mcp.mcp_security</code>.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 3 — Recipe → MCP bridge</h2>
-<!-- /wp:heading -->
-
-<!-- wp:paragraph -->
-<p>Turn any PraisonAI recipe into a scoped MCP server with allow/deny lists and safe mode.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>praisonai mcp serve-recipe support-reply --transport stdio
-
-praisonai mcp validate-recipe support-reply
-praisonai mcp inspect-recipe support-reply
-
-praisonai mcp config-generate-recipe support-reply --client claude-desktop</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Default denied tools include <code>shell.exec</code>, <code>file.delete</code>, <code>eval</code>, and similar destructive operations.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 4 — MCP client config management</h2>
-<!-- /wp:heading -->
-
-<!-- wp:paragraph -->
-<p>Config subcommands (<code>list</code>, <code>add</code>, <code>remove</code>, <code>sync</code>, <code>test</code>) require <code>praisonai-code</code> via <code>_code_bridge</code>.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>praisonai mcp list
-praisonai mcp add filesystem \
-  --command npx \
-  --args "-y @modelcontextprotocol/server-filesystem ."
-
-praisonai mcp test filesystem
-praisonai mcp sync
-praisonai mcp tools
-praisonai mcp status</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 5 — Built-in registry (tools, resources, prompts)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Type</th><th>Examples</th><th>Adapter</th></tr></thead><tbody><tr><td>Tools</td><td><code>praisonai.chat.*</code>, <code>praisonai.workflow.*</code>, agent run helpers</td><td><code>mcp_server/adapters/capabilities.py</code>, <code>cli_tools.py</code></td></tr><tr><td>Resources</td><td><code>praisonai://memory/sessions</code>, <code>praisonai://workflows</code>, <code>praisonai://agents</code></td><td><code>adapters/resources.py</code></td></tr><tr><td>Prompts</td><td><code>deep-research</code>, <code>code-review</code>, <code>workflow-auto</code></td><td><code>adapters/prompts.py</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code># Inspect what the host exposes
-praisonai-mcp list-tools
-praisonai-mcp list-resources
-praisonai-mcp list-prompts
-
-# Host tool search (MCPServerCLI)
-praisonai-mcp tools search "workflow"</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 6 — Security &amp; auth</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Concern</th><th>Package</th><th>Module</th></tr></thead><tbody><tr><td>Origin validation, session IDs</td><td><code>praisonaiagents</code></td><td><code>mcp/mcp_security.py</code></td></tr><tr><td>API keys, scoped keys file</td><td><code>praisonai-mcp</code></td><td><code>mcp_server/auth/api_key.py</code></td></tr><tr><td>OAuth 2.1 + PKCE</td><td><code>praisonai-mcp</code></td><td><code>mcp_server/auth/oauth.py</code></td></tr><tr><td>OIDC discovery</td><td><code>praisonai-mcp</code></td><td><code>mcp_server/auth/oidc.py</code></td></tr><tr><td>Scope enforcement</td><td><code>praisonai-mcp</code></td><td><code>mcp_server/auth/scopes.py</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code># Scoped keys file (--keys-file)
-[
-  {"key": "monitor-key", "name": "monitor", "scopes": ["tools:read", "resources:read"]},
-  {"key": "admin-key", "name": "admin", "scopes": ["*"]}
-]
-
-# Env vars
-export MCP_API_KEY=your-key
-export PRAISONAI_MCP_MAX_SESSIONS=1000</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 7 — CLI routing (lazy load)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Registry</th><th>Commands</th><th>Gate</th></tr></thead><tbody><tr><td>MCP-resident Typer</td><td>list, add, remove, sync, test, serve, doctor</td><td><code>mcp_package_available()</code></td></tr><tr><td>MCPServerCLI host</td><td>serve, list-tools, list-resources, config-generate, tasks, auth</td><td>Direct via <code>praisonai-mcp &lt;cmd&gt;</code></td></tr><tr><td>Code-resident light</td><td><code>serve mcp</code></td><td>Always available with code + agents</td></tr><tr><td>Wrapper-resident</td><td>dashboard, schedule, langfuse</td><td><code>wrapper_package_available()</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:paragraph -->
-<p>Standalone <code>praisonai-code</code> hides <code>mcp</code> from <code>--help</code> when <code>praisonai-mcp</code> is not installed. Host commands like <code>praisonai-mcp serve</code> skip the <code>mcp</code> prefix; <code>praisonai mcp serve</code> goes through the Typer group.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 8 — Python API</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>import praisonai_mcp
-from praisonai_mcp.mcp_server import MCPServer
-from praisonai_mcp.mcp_server.registry import register_tool
-from praisonai_mcp.mcp_server.adapters import register_all
-
-@register_tool("custom.greet")
-def greet(name: str) -> str:
-    """Greet a person by name."""
-    return f"Hello, {name}!"
-
-register_all()
-server = MCPServer(name="praisonai")
-server.run(transport="stdio")</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code># Recipe host
-from praisonai_mcp.mcp_server import RecipeMCPAdapter
-
-adapter = RecipeMCPAdapter("support-reply")
-adapter.load()
-adapter.to_mcp_server().run(transport="stdio")
-
-# Shim path still works
-from praisonai.mcp_server import MCPServer</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 9 — Standalone (no wrapper)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>pip install praisonaiagents "praisonai-mcp[all]"
-export OPENAI_API_KEY=sk-...
-
-praisonai-mcp serve --transport stdio
-praisonai-mcp list-tools
-praisonai-mcp doctor
-praisonai-mcp --help</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Heavy MCP hosting needs only <code>praisonaiagents</code> + <code>praisonai-mcp</code>. Full capability registry (workflows, deploy, extended tools) activates when the wrapper is co-installed via <code>_wrapper_bridge</code>.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Bridges (no PyPI cycles)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Bridge</th><th>Direction</th><th>Use</th></tr></thead><tbody><tr><td><code>_mcp_bridge</code></td><td>code → mcp</td><td>Route <code>praisonai mcp</code> into Typer group</td></tr><tr><td><code>_code_bridge</code></td><td>mcp → code</td><td>Config loader, paths, output controller</td></tr><tr><td><code>_wrapper_bridge</code></td><td>mcp → wrapper</td><td>Capabilities, recipe, deploy adapters</td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Backward-compat shims</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Old path</th><th>Still works via</th></tr></thead><tbody><tr><td><code>praisonai.mcp_server.*</code></td><td><code>alias_package</code> → <code>praisonai_mcp.mcp_server</code></td></tr><tr><td><code>praisonai.cli.commands.mcp</code></td><td><code>sys.modules</code> shim → mcp Typer group</td></tr><tr><td><code>from praisonai.mcp_server import MCPServer</code></td><td>Lazy re-export through shim</td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Seven-package publish order</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>praisonaiagents → praisonai-code → praisonai-bot → praisonai-train → praisonai-browser → praisonai-mcp → praisonai (wrapper)</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Wrapper pins <code>praisonai-mcp&gt;=X</code> after mcp is on PyPI. CI: <code>.github/workflows/pypi-release.yml</code>. Import gate: <code>scripts/check_c12_mcp_imports.sh</code>.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Summary</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Item</th><th>Value</th></tr></thead><tbody><tr><td>Tier</td><td>2e</td></tr><tr><td>PyPI</td><td><code>praisonai-mcp</code> v0.0.2</td></tr><tr><td>Runtime deps</td><td><code>praisonaiagents</code>, <code>mcp</code>, rich, typer</td></tr><tr><td>HTTP extra</td><td><code>[server]</code> — starlette, uvicorn</td></tr><tr><td>Auth extra</td><td><code>[auth]</code> — httpx</td></tr><tr><td>Transports</td><td><code>stdio</code>, <code>http-stream</code></td></tr><tr><td>Light alternative</td><td><code>praisonai serve mcp</code> (code tier)</td></tr><tr><td>CLI entry</td><td><code>praisonai-mcp</code> or <code>praisonai mcp</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:paragraph -->
-<p>Previous: <a href="https://mer.vin/2026/07/praisonai-train-praisonai-train-fine-tuning-agent-training-in-depth/">praisonai-train</a> · Next: praisonai wrapper</p>
-<!-- /wp:paragraph -->

.agent/mer-vin-praisonai-wrapper.html

@@ -1,460 +0,0 @@
-<!-- wp:paragraph -->
-<p>praisonai is Tier 3 — the integration wrapper that wires <code>praisonaiagents</code> + five Tier-2 packages (<code>praisonai-code</code>, <code>praisonai-bot</code>, <code>praisonai-train</code>, <code>praisonai-browser</code>, <code>praisonai-mcp</code>) into one install, with dashboard, framework adapters, jobs API, serve orchestration, and backward-compat shims. v4.6.150.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:merpress/mermaidjs {"align":"full"} -->
-<div class="wp-block-merpress-mermaidjs diagram-source-mermaid alignfull"><pre class="mermaid">%%{init: {"theme": "base", "themeVariables": {"background": "transparent", "lineColor": "#000000"}}}%%
-flowchart TB
-  subgraph T1 [Tier 1 praisonaiagents]
-    A[Agent tools memory MCP client]
-  end
-  subgraph T2 [Tier 2 packages]
-    C[praisonai-code run chat code]
-    B[praisonai-bot gateway channels]
-    TR[praisonai-train fine-tune agents]
-    BR[praisonai-browser CDP Playwright]
-    MCP[praisonai-mcp server host]
-  end
-  subgraph T3 [Tier 3 praisonai wrapper]
-    W[dashboard jobs frameworks serve shims]
-  end
-  A --> C
-  A --> B
-  A --> TR
-  A --> BR
-  A --> MCP
-  W --> C
-  W --> B
-  W --> TR
-  W --> BR
-  W --> MCP
-  W --> A
-  classDef agent fill:#8B0000,color:#fff
-  classDef tool fill:#189AB4,color:#fff
-  class A agent
-  class W agent
-  class C tool
-  class B tool
-  class TR tool
-  class BR tool
-  class MCP tool
-</pre></div>
-<!-- /wp:merpress/mermaidjs -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Seven-package stack</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>praisonaiagents → praisonai-code + praisonai-bot + praisonai-train + praisonai-browser + praisonai-mcp → praisonai (wrapper)</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Each Tier-2 package is installable standalone with its own console script. The wrapper pins all of them and preserves every old import path via shims. Use the wrapper when you need several surfaces together — HTTP serve, dashboard, framework YAML, jobs/recipe — without managing tier pins yourself.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Product catalog (C0–C12 shipped)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Package</th><th>Epic</th><th>Choose this when…</th><th>Standalone install</th></tr></thead><tbody><tr><td><code>praisonaiagents</code></td><td>Tier 1</td><td>Building or embedding agents in code — Agent, tools, memory, hooks</td><td><code>pip install praisonaiagents</code></td></tr><tr><td><code>praisonai-code</code></td><td>C0–C8</td><td>Terminal agentic CLI — run, chat, code, warm daemon</td><td><code>pip install praisonai-code</code></td></tr><tr><td><code>praisonai-bot</code></td><td>C9</td><td>Messaging bots + WebSocket gateway</td><td><code>pip install "praisonai-bot[gateway,bot]"</code></td></tr><tr><td><code>praisonai-train</code></td><td>C10</td><td>Agent training loops + GPU LLM fine-tuning</td><td><code>pip install praisonai-train</code> or <code>[llm]</code></td></tr><tr><td><code>praisonai-browser</code></td><td>C11</td><td>Chrome extension bridge, CDP, Playwright agents</td><td><code>pip install "praisonai-browser[all]"</code></td></tr><tr><td><code>praisonai-mcp</code></td><td>C12</td><td>MCP server for Cursor, Claude Desktop, Windsurf</td><td><code>pip install "praisonai-mcp[all]"</code></td></tr><tr><td><code>praisonai</code></td><td>Tier 3</td><td>Full product / umbrella — serve, dashboard, frameworks, jobs</td><td><code>pip install praisonai</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Three-layer products (do not conflate)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Product</th><th>Layer 1 (agents)</th><th>Layer 2 (dedicated pkg)</th><th>Layer 3 (wrapper)</th></tr></thead><tbody><tr><td>Browser</td><td><code>tools/protocols/browser.py</code></td><td><code>praisonai-browser</code></td><td>shims + optional full stack</td></tr><tr><td>MCP</td><td><code>praisonaiagents/mcp</code> client + light server</td><td><code>praisonai-mcp</code> heavy host</td><td>capability bodies via <code>_wrapper_bridge</code></td></tr><tr><td>Bots</td><td>bots/gateway protocols</td><td><code>praisonai-bot</code></td><td>shims only</td></tr><tr><td>Train</td><td>Agent + hooks in agents</td><td><code>praisonai-train</code></td><td>shims + <code>setup-conda-env</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Install matrix</h2>
-<!-- /wp:heading -->
-
-<!-- wp:paragraph -->
-<p>1. Base install (full seven-package stack)</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>pip install praisonai
-export OPENAI_API_KEY=sk-...
-
-praisonai doctor
-praisonai version show</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>2. Targeted extras</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>pip install "praisonai[claw]"      # dashboard + bots + gateway
-pip install "praisonai[all]"       # onboarding + messaging + search stack
-pip install "praisonai[train]"     # LLM fine-tuning (Unsloth stack)
-pip install "praisonai[mcp]"       # full MCP server host
-pip install "praisonai[browser]"   # extension bridge + CDP + Playwright
-pip install "praisonai[crewai]"    # multi-framework YAML</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Package</th><th>Min version (wrapper pin)</th><th>Console script</th></tr></thead><tbody><tr><td><code>praisonaiagents</code></td><td>≥ 1.6.153</td><td>—</td></tr><tr><td><code>praisonai-code</code></td><td>≥ 0.0.49</td><td><code>praisonai-code</code></td></tr><tr><td><code>praisonai-bot</code></td><td>≥ 0.0.34</td><td><code>praisonai-bot</code></td></tr><tr><td><code>praisonai-train</code></td><td>≥ 0.0.5</td><td><code>praisonai-train</code></td></tr><tr><td><code>praisonai-browser</code></td><td>≥ 0.0.2</td><td><code>praisonai-browser</code></td></tr><tr><td><code>praisonai-mcp</code></td><td>≥ 0.0.2</td><td><code>praisonai-mcp</code></td></tr><tr><td><code>praisonai</code></td><td>4.6.150</td><td><code>praisonai</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:separator -->
-<hr class="wp-block-separator has-alpha-channel-opacity"/>
-<!-- /wp:separator -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 1 — What wrapper adds (not in Tier-2 alone)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Feature</th><th>Command / path</th><th>Owner</th><th>Extracted?</th></tr></thead><tbody><tr><td>Unified CLI router</td><td><code>praisonai …</code></td><td>code Typer + 6 resident registries</td><td>—</td></tr><tr><td>HTTP serve orchestration</td><td><code>praisonai serve agents|recipe|a2a|…</code></td><td>wrapper <code>cli/features/serve.py</code></td><td>Deferred (C15 epic)</td></tr><tr><td>Dashboard launcher</td><td><code>praisonai dashboard</code></td><td>wrapper</td><td>Stay wrapper</td></tr><tr><td>Framework adapters</td><td><code>praisonai --framework crewai</code></td><td>wrapper <code>framework_adapters/</code></td><td>Stay wrapper (impls in external PraisonAI-Frameworks)</td></tr><tr><td>Jobs API</td><td><code>praisonai.jobs</code> · port 8005</td><td>wrapper</td><td>Deferred (with serve/recipe)</td></tr><tr><td>Recipe NL → YAML</td><td><code>praisonai recipe …</code></td><td>wrapper</td><td>Deferred</td></tr><tr><td>Scheduler CLI</td><td><code>praisonai schedule …</code></td><td>wrapper</td><td>Stay wrapper (3-layer split with bot)</td></tr><tr><td>Sandbox execution</td><td><code>praisonai sandbox …</code></td><td>wrapper <code>sandbox/</code></td><td>C13 candidate</td></tr><tr><td>Cloud deploy</td><td><code>praisonai deploy …</code></td><td>wrapper <code>deploy/</code></td><td>C13 candidate</td></tr><tr><td>Langfuse / Langflow / n8n</td><td><code>langfuse</code>, <code>flow</code>, <code>n8n</code></td><td>wrapper</td><td>Stay wrapper</td></tr><tr><td>Backward-compat shims</td><td><code>praisonai.bots</code> → <code>praisonai_bot</code></td><td>wrapper <code>cli/_shim.py</code></td><td>Permanent</td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:paragraph -->
-<p>Tier-2 packages own their domains; the wrapper owns integration surfaces that span multiple tiers.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 2 — Terminal hot path (via code tier)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>pip install praisonai
-export OPENAI_API_KEY=sk-...
-
-praisonai run "Summarise the latest AI agent trends"
-praisonai chat
-praisonai code
-praisonai daemon start --background
-praisonai run "Hello"   # auto-forwards to warm runtime</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code># Python SDK (Tier 1 — same everywhere)
-from praisonaiagents import Agent
-agent = Agent(instructions="You are a helpful AI assistant")
-agent.start("Write a movie script about a robot on Mars")</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Deep dive: <a href="https://mer.vin/2026/07/praisonai-code-praisonai-code-terminal-cli-in-depth/">praisonai-code in-depth</a></p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 3 — Train (via praisonai-train tier)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code># LLM fine-tuning (Unsloth) — lazy ML deps
-praisonai train llm dataset.json
-praisonai train llm --model llama-3.1 dataset.json
-
-# Agent training — LLM-as-judge
-praisonai train agents --input "What is Python?" --iterations 3
-
-# Human feedback loop
-praisonai train agents --input "Explain quantum computing" --human
-
-# Session management
-praisonai train list
-praisonai train apply train-abc123 --run "And Germany?"
-
-# Standalone script (no wrapper prefix)
-praisonai-train agents --input "Hello" --iterations 2</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Deep dive: <a href="https://mer.vin/2026/07/praisonai-train-praisonai-train-fine-tuning-agent-training-in-depth/">praisonai-train in-depth</a></p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 4 — Bots &amp; gateway (via bot tier)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>pip install "praisonai[bot]"
-export OPENAI_API_KEY=sk-...
-export TELEGRAM_BOT_TOKEN=...
-
-praisonai onboard
-praisonai bot start --platform telegram
-praisonai gateway start --config ~/.praisonai/bot.yaml
-praisonai gateway install --config ~/.praisonai/bot.yaml
-praisonai pairing approve telegram ABC12345</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Deep dive: <a href="https://mer.vin/2026/07/praisonai-bot-praisonai-bot-gateway-channels-in-depth/">praisonai-bot in-depth</a></p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 5 — MCP server host (via mcp tier)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Command</th><th>Layer</th><th>Package</th></tr></thead><tbody><tr><td><code>praisonai serve mcp</code></td><td>Light server</td><td><code>praisonai-code</code> + agents</td></tr><tr><td><code>praisonai mcp serve</code></td><td>Heavy host</td><td><code>praisonai-mcp</code></td></tr><tr><td><code>praisonai-mcp serve</code></td><td>Heavy host (direct)</td><td><code>praisonai-mcp</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code># Heavy MCP host — full tool/resource/prompt registry
-praisonai mcp serve --transport stdio
-praisonai mcp serve --transport http-stream --port 8080 --api-key secret
-
-# Recipe → scoped MCP server
-praisonai mcp serve-recipe support-reply --transport stdio
-
-# Client config management (needs praisonai-code co-installed)
-praisonai mcp list
-praisonai mcp add filesystem --command npx --args "-y @modelcontextprotocol/server-filesystem ."
-
-# Generate Cursor / Claude Desktop config
-praisonai mcp config-generate --client cursor --transport stdio</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Deep dive: <a href="https://mer.vin/2026/07/praisonai-mcp-praisonai-mcp-server-host-client-config-in-depth/">praisonai-mcp in-depth</a></p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 6 — Browser automation (via browser tier)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>pip install "praisonai[browser]"
-
-# Extension bridge server + LLM browser agent
-praisonai browser start
-praisonai browser run "Find the latest Python release notes"
-
-# Diagnostics
-praisonai browser doctor
-
-# Lightweight tool shim (code tier — no praisonai-browser required)
-praisonai browser-tool snapshot https://example.com
-
-# Standalone script
-praisonai-browser start
-praisonai-browser run "Click the login button"</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Three layers: agents protocols → <code>praisonai browser-tool</code> (praisonai-tools) → <code>praisonai browser</code> (extension bridge, CDP, Playwright).</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:paragraph -->
-<p>Deep dive: <a href="https://mer.vin/2026/07/praisonai-browser-praisonai-browser-browser-automation-in-depth/">praisonai-browser in-depth</a></p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 7 — Dashboard stack</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>pip install "praisonai[claw,flow,ui]"
-
-# Individual services
-praisonai claw              # :8082 — ops dashboard
-praisonai flow              # :7861 — Langflow
-praisonai ui                # :8081 — clean chat
-
-# Unified launcher (wrapper-only)
-praisonai dashboard         # :3000
-praisonai dashboard --port 9000 --no-auto-start</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Port</th><th>Service</th></tr></thead><tbody><tr><td>3000</td><td>Dashboard hub</td></tr><tr><td>7860/7861</td><td>Langflow</td></tr><tr><td>8081</td><td>UI chat</td></tr><tr><td>8082</td><td>Claw</td></tr><tr><td>8765</td><td>Gateway WebSocket</td></tr><tr><td>8005</td><td>Jobs API</td></tr><tr><td>8080</td><td>MCP HTTP stream (optional)</td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 8 — Multi-framework YAML</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>pip install "praisonai[crewai]"
-export OPENAI_API_KEY=sk-...
-
-praisonai --framework crewai --auto "Create a movie script"
-praisonai run --file agents.yaml --framework crewai
-
-pip install "praisonai[autogen]"
-praisonai --framework autogen agents.yaml</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Protocols live in <code>praisonaiagents/frameworks/</code>; adapter implementations in wrapper <code>framework_adapters/</code>. Entry-point group: <code>praisonai.framework_adapters</code>.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 9 — Scheduler (24/7 agents)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>praisonai schedule add --agent my_agent.yaml --expr "hourly"
-praisonai schedule list
-praisonai schedule start</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code># Python
-from praisonai.scheduler import AgentScheduler
-from praisonaiagents import Agent
-
-agent = Agent(name="NewsChecker", instructions="Check latest AI news")
-scheduler = AgentScheduler(agent=agent, task="Summarise top 3 AI stories")
-scheduler.start("hourly", run_immediately=True)</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Three scheduler layers: job store (<code>praisonaiagents.scheduler</code>) → CLI (<code>praisonai schedule</code>, wrapper) → gateway tick delivery (<code>praisonai_bot.scheduler.executor</code>).</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 10 — Jobs API &amp; wrapper-only surfaces</h2>
-<!-- /wp:heading -->
-
-<!-- wp:paragraph -->
-<p>Jobs, recipe, serve, sandbox, and deploy remain wrapper-owned today (deferred or C13 candidates).</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code># Jobs API (wrapper — port 8005)
-python -m uvicorn praisonai.jobs.server:create_app --port 8005 --factory
-praisonai run submit "Analyse AI trends"
-praisonai run submit "Analyse news" --recipe news-analyzer --wait
-export PRAISONAI_JOBS_API_KEY=your-secret
-
-# HTTP serve (wrapper orchestration — Typer shell in code tier)
-praisonai serve agents --port 8080
-praisonai serve recipe support-reply
-
-# Sandbox / deploy (wrapper today — C13 extraction candidates)
-praisonai sandbox run "print hello" --backend docker
-praisonai deploy agents.yaml --provider aws</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 11 — Lazy CLI routing (six resident registries)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Registry</th><th>Count</th><th>Examples</th><th>Loaded from</th><th>Gate</th></tr></thead><tbody><tr><td>Code-resident</td><td>~40</td><td>run, chat, code, daemon, serve, config</td><td><code>praisonai_code.cli.commands.*</code></td><td>always</td></tr><tr><td>Bot-resident</td><td>8</td><td>bot, gateway, onboard, kanban, claw</td><td><code>praisonai_bot.cli.commands.*</code></td><td><code>bot_package_available()</code></td></tr><tr><td>Train-resident</td><td>1</td><td>train</td><td><code>praisonai_train.cli.commands.*</code></td><td><code>train_package_available()</code></td></tr><tr><td>Browser-resident</td><td>1</td><td>browser</td><td><code>praisonai_browser.cli.commands.*</code></td><td><code>browser_package_available()</code></td></tr><tr><td>MCP-resident</td><td>1</td><td>mcp</td><td><code>praisonai_mcp.cli.commands.*</code></td><td><code>mcp_package_available()</code></td></tr><tr><td>Wrapper-resident</td><td>22</td><td>dashboard, schedule, flow, langfuse, recipe</td><td><code>praisonai.cli.commands.*</code></td><td><code>wrapper_available()</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>praisonai --help    # 70+ commands, lazy-loaded
-praisonai doctor
-praisonai train --help
-praisonai mcp --help
-praisonai browser --help
-praisonai dashboard --help</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>Standalone <code>praisonai-code</code> hides bot/train/browser/mcp/wrapper commands from <code>--help</code> when those packages are absent.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 12 — Shim map (backward compat)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Old import / path</th><th>Canonical target</th></tr></thead><tbody><tr><td><code>praisonai.cli.main</code></td><td><code>praisonai_code.cli.main</code></td></tr><tr><td><code>praisonai.runtime.*</code></td><td><code>praisonai_code.runtime.*</code></td></tr><tr><td><code>praisonai.bots.*</code></td><td><code>praisonai_bot.bots.*</code></td></tr><tr><td><code>praisonai.gateway.*</code></td><td><code>praisonai_bot.gateway.*</code></td></tr><tr><td><code>praisonai.train.*</code></td><td><code>praisonai_train.train.*</code></td></tr><tr><td><code>praisonai.browser.*</code></td><td><code>praisonai_browser.*</code></td></tr><tr><td><code>praisonai.mcp_server.*</code></td><td><code>praisonai_mcp.mcp_server.*</code></td></tr><tr><td><code>praisonai.scheduler.executor</code></td><td><code>praisonai_bot.scheduler.executor</code></td></tr><tr><td><code>setup-conda-env</code></td><td><code>praisonai_train.setup.setup_conda_env</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code># These must keep working
-from praisonai.cli.main import PraisonAI
-from praisonai.bots import Bot
-from praisonai.gateway import WebSocketGateway
-from praisonai.train.agents import AgentTrainer
-from praisonai.mcp_server import MCPServer
-python -m praisonai run "hello"
-python -m praisonai.runtime</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Section 13 — Bridges (no PyPI cycles)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Bridge</th><th>Direction</th><th>Use</th></tr></thead><tbody><tr><td><code>_wrapper_bridge</code></td><td>code → wrapper</td><td>serve handlers, frameworks, jobs</td></tr><tr><td><code>_bot_bridge</code></td><td>code → bot</td><td>bot/gateway CLI routing</td></tr><tr><td><code>_train_bridge</code></td><td>code → train</td><td>train CLI routing</td></tr><tr><td><code>_browser_bridge</code></td><td>code → browser</td><td>browser CLI routing</td></tr><tr><td><code>_mcp_bridge</code></td><td>code → mcp</td><td>mcp CLI routing</td></tr><tr><td><code>_code_bridge</code></td><td>tier-2 → code</td><td>config kernel, legacy dispatch</td></tr><tr><td><code>_wrapper_bridge</code></td><td>tier-2 → wrapper</td><td>capabilities, recipe, jobs/UI</td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">When to use wrapper vs a Tier-2 package alone</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Your goal</th><th>Install</th></tr></thead><tbody><tr><td>Only terminal agents</td><td><code>praisonai-code</code> (+ optional <code>praisonaiagents</code>)</td></tr><tr><td>Only bots on Telegram/Slack</td><td><code>praisonai-bot</code></td></tr><tr><td>Only train / fine-tune</td><td><code>praisonai-train</code></td></tr><tr><td>Only automate browser</td><td><code>praisonai-browser</code></td></tr><tr><td>Only MCP server for IDE</td><td><code>praisonai-mcp</code></td></tr><tr><td>Several of the above + serve / dashboard / framework YAML</td><td><code>pip install praisonai</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">What stays in wrapper (not extracted)</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Surface</th><th>Why it stays</th></tr></thead><tbody><tr><td><code>dashboard</code> / <code>flow</code> / <code>ui</code></td><td>Langflow extra + launcher glue — not a standalone PyPI product</td></tr><tr><td><code>claw</code></td><td>Default app lives in <code>praisonai-bot</code>; wrapper is a thin shim</td></tr><tr><td><code>framework_adapters/</code></td><td>Thin registry; heavy impls in external PraisonAI-Frameworks</td></tr><tr><td><code>schedule</code> CLI</td><td>Three-layer split: agents store + wrapper CLI + bot executor</td></tr><tr><td><code>serve</code> / <code>recipe</code> / <code>jobs</code></td><td>~14k LOC deferred epic — high coupling (C15)</td></tr><tr><td><code>sandbox</code> / <code>deploy</code></td><td>Still in wrapper today; C13 extraction candidates</td></tr><tr><td><code>standardise</code> / suite runner</td><td>Maintainer/docs tooling — internal only</td></tr><tr><td><code>persist</code> / enterprise adapters</td><td><strong>Rejected</strong> — agents already ship File/SQLite defaults; no crisp standalone story</td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Roadmap — C13+ candidates</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Package</th><th>Status</th><th>Choose when…</th><th>Standalone install (planned)</th></tr></thead><tbody><tr><td><code>praisonai-sandbox</code></td><td><strong>C13 preferred</strong> (execution goal)</td><td>Isolated agent code execution — Docker/E2B/Modal/Daytona/Sandlock</td><td><code>pip install praisonai-sandbox[docker]</code></td></tr><tr><td><code>praisonai-deploy</code></td><td><strong>C13 alt</strong> (deploy goal)</td><td>Ship <code>agents.yaml</code> to Docker/AWS/GCP/Azure</td><td><code>pip install praisonai-deploy</code></td></tr><tr><td><code>praisonai-replay</code></td><td>Conditional C14+</td><td>Deterministic replay from run ledger / traces</td><td>After product sign-off</td></tr><tr><td><code>praisonai-serve</code></td><td>Deferred C15</td><td>HTTP API hosting without full umbrella (~14k LOC)</td><td>With recipe/jobs decision</td></tr><tr><td><code>praisonai-recipe</code></td><td>Deferred</td><td>NL → agent YAML without jobs UI</td><td>Tied to jobs + serve</td></tr><tr><td><code>praisonai-jobs</code></td><td>Deferred</td><td>Async long-running agent jobs API</td><td>Extract with serve or stay wrapper</td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:paragraph -->
-<p>C13 decision rule: <strong>sandbox</strong> = where code runs; <strong>deploy</strong> = where the agent service lives. Ship one first after product sign-off.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Standalone extraction litmus test</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Criterion</th><th>Pass (browser/MCP)</th><th>Fail (example)</th></tr></thead><tbody><tr><td>Named user goal without full <code>praisonai</code></td><td><code>pip install praisonai-browser</code> → automate Chrome</td><td><code>pip install praisonai-persist</code> → ???</td></tr><tr><td>Coherent product boundary</td><td>One Typer group / one console script</td><td>Whole <code>cli/features/</code> orchestration layer</td></tr><tr><td>PyPI deps: <code>praisonaiagents</code> only</td><td>Tier-2 + lazy <code>_wrapper_bridge</code></td><td>Hard <code>import praisonai</code> at module level</td></tr><tr><td>Worth a separate install</td><td>User who never wants dashboard/serve/bots</td><td>Internal docs tooling</td></tr><tr><td>Extraction shape</td><td>C10 single PR (~3–11k LOC)</td><td>Mega-epic without product sign-off</td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">When to use which tier</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Scenario</th><th>Install</th></tr></thead><tbody><tr><td>Pure Python agents, minimal deps</td><td><code>pip install praisonaiagents</code></td></tr><tr><td>Terminal coding agent, CI, headless</td><td><code>pip install praisonai-code</code></td></tr><tr><td>Telegram/Discord gateway only</td><td><code>pip install "praisonai-bot[gateway,bot]"</code></td></tr><tr><td>Agent training (no GPU)</td><td><code>pip install praisonai-train</code></td></tr><tr><td>LLM fine-tuning (GPU)</td><td><code>pip install "praisonai-train[llm]"</code></td></tr><tr><td>MCP server for Cursor/Claude</td><td><code>pip install "praisonai-mcp[all]"</code></td></tr><tr><td>Browser automation (extension/CDP)</td><td><code>pip install "praisonai-browser[all]"</code></td></tr><tr><td>CrewAI/AutoGen YAML</td><td><code>pip install "praisonai[crewai]"</code></td></tr><tr><td>Full ops + channels + dashboard</td><td><code>pip install "praisonai[claw]"</code></td></tr><tr><td>Everything in one install</td><td><code>pip install praisonai</code></td></tr><tr><td>Library author / embedding</td><td><code>praisonaiagents</code> only</td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Seven-package publish order</h2>
-<!-- /wp:heading -->
-
-<!-- wp:code -->
-<pre class="wp-block-code"><code>praisonaiagents
-  → praisonai-code + praisonai-bot + praisonai-train + praisonai-browser + praisonai-mcp
-  → praisonai (wrapper pins all tier-2 deps last)</code></pre>
-<!-- /wp:code -->
-
-<!-- wp:paragraph -->
-<p>CI: <code>.github/workflows/pypi-release.yml</code> · selective publish: <code>publish_all.py --changed-only</code> (default). Playbook per package: manifest → TDD compat tests → git mv → shims → <code>_X_RESIDENT_COMMANDS</code> → CI shard → PyPI.</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:heading -->
-<h2 class="wp-block-heading">Summary</h2>
-<!-- /wp:heading -->
-
-<!-- wp:table -->
-<figure class="wp-block-table"><table><thead><tr><th>Item</th><th>Value</th></tr></thead><tbody><tr><td>Tier</td><td>3 (integration wrapper)</td></tr><tr><td>PyPI</td><td><code>praisonai</code> v4.6.150</td></tr><tr><td>Shipped tier-2 deps</td><td>code, bot, train, browser, mcp (C0–C12)</td></tr><tr><td>Resident registries</td><td>6 (code + bot + train + browser + mcp + wrapper)</td></tr><tr><td>Wrapper-only (~140k LOC)</td><td>serve, recipe, jobs, dashboard, sandbox, deploy, frameworks</td></tr><tr><td>Next extraction</td><td>C13: sandbox or deploy (product sign-off)</td></tr><tr><td>One-liner still works</td><td><code>pip install praisonai</code></td></tr></tbody></table></figure>
-<!-- /wp:table -->
-
-<!-- wp:paragraph -->
-<p>Architecture overview: Seven-package C7–C12 extraction · Post-C12 roadmap (C13+)</p>
-<!-- /wp:paragraph -->
-
-<!-- wp:paragraph -->
-<p>Series: <a href="https://mer.vin/2026/07/praisonai-code-praisonai-code-terminal-cli-in-depth/">praisonai-code</a> · <a href="https://mer.vin/2026/07/praisonai-bot-praisonai-bot-gateway-channels-in-depth/">praisonai-bot</a> · <a href="https://mer.vin/2026/07/praisonai-train-praisonai-train-fine-tuning-agent-training-in-depth/">praisonai-train</a> · <a href="https://mer.vin/2026/07/praisonai-browser-praisonai-browser-browser-automation-in-depth/">praisonai-browser</a> · <a href="https://mer.vin/2026/07/praisonai-mcp-praisonai-mcp-server-host-client-config-in-depth/">praisonai-mcp</a> · praisonai wrapper</p>
-<!-- /wp:paragraph -->

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

@@ -222,12 +222,10 @@ runs:
 
         STEP 2 — ARCHITECTURE VALIDATION & ROUTING (MANDATORY before writing code):
         Before implementing anything, answer these questions:
-        - CORE vs WRAPPER vs TOOLS vs PLUGINS ROUTING:
+        - CORE vs WRAPPER vs TOOLS 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).
+          3. Tools (PraisonAI-Tools): Specific integrations, external tools (e.g. SurrealDB, Slack), and community extensions MUST go to the `MervinPraison/PraisonAI-Tools` repository. If the feature is a tool, clone `https://github.com/MervinPraison/PraisonAI-Tools`, implement it there, and create the PR using `gh pr create -R MervinPraison/PraisonAI-Tools`.
         - 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.

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

@@ -1,5 +1,5 @@
 name: Install PraisonAI monorepo packages
-description: Install praisonai-agents, praisonai-code, praisonai-bot, praisonai-train, praisonai-browser, praisonai-mcp, praisonai-sandbox, and praisonai wrapper from local paths (mirrors PyPI eight-package install order).
+description: Install praisonai-agents, praisonai-code, and praisonai wrapper from local paths (mirrors PyPI three-package install order).
 
 inputs:
   repo-root:
@@ -36,10 +36,6 @@ runs:
         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"
         WRAPPER_PKG="${BASE}src/praisonai"
 
         normalise_extras() {
@@ -61,14 +57,6 @@ runs:
           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 "$WRAPPER_PKG"
           uv pip install --system "${WRAPPER_SUFFIX}"
         else
@@ -78,14 +66,6 @@ runs:
           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 "$WRAPPER_PKG"
           pip install -e "${WRAPPER_SUFFIX}"
         fi

.github/praisonai-issue-triage.yaml

@@ -34,17 +34,11 @@ steps:
 
       Third, read architecture guidelines: execute_command 'cat src/praisonai-agents/AGENTS.md'.
 
-      Fourth, decide routing before planning:
-      - 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 only for protocols and CLI — external repos for Tools/Plugins.
-
-      Fifth, decide if this issue requires code changes:
+      Fourth, 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 / Tools-external / Plugins-external / No-change), validation result, and exact files/lines to change.
+      Output: routing decision (Core SDK / Wrapper / Tools / 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

.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

@@ -27,75 +27,6 @@ const withRecovery = [
 ];
 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();
@@ -151,40 +82,6 @@ assert('verdict after head accepted', mg.findMergeGateVerdict(
   '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));
 

.github/scripts/merge-gate.js

@@ -41,11 +41,6 @@ const BLOCK_LABELS = new Set([
   'no-auto-merge',
   'auto-merged-by-gate',
 ]);
-const MERGE_READY_LABEL = 'pipeline/merge-ready';
-/** Superseded concurrency runs; must not block merge when real tests passed. */
-const OPTIONAL_CANCELLED_CHECKS = new Set(['detect-and-trigger']);
-/** Cancelled smoke/windows after timeout are non-blocking when core shards passed on HEAD. */
-const OPTIONAL_CANCELLED_WHEN_CORE_GREEN = new Set(['smoke', 'test-windows']);
 const BOT_REVIEWER_PATTERNS = [
   'coderabbit',
   'qodo',
@@ -72,12 +67,6 @@ function isClaudeTriggerNoise(c) {
   return false;
 }
 
-function isClaudeFinalReplyComment(c) {
-  const login = (c.user?.login || '').toLowerCase();
-  if (!login.includes('praisonai-triage')) return false;
-  return (c.body || '').includes('Claude finished');
-}
-
 function hasRecentClaudeTrigger(comments, minutes = 35) {
   const cutoff = Date.now() - minutes * 60 * 1000;
   return comments.some((c) => {
@@ -186,11 +175,6 @@ function isStaleFinalAfterPush(comments, headPushedAt) {
   );
   const finalTime = new Date(latestFinal.created_at).getTime();
   if (headTime <= finalTime + 60000) return false;
-  const claudeRepliedAfterFinal = comments.some((c) => {
-    if (!isClaudeFinalReplyComment(c)) return false;
-    return new Date(c.created_at).getTime() >= finalTime - 60000;
-  });
-  if (claudeRepliedAfterFinal) return false;
   const claudeSinceHead = comments.some((c) => {
     if (!CLAUDE_TRIGGER_LOGINS.includes(c.user.login)) return false;
     if (isClaudeTriggerNoise(c)) return false;
@@ -269,7 +253,7 @@ function finalClaudeCompletedOnSha(comments, headPushedAt) {
 }
 
 const FINAL_CLAUDE_REVIEW_BODY =
-  '@claude You are the FINAL architecture reviewer. If the branch is under MervinPraison/PraisonAI (not a fork), you are able to make modifications to this branch and push directly. SCOPE: Focus ONLY on Python packages (praisonaiagents, praisonai). Do NOT modify praisonai-rust or praisonai-ts. Read ALL comments above from Gemini, Qodo, CodeRabbit, and Copilot carefully before responding.\n\n**Phase 1: Review per AGENTS.md**\n1. Protocol-driven: check heavy implementations vs core SDK\n2. Backward compatible: ensure zero feature regressions\n3. Performance: no hot-path regressions\n4. SDK value: review in depth whether the change genuinely adds value to the SDK — never add features for the sake of adding them. It must strengthen the SDK (simpler, more user-friendly, robust, world-class, secure). If it does not clearly add value, request changes or recommend rejecting/closing rather than merging scope creep\n5. Do not bloat the Agent class with additional params — only if absolutely required; we already support many params.\n6. Repo routing: agent-callable tools → PraisonAI-Tools; lifecycle plugins → PraisonAI-Plugins; optional sandbox backends → PraisonAI-Plugins (`praisonai.sandbox` entry point) — request changes if wrongly added to praisonaiagents/\n\n**Phase 2: FIX Valid Issues**\n7. For any VALID bugs or architectural flaws found by Gemini, CodeRabbit, Qodo, Copilot, or any other reviewer: implement the fix\n8. Also independently identify and fix any gaps or issues you find in the changed code — do not rely only on prior reviewer feedback\n9. Push all code fixes directly to THIS branch (do NOT create a new PR)\n10. Comment a summary of exact files modified and what you skipped\n\n**Phase 3: Final Verdict**\n11. If all issues are resolved, approve the PR / close the Issue\n12. If blocking issues remain, request changes / leave clear action items';
+  '@claude You are the FINAL architecture reviewer. If the branch is under MervinPraison/PraisonAI (not a fork), you are able to make modifications to this branch and push directly. SCOPE: Focus ONLY on Python packages (praisonaiagents, praisonai). Do NOT modify praisonai-rust or praisonai-ts. Read ALL comments above from Gemini, Qodo, CodeRabbit, and Copilot carefully before responding.\n\n**Phase 1: Review per AGENTS.md**\n1. Protocol-driven: check heavy implementations vs core SDK\n2. Backward compatible: ensure zero feature regressions\n3. Performance: no hot-path regressions\n4. SDK value: review in depth whether the change genuinely adds value to the SDK — never add features for the sake of adding them. It must strengthen the SDK (simpler, more user-friendly, robust, world-class, secure). If it does not clearly add value, request changes or recommend rejecting/closing rather than merging scope creep\n5. Do not bloat the Agent class with additional params — only if absolutely required; we already support many params.\n\n**Phase 2: FIX Valid Issues**\n5. For any VALID bugs or architectural flaws found by Gemini, CodeRabbit, Qodo, Copilot, or any other reviewer: implement the fix\n6. Push all code fixes directly to THIS branch (do NOT create a new PR)\n7. Comment a summary of exact files modified and what you skipped\n\n**Phase 3: Final Verdict**\n8. If all issues are resolved, approve the PR / close the Issue\n9. If blocking issues remain, request changes / leave clear action items';
 
 async function getMergeState(github, owner, repo, prNumber) {
   const query = `
@@ -310,87 +294,14 @@ async function getMergeState(github, owner, repo, prNumber) {
   };
 }
 
-async function listChecksOnSha(github, owner, repo, sha) {
+async function allChecksGreenOnSha(github, owner, repo, sha, core) {
   const { data } = await github.rest.checks.listForRef({
     owner,
     repo,
     ref: sha,
     per_page: 100,
   });
-  return (data.check_runs || []).filter((r) => r.head_sha === sha);
-}
-
-function listFailedChecksOnSha(runs) {
-  return (runs || []).filter((run) => {
-    if (run.status !== 'completed') return false;
-    return run.conclusion === 'failure';
-  });
-}
-
-function isCoreTestRun(run) {
-  const name = run?.name || '';
-  return name === 'test-core' || name.startsWith('test-core ') || name === 'test-core-collect';
-}
-
-function coreTestsGreenOnRuns(runs) {
-  const coreRuns = (runs || []).filter(isCoreTestRun);
-  if (coreRuns.length === 0) return false;
-  return coreRuns.every(
-    (run) =>
-      run.status === 'completed' &&
-      ['success', 'neutral', 'skipped'].includes(run.conclusion)
-  );
-}
-
-function checkConclusionRank(conclusion) {
-  if (conclusion === 'success') return 4;
-  if (conclusion === 'neutral') return 3;
-  if (conclusion === 'skipped') return 2;
-  if (conclusion === 'cancelled') return 1;
-  return 0;
-}
-
-function isPendingRun(run) {
-  return !!(run && run.status && run.status !== 'completed');
-}
-
-function bestRunsByName(runs) {
-  const byName = new Map();
-  for (const run of runs || []) {
-    if (!run) continue;
-    const existing = byName.get(run.name);
-    if (!existing) {
-      byName.set(run.name, run);
-      continue;
-    }
-    const runPending = isPendingRun(run);
-    const existingPending = isPendingRun(existing);
-    if (existingPending) continue;
-    if (
-      runPending ||
-      checkConclusionRank(run.conclusion) > checkConclusionRank(existing.conclusion)
-    ) {
-      byName.set(run.name, run);
-    }
-  }
-  return [...byName.values()];
-}
-
-function isAcceptableCheckConclusion(run, runs) {
-  if (['success', 'neutral', 'skipped'].includes(run.conclusion)) return true;
-  if (run.conclusion === 'cancelled' && OPTIONAL_CANCELLED_CHECKS.has(run.name)) return true;
-  if (
-    run.conclusion === 'cancelled' &&
-    OPTIONAL_CANCELLED_WHEN_CORE_GREEN.has(run.name) &&
-    coreTestsGreenOnRuns(runs)
-  ) {
-    return true;
-  }
-  return false;
-}
-
-async function allChecksGreenOnSha(github, owner, repo, sha, core) {
-  const runs = bestRunsByName(await listChecksOnSha(github, owner, repo, sha));
+  const runs = (data.check_runs || []).filter((r) => r.head_sha === sha);
   if (runs.length === 0) {
     core?.info?.(`No check runs on ${sha.slice(0, 7)} — allowing (e.g. docs-only PR)`);
     return true;
@@ -400,17 +311,11 @@ async function allChecksGreenOnSha(github, owner, repo, sha, core) {
       core?.info?.(`Check pending: ${run.name} (${run.status})`);
       return false;
     }
-    if (!isAcceptableCheckConclusion(run, runs)) {
+    const ok = ['success', 'neutral', 'skipped'].includes(run.conclusion);
+    if (!ok) {
       core?.info?.(`Check failed: ${run.name} (${run.conclusion})`);
       return false;
     }
-    if (
-      run.conclusion === 'cancelled' &&
-      OPTIONAL_CANCELLED_WHEN_CORE_GREEN.has(run.name) &&
-      coreTestsGreenOnRuns(runs)
-    ) {
-      core?.info?.(`Ignoring cancelled ${run.name} — test-core green on HEAD`);
-    }
   }
   return true;
 }
@@ -804,67 +709,10 @@ async function evaluatePipelineQuiescent(github, owner, repo, prNumber, core, op
   };
 }
 
-async function listPrNumbersForMergeGateScan(github, owner, repo, core) {
-  let mergeReadyIssues;
-  if (typeof github.paginate === 'function') {
-    mergeReadyIssues = await github.paginate(github.rest.issues.listForRepo, {
-      owner,
-      repo,
-      state: 'open',
-      labels: MERGE_READY_LABEL,
-      per_page: 100,
-    });
-  } else {
-    ({ data: mergeReadyIssues } = await github.rest.issues.listForRepo({
-      owner,
-      repo,
-      state: 'open',
-      labels: MERGE_READY_LABEL,
-      per_page: 100,
-    }));
-  }
-  const mergeReady = mergeReadyIssues
-    .filter((issue) => issue.pull_request)
-    .map((issue) => issue.number)
-    .sort((a, b) => a - b);
-
-  if (mergeReady.length > 0) {
-    core?.info?.(
-      `Merge gate scan: ${mergeReady.length} ${MERGE_READY_LABEL} PR(s) (skipping unlabelled open PRs)`
-    );
-    return mergeReady;
-  }
-
-  core?.info?.(`No ${MERGE_READY_LABEL} PRs — scanning oldest open PRs`);
-  const prs =
-    typeof github.paginate === 'function'
-      ? await github.paginate(github.rest.pulls.list, {
-          owner,
-          repo,
-          state: 'open',
-          per_page: 100,
-          sort: 'created',
-          direction: 'asc',
-        })
-      : (await github.rest.pulls.list({
-          owner,
-          repo,
-          state: 'open',
-          per_page: 100,
-          sort: 'created',
-          direction: 'asc',
-        })).data;
-  return prs.map((pr) => pr.number);
-}
-
 async function selectMergeGateCandidates(github, owner, repo, prNumbers, maxCandidates, core) {
   const readyList = [];
   const skipped = [];
   for (const num of prNumbers) {
-    if (readyList.length >= maxCandidates) {
-      core?.info?.(`Found ${maxCandidates} candidate(s) — skipping remaining PR scans`);
-      break;
-    }
     const result = await evaluatePipelineQuiescent(github, owner, repo, num, core);
     if (result.ready) {
       readyList.push({ pr_number: num, head_sha: result.headSha });
@@ -879,20 +727,12 @@ async function selectMergeGateCandidates(github, owner, repo, prNumbers, maxCand
   };
 }
 
-const AUTOMATED_FALLBACK_MARKER = 'Automated fallback —';
-
-function isAutomatedFallbackVerdict(body) {
-  return (body || '').includes(AUTOMATED_FALLBACK_MARKER);
-}
-
-function findMergeGateVerdict(comments, minCreatedAt = null, headPushedAt = null, options = {}) {
-  const { excludeAutomatedFallback = false } = options || {};
+function findMergeGateVerdict(comments, minCreatedAt = null, headPushedAt = null) {
   const minTime = minCreatedAt ? new Date(minCreatedAt).getTime() : 0;
   const headTime = headPushedAt ? new Date(headPushedAt).getTime() - 60000 : 0;
   const gateComments = comments
     .filter((c) => {
       if (!(c.body || '').includes('MERGE_GATE_VERDICT:')) return false;
-      if (excludeAutomatedFallback && isAutomatedFallbackVerdict(c.body)) return false;
       const created = new Date(c.created_at).getTime();
       if (minTime && created < minTime) return false;
       if (headTime && created < headTime) return false;
@@ -911,7 +751,6 @@ module.exports = {
   AUTO_ACTORS,
   isFinalClaudeTriggerComment,
   isClaudeTriggerNoise,
-  isClaudeFinalReplyComment,
   hasRecentClaudeTrigger,
   hasRecentConflictComment,
   isConflictRebaseTriggerComment,
@@ -922,15 +761,6 @@ module.exports = {
   hasFinalClaudeReviewTrigger,
   finalClaudeCompletedOnSha,
   getMergeState,
-  OPTIONAL_CANCELLED_CHECKS,
-  OPTIONAL_CANCELLED_WHEN_CORE_GREEN,
-  isCoreTestRun,
-  coreTestsGreenOnRuns,
-  isPendingRun,
-  bestRunsByName,
-  isAcceptableCheckConclusion,
-  listChecksOnSha,
-  listFailedChecksOnSha,
   allChecksGreenOnSha,
   hasInProgressClaudeAssistant,
   claudeRunBlocksPr,
@@ -967,10 +797,6 @@ module.exports = {
   FINAL_CLAUDE_REVIEW_BODY,
   loadPrContext,
   evaluatePipelineQuiescent,
-  MERGE_READY_LABEL,
-  listPrNumbersForMergeGateScan,
   selectMergeGateCandidates,
-  isAutomatedFallbackVerdict,
-  AUTOMATED_FALLBACK_MARKER,
   findMergeGateVerdict,
 };

.github/scripts/pipeline-status.js

@@ -5,7 +5,6 @@
 
 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 = [
@@ -156,18 +155,6 @@ async function syncPipelineLabels(github, owner, repo, prNumber, core) {
   }
 
   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,

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

@@ -81,31 +81,4 @@ assert(
   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

@@ -16,7 +16,6 @@ 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();
@@ -76,23 +75,11 @@ function priorReviewerStatus(comments, reviews = []) {
 
 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 };
   }
 
@@ -170,13 +157,8 @@ function claudeFinalReady(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,
-    };
+  if (isSkipCopilot(options)) {
+    return { ready: true, reason: 'copilot skipped', copilotSkipped: true };
   }
   const copilot = copilotReviewReady(comments, reviews);
   if (copilot.ready) {
@@ -209,7 +191,6 @@ async function maybeTriggerClaudeFinal(github, owner, repo, prNumber, finalBody,
   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,
@@ -224,11 +205,7 @@ async function maybeTriggerClaudeFinal(github, owner, repo, prNumber, finalBody,
     issue_number: prNumber,
     body: finalBody,
   });
-  const note = gate.requiredTimeout
-    ? ' (required reviewer timeout fallback)'
-    : gate.copilotSkipped
-      ? ' (Copilot timeout fallback)'
-      : '';
+  const note = gate.copilotSkipped ? ' (Copilot timeout fallback)' : '';
   core?.info?.(`Posted Claude FINAL on PR #${prNumber}${note}`);
   return { posted: true, reason: '' };
 }
@@ -304,7 +281,6 @@ module.exports = {
   isSkipCopilot,
   REQUIRED_PRIOR,
   OPTIONAL_PRIOR,
-  REQUIRED_PRIOR_WAIT_MS,
   COPILOT_REVIEW_BODY,
   priorReviewerStatus,
   priorReviewersReady,

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

@@ -12,46 +12,9 @@ assert.ok(versions.currentWrapper);
 assert.ok(versions.targetCode);
 assert.ok(rg.PACKAGE_PATHS.includes('src/praisonai-code'));
 
-const noonUtc = new Date('2026-07-08T12:00:00Z');
-const dayStart = rg.utcDayStart(noonUtc);
-assert.strictEqual(dayStart.toISOString(), '2026-07-08T00:00:00.000Z');
-
 (async () => {
   assert.strictEqual(await rg.pypiVersionExists('praisonaiagents', '0.0.0'), false);
-
-  const mockGithub = {
-    rest: {
-      actions: {
-        listWorkflowRuns: async () => ({
-          data: {
-            workflow_runs: [
-              {
-                conclusion: 'success',
-                created_at: '2026-07-08T09:00:00Z',
-                status: 'completed',
-              },
-            ],
-          },
-        }),
-      },
-    },
-  };
-  assert.strictEqual(
-    await rg.hasSuccessfulReleaseToday(mockGithub, 'o', 'r', noonUtc),
-    true
-  );
-
-  const result = await rg.evaluateReleasePreflight(
-    mockGithub, 'o', 'r',
-    { headSha: 'abc', isCiTrigger: false, bump: 'patch', now: noonUtc },
-    null
-  );
-  assert.ok(result.reasons.some((r) => r.includes('already released today')));
-
   console.log('ok: bumpPatch');
   console.log('ok: readVersionsFromTree');
   console.log('ok: pypiVersionExists missing version');
-  console.log('ok: utcDayStart');
-  console.log('ok: hasSuccessfulReleaseToday');
-  console.log('ok: daily dedupe blocks second release');
 })();

.github/scripts/release-gate.js

@@ -75,24 +75,6 @@ async function hasActiveReleaseRun(github, owner, repo) {
   );
 }
 
-function utcDayStart(now = new Date()) {
-  return new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
-}
-
-async function hasSuccessfulReleaseToday(github, owner, repo, now = new Date()) {
-  const dayStart = utcDayStart(now);
-  const runs = await github.rest.actions.listWorkflowRuns({
-    owner,
-    repo,
-    workflow_id: 'pypi-release.yml',
-    status: 'completed',
-    per_page: 30,
-  });
-  return runs.data.workflow_runs.some(
-    (r) => r.conclusion === 'success' && new Date(r.created_at) >= dayStart
-  );
-}
-
 async function lastGreenCoreTestsSha(github, owner, repo) {
   const runs = await github.rest.actions.listWorkflowRuns({
     owner,
@@ -134,13 +116,6 @@ async function evaluateReleasePreflight(github, owner, repo, options, core) {
     return out;
   }
 
-  const referenceTime = options.now instanceof Date ? options.now : new Date();
-  if (await hasSuccessfulReleaseToday(github, owner, repo, referenceTime)) {
-    const day = referenceTime.toISOString().slice(0, 10);
-    reasons.push(`already released today (UTC ${day}); max one patch release per day`);
-    return out;
-  }
-
   let versions;
   try {
     versions = readVersionsFromTree();
@@ -222,8 +197,6 @@ module.exports = {
   bumpPatch,
   readVersionsFromTree,
   pypiVersionExists,
-  hasSuccessfulReleaseToday,
-  utcDayStart,
   evaluateReleasePreflight,
   ACTIVE_RELEASE_STATUSES,
   PACKAGE_PATHS,

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

@@ -42,5 +42,5 @@ jobs:
               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: 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: '🤖 Auto-triaging with Claude. Analyzing issue and implementing a fix...\n\nClaude will:\n1. Classify this issue\n2. Search codebase for root cause\n3. Implement a minimal fix following AGENTS.md\n4. Create a PR with the changes'
             });

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

@@ -91,8 +91,8 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Wait for prior reviewers (30 min)
-        run: sleep 1800
+      - name: Wait for prior reviewers (25 min)
+        run: sleep 1500
 
       - name: Post Claude FINAL (skip Copilot)
         uses: actions/github-script@v7

.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-merge-gate.yml

@@ -38,7 +38,7 @@ concurrency:
 
 env:
   GH_TOKEN: ${{ secrets.GH_TOKEN || github.token }}
-  MAX_CANDIDATES: 3
+  MAX_CANDIDATES: 1
   DISPATCH_PR_NUMBER: ${{ github.event.inputs.pr_number || github.event.client_payload.pr_number || '' }}
 
 permissions:
@@ -56,22 +56,15 @@ jobs:
       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
+        env:
+          PAT: ${{ secrets.GH_TOKEN }}
         with:
-          github-token: ${{ steps.app-token.outputs.token }}
+          github-token: ${{ secrets.GH_TOKEN }}
           script: |
             const path = require('path');
             const mergeGate = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/merge-gate.js'));
@@ -79,6 +72,11 @@ jobs:
             const owner = context.repo.owner;
             const repo = context.repo.repo;
 
+            if (!process.env.PAT) {
+              core.setFailed('GH_TOKEN secret is required for merge gate auto-dispatch (needs repo + workflow scope).');
+              return;
+            }
+
             if (wr.conclusion !== 'success') {
               core.info(`Skip dispatch: ${wr.name} conclusion=${wr.conclusion}`);
               return;
@@ -123,26 +121,17 @@ jobs:
       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 }}
+          github-token: ${{ env.GH_TOKEN }}
           script: |
             const path = require('path');
             const mergeGate = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/merge-gate.js'));
@@ -167,9 +156,10 @@ jobs:
                 skipped.push({ pr: n, reasons: result.reasons });
               }
             } else {
-              const prNumbers = await mergeGate.listPrNumbersForMergeGateScan(
-                github, owner, repo, core
-              );
+              const prs = await github.paginate(github.rest.pulls.list, {
+                owner, repo, state: 'open', per_page: 100, sort: 'created', direction: 'asc',
+              });
+              const prNumbers = prs.map((p) => p.number);
               const selected = await mergeGate.selectMergeGateCandidates(
                 github, owner, repo, prNumbers, maxCandidates, core
               );
@@ -206,7 +196,7 @@ jobs:
               });
             }
 
-            await ps.syncOpenPullRequests(github, owner, repo, { maxPrs: 10 }, core);
+            await ps.syncOpenPullRequests(github, owner, repo, { maxPrs: 20 }, core);
 
   claude-assess:
     needs: scan-candidates
@@ -240,7 +230,7 @@ jobs:
         id: mark_active
         uses: actions/github-script@v7
         with:
-          github-token: ${{ steps.app-token.outputs.token }}
+          github-token: ${{ env.GH_TOKEN }}
           script: |
             core.setOutput('started_at', new Date().toISOString());
             await github.rest.issues.addLabels({
@@ -262,6 +252,7 @@ jobs:
 
       - 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 }}
@@ -288,13 +279,12 @@ jobs:
             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 praisonaiagents (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.
-            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.
+            3. Confirm SDK value gate: change strengthens praisonaiagents (no scope creep).
+            4. Do not bloat the Agent class with additional params — only if absolutely required; we already support many params.
+            5. If agent.py adds >100 lines or new Agent __init__ params, respond MERGE_GATE_VERDICT: BLOCK (manual review required).
+            6. 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.
+            7. Confirm no CHANGES_REQUESTED reviews and CI green on HEAD ${{ matrix.head_sha }}.
+            8. 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: |
@@ -309,12 +299,11 @@ jobs:
             Read
           timeout_minutes: 15
 
-      - name: Post fallback BLOCK if Opus did not comment
+      - name: Post fallback verdict if Claude did not comment
         id: fallback_verdict
-        if: steps.assess.outcome != 'success'
         uses: actions/github-script@v7
         with:
-          github-token: ${{ steps.app-token.outputs.token }}
+          github-token: ${{ env.GH_TOKEN }}
           script: |
             const mergeGate = require('/tmp/merge-gate.js');
             const owner = context.repo.owner;
@@ -323,24 +312,24 @@ jobs:
 
             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 }
-            );
+            const existing = mergeGate.findMergeGateVerdict(ctx.comments, minCreatedAt, ctx.headPushedAt);
             if (existing) {
-              core.info(`Opus verdict already posted: ${existing}`);
+              core.info(`Verdict already posted: ${existing}`);
+              core.setOutput('verdict', 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: BLOCK',
+              `MERGE_GATE_VERDICT: ${verdict}`,
               '',
-              'Automated fallback — Opus merge gate assessment did not complete.',
+              'Automated fallback — Claude assess did not post a verdict comment (e.g. GitHub MCP unavailable).',
             ];
             if (check.ready) {
-              lines.push('Deterministic gates passed, but Opus MERGE_GATE_VERDICT is required before merge.');
+              lines.push('All deterministic merge gates passed.');
             } else {
               lines.push('Blockers:', ...check.reasons.map((r) => `- ${r}`));
             }
@@ -348,12 +337,14 @@ jobs:
               owner, repo, issue_number: prNumber,
               body: lines.join('\n'),
             });
-            core.info('Posted fallback BLOCK — Opus verdict required');
+            core.info(`Posted fallback verdict: ${verdict}`);
+            core.setOutput('verdict', verdict);
 
-      - name: Require Opus MERGE_GATE_VERDICT
+      - name: Verify verdict posted
+        id: verdict
         uses: actions/github-script@v7
         with:
-          github-token: ${{ steps.app-token.outputs.token }}
+          github-token: ${{ env.GH_TOKEN }}
           script: |
             const mergeGate = require('/tmp/merge-gate.js');
             const comments = await mergeGate.listAllComments(
@@ -363,23 +354,15 @@ jobs:
               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 }
-            );
-            if (!verdict) {
-              core.setFailed(
-                'Opus merge gate assessment must post MERGE_GATE_VERDICT on this PR (automated fallback APPROVE is not accepted).'
-              );
-              return;
-            }
-            core.info(`Opus merge gate verdict: ${verdict}`);
-            core.setOutput('verdict', verdict);
+            const verdict = mergeGate.findMergeGateVerdict(comments, minCreatedAt, ctx.headPushedAt);
+            core.setOutput('verdict', verdict || 'NONE');
+            if (!verdict) core.warning('No recent MERGE_GATE_VERDICT comment found after assessment');
 
       - name: Remove merge gate active label
         if: always()
         uses: actions/github-script@v7
         with:
-          github-token: ${{ steps.app-token.outputs.token }}
+          github-token: ${{ env.GH_TOKEN }}
           script: |
             const prNumber = ${{ matrix.pr_number }};
             try {
@@ -413,25 +396,16 @@ jobs:
       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 }}
+          github-token: ${{ env.GH_TOKEN }}
           script: |
             const path = require('path');
             const mergeGate = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/merge-gate.js'));
@@ -454,9 +428,7 @@ jobs:
               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 }
-              );
+              const verdict = mergeGate.findMergeGateVerdict(comments, verdictMin, ctx.headPushedAt);
               if (verdict !== 'APPROVE') {
                 core.info(`Skip merge: verdict=${verdict || 'NONE'}`);
                 await removeLabels();

.github/workflows/claude.yml

@@ -52,11 +52,9 @@ jobs:
             // Kind labels
             if (content.includes('feature request') || content.includes('[feature')) {
               labels.push('enhancement');
-            } else if (title.includes('[question]') || content.includes('how do i') || content.includes('how to')) {
-              labels.push('question');
             } else if (content.includes('bug') || content.includes('error') || content.includes('crash') || content.includes('traceback')) {
               labels.push('bug');
-            } else if (content.includes('question')) {
+            } else if (content.includes('question') || content.includes('how do i') || content.includes('how to')) {
               labels.push('question');
             }
 
@@ -98,18 +96,13 @@ jobs:
                   '- 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).'
+                  '_A maintainer can trigger deeper analysis by commenting `@claude` on this issue._'
                 ].join('\n')
               });
             }
 
-            // --- Auto-trigger Claude for owner issues and actionable external bug/enhancement reports ---
-            const titleLower = (issue.title || '').toLowerCase();
-            const hasActionableTitle = /^(\[[^\]]+\]|bug:|fix[:(]|feat:|ux:|enhancement:)/i.test(titleLower);
-            const autoClaude = isOwner || (hasActionableTitle && (labels.includes('bug') || labels.includes('enhancement')) && !labels.includes('question'));
-            if (autoClaude) {
+            // --- For owner: add 'claude' label to trigger the code-fix job ---
+            if (isOwner) {
               await github.rest.issues.addLabels({
                 issue_number: issue.number,
                 owner: context.repo.owner,
@@ -119,36 +112,23 @@ jobs:
             }
 
   # ================================================================
-  # Job 2: Full Claude code-fix
+  # Job 2: Full Claude code-fix (owner/collaborator only)
   # 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)
+    # Allow: human users, github-actions[bot] (auto-comments/labels)
+    # Block: dependabot, cursor, renovate, other bots
     # Skip 'opened' events — triage job handles those above
     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 != 'issue_comment' || contains(github.event.comment.body, '@claude')) &&
       (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 == 'praisonai-triage-agent[bot]'
       ) &&
       github.actor != 'dependabot[bot]' &&
       github.actor != 'cursor[bot]' &&
@@ -291,19 +271,17 @@ jobs:
             STEP 1 — READ GUIDELINES:
             Read AGENTS.md to understand the architecture rules.
             SCOPE: Focus ONLY on Python packages (praisonaiagents, praisonai). Do NOT modify or touch praisonai-rust or praisonai-ts packages.
-            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.
+              3. Tools (PraisonAI-Tools): Capabilities Agents actively call during execution (e.g. SurrealDB tool, Slack tool).
               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.
+              5. Plugins (PraisonAI-Plugins): Framework lifecycle extensions replacing systemic behavior (e.g. tracing, logging, metrics, hooks, guardrails).
               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.
+            - 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.

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

@@ -1,7 +1,7 @@
 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.
+# When install.sh or install.ps1 change on main, trigger praison.ai CI which
+# syncs scripts at build time and deploys to Azure AKS (existing azure-pipeline.yaml).
 
 on:
   push:
@@ -19,59 +19,34 @@ permissions:
   contents: read
 
 jobs:
-  deploy-to-hestia:
+  trigger-website-deploy:
     runs-on: ubuntu-latest
-    environment: production-hestia
     steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: main
-          persist-credentials: false
-
-      - name: Sync install scripts to Hestia
+      - name: Trigger praison.ai CI
         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 }}
+          GH_TOKEN: ${{ secrets.SECRETS_ADMIN_PAT }}
           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."
+          if [ -z "${GH_TOKEN:-}" ]; then
+            echo "SECRETS_ADMIN_PAT is not configured in this repository"
             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
+          gh workflow run CI \
+            --repo MervinPraison/praison.ai \
+            --ref master
 
-          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 "Triggered praison.ai CI for PraisonAI commit ${SOURCE_SHA}"
+          echo "Monitor: https://github.com/MervinPraison/praison.ai/actions/workflows/azure-pipeline.yaml"
 
-          echo "Deployed install scripts for commit ${SOURCE_SHA}"
-          echo "Verify: curl -fsSL https://praison.ai/install.ps1 | head -5"
+          sleep 10
+          RUN_URL=$(gh run list \
+            --repo MervinPraison/praison.ai \
+            --workflow CI \
+            --limit 1 \
+            --json url,status,createdAt \
+            --jq '.[0].url' 2>/dev/null || true)
+          if [ -n "${RUN_URL}" ]; then
+            echo "Latest praison.ai CI run: ${RUN_URL}"
+          fi

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

@@ -12,7 +12,7 @@ on:
     - cron: '0 */6 * * *'
 
 concurrency:
-  group: merge-conflict-scan-${{ github.repository }}-${{ github.event.pull_request.number || github.run_id }}
+  group: merge-conflict-scan-${{ github.repository }}
   cancel-in-progress: true
 
 env:
@@ -44,7 +44,6 @@ jobs:
               '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));

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

@@ -1,8 +1,8 @@
 name: Nightly Release Gate
 
 # Preflight before PyPI Release (patch bump).
-# Triggers: Core Tests success on main (workflow_run) or nightly cron at 00:00 UTC.
-# Dedupe: max one successful patch release per UTC day (see release-gate.js).
+# Primary: Core Tests success on main (workflow_run).
+# Backstop: nightly cron at 00:00 UTC.
 
 on:
   schedule:
@@ -39,9 +39,7 @@ jobs:
         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, 'Bump praisonai')
+        github.event.workflow_run.event == 'push'
       )
     runs-on: ubuntu-latest
     env:

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

@@ -11,7 +11,6 @@ permissions:
   pull-requests: read
   issues: write
   actions: write
-  id-token: write
 
 jobs:
   sync:
@@ -21,18 +20,10 @@ jobs:
         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 }}
+          github-token: ${{ secrets.GH_TOKEN }}
           script: |
             const path = require('path');
             const ps = require(path.join(process.env.GITHUB_WORKSPACE, '.github/scripts/pipeline-status.js'));

.github/workflows/pypi-release.yml

@@ -41,26 +41,6 @@ on:
         required: false
         default: false
         type: boolean
-      skip_train:
-        description: 'Skip praisonai-train publish (recovery if already on PyPI)'
-        required: false
-        default: false
-        type: boolean
-      skip_browser:
-        description: 'Skip praisonai-browser publish (recovery if already on PyPI)'
-        required: false
-        default: false
-        type: boolean
-      skip_mcp:
-        description: 'Skip praisonai-mcp publish (recovery if already on PyPI)'
-        required: false
-        default: false
-        type: boolean
-      skip_sandbox:
-        description: 'Skip praisonai-sandbox publish (recovery if already on PyPI)'
-        required: false
-        default: false
-        type: boolean
       agents_version:
         description: 'Override agents version (empty = auto bump from pyproject.toml)'
         required: false
@@ -81,26 +61,6 @@ on:
         required: false
         default: ''
         type: string
-      train_version:
-        description: 'Override praisonai-train version (empty = auto bump from pyproject.toml)'
-        required: false
-        default: ''
-        type: string
-      browser_version:
-        description: 'Override praisonai-browser version (empty = auto bump from pyproject.toml)'
-        required: false
-        default: ''
-        type: string
-      mcp_version:
-        description: 'Override praisonai-mcp version (empty = auto bump from pyproject.toml)'
-        required: false
-        default: ''
-        type: string
-      sandbox_version:
-        description: 'Override praisonai-sandbox version (empty = auto bump from pyproject.toml)'
-        required: false
-        default: ''
-        type: string
       source:
         description: 'Trigger source (audit trail)'
         required: false
@@ -174,17 +134,9 @@ jobs:
           WRAPPER_OVERRIDE: ${{ inputs.wrapper_version }}
           CODE_OVERRIDE: ${{ inputs.code_version }}
           BOT_OVERRIDE: ${{ inputs.bot_version }}
-          TRAIN_OVERRIDE: ${{ inputs.train_version }}
-          BROWSER_OVERRIDE: ${{ inputs.browser_version }}
-          MCP_OVERRIDE: ${{ inputs.mcp_version }}
-          SANDBOX_OVERRIDE: ${{ inputs.sandbox_version }}
           SKIP_AGENTS: ${{ inputs.skip_agents }}
           SKIP_CODE: ${{ inputs.skip_code }}
           SKIP_BOT: ${{ inputs.skip_bot }}
-          SKIP_TRAIN: ${{ inputs.skip_train }}
-          SKIP_BROWSER: ${{ inputs.skip_browser }}
-          SKIP_MCP: ${{ inputs.skip_mcp }}
-          SKIP_SANDBOX: ${{ inputs.skip_sandbox }}
         run: |
           python <<'PY'
           import os
@@ -217,18 +169,10 @@ jobs:
           wrapper_override = os.environ.get("WRAPPER_OVERRIDE", "").strip()
           code_override = os.environ.get("CODE_OVERRIDE", "").strip()
           bot_override = os.environ.get("BOT_OVERRIDE", "").strip()
-          train_override = os.environ.get("TRAIN_OVERRIDE", "").strip()
-          browser_override = os.environ.get("BROWSER_OVERRIDE", "").strip()
-          mcp_override = os.environ.get("MCP_OVERRIDE", "").strip()
-          sandbox_override = os.environ.get("SANDBOX_OVERRIDE", "").strip()
           validate_version("agents_version", agents_override)
           validate_version("wrapper_version", wrapper_override)
           validate_version("code_version", code_override)
           validate_version("bot_version", bot_override)
-          validate_version("train_version", train_override)
-          validate_version("browser_version", browser_override)
-          validate_version("mcp_version", mcp_override)
-          validate_version("sandbox_version", sandbox_override)
 
           agents_pyproject = root / "src/praisonai-agents/pyproject.toml"
           agents_content = agents_pyproject.read_text()
@@ -254,38 +198,6 @@ jobs:
               sys.exit(1)
           current_bot = bot_match.group(1)
 
-          train_pyproject = root / "src/praisonai-train/pyproject.toml"
-          train_content = train_pyproject.read_text()
-          train_match = re.search(r'^version\s*=\s*"([^"]+)"', train_content, re.MULTILINE)
-          if not train_match:
-              print("Could not read praisonai-train version from pyproject.toml", file=sys.stderr)
-              sys.exit(1)
-          current_train = train_match.group(1)
-
-          browser_pyproject = root / "src/praisonai-browser/pyproject.toml"
-          browser_content = browser_pyproject.read_text()
-          browser_match = re.search(r'^version\s*=\s*"([^"]+)"', browser_content, re.MULTILINE)
-          if not browser_match:
-              print("Could not read praisonai-browser version from pyproject.toml", file=sys.stderr)
-              sys.exit(1)
-          current_browser = browser_match.group(1)
-
-          mcp_pyproject = root / "src/praisonai-mcp/pyproject.toml"
-          mcp_content = mcp_pyproject.read_text()
-          mcp_match = re.search(r'^version\s*=\s*"([^"]+)"', mcp_content, re.MULTILINE)
-          if not mcp_match:
-              print("Could not read praisonai-mcp version from pyproject.toml", file=sys.stderr)
-              sys.exit(1)
-          current_mcp = mcp_match.group(1)
-
-          sandbox_pyproject = root / "src/praisonai-sandbox/pyproject.toml"
-          sandbox_content = sandbox_pyproject.read_text()
-          sandbox_match = re.search(r'^version\s*=\s*"([^"]+)"', sandbox_content, re.MULTILINE)
-          if not sandbox_match:
-              print("Could not read praisonai-sandbox version from pyproject.toml", file=sys.stderr)
-              sys.exit(1)
-          current_sandbox = sandbox_match.group(1)
-
           wrapper_version_py = root / "src/praisonai/praisonai/version.py"
           wrapper_content = wrapper_version_py.read_text()
           wrapper_match = re.search(r'__version__ = "([^"]+)"', wrapper_content)
@@ -298,10 +210,6 @@ jobs:
               ("agents", current_agents),
               ("code", current_code),
               ("bot", current_bot),
-              ("train", current_train),
-              ("browser", current_browser),
-              ("mcp", current_mcp),
-              ("sandbox", current_sandbox),
               ("wrapper", current_wrapper),
           ):
               if not SEMVER.match(value):
@@ -311,10 +219,6 @@ jobs:
           skip_agents = os.environ.get("SKIP_AGENTS", "false").lower() == "true"
           skip_code = os.environ.get("SKIP_CODE", "false").lower() == "true"
           skip_bot = os.environ.get("SKIP_BOT", "false").lower() == "true"
-          skip_train = os.environ.get("SKIP_TRAIN", "false").lower() == "true"
-          skip_browser = os.environ.get("SKIP_BROWSER", "false").lower() == "true"
-          skip_mcp = os.environ.get("SKIP_MCP", "false").lower() == "true"
-          skip_sandbox = os.environ.get("SKIP_SANDBOX", "false").lower() == "true"
 
           if agents_override:
               agents_version = agents_override
@@ -337,34 +241,6 @@ jobs:
           else:
               bot_version = bump_version(current_bot)
 
-          if train_override:
-              train_version = train_override
-          elif skip_train:
-              train_version = current_train
-          else:
-              train_version = bump_version(current_train)
-
-          if browser_override:
-              browser_version = browser_override
-          elif skip_browser:
-              browser_version = current_browser
-          else:
-              browser_version = bump_version(current_browser)
-
-          if mcp_override:
-              mcp_version = mcp_override
-          elif skip_mcp:
-              mcp_version = current_mcp
-          else:
-              mcp_version = bump_version(current_mcp)
-
-          if sandbox_override:
-              sandbox_version = sandbox_override
-          elif skip_sandbox:
-              sandbox_version = current_sandbox
-          else:
-              sandbox_version = bump_version(current_sandbox)
-
           if wrapper_override:
               wrapper_version = wrapper_override
           else:
@@ -375,27 +251,15 @@ jobs:
               fh.write(f"agents_version={agents_version}\n")
               fh.write(f"code_version={code_version}\n")
               fh.write(f"bot_version={bot_version}\n")
-              fh.write(f"train_version={train_version}\n")
-              fh.write(f"browser_version={browser_version}\n")
-              fh.write(f"mcp_version={mcp_version}\n")
-              fh.write(f"sandbox_version={sandbox_version}\n")
               fh.write(f"wrapper_version={wrapper_version}\n")
               fh.write(f"current_agents={current_agents}\n")
               fh.write(f"current_code={current_code}\n")
               fh.write(f"current_bot={current_bot}\n")
-              fh.write(f"current_train={current_train}\n")
-              fh.write(f"current_browser={current_browser}\n")
-              fh.write(f"current_mcp={current_mcp}\n")
-              fh.write(f"current_sandbox={current_sandbox}\n")
               fh.write(f"current_wrapper={current_wrapper}\n")
 
           print(f"Agents:  {current_agents} -> {agents_version}")
           print(f"Code:    {current_code} -> {code_version}")
           print(f"Bot:     {current_bot} -> {bot_version}")
-          print(f"Train:   {current_train} -> {train_version}")
-          print(f"Browser: {current_browser} -> {browser_version}")
-          print(f"MCP:     {current_mcp} -> {mcp_version}")
-          print(f"Sandbox: {current_sandbox} -> {sandbox_version}")
           print(f"Wrapper: {current_wrapper} -> {wrapper_version}")
           PY
 
@@ -406,28 +270,16 @@ jobs:
           AGENTS_VERSION: ${{ steps.versions.outputs.agents_version }}
           CODE_VERSION: ${{ steps.versions.outputs.code_version }}
           BOT_VERSION: ${{ steps.versions.outputs.bot_version }}
-          TRAIN_VERSION: ${{ steps.versions.outputs.train_version }}
-          BROWSER_VERSION: ${{ steps.versions.outputs.browser_version }}
-          MCP_VERSION: ${{ steps.versions.outputs.mcp_version }}
-          SANDBOX_VERSION: ${{ steps.versions.outputs.sandbox_version }}
           WRAPPER_VERSION: ${{ steps.versions.outputs.wrapper_version }}
           INPUT_SKIP_AGENTS: ${{ inputs.skip_agents }}
           INPUT_SKIP_CODE: ${{ inputs.skip_code }}
           INPUT_SKIP_BOT: ${{ inputs.skip_bot }}
-          INPUT_SKIP_TRAIN: ${{ inputs.skip_train }}
-          INPUT_SKIP_BROWSER: ${{ inputs.skip_browser }}
-          INPUT_SKIP_MCP: ${{ inputs.skip_mcp }}
-          INPUT_SKIP_SANDBOX: ${{ inputs.skip_sandbox }}
           INPUT_SKIP_WRAPPER: ${{ inputs.skip_wrapper }}
         run: |
           set -euo pipefail
           skip_agents="${INPUT_SKIP_AGENTS}"
           skip_code="${INPUT_SKIP_CODE}"
           skip_bot="${INPUT_SKIP_BOT}"
-          skip_train="${INPUT_SKIP_TRAIN}"
-          skip_browser="${INPUT_SKIP_BROWSER}"
-          skip_mcp="${INPUT_SKIP_MCP}"
-          skip_sandbox="${INPUT_SKIP_SANDBOX}"
           skip_wrapper="${INPUT_SKIP_WRAPPER}"
           if [ "$skip_agents" != "true" ]; then
             curl -fsSL "https://pypi.org/pypi/praisonaiagents/${AGENTS_VERSION}/json" >/dev/null && skip_agents=true || true
@@ -438,30 +290,14 @@ jobs:
           if [ "$skip_bot" != "true" ]; then
             curl -fsSL "https://pypi.org/pypi/praisonai-bot/${BOT_VERSION}/json" >/dev/null && skip_bot=true || true
           fi
-          if [ "$skip_train" != "true" ]; then
-            curl -fsSL "https://pypi.org/pypi/praisonai-train/${TRAIN_VERSION}/json" >/dev/null && skip_train=true || true
-          fi
-          if [ "$skip_browser" != "true" ]; then
-            curl -fsSL "https://pypi.org/pypi/praisonai-browser/${BROWSER_VERSION}/json" >/dev/null && skip_browser=true || true
-          fi
-          if [ "$skip_mcp" != "true" ]; then
-            curl -fsSL "https://pypi.org/pypi/praisonai-mcp/${MCP_VERSION}/json" >/dev/null && skip_mcp=true || true
-          fi
-          if [ "$skip_sandbox" != "true" ]; then
-            curl -fsSL "https://pypi.org/pypi/praisonai-sandbox/${SANDBOX_VERSION}/json" >/dev/null && skip_sandbox=true || true
-          fi
           if [ "$skip_wrapper" != "true" ]; then
             curl -fsSL "https://pypi.org/pypi/praisonai/${WRAPPER_VERSION}/json" >/dev/null && skip_wrapper=true || true
           fi
           echo "skip_agents=${skip_agents}" >> "$GITHUB_OUTPUT"
           echo "skip_code=${skip_code}" >> "$GITHUB_OUTPUT"
           echo "skip_bot=${skip_bot}" >> "$GITHUB_OUTPUT"
-          echo "skip_train=${skip_train}" >> "$GITHUB_OUTPUT"
-          echo "skip_browser=${skip_browser}" >> "$GITHUB_OUTPUT"
-          echo "skip_mcp=${skip_mcp}" >> "$GITHUB_OUTPUT"
-          echo "skip_sandbox=${skip_sandbox}" >> "$GITHUB_OUTPUT"
           echo "skip_wrapper=${skip_wrapper}" >> "$GITHUB_OUTPUT"
-          if [ "$skip_agents" = "true" ] && [ "$skip_code" = "true" ] && [ "$skip_bot" = "true" ] && [ "$skip_train" = "true" ] && [ "$skip_browser" = "true" ] && [ "$skip_mcp" = "true" ] && [ "$skip_sandbox" = "true" ] && [ "$skip_wrapper" = "true" ]; then
+          if [ "$skip_agents" = "true" ] && [ "$skip_code" = "true" ] && [ "$skip_bot" = "true" ] && [ "$skip_wrapper" = "true" ]; then
             echo "All target versions already on PyPI — nothing to publish."
           fi
 
@@ -471,10 +307,6 @@ jobs:
           steps.pypi_exists.outputs.skip_agents == 'true' &&
           steps.pypi_exists.outputs.skip_code == 'true' &&
           steps.pypi_exists.outputs.skip_bot == 'true' &&
-          steps.pypi_exists.outputs.skip_train == 'true' &&
-          steps.pypi_exists.outputs.skip_browser == 'true' &&
-          steps.pypi_exists.outputs.skip_mcp == 'true' &&
-          steps.pypi_exists.outputs.skip_sandbox == 'true' &&
           steps.pypi_exists.outputs.skip_wrapper == 'true'
         run: echo "Idempotent skip — target versions already on PyPI."
 
@@ -485,9 +317,6 @@ jobs:
           echo "Agents version:  ${{ steps.versions.outputs.agents_version }}"
           echo "Code version:    ${{ steps.versions.outputs.code_version }}"
           echo "Bot version:     ${{ steps.versions.outputs.bot_version }}"
-          echo "Train version:   ${{ steps.versions.outputs.train_version }}"
-          echo "Browser version: ${{ steps.versions.outputs.browser_version }}"
-          echo "MCP version:     ${{ steps.versions.outputs.mcp_version }}"
           echo "Wrapper version: ${{ steps.versions.outputs.wrapper_version }}"
           echo ""
           if [ "${{ inputs.skip_agents }}" != "true" ]; then
@@ -499,17 +328,8 @@ jobs:
           if [ "${{ inputs.skip_bot }}" != "true" ]; then
             echo "Would publish praisonai-bot ${{ steps.versions.outputs.bot_version }}"
           fi
-          if [ "${{ inputs.skip_train }}" != "true" ]; then
-            echo "Would publish praisonai-train ${{ steps.versions.outputs.train_version }}"
-          fi
-          if [ "${{ inputs.skip_browser }}" != "true" ]; then
-            echo "Would publish praisonai-browser ${{ steps.versions.outputs.browser_version }}"
-          fi
-          if [ "${{ inputs.skip_mcp }}" != "true" ]; then
-            echo "Would publish praisonai-mcp ${{ steps.versions.outputs.mcp_version }}"
-          fi
           if [ "${{ inputs.skip_wrapper }}" != "true" ]; then
-            echo "Would run bump_and_release.py ${{ steps.versions.outputs.wrapper_version }} --agents ${{ steps.versions.outputs.agents_version }} --code-pin ${{ steps.versions.outputs.code_version }} --bot-pin ${{ steps.versions.outputs.bot_version }} --train-pin ${{ steps.versions.outputs.train_version }} --browser-pin ${{ steps.versions.outputs.browser_version }} --mcp-pin ${{ steps.versions.outputs.mcp_version }}"
+            echo "Would run bump_and_release.py ${{ steps.versions.outputs.wrapper_version }} --agents ${{ steps.versions.outputs.agents_version }} --code-pin ${{ steps.versions.outputs.code_version }} --bot-pin ${{ steps.versions.outputs.bot_version }}"
             echo "Would uv publish praisonai ${{ steps.versions.outputs.wrapper_version }}"
           fi
 
@@ -719,286 +539,6 @@ jobs:
           git pull --rebase origin main
           git push origin main
 
-      - name: Publish praisonai-train
-        if: >-
-          inputs.dry_run != true &&
-          inputs.skip_train != true &&
-          steps.pypi_exists.outputs.skip_train != 'true'
-        working-directory: src/praisonai-train
-        env:
-          NEW_VERSION: ${{ steps.versions.outputs.train_version }}
-          CURRENT: ${{ steps.versions.outputs.current_train }}
-        run: |
-          set -euo pipefail
-          python <<'PY'
-          import os
-          import re
-          from pathlib import Path
-          new = os.environ["NEW_VERSION"]
-          current = os.environ["CURRENT"]
-          pyproject = Path("pyproject.toml")
-          content = pyproject.read_text()
-          pyproject.write_text(content.replace(f'version = "{current}"', f'version = "{new}"', 1))
-          version_py = Path("praisonai_train/_version.py")
-          version_content = version_py.read_text()
-          version_py.write_text(re.sub(r'__version__ = "[^"]+"', f'__version__ = "{new}"', version_content, count=1))
-          PY
-
-          rm -rf dist
-          uv lock
-          uv build
-          uv publish
-
-      - name: Wait for praisonai-train on PyPI
-        if: >-
-          inputs.dry_run != true &&
-          inputs.skip_train != true &&
-          steps.pypi_exists.outputs.skip_train != 'true'
-        run: |
-          set -euo pipefail
-          PACKAGE="praisonai-train"
-          VERSION="${{ steps.versions.outputs.train_version }}"
-          MAX_WAIT=600
-          INTERVAL=30
-          START=$(date +%s)
-
-          while true; do
-            if curl -fsSL "https://pypi.org/pypi/${PACKAGE}/${VERSION}/json" >/dev/null; then
-              echo "✅ ${PACKAGE}==${VERSION} is available on PyPI"
-              exit 0
-            fi
-            ELAPSED=$(( $(date +%s) - START ))
-            if [ "$ELAPSED" -ge "$MAX_WAIT" ]; then
-              echo "❌ Timeout waiting for ${PACKAGE}==${VERSION} on PyPI"
-              exit 1
-            fi
-            echo "⏳ Waiting for ${PACKAGE}==${VERSION} ($(( MAX_WAIT - ELAPSED ))s remaining...)"
-            sleep "$INTERVAL"
-          done
-
-      - name: Commit praisonai-train version bump
-        if: >-
-          inputs.dry_run != true &&
-          inputs.skip_train != true &&
-          steps.pypi_exists.outputs.skip_train != 'true'
-        run: |
-          set -euo pipefail
-          git add src/praisonai-train/pyproject.toml src/praisonai-train/uv.lock src/praisonai-train/praisonai_train/_version.py
-          git diff --cached --quiet && { echo "No train files to commit"; exit 0; }
-          git commit -m "Bump praisonai-train to ${{ steps.versions.outputs.train_version }}"
-          git pull --rebase origin main
-          git push origin main
-
-      - name: Publish praisonai-browser
-        if: >-
-          inputs.dry_run != true &&
-          inputs.skip_browser != true &&
-          steps.pypi_exists.outputs.skip_browser != 'true'
-        working-directory: src/praisonai-browser
-        env:
-          NEW_VERSION: ${{ steps.versions.outputs.browser_version }}
-          CURRENT: ${{ steps.versions.outputs.current_browser }}
-        run: |
-          set -euo pipefail
-          python <<'PY'
-          import os
-          import re
-          from pathlib import Path
-          new = os.environ["NEW_VERSION"]
-          current = os.environ["CURRENT"]
-          pyproject = Path("pyproject.toml")
-          content = pyproject.read_text()
-          pyproject.write_text(content.replace(f'version = "{current}"', f'version = "{new}"', 1))
-          version_py = Path("praisonai_browser/_version.py")
-          version_content = version_py.read_text()
-          version_py.write_text(re.sub(r'__version__ = "[^"]+"', f'__version__ = "{new}"', version_content, count=1))
-          PY
-
-          rm -rf dist
-          uv lock
-          uv build
-          uv publish
-
-      - name: Wait for praisonai-browser on PyPI
-        if: >-
-          inputs.dry_run != true &&
-          inputs.skip_browser != true &&
-          steps.pypi_exists.outputs.skip_browser != 'true'
-        run: |
-          set -euo pipefail
-          PACKAGE="praisonai-browser"
-          VERSION="${{ steps.versions.outputs.browser_version }}"
-          MAX_WAIT=600
-          INTERVAL=30
-          START=$(date +%s)
-
-          while true; do
-            if curl -fsSL "https://pypi.org/pypi/${PACKAGE}/${VERSION}/json" >/dev/null; then
-              echo "✅ ${PACKAGE}==${VERSION} is available on PyPI"
-              exit 0
-            fi
-            ELAPSED=$(( $(date +%s) - START ))
-            if [ "$ELAPSED" -ge "$MAX_WAIT" ]; then
-              echo "❌ Timeout waiting for ${PACKAGE}==${VERSION} on PyPI"
-              exit 1
-            fi
-            echo "⏳ Waiting for ${PACKAGE}==${VERSION} ($(( MAX_WAIT - ELAPSED ))s remaining...)"
-            sleep "$INTERVAL"
-          done
-
-      - name: Commit praisonai-browser version bump
-        if: >-
-          inputs.dry_run != true &&
-          inputs.skip_browser != true &&
-          steps.pypi_exists.outputs.skip_browser != 'true'
-        run: |
-          set -euo pipefail
-          git add src/praisonai-browser/pyproject.toml src/praisonai-browser/uv.lock src/praisonai-browser/praisonai_browser/_version.py
-          git diff --cached --quiet && { echo "No browser files to commit"; exit 0; }
-          git commit -m "Bump praisonai-browser to ${{ steps.versions.outputs.browser_version }}"
-          git pull --rebase origin main
-          git push origin main
-
-      - name: Publish praisonai-mcp
-        if: >-
-          inputs.dry_run != true &&
-          inputs.skip_mcp != true &&
-          steps.pypi_exists.outputs.skip_mcp != 'true'
-        working-directory: src/praisonai-mcp
-        env:
-          NEW_VERSION: ${{ steps.versions.outputs.mcp_version }}
-          CURRENT: ${{ steps.versions.outputs.current_mcp }}
-        run: |
-          set -euo pipefail
-          python <<'PY'
-          import os
-          import re
-          from pathlib import Path
-          new = os.environ["NEW_VERSION"]
-          current = os.environ["CURRENT"]
-          pyproject = Path("pyproject.toml")
-          content = pyproject.read_text()
-          pyproject.write_text(content.replace(f'version = "{current}"', f'version = "{new}"', 1))
-          version_py = Path("praisonai_mcp/_version.py")
-          version_content = version_py.read_text()
-          version_py.write_text(re.sub(r'__version__ = "[^"]+"', f'__version__ = "{new}"', version_content, count=1))
-          PY
-
-          rm -rf dist
-          uv lock
-          uv build
-          uv publish
-
-      - name: Wait for praisonai-mcp on PyPI
-        if: >-
-          inputs.dry_run != true &&
-          inputs.skip_mcp != true &&
-          steps.pypi_exists.outputs.skip_mcp != 'true'
-        run: |
-          set -euo pipefail
-          PACKAGE="praisonai-mcp"
-          VERSION="${{ steps.versions.outputs.mcp_version }}"
-          MAX_WAIT=600
-          INTERVAL=30
-          START=$(date +%s)
-
-          while true; do
-            if curl -fsSL "https://pypi.org/pypi/${PACKAGE}/${VERSION}/json" >/dev/null; then
-              echo "✅ ${PACKAGE}==${VERSION} is available on PyPI"
-              exit 0
-            fi
-            ELAPSED=$(( $(date +%s) - START ))
-            if [ "$ELAPSED" -ge "$MAX_WAIT" ]; then
-              echo "❌ Timeout waiting for ${PACKAGE}==${VERSION} on PyPI"
-              exit 1
-            fi
-            echo "⏳ Waiting for ${PACKAGE}==${VERSION} ($(( MAX_WAIT - ELAPSED ))s remaining...)"
-            sleep "$INTERVAL"
-          done
-
-      - name: Commit praisonai-mcp version bump
-        if: >-
-          inputs.dry_run != true &&
-          inputs.skip_mcp != true &&
-          steps.pypi_exists.outputs.skip_mcp != 'true'
-        run: |
-          set -euo pipefail
-          git add src/praisonai-mcp/pyproject.toml src/praisonai-mcp/uv.lock src/praisonai-mcp/praisonai_mcp/_version.py
-          git diff --cached --quiet && { echo "No mcp files to commit"; exit 0; }
-          git commit -m "Bump praisonai-mcp to ${{ steps.versions.outputs.mcp_version }}"
-          git pull --rebase origin main
-          git push origin main
-
-      - name: Publish praisonai-sandbox
-        if: >-
-          inputs.dry_run != true &&
-          inputs.skip_sandbox != true &&
-          steps.pypi_exists.outputs.skip_sandbox != 'true'
-        working-directory: src/praisonai-sandbox
-        env:
-          NEW_VERSION: ${{ steps.versions.outputs.sandbox_version }}
-          CURRENT: ${{ steps.versions.outputs.current_sandbox }}
-        run: |
-          set -euo pipefail
-          python <<'PY'
-          import os
-          import re
-          from pathlib import Path
-          new = os.environ["NEW_VERSION"]
-          current = os.environ["CURRENT"]
-          pyproject = Path("pyproject.toml")
-          content = pyproject.read_text()
-          pyproject.write_text(content.replace(f'version = "{current}"', f'version = "{new}"', 1))
-          version_py = Path("praisonai_sandbox/_version.py")
-          version_content = version_py.read_text()
-          version_py.write_text(re.sub(r'__version__ = "[^"]+"', f'__version__ = "{new}"', version_content, count=1))
-          PY
-
-          rm -rf dist
-          uv lock
-          uv build
-          uv publish
-
-      - name: Wait for praisonai-sandbox on PyPI
-        if: >-
-          inputs.dry_run != true &&
-          inputs.skip_sandbox != true &&
-          steps.pypi_exists.outputs.skip_sandbox != 'true'
-        run: |
-          set -euo pipefail
-          PACKAGE="praisonai-sandbox"
-          VERSION="${{ steps.versions.outputs.sandbox_version }}"
-          MAX_WAIT=600
-          INTERVAL=30
-          START=$(date +%s)
-
-          while true; do
-            if curl -fsSL "https://pypi.org/pypi/${PACKAGE}/${VERSION}/json" >/dev/null; then
-              echo "✅ ${PACKAGE}==${VERSION} is available on PyPI"
-              exit 0
-            fi
-            ELAPSED=$(( $(date +%s) - START ))
-            if [ "$ELAPSED" -ge "$MAX_WAIT" ]; then
-              echo "❌ Timeout waiting for ${PACKAGE}==${VERSION} on PyPI"
-              exit 1
-            fi
-            echo "⏳ Waiting for ${PACKAGE}==${VERSION} ($(( MAX_WAIT - ELAPSED ))s remaining...)"
-            sleep "$INTERVAL"
-          done
-
-      - name: Commit praisonai-sandbox version bump
-        if: >-
-          inputs.dry_run != true &&
-          inputs.skip_sandbox != true &&
-          steps.pypi_exists.outputs.skip_sandbox != 'true'
-        run: |
-          set -euo pipefail
-          git add src/praisonai-sandbox/pyproject.toml src/praisonai-sandbox/uv.lock src/praisonai-sandbox/praisonai_sandbox/_version.py
-          git diff --cached --quiet && { echo "No sandbox files to commit"; exit 0; }
-          git commit -m "Bump praisonai-sandbox to ${{ steps.versions.outputs.sandbox_version }}"
-          git pull --rebase origin main
-          git push origin main
-
       - name: Bump and release wrapper
         if: >-
           inputs.dry_run != true &&
@@ -1010,10 +550,6 @@ jobs:
             --agents "${{ steps.versions.outputs.agents_version }}" \
             --code-pin "${{ steps.versions.outputs.code_version }}" \
             --bot-pin "${{ steps.versions.outputs.bot_version }}" \
-            --train-pin "${{ steps.versions.outputs.train_version }}" \
-            --browser-pin "${{ steps.versions.outputs.browser_version }}" \
-            --mcp-pin "${{ steps.versions.outputs.mcp_version }}" \
-            --sandbox-pin "${{ steps.versions.outputs.sandbox_version }}" \
             --wait --max-wait 600 --no-add-all
 
       - name: Publish praisonai wrapper to PyPI
@@ -1058,10 +594,6 @@ jobs:
           AGENTS="${{ steps.versions.outputs.agents_version }}"
           CODE="${{ steps.versions.outputs.code_version }}"
           BOT="${{ steps.versions.outputs.bot_version }}"
-          TRAIN="${{ steps.versions.outputs.train_version }}"
-          BROWSER="${{ steps.versions.outputs.browser_version }}"
-          MCP="${{ steps.versions.outputs.mcp_version }}"
-          SANDBOX="${{ steps.versions.outputs.sandbox_version }}"
           WRAPPER="${{ steps.versions.outputs.wrapper_version }}"
 
           if [ "${{ inputs.skip_agents }}" != "true" ]; then
@@ -1076,22 +608,6 @@ jobs:
             echo "✅ praisonai-bot==${BOT}"
           fi
 
-          if [ "${{ inputs.skip_train }}" != "true" ]; then
-            echo "✅ praisonai-train==${TRAIN}"
-          fi
-
-          if [ "${{ inputs.skip_browser }}" != "true" ]; then
-            echo "✅ praisonai-browser==${BROWSER}"
-          fi
-
-          if [ "${{ inputs.skip_mcp }}" != "true" ]; then
-            echo "✅ praisonai-mcp==${MCP}"
-          fi
-
-          if [ "${{ inputs.skip_sandbox }}" != "true" ]; then
-            echo "✅ praisonai-sandbox==${SANDBOX}"
-          fi
-
           if [ "${{ inputs.skip_wrapper }}" != "true" ]; then
             echo "✅ praisonai==${WRAPPER}"
           fi

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

@@ -6,7 +6,7 @@ on:
       target_repo:
         description: 'Destination repo (owner/name)'
         required: true
-        default: 'MervinPraison/PraisonAIUI'
+        default: 'MervinPraison/PraisonAI-Plugins'
         type: string
 
 permissions:

.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-core.yml

@@ -88,39 +88,18 @@ jobs:
             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
-            paths: >-
-              tests/unit/train/
-            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: subdirs
             paths: >-
               tests/unit/scheduler/
               tests/unit/integrations/
               tests/unit/deploy/
+              tests/unit/mcp_server/
               tests/unit/mcp/
               tests/unit/knowledge/
+              tests/unit/train/
               tests/unit/llm/
               tests/unit/doctor/
               tests/unit/code/
@@ -137,6 +116,7 @@ jobs:
               tests/unit/orchestration/
               tests/unit/dev/
               tests/unit/_dev/
+              tests/unit/daemon/
               tests/unit/context/
               tests/unit/adapters/
               tests/unit/templates/
@@ -180,12 +160,6 @@ jobs:
       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-mcp" ]; then
-          bash "$GITHUB_WORKSPACE/scripts/check_c12_mcp_imports.sh"
-        fi
         cd "$WORKDIR"
         if [ -n "${{ matrix.pythonpath || '' }}" ]; then
           export PYTHONPATH="${{ matrix.pythonpath }}:${PYTHONPATH:-}"

.github/workflows/test-optimized.yml

@@ -42,7 +42,7 @@ jobs:
   # ============================================
   smoke:
     runs-on: ubuntu-latest
-    timeout-minutes: 12
+    timeout-minutes: 8
     steps:
     - uses: actions/checkout@v4
       with:
@@ -81,15 +81,8 @@ jobs:
         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 \
           -q --tb=line --timeout=30 --maxfail=5
         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 \
@@ -132,35 +125,17 @@ jobs:
         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
+        # Standalone run must not fail on wrapper ImportError (API auth failure is OK)
         set +e
-        RUN_OUT=$(timeout 90 /tmp/praisonai-code-standalone/bin/praisonai-code run --output actions "Say hello in one word" 2>&1)
+        RUN_OUT=$(timeout 90 /tmp/praisonai-code-standalone/bin/praisonai-code run "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"
+          echo "FAIL: standalone 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"
+        echo "standalone run import gate ok (exit $RUN_CODE)"
 
     - name: Standalone praisonai-bot smoke (C9)
       run: |
@@ -172,108 +147,15 @@ jobs:
         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: 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
-        python scripts/audit_hybrid_modules.py
     
     - name: Smoke Test Summary
       if: always()
@@ -338,6 +220,7 @@ jobs:
           --ignore=tests/e2e \
           --ignore=tests/live \
           --ignore=tests/unit/jobs \
+          --ignore=tests/unit/sandbox \
           --ignore=tests/unit/test_langflow_components.py \
           --cov=praisonai \
           --cov-report=xml \
@@ -776,14 +659,14 @@ jobs:
           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_gateway_session.py
+          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/test_bot_history.py
-          ../praisonai-bot/tests/unit/test_bot_fixes.py
+          tests/unit/test_bot_wiring.py
+          tests/unit/test_bot_history.py
+          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

.github/workflows/test-windows.yml

@@ -20,7 +20,7 @@ on:
 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

AGENTS.md

@@ -7,9 +7,5 @@ You are working on the PraisonAI project.
 - Be concise and helpful in responses  
 - Test implementation thoroughly
 - Ensure backward compatibility with existing APIs
-- Follow protocol-driven design across the eight packages: 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/`, integrations/serve/dashboard in the `praisonai/` wrapper
-- 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)
-- 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.
+- Follow protocol-driven design: core protocols in `praisonaiagents/`, agentic terminal CLI in `praisonai-code/`, bot/channel and heavy implementations in `praisonai/`
+- Preserve old `praisonai.cli.*` import paths via shims when changing moved CLI code (see §2.3 in `src/praisonai-agents/AGENTS.md`)

ARCHITECTURE.md

@@ -1,9 +1,9 @@
 # PraisonAI Architecture
 
-> **Last updated:** 2026-07-17 (C13 — eight-package tiered model)
+> **Last updated:** 2026-07-03 (C9 — four-tier package model)
 >
 > Strategic architecture document for PraisonAI — a multi-agent AI framework.
-> Covers **Python tiered package model (C7.1 + C9 + C10)**, system design, runtime
+> Covers **Python four-tier package model (C7.1 + C9)**, system design, runtime
 > architecture, data contracts, reliability, observability, and the road map.
 
 ---
@@ -11,7 +11,7 @@
 ## Table of Contents
 
 1. [Executive Summary](#1-executive-summary)
-2. [Python Tiered Package Model (C7.1 + C9 + C10 + C11 + C12 + C13)](#2-python-tiered-package-model-c71--c9--c10--c11--c12--c13)
+2. [Python Four-Tier Package Model (C7.1 + C9)](#2-python-four-tier-package-model-c71--c9)
 3. [System Overview](#3-system-overview)
 4. [Layered Architecture](#4-layered-architecture)
 5. [Core Data Contracts](#5-core-data-contracts)
@@ -21,7 +21,7 @@
 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
+**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/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
 
 ---
 
@@ -51,17 +51,13 @@ Orchestration + Observability** core to unlock adoption and trust:
 
 ---
 
-## 2. Python Tiered Package Model (C7.1 + C9 + C10 + C11 + C12 + C13)
+## 2. Python Four-Tier Package Model (C7.1 + C9)
 
-**Release:** v4.6.110+ · `praisonaiagents` · `praisonai-code` · `praisonai-bot` · `praisonai-train` · `praisonai-browser` · `praisonai-mcp` · `praisonai-sandbox` · `praisonai`
+**Release:** v4.6.110+ · `praisonaiagents` · `praisonai-code` · `praisonai-bot` · `praisonai`
 
-The Python monorepo publishes eight 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`.
+The Python monorepo publishes four 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`.
 
 ```mermaid
 flowchart TB
@@ -69,58 +65,36 @@ flowchart TB
     Agents["praisonaiagents<br/>Agent, tools, memory, hooks, protocols"]
   end
 
-  subgraph tier2 [Tier 2 — Terminal + Bot + Train + Browser + MCP + Sandbox]
+  subgraph tier2 [Tier 2 — Terminal + Bot]
     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"]
   end
 
   subgraph tier3 [Tier 3 — Wrapper]
-    Wrapper["praisonai<br/>framework_adapters, serve, dashboard"]
+    Wrapper["praisonai<br/>framework_adapters, train, serve, dashboard"]
   end
 
   Agents --> Code
   Agents --> Bot
-  Agents --> Train
-  Agents --> Browser
-  Agents --> MCP
-  Agents --> Sandbox
   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 _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`
+**PyPI publish order:** `praisonaiagents` → `praisonai-code` + `praisonai-bot` → `praisonai`
 
-**Backward compatibility:** `praisonai.bots`, `praisonai.gateway`, `praisonai.train`,
-`praisonai.browser`, `praisonai.mcp_server`, `praisonai.sandbox`, and related CLI paths remain as
-`alias_package` shims to `praisonai_bot.*` / `praisonai_train.*` /
-`praisonai_browser.*` / `praisonai_mcp.*` / `praisonai_sandbox.*`.
+**Backward compatibility:** `praisonai.bots`, `praisonai.gateway`, and related CLI
+paths remain as `alias_package` shims to `praisonai_bot.*`.
 
 | 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` |
-| 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`) |
-| 3 | `src/praisonai/` | `framework_adapters/`, serve, dashboard, async jobs API | — |
+| 1 | `src/praisonai-agents/` | Agent, tools, memory, hooks, `frameworks/` protocols | `praisonai`, `praisonai-code` |
+| 2 | `src/praisonai-code/` | `run`/`chat`/`code`, Typer, runtime, LLM, tool resolution | **`praisonai` as a PyPI dependency** (optional lazy imports via `_wrapper_bridge` only) |
+| 3 | `src/praisonai/` | Gateway, bots, `framework_adapters/`, capabilities, train, serve | — |
 
-**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`).
+**Publish order:** `praisonaiagents` → `praisonai-code` → `praisonai`
 
 ### Dependency rule (validated)
 

api.md

@@ -61,7 +61,6 @@ Methods:
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">handoff_to</a>(target_agent: 'Agent', prompt: str, context: Optional[Dict[str, Any]] = None, config: Optional['HandoffConfig'] = None) -> 'HandoffResult'</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">handoff_to_async</a>(target_agent: 'Agent', prompt: str, context: Optional[Dict[str, Any]] = None, config: Optional['HandoffConfig'] = None) -> 'HandoffResult'</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">is_closed</a>() -> bool</code>
-* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">last_stop_reason</a>() -> str</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">list_mcp_servers</a>() -> List[str]</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">llm_instance</a>()</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">llm_instance</a>(value)</code>
@@ -81,7 +80,7 @@ Methods:
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">rules_manager</a>() -> Optional[Any]</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">run_autonomous</a>(prompt: str, max_iterations: Optional[int] = None, timeout_seconds: Optional[float] = None, completion_promise: Optional[str] = None, clear_context: bool = False)</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">run_autonomous_async</a>(prompt: str, max_iterations: Optional[int] = None, timeout_seconds: Optional[float] = None, completion_promise: Optional[str] = None, clear_context: bool = False)</code>
-* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">run_until</a>(prompt: str, criteria: str = '', threshold: float = 8.0, max_iterations: int = 5, mode: str = 'optimize', on_iteration: Optional[Callable[[Any], None]] = None, verbose: bool = False, goal: Optional[str] = None, goal_criteria: Optional[Any] = None, judge_model: Optional[str] = None) -> 'EvaluationLoopResult'</code>
+* <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">run_until</a>(prompt: str, criteria: str, threshold: float = 8.0, max_iterations: int = 5, mode: str = 'optimize', on_iteration: Optional[Callable[[Any], None]] = None, verbose: bool = False) -> 'EvaluationLoopResult'</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">run_until_async</a>(prompt: str, criteria: str, threshold: float = 8.0, max_iterations: int = 5, mode: str = 'optimize', on_iteration: Optional[Callable[[Any], None]] = None, verbose: bool = False) -> 'EvaluationLoopResult'</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">skill_manager</a>() -> Optional[Any]</code>
 * <code title="class Agent">Agent.<a href="./src/praisonai-agents/praisonaiagents/agent/agent.py">store_memory</a>(content: str, memory_type: str = 'short_term', action: str = 'add', **kwargs: Any) -> None</code>
@@ -192,7 +191,7 @@ Methods:
 * <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">discover_single_file_plugins</a>() -> int</code>
 * <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">get</a>(name: str) -> Optional[Union[BaseTool, Callable]]</code>
 * <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">get_all</a>() -> Dict[str, Union[BaseTool, Callable]]</code>
-* <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">get_tool_definitions</a>(permission_resolver: Optional[Callable[[str], bool]] = None) -> List[Dict[str, Any]]</code>
+* <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">get_tool_definitions</a>() -> List[Dict[str, Any]]</code>
 * <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">get_trust_level</a>(name: str) -> Optional[str]</code>
 * <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">list_available_tools</a>(context: Optional[Dict[str, Any]] = None, ttl_seconds: Optional[float] = None) -> List[Union[BaseTool, Callable]]</code>
 * <code title="class ToolRegistry">ToolRegistry.<a href="./src/praisonai-agents/praisonaiagents/tools/registry.py">list_base_tools</a>() -> List[BaseTool]</code>
@@ -493,7 +492,7 @@ Methods:
 * <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">bundles</a>() -> List['BundleManifest']</code>
 * <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">clear</a>() -> None</code>
 * <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">create</a>(name: str, content: str, category: Optional[str] = None, propose: Optional[bool] = None) -> dict</code>
-* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">create_skill</a>(name: str, content: str, category: str = None, agent_created: bool = True, propose: Optional[bool] = None, base_dir: Optional[str] = None) -> dict</code>
+* <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">create_skill</a>(name: str, content: str, category: str = None, agent_created: bool = True, propose: Optional[bool] = None) -> dict</code>
 * <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">delete</a>(name: str, propose: Optional[bool] = None) -> dict</code>
 * <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">delete_skill</a>(name: str, hard: bool = False, propose: Optional[bool] = None) -> dict</code>
 * <code title="class SkillManager">SkillManager.<a href="./src/praisonai-agents/praisonaiagents/skills/manager.py">discover</a>(skill_dirs: Optional[List[str]] = None, include_defaults: bool = True) -> int</code>
@@ -571,13 +570,9 @@ from praisonaiagents import MCP
 
 Methods:
 
-* <code title="class MCP">MCP.<a href="./src/praisonai-agents/praisonaiagents/mcp/mcp.py">apply_tool_filters</a>(allowed_tools: Optional[List[str]] = None, disabled_tools: Optional[List[str]] = None) -> 'MCP'</code>
-* <code title="class MCP">MCP.<a href="./src/praisonai-agents/praisonaiagents/mcp/mcp.py">get_prompts</a>() -> List[dict]</code>
-* <code title="class MCP">MCP.<a href="./src/praisonai-agents/praisonaiagents/mcp/mcp.py">get_resources</a>() -> List[dict]</code>
 * <code title="class MCP">MCP.<a href="./src/praisonai-agents/praisonaiagents/mcp/mcp.py">get_tools</a>() -> List[Callable]</code>
 * <code title="class MCP">MCP.<a href="./src/praisonai-agents/praisonaiagents/mcp/mcp.py">shutdown</a>()</code>
 * <code title="class MCP">MCP.<a href="./src/praisonai-agents/praisonaiagents/mcp/mcp.py">to_openai_tool</a>()</code>
-* <code title="class MCP">MCP.<a href="./src/praisonai-agents/praisonaiagents/mcp/mcp.py">with_tool_prefix</a>(prefix: str) -> 'MCP'</code>
 
 # Telemetry
 
@@ -669,8 +664,6 @@ Methods:
 * <code title="class AutonomyConfig">AutonomyConfig.<a href="./src/praisonai-agents/praisonaiagents/agent/autonomy.py">from_dict</a>(data: Dict[str, Any]) -> 'AutonomyConfig'</code>
 * <code title="class CachingConfig">CachingConfig.<a href="./src/praisonai-agents/praisonaiagents/config/feature_configs.py">to_dict</a>() -> Dict[str, Any]</code>
 * <code title="class ExecutionConfig">ExecutionConfig.<a href="./src/praisonai-agents/praisonaiagents/config/feature_configs.py">from_dict</a>(data: Dict[str, Any]) -> 'ExecutionConfig'</code>
-* <code title="class ExecutionConfig">ExecutionConfig.<a href="./src/praisonai-agents/praisonaiagents/config/feature_configs.py">resolved_max_steps</a>() -> int</code>
-* <code title="class ExecutionConfig">ExecutionConfig.<a href="./src/praisonai-agents/praisonaiagents/config/feature_configs.py">resolved_max_tool_calls</a>() -> int</code>
 * <code title="class ExecutionConfig">ExecutionConfig.<a href="./src/praisonai-agents/praisonaiagents/config/feature_configs.py">to_dict</a>() -> Dict[str, Any]</code>
 * <code title="class GuardrailConfig">GuardrailConfig.<a href="./src/praisonai-agents/praisonaiagents/config/feature_configs.py">to_dict</a>() -> Dict[str, Any]</code>
 * <code title="class HooksConfig">HooksConfig.<a href="./src/praisonai-agents/praisonaiagents/config/feature_configs.py">to_dict</a>() -> Dict[str, Any]</code>
@@ -894,6 +887,18 @@ Methods:
 * <code title="cli">praisonai managed save <a href="./src/praisonai/praisonai/cli/commands/managed.py">--help</a></code>
 * <code title="cli">praisonai managed show <a href="./src/praisonai/praisonai/cli/commands/managed.py">--help</a></code>
 * <code title="cli">praisonai managed update <a href="./src/praisonai/praisonai/cli/commands/managed.py">--help</a></code>
+* <code title="cli">praisonai mcp add <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp auth <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp describe <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp list <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp logout <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp mcp-callback <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp remove <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp run <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp status <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp sync <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp test <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
+* <code title="cli">praisonai mcp tools <a href="./src/praisonai/praisonai/cli/commands/mcp.py">--help</a></code>
 * <code title="cli">praisonai n8n export <a href="./src/praisonai/praisonai/cli/commands/n8n.py">--help</a></code>
 * <code title="cli">praisonai n8n import <a href="./src/praisonai/praisonai/cli/commands/n8n.py">--help</a></code>
 * <code title="cli">praisonai n8n list <a href="./src/praisonai/praisonai/cli/commands/n8n.py">--help</a></code>
@@ -951,6 +956,12 @@ Methods:
 * <code title="cli">praisonai standardise fix <a href="./src/praisonai/praisonai/cli/commands/standardise.py">--help</a></code>
 * <code title="cli">praisonai standardise init <a href="./src/praisonai/praisonai/cli/commands/standardise.py">--help</a></code>
 * <code title="cli">praisonai standardise report <a href="./src/praisonai/praisonai/cli/commands/standardise.py">--help</a></code>
+* <code title="cli">praisonai train agents <a href="./src/praisonai/praisonai/cli/commands/train.py">--help</a></code>
+* <code title="cli">praisonai train apply <a href="./src/praisonai/praisonai/cli/commands/train.py">--help</a></code>
+* <code title="cli">praisonai train list <a href="./src/praisonai/praisonai/cli/commands/train.py">--help</a></code>
+* <code title="cli">praisonai train llm <a href="./src/praisonai/praisonai/cli/commands/train.py">--help</a></code>
+* <code title="cli">praisonai train show <a href="./src/praisonai/praisonai/cli/commands/train.py">--help</a></code>
+* <code title="cli">praisonai train train-callback <a href="./src/praisonai/praisonai/cli/commands/train.py">--help</a></code>
 * <code title="cli">praisonai validate check <a href="./src/praisonai/praisonai/cli/commands/validate.py">--help</a></code>
 * <code title="cli">praisonai validate schema <a href="./src/praisonai/praisonai/cli/commands/validate.py">--help</a></code>
 * <code title="cli">praisonai validate validate <a href="./src/praisonai/praisonai/cli/commands/validate.py">--help</a></code>

docker/Dockerfile.chat

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

docker/Dockerfile.dev

@@ -20,7 +20,7 @@ RUN mkdir -p /root/.praison
 # Install Python packages (using latest versions)
 RUN pip install --no-cache-dir \
     praisonai_tools \
-    "praisonai>=4.6.155" \
+    "praisonai>=4.6.121" \
     "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.6.155" \
+    "praisonai>=4.6.121" \
     "praisonai[ui]" \
     "praisonai[crewai]"
 

examples/doctor/ci_integration.py

@@ -19,9 +19,7 @@ def run_doctor_ci():
         [sys.executable, "-m", "praisonai", "doctor", "ci"],
         capture_output=True,
         text=True,
-        encoding="utf-8",
-        errors="replace",
-        timeout=120,
+        timeout=120
     )
     
     # Parse JSON output

examples/knowledge/compression_demo.py

@@ -149,32 +149,21 @@ def main():
             
             print(f"\nOriginal document length: {len(content)} characters")
             
-            chunks = [{"text": content, "metadata": {"source": doc_path}}]
-
-            # Estimate original tokens (~4 chars/token) so each ratio maps to a
-            # distinct token budget — compress() truncates to target_tokens.
-            original_tokens = max(1, len(content) // 4)
-
             # Compress with different ratios
             for ratio in [0.3, 0.5, 0.7]:
-                target_tokens = max(1, int(original_tokens * ratio))
-                compressor = ContextCompressor(verbose=False)
-                result = compressor.compress(
-                    chunks,
-                    query="security verification code",
-                    target_tokens=target_tokens,
-                    compression_ratio=ratio,
+                compressor = ContextCompressor(
+                    max_tokens=2000,
+                    target_ratio=ratio,
                 )
+                result = compressor.compress([content], query="security verification code")
                 
                 print(f"\nCompression ratio {ratio}:")
                 print(f"  Original tokens: {result.original_tokens}")
                 print(f"  Compressed tokens: {result.compressed_tokens}")
-                print(f"  Actual ratio: {result.compression_ratio:.2f}")
+                print(f"  Actual ratio: {result.compressed_tokens / max(result.original_tokens, 1):.2f}")
                 
                 # Check if secret code is preserved
-                compressed_text = " ".join(
-                    c.get("text", "") for c in result.chunks
-                ) if result.chunks else ""
+                compressed_text = " ".join(result.chunks) if result.chunks else ""
                 if SECRET_CODE in compressed_text:
                     print(f"  ✅ Secret code preserved in compressed output")
                 else:

examples/knowledge/scope_identifiers_example.py

@@ -65,6 +65,7 @@ def main():
             name="Policy_Expert",
             instructions="You are a policy expert.",
             knowledge=[temp_dir],
+            agent_id="policy_agent_v1",  # Knowledge scoped to this agent
         )
         
         response = shared_agent.chat("What are the expense report rules?")
@@ -80,6 +81,7 @@ def main():
             instructions="You are a personal HR assistant.",
             knowledge=[temp_dir],
             memory={"user_id": "user_bob"},
+            agent_id="hr_bot_v2",
         )
         
         response = combined_agent.chat("What training is required?")

examples/persistence/state_redis.py

@@ -13,8 +13,7 @@ Expected Output:
     Agent responds with state persisted to Redis
 """
 
-from praisonaiagents import Agent
-from praisonaiagents.db import db
+from praisonaiagents import Agent, db
 
 print("=== Redis State Store (Agent-First) ===")
 

examples/provider-registry/isolated_registry_example.py

@@ -61,7 +61,7 @@ def demonstrate_collision_problem():
     _reset_default_registry()
     
     # Agent 1 registers "custom" provider
-    register_llm_provider("custom", Agent1Provider, override=True)
+    register_llm_provider("custom", Agent1Provider)
     print("Agent 1 registered 'custom' provider")
     
     # Agent 2 tries to register same name - ERROR!

examples/python/agents/data-analyst-agent.py

@@ -1,5 +1,3 @@
-# praisonai: skip=true
-# Uses removed praisonaiagents.tools exports; pending example refresh
 from praisonaiagents import Agent, Tools
 from praisonaiagents.tools import read_csv, read_excel, write_csv, write_excel, filter_data, get_summary, group_by, pivot_table
 import os
@@ -9,4 +7,4 @@ agent.start(f"""
     Read the data from the csv file {os.path.join(os.path.dirname(__file__), "tesla-stock-price.csv")}
     Analyse the data and give me the insights
     read_csv to read the file
-""")
+""")

examples/python/agents/finance-agent.py

@@ -1,7 +1,5 @@
-# praisonai: skip=true
-# Uses removed praisonaiagents.tools exports; pending example refresh
 from praisonaiagents import Agent, Tools
 from praisonaiagents.tools import get_stock_price, get_stock_info, get_historical_data
 
 agent = Agent(instructions="You are a Research Agent", tools=[get_stock_price, get_stock_info, get_historical_data])
-agent.start("Understand current stock price and historical data of Apple and Google. Tell me if I can invest in them")
+agent.start("Understand current stock price and historical data of Apple and Google. Tell me if I can invest in them")

examples/python/agents/multi-provider-agent.py

@@ -135,7 +135,7 @@ def example_auto_agents_multi_provider():
     from praisonaiagents.agents import AutoAgents
     
     # Create AutoAgents that will automatically assign appropriate models
-    auto_agents = AutoAgents(
+    auto_agents = AutoAgentTeam(
         instructions="Create a market research report on electric vehicles. Include data analysis, competitor analysis, and future projections.",
         max_agents=3,
         llm="gpt-4o-mini",  # Default model for agent generation
@@ -144,7 +144,6 @@ def example_auto_agents_multi_provider():
     
     # After agents are created, upgrade them to multi-model agents
     multi_model_agents = []
-    wrapper_by_original = {}
     for agent in auto_agents.agents:
         # Convert regular agents to multi-model agents
         multi_agent = RouterAgent(
@@ -156,18 +155,9 @@ def example_auto_agents_multi_provider():
             models=["gpt-4o-mini", "gemini/gemini-1.5-flash", "claude-3-haiku-20240307", "gpt-4o-mini"],
             routing_strategy="auto")
         multi_model_agents.append(multi_agent)
-        wrapper_by_original[id(agent)] = multi_agent
     
     # Update the agents in the AutoAgents instance
     auto_agents.agents = multi_model_agents
-
-    # Rebind each task's agent to its wrapper — AutoAgents stores a direct agent
-    # reference on every Task and execution reads task.agent, so replacing only
-    # auto_agents.agents would leave the workflow bound to the original agents.
-    for task in getattr(auto_agents, "tasks", []) or []:
-        wrapper = wrapper_by_original.get(id(task.agent))
-        if wrapper is not None:
-            task.agent = wrapper
     
     # Run the auto-generated workflow
     results = auto_agents.start()

examples/python/agents/wikipedia-agent.py

@@ -1,5 +1,3 @@
-# praisonai: skip=true
-# Uses removed praisonaiagents.tools exports; pending example refresh
 from praisonaiagents import Agent, Task, AgentTeam
 from praisonaiagents.tools import wiki_search, wiki_summary, wiki_page, wiki_random, wiki_language
 
@@ -15,4 +13,4 @@ agent.start(
     "First search the history of AI"
     "Read the page of the history of AI"
     "Get the summary of the page"
-)
+)

examples/python/audio/stt_advanced.py

@@ -1,5 +1,3 @@
-# praisonai: skip=true
-# Requires local audio.mp3 fixture
 from praisonaiagents import AudioAgent
 
 agent = AudioAgent(llm="groq/whisper-large-v3")  # 10x faster
@@ -7,4 +5,3 @@ text = agent.transcribe("audio.mp3", language="en")
 print(text)
 
 # Models: openai/whisper-1, groq/whisper-large-v3, deepgram/nova-2
-

examples/python/audio/stt_basic.py

@@ -1,5 +1,3 @@
-# praisonai: skip=true
-# Requires local audio.mp3 fixture
 # Speech-to-Text with Groq (fastest)
 # Requires: export GROQ_API_KEY=your-key
 
@@ -8,4 +6,3 @@ from praisonaiagents import AudioAgent
 agent = AudioAgent(llm="groq/whisper-large-v3")
 text = agent.listen("audio.mp3")  # Replace with your audio file
 print(text)
-

examples/python/audio/stt_deepgram.py

@@ -1,8 +1,5 @@
-# praisonai: skip=true
-# Requires local audio.mp3 fixture
 from praisonaiagents import AudioAgent
 
 agent = AudioAgent(llm="deepgram/nova-2")
 text = agent.listen("audio.mp3")
 print(text)
-

examples/python/audio/stt_groq.py

@@ -1,8 +1,5 @@
-# praisonai: skip=true
-# Requires local audio.mp3 fixture
 from praisonaiagents import AudioAgent
 
 agent = AudioAgent(llm="groq/whisper-large-v3")
 text = agent.listen("audio.mp3")
 print(text)
-

examples/python/audio/stt_openai.py

@@ -1,8 +1,5 @@
-# praisonai: skip=true
-# Requires local audio.mp3 fixture
 from praisonaiagents import AudioAgent
 
 agent = AudioAgent(llm="openai/whisper-1")
 text = agent.listen("audio.mp3")
 print(text)
-

examples/python/bot_standalone_example.py

@@ -1,33 +0,0 @@
-"""
-Standalone gateway example (praisonai-bot first).
-
-Install:
-    pip install praisonaiagents "praisonai-bot[gateway]"
-
-Set credentials:
-    export OPENAI_API_KEY=your_key
-
-Run:
-    python bot_standalone_example.py
-
-For Telegram/Discord/Slack channels, use the CLI after onboarding:
-    praisonai-bot onboard
-    praisonai-bot bot start --platform telegram
-"""
-
-import asyncio
-
-from praisonaiagents import Agent
-from praisonaiagents.gateway import GatewayConfig
-from praisonai_bot.gateway import WebSocketGateway
-
-assistant = Agent(name="assistant", instructions="You are a helpful assistant.")
-
-config = GatewayConfig(host="127.0.0.1", port=8765)
-gateway = WebSocketGateway(config=config)
-gateway.register_agent(assistant, agent_id="assistant")
-
-if __name__ == "__main__":
-    print("Gateway: ws://127.0.0.1:8765  health: http://127.0.0.1:8765/health")
-    print("CLI equivalent: praisonai-bot gateway start --host 127.0.0.1 --port 8765")
-    asyncio.run(gateway.start())

examples/python/eval/loop_health_eval.py

@@ -1,56 +0,0 @@
-"""
-Loop Health Evaluation Example
-
-Demonstrates ``LoopEvaluator``, which scores loop *health* (convergence,
-wasted iterations, doom-loop guard events) on top of an ``EvaluationLoop`` run.
-
-Where ``EvaluationLoop`` tells you *what* score the agent reached, the
-``LoopEvaluator`` tells you *how healthy* the loop was getting there:
-- Did it converge, and in how many iterations?
-- Were iterations wasted after the threshold was already met?
-- Did a doom-loop safety guard fire?
-
-Usage:
-    pip install praisonaiagents
-    export OPENAI_API_KEY=your-key
-    python loop_health_eval.py
-"""
-from praisonaiagents import Agent
-from praisonaiagents.eval import EvaluationLoop, LoopEvaluator
-
-
-def main():
-    agent = Agent(
-        name="writer",
-        instructions="You are a technical writer. Write clear, accurate explanations.",
-    )
-
-    loop = EvaluationLoop(
-        agent=agent,
-        criteria="Explanation is clear, accurate, and complete.",
-        threshold=8.0,
-        max_iterations=5,
-    )
-
-    # 1. Run the quality loop (existing behaviour).
-    loop_result = loop.run("Explain how HTTPS works.")
-    loop_result.print_summary()
-
-    # 2. Collect any structured guard events emitted during the run.
-    #    In a real setup these would come from doom_loop.py / loop_detection
-    #    plugins. Here we pass an empty list (no guards fired).
-    guard_events = []
-
-    # 3. Score loop health.
-    health = LoopEvaluator(threshold=8.0).run(loop_result, guard_events=guard_events)
-    health.print_summary()
-
-    if not health.success:
-        print("\n⚠️  Loop was UNHEALTHY:")
-        print(f"    {health.reasoning}")
-    else:
-        print("\n✅  Loop was healthy.")
-
-
-if __name__ == "__main__":
-    main()

examples/python/general/auto_agents_example.py

@@ -18,7 +18,7 @@ from praisonaiagents import AutoAgents
 from praisonaiagents.tools import duckduckgo
 
 # Basic usage - AutoAgents analyzes complexity and creates optimal agents
-agents = AutoAgents(
+agents = AutoAgentTeam(
     instructions="Search for information about AI Agents",
     tools=[duckduckgo],
     process="sequential",  # or "hierarchical"

examples/python/general/autonomous-agent.py

@@ -102,14 +102,7 @@ def main():
     # Print results
     print("\nAutonomous Agent Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             task_name = result.description
             print(f"\nTask: {task_name}")

examples/python/general/evaluator-optimiser.py

@@ -64,13 +64,6 @@ results = workflow.start()
 
 # Print results
 print("\nEvaluator-Optimizer Results:")
-task_results = (
-    results.get("task_results", {})
-    if isinstance(results, dict)
-    else {}
-)
-if not task_results and isinstance(results, str):
-    print(f"\nWorkflow output:\n{results}")
-for task_id, result in task_results.items():
+for task_id, result in results["task_results"].items():
     if result:
         print(f"Task {task_id}: {result.raw}")

examples/python/general/memory_simple.py

@@ -1,4 +1,4 @@
-from praisonaiagents.agents.agents import Agent, Task, Agents, AgentTeam
+from praisonaiagents.agents.agents import Agent, Task, Agents
 from praisonaiagents.tools import duckduckgo
 
 # Test facts

examples/python/general/orchestrator-workers.py

@@ -104,13 +104,6 @@ results = workflow.start()
 
 # Print results
 print("\nOrchestrator-Workers Results:")
-task_results = (
-    results.get("task_results", {})
-    if isinstance(results, dict)
-    else {}
-)
-if not task_results and isinstance(results, str):
-    print(f"\nWorkflow output:\n{results}")
-for task_id, result in task_results.items():
+for task_id, result in results["task_results"].items():
     if result:
         print(f"Task {task_id}: {result.raw}")

examples/python/general/parallelisation.py

@@ -86,14 +86,7 @@ async def main():
 
     # Print results
     print("\nParallel Processing Results:")
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"Task {task_id}: {result.raw}")
 

examples/python/general/prompt_chaining.py

@@ -1,6 +1,6 @@
 from praisonaiagents.agent import Agent
 from praisonaiagents.task import Task
-from praisonaiagents.agents import Agents, AgentTeam
+from praisonaiagents.agents import Agents
 from typing import List, Dict
 import time
 
@@ -76,13 +76,6 @@ results = workflow.start(return_dict=True)
 
 # Print results
 print("\nWorkflow Results:")
-task_results = (
-    results.get("task_results", {})
-    if isinstance(results, dict)
-    else {}
-)
-if not task_results and isinstance(results, str):
-    print(f"\nWorkflow output:\n{results}")
-for task_id, result in task_results.items():
+for task_id, result in results["task_results"].items():
     if result:
         print(f"Task {task_id}: {result.raw}")

examples/python/sandbox_example.py

@@ -132,7 +132,6 @@ if __name__ == "__main__":
     demonstrate_result_handling()
     
     print("To run code in sandbox via CLI:")
-    print("  praisonai sandbox run --code \"print('Hello, World!')\"")
-    print("  praisonai sandbox run --file script.py --type docker")
+    print("  praisonai sandbox run \"print('Hello, World!')\"")
+    print("  praisonai sandbox run --file script.py")
     print("  praisonai sandbox shell")
-    print("  praisonai sandbox backends")

examples/python/usecases/adaptive-learning.py

@@ -121,14 +121,7 @@ def main():
     # Print results
     print("\nAdaptive Learning Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/climate-impact.py

@@ -204,14 +204,7 @@ async def main():
     # Print results
     print("\nClimate Impact Analysis Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/code-review.py

@@ -97,14 +97,7 @@ def main():
     # Print results
     print("\nCode Review Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/crypto-validator.py

@@ -222,14 +222,7 @@ async def main():
     # Print results
     print("\nCryptography Validation Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/customer-service.py

@@ -128,14 +128,7 @@ def main():
     # Print results
     print("\nCustomer Service Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/defi-market-maker.py

@@ -208,14 +208,7 @@ async def main():
     # Print results
     print("\nMarket Making Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/disaster-recovery.py

@@ -401,14 +401,7 @@ async def main():
     # Print results
     print("\nDisaster Recovery Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/emergency-response.py

@@ -128,14 +128,7 @@ def main():
     # Print results
     print("\nEmergency Response Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/fraud-detection.py

@@ -125,14 +125,7 @@ async def main():
     # Print results
     print("\nFraud Detection Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/healthcare-diagnosis.py

@@ -153,14 +153,7 @@ def main():
     # Print results
     print("\nDiagnosis Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/medicine-protocol.py

@@ -206,14 +206,7 @@ async def main():
     # Print results
     print("\nProtocol Generation Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/multilingual-content.py

@@ -150,14 +150,7 @@ def main():
     # Print results
     print("\nContent Generation Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/neural-architecture.py

@@ -191,14 +191,7 @@ async def main():
     # Print results
     print("\nArchitecture Search Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/predictive-maintenance.py

@@ -169,14 +169,7 @@ async def main():
     # Print results
     print("\nMaintenance Planning Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/quantum-optimiser.py

@@ -186,14 +186,7 @@ async def main():
     # Print results
     print("\nOptimization Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/research-assistant.py

@@ -181,14 +181,7 @@ async def main():
     # Print results
     print("\nResearch Analysis Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/smart-city.py

@@ -175,14 +175,7 @@ def main():
     # Print results
     print("\nOptimization Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/space-mission.py

@@ -220,14 +220,7 @@ async def main():
     # Print results
     print("\nResource Optimization Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/supply-chain.py

@@ -102,14 +102,7 @@ def main():
     # Print results
     print("\nRisk Management Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/usecases/vulnerability-detection.py

@@ -184,14 +184,7 @@ async def main():
     # Print results
     print("\nVulnerability Detection Results:")
     print("=" * 50)
-    task_results = (
-        results.get("task_results", {})
-        if isinstance(results, dict)
-        else {}
-    )
-    if not task_results and isinstance(results, str):
-        print(f"\nWorkflow output:\n{results}")
-    for task_id, result in task_results.items():
+    for task_id, result in results["task_results"].items():
         if result:
             print(f"\nTask: {task_id}")
             print(f"Result: {result.raw}")

examples/python/workflows/workflow_loop_csv.py

@@ -4,7 +4,7 @@ Agentic Loop with CSV Workflow Example
 Demonstrates iterating over a CSV file with an agent processing each row.
 """
 
-from praisonaiagents import Agent, AgentFlow, Workflow
+from praisonaiagents import Agent, Workflow
 from praisonaiagents.workflows import loop
 import tempfile
 import os

examples/python/workflows/workflow_repeat.py

@@ -5,7 +5,7 @@ Demonstrates the evaluator-optimizer pattern where an agent
 generates content and another evaluates it, repeating until approved.
 """
 
-from praisonaiagents import Agent, AgentFlow, Workflow
+from praisonaiagents import Agent, Workflow
 from praisonaiagents.workflows import repeat
 
 # Create generator agent

examples/routing/routellm_workflow.py

@@ -12,7 +12,7 @@ Prerequisites:
      --port 6060
 """
 
-from praisonaiagents import Agent, AgentFlow, Workflow
+from praisonaiagents import Agent, Workflow
 
 ROUTELLM_URL = "http://localhost:6060/v1"
 

examples/serve/tools_as_mcp_server.py

@@ -78,7 +78,7 @@ def main():
   }''')
     print("\nPress Ctrl+C to stop")
     
-    server.run_sse(port=8081)
+    server.run(transport="sse", host="0.0.0.0", port=8081)
 
 
 def run_manual_server():

examples/terminal_bench/README.md

@@ -1,40 +1,18 @@
-# Terminal-Bench 2.1 Integration with PraisonAI
+# Terminal-Bench 2.0 Integration with PraisonAI
 
-This directory contains adapters for benchmarking PraisonAI on **Terminal-Bench 2.1** via the **Harbor framework**. Everything lives in the examples/benchmark layer + CI — there are **zero changes to the `praisonaiagents` / `praisonai` SDK surface**.
+This directory contains examples for integrating PraisonAI Agents with **Terminal-Bench 2.0** via the **Harbor framework** for AI agent benchmarking.
 
 ## Overview
 
-[Terminal-Bench 2.1](https://www.tbench.ai/docs/run-terminal-bench-2-1) is the current release of the Laude Institute benchmark for evaluating AI coding agents in real terminal environments. The [Harbor framework](https://github.com/laude-institute/harbor) is the official evaluation harness that abstracts container lifecycle, parallelization, and cloud providers.
-
-## Setup
-
-Install Harbor and PraisonAI into **one venv** and run from the repo root with `PYTHONPATH=.` so the adapter import path resolves:
-
-```bash
-pip install harbor
-pip install -e src/praisonai-agents -e src/praisonai
-export PYTHONPATH=.
-```
+[Terminal-Bench 2.0](https://tbench.ai) is a Stanford/Laude Institute benchmark that has become the gold standard for evaluating AI coding agents in real terminal environments. The [Harbor framework](https://harborframework.com) is the official evaluation harness that abstracts container lifecycle, parallelization, and cloud providers.
 
 ## Integration Types
 
-### 0. Code Agent (headline — benchmarks `praisonai code`)
-- **File**: `praisonai_code_agent.py`
-- **Purpose**: Installs and drives the terminal-native `praisonai code` assistant headlessly inside the container.
-- **Run**:
-  ```bash
-  PYTHONPATH=. harbor run -d terminal-bench/terminal-bench-2-1 \
-    --agent "examples.terminal_bench.praisonai_code_agent:PraisonAICodeAgent" \
-    -m openai/gpt-4o-mini \
-    --ae OPENAI_API_KEY=$OPENAI_API_KEY \
-    -n 4
-  ```
-
 ### 1. External Agent (Direct Agent Class)
 - **File**: `praisonai_external_agent.py`
 - **Purpose**: External agent that uses direct `Agent()` class instantiation
-- **Usage**: Run with `--agent "module:Class"`
-- **Approach**: Uses `praisonaiagents.Agent` directly with a bash tool bridged to Harbor's `exec()`
+- **Usage**: Run with `--agent-import-path` flag
+- **Approach**: Uses `praisonaiagents.Agent` directly with `execute_command` tool
 
 ### 2. Wrapper Agent (CLI-Based)
 - **File**: `praisonai_wrapper_agent.py`
@@ -64,12 +42,12 @@ pip install praisonaiagents[tools]
 
 ```bash
 # Test with oracle agent first
-harbor run -d terminal-bench/terminal-bench-2-1 -a oracle
+harbor run -d terminal-bench/terminal-bench-2 -a oracle
 
 # Run PraisonAI external agent (uses direct Agent() class)
-PYTHONPATH=. harbor run -d terminal-bench/terminal-bench-2-1 \
-  --agent "examples.terminal_bench.praisonai_external_agent:PraisonAIExternalAgent" \
-  --model openai/gpt-4o-mini \
+harbor run -d terminal-bench/terminal-bench-2 \
+  --agent-import-path examples.terminal_bench.praisonai_external_agent:PraisonAIExternalAgent \
+  --model openai/gpt-4o \
   --ae OPENAI_API_KEY=$OPENAI_API_KEY \
   -n 4
 ```
@@ -78,9 +56,9 @@ PYTHONPATH=. harbor run -d terminal-bench/terminal-bench-2-1 \
 
 ```bash
 # Run PraisonAI wrapper agent (uses `praisonai "TASK"` CLI pattern)
-PYTHONPATH=. harbor run -d terminal-bench/terminal-bench-2-1 \
-  --agent "examples.terminal_bench.praisonai_wrapper_agent:PraisonAIWrapperAgent" \
-  --model openai/gpt-4o-mini \
+harbor run -d terminal-bench/terminal-bench-2 \
+  --agent-import-path examples.terminal_bench.praisonai_wrapper_agent:PraisonAIWrapperAgent \
+  --model openai/gpt-4o \
   --ae OPENAI_API_KEY=$OPENAI_API_KEY \
   -n 4
 ```
@@ -88,9 +66,9 @@ PYTHONPATH=. harbor run -d terminal-bench/terminal-bench-2-1 \
 ### Running on Cloud (Daytona/E2B/Modal)
 
 ```bash
-PYTHONPATH=. harbor run -d terminal-bench/terminal-bench-2-1 \
-  --agent "examples.terminal_bench.praisonai_external_agent:PraisonAIExternalAgent" \
-  --model openai/gpt-4o-mini \
+harbor run -d terminal-bench/terminal-bench-2 \
+  --agent-import-path examples.terminal_bench.praisonai_external_agent:PraisonAIExternalAgent \
+  --model openai/gpt-4o \
   --env daytona -n 32 \
   --ae OPENAI_API_KEY=$OPENAI_API_KEY
 ```
@@ -122,9 +100,6 @@ PYTHONPATH=. harbor run -d terminal-bench/terminal-bench-2-1 \
 ## Files
 
 - `README.md` - This documentation
-- `praisonai_code_agent.py` - **Headline** adapter benchmarking `praisonai code`
-- `job_code_smoke.yaml` - Smoke-test job config for the code agent
-- `RESULTS.md` - Recorded pass-rates
 - `praisonai_external_agent.py` - External agent (direct Agent class)
 - `praisonai_wrapper_agent.py` - Wrapper agent (CLI-based approach)
 - `praisonai_installed_agent.py` - Installed agent implementation  
@@ -152,7 +127,7 @@ Each task provides:
 
 ## Contributing
 
-1. Test changes with oracle agent first: `harbor run -d terminal-bench/terminal-bench-2-1 -a oracle`
+1. Test changes with oracle agent first: `harbor run -d terminal-bench/terminal-bench-2 -a oracle`
 2. Run real agentic tests to ensure end-to-end functionality
 3. Follow PraisonAI's AGENTS.md architecture guidelines
 4. Add both unit tests and integration tests

examples/terminal_bench/RESULTS.md

@@ -1,19 +0,0 @@
-# Terminal-Bench 2.1 Results — PraisonAI
-
-Pass-rates from the Harbor smoke workflow
-(`.github/workflows/terminal-bench-smoke.yml`, manual dispatch). The full 2.1
-dataset (89 tasks) can be scored by dropping the `task_names` filter in
-`job.yaml`.
-
-| Date | Agent | Model | Tasks | Pass rate | Harbor artifact |
-|------|-------|-------|-------|-----------|-----------------|
-| _pending first run_ | `praisonai code` | `openai/gpt-4o-mini` | smoke (3) | — | — |
-
-## How scores are produced
-
-```bash
-PYTHONPATH=. harbor run -c examples/terminal_bench/job_code_smoke.yaml
-```
-
-The workflow uploads the Harbor results directory as a CI artifact and appends
-the pass-rate row above.

examples/terminal_bench/job.yaml

@@ -1,20 +1,83 @@
-# Harbor Job Configuration — PraisonAI external (SDK-level) agent on Terminal-Bench 2.1
+# Harbor Job Configuration for PraisonAI on Terminal-Bench 2.0
+# 
+# Usage:
+#   harbor run -c examples/terminal_bench/job.yaml
 #
-# Run from the repo root with PYTHONPATH set:
-#   PYTHONPATH=. harbor run -c examples/terminal_bench/job.yaml
+# This configuration runs PraisonAI external agent on Terminal-Bench 2.0 tasks
+# with 8 concurrent trials using GPT-4o.
+
+# Dataset: Terminal-Bench 2.0 (89 carefully curated terminal tasks)
+dataset: terminal-bench/terminal-bench-2
+
+# Agent configuration
+agent:
+  # Use import path for external agent
+  import_path: examples.terminal_bench.praisonai_external_agent:PraisonAIExternalAgent
+  
+  # Model configuration
+  model_name: openai/gpt-4o
+  
+  # Environment variables (API keys)
+  env:
+    OPENAI_API_KEY: "${OPENAI_API_KEY}"
+    # Optional: Add other API keys if using different models
+    # ANTHROPIC_API_KEY: "${ANTHROPIC_API_KEY}"
+    # GEMINI_API_KEY: "${GEMINI_API_KEY}"
+
+# Execution configuration
+n_concurrent: 8        # Run 8 trials in parallel
+n_attempts: 1          # Single attempt per task (benchmark standard)
+
+# Optional: Environment configuration for cloud execution
+# environment:
+#   provider: daytona    # Options: local, daytona, e2b, modal, runloop, gke
+#   n_concurrent: 32     # Higher concurrency on cloud
+
+# Optional: Filter to specific tasks for testing
+# task_filter:
+#   task_names: ["compile_simple_c", "install_python_package", "create_directory"]
+
+# Optional: Advanced configuration
+# timeout_sec: 600       # 10 minute timeout per task
+# save_logs: true        # Save execution logs
+# save_artifacts: true   # Save container artifacts
+
+---
+
+# Alternative configuration using wrapper agent (CLI-based approach)
+# Uses `praisonai "TASK"` pattern instead of direct Agent class
+# Uncomment to use the wrapper approach:
+
+# dataset: terminal-bench/terminal-bench-2
 #
-# Uses the REAL Harbor JobConfig schema. A single YAML document only —
-# multiple `---` documents make yaml.safe_load raise ComposerError.
+# agent:
+#   import_path: examples.terminal_bench.praisonai_wrapper_agent:PraisonAIWrapperAgent
+#   model_name: openai/gpt-4o
+#
+# n_concurrent: 8
+# n_attempts: 1
+#
+# env:
+#   OPENAI_API_KEY: "${OPENAI_API_KEY}"
 
-datasets:
-  - name: terminal-bench
-    version: "2.1"
+---
 
-agents:
-  - import_path: examples.terminal_bench.praisonai_external_agent:PraisonAIExternalAgent
-    model_name: openai/gpt-4o-mini
-    env:
-      OPENAI_API_KEY: "${OPENAI_API_KEY}"
+# Alternative configuration using installed agent (requires Harbor integration)
+# Uncomment this section once PraisonAI is integrated into Harbor's codebase
 
-n_concurrent_trials: 4
-n_attempts: 1
+# dataset: terminal-bench/terminal-bench-2
+# 
+# agent:
+#   name: praisonai
+#   model_name: openai/gpt-4o
+#   flags:
+#     max_turns: 30
+#     verbose: false
+#     memory: false
+#     auto_approval: true
+# 
+# n_concurrent: 8
+# n_attempts: 1
+# 
+# env:
+#   OPENAI_API_KEY: "${OPENAI_API_KEY}"

examples/terminal_bench/job_code_smoke.yaml

@@ -1,28 +0,0 @@
-# Harbor Job Configuration — `praisonai code` smoke test on Terminal-Bench 2.1
-#
-# Run from the repo root with PYTHONPATH set so the adapter import path resolves:
-#   PYTHONPATH=. harbor run -c examples/terminal_bench/job_code_smoke.yaml
-#
-# Schema note: this uses the REAL Harbor JobConfig schema
-# (datasets/agents/n_concurrent_trials/n_attempts). Unknown keys are silently
-# ignored by pydantic, so the older dataset:/agent:/n_concurrent: form runs the
-# default oracle agent on zero tasks — do not use it.
-
-datasets:
-  - name: terminal-bench
-    version: "2.1"
-    # A small verified subset for a cheap smoke run. Verify against the registry
-    # with `harbor datasets list` before editing.
-    task_names:
-      - hello-world
-      - fix-permissions
-      - csv-to-parquet
-
-agents:
-  - import_path: examples.terminal_bench.praisonai_code_agent:PraisonAICodeAgent
-    model_name: openai/gpt-4o-mini
-    env:
-      OPENAI_API_KEY: "${OPENAI_API_KEY}"
-
-n_concurrent_trials: 2
-n_attempts: 1

examples/terminal_bench/job_test_5.yaml

@@ -1,24 +1,22 @@
-# Harbor Job Configuration — PraisonAI external agent, small verified subset
-#
-# Run from the repo root:
-#   PYTHONPATH=. harbor run -c examples/terminal_bench/job_test_5.yaml
-#
-# Real Harbor JobConfig schema. Verify task_names against `harbor datasets list`
-# before editing.
+# Harbor Job Configuration for PraisonAI - 5 Task Test
+# Run with: harbor run -c examples/terminal_bench/job_test_5.yaml -n 1
 
-datasets:
-  - name: terminal-bench
-    version: "2.1"
-    task_names:
-      - hello-world
-      - fix-permissions
-      - csv-to-parquet
+dataset: terminal-bench/terminal-bench-2
 
-agents:
-  - import_path: examples.terminal_bench.praisonai_external_agent:PraisonAIExternalAgent
-    model_name: openai/gpt-4o-mini
-    env:
-      OPENAI_API_KEY: "${OPENAI_API_KEY}"
+agent:
+  import_path: examples.terminal_bench.praisonai_external_agent:PraisonAIExternalAgent
+  model_name: openai/gpt-4o-mini
+  env:
+    OPENAI_API_KEY: "${OPENAI_API_KEY}"
 
-n_concurrent_trials: 1
+n_concurrent: 1
 n_attempts: 1
+
+# Filter to 5 specific simple tasks
+task_filter:
+  task_names:
+    - "hello-world"
+    - "fix-permissions"
+    - "create-bucket"
+    - "csv-to-parquet"
+    - "simple-web-scraper"

examples/terminal_bench/job_test_5_wrapper.yaml

@@ -1,24 +1,22 @@
-# Harbor Job Configuration — PraisonAI wrapper (CLI) agent, small verified subset
-#
-# Run from the repo root:
-#   PYTHONPATH=. harbor run -c examples/terminal_bench/job_test_5_wrapper.yaml
-#
-# Real Harbor JobConfig schema. Verify task_names against `harbor datasets list`
-# before editing.
+# Harbor Job Configuration for PraisonAI Wrapper - 5 Task Test
+# Run with: harbor run -c examples/terminal_bench/job_test_5_wrapper.yaml -n 1
 
-datasets:
-  - name: terminal-bench
-    version: "2.1"
-    task_names:
-      - hello-world
-      - fix-permissions
-      - csv-to-parquet
+dataset: terminal-bench/terminal-bench-2
 
-agents:
-  - import_path: examples.terminal_bench.praisonai_wrapper_agent:PraisonAIWrapperAgent
-    model_name: openai/gpt-4o-mini
-    env:
-      OPENAI_API_KEY: "${OPENAI_API_KEY}"
+agent:
+  import_path: examples.terminal_bench.praisonai_wrapper_agent:PraisonAIWrapperAgent
+  model_name: openai/gpt-4o-mini
+  env:
+    OPENAI_API_KEY: "${OPENAI_API_KEY}"
 
-n_concurrent_trials: 1
+n_concurrent: 1
 n_attempts: 1
+
+# Filter to 5 specific simple tasks
+task_filter:
+  task_names:
+    - "hello-world"
+    - "fix-permissions"
+    - "create-bucket"
+    - "csv-to-parquet"
+    - "simple-web-scraper"

examples/terminal_bench/multi_agent_example.py

@@ -13,7 +13,7 @@ The multi-agent approach is useful for Terminal-Bench tasks that benefit from:
 Usage:
     harbor run -d terminal-bench/terminal-bench-2 \
         --agent-import-path examples.terminal_bench.multi_agent_example:MultiAgentPraisonAI \
-        --model openai/gpt-4o-mini
+        --model openai/gpt-4o
 """
 
 import asyncio
@@ -79,7 +79,7 @@ class MultiAgentPraisonAI(BaseAgent):
                     return "Error: Empty command"
                     
                 try:
-                    result = await environment.exec(command=command, timeout_sec=300)
+                    result = await environment.exec(command=command, timeout_sec=30)
                     output_parts = []
                     if result.stdout:
                         output_parts.append(result.stdout.strip())
@@ -101,7 +101,7 @@ class MultiAgentPraisonAI(BaseAgent):
                     "Consider potential issues and edge cases. "
                     "Output your plan as a numbered list of specific actions."
                 ),
-                llm=self.model_name or "openai/gpt-4o-mini",
+                llm=self.model_name or "openai/gpt-4o",
             )
             
             executor = Agent(
@@ -114,7 +114,7 @@ class MultiAgentPraisonAI(BaseAgent):
                     "If a step fails, try alternative approaches."
                 ),
                 tools=[bash_tool],
-                llm=self.model_name or "openai/gpt-4o-mini", 
+                llm=self.model_name or "openai/gpt-4o", 
             )
             
             verifier = Agent(
@@ -127,7 +127,7 @@ class MultiAgentPraisonAI(BaseAgent):
                     "If issues are found, suggest specific fixes."
                 ),
                 tools=[bash_tool],
-                llm=self.model_name or "openai/gpt-4o-mini",
+                llm=self.model_name or "openai/gpt-4o",
             )
 
             print(f"🚀 Multi-Agent PraisonAI starting: {instruction[:100]}...")
@@ -194,7 +194,7 @@ class MultiAgentPraisonAI(BaseAgent):
                 "framework": "praisonai-multi",
                 "agent_type": "multi-agent-team", 
                 "agents": [agent.name for agent in agents],
-                "model": self.model_name or "openai/gpt-4o-mini",
+                "model": self.model_name or "openai/gpt-4o",
                 "phases": ["planning", "execution", "verification"],
                 "tools_used": ["bash_tool"],
                 "result_summary": str(result.get("verification", ""))[:200],
@@ -238,7 +238,7 @@ class AgentTeamPraisonAI(BaseAgent):
         try:
             # Create bash tool
             async def bash_tool(command: str) -> str:
-                result = await environment.exec(command=command, timeout_sec=300)
+                result = await environment.exec(command=command, timeout_sec=30)
                 output_parts = []
                 if result.stdout:
                     output_parts.append(result.stdout.strip())
@@ -252,14 +252,14 @@ class AgentTeamPraisonAI(BaseAgent):
             planner = Agent(
                 name="planner",
                 instructions="Create detailed execution plans for terminal tasks",
-                llm=self.model_name or "openai/gpt-4o-mini"
+                llm=self.model_name or "openai/gpt-4o"
             )
             
             executor = Agent(
                 name="executor",
                 instructions="Execute terminal commands based on plans",
                 tools=[bash_tool],
-                llm=self.model_name or "openai/gpt-4o-mini"
+                llm=self.model_name or "openai/gpt-4o"
             )
             
             # Create tasks
@@ -317,12 +317,12 @@ if __name__ == "__main__":
     print("# Multi-agent custom workflow")
     print("harbor run -d terminal-bench/terminal-bench-2 \\")
     print("  --agent-import-path examples.terminal_bench.multi_agent_example:MultiAgentPraisonAI \\")
-    print("  --model openai/gpt-4o-mini")
+    print("  --model openai/gpt-4o")
     print()
     print("# AgentTeam structured workflow")  
     print("harbor run -d terminal-bench/terminal-bench-2 \\")
     print("  --agent-import-path examples.terminal_bench.multi_agent_example:AgentTeamPraisonAI \\")
-    print("  --model openai/gpt-4o-mini")
+    print("  --model openai/gpt-4o")
     print()
     print("Benefits of multi-agent approach:")
     print("- Task decomposition and planning")

examples/terminal_bench/praisonai_code_agent.py

@@ -1,127 +0,0 @@
-"""
-PraisonAI Code Agent for Terminal-Bench 2.1 (Harbor)
-
-The headline adapter: benchmarks the terminal-native `praisonai code` assistant
-by installing it inside the Harbor container and driving it headlessly.
-
-Usage:
-    harbor run -d terminal-bench/terminal-bench-2-1 \
-        --agent "examples.terminal_bench.praisonai_code_agent:PraisonAICodeAgent" \
-        -m openai/gpt-4o-mini \
-        --ae OPENAI_API_KEY=$OPENAI_API_KEY \
-        -n 4
-
-Architecture:
-    Harbor Container → `praisonai code "TASK" --dangerously-skip-approval` (headless)
-
-Notes:
-    - `--dangerously-skip-approval` sets PRAISON_APPROVAL_MODE=auto +
-      PRAISONAI_TOOL_SAFETY=off so the assistant runs fully autonomously in the
-      container (no approval hang in a non-TTY session).
-    - `praisonai code` normally exits 0 and Harbor grades by task verification,
-      so a benchmark miss does not fail the run — but the real exit status is
-      propagated so genuine install/auth/startup failures still surface.
-    - The base `praisonai` package is sufficient; heavy `code` extras are not
-      required (ACP tools degrade gracefully).
-
-Dependencies:
-    pip install harbor praisonai praisonaiagents
-"""
-
-import shlex
-
-try:
-    from harbor.agents.installed.base import BaseInstalledAgent
-    from harbor.environments.base import BaseEnvironment
-    from harbor.models.agent.context import AgentContext
-except ImportError as e:  # pragma: no cover - only importable when Harbor present
-    raise ImportError(
-        f"Harbor framework not installed: {e}\n"
-        "Install with: pip install harbor"
-    ) from e
-
-
-class PraisonAICodeAgent(BaseInstalledAgent):
-    """Benchmarks the `praisonai code` terminal assistant inside a Harbor container."""
-
-    @staticmethod
-    def name() -> str:
-        return "praisonai-code"
-
-    def get_version_command(self) -> str:
-        return "praisonai --version"
-
-    async def install(self, environment: BaseEnvironment) -> None:
-        """Install python + the praisonai CLI inside the container."""
-        # System packages (best-effort; image may already have them).
-        await self.exec_as_root(
-            environment,
-            command="apt-get update && apt-get install -y python3 python3-pip || true",
-            env={"DEBIAN_FRONTEND": "noninteractive"},
-        )
-
-        # PEP 668-safe install on bookworm-based images.
-        version_spec = f"=={self._version}" if getattr(self, "_version", None) else ""
-        await self.exec_as_agent(
-            environment,
-            command=(
-                f"pip install --break-system-packages praisonai{version_spec} "
-                "praisonaiagents"
-            ),
-        )
-
-    async def run(
-        self,
-        instruction: str,
-        environment: BaseEnvironment,
-        context: AgentContext,
-    ) -> None:
-        """Drive `praisonai code` headlessly on the instruction."""
-        model = self.model_name or "openai/gpt-4o-mini"
-
-        command = (
-            f"praisonai code {shlex.quote(instruction)} "
-            f"--dangerously-skip-approval "
-            f"--model {shlex.quote(model)} "
-            "> /tmp/praisonai_code.log 2>&1; "
-            # Capture the real exit status so install/auth/startup failures still
-            # surface instead of being silently masked (Harbor otherwise records a
-            # completed attempt for a crashed agent).
-            "status=$?; "
-            # Tee the log into a stable path so populate_context_post_run can read it.
-            "cp /tmp/praisonai_code.log /tmp/praisonai_code_run.log 2>/dev/null || true; "
-            # `praisonai code` normally exits 0 (Harbor grades by task
-            # verification), so a genuine benchmark miss won't fail here — but a
-            # nonzero status means the assistant itself failed to run.
-            "exit $status"
-        )
-
-        # `extra_env` is the --ae channel; merge it into the exec env (never host
-        # os.environ). `env` on BaseInstalledAgent already includes extra_env.
-        await self.exec_as_agent(
-            environment,
-            command=command,
-            env=self.env,
-        )
-
-    def populate_context_post_run(self, context: AgentContext) -> None:
-        """`praisonai code` exposes no machine-readable metrics headlessly.
-
-        Record identifying metadata; token/cost accounting is not available from
-        the CLI's mixed stdout, so we leave those fields unset rather than guess.
-        """
-        context.metadata = {
-            "framework": "praisonai",
-            "agent_type": "code-cli",
-            "agent_name": self.name(),
-            "model": self.model_name,
-            "log_path": "/tmp/praisonai_code.log",
-        }
-
-
-if __name__ == "__main__":
-    print("PraisonAI Code Agent for Terminal-Bench 2.1")
-    print("Usage:")
-    print("  harbor run -d terminal-bench/terminal-bench-2-1 \\")
-    print('    --agent "examples.terminal_bench.praisonai_code_agent:PraisonAICodeAgent" \\')
-    print("    -m openai/gpt-4o-mini --ae OPENAI_API_KEY=$OPENAI_API_KEY -n 4")

examples/terminal_bench/praisonai_external_agent.py

@@ -7,7 +7,7 @@ BaseEnvironment interface. The agent uses Harbor's exec() as a bash tool.
 Usage:
     harbor run -d terminal-bench/terminal-bench-2 \
         --agent-import-path examples.terminal_bench.praisonai_external_agent:PraisonAIExternalAgent \
-        --model openai/gpt-4o-mini \
+        --model openai/gpt-4o \
         --ae OPENAI_API_KEY=$OPENAI_API_KEY
 
 Architecture:
@@ -75,9 +75,8 @@ class PraisonAIExternalAgent(BaseAgent):
         """
         
         # Inject API keys from Harbor's --ae env vars into host os.environ
-        # so litellm can pick them up. The --ae channel arrives via the
-        # BaseAgent.extra_env property (AgentContext has no `env` field).
-        agent_env = getattr(self, 'extra_env', {}) or {}
+        # so litellm can pick them up (--ae only sets them inside Docker, not the host)
+        agent_env = getattr(context, 'env', {}) or {}
         for key, val in agent_env.items():
             if key not in os.environ and val:
                 os.environ[key] = val
@@ -140,7 +139,7 @@ class PraisonAIExternalAgent(BaseAgent):
                     "   Keep calling bash_tool until the test PASSES or you have exhausted all approaches."
                 ),
                 tools=[bash_tool],
-                llm=self.model_name or "openai/gpt-4o-mini",
+                llm=self.model_name or "openai/gpt-4o",
             )
 
             # Execute the agent with outer loop to handle premature stopping
@@ -183,14 +182,17 @@ class PraisonAIExternalAgent(BaseAgent):
         Harbor tracks: n_input_tokens, n_output_tokens, cost_usd, metadata
         """
         try:
-            # Extract token usage and cost from agent. `cost_summary` is a
-            # property returning a dict (not callable) on praisonaiagents.Agent.
+            # Extract token usage and cost from agent
             try:
-                summary = getattr(agent, 'cost_summary', None)
+                summary = agent.cost_summary() if callable(getattr(agent, 'cost_summary', None)) else None
                 if isinstance(summary, dict):
                     context.n_input_tokens = summary.get('tokens_in')
                     context.n_output_tokens = summary.get('tokens_out')
                     context.cost_usd = summary.get('cost')
+                else:
+                    context.n_input_tokens = getattr(agent, '_total_tokens_in', 0)
+                    context.n_output_tokens = getattr(agent, '_total_tokens_out', 0)
+                    context.cost_usd = getattr(agent, 'total_cost', None)
             except Exception:
                 pass
                 
@@ -214,7 +216,7 @@ if __name__ == "__main__":
     print("PraisonAI External Agent for Terminal-Bench 2.0")
     print("Usage: harbor run -d terminal-bench/terminal-bench-2 \\")
     print("  --agent-import-path examples.terminal_bench.praisonai_external_agent:PraisonAIExternalAgent \\")
-    print("  --model openai/gpt-4o-mini")
+    print("  --model openai/gpt-4o")
     print()
     print("Dependencies:")
     print("  pip install harbor praisonaiagents")

examples/terminal_bench/praisonai_installed_agent.py

@@ -9,7 +9,7 @@ Usage:
     # First, this would need to be integrated into Harbor's codebase as:
     # src/harbor/agents/installed/praisonai.py
     
-    harbor run -d terminal-bench/terminal-bench-2 -a praisonai --model openai/gpt-4o-mini
+    harbor run -d terminal-bench/terminal-bench-2 -a praisonai --model openai/gpt-4o
 
 Architecture:
     Harbor Container → praisonaiagents installed inside → execute_command tool
@@ -25,9 +25,34 @@ import asyncio
 from pathlib import Path
 from typing import Dict, Optional
 
-from harbor.agents.installed.base import BaseInstalledAgent, with_prompt_template, CliFlag
-from harbor.environments.base import BaseEnvironment
-from harbor.models.agent.context import AgentContext
+try:
+    # These imports would work if this file was in Harbor's codebase
+    from harbor.agents.installed.base import BaseInstalledAgent, with_prompt_template, CliFlag
+    from harbor.environments.base import BaseEnvironment
+    from harbor.models.agent.context import AgentContext
+    from harbor.models.trial.paths import EnvironmentPaths
+except ImportError:
+    # Fallback for development/testing outside Harbor
+    print("Note: This is a reference implementation for Harbor integration")
+    print("To actually use this, it needs to be integrated into Harbor's codebase")
+    
+    # Mock classes for development
+    class BaseInstalledAgent:
+        pass
+    
+    def with_prompt_template(func):
+        return func
+    
+    class CliFlag:
+        def __init__(self, name, cli, type, default):
+            pass
+    
+    class BaseEnvironment:
+        async def exec(self, **kwargs):
+            pass
+    
+    class AgentContext:
+        pass
 
 
 class PraisonAIInstalledAgent(BaseInstalledAgent):
@@ -41,10 +66,12 @@ class PraisonAIInstalledAgent(BaseInstalledAgent):
     # ATIF trajectory support - would be implemented once PraisonAI has trajectory format
     SUPPORTS_ATIF: bool = False
 
-    # Command-line configuration flags. The real Harbor CliFlag dataclass keys
-    # the value by `kwarg` (not `name`).
+    # Command-line configuration flags
     CLI_FLAGS = [
-        CliFlag(kwarg="max_turns", cli="--max-turns", type="int", default=30),
+        CliFlag("max_turns", cli="--max-turns", type="int", default=30),
+        CliFlag("verbose", cli="--verbose", type="bool", default=False),
+        CliFlag("memory", cli="--memory", type="bool", default=False),
+        CliFlag("auto_approval", cli="--auto-approval", type="bool", default=True),
     ]
 
     @staticmethod
@@ -115,7 +142,7 @@ def main():
         sys.exit(1)
         
     instruction = sys.argv[1]
-    model = sys.argv[2] if len(sys.argv) > 2 else "openai/gpt-4o-mini"
+    model = sys.argv[2] if len(sys.argv) > 2 else "openai/gpt-4o"
     max_turns = int(sys.argv[3]) if len(sys.argv) > 3 else 30
     try:
         from praisonaiagents import Agent
@@ -149,19 +176,19 @@ def main():
             "tools_used": ["execute_command"],
         }
         
-        # Token usage + cost come from the `cost_summary` property (a dict).
-        try:
-            summary = getattr(agent, "cost_summary", None)
-            if isinstance(summary, dict):
-                metrics["input_tokens"] = summary.get("tokens_in")
-                metrics["output_tokens"] = summary.get("tokens_out")
-                metrics["cost_usd"] = summary.get("cost")
-        except Exception:
-            pass
-
-        # Write metrics to a stable path so the host adapter can read them back.
-        with open("/tmp/praisonai_metrics.json", "w") as fh:
-            json.dump(metrics, fh)
+        # Add token usage if available
+        if hasattr(agent, '_usage'):
+            usage = agent._usage
+            if usage:
+                metrics.update({
+                    "input_tokens": getattr(usage, 'input_tokens', None),
+                    "output_tokens": getattr(usage, 'output_tokens', None),
+                })
+                
+        # Add cost if available
+        if hasattr(agent, '_cost'):
+            metrics["cost_usd"] = agent._cost
+            
         print(json.dumps(metrics))
         
     except Exception as e:
@@ -189,7 +216,7 @@ if __name__ == "__main__":
         This executes the headless runner script with the instruction,
         similar to how other installed agents work in Harbor.
         """
-        model = self.model_name or "openai/gpt-4o-mini"
+        model = self.model_name or "openai/gpt-4o"
         max_turns = getattr(self, 'max_turns', 30)
         
         # Build command to run PraisonAI
@@ -200,18 +227,15 @@ if __name__ == "__main__":
             str(max_turns),
         ]
         
-        # Tee the metrics file back so populate_context_post_run can read it via
-        # the container. Also print it so it lands in Harbor's captured stdout.
-        command = " ".join(cmd_args) + "; cat /tmp/praisonai_metrics.json 2>/dev/null || true"
+        command = " ".join(cmd_args)
         
         try:
-            # Execute the agent and keep the ExecResult stdout for metric parsing.
-            result = await self.exec_as_agent(
+            # Execute the agent
+            await self.exec_as_agent(
                 environment,
                 command=command,
-                env=self.env,
+                env=self._get_environment_vars(),
             )
-            self._last_stdout = getattr(result, "stdout", "") or ""
         except Exception as e:
             # Store error in context for Harbor's reporting
             context.metadata = {"execution_error": str(e)}
@@ -246,38 +270,37 @@ if __name__ == "__main__":
         JSON output of the headless runner script.
         """
         try:
-            # Parse the JSON metrics captured from the runner's stdout (teed via
-            # `cat /tmp/praisonai_metrics.json` in run()). AgentContext has no
-            # `_last_stdout`; we stash it on the agent instead.
-            last_output = getattr(self, '_last_stdout', None)
-            metrics = None
+            # Parse the last stdout output for JSON metrics
+            # In Harbor's model, the last execution output should contain our JSON
+            last_output = getattr(context, '_last_stdout', None)
+            
             if last_output:
-                # The output may contain CLI noise before the JSON line; grab the
-                # last line that parses as a JSON object.
-                for line in reversed(last_output.strip().splitlines()):
-                    line = line.strip()
-                    if line.startswith("{"):
-                        try:
-                            metrics = json.loads(line)
-                            break
-                        except (json.JSONDecodeError, ValueError):
-                            continue
-
-            if metrics is not None:
-                # Extract metrics with safe defaults
-                context.n_input_tokens = metrics.get('input_tokens')
-                context.n_output_tokens = metrics.get('output_tokens')
-                context.cost_usd = metrics.get('cost_usd')
-
-                # Store additional metadata
-                context.metadata = {
-                    "framework": "praisonai",
-                    "agent_type": "installed",
-                    "agent_name": metrics.get('agent_name', 'terminal-agent'),
-                    "model": metrics.get('model'),
-                    "tools_used": metrics.get('tools_used', []),
-                    "version": self.get_version() if hasattr(self, 'get_version') else None,
-                }
+                try:
+                    metrics = json.loads(last_output.strip())
+                    
+                    # Extract metrics with safe defaults
+                    context.n_input_tokens = metrics.get('input_tokens') 
+                    context.n_output_tokens = metrics.get('output_tokens')
+                    context.cost_usd = metrics.get('cost_usd')
+                    
+                    # Store additional metadata
+                    context.metadata = {
+                        "framework": "praisonai",
+                        "agent_type": "installed",
+                        "agent_name": metrics.get('agent_name', 'terminal-agent'),
+                        "model": metrics.get('model'),
+                        "tools_used": metrics.get('tools_used', []),
+                        "version": self.get_version() if hasattr(self, 'get_version') else None,
+                    }
+                    
+                except (json.JSONDecodeError, ValueError) as e:
+                    # If JSON parsing fails, store basic metadata
+                    context.metadata = {
+                        "framework": "praisonai", 
+                        "agent_type": "installed",
+                        "parse_error": str(e),
+                        "raw_output": str(last_output)[:200] if last_output else None,
+                    }
             else:
                 # No output to parse
                 context.metadata = {
@@ -311,7 +334,7 @@ if __name__ == "__main__":
     print("   - Add PraisonAI to _AGENTS list and _AGENT_MAP")
     print()
     print("3. Run with Harbor:")
-    print("   harbor run -d terminal-bench/terminal-bench-2 -a praisonai --model openai/gpt-4o-mini")
+    print("   harbor run -d terminal-bench/terminal-bench-2 -a praisonai --model openai/gpt-4o")
     print()
     print("Dependencies:")
     print("   pip install harbor praisonaiagents")

examples/terminal_bench/praisonai_wrapper_agent.py

@@ -8,7 +8,7 @@ that matches the standard `praisonai "TASK"` CLI usage pattern.
 Usage:
     harbor run -d terminal-bench/terminal-bench-2 \
         --agent-import-path examples.terminal_bench.praisonai_wrapper_agent:PraisonAIWrapperAgent \
-        --model openai/gpt-4o-mini \
+        --model openai/gpt-4o \
         --ae OPENAI_API_KEY=$OPENAI_API_KEY \
         -n 4
 
@@ -95,16 +95,13 @@ class PraisonAIWrapperAgent(BaseAgent):
         
         Uses the `praisonai "TASK"` CLI pattern inside the Harbor container.
         """
-        model = self.model_name or "openai/gpt-4o-mini"
+        model = self.model_name or "openai/gpt-4o"
         
-        # Build the `praisonai code` headless command. --dangerously-skip-approval
-        # makes the terminal assistant run autonomously (no approval hang in a
-        # non-TTY container). Bare `praisonai "TASK"` would run agents-generator
-        # mode with no shell-tool loop, so we use the code assistant instead.
+        # Build the praisonai CLI command
+        # Format: praisonai "TASK" --model MODEL
         cmd_parts = [
-            "praisonai", "code",
+            "praisonai",
             shlex.quote(instruction),
-            "--dangerously-skip-approval",
             "--model", shlex.quote(model),
         ]
         
@@ -151,7 +148,7 @@ class PraisonAIWrapperAgent(BaseAgent):
             # Store result summary
             context.metadata = {
                 "agent_name": "praisonai-wrapper",
-                "model": self.model_name or "openai/gpt-4o-mini",
+                "model": self.model_name or "openai/gpt-4o",
                 "framework": "praisonai",
                 "wrapper_type": "cli",
                 "instruction_preview": instruction[:200],
@@ -207,16 +204,16 @@ class PraisonAIWrapperAgent(BaseAgent):
         return env_vars
 
     async def _exec_as_root(self, environment: BaseEnvironment, command: str, env: Optional[Dict] = None) -> Any:
-        """Execute command as root in the container.
+        """Execute command as root in the container."""
+        if hasattr(environment, 'exec_as_root'):
+            return await environment.exec_as_root(command=command, env=env or {})
+        else:
+            # Fallback: use sudo
+            return await environment.exec(command=f"sudo {command}", env=env or {})
 
-        BaseEnvironment has no `exec_as_root`; use `exec(..., user="root")`.
-        `sudo` is typically absent from TB task containers.
-        """
-        return await environment.exec(command=command, env=env or {}, user="root")
-
-    async def _exec_as_agent(self, environment: BaseEnvironment, command: str, env: Optional[Dict] = None) -> Any:
+    async def _exec_as_agent(self, environment: BaseEnvironment, command: str) -> Any:
         """Execute command as the agent user in the container."""
-        return await environment.exec(command=command, env=env or {})
+        return await environment.exec(command=command)
 
 
 # Example usage for testing
@@ -230,7 +227,7 @@ if __name__ == "__main__":
     print("Usage with Harbor:")
     print("  harbor run -d terminal-bench/terminal-bench-2 \\")
     print("    --agent-import-path examples.terminal_bench.praisonai_wrapper_agent:PraisonAIWrapperAgent \\")
-    print("    --model openai/gpt-4o-mini")
+    print("    --model openai/gpt-4o")
     print()
     print("Dependencies:")
     print("  pip install harbor praisonai")

examples/terminal_bench/test_integration.py

@@ -1,119 +1,274 @@
 """
-Tests for the PraisonAI Terminal-Bench 2.1 (Harbor) integration.
+Tests for PraisonAI Terminal-Bench 2.0 Integration
 
-Run from the repo root with PYTHONPATH set so the package import path resolves:
-    PYTHONPATH=. python -m pytest examples/terminal_bench/test_integration.py -v
+This module contains both unit tests and integration tests for the
+PraisonAI Harbor integration.
 
-Tests that require Harbor are honestly skipped only when Harbor is not installed
-(checked via importlib.util.find_spec). pytest-asyncio must be installed for the
-async tests.
+Run tests with:
+    python -m pytest examples/terminal_bench/test_integration.py -v
+
+Requirements:
+    pip install pytest praisonaiagents
+    # Harbor is optional for unit tests, required for integration tests
 """
 
-import importlib.util
-import shlex
-from types import SimpleNamespace
-from unittest.mock import AsyncMock, Mock
-
 import pytest
-
-HARBOR_AVAILABLE = importlib.util.find_spec("harbor") is not None
-
-pytestmark = pytest.mark.skipif(
-    not HARBOR_AVAILABLE, reason="Harbor not installed"
-)
-
-
-class TestPraisonAICodeAgent:
-    """The headline `praisonai code` adapter."""
-
-    def test_metadata(self):
-        from examples.terminal_bench.praisonai_code_agent import PraisonAICodeAgent
-
-        agent = PraisonAICodeAgent(model_name="openai/gpt-4o-mini", logs_dir="/tmp")
-        assert agent.name() == "praisonai-code"
-        assert agent.get_version_command() == "praisonai --version"
-
-    @pytest.mark.asyncio
-    async def test_code_agent_command_shape(self, tmp_path):
-        """run() must issue the exact headless `praisonai code` command."""
-        from examples.terminal_bench.praisonai_code_agent import PraisonAICodeAgent
-
-        agent = PraisonAICodeAgent(
-            model_name="openai/gpt-4o-mini", logs_dir=str(tmp_path)
-        )
-        env = Mock()
-        env.exec = AsyncMock(
-            return_value=SimpleNamespace(stdout="", stderr="", return_code=0)
-        )
-        context = SimpleNamespace(metadata=None)
-
-        instruction = "fix the failing test"
-        await agent.run(instruction, env, context)
-
-        env.exec.assert_awaited()
-        command = env.exec.await_args.kwargs.get("command", "")
-        assert command.startswith(f"praisonai code {shlex.quote(instruction)}")
-        assert "--dangerously-skip-approval" in command
-        assert "--model openai/gpt-4o-mini" in command
+import asyncio
+from unittest.mock import Mock, AsyncMock, patch
+from pathlib import Path
 
 
 class TestPraisonAIExternalAgent:
-    """The external (SDK-level) adapter."""
-
-    def test_metadata(self):
-        from examples.terminal_bench.praisonai_external_agent import (
-            PraisonAIExternalAgent,
-        )
-
+    """Test the external agent implementation."""
+    
+    def test_agent_metadata(self):
+        """Test agent name and version reporting."""
+        try:
+            from .praisonai_external_agent import PraisonAIExternalAgent
+        except ImportError:
+            pytest.skip("Harbor not installed - skipping Harbor-specific tests")
+            
         agent = PraisonAIExternalAgent()
         assert agent.name() == "praisonai"
+        
+        # Version should be None if praisonaiagents not installed, or actual version
         version = agent.version()
         assert version is None or isinstance(version, str)
 
-    def test_context_population_uses_cost_summary(self):
-        from examples.terminal_bench.praisonai_external_agent import (
-            PraisonAIExternalAgent,
-        )
+    @pytest.mark.asyncio
+    async def test_setup(self):
+        """Test agent setup phase."""
+        try:
+            from .praisonai_external_agent import PraisonAIExternalAgent
+        except ImportError:
+            pytest.skip("Harbor not installed")
+            
+        agent = PraisonAIExternalAgent()
+        mock_env = Mock()
+        
+        # Setup should complete without error (external agent needs no setup)
+        await agent.setup(mock_env)
 
+    @pytest.mark.asyncio
+    async def test_bash_tool_execution(self):
+        """Test the bash tool wrapper around Harbor's exec()."""
+        try:
+            from .praisonai_external_agent import PraisonAIExternalAgent
+        except ImportError:
+            pytest.skip("Harbor not installed")
+            
+        # Mock Harbor environment
+        mock_env = Mock()
+        mock_result = Mock()
+        mock_result.stdout = "Hello, World!"
+        mock_result.stderr = ""
+        mock_result.return_code = 0
+        mock_env.exec = AsyncMock(return_value=mock_result)
+        
+        # Mock agent context
+        mock_context = Mock()
+        mock_context.metadata = {}
+        
+        agent = PraisonAIExternalAgent()
+        
+        # Mock PraisonAI Agent to avoid LLM calls in tests
+        with patch('praisonaiagents.Agent') as mock_agent_class:
+            mock_agent_instance = Mock()
+            mock_agent_instance.start.return_value = "Task completed successfully"
+            mock_agent_instance.name = "terminal-agent"
+            mock_agent_class.return_value = mock_agent_instance
+            
+            # Mock approval backend
+            with patch('praisonaiagents.approval.set_approval_backend'):
+                await agent.run("echo 'Hello, World!'", mock_env, mock_context)
+            
+            # Verify agent was created with correct parameters
+            mock_agent_class.assert_called_once()
+            args, kwargs = mock_agent_class.call_args
+            
+            assert kwargs['name'] == 'terminal-agent'
+            assert 'tools' in kwargs
+            assert len(kwargs['tools']) == 1  # bash_tool
+            assert kwargs['verbose'] is False
+            assert kwargs['memory'] is False
+
+    def test_context_population(self):
+        """Test that agent context is properly populated."""
+        try:
+            from .praisonai_external_agent import PraisonAIExternalAgent
+        except ImportError:
+            pytest.skip("Harbor not installed")
+            
         agent_impl = PraisonAIExternalAgent()
-
-        # cost_summary is a dict property on the real Agent, not a callable.
+        
+        # Mock agent with usage data
         mock_agent = Mock()
         mock_agent.name = "test-agent"
-        mock_agent.llm = "gpt-4o-mini"
-        mock_agent.cost_summary = {"tokens_in": 100, "tokens_out": 50, "cost": 0.01}
-
-        context = SimpleNamespace(
-            n_input_tokens=None, n_output_tokens=None, cost_usd=None, metadata=None
-        )
-        agent_impl._populate_context(mock_agent, context, "done")
-
-        assert context.n_input_tokens == 100
-        assert context.n_output_tokens == 50
-        assert context.cost_usd == 0.01
-        assert context.metadata["framework"] == "praisonai"
+        mock_agent.llm = "gpt-4o"
+        mock_agent._usage = Mock()
+        mock_agent._usage.input_tokens = 100
+        mock_agent._usage.output_tokens = 50
+        mock_agent._cost = 0.01
+        
+        mock_context = Mock()
+        mock_context.metadata = {}
+        
+        # Test context population
+        agent_impl._populate_context(mock_agent, mock_context, "Test result")
+        
+        assert mock_context.n_input_tokens == 100
+        assert mock_context.n_output_tokens == 50
+        assert mock_context.cost_usd == 0.01
+        assert mock_context.metadata['agent_name'] == 'test-agent'
+        assert mock_context.metadata['model'] == 'gpt-4o'
+        assert mock_context.metadata['framework'] == 'praisonai'
 
 
 class TestPraisonAIInstalledAgent:
-    """The installed adapter."""
-
-    def test_metadata_and_flags(self):
-        from examples.terminal_bench.praisonai_installed_agent import (
-            PraisonAIInstalledAgent,
-        )
-
-        agent = PraisonAIInstalledAgent(logs_dir="/tmp")
+    """Test the installed agent implementation."""
+    
+    def test_agent_configuration(self):
+        """Test agent CLI flags and configuration."""
+        try:
+            from .praisonai_installed_agent import PraisonAIInstalledAgent
+        except ImportError:
+            pytest.skip("Harbor not installed")
+            
+        agent = PraisonAIInstalledAgent()
         assert agent.name() == "praisonai"
-        # CliFlag is keyed by `kwarg` in the real Harbor dataclass.
-        assert all(getattr(f, "kwarg", None) for f in agent.CLI_FLAGS)
+        assert agent.SUPPORTS_ATIF is False  # Until trajectory format is implemented
+        
+        # Check CLI flags
+        flag_names = [flag.name if hasattr(flag, 'name') else str(flag) for flag in agent.CLI_FLAGS]
+        expected_flags = ['max_turns', 'verbose', 'memory', 'auto_approval']
+        for expected in expected_flags:
+            assert any(expected in flag_name for flag_name in flag_names)
 
-    def test_runner_script_uses_cost_summary(self):
-        from examples.terminal_bench.praisonai_installed_agent import (
-            PraisonAIInstalledAgent,
-        )
+    def test_version_command(self):
+        """Test version detection command."""
+        try:
+            from .praisonai_installed_agent import PraisonAIInstalledAgent
+        except ImportError:
+            pytest.skip("Harbor not installed")
+            
+        agent = PraisonAIInstalledAgent()
+        version_cmd = agent.get_version_command()
+        
+        assert version_cmd is not None
+        assert "praisonaiagents" in version_cmd
+        assert "__version__" in version_cmd
 
-        agent = PraisonAIInstalledAgent(logs_dir="/tmp")
+    def test_runner_script_generation(self):
+        """Test that the headless runner script is properly generated."""
+        try:
+            from .praisonai_installed_agent import PraisonAIInstalledAgent
+        except ImportError:
+            pytest.skip("Harbor not installed")
+            
+        agent = PraisonAIInstalledAgent()
         script = agent._build_runner_script()
-        assert "cost_summary" in script
-        assert "_usage" not in script
+        
+        assert "import praisonaiagents" in script
+        assert "Agent" in script
         assert "execute_command" in script
+        assert "AutoApproveBackend" in script
+        assert "json.dumps" in script
+
+
+class TestIntegration:
+    """Integration tests that require both PraisonAI and Harbor."""
+    
+    @pytest.mark.integration
+    def test_praisonai_agent_real(self):
+        """
+        Real agentic test - agent must call LLM end-to-end.
+        
+        This is a MANDATORY test per AGENTS.md §9.4.
+        Agent MUST call agent.start() with real prompt and produce LLM output.
+        """
+        try:
+            from praisonaiagents import Agent
+        except ImportError:
+            pytest.skip("PraisonAI not installed")
+            
+        # Create real agent that will call LLM
+        agent = Agent(
+            name="test-terminal-agent", 
+            instructions="You are a helpful terminal assistant"
+        )
+        
+        # Real agentic test - agent must call LLM and produce text response
+        result = agent.start("Say hello in one sentence and mention you can help with terminal tasks")
+        
+        # Verify we got actual LLM output
+        assert result is not None
+        assert isinstance(result, str)
+        assert len(result) > 0
+        
+        # Print output for manual verification
+        print("✅ Real agentic test result:")
+        print(result)
+
+    @pytest.mark.integration
+    @pytest.mark.asyncio
+    async def test_bash_tool_real_execution(self):
+        """Test bash tool with real command execution (if safe)."""
+        # This would test real bash execution in a safe environment
+        # For now, we'll mock it to avoid system changes
+        
+        mock_result = Mock()
+        mock_result.stdout = "PraisonAI Terminal Test\n"
+        mock_result.stderr = ""
+        mock_result.return_code = 0
+        
+        # Test that our bash tool wrapper works correctly
+        async def mock_exec(command, timeout_sec=30):
+            assert "echo" in command  # Ensure we're testing echo command
+            return mock_result
+            
+        # This simulates Harbor's BaseEnvironment.exec()
+        result = await mock_exec("echo 'PraisonAI Terminal Test'")
+        
+        assert result.stdout.strip() == "PraisonAI Terminal Test"
+        assert result.return_code == 0
+
+    @pytest.mark.integration
+    def test_auto_approval_setup(self):
+        """Test that auto-approval backend works correctly."""
+        try:
+            from praisonaiagents.approval import set_approval_backend, AutoApproveBackend
+        except ImportError:
+            pytest.skip("PraisonAI approval system not available")
+            
+        # Test setting and restoring approval backend
+        original = set_approval_backend(AutoApproveBackend())
+        new_backend = set_approval_backend(original)
+        
+        assert isinstance(new_backend, AutoApproveBackend)
+
+
+if __name__ == "__main__":
+    # Allow running tests directly
+    import sys
+    
+    print("PraisonAI Terminal-Bench 2.0 Integration Tests")
+    print("=" * 50)
+    
+    # Check dependencies
+    try:
+        import praisonaiagents
+        print(f"✅ PraisonAI version: {getattr(praisonaiagents, '__version__', None)}")
+    except ImportError:
+        print("❌ PraisonAI not installed: pip install praisonaiagents")
+        sys.exit(1)
+    
+    try:
+        import harbor
+        print("✅ Harbor framework available")
+    except ImportError:
+        print("⚠️  Harbor not installed: pip install harbor")
+        print("   (Some tests will be skipped)")
+    
+    print()
+    print("Run tests with: python -m pytest examples/terminal_bench/test_integration.py -v")
+    print("Run real agentic test: python -m pytest examples/terminal_bench/test_integration.py::TestIntegration::test_praisonai_agent_real -v -s")

examples/workflow_output_modes.py

@@ -13,7 +13,7 @@ Available presets:
 - json: JSONL output for piping
 """
 
-from praisonaiagents import Agent, AgentFlow, Workflow
+from praisonaiagents import Agent, Workflow
 
 
 def main():

examples/yaml/bot_standalone.yaml

@@ -1,18 +0,0 @@
-# Standalone bot + gateway (praisonai-bot first)
-#
-# pip install praisonaiagents "praisonai-bot[gateway,bot]"
-# export OPENAI_API_KEY=...
-# praisonai-bot gateway start --host 127.0.0.1 --port 8765
-
-agent:
-  name: assistant
-  instructions: You are a helpful assistant.
-  llm: gpt-4o-mini
-
-gateway:
-  host: 127.0.0.1
-  port: 8765
-
-platforms:
-  telegram:
-    token: ${TELEGRAM_BOT_TOKEN}