@getpaseo/server 0.1.2

package/dist/server/server/agent/providers/tool-call-mapper-utils.js

@@ -0,0 +1,119 @@
+export function nonEmptyString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+export function commandFromValue(value) {
+    if (typeof value === "string") {
+        return nonEmptyString(value);
+    }
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const tokens = value.filter((token) => typeof token === "string" && token.length > 0);
+    return tokens.length > 0 ? tokens.join(" ") : undefined;
+}
+const CODEX_SHELL_ENVELOPE_HEADER_LINES = new Set([
+    "chunk id:",
+    "wall time:",
+    "process exited with code",
+    "original token count:",
+]);
+function isCodexShellEnvelopeHeaderLine(line) {
+    const normalized = line.trim().toLowerCase();
+    for (const prefix of CODEX_SHELL_ENVELOPE_HEADER_LINES) {
+        if (normalized.startsWith(prefix)) {
+            return true;
+        }
+    }
+    return false;
+}
+function looksLikeCodexShellEnvelope(lines) {
+    if (lines.length === 0) {
+        return false;
+    }
+    const first = lines[0]?.trim().toLowerCase() ?? "";
+    if (!first.startsWith("chunk id:")) {
+        return false;
+    }
+    const headerWindow = lines.slice(0, 8).map((line) => line.trim().toLowerCase());
+    const hasWallTime = headerWindow.some((line) => line.startsWith("wall time:"));
+    const hasExitCode = headerWindow.some((line) => line.startsWith("process exited with code"));
+    return hasWallTime && hasExitCode;
+}
+export function extractCodexShellOutput(value) {
+    const text = nonEmptyString(value);
+    if (!text) {
+        return undefined;
+    }
+    const normalized = text.replace(/\r\n/g, "\n");
+    const lines = normalized.split("\n");
+    if (!looksLikeCodexShellEnvelope(lines)) {
+        return text;
+    }
+    const outputLineIndex = lines.findIndex((line) => line.trim() === "Output:");
+    if (outputLineIndex >= 0) {
+        return nonEmptyString(lines.slice(outputLineIndex + 1).join("\n"));
+    }
+    let firstBodyLineIndex = -1;
+    for (let index = 1; index < lines.length; index += 1) {
+        const line = lines[index] ?? "";
+        if (!isCodexShellEnvelopeHeaderLine(line)) {
+            firstBodyLineIndex = index;
+            break;
+        }
+    }
+    if (firstBodyLineIndex === -1) {
+        return undefined;
+    }
+    return nonEmptyString(lines.slice(firstBodyLineIndex).join("\n"));
+}
+export function flattenReadContent(value) {
+    if (typeof value === "string") {
+        return nonEmptyString(value);
+    }
+    if (!value) {
+        return undefined;
+    }
+    if (Array.isArray(value)) {
+        const parts = value
+            .map((chunk) => nonEmptyString(chunk.text) ??
+            nonEmptyString(chunk.content) ??
+            nonEmptyString(chunk.output))
+            .filter((part) => typeof part === "string");
+        return parts.length > 0 ? parts.join("\n") : undefined;
+    }
+    return (nonEmptyString(value.text) ??
+        nonEmptyString(value.content) ??
+        nonEmptyString(value.output));
+}
+export function truncateDiffText(text, maxChars = 12000) {
+    if (typeof text !== "string") {
+        return undefined;
+    }
+    if (text.length <= maxChars) {
+        return text;
+    }
+    const truncatedCount = text.length - maxChars;
+    return `${text.slice(0, maxChars)}\n...[truncated ${truncatedCount} chars]`;
+}
+function hashText(value) {
+    let hash = 0;
+    for (let i = 0; i < value.length; i += 1) {
+        hash = (hash << 5) - hash + value.charCodeAt(i);
+        hash |= 0;
+    }
+    return Math.abs(hash).toString(36);
+}
+export function coerceToolCallId(params) {
+    if (typeof params.rawCallId === "string" && params.rawCallId.trim().length > 0) {
+        return params.rawCallId;
+    }
+    let serialized = "";
+    try {
+        serialized = JSON.stringify(params.input) ?? "";
+    }
+    catch {
+        serialized = String(params.input);
+    }
+    return `${params.providerPrefix}-${hashText(`${params.toolName}:${serialized}`)}`;
+}
+//# sourceMappingURL=tool-call-mapper-utils.js.map

package/dist/server/server/agent/providers/tool-call-mapper-utils.js.map

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

