code-puppy 0.0.379__py3-none-any.whl → 0.0.381__py3-none-any.whl

code_puppy/tools/browser/browser_manager.py

@@ -8,13 +8,41 @@ import atexit
 import contextvars
 import os
 from pathlib import Path
-from typing import Optional
+from typing import Callable, Dict, Optional
 
 from playwright.async_api import Browser, BrowserContext, Page
 
 from code_puppy import config
 from code_puppy.messaging import emit_info, emit_success, emit_warning
 
+# Registry for custom browser types from plugins (e.g., Camoufox for stealth browsing)
+_CUSTOM_BROWSER_TYPES: Dict[str, Callable] = {}
+_BROWSER_TYPES_LOADED: bool = False
+
+
+def _load_plugin_browser_types() -> None:
+    """Load custom browser types from plugins.
+
+    This is called lazily on first browser initialization to allow plugins
+    to register custom browser providers (like Camoufox for stealth browsing).
+    """
+    global _CUSTOM_BROWSER_TYPES, _BROWSER_TYPES_LOADED
+
+    if _BROWSER_TYPES_LOADED:
+        return
+
+    _BROWSER_TYPES_LOADED = True
+
+    try:
+        from code_puppy.callbacks import on_register_browser_types
+
+        results = on_register_browser_types()
+        for result in results:
+            if isinstance(result, dict):
+                _CUSTOM_BROWSER_TYPES.update(result)
+    except Exception:
+        pass  # Don't break if plugins fail to load
+
 # Store active manager instances by session ID
 _active_managers: dict[str, "BrowserManager"] = {}
 
@@ -78,14 +106,19 @@ class BrowserManager:
     _context: Optional[BrowserContext] = None
     _initialized: bool = False
 
-    def __init__(self, session_id: Optional[str] = None):
+    def __init__(
+        self, session_id: Optional[str] = None, browser_type: Optional[str] = None
+    ):
         """Initialize manager settings.
 
         Args:
             session_id: Optional session ID for this instance.
                 If None, uses 'default' as the session ID.
+            browser_type: Optional browser type to use. If None, uses Chromium.
+                Custom types can be registered via the register_browser_types hook.
         """
         self.session_id = session_id or "default"
+        self.browser_type = browser_type  # None means default Chromium
 
         # Default to headless=True (no browser spam during tests)
         # Override with BROWSER_HEADLESS=false to see the browser
@@ -124,7 +157,27 @@ class BrowserManager:
             raise
 
     async def _initialize_browser(self) -> None:
-        """Initialize Playwright Chromium browser with persistent context."""
+        """Initialize browser with persistent context.
+
+        Checks for custom browser types registered via plugins first,
+        then falls back to default Playwright Chromium.
+        """
+        # Load plugin browser types on first initialization
+        _load_plugin_browser_types()
+
+        # Check if a custom browser type was requested and is available
+        if self.browser_type and self.browser_type in _CUSTOM_BROWSER_TYPES:
+            emit_info(
+                f"Using custom browser type '{self.browser_type}' "
+                f"(session: {self.session_id})"
+            )
+            init_func = _CUSTOM_BROWSER_TYPES[self.browser_type]
+            # Custom init functions should set self._context and self._browser
+            await init_func(self)
+            self._initialized = True
+            return
+
+        # Default: use Playwright Chromium
         from playwright.async_api import async_playwright
 
         emit_info(f"Using persistent profile: {self.profile_dir}")
@@ -220,13 +273,18 @@ class BrowserManager:
         emit_info(f"Browser closed (session: {self.session_id})")
 
 
-def get_browser_manager(session_id: Optional[str] = None) -> BrowserManager:
+def get_browser_manager(
+    session_id: Optional[str] = None, browser_type: Optional[str] = None
+) -> BrowserManager:
     """Get or create a BrowserManager instance.
 
     Args:
         session_id: Optional session ID. If provided and a manager with this
             session exists, returns that manager. Otherwise creates a new one.
             If None, uses 'default' as the session ID.
+        browser_type: Optional browser type to use for new managers.
+            Ignored if a manager for this session already exists.
+            Custom types can be registered via the register_browser_types hook.
 
     Returns:
         A BrowserManager instance.
@@ -237,11 +295,14 @@ def get_browser_manager(session_id: Optional[str] = None) -> BrowserManager:
 
         # Named session (for multi-agent use)
         manager = get_browser_manager("qa-agent-1")
+
+        # Custom browser type (e.g., stealth browser from plugin)
+        manager = get_browser_manager("stealth-session", browser_type="camoufox")
     """
     session_id = session_id or "default"
 
     if session_id not in _active_managers:
