@thisispamela/widget 1.1.0

package/README.md

@@ -0,0 +1,133 @@
+# @thisispamela/widget
+
+Embeddable Pamela Voice AI widget for any website. Add AI-powered phone calls with a single script tag.
+
+## Installation
+
+### Script tag (CDN)
+
+**Primary CDN (when available):**
+```html
+<script src="https://cdn.thisispamela.com/widget.js"></script>
+```
+
+**unpkg / jsDelivr (npm-backed):**
+```html
+<script src="https://unpkg.com/@thisispamela/widget"></script>
+<!-- or -->
+<script src="https://cdn.jsdelivr.net/npm/@thisispamela/widget"></script>
+```
+
+Example:
+```html
+<script src="https://cdn.thisispamela.com/widget.js"></script>
+<script>
+  Pamela.init({
+    apiKey: 'pk_live_xxx',
+    mode: 'floating',
+    theme: 'auto',
+    position: 'bottom-right',
+  });
+</script>
+```
+
+### npm
+
+```bash
+npm install @thisispamela/widget
+```
+
+```javascript
+import Pamela from '@thisispamela/widget';
+
+Pamela.init({ apiKey: 'pk_live_xxx', mode: 'floating' });
+```
+
+## API
+
+### `Pamela.init(options)`
+
+| Option     | Type   | Default        | Description                    |
+| ---------- | ------ | -------------- | ------------------------------ |
+| `apiKey`   | string | **required**  | Enterprise API key             |
+| `mode`     | string | `'floating'`  | `'floating'` \| `'modal'` \| `'inline'` \| `'none'` |
+| `theme`    | string | `'auto'`      | `'light'` \| `'dark'` \| `'auto'` |
+| `position` | string | `'bottom-right'` | Floating button position     |
+| `baseUrl`  | string | Production API | Custom API base URL          |
+| `defaults` | object | —             | Default voice, agentName, callerName, maxDuration |
+| `styles`   | object | —             | CSS variable overrides: `--pamela-accent`, `--pamela-primary`, `--pamela-background`, `--pamela-text`, `--pamela-border-radius`, `--pamela-font` |
+
+### `Pamela.call(options)`
+
+Start a call programmatically.
+
+```javascript
+const call = await Pamela.call({
+  to: '+15551234567',
+  task: 'Schedule a demo for tomorrow at 2pm',
+  voice: 'auto',
+  agentName: 'Pamela',
+  callerName: 'Acme Corp',
+});
+```
+
+### `Pamela.getCall(callId)` / `Pamela.cancel(callId)`
+
+Get call status or cancel an in-progress call.
+
+### `Pamela.on(event, callback)` / `Pamela.off(event, callback)`
+
+Events: `call:start`, `call:update`, `call:complete`, `call:error`, `modal:open`, `modal:close`.
+
+### `Pamela.destroy()`
+
+Remove the widget and clean up.
+
+## Inline mode
+
+Add call buttons to existing elements:
+
+```html
+<div
+  data-pamela-call
+  data-to="+15551234567"
+  data-task="Schedule a demo"
+  data-voice="auto"
+  data-label="Call with Pamela"
+></div>
+```
+
+The widget discovers these on load and watches for dynamically added elements. When you click an inline button, the modal opens (if you use `mode: 'inline'`) and shows call status and transcript until the call completes.
+
+## Modal mode
+
+Use the full modal UI (phone input, task textarea, voice select, status + transcript):
+
+```javascript
+Pamela.init({ apiKey: 'pk_live_xxx', mode: 'modal' });
+// Open the modal programmatically if you want:
+Pamela.show();
+```
+
+## Theming
+
+The widget uses CSS variables aligned with the Pamela design system (light and dark). Themes: **Light** (default), **Dark** (auto-detected via `prefers-color-scheme`, `.dark` class, or `data-pamela-theme="dark"`). Pass `theme: 'light'` or `theme: 'dark'` to force, or `theme: 'auto'` (default). Override at init with `styles: { '--pamela-primary': '#f97316', '--pamela-background': '#ffffff', '--pamela-text': '#1f2937', '--pamela-border-radius': '8px', '--pamela-font': '...' }` or override tokens in your CSS on `.pamela-widget-root`.
+
+## Distribution
+
+- **Full bundle:** `dist/widget.js` (IIFE), `dist/widget.esm.js` (ESM), `dist/widget.d.ts` (types)
+- **Minified:** `npm run build:min` produces `dist/widget.min.js` for production/CDN
+- **npm:** `npm publish` (package `@thisispamela/widget`, `publishConfig.access: public`)
+- **CDN URLs:** `https://cdn.thisispamela.com/widget.js` (primary), `https://unpkg.com/@thisispamela/widget`, `https://cdn.jsdelivr.net/npm/@thisispamela/widget`
+
+## Local demo
+
+After `npm run build`, serve the package directory and open `demo.html` (e.g. `npx serve .` then visit `/demo.html`). Replace `apiKey` in the script with a valid key to test the floating button and call flow.
+
+## Security
+
+API keys used in the widget are visible in the frontend. Use project/domain allowlists in the dashboard and prefer restricted public keys (`pk_*`) for widget use. See [WIDGET_ARCHITECTURE.md](../../docs/architecture/WIDGET_ARCHITECTURE.md#security-considerations).
+
+## Architecture
+
+See [docs/architecture/WIDGET_ARCHITECTURE.md](../../docs/architecture/WIDGET_ARCHITECTURE.md) for bundle strategy, security, and implementation details.

package/dist/api.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Lightweight fetch-based API client for the widget.
+ * Imports shared types from @thisispamela/sdk for alignment.
+ */
+import type { PamelaCall, PamelaCallOptions } from './types';
+export declare class PamelaError extends Error {
+    code?: string;
+    errorCode?: number;
+    statusCode?: number;
+    details?: Record<string, unknown>;
+    constructor(message: string, options?: {
+        code?: string;
+        errorCode?: number;
+        statusCode?: number;
+        details?: Record<string, unknown>;
+    });
+}
+export interface ApiClientOptions {
+    authToken: string;
+    baseUrl?: string;
+}
+export declare class PamelaApiClient {
+    private authToken;
+    private baseUrl;
+    constructor(options: ApiClientOptions);
+    private request;
+    createCall(options: PamelaCallOptions): Promise<PamelaCall>;
+    getCall(callId: string): Promise<PamelaCall>;
+    cancelCall(callId: string): Promise<void>;
+    /**
+     * Poll call status until terminal state or timeout.
+     */
+    pollCallStatus(callId: string, options?: {
+        intervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<PamelaCall>;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EAIlB,MAAM,SAAS,CAAC;AAEjB,qBAAa,WAAY,SAAQ,KAAK;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CASJ;AAgCD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,gBAAgB;YAKvB,OAAO;IAyCf,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAkB3D,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAK5C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACxD,OAAO,CAAC,UAAU,CAAC;CAgBvB"}

package/dist/events.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Simple event emitter for widget callbacks
+ */
+type Listener = (...args: unknown[]) => void;
+export declare class EventEmitter {
+    private listeners;
+    on(event: string, callback: Listener): void;
+    off(event: string, callback: Listener): void;
+    emit(event: string, ...args: unknown[]): void;
+    removeAllListeners(event?: string): void;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,KAAK,QAAQ,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAE7C,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAsC;IAEvD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAM3C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAQ5C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAY7C,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;CAOzC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @thisispamela/widget - Embeddable Pamela Voice AI widget
+ *
+ * Usage (script tag):
+ *   <script src="https://cdn.thisispamela.com/widget.js"></script>
+ *   <script>
+ *     Pamela.init({ apiKey: 'pk_live_xxx', mode: 'floating' });
+ *   </script>
+ *
+ * Usage (ESM):
+ *   import Pamela from '@thisispamela/widget';
+ *   Pamela.init({ apiKey: 'pk_live_xxx' });
+ */
+import { Pamela } from './pamela';
+import { PamelaError } from './api';
+import type { PamelaInitOptions, PamelaCallOptions, PamelaCall, PamelaStyleOverrides, TranscriptEntry } from './types';
+export { Pamela, PamelaError };
+export type { PamelaInitOptions, PamelaCallOptions, PamelaCall, PamelaStyleOverrides, TranscriptEntry };
+export default Pamela;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAOvH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AAC/B,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,oBAAoB,EAAE,eAAe,EAAE,CAAC;AAExG,eAAe,MAAM,CAAC"}

package/dist/pamela.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Main Pamela widget class: init, call, events, UI modes
+ */
+import type { PamelaInitOptions, PamelaCallOptions, PamelaCall } from './types';
+export declare class Pamela {
+    private static instance;
+    private api;
+    private options;
+    private events;
+    private floatingButton;
+    private inlineButton;
+    private modal;
+    private container;
+    private theme;
+    static init(options: PamelaInitOptions): Pamela;
+    private init;
+    private handleCreateCall;
+    call(options: PamelaCallOptions): Promise<PamelaCall>;
+    getCall(callId: string): Promise<PamelaCall>;
+    cancel(callId: string): Promise<void>;
+    on(event: string, callback: (...args: unknown[]) => void): void;
+    off(event: string, callback: (...args: unknown[]) => void): void;
+    show(): void;
+    hide(): void;
+    destroy(): void;
+    static getInstance(): Pamela | null;
+}
+//# sourceMappingURL=pamela.d.ts.map

package/dist/pamela.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pamela.d.ts","sourceRoot":"","sources":["../src/pamela.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACX,MAAM,SAAS,CAAC;AAejB,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuB;IAE9C,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,KAAK,CAA6B;IAE1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;IAU/C,OAAO,CAAC,IAAI;YA8DE,gBAAgB;IA0B9B,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAKrD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAK5C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAI/D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAIhE,IAAI,IAAI,IAAI;IAKZ,IAAI,IAAI,IAAI;IAKZ,OAAO,IAAI,IAAI;IAef,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,IAAI;CAGpC"}

package/dist/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Pamela Widget - TypeScript interfaces
+ */
+import type { CallStatusValue } from '@thisispamela/sdk/types';
+export interface PamelaInitOptions {
+    apiKey?: string;
+    accessToken?: string;
+    theme?: 'light' | 'dark' | 'auto';
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    mode?: 'floating' | 'modal' | 'inline' | 'none';
+    baseUrl?: string;
+    defaults?: {
+        voice?: string;
+        agentName?: string;
+        callerName?: string;
+        maxDuration?: number;
+    };
+    styles?: Partial<PamelaStyleOverrides>;
+}
+export interface PamelaCallOptions {
+    to: string;
+    task: string;
+    voice?: string;
+    agentName?: string;
+    callerName?: string;
+    maxDuration?: number;
+    metadata?: Record<string, string>;
+    webhooks?: {
+        onComplete?: string;
+        onFailed?: string;
+    };
+}
+export interface TranscriptEntry {
+    role: 'agent' | 'recipient';
+    content: string;
+    timestamp: number;
+}
+export interface PamelaCall {
+    id: string;
+    status: CallStatusValue;
+    to: string;
+    task: string;
+    duration?: number;
+    transcript?: TranscriptEntry[];
+    summary?: string;
+    createdAt: string;
+    completedAt?: string;
+}
+export interface PamelaStyleOverrides {
+    '--pamela-accent'?: string;
+    '--pamela-accent-2'?: string;
+    '--pamela-primary'?: string;
+    '--pamela-background'?: string;
+    '--pamela-text'?: string;
+    '--pamela-radius'?: string;
+    '--pamela-border-radius'?: string;
+    '--pamela-font'?: string;
+}
+/** Raw API response (snake_case) from backend */
+export interface ApiCallResponse {
+    id: string;
+    status: string;
+    call_session_id: string;
+    created_at: string;
+}
+export interface ApiCallStatusResponse {
+    id: string;
+    status: string;
+    to: string;
+    from_: string;
+    country: string;
+    created_at: string;
+    started_at?: string;
+    completed_at?: string;
+    duration_seconds?: number;
+    max_duration_seconds?: number;
+    transcript?: Array<{
+        role: string;
+        content: string;
+        timestamp?: number;
+    }>;
+    summary?: string;
+    metadata: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/ui/FloatingButton.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Floating call button that expands to a mini form (phone + task + Call Now)
+ */
+import type { PamelaCall } from '../types';
+export interface FloatingButtonOptions {
+    position: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    theme: 'light' | 'dark';
+    defaults?: {
+        voice?: string;
+        agentName?: string;
+        callerName?: string;
+    };
+    onCreateCall: (to: string, task: string) => void;
+    onExpand?: () => void;
+    onCollapse?: () => void;
+}
+export declare class FloatingButton {
+    private options;
+    private root;
+    private wrapper;
+    private panel;
+    private expanded;
+    private currentCall;
+    constructor(options: FloatingButtonOptions);
+    render(container: HTMLElement): HTMLElement;
+    private getWrapperStyles;
+    private getButtonStyles;
+    private toggle;
+    private handleSubmit;
+    setCallStatus(call: PamelaCall | null): void;
+    destroy(): void;
+}
+//# sourceMappingURL=FloatingButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FloatingButton.d.ts","sourceRoot":"","sources":["../../src/ui/FloatingButton.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAW3C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;IACpE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAA2B;gBAElC,OAAO,EAAE,qBAAqB;IAI1C,MAAM,CAAC,SAAS,EAAE,WAAW,GAAG,WAAW;IA8E3C,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,YAAY;IAmBpB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAkB5C,OAAO,IAAI,IAAI;CAMhB"}

package/dist/ui/InlineButton.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Inline button mode: attach call buttons to elements with data-pamela-call
+ * Auto-initializes on DOM ready and watches for dynamically added elements.
+ */
+export interface InlineButtonOptions {
+    theme: 'light' | 'dark';
+    onCallClick: (params: {
+        to: string;
+        task: string;
+        voice?: string;
+    }) => void;
+}
+export declare class InlineButton {
+    private options;
+    private observer;
+    private styleInjected;
+    constructor(options: InlineButtonOptions);
+    /**
+     * Scan the document for [data-pamela-call] and attach buttons.
+     */
+    attach(root?: Document | HTMLElement): void;
+    private attachToElement;
+    /**
+     * Start watching for dynamically added [data-pamela-call] elements.
+     */
+    observe(root?: Document | HTMLElement): void;
+    destroy(): void;
+}
+//# sourceMappingURL=InlineButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InlineButton.d.ts","sourceRoot":"","sources":["../../src/ui/InlineButton.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,WAAW,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC7E;AAyBD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,EAAE,mBAAmB;IAIxC;;OAEG;IACH,MAAM,CAAC,IAAI,GAAE,QAAQ,GAAG,WAAsB,GAAG,IAAI;IAWrD,OAAO,CAAC,eAAe;IA8BvB;;OAEG;IACH,OAAO,CAAC,IAAI,GAAE,QAAQ,GAAG,WAAsB,GAAG,IAAI;IAqBtD,OAAO,IAAI,IAAI;CAIhB"}

package/dist/ui/Modal.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Full-featured call modal with status + transcript display.
+ */
+import type { PamelaCall } from '../types';
+export interface ModalOptions {
+    theme: 'light' | 'dark';
+    defaults?: {
+        voice?: string;
+        agentName?: string;
+        callerName?: string;
+    };
+    onCreateCall: (to: string, task: string, voice?: string) => void;
+    onClose?: () => void;
+}
+export declare class Modal {
+    private options;
+    private root;
+    private overlay;
+    private panel;
+    private orbEl;
+    private statusEl;
+    private transcriptEl;
+    private summaryEl;
+    private expanded;
+    private boundKeydown;
+    constructor(options: ModalOptions);
+    render(container: HTMLElement): HTMLElement;
+    open(): void;
+    close(): void;
+    setCallStatus(call: PamelaCall | null): void;
+    destroy(): void;
+    private renderTranscriptEntry;
+    private handleSubmit;
+    private getOverlayStyles;
+    private getSelectStyles;
+    private getCloseStyles;
+    private getTranscriptWrapperStyles;
+    private getTranscriptStyles;
+    private getTranscriptBubbleStyles;
+    private getOrbStyles;
+}
+//# sourceMappingURL=Modal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../src/ui/Modal.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,UAAU,CAAC;AAM5D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA6C;gBAErD,OAAO,EAAE,YAAY;IAIjC,MAAM,CAAC,SAAS,EAAE,WAAW,GAAG,WAAW;IAoI3C,IAAI,IAAI,IAAI;IAMZ,KAAK,IAAI,IAAI;IAOb,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAqC5C,OAAO,IAAI,IAAI;IAef,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,0BAA0B;IAOlC,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,yBAAyB;IAWjC,OAAO,CAAC,YAAY;CAQrB"}

package/dist/ui/icons.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Inline SVG icons for the widget (no external assets)
+ */
+export declare const ICON_LOGO = "<svg viewBox=\"0 0 32 32\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><circle cx=\"16\" cy=\"16\" r=\"14\" fill=\"url(#pamela-g)\" stroke=\"rgba(255,255,255,0.4)\" stroke-width=\"1.5\"/><path d=\"M12 11v10l8-5-8-5z\" fill=\"white\"/><defs><linearGradient id=\"pamela-g\" x1=\"8\" y1=\"8\" x2=\"24\" y2=\"24\" gradientUnits=\"userSpaceOnUse\"><stop stop-color=\"#F27A1A\"/><stop offset=\"1\" stop-color=\"#F06C4F\"/></linearGradient></defs></svg>";
+export declare const ICON_PHONE = "<svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M22 16.92v3a2 2 0 01-2.18 2 19.79 19.79 0 01-8.63-3.07 19.5 19.5 0 01-6-6 19.79 19.79 0 01-3.07-8.67A2 2 0 014.11 2h3a2 2 0 012 1.72 12.84 12.84 0 00.7 2.81 2 2 0 01-.45 2.11L8.09 9.91a16 16 0 006 6l1.27-1.27a2 2 0 012.11-.45 12.84 12.84 0 002.81.7A2 2 0 0122 16.92z\"/></svg>";
+export declare const ICON_CLOSE = "<svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><line x1=\"18\" y1=\"6\" x2=\"6\" y2=\"18\"/><line x1=\"6\" y1=\"6\" x2=\"18\" y2=\"18\"/></svg>";
+export declare const ICON_CALL = "<svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M22 16.92v3a2 2 0 01-2.18 2 19.79 19.79 0 01-8.63-3.07 19.5 19.5 0 01-6-6 19.79 19.79 0 01-3.07-8.67A2 2 0 014.11 2h3a2 2 0 012 1.72 12.84 12.84 0 00.7 2.81 2 2 0 01-.45 2.11L8.09 9.91a16 16 0 006 6l1.27-1.27a2 2 0 012.11-.45 12.84 12.84 0 002.81.7A2 2 0 0122 16.92z\"/></svg>";
+//# sourceMappingURL=icons.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/ui/icons.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,SAAS,0cAC2Y,CAAC;AAEla,eAAO,MAAM,UAAU,0aACoY,CAAC;AAE5Z,eAAO,MAAM,UAAU,4OACwL,CAAC;AAEhN,eAAO,MAAM,SAAS,0aACqY,CAAC"}

package/dist/ui/styles.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Design tokens aligned with WEBSITE_DESIGN_SCHEMA.md (light + dark).
+ * Plan aliases: --pamela-primary, --pamela-background, --pamela-border-radius for host overrides.
+ */
+export declare function injectStyles(theme: 'light' | 'dark'): void;
+export declare function getThemeClass(theme: 'light' | 'dark'): string;
+/** Style overrides from PamelaStyleOverrides (init options.styles) */
+export type StyleOverrides = import('../types').PamelaStyleOverrides;
+/**
+ * Apply custom CSS variable overrides to widget roots.
+ * Call after injectStyles; host can pass options.styles from init.
+ */
+export declare function applyStyleOverrides(overrides: Partial<StyleOverrides>): void;
+//# sourceMappingURL=styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/ui/styles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkFH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ1D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAE7D;AAED,sEAAsE;AACtE,MAAM,MAAM,cAAc,GAAG,OAAO,UAAU,EAAE,oBAAoB,CAAC;AAErE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAuB5E"}

package/dist/utils/phone.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Phone helpers for the widget (lightweight, no external deps).
+ */
+export declare function normalizePhone(value: string): string;
+export declare function isValidE164(value: string): boolean;
+//# sourceMappingURL=phone.d.ts.map

package/dist/utils/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../src/utils/phone.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/dist/utils/styles.d.ts

@@ -0,0 +1,20 @@
+type PanelStyleOptions = {
+    width?: string;
+    minWidth?: string;
+    maxWidth?: string;
+    padding?: string;
+    borderRadiusVar?: string;
+    gap?: string;
+};
+type InputStyleOptions = {
+    padding?: string;
+    fontSize?: string;
+};
+type CtaStyleOptions = {
+    padding?: string;
+};
+export declare function buildPanelStyles(options?: PanelStyleOptions): string;
+export declare function buildInputStyles(options?: InputStyleOptions): string;
+export declare function buildCtaStyles(options?: CtaStyleOptions): string;
+export {};
+//# sourceMappingURL=styles.d.ts.map

package/dist/utils/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/utils/styles.ts"],"names":[],"mappings":"AAAA,KAAK,iBAAiB,GAAG;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAsBxE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAQxE;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAOpE"}

package/dist/widget.d.ts

@@ -0,0 +1,123 @@
+import { CallStatusValue } from '@thisispamela/sdk/types';
+
+/**
+ * Pamela Widget - TypeScript interfaces
+ */
+
+interface PamelaInitOptions {
+    apiKey?: string;
+    accessToken?: string;
+    theme?: 'light' | 'dark' | 'auto';
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    mode?: 'floating' | 'modal' | 'inline' | 'none';
+    baseUrl?: string;
+    defaults?: {
+        voice?: string;
+        agentName?: string;
+        callerName?: string;
+        maxDuration?: number;
+    };
+    styles?: Partial<PamelaStyleOverrides>;
+}
+interface PamelaCallOptions {
+    to: string;
+    task: string;
+    voice?: string;
+    agentName?: string;
+    callerName?: string;
+    maxDuration?: number;
+    metadata?: Record<string, string>;
+    webhooks?: {
+        onComplete?: string;
+        onFailed?: string;
+    };
+}
+interface TranscriptEntry {
+    role: 'agent' | 'recipient';
+    content: string;
+    timestamp: number;
+}
+interface PamelaCall {
+    id: string;
+    status: CallStatusValue;
+    to: string;
+    task: string;
+    duration?: number;
+    transcript?: TranscriptEntry[];
+    summary?: string;
+    createdAt: string;
+    completedAt?: string;
+}
+interface PamelaStyleOverrides {
+    '--pamela-accent'?: string;
+    '--pamela-accent-2'?: string;
+    '--pamela-primary'?: string;
+    '--pamela-background'?: string;
+    '--pamela-text'?: string;
+    '--pamela-radius'?: string;
+    '--pamela-border-radius'?: string;
+    '--pamela-font'?: string;
+}
+
+/**
+ * Main Pamela widget class: init, call, events, UI modes
+ */
+
+declare class Pamela {
+    private static instance;
+    private api;
+    private options;
+    private events;
+    private floatingButton;
+    private inlineButton;
+    private modal;
+    private container;
+    private theme;
+    static init(options: PamelaInitOptions): Pamela;
+    private init;
+    private handleCreateCall;
+    call(options: PamelaCallOptions): Promise<PamelaCall>;
+    getCall(callId: string): Promise<PamelaCall>;
+    cancel(callId: string): Promise<void>;
+    on(event: string, callback: (...args: unknown[]) => void): void;
+    off(event: string, callback: (...args: unknown[]) => void): void;
+    show(): void;
+    hide(): void;
+    destroy(): void;
+    static getInstance(): Pamela | null;
+}
+
+/**
+ * Lightweight fetch-based API client for the widget.
+ * Imports shared types from @thisispamela/sdk for alignment.
+ */
+
+declare class PamelaError extends Error {
+    code?: string;
+    errorCode?: number;
+    statusCode?: number;
+    details?: Record<string, unknown>;
+    constructor(message: string, options?: {
+        code?: string;
+        errorCode?: number;
+        statusCode?: number;
+        details?: Record<string, unknown>;
+    });
+}
+
+/**
+ * @thisispamela/widget - Embeddable Pamela Voice AI widget
+ *
+ * Usage (script tag):
+ *   <script src="https://cdn.thisispamela.com/widget.js"></script>
+ *   <script>
+ *     Pamela.init({ apiKey: 'pk_live_xxx', mode: 'floating' });
+ *   </script>
+ *
+ * Usage (ESM):
+ *   import Pamela from '@thisispamela/widget';
+ *   Pamela.init({ apiKey: 'pk_live_xxx' });
+ */
+
+export { Pamela, PamelaError, Pamela as default };
+export type { PamelaCall, PamelaCallOptions, PamelaInitOptions, PamelaStyleOverrides, TranscriptEntry };