@tbrandenburg/opencode-a2a-lite 0.2.6 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +36 -22
- package/dist/package.json +3 -2
- package/dist/src/cli.js +1 -1
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -5,10 +5,10 @@
|
|
|
5
5
|
[](https://github.com/tbrandenburg/opencode-a2a-lite/actions/workflows/ci.yml)
|
|
6
6
|
[](https://github.com/tbrandenburg/opencode-a2a-lite/releases/latest)
|
|
7
7
|
[](LICENSE)
|
|
8
|
-

|
|
8
|
+

|
|
9
9
|

|
|
10
10
|
|
|
11
|
-
A small OpenCode ACP → A2A 1.0 gateway for trusted
|
|
11
|
+
A small OpenCode ACP → A2A 1.0 gateway for trusted workspaces: point any A2A
|
|
12
12
|
client at it and it drives OpenCode. It uses the official A2A and ACP SDKs: OpenCode
|
|
13
13
|
owns coding-session behavior, the gateway translates plain-text tasks, streamed output
|
|
14
14
|
and context continuity.
|
|
@@ -36,14 +36,17 @@ A2A client ──HTTP/SSE──▶ opencode-a2a-lite ──ACP (stdio)──▶
|
|
|
36
36
|
|
|
37
37
|
## Quick start
|
|
38
38
|
|
|
39
|
+
Run it from any directory outside a checkout of this repository:
|
|
40
|
+
|
|
39
41
|
```sh
|
|
40
|
-
|
|
41
|
-
make check # format, lint, typecheck, deterministic tests, build
|
|
42
|
-
bun src/cli.ts --workspace /absolute/path/to/trusted/workspace --port 0
|
|
42
|
+
npx --yes @tbrandenburg/opencode-a2a-lite@latest --workspace /absolute/path/to/trusted/workspace --port 0
|
|
43
43
|
```
|
|
44
44
|
|
|
45
|
-
|
|
46
|
-
|
|
45
|
+
This starts a **gateway server** on `127.0.0.1` and launches `opencode` as a child
|
|
46
|
+
process over ACP in that workspace. It does not run any task by itself: OpenCode only
|
|
47
|
+
works when an A2A client sends a prompt. Wait for a JSON stdout record such as
|
|
48
|
+
`{"ready":true,"url":"http://127.0.0.1:.../"}`, then in a second terminal use the
|
|
49
|
+
**actual** URL (default port 41241):
|
|
47
50
|
|
|
48
51
|
```sh
|
|
49
52
|
a2a card get http://127.0.0.1:41241
|
|
@@ -56,17 +59,22 @@ SIGINT/SIGTERM.
|
|
|
56
59
|
|
|
57
60
|
## Requirements
|
|
58
61
|
|
|
59
|
-
- Linux, **Bun 1.4.4**, and stable
|
|
60
|
-
(live acceptance recorded on
|
|
62
|
+
- Linux, or macOS for experimental gateway use, **Bun 1.4.4**, and stable
|
|
63
|
+
**`opencode` v2.2.7 or newer** on `PATH` (full live acceptance recorded on
|
|
64
|
+
Linux with 2.2.7; a two-turn macOS live demo passed with 2.3.0).
|
|
61
65
|
- An explicitly trusted workspace and reviewed OpenCode provider, model, tools,
|
|
62
66
|
plugins, MCP servers and configuration.
|
|
63
67
|
- The separate [official A2A CLI](https://github.com/a2aproject/a2a-cli)
|
|
64
|
-
(tested with 0.3.1) to talk to the running gateway.
|
|
68
|
+
(tested with 0.3.1 on Linux and 0.4.0 in the macOS demo) to talk to the running gateway.
|
|
65
69
|
|
|
66
70
|
Runtime security and compatibility evidence is tracked for
|
|
67
71
|
[Bun](docs/bun-runtime-security.md) and [OpenCode](docs/opencode-runtime-upgrade.md).
|
|
68
72
|
Standalone Bun and OpenCode's embedded runtime are separate upgrade boundaries;
|
|
69
73
|
historical acceptance results do not establish compatibility of a new pair.
|
|
74
|
+
macOS package installation requires a release containing the `darwin` package
|
|
75
|
+
manifest entry; older published versions remain Linux-only. The isolated `make demo`
|
|
76
|
+
also supports macOS, but the full live acceptance suite, guarded MCP and team
|
|
77
|
+
launcher still use Linux-specific tooling.
|
|
70
78
|
|
|
71
79
|
## Usage
|
|
72
80
|
|
|
@@ -86,16 +94,11 @@ use `make dev` for development.
|
|
|
86
94
|
|
|
87
95
|
### Package distribution
|
|
88
96
|
|
|
89
|
-
`@tbrandenburg/opencode-a2a-lite` is published on npm
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
npx
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
The package requires Node.js 22 or newer to use `npx`, plus Bun 1.4.4 and
|
|
97
|
-
OpenCode 2.2.7 or newer on `PATH`. `bunx` can be used instead of `npx` where Bun
|
|
98
|
-
is installed. See [distribution and release policy](docs/distribution.md) for
|
|
97
|
+
`@tbrandenburg/opencode-a2a-lite` is published on npm (see [Quick start](#quick-start)).
|
|
98
|
+
Pin a version with `@x.y.z` instead of `@latest`. The package requires Node.js 22 or
|
|
99
|
+
newer to use `npx`, plus Bun 1.4.4 and OpenCode 2.2.7 or newer on `PATH`. `bunx` can
|
|
100
|
+
be used instead of `npx` where Bun is installed. Inside a checkout of this repository
|
|
101
|
+
`npx` can fail with `opencode-a2a-lite: not found`; run it from another directory. See [distribution and release policy](docs/distribution.md) for
|
|
99
102
|
verification scope and release details.
|
|
100
103
|
|
|
101
104
|
## Behavior and limitations
|
|
@@ -125,10 +128,19 @@ and runtime-selected workspaces are not claimed.
|
|
|
125
128
|
|
|
126
129
|
## Development
|
|
127
130
|
|
|
131
|
+
Run from source:
|
|
132
|
+
|
|
133
|
+
```sh
|
|
134
|
+
make install # frozen Bun lockfile
|
|
135
|
+
make check # format, lint, typecheck, deterministic tests, build
|
|
136
|
+
bun src/cli.ts --workspace /absolute/path/to/trusted/workspace --port 0
|
|
137
|
+
```
|
|
138
|
+
|
|
128
139
|
| Command | Purpose |
|
|
129
140
|
| ---------------------------------------------------------------------- | -------------------------------------------------------------------- |
|
|
130
141
|
| `make check` | Formatting, lint, strict types, deterministic regressions, build |
|
|
131
142
|
| `make package-smoke` | Installed-tarball and subprocess lifecycle checks, without provider |
|
|
143
|
+
| `make runtime-smoke` | Isolated gateway and real OpenCode startup, without a model prompt |
|
|
132
144
|
| `A2ABRIDGE_BIN=/absolute/path/to/verified/a2abridge make interop-test` | Pinned, provider-free guarded MCP/bridge/gateway acceptance |
|
|
133
145
|
| `make demo` | Isolated official A2A CLI two-turn smoke (**live, billable**) |
|
|
134
146
|
| `make e2e` | Production live-model acceptance (**live, billable**) |
|
|
@@ -136,9 +148,11 @@ and runtime-selected workspaces are not claimed.
|
|
|
136
148
|
| `make release BUMP=patch` | Check, commit and push tag for npm publication and a GitHub release. |
|
|
137
149
|
| `make clean` | Remove build, coverage and test results |
|
|
138
150
|
|
|
139
|
-
CI
|
|
140
|
-
|
|
151
|
+
CI is configured to check core deterministic tests and installed packaging on Linux and macOS;
|
|
152
|
+
the provider-free team launcher fixtures and checksummed MCP bridge run on Linux.
|
|
153
|
+
Live demo/E2E are explicit manual commands requiring a provider key,
|
|
141
154
|
OpenCode and the official A2A CLI; `make demo` also needs `jq` and GNU `timeout`.
|
|
155
|
+
On macOS its isolated workspace cleanup additionally uses `/usr/sbin/lsof`.
|
|
142
156
|
For the exact live evidence/limitations see [acceptance](docs/acceptance.md).
|
|
143
157
|
For quality measurement see [quality baseline](docs/quality-baseline.md).
|
|
144
158
|
|
package/dist/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tbrandenburg/opencode-a2a-lite",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"description": "OpenCode ACP to A2A gateway for trusted workspaces",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -17,7 +17,8 @@
|
|
|
17
17
|
"LICENSE"
|
|
18
18
|
],
|
|
19
19
|
"os": [
|
|
20
|
-
"linux"
|
|
20
|
+
"linux",
|
|
21
|
+
"darwin"
|
|
21
22
|
],
|
|
22
23
|
"type": "module",
|
|
23
24
|
"publishConfig": {
|
package/dist/src/cli.js
CHANGED
|
@@ -8,7 +8,7 @@ async function main() {
|
|
|
8
8
|
console.log(`Usage: opencode-a2a-lite --workspace <path> [--port <0..65535>]
|
|
9
9
|
|
|
10
10
|
Start the foreground, unauthenticated A2A gateway.
|
|
11
|
-
Linux, Bun 1.4.4, stable OpenCode 2.2.7 or newer on PATH, and configured provider required.
|
|
11
|
+
Linux or macOS (experimental), Bun 1.4.4, stable OpenCode 2.2.7 or newer on PATH, and configured provider required.
|
|
12
12
|
|
|
13
13
|
--workspace <path> Explicitly trust this directory; relative paths are resolved.
|
|
14
14
|
--port <0..65535> Port (default 41241; 0 selects a free port).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tbrandenburg/opencode-a2a-lite",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"description": "OpenCode ACP to A2A gateway for trusted workspaces",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -17,7 +17,8 @@
|
|
|
17
17
|
"LICENSE"
|
|
18
18
|
],
|
|
19
19
|
"os": [
|
|
20
|
-
"linux"
|
|
20
|
+
"linux",
|
|
21
|
+
"darwin"
|
|
21
22
|
],
|
|
22
23
|
"type": "module",
|
|
23
24
|
"publishConfig": {
|