agentic-acp-docs-and-schema

name	agentic-acp-docs-and-schema
description	Use when ACP schema is necessary to clarify the work or when the user asks for ACP data, rules, events, or documentation

ACP documentation and schema

The ACP documentation can be found at:

• Complete Schema: https://agentclientprotocol.com/protocol/schema.md
• Overview: https://agentclientprotocol.com/protocol/overview.md
• Initialization: https://agentclientprotocol.com/protocol/initialization.md
• Session Setup: https://agentclientprotocol.com/protocol/session-setup.md
• https://agentclientprotocol.com/protocol/session-config-options.md
• Prompt Turn: https://agentclientprotocol.com/protocol/prompt-turn.md
• Content: https://agentclientprotocol.com/protocol/content.md
• Tool Calls: https://agentclientprotocol.com/protocol/tool-calls
• File System: https://agentclientprotocol.com/protocol/file-system.md
• Terminals: https://agentclientprotocol.com/protocol/terminals.md
• Agent Plan: https://agentclientprotocol.com/protocol/agent-plan.md
• Session Modes: https://agentclientprotocol.com/protocol/session-modes.md
• Slash Commands: https://agentclientprotocol.com/protocol/slash-commands.md
• Extensibility: https://agentclientprotocol.com/protocol/extensibility.md
• Transports: https://agentclientprotocol.com/protocol/transports.md

ACP architectural limitations:

• No partial acceptance of file changes: Users must accept or reject the entire file's changes as a unit. The ACP protocol is async and transactional (all-or-nothing tool calls). Implementing partial acceptance would require complex workarounds (e.g., auto-accepting then partially reverting) which adds significant complexity. This feature is deferred/out of scope.

Message flow and tool call lifecycle

Required reading for working on adapters, MessageWriter, SessionManager, or PermissionManager.