@runtypelabs/persona 4.23.2 → 4.25.0

package/src/voice/voice.test.ts

@@ -217,14 +217,17 @@ describe('Voice Support Check', () => {
 const WS_OPEN = 1;
 
 class MockWebSocket {
+  static CONNECTING = 0;
   static OPEN = WS_OPEN;
   static instances: MockWebSocket[] = [];
 
   url: string;
   protocols: string | string[] | undefined;
+  /** Negotiated subprotocol, set by the test before `triggerOpen()`. */
+  protocol = '';
   binaryType = '';
   readyState = 0;
-  sent: ArrayBuffer[] = [];
+  sent: Array<ArrayBuffer | string> = [];
   closeCalls: Array<{ code?: number; reason?: string }> = [];
   onopen: (() => void) | null = null;
   onmessage: ((ev: { data: unknown }) => void) | null = null;
@@ -237,7 +240,7 @@ class MockWebSocket {
     MockWebSocket.instances.push(this);
   }
 
-  send(data: ArrayBuffer) {
+  send(data: ArrayBuffer | string) {
     this.sent.push(data);
   }
 
@@ -535,4 +538,271 @@ describe('RuntypeVoiceProvider (realtime streaming)', () => {
     engine.finishedCb?.(); // playback drained
     expect(statuses).toEqual(['listening']);
   });
+});
+
+describe('RuntypeVoiceProvider prewarm', () => {
+  let getUserMedia: ReturnType<typeof vi.fn>;
+  let fetchMock: ReturnType<typeof vi.fn>;
+
+  beforeEach(() => {
+    vi.useFakeTimers();
+    MockWebSocket.instances = [];
+    getUserMedia = vi.fn(async () => makeStream().stream);
+    fetchMock = vi.fn(async () => new Response(null, { status: 204 }));
+    vi.stubGlobal('WebSocket', MockWebSocket);
+    vi.stubGlobal('navigator', { mediaDevices: { getUserMedia } });
+    vi.stubGlobal('fetch', fetchMock);
+    (globalThis as any).window.AudioContext = MockAudioContext;
+    (globalThis as any).window.webkitAudioContext = MockAudioContext;
+    (globalThis as any).window.location = { protocol: 'https:' };
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+    vi.unstubAllGlobals();
+    delete (globalThis as any).window.AudioContext;
+    delete (globalThis as any).window.webkitAudioContext;
+    delete (globalThis as any).window.location;
+  });
+
+  const config = (extra: Partial<NonNullable<VoiceConfig['runtype']>> = {}) => ({
+    agentId: 'agent/1',
+    clientToken: 'ct_secret',
+    host: 'https://api.example.com',
+    ...extra,
+  });
+  const attachConfig = (extra: Partial<NonNullable<VoiceConfig['runtype']>> = {}) =>
+    config({ prewarmMode: 'attach', ...extra });
+  const lastWs = () => MockWebSocket.instances[MockWebSocket.instances.length - 1];
+  const openAs = (ws: MockWebSocket, protocol: string) => {
+    ws.protocol = protocol;
+    ws.triggerOpen();
+  };
+
+  describe("'request' mode (default)", () => {
+    it('POSTs the prewarm endpoint with the bearer token and no body', () => {
+      new RuntypeVoiceProvider(config()).prewarm();
+
+      expect(fetchMock).toHaveBeenCalledOnce();
+      const [url, init] = fetchMock.mock.calls[0];
+      expect(url).toBe('https://api.example.com/v1/client/agents/agent%2F1/voice/prewarm');
+      expect(init).toEqual({
+        method: 'POST',
+        headers: { Authorization: 'Bearer ct_secret' },
+        keepalive: true,
+      });
+      expect(MockWebSocket.instances).toHaveLength(0);
+    });
+
+    it.each([
+      ['http://localhost:8787', 'http://localhost:8787'],
+      ['wss://api.example.com', 'https://api.example.com'],
+      ['api.example.com', 'https://api.example.com'],
+    ])('derives the http base from %s', (host, base) => {
+      new RuntypeVoiceProvider(config({ host })).prewarm();
+      expect(fetchMock.mock.calls[0][0]).toBe(`${base}/v1/client/agents/agent%2F1/voice/prewarm`);
+    });
+
+    it('fires at most once per 30s per provider', () => {
+      const provider = new RuntypeVoiceProvider(config());
+      provider.prewarm();
+      provider.prewarm();
+      vi.advanceTimersByTime(29_999);
+      provider.prewarm();
+      expect(fetchMock).toHaveBeenCalledOnce();
+      vi.advanceTimersByTime(1);
+      provider.prewarm();
+      expect(fetchMock).toHaveBeenCalledTimes(2);
+    });
+
+    it('swallows rejected and throwing fetches without emitting errors or status', async () => {
+      const errors: Error[] = [];
+      const statuses: string[] = [];
+      fetchMock.mockRejectedValueOnce(new Error('offline'));
+      const provider = new RuntypeVoiceProvider(config());
+      provider.onError((e) => errors.push(e));
+      provider.onStatusChange((s) => statuses.push(s));
+      provider.prewarm();
+      await vi.advanceTimersByTimeAsync(30_000);
+      fetchMock.mockImplementationOnce(() => {
+        throw new Error('sync');
+      });
+      expect(() => provider.prewarm()).not.toThrow();
+      await vi.advanceTimersByTimeAsync(0);
+      expect(fetchMock).toHaveBeenCalledTimes(2);
+      expect(errors).toEqual([]);
+      expect(statuses).toEqual([]);
+    });
+
+    it('does nothing without credentials or during a live call', async () => {
+      new RuntypeVoiceProvider(config({ clientToken: undefined })).prewarm();
+      expect(fetchMock).not.toHaveBeenCalled();
+
+      const provider = new RuntypeVoiceProvider(config());
+      await provider.startListening();
+      provider.prewarm();
+      expect(fetchMock).not.toHaveBeenCalled();
+    });
+  });
+
+  describe("'attach' mode", () => {
+    it('opens the voice socket with the attach capability and subprotocol, then pings', () => {
+      new RuntypeVoiceProvider(attachConfig()).prewarm();
+
+      const ws = lastWs();
+      expect(ws.url).toBe('wss://api.example.com/ws/agents/agent%2F1/voice?clientCapabilities=attach');
+      expect(ws.protocols).toEqual(['runtype.bearer', 'runtype.attach', 'ct_secret']);
+      expect(fetchMock).not.toHaveBeenCalled();
+      openAs(ws, 'runtype.attach');
+      expect(ws.sent).toEqual(['{"type":"ping"}']);
+    });
+
+    it('sends a clamped attachIdleMs when configured', () => {
+      new RuntypeVoiceProvider(attachConfig({ attachIdleMs: 5_000 })).prewarm();
+      expect(lastWs().url).toContain('clientCapabilities=attach&attachIdleMs=30000');
+    });
+
+    it('never attaches twice concurrently', () => {
+      const provider = new RuntypeVoiceProvider(attachConfig());
+      provider.prewarm();
+      vi.advanceTimersByTime(60_000);
+      provider.prewarm();
+      expect(MockWebSocket.instances).toHaveLength(1);
+    });
+
+    it('reuses an attached socket on click: sends start and captures on it', async () => {
+      const statuses: string[] = [];
+      const provider = new RuntypeVoiceProvider(attachConfig());
+      provider.onStatusChange((s) => statuses.push(s));
+      provider.prewarm();
+      const ws = lastWs();
+      openAs(ws, 'runtype.attach');
+      ws.triggerMessage('{"type":"attached","idleMs":30000}');
+
+      await provider.startListening();
+
+      expect(MockWebSocket.instances).toHaveLength(1);
+      expect(ws.sent).toEqual(['{"type":"ping"}', '{"type":"start"}']);
+      expect(statuses).toEqual(['listening']);
+      pumpCapture(constantBuffer(0.1));
+      expect(ws.sent).toHaveLength(3);
+      // The call owns the socket now: the attach idle timer no longer closes it.
+      vi.advanceTimersByTime(600_000);
+      expect(ws.closeCalls).toEqual([]);
+    });
+
+    it('adopts a socket whose server ignored attach without sending start', async () => {
+      const transcripts: string[] = [];
+      const provider = new RuntypeVoiceProvider(attachConfig());
+      provider.onTranscript((_role, text) => transcripts.push(text));
+      provider.prewarm();
+      const ws = lastWs();
+      openAs(ws, 'runtype.bearer');
+      expect(ws.sent).toEqual([]);
+
+      await provider.startListening();
+
+      expect(MockWebSocket.instances).toHaveLength(1);
+      expect(ws.sent).toEqual([]);
+      ws.triggerMessage(JSON.stringify({ type: 'transcript_final', role: 'user', text: 'hi' }));
+      expect(transcripts).toEqual(['hi']);
+    });
+
+    it('opens a fresh socket when the attached one dropped before the click', async () => {
+      const provider = new RuntypeVoiceProvider(attachConfig());
+      provider.prewarm();
+      const attached = lastWs();
+      openAs(attached, 'runtype.attach');
+      attached.triggerClose(4408);
+
+      await provider.startListening();
+
+      expect(MockWebSocket.instances).toHaveLength(2);
+      expect(lastWs().url).toBe('wss://api.example.com/ws/agents/agent%2F1/voice');
+      expect(lastWs().protocols).toEqual(['runtype.bearer', 'ct_secret']);
+    });
+
+    it('abandons a handshake stalled for 5s and opens a fresh socket', async () => {
+      const provider = new RuntypeVoiceProvider(attachConfig());
+      provider.prewarm();
+      const stalled = lastWs();
+
+      const started = provider.startListening();
+      await vi.advanceTimersByTimeAsync(4_999);
+      expect(MockWebSocket.instances).toHaveLength(1);
+      await vi.advanceTimersByTimeAsync(1);
+      await started;
+
+      expect(stalled.closeCalls).toEqual([{ code: 1000, reason: 'prewarm released' }]);
+      expect(MockWebSocket.instances).toHaveLength(2);
+      expect(lastWs().protocols).toEqual(['runtype.bearer', 'ct_secret']);
+    });
+
+    it('uses an attach that completes while the click waits on it', async () => {
+      const provider = new RuntypeVoiceProvider(attachConfig());
+      provider.prewarm();
+      const ws = lastWs();
+
+      const started = provider.startListening();
+      await vi.advanceTimersByTimeAsync(1_000);
+      openAs(ws, 'runtype.attach');
+      await started;
+
+      expect(MockWebSocket.instances).toHaveLength(1);
+      expect(ws.sent).toContain('{"type":"start"}');
+    });
+
+    it('closes an unused attached socket at the idle window', () => {
+      const errors: Error[] = [];
+      const provider = new RuntypeVoiceProvider(attachConfig());
+      provider.onError((e) => errors.push(e));
+      provider.prewarm();
+      const ws = lastWs();
+      openAs(ws, 'runtype.attach');
+
+      vi.advanceTimersByTime(29_999);
+      expect(ws.closeCalls).toEqual([]);
+      vi.advanceTimersByTime(1);
+      expect(ws.closeCalls).toEqual([{ code: 1000, reason: 'prewarm released' }]);
+      expect(errors).toEqual([]);
+    });
+
+    it("follows the server's idle window from the attached reply", () => {
+      const provider = new RuntypeVoiceProvider(attachConfig({ attachIdleMs: 120_000 }));
+      provider.prewarm();
+      const ws = lastWs();
+      openAs(ws, 'runtype.attach');
+      vi.advanceTimersByTime(1_000);
+      ws.triggerMessage('{"type":"attached","idleMs":60000}');
+
+      vi.advanceTimersByTime(58_999);
+      expect(ws.closeCalls).toEqual([]);
+      vi.advanceTimersByTime(1);
+      expect(ws.closeCalls).toHaveLength(1);
+    });
+
+    it('closes the attaching socket when the call is hung up mid-handshake', async () => {
+      const provider = new RuntypeVoiceProvider(attachConfig());
+      provider.prewarm();
+      const ws = lastWs();
+
+      const started = provider.startListening();
+      await vi.advanceTimersByTimeAsync(100);
+      await provider.stopListening();
+      await started;
+
+      expect(ws.closeCalls).toEqual([{ code: 1000, reason: 'prewarm released' }]);
+      expect(MockWebSocket.instances).toHaveLength(1);
+      expect(provider.isBargeInActive()).toBe(false);
+    });
+
+    it('disconnect closes an attached socket', async () => {
+      const provider = new RuntypeVoiceProvider(attachConfig());
+      provider.prewarm();
+      const ws = lastWs();
+      openAs(ws, 'runtype.attach');
+      await provider.disconnect();
+      expect(ws.closeCalls).toEqual([{ code: 1000, reason: 'prewarm released' }]);
+    });
+  });
 });

package/src/welcome.test.ts

@@ -274,3 +274,26 @@ describe("resolveConversationState", () => {
     expect(resolveConversationState([])).toBe("empty");
   });
 });
