@hubtalk-ai/web-sdk 0.2.0 → 0.3.1

package/dist/widget.css

@@ -0,0 +1,597 @@
+/* VPT-857 §1.1: the shipped widget styles — a verbatim port of the example
+   widget of VPT-250 (example/widget.css) so the shipped component and the
+   hand-written /free page look the same (user decision 2026-10-13).
+
+   Token values are a copy of the editor palette (editor/src/styles.css,
+   ТЗ №113/№115: OKLCH, hue 286.98). Tokens live on the .ht-widget root and
+   never on :root, so loading this file never repaints the host page; every
+   class carries the ht- prefix for the same reason. Dark by default, light
+   under prefers-color-scheme: light — the editor's own behaviour. */
+.ht-widget {
+  --bg: oklch(0.145 0.004 286.98);
+  --bg-panel: oklch(0.205 0.006 286.98);
+  --bg-elev: oklch(0.269 0.008 286.98);
+  --bg-input: oklch(0.145 0.004 286.98);
+  --border: oklch(1 0.004 286.98 / 0.1);
+  --border-strong: oklch(1 0.005 286.98 / 0.22);
+  --text: oklch(0.985 0 0);
+  --text-dim: oklch(0.82 0.008 286.98);
+  --accent: oklch(0.82 0.065 286.98);
+  --accent-soft: oklch(0.82 0.065 286.98 / 0.14);
+  --accent-contrast: oklch(0.21 0.01 286.98);
+  --ring: oklch(0.7 0.045 286.98);
+  --green: oklch(0.85 0.168 155);
+  --green-soft: oklch(0.85 0.168 155 / 0.13);
+  --amber: oklch(0.85 0.103 75);
+  --amber-soft: oklch(0.85 0.103 75 / 0.15);
+  --red: oklch(0.85 0.065 25);
+  --shadow-panel: oklch(0.1 0.005 286.98 / 0.62);
+  --radius: 14px;
+  --radius-sm: 10px;
+  --dur-1: 120ms;
+  --dur-2: 180ms;
+  --dur-3: 260ms;
+  --ease-out: cubic-bezier(0.23, 1, 0.32, 1);
+  --font-sans: 'Geist Variable', 'Geist', -apple-system, 'Segoe UI', Roboto, sans-serif;
+  --mono: ui-monospace, 'SF Mono', Menlo, monospace;
+  color-scheme: dark;
+}
+
+@media (prefers-color-scheme: light) {
+  .ht-widget {
+    --bg: oklch(0.965 0.002 286.98);
+    --bg-panel: oklch(1 0 0);
+    --bg-elev: oklch(0.97 0.002 286.98);
+    --bg-input: oklch(1 0 0);
+    --border: oklch(0.92 0.003 286.98);
+    --border-strong: oklch(0.85 0.005 286.98);
+    --text: oklch(0.145 0.006 286.98);
+    --text-dim: oklch(0.5 0.012 286.98);
+    --accent: oklch(0.248 0.086 286.98);
+    --accent-soft: oklch(0.248 0.086 286.98 / 0.08);
+    --accent-contrast: oklch(0.985 0 0);
+    --ring: oklch(0.42 0.06 286.98);
+    --green: oklch(0.52 0.103 155);
+    --green-soft: oklch(0.52 0.103 155 / 0.1);
+    --amber: oklch(0.52 0.088 75);
+    --amber-soft: oklch(0.52 0.088 75 / 0.12);
+    --red: oklch(0.55 0.178 25);
+    --shadow-panel: oklch(0.25 0.01 286.98 / 0.22);
+    color-scheme: light;
+  }
+}
+
+/* --- the widget ---------------------------------------------------------- */
+
+.ht-widget {
+  position: fixed;
+  right: 20px;
+  bottom: 20px;
+  z-index: 2147483000;
+  font-family: var(--font-sans);
+  font-size: 13px;
+  line-height: 1.5;
+  color: var(--text);
+}
+.ht-widget * {
+  box-sizing: border-box;
+}
+/* The UA rule for [hidden] is `display: none` at zero specificity, so any class
+   rule that sets display (.ht-panel, .ht-launcher) silently wins and the
+   collapsed state renders anyway. Restate it for the whole widget. */
+.ht-widget [hidden] {
+  display: none !important;
+}
+.ht-widget :focus-visible {
+  outline: 2px solid var(--ring);
+  outline-offset: 2px;
+}
+
+/* launcher: the collapsed state */
+.ht-widget .ht-launcher {
+  position: relative;
+  display: grid;
+  place-items: center;
+  width: 56px;
+  height: 56px;
+  margin-left: auto;
+  border: 1px solid var(--accent);
+  border-radius: 999px;
+  background: var(--accent);
+  color: var(--accent-contrast);
+  cursor: pointer;
+  box-shadow: 0 6px 20px var(--accent-soft);
+  transition:
+    filter var(--dur-1) var(--ease-out),
+    transform var(--dur-1) var(--ease-out);
+}
+.ht-widget .ht-launcher:hover {
+  filter: brightness(1.08);
+}
+.ht-widget .ht-launcher:active {
+  transform: scale(0.97);
+}
+/* an active call must stay visible while the panel is collapsed (§4.3) */
+.ht-widget .ht-live-dot {
+  position: absolute;
+  top: 4px;
+  right: 4px;
+  width: 10px;
+  height: 10px;
+  border-radius: 999px;
+  background: var(--green);
+  box-shadow: 0 0 0 3px var(--green-soft);
+}
+
+/* panel: the expanded state */
+.ht-widget .ht-panel {
+  display: flex;
+  flex-direction: column;
+  width: 360px;
+  /* taller than the log alone would need: the panel also holds the call
+     details form, and a squeezed log reads as broken */
+  height: min(600px, 100dvh - 32px);
+  background: var(--bg-panel);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  box-shadow: 0 12px 40px var(--shadow-panel);
+  overflow: hidden;
+  animation: ht-rise var(--dur-3) var(--ease-out);
+}
+@keyframes ht-rise {
+  from {
+    opacity: 0;
+    transform: translateY(8px);
+  }
+}
+.ht-widget .ht-head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 12px;
+  border-bottom: 1px solid var(--border);
+}
+.ht-widget .ht-title {
+  font-weight: 600;
+  margin-right: auto;
+}
+
+/* agent state pill — the editor's .voice-state */
+.ht-widget .ht-pill {
+  font-size: 12px;
+  color: var(--text-dim);
+  padding: 2px 10px;
+  border: 1px solid var(--border);
+  border-radius: 999px;
+  white-space: nowrap;
+}
+.ht-widget .ht-pill.listening {
+  color: var(--green);
+  border-color: var(--green);
+}
+.ht-widget .ht-pill.speaking {
+  color: var(--accent);
+  border-color: var(--accent);
+}
+.ht-widget .ht-pill.thinking {
+  color: var(--text);
+}
+.ht-widget .ht-timer {
+  font-family: var(--mono);
+  font-size: 12px;
+  font-variant-numeric: tabular-nums;
+  color: var(--text-dim);
+}
+
+/* icon buttons — the base button of the editor */
+.ht-widget .ht-icon {
+  display: grid;
+  place-items: center;
+  width: 26px;
+  height: 26px;
+  padding: 0;
+  font: inherit;
+  color: inherit;
+  background: var(--bg-elev);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  cursor: pointer;
+  transition:
+    border-color var(--dur-1) var(--ease-out),
+    transform var(--dur-1) var(--ease-out);
+}
+.ht-widget .ht-icon:hover {
+  border-color: var(--accent);
+}
+.ht-widget .ht-icon:active:not(:disabled) {
+  transform: scale(0.97);
+}
+.ht-widget .ht-icon:disabled {
+  opacity: 0.45;
+  cursor: default;
+}
+
+/* transcript — the editor's .chat with .msg-agent / .msg-user / .msg-system */
+.ht-widget .ht-log {
+  flex: 1;
+  min-height: 96px;
+  overflow-y: auto;
+  padding: 10px 14px;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+.ht-widget .ht-msg {
+  max-width: 85%;
+  padding: 7px 11px;
+  border-radius: var(--radius);
+  white-space: pre-wrap;
+  word-break: break-word;
+}
+.ht-widget .ht-msg.agent {
+  background: var(--bg-elev);
+  align-self: flex-start;
+}
+.ht-widget .ht-msg.user {
+  background: var(--accent-soft);
+  align-self: flex-end;
+}
+.ht-widget .ht-msg.interim {
+  opacity: 0.6;
+  font-style: italic;
+}
+.ht-widget .ht-msg.system {
+  max-width: 100%;
+  align-self: center;
+  background: none;
+  color: var(--text-dim);
+  font-size: 12px;
+  text-align: center;
+}
+.ht-widget .ht-empty {
+  color: var(--text-dim);
+  font-size: 12px;
+  margin: auto;
+}
+
+/* raw SDK state: the page is also a debugging tool for the integration */
+.ht-widget .ht-debug {
+  font-family: var(--mono);
+  font-size: 11.5px;
+  color: var(--text-dim);
+  padding: 6px 14px;
+  border-top: 1px solid var(--border);
+  white-space: pre-wrap;
+  max-height: 5.5em;
+  overflow-y: auto;
+}
+
+/* composer — the editor's .chat-input-row on a .test-input strip */
+.ht-widget .ht-composer {
+  display: flex;
+  gap: 6px;
+  align-items: center;
+  padding: 8px 10px;
+  border-top: 1px solid var(--border);
+}
+.ht-widget .ht-composer input {
+  flex: 1;
+  min-width: 0;
+  font: inherit;
+  color: var(--text);
+  background: var(--bg-input);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  padding: 6px 10px;
+  transition: border-color var(--dur-1) var(--ease-out);
+}
+.ht-widget .ht-composer input:focus {
+  border-color: var(--accent);
+  outline: none;
+}
+.ht-widget .ht-composer input:disabled {
+  opacity: 0.45;
+}
+
+/* call controls — the editor's .run-btn and .run-btn.danger */
+.ht-widget .ht-actions {
+  display: flex;
+  gap: 8px;
+  padding: 0 10px 12px;
+}
+.ht-widget .ht-btn {
+  flex: 1;
+  font: inherit;
+  font-weight: 600;
+  white-space: nowrap;
+  color: var(--accent-contrast);
+  background: var(--accent);
+  border: 1px solid var(--accent);
+  border-radius: 999px;
+  padding: 7px 14px;
+  cursor: pointer;
+  box-shadow: 0 1px 8px var(--accent-soft);
+  transition:
+    filter var(--dur-1) var(--ease-out),
+    box-shadow var(--dur-1) var(--ease-out);
+}
+.ht-widget .ht-btn:hover:not(:disabled) {
+  filter: brightness(1.08);
+}
+.ht-widget .ht-btn:disabled {
+  opacity: 0.45;
+  cursor: default;
+  box-shadow: none;
+}
+.ht-widget .ht-btn-danger {
+  background: var(--red);
+  border-color: var(--red);
+  box-shadow: none;
+}
+
+@media (max-width: 480px) {
+  .ht-widget {
+    right: 8px;
+    left: 8px;
+    bottom: 8px;
+  }
+  .ht-widget .ht-panel {
+    width: 100%;
+    height: min(560px, 100dvh - 16px);
+  }
+}
+
+/* --- dynamic-variable form: shared by the widget and the call page ------- */
+
+/* Native <details> instead of a scripted toggle — the browser already owns
+   the open state, the keyboard and the semantics. */
+.ht-widget .ht-details {
+  border-bottom: 1px solid var(--border);
+  /* shrinkable, so however many fields are declared the panel still ends
+     where it should — the block scrolls instead of pushing the composer out.
+     During a call it is hidden altogether and the log takes the room back. */
+  flex: 0 1 auto;
+  max-height: 58%;
+  overflow-y: auto;
+}
+.ht-widget .ht-details > summary {
+  padding: 8px 14px;
+  font-size: 12px;
+  font-weight: 600;
+  letter-spacing: 0.02em;
+  color: var(--text-dim);
+  cursor: pointer;
+  list-style: none;
+}
+.ht-widget .ht-details > summary::marker,
+.ht-widget .ht-details > summary::-webkit-details-marker {
+  display: none;
+}
+.ht-widget .ht-details > summary::before {
+  content: '▸';
+  display: inline-block;
+  width: 1em;
+  transition: transform var(--dur-1) var(--ease-out);
+}
+.ht-widget .ht-details[open] > summary::before {
+  transform: rotate(90deg);
+}
+.ht-widget .ht-details > summary:hover {
+  color: var(--text);
+}
+.ht-widget .ht-details .ht-fields {
+  padding: 0 14px 12px;
+}
+.ht-widget .ht-fields {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 10px;
+}
+.ht-widget .ht-field {
+  display: flex;
+  flex: 1 1 100%;
+  flex-direction: column;
+  gap: 5px;
+  min-width: 0;
+}
+.ht-widget .ht-field.half {
+  flex-basis: calc(50% - 5px);
+}
+.ht-widget .ht-field-label {
+  font-size: 12px;
+  font-weight: 600;
+  color: var(--text-dim);
+}
+.ht-widget .ht-field input {
+  font: inherit;
+  width: 100%;
+  color: var(--text);
+  background: var(--bg-input);
+  border: 1px solid var(--border-strong);
+  border-radius: var(--radius-sm);
+  padding: 8px 11px;
+  transition: border-color var(--dur-1) var(--ease-out);
+}
+.ht-widget .ht-field input:hover:not(:read-only) {
+  border-color: var(--ring);
+}
+.ht-widget .ht-field input:focus {
+  border-color: var(--accent);
+  outline: none;
+  box-shadow: 0 0 0 3px var(--accent-soft);
+}
+.ht-widget .ht-field input:read-only {
+  color: var(--text-dim);
+  background: var(--bg-elev);
+  cursor: default;
+}
+/* free-form page: a variable is a key/value row the visitor types */
+.ht-widget .ht-pair {
+  flex-direction: row;
+  align-items: center;
+  gap: 6px;
+}
+.ht-widget .ht-pair input {
+  flex: 1 1 0;
+}
+.ht-widget .ht-pair .ht-icon {
+  flex: none;
+}
+.ht-widget .ht-details .ht-add-var {
+  margin: 0 14px 12px;
+}
+
+.ht-widget .ht-field-note {
+  flex: 1 1 100%;
+  margin: 0;
+  font-size: 12px;
+  color: var(--text-dim);
+}
+
+/* the secondary action next to Call: chat-only, no microphone, no audio */
+.ht-widget .ht-btn-ghost {
+  color: var(--text);
+  background: none;
+  border-color: var(--border-strong);
+  box-shadow: none;
+}
+.ht-widget .ht-btn-ghost:hover:not(:disabled) {
+  border-color: var(--accent);
+  filter: none;
+}
+
+/* --- avatar mode (VPT-857 §2) ------------------------------------------- */
+
+/* the panel sits above the chat launcher, which stays fixed in the corner */
+.ht-widget[data-mode='avatar'] .ht-panel {
+  position: absolute;
+  bottom: 72px;
+  right: 0;
+  height: min(540px, 100dvh - 270px);
+}
+.ht-widget .ht-enable-sound {
+  margin: 8px 10px 0;
+}
+.ht-widget .ht-avatar {
+  overflow: visible;
+  position: fixed;
+  /* --ht-avatar-size: the circle diameter, set by `avatar.size` or by the
+     host page on .ht-widget; phones scale it by 6/7 below */
+  width: var(--ht-avatar-size, 140px);
+  height: var(--ht-avatar-size, 140px);
+  padding: 0;
+  border-radius: 50%;
+  border: 3px solid var(--bg-panel);
+  outline: 2px solid var(--border-strong);
+  box-shadow: 0 12px 40px var(--shadow-panel);
+  touch-action: none;
+  user-select: none;
+  background: var(--bg-elev);
+  cursor: pointer;
+  z-index: 1;
+}
+.ht-widget .ht-avatar img,
+.ht-widget .ht-avatar-video,
+.ht-widget .ht-avatar-live,
+.ht-widget .video-js,
+.ht-widget .vjs-tech {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+  border-radius: 50%;
+  overflow: hidden;
+  pointer-events: none;
+}
+.ht-widget .ht-avatar-video {
+  display: block;
+}
+.ht-widget .ht-avatar-live {
+  background: var(--bg-elev);
+}
+/* status under the circle and the AI label above it — the pill's look */
+.ht-widget .ht-avatar-status,
+.ht-widget .ht-avatar-ai {
+  position: absolute;
+  left: 50%;
+  transform: translateX(-50%);
+  white-space: nowrap;
+  font-size: 11px;
+  color: var(--text-dim);
+  padding: 2px 9px;
+  border: 1px solid var(--border);
+  border-radius: 999px;
+  background: var(--bg-panel);
+  box-shadow: 0 4px 14px var(--shadow-panel);
+}
+.ht-widget .ht-avatar-status {
+  top: calc(100% + 10px);
+}
+.ht-widget .ht-avatar-ai {
+  top: -10px;
+  font-size: 10px;
+  letter-spacing: 0.02em;
+}
+.ht-widget .ht-mic {
+  position: absolute;
+  bottom: 0;
+  right: 0;
+  display: grid;
+  place-items: center;
+  width: 32px;
+  height: 32px;
+  border-radius: 50%;
+  background: var(--accent);
+  color: var(--accent-contrast);
+  border: 2px solid var(--bg-panel);
+}
+.ht-widget .ht-mic svg {
+  width: 18px;
+  height: 18px;
+}
+.ht-widget .ht-mic-slash {
+  display: none;
+}
+.ht-widget .ht-muted {
+  background: var(--bg-elev);
+  color: var(--text-dim);
+}
+.ht-widget .ht-muted .ht-mic-slash {
+  display: block;
+}
+.ht-widget .ht-avatar[data-state='listening'] {
+  outline: 3px solid var(--green);
+}
+.ht-widget .ht-avatar[data-state='speaking'] {
+  outline: 3px solid var(--accent);
+  animation: ht-speaking 1.4s ease-in-out infinite;
+}
+.ht-widget .ht-avatar:focus-visible {
+  outline: 2px solid var(--ring);
+  outline-offset: 6px;
+}
+@keyframes ht-speaking {
+  50% {
+    box-shadow: 0 0 0 9px var(--accent-soft);
+  }
+}
+@media (prefers-reduced-motion: reduce) {
+  .ht-widget .ht-avatar[data-state],
+  .ht-widget .ht-panel {
+    animation: none;
+    transition: none;
+  }
+}
+@media (max-width: 480px) {
+  .ht-widget .ht-avatar {
+    width: calc(var(--ht-avatar-size, 140px) * 6 / 7);
+    height: calc(var(--ht-avatar-size, 140px) * 6 / 7);
+  }
+}
+@media (max-height: 500px) and (min-width: 500px) {
+  .ht-widget[data-mode='avatar'] .ht-panel {
+    height: calc(100dvh - 104px);
+    width: min(360px, calc(100vw - 160px));
+  }
+}

package/dist/widget.d.ts

@@ -0,0 +1,40 @@
+import type { StartCallParams } from './types';
+/**
+ * VPT-857 D1: the clip FAILOVER of avatar mode — poster and silent loops the
+ * integrator hosts, shown whenever the live avatar video is absent.
+ */
+export interface AvatarMedia {
+    posterUrl: string;
+    listeningVideoUrl: string;
+    speakingVideoUrl: string;
+    /**
+     * Diameter of the avatar circle in CSS pixels; default 140 (phones scale
+     * it down by the same ratio the default does). The microphone badge and
+     * the status pill keep their size.
+     */
+    size?: number;
+}
+/** The default circle diameter — DEFAULT_AVATAR_SIZE × 6/7 on phones. */
+export declare const DEFAULT_AVATAR_SIZE = 140;
+/**
+ * VPT-857 §1.1: what the widget tells the integrator's backend about the
+ * call it is about to start. `avatar: true` in avatar mode — the backend
+ * forwards it as `avatar: true` of `POST /v1/calls/web`; the live avatar then
+ * starts only if the agent's avatar setting is on too.
+ */
+export interface CreateSessionContext {
+    avatar: boolean;
+}
+export interface WidgetOptions {
+    container: HTMLElement;
+    mode?: 'standard' | 'avatar';
+    /** Zero-argument callbacks keep working: the context is an extra argument. */
+    createSession: (context: CreateSessionContext) => Promise<StartCallParams>;
+    renderCallDetails?: (container: HTMLElement) => void;
+    avatar?: AvatarMedia;
+}
+export interface WidgetHandle {
+    destroy(): void;
+}
+/** Mount one isolated widget; credentials remain in the host's backend. */
+export declare function mountWidget(options: WidgetOptions): WidgetHandle;