@laplace.live/persona-sdk 0.18.0 → 1.0.0

package/dist/values/gltf-extensions.js

@@ -0,0 +1,68 @@
+// Which glTF extensions each loader honours — `loadVrm` for avatars, `loadGltf` for props and
+// sets (`renderer/vrm/loader.ts`) — so the info rows can split a file's declared list. The test
+// pins the glTF lists to three's own table and the VRM list to three-vrm.
+/** The app's wardrobe extension, read on avatars — `renderer/vrm/gltf-outfit.ts`. */
+export const LAPLACE_OUTFIT = 'LAPLACE_outfit';
+/** The app's room extension, read on props and sets — `renderer/vrm/gltf-extension.ts`. */
+export const LAPLACE_ENVIRONMENT = 'LAPLACE_environment';
+/** VRM's own — every name `VRMLoaderPlugin`'s default sub-plugins read; `VRM` is 0.x. */
+const VRM_EXTENSIONS = [
+    'VRM',
+    'VRMC_vrm',
+    'VRMC_springBone',
+    'VRMC_springBone_extended_collider',
+    'VRMC_node_constraint',
+    'VRMC_materials_mtoon',
+    'VRMC_materials_hdr_emissiveMultiplier',
+];
+/** `GLTFLoader` extensions that throw at parse without a decoder — and the app sets none. */
+export const DECODER_EXTENSIONS = [
+    'KHR_draco_mesh_compression',
+    'KHR_texture_basisu',
+    'EXT_meshopt_compression',
+    'KHR_meshopt_compression',
+];
+/** The rest of `GLTFLoader`'s own `EXTENSIONS` table, which either loader renders as authored. */
+const RENDERABLE = [
+    'KHR_binary_glTF',
+    'KHR_lights_punctual',
+    'KHR_materials_clearcoat',
+    'KHR_materials_dispersion',
+    'KHR_materials_ior',
+    'KHR_materials_sheen',
+    'KHR_materials_specular',
+    'KHR_materials_transmission',
+    'KHR_materials_iridescence',
+    'KHR_materials_anisotropy',
+    'KHR_materials_unlit',
+    'KHR_materials_volume',
+    'KHR_texture_transform',
+    'KHR_mesh_quantization',
+    'KHR_materials_emissive_strength',
+    'EXT_materials_bump',
+    'EXT_texture_webp',
+    'EXT_texture_avif',
+    'EXT_mesh_gpu_instancing',
+];
+/** Per loader; the app's own extensions ride with the loader that reads them. */
+export const SUPPORTED_EXTENSIONS = {
+    vrm: new Set([...VRM_EXTENSIONS, LAPLACE_OUTFIT, ...RENDERABLE]),
+    gltf: new Set([LAPLACE_ENVIRONMENT, ...RENDERABLE]),
+};
+/** The extensions a glTF root declares (`extensionsUsed`) or carries itself, deduped in file order. */
+export function declaredExtensions(json) {
+    const used = Array.isArray(json.extensionsUsed)
+        ? json.extensionsUsed.filter((e) => typeof e === 'string')
+        : [];
+    // Plus the root's own keys: three honours an undeclared root extension, and a VRM is detected by one.
+    const root = typeof json.extensions === 'object' && json.extensions !== null ? Object.keys(json.extensions) : [];
+    return [...new Set([...used, ...root])];
+}
+/** A file's declared extensions split by what its loader honours, each side in file order. */
+export function partitionExtensions(declared, path) {
+    const supported = [];
+    const unsupported = [];
+    for (const name of declared)
+        (SUPPORTED_EXTENSIONS[path].has(name) ? supported : unsupported).push(name);
+    return { supported, unsupported };
+}

package/dist/values/guards.d.ts

@@ -6,3 +6,5 @@ export declare function isFiniteNumber(v: unknown): v is number;
 export declare function finiteOr(v: unknown, fallback: number): number;
 /** The string when it has non-whitespace content (returned untrimmed), else null. */
 export declare function nonEmptyString(v: unknown): string | null;
+/** Same keys, same values, one level deep — for snapshots rebuilt every tick, where identity says nothing. */
+export declare function shallowEqualRecord(a: Partial<Record<string, unknown>>, b: Partial<Record<string, unknown>>): boolean;

package/dist/values/guards.js

