@holostaff/sdk 0.4.0 → 0.9.0

package/dist/presence/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Presence binding — P2. Subscribes to the `presence` SSE event and
+ * drives the living-portrait chip's identity. Holds the current copilot
+ * + design tokens as shared state the note (P3), handoff ritual (P4),
+ * and Stage (P6) all read.
+ *
+ * The chip is the resting magnitude of the copilot; everything else
+ * (note, Stage, Theater) grows from it, so this binding is the anchor
+ * the other surfaces attach to.
+ */
+import type { TransportConfig } from '../transport.js';
+import { type ChipInstance } from './chip.js';
+import type { DesignTokens, PresenceCopilot, PresenceOptions } from './types.js';
+export interface PresenceDeps {
+    cfg: TransportConfig;
+    getSessionId: () => string;
+    buildBody: () => Record<string, unknown>;
+    /** The SDK's already-open SSE channel. */
+    source: EventSource | null;
+    options?: PresenceOptions;
+}
+export interface PresenceBinding {
+    dispose(): void;
+    /** The live chip instance (note/Stage anchor + gesture control). */
+    chip: ChipInstance | null;
+    /** Current copilot identity, or null when none covers the stage. */
+    getCopilot(): PresenceCopilot | null;
+    /** Host design tokens from the last presence event (Theater theming). */
+    getDesignTokens(): DesignTokens | null;
+    /** Register a click→activate handler (the Stage, wired in P6). */
+    onActivate(handler: (copilot: PresenceCopilot) => void): void;
+}
+export declare function startPresence(deps: PresenceDeps): PresenceBinding;
+export type { PresenceCopilot, DesignTokens, PresenceOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presence/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AACxD,OAAO,KAAK,EACW,YAAY,EAAE,eAAe,EAAiB,eAAe,EACnF,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,eAAe,CAAA;IACpB,YAAY,EAAE,MAAM,MAAM,CAAA;IAC1B,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,0CAA0C;IAC1C,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;IAC1B,OAAO,CAAC,EAAE,eAAe,CAAA;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,IAAI,CAAA;IACf,oEAAoE;IACpE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAA;IACzB,oEAAoE;IACpE,UAAU,IAAI,eAAe,GAAG,IAAI,CAAA;IACpC,yEAAyE;IACzE,eAAe,IAAI,YAAY,GAAG,IAAI,CAAA;IACtC,kEAAkE;IAClE,UAAU,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI,CAAA;CAC9D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,CA6DjE;AAYD,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA"}

package/dist/presence/index.js

@@ -0,0 +1,81 @@
+/**
+ * Presence binding — P2. Subscribes to the `presence` SSE event and
+ * drives the living-portrait chip's identity. Holds the current copilot
+ * + design tokens as shared state the note (P3), handoff ritual (P4),
+ * and Stage (P6) all read.
+ *
+ * The chip is the resting magnitude of the copilot; everything else
+ * (note, Stage, Theater) grows from it, so this binding is the anchor
+ * the other surfaces attach to.
+ */
+import { startChip } from './chip.js';
+export function startPresence(deps) {
+    const opts = deps.options ?? {};
+    if (opts.enabled === false || typeof window === 'undefined' || !deps.source) {
+        return inertBinding();
+    }
+    let copilot = null;
+    let tokens = null;
+    let activateHandler = null;
+    const chip = startChip({
+        dock: opts.dock ?? 'bottom-right',
+        offset: opts.offset ?? 16,
+        onActivate: (c) => activateHandler?.(c),
+    });
+    // `presence` — set identity, no ritual (connect / reconnect).
+    const onPresence = (raw) => {
+        let event = null;
+        try {
+            event = JSON.parse(raw.data);
+        }
+        catch {
+            return;
+        }
+        if (!event)
+            return;
+        copilot = event.copilot ?? null;
+        tokens = event.designTokens ?? null;
+        chip.setCopilot(copilot, tokens);
+    };
+    // `copilot_changed` — the handoff ritual (P4): crossfade to the new
+    // copilot + greeting gesture. First meeting waves; otherwise nods.
+    // (The intro note is rendered by the note binding off the same event.)
+    const onCopilotChanged = (raw) => {
+        let event = null;
+        try {
+            event = JSON.parse(raw.data);
+        }
+        catch {
+            return;
+        }
+        if (!event || !event.copilot)
+            return;
+        copilot = event.copilot;
+        tokens = event.designTokens ?? tokens;
+        chip.setCopilot(copilot, tokens);
+        chip.playGesture(event.firstMeeting ? 'wave' : 'nod');
+    };
+    deps.source.addEventListener('presence', onPresence);
+    deps.source.addEventListener('copilot_changed', onCopilotChanged);
+    return {
+        chip,
+        dispose() {
+            deps.source?.removeEventListener('presence', onPresence);
+            deps.source?.removeEventListener('copilot_changed', onCopilotChanged);
+            chip.destroy();
+        },
+        getCopilot: () => copilot,
+        getDesignTokens: () => tokens,
+        onActivate(handler) { activateHandler = handler; },
+    };
+}
+function inertBinding() {
+    return {
+        chip: null,
+        dispose: () => { },
+        getCopilot: () => null,
+        getDesignTokens: () => null,
+        onActivate: () => { },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/presence/index.js.map

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

package/dist/presence/note.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The note — the initiative magnitude (copilot-presence-design.md §2.2).
+ *
+ * The written suggestion the portrait "leaves for you." Replaces the v1
+ * widget card (sdk/src/widget.ts). Grows from the chip, the chip glances
+ * at it on arrival, and its ignore timing is *attention-gated* — the
+ * countdown starts only once there's evidence the visitor is conscious of
+ * the page, so reading slowly or being deep in a task never reads as
+ * "ignored."
+ *
+ *   ✕                         → dismissed
+ *   attention-gated timeout   → ignored
+ *   "Got it" / action verb    → engaged
+ *   "Show me"  (P5 Theater)   → engaged + opens the Theater
+ *   "Talk"     (P6 Stage)     → engaged + opens the Stage
+ *
+ * Carried from v1: stale-route guard, one-note-at-a-time, animated out +
+ * removed from the DOM, aria-live=polite, reduced-motion variants.
+ */
+import { type TransportConfig } from '../transport.js';
+import type { DockCorner } from '../types.js';
+import type { PresenceBinding } from './index.js';
+export interface NoteDeps {
+    cfg: TransportConfig;
+    getSessionId: () => string;
+    buildBody: () => Record<string, unknown>;
+    source: EventSource | null;
+    /** Chip anchor + gesture control + copilot identity. */
+    presence: PresenceBinding;
+    dock: DockCorner;
+}
+export interface NoteBinding {
+    dispose(): void;
+    /** Register the "Show me" → Theater handler (P5). */
+    onShow(handler: NoteActionHandler): void;
+    /** Register the "Talk" → Stage handler (P6). */
+    onTalk(handler: NoteActionHandler): void;
+}
+export type NoteActionHandler = (ctx: NoteActionContext) => void;
+export interface NoteActionContext {
+    interventionId: string;
+    goal: string;
+    content: string;
+    stage: string | null;
+}
+export declare function startNote(deps: NoteDeps): NoteBinding;
+//# sourceMappingURL=note.d.ts.map

package/dist/presence/note.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note.d.ts","sourceRoot":"","sources":["../../src/presence/note.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,KAAK,EAAuB,UAAU,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAcjD,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,eAAe,CAAA;IACpB,YAAY,EAAE,MAAM,MAAM,CAAA;IAC1B,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;IAC1B,wDAAwD;IACxD,QAAQ,EAAE,eAAe,CAAA;IACzB,IAAI,EAAE,UAAU,CAAA;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,IAAI,IAAI,CAAA;IACf,qDAAqD;IACrD,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACxC,gDAAgD;IAChD,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAA;CACzC;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAA;AAChE,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAYD,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,CAiFrD"}

package/dist/presence/note.js

@@ -0,0 +1,501 @@
+/**
+ * The note — the initiative magnitude (copilot-presence-design.md §2.2).
+ *
+ * The written suggestion the portrait "leaves for you." Replaces the v1
+ * widget card (sdk/src/widget.ts). Grows from the chip, the chip glances
+ * at it on arrival, and its ignore timing is *attention-gated* — the
+ * countdown starts only once there's evidence the visitor is conscious of
+ * the page, so reading slowly or being deep in a task never reads as
+ * "ignored."
+ *
+ *   ✕                         → dismissed
+ *   attention-gated timeout   → ignored
+ *   "Got it" / action verb    → engaged
+ *   "Show me"  (P5 Theater)   → engaged + opens the Theater
+ *   "Talk"     (P6 Stage)     → engaged + opens the Stage
+ *
+ * Carried from v1: stale-route guard, one-note-at-a-time, animated out +
+ * removed from the DOM, aria-live=polite, reduced-motion variants.
+ */
+import { postJson } from '../transport.js';
+/** Attention-gated ignore budget (design §2.2): countdown of 45s, armed
+ *  on the first interaction-after-render or a 15s grace, paused on
+ *  hover/focus + hidden tab. */
+const IGNORE_BUDGET_MS = 45000;
+const ARM_GRACE_MS = 15000;
+const ENTER_MS = 260;
+const EXIT_MS = 200;
+/** Intro note (P4 handoff) auto-dismiss — design §4. */
+const INTRO_DISMISS_MS = 12000;
+const CONTAINER_ID = 'holostaff-note-root';
+export function startNote(deps) {
+    if (typeof window === 'undefined' || !deps.source) {
+        return { dispose: () => { }, onShow: () => { }, onTalk: () => { } };
+    }
+    let current = null;
+    let showHandler = null;
+    let talkHandler = null;
+    const reportOutcome = (interventionId, outcome) => {
+        void postJson(deps.cfg, `/api/runtime/sessions/${deps.getSessionId()}/outcome`, {
+            ...deps.buildBody(),
+            interventionId,
+            outcome,
+        });
+    };
+    const onFire = (raw) => {
+        let parsed = null;
+        try {
+            const data = JSON.parse(raw.data);
+            if (!data || typeof data.interventionId !== 'string')
+                return;
+            parsed = data;
+        }
+        catch {
+            return;
+        }
+        if (!parsed)
+            return;
+        // Modality gate — text renders a normal note; voice_presentation
+        // renders a note whose primary CTA is "Show me" → the Theater (P5).
+        if (parsed.modality !== 'text' && parsed.modality !== 'voice_presentation') {
+            deps.cfg.onError?.(new Error(`Modality '${parsed.modality}' is not supported in this SDK build`), { method: 'NOTE', path: '(fire_intervention)' });
+            return;
+        }
+        // Stale-fire guard — decided for a route the visitor already left.
+        if (parsed.route) {
+            const decidedPath = parsed.route.split('?')[0];
+            if (decidedPath && decidedPath !== window.location.pathname) {
+                reportOutcome(parsed.interventionId, 'ignored');
+                return;
+            }
+        }
+        // One note at a time — retire the old as 'ignored'.
+        if (current)
+            current.close('ignored');
+        current = renderNote(deps, parsed, { showHandler, talkHandler }, () => {
+            if (current && current.event.interventionId === parsed.interventionId)
+                current = null;
+        });
+    };
+    // Intro note on first meeting (P4). Never interrupts an open note
+    // (design §4: "never mid-card"); the intro is low-stakes + once-per-pair.
+    const onCopilotChanged = (raw) => {
+        let event = null;
+        try {
+            event = JSON.parse(raw.data);
+        }
+        catch {
+            return;
+        }
+        if (!event || !event.firstMeeting || !event.copilot?.intro)
+            return;
+        if (current)
+            return; // a card is open — skip rather than queue
+        current = renderIntro(deps, event, () => { current = null; });
+    };
+    deps.source.addEventListener('fire_intervention', onFire);
+    deps.source.addEventListener('copilot_changed', onCopilotChanged);
+    return {
+        dispose() {
+            deps.source?.removeEventListener('fire_intervention', onFire);
+            deps.source?.removeEventListener('copilot_changed', onCopilotChanged);
+            current?.detach();
+            current = null;
+        },
+        onShow(handler) { showHandler = handler; },
+        onTalk(handler) { talkHandler = handler; },
+    };
+}
+function renderNote(deps, event, handlers, onClosed) {
+    const container = ensureContainer();
+    positionContainer(container, deps);
+    const root = container.shadowRoot;
+    root.innerHTML = '';
+    const reducedMotion = typeof window.matchMedia === 'function'
+        && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+    const copilotName = event.copilot?.name?.trim() || 'Copilot';
+    const roleLine = event.copilot?.roleLine?.trim() || '';
+    const avatarUrl = event.copilot?.avatar?.trim() || '';
+    const card = document.createElement('div');
+    card.className = `note enter ${deps.dock}`;
+    card.setAttribute('role', 'status');
+    card.setAttribute('aria-live', 'polite');
+    // Header: avatar + name·role + ✕
+    const head = document.createElement('div');
+    head.className = 'head';
+    if (avatarUrl) {
+        const img = document.createElement('img');
+        img.className = 'avatar';
+        img.src = avatarUrl;
+        img.alt = '';
+        img.referrerPolicy = 'no-referrer';
+        img.addEventListener('error', () => img.replaceWith(monogram(copilotName)));
+        head.appendChild(img);
+    }
+    else {
+        head.appendChild(monogram(copilotName));
+    }
+    const idBlock = document.createElement('div');
+    idBlock.className = 'idblock';
+    const nameEl = document.createElement('div');
+    nameEl.className = 'name';
+    nameEl.textContent = copilotName;
+    idBlock.appendChild(nameEl);
+    if (roleLine) {
+        const roleEl = document.createElement('div');
+        roleEl.className = 'role';
+        roleEl.textContent = roleLine;
+        idBlock.appendChild(roleEl);
+    }
+    head.appendChild(idBlock);
+    const x = document.createElement('button');
+    x.className = 'x';
+    x.type = 'button';
+    x.setAttribute('aria-label', 'Dismiss');
+    x.textContent = '✕';
+    head.appendChild(x);
+    // Body
+    const message = document.createElement('div');
+    message.className = 'message';
+    message.textContent = event.content || event.goal;
+    // Actions. A voice_presentation note leads with "Show me" (→ Theater)
+    // when the Theater is wired; otherwise it gracefully degrades to "Got
+    // it" (the copilot tells instead of shows — theater doc §4.1). "Talk"
+    // (→ Stage, P6) is offered whenever voice is wired.
+    const isPresent = event.modality === 'voice_presentation';
+    const actions = document.createElement('div');
+    actions.className = 'actions';
+    if (handlers.talkHandler) {
+        actions.appendChild(makeBtn('secondary', 'Talk', () => {
+            handlers.talkHandler?.(toActionCtx(event));
+            instance.close('engaged');
+        }));
+    }
+    if (isPresent && handlers.showHandler) {
+        actions.appendChild(makeBtn('primary', 'Show me', () => {
+            handlers.showHandler?.(toActionCtx(event));
+            instance.close('engaged');
+        }));
+    }
+    else {
+        actions.appendChild(makeBtn('primary', 'Got it', () => instance.close('engaged')));
+    }
+    card.append(head, message, actions);
+    root.append(styleNode(), card);
+    // Entry — grow from the chip. The portrait glances at the note.
+    if (reducedMotion) {
+        card.classList.remove('enter');
+    }
+    else {
+        requestAnimationFrame(() => requestAnimationFrame(() => card.classList.remove('enter')));
+    }
+    deps.presence.chip?.playGesture(deps.presence.chip.innerGlance());
+    // -- Attention-gated ignore timer -----------------------------------
+    let closed = false;
+    let armed = false;
+    let remainingMs = IGNORE_BUDGET_MS;
+    let runTimer = null;
+    let startedAt = 0;
+    let paused = false;
+    const tick = () => {
+        if (closed || !armed || paused)
+            return;
+        startedAt = Date.now();
+        runTimer = setTimeout(() => instance.close('ignored'), remainingMs);
+    };
+    const pause = () => {
+        paused = true;
+        if (runTimer != null) {
+            clearTimeout(runTimer);
+            runTimer = null;
+            remainingMs = Math.max(1000, remainingMs - (Date.now() - startedAt));
+        }
+    };
+    const resume = () => { if (paused) {
+        paused = false;
+        tick();
+    } };
+    const arm = () => {
+        if (armed || closed)
+            return;
+        armed = true;
+        window.removeEventListener('pointerdown', arm);
+        window.removeEventListener('scroll', arm);
+        window.removeEventListener('keydown', arm);
+        if (graceTimer != null) {
+            clearTimeout(graceTimer);
+            graceTimer = null;
+        }
+        if (!document.hidden)
+            tick();
+    };
+    // Arm on first conscious interaction, or after the grace window.
+    window.addEventListener('pointerdown', arm, { passive: true });
+    window.addEventListener('scroll', arm, { passive: true });
+    window.addEventListener('keydown', arm);
+    let graceTimer = setTimeout(arm, ARM_GRACE_MS);
+    // Pause while reading (hover/focus) or while the tab is hidden.
+    card.addEventListener('mouseenter', pause);
+    card.addEventListener('focusin', pause);
+    card.addEventListener('mouseleave', resume);
+    card.addEventListener('focusout', resume);
+    const onVis = () => { if (document.hidden)
+        pause();
+    else if (armed)
+        resume(); };
+    document.addEventListener('visibilitychange', onVis);
+    const sendOutcome = (outcome) => {
+        void postJson(deps.cfg, `/api/runtime/sessions/${deps.getSessionId()}/outcome`, {
+            ...deps.buildBody(),
+            interventionId: event.interventionId,
+            outcome,
+        });
+    };
+    const teardown = () => {
+        if (runTimer != null)
+            clearTimeout(runTimer);
+        if (graceTimer != null)
+            clearTimeout(graceTimer);
+        window.removeEventListener('pointerdown', arm);
+        window.removeEventListener('scroll', arm);
+        window.removeEventListener('keydown', arm);
+        document.removeEventListener('visibilitychange', onVis);
+    };
+    const doClose = (outcome) => {
+        if (closed)
+            return;
+        closed = true;
+        teardown();
+        if (outcome)
+            sendOutcome(outcome);
+        const remove = () => {
+            try {
+                root.removeChild(card);
+            }
+            catch { /* gone */ }
+            onClosed();
+        };
+        if (reducedMotion) {
+            remove();
+            return;
+        }
+        card.classList.add('exit'); // collapse toward the chip
+        let removed = false;
+        const once = () => { if (!removed) {
+            removed = true;
+            remove();
+        } };
+        card.addEventListener('transitionend', once, { once: true });
+        setTimeout(once, EXIT_MS + 80);
+    };
+    x.addEventListener('click', () => doClose('dismissed'));
+    const instance = {
+        event,
+        close(outcome) { doClose(outcome); },
+        detach() { doClose(null); },
+    };
+    return instance;
+}
+/**
+ * Intro note (P4) — the first-meeting greeting card. ✕-only, auto-dismiss
+ * in 12s, no outcome reporting (it's a presence event, not an
+ * intervention — it bypasses budgets server-side).
+ */
+function renderIntro(deps, event, onClosed) {
+    const container = ensureContainer();
+    positionContainer(container, deps);
+    const root = container.shadowRoot;
+    root.innerHTML = '';
+    const reducedMotion = typeof window.matchMedia === 'function'
+        && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+    const name = event.copilot.name?.trim() || 'Copilot';
+    const roleLine = event.copilot.roleLine?.trim() || '';
+    const avatarUrl = event.copilot.avatar?.trim() || '';
+    const card = document.createElement('div');
+    card.className = `note enter ${deps.dock}`;
+    card.setAttribute('role', 'status');
+    card.setAttribute('aria-live', 'polite');
+    const head = document.createElement('div');
+    head.className = 'head';
+    if (avatarUrl) {
+        const img = document.createElement('img');
+        img.className = 'avatar';
+        img.src = avatarUrl;
+        img.alt = '';
+        img.referrerPolicy = 'no-referrer';
+        img.addEventListener('error', () => img.replaceWith(monogram(name)));
+        head.appendChild(img);
+    }
+    else {
+        head.appendChild(monogram(name));
+    }
+    const idBlock = document.createElement('div');
+    idBlock.className = 'idblock';
+    const nameEl = document.createElement('div');
+    nameEl.className = 'name';
+    nameEl.textContent = name;
+    idBlock.appendChild(nameEl);
+    if (roleLine) {
+        const roleEl = document.createElement('div');
+        roleEl.className = 'role';
+        roleEl.textContent = roleLine;
+        idBlock.appendChild(roleEl);
+    }
+    head.appendChild(idBlock);
+    const x = document.createElement('button');
+    x.className = 'x';
+    x.type = 'button';
+    x.setAttribute('aria-label', 'Dismiss');
+    x.textContent = '✕';
+    head.appendChild(x);
+    const message = document.createElement('div');
+    message.className = 'message';
+    message.textContent = event.copilot.intro;
+    card.append(head, message);
+    root.append(styleNode(), card);
+    if (reducedMotion)
+        card.classList.remove('enter');
+    else
+        requestAnimationFrame(() => requestAnimationFrame(() => card.classList.remove('enter')));
+    let closed = false;
+    let dismissTimer = setTimeout(() => instance.close(null), INTRO_DISMISS_MS);
+    const doClose = () => {
+        if (closed)
+            return;
+        closed = true;
+        if (dismissTimer != null) {
+            clearTimeout(dismissTimer);
+            dismissTimer = null;
+        }
+        const remove = () => {
+            try {
+                root.removeChild(card);
+            }
+            catch { /* gone */ }
+            onClosed();
+        };
+        if (reducedMotion) {
+            remove();
+            return;
+        }
+        card.classList.add('exit');
+        let removed = false;
+        const once = () => { if (!removed) {
+            removed = true;
+            remove();
+        } };
+        card.addEventListener('transitionend', once, { once: true });
+        setTimeout(once, EXIT_MS + 80);
+    };
+    x.addEventListener('click', doClose);
+    const instance = {
+        event: { interventionId: `intro_${event.copilot.copilotId}`, modality: 'text', content: event.copilot.intro, goal: '', stage: event.stage },
+        close() { doClose(); },
+        detach() { doClose(); },
+    };
+    return instance;
+}
+function toActionCtx(e) {
+    return { interventionId: e.interventionId, goal: e.goal, content: e.content, stage: e.stage };
+}
+function makeBtn(kind, label, onClick) {
+    const b = document.createElement('button');
+    b.className = `btn ${kind}`;
+    b.type = 'button';
+    b.textContent = label;
+    b.addEventListener('click', onClick);
+    return b;
+}
+function monogram(name) {
+    const el = document.createElement('div');
+    el.className = 'avatar mono';
+    el.textContent = (name.trim()[0] ?? '?').toUpperCase();
+    return el;
+}
+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;z-index:2147483646;pointer-events:none';
+    el.attachShadow({ mode: 'open' });
+    document.body.appendChild(el);
+    return el;
+}
+/** Anchor the note to the chip — grows from it, aligned to its outer
+ *  edge, sitting just inside it toward viewport center. */
+function positionContainer(el, deps) {
+    const gap = 12;
+    const rect = deps.presence.chip?.getAnchorRect() ?? null;
+    // Reset.
+    el.style.top = el.style.bottom = el.style.left = el.style.right = '';
+    if (rect) {
+        if (deps.dock.startsWith('bottom')) {
+            el.style.bottom = `${Math.max(8, window.innerHeight - rect.top + gap)}px`;
+        }
+        else {
+            el.style.top = `${Math.max(8, rect.bottom + gap)}px`;
+        }
+        if (deps.dock.endsWith('right')) {
+            el.style.right = `${Math.max(8, window.innerWidth - rect.right)}px`;
+        }
+        else {
+            el.style.left = `${Math.max(8, rect.left)}px`;
+        }
+        return;
+    }
+    // Fallback: dock corner with room for the chip.
+    const off = 16;
+    if (deps.dock.startsWith('bottom'))
+        el.style.bottom = `${off + 64}px`;
+    else
+        el.style.top = `${off + 64}px`;
+    if (deps.dock.endsWith('right'))
+        el.style.right = `${off}px`;
+    else
+        el.style.left = `${off}px`;
+}
+function styleNode() {
+    const node = document.createElement('style');
+    node.textContent = `
+    :host { all: initial; }
+    .note {
+      pointer-events: auto;
+      width: 320px; max-width: calc(100vw - 32px);
+      background: #111; color: #fafafa;
+      border-radius: 16px;
+      box-shadow: 0 12px 32px rgba(0,0,0,0.32), 0 2px 8px rgba(0,0,0,0.12);
+      padding: 12px 14px;
+      font: 14px/1.45 -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;
+      opacity: 1; transform: scale(1) translateY(0);
+      transition: opacity ${ENTER_MS}ms ease-out, transform ${ENTER_MS}ms cubic-bezier(0.16,1,0.3,1);
+    }
+    /* Grow from the chip: origin toward the docked corner. */
+    .note.bottom-right { transform-origin: bottom right; }
+    .note.bottom-left  { transform-origin: bottom left; }
+    .note.top-right    { transform-origin: top right; }
+    .note.top-left     { transform-origin: top left; }
+    .note.enter { opacity: 0; transform: scale(0.82) translateY(8px); }
+    .note.exit  { opacity: 0; transform: scale(0.82) translateY(8px); transition-duration: ${EXIT_MS}ms; }
+    .head { display: flex; align-items: center; gap: 10px; margin-bottom: 8px; }
+    .avatar { width: 34px; height: 34px; border-radius: 50%; object-fit: cover; flex: none; background: #2a2a2a; }
+    .avatar.mono { display: flex; align-items: center; justify-content: center; color: #9ab8ff; font-weight: 600; font-size: 15px; }
+    .idblock { flex: 1; min-width: 0; }
+    .name { font-weight: 600; font-size: 13px; color: #e8e8e8; }
+    .role { font-size: 11px; color: #9a9a9a; margin-top: 1px; }
+    .x { appearance: none; border: 0; background: transparent; color: #8a8a8a; font-size: 13px; line-height: 1; padding: 6px; margin: -6px -4px -6px 0; border-radius: 8px; cursor: pointer; flex: none; }
+    .x:hover { color: #fff; background: rgba(255,255,255,0.08); }
+    .message { margin: 0 2px 12px; color: #f2f2f2; }
+    .actions { display: flex; justify-content: flex-end; gap: 8px; }
+    .btn { appearance: none; border: 0; padding: 7px 14px; border-radius: 9px; font: inherit; font-size: 13px; font-weight: 500; cursor: pointer; }
+    .btn.primary { background: #4f8bff; color: #fff; }
+    .btn.primary:hover { background: #6aa0ff; }
+    .btn.secondary { background: rgba(255,255,255,0.10); color: #e8e8e8; }
+    .btn.secondary:hover { background: rgba(255,255,255,0.16); }
+    .btn:focus-visible, .x:focus-visible { outline: 2px solid #9ab8ff; outline-offset: 2px; }
+    @media (prefers-reduced-motion: reduce) { .note { transition: none; } }
+  `;
+    return node;
+}
+//# sourceMappingURL=note.js.map