@urun-sh/react 0.2.3 → 0.2.5

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.2.5
+
+- Session workbench building blocks: generic, composable debug/steer components
+  over the public `Session` primitives — `UrunStreamTail` (named data-lane tail
+  over `stream.messages()`), `UrunDocPanel` + `UrunControlSender` (view/patch a
+  session doc), `UrunEventSpine` (SDK-native activity log from `onPhase` /
+  track / doc events), `UrunSessionStatus` + `UrunSessionGate`, plus the hooks
+  `useSessionTrack` / `useSessionDoc` / `useStreamMessages`. Media panes reuse
+  the existing `UrunVideo` / `UrunAudio` / `UrunVoice`. See
+  `docs/session-workbench-building-blocks.md`.
+- `useStreamMessages` now cancels the stream's async iterator (calls
+  `.return()`) on unmount / name change, instead of only flipping a local
+  flag — on a quiet stream the old subscription used to linger until the next
+  message ever arrived.
+- `UrunControlSender`'s doc-change log line is labeled `change` instead of
+  `recv`: the core doc has no origin marker, so the line also fires for this
+  component's own writes and `recv` overclaimed it came from the runtime.
+
 ## 0.2.1
 
 - Republish of the 0.2.0 line (`@urun-sh/core` / `@urun-sh/react` 0.2.0 published but never persisted in the npm packument; bumped to 0.2.1 for a clean, resolvable release). No source changes vs 0.2.0.

package/dist/auth.d.mts

@@ -0,0 +1,6 @@
+type UrunAuthMode = 'workos' | 'jwt';
+declare function urunPublicEnv(name: string): string | undefined;
+declare function authMode(): UrunAuthMode;
+declare function usesWorkOSAuth(): boolean;
+
+export { type UrunAuthMode, authMode, urunPublicEnv, usesWorkOSAuth };

package/dist/auth.d.ts

@@ -0,0 +1,6 @@
+type UrunAuthMode = 'workos' | 'jwt';
+declare function urunPublicEnv(name: string): string | undefined;
+declare function authMode(): UrunAuthMode;
+declare function usesWorkOSAuth(): boolean;
+
+export { type UrunAuthMode, authMode, urunPublicEnv, usesWorkOSAuth };

package/dist/auth.js

@@ -0,0 +1 @@
+"use strict";var u=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var p=(e,n)=>{for(var s in n)u(e,s,{get:n[s],enumerable:!0})},U=(e,n,s,i)=>{if(n&&typeof n=="object"||typeof n=="function")for(let o of f(n))!c.call(e,o)&&o!==s&&u(e,o,{get:()=>n[o],enumerable:!(i=E(n,o))||i.enumerable});return e};var N=e=>U(u({},"__esModule",{value:!0}),e);var T={};p(T,{authMode:()=>d,urunPublicEnv:()=>t,usesWorkOSAuth:()=>_});module.exports=N(T);function r(e){return e&&e.trim()?e.trim():void 0}function t(e){switch(e){case"NEXT_PUBLIC_AUTH_MODE":return r(typeof process<"u"?process.env?.NEXT_PUBLIC_AUTH_MODE:void 0);case"NEXT_PUBLIC_AUTH_ENABLED":return r(typeof process<"u"?process.env?.NEXT_PUBLIC_AUTH_ENABLED:void 0);case"NEXT_PUBLIC_SESSION_AUTH_PROVIDER":return r(typeof process<"u"?process.env?.NEXT_PUBLIC_SESSION_AUTH_PROVIDER:void 0);case"NEXT_PUBLIC_SESSION_TOKEN":return r(typeof process<"u"?process.env?.NEXT_PUBLIC_SESSION_TOKEN:void 0);case"NEXT_PUBLIC_URUN_JWT":return r(typeof process<"u"?process.env?.NEXT_PUBLIC_URUN_JWT:void 0);case"VERCEL_ENV":return r(typeof process<"u"?process.env?.VERCEL_ENV:void 0);default:return r(typeof process<"u"?process.env?.[e]:void 0)}}function d(){let e=t("NEXT_PUBLIC_AUTH_MODE")?.toLowerCase();return e==="jwt"||e==="customer-jwt"||e==="test-jwt"?"jwt":e==="workos"||t("VERCEL_ENV")==="production"?"workos":t("NEXT_PUBLIC_AUTH_ENABLED")==="false"?"jwt":"workos"}function _(){return d()==="workos"}0&&(module.exports={authMode,urunPublicEnv,usesWorkOSAuth});

