charness 3.2.0 → 3.3.0

package/dist/utils/openCodeUsage.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * @description The USAGE of OpenCode providers signed in through a SUBSCRIPTION — what `/limits` and `/accounts` print
+ * beside an OpenCode provider the way they print a Claude account's windows. v1 knows one provider: `openai` signed in
+ * with a ChatGPT subscription (an `oauth` record in OpenCode's `auth.json`), read off
+ * `GET https://chatgpt.com/backend-api/wham/usage` — the endpoint the Codex CLI and ChatGPT's own settings page use. It
+ * has no published schema; the field names below (`rate_limit.primary_window` / `secondary_window`, each with
+ * `used_percent`, `limit_window_seconds`, `reset_after_seconds`, `reset_at`) come from third-party documentation of it
+ * (the codex-lb proxy's API reference), so the parser is tolerant and an unknown shape yields no windows — the row just
+ * has no usage. API-key providers and other subscriptions have no reader: they show their auth kind only.
+ *
+ * Like a Claude profile's usage (`claudeUsage.ts`): the stored token is used as is and NEVER refreshed here (OpenCode
+ * renews it; a bot-side refresh would race it) — a token past its expiry is not sent and marks the snapshot stale; the
+ * token is never logged. Snapshots reuse the Claude shape (`ClaudeUsageSnapshot`: the primary window is `session`, the
+ * secondary `weekly_all`), so `formatClaudeProfileUsageLines` renders them unchanged. Pure except
+ * {@link readOpenCodeCredentials} (one file read) and the injectable fetch.
+ */
+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.openCodeUsageReaders = exports.chatGptProviderId = exports.chatGptUsageEndpoint = void 0;
+exports.parseOpenCodeCredentials = parseOpenCodeCredentials;
+exports.readOpenCodeCredentials = readOpenCodeCredentials;
+exports.parseChatGptUsageResponse = parseChatGptUsageResponse;
+exports.fetchChatGptUsage = fetchChatGptUsage;
+exports.createOpenCodeUsagePoller = createOpenCodeUsagePoller;
+const fs = __importStar(require("fs"));
+const claudeUsage_1 = require("./claudeUsage");
+exports.chatGptUsageEndpoint = 'https://chatgpt.com/backend-api/wham/usage';
+/** The OpenCode provider a ChatGPT subscription signs in to. */
+exports.chatGptProviderId = 'openai';
+/** A window up to this long counts as the short (5-hour) one, a longer window as the weekly one. */
+const shortWindowMaxSeconds = 24 * 3600;
+function checkIsRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readAuthKind(type) {
+    if (type === 'oauth')
+        return 'subscription';
+    if (type === 'api')
+        return 'apiKey';
+    return 'unknown';
+}
+/**
+ * @description The providers of a parsed `auth.json` with their credential kind; a malformed entry is skipped, never
+ * thrown on. `null` when the document is not an object.
+ */
+function parseOpenCodeCredentials(authJson) {
+    if (!checkIsRecord(authJson))
+        return null;
+    const credentials = {};
+    for (const [providerId, entry] of Object.entries(authJson)) {
+        if (!checkIsRecord(entry))
+            continue;
+        credentials[providerId] = {
+            kind: readAuthKind(entry.type),
+            accessToken: typeof entry.access === 'string' && entry.access !== '' ? entry.access : null,
+            expiresAtMs: typeof entry.expires === 'number' ? entry.expires : null,
+            accountId: typeof entry.accountId === 'string' && entry.accountId !== '' ? entry.accountId : null,
+        };
+    }
+    return credentials;
+}
+/** @description {@link parseOpenCodeCredentials} of the file at `authFilePath`; `null` when it is missing or unreadable. */
+function readOpenCodeCredentials(authFilePath) {
+    try {
+        return parseOpenCodeCredentials(JSON.parse(fs.readFileSync(authFilePath, 'utf8')));
+    }
+    catch {
+        return null;
+    }
+}
+// ── the ChatGPT reader ──
+/** The account id inside a ChatGPT access token (a JWT): the claim `chatgpt_account_id` under `https://api.openai.com/auth`. */
+function readAccountIdFromJwt(accessToken) {
+    const payload = accessToken.split('.')[1];
+    if (payload === undefined)
+        return null;
+    try {
+        const claims = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8'));
+        const auth = checkIsRecord(claims) ? claims['https://api.openai.com/auth'] : null;
+        return checkIsRecord(auth) && typeof auth.chatgpt_account_id === 'string' ? auth.chatgpt_account_id : null;
+    }
+    catch {
+        return null;
+    }
+}
+function clampPercent(value) {
+    return Math.max(0, Math.min(100, Math.round(value)));
+}
+/** A window's reset as an ISO instant: its own `reset_at` (Unix seconds), else `reset_after_seconds` from now. */
+function readResetsAt(window, nowMs) {
+    if (typeof window.reset_at === 'number')
+        return new Date(window.reset_at * 1000).toISOString();
+    if (typeof window.reset_after_seconds === 'number')
+        return new Date(nowMs + window.reset_after_seconds * 1000).toISOString();
+    return null;
+}
+/**
+ * @description The windows of a ChatGPT usage response as Claude-shaped buckets. A window is the 5-hour `session` when
+ * its length (`limit_window_seconds`) is a day or less, else the weekly one; a window that names no length is read by
+ * its place (primary = 5-hour, secondary = weekly). An account with one window only (a weekly-only plan) yields that
+ * bucket. A body of another shape yields none.
+ */
+function parseChatGptUsageResponse(body, nowMs) {
+    const rateLimit = checkIsRecord(body) ? body.rate_limit : null;
+    if (!checkIsRecord(rateLimit))
+        return [];
+    const buckets = [];
+    for (const [field, placeKind] of [['primary_window', 'session'], ['secondary_window', 'weekly_all']]) {
+        const window = rateLimit[field];
+        if (!checkIsRecord(window) || typeof window.used_percent !== 'number')
+            continue;
+        const length = window.limit_window_seconds;
+        const kind = typeof length === 'number' ? (length <= shortWindowMaxSeconds ? 'session' : 'weekly_all') : placeKind;
+        if (buckets.some((bucket) => bucket.kind === kind))
+            continue;
+        buckets.push({ kind, percent: clampPercent(window.used_percent), resetsAt: readResetsAt(window, nowMs), scopeModel: null });
+    }
+    return buckets;
+}
+/**
+ * @description One GET of the ChatGPT usage endpoint with the subscription's token and account id (the id off the record,
+ * else off the token). Never throws; the token never appears in the result.
+ */
+function fetchChatGptUsage(credential, options = {}) {
+    const accessToken = credential.accessToken ?? '';
+    const accountId = credential.accountId ?? readAccountIdFromJwt(accessToken);
+    const nowMs = options.nowMs ?? Date.now();
+    return (0, claudeUsage_1.fetchUsageBuckets)({
+        url: exports.chatGptUsageEndpoint,
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            Accept: 'application/json',
+            ...(accountId === null ? {} : { 'ChatGPT-Account-Id': accountId }),
+        },
+        parse: (body) => parseChatGptUsageResponse(body, nowMs),
+        fetchImpl: options.fetchImpl,
+        timeoutMs: options.timeoutMs,
+    });
+}
+/** The subscription usage readers by provider id; a provider not here shows only its auth kind. */
+exports.openCodeUsageReaders = {
+    [exports.chatGptProviderId]: (credential) => fetchChatGptUsage(credential),
+};
+/**
+ * @description The poller of OpenCode providers' usage. For each provider in `auth.json`: an API key or an unknown record
+ * is stored as its kind alone (no usage); a subscription with a reader is polled — an expired token is not sent and marks
+ * the snapshot stale, a failed poll keeps the last figures marked stale. A provider `auth.json` does not list (one
+ * enabled by an environment variable) is left as it is. A failure is logged once per change of its reason — a poll every
+ * ten minutes must not fill the log — and never reported to error tracking (nothing for us to fix).
+ */
+function createOpenCodeUsagePoller(deps) {
+    const now = deps.now ?? (() => Date.now());
+    const log = deps.log ?? ((line) => console.log(line));
+    const readers = deps.readers ?? exports.openCodeUsageReaders;
+    function saveIfChanged(providerId, previous, next) {
+        if (JSON.stringify(previous) !== JSON.stringify(next))
+            deps.saveRecord(providerId, next);
+    }
+    function logFailureOnce(providerId, previous, reason) {
+        if (previous?.usage?.isStale && previous.usage.error === reason)
+            return;
+        log(`[usage] OpenCode ${providerId}: usage unavailable (${reason})`);
+    }
+    async function pollSubscription(providerId, credential, previous) {
+        const reader = readers[providerId];
+        if (reader === undefined) {
+            saveIfChanged(providerId, previous, { authKind: 'subscription' });
+            return;
+        }
+        const markStale = (reason) => {
+            logFailureOnce(providerId, previous, reason);
+            saveIfChanged(providerId, previous, { authKind: 'subscription', usage: (0, claudeUsage_1.markClaudeUsageSnapshotStale)(previous?.usage, reason, now()) });
+        };
+        if (credential.accessToken === null) {
+            markStale('not signed in');
+            return;
+        }
+        if (credential.expiresAtMs !== null && credential.expiresAtMs <= now()) {
+            markStale('token expired');
+            return;
+        }
+        const result = await reader(credential);
+        if (!result.ok) {
+            markStale(result.error);
+            return;
+        }
+        deps.saveRecord(providerId, { authKind: 'subscription', usage: (0, claudeUsage_1.mergeClaudeUsageSnapshot)(previous?.usage, result.buckets, 'api', now()) });
+    }
+    function checkNeedsPoll(previous, maxAgeMs) {
+        if (maxAgeMs === undefined || !previous?.usage || previous.usage.isStale)
+            return true;
+        return now() - Date.parse(previous.usage.fetchedAt) >= maxAgeMs;
+    }
+    async function refreshAll(options = {}) {
+        const credentials = deps.readCredentials();
+        if (credentials === null)
+            return;
+        await Promise.all(Object.entries(credentials).map(async ([providerId, credential]) => {
+            const previous = deps.getRecord(providerId);
+            try {
+                if (credential.kind !== 'subscription') {
+                    saveIfChanged(providerId, previous, { authKind: credential.kind });
+                }
+                else if (checkNeedsPoll(previous, options.maxAgeMs)) {
+                    await pollSubscription(providerId, credential, previous);
+                }
+            }
+            catch (e) {
+                log(`[usage] OpenCode ${providerId}: usage poll threw: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }));
+    }
+    return { refreshAll };
+}
+//# sourceMappingURL=openCodeUsage.js.map

package/dist/utils/openCodeUsage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openCodeUsage.js","sourceRoot":"","sources":["../../src/utils/openCodeUsage.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DH,4DAaC;AAGD,0DAMC;AAkCD,8DAaC;AAMD,8CAkBC;AAmCD,8DAsDC;AAhPD,uCAAyB;AACzB,+CASuB;AAEV,QAAA,oBAAoB,GAAG,4CAA4C,CAAC;AAEjF,gEAAgE;AACnD,QAAA,iBAAiB,GAAG,QAAQ,CAAC;AAc1C,oGAAoG;AACpG,MAAM,qBAAqB,GAAG,EAAE,GAAG,IAAI,CAAC;AAcxC,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,IAAa;IACjC,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,cAAc,CAAC;IAC5C,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,QAAQ,CAAC;IACpC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAgB,wBAAwB,CAAC,QAAiB;IACxD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,WAAW,GAA+C,EAAE,CAAC;IACnE,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,WAAW,CAAC,UAAU,CAAC,GAAG;YACxB,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;YAC9B,WAAW,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;YAC1F,WAAW,EAAE,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YACrE,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;SAClG,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,4HAA4H;AAC5H,SAAgB,uBAAuB,CAAC,YAAoB;IAC1D,IAAI,CAAC;QACH,OAAO,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,2BAA2B;AAE3B,gIAAgI;AAChI,SAAS,oBAAoB,CAAC,WAAmB;IAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACvF,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAClF,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,kHAAkH;AAClH,SAAS,YAAY,CAAC,MAA+B,EAAE,KAAa;IAClE,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/F,IAAI,OAAO,MAAM,CAAC,mBAAmB,KAAK,QAAQ;QAAE,OAAO,IAAI,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7H,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAC,IAAa,EAAE,KAAa;IACpE,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IACzC,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,SAAS,CAAC,EAAE,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAU,EAAE,CAAC;QAC9G,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ;YAAE,SAAS;QAChF,MAAM,MAAM,GAAG,MAAM,CAAC,oBAAoB,CAAC;QAC3C,MAAM,IAAI,GAA0B,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1I,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QAC7D,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9H,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAC/B,UAAsC,EACtC,UAA8E,EAAE;IAEhF,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IAC1C,OAAO,IAAA,+BAAiB,EAAC;QACvB,GAAG,EAAE,4BAAoB;QACzB,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,WAAW,EAAE;YACtC,MAAM,EAAE,kBAAkB;YAC1B,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,SAAS,EAAE,CAAC;SACnE;QACD,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,EAAE,KAAK,CAAC;QACvD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;AACL,CAAC;AAKD,mGAAmG;AACtF,QAAA,oBAAoB,GAAkD;IACjF,CAAC,yBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC;CACnE,CAAC;AAoBF;;;;;;GAMG;AACH,SAAgB,yBAAyB,CAAC,IAA6B;IACrE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,4BAAoB,CAAC;IAErD,SAAS,aAAa,CAAC,UAAkB,EAAE,QAAiD,EAAE,IAAiC;QAC7H,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC3F,CAAC;IAED,SAAS,cAAc,CAAC,UAAkB,EAAE,QAAiD,EAAE,MAAc;QAC3G,IAAI,QAAQ,EAAE,KAAK,EAAE,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO;QACxE,GAAG,CAAC,oBAAoB,UAAU,wBAAwB,MAAM,GAAG,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,UAAU,gBAAgB,CAAC,UAAkB,EAAE,UAAsC,EAAE,QAAiD;QAC3I,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,aAAa,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,MAAc,EAAQ,EAAE;YACzC,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC7C,aAAa,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,IAAA,0CAA4B,EAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACzI,CAAC,CAAC;QACF,IAAI,UAAU,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC5E,IAAI,UAAU,CAAC,WAAW,KAAK,IAAI,IAAI,UAAU,CAAC,WAAW,IAAI,GAAG,EAAE,EAAE,CAAC;YAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC/G,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,IAAA,sCAAwB,EAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5I,CAAC;IAED,SAAS,cAAc,CAAC,QAAiD,EAAE,QAA4B;QACrG,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QACtF,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC;IAClE,CAAC;IAED,KAAK,UAAU,UAAU,CAAC,UAAiC,EAAE;QAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QAC3C,IAAI,WAAW,KAAK,IAAI;YAAE,OAAO;QACjC,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,EAAE;YACnF,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAC5C,IAAI,CAAC;gBACH,IAAI,UAAU,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBACvC,aAAa,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrE,CAAC;qBAAM,IAAI,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACtD,MAAM,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,CAAC,oBAAoB,UAAU,uBAAuB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzG,CAAC;QACH,CAAC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC"}

package/dist/utils/operatorSwitchPlan.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @description The pure decision behind the ONE switch path the operator's own picks share — a row of `/limits` or
+ * `/accounts`, a model page, `/accounts use`: given where the topic runs and where it was told to go, WHICH kind of
+ * move it is. `bot.ts` (`switchTopicByOperator`) makes the move; the screens only ask for it and word their toast
+ * from the outcome.
+ */
+import type { FallbackChainEntry } from './fallbackChain';
+import type { BackendFamily } from './backendSwitchPlan';
+/**
+ * How the topic gets to the picked rung:
+ *   - `limitMove`  — a usage-limit wait is armed: the pick is the limit move (the wait is dropped, the work continues,
+ *                    a conversation is handed over without the question);
+ *   - `sameFamily` — the topic stays on the backend it runs (or has none, and a Claude account is only recorded for
+ *                    its next start): a Claude pick changes the account, an OpenCode pick the model — the conversation is kept;
+ *   - `askFirst`   — the other backend, with a conversation to hand over: the operator is asked first;
+ *   - `switchNow`  — the other backend with nothing to carry (or no agent yet): the target is started at once.
+ */
+export type OperatorSwitchRoute = 'limitMove' | 'sameFamily' | 'askFirst' | 'switchNow';
+/**
+ * What a screen is told about a pick. `switched` carries the bot's own confirmation line (`text`) and where the topic runs now
+ * in words (`label`: `Claude «work» (sonnet)`, `OpenCode openai/gpt-5`), from which a screen words its short toast; `asked` means
+ * the hand-over question is already in the topic and nothing more is to be said; `refused` carries why nothing moved.
+ */
+export type OperatorSwitchOutcome = {
+    kind: 'switched';
+    text: string;
+    label: string;
+} | {
+    kind: 'asked';
+} | {
+    kind: 'refused';
+    text: string;
+};
+export interface OperatorSwitchInput {
+    /** A usage-limit wait is armed for the topic. */
+    isUsageLimitWaitArmed: boolean;
+    /** The rung the topic runs on now; `null` for no agent, a shell, or an OpenCode on the server's default model. */
+    from: FallbackChainEntry | null;
+    to: FallbackChainEntry;
+    /** The backend family the topic's agent runs on; `null` for no agent or a shell. */
+    currentFamily: BackendFamily | null;
+    /** Whether the agent being left holds a conversation to hand over (only read when the families differ). */
+    hasConversation: boolean;
+    /**
+     * The pick names another model of the SAME Claude account and that model is clear of the exhausted window (a Fable-only
+     * weekly limit does not stop `sonnet`): the work can continue on it, so with a wait armed the pick is the limit move.
+     */
+    isPickBeyondLimit?: boolean;
+}
+/**
+ * @description The route of a pick, in this order:
+ *   1. a wait is armed and the pick leaves the account (Claude) / model (OpenCode) that hit the limit, or names a model of the
+ *      same Claude account that the limit does not cover → `limitMove`; a pick still inside the limit's scope (another model
+ *      under the same exhausted window) only changes the model and the wait stays;
+ *   2. the topic runs no agent of a family (nothing, a shell): a Claude pick is recorded for the next start
+ *      (`sameFamily`), an OpenCode pick starts OpenCode on it (`switchNow`);
+ *   3. the topic runs the picked family → `sameFamily`;
+ *   4. otherwise the other backend: `askFirst` with a conversation, `switchNow` without.
+ */
+export declare function decideOperatorSwitch(input: OperatorSwitchInput): OperatorSwitchRoute;
+//# sourceMappingURL=operatorSwitchPlan.d.ts.map

package/dist/utils/operatorSwitchPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operatorSwitchPlan.d.ts","sourceRoot":"","sources":["../../src/utils/operatorSwitchPlan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,CAAC;AAExF;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kHAAkH;IAClH,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAChC,EAAE,EAAE,kBAAkB,CAAC;IACvB,oFAAoF;IACpF,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,2GAA2G;IAC3G,eAAe,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,CAOpF"}

package/dist/utils/operatorSwitchPlan.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * @description The pure decision behind the ONE switch path the operator's own picks share — a row of `/limits` or
+ * `/accounts`, a model page, `/accounts use`: given where the topic runs and where it was told to go, WHICH kind of
+ * move it is. `bot.ts` (`switchTopicByOperator`) makes the move; the screens only ask for it and word their toast
+ * from the outcome.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decideOperatorSwitch = decideOperatorSwitch;
+const fallbackChain_1 = require("./fallbackChain");
+/**
+ * @description The route of a pick, in this order:
+ *   1. a wait is armed and the pick leaves the account (Claude) / model (OpenCode) that hit the limit, or names a model of the
+ *      same Claude account that the limit does not cover → `limitMove`; a pick still inside the limit's scope (another model
+ *      under the same exhausted window) only changes the model and the wait stays;
+ *   2. the topic runs no agent of a family (nothing, a shell): a Claude pick is recorded for the next start
+ *      (`sameFamily`), an OpenCode pick starts OpenCode on it (`switchNow`);
+ *   3. the topic runs the picked family → `sameFamily`;
+ *   4. otherwise the other backend: `askFirst` with a conversation, `switchNow` without.
+ */
+function decideOperatorSwitch(input) {
+    const { from, to, currentFamily } = input;
+    const isLeavingLimitedRung = from === null || !(0, fallbackChain_1.checkIsSameFallbackAccount)(from, to);
+    if (input.isUsageLimitWaitArmed && currentFamily !== null && (isLeavingLimitedRung || input.isPickBeyondLimit === true))
+        return 'limitMove';
+    if (currentFamily === null)
+        return to.backend === 'claude' ? 'sameFamily' : 'switchNow';
+    if (currentFamily === to.backend)
+        return 'sameFamily';
+    return input.hasConversation ? 'askFirst' : 'switchNow';
+}
+//# sourceMappingURL=operatorSwitchPlan.js.map

package/dist/utils/operatorSwitchPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operatorSwitchPlan.js","sourceRoot":"","sources":["../../src/utils/operatorSwitchPlan.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAsDH,oDAOC;AA1DD,mDAA6D;AAyC7D;;;;;;;;;GASG;AACH,SAAgB,oBAAoB,CAAC,KAA0B;IAC7D,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAC1C,MAAM,oBAAoB,GAAG,IAAI,KAAK,IAAI,IAAI,CAAC,IAAA,0CAA0B,EAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpF,IAAI,KAAK,CAAC,qBAAqB,IAAI,aAAa,KAAK,IAAI,IAAI,CAAC,oBAAoB,IAAI,KAAK,CAAC,iBAAiB,KAAK,IAAI,CAAC;QAAE,OAAO,WAAW,CAAC;IAC5I,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;IACxF,IAAI,aAAa,KAAK,EAAE,CAAC,OAAO;QAAE,OAAO,YAAY,CAAC;IACtD,OAAO,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;AAC1D,CAAC"}

package/dist/utils/promptDelivery.d.ts

@@ -43,4 +43,44 @@ export type PromptDelivery = 'forwarded' | 'buffered';
  * buffered before the notice went out.
  */
 export declare function deliverPromptOrBuffer(deps: PromptDeliveryDeps, key: SessionKey, text: string, isStarting: boolean, onBufferedSettled?: BufferedPromptSettled): Promise<PromptDelivery>;
+/**
+ * @name LatePromptRoute
+ * @description How a prompt decided on when it ARRIVED is delivered once its handler is ready to forward it:
+ * `buffer` — a start or the idle stop is under way (its window is open: the prompt waits there, and the stop resumes the
+ * session for it); `wake` — the process is gone meanwhile (the conversation sleeps: wake it, then forward); `forward`.
+ */
+export type LatePromptRoute = 'buffer' | 'wake' | 'forward';
+/**
+ * @description The {@link LatePromptRoute} of a prompt, read at the moment it is forwarded. The idle stop posts a
+ * re-asked question just before it stops the process, and a handler awaits between reading the session's state and the
+ * forward (the tap's toast, the request it opens): written into a process being stopped the prompt was lost, and
+ * into one already gone it was dropped.
+ */
+export declare function getLatePromptRoute(input: {
+    isWindowOpen: boolean;
+    isSessionActive: boolean;
+}): LatePromptRoute;
+/**
+ * @name LatePromptDeliveryPorts
+ * @description What {@link deliverLatePrompt} acts through, for one prompt: the session's state read NOW, and the three
+ * ways out. `reportNoSession` runs when the wake found nothing to resume (the ids released, the topic unbound, a start
+ * that failed): it tells the person, as the arrival-time paths do, and closes what the prompt opened.
+ */
+export interface LatePromptDeliveryPorts {
+    checkIsWindowOpen: () => boolean;
+    checkIsSessionActive: () => boolean;
+    buffer: () => Promise<void>;
+    /** Resume the sleeping conversation; `true` once a session is up to forward to. */
+    wake: () => Promise<boolean>;
+    forward: () => Promise<void>;
+    reportNoSession: () => Promise<void>;
+}
+/** @description Where {@link deliverLatePrompt} put the prompt; `noSession` — nowhere: nothing to deliver it to. */
+export type LatePromptOutcome = 'buffered' | 'forwarded' | 'noSession';
+/**
+ * @description Deliver a prompt whose handler decided, when it arrived, that the session is live — routed again by
+ * {@link getLatePromptRoute} now, after the handler's awaits. A wake that finds nothing never forwards: the forward
+ * would show the topic as working while the adapter drops the text.
+ */
+export declare function deliverLatePrompt(ports: LatePromptDeliveryPorts): Promise<LatePromptOutcome>;
 //# sourceMappingURL=promptDelivery.d.ts.map

package/dist/utils/promptDelivery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promptDelivery.d.ts","sourceRoot":"","sources":["../../src/utils/promptDelivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC;IACtD,aAAa,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,kBAAkB,EACxB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,OAAO,EACnB,iBAAiB,CAAC,EAAE,qBAAqB,GACxC,OAAO,CAAC,cAAc,CAAC,CAiBzB"}
+{"version":3,"file":"promptDelivery.d.ts","sourceRoot":"","sources":["../../src/utils/promptDelivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC;IACtD,aAAa,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,kBAAkB,EACxB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,OAAO,EACnB,iBAAiB,CAAC,EAAE,qBAAqB,GACxC,OAAO,CAAC,cAAc,CAAC,CAiBzB;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,GAAG,eAAe,CAG9G;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE,MAAM,OAAO,CAAC;IACjC,oBAAoB,EAAE,MAAM,OAAO,CAAC;IACpC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,mFAAmF;IACnF,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,oHAAoH;AACpH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAEvE;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAYlG"}

package/dist/utils/promptDelivery.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deliverPromptOrBuffer = deliverPromptOrBuffer;
+exports.getLatePromptRoute = getLatePromptRoute;
+exports.deliverLatePrompt = deliverLatePrompt;
 const sessionKey_1 = require("../sessionKey");
 const sessionKeyCodec_1 = require("../connectors/telegram/sessionKeyCodec");
 /**
@@ -46,4 +48,33 @@ async function deliverPromptOrBuffer(deps, key, text, isStarting, onBufferedSett
     }
     return 'buffered';
 }
+/**
+ * @description The {@link LatePromptRoute} of a prompt, read at the moment it is forwarded. The idle stop posts a
+ * re-asked question just before it stops the process, and a handler awaits between reading the session's state and the
+ * forward (the tap's toast, the request it opens): written into a process being stopped the prompt was lost, and
+ * into one already gone it was dropped.
+ */
+function getLatePromptRoute(input) {
+    if (input.isWindowOpen)
+        return 'buffer';
+    return input.isSessionActive ? 'forward' : 'wake';
+}
+/**
+ * @description Deliver a prompt whose handler decided, when it arrived, that the session is live — routed again by
+ * {@link getLatePromptRoute} now, after the handler's awaits. A wake that finds nothing never forwards: the forward
+ * would show the topic as working while the adapter drops the text.
+ */
+async function deliverLatePrompt(ports) {
+    const route = getLatePromptRoute({ isWindowOpen: ports.checkIsWindowOpen(), isSessionActive: ports.checkIsSessionActive() });
+    if (route === 'buffer') {
+        await ports.buffer();
+        return 'buffered';
+    }
+    if (route === 'wake' && !(await ports.wake())) {
+        await ports.reportNoSession();
+        return 'noSession';
+    }
+    await ports.forward();
+    return 'forwarded';
+}
 //# sourceMappingURL=promptDelivery.js.map

package/dist/utils/promptDelivery.js.map

@@ -1 +1 @@
-{"version":3,"file":"promptDelivery.js","sourceRoot":"","sources":["../../src/utils/promptDelivery.ts"],"names":[],"mappings":";;AAgDA,sDAuBC;AAvED,8CAA6D;AAC7D,4EAA4E;AAuB5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,KAAK,UAAU,qBAAqB,CACzC,IAAwB,EACxB,GAAe,EACf,IAAY,EACZ,UAAmB,EACnB,iBAAyC;IAEzC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpC,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,IAAA,wBAAW,EAAC,GAAG,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAChG,IAAI,eAAe,IAAI,IAAA,oCAAkB,EAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,sGAAsG;QACtG,sGAAsG;QACtG,gDAAgD;QAChD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,sCAAsC,IAAA,wBAAW,EAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}
+{"version":3,"file":"promptDelivery.js","sourceRoot":"","sources":["../../src/utils/promptDelivery.ts"],"names":[],"mappings":";;AAgDA,sDAuBC;AAgBD,gDAGC;AA0BD,8CAYC;AAhID,8CAA6D;AAC7D,4EAA4E;AAuB5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,KAAK,UAAU,qBAAqB,CACzC,IAAwB,EACxB,GAAe,EACf,IAAY,EACZ,UAAmB,EACnB,iBAAyC;IAEzC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpC,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,IAAA,wBAAW,EAAC,GAAG,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAChG,IAAI,eAAe,IAAI,IAAA,oCAAkB,EAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,sGAAsG;QACtG,sGAAsG;QACtG,gDAAgD;QAChD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,sCAAsC,IAAA,wBAAW,EAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAUD;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,KAA0D;IAC3F,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,QAAQ,CAAC;IACxC,OAAO,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AACpD,CAAC;AAqBD;;;;GAIG;AACI,KAAK,UAAU,iBAAiB,CAAC,KAA8B;IACpE,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,iBAAiB,EAAE,EAAE,eAAe,EAAE,KAAK,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAC7H,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9C,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IACtB,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/utils/recvPreviewRedaction.d.ts

@@ -1,5 +1,14 @@
 /** Recorded instead of a pasted provider API key while `/connect` is pending. */
 export declare const redactedConnectKeyPreview = "[redacted: provider API key]";
+/** Recorded instead of a pasted speech-engine key while `/stt` waits for one. */
+export declare const redactedSttKeyPreview = "[redacted: speech engine key]";
+/**
+ * Recorded instead of a custom speech-engine address while `/stt` waits for one: an address may carry a login
+ * (`http://user:pass@host`), and the message is deleted from the topic for that reason.
+ */
+export declare const redactedSttAddressPreview = "[redacted: speech engine address]";
+/** What `/stt` waits for as plain text: the next non-command message of the topic IS that secret-bearing input. */
+export type SttAwaitedInputStep = 'url' | 'key';
 /** Recorded instead of a `/connect …` invocation — its arguments may carry the key inline. */
 export declare const redactedConnectCommandPreview = "/connect <redacted>";
 /**
@@ -15,9 +24,10 @@ export declare function checkIsConnectCommandText(rawText: string): boolean;
  * on-disk trace log. Mirrors the text handler's own routing: while the thread
  * is in the pending `/connect` state, the next non-command text IS the pasted
  * key → the preview is fully redacted (a command text cancels the flow instead,
- * so it is not a secret). Independently of the pending state, an inline
- * `/connect <key>` carries the key in its arguments → only a fixed command
- * marker is recorded. Everything else records unchanged.
+ * so it is not a secret). The same holds while `/stt` waits for a speech-engine
+ * key or for a custom server's address (it may carry a login). Independently of the pending state, an inline `/connect <key>` carries
+ * the key in its arguments → only a fixed command marker is recorded.
+ * Everything else records unchanged.
  */
-export declare function getRecvTracePreview(messageText: string, isThreadPendingProviderConnect: boolean): string;
+export declare function getRecvTracePreview(messageText: string, isThreadPendingProviderConnect: boolean, awaitedSttStep?: SttAwaitedInputStep | null): string;
 //# sourceMappingURL=recvPreviewRedaction.d.ts.map

package/dist/utils/recvPreviewRedaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recvPreviewRedaction.d.ts","sourceRoot":"","sources":["../../src/utils/recvPreviewRedaction.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,iCAAiC,CAAC;AAExE,8FAA8F;AAC9F,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,8BAA8B,EAAE,OAAO,GACtC,MAAM,CAMR"}
+{"version":3,"file":"recvPreviewRedaction.d.ts","sourceRoot":"","sources":["../../src/utils/recvPreviewRedaction.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,iCAAiC,CAAC;AAExE,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,kCAAkC,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,sCAAsC,CAAC;AAE7E,mHAAmH;AACnH,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,KAAK,CAAC;AAEhD,8FAA8F;AAC9F,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,8BAA8B,EAAE,OAAO,EACvC,cAAc,GAAE,mBAAmB,GAAG,IAAW,GAChD,MAAM,CAOR"}

package/dist/utils/recvPreviewRedaction.js

@@ -1,11 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.redactedConnectCommandPreview = exports.redactedConnectKeyPreview = void 0;
+exports.redactedConnectCommandPreview = exports.redactedSttAddressPreview = exports.redactedSttKeyPreview = exports.redactedConnectKeyPreview = void 0;
 exports.checkIsConnectCommandText = checkIsConnectCommandText;
 exports.getRecvTracePreview = getRecvTracePreview;
 const utils_1 = require("../utils");
 /** Recorded instead of a pasted provider API key while `/connect` is pending. */
 exports.redactedConnectKeyPreview = '[redacted: provider API key]';
+/** Recorded instead of a pasted speech-engine key while `/stt` waits for one. */
+exports.redactedSttKeyPreview = '[redacted: speech engine key]';
+/**
+ * Recorded instead of a custom speech-engine address while `/stt` waits for one: an address may carry a login
+ * (`http://user:pass@host`), and the message is deleted from the topic for that reason.
+ */
+exports.redactedSttAddressPreview = '[redacted: speech engine address]';
 /** Recorded instead of a `/connect …` invocation — its arguments may carry the key inline. */
 exports.redactedConnectCommandPreview = '/connect <redacted>';
 /**
@@ -24,16 +31,21 @@ function checkIsConnectCommandText(rawText) {
  * on-disk trace log. Mirrors the text handler's own routing: while the thread
  * is in the pending `/connect` state, the next non-command text IS the pasted
  * key → the preview is fully redacted (a command text cancels the flow instead,
- * so it is not a secret). Independently of the pending state, an inline
- * `/connect <key>` carries the key in its arguments → only a fixed command
- * marker is recorded. Everything else records unchanged.
+ * so it is not a secret). The same holds while `/stt` waits for a speech-engine
+ * key or for a custom server's address (it may carry a login). Independently of the pending state, an inline `/connect <key>` carries
+ * the key in its arguments → only a fixed command marker is recorded.
+ * Everything else records unchanged.
  */
-function getRecvTracePreview(messageText, isThreadPendingProviderConnect) {
+function getRecvTracePreview(messageText, isThreadPendingProviderConnect, awaitedSttStep = null) {
     if (checkIsConnectCommandText(messageText))
         return exports.redactedConnectCommandPreview;
-    if (isThreadPendingProviderConnect && !messageText.trim().startsWith('/')) {
+    const isPlainText = !messageText.trim().startsWith('/');
+    if (isThreadPendingProviderConnect && isPlainText)
         return exports.redactedConnectKeyPreview;
-    }
+    if (awaitedSttStep === 'key' && isPlainText)
+        return exports.redactedSttKeyPreview;
+    if (awaitedSttStep === 'url' && isPlainText)
+        return exports.redactedSttAddressPreview;
     return messageText;
 }
 //# sourceMappingURL=recvPreviewRedaction.js.map

package/dist/utils/recvPreviewRedaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"recvPreviewRedaction.js","sourceRoot":"","sources":["../../src/utils/recvPreviewRedaction.ts"],"names":[],"mappings":";;;AAcA,8DAGC;AAYD,kDASC;AAtCD,oCAAkD;AAElD,iFAAiF;AACpE,QAAA,yBAAyB,GAAG,8BAA8B,CAAC;AAExE,8FAA8F;AACjF,QAAA,6BAA6B,GAAG,qBAAqB,CAAC;AAEnE;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAC,OAAe;IACvD,MAAM,CAAC,WAAW,GAAG,EAAE,CAAC,GAAG,IAAA,8BAAsB,EAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAClF,OAAO,WAAW,KAAK,UAAU,CAAC;AACpC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,mBAAmB,CACjC,WAAmB,EACnB,8BAAuC;IAEvC,IAAI,yBAAyB,CAAC,WAAW,CAAC;QAAE,OAAO,qCAA6B,CAAC;IACjF,IAAI,8BAA8B,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1E,OAAO,iCAAyB,CAAC;IACnC,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"recvPreviewRedaction.js","sourceRoot":"","sources":["../../src/utils/recvPreviewRedaction.ts"],"names":[],"mappings":";;;AA0BA,8DAGC;AAaD,kDAWC;AArDD,oCAAkD;AAElD,iFAAiF;AACpE,QAAA,yBAAyB,GAAG,8BAA8B,CAAC;AAExE,iFAAiF;AACpE,QAAA,qBAAqB,GAAG,+BAA+B,CAAC;AAErE;;;GAGG;AACU,QAAA,yBAAyB,GAAG,mCAAmC,CAAC;AAK7E,8FAA8F;AACjF,QAAA,6BAA6B,GAAG,qBAAqB,CAAC;AAEnE;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAC,OAAe;IACvD,MAAM,CAAC,WAAW,GAAG,EAAE,CAAC,GAAG,IAAA,8BAAsB,EAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAClF,OAAO,WAAW,KAAK,UAAU,CAAC;AACpC,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,mBAAmB,CACjC,WAAmB,EACnB,8BAAuC,EACvC,iBAA6C,IAAI;IAEjD,IAAI,yBAAyB,CAAC,WAAW,CAAC;QAAE,OAAO,qCAA6B,CAAC;IACjF,MAAM,WAAW,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,8BAA8B,IAAI,WAAW;QAAE,OAAO,iCAAyB,CAAC;IACpF,IAAI,cAAc,KAAK,KAAK,IAAI,WAAW;QAAE,OAAO,6BAAqB,CAAC;IAC1E,IAAI,cAAc,KAAK,KAAK,IAAI,WAAW;QAAE,OAAO,iCAAyB,CAAC;IAC9E,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/utils/startupReadiness.d.ts

@@ -36,8 +36,8 @@ export interface ReadinessFacts {
     hasBinding: boolean;
     /** Installed agent CLIs among `claude` / `opencode` (empty ⇒ none installed). */
     availableAgents: string[];
-    /** `GROQ_API_KEY` is present (optional — enables voice input). */
-    hasGroq: boolean;
+    /** At least one speech engine is available (optional — enables voice input). */
+    hasSpeechEngine: boolean;
     /** `OWNER_USER_ID` is set. */
     ownerSet: boolean;
     /**
@@ -75,7 +75,7 @@ export declare function formatMissingRights(keys: BotRightKey[]): string;
  *
  * `isReady` is true iff NONE of the required items are unmet:
  *   groupPaired  &&  all admin rights held  &&  a binding exists  &&  an agent CLI installed.
- * The optional groq / owner items are informational — they populate `unmetKeys`
+ * The optional speech-engine / owner items are informational — they populate `unmetKeys`
  * (so they render inside a not-ready checklist) but never flip `isReady`.
  *
  * `grant_admin` is only unmet while a group IS paired (you cannot grant admin

package/dist/utils/startupReadiness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"startupReadiness.d.ts","sourceRoot":"","sources":["../../src/utils/startupReadiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE5D,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,aAAa,GACb,YAAY,GACZ,eAAe,GACf,eAAe,GACf,gBAAgB,CAAC;AAErB,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,iFAAiF;IACjF,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B;AAoBD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAItD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,WAAW,EAAE,CAOhF;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,CAE/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAe3E;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAEV;AAED,uGAAuG;AACvG,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,OAAO,EACvB,gBAAgB,EAAE,OAAO,GACxB,aAAa,EAAE,CAQjB;AAED,0GAA0G;AAC1G,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC;AAE7F;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,sBAAsB,GAChC,MAAM,CAaR"}
+{"version":3,"file":"startupReadiness.d.ts","sourceRoot":"","sources":["../../src/utils/startupReadiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE5D,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,aAAa,GACb,YAAY,GACZ,eAAe,GACf,eAAe,GACf,gBAAgB,CAAC;AAErB,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,mEAAmE;IACnE,UAAU,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gFAAgF;IAChF,eAAe,EAAE,OAAO,CAAC;IACzB,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,iFAAiF;IACjF,aAAa,EAAE,WAAW,EAAE,CAAC;CAC9B;AAoBD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAItD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,WAAW,EAAE,CAOhF;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,CAE/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAe3E;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAEV;AAED,uGAAuG;AACvG,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,OAAO,EACvB,gBAAgB,EAAE,OAAO,GACxB,aAAa,EAAE,CAQjB;AAED,0GAA0G;AAC1G,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC;AAE7F;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,sBAAsB,GAChC,MAAM,CAaR"}

package/dist/utils/startupReadiness.js

@@ -69,7 +69,7 @@ function formatMissingRights(keys) {
  *
  * `isReady` is true iff NONE of the required items are unmet:
  *   groupPaired  &&  all admin rights held  &&  a binding exists  &&  an agent CLI installed.
- * The optional groq / owner items are informational — they populate `unmetKeys`
+ * The optional speech-engine / owner items are informational — they populate `unmetKeys`
  * (so they render inside a not-ready checklist) but never flip `isReady`.
  *
  * `grant_admin` is only unmet while a group IS paired (you cannot grant admin
@@ -86,7 +86,7 @@ function buildReadinessReport(facts) {
         unmet.add('bind_topic');
     if (facts.availableAgents.length === 0)
         unmet.add('install_agent');
-    if (!facts.hasGroq)
+    if (!facts.hasSpeechEngine)
         unmet.add('optional_groq');
     if (!facts.ownerSet && facts.usedGeneralFallback)
         unmet.add('optional_owner');