Grab System Test

Run 5 test suites covering distance grab, one-hand grab, two-hand grab, system/component registration, and stability.

All tool calls go through npx iwsdk from the example workspace. The helper below keeps the existing MCP-style tool names, but it resolves them through iwsdk mcp inspect and then executes the matching CLI command directly.

Configuration:

EXAMPLE_DIR: /Users/felixz/Projects/immersive-web-sdk/examples/grab
ROOT: /Users/felixz/Projects/immersive-web-sdk

SHORTHAND: Throughout this document, MCPCALL means this shell function:

MCPCALL() {
  local tool=""
  local args=""
  local timeout=""
  while [ "$#" -gt 0 ]; do
    case "$1" in
      --tool) tool="$2"; shift 2 ;;
      --args) args="$2"; shift 2 ;;
      --timeout) timeout="$2"; shift 2 ;;
      *) echo "Unknown argument: $1" >&2; return 1 ;;
    esac
  done

  node --input-type=module - "$tool" "${args:-}" "${timeout:-}" <<'EOF'
import { spawnSync } from 'node:child_process';

const [toolName, rawArgs, timeout] = process.argv.slice(2);
const inspect = spawnSync('npx', ['iwsdk', 'mcp', 'inspect'], {
  cwd: process.cwd(),
  encoding: 'utf8',
});
if (inspect.status !== 0) {
  if (inspect.stderr) process.stderr.write(inspect.stderr);
  process.exit(inspect.status ?? 1);
}

const parsed = JSON.parse(inspect.stdout);
const tool = parsed.data.tools.find((entry) => entry.mcpName === toolName);
if (!tool) {
  console.error(`Unknown tool: ${toolName}`);
  process.exit(1);
}

const cliArgs = ['iwsdk', ...tool.cliPath.split(' ')];
if (rawArgs) cliArgs.push('--input-json', rawArgs);
if (timeout) cliArgs.push('--timeout', timeout);

const result = spawnSync('npx', cliArgs, {
  cwd: process.cwd(),
  encoding: 'utf8',
});
if (result.stdout) process.stdout.write(result.stdout);
if (result.stderr) process.stderr.write(result.stderr);
process.exit(result.status ?? 1);
EOF
}

Grab System Test

Run 5 test suites covering distance grab, one-hand grab, two-hand grab, system/component registration, and stability.

Configuration:

EXAMPLE_DIR: /Users/felixz/Projects/immersive-web-sdk/examples/grab

ROOT: /Users/felixz/Projects/immersive-web-sdk

SHORTHAND: Throughout this document, MCPCALL means this shell function:

MCPCALL() { local tool="" local args="" local timeout="" while [ "$#" -gt 0 ]; do case "$1" in --tool) tool="$2"; shift 2 ;; --args) args="$2"; shift 2 ;; --timeout) timeout="$2"; shift 2 ;; *) echo "Unknown argument: $1" >&2; return 1 ;; esac done node --input-type=module - "$tool" "${args:-}" "${timeout:-}" <<'EOF' import { spawnSync } from 'node:child_process'; const [toolName, rawArgs, timeout] = process.argv.slice(2); const inspect = spawnSync('npx', ['iwsdk', 'mcp', 'inspect'], { cwd: process.cwd(), encoding: 'utf8', }); if (inspect.status !== 0) { if (inspect.stderr) process.stderr.write(inspect.stderr); process.exit(inspect.status ?? 1); } const parsed = JSON.parse(inspect.stdout); const tool = parsed.data.tools.find((entry) => entry.mcpName === toolName); if (!tool) { console.error(`Unknown tool: ${toolName}`); process.exit(1); } const cliArgs = ['iwsdk', ...tool.cliPath.split(' ')]; if (rawArgs) cliArgs.push('--input-json', rawArgs); if (timeout) cliArgs.push('--timeout', timeout); const result = spawnSync('npx', cliArgs, { cwd: process.cwd(), encoding: 'utf8', }); if (result.stdout) process.stdout.write(result.stdout); if (result.stderr) process.stderr.write(result.stderr); process.exit(result.status ?? 1); EOF }

Component	Pointer Type	Activation
`DistanceGrabbable`	Ray (trigger)	`xr_set_select_value`
`OneHandGrabbable`	Grip sphere (squeeze)	`xr_set_gamepad_state` button 1
`TwoHandsGrabbable`	Grip sphere (squeeze)	`xr_set_gamepad_state` button 1, both hands

Test Grab

Grab System Test

Test Grab

Grab System Test

Step 1: Install Dependencies

Step 2: Start Dev Server

Step 3: Verify Connectivity

Step 4: Run Test Suites

Pre-test Setup

Entity Discovery

Component Reference

Suite 1: Distance Grab (Ray + Trigger)

Suite 2: One-Hand Grab (Squeeze)

Suite 3: Two-Hand Grab (Both Controllers Squeeze)

Suite 4: System & Component Registration

Suite 5: Stability

Step 5: Cleanup & Results

Recovery

Known Issues & Workarounds

No Hovered/Pressed for near-field grabs

Handle component is permanent

Trigger vs Squeeze confusion

Grab sphere radius is 0.07m

Entity indices change on reload

Automation Audit Ops

Github Qa Labels

Jupyter Notebook

Tidb Integrationtest Recorder

Quality Nonconformance

Hugging Face Trackio