@kuralle-syrinx/server-workers 4.4.0 → 4.5.0

package/dist/kuralle-realtime-agent.d.ts

@@ -0,0 +1,16 @@
+import type { VectorizeIndex } from "@cloudflare/workers-types";
+import type { Reasoner } from "@kuralle-syrinx/core";
+export interface KuralleRealtimeEnv {
+    readonly OPENAI_API_KEY?: string;
+    readonly OPENAI_MODEL?: string;
+    readonly VECTORIZE: VectorizeIndex;
+}
+export interface CreateRealtimeKuralleReasonerOptions {
+    readonly sessionId: string;
+    readonly userId?: string;
+}
+export declare function createRealtimeKuralleReasoner(env: KuralleRealtimeEnv, opts: CreateRealtimeKuralleReasonerOptions): Promise<Reasoner>;
+export type KuralleCascadeEnv = KuralleRealtimeEnv;
+export type CreateCascadeKuralleReasonerOptions = CreateRealtimeKuralleReasonerOptions;
+export declare const createCascadeKuralleReasoner: typeof createRealtimeKuralleReasoner;
+//# sourceMappingURL=kuralle-realtime-agent.d.ts.map

package/dist/kuralle-realtime-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kuralle-realtime-agent.d.ts","sourceRoot":"","sources":["../src/kuralle-realtime-agent.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAiHrD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;CACpC;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AA+CD,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,kBAAkB,EACvB,IAAI,EAAE,oCAAoC,GACzC,OAAO,CAAC,QAAQ,CAAC,CAMnB;AAED,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AACnD,MAAM,MAAM,mCAAmC,GAAG,oCAAoC,CAAC;AACvF,eAAO,MAAM,4BAA4B,sCAAgC,CAAC"}

package/dist/kuralle-realtime-agent.js

