@vendoai/ui 0.4.0

package/dist/voice/driver.d.ts

@@ -0,0 +1,94 @@
+/** The public transport seam for the voice stage (08-ui §1, §3). */
+import type { UIPayload } from "@vendoai/core";
+export type VoiceState = "unavailable" | "idle" | "connecting" | "reconnecting" | "listening" | "speaking" | "error";
+export type VoiceSessionState = Extract<VoiceState, "connecting" | "reconnecting" | "listening" | "speaking">;
+export interface VoiceTranscriptEntry {
+    id: string;
+    role: "user" | "assistant";
+    text: string;
+    final: boolean;
+}
+export interface VoiceDriverError {
+    message: string;
+    cause?: unknown;
+}
+export interface VoiceSessionView {
+    id: string;
+    appId: string;
+    payload: UIPayload;
+}
+/** Voice-lane composite (2026-07-19) — a connector call ended `connect-required`
+    mid-session; the stage docks the ConnectCard in the consent slot (Cn-A). */
+export interface VoiceConnectRequest {
+    /** Stable per tool call, so the stage renders one card per blocked call. */
+    id: string;
+    toolkit: string;
+    connector: string;
+    message: string;
+}
+export type KnownVoiceDriverEvent = {
+    type: "state";
+    state: VoiceSessionState;
+} | {
+    type: "transcript";
+    entry: VoiceTranscriptEntry;
+} | {
+    type: "amplitude";
+    level: number;
+} | {
+    type: "view";
+    view: VoiceSessionView;
+}
+/** A recognized spoken decision ("approve"/"decline") — drives the consent
+    bar's spoken-yes register (C-A). Advisory: the guard still records the
+    decision the stage submits. */
+ | {
+    type: "intent";
+    intent: "approve" | "decline";
+} | {
+    type: "connect";
+    connect: VoiceConnectRequest;
+} | {
+    type: "error";
+    error: VoiceDriverError;
+};
+/**
+ * Unknown event variants are deliberately accepted and ignored by consumers,
+ * matching core's forward-compatible stream rule (01-core §15).
+ */
+export type VoiceDriverEvent = KnownVoiceDriverEvent | {
+    type: string;
+    [key: string]: unknown;
+};
+export interface VoiceDriverHandlers {
+    onEvent(event: VoiceDriverEvent): void;
+}
+/** ENG-319 — one realtime function call, as the driver hands it to the bridge. */
+export interface VoiceToolCall {
+    callId: string;
+    name: string;
+    args: unknown;
+}
+/** ENG-319 — what a tool-call handler can do back into the live session. */
+export interface VoiceActSession {
+    /** Land a rendered view in the stage's session feed. */
+    emitView(view: VoiceSessionView): void;
+    /** Surface a connect-required outcome so the stage can dock the ConnectCard
+        (voice-lane Cn-A). Optional: older drivers simply never forward it. */
+    emitConnect?(connect: VoiceConnectRequest): void;
+}
+/** ENG-319 — the realtime tool-call bridge seam: `tools` ride the provider
+    session config; every model function call funnels through `onToolCall`,
+    whose resolved value returns to the model as the function output. */
+export interface VoiceToolBridge {
+    tools: Array<Record<string, unknown>>;
+    onToolCall(call: VoiceToolCall, session: VoiceActSession): Promise<unknown>;
+}
+export interface VoiceSessionHandle {
+    setMuted?(muted: boolean): void;
+    stop(): void;
+}
+export interface VoiceDriver {
+    start(handlers: VoiceDriverHandlers): VoiceSessionHandle;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/voice/driver.d.ts.map

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

package/dist/voice/driver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=driver.js.map

package/dist/voice/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../src/voice/driver.ts"],"names":[],"mappings":""}

package/dist/voice/index.d.ts

@@ -0,0 +1,7 @@
+/** @vendoai/ui/voice — the voice stage driver + surface. Lane D. */
+export { type KnownVoiceDriverEvent, type VoiceDriver, type VoiceDriverError, type VoiceDriverEvent, type VoiceDriverHandlers, type VoiceSessionHandle, type VoiceSessionState, type VoiceSessionView, type VoiceState, type VoiceToolBridge, type VoiceToolCall, type VoiceActSession, type VoiceTranscriptEntry, } from "./driver.js";
+export { createVoiceActBridge, type VoiceActBridgeOptions } from "./voice-act.js";
+export { mapRealtimeServerEvent, realtimeVoiceDriver, type RealtimeMappedEvent, type RealtimeVoiceDriverOptions, } from "./realtime-driver.js";
+export { VendoStage, type VendoStageProps } from "./stage.js";
+export { useVoice, type UseVoiceResult } from "./use-voice.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/voice/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/voice/index.js

@@ -0,0 +1,5 @@
+export { createVoiceActBridge } from "./voice-act.js";
+export { mapRealtimeServerEvent, realtimeVoiceDriver, } from "./realtime-driver.js";
+export { VendoStage } from "./stage.js";
+export { useVoice } from "./use-voice.js";
+//# sourceMappingURL=index.js.map

package/dist/voice/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,oBAAoB,EAA8B,MAAM,gBAAgB,CAAC;AAClF,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAwB,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAuB,MAAM,gBAAgB,CAAC"}

package/dist/voice/realtime-driver.d.ts

@@ -0,0 +1,57 @@
+import type { VoiceDriver, VoiceSessionState, VoiceToolBridge, VoiceTranscriptEntry } from "./driver.js";
+export interface RealtimeVoiceDriverOptions {
+    getSession(): Promise<{
+        clientSecret: string;
+        model?: string;
+    }>;
+    callsUrl?: string;
+    instructions?: string;
+    connectTimeoutMs?: number;
+    /** ENG-319 — the tool-call bridge: its `tools` ride session.update and its
+        `onToolCall` handles every model function call (the resolved value is
+        sent back as the function output and a fresh response is requested). */
+    act?: VoiceToolBridge;
+    /** @internal Browser/retry capability seam for deterministic tests. */
+    __internal?: {
+        browserCapabilities?(): BrowserCapabilities;
+        reconnectDelayMs?(attempt: number): number;
+    };
+}
+export type RealtimeMappedEvent = {
+    type: "state";
+    state: VoiceSessionState;
+} | {
+    type: "transcript-delta";
+    id: string;
+    role: VoiceTranscriptEntry["role"];
+    delta: string;
+} | {
+    type: "transcript-final";
+    id: string;
+    role: VoiceTranscriptEntry["role"];
+    text: string;
+} | {
+    type: "function-call";
+    callId: string;
+    name: string;
+    argsJson: string;
+} | {
+    type: "error";
+    message: string;
+};
+/**
+ * Maps provider data-channel payloads without touching browser globals. Keeping
+ * this seam pure makes protocol growth deterministic and separately testable.
+ */
+export declare function mapRealtimeServerEvent(input: unknown): RealtimeMappedEvent[];
+/** OpenAI Realtime over WebRTC, using only an ephemeral browser credential. */
+export declare function realtimeVoiceDriver(options: RealtimeVoiceDriverOptions): VoiceDriver;
+interface BrowserCapabilities {
+    mediaDevices: Pick<MediaDevices, "getUserMedia">;
+    PeerConnection: typeof RTCPeerConnection;
+    document: Document;
+    fetch: typeof fetch;
+    AudioContext?: typeof AudioContext;
+}
+export {};
+//# sourceMappingURL=realtime-driver.d.ts.map

package/dist/voice/realtime-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-driver.d.ts","sourceRoot":"","sources":["../../src/voice/realtime-driver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EAGX,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,0BAA0B;IACzC,UAAU,IAAI,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;+EAE2E;IAC3E,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,uEAAuE;IACvE,UAAU,CAAC,EAAE;QACX,mBAAmB,CAAC,IAAI,mBAAmB,CAAC;QAC5C,gBAAgB,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;KAC5C,CAAC;CACH;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3F;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1F;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAOvC;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,EAAE,CAqE5E;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,WAAW,CA4cpF;AAED,UAAU,mBAAmB;IAC3B,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IACjD,cAAc,EAAE,OAAO,iBAAiB,CAAC;IACzC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,YAAY,CAAC;CACpC"}