@unctad-ai/voice-agent-server 0.1.1

package/dist/builtinTools.d.ts

@@ -0,0 +1,81 @@
+import type { SiteConfig, ServiceBase } from '@unctad-ai/voice-agent-core';
+export declare function buildSynonymMap(synonyms: Record<string, string[]>): Record<string, string[]>;
+export declare function levenshtein(a: string, b: string): number;
+export declare function fuzzySearch(query: string, services: ServiceBase[], synonymMap: Record<string, string[]>): ServiceBase[];
+export declare function createBuiltinTools(config: SiteConfig): {
+    serverTools: {
+        searchServices: import("ai").Tool<{
+            query: string;
+        }, {
+            totalResults: number;
+            services: {
+                id: string;
+                title: string;
+                category: string;
+                duration: string | undefined;
+                cost: string | undefined;
+            }[];
+        }>;
+        getServiceDetails: import("ai").Tool<{
+            serviceId: string;
+        }, {
+            [key: string]: unknown;
+            title: string;
+            category: string;
+            overview?: string;
+            duration?: string;
+            cost?: string;
+            requirements?: string[];
+            eligibility?: string[];
+            steps?: Array<{
+                title: string;
+                description: string;
+            }>;
+        } | {
+            error: string;
+        }>;
+        listServicesByCategory: import("ai").Tool<{
+            category: string;
+        }, {
+            id: string;
+            title: string;
+            duration: string | undefined;
+            cost: string | undefined;
+        }[] | {
+            error: string;
+        }>;
+        compareServices: import("ai").Tool<{
+            serviceIds: string[];
+        }, "Could not find enough valid services to compare." | {
+            id: string;
+            title: string;
+            duration: string | undefined;
+            cost: string | undefined;
+            requirements: string[] | undefined;
+            eligibility: string[] | undefined;
+        }[]>;
+    };
+    clientTools: {
+        navigateTo: import("ai").Tool<{
+            page: string;
+        }, never>;
+        viewService: import("ai").Tool<{
+            serviceId: string;
+        }, never>;
+        startApplication: import("ai").Tool<{
+            serviceId: string;
+        }, never>;
+        performUIAction: import("ai").Tool<{
+            actionId: string;
+            paramsJson?: string | undefined;
+        }, never>;
+        getFormSchema: import("ai").Tool<Record<string, never>, never>;
+        fillFormFields: import("ai").Tool<{
+            fields: {
+                fieldId: string;
+                value: string;
+            }[];
+        }, never>;
+    };
+};
+//# sourceMappingURL=builtinTools.d.ts.map

package/dist/builtinTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtinTools.d.ts","sourceRoot":"","sources":["../src/builtinTools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI3E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAW5F;AAID,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAexD;AAID,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,WAAW,EAAE,EACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACnC,WAAW,EAAE,CAqBf;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoGpD"}

package/dist/builtinTools.js

@@ -0,0 +1,156 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+// --- Synonym map builder ---
+export function buildSynonymMap(synonyms) {
+    const map = {};
+    for (const [key, values] of Object.entries(synonyms)) {
+        if (!map[key])
+            map[key] = [];
+        map[key].push(...values);
+        for (const v of values) {
+            if (!map[v])
+                map[v] = [];
+            if (!map[v].includes(key))
+                map[v].push(key);
+        }
+    }
+    return map;
+}
+// --- Levenshtein distance ---
+export function levenshtein(a, b) {
+    const m = a.length, n = b.length;
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    const dp = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            dp[i][j] = a[i - 1] === b[j - 1]
+                ? dp[i - 1][j - 1]
+                : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+        }
+    }
+    return dp[m][n];
+}
+// --- Fuzzy search ---
+export function fuzzySearch(query, services, synonymMap) {
+    const q = query.toLowerCase();
+    const searchTerms = [q];
+    for (const [term, synonyms] of Object.entries(synonymMap)) {
+        if (q.includes(term))
+            searchTerms.push(...synonyms);
+    }
+    const queryWords = q.split(/\s+/).filter((w) => w.length >= 3);
+    return services.filter((s) => {
+        const titleLower = s.title.toLowerCase();
+        const overviewLower = s.overview?.toLowerCase() || '';
+        const categoryLower = s.category.toLowerCase();
+        const corpus = `${titleLower} ${overviewLower} ${categoryLower}`;
+        const substringMatch = searchTerms.some((term) => titleLower.includes(term) || overviewLower.includes(term) || categoryLower.includes(term));
+        if (substringMatch)
+            return true;
+        const corpusWords = corpus.split(/\s+/);
+        return queryWords.some((qw) => qw.length >= 5 && corpusWords.some((cw) => cw.length >= 5 && levenshtein(qw, cw) <= 2));
+    });
+}
+// --- Tool factory ---
+export function createBuiltinTools(config) {
+    const synonymMap = buildSynonymMap(config.synonyms);
+    // Helper: find service by ID
+    function getServiceById(id) {
+        return config.services.find((s) => s.id === id);
+    }
+    // --- Server-side tools (have execute) ---
+    const serverTools = {
+        searchServices: tool({
+            description: `Search ${config.siteTitle} services by keyword. Supports synonyms. When the search returns a single clear match, immediately follow up with viewService to show the page.`,
+            inputSchema: z.object({ query: z.string().describe('Search query') }),
+            execute: async ({ query }) => {
+                const results = fuzzySearch(query, config.services, synonymMap);
+                return {
+                    totalResults: results.length,
+                    services: results.map((s) => ({
+                        id: s.id, title: s.title, category: s.category, duration: s.duration, cost: s.cost,
+                    })),
+                };
+            },
+        }),
+        getServiceDetails: tool({
+            description: 'Get full details about a service so you can answer verbally. Call searchServices first to get the id. Use alongside viewService.',
+            inputSchema: z.object({ serviceId: z.string() }),
+            execute: async ({ serviceId }) => {
+                const service = getServiceById(serviceId);
+                if (!service)
+                    return { error: 'Service not found' };
+                const { id, ...details } = service;
+                return details;
+            },
+        }),
+        listServicesByCategory: tool({
+            description: 'List all services in a category. Use when the user asks what services are available or wants to browse.',
+            inputSchema: z.object({
+                category: z.enum(Object.keys(config.categoryMap)).describe('Category to list'),
+            }),
+            execute: async ({ category }) => {
+                const categoryTitle = config.categoryMap[category];
+                const cat = config.categories.find((c) => c.title.toLowerCase() === categoryTitle?.toLowerCase());
+                if (!cat)
+                    return { error: 'Category not found' };
+                return cat.services.map((s) => ({ id: s.id, title: s.title, duration: s.duration, cost: s.cost }));
+            },
+        }),
+        compareServices: tool({
+            description: 'Compare two or more services side by side.',
+            inputSchema: z.object({ serviceIds: z.array(z.string()).min(2) }),
+            execute: async ({ serviceIds }) => {
+                const services = serviceIds.map((id) => getServiceById(id)).filter(Boolean);
+                if (services.length < 2)
+                    return 'Could not find enough valid services to compare.';
+                return services.map((s) => ({
+                    id: s.id, title: s.title, duration: s.duration, cost: s.cost,
+                    requirements: s.requirements, eligibility: s.eligibility,
+                }));
+            },
+        }),
+    };
+    // --- Client-side tools (NO execute — handled via onToolCall in useChat) ---
+    const clientTools = {
+        navigateTo: tool({
+            description: `Navigate to a page in ${config.siteTitle}.`,
+            inputSchema: z.object({
+                page: z.enum(Object.keys(config.routeMap)).describe('Page key from route map'),
+            }),
+        }),
+        viewService: tool({
+            description: 'Navigate to a specific service detail page. Use the id from searchServices.',
+            inputSchema: z.object({ serviceId: z.string() }),
+        }),
+        startApplication: tool({
+            description: 'Navigate to an application form for a service. Use when the user wants to apply or register.',
+            inputSchema: z.object({ serviceId: z.string() }),
+        }),
+        performUIAction: tool({
+            description: 'Execute a UI action on the current page such as clicking a button, switching a tab, or toggling a view.',
+            inputSchema: z.object({
+                actionId: z.string().describe('The action id from UI_ACTIONS context'),
+                paramsJson: z.string().optional().describe('JSON params string, e.g. {"tab":"taxes"}'),
+            }),
+        }),
+        getFormSchema: tool({
+            description: 'Get available form field IDs and types. Call this ONCE before fillFormFields.',
+            inputSchema: z.object({}),
+        }),
+        fillFormFields: tool({
+            description: 'Fill one or more form fields. Use field IDs from getFormSchema.',
+            inputSchema: z.object({
+                fields: z.array(z.object({
+                    fieldId: z.string().describe('The field ID from getFormSchema'),
+                    value: z.string().describe('The value to set'),
+                })),
+            }),
+        }),
+    };
+    return { serverTools, clientTools };
+}
+//# sourceMappingURL=builtinTools.js.map