@@ -0,0 +1,156 @@
+// SPDX-License-Identifier: MIT
+import { createOpenAI } from "@ai-sdk/openai";
+import { defineAgent, defineFlow, defineTool, buildToolSet, createRuntime, MemoryStore, reply, } from "@kuralle-agents/core";
+import { AiSdkEmbedder, VectorRetriever, } from "@kuralle-agents/rag";
+import { defineSkill } from "@kuralle-agents/skills";
+import { CloudflareVectorizeStore } from "@kuralle-agents/vectorize-store";
+import { fromKuralleRuntime } from "@kuralle-syrinx/kuralle";
+import { z } from "zod";
+const DEFAULT_MODEL = "gpt-4.1-mini";
+const INDEX_NAME = "kuralle-university-kb";
+const SCHOLARSHIP_SKILL = defineSkill({
+    name: "scholarship-guidance",
+    description: "Guide students through scholarship eligibility and application steps",
+    body: `# Scholarship Guidance
+
+1. Ask whether the student is seeking merit-based aid, need-based aid, or both.
+2. For merit: cite the Dean's Merit Scholarship (GPA ≥ 3.5).
+3. For need: cite the Need-Based Grant (FAFSA required).
+4. Always mention the application deadline of February 15.`,
+    allowedTools: [],
+});
+let bookingCounter = 0;
+const createBookingTool = defineTool({
+    name: "create_booking",
+    description: "Finalize the advisor appointment booking. Only call after the user has explicitly confirmed the details.",
+    input: z.object({}),
+    execute: async () => {
+        bookingCounter += 1;
+        return { bookingRef: `ADV-${bookingCounter}` };
+    },
+});
+const recordBookingDetails = defineTool({
+    name: "record_booking_details",
+    description: "Record the student's name, program, and preferred date once all three are known.",
+    input: z.object({ name: z.string(), program: z.string(), preferredDate: z.string() }),
+    execute: async (details) => details,
+});
+const requestTranscriptTool = defineTool({
+    name: "request_transcript",
+    description: "Submit an official transcript request for the given studentId.",
+    input: z.object({ studentId: z.string() }),
+    execute: async ({ studentId }) => ({ requestRef: `TR-${studentId}` }),
+});
+const replyBooked = reply({
+    id: "reply-booked",
+    grounding: { knowledge: { autoRetrieve: false } },
+    instructions: ({ state }) => `The advisor appointment is booked. Confirm it to the user and include this exact reference verbatim: ${String(state["bookingRef"] ?? "")}.`,
+    next: () => ({ end: "booked" }),
+});
+const confirmBooking = reply({
+    id: "confirm-booking",
+    grounding: { knowledge: { autoRetrieve: false } },
+    instructions: ({ state }) => `Summarize the advisor appointment — name: ${String(state["name"] ?? "")}, program: ${String(state["program"] ?? "")}, date: ${String(state["preferredDate"] ?? "")} — and ask the user to confirm. ONLY when the user clearly confirms, call create_booking to finalize. If they want changes, ask for the corrected detail.`,
+    tools: buildToolSet({ create_booking: createBookingTool }),
+    next: (turn) => {
+        const r = turn.toolResults.find((t) => t.name === "create_booking");
+        if (r?.result && typeof r.result === "object")
+            return { goto: replyBooked, data: r.result };
+        return "stay";
+    },
+});
+const collectBooking = reply({
+    id: "collect-booking",
+    grounding: { knowledge: { autoRetrieve: false } },
+    instructions: "Help the user book an advisor appointment. If you don't yet have all three of name, program, and preferred date, ask for the missing ones. Once you have all three, call record_booking_details.",
+    tools: buildToolSet({ record_booking_details: recordBookingDetails }),
+    next: (turn) => {
+        const r = turn.toolResults.find((t) => t.name === "record_booking_details");
+        if (r?.result && typeof r.result === "object")
+            return { goto: confirmBooking, data: r.result };
+        return "stay";
+    },
+});
+const bookingFlow = defineFlow({
+    name: "book-advisor-appointment",
+    description: "Book an appointment with an academic advisor",
+    start: collectBooking,
+    nodes: [collectBooking, confirmBooking, replyBooked],
+});
+const replyTranscript = reply({
+    id: "reply-transcript",
+    grounding: { knowledge: { autoRetrieve: false } },
+    instructions: ({ state }) => `Confirm the transcript request was submitted. Include this exact request reference verbatim: ${String(state["requestRef"] ?? "")}.`,
+    next: () => ({ end: "requested" }),
+});
+const collectTranscript = reply({
+    id: "collect-transcript",
+    grounding: { knowledge: { autoRetrieve: false } },
+    instructions: "Help the user request an official transcript. If you don't have their student ID, ask for it. Once you have it, call request_transcript with that studentId.",
+    tools: buildToolSet({ request_transcript: requestTranscriptTool }),
+    next: (turn) => {
+        const r = turn.toolResults.find((t) => t.name === "request_transcript");
+        if (r?.result && typeof r.result === "object")
+            return { goto: replyTranscript, data: r.result };
+        return "stay";
+    },
+});
+const transcriptFlow = defineFlow({
+    name: "request-transcript",
+    description: "Request an official academic transcript",
+    start: collectTranscript,
+    nodes: [collectTranscript, replyTranscript],
+});
+let runtimePromise;
+function vectorStore(env) {
+    return new CloudflareVectorizeStore({ binding: env.VECTORIZE });
+}
+async function createUniversityRuntime(env) {
+    const apiKey = requireKey(env.OPENAI_API_KEY, "OPENAI_API_KEY");
+    const openai = createOpenAI({ apiKey });
+    const model = openai(env.OPENAI_MODEL?.trim() || DEFAULT_MODEL);
+    const embedder = new AiSdkEmbedder({ model: openai.embedding("text-embedding-3-small") });
+    const retriever = new VectorRetriever({
+        vectorStore: vectorStore(env),
+        embedder,
+        indexName: INDEX_NAME,
+        topK: 3,
+    });
+    const agent = defineAgent({
+        id: "university",
+        model,
+        instructions: "You are a friendly university support assistant. Answer admissions, program, tuition, and scholarship questions clearly and concisely for voice.",
+        knowledge: { autoRetrieve: true },
+        skills: [SCHOLARSHIP_SKILL],
+        flows: [bookingFlow, transcriptFlow],
+        tools: {
+            create_booking: createBookingTool,
+            request_transcript: requestTranscriptTool,
+        },
+        memory: { workingMemory: { autoLoad: [{ scope: "user", key: "USER" }] } },
+    });
+    return createRuntime({
+        agents: [agent],
+        defaultAgentId: "university",
+        sessionStore: new MemoryStore(),
+        knowledge: { retriever, embedder },
+    });
+}
+function getRuntime(env) {
+    return (runtimePromise ??= createUniversityRuntime(env));
+}
+export async function createRealtimeKuralleReasoner(env, opts) {
+    const runtime = await getRuntime(env);
+    return fromKuralleRuntime(runtime, {
+        sessionId: opts.sessionId,
+        userId: opts.userId ?? "voice",
+    });
+}
+export const createCascadeKuralleReasoner = createRealtimeKuralleReasoner;
+function requireKey(value, name) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        throw new Error(`${name} is required to start a realtime voice session`);
+    return trimmed;
+}
+//# sourceMappingURL=kuralle-realtime-agent.js.map

