Gessa Docs
Generated Reference

Reference

AI World Build Contract

Sources: packages/world-build-contract/src/index.ts, packages/protocol/src/index.ts, packages/engine-version/src/index.ts.
engine v1.0.234Copy for LLM

This generated snapshot is derived from packages/world-build-contract. It is the Milestone 4B contract projection for prompt-to-world build contracts, renderer/material capabilities, deterministic demo recipes, QA eval receipts, and execution timeline coordinates.

Coordinates

CoordinateVersionHash
AI World Build Contractai-world-build-contract.v1.bistro-canonical-rebuild-phase1sha256:b05d3d5d36c6606b3310195ad75cb4d9194b748af1ba69c0ef62f50c5dedab3d
Workbench Product Claim Contractworkbench-product-claim-contract.v1sha256:2d9e79129fe980df390ee04acf077b633f3591e7d3ed9322a782c4a1bc73163d
Workbench Semantic Product Specworkbench-semantic-product-spec.v2sha256:50f30e3771b5dd2779f2f57ca1f8cc16352f6fd684a16a8d1cd29b5a6097024d
Renderer/Material Capability Catalogrenderer-material-capability-catalog.v1.bistro-canonical-rebuild-phase1sha256:3de48da98d3e9d29116fde017e7a95c75ebf7f887c4c149119677dba95d3cfed
Demo Recipe Catalogworld-build-demo-recipe-catalog.v1.bistro-canonical-rebuild-phase1sha256:47570f24b7b2e0a1504205f08ad56d46cefce542c4845bfe62788c4feebd93fe
QA/Eval Catalogworld-build-qa-eval-catalog.v1.spatial-proxy-proofsha256:c45215b495e1dd9c226f8f26cf46ddd6fdee9471d3d679ba080a356ab61e7bda
Execution Timelineworld-build-execution-timeline.v1sha256:96f461e7c45f82b3a76ee383c2b1bd05f34e38b0e69ee3e9ca01a433ea6d3456
Catalog Coordinatescompositesha256:d6ce5f9e6709fb40c82898d9a10656a2e453ece7f180ecc564ae900bab417f0d

Acceptance Policy

  • world.build.from_prompt is the canonical action for prompt-to-world build execution.
  • world.build.from_spatial_asset is the canonical action for turning imported/generated spatial assets into executable worlds.
  • Playable spatial world acceptance requires collision proxy, nav/query proxy, semantic anchor, and playability.accepted receipts; renderability alone is not playable proof.
  • Accepted build proof requires semantic contract proof, Project Graph validation, visible unsupported requirements, passing QA receipts, and a timeline receipt.
  • Generated assets may iterate through placeholders, but accepted final proof only permits terminal_success, substituted, or degraded asset receipts.
  • Renderer/material choices must reference cataloged capability ids; raw shader/pass fields such as shaderSource, fragmentShader, vertexShader, wgsl, glsl, renderPassCode, and customPassSource are forbidden.
  • Workbench product claims use explicit terminal states and proof tri-state; missing proof is not_run, not pass.

Workbench Product Claim Contracts

