charness 3.6.1 → 3.8.0

package/dist/utils/openCodeCompactPlugin.js

@@ -1,10 +1,11 @@
 "use strict";
 /**
  * @description The OpenCode plugin the bot installs so that a compaction OpenCode
- * runs ON ITS OWN when the context overflows also tells the next session which
- * skills to load again.
+ * runs ON ITS OWN when the context overflows also gets the resume guidance — the
+ * skills to load again and the next-steps checklist that ends the summary
+ * (`compactionResumeGuidance`).
  *
- * WHY this exists: the loaded-skills guidance rides the bot's per-invocation
+ * WHY this exists: the resume guidance rides the bot's per-invocation
  * `instruction` (`POST /session/:id/summarize`), which an overflow compaction
  * never receives, and unlike D3 it is not baked into the fork's prompt. OpenCode
  * runs the plugin hook `experimental.session.compacting` before EVERY compaction
@@ -18,6 +19,15 @@
  * file and rewrites it only when its content changed; the user's `opencode.json`
  * is never touched.
  *
+ * The file name carries a hash of the plugin's content. `GET /config` reports a
+ * loaded plugin only by that name, so a name that is the same for every version
+ * would make an instance that loaded an OLDER text read as up to date: it would
+ * never be recreated, and the bot would leave the guidance out of its own
+ * instruction on the strength of a plugin that carries less than the current
+ * one. With the hash only an instance that loaded the current text counts
+ * ({@link checkHasOpenCodeCompactPlugin}); an older copy of the file is removed on
+ * install, so a new instance never loads two.
+ *
  * A RUNNING instance does not rescan: OpenCode loads plugins once per project
  * folder. `POST /instance/dispose?directory=` makes the next request recreate the
  * folder's instance, which then loads the plugin — no server restart, sessions
@@ -29,34 +39,41 @@
  *
  * The hook only sees the session id, never the bot's per-invocation instruction,
  * so it cannot skip a compaction that already carries the guidance. The bot
- * therefore leaves the skills guidance out of its instruction when the folder's
- * instance has this plugin ({@link checkHasOpenCodeCompactPlugin} over
+ * therefore leaves the resume guidance out of its instruction when the folder's
+ * instance has the CURRENT plugin ({@link checkHasOpenCodeCompactPlugin} over
  * `GET /config`), and keeps it otherwise.
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.legacyOpenCodeCompactPluginId = exports.legacyOpenCodeCompactPluginFileName = exports.openCodeCompactPluginId = exports.openCodeCompactPluginFileName = void 0;
+exports.openCodeCompactPluginFileName = exports.legacyOpenCodeCompactPluginId = exports.legacyOpenCodeCompactPluginFileName = exports.openCodeCompactPluginId = void 0;
 exports.getOpenCodeCompactPluginContext = getOpenCodeCompactPluginContext;
 exports.buildOpenCodeCompactPluginSource = buildOpenCodeCompactPluginSource;
+exports.getOpenCodeCompactPluginFileName = getOpenCodeCompactPluginFileName;
 exports.resolveOpenCodeGlobalPluginDir = resolveOpenCodeGlobalPluginDir;
 exports.checkHasOpenCodeCompactPlugin = checkHasOpenCodeCompactPlugin;
 exports.getCompactPluginActivation = getCompactPluginActivation;
+exports.checkIsOpenCodeSessionStatusIdle = checkIsOpenCodeSessionStatusIdle;
 exports.installOpenCodeCompactPlugin = installOpenCodeCompactPlugin;
+const crypto_1 = __importDefault(require("crypto"));
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const compactOnIdle_1 = require("./compactOnIdle");
 const legacyNames_1 = require("../legacyNames");
-/** File name of the plugin in OpenCode's plugin folder; also how the bot recognises it in `GET /config`. */
-exports.openCodeCompactPluginFileName = 'charness-compaction.js';
 /** OpenCode requires a path plugin to export an id. */
 exports.openCodeCompactPluginId = 'charness-compaction';
