# signal:// A2V

> Reconstruct video from ASCII/asciicast/JSON-stream input in the browser and
> render ASCII text into SVG, HTML, ANSI, JSON, NDJSON, or plain text artifacts
> over HTTP. Version 1.0.0.

## What it does
- Browser studio for pasted ASCII, ANSI text, multi-frame text, JSON/NDJSON frame streams, and asciicast recordings.
- Trusted source handoffs from https://v2a.platphormnews.com and local WebM artifact uploads.
- Live V2A frame handoffs accept nested frame.text plus optional exact rgb24-b64-v1 cell chroma, and acknowledge accepted frames with platphorm:a2v:ack.
- Video recording/export of animated ASCII effects.
- Source-quality restoration when the handoff includes the original WebM/source artifact.
- Server API to render ASCII into SVG, HTML, ANSI, JSON, NDJSON, or text.
- MCP server so agents can render ASCII artifacts as a tool call.
- W3C trace context on render and MCP calls, with public-safe Trace spans/evidence and response trace links when export is configured.

## Input support
- Raw ASCII or ANSI text.
- Multi-frame text split by --- / === / ~~~ / ### delimiter lines.
- asciicast v2 newline-delimited JSON, parsed best-effort into frame snapshots.
- A2V JSON frame arrays, { frames: [...] } documents, and NDJSON frame objects.
- Trusted source handoff JSON, URL-fragment payloads, and postMessage payloads from v2a.platphormnews.com.
- WebM artifacts are played/exported as source media rather than being degraded through ASCII.
- JSON fields: ascii, asciiUrl, asciiBase64.
- multipart/form-data field: ascii.
- raw text/plain request body.

## Endpoints
- GET  https://a2v.platphormnews.com/api/health — liveness + capabilities
- POST https://a2v.platphormnews.com/api/v1/render — ASCII/asciicast/JSON-stream -> SVG/HTML/ANSI/JSON/NDJSON/text
- POST https://a2v.platphormnews.com/api/mcp — Model Context Protocol (JSON-RPC 2.0), tool: render_ascii
- GET  https://a2v.platphormnews.com/api/openapi.json — OpenAPI 3.1 spec
- GET  https://a2v.platphormnews.com/llms-index.json — discovery index
- GET  https://a2v.platphormnews.com/.well-known/trust.json — PlatPhorm trust and public/protected boundary

## Render parameters
- format (enum, default svg): svg | html | ansi | json | json-stream | text output artifact.
- monoColor (hex, default #22c55e): Phosphor / glyph color.
- background (hex, default #050805): Backdrop color (svg/html).
- glow (float 0–1, default 0.6): CRT phosphor bloom amount (svg/html).
- scanlines (boolean, default true): Overlay CRT scanlines (svg/html).
- fontSize (integer 6–48, default 14): Cell height in px (svg/html).
- gradientTo (hex | null, default null): Optional top→bottom gradient target color.
- frame (integer, default 0): Frame index for multi-frame / .cast input.
- trim (boolean, default true): Trim blank border rows and columns.

## Quick start
curl -F "ascii=@frame.txt" "https://a2v.platphormnews.com/api/v1/render?format=svg"

curl -X POST https://a2v.platphormnews.com/api/v1/render \
  -H "Content-Type: application/json" \
  -d '{"ascii":"signal://a2v","format":"html","monoColor":"#22c55e"}'

curl -X POST https://a2v.platphormnews.com/api/v1/render \
  -H "Content-Type: application/json" \
  -d '{"ascii":"{\"frames\":[\"A2V frame 1\",\"A2V frame 2\"]}","format":"json-stream"}'

## MCP
POST https://a2v.platphormnews.com/api/mcp with a JSON-RPC body:
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"render_ascii","arguments":{"ascii":"signal://a2v","format":"ansi"}}}