feat: rename package and repo to opencode-a2a (#282)

Author: liujuanjuan1984

.github/workflows/ci.yml

@@ -49,10 +49,10 @@ jobs:
         run: uv build --no-sources
 
       - name: Smoke test built wheel
-        run: bash ./scripts/smoke_test_built_cli.sh dist/opencode_a2a_server-*.whl
+        run: bash ./scripts/smoke_test_built_cli.sh dist/opencode_a2a-*.whl
 
       - name: Smoke test built sdist
-        run: bash ./scripts/smoke_test_built_cli.sh dist/opencode_a2a_server-*.tar.gz
+        run: bash ./scripts/smoke_test_built_cli.sh dist/opencode_a2a-*.tar.gz
 
   runtime-matrix:
     runs-on: ubuntu-latest

.github/workflows/publish.yml

@@ -49,16 +49,16 @@ jobs:
           import pathlib
 
           dist_dir = pathlib.Path("dist")
-          wheels = sorted(dist_dir.glob("opencode_a2a_server-*.whl"))
-          sdists = sorted(dist_dir.glob("opencode_a2a_server-*.tar.gz"))
+          wheels = sorted(dist_dir.glob("opencode_a2a-*.whl"))
+          sdists = sorted(dist_dir.glob("opencode_a2a-*.tar.gz"))
           if len(wheels) != 1:
               raise SystemExit(f"Expected exactly one wheel in dist/, found {len(wheels)}")
           if len(sdists) != 1:
               raise SystemExit(f"Expected exactly one sdist in dist/, found {len(sdists)}")
           wheel = wheels[0].name
           sdist = sdists[0].name
-          version = wheel.removeprefix("opencode_a2a_server-").split("-py3", 1)[0]
-          sdist_version = sdist.removeprefix("opencode_a2a_server-").removesuffix(".tar.gz")
+          version = wheel.removeprefix("opencode_a2a-").split("-py3", 1)[0]
+          sdist_version = sdist.removeprefix("opencode_a2a-").removesuffix(".tar.gz")
           tag = os.environ["GITHUB_REF_NAME"].removeprefix("v")
           if version != tag:
               raise SystemExit(f"Wheel version {version!r} does not match tag {tag!r}")
@@ -68,10 +68,10 @@ jobs:
           PY
 
       - name: Smoke test wheel install
-        run: bash ./scripts/smoke_test_built_cli.sh dist/opencode_a2a_server-*.whl
+        run: bash ./scripts/smoke_test_built_cli.sh dist/opencode_a2a-*.whl
 
       - name: Smoke test sdist install
-        run: bash ./scripts/smoke_test_built_cli.sh dist/opencode_a2a_server-*.tar.gz
+        run: bash ./scripts/smoke_test_built_cli.sh dist/opencode_a2a-*.tar.gz
 
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1

.pre-commit-config.yaml

@@ -27,7 +27,7 @@ repos:
     hooks:
       - id: mypy
         name: mypy
-        entry: uv run mypy src/opencode_a2a_server
+        entry: uv run mypy src/opencode_a2a
         language: system
         pass_filenames: false
       - id: bash-n

CONTRIBUTING.md

@@ -1,8 +1,8 @@
 # Contributing
 
-Thanks for contributing to `opencode-a2a-server`.
+Thanks for contributing to `opencode-a2a`.
 
-This repository maintains an A2A adapter service around OpenCode. Changes
+This repository maintains an OpenCode A2A runtime. Changes
 should keep runtime behavior, Agent Card declarations, OpenAPI examples, and
 machine-readable extension contracts aligned.
 
@@ -32,13 +32,13 @@ Start OpenCode in one terminal:
 opencode serve --hostname 127.0.0.1 --port 4096
 ```
 
-Then start the A2A server in another terminal:
+Then start the A2A runtime in another terminal:
 
 ```bash
 A2A_BEARER_TOKEN=dev-token \
 OPENCODE_BASE_URL=http://127.0.0.1:4096 \
 OPENCODE_WORKSPACE_ROOT=/abs/path/to/workspace \
-uv run opencode-a2a-server serve
+uv run opencode-a2a serve
 ```
 
 ## Validation
@@ -63,7 +63,7 @@ contract surfaces, also run:
 
 ```bash
 uv run pytest tests/contracts/test_extension_contract_consistency.py
-uv run mypy src/opencode_a2a_server
+uv run mypy src/opencode_a2a
 ```
 
 ## Change Expectations
@@ -95,7 +95,7 @@ Keep compatibility guidance centralized in [docs/guide.md](docs/guide.md) unless
 new standalone document is clearly necessary.
 
 When changing extension contracts, update
-[`src/opencode_a2a_server/contracts/extensions.py`](src/opencode_a2a_server/contracts/extensions.py)
+[`src/opencode_a2a/contracts/extensions.py`](src/opencode_a2a/contracts/extensions.py)
 first and keep these generated/documented surfaces aligned:
 
 - Agent Card extension params

README.md

@@ -1,8 +1,8 @@
-# opencode-a2a-server
+# opencode-a2a
 
 > Expose OpenCode through A2A.
 
-`opencode-a2a-server` adds an A2A service layer to `opencode serve`, with
+`opencode-a2a` adds an A2A runtime layer to `opencode serve`, with
 auth, streaming, session continuity, interrupt handling, and a clear
 deployment boundary.
 
@@ -17,7 +17,7 @@ flowchart TD
     Client["a2a-client-hub / any A2A client"]
 
     subgraph ServerSide["Server-side"]
-        Adapter["opencode-a2a-server\nA2A adapter service"]
+        Adapter["opencode-a2a\nA2A adapter service"]
         Runtime["opencode serve\nOpenCode runtime"]
 
         Adapter <--> Runtime
@@ -31,13 +31,13 @@ flowchart TD
 Install the released CLI with `uv tool`:
 
 ```bash
-uv tool install opencode-a2a-server
+uv tool install opencode-a2a
 ```
 
 Upgrade later with:
 
 ```bash
-uv tool upgrade opencode-a2a-server
+uv tool upgrade opencode-a2a
 ```
 
 Make sure provider credentials and a default model are configured on the
@@ -49,7 +49,7 @@ opencode models
 opencode serve --hostname 127.0.0.1 --port 4096
 ```
 
-Then start `opencode-a2a-server` against that upstream:
+Then start `opencode-a2a` against that upstream:
 
 ```bash
 A2A_BEARER_TOKEN=dev-token \
@@ -59,7 +59,7 @@ A2A_PORT=8000 \
 A2A_PUBLIC_URL=http://127.0.0.1:8000 \
 A2A_STREAM_SSE_PING_SECONDS=15 \
 OPENCODE_WORKSPACE_ROOT=/abs/path/to/workspace \
-opencode-a2a-server serve
+opencode-a2a serve
 ```
 
 Verify that the service is up:

SECURITY.md

@@ -2,7 +2,7 @@
 
 ## Scope
 
-This repository wraps OpenCode as an A2A adapter service. It exposes A2A
+This repository wraps OpenCode as an A2A runtime. It exposes A2A
 HTTP+JSON and JSON-RPC interfaces, and adds authentication, task/session
 contracts, streaming, interrupt handling, and runtime guidance. It does not
 fully isolate upstream model credentials from OpenCode runtime behavior.
@@ -11,7 +11,7 @@ fully isolate upstream model credentials from OpenCode runtime behavior.
 
 - `A2A_BEARER_TOKEN` protects access to the A2A surface, but it is not a
   tenant-isolation boundary inside one deployed instance.
-- One `OpenCode + opencode-a2a-server` instance pair is treated as a
+- One `OpenCode + opencode-a2a` instance pair is treated as a
   single-tenant trust boundary by design.
 - Tenant isolation across consumers is expected to come from parameterized
   self-deployment.

docs/guide.md

@@ -19,7 +19,7 @@ JSON-RPC extension details; README stays at overview level.
 
 This section keeps only the protocol-relevant variables.
 For the full runtime variable catalog and defaults, see
-[`../src/opencode_a2a_server/config.py`](../src/opencode_a2a_server/config.py).
+[`../src/opencode_a2a/config.py`](../src/opencode_a2a/config.py).
 Deployment supervision is intentionally out of scope for this project; use your
 own process manager, container runtime, or host orchestration.
 
@@ -99,7 +99,7 @@ starting that upstream process:
 If your provider uses environment variables for auth, export them before
 starting `opencode serve`.
 
-Then start `opencode-a2a-server` against that explicit upstream URL:
+Then start `opencode-a2a` against that explicit upstream URL:
 
 ```bash
 OPENCODE_BASE_URL=http://127.0.0.1:4096 \
@@ -108,7 +108,7 @@ A2A_HOST=127.0.0.1 \
 A2A_PORT=8000 \
 A2A_PUBLIC_URL=http://127.0.0.1:8000 \
 OPENCODE_WORKSPACE_ROOT=/abs/path/to/workspace \
-opencode-a2a-server serve
+opencode-a2a serve
 ```
 
 ## Core Behavior
@@ -443,7 +443,7 @@ Consumer guidance:
 - Treat `metadata.shared.model` as request-scoped preference data rather than
   deployment configuration.
 - Provider auth and service-level model defaults belong to `opencode serve`,
-  not to `opencode-a2a-server`.
+  not to `opencode-a2a`.
 
 Minimal example:
 
@@ -856,7 +856,7 @@ If an SSE connection drops, use `GET /v1/tasks/{task_id}:subscribe` to re-subscr
 - Idempotency contract: repeated `tasks/cancel` on an already `canceled` task returns the current terminal task state without error.
 - Terminal subscribe contract: calling `subscribe` on a terminal task replays one terminal `Task` snapshot and then closes the stream.
 - These two semantics are also declared as machine-readable `service_behaviors` in the compatibility profile and wire contract extensions.
-- The service emits lightweight metric log records (`logger=opencode_a2a_server.execution.executor`):
+- The service emits lightweight metric log records (`logger=opencode_a2a.execution.executor`):
   - `a2a_stream_requests_total`
   - `a2a_stream_active` (`value=1` when a stream starts, `value=-1` when it closes)
   - `opencode_stream_retries_total`

pyproject.toml

@@ -3,9 +3,9 @@ requires = ["setuptools>=77", "setuptools-scm[toml]>=8"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "opencode-a2a-server"
+name = "opencode-a2a"
 dynamic = ["version"]
-description = "A2A wrapper service for opencode"
+description = "OpenCode A2A runtime"
 readme = "README.md"
 requires-python = ">=3.11"
 license = "Apache-2.0"
@@ -45,12 +45,12 @@ dev = [
 ]
 
 [project.scripts]
-opencode-a2a-server = "opencode_a2a_server.cli:main"
+opencode-a2a = "opencode_a2a.cli:main"
 
 [project.urls]
-Homepage = "https://github.com/Intelligent-Internet/opencode-a2a-server"
-Repository = "https://github.com/Intelligent-Internet/opencode-a2a-server"
-Issues = "https://github.com/Intelligent-Internet/opencode-a2a-server/issues"
+Homepage = "https://github.com/Intelligent-Internet/opencode-a2a"
+Repository = "https://github.com/Intelligent-Internet/opencode-a2a"
+Issues = "https://github.com/Intelligent-Internet/opencode-a2a/issues"
 
 [tool.ruff]
 line-length = 100
@@ -71,7 +71,7 @@ tag_regex = "^v?(?P<version>.+)$"
 
 [tool.mypy]
 python_version = "3.11"
-files = ["src/opencode_a2a_server"]
+files = ["src/opencode_a2a"]
 show_error_codes = true
 pretty = true
 warn_redundant_casts = true
@@ -80,4 +80,4 @@ check_untyped_defs = true
 warn_return_any = true
 
 [tool.pytest.ini_options]
-addopts = "--cov=src/opencode_a2a_server --cov-report=term-missing --cov-report=json:.coverage.json --cov-fail-under=90"
+addopts = "--cov=src/opencode_a2a --cov-report=term-missing --cov-report=json:.coverage.json --cov-fail-under=90"

scripts/check_coverage.py

@@ -7,10 +7,10 @@
 
 OVERALL_MINIMUM = 90.0
 PER_FILE_MINIMUMS = {
-    "src/opencode_a2a_server/execution/executor.py": 90.0,
-    "src/opencode_a2a_server/server/application.py": 90.0,
-    "src/opencode_a2a_server/jsonrpc/application.py": 85.0,
-    "src/opencode_a2a_server/opencode_upstream_client.py": 85.0,
+    "src/opencode_a2a/execution/executor.py": 90.0,
+    "src/opencode_a2a/server/application.py": 90.0,
+    "src/opencode_a2a/jsonrpc/application.py": 85.0,
+    "src/opencode_a2a/opencode_upstream_client.py": 85.0,
 }
 
 

scripts/smoke_test_built_cli.sh

@@ -33,7 +33,7 @@ artifact_path="${1:-${SMOKE_TEST_ARTIFACT_PATH:-${SMOKE_TEST_WHEEL_PATH:-}}}"
 
 if [[ -z "${artifact_path}" ]]; then
   shopt -s nullglob
-  wheel_paths=(dist/opencode_a2a_server-*.whl)
+  wheel_paths=(dist/opencode_a2a-*.whl)
   shopt -u nullglob
 
   if [[ "${#wheel_paths[@]}" -eq 0 ]]; then
@@ -92,7 +92,7 @@ bearer_token="smoke-test-token"
 A2A_BEARER_TOKEN="${bearer_token}" \
 A2A_PORT="${port}" \
 A2A_HOST="127.0.0.1" \
-"${tool_bin_dir}/opencode-a2a-server" >"${server_log}" 2>&1 &
+"${tool_bin_dir}/opencode-a2a" >"${server_log}" 2>&1 &
 server_pid="$!"
 
 health_url="http://127.0.0.1:${port}/health"