Agent Communication Protocol (ACP)¶

┌─────────────────────────────┐
│       IDE 클라이언트 (에디터)       │
└──────────────┬──────────────┘
               │
        JSON-RPC 2.0 (NDJSON)
               │
┌──────────────▼──────────────┐
│    Continuum Router (ACP)   │
│  ┌────────────────────────┐ │
│  │  AcpMethodRouter       │ │
│  │  SessionStore          │ │
│  │  PermissionPolicy      │ │
│  │  ToolExecutor          │ │
│  │  McpConnectionManager  │ │
│  └────────────────────────┘ │
└──────────────┬──────────────┘
               │
    ┌──────────┴──────────┐
    ▼                     ▼
┌────────┐         ┌───────────┐
│ OpenAI │   ...   │ Anthropic │
└────────┘         └───────────┘

{
  "jsonrpc": "2.0",
  "method": "initialize",
  "params": {
    "protocolVersion": 1,
    "clientCapabilities": {
      "readTextFile": true,
      "writeTextFile": true,
      "terminal": false
    },
    "clientInfo": {
      "name": "MyEditor",
      "version": "1.0.0"
    }
  },
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "protocolVersion": 1,
    "agentCapabilities": {
      "loadSession": true,
      "image": false,
      "audio": false,
      "embeddedContext": false,
      "mcp": true,
      "mcpCapabilities": { "acp": true }
    },
    "agentInfo": {
      "name": "Continuum Router",
      "version": "1.3.0-beta.1"
    },
    "authMethods": []
  },
  "id": 1
}

{
  "jsonrpc": "2.0",
  "method": "authenticate",
  "params": {
    "method": "api_key",
    "token": "your-api-key"
  },
  "id": 2
}

{
  "jsonrpc": "2.0",
  "method": "session/new",
  "params": { "mode": "code" },
  "id": 3
}

{
  "jsonrpc": "2.0",
  "result": {
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "createdAt": "2026-03-08T12:00:00Z",
    "updatedAt": "2026-03-08T12:00:00Z",
    "mode": "code",
    "historyLength": 0
  },
  "id": 3
}

{
  "jsonrpc": "2.0",
  "method": "session/load",
  "params": { "sessionId": "550e8400-e29b-41d4-a716-446655440000" },
  "id": 4
}

{
  "jsonrpc": "2.0",
  "method": "session/set_mode",
  "params": { "mode": "architect" },
  "id": 5
}

{
  "jsonrpc": "2.0",
  "result": {
    "mode": "architect",
    "previousMode": "code"
  },
  "id": 5
}

{
  "jsonrpc": "2.0",
  "method": "session/cancel",
  "id": 6
}

{
  "jsonrpc": "2.0",
  "method": "session/prompt",
  "params": {
    "sessionId": "550e8400-...",
    "content": [
      { "type": "text", "text": "Explain the architecture of this project" }
    ],
    "model": "gpt-4o",
    "stream": true,
    "temperature": 0.7,
    "maxTokens": 4096
  },
  "id": 7
}

{
  "jsonrpc": "2.0",
  "method": "session/update",
  "params": {
    "sessionId": "550e8400-...",
    "content": [{ "type": "text", "text": "The architecture..." }]
  }
}

{
  "jsonrpc": "2.0",
  "result": { "stopReason": "end_turn" },
  "id": 7
}

                    ┌─────────┐
                    │ Pending │
                    └────┬────┘
                         │
                    분류 + 권한 확인
                         │
                    ┌────▼────┐
         ┌─────────│   Ask   │─────────┐
         │         └─────────┘         │
    allow/always                  reject/always
         │                             │
    ┌────▼──────┐               ┌──────▼──┐
    │InProgress │               │ Failed  │
    └────┬──────┘               └─────────┘
         │
    도구 실행
         │
    ┌────▼──────┐
    │ Completed │
    └───────────┘

{
  "jsonrpc": "2.0",
  "method": "session/request_permission",
  "params": {
    "sessionId": "...",
    "toolCallId": "tc-1",
    "title": "Edit File",
    "kind": "edit",
    "locations": [{ "uri": "file:///src/main.rs", "startLine": 42 }]
  }
}