package/dist/kuralle-realtime-agent.js.map

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

package/dist/live-realtime-session.d.ts

@@ -0,0 +1,19 @@
+import type { Reasoner } from "@kuralle-syrinx/core";
+import type { RealtimePipeline, VoicePipelineContext } from "@kuralle-syrinx/cf-agents";
+import type { VectorizeIndex } from "@cloudflare/workers-types";
+export type RealtimeFront = "openai" | "gemini";
+export interface RealtimeSessionEnv {
+    readonly OPENAI_API_KEY?: string;
+    readonly OPENAI_MODEL?: string;
+    readonly GEMINI_API_KEY?: string;
+    readonly GEMINI_LIVE_MODEL?: string;
+    readonly REALTIME_FRONT?: string;
+    readonly VECTORIZE: VectorizeIndex;
+}
+export declare function resolveRealtimeFront(env: RealtimeSessionEnv): RealtimeFront;
+export declare function hasRealtimeSessionCredentials(env: RealtimeSessionEnv): boolean;
+/** Realtime pipeline descriptor consumed by `withVoice(Agent)`. */
+export declare const realtimeVoicePipeline: RealtimePipeline<RealtimeSessionEnv>;
+/** The back model: a kuralle Vectorize-backed Reasoner, keyed by the session id. */
+export declare function createRealtimeReasoner(env: RealtimeSessionEnv, ctx: VoicePipelineContext): Promise<Reasoner>;
+//# sourceMappingURL=live-realtime-session.d.ts.map

package/dist/live-realtime-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-realtime-session.d.ts","sourceRoot":"","sources":["../src/live-realtime-session.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;CACpC;AAiBD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,kBAAkB,GAAG,aAAa,CAG3E;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAI9E;AAqBD,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,EAAE,gBAAgB,CAAC,kBAAkB,CAItE,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,kBAAkB,EACvB,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,QAAQ,CAAC,CAEnB"}

package/dist/live-realtime-session.js

