@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 CHANGED
@@ -5,10 +5,10 @@
5
5
  [![CI](https://github.com/tbrandenburg/opencode-a2a-lite/actions/workflows/ci.yml/badge.svg)](https://github.com/tbrandenburg/opencode-a2a-lite/actions/workflows/ci.yml)
6
6
  [![Release](https://img.shields.io/github/v/release/tbrandenburg/opencode-a2a-lite)](https://github.com/tbrandenburg/opencode-a2a-lite/releases/latest)
7
7
  [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
8
- ![Platform: Linux](https://img.shields.io/badge/platform-linux-lightgrey)
8
+ ![Platform: Linux and experimental macOS](https://img.shields.io/badge/platform-linux%20%7C%20macOS%20experimental-lightgrey)
9
9
  ![Runtime: Bun](https://img.shields.io/badge/runtime-Bun%201.4.4-black)
10
10
 
11
- A small OpenCode ACP → A2A 1.0 gateway for trusted Linux workspaces: point any A2A
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
- make install # frozen Bun lockfile
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
- Wait for a JSON stdout record such as `{"ready":true,"url":"http://127.0.0.1:.../"}`,
46
- then in a second terminal use the **actual** URL (default port 41241):
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 **`opencode` v2.2.7 or newer** on `PATH`
60
- (live acceptance recorded on 2.2.7).
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; registry publication and
90
- the installed CLI were verified for version 0.2.5. To run that version:
91
-
92
- ```sh
93
- npx --yes @tbrandenburg/opencode-a2a-lite@0.2.5 --workspace .
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 checks deterministic tests, the provider-free team launcher fixtures, installed
140
- packaging and the checksummed provider-free MCP bridge. Live demo/E2E are explicit manual commands requiring a provider key,
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.2.6",
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.2.6",
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": {