Gessa Docs
Generated Reference

Reference

Action Catalog

Sources: packages/action-catalog/src/index.ts.
engine v1.0.234Copy for LLM

This generated snapshot is derived from packages/action-catalog. It is the canonical verb registry for mutating platform surfaces and planned ontology/control-plane actions.

Catalog version: action-catalog.v1.0.234. Catalog hash: sha256:f39b6630cd20fb47cc8f6638fcd798405a19303ddfc1f6f3bac0cb824628e3db. Action count: 119. Surface mapping count: 188.

Actions

ActionTitleDescriptionDomainKindLifecycleOwnerExposureAudit Events
agentenv.create_runCreate Run Agent EnvironmentExecute the canonical AgentEnv CreateRun protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.agentenvcommandactiveagentenvmcp<br>sdkAgentEnvCreateRun
agentenv.create_episodeCreate Episode Agent EnvironmentExecute the canonical AgentEnv CreateEpisode protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.agentenvcommandactiveagentenvmcp<br>sdkAgentEnvCreateEpisode
agentenv.reset_episodeReset Episode Agent EnvironmentExecute the canonical AgentEnv ResetEpisode protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.agentenvcommandactiveagentenvmcp<br>sdkAgentEnvResetEpisode
agentenv.observeObserve Agent EnvironmentExecute the canonical AgentEnv Observe protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.agentenvqueryactiveagentenvmcp<br>sdkAgentEnvObserve
agentenv.submit_intentSubmit Intent Agent EnvironmentExecute the canonical AgentEnv SubmitIntent protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.agentenvcommandactiveagentenvmcp<br>sdkAgentEnvSubmitIntent
agentenv.stepStep Agent EnvironmentExecute the canonical AgentEnv Step protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.agentenvcommandactiveagentenvmcp<br>sdkAgentEnvStep
agentenv.scoreScore Agent EnvironmentExecute the canonical AgentEnv Score protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.agentenvqueryactiveagentenvmcp<br>sdkAgentEnvScore
agentenv.terminateTerminate Agent EnvironmentExecute the canonical AgentEnv Terminate protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.agentenvcommandactiveagentenvmcp<br>sdkAgentEnvTerminate
agentenv.fetch_replayFetch Replay Agent EnvironmentExecute the canonical AgentEnv FetchReplay protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.agentenvqueryactiveagentenvmcp<br>sdkAgentEnvFetchReplay
agentenv.export_trajectoryExport Trajectory Agent EnvironmentExecute the canonical AgentEnv ExportTrajectory protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.agentenvcommandactiveagentenvmcp<br>sdkAgentEnvExportTrajectory
workspace.createCreate WorkspaceCreate a workspace through the control-plane service.control-planecommandactivecontrol-planeui<br>mcp<br>ai<br>sdkCreateWorkspace
game.createCreate ProjectCreate a game/project row and apply the caller's declared canonical template intent.control-planecommandactivecontrol-planeui<br>mcp<br>aiCreateGame
game.multiplayer_blueprint.setSet Multiplayer BlueprintSet the game's default multiplayer blueprint (rooms, queues, teams, seats, placement, lifecycle, and netcode runtime budgets). Configures matchmaking and netcode parameters a script cannot set.control-planecommandactivecontrol-planeui<br>mcp<br>ai<br>sdkSetGameMultiplayerDefault
commerce.offer.setSet Commerce OfferCreate or update one purchasable offer on a game: its title, price, kind (durable or consumable), status (draft, active, archived) and the entitlement or item grants it delivers. Offers are what a script's Commerce.promptPurchase names, so the offer must exist before a purchase prompt can open.control-planecommandactivecommerceui<br>mcp<br>ai<br>sdkUpsertCommerceOffer
commerce.offer.listList Commerce OffersList every offer defined on a game, drafts and archived included, with keys, prices, kinds and statuses. Read this before naming an offer key in a script so the purchase prompt points at an offer that exists and is active.control-planequeryactivecommerceui<br>mcp<br>ai<br>sdkListCommerceOffers
game.updateUpdate ProjectUpdate project control-plane fields such as title and thumbnail.control-planecommandactivecontrol-planeui<br>sdk<br>mcp<br>aiUpdateGame<br>SetGameThumbnail
environment.createCreate EnvironmentCreate a game environment through the control-plane service.control-planecommandactivecontrol-planeui<br>mcp<br>ai<br>sdkCreateEnvironment
project.graph.snapshot.readRead Project Graph SnapshotRead the current typed Project Graph snapshot through its owner service.project-graphqueryactiveproject-graphmcp<br>ai<br>workflow<br>sdkProjectGraphSnapshotRead
project.transaction.applyApply Project Graph TransactionAtomically apply several low-level Project Graph ops as ONE checked, idempotent, undoable transaction. Each op is a { kind, ...fields } object (record.create/update/delete, component.put/patch/delete/add/remove) over a resourceKind (asset, world, component, prefab, entity, script, workflow, ui-panel, data-store); the ops field description carries the exact shapes. The precision batched writer: no engine-owned component defaults, strong per-op validation on receipt.project-graphcommandactiveproject-graphworkflowProjectGraphTransactionApplied
project.asset.createCreate Project AssetCreate a ProjectAsset through the UUID-only Project Graph client contract; internal keys, storage, pipeline, provenance, and frozen graph fields are never caller-owned.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkCreateProjectAsset
project.asset.updateUpdate Project AssetUpdate a ProjectAsset through the UUID-only Project Graph client contract; internal keys, storage, pipeline, provenance, and frozen graph fields are never caller-owned.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkUpdateProjectAsset
project.asset.deleteDelete Project AssetDelete a ProjectAsset through the UUID-only Project Graph client contract; internal keys, storage, pipeline, provenance, and frozen graph fields are never caller-owned.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkDeleteProjectAsset
project.world.createCreate Project WorldCreate a Project Graph world record through the canonical owner service; the receipt is the exact client resource.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkCreateProjectWorld
project.world.updateUpdate Project WorldUpdate a Project Graph world record through the canonical owner service; the receipt is the exact client resource.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkUpdateProjectWorld
project.world.deleteDelete Project WorldDelete a Project Graph world record through the canonical owner service; the receipt is the exact client resource.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkDeleteProjectWorld
project.world.readRead Project WorldRead one Project Graph world record by uuid or graph key through the canonical owner service; the receipt is the exact client resource with its current version.project-graphqueryactiveproject-graphmcp<br>ai<br>workflow<br>sdkReadProjectWorld
project.component.createCreate Project ComponentCreate a Project Graph component definition record through backend service paths. Project-defined components are production-grade backend-validated project-local data contracts for advanced/import-only data; they are not canonical engine atomics.project-graphcommandactiveproject-graphui<br>mcp<br>sdkCreateProjectComponent
project.component.updateUpdate Project ComponentUpdate a Project Graph component definition record through backend service paths. Project-defined components are production-grade backend-validated project-local data contracts for advanced/import-only data; they are not canonical engine atomics.project-graphcommandactiveproject-graphui<br>mcp<br>sdkUpdateProjectComponent
project.component.deleteDelete Project ComponentDelete a Project Graph component definition record through backend service paths. Project-defined components are production-grade backend-validated project-local data contracts for advanced/import-only data; they are not canonical engine atomics.project-graphcommandactiveproject-graphui<br>mcp<br>sdkDeleteProjectComponent
project.prefab.createCreate Project PrefabCreate a Project Graph prefab record through the canonical owner service; the receipt is the exact client resource.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkCreateProjectPrefab
project.prefab.updateUpdate Project PrefabUpdate a Project Graph prefab record through the canonical owner service; the receipt is the exact client resource.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkUpdateProjectPrefab
project.prefab.deleteDelete Project PrefabDelete a Project Graph prefab record through the canonical owner service; the receipt is the exact client resource.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkDeleteProjectPrefab
project.prefab.readRead Project PrefabRead one Project Graph prefab record by uuid or graph key through the canonical owner service; the receipt is the exact client resource with its current version.project-graphqueryactiveproject-graphmcp<br>ai<br>workflow<br>sdkReadProjectPrefab
project.entity.createCreate Project EntityCreate a Project Graph entity in a world through the canonical entity owner. worldId/parentEntityId/prefabId accept a uuid or a graph key; on_conflict controls duplicate-key handling.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkCreateProjectEntity
project.entity.updateUpdate Project EntityUpdate a Project Graph entity's identity, hierarchy, tags, or metadata through the canonical entity owner. With expected_revision the write goes through an optimistic-concurrency transaction and returns a transaction result; otherwise it returns the updated entity.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkUpdateProjectEntity
project.entity.deleteDelete Project EntityDelete a Project Graph entity through the canonical entity owner. With expected_revision the delete goes through an optimistic-concurrency transaction and returns a transaction result; otherwise it returns the deleted entity.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkDeleteProjectEntity
project.entity.readRead Project EntityRead one Project Graph entity by uuid or graph key through the canonical entity owner; the receipt is the exact client entity with its current version and components.project-graphqueryactiveproject-graphmcp<br>ai<br>workflow<br>sdkReadProjectEntity
project.entity.searchSearch Project EntitiesSearch Project Graph entities by query, world, tag(s), component type(s), or key prefix through the canonical entity owner, returning a bounded cursor-paginated page of entity records (the discovery reader for edit targets).project-graphqueryactiveproject-graphmcp<br>ai<br>workflow<br>sdkSearchProjectEntities
project.script.createCreate Project ScriptCreate a Project Graph script from a structural GessaScript shell through the canonical script owner.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkCreateProjectScript
project.script.updateUpdate Project ScriptUpdate a Project Graph script's metadata through the canonical script owner.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkUpdateProjectScript
project.script.deleteDelete Project ScriptDelete a Project Graph script through the canonical script owner.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkDeleteProjectScript
project.script.readRead Project ScriptRead one Project Graph script by uuid or graph key through the canonical script owner; the receipt is the exact client script carrying its current version and IR fingerprint together, so a semantic patch never needs to probe for concurrency coordinates.project-graphqueryactiveproject-graphmcp<br>ai<br>workflow<br>sdkReadProjectScript
project.ui_panel.createCreate Project Ui PanelCreate a Project Graph ui panel record through the canonical owner service; the receipt is the exact client resource.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkCreateProjectUiPanel
project.ui_panel.updateUpdate Project Ui PanelUpdate a Project Graph ui panel record through the canonical owner service; the receipt is the exact client resource.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkUpdateProjectUiPanel
project.ui_panel.deleteDelete Project Ui PanelDelete a Project Graph ui panel record through the canonical owner service; the receipt is the exact client resource.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkDeleteProjectUiPanel
project.ui_panel.readRead Project Ui PanelRead one Project Graph ui panel record by uuid or graph key through the canonical owner service; the receipt is the exact client resource with its current version.project-graphqueryactiveproject-graphmcp<br>ai<br>workflow<br>sdkReadProjectUiPanel
project.data_store.createCreate Project Data StoreCreate a Project Graph data store record through the canonical owner service; the receipt is the exact client resource.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkCreateProjectDataStore
project.data_store.updateUpdate Project Data StoreUpdate a Project Graph data store record through the canonical owner service; the receipt is the exact client resource.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkUpdateProjectDataStore
project.data_store.deleteDelete Project Data StoreDelete a Project Graph data store record through the canonical owner service; the receipt is the exact client resource.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkDeleteProjectDataStore
project.data_store.readRead Project Data StoreRead one Project Graph data store record by uuid or graph key through the canonical owner service; the receipt is the exact client resource with its current version.project-graphqueryactiveproject-graphmcp<br>ai<br>workflow<br>sdkReadProjectDataStore
project.asset.duplicateDuplicate Project AssetDuplicate a ProjectAsset by canonical UUID through the Project Graph owner so storage-owned fields are copied internally and never reconstructed by a caller.project-graphcommandactiveproject-graphui<br>mcp<br>aiCreateProjectAsset
project.asset.model_document.saveSave Project Model DocumentValidate and persist the authored ModelAuthoringDocument through the dedicated Project Graph merge boundary without opening the generic client asset update to server-owned rendering fields.model-authoringcommandactiveproject-graphui<br>mcp<br>aiUpdateProjectAsset
asset_pipeline.model_material_slots.inspectInspect Model Material SlotsInspect the canonical conditioned material-slot projection for one model ProjectAsset UUID.asset-pipelinequeryactiveasset-pipelineui<br>mcp<br>aiAssetPipelineModelMaterialSlotsInspected
asset_pipeline.model_material_slot.promotePromote Model Material SlotPromote one conditioned model material slot into a durable ProjectAsset through the Asset Pipeline owner.asset-pipelinecommandactiveasset-pipelineui<br>mcp<br>aiAssetPipelineModelMaterialSlotPromoted
asset_pipeline.model_material_slots.promotePromote Model Material SlotsPromote all, every, or a selected bulk batch of conditioned model material slots into durable material assets through the Asset Pipeline owner.asset-pipelinecommandactiveasset-pipelineui<br>mcp<br>aiAssetPipelineModelMaterialSlotsPromoted
asset_pipeline.model_material_slot.overrideOverride Model Material SlotSet or clear one renderable model material-slot override through the Asset Pipeline owner.asset-pipelinecommandactiveasset-pipelineui<br>mcp<br>aiAssetPipelineModelMaterialSlotOverridden
project.entity.component.setSet Entity ComponentAdd or replace a complete component on a Project Graph entity through the canonical component mutation kernel. With expected_revision the write goes through an optimistic-concurrency transaction and returns a transaction result; otherwise it returns the updated entity.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkSetProjectEntityComponentOverride<br>PutProjectEntityComponent<br>PatchProjectEntityComponent
project.entity.component.deleteDelete Entity ComponentRemove one component from a Project Graph entity through the canonical component mutation kernel. With expected_revision the delete goes through an optimistic-concurrency transaction and returns a transaction result; otherwise it returns the updated entity.project-graphcommandactiveproject-graphui<br>mcp<br>ai<br>sdkDeleteProjectEntityComponent
project.script.patch.applyApply Script Semantic PatchApply checked semantic patch operations to a Project Script and persist canonical Script IR.script-authoringcommandactivescript-semantic-patchui<br>mcp<br>ai<br>workflow<br>sdkUpdateProjectScript
project.material.patch.applyApply Material Semantic PatchApply checked semantic patch operations to a material asset and persist canonical material graph artifacts.material-authoringcommandactivematerial-semantic-patchui<br>mcp<br>ai<br>workflow<br>sdkProjectGraphAssetUpdated
generation.capability.listList Generation CapabilitiesList generation offerings visible to the requester through the canonical generation owner.generationqueryactivegenerationui<br>mcp<br>ai<br>workflow<br>sdkGenerationCapabilitiesListed
generation.job.quoteQuote Generation JobQuote a generation request against capability, policy, and budget controls.generationcommandactivegenerationui<br>mcp<br>ai<br>workflow<br>sdkGenerationJobQuoted
blender.model.createCreate Blender ModelAuthor a detailed Blender model with the dedicated Astra model, render and import it through the durable generation service.generationjob_startactivegenerationaiBlenderModelRequested
generation.job.createCreate Generation JobCreate a durable generation job for an approved capability.generationjob_startactivegenerationui<br>mcp<br>ai<br>workflow<br>sdkGenerationJobCreated<br>GenerationJobQueued
generation.job.readRead Generation JobRead one durable generation job through the canonical generation owner.generationqueryactivegenerationui<br>mcp<br>ai<br>workflow<br>sdkGenerationJobRead
generation.job.listList Generation JobsList durable generation jobs visible to the requester through the canonical generation owner.generationqueryactivegenerationui<br>mcp<br>ai<br>workflow<br>sdkGenerationJobsListed
generation.job.cancelCancel Generation JobCancel an unclaimed generation job through its owner, or explicitly cancel saved placement with scope placement while rendering and incurred charges continue. Inspect the returned placement status for completion races.generationcommandactivegenerationui<br>mcp<br>ai<br>workflow<br>sdkGenerationJobCancel
generation.job.claimClaim Generation JobClaim the next queued generation job for a worker lease.generationjob_startactivegenerationcli<br>adminGenerationJobClaim
generation.job.heartbeatHeartbeat Generation JobExtend a generation job worker lease.generationcommandactivegenerationcli<br>adminGenerationJobHeartbeat
generation.job.progressProgress Generation JobRecord worker-owned generation job progress.generationcommandactivegenerationcli<br>adminGenerationJobProgress
generation.job.completeComplete Generation JobComplete and finalize a generation job.generationcommandactivegenerationcli<br>adminGenerationJobComplete
generation.job.failFail Generation JobFail or retry a generation job through worker-owned state transitions.generationcommandactivegenerationcli<br>adminGenerationJobFail
publish.devPublish Dev BuildCreate a dev content version and deployment candidate through publish gates.publishcommandactivepublishui<br>mcp<br>ai<br>workflow<br>sdkPublishDev
workflow.definition.createCreate Workflow DefinitionHidden privileged/deferred Workflow IR definition mutation. Normal UI, MCP, AI, and SDK workflow authoring stays unavailable until a complete creator-facing projection ships.workflowadmininternalworkflowsadminCreateProjectWorkflow
workflow.run.startStart Workflow RunStart a durable workflow run through the workflow runner.workflowworkflow_stepactiveworkflowsui<br>sdk<br>mcp<br>aiWorkflowRunStarted
blueprint.package.applyApply Smart Asset PackageApply a canonical Smart Asset Package manifest through backend package service paths and Project Graph transactions.blueprintcommandactiveblueprintsui<br>mcp<br>ai<br>workflow<br>sdkSmartAssetPackageApplied<br>ProjectGraphTransactionApplied
blueprint.template.applyApply Creation TemplateCompatibility alias for applying a creation template; canonical package application is blueprint.package.apply.blueprintcommandplannedblueprintsui<br>sdkCreationTemplateApplied
workspace.asset.linkLink Workspace AssetLink an authorized existing workspace asset into a project and return its owner-issued project identity without supplying raw storage coordinates.workspace-assetscommandactiveworkspace-assetsui<br>mcp<br>aiWorkspaceAssetLinkedToGame<br>ProjectAssetCreated
spatial.asset.importImport Spatial AssetQueue and run backend-authoritative spatial asset import processing through Jobs and Capability Registry.spatial-ingestionjob_startactivespatial-ingestionui<br>mcp<br>ai<br>workflow<br>sdk<br>cliSpatialAssetImportQueued<br>SpatialAssetImportProcessed
spatial.capture.proxy.generateGenerate Spatial Capture ProxyGenerate or record collision/nav/query proxy receipts for a spatial capture asset.spatial-ingestionjob_startactivespatial-ingestionui<br>mcp<br>ai<br>workflow<br>sdk<br>cliSpatialCaptureProxyGenerationQueued<br>SpatialCaptureProxyGenerationRecorded
spatial.capture.annotateAnnotate Spatial CaptureRecord semantic anchors for spatial captures through backend-validated Project Graph facets.spatial-ingestioncommandactivespatial-ingestionui<br>mcp<br>ai<br>workflow<br>sdk<br>cliSpatialCaptureAnnotationRecorded
terrain.resource.createCreate Terrain ResourceCreate a versioned hybrid terrain resource (heightfield + mesh under one resource) as a Project Graph asset terrain facet. Backed by the terrain resource contract (terrain-resource-contract.v1) + the terrain patch chokepoint; the dedicated REST/MCP/AI handlers are pending (planned).terraincommandplannedterrainui<br>sdkTerrainResourceCreated
terrain.patch.applyApply Terrain Semantic PatchApply checked semantic terrain operations (sculpt/paint/road/biome/generate/cutHole/erosion/scatter) to the versioned terrain resource through the single terrain patch chokepoint (compileTerrainPatch + applyTerrainPatch), invalidating collision/nav/render artifacts for gated rebuild so collision and nav never drift from the source. Lowers into ProjectGraphService.applyTerrainPatch over the asset terrain facet via the existing updateAsset path (no parallel write path).terraincommandactiveterrainui<br>mcp<br>ai<br>workflow<br>sdkTerrainPatchApplied
terrain.artifacts.buildBuild Terrain ArtifactsBuild the explicit terrain artifacts (render height tile, collision proxy, nav source mesh) from the terrain resource source, writing regenerate-gated receipts onto the facet and lifting acceptance to navigable_terrain. Backed by ProjectGraphService.buildTerrainArtifacts over the deterministic buildTerrainArtifacts builder (same source -> same artifactHash, one no-drift build for collision/nav/render). v1 runs the build inline; the durable job-queue worker is a later optimization. Build is a job; path query is runtime.terrainjob_startactiveterrainui<br>mcp<br>ai<br>sdk<br>cliTerrainArtifactsBuildQueued<br>TerrainArtifactsBuilt
instance_set.patch.applyApply Instance Set Semantic PatchApply checked bulk InstanceSet aggregate operations (configure/populate/fill/clearRegion/setCells/clearCells/scatterInstances/paintKind/removeInstances) to a versioned instanceSet resource facet through the single instance-set patch chokepoint (compileInstanceSetPatch + applyInstanceSetPatch), advancing the facet source version so render/collider projections regenerate. Lowers into ProjectGraphService.applyInstanceSetPatch over the asset instanceSet facet via the existing updateAsset path (no parallel write path); author only through the typed ops, never raw packed cell/instance arrays.instance-setcommandactiveinstance-setui<br>mcp<br>ai<br>workflow<br>sdkInstanceSetPatchApplied
world.build.from_promptBuild World From PromptClient ingress that routes a prompt-to-world request to the neutral authoring kernel. Not an engine mutation action; carries no owner binding.world-factoryworkflow_stepactiveworld-factoryui<br>sdkAiWorldBuildStarted<br>AiWorldBuildAccepted
world.build.from_spatial_assetBuild World From Spatial AssetCreate an executable Project Graph world from an imported spatial asset while enforcing proxy, anchor, and playability receipts.world-factoryworkflow_stepactiveworld-factoryui<br>mcp<br>ai<br>workflow<br>sdkSpatialAssetWorldBuildStarted<br>SpatialAssetWorldBuildAccepted
knowledge.searchSearch Knowledge LibrarySearch the pull-only knowledge library (generated engine reference plus optional curated playbooks) and return pointers with distilled summaries, never bulk content.knowledgequeryactiveknowledgemcp<br>ai<br>workflow<br>sdkKnowledgeSearched
knowledge.loadLoad Knowledge EntryLoad one knowledge entry by id with full provenance (source path, sha256, corpus, trust). Optional playbook/distillation corpora refuse to load under the no-skill switch.knowledgequeryactiveknowledgemcp<br>ai<br>workflow<br>sdkKnowledgeLoaded
engine.component.types.listList Engine Component TypesList built-in ECS component types with their canonical drafts, add modes, reference admission contracts, and field contracts. Use before authoring entity components to learn which component types exist and their exact shapes.enginequeryactiveenginemcp<br>ai<br>workflow<br>sdkEngineComponentTypesListed
engine.component.schema.readRead Engine Component SchemaGet the exact schema, field contracts, canonical draft, and reference requirements for one built-in ECS component type (for example TransformComponent). Call this before authoring a component value so the value carries the correct type discriminator and required fields.enginequeryactiveenginemcp<br>ai<br>workflow<br>sdkEngineComponentSchemaRead
engine.sdk.functions.listList Engine Script SDK FunctionsList the script SDK host functions available to authored scripts. Use before writing TypeScript scripts to learn which host APIs exist.enginequeryactiveenginemcp<br>ai<br>workflow<br>sdkEngineSdkFunctionsListed
engine.sdk.function.signature.readRead Engine SDK Function SignatureGet the metadata and signature for one script SDK host function by namespace.name. Use to resolve one script host function before calling it in an authored script.enginequeryactiveenginemcp<br>ai<br>workflow<br>sdkEngineSdkFunctionSignatureRead
engine.capability.graph.readRead Engine Capability GraphRead the canonical engine capability graph for agent self-discovery before complex builds.enginequeryactiveenginemcp<br>ai<br>workflow<br>sdkEngineCapabilityGraphRead
engine.asset_package.listList Engine Smart Asset PackagesList canonical Smart Asset Package manifests before applying a launch package or package variant.enginequeryactiveenginemcp<br>ai<br>workflow<br>sdkEngineSmartAssetPackagesListed
runtime.proof.runRun Runtime ProofExecute one author-declared input against an immutable Project Graph snapshot in an isolated real runtime actor and return typed causal transition evidence with provider and checkpoint lineage.runtime-qacommandactiveruntimemcp<br>ai<br>sdkRuntimeProofRun
versioning.proof.state_diffProve Canonical State DiffCompare immutable pre-author and final Versioning checkpoints, reconstruct the complete canonical Project Graph transition, and evaluate exact reviewer-authored assertions.versioningcommandactiveversioningmcp<br>ai<br>sdkVersioningStateDiffProofRun
factory.proof.runRun Factory ProofDisabled native-AI action: a build-time factory-proof provenance harness, not a runtime owner. Returns a typed unsupported gap if requested by the agent.factory-qacommandactivefactory-proofsdkFactoryProofRun
renderer.visual_profile.applyApply Renderer Visual ProfileApply a canonical renderer visual profile by mutating the Project Graph world environment through backend authority.renderercommandactiverendererui<br>mcp<br>ai<br>sdkRendererVisualProfileApplied
renderer.visual_qa.runRun Renderer Visual QARetired native-AI composite. The canonical renderer pixel-capture primitive is qa.renderer.viewport.capture; this SDK-surface convenience adds profile/fallback receipt checks over it.renderer-qacommandactiveqasdkRendererVisualQaRun
qa.run.startRun Simulation QAExecute bounded deterministic simulation QA from an immutable verified Versioning checkpoint to verify the physics simulation converges to its expected numerical value, returning an executable numerical-oracle receipt with an independent repeat and seed-sensitivity control.qacommandactivesimulationmcp<br>ai<br>workflowSimulationQaRun
qa.renderer.viewport.captureProve Runtime Renderer FrameRender one immutable verified Versioning checkpoint through the real runtime and renderer, independently content-address the PNG bytes, and return exact runtime/browser/media lineage.qacommandactiveqamcp<br>aiRendererViewportCaptured
world.observe.sceneObserve Scene DigestRead a bounded revision-stamped digest of the authored project graph (entity and per-component-type counts, world summary, spatial bounds, named-entity summary, and an optional bounded diff against a prior revision handle).observationqueryactiveai-platform-observationmcp<br>aiWorldObserveScene
world.observe.frameObserve Viewport FrameCapture one editor or runtime viewport frame through the existing qa renderer capture lane where a browser runtime is available, returning a bounded frame descriptor (camera, viewport, renderer, media hash, pixel diagnostics, browser health) or an honest typed unavailable envelope when no browser runtime is present.observationqueryactiveai-platform-observationmcp<br>aiWorldObserveFrame
world.observe.logsObserve Runtime LogsRead a bounded newest-first tail of runtime and script diagnostics for one runtime room.observationqueryactiveai-platform-observationmcp<br>aiWorldObserveLogs
world.observe.roomsObserve Active RoomsRead a bounded roster of active runtime rooms for a game with per-room player and observer counts, status, and lifecycle timestamps.observationqueryactiveai-platform-observationmcp<br>aiWorldObserveRooms
world.sample.terrainSample Terrain SurfaceSample the authored terrain surface height, normal, and slope at up to 64 (x,z) points, reusing the SAME no-drift height math the runtime draws and clamps to. Call BEFORE placing props on sculpted terrain so they rest on the surface instead of a hand-guessed y.observationqueryactiveai-platform-observationmcp<br>aiWorldSampleTerrain
world.observe.entity_viewObserve Entity View (The Eye)Look at what you built: frame up to 8 authored entities in a 3/4 fit-bounds (F-key) view and render the CURRENT head so you SEE placeholders, floating props, and muddy paint a graph digest hides. The frame rides back as an image where the render lane is wired, else a typed capture_unavailable names the missing seam. Use after scenery/prop authoring.observationqueryactiveai-platform-observationmcp<br>aiWorldObserveEntityView
generator.plan.computeCompute Generator PlanRun an authored program in the bounded deterministic sandbox and return a validated world-build semantic-operation batch (the plan is the diff) plus a deterministic double-run planHash. Pure and read-only: the VM has no io/clock/Math.random, only a seeded rand(); the plan holds no write handle.generatorsqueryactiveai-platform-generatorsmcp<br>aiGeneratorPlanComputed
generator.plan.applyApply Generator PlanRecompute a plan by hash, lower it through the world-build semantic compiler (the single validator), and land the generated entities as ONE canonical transaction (one history/undo unit). Idempotent by (programHash, paramsHash, seed): a replay is a no-op. Standard approval applies.generatorscommandactiveai-platform-generatorsmcp<br>aiGeneratorPlanApplied<br>ProjectGraphTransactionApplied
world.author.programAuthor World From One ProgramTypecheck and compile ONE bounded build.ts against the generated builder SDK, compute its world-build plan, land it through the widened generator apply seam as ONE canonical transaction (one history/undo unit), observe one frame, optionally run a default playtest scenario (possess the start entity, move, interact), and return ONE receipt: plan steps, apply stages with per-owner mutation counts and wiring truth, an inline frame, a graded playtest verdict, source-mapped diagnostics back to build.ts lines, and a terminal outcome. Idempotent by (programHash, paramsHash, seed): a replay is a no-op. dry_run computes without applying. Standard approval applies.generatorscommandactiveai-platform-generatorsmcp<br>aiGeneratorPlanApplied<br>ProjectGraphTransactionApplied
world.builder.sdkFetch Builder SDK TypesReturn the builder SDK .d.ts generated from this project's REAL catalog (built-in + project components) and its workspace asset ids: the exact type surface world_author_program typechecks build.ts against. Read-only - one authorized snapshot read plus a pure codegen, writing nothing. Lets an author working outside the editor autocomplete against the vocabulary the server will actually judge, instead of a default-catalog baseline whose asset ids match no real game.generatorsqueryactiveai-platform-generatorsmcp<br>cli<br>aiWorldBuilderSdkRead
world_build.semantic_operations.applyApply World Build Semantic OperationsApply a batch of high-level world-build semantic operations as ONE canonical transaction: compile the operations through the single world-build semantic compiler (the same validator world_build_compile_semantic_operations uses), lower them to Native Agent Runtime operations, and land them via one atomic idempotent applyTransaction (one history/undo unit). Budget-capped and plan-hash deterministic; a replay by idempotency key is a no-op. The WRITE twin of world_build_compile_semantic_operations and the primary document write path. Standard approval applies; conflict and budget overflow surface as typed rejections.generatorscommandactiveai-platform-generatorsmcp<br>aiWorldBuildSemanticOperationsApplied<br>ProjectGraphTransactionApplied
world_build.semantic_operations.compileCompile World Build Semantic OperationsCompile high-level world-build semantic operations through the single world-build semantic compiler and return lowered operations, receipts, and diagnostics without writing anything. The dry-run READ twin of world_build.semantic_operations.apply.generatorsqueryactiveai-platform-generatorsmcp<br>aiWorldBuildSemanticOperationsCompiled
world_build.operation_catalog.readRead World Build Operation CatalogReturn the world-build semantic operation catalog (intent operation ids, titles, lowered targets, required coordinates) that documents what a world-build document can express.generatorsqueryactiveai-platform-generatorsmcp<br>aiWorldBuildOperationCatalogRead
authoring_package.exportExport Authoring PackageExport the live project graph as the canonical authoring-package file tree (gessa.json manifest, worlds/entities documents, GessaScript sources) stamped with the conflict baseline: the graph revision plus per-script IR fingerprints. The read half of the file door - the same export the HTTP route and the gessa-package CLI pull drive.generatorsqueryactiveauthoring-packagemcp<br>aiProjectGraphSnapshotRead
authoring_package.applyApply Authoring PackageLocal-only authoring-package apply: compile against the live graph, then apply owner-validated steps with per-resource idempotency. Aggregate preflight is not qualified; earlier steps may persist before a later rejection. Unavailable outside the local environment. Use supported per-resource authoring operations there. HTTP, MCP, native AI, and CLI share this boundary.generatorscommandactiveauthoring-packagemcp<br>aiWorldBuildSemanticOperationsApplied<br>ProjectGraphTransactionApplied
project.entity.bulk_createBulk Create EntitiesCreate up to 1,000 entities in one decisive batched call with built-in key-suffix conflict healing (each item resolves independently, one commit boundary per item). The batched multi-entity writer the AI core surface prefers over per-entity creates.project-graphcommandactiveproject-graphmcp<br>aiProjectGraphTransactionApplied
world.playtest.scenarioPlaytest ScenarioBoot an isolated proof room for a world, possess an entity, execute a typed action sequence (move/look/jump/interact/press) with per-step tick budgets, and return a revision-stamped outcome (before/after scene digests, per-step applied/failed, diagnostics). Executed proof over a discardable proof room; no durable project mutation.playtestqueryactiveai-platform-playtestmcp<br>aiWorldPlaytestScenario