-        _active_managers[session_id] = BrowserManager(session_id)
+        _active_managers[session_id] = BrowserManager(session_id, browser_type)
 
     return _active_managers[session_id]
 

{code_puppy-0.0.379.dist-info → code_puppy-0.0.381.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-puppy
-Version: 0.0.379
+Version: 0.0.381
 Summary: Code generation agent
 Project-URL: repository, https://github.com/mpfaffenberger/code_puppy
 Project-URL: HomePage, https://github.com/mpfaffenberger/code_puppy

{code_puppy-0.0.379.dist-info → code_puppy-0.0.381.dist-info}/RECORD

@@ -1,17 +1,17 @@
 code_puppy/__init__.py,sha256=xMPewo9RNHb3yfFNIk5WCbv2cvSPtJOCgK2-GqLbNnU,373
 code_puppy/__main__.py,sha256=pDVssJOWP8A83iFkxMLY9YteHYat0EyWDQqMkKHpWp4,203
-code_puppy/callbacks.py,sha256=A7aqykjNVB2HorewzerCEb3YYnqeDIdQG_2wNTt1paE,16745
+code_puppy/callbacks.py,sha256=KrIvt3dZemb2wbcLc-Tn1n9g9w2M2m2Blf5fFW4tRu0,19648
 code_puppy/chatgpt_codex_client.py,sha256=upMuAfOhMB7SEpVw4CU4GjgaeZ8X65ri3yNM-dnlmYA,12308
 code_puppy/claude_cache_client.py,sha256=GtwYrxcTe0pE-JGtl1ysR2qskfeE73_x4w7q_u-kR1k,24026
-code_puppy/cli_runner.py,sha256=w5CLKgQYYaT7My3Cga2StXYol-u6DBxNzzUuhhsfhsA,34952
-code_puppy/config.py,sha256=eAyVqiu8SwzJQpaJu80rlJvd8XXY51DqafMsP5lBRI4,55827
+code_puppy/cli_runner.py,sha256=xgEEbLHhhhFpZHUdnGGTYqmJQYVz1JOUZIYVs6PyiV4,38866
+code_puppy/config.py,sha256=mdup26I0W599y297WuYm2vPRPCtm7Qbwf_DfN90k2A4,56325
 code_puppy/error_logging.py,sha256=a80OILCUtJhexI6a9GM-r5LqIdjvSRzggfgPp2jv1X0,3297
 code_puppy/gemini_code_assist.py,sha256=KGS7sO5OLc83nDF3xxS-QiU6vxW9vcm6hmzilu79Ef8,13867
 code_puppy/gemini_model.py,sha256=UHb5vFC9zrEdFJ-yCN3vNCdp0UxP156BL_fwbnEhaw8,27988
 code_puppy/http_utils.py,sha256=Xel6UyQGO6X_5BlrtPYO1hVXN24aqP72tn5g1uUkluU,11491
 code_puppy/keymap.py,sha256=IvMkTlB_bIqOWpbTpmftkdyjhtD5todXuEIw1zCZ4u0,3584
 code_puppy/main.py,sha256=82r3vZy_XcyEsenLn82BnUusaoyL3Bpm_Th_jKgqecE,273
-code_puppy/model_factory.py,sha256=5ndms7O0_bJftizpJMbsdYs3geixn3vZKL2105zEgmM,32338
+code_puppy/model_factory.py,sha256=CbYlI1dkkUayEZ7D7XG_Ybjd4uvYe39xdjOYcVmqLcI,33935
 code_puppy/model_switching.py,sha256=3IsnSWKHLWzI5d2WDYNg0Xr78BeYNN1WrZuzas-lYJ4,2064
 code_puppy/model_utils.py,sha256=cG1V4fsIOEQIb0W88FyGcsMWNv8SpmRAXN3A7LBEoyE,5116
 code_puppy/models.json,sha256=SC7N2lV1Q8ikXlalRNqABkNvuuL_8fIIk638739-gGY,3319
@@ -45,7 +45,7 @@ code_puppy/agents/agent_qa_kitten.py,sha256=qvry-1u_CiXi8eRueHTax4OtqsS_mQrtXHsb
 code_puppy/agents/agent_security_auditor.py,sha256=SpiYNA0XAsIwBj7S2_EQPRslRUmF_-b89pIJyW7DYtY,12022
 code_puppy/agents/agent_terminal_qa.py,sha256=U-iyP7OBWdAmchW_oUU8k6asH2aignTMmgqqYDyf-ms,10343
 code_puppy/agents/agent_typescript_reviewer.py,sha256=vsnpp98xg6cIoFAEJrRTUM_i4wLEWGm5nJxs6fhHobM,10275
-code_puppy/agents/base_agent.py,sha256=gZvACpqH8L2Wp2xjn_v5D4Azlt6yvGnQO6UApN8HCEo,76272
+code_puppy/agents/base_agent.py,sha256=oc59XiPb7xfuLo70vduxGtjAWGWZd6ZzsV_rsNcsmB4,78924
 code_puppy/agents/event_stream_handler.py,sha256=JttLZJpNADE5HXiXY-GZ6tpwaBeFRODcy34KiquPOvU,14952
 code_puppy/agents/json_agent.py,sha256=FtbZxO8mo563kvXgpgRM4b-c9VA3G3cty7r-O0nBZQk,5690
 code_puppy/agents/prompt_reviewer.py,sha256=JJrJ0m5q0Puxl8vFsyhAbY9ftU9n6c6UxEVdNct1E-Q,5558
@@ -78,14 +78,14 @@ code_puppy/command_line/colors_menu.py,sha256=AI36z4vicbhwDQkziQZXCfy_F59bJLYs-1
 code_puppy/command_line/command_handler.py,sha256=yDR_NAvgwjFKxUuQMY5yzkkihFovDiT24wyKALmJSRU,10969
 code_puppy/command_line/command_registry.py,sha256=qFySsw1g8dol3kgi0p6cXrIDlP11_OhOoaQ5nAadWXg,4416
 code_puppy/command_line/config_commands.py,sha256=uwS7ln0I0w0A3tSSWZEtq7Xgj-VOaGEYLE1CihdQ8ic,25759
-code_puppy/command_line/core_commands.py,sha256=QTQt2CS9_6ExcgS6BLgRZWkXDaSb-KC_tWplUkOGaMA,27133
+code_puppy/command_line/core_commands.py,sha256=l6HWaxPIvVZxZillknNzoWPc4ni6-L79KtLxrgxHbfY,29090
 code_puppy/command_line/diff_menu.py,sha256=tokSiQXv9cWDd7HTBEkKKnxZjwSNyVjpIReXe-K2vL4,24245
 code_puppy/command_line/file_path_completion.py,sha256=gw8NpIxa6GOpczUJRyh7VNZwoXKKn-yvCqit7h2y6Gg,2931
 code_puppy/command_line/load_context_completion.py,sha256=a3JvLDeLLSYxVgTjAdqWzS4spjv6ccCrK2LKZgVJ1IM,2202
 code_puppy/command_line/mcp_completion.py,sha256=eKzW2O7gun7HoHekOW0XVXhNS5J2xCtK7aaWyA8bkZk,6952
 code_puppy/command_line/model_picker_completion.py,sha256=YRudzwGVtIjr02MyeIdmbkDhS00ENjCt9k3nATT3KdM,6143
 code_puppy/command_line/model_settings_menu.py,sha256=1SrhwmiL8fTqaM-frV0mSnssiVvjKfjMNoZAm1ofiYo,33708
-code_puppy/command_line/motd.py,sha256=XuIk3UTLawwVFM-NfoaJGU5F2hPLASTFXq84UdDMT0Q,2408
+code_puppy/command_line/motd.py,sha256=MMaRdJ9fsGnQ6Q01PPQO9kJaNUPwHbSIZrsIl-AF5pg,3066
 code_puppy/command_line/onboarding_slides.py,sha256=itqAsuHzjHpD_XNz6FniBIYr6dNyP1AW_XQZQ6SbVek,7125
 code_puppy/command_line/onboarding_wizard.py,sha256=mAFmQsPU8N48MGxHXOPBFRz7zeC4otdlqM6MpYVmrrc,10353
 code_puppy/command_line/pin_command_completion.py,sha256=juSvdqRpk7AdfkPy1DJx5NzfEUU5KYGlChvP0hisM18,11667
@@ -93,6 +93,7 @@ code_puppy/command_line/prompt_toolkit_completion.py,sha256=49GM3jVE89G1M3XroMZk
 code_puppy/command_line/session_commands.py,sha256=Jh8GGfhlfBAEVfucKLbcZjNaXYd0twImiOwq2ZnGdQQ,9902
 code_puppy/command_line/uc_menu.py,sha256=DWxcqhHDQtaAmf00VLoG3j7W47lI_sPl1vMnTaNMofI,26141
 code_puppy/command_line/utils.py,sha256=_upMrrmDp5hteUjrRiEgVR6SoeNEPNZGXb5lOWYqcUQ,2952
+code_puppy/command_line/wiggum_state.py,sha256=L64-JF0CFYKyxAUcETeeYQr8_1PO35tkjdrs1YUvi1k,1952
 code_puppy/command_line/mcp/__init__.py,sha256=0-OQuwjq_pLiTVJ1_NrirVwdRerghyKs_MTZkwPC7YY,315
 code_puppy/command_line/mcp/base.py,sha256=pPeNnSyM0GGqD6mhYN-qA22rAT9bEapxliwH_YiIu3Q,823
 code_puppy/command_line/mcp/catalog_server_installer.py,sha256=G9FvQPTBB4LeJ4cOR9DvIkp82mClKRKI35KELbFLCKU,6181
@@ -130,7 +131,7 @@ code_puppy/mcp_/manager.py,sha256=_2ZRTLS8Sf3SMgEpAHl-wXBDYVqg2l-j9uI9EkfCNaE,31
 code_puppy/mcp_/mcp_logs.py,sha256=o4pSHwELWIjEjqhfaMMEGrBvb159-VIgUp21E707BPo,6264
 code_puppy/mcp_/registry.py,sha256=U_t12WQ-En-KGyZoiTYdqlhp9NkDTWafu8g5InvF2NM,15774
 code_puppy/mcp_/retry_manager.py,sha256=evVxbtrsHNyo8UoI7zpO-NVDegibn82RLlgN8VKewA8,10665
-code_puppy/mcp_/server_registry_catalog.py,sha256=fr_wsr99BphnaDiPLcN60t4Mp62lbt8rYNOpghKnqEA,39429
+code_puppy/mcp_/server_registry_catalog.py,sha256=HhWXMsU4xq3zxpzKhV5DvFh7i7Ho30kPkm4XIY6V0tE,39898
 code_puppy/mcp_/status_tracker.py,sha256=uekxrzkzIWrv3OfSVgblaPuoGFcAh_dBYwCcaHZ_CrM,12183
 code_puppy/mcp_/system_tools.py,sha256=7_oR8k0c8YjtCcYF9g7A946oAGuKOf_i-92aJH7VmlQ,7331
 code_puppy/mcp_/examples/retry_example.py,sha256=Qi5K6cNmhc5-zncZa0F_dkJUEdZ6OIgt1xfG5PUxt3Q,7234
@@ -184,14 +185,6 @@ code_puppy/plugins/file_permission_handler/register_callbacks.py,sha256=QlUqENkb
 code_puppy/plugins/frontend_emitter/__init__.py,sha256=4_o6anYxDpJGvKyMomRy4FfLXZx6VOLnX0PcZIL-fws,661
 code_puppy/plugins/frontend_emitter/emitter.py,sha256=GNcnoKLPAjrD_see82nuRutZEHxXwb2aUEKR4K8TJvQ,3787
 code_puppy/plugins/frontend_emitter/register_callbacks.py,sha256=3j7Emn3VeWSJSN9ozZ_Z78ZU8JvN7yfJNQ4bSH2KGdE,7704
-code_puppy/plugins/ralph/__init__.py,sha256=drPRgJ2LGLh8v_8dk7TJIklv-51XHjqW7SMfNTzwiGI,448
-code_puppy/plugins/ralph/agents.py,sha256=EQ2pvb8tb8aFfYZYtBuo9rBIvVp18XCieeK5PRvH3K4,11914
-code_puppy/plugins/ralph/commands.py,sha256=J1sVNrm4SBj_ujkO51ILWzdH5L3px6NPR_mn0mXD_FQ,6736
-code_puppy/plugins/ralph/loop_controller.py,sha256=uhEOKpmkxlfj5MK6_zVvSHH9D79JRx4RRkNtBkrBkNk,10107
-code_puppy/plugins/ralph/models.py,sha256=IrAJW85CgKA6yYSrWRn3VHx_65ukFkrasUhbVM1emF0,3983
-code_puppy/plugins/ralph/register_callbacks.py,sha256=_q1SILAYc8BHyWpXZoA8MOVsLCFnOvQ3vU8PzjfzZxc,4429
-code_puppy/plugins/ralph/state_manager.py,sha256=jv7bnQBiy_XQTj7Kfl3zBIMLV3XN5U-IS_U-fIdpHe0,10215
-code_puppy/plugins/ralph/tools.py,sha256=p767ZdjkeRmfWTqUYdFmXnKEHC15ek1Ho3tkLcjWb20,14391
 code_puppy/plugins/shell_safety/__init__.py,sha256=B-RYLWKlvrws9XCHG1Z99mBMC3VC394HAlMOhhCoGGI,243
 code_puppy/plugins/shell_safety/agent_shell_safety.py,sha256=5JutYlzzTzyFcbFujlNkV4NunVvD5QIpOSumjS3Fjc8,2408
 code_puppy/plugins/shell_safety/command_cache.py,sha256=adYtSPNVOZfW_6dQdtEihO6E-JYXYrdvlS1Cl7xBkDU,4546
@@ -216,7 +209,7 @@ code_puppy/tools/browser/__init__.py,sha256=Mu6zvTQHdKcEh3ttwNgjiKtaKjVkNQ4ncpQ0
 code_puppy/tools/browser/browser_control.py,sha256=qul611bbXteH3pBoN39AystbYr3ZXkCs9mbjobir5Io,8429
 code_puppy/tools/browser/browser_interactions.py,sha256=toroY2hDVDaNN9g6UV-vJ5IA1htaf_Pk85Z7PXwpMm4,16774
 code_puppy/tools/browser/browser_locators.py,sha256=--cYu5pi1nvVh673fFCV2GSOJ5XuAUHvyPpPJREOx7s,19176
-code_puppy/tools/browser/browser_manager.py,sha256=1-aXGzlOhAqC9eeH1RY13jaJntKrhhH3IUm24CfHWC8,10444
+code_puppy/tools/browser/browser_manager.py,sha256=9R6Qd9rjoIWPAnfLu_0ljplO--2YYGRTj_C6vW_UwJ8,12845
 code_puppy/tools/browser/browser_navigation.py,sha256=MbfIL6UNs79ImbCli1854_ftwqLke37jhwQzfcA0Zag,7415
 code_puppy/tools/browser/browser_screenshot.py,sha256=YT35iJc9SfFI8PiIfskyehDFpk1YfJ1K6lFwrzRwkH8,6281
 code_puppy/tools/browser/browser_scripts.py,sha256=swQLuD61mwE3uFghOZmSSJXggg5ZIPKHqKu-KvdY49Y,14778
@@ -225,10 +218,10 @@ code_puppy/tools/browser/chromium_terminal_manager.py,sha256=w1thQ_ACb6oV45L93TS
 code_puppy/tools/browser/terminal_command_tools.py,sha256=9byOZku-dwvTtCl532xt7Lumed_jTn0sLvUe_X75XCQ,19068
 code_puppy/tools/browser/terminal_screenshot_tools.py,sha256=J_21YO_495NvYgNFu9KQP6VYg2K_f8CtSdZuF94Yhnw,18448
 code_puppy/tools/browser/terminal_tools.py,sha256=F5LjVH3udSCFHmqC3O1UJLoLozZFZsEdX42jOmkqkW0,17853
-code_puppy-0.0.379.data/data/code_puppy/models.json,sha256=SC7N2lV1Q8ikXlalRNqABkNvuuL_8fIIk638739-gGY,3319
-code_puppy-0.0.379.data/data/code_puppy/models_dev_api.json,sha256=wHjkj-IM_fx1oHki6-GqtOoCrRMR0ScK0f-Iz0UEcy8,548187
-code_puppy-0.0.379.dist-info/METADATA,sha256=ldoaFKnfpIocHpmV_ZBTVEjfW0l7YWxIX7qRXJt1rQM,27604
-code_puppy-0.0.379.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-code_puppy-0.0.379.dist-info/entry_points.txt,sha256=Tp4eQC99WY3HOKd3sdvb22vZODRq0XkZVNpXOag_KdI,91
-code_puppy-0.0.379.dist-info/licenses/LICENSE,sha256=31u8x0SPgdOq3izJX41kgFazWsM43zPEF9eskzqbJMY,1075
-code_puppy-0.0.379.dist-info/RECORD,,
+code_puppy-0.0.381.data/data/code_puppy/models.json,sha256=SC7N2lV1Q8ikXlalRNqABkNvuuL_8fIIk638739-gGY,3319
+code_puppy-0.0.381.data/data/code_puppy/models_dev_api.json,sha256=wHjkj-IM_fx1oHki6-GqtOoCrRMR0ScK0f-Iz0UEcy8,548187
+code_puppy-0.0.381.dist-info/METADATA,sha256=sLQPLb3yvsL_sAhHULeuWoH9A5Ydkk6zKa0Us_vKWuU,27604
+code_puppy-0.0.381.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+code_puppy-0.0.381.dist-info/entry_points.txt,sha256=Tp4eQC99WY3HOKd3sdvb22vZODRq0XkZVNpXOag_KdI,91
+code_puppy-0.0.381.dist-info/licenses/LICENSE,sha256=31u8x0SPgdOq3izJX41kgFazWsM43zPEF9eskzqbJMY,1075
+code_puppy-0.0.381.dist-info/RECORD,,

code_puppy/plugins/ralph/__init__.py

@@ -1,13 +0,0 @@
-"""Ralph Plugin - Autonomous AI agent loop for completing PRDs.
-
-Based on Geoffrey Huntley's Ralph pattern: https://ghuntley.com/ralph/
-
-This plugin provides:
-- PRD Generator agent for creating detailed requirements
-- Ralph Converter agent for converting PRDs to JSON format
-- Ralph Orchestrator agent for autonomous execution
-- Tools for managing prd.json and progress.txt
-- /ralph commands for controlling the workflow
-"""
-
-__version__ = "0.1.0"

code_puppy/plugins/ralph/agents.py

@@ -1,433 +0,0 @@
-"""Ralph plugin agents - registered via the register_agents callback."""
-
-from typing import Any, Dict, List
-
-from code_puppy.agents.base_agent import BaseAgent
-
-
-class RalphPRDGeneratorAgent(BaseAgent):
-    """Agent for creating Product Requirements Documents."""
-
-    @property
-    def name(self) -> str:
-        return "ralph-prd-generator"
-
-    @property
-    def display_name(self) -> str:
-        return "Ralph PRD Generator 📋"
-
-    @property
-    def description(self) -> str:
-        return "Creates detailed Product Requirements Documents with user stories"
-
-    def get_available_tools(self) -> List[str]:
-        return [
-            "list_files",
-            "read_file",
-            "edit_file",
-            "agent_share_your_reasoning",
-        ]
-
-    def get_system_prompt(self) -> str:
-        return """You are a PRD (Product Requirements Document) Generator, part of the Ralph autonomous agent system.
-
-## Your Job
-
-Help users create detailed, well-structured PRDs that can be converted to Ralph's prd.json format for autonomous execution.
-
-## Process
-
-### Step 1: Clarifying Questions
-Ask 3-5 essential questions with LETTERED OPTIONS so users can respond quickly (e.g., "1A, 2C, 3B"):
-
-```
-1. What is the primary goal?
-   A. Option 1
-   B. Option 2
-   C. Other: [specify]
-
-2. Who is the target user?
-   A. All users
-   B. Admin only
-   C. New users only
-```
-
-### Step 2: Generate PRD
-
-After getting answers, create a PRD with these sections:
-
-```markdown
-# PRD: [Feature Name]
-
-## Introduction
-Brief description of the feature and problem it solves.
-
-## Goals
-- Specific, measurable objective 1
-- Specific, measurable objective 2
-
-## User Stories
-
-### US-001: [Title]
-**Description:** As a [user], I want [feature] so that [benefit].
-
-**Acceptance Criteria:**
-- [ ] Specific verifiable criterion
-- [ ] Another criterion
-- [ ] Typecheck passes
-- [ ] [For UI stories] Verify in browser using qa-kitten
-
-### US-002: [Title]
-...
-
-## Functional Requirements
-- FR-1: The system must...
-- FR-2: When user clicks X, the system must...
-
-## Non-Goals (Out of Scope)
-- What this feature will NOT include
-
-## Technical Considerations
-- Known constraints or dependencies
-- Integration points
-
-## How to Test
-Describe how to verify this feature works:
-- Command to run (e.g., `python main.py --feature`)
-- API endpoints to test (e.g., `curl http://localhost:8000/api/...`)
-- URL to visit for UI features (e.g., `http://localhost:3000/dashboard`)
-- Expected behavior or output
-
-## Success Metrics
-- How success will be measured
-```
-
-## CRITICAL: Story Sizing
-
-Each story must be completable in ONE iteration (one context window). Right-sized:
-- Add a database column and migration
-- Add a UI component to an existing page
-- Update a server action with new logic
-
-TOO BIG (split these):
-- "Build the entire dashboard" → Split into schema, queries, components
-- "Add authentication" → Split into schema, middleware, login UI, session
-
-**Rule of thumb:** If you can't describe the change in 2-3 sentences, it's too big.
-
-## Acceptance Criteria Rules
-
-Criteria must be VERIFIABLE, not vague:
-- ✅ "Button shows confirmation dialog before deleting"
-- ✅ "Filter dropdown has options: All, Active, Completed"
-- ❌ "Works correctly"
-- ❌ "Good UX"
-
-Always include:
-- "Typecheck passes" for all stories
-- "Verify in browser using qa-kitten" for UI stories
-
-## How to Test Section
-
-ALWAYS include a "How to Test" section that tells Ralph exactly how to verify the feature:
-
-**Good examples:**
-```markdown
-## How to Test
-1. Run `python -m pytest tests/test_auth.py` - all tests should pass
-2. Start the server with `python manage.py runserver`
-3. Visit http://localhost:8000/login and verify the login form appears
-4. Try logging in with test@example.com / password123
-```
-
-**Bad examples:**
-- "Test that it works" (too vague)
-- "Verify the feature" (no specific steps)
-
-## Output
-
-Save the PRD to `tasks/prd-[feature-name].md` using the edit_file tool.
-
-After creating the PRD, tell the user to run `/ralph convert` to convert it to prd.json format.
-"""
-
-
-class RalphConverterAgent(BaseAgent):
-    """Agent for converting PRDs to prd.json format."""
-
-    @property
-    def name(self) -> str:
-        return "ralph-converter"
-
-    @property
-    def display_name(self) -> str:
-        return "Ralph Converter 🔄"
-
-    @property
-    def description(self) -> str:
-        return "Converts markdown PRDs to prd.json format for Ralph execution"
-
-    def get_available_tools(self) -> List[str]:
-        return [
-            "list_files",
-            "read_file",
-            "edit_file",
-            "agent_share_your_reasoning",
-        ]
-
-    def get_system_prompt(self) -> str:
-        return """You are the Ralph Converter, responsible for converting markdown PRDs to prd.json format.
-
-## Your Job
-
-Take a PRD (markdown file or text) and convert it to the prd.json format that Ralph uses for autonomous execution.
-
-## Output Format
-
-```json
-{
-  "project": "[Project Name]",
-  "branchName": "ralph/[feature-name-kebab-case]",
-  "description": "[Feature description]",
-  "userStories": [
-    {
-      "id": "US-001",
-      "title": "[Story title]",
-      "description": "As a [user], I want [feature] so that [benefit]",
-      "acceptanceCriteria": [
-        "Criterion 1",
-        "Criterion 2",
-        "Typecheck passes"
-      ],
-      "priority": 1,
-      "passes": false,
-      "notes": ""
-    }
-  ]
-}
-```
-
-## Conversion Rules
-
-1. **Story IDs**: Sequential (US-001, US-002, etc.)
-2. **Priority**: Based on dependency order, then document order (1 = highest)
-3. **All stories**: `passes: false` and empty `notes`
-4. **branchName**: Derive from feature name, kebab-case, prefixed with `ralph/`
-
-## Story Ordering (CRITICAL)
-
-Order by dependency - earlier stories must NOT depend on later ones:
-1. Schema/database changes (migrations)
-2. Server actions / backend logic
-3. UI components that use the backend
-4. Dashboard/summary views that aggregate
-
-## Story Size Validation
-
-Each story must be completable in ONE iteration. If a story is too big, SPLIT IT:
-
-TOO BIG: "Add user notification system"
-
-SPLIT INTO:
-- US-001: Add notifications table to database
-- US-002: Create notification service
-- US-003: Add notification bell icon to header
-- US-004: Create notification dropdown panel
-- US-005: Add mark-as-read functionality
-
-## Acceptance Criteria Requirements
-
-ALWAYS add these criteria:
-- "Typecheck passes" → ALL stories
-- "Verify in browser using qa-kitten" → UI stories only
-
-## Process
-
-1. Read the PRD file (ask for path if not provided)
-2. Extract user stories and requirements
-3. Validate story sizes (split if needed)
-4. Order by dependencies
-5. Generate prd.json
-6. Save to `prd.json` in the current directory
-
-After saving, tell the user to run `/ralph start` to begin autonomous execution.
-"""
-
-
-class RalphOrchestratorAgent(BaseAgent):
-    """Agent for orchestrating the autonomous Ralph loop."""
-
-    @property
-    def name(self) -> str:
-        return "ralph-orchestrator"
-
-    @property
-    def display_name(self) -> str:
-        return "Ralph Orchestrator 🐺"
-
-    @property
-    def description(self) -> str:
-        return "Orchestrates the autonomous Ralph loop, implementing stories one by one"
-
-    def get_available_tools(self) -> List[str]:
-        return [
-            # Ralph-specific tools
-            "ralph_get_current_story",
-            "ralph_mark_story_complete",
-            "ralph_log_progress",
-            "ralph_check_all_complete",
-            "ralph_read_prd",
-            "ralph_read_patterns",
-            "ralph_add_pattern",
-            # Standard coding tools
-            "list_files",
-            "read_file",
-            "edit_file",
-            "delete_file",
-            "grep",
-            "agent_run_shell_command",
-            "agent_share_your_reasoning",
-            # Sub-agent tools for delegation
-            "list_agents",
-            "invoke_agent",
-        ]
-
-    def get_system_prompt(self) -> str:
-        return """You are the Ralph Orchestrator 🐺, an autonomous coding agent that implements PRD user stories one at a time.
-
-## Your Mission
-
-Execute user stories from prd.json until ALL stories have `passes: true`.
-
-## CRITICAL WORKFLOW
-
-For EACH iteration:
-
-### 1. READ CONTEXT FIRST
-```
-- Call ralph_read_patterns() to get codebase patterns
-- Call ralph_get_current_story() to get the next story
-```
-
-### 2. CHECK FOR COMPLETION
-If `all_complete: true`, output this EXACT text:
-```
-<promise>COMPLETE</promise>
-```
-Then STOP. Do not continue.
-
-### 3. IMPLEMENT THE STORY
-- Understand the acceptance criteria
-- Explore relevant code with list_files and read_file
-- Make changes with edit_file
-- Keep changes focused and minimal
-
-### 4. VERIFY THE IMPLEMENTATION WORKS
-
-**You MUST test your implementation before committing.** The PRD acceptance criteria should guide you, but use your judgment.
-
-#### For CLI/Backend Programs:
-```bash
-# Run the program directly
-python main.py --help
-./my_program test_input.txt
-
-# Check exit codes
-echo $?
-```
-
-#### For Backend Web Services (APIs):
-```bash
-# Test endpoints with curl
-curl -X GET http://localhost:8000/api/endpoint
-curl -X POST http://localhost:8000/api/resource -d '{"key": "value"}'
-
-# Verify responses are correct
-```
-
-#### For Frontend Websites (UI stories):
-Invoke the **qa-kitten** agent for browser-based verification:
-```
-invoke_agent("qa-kitten", "Navigate to http://localhost:3000 and verify: [acceptance criteria]. Take a screenshot and confirm the feature works.")
-```
-
-#### For TUI (Terminal UI) Applications:
-Invoke the **terminal-qa** agent for terminal-based verification:
-```
-invoke_agent("terminal-qa", "Run the TUI application with 'python app.py' and verify: [acceptance criteria]. Take a screenshot and confirm the interface works.")
-```
-
-#### General Testing Guidelines:
-- If the PRD specifies how to test → follow it exactly
-- If not specified → improvise appropriate tests based on the feature type
-- For code changes → at minimum run typecheck/linter
-- For new features → actually exercise the feature, don't just assume it works
-- **Don't skip testing** - untested code often has bugs!
-
-### 5. COMMIT CHANGES
-```bash
-git add -A
-git commit -m "feat: [Story ID] - [Story Title]"
-```
-
-### 6. MARK COMPLETE & LOG
-```
-ralph_mark_story_complete(story_id, notes)
-ralph_log_progress(story_id, summary, files_changed, learnings)
-```
-
-If you discovered reusable patterns, add them:
-```
-ralph_add_pattern("Use X pattern for Y")
-```
-
-### 7. CHECK IF ALL DONE
-```
-ralph_check_all_complete()
-```
-If all complete, output `<promise>COMPLETE</promise>` and STOP.
-
-## RULES
-
-1. **ONE story per iteration** - Don't try to do multiple
-2. **Read patterns FIRST** - Learn from previous iterations
-3. **VERIFY BEFORE COMMIT** - Never commit untested code
-4. **Actually run the code** - Don't just assume it works
-5. **Keep changes minimal** - Don't refactor unrelated code
-6. **Log learnings** - Help future iterations succeed
-
-## COMPLETION SIGNAL
-
-When ALL stories are done, you MUST output:
-```
-<promise>COMPLETE</promise>
-```
-
-## ERROR HANDLING
-
-If verification fails:
-1. Read the error message carefully
-2. Fix the code
-3. Re-run verification
-4. Only proceed when verification passes
-
-If truly stuck after 3 attempts:
-1. Log detailed notes about the issue
-2. Mark story with notes explaining the blocker
-3. Move on (but this should be rare!)
-
-Now, let's get to work! Start by reading patterns and getting the current story.
-"""
-
-
-def get_ralph_agents() -> List[Dict[str, Any]]:
-    """Get all Ralph agents for registration via the register_agents callback.
-
-    Returns:
-        List of agent definitions with name and class.
-    """
-    return [
-        {"name": "ralph-prd-generator", "class": RalphPRDGeneratorAgent},
-        {"name": "ralph-converter", "class": RalphConverterAgent},
-        {"name": "ralph-orchestrator", "class": RalphOrchestratorAgent},
-    ]