# Cyberart

> Explain host, runtime, and cart: the host owns the page and capabilities; the runtime mounts a cart; the cart is a state machine that optionally paints.

@cyberart-io/engine 0.0.12. Documentation is generated from one validated manifest; the JSON index at https://dgadsuq3fvhh4.cloudfront.net/docs/agent/index.json is canonical and carries `schemaVersion`, `sourceRevision`, `enginePackageVersion`, `generatedAt`, and `contentHash` (sha256 of the document without `generatedAt`). Pin by `sourceRevision` or `contentHash`; feature ids, slugs, routes, and anchors are stable while titles may change. Sections are tagged normative / tutorial / example / provenance; only `substantial` features are normative.

- Engine: @cyberart-io/engine 0.0.12
- Manifest schema: 1 · Agent surface schema: 2
- Source revision: cdbb9388980b61e901885b57e006eddae4e168fb
- Content hash: 443533f81a3bcac4bea709d794388786b96ea4f95149f05bfb7c14e12142f077
- Generated at: 2026-10-20T05:44:25.751Z

## Docs

- [Framework overview](https://dgadsuq3fvhh4.cloudfront.net/docs): host, runtime, and cart mental model
- [Getting started](https://dgadsuq3fvhh4.cloudfront.net/docs/getting-started): install, write a cart, mount, start
- [Feature index](https://dgadsuq3fvhh4.cloudfront.net/docs/features): human listing of routed features
- [Agent index (JSON)](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/index.json): every feature, example, redirect, and deprecation with provenance
- [Agent index (Markdown)](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/index.md): same content as text
- [Index JSON Schema](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/schema/index.schema.json): draft 2020-12 schema for the index; feature documents use https://dgadsuq3fvhh4.cloudfront.net/docs/agent/schema/feature.schema.json

## Features

- [runtime](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/runtime.json): Runtime and carts (substantial) — Mount an AnimationCart into a host-owned DOM element, run the update/render loop, and expose pause, snapshot, events, and teardown. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/runtime
- [random](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/random.json): Seeded random (substantial) — Art Blocks / kautomata sfc32 Random plus token seed helpers so generative output follows the hash. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/random
- [keyboard](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/keyboard.json): Keyboard manager (substantial) — Cart-facing single-character key bindings with optional window capture and deterministic inject(). Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/keyboard
- [pointer](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/pointer.json): Pointer manager (substantial) — Canvas pointer position, buttons, and click queue, with listen:false for deterministic inject. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/pointer
- [midi](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/midi.json): MIDI (substantial) — Host-owned MidiManager: note/CC/pitch in and out, inject/fake port, structured requestAccess. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/midi
- [calculation-carts](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/calculation-carts.json): Calculation carts (substantial) — kind: calculation runs update and events without a canvas so a sibling render cart can paint. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/calculation-carts
- [deterministic-mode](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/deterministic-mode.json): Deterministic mode (substantial) — step/schedule, virtual clocks, ScriptedAction, and replay diffs so CI can drive a cart without wall time. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/deterministic-mode
- [events](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/events.json): Events and router (substantial) — Mailbox envelope, typed contracts, createEventRouter, hops, idempotency, and rejections. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/events
- [snapshots](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/snapshots.json): Snapshots (substantial) — Versioned snapshot envelope, defineSnapshot / parseSnapshot, and host-owned migrations. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/snapshots
- [presentation-adapter](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/presentation-adapter.json): Presentation adapter (substantial) — Host-owned render model with loading / ready / error / unsupported phases and typed intents. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/presentation-adapter
- [presentation-cue](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/presentation-cue.json): Presentation cue (substantial) — Deterministic createPresentationTimeline with duplicate policy, reduced-motion, and cue lifecycle events. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/presentation-cue
- [loading-indicator](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/loading-indicator.json): Loading indicator (substantial) — Host-facing presentation-only loader carts with seeded variants, honest progress, snapshot/restore, and builtin fallback. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/loading-indicator
- [asset-resolver](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/asset-resolver.json): Asset resolver (substantial) — Host-pluggable images/audio/fonts/spritesheets with cache, preload, provenance, and silent fallbacks. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/asset-resolver
- [audio](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/audio.json): Audio broker and cues (substantial) — Shared unlock broker plus deterministic audio cue timeline. PCM is not deterministic; headless traces are. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/audio
- [capability-manifest](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/capability-manifest.json): Capability manifest (substantial) — Versioned JSON for runtime features, phases, managers, assets, events, permissions, and integrations. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/capability-manifest
- [executable-modules](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/executable-modules.json): Executable modules (substantial) — Trusted versioned factories, host allowlists, isolation, and per-module failures. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/executable-modules
- [normalized-geometry](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/normalized-geometry.json): Normalized geometry (substantial) — Coordinate spaces, contain/cover/crop layout, landmarks, hit regions, and a debug overlay. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/normalized-geometry
- [runtime-group](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/runtime-group.json): Runtime group (substantial) — createRuntimeGroup: several carts, shared router attach, lockstep clock. Headless twin is createHeadlessMultiCartHarness. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/runtime-group
- [compositor](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/compositor.json): Compositor (substantial) — Transparent multi-cart stacking, blend modes, and captureComposedFrame / writeComposedFrame. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/compositor
- [visual-layers](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/visual-layers.json): Visual layers (substantial) — Versioned overlay layers, deterministic swaps, and hostState JSON projected onto paint. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/visual-layers
- [semantic-layers](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/semantic-layers.json): Semantic layers (substantial) — Named mask/polygon/rect/depth regions, host a11y names/roles, and hit-test policies. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/semantic-layers
- [presentation-sequences](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/presentation-sequences.json): Presentation sequences (substantial) — One frame-stepped clock across audio, captions, semantic focus, visual layers, and cues, with skip/fallback/restore. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/presentation-sequences
- [presentation-bindings](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/presentation-bindings.json): Presentation bindings (substantial) — Versioned manifest projecting host state onto visual versions, presence, regions, and sequences; fail-closed defaults. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/presentation-bindings
- [portal-lifecycle](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/portal-lifecycle.json): Portal lifecycle (substantial) — Enter/exit/abort another cart exclusively, with parent suspend, grant transfer, and nested stack restore. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/portal-lifecycle
- [job-orchestration](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/job-orchestration.json): Job orchestration (substantial) — Durable queued jobs with retries, leases, evaluator feedback, and host-owned apply. Results are refs, not payloads. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/job-orchestration
- [world-graph](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/world-graph.json): World graph (substantial) — Optional spatial graph with stable ids, canonical vs known projections, and semantic-time transit. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/world-graph
- [world-patch](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/world-patch.json): World patch (substantial) — Transactional dry-run and atomic commit of a generated world patch as one revision. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/world-patch
- [content-revision](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/content-revision.json): Content revision (substantial) — Atomic staging and commit of an external content bundle with last-known-good rollback. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/content-revision
- [remote-cart-manifest](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/remote-cart-manifest.json): Remote cart manifests (substantial) — HMAC-signed versioned catalogs, declared asset hashes, deny-by-default host grants, no ambient network. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/remote-cart-manifest
- [headless-harness](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/headless-harness.json): Headless harness (substantial) — Node/jsdom createHeadlessHarness around production createRuntime({ deterministic }), software Canvas2D, and pixel asserts. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/headless-harness
- [frame-benchmark](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/frame-benchmark.json): Frame benchmarking (substantial) — benchmarkCartFrames (headless) and optional onFrameTiming (live); zero cost when unset. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/frame-benchmark
- [browser-harness](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/browser-harness.json): Browser harness (substantial) — createBrowserHarness: DOM clicks, viewport/DPR, composed screenshots, Playwright-compatible adapter. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/browser-harness
- [production-scenario](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/production-scenario.json): Production scenario (substantial) — One JSON scenario drives the real host/runtime/cart composition; evidence bundles record firstBrokenBoundary. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/production-scenario
- [replay-inspector](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/replay-inspector.json): Replay inspector (substantial) — Causation trees, redacted export/import, and headless replay of recorded traces. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/replay-inspector
- [selection-trace](https://dgadsuq3fvhh4.cloudfront.net/docs/agent/features/selection-trace.json): Selection trace (substantial) — Why a binding, revision, asset, sequence, or fallback won, with secret-safe export. Page: https://dgadsuq3fvhh4.cloudfront.net/docs/features/selection-trace

## Examples

- [create-runtime-canvas](https://dgadsuq3fvhh4.cloudfront.net/docs/examples/create-runtime-canvas): Silent createRuntime canvas fill — artifact available; source restricted; features runtime
- [calculation-capability](https://dgadsuq3fvhh4.cloudfront.net/docs/examples/calculation-capability): Calculation cart with capability manifest — artifact available; source restricted; features calculation-carts, capability-manifest, headless-harness
- [keyboard-inject](https://dgadsuq3fvhh4.cloudfront.net/docs/examples/keyboard-inject): Keyboard inject and key trace — artifact available; source restricted; features keyboard
- [audio-unlock](https://dgadsuq3fvhh4.cloudfront.net/docs/examples/audio-unlock): Audio unlock control — artifact available; source restricted; features audio
- [snapshot-restore](https://dgadsuq3fvhh4.cloudfront.net/docs/examples/snapshot-restore): Snapshot export and restore — artifact available; source restricted; features snapshots

## Optional

- [Sitemap](https://dgadsuq3fvhh4.cloudfront.net/sitemap.xml): every public page and discovery document