@touchcastllc/napster-companion-api-dev 1.0.0-alpha.80 → 1.0.0-alpha.82

package/lib/services/edge-mcp/index.d.ts

@@ -1,5 +1,2 @@
 export { EdgeMcpBridge } from "./edge-mcp-bridge";
-export type { EdgeMcpBridgeOptions } from "./edge-mcp-bridge";
 export { normalizeFunctionCallEvent } from "./normalizeFunctionCallEvent";
-export { getModelContext, discoverModelContext } from "./edge-mcp-discovery";
-export type { EdgeMcpModelContext, EdgeMcpToolInfo, EdgeMcpToolAnnotations, EdgeMcpResourceUpdate, FunctionCallEvent, SendCommand, } from "./edge-mcp-types";

package/lib/services/webrtc.d.ts

@@ -22,6 +22,18 @@ interface WebRTCParams {
     onDataChannel?: (dc: RTCDataChannel) => void;
     maxReconnectAttempts?: number;
     reconnectInterval?: number;
+    /**
+     * ICE servers for the peer connection. When omitted, servers from the
+     * connection token are used, else {@link DEFAULT_ICE_SERVERS}. Provide this to
+     * inject deployment-specific or ephemeral TURN credentials.
+     */
+    iceServers?: RTCIceServer[];
 }
+/**
+ * Resolve the RTCPeerConnection ICE configuration. Prefers caller-supplied ICE
+ * servers (ideally short-lived, per-session credentials minted by the backend)
+ * and falls back to {@link DEFAULT_ICE_SERVERS} only when none are provided.
+ */
+export declare function resolveRtcConfiguration(iceServers?: RTCIceServer[] | null): RTCConfiguration;
 export declare function createWebRTCController(params?: WebRTCParams): WebRTCController;
 export {};

package/lib/stores/index.d.ts

@@ -1,8 +1,6 @@
 export { store } from "./store";
-export type { RootState, AppDispatch } from "./store";
+export type { RootState } from "./store";
 export { setOnFeaturesUpdateCallback } from "./middleware/featuresUpdateMiddleware";
 export * from "./selectors";
-export { setSessionId, setAvatarReady, setDataChannel, setAvatarId, setVideoId, setStopInteraction, setMuted, setAutoMicActive, setVolume, setAvatarSpeaking, setScreenSharing, setUserTalking, addTranscript, setCustomVoiceId, setDefaultVoiceId, setConnectionToken, setCloseConnectionHandler, setSessionTerminatedByServer, resetAvatar, avatarReducer, } from "./slices/avatarSlice";
-export type { WebRTCStatus, AvatarState, Transcript, } from "./slices/avatarSlice";
-export { appReducer, setFeatures, resetFeatures, setPosition, setShowExperience, setDebugMode, } from "./slices/appSlice";
-export type { AppState } from "./slices/appSlice";
+export { setSessionId, setAvatarReady, setDataChannel, setStopInteraction, setMuted, setAutoMicActive, setVolume, setAvatarSpeaking, setScreenSharing, setUserTalking, setConnectionToken, setCloseConnectionHandler, setSessionTerminatedByServer, resetAvatar, } from "./slices/avatarSlice";
+export { setFeatures, resetFeatures, setPosition, setDebugMode, } from "./slices/appSlice";

package/lib/stores/selectors.d.ts

@@ -1,25 +1,16 @@
 import { RootState } from "./index";
 import { FeatureConfig, Position } from "../types";
-import { Transcript } from "./slices/avatarSlice";
 /**
  * Avatar state selectors
  */
 export declare const selectSessionId: (state: RootState) => string | undefined;
 export declare const selectAvatarReady: (state: RootState) => boolean;
 export declare const selectDataChannel: (state: RootState) => RTCDataChannel | null;
-export declare const selectAvatarId: (state: RootState) => string | undefined;
-export declare const selectVideoId: (state: RootState) => string | undefined;
 export declare const selectMuted: (state: RootState) => boolean;
 export declare const selectAutoMicActive: (state: RootState) => boolean;
-export declare const selectVolume: (state: RootState) => number;
 export declare const selectAvatarSpeaking: (state: RootState) => boolean;
-export declare const selectScreenSharing: (state: RootState) => boolean;
 export declare const selectUserTalking: (state: RootState) => boolean;
-export declare const selectTranscript: (state: RootState) => Transcript | undefined;
-export declare const selectCustomVoiceId: (state: RootState) => string | undefined;
-export declare const selectDefaultVoiceId: (state: RootState) => string | undefined;
 export declare const selectConnectionToken: (state: RootState) => string | undefined;
