Skip to content

graff — a fast agentic coding harness in Zig: multi-provider, MCP, workflows, DGM evolution loop, TS/Python SDKs

Python
5.7 KB
Raw Blame

ACP Registry listing (#613)

Listing is not a feature of this repo. The catalog lives in agentclientprotocol/registry and is what Zed's "Install from Registry" (and other ACP clients) reads.

This page is the submit recipe. There is no registry client in graff, and graff acp does not grow one.

Hand-written Zed setup is graff acp (see the README) and the host recipe stays embedding.md. Replace those with "Install from Registry" only after a listing lands.

What already ships here

Piece Status
graff acp stdio agent Shipped. Protocol version 1.
Mid-turn session/update (thought / tool / text) Shipped (ADR 0032, #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.
Credential-free startup Shipped. A clean graff acp initializes, then returns ACP auth_required until login and respawn.
session/load Live CLI restores saved conversations in the selected workspace and replays retained history.
session/request_permission Interactive clients answer tool approval requests; unattended --yolo remains available. See client behavior.

A stale comment on #613 said #612 was still open. It is not: streaming is on the tagged v0.0.279 cut. The final in-repo registry prerequisite was startup ordering: key resolution used to exit before a clean process could initialize.

Registry auth

The registry's AUTHENTICATION.md accepts only:

  • Agent Auth — the agent runs OAuth (local callback server + browser).
  • 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:

{
  "authMethods": [
    {
      "id": "graff-login",
      "name": "graff login",
      "description": "Interactive terminal login (codegraff / Codex / Kimi)",
      "type": "terminal",
      "args": ["login"]
    }
  ]
}

Do not invent Agent Auth that duplicates graff login. Do not add env-var auth to satisfy the registry — it is not one of the two accepted types.

When startup finds no provider credential, the lightweight ACP loop uses the same acp_engine initialize response as the full runtime. Requests that need a live Agent are rejected without exiting the loop:

{"jsonrpc":"2.0","id":2,"error":{"code":-32000,"message":"Authentication required: run `graff login`, then restart the ACP agent."}}

CI on the registry repo runs python3 .github/workflows/verify_agents.py --auth-check and rejects an agent whose initialize omits authMethods.

Submit recipe (other repo)

  1. Fork agentclientprotocol/registry.
  2. Add a directory whose name equals id (suggested: graff/).
  3. Put agent.json (schema: agent.schema.json) and a 16×16 monochrome icon.svg that uses only currentColor / none / inherit fills. Hardcoded colors fail CI.
  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/):

{
  "id": "graff",
  "name": "graff",
  "version": "0.0.279",
  "description": "Codegraff harness as an ACP agent (graff acp)",
  "repository": "https://github.com/justrach/codegraff",
  "website": "https://codegraff.com",
  "authors": ["Rach Pradhan"],
  "license": "LicenseRef-codegraff",
  "distribution": {
    "binary": {
      "darwin-aarch64": {
        "archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-aarch64-macos.tar.gz",
        "cmd": "./graff",
        "args": ["acp"]
      },
      "darwin-x86_64": {
        "archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-x86_64-macos.tar.gz",
        "cmd": "./graff",
        "args": ["acp"]
      },
      "linux-aarch64": {
        "archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-aarch64-linux.tar.gz",
        "cmd": "./graff",
        "args": ["acp"]
      },
      "linux-x86_64": {
        "archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-x86_64-linux.tar.gz",
        "cmd": "./graff",
        "args": ["acp"]
      },
      "windows-aarch64": {
        "archive": "https://github.com/justrach/codegraff/releases/download/v0.0.279/graff-aarch64-windows.tar.gz",
        "cmd": "./graff.exe",
        "args": ["acp"]
      },
      "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"]
      }
    }
  }
}

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 and the credential-free handshake are 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.

Not this repo

  • No graff registry command.
  • No fetch of cdn.agentclientprotocol.com.
  • No authenticate implementation (Terminal Auth is out of band).