@tbrandenburg/opencode-a2a-lite 0.2.5 → 0.2.7

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
@@ -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
@@ -86,17 +89,12 @@ use `make dev` for development.
86
89
 
87
90
  ### Package distribution
88
91
 
89
- `@tbrandenburg/opencode-a2a-lite` is released on GitHub (see the release badge above).
90
- **npm registry publication has not been verified**; do not assume these work until
91
- the scope/registry is checked:
92
-
93
- ```sh
94
- bunx @tbrandenburg/opencode-a2a-lite --workspace .
95
- npx --yes @tbrandenburg/opencode-a2a-lite --workspace .
96
- ```
97
-
98
- Both runners still require Bun. `make package-smoke` tests an installed tarball,
99
- **not** registry publication. See [distribution and release policy](docs/distribution.md).
92
+ `@tbrandenburg/opencode-a2a-lite` is published on npm (see [Quick start](#quick-start)).
93
+ Pin a version with `@x.y.z` instead of `@latest`. The package requires Node.js 22 or
94
+ newer to use `npx`, plus Bun 1.4.4 and OpenCode 2.2.7 or newer on `PATH`. `bunx` can
95
+ be used instead of `npx` where Bun is installed. Inside a checkout of this repository
96
+ `npx` can fail with `opencode-a2a-lite: not found`; run it from another directory. See [distribution and release policy](docs/distribution.md) for
97
+ verification scope and release details.
100
98
 
101
99
  ## Behavior and limitations
102
100
 
@@ -125,6 +123,14 @@ and runtime-selected workspaces are not claimed.
125
123
 
126
124
  ## Development
127
125
 
126
+ Run from source:
127
+
128
+ ```sh
129
+ make install # frozen Bun lockfile
130
+ make check # format, lint, typecheck, deterministic tests, build
131
+ bun src/cli.ts --workspace /absolute/path/to/trusted/workspace --port 0
132
+ ```
133
+
128
134
  | Command | Purpose |
129
135
  | ---------------------------------------------------------------------- | -------------------------------------------------------------------- |
130
136
  | `make check` | Formatting, lint, strict types, deterministic regressions, build |
package/dist/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tbrandenburg/opencode-a2a-lite",
3
- "version": "0.2.5",
3
+ "version": "0.2.7",
4
4
  "description": "OpenCode ACP to A2A gateway for trusted workspaces",
5
5
  "license": "MIT",
6
6
  "repository": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tbrandenburg/opencode-a2a-lite",
3
- "version": "0.2.5",
3
+ "version": "0.2.7",
4
4
  "description": "OpenCode ACP to A2A gateway for trusted workspaces",
5
5
  "license": "MIT",
6
6
  "repository": {