Surface Mappings

SurfaceMethodPathToolAction
mcpagentenv_create_runagentenv.create_run
mcpagentenv_create_episodeagentenv.create_episode
mcpagentenv_reset_episodeagentenv.reset_episode
mcpagentenv_observeagentenv.observe
mcpagentenv_submit_intentagentenv.submit_intent
mcpagentenv_stepagentenv.step
mcpagentenv_scoreagentenv.score
mcpagentenv_terminateagentenv.terminate
mcpagentenv_fetch_replayagentenv.fetch_replay
mcpagentenv_export_trajectoryagentenv.export_trajectory
mcpproject_get_graph_snapshotproject.graph.snapshot.read
mcpproject_get_worldproject.world.read
mcpproject_get_prefabproject.prefab.read
mcpproject_get_ui_panelproject.ui_panel.read
mcpproject_get_data_storeproject.data_store.read
mcpproject_get_entityproject.entity.read
mcpproject_search_entitiesproject.entity.search
mcpproject_get_scriptproject.script.read
httpPOST/api/workspacesworkspace.create
httpPOST/api/workspaces/:workspaceId/gamesgame.create
httpPATCH/api/games/:gameIdgame.update
httpPUT/api/games/:gameId/thumbnailgame.update
mcpproject_update_gamegame.update
httpPOST/api/games/:gameId/environmentsenvironment.create
httpPOST/api/games/:gameId/project/transactionsproject.transaction.apply
httpPOST/api/games/:gameId/project/assetsproject.asset.create
httpPATCH/api/games/:gameId/project/assets/:assetIdproject.asset.update
httpDELETE/api/games/:gameId/project/assets/:assetIdproject.asset.delete
httpPOST/api/games/:gameId/project/assets/:assetId/duplicateproject.asset.duplicate
mcpasset_duplicateproject.asset.duplicate
httpPOST/api/games/:gameId/project/assets/:assetId/model-documentproject.asset.model_document.save
mcpmodel_saveproject.asset.model_document.save
httpGET/api/games/:gameId/asset-pipeline/:assetId/model-material-slotsasset_pipeline.model_material_slots.inspect
mcpproject_inspect_model_material_slotsasset_pipeline.model_material_slots.inspect
httpPOST/api/games/:gameId/asset-pipeline/:assetId/promote-material-slotasset_pipeline.model_material_slot.promote
mcpproject_promote_model_material_slotasset_pipeline.model_material_slot.promote
httpPOST/api/games/:gameId/asset-pipeline/:assetId/promote-material-slotsasset_pipeline.model_material_slots.promote
mcpproject_promote_model_material_slotsasset_pipeline.model_material_slots.promote
httpPOST/api/games/:gameId/asset-pipeline/model-material-slot-overridesasset_pipeline.model_material_slot.override
mcpproject_override_model_material_slotasset_pipeline.model_material_slot.override
httpPOST/api/games/:gameId/project/worldsproject.world.create
httpPATCH/api/games/:gameId/project/worlds/:idOrKeyproject.world.update
httpDELETE/api/games/:gameId/project/worlds/:idOrKeyproject.world.delete
httpPOST/api/games/:gameId/project/componentsproject.component.create
httpPATCH/api/games/:gameId/project/components/:idOrKeyproject.component.update
httpDELETE/api/games/:gameId/project/components/:idOrKeyproject.component.delete
httpPOST/api/games/:gameId/project/prefabsproject.prefab.create
httpPATCH/api/games/:gameId/project/prefabs/:idOrKeyproject.prefab.update
httpDELETE/api/games/:gameId/project/prefabs/:idOrKeyproject.prefab.delete
httpPOST/api/games/:gameId/project/entitiesproject.entity.create
httpPATCH/api/games/:gameId/project/entities/:idOrKeyproject.entity.update
httpDELETE/api/games/:gameId/project/entities/:idOrKeyproject.entity.delete
httpPOST/api/games/:gameId/project/scriptsproject.script.create
httpPATCH/api/games/:gameId/project/scripts/:idOrKeyproject.script.update
httpDELETE/api/games/:gameId/project/scripts/:idOrKeyproject.script.delete
httpPOST/api/games/:gameId/project/ui-panelsproject.ui_panel.create
httpPATCH/api/games/:gameId/project/ui-panels/:idOrKeyproject.ui_panel.update
httpDELETE/api/games/:gameId/project/ui-panels/:idOrKeyproject.ui_panel.delete
httpPUT/api/games/:gameId/project/entities/:idOrKey/components/:componentKeyproject.entity.component.set
httpPATCH/api/games/:gameId/project/entities/:idOrKey/components/:componentKeyproject.entity.component.set
httpDELETE/api/games/:gameId/project/entities/:idOrKey/components/:componentKeyproject.entity.component.delete
httpPOST/api/generation/quotegeneration.job.quote
httpPOST/api/generation/jobsgeneration.job.create
httpPOST/api/generation/jobs/:jobId/cancelgeneration.job.cancel
httpPOST/api/generation/worker/claimgeneration.job.claim
httpPOST/api/generation/worker/jobs/:jobId/heartbeatgeneration.job.heartbeat
httpPOST/api/generation/worker/jobs/:jobId/progressgeneration.job.progress
httpPOST/api/generation/worker/jobs/:jobId/completegeneration.job.complete
httpPOST/api/generation/worker/jobs/:jobId/failgeneration.job.fail
httpPOST/api/games/:gameId/project/scripts/:idOrKey/patches/applyproject.script.patch.apply
httpPOST/api/games/:gameId/project/assets/:assetId/material/patches/applyproject.material.patch.apply
httpPOST/api/games/:gameId/project/assets/:assetId/terrain/patches/applyterrain.patch.apply
mcpproject_apply_terrain_semantic_patchterrain.patch.apply
httpPOST/api/games/:gameId/project/assets/:assetId/instance-set/patches/applyinstance_set.patch.apply
mcpproject_apply_instance_set_patchinstance_set.patch.apply
sdkproject.instanceSet.applySemanticPatchinstance_set.patch.apply
mcpproject_apply_transactionproject.transaction.apply
sdkproject.terrain.applySemanticPatchterrain.patch.apply
httpPOST/api/games/:gameId/project/assets/:assetId/terrain/artifacts/buildterrain.artifacts.build
sdkproject.terrain.buildArtifactsterrain.artifacts.build
httpPOST/api/games/:gameId/publish/devpublish.dev
httpPOST/api/games/:gameId/spatial-assets/importsspatial.asset.import
httpPOST/api/games/:gameId/spatial-assets/import-jobs/:jobId/runspatial.asset.import
httpPOST/api/games/:gameId/spatial-assets/:assetId/proxy-jobsspatial.capture.proxy.generate
httpPOST/api/games/:gameId/spatial-assets/proxy-jobs/:jobId/runspatial.capture.proxy.generate
httpPOST/api/games/:gameId/spatial-assets/:assetId/annotationsspatial.capture.annotate
httpPOST/api/games/:gameId/spatial-assets/:assetId/build-worldworld.build.from_spatial_asset
httpPOST/api/games/:gameId/project/worlds/:idOrKey/visual-profile/applyrenderer.visual_profile.apply
sdkrenderer.visualProfiles.applyrenderer.visual_profile.apply
mcpproject_create_gamegame.create
httpPUT/api/games/:gameId/commerce/offers/:offerKeycommerce.offer.set
mcpcommerce_set_offercommerce.offer.set
aiset_commerce_offercommerce.offer.set
sdkCommerce.setOffercommerce.offer.set
httpGET/api/games/:gameId/commerce/catalogcommerce.offer.list
mcpcommerce_list_offerscommerce.offer.list
ailist_commerce_offerscommerce.offer.list
sdkCommerce.listOfferscommerce.offer.list
httpPATCH/api/games/:gameId/multiplayer-defaultgame.multiplayer_blueprint.set
mcpproject_set_multiplayer_blueprintgame.multiplayer_blueprint.set
aiset_game_multiplayer_blueprintgame.multiplayer_blueprint.set
sdkProject.setMultiplayerBlueprintgame.multiplayer_blueprint.set
mcpworkspace_asset_linkworkspace.asset.link
httpPOST/api/workspaces/:workspaceId/assets/:assetIdOrKey/link-gameworkspace.asset.link
mcpproject_create_assetproject.asset.create
mcpproject_create_worldproject.world.create
mcpproject_create_entityproject.entity.create
mcpproject_create_scriptproject.script.create
mcpproject_update_scriptproject.script.update
mcpproject_apply_script_semantic_patchproject.script.patch.apply
aiapply_script_semantic_patchproject.script.patch.apply
sdkproject.scripts.applySemanticPatchproject.script.patch.apply
mcpproject_apply_material_semantic_patchproject.material.patch.apply
aiapply_material_semantic_patchproject.material.patch.apply
sdkproject.materials.applySemanticPatchproject.material.patch.apply
mcpproject_apply_smart_asset_packageblueprint.package.apply
aiapply_smart_asset_packageblueprint.package.apply
sdkProject.applySmartAssetPackageblueprint.package.apply
httpPOST/api/games/:gameId/workflows/:idOrKey/runsworkflow.run.start
mcpproject_start_workflow_runworkflow.run.start
mcpproject_create_ui_panelproject.ui_panel.create
mcpproject_create_data_storeproject.data_store.create
mcpspatial_asset_queue_importspatial.asset.import
mcpspatial_capture_queue_proxy_jobspatial.capture.proxy.generate
mcpspatial_capture_record_annotationsspatial.capture.annotate
mcpworld_build_from_spatial_assetworld.build.from_spatial_asset
aibuild_world_from_spatial_assetworld.build.from_spatial_asset
sdkworld.build.fromSpatialAssetworld.build.from_spatial_asset
sdkrenderer.visualQa.runrenderer.visual_qa.run
mcpqa_capture_renderer_viewportqa.renderer.viewport.capture
mcpblender_model_createblender.model.create
mcpgeneration_create_jobgeneration.job.create
mcpgeneration_list_capabilitiesgeneration.capability.list
mcpgeneration_get_jobgeneration.job.read
mcpgeneration_list_jobsgeneration.job.list
mcpknowledge_searchknowledge.search
mcpknowledge_loadknowledge.load
mcpengine_list_component_typesengine.component.types.list
mcpengine_get_component_schemaengine.component.schema.read
mcpengine_list_sdk_functionsengine.sdk.functions.list
mcpengine_get_sdk_function_signatureengine.sdk.function.signature.read
mcpengine_get_capability_graphengine.capability.graph.read
mcpengine_list_smart_asset_packagesengine.asset_package.list
mcpproject_update_worldproject.world.update
mcpproject_delete_worldproject.world.delete
mcpproject_update_entityproject.entity.update
mcpproject_delete_entityproject.entity.delete
mcpproject_add_componentproject.entity.component.set
mcpproject_remove_componentproject.entity.component.delete
mcpproject_update_assetproject.asset.update
mcpproject_delete_assetproject.asset.delete
mcpproject_create_prefabproject.prefab.create
mcpproject_update_prefabproject.prefab.update
mcpproject_delete_prefabproject.prefab.delete
mcpproject_delete_scriptproject.script.delete
mcpproject_update_ui_panelproject.ui_panel.update
mcpproject_delete_ui_panelproject.ui_panel.delete
mcpproject_update_data_storeproject.data_store.update
mcpproject_delete_data_storeproject.data_store.delete
mcpworkspace_createworkspace.create
mcpproject_create_environmentenvironment.create
mcpruntime_proof_runruntime.proof.run
mcpversioning_state_diff_proof_runversioning.proof.state_diff
mcpsimulation_runqa.run.start
mcpworld_apply_visual_profilerenderer.visual_profile.apply
mcpgeneration_quote_jobgeneration.job.quote
mcpgeneration_cancel_jobgeneration.job.cancel
mcpterrain_build_artifactsterrain.artifacts.build
mcpruntime_create_deploymentpublish.dev
mcpworld_observe_sceneworld.observe.scene
mcpworld_observe_frameworld.observe.frame
mcpworld_observe_logsworld.observe.logs
mcpworld_observe_roomsworld.observe.rooms
mcpworld_sample_terrainworld.sample.terrain
mcpworld_observe_entity_viewworld.observe.entity_view
mcpgenerator_plan_computegenerator.plan.compute
mcpgenerator_plan_applygenerator.plan.apply
mcpworld_playtest_scenarioworld.playtest.scenario
mcpworld_author_programworld.author.program
mcpworld_builder_sdkworld.builder.sdk
mcpworld_build_apply_semantic_operationsworld_build.semantic_operations.apply
mcpworld_build_compile_semantic_operationsworld_build.semantic_operations.compile
mcpworld_build_get_operation_catalogworld_build.operation_catalog.read
httpGET/api/games/:gameId/authoring-package/exportauthoring_package.export
httpPOST/api/games/:gameId/authoring-package/applyauthoring_package.apply
mcpworld_build_export_authoring_packageauthoring_package.export
mcpworld_build_apply_authoring_packageauthoring_package.apply
mcpproject_bulk_create_entitiesproject.entity.bulk_create

