Upload folder using huggingface_hub (part 3)

.gitattributes

@@ -234,3 +234,217 @@ docs/res/usage/webui/model-presets-add.png filter=lfs diff=lfs merge=lfs -text
 docs/res/usage/webui/model-presets-editor.png filter=lfs diff=lfs merge=lfs -text
 docs/res/usage/webui/project-active-chat.png filter=lfs diff=lfs merge=lfs -text
 docs/res/usage/webui/project-create-filled.png filter=lfs diff=lfs merge=lfs -text
+docs/res/usage/webui/project-instructions-filled.png filter=lfs diff=lfs merge=lfs -text
+docs/res/usage/webui/project-picker.png filter=lfs diff=lfs merge=lfs -text
+docs/res/usage/webui/projects-empty.png filter=lfs diff=lfs merge=lfs -text
+docs/res/usage/webui/projects-list-created.png filter=lfs diff=lfs merge=lfs -text
+docs/res/usage/webui/skills-selector-checked.png filter=lfs diff=lfs merge=lfs -text
+docs/res/usage/webui/skills-selector.png filter=lfs diff=lfs merge=lfs -text
+docs/res/usage/webui/unread-dot-chat-list.png filter=lfs diff=lfs merge=lfs -text
+docs/setup/dev-setup.md filter=lfs diff=lfs merge=lfs -text
+docs/setup/installation.md filter=lfs diff=lfs merge=lfs -text
+docs/setup/vps-deployment.md filter=lfs diff=lfs merge=lfs -text
+extensions/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/_functions/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/_functions/__main__/init_a0/end/_10_register_watchdogs.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/_functions/agent/Agent/handle_exception/end/_40_handle_intervention_exception.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/_functions/agent/Agent/handle_exception/end/_50_handle_repairable_exception.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/_functions/agent/Agent/handle_exception/end/_90_handle_critical_exception.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/_functions/agent/Agent/hist_add_ai_response/end/_10_log_plain_responses.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/_functions/agent/Agent/hist_add_warning/end/_90_stop_unusable_response_loop.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/_functions/agent/Agent/prepare_prompt/end/_00_restore_settings.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/_functions/agent/Agent/prepare_prompt/start/_99_snapshot_settings.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/_functions/agent/AgentContext/run_task/end/_10_mark_state_dirty.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/agent_init/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/agent_init/_10_initial_message.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/agent_init/_15_load_profile_settings.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/banners/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/banners/_10_unsecured_connection.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/banners/_30_system_resources.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/before_main_llm_call/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/before_main_llm_call/_10_log_for_stream.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/error_format/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/error_format/_10_mask_errors.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/hist_add_before/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/hist_add_before/_10_mask_content.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/hist_add_tool_result/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/hist_add_tool_result/_90_save_tool_call_file.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/job_loop/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/job_loop/_20_cleanup_expired_api_chats.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/job_loop/_50_trim_cache.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_end/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_end/_10_organize_history.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_end/_90_save_chat.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_prompts_after/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_prompts_after/_60_include_current_datetime.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_prompts_after/_63_recall_relevant_skills.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_prompts_after/_65_include_loaded_skills.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_prompts_after/_70_include_agent_info.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_prompts_after/_72_include_parallel_jobs.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_prompts_after/_75_include_workdir_extras.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_prompts_before/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_prompts_before/_90_organize_history_wait.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_result/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_result/_20_empty_response.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_result/_30_repeat_response.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_start/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/message_loop_start/_10_iteration_no.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/monologue_end/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/monologue_end/_90_waiting_for_input_msg.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/monologue_start/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/process_chain_end/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/process_chain_end/_50_process_queue.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/reasoning_stream/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/reasoning_stream/_10_log_from_stream.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/reasoning_stream_chunk/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/reasoning_stream_chunk/_10_mask_stream.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/reasoning_stream_end/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/reasoning_stream_end/_10_mask_end.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/response_stream/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/response_stream/_10_log_from_stream.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/response_stream/_15_replace_include_alias.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/response_stream/_20_live_response.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/response_stream_chunk/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/response_stream_chunk/_10_mask_stream.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/response_stream_end/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/response_stream_end/_10_mask_end.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/response_stream_end/_15_log_from_stream_end.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/startup_migration/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/startup_migration/_10_self_update_manager.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/system_prompt/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/system_prompt/_10_main_prompt.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/system_prompt/_11_tools_prompt.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/system_prompt/_12_mcp_prompt.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/system_prompt/_13_secrets_prompt.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/system_prompt/_13_skills_prompt.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/system_prompt/_14_project_prompt.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/tool_execute_after/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/tool_execute_after/_10_mask_secrets.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/tool_execute_before/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/tool_execute_before/_10_replace_last_tool_output.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/tool_execute_before/_10_unmask_secrets.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/tool_execute_before/_20_block_parallel_recursion.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/user_message_ui/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/user_message_ui/_10_update_check.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/util_model_call_before/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/util_model_call_before/_10_mask_secrets.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/webui_ws_connect/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/webui_ws_connect/_10_state_sync.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/webui_ws_disconnect/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/webui_ws_disconnect/_10_state_sync.py filter=lfs diff=lfs merge=lfs -text
+extensions/python/webui_ws_event/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/python/webui_ws_event/_10_state_sync.py filter=lfs diff=lfs merge=lfs -text
+extensions/webui/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/webui/fetch_api_call_after/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/webui/fetch_api_call_before/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/webui/get_message_handler/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/webui/initFw_end/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/webui/initFw_end/restoreRestorableModals.js filter=lfs diff=lfs merge=lfs -text
+extensions/webui/initFw_end/selfUpdateGlobal.js filter=lfs diff=lfs merge=lfs -text
+extensions/webui/json_api_call_after/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/webui/json_api_call_after/cache_reset.js filter=lfs diff=lfs merge=lfs -text
+extensions/webui/json_api_call_before/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/webui/right-canvas-panels/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/webui/right-canvas-panels/files-panel.html filter=lfs diff=lfs merge=lfs -text
+extensions/webui/right_canvas_register_surfaces/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/webui/right_canvas_register_surfaces/register-files.js filter=lfs diff=lfs merge=lfs -text
+extensions/webui/right_canvas_register_surfaces/register-remote-link.js filter=lfs diff=lfs merge=lfs -text
+extensions/webui/right_canvas_register_surfaces/register-space-agent.js filter=lfs diff=lfs merge=lfs -text
+extensions/webui/set_messages_after_loop/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/webui/set_messages_before_loop/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/webui/webui_ws_push/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+extensions/webui/webui_ws_push/clear_cache.js filter=lfs diff=lfs merge=lfs -text
+helpers/AGENTS.md filter=lfs diff=lfs merge=lfs -text
+helpers/api.py filter=lfs diff=lfs merge=lfs -text
+helpers/api.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/attachment_manager.py filter=lfs diff=lfs merge=lfs -text
+helpers/attachment_manager.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/backup.py filter=lfs diff=lfs merge=lfs -text
+helpers/backup.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/browser.py filter=lfs diff=lfs merge=lfs -text
+helpers/browser.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/cache.py filter=lfs diff=lfs merge=lfs -text
+helpers/cache.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/call_llm.py filter=lfs diff=lfs merge=lfs -text
+helpers/call_llm.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/chat_media.py filter=lfs diff=lfs merge=lfs -text
+helpers/chat_media.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/cli_tunnel.py filter=lfs diff=lfs merge=lfs -text
+helpers/cli_tunnel.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/cloudflare_tunnel._py filter=lfs diff=lfs merge=lfs -text
+helpers/cloudflare_tunnel.py filter=lfs diff=lfs merge=lfs -text
+helpers/cloudflare_tunnel.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/context.py filter=lfs diff=lfs merge=lfs -text
+helpers/context.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/context_utils.py filter=lfs diff=lfs merge=lfs -text
+helpers/context_utils.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/crypto.py filter=lfs diff=lfs merge=lfs -text
+helpers/crypto.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/defer.py filter=lfs diff=lfs merge=lfs -text
+helpers/defer.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/dirty_json.py filter=lfs diff=lfs merge=lfs -text
+helpers/dirty_json.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/docker.py filter=lfs diff=lfs merge=lfs -text
+helpers/docker.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/document_query.py filter=lfs diff=lfs merge=lfs -text
+helpers/document_query.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/dotenv.py filter=lfs diff=lfs merge=lfs -text
+helpers/dotenv.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/duckduckgo_search.py filter=lfs diff=lfs merge=lfs -text
+helpers/duckduckgo_search.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/email_client.py filter=lfs diff=lfs merge=lfs -text
+helpers/email_client.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/ephemeral_images.py filter=lfs diff=lfs merge=lfs -text
+helpers/ephemeral_images.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/errors.py filter=lfs diff=lfs merge=lfs -text
+helpers/errors.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/extension.py filter=lfs diff=lfs merge=lfs -text
+helpers/extension.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/extract_tools.py filter=lfs diff=lfs merge=lfs -text
+helpers/extract_tools.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/faiss_monkey_patch.py filter=lfs diff=lfs merge=lfs -text
+helpers/faiss_monkey_patch.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/fasta2a_client.py filter=lfs diff=lfs merge=lfs -text
+helpers/fasta2a_client.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/fasta2a_server.py filter=lfs diff=lfs merge=lfs -text
+helpers/fasta2a_server.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/file_browser.py filter=lfs diff=lfs merge=lfs -text
+helpers/file_browser.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/file_tree.py filter=lfs diff=lfs merge=lfs -text
+helpers/file_tree.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/files.py filter=lfs diff=lfs merge=lfs -text
+helpers/files.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/functions.py filter=lfs diff=lfs merge=lfs -text
+helpers/functions.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/git.py filter=lfs diff=lfs merge=lfs -text
+helpers/git.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/guids.py filter=lfs diff=lfs merge=lfs -text
+helpers/guids.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/history.py filter=lfs diff=lfs merge=lfs -text
+helpers/history.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/images.py filter=lfs diff=lfs merge=lfs -text
+helpers/images.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/integration_commands.py filter=lfs diff=lfs merge=lfs -text
+helpers/integration_commands.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/job_loop.py filter=lfs diff=lfs merge=lfs -text
+helpers/job_loop.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/kvp.py filter=lfs diff=lfs merge=lfs -text
+helpers/kvp.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/litellm_transport.py filter=lfs diff=lfs merge=lfs -text
+helpers/litellm_transport.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/llm_result.py filter=lfs diff=lfs merge=lfs -text
+helpers/llm_result.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/localization.py filter=lfs diff=lfs merge=lfs -text
+helpers/localization.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/log.py filter=lfs diff=lfs merge=lfs -text
+helpers/log.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/login.py filter=lfs diff=lfs merge=lfs -text
+helpers/login.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/mcp_handler.py filter=lfs diff=lfs merge=lfs -text
+helpers/mcp_handler.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/mcp_server.py filter=lfs diff=lfs merge=lfs -text
+helpers/mcp_server.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/media_artifacts.py filter=lfs diff=lfs merge=lfs -text
+helpers/media_artifacts.py.dox.md filter=lfs diff=lfs merge=lfs -text
+helpers/message_queue.py filter=lfs diff=lfs merge=lfs -text

docs/setup/dev-setup.md