IntentSurfaceHashRequired childrenProject Graph artifactsScript/state/UI artifactsProof lanesPartial draft
read_onlychatsha256:28078b57591ab5812a4f5ee64ea8b7c6d8770fb961b50ea65b91ba59584fdadcNoneNoneNoneNoneno
small_editworkbench_buildsha256:9dece67541828ac9457408da146f5ed8c1ab52e8281cfa44864dfbf6413d06c0NoneNoneNoneproject_graphyes
script_editscript_fixsha256:ba0baee70777ae079fbfcf5e7cd72ff07941d8cb6d50f49574b8c8d4a8e7ef69NoneNonescript_behaviorscript_behavioryes
visual_world_buildworld_buildsha256:7817d2f9f1ff5b30ed5830cf58e09be738e5a2a6ec9b6e2ca2b666c7fbe1d107creative-world-layout<br>creative-visual-style<br>creative-proof-plan<br>foundation<br>scene<br>visual-qa-repairworld<br>visible_scene_entities<br>active_camera<br>lightingNoneproject_graph<br>observer_visual_qa<br>renderer_visual_qayes
playable_game_factoryfactory_buildsha256:6d1e07fb985b99609e4b4132f5833fbdc91b095d567416f28d14e2a65fabd893creative-gameplay-plan<br>creative-world-layout<br>creative-visual-style<br>creative-proof-plan<br>foundation<br>scene<br>factory-content<br>factory-script-attach<br>visual-qa-repair<br>factory-proofworld<br>visible_scene_entities<br>active_camera<br>lighting<br>smart_asset_package<br>player_spawn<br>player_control_path<br>runtime_controllerscript_behavior<br>typed_score_win_state<br>hud_bindingproject_graph<br>script_behavior<br>typed_state<br>hud<br>player_control<br>observer_visual_qa<br>renderer_visual_qa<br>runtime_play<br>factory_acceptanceyes
organic_playable_worldworld_buildsha256:53bd306f1fadf0a49fbbb3dd93af173a2043b6565c3a9aabac94344ffdf3a33dNoneworld<br>visible_scene_entitiesNoneproject_graph<br>runtime_playyes
debug_repairdebug_repairsha256:aa5318b8570991f25b6f0e3beedb616514867a02d67153ae35441bb2b4e2918bNoneNoneNoneproject_graphyes
qa_or_publish_proofqa_proofsha256:6080a2fd04ec8102c154e53b423f521bca790c3a59bd529d2010e86ef6c783a5NoneNoneNoneobserver_visual_qa<br>renderer_visual_qa<br>runtime_play<br>factory_acceptanceno
unknown_or_unsupportedchatsha256:d4f94ced9df30c21248877c3deb9e6f424ca6acf1a8420cae2dc74365706c1bdNoneNoneNoneNoneno

Workbench Semantic Product Spec

Normal Workbench AI build paths must produce a prompt-specific Semantic Product Spec before lowering to canonical world-build operations. Deterministic fixture defaults are only permitted in explicit test/demo fixture paths.

FieldMeaning
promptOriginal user prompt used for traceability and prompt-specific hashing.
intentWorkbench product claim intent such as visual_world_build or playable_game_factory.
genreOrWorldTypePlanner-selected semantic product category for this prompt.
targetExperienceShort user-facing experience goal that all projections derive from.
visualStyleMood, palette, and density for renderer/material planning.
regionsNamed semantic areas such as districts, lanes, routes, water, or parks.
entityClassesPrompt-specific entity classes that expand into semantic batch items.
gameplayLoopsGameplay loop descriptions and proof requirements for playable builds.
scriptBehaviorsScript Semantic Patch behavior intents; not raw Script IR or source.
typedStateTyped score/win/runtime state contract for playable builds.
uiHudHUD bindings backed by typed state, not renderer-only claims.
cameraSemantic camera mode, framing, transform, and fov.
lightingSemantic lighting rig and atmosphere.
materialsCatalog capability ids and material direction; raw shader/pass fields are forbidden.
proofPlanRequired visual/runtime/factory proof lanes.
acceptanceRubricPlanner acceptance criteria that product-claim proof must satisfy.
budgetPlanner budget for provider calls, cost, and child workers.

Renderer/Material Capabilities

