@voicelayer/sdk 0.1.11 → 0.2.0

package/dist/{text-session-D1j8nQac.d.ts → text-session-BqMWaNsN.d.ts}

@@ -1,5 +1,248 @@
 import { JobContext, voice } from '@livekit/agents';
 import { z } from 'zod';
+import OpenAI from 'openai';
+
+type SessionState = 'initializing' | 'idle' | 'listening' | 'thinking' | 'speaking';
+declare const LK_AGENT_STATE_MAP: Readonly<Record<string, SessionState>>;
+declare const NON_BUSY_STATES: ReadonlySet<SessionState>;
+/** Normalize a raw LK state string to SessionState; unknown -> 'thinking' (fail-safe). */
+declare function normalizeState(raw: string): SessionState;
+interface UserInputEvent {
+    readonly transcript: string;
+    readonly isFinal: boolean;
+    readonly speakerId: string | null;
+}
+interface AgentTurnEvent {
+    readonly text: string;
+}
+interface DtmfEvent$1 {
+    readonly digit: string;
+    readonly code: number;
+    readonly participantId: string | null;
+}
+interface StateChangeEvent {
+    readonly oldState: SessionState | null;
+    readonly newState: SessionState | null;
+    readonly rawOldState: string | null;
+    readonly rawNewState: string | null;
+}
+interface UserStateEvent {
+    readonly speaking: boolean;
+    readonly at: number;
+}
+interface SessionErrorEvent {
+    readonly error: unknown;
+    readonly source: 'llm' | 'stt' | 'tts' | 'realtime' | 'unknown';
+    readonly fatalTransport: boolean;
+}
+interface MetricsEvent {
+    readonly metrics: unknown;
+}
+interface SessionEventMap {
+    user_input: UserInputEvent;
+    agent_turn: AgentTurnEvent;
+    dtmf: DtmfEvent$1;
+    state: StateChangeEvent;
+    user_state: UserStateEvent;
+    error: SessionErrorEvent;
+    metrics: MetricsEvent;
+    close: void;
+}
+type SessionEvent = keyof SessionEventMap;
+type Unsubscribe = () => void;
+type ChannelKind = 'voice' | 'text';
+interface SessionCapabilities {
+    readonly channel: ChannelKind;
+    readonly usingRealtime: boolean;
+    readonly hasStreamingTranscripts: boolean;
+    readonly canBargeIn: boolean;
+    readonly canReceiveDtmf: boolean;
+    readonly canPublishDtmf: boolean;
+    readonly canResolveSpeaker: boolean;
+}
+interface SayOptions$1 {
+    readonly allowInterruptions?: boolean;
+    readonly to?: string | readonly string[];
+}
+interface SpeechResult {
+    readonly interrupted: boolean;
+}
+interface EndCallOutcome {
+    readonly torn: 'room' | 'agent' | 'none';
+    readonly stranded: boolean;
+}
+interface SessionOutbound {
+    /** Speak verbatim. Under usingRealtime the LiveKit adapter routes to
+     *  generateReply(verbatim) NOT session.say (no TTS in S2S). Resolves after
+     *  playout (voice) or after the text turn is committed (text). */
+    say(text: string, opts?: SayOptions$1): Promise<SpeechResult>;
+    /** Queue a verbatim line and return once it is QUEUED, not played out (a host's `say` — burn-down G-5). `interrupt`
+     *  first cancels what the agent is saying. Realtime routes through the model, as say() does. */
+    enqueueSay(text: string, opts?: {
+        readonly interrupt?: boolean;
+        readonly allowInterruptions?: boolean;
+    }): Promise<void>;
+    /** Ask the LLM to produce a turn. */
+    generateReply(opts?: {
+        readonly instructions?: string;
+    }): Promise<void>;
+    /** Barge-in cancel (puppet interrupt mode). text => no-op. */
+    interrupt(): Promise<void>;
+    /** Publish outbound DTMF from the agent leg. Throws if !canPublishDtmf. */
+    sendDtmf(code: number, digit: string): Promise<void>;
+    /** Hang up via the SDK end-call controller (deletes room so the SIP leg drops). */
+    endCall(opts?: {
+        readonly reason?: string;
+        readonly trigger?: string;
+    }): Promise<EndCallOutcome>;
+}
+type TurnEvent = {
+    readonly kind: 'partial';
+    readonly text: string;
+    readonly speakerId: string | null;
+} | {
+    readonly kind: 'final';
+    readonly text: string;
+    readonly speakerId: string | null;
+    readonly at: Date;
+} | {
+    readonly kind: 'dtmf';
+    readonly digit: string;
+    readonly code: number;
+    readonly participantId: string | null;
+    readonly at: Date;
+} | {
+    readonly kind: 'hangup';
+} | {
+    readonly kind: 'timeout';
+};
+interface InboundOptions {
+    readonly idleTimeoutMs?: number;
+    readonly finalsOnly?: boolean;
+}
+interface SessionAdapter extends SessionOutbound {
+    readonly capabilities: SessionCapabilities;
+    on<E extends SessionEvent>(event: E, handler: (payload: SessionEventMap[E]) => void): Unsubscribe;
+    once<E extends SessionEvent>(event: E, handler: (payload: SessionEventMap[E]) => void): Unsubscribe;
+    /** Graph read side. ONE underlying subscription. Mutually exclusive with the
+     *  flat on('user_input') consumer (THROWS if both active). The iterator's
+     *  return()/finally MUST unsubscribe. */
+    inbound(opts?: InboundOptions): AsyncIterableIterator<TurnEvent>;
+    /** Begin the session (was session.start + waitForSessionActivity). The LiveKit
+     *  impl preserves the activity sequence VERBATIM so a provider/LLM init failure
+     *  REJECTS rather than producing a silently-dead answered call. */
+    start(opts?: {
+        readonly agent?: unknown;
+        readonly room?: unknown;
+    }): Promise<void>;
+    readonly state: SessionState;
+    /** Resolve when idle/listening, on timeout, or on close. Synchronous fast-path:
+     *  if already non-busy, resolves 'idle' in the same microtask. */
+    waitForIdle(timeoutMs: number): Promise<'idle' | 'timeout' | 'closed'>;
+    waitForClose(): Promise<void>;
+    /** Escape hatch for genuinely LK-coupled sites. undefined on the text adapter. */
+    readonly raw?: {
+        readonly job: JobContext;
+        readonly session: unknown;
+        readonly room: unknown;
+    };
+    dispose(): void;
+    /**
+     * Phase 0b-2: span-end teardown of the adapter's own engine-session listeners.
+     * Optional — the text adapter has none. Awaited from runCallSpan's finally
+     * AFTER close, so the post-close engine-death Error listener survives its
+     * window (PR #141). Distinct from `dispose()` (per-call fan-out cleanup).
+     */
+    [Symbol.asyncDispose]?(): Promise<void>;
+}
+interface EndCallControllerHandle {
+    hangUp(opts?: {
+        readonly trigger?: string;
+        readonly reason?: string;
+    }): Promise<void>;
+    armIdle(): void;
+    cancelIdle(): void;
+    noteEngineClosed(): void;
+}
+/**
+ * Fold the user's `speech.interruption` / `speech.endpointing` config into an
+ * LK turnHandling object. User-set fields are merged over whatever mode
+ * defaults (puppet/hostControlled) already put there — explicit agent config
+ * wins. No-op when the config is absent, so existing agents keep LK defaults.
+ * Lives here (not session-adapter-livekit) so agent.ts can import it without
+ * pulling @livekit/agents in at module load.
+ */
+declare function applySpeechTurnHandling(turnHandling: Record<string, unknown>, speech?: {
+    readonly interruption?: {
+        readonly enabled?: boolean;
+        readonly minWords?: number;
+        readonly minDuration?: number;
+    };
+    readonly endpointing?: {
+        readonly minDelay?: number;
+        readonly maxDelay?: number;
+    };
+}): Record<string, unknown>;
+interface SessionFactoryInput {
+    readonly usingRealtime: boolean;
+    readonly graphMode: boolean;
+    readonly puppetMode: boolean;
+    readonly hostControlled: boolean;
+    /** Connector-brain agent: disable preemptive generation (a multi-second remote
+     *  turn otherwise regenerates on the final transcript and drops the reply). */
+    readonly connectorAgentMode?: boolean;
+    readonly captureDtmf: boolean;
+    readonly pipeline?: {
+        readonly stt?: unknown;
+        readonly tts?: unknown;
+        readonly vad?: unknown;
+        readonly llm: unknown;
+    };
+    readonly turnHandling?: Record<string, unknown>;
+    /** Per-agent barge-in + endpointing tuning (AgentConfig `speech`). Merged
+     *  over mode defaults by applySpeechTurnHandling — explicit config wins. */
+    readonly speech?: {
+        readonly interruption?: {
+            readonly enabled?: boolean;
+            readonly minWords?: number;
+            readonly minDuration?: number;
+        };
+        readonly endpointing?: {
+            readonly minDelay?: number;
+            readonly maxDelay?: number;
+        };
+    };
+    readonly resolveSpeaker?: (speakerId: string | null) => {
+        readonly id: string | null;
+        readonly label: string;
+    };
+    readonly classifyEngineClosed?: (err: unknown) => boolean;
+    readonly endCallController?: EndCallControllerHandle;
+}
+type SessionFactory = (input: SessionFactoryInput) => Promise<SessionAdapter>;
+interface UserTurn {
+    readonly text: string;
+    readonly speakerLabel: string;
+    readonly speakerId: string | null;
+    readonly at: Date;
+}
+interface FakeSessionAdapter extends SessionAdapter {
+    emitUserInput(e: UserInputEvent): void;
+    emitAgentTurn(text: string): void;
+    emitDtmf(digit: string): void;
+    /** Drives 'state' with correct oldState/rawOldState AND runs the SAME
+     *  arm/cancel + idle-release as production. Unknown string => 'thinking'. */
+    setState(next: SessionState | string): void;
+    emitError(error: unknown, fatalTransport?: boolean): void;
+    emitClose(): void;
+    readonly spoken: ReadonlyArray<string>;
+    readonly generatedReplies: ReadonlyArray<string | undefined>;
+    readonly sentDtmf: ReadonlyArray<string>;
+    readonly endCalls: ReadonlyArray<{
+        readonly reason?: string;
+        readonly trigger?: string;
+    }>;
+}
 
 declare const brand: unique symbol;
 type Brand<T, B> = T & {
@@ -94,11 +337,11 @@ declare const ProcessSchemaDTO: z.ZodObject<{
         id: z.ZodString;
         text: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        id: string;
         text: string;
-    }, {
         id: string;
+    }, {
         text: string;
+        id: string;
     }>, "many">>;
     fields: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -206,7 +449,7 @@ declare const ProcessSchemaDTO: z.ZodObject<{
         description: string;
         input: Record<string, "string" | "number" | "boolean">;
         url: string;
-        method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
         auth: "none" | "connection";
         headers?: Record<string, string> | undefined;
         connectionRef?: string | undefined;
@@ -215,7 +458,7 @@ declare const ProcessSchemaDTO: z.ZodObject<{
         description: string;
         input: Record<string, "string" | "number" | "boolean">;
         url: string;
-        method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
         auth: "none" | "connection";
         headers?: Record<string, string> | undefined;
         connectionRef?: string | undefined;
@@ -290,7 +533,7 @@ declare const ProcessSchemaDTO: z.ZodObject<{
                 condition?: string | undefined;
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
-            type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+            type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
             id: string;
             config: Record<string, unknown>;
             out: {
@@ -300,7 +543,7 @@ declare const ProcessSchemaDTO: z.ZodObject<{
                 condition?: string | undefined;
             }[];
         }, {
-            type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+            type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
             id: string;
             config: Record<string, unknown>;
             out: {
@@ -321,20 +564,22 @@ declare const ProcessSchemaDTO: z.ZodObject<{
             acyclic: z.ZodBoolean;
             droppedEdges: z.ZodArray<z.ZodString, "many">;
             unsupportedNodes: z.ZodArray<z.ZodString, "many">;
+            labelOnlyEdges: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
             acyclic: boolean;
             droppedEdges: string[];
             unsupportedNodes: string[];
+            labelOnlyEdges?: string[] | undefined;
         }, {
             acyclic: boolean;
             droppedEdges: string[];
             unsupportedNodes: string[];
+            labelOnlyEdges?: string[] | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        v: 1;
         id: string;
         nodes: Record<string, {
-            type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+            type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
             id: string;
             config: Record<string, unknown>;
             out: {
@@ -344,6 +589,7 @@ declare const ProcessSchemaDTO: z.ZodObject<{
                 condition?: string | undefined;
             }[];
         }>;
+        v: 1;
         entry: string[];
         completionGate: {
             requiredFields: string[];
@@ -352,12 +598,12 @@ declare const ProcessSchemaDTO: z.ZodObject<{
             acyclic: boolean;
             droppedEdges: string[];
             unsupportedNodes: string[];
+            labelOnlyEdges?: string[] | undefined;
         } | undefined;
     }, {
-        v: 1;
         id: string;
         nodes: Record<string, {
-            type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+            type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
             id: string;
             config: Record<string, unknown>;
             out: {
@@ -367,6 +613,7 @@ declare const ProcessSchemaDTO: z.ZodObject<{
                 condition?: string | undefined;
             }[];
         }>;
+        v: 1;
         entry: string[];
         completionGate: {
             requiredFields: string[];
@@ -375,6 +622,7 @@ declare const ProcessSchemaDTO: z.ZodObject<{
             acyclic: boolean;
             droppedEdges: string[];
             unsupportedNodes: string[];
+            labelOnlyEdges?: string[] | undefined;
         } | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -417,8 +665,8 @@ declare const ProcessSchemaDTO: z.ZodObject<{
         } | undefined;
     } | undefined;
     prompts?: {
-        id: string;
         text: string;
+        id: string;
     }[] | undefined;
     triggers?: {
         then: string;
@@ -431,16 +679,15 @@ declare const ProcessSchemaDTO: z.ZodObject<{
         description: string;
         input: Record<string, "string" | "number" | "boolean">;
         url: string;
-        method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
         auth: "none" | "connection";
         headers?: Record<string, string> | undefined;
         connectionRef?: string | undefined;
     }[] | undefined;
     program?: {
-        v: 1;
         id: string;
         nodes: Record<string, {
-            type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+            type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
             id: string;
             config: Record<string, unknown>;
             out: {
@@ -450,6 +697,7 @@ declare const ProcessSchemaDTO: z.ZodObject<{
                 condition?: string | undefined;
             }[];
         }>;
+        v: 1;
         entry: string[];
         completionGate: {
             requiredFields: string[];
@@ -458,6 +706,7 @@ declare const ProcessSchemaDTO: z.ZodObject<{
             acyclic: boolean;
             droppedEdges: string[];
             unsupportedNodes: string[];
+            labelOnlyEdges?: string[] | undefined;
         } | undefined;
     } | undefined;
 }, {
@@ -500,8 +749,8 @@ declare const ProcessSchemaDTO: z.ZodObject<{
         } | undefined;
     } | undefined;
     prompts?: {
-        id: string;
         text: string;
+        id: string;
     }[] | undefined;
     triggers?: {
         then: string;
@@ -514,16 +763,15 @@ declare const ProcessSchemaDTO: z.ZodObject<{
         description: string;
         input: Record<string, "string" | "number" | "boolean">;
         url: string;
-        method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
         auth: "none" | "connection";
         headers?: Record<string, string> | undefined;
         connectionRef?: string | undefined;
     }[] | undefined;
     program?: {
-        v: 1;
         id: string;
         nodes: Record<string, {
-            type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+            type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
             id: string;
             config: Record<string, unknown>;
             out: {
@@ -533,6 +781,7 @@ declare const ProcessSchemaDTO: z.ZodObject<{
                 condition?: string | undefined;
             }[];
         }>;
+        v: 1;
         entry: string[];
         completionGate: {
             requiredFields: string[];
@@ -541,6 +790,7 @@ declare const ProcessSchemaDTO: z.ZodObject<{
             acyclic: boolean;
             droppedEdges: string[];
             unsupportedNodes: string[];
+            labelOnlyEdges?: string[] | undefined;
         } | undefined;
     } | undefined;
 }>;
@@ -575,11 +825,11 @@ declare const AgentDTO: z.ZodObject<{
             id: z.ZodString;
             text: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            id: string;
             text: string;
-        }, {
             id: string;
+        }, {
             text: string;
+            id: string;
         }>, "many">>;
         fields: z.ZodArray<z.ZodObject<{
             name: z.ZodString;
@@ -687,7 +937,7 @@ declare const AgentDTO: z.ZodObject<{
             description: string;
             input: Record<string, "string" | "number" | "boolean">;
             url: string;
-            method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
             auth: "none" | "connection";
             headers?: Record<string, string> | undefined;
             connectionRef?: string | undefined;
@@ -696,7 +946,7 @@ declare const AgentDTO: z.ZodObject<{
             description: string;
             input: Record<string, "string" | "number" | "boolean">;
             url: string;
-            method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
             auth: "none" | "connection";
             headers?: Record<string, string> | undefined;
             connectionRef?: string | undefined;
@@ -771,7 +1021,7 @@ declare const AgentDTO: z.ZodObject<{
                     condition?: string | undefined;
                 }>, "many">;
             }, "strip", z.ZodTypeAny, {
-                type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+                type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
                 id: string;
                 config: Record<string, unknown>;
                 out: {
@@ -781,7 +1031,7 @@ declare const AgentDTO: z.ZodObject<{
                     condition?: string | undefined;
                 }[];
             }, {
-                type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+                type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
                 id: string;
                 config: Record<string, unknown>;
                 out: {
@@ -802,20 +1052,22 @@ declare const AgentDTO: z.ZodObject<{
                 acyclic: z.ZodBoolean;
                 droppedEdges: z.ZodArray<z.ZodString, "many">;
                 unsupportedNodes: z.ZodArray<z.ZodString, "many">;
+                labelOnlyEdges: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             }, "strip", z.ZodTypeAny, {
                 acyclic: boolean;
                 droppedEdges: string[];
                 unsupportedNodes: string[];
+                labelOnlyEdges?: string[] | undefined;
             }, {
                 acyclic: boolean;
                 droppedEdges: string[];
                 unsupportedNodes: string[];
+                labelOnlyEdges?: string[] | undefined;
             }>>;
         }, "strip", z.ZodTypeAny, {
-            v: 1;
             id: string;
             nodes: Record<string, {
-                type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+                type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
                 id: string;
                 config: Record<string, unknown>;
                 out: {
@@ -825,6 +1077,7 @@ declare const AgentDTO: z.ZodObject<{
                     condition?: string | undefined;
                 }[];
             }>;
+            v: 1;
             entry: string[];
             completionGate: {
                 requiredFields: string[];
@@ -833,12 +1086,12 @@ declare const AgentDTO: z.ZodObject<{
                 acyclic: boolean;
                 droppedEdges: string[];
                 unsupportedNodes: string[];
+                labelOnlyEdges?: string[] | undefined;
             } | undefined;
         }, {
-            v: 1;
             id: string;
             nodes: Record<string, {
-                type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+                type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
                 id: string;
                 config: Record<string, unknown>;
                 out: {
@@ -848,6 +1101,7 @@ declare const AgentDTO: z.ZodObject<{
                     condition?: string | undefined;
                 }[];
             }>;
+            v: 1;
             entry: string[];
             completionGate: {
                 requiredFields: string[];
@@ -856,6 +1110,7 @@ declare const AgentDTO: z.ZodObject<{
                 acyclic: boolean;
                 droppedEdges: string[];
                 unsupportedNodes: string[];
+                labelOnlyEdges?: string[] | undefined;
             } | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
@@ -898,8 +1153,8 @@ declare const AgentDTO: z.ZodObject<{
             } | undefined;
         } | undefined;
         prompts?: {
-            id: string;
             text: string;
+            id: string;
         }[] | undefined;
         triggers?: {
             then: string;
@@ -912,16 +1167,15 @@ declare const AgentDTO: z.ZodObject<{
             description: string;
             input: Record<string, "string" | "number" | "boolean">;
             url: string;
-            method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
             auth: "none" | "connection";
             headers?: Record<string, string> | undefined;
             connectionRef?: string | undefined;
         }[] | undefined;
         program?: {
-            v: 1;
             id: string;
             nodes: Record<string, {
-                type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+                type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
                 id: string;
                 config: Record<string, unknown>;
                 out: {
@@ -931,6 +1185,7 @@ declare const AgentDTO: z.ZodObject<{
                     condition?: string | undefined;
                 }[];
             }>;
+            v: 1;
             entry: string[];
             completionGate: {
                 requiredFields: string[];
@@ -939,6 +1194,7 @@ declare const AgentDTO: z.ZodObject<{
                 acyclic: boolean;
                 droppedEdges: string[];
                 unsupportedNodes: string[];
+                labelOnlyEdges?: string[] | undefined;
             } | undefined;
         } | undefined;
     }, {
@@ -981,8 +1237,8 @@ declare const AgentDTO: z.ZodObject<{
             } | undefined;
         } | undefined;
         prompts?: {
-            id: string;
             text: string;
+            id: string;
         }[] | undefined;
         triggers?: {
             then: string;
@@ -995,16 +1251,15 @@ declare const AgentDTO: z.ZodObject<{
             description: string;
             input: Record<string, "string" | "number" | "boolean">;
             url: string;
-            method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
             auth: "none" | "connection";
             headers?: Record<string, string> | undefined;
             connectionRef?: string | undefined;
         }[] | undefined;
         program?: {
-            v: 1;
             id: string;
             nodes: Record<string, {
-                type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+                type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
                 id: string;
                 config: Record<string, unknown>;
                 out: {
@@ -1014,6 +1269,7 @@ declare const AgentDTO: z.ZodObject<{
                     condition?: string | undefined;
                 }[];
             }>;
+            v: 1;
             entry: string[];
             completionGate: {
                 requiredFields: string[];
@@ -1022,9 +1278,11 @@ declare const AgentDTO: z.ZodObject<{
                 acyclic: boolean;
                 droppedEdges: string[];
                 unsupportedNodes: string[];
+                labelOnlyEdges?: string[] | undefined;
             } | undefined;
         } | undefined;
     }>>>;
+    textRunnable: z.ZodOptional<z.ZodBoolean>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -1085,8 +1343,8 @@ declare const AgentDTO: z.ZodObject<{
             } | undefined;
         } | undefined;
         prompts?: {
-            id: string;
             text: string;
+            id: string;
         }[] | undefined;
         triggers?: {
             then: string;
@@ -1099,16 +1357,15 @@ declare const AgentDTO: z.ZodObject<{
             description: string;
             input: Record<string, "string" | "number" | "boolean">;
             url: string;
-            method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
             auth: "none" | "connection";
             headers?: Record<string, string> | undefined;
             connectionRef?: string | undefined;
         }[] | undefined;
         program?: {
-            v: 1;
             id: string;
             nodes: Record<string, {
-                type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+                type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
                 id: string;
                 config: Record<string, unknown>;
                 out: {
@@ -1118,6 +1375,7 @@ declare const AgentDTO: z.ZodObject<{
                     condition?: string | undefined;
                 }[];
             }>;
+            v: 1;
             entry: string[];
             completionGate: {
                 requiredFields: string[];
@@ -1126,9 +1384,11 @@ declare const AgentDTO: z.ZodObject<{
                 acyclic: boolean;
                 droppedEdges: string[];
                 unsupportedNodes: string[];
+                labelOnlyEdges?: string[] | undefined;
             } | undefined;
         } | undefined;
     } | null | undefined;
+    textRunnable?: boolean | undefined;
 }, {
     status: "online" | "offline" | "degraded";
     id: string;
@@ -1187,8 +1447,8 @@ declare const AgentDTO: z.ZodObject<{
             } | undefined;
         } | undefined;
         prompts?: {
-            id: string;
             text: string;
+            id: string;
         }[] | undefined;
         triggers?: {
             then: string;
@@ -1201,16 +1461,15 @@ declare const AgentDTO: z.ZodObject<{
             description: string;
             input: Record<string, "string" | "number" | "boolean">;
             url: string;
-            method: "GET" | "POST" | "PATCH" | "PUT" | "DELETE";
+            method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
             auth: "none" | "connection";
             headers?: Record<string, string> | undefined;
             connectionRef?: string | undefined;
         }[] | undefined;
         program?: {
-            v: 1;
             id: string;
             nodes: Record<string, {
-                type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+                type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
                 id: string;
                 config: Record<string, unknown>;
                 out: {
@@ -1220,6 +1479,7 @@ declare const AgentDTO: z.ZodObject<{
                     condition?: string | undefined;
                 }[];
             }>;
+            v: 1;
             entry: string[];
             completionGate: {
                 requiredFields: string[];
@@ -1228,9 +1488,11 @@ declare const AgentDTO: z.ZodObject<{
                 acyclic: boolean;
                 droppedEdges: string[];
                 unsupportedNodes: string[];
+                labelOnlyEdges?: string[] | undefined;
             } | undefined;
         } | undefined;
     } | null | undefined;
+    textRunnable?: boolean | undefined;
 }>;
 type AgentDTO = z.infer<typeof AgentDTO>;
 
@@ -1259,7 +1521,7 @@ declare const FlowProgram: z.ZodObject<{
             condition?: string | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+        type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
         id: string;
         config: Record<string, unknown>;
         out: {
@@ -1269,7 +1531,7 @@ declare const FlowProgram: z.ZodObject<{
             condition?: string | undefined;
         }[];
     }, {
-        type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+        type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
         id: string;
         config: Record<string, unknown>;
         out: {
@@ -1290,20 +1552,22 @@ declare const FlowProgram: z.ZodObject<{
         acyclic: z.ZodBoolean;
         droppedEdges: z.ZodArray<z.ZodString, "many">;
         unsupportedNodes: z.ZodArray<z.ZodString, "many">;
+        labelOnlyEdges: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         acyclic: boolean;
         droppedEdges: string[];
         unsupportedNodes: string[];
+        labelOnlyEdges?: string[] | undefined;
     }, {
         acyclic: boolean;
         droppedEdges: string[];
         unsupportedNodes: string[];
+        labelOnlyEdges?: string[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    v: 1;
     id: string;
     nodes: Record<string, {
-        type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+        type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
         id: string;
         config: Record<string, unknown>;
         out: {
@@ -1313,6 +1577,7 @@ declare const FlowProgram: z.ZodObject<{
             condition?: string | undefined;
         }[];
     }>;
+    v: 1;
     entry: string[];
     completionGate: {
         requiredFields: string[];
@@ -1321,12 +1586,12 @@ declare const FlowProgram: z.ZodObject<{
         acyclic: boolean;
         droppedEdges: string[];
         unsupportedNodes: string[];
+        labelOnlyEdges?: string[] | undefined;
     } | undefined;
 }, {
-    v: 1;
     id: string;
     nodes: Record<string, {
-        type: "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "llm" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
+        type: "llm" | "code" | "start" | "say" | "ask" | "confirm" | "tool" | "decision" | "handoff" | "end" | "trigger" | "gate" | "playbook" | "menu" | "set" | "subflow" | "rag" | "memory" | "speech" | "classify" | "router" | "note";
         id: string;
         config: Record<string, unknown>;
         out: {
@@ -1336,6 +1601,7 @@ declare const FlowProgram: z.ZodObject<{
             condition?: string | undefined;
         }[];
     }>;
+    v: 1;
     entry: string[];
     completionGate: {
         requiredFields: string[];
@@ -1344,231 +1610,11 @@ declare const FlowProgram: z.ZodObject<{
         acyclic: boolean;
         droppedEdges: string[];
         unsupportedNodes: string[];
+        labelOnlyEdges?: string[] | undefined;
     } | undefined;
 }>;
 type FlowProgram = z.infer<typeof FlowProgram>;
 
-type SessionState = 'initializing' | 'idle' | 'listening' | 'thinking' | 'speaking';
-declare const LK_AGENT_STATE_MAP: Readonly<Record<string, SessionState>>;
-declare const NON_BUSY_STATES: ReadonlySet<SessionState>;
-/** Normalize a raw LK state string to SessionState; unknown -> 'thinking' (fail-safe). */
-declare function normalizeState(raw: string): SessionState;
-interface UserInputEvent {
-    readonly transcript: string;
-    readonly isFinal: boolean;
-    readonly speakerId: string | null;
-}
-interface AgentTurnEvent {
-    readonly text: string;
-}
-interface DtmfEvent$1 {
-    readonly digit: string;
-    readonly code: number;
-    readonly participantId: string | null;
-}
-interface StateChangeEvent {
-    readonly oldState: SessionState | null;
-    readonly newState: SessionState | null;
-    readonly rawOldState: string | null;
-    readonly rawNewState: string | null;
-}
-interface SessionErrorEvent {
-    readonly error: unknown;
-    readonly source: 'llm' | 'stt' | 'tts' | 'realtime' | 'unknown';
-    readonly fatalTransport: boolean;
-}
-interface MetricsEvent {
-    readonly metrics: unknown;
-}
-interface SessionEventMap {
-    user_input: UserInputEvent;
-    agent_turn: AgentTurnEvent;
-    dtmf: DtmfEvent$1;
-    state: StateChangeEvent;
-    error: SessionErrorEvent;
-    metrics: MetricsEvent;
-    close: void;
-}
-type SessionEvent = keyof SessionEventMap;
-type Unsubscribe = () => void;
-type ChannelKind = 'voice' | 'text';
-interface SessionCapabilities {
-    readonly channel: ChannelKind;
-    readonly usingRealtime: boolean;
-    readonly hasStreamingTranscripts: boolean;
-    readonly canBargeIn: boolean;
-    readonly canReceiveDtmf: boolean;
-    readonly canPublishDtmf: boolean;
-    readonly canResolveSpeaker: boolean;
-}
-interface SayOptions$1 {
-    readonly allowInterruptions?: boolean;
-    readonly to?: string | readonly string[];
-}
-interface SpeechResult {
-    readonly interrupted: boolean;
-}
-interface EndCallOutcome {
-    readonly torn: 'room' | 'agent' | 'none';
-    readonly stranded: boolean;
-}
-interface SessionOutbound {
-    /** Speak verbatim. Under usingRealtime the LiveKit adapter routes to
-     *  generateReply(verbatim) NOT session.say (no TTS in S2S). Resolves after
-     *  playout (voice) or after the text turn is committed (text). */
-    say(text: string, opts?: SayOptions$1): Promise<SpeechResult>;
-    /** Ask the LLM to produce a turn. */
-    generateReply(opts?: {
-        readonly instructions?: string;
-    }): Promise<void>;
-    /** Barge-in cancel (puppet interrupt mode). text => no-op. */
-    interrupt(): Promise<void>;
-    /** Publish outbound DTMF from the agent leg. Throws if !canPublishDtmf. */
-    sendDtmf(code: number, digit: string): Promise<void>;
-    /** Hang up via the SDK end-call controller (deletes room so the SIP leg drops). */
-    endCall(opts?: {
-        readonly reason?: string;
-        readonly trigger?: string;
-    }): Promise<EndCallOutcome>;
-}
-type TurnEvent = {
-    readonly kind: 'partial';
-    readonly text: string;
-    readonly speakerId: string | null;
-} | {
-    readonly kind: 'final';
-    readonly text: string;
-    readonly speakerId: string | null;
-    readonly at: Date;
-} | {
-    readonly kind: 'dtmf';
-    readonly digit: string;
-    readonly code: number;
-    readonly participantId: string | null;
-    readonly at: Date;
-} | {
-    readonly kind: 'hangup';
-} | {
-    readonly kind: 'timeout';
-};
-interface InboundOptions {
-    readonly idleTimeoutMs?: number;
-    readonly finalsOnly?: boolean;
-}
-interface SessionAdapter extends SessionOutbound {
-    readonly capabilities: SessionCapabilities;
-    on<E extends SessionEvent>(event: E, handler: (payload: SessionEventMap[E]) => void): Unsubscribe;
-    once<E extends SessionEvent>(event: E, handler: (payload: SessionEventMap[E]) => void): Unsubscribe;
-    /** Graph read side. ONE underlying subscription. Mutually exclusive with the
-     *  flat on('user_input') consumer (THROWS if both active). The iterator's
-     *  return()/finally MUST unsubscribe. */
-    inbound(opts?: InboundOptions): AsyncIterableIterator<TurnEvent>;
-    /** Begin the session (was session.start + waitForSessionActivity). The LiveKit
-     *  impl preserves the activity sequence VERBATIM so a provider/LLM init failure
-     *  REJECTS rather than producing a silently-dead answered call. */
-    start(opts?: {
-        readonly agent?: unknown;
-        readonly room?: unknown;
-    }): Promise<void>;
-    readonly state: SessionState;
-    /** Resolve when idle/listening, on timeout, or on close. Synchronous fast-path:
-     *  if already non-busy, resolves 'idle' in the same microtask. */
-    waitForIdle(timeoutMs: number): Promise<'idle' | 'timeout' | 'closed'>;
-    waitForClose(): Promise<void>;
-    /** Escape hatch for genuinely LK-coupled sites. undefined on the text adapter. */
-    readonly raw?: {
-        readonly job: JobContext;
-        readonly session: unknown;
-        readonly room: unknown;
-    };
-    dispose(): void;
-}
-interface EndCallControllerHandle {
-    hangUp(opts?: {
-        readonly trigger?: string;
-        readonly reason?: string;
-    }): Promise<void>;
-    armIdle(): void;
-    cancelIdle(): void;
-    noteEngineClosed(): void;
-}
-/**
- * Fold the user's `speech.interruption` / `speech.endpointing` config into an
- * LK turnHandling object. User-set fields are merged over whatever mode
- * defaults (puppet/hostControlled) already put there — explicit agent config
- * wins. No-op when the config is absent, so existing agents keep LK defaults.
- * Lives here (not session-adapter-livekit) so agent.ts can import it without
- * pulling @livekit/agents in at module load.
- */
-declare function applySpeechTurnHandling(turnHandling: Record<string, unknown>, speech?: {
-    readonly interruption?: {
-        readonly enabled?: boolean;
-        readonly minWords?: number;
-        readonly minDuration?: number;
-    };
-    readonly endpointing?: {
-        readonly minDelay?: number;
-        readonly maxDelay?: number;
-    };
-}): Record<string, unknown>;
-interface SessionFactoryInput {
-    readonly usingRealtime: boolean;
-    readonly graphMode: boolean;
-    readonly puppetMode: boolean;
-    readonly hostControlled: boolean;
-    readonly captureDtmf: boolean;
-    readonly pipeline?: {
-        readonly stt?: unknown;
-        readonly tts?: unknown;
-        readonly vad?: unknown;
-        readonly llm: unknown;
-    };
-    readonly turnHandling?: Record<string, unknown>;
-    /** Per-agent barge-in + endpointing tuning (AgentConfig `speech`). Merged
-     *  over mode defaults by applySpeechTurnHandling — explicit config wins. */
-    readonly speech?: {
-        readonly interruption?: {
-            readonly enabled?: boolean;
-            readonly minWords?: number;
-            readonly minDuration?: number;
-        };
-        readonly endpointing?: {
-            readonly minDelay?: number;
-            readonly maxDelay?: number;
-        };
-    };
-    readonly resolveSpeaker?: (speakerId: string | null) => {
-        readonly id: string | null;
-        readonly label: string;
-    };
-    readonly classifyEngineClosed?: (err: unknown) => boolean;
-    readonly endCallController?: EndCallControllerHandle;
-}
-type SessionFactory = (input: SessionFactoryInput) => Promise<SessionAdapter>;
-interface UserTurn {
-    readonly text: string;
-    readonly speakerLabel: string;
-    readonly speakerId: string | null;
-    readonly at: Date;
-}
-interface FakeSessionAdapter extends SessionAdapter {
-    emitUserInput(e: UserInputEvent): void;
-    emitAgentTurn(text: string): void;
-    emitDtmf(digit: string): void;
-    /** Drives 'state' with correct oldState/rawOldState AND runs the SAME
-     *  arm/cancel + idle-release as production. Unknown string => 'thinking'. */
-    setState(next: SessionState | string): void;
-    emitError(error: unknown, fatalTransport?: boolean): void;
-    emitClose(): void;
-    readonly spoken: ReadonlyArray<string>;
-    readonly generatedReplies: ReadonlyArray<string | undefined>;
-    readonly sentDtmf: ReadonlyArray<string>;
-    readonly endCalls: ReadonlyArray<{
-        readonly reason?: string;
-        readonly trigger?: string;
-    }>;
-}
-
 interface ProcessSchema {
     readonly id: string;
     readonly fields: readonly FieldSpec[];
@@ -1931,6 +1977,13 @@ type FlowOutcome = {
     readonly message: string;
 };
 
+/**
+ * Run `fn` with `client` as the internal helpers' OpenAI client. The scope follows the async work `fn` starts (an
+ * interpreter loop started inside keeps it for its whole life), so a conversation started inside it uses `client`
+ * for every extraction, condition judge and embedding it makes.
+ */
+declare function runWithOpenAIScope<T>(client: OpenAI, fn: () => T): T;
+
 /** One graph-lifecycle event, for the builder's dry-run trace overlay. */
 interface GraphTraceEvent {
     readonly kind: string;
@@ -1953,6 +2006,9 @@ interface RunTextSessionOptions {
     /** Tap the graph lifecycle (node.entered / edge.traversed / notes) — the
      *  same stream the live timeline records, surfaced for the dry-run trace. */
     readonly onTrace?: (event: GraphTraceEvent) => void;
+    /** Fires when the interpreter finishes a turn and blocks for the next user
+     *  message — the per-turn boundary used by the live driver below. */
+    readonly onAwaitInput?: () => void;
 }
 interface TextSession {
     /** Feed an inbound user message (a final turn). */
@@ -1992,5 +2048,38 @@ interface TextTranscriptResult {
  *  flow consumes them in order as it reaches ask points. Stateless — the request/
  *  response shape the text playground route uses. */
 declare function runTextTranscript(opts: RunTextTranscriptOptions): Promise<TextTranscriptResult>;
+/** One live turn's result: the agent text emitted for this turn, whether the flow
+ *  has ended, and (when ended) the final outcome. */
+interface LiveTurnResult {
+    readonly replies: readonly string[];
+    readonly done: boolean;
+    readonly outcome?: FlowOutcome;
+}
+/** A live, turn-by-turn flow conversation: keeps ONE interpreter session alive
+ *  (graph cursor + collected slots preserved between turns), so each `turn()`
+ *  advances the real flow one user message at a time — the incremental complement
+ *  to the stateless `runTextTranscript`. Backs a chat UI / an HTTP turn endpoint. */
+interface LiveTextConversation {
+    /** Collect the agent's opening turn (greeting / first prompt) before any user
+     *  input. Call once, right after construction. */
+    start(): Promise<LiveTurnResult>;
+    /** Feed one user message; resolves with the agent's replies for THIS turn once
+     *  the interpreter parks for the next input (or the flow ends). */
+    turn(text: string): Promise<LiveTurnResult>;
+    /** End the conversation (hangup); resolves with the final outcome. */
+    end(): Promise<FlowOutcome>;
+}
+type RunLiveTextOptions = Omit<RunTextSessionOptions, 'onAgentText' | 'onAwaitInput'> & {
+    /** Optional extra sink for agent text (the driver always buffers per turn). */
+    readonly onAgentText?: (text: string) => void | Promise<void>;
+    /** The flow's compiled schema. When `processRt` is not supplied, the runtime is
+     *  built from this (else derived from the program) — required for ask nodes to
+     *  capture, exactly as `runTextTranscript` does. */
+    readonly schema?: ProcessSchemaDTO;
+};
+/** Drive a flow live, one user turn at a time, preserving interpreter state
+ *  between turns. Uses the `onAwaitInput` boundary: a turn is "done" once the
+ *  interpreter blocks for the next message, or the flow ends. */
+declare function runLiveTextConversation(opts: RunLiveTextOptions): LiveTextConversation;
 
-export { type UserTurn as $, AgentDTO as A, type SessionEvent as B, type CallInfo as C, type DtmfEvent as D, type EndCallControllerHandle as E, type FakeSessionAdapter as F, type SessionEventMap as G, type SessionFactory as H, type InboundOptions as I, type SessionFactoryInput as J, type SessionOutbound as K, LK_AGENT_STATE_MAP as L, type MemoryHandle as M, NON_BUSY_STATES as N, type SessionState as O, ProcessSchemaDTO as P, type SpeechResult as Q, type RespondOptions as R, type SayOptions as S, type SpeechTarget as T, type StateChangeEvent as U, type TextSession as V, type TextTranscriptResult as W, type TtsVoiceConfig as X, type TurnEvent as Y, type Unsubscribe as Z, type UserInputEvent as _, AgentStatus as a, applySpeechTurnHandling as a0, dtmfCodeToDigit as a1, dtmfDigitToCode as a2, duck as a3, mute as a4, normalizeState as a5, passthrough as a6, runTextSession as a7, runTextTranscript as a8, transform as a9, type GraphTraceEvent as aa, AgentEnvironment as b, type AgentContext as c, type Participant as d, type AgentTurnEvent as e, type AudioProfile as f, type AudioSurface as g, type ChannelKind as h, type DtmfHandler as i, type EndCallOutcome as j, type FloorControlConfig as k, type MetricsEvent as l, ParticipantId as m, type ParticipantKind as n, type ParticipantSet as o, type ProcessSnapshot as p, type Room as q, type RouteEntry as r, type RoutingRule as s, type RoutingSnapshot as t, type RunTextSessionOptions as u, type RunTextTranscriptOptions as v, type SendDtmfOptions as w, type SessionAdapter as x, type SessionCapabilities as y, type SessionErrorEvent as z };
+export { type UserStateEvent as $, AgentDTO as A, type SessionEvent as B, type CallInfo as C, type DtmfEvent as D, type EndCallControllerHandle as E, type FakeSessionAdapter as F, type SessionEventMap as G, type SessionFactory as H, type InboundOptions as I, type SessionFactoryInput as J, type SessionOutbound as K, LK_AGENT_STATE_MAP as L, type MemoryHandle as M, NON_BUSY_STATES as N, type SessionState as O, type Participant as P, type SpeechResult as Q, type RespondOptions as R, type SayOptions as S, type SpeechTarget as T, type StateChangeEvent as U, type TextSession as V, type TextTranscriptResult as W, type TtsVoiceConfig as X, type TurnEvent as Y, type Unsubscribe as Z, type UserInputEvent as _, AgentStatus as a, type UserTurn as a0, applySpeechTurnHandling as a1, dtmfCodeToDigit as a2, dtmfDigitToCode as a3, duck as a4, mute as a5, normalizeState as a6, passthrough as a7, runTextSession as a8, runTextTranscript as a9, transform as aa, type GraphTraceEvent as ab, type LiveTextConversation as ac, type LiveTurnResult as ad, type RunLiveTextOptions as ae, runLiveTextConversation as af, runWithOpenAIScope as ag, AgentEnvironment as b, type AgentContext as c, ProcessSchemaDTO as d, type AgentTurnEvent as e, type AudioProfile as f, type AudioSurface as g, type ChannelKind as h, type DtmfHandler as i, type EndCallOutcome as j, type FloorControlConfig as k, type MetricsEvent as l, ParticipantId as m, type ParticipantKind as n, type ParticipantSet as o, type ProcessSnapshot as p, type Room as q, type RouteEntry as r, type RoutingRule as s, type RoutingSnapshot as t, type RunTextSessionOptions as u, type RunTextTranscriptOptions as v, type SendDtmfOptions as w, type SessionAdapter as x, type SessionCapabilities as y, type SessionErrorEvent as z };