+
+describe("V5 welcome layout defaults", () => {
+  it("centers the empty greeting with concise copy and dismisses every variant", () => {
+    for (const variant of ["card", "hero", "none"] as const) {
+      const resolved = resolveWelcomeConfig(config({ future: { v5Defaults: true }, welcome: { variant } }));
+      expect(resolved).toMatchObject({ layout: "centered", align: "center", title: "What can I help with?", subtitle: "", dismiss: "on-first-message", anchor: "bottom" });
+      expect(isWelcomeVisible(resolved, [userMessage])).toBe(false);
+    }
+  });
+
+  it("keeps explicit fields and legacy copy above V5 defaults", () => {
+    const resolved = resolveWelcomeConfig(config({ future: { v5Defaults: true }, copy: { welcomeTitle: "Legacy", welcomeSubtitle: "Scope" }, welcome: { layout: "top", variant: "hero", dismiss: "never", anchor: "bottom", align: "start" } }), true);
+    expect(resolved).toMatchObject({ title: "Legacy", subtitle: "Scope", layout: "top", dismiss: "never", anchor: "bottom", align: "start" });
+  });
+
+  it("makes centered fullscreen geometry available in either default mode", () => {
+    for (const v5Defaults of [false, true]) {
+      const resolved = resolveWelcomeConfig(config({ future: { v5Defaults }, welcome: { layout: "centered" } }), true);
+      expect(resolved.anchor).toBe("center");
+      expect(resolveWelcomeConfig(config({ future: { v5Defaults }, welcome: { layout: "centered", anchor: "bottom" } }), true).anchor).toBe("bottom");
+    }
+  });
+});