IDE 클라이언트 ←→ [ACP stdio] ←→ Continuum Router ←→ [MCP stdio] ←→ MCP 서버

{
  "jsonrpc": "2.0",
  "method": "mcp/connect",
  "params": { "id": "filesystem" },
  "id": 10
}

{
  "jsonrpc": "2.0",
  "result": { "connectionId": "uuid-..." },
  "id": 10
}

{
  "jsonrpc": "2.0",
  "method": "mcp/message",
  "params": {
    "connectionId": "uuid-...",
    "message": {
      "jsonrpc": "2.0",
      "method": "tools/list",
      "id": 1
    }
  },
  "id": 11
}

{
  "jsonrpc": "2.0",
  "method": "mcp/disconnect",
  "params": { "connectionId": "uuid-..." },
  "id": 12
}

{
  "name": "continuum-router",
  "displayName": "Continuum Router",
  "version": "1.3.0-beta.1",
  "description": "Local LLM inference agent with multi-backend routing",
  "transport": [
    { "type": "stdio" }
  ],
  "capabilities": {
    "loadSession": true,
    "mcp": true
  }
}

acp:
  enabled: true

  transport:
    stdio:
      enabled: true

  agent:
    name: "Continuum Router"
    version: "1.0.0"
    description: "Local LLM inference agent"

  capabilities:
    load_session: true
    image: false
    audio: false
    embedded_context: false
    mcp: true

  # ACP 세션의 기본 모델 (선택 사항)
  default_model: "gpt-4o"

  # 시스템 프롬프트 주입 (선택 사항)
  system_prompt: "You are a helpful coding assistant."

  # 코딩 에이전트 모드 활성화
  coding_agent_mode: true

  permissions:
    # 기본 정책: ask_always, allow_read 또는 allow_all
    default_policy: ask_always
    auto_allow:
      - read
      - search
      - think
    always_ask:
      - edit
      - delete
      - execute

  sessions:
    max_concurrent: 10
    idle_timeout: "1h"
    storage: "memory"

  mcp:
    max_connections_per_session: 5
    allowed_servers: []        # 비어 있으면 설정된 모든 서버 허용
    server_spawn_timeout: "10s"

src/acp/
├── mod.rs              # 모듈 루트
├── jsonrpc.rs          # JSON-RPC 2.0 프로토콜 타입
├── types.rs            # ACP 콘텐츠 블록과 메시지
├── error.rs            # 오류 타입
├── capabilities.rs     # 기능 협상
├── config.rs           # 설정 구조체
├── config_validate.rs  # 설정 검증
├── metadata.rs         # 에이전트 레지스트리 메타데이터 (agent.json)
├── transport/
│   ├── mod.rs          # AcpTransport 트레이트
│   └── stdio.rs        # stdin/stdout 위의 NDJSON
├── session.rs          # 세션 라이프사이클과 저장소
├── router.rs           # 메서드 디스패치 라우터
├── handlers/
│   ├── initialize.rs   # 프로토콜 초기화
│   ├── authenticate.rs # 인증 (스텁)
│   ├── session.rs      # session/* 메서드
│   ├── prompt.rs       # session/prompt 핸들러
│   ├── prompt_stream.rs # SSE 스트리밍 프로세서
│   └── translate.rs    # ACP → OpenAI 형식 변환
├── tools/
│   ├── mod.rs          # 도구 호출 타입
│   ├── classifier.rs   # 도구 종류 분류
│   ├── permission.rs   # 권한 정책 엔진
│   ├── executor.rs     # 도구 실행 오케스트레이터
│   └── client_methods.rs # 클라이언트 측 메서드 (fs/*, terminal/*)
├── mcp_bridge/
│   ├── mod.rs          # MCP 기능
│   ├── handlers.rs     # connect/message/disconnect 핸들러
│   ├── connection.rs   # 연결 관리자
│   ├── process.rs      # MCP 서버 프로세스 스폰
│   └── schema_translate.rs # MCP ↔ ACP 스키마 변환
└── admin.rs            # Admin API 엔드포인트