@holostaff/sdk 0.3.0

package/dist/widget.js

@@ -0,0 +1,182 @@
+/**
+ * Widget — Wave 3e.
+ *
+ * Listens to the SSE command channel for `fire_intervention` events
+ * and renders a minimal text pill in the customer's host page. Wires
+ * dismiss / engage user actions back to /outcome.
+ *
+ * Wave 3e scope:
+ *   - `text` modality only. Other modalities (voice / email / sms /
+ *     phone / screen_automation) are logged and ignored — Wave 6.
+ *   - Single visible widget at a time. A new event while one is open
+ *     replaces it (and reports 'ignored' for the prior).
+ *   - No theming. Inline-styled floating pill, fixed lower-right.
+ *
+ * The widget keeps zero dependencies on host CSS — it injects its own
+ * styles into the shadow root of a top-level container so host page
+ * rules can't bleed in or out.
+ */
+import { postJson } from './transport.js';
+/** Auto-dismiss timeout — runtime doc §9.1 'ignored' outcome. */
+const AUTO_DISMISS_MS = 30000;
+/** Container id — single instance per page. */
+const CONTAINER_ID = 'holostaff-widget-root';
+/**
+ * Start the widget subsystem. Subscribes to the SSE `fire_intervention`
+ * event and shows the text pill when one arrives. Idempotent in the
+ * sense that the SDK singleton ensures one binding per session.
+ */
+export function startWidget(deps) {
+    if (typeof window === 'undefined' || !deps.source) {
+        return { dispose: () => { } };
+    }
+    let currentWidget = null;
+    const onFire = (rawEvent) => {
+        let parsed = null;
+        try {
+            const data = JSON.parse(rawEvent.data);
+            if (!data || typeof data.interventionId !== 'string')
+                return;
+            parsed = data;
+        }
+        catch {
+            return;
+        }
+        if (!parsed)
+            return;
+        // Modality gate — only text is supported in v1.
+        if (parsed.modality !== 'text') {
+            deps.cfg.onError?.(new Error(`Modality '${parsed.modality}' is not supported in this SDK build`), { method: 'WIDGET', path: '(fire_intervention)' });
+            return;
+        }
+        // If a widget is already up, evict it as 'ignored' before showing the new one.
+        if (currentWidget) {
+            currentWidget.reportAndClose('ignored');
+        }
+        currentWidget = renderWidget(deps, parsed, () => {
+            if (currentWidget && currentWidget.event.interventionId === parsed.interventionId) {
+                currentWidget = null;
+            }
+        });
+    };
+    deps.source.addEventListener('fire_intervention', onFire);
+    return {
+        dispose() {
+            deps.source?.removeEventListener('fire_intervention', onFire);
+            if (currentWidget) {
+                currentWidget.detach();
+                currentWidget = null;
+            }
+        },
+    };
+}
+function renderWidget(deps, event, onClosed) {
+    const container = ensureContainer();
+    const root = container.shadowRoot;
+    // Clear any prior content (defensive — single-widget invariant).
+    root.innerHTML = '';
+    const wrapper = document.createElement('div');
+    wrapper.className = 'pill';
+    wrapper.setAttribute('role', 'dialog');
+    wrapper.setAttribute('aria-live', 'polite');
+    wrapper.setAttribute('data-intervention-id', event.interventionId);
+    const message = document.createElement('div');
+    message.className = 'message';
+    message.textContent = event.content || event.goal;
+    const actions = document.createElement('div');
+    actions.className = 'actions';
+    const dismissBtn = document.createElement('button');
+    dismissBtn.className = 'btn dismiss';
+    dismissBtn.type = 'button';
+    dismissBtn.textContent = 'Dismiss';
+    const engageBtn = document.createElement('button');
+    engageBtn.className = 'btn engage';
+    engageBtn.type = 'button';
+    engageBtn.textContent = 'Got it';
+    actions.appendChild(dismissBtn);
+    actions.appendChild(engageBtn);
+    wrapper.appendChild(message);
+    wrapper.appendChild(actions);
+    root.appendChild(styleNode());
+    root.appendChild(wrapper);
+    let closed = false;
+    let timeoutId = setTimeout(() => {
+        instance.reportAndClose('ignored');
+    }, AUTO_DISMISS_MS);
+    const reportOutcome = (outcome) => {
+        const body = {
+            ...deps.buildBody(),
+            interventionId: event.interventionId,
+            outcome,
+        };
+        void postJson(deps.cfg, `/api/runtime/sessions/${deps.getSessionId()}/outcome`, body);
+    };
+    const close = (outcome) => {
+        if (closed)
+            return;
+        closed = true;
+        if (timeoutId != null) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+        if (outcome)
+            reportOutcome(outcome);
+        try {
+            root.removeChild(wrapper);
+        }
+        catch { /* removed already */ }
+        onClosed();
+    };
+    dismissBtn.addEventListener('click', () => close('dismissed'));
+    engageBtn.addEventListener('click', () => close('engaged'));
+    const instance = {
+        event,
+        reportAndClose(outcome) { close(outcome); },
+        detach() { close(null); },
+    };
+    return instance;
+}
+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;right:16px;bottom:16px;z-index:2147483647;pointer-events:none';
+    el.attachShadow({ mode: 'open' });
+    document.body.appendChild(el);
+    return el;
+}
+function styleNode() {
+    const node = document.createElement('style');
+    // Inline styles only — shadow-DOM scoped, no host page leakage.
+    node.textContent = `
+    .pill {
+      pointer-events: auto;
+      max-width: 360px;
+      background: #111;
+      color: #fafafa;
+      border-radius: 14px;
+      box-shadow: 0 12px 32px rgba(0,0,0,0.32), 0 2px 8px rgba(0,0,0,0.12);
+      padding: 14px 16px 12px;
+      font: 14px/1.4 -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;
+    }
+    .message { margin-bottom: 12px; }
+    .actions { display: flex; gap: 8px; justify-content: flex-end; }
+    .btn {
+      appearance: none;
+      border: 0;
+      padding: 6px 12px;
+      border-radius: 8px;
+      font: inherit;
+      font-size: 13px;
+      cursor: pointer;
+    }
+    .btn.dismiss { background: transparent; color: #c7c7c7; }
+    .btn.dismiss:hover { color: #fff; }
+    .btn.engage { background: #4f8bff; color: #fff; }
+    .btn.engage:hover { background: #6aa0ff; }
+  `;
+    return node;
+}
+//# sourceMappingURL=widget.js.map

package/dist/widget.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@holostaff/sdk",
+  "version": "0.3.0",
+  "description": "Holostaff SDK — lifetime identity, stage detection, and custom signal probes for the holostaff runtime.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "holostaff",
+    "copilot",
+    "instrumentation",
+    "runtime"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  }
+}