migrai 1.3.0__tar.gz

migrai-1.3.0/LICENSE

@@ -0,0 +1,30 @@
+Portions of this software are licensed as follows:
+* All content that resides under the enterprise/ directory is licensed under the license defined in "enterprise/LICENSE".
+* Content outside of the above mentioned directories or restrictions above is available under the MIT license as defined below.
+
+=====================
+
+The MIT License (MIT)
+
+Copyright © 2025
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the “Software”), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

migrai-1.3.0/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: migrai
+Version: 1.3.0
+Summary: MigrAI CLI and app server for AI-driven development
+License-Expression: MIT
+License-File: LICENSE
+Author: MigrAI
+Author-email: contato@migrai.com.br
+Requires-Python: >=3.12,<3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Provides-Extra: third-party-runtimes
+Requires-Dist: aiohttp (>=3.13.3)
+Requires-Dist: aioredis (>=2,<3)
+Requires-Dist: anthropic[vertex]
+Requires-Dist: anyio (==4.9)
+Requires-Dist: asyncpg (>=0.30)
+Requires-Dist: authlib (>=1.6.9)
+Requires-Dist: bashlex (>=0.18)
+Requires-Dist: boto3
+Requires-Dist: browsergym-core (==0.13.3)
+Requires-Dist: coredis (>=3.4,<5)
+Requires-Dist: croniter
+Requires-Dist: cryptography (>=46.0.5)
+Requires-Dist: daytona (==0.24.2) ; extra == "third-party-runtimes"
+Requires-Dist: deprecated
+Requires-Dist: deprecation (>=2.1)
+Requires-Dist: dirhash
+Requires-Dist: docker
+Requires-Dist: e2b-code-interpreter (>=2) ; extra == "third-party-runtimes"
+Requires-Dist: fastapi
+Requires-Dist: fastmcp (>=3,<4)
+Requires-Dist: google-api-python-client (>=2.164)
+Requires-Dist: google-auth (>=2.47)
+Requires-Dist: google-auth-httplib2
+Requires-Dist: google-auth-oauthlib
+Requires-Dist: google-cloud-aiplatform
+Requires-Dist: google-genai
+Requires-Dist: gspread (>=6.2.1)
+Requires-Dist: html2text
+Requires-Dist: httpx-aiohttp (>=0.1.8)
+Requires-Dist: ipywidgets (>=8.1.5)
+Requires-Dist: jinja2 (>=3.1.6)
+Requires-Dist: joblib
+Requires-Dist: json-repair
+Requires-Dist: jupyter-kernel-gateway
+Requires-Dist: kubernetes (>=33.1)
+Requires-Dist: langfuse (>=2.50)
+Requires-Dist: langgraph (>=0.3)
+Requires-Dist: langgraph-checkpoint-postgres (>=0.2)
+Requires-Dist: libtmux (>=0.46.2)
+Requires-Dist: limits (>=5.6)
+Requires-Dist: litellm (>=1.74.3)
+Requires-Dist: lmnr (>=0.7.20)
+Requires-Dist: mcp (>=1.25)
+Requires-Dist: memory-profiler (>=0.61)
+Requires-Dist: modal (>=0.66.26,<1.2) ; extra == "third-party-runtimes"
+Requires-Dist: numpy (<2.4)
+Requires-Dist: openai (==2.8)
+Requires-Dist: openhands-aci (==0.3.3)
+Requires-Dist: openhands-agent-server (==1.12)
+Requires-Dist: openhands-sdk (==1.12)
+Requires-Dist: openhands-tools (==1.12)
+Requires-Dist: opentelemetry-api (>=1.33.1)
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc (>=1.33.1)
+Requires-Dist: orjson (>=3.11.6)
+Requires-Dist: pathspec (>=0.12.1)
+Requires-Dist: pexpect
+Requires-Dist: pg8000 (>=1.31.5)
+Requires-Dist: pillow (>=12.1.1)
+Requires-Dist: playwright (>=1.55)
+Requires-Dist: poetry (>=2.1.2)
+Requires-Dist: prompt-toolkit (>=3.0.50)
+Requires-Dist: protobuf (>=5.29.6,<6)
+Requires-Dist: psutil
+Requires-Dist: pyasn1 (>=0.6.3)
+Requires-Dist: pybase62 (>=1)
+Requires-Dist: pydantic (>=2.11.9)
+Requires-Dist: pygithub (>=2.5)
+Requires-Dist: pyjwt (>=2.12)
+Requires-Dist: pylatexenc
+Requires-Dist: pypdf (>=6.9.1)
+Requires-Dist: python-docx
+Requires-Dist: python-dotenv
+Requires-Dist: python-frontmatter (>=1.1)
+Requires-Dist: python-jose[cryptography] (>=3.3)
+Requires-Dist: python-json-logger (>=3.2.1)
+Requires-Dist: python-keycloak (>=7.0.2,<8)
+Requires-Dist: python-multipart (>=0.0.22)
+Requires-Dist: python-pptx
+Requires-Dist: python-slugify (>=8.0.4,<9)
+Requires-Dist: python-socketio (>=5.14)
+Requires-Dist: pythonnet
+Requires-Dist: pyyaml (>=6.0.2)
+Requires-Dist: qtconsole (>=5.6.1)
+Requires-Dist: rapidfuzz (>=3.9)
+Requires-Dist: redis (>=5.2,<7)
+Requires-Dist: requests (>=2.32.5)
+Requires-Dist: runloop-api-client (==0.50) ; extra == "third-party-runtimes"
+Requires-Dist: sentry-sdk[fastapi] (>=2,<3)
+Requires-Dist: setuptools (>=78.1.1)
+Requires-Dist: shap (>=0.50)
+Requires-Dist: shellingham (>=1.5.4)
+Requires-Dist: slack-sdk (>=3.39)
+Requires-Dist: sqlalchemy[asyncio] (>=2.0.40)
+Requires-Dist: sse-starlette (>=3.0.2)
+Requires-Dist: starlette (>=0.49.1)
+Requires-Dist: stripe (>=14.1,<15)
+Requires-Dist: tenacity (>=8.5,<10)
+Requires-Dist: termcolor
+Requires-Dist: toml
+Requires-Dist: tornado (>=6.5.5)
+Requires-Dist: types-toml
+Requires-Dist: urllib3 (>=2.6.3)
+Requires-Dist: uvicorn
+Requires-Dist: whatthepatch (>=1.0.6)
+Requires-Dist: zope-interface (==7.2)
+Project-URL: Homepage, https://migrai.com.br
+Project-URL: Repository, https://github.com/brunohelius/migrai-agentic-coder
+Description-Content-Type: text/markdown
+
+<a name="readme-top"></a>
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/OpenHands/docs/main/openhands/static/img/logo.png" alt="Logo" width="200">
+  <h1 align="center" style="border-bottom: none">MigrAI: AI-Driven Development</h1>
+</div>
+
+
+<div align="center">
+  <a href="https://github.com/OpenHands/OpenHands/blob/main/LICENSE"><img src="https://img.shields.io/badge/LICENSE-MIT-20B2AA?style=for-the-badge" alt="MIT License"></a>
+  <a href="https://docs.google.com/spreadsheets/d/1wOUdFCMyY6Nt0AIqF705KN4JKOWgeI4wUGUP60krXXs/edit?gid=811504672#gid=811504672"><img src="https://img.shields.io/badge/SWEBench-77.6-00cc00?logoColor=FFE165&style=for-the-badge" alt="Benchmark Score"></a>
+  <br/>
+  <a href="https://docs.openhands.dev/sdk"><img src="https://img.shields.io/badge/Documentation-000?logo=googledocs&logoColor=FFE165&style=for-the-badge" alt="Check out the documentation"></a>
+  <a href="https://arxiv.org/abs/2511.03690"><img src="https://img.shields.io/badge/Paper-000?logoColor=FFE165&logo=arxiv&style=for-the-badge" alt="Tech Report"></a>
+
+
+  <!-- Keep these links. Translations will automatically update with the README. -->
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=de">Deutsch</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=es">Español</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=fr">français</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=ja">日本語</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=ko">한국어</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=pt">Português</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=ru">Русский</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=zh">中文</a>
+
+</div>
+
+<hr>
+
+🙌 Welcome to MigrAI, a [community](COMMUNITY.md) focused on AI-driven development. We’d love for you to [join us on Slack](https://dub.sh/openhands).
+
+There are a few ways to work with MigrAI:
+
+### MigrAI Software Agent SDK
+The SDK is a composable Python library that contains all of our agentic tech. It's the engine that powers everything else below.
+
+Define agents in code, then run them locally, or scale to 1000s of agents in the cloud.
+
+[Check out the docs](https://docs.openhands.dev/sdk) or [view the source](https://github.com/OpenHands/software-agent-sdk/)
+
+### MigrAI CLI
+The CLI is the easiest way to start using MigrAI. The experience will be familiar to anyone who has worked
+with e.g. Claude Code or Codex. Install it locally with `pipx install migrai`, authenticate with
+`migrai login --api-key <sua-chave>`, and then run `migrai "<sua tarefa>"`.
+
+[Check out the docs](https://docs.openhands.dev/openhands/usage/run-openhands/cli-mode) or view the source in this repo.
+
+### MigrAI Local GUI
+Use the Local GUI for running agents on your laptop. It comes with a REST API and a single-page React application.
+The experience will be familiar to anyone who has used Devin or Jules.
+
+[Check out the docs](https://docs.openhands.dev/openhands/usage/run-openhands/local-setup) or view the source in this repo.
+
+### MigrAI Cloud
+This is a deployment of MigrAI GUI, running on hosted infrastructure.
+
+You can try it with a free $10 credit by [signing in with your GitHub or GitLab account](https://app.all-hands.dev).
+
+MigrAI Cloud comes with source-available features and integrations:
+- Integrations with Slack, Jira, and Linear
+- Multi-user support
+- RBAC and permissions
+- Collaboration features (e.g., conversation sharing)
+
+### MigrAI Enterprise
+Large enterprises can work with us to self-host MigrAI Cloud in their own VPC, via Kubernetes.
+MigrAI Enterprise can also work with the CLI and SDK above.
+
+MigrAI Enterprise is source-available--you can see all the source code here in the enterprise/ directory,
+but you'll need to purchase a license if you want to run it for more than one month.
+
+Enterprise contracts also come with extended support and access to our research team.
+
+Learn more at [openhands.dev/enterprise](https://openhands.dev/enterprise)
+
+### Everything Else
+
+Check out our [Product Roadmap](https://github.com/orgs/openhands/projects/1), and feel free to
+[open up an issue](https://github.com/OpenHands/OpenHands/issues) if there's something you'd like to see!
+
+You might also be interested in our [evaluation infrastructure](https://github.com/OpenHands/benchmarks), our [chrome extension](https://github.com/OpenHands/openhands-chrome-extension/), or our [Theory-of-Mind module](https://github.com/OpenHands/ToM-SWE).
+
+All our work is available under the MIT license, except for the `enterprise/` directory in this repository (see the [enterprise license](enterprise/LICENSE) for details).
+The core `openhands` and `agent-server` Docker images are fully MIT-licensed as well.
+
+If you need help with anything, or just want to chat, [come find us on Slack](https://dub.sh/openhands).
+

migrai-1.3.0/README.md

@@ -0,0 +1,87 @@
+<a name="readme-top"></a>
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/OpenHands/docs/main/openhands/static/img/logo.png" alt="Logo" width="200">
+  <h1 align="center" style="border-bottom: none">MigrAI: AI-Driven Development</h1>
+</div>
+
+
+<div align="center">
+  <a href="https://github.com/OpenHands/OpenHands/blob/main/LICENSE"><img src="https://img.shields.io/badge/LICENSE-MIT-20B2AA?style=for-the-badge" alt="MIT License"></a>
+  <a href="https://docs.google.com/spreadsheets/d/1wOUdFCMyY6Nt0AIqF705KN4JKOWgeI4wUGUP60krXXs/edit?gid=811504672#gid=811504672"><img src="https://img.shields.io/badge/SWEBench-77.6-00cc00?logoColor=FFE165&style=for-the-badge" alt="Benchmark Score"></a>
+  <br/>
+  <a href="https://docs.openhands.dev/sdk"><img src="https://img.shields.io/badge/Documentation-000?logo=googledocs&logoColor=FFE165&style=for-the-badge" alt="Check out the documentation"></a>
+  <a href="https://arxiv.org/abs/2511.03690"><img src="https://img.shields.io/badge/Paper-000?logoColor=FFE165&logo=arxiv&style=for-the-badge" alt="Tech Report"></a>
+
+
+  <!-- Keep these links. Translations will automatically update with the README. -->
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=de">Deutsch</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=es">Español</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=fr">français</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=ja">日本語</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=ko">한국어</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=pt">Português</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=ru">Русский</a> |
+  <a href="https://www.readme-i18n.com/OpenHands/OpenHands?lang=zh">中文</a>
+
+</div>
+
+<hr>
+
+🙌 Welcome to MigrAI, a [community](COMMUNITY.md) focused on AI-driven development. We’d love for you to [join us on Slack](https://dub.sh/openhands).
+
+There are a few ways to work with MigrAI:
+
+### MigrAI Software Agent SDK
+The SDK is a composable Python library that contains all of our agentic tech. It's the engine that powers everything else below.
+
+Define agents in code, then run them locally, or scale to 1000s of agents in the cloud.
+
+[Check out the docs](https://docs.openhands.dev/sdk) or [view the source](https://github.com/OpenHands/software-agent-sdk/)
+
+### MigrAI CLI
+The CLI is the easiest way to start using MigrAI. The experience will be familiar to anyone who has worked
+with e.g. Claude Code or Codex. Install it locally with `pipx install migrai`, authenticate with
+`migrai login --api-key <sua-chave>`, and then run `migrai "<sua tarefa>"`.
+
+[Check out the docs](https://docs.openhands.dev/openhands/usage/run-openhands/cli-mode) or view the source in this repo.
+
+### MigrAI Local GUI
+Use the Local GUI for running agents on your laptop. It comes with a REST API and a single-page React application.
+The experience will be familiar to anyone who has used Devin or Jules.
+
+[Check out the docs](https://docs.openhands.dev/openhands/usage/run-openhands/local-setup) or view the source in this repo.
+
+### MigrAI Cloud
+This is a deployment of MigrAI GUI, running on hosted infrastructure.
+
+You can try it with a free $10 credit by [signing in with your GitHub or GitLab account](https://app.all-hands.dev).
+
+MigrAI Cloud comes with source-available features and integrations:
+- Integrations with Slack, Jira, and Linear
+- Multi-user support
+- RBAC and permissions
+- Collaboration features (e.g., conversation sharing)
+
+### MigrAI Enterprise
+Large enterprises can work with us to self-host MigrAI Cloud in their own VPC, via Kubernetes.
+MigrAI Enterprise can also work with the CLI and SDK above.
+
+MigrAI Enterprise is source-available--you can see all the source code here in the enterprise/ directory,
+but you'll need to purchase a license if you want to run it for more than one month.
+
+Enterprise contracts also come with extended support and access to our research team.
+
+Learn more at [openhands.dev/enterprise](https://openhands.dev/enterprise)
+
+### Everything Else
+
+Check out our [Product Roadmap](https://github.com/orgs/openhands/projects/1), and feel free to
+[open up an issue](https://github.com/OpenHands/OpenHands/issues) if there's something you'd like to see!
+
+You might also be interested in our [evaluation infrastructure](https://github.com/OpenHands/benchmarks), our [chrome extension](https://github.com/OpenHands/openhands-chrome-extension/), or our [Theory-of-Mind module](https://github.com/OpenHands/ToM-SWE).
+
+All our work is available under the MIT license, except for the `enterprise/` directory in this repository (see the [enterprise license](enterprise/LICENSE) for details).
+The core `openhands` and `agent-server` Docker images are fully MIT-licensed as well.
+
+If you need help with anything, or just want to chat, [come find us on Slack](https://dub.sh/openhands).

migrai-1.3.0/openhands/README.md

@@ -0,0 +1,54 @@
+# MigrAI Architecture
+
+This directory contains the core components of MigrAI.
+
+For an overview of the system architecture, see the [architecture documentation](https://docs.openhands.dev/usage/architecture/backend) (v0 backend architecture).
+
+## Classes
+
+The key classes in MigrAI are:
+
+* LLM: brokers all interactions with large language models. Works with any underlying completion model, thanks to LiteLLM.
+* Agent: responsible for looking at the current State, and producing an Action that moves one step closer toward the end-goal.
+* AgentController: initializes the Agent, manages State, and drive the main loop that pushes the Agent forward, step by step
+* State: represents the current state of the Agent's task. Includes things like the current step, a history of recent events, the Agent's long-term plan, etc
+* EventStream: a central hub for Events, where any component can publish Events, or listen for Events published by other components
+  * Event: an Action or Observeration
+      * Action: represents a request to e.g. edit a file, run a command, or send a message
+      * Observation: represents information collected from the environment, e.g. file contents or command output
+* Runtime: responsible for performing Actions, and sending back Observations
+    * Sandbox: the part of the runtime responsible for running commands, e.g. inside of Docker
+* Server: brokers MigrAI sessions over HTTP, e.g. to drive the frontend
+    * Session: holds a single EventStream, a single AgentController, and a single Runtime. Generally represents a single task (but potentially including several user prompts)
+    * ConversationManager: keeps a list of active sessions, and ensures requests are routed to the correct Session
+
+## Control Flow
+
+Here's the basic loop (in pseudocode) that drives agents.
+
+```python
+while True:
+  prompt = agent.generate_prompt(state)
+  response = llm.completion(prompt)
+  action = agent.parse_response(response)
+  observation = runtime.run(action)
+  state = state.update(action, observation)
+```
+
+In reality, most of this is achieved through message passing, via the EventStream.
+The EventStream serves as the backbone for all communication in MigrAI.
+
+```mermaid
+flowchart LR
+  Agent--Actions-->AgentController
+  AgentController--State-->Agent
+  AgentController--Actions-->EventStream
+  EventStream--Observations-->AgentController
+  Runtime--Observations-->EventStream
+  EventStream--Actions-->Runtime
+  Frontend--Actions-->EventStream
+```
+
+## Runtime
+
+Please refer to the [documentation](https://docs.openhands.dev/usage/architecture/runtime) to learn more about `Runtime`.

migrai-1.3.0/openhands/__init__.py

@@ -0,0 +1,9 @@
+# This is a namespace package - extend the path to include installed packages
+# (We need to do this to support dependencies openhands-sdk, openhands-tools and openhands-agent-server
+# which all have a top level `openhands`` package.)
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)
+
+# Import version information for backward compatibility
+from openhands.version import __version__, get_version
+
+__all__ = ['__version__', 'get_version']

migrai-1.3.0/openhands/agenthub/README.md

@@ -0,0 +1,142 @@
+# Agent Hub
+
+In this folder, there may exist multiple implementations of `Agent` that will be used by the framework.
+
+For example, `openhands/agenthub/codeact_agent`, etc.
+Contributors from different backgrounds and interests can choose to contribute to any (or all!) of these directions.
+
+## Constructing an Agent
+
+The abstraction for an agent can be found [here](../controller/agent.py).
+
+Agents are run inside of a loop. At each iteration, `agent.step()` is called with a
+[State](../controller/state/state.py) input, and the agent must output an [Action](../events/action).
+
+Every agent also has a `self.llm` which it can use to interact with the LLM configured by the user.
+See the [LiteLLM docs for `self.llm.completion`](https://docs.litellm.ai/docs/completion).
+
+## State
+
+The `state` represents the running state of an agent in the MigrAI system. The class handles saving and restoring the agent session. It is serialized in a pickle.
+
+The State object stores information about:
+
+* Multi-agent state / delegates:
+  * the 'root task' (conversation between the agent and the user)
+  * the subtask (conversation between an agent and the user or another agent)
+  * global and local iterations
+  * delegate levels for multi-agent interactions
+  * almost stuck state
+* Running state of an agent:
+  * current agent state (e.g., LOADING, RUNNING, PAUSED)
+  * traffic control state for rate limiting
+  * confirmation mode
+  * the last error encountered
+* History:
+  * start and end IDs for events in agent's history. This allows to retrieve the actions taken by the agent, and observations (e.g. file content, command output) from the current or past sessions.
+* Metrics:
+  * global metrics for the current task
+  * local metrics for the current subtask
+* Extra data:
+  * additional task-specific data
+
+The agent can add and modify subtasks through the `AddTaskAction` and `ModifyTaskAction`
+
+## Actions
+
+Here is a list of available Actions, which can be returned by `agent.step()`:
+
+- [`CmdRunAction`](../events/action/commands.py) - Runs a command inside a sandboxed terminal
+- [`IPythonRunCellAction`](../events/action/commands.py) - Execute a block of Python code interactively (in Jupyter notebook) and receives `CmdOutputObservation`. Requires setting up `jupyter` [plugin](../runtime/plugins) as a requirement.
+- [`FileReadAction`](../events/action/files.py) - Reads the content of a file
+- [`FileWriteAction`](../events/action/files.py) - Writes new content to a file
+- [`BrowseURLAction`](../events/action/browse.py) - Gets the content of a URL
+- [`AddTaskAction`](../events/action/tasks.py) - Adds a subtask to the plan
+- [`ModifyTaskAction`](../events/action/tasks.py) - Changes the state of a subtask.
+- [`AgentFinishAction`](../events/action/agent.py) - Stops the control loop, allowing the user/delegator agent to enter a new task
+- [`AgentRejectAction`](../events/action/agent.py) - Stops the control loop, allowing the user/delegator agent to enter a new task
+- [`AgentFinishAction`](../events/action/agent.py) - Stops the control loop, allowing the user to enter a new task
+- [`MessageAction`](../events/action/message.py) - Represents a message from an agent or the user
+
+To serialize and deserialize an action, you can use:
+- `action.to_dict()` to serialize the action to a dictionary to be sent to the UI, including a user-friendly string representation of the message
+- `action.to_memory()` to serialize the action to a dictionary to be sent to the LLM. It may include raw information, such as the underlying exceptions that occurred during the action execution.
+- `action_from_dict(action_dict)` to deserialize the action from a dictionary.
+
+## Observations
+
+There are also several types of Observations. These are typically available in the step following the corresponding Action.
+But they may also appear as a result of asynchronous events (e.g. a message from the user).
+
+Here is a list of available Observations:
+
+- [`CmdOutputObservation`](../events/observation/commands.py)
+- [`BrowserOutputObservation`](../events/observation/browse.py)
+- [`FileReadObservation`](../events/observation/files.py)
+- [`FileWriteObservation`](../events/observation/files.py)
+- [`ErrorObservation`](../events/observation/error.py)
+- [`SuccessObservation`](../events/observation/success.py)
+
+You can use `observation.to_dict()` and `observation_from_dict` to serialize and deserialize observations.
+
+## Interface
+
+Every agent must implement the following methods:
+
+### `step`
+
+```
+def step(self, state: "State") -> "Action"
+```
+
+`step` moves the agent forward one step towards its goal. This probably means
+sending a prompt to the LLM, then parsing the response into an `Action`.
+
+## Agent Delegation
+
+MigrAI is a multi-agentic system. Agents can delegate tasks to other agents, whether
+prompted by the user, or when the agent decides to ask another agent for help. For example,
+the `CodeActAgent` might delegate to the `BrowsingAgent` to answer questions that involve browsing
+the web. The Delegator Agent forwards tasks to micro-agents, such as 'RepoStudyAgent' to study a repo,
+or 'VerifierAgent' to verify a task completion.
+
+### Understanding the terminology
+
+A `task` is an end-to-end conversation between MigrAI (the whole system) and the user,
+which might involve one or more inputs from the user. It starts with an initial input
+(typically a task statement) from the user, and ends with either an `AgentFinishAction`
+initiated by the agent, a stop initiated by the user, or an error.
+
+A `subtask` is an end-to-end conversation between an agent and the user, or
+another agent. If a `task` is conducted by a single agent, then it's also a `subtask`
+itself. Otherwise, a `task` consists of multiple `subtasks`, each executed by
+one agent.
+
+For example, considering a task from the user: `tell me how many GitHub stars
+MigrAI repo has`. Let's assume the default agent is CodeActAgent.
+
+```
+-- TASK STARTS (SUBTASK 0 STARTS) --
+
+DELEGATE_LEVEL 0, ITERATION 0, LOCAL_ITERATION 0
+CodeActAgent: I should request help from BrowsingAgent
+
+-- DELEGATE STARTS (SUBTASK 1 STARTS) --
+
+DELEGATE_LEVEL 1, ITERATION 1, LOCAL_ITERATION 0
+BrowsingAgent: Let me find the answer on GitHub
+
+DELEGATE_LEVEL 1, ITERATION 2, LOCAL_ITERATION 1
+BrowsingAgent: I found the answer, let me convey the result and finish
+
+-- DELEGATE ENDS (SUBTASK 1 ENDS) --
+
+DELEGATE_LEVEL 0, ITERATION 3, LOCAL_ITERATION 1
+CodeActAgent: I got the answer from BrowsingAgent, let me convey the result
+and finish
+
+-- TASK ENDS (SUBTASK 0 ENDS) --
+```
+
+Note how ITERATION counter is shared across agents, while LOCAL_ITERATION
+is local to each subtask.

migrai-1.3.0/openhands/agenthub/__init__.py

@@ -0,0 +1,24 @@
+from dotenv import load_dotenv
+
+load_dotenv()
+
+
+from openhands.agenthub import (  # noqa: E402
+    browsing_agent,
+    codeact_agent,
+    dummy_agent,
+    loc_agent,
+    readonly_agent,
+    visualbrowsing_agent,
+)
+from openhands.controller.agent import Agent  # noqa: E402
+
+__all__ = [
+    'Agent',
+    'codeact_agent',
+    'dummy_agent',
+    'browsing_agent',
+    'visualbrowsing_agent',
+    'readonly_agent',
+    'loc_agent',
+]

migrai-1.3.0/openhands/agenthub/browsing_agent/README.md

@@ -0,0 +1,16 @@
+# Browsing Agent Framework
+
+This folder implements the basic BrowserGym [demo agent](https://github.com/ServiceNow/BrowserGym/tree/main/demo_agent) that enables full-featured web browsing.
+
+
+## Test run
+
+Note that for browsing tasks, GPT-4 is usually a requirement to get reasonable results, due to the complexity of the web page structures.
+
+```
+poetry run python ./openhands/core/main.py \
+           -i 10 \
+           -t "tell me the usa's president using google search" \
+           -c BrowsingAgent \
+           -m claude-3-5-sonnet-20241022
+```

migrai-1.3.0/openhands/agenthub/browsing_agent/__init__.py

@@ -0,0 +1,4 @@
+from openhands.agenthub.browsing_agent.browsing_agent import BrowsingAgent
+from openhands.controller.agent import Agent
+
+Agent.register('BrowsingAgent', BrowsingAgent)