Apron チャットプロトコル: セルフホストサーバー向けの最小限のJSONチャットプロトコル

Apron は、セルフホストチャットのための最小限のプロトコルであり、Hacker News ユーザーの shazow によって apron.chat で公開されています。その中心的な主張は、意図的なトレードオフです。コアは、動作するサーバーを約100行で書けるほど小さく、一方でオプションの機能が部屋、スレッド、ボット、リアクションなどに拡張します。

このプロジェクトは Show HN として投稿され、執筆時点で Hacker News のスレッドでは30ポイント、コメントはありませんでした。

プロトコルは WebSocket を含むあらゆるトランスポート上の JSON です

Apron は独自のフレーミングやトランスポートを定義しません。メッセージは任意のトランスポートで送信される JSON オブジェクトであり、例として WebSocket が挙げられています。コアは非常に小さく、追加機能はオプションで段階的に追加され、クライアントやサーバーが実装していない機能を無視できるようにグレースフルフォールバックが用意されています。

このプロジェクトの設計原則は「必要なものだけを構築する」です。

公開されている例のセッションは次のようになります。サーバーが最初に自身をアドバタイズします:

{"method": "server", "params": {"apron": 10, "auth": ["guest"]}}

次にクライアントが認証します:

{"method": "auth", "id": "c1", "params": {"scheme": "guest", "name": "Ada"}}
{"id": "c1", "result": {"you": {"user_id": "guest_1234", "name": "Ada"}}}

そしてメッセージを送信します:

{"method": "message", "id": "c2", "params": {"body": {"text": "Hello"}}}
{"method": "message", "params": {"room_id": "general", "from": {"user_id": "guest_1234"}, ...}}
{"id": "c2", "result": {"message_id": "1724803200042"}}

このやり取りには3つの構造的な詳細が見られます。リクエストは method とオプションの id を持ち、レスポンスは id をエコーして result を持ちます。サーバーのハンドシェイクは、サポートされている認証スキームとともに "apron": 10 をアドバタイズし、例では表示名を持つ guest スキームを使用しています。例のメッセージIDは 1724803200042 のようなミリ秒形式の数値文字列です。

Apron は AI エージェントが読んで実装できるように設計されています

このプロジェクトは、apron.chat/llms.txt にエージェント向けのエントリポイントを公開しています。そのファイルは、Markdown の仕様、リファレンスサーバー、クライアント、JSON Schema、およびテスト用のワイヤーフィクスチャをリンクしています。

これはチャットプロトコルとしては注目すべき選択です。実装者を散文のドキュメントだけに誘導するのではなく、Apron は機械で検証可能な成果物(スキーマとワイヤーフィクスチャ)を提供し、生成されたクライアントやサーバーが実際のメッセージ形式に対して検証できるようにしています。

公開デモは3つのデプロイ形態を示しています

サイトは公開デモサーバーと、任意のサーバーを指定できる Apron Web クライアントをホストしています。プロトコルの範囲を示すために3つのシナリオが提示されています:

  • チームチャット。 部屋、スレッド、ダイレクトメッセージ、ボット、返信、メンション、ターミナル、リアクション、プレゼンス。
  • ファミリーチャット。 プライベートルーム、スレッド、返信、リアクション、アバター、タイピングインジケーター。
  • サポートデスク。 ボットの群れ、チケットごとに1つのスレッド、そしてそれらすべてで共有される単一の回答。

これらのシナリオは、最小限のコアが機能の上限を制限しないというプロジェクトの主張です。プレゼンス、タイピングインジケーター、スレッド、リアクションはすべて、同じ JSON メッセージ形式に重ねられたオプション機能として到達可能です。

サーバーとクライアントは分離された交換可能な部品です

Apron は、サーバーとクライアントが独立するように構成されています。サイトには、特定のユースケースに合わせて実行または変更することを意図したリファレンスサーバー実装と、任意のサーバーに参加できるクライアントがリストされています。目標は、ユーザーが好みのクライアントで任意のサーバーに参加できるか、新しいものを構築できることです。

プロトコルは汎用トランスポート上の JSON であり、コアは意図的に小さいため、リファレンス実装は唯一のサポートスタックではなく、出発点として機能します。

FAQ にはプロジェクトが想定する質問がリストされています

プロジェクトの GitHub リポジトリでホストされている Apron FAQ は、繰り返し発生する反論に対応しています。公開されている質問リストは次のとおりです:

  • あなたは誰ですか?
  • なぜ Apron チャットプロトコルを作ったのですか?
  • 暗号化はありますか?安全ですか?
  • なぜ XMPP/Matrix/IRCv3 などではないのですか?
  • なぜ Slack/Discord/Zulip などではないのですか?
  • なぜ別の標準なのですか?XKCD 927!
  • AI は Apron の作成にどのように使われましたか?それはスロップですか?
  • Apron はビジネスですか?
  • なぜ Apron という名前なのですか?
  • わかりました、どうやって試せばいいですか?

XKCD 927 の質問(競合する標準についての漫画)と「スロップですか?」という質問の存在は、著者が2つの特定の批判を予期していることを示しています。新しいチャットプロトコルが断片化を減らすのではなく増やすこと、そして AI 支援プロジェクトは真剣なエンジニアリング努力ではないかもしれないことです。回答自体はランディングページではなくリンクされた FAQ にあります。

ソース資料が確立していないこと

ランディングページと Hacker News の投稿は、ライセンス、ガバナンスモデル、セキュリティまたは暗号化の設計、またはハンドシェイク例の "apron": 10 値以外のバージョン履歴を明記していません。Hacker News のスレッドは収集時点でコメントがなかったため、ここで総合するコミュニティの議論、反論、メンテナーの応答はありません。本番使用のために Apron を評価する読者は、ランディングページだけに頼るのではなく、apron.chat/llms.txt からリンクされている仕様、JSON Schema、ワイヤーフィクスチャ、および GitHub リポジトリの FAQ を参照する必要があります。

Sources