@@ -0,0 +1,65 @@
+// SPDX-License-Identifier: MIT
+//
+// Bi-model voice pipeline for the Cloudflare Workers host: a gpt-realtime or Gemini
+// Live front model with a kuralle Vectorize-backed Reasoner back model, consulted
+// via the `ask_university` front-model delegate tool. This is the pipeline/brain
+// layer — the host (worker-realtime.ts) composes it via `withVoice(Agent)`.
+import { fromGeminiLive, fromOpenAIRealtime } from "@kuralle-syrinx/realtime";
+import { createWorkersSocket } from "@kuralle-syrinx/ws/workers";
+import { createRealtimeKuralleReasoner } from "./kuralle-realtime-agent.js";
+const DEFAULT_GEMINI_LIVE_MODEL = "gemini-3.1-flash-live-preview";
+const REALTIME_SYSTEM_INSTRUCTION = "You are a university student-relations voice assistant. Delegate factual questions to ask_university.";
+const ASK_UNIVERSITY_TOOL = {
+    name: "ask_university",
+    description: "Answer university student-relations questions (enrollment, add/drop, advising).",
+    parameters: {
+        type: "object",
+        properties: { query: { type: "string" } },
+        required: ["query"],
+    },
+};
+export function resolveRealtimeFront(env) {
+    const front = env.REALTIME_FRONT?.trim().toLowerCase();
+    return front === "gemini" ? "gemini" : "openai";
+}
+export function hasRealtimeSessionCredentials(env) {
+    const front = resolveRealtimeFront(env);
+    if (front === "gemini")
+        return Boolean(env.GEMINI_API_KEY?.trim());
+    return Boolean(env.OPENAI_API_KEY?.trim());
+}
+function buildRealtimeFront(env) {
+    const front = resolveRealtimeFront(env);
+    if (front === "gemini") {
+        return fromGeminiLive({
+            apiKey: requireKey(env.GEMINI_API_KEY, "GEMINI_API_KEY"),
+            model: env.GEMINI_LIVE_MODEL?.trim() || DEFAULT_GEMINI_LIVE_MODEL,
+            systemInstruction: REALTIME_SYSTEM_INSTRUCTION,
+            tools: [ASK_UNIVERSITY_TOOL],
+        });
+    }
+    return fromOpenAIRealtime({
+        apiKey: requireKey(env.OPENAI_API_KEY, "OPENAI_API_KEY"),
+        socketFactory: createWorkersSocket,
+        turnDetection: { type: "server_vad", silence_duration_ms: 500 },
+        inputTranscription: true,
+        tools: [ASK_UNIVERSITY_TOOL],
+    });
+}
+/** Realtime pipeline descriptor consumed by `withVoice(Agent)`. */
+export const realtimeVoicePipeline = {
+    kind: "realtime",
+    front: (env) => buildRealtimeFront(env),
+    delegateToolName: ASK_UNIVERSITY_TOOL.name,
+};
+/** The back model: a kuralle Vectorize-backed Reasoner, keyed by the session id. */
+export function createRealtimeReasoner(env, ctx) {
+    return createRealtimeKuralleReasoner(env, { sessionId: ctx.sessionId });
+}
+function requireKey(value, name) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        throw new Error(`${name} is required to start a realtime voice session`);
+    return trimmed;
+}
+//# sourceMappingURL=live-realtime-session.js.map

package/dist/live-realtime-session.js.map

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

package/dist/live-session.d.ts

@@ -0,0 +1,27 @@
+import type { Reasoner } from "@kuralle-syrinx/core";
+import type { CascadedPipeline, VoicePipelineContext } from "@kuralle-syrinx/cf-agents";
+import type { VectorizeIndex } from "@cloudflare/workers-types";
+import { WorkersAiSmartTurnPredictor, type Ai } from "./workers-ai-smart-turn.js";
+/** Provider secrets + optional tuning, supplied as Workers env/secret bindings. */
+export interface LiveSessionEnv {
+    readonly DEEPGRAM_API_KEY?: string;
+    readonly OPENAI_API_KEY?: string;
+    readonly OPENAI_MODEL?: string;
+    readonly VECTORIZE: VectorizeIndex;
+    /** Optional Cloudflare Workers AI binding for hosted Smart Turn. */
+    readonly AI?: Ai;
+}
+/** True when every provider secret needed for a live turn is present. */
+export declare function hasLiveSessionCredentials(env: LiveSessionEnv): boolean;
+/**
+ * Cascaded pipeline descriptor consumed by `withVoice(Agent)`. Deepgram Nova-3 STT
+ * (provider-endpointed, VAD events for barge-in) → kuralle Reasoner → Deepgram Aura
+ * TTS. `sttForceFinalizeTimeoutMs: 3500` keeps the engine's force-finalize tighter
+ * than the 7000ms default for the provider-endpointed cascade.
+ */
+export declare const liveCascadedPipeline: CascadedPipeline<LiveSessionEnv>;
+/** The brain: a kuralle Vectorize-backed Reasoner, keyed by the session id. */
+export declare function createLiveReasoner(env: LiveSessionEnv, ctx: VoicePipelineContext): Promise<Reasoner>;
+/** Factory: returns a hosted Smart Turn predictor when `env.AI` is present, otherwise undefined. */
+export declare function createWorkersAiSmartTurnPredictor(env: LiveSessionEnv): WorkersAiSmartTurnPredictor | undefined;
+//# sourceMappingURL=live-session.d.ts.map

