charness 3.2.0 → 3.3.1

package/dist/stt/sttSettings.d.ts

@@ -0,0 +1,201 @@
+import { type ConfigFileLoad, type ConfigValidation } from '../configDirFile';
+import { type TranscriptionEndpoint } from '../utils/transcribeAudio';
+/**
+ * @description The voice-recognition settings: ONE JSON file, `stt.json`, next to
+ * the instance's `.env`, holding the engine chain, the language, the local
+ * engine's knobs AND the API keys. `/stt` writes it; an operator may hand-edit
+ * it, and the next voice note sees the edit (the load is cached by file stamp).
+ *
+ * Validation is strict and all-or-nothing, like `jira.json`: a typo is an error
+ * that NAMES the field and never echoes a value (a key may sit next to it), and
+ * an invalid edit keeps the last good settings instead of silently dropping an
+ * engine.
+ */
+/** The file in the config dir. */
+export declare const sttConfigFileName = "stt.json";
+export declare const sttEngineKinds: readonly ["gigaam", "groq", "openai", "url"];
+export type SttEngineKind = (typeof sttEngineKinds)[number];
+/** The most engines one chain holds. */
+export declare const sttEngineLimit = 6;
+/** The worker counts `/stt` offers; a hand-edited value is clamped to the nearest one. */
+export declare const sttGigaamWorkerChoices: readonly number[];
+/** The shape of an engine's request budget: `baseSeconds + percentOfDuration % of the voice`. */
+export interface SttTimeout {
+    baseSeconds: number;
+    percentOfDuration: number;
+}
+export declare const defaultSttTimeout: SttTimeout;
+export declare const defaultGigaamIdleMinutes = 15;
+export declare const defaultGigaamWorkers = 4;
+/** Intra-op threads per worker; `workers × threads` should not exceed the CPU count. */
+export declare const defaultGigaamThreads = 2;
+/** The only language the local engine knows. */
+export declare const gigaamLanguage = "ru";
+/** @name SttEngineSetting @description One entry of the chain, as stored in `stt.json`. */
+export interface SttEngineSetting {
+    /** Stable short id (`g`, `q1`, `u2`): `/stt` callback data carries it, so lowercase letters and digits only. */
+    id: string;
+    kind: SttEngineKind;
+    isDisabled?: boolean;
+    /** Absent → {@link defaultSttTimeout}. */
+    timeout?: SttTimeout;
+    /** `url` kind: the FULL transcription endpoint URL. */
+    url?: string;
+    /** `url` kind: the model name sent along (default `whisper-1`). */
+    model?: string;
+    /** `groq` / `openai` / `url`: never logged or echoed. */
+    apiKey?: string;
+}
+/** @name SttGigaamSettings @description The local engine's process knobs. */
+export interface SttGigaamSettings {
+    /** The process exits after this many idle minutes; `0` = never. */
+    idleMinutes: number;
+    /** Chunks recognised in parallel; one of {@link sttGigaamWorkerChoices}. */
+    workers: number;
+    /** Intra-op threads per worker; a hand-edit-only knob, absent → {@link defaultGigaamThreads}. */
+    threads?: number;
+}
+/** @name SttConfigFile @description The whole of `stt.json`. */
+export interface SttConfigFile {
+    /** Ordered: the first available engine is tried first. */
+    engines: SttEngineSetting[];
+    /** ISO-639-1 (`ru`), or `null` = the engine detects the language. */
+    language: string | null;
+    gigaam: SttGigaamSettings;
+}
+export type SttConfigResult = ConfigValidation<SttConfigFile>;
+/** @description The settings of an instance that has no `stt.json`: no engines, auto language. */
+export declare function createEmptySttConfig(): SttConfigFile;
+/** @description The worker count nearest to `workers` among {@link sttGigaamWorkerChoices} (a tie goes to the smaller). */
+export declare function clampSttWorkers(workers: number): number;
+/** @description `config` with the worker count clamped to a choice `/stt` offers. */
+export declare function normaliseSttConfig(config: SttConfigFile): SttConfigFile;
+/**
+ * @description Validate a parsed `stt.json` object. Every error names its field
+ * (`stt.json engines.1.timeout.baseSeconds: …`) and never carries a value.
+ */
+export declare function validateSttConfig(parsedJson: object): SttConfigResult;
+/**
+ * @description Where `stt.json` lives: beside the instance's REAL env file (see {@link getConfigDirFilePath} for
+ * the rules — a symlinked `.env` is resolved, so the file that holds API keys lands beside the real one).
+ */
+export declare function getSttConfigPath(env?: NodeJS.ProcessEnv, homeDir?: string): string;
+/**
+ * @description What the file holds right now. `invalid` keeps the LAST GOOD
+ * settings (`null` when the file was never valid in this process), so a bad hand
+ * edit never takes voice down.
+ */
+export type SttConfigLoad = ConfigFileLoad<SttConfigFile>;
+/**
+ * @description Read and validate `stt.json`, cached by the file's stamp
+ * (mtime, size, inode) so a per-voice call costs one `stat`. A missing file is
+ * the empty settings; an unreadable or invalid one keeps the last good settings.
+ */
+export declare const loadSttConfig: (filePath: string) => ConfigFileLoad<SttConfigFile>;
+/** @description Forget every cached load — for tests, which swap files under one path. */
+export declare const resetSttConfigCache: () => void;
+/**
+ * @description Write `config` to `filePath`: validated first (a caller that builds
+ * an invalid file has a bug), then written mode 0600 through a temp file and a
+ * rename, so a reader never sees half a file.
+ */
+export declare function saveSttConfig(filePath: string, config: SttConfigFile): void;
+/** @name SttMigrationResult @description What {@link migrateLegacySttKeys} did. */
+export type SttMigrationResult = {
+    status: 'noKeys';
+} | {
+    status: 'fileExists';
+} | {
+    status: 'migrated';
+    engineNames: string[];
+} | {
+    status: 'writeFailed';
+    error: string;
+};
+/**
+ * @description The ONE-TIME migration of the pre-`stt.json` setup: with no file
+ * yet and `GROQ_API_KEY` / `OPENAI_API_KEY` set, write `stt.json` with those
+ * engines (Groq first) and their keys. From then on the env keys are ignored;
+ * a process that still sees one says so once. Never overwrites an existing file.
+ */
+export declare function migrateLegacySttKeys(filePath: string, env?: NodeJS.ProcessEnv, writeLine?: (text: string) => void): SttMigrationResult;
+/**
+ * @description `/stt`'s engine id for a new engine of `kind`: `g` for the local
+ * one, else the kind's letter plus the smallest number not taken (`q1`, `o2`, `u1`).
+ */
+export declare function createSttEngineId(kind: SttEngineKind, takenIds: ReadonlySet<string>): string;
+/** @description What the resolver needs to know about the host (the local engine's lifecycle). */
+export interface SttFacts {
+    isGigaamInstalled: boolean;
+    isGigaamInstalling: boolean;
+    /** The spawn-storm guard marked the local engine unhealthy. */
+    isGigaamUnhealthy: boolean;
+    /** The sidecar has a long-lived process to die with (supervisor or bot); without one it is never started. */
+    hasOwnerContext: boolean;
+}
+/** @description Hooks the resolver cannot know: how the local engine's endpoint is produced at call time. */
+export interface SttResolveOptions {
+    /** Starts the sidecar if needed and returns its endpoint; absent → the local engine is unavailable. */
+    getGigaamEndpoint?: () => Promise<TranscriptionEndpoint>;
+}
+export type SttUnavailableReason = 'disabled' | 'notInstalled' | 'installing' | 'unhealthy' | 'languageNotSupported' | 'noOwnerContext' | 'missingKey' | 'missingUrl';
+/** An engine that will be tried, with its endpoint produced lazily. */
+export interface ResolvedSttEngine {
+    id: string;
+    kind: SttEngineKind;
+    /** What logs call it: the kind, or `url:<host>` for a custom server. */
+    name: string;
+    timeout: SttTimeout;
+    /** Static engines answer at once; the local engine starts its process here and may reject. */
+    getEndpoint: () => Promise<TranscriptionEndpoint>;
+}
+export interface UnavailableSttEngine {
+    id: string;
+    kind: SttEngineKind;
+    reason: SttUnavailableReason;
+}
+/**
+ * Where the effective settings came from: the valid file, none (no file),
+ * the last good settings kept after an invalid edit, or nothing usable (an
+ * invalid file that was never valid).
+ */
+export type SttSettingsSource = 'ok' | 'missing' | 'lastGood' | 'invalid';
+export interface ResolvedSttSettings {
+    /** The effective settings: the file's, the last good ones after a bad edit, or the empty ones. */
+    settings: SttConfigFile;
+    source: SttSettingsSource;
+    /** Available engines in chain order. */
+    engines: ResolvedSttEngine[];
+    unavailable: UnavailableSttEngine[];
+    /** The file names an enabled local engine that is neither installed nor being installed. */
+    needsAutoInstall: boolean;
+    errors: string[];
+}
+/**
+ * @description Turn the loaded settings into the chain a voice note walks:
+ * the available engines in order, the skipped ones with their reason, and
+ * whether the local engine has to be installed first.
+ */
+export declare function resolveSttSettings(load: SttConfigLoad, facts: SttFacts, options?: SttResolveOptions): ResolvedSttSettings;
+/**
+ * @description The i18n key of the notice a voice note gets when NO engine can take it, from the most specific
+ * cause down: a broken `stt.json`; the local engine still installing (the voice is not refused for good — send it
+ * again); engines that are listed but unusable right now; and none set up (or all switched off by the operator).
+ */
+export declare function getNoEngineNoticeCode(resolved: Pick<ResolvedSttSettings, 'errors' | 'unavailable'>): 'voice.config_invalid' | 'voice.local_installing' | 'voice.engines_unavailable' | 'voice.no_api_key';
+/**
+ * @description The `[STT]` log lines for what is wrong with the settings:
+ * file errors (with what the bot does instead), skipped engines (a disabled one
+ * is the operator's choice, not a problem) and an empty chain (unless the file itself
+ * is unusable, which its own error already says). Empty → all well.
+ */
+export declare function getSttReportLines(resolved: ResolvedSttSettings): string[];
+/**
+ * @description The request budget for one voice: `baseSeconds` plus
+ * `percentOfDuration` % of the voice's length (Telegram's `voice.duration`). A missing length — or a `0`, which
+ * Telegram reports for a note whose length it could not read — is "unknown", not a 0-second voice: it is
+ * budgeted as {@link unknownVoiceDurationSeconds}, so a long voice without a length is not cut at the bare base.
+ * Long voices stay on their engine, they just get more time.
+ */
+export declare function getEngineTimeoutMs(timeout: SttTimeout, durationSeconds: number | undefined): number;
+//# sourceMappingURL=sttSettings.d.ts.map

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

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

