agy-worker-mcp 0.3.1 → 0.3.2

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.
Files changed (3) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +11 -13
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -4,6 +4,18 @@ All notable changes to agy-worker-mcp. Dates are the day the version landed on
4
4
  `main`. Measurements against the real `agy` CLI are noted with the agy version
5
5
  they were taken on.
6
6
 
7
+ ## 0.3.2 — 2026-09-10
8
+
9
+ Documentation only. No code changes.
10
+
11
+ - **README renders on npm** — GitHub alert syntax (`> [!WARNING]`, `> [!NOTE]`)
12
+ is not supported by npm's markdown renderer and showed up literally on the
13
+ package page. Both blocks are plain blockquotes with a bold label now, and the
14
+ development-status block reads "Important" rather than "Warning".
15
+ - **Links work off GitHub** — every relative link in the README (`docs/`,
16
+ `CHANGELOG.md`, `test/fake-agy`) is an absolute GitHub URL, since npm does not
17
+ resolve relative links against the repository.
18
+
7
19
  ## 0.3.1 — 2026-09-09
8
20
 
9
21
  Pre-publish audit. The gate is a string classifier; this release makes it
package/README.md CHANGED
@@ -1,9 +1,8 @@
1
- > [!WARNING]
2
- > Under active development (0.3.x). The permission model is a string classifier over
1
+ > **Important — under active development (0.3.x).** The permission model is a string classifier over
3
2
  > tool calls — the same kind of boundary Claude Code and Codex use, not a kernel
4
3
  > boundary. Allowed shell commands run **without** an OS sandbox by default since 0.2.1
5
4
  > (can be enabled with `sandbox: "seatbelt"`). What the gate deliberately does not
6
- > see is documented in [`docs/permissions.md`](./docs/permissions.md#what-the-gate-deliberately-does-not-see);
5
+ > see is documented in [`docs/permissions.md`](https://github.com/thezoot3/agy-worker-mcp/blob/main/docs/permissions.md#what-the-gate-deliberately-does-not-see);
7
6
  > read it before starting. Point it only at projects you would let Claude Code work on unattended.
8
7
 
9
8
  # agy-worker-mcp
@@ -11,7 +10,6 @@
11
10
  An MCP server that runs the Google Antigravity CLI (`agy`) as an asynchronous
12
11
  worker agent, callable from Claude Code, Codex, and any other MCP client.
13
12
 
14
- > [!NOTE]
15
13
  > **Unofficial.** agy-worker-mcp is an independent, third-party MCP server. It is not affiliated with, endorsed by, or supported by Google. "Google", "Antigravity", "Gemini", and the `agy` command name are trademarks or product names of Google LLC and are used here only to identify the CLI this server drives. See [Trademarks and terms](#trademarks-and-terms).
16
14
 
17
15
  Jobs are detached from the client that started them: a job's process outlives
@@ -30,7 +28,7 @@ kernel boundary back with `sandbox: "seatbelt"`. `agy_ceiling`, the shipped
30
28
  `agy-ceiling` skill and the `/agy-ceiling` slash command let an agent or a user
31
29
  propose that ceiling from the project's denial history — and nothing writes
32
30
  the file without your approval. Version-by-version detail is in
33
- [`CHANGELOG.md`](./CHANGELOG.md).
31
+ [`CHANGELOG.md`](https://github.com/thezoot3/agy-worker-mcp/blob/main/CHANGELOG.md).
34
32
 
35
33
  ## Why detached jobs
36
34
 
@@ -152,7 +150,7 @@ agy_start { profile: "general_worker", permissions: { read_roots: ["~/.jdks"] },
152
150
 
153
151
  Without the matching ceiling entry, `read_roots` in the request is
154
152
  dropped and reported in `rejected_read_roots` — see
155
- [`docs/permissions.md`](./docs/permissions.md) for the full model.
153
+ [`docs/permissions.md`](https://github.com/thezoot3/agy-worker-mcp/blob/main/docs/permissions.md) for the full model.
156
154
 
157
155
  When a job comes back `blocked`, `agy_result`'s `verification.blockers[]` says
158
156
  who refused. Each entry carries `actionable` (can a different `agy_start` lift
@@ -178,7 +176,7 @@ a human editing `policy.json`, or a different command.
178
176
  | `agy_ceiling` | Read-only: the ceiling, the effective policy, denial history, and a review of a draft ceiling. Never writes. |
179
177
 
180
178
  Parameter-level detail, the `outcome` vocabulary, and the two "blocked" classes
181
- are in [`docs/tools.md`](./docs/tools.md).
179
+ are in [`docs/tools.md`](https://github.com/thezoot3/agy-worker-mcp/blob/main/docs/tools.md).
182
180
 
183
181
  ## Permissions
184
182
 
@@ -223,7 +221,7 @@ list to empty and takes the profile's own defaults with it.
223
221
 
224
222
  Full model — the three owners, the ceiling file schema, the gate's decision
225
223
  order, containment, `verify_command`, and denial recovery — is in
226
- [`docs/permissions.md`](./docs/permissions.md).
224
+ [`docs/permissions.md`](https://github.com/thezoot3/agy-worker-mcp/blob/main/docs/permissions.md).
227
225
 
228
226
  ### Proposing a ceiling (skill)
229
227
 
@@ -247,14 +245,14 @@ cp "$(npm root -g)/agy-worker-mcp/commands/agy-ceiling.md" .claude/commands/
247
245
 
248
246
  ## Documentation
249
247
 
250
- - [`docs/tools.md`](./docs/tools.md) — the ten tools, parameter by parameter,
248
+ - [`docs/tools.md`](https://github.com/thezoot3/agy-worker-mcp/blob/main/docs/tools.md) — the ten tools, parameter by parameter,
251
249
  and the result vocabulary
252
- - [`docs/permissions.md`](./docs/permissions.md) — the three-owner permission
250
+ - [`docs/permissions.md`](https://github.com/thezoot3/agy-worker-mcp/blob/main/docs/permissions.md) — the three-owner permission
253
251
  model, the ceiling file, the gate's decision order, containment,
254
252
  `verify_command`, denial recovery
255
- - [`docs/operations.md`](./docs/operations.md) — state layout, lifecycle, locks,
253
+ - [`docs/operations.md`](https://github.com/thezoot3/agy-worker-mcp/blob/main/docs/operations.md) — state layout, lifecycle, locks,
256
254
  timeouts, retention, test suites
257
- - [`CHANGELOG.md`](./CHANGELOG.md) — what changed in each version
255
+ - [`CHANGELOG.md`](https://github.com/thezoot3/agy-worker-mcp/blob/main/CHANGELOG.md) — what changed in each version
258
256
 
259
257
  ## Development
260
258
 
@@ -265,7 +263,7 @@ npm run build # emits dist/server.js, dist/runner.js, dist/gate.js, dist/s
265
263
  ```
266
264
 
267
265
  `npm test` and CI run exclusively against the scripted fake in
268
- [`test/fake-agy/`](./test/fake-agy); the real `agy` CLI is never invoked there,
266
+ [`test/fake-agy/`](https://github.com/thezoot3/agy-worker-mcp/blob/main/test/fake-agy); the real `agy` CLI is never invoked there,
269
267
  since every invocation spends real quota. The real binary is exercised only by
270
268
  the opt-in live suite:
271
269
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agy-worker-mcp",
3
- "version": "0.3.1",
3
+ "version": "0.3.2",
4
4
  "description": "Unofficial MCP server that drives Google's Antigravity CLI (agy) as an asynchronous worker agent",
5
5
  "type": "module",
6
6
  "license": "MIT",