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

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

@@ -44,6 +44,16 @@ export declare class EdgeMcpBridge {
     constructor(options: EdgeMcpBridgeOptions);
     /** The document whose `modelContext` we read — the target iframe's, or this window's. */
     private targetDoc;
+    /**
+     * Switch the bridge's target to a different iframe (or back to this window's document)
+     * at runtime, then re-discover the model context there. Used by the persistent-agent
+     * shell's frame-on-navigate mode: the site starts UN-framed — its WebMCP tools live on
+     * the top-level `document.modelContext` — and only gets wrapped in an iframe on the first
+     * navigation, at which point the bridge must re-target from the top-level document to the
+     * new iframe. Detaches the old iframe's `load` listener, installs one on the new iframe,
+     * and calls `reattach()` (which polls, so a not-yet-loaded iframe still binds once ready).
+     */
+    setIframe(iframe: HTMLIFrameElement | null): void;
     /**
      * Discover `document.modelContext` in the page, cache its tools, and wire up
      * the `toolchange` / `resourceupdated` listeners. Returns the model context,

package/lib/shell/mount-shell.d.ts

@@ -13,6 +13,20 @@ export interface ShellOptions {
      * persistence.
      */
     persist?: boolean;
+    /**
+     * Defer the iframe wrap until the user first navigates (requires `persist`). Instead of
+     * wrapping the current page on connect, the landing page stays fully native — no iframe —
+     * and the avatar mounts in the top-level document. The shell intercepts the first in-site
+     * link click and, if the target is allowed (not matched by `persistConfig`), wraps the site
+     * into an iframe THEN, loading the clicked page, so the session persists from that point on.
+     *
+     * Only anchor clicks are caught. Programmatic navigation (`location.assign`, `location.href=`),
+     * address-bar/bookmark loads, modified/`_blank` clicks, and links matched by `persistConfig`
+     * fall through to a normal top-level navigation, which ends the session (as a plain widget would).
+     *
+     * Default: `false` (wrap eagerly on connect). Ignored unless `persist` is on.
+     */
+    frameOnNavigate?: boolean;
     /**
      * The ONLY URLs that break out of the iframe (open at the top window and end the session).
      * A link is opened inside the iframe unless it matches this denylist — use it for URLs that

package/lib/types/index.d.ts

@@ -379,6 +379,14 @@ export interface NapsterCompanionApiInstance {
     avatarIsVisible: () => boolean;
     /** Tear down the SDK, remove DOM nodes and clean up resources. */
     destroy: () => void;
+    /**
+     * Re-target the Edge MCP bridge at runtime: read the site's WebMCP tools from the given
+     * same-origin iframe's `document.modelContext`, or pass `null` to read them from this
+     * window's document. Used by the persistent-agent shell's frame-on-navigate mode, where
+     * the site is only wrapped in an iframe on the first navigation. No-op if the bridge is
+     * inactive.
+     */
+    setEdgeMcpIframe: (iframe: HTMLIFrameElement | null) => void;
     /**
      * The current session identifier. Available after a connection is established
      * and reset to `undefined` once the connection is closed.

package/lib/utils/PiPManager.d.ts

@@ -1,6 +1,8 @@
 export interface PiPController {
     destroy: () => void;
 }
+export declare function checkPiPSupport(): boolean;
+export declare function resetPiPSupportCache(): void;
 /**
  * Creates a PiP controller that opens a Document Picture-in-Picture window
  * via Media Session API when the user switches tabs, and closes it on return.

package/package.json

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