@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 +22 -16
- package/dist/package.json +1 -1
- package/package.json +1 -1
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
|
-
|
|
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
|
|
@@ -86,17 +89,12 @@ use `make dev` for development.
|
|
|
86
89
|
|
|
87
90
|
### Package distribution
|
|
88
91
|
|
|
89
|
-
`@tbrandenburg/opencode-a2a-lite` is
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
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