Skip to main content

ascii.platphormnews.com

Automation Guide

The primary UI stays focused on human image-to-ASCII conversion. Automation uses public REST routes, chunked artifact manifests, NDJSON streams, and MCP tools around the same real conversion engine. Text payloads stay compact; color travels as rich clipboard, local deASCII handoff, or API sidecar metadata.

Transport Matrix

CapabilityStatusRoutesUse
REST synchronous conversionimplemented/api/convert, /api/convert/url, /api/convert/browserops, /api/convert/agentuiSmall and medium conversions, trusted artifact URL intake, and standard request/response automation.
Chunked artifact manifestsimplemented/api/convert/chunked, /api/artifacts/{id}/manifest, /api/artifacts/{id}/chunksLarge output, proof artifacts, continuation links, hashes, and export formats.
NDJSON conversion streamimplemented/api/convert/streamLine-delimited manifest and chunk records for agents that want progressive reads without SSE.
MCP JSON-RPC toolsimplemented/api/mcp, /.well-known/mcp.jsonAgent tool calls, resources, prompts, conversion previews, artifact manifests, and public-safe introspection.
Atom/RSS update feedsimplemented_for_updates/atom.xml, /rss.xml, /feed.xmlPublic change discovery and capability updates. These feeds are not conversion transports.
Server-Sent Eventsnot_implemented_not_requirednoneNot needed for current conversion because NDJSON streaming, chunk manifests, and MCP cover automation needs.
Async queued conversion jobsplannednoneFuture durable jobs for long-running, persisted, or multi-step conversions once durable storage is configured.

Human Use

Use the converter screen for upload, tuning, preview, copy, local text/PNG/Markdown export, and the explicit deASCII action when reconstruction should open with compact text and chroma attached.

Agent Use

Prefer MCP for tool calling and artifact discovery. Use REST for direct integration. Use /api/convert/stream when the client wants line-delimited records.

Workflow Proof

BrowserOps and AgentUI should send a real screenshot image artifact URL or inline image payload. A run URL without screenshot evidence is not enough to claim ASCII conversion.

Public Boundary

Trusted *.platphormnews.com and Vercel Blob image artifact URLs convert without PLATPHORM_API_KEY. Untrusted external image URLs, persistence, publishing, outbound handoffs, webhook mutation, and report generation require the shared platform key. Atom/RSS feeds at https://ascii.platphormnews.com/atom.xml and https://ascii.platphormnews.com/rss.xml are for public update discovery, not conversion transport.