@markusylisiurunen/tau 0.3.50 → 0.3.51

package/dist/core/telegram/tts.js

@@ -0,0 +1,137 @@
+import { mkdtemp, readdir, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { GEMINI_SPEECH_PLAYBACK_RATE, streamGeminiSpeechAudio } from "../utils/gemini_speech.js";
+import { spawnWithCapture } from "../utils/spawn_capture.js";
+const TELEGRAM_TTS_TEMP_DIR_PREFIX = "tau-telegram-tts-";
+const TELEGRAM_TTS_CONVERSION_TIMEOUT_MS = 120_000;
+const WAVE_HEADER_BYTES = 44;
+export async function sweepStaleTelegramTtsTempDirs() {
+    const systemTmpDir = tmpdir();
+    try {
+        const entries = await readdir(systemTmpDir, { withFileTypes: true, encoding: "utf8" });
+        await Promise.allSettled(entries
+            .filter((entry) => entry.isDirectory() && entry.name.startsWith(TELEGRAM_TTS_TEMP_DIR_PREFIX))
+            .map(async (entry) => await rm(join(systemTmpDir, entry.name), { recursive: true, force: true })));
+    }
+    catch {
+        return;
+    }
+}
+export async function generateTelegramVoice(options) {
+    const streamSpeechAudio = options.deps?.streamSpeechAudio ?? streamGeminiSpeechAudio;
+    const spawn = options.deps?.spawn ?? spawnWithCapture;
+    const temporaryDirectory = await mkdtemp(join(tmpdir(), TELEGRAM_TTS_TEMP_DIR_PREFIX));
+    const manifestPath = join(temporaryDirectory, "speech.ffconcat");
+    const outputPath = join(temporaryDirectory, "speech.ogg");
+    try {
+        const chunkNames = [];
+        let waveFormat;
+        for await (const chunk of streamSpeechAudio({
+            apiKey: options.apiKey,
+            sourceText: options.sourceText,
+            deliveryMode: "complete",
+            fetchImpl: options.fetchImpl,
+            signal: options.signal,
+        })) {
+            const header = parseWaveHeader(chunk.audio);
+            if (waveFormat && !header.format.equals(waveFormat)) {
+                throw new Error("Gemini TTS returned incompatible audio chunks");
+            }
+            waveFormat ??= Buffer.from(header.format);
+            const chunkName = `chunk-${String(chunkNames.length).padStart(3, "0")}.wav`;
+            await writeFile(join(temporaryDirectory, chunkName), chunk.audio.subarray(0, WAVE_HEADER_BYTES + header.dataBytes));
+            chunkNames.push(chunkName);
+        }
+        if (chunkNames.length === 0) {
+            throw new Error("Gemini TTS returned no audio");
+        }
+        await writeFile(manifestPath, `ffconcat version 1.0\n${chunkNames.map((name) => `file '${name}'`).join("\n")}\n`, "utf8");
+        const result = await spawn("ffmpeg", [
+            "-nostdin",
+            "-hide_banner",
+            "-loglevel",
+            "error",
+            "-y",
+            "-f",
+            "concat",
+            "-safe",
+            "1",
+            "-i",
+            "speech.ffconcat",
+            "-filter:a",
+            `atempo=${GEMINI_SPEECH_PLAYBACK_RATE}`,
+            "-c:a",
+            "libopus",
+            "-b:a",
+            "48k",
+            "-vbr",
+            "on",
+            "-application",
+            "voip",
+            "speech.ogg",
+        ], {
+            cwd: temporaryDirectory,
+            detached: true,
+            killProcessGroup: true,
+            signal: options.signal,
+            timeoutMs: TELEGRAM_TTS_CONVERSION_TIMEOUT_MS,
+            maxCaptureBytes: 20_000,
+        });
+        if (result.aborted || options.signal?.aborted) {
+            throw abortError();
+        }
+        if (result.timedOut) {
+            throw new Error("ffmpeg timed out while encoding Telegram voice audio");
+        }
+        if (result.exitCode !== 0) {
+            const detail = result.stderr.trim();
+            throw new Error(detail
+                ? `ffmpeg failed to encode Telegram voice audio: ${detail}`
+                : `ffmpeg exited with code ${result.exitCode ?? "unknown"}`);
+        }
+        const voice = await readFile(outputPath);
+        if (voice.length === 0) {
+            throw new Error("ffmpeg produced empty Telegram voice audio");
+        }
+        return voice;
+    }
+    catch (error) {
+        if (isMissingExecutableError(error)) {
+            throw new Error("ffmpeg is required to encode Telegram voice notes");
+        }
+        throw error;
+    }
+    finally {
+        await rm(temporaryDirectory, { recursive: true, force: true });
+    }
+}
+function parseWaveHeader(audio) {
+    if (audio.length < WAVE_HEADER_BYTES ||
+        audio.toString("ascii", 0, 4) !== "RIFF" ||
+        audio.toString("ascii", 8, 12) !== "WAVE" ||
+        audio.toString("ascii", 12, 16) !== "fmt " ||
+        audio.toString("ascii", 36, 40) !== "data") {
+        throw new Error("Gemini TTS returned invalid WAV audio");
+    }
+    const dataBytes = audio.readUInt32LE(40);
+    if (dataBytes > audio.length - WAVE_HEADER_BYTES) {
+        throw new Error("Gemini TTS returned truncated WAV audio");
+    }
+    return {
+        format: audio.subarray(20, 36),
+        dataBytes,
+    };
+}
+function isMissingExecutableError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+function abortError() {
+    const error = new Error("Telegram TTS was aborted");
+    error.name = "AbortError";
+    return error;
+}
+//# sourceMappingURL=tts.js.map

package/dist/core/telegram/tts.js.map

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

package/dist/core/tools/presentation.js

@@ -1,6 +1,8 @@
 import { z } from "zod";
+import { SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_BYTES, SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_DETAIL_BYTES, SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_DETAILS, SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_LABEL_BYTES, SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_METADATA, SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_METADATA_VALUE_BYTES, SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_SUBJECT_BYTES, } from "../../protocol/session_protocol.js";
 import { TOOL_NAME_BASH, TOOL_NAME_EDIT, TOOL_NAME_HISTORY, TOOL_NAME_INTERRUPT_AGENT, TOOL_NAME_LIST_AGENTS, TOOL_NAME_NOOK, TOOL_NAME_SEND_INPUT_TO_AGENT, TOOL_NAME_SPAWN_AGENT, TOOL_NAME_TAU_DOCS, TOOL_NAME_VIEW_IMAGE, TOOL_NAME_WAIT_FOR_AGENTS, TOOL_NAME_WEB, TOOL_NAME_WRITE, } from "./tool_names.js";
 export const TOOL_UI_FACET_VERSION = 3;
+export const TOOL_RUN_PRESENTATION_MAX_BYTES = SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_BYTES * 2;
 export const TOOL_CARD_SUBJECT_MAX_LINES = 8;
 export const TOOL_CARD_DEFAULT_DETAILS_MAX_LINES = 7;
 export const TOOL_CARD_TRUNCATED_DETAILS_MAX_LINES = 33;
@@ -8,15 +10,18 @@ export const TOOL_CARD_MAX_LINE_CHARS = 512;
 function isSingleLine(text) {
     return !text.includes("\n") && !text.includes("\r");
 }
-function isBoundedLine(text) {
-    return isSingleLine(text) && Array.from(text).length <= TOOL_CARD_MAX_LINE_CHARS;
+function utf8ByteLength(text) {
+    return Buffer.byteLength(text, "utf8");
 }
 const singleLineSchema = z.string().refine(isSingleLine, "must be one line");
-const boundedLineSchema = z.string().refine(isBoundedLine, "must be one bounded line");
-const boundedLabelSchema = boundedLineSchema.min(1);
+const boundedLabelSchema = singleLineSchema
+    .min(1)
+    .refine((value) => utf8ByteLength(value) <= SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_LABEL_BYTES, `must not exceed ${SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_LABEL_BYTES} UTF-8 bytes`);
+const boundedDetailSchema = singleLineSchema.refine((value) => utf8ByteLength(value) <= SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_DETAIL_BYTES, `must not exceed ${SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_DETAIL_BYTES} UTF-8 bytes`);
+const boundedMetadataSchema = singleLineSchema.refine((value) => utf8ByteLength(value) <= SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_METADATA_VALUE_BYTES, `must not exceed ${SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_METADATA_VALUE_BYTES} UTF-8 bytes`);
 const toolCardLineSchema = z
     .object({
-    text: singleLineSchema,
+    text: boundedDetailSchema,
     tone: z.enum(["added", "removed"]).optional(),
     wrap: z.enum(["word", "character"]),
 })
@@ -38,15 +43,16 @@ const toolRunPresentationSchema = z
     subject: z
         .string()
         .min(1)
-        .refine((subject) => {
-        const lines = subject.split("\n");
-        return lines.length <= TOOL_CARD_SUBJECT_MAX_LINES && lines.every(isBoundedLine);
-    }, "must contain only bounded lines"),
+        .refine((value) => !value.includes("\r"), "must not contain carriage returns")
+        .refine((value) => utf8ByteLength(value) <= SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_SUBJECT_BYTES, `must not exceed ${SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_SUBJECT_BYTES} UTF-8 bytes`),
     subjectWrap: z.enum(["word", "character"]),
-    details: z.array(toolCardLineSchema),
-    metadata: z.array(boundedLineSchema),
+    details: z.array(toolCardLineSchema).max(SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_DETAILS),
+    metadata: z
+        .array(boundedMetadataSchema)
+        .max(SESSION_PROTOCOL_MAX_CLIENT_TOOL_PRESENTATION_METADATA),
 })