package/dist/server/server/agent/recordings-debug.d.ts

@@ -0,0 +1,3 @@
+export declare function isPaseoDictationDebugEnabled(): boolean;
+export declare function resolveRecordingsDebugDir(explicitEnvVarName: string): string | null;
+//# sourceMappingURL=recordings-debug.d.ts.map

package/dist/server/server/agent/recordings-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordings-debug.d.ts","sourceRoot":"","sources":["../../../../src/server/agent/recordings-debug.ts"],"names":[],"mappings":"AAOA,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED,wBAAgB,yBAAyB,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWnF"}

package/dist/server/server/agent/recordings-debug.js

@@ -0,0 +1,19 @@
+import { resolve } from "path";
+function isTruthyEnv(value) {
+    const normalized = (value ?? "").trim().toLowerCase();
+    return normalized === "1" || normalized === "true" || normalized === "yes" || normalized === "on";
+}
+export function isPaseoDictationDebugEnabled() {
+    return isTruthyEnv(process.env.PASEO_DICTATION_DEBUG);
+}
+export function resolveRecordingsDebugDir(explicitEnvVarName) {
+    const explicit = process.env[explicitEnvVarName];
+    if (explicit && explicit.trim()) {
+        return resolve(explicit.trim());
+    }
+    if (!isPaseoDictationDebugEnabled()) {
+        return null;
+    }
+    return resolve(process.cwd(), ".debug/recordings");
+}
+//# sourceMappingURL=recordings-debug.js.map

package/dist/server/server/agent/recordings-debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordings-debug.js","sourceRoot":"","sources":["../../../../src/server/agent/recordings-debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,SAAS,WAAW,CAAC,KAAyB;IAC5C,MAAM,UAAU,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtD,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,IAAI,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,kBAA0B;IAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACjD,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,4BAA4B,EAAE,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,mBAAmB,CAAC,CAAC;AACrD,CAAC"}

package/dist/server/server/agent/stt-debug.d.ts

@@ -0,0 +1,10 @@
+import type pino from "pino";
+export interface DebugAudioMetadata {
+    sessionId: string;
+    agentId?: string;
+    requestId?: string;
+    label?: string;
+    format: string;
+}
+export declare function maybePersistDebugAudio(audio: Buffer, metadata: DebugAudioMetadata, logger: pino.Logger): Promise<string | null>;
+//# sourceMappingURL=stt-debug.d.ts.map

package/dist/server/server/agent/stt-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stt-debug.d.ts","sourceRoot":"","sources":["../../../../src/server/agent/stt-debug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAS7B,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,IAAI,CAAC,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6BxB"}

package/dist/server/server/agent/stt-debug.js

@@ -0,0 +1,33 @@
+import { mkdir, writeFile } from "fs/promises";
+import { join } from "path";
+import { inferAudioExtension, sanitizeForFilename } from "./audio-utils.js";
+import { resolveRecordingsDebugDir } from "./recordings-debug.js";
+const debugDir = resolveRecordingsDebugDir("STT_DEBUG_AUDIO_DIR");
+let announced = false;
+export async function maybePersistDebugAudio(audio, metadata, logger) {
+    if (!debugDir) {
+        return null;
+    }
+    if (!announced) {
+        logger.info({ debugDir }, "Raw audio capture enabled");
+        announced = true;
+    }
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const folder = join(debugDir, sanitizeForFilename(metadata.sessionId, "session"));
+    await mkdir(folder, { recursive: true });
+    const parts = [timestamp];
+    if (metadata.agentId) {
+        parts.push(sanitizeForFilename(metadata.agentId, "agent"));
+    }
+    if (metadata.label) {
+        parts.push(sanitizeForFilename(metadata.label, "source"));
+    }
+    if (metadata.requestId) {
+        parts.push(sanitizeForFilename(metadata.requestId, "request"));
+    }
+    const ext = inferAudioExtension(metadata.format);
+    const filePath = join(folder, `${parts.join("_")}.${ext}`);
+    await writeFile(filePath, audio);
+    return filePath;
+}
+//# sourceMappingURL=stt-debug.js.map

package/dist/server/server/agent/stt-debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stt-debug.js","sourceRoot":"","sources":["../../../../src/server/agent/stt-debug.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,QAAQ,GAAG,yBAAyB,CAAC,qBAAqB,CAAC,CAAC;AAClE,IAAI,SAAS,GAAG,KAAK,CAAC;AAUtB,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAa,EACb,QAA4B,EAC5B,MAAmB;IAEnB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,2BAA2B,CAAC,CAAC;QACvD,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IAClF,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1B,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,GAAG,GAAG,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/server/server/agent/stt-manager.d.ts