CapabilityKindLabelOwnerProtocol FieldsRequired PrimitivesQA Coverage
material.matte@1material_recipeMatte MaterialrendererProjectMaterialPayload.baseColor<br>ProjectMaterialPayload.roughnessprimitive.project_graph.material_assetqa.project_graph.assets<br>qa.renderer.material_pbr
material.metal@1material_recipeMetal MaterialrendererProjectMaterialPayload.metallic<br>ProjectMaterialPayload.roughnessprimitive.renderer.material_pbr_advancedqa.renderer.material_pbr
material.glass@1material_recipeGlass MaterialrendererProjectMaterialPayload.transmission<br>ProjectMaterialPayload.alphaModeprimitive.renderer.material_pbr_advancedqa.renderer.material_pbr<br>qa.render_browser_qa.visual
material.emissive@1material_recipeEmissive MaterialrendererProjectMaterialPayload.emissiveColor<br>ProjectMaterialPayload.emissiveIntensityprimitive.renderer.material_pbr_advancedqa.renderer.material_pbr
material.toon@1material_recipeToon MaterialrendererProjectMaterialPayload.shadingModelprimitive.project_graph.material_assetqa.renderer.surface_response_toon<br>qa.render_browser_qa.visual
material.holographic@1material_recipeHolographic MaterialrendererProjectMaterialPayload.emissiveColor<br>ProjectMaterialPayload.alphaModeprimitive.renderer.material_pbr_advancedqa.renderer.material_pbr<br>qa.render_budget
material.terrain_layered@1material_recipeLayered Terrain MaterialrendererSceneSnapshotTerrain.materialprimitive.renderer.terrainqa.renderer.terrain
material.water@1material_recipeWater MaterialrendererSceneSnapshotWater.materialprimitive.renderer.waterqa.renderer.water
material.foliage@1material_recipeFoliage MaterialrendererProjectMaterialPayload.alphaMode<br>ProjectMaterialPayload.doubleSidedprimitive.renderer.asset_streamingqa.renderer.material_pbr<br>qa.renderer.instancing
material.decal@1material_recipeDecal MaterialrendererSceneSnapshotDecal.materialprimitive.renderer.decalsqa.renderer.decals
material.ui@1material_recipeUI MaterialrendererUiPanelPayload.stylingprimitive.project_graph.ui_panelqa.ui.panel_renderer
texture.base_color@1texture_slotTexture base colorrendererProjectMaterialPayload.textureSlots<br>ProjectAssetReferenceprimitive.project_graph.asset<br>primitive.project_graph.material_assetqa.project_graph.assets<br>qa.renderer.material_textures
texture.normal@1texture_slotTexture normalrendererProjectMaterialPayload.textureSlots<br>ProjectAssetReferenceprimitive.project_graph.asset<br>primitive.project_graph.material_assetqa.project_graph.assets<br>qa.renderer.material_textures
texture.roughness@1texture_slotTexture roughnessrendererProjectMaterialPayload.textureSlots<br>ProjectAssetReferenceprimitive.project_graph.asset<br>primitive.project_graph.material_assetqa.project_graph.assets<br>qa.renderer.material_textures
texture.metalness@1texture_slotTexture metalnessrendererProjectMaterialPayload.textureSlots<br>ProjectAssetReferenceprimitive.project_graph.asset<br>primitive.project_graph.material_assetqa.project_graph.assets<br>qa.renderer.material_textures
texture.emissive@1texture_slotTexture emissiverendererProjectMaterialPayload.textureSlots<br>ProjectAssetReferenceprimitive.project_graph.asset<br>primitive.project_graph.material_assetqa.project_graph.assets<br>qa.renderer.material_textures
texture.ambient_occlusion@1texture_slotTexture ambient occlusionrendererProjectMaterialPayload.textureSlots<br>ProjectAssetReferenceprimitive.project_graph.asset<br>primitive.project_graph.material_assetqa.project_graph.assets<br>qa.renderer.material_textures
texture.skybox_equirectangular@1texture_slotTexture skybox equirectangularrendererProjectMaterialPayload.textureSlots<br>ProjectAssetReferenceprimitive.project_graph.asset<br>primitive.project_graph.material_assetqa.project_graph.assets<br>qa.renderer.material_textures
post.bloom@1post_processing_intentPost bloomrendererRendererPostProcessingIntentprimitive.renderer.backend_capabilityqa.render_browser_qa.visual<br>qa.render_budget
post.color_grading@1post_processing_intentPost color gradingrendererRendererPostProcessingIntentprimitive.renderer.backend_capabilityqa.render_browser_qa.visual<br>qa.render_budget
post.vignette@1post_processing_intentPost vignetterendererRendererPostProcessingIntentprimitive.renderer.backend_capabilityqa.render_browser_qa.visual<br>qa.render_budget
post.anti_aliasing@1post_processing_intentPost anti-aliasingrendererRendererPostProcessingIntentprimitive.renderer.backend_capabilityqa.render_browser_qa.visual<br>qa.render_budget
post.ambient_occlusion@1post_processing_intentPost ambient occlusionrendererRendererPostProcessingIntentprimitive.renderer.backend_capabilityqa.render_browser_qa.visual<br>qa.render_budget
post.contact_shadows@1post_processing_intentPost contact shadowsrendererRendererPostProcessingIntentprimitive.renderer.backend_capabilityqa.render_browser_qa.visual<br>qa.render_budget
post.screen_space_global_illumination@1post_processing_intentPost screen-space global illuminationrendererRendererPostProcessingIntentprimitive.renderer.backend_capabilityqa.render_browser_qa.visual<br>qa.render_budget
post.screen_space_reflections@1post_processing_intentPost screen-space reflectionsrendererRendererPostProcessingIntentprimitive.renderer.backend_capabilityqa.render_browser_qa.visual<br>qa.render_budget
post.light_shafts@1post_processing_intentPost light shaftsrendererRendererPostProcessingIntentprimitive.renderer.backend_capabilityqa.render_browser_qa.visual<br>qa.render_budget
post.depth_of_field@1post_processing_intentPost depth of fieldrendererRendererPostProcessingIntentprimitive.renderer.backend_capabilityqa.render_browser_qa.visual<br>qa.render_budget
post.motion_blur@1post_processing_intentPost motion blurrendererRendererPostProcessingIntentprimitive.renderer.backend_capabilityqa.render_browser_qa.visual<br>qa.render_budget
scene.terrain@1scene_capabilityScene terrainrendererSceneSnapshotprimitive.renderer.terrainqa.render_browser_qa.visual<br>qa.render_device_matrix
scene.water@1scene_capabilityScene waterrendererSceneSnapshotprimitive.renderer.waterqa.render_browser_qa.visual<br>qa.render_device_matrix
scene.decals@1scene_capabilityScene decalsrendererSceneSnapshotprimitive.renderer.decalsqa.render_browser_qa.visual<br>qa.render_device_matrix
scene.particles@1scene_capabilityScene particlesrendererSceneSnapshotprimitive.renderer.particlesqa.render_browser_qa.visual<br>qa.render_device_matrix
scene.reflection_probe@1scene_capabilityScene reflection proberendererSceneSnapshotprimitive.renderer.environment_profilesqa.render_browser_qa.visual<br>qa.render_device_matrix
scene.image_based_lighting@1scene_capabilityScene image based lightingrendererSceneSnapshotprimitive.renderer.image_based_lightingqa.render_browser_qa.visual<br>qa.render_device_matrix
scene.compressed_texture_variants@1scene_capabilityScene compressed texture variantsrendererSceneSnapshotprimitive.renderer.compressed_texture_variantsqa.render_browser_qa.visual<br>qa.render_device_matrix
scene.asset_streaming@1scene_capabilityScene asset streamingrendererSceneSnapshotprimitive.renderer.asset_streamingqa.render_browser_qa.visual<br>qa.render_device_matrix
scene.culling@1scene_capabilityScene cullingrendererSceneSnapshotprimitive.renderer.cullingqa.render_browser_qa.visual<br>qa.render_device_matrix
scene.instancing@1scene_capabilityScene instancingrendererSceneSnapshotprimitive.renderer.instancingqa.render_browser_qa.visual<br>qa.render_device_matrix
style.pack.natural_explorer@1style_packNatural Explorer Style PackrendererProjectWorld.environment<br>RendererPostProcessingIntentprimitive.renderer.environment_profilesqa.runtime.scene_snapshot<br>qa.render_browser_qa.visual
style.pack.renderer_moat@1style_packRenderer Moat Style PackrendererProjectWorld.renderer.recipeHashprimitive.renderer.terrain<br>primitive.renderer.water<br>primitive.renderer.particlesqa.renderer_moat_recipe<br>qa.render_browser_qa.visual

