iwsdk-runtime tools. Ask the agent to inspect each tool’s installed schema before calling it.npx iwsdk dev status
| Status | Meaning |
|---|---|
Development server is reachable | The application server can respond. Browser tools might still be unavailable. |
state.browserCommandReady is true | The registered session can accept browser commands. |
state.session.browser.commandReady is true | The managed browser reports command readiness. |
--no-open has no registered managed browser, so every iwsdk-runtime tool call remains unavailable. iwsdk mcp inspect can still display schemas.iwsdk mcp stdio, and they do not bind themselves to temporary dev-server ports. Common tools have CLI equivalents that you can run from a terminal, or use when your AI tool has not loaded the MCP tool schemas yet:xr_get_session_status <-> iwsdk xr status xr_accept_session <-> iwsdk xr enter xr_run_sequence <-> iwsdk xr run-sequence xr_list_targets <-> iwsdk xr list-targets browser_screenshot <-> iwsdk browser screenshot browser_snapshot <-> iwsdk browser snapshot browser_interact <-> iwsdk browser interact browser_profile <-> iwsdk browser profile browser_get_console_logs <-> iwsdk browser logs browser_reload_page <-> iwsdk browser reload browser_set_muted <-> iwsdk browser set-muted --muted <true|false> scene_render_file <-> iwsdk scene render-file scene_flatten_file <-> iwsdk scene flatten scene_get_state <-> iwsdk scene state ecs_diff <-> iwsdk ecs diff
npx @iwsdk/cli xr status.public/scenes/ as the authoring surface. The current iwsdk.scene.v1 document supports group, asset, instance, and pattern node content. Refer to project-manifest asset identifiers instead of embedding ad hoc geometry or material objects in the scene file.scene_get_capabilities({full: true}) to read the current scene contract.scene_render_file for every changed module. Fix all returned diagnostics.scene_render_file for the composed root. This validates the resolved composition without replacing the active Editor document.scene_flatten_file once to write a final import-free scene to the path selected by iwsdk.config.json.scene_open with the flattened path. Do not pass an import-bearing composition to scene_open.scene_get_state and confirm that diagnostics are empty and the Editor is clean and conflict-free. Record each hash by name; source-document, composed-document, and runtime hashes represent different projections and need not match.scene_set_camera, then capture Editor evidence with scene_screenshot.browser_screenshot and browser_get_console_logs.{
"path": "public/scenes/main.composition.iwsdk.scene.json",
"outputPath": "public/scenes/main.iwsdk.scene.json",
"overwrite": true
}
iwsdk.config.json names ./public/scenes/main.iwsdk.scene.json as its scene. If you choose another output, update the manifest and restart the session before runtime verification. A successful flatten writes only after confirming that its sourceRuntimeHash and outputRuntimeHash match. scene_render_file returns hashes, dependencies, render metadata, and a local screenshotPath for a valid file. An invalid render returns diagnostics without a screenshot.overwrite replaces any edits made to the flat file since the last flatten.scene_get_state to identify the active file, selection, diagnostics, and current hashes.scene_select({nodeIds: [...]}) to replace the selection. The tool does not accept a selection mode.scene_set_preview_visibility for temporary context, solo, ghost, hide, show, lock, or saved-arrangement views.scene_set_camera to choose a named view, step an orbit, or provide an explicit camera.scene_screenshot with captureMode: "render" for a clean scene image or captureMode: "editor" to include selection and editing overlays. Read structured validation, dirty, conflict, and runtime-readiness diagnostics from scene_get_state, not from screenshot pixels.browser_get_console_logs and record the initial errors.browser_reload_page after changing code or runtime-loaded assets.browser_snapshot, then call browser_interact with the returned refs or canvas-relative coordinates, or reproduce the behavior through XR or ECS tools.browser_screenshot and then read the console logs again.browser_profile using action: "start" and action: "stop". Use interaction or rendering mode for summarized host-browser diagnostics, and trace mode when you need a Playwright trace artifact. These profiles are uncalibrated. Do not present them as target-device measurements.browser_screenshot always captures the application runtime. It switches the managed workspace from Editor to Runtime when necessary and does not accept a target argument.xr_get_session_status.xr_accept_session if a session is offered but not active.xr_set_input_mode with controller or hand.xr_set_connected with connected: true for each emulated input device that the interaction requires.scene_get_runtime_hierarchy to locate the live object.scene_get_object_transform with its runtime UUID or native scene node ID.xr_look_at for a connected controller or hand.xr_select for a complete press and release, or use xr_set_select_value for a held interaction.browser_screenshot and inspect console logs.xr_get_session_status, and call xr_accept_session when needed.xr_set_input_mode with mode: "hand".xr_list_targets.xr_run_sequence with dryRun: true, then run the same steps without dryRun.Pressed or Grabbed tags, ui_inspect text, or transforms.press, not a pinch. To pick something up, target it with pinch: {"value": 1, "at": "arrival"}, and let go with pinch: 0. While the hand holds something, a step position is where the object’s base goes. Target names come from xr_list_targets. These targets come from the poke and grab examples:{
"device": "hand-right",
"steps": [
{ "label": "press", "target": "counter-button", "press": {} },
{
"label": "grab",
"target": "Map Pin 1",
"approach": { "distance": 0.06 },
"pinch": { "value": 1, "at": "arrival" }
},
{
"label": "carry",
"position": { "x": 0.3, "y": 1.0, "z": -1.3 },
"depart": { "distance": 0.08 }
},
{ "label": "release", "pinch": 0, "duration": 0.15 }
]
}
presses field gives each press’s contact time. A UIKit click needs the fingertip to leave again within 800 ms. Slow headless frames can stretch a press past that, so press again when contactMs is 800 or more.OneHandGrabbable or TwoHandsGrabbable and grabbing.useHandPinchForGrab, which is on by default, so a hand’s pinch grabs instead of a controller’s squeeze. See MCP tools reference for target resolution and timing details.scene_get_render_stats after the runtime bridge is ready. It reports calls, triangles, points, lines, geometries, textures, programs, meshCount, materialCount, shadowCasters, worldBounds, framingBounds, environment, and scene asset, environment, light, and material summaries. It does not return the Editor-only objectCount, nodeCount, geometryCount, visibleNodeIds, or frameTimeSamplesMs fields.available: false when the measurement bridge is not installed. Treat that as missing runtime evidence, not as zero work.ecs_list_systems and ecs_list_components to discover the current runtime contract.ecs_find_entities, then ecs_query_entity for a focused entity.ecs_pause.ecs_snapshot.ecs_step to advance a controlled number of fixed-timestep frames, or use ecs_set_component after checking the field schema and current value.ecs_diff.ecs_resume, even when the investigation finds no defect.ui_list_assets to discover the project’s UIKitML assets.ui_render_preview schema.ui_render_preview for the selected asset and review the returned preview.ecs_find_entities with namePattern set to the panel name.ui_inspect with the panel’s entityIndex to list stable element IDs.ui_inspect again with the same entityIndex and a selector such as #save-button.ui_inspect when you validate code-driven runtime changes.