@@ -0,0 +1,32 @@
+import type pino from "pino";
+import type { SpeechToTextProvider, TranscriptionResult } from "../speech/speech-provider.js";
+interface TranscriptionMetadata {
+    agentId?: string;
+    requestId?: string;
+    label?: string;
+}
+export interface SessionTranscriptionResult extends TranscriptionResult {
+    debugRecordingPath?: string;
+    byteLength: number;
+    format: string;
+}
+/**
+ * Per-session STT manager
+ * Handles speech-to-text transcription
+ */
+export declare class STTManager {
+    private readonly sessionId;
+    private readonly logger;
+    private readonly stt;
+    constructor(sessionId: string, logger: pino.Logger, stt: SpeechToTextProvider | null);
+    /**
+     * Transcribe audio buffer to text
+     */
+    transcribe(audio: Buffer, format: string, metadata?: TranscriptionMetadata): Promise<SessionTranscriptionResult>;
+    /**
+     * Cleanup (currently no-op, but provides extension point)
+     */
+    cleanup(): void;
+}
+export {};
+//# sourceMappingURL=stt-manager.d.ts.map

package/dist/server/server/agent/stt-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stt-manager.d.ts","sourceRoot":"","sources":["../../../../src/server/agent/stt-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAK9F,UAAU,qBAAqB;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAkBD,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA8B;gBAEtC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,IAAI;IAMpF;;OAEG;IACU,UAAU,CACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,0BAA0B,CAAC;IAiQtC;;OAEG;IACI,OAAO,IAAI,IAAI;CAGvB"}

package/dist/server/server/agent/stt-manager.js