package/dist/builtinTools.js.map

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

package/dist/createChatHandler.d.ts

@@ -0,0 +1,9 @@
+import type { SiteConfig } from '@unctad-ai/voice-agent-core';
+import type { Request, Response } from 'express';
+export interface ChatHandlerOptions {
+    config: SiteConfig;
+    groqApiKey: string;
+    groqModel?: string;
+}
+export declare function createChatHandler(options: ChatHandlerOptions): (req: Request, res: Response) => Promise<void>;
+//# sourceMappingURL=createChatHandler.d.ts.map

package/dist/createChatHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createChatHandler.d.ts","sourceRoot":"","sources":["../src/createChatHandler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAMjD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CA+C7G"}

package/dist/createChatHandler.js

@@ -0,0 +1,47 @@
+import { streamText, convertToModelMessages, stepCountIs } from 'ai';
+import { createGroq } from '@ai-sdk/groq';
+import { buildSystemPrompt } from './systemPrompt.js';
+import { createBuiltinTools } from './builtinTools.js';
+export function createChatHandler(options) {
+    const { config, groqApiKey, groqModel } = options;
+    const groq = createGroq({ apiKey: groqApiKey });
+    const { serverTools, clientTools } = createBuiltinTools(config);
+    // Merge extra server tools from config if provided
+    const allServerTools = config.extraServerTools
+        ? { ...serverTools, ...config.extraServerTools }
+        : serverTools;
+    return async function chatHandler(req, res) {
+        try {
+            const { messages, clientState } = req.body;
+            if (!messages || !Array.isArray(messages) || messages.length === 0) {
+                res.status(400).json({ error: 'messages array is required' });
+                return;
+            }
+            // useChat sends UIMessage format; convert to model messages for streamText
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const modelMessages = await convertToModelMessages(messages);
+            const result = streamText({
+                model: groq(groqModel || 'openai/gpt-oss-120b'),
+                system: buildSystemPrompt(config, clientState),
+                messages: modelMessages,
+                tools: { ...allServerTools, ...clientTools },
+                stopWhen: stepCountIs(5),
+                temperature: 0,
+            });
+            result.pipeUIMessageStreamToResponse(res);
+            // Consume the full text promise to catch async stream errors that would
+            // otherwise crash the Node process as unhandled rejections.
+            Promise.resolve(result.text).catch((err) => {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error('Stream error:', msg);
+            });
+        }
+        catch (error) {
+            console.error('Chat error:', error);
+            if (!res.headersSent) {
+                res.status(500).json({ error: 'Chat request failed' });
+            }
+        }
+    };
+}
+//# sourceMappingURL=createChatHandler.js.map

package/dist/createChatHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createChatHandler.js","sourceRoot":"","sources":["../src/createChatHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AASvD,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAChD,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAEhE,mDAAmD;IACnD,MAAM,cAAc,GAAG,MAAM,CAAC,gBAAgB;QAC5C,CAAC,CAAC,EAAE,GAAG,WAAW,EAAE,GAAI,MAAM,CAAC,gBAAyE,EAAE;QAC1G,CAAC,CAAC,WAAW,CAAC;IAEhB,OAAO,KAAK,UAAU,WAAW,CAAC,GAAY,EAAE,GAAa;QAC3D,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,IAA2D,CAAC;YAElG,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC,CAAC;gBAC9D,OAAO;YACT,CAAC;YAED,2EAA2E;YAC3E,8DAA8D;YAC9D,MAAM,aAAa,GAAG,MAAM,sBAAsB,CAAC,QAAe,CAAC,CAAC;YAEpE,MAAM,MAAM,GAAG,UAAU,CAAC;gBACxB,KAAK,EAAE,IAAI,CAAC,SAAS,IAAI,qBAAqB,CAAC;gBAC/C,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC;gBAC9C,QAAQ,EAAE,aAAa;gBACvB,KAAK,EAAE,EAAE,GAAG,cAAc,EAAE,GAAG,WAAW,EAAE;gBAC5C,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;gBACxB,WAAW,EAAE,CAAC;aACf,CAAC,CAAC;YAEH,MAAM,CAAC,6BAA6B,CAAC,GAAgC,CAAC,CAAC;YAEvE,wEAAwE;YACxE,4DAA4D;YAC5D,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBAClD,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/createSttHandler.d.ts

@@ -0,0 +1,8 @@
+import { Router } from 'express';
+export interface SttHandlerOptions {
+    groqApiKey?: string;
+    sttProvider?: string;
+    kyutaiSttUrl?: string;
+}
+export declare function createSttHandler(options: SttHandlerOptions): Router;
+//# sourceMappingURL=createSttHandler.d.ts.map

package/dist/createSttHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSttHandler.d.ts","sourceRoot":"","sources":["../src/createSttHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAUD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAiJnE"}

package/dist/createSttHandler.js

