PASH Protocol

What is PASH?

The AI doesn't write markup. It sends intent. The client renders.

PASH is a token-efficient text format for transmitting UI components from LLMs to clients.

Instead of HTML (52 tokens):

<div class="product-card"><h3>Смартфон X1</h3><p>AMOLED 120Hz</p>
<span class="price">69 990 ₽</span><button>Купить</button></div>

The AI outputs PASH (11 tokens — 79% fewer):

1|Смартфон X1|AMOLED 120Hz|69990|Купить

Your client knows 1 = ProductCard, renders it with your CSS, your locale, your design system.

Quick Start

Step 1 — Install

npm install pash-sdk @pash/prompt

Step 2 — Generate system prompt

const { PromptEngine } = require('@pash/prompt');
const { SCHEMAS }      = require('pash-sdk');

const engine = new PromptEngine({ schemas: SCHEMAS });
const system = engine.generate({ lang: 'ru', mode: 'pash' });
// Auto-generated from your component registry. Always in sync.

Step 3 — Decode AI response

const { decodeStream, renderStream } = require('pash-sdk');

const aiResponse = `
1|Смартфон X1|AMOLED 120Hz, 256GB|69990|Купить
2|warn|Последний в наличии
`;

const decoded = decodeStream(aiResponse);
// { version: null, components: [ ProductCard, Notification ] }

document.getElementById('output').innerHTML = renderStream(decoded);

Step 4 — Streaming (optional)

const { StreamingDecoder, renderComponent } = require('pash-sdk');

const decoder = new StreamingDecoder((component) => {
  document.getElementById('output').innerHTML += renderComponent(component);
});

const response = await fetch('/api/ai');
const reader   = response.body.getReader();
const utf8     = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) { decoder.flush(); break; }
  decoder.push(utf8.decode(value));
}

Format

COMP_ID|field1|field2|field3|...

• | — separator (1 BPE token in GPT-4, LLaMA-3)
• \| — escaped pipe inside a value
• # — nested component prefix
• v:1 — optional version header (first line)
• \n — component separator

Token efficiency

Component Registry

UI Components (ID 1–6)

PASH-Doc Blocks (ID 20–32)

* = required. ID 40+ available for custom components.

Modes

Custom component

const { registerComponent } = require('pash-sdk');

registerComponent(40, {
  name: 'UserCard',
  fields: [
    { id: 0, type: 'string', label: 'name',  required: true },
    { id: 1, type: 'string', label: 'email'                 },
  ],
  render: (f) => `<div class="user-card"><b>${f.name}</b><span>${f.email}</span></div>`,
});

// AI can now generate: 40|Иван Петров|ivan@example.com

Locale

const { setLocale } = require('pash-sdk');

setLocale('en-US');  // price: 69990 → $69,990
setLocale('de-DE');  // price: 69990 → 69.990 €
setLocale('ru-RU');  // price: 69990 → 69 990 ₽  (default)

SDK Modules

decodeStream parseLine encode encodeStream renderComponent renderStream StreamingDecoder EventStreamDecoder Dictionary setLocale addLocale validateStream registerComponent SCHEMAS VERSION

Links

• npm: pash-sdk
• npm: @akynzhe/pash-js
• GitHub: pash-sdk
• GitHub: pash-js
• System Prompts
• Specification

PASH v1.1.0 · MIT License · Copyright (c) 2026 Sergei