@@ -0,0 +1,231 @@
+import { maybePersistDebugAudio } from "./stt-debug.js";
+import { parsePcm16MonoWav, parsePcmRateFromFormat } from "../speech/audio.js";
+import { Pcm16MonoResampler } from "./pcm16-resampler.js";
+const BATCH_APPEND_CHUNK_SECONDS = 1;
+const DEFAULT_BATCH_COMMIT_EVERY_SECONDS = 15;
+const BATCH_FINAL_TIMEOUT_MS = 120000;
+function resolveBatchCommitEverySeconds() {
+    const fromEnv = process.env.PASEO_STT_BATCH_COMMIT_EVERY_SECONDS;
+    if (!fromEnv) {
+        return DEFAULT_BATCH_COMMIT_EVERY_SECONDS;
+    }
+    const parsed = Number.parseFloat(fromEnv);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return DEFAULT_BATCH_COMMIT_EVERY_SECONDS;
+    }
+    return parsed;
+}
+/**
+ * Per-session STT manager
+ * Handles speech-to-text transcription
+ */
+export class STTManager {
+    constructor(sessionId, logger, stt) {
+        this.sessionId = sessionId;
+        this.logger = logger.child({ module: "agent", component: "stt-manager", sessionId });
+        this.stt = stt;
+    }
+    /**
+     * Transcribe audio buffer to text
+     */
+    async transcribe(audio, format, metadata) {
+        if (!this.stt) {
+            throw new Error("STT not configured");
+        }
+        this.logger.debug({ bytes: audio.length, format, label: metadata?.label }, "Transcribing audio");
+        let debugRecordingPath = null;
+        try {
+            debugRecordingPath = await maybePersistDebugAudio(audio, {
+                sessionId: this.sessionId,
+                agentId: metadata?.agentId,
+                requestId: metadata?.requestId,
+                label: metadata?.label,
+                format,
+            }, this.logger);
+        }
+        catch (error) {
+            this.logger.warn({ err: error }, "Failed to persist debug audio");
+        }
+        const session = this.stt.createSession({
+            logger: this.logger.child({ component: "stt-session" }),
+            language: "en",
+        });
+        let inputRate;
+        let pcm16;
+        if (format.toLowerCase().includes("audio/wav")) {
+            const parsed = parsePcm16MonoWav(audio);
+            inputRate = parsed.sampleRate;
+            pcm16 = parsed.pcm16;
+        }
+        else if (format.toLowerCase().includes("audio/pcm")) {
+            inputRate =
+                parsePcmRateFromFormat(format, session.requiredSampleRate) ??
+                    session.requiredSampleRate;
+            pcm16 = audio;
+        }
+        else {
+            throw new Error(`Unsupported audio format for STT: ${format}`);
+        }
+        let pcmForModel = pcm16;
+        if (inputRate !== session.requiredSampleRate) {
+            const resampler = new Pcm16MonoResampler({
+                inputRate,
+                outputRate: session.requiredSampleRate,
+            });
+            pcmForModel = resampler.processChunk(pcm16);
+            inputRate = session.requiredSampleRate;
+        }
+        try {
+            const startedAt = Date.now();
+            await session.connect();
+            const committedSegmentIds = [];
+            const transcriptsBySegmentId = new Map();
+            const finalTranscriptSegmentIds = new Set();
+            const transcriptMetaBySegmentId = new Map();
+            let expectedFinals = 0;
+            let settle = null;
+            let fail = null;
+            let settled = false;
+            const allFinalsReady = new Promise((resolve, reject) => {
+                settle = resolve;
+                fail = reject;
+            });
+            const resolveIfComplete = () => {
+                if (settled) {
+                    return;
+                }
+                if (expectedFinals > 0 && finalTranscriptSegmentIds.size >= expectedFinals) {
+                    settled = true;
+                    settle?.();
+                    return;
+                }
+                if (expectedFinals === 0 && finalTranscriptSegmentIds.size > 0) {
+                    settled = true;
+                    settle?.();
+                }
+            };
+            const rejectWith = (error) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                fail?.(error);
+            };
+            session.on("error", (error) => {
+                rejectWith(error instanceof Error ? error : new Error(String(error)));
+            });
+            session.on("committed", ({ segmentId }) => {
+                committedSegmentIds.push(segmentId);
+                expectedFinals += 1;
+                resolveIfComplete();
+            });
+            session.on("transcript", (payload) => {
+                transcriptsBySegmentId.set(payload.segmentId, payload.transcript);
+                if (!payload.isFinal) {
+                    return;
+                }
+                finalTranscriptSegmentIds.add(payload.segmentId);
+                transcriptMetaBySegmentId.set(payload.segmentId, {
+                    language: payload.language,
+                    logprobs: payload.logprobs,
+                    avgLogprob: payload.avgLogprob,
+                    isLowConfidence: payload.isLowConfidence,
+                });
+                resolveIfComplete();
+            });
+            const appendChunkBytes = Math.max(1, Math.round(session.requiredSampleRate * 2 * BATCH_APPEND_CHUNK_SECONDS));
+            const commitEverySeconds = resolveBatchCommitEverySeconds();
+            const commitEveryBytes = commitEverySeconds > 0
+                ? Math.max(1, Math.round(session.requiredSampleRate * 2 * commitEverySeconds))
+                : 0;
+            let bytesSinceCommit = 0;
+            for (let offset = 0; offset < pcmForModel.length; offset += appendChunkBytes) {
+                const chunk = pcmForModel.subarray(offset, Math.min(pcmForModel.length, offset + appendChunkBytes));
+                if (chunk.length === 0) {
+                    continue;
+                }
+                session.appendPcm16(chunk);
+                bytesSinceCommit += chunk.length;
+                if (commitEveryBytes > 0 && bytesSinceCommit >= commitEveryBytes) {
+                    session.commit();
+                    bytesSinceCommit = 0;
+                }
+            }
+            if (bytesSinceCommit > 0 || expectedFinals === 0) {
+                session.commit();
+            }
+            const finalTimeout = setTimeout(() => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                this.logger.warn({
+                    expectedFinals,
+                    receivedFinals: finalTranscriptSegmentIds.size,
+                    label: metadata?.label,
+                }, "Timed out waiting for final STT segments; returning available transcripts");
+                settle?.();
+            }, BATCH_FINAL_TIMEOUT_MS);
+            await allFinalsReady;
+            clearTimeout(finalTimeout);
+            const committedSet = new Set(committedSegmentIds);
+            const orderedSegmentIds = [...committedSegmentIds];
+            for (const segmentId of transcriptsBySegmentId.keys()) {
+                if (!committedSet.has(segmentId)) {
+                    orderedSegmentIds.push(segmentId);
+                }
+            }
+            const transcript = orderedSegmentIds
+                .map((segmentId) => transcriptsBySegmentId.get(segmentId) ?? "")
+                .join(" ")
+                .trim();
+            const orderedFinalMeta = orderedSegmentIds
+                .filter((segmentId) => finalTranscriptSegmentIds.has(segmentId))
+                .map((segmentId) => transcriptMetaBySegmentId.get(segmentId))
+                .filter((meta) => Boolean(meta));
+            const language = orderedFinalMeta.find((meta) => meta.language)?.language;
+            const singleSegmentMeta = orderedFinalMeta.length === 1 ? orderedFinalMeta[0] : null;
+            const allLowConfidence = orderedFinalMeta.length > 0 &&
+                orderedFinalMeta.every((meta) => meta.isLowConfidence === true);
+            const result = {
+                text: transcript,
+                ...(language ? { language } : {}),
+                ...(singleSegmentMeta?.logprobs ? { logprobs: singleSegmentMeta.logprobs } : {}),
+                ...(singleSegmentMeta?.avgLogprob !== undefined
+                    ? { avgLogprob: singleSegmentMeta.avgLogprob }
+                    : {}),
+                ...(allLowConfidence ? { isLowConfidence: true } : {}),
+                duration: Date.now() - startedAt,
+            };
+            // Filter out low-confidence transcriptions (non-speech sounds)
+            if (result.isLowConfidence) {
+                this.logger.debug({ text: result.text, avgLogprob: result.avgLogprob }, "Filtered low-confidence transcription (likely non-speech)");
+                // Return empty text to ignore this transcription
+                return {
+                    ...result,
+                    text: "",
+                    byteLength: audio.length,
+                    format,
+                    debugRecordingPath: debugRecordingPath ?? undefined,
+                };
+            }
+            this.logger.debug({ text: result.text, avgLogprob: result.avgLogprob }, "Transcription complete");
+            return {
+                ...result,
+                debugRecordingPath: debugRecordingPath ?? undefined,
+                byteLength: audio.length,
+                format,
+            };
+        }
+        finally {
+            session.close();
+        }
+    }
+    /**
+     * Cleanup (currently no-op, but provides extension point)
+     */
+    cleanup() {
+        // No cleanup needed for STT currently
+    }
+}
+//# sourceMappingURL=stt-manager.js.map