package/dist/auth.mjs

@@ -0,0 +1 @@
+import{a as u,b as o,c as e}from"./chunk-SSZO4I6Y.mjs";export{o as authMode,u as urunPublicEnv,e as usesWorkOSAuth};

package/dist/chunk-SSZO4I6Y.mjs

@@ -0,0 +1 @@
+function n(e){return e&&e.trim()?e.trim():void 0}function r(e){switch(e){case"NEXT_PUBLIC_AUTH_MODE":return n(typeof process<"u"?process.env?.NEXT_PUBLIC_AUTH_MODE:void 0);case"NEXT_PUBLIC_AUTH_ENABLED":return n(typeof process<"u"?process.env?.NEXT_PUBLIC_AUTH_ENABLED:void 0);case"NEXT_PUBLIC_SESSION_AUTH_PROVIDER":return n(typeof process<"u"?process.env?.NEXT_PUBLIC_SESSION_AUTH_PROVIDER:void 0);case"NEXT_PUBLIC_SESSION_TOKEN":return n(typeof process<"u"?process.env?.NEXT_PUBLIC_SESSION_TOKEN:void 0);case"NEXT_PUBLIC_URUN_JWT":return n(typeof process<"u"?process.env?.NEXT_PUBLIC_URUN_JWT:void 0);case"VERCEL_ENV":return n(typeof process<"u"?process.env?.VERCEL_ENV:void 0);default:return n(typeof process<"u"?process.env?.[e]:void 0)}}function s(){let e=r("NEXT_PUBLIC_AUTH_MODE")?.toLowerCase();return e==="jwt"||e==="customer-jwt"||e==="test-jwt"?"jwt":e==="workos"||r("VERCEL_ENV")==="production"?"workos":r("NEXT_PUBLIC_AUTH_ENABLED")==="false"?"jwt":"workos"}function t(){return s()==="workos"}export{r as a,s as b,t as c};

package/dist/index.css