@@ -1,190 +1,3 @@
-# Development manual for Agent Zero
-This guide will show you how to setup a local development environment for Agent Zero in a VS Code compatible IDE, including proper debugger.
-
-
-[![Tutorial video](../res/devguide_vid.png)](https://www.youtube.com/watch?v=KE39P4qBjDk)
-
-
-
-> [!WARNING]
-> This guide is for developers and contributors. It assumes you have a basic understanding of how to use Git/GitHub, Docker, IDEs and Python.
-
-> [!NOTE]
-> - Agent Zero runs in a Docker container, this simplifies installation and ensures unified environment and behavior across systems.
-> - Developing and debugging in a container would be complicated though, therefore we use a hybrid approach where the python framework runs on your machine (in VS Code for example) and only connects to a Dockerized instance when it needs to execute code or use other pre-installed functionality like the built-in search engine.
-
-
-## To follow this guide you will need:
-1. VS Code compatible IDE (VS Code, Cursor, Windsurf...)
-2. Python environment (Conda, venv, uv...)
-3. Docker (Docker Desktop, docker-ce...)
-4. (optional) Git/GitHub
-
-> [!NOTE]
-> I will be using clean VS Code, Conda and Docker Desktop in this example on MacOS.
-
-
-## Step 0: Install required software
-- See the list above and install the software required if you don't already have it.
-- You can choose your own variants, but Python, Docker and a VS Code compatible IDE are required.
-- For Python you can choose your environment manager - base Python venv, Conda, uv...
-
-## Step 1: Clone or download the repository
-- Agent Zero is available on GitHub [github.com/agent0ai/agent-zero](https://github.com/agent0ai/agent-zero).
-- You can download the files using a browser and extract or run `git clone https://github.com/agent0ai/agent-zero` in your desired directory.
-
-> [!NOTE]
-> In my case, I used `cd ~/Desktop` and `git clone https://github.com/agent0ai/agent-zero`, so my project folder is `~/Desktop/agent-zero`.
-
-## Step 2: Open project folder in your IDE
-- I will be using plain and clean VS Code for this example to make sure I don't skip any setup part, you can use any of it's variants like Cursor, Windsurf etc.
-- Agent Zero comes with `.vscode` folder that contains basic setup, recommended extensions, and debugger profiles. These will help us a lot.
-
-1. Open your IDE and open the project folder using `File > Open Folder` and select your folder, in my case `~/Desktop/agent-zero`.
-2. You will probably be prompted to trust the directory, confirm that.
-3. You should now have the project open in your IDE
-![VS Code project](../res/dev/devinst-1.png)
-
-# Step 3: Prepare your IDE:
-1. Notice the prompt in lower right corner of the screenshot above to install recommended extensions, this comes from the `.vscode/extensions.json` file. It contains Python language support, debugger and error helper, install them by confirming the popup or manually in Extensions tab of your IDE. These are the extensions mentioned:
-```
-usernamehw.errorlens
-ms-python.debugpy
-ms-python.python
-```
-
-Now when you select one of the python files in the project, you should see proper Python syntax highlighting and error detection. It should immediately show some errors, because we did not yet install dependencies.
-![VS Code Python](../res/dev/devinst-2.png)
-
-2. Prepare the python environment to run Agent Zero in. This step assumes you have some Python runtime installed. By clicking the python version in lower right corner (3.13.1 in my example), you should get a list of available environments. You can click the `+ Create Virtual Environment` button. You might be prompted to select the environment manager if you have multiple installed. I have venv and Conda, I will select Conda here. I'm also prompted for desired python version, I will select 3.12, that is known to work well.
-![VS Code Python environments](../res/dev/devinst-3.png)
-![VS Code Python environments](../res/dev/devinst-4.png)
-
-- Your new environment should be automatically activated. If not, select it in the lower right corner. You might need to open a new terminal in VS Code to reflect the changes with `Terminal > New Terminal` or clicking the `+` button in the terminal tab. Your terminal prompt should now start with your environment name/path, in my case `(/Users/frdel/Desktop/agent-zero/.conda)` This shows the environment is active in the terminal.
-
-![VS Code env terminal](../res/dev/devinst-5.png)
-
-3. Install dependencies. Run these commands from the project root:
-
-```bash
-pip install -r requirements.txt
-PLAYWRIGHT_BROWSERS_PATH=./tmp/playwright patchright install chromium --no-shell
-```
-
-The first command installs Python dependencies.
-
-The second command installs full Patchright Chromium into `./tmp/playwright`,
-relative to the project root. Docker images use the absolute path
-`/a0/tmp/playwright` and ship Chromium preinstalled.
-
-If you skip the second command, local development can still download Chromium on
-first Browser use through `ensure_playwright_binary()` in
-`plugins/_browser/helpers/playwright.py`. Pre-installing avoids that wait.
-
-See the [Browser Guide](../guides/browser.md) for the Browser surface,
-screenshots, annotations, and host-browser mode.
-Errors in the code editor caused by missing packages should now be gone. If not, try reloading the window.
-
-
-## Step 4: Run Agent Zero in the IDE
-Great work! Now you should be able to run Agent Zero from your IDE including real-time debugging.
-It will not be able to do code execution and few other features requiring the Docker container just yet, but most of the framework will already work.
-
-1. The project is pre-configured for debugging. Go to Debugging tab, select "run_ui.py" and click the green play button (or press F5 by default). The configuration can be found at `.vscode/launch.json`.
-
-![VS Code debugging](../res/dev/devinst-6.png)
-
-The framework will run at the default port 5000. If you open `http://localhost:5000` in your browser and see `ERR_EMPTY_RESPONSE`, don't panic, you may need to select another port like I did for some reason. If you need to change the default port, you can add `"--port=5555"` to the args in the `.vscode/launch.json` file or you can create a `.env` file in the root directory and set the `WEB_UI_PORT` variable to the desired port.
-
-You can also set the bind host via `"--host=0.0.0.0"` (or `WEB_UI_HOST=0.0.0.0`).
-
-It may take a while the first time. You should see output like the screenshot below. The RFC error is ok for now as we did not yet connect our local development to another instance in docker.
-![First run](../res/dev/devinst-7.png)
-
-
-After inserting my API key in settings, my Agent Zero instance works. I can send a simple message and get a response.
-Some tools like code execution will not work yet because they need to be connected to a Dockerized instance.
-
-![First message](../res/dev/devinst-8.png)
-
-
-## Debugging
-- You can try out the debugger already by placing a breakpoint somewhere in the python code.
-- Let's open `python/api/message.py` for example and place a breakpoint at the beginning of the `communicate` function by clicking on the left of the row number. A red dot should appear showing a breakpoint is set.
-
-![Debugging](../res/dev/devinst-9.png)
-
-- Now when I send a message in the UI, the debugger will pause the execution at the breakpoint and allow me to inspect all the runtime variables and run the code step by step, even modify the variables or jump to another locations in the code. No more print statements needed!
-
-![Debugging](../res/dev/devinst-10.png)
-
-
-## Step 5: Run another instance of Agent Zero in Docker
-- Some parts of A0 require standardized linux environment, additional web services and preinstalled binaries that would be unneccessarily complex to set up in a local environment.
-- To make development easier, we can use existing A0 instance in docker and forward some requests to be executed there using SSH and RFC (Remote Function Call).
-
-1. Pull the docker image `agent0ai/agent-zero` from Docker Hub and run it with a web port (`80`) mapped and SSH port (`22`) mapped.
-If you want, you can also map the `/a0` folder to our local project folder as well, this way we can update our local instance and the docker instance at the same time.
-This is how it looks in my example: port `80` is mapped to `8880` on the host and `22` to `8822`, `/a0` folder mapped to `/Users/frdel/Desktop/agent-zero`:
-
-![docker run](../res/dev/devinst-11.png)
-![docker run](../res/dev/devinst-12.png)
-
-
-## Step 6: Configure SSH and RFC connection
-- The last step is to configure the local development (VS Code) instance and the dockerized instance to communicate with each other. This is very simple and can be done in the settings in the Web UI of both instances.
-- In my example the dark themed instance is the VS Code one, the light themed one is the dockerized instance.
-
-1. Open the "Settings" page in the Web UI of your dockerized instance and go in the "Development" section.
-2. Set the `RFC Password` field to a new password and save.
-3. Open the "Settings" page in the Web UI of your local instance and go in the "Development" section.
-4. Here set the `RFC Password` field to the same password you used in the dockerized instance. Also set the SSH port and HTTP port the same numbers you used when creating the container - in my case `8822` for SSH and `8880` for HTTP. The `RFC Destination URL` will most probably stay `localhost` as both instances are running on the host machine.
-5. Click save and test by asking your agent to do something in the terminal, like "Get current OS version". It should be able to communicate with the dockerized instance via RFC and SSH and execute the command there, responding with something like "Kali GNU/Linux Rolling".
-
-My Dockerized instance:
-![Dockerized instance](../res/dev/devinst-14.png)
-
-My VS Code instance:
-![VS Code instance](../res/dev/devinst-13.png)
-
-## RFC Notes (Host IDE + Docker Execution)
-Agent Zero runs code inside the container by default. If you are running the framework locally in your IDE but want tools (like code execution) to run in Docker, configure RFC in **Settings -> Development** and point it to a running Agent Zero container. This routes execution through SSH/RFC to the container while keeping the UI and agent loop on your host.
-
-
-# Congratulations!
-
-You have successfully set up a complete Agent Zero development environment! You now have:
-
-- A local development instance running in your IDE with full debugging capabilities
-- A dockerized instance for code execution and system operations
-- RFC and SSH communication between both instances
-- The ability to develop, debug, and test Agent Zero features seamlessly
-
-You're now ready to contribute to Agent Zero, create custom extensions, or modify the framework to suit your needs. Happy coding!
-
-
-## Next steps
-- See [Create a Small Plugin](../guides/create-plugin.md) before building a new plugin.
-- Use [DeepWiki for Agent Zero](https://deepwiki.com/agent0ai/agent-zero) for architecture and source-linked internals.
-- See [Contributing to Agent Zero](../guides/contribution.md) for contribution basics.
-
-## Configuration via Environment Variables
-
-For development and testing, you can override default settings using the `.env` file with `A0_SET_` prefixed variables:
-
-```env
-# Add to your .env file
-A0_SET_chat_model_provider=ollama
-A0_SET_chat_model_name=llama3.2
-A0_SET_chat_model_api_base=http://localhost:11434
-A0_SET_memory_recall_interval=5
-```
-
-These environment variables automatically override the hardcoded defaults in `get_default_settings()` without modifying code. Useful for testing different configurations or multi-environment setups.
-
-## Want to build your docker image?
-- You can use the `DockerfileLocal` to build your docker image.
-- Navigate to your project root in the terminal and run `docker build -f DockerfileLocal -t agent-zero-local --build-arg CACHE_DATE=$(date +%Y-%m-%d:%H:%M:%S) .`
-- The `CACHE_DATE` argument is optional, it is used to cache most of the build process and only rebuild the last steps when the files or dependencies change.
-- See `docker/run/build.txt` for more build command examples.
-- Automated Docker Hub publishing for release tags is handled by `.github/workflows/docker-publish.yml`. The latest eligible `main` tag generates its GitHub release body on the fly from commit subjects and descriptions via OpenRouter.
+version https://git-lfs.github.com/spec/v1
+oid sha256:71d5be20f1035b01e37236efe2d1baedaf829baf99e575cf841b9db2d47f96b6
+size 12391

docs/setup/installation.md

@@ -1,871 +1,3 @@
-# Installation Guide
-
-## **Goal:** Go from zero to a first working chat with minimal setup.
-
----
-
-## Quick Start (Recommended)
-
-Agent Zero runs as a Docker container, and you now have two friendly ways to get
-there:
-
-- **A0 Launcher** is the desktop app. It can download Agent Zero, create and
-  manage Instances, and help set up the local container runtime when needed.
-- **A0 Install** is the terminal installer. It is best for SSH sessions,
-  servers, scripted setup, recovery shells, or users who prefer commands.
-
-If Docker is already installed and running, you can also start the container
-directly.
-
-### A0 Launcher
-
-Use **A0 Launcher** when you want the guided desktop path. Download the app for
-your platform, open it, and let it check Docker or set up a runtime before it
-downloads Agent Zero.
-
-#### Downloads
-
-| Architecture | macOS | Linux | Windows |
-| --- | --- | --- | --- |
-| x86 | [Mac Intel](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-macos-x64.dmg) | [Linux x86](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-linux-x64.AppImage) | [Windows x86](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-windows-x64.exe) |
-| ARM64 | [Mac Apple Silicon](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-macos-arm64.dmg) | [Linux ARM64](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-linux-arm64.AppImage) | [Windows ARM64](https://github.com/agent0ai/a0-launcher/releases/download/v0.9/a0-launcher-0.9-windows-arm64.exe) |
-
-See the [A0 Launcher v0.9 release](https://github.com/agent0ai/a0-launcher/releases/tag/v0.9)
-for release notes and updater metadata. See the
-[Launcher guide](../guides/launcher.md) for the first-run walkthrough.
-
-### A0 Install
-
-Use **A0 Install** when you want the command-line path. The installer creates a
-Dockerized Agent Zero instance, mounts user data to `/a0/usr`, and tries to
-reuse an existing Docker-compatible runtime before setting one up.
-
-#### macOS / Linux
-```bash
-curl -fsSL https://bash.agent-zero.ai | bash
-```
-
-#### Windows PowerShell
-```powershell
-irm https://ps.agent-zero.ai | iex
-```
-
-#### Headless / scripted
-
-For servers and automation, Quick Start mode creates one instance and exits
-without opening menus:
-
-```bash
-curl -fsSL https://bash.agent-zero.ai | bash -s -- --quick-start --name agent-zero --port 5080
-```
-
-```powershell
-& ([scriptblock]::Create((irm https://ps.agent-zero.ai))) -QuickStart -Name agent-zero -Port 5080
-```
-
-Use `--skip-runtime-setup` / `-SkipRuntimeSetup` when Docker must already be
-working and the installer should not try to set up a runtime. See the
-[A0 Install repository](https://github.com/agent0ai/a0-install) for all
-installer flags.
-
-### Docker already installed? Run this directly
-
-```bash
-docker run -p 80:80 -v a0_usr:/a0/usr agent0ai/agent-zero
-```
-
-Once the install completes, open the URL shown in your terminal or Launcher to
-access the Web UI. Complete onboarding, add your model provider or API key, then
-continue to [Step 3: Configure Agent Zero](#step-3-configure-agent-zero).
-
-> [!TIP]
-> Need Agent Zero to reach host-machine files, shell, or a host browser? Install the optional [A0 CLI Connector](../guides/a0-cli-connector.md), then run `a0` to connect your terminal to this Agent Zero instance.
-
----
-
-## How to Update Agent Zero
-
-### Self Update (Recommended)
-
-Use the built-in updater in the Web UI:
-
-1. Open **Settings UI -> Update** tab
-2. Open **Self Update**
-3. Wait for the update checker to see if you have the latest version or if there's an available update. 
-
-You'll also be prompted through the UI when a new A0 version is released. Backups are automatically managed internally during this process.
-
-For technical details of the updater, see [Self Update](../guides/self-update.md).
-
-### Updating from v1.20 to v2.0
-
-Agent Zero v2.0 starts a new major release line. If your instance is on v1.20,
-the in-app Self Update can show the newer v2.x line, but it will not apply that
-jump inside the existing v1 Docker image. The safe path is:
-
-1. Create a backup zip from the old v1.20 instance.
-2. Pull the new `agent0ai/agent-zero:latest` Docker image. For the v2.0 release,
-   `latest` is the v2.0 image.
-3. Start a new container from that image.
-4. Restore the backup zip into the new v2.0 instance.
-
-![Self Update warning for a newer major release line](../res/usage/updating/self-update-v1-to-v2-warning.png)
-
-#### Without Agent Zero Launcher
-
-Use this path if you manage Agent Zero directly from Docker Desktop or Docker
-CLI.
-
-1. Open your old v1.20 Web UI and create a backup from **Settings -> Check for Updates -> Backup & Restore -> Create Backup**. Keep the downloaded `.zip` file.
-2. Pull the v2.0 image. In **Docker Desktop**, search for `agent0ai/agent-zero:latest` and pull that image. In **Docker CLI**, run:
-   ```bash
-   docker pull agent0ai/agent-zero:latest
-   ```
-3. Start a new v2.0 container on a different host port so the old instance stays available:
-   ```bash
-   docker run -d -p 50081:80 --name agent-zero-v2 -v a0_v2_usr:/a0/usr agent0ai/agent-zero:latest
-   ```
-4. Open the new v2.0 instance, complete any first-run prompts, then restore the downloaded `.zip` from **Settings -> Check for Updates -> Backup & Restore -> Restore Backup**.
-5. Verify chats, projects, memory, settings, and custom plugins before removing the old v1.20 container.
-
-#### With Agent Zero Launcher
-
-Launcher gives you the same backup/restore idea from the **Instances** page.
-
-1. Open **Instances**, choose the old v1.20 Instance, and use **Backup `/a0/usr`**.
-2. Open **Installs**, use the **latest** card, then **Install** or **Run** the image. For the v2.0 release, **latest** is the v2.0 image.
-3. Return to **Instances**, choose the new v2.0 Instance, and use **Restore `/a0/usr`** with the backup zip.
-4. Open the new Instance and verify it before deleting or stopping the old v1.20 container.
-
-Launcher keeps old and new Instances visible separately, which makes it easier
-to compare them before cleanup.
-
-> [!CAUTION]
-> Do not try to solve the v1.20 -> v2.0 jump by bind-mounting the whole old
-> `/a0` directory into a new container. Keep user data under `/a0/usr`, use the
-> backup/restore flow, and let the new image provide the v2.0 system files.
-
-### Updating from Pre-v0.9.8
-
-If you are upgrading from Agent Zero v0.9.8 or earlier to v1.1 or newer, use the migration path below. Older installs were laid out differently, so the in-app Self Update is not the right tool for that jump.
-
-1. **Backup your existing `usr/` directory** (which contains your settings, projects, memory, and custom plugins).
-2. **Run the new install script** to set up the current Docker-based install:
-   - macOS / Linux: `curl -fsSL https://bash.agent-zero.ai | bash`
-   - Windows (PowerShell): `irm https://ps.agent-zero.ai | iex`
-3. **Migrate your data:** After the new installation completes, copy the contents of your backed-up `usr/` directory into the new `/a0/usr/` directory created by the script.
-4. Restart the container for the changes to take effect.
-
-### Manual Update (Advanced)
-
-> Use this only if Self Update is unavailable or you must manage containers yourself (for example, some custom Docker setups).
-
-1. Keep the current container running
-2. `docker pull agent0ai/agent-zero:latest`
-3. Start a **new** container on a different host port, for example: `docker run -d -p 50081:80 --name agent-zero-new agent0ai/agent-zero:latest`
-4. On the **old** instance: **Settings -> Check for Updates -> Backup & Restore -> Create Backup**
-5. On the **new** instance: restore the downloaded backup zip
-6. Verify chats and data, then remove the old container
-
-> [!CAUTION]
-> Do not delete the old container until the new one has your data.
-
-> [!TIP]
-> If the new instance fails to load settings, remove `/a0/usr/settings.json` and restart to regenerate default settings.
-
----
-
-## Manual Installation (Advanced)
-
-> Users should use [Quick Start (Recommended)](#quick-start-recommended) above. The steps below are for custom Docker setups, air-gapped installs, or when you cannot use the install scripts.
-
-Follow the steps below to install Docker and run the image by hand.
-
-### Step 1: Install Docker Desktop
-
-Docker Desktop provides the runtime environment for Agent Zero, ensuring consistent behavior and security across platforms. The entire framework runs within a Docker container, providing isolation and easy deployment.
-
-**Choose your operating system:**
-
-<table>
-<tr>
-<td align="center" width="33%">
-<a href="#windows-installation">
-<img src="../res/setup/oses/windows.png" width="80" alt="Windows"/><br/>
-<b>Windows</b>
-</a>
-</td>
-<td align="center" width="33%">
-<a href="#macos-installation">
-<img src="../res/setup/oses/apple.png" width="80" alt="macOS"/><br/>
-<b>macOS</b>
-</a>
-</td>
-<td align="center" width="33%">
-<a href="#linux-installation">
-<img src="../res/setup/oses/linux.png" width="80" alt="Linux"/><br/>
-<b>Linux</b>
-</a>
-</td>
-</tr>
-</table>
-
----
-
-<a name="windows-installation"></a>
-#### <img src="../res/setup/oses/windows.png" width="30" alt="Windows"/> Windows Installation
-
-**1.1. Download Docker Desktop**
-
-Go to the [Docker Desktop download page](https://www.docker.com/products/docker-desktop/) and download the Windows version (Intel/AMD is the main download button).
-
-<img src="../res/setup/image-8.png" alt="docker download" width="200"/>
-<br><br>
-
-**1.2. Run the Installer**
-
-Run the installer with default settings.
-
-<img src="../res/setup/image-9.png" alt="docker install" width="300"/>
-<img src="../res/setup/image-10.png" alt="docker install" width="300"/>
-<br><br>
-
-**1.3. Launch Docker Desktop**
-
-Once installed, launch Docker Desktop from your Start menu or desktop shortcut.
-
-<img src="../res/setup/image-11.png" alt="docker installed" height="100"/>
-
-**Docker is now installed.**
-
-Continue to [Step 2: Run Agent Zero](#step-2-run-agent-zero)
-
----
-
-<a name="macos-installation"></a>
-#### <img src="../res/setup/oses/apple.png" width="30" alt="macOS"/> macOS Installation
-
-**1.1. Download Docker Desktop**
-
-Go to the [Docker Desktop download page](https://www.docker.com/products/docker-desktop/) and download the macOS version (choose Apple Silicon or Intel based on your Mac).
-
-<img src="../res/setup/image-8.png" alt="docker download" width="200"/>
-<br><br>
-
-**1.2. Install Docker Desktop**
-
-Drag and drop the Docker application to your Applications folder.
-
-<img src="../res/setup/image-12.png" alt="docker install" width="300"/>
-<br><br>
-
-**1.3. Launch Docker Desktop**
-
-Open Docker Desktop from your Applications folder.
-
-<img src="../res/setup/image-13.png" alt="docker installed" height="100"/>
-<br><br>
-
-**1.4. Configure Docker Socket**
-
-> [!NOTE]
-> **Important macOS Configuration:** In Docker Desktop's preferences (Docker menu) -> Settings -> Advanced, enable "Allow the default Docker socket to be used (requires password)."
-
-![docker socket macOS](../res/setup/macsocket.png)
-
-**Docker is now installed.**
-
-Continue to [Step 2: Run Agent Zero](#step-2-run-agent-zero)
-
----
-
-<a name="linux-installation"></a>
-#### <img src="../res/setup/oses/linux.png" width="30" alt="Linux"/> Linux Installation
-
-**1.1. Choose Installation Method**
-
-You can install either Docker Desktop or docker-ce (Community Edition).
-
-**Option A: Docker Desktop (Recommended for beginners)**
-
-Follow the instructions for your specific Linux distribution [here](https://docs.docker.com/desktop/install/linux-install/).
-
-**Option B: docker-ce (Lightweight alternative)**
-
-Follow the installation instructions [here](https://docs.docker.com/engine/install/).
-
-**1.2. Post-Installation Steps (docker-ce only)**
-
-If you installed docker-ce, add your user to the `docker` group:
-
-```bash
-sudo usermod -aG docker $USER
-```
-
-Log out and back in, then authenticate:
-
-```bash
-docker login
-```
-
-**1.3. Launch Docker**
-
-If you installed Docker Desktop, launch it from your applications menu.
-
-**Docker is now installed.**
-
-> [!TIP]
-> **Deploying on a VPS/Server?** For production deployments with reverse proxy, SSL, and domain configuration, see the [VPS Deployment Guide](vps-deployment.md).
-
----
-
-### Step 2: Run Agent Zero
-
-#### 2.1. Pull the Agent Zero Docker Image
-
-**Using Docker Desktop GUI:**
-
-- Search for `agent0ai/agent-zero` in Docker Desktop
-- Click the `Pull` button
-- The image will be downloaded to your machine in a few minutes
-
-![docker pull](../res/setup/1-docker-image-search.png)
-
-**Using Terminal:**
-
-```bash
-docker pull agent0ai/agent-zero
-```
-
-#### 2.2. (Optional) Map Folders for Persistence
-
-Choose or create a folder on your computer where Agent Zero will save its data. 
-
-Setting up persistence is needed only if you want your data and files to remain available even after you delete the container.
-
-You can pick any location you find convenient:
-
-- **Windows:** `C:\agent-zero-data`
-- **macOS/Linux:** `/home/user/agent-zero-data`
-
-You can map just the `/a0/usr` directory (recommended) or individual subfolders of `/a0` to a local directory.
-
-> [!CAUTION]
-> Do **not** map the entire `/a0` directory: it contains the application code and can break upgrades.
-
-> [!TIP]
-> Choose a location that's easy to access and backup. All your Agent Zero data will be directly accessible in this directory.
-
-#### 2.3. Run the Container
-
-**Using Docker Desktop GUI:**
-
-- In Docker Desktop, go to the "Images" tab
-- Click the `Run` button next to the `agent0ai/agent-zero` image
-- Open the "Optional settings" menu
-- **Ensure at least one host port is mapped to container port `80`** (set host port to `0` for automatic assignment)
-- Click the `Run` button
-
-![docker port mapping](../res/setup/2-docker-image-run.png)
-![docker volume mapping](../res/setup/2-docker-image-run-3.png)
-
-The container will start and show in the "Containers" tab:
-
-![docker containers](../res/setup/4-docker-container-started.png)
-
-#### 2.4. Access the Web UI
-
-The framework will take a few seconds to initialize. Find the mapped port in Docker Desktop (shown as `<PORT>:80`) or click the port right under the container ID:
-
-![docker logs](../res/setup/5-docker-click-to-open.png)
-
-Open `http://localhost:<PORT>` in your browser. The Web UI will open - Agent Zero is ready for configuration!
-
-![docker ui](../res/setup/6-docker-a0-running-new.png)
-
-> [!TIP]
-> You can also access the Web UI by clicking the port link directly under the container ID in Docker Desktop.
-
-> [!NOTE]
-> After starting the container, you'll find all Agent Zero files in your chosen directory. You can access and edit these files directly on your machine, and the changes will be immediately reflected in the running container.
-
-**Running A0 using Terminal?**
-
-```bash
-docker run -p 0:80 -v /path/to/your/work_dir:/a0/usr agent0ai/agent-zero
-```
-
-- Replace `0` with a fixed port if you prefer (e.g., `50080:80`)
-
----
-
-## Step 3: Configure Agent Zero
-
-The UI opens on the welcome screen. If model setup is missing, send a message
-or use the setup shortcuts to choose Cloud, AI account, or Local access, then
-select your main and utility models. For the screenshot walkthrough, see the
-[First-Run Onboarding guide](../guides/onboarding.md).
-
-### Settings Configuration
-
-Agent Zero provides a comprehensive settings interface to customize various aspects of its functionality. Access the settings by clicking the "Settings" button with a gear icon in the sidebar.
-
-### Agent Configuration
-
-- **Agent Profile:** Select the default profile for new chats, such as `agent0`,
-  `hacker`, or `researcher`.
-- **Memory Subdirectory:** Select the subdirectory for agent memory storage, allowing separation between different instances.
-- **Knowledge Subdirectory:** Specify the location of custom knowledge files to enhance the agent's understanding.
-
-See the [Agent Profiles guide](../guides/agent-profiles.md) for profile
-switching, the Easy and Advanced editors, capability policy, and project
-availability.
-
-> [!NOTE]
-> Since v0.9.7, custom prompts belong inside a specific agent profile rather
-> than a shared `/prompts` folder. Most users should use **Manage agents** and
-> the Agent Editor instead of editing files directly.
-
-> [!NOTE]
-> The Hacker profile is included in the main image. After launch, choose the **hacker** agent profile in Settings to make it the default for new chats, or switch the selected chat from the composer profile selector. The "hacker" branch is deprecated.
-
-![settings](../res/setup/settings/1-agentConfig.png)
-
-### Chat Model Settings
-
-- **Provider:** Select the chat model provider (e.g., Anthropic)
-- **Model Name:** Choose the specific model (e.g., claude-sonnet-4-5)
-- **Context Length:** Set the maximum token limit for context window
-- **Context Window Space:** Configure how much of the context window is dedicated to chat history
-
-![chat model settings](../res/setup/settings/2-chat-model.png)
-
-**Model naming is provider-specific.**
-
-Use `claude-sonnet-4-5` for Anthropic, but use `anthropic/claude-sonnet-4-5` for OpenRouter. If you see "Invalid model ID," verify the provider and naming format on the provider website, or search the web for "<name-of-ai-model> model naming".
-
-> [!TIP]
-> **Context window tuning:** Set the total context window size first (for example, 100k), then adjust the chat history portion as a fraction of that total. A large fraction on a very large context window can still be enormous.
-
-> [!TIP]
-> **API URL:** URL of the API endpoint for the chat model - only needed for some providers like Ollama, LM Studio, Azure, etc.
-
-### Utility Model Configuration
-
-- **Provider & Model:** Select a model for utility tasks like memory organization and summarization
-- **Temperature:** Adjust the determinism of utility responses
-
-> [!NOTE]
-> Utility models need to be strong enough to extract and consolidate memory reliably. Very small models (e.g., 4B) often fail at this; 70B-class models or high-quality cloud "flash/mini" models work best.
-
-### Embedding Model Settings [Optional]
-
-- **Provider:** Choose the embedding model provider (e.g., OpenAI)
-- **Model Name:** Select the specific embedding model (e.g., text-embedding-3-small)
-
-> [!NOTE]
-> Agent Zero uses a local embedding model by default (runs on CPU), but you can switch to OpenAI embeddings like `text-embedding-3-small` or `text-embedding-3-large` if preferred.
-
-### Built-in Voice Plugins
-
-- Agent Zero ships Whisper STT as the built-in `_whisper_stt` plugin and Kokoro TTS as the built-in `_kokoro_tts` plugin.
-- Docker/bootstrap remains responsible for installing the required speech dependencies such as `ffmpeg`, Kokoro, Whisper, and `soundfile`.
-- Both plugins can be enabled or disabled independently from the Agent Plugins section in the Web UI.
-- Whisper model size, language, message handling, and silence behavior are configured from the plugin settings screen.
-- If `_kokoro_tts` is disabled, spoken output falls back to the browser's native speech synthesis instead of the container runtime.
-
-### API Keys
-
-Configure API keys for various service providers directly within the Web UI. Click `Save` to confirm your settings.
-
-> [!NOTE]
-> **OpenAI API vs Plus subscription:** A ChatGPT Plus subscription does not include API credits. You must provide a separate API key for OpenAI usage in Agent Zero.
-
-> [!TIP]
-> For OpenAI-compatible providers (e.g., custom gateways or Z.AI/GLM), add the API key under **External Services -> Other OpenAI-compatible API keys**, then select **OpenAI Compatible** as the provider in model settings.
-
-> [!CAUTION]
-> **GitHub Copilot Provider:** When using the GitHub Copilot provider, after selecting the model and entering your first prompt, the OAuth login procedure will begin. You'll find the authentication code and link in the output logs. Complete the authentication process by following the provided link and entering the code, then you may continue using Agent Zero.
-
-### Authentication
-
-- **UI Login:** Set username for web interface access
-- **UI Password:** Configure password for web interface security
-- **Root Password:** Manage Docker container root password for SSH access
-
-![settings](../res/setup/settings/3-auth.png)
-
-### Development Settings
-
-- **RFC Parameters (local instances only):** Configure URLs and ports for remote function calls between instances
-- **RFC Password:** Configure password for remote function calls
-
-Learn more about Remote Function Calls in the [Development Setup guide](dev-setup.md#step-6-configure-ssh-and-rfc-connection).
-
-> [!IMPORTANT]
-> Always keep your API keys and passwords secure.
-
-> [!NOTE]
-> On Windows host installs (non-Docker), you must use RFC to run shell code on the host system. The Docker runtime handles this automatically.
-
----
-
-## Choosing Your LLMs
-
-The Settings page is the control center for selecting the Large Language Models (LLMs) that power Agent Zero. You can choose different LLMs for different roles:
-
-| LLM Role | Description |
-| --- | --- |
-| `chat_llm` | This is the primary LLM used for conversations, agent reasoning, and tool use. Vision support controls image understanding. |
-| `utility_llm` | This LLM handles internal tasks like summarizing messages, managing memory, and processing internal prompts. Using a smaller, less expensive model here can improve efficiency. |
-| `embedding_llm` | The embedding model shipped with A0 runs on CPU and is responsible for generating embeddings used for memory retrieval and knowledge base lookups. Changing the `embedding_llm` will re-index all of A0's memory. |
-
-**How to Change:**
-
-1. Open Settings page in the Web UI.
-2. Choose the provider for the LLM for each role (Main Model, Utility Model, Embedding Model) and write the model name.
-3. Click "Save" to apply the changes.
-
-> [!NOTE]
-> The built-in Browser does not have a separate default model slot. The main agent decides when to call the direct `browser` tool. Browser settings can optionally choose a Browser LLM preset for Browser-owned helper operations.
-
-### Important Considerations
-
-#### Model Naming by Provider
-
-Use the naming format required by your selected provider:
-
-| Provider | Model Name Format | Example |
-| --- | --- | --- |
-| OpenAI | Model name only | `claude-sonnet-4-5` |
-| OpenRouter | Provider prefix mostly required | `anthropic/claude-sonnet-4-5` |
-| Ollama | Model name only | `gpt-oss:20b` |
-| oMLX | API-visible model name from `/v1/models` | `Qwen3-0.6B-4bit` |
-| llama.cpp | API-visible model name from `/v1/models` or `--alias` | `local-gguf` |
-| vLLM | Hugging Face model ID or served model alias | `Qwen/Qwen2.5-1.5B-Instruct` |
-
-> [!TIP]
-> If you see "Invalid model ID," verify the provider and naming format on the provider website, or search the web for "<name-of-ai-model> model naming".
-
-#### Local Model Server Addresses From Docker
-
-When Agent Zero runs in Docker, `localhost` and `127.0.0.1` inside an API base URL mean the Agent Zero container, not your host machine. For a model server running on the host, use `http://host.docker.internal:<port>` when available, or the Docker host gateway address such as `http://172.17.0.1:<port>` on the default Linux bridge.
-
-If the model server only listens on host loopback, for example `127.0.0.1:<port>`, the container still cannot reach it through the gateway. Configure the local server to listen on a Docker-reachable address such as `0.0.0.0`, and keep that port limited to trusted clients.
-
-#### Context Window & Memory Split
-
-- Set the **total context window** (e.g., 100k) first.
-- Then tune the **chat history portion** as a fraction of that total.
-- Extremely large totals can make even small fractions very large; adjust thoughtfully.
-
-#### Utility Model Guidance
-
-- Utility models handle summarization and memory extraction.
-- Very small models (about 4B) usually fail at reliable context extraction.
-- Aim for ~70B class models or strong cloud "flash/mini" models for better results.
-
-#### Reasoning/Thinking Models
-
-- Reasoning can increase cost and latency. Some models perform better **without** reasoning.
-- If a model supports it, disable reasoning via provider-specific parameters (e.g., Venice `disable_thinking=true`).
-
----
-
-## Installing and Using oMLX (Apple Silicon Local Models)
-
-oMLX is a local inference server for Apple Silicon Macs. It serves MLX models through an OpenAI-compatible API and supports chat, embeddings, and model listing endpoints.
-
-> [!NOTE]
-> oMLX requires Apple Silicon and macOS 15+. On 16 GB machines, start with small quantized MLX models.
-
-### macOS oMLX Installation
-
-**Using Homebrew:**
-
-```bash
-brew tap jundot/omlx https://github.com/jundot/omlx
-brew install omlx
-omlx start
-```
-
-**Using the macOS App:**
-
-Download the oMLX app from the [official website](https://omlx.ai/) and follow the welcome flow to choose a model directory, start the server, and download or discover models.
-
-By default, oMLX serves its OpenAI-compatible API at `http://localhost:8000/v1`.
-
-To run a foreground server with oMLX's paged SSD cache enabled:
-
-```bash
-omlx serve --model-dir ~/.omlx/models --paged-ssd-cache-dir ~/.omlx/cache
-```
-
-### Configuring oMLX in Agent Zero
-
-1. Start oMLX and make sure at least one model is available in the oMLX dashboard or model directory.
-2. In Agent Zero Settings, choose **oMLX** as the Chat model, Utility model, or Embedding model provider.
-3. Use the model name shown by oMLX's model list or dashboard.
-4. Agent Zero includes Docker-friendly defaults for oMLX on the host at `http://host.docker.internal:8000/v1`. Override the API base URL only if your oMLX server runs somewhere else.
-5. Click `Save` to confirm your settings.
-
-> [!NOTE]
-> If Agent Zero runs in Docker and oMLX runs on the Mac host, ensure port **8000** is reachable from the container. The shipped Docker Compose file maps `host.docker.internal` to the host gateway for Linux Docker. Docker Desktop for macOS provides this hostname automatically.
-
----
-
-## Installing and Using llama.cpp (GGUF Local Models)
-
-llama.cpp provides `llama-server`, a lightweight OpenAI-compatible HTTP server for GGUF models. Agent Zero talks to it through the same `/v1` API used by OpenAI-compatible clients.
-
-### macOS llama.cpp Installation
-
-**Using Homebrew:**
-
-```bash
-brew install llama.cpp
-```
-
-Start a server with a downloaded GGUF model:
-
-```bash
-llama-server -m ~/models/model.gguf --port 8080 --alias local-gguf
-```
-
-By default, Agent Zero expects llama.cpp at `http://host.docker.internal:8080/v1`. The model name can be the model path returned by `/v1/models`, but using `--alias` gives you a short stable name such as `local-gguf`.
-
-### Configuring llama.cpp in Agent Zero
-
-1. Start `llama-server` and confirm `http://localhost:8080/v1/models` returns your model.
-2. In Agent Zero Settings, choose **llama.cpp** as the Chat model, Utility model, or Embedding model provider.
-3. Use the model ID shown by `/v1/models`, or the alias you passed with `--alias`.
-4. Override the API base URL only if you started `llama-server` on another host or port.
-5. Click `Save` to confirm your settings.
-
-> [!NOTE]
-> If Agent Zero runs in Docker and cannot reach a host-side `llama-server`, start the server on an address Docker can reach, for example `--host 0.0.0.0`, and keep the port firewalled to trusted clients.
-
----
-
-## Installing and Using vLLM (Local OpenAI-Compatible Serving)
-
-vLLM is a high-throughput local inference server with an OpenAI-compatible API. It is most common on Linux GPU hosts, and can also run on Apple Silicon through the vLLM Apple Silicon path or vLLM-Metal.
-
-For Apple Silicon Macs, install and activate vLLM-Metal:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/vllm-project/vllm-metal/main/install.sh | bash
-source ~/.venv-vllm-metal/bin/activate
-```
-
-Start a basic OpenAI-compatible server:
-
-```bash
-vllm serve Qwen/Qwen2.5-1.5B-Instruct --host 0.0.0.0 --port 8000
-```
-
-By default, Agent Zero expects vLLM at `http://host.docker.internal:8000/v1`, matching vLLM's default HTTP port. If another local provider already uses port 8000, start vLLM on another port and update Agent Zero's API base, for example `http://host.docker.internal:8001/v1`.
-
-### Configuring vLLM in Agent Zero
-
-1. Start vLLM and confirm `http://localhost:8000/v1/models` returns the served model.
-2. In Agent Zero Settings, choose **vLLM** as the Chat model, Utility model, or Embedding model provider.
-3. Use the model ID returned by vLLM's model list endpoint.
-4. If you started vLLM with `--api-key`, enter the same key in the advanced provider settings or environment.
-5. Click `Save` to confirm your settings.
-
-> [!NOTE]
-> vLLM serves one model at a time by default. Use a generation model for Chat and Utility slots, and a separate embedding-capable vLLM server if you want vLLM embeddings.
-
----
-
-## Installing and Using Ollama (Local Models)
-
-Ollama is a powerful tool that allows you to run various large language models locally.
-
----
-
-<a name="windows-ollama-installation"></a>
-### <img src="../res/setup/oses/windows.png" width="30" alt="Windows"/> Windows Ollama Installation
-
-Download and install Ollama from the official website:
-
-<button>[Download Ollama Setup](https://ollama.com/download/OllamaSetup.exe)</button>
-
-Once installed, continue to [Pulling Models](#pulling-models).
-
----
-
-<a name="macos-ollama-installation"></a>
-### <img src="../res/setup/oses/apple.png" width="30" alt="macOS"/> macOS Ollama Installation
-
-**Using Homebrew:**
-
-```bash
-brew install ollama
-```
-
-**Using Installer:**
-
-Download from the [official website](https://ollama.com/).
-
-Once installed, continue to [Pulling Models](#pulling-models).
-
----
-
-<a name="linux-ollama-installation"></a>
-### <img src="../res/setup/oses/linux.png" width="30" alt="Linux"/> Linux Ollama Installation
-
-Run the installation script:
-
-```bash
-curl -fsSL https://ollama.com/install.sh | sh
-```
-
-Once installed, continue to [Pulling Models](#pulling-models).
-
----
-
-### Pulling Models
-
-**Finding Model Names:**
-
-Visit the [Ollama model library](https://ollama.com/library) for a list of available models and their corresponding names. Ollama models are referenced by **model name only** (for example, `llama3.2`).
-
-**Pull a model:**
-
-```bash
-ollama pull <model-name>
-```
-
-Replace `<model-name>` with the name of the model you want to use. For example: `ollama pull mistral-large`
-
-### Configuring Ollama in Agent Zero
-
-1. Once you've downloaded your model(s), select it in the Settings page of the GUI.
-2. Within the Chat model, Utility model, or Embedding model section, choose **Ollama** as provider.
-3. Write your model code as expected by Ollama, in the format `llama3.2` or `qwen2.5:7b`
-4. Agent Zero includes Docker-friendly defaults for Ollama on the host at `http://host.docker.internal:11434`. Override the API base URL only if your Ollama server runs somewhere else.
-5. Click `Save` to confirm your settings.
-
-![ollama](../res/setup/settings/4-local-models.png)
-
-> [!NOTE]
-> If Agent Zero runs in Docker and Ollama runs on the host, ensure port **11434** is reachable from the container. The shipped Docker Compose file maps `host.docker.internal` to the host gateway for Linux Docker. If both services are in the same Docker network, you can use `http://<container_name>:11434` instead of `host.docker.internal`.
-
-### Managing Downloaded Models
-
-**Listing downloaded models:**
-
-```bash
-ollama list
-```
-
-**Removing a model:**
-
-```bash
-ollama rm <model-name>
-```
-
-> [!TIP]
-> Experiment with different model combinations to find the balance of performance and cost that best suits your needs. E.g., faster and lower latency LLMs will help, and you can also use `faiss_gpu` instead of `faiss_cpu` for the memory. 
-
----
-
-## Using Agent Zero on Your Mobile Device
-
-Agent Zero can be accessed from mobile devices and other computers using the built-in **Tunnel feature**.
-
-### Recommended: Using Tunnel (Remote Access)
-
-The Tunnel feature allows secure access to your Agent Zero instance from anywhere:
-
-1. Open Settings in the Web UI
-2. Navigate to the **External Services** tab
-3. Click on **Flare Tunnel** in the navigation menu
-4. Click **Create Tunnel** to generate a secure HTTPS URL
-5. Share this URL to access Agent Zero from any device
-
-> [!IMPORTANT]
-> **Security:** Always set a username and password in Settings -> Authentication before creating a tunnel to secure your instance on the internet.
-
-For complete details on tunnel configuration and security considerations, see the [Remote Access via Tunneling](../guides/usage.md#remote-access-via-tunneling) section in the Usage Guide.
-
-### Alternative: Local Network Access
-
-If you prefer to keep access limited to your local network:
-
-1. Find the mapped port in Docker Desktop (format: `<PORT>:80`, e.g., `32771:80`)
-2. Access from the same computer: `http://localhost:<PORT>`
-3. Access from other devices on the network: `http://<YOUR_COMPUTER_IP>:<PORT>`
-
-> [!TIP]
-> Find your computer's IP address with `ipconfig` (Windows) or `ifconfig`/`ip addr` (macOS/Linux). It's usually in the format `192.168.x.x` or `10.0.x.x`.
-
-For developers or users who need to run Agent Zero directly on their system, see the [In-Depth Guide for Full Binaries Installation](dev-setup.md).
-
----
-
-## Advanced: Automated Configuration via Environment Variables
-
-Agent Zero settings can be automatically configured using environment variables with the `A0_SET_` prefix in your `.env` file. This enables automated deployments without manual configuration.
-
-**Usage:**
-
-Add variables to your `.env` file in the format:
-
-```env
-A0_SET_{setting_name}={value}
-```
-
-**Examples:**
-
-```env
-# Model configuration
-A0_SET_chat_model_provider=anthropic
-A0_SET_chat_model_name=claude-3-5-sonnet-20241022
-A0_SET_chat_model_ctx_length=200000
-
-# Memory settings
-A0_SET_memory_recall_enabled=true
-A0_SET_memory_recall_interval=5
-
-# Agent configuration
-A0_SET_agent_profile=custom
-A0_SET_agent_memory_subdir=production
-```
-
-**Docker usage:**
-
-When running Docker, you can pass these as environment variables:
-
-```bash
-docker run -p 50080:80 \
-  -e A0_SET_chat_model_provider=anthropic \
-  -e A0_SET_chat_model_name=claude-3-5-sonnet-20241022 \
-  agent0ai/agent-zero
-```
-
-**Notes:**
-
-- These provide initial default values when settings.json doesn't exist or when new settings are added to the application. Once a value is saved in settings.json, it takes precedence over these environment variables.
-- Sensitive settings (API keys, passwords) use their existing environment variables
-- Container/process restart required for changes to take effect
-
----
-
-### Manual Migration (Legacy or Non-Docker)
-
-If you are migrating from older, non-Docker setups, A0 handles the migration of legacy folders and files automatically at runtime. The right place to save your files and directories is `a0/usr`.
-
-## Conclusion
-
-After following the instructions for your specific operating system, you should have Agent Zero successfully installed and running. You can now start exploring the framework's capabilities and experimenting with creating your own intelligent agents.
-
-**Next Steps:**
-
-- For production server deployments, see the [VPS Deployment Guide](vps-deployment.md)
-- For development setup and extensions, see the [Development Setup Guide](dev-setup.md)
-- For remote access via tunnel, see [Remote Access via Tunneling](../guides/usage.md#remote-access-via-tunneling)
-
-If you encounter any issues during the installation process, please consult the [Troubleshooting section](../guides/troubleshooting.md) of this documentation or refer to the Agent Zero [Skool](https://www.skool.com/agent-zero) or [Discord](https://discord.gg/B8KZKNsPpj) community for assistance.
+version https://git-lfs.github.com/spec/v1
+oid sha256:22679137b4317a0dafc352dca421aa13cd208db65b9b9deb843c6198730cfd6f
+size 35606

docs/setup/vps-deployment.md

@@ -1,770 +1,3 @@
-# Agent Zero Installation Guide
-
-> **Purpose:** Step-by-step guide for deploying Agent Zero instances on VPS/dedicated servers  
-> **Author:** Auto-generated from deployment experience  
-> **Last Updated:** December 21 2025  
-> **Compatibility:** Docker-capable Linux servers (AlmaLinux, CentOS, Rocky, Ubuntu, Debian)
-
----
-
-## Table of Contents
-
-1. [Prerequisites](#prerequisites)
-2. [Docker Installation](#docker-installation)
-3. [Agent Zero Container Deployment](#agent-zero-container-deployment)
-4. [Apache Reverse Proxy Configuration](#apache-reverse-proxy-configuration)
-5. [SSL/TLS Configuration](#ssltls-configuration)
-6. [Authentication Setup](#authentication-setup)
-7. [Domain & DNS Setup](#domain-dns-setup)
-8. [Verification & Testing](#verification-testing)
-9. [Troubleshooting](#troubleshooting)
-10. [Maintenance & Updates](#maintenance-updates)
-11. [Quick Reference](#quick-reference)
-
----
-
-## Prerequisites
-
-### Server Requirements
-
-| Requirement | Minimum | Recommended |
-|-------------|---------|-------------|
-| **RAM** | 2 GB | 4+ GB |
-| **Storage** | 20 GB | 50+ GB |
-| **CPU** | 1 vCPU | 2+ vCPU |
-| **OS** | Linux (64-bit) | AlmaLinux 9, Ubuntu 22.04+ |
-| **Network** | Static IP | Dedicated IP with reverse DNS |
-
-### Required Access
-
-- Root or sudo access to the server
-- SSH access (preferably on non-standard port)
-- Domain/subdomain with DNS control
-- SSL certificate (Let's Encrypt or commercial)
-
-### Software Dependencies
-
-- Docker Engine 24.0+
-- Apache 2.4+ with mod_proxy, mod_proxy_http, mod_proxy_wstunnel, mod_ssl, mod_rewrite
-- curl, git (optional)
-
----
-
-## Docker Installation
-
-> [!NOTE]
-> For detailed Docker installation instructions and alternative methods, see the [Linux Installation section](installation.md#linux-installation) in the main installation guide.
-
-### Method A: Debian/Ubuntu Systems
-
-```bash
-# Update package index
-apt-get update
-
-# Install prerequisites
-apt-get install -y ca-certificates curl gnupg
-
-# Add Docker's official GPG key
-install -m 0755 -d /etc/apt/keyrings
-curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
-chmod a+r /etc/apt/keyrings/docker.gpg
-
-# Set up repository
-echo   "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu   $(. /etc/os-release && echo "$VERSION_CODENAME") stable" |   tee /etc/apt/sources.list.d/docker.list > /dev/null
-
-# Install Docker
-apt-get update
-apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
-
-# Start and enable Docker
-systemctl enable docker
-systemctl start docker
-```
-
-### Method B: AlmaLinux/Rocky/CentOS/RHEL Systems
-
-```bash
-# Install required packages
-dnf -y install dnf-plugins-core
-
-# Add Docker repository (use CentOS repo for AlmaLinux/Rocky)
-dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
-
-# Install Docker
-dnf -y install docker-ce docker-ce-cli containerd.io docker-compose-plugin
-
-# Start and enable Docker
-systemctl enable docker
-systemctl start docker
-```
-
-### Method C: Generic (Convenience Script)
-
-> ⚠️ **Note:** May not work on all distributions (e.g., AlmaLinux)
-
-```bash
-curl -fsSL https://get.docker.com -o get-docker.sh
-sh get-docker.sh
-systemctl enable docker
-systemctl start docker
-```
-
-### Verify Docker Installation
-
-```bash
-docker --version
-docker run hello-world
-```
-
----
-
-## Agent Zero Container Deployment
-
-### Step 1: Create Directory Structure
-
-```bash
-# Choose your installation path
-A0_NAME="a0-instance"  # Change this to your instance name
-A0_PATH="/opt/${A0_NAME}"
-
-# Create directories
-mkdir -p ${A0_PATH}
-mkdir -p ${A0_PATH}/work_dir
-mkdir -p ${A0_PATH}/memory
-mkdir -p ${A0_PATH}/logs
-```
-
-### Step 2: Create Environment Configuration
-
-```bash
-# Create .env file with authentication
-cat > ${A0_PATH}/.env << 'EOF'
-# Agent Zero Configuration
-# Authentication (REQUIRED for web access)
-AUTH_LOGIN=your_username_here
-AUTH_PASSWORD=your_secure_password_here
-
-# Optional: Additional configuration
-# See Agent Zero documentation for all options
-EOF
-```
-
-> ⚠️ **CRITICAL:** `AUTH_LOGIN` is the **username**, not a boolean!
-> - ✅ Correct: `AUTH_LOGIN=admin`
-> - ❌ Wrong: `AUTH_LOGIN=true`
-
-### Step 3: Choose Host Port
-
-| Port | Use Case |
-|------|----------|
-| `50080` | Standard/recommended for reverse proxy setups |
-| `50081`, `50082`... | Additional instances on same server |
-| `80` | Direct access (not recommended for production) |
-
-### Step 4: Pull and Run Container
-
-```bash
-# Set variables
-A0_NAME="a0-instance"
-A0_PATH="/opt/${A0_NAME}"
-A0_PORT="50080"
-
-# Pull latest image
-docker pull agent0ai/agent-zero:latest
-
-# Run container
-docker run -d   --name ${A0_NAME}   --restart unless-stopped   -p ${A0_PORT}:80   -v ${A0_PATH}/.env:/a0/.env   -v ${A0_PATH}/usr:/a0/usr   agent0ai/agent-zero:latest
-```
-
-### Step 5: Verify Container
-
-```bash
-# Check container is running
-docker ps | grep ${A0_NAME}
-
-# Check logs
-docker logs ${A0_NAME}
-
-# Test local access
-curl -I http://127.0.0.1:${A0_PORT}/
-```
-
-Expected response: `HTTP/1.1 302 FOUND` with `Location: /login` (if auth enabled)
-
----
-
-## Apache Reverse Proxy Configuration
-
-### Required Apache Modules
-
-```bash
-# Debian/Ubuntu
-a2enmod proxy proxy_http proxy_wstunnel ssl rewrite headers
-systemctl restart apache2
-
-# AlmaLinux/CentOS (usually pre-loaded)
-httpd -M | grep -E "proxy|rewrite|ssl"
-```
-
-### Configuration for Standard Apache (Debian/Ubuntu)
-
-Create `/etc/apache2/sites-available/a0-instance.conf`:
-
-```apache
-# Agent Zero Reverse Proxy Configuration
-# Instance: a0-instance
-# Domain: a0.example.com
-
-# HTTP - Redirect to HTTPS
-<VirtualHost *:80>
-    ServerName a0.example.com
-    ServerAlias www.a0.example.com
-
-    RewriteEngine On
-    RewriteCond %{HTTPS} off
-    RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
-</VirtualHost>
-
-# HTTPS - Proxy to Container
-<VirtualHost *:443>
-    ServerName a0.example.com
-    ServerAlias www.a0.example.com
-    ServerAdmin webmaster@example.com
-
-    # SSL Configuration
-    SSLEngine on
-    SSLCertificateFile /path/to/certificate.crt
-    SSLCertificateKeyFile /path/to/private.key
-    SSLCertificateChainFile /path/to/chain.crt
-
-    # Proxy Configuration
-    ProxyPreserveHost On
-    ProxyPass / http://127.0.0.1:50080/
-    ProxyPassReverse / http://127.0.0.1:50080/
-
-    # WebSocket Support (Required for real-time features)
-    RewriteEngine On
-    RewriteCond %{HTTP:Upgrade} websocket [NC]
-    RewriteCond %{HTTP:Connection} upgrade [NC]
-    RewriteRule ^/?(.*) ws://127.0.0.1:50080/$1 [P,L]
-
-    # Logging
-    ErrorLog ${APACHE_LOG_DIR}/a0-instance.error.log
-    CustomLog ${APACHE_LOG_DIR}/a0-instance.access.log combined
-</VirtualHost>
-```
-
-Enable and restart:
-
-```bash
-a2ensite a0-instance.conf
-apache2ctl configtest
-systemctl reload apache2
-```
-
-### Configuration for DirectAdmin Apache (AlmaLinux/CentOS)
-
-#### Option A: Use httpd-includes.conf (Recommended)
-
-Edit `/etc/httpd/conf/extra/httpd-includes.conf`:
-
-```apache
-# Agent Zero Proxy Configuration
-# Instance: a0-instance
-# Domain: a0.example.com
-# Note: Use specific IP, not wildcards, for DirectAdmin compatibility
-
-<VirtualHost YOUR_SERVER_IP:80>
-    ServerName a0.example.com
-    ServerAlias www.a0.example.com
-
-    RewriteEngine On
-    RewriteCond %{HTTPS} off
-    RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
-</VirtualHost>
-
-<VirtualHost YOUR_SERVER_IP:443>
-    ServerName a0.example.com
-    ServerAlias www.a0.example.com
-    ServerAdmin webmaster@example.com
-
-    SSLEngine on
-    # DirectAdmin SSL cert paths (adjust user and domain)
-    SSLCertificateFile /usr/local/directadmin/data/users/USERNAME/domains/example.com.cert.combined
-    SSLCertificateKeyFile /usr/local/directadmin/data/users/USERNAME/domains/example.com.key
-
-    ProxyPreserveHost On
-    ProxyPass / http://127.0.0.1:50080/
-    ProxyPassReverse / http://127.0.0.1:50080/
-
-    # WebSocket Support
-    RewriteEngine On
-    RewriteCond %{HTTP:Upgrade} websocket [NC]
-    RewriteCond %{HTTP:Connection} upgrade [NC]
-    RewriteRule ^/?(.*) ws://127.0.0.1:50080/$1 [P,L]
-
-    ErrorLog /var/log/httpd/domains/a0.example.com.error.log
-    CustomLog /var/log/httpd/domains/a0.example.com.access.log combined
-</VirtualHost>
-```
-
-> ⚠️ **Important for DirectAdmin:**
-> - Use **specific IP address** (e.g., `192.168.1.100:443`), not `*:443`
-> - IP-bound vhosts take precedence over DirectAdmin's vhosts
-> - SSL certs are in `/usr/local/directadmin/data/users/USERNAME/domains/`
-
-#### Option B: Standalone conf.d file
-
-If `/etc/httpd/conf.d/` is included in your Apache config:
-
-```bash
-# Check if conf.d is included
-grep 'conf.d' /etc/httpd/conf/httpd.conf
-
-# If not, add before directadmin-vhosts.conf include:
-sed -i '/Include conf\/extra\/directadmin-vhosts.conf/i Include conf.d/*.conf' /etc/httpd/conf/httpd.conf
-
-# Create config
-mkdir -p /etc/httpd/conf.d
-cat > /etc/httpd/conf.d/httpd-vhosts-a0.conf << 'EOF'
-# Your vhost config here (same as Option A)
-EOF
-```
-
-### Verify and Restart Apache
-
-```bash
-# Test configuration
-httpd -t          # AlmaLinux/CentOS
-apachectl -t      # Alternative
-apache2ctl -t     # Debian/Ubuntu
-
-# Restart
-systemctl restart httpd   # AlmaLinux/CentOS
-systemctl restart apache2 # Debian/Ubuntu
-```
-
----
-
-## SSL/TLS Configuration
-
-### Option A: Let's Encrypt with Certbot
-
-```bash
-# Install Certbot
-# Debian/Ubuntu:
-apt-get install certbot python3-certbot-apache
-
-# AlmaLinux/CentOS:
-dnf install certbot python3-certbot-apache
-
-# Obtain certificate
-certbot --apache -d a0.example.com -d www.a0.example.com
-
-# Auto-renewal (usually automatic, but verify)
-certbot renew --dry-run
-```
-
-### Option B: DirectAdmin Auto-SSL
-
-If using DirectAdmin, SSL is typically managed automatically:
-
-1. Create domain/subdomain in DirectAdmin
-2. Enable "SSL" for the domain
-3. DirectAdmin will obtain Let's Encrypt certificate
-4. Certs stored in `/usr/local/directadmin/data/users/USERNAME/domains/`
-
-### Option C: Manual/Commercial Certificates
-
-Place certificates in secure location:
-
-```bash
-mkdir -p /etc/ssl/a0
-chmod 700 /etc/ssl/a0
-
-# Copy your certificates
-cp certificate.crt /etc/ssl/a0/
-cp private.key /etc/ssl/a0/
-cp chain.crt /etc/ssl/a0/  # if applicable
-
-chmod 600 /etc/ssl/a0/*
-```
-
----
-
-## Authentication Setup
-
-### Understanding A0 Authentication Variables
-
-| Variable | Purpose | Example |
-|----------|---------|--------|
-| `AUTH_LOGIN` | The **username** for login | `AUTH_LOGIN=admin` |
-| `AUTH_PASSWORD` | The **password** for login | `AUTH_PASSWORD=SecurePass123!` |
-
-> ⚠️ **Common Mistake:** `AUTH_LOGIN` is the username, **not** a boolean to enable auth!
-
-### Setting Up Authentication
-
-```bash
-# Edit .env file
-vi /opt/a0-instance/.env
-
-# Add/update these lines:
-AUTH_LOGIN=your_username
-AUTH_PASSWORD=your_secure_password
-
-# Restart container to apply
-docker restart a0-instance
-```
-
-### Password Requirements
-
-- Minimum 8 characters recommended
-- Special characters are supported (properly escaped)
-- Avoid these characters in passwords: `' " \` $ \` (or escape carefully)
-
-### Disabling Authentication (Not Recommended)
-
-To disable authentication (local/dev use only):
-
-```bash
-# Remove or comment out both lines in .env:
-# AUTH_LOGIN=
-# AUTH_PASSWORD=
-
-docker restart a0-instance
-```
-
----
-
-## Domain & DNS Setup
-
-### DNS Configuration
-
-Create an A record pointing to your server:
-
-| Type | Name | Value | TTL |
-|------|------|-------|-----|
-| A | a0 | YOUR_SERVER_IP | 300 |
-| A | www.a0 | YOUR_SERVER_IP | 300 |
-
-### DirectAdmin Subdomain Setup
-
-1. Log into DirectAdmin
-2. Navigate to: **Domain Setup** → Select domain → **Subdomain Management**
-3. Create subdomain (e.g., `a0`)
-4. Note: You'll override the DocumentRoot with Apache proxy config
-
-### Verify DNS Propagation
-
-```bash
-# Check DNS resolution
-dig a0.example.com +short
-nslookup a0.example.com
-
-# Should return your server IP
-```
-
----
-
-## Verification & Testing
-
-### Step-by-Step Verification Checklist
-
-```bash
-# 1. Verify Docker container is running
-docker ps | grep a0-instance
-
-# 2. Check container logs for errors
-docker logs a0-instance --tail 50
-
-# 3. Test local container access
-curl -I http://127.0.0.1:50080/
-# Expected: HTTP/1.1 302 FOUND, Location: /login
-
-# 4. Test Apache config
-httpd -t   # or apache2ctl -t
-
-# 5. Check Apache is proxying correctly
-curl -I http://127.0.0.1:80 -H "Host: a0.example.com"
-curl -Ik https://127.0.0.1:443 -H "Host: a0.example.com"
-
-# 6. Test external HTTPS access
-curl -I https://a0.example.com/
-# Expected: HTTP/2 302 with Location: /login
-
-# 7. Test login page loads
-curl -s https://a0.example.com/login | grep -i "<title>"
-# Expected: <title>Login - Agent Zero</title>
-```
-
-### WebSocket Verification
-
-```bash
-# Install wscat if needed
-npm install -g wscat
-
-# Test WebSocket connection
-wscat -c wss://a0.example.com/ws
-```
-
----
-
-## Troubleshooting
-
-### Issue: "Invalid Credentials" on Login
-
-**Cause:** Incorrect `.env` configuration
-
-**Fix:**
-```bash
-# Verify .env inside container
-docker exec a0-instance cat /a0/.env
-
-# Ensure format is:
-# AUTH_LOGIN=username  (NOT AUTH_LOGIN=true)
-# AUTH_PASSWORD=password
-
-# Restart after fixing
-docker restart a0-instance
-```
-
-### Issue: 403 Forbidden
-
-**Cause:** DirectAdmin vhost overriding custom proxy config
-
-**Fix:**
-```bash
-# Check vhost order
-httpd -S 2>&1 | grep your-domain
-
-# Ensure custom config loads BEFORE directadmin-vhosts.conf
-# Use specific IP binding (e.g., 192.168.1.1:443) not wildcards (*:443)
-
-# Restart Apache
-systemctl restart httpd
-```
-
-### Issue: 502 Bad Gateway
-
-**Cause:** Container not running or wrong port
-
-**Fix:**
-```bash
-# Check container status
-docker ps -a | grep a0-instance
-
-# If stopped, check logs
-docker logs a0-instance
-
-# Restart container
-docker start a0-instance
-
-# Verify port binding
-netstat -tlnp | grep 50080
-```
-
-### Issue: 504 Gateway Timeout
-
-**Cause:** Container overloaded or unresponsive
-
-**Fix:**
-```bash
-# Check container resource usage
-docker stats a0-instance --no-stream
-
-# Restart container
-docker restart a0-instance
-
-# Check for memory issues
-free -h
-```
-
-### Issue: WebSocket Connection Failed
-
-**Cause:** Missing WebSocket proxy rules
-
-**Fix:**
-Ensure these lines are in your vhost config:
-
-```apache
-RewriteEngine On
-RewriteCond %{HTTP:Upgrade} websocket [NC]
-RewriteCond %{HTTP:Connection} upgrade [NC]
-RewriteRule ^/?(.*) ws://127.0.0.1:50080/$1 [P,L]
-```
-
-### Issue: Container Won't Start
-
-**Cause:** Port conflict or Docker issue
-
-**Fix:**
-```bash
-# Check what's using the port
-netstat -tlnp | grep 50080
-
-# Remove conflicting container
-docker rm -f conflicting-container
-
-# Check Docker daemon
-systemctl status docker
-journalctl -u docker --since "1 hour ago"
-```
-
-### Issue: Changes to .env Not Taking Effect
-
-**Cause:** Container needs restart to reload env
-
-**Fix:**
-```bash
-docker restart a0-instance
-
-# Verify env is loaded
-docker exec a0-instance cat /a0/.env
-```
-
----
-
-## Maintenance & Updates
-
-### Updating Agent Zero
-
-```bash
-# Pull latest image
-docker pull agent0ai/agent-zero:latest
-
-# Stop and remove old container (data persists in volumes)
-docker stop a0-instance
-docker rm a0-instance
-
-# Recreate with same settings
-docker run -d   --name a0-instance   --restart unless-stopped   -p 50080:80   -v /opt/a0-instance/.env:/a0/.env   -v /opt/a0-instance/usr:/a0/usr   -v /opt/agent-zero:latest
-```
-
-### Backup Strategy
-
-```bash
-# Backup all instance data
-tar -czvf a0-backup-$(date +%Y%m%d).tar.gz /opt/a0-instance/
-
-# Key items to backup:
-# - /opt/a0-instance/.env (configuration)
-# - /opt/a0-instance/memory/ (agent memories)
-# - /opt/a0-instance/work_dir/ (working files)
-```
-
-### Monitoring
-
-```bash
-# Check container health
-docker ps --format "table {{.Names}}	{{.Status}}	{{.Ports}}"
-
-# View recent logs
-docker logs --tail 100 -f a0-instance
-
-# Resource usage
-docker stats a0-instance
-```
-
-### Docker Cleanup
-
-```bash
-# Remove unused images
-docker image prune -f
-
-# Remove all unused Docker resources
-docker system prune -f
-```
-
----
-
-## Quick Reference
-
-### Essential Commands
-
-```bash
-# Container Management
-docker start a0-instance
-docker stop a0-instance
-docker restart a0-instance
-docker logs a0-instance
-docker exec -it a0-instance bash
-
-# Apache Management  
-systemctl restart httpd    # RHEL/AlmaLinux
-systemctl restart apache2  # Debian/Ubuntu
-httpd -t                   # Test config
-
-# Quick Diagnostics
-docker ps | grep a0
-curl -I https://your-domain.com/login
-```
-
-### Standard Paths
-
-| Component | Path |
-|-----------|----- |
-| Instance Data | `/opt/a0-instance/` |
-| Environment File | `/opt/a0-instance/.env` |
-| Memory Storage | `/opt/a0-instance/memory/` |
-| Work Directory | `/opt/a0-instance/work_dir/` |
-| Apache Config (Standard) | `/etc/apache2/sites-available/` |
-| Apache Config (DirectAdmin) | `/etc/httpd/conf/extra/httpd-includes.conf` |
-| DirectAdmin SSL Certs | `/usr/local/directadmin/data/users/USER/domains/` |
-
-### Standard Ports
-
-| Port | Purpose |
-|------|---------|
-| 50080 | First A0 instance |
-| 50081 | Second A0 instance |
-| 50082 | Third A0 instance |
-| 80 | HTTP (redirect to HTTPS) |
-| 443 | HTTPS (main access) |
-
-### .env Template
-
-```bash
-# Agent Zero Configuration Template
-# Copy and customize for each instance
-
-# Authentication (REQUIRED for production)
-AUTH_LOGIN=your_username
-AUTH_PASSWORD=your_secure_password
-
-# Optional: Additional settings
-# Refer to Agent Zero documentation for all options
-```
-
----
-
-## Appendix: Multi-Instance Setup
-
-For running multiple A0 instances on the same server:
-
-```bash
-# Instance 1: a0-primary on port 50080
-mkdir -p /opt/a0-primary
-# ... create .env, run container on port 50080
-
-# Instance 2: a0-dev on port 50081  
-mkdir -p /opt/a0-dev
-# ... create .env, run container on port 50081
-
-# Instance 3: a0-backup on port 50082
-mkdir -p /opt/a0-backup
-# ... create .env, run container on port 50082
-```
-
-Each instance needs:
-- Unique container name
-- Unique host port
-- Separate data directory
-- Separate domain/subdomain
-- Separate Apache vhost config
-
----
-
-*This guide comes from successful Agent Zero deployments across DirectAdmin and standard Linux environments.*
-
-Contributed by @hurtdidit in the A0 Community.
+version https://git-lfs.github.com/spec/v1
+oid sha256:35d128f65e9196f4a7714c2eca191b2a2535049356ad8c7e9a30c60d021068b1
+size 18115

extensions/AGENTS.md

@@ -1,39 +1,3 @@
-# Extensions DOX
-
-## Purpose
-
-- Own core lifecycle extension implementations for backend and WebUI extension points.
-- Keep built-in hook behavior ordered, discoverable, and compatible with plugin extension discovery.
-
-## Ownership
-
-- `python/` contains backend lifecycle hooks executed through `helpers.extension`.
-- `webui/` contains frontend extension contributions loaded through `webui/js/extensions.js`.
-- Plugin-specific extensions belong inside each plugin's `extensions/` directory.
-
-## Local Contracts
-
-- Extension directory names are runtime extension point names.
-- File ordering matters when names include numeric prefixes.
-- Extensions must be safe to run repeatedly when the lifecycle point can fire multiple times.
-- Secret masking, auth, security, and persistence extensions must not be bypassed by convenience changes.
-
-## Work Guidance
-
-- Keep extension code small and focused on its hook point.
-- Move shared logic into `helpers/` when it is reused outside one extension.
-- Coordinate changes with plugin extension docs and tests when extension point semantics change.
-
-## Verification
-
-- Run targeted lifecycle, prompt, stream, WebSocket, or WebUI extension tests for changed hook points.
-- Smoke-test startup when changing initialization, migration, or system-prompt extensions.
-
-## Child DOX Index
-
-Direct child DOX files:
-
-| Child | Scope |
-| --- | --- |
-| [python/AGENTS.md](python/AGENTS.md) | Backend lifecycle extension hook files. |
-| [webui/AGENTS.md](webui/AGENTS.md) | Frontend extension contributions. |
+version https://git-lfs.github.com/spec/v1
+oid sha256:2fee5d7084cc2d56ea3b981a3c921e2e7944bc20a20fd8691d5caf0b94b2d7f8
+size 1537

extensions/python/AGENTS.md

@@ -1,68 +1,3 @@
-# Python Extensions DOX
-
-## Purpose
-
-- Own built-in backend lifecycle extensions under `extensions/python/`.
-- Keep Python hook behavior compatible with `helpers.extension.call_extensions_async` and `call_extensions_sync`.
-
-## Ownership
-
-- Each direct subdirectory is one named extension point.
-- Python files inside an extension point are loaded in deterministic filename order.
-- Implicit `@extensible` hook implementations use `_functions/<module>/<qualname>/<start|end>/` layout when present.
-
-## Local Contracts
-
-- Extension functions must match the arguments supplied by their hook point.
-- Preserve numeric prefixes when ordering affects prompt construction, stream masking, persistence, or cleanup.
-- Use `AgentContext` from `agent` when context access is needed.
-- Do not log unmasked secrets, raw hidden prompt sections, or private user data.
-
-## Work Guidance
-
-- Keep extension modules import-light; many hooks run during hot paths.
-- Use mutable `ctx` or `data` dictionaries according to the hook contract when rewriting content.
-- Add or update tests when a hook changes prompt content, message history, tool output, streaming, or persistence behavior.
-
-## Verification
-
-- Run targeted tests for the affected lifecycle area.
-- Run a startup smoke check for `agent_init`, `startup_migration`, or `system_prompt` changes when practical.
-
-## Child DOX Index
-
-Direct child DOX files:
-
-| Child | Scope |
-| --- | --- |
-| [_functions/AGENTS.md](_functions/AGENTS.md) | Implicit `@extensible` backend hook implementations. |
-| [agent_init/AGENTS.md](agent_init/AGENTS.md) | Agent context initialization hooks. |
-| [banners/AGENTS.md](banners/AGENTS.md) | Backend banner and discovery-card contributions. |
-| [before_main_llm_call/AGENTS.md](before_main_llm_call/AGENTS.md) | Pre-main-model-call behavior. |
-| [error_format/AGENTS.md](error_format/AGENTS.md) | Error formatting and masking behavior. |
-| [hist_add_before/AGENTS.md](hist_add_before/AGENTS.md) | Pre-history-insertion masking behavior. |
-| [hist_add_tool_result/AGENTS.md](hist_add_tool_result/AGENTS.md) | Tool-result history side effects. |
-| [job_loop/AGENTS.md](job_loop/AGENTS.md) | Periodic backend maintenance jobs. |
-| [message_loop_end/AGENTS.md](message_loop_end/AGENTS.md) | End-of-message-loop history and persistence behavior. |
-| [message_loop_result/AGENTS.md](message_loop_result/AGENTS.md) | Completed model-result normalization and default-processing interception. |
-| [message_loop_prompts_after/AGENTS.md](message_loop_prompts_after/AGENTS.md) | Prompt protocol and extras assembled around message-loop prompt construction. |
-| [message_loop_prompts_before/AGENTS.md](message_loop_prompts_before/AGENTS.md) | Pre-prompt-construction message-loop gates. |
-| [message_loop_start/AGENTS.md](message_loop_start/AGENTS.md) | Start-of-message-loop iteration state. |
-| [monologue_end/AGENTS.md](monologue_end/AGENTS.md) | End-of-monologue UI and cleanup behavior. |
-| [monologue_start/AGENTS.md](monologue_start/AGENTS.md) | Core start-of-monologue lifecycle extensions. |
-| [process_chain_end/AGENTS.md](process_chain_end/AGENTS.md) | Process-chain completion and queued-message handling. |
-| [reasoning_stream/AGENTS.md](reasoning_stream/AGENTS.md) | Full reasoning stream handling. |
-| [reasoning_stream_chunk/AGENTS.md](reasoning_stream_chunk/AGENTS.md) | Reasoning stream chunk masking. |
-| [reasoning_stream_end/AGENTS.md](reasoning_stream_end/AGENTS.md) | Reasoning stream finalization. |
-| [response_stream/AGENTS.md](response_stream/AGENTS.md) | Full assistant response stream handling. |
-| [response_stream_chunk/AGENTS.md](response_stream_chunk/AGENTS.md) | Assistant response chunk masking. |
-| [response_stream_end/AGENTS.md](response_stream_end/AGENTS.md) | Assistant response stream finalization. |
-| [startup_migration/AGENTS.md](startup_migration/AGENTS.md) | Startup migrations. |
-| [system_prompt/AGENTS.md](system_prompt/AGENTS.md) | Core system prompt section construction. |
-| [tool_execute_after/AGENTS.md](tool_execute_after/AGENTS.md) | Post-tool-execution processing. |
-| [tool_execute_before/AGENTS.md](tool_execute_before/AGENTS.md) | Pre-tool-execution processing. |
-| [user_message_ui/AGENTS.md](user_message_ui/AGENTS.md) | User-visible UI message hooks. |
-| [util_model_call_before/AGENTS.md](util_model_call_before/AGENTS.md) | Pre-utility-model-call masking. |
-| [webui_ws_connect/AGENTS.md](webui_ws_connect/AGENTS.md) | WebUI WebSocket connect behavior. |
-| [webui_ws_disconnect/AGENTS.md](webui_ws_disconnect/AGENTS.md) | WebUI WebSocket disconnect behavior. |
-| [webui_ws_event/AGENTS.md](webui_ws_event/AGENTS.md) | Incoming WebUI WebSocket event behavior. |
+version https://git-lfs.github.com/spec/v1
+oid sha256:a60e8fc1128128aafbb5a9a5b45033ab0d21af713353e168f3008c2276b71cac
+size 4681

extensions/python/_functions/AGENTS.md

@@ -1,33 +1,3 @@
-# Python Function Extensions DOX
-
-## Purpose
-
-- Own implicit `@extensible` backend hook implementations.
-- Preserve nested module, class/function, method, and `start`/`end` extension layout.
-
-## Ownership
-
-- Each nested path mirrors a Python module and qualname segment.
-- Leaf `start/` and `end/` directories own ordered extension files for that extensible function point.
-
-## Local Contracts
-
-- Do not flatten nested qualname paths into retired legacy folder names.
-- Extension functions must match the implicit hook's supplied arguments.
-- Preserve ordering prefixes where exception handling, watchdog registration, or cleanup depends on them.
-- Hooks that mirror persisted AI responses into UI logs must reuse existing stream log items and avoid duplicating live response-tool logs.
-- The `AgentContext.run_task/end` hook attaches integration callbacks to the returned `DeferredTask`; keep terminal side effects out of `agent.py`.
-- Recovery-loop circuit breakers must stop at the General Settings limit and render their user-visible cost warning from a core framework prompt.
-- Prompt settings snapshots must be task-local, accessed through `get_settings_for_prompt()`, and end with the matching `Agent.prepare_prompt` call, including exceptional exits.
-
-## Work Guidance
-
-- Keep implicit hook extensions narrow and colocated with the exact function point they extend.
-
-## Verification
-
-- Run targeted tests for the affected function point after changes.
-
-## Child DOX Index
-
-No child DOX files.
+version https://git-lfs.github.com/spec/v1
+oid sha256:45b0d49727663cfd9f6c3bf81431bde197789b2392924aa68bed1a8afae2c296
+size 1501

extensions/python/_functions/__main__/init_a0/end/_10_register_watchdogs.py

@@ -1,11 +1,3 @@
-from helpers.extension import Extension
-
-
-class RegisterWatchDogs(Extension):
-
-    def execute(self, **kwargs):
-        from helpers.plugins import register_watchdogs as register_plugins_watchdogs
-        from helpers.api import register_watchdogs as register_api_watchdogs
-
-        register_plugins_watchdogs()
-        register_api_watchdogs()
+version https://git-lfs.github.com/spec/v1
+oid sha256:3585ef1b3cd71ea587ba5fed1ebdc4e37be8e6517bc888d4744938bc27561cdd
+size 344

extensions/python/_functions/agent/Agent/handle_exception/end/_40_handle_intervention_exception.py

@@ -1,21 +1,3 @@
-from datetime import datetime, timezone
-from helpers.extension import Extension
-from agent import LoopData
-from helpers.localization import Localization
-from helpers.errors import InterventionException
-from helpers import errors
-from helpers.print_style import PrintStyle
-
-
-class HandleInterventionException(Extension):
-    async def execute(self, data: dict = {}, **kwargs):
-        if not self.agent:
-            return
-
-        if not data.get("exception"):
-            return
-
-        if isinstance(data["exception"], InterventionException):
-            data["exception"] = None # skip the exception and continue message loop
-
-        
+version https://git-lfs.github.com/spec/v1
+oid sha256:04ee5f0807d0d8f697979f33c0ff2ba7049a85bbad3aa6955738a3a60b0336f9
+size 640

extensions/python/_functions/agent/Agent/handle_exception/end/_50_handle_repairable_exception.py

@@ -1,25 +1,3 @@
-from datetime import datetime, timezone
-from helpers.extension import Extension
-from agent import LoopData
-from helpers.localization import Localization
-from helpers.errors import RepairableException
-from helpers import errors, extension
-from helpers.print_style import PrintStyle
-
-class HandleRepairableException(Extension):
-    async def execute(self, data: dict = {}, **kwargs):
-        if not self.agent:
-            return
-
-        if not data.get("exception"):
-            return
-
-        if isinstance(data["exception"], RepairableException):
-            msg = {"message": errors.format_error(data["exception"])}
-            await extension.call_extensions_async("error_format", agent=self.agent, msg=msg)
-            wmsg = self.agent.hist_add_warning(msg["message"])
-            PrintStyle(font_color="red", padding=True).print(msg["message"])
-            self.agent.context.log.log(type="warning", content=msg["message"], id=wmsg.id)
-            data["exception"] = None
-
-        
+version https://git-lfs.github.com/spec/v1
+oid sha256:67e15a2835ee4e4d02f7f277a32a42273f6bddad4e8b2448f3588aec2bcc54b0
+size 991

extensions/python/_functions/agent/Agent/handle_exception/end/_90_handle_critical_exception.py

@@ -1,43 +1,3 @@
-import asyncio
-
-from helpers.extension import Extension
-from helpers.print_style import PrintStyle
-from helpers import errors
-
-from helpers.errors import HandledException
-
-
-class HandleCriticalException(Extension):
-    async def execute(self, data: dict = {}, **kwargs):
-        if not self.agent:
-            return
-
-        if not (exception:= data.get("exception")):
-            return
-
-        # when exception is HandledException, keep it active, no logging here
-        if isinstance(exception, HandledException):
-            return 
-
-        # asyncio cancel - chat is being terminated, print out and re-raise as handledException
-        if isinstance(exception, asyncio.CancelledError):
-            PrintStyle(font_color="white", background_color="red", padding=True).print(
-                f"Context {self.agent.context.id} terminated during message loop"
-            )
-            data["exception"] = HandledException(exception)
-            return
-
-        # other exceptions should be logged and re-raised as HandledException
-        error_text = errors.error_text(exception)
-        error_message = errors.format_error(exception)
-
-        PrintStyle(font_color="red", padding=True).print(error_message)
-        self.agent.context.log.log(
-            type="error",
-            content=error_message,
-        )
-        PrintStyle(font_color="red", padding=True).print(
-            f"{self.agent.agent_name}: {error_text}"
-        )
-
-        data["exception"] = HandledException(exception)
+version https://git-lfs.github.com/spec/v1
+oid sha256:762c8469756a147e96d7cbed07cb0d585d296006b10475f7fbe143e6ded43b32
+size 1500

extensions/python/_functions/agent/Agent/hist_add_ai_response/end/_10_log_plain_responses.py

@@ -1,47 +1,3 @@
-from typing import Any
-
-from helpers import extract_tools
-from helpers.extension import Extension
-
-
-class LogPlainResponses(Extension):
-    def execute(self, data: dict[str, Any] | None = None, **kwargs):
-        if not self.agent or not isinstance(data, dict):
-            return
-
-        call_kwargs = data.get("kwargs")
-        if not isinstance(call_kwargs, dict):
-            call_kwargs = {}
-
-        llm_result = call_kwargs.get("llm_result")
-        if getattr(llm_result, "mode", "") != "responses":
-            return
-
-        message = call_kwargs.get("message")
-        call_args = data.get("args")
-        if message is None and isinstance(call_args, tuple) and len(call_args) > 1:
-            message = call_args[1]
-        if not isinstance(message, str) or not message:
-            return
-        if (
-            extract_tools.extract_tool_request(message) is not None
-            or extract_tools.is_misformatted_tool_request(message)
-        ):
-            return
-
-        params = getattr(getattr(self.agent, "loop_data", None), "params_temporary", None)
-        if not isinstance(params, dict) or "log_item_response" in params:
-            return
-
-        log_item = params.get("log_item_generating")
-        if log_item is None:
-            return
-
-        params["log_item_response"] = log_item
-        log_item.update(
-            type="response",
-            heading="",
-            content=message,
-            finished=True,
-            update_progress="none",
-        )
+version https://git-lfs.github.com/spec/v1
+oid sha256:cbb24ea2ec8c6acf3f4a7df4b6042464e4c3471118f865a843ca2d9f90b90950
+size 1498

extensions/python/_functions/agent/Agent/hist_add_warning/end/_90_stop_unusable_response_loop.py

@@ -1,56 +1,3 @@
-from helpers.errors import HandledException
-from helpers.extension import Extension
-from helpers.settings import get_settings
-
-
-STATE_KEY = "_unusable_response_failures"
-
-
-class StopUnusableResponseLoop(Extension):
-    def execute(self, data: dict | None = None, **kwargs):
-        if not self.agent or not isinstance(data, dict):
-            return
-
-        call_kwargs = data.get("kwargs")
-        message = call_kwargs.get("message") if isinstance(call_kwargs, dict) else None
-        call_args = data.get("args")
-        if message is None and isinstance(call_args, tuple) and len(call_args) > 1:
-            message = call_args[1]
-
-        if not isinstance(message, str):
-            return
-        if message not in {
-            self.agent.read_prompt("fw.msg_misformat.md"),
-            self.agent.read_prompt("fw.msg_repeat.md"),
-            self.agent.read_prompt("fw.msg_empty_response.md"),
-        }:
-            return
-
-        loop_data = getattr(self.agent, "loop_data", None)
-        state = getattr(loop_data, "params_persistent", None)
-        iteration = getattr(loop_data, "iteration", None)
-        if not isinstance(state, dict) or not isinstance(iteration, int):
-            return
-
-        previous = state.get(STATE_KEY, {})
-        if not isinstance(previous, dict):
-            previous = {}
-        previous_iteration = previous.get("iteration")
-        if previous_iteration == iteration:
-            return
-
-        count = (
-            previous.get("count", 0) + 1
-            if previous_iteration == iteration - 1
-            else 1
-        )
-        state[STATE_KEY] = {"iteration": iteration, "count": count}
-        limit = get_settings()["max_consecutive_unusable_responses"]
-        if count < limit:
-            return
-
-        stop_message = self.agent.read_prompt(
-            "fw.msg_unusable_response_limit.md", limit=limit
-        )
-        self.agent.context.log.log(type="warning", content=stop_message)
-        data["exception"] = HandledException(stop_message)
+version https://git-lfs.github.com/spec/v1
+oid sha256:7c138b131522d75756865ef2aebc656f12c7d16f0ce5feefc6c733a3916b1b84
+size 2012

extensions/python/_functions/agent/Agent/prepare_prompt/end/_00_restore_settings.py

@@ -1,12 +1,3 @@
-from helpers import settings
-from helpers.extension import Extension
-
-
-_TOKEN_KEY = "_prompt_settings_snapshot_token"
-
-
-class RestorePromptSettings(Extension):
-    def execute(self, data: dict | None = None, **kwargs):
-        token = data.pop(_TOKEN_KEY, None) if isinstance(data, dict) else None
-        if token is not None:
-            settings.end_prompt_settings_snapshot(token)
+version https://git-lfs.github.com/spec/v1
+oid sha256:02352e6a668d95ed2d72d77c3fe417f4ceea29a3ad7601666059c569d06e48e9
+size 385

extensions/python/_functions/agent/Agent/prepare_prompt/start/_99_snapshot_settings.py

@@ -1,11 +1,3 @@
-from helpers import settings
-from helpers.extension import Extension
-
-
-_TOKEN_KEY = "_prompt_settings_snapshot_token"
-
-
-class SnapshotPromptSettings(Extension):
-    def execute(self, data: dict | None = None, **kwargs):
-        if isinstance(data, dict):
-            data[_TOKEN_KEY] = settings.begin_prompt_settings_snapshot()
+version https://git-lfs.github.com/spec/v1
+oid sha256:8f60a19ebaf9a35b14e788a31e3fce5a7285fa9fee1228374f2b25edff31a477
+size 328

extensions/python/_functions/agent/AgentContext/run_task/end/_10_mark_state_dirty.py

@@ -1,14 +1,3 @@
-from helpers.defer import DeferredTask
-from helpers.extension import Extension
-from helpers.state_monitor_integration import mark_dirty_all
-
-
-class MarkStateDirty(Extension):
-    def execute(self, data: dict | None = None, **kwargs) -> None:
-        task = data.get("result") if isinstance(data, dict) else None
-        if isinstance(task, DeferredTask):
-            task.add_done_callback(
-                lambda _future: mark_dirty_all(
-                    reason="agent.AgentContext.run_task_done",
-                )
-            )
+version https://git-lfs.github.com/spec/v1
+oid sha256:02112c06ff56b8de8ed877895b58c0e0ed8057800e55eccf12a9e128f3878d4c
+size 534

extensions/python/agent_init/AGENTS.md

@@ -1,26 +1,3 @@
-# Agent Init Extensions DOX
-
-## Purpose
-
-- Own backend extensions that run when an agent context initializes.
-
-## Ownership
-
-- Ordered Python files own initial UI message setup and profile settings load behavior.
-
-## Local Contracts
-
-- Keep initialization idempotent for contexts that may be restored or reloaded.
-- Preserve ordering between initial message creation and profile settings loading.
-
-## Work Guidance
-
-- Coordinate changes with profile loading, settings resolution, and startup smoke checks.
-
-## Verification
-
-- Smoke-test new chat/context initialization after changes.
-
-## Child DOX Index
-
-No child DOX files.
+version https://git-lfs.github.com/spec/v1
+oid sha256:a0d9eb62f086092e47acc26b8d95af4020a180c2639da41a45f31987b76f6401
+size 625

extensions/python/agent_init/_10_initial_message.py

@@ -1,44 +1,3 @@
-import json
-from agent import LoopData
-from helpers.extension import Extension
-
-
-class InitialMessage(Extension):
-
-    def execute(self, **kwargs):
-        """
-        Add an initial greeting message when first user message is processed.
-        Called only once per session via _process_chain method.
-        """
-        if not self.agent:
-            return
-
-        # Only add initial message for main agent (A0), not subordinate agents
-        if self.agent.number != 0:
-            return
-
-        # If the context already contains log messages, do not add another initial message
-        if self.agent.context.log.logs:
-            return
-
-        # Construct the initial message from prompt template
-        initial_message = self.agent.read_prompt("fw.initial_message.md")
-
-        # add initial loop data to agent (for hist_add_ai_response)
-        self.agent.loop_data = LoopData(user_message=None)
-
-        # Add the message to history as an AI response
-        msg = self.agent.hist_add_ai_response(initial_message)
-
-        # json parse the message, get the tool_args text
-        initial_message_json = json.loads(initial_message)
-        initial_message_text = initial_message_json.get("tool_args", {}).get("text", "Hello! How can I help you?")
-
-        # Add to log (green bubble) for immediate UI display
-        self.agent.context.log.log(
-            type="response",
-            content=initial_message_text,
-            finished=True,
-            update_progress="none",
-            id=msg.id,
-        )
+version https://git-lfs.github.com/spec/v1
+oid sha256:a600f43500b56a633d3dd0f8eec64e84fd32bfc6a43b55657652c8dc24ccc7a4
+size 1525

extensions/python/agent_init/_15_load_profile_settings.py

@@ -1,53 +1,3 @@
-from initialize import initialize_agent
-from helpers import dirty_json, files, subagents, projects
-from helpers.extension import Extension
-
-
-class LoadProfileSettings(Extension):
-    
-    def execute(self, **kwargs) -> None:
-
-        if not self.agent or not self.agent.config.profile:
-            return
-
-        config_files = subagents.get_paths(self.agent, "settings.json", include_default=False, include_user=False)
-        settings_override = {}
-        for settings_path in config_files:
-            if files.exists(settings_path):
-                try:
-                    override_settings_str = files.read_file(settings_path)
-                    override_settings = dirty_json.try_parse(override_settings_str)
-                    if isinstance(override_settings, dict):
-                        settings_override.update(override_settings)
-                    else:
-                        raise Exception(
-                            f"Subordinate settings in {settings_path} must be a JSON object."
-                        )
-                except Exception as e:
-                    self.agent.context.log.log(
-                        type="error",
-                        content=(
-                            f"Error loading subordinate settings from {settings_path} for "
-                            f"profile '{self.agent.config.profile}': {e}"
-                        ),
-                    )
-
-        if settings_override:
-            current_config = self.agent.config
-            new_config = initialize_agent(override_settings=settings_override)
-
-            for override_key, config_attr in (
-                ("agent_profile", "profile"),
-                ("mcp_servers", "mcp_servers"),
-            ):
-                if override_key not in settings_override:
-                    setattr(new_config, config_attr, getattr(current_config, config_attr))
-            self.agent.config = new_config
-            # self.agent.context.log.log(
-            #     type="info",
-            #     content=(
-            #         "Loaded custom settings for agent "
-            #         f"{self.agent.number} with profile '{self.agent.config.profile}'."
-            #     ),
-            # )
-
+version https://git-lfs.github.com/spec/v1
+oid sha256:661afc11f43f87eb7afcb2cef1690856bb298bde0e99945739fdc4132722d734
+size 2200

extensions/python/banners/AGENTS.md

@@ -1,28 +1,3 @@
-# Banner Extensions DOX
-
-## Purpose
-
-- Own backend banner and discovery-card contributions.
-
-## Ownership
-
-- Ordered Python files append alert banners or discovery cards to the mutable `banners` list.
-
-## Local Contracts
-
-- Banner IDs must be unique and stable.
-- Use supported banner/card fields and types only.
-- Banner HTML links that trigger WebUI behavior should use supported structured actions, such as `data-banner-action`, instead of inline JavaScript handlers.
-- Do not expose secrets, local paths, or raw system diagnostics in banner text.
-
-## Work Guidance
-
-- Gate setup or warning banners on current configuration/status where possible.
-
-## Verification
-
-- Smoke-test welcome-screen banner rendering, ordering, dismissal, and CTA behavior after changes.
-
-## Child DOX Index
-
-No child DOX files.
+version https://git-lfs.github.com/spec/v1
+oid sha256:9384eec1a33ca8900836671c77730e4c3e7ef573abe31700150c8f7b6e2950ff
+size 808

extensions/python/banners/_10_unsecured_connection.py

@@ -1,63 +1,3 @@
-from helpers.extension import Extension
-from helpers import dotenv
-import re
-
-
-class UnsecuredConnectionCheck(Extension):
-    """Check: non-local without credentials, or credentials over non-HTTPS."""
-
-    async def execute(self, banners: list = [], frontend_context: dict = {}, **kwargs):
-        hostname = frontend_context.get("hostname", "")
-        protocol = frontend_context.get("protocol", "")
-        
-        auth_login = dotenv.get_dotenv_value(dotenv.KEY_AUTH_LOGIN, "")
-        auth_password = dotenv.get_dotenv_value(dotenv.KEY_AUTH_PASSWORD, "")
-        has_credentials = bool(auth_login and auth_login.strip() and auth_password and auth_password.strip())
-        
-        is_local = self._is_localhost(hostname)
-        is_https = protocol == "https:"
-        
-        if not is_local and not has_credentials:
-            banners.append({
-                "id": "unsecured-connection",
-                "type": "warning",
-                "priority": 80,
-                "title": "Unsecured Connection",
-                "html": """You are accessing Agent Zero from a non-local address without authentication. 
-                         <a href="#section-auth" data-banner-action="open-modal:settings/settings.html#section-auth">
-                         Configure credentials</a> in Settings → External Services → Authentication.""",
-                "dismissible": True,
-                "source": "backend"
-            })
-        
-        if has_credentials and not is_local and not is_https:
-            banners.append({
-                "id": "credentials-unencrypted",
-                "type": "warning", 
-                "priority": 90,
-                "title": "Credentials May Be Sent Unencrypted",
-                "html": """Your connection is not using HTTPS. Login credentials may be transmitted in plain text. 
-                         Consider using HTTPS or a secure tunnel.""",
-                "dismissible": True,
-                "source": "backend"
-            })
-
-    def _is_localhost(self, hostname: str) -> bool:
-        local_patterns = ["localhost", "127.0.0.1", "::1", "0.0.0.0"]
-        
-        if hostname in local_patterns:
-            return True
-        
-        # RFC1918 private ranges
-        if re.match(r"^192\.168\.\d{1,3}\.\d{1,3}$", hostname):
-            return True
-        if re.match(r"^10\.\d{1,3}\.\d{1,3}\.\d{1,3}$", hostname):
-            return True
-        if re.match(r"^172\.(1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3}$", hostname):
-            return True
-        
-        # .local domains
-        if hostname.endswith(".local"):
-            return True
-        
-        return False
+version https://git-lfs.github.com/spec/v1
+oid sha256:6a8d4f8ed25d1e17d786ae5ea6b1f1d6d29f2b80bc8cce4d4bb4807c5d56c623
+size 2640

extensions/python/banners/_30_system_resources.py

@@ -1,151 +1,3 @@
-from helpers.extension import Extension
-import os
-import psutil
-
-
-class SystemResourcesCheck(Extension):
-    async def execute(self, banners: list = [], frontend_context: dict = {}, **kwargs):
-        try:
-            cpu_percent = psutil.cpu_percent(interval=0.1)
-        except Exception:
-            cpu_percent = None
-
-        try:
-            cpu_cores = psutil.cpu_count(logical=True)
-        except Exception:
-            cpu_cores = None
-
-        load_avg = self._get_load_average()
-
-        try:
-            vm = psutil.virtual_memory()
-            ram_percent = vm.percent
-            ram_used_gb = (vm.total - vm.available) / (1024 ** 3)
-            ram_total_gb = vm.total / (1024 ** 3)
-        except Exception:
-            ram_percent = None
-
-            ram_used_gb = None
-            ram_total_gb = None
-
-        disk_percent, disk_used_gb, disk_total_gb, disk_path = self._get_disk_usage()
-
-        try:
-            net = psutil.net_io_counters()
-            net_sent = self._format_bytes(net.bytes_sent)
-            net_recv = self._format_bytes(net.bytes_recv)
-        except Exception:
-            net_sent = "N/A"
-            net_recv = "N/A"
-
-        load_value = "N/A"
-        if load_avg:
-            la1, la5, la15 = load_avg
-            load_value = f"{la1:.2f} / {la5:.2f} / {la15:.2f}"
-
-        if disk_percent is None or disk_used_gb is None or disk_total_gb is None:
-            disk_value = "N/A"
-        else:
-            disk_value = f"{disk_used_gb:.2f}/{disk_total_gb:.2f} GB"
-
-        if cpu_percent is None:
-            cpu_value = "N/A"
-        else:
-            cores_value = "" if cpu_cores is None else f" ({cpu_cores} cores)"
-            cpu_value = f"{cpu_percent:.0f}%{cores_value}"
-
-        if ram_percent is None or ram_used_gb is None or ram_total_gb is None:
-            ram_value = "N/A"
-        else:
-            ram_value = f"{ram_used_gb:.2f}/{ram_total_gb:.2f} GB"
-
-        cpu_bar = self._bar_html(cpu_percent)
-        ram_bar = self._bar_html(ram_percent)
-        disk_bar = self._bar_html(disk_percent)
-
-        banners.append({
-            "id": "system-resources",
-            "type": "info",
-            "priority": 10,
-            "title": "System Resources",
-            "html": (
-                "<div class=\"system-resource-body\">"
-                "<div class=\"system-resource-meter\">"
-                "<div class=\"system-resource-label\">"
-                "<div class=\"system-resource-name\">CPU</div>"
-                f"<div class=\"system-resource-value\">{cpu_value}</div>"
-                "</div>"
-                f"{cpu_bar}"
-                "</div>"
-                "<div class=\"system-resource-meter\">"
-                "<div class=\"system-resource-label\">"
-                "<div class=\"system-resource-name\">RAM</div>"
-                f"<div class=\"system-resource-value\">{ram_value}</div>"
-                "</div>"
-                f"{ram_bar}"
-                "</div>"
-                "<div class=\"system-resource-meter\">"
-                "<div class=\"system-resource-label\">"
-                "<div class=\"system-resource-name\">Disk</div>"
-                f"<div class=\"system-resource-value\">{disk_value}</div>"
-                "</div>"
-                f"{disk_bar}"
-                "</div>"
-                "<div class=\"system-resource-footer\">"
-                "<div class=\"system-resource-detail\">"
-                "<div class=\"system-resource-detail-title\">Load (1/5/15)</div>"
-                f"<div class=\"system-resource-detail-value\">{load_value}</div>"
-                "</div>"
-                "<div class=\"system-resource-detail\">"
-                "<div class=\"system-resource-detail-title\">Net (since boot)</div>"
-                f"<div class=\"system-resource-detail-value\">{net_sent} sent / {net_recv} recv</div>"
-                "</div>"
-                "</div>"
-                "</div>"
-            ),
-            "dismissible": True,
-            "source": "backend",
-        })
-
-    def _bar_html(self, percent: float | None) -> str:
-        if percent is None:
-            return ""
-
-        p = max(0.0, min(100.0, float(percent)))
-        if p >= 85:
-            color = "#ef4444"
-        elif p >= 70:
-            color = "#f59e0b"
-        else:
-            color = "#22c55e"
-
-        return (
-            "<div class=\"system-resource-track\">"
-            f"<span class=\"system-resource-fill\" style=\"--resource-value:{p:.0f}%;--resource-color:{color};\"></span>"
-            "</div>"
-        )
-
-    def _get_load_average(self) -> tuple[float, float, float] | None:
-        try:
-            return os.getloadavg()
-        except Exception:
-            return None
-
-    def _get_disk_usage(self) -> tuple[float | None, float | None, float | None, str]:
-        for path in ["/", os.path.expanduser("~")]:
-            try:
-                usage = psutil.disk_usage(path)
-                used_gb = usage.used / (1024 ** 3)
-                total_gb = usage.total / (1024 ** 3)
-                return usage.percent, used_gb, total_gb, path
-            except Exception:
-                continue
-        return None, None, None, "/"
-
-    def _format_bytes(self, value: int) -> str:
-        size = float(value)
-        for unit in ["B", "KB", "MB", "GB", "TB", "PB"]:
-            if size < 1024:
-                return f"{size:.1f} {unit}"
-            size /= 1024
-        return f"{size:.1f} EB"
+version https://git-lfs.github.com/spec/v1
+oid sha256:c25cebb701f5ee4166d857d7bd34ea1d149507108691cd94cc78c553a606ec3d
+size 5422

extensions/python/before_main_llm_call/AGENTS.md

@@ -1,26 +1,3 @@
-# Before Main LLM Call Extensions DOX
-
-## Purpose
-
-- Own backend behavior that runs immediately before the main LLM call.
-
-## Ownership
-
-- Ordered Python files own pre-call logging or context preparation for streaming/model execution.
-
-## Local Contracts
-
-- Do not mutate prompt or history data unless the hook contract explicitly passes mutable state for that purpose.
-- Avoid logging secrets, hidden prompt sections, or private user data.
-
-## Work Guidance
-
-- Keep this hook light because it sits on the main model hot path.
-
-## Verification
-
-- Run targeted model-call or streaming tests after behavior changes.
-
-## Child DOX Index
-
-No child DOX files.
+version https://git-lfs.github.com/spec/v1
+oid sha256:9a6e854a5cf0d094abc2bc4da91833b82b0301d173ddff8537b16b341a60a868
+size 655

extensions/python/before_main_llm_call/_10_log_for_stream.py

@@ -1,33 +1,3 @@
-from helpers import persist_chat, tokens
-from helpers.extension import Extension
-from agent import LoopData
-import asyncio
-from helpers.log import LogItem
-from helpers import log
-import math
-import uuid
-
-
-class LogForStream(Extension):
-
-    async def execute(self, loop_data: LoopData = LoopData(), text: str = "", **kwargs):
-        if not self.agent:
-            return
-        
-        # create log message and store it in loop data temporary params
-        if "log_item_generating" not in loop_data.params_temporary:
-            loop_data.params_temporary["log_item_generating"] = (
-                self.agent.context.log.log(
-                    type="agent",
-                    heading=build_default_heading(self.agent),
-                    id=str(uuid.uuid4()),
-                )
-            )
-
-def build_heading(agent, text: str, icon: str = "network_intelligence"):
-    # Include agent identifier for all agents (A0:, A1:, A2:, etc.)
-    agent_prefix = f"{agent.agent_name}: "
-    return f"{agent_prefix}{text}"
-
-def build_default_heading(agent):
-    return build_heading(agent, "Calling LLM...") 
+version https://git-lfs.github.com/spec/v1
+oid sha256:39f2b897c81318b9f399bd96aa5883bfa866bee8857a62cdd69061aacfed94ac
+size 1107

extensions/python/error_format/AGENTS.md

@@ -1,26 +1,3 @@
-# Error Format Extensions DOX
-
-## Purpose
-
-- Own backend error formatting and masking before errors are shown or logged.
-
-## Ownership
-
-- Ordered Python files own mutation of error-format data passed by the hook.
-
-## Local Contracts
-
-- Preserve secret masking and safe user-facing error messages.
-- Do not expose raw tokens, credentials, hidden prompts, or private payloads.
-
-## Work Guidance
-
-- Keep masking rules conservative and synchronized with tool/model error surfaces.
-
-## Verification
-
-- Test or inspect representative masked and unmasked error paths after changes.
-
-## Child DOX Index
-
-No child DOX files.
+version https://git-lfs.github.com/spec/v1
+oid sha256:9b7b73348ce16977cdbdcb128c99408b750a985698adf49d8c4a8c2976c2b059
+size 616

extensions/python/error_format/_10_mask_errors.py

@@ -1,20 +1,3 @@
-from helpers.extension import Extension
-from helpers.secrets import get_secrets_manager
-
-
-class MaskErrorSecrets(Extension):
-
-    async def execute(self, **kwargs):
-        if not self.agent:
-            return
-        
-        # Get error data from kwargs
-        msg = kwargs.get("msg")
-        if not msg:
-            return
-
-        secrets_mgr = get_secrets_manager(self.agent.context)
-
-        # Mask the error message
-        if "message" in msg:
-            msg["message"] = secrets_mgr.mask_values(msg["message"])
+version https://git-lfs.github.com/spec/v1
+oid sha256:30811f67fa20158348d9bd71dc8ad3c11c5562330e090d9fcae9ef2e34d9dd18
+size 523

extensions/python/hist_add_before/AGENTS.md

@@ -1,26 +1,3 @@
-# History Add Before Extensions DOX
-
-## Purpose
-
-- Own preprocessing before messages are added to agent history.
-
-## Ownership
-
-- Ordered Python files own history content masking before persistence or model reuse.
-
-## Local Contracts
-
-- Preserve secret and sensitive-content masking before history storage.
-- Do not remove fields required by downstream history organization or replay.
-
-## Work Guidance
-
-- Coordinate history mutation changes with message persistence and plugin-owned history consumers.
-
-## Verification
-
-- Test message history insertion for masked content after changes.
-
-## Child DOX Index
-
-No child DOX files.
+version https://git-lfs.github.com/spec/v1
+oid sha256:5857c34d73e867c3034d4a2edad9d2e054469e9b2a81b5ee843fcd8ee8547e23
+size 629

extensions/python/hist_add_before/_10_mask_content.py

@@ -1,35 +1,3 @@
-from helpers.extension import Extension
-from helpers.secrets import get_secrets_manager
-
-
-class MaskHistoryContent(Extension):
-
-    def execute(self, **kwargs):
-        if not self.agent:
-            return
-
-        # Get content data from kwargs
-        content_data = kwargs.get("content_data")
-        if not content_data:
-            return
-
-        try:
-            secrets_mgr = get_secrets_manager(self.agent.context)
-
-            # Mask the content before adding to history
-            content_data["content"] = self._mask_content(content_data["content"], secrets_mgr)
-        except Exception as e:
-            # If masking fails, proceed without masking
-            pass
-
-    def _mask_content(self, content, secrets_mgr):
-        """Recursively mask secrets in message content."""
-        if isinstance(content, str):
-            return secrets_mgr.mask_values(content)
-        elif isinstance(content, list):
-            return [self._mask_content(item, secrets_mgr) for item in content]
-        elif isinstance(content, dict):
-            return {k: self._mask_content(v, secrets_mgr) for k, v in content.items()}
-        else:
-            # For other types, return as-is
-            return content
+version https://git-lfs.github.com/spec/v1
+oid sha256:eb613a29492b4e9fa9b238de709d3fcee747b7ab6dee78e7871b0371dafb3f41
+size 1212

extensions/python/hist_add_tool_result/AGENTS.md

@@ -1,27 +1,3 @@
-# History Tool Result Extensions DOX
-
-## Purpose
-
-- Own processing after tool results are added to history.
-
-## Ownership
-
-- Ordered Python files own tool-call file persistence and related history side effects.
-
-## Local Contracts
-
-- Preserve tool result traceability without leaking secrets.
-- Keep file artifacts inside expected runtime/user-owned paths.
-- Skip BACKGROUND contexts; background workers must remain ephemeral and must not create chat message files.
-
-## Work Guidance
-
-- Coordinate changes with tool output storage and chat persistence behavior.
-
-## Verification
-
-- Smoke-test a tool call that produces persisted output after changes.
-
-## Child DOX Index
-
-No child DOX files.
+version https://git-lfs.github.com/spec/v1
+oid sha256:b7fa7f5240203dec28a2b603a075b29bcbdaeecaf77450cb1dcf5f410577ffc7
+size 692

extensions/python/hist_add_tool_result/_90_save_tool_call_file.py

@@ -1,44 +1,3 @@
-from typing import Any
-from agent import AgentContextType
-from helpers.extension import Extension
-from helpers import files, persist_chat
-import os, re
-
-LEN_MIN = 500
-
-class SaveToolCallFile(Extension):
-    def execute(self, data: dict[str, Any] | None = None, **kwargs):
-        if not self.agent:
-            return
-
-        if self.agent.context.type == AgentContextType.BACKGROUND:
-            return
-            
-        if not data:
-            return
-
-        # get tool call result
-        result = data.get("tool_result") if isinstance(data, dict) else None
-        if result is None:
-            return
-
-        # skip short results
-        if len(str(result)) < LEN_MIN:
-            return
-
-        # message files directory
-        msgs_folder = persist_chat.get_chat_msg_files_folder(self.agent.context.id)
-        os.makedirs(msgs_folder, exist_ok=True)
-
-        # count the files in the directory
-        last_num = len(os.listdir(msgs_folder))
-
-        # create new file
-        new_file = files.get_abs_path(msgs_folder, f"{last_num+1}.txt")
-        files.write_file(
-            new_file,
-            result,
-        )
-
-        # add the path to the history
-        data["file"] = new_file
+version https://git-lfs.github.com/spec/v1
+oid sha256:8dd610d93ebf73e70c78f2eb476b1c766dae1ecf330f4597b894064a21e03874
+size 1208

extensions/python/job_loop/AGENTS.md

@@ -1,26 +1,3 @@
-# Job Loop Extensions DOX
-
-## Purpose
-
-- Own periodic backend maintenance jobs.
-
-## Ownership
-
-- Ordered Python files own cleanup of expired API chats, cache trimming, and future job-loop tasks.
-
-## Local Contracts
-
-- Jobs must be idempotent and safe to run repeatedly.
-- Keep cleanup scoped to owned caches, temporary contexts, or documented runtime state.
-
-## Work Guidance
-
-- Avoid expensive work on every loop; use timestamps or thresholds when practical.
-
-## Verification
-
-- Run targeted cleanup/cache tests or smoke-test job-loop startup after changes.
-
-## Child DOX Index
-
-No child DOX files.
+version https://git-lfs.github.com/spec/v1
+oid sha256:a6af0f3ca610f74f000248f7483e06b217b803155116f24fd818137c87ae8eb4
+size 600

extensions/python/job_loop/_20_cleanup_expired_api_chats.py

@@ -1,63 +1,3 @@
-from datetime import datetime, timedelta, timezone
-from typing import Any
-
-from agent import AgentContext
-from helpers import persist_chat
-from helpers.extension import Extension
-from helpers.print_style import PrintStyle
-from helpers.state_monitor_integration import mark_dirty_all
-
-
-CHECK_INTERVAL = timedelta(hours=1)
-LIFETIME_KEY = "lifetime_hours"
-
-
-class CleanupExpiredApiChats(Extension):
-    _last_check: datetime | None = None
-
-    async def execute(self, data: dict[str, Any] | None = None, **kwargs):
-        now = datetime.now(timezone.utc)
-        if type(self)._last_check and now - type(self)._last_check < CHECK_INTERVAL:
-            return
-        type(self)._last_check = now
-
-        removed = 0
-        for context in list(AgentContext.all()):
-            lifetime_hours = context.get_data(LIFETIME_KEY)
-            if lifetime_hours is None:
-                continue
-
-            try:
-                lifetime = timedelta(hours=float(lifetime_hours))
-            except (TypeError, ValueError):
-                PrintStyle.error(
-                    f"Invalid chat lifetime for {context.id}: {lifetime_hours}"
-                )
-                continue
-
-            if lifetime <= timedelta(0) or context.is_running():
-                continue
-
-            last_message = _as_utc(context.last_message)
-            if now - last_message <= lifetime:
-                continue
-
-            try:
-                context.reset()
-                AgentContext.remove(context.id)
-                persist_chat.remove_chat(context.id)
-                removed += 1
-                PrintStyle().print(f"Cleaned up expired API chat: {context.id}")
-            except Exception as e:
-                PrintStyle.error(f"Failed to cleanup expired API chat {context.id}: {e}")
-
-        if removed:
-            mark_dirty_all(reason="job_loop.CleanupExpiredApiChats")
-
-
-def _as_utc(value: datetime | None) -> datetime:
-    if value is None:
-        return datetime.fromtimestamp(0, timezone.utc)
-    if value.tzinfo is None:
-        return value.replace(tzinfo=timezone.utc)
-    return value.astimezone(timezone.utc)
+version https://git-lfs.github.com/spec/v1
+oid sha256:77ff57423672bedcbdf501f27cbcb7816192e088e2e98893be9c76ae819e67a9
+size 2119

extensions/python/job_loop/_50_trim_cache.py

@@ -1,9 +1,3 @@
-from typing import Any
-from helpers.extension import Extension
-from helpers import cache
-
-
-class SaveToolCallFile(Extension):
-    def execute(self, data: dict[str, Any] | None = None, **kwargs):
-        # trim unused cache entries
-        cache.trim_cache("*", seconds=300)
+version https://git-lfs.github.com/spec/v1
+oid sha256:a5b536371abc86345790f9014baa645fc7d33fcd0a1062dc0fc27c56b7948587
+size 274

extensions/python/message_loop_end/AGENTS.md

@@ -1,27 +1,3 @@
-# Message Loop End Extensions DOX
-
-## Purpose
-
-- Own backend behavior that runs after a message loop completes.
-
-## Ownership
-
-- Ordered Python files own history organization and chat persistence at loop end.
-
-## Local Contracts
-
-- Preserve history consistency before saving chats.
-- Do not skip persistence for successful loops unless the hook contract explicitly permits it.
-- History compression that rewrites local history must clear the active Responses provider continuation while preserving stored response IDs for cleanup.
-
-## Work Guidance
-
-- Coordinate changes with chat serialization, history organization, and WebUI refresh behavior.
-
-## Verification
-
-- Smoke-test sending a message, reloading the chat, and checking persisted history after changes.
-
-## Child DOX Index
-
-No child DOX files.
+version https://git-lfs.github.com/spec/v1
+oid sha256:aad03752d410b9e80eef91fa1e1b5a45b7907f2085001f6591e47878495d6f5c
+size 803

extensions/python/message_loop_end/_10_organize_history.py

@@ -1,30 +1,3 @@
-from helpers.extension import Extension
-from agent import LoopData
-from helpers.defer import DeferredTask, THREAD_BACKGROUND
-from helpers.history import clear_responses_provider_state
-
-DATA_NAME_TASK = "_organize_history_task"
-
-
-async def compress_history(agent) -> bool:
-    compressed = bool(await agent.history.compress())
-    if compressed:
-        clear_responses_provider_state(agent)
-    return compressed
-
-
-class OrganizeHistory(Extension):
-    async def execute(self, loop_data: LoopData = LoopData(), **kwargs):
-        if not self.agent:
-            return
-
-        # is there a running task? if yes, skip this round, the wait extension will double check the context size
-        task: DeferredTask|None = self.agent.get_data(DATA_NAME_TASK)
-        if task and not task.is_ready():
-            return
-
-        # start task
-        task = DeferredTask(thread_name=THREAD_BACKGROUND)
-        task.start_task(compress_history, self.agent)
-        # set to agent to be able to wait for it
-        self.agent.set_data(DATA_NAME_TASK, task)
+version https://git-lfs.github.com/spec/v1
+oid sha256:70998648652bb1192f47f3bc4a4907a1b7860045bf6f76dbf075841cea0394bb
+size 1047

extensions/python/message_loop_end/_90_save_chat.py

@@ -1,15 +1,3 @@
-from helpers.extension import Extension
-from agent import LoopData, AgentContextType
-from helpers import persist_chat
-
-
-class SaveChat(Extension):
-    async def execute(self, loop_data: LoopData = LoopData(), **kwargs):
-        if not self.agent:
-            return
-
-        # Skip saving BACKGROUND contexts as they should be ephemeral
-        if self.agent.context.type == AgentContextType.BACKGROUND:
-            return
-
-        persist_chat.save_tmp_chat(self.agent.context)
+version https://git-lfs.github.com/spec/v1
+oid sha256:8f2efeb0b9ddafa494eb58cdc1f649eb2edf9f0ae7c16d8f58d6cb95d6bc87ab
+size 479

extensions/python/message_loop_prompts_after/AGENTS.md

@@ -1,33 +1,3 @@
-# Message Loop Prompts After Extensions DOX
-
-## Purpose
-
-- Own prompt protocol, prompt extras, and history reattachment around primary message-loop prompt construction.
-
-## Ownership
-
-- Ordered Python files own current datetime, relevant-skill hints, loaded-skill history reattachment, agent info, parallel job status, and workdir extras injection.
-- Explicitly loaded skill bodies belong in tool-result history with metadata so they can survive persistence and be reattached after compaction.
-- Explicitly loaded skill IDs are chat-wide context data, not agent-local state.
-- Skills must not write selected or loaded skill bodies into protocol or extras.
-
-## Local Contracts
-
-- Keep injected content bounded and clearly attributed.
-- Preserve ordering where later prompt extras depend on earlier recall or load results.
-- Do not expose secrets or private files from workdir extras.
-- Relevant-skill recall should search the raw user message when available, not the rendered history wrapper.
-- Relevant-skill hints must not advertise loading when profile policy blocks
-  `skills_tool`.
-
-## Work Guidance
-
-- Coordinate prompt protocol, history-reattachment, and prompt-extra changes with skill, workdir, and profile contracts.
-
-## Verification
-
-- Inspect rendered prompt protocol/history/extras or run prompt-construction tests after changes.
-
-## Child DOX Index
-
-No child DOX files.
+version https://git-lfs.github.com/spec/v1
+oid sha256:42e777c4abc98d45ef762257a7bd55f079df91a7b6dc1ef1bffbfc72b288cf4d
+size 1383

extensions/python/message_loop_prompts_after/_60_include_current_datetime.py

@@ -1,19 +1,3 @@
-from helpers.extension import Extension
-from agent import LoopData
-from helpers.localization import Localization
-
-
-class IncludeCurrentDatetime(Extension):
-    async def execute(self, loop_data: LoopData = LoopData(), **kwargs):
-        if not self.agent:
-            return
-
-        current_datetime = Localization.get().now().strftime("%Y-%m-%d %H:%M:%S %Z")
-
-        # read prompt
-        datetime_prompt = self.agent.read_prompt(
-            "agent.system.datetime.md", date_time=current_datetime
-        )
-
-        # add current datetime to the loop data
-        loop_data.extras_temporary["current_datetime"] = datetime_prompt
+version https://git-lfs.github.com/spec/v1
+oid sha256:6737327bbd60eb39b4cf9d581c243a472cba4f69e2abe6bb42f207970d3f601e
+size 633

extensions/python/message_loop_prompts_after/_63_recall_relevant_skills.py

@@ -1,45 +1,3 @@
-from agent import LoopData
-from helpers.extension import Extension
-from helpers import skills as skills_helper, tool_policy
-
-
-class RecallRelevantSkills(Extension):
-    async def execute(self, loop_data: LoopData = LoopData(), **kwargs):
-        if not self.agent or loop_data.iteration != 0:
-            return
-        if not tool_policy.resolve_tool(self.agent, "skills_tool").allowed:
-            return
-
-        content = loop_data.user_message.content if loop_data.user_message else ""
-        if isinstance(content, dict):
-            user_instruction = str(content.get("user_message") or "").strip()
-        else:
-            user_instruction = (
-                loop_data.user_message.output_text() if loop_data.user_message else ""
-            ).strip()
-        if len(user_instruction) < 8:
-            return
-
-        matches = skills_helper.search_skills(
-            user_instruction,
-            limit=6,
-            agent=self.agent,
-        )
-        if not matches:
-            return
-
-        lines: list[str] = []
-        for skill in matches:
-            name = skill.name.strip().replace("\n", " ")[:100]
-            desc = (skill.description or "").replace("\n", " ").strip()
-            if len(desc) > 220:
-                desc = desc[:220].rstrip() + "…"
-            lines.append(f"- {name}: {desc}")
-
-        if not lines:
-            return
-
-        loop_data.extras_temporary["relevant_skills"] = self.agent.read_prompt(
-            "agent.system.skills.relevant.md",
-            skills="\n".join(lines),
-        )
+version https://git-lfs.github.com/spec/v1
+oid sha256:130e5e731e029d363cf3cf361b33613c846a40627a81fb0eb2967c568fff24ea
+size 1544

extensions/python/message_loop_prompts_after/_65_include_loaded_skills.py

@@ -1,78 +1,3 @@
-from helpers.extension import Extension
-from helpers import skills, tokens
-from agent import LoopData
-
-
-SKILL_REATTACHMENT_TOKEN_BUDGET = 12_000
-SKILL_REATTACHMENT_HEADER = (
-    "Reattached loaded skill instructions after history compaction."
-)
-
-
-class IncludeLoadedSkills(Extension):
-    async def execute(self, loop_data: LoopData = LoopData(), **kwargs):
-        if not self.agent:
-            return
-
-        skill_names = skills.get_loaded_skill_names(self.agent)
-        if not skill_names:
-            return
-
-        # Loaded skill bodies live in tool-result history. This hook only keeps
-        # the ledger clean and restores bodies that compaction hid.
-        visible_skill_names = []
-        loaded_skills = []
-        for skill_name in skill_names:
-            skill = skills.find_skill(skill_name, agent=self.agent)
-            if not skill:
-                continue
-            visible_skill_names.append(skill.name)
-            loaded_skills.append(skill)
-        skills.set_loaded_skill_names(self.agent, visible_skill_names)
-
-        self._reattach_missing_skill_bodies(loop_data, loaded_skills)
-
-    def _reattach_missing_skill_bodies(self, loop_data: LoopData, loaded_skills):
-        if not self.agent or not loaded_skills:
-            return
-
-        visible_skill_names = _visible_skill_names(loop_data.history_output)
-        selected = []
-        used_tokens = 0
-
-        for skill in reversed(loaded_skills):
-            if skill.name in visible_skill_names:
-                continue
-
-            skill_data = skills.load_skill_for_agent(
-                skill_name=skill.name,
-                agent=self.agent,
-            )
-            message = f"{SKILL_REATTACHMENT_HEADER}\n\n{skill_data}"
-            message_tokens = tokens.approximate_tokens(message)
-            if used_tokens + message_tokens > SKILL_REATTACHMENT_TOKEN_BUDGET:
-                continue
-
-            selected.append((skill, message))
-            used_tokens += message_tokens
-
-        for skill, message in reversed(selected):
-            history_message = self.agent.hist_add_tool_result(
-                "skills_tool",
-                message,
-                skill_instructions={
-                    "name": skill.name,
-                    "path": str(skill.path),
-                    "source": "skills_tool:reattach",
-                    "content_included": True,
-                },
-            )
-            loop_data.history_output.extend(history_message.output())
-
-
-def _visible_skill_names(history_output) -> set[str]:
-    return {
-        name
-        for message in history_output or []
-        if (name := skills.skill_instruction_name(message))
-    }
+version https://git-lfs.github.com/spec/v1
+oid sha256:3d911949e4103bf7d9a756a85517d4cca75aeab223d8f57956244fdf110a1cd3
+size 2668

extensions/python/message_loop_prompts_after/_70_include_agent_info.py

@@ -1,27 +1,3 @@
-from helpers.extension import Extension
-from agent import LoopData
-
-
-class IncludeAgentInfo(Extension):
-    async def execute(self, loop_data: LoopData = LoopData(), **kwargs):
-        if not self.agent:
-            return
-
-        # read prompt
-        from plugins._model_config.helpers.model_config import (
-            get_chat_model_config,
-            get_effective_preset_name,
-        )
-        chat_cfg = get_chat_model_config(self.agent)
-        preset_name = get_effective_preset_name(self.agent)
-
-        agent_info_prompt = self.agent.read_prompt(
-            "agent.extras.agent_info.md",
-            number=self.agent.number,
-            profile=self.agent.config.profile or "Default",
-            llm=chat_cfg.get("provider", "") + "/" + chat_cfg.get("name", ""),
-            preset=preset_name,
-        )
-
-        # add agent info to the prompt
-        loop_data.extras_temporary["agent_info"] = agent_info_prompt
+version https://git-lfs.github.com/spec/v1
+oid sha256:c10a045b764ddc51c2f00ba3e7a9cc702fd8acd3b31f3b7942707eeea1c432e9
+size 931

extensions/python/message_loop_prompts_after/_72_include_parallel_jobs.py

@@ -1,13 +1,3 @@
-from helpers.extension import Extension
-from agent import LoopData
-from helpers import parallel_tools
-
-
-class IncludeParallelJobs(Extension):
-    async def execute(self, loop_data: LoopData = LoopData(), **kwargs):
-        if not self.agent:
-            return
-
-        extras = await parallel_tools.build_parallel_jobs_extras(self.agent)
-        if extras:
-            loop_data.extras_temporary["parallel_jobs"] = extras
+version https://git-lfs.github.com/spec/v1
+oid sha256:2d4e5220acd60cb3de270e2e828db61c999c951ab5d9f9bbb9f5457bc1a15f2b
+size 423

extensions/python/message_loop_prompts_after/_75_include_workdir_extras.py

@@ -1,96 +1,3 @@
-from helpers.extension import Extension
-from agent import LoopData
-from helpers import projects
-from helpers import settings
-from helpers import runtime
-from helpers import file_tree
-from helpers import files
-
-class IncludeWorkdirExtras(Extension):
-    async def execute(self, loop_data: LoopData = LoopData(), **kwargs):
-        if not self.agent:
-            return
-
-        project_name = projects.get_context_project_name(self.agent.context)
-
-        enabled = False
-        max_depth = 0
-        max_files = 0
-        max_folders = 0
-        max_lines = 0
-        gitignore_raw = ""
-        folder = ""
-        file_structure = ""
-
-        if project_name:
-            project = projects.load_basic_project_data(project_name)
-            enabled = project["file_structure"]["enabled"]
-            
-            if not enabled:
-                return
-            
-            max_depth = project["file_structure"]["max_depth"]
-            gitignore_raw = project["file_structure"]["gitignore"]
-
-            folder = projects.get_project_folder(project_name)
-            if runtime.is_development():
-                folder = files.normalize_a0_path(folder)
-
-            file_structure = projects.get_file_structure(project_name)
-        else:
-            set = settings.get_settings_for_prompt()
-            enabled = bool(set["workdir_show"])
-
-            if not enabled:
-                return
-            
-            max_depth = set["workdir_max_depth"]
-            max_files = set["workdir_max_files"]
-            max_folders = set["workdir_max_folders"]
-            max_lines = set["workdir_max_lines"]
-            gitignore_raw = set["workdir_gitignore"]
-
-            folder = set["workdir_path"]
-            scan_path = files.get_abs_path_development(folder)
-
-            files.create_dir(scan_path)
-
-            file_structure = str(
-                file_tree.file_tree(
-                    scan_path,
-                    max_depth=max_depth,
-                    max_files=max_files,
-                    max_folders=max_folders,
-                    max_lines=max_lines,
-                    ignore=gitignore_raw,
-                    output_mode=file_tree.OUTPUT_MODE_STRING,
-                )
-            )
-
-        gitignore = cleanup_gitignore(gitignore_raw)
-
-        file_structure_prompt = self.agent.read_prompt(
-            "agent.extras.workdir_structure.md",
-            max_depth=max_depth,
-            gitignore=gitignore,
-            folder=folder,
-            file_structure=file_structure,
-        )
-
-        loop_data.extras_temporary["project_file_structure"] = file_structure_prompt
-
-
-def cleanup_gitignore(gitignore_raw: str) -> str:
-    """Process gitignore: split lines, strip, remove comments, remove empty lines."""
-    gitignore_lines = []
-    for line in gitignore_raw.split('\n'):
-        # Strip whitespace
-        line = line.strip()
-        # Remove inline comments (everything after #)
-        if '#' in line:
-            line = line.split('#')[0].strip()
-        # Keep only non-empty lines
-        if line:
-            gitignore_lines.append(line)
-    
-    return '\n'.join(gitignore_lines) if gitignore_lines else "nothing ignored"
+version https://git-lfs.github.com/spec/v1
+oid sha256:bc46c3d0e739e5f9f66e753ff11d589dd857eff3ad328d9b00244e65ab307dcd
+size 3173