-    .strict();
+    .strict()
+    .refine((value) => utf8ByteLength(JSON.stringify(value)) <= TOOL_RUN_PRESENTATION_MAX_BYTES, `must not exceed ${TOOL_RUN_PRESENTATION_MAX_BYTES} UTF-8 bytes`);
 const GENERIC_TOOL_RUN_ACTION_LABELS = {
     preparing: "preparing",
     queued: "queued",
@@ -188,9 +194,41 @@ function truncateLines(lines, maxLines, maxLineChars, strategy = "middle") {
             text: truncateLine(`…${omitted} more ${omitted === 1 ? "line" : "lines"}…`, maxLineChars),
             wrap: "word",
         },
-        ...bounded.slice(-tailCount),
+        ...(tailCount > 0 ? bounded.slice(-tailCount) : []),
     ];
 }
+export function truncateToolText(text, options) {
+    if (!Number.isInteger(options.maxLines) || options.maxLines < 1) {
+        throw new Error("text maxLines must be a positive integer");
+    }
+    if (!Number.isInteger(options.maxLineChars) || options.maxLineChars < 1) {
+        throw new Error("text maxLineChars must be a positive integer");
+    }
+    return truncateLines(text
+        .replace(/\r\n?/g, "\n")
+        .replace(/\n+$/, "")
+        .split("\n")
+        .map((line) => ({ text: line, wrap: "word" })), options.maxLines, options.maxLineChars, options.strategy)
+        .map((line) => line.text)
+        .join("\n");
+}
+export function truncateToolRunSubject(subject, options = {}) {
+    const maxLines = options.maxLines ?? TOOL_CARD_SUBJECT_MAX_LINES;
+    const maxLineChars = options.maxLineChars ?? TOOL_CARD_MAX_LINE_CHARS;
+    if (!Number.isInteger(maxLines) || maxLines < 1 || maxLines > TOOL_CARD_SUBJECT_MAX_LINES) {
+        throw new Error(`subject maxLines must be between 1 and ${TOOL_CARD_SUBJECT_MAX_LINES}`);
+    }
+    if (!Number.isInteger(maxLineChars) ||
+        maxLineChars < 1 ||
+        maxLineChars > TOOL_CARD_MAX_LINE_CHARS) {
+        throw new Error(`subject maxLineChars must be between 1 and ${TOOL_CARD_MAX_LINE_CHARS}`);
+    }
+    return truncateToolText(subject, {
+        maxLines,
+        maxLineChars,
+        strategy: options.strategy,
+    });
+}
 export function parseToolRunPresentation(value) {
     return toolRunPresentationSchema.parse(value);
 }
