zidane 5.13.0 → 5.13.2

package/README.md

@@ -21,6 +21,7 @@ Everything below is in service of those:
 - 🧠 **Providers** — Anthropic, OpenAI Codex, OpenRouter, Cerebras, xAI Grok, Arcee, local LLMs, plus `openaiCompat` (Baseten, Fireworks, Groq). OAuth + API key with auto-refresh.
 - 🪝 **Hookable turn loop** — every text/thinking delta, tool call, MCP, session, skill, spawn, OAuth, validation, and budget event is observable and (mostly) mutable.
 - 🛠️ **First-class tools** — `shell`, `read_file`, `write_file`, `edit`, `multi_edit`, `glob`, `grep`, `spawn`, human-in-the-loop, plus any [MCP](https://modelcontextprotocol.io) server. Per-call gates, arg auto-coerce, hallucinated-tool fallback, error rewriting. Lazy MCP disclosure via `tool_search`. Optional `todowrite` / `todoread` for persistent task checkpointing across prompts.
+- 🔌 **ACP v1 adapter** — run Zidane from ACP clients like Zed via `zidane-acp`, or embed the protocol server with `zidane/acp`.
 - 🧮 **Per-tool concurrency** — every `ToolDef` carries `isConcurrencySafe` (default `false`); the dispatcher fans safe siblings out in parallel and barriers unsafe ones. Order is preserved at yield time. Cap via `behavior.maxConcurrentTools`.
 - ✂️ **Token-aware** — paginated reads, tail-truncated `shell`, idempotent `write_file`; `outputBytes` everywhere. `toolOutputBudget`, `toolBudgets`, `thinkingDecay`.
 - 🗜️ **Context discipline** — `cache_control` breakpoints; server-side compaction on Anthropic, client-side `compactStrategy: 'tail'` elsewhere. Per-session read dedup + `requireReadBeforeEdit`; generalized `dedupTools`.
@@ -137,6 +138,20 @@ For `local` / `openai-compat`, `--base-url`, `--api-key-env`, `--headers-env`, `
 
 `bun start --restate` runs the same start flow through a local Restate endpoint for durable-execution demos and fixture testing. It starts the service, probes readiness, registers the deployment, invokes `zidane-start-agent`, and exposes `run` / `status` / `history` handlers. See [docs/RESTATE.md](./docs/RESTATE.md) for production wiring and the advanced ReState flags.
 
+## ACP
+
+Zidane ships an opt-in [Agent Client Protocol](https://agentclientprotocol.com) v1 adapter for editors and IDEs. Install the package and point your ACP client at:
+
+```bash
+zidane-acp --provider anthropic --model claude-sonnet-4-5
+```
+
+Expose a model picker to the client (e.g. Zed's dropdown) with `--models a,b` (one provider) or repeatable `--model-option provider:model[:label]` for cross-provider models — each resolves its own credentials lazily.
+
+Credentials come from Zidane's app credential store (`~/.zidane/credentials.json`) by default, so no API keys are needed in the editor config; explicit env vars still win. ACP doesn't let editors forward their own provider keys, so configure Zidane credentials once to keep secrets out of `settings.json`.
+
+For Zed config, model selection, stdio framing details, session persistence, and in-process usage via `zidane/acp`, see [docs/ACP.md](./docs/ACP.md).
+
 ## Providers
 
 All providers accept runtime credentials via params. Env vars are fallbacks.