package/src/welcome.ts

@@ -55,6 +55,7 @@ export interface ResolvedWelcomeConfig {
    * Optional on the interface, always populated by `resolveWelcomeConfig`:
    * a plugin literal built against an older minor must still type-check.
    */
+  layout?: "top" | "centered";
   anchor?: AgentWidgetWelcomeAnchor;
   /** Percentage string; validated, falls back to "44%". */
   anchorComposerTop?: string;
@@ -80,10 +81,14 @@ const warnOnce = (config: AgentWidgetConfig | undefined, messages: string[]) =>
  * `copy` alias, else the default above.
  */
 export const resolveWelcomeConfig = (
-  config?: AgentWidgetConfig
+  config?: AgentWidgetConfig,
+  fullscreen = config?.launcher?.fullHeight === true &&
+    !config.launcher.sidebarMode && config.launcher.mountMode !== "docked"
 ): ResolvedWelcomeConfig => {
   const welcome = config?.welcome;
   const copy = config?.copy;
+  const v5 = config?.future?.v5Defaults === true;
+  const layout = welcome?.layout ?? (v5 ? "centered" : "top");
 
   const variant: AgentWidgetWelcomeVariant = isSet(welcome, "variant")
     ? welcome!.variant!
@@ -91,13 +96,14 @@ export const resolveWelcomeConfig = (
       ? "none"
       : "card";
 
-  // Hero IS the greeting: `dismiss` is forced and `message` is suppressed.
+  // Legacy V4 heroes force dismissal; opting into layout makes it configurable.
+  // A hero remains the greeting, so its separate message is always suppressed.
   const dismiss: AgentWidgetWelcomeDismiss =
-    variant === "hero"
+    variant === "hero" && !v5 && welcome?.layout === undefined
       ? "on-first-message"
       : isSet(welcome, "dismiss")
         ? welcome!.dismiss!
-        : "never";
+        : v5 || variant === "hero" ? "on-first-message" : "never";
 
   const conflicts: string[] = [];
   if (isSet(welcome, "title") && isSet(copy, "welcomeTitle")) {
@@ -120,14 +126,14 @@ export const resolveWelcomeConfig = (
       'welcome.message is ignored when welcome.variant is "hero": the hero is the greeting.'
     );
   }
-  if (variant === "hero" && isSet(welcome, "dismiss") && welcome!.dismiss !== "on-first-message") {
+  if (!v5 && welcome?.layout === undefined && variant === "hero" && isSet(welcome, "dismiss") && welcome!.dismiss !== "on-first-message") {
     conflicts.push(
       'welcome.dismiss is pinned to "on-first-message" when welcome.variant is "hero".'
     );
   }
 
   const anchor: AgentWidgetWelcomeAnchor =
-    welcome?.anchor === "center" ? "center" : "bottom";
+    welcome?.anchor ?? (layout === "centered" && fullscreen ? "center" : "bottom");
   const anchorTopValid = parseAnchorFraction(welcome?.anchorComposerTop) !== null;
   if (isSet(welcome, "anchorComposerTop") && !anchorTopValid) {
     conflicts.push(
@@ -147,16 +153,16 @@ export const resolveWelcomeConfig = (
   return {
     title: isSet(welcome, "title")
       ? welcome!.title!
-      : copy?.welcomeTitle ?? DEFAULT_WELCOME_TITLE,
+      : copy?.welcomeTitle ?? (v5 ? "What can I help with?" : DEFAULT_WELCOME_TITLE),
     kicker: welcome?.kicker ?? "",
     subtitle: isSet(welcome, "subtitle")
       ? welcome!.subtitle!
-      : copy?.welcomeSubtitle ?? DEFAULT_WELCOME_SUBTITLE,
+      : copy?.welcomeSubtitle ?? (v5 ? "" : DEFAULT_WELCOME_SUBTITLE),
     icon: welcome?.icon,
     align:
       welcome?.align === "start" || welcome?.align === "center"
         ? welcome.align
-        : undefined,
+        : layout === "centered" ? "center" : undefined,
     iconPlacement:
       welcome?.icon && typeof welcome.icon !== "function" &&
       welcome.icon.placement === "inline"
@@ -165,6 +171,7 @@ export const resolveWelcomeConfig = (
     variant,
     dismiss,
     message: variant === "hero" ? undefined : welcome?.message,
+    layout,
     anchor,
     anchorComposerTop: anchorTopValid
       ? welcome!.anchorComposerTop!

package/dist/approval-ui-K7R5Q5OC.js

@@ -1 +0,0 @@
-import{a as E,g as P}from"./chunk-NQLDCJAP.js";import{a as x}from"./chunk-7NQ4ZTHF.js";import{b as q,c as $}from"./chunk-Q735PSZL.js";import{a}from"./chunk-76IELU7F.js";var R=()=>{},z=t=>{R=t.webMcpToolTitle},I=t=>R(t);import{ChevronDown as Y,ChevronUp as ee,ShieldAlert as te,ShieldCheck as K,ShieldX as _}from"lucide";var k=new Map,B=t=>{let o=(t.startsWith(E)?t.slice(E.length):t).replace(/([a-z0-9])([A-Z])/g,"$1 $2").split(/[_\-\s.]+/).filter(Boolean);if(o.length===0)return t;let e=o.join(" ").toLowerCase();return e.charAt(0).toUpperCase()+e.slice(1)},F=t=>t?.approval!==!1?t?.approval:void 0,X=(t,r)=>{let o=F(r)?.detailsDisplay??"collapsed";return k.get(t)??o==="expanded"},j=(t,r,o)=>{let e=F(o);t.setAttribute("aria-expanded",r?"true":"false");let u=t.querySelector("[data-approval-details-label]");u&&(u.textContent=r?e?.hideDetailsLabel??"Hide details":e?.showDetailsLabel??"Show details");let i=t.querySelector("[data-approval-details-chevron]");if(i){i.innerHTML="";let g=x(r?ee:Y,14,"currentColor",2);g&&i.appendChild(g)}},V=(t,r,o)=>{let e=r.querySelector('button[data-bubble-type="approval"]'),u=r.querySelector("[data-approval-details]");if(!e||!u)return;let i=X(t,o);j(e,i,o),u.style.display=i?"":"none"};var Z=(t,r)=>{let o=t.approval,e=r?.approval!==!1?r?.approval:void 0,u=o?.status==="pending",i=a("div",["persona-approval-bubble","persona-w-full","persona-rounded-2xl","persona-border","persona-shadow-sm","persona-overflow-hidden"].join(" "));if(i.id=`bubble-${t.id}`,i.setAttribute("data-message-id",t.id),i.style.backgroundColor=e?.backgroundColor??"var(--persona-approval-bg, #fefce8)",i.style.borderColor=e?.borderColor??"var(--persona-approval-border, #fef08a)",i.style.boxShadow=e?.shadow!==void 0?e.shadow.trim()===""?"none":e.shadow:"var(--persona-approval-shadow, 0 5px 15px rgba(15, 23, 42, 0.08))",!o)return i;let g=a("div","persona-flex persona-items-start persona-gap-3 persona-px-4 persona-py-3"),l=a("div","persona-flex-shrink-0 persona-mt-0.5");l.setAttribute("data-approval-icon","true");let v=o.status==="denied"?_:o.status==="timeout"?te:K,C=o.status==="approved"?"var(--persona-feedback-success, #16a34a)":o.status==="denied"?"var(--persona-feedback-error, #dc2626)":o.status==="timeout"?"var(--persona-feedback-warning, #ca8a04)":e?.titleColor??"currentColor",A=x(v,20,C,2);A&&l.appendChild(A);let m=a("div","persona-flex-1 persona-min-w-0"),f=a("div","persona-flex persona-items-center persona-gap-2"),w=a("span","persona-text-sm persona-font-medium persona-text-persona-primary");if(e?.titleColor&&(w.style.color=e.titleColor),w.textContent=e?.title??"Approval Required",f.appendChild(w),!u){let s=a("span","persona-inline-flex persona-items-center persona-px-2 persona-py-0.5 persona-rounded-full persona-text-xs persona-font-medium");s.setAttribute("data-approval-status",o.status),o.status==="approved"?(s.style.backgroundColor="var(--persona-palette-colors-success-100, #dcfce7)",s.style.color="var(--persona-palette-colors-success-700, #15803d)",s.textContent="Approved"):o.status==="denied"?(s.style.backgroundColor="var(--persona-palette-colors-error-100, #fee2e2)",s.style.color="var(--persona-palette-colors-error-700, #b91c1c)",s.textContent="Denied"):o.status==="timeout"&&(s.style.backgroundColor="var(--persona-palette-colors-warning-100, #fef3c7)",s.style.color="var(--persona-palette-colors-warning-700, #b45309)",s.textContent="Timeout"),f.appendChild(s)}m.appendChild(f);let y=o.toolType==="webmcp"||o.toolName.startsWith(E)?I(o.toolName):void 0,N=e?.formatDescription?.({toolName:o.toolName,toolType:o.toolType,description:o.description,parameters:o.parameters,...y?{displayTitle:y}:{},...o.reason?{reason:o.reason}:{}}),D=!o.toolName,H=N||(D?o.description:`The assistant wants to use \u201C${y??B(o.toolName)}\u201D.`),h=a("p","persona-text-sm persona-mt-0.5 persona-text-persona-muted");if(h.setAttribute("data-approval-summary","true"),e?.descriptionColor&&(h.style.color=e.descriptionColor),h.textContent=H,m.appendChild(h),o.reason){let s=a("p","persona-text-sm persona-mt-1 persona-text-persona-muted");s.setAttribute("data-approval-reason","true"),e?.reasonColor?s.style.color=e.reasonColor:e?.descriptionColor&&(s.style.color=e.descriptionColor);let n=a("span","persona-font-medium");n.textContent=`${e?.reasonLabel??"Agent's stated reason:"} `,s.appendChild(n),s.appendChild(document.createTextNode(o.reason)),m.appendChild(s)}let W=e?.detailsDisplay??"collapsed",M=!!o.description&&!D,S=M||!!o.parameters;if(W!=="hidden"&&S){let s=X(t.id,r),n=a("button","persona-inline-flex persona-items-center persona-gap-1 persona-mt-1 persona-p-0 persona-border-none persona-bg-transparent persona-text-xs persona-font-medium persona-cursor-pointer persona-text-persona-muted");n.type="button",n.setAttribute("data-expand-header","true"),n.setAttribute("data-bubble-type","approval"),e?.descriptionColor&&(n.style.color=e.descriptionColor);let p=a("span");p.setAttribute("data-approval-details-label","true");let b=a("span","persona-inline-flex persona-items-center");b.setAttribute("data-approval-details-chevron","true"),n.append(p,b),j(n,s,r),m.appendChild(n);let c=a("div");if(c.setAttribute("data-approval-details","true"),c.style.display=s?"":"none",M){let d=a("p","persona-text-sm persona-mt-1 persona-text-persona-muted");e?.descriptionColor&&(d.style.color=e.descriptionColor),d.textContent=o.description,c.appendChild(d)}if(o.parameters){let d=a("pre","persona-mt-2 persona-text-xs persona-p-2 persona-rounded persona-overflow-x-auto persona-max-h-32 persona-bg-persona-container persona-text-persona-primary");e?.parameterBackgroundColor&&(d.style.backgroundColor=e.parameterBackgroundColor),e?.parameterTextColor&&(d.style.color=e.parameterTextColor),d.style.fontSize="0.75rem",d.style.lineHeight="1rem",d.textContent=P(o.parameters),c.appendChild(d)}m.appendChild(c)}if(u){let s=a("div","persona-flex persona-gap-2 persona-mt-2");s.setAttribute("data-approval-buttons","true");let n=a("button","persona-inline-flex persona-items-center persona-px-3 persona-py-1.5 persona-rounded-md persona-text-xs persona-font-medium persona-border-none persona-cursor-pointer");n.type="button",n.style.backgroundColor=e?.approveButtonColor??"var(--persona-approval-approve-bg, #22c55e)",n.style.color=e?.approveButtonTextColor??"#ffffff",n.setAttribute("data-approval-action","approve");let p=x(K,14,e?.approveButtonTextColor??"#ffffff",2);p&&(p.style.marginRight="4px",n.appendChild(p));let b=document.createTextNode(e?.approveLabel??"Approve");n.appendChild(b);let c=a("button","persona-inline-flex persona-items-center persona-px-3 persona-py-1.5 persona-rounded-md persona-text-xs persona-font-medium persona-cursor-pointer");c.type="button",c.style.backgroundColor=e?.denyButtonColor??"transparent",c.style.color=e?.denyButtonTextColor??"var(--persona-feedback-error, #dc2626)",c.style.border=`1px solid ${e?.denyButtonTextColor?e.denyButtonTextColor:"var(--persona-palette-colors-error-200, #fca5a5)"}`,c.setAttribute("data-approval-action","deny");let d=x(_,14,e?.denyButtonTextColor??"var(--persona-feedback-error, #dc2626)",2);d&&(d.style.marginRight="4px",c.appendChild(d));let L=document.createTextNode(e?.denyLabel??"Deny");c.appendChild(L),s.append(n,c),m.appendChild(s)}return g.append(l,m),i.appendChild(g),i};import{Ban as oe,ChevronDown as G,ShieldCheck as ne}from"lucide";var re=()=>({keyHandlers:new Map,popovers:new Map,pendingOrder:[],latestPendingApprovalId:null}),J=(t,r)=>{let o=t.keyHandlers.get(r);o&&(document.removeEventListener("keydown",o),t.keyHandlers.delete(r));let e=t.popovers.get(r);e&&(e.destroy(),t.popovers.delete(r))},T=(t,r)=>{J(t,r);let o=t.pendingOrder.indexOf(r);o!==-1&&t.pendingOrder.splice(o,1),t.latestPendingApprovalId===r&&(t.latestPendingApprovalId=t.pendingOrder.length?t.pendingOrder[t.pendingOrder.length-1]:null)},ae=t=>t?.approval!==!1?t?.approval:void 0,se=(t,r)=>{let o=r?.detailsDisplay??"collapsed";return k.get(t)??o==="expanded"},U=t=>{let r=a("span","persona-approval-kbd");return r.textContent=t,r},pe=(t,r)=>{let o=a("span","persona-approval-title");r?.titleColor&&(o.style.color=r.titleColor);let u=t.toolType==="webmcp"||t.toolName.startsWith(E)?I(t.toolName):void 0,i=r?.formatDescription?.({toolName:t.toolName,toolType:t.toolType,description:t.description??"",parameters:t.parameters,...u?{displayTitle:u}:{},...t.reason?{reason:t.reason}:{}});if(i)return o.textContent=i,o;let g=u??B(t.toolName),l=t.toolType&&t.toolType!=="webmcp"?t.toolType:null;o.append("The assistant wants to use ");let v=document.createElement("strong");if(v.textContent=g,o.appendChild(v),l){o.append(" from ");let C=document.createElement("strong");C.textContent=l,o.appendChild(C)}return o},le=t=>{let r=a("div","persona-approval-resolved"),o=x(oe,15,"currentColor",2);o&&r.appendChild(o);let e=a("span","persona-approval-resolved-name");return e.textContent=t.toolName?B(t.toolName):"Tool",r.append(e,document.createTextNode(t.status==="timeout"?" timed out":" denied")),r},ie=(t,r,o,e,u,i,g)=>{let l=a("div","persona-approval-card persona-shadow-sm");l.id=`bubble-${r.id}`,l.setAttribute("data-message-id",r.id),l.setAttribute("data-bubble-type","approval"),e?.backgroundColor&&(l.style.background=e.backgroundColor),e?.borderColor&&(l.style.borderColor=e.borderColor),e?.shadow!==void 0&&(l.style.boxShadow=e.shadow.trim()===""?"none":e.shadow);let v=e?.detailsDisplay??"collapsed",C=!!o.description&&v!=="hidden",A=o.parameters!=null&&v!=="hidden",m=C||A,f=m&&se(r.id,e),w=e?.showDetailsLabel??"Show details",O=e?.hideDetailsLabel??"Hide details",y=a("button","persona-approval-head");y.type="button",m?(y.setAttribute("data-action","toggle-params"),y.setAttribute("aria-expanded",f?"true":"false"),y.setAttribute("aria-label",f?O:w)):y.setAttribute("data-static","true");let N=a("span","persona-approval-logo"),D=x(ne,16,"currentColor",2);D&&N.appendChild(D),y.appendChild(N);let H=pe(o,e);if(m){let n=a("span","persona-approval-toggle");n.setAttribute("aria-hidden","true");let p=x(G,14,"currentColor",2);p&&n.appendChild(p),H.append(" "),H.appendChild(n)}y.appendChild(H),l.appendChild(y);let h=a("div","persona-approval-body");if(m){let n=a("div","persona-approval-details");if(n.setAttribute("data-role","params"),n.hidden=!f,C){let p=a("p","persona-approval-desc");e?.descriptionColor&&(p.style.color=e.descriptionColor),p.textContent=o.description,n.appendChild(p)}if(A){let p=a("pre","persona-approval-params");e?.parameterBackgroundColor&&(p.style.background=e.parameterBackgroundColor),e?.parameterTextColor&&(p.style.color=e.parameterTextColor),p.textContent=P(o.parameters),n.appendChild(p)}h.appendChild(n)}if(o.reason){let n=a("p","persona-approval-reason");e?.reasonColor?n.style.color=e.reasonColor:e?.descriptionColor&&(n.style.color=e.descriptionColor);let p=a("span","persona-approval-reason-label");p.textContent=`${e?.reasonLabel??"Agent's stated reason:"} `,n.append(p,document.createTextNode(o.reason)),h.appendChild(n)}let W=a("div","persona-approval-actions"),M=null,S=n=>{e?.approveButtonColor&&(n.style.background=e.approveButtonColor),e?.approveButtonTextColor&&(n.style.color=e.approveButtonTextColor)},s=a("button","persona-approval-deny");if(s.type="button",s.setAttribute("data-action","deny"),e?.denyButtonColor&&(s.style.background=e.denyButtonColor),e?.denyButtonTextColor&&(s.style.color=e.denyButtonTextColor),s.append(e?.denyLabel??"Deny"),g){let n=a("div","persona-approval-split"),p=a("button","persona-approval-primary");p.type="button",p.setAttribute("data-action","always"),S(p),p.append(e?.approveLabel??"Always allow",U("\u23CE"));let b=a("button","persona-approval-caret");b.type="button",b.setAttribute("data-action","toggle-menu"),b.setAttribute("aria-label","More options"),S(b);let c=x(G,15,"currentColor",2);c&&b.appendChild(c),n.append(p,b),W.append(n,s),s.append(U("Esc"));let d=a("div","persona-approval-menu"),L=a("button","persona-approval-menu-item");L.type="button",L.append("Allow once",U("\u2318\u23CE")),d.appendChild(L),M=q({anchor:n,content:d,placement:"bottom-start",matchAnchorWidth:!0}),t.popovers.set(r.id,M),L.addEventListener("click",()=>{T(t,r.id),u()})}else{let n=a("button","persona-approval-primary persona-approval-primary--solo");n.type="button",n.setAttribute("data-action","allow"),S(n),n.append(e?.approveLabel??"Allow"),W.append(n,s)}return h.appendChild(W),l.appendChild(h),l.addEventListener("click",n=>{let p=n.target instanceof Element?n.target.closest("[data-action]"):null;if(!p)return;let b=p.getAttribute("data-action");if(b==="toggle-params"){let c=l.querySelector('[data-role="params"]');if(c){let d=c.hidden;c.hidden=!d,y.setAttribute("aria-expanded",d?"true":"false"),y.setAttribute("aria-label",d?O:w),k.set(r.id,d)}return}if(b==="toggle-menu"){M?.toggle();return}if(b==="always"){T(t,r.id),u({remember:!0});return}if(b==="allow"){T(t,r.id),u();return}if(b==="deny"){T(t,r.id),i();return}}),l},Q=()=>{let t=re();return{plugin:{id:"persona-built-in-approval",renderApproval:({message:e,approve:u,deny:i,config:g})=>{let l=e?.approval;if(!l)return null;let v=ae(g);if(l.status!=="pending"){if(T(t,e.id),l.status==="approved"){let m=document.createElement("div");return m.style.display="none",m}return le(l)}J(t,e.id);let C=v?.enableAlwaysAllow===!0,A=ie(t,e,l,v,u,i,C);if(C){t.pendingOrder.includes(e.id)||t.pendingOrder.push(e.id),t.latestPendingApprovalId=t.pendingOrder[t.pendingOrder.length-1];let m=f=>{$(f)||e.id===t.latestPendingApprovalId&&(f.key!=="Escape"&&f.key!=="Enter"||(f.preventDefault(),f.stopImmediatePropagation(),T(t,e.id),f.key==="Escape"?i():f.metaKey||f.ctrlKey?u():u({remember:!0})))};t.keyHandlers.set(e.id,m),document.addEventListener("keydown",m)}return A}},teardown:()=>{for(let e of[...t.keyHandlers.keys(),...t.popovers.keys()])T(t,e);t.latestPendingApprovalId=null}}};export{k as approvalDetailsExpansionState,Z as createApprovalBubble,Q as createBuiltInApprovalPlugin,B as humanizeToolName,z as initApprovalUi,V as updateApprovalDetailsUI};

package/dist/voice-runtime-EFR3R5ES.js

@@ -1 +0,0 @@
-import{a as m}from"./chunk-5EIIHQLQ.js";var g=16e3,y=24e3,k=4096,C=4,S=1380533830;function E(r){return r.byteLength>=44&&new DataView(r).getUint32(0,!1)===S?new Uint8Array(r,44):new Uint8Array(r)}function V(r){let t=r.replace(/\/+$/,"");return/^wss?:\/\//i.test(t)?t:/^https?:\/\//i.test(t)?t.replace(/^http/i,"ws"):`${typeof window<"u"&&window.location?.protocol==="https:"?"wss:":"ws:"}//${t}`}var d=class{constructor(t){this.config=t;this.type="runtype";this.ws=null;this.captureContext=null;this.levelCallbacks=[];this.mediaStream=null;this.sourceNode=null;this.processor=null;this.playback=null;this.callLive=!1;this.isSpeaking=!1;this.callGeneration=0;this.intentionalClose=!1;this.resultCallbacks=[];this.errorCallbacks=[];this.statusCallbacks=[];this.transcriptCallbacks=[];this.metricsCallbacks=[]}async connect(){}async startListening(){if(this.callLive)return;let t=this.config?.agentId,e=this.config?.clientToken,i=this.config?.host;if(!t)throw new Error("Runtype voice requires an agentId");if(!e)throw new Error("Runtype voice requires a clientToken");if(!i)throw new Error("Runtype voice requires a host (or widget apiUrl)");let s=++this.callGeneration;this.intentionalClose=!1,this.callLive=!0;try{let o=await navigator.mediaDevices.getUserMedia({audio:{sampleRate:g,channelCount:1,echoCancellation:!0}});if(s!==this.callGeneration){o.getTracks().forEach(a=>a.stop());return}this.mediaStream=o;let p=window.AudioContext||window.webkitAudioContext,u=new p({sampleRate:g});u.state==="suspended"&&await u.resume().catch(()=>{}),this.captureContext=u;let l=this.config?.createPlaybackEngine?await this.config.createPlaybackEngine():new m(y);if(s!==this.callGeneration){l.destroy(),o.getTracks().forEach(a=>a.stop()),u.close().catch(()=>{});return}this.playback=l,l.onFinished(()=>{s===this.callGeneration&&(this.isSpeaking=!1,this.ws&&this.ws.readyState===WebSocket.OPEN&&this.emitStatus("listening"))});let f=`${V(i)}/ws/agents/${encodeURIComponent(t)}/voice`,n=new WebSocket(f,["runtype.bearer",e]);n.binaryType="arraybuffer",this.ws=n,n.onopen=()=>{s===this.callGeneration&&(this.emitStatus("listening"),this.startCapture(u,o,n,s))},n.onmessage=a=>this.handleMessage(a,s),n.onerror=()=>{s===this.callGeneration&&(this.emitError(new Error("Voice connection failed")),this.emitStatus("error"),this.cleanup())},n.onclose=a=>{if(this.intentionalClose){this.intentionalClose=!1;return}if(s===this.callGeneration){if(a.code!==1e3){let c=a.code?` (code ${a.code})`:"";this.emitError(new Error(`Voice connection closed${c}`)),this.emitStatus("error")}else this.emitStatus("idle");this.cleanup()}}}catch(o){throw this.cleanup(),this.emitError(o),this.emitStatus("error"),o}}async stopListening(){this.cleanup(),this.emitStatus("idle")}async disconnect(){this.cleanup(),this.emitStatus("disconnected"),this.resultCallbacks=[],this.errorCallbacks=[],this.statusCallbacks=[],this.transcriptCallbacks=[],this.metricsCallbacks=[]}stopPlayback(){this.playback&&this.playback.flush(),this.isSpeaking=!1,this.ws&&this.ws.readyState===WebSocket.OPEN&&this.emitStatus("listening")}getInterruptionMode(){return"barge-in"}isBargeInActive(){return this.callLive}onLevel(t){this.levelCallbacks.push(t)}async deactivateBargeIn(){this.cleanup(),this.emitStatus("idle")}startCapture(t,e,i,s){let o=t.createMediaStreamSource(e);this.sourceNode=o;let p=t.createScriptProcessor(k,1,1);this.processor=p,p.onaudioprocess=u=>{if(s!==this.callGeneration||i.readyState!==WebSocket.OPEN)return;let l=u.inputBuffer.getChannelData(0),f=new Int16Array(l.length),n=0;for(let a=0;a<l.length;a++){let c=Math.max(-1,Math.min(1,l[a]));n+=c*c,f[a]=c<0?c*32768:c*32767}if(i.send(f.buffer),this.levelCallbacks.length>0){let a=Math.sqrt(n/l.length),c=Math.max(0,Math.min(1,a*C));for(let b of this.levelCallbacks)b(c)}},o.connect(p),p.connect(t.destination)}handleMessage(t,e){if(e!==this.callGeneration)return;if(t.data instanceof ArrayBuffer){this.handleAudioFrame(t.data,e);return}let i;try{i=JSON.parse(t.data)}catch{return}switch(i.type){case"transcript_interim":this.emitStatus("listening"),this.emitTranscript("user",i.text??"",!1);break;case"transcript_final":{let s=i.role==="assistant"?"assistant":"user";this.emitStatus(s==="user"?"processing":"speaking"),this.emitTranscript(s,i.text??"",!0);break}case"audio_end":this.playback?this.playback.markStreamEnd():(this.isSpeaking=!1,this.emitStatus("listening"));break;case"metrics":this.emitMetrics({llmMs:i.llm_ms,ttsMs:i.tts_ms,firstAudioMs:i.first_audio_ms,totalMs:i.total_ms});break;case"error":this.emitError(new Error(i.error||"Voice error")),this.emitStatus("error");break}}handleAudioFrame(t,e){if(e!==this.callGeneration||!this.playback)return;let i=E(t);i.length!==0&&(this.isSpeaking||(this.isSpeaking=!0,this.emitStatus("speaking")),this.playback.enqueue(i))}cleanup(){if(this.callGeneration+=1,this.callLive=!1,this.isSpeaking=!1,this.processor&&(this.processor.onaudioprocess=null,this.processor.disconnect(),this.processor=null),this.sourceNode&&(this.sourceNode.disconnect(),this.sourceNode=null),this.mediaStream&&(this.mediaStream.getTracks().forEach(t=>t.stop()),this.mediaStream=null),this.captureContext&&(this.captureContext.close().catch(()=>{}),this.captureContext=null),this.playback&&(this.playback.destroy(),this.playback=null),this.ws){this.intentionalClose=!0;try{this.ws.close(1e3,"client ended call")}catch{}this.ws=null}}onResult(t){this.resultCallbacks.push(t)}onError(t){this.errorCallbacks.push(t)}onStatusChange(t){this.statusCallbacks.push(t)}onTranscript(t){this.transcriptCallbacks.push(t)}onMetrics(t){this.metricsCallbacks.push(t)}emitStatus(t){this.statusCallbacks.forEach(e=>e(t))}emitError(t){this.errorCallbacks.forEach(e=>e(t))}emitTranscript(t,e,i){this.transcriptCallbacks.forEach(s=>s(t,e,i))}emitMetrics(t){this.metricsCallbacks.forEach(e=>e(t))}};var h=class{constructor(t={}){this.config=t;this.type="browser";this.recognition=null;this.resultCallbacks=[];this.errorCallbacks=[];this.statusCallbacks=[];this.isListening=!1;this.w=typeof window<"u"?window:void 0}async connect(){this.statusCallbacks.forEach(t=>t("connected"))}async startListening(){try{if(this.isListening)throw new Error("Already listening");if(!this.w)throw new Error("Window object not available");let t=this.w.SpeechRecognition||this.w.webkitSpeechRecognition;if(!t)throw new Error("Browser speech recognition not supported");this.recognition=new t,this.recognition.lang=this.config?.language||"en-US",this.recognition.continuous=this.config?.continuous||!1,this.recognition.interimResults=!0,this.recognition.onresult=e=>{let i=Array.from(e.results).map(o=>o[0]).map(o=>o.transcript).join(""),s=e.results[e.results.length-1].isFinal;this.resultCallbacks.forEach(o=>o({text:i,confidence:s?.8:.5,provider:"browser"})),s&&!this.config?.continuous&&this.stopListening()},this.recognition.onerror=e=>{this.errorCallbacks.forEach(i=>i(new Error(e.error))),this.statusCallbacks.forEach(i=>i("error"))},this.recognition.onstart=()=>{this.isListening=!0,this.statusCallbacks.forEach(e=>e("listening"))},this.recognition.onend=()=>{this.isListening=!1,this.statusCallbacks.forEach(e=>e("idle"))},this.recognition.start()}catch(t){throw this.errorCallbacks.forEach(e=>e(t)),this.statusCallbacks.forEach(e=>e("error")),t}}async stopListening(){this.recognition&&(this.recognition.stop(),this.recognition=null),this.isListening=!1,this.statusCallbacks.forEach(t=>t("idle"))}onResult(t){this.resultCallbacks.push(t)}onError(t){this.errorCallbacks.push(t)}onStatusChange(t){this.statusCallbacks.push(t)}async disconnect(){await this.stopListening(),this.statusCallbacks.forEach(t=>t("disconnected"))}static isSupported(){return"SpeechRecognition"in window||"webkitSpeechRecognition"in window}};function v(r){switch(r.type){case"runtype":if(!r.runtype)throw new Error("Runtype voice provider requires configuration");return new d(r.runtype);case"browser":if(!h.isSupported())throw new Error("Browser speech recognition not supported");return new h(r.browser||{});case"custom":{let t=r.custom;if(!t)throw new Error("Custom voice provider requires a `custom` provider instance or factory");let e=typeof t=="function"?t():t;if(!e||typeof e.startListening!="function")throw new Error("Custom voice provider `custom` must be a VoiceProvider (or a factory returning one)");return e}default:throw new Error(`Unknown voice provider type: ${r.type}`)}}function w(r){if(r?.type==="custom"&&r.custom)return v({type:"custom",custom:r.custom});if(r?.type==="runtype"&&r.runtype)return v({type:"runtype",runtype:r.runtype});if(h.isSupported())return v({type:"browser",browser:r?.browser||{language:"en-US"}});throw new Error("No supported voice providers available")}function P(r){try{return w(r),!0}catch{return!1}}export{h as BrowserVoiceProvider,d as RuntypeVoiceProvider,w as createBestAvailableVoiceProvider,v as createVoiceProvider,P as isVoiceSupported};