@@ -15,3 +15,8 @@ export function finiteOr(v, fallback) {
 export function nonEmptyString(v) {
     return typeof v === 'string' && v.trim() !== '' ? v : null;
 }
+/** Same keys, same values, one level deep — for snapshots rebuilt every tick, where identity says nothing. */
+export function shallowEqualRecord(a, b) {
+    const keys = Object.keys(a);
+    return keys.length === Object.keys(b).length && keys.every(k => a[k] === b[k]);
+}

package/dist/values/hotkeys.d.ts

@@ -1,2 +1,8 @@
 /** True when the combo carries a command modifier and so may be registered globally. */
 export declare function hasCommandModifier(accelerator: string | null): boolean;
+/**
+ * True when `global` can apply: a command-modifier combo registers with the OS, and a controller
+ * combo is observed directly, so neither needs Persona focused. Classifies stored combos, which
+ * every writer canonicalizes; it does not validate one.
+ */
+export declare function canRunInBackground(accelerator: string | null): boolean;

package/dist/values/hotkeys.js

@@ -1,5 +1,6 @@
 // Hotkey rules every consumer must agree on: main decides OS registration by them, and a
 // client reading `Hotkey.global` off the wire needs the same rule to know the flag can apply.
+import { isControllerTriggerName } from "./controller.js";
 // Shift is deliberately absent: Shift+letter is how text is typed, and a global
 // registration consumes the combo system-wide (VTS can allow it because it observes).
 const COMMAND_MODIFIERS = ['Control', 'Alt', 'Super'];
@@ -9,3 +10,13 @@ export function hasCommandModifier(accelerator) {
         return false;
     return accelerator.split('+').some(t => COMMAND_MODIFIERS.includes(t));
 }
+/**
+ * True when `global` can apply: a command-modifier combo registers with the OS, and a controller
+ * combo is observed directly, so neither needs Persona focused. Classifies stored combos, which
+ * every writer canonicalizes; it does not validate one.
+ */
+export function canRunInBackground(accelerator) {
+    if (accelerator === null)
+        return false;
+    return hasCommandModifier(accelerator) || accelerator.split('+').every(isControllerTriggerName);
+}

package/dist/values/labels.d.ts

@@ -1,4 +1,6 @@
 import type { ShortcutInfo } from '../wire/types.ts';
+/** Last path segment, tolerating both `/` and `\` separators. */
+export declare function fileBasename(path: string): string;
 /**
  * Display label for a model-relative motion/expression/animation file: the
  * basename with its format extension stripped. Cubism entries carry no `Name`,

package/dist/values/labels.js

@@ -1,10 +1,14 @@
+/** Last path segment, tolerating both `/` and `\` separators. */
+export function fileBasename(path) {
+    return path.split(/[/\\]/).at(-1) ?? path;
+}
 /**
  * Display label for a model-relative motion/expression/animation file: the
  * basename with its format extension stripped. Cubism entries carry no `Name`,
  * so the basename is the only identifier there is.
  */
 export function motionLabel(file) {
-    const base = file.split(/[\\/]/).pop() ?? file;
+    const base = fileBasename(file);
     return base.replace(/\.motion3\.json$|\.exp3\.json$|\.vrma$|\.json$/i, '') || base;
 }
 // English fallbacks; localizing clients keep their own map and use these for unknown kinds.

package/dist/values/limits.d.ts

@@ -2,6 +2,8 @@ import type { AssetRef, Attach, EnvironmentLook, ModelFormat, MToonTuning, Objec
 export declare function clamp(v: number, min: number, max: number): number;
 /** Clamp to the unit interval. */
 export declare function clamp01(v: number): number;
+/** Wrap an angle into (-π, π]. */
+export declare function wrapAngle(a: number): number;
 export declare const DEFAULT_LIVE2D_PLACEMENT: ScreenPlacement;
 export declare const DEFAULT_VRM_PLACEMENT: VrmPlacement;
 /** Scene colors heal to 6-digit hex. */
@@ -109,6 +111,12 @@ export declare const PLACE_2D_SCALE_MIN = 0.01;
 export declare const PLACE_2D_SCALE_MAX = 50;
 export declare const PLACE_3D_SCALE_MIN = 0.01;
 export declare const PLACE_3D_SCALE_MAX = 100;
+/** Web object viewport bounds, CSS px per side. */
+export declare const WEB_SIZE_MIN = 16;
+export declare const WEB_SIZE_MAX = 7680;
+/** Web object paint-rate bounds, frames per second. */
+export declare const WEB_FPS_MIN = 1;
+export declare const WEB_FPS_MAX = 60;
 /** A prop is a mesh, so it only exists in the three.js scene; every other kind renders in both. */
 export declare function objectSupportsSpace(kind: ObjectContent['kind'], space: ObjectSpace): boolean;
 /** The asset an object streams from, or null for kinds that carry their source inline (web, capture). */
@@ -136,3 +144,20 @@ export declare const STORAGE_VALUE_MAX_LENGTH: number;
 export declare const STORAGE_KEYS_MAX = 256;
 /** `speech.play` URL ceiling — sized for a ~40 s WAV as a base64 `data:audio/*` payload. */
 export declare const SPEECH_URL_MAX_LENGTH = 8000000;
+/**
+ * Narrowest the panel's field column still reads at: the three-up axis fields divide the width,
+ * they never wrap. The window's own floor, and the detail column's beside a dragged outliner.
+ */
+export declare const CONTROL_MIN_WIDTH = 360;
+/** Narrowest the outliner column drags to: the scene picker and a layer row's affordances still fit. */
+export declare const OUTLINER_MIN_WIDTH = 260;
+/** Width the outliner column opens at before anyone drags it, and the one a double-click restores. */
+export declare const OUTLINER_DEFAULT_WIDTH = 288;
+/**
+ * Where the panel splits in two: below it the detail follows the outliner in one scroller, at or
+ * above it each column scrolls on its own. `OUTLINER_MIN_WIDTH + CONTROL_MIN_WIDTH` and the 1 px
+ * split must fit inside it, or no layout satisfies both floors and the group clips instead.
+ */
+export declare const TWO_COLUMN_WIDTH = 672;
+/** 3D-stage resolution multipliers offered by both performance pickers. */
+export declare const RENDER_SCALE_PRESETS: readonly [1, 0.85, 0.75, 0.66, 0.5];

package/dist/values/limits.js

@@ -6,6 +6,16 @@ export function clamp(v, min, max) {
 export function clamp01(v) {
     return v < 0 ? 0 : v > 1 ? 1 : v;
 }
+/** Wrap an angle into (-π, π]. */
+export function wrapAngle(a) {
+    const TAU = Math.PI * 2;
+    let r = a % TAU;
+    if (r > Math.PI)
+        r -= TAU;
+    if (r <= -Math.PI)
+        r += TAU;
+    return r;
+}
 export const DEFAULT_LIVE2D_PLACEMENT = { x: 0, y: 0, scale: 1, rotation: 0 };
 export const DEFAULT_VRM_PLACEMENT = { x: 0, y: 0, z: 0, rotX: 0, rotY: 0, rotZ: 0, scale: 1 };
 /** Scene colors heal to 6-digit hex. */
@@ -193,6 +203,12 @@ export const PLACE_2D_SCALE_MIN = 0.01;
 export const PLACE_2D_SCALE_MAX = 50;
 export const PLACE_3D_SCALE_MIN = 0.01;
 export const PLACE_3D_SCALE_MAX = 100;
+/** Web object viewport bounds, CSS px per side. */
+export const WEB_SIZE_MIN = 16;
+export const WEB_SIZE_MAX = 7680;
+/** Web object paint-rate bounds, frames per second. */
+export const WEB_FPS_MIN = 1;
+export const WEB_FPS_MAX = 60;
 /** A prop is a mesh, so it only exists in the three.js scene; every other kind renders in both. */
 export function objectSupportsSpace(kind, space) {
     return kind === 'prop' ? space === '3d' : true;
@@ -233,3 +249,20 @@ export const STORAGE_VALUE_MAX_LENGTH = 64 * 1024;
 export const STORAGE_KEYS_MAX = 256;
 /** `speech.play` URL ceiling — sized for a ~40 s WAV as a base64 `data:audio/*` payload. */
 export const SPEECH_URL_MAX_LENGTH = 8_000_000;
+/**
+ * Narrowest the panel's field column still reads at: the three-up axis fields divide the width,
+ * they never wrap. The window's own floor, and the detail column's beside a dragged outliner.
+ */
+export const CONTROL_MIN_WIDTH = 360;
+/** Narrowest the outliner column drags to: the scene picker and a layer row's affordances still fit. */
+export const OUTLINER_MIN_WIDTH = 260;
+/** Width the outliner column opens at before anyone drags it, and the one a double-click restores. */
+export const OUTLINER_DEFAULT_WIDTH = 288;
+/**
+ * Where the panel splits in two: below it the detail follows the outliner in one scroller, at or
+ * above it each column scrolls on its own. `OUTLINER_MIN_WIDTH + CONTROL_MIN_WIDTH` and the 1 px
+ * split must fit inside it, or no layout satisfies both floors and the group clips instead.
+ */
+export const TWO_COLUMN_WIDTH = 672;
+/** 3D-stage resolution multipliers offered by both performance pickers. */
+export const RENDER_SCALE_PRESETS = [1, 0.85, 0.75, 0.66, 0.5];

package/dist/values/locale.d.ts

@@ -3,6 +3,8 @@ export declare const LOCALES: readonly ["en", "ja", "zh-CN", "zh-TW"];
 export type Locale = (typeof LOCALES)[number];
 /** `ui.language` setting: an explicit locale, or follow the OS language. */
 export type LanguageSetting = 'system' | Locale;
+/** `ui.theme` setting: an explicit appearance, or follow the OS. */
+export type ThemeSetting = 'system' | 'light' | 'dark';
 /** Native-language display names for the language picker (deliberately untranslated). */
 export declare const LOCALE_LABELS: Record<Locale, string>;
 /** Best supported locale for a BCP 47-ish tag: exact match first, then fuzzy per language. */

package/dist/values/model-info.d.ts

@@ -0,0 +1,66 @@
+import type { ContentOrigin } from '../wire/types.ts';
+/** Which VRM specification the file declares. */
+export type VrmSpec = '0.x' | '1.0';
+/** Everything the panel reports about a Live2D model on stage. */
+export interface Live2DModelInfo {
+    format: 'live2d';
+    name: string;
+    origin: ContentOrigin;
+    file: string;
+    /** Config sidecars found next to the entry file (`*.vtube.json`, `*.persona.json`). */
+    configFiles: string[];
+    canvas: {
+        width: number;
+        height: number;
+    };
+    /** `csmMocVersion` of the model's own moc3, or null when the header couldn't be read. */
+    mocVersion: number | null;
+    /** Highest `csmMocVersion` the vendored Core can load (`csmGetLatestMocVersion()`). */
+    coreMocVersion: number;
+    /** Packed uint32 from `csmGetVersion()`; 0 when the Core global is missing. */
+    coreVersion: number;
+    params: number;
+    parts: number;
+    /** Pixel size of each loaded texture atlas. */
+    textureSizes: {
+        width: number;
+        height: number;
+    }[];
+    motionGroups: number;
+    motionTotal: number;
+    expressions: number;
+    /** Param ids the auto eye-blink drives (the engine falls back to standard params when undeclared). */
+    eyeBlinkParams: string[];
+    /** Param ids of the model's `LipSync` group; empty means lip sync cannot move the mouth. */
+    lipSyncParams: string[];
+    /** How many distinct raw ARKit channels the rig's bindings read; 52 is full perfect sync. */
+    arkitInputs: number;
+    /** Optional subsystems that loaded, e.g. `['physics', 'pose']`. */
+    extras: string[];
+    /** Wall-clock ms the stage spent loading the model. */
+    loadMs: number;
+}
+/** What the panel reports about a VRM on stage. */
+export interface VrmModelInfo {
+    format: 'vrm';
+    name: string;
+    origin: ContentOrigin;
+    file: string;
+    spec: VrmSpec;
+    specVersion: string;
+    /** Every glTF extension the file declares, in file order; the rows split them by stage support. */
+    extensions: string[];
+    humanBones: number;
+    springGroups: number;
+    expressions: number;
+    /** How many of the 52 ARKit shapes the expressions cover; 52 enables perfect-sync tracking. */
+    arkitExpressions: number;
+    authors: string[];
+    licenseUrl: string | null;
+    /** VRM 1.0 `creditNotation === 'required'`; always false for 0.x. */
+    creditRequired: boolean;
+    /** Wall-clock ms the stage spent loading the model. */
+    loadMs: number;
+}
+/** Everything the panel reports about the model currently on stage. */
+export type ModelInfo = Live2DModelInfo | VrmModelInfo;

package/dist/values/model-info.js

@@ -0,0 +1 @@
+export {};

package/dist/values/stage-info.d.ts

@@ -0,0 +1,27 @@
+/** Decoded image/video pixels, or a web object's configured viewport pixels, before placement. */
+export interface ObjectMediaSize {
+    width: number;
+    height: number;
+}
+/** One light baked into a prop asset, as the panel lists it. `index` is the override key. */
+export interface BakedLightInfo {
+    index: number;
+    /** Node name from the asset; may be empty. */
+    name: string;
+    type: 'point' | 'spot' | 'directional';
+    /** The asset's own intensity after normalization, in scene-slider units. */
+    defaultIntensity: number;
+}
+/** Loaded asset metadata; absent dimensions/extensions mean the asset has not reported them yet. */
+export interface SceneAssetInfo {
+    assetId: string | null;
+    lights: BakedLightInfo[];
+    extensions: string[] | null;
+    mediaSize: ObjectMediaSize | null;
+}
+/** Metadata for the active scene, tagged so a response from a previous scene can be discarded. */
+export interface SceneInspection {
+    sceneId: string;
+    environment: Omit<SceneAssetInfo, 'mediaSize'>;
+    objects: Record<string, SceneAssetInfo>;
+}

package/dist/values/stage-info.js

@@ -0,0 +1 @@
+export {};

package/dist/values/vrm-bindings.d.ts

@@ -0,0 +1,14 @@
+/** Where a VRM binding target lands; expressions are the model's own, the rest are pose offsets. */
+export type VrmBindingGroup = 'head' | 'body' | 'gaze' | 'expressions';
+export interface VrmPoseTarget {
+    id: string;
+    group: Exclude<VrmBindingGroup, 'expressions'>;
+    /** Symmetric range in degrees. */
+    range: number;
+}
+/** The generated VRM binding targets, in degrees; each is an offset layered over the current pose. */
+export declare const VRM_POSE_TARGETS: readonly VrmPoseTarget[];
+/** The binding target id for a VRM expression, keeping the model author's spelling. */
+export declare function vrmExpressionTarget(name: string): string;
+/** The expression behind a VRM binding target id; null for a pose target. */
+export declare function vrmExpressionName(id: string): string | null;

package/dist/values/vrm-bindings.js

@@ -0,0 +1,20 @@
+/** The generated VRM binding targets, in degrees; each is an offset layered over the current pose. */
+export const VRM_POSE_TARGETS = [
+    { id: 'HeadYaw', group: 'head', range: 30 },
+    { id: 'HeadPitch', group: 'head', range: 30 },
+    { id: 'HeadRoll', group: 'head', range: 30 },
+    { id: 'BodyYaw', group: 'body', range: 15 },
+    { id: 'BodyPitch', group: 'body', range: 15 },
+    { id: 'BodyRoll', group: 'body', range: 15 },
+    { id: 'GazeYaw', group: 'gaze', range: 90 },
+    { id: 'GazePitch', group: 'gaze', range: 90 },
+];
+const VRM_EXPRESSION_PREFIX = 'Expression:';
+/** The binding target id for a VRM expression, keeping the model author's spelling. */
+export function vrmExpressionTarget(name) {
+    return `${VRM_EXPRESSION_PREFIX}${name}`;
+}
+/** The expression behind a VRM binding target id; null for a pose target. */
+export function vrmExpressionName(id) {
+    return id.startsWith(VRM_EXPRESSION_PREFIX) ? id.slice(VRM_EXPRESSION_PREFIX.length) : null;
+}

package/dist/wire/methods.d.ts

@@ -1,5 +1,8 @@
+import type { Binding, BindingEditorData } from '../values/bindings.ts';
+import type { ControllerMovementConfig, ControllerState } from '../values/controller.ts';
+import type { SceneInspection } from '../values/stage-info.ts';
 import type { EventName } from './events.ts';
-import type { AnchorOption, AppCapability, AssetKind, AssetRef, Attach, AttachHeadAngle, Expression, ExpressionPersistence, HotkeyConfig, HotkeyState, InjectEntry, InjectTarget, InstanceRuntime, JsonValue, ModelInfo, ModelRef, MotionGroup, MToonTuning, ObjectContent, ObjectLightOverride, ObjectSpace, Place2D, Place3D, PlayingMotion, PoseSourceId, PoseStatus, Scene, SceneItem, ScenePatch, SceneState, ScreenPlacement, Settings, SettingsPatch, ShortcutInfo, TrackingSourceConfig, TrackingSourceId, TrackingSourceKind, TrackingStatus, VrmPlacement } from './types.ts';
+import type { AnchorOption, AppCapability, AssetKind, AssetRef, Attach, AttachHeadAngle, BindingInput, Expression, ExpressionPersistence, HotkeyConfig, HotkeyState, InjectEntry, InjectTarget, InstanceRuntime, JsonValue, ModelInfo, ModelRef, MotionGroup, MToonTuning, ObjectContent, ObjectLightOverride, ObjectSpace, Place2D, Place3D, PlayingMotion, PoseSourceId, PoseStatus, Scene, SceneItem, ScenePatch, SceneState, ScreenPlacement, Settings, SettingsPatch, ShortcutInfo, TrackingSourceConfig, TrackingSourceId, TrackingSourceKind, TrackingStatus, VrmPlacement } from './types.ts';
 /** Marker for methods that take no parameters; the client lets you omit the argument. */
 export type EmptyRequest = Record<never, never>;
 /** Marker for methods whose success response carries no data. */
@@ -80,6 +83,13 @@ export interface InstanceSetTrackingSourcesRequest {
     poseSourceId?: string | null;
 }
 export type InstanceSetTrackingSourcesResponse = EmptyResponse;
+export interface InstanceSetControllerMovementRequest {
+    instanceId: string;
+    movement: Partial<ControllerMovementConfig>;
+}
+export interface InstanceSetControllerMovementResponse {
+    movement: ControllerMovementConfig;
+}
 export interface InstanceReorderRequest {
     /** Full z-order within the scene; ids not listed keep their relative order at the end. */
     orderedInstanceIds: string[];
@@ -315,7 +325,7 @@ export type PoseSetEnabledResponse = EmptyResponse;
 export interface PoseSetSourceRequest {
     source: PoseSourceId;
 }
-/** Switching protocol resets the port to that source's default; the response reports it. */
+/** Switching protocol resets the port to that source's next free default; the response reports it. */
 export interface PoseSetSourceResponse {
     port: number;
 }
@@ -328,7 +338,10 @@ export interface TrackingAddSourceRequest {
     name?: string;
     /** Face kinds: pin to a device IP. */
     phoneIp?: string | null;
-    /** vmc: the UDP port to listen on; defaults to the next free VMC port. */
+    /**
+     * vmc / mocopi: the UDP port to listen on, default the next free port from 39539 / 12351.
+     * ifacialmocap: the receive port, default 49983 (set the phone's Send Port to match).
+     */
     port?: number;
 }
 export interface TrackingAddSourceResponse {
@@ -440,11 +453,140 @@ export interface ParamReleaseRequest {
     targets?: InjectTarget[];
 }
 export type ParamReleaseResponse = EmptyResponse;
+export type ControllerStateRequest = EmptyRequest;
+export type ControllerStateResponse = ControllerState;
+export interface ControllerRenameRequest {
+    slot: number;
+    name: string;
+}
+export type ControllerRenameResponse = EmptyResponse;
+export interface ControllerSetDeadZoneRequest {
+    slot: number;
+    /** Radial stick dead zone, 0..0.5. */
+    deadZone: number;
+}
+export type ControllerSetDeadZoneResponse = EmptyResponse;
+export interface ControllerRemoveRequest {
+    slot: number;
+}
+export type ControllerRemoveResponse = EmptyResponse;
+export interface ControllerAssignRequest {
+    slot: number | null;
+}
+export type ControllerAssignResponse = EmptyResponse;
+export interface BindingTarget {
+    instanceId: string;
+    modelId: string;
+}
+export type BindingGetRequest = BindingTarget;
+export type BindingReleaseRequest = BindingTarget;
+export type BindingReleaseResponse = EmptyResponse;
+export interface BindingGetResponse {
+    data: BindingEditorData | null;
+}
+export interface BindingPreviewRequest extends BindingTarget {
+    connections: Binding[];
+}
+export type BindingPreviewResponse = EmptyResponse;
+export type BindingSetRequest = BindingPreviewRequest;
+export interface BindingSetResponse {
+    saved: boolean;
+}
+export type BindingInputsRequest = BindingTarget;
+export interface BindingInputsResponse {
+    inputs: Partial<Record<BindingInput, number>>;
+}
+export interface BindingOverrideRequest extends BindingTarget {
+    input: BindingInput;
+    value: number | null;
+}
+export type BindingOverrideResponse = EmptyResponse;
+export interface InstanceSetBreathRequest {
+    instanceId: string;
+    breath?: boolean;
+    breathDepth?: number;
+}
+export type InstanceSetBreathResponse = EmptyResponse;
+/** A small image preview for a registered id; never a path or arbitrary file request. */
+export interface RegistryThumbnailRequest {
+    kind: 'model' | 'asset';
+    id: string;
+}
+export interface RegistryThumbnailResponse {
+    dataUrl: string | null;
+}
+export type SceneInspectRequest = EmptyRequest;
+export type SceneInspectResponse = SceneInspection;
+export interface MotionPlayAssetRequest {
+    instanceId: string;
+    assetId: string;
+}
+export type MotionPlayAssetResponse = EmptyResponse;
 /**
  * The full request surface: method → request/response. Model-scoped methods take
  * an optional `instanceId` defaulting to the scene's primary model instance.
  */
 export interface MethodMap {
+    'registry.thumbnail': {
+        request: RegistryThumbnailRequest;
+        response: RegistryThumbnailResponse;
+    };
+    'scene.inspect': {
+        request: SceneInspectRequest;
+        response: SceneInspectResponse;
+    };
+    'motion.playAsset': {
+        request: MotionPlayAssetRequest;
+        response: MotionPlayAssetResponse;
+    };
+    'binding.release': {
+        request: BindingReleaseRequest;
+        response: BindingReleaseResponse;
+    };
+    'binding.get': {
+        request: BindingGetRequest;
+        response: BindingGetResponse;
+    };
+    'binding.preview': {
+        request: BindingPreviewRequest;
+        response: BindingPreviewResponse;
+    };
+    'binding.set': {
+        request: BindingSetRequest;
+        response: BindingSetResponse;
+    };
+    'binding.inputs': {
+        request: BindingInputsRequest;
+        response: BindingInputsResponse;
+    };
+    'binding.override': {
+        request: BindingOverrideRequest;
+        response: BindingOverrideResponse;
+    };
+    'instance.setBreath': {
+        request: InstanceSetBreathRequest;
+        response: InstanceSetBreathResponse;
+    };
+    'controller.state': {
+        request: ControllerStateRequest;
+        response: ControllerStateResponse;
+    };
+    'controller.rename': {
+        request: ControllerRenameRequest;
+        response: ControllerRenameResponse;
+    };
+    'controller.setDeadZone': {
+        request: ControllerSetDeadZoneRequest;
+        response: ControllerSetDeadZoneResponse;
+    };
+    'controller.remove': {
+        request: ControllerRemoveRequest;
+        response: ControllerRemoveResponse;
+    };
+    'controller.assign': {
+        request: ControllerAssignRequest;
+        response: ControllerAssignResponse;
+    };
     'scene.list': {
         request: SceneListRequest;
         response: SceneListResponse;
@@ -513,6 +655,10 @@ export interface MethodMap {
         request: InstanceSetTrackingSourcesRequest;
         response: InstanceSetTrackingSourcesResponse;
     };
+    'instance.setControllerMovement': {
+        request: InstanceSetControllerMovementRequest;
+        response: InstanceSetControllerMovementResponse;
+    };
     'instance.reorder': {
         request: InstanceReorderRequest;
         response: InstanceReorderResponse;
@@ -696,12 +842,12 @@ export interface MethodMap {
         request: PoseSetEnabledRequest;
         response: PoseSetEnabledResponse;
     };
-    /** Legacy: operates on the first vmc source. Prefer the tracking.* source CRUD. */
+    /** Legacy: operates on the first body source. Prefer the tracking.* source CRUD. */
     'pose.setSource': {
         request: PoseSetSourceRequest;
         response: PoseSetSourceResponse;
     };
-    /** Legacy: sets the first vmc source's port. */
+    /** Legacy: sets the first body source's port. */
     'pose.setPort': {
         request: PoseSetPortRequest;
         response: PoseSetPortResponse;