Demo Recipes

RecipeLabelWorld TypeTemplateRenderer/Material PlanGenerated Asset ReceiptsQA Evals
three_d_explorer_demo@13D Explorer Demospatial_3dthree_d_explorerstyle.pack.natural_explorer<br>post.color_grading<br>post.vignetteNonesemantic_contract<br>project_graph_validation<br>runtime_playability<br>renderer_nonblank<br>browser_no_console
first_person_explorer_demo@1First-Person Explorer Demospatial_3dfirst_person_explorerstyle.pack.natural_explorer<br>post.anti_aliasingNonesemantic_contract<br>project_graph_validation<br>runtime_playability<br>browser_no_console
renderer_moat_showcase_demo@1Renderer Moat Showcase Demospatial_3drenderer_moat_showcasestyle.pack.renderer_moat<br>material.glass<br>material.metal<br>material.emissive<br>scene.terrain<br>scene.water<br>scene.particlesNonesemantic_contract<br>project_graph_validation<br>renderer_nonblank<br>visual_budget<br>browser_no_console
ai_entity_world_demo@1AI Entity World Demospatial_3dthree_d_explorermaterial.toon<br>post.color_gradingasset.icon.ai_actor:substitutedsemantic_contract<br>project_graph_validation<br>script_semantic_patch<br>workflow_action_state<br>runtime_playability
asset_factory_demo@1Asset Factory Demospatial_3dblank_3dmaterial.matte<br>texture.base_color<br>texture.normalasset.factory.model:substituted<br>asset.factory.texture:substituted<br>asset.factory.audio:substitutedsemantic_contract<br>project_graph_validation<br>generation_terminal_or_degraded<br>asset_reference_resolves
spatial_asset_playable_world_demo@1Spatial Asset Playable World Demospatial_3dblank_3dscene.asset_streaming<br>post.anti_aliasingNonesemantic_contract<br>project_graph_validation<br>spatial_import_receipts<br>spatial_proxy_proof<br>renderer_nonblank<br>runtime_playability<br>browser_no_console
abstract_workflow_world_demo@1Abstract Workflow World Demoabstract_workflowNoneNoneNonesemantic_contract<br>project_graph_validation<br>workflow_action_state<br>timeline_receipt_integrity