Action Details

One section per action, keyed by action id, so a reference to an action id resolves to its own anchor.

agentenv.create_episode

Execute the canonical AgentEnv CreateEpisode protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.

FieldValue
TitleCreate Episode Agent Environment
Domainagentenv
Kindcommand
Lifecycleactive
Owneragentenv
Exposuremcp, sdk
Audit eventsAgentEnvCreateEpisode

Surface mappings:

SurfaceMethodPathTool
mcpagentenv_create_episode

agentenv.create_run

Execute the canonical AgentEnv CreateRun protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.

FieldValue
TitleCreate Run Agent Environment
Domainagentenv
Kindcommand
Lifecycleactive
Owneragentenv
Exposuremcp, sdk
Audit eventsAgentEnvCreateRun

Surface mappings:

SurfaceMethodPathTool
mcpagentenv_create_run

agentenv.export_trajectory

Execute the canonical AgentEnv ExportTrajectory protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.

FieldValue
TitleExport Trajectory Agent Environment
Domainagentenv
Kindcommand
Lifecycleactive
Owneragentenv
Exposuremcp, sdk
Audit eventsAgentEnvExportTrajectory

Surface mappings:

SurfaceMethodPathTool
mcpagentenv_export_trajectory

agentenv.fetch_replay

