@wix/legends-platform-sdk 1.31.0 → 1.33.0

package/dist/esm/startup-telemetry/attempt.js

@@ -0,0 +1,180 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+/* eslint-env es2020 */
+/** All elapsed times belong to one browser document's monotonic clock. */
+
+function newId() {
+  var _globalThis$crypto;
+  return ((_globalThis$crypto = globalThis.crypto) == null || _globalThis$crypto.randomUUID == null ? void 0 : _globalThis$crypto.randomUUID()) || `startup-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+export function createStartupIntent() {
+  return {
+    id: newId(),
+    startedAt: performance.now(),
+    timeOrigin: performance.timeOrigin
+  };
+}
+export class StartupAttempt {
+  constructor(options, chatId, intent) {
+    this.options = options;
+    this.chatId = chatId;
+    _defineProperty(this, "terminal", false);
+    _defineProperty(this, "adoptedBySdk", false);
+    _defineProperty(this, "seen", new Set());
+    _defineProperty(this, "conversationId", void 0);
+    _defineProperty(this, "timeout", void 0);
+    _defineProperty(this, "id", void 0);
+    _defineProperty(this, "startedAt", void 0);
+    _defineProperty(this, "startBoundary", void 0);
+    _defineProperty(this, "visibilityChanged", () => {
+      if (document.visibilityState !== 'visible') {
+        this.finish('unmeasurable', 'hidden_document');
+      }
+    });
+    const now = performance.now();
+    const valid = intent && intent.timeOrigin === performance.timeOrigin && Number.isFinite(intent.startedAt) && intent.startedAt >= 0 && intent.startedAt <= now;
+    this.id = valid ? intent.id : newId();
+    this.startedAt = valid ? intent.startedAt : now;
+    this.startBoundary = valid ? 'user_intent' : 'sdk_create';
+    this.timeout = setTimeout(() => this.finish('timeout'), Math.max(0, 120000 - (now - this.startedAt)));
+    this.mark('attempt_started');
+    if (typeof document !== 'undefined') {
+      document.addEventListener('visibilitychange', this.visibilityChanged);
+      this.visibilityChanged();
+    }
+  }
+
+  /** A pre-SDK terminal attempt must be adopted once, not counted again. */
+  claimForSdk() {
+    if (this.adoptedBySdk) {
+      return false;
+    }
+    this.adoptedBySdk = true;
+    return true;
+  }
+  get completed() {
+    return this.terminal;
+  }
+  attachChat(chatId) {
+    this.chatId = chatId;
+  }
+  bind(conversationId) {
+    this.conversationId = conversationId;
+  }
+  mark(milestone, method) {
+    if (this.terminal || this.seen.has(milestone)) {
+      return;
+    }
+    this.seen.add(milestone);
+    this.send(milestone, 'pending', method);
+  }
+  frame(method) {
+    this.finish('success', method);
+  }
+  finish(outcome, method) {
+    if (this.terminal) {
+      return;
+    }
+    this.terminal = true;
+    clearTimeout(this.timeout);
+    if (typeof document !== 'undefined') {
+      document.removeEventListener('visibilitychange', this.visibilityChanged);
+    }
+    this.send(outcome === 'success' ? 'first_frame' : 'terminal', outcome, method);
+  }
+  send(milestone, outcome, method) {
+    const elapsed = performance.now() - this.startedAt;
+    if (!Number.isFinite(elapsed) || elapsed < 0) {
+      return;
+    }
+    try {
+      var _this$options$report, _this$options;
+      const result = (_this$options$report = (_this$options = this.options).report) == null ? void 0 : _this$options$report.call(_this$options, {
+        attemptId: this.id,
+        chatId: this.chatId,
+        conversationId: this.conversationId,
+        milestone,
+        elapsedMs: Math.ceil(elapsed),
+        clientStartUnixMs: Math.floor(performance.timeOrigin + this.startedAt),
+        outcome,
+        startBoundary: this.startBoundary,
+        method,
+        application: this.options.application,
+        applicationVersion: this.options.applicationVersion,
+        entryCoverage: this.options.entryCoverage || 'sdk_only',
+        measurementVersion: 1
+      });
+      // BI failures must not produce unhandled promise rejections or break media.
+      if (result) {
+        void Promise.resolve(result).catch(() => undefined);
+      }
+    } catch {
+      /* Reporting is best effort; conversation behavior is unchanged. */
+    }
+  }
+}
+export class StartupTelemetrySession {
+  constructor(options, chatId) {
+    this.options = options;
+    this.chatId = chatId;
+    _defineProperty(this, "attempts", new Map());
+    _defineProperty(this, "leases", new Map());
+    _defineProperty(this, "active", void 0);
+    _defineProperty(this, "terminalAtCreation", void 0);
+    _defineProperty(this, "intentConsumed", false);
+  }
+  start() {
+    if (!this.options.enabled || !this.options.report) {
+      return undefined;
+    }
+    if (this.active && (!this.active.completed || this.active === this.terminalAtCreation && (this.leases.get(this.active) || 0) === 0)) {
+      this.leases.set(this.active, (this.leases.get(this.active) || 0) + 1);
+      return this.active;
+    }
+    const provided = !this.intentConsumed && this.options.attempt && this.options.attempt.claimForSdk() ? this.options.attempt : undefined;
+    const attempt = provided || new StartupAttempt({
+      ...this.options,
+      entryCoverage: 'sdk_only'
+    }, this.chatId, this.intentConsumed ? undefined : this.options.intent);
+    attempt.attachChat(this.chatId);
+    this.intentConsumed = true;
+    this.active = attempt;
+    this.terminalAtCreation = attempt.completed ? attempt : undefined;
+    this.leases.set(attempt, 1);
+    return attempt;
+  }
+  bind(attempt, id) {
+    if (!attempt) {
+      return;
+    }
+    attempt.bind(id);
+    this.attempts.set(id, attempt);
+    // A provider normally owns one conversation; bound memory across retries.
+    if (this.attempts.size > 8) {
+      var _this$attempts$get;
+      const oldest = this.attempts.keys().next().value;
+      (_this$attempts$get = this.attempts.get(oldest)) == null || _this$attempts$get.finish('cancelled');
+      this.attempts.delete(oldest);
+    }
+  }
+  get(id) {
+    return id ? this.attempts.get(id) : undefined;
+  }
+  release(attempt) {
+    if (!attempt) {
+      return;
+    }
+    this.leases.set(attempt, Math.max(0, (this.leases.get(attempt) || 0) - 1));
+    // StrictMode immediately replays effects. Cancel only if no setup reclaimed
+    // this attempt by the microtask boundary; real unmounts still terminate it.
+    void Promise.resolve().then(() => {
+      if (this.leases.get(attempt) === 0) {
+        attempt.finish('cancelled');
+        this.leases.delete(attempt);
+        if (this.active === attempt) {
+          this.active = undefined;
+        }
+      }
+    });
+  }
+}
+//# sourceMappingURL=attempt.js.map

package/dist/esm/startup-telemetry/attempt.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["newId","_globalThis$crypto","globalThis","crypto","randomUUID","Date","now","Math","random","toString","slice","createStartupIntent","id","startedAt","performance","timeOrigin","StartupAttempt","constructor","options","chatId","intent","_defineProperty","Set","document","visibilityState","finish","valid","Number","isFinite","startBoundary","timeout","setTimeout","max","mark","addEventListener","visibilityChanged","claimForSdk","adoptedBySdk","completed","terminal","attachChat","bind","conversationId","milestone","method","seen","has","add","send","frame","outcome","clearTimeout","removeEventListener","elapsed","_this$options$report","_this$options","result","report","call","attemptId","elapsedMs","ceil","clientStartUnixMs","floor","application","applicationVersion","entryCoverage","measurementVersion","Promise","resolve","catch","undefined","StartupTelemetrySession","Map","start","enabled","active","terminalAtCreation","leases","get","set","provided","intentConsumed","attempt","attempts","size","_this$attempts$get","oldest","keys","next","value","delete","release","then"],"sources":["../../../src/startup-telemetry/attempt.ts"],"sourcesContent":["/* eslint-env es2020 */\n/** All elapsed times belong to one browser document's monotonic clock. */\nexport type StartupMilestone =\n  | 'attempt_started'\n  | 'api_request'\n  | 'api_response'\n  | 'join_requested'\n  | 'room_connected'\n  | 'agent_joined'\n  | 'track_subscribed'\n  | 'first_frame'\n  | 'terminal';\nexport type StartupOutcome =\n  | 'pending'\n  | 'success'\n  | 'error'\n  | 'cancelled'\n  | 'timeout'\n  | 'unmeasurable';\nexport type StartupIntent = {\n  id: string;\n  startedAt: number;\n  timeOrigin: number;\n};\nexport type StartupReport = {\n  attemptId: string;\n  chatId: string;\n  conversationId?: string;\n  milestone: StartupMilestone;\n  elapsedMs: number;\n  clientStartUnixMs: number;\n  outcome: StartupOutcome;\n  startBoundary: 'user_intent' | 'sdk_create';\n  method?: string;\n  application: string;\n  applicationVersion?: string;\n  entryCoverage: 'user_handler' | 'sdk_only';\n  measurementVersion: number;\n};\nexport type StartupTelemetryOptions = {\n  enabled: boolean;\n  intent?: StartupIntent;\n  attempt?: StartupAttempt;\n  application: string;\n  applicationVersion?: string;\n  entryCoverage?: 'user_handler' | 'sdk_only';\n  report?: (event: StartupReport) => void | Promise<unknown>;\n};\n\nfunction newId() {\n  return (\n    globalThis.crypto?.randomUUID?.() ||\n    `startup-${Date.now()}-${Math.random().toString(36).slice(2)}`\n  );\n}\n\nexport function createStartupIntent(): StartupIntent {\n  return {\n    id: newId(),\n    startedAt: performance.now(),\n    timeOrigin: performance.timeOrigin,\n  };\n}\n\nexport class StartupAttempt {\n  private terminal = false;\n  private adoptedBySdk = false;\n  private seen = new Set<StartupMilestone>();\n  private conversationId?: string;\n  private timeout?: ReturnType<typeof setTimeout>;\n  readonly id: string;\n  readonly startedAt: number;\n  readonly startBoundary: 'user_intent' | 'sdk_create';\n  private visibilityChanged = () => {\n    if (document.visibilityState !== 'visible') {\n      this.finish('unmeasurable', 'hidden_document');\n    }\n  };\n\n  constructor(\n    private options: StartupTelemetryOptions,\n    private chatId: string,\n    intent?: StartupIntent,\n  ) {\n    const now = performance.now();\n    const valid =\n      intent &&\n      intent.timeOrigin === performance.timeOrigin &&\n      Number.isFinite(intent.startedAt) &&\n      intent.startedAt >= 0 &&\n      intent.startedAt <= now;\n    this.id = valid ? intent.id : newId();\n    this.startedAt = valid ? intent.startedAt : now;\n    this.startBoundary = valid ? 'user_intent' : 'sdk_create';\n    this.timeout = setTimeout(\n      () => this.finish('timeout'),\n      Math.max(0, 120000 - (now - this.startedAt)),\n    );\n    this.mark('attempt_started');\n    if (typeof document !== 'undefined') {\n      document.addEventListener('visibilitychange', this.visibilityChanged);\n      this.visibilityChanged();\n    }\n  }\n\n  /** A pre-SDK terminal attempt must be adopted once, not counted again. */\n  claimForSdk() {\n    if (this.adoptedBySdk) {\n      return false;\n    }\n    this.adoptedBySdk = true;\n    return true;\n  }\n\n  get completed() {\n    return this.terminal;\n  }\n\n  attachChat(chatId: string) {\n    this.chatId = chatId;\n  }\n\n  bind(conversationId: string) {\n    this.conversationId = conversationId;\n  }\n\n  mark(milestone: StartupMilestone, method?: string) {\n    if (this.terminal || this.seen.has(milestone)) {\n      return;\n    }\n    this.seen.add(milestone);\n    this.send(milestone, 'pending', method);\n  }\n\n  frame(method: string) {\n    this.finish('success', method);\n  }\n\n  finish(outcome: Exclude<StartupOutcome, 'pending'>, method?: string) {\n    if (this.terminal) {\n      return;\n    }\n    this.terminal = true;\n    clearTimeout(this.timeout);\n    if (typeof document !== 'undefined') {\n      document.removeEventListener('visibilitychange', this.visibilityChanged);\n    }\n    this.send(\n      outcome === 'success' ? 'first_frame' : 'terminal',\n      outcome,\n      method,\n    );\n  }\n\n  private send(\n    milestone: StartupMilestone,\n    outcome: StartupOutcome,\n    method?: string,\n  ) {\n    const elapsed = performance.now() - this.startedAt;\n    if (!Number.isFinite(elapsed) || elapsed < 0) {\n      return;\n    }\n    try {\n      const result = this.options.report?.({\n        attemptId: this.id,\n        chatId: this.chatId,\n        conversationId: this.conversationId,\n        milestone,\n        elapsedMs: Math.ceil(elapsed),\n        clientStartUnixMs: Math.floor(performance.timeOrigin + this.startedAt),\n        outcome,\n        startBoundary: this.startBoundary,\n        method,\n        application: this.options.application,\n        applicationVersion: this.options.applicationVersion,\n        entryCoverage: this.options.entryCoverage || 'sdk_only',\n        measurementVersion: 1,\n      });\n      // BI failures must not produce unhandled promise rejections or break media.\n      if (result) {\n        void Promise.resolve(result).catch(() => undefined);\n      }\n    } catch {\n      /* Reporting is best effort; conversation behavior is unchanged. */\n    }\n  }\n}\n\nexport class StartupTelemetrySession {\n  private attempts = new Map<string, StartupAttempt>();\n  private leases = new Map<StartupAttempt, number>();\n  private active?: StartupAttempt;\n  private terminalAtCreation?: StartupAttempt;\n  private intentConsumed = false;\n  constructor(\n    private options: StartupTelemetryOptions,\n    private chatId: string,\n  ) {}\n\n  start(): StartupAttempt | undefined {\n    if (!this.options.enabled || !this.options.report) {\n      return undefined;\n    }\n    if (\n      this.active &&\n      (!this.active.completed ||\n        (this.active === this.terminalAtCreation &&\n          (this.leases.get(this.active) || 0) === 0))\n    ) {\n      this.leases.set(this.active, (this.leases.get(this.active) || 0) + 1);\n      return this.active;\n    }\n    const provided =\n      !this.intentConsumed &&\n      this.options.attempt &&\n      this.options.attempt.claimForSdk()\n        ? this.options.attempt\n        : undefined;\n    const attempt =\n      provided ||\n      new StartupAttempt(\n        { ...this.options, entryCoverage: 'sdk_only' },\n        this.chatId,\n        this.intentConsumed ? undefined : this.options.intent,\n      );\n    attempt.attachChat(this.chatId);\n    this.intentConsumed = true;\n    this.active = attempt;\n    this.terminalAtCreation = attempt.completed ? attempt : undefined;\n    this.leases.set(attempt, 1);\n    return attempt;\n  }\n\n  bind(attempt: StartupAttempt | undefined, id: string) {\n    if (!attempt) {\n      return;\n    }\n    attempt.bind(id);\n    this.attempts.set(id, attempt);\n    // A provider normally owns one conversation; bound memory across retries.\n    if (this.attempts.size > 8) {\n      const oldest = this.attempts.keys().next().value as string;\n      this.attempts.get(oldest)?.finish('cancelled');\n      this.attempts.delete(oldest);\n    }\n  }\n\n  get(id?: string) {\n    return id ? this.attempts.get(id) : undefined;\n  }\n  release(attempt?: StartupAttempt) {\n    if (!attempt) {\n      return;\n    }\n    this.leases.set(attempt, Math.max(0, (this.leases.get(attempt) || 0) - 1));\n    // StrictMode immediately replays effects. Cancel only if no setup reclaimed\n    // this attempt by the microtask boundary; real unmounts still terminate it.\n    void Promise.resolve().then(() => {\n      if (this.leases.get(attempt) === 0) {\n        attempt.finish('cancelled');\n        this.leases.delete(attempt);\n        if (this.active === attempt) {\n          this.active = undefined;\n        }\n      }\n    });\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/startup-telemetry/frame.js

@@ -0,0 +1,77 @@
+/** A presentation milestone, not proof of photons or user attention. */
+export function isSurfaceVisible(element) {
+  if (document.visibilityState !== 'visible' || !element.isConnected) {
+    return false;
+  }
+  const bounds = element.getBoundingClientRect();
+  if (bounds.width <= 0 || bounds.height <= 0 || bounds.bottom <= 0 || bounds.right <= 0 || bounds.top >= innerHeight || bounds.left >= innerWidth) {
+    return false;
+  }
+  for (let current = element; current; current = current.parentElement) {
+    const style = getComputedStyle(current);
+    if (style.display === 'none' || style.visibility === 'hidden' || style.visibility === 'collapse' || style.opacity !== '' && Number(style.opacity) === 0) {
+      return false;
+    }
+  }
+  return true;
+}
+export function recordCanvasFrame(attempt, canvas, video) {
+  if (!attempt || attempt.completed || video.readyState < 2 || !canvas.width || !canvas.height) {
+    return;
+  }
+  if (document.visibilityState !== 'visible') {
+    attempt.finish('unmeasurable', 'hidden_document');
+    return;
+  }
+  if (isSurfaceVisible(canvas)) {
+    attempt.frame('canvas_draw');
+  }
+}
+export function observeVideoFrame(attempt, video) {
+  if (attempt.completed) {
+    return () => undefined;
+  }
+  if (document.visibilityState !== 'visible') {
+    attempt.finish('unmeasurable', 'hidden_document');
+    return () => undefined;
+  }
+  if (!video.requestVideoFrameCallback) {
+    attempt.finish('unmeasurable', 'unsupported_video_frame_callback');
+    return () => undefined;
+  }
+  let active = true;
+  let handle;
+  const stop = () => {
+    active = false;
+    document.removeEventListener('visibilitychange', visibilityChanged);
+    if (handle !== undefined) {
+      video.cancelVideoFrameCallback(handle);
+    }
+  };
+  function visibilityChanged() {
+    if (document.visibilityState !== 'visible') {
+      attempt.finish('unmeasurable', 'hidden_document');
+      stop();
+    }
+  }
+  const frame = () => {
+    if (!active || attempt.completed) {
+      stop();
+      return;
+    }
+    if (document.visibilityState !== 'visible') {
+      visibilityChanged();
+      return;
+    }
+    if (isSurfaceVisible(video)) {
+      attempt.frame('video_frame_callback');
+      stop();
+      return;
+    }
+    handle = video.requestVideoFrameCallback(frame);
+  };
+  document.addEventListener('visibilitychange', visibilityChanged);
+  handle = video.requestVideoFrameCallback(frame);
+  return stop;
+}
+//# sourceMappingURL=frame.js.map

package/dist/esm/startup-telemetry/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isSurfaceVisible","element","document","visibilityState","isConnected","bounds","getBoundingClientRect","width","height","bottom","right","top","innerHeight","left","innerWidth","current","parentElement","style","getComputedStyle","display","visibility","opacity","Number","recordCanvasFrame","attempt","canvas","video","completed","readyState","finish","frame","observeVideoFrame","undefined","requestVideoFrameCallback","active","handle","stop","removeEventListener","visibilityChanged","cancelVideoFrameCallback","addEventListener"],"sources":["../../../src/startup-telemetry/frame.ts"],"sourcesContent":["import type { StartupAttempt } from './attempt';\n\n/** A presentation milestone, not proof of photons or user attention. */\nexport function isSurfaceVisible(element: HTMLElement): boolean {\n  if (document.visibilityState !== 'visible' || !element.isConnected) {\n    return false;\n  }\n  const bounds = element.getBoundingClientRect();\n  if (\n    bounds.width <= 0 ||\n    bounds.height <= 0 ||\n    bounds.bottom <= 0 ||\n    bounds.right <= 0 ||\n    bounds.top >= innerHeight ||\n    bounds.left >= innerWidth\n  ) {\n    return false;\n  }\n  for (\n    let current: HTMLElement | null = element;\n    current;\n    current = current.parentElement\n  ) {\n    const style = getComputedStyle(current);\n    if (\n      style.display === 'none' ||\n      style.visibility === 'hidden' ||\n      style.visibility === 'collapse' ||\n      (style.opacity !== '' && Number(style.opacity) === 0)\n    ) {\n      return false;\n    }\n  }\n  return true;\n}\n\nexport function recordCanvasFrame(\n  attempt: StartupAttempt | undefined,\n  canvas: HTMLCanvasElement,\n  video: HTMLVideoElement,\n) {\n  if (\n    !attempt ||\n    attempt.completed ||\n    video.readyState < 2 ||\n    !canvas.width ||\n    !canvas.height\n  ) {\n    return;\n  }\n  if (document.visibilityState !== 'visible') {\n    attempt.finish('unmeasurable', 'hidden_document');\n    return;\n  }\n  if (isSurfaceVisible(canvas)) {\n    attempt.frame('canvas_draw');\n  }\n}\n\nexport function observeVideoFrame(\n  attempt: StartupAttempt,\n  video: HTMLVideoElement,\n): () => void {\n  if (attempt.completed) {\n    return () => undefined;\n  }\n  if (document.visibilityState !== 'visible') {\n    attempt.finish('unmeasurable', 'hidden_document');\n    return () => undefined;\n  }\n  if (!video.requestVideoFrameCallback) {\n    attempt.finish('unmeasurable', 'unsupported_video_frame_callback');\n    return () => undefined;\n  }\n  let active = true;\n  let handle: number | undefined;\n  const stop = () => {\n    active = false;\n    document.removeEventListener('visibilitychange', visibilityChanged);\n    if (handle !== undefined) {\n      video.cancelVideoFrameCallback(handle);\n    }\n  };\n  function visibilityChanged() {\n    if (document.visibilityState !== 'visible') {\n      attempt.finish('unmeasurable', 'hidden_document');\n      stop();\n    }\n  }\n  const frame = () => {\n    if (!active || attempt.completed) {\n      stop();\n      return;\n    }\n    if (document.visibilityState !== 'visible') {\n      visibilityChanged();\n      return;\n    }\n    if (isSurfaceVisible(video)) {\n      attempt.frame('video_frame_callback');\n      stop();\n      return;\n    }\n    handle = video.requestVideoFrameCallback(frame);\n  };\n  document.addEventListener('visibilitychange', visibilityChanged);\n  handle = video.requestVideoFrameCallback(frame);\n  return stop;\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/startup-telemetry/useStartupAttempt.js

@@ -0,0 +1,10 @@
+import { useAtomValue } from 'jotai';
+import { state } from '../conversation';
+import { useSdkConsumer } from '../sdk-consumer';
+export function useStartupAttempt() {
+  const _useSdkConsumer = useSdkConsumer(),
+    startupTelemetrySession = _useSdkConsumer.startupTelemetrySession;
+  const conversation = useAtomValue(state.conversation);
+  return startupTelemetrySession == null ? void 0 : startupTelemetrySession.get(conversation == null ? void 0 : conversation.id);
+}
+//# sourceMappingURL=useStartupAttempt.js.map

package/dist/esm/startup-telemetry/useStartupAttempt.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useAtomValue","state","useSdkConsumer","useStartupAttempt","_useSdkConsumer","startupTelemetrySession","conversation","get","id"],"sources":["../../../src/startup-telemetry/useStartupAttempt.ts"],"sourcesContent":["import { useAtomValue } from 'jotai';\nimport { state } from '../conversation';\nimport { useSdkConsumer } from '../sdk-consumer';\n\nexport function useStartupAttempt() {\n  const { startupTelemetrySession } = useSdkConsumer();\n  const conversation = useAtomValue(state.conversation);\n  return startupTelemetrySession?.get(conversation?.id);\n}\n"],"mappings":"AAAA,SAASA,YAAY,QAAQ,OAAO;AACpC,SAASC,KAAK,QAAQ,iBAAiB;AACvC,SAASC,cAAc,QAAQ,iBAAiB;AAEhD,OAAO,SAASC,iBAAiBA,CAAA,EAAG;EAClC,MAAAC,eAAA,GAAoCF,cAAc,CAAC,CAAC;IAA5CG,uBAAuB,GAAAD,eAAA,CAAvBC,uBAAuB;EAC/B,MAAMC,YAAY,GAAGN,YAAY,CAACC,KAAK,CAACK,YAAY,CAAC;EACrD,OAAOD,uBAAuB,oBAAvBA,uBAAuB,CAAEE,GAAG,CAACD,YAAY,oBAAZA,YAAY,CAAEE,EAAE,CAAC;AACvD","ignoreList":[]}

package/dist/esm/types/service.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sources":["../../../src/types/service.ts"],"sourcesContent":["export type FunctionCall = {\n  functionCallId: string;\n  name: string;\n  arguments: string;\n};\n\nexport type FunctionCallResult = {\n  functionCallId: string;\n  result: string;\n  error?: string;\n};\n\nexport type LimitationType = 'MINUTES' | 'SECONDS' | 'TOKENS';\n\nexport interface Limitation {\n  type?: LimitationType;\n  limit?: number;\n}\n\nexport interface ConversationResult {\n  url: string;\n  id: string;\n  limit?: number;\n}\n\nexport interface CreateConversationParams {\n  chatId: string;\n  namespace: string;\n  chatConfig?: object;\n  /** Whether this is the visitor's first-ever conversation with the persona (drives the opening message). */\n  firstConversation?: boolean;\n  /** Title of the visitor's last meaningful conversation, for a returning-visitor greeting. */\n  lastConversationTopic?: string;\n}\n\nexport interface EndConversationParams {\n  chatId: string;\n  conversationId: string;\n  namespace: string;\n}\n\nexport interface ChatMessageAttachment {\n  fileName?: string;\n  url?: string | null;\n  mimeType?: string;\n  textFileContent?: string | null;\n}\n\nexport interface AdditionalMetadata {\n  key?: string | null;\n  value?: string | null;\n  excludeFromPrompt?: boolean | null;\n}\n\nexport interface SendMessageMetadata {\n  additionalMetadata?: AdditionalMetadata[];\n}\n\nexport interface SendMessageParams {\n  chatId: string;\n  namespace: string;\n  message: string;\n  functionCallResults?: FunctionCallResult[];\n  chatConfig?: object;\n  attachments?: ChatMessageAttachment[];\n  metadata?: SendMessageMetadata;\n}\n\nexport interface ChatMessage {\n  id: string;\n  content: string;\n  role: 'USER' | 'ASSISTANT';\n  createdAt?: string;\n  attachments?: ChatMessageAttachment[];\n}\n\nexport interface QueryMessagesParams {\n  chatId: string;\n  namespace: string;\n  limit?: number;\n  cursor?: string;\n}\n\nexport interface QueryMessagesResult {\n  messages: ChatMessage[];\n  nextCursor?: string;\n}\n\nexport interface IPersonaChatService {\n  createVoiceConversation(\n    params: CreateConversationParams,\n  ): Promise<ConversationResult>;\n  createInteractiveConversation(\n    params: CreateConversationParams,\n  ): Promise<ConversationResult>;\n  endInteractiveConversation(params: EndConversationParams): Promise<void>;\n  sendChatMessage(\n    params: SendMessageParams,\n  ): Promise<{ functionCalls?: FunctionCall[]; messages?: ChatMessage[] }>;\n  queryChatMessages(params: QueryMessagesParams): Promise<QueryMessagesResult>;\n}\n"],"mappings":"","ignoreList":[]}
+{"version":3,"names":[],"sources":["../../../src/types/service.ts"],"sourcesContent":["export type FunctionCall = {\n  functionCallId: string;\n  name: string;\n  arguments: string;\n};\n\nexport type FunctionCallResult = {\n  functionCallId: string;\n  result: string;\n  error?: string;\n};\n\nexport type LimitationType = 'MINUTES' | 'SECONDS' | 'TOKENS';\n\nexport interface Limitation {\n  type?: LimitationType;\n  limit?: number;\n}\n\nexport interface ConversationResult {\n  url: string;\n  id: string;\n  limit?: number;\n}\n\nexport interface CreateConversationParams {\n  chatId: string;\n  namespace: string;\n  chatConfig?: object;\n  /** Whether this is the visitor's first-ever conversation with the persona (drives the opening message). */\n  firstConversation?: boolean;\n  /** Title of the visitor's last meaningful conversation, for a returning-visitor greeting. */\n  lastConversationTopic?: string;\n  /** Language or locale for a new voice/video call, e.g. es or en-GB. Omit to keep the default behavior. */\n  conversationLanguage?: string;\n}\n\nexport interface EndConversationParams {\n  chatId: string;\n  conversationId: string;\n  namespace: string;\n}\n\nexport interface ChatMessageAttachment {\n  fileName?: string;\n  url?: string | null;\n  mimeType?: string;\n  textFileContent?: string | null;\n}\n\nexport interface AdditionalMetadata {\n  key?: string | null;\n  value?: string | null;\n  excludeFromPrompt?: boolean | null;\n}\n\nexport interface SendMessageMetadata {\n  additionalMetadata?: AdditionalMetadata[];\n}\n\nexport interface SendMessageParams {\n  chatId: string;\n  namespace: string;\n  message: string;\n  functionCallResults?: FunctionCallResult[];\n  chatConfig?: object;\n  attachments?: ChatMessageAttachment[];\n  metadata?: SendMessageMetadata;\n}\n\nexport interface ChatMessage {\n  id: string;\n  content: string;\n  role: 'USER' | 'ASSISTANT';\n  createdAt?: string;\n  attachments?: ChatMessageAttachment[];\n}\n\nexport interface QueryMessagesParams {\n  chatId: string;\n  namespace: string;\n  limit?: number;\n  cursor?: string;\n}\n\nexport interface QueryMessagesResult {\n  messages: ChatMessage[];\n  nextCursor?: string;\n}\n\nexport interface IPersonaChatService {\n  createVoiceConversation(\n    params: CreateConversationParams,\n  ): Promise<ConversationResult>;\n  createInteractiveConversation(\n    params: CreateConversationParams,\n  ): Promise<ConversationResult>;\n  endInteractiveConversation(params: EndConversationParams): Promise<void>;\n  sendChatMessage(\n    params: SendMessageParams,\n  ): Promise<{ functionCalls?: FunctionCall[]; messages?: ChatMessage[] }>;\n  queryChatMessages(params: QueryMessagesParams): Promise<QueryMessagesResult>;\n}\n"],"mappings":"","ignoreList":[]}

package/dist/types/components/ChromaKey/ChromaKey.d.ts

@@ -9,6 +9,8 @@ interface ChromaKeyProps extends React.HTMLAttributes<HTMLCanvasElement> {
     background?: string | null;
     children: React.ReactElement<React.VideoHTMLAttributes<HTMLVideoElement> & {
         ref?: React.Ref<HTMLVideoElement>;
+        startupRenderSurface?: 'video' | 'canvas';
+        type?: 'agent' | 'user' | 'screen';
         pip?: boolean;
         pipFallback?: React.ReactNode;
         onPiPEnter?: () => void;

package/dist/types/components/ChromaKey/ChromaKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChromaKey.d.ts","sourceRoot":"","sources":["../../../../src/components/ChromaKey/ChromaKey.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAS3D,UAAU,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,iBAAiB,CAAC;IACtE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC,YAAY,CAC1B,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;QAC5C,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAClC,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;QACvB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;KACrC,CACF,CAAC;CACH;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,qBA0J9C"}
+{"version":3,"file":"ChromaKey.d.ts","sourceRoot":"","sources":["../../../../src/components/ChromaKey/ChromaKey.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsC,MAAM,OAAO,CAAC;AAS3D,UAAU,cAAe,SAAQ,KAAK,CAAC,cAAc,CAAC,iBAAiB,CAAC;IACtE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC,YAAY,CAC1B,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;QAC5C,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAClC,oBAAoB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;QAC1C,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;QACnC,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;QACvB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;KACrC,CACF,CAAC;CACH;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,qBA4K9C"}

package/dist/types/components/ChromaKey/chroma-key.d.ts

@@ -1,5 +1,6 @@
 export type ProcessCallback = () => void;
 export declare function chromaKey($video: HTMLVideoElement, $canvas: HTMLCanvasElement, options: {
+    onFrameDrawn?: () => void;
     color: string;
     spill: number;
     similarity: number;

package/dist/types/components/ChromaKey/chroma-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chroma-key.d.ts","sourceRoot":"","sources":["../../../../src/components/ChromaKey/chroma-key.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC;AAEzC,wBAAgB,SAAS,CACvB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,GACA,eAAe,GAAG,IAAI,CAuHxB"}
+{"version":3,"file":"chroma-key.d.ts","sourceRoot":"","sources":["../../../../src/components/ChromaKey/chroma-key.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC;AAEzC,wBAAgB,SAAS,CACvB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE;IACP,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,GACA,eAAe,GAAG,IAAI,CA0HxB"}

package/dist/types/components/LegendsPlatform/LegendsPlatform.d.ts

@@ -3,7 +3,9 @@ import { type Store } from 'jotai/vanilla/store';
 import { QueryClient } from '@tanstack/react-query';
 import type { ToolsRegistry } from '../../hooks/useTools/model/types';
 import type { IPersonaChatService } from '../../types/service';
+import { type StartupTelemetryOptions } from '../../startup-telemetry/attempt';
 export type LegendsPlatformProps = {
+    startupTelemetry?: StartupTelemetryOptions;
     chatId: string;
     namespace: string;
     apiKey?: string;

package/dist/types/components/LegendsPlatform/LegendsPlatform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LegendsPlatform.d.ts","sourceRoot":"","sources":["../../../../src/components/LegendsPlatform/LegendsPlatform.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAuB,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI/D,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,qBAwD1D"}
+{"version":3,"file":"LegendsPlatform.d.ts","sourceRoot":"","sources":["../../../../src/components/LegendsPlatform/LegendsPlatform.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0B,MAAM,OAAO,CAAC;AAE/C,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAuB,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,iCAAiC,CAAC;AAEzC,MAAM,MAAM,oBAAoB,GAAG;IACjC,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,qBAuF1D"}

package/dist/types/components/Video/Video.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 export declare const Video: React.ForwardRefExoticComponent<{
+    startupRenderSurface?: "video" | "canvas";
     mirror?: boolean;
     automirror?: boolean;
     type: "user" | "agent" | "screen";

package/dist/types/components/Video/Video.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Video.d.ts","sourceRoot":"","sources":["../../../../src/components/Video/Video.tsx"],"names":[],"mappings":"AAAA,OAAO,KAKN,MAAM,OAAO,CAAC;AAYf,eAAO,MAAM,KAAK;;;;;eARa,MAAO,aACtC;;;;;kBASM,MACF,SAAQ;0GAqEV,CAAC"}
+{"version":3,"file":"Video.d.ts","sourceRoot":"","sources":["../../../../src/components/Video/Video.tsx"],"names":[],"mappings":"AAAA,OAAO,KAKN,MAAM,OAAO,CAAC;AAcf,eAAO,MAAM,KAAK;;;;;;eATgF,MAChG,aACI;;;;;kBAO8D,MAAO,SACvE;0GAyFF,CAAC"}

package/dist/types/components/Video/types.d.ts

@@ -3,6 +3,8 @@ export type FallbackProps = {
     style?: React.CSSProperties;
 };
 export type VideoProps = {
+    /** Internal: canvas wrappers own the final presentation milestone. */
+    startupRenderSurface?: 'video' | 'canvas';
     mirror?: boolean;
     automirror?: boolean;
     type: 'user' | 'agent' | 'screen';

package/dist/types/components/Video/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/Video/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClC,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAC9C,qCAAqC;IACrC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,qCAAqC;IACrC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACpC,2CAA2C;IAC3C,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC/B,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/Video/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClC,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;IAC9C,qCAAqC;IACrC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,qCAAqC;IACrC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACpC,2CAA2C;IAC3C,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC/B,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,UAAU,CAAC,CAAC"}

package/dist/types/components/VideoPostProcessor/VideoPostProcessor.d.ts

@@ -4,6 +4,8 @@ interface VideoPostProcessorProps {
     effects: VideoPostProcessorEffect[];
     children: React.ReactElement<React.VideoHTMLAttributes<HTMLVideoElement> & {
         ref: React.RefObject<HTMLVideoElement>;
+        startupRenderSurface?: 'video' | 'canvas';
+        type?: 'agent' | 'user' | 'screen';
     }>;
 }
 export declare function VideoPostProcessor({ effects, children, }: VideoPostProcessorProps): React.JSX.Element;

package/dist/types/components/VideoPostProcessor/VideoPostProcessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoPostProcessor.d.ts","sourceRoot":"","sources":["../../../../src/components/VideoPostProcessor/VideoPostProcessor.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAKjD,KAAK,wBAAwB,GAAG,wBAAwB,CAAC;AAEzD,UAAU,uBAAuB;IAC/B,OAAO,EAAE,wBAAwB,EAAE,CAAC;IAEpC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAC1B,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;QAC5C,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;KACxC,CACF,CAAC;CACH;AAED,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,QAAQ,GACT,EAAE,uBAAuB,qBA0DzB"}
+{"version":3,"file":"VideoPostProcessor.d.ts","sourceRoot":"","sources":["../../../../src/components/VideoPostProcessor/VideoPostProcessor.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAKjD,KAAK,wBAAwB,GAAG,wBAAwB,CAAC;AAEzD,UAAU,uBAAuB;IAC/B,OAAO,EAAE,wBAAwB,EAAE,CAAC;IAEpC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAC1B,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;QAC5C,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACvC,oBAAoB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;QAC1C,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;KACpC,CACF,CAAC;CACH;AAED,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,QAAQ,GACT,EAAE,uBAAuB,qBAkEzB"}

package/dist/types/hooks/useConversation/livekit/useConversation.d.ts

@@ -1,3 +1,3 @@
 import type { UseConversationResult, UseConversationOptions } from '../types';
-export declare function useConversation({ autoJoin, type, config, startWithMicrophone, startWithCamera, firstConversation, lastConversationTopic, }: UseConversationOptions): UseConversationResult;
+export declare function useConversation({ autoJoin, type, config, startWithMicrophone, startWithCamera, firstConversation, lastConversationTopic, conversationLanguage, }: UseConversationOptions): UseConversationResult;
 //# sourceMappingURL=useConversation.d.ts.map

package/dist/types/hooks/useConversation/livekit/useConversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useConversation.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useConversation/livekit/useConversation.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EAEvB,MAAM,UAAU,CAAC;AA6ClB,wBAAgB,eAAe,CAAC,EAC9B,QAAe,EACf,IAAI,EACJ,MAAM,EACN,mBAA2B,EAC3B,eAAuB,EACvB,iBAAiB,EACjB,qBAAqB,GACtB,EAAE,sBAAsB,GAAG,qBAAqB,CAslBhD"}
+{"version":3,"file":"useConversation.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useConversation/livekit/useConversation.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EAEvB,MAAM,UAAU,CAAC;AA6ClB,wBAAgB,eAAe,CAAC,EAC9B,QAAe,EACf,IAAI,EACJ,MAAM,EACN,mBAA2B,EAC3B,eAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,EAAE,sBAAsB,GAAG,qBAAqB,CA2mBhD"}

package/dist/types/hooks/useCreateConversation/useCreateConversation.d.ts

@@ -6,6 +6,8 @@ export type UseCreateConversationOptions = {
     firstConversation?: boolean;
     /** Title of the visitor's last meaningful conversation, for a returning-visitor greeting. */
     lastConversationTopic?: string;
+    /** Language or locale for a new voice/video call, e.g. es or en-GB. Omit to keep the default behavior. */
+    conversationLanguage?: string;
 };
 export type UseCreateConversationResult = {
     data?: Conversation;

package/dist/types/hooks/useCreateConversation/useCreateConversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCreateConversation.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useCreateConversation/useCreateConversation.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAM5B,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2GAA2G;IAC3G,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,6FAA6F;IAC7F,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,2BAA2B,CA2G7B"}
+{"version":3,"file":"useCreateConversation.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useCreateConversation/useCreateConversation.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAO5B,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2GAA2G;IAC3G,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,6FAA6F;IAC7F,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,0GAA0G;IAC1G,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,2BAA2B,CAuH7B"}

package/dist/types/sdk-consumer/context.d.ts

@@ -1,6 +1,8 @@
+import type { StartupTelemetrySession } from '../startup-telemetry/attempt';
 import type { ToolsRegistry } from '../hooks';
 import type { IPersonaChatService } from '../types';
 export interface ISdkConsumerContext {
+    startupTelemetrySession?: StartupTelemetrySession;
     chatId: string;
     namespace: string;
     tools?: ToolsRegistry;

package/dist/types/sdk-consumer/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/sdk-consumer/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;CAC1C;AAED,eAAO,MAAM,kBAAkB,8CAI7B,CAAC;AAEH,wBAAgB,cAAc,wBAE7B"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/sdk-consumer/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;CAC1C;AAED,eAAO,MAAM,kBAAkB,8CAI7B,CAAC;AAEH,wBAAgB,cAAc,wBAE7B"}

package/dist/types/sdk.d.ts

@@ -16,4 +16,6 @@ export * from './hooks/usePictureInPicture';
 export * from './hooks/useMediaPermissions';
 export * from './hooks/useTools';
 export * from './conversation/types';
+export { createStartupIntent, StartupAttempt, } from './startup-telemetry/attempt';
+export type { StartupIntent, StartupReport, StartupTelemetryOptions, } from './startup-telemetry/attempt';
 //# sourceMappingURL=sdk.d.ts.map

package/dist/types/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/sdk.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AAExB,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AAEjC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/sdk.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AAExB,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AAEjC,cAAc,sBAAsB,CAAC;AAErC,OAAO,EACL,mBAAmB,EACnB,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,aAAa,EACb,aAAa,EACb,uBAAuB,GACxB,MAAM,6BAA6B,CAAC"}

package/dist/types/services/FetchPersonaChatService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FetchPersonaChatService.d.ts","sourceRoot":"","sources":["../../../src/services/FetchPersonaChatService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EAEZ,MAAM,UAAU,CAAC;AAmBlB,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM;IAI1B,OAAO,CAAC,OAAO;YAOD,IAAI;IAmBZ,uBAAuB,CAC3B,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC;IAsBxB,6BAA6B,CACjC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC;IAsBxB,0BAA0B,CAC9B,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAWV,eAAe,CACnB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC;QAAE,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IAsBlE,iBAAiB,CACrB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;CA0BhC"}
+{"version":3,"file":"FetchPersonaChatService.d.ts","sourceRoot":"","sources":["../../../src/services/FetchPersonaChatService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EAEZ,MAAM,UAAU,CAAC;AAmBlB,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,MAAM;IAI1B,OAAO,CAAC,OAAO;YAOD,IAAI;IAmBZ,uBAAuB,CAC3B,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC;IAuBxB,6BAA6B,CACjC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC;IAuBxB,0BAA0B,CAC9B,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAWV,eAAe,CACnB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC;QAAE,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC;IAsBlE,iBAAiB,CACrB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC;CA0BhC"}

package/dist/types/startup-telemetry/attempt.d.ts

@@ -0,0 +1,71 @@
+/** All elapsed times belong to one browser document's monotonic clock. */
+export type StartupMilestone = 'attempt_started' | 'api_request' | 'api_response' | 'join_requested' | 'room_connected' | 'agent_joined' | 'track_subscribed' | 'first_frame' | 'terminal';
+export type StartupOutcome = 'pending' | 'success' | 'error' | 'cancelled' | 'timeout' | 'unmeasurable';
+export type StartupIntent = {
+    id: string;
+    startedAt: number;
+    timeOrigin: number;
+};
+export type StartupReport = {
+    attemptId: string;
+    chatId: string;
+    conversationId?: string;
+    milestone: StartupMilestone;
+    elapsedMs: number;
+    clientStartUnixMs: number;
+    outcome: StartupOutcome;
+    startBoundary: 'user_intent' | 'sdk_create';
+    method?: string;
+    application: string;
+    applicationVersion?: string;
+    entryCoverage: 'user_handler' | 'sdk_only';
+    measurementVersion: number;
+};
+export type StartupTelemetryOptions = {
+    enabled: boolean;
+    intent?: StartupIntent;
+    attempt?: StartupAttempt;
+    application: string;
+    applicationVersion?: string;
+    entryCoverage?: 'user_handler' | 'sdk_only';
+    report?: (event: StartupReport) => void | Promise<unknown>;
+};
+export declare function createStartupIntent(): StartupIntent;
+export declare class StartupAttempt {
+    private options;
+    private chatId;
+    private terminal;
+    private adoptedBySdk;
+    private seen;
+    private conversationId?;
+    private timeout?;
+    readonly id: string;
+    readonly startedAt: number;
+    readonly startBoundary: 'user_intent' | 'sdk_create';
+    private visibilityChanged;
+    constructor(options: StartupTelemetryOptions, chatId: string, intent?: StartupIntent);
+    /** A pre-SDK terminal attempt must be adopted once, not counted again. */
+    claimForSdk(): boolean;
+    get completed(): boolean;
+    attachChat(chatId: string): void;
+    bind(conversationId: string): void;
+    mark(milestone: StartupMilestone, method?: string): void;
+    frame(method: string): void;
+    finish(outcome: Exclude<StartupOutcome, 'pending'>, method?: string): void;
+    private send;
+}
+export declare class StartupTelemetrySession {
+    private options;
+    private chatId;
+    private attempts;
+    private leases;
+    private active?;
+    private terminalAtCreation?;
+    private intentConsumed;
+    constructor(options: StartupTelemetryOptions, chatId: string);
+    start(): StartupAttempt | undefined;
+    bind(attempt: StartupAttempt | undefined, id: string): void;
+    get(id?: string): StartupAttempt | undefined;
+    release(attempt?: StartupAttempt): void;
+}
+//# sourceMappingURL=attempt.d.ts.map

package/dist/types/startup-telemetry/attempt.d.ts.map

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

package/dist/types/startup-telemetry/frame.d.ts

@@ -0,0 +1,6 @@
+import type { StartupAttempt } from './attempt';
+/** A presentation milestone, not proof of photons or user attention. */
+export declare function isSurfaceVisible(element: HTMLElement): boolean;
+export declare function recordCanvasFrame(attempt: StartupAttempt | undefined, canvas: HTMLCanvasElement, video: HTMLVideoElement): void;
+export declare function observeVideoFrame(attempt: StartupAttempt, video: HTMLVideoElement): () => void;
+//# sourceMappingURL=frame.d.ts.map

package/dist/types/startup-telemetry/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../../src/startup-telemetry/frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CA+B9D;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,gBAAgB,QAkBxB;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,gBAAgB,GACtB,MAAM,IAAI,CA8CZ"}

package/dist/types/startup-telemetry/useStartupAttempt.d.ts

@@ -0,0 +1,2 @@
+export declare function useStartupAttempt(): import("./attempt").StartupAttempt | undefined;
+//# sourceMappingURL=useStartupAttempt.d.ts.map

package/dist/types/startup-telemetry/useStartupAttempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStartupAttempt.d.ts","sourceRoot":"","sources":["../../../src/startup-telemetry/useStartupAttempt.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,mDAIhC"}

package/dist/types/types/service.d.ts

@@ -26,6 +26,8 @@ export interface CreateConversationParams {
     firstConversation?: boolean;
     /** Title of the visitor's last meaningful conversation, for a returning-visitor greeting. */
     lastConversationTopic?: string;
+    /** Language or locale for a new voice/video call, e.g. es or en-GB. Omit to keep the default behavior. */
+    conversationLanguage?: string;
 }
 export interface EndConversationParams {
     chatId: string;