package/dist/server/server/agent/stt-manager.js.map

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

package/dist/server/server/agent/system-prompt.d.ts

@@ -0,0 +1,3 @@
+export declare function loadSystemPrompt(): string;
+export declare function getSystemPrompt(): string;
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/server/server/agent/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../../../src/server/agent/system-prompt.ts"],"names":[],"mappings":"AAQA,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAKD,wBAAgB,eAAe,IAAI,MAAM,CAKxC"}

package/dist/server/server/agent/system-prompt.js

@@ -0,0 +1,19 @@
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import path from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Load system prompt from agent-prompt.md in package root
+export function loadSystemPrompt() {
+    const promptPath = path.join(__dirname, '../../../agent-prompt.md');
+    return readFileSync(promptPath, 'utf-8');
+}
+// Cache the loaded prompt
+let cachedPrompt = null;
+export function getSystemPrompt() {
+    if (!cachedPrompt) {
+        cachedPrompt = loadSystemPrompt();
+    }
+    return cachedPrompt;
+}
+//# sourceMappingURL=system-prompt.js.map

package/dist/server/server/agent/system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../../../src/server/agent/system-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC;IACpE,OAAO,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,0BAA0B;AAC1B,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,gBAAgB,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/server/server/agent/tool-name-normalization.d.ts

@@ -0,0 +1,7 @@
+export declare function normalizeToolName(name: string): string;
+export declare function tokenizeToolName(name: string): string[];
+export declare function getToolLeafName(name: string): string | null;
+export declare function isSpeakToolName(name: string): boolean;
+export declare function isLikelyNamespacedToolName(name: string): boolean;
+export declare function isLikelyExternalToolName(name: string): boolean;
+//# sourceMappingURL=tool-name-normalization.d.ts.map

package/dist/server/server/agent/tool-name-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-name-normalization.d.ts","sourceRoot":"","sources":["../../../../src/server/agent/tool-name-normalization.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAGvD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAkBhE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAS9D"}

package/dist/server/server/agent/tool-name-normalization.js