-export declare const selectCompanionId: (state: RootState) => string | undefined;
 export declare const selectStopInteraction: (state: RootState) => boolean;
 export declare const selectCloseConnectionHandler: (state: RootState) => (() => void) | undefined;
 export declare const selectSessionTerminatedByServer: (state: RootState) => boolean;
@@ -28,7 +19,6 @@ export declare const selectSessionTerminatedByServer: (state: RootState) => bool
  */
 export declare const selectFeatures: (state: RootState) => FeatureConfig;
 export declare const selectPosition: (state: RootState) => Position | undefined;
-export declare const selectShowExperience: (state: RootState) => boolean;
 /**
  * Composite selectors
  */

package/lib/stores/slices/appSlice.d.ts

@@ -2,11 +2,10 @@ import { Position, FeatureConfig } from "../../types";
 export interface AppState {
     features: FeatureConfig;
     position?: Position;
-    showExperience: boolean;
     debugMode?: boolean;
 }
 export declare const setFeatures: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     feature: keyof FeatureConfig;
     config: FeatureConfig[keyof FeatureConfig];
-}, "app/setFeatures">, resetFeatures: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"app/resetFeatures">, setPosition: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<Position | undefined, "app/setPosition">, setShowExperience: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "app/setShowExperience">, setDebugMode: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<boolean | undefined, "app/setDebugMode">;
+}, "app/setFeatures">, resetFeatures: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"app/resetFeatures">, setPosition: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<Position | undefined, "app/setPosition">, setDebugMode: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<boolean | undefined, "app/setDebugMode">;
 export declare const appReducer: import("redux").Reducer<AppState>;

package/lib/stores/slices/avatarSlice.d.ts

@@ -3,16 +3,10 @@ export interface WebRTCStatus {
     reason: string;
     message: string;
 }
