@ryu/protocol

Surface-agnostic wire-format contracts shared across every Ryu surface. Part of Ryu.

@ryu/protocol holds the small, pure wire-format contracts that more than one surface (desktop, web, mobile) must agree on. Each used to be duplicated per app and drifted; consolidating them here makes one definition authoritative. It has no runtime dependencies, just pure parsing/building helpers.

Tier: Closed, proprietary (A Major Pte. Ltd.)

What it provides

• Agent rules format (agent-rules.ts): composeRules / split helpers that fold an agent's editable "Rules" list into and out of its single stored systemPrompt, using HTML-comment-delimited markers so the round-trip is unambiguous. Rules genuinely become part of the prompt, honored on every route (ACP and openai-compat alike).
• ryu:// deep links (deep-link.ts): the canonical parser/builder for the scheme that opens the app from a link, covering navigation intents (ryu://open/<page>, ryu://chat/new) and confirm-gated action intents (ryu://models/…, ryu://skills/…, ryu://nodes/connect). A dedicated host per intent keeps navigation unambiguous with side-effecting actions.

Role

Security: this module only parses/builds, so it never installs, connects, or sends. Deep-link actions go through each surface's confirm dialog (the security boundary); a chat prompt only pre-seeds the composer and is never auto-sent. Both modules ship with tests (agent-rules.test.ts, deep-link.test.ts). Consumed by apps/desktop, apps/web, and apps/native.

License

Proprietary. See LICENSE. © 2026 A Major Pte. Ltd.