에이전트 렌더링 프로토콜

문제 ​

AI 에이전트는 구조화된 출력 — 표, 폼, 차트, 상태 메시지, 코드 블록 — 을 생성하지만, 해당 출력의 렌더링은 전송 계층 및 프론트엔드 프레임워크에 긴밀하게 결합되어 있습니다. 웹 채팅용으로 구축된 에이전트는 데스크톱 앱에서 렌더링할 수 없습니다. SSE 스트림 뒤에 있는 에이전트는 다른 프로토콜을 기대하는 모바일 클라이언트에 서비스할 수 없습니다.

새로운 렌더링 표면마다 맞춤형 통합 코드가 필요합니다.

해결책 ​

ARP는 프로토콜을 정의합니다 — 프레임워크도, 라이브러리도 아닙니다. Wayland가 애플리케이션을 디스플레이 서버로부터 분리한 것처럼, ARP는 에이전트를 렌더러로부터 분리합니다.

에이전트는 무엇을 표시할지 결정합니다. 렌더러는 어떻게 표시할지 결정합니다.

Agent (backend)                              Renderer (web, CLI, mobile)
───────────────                              ──────────────────────────
Owns surfaces         ── render / delta ──►  Owns display
Owns UI state         ◄── input events ────  Owns input routing

설계 원칙 ​

프로토콜 메시지 ​

모든 ARP 메시지는 최소한 { v: 1, type: "<type>" }을 포함하는 JSON입니다.

14가지 기본 컴포넌트 ​

ARP 적합 렌더러는 최소한 text를 지원해야 합니다. 컴포넌트는 폴백 체인을 선언합니다 — chart는 table로, table은 text로 폴백됩니다.

전송 계층 ​

클라이언트 SDK ​

import { ArpClient } from '@haira/arp'

const client = new ArpClient('ws://localhost:8080/_arp/v1', {
  onDelta: (text) => appendToChat(text),
  onRender: (event) => renderComponent(event.component, event.props),
  onDone: () => markStreamComplete(),
})

client.connect()
client.sendText('Show me the sales data')

import { ArpChat } from '@haira/arp-react'

function App() {
  return (
    <ArpChat
      url="ws://localhost:8080/_arp/v1"
      theme="dark"
      title="Data Explorer"
    />
  )
}

Vue 3용 @haira/arp-vue 및 Go 백엔드용 **github.com/haira-lang/arp-go**도 사용 가능합니다.

Haira 통합 ​

모든 Haira 서버는 기본적으로 ARP를 지원합니다. 별도의 설정이 필요 없습니다.

import "ui"

tool query_database(query: string) -> any {
    """Executes a SQL query and displays results."""
    rows, err = postgres.query(db, query)
    if err != nil {
        return ui.status_card("error", "Query Failed", conv.to_string(err))
    }
    return ui.table("Query Results", headers, rows)
}

agent DataExplorer {
    provider: OpenAI
    tools: [query_database]
    ui: ui
}

@webhook("/chat")
workflow Chat(message: string, session_id: string) -> stream {
    return DataExplorer.stream(message, session: session_id)
}

확장 수명 주기 ​

새 컴포넌트는 Wayland에서 영감을 받은 3단계 수명 주기를 따릅니다:

적합성 수준 ​