package/dist/live-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-session.d.ts","sourceRoot":"","sources":["../src/live-session.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,2BAA2B,EAAE,KAAK,EAAE,EAAE,MAAM,4BAA4B,CAAC;AAElF,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;CAClB;AAMD,yEAAyE;AACzE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAEtE;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,CAAC,cAAc,CA0CjE,CAAC;AAEF,+EAA+E;AAC/E,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAI1G;AAED,oGAAoG;AACpG,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,cAAc,GAAG,2BAA2B,GAAG,SAAS,CAG9G"}

package/dist/live-session.js

@@ -0,0 +1,93 @@
+// SPDX-License-Identifier: MIT
+//
+// Cascaded voice pipeline for the Cloudflare Workers host: real Deepgram STT
+// (nova-3) + kuralle (Vectorize RAG) Reasoner + Deepgram Aura TTS, all dialed
+// over the Workers fetch-upgrade socket (createWorkersSocket) so no Node `ws`
+// is pulled into the edge bundle. Default turn-taking is Deepgram endpointing
+// (endpointingOwner: "provider_stt"); when `env.AI` is bound, hosted Workers AI
+// Smart Turn owns EOS via the edge-safe PipecatEOSPlugin (`/eos` subpath, no ONNX).
+//
+// This is the pipeline/brain layer — the host (worker.ts) composes it via
+// `withVoice(Agent)`; this module owns the plugin slots and the reasoner, not the
+// connection lifecycle.
+import { DeepgramSTTPlugin, DeepgramTTSPlugin } from "@kuralle-syrinx/deepgram";
+import { PipecatEOSPlugin } from "@kuralle-syrinx/pipecat-smart-turn/eos";
+import { createWorkersSocket } from "@kuralle-syrinx/ws/workers";
+import { createRealtimeKuralleReasoner } from "./kuralle-realtime-agent.js";
+import { WorkersAiSmartTurnPredictor } from "./workers-ai-smart-turn.js";
+const DEFAULT_DEEPGRAM_TTS_MODEL = "aura-2-thalia-en";
+const INPUT_SAMPLE_RATE_HZ = 16000;
+const OUTPUT_SAMPLE_RATE_HZ = 16000;
+/** True when every provider secret needed for a live turn is present. */
+export function hasLiveSessionCredentials(env) {
+    return Boolean(env.DEEPGRAM_API_KEY?.trim() && env.OPENAI_API_KEY?.trim() && env.VECTORIZE);
+}
+/**
+ * Cascaded pipeline descriptor consumed by `withVoice(Agent)`. Deepgram Nova-3 STT
+ * (provider-endpointed, VAD events for barge-in) → kuralle Reasoner → Deepgram Aura
+ * TTS. `sttForceFinalizeTimeoutMs: 3500` keeps the engine's force-finalize tighter
+ * than the 7000ms default for the provider-endpointed cascade.
+ */
+export const liveCascadedPipeline = {
+    kind: "cascaded",
+    stt: (env) => ({
+        plugin: new DeepgramSTTPlugin(createWorkersSocket),
+        config: {
+            api_key: requireKey(env.DEEPGRAM_API_KEY, "DEEPGRAM_API_KEY"),
+            sample_rate: INPUT_SAMPLE_RATE_HZ,
+            model: "nova-3",
+            language: "en-US",
+            // Silence (ms) before Deepgram finalizes a turn. 300ms is too aggressive with
+            // no semantic layer behind it: a natural mid-sentence pause ("my address is
+            // forty-two… Elm Street") finalizes early and the agent answers half an
+            // utterance. 500ms is the middle ground — it stops the worst cut-offs, and the
+            // ~200ms cost is negligible against the LLM-dominated v2v budget. The real fix
+            // for the edge is a semantic/dynamic endpointer (smart-turn has no Workers
+            // build yet); until then this is the sane default. Tune per deployment.
+            endpointing: 500,
+            // Gap-based backstop: on a noisy/continuous line where Deepgram never detects
+            // clean silence, `speech_final` can fail to fire and the turn wedges. UtteranceEnd
+            // completes it. Requires interim_results (on by default).
+            utterance_end_ms: 1000,
+            provider_finalize_timeout_ms: 2500,
+            finalize_timeout_fallback: true,
+            // No local VAD on the edge: Deepgram SpeechStarted is the barge-in
+            // speech-start signal (vad.speech_started producer).
+            vad_events: true,
+        },
+    }),
+    tts: (env) => ({
+        plugin: new DeepgramTTSPlugin(createWorkersSocket),
+        config: {
+            api_key: requireKey(env.DEEPGRAM_API_KEY, "DEEPGRAM_API_KEY"),
+            model: DEFAULT_DEEPGRAM_TTS_MODEL,
+            sample_rate: OUTPUT_SAMPLE_RATE_HZ,
+        },
+    }),
+    eos: (env) => {
+        const predictor = createWorkersAiSmartTurnPredictor(env);
+        return predictor ? { plugin: new PipecatEOSPlugin(predictor), config: {} } : undefined;
+    },
+    endpointingOwner: (env) => (env.AI ? "smart_turn" : "provider_stt"),
+    sttForceFinalizeTimeoutMs: 3500,
+};
+/** The brain: a kuralle Vectorize-backed Reasoner, keyed by the session id. */
+export async function createLiveReasoner(env, ctx) {
+    requireKey(env.OPENAI_API_KEY, "OPENAI_API_KEY");
+    if (!env.VECTORIZE)
+        throw new Error("VECTORIZE binding is required to start a live voice session");
+    return createRealtimeKuralleReasoner(env, { sessionId: ctx.sessionId });
+}
+/** Factory: returns a hosted Smart Turn predictor when `env.AI` is present, otherwise undefined. */
+export function createWorkersAiSmartTurnPredictor(env) {
+    if (!env.AI)
+        return undefined;
+    return new WorkersAiSmartTurnPredictor(env.AI);
+}
+function requireKey(value, name) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        throw new Error(`${name} is required to start a live voice session`);
+    return trimmed;
+}
+//# sourceMappingURL=live-session.js.map

