Skip to content

docs(acp): pin registry listing to v0.0.280 #678

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
justrach wants to merge 1 commit into from
Closed

docs(acp): pin registry listing to v0.0.280 #678

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 36 additions & 33 deletions docs/acp-registry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,20 +11,20 @@ Hand-written Zed setup stays in the [README](../README.md#zed-external-agents--a
and the host recipe stays [embedding.md](embedding.md). Replace those with
"Install from Registry" only after a listing lands.

## What already ships here
## Status

| Piece | Status |
| --- | --- |
| `graff acp` stdio agent | Shipped. Protocol version 1. |
| Mid-turn `session/update` (thought / tool / text) | Shipped (ADR [0032](adr/0032-acp-streams-mid-turn.md), #612). |
| Provider login | `graff login` / keychain / env keys. Not ACP `authenticate`. |
| `initialize.authMethods` | **Shipped.** `graff-login` / `type: "terminal"` / `args: ["login"]`. `authenticate` stays unused — the client re-spawns `graff login`. |
| Registry listing | **Submitted.** [`agentclientprotocol/registry#558`](https://github.com/agentclientprotocol/registry/pull/558) pins tagged **v0.0.280**. |
| `session/load`, `session/request_permission` | Not implemented. Unattended + `--yolo` is the host path. |

A stale comment on #613 said #612 was still open. It is not: streaming is on
the tagged v0.0.279 cut. The remaining blocker for a listing is protocol auth.
A listing in the other repo does not add a registry client here.

## Registry auth (the actual blocker)
## Registry auth

The registry's [AUTHENTICATION.md](https://github.com/agentclientprotocol/registry/blob/main/AUTHENTICATION.md)
accepts only:
Expand All @@ -33,8 +33,7 @@ accepts only:
- **Terminal Auth** — the client re-spawns the binary with setup args (a TUI
login), then runs the normal ACP command.

`graff login` is already Terminal Auth in product terms. `initialize` now
advertises it:
`graff login` is Terminal Auth. `initialize` advertises it:

```json
{
Expand Down Expand Up @@ -67,14 +66,16 @@ agent whose `initialize` omits `authMethods`.
4. Open a PR there. Versions must be pinned (no `/latest/`, no `@latest`).
GitHub Releases + a `repository` URL let the registry bump the tag hourly.

Draft `agent.json` for the next cut that advertises Terminal Auth (URLs and
sha256 must match a real release; do not submit against `/latest/`):
Pinned `agent.json` for **v0.0.280** (the listing currently in
[registry#558](https://github.com/agentclientprotocol/registry/pull/558)).
Archives extract as `graff-<target>/graff`; `cmd` is nested. SHA-256 values
are from that release's `SHA256SUMS`:

```json
{
"id": "graff",
"name": "graff",
"version": "0.0.279",
"version": "0.0.280",
"description": "Codegraff harness as an ACP agent (graff acp)",
"repository": "https://github.com/justrach/codegraff",
"website": "https://codegraff.com",
Expand All @@ -83,46 +84,48 @@ sha256 must match a real release; do not submit against `/latest/`):
"distribution": {
"binary": {
"darwin-aarch64": {
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-aarch64-macos.tar.gz",
"cmd": "./graff",
"args": ["acp"]
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.280/graff-aarch64-macos.tar.gz",
"cmd": "./graff-aarch64-macos/graff",
"args": ["acp"],
"sha256": "3fb1d4860338f14445955cab070f187ea9af8fe31cada19a00c2b29cc95c910b"
},
"darwin-x86_64": {
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-x86_64-macos.tar.gz",
"cmd": "./graff",
"args": ["acp"]
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.280/graff-x86_64-macos.tar.gz",
"cmd": "./graff-x86_64-macos/graff",
"args": ["acp"],
"sha256": "3d250cfe44a32367dee1dc55ca9f3eef987cda5b886c68fa3bcc771a07394d45"
},
"linux-aarch64": {
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-aarch64-linux.tar.gz",
"cmd": "./graff",
"args": ["acp"]
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.280/graff-aarch64-linux.tar.gz",
"cmd": "./graff-aarch64-linux/graff",
"args": ["acp"],
"sha256": "fbbf9d37f29eb25b74a95da0b2f523a2c754c776a78d089d96d4fdbcf48e43f5"
},
"linux-x86_64": {
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-x86_64-linux.tar.gz",
"cmd": "./graff",
"args": ["acp"]
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.280/graff-x86_64-linux.tar.gz",
"cmd": "./graff-x86_64-linux/graff",
"args": ["acp"],
"sha256": "7a2412724aa6f0c7bf4a2c5248b0619c331a5a20ffc5a17f0ed95a8f291c1bcd"
},
"windows-aarch64": {
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-aarch64-windows.tar.gz",
"cmd": "./graff.exe",
"args": ["acp"]
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.280/graff-aarch64-windows.tar.gz",
"cmd": "./graff-aarch64-windows/graff.exe",
"args": ["acp"],
"sha256": "ad96fea65acfb650dfa934b0918c3a103bc5d037f63a087c817174b2578ba8f3"
},
"windows-x86_64": {
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-x86_64-windows.tar.gz",
"cmd": "./graff.exe",
"args": ["acp"]
"archive": "https://github.com/justrach/codegraff/releases/download/v0.0.280/graff-x86_64-windows.tar.gz",
"cmd": "./graff-x86_64-windows/graff.exe",
"args": ["acp"],
"sha256": "25f94952cb0bcfd3d4503cf88379ded5287f8f111aa5a51715a439dd096ec0f1"
}
}
}
}
```

Pin `sha256` from that release's `SHA256SUMS` before the PR. Archive layout
is sometimes flat (`graff` at the tarball root) and sometimes nested
(`graff-<target>/graff`); `cmd` must match what the installer extracts.

`authMethods` is on the wire. Pin `sha256` from a real release, then open the
registry PR in the other repo. This repo still does not fetch the catalog.
When the next cut ships, bump `version`, archive URLs, `sha256`, and `cmd`
if the tarball layout changes. Do not submit against `/latest/`.

## Not this repo

Expand Down