@@ -0,0 +1,125 @@
+import { Router } from 'express';
+import Groq from 'groq-sdk';
+import multer from 'multer';
+export function createSttHandler(options) {
+    const router = Router();
+    const upload = multer({
+        storage: multer.memoryStorage(),
+        limits: { fileSize: 10 * 1024 * 1024 }, // 10MB max
+    });
+    const sttProvider = options.sttProvider || 'kyutai';
+    const kyutaiSttUrl = options.kyutaiSttUrl || 'http://localhost:8003';
+    // Groq client — only initialized when needed
+    let groq = null;
+    function getGroq() {
+        if (!groq) {
+            if (!options.groqApiKey) {
+                throw new Error('groqApiKey not set — cannot use Groq STT');
+            }
+            groq = new Groq({ apiKey: options.groqApiKey });
+        }
+        return groq;
+    }
+    // --- Kyutai STT ---
+    async function transcribeWithKyutai(wavBuffer) {
+        const formData = new FormData();
+        const blob = new Blob([new Uint8Array(wavBuffer)], { type: 'audio/wav' });
+        formData.append('file', blob, 'audio.wav');
+        const res = await fetch(`${kyutaiSttUrl}/v1/audio/transcriptions`, {
+            method: 'POST',
+            body: formData,
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => '');
+            throw new Error(`Kyutai STT HTTP ${res.status}: ${body}`);
+        }
+        const data = (await res.json());
+        // Map Kyutai VAD to Whisper-compatible format:
+        // vadProbs[2] = P(no voice activity in 2s) — maps to Whisper's no_speech_prob
+        const noSpeechProb = data.vadProbs?.[2] ?? 0;
+        // Derive confidence proxy from aggregate VAD probabilities.
+        // Low mean VAD probability -> audio is likely not speech -> mapped to negative logprob
+        const vadProbs = data.vadProbs ?? [];
+        const meanVadProb = vadProbs.length > 0
+            ? vadProbs.reduce((s, v) => s + v, 0) / vadProbs.length
+            : 1; // no probs = assume speech
+        const avgLogprob = vadProbs.length > 0 ? -1.0 * (1 - meanVadProb) : 0;
+        return {
+            text: data.text,
+            language: 'en',
+            noSpeechProb,
+            avgLogprob,
+        };
+    }
+    // --- Groq Whisper STT ---
+    async function transcribeWithGroq(wavBuffer) {
+        const uint8 = new Uint8Array(wavBuffer);
+        const file = new File([uint8], 'audio.wav', { type: 'audio/wav' });
+        const transcription = await getGroq().audio.transcriptions.create({
+            file,
+            model: 'whisper-large-v3-turbo',
+            temperature: 0,
+            response_format: 'verbose_json',
+        });
+        // verbose_json includes per-segment quality signals the type doesn't expose
+        const verbose = transcription;
+        const segments = verbose.segments ?? [];
+        const noSpeechProb = segments.length > 0
+            ? Math.max(...segments.map((s) => s.no_speech_prob ?? 0))
+            : 0;
+        const avgLogprob = segments.length > 0
+            ? segments.reduce((sum, s) => sum + (s.avg_logprob ?? 0), 0) / segments.length
+            : 0;
+        return {
+            text: transcription.text,
+            language: verbose.language ?? 'en',
+            noSpeechProb,
+            avgLogprob,
+        };
+    }
+    // --- Route handler ---
+    router.post('/', upload.single('audio'), async (req, res) => {
+        try {
+            if (!req.file) {
+                res.status(400).json({ error: 'No audio file provided' });
+                return;
+            }
+            let response;
+            let provider = sttProvider;
+            const t0 = performance.now();
+            if (sttProvider === 'kyutai') {
+                try {
+                    response = await transcribeWithKyutai(req.file.buffer);
+                    if (!response.text)
+                        throw new Error('empty transcription');
+                }
+                catch (err) {
+                    console.warn('[STT] Kyutai failed, falling back to Groq:', err.message);
+                    provider = 'groq (fallback)';
+                    response = await transcribeWithGroq(req.file.buffer);
+                }
+            }
+            else {
+                response = await transcribeWithGroq(req.file.buffer);
+            }
+            const durationMs = Math.round(performance.now() - t0);
+            const audioSizeKB = Math.round(req.file.buffer.length / 1024);
+            console.log('[STT]', JSON.stringify({
+                provider,
+                text: response.text,
+                durationMs,
+                audioSizeKB,
+                noSpeechProb: response.noSpeechProb.toFixed(3),
+                avgLogprob: response.avgLogprob.toFixed(3),
+            }));
+            res.json({ ...response, durationMs });
+        }
+        catch (error) {
+            console.error('STT error:', error);
+            res.status(500).json({ error: 'Transcription failed' });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=createSttHandler.js.map

package/dist/createSttHandler.js.map

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

package/dist/createTtsHandler.d.ts

@@ -0,0 +1,13 @@
+import { Router } from 'express';
+export interface TtsHandlerOptions {
+    ttsProvider?: string;
+    qwen3TtsUrl?: string;
+    chatterboxTurboUrl?: string;
+    cosyVoiceTtsUrl?: string;
+    pocketTtsUrl?: string;
+    resembleApiKey?: string;
+    resembleModel?: string;
+    resembleVoiceUuid?: string;
+}
+export declare function createTtsHandler(options: TtsHandlerOptions): Router;
+//# sourceMappingURL=createTtsHandler.d.ts.map

package/dist/createTtsHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTtsHandler.d.ts","sourceRoot":"","sources":["../src/createTtsHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAsLD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAoNnE"}

package/dist/createTtsHandler.js

@@ -0,0 +1,364 @@
+import { Router } from 'express';
+/**
+ * Strip reasoning-model chain-of-thought from LLM output.
+ *
+ * Reasoning models (gpt-oss-120b, DeepSeek, QwQ) emit their thinking
+ * before the answer. Two patterns:
+ *
+ * 1. Tagged: <think>reasoning</think>actual answer
+ *    The sanitizer's < > stripping removes the tags but leaves reasoning
+ *    content — must strip BEFORE other sanitization.
+ *
+ * 2. Untagged: garbled preamble + \n\n + reasoning + actual answer
+ *    Detected by meta-reasoning phrases ("we need to", "according to rules").
+ *    The actual answer is always the LAST paragraph.
+ */
+function stripChainOfThought(raw) {
+    let text = raw;
+    // Tagged CoT: <think>...</think> (may span multiple lines)
+    text = text.replace(/<think>[\s\S]*?<\/think>/gi, '');
+    // Untagged CoT: split on double-newline, check for reasoning patterns
+    const paragraphs = text.split(/\n\n+/).map(p => p.trim()).filter(Boolean);
+    if (paragraphs.length > 1) {
+        const reasoningPatterns = /\b(we need to|we should|we must|according to rules|the user says|ensure no|two sentences|under \d+ words|no markdown|no contractions|let me think|so we|that'?s \d+ sentences)\b/i;
+        const hasReasoning = paragraphs.slice(0, -1).some(p => reasoningPatterns.test(p));
+        if (hasReasoning) {
+            text = paragraphs[paragraphs.length - 1];
+        }
+    }
+    return text.trim();
+}
+/**
+ * Sanitize text for TTS engines.
+ * Strips CoT reasoning, markdown/emoji, escapes SSML chars, caps length.
+ */
+function sanitizeForTTS(raw, maxWords = 60) {
+    // Strip chain-of-thought FIRST — before < > removal destroys the tags
+    let text = stripChainOfThought(raw)
+        // Strip emoji
+        .replace(/[\u{1F600}-\u{1F64F}\u{1F300}-\u{1F5FF}\u{1F680}-\u{1F6FF}\u{1F1E0}-\u{1F1FF}\u{2600}-\u{26FF}\u{2700}-\u{27BF}\u{FE00}-\u{FE0F}\u{1F900}-\u{1F9FF}\u{1FA00}-\u{1FA6F}\u{1FA70}-\u{1FAFF}\u{200D}\u{20E3}\u{E0020}-\u{E007F}\u{2705}\u{274C}\u{2714}\u{2716}]/gu, '')
+        // Normalize Unicode dashes
+        .replace(/[\u{2010}\u{2011}\u{2012}\u{2013}\u{2014}\u{2015}]/gu, '-')
+        // Strip markdown formatting
+        .replace(/\*{1,3}([^*]+)\*{1,3}/g, '$1')
+        .replace(/^\|.*\|$/gm, '')
+        .replace(/^\|[-:| ]+\|$/gm, '')
+        .replace(/\|/g, ',')
+        .replace(/^#{1,6}\s+/gm, '')
+        .replace(/`{1,3}[^`]*`{1,3}/g, '')
+        .replace(/^[\s]*[-*]\s+/gm, '')
+        .replace(/^[\s]*\d+\.\s+/gm, '')
+        // Strip bracketed stage directions ([Awaiting response], [END_SESSION], etc.)
+        .replace(/\[[^\]]{2,}\]/g, '')
+        // SSML-breaking characters
+        .replace(/&/g, 'and')
+        .replace(/</g, '')
+        .replace(/>/g, '')
+        // Collapse whitespace and double periods
+        .replace(/\n{2,}/g, '. ')
+        .replace(/\n/g, ' ')
+        .replace(/\s{2,}/g, ' ')
+        .replace(/\.{2,}/g, '.')
+        .replace(/\.\s*\./g, '.')
+        .trim();
+    // Cap at ~maxWords words for listening UX — cut at sentence boundary.
+    const words = text.split(/\s+/);
+    if (words.length > maxWords) {
+        const joined = words.slice(0, maxWords).join(' ');
+        const lastSentence = Math.max(joined.lastIndexOf('. '), joined.lastIndexOf('? '));
+        text = lastSentence > 0 ? joined.slice(0, lastSentence + 1) : joined.replace(/[,;:\s]+$/, '') + '.';
+    }
+    return text;
+}
+// --- TTS provider functions ---
+async function synthesizeWithQwen3TTS(text, url, signal, opts) {
+    const formData = new URLSearchParams();
+    formData.append('text', text);
+    if (opts?.temperature != null)
+        formData.append('temperature', String(opts.temperature));
+    // Uses /tts-pipeline for token-level streaming: audio chunks yielded as codec
+    // tokens are generated. TTFA ~200ms with two-phase emission + Hann crossfade.
+    // 50s timeout: accounts for GPU lock wait (up to 15s) + generation (up to 25s).
+    const providerTimeout = AbortSignal.timeout(50_000);
+    return fetch(`${url}/tts-pipeline`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: formData.toString(),
+        signal: signal ? AbortSignal.any([signal, providerTimeout]) : providerTimeout,
+    });
+}
+async function synthesizeWithChatterboxTurbo(text, url, signal) {
+    const formData = new URLSearchParams();
+    formData.append('text', text);
+    // Use /tts-pipeline for sentence-level pipelining: splits text into sentences,
+    // generates each sequentially, streams PCM as each sentence completes.
+    const providerTimeout = AbortSignal.timeout(30_000);
+    return fetch(`${url}/tts-pipeline`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: formData.toString(),
+        signal: signal ? AbortSignal.any([signal, providerTimeout]) : providerTimeout,
+    });
+}
+async function synthesizeWithCosyVoice(text, url, signal) {
+    const formData = new URLSearchParams();
+    formData.append('text', text);
+    const providerTimeout = AbortSignal.timeout(15_000);
+    return fetch(`${url}/tts`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: formData.toString(),
+        signal: signal ? AbortSignal.any([signal, providerTimeout]) : providerTimeout,
+    });
+}
+async function synthesizeWithPocketTTS(text, url, signal) {
+    const formData = new URLSearchParams();
+    formData.append('text', text);
+    const providerTimeout = AbortSignal.timeout(30_000); // Pocket TTS generates at ~0.5x RT on CPU
+    return fetch(`${url}/tts`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: formData.toString(),
+        signal: signal ? AbortSignal.any([signal, providerTimeout]) : providerTimeout,
+    });
+}
+async function synthesizeWithResemble(text, apiKey, model, voiceUuid, signal) {
+    const providerTimeout = AbortSignal.timeout(10_000);
+    return fetch('https://f.cluster.resemble.ai/stream', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'User-Agent': 'voice-agent-kit/1.0',
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            model,
+            voice_uuid: voiceUuid,
+            data: text,
+            output_format: 'wav',
+        }),
+        signal: signal ? AbortSignal.any([signal, providerTimeout]) : providerTimeout,
+    });
+}
+export function createTtsHandler(options) {
+    const router = Router();
+    const ttsProvider = options.ttsProvider || 'resemble';
+    const qwen3TtsUrl = options.qwen3TtsUrl || 'http://localhost:8005';
+    const chatterboxTurboUrl = options.chatterboxTurboUrl || 'http://localhost:8004';
+    const cosyVoiceTtsUrl = options.cosyVoiceTtsUrl || 'http://localhost:8004';
+    const pocketTtsUrl = options.pocketTtsUrl || 'http://pocket-tts:8002';
+    const resembleApiKey = options.resembleApiKey || '';
+    const resembleModel = options.resembleModel || '';
+    const resembleVoiceUuid = options.resembleVoiceUuid || '';
+    // Helper to call Resemble with options closure
+    function callResemble(text, signal) {
+        return synthesizeWithResemble(text, resembleApiKey, resembleModel, resembleVoiceUuid, signal);
+    }
+    router.post('/', async (req, res) => {
+        // Global AbortController: aborts upstream fetch on client disconnect or overall timeout.
+        // 60s cap prevents the fallback cascade (up to 90s worst-case) from running unchecked.
+        const globalAc = new AbortController();
+        const globalTimeout = AbortSignal.timeout(60_000);
+        const signal = AbortSignal.any([globalAc.signal, globalTimeout]);
+        // Abort upstream fetch when client disconnects (barge-in, navigation, tab close).
+        // MUST use res.on('close'), NOT req.on('close'): in Node 22, req 'close' fires
+        // when the request body is consumed (auto-destroy on Readable), not on disconnect.
+        // res 'close' fires when the response connection actually closes.
+        res.on('close', () => {
+            if (!res.writableFinished) {
+                console.debug('[TTS] client disconnected before response complete, aborting upstream');
+                globalAc.abort();
+            }
+        });
+        try {
+            const { text, temperature: rawTemp, maxWords: rawMaxWords } = req.body;
+            if (!text) {
+                res.status(400).json({ error: 'No text provided' });
+                return;
+            }
+            if (typeof text !== 'string' || text.length > 2000) {
+                res.status(400).json({ error: 'Text must be a string of 2000 characters or less' });
+                return;
+            }
+            // Validate optional temperature (0-1)
+            let temperature;
+            if (rawTemp != null) {
+                temperature = Number(rawTemp);
+                if (isNaN(temperature) || temperature < 0 || temperature > 1) {
+                    res.status(400).json({ error: 'temperature must be between 0 and 1' });
+                    return;
+                }
+            }
+            // Validate optional maxWords (10-200)
+            let maxWords;
+            if (rawMaxWords != null) {
+                maxWords = Number(rawMaxWords);
+                if (isNaN(maxWords) || maxWords < 10 || maxWords > 200) {
+                    res.status(400).json({ error: 'maxWords must be between 10 and 200' });
+                    return;
+                }
+            }
+            const sanitized = sanitizeForTTS(text, maxWords);
+            console.debug('[TTS] provider:', ttsProvider);
+            console.debug('[TTS] raw:', JSON.stringify(text));
+            console.debug('[TTS] sanitized:', JSON.stringify(sanitized));
+            const ttsStartTime = performance.now();
+            let response;
+            if (ttsProvider === 'qwen3-tts') {
+                try {
+                    response = await synthesizeWithQwen3TTS(sanitized, qwen3TtsUrl, signal, { temperature });
+                    if (!response.ok)
+                        throw new Error(`qwen3-tts ${response.status}`);
+                }
+                catch (err) {
+                    if (signal.aborted)
+                        throw err; // Don't fallback if globally aborted
+                    console.warn('[TTS] qwen3-tts failed, falling back to pocket-tts:', err);
+                    try {
+                        response = await synthesizeWithPocketTTS(sanitized, pocketTtsUrl, signal);
+                        if (!response.ok)
+                            throw new Error(`pocket-tts ${response.status}`);
+                    }
+                    catch (err2) {
+                        if (signal.aborted)
+                            throw err2;
+                        console.warn('[TTS] pocket-tts failed, falling back to Resemble:', err2);
+                        response = await callResemble(sanitized, signal);
+                    }
+                }
+            }
+            else if (ttsProvider === 'chatterbox-turbo') {
+                try {
+                    response = await synthesizeWithChatterboxTurbo(sanitized, chatterboxTurboUrl, signal);
+                    if (!response.ok)
+                        throw new Error(`chatterbox-turbo ${response.status}`);
+                }
+                catch (err) {
+                    if (signal.aborted)
+                        throw err;
+                    console.warn('[TTS] chatterbox-turbo failed, falling back to pocket-tts:', err);
+                    try {
+                        response = await synthesizeWithPocketTTS(sanitized, pocketTtsUrl, signal);
+                        if (!response.ok)
+                            throw new Error(`pocket-tts ${response.status}`);
+                    }
+                    catch (err2) {
+                        if (signal.aborted)
+                            throw err2;
+                        console.warn('[TTS] pocket-tts failed, falling back to Resemble:', err2);
+                        response = await callResemble(sanitized, signal);
+                    }
+                }
+            }
+            else if (ttsProvider === 'cosyvoice') {
+                try {
+                    response = await synthesizeWithCosyVoice(sanitized, cosyVoiceTtsUrl, signal);
+                    if (!response.ok)
+                        throw new Error(`cosyvoice ${response.status}`);
+                }
+                catch (err) {
+                    if (signal.aborted)
+                        throw err;
+                    console.warn('[TTS] cosyvoice failed, falling back to pocket-tts:', err);
+                    try {
+                        response = await synthesizeWithPocketTTS(sanitized, pocketTtsUrl, signal);
+                        if (!response.ok)
+                            throw new Error(`pocket-tts ${response.status}`);
+                    }
+                    catch (err2) {
+                        if (signal.aborted)
+                            throw err2;
+                        console.warn('[TTS] pocket-tts failed, falling back to Resemble:', err2);
+                        response = await callResemble(sanitized, signal);
+                    }
+                }
+            }
+            else if (ttsProvider === 'pocket-tts') {
+                try {
+                    response = await synthesizeWithPocketTTS(sanitized, pocketTtsUrl, signal);
+                    if (!response.ok)
+                        throw new Error(`pocket-tts ${response.status}`);
+                }
+                catch (err) {
+                    if (signal.aborted)
+                        throw err;
+                    console.warn('[TTS] pocket-tts failed, falling back to Resemble:', err);
+                    response = await callResemble(sanitized, signal);
+                }
+            }
+            else {
+                response = await callResemble(sanitized, signal);
+            }
+            if (!response.ok) {
+                const errorText = await response.text();
+                console.error('[TTS] API error:', response.status, errorText);
+                // Normalize all upstream errors to 502 Bad Gateway
+                res.status(502).json({ error: 'TTS request failed' });
+                return;
+            }
+            res.setHeader('Content-Type', 'audio/wav');
+            res.setHeader('Transfer-Encoding', 'chunked');
+            const reader = response.body?.getReader();
+            if (!reader) {
+                res.status(500).json({ error: 'No response body from TTS' });
+                return;
+            }
+            // Forward chunks as they arrive from upstream TTS provider.
+            // Handles backpressure (pause reading when Express buffer is full)
+            // and client disconnect (cancel reader to stop upstream consumption).
+            let firstChunkSent = false;
+            let ttfaMs = 0;
+            try {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    if (!firstChunkSent) {
+                        firstChunkSent = true;
+                        ttfaMs = Math.round(performance.now() - ttsStartTime);
+                        // Add Server-Timing header before first write so client can read TTFA
+                        res.setHeader('Server-Timing', `ttfa;dur=${ttfaMs}`);
+                        // Flush headers now that Server-Timing is set
+                        res.flushHeaders();
+                    }
+                    const canContinue = res.write(value);
+                    if (!canContinue) {
+                        // Express buffer is full — wait for drain before reading more
+                        await new Promise((resolve) => res.once('drain', resolve));
+                    }
+                }
+            }
+            catch (streamErr) {
+                // Reader cancelled (client disconnect) or global timeout — clean up silently
+                reader.cancel().catch(() => { });
+            }
+            finally {
+                const totalMs = Math.round(performance.now() - ttsStartTime);
+                // Update Server-Timing with total duration (only works if headers not yet flushed,
+                // otherwise the TTFA-only header was already sent — that's fine)
+                if (!firstChunkSent) {
+                    res.setHeader('Server-Timing', `ttfa;dur=0, total;dur=${totalMs}`);
+                    res.flushHeaders();
+                }
+                console.log('[TTS]', JSON.stringify({
+                    provider: ttsProvider,
+                    ttfaMs,
+                    totalMs,
+                    textLen: sanitized.length,
+                }));
+                res.end();
+            }
+        }
+        catch (error) {
+            console.error('[TTS] error:', error);
+            if (!res.headersSent) {
+                res.status(500).json({ error: 'TTS request failed' });
+            }
+            else if (!res.writableEnded) {
+                res.end();
+            }
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=createTtsHandler.js.map

package/dist/createTtsHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTtsHandler.js","sourceRoot":"","sources":["../src/createTtsHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAajC;;;;;;;;;;;;;GAaG;AACH,SAAS,mBAAmB,CAAC,GAAW;IACtC,IAAI,IAAI,GAAG,GAAG,CAAC;IAEf,2DAA2D;IAC3D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;IAEtD,sEAAsE;IACtE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,iBAAiB,GAAG,mLAAmL,CAAC;QAC9M,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClF,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,GAAW,EAAE,QAAQ,GAAG,EAAE;IAChD,sEAAsE;IACtE,IAAI,IAAI,GAAG,mBAAmB,CAAC,GAAG,CAAC;QACjC,cAAc;SACb,OAAO,CAAC,iQAAiQ,EAAE,EAAE,CAAC;QAC/Q,2BAA2B;SAC1B,OAAO,CAAC,sDAAsD,EAAE,GAAG,CAAC;QACrE,4BAA4B;SAC3B,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC;SACvC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;SAC9B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;SACjC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;SAC9B,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAChC,8EAA8E;SAC7E,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC9B,2BAA2B;SAC1B,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;SACjB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB,yCAAyC;SACxC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC;SACxB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,IAAI,EAAE,CAAC;IAEV,sEAAsE;IACtE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAClF,IAAI,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IACtG,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iCAAiC;AAEjC,KAAK,UAAU,sBAAsB,CACnC,IAAY,EACZ,GAAW,EACX,MAAoB,EACpB,IAA+B;IAE/B,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,EAAE,WAAW,IAAI,IAAI;QAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAExF,8EAA8E;IAC9E,8EAA8E;IAC9E,gFAAgF;IAChF,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,GAAG,GAAG,eAAe,EAAE;QAClC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;QAChE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;KAC9E,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,6BAA6B,CAC1C,IAAY,EACZ,GAAW,EACX,MAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE9B,+EAA+E;IAC/E,uEAAuE;IACvE,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,GAAG,GAAG,eAAe,EAAE;QAClC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;QAChE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;KAC9E,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,IAAY,EACZ,GAAW,EACX,MAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE9B,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,GAAG,GAAG,MAAM,EAAE;QACzB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;QAChE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;KAC9E,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,IAAY,EACZ,GAAW,EACX,MAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE9B,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,0CAA0C;IAC/F,OAAO,KAAK,CAAC,GAAG,GAAG,MAAM,EAAE;QACzB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;QAChE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;KAC9E,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,IAAY,EACZ,MAAc,EACd,KAAa,EACb,SAAiB,EACjB,MAAoB;IAEpB,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC,sCAAsC,EAAE;QACnD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,YAAY,EAAE,qBAAqB;YACnC,aAAa,EAAE,UAAU,MAAM,EAAE;SAClC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,KAAK;YACL,UAAU,EAAE,SAAS;YACrB,IAAI,EAAE,IAAI;YACV,aAAa,EAAE,KAAK;SACrB,CAAC;QACF,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;KAC9E,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IACzD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,UAAU,CAAC;IACtD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,uBAAuB,CAAC;IACnE,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,uBAAuB,CAAC;IACjF,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,uBAAuB,CAAC;IAC3E,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,wBAAwB,CAAC;IACtE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;IACpD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;IAClD,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAE1D,+CAA+C;IAC/C,SAAS,YAAY,CAAC,IAAY,EAAE,MAAoB;QACtD,OAAO,sBAAsB,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAClC,yFAAyF;QACzF,uFAAuF;QACvF,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACvC,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;QAEjE,kFAAkF;QAClF,+EAA+E;QAC/E,mFAAmF;QACnF,kEAAkE;QAClE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;gBAC1B,OAAO,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAC;gBACvF,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;YAEvE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBACpD,OAAO;YACT,CAAC;YAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;gBACnD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,kDAAkD,EAAE,CAAC,CAAC;gBACpF,OAAO;YACT,CAAC;YAED,sCAAsC;YACtC,IAAI,WAA+B,CAAC;YACpC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACpB,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC9B,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;oBAC7D,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC,CAAC;oBACvE,OAAO;gBACT,CAAC;YACH,CAAC;YAED,sCAAsC;YACtC,IAAI,QAA4B,CAAC;YACjC,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;gBACxB,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;gBAC/B,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,EAAE,IAAI,QAAQ,GAAG,GAAG,EAAE,CAAC;oBACvD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC,CAAC;oBACvE,OAAO;gBACT,CAAC;YACH,CAAC;YAED,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACjD,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;YAC9C,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YAClD,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;YAE7D,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YACvC,IAAI,QAAkB,CAAC;YAEvB,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACH,QAAQ,GAAG,MAAM,sBAAsB,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;oBACzF,IAAI,CAAC,QAAQ,CAAC,EAAE;wBAAE,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBACpE,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,MAAM,CAAC,OAAO;wBAAE,MAAM,GAAG,CAAC,CAAC,qCAAqC;oBACpE,OAAO,CAAC,IAAI,CAAC,qDAAqD,EAAE,GAAG,CAAC,CAAC;oBACzE,IAAI,CAAC;wBACH,QAAQ,GAAG,MAAM,uBAAuB,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;wBAC1E,IAAI,CAAC,QAAQ,CAAC,EAAE;4BAAE,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;oBACrE,CAAC;oBAAC,OAAO,IAAI,EAAE,CAAC;wBACd,IAAI,MAAM,CAAC,OAAO;4BAAE,MAAM,IAAI,CAAC;wBAC/B,OAAO,CAAC,IAAI,CAAC,oDAAoD,EAAE,IAAI,CAAC,CAAC;wBACzE,QAAQ,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;oBACnD,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,WAAW,KAAK,kBAAkB,EAAE,CAAC;gBAC9C,IAAI,CAAC;oBACH,QAAQ,GAAG,MAAM,6BAA6B,CAAC,SAAS,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;oBACtF,IAAI,CAAC,QAAQ,CAAC,EAAE;wBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC3E,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,MAAM,CAAC,OAAO;wBAAE,MAAM,GAAG,CAAC;oBAC9B,OAAO,CAAC,IAAI,CAAC,4DAA4D,EAAE,GAAG,CAAC,CAAC;oBAChF,IAAI,CAAC;wBACH,QAAQ,GAAG,MAAM,uBAAuB,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;wBAC1E,IAAI,CAAC,QAAQ,CAAC,EAAE;4BAAE,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;oBACrE,CAAC;oBAAC,OAAO,IAAI,EAAE,CAAC;wBACd,IAAI,MAAM,CAAC,OAAO;4BAAE,MAAM,IAAI,CAAC;wBAC/B,OAAO,CAAC,IAAI,CAAC,oDAAoD,EAAE,IAAI,CAAC,CAAC;wBACzE,QAAQ,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;oBACnD,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;gBACvC,IAAI,CAAC;oBACH,QAAQ,GAAG,MAAM,uBAAuB,CAAC,SAAS,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;oBAC7E,IAAI,CAAC,QAAQ,CAAC,EAAE;wBAAE,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBACpE,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,MAAM,CAAC,OAAO;wBAAE,MAAM,GAAG,CAAC;oBAC9B,OAAO,CAAC,IAAI,CAAC,qDAAqD,EAAE,GAAG,CAAC,CAAC;oBACzE,IAAI,CAAC;wBACH,QAAQ,GAAG,MAAM,uBAAuB,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;wBAC1E,IAAI,CAAC,QAAQ,CAAC,EAAE;4BAAE,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;oBACrE,CAAC;oBAAC,OAAO,IAAI,EAAE,CAAC;wBACd,IAAI,MAAM,CAAC,OAAO;4BAAE,MAAM,IAAI,CAAC;wBAC/B,OAAO,CAAC,IAAI,CAAC,oDAAoD,EAAE,IAAI,CAAC,CAAC;wBACzE,QAAQ,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;oBACnD,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;gBACxC,IAAI,CAAC;oBACH,QAAQ,GAAG,MAAM,uBAAuB,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;oBAC1E,IAAI,CAAC,QAAQ,CAAC,EAAE;wBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBACrE,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,MAAM,CAAC,OAAO;wBAAE,MAAM,GAAG,CAAC;oBAC9B,OAAO,CAAC,IAAI,CAAC,oDAAoD,EAAE,GAAG,CAAC,CAAC;oBACxE,QAAQ,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxC,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAC9D,mDAAmD;gBACnD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAC;gBACtD,OAAO;YACT,CAAC;YAED,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YAC3C,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;YAE9C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC,CAAC;gBAC7D,OAAO;YACT,CAAC;YAED,4DAA4D;YAC5D,mEAAmE;YACnE,sEAAsE;YACtE,IAAI,cAAc,GAAG,KAAK,CAAC;YAC3B,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,IAAI,CAAC;gBACH,OAAO,IAAI,EAAE,CAAC;oBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;oBAC5C,IAAI,IAAI;wBAAE,MAAM;oBAEhB,IAAI,CAAC,cAAc,EAAE,CAAC;wBACpB,cAAc,GAAG,IAAI,CAAC;wBACtB,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,CAAC;wBACtD,sEAAsE;wBACtE,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,YAAY,MAAM,EAAE,CAAC,CAAC;wBACrD,8CAA8C;wBAC9C,GAAG,CAAC,YAAY,EAAE,CAAC;oBACrB,CAAC;oBAED,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACrC,IAAI,CAAC,WAAW,EAAE,CAAC;wBACjB,8DAA8D;wBAC9D,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;oBACnE,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,SAAS,EAAE,CAAC;gBACnB,6EAA6E;gBAC7E,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAClC,CAAC;oBAAS,CAAC;gBACT,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,CAAC;gBAC7D,mFAAmF;gBACnF,iEAAiE;gBACjE,IAAI,CAAC,cAAc,EAAE,CAAC;oBACpB,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,yBAAyB,OAAO,EAAE,CAAC,CAAC;oBACnE,GAAG,CAAC,YAAY,EAAE,CAAC;gBACrB,CAAC;gBACD,OAAO,CAAC,GAAG,CACT,OAAO,EACP,IAAI,CAAC,SAAS,CAAC;oBACb,QAAQ,EAAE,WAAW;oBACrB,MAAM;oBACN,OAAO;oBACP,OAAO,EAAE,SAAS,CAAC,MAAM;iBAC1B,CAAC,CACH,CAAC;gBACF,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAC;YACxD,CAAC;iBAAM,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;gBAC9B,GAAG,CAAC,GAAG,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import type { SiteConfig } from '@unctad-ai/voice-agent-core';
+import type { Router } from 'express';
+export interface VoiceServerOptions {
+    config: SiteConfig;
+    groqApiKey: string;
+    groqModel?: string;
+    sttProvider?: string;
+    kyutaiSttUrl?: string;
+    ttsProvider?: string;
+    qwen3TtsUrl?: string;
+    chatterboxTurboUrl?: string;
+    cosyVoiceTtsUrl?: string;
+    pocketTtsUrl?: string;
+    resembleApiKey?: string;
+    resembleModel?: string;
+    resembleVoiceUuid?: string;
+}
+export declare function createVoiceRoutes(options: VoiceServerOptions): {
+    chat: (req: import('express').Request, res: import('express').Response) => Promise<void>;
+    stt: Router;
+    tts: Router;
+};
+export { createChatHandler } from './createChatHandler.js';
+export { createSttHandler } from './createSttHandler.js';
+export { createTtsHandler } from './createTtsHandler.js';
+export { buildSystemPrompt } from './systemPrompt.js';
+export { createBuiltinTools } from './builtinTools.js';
+export { buildSynonymMap, fuzzySearch } from './builtinTools.js';
+export type { ClientState } from './systemPrompt.js';
+export type { ChatHandlerOptions } from './createChatHandler.js';
+export type { SttHandlerOptions } from './createSttHandler.js';
+export type { TtsHandlerOptions } from './createTtsHandler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAKtC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG;IAC9D,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,SAAS,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzF,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb,CAMA;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+import { createChatHandler } from './createChatHandler.js';
+import { createSttHandler } from './createSttHandler.js';
+import { createTtsHandler } from './createTtsHandler.js';
+export function createVoiceRoutes(options) {
+    return {
+        chat: createChatHandler(options),
+        stt: createSttHandler(options),
+        tts: createTtsHandler(options),
+    };
+}
+export { createChatHandler } from './createChatHandler.js';
+export { createSttHandler } from './createSttHandler.js';
+export { createTtsHandler } from './createTtsHandler.js';
+export { buildSystemPrompt } from './systemPrompt.js';
+export { createBuiltinTools } from './builtinTools.js';
+export { buildSynonymMap, fuzzySearch } from './builtinTools.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAkBzD,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAK3D,OAAO;QACL,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC;QAChC,GAAG,EAAE,gBAAgB,CAAC,OAAO,CAAC;QAC9B,GAAG,EAAE,gBAAgB,CAAC,OAAO,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/systemPrompt.d.ts

@@ -0,0 +1,25 @@
+import type { SiteConfig } from '@unctad-ai/voice-agent-core';
+export interface ClientState {
+    route?: string;
+    currentService?: {
+        id: string;
+        title: string;
+        category: string;
+    } | null;
+    categories?: Array<{
+        category: string;
+        count: number;
+    }>;
+    uiActions?: Array<{
+        id: string;
+        description: string;
+        category?: string;
+        params?: unknown;
+    }>;
+    formStatus?: {
+        fieldCount: number;
+        groups: string[];
+    } | null;
+}
+export declare function buildSystemPrompt(config: SiteConfig, clientState?: ClientState): string;
+//# sourceMappingURL=systemPrompt.d.ts.map

package/dist/systemPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemPrompt.d.ts","sourceRoot":"","sources":["../src/systemPrompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxE,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC5F,UAAU,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9D;AAqBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,CA6BvF"}

package/dist/systemPrompt.js

@@ -0,0 +1,46 @@
+const BASE_RULES = `RULES:
+1. Two sentences max, under 40 words. Plain spoken English — no markdown, lists, formatting, or bracketed tags like [Awaiting response]. Never use contractions (say "you would" not "you'd", "I am" not "I'm", "do not" not "don't").
+2. Summarize, never enumerate. Say "three categories like investor services and permits" — never list every item.
+3. After a tool call, confirm what you did in one sentence.
+4. Never fabricate information. Never say you lack a capability your tools provide.
+5. Say exactly [SILENT] if the speaker is not addressing you — side conversations, background noise, or filler words. When unsure, choose [SILENT].
+
+PROACTIVE NAVIGATION: When the user asks about a service, call searchServices first. Then call BOTH viewService (to show the page) AND getServiceDetails (to get data you can speak about) — do not call one without the other. When the user wants to APPLY, call startApplication instead of viewService.
+
+TOOL SELECTION: Use searchServices when the user has a specific keyword or service in mind. Use listServicesByCategory when the user wants to BROWSE or see ALL services in a category.
+
+PAGE TYPES:
+- /service/:id pages are INFORMATIONAL — they show overview, requirements, and steps. After viewService, briefly describe the service. Do NOT call getFormSchema or fillFormFields on these pages.
+- /dashboard/* pages MAY have fillable forms. Only call getFormSchema when the user explicitly asks to fill or start an application.
+
+FORMS: When on a /dashboard/* page, ALWAYS call getFormSchema to see what fields are actually visible — NEVER guess or fabricate form content. The schema is the single source of truth for what the user sees. Ask conversationally for a few details at a time — never dump all field names at once. Batch-fill with fillFormFields once you have the information. When getFormSchema returns sections, guide the user through the FIRST section only. More sections appear automatically as the user answers questions — call getFormSchema again to see newly visible fields.
+
+GOODBYE: When the user says goodbye or is done, respond with a warm farewell and append [END_SESSION] at the end. Example: "Happy to help, goodbye! [END_SESSION]"`;
+export function buildSystemPrompt(config, clientState) {
+    // Identity layer — from config
+    let prompt = `You are ${config.copilotName}, a friendly voice assistant for ${config.siteTitle}. ${config.systemPromptIntro} Your name is ${config.copilotName}.\n\n`;
+    // Base rules layer — package-owned
+    prompt += BASE_RULES;
+    // Dynamic context layer — per-request clientState
+    if (!clientState)
+        return prompt;
+    if (clientState.route) {
+        prompt += `\n\nCurrent page: ${clientState.route}`;
+    }
+    if (clientState.currentService) {
+        const s = clientState.currentService;
+        prompt += `\nViewing service: ${s.title} (${s.category}). Call getServiceDetails for full info.`;
+    }
+    if (clientState.categories) {
+        prompt += `\nService categories: ${JSON.stringify(clientState.categories)}`;
+    }
+    if (clientState.uiActions && clientState.uiActions.length > 0) {
+        prompt += `\n\nUI_ACTIONS available on this page:\n${JSON.stringify(clientState.uiActions)}`;
+    }
+    if (clientState.formStatus) {
+        const f = clientState.formStatus;
+        prompt += `\n\nForm: ${f.fieldCount} fields in ${f.groups.length} sections. Call getFormSchema before fillFormFields.`;
+    }
+    return prompt;
+}
+//# sourceMappingURL=systemPrompt.js.map

package/dist/systemPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemPrompt.js","sourceRoot":"","sources":["../src/systemPrompt.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;mKAiBgJ,CAAC;AAEpK,MAAM,UAAU,iBAAiB,CAAC,MAAkB,EAAE,WAAyB;IAC7E,+BAA+B;IAC/B,IAAI,MAAM,GAAG,WAAW,MAAM,CAAC,WAAW,oCAAoC,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,iBAAiB,iBAAiB,MAAM,CAAC,WAAW,OAAO,CAAC;IAEtK,mCAAmC;IACnC,MAAM,IAAI,UAAU,CAAC;IAErB,kDAAkD;IAClD,IAAI,CAAC,WAAW;QAAE,OAAO,MAAM,CAAC;IAEhC,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,qBAAqB,WAAW,CAAC,KAAK,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,WAAW,CAAC,cAAc,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,WAAW,CAAC,cAAc,CAAC;QACrC,MAAM,IAAI,sBAAsB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,QAAQ,0CAA0C,CAAC;IACnG,CAAC;IACD,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAI,yBAAyB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,2CAA2C,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;IAC/F,CAAC;IACD,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC;QACjC,MAAM,IAAI,aAAa,CAAC,CAAC,UAAU,cAAc,CAAC,CAAC,MAAM,CAAC,MAAM,sDAAsD,CAAC;IACzH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@unctad-ai/voice-agent-server",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/unctad-ai/voice-agent-kit.git",
+    "directory": "packages/server"
+  },
+  "dependencies": {
+    "@unctad-ai/voice-agent-core": "0.1.1"
+  },
+  "peerDependencies": {
+    "@ai-sdk/groq": "^3.0.0",
+    "ai": "^6.0.0",
+    "express": ">=5",
+    "zod": "^3.0.0 || ^4.0.0"
+  },
+  "devDependencies": {
+    "@ai-sdk/groq": "^3.0.24",
+    "@types/express": "^5.0.6",
+    "@types/multer": "^2.0.0",
+    "ai": "^6.0.112",
+    "express": "^5.2.1",
+    "groq-sdk": "^0.37.0",
+    "multer": "^2.1.1",
+    "typescript": "^5.9.3",
+    "zod": "^4.3.6"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  }
+}