Execute the canonical AgentEnv FetchReplay protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.

FieldValue
TitleFetch Replay Agent Environment
Domainagentenv
Kindquery
Lifecycleactive
Owneragentenv
Exposuremcp, sdk
Audit eventsAgentEnvFetchReplay

Surface mappings:

SurfaceMethodPathTool
mcpagentenv_fetch_replay

agentenv.observe

Execute the canonical AgentEnv Observe protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.

FieldValue
TitleObserve Agent Environment
Domainagentenv
Kindquery
Lifecycleactive
Owneragentenv
Exposuremcp, sdk
Audit eventsAgentEnvObserve

Surface mappings:

SurfaceMethodPathTool
mcpagentenv_observe

agentenv.reset_episode

Execute the canonical AgentEnv ResetEpisode protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.

FieldValue
TitleReset Episode Agent Environment
Domainagentenv
Kindcommand
Lifecycleactive
Owneragentenv
Exposuremcp, sdk
Audit eventsAgentEnvResetEpisode

Surface mappings:

SurfaceMethodPathTool
mcpagentenv_reset_episode

agentenv.score

Execute the canonical AgentEnv Score protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.

FieldValue
TitleScore Agent Environment
Domainagentenv
Kindquery
Lifecycleactive
Owneragentenv
Exposuremcp, sdk
Audit eventsAgentEnvScore

Surface mappings:

SurfaceMethodPathTool
mcpagentenv_score

agentenv.step

Execute the canonical AgentEnv Step protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.

FieldValue
TitleStep Agent Environment
Domainagentenv
Kindcommand
Lifecycleactive
Owneragentenv
Exposuremcp, sdk
Audit eventsAgentEnvStep

Surface mappings:

SurfaceMethodPathTool
mcpagentenv_step

agentenv.submit_intent

Execute the canonical AgentEnv SubmitIntent protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.

FieldValue
TitleSubmit Intent Agent Environment
Domainagentenv
Kindcommand
Lifecycleactive
Owneragentenv
Exposuremcp, sdk
Audit eventsAgentEnvSubmitIntent

Surface mappings:

SurfaceMethodPathTool
mcpagentenv_submit_intent

agentenv.terminate