package/dist/stt/sttSettings.js

@@ -0,0 +1,387 @@
+"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.resetSttConfigCache = exports.loadSttConfig = exports.gigaamLanguage = exports.defaultGigaamThreads = exports.defaultGigaamWorkers = exports.defaultGigaamIdleMinutes = exports.defaultSttTimeout = exports.sttGigaamWorkerChoices = exports.sttEngineLimit = exports.sttEngineKinds = exports.sttConfigFileName = void 0;
+exports.createEmptySttConfig = createEmptySttConfig;
+exports.clampSttWorkers = clampSttWorkers;
+exports.normaliseSttConfig = normaliseSttConfig;
+exports.validateSttConfig = validateSttConfig;
+exports.getSttConfigPath = getSttConfigPath;
+exports.saveSttConfig = saveSttConfig;
+exports.migrateLegacySttKeys = migrateLegacySttKeys;
+exports.createSttEngineId = createSttEngineId;
+exports.resolveSttSettings = resolveSttSettings;
+exports.getNoEngineNoticeCode = getNoEngineNoticeCode;
+exports.getSttReportLines = getSttReportLines;
+exports.getEngineTimeoutMs = getEngineTimeoutMs;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const zod_1 = require("zod");
+const configDirFile_1 = require("../configDirFile");
+const legacyNames_1 = require("../legacyNames");
+const transcribeAudio_1 = require("../utils/transcribeAudio");
+/**
+ * @description The voice-recognition settings: ONE JSON file, `stt.json`, next to
+ * the instance's `.env`, holding the engine chain, the language, the local
+ * engine's knobs AND the API keys. `/stt` writes it; an operator may hand-edit
+ * it, and the next voice note sees the edit (the load is cached by file stamp).
+ *
+ * Validation is strict and all-or-nothing, like `jira.json`: a typo is an error
+ * that NAMES the field and never echoes a value (a key may sit next to it), and
+ * an invalid edit keeps the last good settings instead of silently dropping an
+ * engine.
+ */
+/** The file in the config dir. */
+exports.sttConfigFileName = 'stt.json';
+exports.sttEngineKinds = ['gigaam', 'groq', 'openai', 'url'];
+/** The most engines one chain holds. */
+exports.sttEngineLimit = 6;
+/** The worker counts `/stt` offers; a hand-edited value is clamped to the nearest one. */
+exports.sttGigaamWorkerChoices = [1, 2, 4, 8];
+exports.defaultSttTimeout = { baseSeconds: 10, percentOfDuration: 25 };
+exports.defaultGigaamIdleMinutes = 15;
+exports.defaultGigaamWorkers = 4;
+/** Intra-op threads per worker; `workers × threads` should not exceed the CPU count. */
+exports.defaultGigaamThreads = 2;
+/** Voice length assumed for the timeout when Telegram did not report one. */
+const unknownVoiceDurationSeconds = 60;
+/** The only language the local engine knows. */
+exports.gigaamLanguage = 'ru';
+const percentDivisor = 100;
+const millisecondsPerSecond = 1000;
+const engineIdRe = /^[a-z0-9]{1,8}$/;
+const languageRe = /^[a-z]{2}$/;
+const maxTimeoutBaseSeconds = 600;
+const maxTimeoutPercent = 400;
+const maxIdleMinutes = 24 * 60; // a day: longer is "never" (0)
+const maxWorkers = 64;
+const maxThreads = 32;
+/** The file holds API keys: owner-only. */
+const configFileMode = 0o600;
+const timeoutSchema = zod_1.z.strictObject({
+    baseSeconds: zod_1.z.number().min(1).max(maxTimeoutBaseSeconds),
+    percentOfDuration: zod_1.z.number().min(0).max(maxTimeoutPercent),
+});
+const engineSchema = zod_1.z.strictObject({
+    id: zod_1.z.string().regex(engineIdRe, 'must be 1-8 lowercase letters or digits'),
+    kind: zod_1.z.enum(exports.sttEngineKinds),
+    isDisabled: zod_1.z.boolean().optional(),
+    timeout: timeoutSchema.optional(),
+    url: zod_1.z.string().min(1).optional(),
+    model: zod_1.z.string().min(1).optional(),
+    apiKey: zod_1.z.string().min(1).optional(),
+});
+const gigaamSchema = zod_1.z.strictObject({
+    idleMinutes: zod_1.z.number().int().min(0).max(maxIdleMinutes).optional(),
+    workers: zod_1.z.number().int().min(1).max(maxWorkers).optional(),
+    threads: zod_1.z.number().int().min(1).max(maxThreads).optional(),
+});
+const rawConfigSchema = zod_1.z.strictObject({
+    engines: zod_1.z.array(engineSchema).max(exports.sttEngineLimit).optional(),
+    language: zod_1.z.string().regex(languageRe, 'must be a two-letter ISO-639-1 code like ru').nullable().optional(),
+    gigaam: gigaamSchema.optional(),
+});
+/** @description The settings of an instance that has no `stt.json`: no engines, auto language. */
+function createEmptySttConfig() {
+    return {
+        engines: [],
+        language: null,
+        gigaam: { idleMinutes: exports.defaultGigaamIdleMinutes, workers: exports.defaultGigaamWorkers },
+    };
+}
+/** @description The worker count nearest to `workers` among {@link sttGigaamWorkerChoices} (a tie goes to the smaller). */
+function clampSttWorkers(workers) {
+    return exports.sttGigaamWorkerChoices.reduce((nearest, choice) => Math.abs(choice - workers) < Math.abs(nearest - workers) ? choice : nearest);
+}
+/** @description `config` with the worker count clamped to a choice `/stt` offers. */
+function normaliseSttConfig(config) {
+    return { ...config, gigaam: { ...config.gigaam, workers: clampSttWorkers(config.gigaam.workers) } };
+}
+function getUrlError(url) {
+    try {
+        const protocol = new URL(url).protocol;
+        return protocol === 'http:' || protocol === 'https:' ? null : 'must be an http(s) URL';
+    }
+    catch {
+        return 'must be an http(s) URL';
+    }
+}
+function createConfigFromRaw(raw) {
+    const empty = createEmptySttConfig();
+    const gigaam = {
+        idleMinutes: raw.gigaam?.idleMinutes ?? empty.gigaam.idleMinutes,
+        workers: raw.gigaam?.workers ?? empty.gigaam.workers,
+        ...(raw.gigaam?.threads !== undefined ? { threads: raw.gigaam.threads } : {}),
+    };
+    return normaliseSttConfig({ engines: raw.engines ?? [], language: raw.language ?? null, gigaam });
+}
+/**
+ * @description Validate a parsed `stt.json` object. Every error names its field
+ * (`stt.json engines.1.timeout.baseSeconds: …`) and never carries a value.
+ */
+function validateSttConfig(parsedJson) {
+    const parsed = rawConfigSchema.safeParse(parsedJson);
+    if (!parsed.success) {
+        return {
+            ok: false,
+            errors: parsed.error.issues.map((issue) => `stt.json ${issue.path.join('.') || '(root)'}: ${issue.message}`),
+        };
+    }
+    const errors = [];
+    const seenIds = new Set();
+    let isGigaamSeen = false;
+    (parsed.data.engines ?? []).forEach((engine, index) => {
+        if (seenIds.has(engine.id))
+            errors.push(`stt.json engines.${index}.id: duplicate id`);
+        seenIds.add(engine.id);
+        if (engine.kind === 'gigaam') {
+            if (isGigaamSeen)
+                errors.push(`stt.json engines.${index}.kind: the local engine can be listed only once`);
+            isGigaamSeen = true;
+        }
+        const urlError = engine.url === undefined ? null : getUrlError(engine.url);
+        if (urlError)
+            errors.push(`stt.json engines.${index}.url: ${urlError}`);
+    });
+    if (errors.length > 0)
+        return { ok: false, errors };
+    return { ok: true, config: createConfigFromRaw(parsed.data) };
+}
+/**
+ * @description Where `stt.json` lives: beside the instance's REAL env file (see {@link getConfigDirFilePath} for
+ * the rules — a symlinked `.env` is resolved, so the file that holds API keys lands beside the real one).
+ */
+function getSttConfigPath(env = process.env, homeDir = os.homedir()) {
+    return (0, configDirFile_1.getConfigDirFilePath)(exports.sttConfigFileName, env, homeDir);
+}
+const sttConfigLoader = (0, configDirFile_1.createConfigFileLoader)({
+    fileName: exports.sttConfigFileName,
+    createEmpty: createEmptySttConfig,
+    validate: validateSttConfig,
+});
+/**
+ * @description Read and validate `stt.json`, cached by the file's stamp
+ * (mtime, size, inode) so a per-voice call costs one `stat`. A missing file is
+ * the empty settings; an unreadable or invalid one keeps the last good settings.
+ */
+exports.loadSttConfig = sttConfigLoader.load;
+/** @description Forget every cached load — for tests, which swap files under one path. */
+exports.resetSttConfigCache = sttConfigLoader.resetCache;
+/**
+ * @description Write `config` to `filePath`: validated first (a caller that builds
+ * an invalid file has a bug), then written mode 0600 through a temp file and a
+ * rename, so a reader never sees half a file.
+ */
+function saveSttConfig(filePath, config) {
+    const normalised = normaliseSttConfig(config);
+    const validation = validateSttConfig(normalised);
+    if (!validation.ok)
+        throw new Error(`refusing to write an invalid stt.json: ${validation.errors.join('; ')}`);
+    (0, configDirFile_1.writeJsonFileAtomically)(filePath, normalised, configFileMode);
+}
+/** The env variables the one-time migration reads: the only place that does. */
+const legacyGroqKeyName = 'GROQ_API_KEY';
+const legacyOpenAiKeyName = 'OPENAI_API_KEY';
+const legacyKeysDeprecationKey = 'stt-env-keys';
+const legacyKeysDeprecationMessage = 'GROQ_API_KEY/OPENAI_API_KEY in .env is deprecated, voice settings now live in stt.json';
+/**
+ * @description The ONE-TIME migration of the pre-`stt.json` setup: with no file
+ * yet and `GROQ_API_KEY` / `OPENAI_API_KEY` set, write `stt.json` with those
+ * engines (Groq first) and their keys. From then on the env keys are ignored;
+ * a process that still sees one says so once. Never overwrites an existing file.
+ */
+function migrateLegacySttKeys(filePath, env = process.env, writeLine) {
+    const groqKey = env[legacyGroqKeyName];
+    const openAiKey = env[legacyOpenAiKeyName];
+    if (!groqKey && !openAiKey)
+        return { status: 'noKeys' };
+    (0, legacyNames_1.warnLegacyNameOnce)(legacyKeysDeprecationKey, legacyKeysDeprecationMessage, writeLine);
+    if (fs.existsSync(filePath))
+        return { status: 'fileExists' };
+    const config = createEmptySttConfig();
+    if (groqKey)
+        config.engines.push({ id: createSttEngineId('groq', new Set()), kind: 'groq', apiKey: groqKey });
+    if (openAiKey)
+        config.engines.push({ id: createSttEngineId('openai', new Set()), kind: 'openai', apiKey: openAiKey });
+    try {
+        saveSttConfig(filePath, config);
+    }
+    catch (e) {
+        return { status: 'writeFailed', error: (0, configDirFile_1.getCaughtErrnoCode)(e) };
+    }
+    return { status: 'migrated', engineNames: config.engines.map((engine) => engine.kind) };
+}
+/**
+ * @description `/stt`'s engine id for a new engine of `kind`: `g` for the local
+ * one, else the kind's letter plus the smallest number not taken (`q1`, `o2`, `u1`).
+ */
+function createSttEngineId(kind, takenIds) {
+    if (kind === 'gigaam')
+        return 'g';
+    const letter = kind === 'groq' ? 'q' : kind === 'openai' ? 'o' : 'u';
+    let number = 1;
+    while (takenIds.has(`${letter}${number}`))
+        number++;
+    return `${letter}${number}`;
+}
+function getUnavailableReason(engine, config, facts) {
+    if (engine.isDisabled)
+        return 'disabled';
+    switch (engine.kind) {
+        case 'gigaam':
+            if (!facts.hasOwnerContext)
+                return 'noOwnerContext';
+            if (config.language !== null && config.language !== exports.gigaamLanguage)
+                return 'languageNotSupported';
+            if (facts.isGigaamInstalling)
+                return 'installing';
+            if (!facts.isGigaamInstalled)
+                return 'notInstalled';
+            return facts.isGigaamUnhealthy ? 'unhealthy' : null;
+        case 'groq':
+        case 'openai':
+            return engine.apiKey ? null : 'missingKey';
+        case 'url':
+            return engine.url ? null : 'missingUrl';
+    }
+}
+function getEngineName(engine) {
+    if (engine.kind !== 'url')
+        return engine.kind;
+    try {
+        return `url:${new URL(engine.url ?? '').host}`;
+    }
+    catch {
+        return 'url';
+    }
+}
+/** The endpoint of an engine that needs no process: its key and URL are in the file. */
+function createStaticEndpoint(engine) {
+    if (engine.kind === 'groq')
+        return (0, transcribeAudio_1.createGroqEndpoint)(engine.apiKey ?? '');
+    if (engine.kind === 'openai')
+        return (0, transcribeAudio_1.createOpenAiEndpoint)(engine.apiKey ?? '');
+    return (0, transcribeAudio_1.createCustomEndpoint)({ url: engine.url ?? '', apiKey: engine.apiKey, model: engine.model });
+}
+/**
+ * @description Turn the loaded settings into the chain a voice note walks:
+ * the available engines in order, the skipped ones with their reason, and
+ * whether the local engine has to be installed first.
+ */
+function resolveSttSettings(load, facts, options = {}) {
+    const settings = load.config ?? createEmptySttConfig();
+    const engines = [];
+    const unavailable = [];
+    for (const engine of settings.engines) {
+        const getEndpoint = engine.kind === 'gigaam' ? options.getGigaamEndpoint : () => Promise.resolve(createStaticEndpoint(engine));
+        // No hook to start the process means no owner to start it for.
+        const reason = getUnavailableReason(engine, settings, facts) ?? (getEndpoint ? null : 'noOwnerContext');
+        if (reason || !getEndpoint) {
+            unavailable.push({ id: engine.id, kind: engine.kind, reason: reason ?? 'noOwnerContext' });
+            continue;
+        }
+        engines.push({
+            id: engine.id,
+            kind: engine.kind,
+            name: getEngineName(engine),
+            timeout: engine.timeout ?? exports.defaultSttTimeout,
+            getEndpoint,
+        });
+    }
+    const needsAutoInstall = settings.engines.some((engine) => engine.kind === 'gigaam' && !engine.isDisabled && !facts.isGigaamInstalled && !facts.isGigaamInstalling);
+    return {
+        settings,
+        source: load.status === 'invalid' ? (load.config ? 'lastGood' : 'invalid') : load.status,
+        engines,
+        unavailable,
+        needsAutoInstall,
+        errors: load.status === 'invalid' ? load.errors : [],
+    };
+}
+const unavailableReasonTexts = {
+    disabled: 'disabled',
+    notInstalled: 'not installed',
+    installing: 'still installing',
+    unhealthy: 'marked unhealthy after repeated start failures',
+    languageNotSupported: 'the local engine only knows Russian',
+    noOwnerContext: 'it has no owner process to be tied to (a hot supervisor that predates local recognition: restart it)',
+    missingKey: 'no API key',
+    missingUrl: 'no URL',
+};
+/**
+ * @description The i18n key of the notice a voice note gets when NO engine can take it, from the most specific
+ * cause down: a broken `stt.json`; the local engine still installing (the voice is not refused for good — send it
+ * again); engines that are listed but unusable right now; and none set up (or all switched off by the operator).
+ */
+function getNoEngineNoticeCode(resolved) {
+    if (resolved.errors.length > 0)
+        return 'voice.config_invalid';
+    if (resolved.unavailable.some((engine) => engine.reason === 'installing'))
+        return 'voice.local_installing';
+    if (resolved.unavailable.some((engine) => engine.reason !== 'disabled'))
+        return 'voice.engines_unavailable';
+    return 'voice.no_api_key';
+}
+/**
+ * @description The `[STT]` log lines for what is wrong with the settings:
+ * file errors (with what the bot does instead), skipped engines (a disabled one
+ * is the operator's choice, not a problem) and an empty chain (unless the file itself
+ * is unusable, which its own error already says). Empty → all well.
+ */
+function getSttReportLines(resolved) {
+    const errorSuffix = resolved.source === 'lastGood' ? 'keeping the last good settings' : 'no voice settings loaded';
+    const lines = resolved.errors.map((error) => `[STT] ${error} (${errorSuffix})`);
+    for (const skipped of resolved.unavailable) {
+        if (skipped.reason === 'disabled')
+            continue;
+        lines.push(`[STT] engine ${skipped.id} (${skipped.kind}) is skipped: ${unavailableReasonTexts[skipped.reason]}`);
+    }
+    if (resolved.engines.length === 0 && resolved.source !== 'invalid') {
+        lines.push('[STT] no speech engine is available: voice notes are refused until one is set up');
+    }
+    return lines;
+}
+/**
+ * @description The request budget for one voice: `baseSeconds` plus
+ * `percentOfDuration` % of the voice's length (Telegram's `voice.duration`). A missing length — or a `0`, which
+ * Telegram reports for a note whose length it could not read — is "unknown", not a 0-second voice: it is
+ * budgeted as {@link unknownVoiceDurationSeconds}, so a long voice without a length is not cut at the bare base.
+ * Long voices stay on their engine, they just get more time.
+ */
+function getEngineTimeoutMs(timeout, durationSeconds) {
+    const voiceSeconds = durationSeconds !== undefined && durationSeconds > 0 ? durationSeconds : unknownVoiceDurationSeconds;
+    return (timeout.baseSeconds + (timeout.percentOfDuration / percentDivisor) * voiceSeconds) * millisecondsPerSecond;
+}
+//# sourceMappingURL=sttSettings.js.map

package/dist/stt/sttSettings.js.map

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