QA Evals

EvalLabelProof SurfaceRequiredReceipt Kind
semantic_contract@1Semantic Contractsemanticyessemantic_contract.receipt
project_graph_validation@1Project Graph Validationproject_graphyesproject_graph.validation_receipt
script_semantic_patch@1Script Semantic Patchscriptyesscript_semantic_patch.receipt
generation_terminal_or_degraded@1Generation Terminal Or Degradedgenerationyesgeneration.finalization_receipt
asset_reference_resolves@1Asset Reference Resolvesgenerationyesasset_reference.receipt
spatial_import_receipts@1Spatial Import Receiptsproject_graphyesspatial.import_receipts
spatial_proxy_proof@1Spatial Proxy Proofproject_graphyesspatial.proxy_receipt
renderer_nonblank@1Renderer Nonblankrendereryesrenderer.nonblank_receipt
visual_budget@1Visual Budgetrendereryesrenderer.budget_receipt
runtime_playability@1Runtime Playabilityruntimeyesruntime.playability_receipt
workflow_action_state@1Workflow Action Stateworkflowyesworkflow.action_state_receipt
browser_no_console@1Browser No Console Errorsbrowseryesbrowser.no_console_receipt
timeline_receipt_integrity@1Timeline Receipt Integritytimelineyestimeline.integrity_receipt
Was this helpful?Report an issueContact support

On this page