Execute the canonical AgentEnv Terminate protocol exchange without bypassing lifecycle, identity, version, or idempotency authority.

FieldValue
TitleTerminate Agent Environment
Domainagentenv
Kindcommand
Lifecycleactive
Owneragentenv
Exposuremcp, sdk
Audit eventsAgentEnvTerminate

Surface mappings:

SurfaceMethodPathTool
mcpagentenv_terminate

asset_pipeline.model_material_slot.override

Set or clear one renderable model material-slot override through the Asset Pipeline owner.

FieldValue
TitleOverride Model Material Slot
Domainasset-pipeline
Kindcommand
Lifecycleactive
Ownerasset-pipeline
Exposureui, mcp, ai
Audit eventsAssetPipelineModelMaterialSlotOverridden

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/asset-pipeline/model-material-slot-overrides
mcpproject_override_model_material_slot

asset_pipeline.model_material_slot.promote

Promote one conditioned model material slot into a durable ProjectAsset through the Asset Pipeline owner.

FieldValue
TitlePromote Model Material Slot
Domainasset-pipeline
Kindcommand
Lifecycleactive
Ownerasset-pipeline
Exposureui, mcp, ai
Audit eventsAssetPipelineModelMaterialSlotPromoted

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/asset-pipeline/:assetId/promote-material-slot
mcpproject_promote_model_material_slot

asset_pipeline.model_material_slots.inspect

Inspect the canonical conditioned material-slot projection for one model ProjectAsset UUID.

FieldValue
TitleInspect Model Material Slots
Domainasset-pipeline
Kindquery
Lifecycleactive
Ownerasset-pipeline
Exposureui, mcp, ai
Audit eventsAssetPipelineModelMaterialSlotsInspected

Surface mappings:

SurfaceMethodPathTool
httpGET/api/games/:gameId/asset-pipeline/:assetId/model-material-slots
mcpproject_inspect_model_material_slots

asset_pipeline.model_material_slots.promote

Promote all, every, or a selected bulk batch of conditioned model material slots into durable material assets through the Asset Pipeline owner.

FieldValue
TitlePromote Model Material Slots
Domainasset-pipeline
Kindcommand
Lifecycleactive
Ownerasset-pipeline
Exposureui, mcp, ai
Audit eventsAssetPipelineModelMaterialSlotsPromoted

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/asset-pipeline/:assetId/promote-material-slots
mcpproject_promote_model_material_slots

authoring_package.apply

Local-only authoring-package apply: compile against the live graph, then apply owner-validated steps with per-resource idempotency. Aggregate preflight is not qualified; earlier steps may persist before a later rejection. Unavailable outside the local environment. Use supported per-resource authoring operations there. HTTP, MCP, native AI, and CLI share this boundary.

FieldValue
TitleApply Authoring Package
Domaingenerators
Kindcommand
Lifecycleactive
Ownerauthoring-package
Exposuremcp, ai
Audit eventsWorldBuildSemanticOperationsApplied, ProjectGraphTransactionApplied

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/authoring-package/apply
mcpworld_build_apply_authoring_package

authoring_package.export

Export the live project graph as the canonical authoring-package file tree (gessa.json manifest, worlds/entities documents, GessaScript sources) stamped with the conflict baseline: the graph revision plus per-script IR fingerprints. The read half of the file door - the same export the HTTP route and the gessa-package CLI pull drive.

FieldValue
TitleExport Authoring Package
Domaingenerators
Kindquery
Lifecycleactive
Ownerauthoring-package
Exposuremcp, ai
Audit eventsProjectGraphSnapshotRead

Surface mappings:

SurfaceMethodPathTool
httpGET/api/games/:gameId/authoring-package/export
mcpworld_build_export_authoring_package

blender.model.create

Author a detailed Blender model with the dedicated Astra model, render and import it through the durable generation service.

FieldValue
TitleCreate Blender Model
Domaingeneration
Kindjob_start
Lifecycleactive
Ownergeneration
Exposureai
Audit eventsBlenderModelRequested

Surface mappings:

SurfaceMethodPathTool
mcpblender_model_create

blueprint.package.apply

Apply a canonical Smart Asset Package manifest through backend package service paths and Project Graph transactions.

FieldValue
TitleApply Smart Asset Package
Domainblueprint
Kindcommand
Lifecycleactive
Ownerblueprints
Exposureui, mcp, ai, workflow, sdk
Audit eventsSmartAssetPackageApplied, ProjectGraphTransactionApplied

Surface mappings:

SurfaceMethodPathTool
mcpproject_apply_smart_asset_package
aiapply_smart_asset_package
sdkProject.applySmartAssetPackage

blueprint.template.apply

Compatibility alias for applying a creation template; canonical package application is blueprint.package.apply.

FieldValue
TitleApply Creation Template
Domainblueprint
Kindcommand
Lifecycleplanned
Ownerblueprints
Exposureui, sdk
Audit eventsCreationTemplateApplied

Surface mappings:

No surface mappings; reachable through the exposure surfaces above.

commerce.offer.list

List every offer defined on a game, drafts and archived included, with keys, prices, kinds and statuses. Read this before naming an offer key in a script so the purchase prompt points at an offer that exists and is active.

FieldValue
TitleList Commerce Offers
Domaincontrol-plane
Kindquery
Lifecycleactive
Ownercommerce
Exposureui, mcp, ai, sdk
Audit eventsListCommerceOffers

Surface mappings:

SurfaceMethodPathTool
httpGET/api/games/:gameId/commerce/catalog
mcpcommerce_list_offers
ailist_commerce_offers
sdkCommerce.listOffers

commerce.offer.set

Create or update one purchasable offer on a game: its title, price, kind (durable or consumable), status (draft, active, archived) and the entitlement or item grants it delivers. Offers are what a script's Commerce.promptPurchase names, so the offer must exist before a purchase prompt can open.

FieldValue
TitleSet Commerce Offer
Domaincontrol-plane
Kindcommand
Lifecycleactive
Ownercommerce
Exposureui, mcp, ai, sdk
Audit eventsUpsertCommerceOffer

Surface mappings:

SurfaceMethodPathTool
httpPUT/api/games/:gameId/commerce/offers/:offerKey
mcpcommerce_set_offer
aiset_commerce_offer
sdkCommerce.setOffer

engine.asset_package.list

List canonical Smart Asset Package manifests before applying a launch package or package variant.

FieldValue
TitleList Engine Smart Asset Packages
Domainengine
Kindquery
Lifecycleactive
Ownerengine
Exposuremcp, ai, workflow, sdk
Audit eventsEngineSmartAssetPackagesListed

Surface mappings:

SurfaceMethodPathTool
mcpengine_list_smart_asset_packages

engine.capability.graph.read

Read the canonical engine capability graph for agent self-discovery before complex builds.

FieldValue
TitleRead Engine Capability Graph
Domainengine
Kindquery
Lifecycleactive
Ownerengine
Exposuremcp, ai, workflow, sdk
Audit eventsEngineCapabilityGraphRead

Surface mappings:

SurfaceMethodPathTool
mcpengine_get_capability_graph

engine.component.schema.read

Get the exact schema, field contracts, canonical draft, and reference requirements for one built-in ECS component type (for example TransformComponent). Call this before authoring a component value so the value carries the correct type discriminator and required fields.

FieldValue
TitleRead Engine Component Schema
Domainengine
Kindquery
Lifecycleactive
Ownerengine
Exposuremcp, ai, workflow, sdk
Audit eventsEngineComponentSchemaRead

Surface mappings:

SurfaceMethodPathTool
mcpengine_get_component_schema

engine.component.types.list

List built-in ECS component types with their canonical drafts, add modes, reference admission contracts, and field contracts. Use before authoring entity components to learn which component types exist and their exact shapes.

FieldValue
TitleList Engine Component Types
Domainengine
Kindquery
Lifecycleactive
Ownerengine
Exposuremcp, ai, workflow, sdk
Audit eventsEngineComponentTypesListed

Surface mappings:

SurfaceMethodPathTool
mcpengine_list_component_types

engine.sdk.function.signature.read

Get the metadata and signature for one script SDK host function by namespace.name. Use to resolve one script host function before calling it in an authored script.

FieldValue
TitleRead Engine SDK Function Signature
Domainengine
Kindquery
Lifecycleactive
Ownerengine
Exposuremcp, ai, workflow, sdk
Audit eventsEngineSdkFunctionSignatureRead

Surface mappings:

SurfaceMethodPathTool
mcpengine_get_sdk_function_signature

engine.sdk.functions.list

List the script SDK host functions available to authored scripts. Use before writing TypeScript scripts to learn which host APIs exist.

FieldValue
TitleList Engine Script SDK Functions
Domainengine
Kindquery
Lifecycleactive
Ownerengine
Exposuremcp, ai, workflow, sdk
Audit eventsEngineSdkFunctionsListed

Surface mappings:

SurfaceMethodPathTool
mcpengine_list_sdk_functions

environment.create

Create a game environment through the control-plane service.

FieldValue
TitleCreate Environment
Domaincontrol-plane
Kindcommand
Lifecycleactive
Ownercontrol-plane
Exposureui, mcp, ai, sdk
Audit eventsCreateEnvironment

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/environments
mcpproject_create_environment

factory.proof.run

Disabled native-AI action: a build-time factory-proof provenance harness, not a runtime owner. Returns a typed unsupported gap if requested by the agent.

FieldValue
TitleRun Factory Proof
Domainfactory-qa
Kindcommand
Lifecycleactive
Ownerfactory-proof
Exposuresdk
Audit eventsFactoryProofRun

Surface mappings:

No surface mappings; reachable through the exposure surfaces above.

game.create

Create a game/project row and apply the caller's declared canonical template intent.

FieldValue
TitleCreate Project
Domaincontrol-plane
Kindcommand
Lifecycleactive
Ownercontrol-plane
Exposureui, mcp, ai
Audit eventsCreateGame

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/workspaces/:workspaceId/games
mcpproject_create_game

game.multiplayer_blueprint.set

Set the game's default multiplayer blueprint (rooms, queues, teams, seats, placement, lifecycle, and netcode runtime budgets). Configures matchmaking and netcode parameters a script cannot set.

FieldValue
TitleSet Multiplayer Blueprint
Domaincontrol-plane
Kindcommand
Lifecycleactive
Ownercontrol-plane
Exposureui, mcp, ai, sdk
Audit eventsSetGameMultiplayerDefault

Surface mappings:

SurfaceMethodPathTool
httpPATCH/api/games/:gameId/multiplayer-default
mcpproject_set_multiplayer_blueprint
aiset_game_multiplayer_blueprint
sdkProject.setMultiplayerBlueprint

game.update

Update project control-plane fields such as title and thumbnail.

FieldValue
TitleUpdate Project
Domaincontrol-plane
Kindcommand
Lifecycleactive
Ownercontrol-plane
Exposureui, sdk, mcp, ai
Audit eventsUpdateGame, SetGameThumbnail

Surface mappings:

SurfaceMethodPathTool
httpPATCH/api/games/:gameId
httpPUT/api/games/:gameId/thumbnail
mcpproject_update_game

generation.capability.list

List generation offerings visible to the requester through the canonical generation owner.

FieldValue
TitleList Generation Capabilities
Domaingeneration
Kindquery
Lifecycleactive
Ownergeneration
Exposureui, mcp, ai, workflow, sdk
Audit eventsGenerationCapabilitiesListed

Surface mappings:

SurfaceMethodPathTool
mcpgeneration_list_capabilities

generation.job.cancel

Cancel an unclaimed generation job through its owner, or explicitly cancel saved placement with scope placement while rendering and incurred charges continue. Inspect the returned placement status for completion races.

FieldValue
TitleCancel Generation Job
Domaingeneration
Kindcommand
Lifecycleactive
Ownergeneration
Exposureui, mcp, ai, workflow, sdk
Audit eventsGenerationJobCancel

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/generation/jobs/:jobId/cancel
mcpgeneration_cancel_job

generation.job.claim

Claim the next queued generation job for a worker lease.

FieldValue
TitleClaim Generation Job
Domaingeneration
Kindjob_start
Lifecycleactive
Ownergeneration
Exposurecli, admin
Audit eventsGenerationJobClaim

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/generation/worker/claim

generation.job.complete

Complete and finalize a generation job.

FieldValue
TitleComplete Generation Job
Domaingeneration
Kindcommand
Lifecycleactive
Ownergeneration
Exposurecli, admin
Audit eventsGenerationJobComplete

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/generation/worker/jobs/:jobId/complete