@@ -1 +1 @@
-:root{--urun-bg: #ffffff;--urun-text: #1a1a2e;--urun-border: #e2e8f0;--urun-radius: 8px;--urun-font: system-ui, -apple-system, sans-serif;--urun-progress-bg: #e2e8f0;--urun-progress-fill: #3b82f6;--urun-progress-success: #22c55e;--urun-progress-error: #ef4444;--urun-progress-height: 8px;--urun-status-thinking: #f59e0b;--urun-status-generating: #3b82f6;--urun-status-idle: #94a3b8;--urun-status-error: #ef4444;--urun-status-indicator-size: 8px;--urun-cursor-color: #3b82f6;--urun-cursor-width: 2px;--urun-metric-bg: #f8fafc;--urun-metric-label-color: #64748b;--urun-metric-value-color: #1a1a2e}.urun-progress-card{font-family:var(--urun-font);color:var(--urun-text);border:1px solid var(--urun-border);border-radius:var(--urun-radius);padding:12px 16px;background:var(--urun-bg)}.urun-progress-label{font-size:.875rem;font-weight:500;margin-bottom:8px}.urun-progress-bar{height:var(--urun-progress-height);background:var(--urun-progress-bg);border-radius:calc(var(--urun-progress-height) / 2);overflow:hidden}.urun-progress-fill{height:100%;background:var(--urun-progress-fill);border-radius:inherit;transition:width .3s ease}.urun-progress-card[data-variant=success] .urun-progress-fill{background:var(--urun-progress-success)}.urun-progress-card[data-variant=error] .urun-progress-fill{background:var(--urun-progress-error)}.urun-progress-text{font-size:.75rem;color:var(--urun-metric-label-color);margin-top:4px;text-align:right}.urun-status-badge{display:inline-flex;align-items:center;gap:6px;font-family:var(--urun-font);font-size:.875rem;color:var(--urun-text)}.urun-status-indicator{display:inline-block;width:var(--urun-status-indicator-size);height:var(--urun-status-indicator-size);border-radius:50%;background:var(--urun-status-idle);flex-shrink:0}.urun-status-badge[data-state=thinking] .urun-status-indicator{background:var(--urun-status-thinking)}.urun-status-badge[data-state=generating] .urun-status-indicator{background:var(--urun-status-generating)}.urun-status-badge[data-state=error] .urun-status-indicator{background:var(--urun-status-error)}.urun-status-pulse{animation:urun-pulse 1.5s ease-in-out infinite}.urun-text-stream{font-family:var(--urun-font);color:var(--urun-text);white-space:pre-wrap;word-break:break-word}.urun-text-cursor{display:inline-block;width:var(--urun-cursor-width);height:1em;background:var(--urun-cursor-color);vertical-align:text-bottom;animation:urun-blink 1s step-end infinite}.urun-image-frame{margin:0;border:1px solid var(--urun-border);border-radius:var(--urun-radius);overflow:hidden;background:var(--urun-bg)}.urun-image{display:block;width:100%;height:auto}.urun-image-caption{padding:8px 12px;font-family:var(--urun-font);font-size:.875rem;color:var(--urun-metric-label-color);text-align:center}.urun-metrics-panel{display:grid;grid-template-columns:repeat(auto-fit,minmax(120px,1fr));gap:12px;font-family:var(--urun-font)}.urun-metric-card{background:var(--urun-metric-bg);border:1px solid var(--urun-border);border-radius:var(--urun-radius);padding:12px;text-align:center}.urun-metric-label{font-size:.75rem;color:var(--urun-metric-label-color);margin-bottom:4px}.urun-metric-value{font-size:1.25rem;font-weight:600;color:var(--urun-metric-value-color)}.urun-component-error{font-family:var(--urun-font);padding:8px 12px;border:1px solid var(--urun-status-error);border-radius:var(--urun-radius);background:#fef2f2;color:var(--urun-status-error);font-size:.875rem}@keyframes urun-pulse{0%,to{opacity:1}50%{opacity:.4}}@keyframes urun-blink{0%,to{opacity:1}50%{opacity:0}}[data-urun-video],[data-urun-video] .video-js,[data-urun-video] .vjs-tech{width:100%;height:100%}[data-urun-video] .vjs-tech{object-fit:contain}.urun-video-live.vjs-has-started .vjs-poster,.urun-video-live.vjs-has-started .vjs-loading-spinner,.urun-video-live.vjs-has-started .vjs-big-play-button{display:none!important}.urun-video-live .vjs-poster{background-color:transparent}
+:root{--urun-bg: #ffffff;--urun-text: #1a1a2e;--urun-border: #e2e8f0;--urun-radius: 8px;--urun-font: system-ui, -apple-system, sans-serif;--urun-progress-bg: #e2e8f0;--urun-progress-fill: #3b82f6;--urun-progress-success: #22c55e;--urun-progress-error: #ef4444;--urun-progress-height: 8px;--urun-status-thinking: #f59e0b;--urun-status-generating: #3b82f6;--urun-status-idle: #94a3b8;--urun-status-error: #ef4444;--urun-status-indicator-size: 8px;--urun-cursor-color: #3b82f6;--urun-cursor-width: 2px;--urun-metric-bg: #f8fafc;--urun-metric-label-color: #64748b;--urun-metric-value-color: #1a1a2e}.urun-progress-card{font-family:var(--urun-font);color:var(--urun-text);border:1px solid var(--urun-border);border-radius:var(--urun-radius);padding:12px 16px;background:var(--urun-bg)}.urun-progress-label{font-size:.875rem;font-weight:500;margin-bottom:8px}.urun-progress-bar{height:var(--urun-progress-height);background:var(--urun-progress-bg);border-radius:calc(var(--urun-progress-height) / 2);overflow:hidden}.urun-progress-fill{height:100%;background:var(--urun-progress-fill);border-radius:inherit;transition:width .3s ease}.urun-progress-card[data-variant=success] .urun-progress-fill{background:var(--urun-progress-success)}.urun-progress-card[data-variant=error] .urun-progress-fill{background:var(--urun-progress-error)}.urun-progress-text{font-size:.75rem;color:var(--urun-metric-label-color);margin-top:4px;text-align:right}.urun-status-badge{display:inline-flex;align-items:center;gap:6px;font-family:var(--urun-font);font-size:.875rem;color:var(--urun-text)}.urun-status-indicator{display:inline-block;width:var(--urun-status-indicator-size);height:var(--urun-status-indicator-size);border-radius:50%;background:var(--urun-status-idle);flex-shrink:0}.urun-status-badge[data-state=thinking] .urun-status-indicator{background:var(--urun-status-thinking)}.urun-status-badge[data-state=generating] .urun-status-indicator{background:var(--urun-status-generating)}.urun-status-badge[data-state=error] .urun-status-indicator{background:var(--urun-status-error)}.urun-status-pulse{animation:urun-pulse 1.5s ease-in-out infinite}.urun-text-stream{font-family:var(--urun-font);color:var(--urun-text);white-space:pre-wrap;word-break:break-word}.urun-text-cursor{display:inline-block;width:var(--urun-cursor-width);height:1em;background:var(--urun-cursor-color);vertical-align:text-bottom;animation:urun-blink 1s step-end infinite}.urun-image-frame{margin:0;border:1px solid var(--urun-border);border-radius:var(--urun-radius);overflow:hidden;background:var(--urun-bg)}.urun-image{display:block;width:100%;height:auto}.urun-image-caption{padding:8px 12px;font-family:var(--urun-font);font-size:.875rem;color:var(--urun-metric-label-color);text-align:center}.urun-metrics-panel{display:grid;grid-template-columns:repeat(auto-fit,minmax(120px,1fr));gap:12px;font-family:var(--urun-font)}.urun-metric-card{background:var(--urun-metric-bg);border:1px solid var(--urun-border);border-radius:var(--urun-radius);padding:12px;text-align:center}.urun-metric-label{font-size:.75rem;color:var(--urun-metric-label-color);margin-bottom:4px}.urun-metric-value{font-size:1.25rem;font-weight:600;color:var(--urun-metric-value-color)}.urun-component-error{font-family:var(--urun-font);padding:8px 12px;border:1px solid var(--urun-status-error);border-radius:var(--urun-radius);background:#fef2f2;color:var(--urun-status-error);font-size:.875rem}@keyframes urun-pulse{0%,to{opacity:1}50%{opacity:.4}}@keyframes urun-blink{0%,to{opacity:1}50%{opacity:0}}[data-urun-video],[data-urun-video] .video-js,[data-urun-video] .vjs-tech{width:100%;height:100%}[data-urun-video] .vjs-tech{object-fit:contain}.urun-video-live.vjs-has-started .vjs-poster,.urun-video-live.vjs-has-started .vjs-loading-spinner,.urun-video-live.vjs-has-started .vjs-big-play-button{display:none!important}.urun-video-live .vjs-poster{background-color:transparent}.urun-stream-tail,.urun-doc-panel,.urun-control-sender,.urun-event-spine{display:flex;flex-direction:column;gap:6px;font-size:12px}.urun-stream-tail-meta,.urun-doc-panel-meta{display:flex;align-items:center;gap:8px;color:var(--urun-wb-muted, #8a8a8a)}.urun-stream-tail-log,.urun-control-sender-log{display:flex;flex-direction:column;gap:2px;max-height:220px;overflow:auto;padding:6px;border-radius:6px;background:var(--urun-wb-log-bg, rgba(0, 0, 0, .25));font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px}.urun-stream-tail-time,.urun-control-sender-time,.urun-event-spine-time{color:var(--urun-wb-muted, #8a8a8a)}.urun-doc-panel-snapshot{margin:0;padding:8px;max-height:220px;overflow:auto;border-radius:6px;background:var(--urun-wb-log-bg, rgba(0, 0, 0, .25));font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px}.urun-doc-patch,.urun-control-sender{display:flex;flex-direction:column;gap:6px}.urun-doc-patch-input{width:100%;resize:vertical;border-radius:6px;border:1px solid var(--urun-wb-border, rgba(128, 128, 128, .4));background:var(--urun-wb-input-bg, transparent);color:inherit;padding:6px 8px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px}.urun-doc-patch-actions{display:flex;align-items:center;gap:8px}.urun-doc-patch-button,.urun-mic-button{cursor:pointer;border-radius:6px;border:1px solid var(--urun-wb-border, rgba(128, 128, 128, .4));background:var(--urun-wb-accent, #24db49);color:var(--urun-wb-accent-fg, #04120a);padding:4px 12px;font-size:12px;font-weight:600}.urun-doc-patch-button:disabled{cursor:default;opacity:.5}.urun-doc-patch-error,.urun-mic-error{color:var(--urun-wb-danger, #e5484d)}.urun-event-spine{max-height:260px;overflow:auto}.urun-event-spine-line,.urun-control-sender-line{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:11px}.urun-event-spine-kind,.urun-control-sender-dir{display:inline-block;min-width:3.5em;color:var(--urun-wb-muted, #8a8a8a)}.urun-session-status{display:inline-flex;align-items:center;gap:6px;font-size:12px}.urun-session-status-dot{width:8px;height:8px;border-radius:50%;background:var(--urun-wb-muted, #8a8a8a)}.urun-session-status-dot[data-phase=live]{background:var(--urun-wb-accent, #24db49)}.urun-session-status-dot[data-phase=connecting],.urun-session-status-dot[data-phase=provisioning],.urun-session-status-dot[data-phase=queued]{background:var(--urun-wb-warn, #ffb224)}.urun-session-status-dot[data-phase=error]{background:var(--urun-wb-danger, #e5484d)}.urun-session-status-detail{color:var(--urun-wb-muted, #8a8a8a)}

package/dist/index.d.mts

@@ -1,7 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { RefObject, ReactNode, Component, ErrorInfo, ComponentType } from 'react';
-import { SessionInterface, SessionDocument, SessionStream, SessionPhase } from '@urun-sh/core';
+export { UrunAuthMode, authMode, urunPublicEnv, usesWorkOSAuth } from './auth.mjs';
+import { SessionInterface, SessionDocument, SessionStream, SessionPhase, SessionStatus } from '@urun-sh/core';
 export { App as AppInterface, AppOptions, SessionDocument, Session as SessionInterface, SessionPhase, SessionPhaseName, SessionStream } from '@urun-sh/core';
 import { ZodSchema, z } from 'zod';
 import Player from 'video.js/dist/types/player';
@@ -60,11 +61,6 @@ declare function UrunAuthProvider({ getAccessToken, children }: UrunAuthProvider
 declare const UrunJwtProvider: typeof UrunAuthProvider;
 declare function useUrunAuth(): UrunAuthContextValue | null;
 
-type UrunAuthMode = 'workos' | 'jwt';
-declare function urunPublicEnv(name: string): string | undefined;
-declare function authMode(): UrunAuthMode;
-declare function usesWorkOSAuth(): boolean;
-
 type Unsubscribe = () => void;
 type ReactSessionDocument<T = Record<string, unknown>> = Omit<SessionDocument, 'get' | 'set' | 'on'> & {
     get(): T;
@@ -78,6 +74,8 @@ interface ReactSession extends Omit<SessionInterface, 'doc' | 'stream'> {
     stream(name: string): ReactSessionStream;
     
     readonly phase: SessionPhase;
+    
+    readonly status: SessionStatus;
 }
 type ReactApp = Record<string, (args?: Record<string, unknown>) => ReactSession>;
 
@@ -279,12 +277,12 @@ declare const ImageFrameSchema: z.ZodObject<{
     caption: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     src: string;
-    alt?: string | undefined;
     caption?: string | undefined;
+    alt?: string | undefined;
 }, {
     src: string;
-    alt?: string | undefined;
     caption?: string | undefined;
+    alt?: string | undefined;
 }>;
 type ImageFrameProps = z.infer<typeof ImageFrameSchema>;
 declare function useImageFrame(props: ImageFrameProps): {
@@ -300,24 +298,24 @@ declare const MetricsPanelSchema: z.ZodObject<{
         value: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
         unit: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        value: string | number;
         label: string;
+        value: string | number;
         unit?: string | undefined;
     }, {
-        value: string | number;
         label: string;
+        value: string | number;
         unit?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     metrics: {
-        value: string | number;
         label: string;
+        value: string | number;
         unit?: string | undefined;
     }[];
 }, {
     metrics: {
-        value: string | number;
         label: string;
+        value: string | number;
         unit?: string | undefined;
     }[];
 }>;
@@ -366,4 +364,355 @@ interface UrunVideoProps {
 
 declare const UrunVideo: react.ForwardRefExoticComponent<UrunVideoProps & react.RefAttributes<HTMLVideoElement>>;
 
-export { type ChatMessage, type ChatRole, ComponentRenderer, ImageFrame, ImageFrameSchema, MetricsPanel, MetricsPanelSchema, ProgressCard, ProgressCardSchema, type ReactApp, type ReactSession, type ReactSessionDocument, type ReactSessionStream, type RegisteredComponent, type RequestCapableSession, type RequestStream, type SessionRequestOptions, StatusBadge, StatusBadgeSchema, TextStream, TextStreamSchema, type UrunAccessToken, type UrunAccessTokenProvider, type UrunAuthContextValue, type UrunAuthMode, UrunAuthProvider, type UrunAuthProviderProps, UrunErrorBoundary, UrunJwtProvider, UrunProvider, UrunVideo, type UrunVideoProps, type UseChatOptions, type UseChatResult, type UseCompletionOptions, type UseCompletionResult, type UseRequestOptions, type UseRequestResult, authMode, registerComponent, urunPublicEnv, useApp, useChat, useCompletion, useImageFrame, useMetricsPanel, useProgressCard, useRequest, useStatusBadge, useTextStream, useUrunAuth, usesWorkOSAuth };
+interface UrunAudioStreamSource {
+    
+    readonly track: MediaStreamTrack | null;
+    
+    on(event: 'track', handler: (track: MediaStreamTrack | null) => void): () => void;
+}
+
+interface UrunAudioSessionSource {
+    stream(name: string): UrunAudioStreamSource;
+}
+
+interface UrunAudioHandle {
+    
+    unlock(): void;
+    
+    readonly unlocked: boolean;
+    
+    readonly element: HTMLAudioElement | null;
+}
+
+interface UrunAudioProps {
+    
+    session?: UrunAudioSessionSource | null;
+    
+    stream?: string;
+    
+    track?: MediaStreamTrack | null;
+    
+    controls?: boolean;
+    
+    className?: string;
+    
+    onTrack?: (track: MediaStreamTrack | null) => void;
+    
+    onUnlockChange?: (unlocked: boolean) => void;
+    
+    onAudioElement?: (el: HTMLAudioElement | null) => void;
+}
+
+declare const UrunAudio: react.ForwardRefExoticComponent<UrunAudioProps & react.RefAttributes<UrunAudioHandle>>;
+
+interface UrunVoiceStreamSource extends UrunAudioStreamSource {
+    attach(track: MediaStreamTrack): Promise<void>;
+    detach(): Promise<void>;
+}
+
+interface UrunVoiceSessionSource {
+    stream(name: string): UrunVoiceStreamSource;
+    
+    whenLive(options?: {
+        timeout?: number;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    
+    readonly status?: SessionStatus;
+}
+
+interface UrunVoiceHandle {
+    
+    start(): Promise<void>;
+    
+    stop(): Promise<void>;
+    
+    readonly active: boolean;
+    
+    readonly micStream: MediaStream | null;
+    
+    unlock(): void;
+    
+    readonly audio: UrunAudioHandle | null;
+}
+
+interface UrunVoiceProps {
+    
+    session: UrunVoiceSessionSource;
+    
+    stream?: string;
+    
+    constraints?: MediaTrackConstraints;
+    
+    connectTimeoutMs?: number;
+    
+    attempts?: number;
+    
+    retryDelayMs?: number;
+    
+    onActiveChange?: (active: boolean) => void;
+    
+    onError?: (error: Error) => void;
+    
+    onMicStream?: (stream: MediaStream | null) => void;
+    
+    onTrack?: (track: MediaStreamTrack | null) => void;
+    
+    onUnlockChange?: (unlocked: boolean) => void;
+}
+
+declare const DEFAULT_VOICE_CONSTRAINTS: MediaTrackConstraints;
+
+declare const UrunVoice: react.ForwardRefExoticComponent<UrunVoiceProps & react.RefAttributes<UrunVoiceHandle>>;
+
+interface UrunCameraStreamSource {
+    attachVideo(track: MediaStreamTrack): Promise<void>;
+    detachVideo(): Promise<void>;
+}
+
+interface UrunCameraSessionSource {
+    stream(name: string): UrunCameraStreamSource;
+    
+    whenLive(options?: {
+        timeout?: number;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    
+    readonly status?: SessionStatus;
+}
+
+type UrunCameraFacing = 'user' | 'environment';
+
+interface UrunCameraHandle {
+    
+    start(options?: {
+        facingMode?: UrunCameraFacing;
+    }): Promise<void>;
+    
+    stop(): Promise<void>;
+    
+    flip(): Promise<void>;
+    
+    setFacingMode(mode: UrunCameraFacing): Promise<void>;
+    
+    readonly active: boolean;
+    
+    readonly facingMode: UrunCameraFacing;
+    
+    readonly stream: MediaStream | null;
+    
+    readonly element: HTMLVideoElement | null;
+}
+
+interface UrunCameraProps {
+    
+    session: UrunCameraSessionSource;
+    
+    stream?: string;
+    
+    constraints?: MediaTrackConstraints;
+    
+    facingMode?: UrunCameraFacing;
+    
+    mirror?: boolean | 'auto';
+    
+    connectTimeoutMs?: number;
+    
+    preview?: boolean;
+    
+    className?: string;
+    
+    videoClassName?: string;
+    
+    onActiveChange?: (active: boolean) => void;
+    
+    onError?: (error: Error) => void;
+    
+    onStream?: (stream: MediaStream | null) => void;
+    
+    onTrack?: (track: MediaStreamTrack | null) => void;
+    
+    children?: ReactNode;
+}
+
+declare const DEFAULT_CAMERA_CONSTRAINTS: MediaTrackConstraints;
+
+declare const UrunCamera: react.ForwardRefExoticComponent<UrunCameraProps & react.RefAttributes<UrunCameraHandle>>;
+
+interface UseUrunAudioLevelOptions {
+    
+    fftSize?: number;
+    
+    intervalMs?: number;
+    
+    speakingThreshold?: number;
+}
+
+interface UrunAudioLevel {
+    
+    level: number;
+    
+    speaking: boolean;
+}
+
+declare function useUrunAudioLevel(source: MediaStream | MediaStreamTrack | null | undefined, options?: UseUrunAudioLevelOptions): UrunAudioLevel;
+
+declare function getUrunAudioContext(): AudioContext | null;
+
+declare function resumeUrunAudioContext(): void;
+
+interface WorkbenchStreamSource {
+    
+    readonly track: MediaStreamTrack | null;
+    
+    on(event: 'track', handler: (track: MediaStreamTrack | null) => void): () => void;
+    
+    messages(): AsyncIterable<unknown>;
+}
+
+interface WorkbenchDocSource {
+    
+    get(path?: string, defaultValue?: unknown): unknown;
+    
+    set(patch: Record<string, unknown>): void;
+    
+    on(event: 'change', handler: (snapshot: unknown) => void): () => void;
+    
+    readonly synced: boolean;
+    
+    onSynced(handler: () => void): () => void;
+}
+
+interface WorkbenchSession {
+    
+    readonly id: string;
+    
+    readonly phase: SessionPhase;
+    
+    onPhase(handler: (phase: SessionPhase) => void): () => void;
+    
+    stream(name: string): WorkbenchStreamSource;
+    
+    doc(key: string): WorkbenchDocSource;
+}
+
+declare function useSessionTrack(session: WorkbenchSession | null, name: string): MediaStreamTrack | null;
+
+interface UseSessionDocResult<T> {
+    
+    snapshot: T | null;
+    
+    synced: boolean;
+    
+    set: (patch: Partial<T> & Record<string, unknown>) => void;
+}
+
+declare function useSessionDoc<T = Record<string, unknown>>(session: WorkbenchSession | null, key: string): UseSessionDocResult<T>;
+
+declare const DEFAULT_LOG_CAP = 200;
+
+declare function pushCapped<T>(list: readonly T[], entry: T, cap?: number): T[];
+
+interface StreamMessageEntry {
+    at: number;
+    payload: unknown;
+}
+
+interface SpineEntry {
+    at: number;
+    kind: 'phase' | 'track' | 'doc';
+    text: string;
+}
+
+declare function formatPayload(payload: unknown): string;
+type JsonObjectParse = {
+    ok: true;
+    value: Record<string, unknown>;
+} | {
+    ok: false;
+    error: string;
+};
+
+declare function parseJsonObject(text: string): JsonObjectParse;
+
+interface UseStreamMessagesOptions {
+    
+    cap?: number;
+}
+
+declare function useStreamMessages(session: WorkbenchSession | null, name: string, options?: UseStreamMessagesOptions): StreamMessageEntry[];
+
+interface UrunStreamTailProps {
+    
+    session: WorkbenchSession | null;
+    
+    name: string;
+    
+    cap?: number;
+    className?: string;
+}
+
+declare function UrunStreamTail({ session, name, cap, className }: UrunStreamTailProps): react_jsx_runtime.JSX.Element;
+
+declare function DocPatchForm({ placeholder, buttonLabel, disabled, onApply, }: {
+    placeholder?: string;
+    buttonLabel: string;
+    disabled?: boolean;
+    onApply: (patch: Record<string, unknown>, raw: string) => void;
+}): react_jsx_runtime.JSX.Element;
+interface UrunDocPanelProps {
+    session: WorkbenchSession | null;
+    
+    docKey: string;
+    
+    editable?: boolean;
+    
+    patchPlaceholder?: string;
+    className?: string;
+}
+
+declare function UrunDocPanel({ session, docKey, editable, patchPlaceholder, className, }: UrunDocPanelProps): react_jsx_runtime.JSX.Element;
+
+interface UrunControlSenderProps {
+    session: WorkbenchSession | null;
+    
+    docKey?: string;
+    
+    cap?: number;
+    className?: string;
+}
+
+declare function UrunControlSender({ session, docKey, cap, className, }: UrunControlSenderProps): react_jsx_runtime.JSX.Element;
+
+interface UrunEventSpineProps {
+    session: WorkbenchSession | null;
+    
+    trackNames?: string[];
+    
+    docKeys?: string[];
+    
+    cap?: number;
+    className?: string;
+}
+
+declare function UrunEventSpine({ session, trackNames, docKeys, cap, className, }: UrunEventSpineProps): react_jsx_runtime.JSX.Element;
+
+declare function useSessionPhase(session: WorkbenchSession | null): SessionPhase | null;
+interface UrunSessionStatusProps {
+    session: WorkbenchSession | null;
+    className?: string;
+}
+
+declare function UrunSessionStatus({ session, className }: UrunSessionStatusProps): react_jsx_runtime.JSX.Element;
+interface UrunSessionGateProps {
+    session: WorkbenchSession | null;
+    
+    children: ReactNode;
+    
+    fallback?: (phase: SessionPhase | null) => ReactNode;
+    className?: string;
+}
+
+declare function UrunSessionGate({ session, children, fallback, className, }: UrunSessionGateProps): react_jsx_runtime.JSX.Element;
+
+export { type ChatMessage, type ChatRole, ComponentRenderer, DEFAULT_CAMERA_CONSTRAINTS, DEFAULT_LOG_CAP, DEFAULT_VOICE_CONSTRAINTS, DocPatchForm, ImageFrame, ImageFrameSchema, type JsonObjectParse, MetricsPanel, MetricsPanelSchema, ProgressCard, ProgressCardSchema, type ReactApp, type ReactSession, type ReactSessionDocument, type ReactSessionStream, type RegisteredComponent, type RequestCapableSession, type RequestStream, type SessionRequestOptions, type SpineEntry, StatusBadge, StatusBadgeSchema, type StreamMessageEntry, TextStream, TextStreamSchema, type UrunAccessToken, type UrunAccessTokenProvider, UrunAudio, type UrunAudioHandle, type UrunAudioLevel, type UrunAudioProps, type UrunAudioSessionSource, type UrunAudioStreamSource, type UrunAuthContextValue, UrunAuthProvider, type UrunAuthProviderProps, UrunCamera, type UrunCameraFacing, type UrunCameraHandle, type UrunCameraProps, type UrunCameraSessionSource, type UrunCameraStreamSource, UrunControlSender, type UrunControlSenderProps, UrunDocPanel, type UrunDocPanelProps, UrunErrorBoundary, UrunEventSpine, type UrunEventSpineProps, UrunJwtProvider, UrunProvider, UrunSessionGate, type UrunSessionGateProps, UrunSessionStatus, type UrunSessionStatusProps, UrunStreamTail, type UrunStreamTailProps, UrunVideo, type UrunVideoProps, UrunVoice, type UrunVoiceHandle, type UrunVoiceProps, type UrunVoiceSessionSource, type UrunVoiceStreamSource, type UseChatOptions, type UseChatResult, type UseCompletionOptions, type UseCompletionResult, type UseRequestOptions, type UseRequestResult, type UseSessionDocResult, type UseStreamMessagesOptions, type UseUrunAudioLevelOptions, type WorkbenchDocSource, type WorkbenchSession, type WorkbenchStreamSource, formatPayload, getUrunAudioContext, parseJsonObject, pushCapped, registerComponent, resumeUrunAudioContext, useApp, useChat, useCompletion, useImageFrame, useMetricsPanel, useProgressCard, useRequest, useSessionDoc, useSessionPhase, useSessionTrack, useStatusBadge, useStreamMessages, useTextStream, useUrunAudioLevel, useUrunAuth };