charness 3.2.0 → 3.3.1

package/dist/stt/sttInstall.js

@@ -0,0 +1,491 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSttCommand = exports.missingPythonToolError = exports.gigaamModelApproxBytes = exports.gigaamPinnedRequirements = exports.gigaamScriptVersion = void 0;
+exports.getSttPaths = getSttPaths;
+exports.getSidecarScriptPath = getSidecarScriptPath;
+exports.planSttInstall = planSttInstall;
+exports.detectSttInstallFacts = detectSttInstallFacts;
+exports.isGigaamInstalled = isGigaamInstalled;
+exports.isGigaamInstalling = isGigaamInstalling;
+exports.getLastSttInstallProgress = getLastSttInstallProgress;
+exports.readSttInstallProgress = readSttInstallProgress;
+exports.formatDownloadDetail = formatDownloadDetail;
+exports.runSttInstall = runSttInstall;
+exports.removeSttInstall = removeSttInstall;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const installManager_1 = require("../installManager");
+const jsonStreamHost_1 = require("../utils/jsonStreamHost");
+const sttChildEnv_1 = require("./sttChildEnv");
+const configDirFile_1 = require("../configDirFile");
+/**
+ * @description The install of the local speech engine: a private Python venv
+ * under `<DATA_DIR>/stt` holding the pinned `onnx-asr` + `soundfile`, and the
+ * GigaAM model fetched into a private Hugging Face cache — nothing is shared
+ * with, or written into, the operator's Python. There is NO user-facing command:
+ * the bot runs this from `/stt` ("Add engine → GigaAM (local)") or, when `stt.json`
+ * names the local engine, at boot; both launch the detached `sttInstallEntry`.
+ */
+/** Must equal `SCRIPT_VERSION` in `stt/gigaam_sidecar.py` (a unit test holds them together). */
+exports.gigaamScriptVersion = '1';
+/** The one place the pinned packages are named. */
+exports.gigaamPinnedRequirements = ['onnx-asr[cpu,hub]==0.12.0', 'soundfile==0.14.0'];
+/** The Python the packages need. */
+const minimumPythonMajor = 3;
+const minimumPythonMinor = 10;
+const pythonRequest = `>=${minimumPythonMajor}.${minimumPythonMinor}`;
+const mebibyte = 1024 * 1024;
+/** The int8 e2e-rnnt files as fetched (216 MiB: the 215 MB encoder, decoder, joint, vocab), the progress denominator. */
+exports.gigaamModelApproxBytes = 216 * mebibyte;
+/** A lock with no owner file (its taker died between `mkdir` and the write) is left after this long. */
+const ownerlessLockStaleMs = 60 * 1000;
+const downloadPollIntervalMs = 2_000;
+const pythonProbeTimeoutMs = 10_000;
+const logTailLineCount = 20;
+const logTailLineMaxLength = 300;
+const installStepTimeoutMs = 20 * 60 * 1000;
+/** The model check downloads ~220 MB: a slow link needs far longer than the pip steps. */
+const modelCheckTimeoutMs = 60 * 60 * 1000;
+const rootDirName = 'stt';
+const venvDirName = 'venv';
+const hfDirName = 'hf';
+const uvCacheDirName = 'uv-cache';
+const markerFileName = 'installed.json';
+const lockDirName = 'install.lock';
+const lockOwnerFileName = 'owner';
+const installLogFileName = 'install.log';
+const progressFileName = 'install-progress.json';
+const sidecarScriptName = 'gigaam_sidecar.py';
+function getSttPaths(dataDir) {
+    const root = path.join(dataDir, rootDirName);
+    const venvDir = path.join(root, venvDirName);
+    return {
+        root,
+        venvDir,
+        venvPython: path.join(venvDir, 'bin', 'python'),
+        hfHome: path.join(root, hfDirName),
+        uvCacheDir: path.join(root, uvCacheDirName),
+        markerFile: path.join(root, markerFileName),
+        lockDir: path.join(root, lockDirName),
+        installLog: path.join(root, installLogFileName),
+        progressFile: path.join(root, progressFileName),
+    };
+}
+/**
+ * @description The sidecar script that ships in the package's `stt/` dir, two
+ * levels above this module (`src/stt` under tsx, `dist/stt` once built).
+ */
+function getSidecarScriptPath() {
+    return path.join(fs.realpathSync(__dirname), '..', '..', 'stt', sidecarScriptName);
+}
+exports.missingPythonToolError = 'Local recognition needs either uv (https://docs.astral.sh/uv/) or Python 3.10+ with the venv module ' +
+    '(on Debian/Ubuntu: apt install python3-venv). Neither was found.';
+/**
+ * @description Decide how to build the venv: `uv` first (it needs no `ensurepip`
+ * and can fetch a Python), else a `python3` >= 3.10 that can create a venv with
+ * pip, else an error naming what is missing.
+ */
+function planSttInstall(facts) {
+    const { venvDir, venvPython } = facts.paths;
+    if (facts.uvPath) {
+        return {
+            ok: true,
+            tool: 'uv',
+            commands: [
+                { command: facts.uvPath, args: ['venv', '--python', pythonRequest, venvDir], phase: 'creatingEnvironment' },
+                {
+                    command: facts.uvPath,
+                    args: ['pip', 'install', '--python', venvPython, ...exports.gigaamPinnedRequirements],
+                    phase: 'installingPackages',
+                },
+            ],
+        };
+    }
+    const python3 = facts.python3;
+    const isNewEnough = python3 !== null &&
+        (python3.major > minimumPythonMajor || (python3.major === minimumPythonMajor && python3.minor >= minimumPythonMinor));
+    if (python3 && isNewEnough && python3.hasVenvSupport) {
+        return {
+            ok: true,
+            tool: 'pip',
+            commands: [
+                { command: python3.path, args: ['-m', 'venv', venvDir], phase: 'creatingEnvironment' },
+                {
+                    command: venvPython,
+                    args: ['-m', 'pip', 'install', '--no-cache-dir', ...exports.gigaamPinnedRequirements],
+                    phase: 'installingPackages',
+                },
+            ],
+        };
+    }
+    return { ok: false, error: exports.missingPythonToolError };
+}
+function findOnPath(binaryName, env) {
+    const candidates = (env.PATH ?? '').split(path.delimiter).map((directory) => path.join(directory, binaryName));
+    candidates.push(path.join(os.homedir(), '.local', 'bin', binaryName));
+    return candidates.find((candidate) => path.isAbsolute(candidate) && checkIsExecutableFile(candidate)) ?? null;
+}
+function checkIsExecutableFile(filePath) {
+    try {
+        fs.accessSync(filePath, fs.constants.X_OK);
+        return fs.statSync(filePath).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/** @description Look at the host: where `uv` and a usable `python3` are. */
+function detectSttInstallFacts(paths, env = process.env) {
+    const uvPath = findOnPath('uv', env);
+    const python3Path = findOnPath('python3', env);
+    let python3 = null;
+    if (python3Path) {
+        try {
+            const probe = (0, child_process_1.execFileSync)(python3Path, ['-c', 'import sys, importlib.util; print(sys.version_info.major, sys.version_info.minor, importlib.util.find_spec("ensurepip") is not None and importlib.util.find_spec("venv") is not None)'], { encoding: 'utf8', timeout: pythonProbeTimeoutMs }).trim().split(' ');
+            python3 = { path: python3Path, major: Number(probe[0]), minor: Number(probe[1]), hasVenvSupport: probe[2] === 'True' };
+        }
+        catch {
+            python3 = null;
+        }
+    }
+    return { uvPath, python3, paths };
+}
+function readMarker(paths) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(paths.markerFile, 'utf8'));
+        if (typeof parsed.scriptVersion !== 'string' || !Array.isArray(parsed.pins) || typeof parsed.installedAt !== 'string')
+            return null;
+        return { scriptVersion: parsed.scriptVersion, pins: parsed.pins, installedAt: parsed.installedAt };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * @description Whether the local engine is ready to start: the marker names the
+ * script version and pins this build ships, and the venv's interpreter is still
+ * there. Cheap and synchronous — it runs for every voice note.
+ */
+function isGigaamInstalled(dataDir) {
+    const paths = getSttPaths(dataDir);
+    const marker = readMarker(paths);
+    if (!marker || marker.scriptVersion !== exports.gigaamScriptVersion)
+        return false;
+    if (marker.pins.join(' ') !== exports.gigaamPinnedRequirements.join(' '))
+        return false;
+    return checkIsExecutableFile(paths.venvPython);
+}
+/** The owner file: the job's pid, and its start token so a reused pid is not mistaken for the job. */
+function readLockOwner(paths) {
+    try {
+        const [pidText, startToken] = fs.readFileSync(path.join(paths.lockDir, lockOwnerFileName), 'utf8').split('\n');
+        const pid = Number(pidText);
+        return Number.isInteger(pid) && pid > 0 ? { pid, startToken: startToken?.trim() || null } : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The install lock is held while its owner lives — however long a slow download takes. Age matters only for a
+ * lock nobody ever wrote an owner into (its taker died in between), which goes stale quickly.
+ */
+function checkIsLockHeld(paths, nowMs) {
+    let lockModifiedMs;
+    try {
+        lockModifiedMs = fs.statSync(paths.lockDir).mtimeMs;
+    }
+    catch {
+        return false;
+    }
+    const owner = readLockOwner(paths);
+    if (!owner)
+        return nowMs - lockModifiedMs <= ownerlessLockStaleMs;
+    return owner.startToken ? (0, installManager_1.checkIsProcessIdentityCurrent)({ pid: owner.pid, startToken: owner.startToken }) : (0, jsonStreamHost_1.checkIsPidAlive)(owner.pid);
+}
+/** @description An install job is running right now (its lock is held by a live process, not stale). */
+function isGigaamInstalling(dataDir, nowMs = Date.now()) {
+    return checkIsLockHeld(getSttPaths(dataDir), nowMs);
+}
+/** Take the lock; a stale or dead-owner one is replaced. False when a live install holds it. */
+function acquireInstallLock(paths, nowMs) {
+    fs.mkdirSync(paths.root, { recursive: true });
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            fs.mkdirSync(paths.lockDir);
+            fs.writeFileSync(path.join(paths.lockDir, lockOwnerFileName), `${process.pid}\n${(0, installManager_1.getProcessIdentity)(process.pid)?.startToken ?? ''}\n`);
+            return true;
+        }
+        catch (error) {
+            if (!(error instanceof Error && (0, configDirFile_1.getErrnoCode)(error) === 'EEXIST'))
+                throw error;
+            if (checkIsLockHeld(paths, nowMs))
+                return false;
+            fs.rmSync(paths.lockDir, { recursive: true, force: true });
+        }
+    }
+    return false;
+}
+function releaseInstallLock(paths) {
+    fs.rmSync(paths.lockDir, { recursive: true, force: true });
+}
+/**
+ * @description The last complete progress report in the text of the progress
+ * file (one JSON object per line); a torn last line from a crash is skipped.
+ */
+function getLastSttInstallProgress(text) {
+    const lines = text.split('\n').map((line) => line.trim()).filter(Boolean);
+    for (const line of lines.reverse()) {
+        try {
+            const parsed = JSON.parse(line);
+            if (typeof parsed.phase === 'string' && typeof parsed.bytesDownloaded === 'number') {
+                return { phase: parsed.phase, detail: parsed.detail ?? '', bytesDownloaded: parsed.bytesDownloaded, error: parsed.error, logTail: parsed.logTail };
+            }
+        }
+        catch {
+            // a half-written line: try the one before
+        }
+    }
+    return null;
+}
+function readSttInstallProgress(dataDir) {
+    try {
+        return getLastSttInstallProgress(fs.readFileSync(getSttPaths(dataDir).progressFile, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** @description "120/217 MB" — the download line of the progress report. */
+function formatDownloadDetail(bytesDownloaded) {
+    const doneMegabytes = Math.min(Math.floor(bytesDownloaded / mebibyte), Math.round(exports.gigaamModelApproxBytes / mebibyte));
+    return `${doneMegabytes}/${Math.round(exports.gigaamModelApproxBytes / mebibyte)} MB`;
+}
+function getDirectorySizeBytes(directory) {
+    let total = 0;
+    let entries;
+    try {
+        entries = fs.readdirSync(directory, { withFileTypes: true });
+    }
+    catch {
+        return 0;
+    }
+    for (const entry of entries) {
+        const entryPath = path.join(directory, entry.name);
+        try {
+            total += entry.isDirectory() ? getDirectorySizeBytes(entryPath) : fs.lstatSync(entryPath).size;
+        }
+        catch {
+            // vanished between readdir and stat: a temp file renamed into place
+        }
+    }
+    return total;
+}
+const runSttCommand = (command, args, { env, logFile, timeoutMs }) => new Promise((resolve) => {
+    const logFd = fs.openSync(logFile, 'a');
+    fs.writeSync(logFd, `\n$ ${command} ${args.join(' ')}\n`);
+    const child = (0, child_process_1.spawn)(command, args, { env, stdio: ['ignore', 'pipe', logFd] });
+    let stdout = '';
+    child.stdout?.setEncoding('utf8');
+    child.stdout?.on('data', (chunk) => {
+        stdout += chunk;
+        fs.writeSync(logFd, chunk);
+    });
+    const timer = setTimeout(() => child.kill('SIGKILL'), timeoutMs);
+    let isFinished = false;
+    const finish = (exitCode) => {
+        if (isFinished)
+            return; // 'error' and 'close' can both fire for one failed spawn
+        isFinished = true;
+        clearTimeout(timer);
+        fs.closeSync(logFd);
+        resolve({ exitCode, stdout });
+    };
+    child.once('error', (error) => {
+        fs.writeSync(logFd, `spawn failed: ${error.message}\n`);
+        finish(null);
+    });
+    child.once('close', finish);
+});
+exports.runSttCommand = runSttCommand;
+function appendProgressLine(paths, progress) {
+    try {
+        fs.appendFileSync(paths.progressFile, `${JSON.stringify(progress)}\n`);
+    }
+    catch {
+        // The file only feeds a status message; a full disk must not fail the install itself.
+    }
+}
+function readLogTail(logFile) {
+    try {
+        // Progress bars redraw one line with carriage returns: split on those too, and cap what one line can carry.
+        return fs
+            .readFileSync(logFile, 'utf8')
+            .split(/[\r\n]+/)
+            .filter((line) => line.trim())
+            .map((line) => line.slice(0, logTailLineMaxLength))
+            .slice(-logTailLineCount);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * @description Build the venv, install the pinned packages and fetch the model
+ * (`--check` loads it and recognises a second of silence, so a broken download
+ * is caught here, not by the first voice). Idempotent: a current marker means
+ * nothing to do unless `force`. One install at a time per data dir (a lock
+ * directory; a stale one or a dead owner's is replaced). Child output goes to
+ * `install.log`; a failure returns its last lines.
+ */
+async function runSttInstall(dataDir, options = {}) {
+    const paths = getSttPaths(dataDir);
+    const env = options.env ?? process.env;
+    const nowMs = options.nowMs ?? Date.now;
+    const runCommand = options.runCommand ?? exports.runSttCommand;
+    const report = (progress) => {
+        appendProgressLine(paths, progress);
+        options.onProgress?.(progress);
+    };
+    if (!acquireInstallLock(paths, nowMs())) {
+        return { ok: false, reason: 'locked', error: 'another install is already running', logTail: [] };
+    }
+    // This run's progress starts from an empty file, so a reader never mistakes an earlier run's `done` for it.
+    fs.writeFileSync(paths.progressFile, '');
+    const fail = (error) => {
+        const logTail = readLogTail(paths.installLog);
+        report({ phase: 'failed', detail: '', bytesDownloaded: 0, error, logTail });
+        return { ok: false, reason: 'failed', error, logTail };
+    };
+    try {
+        if (!options.force && isGigaamInstalled(dataDir)) {
+            report({ phase: 'done', detail: '', bytesDownloaded: getDirectorySizeBytes(paths.hfHome) });
+            return { ok: true, wasAlreadyInstalled: true };
+        }
+        fs.mkdirSync(paths.hfHome, { recursive: true });
+        fs.rmSync(paths.installLog, { force: true });
+        fs.rmSync(paths.markerFile, { force: true });
+        fs.rmSync(paths.venvDir, { recursive: true, force: true });
+        const plan = planSttInstall((options.detectFacts ?? detectSttInstallFacts)(paths, env));
+        if (!plan.ok)
+            return fail(plan.error);
+        // The model has to come from the network here (the running sidecar is offline), whatever the parent env says.
+        // ... and from a short allowlist, not the bot's whole environment: pip / uv run third-party package code.
+        const { HF_HUB_OFFLINE: _hubOffline, ...inheritedEnv } = (0, sttChildEnv_1.getSttChildEnv)(env);
+        const installEnv = {
+            ...inheritedEnv,
+            HF_HOME: paths.hfHome,
+            UV_CACHE_DIR: paths.uvCacheDir,
+            PIP_DISABLE_PIP_VERSION_CHECK: '1',
+        };
+        for (const step of plan.commands) {
+            report({ phase: step.phase, detail: '', bytesDownloaded: 0 });
+            const result = await runCommand(step.command, step.args, { env: installEnv, logFile: paths.installLog, timeoutMs: installStepTimeoutMs });
+            if (result.exitCode !== 0)
+                return fail(`${path.basename(step.command)} ${step.args[0]} failed (exit ${result.exitCode ?? 'none'})`);
+        }
+        const pollMs = options.downloadPollIntervalMs ?? downloadPollIntervalMs;
+        const reportDownload = () => {
+            const bytesDownloaded = getDirectorySizeBytes(paths.hfHome);
+            const isDownloaded = bytesDownloaded >= exports.gigaamModelApproxBytes;
+            report({
+                phase: isDownloaded ? 'checking' : 'downloadingModel',
+                detail: isDownloaded ? '' : formatDownloadDetail(bytesDownloaded),
+                bytesDownloaded,
+            });
+        };
+        reportDownload();
+        const poller = setInterval(reportDownload, pollMs);
+        let check;
+        try {
+            check = await runCommand(paths.venvPython, ['-I', getSidecarScriptPath(), '--check'], {
+                env: installEnv,
+                logFile: paths.installLog,
+                timeoutMs: modelCheckTimeoutMs,
+            });
+        }
+        finally {
+            clearInterval(poller);
+        }
+        const checkReport = getLastJsonLine(check.stdout);
+        if (check.exitCode !== 0 || checkReport?.ok !== true) {
+            return fail(`the model check failed${checkReport?.error ? `: ${checkReport.error}` : ` (exit ${check.exitCode ?? 'none'})`}`);
+        }
+        const marker = {
+            scriptVersion: exports.gigaamScriptVersion,
+            pins: [...exports.gigaamPinnedRequirements],
+            installedAt: new Date(nowMs()).toISOString(),
+        };
+        fs.writeFileSync(paths.markerFile, `${JSON.stringify(marker, null, 2)}\n`);
+        report({ phase: 'done', detail: '', bytesDownloaded: getDirectorySizeBytes(paths.hfHome) });
+        return { ok: true, wasAlreadyInstalled: false };
+    }
+    catch (error) {
+        return fail(error instanceof Error ? error.message : 'the install crashed');
+    }
+    finally {
+        releaseInstallLock(paths);
+    }
+}
+function getLastJsonLine(stdout) {
+    const lines = stdout.split('\n').map((line) => line.trim()).filter(Boolean);
+    const lastLine = lines[lines.length - 1];
+    if (!lastLine)
+        return null;
+    try {
+        return JSON.parse(lastLine);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * @description Delete the local engine's files (venv, model cache, uv cache,
+ * marker, install log). Refuses while an install runs. The caller stops the
+ * sidecar first.
+ */
+function removeSttInstall(dataDir) {
+    const paths = getSttPaths(dataDir);
+    if (checkIsLockHeld(paths, Date.now()))
+        return false;
+    for (const target of [paths.venvDir, paths.hfHome, paths.uvCacheDir, paths.markerFile, paths.installLog, paths.progressFile, paths.lockDir]) {
+        fs.rmSync(target, { recursive: true, force: true });
+    }
+    return true;
+}
+//# sourceMappingURL=sttInstall.js.map

package/dist/stt/sttInstall.js.map

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

package/dist/stt/sttInstallEntry.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sttInstallEntry.d.ts.map

package/dist/stt/sttInstallEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sttInstallEntry.d.ts","sourceRoot":"","sources":["../../src/stt/sttInstallEntry.ts"],"names":[],"mappings":""}

package/dist/stt/sttInstallEntry.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const sttInstall_1 = require("./sttInstall");
+/**
+ * @description The detached install job — NOT a user command (there is no CLI
+ * for voice setup). The bot launches it through `startExternallyParentedProcess`
+ * so a hot reload in the middle of a 450 MB download never kills it:
+ * `node dist/stt/sttInstallEntry.js <dataDir> [--force]`.
+ *
+ * Progress is appended to `<dataDir>/stt/install-progress.json` by
+ * `runSttInstall` itself; this file only maps the outcome to an exit code:
+ * 0 installed (or already was), 1 failed, 2 bad usage, 3 another install holds the lock.
+ */
+const exitInstalled = 0;
+const exitFailed = 1;
+const exitUsage = 2;
+const exitLocked = 3;
+async function main() {
+    const dataDir = process.argv[2];
+    if (!dataDir)
+        return exitUsage;
+    const result = await (0, sttInstall_1.runSttInstall)(dataDir, { force: process.argv.includes('--force') });
+    if (result.ok)
+        return exitInstalled;
+    return result.reason === 'locked' ? exitLocked : exitFailed;
+}
+main().then((exitCode) => process.exit(exitCode), (error) => {
+    console.error('[STT] install job crashed:', error instanceof Error ? error.message : error);
+    process.exit(exitFailed);
+});
+//# sourceMappingURL=sttInstallEntry.js.map

package/dist/stt/sttInstallEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sttInstallEntry.js","sourceRoot":"","sources":["../../src/stt/sttInstallEntry.ts"],"names":[],"mappings":";;AAAA,6CAA6C;AAE7C;;;;;;;;;GASG;AAEH,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAa,EAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACzF,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,aAAa,CAAC;IACpC,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9D,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CACT,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EACpC,CAAC,KAAK,EAAE,EAAE;IACR,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5F,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AAC3B,CAAC,CACF,CAAC"}

package/dist/stt/sttInstallReporter.d.ts

@@ -0,0 +1,45 @@
+import type { SttInstallProgressMessage, StateStore } from '../state';
+import type { SessionKey } from '../sessionKey';
+import type { SttInstallReporter } from './sttAutoInstall';
+import { type SttTranslate } from './sttScreenPlan';
+/**
+ * @description Reporters for an install job's progress: one that keeps a SINGLE message of a topic up to date
+ * (the boot auto-install in General, the `/stt` button in its own topic), and one that only writes `[STT]` log
+ * lines (no group is paired). The message id is kept in `state.json` so a reloaded bot re-attaches to the same
+ * message instead of posting a second one.
+ */
+export interface SttInstallMessagePorts {
+    getState: () => Pick<StateStore, 'getSttInstallProgressMessage' | 'setSttInstallProgressMessage'>;
+    /** Post into the topic; the new message's id, or `null` when it failed. */
+    replyToThread: (key: SessionKey, text: string) => Promise<number | null>;
+    /** Edit a message of the topic; false when it failed (a deleted message). */
+    editThreadMessage: (key: SessionKey, messageId: number, text: string) => Promise<boolean>;
+    /** `t(...)` in the topic's locale, for the whole text of one report. */
+    translateFor: (key: SessionKey) => SttTranslate;
+    nowMs: () => number;
+}
+/** @description A message reporter and the id of the message it currently edits (it can change when a deleted message is replaced). */
+export interface SttInstallMessageReporter {
+    report: SttInstallReporter;
+    getMessageId: () => number | null;
+}
+/**
+ * @description Keep ONE message up to date with a running install. It edits `existing` (a message the caller
+ * already posted — the `/stt` confirm screen), else the one `state.json` remembers for THIS topic, else posts one
+ * on the first report, and remembers its id together with the "enable on done" flag. The END of the job is not
+ * reported here: the finisher turns the message into the outcome (with its buttons) and forgets it, so a job that
+ * outlives the bot is finished the same way by whoever re-attaches.
+ */
+export declare function createSttInstallMessageReporter(ports: SttInstallMessagePorts, key: SessionKey, existing?: SttInstallProgressMessage): SttInstallMessageReporter;
+/** @description The reporter for an install nobody is watching in a chat: one `[STT] install: …` line per phase change. */
+export declare function createSttInstallLogReporter(log: (line: string) => void): SttInstallReporter;
+/** What the Telegram side lends the install message: the topic send helpers and the locale. */
+export interface SttInstallMessageCore {
+    getState: SttInstallMessagePorts['getState'];
+    replyToThread: (key: SessionKey, text: string, extra?: object) => Promise<number | null>;
+    editThreadMessage: (key: SessionKey, messageId: number, text: string, extra?: object) => Promise<boolean>;
+    withThreadLocale: <TResult>(key: SessionKey, fn: () => TResult) => TResult;
+}
+/** @description The ports of {@link createSttInstallMessageReporter} over the bot's topic helpers; `translate` is `t(…)`. */
+export declare function createSttInstallMessagePorts(core: SttInstallMessageCore, translate: SttTranslate): SttInstallMessagePorts;
+//# sourceMappingURL=sttInstallReporter.d.ts.map

package/dist/stt/sttInstallReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sttInstallReporter.d.ts","sourceRoot":"","sources":["../../src/stt/sttInstallReporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAwD,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE1G;;;;;GAKG;AAEH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,IAAI,CAAC,UAAU,EAAE,8BAA8B,GAAG,8BAA8B,CAAC,CAAC;IAClG,2EAA2E;IAC3E,aAAa,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzE,6EAA6E;IAC7E,iBAAiB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,wEAAwE;IACxE,YAAY,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,YAAY,CAAC;IAChD,KAAK,EAAE,MAAM,MAAM,CAAC;CACrB;AAED,uIAAuI;AACvI,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,sBAAsB,EAC7B,GAAG,EAAE,UAAU,EACf,QAAQ,CAAC,EAAE,yBAAyB,GACnC,yBAAyB,CAoB3B;AAED,2HAA2H;AAC3H,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,kBAAkB,CAO3F;AAED,+FAA+F;AAC/F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC7C,aAAa,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzF,iBAAiB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1G,gBAAgB,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,KAAK,OAAO,CAAC;CAC5E;AAED,6HAA6H;AAC7H,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,qBAAqB,EAAE,SAAS,EAAE,YAAY,GAAG,sBAAsB,CAQzH"}