zidane 7.0.15 → 7.0.16

package/README.md

@@ -904,15 +904,24 @@ Benchmark harnesses live in [`benchmarks/`](./benchmarks). First integration: [T
 
 ## Docs
 
-| Doc | What |
-|---|---|
-| [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md) | Mermaid diagrams of the agent loop, tool execution, hook firing order, dependency graph. |
-| [docs/HEADLESS.md](./docs/HEADLESS.md) | `zidane/headless` — non-interactive `runHeadless()` + CLI for automation / RL rollouts. Structured result, JSONL transcript, `stream-json`, exit codes. |
-| [docs/SKILL.md](./docs/SKILL.md) | Authoritative reference for `createAgent` + hooks + tools + sessions + skills + MCP. Long-form. |
-| [docs/CHAT.md](./docs/CHAT.md) | `zidane/chat` — renderer-agnostic chat engine (auth, sessions, safe-mode, settings, theme). Consumed by the TUI and any future GUI. |
-| [docs/TUI.md](./docs/TUI.md) | `zidane/tui` — terminal shell built on `zidane/chat`. `runTui()`, screens, modals, keyboard, theming. |
-| [docs/RESTATE.md](./docs/RESTATE.md) | `zidane/restate` — optional durable-execution adapter (Restate). Journals LLM + completed tool calls, with strict defaults and opt-in durable parallel tools. |
-| [docs/PLUGINS.md](./docs/PLUGINS.md) | `zidane/plugins` — [Agent Plugins](https://agent-plugins.org) 1.0.0 loader. Portable packages bundling skills + MCP servers, with closed validation and a filesystem boundary. |
+Full index with a "where does X live" map: [docs/README.md](./docs/README.md).
+
+| Area | Doc | What |
+|---|---|---|
+| Core SDK | [SKILL.md](./docs/SKILL.md) | `createAgent`, providers, the complete hooks table, tools, sessions, skills, MCP, spawning. The API reference. |
+| Core SDK | [ARCHITECTURE.md](./docs/ARCHITECTURE.md) | Agent loop internals: lifecycle, turn/tool flow, hook order, built-in tool defaults, cache-stable config. |
+| Core SDK | [EXECUTION_CONTEXT.md](./docs/EXECUTION_CONTEXT.md) | `--context process\|docker\|e2b\|daytona`: where shell/file ops run and what each isolates. |
+| Core SDK | [RUN_IN_BACKGROUND.md](./docs/RUN_IN_BACKGROUND.md) | Background shell tasks: `run_in_background`, `wait_task`, notifications, teardown, subagent reassignment. |
+| Core SDK | [INTERACTIONS.md](./docs/INTERACTIONS.md) | `present_plan` / `ask_user`: pausing for user input. |
+| Core SDK | [HEADLESS.md](./docs/HEADLESS.md) | `zidane/headless`: one-shot `runHeadless()` + CLI for automation / RL. |
+| Chat + surfaces | [CHAT.md](./docs/CHAT.md) | `zidane/chat`: renderer-agnostic engine — config, sessions, settings, safe mode, todos, commands, completion. |
+| Chat + surfaces | [TUI.md](./docs/TUI.md) | `zidane/tui`: terminal shell — screens, keybindings, modals, theming, file layout. |
+| Chat + surfaces | [IPC.md](./docs/IPC.md) | `zidane/ipc`: shared chat host + daemon; every RPC and signal; TUI/GUI parity. |
+| Chat + surfaces | [ARTIFACTS.md](./docs/ARTIFACTS.md) | Session artifacts: what a session produced (PRs, branches, commits, files) — model, producers, surfaces, IPC. |
+| Chat + surfaces | [EXTENSIONS.md](./docs/EXTENSIONS.md) | User extensions: `defineExtension`, the full `ctx` API, discovery, installing, authoring patterns. |
+| Integrations | [PLUGINS.md](./docs/PLUGINS.md) | `zidane/plugins`: Agent Plugins 1.0.0 loader (skills + MCP servers as portable packages). |
+| Integrations | [ACP.md](./docs/ACP.md) | `zidane/acp`: Agent Client Protocol adapter for editors (Zed etc.). |
+| Integrations | [RESTATE.md](./docs/RESTATE.md) | `zidane/restate`: durable execution — journaled LLM + tool calls, strict defaults. |
 
 ## License
 

package/docs/ACP.md

@@ -23,6 +23,12 @@ The command writes only ACP JSON-RPC frames to stdout during normal operation.
 Diagnostics, usage errors, and provider logs go to stderr so editor clients can
 keep stdout reserved for protocol traffic.
 
+Contents: [Install](#install) · [Zed](#zed) · [Credentials](#credentials) ·
+[Model Selection](#model-selection) · [Modes](#modes) ·
+[Model Options](#model-options) · [Other ACP Clients](#other-acp-clients) ·
+[In Process](#in-process) · [Protocol Coverage](#protocol-coverage) ·
+[Troubleshooting](#troubleshooting)
+
 ## Zed
 
 Zed supports custom ACP agents through `agent_servers` in `settings.json`.