ACP Overview

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/phodal/routa/llms.txt

Use this file to discover all available pages before exploring further.

​

What is ACP?

​

Architecture

​

Core Components

• ACP Session Manager (src/core/acp/acp-session-manager.ts) - Manages active agent sessions
• ACP Process Manager (src/core/acp/acp-process-manager.ts) - Spawns and controls agent processes
• Runtime Manager (src/core/acp/runtime-manager.ts) - Manages Node.js and Python runtimes
• Provider Registry (src/core/acp/provider-registry.ts) - Registry of available agent providers
• ACP Registry (src/core/acp/acp-registry.ts) - Fetches agent definitions from the ACP Registry CDN

​

Provider Adapters

• Claude Code Adapter - Handles Claude’s stream-json protocol
• OpenCode Adapter - Standard ACP protocol implementation
• Standard ACP Adapter - Generic adapter for compliant agents

interface NormalizedSessionUpdate {
  sessionId: string;
  type: "tool_call" | "tool_call_update" | "agent_message" | "agent_thought";
  toolCall?: NormalizedToolCall;
  message?: { role: string; content: string; isChunk?: boolean };
  rawNotification: unknown;
}

​

JSON-RPC Methods

​

Session Management

• initialize - Initialize the ACP connection
• session/new - Create a new agent session
• session/prompt - Send a message to an agent session
• session/cancel - Cancel an active session
• session/load - Load a persisted session
• session/set_mode - Change the session mode (e.g., orchestrator)

​

Provider Information

• _providers/list - List available providers and their models

​

Event Streaming

GET /api/acp?sessionId=<id>

• Tool calls and their execution status
• Agent messages and thoughts
• Session state changes

​

Supported Providers

​

Usage Example

​

Creating an ACP Session

import { AcpSessionManager } from "@/core/acp";

const manager = new AcpSessionManager();

// Create a new session with OpenCode
const sessionId = await manager.createSession({
  provider: "opencode",
  workspaceId: "my-workspace",
  workspacePath: "/path/to/project",
  sessionMode: "orchestrator",
});

// Send a message
const response = await manager.sendMessage(sessionId, {
  role: "user",
  content: "Add authentication to the API",
});

console.log(response);

​

Using the JSON-RPC API

curl -X POST http://localhost:3000/api/acp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "session/new",
    "params": {
      "provider": "opencode",
      "workspaceId": "default",
      "message": "Fix the login bug"
    },
    "id": 1
  }'

​

Next Steps

• Runtime Management - Managing Node.js and Python runtimes
• ACP Registry - Using the ACP agent registry
• Installing Agents - Installing and configuring agents