package/dist/live-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-session.js","sourceRoot":"","sources":["../src/live-session.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,gFAAgF;AAChF,oFAAoF;AACpF,EAAE;AACF,0EAA0E;AAC1E,kFAAkF;AAClF,wBAAwB;AAIxB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAW,MAAM,4BAA4B,CAAC;AAYlF,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;AACtD,MAAM,oBAAoB,GAAG,KAAK,CAAC;AACnC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC,yEAAyE;AACzE,MAAM,UAAU,yBAAyB,CAAC,GAAmB;IAC3D,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;AAC9F,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAqC;IACpE,IAAI,EAAE,UAAU;IAChB,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACb,MAAM,EAAE,IAAI,iBAAiB,CAAC,mBAAmB,CAAC;QAClD,MAAM,EAAE;YACN,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;YAC7D,WAAW,EAAE,oBAAoB;YACjC,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,OAAO;YACjB,8EAA8E;YAC9E,4EAA4E;YAC5E,wEAAwE;YACxE,+EAA+E;YAC/E,+EAA+E;YAC/E,2EAA2E;YAC3E,wEAAwE;YACxE,WAAW,EAAE,GAAG;YAChB,8EAA8E;YAC9E,mFAAmF;YACnF,0DAA0D;YAC1D,gBAAgB,EAAE,IAAI;YACtB,4BAA4B,EAAE,IAAI;YAClC,yBAAyB,EAAE,IAAI;YAC/B,mEAAmE;YACnE,qDAAqD;YACrD,UAAU,EAAE,IAAI;SACjB;KACF,CAAC;IACF,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACb,MAAM,EAAE,IAAI,iBAAiB,CAAC,mBAAmB,CAAC;QAClD,MAAM,EAAE;YACN,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;YAC7D,KAAK,EAAE,0BAA0B;YACjC,WAAW,EAAE,qBAAqB;SACnC;KACF,CAAC;IACF,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,SAAS,GAAG,iCAAiC,CAAC,GAAG,CAAC,CAAC;QACzD,OAAO,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,CAAC;IACD,gBAAgB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC;IACnE,yBAAyB,EAAE,IAAI;CAChC,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAmB,EAAE,GAAyB;IACrF,UAAU,CAAC,GAAG,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IACjD,IAAI,CAAC,GAAG,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACnG,OAAO,6BAA6B,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,iCAAiC,CAAC,GAAmB;IACnE,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,IAAI,2BAA2B,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,UAAU,CAAC,KAAyB,EAAE,IAAY;IACzD,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,4CAA4C,CAAC,CAAC;IACnF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/worker-realtime.d.ts

