@laplace.live/persona-sdk 1.14.0 → 1.15.0

package/dist/wire/events.d.ts

@@ -31,10 +31,12 @@ export interface EventMap {
         active: string[];
         weights?: Record<string, number>;
     };
+    /** `oneShot`: the motion outranks the idle, so `motion.stop` would end it; hosts with `motion-stop` send it. */
     'motion.started': {
         instanceId: string;
         group: string;
         index: number;
+        oneShot?: boolean;
     };
     'motion.ended': {
         instanceId: string;

package/dist/wire/methods.d.ts

@@ -292,6 +292,16 @@ export interface MotionPlayingRequest {
 }
 export interface MotionPlayingResponse {
     playing: PlayingMotion | null;
+    /** `playing` outranks the idle — what `motion.stop` ends. Absent on hosts without `motion-stop`. */
+    oneShot?: boolean;
+}
+/** Fade the running motion out and let the idle resume; the idle itself is left alone. */
+export interface MotionStopRequest {
+    instanceId?: string;
+}
+export interface MotionStopResponse {
+    /** A motion above the idle was playing and is now fading out. */
+    stopped: boolean;
 }
 /** Play a clip with lip-sync. One utterance per model: a new play supersedes the current one. */
 export interface SpeechPlayRequest {
@@ -884,6 +894,11 @@ export interface MethodMap {
         request: MotionPlayingRequest;
         response: MotionPlayingResponse;
     };
+    /** Needs the `motion-stop` app capability. */
+    'motion.stop': {
+        request: MotionStopRequest;
+        response: MotionStopResponse;
+    };
     /**
      * Lip-synced audio on models advertising the `speech` capability. The response means
      * playback started (else `invalid-state`); `speech.started`/`speech.ended` bracket it.

package/dist/wire/types.d.ts

@@ -1005,7 +1005,7 @@ export interface ScenePatch {
  * App-level features a client gates on (never version-sniff): `hello` and
  * `app.info` report them — the per-app mirror of {@link InstanceRuntime.capabilities}.
  */
-export declare const APP_CAPABILITIES: readonly ["storage", "speech", "automations", "controllers", "model-editing", "asset-inspection", "layer-effects", "scene-transitions", "area-lights", "spot-lights", "camera-follow-lights", "shadow-filters", "environment-map-model", "spawn", "tracking-lost"];
+export declare const APP_CAPABILITIES: readonly ["storage", "speech", "automations", "controllers", "model-editing", "asset-inspection", "layer-effects", "scene-transitions", "area-lights", "spot-lights", "camera-follow-lights", "shadow-filters", "environment-map-model", "spawn", "tracking-lost", "motion-stop"];
 export type AppCapability = (typeof APP_CAPABILITIES)[number];
 export declare function isAppCapability(v: unknown): v is AppCapability;
 /** What a loaded model instance can do; absent capabilities answer `unsupported-for-format`. */

package/dist/wire/types.js

@@ -49,6 +49,8 @@ export const APP_CAPABILITIES = [
     'spawn',
     /** `instance.setIdle` takes `trackingLostBehavior`, `trackingLostMotion` and `trackingLostDelay`. */
     'tracking-lost',
+    /** `motion.stop`; `motion.playing` and `motion.started` carry `oneShot`. */
+    'motion-stop',
 ];
 export function isAppCapability(v) {
     return isOneOf(v, APP_CAPABILITIES);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laplace.live/persona-sdk",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "TypeScript SDK and wire schema for the LAPLACE Persona plugin API",
   "license": "MIT",
   "type": "module",