🙌 OpenHands: AI-Driven Development
Remove docs/ folder - migrated to separate repository (#11261)
Xingyao Wangf3c6fd21226c
diff --git a/docs/DOC_STYLE_GUIDE.md b/docs/DOC_STYLE_GUIDE.mddeleted file mode 100644index 213e857078..0000000000--- a/docs/DOC_STYLE_GUIDE.md+++ /dev/null@@ -1,67 +0,0 @@-# Documentation Style Guide--## General Writing Principles--- **Clarity & Conciseness**: Always prioritize clarity and brevity. Avoid unnecessary jargon or overly complex explanations.-Keep sentences short and to the point.-- **Gradual Complexity**: Start with the simplest, most basic setup, and then gradually introduce more advanced-concepts and configurations.--## Formatting Guidelines--### Headers--Use **Title Case** for the first and second level headers.--Example:- - **Basic Usage**- - **Advanced Configuration Options**--### Lists--When listing items or options, use bullet points to enhance readability.--Example:- - Option A- - Option B- - Option C--### Procedures--For instructions or processes that need to be followed in a specific order, use numbered steps.--Example:- 1. Step one: Do this.- - First this sub step.- - Then this sub step.- 2. Step two: Complete this action.- 3. Step three: Verify the result.--### Code Blocks--* Use code blocks for multi-line inputs, outputs, commands and code samples.--Example:-```bash-docker run -it \- -e THIS=this \- -e THAT=that- ...-```--### Use of Note and Warning--When adding a note or warning, use the built-in note and warning syntax.--Example:-<Note>-This section is for advanced users only.-</Note>--### Referring to UI Elements--When referencing UI elements, use ``.--Example:-1. Toggle the `Advanced` option-2. Enter your model in the `Custom Model` textbox.diff --git a/docs/README.md b/docs/README.mddeleted file mode 100644index 299ae6938e..0000000000--- a/docs/README.md+++ /dev/null@@ -1,36 +0,0 @@-# OpenHands Documentation--This directory contains the documentation for OpenHands. The documentation is automatically synchronized with the [All-Hands-AI/docs](https://github.com/All-Hands-AI/docs) repository, which hosts the unified documentation site using Mintlify.--## Documentation Structure--The documentation files in this directory are automatically included in the main documentation site via Git submodules. When you make changes to documentation in this repository, they will be automatically synchronized to the docs repository.--## How It Works--1. **Automatic Sync**: When documentation changes are pushed to the `main` branch, a GitHub Action automatically notifies the docs repository-2. **Submodule Update**: The docs repository updates its submodule reference to include your latest changes-3. **Site Rebuild**: Mintlify automatically rebuilds and deploys the documentation site--## Making Documentation Changes--Simply edit the documentation files in this directory as usual. The synchronization happens automatically when changes are merged to the main branch.--## Local Development--For local documentation development in this repository only:--```bash-npm install -g mint-# or-yarn global add mint--# Preview local changes-mint dev-```--For the complete unified documentation site, work with the [All-Hands-AI/docs](https://github.com/All-Hands-AI/docs) repository.--## Configuration--The Mintlify configuration (`docs.json`) has been moved to the root of the [All-Hands-AI/docs](https://github.com/All-Hands-AI/docs) repository to enable unified documentation across multiple repositories.diff --git a/docs/README_JA.md b/docs/README_JA.mddeleted file mode 100644index 03d4715cfa..0000000000--- a/docs/README_JA.md+++ /dev/null@@ -1,17 +0,0 @@-# セットアップ--```-npm install -g mint-```--または--```-yarn global add mint-```--# プレビュー--```-mint dev-```diff --git a/docs/docs.json b/docs/docs.jsondeleted file mode 100644index fd07e8c18b..0000000000--- a/docs/docs.json+++ /dev/null@@ -1,233 +0,0 @@-{- "$schema": "https://mintlify.com/docs.json",- "theme": "mint",- "name": "All Hands Docs",- "colors": {- "primary": "#99873c"- },- "background": {- "color": {- "light": "#f7f3ee"- }- },- "appearance": {- "default": "light",- "strict": true- },- "favicon": "/logo-square.png",- "navigation": {- "tabs": [- {- "tab": "Docs",- "pages": [- "index",- "usage/installation",- "usage/getting-started",- "usage/key-features",- "usage/faqs",- {- "group": "OpenHands Cloud",- "pages": [- "usage/cloud/openhands-cloud",- "usage/cloud/pro-subscription",- {- "group": "Integrations",- "pages": [- "usage/cloud/bitbucket-installation",- "usage/cloud/github-installation",- "usage/cloud/gitlab-installation",- "usage/cloud/slack-installation",- {- "group": "Project Management Tools",- "pages": [- "usage/cloud/project-management/overview",- "usage/cloud/project-management/jira-integration",- "usage/cloud/project-management/jira-dc-integration",- "usage/cloud/project-management/linear-integration"- ]- }- ]- },- "usage/cloud/cloud-ui",- "usage/cloud/cloud-api"- ]- },- {- "group": "Run OpenHands on Your Own",- "pages": [- "usage/local-setup",- "usage/how-to/gui-mode",- "usage/how-to/cli-mode",- "usage/how-to/headless-mode",- "usage/how-to/github-action",- {- "group": "Advanced Configuration",- "pages": [- {- "group": "LLM Configuration",- "pages": [- "usage/llms/llms",- {- "group": "Providers",- "pages": [- "usage/llms/openhands-llms",- "usage/llms/azure-llms",- "usage/llms/google-llms",- "usage/llms/groq",- "usage/llms/local-llms",- "usage/llms/litellm-proxy",- "usage/llms/moonshot",- "usage/llms/openai-llms",- "usage/llms/openrouter"- ]- }- ]- },- {- "group": "Runtime Configuration",- "pages": [- "usage/runtimes/overview",- {- "group": "Providers",- "pages": [- "usage/runtimes/docker",- "usage/runtimes/remote",- "usage/runtimes/local",- {- "group": "Third-Party Providers",- "pages": [- "usage/runtimes/modal",- "usage/runtimes/daytona",- "usage/runtimes/runloop",- "usage/runtimes/e2b"- ]- }- ]- }- ]- },- "usage/configuration-options",- "usage/how-to/custom-sandbox-guide",- "usage/search-engine-setup"- ]- }- ]- },- {- "group": "Customizations & Settings",- "pages": [- {- "group": "OpenHands Settings",- "pages": [- "usage/settings/secrets-settings",- "usage/settings/mcp-settings"- ]- },- "usage/prompting/repository",- {- "group": "Microagents",- "pages": [- "usage/prompting/microagents-overview",- "usage/prompting/microagents-repo",- "usage/prompting/microagents-keyword",- "usage/prompting/microagents-org",- "usage/prompting/microagents-public"- ]- }- ]- },- {- "group": "Tips and Tricks",- "pages": [- "usage/prompting/prompting-best-practices"- ]- },- {- "group": "Troubleshooting & Feedback",- "pages": [- "usage/troubleshooting/troubleshooting",- "usage/feedback"- ]- },- {- "group": "OpenHands Developers",- "pages": [- "usage/how-to/development-overview",- {- "group": "Architecture",- "pages": [- "usage/architecture/backend",- "usage/architecture/runtime"- ]- },- "usage/how-to/debugging",- "usage/how-to/evaluation-harness",- "usage/how-to/websocket-connection"- ]- }- ]- },- {- "tab": "Success Stories",- "pages": [- "success-stories/index"- ]- },- {- "tab": "API Reference",- "openapi": "/openapi.json"- }- ],- "global": {- "anchors": [- {- "anchor": "Company",- "href": "https://www.all-hands.dev/",- "icon": "house"- },- {- "anchor": "Blog",- "href": "https://www.all-hands.dev/blog",- "icon": "newspaper"- },- {- "anchor": "OpenHands Cloud",- "href": "https://app.all-hands.dev",- "icon": "cloud"- }- ]- }- },- "logo": {- "light": "/logo/light.svg",- "dark": "/logo/dark.svg"- },- "navbar": {- "links": [- ],- "primary": {- "type": "github",- "href": "https://github.com/All-Hands-AI/OpenHands"- }- },- "footer": {- "socials": {- "slack": "https://all-hands.dev/joinslack",- "github": "https://github.com/All-Hands-AI/OpenHands"- }- },- "contextual": {- "options": [- "copy",- "view",- "chatgpt",- "claude"- ]- },- "redirects": [- {- "source": "/modules/:slug*",- "destination": "/:slug*"- }- ]-}diff --git a/docs/favicon.svg b/docs/favicon.svgdeleted file mode 100644index b785c738bf..0000000000--- a/docs/favicon.svg+++ /dev/null@@ -1,19 +0,0 @@-<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">-<path d="M9.06145 23.1079C5.26816 22.3769 -3.39077 20.6274 1.4173 5.06384C9.6344 6.09939 16.9728 14.0644 9.06145 23.1079Z" fill="url(#paint0_linear_17557_2021)"/>-<path d="M8.91928 23.0939C5.27642 21.2223 0.78371 4.20891 17.0071 0C20.7569 7.19341 19.6212 16.5452 8.91928 23.0939Z" fill="url(#paint1_linear_17557_2021)"/>-<path d="M8.91388 23.0788C8.73534 19.8817 10.1585 9.08525 23.5699 13.1107C23.1812 20.1229 18.984 26.4182 8.91388 23.0788Z" fill="url(#paint2_linear_17557_2021)"/>-<defs>-<linearGradient id="paint0_linear_17557_2021" x1="3.77557" y1="5.91571" x2="5.23185" y2="21.5589" gradientUnits="userSpaceOnUse">-<stop stop-color="#18E299"/>-<stop offset="1" stop-color="#15803D"/>-</linearGradient>-<linearGradient id="paint1_linear_17557_2021" x1="12.1711" y1="-0.718425" x2="10.1897" y2="22.9832" gradientUnits="userSpaceOnUse">-<stop stop-color="#16A34A"/>-<stop offset="1" stop-color="#4ADE80"/>-</linearGradient>-<linearGradient id="paint2_linear_17557_2021" x1="23.1327" y1="15.353" x2="9.33841" y2="18.5196" gradientUnits="userSpaceOnUse">-<stop stop-color="#4ADE80"/>-<stop offset="1" stop-color="#0D9373"/>-</linearGradient>-</defs>-</svg>diff --git a/docs/index.mdx b/docs/index.mdxdeleted file mode 100644index 536f49f246..0000000000--- a/docs/index.mdx+++ /dev/null@@ -1,17 +0,0 @@-----title: Introduction-description: OpenHands - Code Less, Make More-icon: book-open-mode: wide-----Use AI to tackle the toil in your backlog. Our agents have all the same tools as a human developer:-they can modify code, run commands, browse the web, call APIs, and yes-even copy code snippets from StackOverflow.--<iframe- className="w-full aspect-video"- src="https://www.youtube.com/embed/oB4JR98KRAA"- title="YouTube video player"- frameborder="0"- allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"- allowfullscreen-></iframe>diff --git a/docs/logo-square.png b/docs/logo-square.pngdeleted file mode 100644index a260f507bc..0000000000Binary files a/docs/logo-square.png and /dev/null differdiff --git a/docs/logo/dark.svg b/docs/logo/dark.svgdeleted file mode 100644index 5632a89e4a..0000000000--- a/docs/logo/dark.svg+++ /dev/null@@ -1,29 +0,0 @@-<svg width="1305" height="196" viewBox="0 0 1305 196" fill="none" xmlns="http://www.w3.org/2000/svg">-<g clip-path="url(#clip0_14027_2415)">-<g clip-path="url(#clip1_14027_2415)">-<path d="M282.419 58.7848C273.03 53.1628 266.757 61.779 267.526 73.4779L267.448 73.5663C267.474 61.3495 265.779 47.8566 260.145 36.9411C258.15 33.0751 254.107 26.7204 246.113 29.7146C242.605 31.0285 239.423 34.9828 241.066 45.1909C241.066 45.1909 242.892 55.9043 242.552 69.3719V69.5614C240.27 32.4182 231.663 21.0857 219.352 21.8185C215.414 22.5007 210.028 24.1557 211.841 35.5766C211.841 35.5766 213.81 47.4902 214.449 56.9782L214.488 57.4583H214.449C208.659 36.979 200.86 36.701 195.213 37.4969C190.088 38.2171 184.493 43.3969 187.323 53.605C196.204 85.6315 194.47 124.202 193.805 129.723C191.992 125.946 191.431 122.952 188.914 118.808C178.794 102.169 173.982 100.944 168.074 100.691C162.206 100.438 155.868 103.963 156.285 110.672C156.716 117.38 160.224 118.492 165.205 127.841C169.092 135.118 170.2 144.656 178.025 161.99C184.506 176.342 201.447 192.084 232.302 190.214C257.302 189.405 294.639 180.89 288.144 124.973C286.527 115.258 287.74 107.122 288.588 98.7833C289.905 85.8463 291.835 64.4068 282.432 58.7722L282.419 58.7848Z" fill="#FFE165"/>-<path d="M126.317 101.083C120.409 101.449 115.636 102.75 105.829 119.566C103.391 123.748 102.895 126.754 101.148 130.557C100.378 125.049 97.9134 86.516 106.181 54.3378C108.816 44.0918 103.13 39.0131 97.9916 38.3814C92.3318 37.6865 84.5201 38.1034 79.1211 58.7849H79.0559L79.1341 58.1911C79.5906 48.6905 81.3381 36.7516 81.3381 36.7516C82.9161 25.2928 77.517 23.7389 73.5655 23.1198C61.2808 22.6145 52.9083 33.9975 51.2912 70.8122H51.2652C50.7044 57.4836 52.3084 46.8713 52.3084 46.8713C53.756 36.6253 50.4957 32.7341 46.9616 31.4833C38.9152 28.6281 34.9898 35.0587 33.0727 38.9625C27.6476 49.9792 26.2 63.4973 26.4609 75.7141L26.3826 75.6257C26.9173 63.9142 20.488 55.4117 11.2027 61.1979C1.9174 66.9968 4.25176 88.3984 5.8167 101.31C6.83391 109.636 8.19019 117.747 6.75567 127.487C1.33054 183.505 38.8239 191.351 63.8368 191.717C94.7183 193.044 111.359 176.986 117.566 162.521C125.052 145.061 125.991 135.497 129.734 128.157C134.533 118.719 138.028 117.544 138.328 110.836C138.628 104.127 132.225 100.716 126.356 101.07L126.317 101.083Z" fill="#FFE165"/>-<path d="M138.679 101.171C135.549 98.2021 130.842 96.6228 126.056 96.9008C118.387 97.3682 112.949 100.084 104.59 113.35C104.368 98.1768 105.242 75.3981 110.38 55.361C112.31 47.8313 110.367 42.9168 108.385 40.1247C106.076 36.8652 102.49 34.7175 98.5256 34.2374C94.9132 33.7952 90.1923 33.7699 85.5888 37.4337C85.5888 37.3832 85.6018 37.32 85.6018 37.32C87.0885 26.5561 83.2544 20.3908 74.2169 19.0011L73.7213 18.9505C68.1527 18.7105 63.3797 20.4792 59.5325 24.1935C57.472 26.177 55.6854 28.7417 54.1335 31.9128C52.399 29.4492 50.169 28.1984 48.4084 27.5668C37.6495 23.7387 31.7027 31.938 29.1205 37.1684C26.1211 43.2579 24.2562 50.0801 23.2129 57.0413C22.9912 56.9023 22.7825 56.7634 22.5608 56.637C20.1873 55.3105 15.2447 53.6934 8.82849 57.6983C-2.04784 64.4952 -0.665478 84.027 1.49935 101.815C1.61673 102.763 1.7341 103.698 1.85147 104.645C2.77739 111.935 3.65115 118.82 2.45136 126.919L2.42528 127.121C0.247403 149.596 4.61619 166.892 15.4143 178.553C25.795 189.771 42.0574 195.608 63.6144 195.924C65.1924 195.987 66.7312 196.013 68.231 196C105.059 195.671 118.27 171.73 121.517 164.15C125.716 154.346 127.894 147.032 129.629 141.144C130.972 136.596 132.041 133.008 133.554 130.026C135.276 126.641 136.788 124.442 138.119 122.497C140.388 119.187 142.344 116.331 142.579 111.025C142.748 107.185 141.392 103.774 138.64 101.171H138.679ZM65.6488 30.1314C67.7224 28.1353 70.1089 27.2509 73.1345 27.3141C75.7557 27.731 78.1292 28.3501 77.0468 36.183C76.9686 36.6757 75.2732 48.4377 74.8168 58.0141C74.8168 58.0773 74.8168 58.1404 74.8168 58.2036C72.4302 67.5526 70.4349 81.0202 69.3656 100.704C64.7359 100.981 60.1194 101.462 55.6332 102.093C54.1856 62.158 57.5372 37.9391 65.6358 30.1314H65.6488ZM36.9452 40.7817C40.1925 34.2121 42.9181 34.5406 45.4481 35.4376C48.9561 36.6883 48.4084 43.4727 48.0041 46.29C47.9389 46.7448 46.374 57.3192 46.9217 70.7742C46.5174 80.2116 46.5696 91.0893 47.0521 103.534C42.7616 104.355 38.6927 105.302 34.976 106.326C33.2155 100.59 25.4299 64.1541 36.9452 40.7943V40.7817ZM130.946 117.86C129.537 119.907 127.79 122.459 125.821 126.325C123.956 129.976 122.808 133.892 121.335 138.832C119.652 144.505 117.553 151.567 113.549 160.929C110.706 167.549 98.7603 189.051 63.8752 187.535C44.4309 187.257 30.6855 182.482 21.8566 172.943C12.7539 163.114 9.11539 147.979 11.0324 127.98C12.3626 118.833 11.3846 111.088 10.4326 103.609C10.3152 102.674 10.1978 101.752 10.0804 100.817C9.03715 92.1884 6.24634 69.2581 13.5103 64.7226C15.4664 63.4972 17.0705 63.2192 18.2572 63.8762C20.2786 65.0006 22.313 69.0939 22.0261 75.436C22.0131 75.7772 22.0522 76.1056 22.1174 76.4341C22.4826 91.2156 25.2082 104.077 26.7601 108.903C24.2171 109.825 21.974 110.785 20.0961 111.745C17.9834 112.832 17.1879 115.359 18.3094 117.405C19.0919 118.833 20.6047 119.642 22.1696 119.629C22.8347 119.629 23.5128 119.465 24.1519 119.136C34.7022 113.716 59.7281 108.208 81.7807 108.802C84.1803 108.84 86.1495 107.046 86.2147 104.734C86.28 102.422 84.402 100.501 82.0155 100.438C80.6983 100.4 79.3681 100.4 78.0379 100.4C80.2419 60.7051 86.306 47.7555 91.0269 43.9275C92.9831 42.3483 94.848 42.2219 97.4301 42.5378C98.1474 42.6262 99.9471 43.0305 101.238 44.8497C102.634 46.8332 102.894 49.7643 101.982 53.327C94.0003 84.4186 95.8 120.981 96.7129 129.85C96.5564 130.153 96.4129 130.456 96.2434 130.772C94.3785 134.17 90.9096 137.708 86.7755 137.468C84.4151 137.354 82.3415 139.098 82.1981 141.397C82.0546 143.709 83.8673 145.692 86.2539 145.831C93.2439 146.236 99.8297 142.079 103.872 134.714C104.303 133.93 104.668 133.185 104.994 132.465C105.02 132.414 105.046 132.351 105.072 132.301C105.829 130.658 106.376 129.155 106.859 127.803C107.615 125.706 108.267 123.886 109.571 121.638C118.831 105.744 122.587 105.517 126.564 105.277C128.898 105.138 131.22 105.858 132.589 107.172C133.567 108.094 133.998 109.244 133.932 110.684C133.802 113.653 132.954 114.891 130.907 117.873L130.946 117.86Z" fill="black"/>-<path d="M292.383 124.316C291.04 116.243 291.783 109.345 292.566 102.043C292.67 101.095 292.774 100.16 292.866 99.2129C294.691 81.3993 295.709 61.8296 284.689 55.2348C278.194 51.3436 273.278 53.0492 270.93 54.4136C270.709 54.54 270.5 54.6916 270.278 54.8305C269.091 47.8946 267.109 41.1103 263.992 35.0713C261.319 29.8915 255.229 21.7933 244.535 25.8108C242.787 26.4678 240.597 27.7564 238.901 30.2579C237.284 27.1121 235.445 24.5853 233.346 22.6397C229.433 19.0012 224.621 17.3083 219.066 17.6494L218.57 17.6999C209.559 19.2539 205.842 25.4823 207.537 36.2463C207.537 36.2463 207.537 36.2968 207.55 36.3347C202.882 32.7467 198.161 32.8604 194.561 33.3658C190.61 33.9217 187.063 36.1326 184.82 39.43C182.902 42.2599 181.038 47.1997 183.111 54.6916C188.641 74.6403 189.945 97.4063 190.01 112.579C181.403 99.4656 175.912 96.8504 168.244 96.5219C163.471 96.3198 158.763 98.0001 155.699 101.02C152.999 103.673 151.708 107.109 151.956 110.937C152.295 116.231 154.303 119.061 156.638 122.32C158.007 124.24 159.559 126.413 161.345 129.761C162.923 132.718 164.058 136.28 165.493 140.803C167.344 146.653 169.653 153.93 174.048 163.658C177.438 171.175 191.105 194.888 227.829 194.547C229.316 194.535 230.855 194.484 232.42 194.383C254.094 193.688 270.239 187.548 280.411 176.152C290.975 164.302 295.017 146.931 292.422 124.493L292.396 124.291L292.383 124.316ZM245.317 44.5593C244.861 41.7041 244.17 34.9324 247.665 33.6311C250.169 32.6836 252.907 32.3172 256.272 38.8236C268.231 61.9812 261.149 98.5559 259.493 104.317C255.75 103.357 251.668 102.485 247.365 101.74C247.6 89.2954 247.443 78.4051 246.869 68.9803C247.156 55.5254 245.396 44.9762 245.317 44.5593ZM219.822 26.0003C222.861 25.874 225.26 26.7204 227.36 28.6913C235.602 36.36 239.423 60.5031 238.732 100.464C234.232 99.9078 229.616 99.5161 224.973 99.314C223.539 79.6432 221.283 66.2262 218.714 56.9151C218.714 56.8519 218.714 56.7888 218.714 56.7256C218.074 47.1492 216.144 35.4251 216.066 34.9703C214.827 27.1247 217.188 26.4678 219.809 26.0003H219.822ZM283.841 125.554C286.136 145.516 282.785 160.714 273.878 170.707C265.231 180.397 251.577 185.426 232.015 186.057C197.326 188.18 184.937 166.905 181.977 160.335C177.777 151.037 175.547 144.025 173.761 138.378C172.196 133.45 170.97 129.572 169.04 125.946C167.005 122.118 165.206 119.604 163.758 117.582C161.658 114.639 160.785 113.413 160.589 110.444C160.498 109.004 160.915 107.842 161.867 106.907C163.223 105.568 165.519 104.797 167.866 104.911C171.844 105.088 175.599 105.239 185.172 120.968C186.528 123.192 187.206 124.998 188.002 127.083C188.523 128.435 189.097 129.938 189.893 131.568C189.919 131.618 189.932 131.669 189.958 131.707C190.31 132.427 190.688 133.16 191.131 133.943C195.318 141.233 201.982 145.276 208.959 144.745C211.332 144.568 213.119 142.547 212.936 140.247C212.754 137.948 210.68 136.242 208.294 136.394C204.16 136.697 200.625 133.223 198.695 129.862C198.513 129.547 198.369 129.256 198.213 128.953C198.956 120.084 200.065 83.4839 191.484 52.5438C190.492 48.9937 190.701 46.0627 192.057 44.0539C193.322 42.2094 195.109 41.7672 195.826 41.6662C198.395 41.2998 200.273 41.4009 202.256 42.9422C207.055 46.6944 213.367 59.5303 216.314 99.175C214.984 99.1876 213.654 99.2255 212.349 99.2887C209.963 99.3898 208.124 101.348 208.228 103.66C208.333 105.972 210.315 107.715 212.741 107.652C234.767 106.667 259.911 111.72 270.552 116.963C271.191 117.279 271.869 117.418 272.547 117.418C274.112 117.406 275.612 116.572 276.368 115.119C277.451 113.06 276.603 110.533 274.464 109.484C272.573 108.549 270.304 107.64 267.748 106.755C269.209 101.904 271.7 88.9922 271.778 74.2107C271.843 73.8822 271.869 73.5537 271.843 73.2126C271.426 66.8831 273.395 62.7519 275.39 61.5896C276.564 60.9074 278.168 61.16 280.15 62.3476C287.506 66.7568 285.158 89.725 284.271 98.3791C284.18 99.314 284.076 100.236 283.971 101.171C283.163 108.676 282.328 116.42 283.841 125.554Z" fill="black"/>-<path d="M162.923 44.774C162.232 44.774 161.527 44.6477 160.862 44.3445C158.424 43.258 157.354 40.4659 158.476 38.1034C162.101 30.4347 167.409 23.3598 173.812 17.6494C175.781 15.8933 178.859 16.007 180.672 17.9273C182.485 19.835 182.367 22.8166 180.385 24.5727C174.921 29.4493 170.395 35.4882 167.292 42.0325C166.483 43.7381 164.749 44.7614 162.923 44.774Z" fill="black"/>-<path d="M146.57 42.0578C144.053 42.083 141.901 40.2132 141.692 37.737C140.766 26.6572 140.727 15.4258 141.601 4.34602C141.809 1.7561 144.144 -0.176866 146.804 0.0126405C149.478 0.214781 151.473 2.46359 151.277 5.05351C150.443 15.6406 150.482 26.3793 151.369 36.9664C151.59 39.5563 149.595 41.8304 146.922 42.0325C146.804 42.0325 146.687 42.0451 146.57 42.0451V42.0578Z" fill="black"/>-<path d="M129.851 44.9762C127.673 45.0015 125.665 43.5739 125.104 41.4388C123.043 33.6058 119.144 26.1645 113.836 19.9361C112.128 17.9273 112.428 14.971 114.488 13.316C116.562 11.661 119.614 11.9516 121.322 13.9477C127.53 21.25 132.094 29.9547 134.494 39.1141C135.159 41.6283 133.581 44.1929 130.985 44.8372C130.594 44.9383 130.216 44.9762 129.825 44.9888L129.851 44.9762Z" fill="black"/>-</g>-</g>-<path d="M379.045 147.144L419.52 55.0319C423.451 46.2048 424.882 39.0196 425.244 34.35C425.349 32.9943 426.419 31.9097 427.775 31.7892L440.789 30.5691C441.979 30.4637 443.109 31.1114 443.606 32.211L492.788 141.571C500.244 158.005 502.94 165.566 513.153 168.715C514.313 169.076 515.127 170.161 515.127 171.381V173.655C515.127 175.207 513.876 176.457 512.325 176.457H455.822C454.271 176.457 453.021 175.207 453.021 173.655V171.321C453.021 170.01 453.955 168.88 455.235 168.594C466.954 166.003 466.728 160.068 462.556 150.413L459.528 143.438C456.741 136.931 451.62 135.997 445.805 135.997H407.665C401.384 135.997 396.97 137.157 394.409 143.212L391.849 149.027C387.224 159.827 391.999 166.033 405.195 168.639C406.505 168.895 407.439 170.055 407.439 171.381V173.685C407.439 175.237 406.189 176.487 404.637 176.487H358.589C357.037 176.487 355.787 175.237 355.787 173.685V171.245C355.787 169.98 356.631 168.88 357.851 168.549C369.344 165.476 373.984 158.622 379.045 147.174V147.144ZM407.665 125.98H445.579C448.14 125.98 450.46 123.886 448.833 120.166L428.603 75.051C426.75 71.0894 425.816 71.0894 424.19 75.051L404.185 120.874C402.785 124.127 405.345 125.995 407.68 125.995L407.665 125.98Z" fill="#fff" stroke="#fff" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M527.675 156.227V50.1663C527.675 40.5107 524.075 37.3023 515.685 37.4378C514.103 37.468 512.777 36.2328 512.777 34.6361V32.708C512.777 31.3523 513.741 30.2074 515.067 29.9514L545.344 24.3328C552.093 23.1729 555.572 26.2006 555.572 32.4669V156.212C555.572 162.825 558.329 166.184 563.179 165.883C564.836 165.777 566.267 166.997 566.267 168.669V168.745C566.267 169.227 566.162 169.709 565.921 170.115C562.682 175.689 555.316 177.843 548.598 177.843C536.502 177.843 527.66 171.094 527.66 156.212L527.675 156.227Z" fill="#fff" stroke="#fff" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M581.748 156.227V50.1663C581.748 40.5107 578.148 37.3023 569.758 37.4378C568.176 37.468 566.851 36.2328 566.851 34.6361V32.708C566.851 31.3523 567.815 30.2074 569.14 29.9514L599.417 24.3328C606.166 23.1729 609.645 26.2006 609.645 32.4669V156.212C609.645 162.825 612.402 166.184 617.252 165.883C618.909 165.777 620.34 166.997 620.34 168.669V168.745C620.34 169.227 620.235 169.709 619.994 170.115C616.755 175.689 609.389 177.843 602.671 177.843C590.575 177.843 581.733 171.094 581.733 156.212L581.748 156.227Z" fill="#fff" stroke="#fff" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M688.158 155.052V53.4201C688.158 45.2558 683.383 41.4599 674.405 39.818C673.079 39.577 672.115 38.4171 672.115 37.0765V34.817C672.115 33.2655 673.365 32.0152 674.917 32.0152H733.046C734.598 32.0152 735.848 33.2655 735.848 34.817V37.0765C735.848 38.4171 734.884 39.577 733.558 39.818C724.566 41.4448 719.806 45.2408 719.806 53.4201V92.9613C719.806 98.3087 723.993 100.644 729.808 100.644H770.283C776.097 100.644 780.285 98.3238 780.285 92.9613V53.4201C780.285 45.2558 775.51 41.4599 766.532 39.818C765.206 39.577 764.242 38.4171 764.242 37.0765V34.817C764.242 33.2655 765.493 32.0152 767.044 32.0152H825.173C826.725 32.0152 827.975 33.2655 827.975 34.817V37.0765C827.975 38.4171 827.011 39.577 825.686 39.818C816.708 41.4448 811.933 45.2408 811.933 53.4201V155.067C811.933 163.232 816.708 167.027 825.686 168.669C827.011 168.91 827.975 170.07 827.975 171.411V173.67C827.975 175.222 826.725 176.472 825.173 176.472H767.044C765.493 176.472 764.242 175.222 764.242 173.67V171.411C764.242 170.07 765.206 168.91 766.532 168.669C775.525 167.043 780.285 163.247 780.285 155.067V117.62C780.285 112.272 776.097 109.938 770.524 109.938H729.582C723.993 109.938 719.821 112.257 719.821 117.62V155.067C719.821 163.232 724.596 167.027 733.573 168.669C734.899 168.91 735.863 170.07 735.863 171.411V173.67C735.863 175.222 734.613 176.472 733.061 176.472H674.932C673.381 176.472 672.13 175.222 672.13 173.67V171.411C672.13 170.07 673.094 168.91 674.42 168.669C683.398 167.043 688.173 163.247 688.173 155.067L688.158 155.052Z" fill="#fff" stroke="#fff" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M834.929 152.265C834.929 133.421 850.745 122.033 896.101 115.511C902.608 114.577 904.476 112.95 904.476 106.909V103.189C904.476 86.4384 899.128 77.8373 885.873 77.8373C859.361 77.8373 879.591 108.777 855.4 108.777C846.091 108.777 841.677 102.963 841.677 95.5216C841.677 77.6114 867.029 69.4772 892.621 69.4772C920.066 69.4772 932.388 79.4792 932.388 111.805V156.227C932.388 162.855 934.346 166.379 938.941 165.973C940.553 165.837 941.923 167.148 941.923 168.759C941.923 169.226 941.818 169.708 941.577 170.115C938.414 175.688 931.891 177.843 924.947 177.843C911.917 177.843 905.877 170.16 904.943 161.8C904.717 159.013 902.849 158.546 900.755 161.107C894.248 169.241 882.152 177.858 865.402 177.858C849.585 177.858 834.929 170.416 834.929 152.28V152.265ZM879.817 162.267C894.007 162.267 904.476 151.331 904.476 136.675V130.634C904.476 125.287 902.623 122.952 895.167 123.66C869.348 125.98 863.534 137.608 863.534 146.692C863.534 155.067 868.414 162.282 879.817 162.282V162.267Z" fill="#fff" stroke="#fff" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M1038.21 156.227V114.125C1038.21 98.0829 1030.3 85.746 1015.89 85.746C1001.47 85.746 992.856 98.0678 992.856 114.125V154.359C992.856 164.211 996.2 167.751 1005.07 168.971C1006.46 169.167 1007.51 170.341 1007.51 171.742V173.655C1007.51 175.207 1006.26 176.457 1004.71 176.457H952.863C951.311 176.457 950.061 175.207 950.061 173.655V171.757C950.061 170.357 951.115 169.182 952.501 168.986C961.584 167.766 964.944 164.226 964.944 154.359V95.7481C964.944 86.0925 961.343 82.884 952.953 83.0196C951.372 83.0497 950.046 81.8145 950.046 80.2178V78.2897C950.046 76.934 951.01 75.7892 952.336 75.5331L982.613 69.9145C989.361 68.7546 992.841 71.7824 992.841 77.1298C992.841 85.505 996.561 87.5988 999.589 84.1041C1004.47 78.2897 1013.31 68.9806 1031.69 68.9806C1048.91 68.9806 1066.11 77.3558 1066.11 108.748V156.197C1066.11 162.81 1068.87 166.169 1073.72 165.868C1075.37 165.762 1076.8 166.982 1076.8 168.654V168.73C1076.8 169.212 1076.7 169.694 1076.46 170.1C1073.22 175.674 1065.85 177.828 1059.13 177.828C1047.04 177.828 1038.2 171.08 1038.2 156.197L1038.21 156.227Z" fill="#fff" stroke="#fff" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M1082.63 125.061C1082.63 88.7735 1107.52 69.4775 1133.11 69.4775C1157.06 69.4775 1165.21 86.6948 1165.21 67.6096V50.1663C1165.21 40.5107 1161.61 37.3023 1153.22 37.4378C1151.64 37.468 1150.31 36.2328 1150.31 34.6361V32.708C1150.31 31.3523 1151.27 30.2074 1152.6 29.9514L1182.88 24.3328C1189.63 23.1729 1193.1 26.2006 1193.1 32.4669V156.212C1193.1 162.825 1195.86 166.184 1200.71 165.883C1202.37 165.777 1203.8 166.997 1203.8 168.669V168.745C1203.8 169.227 1203.69 169.709 1203.45 170.115C1200.21 175.689 1192.86 177.843 1186.36 177.843C1178.67 177.843 1170.77 174.815 1168.22 167.841C1166.82 164.12 1164.73 162.493 1162.18 162.493C1156.59 162.493 1148.46 177.843 1127.29 177.843C1104.04 177.843 1082.63 158.532 1082.63 125.046V125.061ZM1142.64 161.574C1152.64 161.574 1165.21 155.534 1165.21 135.289V117.62C1165.21 89.2405 1148.92 78.0786 1135.89 78.0786C1120.77 78.0786 1111.94 93.4281 1111.94 114.592C1111.94 139.718 1124.27 161.574 1142.64 161.574Z" fill="#fff" stroke="#fff" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M1219.29 167.826C1218.9 167.539 1218.6 167.163 1218.39 166.726C1212.86 154.781 1212.35 141.103 1221.02 141.103C1224.28 141.103 1226.37 142.73 1227.53 146.225C1233.12 162.975 1242.88 169.483 1256.6 169.483C1272.19 169.483 1276.61 161.574 1276.61 154.133C1276.61 143.905 1267.07 140.636 1252.41 136.223C1233.57 130.408 1215.66 121.34 1215.66 101.095C1215.66 80.8501 1234.5 69.4623 1258.45 69.4623C1272.06 69.4623 1284.77 73.213 1292.72 78.7865C1293.13 79.0727 1293.46 79.4643 1293.67 79.9162C1299.19 91.8463 1299.68 105.268 1291.02 105.268C1287.77 105.268 1285.67 103.641 1284.51 100.146C1278.93 83.3958 1268.92 77.3554 1257.07 77.3554C1245.91 77.3554 1240.79 82.9439 1240.79 91.3041C1240.79 101.773 1249.63 106.895 1260.79 110.374C1277.54 115.496 1302.65 121.777 1302.65 145.035C1302.65 166.666 1280.33 177.828 1254.98 177.828C1240 177.828 1227.23 173.625 1219.28 167.795L1219.29 167.826Z" fill="#fff" stroke="#fff" stroke-width="0.393644" stroke-miterlimit="10"/>-<defs>-<clipPath id="clip0_14027_2415">-<rect width="294" height="196" fill="white"/>-</clipPath>-<clipPath id="clip1_14027_2415">-<rect width="294" height="196" fill="white"/>-</clipPath>-</defs>-</svg>diff --git a/docs/logo/light.svg b/docs/logo/light.svgdeleted file mode 100644index 80f4eccf39..0000000000--- a/docs/logo/light.svg+++ /dev/null@@ -1,29 +0,0 @@-<svg width="1305" height="196" viewBox="0 0 1305 196" fill="none" xmlns="http://www.w3.org/2000/svg">-<g clip-path="url(#clip0_14027_2415)">-<g clip-path="url(#clip1_14027_2415)">-<path d="M282.419 58.7848C273.03 53.1628 266.757 61.779 267.526 73.4779L267.448 73.5663C267.474 61.3495 265.779 47.8566 260.145 36.9411C258.15 33.0751 254.107 26.7204 246.113 29.7146C242.605 31.0285 239.423 34.9828 241.066 45.1909C241.066 45.1909 242.892 55.9043 242.552 69.3719V69.5614C240.27 32.4182 231.663 21.0857 219.352 21.8185C215.414 22.5007 210.028 24.1557 211.841 35.5766C211.841 35.5766 213.81 47.4902 214.449 56.9782L214.488 57.4583H214.449C208.659 36.979 200.86 36.701 195.213 37.4969C190.088 38.2171 184.493 43.3969 187.323 53.605C196.204 85.6315 194.47 124.202 193.805 129.723C191.992 125.946 191.431 122.952 188.914 118.808C178.794 102.169 173.982 100.944 168.074 100.691C162.206 100.438 155.868 103.963 156.285 110.672C156.716 117.38 160.224 118.492 165.205 127.841C169.092 135.118 170.2 144.656 178.025 161.99C184.506 176.342 201.447 192.084 232.302 190.214C257.302 189.405 294.639 180.89 288.144 124.973C286.527 115.258 287.74 107.122 288.588 98.7833C289.905 85.8463 291.835 64.4068 282.432 58.7722L282.419 58.7848Z" fill="#FFE165"/>-<path d="M126.317 101.083C120.409 101.449 115.636 102.75 105.829 119.566C103.391 123.748 102.895 126.754 101.148 130.557C100.378 125.049 97.9134 86.516 106.181 54.3378C108.816 44.0918 103.13 39.0131 97.9916 38.3814C92.3318 37.6865 84.5201 38.1034 79.1211 58.7849H79.0559L79.1341 58.1911C79.5906 48.6905 81.3381 36.7516 81.3381 36.7516C82.9161 25.2928 77.517 23.7389 73.5655 23.1198C61.2808 22.6145 52.9083 33.9975 51.2912 70.8122H51.2652C50.7044 57.4836 52.3084 46.8713 52.3084 46.8713C53.756 36.6253 50.4957 32.7341 46.9616 31.4833C38.9152 28.6281 34.9898 35.0587 33.0727 38.9625C27.6476 49.9792 26.2 63.4973 26.4609 75.7141L26.3826 75.6257C26.9173 63.9142 20.488 55.4117 11.2027 61.1979C1.9174 66.9968 4.25176 88.3984 5.8167 101.31C6.83391 109.636 8.19019 117.747 6.75567 127.487C1.33054 183.505 38.8239 191.351 63.8368 191.717C94.7183 193.044 111.359 176.986 117.566 162.521C125.052 145.061 125.991 135.497 129.734 128.157C134.533 118.719 138.028 117.544 138.328 110.836C138.628 104.127 132.225 100.716 126.356 101.07L126.317 101.083Z" fill="#FFE165"/>-<path d="M138.679 101.171C135.549 98.2021 130.842 96.6228 126.056 96.9008C118.387 97.3682 112.949 100.084 104.59 113.35C104.368 98.1768 105.242 75.3981 110.38 55.361C112.31 47.8313 110.367 42.9168 108.385 40.1247C106.076 36.8652 102.49 34.7175 98.5256 34.2374C94.9132 33.7952 90.1923 33.7699 85.5888 37.4337C85.5888 37.3832 85.6018 37.32 85.6018 37.32C87.0885 26.5561 83.2544 20.3908 74.2169 19.0011L73.7213 18.9505C68.1527 18.7105 63.3797 20.4792 59.5325 24.1935C57.472 26.177 55.6854 28.7417 54.1335 31.9128C52.399 29.4492 50.169 28.1984 48.4084 27.5668C37.6495 23.7387 31.7027 31.938 29.1205 37.1684C26.1211 43.2579 24.2562 50.0801 23.2129 57.0413C22.9912 56.9023 22.7825 56.7634 22.5608 56.637C20.1873 55.3105 15.2447 53.6934 8.82849 57.6983C-2.04784 64.4952 -0.665478 84.027 1.49935 101.815C1.61673 102.763 1.7341 103.698 1.85147 104.645C2.77739 111.935 3.65115 118.82 2.45136 126.919L2.42528 127.121C0.247403 149.596 4.61619 166.892 15.4143 178.553C25.795 189.771 42.0574 195.608 63.6144 195.924C65.1924 195.987 66.7312 196.013 68.231 196C105.059 195.671 118.27 171.73 121.517 164.15C125.716 154.346 127.894 147.032 129.629 141.144C130.972 136.596 132.041 133.008 133.554 130.026C135.276 126.641 136.788 124.442 138.119 122.497C140.388 119.187 142.344 116.331 142.579 111.025C142.748 107.185 141.392 103.774 138.64 101.171H138.679ZM65.6488 30.1314C67.7224 28.1353 70.1089 27.2509 73.1345 27.3141C75.7557 27.731 78.1292 28.3501 77.0468 36.183C76.9686 36.6757 75.2732 48.4377 74.8168 58.0141C74.8168 58.0773 74.8168 58.1404 74.8168 58.2036C72.4302 67.5526 70.4349 81.0202 69.3656 100.704C64.7359 100.981 60.1194 101.462 55.6332 102.093C54.1856 62.158 57.5372 37.9391 65.6358 30.1314H65.6488ZM36.9452 40.7817C40.1925 34.2121 42.9181 34.5406 45.4481 35.4376C48.9561 36.6883 48.4084 43.4727 48.0041 46.29C47.9389 46.7448 46.374 57.3192 46.9217 70.7742C46.5174 80.2116 46.5696 91.0893 47.0521 103.534C42.7616 104.355 38.6927 105.302 34.976 106.326C33.2155 100.59 25.4299 64.1541 36.9452 40.7943V40.7817ZM130.946 117.86C129.537 119.907 127.79 122.459 125.821 126.325C123.956 129.976 122.808 133.892 121.335 138.832C119.652 144.505 117.553 151.567 113.549 160.929C110.706 167.549 98.7603 189.051 63.8752 187.535C44.4309 187.257 30.6855 182.482 21.8566 172.943C12.7539 163.114 9.11539 147.979 11.0324 127.98C12.3626 118.833 11.3846 111.088 10.4326 103.609C10.3152 102.674 10.1978 101.752 10.0804 100.817C9.03715 92.1884 6.24634 69.2581 13.5103 64.7226C15.4664 63.4972 17.0705 63.2192 18.2572 63.8762C20.2786 65.0006 22.313 69.0939 22.0261 75.436C22.0131 75.7772 22.0522 76.1056 22.1174 76.4341C22.4826 91.2156 25.2082 104.077 26.7601 108.903C24.2171 109.825 21.974 110.785 20.0961 111.745C17.9834 112.832 17.1879 115.359 18.3094 117.405C19.0919 118.833 20.6047 119.642 22.1696 119.629C22.8347 119.629 23.5128 119.465 24.1519 119.136C34.7022 113.716 59.7281 108.208 81.7807 108.802C84.1803 108.84 86.1495 107.046 86.2147 104.734C86.28 102.422 84.402 100.501 82.0155 100.438C80.6983 100.4 79.3681 100.4 78.0379 100.4C80.2419 60.7051 86.306 47.7555 91.0269 43.9275C92.9831 42.3483 94.848 42.2219 97.4301 42.5378C98.1474 42.6262 99.9471 43.0305 101.238 44.8497C102.634 46.8332 102.894 49.7643 101.982 53.327C94.0003 84.4186 95.8 120.981 96.7129 129.85C96.5564 130.153 96.4129 130.456 96.2434 130.772C94.3785 134.17 90.9096 137.708 86.7755 137.468C84.4151 137.354 82.3415 139.098 82.1981 141.397C82.0546 143.709 83.8673 145.692 86.2539 145.831C93.2439 146.236 99.8297 142.079 103.872 134.714C104.303 133.93 104.668 133.185 104.994 132.465C105.02 132.414 105.046 132.351 105.072 132.301C105.829 130.658 106.376 129.155 106.859 127.803C107.615 125.706 108.267 123.886 109.571 121.638C118.831 105.744 122.587 105.517 126.564 105.277C128.898 105.138 131.22 105.858 132.589 107.172C133.567 108.094 133.998 109.244 133.932 110.684C133.802 113.653 132.954 114.891 130.907 117.873L130.946 117.86Z" fill="black"/>-<path d="M292.383 124.316C291.04 116.243 291.783 109.345 292.566 102.043C292.67 101.095 292.774 100.16 292.866 99.2129C294.691 81.3993 295.709 61.8296 284.689 55.2348C278.194 51.3436 273.278 53.0492 270.93 54.4136C270.709 54.54 270.5 54.6916 270.278 54.8305C269.091 47.8946 267.109 41.1103 263.992 35.0713C261.319 29.8915 255.229 21.7933 244.535 25.8108C242.787 26.4678 240.597 27.7564 238.901 30.2579C237.284 27.1121 235.445 24.5853 233.346 22.6397C229.433 19.0012 224.621 17.3083 219.066 17.6494L218.57 17.6999C209.559 19.2539 205.842 25.4823 207.537 36.2463C207.537 36.2463 207.537 36.2968 207.55 36.3347C202.882 32.7467 198.161 32.8604 194.561 33.3658C190.61 33.9217 187.063 36.1326 184.82 39.43C182.902 42.2599 181.038 47.1997 183.111 54.6916C188.641 74.6403 189.945 97.4063 190.01 112.579C181.403 99.4656 175.912 96.8504 168.244 96.5219C163.471 96.3198 158.763 98.0001 155.699 101.02C152.999 103.673 151.708 107.109 151.956 110.937C152.295 116.231 154.303 119.061 156.638 122.32C158.007 124.24 159.559 126.413 161.345 129.761C162.923 132.718 164.058 136.28 165.493 140.803C167.344 146.653 169.653 153.93 174.048 163.658C177.438 171.175 191.105 194.888 227.829 194.547C229.316 194.535 230.855 194.484 232.42 194.383C254.094 193.688 270.239 187.548 280.411 176.152C290.975 164.302 295.017 146.931 292.422 124.493L292.396 124.291L292.383 124.316ZM245.317 44.5593C244.861 41.7041 244.17 34.9324 247.665 33.6311C250.169 32.6836 252.907 32.3172 256.272 38.8236C268.231 61.9812 261.149 98.5559 259.493 104.317C255.75 103.357 251.668 102.485 247.365 101.74C247.6 89.2954 247.443 78.4051 246.869 68.9803C247.156 55.5254 245.396 44.9762 245.317 44.5593ZM219.822 26.0003C222.861 25.874 225.26 26.7204 227.36 28.6913C235.602 36.36 239.423 60.5031 238.732 100.464C234.232 99.9078 229.616 99.5161 224.973 99.314C223.539 79.6432 221.283 66.2262 218.714 56.9151C218.714 56.8519 218.714 56.7888 218.714 56.7256C218.074 47.1492 216.144 35.4251 216.066 34.9703C214.827 27.1247 217.188 26.4678 219.809 26.0003H219.822ZM283.841 125.554C286.136 145.516 282.785 160.714 273.878 170.707C265.231 180.397 251.577 185.426 232.015 186.057C197.326 188.18 184.937 166.905 181.977 160.335C177.777 151.037 175.547 144.025 173.761 138.378C172.196 133.45 170.97 129.572 169.04 125.946C167.005 122.118 165.206 119.604 163.758 117.582C161.658 114.639 160.785 113.413 160.589 110.444C160.498 109.004 160.915 107.842 161.867 106.907C163.223 105.568 165.519 104.797 167.866 104.911C171.844 105.088 175.599 105.239 185.172 120.968C186.528 123.192 187.206 124.998 188.002 127.083C188.523 128.435 189.097 129.938 189.893 131.568C189.919 131.618 189.932 131.669 189.958 131.707C190.31 132.427 190.688 133.16 191.131 133.943C195.318 141.233 201.982 145.276 208.959 144.745C211.332 144.568 213.119 142.547 212.936 140.247C212.754 137.948 210.68 136.242 208.294 136.394C204.16 136.697 200.625 133.223 198.695 129.862C198.513 129.547 198.369 129.256 198.213 128.953C198.956 120.084 200.065 83.4839 191.484 52.5438C190.492 48.9937 190.701 46.0627 192.057 44.0539C193.322 42.2094 195.109 41.7672 195.826 41.6662C198.395 41.2998 200.273 41.4009 202.256 42.9422C207.055 46.6944 213.367 59.5303 216.314 99.175C214.984 99.1876 213.654 99.2255 212.349 99.2887C209.963 99.3898 208.124 101.348 208.228 103.66C208.333 105.972 210.315 107.715 212.741 107.652C234.767 106.667 259.911 111.72 270.552 116.963C271.191 117.279 271.869 117.418 272.547 117.418C274.112 117.406 275.612 116.572 276.368 115.119C277.451 113.06 276.603 110.533 274.464 109.484C272.573 108.549 270.304 107.64 267.748 106.755C269.209 101.904 271.7 88.9922 271.778 74.2107C271.843 73.8822 271.869 73.5537 271.843 73.2126C271.426 66.8831 273.395 62.7519 275.39 61.5896C276.564 60.9074 278.168 61.16 280.15 62.3476C287.506 66.7568 285.158 89.725 284.271 98.3791C284.18 99.314 284.076 100.236 283.971 101.171C283.163 108.676 282.328 116.42 283.841 125.554Z" fill="black"/>-<path d="M162.923 44.774C162.232 44.774 161.527 44.6477 160.862 44.3445C158.424 43.258 157.354 40.4659 158.476 38.1034C162.101 30.4347 167.409 23.3598 173.812 17.6494C175.781 15.8933 178.859 16.007 180.672 17.9273C182.485 19.835 182.367 22.8166 180.385 24.5727C174.921 29.4493 170.395 35.4882 167.292 42.0325C166.483 43.7381 164.749 44.7614 162.923 44.774Z" fill="black"/>-<path d="M146.57 42.0578C144.053 42.083 141.901 40.2132 141.692 37.737C140.766 26.6572 140.727 15.4258 141.601 4.34602C141.809 1.7561 144.144 -0.176866 146.804 0.0126405C149.478 0.214781 151.473 2.46359 151.277 5.05351C150.443 15.6406 150.482 26.3793 151.369 36.9664C151.59 39.5563 149.595 41.8304 146.922 42.0325C146.804 42.0325 146.687 42.0451 146.57 42.0451V42.0578Z" fill="black"/>-<path d="M129.851 44.9762C127.673 45.0015 125.665 43.5739 125.104 41.4388C123.043 33.6058 119.144 26.1645 113.836 19.9361C112.128 17.9273 112.428 14.971 114.488 13.316C116.562 11.661 119.614 11.9516 121.322 13.9477C127.53 21.25 132.094 29.9547 134.494 39.1141C135.159 41.6283 133.581 44.1929 130.985 44.8372C130.594 44.9383 130.216 44.9762 129.825 44.9888L129.851 44.9762Z" fill="black"/>-</g>-</g>-<path d="M379.045 147.144L419.52 55.0319C423.451 46.2048 424.882 39.0196 425.244 34.35C425.349 32.9943 426.419 31.9097 427.775 31.7892L440.789 30.5691C441.979 30.4637 443.109 31.1114 443.606 32.211L492.788 141.571C500.244 158.005 502.94 165.566 513.153 168.715C514.313 169.076 515.127 170.161 515.127 171.381V173.655C515.127 175.207 513.876 176.457 512.325 176.457H455.822C454.271 176.457 453.021 175.207 453.021 173.655V171.321C453.021 170.01 453.955 168.88 455.235 168.594C466.954 166.003 466.728 160.068 462.556 150.413L459.528 143.438C456.741 136.931 451.62 135.997 445.805 135.997H407.665C401.384 135.997 396.97 137.157 394.409 143.212L391.849 149.027C387.224 159.827 391.999 166.033 405.195 168.639C406.505 168.895 407.439 170.055 407.439 171.381V173.685C407.439 175.237 406.189 176.487 404.637 176.487H358.589C357.037 176.487 355.787 175.237 355.787 173.685V171.245C355.787 169.98 356.631 168.88 357.851 168.549C369.344 165.476 373.984 158.622 379.045 147.174V147.144ZM407.665 125.98H445.579C448.14 125.98 450.46 123.886 448.833 120.166L428.603 75.051C426.75 71.0894 425.816 71.0894 424.19 75.051L404.185 120.874C402.785 124.127 405.345 125.995 407.68 125.995L407.665 125.98Z" fill="black" stroke="black" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M527.675 156.227V50.1663C527.675 40.5107 524.075 37.3023 515.685 37.4378C514.103 37.468 512.777 36.2328 512.777 34.6361V32.708C512.777 31.3523 513.741 30.2074 515.067 29.9514L545.344 24.3328C552.093 23.1729 555.572 26.2006 555.572 32.4669V156.212C555.572 162.825 558.329 166.184 563.179 165.883C564.836 165.777 566.267 166.997 566.267 168.669V168.745C566.267 169.227 566.162 169.709 565.921 170.115C562.682 175.689 555.316 177.843 548.598 177.843C536.502 177.843 527.66 171.094 527.66 156.212L527.675 156.227Z" fill="black" stroke="black" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M581.748 156.227V50.1663C581.748 40.5107 578.148 37.3023 569.758 37.4378C568.176 37.468 566.851 36.2328 566.851 34.6361V32.708C566.851 31.3523 567.815 30.2074 569.14 29.9514L599.417 24.3328C606.166 23.1729 609.645 26.2006 609.645 32.4669V156.212C609.645 162.825 612.402 166.184 617.252 165.883C618.909 165.777 620.34 166.997 620.34 168.669V168.745C620.34 169.227 620.235 169.709 619.994 170.115C616.755 175.689 609.389 177.843 602.671 177.843C590.575 177.843 581.733 171.094 581.733 156.212L581.748 156.227Z" fill="black" stroke="black" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M688.158 155.052V53.4201C688.158 45.2558 683.383 41.4599 674.405 39.818C673.079 39.577 672.115 38.4171 672.115 37.0765V34.817C672.115 33.2655 673.365 32.0152 674.917 32.0152H733.046C734.598 32.0152 735.848 33.2655 735.848 34.817V37.0765C735.848 38.4171 734.884 39.577 733.558 39.818C724.566 41.4448 719.806 45.2408 719.806 53.4201V92.9613C719.806 98.3087 723.993 100.644 729.808 100.644H770.283C776.097 100.644 780.285 98.3238 780.285 92.9613V53.4201C780.285 45.2558 775.51 41.4599 766.532 39.818C765.206 39.577 764.242 38.4171 764.242 37.0765V34.817C764.242 33.2655 765.493 32.0152 767.044 32.0152H825.173C826.725 32.0152 827.975 33.2655 827.975 34.817V37.0765C827.975 38.4171 827.011 39.577 825.686 39.818C816.708 41.4448 811.933 45.2408 811.933 53.4201V155.067C811.933 163.232 816.708 167.027 825.686 168.669C827.011 168.91 827.975 170.07 827.975 171.411V173.67C827.975 175.222 826.725 176.472 825.173 176.472H767.044C765.493 176.472 764.242 175.222 764.242 173.67V171.411C764.242 170.07 765.206 168.91 766.532 168.669C775.525 167.043 780.285 163.247 780.285 155.067V117.62C780.285 112.272 776.097 109.938 770.524 109.938H729.582C723.993 109.938 719.821 112.257 719.821 117.62V155.067C719.821 163.232 724.596 167.027 733.573 168.669C734.899 168.91 735.863 170.07 735.863 171.411V173.67C735.863 175.222 734.613 176.472 733.061 176.472H674.932C673.381 176.472 672.13 175.222 672.13 173.67V171.411C672.13 170.07 673.094 168.91 674.42 168.669C683.398 167.043 688.173 163.247 688.173 155.067L688.158 155.052Z" fill="black" stroke="black" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M834.929 152.265C834.929 133.421 850.745 122.033 896.101 115.511C902.608 114.577 904.476 112.95 904.476 106.909V103.189C904.476 86.4384 899.128 77.8373 885.873 77.8373C859.361 77.8373 879.591 108.777 855.4 108.777C846.091 108.777 841.677 102.963 841.677 95.5216C841.677 77.6114 867.029 69.4772 892.621 69.4772C920.066 69.4772 932.388 79.4792 932.388 111.805V156.227C932.388 162.855 934.346 166.379 938.941 165.973C940.553 165.837 941.923 167.148 941.923 168.759C941.923 169.226 941.818 169.708 941.577 170.115C938.414 175.688 931.891 177.843 924.947 177.843C911.917 177.843 905.877 170.16 904.943 161.8C904.717 159.013 902.849 158.546 900.755 161.107C894.248 169.241 882.152 177.858 865.402 177.858C849.585 177.858 834.929 170.416 834.929 152.28V152.265ZM879.817 162.267C894.007 162.267 904.476 151.331 904.476 136.675V130.634C904.476 125.287 902.623 122.952 895.167 123.66C869.348 125.98 863.534 137.608 863.534 146.692C863.534 155.067 868.414 162.282 879.817 162.282V162.267Z" fill="black" stroke="black" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M1038.21 156.227V114.125C1038.21 98.0829 1030.3 85.746 1015.89 85.746C1001.47 85.746 992.856 98.0678 992.856 114.125V154.359C992.856 164.211 996.2 167.751 1005.07 168.971C1006.46 169.167 1007.51 170.341 1007.51 171.742V173.655C1007.51 175.207 1006.26 176.457 1004.71 176.457H952.863C951.311 176.457 950.061 175.207 950.061 173.655V171.757C950.061 170.357 951.115 169.182 952.501 168.986C961.584 167.766 964.944 164.226 964.944 154.359V95.7481C964.944 86.0925 961.343 82.884 952.953 83.0196C951.372 83.0497 950.046 81.8145 950.046 80.2178V78.2897C950.046 76.934 951.01 75.7892 952.336 75.5331L982.613 69.9145C989.361 68.7546 992.841 71.7824 992.841 77.1298C992.841 85.505 996.561 87.5988 999.589 84.1041C1004.47 78.2897 1013.31 68.9806 1031.69 68.9806C1048.91 68.9806 1066.11 77.3558 1066.11 108.748V156.197C1066.11 162.81 1068.87 166.169 1073.72 165.868C1075.37 165.762 1076.8 166.982 1076.8 168.654V168.73C1076.8 169.212 1076.7 169.694 1076.46 170.1C1073.22 175.674 1065.85 177.828 1059.13 177.828C1047.04 177.828 1038.2 171.08 1038.2 156.197L1038.21 156.227Z" fill="black" stroke="black" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M1082.63 125.061C1082.63 88.7735 1107.52 69.4775 1133.11 69.4775C1157.06 69.4775 1165.21 86.6948 1165.21 67.6096V50.1663C1165.21 40.5107 1161.61 37.3023 1153.22 37.4378C1151.64 37.468 1150.31 36.2328 1150.31 34.6361V32.708C1150.31 31.3523 1151.27 30.2074 1152.6 29.9514L1182.88 24.3328C1189.63 23.1729 1193.1 26.2006 1193.1 32.4669V156.212C1193.1 162.825 1195.86 166.184 1200.71 165.883C1202.37 165.777 1203.8 166.997 1203.8 168.669V168.745C1203.8 169.227 1203.69 169.709 1203.45 170.115C1200.21 175.689 1192.86 177.843 1186.36 177.843C1178.67 177.843 1170.77 174.815 1168.22 167.841C1166.82 164.12 1164.73 162.493 1162.18 162.493C1156.59 162.493 1148.46 177.843 1127.29 177.843C1104.04 177.843 1082.63 158.532 1082.63 125.046V125.061ZM1142.64 161.574C1152.64 161.574 1165.21 155.534 1165.21 135.289V117.62C1165.21 89.2405 1148.92 78.0786 1135.89 78.0786C1120.77 78.0786 1111.94 93.4281 1111.94 114.592C1111.94 139.718 1124.27 161.574 1142.64 161.574Z" fill="black" stroke="black" stroke-width="0.393644" stroke-miterlimit="10"/>-<path d="M1219.29 167.826C1218.9 167.539 1218.6 167.163 1218.39 166.726C1212.86 154.781 1212.35 141.103 1221.02 141.103C1224.28 141.103 1226.37 142.73 1227.53 146.225C1233.12 162.975 1242.88 169.483 1256.6 169.483C1272.19 169.483 1276.61 161.574 1276.61 154.133C1276.61 143.905 1267.07 140.636 1252.41 136.223C1233.57 130.408 1215.66 121.34 1215.66 101.095C1215.66 80.8501 1234.5 69.4623 1258.45 69.4623C1272.06 69.4623 1284.77 73.213 1292.72 78.7865C1293.13 79.0727 1293.46 79.4643 1293.67 79.9162C1299.19 91.8463 1299.68 105.268 1291.02 105.268C1287.77 105.268 1285.67 103.641 1284.51 100.146C1278.93 83.3958 1268.92 77.3554 1257.07 77.3554C1245.91 77.3554 1240.79 82.9439 1240.79 91.3041C1240.79 101.773 1249.63 106.895 1260.79 110.374C1277.54 115.496 1302.65 121.777 1302.65 145.035C1302.65 166.666 1280.33 177.828 1254.98 177.828C1240 177.828 1227.23 173.625 1219.28 167.795L1219.29 167.826Z" fill="black" stroke="black" stroke-width="0.393644" stroke-miterlimit="10"/>-<defs>-<clipPath id="clip0_14027_2415">-<rect width="294" height="196" fill="white"/>-</clipPath>-<clipPath id="clip1_14027_2415">-<rect width="294" height="196" fill="white"/>-</clipPath>-</defs>-</svg>diff --git a/docs/openapi.json b/docs/openapi.jsondeleted file mode 100644index d073f858ca..0000000000--- a/docs/openapi.json+++ /dev/null@@ -1,3942 +0,0 @@-{- "openapi": "3.1.0",- "info": {- "title": "OpenHands",- "description": "OpenHands: Code Less, Make More",- "version": "0.53.0"- },- "paths": {- "/api/options/models": {- "get": {- "summary": "List Supported Models",- "description": "List model identifiers available on this server based on configured providers.",- "operationId": "get_litellm_models_api_options_models_get",- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "items": {- "type": "string"- },- "type": "array",- "title": "Response Get Litellm Models Api Options Models Get"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- }- },- "/api/options/agents": {- "get": {- "summary": "List Agents",- "description": "List available agent types supported by this server.",- "operationId": "get_agents_api_options_agents_get",- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "items": {- "type": "string"- },- "type": "array",- "title": "Response Get Agents Api Options Agents Get"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- }- },- "/api/options/security-analyzers": {- "get": {- "summary": "List Security Analyzers",- "description": "List supported security analyzers.",- "operationId": "get_security_analyzers_api_options_security_analyzers_get",- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "items": {- "type": "string"- },- "type": "array",- "title": "Response Get Security Analyzers Api Options Security Analyzers Get"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- }- },- "/api/options/config": {- "get": {- "summary": "Get Config",- "description": "Get current config.",- "operationId": "get_config_api_options_config_get",- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "additionalProperties": true,- "type": "object",- "title": "Response Get Config Api Options Config Get"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- }- },- "/api/conversations/{conversation_id}/list-files": {- "get": {- "summary": "List Workspace Files",- "description": "List workspace files visible to the conversation runtime. Applies .gitignore and internal ignore rules.",- "operationId": "list_files_api_conversations__conversation_id__list_files_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- },- {- "name": "path",- "in": "query",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Path"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "type": "array",- "items": {- "type": "string"- },- "title": "Response List Files Api Conversations Conversation Id List Files Get"- }- }- }- },- "404": {- "description": "Runtime not initialized",- "content": {- "application/json": {- "schema": {- "type": "object",- "additionalProperties": true,- "title": "Response 404 List Files Api Conversations Conversation Id List Files Get"- }- }- }- },- "500": {- "description": "Error listing or filtering files",- "content": {- "application/json": {- "schema": {- "type": "object",- "additionalProperties": true,- "title": "Response 500 List Files Api Conversations Conversation Id List Files Get"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}/select-file": {- "get": {- "summary": "Get File Content",- "description": "Return the content of the given file from the conversation workspace.",- "operationId": "select_file_api_conversations__conversation_id__select_file_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- },- {- "name": "file",- "in": "query",- "required": true,- "schema": {- "type": "string",- "title": "File"- }- }- ],- "responses": {- "200": {- "description": "File content returned as JSON",- "content": {- "application/json": {- "schema": {- "type": "object",- "additionalProperties": {- "type": "string"- },- "title": "Response 200 Select File Api Conversations Conversation Id Select File Get"- }- }- }- },- "500": {- "description": "Error opening file",- "content": {- "application/json": {- "schema": {- "type": "object",- "additionalProperties": true,- "title": "Response 500 Select File Api Conversations Conversation Id Select File Get"- }- }- }- },- "415": {- "description": "Unsupported media type",- "content": {- "application/json": {- "schema": {- "type": "object",- "additionalProperties": true,- "title": "Response 415 Select File Api Conversations Conversation Id Select File Get"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}/zip-directory": {- "get": {- "summary": "Download Workspace Archive",- "operationId": "zip_current_workspace_api_conversations__conversation_id__zip_directory_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "responses": {- "200": {- "description": "Zipped workspace returned as FileResponse",- "content": {- "application/json": {- "schema": {}- }- }- },- "500": {- "description": "Error zipping workspace",- "content": {- "application/json": {- "schema": {- "type": "object",- "additionalProperties": true,- "title": "Response 500 Zip Current Workspace Api Conversations Conversation Id Zip Directory Get"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- },- "description": "Return a ZIP archive of the current conversation workspace."- }- },- "/api/conversations/{conversation_id}/git/changes": {- "get": {- "summary": "Git Changes",- "operationId": "git_changes_api_conversations__conversation_id__git_changes_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "type": "array",- "items": {- "type": "object",- "additionalProperties": {- "type": "string"- }- },- "title": "Response Git Changes Api Conversations Conversation Id Git Changes Get"- }- }- }- },- "404": {- "description": "Not a git repository",- "content": {- "application/json": {- "schema": {- "type": "object",- "additionalProperties": true,- "title": "Response 404 Git Changes Api Conversations Conversation Id Git Changes Get"- }- }- }- },- "500": {- "description": "Error getting changes",- "content": {- "application/json": {- "schema": {- "type": "object",- "additionalProperties": true,- "title": "Response 500 Git Changes Api Conversations Conversation Id Git Changes Get"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}/git/diff": {- "get": {- "summary": "Git Diff",- "operationId": "git_diff_api_conversations__conversation_id__git_diff_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- },- {- "name": "path",- "in": "query",- "required": true,- "schema": {- "type": "string",- "title": "Path"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "type": "object",- "additionalProperties": true,- "title": "Response Git Diff Api Conversations Conversation Id Git Diff Get"- }- }- }- },- "500": {- "description": "Error getting diff",- "content": {- "application/json": {- "schema": {- "type": "object",- "additionalProperties": true,- "title": "Response 500 Git Diff Api Conversations Conversation Id Git Diff Get"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}/upload-files": {- "post": {- "summary": "Upload Files",- "operationId": "upload_files_api_conversations__conversation_id__upload_files_post",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "requestBody": {- "required": true,- "content": {- "multipart/form-data": {- "schema": {- "$ref": "#/components/schemas/Body_upload_files_api_conversations__conversation_id__upload_files_post"- }- }- }- },- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/POSTUploadFilesModel"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}/submit-feedback": {- "post": {- "summary": "Submit Feedback",- "description": "Submit user feedback.\n\nThis function stores the provided feedback data.\n\nTo submit feedback:",- "operationId": "submit_feedback_api_conversations__conversation_id__submit_feedback_post",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {}- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}/config": {- "get": {- "summary": "Get Remote Runtime Config",- "description": "Retrieve the runtime configuration.\n\nCurrently, this is the session ID and runtime ID (if available).",- "operationId": "get_remote_runtime_config_api_conversations__conversation_id__config_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {}- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}/events": {- "get": {- "summary": "Search Events",- "description": "Search through the event stream with filtering and pagination.",- "operationId": "search_events_api_conversations__conversation_id__events_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- },- {- "name": "start_id",- "in": "query",- "required": false,- "schema": {- "type": "integer",- "default": 0,- "title": "Start Id"- }- },- {- "name": "end_id",- "in": "query",- "required": false,- "schema": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "title": "End Id"- }- },- {- "name": "reverse",- "in": "query",- "required": false,- "schema": {- "type": "boolean",- "default": false,- "title": "Reverse"- }- },- {- "name": "limit",- "in": "query",- "required": false,- "schema": {- "type": "integer",- "default": 20,- "title": "Limit"- }- }- ],- "requestBody": {- "content": {- "application/json": {- "schema": {- "anyOf": [- {- "$ref": "#/components/schemas/EventFilter"- },- {- "type": "null"- }- ],- "title": "Filter"- }- }- }- },- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {}- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- },- "post": {- "summary": "Add Event",- "operationId": "add_event_api_conversations__conversation_id__events_post",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {}- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}/microagents": {- "get": {- "summary": "Get Microagents",- "description": "Get all microagents associated with the conversation.\n\nThis endpoint returns all repository and knowledge microagents that are loaded for the conversation.",- "operationId": "get_microagents_api_conversations__conversation_id__microagents_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {}- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations": {- "post": {- "summary": "New Conversation",- "description": "Initialize a new session or join an existing one.\n\nAfter successful initialization, the client should connect to the WebSocket\nusing the returned conversation ID.",- "operationId": "new_conversation_api_conversations_post",- "security": [- {- "APIKeyHeader": []- }- ],- "requestBody": {- "required": true,- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/InitSessionRequest"- }- }- }- },- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ConversationResponse"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- },- "get": {- "summary": "Search Conversations",- "operationId": "search_conversations_api_conversations_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "page_id",- "in": "query",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Page Id"- }- },- {- "name": "limit",- "in": "query",- "required": false,- "schema": {- "type": "integer",- "default": 20,- "title": "Limit"- }- },- {- "name": "selected_repository",- "in": "query",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Selected Repository"- }- },- {- "name": "conversation_trigger",- "in": "query",- "required": false,- "schema": {- "anyOf": [- {- "$ref": "#/components/schemas/ConversationTrigger"- },- {- "type": "null"- }- ],- "title": "Conversation Trigger"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ConversationInfoResultSet"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}": {- "get": {- "summary": "Get Conversation",- "operationId": "get_conversation_api_conversations__conversation_id__get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "anyOf": [- {- "$ref": "#/components/schemas/ConversationInfo"- },- {- "type": "null"- }- ],- "title": "Response Get Conversation Api Conversations Conversation Id Get"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- },- "delete": {- "summary": "Delete Conversation",- "operationId": "delete_conversation_api_conversations__conversation_id__delete",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "type": "boolean",- "title": "Response Delete Conversation Api Conversations Conversation Id Delete"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- },- "patch": {- "summary": "Update Conversation",- "description": "Update conversation metadata.\n\nThis endpoint allows updating conversation details like title.\nOnly the conversation owner can update the conversation.",- "operationId": "update_conversation_api_conversations__conversation_id__patch",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "requestBody": {- "required": true,- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/UpdateConversationRequest"- }- }- }- },- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "type": "boolean",- "title": "Response Update Conversation Api Conversations Conversation Id Patch"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}/remember-prompt": {- "get": {- "summary": "Get Prompt",- "operationId": "get_prompt_api_conversations__conversation_id__remember_prompt_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- },- {- "name": "event_id",- "in": "query",- "required": true,- "schema": {- "type": "integer",- "title": "Event Id"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {}- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}/start": {- "post": {- "summary": "Start Conversation",- "description": "Start an agent loop for a conversation.\n\nThis endpoint calls the conversation_manager's maybe_start_agent_loop method\nto start a conversation. If the conversation is already running, it will\nreturn the existing agent loop info.",- "operationId": "start_conversation_api_conversations__conversation_id__start_post",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "requestBody": {- "required": true,- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ProvidersSetModel"- }- }- }- },- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ConversationResponse"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}/stop": {- "post": {- "summary": "Stop Conversation",- "description": "Stop an agent loop for a conversation.\n\nThis endpoint calls the conversation_manager's close_session method\nto stop a conversation.",- "operationId": "stop_conversation_api_conversations__conversation_id__stop_post",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ConversationResponse"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/settings": {- "get": {- "summary": "Load Settings",- "operationId": "load_settings_api_settings_get",- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GETSettingsModel"- }- }- }- },- "404": {- "description": "Settings not found",- "content": {- "application/json": {- "schema": {- "additionalProperties": true,- "type": "object",- "title": "Response 404 Load Settings Api Settings Get"- }- }- }- },- "401": {- "description": "Invalid token",- "content": {- "application/json": {- "schema": {- "additionalProperties": true,- "type": "object",- "title": "Response 401 Load Settings Api Settings Get"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- },- "post": {- "summary": "Store Settings",- "operationId": "store_settings_api_settings_post",- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/Settings"- }- }- },- "required": true- },- "responses": {- "200": {- "description": "Settings stored successfully",- "content": {- "application/json": {- "schema": {- "additionalProperties": true,- "type": "object",- "title": "Response 200 Store Settings Api Settings Post"- }- }- }- },- "500": {- "description": "Error storing settings",- "content": {- "application/json": {- "schema": {- "additionalProperties": true,- "type": "object",- "title": "Response 500 Store Settings Api Settings Post"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- }- },- "/api/reset-settings": {- "post": {- "summary": "Reset Settings",- "description": "Resets user settings. (Deprecated)",- "operationId": "reset_settings_api_reset_settings_post",- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {}- }- }- },- "410": {- "description": "Reset settings functionality has been removed",- "content": {- "application/json": {- "schema": {- "additionalProperties": true,- "type": "object",- "title": "Response 410 Reset Settings Api Reset Settings Post"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- }- },- "/api/add-git-providers": {- "post": {- "summary": "Store Provider Tokens",- "operationId": "store_provider_tokens_api_add_git_providers_post",- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/POSTProviderModel"- }- }- },- "required": true- },- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {}- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- }- },- "/api/unset-provider-tokens": {- "post": {- "summary": "Unset Provider Tokens",- "operationId": "unset_provider_tokens_api_unset_provider_tokens_post",- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "additionalProperties": {- "type": "string"- },- "type": "object",- "title": "Response Unset Provider Tokens Api Unset Provider Tokens Post"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- }- },- "/api/secrets": {- "get": {- "summary": "Load Custom Secrets Names",- "operationId": "load_custom_secrets_names_api_secrets_get",- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GETCustomSecrets"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- },- "post": {- "summary": "Create Custom Secret",- "operationId": "create_custom_secret_api_secrets_post",- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CustomSecretModel"- }- }- },- "required": true- },- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "additionalProperties": {- "type": "string"- },- "type": "object",- "title": "Response Create Custom Secret Api Secrets Post"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- }- },- "/api/secrets/{secret_id}": {- "put": {- "summary": "Update Custom Secret",- "operationId": "update_custom_secret_api_secrets__secret_id__put",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "secret_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Secret Id"- }- }- ],- "requestBody": {- "required": true,- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CustomSecretWithoutValueModel"- }- }- }- },- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "type": "object",- "additionalProperties": {- "type": "string"- },- "title": "Response Update Custom Secret Api Secrets Secret Id Put"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- },- "delete": {- "summary": "Delete Custom Secret",- "operationId": "delete_custom_secret_api_secrets__secret_id__delete",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "secret_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Secret Id"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {}- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/user/installations": {- "get": {- "summary": "Get User Installations",- "operationId": "get_user_installations_api_user_installations_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "provider",- "in": "query",- "required": true,- "schema": {- "$ref": "#/components/schemas/ProviderType"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "type": "array",- "items": {- "type": "string"- },- "title": "Response Get User Installations Api User Installations Get"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/user/repositories": {- "get": {- "summary": "Get User Repositories",- "operationId": "get_user_repositories_api_user_repositories_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "sort",- "in": "query",- "required": false,- "schema": {- "type": "string",- "default": "pushed",- "title": "Sort"- }- },- {- "name": "selected_provider",- "in": "query",- "required": false,- "schema": {- "anyOf": [- {- "$ref": "#/components/schemas/ProviderType"- },- {- "type": "null"- }- ],- "title": "Selected Provider"- }- },- {- "name": "page",- "in": "query",- "required": false,- "schema": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "title": "Page"- }- },- {- "name": "per_page",- "in": "query",- "required": false,- "schema": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "title": "Per Page"- }- },- {- "name": "installation_id",- "in": "query",- "required": false,- "schema": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Installation Id"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "type": "array",- "items": {- "$ref": "#/components/schemas/Repository"- },- "title": "Response Get User Repositories Api User Repositories Get"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/user/info": {- "get": {- "summary": "Get User",- "operationId": "get_user_api_user_info_get",- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/User"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- }- },- "/api/user/search/repositories": {- "get": {- "summary": "Search Repositories",- "operationId": "search_repositories_api_user_search_repositories_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "query",- "in": "query",- "required": true,- "schema": {- "type": "string",- "title": "Query"- }- },- {- "name": "per_page",- "in": "query",- "required": false,- "schema": {- "type": "integer",- "default": 5,- "title": "Per Page"- }- },- {- "name": "sort",- "in": "query",- "required": false,- "schema": {- "type": "string",- "default": "stars",- "title": "Sort"- }- },- {- "name": "order",- "in": "query",- "required": false,- "schema": {- "type": "string",- "default": "desc",- "title": "Order"- }- },- {- "name": "selected_provider",- "in": "query",- "required": false,- "schema": {- "anyOf": [- {- "$ref": "#/components/schemas/ProviderType"- },- {- "type": "null"- }- ],- "title": "Selected Provider"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "type": "array",- "items": {- "$ref": "#/components/schemas/Repository"- },- "title": "Response Search Repositories Api User Search Repositories Get"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/user/suggested-tasks": {- "get": {- "summary": "Get Suggested Tasks",- "description": "Get suggested tasks for the authenticated user across their most recently pushed repositories.",- "operationId": "get_suggested_tasks_api_user_suggested_tasks_get",- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "items": {- "$ref": "#/components/schemas/SuggestedTask"- },- "type": "array",- "title": "Response Get Suggested Tasks Api User Suggested Tasks Get"- }- }- }- }- },- "security": [- {- "APIKeyHeader": []- }- ]- }- },- "/api/user/repository/branches": {- "get": {- "summary": "Get Repository Branches",- "description": "Get branches for a repository.",- "operationId": "get_repository_branches_api_user_repository_branches_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "repository",- "in": "query",- "required": true,- "schema": {- "type": "string",- "title": "Repository"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "type": "array",- "items": {- "$ref": "#/components/schemas/Branch"- },- "title": "Response Get Repository Branches Api User Repository Branches Get"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/user/repository/{repository_name}/microagents": {- "get": {- "summary": "Get Repository Microagents",- "description": "Scan the microagents directory of a repository and return the list of microagents.\n\nThe microagents directory location depends on the git provider and actual repository name:\n- If git provider is not GitLab and actual repository name is \".openhands\": scans \"microagents\" folder\n- If git provider is GitLab and actual repository name is \"openhands-config\": scans \"microagents\" folder\n- Otherwise: scans \".openhands/microagents\" folder",- "operationId": "get_repository_microagents_api_user_repository__repository_name__microagents_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "repository_name",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Repository Name"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "type": "array",- "items": {- "$ref": "#/components/schemas/MicroagentResponse"- },- "title": "Response Get Repository Microagents Api User Repository Repository Name Microagents Get"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/user/repository/{repository_name}/microagents/content": {- "get": {- "summary": "Get Repository Microagent Content",- "description": "Fetch the content of a specific microagent file from a repository.",- "operationId": "get_repository_microagent_content_api_user_repository__repository_name__microagents_content_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "repository_name",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Repository Name"- }- },- {- "name": "file_path",- "in": "query",- "required": true,- "schema": {- "type": "string",- "description": "Path to the microagent file within the repository",- "title": "File Path"- },- "description": "Path to the microagent file within the repository"- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/MicroagentContentResponse"- }- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/api/conversations/{conversation_id}/trajectory": {- "get": {- "summary": "Get Trajectory",- "description": "Get trajectory.\n\nThis function retrieves the current trajectory and returns it.",- "operationId": "get_trajectory_api_conversations__conversation_id__trajectory_get",- "security": [- {- "APIKeyHeader": []- }- ],- "parameters": [- {- "name": "conversation_id",- "in": "path",- "required": true,- "schema": {- "type": "string",- "title": "Conversation Id"- }- }- ],- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {}- }- }- },- "422": {- "description": "Validation Error",- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/HTTPValidationError"- }- }- }- }- }- }- },- "/alive": {- "get": {- "summary": "Alive",- "operationId": "alive_alive_get",- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {}- }- }- }- }- }- },- "/health": {- "get": {- "summary": "Health",- "operationId": "health_health_get",- "responses": {- "200": {- "description": "Successful Response",- "content": {- "application/json": {- "schema": {- "type": "string",- "title": "Response Health Health Get"- }- }- }- }- }- }- }- },- "components": {- "schemas": {- "Body_upload_files_api_conversations__conversation_id__upload_files_post": {- "properties": {- "files": {- "items": {- "type": "string",- "format": "binary"- },- "type": "array",- "title": "Files"- }- },- "type": "object",- "required": [- "files"- ],- "title": "Body_upload_files_api_conversations__conversation_id__upload_files_post"- },- "Branch": {- "properties": {- "name": {- "type": "string",- "title": "Name"- },- "commit_sha": {- "type": "string",- "title": "Commit Sha"- },- "protected": {- "type": "boolean",- "title": "Protected"- },- "last_push_date": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Last Push Date"- }- },- "type": "object",- "required": [- "name",- "commit_sha",- "protected"- ],- "title": "Branch"- },- "ConversationInfo": {- "properties": {- "conversation_id": {- "type": "string",- "title": "Conversation Id"- },- "title": {- "type": "string",- "title": "Title"- },- "last_updated_at": {- "anyOf": [- {- "type": "string",- "format": "date-time"- },- {- "type": "null"- }- ],- "title": "Last Updated At"- },- "status": {- "$ref": "#/components/schemas/ConversationStatus",- "default": "STOPPED"- },- "runtime_status": {- "anyOf": [- {- "$ref": "#/components/schemas/RuntimeStatus"- },- {- "type": "null"- }- ]- },- "selected_repository": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Selected Repository"- },- "selected_branch": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Selected Branch"- },- "git_provider": {- "anyOf": [- {- "$ref": "#/components/schemas/ProviderType"- },- {- "type": "null"- }- ]- },- "trigger": {- "anyOf": [- {- "$ref": "#/components/schemas/ConversationTrigger"- },- {- "type": "null"- }- ]- },- "num_connections": {- "type": "integer",- "title": "Num Connections",- "default": 0- },- "url": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Url"- },- "session_api_key": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Session Api Key"- },- "created_at": {- "type": "string",- "format": "date-time",- "title": "Created At"- },- "pr_number": {- "items": {- "type": "integer"- },- "type": "array",- "title": "Pr Number"- }- },- "type": "object",- "required": [- "conversation_id",- "title"- ],- "title": "ConversationInfo"- },- "ConversationInfoResultSet": {- "properties": {- "results": {- "items": {- "$ref": "#/components/schemas/ConversationInfo"- },- "type": "array",- "title": "Results"- },- "next_page_id": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Next Page Id"- }- },- "type": "object",- "title": "ConversationInfoResultSet"- },- "ConversationResponse": {- "properties": {- "status": {- "type": "string",- "title": "Status"- },- "conversation_id": {- "type": "string",- "title": "Conversation Id"- },- "message": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Message"- },- "conversation_status": {- "anyOf": [- {- "$ref": "#/components/schemas/ConversationStatus"- },- {- "type": "null"- }- ]- }- },- "type": "object",- "required": [- "status",- "conversation_id"- ],- "title": "ConversationResponse"- },- "ConversationStatus": {- "type": "string",- "enum": [- "STARTING",- "RUNNING",- "STOPPED"- ],- "title": "ConversationStatus"- },- "ConversationTrigger": {- "type": "string",- "enum": [- "resolver",- "gui",- "suggested_task",- "openhands_api",- "slack",- "microagent_management",- "jira",- "jira_dc",- "linear"- ],- "title": "ConversationTrigger"- },- "CreateMicroagent": {- "properties": {- "repo": {- "type": "string",- "title": "Repo"- },- "git_provider": {- "anyOf": [- {- "$ref": "#/components/schemas/ProviderType"- },- {- "type": "null"- }- ]- },- "title": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Title"- }- },- "type": "object",- "required": [- "repo"- ],- "title": "CreateMicroagent"- },- "CustomSecretModel": {- "properties": {- "name": {- "type": "string",- "title": "Name"- },- "description": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Description"- },- "value": {- "type": "string",- "format": "password",- "title": "Value",- "writeOnly": true- }- },- "type": "object",- "required": [- "name",- "value"- ],- "title": "CustomSecretModel",- "description": "Custom secret model with value"- },- "CustomSecretWithoutValueModel": {- "properties": {- "name": {- "type": "string",- "title": "Name"- },- "description": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Description"- }- },- "type": "object",- "required": [- "name"- ],- "title": "CustomSecretWithoutValueModel",- "description": "Custom secret model without value"- },- "EventFilter": {- "properties": {- "exclude_hidden": {- "type": "boolean",- "title": "Exclude Hidden",- "default": false- },- "query": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Query"- },- "include_types": {- "anyOf": [- {- "items": {},- "type": "array"- },- {- "type": "null"- }- ],- "title": "Include Types"- },- "exclude_types": {- "anyOf": [- {- "items": {},- "type": "array"- },- {- "type": "null"- }- ],- "title": "Exclude Types"- },- "source": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Source"- },- "start_date": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Start Date"- },- "end_date": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "End Date"- }- },- "type": "object",- "title": "EventFilter"- },- "ExperimentConfig": {- "properties": {- "config": {- "anyOf": [- {- "additionalProperties": {- "type": "string"- },- "type": "object"- },- {- "type": "null"- }- ],- "title": "Config"- }- },- "type": "object",- "title": "ExperimentConfig"- },- "GETCustomSecrets": {- "properties": {- "custom_secrets": {- "anyOf": [- {- "items": {- "$ref": "#/components/schemas/CustomSecretWithoutValueModel"- },- "type": "array"- },- {- "type": "null"- }- ],- "title": "Custom Secrets"- }- },- "type": "object",- "title": "GETCustomSecrets",- "description": "Custom secrets names"- },- "GETSettingsModel": {- "properties": {- "language": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Language"- },- "agent": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Agent"- },- "max_iterations": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "title": "Max Iterations"- },- "security_analyzer": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Security Analyzer"- },- "confirmation_mode": {- "anyOf": [- {- "type": "boolean"- },- {- "type": "null"- }- ],- "title": "Confirmation Mode"- },- "llm_model": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Llm Model"- },- "llm_api_key": {- "anyOf": [- {- "type": "string",- "format": "password",- "writeOnly": true- },- {- "type": "null"- }- ],- "title": "Llm Api Key"- },- "llm_base_url": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Llm Base Url"- },- "remote_runtime_resource_factor": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "title": "Remote Runtime Resource Factor"- },- "secrets_store": {- "$ref": "#/components/schemas/UserSecrets-Output"- },- "enable_default_condenser": {- "type": "boolean",- "title": "Enable Default Condenser",- "default": true- },- "enable_sound_notifications": {- "type": "boolean",- "title": "Enable Sound Notifications",- "default": false- },- "enable_proactive_conversation_starters": {- "type": "boolean",- "title": "Enable Proactive Conversation Starters",- "default": true- },- "enable_solvability_analysis": {- "type": "boolean",- "title": "Enable Solvability Analysis",- "default": true- },- "user_consents_to_analytics": {- "anyOf": [- {- "type": "boolean"- },- {- "type": "null"- }- ],- "title": "User Consents To Analytics"- },- "sandbox_base_container_image": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Sandbox Base Container Image"- },- "sandbox_runtime_container_image": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Sandbox Runtime Container Image"- },- "mcp_config": {- "anyOf": [- {- "$ref": "#/components/schemas/MCPConfig"- },- {- "type": "null"- }- ]- },- "search_api_key": {- "anyOf": [- {- "type": "string",- "format": "password",- "writeOnly": true- },- {- "type": "null"- }- ],- "title": "Search Api Key"- },- "sandbox_api_key": {- "anyOf": [- {- "type": "string",- "format": "password",- "writeOnly": true- },- {- "type": "null"- }- ],- "title": "Sandbox Api Key"- },- "max_budget_per_task": {- "anyOf": [- {- "type": "number"- },- {- "type": "null"- }- ],- "title": "Max Budget Per Task"- },- "email": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Email"- },- "email_verified": {- "anyOf": [- {- "type": "boolean"- },- {- "type": "null"- }- ],- "title": "Email Verified"- },- "git_user_name": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Git User Name"- },- "git_user_email": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Git User Email"- },- "provider_tokens_set": {- "anyOf": [- {- "additionalProperties": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ]- },- "propertyNames": {- "$ref": "#/components/schemas/ProviderType"- },- "type": "object"- },- {- "type": "null"- }- ],- "title": "Provider Tokens Set"- },- "llm_api_key_set": {- "type": "boolean",- "title": "Llm Api Key Set"- },- "search_api_key_set": {- "type": "boolean",- "title": "Search Api Key Set",- "default": false- }- },- "type": "object",- "required": [- "llm_api_key_set"- ],- "title": "GETSettingsModel",- "description": "Settings with additional token data for the frontend"- },- "HTTPValidationError": {- "properties": {- "detail": {- "items": {- "$ref": "#/components/schemas/ValidationError"- },- "type": "array",- "title": "Detail"- }- },- "type": "object",- "title": "HTTPValidationError"- },- "InitSessionRequest": {- "properties": {- "repository": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Repository"- },- "git_provider": {- "anyOf": [- {- "$ref": "#/components/schemas/ProviderType"- },- {- "type": "null"- }- ]- },- "selected_branch": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Selected Branch"- },- "initial_user_msg": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Initial User Msg"- },- "image_urls": {- "anyOf": [- {- "items": {- "type": "string"- },- "type": "array"- },- {- "type": "null"- }- ],- "title": "Image Urls"- },- "replay_json": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Replay Json"- },- "suggested_task": {- "anyOf": [- {- "$ref": "#/components/schemas/SuggestedTask"- },- {- "type": "null"- }- ]- },- "create_microagent": {- "anyOf": [- {- "$ref": "#/components/schemas/CreateMicroagent"- },- {- "type": "null"- }- ]- },- "conversation_instructions": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Conversation Instructions"- },- "mcp_config": {- "anyOf": [- {- "$ref": "#/components/schemas/MCPConfig"- },- {- "type": "null"- }- ]- },- "conversation_id": {- "type": "string",- "title": "Conversation Id"- }- },- "additionalProperties": false,- "type": "object",- "title": "InitSessionRequest"- },- "MCPConfig": {- "properties": {- "sse_servers": {- "items": {- "$ref": "#/components/schemas/MCPSSEServerConfig"- },- "type": "array",- "title": "Sse Servers"- },- "stdio_servers": {- "items": {- "$ref": "#/components/schemas/MCPStdioServerConfig"- },- "type": "array",- "title": "Stdio Servers"- },- "shttp_servers": {- "items": {- "$ref": "#/components/schemas/MCPSHTTPServerConfig"- },- "type": "array",- "title": "Shttp Servers"- }- },- "additionalProperties": false,- "type": "object",- "title": "MCPConfig",- "description": "Configuration for MCP (Message Control Protocol) settings.\n\nAttributes:\n sse_servers: List of MCP SSE server configs\n stdio_servers: List of MCP stdio server configs. These servers will be added to the MCP Router running inside runtime container.\n shttp_servers: List of MCP HTTP server configs."- },- "MCPSHTTPServerConfig": {- "properties": {- "url": {- "type": "string",- "title": "Url"- },- "api_key": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Api Key"- }- },- "type": "object",- "required": [- "url"- ],- "title": "MCPSHTTPServerConfig"- },- "MCPSSEServerConfig": {- "properties": {- "url": {- "type": "string",- "title": "Url"- },- "api_key": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Api Key"- }- },- "type": "object",- "required": [- "url"- ],- "title": "MCPSSEServerConfig",- "description": "Configuration for a single MCP server.\n\nAttributes:\n url: The server URL\n api_key: Optional API key for authentication"- },- "MCPStdioServerConfig": {- "properties": {- "name": {- "type": "string",- "title": "Name"- },- "command": {- "type": "string",- "title": "Command"- },- "args": {- "items": {- "type": "string"- },- "type": "array",- "title": "Args"- },- "env": {- "additionalProperties": {- "type": "string"- },- "type": "object",- "title": "Env"- }- },- "type": "object",- "required": [- "name",- "command"- ],- "title": "MCPStdioServerConfig",- "description": "Configuration for a MCP server that uses stdio.\n\nAttributes:\n name: The name of the server\n command: The command to run the server\n args: The arguments to pass to the server\n env: The environment variables to set for the server"- },- "MicroagentContentResponse": {- "properties": {- "content": {- "type": "string",- "title": "Content"- },- "path": {- "type": "string",- "title": "Path"- },- "triggers": {- "items": {- "type": "string"- },- "type": "array",- "title": "Triggers",- "default": []- },- "git_provider": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Git Provider"- }- },- "type": "object",- "required": [- "content",- "path"- ],- "title": "MicroagentContentResponse",- "description": "Response model for individual microagent content endpoint."- },- "MicroagentResponse": {- "properties": {- "name": {- "type": "string",- "title": "Name"- },- "path": {- "type": "string",- "title": "Path"- },- "created_at": {- "type": "string",- "format": "date-time",- "title": "Created At"- }- },- "type": "object",- "required": [- "name",- "path",- "created_at"- ],- "title": "MicroagentResponse",- "description": "Response model for microagents endpoint.\n\nNote: This model only includes basic metadata that can be determined\nwithout parsing microagent content. Use the separate content API\nto get detailed microagent information."- },- "OwnerType": {- "type": "string",- "enum": [- "user",- "organization"- ],- "title": "OwnerType"- },- "POSTProviderModel": {- "properties": {- "mcp_config": {- "anyOf": [- {- "$ref": "#/components/schemas/MCPConfig"- },- {- "type": "null"- }- ]- },- "provider_tokens": {- "additionalProperties": {- "$ref": "#/components/schemas/ProviderToken"- },- "propertyNames": {- "$ref": "#/components/schemas/ProviderType"- },- "type": "object",- "title": "Provider Tokens",- "default": {}- }- },- "type": "object",- "title": "POSTProviderModel",- "description": "Settings for POST requests"- },- "POSTUploadFilesModel": {- "properties": {- "file_urls": {- "items": {- "type": "string"- },- "type": "array",- "title": "File Urls"- },- "skipped_files": {- "items": {- "type": "string"- },- "type": "array",- "title": "Skipped Files"- }- },- "type": "object",- "required": [- "file_urls",- "skipped_files"- ],- "title": "POSTUploadFilesModel",- "description": "Upload files response model"- },- "ProviderToken": {- "properties": {- "token": {- "anyOf": [- {- "type": "string",- "format": "password",- "writeOnly": true- },- {- "type": "null"- }- ],- "title": "Token"- },- "user_id": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "User Id"- },- "host": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Host"- }- },- "type": "object",- "title": "ProviderToken"- },- "ProviderType": {- "type": "string",- "enum": [- "github",- "gitlab",- "bitbucket",- "enterprise_sso"- ],- "title": "ProviderType"- },- "ProvidersSetModel": {- "properties": {- "providers_set": {- "anyOf": [- {- "items": {- "$ref": "#/components/schemas/ProviderType"- },- "type": "array"- },- {- "type": "null"- }- ],- "title": "Providers Set"- }- },- "type": "object",- "title": "ProvidersSetModel"- },- "Repository": {- "properties": {- "id": {- "type": "string",- "title": "Id"- },- "full_name": {- "type": "string",- "title": "Full Name"- },- "git_provider": {- "$ref": "#/components/schemas/ProviderType"- },- "is_public": {- "type": "boolean",- "title": "Is Public"- },- "stargazers_count": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "title": "Stargazers Count"- },- "link_header": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Link Header"- },- "pushed_at": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Pushed At"- },- "owner_type": {- "anyOf": [- {- "$ref": "#/components/schemas/OwnerType"- },- {- "type": "null"- }- ]- },- "main_branch": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Main Branch"- }- },- "type": "object",- "required": [- "id",- "full_name",- "git_provider",- "is_public"- ],- "title": "Repository"- },- "RuntimeStatus": {- "type": "string",- "enum": [- "STATUS$STOPPED",- "STATUS$BUILDING_RUNTIME",- "STATUS$STARTING_RUNTIME",- "STATUS$RUNTIME_STARTED",- "STATUS$SETTING_UP_WORKSPACE",- "STATUS$SETTING_UP_GIT_HOOKS",- "STATUS$READY",- "STATUS$ERROR",- "STATUS$ERROR_RUNTIME_DISCONNECTED",- "STATUS$ERROR_LLM_AUTHENTICATION",- "STATUS$ERROR_LLM_SERVICE_UNAVAILABLE",- "STATUS$ERROR_LLM_INTERNAL_SERVER_ERROR",- "STATUS$ERROR_LLM_OUT_OF_CREDITS",- "STATUS$ERROR_LLM_CONTENT_POLICY_VIOLATION",- "CHAT_INTERFACE$AGENT_RATE_LIMITED_STOPPED_MESSAGE",- "STATUS$GIT_PROVIDER_AUTHENTICATION_ERROR",- "STATUS$LLM_RETRY",- "STATUS$ERROR_MEMORY"- ],- "title": "RuntimeStatus"- },- "Settings": {- "properties": {- "language": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Language"- },- "agent": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Agent"- },- "max_iterations": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "title": "Max Iterations"- },- "security_analyzer": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Security Analyzer"- },- "confirmation_mode": {- "anyOf": [- {- "type": "boolean"- },- {- "type": "null"- }- ],- "title": "Confirmation Mode"- },- "llm_model": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Llm Model"- },- "llm_api_key": {- "anyOf": [- {- "type": "string",- "format": "password",- "writeOnly": true- },- {- "type": "null"- }- ],- "title": "Llm Api Key"- },- "llm_base_url": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Llm Base Url"- },- "remote_runtime_resource_factor": {- "anyOf": [- {- "type": "integer"- },- {- "type": "null"- }- ],- "title": "Remote Runtime Resource Factor"- },- "secrets_store": {- "$ref": "#/components/schemas/UserSecrets-Input"- },- "enable_default_condenser": {- "type": "boolean",- "title": "Enable Default Condenser",- "default": true- },- "enable_sound_notifications": {- "type": "boolean",- "title": "Enable Sound Notifications",- "default": false- },- "enable_proactive_conversation_starters": {- "type": "boolean",- "title": "Enable Proactive Conversation Starters",- "default": true- },- "enable_solvability_analysis": {- "type": "boolean",- "title": "Enable Solvability Analysis",- "default": true- },- "user_consents_to_analytics": {- "anyOf": [- {- "type": "boolean"- },- {- "type": "null"- }- ],- "title": "User Consents To Analytics"- },- "sandbox_base_container_image": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Sandbox Base Container Image"- },- "sandbox_runtime_container_image": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Sandbox Runtime Container Image"- },- "mcp_config": {- "anyOf": [- {- "$ref": "#/components/schemas/MCPConfig"- },- {- "type": "null"- }- ]- },- "search_api_key": {- "anyOf": [- {- "type": "string",- "format": "password",- "writeOnly": true- },- {- "type": "null"- }- ],- "title": "Search Api Key"- },- "sandbox_api_key": {- "anyOf": [- {- "type": "string",- "format": "password",- "writeOnly": true- },- {- "type": "null"- }- ],- "title": "Sandbox Api Key"- },- "max_budget_per_task": {- "anyOf": [- {- "type": "number"- },- {- "type": "null"- }- ],- "title": "Max Budget Per Task"- },- "email": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Email"- },- "email_verified": {- "anyOf": [- {- "type": "boolean"- },- {- "type": "null"- }- ],- "title": "Email Verified"- },- "git_user_name": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Git User Name"- },- "git_user_email": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Git User Email"- }- },- "type": "object",- "title": "Settings",- "description": "Persisted settings for OpenHands sessions"- },- "SuggestedTask": {- "properties": {- "git_provider": {- "$ref": "#/components/schemas/ProviderType"- },- "task_type": {- "$ref": "#/components/schemas/TaskType"- },- "repo": {- "type": "string",- "title": "Repo"- },- "issue_number": {- "type": "integer",- "title": "Issue Number"- },- "title": {- "type": "string",- "title": "Title"- }- },- "type": "object",- "required": [- "git_provider",- "task_type",- "repo",- "issue_number",- "title"- ],- "title": "SuggestedTask"- },- "TaskType": {- "type": "string",- "enum": [- "MERGE_CONFLICTS",- "FAILING_CHECKS",- "UNRESOLVED_COMMENTS",- "OPEN_ISSUE",- "OPEN_PR",- "CREATE_MICROAGENT"- ],- "title": "TaskType"- },- "UpdateConversationRequest": {- "properties": {- "title": {- "type": "string",- "maxLength": 200,- "minLength": 1,- "title": "Title",- "description": "New conversation title"- }- },- "additionalProperties": false,- "type": "object",- "required": [- "title"- ],- "title": "UpdateConversationRequest",- "description": "Request model for updating conversation metadata."- },- "User": {- "properties": {- "id": {- "type": "string",- "title": "Id"- },- "login": {- "type": "string",- "title": "Login"- },- "avatar_url": {- "type": "string",- "title": "Avatar Url"- },- "company": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Company"- },- "name": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Name"- },- "email": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "title": "Email"- }- },- "type": "object",- "required": [- "id",- "login",- "avatar_url"- ],- "title": "User"- },- "UserSecrets-Input": {- "properties": {- "provider_tokens": {- "additionalProperties": {- "type": "string"- },- "type": "object",- "title": "Provider Tokens"- },- "custom_secrets": {- "additionalProperties": {- "type": "string"- },- "type": "object",- "title": "Custom Secrets"- }- },- "type": "object",- "title": "UserSecrets"- },- "UserSecrets-Output": {- "properties": {- "provider_tokens": {- "additionalProperties": {- "additionalProperties": {- "anyOf": [- {- "type": "string"- },- {}- ]- },- "type": "object"- },- "type": "object",- "title": "Provider Tokens"- },- "custom_secrets": {- "additionalProperties": {- "type": "string"- },- "type": "object",- "title": "Custom Secrets"- }- },- "type": "object",- "title": "UserSecrets"- },- "ValidationError": {- "properties": {- "loc": {- "items": {- "anyOf": [- {- "type": "string"- },- {- "type": "integer"- }- ]- },- "type": "array",- "title": "Location"- },- "msg": {- "type": "string",- "title": "Message"- },- "type": {- "type": "string",- "title": "Error Type"- }- },- "type": "object",- "required": [- "loc",- "msg",- "type"- ],- "title": "ValidationError"- }- },- "securitySchemes": {- "APIKeyHeader": {- "type": "apiKey",- "in": "header",- "name": "X-Session-API-Key"- }- }- },- "servers": [- {- "url": "https://app.all-hands.dev",- "description": "Production server"- },- {- "url": "http://localhost:3000",- "description": "Local development server"- }- ]-}\ No newline at end of filediff --git a/docs/reo-init.js b/docs/reo-init.jsdeleted file mode 100644index 9559ed0d55..0000000000--- a/docs/reo-init.js+++ /dev/null@@ -1,14 +0,0 @@-// Reo.dev tracking initialization-(function() {- var e, t, n;- e = "6bac7145b4ee6ec";- t = function() {- Reo.init({clientID: "6bac7145b4ee6ec"});- };- n = document.createElement("script");- n.src = "https://static.reo.dev/" + e + "/reo.js";- n.defer = true;- n.onload = t;- document.head.appendChild(n);-})();-diff --git a/docs/static/img/backend_architecture.png b/docs/static/img/backend_architecture.pngdeleted file mode 100644index 2cc41a3e67..0000000000Binary files a/docs/static/img/backend_architecture.png and /dev/null differdiff --git a/docs/static/img/backend_architecture.puml b/docs/static/img/backend_architecture.pumldeleted file mode 100644index c96651ab46..0000000000--- a/docs/static/img/backend_architecture.puml+++ /dev/null@@ -1,201 +0,0 @@-@startuml openhands-!pragma useIntermediatePackages false--class openhands.action.agent.AgentEchoAction {- content: str- runnable: bool- action: str-}-class openhands.action.agent.AgentFinishAction {- runnable: bool- action: str-}-class openhands.observation.AgentMessageObservation {- role: str- observation: str-}-class openhands.action.agent.AgentSummarizeAction {- summary: str- action: str-}-class openhands.action.agent.AgentThinkAction {- thought: str- runnable: bool- action: str-}-class openhands.action.base.ExecutableAction {-}-class openhands.action.base.NotExecutableAction {-}-class openhands.observation.Observation {- content: str-}-class openhands.action.base.Action {-}-class openhands.action.base.NullAction {- action: str-}-class openhands.action.bash.CmdRunAction {- command: str- action: str-}-class openhands.action.browse.BrowseURLAction {- url: str- action: str-}-class openhands.observation.BrowserOutputObservation {- url: str- status_code: int- error: bool- observation: str-}-class openhands.action.fileop.FileReadAction {- path: str- action: str-}-class openhands.observation.FileReadObservation {- path: str- observation: str-}-class openhands.action.fileop.FileWriteAction {- path: str- contents: str- action: str-}-class openhands.observation.FileWriteObservation {- path: str- observation: str-}-class openhands.action.tasks.AddTaskAction {- parent: str- goal: str- subtasks: list- action: str-}-class openhands.action.tasks.ModifyTaskAction {- id: str- state: str- action: str-}-abstract class openhands.agent.Agent {- _registry: Dict[str, Type[Agent]] {static}- llm: LLM- _complete: None-}-class openhands.llm.llm.LLM {- model: None- api_key: None- base_url: None- _debug_dir: None- _debug_idx: None- _debug_id: None- _completion: None-}-class openhands.controller.agent_controller.AgentController {- agent: Agent- max_iterations: int- workdir: str- command_manager: CommandManager- state: State- plan: Plan- callbacks: List[Callable]-}-class openhands.observation.AgentErrorObservation {- observation: str-}-class openhands.controller.command_manager.CommandManager {- directory: None- shell: None-}-class openhands.observation.NullObservation {- observation: str-}-class openhands.plan.Plan {- main_goal: str {static}- task: Task {static}- main_goal: str- task: None-}-class openhands.state.State {- plan: Plan- iteration: int- history: List[Tuple[Action, Observation]]- updated_info: List[Tuple[Action, Observation]]-}-class openhands.observation.CmdOutputObservation {- command: str- exit_code: int- observation: str-}-class openhands.sandbox.sandbox.DockerInteractive {- instance_id: None- instance_id: None- workspace_dir: None- workspace_dir: None- workspace_dir: None- timeout: int- base_container_image: None- container_name: None-}-class openhands.observation.UserMessageObservation {- role: str- observation: str-}-class openhands.plan.Task {- id: str {static}- goal: str {static}- parent: Task | None {static}- subtasks: List[Task] {static}- id: None- id: None- parent: None- goal: str- subtasks: None-}--class openhands.server.session.Session {- websocket: None- controller: Optional[AgentController]- agent: Optional[Agent]- agent_task: None-}--openhands.action.base.ExecutableAction <|-- openhands.action.agent.AgentEchoAction-openhands.action.base.NotExecutableAction <|-- openhands.action.agent.AgentFinishAction-openhands.observation.Observation <|-- openhands.observation.AgentMessageObservation-openhands.action.base.NotExecutableAction <|-- openhands.action.agent.AgentSummarizeAction-openhands.action.base.NotExecutableAction <|-- openhands.action.agent.AgentThinkAction-openhands.action.base.Action <|-- openhands.action.base.ExecutableAction-openhands.action.base.Action <|-- openhands.action.base.NotExecutableAction-openhands.action.base.NotExecutableAction <|-- openhands.action.base.NullAction-openhands.action.base.ExecutableAction <|-- openhands.action.bash.CmdRunAction-openhands.action.base.ExecutableAction <|-- openhands.action.browse.BrowseURLAction-openhands.observation.Observation <|-- openhands.observation.BrowserOutputObservation-openhands.action.base.ExecutableAction <|-- openhands.action.fileop.FileReadAction-openhands.observation.Observation <|-- openhands.observation.FileReadObservation-openhands.action.base.ExecutableAction <|-- openhands.action.fileop.FileWriteAction-openhands.observation.Observation <|-- openhands.observation.FileWriteObservation-openhands.action.base.NotExecutableAction <|-- openhands.action.tasks.AddTaskAction-openhands.action.base.NotExecutableAction <|-- openhands.action.tasks.ModifyTaskAction-openhands.agent.Agent *-- openhands.agent.Agent-openhands.agent.Agent *-- openhands.llm.llm.LLM-openhands.controller.agent_controller.AgentController *-- openhands.agent.Agent-openhands.observation.Observation <|-- openhands.observation.AgentErrorObservation-openhands.observation.Observation <|-- openhands.observation.NullObservation-openhands.plan.Plan *-- openhands.plan.Task-openhands.state.State *-- openhands.plan.Plan-openhands.state.State *-- openhands.observation.CmdOutputObservation-openhands.state.State *-- openhands.action.base.Action-openhands.state.State *-- openhands.observation.Observation-openhands.observation.Observation <|-- openhands.observation.CmdOutputObservation-openhands.observation.Observation <|-- openhands.observation.UserMessageObservation-openhands.plan.Task *-- openhands.plan.Task-openhands.server.session.Session *-- openhands.controller.agent_controller.AgentController-openhands.server.session.Session *-- openhands.agent.Agent-openhands.controller.agent_controller.AgentController -> openhands.state.State-openhands.controller.agent_controller.AgentController -> openhands.plan.Plan-openhands.controller.agent_controller.AgentController -> openhands.controller.command_manager.CommandManager-openhands.controller.command_manager.CommandManager -> openhands.sandbox.sandbox.DockerInteractive--footer Based on f3fda42; Generated by //py2puml//-@endumldiff --git a/docs/static/img/backend_architecture.svg b/docs/static/img/backend_architecture.svgdeleted file mode 100644index a5fc173d5a..0000000000--- a/docs/static/img/backend_architecture.svg+++ /dev/null@@ -1 +0,0 @@-<?xml version="1.0" encoding="us-ascii" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentStyleType="text/css" height="1227px" preserveAspectRatio="none" style="width:5978px;height:1227px;background:#003153;" version="1.1" viewBox="0 0 5978 1227" width="5978px" zoomAndPan="magnify"><defs/><g><rect fill="#003153" height="1227" style="stroke:none;stroke-width:1.0;" width="5978" x="0" y="0"/><!--cluster openhands--><g id="cluster_openhands"><path d="M13.5,11 L96.5,11 A3.75,3.75 0 0 1 99,13.5 L106,33.2969 L5968.5,33.2969 A2.5,2.5 0 0 1 5971,35.7969 L5971,1189 A2.5,2.5 0 0 1 5968.5,1191.5 L13.5,1191.5 A2.5,2.5 0 0 1 11,1189 L11,13.5 A2.5,2.5 0 0 1 13.5,11 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="11" x2="106" y1="33.2969" y2="33.2969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="82" x="15" y="25.9951">openhands</text></g><!--cluster action--><g id="cluster_action"><path d="M1055.5,538 L1108.5,538 A3.75,3.75 0 0 1 1111,540.5 L1118,560.2969 L3852.5,560.2969 A2.5,2.5 0 0 1 3855,562.7969 L3855,1165 A2.5,2.5 0 0 1 3852.5,1167.5 L1055.5,1167.5 A2.5,2.5 0 0 1 1053,1165 L1053,540.5 A2.5,2.5 0 0 1 1055.5,538 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1053" x2="1118" y1="560.2969" y2="560.2969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="52" x="1057" y="552.9951">action</text></g><!--cluster agent--><g id="cluster_agent"><path d="M1507.5,991.5 L1555.5,991.5 A3.75,3.75 0 0 1 1558,994 L1565,1013.7969 L2509.5,1013.7969 A2.5,2.5 0 0 1 2512,1016.2969 L2512,1133 A2.5,2.5 0 0 1 2509.5,1135.5 L1507.5,1135.5 A2.5,2.5 0 0 1 1505,1133 L1505,994 A2.5,2.5 0 0 1 1507.5,991.5 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1505" x2="1565" y1="1013.7969" y2="1013.7969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="47" x="1509" y="1006.4951">agent</text></g><!--cluster base--><g id="cluster_base"><path d="M1079.5,581 L1118.5,581 A3.75,3.75 0 0 1 1121,583.5 L1128,603.2969 L1478.5,603.2969 A2.5,2.5 0 0 1 1481,605.7969 L1481,1116.5 A2.5,2.5 0 0 1 1478.5,1119 L1079.5,1119 A2.5,2.5 0 0 1 1077,1116.5 L1077,583.5 A2.5,2.5 0 0 1 1079.5,581 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1077" x2="1128" y1="603.2969" y2="603.2969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="38" x="1081" y="595.9951">base</text></g><!--cluster bash--><g id="cluster_bash"><path d="M2538.5,991.5 L2578.5,991.5 A3.75,3.75 0 0 1 2581,994 L2588,1013.7969 L2868.5,1013.7969 A2.5,2.5 0 0 1 2871,1016.2969 L2871,1133 A2.5,2.5 0 0 1 2868.5,1135.5 L2538.5,1135.5 A2.5,2.5 0 0 1 2536,1133 L2536,994 A2.5,2.5 0 0 1 2538.5,991.5 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="2536" x2="2588" y1="1013.7969" y2="1013.7969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="39" x="2540" y="1006.4951">bash</text></g><!--cluster browse--><g id="cluster_browse"><path d="M2897.5,999.5 L2956.5,999.5 A3.75,3.75 0 0 1 2959,1002 L2966,1021.7969 L3078.5,1021.7969 A2.5,2.5 0 0 1 3081,1024.2969 L3081,1125 A2.5,2.5 0 0 1 3078.5,1127.5 L2897.5,1127.5 A2.5,2.5 0 0 1 2895,1125 L2895,1002 A2.5,2.5 0 0 1 2897.5,999.5 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="2895" x2="2966" y1="1021.7969" y2="1021.7969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="58" x="2899" y="1014.4951">browse</text></g><!--cluster fileop--><g id="cluster_fileop"><path d="M3107.5,991.5 L3154.5,991.5 A3.75,3.75 0 0 1 3157,994 L3164,1013.7969 L3445.5,1013.7969 A2.5,2.5 0 0 1 3448,1016.2969 L3448,1133 A2.5,2.5 0 0 1 3445.5,1135.5 L3107.5,1135.5 A2.5,2.5 0 0 1 3105,1133 L3105,994 A2.5,2.5 0 0 1 3107.5,991.5 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3105" x2="3164" y1="1013.7969" y2="1013.7969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="46" x="3109" y="1006.4951">fileop</text></g><!--cluster tasks--><g id="cluster_tasks"><path d="M3474.5,983.5 L3520.5,983.5 A3.75,3.75 0 0 1 3523,986 L3530,1005.7969 L3828.5,1005.7969 A2.5,2.5 0 0 1 3831,1008.2969 L3831,1141 A2.5,2.5 0 0 1 3828.5,1143.5 L3474.5,1143.5 A2.5,2.5 0 0 1 3472,1141 L3472,986 A2.5,2.5 0 0 1 3474.5,983.5 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3472" x2="3530" y1="1005.7969" y2="1005.7969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="45" x="3476" y="998.4951">tasks</text></g><!--cluster observation--><g id="cluster_observation"><path d="M3881.5,573 L3979.5,573 A3.75,3.75 0 0 1 3982,575.5 L3989,595.2969 L5944.5,595.2969 A2.5,2.5 0 0 1 5947,597.7969 L5947,916 A2.5,2.5 0 0 1 5944.5,918.5 L3881.5,918.5 A2.5,2.5 0 0 1 3879,916 L3879,575.5 A2.5,2.5 0 0 1 3881.5,573 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3879" x2="3989" y1="595.2969" y2="595.2969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="97" x="3883" y="587.9951">observation</text></g><!--cluster agent--><g id="cluster_agent"><path d="M511.5,556.5 L559.5,556.5 A3.75,3.75 0 0 1 562,559 L569,578.7969 L798.5,578.7969 A2.5,2.5 0 0 1 801,581.2969 L801,698 A2.5,2.5 0 0 1 798.5,700.5 L511.5,700.5 A2.5,2.5 0 0 1 509,698 L509,559 A2.5,2.5 0 0 1 511.5,556.5 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="509" x2="569" y1="578.7969" y2="578.7969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="47" x="513" y="571.4951">agent</text></g><!--cluster llm--><g id="cluster_llm"><path d="M558.5,734 L614.5,734 A3.75,3.75 0 0 1 617,736.5 L624,756.2969 L733.5,756.2969 A2.5,2.5 0 0 1 736,758.7969 L736,940.5 A2.5,2.5 0 0 1 733.5,943 L558.5,943 A2.5,2.5 0 0 1 556,940.5 L556,736.5 A2.5,2.5 0 0 1 558.5,734 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="556" x2="624" y1="756.2969" y2="756.2969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="55" x="560" y="748.9951">llm.llm</text></g><!--cluster controller--><g id="cluster_controller"><path d="M531.5,238 L612.5,238 A3.75,3.75 0 0 1 615,240.5 L622,260.2969 L1120.5,260.2969 A2.5,2.5 0 0 1 1123,262.7969 L1123,511.5 A2.5,2.5 0 0 1 1120.5,514 L531.5,514 A2.5,2.5 0 0 1 529,511.5 L529,240.5 A2.5,2.5 0 0 1 531.5,238 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="529" x2="622" y1="260.2969" y2="260.2969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="80" x="533" y="252.9951">controller</text></g><!--cluster agent_controller--><g id="cluster_agent_controller"><path d="M773.5,281 L908.5,281 A3.75,3.75 0 0 1 911,283.5 L918,303.2969 L1096.5,303.2969 A2.5,2.5 0 0 1 1099,305.7969 L1099,487.5 A2.5,2.5 0 0 1 1096.5,490 L773.5,490 A2.5,2.5 0 0 1 771,487.5 L771,283.5 A2.5,2.5 0 0 1 773.5,281 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="771" x2="918" y1="303.2969" y2="303.2969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="134" x="775" y="295.9951">agent_controller</text></g><!--cluster command_manager--><g id="cluster_command_manager"><path d="M555.5,321.5 L713.5,321.5 A3.75,3.75 0 0 1 716,324 L723,343.7969 L744.5,343.7969 A2.5,2.5 0 0 1 747,346.2969 L747,447 A2.5,2.5 0 0 1 744.5,449.5 L555.5,449.5 A2.5,2.5 0 0 1 553,447 L553,324 A2.5,2.5 0 0 1 555.5,321.5 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="553" x2="723" y1="343.7969" y2="343.7969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="157" x="557" y="336.4951">command_manager</text></g><!--cluster plan--><g id="cluster_plan"><path d="M827.5,548.5 L863.5,548.5 A3.75,3.75 0 0 1 866,551 L873,570.7969 L1026.5,570.7969 A2.5,2.5 0 0 1 1029,573.2969 L1029,957 A2.5,2.5 0 0 1 1026.5,959.5 L827.5,959.5 A2.5,2.5 0 0 1 825,957 L825,551 A2.5,2.5 0 0 1 827.5,548.5 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="825" x2="873" y1="570.7969" y2="570.7969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="35" x="829" y="563.4951">plan</text></g><!--cluster state--><g id="cluster_state"><path d="M1153.5,297.5 L1198.5,297.5 A3.75,3.75 0 0 1 1201,300 L1208,319.7969 L1612.5,319.7969 A2.5,2.5 0 0 1 1615,322.2969 L1615,471 A2.5,2.5 0 0 1 1612.5,473.5 L1153.5,473.5 A2.5,2.5 0 0 1 1151,471 L1151,300 A2.5,2.5 0 0 1 1153.5,297.5 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1151" x2="1208" y1="319.7969" y2="319.7969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="44" x="1155" y="312.4951">state</text></g><!--cluster sandbox--><g id="cluster_sandbox"><path d="M37.5,264.5 L179.5,264.5 A3.75,3.75 0 0 1 182,267 L189,286.7969 L482.5,286.7969 A2.5,2.5 0 0 1 485,289.2969 L485,673.5 A2.5,2.5 0 0 1 482.5,676 L37.5,676 A2.5,2.5 0 0 1 35,673.5 L35,267 A2.5,2.5 0 0 1 37.5,264.5 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="35" x2="189" y1="286.7969" y2="286.7969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="141" x="39" y="279.4951">sandbox.sandbox</text></g><!--cluster session--><g id="cluster_session"><path d="M568.5,54 L685.5,54 A3.75,3.75 0 0 1 688,56.5 L695,76.2969 L877.5,76.2969 A2.5,2.5 0 0 1 880,78.7969 L880,211.5 A2.5,2.5 0 0 1 877.5,214 L568.5,214 A2.5,2.5 0 0 1 566,211.5 L566,56.5 A2.5,2.5 0 0 1 568.5,54 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="566" x2="695" y1="76.2969" y2="76.2969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="116" x="570" y="68.9951">server.session</text></g><!--class AgentEchoAction--><g id="elem_AgentEchoAction"><rect codeLine="4" fill="#003153" height="92.8906" id="AgentEchoAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="154" x="2342" y="1026.5"/><ellipse cx="2355" cy="1040.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M2357.3438,1036.1719 C2356.4063,1035.7344 2355.8125,1035.5938 2354.9375,1035.5938 C2352.3125,1035.5938 2350.3125,1037.6719 2350.3125,1040.3906 L2350.3125,1041.5156 C2350.3125,1044.0938 2352.4219,1045.9844 2355.3125,1045.9844 C2356.5313,1045.9844 2357.6875,1045.6875 2358.4375,1045.1406 C2359.0156,1044.7344 2359.3438,1044.2813 2359.3438,1043.8906 C2359.3438,1043.4375 2358.9531,1043.0469 2358.4844,1043.0469 C2358.2656,1043.0469 2358.0625,1043.125 2357.875,1043.3125 C2357.4219,1043.7969 2357.4219,1043.7969 2357.2344,1043.8906 C2356.8125,1044.1563 2356.125,1044.2813 2355.3594,1044.2813 C2353.3125,1044.2813 2352.0156,1043.1875 2352.0156,1041.4844 L2352.0156,1040.3906 C2352.0156,1038.6094 2353.2656,1037.2969 2355,1037.2969 C2355.5781,1037.2969 2356.1875,1037.4531 2356.6563,1037.7031 C2357.1406,1037.9844 2357.3125,1038.2031 2357.4063,1038.6094 C2357.4688,1039.0156 2357.5,1039.1406 2357.6406,1039.2656 C2357.7813,1039.4063 2358.0156,1039.5156 2358.2344,1039.5156 C2358.5,1039.5156 2358.7656,1039.375 2358.9375,1039.1563 C2359.0469,1039 2359.0781,1038.8125 2359.0781,1038.3906 L2359.0781,1036.9688 C2359.0781,1036.5313 2359.0625,1036.4063 2358.9688,1036.25 C2358.8125,1035.9844 2358.5313,1035.8438 2358.2344,1035.8438 C2357.9375,1035.8438 2357.7344,1035.9375 2357.5156,1036.25 L2357.3438,1036.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="126" x="2367" y="1045.3467">AgentEchoAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="2343" x2="2495" y1="1054.5" y2="1054.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="87" x="2348" y="1071.4951">content: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="104" x="2348" y="1087.792">runnable: bool</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="2348" y="1104.0889">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="2343" x2="2495" y1="1111.3906" y2="1111.3906"/></g><!--class AgentFinishAction--><g id="elem_AgentFinishAction"><rect codeLine="9" fill="#003153" height="76.5938" id="AgentFinishAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="160" x="1950" y="1034.5"/><ellipse cx="1963" cy="1048.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M1965.3438,1044.1719 C1964.4063,1043.7344 1963.8125,1043.5938 1962.9375,1043.5938 C1960.3125,1043.5938 1958.3125,1045.6719 1958.3125,1048.3906 L1958.3125,1049.5156 C1958.3125,1052.0938 1960.4219,1053.9844 1963.3125,1053.9844 C1964.5313,1053.9844 1965.6875,1053.6875 1966.4375,1053.1406 C1967.0156,1052.7344 1967.3438,1052.2813 1967.3438,1051.8906 C1967.3438,1051.4375 1966.9531,1051.0469 1966.4844,1051.0469 C1966.2656,1051.0469 1966.0625,1051.125 1965.875,1051.3125 C1965.4219,1051.7969 1965.4219,1051.7969 1965.2344,1051.8906 C1964.8125,1052.1563 1964.125,1052.2813 1963.3594,1052.2813 C1961.3125,1052.2813 1960.0156,1051.1875 1960.0156,1049.4844 L1960.0156,1048.3906 C1960.0156,1046.6094 1961.2656,1045.2969 1963,1045.2969 C1963.5781,1045.2969 1964.1875,1045.4531 1964.6563,1045.7031 C1965.1406,1045.9844 1965.3125,1046.2031 1965.4063,1046.6094 C1965.4688,1047.0156 1965.5,1047.1406 1965.6406,1047.2656 C1965.7813,1047.4063 1966.0156,1047.5156 1966.2344,1047.5156 C1966.5,1047.5156 1966.7656,1047.375 1966.9375,1047.1563 C1967.0469,1047 1967.0781,1046.8125 1967.0781,1046.3906 L1967.0781,1044.9688 C1967.0781,1044.5313 1967.0625,1044.4063 1966.9688,1044.25 C1966.8125,1043.9844 1966.5313,1043.8438 1966.2344,1043.8438 C1965.9375,1043.8438 1965.7344,1043.9375 1965.5156,1044.25 L1965.3438,1044.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="132" x="1975" y="1053.3467">AgentFinishAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1951" x2="2109" y1="1062.5" y2="1062.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="104" x="1956" y="1079.4951">runnable: bool</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="1956" y="1095.792">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1951" x2="2109" y1="1103.0938" y2="1103.0938"/></g><!--class AgentRecallAction--><g id="elem_AgentRecallAction"><rect codeLine="17" fill="#003153" height="76.5938" id="AgentRecallAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="162" x="2145" y="1034.5"/><ellipse cx="2158" cy="1048.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M2160.3438,1044.1719 C2159.4063,1043.7344 2158.8125,1043.5938 2157.9375,1043.5938 C2155.3125,1043.5938 2153.3125,1045.6719 2153.3125,1048.3906 L2153.3125,1049.5156 C2153.3125,1052.0938 2155.4219,1053.9844 2158.3125,1053.9844 C2159.5313,1053.9844 2160.6875,1053.6875 2161.4375,1053.1406 C2162.0156,1052.7344 2162.3438,1052.2813 2162.3438,1051.8906 C2162.3438,1051.4375 2161.9531,1051.0469 2161.4844,1051.0469 C2161.2656,1051.0469 2161.0625,1051.125 2160.875,1051.3125 C2160.4219,1051.7969 2160.4219,1051.7969 2160.2344,1051.8906 C2159.8125,1052.1563 2159.125,1052.2813 2158.3594,1052.2813 C2156.3125,1052.2813 2155.0156,1051.1875 2155.0156,1049.4844 L2155.0156,1048.3906 C2155.0156,1046.6094 2156.2656,1045.2969 2158,1045.2969 C2158.5781,1045.2969 2159.1875,1045.4531 2159.6563,1045.7031 C2160.1406,1045.9844 2160.3125,1046.2031 2160.4063,1046.6094 C2160.4688,1047.0156 2160.5,1047.1406 2160.6406,1047.2656 C2160.7813,1047.4063 2161.0156,1047.5156 2161.2344,1047.5156 C2161.5,1047.5156 2161.7656,1047.375 2161.9375,1047.1563 C2162.0469,1047 2162.0781,1046.8125 2162.0781,1046.3906 L2162.0781,1044.9688 C2162.0781,1044.5313 2162.0625,1044.4063 2161.9688,1044.25 C2161.8125,1043.9844 2161.5313,1043.8438 2161.2344,1043.8438 C2160.9375,1043.8438 2160.7344,1043.9375 2160.5156,1044.25 L2160.3438,1044.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="134" x="2170" y="1053.3467">AgentRecallAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="2146" x2="2306" y1="1062.5" y2="1062.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="69" x="2151" y="1079.4951">query: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="2151" y="1095.792">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="2146" x2="2306" y1="1103.0938" y2="1103.0938"/></g><!--class AgentSummarizeAction--><g id="elem_AgentSummarizeAction"><rect codeLine="26" fill="#003153" height="76.5938" id="AgentSummarizeAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="199" x="1715.5" y="1034.5"/><ellipse cx="1728.5" cy="1048.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M1730.8438,1044.1719 C1729.9063,1043.7344 1729.3125,1043.5938 1728.4375,1043.5938 C1725.8125,1043.5938 1723.8125,1045.6719 1723.8125,1048.3906 L1723.8125,1049.5156 C1723.8125,1052.0938 1725.9219,1053.9844 1728.8125,1053.9844 C1730.0313,1053.9844 1731.1875,1053.6875 1731.9375,1053.1406 C1732.5156,1052.7344 1732.8438,1052.2813 1732.8438,1051.8906 C1732.8438,1051.4375 1732.4531,1051.0469 1731.9844,1051.0469 C1731.7656,1051.0469 1731.5625,1051.125 1731.375,1051.3125 C1730.9219,1051.7969 1730.9219,1051.7969 1730.7344,1051.8906 C1730.3125,1052.1563 1729.625,1052.2813 1728.8594,1052.2813 C1726.8125,1052.2813 1725.5156,1051.1875 1725.5156,1049.4844 L1725.5156,1048.3906 C1725.5156,1046.6094 1726.7656,1045.2969 1728.5,1045.2969 C1729.0781,1045.2969 1729.6875,1045.4531 1730.1563,1045.7031 C1730.6406,1045.9844 1730.8125,1046.2031 1730.9063,1046.6094 C1730.9688,1047.0156 1731,1047.1406 1731.1406,1047.2656 C1731.2813,1047.4063 1731.5156,1047.5156 1731.7344,1047.5156 C1732,1047.5156 1732.2656,1047.375 1732.4375,1047.1563 C1732.5469,1047 1732.5781,1046.8125 1732.5781,1046.3906 L1732.5781,1044.9688 C1732.5781,1044.5313 1732.5625,1044.4063 1732.4688,1044.25 C1732.3125,1043.9844 1732.0313,1043.8438 1731.7344,1043.8438 C1731.4375,1043.8438 1731.2344,1043.9375 1731.0156,1044.25 L1730.8438,1044.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="171" x="1740.5" y="1053.3467">AgentSummarizeAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1716.5" x2="1913.5" y1="1062.5" y2="1062.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="94" x="1721.5" y="1079.4951">summary: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="1721.5" y="1095.792">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1716.5" x2="1913.5" y1="1103.0938" y2="1103.0938"/></g><!--class AgentThinkAction--><g id="elem_AgentThinkAction"><rect codeLine="30" fill="#003153" height="92.8906" id="AgentThinkAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="159" x="1521.5" y="1026.5"/><ellipse cx="1534.5" cy="1040.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M1536.8438,1036.1719 C1535.9063,1035.7344 1535.3125,1035.5938 1534.4375,1035.5938 C1531.8125,1035.5938 1529.8125,1037.6719 1529.8125,1040.3906 L1529.8125,1041.5156 C1529.8125,1044.0938 1531.9219,1045.9844 1534.8125,1045.9844 C1536.0313,1045.9844 1537.1875,1045.6875 1537.9375,1045.1406 C1538.5156,1044.7344 1538.8438,1044.2813 1538.8438,1043.8906 C1538.8438,1043.4375 1538.4531,1043.0469 1537.9844,1043.0469 C1537.7656,1043.0469 1537.5625,1043.125 1537.375,1043.3125 C1536.9219,1043.7969 1536.9219,1043.7969 1536.7344,1043.8906 C1536.3125,1044.1563 1535.625,1044.2813 1534.8594,1044.2813 C1532.8125,1044.2813 1531.5156,1043.1875 1531.5156,1041.4844 L1531.5156,1040.3906 C1531.5156,1038.6094 1532.7656,1037.2969 1534.5,1037.2969 C1535.0781,1037.2969 1535.6875,1037.4531 1536.1563,1037.7031 C1536.6406,1037.9844 1536.8125,1038.2031 1536.9063,1038.6094 C1536.9688,1039.0156 1537,1039.1406 1537.1406,1039.2656 C1537.2813,1039.4063 1537.5156,1039.5156 1537.7344,1039.5156 C1538,1039.5156 1538.2656,1039.375 1538.4375,1039.1563 C1538.5469,1039 1538.5781,1038.8125 1538.5781,1038.3906 L1538.5781,1036.9688 C1538.5781,1036.5313 1538.5625,1036.4063 1538.4688,1036.25 C1538.3125,1035.9844 1538.0313,1035.8438 1537.7344,1035.8438 C1537.4375,1035.8438 1537.2344,1035.9375 1537.0156,1036.25 L1536.8438,1036.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="131" x="1546.5" y="1045.3467">AgentThinkAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1522.5" x2="1679.5" y1="1054.5" y2="1054.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="87" x="1527.5" y="1071.4951">thought: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="104" x="1527.5" y="1087.792">runnable: bool</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="1527.5" y="1104.0889">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1522.5" x2="1679.5" y1="1111.3906" y2="1111.3906"/></g><!--class ExecutableAction--><g id="elem_ExecutableAction"><rect codeLine="35" fill="#003153" height="44" id="ExecutableAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="155" x="1309.5" y="826"/><ellipse cx="1322.5" cy="840" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M1324.8438,835.6719 C1323.9063,835.2344 1323.3125,835.0938 1322.4375,835.0938 C1319.8125,835.0938 1317.8125,837.1719 1317.8125,839.8906 L1317.8125,841.0156 C1317.8125,843.5938 1319.9219,845.4844 1322.8125,845.4844 C1324.0313,845.4844 1325.1875,845.1875 1325.9375,844.6406 C1326.5156,844.2344 1326.8438,843.7813 1326.8438,843.3906 C1326.8438,842.9375 1326.4531,842.5469 1325.9844,842.5469 C1325.7656,842.5469 1325.5625,842.625 1325.375,842.8125 C1324.9219,843.2969 1324.9219,843.2969 1324.7344,843.3906 C1324.3125,843.6563 1323.625,843.7813 1322.8594,843.7813 C1320.8125,843.7813 1319.5156,842.6875 1319.5156,840.9844 L1319.5156,839.8906 C1319.5156,838.1094 1320.7656,836.7969 1322.5,836.7969 C1323.0781,836.7969 1323.6875,836.9531 1324.1563,837.2031 C1324.6406,837.4844 1324.8125,837.7031 1324.9063,838.1094 C1324.9688,838.5156 1325,838.6406 1325.1406,838.7656 C1325.2813,838.9063 1325.5156,839.0156 1325.7344,839.0156 C1326,839.0156 1326.2656,838.875 1326.4375,838.6563 C1326.5469,838.5 1326.5781,838.3125 1326.5781,837.8906 L1326.5781,836.4688 C1326.5781,836.0313 1326.5625,835.9063 1326.4688,835.75 C1326.3125,835.4844 1326.0313,835.3438 1325.7344,835.3438 C1325.4375,835.3438 1325.2344,835.4375 1325.0156,835.75 L1324.8438,835.6719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="127" x="1334.5" y="844.8467">ExecutableAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1310.5" x2="1463.5" y1="854" y2="854"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1310.5" x2="1463.5" y1="862" y2="862"/></g><!--class NotExecutableAction--><g id="elem_NotExecutableAction"><rect codeLine="37" fill="#003153" height="44" id="NotExecutableAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="181" x="1093.5" y="826"/><ellipse cx="1106.5" cy="840" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M1108.8438,835.6719 C1107.9063,835.2344 1107.3125,835.0938 1106.4375,835.0938 C1103.8125,835.0938 1101.8125,837.1719 1101.8125,839.8906 L1101.8125,841.0156 C1101.8125,843.5938 1103.9219,845.4844 1106.8125,845.4844 C1108.0313,845.4844 1109.1875,845.1875 1109.9375,844.6406 C1110.5156,844.2344 1110.8438,843.7813 1110.8438,843.3906 C1110.8438,842.9375 1110.4531,842.5469 1109.9844,842.5469 C1109.7656,842.5469 1109.5625,842.625 1109.375,842.8125 C1108.9219,843.2969 1108.9219,843.2969 1108.7344,843.3906 C1108.3125,843.6563 1107.625,843.7813 1106.8594,843.7813 C1104.8125,843.7813 1103.5156,842.6875 1103.5156,840.9844 L1103.5156,839.8906 C1103.5156,838.1094 1104.7656,836.7969 1106.5,836.7969 C1107.0781,836.7969 1107.6875,836.9531 1108.1563,837.2031 C1108.6406,837.4844 1108.8125,837.7031 1108.9063,838.1094 C1108.9688,838.5156 1109,838.6406 1109.1406,838.7656 C1109.2813,838.9063 1109.5156,839.0156 1109.7344,839.0156 C1110,839.0156 1110.2656,838.875 1110.4375,838.6563 C1110.5469,838.5 1110.5781,838.3125 1110.5781,837.8906 L1110.5781,836.4688 C1110.5781,836.0313 1110.5625,835.9063 1110.4688,835.75 C1110.3125,835.4844 1110.0313,835.3438 1109.7344,835.3438 C1109.4375,835.3438 1109.2344,835.4375 1109.0156,835.75 L1108.8438,835.6719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="153" x="1118.5" y="844.8467">NotExecutableAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1094.5" x2="1273.5" y1="854" y2="854"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1094.5" x2="1273.5" y1="862" y2="862"/></g><!--class Action--><g id="elem_Action"><rect codeLine="42" fill="#003153" height="44" id="Action" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="75" x="1345.5" y="616"/><ellipse cx="1358.5" cy="630" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M1360.8438,625.6719 C1359.9063,625.2344 1359.3125,625.0938 1358.4375,625.0938 C1355.8125,625.0938 1353.8125,627.1719 1353.8125,629.8906 L1353.8125,631.0156 C1353.8125,633.5938 1355.9219,635.4844 1358.8125,635.4844 C1360.0313,635.4844 1361.1875,635.1875 1361.9375,634.6406 C1362.5156,634.2344 1362.8438,633.7813 1362.8438,633.3906 C1362.8438,632.9375 1362.4531,632.5469 1361.9844,632.5469 C1361.7656,632.5469 1361.5625,632.625 1361.375,632.8125 C1360.9219,633.2969 1360.9219,633.2969 1360.7344,633.3906 C1360.3125,633.6563 1359.625,633.7813 1358.8594,633.7813 C1356.8125,633.7813 1355.5156,632.6875 1355.5156,630.9844 L1355.5156,629.8906 C1355.5156,628.1094 1356.7656,626.7969 1358.5,626.7969 C1359.0781,626.7969 1359.6875,626.9531 1360.1563,627.2031 C1360.6406,627.4844 1360.8125,627.7031 1360.9063,628.1094 C1360.9688,628.5156 1361,628.6406 1361.1406,628.7656 C1361.2813,628.9063 1361.5156,629.0156 1361.7344,629.0156 C1362,629.0156 1362.2656,628.875 1362.4375,628.6563 C1362.5469,628.5 1362.5781,628.3125 1362.5781,627.8906 L1362.5781,626.4688 C1362.5781,626.0313 1362.5625,625.9063 1362.4688,625.75 C1362.3125,625.4844 1362.0313,625.3438 1361.7344,625.3438 C1361.4375,625.3438 1361.2344,625.4375 1361.0156,625.75 L1360.8438,625.6719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="47" x="1370.5" y="634.8467">Action</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1346.5" x2="1419.5" y1="644" y2="644"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1346.5" x2="1419.5" y1="652" y2="652"/></g><!--class NullAction--><g id="elem_NullAction"><rect codeLine="44" fill="#003153" height="60.2969" id="NullAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="101" x="1133.5" y="1043"/><ellipse cx="1146.5" cy="1057" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M1148.8438,1052.6719 C1147.9063,1052.2344 1147.3125,1052.0938 1146.4375,1052.0938 C1143.8125,1052.0938 1141.8125,1054.1719 1141.8125,1056.8906 L1141.8125,1058.0156 C1141.8125,1060.5938 1143.9219,1062.4844 1146.8125,1062.4844 C1148.0313,1062.4844 1149.1875,1062.1875 1149.9375,1061.6406 C1150.5156,1061.2344 1150.8438,1060.7813 1150.8438,1060.3906 C1150.8438,1059.9375 1150.4531,1059.5469 1149.9844,1059.5469 C1149.7656,1059.5469 1149.5625,1059.625 1149.375,1059.8125 C1148.9219,1060.2969 1148.9219,1060.2969 1148.7344,1060.3906 C1148.3125,1060.6563 1147.625,1060.7813 1146.8594,1060.7813 C1144.8125,1060.7813 1143.5156,1059.6875 1143.5156,1057.9844 L1143.5156,1056.8906 C1143.5156,1055.1094 1144.7656,1053.7969 1146.5,1053.7969 C1147.0781,1053.7969 1147.6875,1053.9531 1148.1563,1054.2031 C1148.6406,1054.4844 1148.8125,1054.7031 1148.9063,1055.1094 C1148.9688,1055.5156 1149,1055.6406 1149.1406,1055.7656 C1149.2813,1055.9063 1149.5156,1056.0156 1149.7344,1056.0156 C1150,1056.0156 1150.2656,1055.875 1150.4375,1055.6563 C1150.5469,1055.5 1150.5781,1055.3125 1150.5781,1054.8906 L1150.5781,1053.4688 C1150.5781,1053.0313 1150.5625,1052.9063 1150.4688,1052.75 C1150.3125,1052.4844 1150.0313,1052.3438 1149.7344,1052.3438 C1149.4375,1052.3438 1149.2344,1052.4375 1149.0156,1052.75 L1148.8438,1052.6719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="73" x="1158.5" y="1061.8467">NullAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1134.5" x2="1233.5" y1="1071" y2="1071"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="1139.5" y="1087.9951">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1134.5" x2="1233.5" y1="1095.2969" y2="1095.2969"/></g><!--class CmdKillAction--><g id="elem_CmdKillAction"><rect codeLine="47" fill="#003153" height="76.5938" id="CmdKillAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="130" x="2552" y="1034.5"/><ellipse cx="2565" cy="1048.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M2567.3438,1044.1719 C2566.4063,1043.7344 2565.8125,1043.5938 2564.9375,1043.5938 C2562.3125,1043.5938 2560.3125,1045.6719 2560.3125,1048.3906 L2560.3125,1049.5156 C2560.3125,1052.0938 2562.4219,1053.9844 2565.3125,1053.9844 C2566.5313,1053.9844 2567.6875,1053.6875 2568.4375,1053.1406 C2569.0156,1052.7344 2569.3438,1052.2813 2569.3438,1051.8906 C2569.3438,1051.4375 2568.9531,1051.0469 2568.4844,1051.0469 C2568.2656,1051.0469 2568.0625,1051.125 2567.875,1051.3125 C2567.4219,1051.7969 2567.4219,1051.7969 2567.2344,1051.8906 C2566.8125,1052.1563 2566.125,1052.2813 2565.3594,1052.2813 C2563.3125,1052.2813 2562.0156,1051.1875 2562.0156,1049.4844 L2562.0156,1048.3906 C2562.0156,1046.6094 2563.2656,1045.2969 2565,1045.2969 C2565.5781,1045.2969 2566.1875,1045.4531 2566.6563,1045.7031 C2567.1406,1045.9844 2567.3125,1046.2031 2567.4063,1046.6094 C2567.4688,1047.0156 2567.5,1047.1406 2567.6406,1047.2656 C2567.7813,1047.4063 2568.0156,1047.5156 2568.2344,1047.5156 C2568.5,1047.5156 2568.7656,1047.375 2568.9375,1047.1563 C2569.0469,1047 2569.0781,1046.8125 2569.0781,1046.3906 L2569.0781,1044.9688 C2569.0781,1044.5313 2569.0625,1044.4063 2568.9688,1044.25 C2568.8125,1043.9844 2568.5313,1043.8438 2568.2344,1043.8438 C2567.9375,1043.8438 2567.7344,1043.9375 2567.5156,1044.25 L2567.3438,1044.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="102" x="2577" y="1053.3467">CmdKillAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="2553" x2="2681" y1="1062.5" y2="1062.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="42" x="2558" y="1079.4951">id: int</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="2558" y="1095.792">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="2553" x2="2681" y1="1103.0938" y2="1103.0938"/></g><!--class CmdRunAction--><g id="elem_CmdRunAction"><rect codeLine="51" fill="#003153" height="92.8906" id="CmdRunAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="138" x="2717" y="1026.5"/><ellipse cx="2731.35" cy="1040.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M2733.6938,1036.1719 C2732.7563,1035.7344 2732.1625,1035.5938 2731.2875,1035.5938 C2728.6625,1035.5938 2726.6625,1037.6719 2726.6625,1040.3906 L2726.6625,1041.5156 C2726.6625,1044.0938 2728.7719,1045.9844 2731.6625,1045.9844 C2732.8813,1045.9844 2734.0375,1045.6875 2734.7875,1045.1406 C2735.3656,1044.7344 2735.6938,1044.2813 2735.6938,1043.8906 C2735.6938,1043.4375 2735.3031,1043.0469 2734.8344,1043.0469 C2734.6156,1043.0469 2734.4125,1043.125 2734.225,1043.3125 C2733.7719,1043.7969 2733.7719,1043.7969 2733.5844,1043.8906 C2733.1625,1044.1563 2732.475,1044.2813 2731.7094,1044.2813 C2729.6625,1044.2813 2728.3656,1043.1875 2728.3656,1041.4844 L2728.3656,1040.3906 C2728.3656,1038.6094 2729.6156,1037.2969 2731.35,1037.2969 C2731.9281,1037.2969 2732.5375,1037.4531 2733.0063,1037.7031 C2733.4906,1037.9844 2733.6625,1038.2031 2733.7563,1038.6094 C2733.8188,1039.0156 2733.85,1039.1406 2733.9906,1039.2656 C2734.1313,1039.4063 2734.3656,1039.5156 2734.5844,1039.5156 C2734.85,1039.5156 2735.1156,1039.375 2735.2875,1039.1563 C2735.3969,1039 2735.4281,1038.8125 2735.4281,1038.3906 L2735.4281,1036.9688 C2735.4281,1036.5313 2735.4125,1036.4063 2735.3188,1036.25 C2735.1625,1035.9844 2734.8813,1035.8438 2734.5844,1035.8438 C2734.2875,1035.8438 2734.0844,1035.9375 2733.8656,1036.25 L2733.6938,1036.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="107" x="2743.65" y="1045.3467">CmdRunAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="2718" x2="2854" y1="1054.5" y2="1054.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="100" x="2723" y="1071.4951">command: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="126" x="2723" y="1087.792">background: bool</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="2723" y="1104.0889">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="2718" x2="2854" y1="1111.3906" y2="1111.3906"/></g><!--class BrowseURLAction--><g id="elem_BrowseURLAction"><rect codeLine="56" fill="#003153" height="76.5938" id="BrowseURLAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="154" x="2911" y="1034.5"/><ellipse cx="2924" cy="1048.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M2926.3438,1044.1719 C2925.4063,1043.7344 2924.8125,1043.5938 2923.9375,1043.5938 C2921.3125,1043.5938 2919.3125,1045.6719 2919.3125,1048.3906 L2919.3125,1049.5156 C2919.3125,1052.0938 2921.4219,1053.9844 2924.3125,1053.9844 C2925.5313,1053.9844 2926.6875,1053.6875 2927.4375,1053.1406 C2928.0156,1052.7344 2928.3438,1052.2813 2928.3438,1051.8906 C2928.3438,1051.4375 2927.9531,1051.0469 2927.4844,1051.0469 C2927.2656,1051.0469 2927.0625,1051.125 2926.875,1051.3125 C2926.4219,1051.7969 2926.4219,1051.7969 2926.2344,1051.8906 C2925.8125,1052.1563 2925.125,1052.2813 2924.3594,1052.2813 C2922.3125,1052.2813 2921.0156,1051.1875 2921.0156,1049.4844 L2921.0156,1048.3906 C2921.0156,1046.6094 2922.2656,1045.2969 2924,1045.2969 C2924.5781,1045.2969 2925.1875,1045.4531 2925.6563,1045.7031 C2926.1406,1045.9844 2926.3125,1046.2031 2926.4063,1046.6094 C2926.4688,1047.0156 2926.5,1047.1406 2926.6406,1047.2656 C2926.7813,1047.4063 2927.0156,1047.5156 2927.2344,1047.5156 C2927.5,1047.5156 2927.7656,1047.375 2927.9375,1047.1563 C2928.0469,1047 2928.0781,1046.8125 2928.0781,1046.3906 L2928.0781,1044.9688 C2928.0781,1044.5313 2928.0625,1044.4063 2927.9688,1044.25 C2927.8125,1043.9844 2927.5313,1043.8438 2927.2344,1043.8438 C2926.9375,1043.8438 2926.7344,1043.9375 2926.5156,1044.25 L2926.3438,1044.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="126" x="2936" y="1053.3467">BrowseURLAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="2912" x2="3064" y1="1062.5" y2="1062.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="47" x="2917" y="1079.4951">url: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="2917" y="1095.792">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="2912" x2="3064" y1="1103.0938" y2="1103.0938"/></g><!--class FileReadAction--><g id="elem_FileReadAction"><rect codeLine="66" fill="#003153" height="76.5938" id="FileReadAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="136" x="3121" y="1034.5"/><ellipse cx="3134" cy="1048.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M3136.3438,1044.1719 C3135.4063,1043.7344 3134.8125,1043.5938 3133.9375,1043.5938 C3131.3125,1043.5938 3129.3125,1045.6719 3129.3125,1048.3906 L3129.3125,1049.5156 C3129.3125,1052.0938 3131.4219,1053.9844 3134.3125,1053.9844 C3135.5313,1053.9844 3136.6875,1053.6875 3137.4375,1053.1406 C3138.0156,1052.7344 3138.3438,1052.2813 3138.3438,1051.8906 C3138.3438,1051.4375 3137.9531,1051.0469 3137.4844,1051.0469 C3137.2656,1051.0469 3137.0625,1051.125 3136.875,1051.3125 C3136.4219,1051.7969 3136.4219,1051.7969 3136.2344,1051.8906 C3135.8125,1052.1563 3135.125,1052.2813 3134.3594,1052.2813 C3132.3125,1052.2813 3131.0156,1051.1875 3131.0156,1049.4844 L3131.0156,1048.3906 C3131.0156,1046.6094 3132.2656,1045.2969 3134,1045.2969 C3134.5781,1045.2969 3135.1875,1045.4531 3135.6563,1045.7031 C3136.1406,1045.9844 3136.3125,1046.2031 3136.4063,1046.6094 C3136.4688,1047.0156 3136.5,1047.1406 3136.6406,1047.2656 C3136.7813,1047.4063 3137.0156,1047.5156 3137.2344,1047.5156 C3137.5,1047.5156 3137.7656,1047.375 3137.9375,1047.1563 C3138.0469,1047 3138.0781,1046.8125 3138.0781,1046.3906 L3138.0781,1044.9688 C3138.0781,1044.5313 3138.0625,1044.4063 3137.9688,1044.25 C3137.8125,1043.9844 3137.5313,1043.8438 3137.2344,1043.8438 C3136.9375,1043.8438 3136.7344,1043.9375 3136.5156,1044.25 L3136.3438,1044.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="108" x="3146" y="1053.3467">FileReadAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3122" x2="3256" y1="1062.5" y2="1062.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="63" x="3127" y="1079.4951">path: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="3127" y="1095.792">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3122" x2="3256" y1="1103.0938" y2="1103.0938"/></g><!--class FileWriteAction--><g id="elem_FileWriteAction"><rect codeLine="74" fill="#003153" height="92.8906" id="FileWriteAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="140" x="3292" y="1026.5"/><ellipse cx="3305" cy="1040.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M3307.3438,1036.1719 C3306.4063,1035.7344 3305.8125,1035.5938 3304.9375,1035.5938 C3302.3125,1035.5938 3300.3125,1037.6719 3300.3125,1040.3906 L3300.3125,1041.5156 C3300.3125,1044.0938 3302.4219,1045.9844 3305.3125,1045.9844 C3306.5313,1045.9844 3307.6875,1045.6875 3308.4375,1045.1406 C3309.0156,1044.7344 3309.3438,1044.2813 3309.3438,1043.8906 C3309.3438,1043.4375 3308.9531,1043.0469 3308.4844,1043.0469 C3308.2656,1043.0469 3308.0625,1043.125 3307.875,1043.3125 C3307.4219,1043.7969 3307.4219,1043.7969 3307.2344,1043.8906 C3306.8125,1044.1563 3306.125,1044.2813 3305.3594,1044.2813 C3303.3125,1044.2813 3302.0156,1043.1875 3302.0156,1041.4844 L3302.0156,1040.3906 C3302.0156,1038.6094 3303.2656,1037.2969 3305,1037.2969 C3305.5781,1037.2969 3306.1875,1037.4531 3306.6563,1037.7031 C3307.1406,1037.9844 3307.3125,1038.2031 3307.4063,1038.6094 C3307.4688,1039.0156 3307.5,1039.1406 3307.6406,1039.2656 C3307.7813,1039.4063 3308.0156,1039.5156 3308.2344,1039.5156 C3308.5,1039.5156 3308.7656,1039.375 3308.9375,1039.1563 C3309.0469,1039 3309.0781,1038.8125 3309.0781,1038.3906 L3309.0781,1036.9688 C3309.0781,1036.5313 3309.0625,1036.4063 3308.9688,1036.25 C3308.8125,1035.9844 3308.5313,1035.8438 3308.2344,1035.8438 C3307.9375,1035.8438 3307.7344,1035.9375 3307.5156,1036.25 L3307.3438,1036.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="112" x="3317" y="1045.3467">FileWriteAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3293" x2="3431" y1="1054.5" y2="1054.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="63" x="3298" y="1071.4951">path: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="94" x="3298" y="1087.792">contents: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="3298" y="1104.0889">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3293" x2="3431" y1="1111.3906" y2="1111.3906"/></g><!--class AddTaskAction--><g id="elem_AddTaskAction"><rect codeLine="83" fill="#003153" height="109.1875" id="AddTaskAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="136" x="3488" y="1018.5"/><ellipse cx="3501" cy="1032.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M3503.3438,1028.1719 C3502.4063,1027.7344 3501.8125,1027.5938 3500.9375,1027.5938 C3498.3125,1027.5938 3496.3125,1029.6719 3496.3125,1032.3906 L3496.3125,1033.5156 C3496.3125,1036.0938 3498.4219,1037.9844 3501.3125,1037.9844 C3502.5313,1037.9844 3503.6875,1037.6875 3504.4375,1037.1406 C3505.0156,1036.7344 3505.3438,1036.2813 3505.3438,1035.8906 C3505.3438,1035.4375 3504.9531,1035.0469 3504.4844,1035.0469 C3504.2656,1035.0469 3504.0625,1035.125 3503.875,1035.3125 C3503.4219,1035.7969 3503.4219,1035.7969 3503.2344,1035.8906 C3502.8125,1036.1563 3502.125,1036.2813 3501.3594,1036.2813 C3499.3125,1036.2813 3498.0156,1035.1875 3498.0156,1033.4844 L3498.0156,1032.3906 C3498.0156,1030.6094 3499.2656,1029.2969 3501,1029.2969 C3501.5781,1029.2969 3502.1875,1029.4531 3502.6563,1029.7031 C3503.1406,1029.9844 3503.3125,1030.2031 3503.4063,1030.6094 C3503.4688,1031.0156 3503.5,1031.1406 3503.6406,1031.2656 C3503.7813,1031.4063 3504.0156,1031.5156 3504.2344,1031.5156 C3504.5,1031.5156 3504.7656,1031.375 3504.9375,1031.1563 C3505.0469,1031 3505.0781,1030.8125 3505.0781,1030.3906 L3505.0781,1028.9688 C3505.0781,1028.5313 3505.0625,1028.4063 3504.9688,1028.25 C3504.8125,1027.9844 3504.5313,1027.8438 3504.2344,1027.8438 C3503.9375,1027.8438 3503.7344,1027.9375 3503.5156,1028.25 L3503.3438,1028.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="108" x="3513" y="1037.3467">AddTaskAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3489" x2="3623" y1="1046.5" y2="1046.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="78" x="3494" y="1063.4951">parent: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="59" x="3494" y="1079.792">goal: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="94" x="3494" y="1096.0889">subtasks: list</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="3494" y="1112.3857">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3489" x2="3623" y1="1119.6875" y2="1119.6875"/></g><!--class ModifyTaskAction--><g id="elem_ModifyTaskAction"><rect codeLine="89" fill="#003153" height="92.8906" id="ModifyTaskAction" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="156" x="3659" y="1026.5"/><ellipse cx="3672" cy="1040.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M3674.3438,1036.1719 C3673.4063,1035.7344 3672.8125,1035.5938 3671.9375,1035.5938 C3669.3125,1035.5938 3667.3125,1037.6719 3667.3125,1040.3906 L3667.3125,1041.5156 C3667.3125,1044.0938 3669.4219,1045.9844 3672.3125,1045.9844 C3673.5313,1045.9844 3674.6875,1045.6875 3675.4375,1045.1406 C3676.0156,1044.7344 3676.3438,1044.2813 3676.3438,1043.8906 C3676.3438,1043.4375 3675.9531,1043.0469 3675.4844,1043.0469 C3675.2656,1043.0469 3675.0625,1043.125 3674.875,1043.3125 C3674.4219,1043.7969 3674.4219,1043.7969 3674.2344,1043.8906 C3673.8125,1044.1563 3673.125,1044.2813 3672.3594,1044.2813 C3670.3125,1044.2813 3669.0156,1043.1875 3669.0156,1041.4844 L3669.0156,1040.3906 C3669.0156,1038.6094 3670.2656,1037.2969 3672,1037.2969 C3672.5781,1037.2969 3673.1875,1037.4531 3673.6563,1037.7031 C3674.1406,1037.9844 3674.3125,1038.2031 3674.4063,1038.6094 C3674.4688,1039.0156 3674.5,1039.1406 3674.6406,1039.2656 C3674.7813,1039.4063 3675.0156,1039.5156 3675.2344,1039.5156 C3675.5,1039.5156 3675.7656,1039.375 3675.9375,1039.1563 C3676.0469,1039 3676.0781,1038.8125 3676.0781,1038.3906 L3676.0781,1036.9688 C3676.0781,1036.5313 3676.0625,1036.4063 3675.9688,1036.25 C3675.8125,1035.9844 3675.5313,1035.8438 3675.2344,1035.8438 C3674.9375,1035.8438 3674.7344,1035.9375 3674.5156,1036.25 L3674.3438,1036.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="128" x="3684" y="1045.3467">ModifyTaskAction</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3660" x2="3814" y1="1054.5" y2="1054.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="42" x="3665" y="1071.4951">id: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="67" x="3665" y="1087.792">state: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="3665" y="1104.0889">action: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3660" x2="3814" y1="1111.3906" y2="1111.3906"/></g><!--class AgentMessageObservation--><g id="elem_AgentMessageObservation"><rect codeLine="13" fill="#003153" height="76.5938" id="AgentMessageObservation" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="221" x="4992.5" y="809.5"/><ellipse cx="5005.5" cy="823.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M5007.8438,819.1719 C5006.9063,818.7344 5006.3125,818.5938 5005.4375,818.5938 C5002.8125,818.5938 5000.8125,820.6719 5000.8125,823.3906 L5000.8125,824.5156 C5000.8125,827.0938 5002.9219,828.9844 5005.8125,828.9844 C5007.0313,828.9844 5008.1875,828.6875 5008.9375,828.1406 C5009.5156,827.7344 5009.8438,827.2813 5009.8438,826.8906 C5009.8438,826.4375 5009.4531,826.0469 5008.9844,826.0469 C5008.7656,826.0469 5008.5625,826.125 5008.375,826.3125 C5007.9219,826.7969 5007.9219,826.7969 5007.7344,826.8906 C5007.3125,827.1563 5006.625,827.2813 5005.8594,827.2813 C5003.8125,827.2813 5002.5156,826.1875 5002.5156,824.4844 L5002.5156,823.3906 C5002.5156,821.6094 5003.7656,820.2969 5005.5,820.2969 C5006.0781,820.2969 5006.6875,820.4531 5007.1563,820.7031 C5007.6406,820.9844 5007.8125,821.2031 5007.9063,821.6094 C5007.9688,822.0156 5008,822.1406 5008.1406,822.2656 C5008.2813,822.4063 5008.5156,822.5156 5008.7344,822.5156 C5009,822.5156 5009.2656,822.375 5009.4375,822.1563 C5009.5469,822 5009.5781,821.8125 5009.5781,821.3906 L5009.5781,819.9688 C5009.5781,819.5313 5009.5625,819.4063 5009.4688,819.25 C5009.3125,818.9844 5009.0313,818.8438 5008.7344,818.8438 C5008.4375,818.8438 5008.2344,818.9375 5008.0156,819.25 L5007.8438,819.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="193" x="5017.5" y="828.3467">AgentMessageObservation</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="4993.5" x2="5212.5" y1="837.5" y2="837.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="57" x="4998.5" y="854.4951">role: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="115" x="4998.5" y="870.792">observation: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="4993.5" x2="5212.5" y1="878.0938" y2="878.0938"/></g><!--class AgentRecallObservation--><g id="elem_AgentRecallObservation"><rect codeLine="21" fill="#003153" height="92.8906" id="AgentRecallObservation" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="203" x="5492.5" y="801.5"/><ellipse cx="5505.5" cy="815.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M5507.8438,811.1719 C5506.9063,810.7344 5506.3125,810.5938 5505.4375,810.5938 C5502.8125,810.5938 5500.8125,812.6719 5500.8125,815.3906 L5500.8125,816.5156 C5500.8125,819.0938 5502.9219,820.9844 5505.8125,820.9844 C5507.0313,820.9844 5508.1875,820.6875 5508.9375,820.1406 C5509.5156,819.7344 5509.8438,819.2813 5509.8438,818.8906 C5509.8438,818.4375 5509.4531,818.0469 5508.9844,818.0469 C5508.7656,818.0469 5508.5625,818.125 5508.375,818.3125 C5507.9219,818.7969 5507.9219,818.7969 5507.7344,818.8906 C5507.3125,819.1563 5506.625,819.2813 5505.8594,819.2813 C5503.8125,819.2813 5502.5156,818.1875 5502.5156,816.4844 L5502.5156,815.3906 C5502.5156,813.6094 5503.7656,812.2969 5505.5,812.2969 C5506.0781,812.2969 5506.6875,812.4531 5507.1563,812.7031 C5507.6406,812.9844 5507.8125,813.2031 5507.9063,813.6094 C5507.9688,814.0156 5508,814.1406 5508.1406,814.2656 C5508.2813,814.4063 5508.5156,814.5156 5508.7344,814.5156 C5509,814.5156 5509.2656,814.375 5509.4375,814.1563 C5509.5469,814 5509.5781,813.8125 5509.5781,813.3906 L5509.5781,811.9688 C5509.5781,811.5313 5509.5625,811.4063 5509.4688,811.25 C5509.3125,810.9844 5509.0313,810.8438 5508.7344,810.8438 C5508.4375,810.8438 5508.2344,810.9375 5508.0156,811.25 L5507.8438,811.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="175" x="5517.5" y="820.3467">AgentRecallObservation</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="5493.5" x2="5694.5" y1="829.5" y2="829.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="137" x="5498.5" y="846.4951">memories: List[str]</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="57" x="5498.5" y="862.792">role: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="115" x="5498.5" y="879.0889">observation: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="5493.5" x2="5694.5" y1="886.3906" y2="886.3906"/></g><!--class Observation--><g id="elem_Observation"><rect codeLine="39" fill="#003153" height="60.2969" id="Observation" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="116" x="4726" y="608"/><ellipse cx="4739" cy="622" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M4741.3438,617.6719 C4740.4063,617.2344 4739.8125,617.0938 4738.9375,617.0938 C4736.3125,617.0938 4734.3125,619.1719 4734.3125,621.8906 L4734.3125,623.0156 C4734.3125,625.5938 4736.4219,627.4844 4739.3125,627.4844 C4740.5313,627.4844 4741.6875,627.1875 4742.4375,626.6406 C4743.0156,626.2344 4743.3438,625.7813 4743.3438,625.3906 C4743.3438,624.9375 4742.9531,624.5469 4742.4844,624.5469 C4742.2656,624.5469 4742.0625,624.625 4741.875,624.8125 C4741.4219,625.2969 4741.4219,625.2969 4741.2344,625.3906 C4740.8125,625.6563 4740.125,625.7813 4739.3594,625.7813 C4737.3125,625.7813 4736.0156,624.6875 4736.0156,622.9844 L4736.0156,621.8906 C4736.0156,620.1094 4737.2656,618.7969 4739,618.7969 C4739.5781,618.7969 4740.1875,618.9531 4740.6563,619.2031 C4741.1406,619.4844 4741.3125,619.7031 4741.4063,620.1094 C4741.4688,620.5156 4741.5,620.6406 4741.6406,620.7656 C4741.7813,620.9063 4742.0156,621.0156 4742.2344,621.0156 C4742.5,621.0156 4742.7656,620.875 4742.9375,620.6563 C4743.0469,620.5 4743.0781,620.3125 4743.0781,619.8906 L4743.0781,618.4688 C4743.0781,618.0313 4743.0625,617.9063 4742.9688,617.75 C4742.8125,617.4844 4742.5313,617.3438 4742.2344,617.3438 C4741.9375,617.3438 4741.7344,617.4375 4741.5156,617.75 L4741.3438,617.6719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="88" x="4751" y="626.8467">Observation</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="4727" x2="4841" y1="636" y2="636"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="87" x="4732" y="652.9951">content: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="4727" x2="4841" y1="660.2969" y2="660.2969"/></g><!--class BrowserOutputObservation--><g id="elem_BrowserOutputObservation"><rect codeLine="60" fill="#003153" height="109.1875" id="BrowserOutputObservation" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="225" x="3895.5" y="793.5"/><ellipse cx="3908.5" cy="807.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M3910.8438,803.1719 C3909.9063,802.7344 3909.3125,802.5938 3908.4375,802.5938 C3905.8125,802.5938 3903.8125,804.6719 3903.8125,807.3906 L3903.8125,808.5156 C3903.8125,811.0938 3905.9219,812.9844 3908.8125,812.9844 C3910.0313,812.9844 3911.1875,812.6875 3911.9375,812.1406 C3912.5156,811.7344 3912.8438,811.2813 3912.8438,810.8906 C3912.8438,810.4375 3912.4531,810.0469 3911.9844,810.0469 C3911.7656,810.0469 3911.5625,810.125 3911.375,810.3125 C3910.9219,810.7969 3910.9219,810.7969 3910.7344,810.8906 C3910.3125,811.1563 3909.625,811.2813 3908.8594,811.2813 C3906.8125,811.2813 3905.5156,810.1875 3905.5156,808.4844 L3905.5156,807.3906 C3905.5156,805.6094 3906.7656,804.2969 3908.5,804.2969 C3909.0781,804.2969 3909.6875,804.4531 3910.1563,804.7031 C3910.6406,804.9844 3910.8125,805.2031 3910.9063,805.6094 C3910.9688,806.0156 3911,806.1406 3911.1406,806.2656 C3911.2813,806.4063 3911.5156,806.5156 3911.7344,806.5156 C3912,806.5156 3912.2656,806.375 3912.4375,806.1563 C3912.5469,806 3912.5781,805.8125 3912.5781,805.3906 L3912.5781,803.9688 C3912.5781,803.5313 3912.5625,803.4063 3912.4688,803.25 C3912.3125,802.9844 3912.0313,802.8438 3911.7344,802.8438 C3911.4375,802.8438 3911.2344,802.9375 3911.0156,803.25 L3910.8438,803.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="197" x="3920.5" y="812.3467">BrowserOutputObservation</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3896.5" x2="4119.5" y1="821.5" y2="821.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="47" x="3901.5" y="838.4951">url: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="115" x="3901.5" y="854.792">status_code: int</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="77" x="3901.5" y="871.0889">error: bool</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="115" x="3901.5" y="887.3857">observation: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="3896.5" x2="4119.5" y1="894.6875" y2="894.6875"/></g><!--class FileReadObservation--><g id="elem_FileReadObservation"><rect codeLine="70" fill="#003153" height="76.5938" id="FileReadObservation" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="177" x="4155.5" y="809.5"/><ellipse cx="4168.5" cy="823.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M4170.8438,819.1719 C4169.9063,818.7344 4169.3125,818.5938 4168.4375,818.5938 C4165.8125,818.5938 4163.8125,820.6719 4163.8125,823.3906 L4163.8125,824.5156 C4163.8125,827.0938 4165.9219,828.9844 4168.8125,828.9844 C4170.0313,828.9844 4171.1875,828.6875 4171.9375,828.1406 C4172.5156,827.7344 4172.8438,827.2813 4172.8438,826.8906 C4172.8438,826.4375 4172.4531,826.0469 4171.9844,826.0469 C4171.7656,826.0469 4171.5625,826.125 4171.375,826.3125 C4170.9219,826.7969 4170.9219,826.7969 4170.7344,826.8906 C4170.3125,827.1563 4169.625,827.2813 4168.8594,827.2813 C4166.8125,827.2813 4165.5156,826.1875 4165.5156,824.4844 L4165.5156,823.3906 C4165.5156,821.6094 4166.7656,820.2969 4168.5,820.2969 C4169.0781,820.2969 4169.6875,820.4531 4170.1563,820.7031 C4170.6406,820.9844 4170.8125,821.2031 4170.9063,821.6094 C4170.9688,822.0156 4171,822.1406 4171.1406,822.2656 C4171.2813,822.4063 4171.5156,822.5156 4171.7344,822.5156 C4172,822.5156 4172.2656,822.375 4172.4375,822.1563 C4172.5469,822 4172.5781,821.8125 4172.5781,821.3906 L4172.5781,819.9688 C4172.5781,819.5313 4172.5625,819.4063 4172.4688,819.25 C4172.3125,818.9844 4172.0313,818.8438 4171.7344,818.8438 C4171.4375,818.8438 4171.2344,818.9375 4171.0156,819.25 L4170.8438,819.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="149" x="4180.5" y="828.3467">FileReadObservation</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="4156.5" x2="4331.5" y1="837.5" y2="837.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="63" x="4161.5" y="854.4951">path: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="115" x="4161.5" y="870.792">observation: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="4156.5" x2="4331.5" y1="878.0938" y2="878.0938"/></g><!--class FileWriteObservation--><g id="elem_FileWriteObservation"><rect codeLine="79" fill="#003153" height="76.5938" id="FileWriteObservation" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="181" x="4367.5" y="809.5"/><ellipse cx="4380.5" cy="823.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M4382.8438,819.1719 C4381.9063,818.7344 4381.3125,818.5938 4380.4375,818.5938 C4377.8125,818.5938 4375.8125,820.6719 4375.8125,823.3906 L4375.8125,824.5156 C4375.8125,827.0938 4377.9219,828.9844 4380.8125,828.9844 C4382.0313,828.9844 4383.1875,828.6875 4383.9375,828.1406 C4384.5156,827.7344 4384.8438,827.2813 4384.8438,826.8906 C4384.8438,826.4375 4384.4531,826.0469 4383.9844,826.0469 C4383.7656,826.0469 4383.5625,826.125 4383.375,826.3125 C4382.9219,826.7969 4382.9219,826.7969 4382.7344,826.8906 C4382.3125,827.1563 4381.625,827.2813 4380.8594,827.2813 C4378.8125,827.2813 4377.5156,826.1875 4377.5156,824.4844 L4377.5156,823.3906 C4377.5156,821.6094 4378.7656,820.2969 4380.5,820.2969 C4381.0781,820.2969 4381.6875,820.4531 4382.1563,820.7031 C4382.6406,820.9844 4382.8125,821.2031 4382.9063,821.6094 C4382.9688,822.0156 4383,822.1406 4383.1406,822.2656 C4383.2813,822.4063 4383.5156,822.5156 4383.7344,822.5156 C4384,822.5156 4384.2656,822.375 4384.4375,822.1563 C4384.5469,822 4384.5781,821.8125 4384.5781,821.3906 L4384.5781,819.9688 C4384.5781,819.5313 4384.5625,819.4063 4384.4688,819.25 C4384.3125,818.9844 4384.0313,818.8438 4383.7344,818.8438 C4383.4375,818.8438 4383.2344,818.9375 4383.0156,819.25 L4382.8438,819.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="153" x="4392.5" y="828.3467">FileWriteObservation</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="4368.5" x2="4547.5" y1="837.5" y2="837.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="63" x="4373.5" y="854.4951">path: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="115" x="4373.5" y="870.792">observation: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="4368.5" x2="4547.5" y1="878.0938" y2="878.0938"/></g><!--class AgentErrorObservation--><g id="elem_AgentErrorObservation"><rect codeLine="117" fill="#003153" height="60.2969" id="AgentErrorObservation" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="196" x="4584" y="818"/><ellipse cx="4597" cy="832" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M4599.3438,827.6719 C4598.4063,827.2344 4597.8125,827.0938 4596.9375,827.0938 C4594.3125,827.0938 4592.3125,829.1719 4592.3125,831.8906 L4592.3125,833.0156 C4592.3125,835.5938 4594.4219,837.4844 4597.3125,837.4844 C4598.5313,837.4844 4599.6875,837.1875 4600.4375,836.6406 C4601.0156,836.2344 4601.3438,835.7813 4601.3438,835.3906 C4601.3438,834.9375 4600.9531,834.5469 4600.4844,834.5469 C4600.2656,834.5469 4600.0625,834.625 4599.875,834.8125 C4599.4219,835.2969 4599.4219,835.2969 4599.2344,835.3906 C4598.8125,835.6563 4598.125,835.7813 4597.3594,835.7813 C4595.3125,835.7813 4594.0156,834.6875 4594.0156,832.9844 L4594.0156,831.8906 C4594.0156,830.1094 4595.2656,828.7969 4597,828.7969 C4597.5781,828.7969 4598.1875,828.9531 4598.6563,829.2031 C4599.1406,829.4844 4599.3125,829.7031 4599.4063,830.1094 C4599.4688,830.5156 4599.5,830.6406 4599.6406,830.7656 C4599.7813,830.9063 4600.0156,831.0156 4600.2344,831.0156 C4600.5,831.0156 4600.7656,830.875 4600.9375,830.6563 C4601.0469,830.5 4601.0781,830.3125 4601.0781,829.8906 L4601.0781,828.4688 C4601.0781,828.0313 4601.0625,827.9063 4600.9688,827.75 C4600.8125,827.4844 4600.5313,827.3438 4600.2344,827.3438 C4599.9375,827.3438 4599.7344,827.4375 4599.5156,827.75 L4599.3438,827.6719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="168" x="4609" y="836.8467">AgentErrorObservation</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="4585" x2="4779" y1="846" y2="846"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="115" x="4590" y="862.9951">observation: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="4585" x2="4779" y1="870.2969" y2="870.2969"/></g><!--class NullObservation--><g id="elem_NullObservation"><rect codeLine="124" fill="#003153" height="60.2969" id="NullObservation" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="142" x="4815" y="818"/><ellipse cx="4828" cy="832" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M4830.3438,827.6719 C4829.4063,827.2344 4828.8125,827.0938 4827.9375,827.0938 C4825.3125,827.0938 4823.3125,829.1719 4823.3125,831.8906 L4823.3125,833.0156 C4823.3125,835.5938 4825.4219,837.4844 4828.3125,837.4844 C4829.5313,837.4844 4830.6875,837.1875 4831.4375,836.6406 C4832.0156,836.2344 4832.3438,835.7813 4832.3438,835.3906 C4832.3438,834.9375 4831.9531,834.5469 4831.4844,834.5469 C4831.2656,834.5469 4831.0625,834.625 4830.875,834.8125 C4830.4219,835.2969 4830.4219,835.2969 4830.2344,835.3906 C4829.8125,835.6563 4829.125,835.7813 4828.3594,835.7813 C4826.3125,835.7813 4825.0156,834.6875 4825.0156,832.9844 L4825.0156,831.8906 C4825.0156,830.1094 4826.2656,828.7969 4828,828.7969 C4828.5781,828.7969 4829.1875,828.9531 4829.6563,829.2031 C4830.1406,829.4844 4830.3125,829.7031 4830.4063,830.1094 C4830.4688,830.5156 4830.5,830.6406 4830.6406,830.7656 C4830.7813,830.9063 4831.0156,831.0156 4831.2344,831.0156 C4831.5,831.0156 4831.7656,830.875 4831.9375,830.6563 C4832.0469,830.5 4832.0781,830.3125 4832.0781,829.8906 L4832.0781,828.4688 C4832.0781,828.0313 4832.0625,827.9063 4831.9688,827.75 C4831.8125,827.4844 4831.5313,827.3438 4831.2344,827.3438 C4830.9375,827.3438 4830.7344,827.4375 4830.5156,827.75 L4830.3438,827.6719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="114" x="4840" y="836.8467">NullObservation</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="4816" x2="4956" y1="846" y2="846"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="115" x="4821" y="862.9951">observation: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="4816" x2="4956" y1="870.2969" y2="870.2969"/></g><!--class CmdOutputObservation--><g id="elem_CmdOutputObservation"><rect codeLine="140" fill="#003153" height="109.1875" id="CmdOutputObservation" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="200" x="5731" y="793.5"/><ellipse cx="5744" cy="807.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M5746.3438,803.1719 C5745.4063,802.7344 5744.8125,802.5938 5743.9375,802.5938 C5741.3125,802.5938 5739.3125,804.6719 5739.3125,807.3906 L5739.3125,808.5156 C5739.3125,811.0938 5741.4219,812.9844 5744.3125,812.9844 C5745.5313,812.9844 5746.6875,812.6875 5747.4375,812.1406 C5748.0156,811.7344 5748.3438,811.2813 5748.3438,810.8906 C5748.3438,810.4375 5747.9531,810.0469 5747.4844,810.0469 C5747.2656,810.0469 5747.0625,810.125 5746.875,810.3125 C5746.4219,810.7969 5746.4219,810.7969 5746.2344,810.8906 C5745.8125,811.1563 5745.125,811.2813 5744.3594,811.2813 C5742.3125,811.2813 5741.0156,810.1875 5741.0156,808.4844 L5741.0156,807.3906 C5741.0156,805.6094 5742.2656,804.2969 5744,804.2969 C5744.5781,804.2969 5745.1875,804.4531 5745.6563,804.7031 C5746.1406,804.9844 5746.3125,805.2031 5746.4063,805.6094 C5746.4688,806.0156 5746.5,806.1406 5746.6406,806.2656 C5746.7813,806.4063 5747.0156,806.5156 5747.2344,806.5156 C5747.5,806.5156 5747.7656,806.375 5747.9375,806.1563 C5748.0469,806 5748.0781,805.8125 5748.0781,805.3906 L5748.0781,803.9688 C5748.0781,803.5313 5748.0625,803.4063 5747.9688,803.25 C5747.8125,802.9844 5747.5313,802.8438 5747.2344,802.8438 C5746.9375,802.8438 5746.7344,802.9375 5746.5156,803.25 L5746.3438,803.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="172" x="5756" y="812.3467">CmdOutputObservation</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="5732" x2="5930" y1="821.5" y2="821.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="120" x="5737" y="838.4951">command_id: int</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="100" x="5737" y="854.792">command: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="99" x="5737" y="871.0889">exit_code: int</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="115" x="5737" y="887.3857">observation: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="5732" x2="5930" y1="894.6875" y2="894.6875"/></g><!--class UserMessageObservation--><g id="elem_UserMessageObservation"><rect codeLine="157" fill="#003153" height="76.5938" id="UserMessageObservation" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="208" x="5249" y="809.5"/><ellipse cx="5262" cy="823.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M5264.3438,819.1719 C5263.4063,818.7344 5262.8125,818.5938 5261.9375,818.5938 C5259.3125,818.5938 5257.3125,820.6719 5257.3125,823.3906 L5257.3125,824.5156 C5257.3125,827.0938 5259.4219,828.9844 5262.3125,828.9844 C5263.5313,828.9844 5264.6875,828.6875 5265.4375,828.1406 C5266.0156,827.7344 5266.3438,827.2813 5266.3438,826.8906 C5266.3438,826.4375 5265.9531,826.0469 5265.4844,826.0469 C5265.2656,826.0469 5265.0625,826.125 5264.875,826.3125 C5264.4219,826.7969 5264.4219,826.7969 5264.2344,826.8906 C5263.8125,827.1563 5263.125,827.2813 5262.3594,827.2813 C5260.3125,827.2813 5259.0156,826.1875 5259.0156,824.4844 L5259.0156,823.3906 C5259.0156,821.6094 5260.2656,820.2969 5262,820.2969 C5262.5781,820.2969 5263.1875,820.4531 5263.6563,820.7031 C5264.1406,820.9844 5264.3125,821.2031 5264.4063,821.6094 C5264.4688,822.0156 5264.5,822.1406 5264.6406,822.2656 C5264.7813,822.4063 5265.0156,822.5156 5265.2344,822.5156 C5265.5,822.5156 5265.7656,822.375 5265.9375,822.1563 C5266.0469,822 5266.0781,821.8125 5266.0781,821.3906 L5266.0781,819.9688 C5266.0781,819.5313 5266.0625,819.4063 5265.9688,819.25 C5265.8125,818.9844 5265.5313,818.8438 5265.2344,818.8438 C5264.9375,818.8438 5264.7344,818.9375 5264.5156,819.25 L5264.3438,819.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="180" x="5274" y="828.3467">UserMessageObservation</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="5250" x2="5456" y1="837.5" y2="837.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="57" x="5255" y="854.4951">role: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="115" x="5255" y="870.792">observation: str</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="5250" x2="5456" y1="878.0938" y2="878.0938"/></g><!--class Agent--><g id="elem_Agent"><rect codeLine="94" fill="#003153" height="92.8906" id="Agent" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="242" x="525" y="591.5"/><ellipse cx="621.25" cy="605.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M623.3281,607.3125 L623.7188,608.2969 L623.3281,608.2969 C622.875,608.2969 622.7656,608.3125 622.6094,608.4219 C622.3594,608.5781 622.2031,608.8594 622.2031,609.1563 C622.2031,609.4219 622.3438,609.6719 622.5625,609.8281 C622.7031,609.9531 622.9063,610 623.3281,610 L625.6875,610 C626.0469,610 626.2656,609.9688 626.4063,609.875 C626.6563,609.7344 626.8125,609.4375 626.8125,609.1563 C626.8125,608.875 626.6719,608.625 626.4531,608.4688 C626.2813,608.3281 626.125,608.2969 625.6563,608.2969 L622.2656,600.0938 L618.5938,600.0938 C618.1406,600.0938 618.0156,600.1094 617.8594,600.2031 C617.6094,600.375 617.4531,600.6563 617.4531,600.9375 C617.4531,601.2188 617.5938,601.4688 617.8125,601.6406 C617.9844,601.75 618.1563,601.7813 618.5938,601.7813 L619.6719,601.7813 L617.0313,608.2969 C616.6094,608.2969 616.4531,608.3125 616.2969,608.4219 C616.0469,608.5781 615.8906,608.8594 615.8906,609.1563 C615.8906,609.7188 616.2656,610 617.0156,610 L619.2813,610 C619.6406,610 619.8594,609.9688 619.9844,609.875 C620.25,609.7344 620.3906,609.4375 620.3906,609.1563 C620.3906,608.875 620.2656,608.625 620.0469,608.4531 C619.875,608.3281 619.7344,608.2969 619.2813,608.2969 L618.8906,608.2969 L619.2813,607.3125 L623.3281,607.3125 Z M622.625,605.6094 L619.9531,605.6094 L621.2969,602.3438 L622.625,605.6094 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-style="italic" lengthAdjust="spacing" textLength="42" x="638.75" y="610.3467">Agent</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="526" x2="766" y1="619.5" y2="619.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" text-decoration="underline" textLength="230" x="531" y="636.4951">_registry: Dict[str, Type[Agent]]</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="59" x="531" y="652.792">llm: LLM</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="123" x="531" y="669.0889">_complete: None</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="526" x2="766" y1="676.3906" y2="676.3906"/></g><!--class LLM--><g id="elem_LLM"><rect codeLine="99" fill="#003153" height="158.0781" id="LLM" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="148" x="572" y="769"/><ellipse cx="628.25" cy="783" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M630.5938,778.6719 C629.6563,778.2344 629.0625,778.0938 628.1875,778.0938 C625.5625,778.0938 623.5625,780.1719 623.5625,782.8906 L623.5625,784.0156 C623.5625,786.5938 625.6719,788.4844 628.5625,788.4844 C629.7813,788.4844 630.9375,788.1875 631.6875,787.6406 C632.2656,787.2344 632.5938,786.7813 632.5938,786.3906 C632.5938,785.9375 632.2031,785.5469 631.7344,785.5469 C631.5156,785.5469 631.3125,785.625 631.125,785.8125 C630.6719,786.2969 630.6719,786.2969 630.4844,786.3906 C630.0625,786.6563 629.375,786.7813 628.6094,786.7813 C626.5625,786.7813 625.2656,785.6875 625.2656,783.9844 L625.2656,782.8906 C625.2656,781.1094 626.5156,779.7969 628.25,779.7969 C628.8281,779.7969 629.4375,779.9531 629.9063,780.2031 C630.3906,780.4844 630.5625,780.7031 630.6563,781.1094 C630.7188,781.5156 630.75,781.6406 630.8906,781.7656 C631.0313,781.9063 631.2656,782.0156 631.4844,782.0156 C631.75,782.0156 632.0156,781.875 632.1875,781.6563 C632.2969,781.5 632.3281,781.3125 632.3281,780.8906 L632.3281,779.4688 C632.3281,779.0313 632.3125,778.9063 632.2188,778.75 C632.0625,778.4844 631.7813,778.3438 631.4844,778.3438 C631.1875,778.3438 630.9844,778.4375 630.7656,778.75 L630.5938,778.6719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="28" x="645.75" y="787.8467">LLM</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="573" x2="719" y1="797" y2="797"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="91" x="578" y="813.9951">model: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="101" x="578" y="830.292">api_key: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="105" x="578" y="846.5889">base_url: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="124" x="578" y="862.8857">_debug_dir: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="126" x="578" y="879.1826">_debug_idx: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="118" x="578" y="895.4795">_debug_id: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="136" x="578" y="911.7764">_completion: None</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="573" x2="719" y1="919.0781" y2="919.0781"/></g><!--class AgentController--><g id="elem_AgentController"><rect codeLine="108" fill="#003153" height="158.0781" id="AgentController" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="296" x="787" y="316"/><ellipse cx="872.75" cy="330" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M875.0938,325.6719 C874.1563,325.2344 873.5625,325.0938 872.6875,325.0938 C870.0625,325.0938 868.0625,327.1719 868.0625,329.8906 L868.0625,331.0156 C868.0625,333.5938 870.1719,335.4844 873.0625,335.4844 C874.2813,335.4844 875.4375,335.1875 876.1875,334.6406 C876.7656,334.2344 877.0938,333.7813 877.0938,333.3906 C877.0938,332.9375 876.7031,332.5469 876.2344,332.5469 C876.0156,332.5469 875.8125,332.625 875.625,332.8125 C875.1719,333.2969 875.1719,333.2969 874.9844,333.3906 C874.5625,333.6563 873.875,333.7813 873.1094,333.7813 C871.0625,333.7813 869.7656,332.6875 869.7656,330.9844 L869.7656,329.8906 C869.7656,328.1094 871.0156,326.7969 872.75,326.7969 C873.3281,326.7969 873.9375,326.9531 874.4063,327.2031 C874.8906,327.4844 875.0625,327.7031 875.1563,328.1094 C875.2188,328.5156 875.25,328.6406 875.3906,328.7656 C875.5313,328.9063 875.7656,329.0156 875.9844,329.0156 C876.25,329.0156 876.5156,328.875 876.6875,328.6563 C876.7969,328.5 876.8281,328.3125 876.8281,327.8906 L876.8281,326.4688 C876.8281,326.0313 876.8125,325.9063 876.7188,325.75 C876.5625,325.4844 876.2813,325.3438 875.9844,325.3438 C875.6875,325.3438 875.4844,325.4375 875.2656,325.75 L875.0938,325.6719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="117" x="890.25" y="334.8467">AgentController</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="788" x2="1082" y1="344" y2="344"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="95" x="793" y="360.9951">agent: Agent</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="136" x="793" y="377.292">max_iterations: int</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="83" x="793" y="393.5889">workdir: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="284" x="793" y="409.8857">command_manager: CommandManager</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="87" x="793" y="426.1826">state: State</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="70" x="793" y="442.4795">plan: Plan</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="168" x="793" y="458.7764">callbacks: List[Callable]</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="788" x2="1082" y1="466.0781" y2="466.0781"/></g><!--class CommandManager--><g id="elem_CommandManager"><rect codeLine="120" fill="#003153" height="76.5938" id="CommandManager" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="162" x="569" y="356.5"/><ellipse cx="582" cy="370.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M584.3438,366.1719 C583.4063,365.7344 582.8125,365.5938 581.9375,365.5938 C579.3125,365.5938 577.3125,367.6719 577.3125,370.3906 L577.3125,371.5156 C577.3125,374.0938 579.4219,375.9844 582.3125,375.9844 C583.5313,375.9844 584.6875,375.6875 585.4375,375.1406 C586.0156,374.7344 586.3438,374.2813 586.3438,373.8906 C586.3438,373.4375 585.9531,373.0469 585.4844,373.0469 C585.2656,373.0469 585.0625,373.125 584.875,373.3125 C584.4219,373.7969 584.4219,373.7969 584.2344,373.8906 C583.8125,374.1563 583.125,374.2813 582.3594,374.2813 C580.3125,374.2813 579.0156,373.1875 579.0156,371.4844 L579.0156,370.3906 C579.0156,368.6094 580.2656,367.2969 582,367.2969 C582.5781,367.2969 583.1875,367.4531 583.6563,367.7031 C584.1406,367.9844 584.3125,368.2031 584.4063,368.6094 C584.4688,369.0156 584.5,369.1406 584.6406,369.2656 C584.7813,369.4063 585.0156,369.5156 585.2344,369.5156 C585.5,369.5156 585.7656,369.375 585.9375,369.1563 C586.0469,369 586.0781,368.8125 586.0781,368.3906 L586.0781,366.9688 C586.0781,366.5313 586.0625,366.4063 585.9688,366.25 C585.8125,365.9844 585.5313,365.8438 585.2344,365.8438 C584.9375,365.8438 584.7344,365.9375 584.5156,366.25 L584.3438,366.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="134" x="594" y="375.3467">CommandManager</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="570" x2="730" y1="384.5" y2="384.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="112" x="575" y="401.4951">directory: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="79" x="575" y="417.792">shell: None</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="570" x2="730" y1="425.0938" y2="425.0938"/></g><!--class Plan--><g id="elem_Plan"><rect codeLine="127" fill="#003153" height="109.1875" id="Plan" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="113" x="878.5" y="583.5"/><ellipse cx="916.25" cy="597.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M918.5938,593.1719 C917.6563,592.7344 917.0625,592.5938 916.1875,592.5938 C913.5625,592.5938 911.5625,594.6719 911.5625,597.3906 L911.5625,598.5156 C911.5625,601.0938 913.6719,602.9844 916.5625,602.9844 C917.7813,602.9844 918.9375,602.6875 919.6875,602.1406 C920.2656,601.7344 920.5938,601.2813 920.5938,600.8906 C920.5938,600.4375 920.2031,600.0469 919.7344,600.0469 C919.5156,600.0469 919.3125,600.125 919.125,600.3125 C918.6719,600.7969 918.6719,600.7969 918.4844,600.8906 C918.0625,601.1563 917.375,601.2813 916.6094,601.2813 C914.5625,601.2813 913.2656,600.1875 913.2656,598.4844 L913.2656,597.3906 C913.2656,595.6094 914.5156,594.2969 916.25,594.2969 C916.8281,594.2969 917.4375,594.4531 917.9063,594.7031 C918.3906,594.9844 918.5625,595.2031 918.6563,595.6094 C918.7188,596.0156 918.75,596.1406 918.8906,596.2656 C919.0313,596.4063 919.2656,596.5156 919.4844,596.5156 C919.75,596.5156 920.0156,596.375 920.1875,596.1563 C920.2969,596 920.3281,595.8125 920.3281,595.3906 L920.3281,593.9688 C920.3281,593.5313 920.3125,593.4063 920.2188,593.25 C920.0625,592.9844 919.7813,592.8438 919.4844,592.8438 C919.1875,592.8438 918.9844,592.9375 918.7656,593.25 L918.5938,593.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="30" x="933.75" y="602.3467">Plan</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="879.5" x2="990.5" y1="611.5" y2="611.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" text-decoration="underline" textLength="101" x="884.5" y="628.4951">main_goal: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" text-decoration="underline" textLength="73" x="884.5" y="644.792">task: Task</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="101" x="884.5" y="661.0889">main_goal: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="77" x="884.5" y="677.3857">task: None</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="879.5" x2="990.5" y1="684.6875" y2="684.6875"/></g><!--class Task--><g id="elem_Task"><rect codeLine="161" fill="#003153" height="190.6719" id="Task" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="153" x="841.5" y="752.5"/><ellipse cx="897.75" cy="766.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M900.0938,762.1719 C899.1563,761.7344 898.5625,761.5938 897.6875,761.5938 C895.0625,761.5938 893.0625,763.6719 893.0625,766.3906 L893.0625,767.5156 C893.0625,770.0938 895.1719,771.9844 898.0625,771.9844 C899.2813,771.9844 900.4375,771.6875 901.1875,771.1406 C901.7656,770.7344 902.0938,770.2813 902.0938,769.8906 C902.0938,769.4375 901.7031,769.0469 901.2344,769.0469 C901.0156,769.0469 900.8125,769.125 900.625,769.3125 C900.1719,769.7969 900.1719,769.7969 899.9844,769.8906 C899.5625,770.1563 898.875,770.2813 898.1094,770.2813 C896.0625,770.2813 894.7656,769.1875 894.7656,767.4844 L894.7656,766.3906 C894.7656,764.6094 896.0156,763.2969 897.75,763.2969 C898.3281,763.2969 898.9375,763.4531 899.4063,763.7031 C899.8906,763.9844 900.0625,764.2031 900.1563,764.6094 C900.2188,765.0156 900.25,765.1406 900.3906,765.2656 C900.5313,765.4063 900.7656,765.5156 900.9844,765.5156 C901.25,765.5156 901.5156,765.375 901.6875,765.1563 C901.7969,765 901.8281,764.8125 901.8281,764.3906 L901.8281,762.9688 C901.8281,762.5313 901.8125,762.4063 901.7188,762.25 C901.5625,761.9844 901.2813,761.8438 900.9844,761.8438 C900.6875,761.8438 900.4844,761.9375 900.2656,762.25 L900.0938,762.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="33" x="915.25" y="771.3467">Task</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="842.5" x2="993.5" y1="780.5" y2="780.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" text-decoration="underline" textLength="42" x="847.5" y="797.4951">id: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" text-decoration="underline" textLength="59" x="847.5" y="813.792">goal: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" text-decoration="underline" textLength="141" x="847.5" y="830.0889">parent: Task | None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" text-decoration="underline" textLength="141" x="847.5" y="846.3857">subtasks: List[Task]</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="59" x="847.5" y="862.6826">id: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="59" x="847.5" y="878.9795">id: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="95" x="847.5" y="895.2764">parent: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="59" x="847.5" y="911.5732">goal: str</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="109" x="847.5" y="927.8701">subtasks: None</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="842.5" x2="993.5" y1="935.1719" y2="935.1719"/></g><!--class State--><g id="elem_State"><rect codeLine="133" fill="#003153" height="125.4844" id="State" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="432" x="1167" y="332.5"/><ellipse cx="1359.25" cy="346.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M1361.5938,342.1719 C1360.6563,341.7344 1360.0625,341.5938 1359.1875,341.5938 C1356.5625,341.5938 1354.5625,343.6719 1354.5625,346.3906 L1354.5625,347.5156 C1354.5625,350.0938 1356.6719,351.9844 1359.5625,351.9844 C1360.7813,351.9844 1361.9375,351.6875 1362.6875,351.1406 C1363.2656,350.7344 1363.5938,350.2813 1363.5938,349.8906 C1363.5938,349.4375 1363.2031,349.0469 1362.7344,349.0469 C1362.5156,349.0469 1362.3125,349.125 1362.125,349.3125 C1361.6719,349.7969 1361.6719,349.7969 1361.4844,349.8906 C1361.0625,350.1563 1360.375,350.2813 1359.6094,350.2813 C1357.5625,350.2813 1356.2656,349.1875 1356.2656,347.4844 L1356.2656,346.3906 C1356.2656,344.6094 1357.5156,343.2969 1359.25,343.2969 C1359.8281,343.2969 1360.4375,343.4531 1360.9063,343.7031 C1361.3906,343.9844 1361.5625,344.2031 1361.6563,344.6094 C1361.7188,345.0156 1361.75,345.1406 1361.8906,345.2656 C1362.0313,345.4063 1362.2656,345.5156 1362.4844,345.5156 C1362.75,345.5156 1363.0156,345.375 1363.1875,345.1563 C1363.2969,345 1363.3281,344.8125 1363.3281,344.3906 L1363.3281,342.9688 C1363.3281,342.5313 1363.3125,342.4063 1363.2188,342.25 C1363.0625,341.9844 1362.7813,341.8438 1362.4844,341.8438 C1362.1875,341.8438 1361.9844,341.9375 1361.7656,342.25 L1361.5938,342.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="40" x="1376.75" y="351.3467">State</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1168" x2="1598" y1="360.5" y2="360.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="70" x="1173" y="377.4951">plan: Plan</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="92" x="1173" y="393.792">iteration: int</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="420" x="1173" y="410.0889">background_commands_obs: List[CmdOutputObservation]</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="288" x="1173" y="426.3857">history: List[Tuple[Action, Observation]]</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="333" x="1173" y="442.6826">updated_info: List[Tuple[Action, Observation]]</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="1168" x2="1598" y1="449.9844" y2="449.9844"/></g><!--class DockerInteractive--><g id="elem_DockerInteractive"><rect codeLine="146" fill="#003153" height="190.6719" id="DockerInteractive" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="417" x="51.5" y="299.5"/><ellipse cx="190.75" cy="313.5" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M193.0938,309.1719 C192.1563,308.7344 191.5625,308.5938 190.6875,308.5938 C188.0625,308.5938 186.0625,310.6719 186.0625,313.3906 L186.0625,314.5156 C186.0625,317.0938 188.1719,318.9844 191.0625,318.9844 C192.2813,318.9844 193.4375,318.6875 194.1875,318.1406 C194.7656,317.7344 195.0938,317.2813 195.0938,316.8906 C195.0938,316.4375 194.7031,316.0469 194.2344,316.0469 C194.0156,316.0469 193.8125,316.125 193.625,316.3125 C193.1719,316.7969 193.1719,316.7969 192.9844,316.8906 C192.5625,317.1563 191.875,317.2813 191.1094,317.2813 C189.0625,317.2813 187.7656,316.1875 187.7656,314.4844 L187.7656,313.3906 C187.7656,311.6094 189.0156,310.2969 190.75,310.2969 C191.3281,310.2969 191.9375,310.4531 192.4063,310.7031 C192.8906,310.9844 193.0625,311.2031 193.1563,311.6094 C193.2188,312.0156 193.25,312.1406 193.3906,312.2656 C193.5313,312.4063 193.7656,312.5156 193.9844,312.5156 C194.25,312.5156 194.5156,312.375 194.6875,312.1563 C194.7969,312 194.8281,311.8125 194.8281,311.3906 L194.8281,309.9688 C194.8281,309.5313 194.8125,309.4063 194.7188,309.25 C194.5625,308.9844 194.2813,308.8438 193.9844,308.8438 C193.6875,308.8438 193.4844,308.9375 193.2656,309.25 L193.0938,309.1719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="131" x="208.25" y="318.3467">DockerInteractive</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="52.5" x2="467.5" y1="327.5" y2="327.5"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" text-decoration="underline" textLength="405" x="57.5" y="344.4951">background_commands: Dict[int, BackgroundCommand]</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="127" x="57.5" y="360.792">instance_id: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="127" x="57.5" y="377.0889">instance_id: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="149" x="57.5" y="393.3857">workspace_dir: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="149" x="57.5" y="409.6826">workspace_dir: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="149" x="57.5" y="425.9795">workspace_dir: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="87" x="57.5" y="442.2764">timeout: int</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="166" x="57.5" y="458.5732">base_container_image: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="162" x="57.5" y="474.8701">container_name: None</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="52.5" x2="467.5" y1="482.1719" y2="482.1719"/></g><!--class BackgroundCommand--><g id="elem_BackgroundCommand"><rect fill="#003153" height="44" id="BackgroundCommand" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="186" x="167" y="616"/><ellipse cx="180" cy="630" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M182.3438,625.6719 C181.4063,625.2344 180.8125,625.0938 179.9375,625.0938 C177.3125,625.0938 175.3125,627.1719 175.3125,629.8906 L175.3125,631.0156 C175.3125,633.5938 177.4219,635.4844 180.3125,635.4844 C181.5313,635.4844 182.6875,635.1875 183.4375,634.6406 C184.0156,634.2344 184.3438,633.7813 184.3438,633.3906 C184.3438,632.9375 183.9531,632.5469 183.4844,632.5469 C183.2656,632.5469 183.0625,632.625 182.875,632.8125 C182.4219,633.2969 182.4219,633.2969 182.2344,633.3906 C181.8125,633.6563 181.125,633.7813 180.3594,633.7813 C178.3125,633.7813 177.0156,632.6875 177.0156,630.9844 L177.0156,629.8906 C177.0156,628.1094 178.2656,626.7969 180,626.7969 C180.5781,626.7969 181.1875,626.9531 181.6563,627.2031 C182.1406,627.4844 182.3125,627.7031 182.4063,628.1094 C182.4688,628.5156 182.5,628.6406 182.6406,628.7656 C182.7813,628.9063 183.0156,629.0156 183.2344,629.0156 C183.5,629.0156 183.7656,628.875 183.9375,628.6563 C184.0469,628.5 184.0781,628.3125 184.0781,627.8906 L184.0781,626.4688 C184.0781,626.0313 184.0625,625.9063 183.9688,625.75 C183.8125,625.4844 183.5313,625.3438 183.2344,625.3438 C182.9375,625.3438 182.7344,625.4375 182.5156,625.75 L182.3438,625.6719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="158" x="192" y="634.8467">BackgroundCommand</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="168" x2="352" y1="644" y2="644"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="168" x2="352" y1="652" y2="652"/></g><!--class Session--><g id="elem_Session"><rect codeLine="173" fill="#003153" height="109.1875" id="Session" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="281" x="582.5" y="89"/><ellipse cx="692.25" cy="103" fill="#003153" rx="9" ry="9" style="stroke:#D9D3D0;stroke-width:1.0;"/><path d="M694.5938,98.6719 C693.6563,98.2344 693.0625,98.0938 692.1875,98.0938 C689.5625,98.0938 687.5625,100.1719 687.5625,102.8906 L687.5625,104.0156 C687.5625,106.5938 689.6719,108.4844 692.5625,108.4844 C693.7813,108.4844 694.9375,108.1875 695.6875,107.6406 C696.2656,107.2344 696.5938,106.7813 696.5938,106.3906 C696.5938,105.9375 696.2031,105.5469 695.7344,105.5469 C695.5156,105.5469 695.3125,105.625 695.125,105.8125 C694.6719,106.2969 694.6719,106.2969 694.4844,106.3906 C694.0625,106.6563 693.375,106.7813 692.6094,106.7813 C690.5625,106.7813 689.2656,105.6875 689.2656,103.9844 L689.2656,102.8906 C689.2656,101.1094 690.5156,99.7969 692.25,99.7969 C692.8281,99.7969 693.4375,99.9531 693.9063,100.2031 C694.3906,100.4844 694.5625,100.7031 694.6563,101.1094 C694.7188,101.5156 694.75,101.6406 694.8906,101.7656 C695.0313,101.9063 695.2656,102.0156 695.4844,102.0156 C695.75,102.0156 696.0156,101.875 696.1875,101.6563 C696.2969,101.5 696.3281,101.3125 696.3281,100.8906 L696.3281,99.4688 C696.3281,99.0313 696.3125,98.9063 696.2188,98.75 C696.0625,98.4844 695.7813,98.3438 695.4844,98.3438 C695.1875,98.3438 694.9844,98.4375 694.7656,98.75 L694.5938,98.6719 Z " fill="#D9D3D0"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="54" x="709.75" y="107.8467">Session</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="583.5" x2="862.5" y1="117" y2="117"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="125" x="588.5" y="133.9951">websocket: None</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="269" x="588.5" y="150.292">controller: Optional[AgentController]</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="167" x="588.5" y="166.5889">agent: Optional[Agent]</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="126" x="588.5" y="182.8857">agent_task: None</text><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="583.5" x2="862.5" y1="190.1875" y2="190.1875"/></g><!--reverse link ExecutableAction to AgentEchoAction--><g id="link_ExecutableAction_AgentEchoAction"><path codeLine="180" d="M1482.7207,854.0654 C1679.2907,865.2924 2173.24,900.107 2324,975.5 C2347.76,987.382 2369.05,1007.577 2385.43,1026.43 " fill="none" id="ExecutableAction-backto-AgentEchoAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1464.75,853.039,1482.3786,860.0556,1483.0628,848.0752,1464.75,853.039" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link NotExecutableAction to AgentFinishAction--><g id="link_NotExecutableAction_AgentFinishAction"><path codeLine="181" d="M1204.9299,885.5585 C1221.8899,913.8295 1247.06,947.315 1292,967.5 C1324.44,982.068 1899.18,961.814 1932,975.5 C1960.87,987.539 1985.86,1012.526 2003.37,1034.057 " fill="none" id="NotExecutableAction-backto-AgentFinishAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1195.67,870.123,1199.7847,888.6451,1210.075,882.4719,1195.67,870.123" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Observation to AgentMessageObservation--><g id="link_Observation_AgentMessageObservation"><path codeLine="182" d="M4858.938,666.2298 C4898.188,681.5498 4933.43,698.027 4975,726 C5010.39,749.817 5045.22,783.607 5069.59,809.429 " fill="none" id="Observation-backto-AgentMessageObservation" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="4842.17,659.685,4856.7564,671.8192,4861.1196,660.6405,4842.17,659.685" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link ExecutableAction to AgentRecallAction--><g id="link_ExecutableAction_AgentRecallAction"><path codeLine="183" d="M1482.6893,858.1999 C1648.2193,874.8819 2011.72,916.805 2127,975.5 C2154.38,989.44 2179.13,1013.565 2197.03,1034.205 " fill="none" id="ExecutableAction-backto-AgentRecallAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1464.78,856.395,1482.0877,864.1696,1483.2909,852.2301,1464.78,856.395" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Observation to AgentRecallObservation--><g id="link_Observation_AgentRecallObservation"><path codeLine="184" d="M4860.0646,647.2181 C5021.4046,664.7551 5446.67,711.983 5475,726 C5509.86,743.248 5540.41,774.879 5561.82,801.475 " fill="none" id="Observation-backto-AgentRecallObservation" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="4842.17,645.273,4859.4162,653.1829,4860.713,641.2532,4842.17,645.273" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link NotExecutableAction to AgentSummarizeAction--><g id="link_NotExecutableAction_AgentSummarizeAction"><path codeLine="185" d="M1204.9749,885.4974 C1221.9649,913.7144 1247.13,947.154 1292,967.5 C1333.09,986.133 1655.69,959.83 1698,975.5 C1730.35,987.479 1760.22,1012.467 1781.69,1034.014 " fill="none" id="NotExecutableAction-backto-AgentSummarizeAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1195.69,870.077,1199.8348,888.5924,1210.1151,882.4025,1195.69,870.077" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link NotExecutableAction to AgentThinkAction--><g id="link_NotExecutableAction_AgentThinkAction"><path codeLine="186" d="M1205.4261,885.7752 C1222.5861,913.8962 1247.61,946.766 1292,967.5 C1330.09,985.292 1441.65,960.7 1481,975.5 C1509.78,986.324 1536.91,1006.897 1558.08,1026.276 " fill="none" id="NotExecutableAction-backto-AgentThinkAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1196.05,870.41,1200.3044,888.9005,1210.5479,882.6498,1196.05,870.41" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Action to ExecutableAction--><g id="link_Action_ExecutableAction"><path codeLine="187" d="M1383.7531,678.0857 C1384.5131,717.9517 1385.83,785.946 1386.59,825.855 " fill="none" id="Action-backto-ExecutableAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1383.41,660.089,1377.7542,678.2001,1389.752,677.9714,1383.41,660.089" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Action to NotExecutableAction--><g id="link_Action_NotExecutableAction"><path codeLine="188" d="M1346.5,672.5576 C1327.82,689.8756 1314.33,702.895 1292,726 C1259.13,760.017 1222.89,801.497 1201.86,825.995 " fill="none" id="Action-backto-NotExecutableAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1359.7,660.32,1342.4208,668.1576,1350.5792,676.9576,1359.7,660.32" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link NotExecutableAction to NullAction--><g id="link_NotExecutableAction_NullAction"><path codeLine="189" d="M1184,888.382 C1184,928.499 1184,997.104 1184,1042.646 " fill="none" id="NotExecutableAction-backto-NullAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1184,870.382,1178,888.382,1190,888.382,1184,870.382" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link ExecutableAction to CmdKillAction--><g id="link_ExecutableAction_CmdKillAction"><path codeLine="190" d="M1482.718,852.1521 C1705.478,860.2771 2324.21,889.919 2512,975.5 C2541.06,988.745 2567.5,1013.145 2586.57,1034.094 " fill="none" id="ExecutableAction-backto-CmdKillAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1464.73,851.496,1482.4993,858.1481,1482.9367,846.1561,1464.73,851.496" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link ExecutableAction to CmdRunAction--><g id="link_ExecutableAction_CmdRunAction"><path codeLine="191" d="M1482.5595,849.3387 C1730.2295,851.1227 2480.58,865.476 2699,975.5 C2721.87,987.018 2741.56,1007.291 2756.39,1026.293 " fill="none" id="ExecutableAction-backto-CmdRunAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1464.56,849.209,1482.5163,855.3385,1482.6028,843.3388,1464.56,849.209" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link ExecutableAction to BrowseURLAction--><g id="link_ExecutableAction_BrowseURLAction"><path codeLine="192" d="M1482.499,849.7576 C1749.679,852.6316 2612.13,869.89 2871,975.5 C2902.69,988.43 2932.37,1013.113 2953.9,1034.277 " fill="none" id="ExecutableAction-backto-BrowseURLAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1464.5,849.564,1482.4344,855.7573,1482.5635,843.758,1464.5,849.564" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Observation to BrowserOutputObservation--><g id="link_Observation_BrowserOutputObservation"><path codeLine="193" d="M4707.7848,643.4485 C4569.2348,652.0825 4241.84,676.897 4138,726 C4104.97,741.619 4074.66,768.705 4051.64,793.295 " fill="none" id="Observation-backto-BrowserOutputObservation" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="4725.75,642.329,4707.4117,637.4601,4708.158,649.4369,4725.75,642.329" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link ExecutableAction to FileReadAction--><g id="link_ExecutableAction_FileReadAction"><path codeLine="194" d="M1482.6469,852.549 C1794.8669,864.457 2931,911.748 3081,975.5 C3111.08,988.286 3138.46,1012.971 3158.13,1034.173 " fill="none" id="ExecutableAction-backto-FileReadAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1464.66,851.863,1482.4183,858.5447,1482.8756,846.5534,1464.66,851.863" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Observation to FileReadObservation--><g id="link_Observation_FileReadObservation"><path codeLine="195" d="M4707.8076,639.5894 C4620.4276,642.1314 4470.72,656.14 4350,726 C4315.19,746.143 4286,781.91 4267.13,809.351 " fill="none" id="Observation-backto-FileReadObservation" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="4725.8,639.066,4707.6331,633.592,4707.9821,645.5869,4725.8,639.066" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link ExecutableAction to FileWriteAction--><g id="link_ExecutableAction_FileWriteAction"><path codeLine="196" d="M1482.7546,851.2435 C1817.6246,859.4605 3109.11,896.014 3274,975.5 C3297.39,986.773 3317.46,1007.267 3332.5,1026.477 " fill="none" id="ExecutableAction-backto-FileWriteAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1464.76,850.802,1482.6074,857.2417,1482.9018,845.2454,1464.76,850.802" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Observation to FileWriteObservation--><g id="link_Observation_FileWriteObservation"><path codeLine="197" d="M4708.3985,659.6903 C4662.5585,673.6283 4615.76,691.965 4567,726 C4534.31,748.819 4504.56,783.208 4484.44,809.499 " fill="none" id="Observation-backto-FileWriteObservation" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="4725.62,654.454,4706.653,653.9498,4710.1439,665.4308,4725.62,654.454" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link NotExecutableAction to AddTaskAction--><g id="link_NotExecutableAction_AddTaskAction"><path codeLine="198" d="M1204.876,885.6288 C1221.816,913.9658 1246.97,947.513 1292,967.5 C1319.37,979.648 3420.04,964.77 3448,975.5 C3471.59,984.555 3493.31,1001.372 3510.98,1018.462 " fill="none" id="NotExecutableAction-backto-AddTaskAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1195.64,870.179,1199.726,888.7075,1210.0259,882.5502,1195.64,870.179" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link NotExecutableAction to ModifyTaskAction--><g id="link_NotExecutableAction_ModifyTaskAction"><path codeLine="199" d="M1204.8755,885.6311 C1221.8155,913.9701 1246.96,947.52 1292,967.5 C1321.82,980.731 3610.9,962.924 3641,975.5 C3666.29,986.066 3688.38,1006.871 3704.96,1026.465 " fill="none" id="NotExecutableAction-backto-ModifyTaskAction" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="1195.64,870.181,1199.7255,888.7096,1210.0255,882.5526,1195.64,870.181" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Agent to Agent--><g id="link_Agent_Agent"><path codeLine="200" d="M778.6667,604.0754 C799.3387,609.0984 802,618.518 802,638 C802,657.482 787.678,669.735 767.006,674.758 " fill="none" id="Agent-backto-Agent" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="767.006,601.242,771.8919,606.5456,778.6667,604.0754,773.7808,598.7718,767.006,601.242" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Agent to LLM--><g id="link_Agent_LLM"><path codeLine="201" d="M646,696.646 C646,721.281 646,740.375 646,768.742 " fill="none" id="Agent-backto-LLM" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="646,684.646,642,690.646,646,696.646,650,690.646,646,684.646" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link AgentController to Agent--><g id="link_AgentController_Agent"><path codeLine="202" d="M831.954,481.9314 C785.476,520.6904 740.205,558.441 700.632,591.442 " fill="none" id="AgentController-backto-Agent" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="841.17,474.246,834.0002,475.0167,831.954,481.9314,839.1238,481.1607,841.17,474.246" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Observation to AgentErrorObservation--><g id="link_Observation_AgentErrorObservation"><path codeLine="203" d="M4761.6747,684.5213 C4742.2347,724.1633 4715.73,778.224 4696.32,817.789 " fill="none" id="Observation-backto-AgentErrorObservation" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="4769.6,668.36,4756.2875,681.8796,4767.0618,687.1631,4769.6,668.36" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Observation to NullObservation--><g id="link_Observation_NullObservation"><path codeLine="204" d="M4806.3253,684.5213 C4825.7653,724.1633 4852.27,778.224 4871.68,817.789 " fill="none" id="Observation-backto-NullObservation" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="4798.4,668.36,4800.9382,687.1631,4811.7125,681.8796,4798.4,668.36" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Plan to Task--><g id="link_Plan_Task"><path codeLine="205" d="M929.6447,704.5251 C928.1497,722.8211 927.407,731.905 925.727,752.453 " fill="none" id="Plan-backto-Task" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="930.622,692.565,926.1466,698.2193,929.6447,704.5251,934.1201,698.8708,930.622,692.565" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link State to Plan--><g id="link_State_Plan"><path codeLine="206" d="M1238.4982,462.4218 C1191.2682,483.5738 1148.53,502.035 1099,522 C1089.35,525.89 1086.14,525.037 1077,530 C1047.16,546.197 1016.74,568.23 991.758,588.094 " fill="none" id="State-backto-Plan" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="1249.45,457.517,1242.3391,456.3188,1238.4982,462.4218,1245.609,463.62,1249.45,457.517" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link State to CmdOutputObservation--><g id="link_State_CmdOutputObservation"><path codeLine="207" d="M1611.2886,399.2144 C2268.7286,409.2644 4225.15,445.588 4860,530 C5245.6,581.27 5373.87,535.458 5713,726 C5742.8,742.745 5769.92,769.308 5790.62,793.285 " fill="none" id="State-backto-CmdOutputObservation" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="1599.29,399.031,1605.2282,403.1222,1611.2886,399.2144,1605.3504,395.1232,1599.29,399.031" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link State to Action--><g id="link_State_Action"><path codeLine="208" d="M1383,469.751 C1383,521.631 1383,580.747 1383,615.76 " fill="none" id="State-backto-Action" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="1383,457.751,1379,463.751,1383,469.751,1387,463.751,1383,457.751" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link State to Observation--><g id="link_State_Observation"><path codeLine="209" d="M1611.27,412.1752 C2291.47,460.3752 4352.11,606.395 4725.91,632.884 " fill="none" id="State-backto-Observation" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="1599.3,411.327,1605.0023,415.7411,1611.27,412.1752,1605.5677,407.7611,1599.3,411.327" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Observation to CmdOutputObservation--><g id="link_Observation_CmdOutputObservation"><path codeLine="210" d="M4859.958,649.0702 C4968.568,663.2742 5191.95,691.296 5396,708.5 C5466.3,714.427 5648.77,696.811 5713,726 C5745.19,740.629 5773.22,768.295 5793.87,793.483 " fill="none" id="Observation-backto-CmdOutputObservation" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="4842.11,646.736,4859.18,655.0195,4860.7361,643.1208,4842.11,646.736" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link DockerInteractive to BackgroundCommand--><g id="link_DockerInteractive_BackgroundCommand"><path codeLine="211" d="M260,502.558 C260,548.449 260,587.609 260,615.676 " fill="none" id="DockerInteractive-backto-BackgroundCommand" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="260,490.558,256,496.558,260,502.558,264,496.558,260,490.558" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Observation to UserMessageObservation--><g id="link_Observation_UserMessageObservation"><path codeLine="212" d="M4860.1972,640.3987 C4949.0572,643.7517 5103.65,658.602 5231,726 C5268.97,746.094 5302.82,781.867 5325.18,809.323 " fill="none" id="Observation-backto-UserMessageObservation" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="none" points="4842.21,639.72,4859.971,646.3945,4860.4234,634.403,4842.21,639.72" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Task to Task--><g id="link_Task_Task"><path codeLine="213" d="M1006.521,810.4654 C1026.414,812.8604 1029.5,824.416 1029.5,848 C1029.5,871.584 1014.5,884.574 994.607,886.969 " fill="none" id="Task-backto-Task" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="994.607,809.031,1000.0859,813.7195,1006.521,810.4654,1001.0421,805.7769,994.607,809.031" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Session to AgentController--><g id="link_Session_AgentController"><path codeLine="214" d="M776.2487,207.1651 C805.4487,241.5341 836.093,277.598 868.667,315.933 " fill="none" id="Session-backto-AgentController" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="768.479,198.02,769.3155,205.1824,776.2487,207.1651,775.4122,200.0026,768.479,198.02" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--reverse link Session to Agent--><g id="link_Session_Agent"><path codeLine="215" d="M573.0465,205.0112 C561.5085,214.2312 560.714,217.485 553,230 C484.902,340.476 509.72,399.652 553,522 C562.077,547.659 579.582,571.786 596.979,591.25 " fill="none" id="Session-backto-Agent" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="582.421,197.52,575.2367,198.1407,573.0465,205.0112,580.2308,204.3904,582.421,197.52" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link AgentController to State--><g id="link_AgentController_State"><path codeLine="216" d="M1083.31,395 C1111.12,395 1132.92,395 1160.72,395 " fill="none" id="AgentController-to-State" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="1166.72,395,1157.72,391,1161.72,395,1157.72,399,1166.72,395" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link AgentController to Plan--><g id="link_AgentController_Plan"><path codeLine="217" d="M935,474.246 C935,509.843 935,545.074 935,577.129 " fill="none" id="AgentController-to-Plan" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="935,583.129,939,574.129,935,578.129,931,574.129,935,583.129" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link AgentController to CommandManager--><g id="link_AgentController_CommandManager"><path codeLine="218" d="M786.977,395 C768.408,395 755.839,395 737.27,395 " fill="none" id="AgentController-to-CommandManager" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="731.27,395,740.27,399,736.27,395,740.27,391,731.27,395" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link CommandManager to DockerInteractive--><g id="link_CommandManager_DockerInteractive"><path codeLine="219" d="M568.916,395 C535.514,395 508.113,395 474.711,395 " fill="none" id="CommandManager-to-DockerInteractive" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="468.711,395,477.711,399,473.711,395,477.711,391,468.711,395" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><text fill="#D9D3D0" font-family="Verdana" font-size="10" lengthAdjust="spacing" textLength="175" x="2874" y="1211.7822">Based on f3fda42; Generated by</text><text fill="#D9D3D0" font-family="Verdana" font-size="10" font-style="italic" lengthAdjust="spacing" textLength="43" x="3052" y="1211.7822">py2puml</text><!--SRC=[hLZVRzis47xNNy6-3ea3T7loXW5fcWx3agP8KkmXC0HAEjk49L4ZgIHUs_-zHygIA9cEAKiFjgJJyUF7-qMUtgarP42Yj8H2i5m5xmf1LnabfOI_SmKYWuHH1LzelA4ha6H9Kmb14ATKIi8Bo1DuPlcCnefnlAmWLxDB_NyTh_cbaP9l0I4nHxHSpObK0Xz5cUSqIc5E8ivJ55G0rUiV7l2VMCxasffW82AF98XdQc0Du2r8YVXthRo2vHgo8csDyITw3p5DKuleVoM8RGqva6G5rkUOGSO50padDqog9yHQJC7yeSmoAjZ_O96NHkP9Vn_oSStoZGMdrhnShKT6HKGbpAvV8IwL7jp0lptWCrTUOsmVz0tV2Ugtf_DbLNPYnNVzwzbLblp3EcDPCYSwemUYt9Tv9stHttbIEoZ2Ch0IlDIIGIuI_0LNzy5SljxVM3EK8XsU31MGk2jLKQg-Lon4gQWgPHZp16fZW11SDEpz4sF9Kk35x1DUxe4crWeAgjR3br03zTdRQ2Un-rSm1GVexG9MdaRN84_3Lr6vaRFB97d4cmvPOUqIAqvRLvQH6JGdAHOvty2hvhdb2LjkUrEnn8uIS9k4HdX54Td3RukQGGi5h92NBeqVMMoAy1bvt1RmP7GM2_9DJyFY7wYSfXdMwfjRFGuph4X1p_-Pv-1O2IgR7-fNrHw3ETrf8zs2XHlODi-wYeGc0tQ2C86eN8K94tqHIrxtHQraHymOum0r7KwupQGWAdk4bi0i-wfvhihPoZZNlD8heQyXHfGm0IFh17tXOcFOrY5hAb28VpWSnLULuBPwRjtte2ywX5AAZB_WlnwDswKkMlNUU8NFkk0lV7RRQrqg-l7k4UEM5NhiPrto1X3N2h7YelMXN4EQ7ZIwJLDl5oSGr2QQQGjL0KLP7ZQfPiUfpfuvqNbZIxlwZTe1kiOxC-ESAiDjzpJUhvtVRZ3XpdGon0NLtikIlPAlZpfhV6aCQBGUIupRfohJpuYjgdNB8a4gISZo9VSOyBRzNOJiVJDiD-7UJWglJ7Ns9G-tIHmVyTVc-f776n3ccAwhrdDbO8S9TpK99peZ7vhNkrZiL2QMutqUWrq9N3ATfBAWABGBon2fOXdmKhNcoHN65OYGPPWQZLehpsa6Nadn5M-dESsRFAd2lzqmR7CviwRUmyp0xuQn_RhToAhWm_kk2opBjxSrwExHlJFkZBCVEBXGB3uIZQ8Dz51TpQ9U898wZ5J7ubNrcfExGfk7fa-zQhveYtbNfNaHTef2u7be_-Fx-RbdLndu7-kFejhDP73ywD_3ysWb9rk_tKrEm7IldvpIght-SKfeguyCtkott4XEuvyCv5Z1wBNsci5nyRFV84w3rxIA8-6SpU6uw3xK88vZwkm1nn5rj86JSRGwmV4a-ytVw11tj80JOVRRlS3TjltIHMZVUEbRRLbmMaVaC_-fXRtVkeo3xBKPWQkJwAwcEJa5xax0eMrQ0X_jOmTmBv3z4ZzuxidCUsmHHu_zNOvz_RqJ_pYsxkDru3erUyI4-sJQ7JWWgOP2kxDkI1QV_-bkTgU0S-N5oM3UNoM2KxvaTCrmB6A3OCavFc4tAY4Xw9Rbhyk4_lR-T_8NvFgR04gZBRcuABRlYp9BBov-0W00]--></g></svg>diff --git a/docs/static/img/connect-repo.png b/docs/static/img/connect-repo.pngdeleted file mode 100644index 9e5ef94476..0000000000Binary files a/docs/static/img/connect-repo.png and /dev/null differdiff --git a/docs/static/img/jira-admin-configure.png b/docs/static/img/jira-admin-configure.pngdeleted file mode 100644index 088869cdcc..0000000000Binary files a/docs/static/img/jira-admin-configure.png and /dev/null differdiff --git a/docs/static/img/jira-admin-edit.png b/docs/static/img/jira-admin-edit.pngdeleted file mode 100644index 544d57b85d..0000000000Binary files a/docs/static/img/jira-admin-edit.png and /dev/null differdiff --git a/docs/static/img/jira-dc-admin-configure.png b/docs/static/img/jira-dc-admin-configure.pngdeleted file mode 100644index 52dc35e188..0000000000Binary files a/docs/static/img/jira-dc-admin-configure.png and /dev/null differdiff --git a/docs/static/img/jira-dc-admin-edit.png b/docs/static/img/jira-dc-admin-edit.pngdeleted file mode 100644index ff085c308c..0000000000Binary files a/docs/static/img/jira-dc-admin-edit.png and /dev/null differdiff --git a/docs/static/img/jira-dc-user-link.png b/docs/static/img/jira-dc-user-link.pngdeleted file mode 100644index 0fd2e0cfee..0000000000Binary files a/docs/static/img/jira-dc-user-link.png and /dev/null differdiff --git a/docs/static/img/jira-dc-user-unlink.png b/docs/static/img/jira-dc-user-unlink.pngdeleted file mode 100644index 29ea93bf07..0000000000Binary files a/docs/static/img/jira-dc-user-unlink.png and /dev/null differdiff --git a/docs/static/img/jira-user-link.png b/docs/static/img/jira-user-link.pngdeleted file mode 100644index e0868d2c09..0000000000Binary files a/docs/static/img/jira-user-link.png and /dev/null differdiff --git a/docs/static/img/jira-user-unlink.png b/docs/static/img/jira-user-unlink.pngdeleted file mode 100644index 39f07ce0cb..0000000000Binary files a/docs/static/img/jira-user-unlink.png and /dev/null differdiff --git a/docs/static/img/linear-admin-configure.png b/docs/static/img/linear-admin-configure.pngdeleted file mode 100644index 513365604a..0000000000Binary files a/docs/static/img/linear-admin-configure.png and /dev/null differdiff --git a/docs/static/img/linear-admin-edit.png b/docs/static/img/linear-admin-edit.pngdeleted file mode 100644index 930cb22b76..0000000000Binary files a/docs/static/img/linear-admin-edit.png and /dev/null differdiff --git a/docs/static/img/linear-user-link.png b/docs/static/img/linear-user-link.pngdeleted file mode 100644index 83f75107d0..0000000000Binary files a/docs/static/img/linear-user-link.png and /dev/null differdiff --git a/docs/static/img/linear-user-unlink.png b/docs/static/img/linear-user-unlink.pngdeleted file mode 100644index b167402e3d..0000000000Binary files a/docs/static/img/linear-user-unlink.png and /dev/null differdiff --git a/docs/static/img/logo-square.png b/docs/static/img/logo-square.pngdeleted file mode 100644index a260f507bc..0000000000Binary files a/docs/static/img/logo-square.png and /dev/null differdiff --git a/docs/static/img/logo.png b/docs/static/img/logo.pngdeleted file mode 100644index 799c7ee739..0000000000Binary files a/docs/static/img/logo.png and /dev/null differdiff --git a/docs/static/img/oh-features.png b/docs/static/img/oh-features.pngdeleted file mode 100644index 8647d0d378..0000000000Binary files a/docs/static/img/oh-features.png and /dev/null differdiff --git a/docs/static/img/openhands-llm-api-key.png b/docs/static/img/openhands-llm-api-key.pngdeleted file mode 100644index 67efda8ab6..0000000000Binary files a/docs/static/img/openhands-llm-api-key.png and /dev/null differdiff --git a/docs/static/img/openhands-provider-cli.png b/docs/static/img/openhands-provider-cli.pngdeleted file mode 100644index 30437589e9..0000000000Binary files a/docs/static/img/openhands-provider-cli.png and /dev/null differdiff --git a/docs/static/img/results.png b/docs/static/img/results.pngdeleted file mode 100644index 48a6275f49..0000000000Binary files a/docs/static/img/results.png and /dev/null differdiff --git a/docs/static/img/slack-create-conversation.png b/docs/static/img/slack-create-conversation.pngdeleted file mode 100644index 5cdd58542b..0000000000Binary files a/docs/static/img/slack-create-conversation.png and /dev/null differdiff --git a/docs/static/img/slack-pro-tip.png b/docs/static/img/slack-pro-tip.pngdeleted file mode 100644index 74f211f2f9..0000000000Binary files a/docs/static/img/slack-pro-tip.png and /dev/null differdiff --git a/docs/static/img/slack-results-and-follow-up.png b/docs/static/img/slack-results-and-follow-up.pngdeleted file mode 100644index 26a434336a..0000000000Binary files a/docs/static/img/slack-results-and-follow-up.png and /dev/null differdiff --git a/docs/static/img/system_architecture.png b/docs/static/img/system_architecture.pngdeleted file mode 100644index 42c05b1d4a..0000000000Binary files a/docs/static/img/system_architecture.png and /dev/null differdiff --git a/docs/static/img/system_architecture.puml b/docs/static/img/system_architecture.pumldeleted file mode 100644index b1b9713ef4..0000000000--- a/docs/static/img/system_architecture.puml+++ /dev/null@@ -1,67 +0,0 @@-@startuml "System Architecture"---node frontend as frontend{-- component App-- package components{-- component Terminal-- component ChatInterface-- component BannerSettings-- }-- package services{- component chatService-- component settingsService-- chatService -[hidden]u-> settingsService- }-- package socket-- App -> Terminal- App -> ChatInterface- App -> BannerSettings- ChatInterface -> chatService- BannerSettings -> settingsService- Terminal -> socket- chatService -d-> socket- settingsService -d-> socket- services -[hidden]d-> socket-- Terminal -[hidden]u-> ChatInterface- ChatInterface -[hidden]u-> BannerSettings---- interface "HTTP (:3001)" as HTTP- HTTP - App--}--node backend{- package server as serverpackage{- component Server-- 'defined in server/server.py, port is defined at startup with uvicorn- interface "Client WS\n(:3000/ws)" as client_socket- client_socket - Server--- }- node AgentController{-- }- Server -d-> AgentController-}---socket -d-> client_socket: connects to \n VITE_TERMINAL_WS_URL--@endumldiff --git a/docs/static/img/system_architecture.svg b/docs/static/img/system_architecture.svgdeleted file mode 100644index d259a4ca3b..0000000000--- a/docs/static/img/system_architecture.svg+++ /dev/null@@ -1 +0,0 @@-<?xml version="1.0" encoding="us-ascii" standalone="no"?><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentStyleType="text/css" height="763px" preserveAspectRatio="none" style="width:756px;height:763px;background:#003153;" version="1.1" viewBox="0 0 756 763" width="756px" zoomAndPan="magnify"><defs/><g><rect fill="#003153" height="763" style="stroke:none;stroke-width:1.0;" width="756" x="0" y="0"/><!--cluster frontend--><g id="cluster_frontend"><polygon fill="#003153" points="32,21,42,11,657,11,657,418,647,428,32,428,32,21" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="647" x2="657" y1="21" y2="11"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="32" x2="647" y1="21" y2="21"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="647" x2="647" y1="21" y2="428"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="71" x="305" y="36.9951">frontend</text></g><!--cluster components--><g id="cluster_components"><path d="M192.5,75 L293.5,75 A3.75,3.75 0 0 1 296,77.5 L303,97.2969 L371.5,97.2969 A2.5,2.5 0 0 1 374,99.7969 L374,401.5 A2.5,2.5 0 0 1 371.5,404 L192.5,404 A2.5,2.5 0 0 1 190,401.5 L190,77.5 A2.5,2.5 0 0 1 192.5,75 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="190" x2="303" y1="97.2969" y2="97.2969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="100" x="194" y="89.9951">components</text></g><!--cluster services--><g id="cluster_services"><path d="M408.5,67 L475.5,67 A3.75,3.75 0 0 1 478,69.5 L485,89.2969 L622.5,89.2969 A2.5,2.5 0 0 1 625,91.7969 L625,284.5 A2.5,2.5 0 0 1 622.5,287 L408.5,287 A2.5,2.5 0 0 1 406,284.5 L406,69.5 A2.5,2.5 0 0 1 408.5,67 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="406" x2="485" y1="89.2969" y2="89.2969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="66" x="410" y="81.9951">services</text></g><!--cluster backend--><g id="cluster_backend"><polygon fill="#003153" points="518,502,528,492,739,492,739,736,729,746,518,746,518,502" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="729" x2="739" y1="502" y2="492"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="518" x2="729" y1="502" y2="502"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="729" x2="729" y1="502" y2="746"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="67" x="591" y="517.9951">backend</text></g><!--cluster serverpackage--><g id="cluster_serverpackage"><path d="M544.5,540 L595.5,540 A3.75,3.75 0 0 1 598,542.5 L605,562.2969 L712.5,562.2969 A2.5,2.5 0 0 1 715,564.7969 L715,634.5 A2.5,2.5 0 0 1 712.5,637 L544.5,637 A2.5,2.5 0 0 1 542,634.5 L542,542.5 A2.5,2.5 0 0 1 544.5,540 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="542" x2="605" y1="562.2969" y2="562.2969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="50" x="546" y="554.9951">server</text></g><!--entity App--><g id="elem_App"><rect fill="#003153" height="46.2969" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="70" x="101" y="110"/><rect fill="#003153" height="10" style="stroke:#D9D3D0;stroke-width:1.0;" width="15" x="151" y="115"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="149" y="117"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="149" y="121"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="30" x="116" y="142.9951">App</text></g><!--entity socket--><g id="elem_socket"><path d="M521.5,345.5 L588.5,345.5 A3.75,3.75 0 0 1 591,348 L598,367.7969 L612.5,367.7969 A2.5,2.5 0 0 1 615,370.2969 L615,382.2969 A2.5,2.5 0 0 1 612.5,384.7969 L521.5,384.7969 A2.5,2.5 0 0 1 519,382.2969 L519,348 A2.5,2.5 0 0 1 521.5,345.5 " fill="#003153" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="519" x2="598" y1="367.7969" y2="367.7969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" font-weight="bold" lengthAdjust="spacing" textLength="54" x="529" y="361.4951">socket</text></g><!--entity HTTP--><g id="elem_HTTP"><ellipse cx="57" cy="133" fill="#003153" rx="8" ry="8" style="stroke:#D9D3D0;stroke-width:1.0;"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="92" x="11" y="162.9951">HTTP (:3001)</text></g><!--entity Terminal--><g id="elem_Terminal"><rect fill="#003153" height="46.2969" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="103" x="230.5" y="342"/><rect fill="#003153" height="10" style="stroke:#D9D3D0;stroke-width:1.0;" width="15" x="313.5" y="347"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="311.5" y="349"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="311.5" y="353"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="63" x="245.5" y="374.9951">Terminal</text></g><!--entity ChatInterface--><g id="elem_ChatInterface"><rect fill="#003153" height="46.2969" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="140" x="212" y="217"/><rect fill="#003153" height="10" style="stroke:#D9D3D0;stroke-width:1.0;" width="15" x="332" y="222"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="330" y="224"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="330" y="228"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="100" x="227" y="249.9951">ChatInterface</text></g><!--entity BannerSettings--><g id="elem_BannerSettings"><rect fill="#003153" height="46.2969" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="152" x="206" y="110"/><rect fill="#003153" height="10" style="stroke:#D9D3D0;stroke-width:1.0;" width="15" x="338" y="115"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="336" y="117"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="336" y="121"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="112" x="221" y="142.9951">BannerSettings</text></g><!--entity chatService--><g id="elem_chatService"><rect fill="#003153" height="46.2969" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="125" x="430.5" y="217"/><rect fill="#003153" height="10" style="stroke:#D9D3D0;stroke-width:1.0;" width="15" x="535.5" y="222"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="533.5" y="224"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="533.5" y="228"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="85" x="445.5" y="249.9951">chatService</text></g><!--entity settingsService--><g id="elem_settingsService"><rect fill="#003153" height="46.2969" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="152" x="430" y="110"/><rect fill="#003153" height="10" style="stroke:#D9D3D0;stroke-width:1.0;" width="15" x="562" y="115"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="560" y="117"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="560" y="121"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="112" x="445" y="142.9951">settingsService</text></g><!--entity Server--><g id="elem_Server"><rect fill="#003153" height="46.2969" rx="2.5" ry="2.5" style="stroke:#D9D3D0;stroke-width:1.0;" width="87" x="611.5" y="575"/><rect fill="#003153" height="10" style="stroke:#D9D3D0;stroke-width:1.0;" width="15" x="678.5" y="580"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="676.5" y="582"/><rect fill="#003153" height="2" style="stroke:#D9D3D0;stroke-width:1.0;" width="4" x="676.5" y="586"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="47" x="626.5" y="607.9951">Server</text></g><!--entity client_socket--><g id="elem_client_socket"><ellipse cx="567" cy="598" fill="#003153" rx="8" ry="8" style="stroke:#D9D3D0;stroke-width:1.0;"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="70" x="530" y="627.9951">Client WS</text><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="74" x="530" y="644.292">(:3000/ws)</text></g><!--entity AgentController--><g id="elem_AgentController"><polygon fill="#003153" points="565.5,694,575.5,684,722.5,684,722.5,720.2969,712.5,730.2969,565.5,730.2969,565.5,694" style="stroke:#D9D3D0;stroke-width:1.0;"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="712.5" x2="722.5" y1="694" y2="684"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="565.5" x2="712.5" y1="694" y2="694"/><line style="stroke:#D9D3D0;stroke-width:1.0;" x1="712.5" x2="712.5" y1="694" y2="730.2969"/><text fill="#D9D3D0" font-family="Verdana" font-size="14" lengthAdjust="spacing" textLength="117" x="580.5" y="716.9951">AgentController</text></g><!--reverse link settingsService to chatService--><!--link App to Terminal--><g id="link_App_Terminal"><path d="M139.058,156.063 C144.749,190.456 159.659,257.604 194,303 C205.888,318.715 217.9343,328.6872 233.9283,338.7132 " fill="none" id="App-to-Terminal" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="239.012,341.9,233.5109,333.7307,234.7756,339.2443,229.2619,340.509,239.012,341.9" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link App to ChatInterface--><g id="link_App_ChatInterface"><path d="M166.606,156.011 C191.441,173.872 221.4209,195.4328 246.3119,213.3338 " fill="none" id="App-to-ChatInterface" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="251.183,216.837,246.2118,208.3348,247.1237,213.9177,241.5409,214.8296,251.183,216.837" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link App to BannerSettings--><g id="link_App_BannerSettings"><path d="M171.074,133 C182.629,133 188.184,133 199.739,133 " fill="none" id="App-to-BannerSettings" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="205.739,133,196.739,129,200.739,133,196.739,137,205.739,133" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link ChatInterface to chatService--><g id="link_ChatInterface_chatService"><path d="M352.059,240 C378.118,240 398.178,240 424.237,240 " fill="none" id="ChatInterface-to-chatService" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="430.237,240,421.237,236,425.237,240,421.237,244,430.237,240" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link BannerSettings to settingsService--><g id="link_BannerSettings_settingsService"><path d="M358.125,133 C382.001,133 399.876,133 423.752,133 " fill="none" id="BannerSettings-to-settingsService" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="429.752,133,420.752,129,424.752,133,420.752,137,429.752,133" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link Terminal to socket--><g id="link_Terminal_socket"><path d="M333.768,365 C395.416,365 451.065,365 512.714,365 " fill="none" id="Terminal-to-socket" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="518.714,365,509.714,361,513.714,365,509.714,369,518.714,365" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link chatService to socket--><g id="link_chatService_socket"><path d="M506.401,263.274 C520.479,286.674 539.2859,317.9347 552.5449,339.9737 " fill="none" id="chatService-to-socket" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="555.638,345.115,554.4259,335.341,553.0604,340.8306,547.5709,339.4651,555.638,345.115" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link settingsService to socket--><g id="link_settingsService_socket"><path d="M531.174,156.3 C546.496,171.635 564.673,193.427 573,217 C588.484,260.832 580.3113,310.8028 573.4883,339.4038 " fill="none" id="settingsService-to-socket" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="572.096,345.24,578.0752,337.4138,573.2562,340.3765,570.2936,335.5575,572.096,345.24" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link services to socket--><!--reverse link ChatInterface to Terminal--><!--reverse link BannerSettings to ChatInterface--><!--link HTTP to App--><g id="link_HTTP_App"><path d="M66.2578,133 C77.7907,133 89.3236,133 100.8565,133 " fill="none" id="HTTP-App" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link client_socket to Server--><g id="link_client_socket_Server"><path d="M576.281,598 C587.966,598 599.651,598 611.336,598 " fill="none" id="client_socket-Server" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link Server to AgentController--><g id="link_Server_AgentController"><path d="M652.721,621.17 C650.833,639.534 648.7766,659.5334 646.8896,677.8894 " fill="none" id="Server-to-AgentController" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="646.276,683.8579,651.1754,675.3141,646.7873,678.8841,643.2173,674.496,646.276,683.8579" style="stroke:#D9D3D0;stroke-width:1.0;"/></g><!--link socket to client_socket--><g id="link_socket_client_socket"><path d="M567,384.513 C567,431.834 567,549.809 567,582.824 " fill="none" id="socket-to-client_socket" style="stroke:#D9D3D0;stroke-width:1.0;"/><polygon fill="#D9D3D0" points="567,588.824,571,579.824,567,583.824,563,579.824,567,588.824" style="stroke:#D9D3D0;stroke-width:1.0;"/><text fill="#D9D3D0" font-family="Verdana" font-size="13" lengthAdjust="spacing" textLength="75" x="609.5" y="457.0669">connects to</text><text fill="#D9D3D0" font-family="Verdana" font-size="13" lengthAdjust="spacing" textLength="158" x="572" y="472.1997">VITE_TERMINAL_WS_URL</text></g><!--SRC=[VLHDJy904BttLunSr4G4uys32H8IIT0OMkKWXYpj01lARhDT98RmtzsFqkwsrHwsctdlpSwyplP2Rd27i4ptc0dAP104Z2S8Ay6PH9O0oSlzCG3rc2NckumpP186MHQOK4RYBLbZ1UMMNsfyNOHYHnb9_-CCDqIErT5YHM8CMWXFX34K8Kf9sJgtZ9DVJexYcyRe55F9OvK_j7XRzhp8swHKEkX-RcYI8FlQTnyRYhPwUBn5QMFAEr0gpueYvhVk0BMMDU9nDSVjInDy3VnHwBaCWzig6yqcFbPBqu9RyokN74BjKDV7PlUr7broYoDsCIijHPtdA7g3guVxVl_kkgC7MmSCoI1TEykduWOirGShXzwT9XHQQtT5l6suGaEeXkOomHLbcAYA2d7Flcwpdnl8k910SpYJY1e_IOJSPt2WSWDxvICNhCpcj3LCgJvl5iwPQQxVE-IslzWW2-ktSy6ySBTHQJ6sUZLE3DQAFbJ_0C7J5CMnSMCTWSrb1w6cqyu6vqCrxjNneAnJtp6MEKWESmOVusYqY4RJb_7hOBAOXOltwUGN]--></g></svg>diff --git a/docs/static/img/system_architecture_overview.png b/docs/static/img/system_architecture_overview.pngdeleted file mode 100644index a9174fc6ba..0000000000Binary files a/docs/static/img/system_architecture_overview.png and /dev/null differdiff --git a/docs/static/img/teaser.mp4 b/docs/static/img/teaser.mp4deleted file mode 100644index 3d3a28b156..0000000000Binary files a/docs/static/img/teaser.mp4 and /dev/null differdiff --git a/docs/success-stories/index.mdx b/docs/success-stories/index.mdxdeleted file mode 100644index afc71093b3..0000000000--- a/docs/success-stories/index.mdx+++ /dev/null@@ -1,217 +0,0 @@-----title: "Success Stories"-description: "Real-world examples of what you can achieve with OpenHands"------Discover how developers and teams are using OpenHands to automate their software development workflows. From quick fixes to complex projects, see what's possible with AI-powered development assistance.--Check out the [#success-stories](https://www.linen.dev/s/openhands/c/success-stories) channel on our Slack for more!--<Update label="2025-06-13 OpenHands helps frontline support" description="@Joe Pelletier">--## One of the cool things about OpenHands, and especially the Slack Integration, is the ability to empower folks who are on the ‘front lines’ with customers.--For example, often times Support and Customer Success teams will field bug reports, doc questions, and other ‘nits’ from customers. They tend to have few options to deal with this, other than file a feedback ticket with product teams and hope it gets prioritized in an upcoming sprint.--Instead, with tools like OpenHands and the Slack integration, they can request OpenHands to make fixes proactively and then have someone on the engineering team (like a lead engineer, a merge engineer, or even technical product manager) review the PR and approve it — thus reducing the cycle time for ‘quick wins’ from weeks to just a few hours.--Here's how we do that with the OpenHands project:--<iframe- width="560"- height="560"- src="https://www.linen.dev/s/openhands/t/29118545/seems-mcp-config-from-config-toml-is-being-overwritten-hence#629f8e2b-cde8-427e-920c-390557a06cc9"- frameborder="0"- allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"- allowfullscreen-></iframe>--[Original Slack thread](https://www.linen.dev/s/openhands/t/29124350/one-of-the-cool-things-about-openhands-and-especially-the-sl#25029f37-7b0d-4535-9187-83b3e06a4011)--</Update>---<Update label="2025-06-13 Ask OpenHands to show me some love" description="@Graham Neubig">--## Asked openhands to “show me some love” and...--Asked openhands to “show me some love” and it coded up this app for me, actually kinda genuinely feel loved--<video- controls- autoplay- className="w-full aspect-video"- src="/success-stories/stories/2025-06-13-show-love/v1.mp4"-></video>--[Original Slack thread](https://www.linen.dev/s/openhands/t/29100731/asked-openhands-to-show-me-some-love-and-it-coded-up-this-ap#1e08af6b-b7d5-4167-8a53-17e6806555e0)--</Update>--<Update label="2025-06-11 OpenHands does 100% of my infra IAM research for me" description="@Xingyao Wang">--## Now, OpenHands does 100% of my infra IAM research for me--Got an IAM error on GCP? Send a screenshot to OH... and it just works!!!-Can't imagine going back to the early days without OH: I'd spend an entire afternoon figuring how to get IAM right--[Original Slack thread](https://www.linen.dev/s/openhands/t/29100732/now-openhands-does-100-of-my-infra-iam-research-for-me-sweat#20482a73-4e2e-4edd-b6d1-c9e8442fccd1)-----</Update>--<Update label="2025-06-08 OpenHands builds an interactive map for me" description="@Rodrigo Argenton Freire (ODLab)">--## Very simple example, but baby steps....--I am a professor of architecture and urban design. We built, me and some students, an interactive map prototype to help visitors and new students to find important places in the campus. Considering that we lack a lot of knowledge in programming, that was really nice to build and a smooth process.-We first created the main components with all-hands and then adjusted some details locally. Definitely, saved us a lot of time and money.-That's a prototype but we will have all the info by tuesday.-https://buriti-emau.github.io/Mapa-UFU/--[Original Slack thread](https://www.linen.dev/s/openhands/t/29100736/very-simple-example-but-baby-steps-i-am-a-professor-of-archi#8f2e3f3f-44e6-44ea-b9a8-d53487470179)----</Update>---<Update label="2025-06-06 Web Search Saves the Day" description="@Ian Walker">--## Tavily adapter helps solve persistent debugging issue--Big congratulations to the new [Tavily adapter](https://www.all-hands.dev/blog/building-a-provably-versatile-agent)... OpenHands and I have been beavering away at a Lightstreamer client library for most of this week but were getting a persistent (and unhelpful) "unexpected error" from the server.--Coming back to the problem today, after trying several unsuccessful fixes prompted by me, OH decided all by itself to search the web, and found the cause of the problem (of course it was simply CRLF line endings...). I was on the verge of giving up - good thing OH has more stamina than me!--This demonstrates how OpenHands' web search capabilities can help solve debugging issues that would otherwise require extensive manual research.--<iframe- width="560"- height="560"- src="https://www.linen.dev/s/openhands/t/29100737/big-congratulations-to-the-new-tavily-adapter-openhands-and-#87b027e5-188b-425e-8aa9-719dcb4929f4"- title="YouTube video player"- frameborder="0"- allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"- allowfullscreen-></iframe>---[Original Slack thread](https://www.linen.dev/s/openhands/t/29100737/big-congratulations-to-the-new-tavily-adapter-openhands-and-#76f1fb26-6ef7-4709-b9ea-fb99105e47e4)--</Update>--<Update label="2025-06-05 OpenHands updates my personal website for a new paper" description="@Xingyao Wang">--## I asked OpenHands to update my personal website for the "OpenHands Versa" paper.--It is an extremely trivial task: You just need to browse to arxiv, copy the author names, format them for BibTeX, and then modify the papers.bib file. But now I'm getting way too lazy to even open my IDE and actually do this one-file change!--[Original Tweet/X thread](https://x.com/xingyaow_/status/1930796287919542410)--[Original Slack thread](https://www.linen.dev/s/openhands/t/29100738/i-asked-openhands-to-update-my-personal-website-for-the-open#f0324022-b12b-4d34-b12b-bdbc43823f69)--</Update>--<Update label="2025-06-02 OpenHands makes an animated gif of swe-bench verified scores over time" description="@Graham Neubig">--## I asked OpenHands to make an animated gif of swe-bench verified scores over time.--It took a bit of prompting but ended up looking pretty nice I think--<video width="560" height="315" autoPlay loop muted src="/success-stories/stories/2025-06-02-swebench-score/s1.mp4"></video>--[Original Slack thread](https://www.linen.dev/s/openhands/t/29100744/i-asked-openhands-to-make-an-animated-gif-of-swe-bench-verif#fb3b82c9-6222-4311-b97b-b2ac1cfe6dff)--</Update>--<Update label="2025-05-30 AWS Troubleshooting" description="@Graham Neubig">--## Quick AWS security group fix--I really don't like trying to fix issues with AWS, especially security groups and other finicky things like this. But I started up an instance and wasn't able to ssh in. So I asked OpenHands:--> Currently, the following ssh command is timing out:->-> $ ssh -i gneubig.pem [email protected]-> ssh: connect to host XXX.us-east-2.compute.amazonaws.com port 22: Operation timed out->-> Use the provided AWS credentials to take a look at i-XXX and examine why--And 2 minutes later I was able to SSH in!--This shows how OpenHands can quickly diagnose and fix AWS infrastructure issues that would normally require manual investigation.--[Original Slack thread](https://www.linen.dev/s/openhands/t/29100747/i-really-don-t-like-trying-to-fix-issues-with-aws-especially#d92a66d2-3bc1-4467-9d09-dc983004d083)--</Update>---<Update label="2025-05-04 Chrome Extension Development" description="@Xingyao Wang">--## OpenHands builds Chrome extension for GitHub integration--I asked OpenHands to write a Chrome extension based on our [OpenHands Cloud API](https://docs.all-hands.dev/modules/usage/cloud/cloud-api). Once installed, you can now easily launch an OpenHands cloud session from your GitHub webpage/PR!--This demonstrates OpenHands' ability to create browser extensions and integrate with external APIs, enabling seamless workflows between GitHub and OpenHands Cloud.-----[GitHub Repository](https://github.com/xingyaoww/openhands-chrome-extension)--[Original Slack thread](https://www.linen.dev/s/openhands/t/29100755/i-asked-openhands-to-write-a-chrome-extension-based-on-our-h#88f14b7f-f8ff-40a6-83c2-bd64e95924c5)--</Update>---<Update label="2025-04-11 Visual UI Testing" description="@Xingyao Wang">--## OpenHands tests UI automatically with visual browsing--Thanks to visual browsing -- OpenHands can actually test some simple UI by serving the website, clicking the button in the browser and looking at screenshots now!--Prompt is just:-```-I want to create a Hello World app in Javascript that:-* Displays Hello World in the middle.-* Has a button that when clicked, changes the greeting with a bouncing animation to fun versions of Hello.-* Has a counter for how many times the button has been clicked.-* Has another button that changes the app's background color.-```--Eager-to-work Sonnet 3.7 will test stuff for you without you asking!--This showcases OpenHands' visual browsing capabilities, enabling it to create, serve, and automatically test web applications through actual browser interactions and screenshot analysis.----[Original Slack thread](https://www.linen.dev/s/openhands/t/29100764/thanks-to-u07k0p3bdb9-s-visual-browsing-openhands-can-actual#21beb9bc-1a04-4272-87e9-4d3e3b9925e7)--</Update>--<Update label="2025-03-07 Proactive Error Handling" description="@Graham Neubig">--## OpenHands fixes crashes before you notice them--Interesting story, I asked OpenHands to start an app on port 12000, it showed up on the app pane. I started using the app, and then it crashed... But because it crashed in OpenHands, OpenHands immediately saw the error message and started fixing the problem without me having to do anything. It was already fixing the problem before I even realized what was going wrong.--This demonstrates OpenHands' proactive monitoring capabilities - it doesn't just execute commands, but actively watches for errors and begins remediation automatically, often faster than human reaction time.--</Update>--<Update label="2024-12-03 Creative Design Acceleration" description="@Rohit Malhotra">--## Pair programming for interactive design projects--Used OpenHands as a pair programmer to do heavy lifting for a creative/interactive design project in p5js.--I usually take around 2 days for high fidelity interactions (planning strategy + writing code + circling back with designer), did this in around 5hrs instead with the designer watching curiously the entire time.--This showcases how OpenHands can accelerate creative and interactive design workflows, reducing development time by 75% while maintaining high quality output.--[Original Tweet](https://x.com/rohit_malh5/status/1863995531657425225)--</Update>diff --git a/docs/success-stories/stories/2025-04-11-visual-ui/s1.png b/docs/success-stories/stories/2025-04-11-visual-ui/s1.pngdeleted file mode 100644index bcfaffd986..0000000000Binary files a/docs/success-stories/stories/2025-04-11-visual-ui/s1.png and /dev/null differdiff --git a/docs/success-stories/stories/2025-05-04-chrome-extension/s1.png b/docs/success-stories/stories/2025-05-04-chrome-extension/s1.pngdeleted file mode 100644index f9c7742831..0000000000Binary files a/docs/success-stories/stories/2025-05-04-chrome-extension/s1.png and /dev/null differdiff --git a/docs/success-stories/stories/2025-05-04-chrome-extension/s2.png b/docs/success-stories/stories/2025-05-04-chrome-extension/s2.pngdeleted file mode 100644index c26d5a6ec9..0000000000Binary files a/docs/success-stories/stories/2025-05-04-chrome-extension/s2.png and /dev/null differdiff --git a/docs/success-stories/stories/2025-06-02-swebench-score/s1.mp4 b/docs/success-stories/stories/2025-06-02-swebench-score/s1.mp4deleted file mode 100644index 0ced83feda..0000000000Binary files a/docs/success-stories/stories/2025-06-02-swebench-score/s1.mp4 and /dev/null differdiff --git a/docs/success-stories/stories/2025-06-08-map/s1.png b/docs/success-stories/stories/2025-06-08-map/s1.pngdeleted file mode 100644index 1584c3143c..0000000000Binary files a/docs/success-stories/stories/2025-06-08-map/s1.png and /dev/null differdiff --git a/docs/success-stories/stories/2025-06-11-infra-iam/s1.png b/docs/success-stories/stories/2025-06-11-infra-iam/s1.pngdeleted file mode 100644index a759c8ca0a..0000000000Binary files a/docs/success-stories/stories/2025-06-11-infra-iam/s1.png and /dev/null differdiff --git a/docs/success-stories/stories/2025-06-11-infra-iam/s2.png b/docs/success-stories/stories/2025-06-11-infra-iam/s2.pngdeleted file mode 100644index 988717c5eb..0000000000Binary files a/docs/success-stories/stories/2025-06-11-infra-iam/s2.png and /dev/null differdiff --git a/docs/success-stories/stories/2025-06-13-show-love/v1.mp4 b/docs/success-stories/stories/2025-06-13-show-love/v1.mp4deleted file mode 100644index a917130a9e..0000000000Binary files a/docs/success-stories/stories/2025-06-13-show-love/v1.mp4 and /dev/null differdiff --git a/docs/usage/about.mdx b/docs/usage/about.mdxdeleted file mode 100644index 0d52f410ba..0000000000--- a/docs/usage/about.mdx+++ /dev/null@@ -1,30 +0,0 @@-----title: About OpenHands------## Research Strategy--Achieving full replication of production-grade applications with LLMs is a complex endeavor. Our strategy involves:--- **Core Technical Research:** Focusing on foundational research to understand and improve the technical aspects of code generation and handling.-- **Task Planning:** Developing capabilities for bug detection, codebase management, and optimization.-- **Evaluation:** Establishing comprehensive evaluation metrics to better understand and improve our agents.--## Default Agent--Our default Agent is currently the [CodeActAgent](./agents), which is capable of generating code and handling files.--## Built With--OpenHands is built using a combination of powerful frameworks and libraries, providing a robust foundation for its-development. Here are the key technologies used in the project:--       --Please note that the selection of these technologies is in progress, and additional technologies may be added or-existing ones may be removed as the project evolves. We strive to adopt the most suitable and efficient tools to-enhance the capabilities of OpenHands.--## License--Distributed under MIT [License](https://github.com/All-Hands-AI/OpenHands/blob/main/LICENSE).diff --git a/docs/usage/agents.mdx b/docs/usage/agents.mdxdeleted file mode 100644index ec51228bcf..0000000000--- a/docs/usage/agents.mdx+++ /dev/null@@ -1,26 +0,0 @@-----title: Main Agent and Capabilities------## CodeActAgent--### Description--This agent implements the CodeAct idea ([paper](https://arxiv.org/abs/2402.01030), [tweet](https://twitter.com/xingyaow_/status/1754556835703751087)) that consolidates LLM agents’ **act**ions into a-unified **code** action space for both _simplicity_ and _performance_.--The conceptual idea is illustrated below. At each turn, the agent can:--1. **Converse**: Communicate with humans in natural language to ask for clarification, confirmation, etc.-2. **CodeAct**: Choose to perform the task by executing code--- Execute any valid Linux `bash` command-- Execute any valid `Python` code with [an interactive Python interpreter](https://ipython.org/). This is simulated through `bash` command, see plugin system below for more details.----### Demo--https://github.com/All-Hands-AI/OpenHands/assets/38853559/f592a192-e86c-4f48-ad31-d69282d5f6ac--_Example of CodeActAgent with `gpt-4-turbo-2024-04-09` performing a data science task (linear regression)_.diff --git a/docs/usage/architecture/backend.mdx b/docs/usage/architecture/backend.mdxdeleted file mode 100644index 2a97e7e51c..0000000000--- a/docs/usage/architecture/backend.mdx+++ /dev/null@@ -1,103 +0,0 @@-----title: Backend Architecture-------This is a high-level overview of the system architecture. The system is divided into two main components: the frontend and the backend. The frontend is responsible for handling user interactions and displaying the results. The backend is responsible for handling the business logic and executing the agents.--# System overview--```mermaid-flowchart LR- U["User"] --> FE["Frontend (SPA)"]- FE -- "HTTP/WS" --> BE["OpenHands Backend"]- BE --> ES["EventStream"]- BE --> ST["Storage"]- BE --> RT["Runtime Interface"]- BE --> LLM["LLM Providers"]-- subgraph Runtime- direction TB- RT --> DRT["Docker Runtime"]- RT --> LRT["Local Runtime"]- RT --> RRT["Remote Runtime"]- DRT --> AES["Action Execution Server"]- LRT --> AES- RRT --> AES- AES --> Bash["Bash Session"]- AES --> Jupyter["Jupyter Plugin"]- AES --> Browser["BrowserEnv"]- end-```--This Overview is simplified to show the main components and their interactions. For a more detailed view of the backend architecture, see the Backend Architecture section below.--# Backend Architecture---```mermaid-classDiagram- class Agent {- <<abstract>>- +sandbox_plugins: list[PluginRequirement]- }- class CodeActAgent {- +tools- }- Agent <|-- CodeActAgent-- class EventStream- class Observation- class Action- Action --> Observation- Agent --> EventStream-- class Runtime {- +connect()- +send_action_for_execution()- }- class ActionExecutionClient {- +_send_action_server_request()- }- class DockerRuntime- class LocalRuntime- class RemoteRuntime- Runtime <|-- ActionExecutionClient- ActionExecutionClient <|-- DockerRuntime- ActionExecutionClient <|-- LocalRuntime- ActionExecutionClient <|-- RemoteRuntime-- class ActionExecutionServer {- +/execute_action- +/alive- }- class BashSession- class JupyterPlugin- class BrowserEnv- ActionExecutionServer --> BashSession- ActionExecutionServer --> JupyterPlugin- ActionExecutionServer --> BrowserEnv-- Agent --> Runtime- Runtime ..> ActionExecutionServer : REST-```--<details>- <summary>Updating this Diagram</summary>- <div>- We maintain architecture diagrams inline with Mermaid in this MDX.-- Guidance:- - Edit the Mermaid blocks directly (flowchart/classDiagram).- - Quote labels and edge text for GitHub preview compatibility.- - Keep relationships concise and reflect stable abstractions (agents, runtime client/server, plugins).- - Verify accuracy against code:- - openhands/runtime/impl/action_execution/action_execution_client.py- - openhands/runtime/impl/docker/docker_runtime.py- - openhands/runtime/impl/local/local_runtime.py- - openhands/runtime/action_execution_server.py- - openhands/runtime/plugins/*- - Build docs locally or view on GitHub to confirm diagrams render.-- </div>-</details>diff --git a/docs/usage/architecture/runtime.mdx b/docs/usage/architecture/runtime.mdxdeleted file mode 100644index 7e6666c006..0000000000--- a/docs/usage/architecture/runtime.mdx+++ /dev/null@@ -1,170 +0,0 @@-----title: Runtime Architecture------The OpenHands Docker Runtime is the core component that enables secure and flexible execution of AI agent's action.-It creates a sandboxed environment using Docker, where arbitrary code can be run safely without risking the host system.--## Why do we need a sandboxed runtime?--OpenHands needs to execute arbitrary code in a secure, isolated environment for several reasons:--1. Security: Executing untrusted code can pose significant risks to the host system. A sandboxed environment prevents malicious code from accessing or modifying the host system's resources-2. Consistency: A sandboxed environment ensures that code execution is consistent across different machines and setups, eliminating "it works on my machine" issues-3. Resource Control: Sandboxing allows for better control over resource allocation and usage, preventing runaway processes from affecting the host system-4. Isolation: Different projects or users can work in isolated environments without interfering with each other or the host system-5. Reproducibility: Sandboxed environments make it easier to reproduce bugs and issues, as the execution environment is consistent and controllable--## How does the Runtime work?--The OpenHands Runtime system uses a client-server architecture implemented with Docker containers. Here's an overview of how it works:--```mermaid-graph TD- A[User-provided Custom Docker Image] --> B[OpenHands Backend]- B -->|Builds| C[OH Runtime Image]- C -->|Launches| D[Action Executor]- D -->|Initializes| E[Browser]- D -->|Initializes| F[Bash Shell]- D -->|Initializes| G[Plugins]- G -->|Initializes| L[Jupyter Server]-- B -->|Spawn| H[Agent]- B -->|Spawn| I[EventStream]- I <--->|Execute Action to- Get Observation- via REST API- | D-- H -->|Generate Action| I- I -->|Obtain Observation| H-- subgraph "Docker Container"- D- E- F- G- L- end-```--1. User Input: The user provides a custom base Docker image-2. Image Building: OpenHands builds a new Docker image (the "OH runtime image") based on the user-provided image. This new image includes OpenHands-specific code, primarily the "runtime client"-3. Container Launch: When OpenHands starts, it launches a Docker container using the OH runtime image-4. Action Execution Server Initialization: The action execution server initializes an `ActionExecutor` inside the container, setting up necessary components like a bash shell and loading any specified plugins-5. Communication: The OpenHands backend (client: `openhands/runtime/impl/action_execution/action_execution_client.py`; runtimes: `openhands/runtime/impl/docker/docker_runtime.py`, `openhands/runtime/impl/local/local_runtime.py`) communicates with the action execution server over RESTful API, sending actions and receiving observations-6. Action Execution: The runtime client receives actions from the backend, executes them in the sandboxed environment, and sends back observations-7. Observation Return: The action execution server sends execution results back to the OpenHands backend as observations--The role of the client:--- It acts as an intermediary between the OpenHands backend and the sandboxed environment-- It executes various types of actions (shell commands, file operations, Python code, etc.) safely within the container-- It manages the state of the sandboxed environment, including the current working directory and loaded plugins-- It formats and returns observations to the backend, ensuring a consistent interface for processing results--## How OpenHands builds and maintains OH Runtime images--OpenHands' approach to building and managing runtime images ensures efficiency, consistency, and flexibility in creating and maintaining Docker images for both production and development environments.--Check out the [relevant code](https://github.com/All-Hands-AI/OpenHands/blob/main/openhands/runtime/utils/runtime_build.py) if you are interested in more details.--### Image Tagging System--OpenHands uses a three-tag system for its runtime images to balance reproducibility with flexibility.-The tags are:--- **Versioned Tag**: `oh_v{openhands_version}_{base_image}` (e.g.: `oh_v0.9.9_nikolaik_s_python-nodejs_t_python3.12-nodejs22`)-- **Lock Tag**: `oh_v{openhands_version}_{16_digit_lock_hash}` (e.g.: `oh_v0.9.9_1234567890abcdef`)-- **Source Tag**: `oh_v{openhands_version}_{16_digit_lock_hash}_{16_digit_source_hash}`- (e.g.: `oh_v0.9.9_1234567890abcdef_1234567890abcdef`)--#### Source Tag - Most Specific--This is the first 16 digits of the MD5 of the directory hash for the source directory. This gives a hash-for only the openhands source--#### Lock Tag--This hash is built from the first 16 digits of the MD5 of:--- The name of the base image upon which the image was built (e.g.: `nikolaik/python-nodejs:python3.12-nodejs22`)-- The content of the `pyproject.toml` included in the image.-- The content of the `poetry.lock` included in the image.--This effectively gives a hash for the dependencies of Openhands independent of the source code.--#### Versioned Tag - Most Generic--This tag is a concatenation of openhands version and the base image name (transformed to fit in tag standard).--#### Build Process--When generating an image...--- **No re-build**: OpenHands first checks whether an image with the same **most specific source tag** exists. If there is such an image,- no build is performed - the existing image is used.-- **Fastest re-build**: OpenHands next checks whether an image with the **generic lock tag** exists. If there is such an image,- OpenHands builds a new image based upon it, bypassing all installation steps (like `poetry install` and- `apt-get`) except a final operation to copy the current source code. The new image is tagged with a- **source** tag only.-- **Ok-ish re-build**: If neither a **source** nor **lock** tag exists, an image will be built based upon the **versioned** tag image.- In versioned tag image, most dependencies should already been installed hence saving time.-- **Slowest re-build**: If all of the three tags don't exists, a brand new image is built based upon the base- image (Which is a slower operation). This new image is tagged with all the **source**, **lock**, and **versioned** tags.--This tagging approach allows OpenHands to efficiently manage both development and production environments.--1. Identical source code and Dockerfile always produce the same image (via hash-based tags)-2. The system can quickly rebuild images when minor changes occur (by leveraging recent compatible images)-3. The **lock** tag (e.g., `runtime:oh_v0.9.3_1234567890abcdef`) always points to the latest build for a particular base image, dependency, and OpenHands version combination--## Volume mounts: named volumes and overlay--OpenHands supports both bind mounts and Docker named volumes in SandboxConfig.volumes:--- Bind mount: "/abs/host/path:/container/path[:mode]"-- Named volume: "volume:`<name>`:/container/path[:mode]" or any non-absolute host spec treated as a named volume--Overlay mode (copy-on-write layer) is supported for bind mounts by appending ":overlay" to the mode (e.g., ":ro,overlay").-To enable overlay COW, set SANDBOX_VOLUME_OVERLAYS to a writable host directory; per-container upper/work dirs are created under it. If SANDBOX_VOLUME_OVERLAYS is unset, overlay mounts are skipped.--Implementation references:-- openhands/runtime/impl/docker/docker_runtime.py (named volumes in _build_docker_run_args; overlay mounts in _process_overlay_mounts)-- openhands/core/config/sandbox_config.py (volumes field)---## Runtime Plugin System--The OpenHands Runtime supports a plugin system that allows for extending functionality and customizing the runtime environment. Plugins are initialized when the action execution server starts up inside the runtime.--## Ports and URLs--- Host port allocation uses file-locked ranges for stability and concurrency:- - Main runtime port: find_available_port_with_lock on configured range- - VSCode port: SandboxConfig.sandbox.vscode_port if provided, else find_available_port_with_lock in VSCODE_PORT_RANGE- - App ports: two additional ranges for plugin/web apps-- DOCKER_HOST_ADDR (if set) adjusts how URLs are formed for LocalRuntime/Docker environments.-- VSCode URL is exposed with a connection token from the action execution server endpoint /vscode/connection_token and rendered as:- - Docker/Local: http://localhost:{port}/?tkn={token}&folder={workspace_mount_path_in_sandbox}- - RemoteRuntime: scheme://vscode-{host}/?tkn={token}&folder={workspace_mount_path_in_sandbox}--References:-- openhands/runtime/impl/docker/docker_runtime.py (port ranges, locking, DOCKER_HOST_ADDR, vscode_url)-- openhands/runtime/impl/local/local_runtime.py (vscode_url factory)-- openhands/runtime/impl/remote/remote_runtime.py (vscode_url mapping)-- openhands/runtime/action_execution_server.py (/vscode/connection_token)---Examples:-- Jupyter: openhands/runtime/plugins/jupyter/__init__.py (JupyterPlugin, Kernel Gateway)-- VS Code: openhands/runtime/plugins/vscode/* (VSCodePlugin, exposes tokenized URL)-- Agent Skills: openhands/runtime/plugins/agent_skills/*--Key aspects of the plugin system:--1. Plugin Definition: Plugins are defined as Python classes that inherit from a base `Plugin` class-2. Plugin Registration: Available plugins are registered in `openhands/runtime/plugins/__init__.py` via `ALL_PLUGINS`-3. Plugin Specification: Plugins are associated with `Agent.sandbox_plugins: list[PluginRequirement]`. Users can specify which plugins to load when initializing the runtime-4. Initialization: Plugins are initialized asynchronously when the runtime starts and are accessible to actions-5. Usage: Plugins extend capabilities (e.g., Jupyter for IPython cells); the server exposes any web endpoints (ports) via host port mappingdiff --git a/docs/usage/cloud/bitbucket-installation.mdx b/docs/usage/cloud/bitbucket-installation.mdxdeleted file mode 100644index 7f6e15595a..0000000000--- a/docs/usage/cloud/bitbucket-installation.mdx+++ /dev/null@@ -1,49 +0,0 @@-----title: Bitbucket Integration-description: This guide walks you through the process of installing OpenHands Cloud for your Bitbucket repositories. Once- set up, it will allow OpenHands to work with your Bitbucket repository.------## Prerequisites--- Signed in to [OpenHands Cloud](https://app.all-hands.dev) with [a Bitbucket account](/usage/cloud/openhands-cloud).--## Adding Bitbucket Repository Access--Upon signing into OpenHands Cloud with a Bitbucket account, OpenHands will have access to your repositories.--## Working With Bitbucket Repos in Openhands Cloud--After signing in with a Bitbucket account, use the `Open Repository` section to select the appropriate repository and-branch you'd like OpenHands to work on. Then click on `Launch` to start the conversation!----## IP Whitelisting--If your Bitbucket Cloud instance has IP restrictions, you'll need to whitelist the following IP addresses to allow-OpenHands to access your repositories:--### Core App IP-```-34.68.58.200-```--### Runtime IPs-```-34.10.175.217-34.136.162.246-34.45.0.142-34.28.69.126-35.224.240.213-34.70.174.52-34.42.4.87-35.222.133.153-34.29.175.97-34.60.55.59-```--## Next Steps--- [Learn about the Cloud UI](/usage/cloud/cloud-ui).-- [Use the Cloud API](/usage/cloud/cloud-api) to programmatically interact with OpenHands.diff --git a/docs/usage/cloud/cloud-api.mdx b/docs/usage/cloud/cloud-api.mdxdeleted file mode 100644index 693b85050a..0000000000--- a/docs/usage/cloud/cloud-api.mdx+++ /dev/null@@ -1,122 +0,0 @@-----title: Cloud API-description: OpenHands Cloud provides a REST API that allows you to programmatically interact with OpenHands.- This guide explains how to obtain an API key and use the API to start conversations and retrieve their status.------For the available API endpoints, refer to the-[OpenHands API Reference](https://docs.all-hands.dev/api-reference).--## Obtaining an API Key--To use the OpenHands Cloud API, you'll need to generate an API key:--1. Log in to your [OpenHands Cloud](https://app.all-hands.dev) account.-2. Navigate to the [Settings > API Keys](https://app.all-hands.dev/settings/api-keys) page.-3. Click `Create API Key`.-4. Give your key a descriptive name (Example: "Development" or "Production") and select `Create`.-5. Copy the generated API key and store it securely. It will only be shown once.--## API Usage Example--### Starting a New Conversation--To start a new conversation with OpenHands to perform a task,-[you'll need to make a POST request to the conversation endpoint](/api-reference/new-conversation).--<Tabs>- <Tab title="cURL">- ```bash- curl -X POST "https://app.all-hands.dev/api/conversations" \- -H "Authorization: Bearer YOUR_API_KEY" \- -H "Content-Type: application/json" \- -d '{- "initial_user_msg": "Check whether there is any incorrect information in the README.md file and send a PR to fix it if so.",- "repository": "yourusername/your-repo"- }'- ```- </Tab>- <Tab title="Python (with requests)">- ```python- import requests-- api_key = "YOUR_API_KEY"- url = "https://app.all-hands.dev/api/conversations"-- headers = {- "Authorization": f"Bearer {api_key}",- "Content-Type": "application/json"- }-- data = {- "initial_user_msg": "Check whether there is any incorrect information in the README.md file and send a PR to fix it if so.",- "repository": "yourusername/your-repo"- }-- response = requests.post(url, headers=headers, json=data)- conversation = response.json()-- print(f"Conversation Link: https://app.all-hands.dev/conversations/{conversation['conversation_id']}")- print(f"Status: {conversation['status']}")- ```- </Tab>- <Tab title="TypeScript/JavaScript (with fetch)">- ```typescript- const apiKey = "YOUR_API_KEY";- const url = "https://app.all-hands.dev/api/conversations";-- const headers = {- "Authorization": `Bearer ${apiKey}`,- "Content-Type": "application/json"- };-- const data = {- initial_user_msg: "Check whether there is any incorrect information in the README.md file and send a PR to fix it if so.",- repository: "yourusername/your-repo"- };-- async function startConversation() {- try {- const response = await fetch(url, {- method: "POST",- headers: headers,- body: JSON.stringify(data)- });-- const conversation = await response.json();-- console.log(`Conversation Link: https://app.all-hands.dev/conversations/${conversation.id}`);- console.log(`Status: ${conversation.status}`);-- return conversation;- } catch (error) {- console.error("Error starting conversation:", error);- }- }-- startConversation();- ```- </Tab>-</Tabs>--#### Response--The API will return a JSON object with details about the created conversation:--```json-{- "status": "ok",- "conversation_id": "abc1234",-}-```--You may receive an `AuthenticationError` if:--- You provided an invalid API key.-- You provided the wrong repository name.-- You don't have access to the repository.--## Rate Limits--If you have too many conversations running at once, older conversations will be paused to limit the number of concurrent conversations.-If you're running into issues and need a higher limit for your use case, please contact us at [[email protected]](mailto:[email protected]).diff --git a/docs/usage/cloud/cloud-ui.mdx b/docs/usage/cloud/cloud-ui.mdxdeleted file mode 100644index 4288f74956..0000000000--- a/docs/usage/cloud/cloud-ui.mdx+++ /dev/null@@ -1,54 +0,0 @@-----title: Cloud UI-description: The Cloud UI provides a web interface for interacting with OpenHands. This page provides references on- how to use the OpenHands Cloud UI.------## Landing Page--The landing page is where you can:--- [Select a GitHub repo](/usage/cloud/github-installation#working-with-github-repos-in-openhands-cloud),- [a GitLab repo](/usage/cloud/gitlab-installation#working-with-gitlab-repos-in-openhands-cloud) or- [a Bitbucket repo](/usage/cloud/bitbucket-installation#working-with-bitbucket-repos-in-openhands-cloud) to start working on.-- Launch an empty conversation using `New Conversation`.-- See `Suggested Tasks` for repositories that OpenHands has access to.-- See your `Recent Conversations`.--## Settings--Settings are divided across tabs, with each tab focusing on a specific area of configuration.--- `User`- - Change your email address.-- `Integrations`- - [Configure GitHub repository access](/usage/cloud/github-installation#modifying-repository-access) for OpenHands.- - [Install the OpenHands Slack app](/usage/cloud/slack-installation).-- `Application`- - Set your preferred language, notifications and other preferences.- - Toggle task suggestions on GitHub.- - Toggle Solvability Analysis.- - Set a maximum budget per conversation.- - Configure the username and email that OpenHands uses for commits.-- `LLM` (Available for [Pro subscription users](/usage/cloud/pro-subscription))- - Choose to use another LLM or use different models from the OpenHands provider.-- `Billing`- - Add credits for using the OpenHands provider.- - Cancel your `Pro subscription`.-- `Secrets`- - [Manage secrets](/usage/settings/secrets-settings).-- `API Keys`- - [Create API keys to work with OpenHands programmatically](/usage/cloud/cloud-api).-- `MCP`- - [Setup an MCP server](/usage/settings/mcp-settings)--## Key Features--For an overview of the key features available inside a conversation, please refer to the [Key Features](/usage/key-features)-section of the documentation.--## Next Steps--- [Install GitHub Integration](/usage/cloud/github-installation) to use OpenHands with your GitHub repositories.-- [Install GitLab Integration](/usage/cloud/gitlab-installation) to use OpenHands with your GitLab repositories.-- [Use the Cloud API](/usage/cloud/cloud-api) to programmatically interact with OpenHands.diff --git a/docs/usage/cloud/github-installation.mdx b/docs/usage/cloud/github-installation.mdxdeleted file mode 100644index 68636eadb6..0000000000--- a/docs/usage/cloud/github-installation.mdx+++ /dev/null@@ -1,79 +0,0 @@-----title: GitHub Integration-description: This guide walks you through the process of installing OpenHands Cloud for your GitHub repositories. Once- set up, it will allow OpenHands to work with your GitHub repository through the Cloud UI or straight from GitHub!------## Prerequisites--- Signed in to [OpenHands Cloud](https://app.all-hands.dev) with [a GitHub account](/usage/cloud/openhands-cloud).--## Adding GitHub Repository Access--You can grant OpenHands access to specific GitHub repositories:--1. Click on `+ Add GitHub Repos` in the repository selection dropdown.-2. Select your organization and choose the specific repositories to grant OpenHands access to.-<Accordion title="OpenHands permissions">- - OpenHands requests short-lived tokens (8-hour expiration) with these permissions:- - Actions: Read and write- - Commit statuses: Read and write- - Contents: Read and write- - Issues: Read and write- - Metadata: Read-only- - Pull requests: Read and write- - Webhooks: Read and write- - Workflows: Read and write- - Repository access for a user is granted based on:- - Permission granted for the repository- - User's GitHub permissions (owner/collaborator)-</Accordion>--3. Click `Install & Authorize`.--## Modifying Repository Access--You can modify GitHub repository access at any time by:-- Selecting `+ Add GitHub Repos` in the repository selection dropdown or-- Visiting the `Settings > Integrations` page and selecting `Configure GitHub Repositories`--## Working With GitHub Repos in Openhands Cloud--Once you've granted GitHub repository access, you can start working with your GitHub repository. Use the-`Open Repository` section to select the appropriate repository and branch you'd like OpenHands to work on. Then click-on `Launch` to start the conversation!----## Working on GitHub Issues and Pull Requests Using Openhands--To allow OpenHands to work directly from GitHub directly, you must-[give OpenHands access to your repository](/usage/cloud/github-installation#modifying-repository-access). Once access is-given, you can use OpenHands by labeling the issue or by tagging `@openhands`.--### Working with Issues--On your repository, label an issue with `openhands` or add a message starting with `@openhands`. OpenHands will:-1. Comment on the issue to let you know it is working on it.- - You can click on the link to track the progress on OpenHands Cloud.-2. Open a pull request if it determines that the issue has been successfully resolved.-3. Comment on the issue with a summary of the performed tasks and a link to the PR.--### Working with Pull Requests--To get OpenHands to work on pull requests, mention `@openhands` in the comments to:-- Ask questions-- Request updates-- Get code explanations--<Note>-The `@openhands` mention functionality in pull requests only works if the pull request is both-*to* and *from* a repository that you have added through the interface. This is because OpenHands needs appropriate-permissions to access both repositories.-</Note>---## Next Steps--- [Learn about the Cloud UI](/usage/cloud/cloud-ui).-- [Use the Cloud API](/usage/cloud/cloud-api) to programmatically interact with OpenHands.diff --git a/docs/usage/cloud/gitlab-installation.mdx b/docs/usage/cloud/gitlab-installation.mdxdeleted file mode 100644index 621d05ef88..0000000000--- a/docs/usage/cloud/gitlab-installation.mdx+++ /dev/null@@ -1,60 +0,0 @@-----title: GitLab Integration-description: This guide walks you through the process of installing OpenHands Cloud for your GitLab repositories. Once- set up, it will allow OpenHands to work with your GitLab repository through the Cloud UI or straight from GitLab!.------## Prerequisites--- Signed in to [OpenHands Cloud](https://app.all-hands.dev) with [a GitLab account](/usage/cloud/openhands-cloud).--## Adding GitLab Repository Access--Upon signing into OpenHands Cloud with a GitLab account, OpenHands will have access to your repositories.--## Working With GitLab Repos in Openhands Cloud--After signing in with a Gitlab account, use the `Open Repository` section to select the appropriate repository and-branch you'd like OpenHands to work on. Then click on `Launch` to start the conversation!----## Using Tokens with Reduced Scopes--OpenHands requests an API-scoped token during OAuth authentication. By default, this token is provided to the agent.-To restrict the agent's permissions, [you can define a custom secret](/usage/settings/secrets-settings) `GITLAB_TOKEN`,-which will override the default token assigned to the agent. While the high-permission API token is still requested-and used for other components of the application (e.g. opening merge requests), the agent will not have access to it.--## Working on GitLab Issues and Merge Requests Using Openhands--<Note>-This feature works for personal projects and is available for group projects with a-[Premium or Ultimate tier subscription](https://docs.gitlab.com/user/project/integrations/webhooks/#group-webhooks).--A webhook is automatically installed within a few minutes after the owner/maintainer of the project or group logs into-OpenHands Cloud. If you decide to delete the webhook, then re-installing will require the support of All Hands AI but-we are planning to improve this in a future release.-</Note>--Giving GitLab repository access to OpenHands also allows you to work on GitLab issues and merge requests directly.--### Working with Issues--On your repository, label an issue with `openhands` or add a message starting with `@openhands`. OpenHands will:-1. Comment on the issue to let you know it is working on it.- - You can click on the link to track the progress on OpenHands Cloud.-2. Open a merge request if it determines that the issue has been successfully resolved.-3. Comment on the issue with a summary of the performed tasks and a link to the PR.--### Working with Merge Requests--To get OpenHands to work on merge requests, mention `@openhands` in the comments to:-- Ask questions-- Request updates-- Get code explanations--## Next Steps--- [Learn about the Cloud UI](/usage/cloud/cloud-ui).-- [Use the Cloud API](/usage/cloud/cloud-api) to programmatically interact with OpenHands.diff --git a/docs/usage/cloud/openhands-cloud.mdx b/docs/usage/cloud/openhands-cloud.mdxdeleted file mode 100644index 6c0e363497..0000000000--- a/docs/usage/cloud/openhands-cloud.mdx+++ /dev/null@@ -1,27 +0,0 @@-----title: Getting Started-description: Getting started with OpenHands Cloud.------## Accessing OpenHands Cloud--OpenHands Cloud is the hosted cloud version of All Hands AI's OpenHands. To get started with OpenHands Cloud,-visit [app.all-hands.dev](https://app.all-hands.dev).--You'll be prompted to connect with your GitHub, GitLab or Bitbucket account:--1. Click `Log in with GitHub`, `Log in with GitLab` or `Log in with Bitbucket`.-2. Review the permissions requested by OpenHands and authorize the application.- - OpenHands will require certain permissions from your account. To read more about these permissions,- you can click the `Learn more` link on the authorization page.-3. Review and accept the `terms of service` and select `Continue`.--## Next Steps--Once you've connected your account, you can:--- [Install GitHub Integration](/usage/cloud/github-installation) to use OpenHands with your GitHub repositories.-- [Install GitLab Integration](/usage/cloud/gitlab-installation) to use OpenHands with your GitLab repositories.-- [Install Bitbucket Integration](/usage/cloud/bitbucket-installation) to use OpenHands with your Bitbucket repositories.-- [Learn about the Cloud UI](/usage/cloud/cloud-ui).-- [Use the Cloud API](/usage/cloud/cloud-api) to programmatically interact with OpenHands.diff --git a/docs/usage/cloud/pro-subscription.mdx b/docs/usage/cloud/pro-subscription.mdxdeleted file mode 100644index 65dfe64b91..0000000000--- a/docs/usage/cloud/pro-subscription.mdx+++ /dev/null@@ -1,50 +0,0 @@-----title: "Pro Subscription"-description: "Learn about OpenHands Cloud Pro Subscription features and pricing."------## Overview--The OpenHands Pro Subscription unlocks additional features and better pricing when you run OpenHands conversations in-OpenHands Cloud.--## Base Features--All users start on the Pay-as-you-go plan and have access to these base features when they sign up:--* **Run multiple OpenHands conversations on OpenHands Cloud runtimes.**-* **API keys to the OpenHands LLM provider for use in OpenHands CLI or when running OpenHands on your own.**-* **$20 in initial OpenHands Cloud credits to get started.**-* **Support for GitHub, GitLab, Bitbucket, Slack, and more.**--## What you get with a Pro Subscription--The $20/month Pro subscription covers the cost of runtime compute in OpenHands Cloud, plus enables the following-features:--* **Bring Your Own LLM Keys:** Bring your own API keys from OpenAI, Anthropic, Mistral, and other providers.-* **Model Choice:** Unlocks access to OpenHands LLM provider models for use within OpenHands Cloud.-* **No Markup Pricing on LLM usage:** When you use the OpenHands LLM provider in OpenHands Cloud, you pay for-LLM usage at-cost (zero markup) based on API prices.--## Plan Comparison--Here are the key differences between Pay-as-you-go and Pro subscriptions:--### When running OpenHands conversations in OpenHands Cloud-| | Pay-as-you-go | Pro Subscription |-| :---- | ----- | ----- |-| Monthly price | None \- no commitment | $20/month |-| Can I bring my own LLM key? | No | ✅ Yes |-| Do I pay for LLM usage? | ✅ Yes | ✅ Yes |-| Can I select from different LLMs without bringing my own LLM key? | No \- defaults to Claude Sonnet 4 | ✅ Yes \- via OpenHands LLM provider <br/><br/>[*See models and pricing*](https://docs.all-hands.dev/usage/llms/openhands-llms#pricing) |-| How much am I charged for LLM usage? | **Marked up pricing** \- 2x Claude Sonnet 4 API prices. *This markup helps cover the cost of runtime compute.* | **No markup** \- 1x API prices. *The $20 monthly subscription covers the cost of runtime compute.* |---### When using the OpenHands LLM Provider outside of OpenHands Cloud-The following applies to **both** the Pay-as-you-go and Pro subscription:-| | Pay-as-you-go or Pro Subscription |-| :---- | :---- |-| Do I have access to multiple models via the OpenHands LLM provider? | ✅ Yes <br/><br/> [*See models and pricing*](https://docs.all-hands.dev/usage/llms/openhands-llms#pricing) |-| Can I generate and refresh OpenHands LLM API keys? | ✅ Yes |-| How much am I charged for LLM usage when I use the OpenHands LLM provider in other AI coding tools? | **No markup** \- pay 1x API prices <br/> [*See models and pricing*](https://docs.all-hands.dev/usage/llms/openhands-llms#pricing) <br/><br/> *Usage is deducted from your OpenHands Cloud credit balance.* <br/><br/> *The OpenHands LLM provider is available to all OpenHands Cloud users, and LLM usage is billed at-cost (zero markup). Use these models with OpenHands CLI, running OpenHands on your own, or even other AI coding agents\! [Learn more.](https://www.all-hands.dev/blog/access-state-of-the-art-llm-models-at-cost-via-openhands-gui-and-cli)* |diff --git a/docs/usage/cloud/project-management/jira-dc-integration.mdx b/docs/usage/cloud/project-management/jira-dc-integration.mdxdeleted file mode 100644index 1488bbf70b..0000000000--- a/docs/usage/cloud/project-management/jira-dc-integration.mdx+++ /dev/null@@ -1,126 +0,0 @@-----title: Jira Data Center Integration (Coming soon...)-description: Complete guide for setting up Jira Data Center integration with OpenHands Cloud, including service account creation, personal access token generation, webhook configuration, and workspace integration setup.------# Jira Data Center Integration--## Platform Configuration--### Step 1: Create Service Account--1. **Access User Management**- - Log in to Jira Data Center as administrator- - Go to **Administration** > **User Management**--2. **Create User**- - Click **Create User**- - Username: `openhands-agent`- - Full Name: `OpenHands Agent`- - Email: `[email protected]` (replace with your preferred service account email)- - Password: Set a secure password- - Click **Create**--3. **Assign Permissions**- - Add user to appropriate groups- - Ensure access to relevant projects- - Grant necessary project permissions--### Step 2: Generate API Token--1. **Personal Access Tokens**- - Log in as the service account- - Go to **Profile** > **Personal Access Tokens**- - Click **Create token**- - Name: `OpenHands Cloud Integration`- - Expiry: Set appropriate expiration (recommend 1 year)- - Click **Create**- - **Important**: Copy and store the token securely--### Step 3: Configure Webhook--1. **Create Webhook**- - Go to **Administration** > **System** > **WebHooks**- - Click **Create a WebHook**- - **Name**: `OpenHands Cloud Integration`- - **URL**: `https://app.all-hands.dev/integration/jira-dc/events`- - Set a suitable webhook secret- - **Issue related events**: Select the following:- - Issue updated- - Comment created- - **JQL Filter**: Leave empty (or customize as needed)- - Click **Create**- - **Important**: Copy and store the webhook secret securely (you'll need this for workspace integration)-------## Workspace Integration--### Step 1: Log in to OpenHands Cloud--1. **Navigate and Authenticate**- - Go to [OpenHands Cloud](https://app.all-hands.dev/)- - Sign in with your Git provider (GitHub, GitLab, or BitBucket)- - **Important:** Make sure you're signing in with the same Git provider account that contains the repositories you want the OpenHands agent to work on.--### Step 2: Configure Jira Data Center Integration--1. **Access Integration Settings**- - Navigate to **Settings** > **Integrations**- - Locate **Jira Data Center** section--2. **Configure Workspace**- - Click **Configure** button- - Enter your workspace name and click **Connect**- - If no integration exists, you'll be prompted to enter additional credentials required for the workspace integration:- - **Webhook Secret**: The webhook secret from Step 3 above- - **Service Account Email**: The service account email from Step 1 above- - **Service Account API Key**: The personal access token from Step 2 above- - Ensure **Active** toggle is enabled--<Note>-Workspace name is the host name of your Jira Data Center instance.--Eg: http://jira.all-hands.dev/projects/OH/issues/OH-77--Here the workspace name is **jira.all-hands.dev**.-</Note>--3. **Complete OAuth Flow**- - You'll be redirected to Jira Data Center to complete OAuth verification- - Grant the necessary permissions to verify your workspace access. If you have access to multiple workspaces, select the correct one that you initially provided- - If successful, you will be redirected back to the **Integrations** settings in the OpenHands Cloud UI--### Managing Your Integration--**Edit Configuration:**-- Click the **Edit** button next to your configured platform-- Update any necessary credentials or settings-- Click **Update** to apply changes-- You will need to repeat the OAuth flow as before-- **Important:** Only the original user who created the integration can see the edit view--**Unlink Workspace:**-- In the edit view, click **Unlink** next to the workspace name-- This will deactivate your workspace link-- **Important:** If the original user who configured the integration chooses to unlink their integration, any users currently linked to that integration will also be unlinked, and the workspace integration will be deactivated. The integration can only be reactivated by the original user.--### Screenshots--<AccordionGroup>-<Accordion title="Workspace link flow">--</Accordion>--<Accordion title="Workspace Configure flow">--</Accordion>--<Accordion title="Edit view as a user">--</Accordion>--<Accordion title="Edit view as the workspace creator">--</Accordion>-</AccordionGroup>diff --git a/docs/usage/cloud/project-management/jira-integration.mdx b/docs/usage/cloud/project-management/jira-integration.mdxdeleted file mode 100644index 68c3b524a5..0000000000--- a/docs/usage/cloud/project-management/jira-integration.mdx+++ /dev/null@@ -1,130 +0,0 @@-----title: Jira Cloud Integration (Coming soon...)-description: Complete guide for setting up Jira Cloud integration with OpenHands Cloud, including service account creation, API token generation, webhook configuration, and workspace integration setup.------# Jira Cloud Integration--## Platform Configuration--### Step 1: Create Service Account--1. **Navigate to User Management**- - Go to [Atlassian Admin](https://admin.atlassian.com/)- - Select your organization- - Go to **Directory** > **Users**--2. **Create OpenHands Service Account**- - Click **Service accounts**- - Click **Create a service account**- - Name: `OpenHands Agent`- - Click **Next**- - Select **User** role for Jira app- - Click **Create**--### Step 2: Generate API Token--1. **Access Service Account Configuration**- - Locate the created service account from above step and click on it- - Click **Create API token**- - Set the expiry to 365 days (maximum allowed value)- - Click **Next**- - In **Select token scopes** screen, filter by following values- - App: Jira- - Scope type: Classic- - Scope actions: Write, Read- - Select `read:jira-work` and `write:jira-work` scopes- - Click **Next**- - Review and create API token- - **Important**: Copy and securely store the token immediately--### Step 3: Configure Webhook--1. **Navigate to Webhook Settings**- - Go to **Jira Settings** > **System** > **WebHooks**- - Click **Create a WebHook**--2. **Configure Webhook**- - **Name**: `OpenHands Cloud Integration`- - **Status**: Enabled- - **URL**: `https://app.all-hands.dev/integration/jira/events`- - **Issue related events**: Select the following:- - Issue updated- - Comment created- - **JQL Filter**: Leave empty (or customize as needed)- - Click **Create**- - **Important**: Copy and store the webhook secret securely (you'll need this for workspace integration)-------## Workspace Integration--### Step 1: Log in to OpenHands Cloud--1. **Navigate and Authenticate**- - Go to [OpenHands Cloud](https://app.all-hands.dev/)- - Sign in with your Git provider (GitHub, GitLab, or BitBucket)- - **Important:** Make sure you're signing in with the same Git provider account that contains the repositories you want the OpenHands agent to work on.--### Step 2: Configure Jira Integration--1. **Access Integration Settings**- - Navigate to **Settings** > **Integrations**- - Locate **Jira Cloud** section--2. **Configure Workspace**- - Click **Configure** button- - Enter your workspace name and click **Connect**- - **Important:** Make sure you enter the full workspace name, eg: **yourcompany.atlassian.net**- - If no integration exists, you'll be prompted to enter additional credentials required for the workspace integration:- - **Webhook Secret**: The webhook secret from Step 3 above- - **Service Account Email**: The service account email from Step 1 above- - **Service Account API Key**: The API token from Step 2 above- - Ensure **Active** toggle is enabled--<Note>-Workspace name is the host name when accessing a resource in Jira Cloud.--Eg: https://all-hands.atlassian.net/browse/OH-55--Here the workspace name is **all-hands**.-</Note>--3. **Complete OAuth Flow**- - You'll be redirected to Jira Cloud to complete OAuth verification- - Grant the necessary permissions to verify your workspace access.- - If successful, you will be redirected back to the **Integrations** settings in the OpenHands Cloud UI--### Managing Your Integration--**Edit Configuration:**-- Click the **Edit** button next to your configured platform-- Update any necessary credentials or settings-- Click **Update** to apply changes-- You will need to repeat the OAuth flow as before-- **Important:** Only the original user who created the integration can see the edit view--**Unlink Workspace:**-- In the edit view, click **Unlink** next to the workspace name-- This will deactivate your workspace link-- **Important:** If the original user who configured the integration chooses to unlink their integration, any users currently linked to that workspace integration will also be unlinked, and the workspace integration will be deactivated. The integration can only be reactivated by the original user.--### Screenshots--<AccordionGroup>-<Accordion title="Workspace link flow">--</Accordion>--<Accordion title="Workspace Configure flow">--</Accordion>--<Accordion title="Edit view as a user">--</Accordion>--<Accordion title="Edit view as the workspace creator">--</Accordion>-</AccordionGroup>diff --git a/docs/usage/cloud/project-management/linear-integration.mdx b/docs/usage/cloud/project-management/linear-integration.mdxdeleted file mode 100644index c01da4ae70..0000000000--- a/docs/usage/cloud/project-management/linear-integration.mdx+++ /dev/null@@ -1,130 +0,0 @@-----title: Linear Integration (Coming soon...)-description: Complete guide for setting up Linear integration with OpenHands Cloud, including service account creation, API key generation, webhook configuration, and workspace integration setup.------# Linear Integration--## Platform Configuration--### Step 1: Create Service Account--1. **Access Team Settings**- - Log in to Linear as a team admin- - Go to **Settings** > **Members**--2. **Invite Service Account**- - Click **Invite members**- - Email: `[email protected]` (replace with your preferred service account email)- - Role: **Member** (with appropriate team access)- - Send invitation--3. **Complete Setup**- - Accept invitation from the service account email- - Complete profile setup- - Ensure access to relevant teams/workspaces--### Step 2: Generate API Key--1. **Access API Settings**- - Log in as the service account- - Go to **Settings** > **Security & access**--2. **Create Personal API Key**- - Click **Create new key**- - Name: `OpenHands Cloud Integration`- - Scopes: Select the following:- - `Read` - Read access to issues and comments- - `Create comments` - Ability to create or update comments- - Select the teams you want to provide access to, or allow access for all teams you have permissions for- - Click **Create**- - **Important**: Copy and store the API key securely--### Step 3: Configure Webhook--1. **Access Webhook Settings**- - Go to **Settings** > **API** > **Webhooks**- - Click **New webhook**--2. **Configure Webhook**- - **Label**: `OpenHands Cloud Integration`- - **URL**: `https://app.all-hands.dev/integration/linear/events`- - **Resource types**: Select:- - `Comment` - For comment events- - `Issue` - For issue updates (label changes)- - Select the teams you want to provide access to, or allow access for all public teams- - Click **Create webhook**- - **Important**: Copy and store the webhook secret securely (you'll need this for workspace integration)-------## Workspace Integration--### Step 1: Log in to OpenHands Cloud--1. **Navigate and Authenticate**- - Go to [OpenHands Cloud](https://app.all-hands.dev/)- - Sign in with your Git provider (GitHub, GitLab, or BitBucket)- - **Important:** Make sure you're signing in with the same Git provider account that contains the repositories you want the OpenHands agent to work on.--### Step 2: Configure Linear Integration--1. **Access Integration Settings**- - Navigate to **Settings** > **Integrations**- - Locate **Linear** section--2. **Configure Workspace**- - Click **Configure** button- - Enter your workspace name and click **Connect**- - If no integration exists, you'll be prompted to enter additional credentials required for the workspace integration:- - **Webhook Secret**: The webhook secret from Step 3 above- - **Service Account Email**: The service account email from Step 1 above- - **Service Account API Key**: The API key from Step 2 above- - Ensure **Active** toggle is enabled--<Note>-Workspace name is the identifier after the host name when accessing a resource in Linear.--Eg: https://linear.app/allhands/issue/OH-37--Here the workspace name is **allhands**.-</Note>--3. **Complete OAuth Flow**- - You'll be redirected to Linear to complete OAuth verification- - Grant the necessary permissions to verify your workspace access. If you have access to multiple workspaces, select the correct one that you initially provided- - If successful, you will be redirected back to the **Integrations** settings in the OpenHands Cloud UI--### Managing Your Integration--**Edit Configuration:**-- Click the **Edit** button next to your configured platform-- Update any necessary credentials or settings-- Click **Update** to apply changes-- You will need to repeat the OAuth flow as before-- **Important:** Only the original user who created the integration can see the edit view--**Unlink Workspace:**-- In the edit view, click **Unlink** next to the workspace name-- This will deactivate your workspace link-- **Important:** If the original user who configured the integration chooses to unlink their integration, any users currently linked to that integration will also be unlinked, and the workspace integration will be deactivated. The integration can only be reactivated by the original user.--### Screenshots--<AccordionGroup>-<Accordion title="Workspace link flow">--</Accordion>--<Accordion title="Workspace Configure flow">--</Accordion>--<Accordion title="Edit view as a user">--</Accordion>--<Accordion title="Edit view as the workspace creator">--</Accordion>-</AccordionGroup>diff --git a/docs/usage/cloud/project-management/overview.mdx b/docs/usage/cloud/project-management/overview.mdxdeleted file mode 100644index 54c84abfe2..0000000000--- a/docs/usage/cloud/project-management/overview.mdx+++ /dev/null@@ -1,80 +0,0 @@-----title: Project Management Tool Integrations (Coming soon...)-description: Overview of OpenHands Cloud integrations with project management platforms including Jira Cloud, Jira Data Center, and Linear. Learn about setup requirements, usage methods, and troubleshooting.------# Project Management Tool Integrations--## Overview--OpenHands Cloud integrates with project management platforms (Jira Cloud, Jira Data Center, and Linear) to enable AI-powered task delegation. Users can invoke the OpenHands agent by:-- Adding `@openhands` in ticket comments-- Adding the `openhands` label to tickets--## Prerequisites--Integration requires two levels of setup:-1. **Platform Configuration** - Administrative setup of service accounts and webhooks on your project management platform (see individual platform documentation below)-2. **Workspace Integration** - Self-service configuration through the OpenHands Cloud UI to link your OpenHands account to the target workspace--### Platform-Specific Setup Guides:-- [Jira Cloud Integration (Coming soon...)](./jira-integration.md)-- [Jira Data Center Integration (Coming soon...)](./jira-dc-integration.md)-- [Linear Integration (Coming soon...)](./linear-integration.md)--## Usage--Once both the platform configuration and workspace integration are completed, users can trigger the OpenHands agent within their project management platforms using two methods:--### Method 1: Comment Mention-Add a comment to any issue with `@openhands` followed by your task description:-```-@openhands Please implement the user authentication feature described in this ticket-```--### Method 2: Label-based Delegation-Add the label `openhands` to any issue. The OpenHands agent will automatically process the issue based on its description and requirements.--### Git Repository Detection--The OpenHands agent needs to identify which Git repository to work with when processing your issues. Here's how to ensure proper repository detection:--#### Specifying the Target Repository--**Required:** Include the target Git repository in your issue description or comment to ensure the agent works with the correct codebase.--**Supported Repository Formats:**-- Full HTTPS URL: `https://github.com/owner/repository.git`-- GitHub URL without .git: `https://github.com/owner/repository`-- Owner/repository format: `owner/repository`--#### Platform-Specific Behavior--**Linear Integration:** When GitHub integration is enabled for your Linear workspace with issue sync activated, the target repository is automatically detected from the linked GitHub issue. Manual specification is not required in this configuration.--**Jira Integrations:** Always include the repository information in your issue description or `@openhands` comment to ensure proper repository detection.--## Troubleshooting--### Platform Configuration Issues-- **Webhook not triggering**: Verify the webhook URL is correct and the proper event types are selected (Comment, Issue updated)-- **API authentication failing**: Check API key/token validity and ensure required scopes are granted. If your current API token is expired, make sure to update it in the respective integration settings-- **Permission errors**: Ensure the service account has access to relevant projects/teams and appropriate permissions--### Workspace Integration Issues-- **Workspace linking requests credentials**: If there are no active workspace integrations for the workspace you specified, you need to configure it first. Contact your platform administrator that you want to integrate with (eg: Jira, Linear)-- **Integration not found**: Verify the workspace name matches exactly and that platform configuration was completed first-- **OAuth flow fails**: Make sure that you're authorizing with the correct account with proper workspace access--### General Issues-- **Agent not responding**: Check webhook logs in your platform settings and verify service account status-- **Authentication errors**: Verify Git provider permissions and OpenHands Cloud access-- **Agent fails to identify git repo**: Ensure you're signing in with the same Git provider account that contains the repositories you want OpenHands to work on-- **Partial functionality**: Ensure both platform configuration and workspace integration are properly completed--### Getting Help-For additional support, contact OpenHands Cloud support with:-- Your integration platform (Linear, Jira Cloud, or Jira Data Center)-- Workspace name-- Error logs from webhook/integration attempts-- Screenshots of configuration settings (without sensitive credentials)diff --git a/docs/usage/cloud/slack-installation.mdx b/docs/usage/cloud/slack-installation.mdxdeleted file mode 100644index 50e6d651f3..0000000000--- a/docs/usage/cloud/slack-installation.mdx+++ /dev/null@@ -1,89 +0,0 @@-----title: Slack Integration (Beta)-description: This guide walks you through installing the OpenHands Slack app.------<iframe- className="w-full aspect-video"- src="https://www.youtube.com/embed/hbloGmfZsJ4"- title="OpenHands Slack Integration Tutorial"- frameBorder="0"- allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"- allowFullScreen>-</iframe>--<Info>-OpenHands utilizes a large language model (LLM), which may generate responses that are inaccurate or incomplete.-While we strive for accuracy, OpenHands' outputs are not guaranteed to be correct, and we encourage users to-validate critical information independently.-</Info>--## Prerequisites--- Access to OpenHands Cloud.--## Installation Steps--<AccordionGroup>-<Accordion title="Install Slack App (only for Slack admins/owners)">-- **This step is for Slack admins/owners**-- 1. Make sure you have permissions to install Apps to your workspace.- 2. Click the button below to install OpenHands Slack App <a target="_blank" href="https://slack.com/oauth/v2/authorize?client_id=7477886716822.8729519890534&scope=app_mentions:read,channels:history,chat:write,groups:history,im:history,mpim:history,users:read&user_scope="><img alt="Add to Slack" height="40" width="139" src="https://platform.slack-edge.com/img/add_to_slack.png" srcSet="https://platform.slack-edge.com/img/add_to_slack.png 1x, https://platform.slack-edge.com/img/[email protected] 2x" /></a>- 3. In the top right corner, select the workspace to install the OpenHands Slack app.- 4. Review permissions and click allow.--</Accordion>--<Accordion title="Authorize Slack App (for all Slack workspace members)">-- **Make sure your Slack workspace admin/owner has installed OpenHands Slack App first.**-- Every user in the Slack workspace (including admins/owners) must link their OpenHands Cloud account to the OpenHands Slack App. To do this:- 1. Visit the [Settings > Integrations](https://app.all-hands.dev/settings/integrations) page in OpenHands Cloud.- 2. Click `Install OpenHands Slack App`.- 3. In the top right corner, select the workspace to install the OpenHands Slack app.- 4. Review permissions and click allow.-- Depending on the workspace settings, you may need approval from your Slack admin to authorize the Slack App.--</Accordion>--</AccordionGroup>---## Working With the Slack App--To start a new conversation, you can mention `@openhands` in a new message or a thread inside any Slack channel.--Once a conversation is started, all thread messages underneath it will be follow-up messages to OpenHands.--To send follow-up messages for the same conversation, mention `@openhands` in a thread reply to the original message.-You must be the user who started the conversation.--## Example conversation--### Start a new conversation, and select repo--Conversation is started by mentioning `@openhands`.----### See agent response and send follow up messages--Initial request is followed up by mentioning `@openhands` in a thread reply.----## Pro tip--You can mention a repo name when starting a new conversation in the following formats--1. "My-Repo" repo (e.g `@openhands in the openhands repo ...`)-2. "All-Hands-AI/OpenHands" (e.g `@openhands in All-Hands-AI/OpenHands ...`)--The repo match is case insensitive. If a repo name match is made, it will kick off the conversation.-If the repo name partially matches against multiple repos, you'll be asked to select a repo from the filtered list.--diff --git a/docs/usage/configuration-options.mdx b/docs/usage/configuration-options.mdxdeleted file mode 100644index fc3fcdb579..0000000000--- a/docs/usage/configuration-options.mdx+++ /dev/null@@ -1,437 +0,0 @@-----title: Configuration Options-description: This page outlines all available configuration options for OpenHands, allowing you to customize its- behavior and integrate it with other services.------<Note>- In GUI Mode, any settings applied through the Settings UI will take precedence.-</Note>--<Note>- **Looking for Environment Variables?** All configuration options can also be set using environment variables.- See the [Environment Variables Reference](./environment-variables) for a complete list with examples.-</Note>--## Location of the `config.toml` File--When running OpenHands in CLI, headless, or development mode, you can use a project-specific `config.toml` file for configuration, which must be-located in the same directory from which the command is run. Alternatively, you may use the `--config-file` option to-specify a different path to the `config.toml` file.--## Core Configuration--The core configuration options are defined in the `[core]` section of the `config.toml` file.--Core configuration options can be set as environment variables by converting to uppercase. For example:-- `debug` → `DEBUG`-- `cache_dir` → `CACHE_DIR`-- `runtime` → `RUNTIME`--### Workspace-- `workspace_base` **(Deprecated)**- - Type: `str`- - Default: `"./workspace"`- - Description: Base path for the workspace. **Deprecated: Use `SANDBOX_VOLUMES` instead.**--- `cache_dir`- - Type: `str`- - Default: `"/tmp/cache"`- - Description: Cache directory path--### Debugging and Logging-- `debug`- - Type: `bool`- - Default: `false`- - Description: Enable debugging--- `disable_color`- - Type: `bool`- - Default: `false`- - Description: Disable color in terminal output--### Trajectories-- `save_trajectory_path`- - Type: `str`- - Default: `"./trajectories"`- - Description: Path to store trajectories (can be a folder or a file). If it's a folder, the trajectories will be saved in a file named with the session id name and .json extension, in that folder.--- `replay_trajectory_path`- - Type: `str`- - Default: `""`- - Description: Path to load a trajectory and replay. If given, must be a path to the trajectory file in JSON format. The actions in the trajectory file would be replayed first before any user instruction is executed.--### File Store-- `file_store_path`- - Type: `str`- - Default: `"/tmp/file_store"`- - Description: File store path--- `file_store`- - Type: `str`- - Default: `"memory"`- - Description: File store type--- `file_uploads_allowed_extensions`- - Type: `list of str`- - Default: `[".*"]`- - Description: List of allowed file extensions for uploads--- `file_uploads_max_file_size_mb`- - Type: `int`- - Default: `0`- - Description: Maximum file size for uploads, in megabytes--- `file_uploads_restrict_file_types`- - Type: `bool`- - Default: `false`- - Description: Restrict file types for file uploads--- `file_uploads_allowed_extensions`- - Type: `list of str`- - Default: `[".*"]`- - Description: List of allowed file extensions for uploads--### Task Management-- `max_budget_per_task`- - Type: `float`- - Default: `0.0`- - Description: Maximum budget per task (0.0 means no limit)--- `max_iterations`- - Type: `int`- - Default: `100`- - Description: Maximum number of iterations--### Sandbox Configuration-- `volumes`- - Type: `str`- - Default: `None`- - Description: Volume mounts in the format 'host_path:container_path[:mode]', e.g. '/my/host/dir:/workspace:rw'. Multiple mounts can be specified using commas, e.g. '/path1:/workspace/path1,/path2:/workspace/path2:ro'--- `workspace_mount_path_in_sandbox` **(Deprecated)**- - Type: `str`- - Default: `"/workspace"`- - Description: Path to mount the workspace in the sandbox. **Deprecated: Use `SANDBOX_VOLUMES` instead.**--- `workspace_mount_path` **(Deprecated)**- - Type: `str`- - Default: `""`- - Description: Path to mount the workspace. **Deprecated: Use `SANDBOX_VOLUMES` instead.**--- `workspace_mount_rewrite` **(Deprecated)**- - Type: `str`- - Default: `""`- - Description: Path to rewrite the workspace mount path to. You can usually ignore this, it refers to special cases of running inside another container. **Deprecated: Use `SANDBOX_VOLUMES` instead.**--### Miscellaneous-- `run_as_openhands`- - Type: `bool`- - Default: `true`- - Description: Run as OpenHands--- `runtime`- - Type: `str`- - Default: `"docker"`- - Description: Runtime environment--- `default_agent`- - Type: `str`- - Default: `"CodeActAgent"`- - Description: Name of the default agent--- `jwt_secret`- - Type: `str`- - Default: `uuid.uuid4().hex`- - Description: JWT secret for authentication. Please set it to your own value.--## LLM Configuration--The LLM (Large Language Model) configuration options are defined in the `[llm]` section of the `config.toml` file.--To use these with the docker command, pass in `-e LLM_<option>`. Example: `-e LLM_NUM_RETRIES`.--All LLM configuration options can be set as environment variables by prefixing with `LLM_` and converting to uppercase. For example:-- `model` → `LLM_MODEL`-- `api_key` → `LLM_API_KEY`-- `base_url` → `LLM_BASE_URL`--<Note>-For development setups, you can also define custom named LLM configurations. See [Custom LLM Configurations](./llms/custom-llm-configs) for details.-</Note>--**AWS Credentials**-- `aws_access_key_id`- - Type: `str`- - Default: `""`- - Description: AWS access key ID--- `aws_region_name`- - Type: `str`- - Default: `""`- - Description: AWS region name--- `aws_secret_access_key`- - Type: `str`- - Default: `""`- - Description: AWS secret access key--### API Configuration-- `api_key`- - Type: `str`- - Default: `None`- - Description: API key to use--- `base_url`- - Type: `str`- - Default: `""`- - Description: API base URL--- `api_version`- - Type: `str`- - Default: `""`- - Description: API version--- `input_cost_per_token`- - Type: `float`- - Default: `0.0`- - Description: Cost per input token--- `output_cost_per_token`- - Type: `float`- - Default: `0.0`- - Description: Cost per output token--### Custom LLM Provider-- `custom_llm_provider`- - Type: `str`- - Default: `""`- - Description: Custom LLM provider---### Message Handling-- `max_message_chars`- - Type: `int`- - Default: `30000`- - Description: The approximate maximum number of characters in the content of an event included in the prompt to the LLM. Larger observations are truncated.--- `max_input_tokens`- - Type: `int`- - Default: `0`- - Description: Maximum number of input tokens--- `max_output_tokens`- - Type: `int`- - Default: `0`- - Description: Maximum number of output tokens--### Model Selection-- `model`- - Type: `str`- - Default: `"claude-3-5-sonnet-20241022"`- - Description: Model to use--### Retrying-- `num_retries`- - Type: `int`- - Default: `8`- - Description: Number of retries to attempt--- `retry_max_wait`- - Type: `int`- - Default: `120`- - Description: Maximum wait time (in seconds) between retry attempts--- `retry_min_wait`- - Type: `int`- - Default: `15`- - Description: Minimum wait time (in seconds) between retry attempts--- `retry_multiplier`- - Type: `float`- - Default: `2.0`- - Description: Multiplier for exponential backoff calculation--### Advanced Options-- `drop_params`- - Type: `bool`- - Default: `false`- - Description: Drop any unmapped (unsupported) params without causing an exception--- `caching_prompt`- - Type: `bool`- - Default: `true`- - Description: Using the prompt caching feature if provided by the LLM and supported--- `ollama_base_url`- - Type: `str`- - Default: `""`- - Description: Base URL for the OLLAMA API--- `temperature`- - Type: `float`- - Default: `0.0`- - Description: Temperature for the API--- `timeout`- - Type: `int`- - Default: `0`- - Description: Timeout for the API--- `top_p`- - Type: `float`- - Default: `1.0`- - Description: Top p for the API--- `disable_vision`- - Type: `bool`- - Default: `None`- - Description: If model is vision capable, this option allows to disable image processing (useful for cost reduction)--## Agent Configuration--The agent configuration options are defined in the `[agent]` and `[agent.<agent_name>]` sections of the `config.toml` file.--Agent configuration options can be set as environment variables by prefixing with `AGENT_` and converting to uppercase. For example:-- `enable_browsing` → `AGENT_ENABLE_BROWSING`-- `function_calling` → `AGENT_FUNCTION_CALLING`-- `llm_config` → `AGENT_LLM_CONFIG`--### LLM Configuration-- `llm_config`- - Type: `str`- - Default: `'your-llm-config-group'`- - Description: The name of the LLM config to use--### ActionSpace Configuration-- `function_calling`- - Type: `bool`- - Default: `true`- - Description: Whether function calling is enabled--- `enable_browsing`- - Type: `bool`- - Default: `false`- - Description: Whether browsing delegate is enabled in the action space (only works with function calling)--- `enable_llm_editor`- - Type: `bool`- - Default: `false`- - Description: Whether LLM editor is enabled in the action space (only works with function calling)--- `enable_jupyter`- - Type: `bool`- - Default: `false`- - Description: Whether Jupyter is enabled in the action space--- `enable_history_truncation`- - Type: `bool`- - Default: `true`- - Description: Whether history should be truncated to continue the session when hitting LLM context length limit--### Microagent Usage-- `enable_prompt_extensions`- - Type: `bool`- - Default: `true`- - Description: Whether to use microagents at all--- `disabled_microagents`- - Type: `list of str`- - Default: `None`- - Description: A list of microagents to disable--## Sandbox Configuration--The sandbox configuration options are defined in the `[sandbox]` section of the `config.toml` file.----To use these with the docker command, pass in `-e SANDBOX_<option>`. Example: `-e SANDBOX_TIMEOUT`.--All sandbox configuration options can be set as environment variables by prefixing with `SANDBOX_` and converting to uppercase. For example:-- `timeout` → `SANDBOX_TIMEOUT`-- `user_id` → `SANDBOX_USER_ID`-- `base_container_image` → `SANDBOX_BASE_CONTAINER_IMAGE`--### Execution-- `timeout`- - Type: `int`- - Default: `120`- - Description: Sandbox timeout in seconds--- `user_id`- - Type: `int`- - Default: `1000`- - Description: Sandbox user ID--### Container Image-- `base_container_image`- - Type: `str`- - Default: `"nikolaik/python-nodejs:python3.12-nodejs22"`- - Description: Container image to use for the sandbox--### Networking-- `use_host_network`- - Type: `bool`- - Default: `false`- - Description: Use host network--- `runtime_binding_address`- - Type: `str`- - Default: `0.0.0.0`- - Description: The binding address for the runtime ports. It specifies which network interface on the host machine Docker should bind the runtime ports to.--### Linting and Plugins-- `enable_auto_lint`- - Type: `bool`- - Default: `false`- - Description: Enable auto linting after editing--- `initialize_plugins`- - Type: `bool`- - Default: `true`- - Description: Whether to initialize plugins--### Dependencies and Environment-- `runtime_extra_deps`- - Type: `str`- - Default: `""`- - Description: Extra dependencies to install in the runtime image--- `runtime_startup_env_vars`- - Type: `dict`- - Default: `{}`- - Description: Environment variables to set at the launch of the runtime--### Evaluation-- `browsergym_eval_env`- - Type: `str`- - Default: `""`- - Description: BrowserGym environment to use for evaluation--## Security Configuration--The security configuration options are defined in the `[security]` section of the `config.toml` file.--To use these with the docker command, pass in `-e SECURITY_<option>`. Example: `-e SECURITY_CONFIRMATION_MODE`.--All security configuration options can be set as environment variables by prefixing with `SECURITY_` and converting to uppercase. For example:-- `confirmation_mode` → `SECURITY_CONFIRMATION_MODE`-- `security_analyzer` → `SECURITY_SECURITY_ANALYZER`--### Confirmation Mode-- `confirmation_mode`- - Type: `bool`- - Default: `false`- - Description: Enable confirmation mode--### Security Analyzer-- `security_analyzer`- - Type: `str`- - Default: `""`- - Description: The security analyzer to use-------> **Note**: Adjust configurations carefully, especially for memory, security, and network-related settings to ensure optimal performance and security.-Please note that the configuration options may be subject to change in future versions of OpenHands. It's recommended to refer to the official documentation for the most up-to-date information.diff --git a/docs/usage/confirmation-mode.mdx b/docs/usage/confirmation-mode.mdxdeleted file mode 100644index 951a3a5000..0000000000--- a/docs/usage/confirmation-mode.mdx+++ /dev/null@@ -1,52 +0,0 @@-# Confirmation Mode and Security Analyzers--OpenHands provides a security framework to help protect users from potentially risky actions through **Confirmation Mode** and **Security Analyzers**. This system analyzes agent actions and prompts users for confirmation when high-risk operations are detected.--## Overview--The security system consists of two main components:--1. **Confirmation Mode**: When enabled, the agent will pause and ask for user confirmation before executing actions that are flagged as high-risk by the security analyzer.--2. **Security Analyzers**: These are modules that evaluate the risk level of agent actions and determine whether user confirmation is required.--## Configuration--### CLI-In CLI mode, confirmation is enabled by default. You will have an option to uses the LLM Analyzer and will automatically confirm LOW and MEDIUM risk actions, only prompting for HIGH risk actions.--## Security Analyzers--OpenHands includes multiple analyzers:--- **No Analyzer**: Do not use any security analyzer. The agent will prompt you to confirm *EVERY* action.-- **LLM Risk Analyzer** (default): Uses the same LLM as the agent to assess action risk levels-- **Invariant Analyzer**: Uses Invariant Labs' policy engine to evaluate action traces against security policies--### LLM Risk Analyzer-The default analyzer that leverages the agent's LLM to evaluate the security risk of each action. It considers the action type, parameters, and context to assign risk levels.--### Invariant Analyzer-An advanced analyzer that:-- Collects conversation events and parses them into a trace-- Checks the trace against an Invariant policy to classify risk (low, medium, high)-- Manages an Invariant server container automatically if needed-- Supports optional browsing-alignment and harmful-content checks--## How It Works--1. **Action Analysis**: When the agent wants to perform an action, the selected security analyzer evaluates its risk level.--2. **Risk Assessment**: The analyzer returns one of three risk levels:- - **LOW**: Action proceeds without confirmation- - **MEDIUM**: Action proceeds without confirmation (may be configurable in future)- - **HIGH**: Action is paused, and user confirmation is requested--3. **User Confirmation**: For high-risk actions, a confirmation dialog appears with:- - Description of the action- - Risk assessment explanation- - Options to approve or deny action--4. **Action Execution**: Based on user response:- - **Approve**: Action proceeds as planned- - **Deny**: Action is cancelleddiff --git a/docs/usage/environment-variables.mdx b/docs/usage/environment-variables.mdxdeleted file mode 100644index 24d4554861..0000000000--- a/docs/usage/environment-variables.mdx+++ /dev/null@@ -1,251 +0,0 @@-----title: Environment Variables Reference-description: Complete reference of all environment variables supported by OpenHands------This page provides a reference of environment variables that can be used to configure OpenHands. Environment variables provide an alternative to TOML configuration files and are particularly useful for containerized deployments, CI/CD pipelines, and cloud environments.--## Environment Variable Naming Convention--OpenHands follows a consistent naming pattern for environment variables:--- **Core settings**: Direct uppercase mapping (e.g., `debug` → `DEBUG`)-- **LLM settings**: Prefixed with `LLM_` (e.g., `model` → `LLM_MODEL`)-- **Agent settings**: Prefixed with `AGENT_` (e.g., `enable_browsing` → `AGENT_ENABLE_BROWSING`)-- **Sandbox settings**: Prefixed with `SANDBOX_` (e.g., `timeout` → `SANDBOX_TIMEOUT`)-- **Security settings**: Prefixed with `SECURITY_` (e.g., `confirmation_mode` → `SECURITY_CONFIRMATION_MODE`)--## Core Configuration Variables--These variables correspond to the `[core]` section in `config.toml`:--| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `DEBUG` | boolean | `false` | Enable debug logging throughout the application |-| `DISABLE_COLOR` | boolean | `false` | Disable colored output in terminal |-| `CACHE_DIR` | string | `"/tmp/cache"` | Directory path for caching |-| `SAVE_TRAJECTORY_PATH` | string | `"./trajectories"` | Path to store conversation trajectories |-| `REPLAY_TRAJECTORY_PATH` | string | `""` | Path to load and replay a trajectory file |-| `FILE_STORE_PATH` | string | `"/tmp/file_store"` | File store directory path |-| `FILE_STORE` | string | `"memory"` | File store type (`memory`, `local`, etc.) |-| `FILE_UPLOADS_MAX_FILE_SIZE_MB` | integer | `0` | Maximum file upload size in MB (0 = no limit) |-| `FILE_UPLOADS_RESTRICT_FILE_TYPES` | boolean | `false` | Whether to restrict file upload types |-| `FILE_UPLOADS_ALLOWED_EXTENSIONS` | list | `[".*"]` | List of allowed file extensions for uploads |-| `MAX_BUDGET_PER_TASK` | float | `0.0` | Maximum budget per task (0.0 = no limit) |-| `MAX_ITERATIONS` | integer | `100` | Maximum number of iterations per task |-| `RUNTIME` | string | `"docker"` | Runtime environment (`docker`, `local`, `cli`, etc.) |-| `DEFAULT_AGENT` | string | `"CodeActAgent"` | Default agent class to use |-| `JWT_SECRET` | string | auto-generated | JWT secret for authentication |-| `RUN_AS_OPENHANDS` | boolean | `true` | Whether to run as the openhands user |-| `VOLUMES` | string | `""` | Volume mounts in format `host:container[:mode]` |--## LLM Configuration Variables--These variables correspond to the `[llm]` section in `config.toml`:--| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `LLM_MODEL` | string | `"claude-3-5-sonnet-20241022"` | LLM model to use |-| `LLM_API_KEY` | string | `""` | API key for the LLM provider |-| `LLM_BASE_URL` | string | `""` | Custom API base URL |-| `LLM_API_VERSION` | string | `""` | API version to use |-| `LLM_TEMPERATURE` | float | `0.0` | Sampling temperature |-| `LLM_TOP_P` | float | `1.0` | Top-p sampling parameter |-| `LLM_MAX_INPUT_TOKENS` | integer | `0` | Maximum input tokens (0 = no limit) |-| `LLM_MAX_OUTPUT_TOKENS` | integer | `0` | Maximum output tokens (0 = no limit) |-| `LLM_MAX_MESSAGE_CHARS` | integer | `30000` | Maximum characters that will be sent to the model in observation content |-| `LLM_TIMEOUT` | integer | `0` | API timeout in seconds (0 = no timeout) |-| `LLM_NUM_RETRIES` | integer | `8` | Number of retry attempts |-| `LLM_RETRY_MIN_WAIT` | integer | `15` | Minimum wait time between retries (seconds) |-| `LLM_RETRY_MAX_WAIT` | integer | `120` | Maximum wait time between retries (seconds) |-| `LLM_RETRY_MULTIPLIER` | float | `2.0` | Exponential backoff multiplier |-| `LLM_DROP_PARAMS` | boolean | `false` | Drop unsupported parameters without error |-| `LLM_CACHING_PROMPT` | boolean | `true` | Enable prompt caching if supported |-| `LLM_DISABLE_VISION` | boolean | `false` | Disable vision capabilities for cost reduction |-| `LLM_CUSTOM_LLM_PROVIDER` | string | `""` | Custom LLM provider name |-| `LLM_OLLAMA_BASE_URL` | string | `""` | Base URL for Ollama API |-| `LLM_INPUT_COST_PER_TOKEN` | float | `0.0` | Cost per input token |-| `LLM_OUTPUT_COST_PER_TOKEN` | float | `0.0` | Cost per output token |-| `LLM_REASONING_EFFORT` | string | `""` | Reasoning effort for o-series models (`low`, `medium`, `high`) |--### AWS Configuration-| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `LLM_AWS_ACCESS_KEY_ID` | string | `""` | AWS access key ID |-| `LLM_AWS_SECRET_ACCESS_KEY` | string | `""` | AWS secret access key |-| `LLM_AWS_REGION_NAME` | string | `""` | AWS region name |--## Agent Configuration Variables--These variables correspond to the `[agent]` section in `config.toml`:--| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `AGENT_LLM_CONFIG` | string | `""` | Name of LLM config group to use |-| `AGENT_FUNCTION_CALLING` | boolean | `true` | Enable function calling |-| `AGENT_ENABLE_BROWSING` | boolean | `false` | Enable browsing delegate |-| `AGENT_ENABLE_LLM_EDITOR` | boolean | `false` | Enable LLM-based editor |-| `AGENT_ENABLE_JUPYTER` | boolean | `false` | Enable Jupyter integration |-| `AGENT_ENABLE_HISTORY_TRUNCATION` | boolean | `true` | Enable history truncation |-| `AGENT_ENABLE_PROMPT_EXTENSIONS` | boolean | `true` | Enable microagents (prompt extensions) |-| `AGENT_DISABLED_MICROAGENTS` | list | `[]` | List of microagents to disable |--## Sandbox Configuration Variables--These variables correspond to the `[sandbox]` section in `config.toml`:--| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `SANDBOX_TIMEOUT` | integer | `120` | Sandbox timeout in seconds |-| `SANDBOX_USER_ID` | integer | `1000` | User ID for sandbox processes |-| `SANDBOX_BASE_CONTAINER_IMAGE` | string | `"nikolaik/python-nodejs:python3.12-nodejs22"` | Base container image |-| `SANDBOX_USE_HOST_NETWORK` | boolean | `false` | Use host networking |-| `SANDBOX_RUNTIME_BINDING_ADDRESS` | string | `"0.0.0.0"` | Runtime binding address |-| `SANDBOX_ENABLE_AUTO_LINT` | boolean | `false` | Enable automatic linting |-| `SANDBOX_INITIALIZE_PLUGINS` | boolean | `true` | Initialize sandbox plugins |-| `SANDBOX_RUNTIME_EXTRA_DEPS` | string | `""` | Extra dependencies to install |-| `SANDBOX_RUNTIME_STARTUP_ENV_VARS` | dict | `{}` | Environment variables for runtime |-| `SANDBOX_BROWSERGYM_EVAL_ENV` | string | `""` | BrowserGym evaluation environment |-| `SANDBOX_VOLUMES` | string | `""` | Volume mounts (replaces deprecated workspace settings) |-| `SANDBOX_RUNTIME_CONTAINER_IMAGE` | string | `""` | Pre-built runtime container image |-| `SANDBOX_KEEP_RUNTIME_ALIVE` | boolean | `false` | Keep runtime alive after session ends |-| `SANDBOX_PAUSE_CLOSED_RUNTIMES` | boolean | `false` | Pause instead of stopping closed runtimes |-| `SANDBOX_CLOSE_DELAY` | integer | `300` | Delay before closing idle runtimes (seconds) |-| `SANDBOX_RM_ALL_CONTAINERS` | boolean | `false` | Remove all containers when stopping |-| `SANDBOX_ENABLE_GPU` | boolean | `false` | Enable GPU support |-| `SANDBOX_CUDA_VISIBLE_DEVICES` | string | `""` | Specify GPU devices by ID |-| `SANDBOX_VSCODE_PORT` | integer | auto | Specific port for VSCode server |--### Sandbox Environment Variables-Variables prefixed with `SANDBOX_ENV_` are passed through to the sandbox environment:--| Environment Variable | Description |-|---------------------|-------------|-| `SANDBOX_ENV_*` | Any variable with this prefix is passed to the sandbox (e.g., `SANDBOX_ENV_OPENAI_API_KEY`) |--## Security Configuration Variables--These variables correspond to the `[security]` section in `config.toml`:--| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `SECURITY_CONFIRMATION_MODE` | boolean | `false` | Enable confirmation mode for actions |-| `SECURITY_SECURITY_ANALYZER` | string | `"llm"` | Security analyzer to use (`llm`, `invariant`) |-| `SECURITY_ENABLE_SECURITY_ANALYZER` | boolean | `true` | Enable security analysis |--## Debug and Logging Variables--| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `DEBUG` | boolean | `false` | Enable general debug logging |-| `DEBUG_LLM` | boolean | `false` | Enable LLM-specific debug logging |-| `DEBUG_RUNTIME` | boolean | `false` | Enable runtime debug logging |-| `LOG_TO_FILE` | boolean | auto | Log to file (auto-enabled when DEBUG=true) |--## Runtime-Specific Variables--### Docker Runtime-| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `SANDBOX_VOLUME_OVERLAYS` | string | `""` | Volume overlay configurations |--### Remote Runtime-| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `SANDBOX_API_KEY` | string | `""` | API key for remote runtime |-| `SANDBOX_REMOTE_RUNTIME_API_URL` | string | `""` | Remote runtime API URL |--### Local Runtime-| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `RUNTIME_URL` | string | `""` | Runtime URL for local runtime |-| `RUNTIME_URL_PATTERN` | string | `""` | Runtime URL pattern |-| `RUNTIME_ID` | string | `""` | Runtime identifier |-| `LOCAL_RUNTIME_MODE` | string | `""` | Enable local runtime mode (`1` to enable) |--## Integration Variables--### GitHub Integration-| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `GITHUB_TOKEN` | string | `""` | GitHub personal access token |--### Third-Party API Keys-| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `OPENAI_API_KEY` | string | `""` | OpenAI API key |-| `ANTHROPIC_API_KEY` | string | `""` | Anthropic API key |-| `GOOGLE_API_KEY` | string | `""` | Google API key |-| `AZURE_API_KEY` | string | `""` | Azure API key |-| `TAVILY_API_KEY` | string | `""` | Tavily search API key |--## Server Configuration Variables--These are primarily used when running OpenHands as a server:--| Environment Variable | Type | Default | Description |-|---------------------|------|---------|-------------|-| `FRONTEND_PORT` | integer | `3000` | Frontend server port |-| `BACKEND_PORT` | integer | `8000` | Backend server port |-| `FRONTEND_HOST` | string | `"localhost"` | Frontend host address |-| `BACKEND_HOST` | string | `"localhost"` | Backend host address |-| `WEB_HOST` | string | `"localhost"` | Web server host |-| `SERVE_FRONTEND` | boolean | `true` | Whether to serve frontend |--## Deprecated Variables--These variables are deprecated and should be replaced:--| Environment Variable | Replacement | Description |-|---------------------|-------------|-------------|-| `WORKSPACE_BASE` | `SANDBOX_VOLUMES` | Use volume mounting instead |-| `WORKSPACE_MOUNT_PATH` | `SANDBOX_VOLUMES` | Use volume mounting instead |-| `WORKSPACE_MOUNT_PATH_IN_SANDBOX` | `SANDBOX_VOLUMES` | Use volume mounting instead |-| `WORKSPACE_MOUNT_REWRITE` | `SANDBOX_VOLUMES` | Use volume mounting instead |--## Usage Examples--### Basic Setup with OpenAI-```bash-export LLM_MODEL="gpt-4o"-export LLM_API_KEY="your-openai-api-key"-export DEBUG=true-```--### Docker Deployment with Custom Volumes-```bash-export RUNTIME="docker"-export SANDBOX_VOLUMES="/host/workspace:/workspace:rw,/host/data:/data:ro"-export SANDBOX_TIMEOUT=300-```--### Remote Runtime Configuration-```bash-export RUNTIME="remote"-export SANDBOX_API_KEY="your-remote-api-key"-export SANDBOX_REMOTE_RUNTIME_API_URL="https://your-runtime-api.com"-```--### Security-Enhanced Setup-```bash-export SECURITY_CONFIRMATION_MODE=true-export SECURITY_SECURITY_ANALYZER="llm"-export DEBUG_RUNTIME=true-```--## Notes--1. **Boolean Values**: Environment variables expecting boolean values accept `true`/`false`, `1`/`0`, or `yes`/`no` (case-insensitive).--2. **List Values**: Lists should be provided as Python literal strings, e.g., `AGENT_DISABLED_MICROAGENTS='["microagent1", "microagent2"]'`.--3. **Dictionary Values**: Dictionaries should be provided as Python literal strings, e.g., `SANDBOX_RUNTIME_STARTUP_ENV_VARS='{"KEY": "value"}'`.--4. **Precedence**: Environment variables take precedence over TOML configuration files.--5. **Docker Usage**: When using Docker, pass environment variables with the `-e` flag:- ```bash- docker run -e LLM_API_KEY="your-key" -e DEBUG=true openhands/openhands- ```--6. **Validation**: Invalid environment variable values will be logged as errors and fall back to defaults.\ No newline at end of filediff --git a/docs/usage/faqs.mdx b/docs/usage/faqs.mdxdeleted file mode 100644index 0888994d42..0000000000--- a/docs/usage/faqs.mdx+++ /dev/null@@ -1,96 +0,0 @@-----title: FAQs-description: Frequently asked questions about OpenHands-icon: question------## Getting Started--### I'm new to OpenHands. Where should I start?--1. **Quick start**: Use [OpenHands Cloud](/usage/cloud/openhands-cloud) to get started quickly with- [GitHub](/usage/cloud/github-installation), [GitLab](/usage/cloud/gitlab-installation),- and [Slack](/usage/cloud/slack-installation) integrations.-2. **Run on your own**: If you prefer to run it on your own hardware, follow our [Getting Started guide](/usage/local-setup).-3. **First steps**: Read over the [start building guidelines](/usage/getting-started) and- [prompting best practices](/usage/prompting/prompting-best-practices) to learn the basics.--### Can I use OpenHands for production workloads?--OpenHands is meant to be run by a single user on their local workstation. It is not appropriate for multi-tenant-deployments where multiple users share the same instance. There is no built-in authentication, isolation, or scalability.--If you're interested in running OpenHands in a multi-tenant environment, check out the source-available,-commercially-licensed [OpenHands Cloud Helm Chart](https://github.com/all-Hands-AI/OpenHands-cloud).--<Info>-Using OpenHands for work? We'd love to chat! Fill out-[this short form](https://docs.google.com/forms/d/e/1FAIpQLSet3VbGaz8z32gW9Wm-Grl4jpt5WgMXPgJ4EDPVmCETCBpJtQ/viewform)-to join our Design Partner program, where you'll get early access to commercial features and the opportunity to provide-input on our product roadmap.-</Info>--## Safety and Security--### It's doing stuff without asking, is that safe?--**Generally yes, but with important considerations.** OpenHands runs all code in a secure, isolated Docker container-(called a "sandbox") that is separate from your host system. However, the safety depends on your configuration:--**What's protected:**-- Your host system files and programs (unless you mount them using [this feature](/usage/runtimes/docker#connecting-to-your-filesystem))-- Host system resources-- Other containers and processes--**Potential risks to consider:**-- The agent can access the internet from within the container.-- If you provide credentials (API keys, tokens), the agent can use them.-- Mounted files and directories can be modified or deleted.-- Network requests can be made to external services.--For detailed security information, see our [Runtime Architecture](/usage/architecture/runtime),-[Security Configuration](/usage/configuration-options#security-configuration),-and [Hardened Docker Installation](/usage/runtimes/docker#hardened-docker-installation) documentation.--## File Storage and Access--### Where are my files stored?--Your files are stored in different locations depending on how you've configured OpenHands:--**Default behavior (no file mounting):**-- Files created by the agent are stored inside the runtime Docker container.-- These files are temporary and will be lost when the container is removed.-- The agent works in the `/workspace` directory inside the runtime container.--**When you mount your local filesystem (following [this](/usage/runtimes/docker#connecting-to-your-filesystem)):**-- Your local files are mounted into the container's `/workspace` directory.-- Changes made by the agent are reflected in your local filesystem.-- Files persist after the container is stopped.--<Warning>-Be careful when mounting your filesystem - the agent can modify or delete any files in the mounted directory.-</Warning>--## Development Tools and Environment--### How do I get the dev tools I need?--OpenHands comes with a basic runtime environment that includes Python and Node.js.-It also has the ability to install any tools it needs, so usually it's sufficient to ask it to set up its environment.--If you would like to set things up more systematically, you can:-- **Use setup.sh**: Add a [setup.sh file](/usage/prompting/repository#setup-script) file to- your repository, which will be run every time the agent starts.-- **Use a custom sandbox**: Use a [custom docker image](/usage/how-to/custom-sandbox-guide) to initialize the sandbox.--### Something's not working. Where can I get help?--1. **Search existing issues**: Check our [GitHub issues](https://github.com/All-Hands-AI/OpenHands/issues) to see if- others have encountered the same problem.-2. **Join our community**: Get help from other users and developers:- - [Slack community](https://dub.sh/openhands)-3. **Check our troubleshooting guide**: Common issues and solutions are documented in- [Troubleshooting](/usage/troubleshooting/troubleshooting).-4. **Report bugs**: If you've found a bug, please [create an issue](https://github.com/All-Hands-AI/OpenHands/issues/new)- and fill in as much detail as possible.diff --git a/docs/usage/feedback.mdx b/docs/usage/feedback.mdxdeleted file mode 100644index e47ebdc347..0000000000--- a/docs/usage/feedback.mdx+++ /dev/null@@ -1,50 +0,0 @@-# ✅ Providing Feedback--When using OpenHands, you will encounter cases where things work well, and others where they don't. We encourage you to-provide feedback when you use OpenHands to help give feedback to the development team, and perhaps more importantly,-create an open corpus of coding agent training examples -- Share-OpenHands!--## 📝 How to Provide Feedback--Providing feedback is easy! When you are using OpenHands, you can press the thumbs-up or thumbs-down button at any point-during your interaction. You will be prompted to provide your email address-(e.g. so we can contact you if we want to ask any follow-up questions), and you can choose whether you want to provide feedback publicly or privately.--<iframe width="560" height="315" src="https://www.youtube.com/embed/5rFx-StMVV0?si=svo7xzp6LhGK_GXr" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>--## 📜 Data Use and Privacy--### Data sharing settings--When you submit data, you can submit it either publicly or privately.--- **Public** data will be distributed under the MIT License, like OpenHands itself, and can be used by the community to-train and test models. Obviously, feedback that you can make public will be more valuable for the community as a whole,-so when you are not dealing with sensitive information, we would encourage you to choose this option!-- **Private** data will be made available to the OpenHands team for the purpose of improving OpenHands.-However, a link with a unique ID will still be created that you can share publicly with others.--### Who collects and stores the data?--The data is collected and stored by [All Hands AI](https://all-hands.dev), a company founded by OpenHands maintainers to support and improve OpenHands.--### How will public data be released?--The public data will be released when we hit fixed milestones, such as 1,000 public examples, 10,000 public examples, etc.-At this time, we will follow the following release process:--1. All people who contributed public feedback will receive an email describing the data release and being given an opportunity to opt out.-2. The person or people in charge of the data release will perform quality control of the data, removing low-quality feedback,-removing email submitter email addresses, and attempting to remove any sensitive information.-3. The data will be released publicly under the MIT license through commonly used sites such as GitHub or Hugging Face.--### What if I want my data deleted?--For data on the All Hands AI servers, we are happy to delete it at request:--**One Piece of Data:** If you want one piece of data deleted, we will shortly be adding a mechanism to delete pieces of-data using the link and password that is displayed on the interface when you submit data.--**All Data:** If you would like all pieces of your data deleted, or you do not have the ID and password that you-received when submitting the data, please contact `[email protected]` from the email address that you registered-when you originally submitted the data.diff --git a/docs/usage/getting-started.mdx b/docs/usage/getting-started.mdxdeleted file mode 100644index 3f22e9bcdb..0000000000--- a/docs/usage/getting-started.mdx+++ /dev/null@@ -1,100 +0,0 @@-----title: Start Building-description: So you've [run OpenHands](/usage/installation). Now what?-icon: code------OpenHands can assist with a range of engineering tasks. However, the technology is still new, and we’re far from having-agents that can handle complex tasks independently. It’s important to understand what the agent does well and where it-needs support.--## Hello World--Start with a simple "hello world" example. It might be trickier than it seems!--Prompt the agent with:-> Write a bash script hello.sh that prints "hello world!"--The agent will write the script, set the correct permissions, and run it to check the output.--You can continue prompting the agent to refine your code. This is a great way to-work with agents. Start simple, and iterate.--> Modify hello.sh so that it accepts a name as the first argument, but defaults to "world"--You can also use any language you need. The agent may need time to set up the environment.--> Please convert hello.sh to a Ruby script, and run it--## Building From Scratch--Agents excel at "greenfield" tasks, where they don’t need context about existing code and-they can start from scratch.-Begin with a simple task and iterate from there. Be specific about what you want and the tech stack.--For example, we might build a TODO app:--> Build a frontend-only TODO app in React. All state should be stored in localStorage.--Once the basic structure is in place, continue refining:--> Allow adding an optional due date to each task.--Just like normal development, commit and push your code often.-This way you can always revert back to an old state if the agent goes off track.-You can ask the agent to commit and push for you:--> Commit the changes and push them to a new branch called "feature/due-dates"--## Adding New Code--OpenHands is great at adding new code to an existing codebase.--For instance, you can ask OpenHands to add a GitHub action that lints your code. It might check your codebase to-determine the language, then create a new file in `./github/workflows/lint.yml`.--> Add a GitHub action that lints the code in this repository.--Some tasks need more context. While OpenHands can use commands like ls and grep to search, providing context upfront-speeds things up and reduces token usage.--> Modify ./backend/api/routes.js to add a new route that returns a list of all tasks.--> Add a new React component to the ./frontend/components directory to display a list of Widgets.-> It should use the existing Widget component.--## Refactoring--OpenHands does great at refactoring code in small chunks. Rather than rearchitecting the entire codebase,-it's more effective to break up long files and functions or rename variables.--> Rename all the single-letter variables in ./app.go.--> Split the `build_and_deploy_widgets` function into two functions, `build_widgets` and `deploy_widgets` in widget.php.--> Break ./api/routes.js into separate files for each route.--## Bug Fixes--OpenHands can help track down and fix bugs, but bug fixing can be tricky and often requires more context.-It’s helpful if you’ve already diagnosed the issue and just need OpenHands to handle the logic.--> The email field in the `/subscribe` endpoint is rejecting .io domains. Fix this.--> The `search_widgets` function in ./app.py is doing a case-sensitive search. Make it case-insensitive.--For bug fixing, test-driven development can be really useful. You can ask the agent to write a new test and iterate-until the bug is fixed:--> The `hello` function crashes on the empty string. Write a test that reproduces this bug, then fix the code so it passes.--## More--OpenHands can assist with nearly any coding task, but it takes some practice to get the best results.-Keep these tips in mind:-* Keep your tasks small.-* Be specific.-* Provide plenty of context.-* Commit and push frequently.--See [Prompting Best Practices](./prompting/prompting-best-practices) for more tips on how to get the most out of OpenHands.diff --git a/docs/usage/how-to/cli-mode.mdx b/docs/usage/how-to/cli-mode.mdxdeleted file mode 100644index 6ad9e89a87..0000000000--- a/docs/usage/how-to/cli-mode.mdx+++ /dev/null@@ -1,231 +0,0 @@-----title: CLI-description: The Command-Line Interface (CLI) provides a powerful interface that lets you engage with OpenHands- directly from your terminal.------This mode is different from the [headless mode](/usage/how-to/headless-mode), which is non-interactive and better-for scripting.--<iframe- className="w-full aspect-video"- src="https://www.youtube.com/embed/PfvIx4y8h7w"- title="OpenHands CLI Tutorial"- frameBorder="0"- allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"- allowFullScreen>-</iframe>--## Getting Started--### Running with Python--**Note** - OpenHands requires Python version 3.12 or higher (Python 3.14 is not currently supported) and `uv` for the default `fetch` MCP server (more details below).--#### Recommended: Using uv--We recommend using [uv](https://docs.astral.sh/uv/) for the best OpenHands experience. uv provides better isolation from your current project's virtual environment and is required for OpenHands' default MCP servers.--1. **Install uv** (if you haven't already):-- See the [uv installation guide](https://docs.astral.sh/uv/getting-started/installation/) for the latest installation instructions for your platform.--2. **Launch OpenHands CLI**:-```bash-uvx --python 3.12 --from openhands-ai openhands-```--<AccordionGroup>--<Accordion title="Alternative: Traditional pip installation">--If you prefer to use pip:--```bash-# Install OpenHands-pip install openhands-ai-```--Note that you'll still need `uv` installed for the default MCP servers to work properly.--</Accordion>--<Accordion title="Create shell aliases for easy access across environments">--Add the following to your shell configuration file (`.bashrc`, `.zshrc`, etc.):--```bash-# Add OpenHands aliases (recommended)-alias openhands="uvx --python 3.12 --from openhands-ai openhands"-alias oh="uvx --python 3.12 --from openhands-ai openhands"-```--After adding these lines, reload your shell configuration with `source ~/.bashrc` or `source ~/.zshrc` (depending on your shell).--</Accordion>--<Accordion title="Install OpenHands in home directory without global installation">--You can install OpenHands in a virtual environment in your home directory using `uv`:--```bash-# Create a virtual environment in your home directory-cd ~-uv venv .openhands-venv --python 3.12--# Install OpenHands in the virtual environment-uv pip install -t ~/.openhands-venv/lib/python3.12/site-packages openhands-ai--# Add the bin directory to your PATH in your shell configuration file-echo 'export PATH="$PATH:$HOME/.openhands-venv/bin"' >> ~/.bashrc # or ~/.zshrc--# Reload your shell configuration-source ~/.bashrc # or source ~/.zshrc-```--</Accordion>--</AccordionGroup>--<Note>- If you have cloned the repository, you can also run the CLI directly using Poetry:-- poetry run openhands-</Note>--3. Set your model, API key, and other preferences using the UI (or alternatively environment variables, below).--This command opens an interactive prompt where you can type tasks or commands and get responses from OpenHands.-The first time you run the CLI, it will take you through configuring the required LLM-settings. These will be saved for future sessions.--The conversation history will be saved in `~/.openhands/sessions`.--### Running with Docker--1. Set the following environment variables in your terminal:- - `SANDBOX_VOLUMES` to specify the directory you want OpenHands to access ([See using SANDBOX_VOLUMES for more info](../runtimes/docker#using-sandbox_volumes))- - `LLM_MODEL` - the LLM model to use (e.g. `export LLM_MODEL="anthropic/claude-sonnet-4-20250514"` or `export LLM_MODEL="anthropic/claude-sonnet-4-5-20250929"`)- - `LLM_API_KEY` - your API key (e.g. `export LLM_API_KEY="sk_test_12345"`)--2. Run the following command:--```bash-docker run -it \- --pull=always \- -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.58-nikolaik \- -e SANDBOX_USER_ID=$(id -u) \- -e SANDBOX_VOLUMES=$SANDBOX_VOLUMES \- -e LLM_API_KEY=$LLM_API_KEY \- -e LLM_MODEL=$LLM_MODEL \- -v /var/run/docker.sock:/var/run/docker.sock \- -v ~/.openhands:/.openhands \- --add-host host.docker.internal:host-gateway \- --name openhands-app-$(date +%Y%m%d%H%M%S) \- docker.all-hands.dev/all-hands-ai/openhands:0.58 \- python -m openhands.cli.entry --override-cli-mode true-```--<Note>- If you used OpenHands before version 0.44, you may want to run `mv ~/.openhands-state ~/.openhands` to migrate your- conversation history to the new location.-</Note>--This launches the CLI in Docker, allowing you to interact with OpenHands.--The `-e SANDBOX_USER_ID=$(id -u)` is passed to the Docker command to ensure the sandbox user matches the host user’s-permissions. This prevents the agent from creating root-owned files in the mounted workspace.--The conversation history will be saved in `~/.openhands/sessions`.--## Interactive CLI Overview--### What is CLI Mode?--CLI mode enables real-time interaction with OpenHands agents. You can type natural language tasks, use interactive-commands, and receive instant feedback—all inside your terminal.--### Starting a Conversation--When you start the CLI, you'll see a welcome message and a prompt (`>`). Enter your first task or type a command to-begin your conversation.--### Available Commands--You can use the following commands whenever the prompt (`>`) is displayed:--| Command | Description |-|--------------|----------------------------------------------------------------|-| `/help` | Show all available interactive commands and their descriptions |-| `/exit` | Exit the application |-| `/init` | Initialize a new repository for agent exploration |-| `/status` | Show conversation details and usage metrics |-| `/new` | Start a new conversation |-| `/settings` | View and modify current LLM/agent settings |-| `/resume` | Resume the agent if paused |-| `/mcp` | Manage MCP server configuration and view connection errors |--#### Settings and Configuration--You can update your model, API key, agent, and other preferences interactively using the `/settings` command. Just-follow the prompts:--- **Basic settings**: Choose a model/provider and enter your API key.-- **Advanced settings**: Set custom endpoints, enable or disable confirmation mode, and configure memory condensation.--Settings can also be managed via the `config.toml` file in the current directory or `~/.openhands/config.toml`.--#### Repository Initialization--The `/init` command helps the agent understand your project by creating a `.openhands/microagents/repo.md` file with-project details and structure. Use this when onboarding the agent to a new codebase.--#### Agent Pause/Resume Feature--You can pause the agent while it is running by pressing `Ctrl-P`. To continue the conversation after pausing, simply-type `/resume` at the prompt.--#### MCP Server Management--To configure Model Context Protocol (MCP) servers, you can refer to the documentation on [MCP servers](../mcp) and use the `/mcp` command in the CLI. This command provides an interactive interface for managing Model Context Protocol (MCP) servers:--- **List configured servers**: View all currently configured MCP servers (SSE, Stdio, and SHTTP)-- **Add new server**: Interactively add a new MCP server with guided prompts-- **Remove server**: Remove an existing MCP server from your configuration-- **View errors**: Display any connection errors that occurred during MCP server startup--This command modifies your `~/.openhands/config.toml` file and will prompt you to restart OpenHands for changes to take effect.--By default, the [Fetch MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/fetch) will be automatically configured for OpenHands. You can also [enable search engine](../search-engine-setup) via the [Tavily MCP server](https://github.com/tavily-ai/tavily-mcp) by setting the `search_api_key` under the `[core]` section in the `~/.openhands/config.toml` file.--##### Example of the `config.toml` file with MCP server configuration:--```toml-[core]-search_api_key = "tvly-your-api-key-here"--[mcp]-stdio_servers = [- {name="fetch", command="uvx", args=["mcp-server-fetch"]},-]--sse_servers = [- # Basic SSE server with just a URL- "http://example.com:8080/sse",-]--shttp_servers = [- # Streamable HTTP server with API key authentication- {url="https://secure-example.com/mcp", api_key="your-api-key"}-]-```--## Tips and Troubleshooting--- Use `/help` at any time to see the list of available commands.-- If you encounter permission issues, make sure your workspace directory is trusted and all required environment variables are set correctly.-- For advanced LLM configuration, use the advanced options in `/settings`.-- When confirmation mode is enabled, the CLI will prompt before sensitive operations. You can type `a` or `always` at the first confirmation prompt to automatically confirm subsequent actions for the current conversation.-- If you want to start over, use `/new` to begin a fresh conversation without restarting the CLI.-----diff --git a/docs/usage/how-to/custom-sandbox-guide.mdx b/docs/usage/how-to/custom-sandbox-guide.mdxdeleted file mode 100644index b2380adc98..0000000000--- a/docs/usage/how-to/custom-sandbox-guide.mdx+++ /dev/null@@ -1,101 +0,0 @@-----title: Custom Sandbox-description: This guide is for users that would like to use their own custom Docker image for the runtime.- For example, with certain tools or programming languages pre-installed.------The sandbox is where the agent performs its tasks. Instead of running commands directly on your computer-(which could be risky), the agent runs them inside a Docker container.--The default OpenHands sandbox (`python-nodejs:python3.12-nodejs22`-from [nikolaik/python-nodejs](https://hub.docker.com/r/nikolaik/python-nodejs)) comes with some packages installed such-as python and Node.js but may need other software installed by default.--You have two options for customization:--- Use an existing image with the required software.-- Create your own custom Docker image.--If you choose the first option, you can skip the `Create Your Docker Image` section.--## Create Your Docker Image--To create a custom Docker image, it must be Debian based.--For example, if you want OpenHands to have `ruby` installed, you could create a `Dockerfile` with the following content:--```dockerfile-FROM nikolaik/python-nodejs:python3.12-nodejs22--# Install required packages-RUN apt-get update && apt-get install -y ruby-```--Or you could use a Ruby-specific base image:--```dockerfile-FROM ruby:latest-```--Save this file in a folder. Then, build your Docker image (e.g., named custom-image) by navigating to the folder in-the terminal and running::-```bash-docker build -t custom-image .-```--This will produce a new image called `custom-image`, which will be available in Docker.--## Using the Docker Command--When running OpenHands using [the docker command](/usage/local-setup#start-the-app), replace-`-e SANDBOX_RUNTIME_CONTAINER_IMAGE=...` with `-e SANDBOX_BASE_CONTAINER_IMAGE=<custom image name>`:--```commandline-docker run -it --rm --pull=always \- -e SANDBOX_BASE_CONTAINER_IMAGE=custom-image \- ...-```--## Using the Development Workflow--### Setup--First, ensure you can run OpenHands by following the instructions in [Development.md](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md).--### Specify the Base Sandbox Image--In the `config.toml` file within the OpenHands directory, set the `base_container_image` to the image you want to use.-This can be an image you’ve already pulled or one you’ve built:--```bash-[core]-...-[sandbox]-base_container_image="custom-image"-```--### Additional Configuration Options--The `config.toml` file supports several other options for customizing your sandbox:--```toml-[core]-# Install additional dependencies when the runtime is built-# Can contain any valid shell commands-# If you need the path to the Python interpreter in any of these commands, you can use the $OH_INTERPRETER_PATH variable-runtime_extra_deps = """-pip install numpy pandas-apt-get update && apt-get install -y ffmpeg-"""--# Set environment variables for the runtime-# Useful for configuration that needs to be available at runtime-runtime_startup_env_vars = { DATABASE_URL = "postgresql://user:pass@localhost/db" }--# Specify platform for multi-architecture builds (e.g., "linux/amd64" or "linux/arm64")-platform = "linux/amd64"-```--### Run--Run OpenHands by running ```make run``` in the top level directory.diff --git a/docs/usage/how-to/debugging.mdx b/docs/usage/how-to/debugging.mdxdeleted file mode 100644index b8a4ead3df..0000000000--- a/docs/usage/how-to/debugging.mdx+++ /dev/null@@ -1,73 +0,0 @@-----title: Debugging------The following is intended as a primer on debugging OpenHands for Development purposes.--## Server / VSCode--The following `launch.json` will allow debugging the agent, controller and server elements, but not the sandbox (Which runs inside docker). It will ignore any changes inside the `workspace/` directory:--```-{- "version": "0.2.0",- "configurations": [- {- "name": "OpenHands CLI",- "type": "debugpy",- "request": "launch",- "module": "openhands.cli.main",- "justMyCode": false- },- {- "name": "OpenHands WebApp",- "type": "debugpy",- "request": "launch",- "module": "uvicorn",- "args": [- "openhands.server.listen:app",- "--reload",- "--reload-exclude",- "${workspaceFolder}/workspace",- "--port",- "3000"- ],- "justMyCode": false- }- ]-}-```--More specific debugging configurations which include more parameters may be specified:--```- ...- {- "name": "Debug CodeAct",- "type": "debugpy",- "request": "launch",- "module": "openhands.core.main",- "args": [- "-t",- "Ask me what your task is.",- "-d",- "${workspaceFolder}/workspace",- "-c",- "CodeActAgent",- "-l",- "llm.o1",- "-n",- "prompts"- ],- "justMyCode": false- }- ...-```--Values in the snippet above can be updated such that:-- * *t*: the task- * *d*: the openhands workspace directory- * *c*: the agent- * *l*: the LLM config (pre-defined in config.toml)- * *n*: session name (e.g. eventstream name)diff --git a/docs/usage/how-to/development-overview.mdx b/docs/usage/how-to/development-overview.mdxdeleted file mode 100644index dbd7a5a5ba..0000000000--- a/docs/usage/how-to/development-overview.mdx+++ /dev/null@@ -1,71 +0,0 @@-----title: Development Overview-description: This guide provides an overview of the key documentation resources available in the OpenHands repository. Whether you're looking to contribute, understand the architecture, or work on specific components, these resources will help you navigate the codebase effectively.------## Core Documentation--### Project Fundamentals-- **Main Project Overview** (`/README.md`)- The primary entry point for understanding OpenHands, including features and basic setup instructions.--- **Development Guide** (`/Development.md`)- Comprehensive guide for developers working on OpenHands, including setup, requirements, and development workflows.--- **Contributing Guidelines** (`/CONTRIBUTING.md`)- Essential information for contributors, covering code style, PR process, and contribution workflows.--### Component Documentation--#### Frontend-- **Frontend Application** (`/frontend/README.md`)- Complete guide for setting up and developing the React-based frontend application.--#### Backend-- **Backend Implementation** (`/openhands/README.md`)- Detailed documentation of the Python backend implementation and architecture.--- **Server Documentation** (`/openhands/server/README.md`)- Server implementation details, API documentation, and service architecture.--- **Runtime Environment** (`/openhands/runtime/README.md`)- Documentation covering the runtime environment, execution model, and runtime configurations.--#### Infrastructure-- **Container Documentation** (`/containers/README.md`)- Comprehensive information about Docker containers, deployment strategies, and container management.--### Testing and Evaluation-- **Unit Testing Guide** (`/tests/unit/README.md`)- Instructions for writing, running, and maintaining unit tests.--- **Evaluation Framework** (`/evaluation/README.md`)- Documentation for the evaluation framework, benchmarks, and performance testing.--### Advanced Features-- **Microagents Architecture** (`/microagents/README.md`)- Detailed information about the microagents architecture, implementation, and usage.--### Documentation Standards-- **Documentation Style Guide** (`/docs/DOC_STYLE_GUIDE.md`)- Standards and guidelines for writing and maintaining project documentation.--## Getting Started with Development--If you're new to developing with OpenHands, we recommend following this sequence:--1. Start with the main `README.md` to understand the project's purpose and features-2. Review the `CONTRIBUTING.md` guidelines if you plan to contribute-3. Follow the setup instructions in `Development.md`-4. Dive into specific component documentation based on your area of interest:- - Frontend developers should focus on `/frontend/README.md`- - Backend developers should start with `/openhands/README.md`- - Infrastructure work should begin with `/containers/README.md`--## Documentation Updates--When making changes to the codebase, please ensure that:-1. Relevant documentation is updated to reflect your changes-2. New features are documented in the appropriate README files-3. Any API changes are reflected in the server documentation-4. Documentation follows the style guide in `/docs/DOC_STYLE_GUIDE.md`diff --git a/docs/usage/how-to/evaluation-harness.mdx b/docs/usage/how-to/evaluation-harness.mdxdeleted file mode 100644index 474a2b573b..0000000000--- a/docs/usage/how-to/evaluation-harness.mdx+++ /dev/null@@ -1,280 +0,0 @@-----title: Evaluation Harness------This guide provides an overview of how to integrate your own evaluation benchmark into the OpenHands framework.--## Setup Environment and LLM Configuration--Please follow instructions [here](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md) to setup your local development environment.-OpenHands in development mode uses `config.toml` to keep track of most configurations.--Here's an example configuration file you can use to define and use multiple LLMs:--```toml-[llm]-# IMPORTANT: add your API key here, and set the model to the one you want to evaluate-model = "claude-3-5-sonnet-20241022"-api_key = "sk-XXX"--[llm.eval_gpt4_1106_preview_llm]-model = "gpt-4-1106-preview"-api_key = "XXX"-temperature = 0.0--[llm.eval_some_openai_compatible_model_llm]-model = "openai/MODEL_NAME"-base_url = "https://OPENAI_COMPATIBLE_URL/v1"-api_key = "XXX"-temperature = 0.0-```---## How to use OpenHands in the command line--OpenHands can be run from the command line using the following format:--```bash-poetry run python ./openhands/core/main.py \- -i <max_iterations> \- -t "<task_description>" \- -c <agent_class> \- -l <llm_config>-```--For example:--```bash-poetry run python ./openhands/core/main.py \- -i 10 \- -t "Write me a bash script that prints hello world." \- -c CodeActAgent \- -l llm-```--This command runs OpenHands with:-- A maximum of 10 iterations-- The specified task description-- Using the CodeActAgent-- With the LLM configuration defined in the `llm` section of your `config.toml` file--## How does OpenHands work--The main entry point for OpenHands is in `openhands/core/main.py`. Here's a simplified flow of how it works:--1. Parse command-line arguments and load the configuration-2. Create a runtime environment using `create_runtime()`-3. Initialize the specified agent-4. Run the controller using `run_controller()`, which:- - Attaches the runtime to the agent- - Executes the agent's task- - Returns a final state when complete--The `run_controller()` function is the core of OpenHands's execution. It manages the interaction between the agent, the runtime, and the task, handling things like user input simulation and event processing.---## Easiest way to get started: Exploring Existing Benchmarks--We encourage you to review the various evaluation benchmarks available in the [`evaluation/benchmarks/` directory](https://github.com/All-Hands-AI/OpenHands/blob/main/evaluation/benchmarks) of our repository.--To integrate your own benchmark, we suggest starting with the one that most closely resembles your needs. This approach can significantly streamline your integration process, allowing you to build upon existing structures and adapt them to your specific requirements.--## How to create an evaluation workflow---To create an evaluation workflow for your benchmark, follow these steps:--1. Import relevant OpenHands utilities:- ```python- import openhands.agenthub- from evaluation.utils.shared import (- EvalMetadata,- EvalOutput,- make_metadata,- prepare_dataset,- reset_logger_for_multiprocessing,- run_evaluation,- )- from openhands.controller.state.state import State- from openhands.core.config import (- AppConfig,- SandboxConfig,- get_llm_config_arg,- parse_arguments,- )- from openhands.core.logger import openhands_logger as logger- from openhands.core.main import create_runtime, run_controller- from openhands.events.action import CmdRunAction- from openhands.events.observation import CmdOutputObservation, ErrorObservation- from openhands.runtime.runtime import Runtime- ```--2. Create a configuration:- ```python- def get_config(instance: pd.Series, metadata: EvalMetadata) -> AppConfig:- config = AppConfig(- default_agent=metadata.agent_class,- runtime='docker',- max_iterations=metadata.max_iterations,- sandbox=SandboxConfig(- base_container_image='your_container_image',- enable_auto_lint=True,- timeout=300,- ),- )- config.set_llm_config(metadata.llm_config)- return config- ```--3. Initialize the runtime and set up the evaluation environment:- ```python- def initialize_runtime(runtime: Runtime, instance: pd.Series):- # Set up your evaluation environment here- # For example, setting environment variables, preparing files, etc.- pass- ```--4. Create a function to process each instance:- ```python- from openhands.utils.async_utils import call_async_from_sync- def process_instance(instance: pd.Series, metadata: EvalMetadata) -> EvalOutput:- config = get_config(instance, metadata)- runtime = create_runtime(config)- call_async_from_sync(runtime.connect)- initialize_runtime(runtime, instance)-- instruction = get_instruction(instance, metadata)-- state = run_controller(- config=config,- task_str=instruction,- runtime=runtime,- fake_user_response_fn=your_user_response_function,- )-- # Evaluate the agent's actions- evaluation_result = await evaluate_agent_actions(runtime, instance)-- return EvalOutput(- instance_id=instance.instance_id,- instruction=instruction,- test_result=evaluation_result,- metadata=metadata,- history=compatibility_for_eval_history_pairs(state.history),- metrics=state.metrics.get() if state.metrics else None,- error=state.last_error if state and state.last_error else None,- )- ```--5. Run the evaluation:- ```python- metadata = make_metadata(llm_config, dataset_name, agent_class, max_iterations, eval_note, eval_output_dir)- output_file = os.path.join(metadata.eval_output_dir, 'output.jsonl')- instances = prepare_dataset(your_dataset, output_file, eval_n_limit)-- await run_evaluation(- instances,- metadata,- output_file,- num_workers,- process_instance- )- ```--This workflow sets up the configuration, initializes the runtime environment, processes each instance by running the agent and evaluating its actions, and then collects the results into an `EvalOutput` object. The `run_evaluation` function handles parallelization and progress tracking.--Remember to customize the `get_instruction`, `your_user_response_function`, and `evaluate_agent_actions` functions according to your specific benchmark requirements.--By following this structure, you can create a robust evaluation workflow for your benchmark within the OpenHands framework.---## Understanding the `user_response_fn`--The `user_response_fn` is a crucial component in OpenHands's evaluation workflow. It simulates user interaction with the agent, allowing for automated responses during the evaluation process. This function is particularly useful when you want to provide consistent, predefined responses to the agent's queries or actions.---### Workflow and Interaction--The correct workflow for handling actions and the `user_response_fn` is as follows:--1. Agent receives a task and starts processing-2. Agent emits an Action-3. If the Action is executable (e.g., CmdRunAction, IPythonRunCellAction):- - The Runtime processes the Action- - Runtime returns an Observation-4. If the Action is not executable (typically a MessageAction):- - The `user_response_fn` is called- - It returns a simulated user response-5. The agent receives either the Observation or the simulated response-6. Steps 2-5 repeat until the task is completed or max iterations are reached--Here's a more accurate visual representation:--```- [Agent]- |- v- [Emit Action]- |- v- [Is Action Executable?]- / \- Yes No- | |- v v- [Runtime] [user_response_fn]- | |- v v- [Return Observation] [Simulated Response]- \ /- \ /- v v- [Agent receives feedback]- |- v- [Continue or Complete Task]-```--In this workflow:--- Executable actions (like running commands or executing code) are handled directly by the Runtime-- Non-executable actions (typically when the agent wants to communicate or ask for clarification) are handled by the `user_response_fn`-- The agent then processes the feedback, whether it's an Observation from the Runtime or a simulated response from the `user_response_fn`--This approach allows for automated handling of both concrete actions and simulated user interactions, making it suitable for evaluation scenarios where you want to test the agent's ability to complete tasks with minimal human intervention.--### Example Implementation--Here's an example of a `user_response_fn` used in the SWE-Bench evaluation:--```python-def codeact_user_response(state: State | None) -> str:- msg = (- 'Please continue working on the task on whatever approach you think is suitable.\n'- 'If you think you have solved the task, please first send your answer to user through message and then <execute_bash> exit </execute_bash>.\n'- 'IMPORTANT: YOU SHOULD NEVER ASK FOR HUMAN HELP.\n'- )-- if state and state.history:- # check if the agent has tried to talk to the user 3 times, if so, let the agent know it can give up- user_msgs = [- event- for event in state.history- if isinstance(event, MessageAction) and event.source == 'user'- ]- if len(user_msgs) >= 2:- # let the agent know that it can give up when it has tried 3 times- return (- msg- + 'If you want to give up, run: <execute_bash> exit </execute_bash>.\n'- )- return msg-```--This function does the following:--1. Provides a standard message encouraging the agent to continue working-2. Checks how many times the agent has attempted to communicate with the user-3. If the agent has made multiple attempts, it provides an option to give up--By using this function, you can ensure consistent behavior across multiple evaluation runs and prevent the agent from getting stuck waiting for human input.diff --git a/docs/usage/how-to/github-action.mdx b/docs/usage/how-to/github-action.mdxdeleted file mode 100644index d35bf3ed48..0000000000--- a/docs/usage/how-to/github-action.mdx+++ /dev/null@@ -1,53 +0,0 @@-----title: OpenHands GitHub Action-description: This guide explains how to use the OpenHands GitHub Action in your own projects.------## Using the Action in the OpenHands Repository--To use the OpenHands GitHub Action in a repository, you can:--1. Create an issue in the repository.-2. Add the `fix-me` label to the issue or leave a comment on the issue starting with `@openhands-agent`.--The action will automatically trigger and attempt to resolve the issue.--## Installing the Action in a New Repository--To install the OpenHands GitHub Action in your own repository, follow-the [README for the OpenHands Resolver](https://github.com/All-Hands-AI/OpenHands/blob/main/openhands/resolver/README.md).--## Usage Tips--### Iterative resolution--1. Create an issue in the repository.-2. Add the `fix-me` label to the issue, or leave a comment starting with `@openhands-agent`.-3. Review the attempt to resolve the issue by checking the pull request.-4. Follow up with feedback through general comments, review comments, or inline thread comments.-5. Add the `fix-me` label to the pull request, or address a specific comment by starting with `@openhands-agent`.--### Label versus Macro--- Label (`fix-me`): Requests OpenHands to address the **entire** issue or pull request.-- Macro (`@openhands-agent`): Requests OpenHands to consider only the issue/pull request description and **the specific comment**.--## Advanced Settings--### Add custom repository settings--You can provide custom directions for OpenHands by following the [README for the resolver](https://github.com/All-Hands-AI/OpenHands/blob/main/openhands/resolver/README.md#providing-custom-instructions).--### Custom configurations--GitHub resolver will automatically check for valid [repository secrets](https://docs.github.com/en/actions/security-for-github-actions/security-guides/using-secrets-in-github-actions?tool=webui#creating-secrets-for-a-repository) or [repository variables](https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/store-information-in-variables#creating-configuration-variables-for-a-repository) to customize its behavior.-The customization options you can set are:--| **Attribute name** | **Type** | **Purpose** | **Example** |-| -------------------------------- | -------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------- |-| `LLM_MODEL` | Variable | Set the LLM to use with OpenHands | `LLM_MODEL="anthropic/claude-3-5-sonnet-20241022"` |-| `OPENHANDS_MAX_ITER` | Variable | Set max limit for agent iterations | `OPENHANDS_MAX_ITER=10` |-| `OPENHANDS_MACRO` | Variable | Customize default macro for invoking the resolver | `OPENHANDS_MACRO=@resolveit` |-| `OPENHANDS_BASE_CONTAINER_IMAGE` | Variable | Custom Sandbox ([learn more](/usage/how-to/custom-sandbox-guide)) | `OPENHANDS_BASE_CONTAINER_IMAGE="custom_image"` |-| `TARGET_BRANCH` | Variable | Merge to branch other than `main` | `TARGET_BRANCH="dev"` |-| `TARGET_RUNNER` | Variable | Target runner to execute the agent workflow (default ubuntu-latest) | `TARGET_RUNNER="custom-runner"` |diff --git a/docs/usage/how-to/gui-mode.mdx b/docs/usage/how-to/gui-mode.mdxdeleted file mode 100644index 5359c756a6..0000000000--- a/docs/usage/how-to/gui-mode.mdx+++ /dev/null@@ -1,257 +0,0 @@-----title: GUI-description: High level overview of the Graphical User Interface (GUI) in OpenHands.------## Prerequisites--- [OpenHands is running](/usage/local-setup)--## Launching the GUI Server--### Using the CLI Command--You can launch the OpenHands GUI server directly from the command line using the `serve` command:--<Callout type="info">-**Prerequisites**: You need to have the [OpenHands CLI installed](/usage/how-to/cli-mode) first, OR have `uv` installed and run `uvx --python 3.12 --from openhands-ai openhands serve`. Otherwise, you'll need to use Docker directly (see the [Docker section](#using-docker-directly) below).-</Callout>--```bash-openhands serve-```--This command will:-- Check that Docker is installed and running-- Pull the required Docker images-- Launch the OpenHands GUI server at http://localhost:3000-- Use the same configuration directory (`~/.openhands`) as the CLI mode--#### Mounting Your Current Directory--To mount your current working directory into the GUI server container, use the `--mount-cwd` flag:--```bash-openhands serve --mount-cwd-```--This is useful when you want to work on files in your current directory through the GUI. The directory will be mounted at `/workspace` inside the container.--#### Using GPU Support--If you have NVIDIA GPUs and want to make them available to the OpenHands container, use the `--gpu` flag:--```bash-openhands serve --gpu-```--This will enable GPU support via nvidia-docker, mounting all available GPUs into the container. You can combine this with other flags:--```bash-openhands serve --gpu --mount-cwd-```--**Prerequisites for GPU support:**-- NVIDIA GPU drivers must be installed on your host system-- [NVIDIA Container Toolkit (nvidia-docker2)](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html) must be installed and configured--#### Requirements--Before using the `openhands serve` command, ensure that:-- Docker is installed and running on your system-- You have internet access to pull the required Docker images-- Port 3000 is available on your system--The CLI will automatically check these requirements and provide helpful error messages if anything is missing.--### Using Docker Directly--Alternatively, you can run the GUI server using Docker directly. See the [local setup guide](/usage/local-setup) for detailed Docker instructions.--## Overview--### Initial Setup--1. Upon first launch, you'll see a settings popup.-2. Select an `LLM Provider` and `LLM Model` from the dropdown menus. If the required model does not exist in the list,- select `see advanced settings`. Then toggle `Advanced` options and enter it with the correct prefix in the- `Custom Model` text box.-3. Enter the corresponding `API Key` for your chosen provider.-4. Click `Save Changes` to apply the settings.--### Settings--You can use the Settings page at any time to:--- Setup the LLM provider and model for OpenHands.-- [Setup the search engine](/usage/search-engine-setup).-- [Configure MCP servers](/usage/settings/mcp-settings).-- [Connect to GitHub](/usage/how-to/gui-mode#github-setup), [connect to GitLab](/usage/how-to/gui-mode#gitlab-setup)- and [connect to Bitbucket](/usage/how-to/gui-mode#bitbucket-setup).-- Set application settings like your preferred language, notifications and other preferences.-- [Manage custom secrets](/usage/settings/secrets-settings).--#### GitHub Setup--OpenHands automatically exports a `GITHUB_TOKEN` to the shell environment if provided:--<AccordionGroup>-<Accordion title="Setting Up a GitHub Token">-- 1. **Generate a Personal Access Token (PAT)**:- - On GitHub, go to Settings > Developer Settings > Personal Access Tokens > Tokens (classic).- - **New token (classic)**- - Required scopes:- - `repo` (Full control of private repositories)- - **Fine-Grained Tokens**- - All Repositories (You can select specific repositories, but this will impact what returns in repo search)- - Minimal Permissions (Select `Meta Data = Read-only` read for search, `Pull Requests = Read and Write` and `Content = Read and Write` for branch creation)- 2. **Enter Token in OpenHands**:- - In the Settings page, navigate to the `Integrations` tab.- - Paste your token in the `GitHub Token` field.- - Click `Save Changes` to apply the changes.-- If you're working with organizational repositories, additional setup may be required:-- 1. **Check Organization Requirements**:- - Organization admins may enforce specific token policies.- - Some organizations require tokens to be created with SSO enabled.- - Review your organization's [token policy settings](https://docs.github.com/en/organizations/managing-programmatic-access-to-your-organization/setting-a-personal-access-token-policy-for-your-organization).- 2. **Verify Organization Access**:- - Go to your token settings on GitHub.- - Look for the organization under `Organization access`.- - If required, click `Enable SSO` next to your organization.- - Complete the SSO authorization process.-</Accordion>--<Accordion title="Troubleshooting">- Common issues and solutions:-- - **Token Not Recognized**:- - Check that the token hasn't expired.- - Verify the token has the required scopes.- - Try regenerating the token.-- - **Organization Access Denied**:- - Check if SSO is required but not enabled.- - Verify organization membership.- - Contact organization admin if token policies are blocking access.-- - **Verifying Token Works**:- - The app will show a green checkmark if the token is valid.- - Try accessing a repository to confirm permissions.- - Check the browser console for any error messages.-</Accordion>-</AccordionGroup>--#### GitLab Setup--OpenHands automatically exports a `GITLAB_TOKEN` to the shell environment if provided:--<AccordionGroup>-<Accordion title="Setting Up a GitLab Token">- 1. **Generate a Personal Access Token (PAT)**:- - On GitLab, go to User Settings > Access Tokens.- - Create a new token with the following scopes:- - `api` (API access)- - `read_user` (Read user information)- - `read_repository` (Read repository)- - `write_repository` (Write repository)- - Set an expiration date or leave it blank for a non-expiring token.- 2. **Enter Token in OpenHands**:- - In the Settings page, navigate to the `Integrations` tab.- - Paste your token in the `GitLab Token` field.- - Click `Save Changes` to apply the changes.-- 3. **(Optional): Restrict agent permissions**- - Create another PAT using Step 1 and exclude `api` scope .- - In the Settings page, in the `Secrets` tab, create a new secret `GITLAB_TOKEN` and paste your lower scope token.- - OpenHands will use the higher scope token, and the agent will use the lower scope token-</Accordion>--<Accordion title="Troubleshooting">- Common issues and solutions:-- - **Token Not Recognized**:- - Ensure the token is properly saved in settings.- - Check that the token hasn't expired.- - Verify the token has the required scopes.-- - **Access Denied**:- - Verify project access permissions.- - Check if the token has the necessary scopes.- - For group/organization repositories, ensure you have proper access.-</Accordion>-</AccordionGroup>--#### BitBucket Setup-<AccordionGroup>-<Accordion title="Setting Up a BitBucket Password">-1. **Generate an App Password**:- - On BitBucket, go to Personal Settings > App Password.- - Create a new password with the following scopes:- - `account`: `read`- - `repository: write`- - `pull requests: write`- - `issues: write`- - App passwords are non-expiring token. OpenHands will migrate to using API tokens in the future.- 2. **Enter Token in OpenHands**:- - In the Settings page, navigate to the `Integrations` tab.- - Paste your token in the `BitBucket Token` field.- - Click `Save Changes` to apply the changes.-</Accordion>--<Accordion title="Troubleshooting">- Common issues and solutions:-- - **Token Not Recognized**:- - Ensure the token is properly saved in settings.- - Check that the token hasn't expired.- - Verify the token has the required scopes.-- - **Verifying Token Works**:- - The app will show a green checkmark if the token is valid.- - Try accessing a repository to confirm permissions.- - Check the browser console for any error messages.-</Accordion>--</AccordionGroup>--#### Advanced Settings--The `Advanced` settings allows configuration of additional LLM settings. Inside the Settings page, under the `LLM` tab,-toggle `Advanced` options to access additional settings.--- Custom Model: Use the `Custom Model` text box to manually enter a model. Make sure to use the correct prefix based on litellm docs.-- Base URL: Specify a `Base URL` if required by your LLM provider.-- Memory Condensation: The memory condenser manages the LLM's context by ensuring only the most important and relevant information is presented.-- Confirmation Mode: Enabling this mode will cause OpenHands to confirm an action with the user before performing it.--### Key Features--For an overview of the key features available inside a conversation, please refer to the [Key Features](/usage/key-features)-section of the documentation.--### Status Indicator--The status indicator located in the bottom left of the screen will cycle through a number of states as a new conversation-is loaded. Typically these include:--* `Disconnected` : The frontend is not connected to any conversation.-* `Connecting` : The frontend is connecting a websocket to a conversation.-* `Building Runtime...` : The server is building a runtime. This is typically in development mode only while building a docker image.-* `Starting Runtime...` : The server is starting a new runtime instance - probably a new docker container or remote runtime.-* `Initializing Agent...` : The server is starting the agent loop (This step does not appear at present with Nested runtimes).-* `Setting up workspace...` : Usually this means a `git clone ...` operation.-* `Setting up git hooks` : Setting up the git pre commit hooks for the workspace.-* `Agent is awaiting user input...` : Ready to go!--## Tips for Effective Use--- Be specific in your requests to get the most accurate and helpful responses, as described in the [prompting best practices](../prompting/prompting-best-practices).-- Use one of the recommended models, as described in the [LLMs section](/usage/llms/llms).--## Other Ways to Run Openhands-- [Run OpenHands in a scriptable headless mode.](/usage/how-to/headless-mode)-- [Run OpenHands with a friendly CLI.](/usage/how-to/cli-mode)-- [Run OpenHands on GitHub issues with a GitHub action.](/usage/how-to/github-action)diff --git a/docs/usage/how-to/headless-mode.mdx b/docs/usage/how-to/headless-mode.mdxdeleted file mode 100644index 04ef87a914..0000000000--- a/docs/usage/how-to/headless-mode.mdx+++ /dev/null@@ -1,96 +0,0 @@-----title: Headless-description: You can run OpenHands with a single command, without starting the web application. This makes it easy to- write scripts and automate tasks with OpenHands.------This is different from [the CLI](./cli-mode), which is interactive, and better for active development.--## With Python--To run OpenHands in headless mode with Python:-1. Ensure you have followed the [Development setup instructions](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md).-2. Run the following command:-```bash-poetry run python -m openhands.core.main -t "write a bash script that prints hi"-```--You'll need to be sure to set your model, API key, and other settings via environment variables-[or the `config.toml` file](https://github.com/All-Hands-AI/OpenHands/blob/main/config.template.toml).--### Working with Repositories--You can specify a repository for OpenHands to work with using `--selected-repo` or the `SANDBOX_SELECTED_REPO` environment variable:--> **Note**: Currently, authentication tokens (GITHUB_TOKEN, GITLAB_TOKEN, or BITBUCKET_TOKEN) are required for all repository operations, including public repositories. This is a known limitation that may be addressed in future versions to allow tokenless access to public repositories.--```bash-# Using command-line argument-poetry run python -m openhands.core.main \- --selected-repo "owner/repo-name" \- -t "analyze the codebase and suggest improvements"--# Using environment variable-export SANDBOX_SELECTED_REPO="owner/repo-name"-poetry run python -m openhands.core.main -t "fix any linting issues"--# Authentication tokens are currently required for ALL repository operations (public and private)-# This includes GitHub, GitLab, and Bitbucket repositories-export GITHUB_TOKEN="your-token" # or GITLAB_TOKEN, BITBUCKET_TOKEN-poetry run python -m openhands.core.main \- --selected-repo "owner/repo-name" \- -t "review the security implementation"--# Using task files instead of inline task-echo "Review the README and suggest improvements" > task.txt-poetry run python -m openhands.core.main -f task.txt --selected-repo "owner/repo"-```--## With Docker--Set environment variables and run the Docker command:--```bash-# Set required environment variables-export SANDBOX_VOLUMES="/path/to/workspace:/workspace:rw" # Format: host_path:container_path:mode-export LLM_MODEL="anthropic/claude-sonnet-4-20250514" # or "anthropic/claude-sonnet-4-5-20250929"-export LLM_API_KEY="your-api-key"-export SANDBOX_SELECTED_REPO="owner/repo-name" # Optional: requires GITHUB_TOKEN-export GITHUB_TOKEN="your-token" # Required for repository operations--# Run OpenHands-docker run -it \- --pull=always \- -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.58-nikolaik \- -e SANDBOX_USER_ID=$(id -u) \- -e SANDBOX_VOLUMES=$SANDBOX_VOLUMES \- -e LLM_API_KEY=$LLM_API_KEY \- -e LLM_MODEL=$LLM_MODEL \- -e SANDBOX_SELECTED_REPO=$SANDBOX_SELECTED_REPO \- -e GITHUB_TOKEN=$GITHUB_TOKEN \- -e LOG_ALL_EVENTS=true \- -v /var/run/docker.sock:/var/run/docker.sock \- -v ~/.openhands:/.openhands \- --add-host host.docker.internal:host-gateway \- --name openhands-app-$(date +%Y%m%d%H%M%S) \- docker.all-hands.dev/all-hands-ai/openhands:0.58 \- python -m openhands.core.main -t "write a bash script that prints hi"-```--> **Note**: If you used OpenHands before version 0.44, run `mv ~/.openhands-state ~/.openhands` to migrate your conversation history.--The `-e SANDBOX_USER_ID=$(id -u)` is passed to the Docker command to ensure the sandbox user matches the host user’s-permissions. This prevents the agent from creating root-owned files in the mounted workspace.--## Additional Options--Common command-line options:-- `-d "/path/to/workspace"` - Set working directory-- `-f task.txt` - Load task from file-- `-i 50` - Set max iterations-- `-b 10.0` - Set budget limit (USD)-- `--no-auto-continue` - Interactive mode--Run `poetry run python -m openhands.core.main --help` for all options.--Set `export LOG_ALL_EVENTS=true` to log all agent actions.diff --git a/docs/usage/how-to/websocket-connection.mdx b/docs/usage/how-to/websocket-connection.mdxdeleted file mode 100644index 38c877e6b2..0000000000--- a/docs/usage/how-to/websocket-connection.mdx+++ /dev/null@@ -1,179 +0,0 @@-----title: WebSocket Connection------This guide explains how to connect to the OpenHands WebSocket API to receive real-time events and send actions to the agent.--## Overview--OpenHands uses [Socket.IO](https://socket.io/) for WebSocket communication between the client and server. The WebSocket connection allows you to:--1. Receive real-time events from the agent-2. Send user actions to the agent-3. Maintain a persistent connection for ongoing conversations--## Connecting to the WebSocket--### Connection Parameters--When connecting to the WebSocket, you need to provide the following query parameters:--- `conversation_id`: The ID of the conversation you want to join-- `latest_event_id`: The ID of the latest event you've received (use `-1` for a new connection)-- `providers_set`: (Optional) A comma-separated list of provider types--### Connection Example--Here's a basic example of connecting to the WebSocket using JavaScript:--```javascript-import { io } from "socket.io-client";--const socket = io("http://localhost:3000", {- transports: ["websocket"],- query: {- conversation_id: "your-conversation-id",- latest_event_id: -1,- providers_set: "github,gitlab" // Optional- }-});--socket.on("connect", () => {- console.log("Connected to OpenHands WebSocket");-});--socket.on("oh_event", (event) => {- console.log("Received event:", event);-});--socket.on("connect_error", (error) => {- console.error("Connection error:", error);-});--socket.on("disconnect", (reason) => {- console.log("Disconnected:", reason);-});-```--## Sending Actions to the Agent--To send an action to the agent, use the `oh_user_action` event:--```javascript-// Send a user message to the agent-socket.emit("oh_user_action", {- type: "message",- source: "user",- message: "Hello, can you help me with my project?"-});-```--## Receiving Events from the Agent--The server emits events using the `oh_event` event type. Here are some common event types you might receive:--- User messages (`source: "user", type: "message"`)-- Agent messages (`source: "agent", type: "message"`)-- File edits (`action: "edit"`)-- File writes (`action: "write"`)-- Command executions (`action: "run"`)--Example event handler:--```javascript-socket.on("oh_event", (event) => {- if (event.source === "agent" && event.type === "message") {- console.log("Agent says:", event.message);- } else if (event.action === "run") {- console.log("Command executed:", event.args.command);- console.log("Result:", event.result);- }-});-```--## Using Websocat for Testing--[Websocat](https://github.com/vi/websocat) is a command-line tool for interacting with WebSockets. It's useful for testing your WebSocket connection without writing a full client application.--### Installation--```bash-# On macOS-brew install websocat--# On Linux-curl -L https://github.com/vi/websocat/releases/download/v1.11.0/websocat.x86_64-unknown-linux-musl > websocat-chmod +x websocat-sudo mv websocat /usr/local/bin/-```--### Connecting to the WebSocket--```bash-# Connect to the WebSocket and print all received messages-echo "40{}" | \-websocat "ws://localhost:3000/socket.io/?EIO=4&transport=websocket&conversation_id=your-conversation-id&latest_event_id=-1"-```--### Sending a Message--```bash-# Send a message to the agent-echo '42["oh_user_action",{"type":"message","source":"user","message":"Hello, agent!"}]' | \-websocat "ws://localhost:3000/socket.io/?EIO=4&transport=websocket&conversation_id=your-conversation-id&latest_event_id=-1"-```--### Complete Example with Websocat--Here's a complete example of connecting to the WebSocket, sending a message, and receiving events:--```bash-# Start a persistent connection-websocat -v "ws://localhost:3000/socket.io/?EIO=4&transport=websocket&conversation_id=your-conversation-id&latest_event_id=-1"--# In another terminal, send a message-echo '42["oh_user_action",{"type":"message","source":"user","message":"Can you help me with my project?"}]' | \-websocat "ws://localhost:3000/socket.io/?EIO=4&transport=websocket&conversation_id=your-conversation-id&latest_event_id=-1"-```--## Event Structure--Events sent and received through the WebSocket follow a specific structure:--```typescript-interface OpenHandsEvent {- id: string; // Unique event ID- source: string; // "user" or "agent"- timestamp: string; // ISO timestamp- message?: string; // For message events- type?: string; // Event type (e.g., "message")- action?: string; // Action type (e.g., "run", "edit", "write")- args?: any; // Action arguments- result?: any; // Action result-}-```--## Best Practices--1. **Handle Reconnection**: Implement reconnection logic in your client to handle network interruptions.-2. **Track Event IDs**: Store the latest event ID you've received and use it when reconnecting to avoid duplicate events.-3. **Error Handling**: Implement proper error handling for connection errors and failed actions.-4. **Rate Limiting**: Avoid sending too many actions in a short period to prevent overloading the server.--## Troubleshooting--### Connection Issues--- Verify that the OpenHands server is running and accessible-- Check that you're providing the correct conversation ID-- Ensure your WebSocket URL is correctly formatted--### Authentication Issues--- Make sure you have the necessary authentication cookies if required-- Verify that you have permission to access the specified conversation--### Event Handling Issues--- Check that you're correctly parsing the event data-- Verify that your event handlers are properly registereddiff --git a/docs/usage/installation.mdx b/docs/usage/installation.mdxdeleted file mode 100644index 3f755f6f13..0000000000--- a/docs/usage/installation.mdx+++ /dev/null@@ -1,20 +0,0 @@-----title: Quick Start-description: Running OpenHands Cloud or running on your own.-icon: rocket------<Tabs>- <Tab title="OpenHands Cloud">- The easiest way to get started with OpenHands is on OpenHands Cloud, which comes with $20 in free credits for new users.-- To get started with OpenHands Cloud, visit [app.all-hands.dev](https://app.all-hands.dev).-- For more information see [getting started with OpenHands Cloud.](/usage/cloud/openhands-cloud)- </Tab>- <Tab title="Running OpenHands on Your Own">- Run OpenHands on your local system and bring your own LLM and API key.-- For more information see [running OpenHands on your own.](/usage/local-setup)- </Tab>-</Tabs>diff --git a/docs/usage/key-features.mdx b/docs/usage/key-features.mdxdeleted file mode 100644index 488a3930c0..0000000000--- a/docs/usage/key-features.mdx+++ /dev/null@@ -1,32 +0,0 @@-----title: Key Features-icon: bars--------### Chat Panel-- Displays the conversation between the user and OpenHands.-- OpenHands explains its actions in this panel.--### Changes-- Shows the file changes performed by OpenHands.--### VS Code-- Embedded VS Code for browsing and modifying files.-- Can also be used to upload and download files.--### Terminal-- A space for OpenHands and users to run terminal commands.--### Jupyter-- Shows all Python commands that were executed by OpenHands.-- Particularly handy when using OpenHands to perform data visualization tasks.--### App-- Displays the web server when OpenHands runs an application.-- Users can interact with the running application.--### Browser-- Used by OpenHands to browse websites.-- The browser is non-interactive.diff --git a/docs/usage/llms/azure-llms.mdx b/docs/usage/llms/azure-llms.mdxdeleted file mode 100644index d1dbb31041..0000000000--- a/docs/usage/llms/azure-llms.mdx+++ /dev/null@@ -1,42 +0,0 @@-----title: Azure-description: OpenHands uses LiteLLM to make calls to Azure's chat models. You can find their documentation on using Azure as a provider [here](https://docs.litellm.ai/docs/providers/azure).------## Azure OpenAI Configuration--When running OpenHands, you'll need to set the following environment variable using `-e` in the-[docker run command](../installation#running-openhands):--```-LLM_API_VERSION="<api-version>" # e.g. "2023-05-15"-```--Example:-```bash-docker run -it --pull=always \- -e LLM_API_VERSION="2023-05-15"- ...-```--Then in the OpenHands UI Settings under the `LLM` tab:--<Note>-You will need your ChatGPT deployment name which can be found on the deployments page in Azure. This is referenced as-<deployment-name> below.-</Note>--1. Enable `Advanced` options.-2. Set the following:- - `Custom Model` to azure/<deployment-name>- - `Base URL` to your Azure API Base URL (e.g. `https://example-endpoint.openai.azure.com`)- - `API Key` to your Azure API key--### Azure OpenAI Configuration--When running OpenHands, set the following environment variable using `-e` in the-[docker run command](../installation#running-openhands):--```-LLM_API_VERSION="<api-version>" # e.g. "2024-02-15-preview"-```diff --git a/docs/usage/llms/custom-llm-configs.mdx b/docs/usage/llms/custom-llm-configs.mdxdeleted file mode 100644index 2a7af46817..0000000000--- a/docs/usage/llms/custom-llm-configs.mdx+++ /dev/null@@ -1,137 +0,0 @@-----title: Custom LLM Configurations-description: OpenHands supports defining multiple named LLM configurations in your `config.toml` file. This feature allows you to use different LLM configurations for different purposes, such as using a cheaper model for tasks that don't require high-quality responses, or using different models with different parameters for specific agents.------## How It Works--Named LLM configurations are defined in the `config.toml` file using sections that start with `llm.`. For example:--```toml-# Default LLM configuration-[llm]-model = "gpt-4"-api_key = "your-api-key"-temperature = 0.0--# Custom LLM configuration for a cheaper model-[llm.gpt3]-model = "gpt-3.5-turbo"-api_key = "your-api-key"-temperature = 0.2--# Another custom configuration with different parameters-[llm.high-creativity]-model = "gpt-4"-api_key = "your-api-key"-temperature = 0.8-top_p = 0.9-```--Each named configuration inherits all settings from the default `[llm]` section and can override any of those settings. You can define as many custom configurations as needed.--## Using Custom Configurations--### With Agents--You can specify which LLM configuration an agent should use by setting the `llm_config` parameter in the agent's configuration section:--```toml-[agent.RepoExplorerAgent]-# Use the cheaper GPT-3 configuration for this agent-llm_config = 'gpt3'--[agent.CodeWriterAgent]-# Use the high creativity configuration for this agent-llm_config = 'high-creativity'-```--### Configuration Options--Each named LLM configuration supports all the same options as the default LLM configuration. These include:--- Model selection (`model`)-- API configuration (`api_key`, `base_url`, etc.)-- Model parameters (`temperature`, `top_p`, etc.)-- Retry settings (`num_retries`, `retry_multiplier`, etc.)-- Token limits (`max_input_tokens`, `max_output_tokens`)-- And all other LLM configuration options--For a complete list of available options, see the LLM Configuration section in the [Configuration Options](../configuration-options) documentation.--## Use Cases--Custom LLM configurations are particularly useful in several scenarios:--- **Cost Optimization**: Use cheaper models for tasks that don't require high-quality responses, like repository exploration or simple file operations.-- **Task-Specific Tuning**: Configure different temperature and top_p values for tasks that require different levels of creativity or determinism.-- **Different Providers**: Use different LLM providers or API endpoints for different tasks.-- **Testing and Development**: Easily switch between different model configurations during development and testing.--## Example: Cost Optimization--A practical example of using custom LLM configurations to optimize costs:--```toml-# Default configuration using GPT-4 for high-quality responses-[llm]-model = "gpt-4"-api_key = "your-api-key"-temperature = 0.0--# Cheaper configuration for repository exploration-[llm.repo-explorer]-model = "gpt-3.5-turbo"-temperature = 0.2--# Configuration for code generation-[llm.code-gen]-model = "gpt-4"-temperature = 0.0-max_output_tokens = 2000--[agent.RepoExplorerAgent]-llm_config = 'repo-explorer'--[agent.CodeWriterAgent]-llm_config = 'code-gen'-```--In this example:-- Repository exploration uses a cheaper model since it mainly involves understanding and navigating code-- Code generation uses GPT-4 with a higher token limit for generating larger code blocks-- The default configuration remains available for other tasks--# Custom Configurations with Reserved Names--OpenHands can use custom LLM configurations named with reserved names, for specific use cases. If you specify the model and other settings under the reserved names, then OpenHands will load and them for a specific purpose. As of now, one such configuration is implemented: draft editor.--## Draft Editor Configuration--The `draft_editor` configuration is a group of settings you can provide, to specify the model to use for preliminary drafting of code edits, for any tasks that involve editing and refining code. You need to provide it under the section `[llm.draft_editor]`.--For example, you can define in `config.toml` a draft editor like this:--```toml-[llm.draft_editor]-model = "gpt-4"-temperature = 0.2-top_p = 0.95-presence_penalty = 0.0-frequency_penalty = 0.0-```--This configuration:-- Uses GPT-4 for high-quality edits and suggestions-- Sets a low temperature (0.2) to maintain consistency while allowing some flexibility-- Uses a high top_p value (0.95) to consider a wide range of token options-- Disables presence and frequency penalties to maintain focus on the specific edits needed--Use this configuration when you want to let an LLM draft edits before making them. In general, it may be useful to:-- Review and suggest code improvements-- Refine existing content while maintaining its core meaning-- Make precise, focused changes to code or text--<Note>-Custom LLM configurations are only available when using OpenHands in development mode, via `main.py` or `cli.py`. When running via `docker run`, please use the standard configuration options.-</Note>diff --git a/docs/usage/llms/google-llms.mdx b/docs/usage/llms/google-llms.mdxdeleted file mode 100644index d71c3151d6..0000000000--- a/docs/usage/llms/google-llms.mdx+++ /dev/null@@ -1,30 +0,0 @@-----title: Google Gemini/Vertex-description: OpenHands uses LiteLLM to make calls to Google's chat models. You can find their documentation on using Google as a provider -> [Gemini - Google AI Studio](https://docs.litellm.ai/docs/providers/gemini), [VertexAI - Google Cloud Platform](https://docs.litellm.ai/docs/providers/vertex)------## Gemini - Google AI Studio Configs--When running OpenHands, you'll need to set the following in the OpenHands UI through the Settings under the `LLM` tab:-- `LLM Provider` to `Gemini`-- `LLM Model` to the model you will be using.-If the model is not in the list, enable `Advanced` options, and enter it in `Custom Model`-(e.g. gemini/<model-name> like `gemini/gemini-2.0-flash`).-- `API Key` to your Gemini API key--## VertexAI - Google Cloud Platform Configs--To use Vertex AI through Google Cloud Platform when running OpenHands, you'll need to set the following environment-variables using `-e` in the [docker run command](../installation#running-openhands):--```-GOOGLE_APPLICATION_CREDENTIALS="<json-dump-of-gcp-service-account-json>"-VERTEXAI_PROJECT="<your-gcp-project-id>"-VERTEXAI_LOCATION="<your-gcp-location>"-```--Then set the following in the OpenHands UI through the Settings under the `LLM` tab:-- `LLM Provider` to `VertexAI`-- `LLM Model` to the model you will be using.-If the model is not in the list, enable `Advanced` options, and enter it in `Custom Model`-(e.g. vertex_ai/<model-name>).diff --git a/docs/usage/llms/groq.mdx b/docs/usage/llms/groq.mdxdeleted file mode 100644index 3b571a24f6..0000000000--- a/docs/usage/llms/groq.mdx+++ /dev/null@@ -1,23 +0,0 @@-----title: Groq-description: OpenHands uses LiteLLM to make calls to chat models on Groq. You can find their documentation on using Groq as a provider [here](https://docs.litellm.ai/docs/providers/groq).------## Configuration--When running OpenHands, you'll need to set the following in the OpenHands UI through the Settings under the `LLM` tab:-- `LLM Provider` to `Groq`-- `LLM Model` to the model you will be using. [Visit here to see the list of-models that Groq hosts](https://console.groq.com/docs/models). If the model is not in the list,-enable `Advanced` options, and enter it in `Custom Model` (e.g. groq/<model-name> like `groq/llama3-70b-8192`).-- `API key` to your Groq API key. To find or create your Groq API Key, [see here](https://console.groq.com/keys).--## Using Groq as an OpenAI-Compatible Endpoint--The Groq endpoint for chat completion is [mostly OpenAI-compatible](https://console.groq.com/docs/openai). Therefore, you can access Groq models as you-would access any OpenAI-compatible endpoint. In the OpenHands UI through the Settings under the `LLM` tab:-1. Enable `Advanced` options-2. Set the following:- - `Custom Model` to the prefix `openai/` + the model you will be using (e.g. `openai/llama3-70b-8192`)- - `Base URL` to `https://api.groq.com/openai/v1`- - `API Key` to your Groq API keydiff --git a/docs/usage/llms/litellm-proxy.mdx b/docs/usage/llms/litellm-proxy.mdxdeleted file mode 100644index 89bb46ac77..0000000000--- a/docs/usage/llms/litellm-proxy.mdx+++ /dev/null@@ -1,22 +0,0 @@-----title: LiteLLM Proxy-description: OpenHands supports using the [LiteLLM proxy](https://docs.litellm.ai/docs/proxy/quick_start) to access various LLM providers.------## Configuration--To use LiteLLM proxy with OpenHands, you need to:--1. Set up a LiteLLM proxy server (see [LiteLLM documentation](https://docs.litellm.ai/docs/proxy/quick_start))-2. When running OpenHands, you'll need to set the following in the OpenHands UI through the Settings under the `LLM` tab:- * Enable `Advanced` options- * `Custom Model` to the prefix `litellm_proxy/` + the model you will be using (e.g. `litellm_proxy/anthropic.claude-3-5-sonnet-20241022-v2:0`)- * `Base URL` to your LiteLLM proxy URL (e.g. `https://your-litellm-proxy.com`)- * `API Key` to your LiteLLM proxy API key--## Supported Models--The supported models depend on your LiteLLM proxy configuration. OpenHands supports any model that your LiteLLM proxy-is configured to handle.--Refer to your LiteLLM proxy configuration for the list of available models and their names.diff --git a/docs/usage/llms/llms.mdx b/docs/usage/llms/llms.mdxdeleted file mode 100644index 19357a65de..0000000000--- a/docs/usage/llms/llms.mdx+++ /dev/null@@ -1,118 +0,0 @@-----title: Overview-description: OpenHands can connect to any LLM supported by LiteLLM. However, it requires a powerful model to work.------<Note>-This section is for users who want to connect OpenHands to different LLMs.-</Note>--## Model Recommendations--Based on our evaluations of language models for coding tasks (using the SWE-bench dataset), we can provide some-recommendations for model selection. Our latest benchmarking results can be found in-[this spreadsheet](https://docs.google.com/spreadsheets/d/1wOUdFCMyY6Nt0AIqF705KN4JKOWgeI4wUGUP60krXXs/edit?gid=0).--Based on these findings and community feedback, these are the latest models that have been verified to work reasonably well with OpenHands:--### Cloud / API-Based Models--- [anthropic/claude-sonnet-4-20250514](https://www.anthropic.com/api) (recommended)-- [anthropic/claude-sonnet-4-5-20250929](https://www.anthropic.com/api) (recommended)-- [openai/gpt-5-2025-08-07](https://openai.com/api/) (recommended)-- [gemini/gemini-2.5-pro](https://blog.google/technology/google-deepmind/gemini-model-thinking-updates-march-2025/)-- [deepseek/deepseek-chat](https://api-docs.deepseek.com/)-- [moonshot/kimi-k2-0711-preview](https://platform.moonshot.ai/docs/pricing/chat#generation-model-kimi-k2)--If you have successfully run OpenHands with specific providers, we encourage you to open a PR to share your setup process-to help others using the same provider!--For a full list of the providers and models available, please consult the-[litellm documentation](https://docs.litellm.ai/docs/providers).--<Warning>-OpenHands will issue many prompts to the LLM you configure. Most of these LLMs cost money, so be sure to set spending-limits and monitor usage.-</Warning>--### Local / Self-Hosted Models--- [mistralai/devstral-small](https://www.all-hands.dev/blog/devstral-a-new-state-of-the-art-open-model-for-coding-agents) (20 May 2025) -- also available through [OpenRouter](https://openrouter.ai/mistralai/devstral-small:free)-- [all-hands/openhands-lm-32b-v0.1](https://www.all-hands.dev/blog/introducing-openhands-lm-32b----a-strong-open-coding-agent-model) (31 March 2025) -- also available through [OpenRouter](https://openrouter.ai/all-hands/openhands-lm-32b-v0.1)--### Known Issues--<Warning>-As of July 2025, there are known issues with Gemini 2.5 Pro conversations taking longer than normal with OpenHands. We are continuing to investigate.-</Warning>--<Note>-Most current local and open source models are not as powerful. When using such models, you may see long-wait times between messages, poor responses, or errors about malformed JSON. OpenHands can only be as powerful as the-models driving it. However, if you do find ones that work, please add them to the verified list above.-</Note>--## LLM Configuration--The following can be set in the OpenHands UI through the Settings:--- `LLM Provider`-- `LLM Model`-- `API Key`-- `Base URL` (through `Advanced` settings)--There are some settings that may be necessary for some LLMs/providers that cannot be set through the UI. Instead, these-can be set through environment variables passed to the docker run command when starting the app-using `-e`:--- `LLM_API_VERSION`-- `LLM_EMBEDDING_MODEL`-- `LLM_EMBEDDING_DEPLOYMENT_NAME`-- `LLM_DROP_PARAMS`-- `LLM_DISABLE_VISION`-- `LLM_CACHING_PROMPT`--We have a few guides for running OpenHands with specific model providers:--- [Azure](/usage/llms/azure-llms)-- [Google](/usage/llms/google-llms)-- [Groq](/usage/llms/groq)-- [Local LLMs with SGLang or vLLM](/usage/llms/local-llms)-- [LiteLLM Proxy](/usage/llms/litellm-proxy)-- [Moonshot AI](/usage/llms/moonshot)-- [OpenAI](/usage/llms/openai-llms)-- [OpenHands](/usage/llms/openhands-llms)-- [OpenRouter](/usage/llms/openrouter)--## Model Customization--LLM providers have specific settings that can be customized to optimize their performance with OpenHands, such as:--- **Custom Tokenizers**: For specialized models, you can add a suitable tokenizer.-- **Native Tool Calling**: Toggle native function/tool calling capabilities.--For detailed information about model customization, see-[LLM Configuration Options](/usage/configuration-options#llm-configuration).--### API retries and rate limits--LLM providers typically have rate limits, sometimes very low, and may require retries. OpenHands will automatically-retry requests if it receives a Rate Limit Error (429 error code).--You can customize these options as you need for the provider you're using. Check their documentation, and set the-following environment variables to control the number of retries and the time between retries:--- `LLM_NUM_RETRIES` (Default of 4 times)-- `LLM_RETRY_MIN_WAIT` (Default of 5 seconds)-- `LLM_RETRY_MAX_WAIT` (Default of 30 seconds)-- `LLM_RETRY_MULTIPLIER` (Default of 2)--If you are running OpenHands in development mode, you can also set these options in the `config.toml` file:--```toml-[llm]-num_retries = 4-retry_min_wait = 5-retry_max_wait = 30-retry_multiplier = 2-```diff --git a/docs/usage/llms/local-llms.mdx b/docs/usage/llms/local-llms.mdxdeleted file mode 100644index 97a5cc2e17..0000000000--- a/docs/usage/llms/local-llms.mdx+++ /dev/null@@ -1,224 +0,0 @@-----title: Local LLMs-description: When using a Local LLM, OpenHands may have limited functionality. It is highly recommended that you use GPUs to serve local models for optimal experience.------## News--- 2025/05/21: We collaborated with Mistral AI and released [Devstral Small](https://mistral.ai/news/devstral) that achieves [46.8% on SWE-Bench Verified](https://github.com/SWE-bench/experiments/pull/228)!-- 2025/03/31: We released an open model OpenHands LM 32B v0.1 that achieves 37.1% on SWE-Bench Verified-([blog](https://www.all-hands.dev/blog/introducing-openhands-lm-32b----a-strong-open-coding-agent-model), [model](https://huggingface.co/all-hands/openhands-lm-32b-v0.1)).--## Quickstart: Running OpenHands with a Local LLM using LM Studio--This guide explains how to serve a local Devstral LLM using [LM Studio](https://lmstudio.ai/) and have OpenHands connect to it.--We recommend:-- **LM Studio** as the local model server, which handles metadata downloads automatically and offers a simple, user-friendly interface for configuration.-- **Devstral Small 2505** as the LLM for software development, trained on real GitHub issues and optimized for agent-style workflows like OpenHands.--### Hardware Requirements--Running Devstral requires a recent GPU with at least 16GB of VRAM, or a Mac with Apple Silicon (M1, M2, etc.) with at least 32GB of RAM.--### 1. Install LM Studio--Download and install the LM Studio desktop app from [lmstudio.ai](https://lmstudio.ai/).--### 2. Download Devstral Small--1. Make sure to set the User Interface Complexity Level to "Power User", by clicking on the appropriate label at the bottom of the window.-2. Click the "Discover" button (Magnifying Glass icon) on the left navigation bar to open the Models download page.----3. Search for the "Devstral Small 2505" model, confirm it's the official Mistral AI (mistralai) model, then proceed to download.----4. Wait for the download to finish.--### 3. Load the Model--1. Click the "Developer" button (Console icon) on the left navigation bar to open the Developer Console.-2. Click the "Select a model to load" dropdown at the top of the application window.----3. Enable the "Manually choose model load parameters" switch.-4. Select 'Devstral Small 2505' from the model list.----5. Enable the "Show advanced settings" switch at the bottom of the Model settings flyout to show all the available settings.-6. Set "Context Length" to at least 32768 and enable Flash Attention.-7. Click "Load Model" to start loading the model.----### 4. Start the LLM server--1. Enable the switch next to "Status" at the top-left of the Window.-2. Take note of the Model API Identifier shown on the sidebar on the right.----### 5. Start OpenHands--1. Check [the installation guide](/usage/local-setup) and ensure all prerequisites are met before running OpenHands, then run:--```bash-docker pull docker.all-hands.dev/all-hands-ai/runtime:0.58-nikolaik--docker run -it --rm --pull=always \- -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.58-nikolaik \- -e LOG_ALL_EVENTS=true \- -v /var/run/docker.sock:/var/run/docker.sock \- -v ~/.openhands:/.openhands \- -p 3000:3000 \- --add-host host.docker.internal:host-gateway \- --name openhands-app \- docker.all-hands.dev/all-hands-ai/openhands:0.58-```--2. Wait until the server is running (see log below):-```-Digest: sha256:e72f9baecb458aedb9afc2cd5bc935118d1868719e55d50da73190d3a85c674f-Status: Image is up to date for docker.all-hands.dev/all-hands-ai/openhands:0.58-Starting OpenHands...-Running OpenHands as root-14:22:13 - openhands:INFO: server_config.py:50 - Using config class None-INFO: Started server process [8]-INFO: Waiting for application startup.-INFO: Application startup complete.-INFO: Uvicorn running on http://0.0.0.0:3000 (Press CTRL+C to quit)-```--3. Visit `http://localhost:3000` in your browser.--### 6. Configure OpenHands to use the LLM server--Once you open OpenHands in your browser, you'll need to configure it to use the local LLM server you just started.--When started for the first time, OpenHands will prompt you to set up the LLM provider.--1. Click "see advanced settings" to open the LLM Settings page.----2. Enable the "Advanced" switch at the top of the page to show all the available settings.--3. Set the following values:- - **Custom Model**: `openai/mistralai/devstral-small-2505` (the Model API identifier from LM Studio, prefixed with "openai/")- - **Base URL**: `http://host.docker.internal:1234/v1`- - **API Key**: `local-llm`--4. Click "Save Settings" to save the configuration.----That's it! You can now start using OpenHands with the local LLM server.--If you encounter any issues, let us know on [Slack](https://dub.sh/openhands).--## Advanced: Alternative LLM Backends--This section describes how to run local LLMs with OpenHands using alternative backends like Ollama, SGLang, or vLLM — without relying on LM Studio.--### Create an OpenAI-Compatible Endpoint with Ollama--- Install Ollama following [the official documentation](https://ollama.com/download).-- Example launch command for Devstral Small 2505:--```bash-# ⚠️ WARNING: OpenHands requires a large context size to work properly.-# When using Ollama, set OLLAMA_CONTEXT_LENGTH to at least 32768.-# The default (4096) is way too small — not even the system prompt will fit, and the agent will not behave correctly.-OLLAMA_CONTEXT_LENGTH=32768 OLLAMA_HOST=0.0.0.0:11434 OLLAMA_KEEP_ALIVE=-1 nohup ollama serve &-ollama pull devstral:latest-```--### Create an OpenAI-Compatible Endpoint with vLLM or SGLang--First, download the model checkpoints. For [Devstral Small 2505](https://huggingface.co/mistralai/Devstral-Small-2505):--```bash-huggingface-cli download mistralai/Devstral-Small-2505 --local-dir mistralai/Devstral-Small-2505-```--#### Serving the model using SGLang--- Install SGLang following [the official documentation](https://docs.sglang.ai/start/install.html).-- Example launch command for Devstral Small 2505 (with at least 2 GPUs):--```bash-SGLANG_ALLOW_OVERWRITE_LONGER_CONTEXT_LEN=1 python3 -m sglang.launch_server \- --model mistralai/Devstral-Small-2505 \- --served-model-name Devstral-Small-2505 \- --port 8000 \- --tp 2 --dp 1 \- --host 0.0.0.0 \- --api-key mykey --context-length 131072-```--#### Serving the model using vLLM--- Install vLLM following [the official documentation](https://docs.vllm.ai/en/latest/getting_started/installation.html).-- Example launch command for Devstral Small 2505 (with at least 2 GPUs):--```bash-vllm serve mistralai/Devstral-Small-2505 \- --host 0.0.0.0 --port 8000 \- --api-key mykey \- --tensor-parallel-size 2 \- --served-model-name Devstral-Small-2505 \- --enable-prefix-caching-```--If you are interested in further improved inference speed, you can also try Snowflake's version-of vLLM, [ArcticInference](https://www.snowflake.com/en/engineering-blog/fast-speculative-decoding-vllm-arctic/),-which can achieve up to 2x speedup in some cases.--1. Install the Arctic Inference library that automatically patches vLLM:--```bash-pip install git+https://github.com/snowflakedb/ArcticInference.git-```--2. Run the launch command with speculative decoding enabled:--```bash-vllm serve mistralai/Devstral-Small-2505 \- --host 0.0.0.0 --port 8000 \- --api-key mykey \- --tensor-parallel-size 2 \- --served-model-name Devstral-Small-2505 \- --speculative-config '{"method": "suffix"}'-```--### Run OpenHands (Alternative Backends)--#### Using Docker--Run OpenHands using [the official docker run command](../installation#start-the-app).--#### Using Development Mode--Use the instructions in [Development.md](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md) to build OpenHands.--Start OpenHands using `make run`.--### Configure OpenHands (Alternative Backends)--Once OpenHands is running, open the Settings page in the UI and go to the `LLM` tab.--1. Click **"see advanced settings"** to access the full configuration panel.-2. Enable the **Advanced** toggle at the top of the page.-3. Set the following parameters, if you followed the examples above:- - **Custom Model**: `openai/<served-model-name>`- e.g. `openai/devstral` if you're using Ollama, or `openai/Devstral-Small-2505` for SGLang or vLLM.- - **Base URL**: `http://host.docker.internal:<port>/v1`- Use port `11434` for Ollama, or `8000` for SGLang and vLLM.- - **API Key**:- - For **Ollama**: any placeholder value (e.g. `dummy`, `local-llm`)- - For **SGLang** or **vLLM**: use the same key provided when starting the server (e.g. `mykey`)diff --git a/docs/usage/llms/moonshot.mdx b/docs/usage/llms/moonshot.mdxdeleted file mode 100644index f03ec9457c..0000000000--- a/docs/usage/llms/moonshot.mdx+++ /dev/null@@ -1,25 +0,0 @@-----title: Moonshot AI-description: How to use Moonshot AI models with OpenHands------## Using Moonshot AI with OpenHands--[Moonshot AI](https://platform.moonshot.ai/) offers several powerful models, including Kimi-K2, which has been verified to work well with OpenHands.--### Setup--1. Sign up for an account at [Moonshot AI Platform](https://platform.moonshot.ai/)-2. Generate an API key from your account settings-3. Configure OpenHands to use Moonshot AI:--| Setting | Value |-| --- | --- |-| LLM Provider | `moonshot` |-| LLM Model | `kimi-k2-0711-preview` |-| API Key | Your Moonshot API key |--### Recommended Models--- `moonshot/kimi-k2-0711-preview` - Kimi-K2 is Moonshot's most powerful model with a 131K context window, function calling support, and web search capabilities.-diff --git a/docs/usage/llms/openai-llms.mdx b/docs/usage/llms/openai-llms.mdxdeleted file mode 100644index d97a573f2d..0000000000--- a/docs/usage/llms/openai-llms.mdx+++ /dev/null@@ -1,26 +0,0 @@-----title: OpenAI-description: OpenHands uses LiteLLM to make calls to OpenAI's chat models. You can find their documentation on using OpenAI as a provider [here](https://docs.litellm.ai/docs/providers/openai).------## Configuration--When running OpenHands, you'll need to set the following in the OpenHands UI through the Settings under the `LLM` tab:-* `LLM Provider` to `OpenAI`-* `LLM Model` to the model you will be using.-[Visit here to see a full list of OpenAI models that LiteLLM supports.](https://docs.litellm.ai/docs/providers/openai#openai-chat-completion-models)-If the model is not in the list, enable `Advanced` options, and enter it in `Custom Model` (e.g. openai/<model-name> like `openai/gpt-4o`).-* `API Key` to your OpenAI API key. To find or create your OpenAI Project API Key, [see here](https://platform.openai.com/api-keys).--## Using OpenAI-Compatible Endpoints--Just as for OpenAI Chat completions, we use LiteLLM for OpenAI-compatible endpoints. You can find their full documentation on this topic [here](https://docs.litellm.ai/docs/providers/openai_compatible).--## Using an OpenAI Proxy--If you're using an OpenAI proxy, in the OpenHands UI through the Settings under the `LLM` tab:-1. Enable `Advanced` options-2. Set the following:- - `Custom Model` to openai/<model-name> (e.g. `openai/gpt-4o` or openai/<proxy-prefix>/<model-name>)- - `Base URL` to the URL of your OpenAI proxy- - `API Key` to your OpenAI API keydiff --git a/docs/usage/llms/openhands-llms.mdx b/docs/usage/llms/openhands-llms.mdxdeleted file mode 100644index ce151374b2..0000000000--- a/docs/usage/llms/openhands-llms.mdx+++ /dev/null@@ -1,50 +0,0 @@-----title: OpenHands-description: OpenHands LLM provider with access to state-of-the-art (SOTA) agentic coding models.------## Obtain Your OpenHands LLM API Key--1. [Log in to OpenHands Cloud](/usage/cloud/openhands-cloud).-2. Go to the Settings page and navigate to the `API Keys` tab.-3. Copy your `LLM API Key`.----## Configuration--When running OpenHands, you'll need to set the following in the OpenHands UI through the Settings under the `LLM` tab:-- `LLM Provider` to `OpenHands`-- `LLM Model` to the model you will be using (e.g. claude-sonnet-4-20250514 or claude-sonnet-4-5-20250929)-- `API Key` to your OpenHands LLM API key copied from above--## Using OpenHands LLM Provider in the CLI--1. [Run OpenHands CLI](/usage/how-to/cli-mode).-2. To select OpenHands as the LLM provider:- - If this is your first time running the CLI, choose `openhands` and then select the model that you would like to use.- - If you have previously run the CLI, run the `/settings` command and select to modify the `Basic` settings. Then- choose `openhands` and finally the model.----## Pricing--Pricing follows official API provider rates. Below are the current pricing details for OpenHands models:--| Model | Input Cost (per 1M tokens) | Cached Input Cost (per 1M tokens) | Output Cost (per 1M tokens) | Max Input Tokens | Max Output Tokens |-|-------|----------------------------|-----------------------------------|------------------------------|------------------|-------------------|-| claude-opus-4-20250514 | $15.00 | $1.50 | $75.00 | 200,000 | 32,000 |-| claude-sonnet-4-20250514 | $3.00 | $0.30 | $15.00 | 200,000 | 64,000 |-| claude-sonnet-4-5-20250929 | $3.00 | $0.30 | $15.00 | 200,000 | 64,000 |-| devstral-medium-2507 | $0.40 | N/A | $2.00 | 128,000 | 128,000 |-| devstral-small-2505 | $0.10 | N/A | $0.30 | 128,000 | 128,000 |-| devstral-small-2507 | $0.10 | N/A | $0.30 | 128,000 | 128,000 |-| gemini-2.5-pro | $1.25 | $0.31 | $10.00 | 1,048,576 | 65,535 |-| gpt-5-2025-08-07 | $1.25 | $0.125 | $10.00 | 400,000 | 128,000 |-| gpt-5-mini-2025-08-07 | $0.25 | $0.025 | $2.00 | 400,000 | 128,000 |-| o3 | $2.00 | $0.50 | $8.00 | 200,000 | 100,000 |-| o4-mini | $1.10 | $0.28 | $4.40 | 200,000 | 100,000 |-| qwen3-coder-480b | $0.40 | N/A | $1.60 | N/A | N/A |--**Note:** Cached input tokens are charged at a reduced rate when the same content is reused across requests. Models that don't support prompt caching show "N/A" for cached input cost.diff --git a/docs/usage/llms/openrouter.mdx b/docs/usage/llms/openrouter.mdxdeleted file mode 100644index 2b5f2fa87f..0000000000--- a/docs/usage/llms/openrouter.mdx+++ /dev/null@@ -1,14 +0,0 @@-----title: OpenRouter-description: OpenHands uses LiteLLM to make calls to chat models on OpenRouter. You can find their documentation on using OpenRouter as a provider [here](https://docs.litellm.ai/docs/providers/openrouter).------## Configuration--When running OpenHands, you'll need to set the following in the OpenHands UI through the Settings under the `LLM` tab:-* `LLM Provider` to `OpenRouter`-* `LLM Model` to the model you will be using.-[Visit here to see a full list of OpenRouter models](https://openrouter.ai/models).-If the model is not in the list, enable `Advanced` options, and enter it in-`Custom Model` (e.g. openrouter/<model-name> like `openrouter/anthropic/claude-3.5-sonnet`).-* `API Key` to your OpenRouter API key.diff --git a/docs/usage/llms/screenshots/01_lm_studio_open_model_hub.png b/docs/usage/llms/screenshots/01_lm_studio_open_model_hub.pngdeleted file mode 100644index f67afe5669..0000000000Binary files a/docs/usage/llms/screenshots/01_lm_studio_open_model_hub.png and /dev/null differdiff --git a/docs/usage/llms/screenshots/02_lm_studio_download_devstral.png b/docs/usage/llms/screenshots/02_lm_studio_download_devstral.pngdeleted file mode 100644index 0fb1dfbb15..0000000000Binary files a/docs/usage/llms/screenshots/02_lm_studio_download_devstral.png and /dev/null differdiff --git a/docs/usage/llms/screenshots/03_lm_studio_open_load_model.png b/docs/usage/llms/screenshots/03_lm_studio_open_load_model.pngdeleted file mode 100644index ba97fbef93..0000000000Binary files a/docs/usage/llms/screenshots/03_lm_studio_open_load_model.png and /dev/null differdiff --git a/docs/usage/llms/screenshots/04_lm_studio_setup_devstral_part_1.png b/docs/usage/llms/screenshots/04_lm_studio_setup_devstral_part_1.pngdeleted file mode 100644index 5368bb4bab..0000000000Binary files a/docs/usage/llms/screenshots/04_lm_studio_setup_devstral_part_1.png and /dev/null differdiff --git a/docs/usage/llms/screenshots/05_lm_studio_setup_devstral_part_2.png b/docs/usage/llms/screenshots/05_lm_studio_setup_devstral_part_2.pngdeleted file mode 100644index dfac2d83ad..0000000000Binary files a/docs/usage/llms/screenshots/05_lm_studio_setup_devstral_part_2.png and /dev/null differdiff --git a/docs/usage/llms/screenshots/06_lm_studio_start_server.png b/docs/usage/llms/screenshots/06_lm_studio_start_server.pngdeleted file mode 100644index 0b80af4e01..0000000000Binary files a/docs/usage/llms/screenshots/06_lm_studio_start_server.png and /dev/null differdiff --git a/docs/usage/llms/screenshots/07_openhands_open_advanced_settings.png b/docs/usage/llms/screenshots/07_openhands_open_advanced_settings.pngdeleted file mode 100644index 2817171df8..0000000000Binary files a/docs/usage/llms/screenshots/07_openhands_open_advanced_settings.png and /dev/null differdiff --git a/docs/usage/llms/screenshots/08_openhands_configure_local_llm_parameters.png b/docs/usage/llms/screenshots/08_openhands_configure_local_llm_parameters.pngdeleted file mode 100644index 0203262efb..0000000000Binary files a/docs/usage/llms/screenshots/08_openhands_configure_local_llm_parameters.png and /dev/null differdiff --git a/docs/usage/local-setup.mdx b/docs/usage/local-setup.mdxdeleted file mode 100644index b457335d04..0000000000--- a/docs/usage/local-setup.mdx+++ /dev/null@@ -1,230 +0,0 @@-----title: Getting Started-description: Getting started with running OpenHands on your own.------## Recommended Methods for Running Openhands on Your Local System--### System Requirements--- MacOS with [Docker Desktop support](https://docs.docker.com/desktop/setup/install/mac-install/#system-requirements)-- Linux-- Windows with [WSL](https://learn.microsoft.com/en-us/windows/wsl/install) and [Docker Desktop support](https://docs.docker.com/desktop/setup/install/windows-install/#system-requirements)-- Windows without WSL (see [Windows Without WSL Guide](/usage/windows-without-wsl))--A system with a modern processor and a minimum of **4GB RAM** is recommended to run OpenHands.--### Prerequisites--<AccordionGroup>--<Accordion title="MacOS">-- **Docker Desktop**-- 1. [Install Docker Desktop on Mac](https://docs.docker.com/desktop/setup/install/mac-install).- 2. Open Docker Desktop, go to `Settings > Advanced` and ensure `Allow the default Docker socket to be used` is enabled.-</Accordion>--<Accordion title="Linux">-- <Note>- Tested with Ubuntu 22.04.- </Note>-- **Docker Desktop**-- 1. [Install Docker Desktop on Linux](https://docs.docker.com/desktop/setup/install/linux/).--</Accordion>--<Accordion title="Windows">-- **WSL**-- 1. [Install WSL](https://learn.microsoft.com/en-us/windows/wsl/install).- 2. Run `wsl --version` in powershell and confirm `Default Version: 2`.-- **Ubuntu (Linux Distribution)**-- 1. Install Ubuntu: `wsl --install -d Ubuntu` in PowerShell as Administrator.- 2. Restart computer when prompted.- 3. Open Ubuntu from Start menu to complete setup.- 4. Verify installation: `wsl --list` should show Ubuntu.-- **Docker Desktop**-- 1. [Install Docker Desktop on Windows](https://docs.docker.com/desktop/setup/install/windows-install).- 2. Open Docker Desktop, go to `Settings` and confirm the following:- - General: `Use the WSL 2 based engine` is enabled.- - Resources > WSL Integration: `Enable integration with my default WSL distro` is enabled.-- <Note>- The docker command below to start the app must be run inside the WSL terminal. Use `wsl -d Ubuntu` in PowerShell or search "Ubuntu" in the Start menu to access the Ubuntu terminal.- </Note>-- **Alternative: Windows without WSL**-- If you prefer to run OpenHands on Windows without WSL or Docker, see our [Windows Without WSL Guide](/usage/windows-without-wsl).--</Accordion>--</AccordionGroup>--### Start the App--#### Option 1: Using the CLI Launcher with uv (Recommended)--We recommend using [uv](https://docs.astral.sh/uv/) for the best OpenHands experience. uv provides better isolation from your current project's virtual environment and is required for OpenHands' default MCP servers (like the [fetch MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/fetch)).--**Install uv** (if you haven't already):--See the [uv installation guide](https://docs.astral.sh/uv/getting-started/installation/) for the latest installation instructions for your platform.--**Launch OpenHands**:-```bash-# Launch the GUI server-uvx --python 3.12 --from openhands-ai openhands serve--# Or with GPU support (requires nvidia-docker)-uvx --python 3.12 --from openhands-ai openhands serve --gpu--# Or with current directory mounted-uvx --python 3.12 --from openhands-ai openhands serve --mount-cwd-```--This will automatically handle Docker requirements checking, image pulling, and launching the GUI server. The `--gpu` flag enables GPU support via nvidia-docker, and `--mount-cwd` mounts your current directory into the container.--<Accordion title="Alternative: Traditional pip installation">--If you prefer to use pip and have Python 3.12+ installed:--```bash-# Install OpenHands-pip install openhands-ai--# Launch the GUI server-openhands serve-```--Note that you'll still need `uv` installed for the default MCP servers to work properly.--</Accordion>--#### Option 2: Using Docker Directly--<Accordion title="Docker Command (Click to expand)">--```bash-docker pull docker.all-hands.dev/all-hands-ai/runtime:0.58-nikolaik--docker run -it --rm --pull=always \- -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.58-nikolaik \- -e LOG_ALL_EVENTS=true \- -v /var/run/docker.sock:/var/run/docker.sock \- -v ~/.openhands:/.openhands \- -p 3000:3000 \- --add-host host.docker.internal:host-gateway \- --name openhands-app \- docker.all-hands.dev/all-hands-ai/openhands:0.58-```--</Accordion>--> **Note**: If you used OpenHands before version 0.44, you may want to run `mv ~/.openhands-state ~/.openhands` to migrate your conversation history to the new location.--You'll find OpenHands running at http://localhost:3000!--### Setup--After launching OpenHands, you **must** select an `LLM Provider` and `LLM Model` and enter a corresponding `API Key`.-This can be done during the initial settings popup or by selecting the `Settings`-button (gear icon) in the UI.--If the required model does not exist in the list, in `Settings` under the `LLM` tab, you can toggle `Advanced` options-and manually enter it with the correct prefix in the `Custom Model` text box.-The `Advanced` options also allow you to specify a `Base URL` if required.--#### Getting an API Key--OpenHands requires an API key to access most language models. Here's how to get an API key from the recommended providers:--<AccordionGroup>--<Accordion title="OpenHands (Recommended)">--1. [Log in to OpenHands Cloud](https://app.all-hands.dev).-2. Go to the Settings page and navigate to the `API Keys` tab.-3. Copy your `LLM API Key`.--OpenHands provides access to state-of-the-art agentic coding models with competitive pricing. [Learn more about OpenHands LLM provider](/usage/llms/openhands-llms).--</Accordion>--<Accordion title="Anthropic (Claude)">--1. [Create an Anthropic account](https://console.anthropic.com/).-2. [Generate an API key](https://console.anthropic.com/settings/keys).-3. [Set up billing](https://console.anthropic.com/settings/billing).--</Accordion>--<Accordion title="OpenAI">--1. [Create an OpenAI account](https://platform.openai.com/).-2. [Generate an API key](https://platform.openai.com/api-keys).-3. [Set up billing](https://platform.openai.com/account/billing/overview).--</Accordion>--<Accordion title="Google (Gemini)">--1. Create a Google account if you don't already have one.-2. [Generate an API key](https://aistudio.google.com/apikey).-3. [Set up billing](https://aistudio.google.com/usage?tab=billing).--</Accordion>--<Accordion title="Local LLM (e.g. LM Studio, llama.cpp, Ollama)">--If your local LLM server isn’t behind an authentication proxy, you can enter any value as the API key (e.g. `local-key`, `test123`) — it won’t be used.--</Accordion>--</AccordionGroup>--Consider setting usage limits to control costs.--#### Using a Local LLM--<Note>-Effective use of local models for agent tasks requires capable hardware, along with models specifically tuned for instruction-following and agent-style behavior.-</Note>--To run OpenHands with a locally hosted language model instead of a cloud provider, see the [Local LLMs guide](/usage/llms/local-llms) for setup instructions.--#### Setting Up Search Engine--OpenHands can be configured to use a search engine to allow the agent to search the web for information when needed.--To enable search functionality in OpenHands:--1. Get a Tavily API key from [tavily.com](https://tavily.com/).-2. Enter the Tavily API key in the Settings page under `LLM` tab > `Search API Key (Tavily)`--For more details, see the [Search Engine Setup](/usage/search-engine-setup) guide.--### Versions--The [docker command above](/usage/local-setup#start-the-app) pulls the most recent stable release of OpenHands. You have other options as well:-- For a specific release, replace `$VERSION` in `openhands:$VERSION` and `runtime:$VERSION`, with the version number.-For example, `0.9` will automatically point to the latest `0.9.x` release, and `0` will point to the latest `0.x.x` release.-- For the most up-to-date development version, replace `$VERSION` in `openhands:$VERSION` and `runtime:$VERSION`, with `main`.-This version is unstable and is recommended for testing or development purposes only.--## Next Steps--- [Connect OpenHands to your local filesystem.](/usage/runtimes/docker#connecting-to-your-filesystem) to use OpenHands with your GitHub repositories-- [Run OpenHands in a scriptable headless mode.](/usage/how-to/headless-mode)-- [Run OpenHands with a friendly CLI.](/usage/how-to/cli-mode)-- [Run OpenHands on tagged issues with a GitHub action.](/usage/how-to/github-action)diff --git a/docs/usage/prompting/microagents-keyword.mdx b/docs/usage/prompting/microagents-keyword.mdxdeleted file mode 100644index 8dfa51d203..0000000000--- a/docs/usage/prompting/microagents-keyword.mdx+++ /dev/null@@ -1,36 +0,0 @@-----title: Keyword-Triggered Microagents-description: Keyword-triggered microagents provide OpenHands with specific instructions that are activated when certain keywords appear in the prompt. This is useful for tailoring behavior based on particular tools, languages, or frameworks.------## Usage--These microagents are only loaded when a prompt includes one of the trigger words.--## Frontmatter Syntax--Frontmatter is required for keyword-triggered microagents. It must be placed at the top of the file,-above the guidelines.--Enclose the frontmatter in triple dashes (---) and include the following fields:--| Field | Description | Required | Default |-|------------|--------------------------------------------------|----------|------------------|-| `triggers` | A list of keywords that activate the microagent. | Yes | None |-| `agent` | The agent this microagent applies to. | No | 'CodeActAgent' |---## Example--Keyword-triggered microagent file example located at `.openhands/microagents/yummy.md`:-```-----triggers:-- yummyhappy-- happyyummy------The user has said the magic word. Respond with "That was delicious!"-```--[See examples of microagents triggered by keywords in the official OpenHands repository](https://github.com/All-Hands-AI/OpenHands/tree/main/microagents)diff --git a/docs/usage/prompting/microagents-org.mdx b/docs/usage/prompting/microagents-org.mdxdeleted file mode 100644index 8a439b773c..0000000000--- a/docs/usage/prompting/microagents-org.mdx+++ /dev/null@@ -1,35 +0,0 @@-----title: Organization and User Microagents-description: Organizations and users can define microagents that apply to all repositories belonging to the organization or user.------## Usage--These microagents can be [any type of microagent](./microagents-overview#microagent-types) and will be loaded-accordingly. However, they are applied to all repositories belonging to the organization or user.--Add a `.openhands` repository under the organization or user and create a `microagents` directory and place the-microagents in that directory.--For GitLab organizations, use `openhands-config` as the repository name instead of `.openhands`, since GitLab doesn't support repository names starting with non-alphanumeric characters.--## Example--General microagent file example for organization `Great-Co` located inside the `.openhands` repository:-`microagents/org-microagent.md`:-```-* Use type hints and error boundaries; validate inputs at system boundaries and fail with meaningful error messages.-* Document interfaces and public APIs; use implementation comments only for non-obvious logic.-* Follow the same naming convention for variables, classes, constants, etc. already used in each repository.-```--For GitLab organizations, the same microagent would be located inside the `openhands-config` repository.--## User Microagents When Running Openhands on Your Own--<Note>- This works with CLI, headless and development modes. It does not work out of the box when running OpenHands using the docker command.-</Note>--When running OpenHands on your own, you can place microagents in the `~/.openhands/microagents` folder on your local-system and OpenHands will always load it for all your conversations.diff --git a/docs/usage/prompting/microagents-overview.mdx b/docs/usage/prompting/microagents-overview.mdxdeleted file mode 100644index abc13c2b8d..0000000000--- a/docs/usage/prompting/microagents-overview.mdx+++ /dev/null@@ -1,40 +0,0 @@-----title: Microagents Overview-description: Microagents are specialized prompts that enhance OpenHands with domain-specific knowledge. They provide expert guidance, automate common tasks, and ensure consistent practices across projects.------## Microagent Types--Currently OpenHands supports the following types of microagents:--- [General Microagents](./microagents-repo): General guidelines for OpenHands about the repository.-- [Keyword-Triggered Microagents](./microagents-keyword): Guidelines activated by specific keywords in prompts.--To customize OpenHands' behavior, create a .openhands/microagents/ directory in the root of your repository and-add `<microagent_name>.md` files inside. For repository-specific guidelines, you can ask OpenHands to analyze your repository and create a comprehensive `repo.md` file (see [General Microagents](./microagents-repo) for details).--<Note>-Loaded microagents take up space in the context window.-These microagents, alongside user messages, inform OpenHands about the task and the environment.-</Note>--Example repository structure:--```-some-repository/-└── .openhands/- └── microagents/- └── repo.md # General guidelines- └── trigger_this.md # Microagent triggered by specific keywords- └── trigger_that.md # Microagent triggered by specific keywords-```--## Microagents Frontmatter Requirements--Each microagent file may include frontmatter that provides additional information. In some cases, this frontmatter-is required:--| Microagent Type | Required |-|---------------------------------|----------|-| `General Microagents` | No |-| `Keyword-Triggered Microagents` | Yes |diff --git a/docs/usage/prompting/microagents-public.mdx b/docs/usage/prompting/microagents-public.mdxdeleted file mode 100644index c1e2ca7a4b..0000000000--- a/docs/usage/prompting/microagents-public.mdx+++ /dev/null@@ -1,49 +0,0 @@-----title: Global Microagents-description: Global microagents are [keyword-triggered microagents](./microagents-keyword) that apply to all OpenHands users. A list of the current global microagents can be found [in the OpenHands repository](https://github.com/All-Hands-AI/OpenHands/tree/main/microagents).------## Contributing a Global Microagent--You can create global microagents and share with the community by opening a pull request to the official repository.--See the [CONTRIBUTING.md](https://github.com/All-Hands-AI/OpenHands/blob/main/CONTRIBUTING.md) for specific instructions on how to contribute to OpenHands.--### Global Microagents Best Practices--- **Clear Scope**: Keep the microagent focused on a specific domain or task.-- **Explicit Instructions**: Provide clear, unambiguous guidelines.-- **Useful Examples**: Include practical examples of common use cases.-- **Safety First**: Include necessary warnings and constraints.-- **Integration Awareness**: Consider how the microagent interacts with other components.--### Steps to Contribute a Global Microagent--#### 1. Plan the Global Microagent--Before creating a global microagent, consider:--- What specific problem or use case will it address?-- What unique capabilities or knowledge should it have?-- What trigger words make sense for activating it?-- What constraints or guidelines should it follow?--#### 2. Create File--Create a new Markdown file with a descriptive name in the appropriate directory:-[`microagents/`](https://github.com/All-Hands-AI/OpenHands/tree/main/microagents)--#### 3. Testing the Global Microagent--- Test the agent with various prompts.-- Verify trigger words activate the agent correctly.-- Ensure instructions are clear and comprehensive.-- Check for potential conflicts and overlaps with existing agents.--#### 4. Submission Process--Submit a pull request with:--- The new microagent file.-- Updated documentation if needed.-- Description of the agent's purpose and capabilities.diff --git a/docs/usage/prompting/microagents-repo.mdx b/docs/usage/prompting/microagents-repo.mdxdeleted file mode 100644index e5c3943d5b..0000000000--- a/docs/usage/prompting/microagents-repo.mdx+++ /dev/null@@ -1,62 +0,0 @@-----title: General Microagents-description: General guidelines for OpenHands to work more effectively with the repository.------## Usage--These microagents are always loaded as part of the context.--## Frontmatter Syntax--The frontmatter for this type of microagent is optional.--Frontmatter should be enclosed in triple dashes (---) and may include the following fields:--| Field | Description | Required | Default |-|-----------|-----------------------------------------|----------|----------------|-| `agent` | The agent this microagent applies to | No | 'CodeActAgent' |--## Creating a Comprehensive Repository Agent--To create an effective repository agent, you can ask OpenHands to analyze your repository with a prompt like:--```-Please browse the repository, look at the documentation and relevant code, and understand the purpose of this repository.--Specifically, I want you to create a `.openhands/microagents/repo.md` file. This file should contain succinct information that summarizes:-1. The purpose of this repository-2. The general setup of this repo-3. A brief description of the structure of this repo--Read all the GitHub workflows under .github/ of the repository (if this folder exists) to understand the CI checks (e.g., linter, pre-commit), and include those in the repo.md file.-```--This approach helps OpenHands capture repository context efficiently, reducing the need for repeated searches during conversations and ensuring more accurate solutions.--## Example Content--A comprehensive repository agent file (`.openhands/microagents/repo.md`) should include:--```-# Repository Purpose-This project is a TODO application that allows users to track TODO items.--# Setup Instructions-To set it up, you can run `npm run build`.--# Repository Structure-- `/src`: Core application code-- `/tests`: Test suite-- `/docs`: Documentation-- `/.github`: CI/CD workflows--# CI/CD Workflows-- `lint.yml`: Runs ESLint on all JavaScript files-- `test.yml`: Runs the test suite on pull requests--# Development Guidelines-Always make sure the tests are passing before committing changes. You can run the tests by running `npm run test`.-```--[See more examples of general microagents here.](https://github.com/All-Hands-AI/OpenHands/tree/main/.openhands/microagents)diff --git a/docs/usage/prompting/prompting-best-practices.mdx b/docs/usage/prompting/prompting-best-practices.mdxdeleted file mode 100644index 4802e85e76..0000000000--- a/docs/usage/prompting/prompting-best-practices.mdx+++ /dev/null@@ -1,38 +0,0 @@-----title: Prompting Best Practices-description: When working with OpenHands AI software developer, providing clear and effective prompts is key to getting accurate and useful responses. This guide outlines best practices for crafting effective prompts.------## Characteristics of Good Prompts--Good prompts are:--- **Concrete**: Clearly describe what functionality should be added or what error needs fixing.-- **Location-specific**: Specify the locations in the codebase that should be modified, if known.-- **Appropriately scoped**: Focus on a single feature, typically not exceeding 100 lines of code.--## Examples--### Good Prompt Examples--- Add a function `calculate_average` in `utils/math_operations.py` that takes a list of numbers as input and returns their average.-- Fix the TypeError in `frontend/src/components/UserProfile.tsx` occurring on line 42. The error suggests we're trying to access a property of undefined.-- Implement input validation for the email field in the registration form. Update `frontend/src/components/RegistrationForm.tsx` to check if the email is in a valid format before submission.--### Bad Prompt Examples--- Make the code better. (Too vague, not concrete)-- Rewrite the entire backend to use a different framework. (Not appropriately scoped)-- There's a bug somewhere in the user authentication. Can you find and fix it? (Lacks specificity and location information)--## Tips for Effective Prompting--- Be as specific as possible about the desired outcome or the problem to be solved.-- Provide context, including relevant file paths and line numbers if available.-- Break large tasks into smaller, manageable prompts.-- Include relevant error messages or logs.-- Specify the programming language or framework, if not obvious.--The more precise and informative your prompt, the better OpenHands can assist you.--See [Getting Started with OpenHands](../getting-started) for more examples of helpful prompts.diff --git a/docs/usage/prompting/repository.mdx b/docs/usage/prompting/repository.mdxdeleted file mode 100644index 0bb64ee47b..0000000000--- a/docs/usage/prompting/repository.mdx+++ /dev/null@@ -1,47 +0,0 @@-----title: Repository Customization-description: You can customize how OpenHands interacts with your repository by creating a `.openhands` directory at the root level.------## Microagents--Microagents allow you to extend OpenHands prompts with information specific to your project and define how OpenHands-should function. See [Microagents Overview](../prompting/microagents-overview) for more information.---## Setup Script-You can add a `.openhands/setup.sh` file, which will run every time OpenHands begins working with your repository.-This is an ideal location for installing dependencies, setting environment variables, and performing other setup tasks.--For example:-```bash-#!/bin/bash-export MY_ENV_VAR="my value"-sudo apt-get update-sudo apt-get install -y lsof-cd frontend && npm install ; cd ..-```--## Pre-commit Script-You can add a `.openhands/pre-commit.sh` file to create a custom git pre-commit hook that runs before each commit.-This can be used to enforce code quality standards, run tests, or perform other checks before allowing commits.--For example:-```bash-#!/bin/bash-# Run linting checks-cd frontend && npm run lint-if [ $? -ne 0 ]; then- echo "Frontend linting failed. Please fix the issues before committing."- exit 1-fi--# Run tests-cd backend && pytest tests/unit-if [ $? -ne 0 ]; then- echo "Backend tests failed. Please fix the issues before committing."- exit 1-fi--exit 0-```diff --git a/docs/usage/runtimes/daytona.mdx b/docs/usage/runtimes/daytona.mdxdeleted file mode 100644index c4535eda8e..0000000000--- a/docs/usage/runtimes/daytona.mdx+++ /dev/null@@ -1,47 +0,0 @@-----title: Daytona Runtime-description: You can use [Daytona](https://www.daytona.io/) as a runtime provider.------## Step 1: Retrieve Your Daytona API Key-1. Visit the [Daytona Dashboard](https://app.daytona.io/dashboard/keys).-2. Click **"Create Key"**.-3. Enter a name for your key and confirm the creation.-4. Once the key is generated, copy it.--## Step 2: Set Your API Key as an Environment Variable-Run the following command in your terminal, replacing `<your-api-key>` with the actual key you copied:--### Mac/Linux:-```bash-export DAYTONA_API_KEY="<your-api-key>"-```--### Windows PowerShell:-```powershell-$env:DAYTONA_API_KEY="<your-api-key>"-```--This step ensures that OpenHands can authenticate with the Daytona platform when it runs.--## Step 3: Run OpenHands Locally Using Docker-To start the latest version of OpenHands on your machine, execute the following command in your terminal:--### Mac/Linux:-```bash-bash -i <(curl -sL https://get.daytona.io/openhands)-```--### Windows:-```powershell-powershell -Command "irm https://get.daytona.io/openhands-windows | iex"-```--### What This Command Does:-- Downloads the latest OpenHands release script.-- Runs the script in an interactive Bash session.-- Automatically pulls and runs the OpenHands container using Docker.--Once executed, OpenHands should be running locally and ready for use.--For more details and manual initialization, view the entire [README.md](https://github.com/All-Hands-AI/OpenHands/blob/main/openhands/runtime/impl/daytona/README.md)diff --git a/docs/usage/runtimes/docker.mdx b/docs/usage/runtimes/docker.mdxdeleted file mode 100644index 77b6414d51..0000000000--- a/docs/usage/runtimes/docker.mdx+++ /dev/null@@ -1,157 +0,0 @@-----title: Docker Runtime-description: This is the default Runtime that's used when you start OpenHands.------## Image-The `SANDBOX_RUNTIME_CONTAINER_IMAGE` from nikolaik is a pre-built runtime image-that contains our Runtime server, as well as some basic utilities for Python and NodeJS.-You can also [build your own runtime image](../how-to/custom-sandbox-guide).--## Connecting to Your filesystem-A useful feature is the ability to connect to your local filesystem. To mount your filesystem into the runtime:--### Using SANDBOX_VOLUMES--The simplest way to mount your local filesystem is to use the `SANDBOX_VOLUMES` environment variable:--```bash-export SANDBOX_VOLUMES=/path/to/your/code:/workspace:rw--docker run # ...- -e SANDBOX_USER_ID=$(id -u) \- -e SANDBOX_VOLUMES=$SANDBOX_VOLUMES \- # ...-```--The `SANDBOX_VOLUMES` format is `host_path:container_path[:mode]` where:--- `host_path`: The path on your host machine that you want to mount.-- `container_path`: The path inside the container where the host path will be mounted.- - Use `/workspace` for files you want the agent to modify. The agent works in `/workspace` by default.- - Use a different path (e.g., `/data`) for read-only reference materials or large datasets.-- `mode`: Optional mount mode, either `rw` (read-write, default) or `ro` (read-only).--You can also specify multiple mounts by separating them with commas (`,`):--```bash-export SANDBOX_VOLUMES=/path1:/workspace/path1,/path2:/workspace/path2:ro-```--Examples:--```bash-# Linux and Mac Example - Writable workspace-export SANDBOX_VOLUMES=$HOME/OpenHands:/workspace:rw--# WSL on Windows Example - Writable workspace-export SANDBOX_VOLUMES=/mnt/c/dev/OpenHands:/workspace:rw--# Read-only reference code example-export SANDBOX_VOLUMES=/path/to/reference/code:/data:ro--# Multiple mounts example - Writable workspace with read-only reference data-export SANDBOX_VOLUMES=$HOME/projects:/workspace:rw,/path/to/large/dataset:/data:ro-```--### Using WORKSPACE_* variables (Deprecated)--> **Note:** This method is deprecated and will be removed in a future version. Please use `SANDBOX_VOLUMES` instead.--1. Set `WORKSPACE_BASE`:-- ```bash- export WORKSPACE_BASE=/path/to/your/code- ```--2. Add the following options to the `docker run` command:-- ```bash- docker run # ...- -e SANDBOX_USER_ID=$(id -u) \- -e WORKSPACE_MOUNT_PATH=$WORKSPACE_BASE \- -v $WORKSPACE_BASE:/opt/workspace_base \- # ...- ```--Be careful! There's nothing stopping the OpenHands agent from deleting or modifying-any files that are mounted into its workspace.--The `-e SANDBOX_USER_ID=$(id -u)` is passed to the Docker command to ensure the sandbox user matches the host user’s-permissions. This prevents the agent from creating root-owned files in the mounted workspace.--## Hardened Docker Installation--When deploying OpenHands in environments where security is a priority, you should consider implementing a hardened-Docker configuration. This section provides recommendations for securing your OpenHands Docker deployment beyond the default configuration.--### Security Considerations--The default Docker configuration in the README is designed for ease of use on a local development machine. If you're-running on a public network (e.g. airport WiFi), you should implement additional security measures.--### Network Binding Security--By default, OpenHands binds to all network interfaces (`0.0.0.0`), which can expose your instance to all networks the-host is connected to. For a more secure setup:--1. **Restrict Network Binding**: Use the `runtime_binding_address` configuration to restrict which network interfaces OpenHands listens on:-- ```bash- docker run # ...- -e SANDBOX_RUNTIME_BINDING_ADDRESS=127.0.0.1 \- # ...- ```-- This configuration ensures OpenHands only listens on the loopback interface (`127.0.0.1`), making it accessible only from the local machine.--2. **Secure Port Binding**: Modify the `-p` flag to bind only to localhost instead of all interfaces:-- ```bash- docker run # ... \- -p 127.0.0.1:3000:3000 \- ```-- This ensures that the OpenHands web interface is only accessible from the local machine, not from other machines on the network.--### Network Isolation--Use Docker's network features to isolate OpenHands:--```bash-# Create an isolated network-docker network create openhands-network--# Run OpenHands in the isolated network-docker run # ... \- --network openhands-network \-```--<Note>-**Docker Desktop Required**: Network isolation features, including custom networks and `host.docker.internal` routing, require Docker Desktop. Docker Engine alone does not support these features on localhost across custom networks. If you're using Docker Engine without Docker Desktop, network isolation may not work as expected.-</Note>--### Sidecar Containers--If you want to run sidecar containers to the sandbox 'runner' containers without exposing the sandbox containers to the host network, you can use the `SANDBOX_ADDITIONAL_NETWORKS` environment variable to specify additional Docker network names that should be added to the sandbox containers.--```bash-docker network create openhands-sccache--docker run -d \- --hostname openhandsredis \- --network openhands-sccache \- redis--docker run # ...- -e SANDBOX_ADDITIONAL_NETWORKS='["openhands-sccache"]' \- # ...-```--Then all sandbox instances will have to access a shared redis instance at `openhandsredis:6379`.--#### Docker Compose gotcha--Note that Docker Compose adds a prefix (a scope) by default to created networks, which is not taken into account by the additional networks config. Therefore when using docker compose you have to either:-- specify a network name via the `name` field to remove the scoping (https://docs.docker.com/reference/compose-file/networks/#name)-- or provide the scope within the given config (e.g. `SANDBOX_ADDITIONAL_NETWORKS: '["myscope_openhands-sccache"]'` where `myscope` is the docker-compose assigned prefix).\ No newline at end of filediff --git a/docs/usage/runtimes/e2b.mdx b/docs/usage/runtimes/e2b.mdxdeleted file mode 100644index 772b1b8b00..0000000000--- a/docs/usage/runtimes/e2b.mdx+++ /dev/null@@ -1,44 +0,0 @@-----title: E2B Runtime-description: E2B is an open-source secure cloud environment (sandbox) made for running AI-generated code and agents.------[E2B](https://e2b.dev) offers [Python](https://pypi.org/project/e2b/) and [JS/TS](https://www.npmjs.com/package/e2b)-SDK to spawn and control these sandboxes.--## Getting started--1. [Get your API key](https://e2b.dev/docs/getting-started/api-key)--1. Set your E2B API key to the `E2B_API_KEY` env var when starting the Docker container--1. **Optional** - Install the CLI with NPM.- ```sh- npm install -g @e2b/cli@latest- ```- Full CLI API is [here](https://e2b.dev/docs/cli/installation).--## OpenHands sandbox--You can use the E2B CLI to create a custom sandbox with a Dockerfile. Read the full guide-[here](https://e2b.dev/docs/guide/custom-sandbox). The premade OpenHands sandbox for E2B is set up in the `containers`-directory, and it's called `openhands`.--## Debugging--You can connect to a running E2B sandbox with E2B CLI in your terminal.--- List all running sandboxes (based on your API key)- ```sh- e2b sandbox list- ```--- Connect to a running sandbox- ```sh- e2b sandbox connect <sandbox-id>- ```--## Links--- [E2B Docs](https://e2b.dev/docs)-- [E2B GitHub](https://github.com/e2b-dev/e2b)diff --git a/docs/usage/runtimes/local.mdx b/docs/usage/runtimes/local.mdxdeleted file mode 100644index 4855d302b1..0000000000--- a/docs/usage/runtimes/local.mdx+++ /dev/null@@ -1,72 +0,0 @@-----title: Local Runtime-description: The Local Runtime allows the OpenHands agent to execute actions directly on your local machine without- using Docker. This runtime is primarily intended for controlled environments like CI pipelines or testing scenarios- where Docker is not available.------<Warning>-**Security Warning**: The Local Runtime runs without any sandbox isolation. The agent can directly access and modify-files on your machine. Only use this runtime in controlled environments or when you fully understand the security implications.-</Warning>--## Prerequisites--Before using the Local Runtime, ensure that:--1. You can run OpenHands using the [Development workflow](https://github.com/All-Hands-AI/OpenHands/blob/main/Development.md).-2. For Linux and Mac, tmux is available on your system.-3. For Windows, PowerShell is available on your system.- - Only [CLI mode](../how-to/cli-mode) and [headless mode](../how-to/headless-mode) are supported in Windows with Local Runtime.--## Configuration--To use the Local Runtime, besides required configurations like the LLM provider, model and API key, you'll need to set-the following options via environment variables or the [config.toml file](https://github.com/All-Hands-AI/OpenHands/blob/main/config.template.toml) when starting OpenHands:--Via environment variables (please use PowerShell syntax for Windows PowerShell):--```bash-# Required-export RUNTIME=local--# Optional but recommended-# The agent works in /workspace by default, so mount your project directory there-export SANDBOX_VOLUMES=/path/to/your/workspace:/workspace:rw-# For read-only data, use a different mount path-# export SANDBOX_VOLUMES=/path/to/your/workspace:/workspace:rw,/path/to/large/dataset:/data:ro-```--Via `config.toml`:--```toml-[core]-runtime = "local"--[sandbox]-# The agent works in /workspace by default, so mount your project directory there-volumes = "/path/to/your/workspace:/workspace:rw"-# For read-only data, use a different mount path-# volumes = "/path/to/your/workspace:/workspace:rw,/path/to/large/dataset:/data:ro"-```--If `SANDBOX_VOLUMES` is not set, the runtime will create a temporary directory for the agent to work in.--## Example Usage--Here's an example of how to start OpenHands with the Local Runtime in Headless Mode:--```bash-export RUNTIME=local-export SANDBOX_VOLUMES=/my_folder/myproject:/workspace:rw--poetry run python -m openhands.core.main -t "write a bash script that prints hi"-```--## Use Cases--The Local Runtime is particularly useful for:--- CI/CD pipelines where Docker is not available.-- Testing and development of OpenHands itself.-- Environments where container usage is restricted (e.g. native Windows).diff --git a/docs/usage/runtimes/modal.mdx b/docs/usage/runtimes/modal.mdxdeleted file mode 100644index c5702ec247..0000000000--- a/docs/usage/runtimes/modal.mdx+++ /dev/null@@ -1,14 +0,0 @@-----title: Modal Runtime------Our partners at [Modal](https://modal.com/) have provided a runtime for OpenHands.-To use the Modal Runtime, create an account, and then [create an API key.](https://modal.com/settings)--You'll then need to set the following environment variables when starting OpenHands:-```bash-docker run # ...- -e RUNTIME=modal \- -e MODAL_API_TOKEN_ID="your-id" \- -e MODAL_API_TOKEN_SECRET="modal-api-key" \-```diff --git a/docs/usage/runtimes/overview.mdx b/docs/usage/runtimes/overview.mdxdeleted file mode 100644index 25ab882cc7..0000000000--- a/docs/usage/runtimes/overview.mdx+++ /dev/null@@ -1,36 +0,0 @@-----title: Overview-description: This section is for users that would like to use a runtime other than Docker for OpenHands.------A Runtime is an environment where the OpenHands agent can edit files and run-commands.--By default, OpenHands uses a [Docker-based runtime](/usage/runtimes/docker), running on your local computer.-This means you only have to pay for the LLM you're using, and your code is only ever sent to the LLM.--Additionally, we provide a [Local Runtime](/usage/runtimes/local) that runs directly on your machine without Docker,-which can be useful in controlled environments like CI pipelines.--## Available Runtimes--OpenHands supports several different runtime environments:--- [Docker Runtime](/usage/runtimes/docker) - The default runtime that uses Docker containers for isolation (recommended for most users).-- [OpenHands Remote Runtime](/usage/runtimes/remote) - Cloud-based runtime for parallel execution (beta).-- [Local Runtime](/usage/runtimes/local) - Direct execution on your local machine without Docker.--### Third-Party Runtimes--The following third-party runtimes are available when you install the `third_party_runtimes` extra:--```bash-pip install openhands-ai[third_party_runtimes]-```--- [E2B Runtime](/usage/runtimes/e2b) - Open source runtime using E2B sandboxes.-- [Modal Runtime](/usage/runtimes/modal) - Serverless runtime using Modal infrastructure.-- [Runloop Runtime](/usage/runtimes/runloop) - Cloud runtime using Runloop infrastructure.-- [Daytona Runtime](/usage/runtimes/daytona) - Development environment runtime using Daytona.--**Note**: These third-party runtimes are supported by their respective developers, not by the OpenHands team. For issues specific to these runtimes, please refer to their documentation or contact their support teams.diff --git a/docs/usage/runtimes/remote.mdx b/docs/usage/runtimes/remote.mdxdeleted file mode 100644index ebf6e99d34..0000000000--- a/docs/usage/runtimes/remote.mdx+++ /dev/null@@ -1,11 +0,0 @@-----title: Remote Runtime-description: This runtime is specifically designed for agent evaluation purposes only through the- [OpenHands evaluation harness](https://github.com/All-Hands-AI/OpenHands/tree/main/evaluation). It should not be- used to launch production OpenHands applications.------OpenHands Remote Runtime is currently in beta (read [here](https://runtime.all-hands.dev/) for more details),-it allows you to launch runtimes in parallel in the cloud. Fill out-[this form](https://docs.google.com/forms/d/e/1FAIpQLSckVz_JFwg2_mOxNZjCtr7aoBFI2Mwdan3f75J_TrdMS1JV2g/viewform) to-apply if you want to try this out!diff --git a/docs/usage/runtimes/runloop.mdx b/docs/usage/runtimes/runloop.mdxdeleted file mode 100644index b6c1c4444d..0000000000--- a/docs/usage/runtimes/runloop.mdx+++ /dev/null@@ -1,32 +0,0 @@-----title: Runloop Runtime-description: Runloop provides a fast, secure and scalable AI sandbox (Devbox). Check out the- [runloop docs](https://docs.runloop.ai/overview/what-is-runloop) for more detail.------## Access-Runloop is currently available in a closed beta. For early access, or-just to say hello, sign up at https://www.runloop.ai/hello--## Set up-With your runloop API,-```bash-export RUNLOOP_API_KEY=<your-api-key>-```--Configure the runtime-```bash-export RUNTIME="runloop"-```--## Interact with your devbox-Runloop provides additional tools to interact with your Devbox based-runtime environment. See the [docs](https://docs.runloop.ai/tools) for an up-to date list of tools.--### Dashboard-View logs, ssh into, or view your Devbox status from the [dashboard](https://platform.runloop.ai)--### CLI-Use the Runloop CLI to view logs, execute commands, and more.-See the setup instructions [here](https://docs.runloop.ai/tools/cli)diff --git a/docs/usage/search-engine-setup.mdx b/docs/usage/search-engine-setup.mdxdeleted file mode 100644index 23b865434d..0000000000--- a/docs/usage/search-engine-setup.mdx+++ /dev/null@@ -1,66 +0,0 @@-----title: Search Engine Setup-description: Configure OpenHands to use Tavily as a search engine.------## Setting Up Search Engine in OpenHands--OpenHands can be configured to use [Tavily](https://tavily.com/) as a search engine, which allows the agent to search the web for information when needed. This capability enhances the agent's ability to provide up-to-date information and solve problems that require external knowledge.--### Getting a Tavily API Key--To use the search functionality in OpenHands, you'll need to obtain a Tavily API key:--1. Visit [Tavily's website](https://tavily.com/) and sign up for an account.-2. Navigate to the API section in your dashboard.-3. Generate a new API key.-4. Copy the API key (it should start with `tvly-`).--### Configuring Search in OpenHands--Once you have your Tavily API key, you can configure OpenHands to use it:--#### In the OpenHands UI--1. Open OpenHands and navigate to the Settings page.-2. Under the `LLM` tab, enter your Tavily API key (starting with `tvly-`) in the `Search API Key (Tavily)` field.-3. Click `Save` to apply the changes.--<Note>- The search API key field is optional. If you don't provide a key, the search functionality will not be available to the agent.-</Note>--#### Using Configuration Files--If you're running OpenHands in headless mode or via CLI, you can configure the search API key in your configuration file:--```toml-# In your OpenHands config file-[core]-search_api_key = "tvly-your-api-key-here"-```--### How Search Works in OpenHands--When the search engine is configured:--- The agent can decide to search the web when it needs external information.-- Search queries are sent to Tavily's API via [Tavily's MCP server](https://github.com/tavily-ai/tavily-mcp) which- includes a variety of [tools](https://docs.tavily.com/documentation/api-reference/introduction) (search, extract, crawl, map).-- Results are returned and incorporated into the agent's context.-- The agent can use this information to provide more accurate and up-to-date responses.--### Limitations--- Search results depend on Tavily's coverage and freshness.-- Usage may be subject to Tavily's rate limits and pricing tiers.-- The agent will only search when it determines that external information is needed.--### Troubleshooting--If you encounter issues with the search functionality:--- Verify that your API key is correct and active.-- Check that your API key starts with `tvly-`.-- Ensure you have an active internet connection.-- Check Tavily's status page for any service disruptions.diff --git a/docs/usage/settings/mcp-settings.mdx b/docs/usage/settings/mcp-settings.mdxdeleted file mode 100644index a556867714..0000000000--- a/docs/usage/settings/mcp-settings.mdx+++ /dev/null@@ -1,194 +0,0 @@-----title: Model Context Protocol (MCP)-description: This page outlines how to configure and use the Model Context Protocol (MCP) in OpenHands, allowing you- to extend the agent's capabilities with custom tools.------## Overview--Model Context Protocol (MCP) is a mechanism that allows OpenHands to communicate with external tool servers. These-servers can provide additional functionality to the agent, such as specialized data processing, external API access,-or custom tools. MCP is based on the open standard defined at [modelcontextprotocol.io](https://modelcontextprotocol.io).--## Supported MCPs--OpenHands supports the following MCP transport protocols:--* [Server-Sent Events (SSE)](https://modelcontextprotocol.io/specification/2024-11-05/basic/transports#http-with-sse)-* [Streamable HTTP (SHTTP)](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#streamable-http)-* [Standard Input/Output (stdio)](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#stdio)--## How MCP Works--When OpenHands starts, it:--1. Reads the MCP configuration.-2. Connects to any configured SSE and SHTTP servers.-3. Starts any configured stdio servers.-4. Registers the tools provided by these servers with the agent.--The agent can then use these tools just like any built-in tool. When the agent calls an MCP tool:--1. OpenHands routes the call to the appropriate MCP server.-2. The server processes the request and returns a response.-3. OpenHands converts the response to an observation and presents it to the agent.--## Configuration--MCP configuration can be defined in:-* The OpenHands UI in the `Settings > MCP` page.-* The `config.toml` file under the `[mcp]` section if not using the UI.--### Configuration Options--<Tabs>- <Tab title="SSE Servers">- SSE servers are configured using either a string URL or an object with the following properties:-- - `url` (required)- - Type: `str`- - Description: The URL of the SSE server.-- - `api_key` (optional)- - Type: `str`- - Description: API key for authentication.- </Tab>- <Tab title="SHTTP Servers">- SHTTP (Streamable HTTP) servers are configured using either a string URL or an object with the following properties:-- - `url` (required)- - Type: `str`- - Description: The URL of the SHTTP server.-- - `api_key` (optional)- - Type: `str`- - Description: API key for authentication.-- - `timeout` (optional)- - Type: `int`- - Default: `60`- - Range: `1-3600` seconds (1 hour maximum)- - Description: Timeout in seconds for tool execution. This prevents tool calls from hanging indefinitely.- - **Use Cases:**- - **Short timeout (1-30s)**: For lightweight operations like status checks or simple queries.- - **Medium timeout (30-300s)**: For standard processing tasks like data analysis or API calls.- - **Long timeout (300-3600s)**: For heavy operations like file processing, complex calculations, or batch operations.- <Note>- This timeout only applies to individual tool calls, not server connection establishment.- </Note>- </Tab>- <Tab title="Stdio Servers">- <Note>- While stdio servers are supported, [we recommend using MCP proxies](/usage/settings/mcp-settings#configuration-examples) for- better reliability and performance.- </Note>-- Stdio servers are configured using an object with the following properties:-- - `name` (required)- - Type: `str`- - Description: A unique name for the server.-- - `command` (required)- - Type: `str`- - Description: The command to run the server.-- - `args` (optional)- - Type: `list of str`- - Default: `[]`- - Description: Command-line arguments to pass to the server.-- - `env` (optional)- - Type: `dict of str to str`- - Default: `{}`- - Description: Environment variables to set for the server process.- </Tab>-</Tabs>--#### When to Use Direct Stdio--Direct stdio connections may still be appropriate in these scenarios:-- **Development and testing**: Quick prototyping of MCP servers.-- **Simple, single-use tools**: Tools that don't require high reliability or concurrent access.-- **Local-only environments**: When you don't want to manage additional proxy processes.--### Configuration Examples--<Tabs>- <Tab title="Proxy Servers (SSE/HTTP) - Recommended">- For stdio-based MCP servers, we recommend using MCP proxy tools like- [`supergateway`](https://github.com/supercorp-ai/supergateway) instead of direct stdio connections.- [SuperGateway](https://github.com/supercorp-ai/supergateway) is a popular MCP proxy that converts stdio MCP servers to- HTTP/SSE endpoints.-- Start the proxy servers separately:- ```bash- # Terminal 1: Filesystem server proxy- supergateway --stdio "npx @modelcontextprotocol/server-filesystem /" --port 8080-- # Terminal 2: Fetch server proxy- supergateway --stdio "uvx mcp-server-fetch" --port 8081- ```-- Then configure OpenHands to use the HTTP endpoint:-- ```toml- [mcp]- # SSE Servers - Recommended approach using proxy tools- sse_servers = [- # Basic SSE server with just a URL- "http://example.com:8080/mcp",-- # SuperGateway proxy for fetch server- "http://localhost:8081/sse",-- # External MCP service with authentication- {url="https://api.example.com/mcp/sse", api_key="your-api-key"}- ]-- # SHTTP Servers - Modern streamable HTTP transport (recommended)- shttp_servers = [- # Basic SHTTP server with default 60s timeout- "https://api.example.com/mcp/shttp",-- # Server with custom timeout for heavy operations- {- url = "https://files.example.com/mcp/shttp",- api_key = "your-api-key",- timeout = 1800 # 30 minutes for large file processing- }- ]- ```- </Tab>- <Tab title="Direct Stdio Servers">- <Note>- This setup is not Recommended for production.- </Note>- ```toml- [mcp]- # Direct stdio servers - use only for development/testing- stdio_servers = [- # Basic stdio server- {name="fetch", command="uvx", args=["mcp-server-fetch"]},-- # Stdio server with environment variables- {- name="filesystem",- command="npx",- args=["@modelcontextprotocol/server-filesystem", "/"],- env={- "DEBUG": "true"- }- }- ]- ```-- For production use, we recommend using proxy tools like SuperGateway.- </Tab>-</Tabs>--Other options include:--- **Custom FastAPI/Express servers**: Build your own HTTP wrapper around stdio MCP servers.-- **Docker-based proxies**: Containerized solutions for better isolation.-- **Cloud-hosted MCP services**: Third-party services that provide MCP endpoints.diff --git a/docs/usage/settings/secrets-settings.mdx b/docs/usage/settings/secrets-settings.mdxdeleted file mode 100644index d8180e8309..0000000000--- a/docs/usage/settings/secrets-settings.mdx+++ /dev/null@@ -1,42 +0,0 @@-----title: Secrets Management-description: How to manage secrets in OpenHands.------## Overview--OpenHands provides a secrets manager that allows you to securely store and manage sensitive information that can be-accessed by the agent during runtime, such as API keys. These secrets are automatically exported as environment-variables in the agent's runtime environment.--## Accessing the Secrets Manager--Navigate to the `Settings > Secrets` page. Here, you'll see a list of all your existing custom secrets.--## Adding a New Secret-1. Click `Add a new secret`.-2. Fill in the following fields:- - **Name**: A unique identifier for your secret (e.g., `AWS_ACCESS_KEY`). This will be the environment variable name.- - **Value**: The sensitive information you want to store.- - **Description** (optional): A brief description of what the secret is used for, which is also provided to the agent.-3. Click `Add secret` to save.--## Editing a Secret--1. Click the `Edit` button next to the secret you want to modify.-2. You can update the name and description of the secret.-<Note>- For security reasons, you cannot view or edit the value of an existing secret. If you need to change the- value, delete the secret and create a new one.-</Note>--## Deleting a Secret--1. Click the `Delete` button next to the secret you want to remove.-2. Select `Confirm` to delete the secret.--## Using Secrets in the Agent- - All custom secrets are automatically exported as environment variables in the agent's runtime environment.- - You can access them in your code using standard environment variable access methods. For example, if you create a- secret named `OPENAI_API_KEY`, you can access it in your code as `process.env.OPENAI_API_KEY` in JavaScript or- `os.environ['OPENAI_API_KEY']` in Python.diff --git a/docs/usage/troubleshooting/troubleshooting.mdx b/docs/usage/troubleshooting/troubleshooting.mdxdeleted file mode 100644index 2adbde9ea3..0000000000--- a/docs/usage/troubleshooting/troubleshooting.mdx+++ /dev/null@@ -1,106 +0,0 @@-----title: Troubleshooting------<Tip>-OpenHands only supports Windows via WSL. Please be sure to run all commands inside your WSL terminal.-</Tip>--### Launch docker client failed--**Description**--When running OpenHands, the following error is seen:-```-Launch docker client failed. Please make sure you have installed docker and started docker desktop/daemon.-```--**Resolution**--Try these in order:-* Confirm `docker` is running on your system. You should be able to run `docker ps` in the terminal successfully.-* If using Docker Desktop, ensure `Settings > Advanced > Allow the default Docker socket to be used` is enabled.-* Depending on your configuration you may need `Settings > Resources > Network > Enable host networking` enabled in Docker Desktop.-* Reinstall Docker Desktop.--### Permission Error--**Description**--On initial prompt, an error is seen with `Permission Denied` or `PermissionError`.--**Resolution**--* Check if the `~/.openhands` is owned by `root`. If so, you can:- * Change the directory's ownership: `sudo chown <user>:<user> ~/.openhands`.- * or update permissions on the directory: `sudo chmod 777 ~/.openhands`- * or delete it if you don’t need previous data. OpenHands will recreate it. You'll need to re-enter LLM settings.-* If mounting a local directory, ensure your `WORKSPACE_BASE` has the necessary permissions for the user running- OpenHands.--### On Linux, Getting ConnectTimeout Error--**Description**--When running on Linux, you might run into the error `ERROR:root:<class 'httpx.ConnectTimeout'>: timed out`.--**Resolution**--If you installed Docker from your distribution’s package repository (e.g., docker.io on Debian/Ubuntu), be aware that-these packages can sometimes be outdated or include changes that cause compatibility issues. try reinstalling Docker-[using the official instructions](https://docs.docker.com/engine/install/) to ensure you are running a compatible version.--If that does not solve the issue, try incrementally adding the following parameters to the docker run command:-* `--network host`-* `-e SANDBOX_USE_HOST_NETWORK=true`-* `-e DOCKER_HOST_ADDR=127.0.0.1`--### Internal Server Error. Ports are not available--**Description**--When running on Windows, the error `Internal Server Error ("ports are not available: exposing port TCP-...: bind: An attempt was made to access a socket in a-way forbidden by its access permissions.")` is encountered.--**Resolution**--* Run the following command in PowerShell, as Administrator to reset the NAT service and release the ports:-```-Restart-Service -Name "winnat"-```--### Unable to access VS Code tab via local IP--**Description**--When accessing OpenHands through a non-localhost URL (such as a LAN IP address), the VS Code tab shows a "Forbidden"-error, while other parts of the UI work fine.--**Resolution**--This happens because VS Code runs on a random high port that may not be exposed or accessible from other machines.-To fix this:--1. Set a specific port for VS Code using the `SANDBOX_VSCODE_PORT` environment variable:- ```bash- docker run -it --rm \- -e SANDBOX_VSCODE_PORT=41234 \- -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:latest \- -v /var/run/docker.sock:/var/run/docker.sock \- -v ~/.openhands:/.openhands \- -p 3000:3000 \- -p 41234:41234 \- --add-host host.docker.internal:host-gateway \- --name openhands-app \- docker.all-hands.dev/all-hands-ai/openhands:latest- ```-- > **Note**: If you used OpenHands before version 0.44, you may want to run `mv ~/.openhands-state ~/.openhands` to migrate your conversation history to the new location.--2. Make sure to expose the same port with `-p 41234:41234` in your Docker command.-3. If running with the development workflow, you can set this in your `config.toml` file:- ```toml- [sandbox]- vscode_port = 41234- ```diff --git a/docs/usage/windows-without-wsl.mdx b/docs/usage/windows-without-wsl.mdxdeleted file mode 100644index f09d874a2e..0000000000--- a/docs/usage/windows-without-wsl.mdx+++ /dev/null@@ -1,253 +0,0 @@-----title: Windows Without WSL-description: Running OpenHands GUI on Windows without using WSL or Docker------# Running OpenHands GUI on Windows Without WSL--This guide provides step-by-step instructions for running OpenHands on a Windows machine without using WSL or Docker.--## Prerequisites--1. **Windows 10/11** - A modern Windows operating system-2. **PowerShell 7+** - While Windows PowerShell comes pre-installed on Windows 10/11, PowerShell 7+ is strongly recommended to avoid compatibility issues (see Troubleshooting section for "System.Management.Automation" errors)-3. **.NET Core Runtime** - Required for the PowerShell integration via pythonnet-4. **Python 3.12 or 3.13** - Python 3.12 or 3.13 is required (Python 3.14 is not supported due to pythonnet compatibility)-5. **Git** - For cloning the repository and version control-6. **Node.js and npm** - For running the frontend--## Step 1: Install Required Software--1. **Install Python 3.12 or 3.13**- - Download Python 3.12.x or 3.13.x from [python.org](https://www.python.org/downloads/)- - During installation, check "Add Python to PATH"- - Verify installation by opening PowerShell and running:- ```powershell- python --version- ```--2. **Install PowerShell 7**- - Download and install PowerShell 7 from the [official PowerShell GitHub repository](https://github.com/PowerShell/PowerShell/releases)- - Choose the MSI installer appropriate for your system (x64 for most modern computers)- - Run the installer with default options- - Verify installation by opening a new terminal and running:- ```powershell- pwsh --version- ```- - Using PowerShell 7 (pwsh) instead of Windows PowerShell will help avoid "System.Management.Automation" errors--3. **Install .NET Core Runtime**- - Download and install the .NET Core Runtime from [Microsoft's .NET download page](https://dotnet.microsoft.com/download)- - Choose the latest .NET Core Runtime (not SDK)- - Verify installation by opening PowerShell and running:- ```powershell- dotnet --info- ```- - This step is required for the PowerShell integration via pythonnet. Without it, OpenHands will fall back to a more limited PowerShell implementation.--4. **Install Git**- - Download Git from [git-scm.com](https://git-scm.com/download/win)- - Use default installation options- - Verify installation:- ```powershell- git --version- ```--5. **Install Node.js and npm**- - Download Node.js from [nodejs.org](https://nodejs.org/) (LTS version recommended)- - During installation, accept the default options which will install npm as well- - Verify installation:- ```powershell- node --version- npm --version- ```--6. **Install Poetry**- - Open PowerShell as Administrator and run:- ```powershell- (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -- ```- - Add Poetry to your PATH:- ```powershell- $env:Path += ";$env:APPDATA\Python\Scripts"- ```- - Verify installation:- ```powershell- poetry --version- ```--## Step 2: Clone and Set Up OpenHands--1. **Clone the Repository**- ```powershell- git clone https://github.com/All-Hands-AI/OpenHands.git- cd OpenHands- ```--2. **Install Dependencies**- ```powershell- poetry install- ```-- This will install all required dependencies, including:- - pythonnet - Required for Windows PowerShell integration- - All other OpenHands dependencies--## Step 3: Run OpenHands--1. **Build the Frontend**- ```powershell- cd frontend- npm install- npm run build- cd ..- ```-- This will build the frontend files that the backend will serve.--2. **Start the Backend**- ```powershell- # Make sure to use PowerShell 7 (pwsh) instead of Windows PowerShell- pwsh- $env:RUNTIME="local"; poetry run uvicorn openhands.server.listen:app --host 0.0.0.0 --port 3000 --reload --reload-exclude "./workspace"- ```-- This will start the OpenHands app using the local runtime with PowerShell integration, available at `localhost:3000`.-- > **Note**: If you encounter a `RuntimeError: Directory './frontend/build' does not exist` error, make sure you've built the frontend first using the command above.-- > **Important**: Using PowerShell 7 (pwsh) instead of Windows PowerShell is recommended to avoid "System.Management.Automation" errors. If you encounter this error, see the Troubleshooting section below.--3. **Alternatively, Run the Frontend in Development Mode (in a separate PowerShell window)**- ```powershell- cd frontend- npm run dev- ```--4. **Access the OpenHands GUI**-- Open your browser and navigate to:- ```- http://localhost:3000- ```-- > **Note**: If you're running the frontend in development mode (using `npm run dev`), use port 3001 instead: `http://localhost:3001`--## Installing and Running the CLI--To install and run the OpenHands CLI on Windows without WSL, follow these steps:--### 1. Install uv (Python Package Manager)--Open PowerShell as Administrator and run:--```powershell-powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"-```--### 2. Install .NET SDK (Required)--The OpenHands CLI **requires** the .NET Core runtime for PowerShell integration. Without it, the CLI will fail to start with a `coreclr` error. Install the .NET SDK which includes the runtime:--```powershell-winget install Microsoft.DotNet.SDK.8-```--Alternatively, you can download and install the .NET SDK from the [official Microsoft website](https://dotnet.microsoft.com/download).--After installation, restart your PowerShell session to ensure the environment variables are updated.--### 3. Install and Run OpenHands--After installing the prerequisites, you can install and run OpenHands with:--```powershell-uvx --python 3.12 --from openhands-ai openhands-```--### Troubleshooting CLI Issues--#### CoreCLR Error--If you encounter an error like `Failed to load CoreCLR` or `pythonnet.load('coreclr')` when running OpenHands CLI, this indicates that the .NET Core runtime is missing or not properly configured. To fix this:--1. Install the .NET SDK as described in step 2 above-2. Verify that your system PATH includes the .NET SDK directories-3. Restart your PowerShell session completely after installing the .NET SDK-4. Make sure you're using PowerShell 7 (pwsh) rather than Windows PowerShell--To verify your .NET installation, run:--```powershell-dotnet --info-```--This should display information about your installed .NET SDKs and runtimes. If this command fails, the .NET SDK is not properly installed or not in your PATH.--If the issue persists after installing the .NET SDK, try installing the specific .NET Runtime version 6.0 or later from the [.NET download page](https://dotnet.microsoft.com/download).--## Limitations on Windows--When running OpenHands on Windows without WSL or Docker, be aware of the following limitations:--1. **Browser Tool Not Supported**: The browser tool is not currently supported on Windows.--2. **.NET Core Requirement**: The PowerShell integration requires .NET Core Runtime to be installed. The CLI implementation attempts to load the CoreCLR at startup with `pythonnet.load('coreclr')` and will fail with an error if .NET Core is not properly installed.--3. **Interactive Shell Commands**: Some interactive shell commands may not work as expected. The PowerShell session implementation has limitations compared to the bash session used on Linux/macOS.--4. **Path Handling**: Windows uses backslashes (`\`) in paths, which may require adjustments when working with code examples designed for Unix-like systems.--## Troubleshooting--### "System.Management.Automation" Not Found Error--If you encounter an error message stating that "System.Management.Automation" was not found, this typically indicates that you have a minimal version of PowerShell installed or that the .NET components required for PowerShell integration are missing.--> **IMPORTANT**: This error is most commonly caused by using the built-in Windows PowerShell (powershell.exe) instead of PowerShell 7 (pwsh.exe). Even if you installed PowerShell 7 during the prerequisites, you may still be using the older Windows PowerShell by default.--To resolve this issue:--1. **Install the latest version of PowerShell 7** from the official Microsoft repository:- - Visit [https://github.com/PowerShell/PowerShell/releases](https://github.com/PowerShell/PowerShell/releases)- - Download and install the latest MSI package for your system architecture (x64 for most systems)- - During installation, ensure you select the following options:- - "Add PowerShell to PATH environment variable"- - "Register Windows PowerShell 7 as the default shell"- - "Enable PowerShell remoting"- - The installer will place PowerShell 7 in `C:\Program Files\PowerShell\7` by default--2. **Restart your terminal or command prompt** to ensure the new PowerShell is available--3. **Verify the installation** by running:- ```powershell- pwsh --version- ```-- You should see output indicating PowerShell 7.x.x--4. **Run OpenHands using PowerShell 7** instead of Windows PowerShell:- ```powershell- pwsh- cd path\to\openhands- $env:RUNTIME="local"; poetry run uvicorn openhands.server.listen:app --host 0.0.0.0 --port 3000 --reload --reload-exclude "./workspace"- ```-- > **Note**: Make sure you're explicitly using `pwsh` (PowerShell 7) and not `powershell` (Windows PowerShell). The command prompt or terminal title should say "PowerShell 7" rather than just "Windows PowerShell".--5. **If the issue persists**, ensure that you have the .NET Runtime installed:- - Download and install the latest .NET Runtime from [Microsoft's .NET download page](https://dotnet.microsoft.com/download)- - Choose ".NET Runtime" (not SDK) version 6.0 or later- - After installation, verify it's properly installed by running:- ```powershell- dotnet --info- ```- - Restart your computer after installation- - Try running OpenHands again--6. **Ensure that the .NET Framework is properly installed** on your system:- - Go to Control Panel > Programs > Programs and Features > Turn Windows features on or off- - Make sure ".NET Framework 4.8 Advanced Services" is enabled- - Click OK and restart if prompted--This error occurs because OpenHands uses the pythonnet package to interact with PowerShell, which requires the System.Management.Automation assembly from the .NET framework. A minimal PowerShell installation or older Windows PowerShell (rather than PowerShell 7+) might not include all the necessary components for this integration.diff --git a/tests/unit/test_pricing_documentation.py b/tests/unit/test_pricing_documentation.pydeleted file mode 100644index b4de07f0e1..0000000000--- a/tests/unit/test_pricing_documentation.py+++ /dev/null@@ -1,290 +0,0 @@-"""-Unit tests to verify pricing documentation consistency.-"""--import re-from pathlib import Path-from typing import Any--import pytest-import requests---class TestPricingDocumentation:- """Test class for pricing documentation consistency."""-- @pytest.fixture- def pricing_data(self) -> dict[str, Any]:- """Fetch pricing data from LiteLLM repository."""- url = 'https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json'- response = requests.get(url)- response.raise_for_status()- return response.json()-- @pytest.fixture- def openhands_models(self) -> list[str]:- """Get the list of OpenHands models from the codebase."""- # Read the models directly from the source code file- llm_utils_path = (- Path(__file__).parent.parent.parent / 'openhands' / 'utils' / 'llm.py'- )- content = llm_utils_path.read_text()-- # Extract the openhands_models list from the file- import ast-- # Parse the Python file- tree = ast.parse(content)-- # Find the openhands_models assignment- for node in ast.walk(tree):- if (- isinstance(node, ast.Assign)- and len(node.targets) == 1- and isinstance(node.targets[0], ast.Name)- and node.targets[0].id == 'openhands_models'- ):- # Extract the list values- if isinstance(node.value, ast.List):- models = []- for elt in node.value.elts:- if isinstance(elt, ast.Constant) and isinstance(elt.value, str):- # Remove 'openhands/' prefix and filter out secret models- model = elt.value- if model.startswith('openhands/'):- model = model[10:] # Remove 'openhands/' prefix- if not model.startswith('<secret'):- models.append(model)- return models-- # Fallback if parsing fails- raise ValueError('Could not extract openhands_models from llm.py')-- @pytest.fixture- def documentation_content(self) -> str:- """Read the OpenHands LLM documentation content."""- docs_path = (- Path(__file__).parent.parent.parent- / 'docs'- / 'usage'- / 'llms'- / 'openhands-llms.mdx'- )- return docs_path.read_text()-- def extract_pricing_from_docs(self, content: str) -> dict[str, dict[str, float]]:- """Extract pricing information from documentation."""- # Updated pattern to handle cached input cost column (which can be N/A)- pricing_table_pattern = (- r'\| ([^|]+) \| \$([0-9.]+) \| ([^|]+) \| \$([0-9.]+) \|'- )- matches = re.findall(pricing_table_pattern, content)-- pricing_data = {}- for match in matches:- model_name = match[0].strip()- input_cost = float(match[1])- cached_input_str = match[2].strip()- output_cost = float(match[3])-- # Parse cached input cost (can be N/A or $X.XX)- cached_input_cost = None- if cached_input_str != 'N/A':- cached_input_cost = float(cached_input_str.replace('$', ''))-- pricing_data[model_name] = {- 'input_cost_per_million_tokens': input_cost,- 'cached_input_cost_per_million_tokens': cached_input_cost,- 'output_cost_per_million_tokens': output_cost,- }-- return pricing_data-- def get_litellm_pricing(- self, model: str, pricing_data: dict[str, Any]- ) -> dict[str, float]:- """Get pricing for a model from LiteLLM data."""- # Try different variations of the model name- variations = [- model,- f'openai/{model}',- f'anthropic/{model}',- f'google/{model}',- f'mistral/{model}',- ]-- for variation in variations:- if variation in pricing_data:- model_data = pricing_data[variation]- result = {- 'input_cost_per_million_tokens': model_data.get(- 'input_cost_per_token', 0- )- * 1_000_000,- 'output_cost_per_million_tokens': model_data.get(- 'output_cost_per_token', 0- )- * 1_000_000,- }-- # Add cached input cost if available- cached_cost = model_data.get('cache_read_input_token_cost', 0)- if cached_cost > 0:- result['cached_input_cost_per_million_tokens'] = (- cached_cost * 1_000_000- )-- return result-- return {}-- def test_pricing_table_exists(self, documentation_content: str):- """Test that the pricing table exists in the documentation."""- assert (- '| Model | Input Cost (per 1M tokens) | Cached Input Cost (per 1M tokens) | Output Cost (per 1M tokens)'- in documentation_content- )- assert 'claude-opus-4-20250514' in documentation_content- assert 'qwen3-coder-480b' in documentation_content-- def test_no_external_json_link(self, documentation_content: str):- """Test that the external JSON link has been removed."""- assert (- 'github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json'- not in documentation_content- )-- def test_pricing_consistency_with_litellm(- self, pricing_data: dict[str, Any], documentation_content: str- ):- """Test that pricing in documentation matches LiteLLM data where applicable."""- docs_pricing = self.extract_pricing_from_docs(documentation_content)-- # Special case for qwen3-coder-480b (custom pricing)- qwen_pricing = docs_pricing.get('qwen3-coder-480b')- assert qwen_pricing is not None- assert qwen_pricing['input_cost_per_million_tokens'] == 0.4- assert qwen_pricing['output_cost_per_million_tokens'] == 1.6- assert qwen_pricing['cached_input_cost_per_million_tokens'] is None # N/A-- # Test other models against LiteLLM data- for model_name, doc_pricing in docs_pricing.items():- if model_name == 'qwen3-coder-480b':- continue # Skip custom pricing model-- litellm_pricing = self.get_litellm_pricing(model_name, pricing_data)-- if litellm_pricing: # Only test if we found pricing in LiteLLM- assert (- abs(- doc_pricing['input_cost_per_million_tokens']- - litellm_pricing['input_cost_per_million_tokens']- )- < 0.01- ), (- f'Input pricing mismatch for {model_name}: docs={doc_pricing["input_cost_per_million_tokens"]}, litellm={litellm_pricing["input_cost_per_million_tokens"]}'- )-- assert (- abs(- doc_pricing['output_cost_per_million_tokens']- - litellm_pricing['output_cost_per_million_tokens']- )- < 0.01- ), (- f'Output pricing mismatch for {model_name}: docs={doc_pricing["output_cost_per_million_tokens"]}, litellm={litellm_pricing["output_cost_per_million_tokens"]}'- )-- # Test cached input cost if both have it- doc_cached = doc_pricing.get('cached_input_cost_per_million_tokens')- litellm_cached = litellm_pricing.get(- 'cached_input_cost_per_million_tokens'- )-- if doc_cached is not None and litellm_cached is not None:- assert abs(doc_cached - litellm_cached) < 0.01, (- f'Cached input pricing mismatch for {model_name}: docs={doc_cached}, litellm={litellm_cached}'- )- elif doc_cached is None and litellm_cached is not None:- # Documentation shows N/A but LiteLLM has cached pricing - this might be intentional- pass- elif doc_cached is not None and litellm_cached is None:- # Documentation has cached pricing but LiteLLM doesn't - this shouldn't happen- raise AssertionError(- f'Documentation has cached pricing for {model_name} but LiteLLM does not'- )-- def test_all_openhands_models_documented(- self, openhands_models: list[str], documentation_content: str- ):- """Test that all OpenHands models are documented in the pricing table."""- docs_pricing = self.extract_pricing_from_docs(documentation_content)- documented_models = set(docs_pricing.keys())-- # Filter out models that might not have pricing (like kimi-k2-0711-preview)- expected_models = set(openhands_models)-- # Check that most models are documented (allowing for some models without pricing)- documented_count = len(documented_models.intersection(expected_models))- total_count = len(expected_models)-- # We should have at least 80% of models documented- coverage_ratio = documented_count / total_count if total_count > 0 else 0- assert coverage_ratio >= 0.8, (- f'Only {documented_count}/{total_count} models documented in pricing table'- )-- def test_model_list_consistency(- self, openhands_models: list[str], documentation_content: str- ):- """Test that the model list in documentation is consistent with the code."""- docs_pricing = self.extract_pricing_from_docs(documentation_content)- documented_models = set(docs_pricing.keys())- code_models = set(openhands_models)-- # Find models that are in code but not in docs- missing_from_docs = code_models - documented_models- # Find models that are in docs but not in code- extra_in_docs = documented_models - code_models-- # Allow some models to be missing from docs (e.g., if they don't have pricing)- # but no extra models should be in docs that aren't in code- assert not extra_in_docs, (- f'Models in documentation but not in code: {extra_in_docs}'- )-- # Report missing models for visibility (but don't fail the test)- if missing_from_docs:- print(f'Models in code but not documented: {missing_from_docs}')-- def test_pricing_format_consistency(self, documentation_content: str):- """Test that pricing format is consistent in the documentation."""- docs_pricing = self.extract_pricing_from_docs(documentation_content)-- for model_name, pricing in docs_pricing.items():- # Check that prices are reasonable (not negative, not extremely high)- assert pricing['input_cost_per_million_tokens'] >= 0, (- f'Negative input cost for {model_name}'- )- assert pricing['output_cost_per_million_tokens'] >= 0, (- f'Negative output cost for {model_name}'- )- assert pricing['input_cost_per_million_tokens'] <= 100, (- f'Unreasonably high input cost for {model_name}'- )- assert pricing['output_cost_per_million_tokens'] <= 200, (- f'Unreasonably high output cost for {model_name}'- )-- # Output cost should generally be higher than input cost- if pricing['input_cost_per_million_tokens'] > 0:- ratio = (- pricing['output_cost_per_million_tokens']- / pricing['input_cost_per_million_tokens']- )- assert ratio >= 1.0, (- f'Output cost should be >= input cost for {model_name}'- )- assert ratio <= 20.0, (- f'Output/input cost ratio too high for {model_name}'- )