@@ -0,0 +1,13 @@
+import { Agent } from "agents";
+import { type RealtimeSessionEnv } from "./live-realtime-session.js";
+export interface Env extends RealtimeSessionEnv {
+    readonly REALTIME_VOICE_CONVERSATIONS: DurableObjectNamespace;
+}
+declare const RealtimeVoiceConversation_base: typeof Agent<Env> & (new (...args: any[]) => import("@kuralle-syrinx/cf-agents").WithVoiceMembers);
+export declare class RealtimeVoiceConversation extends RealtimeVoiceConversation_base {
+}
+declare const _default: {
+    fetch(request: Request, env: Env): Promise<Response>;
+};
+export default _default;
+//# sourceMappingURL=worker-realtime.d.ts.map

package/dist/worker-realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-realtime.d.ts","sourceRoot":"","sources":["../src/worker-realtime.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,GAAI,SAAQ,kBAAkB;IAC7C,QAAQ,CAAC,4BAA4B,EAAE,sBAAsB,CAAC;CAC/D;8CAK6D,OAAO,KAAK,CAAC,GAAG,CAAC;AAA/E,qBAAa,yBAA0B,SAAQ,8BAM7C;CAAG;;mBAGkB,OAAO,OAAO,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;;AAD5D,wBASE"}

package/dist/worker-realtime.js

@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: MIT
+//
+// Cloudflare Workers realtime (bi-model) voice host, built on `withVoice(Agent)`
+// (issue #10 / W1). Same host machinery as the cascaded worker — the only
+// difference is the pipeline (realtime front + kuralle back) and the reasoner.
+import { Agent } from "agents";
+import { withVoice } from "@kuralle-syrinx/cf-agents";
+import { createRealtimeReasoner, realtimeVoicePipeline, } from "./live-realtime-session.js";
+const INPUT_SAMPLE_RATE_HZ = 16000;
+const OUTPUT_SAMPLE_RATE_HZ = 16000;
+export class RealtimeVoiceConversation extends withVoice((Agent), {
+    pipeline: realtimeVoicePipeline,
+    reasoner: (env, ctx) => createRealtimeReasoner(env, ctx),
+    inputSampleRateHz: INPUT_SAMPLE_RATE_HZ,
+    outputSampleRateHz: OUTPUT_SAMPLE_RATE_HZ,
+    resumeWindowMs: 15_000,
+}) {
+}
+export default {
+    async fetch(request, env) {
+        const url = new URL(request.url);
+        if (url.pathname === "/health")
+            return new Response("ok");
+        if (url.pathname !== "/ws")
+            return new Response("not found", { status: 404 });
+        const sessionId = url.searchParams.get("sessionId") ?? crypto.randomUUID();
+        const id = env.REALTIME_VOICE_CONVERSATIONS.idFromName(sessionId);
+        return await env.REALTIME_VOICE_CONVERSATIONS.get(id).fetch(request);
+    },
+};
+//# sourceMappingURL=worker-realtime.js.map