generation.job.create

Create a durable generation job for an approved capability.

FieldValue
TitleCreate Generation Job
Domaingeneration
Kindjob_start
Lifecycleactive
Ownergeneration
Exposureui, mcp, ai, workflow, sdk
Audit eventsGenerationJobCreated, GenerationJobQueued

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/generation/jobs
mcpgeneration_create_job

generation.job.fail

Fail or retry a generation job through worker-owned state transitions.

FieldValue
TitleFail Generation Job
Domaingeneration
Kindcommand
Lifecycleactive
Ownergeneration
Exposurecli, admin
Audit eventsGenerationJobFail

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/generation/worker/jobs/:jobId/fail

generation.job.heartbeat

Extend a generation job worker lease.

FieldValue
TitleHeartbeat Generation Job
Domaingeneration
Kindcommand
Lifecycleactive
Ownergeneration
Exposurecli, admin
Audit eventsGenerationJobHeartbeat

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/generation/worker/jobs/:jobId/heartbeat

generation.job.list

List durable generation jobs visible to the requester through the canonical generation owner.

FieldValue
TitleList Generation Jobs
Domaingeneration
Kindquery
Lifecycleactive
Ownergeneration
Exposureui, mcp, ai, workflow, sdk
Audit eventsGenerationJobsListed

Surface mappings:

SurfaceMethodPathTool
mcpgeneration_list_jobs

generation.job.progress

Record worker-owned generation job progress.

FieldValue
TitleProgress Generation Job
Domaingeneration
Kindcommand
Lifecycleactive
Ownergeneration
Exposurecli, admin
Audit eventsGenerationJobProgress

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/generation/worker/jobs/:jobId/progress

generation.job.quote

Quote a generation request against capability, policy, and budget controls.

FieldValue
TitleQuote Generation Job
Domaingeneration
Kindcommand
Lifecycleactive
Ownergeneration
Exposureui, mcp, ai, workflow, sdk
Audit eventsGenerationJobQuoted

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/generation/quote
mcpgeneration_quote_job

generation.job.read

Read one durable generation job through the canonical generation owner.

FieldValue
TitleRead Generation Job
Domaingeneration
Kindquery
Lifecycleactive
Ownergeneration
Exposureui, mcp, ai, workflow, sdk
Audit eventsGenerationJobRead

Surface mappings:

SurfaceMethodPathTool
mcpgeneration_get_job

generator.plan.apply

Recompute a plan by hash, lower it through the world-build semantic compiler (the single validator), and land the generated entities as ONE canonical transaction (one history/undo unit). Idempotent by (programHash, paramsHash, seed): a replay is a no-op. Standard approval applies.

FieldValue
TitleApply Generator Plan
Domaingenerators
Kindcommand
Lifecycleactive
Ownerai-platform-generators
Exposuremcp, ai
Audit eventsGeneratorPlanApplied, ProjectGraphTransactionApplied

Surface mappings:

SurfaceMethodPathTool
mcpgenerator_plan_apply

generator.plan.compute

Run an authored program in the bounded deterministic sandbox and return a validated world-build semantic-operation batch (the plan is the diff) plus a deterministic double-run planHash. Pure and read-only: the VM has no io/clock/Math.random, only a seeded rand(); the plan holds no write handle.

FieldValue
TitleCompute Generator Plan
Domaingenerators
Kindquery
Lifecycleactive
Ownerai-platform-generators
Exposuremcp, ai
Audit eventsGeneratorPlanComputed

Surface mappings:

SurfaceMethodPathTool
mcpgenerator_plan_compute

instance_set.patch.apply

Apply checked bulk InstanceSet aggregate operations (configure/populate/fill/clearRegion/setCells/clearCells/scatterInstances/paintKind/removeInstances) to a versioned instanceSet resource facet through the single instance-set patch chokepoint (compileInstanceSetPatch + applyInstanceSetPatch), advancing the facet source version so render/collider projections regenerate. Lowers into ProjectGraphService.applyInstanceSetPatch over the asset instanceSet facet via the existing updateAsset path (no parallel write path); author only through the typed ops, never raw packed cell/instance arrays.

FieldValue
TitleApply Instance Set Semantic Patch
Domaininstance-set
Kindcommand
Lifecycleactive
Ownerinstance-set
Exposureui, mcp, ai, workflow, sdk
Audit eventsInstanceSetPatchApplied

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/assets/:assetId/instance-set/patches/apply
mcpproject_apply_instance_set_patch
sdkproject.instanceSet.applySemanticPatch

knowledge.load

Load one knowledge entry by id with full provenance (source path, sha256, corpus, trust). Optional playbook/distillation corpora refuse to load under the no-skill switch.

FieldValue
TitleLoad Knowledge Entry
Domainknowledge
Kindquery
Lifecycleactive
Ownerknowledge
Exposuremcp, ai, workflow, sdk
Audit eventsKnowledgeLoaded

Surface mappings:

SurfaceMethodPathTool
mcpknowledge_load

Search the pull-only knowledge library (generated engine reference plus optional curated playbooks) and return pointers with distilled summaries, never bulk content.

FieldValue
TitleSearch Knowledge Library
Domainknowledge
Kindquery
Lifecycleactive
Ownerknowledge
Exposuremcp, ai, workflow, sdk
Audit eventsKnowledgeSearched

Surface mappings:

SurfaceMethodPathTool
mcpknowledge_search

project.asset.create

Create a ProjectAsset through the UUID-only Project Graph client contract; internal keys, storage, pipeline, provenance, and frozen graph fields are never caller-owned.

FieldValue
TitleCreate Project Asset
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsCreateProjectAsset

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/assets
mcpproject_create_asset

project.asset.delete

Delete a ProjectAsset through the UUID-only Project Graph client contract; internal keys, storage, pipeline, provenance, and frozen graph fields are never caller-owned.

FieldValue
TitleDelete Project Asset
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsDeleteProjectAsset

Surface mappings:

SurfaceMethodPathTool
httpDELETE/api/games/:gameId/project/assets/:assetId
mcpproject_delete_asset

project.asset.duplicate

Duplicate a ProjectAsset by canonical UUID through the Project Graph owner so storage-owned fields are copied internally and never reconstructed by a caller.

FieldValue
TitleDuplicate Project Asset
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai
Audit eventsCreateProjectAsset

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/assets/:assetId/duplicate
mcpasset_duplicate

project.asset.model_document.save

Validate and persist the authored ModelAuthoringDocument through the dedicated Project Graph merge boundary without opening the generic client asset update to server-owned rendering fields.

FieldValue
TitleSave Project Model Document
Domainmodel-authoring
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai
Audit eventsUpdateProjectAsset

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/assets/:assetId/model-document
mcpmodel_save

project.asset.update

Update a ProjectAsset through the UUID-only Project Graph client contract; internal keys, storage, pipeline, provenance, and frozen graph fields are never caller-owned.

FieldValue
TitleUpdate Project Asset
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsUpdateProjectAsset

Surface mappings:

SurfaceMethodPathTool
httpPATCH/api/games/:gameId/project/assets/:assetId
mcpproject_update_asset

project.component.create

Create a Project Graph component definition record through backend service paths. Project-defined components are production-grade backend-validated project-local data contracts for advanced/import-only data; they are not canonical engine atomics.

FieldValue
TitleCreate Project Component
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, sdk
Audit eventsCreateProjectComponent

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/components

project.component.delete

Delete a Project Graph component definition record through backend service paths. Project-defined components are production-grade backend-validated project-local data contracts for advanced/import-only data; they are not canonical engine atomics.

FieldValue
TitleDelete Project Component
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, sdk
Audit eventsDeleteProjectComponent

Surface mappings:

SurfaceMethodPathTool
httpDELETE/api/games/:gameId/project/components/:idOrKey

project.component.update

Update a Project Graph component definition record through backend service paths. Project-defined components are production-grade backend-validated project-local data contracts for advanced/import-only data; they are not canonical engine atomics.

FieldValue
TitleUpdate Project Component
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, sdk
Audit eventsUpdateProjectComponent

Surface mappings:

SurfaceMethodPathTool
httpPATCH/api/games/:gameId/project/components/:idOrKey

project.data_store.create

Create a Project Graph data store record through the canonical owner service; the receipt is the exact client resource.

FieldValue
TitleCreate Project Data Store
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsCreateProjectDataStore

Surface mappings:

SurfaceMethodPathTool
mcpproject_create_data_store

project.data_store.delete

Delete a Project Graph data store record through the canonical owner service; the receipt is the exact client resource.

FieldValue
TitleDelete Project Data Store
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsDeleteProjectDataStore

Surface mappings:

SurfaceMethodPathTool
mcpproject_delete_data_store

project.data_store.read

Read one Project Graph data store record by uuid or graph key through the canonical owner service; the receipt is the exact client resource with its current version.

FieldValue
TitleRead Project Data Store
Domainproject-graph
Kindquery
Lifecycleactive
Ownerproject-graph
Exposuremcp, ai, workflow, sdk
Audit eventsReadProjectDataStore

Surface mappings:

SurfaceMethodPathTool
mcpproject_get_data_store

project.data_store.update

Update a Project Graph data store record through the canonical owner service; the receipt is the exact client resource.

FieldValue
TitleUpdate Project Data Store
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsUpdateProjectDataStore

Surface mappings:

SurfaceMethodPathTool
mcpproject_update_data_store

project.entity.bulk_create

Create up to 1,000 entities in one decisive batched call with built-in key-suffix conflict healing (each item resolves independently, one commit boundary per item). The batched multi-entity writer the AI core surface prefers over per-entity creates.

FieldValue
TitleBulk Create Entities
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposuremcp, ai
Audit eventsProjectGraphTransactionApplied

Surface mappings:

SurfaceMethodPathTool
mcpproject_bulk_create_entities

project.entity.component.delete

Remove one component from a Project Graph entity through the canonical component mutation kernel. With expected_revision the delete goes through an optimistic-concurrency transaction and returns a transaction result; otherwise it returns the updated entity.

FieldValue
TitleDelete Entity Component
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsDeleteProjectEntityComponent

Surface mappings:

SurfaceMethodPathTool
httpDELETE/api/games/:gameId/project/entities/:idOrKey/components/:componentKey
mcpproject_remove_component

project.entity.component.set

Add or replace a complete component on a Project Graph entity through the canonical component mutation kernel. With expected_revision the write goes through an optimistic-concurrency transaction and returns a transaction result; otherwise it returns the updated entity.

FieldValue
TitleSet Entity Component
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsSetProjectEntityComponentOverride, PutProjectEntityComponent, PatchProjectEntityComponent

Surface mappings:

SurfaceMethodPathTool
httpPUT/api/games/:gameId/project/entities/:idOrKey/components/:componentKey
httpPATCH/api/games/:gameId/project/entities/:idOrKey/components/:componentKey
mcpproject_add_component

project.entity.create

Create a Project Graph entity in a world through the canonical entity owner. worldId/parentEntityId/prefabId accept a uuid or a graph key; on_conflict controls duplicate-key handling.

FieldValue
TitleCreate Project Entity
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsCreateProjectEntity

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/entities
mcpproject_create_entity

project.entity.delete

Delete a Project Graph entity through the canonical entity owner. With expected_revision the delete goes through an optimistic-concurrency transaction and returns a transaction result; otherwise it returns the deleted entity.

FieldValue
TitleDelete Project Entity
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsDeleteProjectEntity

Surface mappings:

SurfaceMethodPathTool
httpDELETE/api/games/:gameId/project/entities/:idOrKey
mcpproject_delete_entity

project.entity.read

Read one Project Graph entity by uuid or graph key through the canonical entity owner; the receipt is the exact client entity with its current version and components.

FieldValue
TitleRead Project Entity
Domainproject-graph
Kindquery
Lifecycleactive
Ownerproject-graph
Exposuremcp, ai, workflow, sdk
Audit eventsReadProjectEntity

Surface mappings:

SurfaceMethodPathTool
mcpproject_get_entity

Search Project Graph entities by query, world, tag(s), component type(s), or key prefix through the canonical entity owner, returning a bounded cursor-paginated page of entity records (the discovery reader for edit targets).

FieldValue
TitleSearch Project Entities
Domainproject-graph
Kindquery
Lifecycleactive
Ownerproject-graph
Exposuremcp, ai, workflow, sdk
Audit eventsSearchProjectEntities

Surface mappings:

SurfaceMethodPathTool
mcpproject_search_entities

