<!-- GENERATED FILE: do not edit by hand. --> <!-- Regenerate with npm run gen-docs. -->
Sources: packages/world-build-contract/src/index.ts, packages/protocol/src/index.ts, packages/engine-version/src/index.ts.
AI World Build Contract
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
| Coordinate | Version | Hash |
|---|---|---|
| AI World Build Contract | ai-world-build-contract.v1.bistro-canonical-rebuild-phase1 | sha256:b05d3d5d36c6606b3310195ad75cb4d9194b748af1ba69c0ef62f50c5dedab3d |
| Workbench Product Claim Contract | workbench-product-claim-contract.v1 | sha256:2d9e79129fe980df390ee04acf077b633f3591e7d3ed9322a782c4a1bc73163d |
| Workbench Semantic Product Spec | workbench-semantic-product-spec.v2 | sha256:50f30e3771b5dd2779f2f57ca1f8cc16352f6fd684a16a8d1cd29b5a6097024d |
| Renderer/Material Capability Catalog | renderer-material-capability-catalog.v1.bistro-canonical-rebuild-phase1 | sha256:3de48da98d3e9d29116fde017e7a95c75ebf7f887c4c149119677dba95d3cfed |
| Demo Recipe Catalog | world-build-demo-recipe-catalog.v1.bistro-canonical-rebuild-phase1 | sha256:47570f24b7b2e0a1504205f08ad56d46cefce542c4845bfe62788c4feebd93fe |
| QA/Eval Catalog | world-build-qa-eval-catalog.v1.spatial-proxy-proof | sha256:c45215b495e1dd9c226f8f26cf46ddd6fdee9471d3d679ba080a356ab61e7bda |
| Execution Timeline | world-build-execution-timeline.v1 | sha256:96f461e7c45f82b3a76ee383c2b1bd05f34e38b0e69ee3e9ca01a433ea6d3456 |
| Catalog Coordinates | composite | sha256:d6ce5f9e6709fb40c82898d9a10656a2e453ece7f180ecc564ae900bab417f0d |
Acceptance Policy
world.build.from_promptis the canonical action for prompt-to-world build execution.world.build.from_spatial_assetis 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.acceptedreceipts; 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, ordegradedasset receipts. - Renderer/material choices must reference cataloged capability ids; raw shader/pass fields such as
shaderSource,fragmentShader,vertexShader,wgsl,glsl,renderPassCode, andcustomPassSourceare forbidden. - Workbench product claims use explicit terminal states and proof tri-state; missing proof is
not_run, not pass.
Workbench Product Claim Contracts
| Intent | Surface | Hash | Required children | Project Graph artifacts | Script/state/UI artifacts | Proof lanes | Partial draft |
|---|---|---|---|---|---|---|---|
read_only | chat | sha256:28078b57591ab5812a4f5ee64ea8b7c6d8770fb961b50ea65b91ba59584fdadc | None | None | None | None | no |
small_edit | workbench_build | sha256:9dece67541828ac9457408da146f5ed8c1ab52e8281cfa44864dfbf6413d06c0 | None | None | None | project_graph | yes |
script_edit | script_fix | sha256:ba0baee70777ae079fbfcf5e7cd72ff07941d8cb6d50f49574b8c8d4a8e7ef69 | None | None | script_behavior | script_behavior | yes |
visual_world_build | world_build | sha256:7817d2f9f1ff5b30ed5830cf58e09be738e5a2a6ec9b6e2ca2b666c7fbe1d107 | creative-world-layout<br>creative-visual-style<br>creative-proof-plan<br>foundation<br>scene<br>visual-qa-repair | world<br>visible_scene_entities<br>active_camera<br>lighting | None | project_graph<br>observer_visual_qa<br>renderer_visual_qa | yes |
playable_game_factory | factory_build | sha256:6d1e07fb985b99609e4b4132f5833fbdc91b095d567416f28d14e2a65fabd893 | creative-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-proof | world<br>visible_scene_entities<br>active_camera<br>lighting<br>smart_asset_package<br>player_spawn<br>player_control_path<br>runtime_controller | script_behavior<br>typed_score_win_state<br>hud_binding | project_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_acceptance | yes |
organic_playable_world | world_build | sha256:53bd306f1fadf0a49fbbb3dd93af173a2043b6565c3a9aabac94344ffdf3a33d | None | world<br>visible_scene_entities | None | project_graph<br>runtime_play | yes |
debug_repair | debug_repair | sha256:aa5318b8570991f25b6f0e3beedb616514867a02d67153ae35441bb2b4e2918b | None | None | None | project_graph | yes |
qa_or_publish_proof | qa_proof | sha256:6080a2fd04ec8102c154e53b423f521bca790c3a59bd529d2010e86ef6c783a5 | None | None | None | observer_visual_qa<br>renderer_visual_qa<br>runtime_play<br>factory_acceptance | no |
unknown_or_unsupported | chat | sha256:d4f94ced9df30c21248877c3deb9e6f424ca6acf1a8420cae2dc74365706c1bd | None | None | None | None | no |
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.
| Field | Meaning |
|---|---|
prompt | Original user prompt used for traceability and prompt-specific hashing. |
intent | Workbench product claim intent such as visual_world_build or playable_game_factory. |
genreOrWorldType | Planner-selected semantic product category for this prompt. |
targetExperience | Short user-facing experience goal that all projections derive from. |
visualStyle | Mood, palette, and density for renderer/material planning. |
regions | Named semantic areas such as districts, lanes, routes, water, or parks. |
entityClasses | Prompt-specific entity classes that expand into semantic batch items. |
gameplayLoops | Gameplay loop descriptions and proof requirements for playable builds. |
scriptBehaviors | Script Semantic Patch behavior intents; not raw Script IR or source. |
typedState | Typed score/win/runtime state contract for playable builds. |
uiHud | HUD bindings backed by typed state, not renderer-only claims. |
camera | Semantic camera mode, framing, transform, and fov. |
lighting | Semantic lighting rig and atmosphere. |
materials | Catalog capability ids and material direction; raw shader/pass fields are forbidden. |
proofPlan | Required visual/runtime/factory proof lanes. |
acceptanceRubric | Planner acceptance criteria that product-claim proof must satisfy. |
budget | Planner budget for provider calls, cost, and child workers. |
Renderer/Material Capabilities
| Capability | Kind | Label | Owner | Protocol Fields | Required Primitives | QA Coverage |
|---|---|---|---|---|---|---|
material.matte@1 | material_recipe | Matte Material | renderer | ProjectMaterialPayload.baseColor<br>ProjectMaterialPayload.roughness | primitive.project_graph.material_asset | qa.project_graph.assets<br>qa.renderer.material_pbr |
material.metal@1 | material_recipe | Metal Material | renderer | ProjectMaterialPayload.metallic<br>ProjectMaterialPayload.roughness | primitive.renderer.material_pbr_advanced | qa.renderer.material_pbr |
material.glass@1 | material_recipe | Glass Material | renderer | ProjectMaterialPayload.transmission<br>ProjectMaterialPayload.alphaMode | primitive.renderer.material_pbr_advanced | qa.renderer.material_pbr<br>qa.render_browser_qa.visual |
material.emissive@1 | material_recipe | Emissive Material | renderer | ProjectMaterialPayload.emissiveColor<br>ProjectMaterialPayload.emissiveIntensity | primitive.renderer.material_pbr_advanced | qa.renderer.material_pbr |
material.toon@1 | material_recipe | Toon Material | renderer | ProjectMaterialPayload.shadingModel | primitive.project_graph.material_asset | qa.renderer.surface_response_toon<br>qa.render_browser_qa.visual |
material.holographic@1 | material_recipe | Holographic Material | renderer | ProjectMaterialPayload.emissiveColor<br>ProjectMaterialPayload.alphaMode | primitive.renderer.material_pbr_advanced | qa.renderer.material_pbr<br>qa.render_budget |
material.terrain_layered@1 | material_recipe | Layered Terrain Material | renderer | SceneSnapshotTerrain.material | primitive.renderer.terrain | qa.renderer.terrain |
material.water@1 | material_recipe | Water Material | renderer | SceneSnapshotWater.material | primitive.renderer.water | qa.renderer.water |
material.foliage@1 | material_recipe | Foliage Material | renderer | ProjectMaterialPayload.alphaMode<br>ProjectMaterialPayload.doubleSided | primitive.renderer.asset_streaming | qa.renderer.material_pbr<br>qa.renderer.instancing |
material.decal@1 | material_recipe | Decal Material | renderer | SceneSnapshotDecal.material | primitive.renderer.decals | qa.renderer.decals |
material.ui@1 | material_recipe | UI Material | renderer | UiPanelPayload.styling | primitive.project_graph.ui_panel | qa.ui.panel_renderer |
texture.base_color@1 | texture_slot | Texture base color | renderer | ProjectMaterialPayload.textureSlots<br>ProjectAssetReference | primitive.project_graph.asset<br>primitive.project_graph.material_asset | qa.project_graph.assets<br>qa.renderer.material_textures |
texture.normal@1 | texture_slot | Texture normal | renderer | ProjectMaterialPayload.textureSlots<br>ProjectAssetReference | primitive.project_graph.asset<br>primitive.project_graph.material_asset | qa.project_graph.assets<br>qa.renderer.material_textures |
texture.roughness@1 | texture_slot | Texture roughness | renderer | ProjectMaterialPayload.textureSlots<br>ProjectAssetReference | primitive.project_graph.asset<br>primitive.project_graph.material_asset | qa.project_graph.assets<br>qa.renderer.material_textures |
texture.metalness@1 | texture_slot | Texture metalness | renderer | ProjectMaterialPayload.textureSlots<br>ProjectAssetReference | primitive.project_graph.asset<br>primitive.project_graph.material_asset | qa.project_graph.assets<br>qa.renderer.material_textures |
texture.emissive@1 | texture_slot | Texture emissive | renderer | ProjectMaterialPayload.textureSlots<br>ProjectAssetReference | primitive.project_graph.asset<br>primitive.project_graph.material_asset | qa.project_graph.assets<br>qa.renderer.material_textures |
texture.ambient_occlusion@1 | texture_slot | Texture ambient occlusion | renderer | ProjectMaterialPayload.textureSlots<br>ProjectAssetReference | primitive.project_graph.asset<br>primitive.project_graph.material_asset | qa.project_graph.assets<br>qa.renderer.material_textures |
texture.skybox_equirectangular@1 | texture_slot | Texture skybox equirectangular | renderer | ProjectMaterialPayload.textureSlots<br>ProjectAssetReference | primitive.project_graph.asset<br>primitive.project_graph.material_asset | qa.project_graph.assets<br>qa.renderer.material_textures |
post.bloom@1 | post_processing_intent | Post bloom | renderer | RendererPostProcessingIntent | primitive.renderer.backend_capability | qa.render_browser_qa.visual<br>qa.render_budget |
post.color_grading@1 | post_processing_intent | Post color grading | renderer | RendererPostProcessingIntent | primitive.renderer.backend_capability | qa.render_browser_qa.visual<br>qa.render_budget |
post.vignette@1 | post_processing_intent | Post vignette | renderer | RendererPostProcessingIntent | primitive.renderer.backend_capability | qa.render_browser_qa.visual<br>qa.render_budget |
post.anti_aliasing@1 | post_processing_intent | Post anti-aliasing | renderer | RendererPostProcessingIntent | primitive.renderer.backend_capability | qa.render_browser_qa.visual<br>qa.render_budget |
post.ambient_occlusion@1 | post_processing_intent | Post ambient occlusion | renderer | RendererPostProcessingIntent | primitive.renderer.backend_capability | qa.render_browser_qa.visual<br>qa.render_budget |
post.contact_shadows@1 | post_processing_intent | Post contact shadows | renderer | RendererPostProcessingIntent | primitive.renderer.backend_capability | qa.render_browser_qa.visual<br>qa.render_budget |
post.screen_space_global_illumination@1 | post_processing_intent | Post screen-space global illumination | renderer | RendererPostProcessingIntent | primitive.renderer.backend_capability | qa.render_browser_qa.visual<br>qa.render_budget |
post.screen_space_reflections@1 | post_processing_intent | Post screen-space reflections | renderer | RendererPostProcessingIntent | primitive.renderer.backend_capability | qa.render_browser_qa.visual<br>qa.render_budget |
post.light_shafts@1 | post_processing_intent | Post light shafts | renderer | RendererPostProcessingIntent | primitive.renderer.backend_capability | qa.render_browser_qa.visual<br>qa.render_budget |
post.depth_of_field@1 | post_processing_intent | Post depth of field | renderer | RendererPostProcessingIntent | primitive.renderer.backend_capability | qa.render_browser_qa.visual<br>qa.render_budget |
post.motion_blur@1 | post_processing_intent | Post motion blur | renderer | RendererPostProcessingIntent | primitive.renderer.backend_capability | qa.render_browser_qa.visual<br>qa.render_budget |
scene.terrain@1 | scene_capability | Scene terrain | renderer | SceneSnapshot | primitive.renderer.terrain | qa.render_browser_qa.visual<br>qa.render_device_matrix |
scene.water@1 | scene_capability | Scene water | renderer | SceneSnapshot | primitive.renderer.water | qa.render_browser_qa.visual<br>qa.render_device_matrix |
scene.decals@1 | scene_capability | Scene decals | renderer | SceneSnapshot | primitive.renderer.decals | qa.render_browser_qa.visual<br>qa.render_device_matrix |
scene.particles@1 | scene_capability | Scene particles | renderer | SceneSnapshot | primitive.renderer.particles | qa.render_browser_qa.visual<br>qa.render_device_matrix |
scene.reflection_probe@1 | scene_capability | Scene reflection probe | renderer | SceneSnapshot | primitive.renderer.environment_profiles | qa.render_browser_qa.visual<br>qa.render_device_matrix |
scene.image_based_lighting@1 | scene_capability | Scene image based lighting | renderer | SceneSnapshot | primitive.renderer.image_based_lighting | qa.render_browser_qa.visual<br>qa.render_device_matrix |
scene.compressed_texture_variants@1 | scene_capability | Scene compressed texture variants | renderer | SceneSnapshot | primitive.renderer.compressed_texture_variants | qa.render_browser_qa.visual<br>qa.render_device_matrix |
scene.asset_streaming@1 | scene_capability | Scene asset streaming | renderer | SceneSnapshot | primitive.renderer.asset_streaming | qa.render_browser_qa.visual<br>qa.render_device_matrix |
scene.culling@1 | scene_capability | Scene culling | renderer | SceneSnapshot | primitive.renderer.culling | qa.render_browser_qa.visual<br>qa.render_device_matrix |
scene.instancing@1 | scene_capability | Scene instancing | renderer | SceneSnapshot | primitive.renderer.instancing | qa.render_browser_qa.visual<br>qa.render_device_matrix |
style.pack.natural_explorer@1 | style_pack | Natural Explorer Style Pack | renderer | ProjectWorld.environment<br>RendererPostProcessingIntent | primitive.renderer.environment_profiles | qa.runtime.scene_snapshot<br>qa.render_browser_qa.visual |
style.pack.renderer_moat@1 | style_pack | Renderer Moat Style Pack | renderer | ProjectWorld.renderer.recipeHash | primitive.renderer.terrain<br>primitive.renderer.water<br>primitive.renderer.particles | qa.renderer_moat_recipe<br>qa.render_browser_qa.visual |
Demo Recipes
| Recipe | Label | World Type | Template | Renderer/Material Plan | Generated Asset Receipts | QA Evals |
|---|---|---|---|---|---|---|
three_d_explorer_demo@1 | 3D Explorer Demo | spatial_3d | three_d_explorer | style.pack.natural_explorer<br>post.color_grading<br>post.vignette | None | semantic_contract<br>project_graph_validation<br>runtime_playability<br>renderer_nonblank<br>browser_no_console |
first_person_explorer_demo@1 | First-Person Explorer Demo | spatial_3d | first_person_explorer | style.pack.natural_explorer<br>post.anti_aliasing | None | semantic_contract<br>project_graph_validation<br>runtime_playability<br>browser_no_console |
renderer_moat_showcase_demo@1 | Renderer Moat Showcase Demo | spatial_3d | renderer_moat_showcase | style.pack.renderer_moat<br>material.glass<br>material.metal<br>material.emissive<br>scene.terrain<br>scene.water<br>scene.particles | None | semantic_contract<br>project_graph_validation<br>renderer_nonblank<br>visual_budget<br>browser_no_console |
ai_entity_world_demo@1 | AI Entity World Demo | spatial_3d | three_d_explorer | material.toon<br>post.color_grading | asset.icon.ai_actor:substituted | semantic_contract<br>project_graph_validation<br>script_semantic_patch<br>workflow_action_state<br>runtime_playability |
asset_factory_demo@1 | Asset Factory Demo | spatial_3d | blank_3d | material.matte<br>texture.base_color<br>texture.normal | asset.factory.model:substituted<br>asset.factory.texture:substituted<br>asset.factory.audio:substituted | semantic_contract<br>project_graph_validation<br>generation_terminal_or_degraded<br>asset_reference_resolves |
spatial_asset_playable_world_demo@1 | Spatial Asset Playable World Demo | spatial_3d | blank_3d | scene.asset_streaming<br>post.anti_aliasing | None | semantic_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@1 | Abstract Workflow World Demo | abstract_workflow | None | None | None | semantic_contract<br>project_graph_validation<br>workflow_action_state<br>timeline_receipt_integrity |
QA Evals
| Eval | Label | Proof Surface | Required | Receipt Kind |
|---|---|---|---|---|
semantic_contract@1 | Semantic Contract | semantic | yes | semantic_contract.receipt |
project_graph_validation@1 | Project Graph Validation | project_graph | yes | project_graph.validation_receipt |
script_semantic_patch@1 | Script Semantic Patch | script | yes | script_semantic_patch.receipt |
generation_terminal_or_degraded@1 | Generation Terminal Or Degraded | generation | yes | generation.finalization_receipt |
asset_reference_resolves@1 | Asset Reference Resolves | generation | yes | asset_reference.receipt |
spatial_import_receipts@1 | Spatial Import Receipts | project_graph | yes | spatial.import_receipts |
spatial_proxy_proof@1 | Spatial Proxy Proof | project_graph | yes | spatial.proxy_receipt |
renderer_nonblank@1 | Renderer Nonblank | renderer | yes | renderer.nonblank_receipt |
visual_budget@1 | Visual Budget | renderer | yes | renderer.budget_receipt |
runtime_playability@1 | Runtime Playability | runtime | yes | runtime.playability_receipt |
workflow_action_state@1 | Workflow Action State | workflow | yes | workflow.action_state_receipt |
browser_no_console@1 | Browser No Console Errors | browser | yes | browser.no_console_receipt |
timeline_receipt_integrity@1 | Timeline Receipt Integrity | timeline | yes | timeline.integrity_receipt |