Protocole de Rendu Agentique

Le Problème ​

Les agents IA produisent des sorties structurées — tableaux, formulaires, graphiques, messages de statut, blocs de code — mais le rendu de ces sorties est étroitement couplé au transport et au framework frontend. Un agent conçu pour un chat web ne peut pas s'afficher dans une application desktop. Un agent derrière un flux SSE ne peut pas servir un client mobile attendant un protocole différent.

Chaque nouvelle surface de rendu nécessite un code d'intégration personnalisé.

La Solution ​

ARP définit un protocole — pas un framework, pas une bibliothèque. De la même façon que Wayland a découplé les applications des serveurs d'affichage, ARP découple les agents des renderers.

L'agent décide quoi afficher. Le renderer décide comment l'afficher.

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

Principes de Conception ​

Messages du Protocole ​

Chaque message ARP est du JSON avec au minimum { v: 1, type: "<type>" }.

14 Composants Intégrés ​

Tout renderer conforme ARP doit supporter au minimum text. Les composants déclarent des chaînes de repli — chart revient à table, qui revient à text.

Transports ​

SDKs Client ​

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"
    />
  )
}

Également disponibles : @haira/arp-vue pour Vue 3 et github.com/haira-lang/arp-go pour les backends Go.

Intégration Haira ​

Chaque serveur Haira parle ARP nativement. Aucune configuration requise.

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)
}

Cycle de Vie des Extensions ​

Les nouveaux composants suivent un cycle de vie en trois phases inspiré de Wayland :

Niveaux de Conformité ​