@@ -210,10 +248,10 @@ const CHARACTER_WRAPPED_SUBJECT_TOOLS = new Set([
     TOOL_NAME_VIEW_IMAGE,
 ]);
 export function buildToolRunPresentation(args) {
-    const subjectLines = args.subject.replace(/\r\n?/g, "\n").replace(/\n+$/, "").split("\n");
-    const boundedSubject = truncateLines(subjectLines.map((text) => ({ text, wrap: "word" })), TOOL_CARD_SUBJECT_MAX_LINES, TOOL_CARD_MAX_LINE_CHARS)
-        .map((line) => line.text)
-        .join("\n");
+    const normalizedSubject = args.subject.replace(/\r\n?/g, "\n").replace(/\n+$/, "");
+    const boundedSubject = args.subjectTruncation === false
+        ? normalizedSubject
+        : truncateToolRunSubject(normalizedSubject, args.subjectTruncation);
     const labels = { ...getToolRunActionLabels(args.toolName), ...args.actionOverrides };
     for (const status of Object.keys(labels)) {
         labels[status] = normalizeLabel(labels[status]) || GENERIC_TOOL_RUN_ACTION_LABELS[status];

package/dist/core/tools/presentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"presentation.js","sourceRoot":"","sources":["../../../src/core/tools/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,cAAc,EACd,6BAA6B,EAC7B,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,EACb,eAAe,GAChB,MAAM,iBAAiB,CAAC;AA0CzB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,qCAAqC,GAAG,EAAE,CAAC;AACxD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,wBAAwB,CAAC;AACnF,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;AAC7E,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,0BAA0B,CAAC,CAAC;AACvF,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEpD,MAAM,kBAAkB,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,yBAAyB,GAAmC,CAAC;KAChE,MAAM,CAAC;IACN,cAAc,EAAE,CAAC;SACd,MAAM,CAAC;QACN,SAAS,EAAE,kBAAkB;QAC7B,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,kBAAkB;QAC3B,SAAS,EAAE,kBAAkB;QAC7B,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,kBAAkB;QAC3B,SAAS,EAAE,kBAAkB;KAC9B,CAAC;SACD,MAAM,EAAE;IACX,SAAS,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACxC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QAClB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,MAAM,IAAI,2BAA2B,IAAI,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACnF,CAAC,EAAE,iCAAiC,CAAC;IACvC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;CACrC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,8BAA8B,GAAwB;IAC1D,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACvB,CAAC;AAEF,MAAM,sBAAsB,GAAwC;IAClE,CAAC,cAAc,CAAC,EAAE;QAChB,GAAG,8BAA8B;QACjC,SAAS,EAAE,KAAK;KACjB;IACD,CAAC,eAAe,CAAC,EAAE;QACjB,GAAG,8BAA8B;QACjC,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,OAAO;QAClB,MAAM,EAAE,iBAAiB;QACzB,OAAO,EAAE,eAAe;QACxB,SAAS,EAAE,iBAAiB;KAC7B;IACD,CAAC,cAAc,CAAC,EAAE;QAChB,GAAG,8BAA8B;QACjC,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,gBAAgB;KAC5B;IACD,CAAC,oBAAoB,CAAC,EAAE;QACtB,GAAG,8BAA8B;QACjC,MAAM,EAAE,mBAAmB;QAC3B,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,sBAAsB;KAClC;IACD,CAAC,qBAAqB,CAAC,EAAE;QACvB,GAAG,8BAA8B;QACjC,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,eAAe;QACxB,SAAS,EAAE,iBAAiB;KAC7B;IACD,CAAC,6BAA6B,CAAC,EAAE;QAC/B,GAAG,8BAA8B;QACjC,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,eAAe;QACxB,SAAS,EAAE,YAAY;QACvB,MAAM,EAAE,sBAAsB;QAC9B,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,sBAAsB;KAClC;IACD,CAAC,yBAAyB,CAAC,EAAE;QAC3B,GAAG,8BAA8B;QACjC,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,kBAAkB;QAC7B,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,gBAAgB;KAC5B;IACD,CAAC,qBAAqB,CAAC,EAAE;QACvB,GAAG,8BAA8B;QACjC,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,gBAAgB;KAC5B;IACD,CAAC,yBAAyB,CAAC,EAAE;QAC3B,GAAG,8BAA8B;QACjC,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,aAAa;QACxB,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,sBAAsB;QAC/B,SAAS,EAAE,wBAAwB;KACpC;IACD,CAAC,kBAAkB,CAAC,EAAE;QACpB,GAAG,8BAA8B;QACjC,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,WAAW;QACtB,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,qBAAqB;KACjC;CACF,CAAC;AAEF,SAAS,YAAY,CAAC,IAAY,EAAE,QAAgB;IAClD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,UAAU,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC;AAC1D,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,wBAAwB,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,IAAI,EAAE,GAAG,MAAM;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;AACrC,CAAC;AAED,SAAS,aAAa,CACpB,KAAqB,EACrB,QAAgB,EAChB,YAAoB,EACpB,QAAQ,GAAsB,QAAQ;IAEtC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnC,GAAG,IAAI;QACP,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;KAC5C,CAAC,CAAC,CAAC;IACJ,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC;IAE/C,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;QAC3C,OAAO;YACL,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;YAC9B;gBACE,IAAI,EAAE,YAAY,CAAC,IAAI,OAAO,SAAS,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,YAAY,CAAC;gBACzF,IAAI,EAAE,MAAM;aACb;SACF,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACvD,OAAO;QACL,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;QAC9B;YACE,IAAI,EAAE,YAAY,CAAC,IAAI,OAAO,SAAS,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,YAAY,CAAC;YACzF,IAAI,EAAE,MAAM;SACb;QACD,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,yBAAyB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,QAAQ,CAAC;QACpD,CAAC,CAAC,CAAC,sBAAsB,CAAC,QAAQ,CAAC,IAAI,8BAA8B,CAAC;QACtE,CAAC,CAAC,8BAA8B,CAAC;AACrC,CAAC;AAED,MAAM,+BAA+B,GAAG,IAAI,GAAG,CAAC;IAC9C,cAAc;IACd,kBAAkB;IAClB,aAAa;IACb,iBAAiB;IACjB,cAAc;IACd,eAAe;IACf,cAAc;IACd,oBAAoB;CACrB,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CAAC,IASxC;IACC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1F,MAAM,cAAc,GAAG,aAAa,CAClC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,EACpD,2BAA2B,EAC3B,wBAAwB,CACzB;SACE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,MAAM,GAAG,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;IACrF,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAgC,EAAE,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,8BAA8B,CAAC,MAAM,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACpD,IAAI,CAAC,IAAI;SACN,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;SACvB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC,CACjE,CAAC;IACF,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI;QAChD,QAAQ,EAAE,mCAAmC;QAC7C,YAAY,EAAE,wBAAwB;QACtC,QAAQ,EAAE,QAAQ;KACnB,CAAC;IACF,IAAI,gBAAgB,KAAK,KAAK,EAAE,CAAC;QAC/B,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC;YAC5C,gBAAgB,CAAC,QAAQ,GAAG,CAAC;YAC7B,gBAAgB,CAAC,QAAQ,GAAG,qCAAqC,EACjE,CAAC;YACD,MAAM,IAAI,KAAK,CACb,yCAAyC,qCAAqC,EAAE,CACjF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,YAAY,CAAC,IAAI,gBAAgB,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YAC1F,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,MAAM,cAAc,GAClB,gBAAgB,KAAK,KAAK;QACxB,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,aAAa,CACX,OAAO,EACP,gBAAgB,CAAC,QAAQ,EACzB,gBAAgB,CAAC,YAAY,EAC7B,gBAAgB,CAAC,QAAQ,CAC1B,CAAC;IAER,OAAO,wBAAwB,CAAC;QAC9B,cAAc,EAAE,MAAM;QACtB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,EAAE,cAAc,IAAI,IAAI,CAAC,QAAQ;QACxC,WAAW,EACT,IAAI,CAAC,WAAW;YAChB,CAAC,+BAA+B,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7E,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;KACtF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"presentation.js","sourceRoot":"","sources":["../../../src/core/tools/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,mDAAmD,EACnD,0DAA0D,EAC1D,qDAAqD,EACrD,yDAAyD,EACzD,sDAAsD,EACtD,kEAAkE,EAClE,2DAA2D,GAC5D,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,cAAc,EACd,6BAA6B,EAC7B,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,aAAa,EACb,eAAe,GAChB,MAAM,iBAAiB,CAAC;AA0CzB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,+BAA+B,GAC1C,mDAAmD,GAAG,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,qCAAqC,GAAG,EAAE,CAAC;AACxD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAc5C,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;AAC7E,MAAM,kBAAkB,GAAG,gBAAgB;KACxC,GAAG,CAAC,CAAC,CAAC;KACN,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,yDAAyD,EAC7F,mBAAmB,yDAAyD,cAAc,CAC3F,CAAC;AACJ,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,MAAM,CACjD,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,0DAA0D,EAC9F,mBAAmB,0DAA0D,cAAc,CAC5F,CAAC;AACF,MAAM,qBAAqB,GAAG,gBAAgB,CAAC,MAAM,CACnD,CAAC,KAAK,EAAE,EAAE,CACR,cAAc,CAAC,KAAK,CAAC,IAAI,kEAAkE,EAC7F,mBAAmB,kEAAkE,cAAc,CACpG,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,yBAAyB,GAAmC,CAAC;KAChE,MAAM,CAAC;IACN,cAAc,EAAE,CAAC;SACd,MAAM,CAAC;QACN,SAAS,EAAE,kBAAkB;QAC7B,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,kBAAkB;QAC3B,SAAS,EAAE,kBAAkB;QAC7B,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,kBAAkB;QAC3B,SAAS,EAAE,kBAAkB;KAC9B,CAAC;SACD,MAAM,EAAE;IACX,SAAS,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACxC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,mCAAmC,CAAC;SAC7E,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,cAAc,CAAC,KAAK,CAAC,IAAI,2DAA2D,EACtF,mBAAmB,2DAA2D,cAAc,CAC7F;IACH,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,qDAAqD,CAAC;IAC/F,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,qBAAqB,CAAC;SAC5B,GAAG,CAAC,sDAAsD,CAAC;CAC/D,CAAC;KACD,MAAM,EAAE;KACR,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,+BAA+B,EACnF,mBAAmB,+BAA+B,cAAc,CACjE,CAAC;AAEJ,MAAM,8BAA8B,GAAwB;IAC1D,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACvB,CAAC;AAEF,MAAM,sBAAsB,GAAwC;IAClE,CAAC,cAAc,CAAC,EAAE;QAChB,GAAG,8BAA8B;QACjC,SAAS,EAAE,KAAK;KACjB;IACD,CAAC,eAAe,CAAC,EAAE;QACjB,GAAG,8BAA8B;QACjC,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,OAAO;QAClB,MAAM,EAAE,iBAAiB;QACzB,OAAO,EAAE,eAAe;QACxB,SAAS,EAAE,iBAAiB;KAC7B;IACD,CAAC,cAAc,CAAC,EAAE;QAChB,GAAG,8BAA8B;QACjC,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,gBAAgB;KAC5B;IACD,CAAC,oBAAoB,CAAC,EAAE;QACtB,GAAG,8BAA8B;QACjC,MAAM,EAAE,mBAAmB;QAC3B,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,sBAAsB;KAClC;IACD,CAAC,qBAAqB,CAAC,EAAE;QACvB,GAAG,8BAA8B;QACjC,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,UAAU;QACnB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,eAAe;QACxB,SAAS,EAAE,iBAAiB;KAC7B;IACD,CAAC,6BAA6B,CAAC,EAAE;QAC/B,GAAG,8BAA8B;QACjC,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,eAAe;QACxB,SAAS,EAAE,YAAY;QACvB,MAAM,EAAE,sBAAsB;QAC9B,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,sBAAsB;KAClC;IACD,CAAC,yBAAyB,CAAC,EAAE;QAC3B,GAAG,8BAA8B;QACjC,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,kBAAkB;QAC7B,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,gBAAgB;KAC5B;IACD,CAAC,qBAAqB,CAAC,EAAE;QACvB,GAAG,8BAA8B;QACjC,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,gBAAgB;KAC5B;IACD,CAAC,yBAAyB,CAAC,EAAE;QAC3B,GAAG,8BAA8B;QACjC,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,aAAa;QACxB,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,sBAAsB;QAC/B,SAAS,EAAE,wBAAwB;KACpC;IACD,CAAC,kBAAkB,CAAC,EAAE;QACpB,GAAG,8BAA8B;QACjC,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,WAAW;QACtB,MAAM,EAAE,qBAAqB;QAC7B,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,qBAAqB;KACjC;CACF,CAAC;AAEF,SAAS,YAAY,CAAC,IAAY,EAAE,QAAgB;IAClD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,UAAU,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/C,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC;AAC1D,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,wBAAwB,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,IAAI,EAAE,GAAG,MAAM;QAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;AACrC,CAAC;AAED,SAAS,aAAa,CACpB,KAAqB,EACrB,QAAgB,EAChB,YAAoB,EACpB,QAAQ,GAAsB,QAAQ;IAEtC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACnC,GAAG,IAAI;QACP,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC;KAC5C,CAAC,CAAC,CAAC;IACJ,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC;IAE/C,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;QAC3C,OAAO;YACL,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;YAC9B;gBACE,IAAI,EAAE,YAAY,CAAC,IAAI,OAAO,SAAS,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,YAAY,CAAC;gBACzF,IAAI,EAAE,MAAM;aACb;SACF,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACvD,OAAO;QACL,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;QAC9B;YACE,IAAI,EAAE,YAAY,CAAC,IAAI,OAAO,SAAS,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,YAAY,CAAC;YACzF,IAAI,EAAE,MAAM;SACb;QACD,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,OAA2B;IACxE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,aAAa,CAClB,IAAI;SACD,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;SACvB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,EAChD,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,QAAQ,CACjB;SACE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,OAAO,GAA8B,EAAE;IAEvC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,2BAA2B,CAAC;IACjE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,wBAAwB,CAAC;IACtE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,2BAA2B,EAAE,CAAC;QAC1F,MAAM,IAAI,KAAK,CAAC,0CAA0C,2BAA2B,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC;QAC/B,YAAY,GAAG,CAAC;QAChB,YAAY,GAAG,wBAAwB,EACvC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8CAA8C,wBAAwB,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,OAAO,gBAAgB,CAAC,OAAO,EAAE;QAC/B,QAAQ;QACR,YAAY;QACZ,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,yBAAyB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,QAAQ,CAAC;QACpD,CAAC,CAAC,CAAC,sBAAsB,CAAC,QAAQ,CAAC,IAAI,8BAA8B,CAAC;QACtE,CAAC,CAAC,8BAA8B,CAAC;AACrC,CAAC;AAED,MAAM,+BAA+B,GAAG,IAAI,GAAG,CAAC;IAC9C,cAAc;IACd,kBAAkB;IAClB,aAAa;IACb,iBAAiB;IACjB,cAAc;IACd,eAAe;IACf,cAAc;IACd,oBAAoB;CACrB,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CAAC,IAUxC;IACC,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnF,MAAM,cAAc,GAClB,IAAI,CAAC,iBAAiB,KAAK,KAAK;QAC9B,CAAC,CAAC,iBAAiB;QACnB,CAAC,CAAC,sBAAsB,CAAC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,EAAE,GAAG,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;IACrF,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAgC,EAAE,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,8BAA8B,CAAC,MAAM,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACpD,IAAI,CAAC,IAAI;SACN,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;SACvB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC,CACjE,CAAC;IACF,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI;QAChD,QAAQ,EAAE,mCAAmC;QAC7C,YAAY,EAAE,wBAAwB;QACtC,QAAQ,EAAE,QAAQ;KACnB,CAAC;IACF,IAAI,gBAAgB,KAAK,KAAK,EAAE,CAAC;QAC/B,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC;YAC5C,gBAAgB,CAAC,QAAQ,GAAG,CAAC;YAC7B,gBAAgB,CAAC,QAAQ,GAAG,qCAAqC,EACjE,CAAC;YACD,MAAM,IAAI,KAAK,CACb,yCAAyC,qCAAqC,EAAE,CACjF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,YAAY,CAAC,IAAI,gBAAgB,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YAC1F,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,MAAM,cAAc,GAClB,gBAAgB,KAAK,KAAK;QACxB,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,aAAa,CACX,OAAO,EACP,gBAAgB,CAAC,QAAQ,EACzB,gBAAgB,CAAC,YAAY,EAC7B,gBAAgB,CAAC,QAAQ,CAC1B,CAAC;IAER,OAAO,wBAAwB,CAAC;QAC9B,cAAc,EAAE,MAAM;QACtB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,EAAE,cAAc,IAAI,IAAI,CAAC,QAAQ;QACxC,WAAW,EACT,IAAI,CAAC,WAAW;YAChB,CAAC,+BAA+B,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7E,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;KACtF,CAAC,CAAC;AACL,CAAC"}

package/dist/core/utils/gemini_speech.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 const GEMINI_GENERATE_CONTENT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta/models";
+export const GEMINI_SPEECH_PLAYBACK_RATE = 1.1;
 const DEFAULT_GEMINI_SPEECH_REWRITE_MODEL = "gemini-3.6-flash";
 const DEFAULT_GEMINI_SPEECH_REWRITE_THINKING_LEVEL = "minimal";
 const DEFAULT_GEMINI_SPEECH_TTS_MODEL = "gemini-3.1-flash-tts-preview";
@@ -8,8 +9,15 @@ const DEFAULT_TTS_SAMPLE_RATE_HZ = 24000;
 const DEFAULT_TTS_CHANNEL_COUNT = 1;
 const DEFAULT_TTS_BITS_PER_SAMPLE = 16;
 const DEFAULT_TTS_MAX_ATTEMPTS = 3;
-const DEFAULT_TTS_CONCURRENCY = 6;
-const MIN_SPEECH_CHUNK_CHARACTERS = 240;
+const SPEECH_REWRITE_TIMEOUT_MS = 60_000;
+const PROGRESSIVE_TTS_CONCURRENCY = 6;
+const COMPLETE_TTS_CONCURRENCY = 3;
+const PROGRESSIVE_SPEECH_CHUNK_CHARACTERS = 500;
+const COMPLETE_SPEECH_CHUNK_CHARACTERS = 1000;
+const MAX_SPEECH_SOURCE_CHARACTERS = 10_000;
+const MAX_SPOKEN_TEXT_CHARACTERS = 10_000;
+const MAX_SPEECH_PCM_BYTES = 32 * 1024 * 1024;
+const TTS_MAX_OUTPUT_TOKENS = 8192;
 const RETRYABLE_TTS_STATUS_CODES = new Set([408, 429, 500, 502, 503, 504]);
 const errorPayloadSchema = z.object({
     error: z
@@ -34,11 +42,20 @@ class GeminiTtsResponseError extends Error {
         this.name = "GeminiTtsResponseError";
     }
 }
+class GeminiTtsOutputLimitError extends Error {
+    constructor() {
+        super("Gemini TTS reached its output token limit");
+        this.name = "GeminiTtsOutputLimitError";
+    }
+}
 export async function* streamGeminiSpeechAudio(options) {
     const sourceText = options.sourceText.trim();
     if (!sourceText) {
         throw new Error("speech source text was empty");
     }
+    if (exceedsUnicodeCharacterLimit(sourceText, MAX_SPEECH_SOURCE_CHARACTERS)) {
+        throw new Error("speech source text exceeds 10,000 characters");
+    }
     const apiKey = options.apiKey.trim();
     if (!apiKey) {
         throw new Error("missing Gemini API key");
@@ -51,14 +68,33 @@ export async function* streamGeminiSpeechAudio(options) {
     let completed = false;
     try {
         await options.onStageChange?.("rewriting");
-        const spokenText = await rewriteTextForSpeech({
-            apiKey,
-            model: rewriteModel,
-            sourceText,
-            fetchImpl,
-            signal: abortController.signal,
-        });
-        const spokenChunks = splitSpeechChunks(spokenText);
+        const rewriteController = createLinkedAbortController(abortController.signal);
+        const rewriteTimeout = setTimeout(() => rewriteController.abort(), SPEECH_REWRITE_TIMEOUT_MS);
+        rewriteTimeout.unref?.();
+        let spokenText;
+        try {
+            spokenText = await rewriteTextForSpeech({
+                apiKey,
+                model: rewriteModel,
+                sourceText,
+                fetchImpl,
+                signal: rewriteController.signal,
+            });
+        }
+        catch (error) {
+            if (!abortController.signal.aborted && rewriteController.signal.aborted) {
+                throw new Error("speech rewrite timed out after 1 minute");
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(rewriteTimeout);
+            rewriteController.dispose();
+        }
+        if (exceedsUnicodeCharacterLimit(spokenText, MAX_SPOKEN_TEXT_CHARACTERS)) {
+            throw new Error("rewritten speech text exceeds 10,000 characters");
+        }
+        const spokenChunks = splitSpeechChunks(spokenText, options.deliveryMode);
         await options.onStageChange?.("generating");
         await options.onChunkProgress?.({ ready: 0, total: spokenChunks.length });
         for await (const chunk of synthesizeSpeechAudioChunksInOrder({
@@ -69,7 +105,9 @@ export async function* streamGeminiSpeechAudio(options) {
             fetchImpl,
             signal: abortController.signal,
             maxAttempts: options.maxTtsAttempts ?? DEFAULT_TTS_MAX_ATTEMPTS,
-            concurrency: DEFAULT_TTS_CONCURRENCY,
+            concurrency: options.deliveryMode === "progressive"
+                ? PROGRESSIVE_TTS_CONCURRENCY
+                : COMPLETE_TTS_CONCURRENCY,
             onChunkProgress: options.onChunkProgress,
             abortOnFailure: () => abortController.abort(),
         })) {
@@ -130,6 +168,7 @@ async function* synthesizeSpeechAudioChunksInOrder(args) {
     let nextIndex = 0;
     let nextYieldIndex = 0;
     let ready = 0;
+    let totalPcmBytes = 0;
     let failure;
     let notify;
     const wake = () => {
@@ -163,7 +202,7 @@ async function* synthesizeSpeechAudioChunksInOrder(args) {
                 return;
             }
             try {
-                results[index] = await synthesizeSpeechAudioChunk({
+                const pcmAudio = await synthesizeSpeechAudioChunk({
                     apiKey: args.apiKey,
                     model: args.model,
                     voiceName: args.voiceName,
@@ -172,6 +211,11 @@ async function* synthesizeSpeechAudioChunksInOrder(args) {
                     signal: args.signal,
                     maxAttempts: args.maxAttempts,
                 });
+                totalPcmBytes += pcmAudio.length;
+                if (totalPcmBytes > MAX_SPEECH_PCM_BYTES) {
+                    throw new Error("generated speech audio exceeds the 32 MiB limit");
+                }
+                results[index] = pcmAudio;
                 ready += 1;
                 await args.onChunkProgress?.({ ready, total });
                 wake();
@@ -192,6 +236,7 @@ async function* synthesizeSpeechAudioChunksInOrder(args) {
         while (nextYieldIndex < total) {
             const nextResult = results[nextYieldIndex];
             if (nextResult) {
+                results[nextYieldIndex] = undefined;
                 yield { index: nextYieldIndex, pcmAudio: nextResult };
                 nextYieldIndex += 1;
                 continue;
@@ -229,7 +274,7 @@ async function synthesizeSpeechAudioChunk(args) {
                     ],
                     generationConfig: {
                         responseModalities: ["AUDIO"],
-                        temperature: 1,
+                        maxOutputTokens: TTS_MAX_OUTPUT_TOKENS,
                         speechConfig: {
                             voiceConfig: {
                                 prebuiltVoiceConfig: {
@@ -240,6 +285,7 @@ async function synthesizeSpeechAudioChunk(args) {
                     },
                 },
             });
+            assertGeminiTtsDidNotReachOutputLimit(payload);
             const audioData = extractGeminiInlineAudioData(payload);
             if (!audioData) {
                 throw new GeminiTtsResponseError("Gemini TTS response did not include audio data");
@@ -304,6 +350,14 @@ function extractGeminiText(payload) {
     }
     return "";
 }
+function assertGeminiTtsDidNotReachOutputLimit(payload) {
+    if (!isObject(payload) || !Array.isArray(payload.candidates)) {
+        return;
+    }
+    if (payload.candidates.some((candidate) => isObject(candidate) && candidate.finishReason === "MAX_TOKENS")) {
+        throw new GeminiTtsOutputLimitError();
+    }
+}
 function extractGeminiInlineAudioData(payload) {
     if (!isObject(payload) || !Array.isArray(payload.candidates)) {
         return undefined;
@@ -336,14 +390,17 @@ function buildSpeechRewritePrompt(sourceText) {
         "Things that typically need rewriting: file paths, shell commands, code identifiers, markdown structure, XML-like tags, long option lists, and code-heavy formatting.",
         "Remove formatting. Convert headings, lists, tables, and code blocks into plain spoken prose. Do not preserve markdown bullets, heading markers, table rows, fences, or standalone labels.",
         "For file references, keep the filename and any line or range info that was actually present. Do not add location detail that was not in the original.",
-        "Say code identifiers and version strings as natural words (for example, handleToolUiEvent as 'handle tool UI event', v5.4 as 'version 5.4'). Keep numbers and units natural (for example, 8,192 tokens as 'about eight thousand tokens').",
+        "Preserve numbers exactly as written, including separators, decimals, units, versions, line numbers, and ranges.",
+        "Preserve established technical names, acronyms, initialisms, commands, program names, filenames, and extensions exactly as written. Do not spell their letters apart, expand them, or change their capitalization. Examples that must remain unchanged include 24, PCM, ffmpeg, npm, v5.4, and config.json.",
+        "Rewrite a code identifier only when its literal form would be difficult to follow aloud, and preserve its exact meaning.",
         "",
         "Examples of good rewrites:",
         '- `src/core/utils/gemini_speech.ts:372` → "gemini_speech.ts, line 372"',
         '- `src/tui/session_chat_controller.ts:1819-1855` → "session_chat_controller.ts, lines 1819 to 1855"',
         '- `src/core/session/compaction.ts` → "compaction.ts"',
         '- `/Users/markus/.config/tau/config.json` → "the tau config.json in your home directory"',
-        '- `rg --heading -n -t ts "ToolRunPresentation" src` → "ripgrep for ToolRunPresentation in TypeScript files under src"',
+        '- `rg --heading -n -t ts "ToolRunPresentation" src` → "the rg command searching TypeScript files for ToolRunPresentation under src"',
+        '- `24 kHz PCM with ffmpeg` → "24 kHz PCM with ffmpeg"',
         '- `<available-skills>` → "the available-skills tag"',
         "- A markdown bullet list of short items → a natural comma-separated list or short sentences",
         "",
@@ -355,38 +412,59 @@ function buildSpeechRewritePrompt(sourceText) {
         sourceText,
     ].join("\n");
 }
-function splitSpeechChunks(spokenText) {
-    const paragraphs = spokenText
-        .split(/\n\s*\n/g)
-        .map((paragraph) => normalizeSpeechParagraph(paragraph))
-        .filter((paragraph) => paragraph.length > 0);
-    if (paragraphs.length === 0) {
-        return [spokenText.trim()];
+function exceedsUnicodeCharacterLimit(text, limit) {
+    let count = 0;
+    for (const _character of text) {
+        count += 1;
+        if (count > limit) {
+            return true;
+        }
     }
+    return false;
+}
+function splitSpeechChunks(spokenText, deliveryMode) {
+    const normalizedText = spokenText
+        .trim()
+        .split(/\n\s*\n/gu)
+        .map((paragraph) => paragraph.replace(/\s+/gu, " ").trim())
+        .filter(Boolean)
+        .join("\n\n");
+    const maxCharacters = deliveryMode === "progressive"
+        ? PROGRESSIVE_SPEECH_CHUNK_CHARACTERS
+        : COMPLETE_SPEECH_CHUNK_CHARACTERS;
     const chunks = [];
-    let current = "";
-    for (const paragraph of paragraphs) {
-        if (!current) {
-            current = paragraph;
-            continue;
+    let remaining = Array.from(normalizedText);
+    while (remaining.length > maxCharacters) {
+        const boundary = findSpeechChunkBoundary(remaining, maxCharacters);
+        chunks.push(remaining.slice(0, boundary).join("").trim());
+        remaining = Array.from(remaining.slice(boundary).join("").trim());
+    }
+    if (remaining.length > 0) {
+        chunks.push(remaining.join(""));
+    }
+    return chunks.length > 0 ? chunks : [spokenText.trim()];
+}
+function findSpeechChunkBoundary(characters, maxCharacters) {
+    const preferredMinimum = Math.floor(maxCharacters * 0.6);
+    for (let index = maxCharacters; index >= preferredMinimum; index -= 1) {
+        if (characters[index] === "\n" && characters[index + 1] === "\n") {
+            return index;
         }
-        if (current.length < MIN_SPEECH_CHUNK_CHARACTERS) {
-            current = joinSpeechParagraphs(current, paragraph);
-            continue;
+    }
+    for (let index = maxCharacters; index >= preferredMinimum; index -= 1) {
+        if (isSpeechSentenceBoundary(characters[index - 1] ?? "", characters[index] ?? "")) {
+            return index;
         }
-        chunks.push(current);
-        current = paragraph;
     }
-    if (current) {
-        chunks.push(current);
+    for (let index = maxCharacters; index >= 1; index -= 1) {
+        if (/\s/u.test(characters[index] ?? "")) {
+            return index;
+        }
     }
-    return chunks;
+    return maxCharacters;
 }
-function normalizeSpeechParagraph(paragraph) {
-    return paragraph.replace(/\s+/g, " ").trim();
-}
-function joinSpeechParagraphs(first, second) {
-    return `${first}\n\n${second}`;
+function isSpeechSentenceBoundary(previous, next) {
+    return /[。！？]/u.test(previous) || (/[.!?;:]/u.test(previous) && /\s/u.test(next));
 }
 function buildSpeechSynthesisPrompt(spokenText) {
     return [
@@ -395,13 +473,16 @@ function buildSpeechSynthesisPrompt(spokenText) {
         "",
         "### DIRECTOR'S NOTES",
         "Style: Clear, natural, conversational.",
-        "Pacing: Slightly slower than conversational, with deliberate enunciation. The audio will be sped up during playback.",
+        "Pacing: Brisk conversational speed. Keep it clear, confident, and energetic without sounding rushed.",
         "",
         "### TRANSCRIPT",
         spokenText,
     ].join("\n");
 }
 function isRetryableTtsError(error) {
+    if (error instanceof GeminiTtsOutputLimitError) {
+        return false;
+    }
     if (error instanceof GeminiTtsResponseError) {
         return true;
     }