+/** The part of the plugin's file name before the content hash. */
+const openCodeCompactPluginFileStem = 'charness-compaction';
+/** Hex digits of the content hash in the file name: enough that two texts never share one, short enough to read. */
+const openCodeCompactPluginHashLength = 8;
+/** The file name of any version of the plugin: the stem, an optional content hash (the first release had none). */
+const openCodeCompactPluginFileNamePattern = new RegExp(`^${openCodeCompactPluginFileStem}(?:-[0-9a-f]{${openCodeCompactPluginHashLength}})?\\.js$`);
 /**
- * The file and id the same plugin had before the rename. A folder instance that
- * loaded it keeps it in memory, so it still counts as "has the plugin"; the FILE
- * is removed on install so a new instance does not load both.
+ * The file and id the same plugin had before the rename. The file is removed on
+ * install so a new instance does not load both; an instance that loaded it carries
+ * an older text, so it no longer counts as "has the plugin".
  */
 exports.legacyOpenCodeCompactPluginFileName = 'telegramcode-compaction.js';
 exports.legacyOpenCodeCompactPluginId = 'telegramcode-compaction';
@@ -64,10 +81,10 @@ exports.legacyOpenCodeCompactPluginId = 'telegramcode-compaction';
  * @description The text the plugin adds to every compaction prompt. OpenCode
  * appends it AFTER the bot's per-invocation instruction, which may end with the
  * F2 closing-section directive ("write nothing after the end marker"), so the text
- * says outright that the skills list belongs inside the summary.
+ * says outright that the skills list and the checklist belong inside the summary.
  */
 function getOpenCodeCompactPluginContext() {
-    return `Additional instruction for the summary itself (put it inside the summary, never after a closing section the instructions above require): ${compactOnIdle_1.compactionSkillsGuidance}`;
+    return `Additional instruction for the summary itself (put it inside the summary, never after a closing section the instructions above require): ${compactOnIdle_1.compactionResumeGuidance}`;
 }
 /** @description The plugin module source: a v1 plugin (`default` export with `id` + `server`). */
 function buildOpenCodeCompactPluginSource(context) {
@@ -85,24 +102,36 @@ function buildOpenCodeCompactPluginSource(context) {
         '',
     ].join('\n');
 }
