@ateam-ai-mobile/plugin-runtime 0.1.11 → 0.1.13

package/dist/index.d.mts

@@ -485,6 +485,16 @@ interface VisualCaptureOptions {
     signal?: AbortSignal;
     timeoutMs?: number;
 }
+interface VisualStartOptions extends StartOptions<VisualIntent> {
+    /**
+     * Which camera: 'back' (the default) or 'front', the selfie camera — its
+     * frames are mirrored like the view the user sees, so a box's left is the
+     * screen's left. A binary without the front camera REJECTS 'front' rather
+     * than reading the back camera; `camera.facing` in the snapshot says which
+     * one is actually running.
+     */
+    facing?: 'front' | 'back';
+}
 interface VisualDomain {
     /**
      * Cached read. Does NOT open the camera and does NOT take a picture.
@@ -497,7 +507,7 @@ interface VisualDomain {
      */
     getSnapshot(): Promise<VisualSnapshot>;
     /** Maintain visual state according to this intent. Not "open the camera". */
-    start(options: StartOptions<VisualIntent>): Promise<StateSession>;
+    start(options: VisualStartOptions): Promise<StateSession>;
     /**
      * An intentional, one-shot, high-quality-ish acquisition. THROWS
      * DeviceBridgeError on failure — it is an operation, not a read.
@@ -1002,11 +1012,12 @@ type deviceState_VisualFrameQuality = VisualFrameQuality;
 type deviceState_VisualFrameRef = VisualFrameRef;
 type deviceState_VisualIntent = VisualIntent;
 type deviceState_VisualSnapshot = VisualSnapshot;
+type deviceState_VisualStartOptions = VisualStartOptions;
 declare const deviceState_explainCapability: typeof explainCapability;
 declare const deviceState_isActionable: typeof isActionable;
 declare const deviceState_neverObserved: typeof neverObserved;
 declare namespace deviceState {
-  export { type deviceState_ActivityDomain as ActivityDomain, type deviceState_ActivityIntent as ActivityIntent, type deviceState_ActivitySnapshot as ActivitySnapshot, type deviceState_AssertConforming as AssertConforming, type deviceState_AvailabilityState as AvailabilityState, type deviceState_CapabilityDomain as CapabilityDomain, type deviceState_CapabilityEvent as CapabilityEvent, type deviceState_CapabilitySnapshot as CapabilitySnapshot, type deviceState_CapabilityStatus as CapabilityStatus, type deviceState_Confidence as Confidence, type deviceState_ConfidenceLevel as ConfidenceLevel, type deviceState_ConformingEventName as ConformingEventName, type deviceState_ConnectivityDomain as ConnectivityDomain, type deviceState_ConnectivityEvent as ConnectivityEvent, type deviceState_ConnectivityIntent as ConnectivityIntent, type deviceState_ConnectivitySnapshot as ConnectivitySnapshot, type deviceState_DeviceBridgeDomain as DeviceBridgeDomain, deviceState_DeviceBridgeError as DeviceBridgeError, type deviceState_DeviceBridgeErrorCode as DeviceBridgeErrorCode, type deviceState_DeviceBridgeV2 as DeviceBridgeV2, type deviceState_DeviceContextDomain as DeviceContextDomain, type deviceState_DeviceContextSnapshot as DeviceContextSnapshot, type deviceState_DevicePlacement as DevicePlacement, type deviceState_DeviceState as DeviceState, type deviceState_DeviceToolContextV2Extension as DeviceToolContextV2Extension, type deviceState_EnvironmentDomain as EnvironmentDomain, type deviceState_EnvironmentEvent as EnvironmentEvent, type deviceState_EnvironmentIntent as EnvironmentIntent, type deviceState_EnvironmentSnapshot as EnvironmentSnapshot, type deviceState_Freshness as Freshness, type deviceState_FreshnessState as FreshnessState, type deviceState_HumanActivity as HumanActivity, type deviceState_InteractionDomain as InteractionDomain, type deviceState_InteractionEvent as InteractionEvent, type deviceState_InteractionSnapshot as InteractionSnapshot, type deviceState_MediaHandle as MediaHandle, type PermissionState$1 as PermissionState, type deviceState_PluginPropsV2Extension as PluginPropsV2Extension, type deviceState_RestrictionState as RestrictionState, type deviceState_SpatialDomain as SpatialDomain, type deviceState_SpatialEvent as SpatialEvent, type deviceState_SpatialIntent as SpatialIntent, type deviceState_SpatialPoint as SpatialPoint, type deviceState_SpatialSnapshot as SpatialSnapshot, type deviceState_SpatialStateEvent as SpatialStateEvent, type deviceState_StartOptions as StartOptions, type deviceState_StateDomainDeclaration as StateDomainDeclaration, type deviceState_StateEvent as StateEvent, type deviceState_StateListener as StateListener, type deviceState_StateQuality as StateQuality, type deviceState_StateSession as StateSession, type deviceState_StatefulDomain as StatefulDomain, type deviceState_Subscription as Subscription, type deviceState_SupportState as SupportState, type deviceState_VisualCaptureOptions as VisualCaptureOptions, type deviceState_VisualCaptureResult as VisualCaptureResult, type deviceState_VisualDomain as VisualDomain, type deviceState_VisualFrameQuality as VisualFrameQuality, type deviceState_VisualFrameRef as VisualFrameRef, type deviceState_VisualIntent as VisualIntent, type deviceState_VisualSnapshot as VisualSnapshot, deviceState_explainCapability as explainCapability, deviceState_isActionable as isActionable, deviceState_neverObserved as neverObserved };
+  export { type deviceState_ActivityDomain as ActivityDomain, type deviceState_ActivityIntent as ActivityIntent, type deviceState_ActivitySnapshot as ActivitySnapshot, type deviceState_AssertConforming as AssertConforming, type deviceState_AvailabilityState as AvailabilityState, type deviceState_CapabilityDomain as CapabilityDomain, type deviceState_CapabilityEvent as CapabilityEvent, type deviceState_CapabilitySnapshot as CapabilitySnapshot, type deviceState_CapabilityStatus as CapabilityStatus, type deviceState_Confidence as Confidence, type deviceState_ConfidenceLevel as ConfidenceLevel, type deviceState_ConformingEventName as ConformingEventName, type deviceState_ConnectivityDomain as ConnectivityDomain, type deviceState_ConnectivityEvent as ConnectivityEvent, type deviceState_ConnectivityIntent as ConnectivityIntent, type deviceState_ConnectivitySnapshot as ConnectivitySnapshot, type deviceState_DeviceBridgeDomain as DeviceBridgeDomain, deviceState_DeviceBridgeError as DeviceBridgeError, type deviceState_DeviceBridgeErrorCode as DeviceBridgeErrorCode, type deviceState_DeviceBridgeV2 as DeviceBridgeV2, type deviceState_DeviceContextDomain as DeviceContextDomain, type deviceState_DeviceContextSnapshot as DeviceContextSnapshot, type deviceState_DevicePlacement as DevicePlacement, type deviceState_DeviceState as DeviceState, type deviceState_DeviceToolContextV2Extension as DeviceToolContextV2Extension, type deviceState_EnvironmentDomain as EnvironmentDomain, type deviceState_EnvironmentEvent as EnvironmentEvent, type deviceState_EnvironmentIntent as EnvironmentIntent, type deviceState_EnvironmentSnapshot as EnvironmentSnapshot, type deviceState_Freshness as Freshness, type deviceState_FreshnessState as FreshnessState, type deviceState_HumanActivity as HumanActivity, type deviceState_InteractionDomain as InteractionDomain, type deviceState_InteractionEvent as InteractionEvent, type deviceState_InteractionSnapshot as InteractionSnapshot, type deviceState_MediaHandle as MediaHandle, type PermissionState$1 as PermissionState, type deviceState_PluginPropsV2Extension as PluginPropsV2Extension, type deviceState_RestrictionState as RestrictionState, type deviceState_SpatialDomain as SpatialDomain, type deviceState_SpatialEvent as SpatialEvent, type deviceState_SpatialIntent as SpatialIntent, type deviceState_SpatialPoint as SpatialPoint, type deviceState_SpatialSnapshot as SpatialSnapshot, type deviceState_SpatialStateEvent as SpatialStateEvent, type deviceState_StartOptions as StartOptions, type deviceState_StateDomainDeclaration as StateDomainDeclaration, type deviceState_StateEvent as StateEvent, type deviceState_StateListener as StateListener, type deviceState_StateQuality as StateQuality, type deviceState_StateSession as StateSession, type deviceState_StatefulDomain as StatefulDomain, type deviceState_Subscription as Subscription, type deviceState_SupportState as SupportState, type deviceState_VisualCaptureOptions as VisualCaptureOptions, type deviceState_VisualCaptureResult as VisualCaptureResult, type deviceState_VisualDomain as VisualDomain, type deviceState_VisualFrameQuality as VisualFrameQuality, type deviceState_VisualFrameRef as VisualFrameRef, type deviceState_VisualIntent as VisualIntent, type deviceState_VisualSnapshot as VisualSnapshot, type deviceState_VisualStartOptions as VisualStartOptions, deviceState_explainCapability as explainCapability, deviceState_isActionable as isActionable, deviceState_neverObserved as neverObserved };
 }
 
 /**
@@ -1217,11 +1228,13 @@ interface VoiceAPI {
     prompt(input: string): void;
     /**
      * Stream a silent OBSERVATION into the session — tell the model something
-     * without asking it to speak (a `system` conversation item). Cheap and
-     * high-frequency (safe once or twice a second): this is the channel for what
-     * the camera sees while the user walks. The model answers with the
-     * observations in hand the next time it takes a turn (user VAD, or prompt()) —
-     * an observation never triggers a turn by itself. Throws if not connected.
+     * without asking it to speak (a `system` conversation item): the channel for
+     * what the camera sees while the user walks. Limited, because every item stays
+     * in the model's context for the call: 2 a second (bursts of 4) and 2000
+     * characters each; over the limit it THROWS, so send only material changes.
+     * The model answers with the observations in hand the next time it takes a
+     * turn (user VAD, or prompt()) — an observation never triggers a turn by
+     * itself. Throws if not connected.
      */
     observe(text: string): void;
     /** Point-in-time session state. */
@@ -2208,14 +2221,24 @@ declare const PluginSDK: {
 
 /** Host DI: the app supplies the engines it has. Called once at startup. */
 declare function setDeviceStateProvider(state: Partial<DeviceState>): void;
+/**
+ * Release `holder`'s holds — in every domain, or in every domain NOT in `keep`
+ * (a surface whose grants shrank keeps only what it may still use) — and stop
+ * each engine that no one holds any more.
+ */
+declare function releaseDeviceStateHolds(holder: string, keep?: readonly DeviceBridgeDomain[]): Promise<void>;
+/** Who holds what — for diagnostics and tests. */
+declare function deviceStateHolders(domain: DeviceBridgeDomain): string[];
 /**
  * The `deviceState` a plugin receives, gated by what it declared.
  *
  * Every domain is always present — a plugin can call any of the eight without
  * an existence check. What differs is whether it answers with data, or with
- * an explicit "I know nothing" and a reason.
+ * an explicit "I know nothing" and a reason. `holder` names who a start() holds
+ * the session for (see Holds above); a caller with no lifetime of its own passes
+ * the plugin id.
  */
-declare function gateDeviceState(declared?: readonly DeviceBridgeDomain[]): DeviceState;
+declare function gateDeviceState(declared: readonly DeviceBridgeDomain[] | undefined, holder: string): DeviceState;
 /** Which domains this build can actually answer — for diagnostics. */
 declare function implementedStateDomains(): DeviceBridgeDomain[];
 
@@ -2363,7 +2386,7 @@ interface PluginGrants {
 declare function resolvePluginGrants(src: PluginRuntimeSource): PluginGrants;
 /** Turn a plugin's grants into the gated { device, native, deviceState, voice } it
  *  receives on every rendered surface. */
-declare function resolvePluginRuntimeProps(src: PluginRuntimeSource): PluginRuntimeProps;
+declare function resolvePluginRuntimeProps(src: PluginRuntimeSource, holder?: string): PluginRuntimeProps;
 
 interface DeviceToolSummary {
     name: string;
@@ -2393,7 +2416,8 @@ declare function setDeviceToolContextProvider(fn: (pluginId: string, capabilitie
  * Re-registering the same plugin (bundle reload) replaces its own entries.
  */
 declare function registerDeviceTools(pluginId: string, tools: DeviceToolDefinition[], capabilities?: NativeCapabilities$1, stateDomains?: DeviceBridgeDomain[]): string[];
-/** Drop every tool owned by a plugin (bundle eviction / plugin revoked). */
+/** Drop every tool owned by a plugin (bundle eviction / plugin revoked), and the
+ *  sessions its tools started. */
 declare function unregisterDeviceTools(pluginId: string): void;
 /** Is `name` registered — and, given `pluginId`, registered BY that plugin?
  *  (A clean voice call only lets its owner's own tools run.) */
@@ -2968,6 +2992,8 @@ interface UsePluginResult {
 }
 declare function usePlugin(pluginId: string, manifest: PluginManifestLike): UsePluginResult;
 
+declare function usePluginRuntimeProps(src: PluginRuntimeSource, deps: readonly unknown[]): PluginRuntimeProps;
+
 interface RemotePlugin {
     id: string;
     name: string;
@@ -3306,4 +3332,4 @@ declare function isInlineSurface(m: SurfaceManifest): m is InlineSurfaceManifest
 
 declare function SurfaceDispatcher(): react_jsx_runtime.JSX.Element;
 
-export { ActionButton, type ActivitySnapshot, AdaOrb, type AdaOrbState, Badge, type BiometricsAPI, type BiometricsAPIv2, type BluetoothAPI, type BluetoothDevice, type Bridge, type BundleCacheEntry, type BundleStorage, type CameraAPI, CameraPreview, type CameraPreviewProps, type CapabilitySnapshot, type CapabilityStatus, Card, type Confidence, type ConnectivityAPI, type ConnectivitySnapshot, type CookiesAPI, type DeviceBridgeDomain, type DeviceContextSnapshot, type DeviceState, type DeviceToolContext, type DeviceToolDefinition, type DeviceToolFailureReason, type DeviceToolFn, type DeviceToolOutcome, type DeviceToolSummary, type DeviceToolsAction, type DeviceToolsSessionDeps, EmptyState, type EnvironmentSnapshot, ErrorState, type FileSystemAPI, type Freshness, type HapticsAPI, type InlineSurfaceManifest, type InteractionSnapshot, ListItem, type LoadedBundleInfo, type LoadedBundleSource, LoadingState, type LocationAPI, type MapsAPI, type MapsAddress, type MapsCoordinate, type MapsPlace, type MapsRoute, type MapsRouteStep, MemoryBundleStorage, type MountSurfaceManifest, type NativeCapabilities$1 as NativeCapabilities, type NfcAPI, type NotificationsAPI, PLATFORM_VOICE_CALLER, type PluginManifest as PlatformPluginManifest, type PluginBridge, type PluginContext, type PluginGrants, type PluginHooks$1 as PluginHooks, type PluginManifest$1 as PluginManifest, type PluginNative, type PluginProps, type PluginRuntimeProps, type PluginRuntimeSource, PluginSDK, type PluginSummary, type PluginSurfaceMeta, type RegisteredPlugin, type RegisteredServicePlugin, type RegisteredToolsPlugin, type RegisteredUIPlugin, type RemotePlugin, type RenderMode, type ScannerAPI, SearchBar, type SessionSnapshot, type SharingAPI, type SpatialEvent, type SpatialIntent, type SpatialPoint, type SpatialSnapshot, type SpatialStateEvent, type StateEvent, type StateListener, type StateQuality, type StorageAPI, type Subscription, SurfaceCard, type SurfaceCardProps, SurfaceDispatcher, SurfaceDrawer, type SurfaceDrawerProps, SurfaceFullscreen, type SurfaceFullscreenProps, type SurfaceManifest, type SurfacePlacement, type SurfaceType, type SurfaceVisibility, TabBar, type ThemeTokens, type TrustedToolDeclaration, type VisionAPI, type VisionFrameQuality, type VisionLabel, type VisionObject, type VisionText, type VisualSnapshot, type VoiceAPI, type VoiceCaller, type VoiceDeviceToolCall, type VoiceDeviceToolReason, type VoiceEvent, type VoicePersona, type VoiceSessionProvider, type VoiceSnapshot, type VoiceStartOptions, type VoiceState, type VoiceSubscription, type VoiceTranscriptEntry, type WebViewCookie, __resetSessionSyncForTest, bundleManager, callDeviceTool, clearDeviceTools, createNativeBridge, deviceState as deviceStateV2, deviceToolsActionForSession, ensureDeviceToolsLoaded, explainCapability, gateDeviceState, gatePluginNative, gateVoice, getCameraPreviewProvider, getHaptics, getNativeBundleHash, getNativeBundleUrl, getNativeComponentId, getPlugin, getPluginNative, handleServerDeviceToolCall, hasDeviceTool, implementedStateDomains, implementedVoice, isActionable, isDeviceToolCommand, isInlineSurface, isMountSurface, listDeviceTools, listPlugins, nativePluginRegistry, neverObserved, pluginBundleUrl, register, registerBundleModules, registerDeviceTools, registerNativePlugin, registerPlatformDeviceTools, registerService, registerTools, resetDeviceToolLoader, resolvePluginGrants, resolvePluginRuntimeProps, resolvePluginUrl, setBundleStorage, setCameraPreviewProvider, setDeviceStateProvider, setDeviceToolContextProvider, setDeviceToolResultPoster, setHapticsProvider, setPluginNativeProvider, setPluginThemeColors, setVoiceProvider, supportsNative, supportsWebView, syncDeviceToolsForSession, unregisterDeviceTools, unregisterNativePlugin, useApi, useNativeBridge, usePlugin, usePluginTheme, useRemotePlugins, useSurfaceStore };
+export { ActionButton, type ActivitySnapshot, AdaOrb, type AdaOrbState, Badge, type BiometricsAPI, type BiometricsAPIv2, type BluetoothAPI, type BluetoothDevice, type Bridge, type BundleCacheEntry, type BundleStorage, type CameraAPI, CameraPreview, type CameraPreviewProps, type CapabilitySnapshot, type CapabilityStatus, Card, type Confidence, type ConnectivityAPI, type ConnectivitySnapshot, type CookiesAPI, type DeviceBridgeDomain, type DeviceContextSnapshot, type DeviceState, type DeviceToolContext, type DeviceToolDefinition, type DeviceToolFailureReason, type DeviceToolFn, type DeviceToolOutcome, type DeviceToolSummary, type DeviceToolsAction, type DeviceToolsSessionDeps, EmptyState, type EnvironmentSnapshot, ErrorState, type FileSystemAPI, type Freshness, type HapticsAPI, type InlineSurfaceManifest, type InteractionSnapshot, ListItem, type LoadedBundleInfo, type LoadedBundleSource, LoadingState, type LocationAPI, type MapsAPI, type MapsAddress, type MapsCoordinate, type MapsPlace, type MapsRoute, type MapsRouteStep, MemoryBundleStorage, type MountSurfaceManifest, type NativeCapabilities$1 as NativeCapabilities, type NfcAPI, type NotificationsAPI, PLATFORM_VOICE_CALLER, type PluginManifest as PlatformPluginManifest, type PluginBridge, type PluginContext, type PluginGrants, type PluginHooks$1 as PluginHooks, type PluginManifest$1 as PluginManifest, type PluginNative, type PluginProps, type PluginRuntimeProps, type PluginRuntimeSource, PluginSDK, type PluginSummary, type PluginSurfaceMeta, type RegisteredPlugin, type RegisteredServicePlugin, type RegisteredToolsPlugin, type RegisteredUIPlugin, type RemotePlugin, type RenderMode, type ScannerAPI, SearchBar, type SessionSnapshot, type SharingAPI, type SpatialEvent, type SpatialIntent, type SpatialPoint, type SpatialSnapshot, type SpatialStateEvent, type StateEvent, type StateListener, type StateQuality, type StorageAPI, type Subscription, SurfaceCard, type SurfaceCardProps, SurfaceDispatcher, SurfaceDrawer, type SurfaceDrawerProps, SurfaceFullscreen, type SurfaceFullscreenProps, type SurfaceManifest, type SurfacePlacement, type SurfaceType, type SurfaceVisibility, TabBar, type ThemeTokens, type TrustedToolDeclaration, type VisionAPI, type VisionFrameQuality, type VisionLabel, type VisionObject, type VisionText, type VisualSnapshot, type VisualStartOptions, type VoiceAPI, type VoiceCaller, type VoiceDeviceToolCall, type VoiceDeviceToolReason, type VoiceEvent, type VoicePersona, type VoiceSessionProvider, type VoiceSnapshot, type VoiceStartOptions, type VoiceState, type VoiceSubscription, type VoiceTranscriptEntry, type WebViewCookie, __resetSessionSyncForTest, bundleManager, callDeviceTool, clearDeviceTools, createNativeBridge, deviceStateHolders, deviceState as deviceStateV2, deviceToolsActionForSession, ensureDeviceToolsLoaded, explainCapability, gateDeviceState, gatePluginNative, gateVoice, getCameraPreviewProvider, getHaptics, getNativeBundleHash, getNativeBundleUrl, getNativeComponentId, getPlugin, getPluginNative, handleServerDeviceToolCall, hasDeviceTool, implementedStateDomains, implementedVoice, isActionable, isDeviceToolCommand, isInlineSurface, isMountSurface, listDeviceTools, listPlugins, nativePluginRegistry, neverObserved, pluginBundleUrl, register, registerBundleModules, registerDeviceTools, registerNativePlugin, registerPlatformDeviceTools, registerService, registerTools, releaseDeviceStateHolds, resetDeviceToolLoader, resolvePluginGrants, resolvePluginRuntimeProps, resolvePluginUrl, setBundleStorage, setCameraPreviewProvider, setDeviceStateProvider, setDeviceToolContextProvider, setDeviceToolResultPoster, setHapticsProvider, setPluginNativeProvider, setPluginThemeColors, setVoiceProvider, supportsNative, supportsWebView, syncDeviceToolsForSession, unregisterDeviceTools, unregisterNativePlugin, useApi, useNativeBridge, usePlugin, usePluginRuntimeProps, usePluginTheme, useRemotePlugins, useSurfaceStore };

package/dist/index.d.ts

@@ -485,6 +485,16 @@ interface VisualCaptureOptions {
     signal?: AbortSignal;
     timeoutMs?: number;
 }
+interface VisualStartOptions extends StartOptions<VisualIntent> {
+    /**
+     * Which camera: 'back' (the default) or 'front', the selfie camera — its
+     * frames are mirrored like the view the user sees, so a box's left is the
+     * screen's left. A binary without the front camera REJECTS 'front' rather
+     * than reading the back camera; `camera.facing` in the snapshot says which
+     * one is actually running.
+     */
+    facing?: 'front' | 'back';
+}
 interface VisualDomain {
     /**
      * Cached read. Does NOT open the camera and does NOT take a picture.
@@ -497,7 +507,7 @@ interface VisualDomain {
      */
     getSnapshot(): Promise<VisualSnapshot>;
     /** Maintain visual state according to this intent. Not "open the camera". */
-    start(options: StartOptions<VisualIntent>): Promise<StateSession>;
+    start(options: VisualStartOptions): Promise<StateSession>;
     /**
      * An intentional, one-shot, high-quality-ish acquisition. THROWS
      * DeviceBridgeError on failure — it is an operation, not a read.
@@ -1002,11 +1012,12 @@ type deviceState_VisualFrameQuality = VisualFrameQuality;
 type deviceState_VisualFrameRef = VisualFrameRef;
 type deviceState_VisualIntent = VisualIntent;
 type deviceState_VisualSnapshot = VisualSnapshot;
+type deviceState_VisualStartOptions = VisualStartOptions;
 declare const deviceState_explainCapability: typeof explainCapability;
 declare const deviceState_isActionable: typeof isActionable;
 declare const deviceState_neverObserved: typeof neverObserved;
 declare namespace deviceState {
-  export { type deviceState_ActivityDomain as ActivityDomain, type deviceState_ActivityIntent as ActivityIntent, type deviceState_ActivitySnapshot as ActivitySnapshot, type deviceState_AssertConforming as AssertConforming, type deviceState_AvailabilityState as AvailabilityState, type deviceState_CapabilityDomain as CapabilityDomain, type deviceState_CapabilityEvent as CapabilityEvent, type deviceState_CapabilitySnapshot as CapabilitySnapshot, type deviceState_CapabilityStatus as CapabilityStatus, type deviceState_Confidence as Confidence, type deviceState_ConfidenceLevel as ConfidenceLevel, type deviceState_ConformingEventName as ConformingEventName, type deviceState_ConnectivityDomain as ConnectivityDomain, type deviceState_ConnectivityEvent as ConnectivityEvent, type deviceState_ConnectivityIntent as ConnectivityIntent, type deviceState_ConnectivitySnapshot as ConnectivitySnapshot, type deviceState_DeviceBridgeDomain as DeviceBridgeDomain, deviceState_DeviceBridgeError as DeviceBridgeError, type deviceState_DeviceBridgeErrorCode as DeviceBridgeErrorCode, type deviceState_DeviceBridgeV2 as DeviceBridgeV2, type deviceState_DeviceContextDomain as DeviceContextDomain, type deviceState_DeviceContextSnapshot as DeviceContextSnapshot, type deviceState_DevicePlacement as DevicePlacement, type deviceState_DeviceState as DeviceState, type deviceState_DeviceToolContextV2Extension as DeviceToolContextV2Extension, type deviceState_EnvironmentDomain as EnvironmentDomain, type deviceState_EnvironmentEvent as EnvironmentEvent, type deviceState_EnvironmentIntent as EnvironmentIntent, type deviceState_EnvironmentSnapshot as EnvironmentSnapshot, type deviceState_Freshness as Freshness, type deviceState_FreshnessState as FreshnessState, type deviceState_HumanActivity as HumanActivity, type deviceState_InteractionDomain as InteractionDomain, type deviceState_InteractionEvent as InteractionEvent, type deviceState_InteractionSnapshot as InteractionSnapshot, type deviceState_MediaHandle as MediaHandle, type PermissionState$1 as PermissionState, type deviceState_PluginPropsV2Extension as PluginPropsV2Extension, type deviceState_RestrictionState as RestrictionState, type deviceState_SpatialDomain as SpatialDomain, type deviceState_SpatialEvent as SpatialEvent, type deviceState_SpatialIntent as SpatialIntent, type deviceState_SpatialPoint as SpatialPoint, type deviceState_SpatialSnapshot as SpatialSnapshot, type deviceState_SpatialStateEvent as SpatialStateEvent, type deviceState_StartOptions as StartOptions, type deviceState_StateDomainDeclaration as StateDomainDeclaration, type deviceState_StateEvent as StateEvent, type deviceState_StateListener as StateListener, type deviceState_StateQuality as StateQuality, type deviceState_StateSession as StateSession, type deviceState_StatefulDomain as StatefulDomain, type deviceState_Subscription as Subscription, type deviceState_SupportState as SupportState, type deviceState_VisualCaptureOptions as VisualCaptureOptions, type deviceState_VisualCaptureResult as VisualCaptureResult, type deviceState_VisualDomain as VisualDomain, type deviceState_VisualFrameQuality as VisualFrameQuality, type deviceState_VisualFrameRef as VisualFrameRef, type deviceState_VisualIntent as VisualIntent, type deviceState_VisualSnapshot as VisualSnapshot, deviceState_explainCapability as explainCapability, deviceState_isActionable as isActionable, deviceState_neverObserved as neverObserved };
+  export { type deviceState_ActivityDomain as ActivityDomain, type deviceState_ActivityIntent as ActivityIntent, type deviceState_ActivitySnapshot as ActivitySnapshot, type deviceState_AssertConforming as AssertConforming, type deviceState_AvailabilityState as AvailabilityState, type deviceState_CapabilityDomain as CapabilityDomain, type deviceState_CapabilityEvent as CapabilityEvent, type deviceState_CapabilitySnapshot as CapabilitySnapshot, type deviceState_CapabilityStatus as CapabilityStatus, type deviceState_Confidence as Confidence, type deviceState_ConfidenceLevel as ConfidenceLevel, type deviceState_ConformingEventName as ConformingEventName, type deviceState_ConnectivityDomain as ConnectivityDomain, type deviceState_ConnectivityEvent as ConnectivityEvent, type deviceState_ConnectivityIntent as ConnectivityIntent, type deviceState_ConnectivitySnapshot as ConnectivitySnapshot, type deviceState_DeviceBridgeDomain as DeviceBridgeDomain, deviceState_DeviceBridgeError as DeviceBridgeError, type deviceState_DeviceBridgeErrorCode as DeviceBridgeErrorCode, type deviceState_DeviceBridgeV2 as DeviceBridgeV2, type deviceState_DeviceContextDomain as DeviceContextDomain, type deviceState_DeviceContextSnapshot as DeviceContextSnapshot, type deviceState_DevicePlacement as DevicePlacement, type deviceState_DeviceState as DeviceState, type deviceState_DeviceToolContextV2Extension as DeviceToolContextV2Extension, type deviceState_EnvironmentDomain as EnvironmentDomain, type deviceState_EnvironmentEvent as EnvironmentEvent, type deviceState_EnvironmentIntent as EnvironmentIntent, type deviceState_EnvironmentSnapshot as EnvironmentSnapshot, type deviceState_Freshness as Freshness, type deviceState_FreshnessState as FreshnessState, type deviceState_HumanActivity as HumanActivity, type deviceState_InteractionDomain as InteractionDomain, type deviceState_InteractionEvent as InteractionEvent, type deviceState_InteractionSnapshot as InteractionSnapshot, type deviceState_MediaHandle as MediaHandle, type PermissionState$1 as PermissionState, type deviceState_PluginPropsV2Extension as PluginPropsV2Extension, type deviceState_RestrictionState as RestrictionState, type deviceState_SpatialDomain as SpatialDomain, type deviceState_SpatialEvent as SpatialEvent, type deviceState_SpatialIntent as SpatialIntent, type deviceState_SpatialPoint as SpatialPoint, type deviceState_SpatialSnapshot as SpatialSnapshot, type deviceState_SpatialStateEvent as SpatialStateEvent, type deviceState_StartOptions as StartOptions, type deviceState_StateDomainDeclaration as StateDomainDeclaration, type deviceState_StateEvent as StateEvent, type deviceState_StateListener as StateListener, type deviceState_StateQuality as StateQuality, type deviceState_StateSession as StateSession, type deviceState_StatefulDomain as StatefulDomain, type deviceState_Subscription as Subscription, type deviceState_SupportState as SupportState, type deviceState_VisualCaptureOptions as VisualCaptureOptions, type deviceState_VisualCaptureResult as VisualCaptureResult, type deviceState_VisualDomain as VisualDomain, type deviceState_VisualFrameQuality as VisualFrameQuality, type deviceState_VisualFrameRef as VisualFrameRef, type deviceState_VisualIntent as VisualIntent, type deviceState_VisualSnapshot as VisualSnapshot, type deviceState_VisualStartOptions as VisualStartOptions, deviceState_explainCapability as explainCapability, deviceState_isActionable as isActionable, deviceState_neverObserved as neverObserved };
 }
 
 /**
@@ -1217,11 +1228,13 @@ interface VoiceAPI {
     prompt(input: string): void;
     /**
      * Stream a silent OBSERVATION into the session — tell the model something
-     * without asking it to speak (a `system` conversation item). Cheap and
-     * high-frequency (safe once or twice a second): this is the channel for what
-     * the camera sees while the user walks. The model answers with the
-     * observations in hand the next time it takes a turn (user VAD, or prompt()) —
-     * an observation never triggers a turn by itself. Throws if not connected.
+     * without asking it to speak (a `system` conversation item): the channel for
+     * what the camera sees while the user walks. Limited, because every item stays
+     * in the model's context for the call: 2 a second (bursts of 4) and 2000
+     * characters each; over the limit it THROWS, so send only material changes.
+     * The model answers with the observations in hand the next time it takes a
+     * turn (user VAD, or prompt()) — an observation never triggers a turn by
+     * itself. Throws if not connected.
      */
     observe(text: string): void;
     /** Point-in-time session state. */
@@ -2208,14 +2221,24 @@ declare const PluginSDK: {
 
 /** Host DI: the app supplies the engines it has. Called once at startup. */
 declare function setDeviceStateProvider(state: Partial<DeviceState>): void;
+/**
+ * Release `holder`'s holds — in every domain, or in every domain NOT in `keep`
+ * (a surface whose grants shrank keeps only what it may still use) — and stop
+ * each engine that no one holds any more.
+ */
+declare function releaseDeviceStateHolds(holder: string, keep?: readonly DeviceBridgeDomain[]): Promise<void>;
+/** Who holds what — for diagnostics and tests. */
+declare function deviceStateHolders(domain: DeviceBridgeDomain): string[];
 /**
  * The `deviceState` a plugin receives, gated by what it declared.
  *
  * Every domain is always present — a plugin can call any of the eight without
  * an existence check. What differs is whether it answers with data, or with
- * an explicit "I know nothing" and a reason.
+ * an explicit "I know nothing" and a reason. `holder` names who a start() holds
+ * the session for (see Holds above); a caller with no lifetime of its own passes
+ * the plugin id.
  */
-declare function gateDeviceState(declared?: readonly DeviceBridgeDomain[]): DeviceState;
+declare function gateDeviceState(declared: readonly DeviceBridgeDomain[] | undefined, holder: string): DeviceState;
 /** Which domains this build can actually answer — for diagnostics. */
 declare function implementedStateDomains(): DeviceBridgeDomain[];
 
@@ -2363,7 +2386,7 @@ interface PluginGrants {
 declare function resolvePluginGrants(src: PluginRuntimeSource): PluginGrants;
 /** Turn a plugin's grants into the gated { device, native, deviceState, voice } it
  *  receives on every rendered surface. */
-declare function resolvePluginRuntimeProps(src: PluginRuntimeSource): PluginRuntimeProps;
+declare function resolvePluginRuntimeProps(src: PluginRuntimeSource, holder?: string): PluginRuntimeProps;
 
 interface DeviceToolSummary {
     name: string;
@@ -2393,7 +2416,8 @@ declare function setDeviceToolContextProvider(fn: (pluginId: string, capabilitie
  * Re-registering the same plugin (bundle reload) replaces its own entries.
  */
 declare function registerDeviceTools(pluginId: string, tools: DeviceToolDefinition[], capabilities?: NativeCapabilities$1, stateDomains?: DeviceBridgeDomain[]): string[];
-/** Drop every tool owned by a plugin (bundle eviction / plugin revoked). */
+/** Drop every tool owned by a plugin (bundle eviction / plugin revoked), and the
+ *  sessions its tools started. */
 declare function unregisterDeviceTools(pluginId: string): void;
 /** Is `name` registered — and, given `pluginId`, registered BY that plugin?
  *  (A clean voice call only lets its owner's own tools run.) */
@@ -2968,6 +2992,8 @@ interface UsePluginResult {
 }
 declare function usePlugin(pluginId: string, manifest: PluginManifestLike): UsePluginResult;
 
+declare function usePluginRuntimeProps(src: PluginRuntimeSource, deps: readonly unknown[]): PluginRuntimeProps;
+
 interface RemotePlugin {
     id: string;
     name: string;
@@ -3306,4 +3332,4 @@ declare function isInlineSurface(m: SurfaceManifest): m is InlineSurfaceManifest
 
 declare function SurfaceDispatcher(): react_jsx_runtime.JSX.Element;
 
-export { ActionButton, type ActivitySnapshot, AdaOrb, type AdaOrbState, Badge, type BiometricsAPI, type BiometricsAPIv2, type BluetoothAPI, type BluetoothDevice, type Bridge, type BundleCacheEntry, type BundleStorage, type CameraAPI, CameraPreview, type CameraPreviewProps, type CapabilitySnapshot, type CapabilityStatus, Card, type Confidence, type ConnectivityAPI, type ConnectivitySnapshot, type CookiesAPI, type DeviceBridgeDomain, type DeviceContextSnapshot, type DeviceState, type DeviceToolContext, type DeviceToolDefinition, type DeviceToolFailureReason, type DeviceToolFn, type DeviceToolOutcome, type DeviceToolSummary, type DeviceToolsAction, type DeviceToolsSessionDeps, EmptyState, type EnvironmentSnapshot, ErrorState, type FileSystemAPI, type Freshness, type HapticsAPI, type InlineSurfaceManifest, type InteractionSnapshot, ListItem, type LoadedBundleInfo, type LoadedBundleSource, LoadingState, type LocationAPI, type MapsAPI, type MapsAddress, type MapsCoordinate, type MapsPlace, type MapsRoute, type MapsRouteStep, MemoryBundleStorage, type MountSurfaceManifest, type NativeCapabilities$1 as NativeCapabilities, type NfcAPI, type NotificationsAPI, PLATFORM_VOICE_CALLER, type PluginManifest as PlatformPluginManifest, type PluginBridge, type PluginContext, type PluginGrants, type PluginHooks$1 as PluginHooks, type PluginManifest$1 as PluginManifest, type PluginNative, type PluginProps, type PluginRuntimeProps, type PluginRuntimeSource, PluginSDK, type PluginSummary, type PluginSurfaceMeta, type RegisteredPlugin, type RegisteredServicePlugin, type RegisteredToolsPlugin, type RegisteredUIPlugin, type RemotePlugin, type RenderMode, type ScannerAPI, SearchBar, type SessionSnapshot, type SharingAPI, type SpatialEvent, type SpatialIntent, type SpatialPoint, type SpatialSnapshot, type SpatialStateEvent, type StateEvent, type StateListener, type StateQuality, type StorageAPI, type Subscription, SurfaceCard, type SurfaceCardProps, SurfaceDispatcher, SurfaceDrawer, type SurfaceDrawerProps, SurfaceFullscreen, type SurfaceFullscreenProps, type SurfaceManifest, type SurfacePlacement, type SurfaceType, type SurfaceVisibility, TabBar, type ThemeTokens, type TrustedToolDeclaration, type VisionAPI, type VisionFrameQuality, type VisionLabel, type VisionObject, type VisionText, type VisualSnapshot, type VoiceAPI, type VoiceCaller, type VoiceDeviceToolCall, type VoiceDeviceToolReason, type VoiceEvent, type VoicePersona, type VoiceSessionProvider, type VoiceSnapshot, type VoiceStartOptions, type VoiceState, type VoiceSubscription, type VoiceTranscriptEntry, type WebViewCookie, __resetSessionSyncForTest, bundleManager, callDeviceTool, clearDeviceTools, createNativeBridge, deviceState as deviceStateV2, deviceToolsActionForSession, ensureDeviceToolsLoaded, explainCapability, gateDeviceState, gatePluginNative, gateVoice, getCameraPreviewProvider, getHaptics, getNativeBundleHash, getNativeBundleUrl, getNativeComponentId, getPlugin, getPluginNative, handleServerDeviceToolCall, hasDeviceTool, implementedStateDomains, implementedVoice, isActionable, isDeviceToolCommand, isInlineSurface, isMountSurface, listDeviceTools, listPlugins, nativePluginRegistry, neverObserved, pluginBundleUrl, register, registerBundleModules, registerDeviceTools, registerNativePlugin, registerPlatformDeviceTools, registerService, registerTools, resetDeviceToolLoader, resolvePluginGrants, resolvePluginRuntimeProps, resolvePluginUrl, setBundleStorage, setCameraPreviewProvider, setDeviceStateProvider, setDeviceToolContextProvider, setDeviceToolResultPoster, setHapticsProvider, setPluginNativeProvider, setPluginThemeColors, setVoiceProvider, supportsNative, supportsWebView, syncDeviceToolsForSession, unregisterDeviceTools, unregisterNativePlugin, useApi, useNativeBridge, usePlugin, usePluginTheme, useRemotePlugins, useSurfaceStore };
+export { ActionButton, type ActivitySnapshot, AdaOrb, type AdaOrbState, Badge, type BiometricsAPI, type BiometricsAPIv2, type BluetoothAPI, type BluetoothDevice, type Bridge, type BundleCacheEntry, type BundleStorage, type CameraAPI, CameraPreview, type CameraPreviewProps, type CapabilitySnapshot, type CapabilityStatus, Card, type Confidence, type ConnectivityAPI, type ConnectivitySnapshot, type CookiesAPI, type DeviceBridgeDomain, type DeviceContextSnapshot, type DeviceState, type DeviceToolContext, type DeviceToolDefinition, type DeviceToolFailureReason, type DeviceToolFn, type DeviceToolOutcome, type DeviceToolSummary, type DeviceToolsAction, type DeviceToolsSessionDeps, EmptyState, type EnvironmentSnapshot, ErrorState, type FileSystemAPI, type Freshness, type HapticsAPI, type InlineSurfaceManifest, type InteractionSnapshot, ListItem, type LoadedBundleInfo, type LoadedBundleSource, LoadingState, type LocationAPI, type MapsAPI, type MapsAddress, type MapsCoordinate, type MapsPlace, type MapsRoute, type MapsRouteStep, MemoryBundleStorage, type MountSurfaceManifest, type NativeCapabilities$1 as NativeCapabilities, type NfcAPI, type NotificationsAPI, PLATFORM_VOICE_CALLER, type PluginManifest as PlatformPluginManifest, type PluginBridge, type PluginContext, type PluginGrants, type PluginHooks$1 as PluginHooks, type PluginManifest$1 as PluginManifest, type PluginNative, type PluginProps, type PluginRuntimeProps, type PluginRuntimeSource, PluginSDK, type PluginSummary, type PluginSurfaceMeta, type RegisteredPlugin, type RegisteredServicePlugin, type RegisteredToolsPlugin, type RegisteredUIPlugin, type RemotePlugin, type RenderMode, type ScannerAPI, SearchBar, type SessionSnapshot, type SharingAPI, type SpatialEvent, type SpatialIntent, type SpatialPoint, type SpatialSnapshot, type SpatialStateEvent, type StateEvent, type StateListener, type StateQuality, type StorageAPI, type Subscription, SurfaceCard, type SurfaceCardProps, SurfaceDispatcher, SurfaceDrawer, type SurfaceDrawerProps, SurfaceFullscreen, type SurfaceFullscreenProps, type SurfaceManifest, type SurfacePlacement, type SurfaceType, type SurfaceVisibility, TabBar, type ThemeTokens, type TrustedToolDeclaration, type VisionAPI, type VisionFrameQuality, type VisionLabel, type VisionObject, type VisionText, type VisualSnapshot, type VisualStartOptions, type VoiceAPI, type VoiceCaller, type VoiceDeviceToolCall, type VoiceDeviceToolReason, type VoiceEvent, type VoicePersona, type VoiceSessionProvider, type VoiceSnapshot, type VoiceStartOptions, type VoiceState, type VoiceSubscription, type VoiceTranscriptEntry, type WebViewCookie, __resetSessionSyncForTest, bundleManager, callDeviceTool, clearDeviceTools, createNativeBridge, deviceStateHolders, deviceState as deviceStateV2, deviceToolsActionForSession, ensureDeviceToolsLoaded, explainCapability, gateDeviceState, gatePluginNative, gateVoice, getCameraPreviewProvider, getHaptics, getNativeBundleHash, getNativeBundleUrl, getNativeComponentId, getPlugin, getPluginNative, handleServerDeviceToolCall, hasDeviceTool, implementedStateDomains, implementedVoice, isActionable, isDeviceToolCommand, isInlineSurface, isMountSurface, listDeviceTools, listPlugins, nativePluginRegistry, neverObserved, pluginBundleUrl, register, registerBundleModules, registerDeviceTools, registerNativePlugin, registerPlatformDeviceTools, registerService, registerTools, releaseDeviceStateHolds, resetDeviceToolLoader, resolvePluginGrants, resolvePluginRuntimeProps, resolvePluginUrl, setBundleStorage, setCameraPreviewProvider, setDeviceStateProvider, setDeviceToolContextProvider, setDeviceToolResultPoster, setHapticsProvider, setPluginNativeProvider, setPluginThemeColors, setVoiceProvider, supportsNative, supportsWebView, syncDeviceToolsForSession, unregisterDeviceTools, unregisterNativePlugin, useApi, useNativeBridge, usePlugin, usePluginRuntimeProps, usePluginTheme, useRemotePlugins, useSurfaceStore };

package/dist/index.js

@@ -860,7 +860,57 @@ function denial(domain, why) {
 function setDeviceStateProvider(state) {
   _provider = state || {};
 }
-function gateDeviceState(declared) {
+function holdersOf(domain) {
+  let s = holds.get(domain);
+  if (!s) {
+    s = /* @__PURE__ */ new Set();
+    holds.set(domain, s);
+  }
+  return s;
+}
+function withHolds(domain, engine, holder) {
+  if (!engine || typeof engine.start !== "function" || typeof engine.stop !== "function") return engine;
+  return Object.assign(Object.create(engine), {
+    async start(options) {
+      const s = holdersOf(domain);
+      const fresh = !s.has(holder);
+      s.add(holder);
+      let result;
+      try {
+        result = await engine.start(options);
+      } catch (e) {
+        if (fresh && s.delete(holder) && s.size === 0) await stopQuietly(engine);
+        throw e;
+      }
+      if (!s.has(holder) && s.size === 0) await stopQuietly(engine);
+      return result;
+    },
+    async stop() {
+      const s = holdersOf(domain);
+      if (!s.has(holder)) return;
+      s.delete(holder);
+      if (s.size === 0) await engine.stop();
+    }
+  });
+}
+async function stopQuietly(engine) {
+  try {
+    await engine?.stop?.();
+  } catch {
+  }
+}
+async function releaseDeviceStateHolds(holder, keep = []) {
+  for (const [domain, s] of holds) {
+    if (keep.includes(domain)) continue;
+    if (!s.delete(holder) || s.size > 0) continue;
+    await stopQuietly(_provider[domain]);
+  }
+}
+function deviceStateHolders(domain) {
+  return [...holds.get(domain) || []];
+}
+function gateDeviceState(declared, holder) {
+  if (!holder) throw new Error("gateDeviceState: a holder is required \u2014 who would release a session it starts?");
   const allowed = new Set(declared || []);
   const out = {};
   for (const domain of ALL_DOMAINS) {
@@ -872,7 +922,7 @@ function gateDeviceState(declared) {
       continue;
     }
     const engine = _provider[domain];
-    out[domain] = engine ?? deniedDomain(
+    out[domain] = engine ? withHolds(domain, engine, holder) : deniedDomain(
       domain,
       "no engine in this build \u2014 the native side does not exist yet. See docs/DEVICE_API_STATUS.md."
     );
@@ -895,7 +945,7 @@ function withoutSubscribe(state) {
 function implementedStateDomains() {
   return ALL_DOMAINS.filter((d) => !!_provider[d]);
 }
-var UNKNOWN_QUALITY, ALL_DOMAINS, _provider;
+var UNKNOWN_QUALITY, ALL_DOMAINS, _provider, holds;
 var init_deviceStateHost = __esm({
   "src/deviceStateHost.ts"() {
     "use strict";
@@ -914,6 +964,7 @@ var init_deviceStateHost = __esm({
       "interaction"
     ];
     _provider = {};
+    holds = /* @__PURE__ */ new Map();
   }
 });
 
@@ -1016,10 +1067,10 @@ function resolvePluginGrants(src) {
   const stateDomains = trusted?.stateDomains ? [...trusted.stateDomains] : void 0;
   return { capabilities: mergeCaps(trusted), stateDomains };
 }
-function resolvePluginRuntimeProps(src) {
+function resolvePluginRuntimeProps(src, holder = src.pluginId) {
   const { capabilities, stateDomains } = resolvePluginGrants(src);
   const native = gatePluginNative(getPluginNative(), capabilities, src.pluginId);
-  const deviceState = gateDeviceState(stateDomains);
+  const deviceState = gateDeviceState(stateDomains, holder);
   const voice = gateVoice(!!capabilities?.voice, src.pluginId);
   return { device: native, native, deviceState, voice };
 }
@@ -1249,7 +1300,9 @@ function defaultContext(pluginId, capabilities, stateDomains) {
   return {
     bridge: createNativeBridge(pluginId),
     native: gatePluginNative(getPluginNative(), capabilities, pluginId),
-    deviceState: gateDeviceState(stateDomains)
+    // A tool call has no lifetime of its own: what it starts is held for the
+    // plugin's tools, and released when the plugin's tools are unregistered.
+    deviceState: gateDeviceState(stateDomains, toolHolder(pluginId))
   };
 }
 function registerDeviceTools(pluginId, tools, capabilities, stateDomains) {
@@ -1274,10 +1327,14 @@ function registerDeviceTools(pluginId, tools, capabilities, stateDomains) {
   }
   return accepted;
 }
+function toolHolder(pluginId) {
+  return `tools:${pluginId}`;
+}
 function unregisterDeviceTools(pluginId) {
   for (const [name, entry] of registry.entries()) {
     if (entry.pluginId === pluginId) registry.delete(name);
   }
+  void releaseDeviceStateHolds(toolHolder(pluginId));
 }
 function hasDeviceTool(name, pluginId) {
   const entry = registry.get(name);
@@ -3301,6 +3358,7 @@ __export(index_exports, {
   callDeviceTool: () => callDeviceTool,
   clearDeviceTools: () => clearDeviceTools,
   createNativeBridge: () => createNativeBridge,
+  deviceStateHolders: () => deviceStateHolders,
   deviceStateV2: () => device_state_exports,
   deviceToolsActionForSession: () => deviceToolsActionForSession,
   ensureDeviceToolsLoaded: () => ensureDeviceToolsLoaded,
@@ -3335,6 +3393,7 @@ __export(index_exports, {
   registerPlatformDeviceTools: () => registerPlatformDeviceTools,
   registerService: () => registerService,
   registerTools: () => registerTools,
+  releaseDeviceStateHolds: () => releaseDeviceStateHolds,
   resetDeviceToolLoader: () => resetDeviceToolLoader,
   resolvePluginGrants: () => resolvePluginGrants,
   resolvePluginRuntimeProps: () => resolvePluginRuntimeProps,
@@ -3356,6 +3415,7 @@ __export(index_exports, {
   useApi: () => useApi,
   useNativeBridge: () => useNativeBridge,
   usePlugin: () => usePlugin,
+  usePluginRuntimeProps: () => usePluginRuntimeProps,
   usePluginTheme: () => usePluginTheme,
   useRemotePlugins: () => useRemotePlugins,
   useSurfaceStore: () => useSurfaceStore
@@ -3589,15 +3649,38 @@ function usePlugin(pluginId, manifest) {
   return { plugin, loading, error, bundleMissing };
 }
 
-// src/hooks/useRemotePlugins.ts
+// src/hooks/usePluginRuntimeProps.ts
 var import_react12 = require("react");
+init_pluginRuntime();
+init_deviceStateHost();
+var mounts = 0;
+function usePluginRuntimeProps(src, deps) {
+  const holderRef = (0, import_react12.useRef)(null);
+  if (holderRef.current?.pluginId !== src.pluginId) {
+    holderRef.current = { pluginId: src.pluginId, holder: `${src.pluginId}#${++mounts}` };
+  }
+  const holder = holderRef.current.holder;
+  const props = (0, import_react12.useMemo)(() => resolvePluginRuntimeProps(src, holder), [...deps, holder]);
+  const granted = (0, import_react12.useMemo)(() => resolvePluginGrants(src).stateDomains ?? [], deps);
+  (0, import_react12.useEffect)(() => () => {
+    void releaseDeviceStateHolds(holder);
+  }, [holder]);
+  const grantedKey = granted.join(",");
+  (0, import_react12.useEffect)(() => {
+    void releaseDeviceStateHolds(holder, granted);
+  }, [holder, grantedKey]);
+  return props;
+}
+
+// src/hooks/useRemotePlugins.ts
+var import_react13 = require("react");
 var import_core11 = require("@ateam-ai-mobile/core");
 function useRemotePlugins(solutionId) {
-  const [plugins, setPlugins] = (0, import_react12.useState)([]);
-  const [loading, setLoading] = (0, import_react12.useState)(true);
-  const [refreshing, setRefreshing] = (0, import_react12.useState)(false);
-  const [error, setError] = (0, import_react12.useState)(null);
-  const fetchRemotePlugins = (0, import_react12.useCallback)(async () => {
+  const [plugins, setPlugins] = (0, import_react13.useState)([]);
+  const [loading, setLoading] = (0, import_react13.useState)(true);
+  const [refreshing, setRefreshing] = (0, import_react13.useState)(false);
+  const [error, setError] = (0, import_react13.useState)(null);
+  const fetchRemotePlugins = (0, import_react13.useCallback)(async () => {
     try {
       setError(null);
       const targetSolutionId = solutionId || "current";
@@ -3642,11 +3725,11 @@ function useRemotePlugins(solutionId) {
       setRefreshing(false);
     }
   }, [solutionId]);
-  const refresh = (0, import_react12.useCallback)(async () => {
+  const refresh = (0, import_react13.useCallback)(async () => {
     setRefreshing(true);
     await fetchRemotePlugins();
   }, [fetchRemotePlugins]);
-  (0, import_react12.useEffect)(() => {
+  (0, import_react13.useEffect)(() => {
     setLoading(true);
     fetchRemotePlugins();
   }, [fetchRemotePlugins]);
@@ -3709,6 +3792,7 @@ init_SurfaceDispatcher();
   callDeviceTool,
   clearDeviceTools,
   createNativeBridge,
+  deviceStateHolders,
   deviceStateV2,
   deviceToolsActionForSession,
   ensureDeviceToolsLoaded,
@@ -3743,6 +3827,7 @@ init_SurfaceDispatcher();
   registerPlatformDeviceTools,
   registerService,
   registerTools,
+  releaseDeviceStateHolds,
   resetDeviceToolLoader,
   resolvePluginGrants,
   resolvePluginRuntimeProps,
@@ -3764,6 +3849,7 @@ init_SurfaceDispatcher();
   useApi,
   useNativeBridge,
   usePlugin,
+  usePluginRuntimeProps,
   usePluginTheme,
   useRemotePlugins,
   useSurfaceStore