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

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

@@ -76,17 +76,25 @@ export declare class EdgeMcpBridge {
      * Relay the current value of every registered resource to the agent once, as
      * an initial state seed — batched into a SINGLE `send_message` rather than one
      * per resource, so the agent gets the whole starting state in one context
-     * injection. Feature-detects the toolkit's resource extension (`getResources` /
-     * `readResource`) — a bare WebMCP surface has neither, so this is a no-op there.
-     * Already-seeded URIs are skipped so a `resourcelistchanged` re-seed only emits
-     * genuinely new resources. (Ongoing changes still relay per-resource via
-     * `relayResourceUpdate`, since they happen one at a time.)
+     * injection. Deferred until the session's "ready" state, exactly like tool
+     * registration: before that the data channel isn't open and a send would be
+     * silently dropped — onSessionReady() runs the seed at the first moment it
+     * can succeed, reading each value fresh at that point. Feature-detects the
+     * toolkit's resource extension (`getResources` / `readResource`) — a bare
+     * WebMCP surface has neither, so this is a no-op there. Already-seeded URIs
+     * are skipped so a `resourcelistchanged` re-seed only emits genuinely new
+     * resources; URIs are marked seeded only after a successful send, so a
+     * refused send stays owed to the agent. (Ongoing changes still relay
+     * per-resource via `relayResourceUpdate`, since they happen one at a time.)
      */
     private seedResources;
     /**
      * Send the whole initial state set to the agent as ONE `role: 'system'`
      * message (one line per resource). `trigger_response: false` so the avatar
      * doesn't speak on the seed; `delay: true` to wait for any current speech.
+     * Returns true when the send went out; false when the channel refused it
+     * (not open / interaction stopped) so the caller leaves the URIs unmarked
+     * and a later seed trigger re-reads and re-delivers them.
      */
     private relayInitialState;
     /** Re-read the tool catalog from the model context. */
@@ -95,19 +103,26 @@ export declare class EdgeMcpBridge {
     private buildInlineFunctions;
     /**
      * Called by the SDK when the session reaches the "ready" state
-     * (`avatar_state_changed` → `state: "ready"`). This is the only safe moment to
-     * register tools — the realtime session silently drops `inline_functions` sent
-     * before it's ready (e.g. on data-channel open). Marks the session ready,
-     * resets the dedupe, and pushes the current tools. Re-fires on reconnect (a
-     * fresh "ready").
+     * (`avatar_state_changed` → `state: "ready"`). This is the first moment the
+     * agent is reachable — the realtime session silently drops `inline_functions`
+     * sent before it's ready, and the data channel isn't open earlier (the
+     * "ready" event itself arrives over it). Marks the session ready, pushes the
+     * current tools, and delivers the initial state seed that bind() deferred.
+     *
+     * The backend can emit "ready" more than once per session; repeats are
+     * no-ops when nothing changed (the push dedupes on catalog content, the seed
+     * on delivered URIs). A genuinely NEW session never reaches this method on a
+     * live bridge: the SDK tears the whole instance down (destroyInstance →
+     * dispose) and the next init builds a fresh bridge with clean dedupe state.
      */
     onSessionReady(): void;
     /**
      * Register the page's WebMCP tools with the agent by sending the complete
-     * current catalog as `set_settings.inline_functions`. Called on attach, on
-     * every toolchange, and on data-channel open, so tools registered mid-session
-     * reach the agent. No-op when not attached, when `registerInlineFunctions` is
-     * disabled, or when the catalog is unchanged since the last successful push.
+     * current catalog as `set_settings.inline_functions`. Called on attach
+     * (deferred until ready), on session ready, and on every toolchange, so
+     * tools registered mid-session reach the agent. No-op when not attached,
+     * when `registerInlineFunctions` is disabled, or when the catalog is
+     * unchanged since the last successful push.
      */
     private pushInlineFunctions;
     /** True if `attach()` succeeded and the bridge has a live model context. */
@@ -126,7 +141,10 @@ export declare class EdgeMcpBridge {
     /**
      * Forward a toolkit resource update to the agent as a system message.
      * `trigger_response: false` keeps the avatar from speaking on every change;
-     * `delay: true` waits for it to finish its current speech first.
+     * `delay: true` waits for it to finish its current speech first. Before the
+     * session's first "ready" this is a deliberate no-op — the channel can't
+     * carry the message yet, and the session-ready seed reads the then-current
+     * value anyway, so relaying earlier would only warn and drop.
      */
     private relayResourceUpdate;
     /**

package/lib/services/webrtc.d.ts

@@ -1,4 +1,4 @@
-import { type EventMessage, type CompanionFunction } from "../types";
+import { type EventMessage } from "../types";
 import type { MediaCapture } from "../utils/MediaCapture";
 export interface WebRTCController {
     startWithToken: (token: string) => Promise<void>;
@@ -11,7 +11,6 @@ export interface WebRTCController {
 }
 interface WebRTCParams {
     currentAudioDeviceId?: string;
-    functions?: CompanionFunction[];
     screenShareCapture?: MediaCapture | null;
     onChatMessage?: (data: EventMessage) => void;
     onConnectionSuccess?: () => void;

package/lib/types/index.d.ts

@@ -182,6 +182,8 @@ export interface FeatureConfig {
         color?: string;
         /** Optional loader animation type. */
         type?: "spinner" | "pulse";
+        /** Optional CSS class name(s) to add to the loader spinner element. */
+        className?: string;
     };
     /** Document Picture-in-Picture. When enabled, the avatar automatically
      *  opens in a PiP window when the user switches browser tabs (Chrome/Edge 116+). */
@@ -329,8 +331,14 @@ export interface NapsterCompanionApiConfig {
     layout?: "fixed" | "inline";
     /**
      * AI companion function definitions for function calling support.
-     * These functions are sent to the server when the connection is established,
-     * allowing the AI to invoke them during conversation.
+     *
+     * Functions are configured server-side and baked into the connection at
+     * session-creation time (the connection API / token). To register tools
+     * mid-session from the page, use the WebMCP bridge, which pushes them as
+     * `set_settings.inline_functions` after the session reaches "ready".
+     *
+     * @deprecated The SDK no longer sends these over the data channel — supplying
+     * them here has no effect. Configure functions via the connection API instead.
      */
     functions?: CompanionFunction[];
     /** Enable debug logging throughout the SDK. When enabled, detailed logs will be output to the console. */

package/package.json

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