package/dist/worker-realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-realtime.js","sourceRoot":"","sources":["../src/worker-realtime.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,iFAAiF;AACjF,0EAA0E;AAC1E,+EAA+E;AAE/E,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,4BAA4B,CAAC;AAMpC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AACnC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC,MAAM,OAAO,yBAA0B,SAAQ,SAAS,CAAyB,CAAA,KAAU,CAAA,EAAE;IAC3F,QAAQ,EAAE,qBAAqB;IAC/B,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC;IACxD,iBAAiB,EAAE,oBAAoB;IACvC,kBAAkB,EAAE,qBAAqB;IACzC,cAAc,EAAE,MAAM;CACvB,CAAC;CAAG;AAEL,eAAe;IACb,KAAK,CAAC,KAAK,CAAC,OAAgB,EAAE,GAAQ;QACpC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK;YAAE,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9E,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAC3E,MAAM,EAAE,GAAG,GAAG,CAAC,4BAA4B,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAClE,OAAO,MAAM,GAAG,CAAC,4BAA4B,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvE,CAAC;CACF,CAAC"}

package/dist/worker.d.ts

@@ -0,0 +1,32 @@
+import { Agent } from "agents";
+import { type LiveSessionEnv } from "./live-session.js";
+export interface Env extends LiveSessionEnv {
+    VOICE_CONVERSATIONS: DurableObjectNamespace;
+    TWILIO_VOICE_CONVERSATIONS: DurableObjectNamespace;
+    TELNYX_VOICE_CONVERSATIONS: DurableObjectNamespace;
+    /** Optional: when bound, full call audio is recorded to this bucket. */
+    RECORDINGS?: R2Bucket;
+    /** Optional: Cloudflare Workers AI binding for hosted Smart Turn endpointing. */
+    AI?: import("./workers-ai-smart-turn.js").Ai;
+}
+declare const VoiceConversation_base: typeof Agent<Env> & (new (...args: any[]) => import("@kuralle-syrinx/cf-agents").WithVoiceMembers);
+/** Browser/edge cascaded host (Syrinx JSON+envelope protocol over /ws). */
+export declare class VoiceConversation extends VoiceConversation_base {
+}
+declare const TwilioVoiceConversation_base: typeof Agent<Env> & (new (...args: any[]) => import("@kuralle-syrinx/cf-agents").WithVoiceMembers);
+/** Telephony cascaded host (Twilio Media Streams μ-law 8 kHz over /twilio). Same pipeline/brain. */
+export declare class TwilioVoiceConversation extends TwilioVoiceConversation_base {
+}
+declare const TelnyxVoiceConversation_base: typeof Agent<Env> & (new (...args: any[]) => import("@kuralle-syrinx/cf-agents").WithVoiceMembers);
+/**
+ * Telephony cascaded host (Telnyx Media Streaming over /telnyx). Same pipeline/brain;
+ * idle timeout keeps the telephony re-engagement default. Live streaming_start →
+ * /telnyx is carrier-gated / unit-tested only.
+ */
+export declare class TelnyxVoiceConversation extends TelnyxVoiceConversation_base {
+}
+declare const _default: {
+    fetch(request: Request, env: Env): Promise<Response>;
+};
+export default _default;
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAG/B,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,GAAI,SAAQ,cAAc;IACzC,mBAAmB,EAAE,sBAAsB,CAAC;IAC5C,0BAA0B,EAAE,sBAAsB,CAAC;IACnD,0BAA0B,EAAE,sBAAsB,CAAC;IACnD,wEAAwE;IACxE,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,iFAAiF;IACjF,EAAE,CAAC,EAAE,OAAO,4BAA4B,EAAE,EAAE,CAAC;CAC9C;sCAMqD,OAAO,KAAK,CAAC,GAAG,CAAC;AADvE,2EAA2E;AAC3E,qBAAa,iBAAkB,SAAQ,sBAerC;CAAG;4CAGuD,OAAO,KAAK,CAAC,GAAG,CAAC;AAD7E,oGAAoG;AACpG,qBAAa,uBAAwB,SAAQ,4BAM3C;CAAG;4CAOuD,OAAO,KAAK,CAAC,GAAG,CAAC;AAL7E;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,4BAM3C;CAAG;;mBAGkB,OAAO,OAAO,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;;AAD5D,wBA4BE"}