project.entity.update

Update a Project Graph entity's identity, hierarchy, tags, or metadata through the canonical entity owner. With expected_revision the write goes through an optimistic-concurrency transaction and returns a transaction result; otherwise it returns the updated entity.

FieldValue
TitleUpdate Project Entity
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsUpdateProjectEntity

Surface mappings:

SurfaceMethodPathTool
httpPATCH/api/games/:gameId/project/entities/:idOrKey
mcpproject_update_entity

project.graph.snapshot.read

Read the current typed Project Graph snapshot through its owner service.

FieldValue
TitleRead Project Graph Snapshot
Domainproject-graph
Kindquery
Lifecycleactive
Ownerproject-graph
Exposuremcp, ai, workflow, sdk
Audit eventsProjectGraphSnapshotRead

Surface mappings:

SurfaceMethodPathTool
mcpproject_get_graph_snapshot

project.material.patch.apply

Apply checked semantic patch operations to a material asset and persist canonical material graph artifacts.

FieldValue
TitleApply Material Semantic Patch
Domainmaterial-authoring
Kindcommand
Lifecycleactive
Ownermaterial-semantic-patch
Exposureui, mcp, ai, workflow, sdk
Audit eventsProjectGraphAssetUpdated

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/assets/:assetId/material/patches/apply
mcpproject_apply_material_semantic_patch
aiapply_material_semantic_patch
sdkproject.materials.applySemanticPatch

project.prefab.create

Create a Project Graph prefab record through the canonical owner service; the receipt is the exact client resource.

FieldValue
TitleCreate Project Prefab
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsCreateProjectPrefab

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/prefabs
mcpproject_create_prefab

project.prefab.delete

Delete a Project Graph prefab record through the canonical owner service; the receipt is the exact client resource.

FieldValue
TitleDelete Project Prefab
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsDeleteProjectPrefab

Surface mappings:

SurfaceMethodPathTool
httpDELETE/api/games/:gameId/project/prefabs/:idOrKey
mcpproject_delete_prefab

project.prefab.read

Read one Project Graph prefab record by uuid or graph key through the canonical owner service; the receipt is the exact client resource with its current version.

FieldValue
TitleRead Project Prefab
Domainproject-graph
Kindquery
Lifecycleactive
Ownerproject-graph
Exposuremcp, ai, workflow, sdk
Audit eventsReadProjectPrefab

Surface mappings:

SurfaceMethodPathTool
mcpproject_get_prefab

project.prefab.update

Update a Project Graph prefab record through the canonical owner service; the receipt is the exact client resource.

FieldValue
TitleUpdate Project Prefab
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsUpdateProjectPrefab

Surface mappings:

SurfaceMethodPathTool
httpPATCH/api/games/:gameId/project/prefabs/:idOrKey
mcpproject_update_prefab

project.script.create

Create a Project Graph script from a structural GessaScript shell through the canonical script owner.

FieldValue
TitleCreate Project Script
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsCreateProjectScript

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/scripts
mcpproject_create_script

project.script.delete

Delete a Project Graph script through the canonical script owner.

FieldValue
TitleDelete Project Script
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsDeleteProjectScript

Surface mappings:

SurfaceMethodPathTool
httpDELETE/api/games/:gameId/project/scripts/:idOrKey
mcpproject_delete_script

project.script.patch.apply

Apply checked semantic patch operations to a Project Script and persist canonical Script IR.

FieldValue
TitleApply Script Semantic Patch
Domainscript-authoring
Kindcommand
Lifecycleactive
Ownerscript-semantic-patch
Exposureui, mcp, ai, workflow, sdk
Audit eventsUpdateProjectScript

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/scripts/:idOrKey/patches/apply
mcpproject_apply_script_semantic_patch
aiapply_script_semantic_patch
sdkproject.scripts.applySemanticPatch

project.script.read

Read one Project Graph script by uuid or graph key through the canonical script owner; the receipt is the exact client script carrying its current version and IR fingerprint together, so a semantic patch never needs to probe for concurrency coordinates.

FieldValue
TitleRead Project Script
Domainproject-graph
Kindquery
Lifecycleactive
Ownerproject-graph
Exposuremcp, ai, workflow, sdk
Audit eventsReadProjectScript

Surface mappings:

SurfaceMethodPathTool
mcpproject_get_script

project.script.update

Update a Project Graph script's metadata through the canonical script owner.

FieldValue
TitleUpdate Project Script
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsUpdateProjectScript

Surface mappings:

SurfaceMethodPathTool
httpPATCH/api/games/:gameId/project/scripts/:idOrKey
mcpproject_update_script

project.transaction.apply

Atomically apply several low-level Project Graph ops as ONE checked, idempotent, undoable transaction. Each op is a { kind, ...fields } object (record.create/update/delete, component.put/patch/delete/add/remove) over a resourceKind (asset, world, component, prefab, entity, script, workflow, ui-panel, data-store); the ops field description carries the exact shapes. The precision batched writer: no engine-owned component defaults, strong per-op validation on receipt.

FieldValue
TitleApply Project Graph Transaction
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureworkflow
Audit eventsProjectGraphTransactionApplied

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/transactions
mcpproject_apply_transaction

project.ui_panel.create

Create a Project Graph ui panel record through the canonical owner service; the receipt is the exact client resource.

FieldValue
TitleCreate Project Ui Panel
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsCreateProjectUiPanel

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/ui-panels
mcpproject_create_ui_panel

project.ui_panel.delete

Delete a Project Graph ui panel record through the canonical owner service; the receipt is the exact client resource.

FieldValue
TitleDelete Project Ui Panel
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsDeleteProjectUiPanel

Surface mappings:

SurfaceMethodPathTool
httpDELETE/api/games/:gameId/project/ui-panels/:idOrKey
mcpproject_delete_ui_panel

project.ui_panel.read

Read one Project Graph ui panel record by uuid or graph key through the canonical owner service; the receipt is the exact client resource with its current version.

FieldValue
TitleRead Project Ui Panel
Domainproject-graph
Kindquery
Lifecycleactive
Ownerproject-graph
Exposuremcp, ai, workflow, sdk
Audit eventsReadProjectUiPanel

Surface mappings:

SurfaceMethodPathTool
mcpproject_get_ui_panel

project.ui_panel.update

Update a Project Graph ui panel record through the canonical owner service; the receipt is the exact client resource.

FieldValue
TitleUpdate Project Ui Panel
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsUpdateProjectUiPanel

Surface mappings:

SurfaceMethodPathTool
httpPATCH/api/games/:gameId/project/ui-panels/:idOrKey
mcpproject_update_ui_panel

project.world.create

Create a Project Graph world record through the canonical owner service; the receipt is the exact client resource.

FieldValue
TitleCreate Project World
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsCreateProjectWorld

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/worlds
mcpproject_create_world

project.world.delete

Delete a Project Graph world record through the canonical owner service; the receipt is the exact client resource.

FieldValue
TitleDelete Project World
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsDeleteProjectWorld

Surface mappings:

SurfaceMethodPathTool
httpDELETE/api/games/:gameId/project/worlds/:idOrKey
mcpproject_delete_world

project.world.read

Read one Project Graph world record by uuid or graph key through the canonical owner service; the receipt is the exact client resource with its current version.

FieldValue
TitleRead Project World
Domainproject-graph
Kindquery
Lifecycleactive
Ownerproject-graph
Exposuremcp, ai, workflow, sdk
Audit eventsReadProjectWorld

Surface mappings:

SurfaceMethodPathTool
mcpproject_get_world

project.world.update

Update a Project Graph world record through the canonical owner service; the receipt is the exact client resource.

FieldValue
TitleUpdate Project World
Domainproject-graph
Kindcommand
Lifecycleactive
Ownerproject-graph
Exposureui, mcp, ai, sdk
Audit eventsUpdateProjectWorld

Surface mappings:

SurfaceMethodPathTool
httpPATCH/api/games/:gameId/project/worlds/:idOrKey
mcpproject_update_world

publish.dev

Create a dev content version and deployment candidate through publish gates.

FieldValue
TitlePublish Dev Build
Domainpublish
Kindcommand
Lifecycleactive
Ownerpublish
Exposureui, mcp, ai, workflow, sdk
Audit eventsPublishDev

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/publish/dev
mcpruntime_create_deployment

qa.renderer.viewport.capture

Render one immutable verified Versioning checkpoint through the real runtime and renderer, independently content-address the PNG bytes, and return exact runtime/browser/media lineage.

FieldValue
TitleProve Runtime Renderer Frame
Domainqa
Kindcommand
Lifecycleactive
Ownerqa
Exposuremcp, ai
Audit eventsRendererViewportCaptured

Surface mappings:

SurfaceMethodPathTool
mcpqa_capture_renderer_viewport

qa.run.start

Execute bounded deterministic simulation QA from an immutable verified Versioning checkpoint to verify the physics simulation converges to its expected numerical value, returning an executable numerical-oracle receipt with an independent repeat and seed-sensitivity control.

FieldValue
TitleRun Simulation QA
Domainqa
Kindcommand
Lifecycleactive
Ownersimulation
Exposuremcp, ai, workflow
Audit eventsSimulationQaRun

Surface mappings:

SurfaceMethodPathTool
mcpsimulation_run

renderer.visual_profile.apply

Apply a canonical renderer visual profile by mutating the Project Graph world environment through backend authority.

FieldValue
TitleApply Renderer Visual Profile
Domainrenderer
Kindcommand
Lifecycleactive
Ownerrenderer
Exposureui, mcp, ai, sdk
Audit eventsRendererVisualProfileApplied

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/worlds/:idOrKey/visual-profile/apply
sdkrenderer.visualProfiles.apply
mcpworld_apply_visual_profile

renderer.visual_qa.run

Retired native-AI composite. The canonical renderer pixel-capture primitive is qa.renderer.viewport.capture; this SDK-surface convenience adds profile/fallback receipt checks over it.

FieldValue
TitleRun Renderer Visual QA
Domainrenderer-qa
Kindcommand
Lifecycleactive
Ownerqa
Exposuresdk
Audit eventsRendererVisualQaRun

Surface mappings:

SurfaceMethodPathTool
sdkrenderer.visualQa.run

runtime.proof.run

Execute one author-declared input against an immutable Project Graph snapshot in an isolated real runtime actor and return typed causal transition evidence with provider and checkpoint lineage.

FieldValue
TitleRun Runtime Proof
Domainruntime-qa
Kindcommand
Lifecycleactive
Ownerruntime
Exposuremcp, ai, sdk
Audit eventsRuntimeProofRun

Surface mappings:

SurfaceMethodPathTool
mcpruntime_proof_run

spatial.asset.import

Queue and run backend-authoritative spatial asset import processing through Jobs and Capability Registry.

FieldValue
TitleImport Spatial Asset
Domainspatial-ingestion
Kindjob_start
Lifecycleactive
Ownerspatial-ingestion
Exposureui, mcp, ai, workflow, sdk, cli
Audit eventsSpatialAssetImportQueued, SpatialAssetImportProcessed

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/spatial-assets/imports
httpPOST/api/games/:gameId/spatial-assets/import-jobs/:jobId/run
mcpspatial_asset_queue_import

spatial.capture.annotate

Record semantic anchors for spatial captures through backend-validated Project Graph facets.

FieldValue
TitleAnnotate Spatial Capture
Domainspatial-ingestion
Kindcommand
Lifecycleactive
Ownerspatial-ingestion
Exposureui, mcp, ai, workflow, sdk, cli
Audit eventsSpatialCaptureAnnotationRecorded

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/spatial-assets/:assetId/annotations
mcpspatial_capture_record_annotations

spatial.capture.proxy.generate

Generate or record collision/nav/query proxy receipts for a spatial capture asset.

FieldValue
TitleGenerate Spatial Capture Proxy
Domainspatial-ingestion
Kindjob_start
Lifecycleactive
Ownerspatial-ingestion
Exposureui, mcp, ai, workflow, sdk, cli
Audit eventsSpatialCaptureProxyGenerationQueued, SpatialCaptureProxyGenerationRecorded

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/spatial-assets/:assetId/proxy-jobs
httpPOST/api/games/:gameId/spatial-assets/proxy-jobs/:jobId/run
mcpspatial_capture_queue_proxy_job

terrain.artifacts.build