@@ -0,0 +1,45 @@
+const TOOL_TOKEN_REGEX = /[a-z0-9]+/g;
+const STANDARD_NAMESPACE_SEPARATOR_REGEX = /[.:/]/;
+export function normalizeToolName(name) {
+    return name.trim().toLowerCase();
+}
+export function tokenizeToolName(name) {
+    const normalized = normalizeToolName(name);
+    return normalized.match(TOOL_TOKEN_REGEX) ?? [];
+}
+export function getToolLeafName(name) {
+    const tokens = tokenizeToolName(name);
+    return tokens.length > 0 ? tokens[tokens.length - 1] : null;
+}
+export function isSpeakToolName(name) {
+    return getToolLeafName(name) === "speak";
+}
+export function isLikelyNamespacedToolName(name) {
+    const normalized = normalizeToolName(name);
+    if (STANDARD_NAMESPACE_SEPARATOR_REGEX.test(normalized)) {
+        return true;
+    }
+    if (!normalized.includes("__")) {
+        return false;
+    }
+    // Keep `__` handling strict to avoid false positives on arbitrary custom names.
+    const segments = normalized.split("__").filter((segment) => segment.length > 0);
+    if (segments.length >= 3) {
+        return true;
+    }
+    if (segments.length === 2 && segments[1].includes("_")) {
+        return true;
+    }
+    return false;
+}
+export function isLikelyExternalToolName(name) {
+    const normalized = normalizeToolName(name);
+    if (!normalized) {
+        return false;
+    }
+    if (isSpeakToolName(normalized)) {
+        return true;
+    }
+    return isLikelyNamespacedToolName(normalized);
+}
+//# sourceMappingURL=tool-name-normalization.js.map

package/dist/server/server/agent/tool-name-normalization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-name-normalization.js","sourceRoot":"","sources":["../../../../src/server/agent/tool-name-normalization.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,YAAY,CAAC;AACtC,MAAM,kCAAkC,GAAG,OAAO,CAAC;AAEnD,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,UAAU,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,kCAAkC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gFAAgF;IAChF,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChF,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,0BAA0B,CAAC,UAAU,CAAC,CAAC;AAChD,CAAC"}

package/dist/server/server/agent/tts-debug.d.ts

@@ -0,0 +1,8 @@
+import type pino from "pino";
+export interface TtsDebugAudioMetadata {
+    sessionId: string;
+    groupId: string;
+    format: string;
+}
+export declare function maybePersistTtsDebugAudio(audio: Buffer, metadata: TtsDebugAudioMetadata, logger: pino.Logger): Promise<string | null>;
+//# sourceMappingURL=tts-debug.d.ts.map

package/dist/server/server/agent/tts-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts-debug.d.ts","sourceRoot":"","sources":["../../../../src/server/agent/tts-debug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAS7B,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,qBAAqB,EAC/B,MAAM,EAAE,IAAI,CAAC,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBxB"}

package/dist/server/server/agent/tts-debug.js

@@ -0,0 +1,24 @@
+import { mkdir, writeFile } from "fs/promises";
+import { join } from "path";
+import { inferAudioExtension, sanitizeForFilename } from "./audio-utils.js";
+import { resolveRecordingsDebugDir } from "./recordings-debug.js";
+const debugDir = resolveRecordingsDebugDir("TTS_DEBUG_AUDIO_DIR");
+let announced = false;
+export async function maybePersistTtsDebugAudio(audio, metadata, logger) {
+    if (!debugDir) {
+        return null;
+    }
+    if (!announced) {
+        logger.info({ debugDir }, "TTS audio capture enabled");
+        announced = true;
+    }
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const folder = join(debugDir, sanitizeForFilename(metadata.sessionId, "session"));
+    await mkdir(folder, { recursive: true });
+    const parts = [timestamp, sanitizeForFilename(metadata.groupId, "tts")];
+    const ext = inferAudioExtension(metadata.format);
+    const filePath = join(folder, `${parts.join("_")}.${ext}`);
+    await writeFile(filePath, audio);
+    return filePath;
+}
+//# sourceMappingURL=tts-debug.js.map

package/dist/server/server/agent/tts-debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts-debug.js","sourceRoot":"","sources":["../../../../src/server/agent/tts-debug.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,QAAQ,GAAG,yBAAyB,CAAC,qBAAqB,CAAC,CAAC;AAClE,IAAI,SAAS,GAAG,KAAK,CAAC;AAQtB,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAAa,EACb,QAA+B,EAC/B,MAAmB;IAEnB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,2BAA2B,CAAC,CAAC;QACvD,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IAClF,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,MAAM,KAAK,GAAG,CAAC,SAAS,EAAE,mBAAmB,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC;AAClB,CAAC"}