-export interface Transcript {
-    role: string;
-    content: string;
-}
 export interface AvatarState {
     sessionId?: string;
     avatarReady: boolean;
     dataChannel: RTCDataChannel | null;
-    avatarId?: string;
-    videoId?: string;
     stopInteraction: boolean;
     muted: boolean;
     autoMicActive: boolean;
@@ -20,13 +14,9 @@ export interface AvatarState {
     avatarSpeaking: boolean;
     isScreenSharing: boolean;
     isUserTalking: boolean;
-    transcript?: Transcript;
-    customVoiceId: string | undefined;
-    defaultVoiceId: string | undefined;
     connectionToken?: string;
-    companionId?: string;
     closeConnectionHandler?: () => void;
     sessionTerminatedByServer: boolean;
 }
-export declare const setSessionId: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<string | undefined, "avatar/setSessionId">, setAvatarReady: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setAvatarReady">, setDataChannel: import("@reduxjs/toolkit").ActionCreatorWithPayload<RTCDataChannel | null, "avatar/setDataChannel">, setAvatarId: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<string | undefined, "avatar/setAvatarId">, setVideoId: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<string | undefined, "avatar/setVideoId">, setStopInteraction: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setStopInteraction">, setMuted: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setMuted">, setAutoMicActive: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setAutoMicActive">, setVolume: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "avatar/setVolume">, setAvatarSpeaking: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setAvatarSpeaking">, setScreenSharing: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setScreenSharing">, setUserTalking: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setUserTalking">, addTranscript: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<Transcript | undefined, "avatar/addTranscript">, setCustomVoiceId: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<string | undefined, "avatar/setCustomVoiceId">, setDefaultVoiceId: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<string | undefined, "avatar/setDefaultVoiceId">, setConnectionToken: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<string | undefined, "avatar/setConnectionToken">, setCloseConnectionHandler: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<(() => void) | undefined, "avatar/setCloseConnectionHandler">, setSessionTerminatedByServer: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setSessionTerminatedByServer">, resetAvatar: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"avatar/resetAvatar">;
+export declare const setSessionId: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<string | undefined, "avatar/setSessionId">, setAvatarReady: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setAvatarReady">, setDataChannel: import("@reduxjs/toolkit").ActionCreatorWithPayload<RTCDataChannel | null, "avatar/setDataChannel">, setStopInteraction: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setStopInteraction">, setMuted: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setMuted">, setAutoMicActive: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setAutoMicActive">, setVolume: import("@reduxjs/toolkit").ActionCreatorWithPayload<number, "avatar/setVolume">, setAvatarSpeaking: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setAvatarSpeaking">, setScreenSharing: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setScreenSharing">, setUserTalking: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setUserTalking">, setConnectionToken: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<string | undefined, "avatar/setConnectionToken">, setCloseConnectionHandler: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<(() => void) | undefined, "avatar/setCloseConnectionHandler">, setSessionTerminatedByServer: import("@reduxjs/toolkit").ActionCreatorWithPayload<boolean, "avatar/setSessionTerminatedByServer">, resetAvatar: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"avatar/resetAvatar">;
 export declare const avatarReducer: import("redux").Reducer<AvatarState>;

package/lib/stores/store.d.ts

@@ -1,10 +1,10 @@
 export declare const store: import("@reduxjs/toolkit").EnhancedStore<{
-    avatar: import(".").AvatarState;
-    app: import(".").AppState;
+    avatar: import("./slices/avatarSlice").AvatarState;
+    app: import("./slices/appSlice").AppState;
 }, import("redux").UnknownAction, import("@reduxjs/toolkit").Tuple<[import("redux").StoreEnhancer<{
     dispatch: import("redux-thunk").ThunkDispatch<{
-        avatar: import(".").AvatarState;
-        app: import(".").AppState;
+        avatar: import("./slices/avatarSlice").AvatarState;
+        app: import("./slices/appSlice").AppState;
     }, undefined, import("redux").UnknownAction>;
 }>, import("redux").StoreEnhancer]>>;
 export type RootState = ReturnType<typeof store.getState>;

package/lib/types/index.d.ts

@@ -142,12 +142,6 @@ export interface FeatureConfig {
     backgroundRemoval?: {
         enabled: boolean;
     };
-    /** Waveform display settings shown during audio playback/recording. */
-    waveform?: {
-        enabled: boolean;
-        /** Optional CSS color value for the waveform. Defaults are applied by the SDK if omitted. */
-        color?: string;
-    };
     /** Automatically hide or perform actions after a period of inactivity. */
     inactiveTimeout?: {
         enabled: boolean;
@@ -343,6 +337,8 @@ export interface NapsterCompanionApiConfig {
     functions?: CompanionFunction[];
     /** Enable debug logging throughout the SDK. When enabled, detailed logs will be output to the console. */
     debug?: boolean;
+    /** @internal */
+    iceServers?: RTCIceServer[];
     /**
      * Read WebMCP tools from a same-origin child iframe's `document.modelContext` instead of
      * this window's. Set by the persistent-agent shell (`mountShell` with `persist`) so the

package/lib/utils/classnames.d.ts

@@ -17,9 +17,9 @@ type ClassInput = ClassValue | ClassArray | ClassObject;
  */
 export declare function cn(...inputs: ClassInput[]): string;
 /**
- * Common CSS class name constants for the WaveForm component
+ * Common CSS class name constants for the control bar
  */
-export declare const WaveFormClasses: {
+export declare const ControlClasses: {
     readonly icon: "np_companion-action-btn-container-icon";
     readonly persistFillColor: "np_companion-persist-fill-color";
     readonly alignMiddle: "np_companion-align-middle";
@@ -28,12 +28,9 @@ export declare const WaveFormClasses: {
     readonly callEnd: "np_companion-action-btn-container-call-end";
     readonly container: "np_companion-action-btn-container-container";
     readonly wrapper: "np_companion-action-btn-container-wrapper";
-    readonly canvas: "np_companion-action-btn-container-canvas";
     readonly controls: "np_companion-action-btn-container-controls";
     readonly left: "np_companion-action-btn-container-left";
-    readonly middle: "np_companion-action-btn-container-middle";
     readonly right: "np_companion-action-btn-container-right";
-    readonly wave: "np_companion-action-btn-container-wave";
     readonly stop: "np_companion-action-btn-container-stop";
     readonly questionBar: "np_companion-chat-question-bar-container";
     readonly talking: "np_companion-talking";

package/lib/utils/index.d.ts

@@ -9,6 +9,11 @@ export interface DecodedBase64TokenType {
     connection: {
         id: string;
         signalingEndpoint: string;
+        /**
+         * Optional per-session ICE servers. When the backend mints ephemeral TURN
+         * credentials, it delivers them here so they never live in client code.
+         */
+        iceServers?: RTCIceServer[];
     };
     expiresAt: string;
 }

package/lib/utils/mouthDetection.d.ts

@@ -1,13 +1,4 @@
 import type { MouthLandmarks } from "../types";
-/**
- * MediaPipe Face Mesh landmark indices for mouth detection.
- */
-export declare const MOUTH_LANDMARK_INDICES: {
-    readonly upperLip: 13;
-    readonly lowerLip: 14;
-    readonly leftCorner: 61;
-    readonly rightCorner: 291;
-};
 /**
  * Creates a rolling average smoother for mouth-opening ratios.
  */

package/lib/utils/svg.d.ts

@@ -20,9 +20,9 @@ export declare class SVGBuilder {
 }
 export declare const svgBuilder: SVGBuilder;
 /**
- * Predefined SVG icons for WaveForm component
+ * Predefined SVG icons for the control bar buttons
  */
-export declare const WaveFormIcons: {
+export declare const ControlIcons: {
     micUnmuted(): SVGSVGElement;
     micMuted(): SVGSVGElement;
     stop(): SVGSVGElement;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@touchcastllc/napster-companion-api-dev",
-  "version": "1.0.0-alpha.80",
+  "version": "1.0.0-alpha.82",
   "keywords": [
     "napster",
     "companion-api",

package/lib/components/Preview/index.d.ts

@@ -1,18 +0,0 @@
-import "./Preview.css";
-export interface PreviewOptions {
-    previewUrl?: string;
-    idleVideoUrl?: string;
-    onStartClick: () => void;
-    isLoading?: boolean;
-    onVideoLoaded?: (loaded: boolean) => void;
-    shouldAnimate?: boolean;
-}
-export interface PreviewController {
-    update: (opts: Partial<PreviewOptions>) => void;
-    destroy: () => void;
-}
-/**
- * Vanilla Preview implementation. Renders a canvas over an optional looping video
- * and exposes a \"Start\" button. Designed to be lightweight and framework-free.
- */
-export declare function createPreview(mount: HTMLElement, options: PreviewOptions): PreviewController;

package/lib/components/VolumeControl/index.d.ts

@@ -1,18 +0,0 @@
-import "./VolumeControl.css";
-import { BaseController } from "../../types";
-export interface VolumeControlOptions {
-    initialVolume?: number;
-    onChange?: (volume: number) => void;
-    onMuteToggle?: (isMuted: boolean) => void;
-}
-export interface VolumeControlController extends BaseController<VolumeControlOptions> {
-    setVolume: (volume: number) => void;
-    getVolume: () => number;
-    toggleMute: () => void;
-    isMuted: () => boolean;
-}
-/**
- * Vanilla VolumeControl component.
- * Creates a circular button with speaker icon and vertical volume slider.
- */
-export declare function createVolumeControl(mount: HTMLElement, options?: VolumeControlOptions): VolumeControlController;

package/lib/constants/waveform.d.ts

@@ -1,34 +0,0 @@
-/**
- * Waveform component constants
- */
-export declare const WAVEFORM_CONSTANTS: {
-    /** Timeout in milliseconds before hiding controls on mouse inactivity */
-    readonly MOUSE_HIDE_TIMEOUT_MS: 5000;
-    /** Number of frames to maintain "talking" state after voice stops */
-    readonly TALKING_COOLDOWN_FRAMES: 30;
-    /** Minimum number of consecutive frames above threshold to consider user talking */
-    readonly TALKING_REQUIRED_FRAMES: 3;
-    /** Minimum amplitude threshold to detect voice activity */
-    readonly TALKING_THRESHOLD: 6;
-    /** Scale factor for waveform amplitude visualization */
-    readonly AMPLITUDE_SCALE_FACTOR: 0.8;
-    /** Canvas dimensions */
-    readonly CANVAS_WIDTH: 160;
-    readonly CANVAS_HEIGHT: 40;
-    /** Waveform bar styling */
-    readonly BAR_WIDTH: 2;
-    readonly BAR_GAP: 1;
-    /** FFT size for audio analysis */
-    readonly FFT_SIZE: 256;
-};
-/**
- * Waveform visual effects
- */
-export declare const WAVEFORM_EFFECTS: {
-    /** CSS filter for active talking state */
-    readonly TALKING_FILTER: "brightness(0) saturate(100%) invert(48%) sepia(93%) saturate(1720%) hue-rotate(346deg) brightness(101%) contrast(103%)";
-    /** CSS filter for inactive state */
-    readonly INACTIVE_FILTER: "none";
-    /** Transition duration for filter changes */
-    readonly TRANSITION: "filter 0.3s ease";
-};