+/**
+ * @description The plugin's file name for a given source: the stem and a hash of the source. `GET /config` names a
+ * loaded plugin by this file name alone, so the name is what tells an instance that loaded this text from one that
+ * loaded an older one.
+ */
+function getOpenCodeCompactPluginFileName(source) {
+    const contentHash = crypto_1.default.createHash('sha256').update(source).digest('hex').slice(0, openCodeCompactPluginHashLength);
+    return `${openCodeCompactPluginFileStem}-${contentHash}.js`;
+}
+/** File name of the CURRENT plugin in OpenCode's plugin folder; also how the bot recognises it in `GET /config`. */
+exports.openCodeCompactPluginFileName = getOpenCodeCompactPluginFileName(buildOpenCodeCompactPluginSource(getOpenCodeCompactPluginContext()));
 /** @description OpenCode's global plugin folder, resolved the way OpenCode resolves it (XDG config home). */
 function resolveOpenCodeGlobalPluginDir(env) {
     const configHome = env.XDG_CONFIG_HOME || path_1.default.join(os_1.default.homedir(), '.config');
     return path_1.default.join(configHome, 'opencode', 'plugins');
 }
 /**
- * @description Whether a `GET /config` `plugin` list contains the bot's plugin. A
+ * @description Whether a `GET /config` `plugin` list contains the CURRENT bot plugin. A
  * spec is a string or a `[spec, options]` tuple; OpenCode reports a path plugin as
- * a `file://` URL.
+ * a `file://` URL. Only the current file name counts: an instance that loaded an
+ * older version of the plugin (another content hash, the unhashed first release, the
+ * pre-rename file) keeps the older text in memory, so it must be recreated and the
+ * bot must still send the guidance itself.
  */
 function checkHasOpenCodeCompactPlugin(pluginSpecs) {
     if (!Array.isArray(pluginSpecs))
         return false;
     return pluginSpecs.some((entry) => {
         const spec = Array.isArray(entry) ? entry[0] : entry;
-        return (typeof spec === 'string' &&
-            (spec.endsWith(`/${exports.openCodeCompactPluginFileName}`) ||
-                spec.endsWith(`/${exports.legacyOpenCodeCompactPluginFileName}`)));
+        return typeof spec === 'string' && spec.endsWith(`/${exports.openCodeCompactPluginFileName}`);
     });
 }
 /**
@@ -114,11 +143,16 @@ function checkHasOpenCodeCompactPlugin(pluginSpecs) {
 function getCompactPluginActivation(input) {
     if (checkHasOpenCodeCompactPlugin(input.pluginSpecs))
         return 'loaded';
-    const status = input.sessionStatus;
-    if (!status || typeof status !== 'object' || Array.isArray(status))
-        return 'busy';
-    const isAnyBusy = Object.values(status).some((entry) => !entry || typeof entry !== 'object' || entry.type !== 'idle');
-    return isAnyBusy ? 'busy' : 'recreate';
+    return checkIsOpenCodeSessionStatusIdle(input.sessionStatus) ? 'recreate' : 'busy';
+}
+/**
+ * @description Whether a `GET /session/status` map says every session of the instance is idle. A status the bot
+ * cannot read counts as busy: an instance or a server is never recreated on a guess.
+ */
+function checkIsOpenCodeSessionStatusIdle(sessionStatus) {
+    if (!sessionStatus || typeof sessionStatus !== 'object' || Array.isArray(sessionStatus))
+        return false;
+    return Object.values(sessionStatus).every((entry) => typeof entry === 'object' && entry !== null && 'type' in entry && entry.type === 'idle');
 }
 /**
  * @description Remove the plugin file a pre-rename release installed, so a folder
@@ -140,39 +174,73 @@ function removeLegacyOpenCodeCompactPlugin(pluginDir) {
     }
     (0, legacyNames_1.warnLegacyNameOnce)('opencode-compact-plugin', `${(0, legacyNames_1.formatDeprecation)(legacyPath, path_1.default.join(pluginDir, exports.openCodeCompactPluginFileName))}; the old file was removed`);
 }
+/**
+ * @description Remove every OTHER version of the plugin from the folder, so a new
+ * folder instance loads one copy of the guidance, not an older text beside the
+ * current one. Only a file that is the bot's own (its name fits the plugin's and it
+ * exports the plugin's id) goes; anything else stays. Best-effort: a failure leaves a
+ * duplicate guidance, which is harmless.
+ */
+function removeOutdatedOpenCodeCompactPlugins(pluginDir) {
+    let fileNames;
+    try {
+        fileNames = fs_1.default.readdirSync(pluginDir);
+    }
+    catch {
+        return;
+    }
+    for (const fileName of fileNames) {
+        if (fileName === exports.openCodeCompactPluginFileName || !openCodeCompactPluginFileNamePattern.test(fileName))
+            continue;
+        const outdatedPath = path_1.default.join(pluginDir, fileName);
+        try {
+            if (!fs_1.default.readFileSync(outdatedPath, 'utf-8').includes(JSON.stringify(exports.openCodeCompactPluginId)))
+                continue;
+            fs_1.default.unlinkSync(outdatedPath);
+            console.log(`[compact-plugin] removed the outdated plugin file ${outdatedPath}`);
+        }
+        catch {
+            // Gone already or not ours to read: it stays.
+        }
+    }
+}
 /**
  * @description Put the plugin into OpenCode's global plugin folder. Idempotent:
  * an identical file is left alone, a stale one is replaced atomically (a folder
  * instance being created concurrently never reads half a file). Any failure is
  * logged and returned — the plugin improves a summary, it must never block an
  * OpenCode start or the bot's boot. The file a pre-rename release installed is
- * removed first.
+ * removed first; the older versions of the current name, once the current file is
+ * in place (a folder instance created in between loads both, never none).
  */
 function installOpenCodeCompactPlugin(pluginDir = resolveOpenCodeGlobalPluginDir(process.env)) {
     removeLegacyOpenCodeCompactPlugin(pluginDir);
     const pluginPath = path_1.default.join(pluginDir, exports.openCodeCompactPluginFileName);
     const source = buildOpenCodeCompactPluginSource(getOpenCodeCompactPluginContext());
+    let isCurrentFileInPlace = false;
     try {
-        if (fs_1.default.readFileSync(pluginPath, 'utf-8') === source)
-            return 'unchanged';
+        isCurrentFileInPlace = fs_1.default.readFileSync(pluginPath, 'utf-8') === source;
     }
     catch {
         // Missing or unreadable: (re)write below.
     }
-    const tmpPath = `${pluginPath}.${process.pid}.${Date.now()}.tmp`;
-    try {
-        fs_1.default.mkdirSync(pluginDir, { recursive: true });
-        fs_1.default.writeFileSync(tmpPath, source);
-        fs_1.default.renameSync(tmpPath, pluginPath);
-    }
-    catch (e) {
-        console.warn(`[compact-plugin] cannot write ${pluginPath}:`, e);
+    if (!isCurrentFileInPlace) {
+        const tmpPath = `${pluginPath}.${process.pid}.${Date.now()}.tmp`;
         try {
-            fs_1.default.unlinkSync(tmpPath);
+            fs_1.default.mkdirSync(pluginDir, { recursive: true });
+            fs_1.default.writeFileSync(tmpPath, source);
+            fs_1.default.renameSync(tmpPath, pluginPath);
+        }
+        catch (e) {
+            console.warn(`[compact-plugin] cannot write ${pluginPath}:`, e);
+            try {
+                fs_1.default.unlinkSync(tmpPath);
+            }
+            catch { /* never written */ }
+            return 'failed';
         }
-        catch { /* never written */ }
-        return 'failed';
     }
-    return 'written';
+    removeOutdatedOpenCodeCompactPlugins(pluginDir);
+    return isCurrentFileInPlace ? 'unchanged' : 'written';
 }
 //# sourceMappingURL=openCodeCompactPlugin.js.map

package/dist/utils/openCodeCompactPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"openCodeCompactPlugin.js","sourceRoot":"","sources":["../../src/utils/openCodeCompactPlugin.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;;;;AA4BH,0EAEC;AAGD,4EAcC;AAGD,wEAGC;AAOD,sEAUC;AAcD,gEAWC;AAmCD,oEAsBC;AAtJD,4CAAoB;AACpB,4CAAoB;AACpB,gDAAwB;AACxB,mDAA2D;AAC3D,gDAAuE;AAEvE,4GAA4G;AAC/F,QAAA,6BAA6B,GAAG,wBAAwB,CAAC;AAEtE,uDAAuD;AAC1C,QAAA,uBAAuB,GAAG,qBAAqB,CAAC;AAE7D;;;;GAIG;AACU,QAAA,mCAAmC,GAAG,4BAA4B,CAAC;AACnE,QAAA,6BAA6B,GAAG,yBAAyB,CAAC;AAEvE;;;;;GAKG;AACH,SAAgB,+BAA+B;IAC7C,OAAO,4IAA4I,wCAAwB,EAAE,CAAC;AAChL,CAAC;AAED,kGAAkG;AAClG,SAAgB,gCAAgC,CAAC,OAAe;IAC9D,OAAO;QACL,oFAAoF;QACpF,mBAAmB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG;QAC7C,kBAAkB;QAClB,SAAS,IAAI,CAAC,SAAS,CAAC,+BAAuB,CAAC,GAAG;QACnD,0BAA0B;QAC1B,oEAAoE;QACpE,qCAAqC;QACrC,QAAQ;QACR,OAAO;QACP,IAAI;QACJ,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,6GAA6G;AAC7G,SAAgB,8BAA8B,CAAC,GAAsB;IACnE,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,IAAI,cAAI,CAAC,IAAI,CAAC,YAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAC7E,OAAO,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,SAAgB,6BAA6B,CAAC,WAAoB;IAChE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACrD,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;YACxB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,qCAA6B,EAAE,CAAC;gBACjD,IAAI,CAAC,QAAQ,CAAC,IAAI,2CAAmC,EAAE,CAAC,CAAC,CAC5D,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAQD;;;;;GAKG;AACH,SAAgB,0BAA0B,CAAC,KAG1C;IACC,IAAI,6BAA6B,CAAC,KAAK,CAAC,WAAW,CAAC;QAAE,OAAO,QAAQ,CAAC;IACtE,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC;IACnC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAClF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAC1C,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,KAA4B,CAAC,IAAI,KAAK,MAAM,CAChG,CAAC;IACF,OAAO,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;AACzC,CAAC;AAKD;;;;;;GAMG;AACH,SAAS,iCAAiC,CAAC,SAAiB;IAC1D,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,2CAAmC,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,qCAA6B,CAAC,CAAC;YAAE,OAAO;QAC5E,YAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,IAAA,gCAAkB,EAChB,yBAAyB,EACzB,GAAG,IAAA,+BAAiB,EAAC,UAAU,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,qCAA6B,CAAC,CAAC,4BAA4B,CAClH,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,4BAA4B,CAC1C,YAAoB,8BAA8B,CAAC,OAAO,CAAC,GAAG,CAAC;IAE/D,iCAAiC,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,qCAA6B,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,gCAAgC,CAAC,+BAA+B,EAAE,CAAC,CAAC;IACnF,IAAI,CAAC;QACH,IAAI,YAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,MAAM;YAAE,OAAO,WAAW,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,UAAU,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;IACjE,IAAI,CAAC;QACH,YAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,YAAE,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAClC,YAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,iCAAiC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC;YAAC,YAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAC7D,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"openCodeCompactPlugin.js","sourceRoot":"","sources":["../../src/utils/openCodeCompactPlugin.ts"],"names":[],"mappings":"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"}

package/dist/utils/promptDelivery.d.ts

@@ -2,22 +2,26 @@ import { type SessionKey } from '../sessionKey';
 import type { BufferedPromptSettled, StartupPromptBuffer } from '../startupPromptBuffer';
 /**
  * @name PromptDeliveryDeps
- * @description What {@link deliverPromptOrBuffer} acts through. `announceQueued`
- * tells the person their prompt waits for the session to come up — a topic
- * message, so it is only called for a Telegram conversation.
+ * @description What {@link deliverPromptOrBuffer} acts through. `forwardPrompt` says where the
+ * forward put the prompt ({@link LatePromptOutcome}); `announceQueued` tells the person their
+ * prompt waits for the session to come up — a topic message, so it is only called for a
+ * Telegram conversation.
  */
 export interface PromptDeliveryDeps {
     startupBuffer: Pick<StartupPromptBuffer, 'addPrompt'>;
-    forwardPrompt: (key: SessionKey, text: string) => Promise<void>;
+    forwardPrompt: (key: SessionKey, text: string) => Promise<LatePromptOutcome>;
     announceQueued: (key: SessionKey) => Promise<void>;
 }
 /**
  * @name PromptDelivery
  * @description Where {@link deliverPromptOrBuffer} put the prompt: `forwarded` to the
- * session (done), or `buffered` behind a session start (it waits in memory until the
- * start ends — see `onBufferedSettled`).
+ * session (done), `buffered` behind a session start (it waits in memory until the
+ * start ends — see `onBufferedSettled`), or `noSession` — the forward found no session
+ * left to take it (a prompt that waited for a bot restart's replay; the person was
+ * told), so nothing will ever answer it: what the caller opened for it must not wait
+ * for a turn.
  */
-export type PromptDelivery = 'forwarded' | 'buffered';
+export type PromptDelivery = 'forwarded' | 'buffered' | 'noSession';
 /**
  * @description Deliver `text` to a conversation's agent while honouring the startup
  * window: mid-startup the prompt is buffered (it replays in order once the session
@@ -47,18 +51,24 @@ export declare function deliverPromptOrBuffer(deps: PromptDeliveryDeps, key: Ses
  * @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`.
+ * session for it); `wake` — the process is gone meanwhile (the conversation sleeps: wake it, then forward); `forward`;
+ * `drop` — only for a technical prompt that finds no live session without a window: nothing is done for it.
  */
-export type LatePromptRoute = 'buffer' | 'wake' | 'forward';
+export type LatePromptRoute = 'buffer' | 'wake' | 'forward' | 'drop';
 /**
  * @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.
+ *
+ * A bot-made TECHNICAL prompt (the todo list's standalone reminder) is posted only into a live session that is idle at
+ * this moment — never a resume, never held for a later one, never reported to the person: where a user's prompt would be
+ * buffered or wake the conversation, it is dropped.
  */
 export declare function getLatePromptRoute(input: {
     isWindowOpen: boolean;
     isSessionActive: boolean;
+    isTechnical?: boolean;
 }): LatePromptRoute;
 /** @description What a wake did: whether a session is up to forward to, and whether it already told the topic something. */
 export interface LateWakeResult {
@@ -74,15 +84,22 @@ export interface LateWakeResult {
  * already said why (`isAlreadyTold`), where a second, generic line would contradict it.
  */
 export interface LatePromptDeliveryPorts {
+    /** A bot-made technical prompt: dropped, not buffered or woken for, where a session is not live (see {@link getLatePromptRoute}). */
+    isTechnical?: boolean;
     checkIsWindowOpen: () => boolean;
     checkIsSessionActive: () => boolean;
     buffer: () => Promise<void>;
     wake: () => Promise<LateWakeResult>;
-    forward: () => Promise<void>;
+    /** Where the forward put the prompt: `forwarded`, or what a forward that routes it again itself (a prompt that waited for an adopt replay) ended in — passed on as the answer. */
+    forward: () => Promise<LatePromptOutcome>;
     reportNoSession: (isAlreadyTold: boolean) => Promise<void>;
 }
-/** @description Where {@link deliverLatePrompt} put the prompt; `noSession` — nowhere: nothing to deliver it to. */
-export type LatePromptOutcome = 'buffered' | 'forwarded' | 'noSession';
+/**
+ * @description Where {@link deliverLatePrompt} put the prompt; `noSession` — nowhere: nothing to deliver it to (the wake found
+ * nothing to resume, or the forward itself ended so); `dropped` — a technical prompt that found no live session, left alone
+ * on purpose (nothing buffered, woken or said).
+ */
+export type LatePromptOutcome = 'buffered' | 'forwarded' | 'noSession' | 'dropped';
 /**
  * @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

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;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,4HAA4H;AAC5H,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,gGAAgG;IAChG,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;GAMG;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,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,eAAe,EAAE,CAAC,aAAa,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;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,CAelG"}
+{"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;;;;;;GAMG;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,iBAAiB,CAAC,CAAC;IAC7E,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;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,CAkBzB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAErE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,eAAe,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,eAAe,CAIrI;AAED,4HAA4H;AAC5H,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,gGAAgG;IAChG,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,qIAAqI;IACrI,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,MAAM,OAAO,CAAC;IACjC,oBAAoB,EAAE,MAAM,OAAO,CAAC;IACpC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,kLAAkL;IAClL,OAAO,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1C,eAAe,EAAE,CAAC,aAAa,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAEnF;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAelG"}

package/dist/utils/promptDelivery.js

@@ -31,8 +31,9 @@ const sessionKeyCodec_1 = require("../connectors/telegram/sessionKeyCodec");
  */
 async function deliverPromptOrBuffer(deps, key, text, isStarting, onBufferedSettled) {
     if (!isStarting) {
-        await deps.forwardPrompt(key, text);
-        return 'forwarded';
+        // Only `noSession` is told apart: a forward that re-routed the prompt behind a stop window itself registered no
+        // `onBufferedSettled`, so it reads as forwarded, as it always did.
+        return (await deps.forwardPrompt(key, text)) === 'noSession' ? 'noSession' : 'forwarded';
     }
     const isFirstBuffered = deps.startupBuffer.addPrompt((0, sessionKey_1.keyToString)(key), text, onBufferedSettled);
     if (isFirstBuffered && (0, sessionKeyCodec_1.checkIsTelegramKey)(key)) {
@@ -53,8 +54,14 @@ async function deliverPromptOrBuffer(deps, key, text, isStarting, onBufferedSett
  * 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.
+ *
+ * A bot-made TECHNICAL prompt (the todo list's standalone reminder) is posted only into a live session that is idle at
+ * this moment — never a resume, never held for a later one, never reported to the person: where a user's prompt would be
+ * buffered or wake the conversation, it is dropped.
  */
 function getLatePromptRoute(input) {
+    if (input.isTechnical === true)
+        return input.isWindowOpen || !input.isSessionActive ? 'drop' : 'forward';
     if (input.isWindowOpen)
         return 'buffer';
     return input.isSessionActive ? 'forward' : 'wake';
@@ -65,7 +72,9 @@ function getLatePromptRoute(input) {
  * 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() });
+    const route = getLatePromptRoute({ isWindowOpen: ports.checkIsWindowOpen(), isSessionActive: ports.checkIsSessionActive(), isTechnical: ports.isTechnical });
+    if (route === 'drop')
+        return 'dropped';
     if (route === 'buffer') {
         await ports.buffer();
         return 'buffered';
@@ -77,7 +86,6 @@ async function deliverLatePrompt(ports) {
             return 'noSession';
         }
     }
-    await ports.forward();
-    return 'forwarded';
+    return ports.forward();
 }
 //# 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;AAgBD,gDAGC;AAiCD,8CAeC;AA1ID,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;AA4BD;;;;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,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACjD,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IACD,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IACtB,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"promptDelivery.js","sourceRoot":"","sources":["../../src/utils/promptDelivery.ts"],"names":[],"mappings":";;AAoDA,sDAwBC;AAqBD,gDAIC;AAwCD,8CAeC;AA5JD,8CAA6D;AAC7D,4EAA4E;AA2B5E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,KAAK,UAAU,qBAAqB,CACzC,IAAwB,EACxB,GAAe,EACf,IAAY,EACZ,UAAmB,EACnB,iBAAyC;IAEzC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,gHAAgH;QAChH,mEAAmE;QACnE,OAAO,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;IAC3F,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;AAWD;;;;;;;;;GASG;AACH,SAAgB,kBAAkB,CAAC,KAAiF;IAClH,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACzG,IAAI,KAAK,CAAC,YAAY;QAAE,OAAO,QAAQ,CAAC;IACxC,OAAO,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AACpD,CAAC;AAmCD;;;;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,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7J,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACjD,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC"}

package/dist/utils/runnersScreenPlan.d.ts

@@ -0,0 +1,130 @@
+/**
+ * @description Pure plan of the `/runners` screen (`connectors/telegram/commands/runners.ts`): the list of paired machines with
+ * what they said about themselves, the buttons, the confirmation of a removal, the address step of the first pairing, the pairing
+ * message and the texts that replace it once the code was used or expired. Everything here takes the facts in and gives text and
+ * button data out, so the first render and every re-render can never drift apart, and the callback data is checked for Telegram's
+ * 64-byte cap in one place.
+ *
+ * Buttons carry the registry revision AND the runner's position in the WHOLE list (`rnr_<rev>_<i>_<action>`): a keyboard left in the
+ * history acts on the list it was drawn from or is refused, never on a neighbour that moved up — whichever page it stands on.
+ *
+ * The text is BOUNDED: Telegram refuses a message over 4096 characters, and what a machine reports about itself (CPU model, capability
+ * details) has no length of its own, so every reported string is clipped and the machines are split over pages of at most
+ * {@link maxScreenTextChars}. A page holds at least one machine; a list that fits is one page with no navigation.
+ */
+import type { Translate } from '../i18n';
+import { type RunnerProbe } from '../remoteRun/probe';
+import type { PairedRunner } from '../runners/hubRegistry';
+import type { RunnerJobsStop } from '../runners/runnerRemoval';
+/** Telegram refuses callback data over 64 BYTES. */
+export declare const maxCallbackDataBytes = 64;
+/** The most characters a screen's text may have: Telegram's limit is 4096, the rest is the margin for the title, notes and the page line. */
+export declare const maxScreenTextChars = 3600;
+/** The longest a string a machine reported about itself (CPU model, a capability's detail, its OS name) is shown. */
+export declare const maxReportedTextChars = 80;
+export declare const runnersCallbackPrefix = "rnr_";
+export declare const runnersPairCallback = "rnr_pair";
+export declare const runnersRefreshCallback = "rnr_refresh";
+export declare const runnersAddressUseCallback = "rnr_aduse";
+export declare const runnersAddressOtherCallback = "rnr_adother";
+/** Matches `rnr_pg_<page>` (0-based): a view change that acts on nothing, so it carries no revision. */
+export declare const runnersPageCallbackRe: RegExp;
+/** What a button next to a runner does. `remove` asks; `removeYes` / `removeNo` answer the question. */
+export type RunnerAction = 'pause' | 'resume' | 'remove' | 'removeYes' | 'removeNo';
+/** Matches `rnr_<rev>_<index>_<action code>`. */
+export declare const runnerActionCallbackRe: RegExp;
+export type RunnersCallback = {
+    kind: 'pair';
+} | {
+    kind: 'refresh';
+} | {
+    kind: 'addressUse';
+} | {
+    kind: 'addressOther';
+} | {
+    kind: 'page';
+    page: number;
+} | {
+    kind: 'runner';
+    revision: number;
+    index: number;
+    action: RunnerAction;
+};
+export declare function buildRunnersPageCallback(page: number): string;
+export declare function buildRunnerActionCallback(revision: number, index: number, action: RunnerAction): string;
+/** @description Read a button's callback data; `null` when it is not one of this screen's. */
+export declare function parseRunnersCallback(data: string): RunnersCallback | null;
+export interface ScreenButton {
+    text: string;
+    data: string;
+}
+/** @name RunnersScreen @description Text and keyboard rows of one render. */
+export interface RunnersScreen {
+    text: string;
+    rows: ScreenButton[][];
+}
+/** @name RunnersListScreen @description The list as one page: which of how many it is. */
+export interface RunnersListScreen extends RunnersScreen {
+    /** 0-based, clamped into the list that exists. */
+    page: number;
+    pageCount: number;
+}
+/** @name RunnerScreenEntry @description One paired machine and everything known of it right now. */
+export interface RunnerScreenEntry {
+    runner: PairedRunner;
+    isOnline: boolean;
+    /** The last time the hub knew the link alive; `null` = never connected. */
+    lastSeenMs: number | null;
+    /** The live probe while online, else the last snapshot taken when the machine was seen; `null` = never probed. */
+    probe: RunnerProbe | null;
+}
+export interface RunnersScreenModel {
+    /** The registry revision the keyboard is built from. */
+    revision: number;
+    entries: readonly RunnerScreenEntry[];
+    /** When each pairing code that is still open expires. */
+    openPairingExpiries: readonly number[];
+    /** A probe is running: the screen says so, and is re-rendered when it ends. */
+    isChecking: boolean;
+}
+/** @description Formats an instant for the operator (`1 Nov 14:02`) in the bot's timezone and the topic's language. */
+export type FormatTime = (epochMs: number) => string;
+/** @description `text` as a string a machine reported: no longer than {@link maxReportedTextChars}, cut with an ellipsis. */
+export declare function clipReportedText(text: string): string;
+/**
+ * @description Split the entry blocks over pages: each page takes blocks while the text stays within `budget` characters (blocks joined by
+ * a blank line), and at least one block, so a block over the budget alone still has a page. Returns each page's first block and the
+ * block after its last.
+ */
+export declare function paginateBlocks(blocks: readonly string[], budget: number): Array<{
+    start: number;
+    end: number;
+}>;
+/**
+ * @description The list screen, page `page` (0-based; a page past the end is the last): the machines on it, a button to pair another, a
+ * Pause/Resume and a Remove per machine on the page, the page buttons when there is more than one page, Refresh.
+ */
+export declare function buildRunnersScreen(model: RunnersScreenModel, t: Translate, formatTime: FormatTime, page?: number): RunnersListScreen;
+/**
+ * @description The message that says what a removal came to: the key is deleted in every case, and the jobs were stopped from the hub, or the
+ * machine was offline (it stops them itself once it finds out), or they could not be stopped from here (it does the same). Three outcomes,
+ * three texts — «offline» is not what «failed» means.
+ */
+export declare function buildRemovalOutcomeText(runnerName: string, jobs: RunnerJobsStop, t: Translate): string;
+/** @description The question a Remove button turns the screen into. */
+export declare function buildRemoveConfirmation(runnerName: string, revision: number, index: number, t: Translate): RunnersScreen;
+/**
+ * @description The address step of the first pairing. With a proposal (an address of this machine that answered with its own
+ * sshd) it offers «Use …» and «Enter another address»; without one only the second, and says no address was found.
+ */
+export declare function buildAddressStep(proposedAddress: string | null, t: Translate): RunnersScreen;
+/** @description The pairing message's text parts: what stands above the line and below it. The line itself sits between them. */
+export declare function buildPairingMessageParts(pairingLifetimeMinutes: number, t: Translate): {
+    intro: string;
+    outro: string;
+};
+/** @description What the pairing message becomes once the code was used. */
+export declare function buildPairedText(runnerName: string, pairedAtMs: number, t: Translate, formatTime: FormatTime): string;
+/** @description What the pairing message becomes once the code expired unused. */
+export declare function buildExpiredText(t: Translate): string;
+//# sourceMappingURL=runnersScreenPlan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runnersScreenPlan.d.ts","sourceRoot":"","sources":["../../src/utils/runnersScreenPlan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAuC,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,6IAA6I;AAC7I,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,qHAAqH;AACrH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAKvC,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAC9C,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AACpD,eAAO,MAAM,yBAAyB,cAAc,CAAC;AACrD,eAAO,MAAM,2BAA2B,gBAAgB,CAAC;AACzD,wGAAwG;AACxG,eAAO,MAAM,qBAAqB,QAAmB,CAAC;AAEtD,wGAAwG;AACxG,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAGpF,iDAAiD;AACjD,eAAO,MAAM,sBAAsB,QAAoC,CAAC;AAExE,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC;AAE9E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAEvG;AAED,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAWzE;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,EAAE,EAAE,CAAC;CACxB;AAED,0FAA0F;AAC1F,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oGAAoG;AACpG,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kHAAkH;IAClH,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,yDAAyD;IACzD,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,+EAA+E;IAC/E,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,uHAAuH;AACvH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;AASrD,6HAA6H;AAC7H,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAuDD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAe/G;AAQD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,SAAI,GAAG,iBAAiB,CAoC/H;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,SAAS,GAAG,MAAM,CAOtG;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,GAAG,aAAa,CAQxH;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC,EAAE,SAAS,GAAG,aAAa,CAc5F;AAED,iIAAiI;AACjI,wBAAgB,wBAAwB,CAAC,sBAAsB,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAEvH;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAEpH;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAErD"}