Skip to content

Prism

Sight begins when a source survives the seeing.

Prism is LychD's visual and spatial grounding and transformation Extension Domain. It turns admitted sources into bounded transformations and observations without letting captions, OCR, crops, reconstructions, conversions, or model judgments replace them.

Vision admission is Partial: current code preserves immutable ArtifactRef metadata, projects image modality, distinguishes vision from image-capable chat, and filters declarations, but no Prism package, byte-custody or materialization path, OCR tool, or visual provider ships today. State of Work owns that boundary; ADR 36 owns the designed contract.

Several faculties, one source

One Prism deployment or requested capability set may compose a dedicated vision provider, precise Sight workers, an OCR extractor, a deterministic decode or transform service, a Form worker, and an image-capable multimodal chat provider—which remains chat. Each immutable capability profile is still one exact implementation closure. Image, video, spatial-form, or structured-motion generation and editing stay under separate effect or tool contracts. Activating one neither loads the others nor creates another routing system.

Sight records the finite typed-perception contract for boxes, masks, tracks, depth, pose, flow, and registered comparison; the owned worker boundary and first permissive profiles; and the stricter future session required before cameras or streams enter.

Scanner records the evolving candidate engines, pipeline servers, transport shapes, license gates, and bake required before one implements this stable Prism boundary.

Image records the complementary OpenAI Images serving route, the full ComfyUI workflow route, permissive first model profiles, and the stasis and provenance law for text- or image-conditioned visual creation.

Video records the asynchronous temporal-effect contract, simple and graph-serving routes, permissive and specialist model profiles, arbitrary-iron placement law, and the boundary between generated clips, visual direction, and final editing.

Form records the spatial-form contract for generated or reconstructed geometry, appearance, parts, rigs, portable assemblies, radiance and Gaussian forms, voxels, block-native generation, and bounded procedures without collapsing those facets or granting engine and world authority.

Kinesis records the structured-motion contract for finite recovery, generation, retargeting, technical cleanup, cue synchronization, validation, and portable projections; its FOSS tool base and license-gated model profiles; and the later bounded session required for live motion.

Designed interface register

These are semantic interfaces, not delivered source or claims that every provider implements every operation:

Interface Operations Domain request/result Execution binding First dialect/driver study
prism.image@1 generate, edit, inpaint, control, enhance ImageJob@1 and image artifacts/receipts Animator durable_jobJobGrant OpenAI Images subset or Comfy job driver
prism.video@1 t2v, i2v, v2v, first_last, continue, motion_transfer, audio_driven VideoJob@1 and video artifacts/receipts Animator durable_jobJobGrant OpenAI Videos job subset or Comfy job driver
prism.sight@1 classify, detect, ground, segment, estimate_depth, estimate_pose, estimate_flow, track, compare SightJob@1 / VisualObservationSet@1 Animator call/durable_job → matching grant; finite tool → Resolution Lock + ToolProfile Prism worker or proved tensor-service driver
prism.form@1 generate, reconstruct, texture, segment_parts, rig, voxelize, block_generate, convert, render FormJob@1 / FormAssetSet@1 Animator job → JobGrant; finite tool → Resolution Lock + ToolProfile Prism worker, Comfy job, or finite tool driver
prism.kinesis@1 recover, generate, retarget, synchronize, clean, convert, validate KinesisJob@1 / motion or findings set Animator job → JobGrant; finite tool → Resolution Lock + ToolProfile Prism worker or finite tool driver
prism.scanner@1 inspect, extract, OCR, structure Scanner request / DocumentObservation@1 Animator call/job → matching grant; direct tool → Resolution Lock + ToolProfile direct worker, native/REST call, or provider job driver

ImageJob, VideoJob, SightJob, FormJob, and KinesisJob are domain work identities. Each asynchronous or durable provider or local execution is a separately identified ServiceJobAttempt@1. One domain job may receive another attempt only through declared forward-branch or retry law; the shared mechanics do not collapse these contracts into a generic MediaJob.

Two execution paths remain explicit. A resident, shared, independently queued, or remote service is an Animator reached through CapabilityDemand@1 and a typed grant. A finite library, CLI, or subprocess is selected by the Spell Resolution Lock and delivered by a Worker into a trusted executor or Tomb under an immutable ToolProfile; it does not become a fake Animator or Rune. Either path may use ServiceJobAttempt@1 when it must survive the invoking Ghoul. A wrapper becomes an Animator only when its independent lifecycle, residency, queue, or remote boundary justifies it.

The optic path

admit source into custody
→ authorize materialization
→ inspect and decode
→ apply a declared transform
→ resolve an exact finite tool or dispatch an eligible provider
→ retain a grounded observation or derived artifact

The Reliquary must own source bytes before Prism acts. An ArtifactRef is immutable metadata, not byte custody or bearer authority; the designed materializer rechecks authority on every read. The source remains under its retention policy; see the artifact-reference boundary.

A deterministic transform produces a derived artifact recording parent and result digests, operation, immutable implementation revision, parameters, and declared loss. Provider request encodings and handles are transport forms, not universal storage or durable custody. Any retained visual output returns to artifact custody with provenance.

A grounded observation keeps the source and derivative chain, relevant page, frame, time, or region, requested task and output, the producing provider or deterministic operation with its immutable revision, and appropriate uncertainty. It distinguishes extraction, measurement, and inference. Generated or edited media is a new artifact with effect provenance. A caption or OCR result may enter bounded Context; it is not the image and cannot silently replace or delete it.

Sight on finite iron

Prism uses ordinary Capabilities and Dispatcher routing. A local provider may be a managed Soulstone; a remote service remains an explicit Portal. For an otherwise eligible managed binding that is not WARM, Dispatcher returns HardwareTransitionRequired; the requesting Run enters Graph Stasis while Orchestrator converges readiness, then re-dispatches. The waiting transition carries no lease; Prism cannot revoke an issued lease or infer remote fallback from scarce local iron.

Designed Portal egress additionally requires eligible classification, explicit policy, consent where required, and a cost bound. Policy is evaluated on both the source and every derived artifact: a crop, caption, or normalized frame cannot launder restricted pixels.