@holostaff/sdk 0.4.0 → 0.9.0

package/dist/stage/realtime.js

@@ -0,0 +1,165 @@
+/**
+ * Realtime session — P6 (copilot-voice-stage-design.md §1, §2).
+ *
+ * The conversational brain + ears: GPT/Azure Realtime over WebRTC. It
+ * owns the mic (STT), runs the LLM, does turn-taking / VAD / barge-in,
+ * and — in **text mode** (modalities: ['text']) — emits TEXT deltas +
+ * tool calls over the data channel. NO audio output: the spoken voice is
+ * Anam's native TTS, fed the text (Path A). This is the de-Vue-ified
+ * port of tutorLM's useWebRTC + useToolDataChannel.
+ */
+export async function connectRealtime(opts, cb) {
+    const pc = new RTCPeerConnection();
+    // Mic in (STT). No remote audio track is consumed — text mode.
+    for (const track of opts.micStream.getAudioTracks())
+        pc.addTrack(track, opts.micStream);
+    const dc = pc.createDataChannel('oai-events');
+    let turnId = mintTurnId();
+    const send = (obj) => {
+        try {
+            if (dc.readyState === 'open')
+                dc.send(JSON.stringify(obj));
+        }
+        catch { /* closed */ }
+    };
+    dc.addEventListener('open', () => {
+        // Configure the session: text-only out, server VAD (barge-in),
+        // input transcription, and our tool surface.
+        send({
+            type: 'session.update',
+            session: {
+                modalities: ['text'],
+                ...(opts.instructions ? { instructions: opts.instructions } : {}),
+                tools: opts.tools.map(t => ({
+                    type: 'function',
+                    name: t.name,
+                    description: t.description,
+                    parameters: t.parameters,
+                })),
+                tool_choice: 'auto',
+                input_audio_transcription: { model: 'whisper-1' },
+                turn_detection: { type: 'server_vad', threshold: 0.5, silence_duration_ms: 500 },
+            },
+        });
+        // If opened from a suggestion, seed the opening turn with it.
+        if (opts.seedMessage) {
+            send({
+                type: 'conversation.item.create',
+                item: {
+                    type: 'message',
+                    role: 'user',
+                    content: [{ type: 'input_text', text: opts.seedMessage }],
+                },
+            });
+        }
+        // Greet first — the copilot opens by speaking (instructions say how).
+        send({ type: 'response.create' });
+    });
+    dc.addEventListener('message', (ev) => {
+        let msg;
+        try {
+            msg = JSON.parse(ev.data);
+        }
+        catch {
+            return;
+        }
+        handleServerEvent(msg);
+    });
+    const handleServerEvent = (msg) => {
+        switch (msg.type) {
+            // Text deltas — naming varies across Realtime versions.
+            case 'response.text.delta':
+            case 'response.output_text.delta':
+                if (typeof msg.delta === 'string')
+                    cb.onTextDelta(msg.delta, turnId);
+                break;
+            case 'response.text.done':
+            case 'response.output_text.done':
+            case 'response.done':
+                cb.onTurnDone(turnId);
+                turnId = mintTurnId();
+                break;
+            case 'input_audio_buffer.speech_started':
+                cb.onUserSpeechStarted();
+                break;
+            case 'response.function_call_arguments.done': {
+                const name = typeof msg.name === 'string' ? msg.name : '';
+                const callId = typeof msg.call_id === 'string' ? msg.call_id : '';
+                let args = {};
+                if (typeof msg.arguments === 'string') {
+                    try {
+                        args = JSON.parse(msg.arguments);
+                    }
+                    catch { /* keep {} */ }
+                }
+                if (name && callId)
+                    cb.onToolCall({ name, args, callId });
+                break;
+            }
+            case 'error':
+                cb.onError(new Error(typeof msg.error === 'object' && msg.error ? JSON.stringify(msg.error) : 'realtime error'));
+                break;
+        }
+    };
+    // SDP offer → answer exchange using the ephemeral key.
+    const offer = await pc.createOffer();
+    await pc.setLocalDescription(offer);
+    await waitForIceGathering(pc);
+    const sdpRes = await fetch(`${opts.realtimeUrl}?model=${encodeURIComponent(opts.realtimeModel)}`, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${opts.ephemeralKey}`,
+            'Content-Type': 'application/sdp',
+        },
+        body: pc.localDescription?.sdp ?? offer.sdp ?? '',
+    });
+    if (!sdpRes.ok) {
+        pc.close();
+        throw new Error(`realtime SDP ${sdpRes.status}: ${(await sdpRes.text().catch(() => '')).slice(0, 200)}`);
+    }
+    const answer = await sdpRes.text();
+    await pc.setRemoteDescription({ type: 'answer', sdp: answer });
+    return {
+        sendToolResult(callId, output) {
+            send({
+                type: 'conversation.item.create',
+                item: {
+                    type: 'function_call_output',
+                    call_id: callId,
+                    output: typeof output === 'string' ? output : JSON.stringify(output),
+                },
+            });
+            send({ type: 'response.create' });
+        },
+        close() {
+            try {
+                dc.close();
+            }
+            catch { /* */ }
+            try {
+                pc.close();
+            }
+            catch { /* */ }
+        },
+    };
+}
+function mintTurnId() {
+    return `turn_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
+}
+/** Resolve once ICE gathering completes (or after a short cap) so the
+ *  offer SDP carries candidates. */
+function waitForIceGathering(pc) {
+    if (pc.iceGatheringState === 'complete')
+        return Promise.resolve();
+    return new Promise(resolve => {
+        const done = () => {
+            pc.removeEventListener('icegatheringstatechange', check);
+            resolve();
+        };
+        const check = () => { if (pc.iceGatheringState === 'complete')
+            done(); };
+        pc.addEventListener('icegatheringstatechange', check);
+        setTimeout(done, 1500); // cap — don't block on slow networks
+    });
+}
+//# sourceMappingURL=realtime.js.map

package/dist/stage/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../src/stage/realtime.ts"],"names":[],"mappings":"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"}

package/dist/stage/ui.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Stage panel UI — P6 (copilot-presence-design.md §2.3).
+ *
+ * A bottom sheet that grows from the chip: the copilot's live Anam avatar
+ * fills it, with name + scope beneath; listening / thinking / speaking
+ * are expressed through state, not spinners. Captions (output text) are
+ * an accessibility toggle that never violates the no-text-INPUT rule.
+ * Shadow-DOM isolated, vanilla.
+ */
+import type { DockCorner } from '../types.js';
+export type StageState = 'connecting' | 'listening' | 'thinking' | 'speaking';
+export interface StageUiDeps {
+    dock: DockCorner;
+    copilotName: string;
+    scopeLine?: string;
+    onClose: () => void;
+}
+export interface StageUi {
+    /** The <video> Anam binds to. */
+    video: HTMLVideoElement;
+    setState(state: StageState): void;
+    appendCaption(text: string): void;
+    /** Toggle the visible state ring + label. */
+    destroy(): void;
+}
+export declare function startStageUi(deps: StageUiDeps): StageUi;
+//# sourceMappingURL=ui.d.ts.map

package/dist/stage/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/stage/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAA;AAI7E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,iCAAiC;IACjC,KAAK,EAAE,gBAAgB,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACjC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,6CAA6C;IAC7C,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAgHvD"}

package/dist/stage/ui.js

@@ -0,0 +1,176 @@
+/**
+ * Stage panel UI — P6 (copilot-presence-design.md §2.3).
+ *
+ * A bottom sheet that grows from the chip: the copilot's live Anam avatar
+ * fills it, with name + scope beneath; listening / thinking / speaking
+ * are expressed through state, not spinners. Captions (output text) are
+ * an accessibility toggle that never violates the no-text-INPUT rule.
+ * Shadow-DOM isolated, vanilla.
+ */
+const CONTAINER_ID = 'holostaff-stage-root';
+export function startStageUi(deps) {
+    const container = ensureContainer();
+    const root = container.shadowRoot;
+    root.innerHTML = '';
+    root.appendChild(styleNode(deps.dock));
+    const reducedMotion = typeof window.matchMedia === 'function'
+        && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+    const sheet = document.createElement('div');
+    sheet.className = `sheet enter ${deps.dock}`;
+    sheet.setAttribute('role', 'dialog');
+    sheet.setAttribute('aria-label', `Conversation with ${deps.copilotName}`);
+    // Avatar
+    const stageArea = document.createElement('div');
+    stageArea.className = 'avatar-area';
+    const video = document.createElement('video');
+    video.className = 'avatar-video';
+    video.autoplay = true;
+    video.playsInline = true;
+    video.setAttribute('playsinline', '');
+    // Anam provides the audio; this element is NOT muted.
+    stageArea.appendChild(video);
+    const ring = document.createElement('div');
+    ring.className = 'state-ring';
+    stageArea.appendChild(ring);
+    // Header
+    const head = document.createElement('div');
+    head.className = 'head';
+    const idBlock = document.createElement('div');
+    idBlock.className = 'idblock';
+    const nameEl = document.createElement('div');
+    nameEl.className = 'name';
+    nameEl.textContent = deps.copilotName;
+    idBlock.appendChild(nameEl);
+    if (deps.scopeLine) {
+        const scope = document.createElement('div');
+        scope.className = 'scope';
+        scope.textContent = deps.scopeLine;
+        idBlock.appendChild(scope);
+    }
+    head.appendChild(idBlock);
+    const ccBtn = document.createElement('button');
+    ccBtn.className = 'cc';
+    ccBtn.type = 'button';
+    ccBtn.setAttribute('aria-pressed', 'false');
+    ccBtn.title = 'Captions';
+    ccBtn.textContent = 'CC';
+    head.appendChild(ccBtn);
+    const closeBtn = document.createElement('button');
+    closeBtn.className = 'x';
+    closeBtn.type = 'button';
+    closeBtn.setAttribute('aria-label', 'End conversation');
+    closeBtn.textContent = '✕';
+    closeBtn.addEventListener('click', () => deps.onClose());
+    head.appendChild(closeBtn);
+    // State label + captions
+    const stateLabel = document.createElement('div');
+    stateLabel.className = 'state-label';
+    stateLabel.textContent = 'Connecting…';
+    const captions = document.createElement('div');
+    captions.className = 'captions';
+    captions.setAttribute('aria-live', 'polite');
+    let ccOn = false;
+    ccBtn.addEventListener('click', () => {
+        ccOn = !ccOn;
+        ccBtn.setAttribute('aria-pressed', String(ccOn));
+        ccBtn.classList.toggle('on', ccOn);
+        captions.classList.toggle('show', ccOn);
+    });
+    const hint = document.createElement('div');
+    hint.className = 'hint';
+    hint.textContent = "Can't talk right now? Turn on captions, or use the suggestion buttons.";
+    sheet.append(head, stageArea, stateLabel, captions, hint);
+    root.appendChild(sheet);
+    if (reducedMotion)
+        sheet.classList.remove('enter');
+    else
+        requestAnimationFrame(() => requestAnimationFrame(() => sheet.classList.remove('enter')));
+    const setState = (state) => {
+        sheet.setAttribute('data-state', state);
+        stateLabel.textContent = ({
+            connecting: 'Connecting…',
+            listening: 'Listening…',
+            thinking: 'Thinking…',
+            speaking: deps.copilotName + ' is speaking',
+        })[state];
+    };
+    return {
+        video,
+        setState,
+        appendCaption(text) {
+            // Append to the current line; sentence breaks create new lines.
+            captions.textContent = (captions.textContent ?? '') + text;
+            captions.scrollTop = captions.scrollHeight;
+        },
+        destroy() {
+            sheet.classList.add('exit');
+            setTimeout(() => { try {
+                container.remove();
+            }
+            catch { /* gone */ } }, reducedMotion ? 0 : 220);
+        },
+    };
+}
+function ensureContainer() {
+    let el = document.getElementById(CONTAINER_ID);
+    if (el)
+        return el;
+    el = document.createElement('div');
+    el.id = CONTAINER_ID;
+    el.style.cssText = 'position:fixed;inset:0;z-index:2147483646;pointer-events:none';
+    el.attachShadow({ mode: 'open' });
+    document.body.appendChild(el);
+    return el;
+}
+function styleNode(dock) {
+    const node = document.createElement('style');
+    const onRight = dock.endsWith('right');
+    const side = onRight ? 'right: 20px;' : 'left: 20px;';
+    const origin = `${dock.startsWith('bottom') ? 'bottom' : 'top'} ${onRight ? 'right' : 'left'}`;
+    node.textContent = `
+    :host { all: initial; }
+    .sheet {
+      pointer-events: auto;
+      position: fixed; ${side} bottom: 20px;
+      width: 380px; max-width: calc(100vw - 32px);
+      height: 560px; max-height: calc(100vh - 40px);
+      background: #0e0f12; color: #fafafa;
+      border-radius: 20px; overflow: hidden;
+      box-shadow: 0 24px 64px rgba(0,0,0,0.45);
+      display: flex; flex-direction: column;
+      font: 14px/1.5 -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;
+      transform-origin: ${origin};
+      opacity: 1; transition: opacity 220ms ease-out, transform 220ms cubic-bezier(0.16,1,0.3,1);
+    }
+    .sheet.enter { opacity: 0; transform: scale(0.9) translateY(12px); }
+    .sheet.exit  { opacity: 0; transform: scale(0.92) translateY(12px); }
+    @media (max-width: 480px) {
+      .sheet { left: 0; right: 0; bottom: 0; width: 100%; height: 88vh; border-radius: 20px 20px 0 0; }
+    }
+    .head { display: flex; align-items: center; gap: 10px; padding: 14px 16px; }
+    .idblock { flex: 1; min-width: 0; }
+    .name { font-weight: 600; font-size: 15px; }
+    .scope { font-size: 12px; color: #9aa0aa; margin-top: 1px; }
+    .cc, .x { appearance: none; border: 0; background: rgba(255,255,255,0.08); color: #cfd2d8; cursor: pointer; border-radius: 8px; }
+    .cc { font-size: 11px; font-weight: 700; padding: 5px 8px; }
+    .cc.on { background: #4f8bff; color: #fff; }
+    .x { font-size: 14px; padding: 6px 9px; }
+    .cc:hover, .x:hover { background: rgba(255,255,255,0.16); }
+    .avatar-area { position: relative; flex: 1; min-height: 0; background: #16181d; display: flex; align-items: center; justify-content: center; }
+    .avatar-video { width: 100%; height: 100%; object-fit: cover; }
+    .state-ring {
+      position: absolute; inset: 0; pointer-events: none;
+      box-shadow: inset 0 0 0 0 rgba(79,139,255,0); transition: box-shadow 200ms ease-out;
+    }
+    .sheet[data-state="listening"] .state-ring { box-shadow: inset 0 0 0 3px rgba(79,139,255,0.7); }
+    .sheet[data-state="thinking"] .state-ring { box-shadow: inset 0 0 0 3px rgba(255,255,255,0.25); }
+    .sheet[data-state="speaking"] .state-ring { box-shadow: inset 0 0 0 3px rgba(120,220,160,0.6); }
+    .state-label { padding: 10px 16px 0; font-size: 12px; color: #9aa0aa; }
+    .captions { display: none; padding: 8px 16px; max-height: 96px; overflow-y: auto; color: #e8e8ea; font-size: 14px; }
+    .captions.show { display: block; }
+    .hint { padding: 8px 16px 14px; font-size: 11px; color: #6b7280; }
+    @media (prefers-reduced-motion: reduce) { .sheet { transition: none; } }
+  `;
+    return node;
+}
+//# sourceMappingURL=ui.js.map

package/dist/stage/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/stage/ui.ts"],"names":[],"mappings":"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"}

package/dist/theater/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Theater overlay — P5 (copilot-theater-design.md §4).
+ *
+ * The fourth magnitude: a dimmed scrim + a sandboxed <iframe> hosting the
+ * Holostaff Theater micro-app, with the copilot's portrait composited on
+ * top as the presenter. Near-zero SDK weight — all the render/stream
+ * machinery lives in the iframe app we host; the SDK only injects the
+ * iframe and speaks the postMessage protocol:
+ *
+ *   SDK → iframe : { type:'theme', tokens } · { type:'present', payload }
+ *                  { type:'highlight', elementId } · { type:'reset' }
+ *   iframe → SDK : { type:'theater-ready' | 'theater-frame-done'
+ *                          | 'theater-error' | 'theater-close' }
+ *
+ * CSP degrade (§4.1): if the host's `frame-src` blocks our domain the
+ * iframe never reaches 'theater-ready'; we time out, mark the Theater
+ * unavailable, and the copilot falls back to telling (note / voice).
+ */
+import type { PresenceBinding } from '../presence/index.js';
+export interface TheaterDeps {
+    /** Theater service origin, e.g. https://theater.holostaff.ai */
+    baseUrl: string;
+    /** Resolves the runtime context for /present payloads. */
+    buildContext: () => {
+        tenantId: string;
+        sourceId: string;
+        sessionId: string;
+    };
+    /** Presence — portrait composite + design tokens + copilot identity. */
+    presence: PresenceBinding;
+    onError?: (err: Error) => void;
+}
+export interface PresentRequest {
+    intent: string;
+    context?: string;
+}
+export interface TheaterBinding {
+    present(req: PresentRequest): void;
+    highlight(elementId: string): void;
+    close(): void;
+    /** False once a CSP block has been detected for this host. */
+    isAvailable(): boolean;
+    dispose(): void;
+}
+export declare function startTheater(deps: TheaterDeps): TheaterBinding;
+//# sourceMappingURL=index.d.ts.map

package/dist/theater/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theater/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAK3D,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,YAAY,EAAE,MAAM;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7E,wEAAwE;IACxE,QAAQ,EAAE,eAAe,CAAA;IACzB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAAA;IAClC,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,KAAK,IAAI,IAAI,CAAA;IACb,8DAA8D;IAC9D,WAAW,IAAI,OAAO,CAAA;IACtB,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CAmK9D"}

package/dist/theater/index.js

@@ -0,0 +1,222 @@
+/**
+ * Theater overlay — P5 (copilot-theater-design.md §4).
+ *
+ * The fourth magnitude: a dimmed scrim + a sandboxed <iframe> hosting the
+ * Holostaff Theater micro-app, with the copilot's portrait composited on
+ * top as the presenter. Near-zero SDK weight — all the render/stream
+ * machinery lives in the iframe app we host; the SDK only injects the
+ * iframe and speaks the postMessage protocol:
+ *
+ *   SDK → iframe : { type:'theme', tokens } · { type:'present', payload }
+ *                  { type:'highlight', elementId } · { type:'reset' }
+ *   iframe → SDK : { type:'theater-ready' | 'theater-frame-done'
+ *                          | 'theater-error' | 'theater-close' }
+ *
+ * CSP degrade (§4.1): if the host's `frame-src` blocks our domain the
+ * iframe never reaches 'theater-ready'; we time out, mark the Theater
+ * unavailable, and the copilot falls back to telling (note / voice).
+ */
+const READY_TIMEOUT_MS = 6000;
+const SCRIM_ID = 'holostaff-theater-root';
+export function startTheater(deps) {
+    if (typeof window === 'undefined' || typeof document === 'undefined') {
+        return inert();
+    }
+    const origin = safeOrigin(deps.baseUrl);
+    let scrim = null;
+    let iframe = null;
+    let ready = false;
+    let available = true;
+    let readyTimer = null;
+    let pending = null;
+    const onMessage = (ev) => {
+        if (origin && ev.origin !== origin)
+            return;
+        const m = ev.data;
+        if (!m || typeof m.type !== 'string')
+            return;
+        switch (m.type) {
+            case 'theater-ready':
+                ready = true;
+                if (readyTimer) {
+                    clearTimeout(readyTimer);
+                    readyTimer = null;
+                }
+                sendTheme();
+                if (pending) {
+                    sendPresent(pending);
+                    pending = null;
+                }
+                break;
+            case 'theater-close':
+                close();
+                break;
+            case 'theater-error':
+                deps.onError?.(new Error(`Theater: ${m.error ?? 'render error'}`));
+                break;
+        }
+    };
+    window.addEventListener('message', onMessage);
+    const ensureOverlay = () => {
+        if (scrim)
+            return;
+        scrim = document.createElement('div');
+        scrim.id = SCRIM_ID;
+        scrim.style.cssText = [
+            'position:fixed', 'inset:0', 'z-index:2147483647',
+            'background:rgba(8,9,12,0.62)', 'backdrop-filter:blur(2px)',
+            'opacity:0', 'transition:opacity 200ms ease-out',
+        ].join(';');
+        iframe = document.createElement('iframe');
+        iframe.title = 'Copilot presentation';
+        // Run scripts + talk to the Theater backend (same origin as the
+        // iframe = our service), but no access to the host page or top nav.
+        iframe.setAttribute('sandbox', 'allow-scripts allow-same-origin');
+        iframe.style.cssText = [
+            'position:absolute', 'inset:0', 'width:100%', 'height:100%',
+            'border:0', 'background:transparent',
+        ].join(';');
+        iframe.addEventListener('error', () => markUnavailable());
+        // Close affordance (always visible — design §2.4).
+        const closeBtn = document.createElement('button');
+        closeBtn.type = 'button';
+        closeBtn.setAttribute('aria-label', 'Close presentation');
+        closeBtn.textContent = '✕';
+        closeBtn.style.cssText = [
+            'position:absolute', 'top:18px', 'right:20px', 'z-index:2',
+            'width:40px', 'height:40px', 'border-radius:50%', 'border:0',
+            'background:rgba(255,255,255,0.14)', 'color:#fff', 'font-size:16px',
+            'cursor:pointer',
+        ].join(';');
+        closeBtn.addEventListener('click', () => close());
+        scrim.addEventListener('click', (e) => { if (e.target === scrim)
+            close(); });
+        scrim.append(iframe, closeBtn, presenterPortrait());
+        document.body.appendChild(scrim);
+        requestAnimationFrame(() => { if (scrim)
+            scrim.style.opacity = '1'; });
+        // Load the app shell + arm the CSP-block timeout.
+        ready = false;
+        iframe.src = `${deps.baseUrl.replace(/\/$/, '')}/theater/app`;
+        readyTimer = setTimeout(() => { if (!ready)
+            markUnavailable(); }, READY_TIMEOUT_MS);
+    };
+    const sendTheme = () => {
+        const tokens = deps.presence.getDesignTokens();
+        post({ type: 'theme', tokens });
+    };
+    const sendPresent = (req) => {
+        const ctx = deps.buildContext();
+        const copilot = deps.presence.getCopilot();
+        post({
+            type: 'present',
+            payload: {
+                ...ctx,
+                copilotId: copilot?.copilotId,
+                copilotName: copilot?.name,
+                intent: req.intent,
+                context: req.context,
+            },
+        });
+    };
+    const post = (msg) => {
+        try {
+            iframe?.contentWindow?.postMessage(msg, origin || '*');
+        }
+        catch { /* gone */ }
+    };
+    const presenterPortrait = () => {
+        // Pin the copilot as the presenter (design §2.4). Static here; the
+        // Stage (P6) upgrades this to the live Anam avatar narrating.
+        const wrap = document.createElement('div');
+        wrap.style.cssText = [
+            'position:absolute', 'left:24px', 'bottom:24px', 'z-index:2',
+            'width:72px', 'height:72px', 'border-radius:50%', 'overflow:hidden',
+            'box-shadow:0 8px 24px rgba(0,0,0,0.4)', 'background:#1a1a1a',
+        ].join(';');
+        const c = deps.presence.getCopilot();
+        const portrait = c?.portrait;
+        if (portrait?.idle || portrait?.idleMp4 || portrait?.poster) {
+            const v = document.createElement('video');
+            v.muted = true;
+            v.loop = true;
+            v.autoplay = true;
+            v.playsInline = true;
+            v.setAttribute('playsinline', '');
+            v.style.cssText = 'width:100%;height:100%;object-fit:cover';
+            if (portrait.poster)
+                v.poster = portrait.poster;
+            const src = portrait.idle || portrait.idleMp4;
+            if (src) {
+                v.src = src;
+                void v.play().catch(() => { });
+            }
+            wrap.appendChild(v);
+        }
+        else if (c?.avatar) {
+            const img = document.createElement('img');
+            img.src = c.avatar;
+            img.alt = '';
+            img.referrerPolicy = 'no-referrer';
+            img.style.cssText = 'width:100%;height:100%;object-fit:cover';
+            wrap.appendChild(img);
+        }
+        return wrap;
+    };
+    const markUnavailable = () => {
+        available = false;
+        deps.onError?.(new Error('Theater unavailable (likely host frame-src CSP). Falling back to telling.'));
+        close();
+    };
+    const close = () => {
+        if (readyTimer) {
+            clearTimeout(readyTimer);
+            readyTimer = null;
+        }
+        if (!scrim)
+            return;
+        const node = scrim;
+        scrim = null;
+        iframe = null;
+        ready = false;
+        pending = null;
+        node.style.opacity = '0';
+        setTimeout(() => { try {
+            node.remove();
+        }
+        catch { /* gone */ } }, 200);
+    };
+    return {
+        present(req) {
+            if (!available || !req?.intent)
+                return;
+            ensureOverlay();
+            if (ready)
+                sendPresent(req);
+            else
+                pending = req; // sent on theater-ready
+        },
+        highlight(elementId) { post({ type: 'highlight', elementId }); },
+        close,
+        isAvailable: () => available,
+        dispose() {
+            window.removeEventListener('message', onMessage);
+            close();
+        },
+    };
+}
+function safeOrigin(url) {
+    try {
+        return new URL(url).origin;
+    }
+    catch {
+        return '';
+    }
+}
+function inert() {
+    return {
+        present: () => { }, highlight: () => { }, close: () => { },
+        isAvailable: () => false, dispose: () => { },
+    };
+}
+//# sourceMappingURL=index.js.map