Build the explicit terrain artifacts (render height tile, collision proxy, nav source mesh) from the terrain resource source, writing regenerate-gated receipts onto the facet and lifting acceptance to navigable_terrain. Backed by ProjectGraphService.buildTerrainArtifacts over the deterministic buildTerrainArtifacts builder (same source -> same artifactHash, one no-drift build for collision/nav/render). v1 runs the build inline; the durable job-queue worker is a later optimization. Build is a job; path query is runtime.

FieldValue
TitleBuild Terrain Artifacts
Domainterrain
Kindjob_start
Lifecycleactive
Ownerterrain
Exposureui, mcp, ai, sdk, cli
Audit eventsTerrainArtifactsBuildQueued, TerrainArtifactsBuilt

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/assets/:assetId/terrain/artifacts/build
sdkproject.terrain.buildArtifacts
mcpterrain_build_artifacts

terrain.patch.apply

Apply checked semantic terrain operations (sculpt/paint/road/biome/generate/cutHole/erosion/scatter) to the versioned terrain resource through the single terrain patch chokepoint (compileTerrainPatch + applyTerrainPatch), invalidating collision/nav/render artifacts for gated rebuild so collision and nav never drift from the source. Lowers into ProjectGraphService.applyTerrainPatch over the asset terrain facet via the existing updateAsset path (no parallel write path).

FieldValue
TitleApply Terrain Semantic Patch
Domainterrain
Kindcommand
Lifecycleactive
Ownerterrain
Exposureui, mcp, ai, workflow, sdk
Audit eventsTerrainPatchApplied

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/project/assets/:assetId/terrain/patches/apply
mcpproject_apply_terrain_semantic_patch
sdkproject.terrain.applySemanticPatch

terrain.resource.create

Create a versioned hybrid terrain resource (heightfield + mesh under one resource) as a Project Graph asset terrain facet. Backed by the terrain resource contract (terrain-resource-contract.v1) + the terrain patch chokepoint; the dedicated REST/MCP/AI handlers are pending (planned).

FieldValue
TitleCreate Terrain Resource
Domainterrain
Kindcommand
Lifecycleplanned
Ownerterrain
Exposureui, sdk
Audit eventsTerrainResourceCreated

Surface mappings:

No surface mappings; reachable through the exposure surfaces above.

versioning.proof.state_diff

Compare immutable pre-author and final Versioning checkpoints, reconstruct the complete canonical Project Graph transition, and evaluate exact reviewer-authored assertions.

FieldValue
TitleProve Canonical State Diff
Domainversioning
Kindcommand
Lifecycleactive
Ownerversioning
Exposuremcp, ai, sdk
Audit eventsVersioningStateDiffProofRun

Surface mappings:

SurfaceMethodPathTool
mcpversioning_state_diff_proof_run

workflow.definition.create

Hidden privileged/deferred Workflow IR definition mutation. Normal UI, MCP, AI, and SDK workflow authoring stays unavailable until a complete creator-facing projection ships.

FieldValue
TitleCreate Workflow Definition
Domainworkflow
Kindadmin
Lifecycleinternal
Ownerworkflows
Exposureadmin
Audit eventsCreateProjectWorkflow

Surface mappings:

No surface mappings; reachable through the exposure surfaces above.

workflow.run.start

Start a durable workflow run through the workflow runner.

FieldValue
TitleStart Workflow Run
Domainworkflow
Kindworkflow_step
Lifecycleactive
Ownerworkflows
Exposureui, sdk, mcp, ai
Audit eventsWorkflowRunStarted

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/workflows/:idOrKey/runs
mcpproject_start_workflow_run

Link an authorized existing workspace asset into a project and return its owner-issued project identity without supplying raw storage coordinates.

FieldValue
TitleLink Workspace Asset
Domainworkspace-assets
Kindcommand
Lifecycleactive
Ownerworkspace-assets
Exposureui, mcp, ai
Audit eventsWorkspaceAssetLinkedToGame, ProjectAssetCreated

Surface mappings:

SurfaceMethodPathTool
mcpworkspace_asset_link
httpPOST/api/workspaces/:workspaceId/assets/:assetIdOrKey/link-game

workspace.create

Create a workspace through the control-plane service.

FieldValue
TitleCreate Workspace
Domaincontrol-plane
Kindcommand
Lifecycleactive
Ownercontrol-plane
Exposureui, mcp, ai, sdk
Audit eventsCreateWorkspace

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/workspaces
mcpworkspace_create

world_build.operation_catalog.read

Return the world-build semantic operation catalog (intent operation ids, titles, lowered targets, required coordinates) that documents what a world-build document can express.

FieldValue
TitleRead World Build Operation Catalog
Domaingenerators
Kindquery
Lifecycleactive
Ownerai-platform-generators
Exposuremcp, ai
Audit eventsWorldBuildOperationCatalogRead

Surface mappings:

SurfaceMethodPathTool
mcpworld_build_get_operation_catalog

world_build.semantic_operations.apply

Apply a batch of high-level world-build semantic operations as ONE canonical transaction: compile the operations through the single world-build semantic compiler (the same validator world_build_compile_semantic_operations uses), lower them to Native Agent Runtime operations, and land them via one atomic idempotent applyTransaction (one history/undo unit). Budget-capped and plan-hash deterministic; a replay by idempotency key is a no-op. The WRITE twin of world_build_compile_semantic_operations and the primary document write path. Standard approval applies; conflict and budget overflow surface as typed rejections.

FieldValue
TitleApply World Build Semantic Operations
Domaingenerators
Kindcommand
Lifecycleactive
Ownerai-platform-generators
Exposuremcp, ai
Audit eventsWorldBuildSemanticOperationsApplied, ProjectGraphTransactionApplied

Surface mappings:

SurfaceMethodPathTool
mcpworld_build_apply_semantic_operations

world_build.semantic_operations.compile

Compile high-level world-build semantic operations through the single world-build semantic compiler and return lowered operations, receipts, and diagnostics without writing anything. The dry-run READ twin of world_build.semantic_operations.apply.

FieldValue
TitleCompile World Build Semantic Operations
Domaingenerators
Kindquery
Lifecycleactive
Ownerai-platform-generators
Exposuremcp, ai
Audit eventsWorldBuildSemanticOperationsCompiled

Surface mappings:

SurfaceMethodPathTool
mcpworld_build_compile_semantic_operations

world.author.program

Typecheck and compile ONE bounded build.ts against the generated builder SDK, compute its world-build plan, land it through the widened generator apply seam as ONE canonical transaction (one history/undo unit), observe one frame, optionally run a default playtest scenario (possess the start entity, move, interact), and return ONE receipt: plan steps, apply stages with per-owner mutation counts and wiring truth, an inline frame, a graded playtest verdict, source-mapped diagnostics back to build.ts lines, and a terminal outcome. Idempotent by (programHash, paramsHash, seed): a replay is a no-op. dry_run computes without applying. Standard approval applies.

FieldValue
TitleAuthor World From One Program
Domaingenerators
Kindcommand
Lifecycleactive
Ownerai-platform-generators
Exposuremcp, ai
Audit eventsGeneratorPlanApplied, ProjectGraphTransactionApplied

Surface mappings:

SurfaceMethodPathTool
mcpworld_author_program

world.build.from_prompt

Client ingress that routes a prompt-to-world request to the neutral authoring kernel. Not an engine mutation action; carries no owner binding.

FieldValue
TitleBuild World From Prompt
Domainworld-factory
Kindworkflow_step
Lifecycleactive
Ownerworld-factory
Exposureui, sdk
Audit eventsAiWorldBuildStarted, AiWorldBuildAccepted

Surface mappings:

No surface mappings; reachable through the exposure surfaces above.

world.build.from_spatial_asset

Create an executable Project Graph world from an imported spatial asset while enforcing proxy, anchor, and playability receipts.

FieldValue
TitleBuild World From Spatial Asset
Domainworld-factory
Kindworkflow_step
Lifecycleactive
Ownerworld-factory
Exposureui, mcp, ai, workflow, sdk
Audit eventsSpatialAssetWorldBuildStarted, SpatialAssetWorldBuildAccepted

Surface mappings:

SurfaceMethodPathTool
httpPOST/api/games/:gameId/spatial-assets/:assetId/build-world
mcpworld_build_from_spatial_asset
aibuild_world_from_spatial_asset
sdkworld.build.fromSpatialAsset

world.builder.sdk

Return the builder SDK .d.ts generated from this project's REAL catalog (built-in + project components) and its workspace asset ids: the exact type surface world_author_program typechecks build.ts against. Read-only - one authorized snapshot read plus a pure codegen, writing nothing. Lets an author working outside the editor autocomplete against the vocabulary the server will actually judge, instead of a default-catalog baseline whose asset ids match no real game.

FieldValue
TitleFetch Builder SDK Types
Domaingenerators
Kindquery
Lifecycleactive
Ownerai-platform-generators
Exposuremcp, cli, ai
Audit eventsWorldBuilderSdkRead

Surface mappings:

SurfaceMethodPathTool
mcpworld_builder_sdk

world.observe.entity_view

Look at what you built: frame up to 8 authored entities in a 3/4 fit-bounds (F-key) view and render the CURRENT head so you SEE placeholders, floating props, and muddy paint a graph digest hides. The frame rides back as an image where the render lane is wired, else a typed capture_unavailable names the missing seam. Use after scenery/prop authoring.

FieldValue
TitleObserve Entity View (The Eye)
Domainobservation
Kindquery
Lifecycleactive
Ownerai-platform-observation
Exposuremcp, ai
Audit eventsWorldObserveEntityView

Surface mappings:

SurfaceMethodPathTool
mcpworld_observe_entity_view

world.observe.frame

Capture one editor or runtime viewport frame through the existing qa renderer capture lane where a browser runtime is available, returning a bounded frame descriptor (camera, viewport, renderer, media hash, pixel diagnostics, browser health) or an honest typed unavailable envelope when no browser runtime is present.

FieldValue
TitleObserve Viewport Frame
Domainobservation
Kindquery
Lifecycleactive
Ownerai-platform-observation
Exposuremcp, ai
Audit eventsWorldObserveFrame

Surface mappings:

SurfaceMethodPathTool
mcpworld_observe_frame

world.observe.logs

Read a bounded newest-first tail of runtime and script diagnostics for one runtime room.

FieldValue
TitleObserve Runtime Logs
Domainobservation
Kindquery
Lifecycleactive
Ownerai-platform-observation
Exposuremcp, ai
Audit eventsWorldObserveLogs

Surface mappings:

SurfaceMethodPathTool
mcpworld_observe_logs

world.observe.rooms

Read a bounded roster of active runtime rooms for a game with per-room player and observer counts, status, and lifecycle timestamps.

FieldValue
TitleObserve Active Rooms
Domainobservation
Kindquery
Lifecycleactive
Ownerai-platform-observation
Exposuremcp, ai
Audit eventsWorldObserveRooms

Surface mappings:

SurfaceMethodPathTool
mcpworld_observe_rooms

world.observe.scene

Read a bounded revision-stamped digest of the authored project graph (entity and per-component-type counts, world summary, spatial bounds, named-entity summary, and an optional bounded diff against a prior revision handle).

FieldValue
TitleObserve Scene Digest
Domainobservation
Kindquery
Lifecycleactive
Ownerai-platform-observation
Exposuremcp, ai
Audit eventsWorldObserveScene

Surface mappings:

SurfaceMethodPathTool
mcpworld_observe_scene

world.playtest.scenario

Boot an isolated proof room for a world, possess an entity, execute a typed action sequence (move/look/jump/interact/press) with per-step tick budgets, and return a revision-stamped outcome (before/after scene digests, per-step applied/failed, diagnostics). Executed proof over a discardable proof room; no durable project mutation.

FieldValue
TitlePlaytest Scenario
Domainplaytest
Kindquery
Lifecycleactive
Ownerai-platform-playtest
Exposuremcp, ai
Audit eventsWorldPlaytestScenario

Surface mappings:

SurfaceMethodPathTool
mcpworld_playtest_scenario

world.sample.terrain

Sample the authored terrain surface height, normal, and slope at up to 64 (x,z) points, reusing the SAME no-drift height math the runtime draws and clamps to. Call BEFORE placing props on sculpted terrain so they rest on the surface instead of a hand-guessed y.

FieldValue
TitleSample Terrain Surface
Domainobservation
Kindquery
Lifecycleactive
Ownerai-platform-observation
Exposuremcp, ai
Audit eventsWorldSampleTerrain

Surface mappings:

SurfaceMethodPathTool
mcpworld_sample_terrain
Was this helpful?Report an issueContact support

On this page