Connect the archive

Things an agent can do — render, mix, audit, export, scaffold.

get_instrument_state

Read half of the instrument round-trip: parse any Chromologium lab permalink (the URL a visitor shares from the Loom or the Thin-Film workbench) into its full recipe — the validated state, the resolved specimen data (threading plan or film physics), the fringe or thread palette, and the plate/embed URLs. Give it a URL a human made; get back everything needed to reproduce or vary it.

render_instrument

Write half of the instrument round-trip: given an instrument and a state, return the artefact as text-native output — the Loom yields editable SVG (thread-level rects), dependency-free repeating-linear-gradient CSS, and the weaver's draft; the thin film yields an interference-gradient SVG and its physics-sampled fringe stops. Also returns the permalink and PNG plate URL for the state, so an agent can hand its user a finished, provenance-stamped image.

generate_pattern

Commission a generative pattern from the Pattern Press: Truchet tilings, flow fields, isometric lattices, or interference meshes. Returns editable SVG (every mark its own element), a permalink, a stamped plate URL, and — for the families that genuinely tile — dependency-free CSS. Deterministic in its seed, so the same arguments always return the same sheet. Colours default to the archive's canonical ink but may be overridden to match a caller's own tokens.

marble_trough

Float archival pigments on a size bath and draw a comb through them — the ebru technique behind old bookbinders' endpapers. Returns the marbler's recipe (every drop in the order it was floated, and the comb drawn through them), a permalink and a stamped plate URL. Note that marbled paints do not blend: each colour holds its own boundary on the size, which is why the result reads as crisp veins rather than a wash.

teleprint

Re-type one of the archive's specimens as character art and return it as plain text, ready to paste into a README or a terminal. Sources are the archive's own instruments (a woven cloth, an interference film, a pressed pattern, a marbled sheet); each cell takes the character whose ink coverage is nearest its brightness, after the sheet is stretched to its own tonal range, so the result reads as tone rather than as texture.

list_looks

The curated looks catalogue — named, permalinkable instrument states (the same rail shown on each lab). The browsable menu an agent can offer before tuning by hand.

export_palette

Colours out in the file formats designers' tools import: GIMP .gpl (also Krita, Inkscape, Aseprite) and Tokens Studio JSON inline; Adobe .ase and Procreate .swatches as base64. Pass explicit colours, or an instrument state (a loom cloth's threading plan, a thin film's fringe stops) to export what the archive computed.

get_material_optics

Retrieve the authored optical coefficients for a catalogued national material — scatter depth, micro-facet roughness, specular anisotropy, metalness, refractive index at 589 nm, and patina rate — plus its tactile profile, damping regime, and the artwork citation. These are the exact values that drive the Chromologium's GPU material plates.

mix_pigments

Mix two or more archival pigments using genuine two-constant Kubelka–Munk subtractive scattering (K/S = (1−R)²/2R), the way paint actually mixes — not an RGB average. Returns the mixed colour alongside the naive additive average so the difference is visible.

audit_apca_contrast

Compute the APCA Lc (Advanced Perceptual Contrast Algorithm) score between text and background colors with plain-language WCAG 3 verdicts. Supports single color pairs or batch arrays of pairs, plus optional font size / weight lookup for exact pass/fail evaluation.

suggest_passing_color

Suggest the nearest color in OKLCH that passes a desired APCA contrast threshold against a given background substrate, preserving the original hue and chroma while minimally shifting lightness.

get_movement_tokens

Retrieve the full token set for one of the six calibrated design movements in a given substrate mode, returning both OKLCH and Hex values, CSS variables, Tailwind v4 @theme blocks, contrast scores, kinetics, and acoustics.

get_earcon

Retrieve the resonant acoustic profile for a catalogued nation — frequency in Hz, waveform, source instrument, cultural lineage, and psychoacoustic rationale — for synthesising a culturally-grounded UI earcon.

search_archive

Full-text search across the entire Chromologium archive — 31 sovereign entries, 12 archival pigments, 6 movements, 41 lexicon terms, 9 monographs, and 8 lab workbenches — returning matches with their canonical URLs.

cite

Generate citations and attribution blocks for project colophons, /about pages, README acknowledgments, monographs, and catalogued artworks in APA, BibTeX, JSX/HTML Colophon, or Markdown formats.

generate_accessible_scale

Generate a calibrated 10-step (50–950) OKLCH perceptual color scale from any seed color, guaranteeing monotonic lightness distribution, APCA Lc contrast ratings for black/white text pairings on every step, and ready-to-use CSS variables, Tailwind v4 @theme, and W3C DTCG JSON blocks.

export_platform_tokens

Export a visual movement's complete token dictionary into native platform architectures: iOS (Swift / SwiftUI), Android (Kotlin / Jetpack Compose), Figma Tokens Studio (W3C DTCG standard), Style Dictionary JSON, or Tailwind v4 @theme CSS.

scaffold_component

Generate production-ready, fully accessible React + TypeScript component code (Button, Card, Dialog/Modal, Range Slider, Badge, Tabs) styled with the specified movement's OKLCH design tokens, Framer Motion spring physics, and ADA/WCAG 2.2 Level AA semantics.

validate_theme_token_matrix

Audit an entire site or design-system theme token dictionary across both dark and light modes, verifying WCAG 2.1 AA (4.5:1 body / 3.0:1 UI) and APCA Lc compliance for all foreground/background pairings. Identifies failing pairs in either mode and suggests compliant color replacements.

lint_component_accessibility

Pre-flight static audit of React/JSX component code for ADA/WCAG 2.1 AA violations, nested interactive elements, missing form/icon labels, keyboard traps in scrollable regions, hardcoded dark chamber inks, and CSS selector collision hazards.

audit_viewport_resilience

Audit JSX layout patterns and Tailwind CSS classes for mobile viewport traps: rigid min-widths > 320px, non-responsive multi-column grids, and un-padded pre/code blocks causing horizontal blowout on narrow mobile screens (320px–375px).

get_registry_component

Retrieve full installation manifest, typed props, dependencies, code integration boilerplate, and curatorial colophon suggestions for any Chromologium shadcn-compatible component (e.g. 'specimen-document-deck', 'material-plate'). Includes optional Colophon Seal and reference snippets the agent can suggest to the user.