@rajeshvelicheti any chance I could grab you to take a look at this before too many more conflicts arise with samples getting added?

This will also allow us to start writing tests as well as a Python A2A tutorial

Rebased and made changes to make this PR work again after the PRs that have been merged to main in the meantime.

Test Plan:

• Run all agents via uv run . in their respective directories.
• Run the cli via uv run google-a2a-cli from /samples/python

Rebased and retested.

Here's the full description of changes

Steps

Move files

mkdir src
mkdir src/google_a2a
git mv -f common src/google_a2a
git mv -f hosts src/google_a2a
git mv -f agents src/google_a2a

Update pyproject.toml

[project]
name = "google-a2a"
description = "Agent2Agent modules and samples"

[tool.hatch.build.targets.wheel]
packages = ["src/google_a2a"]

[tool.uv.workspace]
members = [
    "src/google_a2a/agents/crewai",
    "src/google_a2a/agents/google_adk",
    "src/google_a2a/agents/langgraph",
    "src/google_a2a/hosts/cli",
    "src/google_a2a/hosts/multiagent",
    "src/google_a2a/agents/llama_index_file_chat",
    "src/google_a2a/agents/semantickernel",
]

Replace imports

find src -name '*.py' -exec sed -i 's/^import common/import google_a2a.common/' {} +
find src -name '*.py' -exec sed -i 's/^import hosts/import google_a2a.hosts/' {} +
find src -name '*.py' -exec sed -i 's/^import agents/import google_a2a.agents/' {} +
find src -name '*.py' -exec sed -i 's/^from common/from google_a2a.common/' {} +
find src -name '*.py' -exec sed -i 's/^from agents/from google_a2a.agents/' {} +
find src -name '*.py' -exec sed -i 's/^from hosts/from google_a2a.hosts/' {} +

• Double check (note: some manual fixups may be needed due to spaces)

git grep -n -i "import common"
git grep -n -i "import hosts"
git grep -n -i "import agents"
git grep -n -i "from common"
git grep -n -i "from hosts"
git grep -n -i "from agents"

Replace references

find . -name '*.md' -exec sed -i 's,/samples/python/common,/samples/python/src/google_a2a/common,' {} +
find . -name '*.txt' -exec sed -i 's,/samples/python/common,/samples/python/src/google_a2a/common,' {} +
find . -name '*.md' -exec sed -i 's,/samples/python/hosts,/samples/python/src/google_a2a/hosts,' {} +
find . -name '*.txt' -exec sed -i 's,/samples/python/hosts,/samples/python/src/google_a2a/hosts,' {} +
find . -name '*.md' -exec sed -i 's,/samples/python/agents,/samples/python/src/google_a2a/agents,' {} +
find . -name '*.txt' -exec sed -i 's,/samples/python/agents,/samples/python/src/google_a2a/agents,' {} +

Replace a2a-samples

find . -name '*.pyproject.toml' -exec sed -i 's/a2a-samples/google-a2a/' {} +

git grep -n -i a2a-samples

Create quickstart example

• See the Python tutorial

## Quickstart
1. Install google-a2a
    ```bash
    pip install git+https://github.com/google/A2A.git#subdirectory=samples/python
    ```
2. Implement your task manager
    ```python
    import typing
    import google_a2a
    import google_a2a.common
    import google_a2a.common.server
    import google_a2a.common.server.task_manager
    import google_a2a.common.types
    class MyTaskManager(google_a2a.common.server.task_manager.InMemoryTaskManager):
        def __init__(
            self,
        ):
            super().__init__()
        async def on_send_task(
            self,
            request: google_a2a.common.types.SendTaskRequest
        ) -> google_a2a.common.types.SendTaskResponse:
            """
            This method queries or creates a task for the agent.
            The caller will receive exactly one response.
            """
            pass

        async def on_send_task_subscribe(
            self,
            request: google_a2a.common.types.SendTaskStreamingRequest
        ) -> typing.AsyncInterable[google_a2a.common.types.SendTaskStreamingResponse] | google_a2a.common.types.JSONRPCResponse:
            """
            This method subscribes the caller to future updates regarding a task.
            The caller will receive a response and additionally receive subscription
            updates over a session established between the client and the server
            """
            pass

    ```
3. Run a server
    ```python
    import google_a2a
    import google_a2a.common
    import google_a2a.common.server
    import google_a2a.common.types
    def main():
        # See examples
        server = google_a2a.common.server.A2AServer(
            # Fill in parameters
            task_manager=MyTaskManager(),
        )
        server.start()
    ```

Expose cli as a script

[project.scripts]
google-a2a-cli = "google_a2a.hosts.cli.__main__:main"

• hosts/cli/main.py

def main():
    asyncio.run(cli())


if __name__ == "__main__":
    main()

Test Plan

• Run uv run . in each folder of /samples/python/src/google_a2a/agents
• Run uv run . in /samples/python/src/google_a2a/hosts/cli
• Run uv run google-a2a-cli in /samples/python
• Follow the python tutorial and ensure imports work correctly

if this isn't merged in - the tutorial doesn't line up yet right? https://google.github.io/A2A/tutorials/python/7-interact-with-server/

I'm trying to run the cli from the my-project folder instead of having to pull the entire repo down.

if this isn't merged in - the tutorial doesn't line up yet right? https://google.github.io/A2A/tutorials/python/7-interact-with-server/

I'm trying to run the cli from the my-project folder instead of having to pull the entire repo down.

Interesting - it was originally mentioned in the tutorial but now has overwritten https://github.com/google/A2A/pull/202/files#diff-1e612e5d30745859d2821e04adb1bd652320e755b78a814c2d24db71301cd0b4R37

The git history for the gh-pages branch also got force rewritten 😥

anything blocking a review here?
It would be quite useful for people building stuff downstream

See #423 for updates on official A2A SDK launch

anything blocking a review here? It would be quite useful for people building stuff downstream

@djsamseng Thank you for this contribution, however much of it won't be needed going forward once the official SDK is released. There is an early version of it in a2a-python-sdk/ but this will soon be moved to its own repository and published on pypi.

This PR is no longer needed due to the Python SDK being published.