Crate warhorn 

Warhorn

Protocol types for AI agent communication - signals between goblins.

This crate defines the message protocol inspired by codex-kaioken’s Op/Event pattern:

• Operations (Op): Messages sent FROM UI TO agent orchestrator
• Events: Messages sent FROM agent orchestrator TO UI

Architecture

┌──────────────┐     Op      ┌──────────────────┐
│     UI       │ ──────────▶ │      Cabal       │
│  (Terminal)  │             │  (Orchestrator)  │
│              │ ◀────────── │                  │
└──────────────┘    Event    └──────────────────┘

Transport Agnostic

These types can be serialized over any transport:

• In-process channels (tokio mpsc)
• Unix domain sockets
• stdio (for MCP compatibility)
• WebSocket (for remote agents)

Re-exports

pub use ops::Op;

pub use events::Event;

pub use error::ProtocolError;

pub use ids::*;

pub use models::*;

Modules

error

Protocol error types

events

Events sent from Goblin orchestrator to UI

ids

Strongly-typed identifiers for protocol entities

models

Data models used across the protocol

ops

Operations sent from UI to Goblin orchestrator

Constants

PROTOCOL_VERSION

Protocol version for compatibility checking