charness 3.6.1 → 3.7.0

package/dist/connectors/telegram/botApiConnection.js.map

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

package/dist/connectors/telegram/commands/botCore.d.ts

@@ -4,7 +4,7 @@
  * members it uses (`Pick<BotCore, …>`), and `bot.ts` builds the one object that satisfies them all.
  */
 import type { Context, NarrowedContext, Telegraf } from 'telegraf';
-import type { Message, Update } from 'telegraf/typings/core/types/typegram';
+import type { InlineKeyboardMarkup, Message, Update } from 'telegraf/typings/core/types/typegram';
 import type { InboundCommand } from '../../../platform/inbound';
 import type { SessionKey } from '../../../sessionKey';
 import type { StateStore } from '../../../state';
@@ -26,7 +26,13 @@ export interface BotCore {
     }) => Promise<number | null>;
     /** Edit a message of the topic in place; `false` when the edit failed. */
     editThreadMessage: (key: SessionKey, messageId: number, text: string, extra?: object) => Promise<boolean>;
-    deleteThreadMessage: (key: SessionKey, messageId: number) => Promise<void>;
+    /**
+     * Replace the inline keyboard of a message of the topic through the paced send queue (`null` removes it). A no-change
+     * edit is no failure; any other failure is logged under `logTag` and answered with `false`.
+     */
+    editThreadKeyboard: (key: SessionKey, messageId: number, keyboard: InlineKeyboardMarkup | null, logTag: string) => Promise<boolean>;
+    /** Delete a message of the topic; `false` when it stayed (older than 48 hours, already gone, not a topic of Telegram). */
+    deleteThreadMessage: (key: SessionKey, messageId: number) => Promise<boolean>;
     /** Gate a callback or message to an admin of the served group; the topic's key, or `null` when it is refused. */
     authoriseContext: (ctx: Context) => Promise<SessionKey | null>;
     /** Run `fn` with the topic's resolved locale for `t(…)`. */

package/dist/connectors/telegram/commands/botCore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"botCore.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/botCore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AAEjG,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KAC5F,IAAI,CAAC;AAEV,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,QAAQ,EAAE,MAAM,UAAU,CAAC;IAC3B,uHAAuH;IACvH,aAAa,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1H,0EAA0E;IAC1E,iBAAiB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1G,mBAAmB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,iHAAiH;IACjH,gBAAgB,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC/D,4DAA4D;IAC5D,gBAAgB,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,KAAK,OAAO,CAAC;IAC3E,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC;IAC7C,4DAA4D;IAC5D,kBAAkB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,6FAA6F;IAC7F,yBAAyB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACrD;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClE"}
+{"version":3,"file":"botCore.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/botCore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,sCAAsC,CAAC;AAClG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AAEjG,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KAC5F,IAAI,CAAC;AAEV,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,QAAQ,CAAC;IACd,OAAO,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,QAAQ,EAAE,MAAM,UAAU,CAAC;IAC3B,uHAAuH;IACvH,aAAa,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1H,0EAA0E;IAC1E,iBAAiB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1G;;;OAGG;IACH,kBAAkB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpI,0HAA0H;IAC1H,mBAAmB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9E,iHAAiH;IACjH,gBAAgB,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC/D,4DAA4D;IAC5D,gBAAgB,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,KAAK,OAAO,CAAC;IAC3E,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC;IAC7C,4DAA4D;IAC5D,kBAAkB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,6FAA6F;IAC7F,yBAAyB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACrD;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClE"}

package/dist/connectors/telegram/commands/botSkills.d.ts

@@ -0,0 +1,21 @@
+import type { SessionKey } from '../../../sessionKey';
+import type { BotSkillsInstanceValue, BotSkillsReader } from '../../../utils/botSkills';
+import type { BotCore } from './botCore';
+/** What the module needs from the bot: the shared core and the two things only the composition root knows. */
+export interface BotSkillsPorts extends Pick<BotCore, 'bot' | 'command' | 'getState' | 'replyToThread' | 'editThreadMessage' | 'authoriseContext' | 'withThreadLocale' | 'checkIsGeneral'> {
+    /** Whether the switch is on for a conversation; `null` asks for the instance value (General's, else `settings.json`'s, else ON). */
+    readBotSkills: BotSkillsReader;
+    /** The instance value with the layer it comes from (General's own choice, the settings file, the built-in default). */
+    readBotSkillsInstanceValue: () => BotSkillsInstanceValue;
+    /** Whether the topic's backend is OpenCode, whose one server serves every topic and so cannot hide the skills from one. */
+    checkIsOpenCodeTopic: (key: SessionKey) => boolean;
+}
+/**
+ * @description Build the «Bot skills» screen over its ports: `/bot_skills` and its three buttons. A tap writes the choice
+ * and edits the picker into its confirmation (a one-shot picker, like `/language`): the menu is gone once a choice is made.
+ */
+export declare function createBotSkills(ports: BotSkillsPorts): {
+    registerBotSkillsCommands: () => void;
+    registerBotSkillsCallbacks: () => void;
+};
+//# sourceMappingURL=botSkills.d.ts.map

package/dist/connectors/telegram/commands/botSkills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"botSkills.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/botSkills.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAA2B,sBAAsB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACjH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,8GAA8G;AAC9G,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;IAC1J,oIAAoI;IACpI,aAAa,EAAE,eAAe,CAAC;IAC/B,uHAAuH;IACvH,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;IACzD,2HAA2H;IAC3H,oBAAoB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC;CACpD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc;qCA0Fb,IAAI;sCAeH,IAAI;EAO5C"}

package/dist/connectors/telegram/commands/botSkills.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBotSkills = createBotSkills;
+/**
+ * The «Bot skills» switch — whether the skills Charness ships with its agents (`agent-plugin/`) and the hint to load the
+ * manager reach them, per topic or (in General) for the instance. See `utils/botSkills.ts` for the precedence and what OFF
+ * does, and README.md in this folder.
+ */
+const telegraf_1 = require("telegraf");
+const i18n_1 = require("../../../i18n");
+const callbackMessage_1 = require("./callbackMessage");
+/** The picker's buttons. */
+const botSkillsOnCallback = 'bsk_on';
+const botSkillsOffCallback = 'bsk_off';
+const botSkillsSameAsGeneralCallback = 'bsk_same';
+/** The word of `/bot_skills <word>` that hands a topic back to General's value. */
+const sameAsGeneralArgument = 'general';
+/**
+ * @description Build the «Bot skills» screen over its ports: `/bot_skills` and its three buttons. A tap writes the choice
+ * and edits the picker into its confirmation (a one-shot picker, like `/language`): the menu is gone once a choice is made.
+ */
+function createBotSkills(ports) {
+    const { bot, command, getState, replyToThread, editThreadMessage, authoriseContext, withThreadLocale, checkIsGeneral, readBotSkills, readBotSkillsInstanceValue, checkIsOpenCodeTopic } = ports;
+    const formatState = (isEnabled) => (isEnabled ? (0, i18n_1.t)('botSkills.on') : (0, i18n_1.t)('botSkills.off'));
+    /**
+     * What the topic is told about the agent it has: a Claude agent keeps its skills until its next start; an OpenCode topic's
+     * skills stay listed (one server serves every topic) and only the hint changes, when that server next restarts — and it is
+     * shared with the OpenCode topics of the same folder.
+     */
+    const getAgentNote = (key) => (checkIsOpenCodeTopic(key) ? (0, i18n_1.t)('botSkills.openCodeTopicNote') : (0, i18n_1.t)('botSkills.runningAgentNote'));
+    const instanceSourceKeys = {
+        general: 'botSkills.instanceSourceGeneral',
+        settingsFile: 'botSkills.instanceSourceSettingsFile',
+        builtInDefault: 'botSkills.instanceSourceBuiltIn',
+    };
+    /**
+     * @description Write a choice and RETURN the confirmation — the one write path behind the typed form and the buttons.
+     * General: the instance value (`null` — «as in General» — is not offered there and changes nothing). A topic: its own
+     * choice, `null` drops it.
+     */
+    async function applyBotSkills(key, isGeneral, choice) {
+        if (isGeneral) {
+            if (choice !== null)
+                await getState().setBotSkillsGlobalValue(choice);
+            return (0, i18n_1.t)('botSkills.setGeneralConfirmation', { state: formatState(readBotSkills(null)) });
+        }
+        await getState().setBotSkillsOverride(key, choice);
+        const state = formatState(readBotSkills(key));
+        const confirmation = choice === null ? (0, i18n_1.t)('botSkills.followGeneralConfirmation', { state }) : (0, i18n_1.t)('botSkills.setTopicConfirmation', { state });
+        // A Claude topic's note continues the confirmation's line; the OpenCode one is a paragraph of its own.
+        return checkIsOpenCodeTopic(key) ? `${confirmation}\n\n${getAgentNote(key)}` : `${confirmation} ${getAgentNote(key)}`;
+    }
+    /** The screen's text: the value in force and where it comes from, what the switch is, and what it means for the agent. */
+    function buildScreenText(key, isGeneral) {
+        if (isGeneral) {
+            const instance = readBotSkillsInstanceValue();
+            const title = (0, i18n_1.t)('botSkills.titleGeneral', { state: formatState(instance.isEnabled), source: (0, i18n_1.t)(instanceSourceKeys[instance.source]) });
+            return [title, (0, i18n_1.t)('botSkills.explanationText'), (0, i18n_1.t)('botSkills.runningAgentNote'), (0, i18n_1.t)('botSkills.generalScopeNote')].join('\n\n');
+        }
+        const source = getState().getBotSkillsOverride(key) === undefined ? (0, i18n_1.t)('botSkills.sourceGeneral') : (0, i18n_1.t)('botSkills.sourceTopic');
+        return [(0, i18n_1.t)('botSkills.titleTopic', { state: formatState(readBotSkills(key)), source }), (0, i18n_1.t)('botSkills.explanationText'), getAgentNote(key)].join('\n\n');
+    }
+    /**
+     * The screen's buttons, the current choice marked ✓. General: On / Off on the instance value in force. A topic: On / Off
+     * and «As in General» (with the value it would give); its mark is the topic's own choice, or «As in General» when it has none.
+     */
+    function buildKeyboard(key, isGeneral) {
+        const mark = (isCurrent) => (isCurrent ? ' ✓' : '');
+        if (isGeneral) {
+            const isEnabled = readBotSkills(null);
+            return telegraf_1.Markup.inlineKeyboard([[
+                    telegraf_1.Markup.button.callback(`${(0, i18n_1.t)('botSkills.onButton')}${mark(isEnabled)}`, botSkillsOnCallback),
+                    telegraf_1.Markup.button.callback(`${(0, i18n_1.t)('botSkills.offButton')}${mark(!isEnabled)}`, botSkillsOffCallback),
+                ]]);
+        }
+        const own = getState().getBotSkillsOverride(key);
+        return telegraf_1.Markup.inlineKeyboard([
+            [
+                telegraf_1.Markup.button.callback(`${(0, i18n_1.t)('botSkills.onButton')}${mark(own === true)}`, botSkillsOnCallback),
+                telegraf_1.Markup.button.callback(`${(0, i18n_1.t)('botSkills.offButton')}${mark(own === false)}`, botSkillsOffCallback),
+            ],
+            [telegraf_1.Markup.button.callback(`${(0, i18n_1.t)('botSkills.sameAsGeneralButton', { state: formatState(readBotSkills(null)) })}${mark(own === undefined)}`, botSkillsSameAsGeneralCallback)],
+        ]);
+    }
+    /** The choice a typed argument names; `undefined` for none (the screen opens), and `general` means nothing in General. */
+    function parseChoice(argument, isGeneral) {
+        if (argument === 'on')
+            return true;
+        if (argument === 'off')
+            return false;
+        if (argument === sameAsGeneralArgument && !isGeneral)
+            return null;
+        return undefined;
+    }
+    /** A tap: apply the choice to the tapped topic (or General), then turn the picker into the confirmation. */
+    async function handleBotSkillsCallback(ctx, choice) {
+        const key = await authoriseContext(ctx);
+        if (!key) {
+            await ctx.answerCbQuery((0, i18n_1.t)('cb.access_denied'));
+            return;
+        }
+        await ctx.answerCbQuery();
+        await withThreadLocale(key, async () => {
+            const confirmation = await applyBotSkills(key, checkIsGeneral(key), choice);
+            const messageId = (0, callbackMessage_1.getCallbackMessageId)(ctx);
+            if (messageId === null)
+                await replyToThread(key, confirmation);
+            else if (!(await editThreadMessage(key, messageId, confirmation)))
+                console.warn('[bsk_cb] picker relabel failed');
+        });
+    }
+    function registerBotSkillsCommands() {
+        // `/bot_skills` — in General the instance value, in a topic that topic's own choice. Not gated on an adapter or a
+        // session: a topic may choose before its agent starts, and the choice is read at the agent's next start. `on` / `off`
+        // (and `general` in a topic) apply at once; bare opens the one-shot picker.
+        command('bot_skills', async (_ctx, key, parsed) => {
+            const isGeneral = checkIsGeneral(key);
+            const choice = parseChoice(parsed.args.join(' ').trim().toLowerCase(), isGeneral);
+            if (choice !== undefined) {
+                await replyToThread(key, await applyBotSkills(key, isGeneral, choice));
+                return;
+            }
+            await replyToThread(key, buildScreenText(key, isGeneral), buildKeyboard(key, isGeneral));
+        });
+    }
+    function registerBotSkillsCallbacks() {
+        bot.action(botSkillsOnCallback, (ctx) => handleBotSkillsCallback(ctx, true));
+        bot.action(botSkillsOffCallback, (ctx) => handleBotSkillsCallback(ctx, false));
+        bot.action(botSkillsSameAsGeneralCallback, (ctx) => handleBotSkillsCallback(ctx, null));
+    }
+    return { registerBotSkillsCommands, registerBotSkillsCallbacks };
+}
+//# sourceMappingURL=botSkills.js.map

package/dist/connectors/telegram/commands/botSkills.js.map

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

package/dist/connectors/telegram/commands/callbackMessage.d.ts

@@ -10,6 +10,11 @@ import type { SessionKey } from '../../../sessionKey';
  * rather than resolve against another message's list.
  */
 export declare function getCallbackMessageId(ctx: Context): number | null;
+/**
+ * @description The text of the message a callback button sits on, as Telegram shows it (formatting marks resolved away), or
+ * `null` when the message carries none (a photo, a very old message). What a handler needs to rewrite a message it holds no record of.
+ */
+export declare function getCallbackMessageText(ctx: Context): string | null;
 /**
  * @description The map key of a per-MESSAGE snapshot (the list a keyboard's indexes resolve against, the rung a
  * question waits to add). A Telegram message id is unique only within ONE chat, so the chat (`key.space`) is part of

package/dist/connectors/telegram/commands/callbackMessage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"callbackMessage.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/callbackMessage.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAElF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQnJ"}
+{"version":3,"file":"callbackMessage.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/callbackMessage.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEhE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAElF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQnJ"}

package/dist/connectors/telegram/commands/callbackMessage.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCallbackMessageId = getCallbackMessageId;
+exports.getCallbackMessageText = getCallbackMessageText;
 exports.buildMessageSnapshotKey = buildMessageSnapshotKey;
 exports.rememberBoundedSnapshot = rememberBoundedSnapshot;
 /**
@@ -12,6 +13,14 @@ exports.rememberBoundedSnapshot = rememberBoundedSnapshot;
 function getCallbackMessageId(ctx) {
     return ctx.callbackQuery?.message?.message_id ?? null;
 }
+/**
+ * @description The text of the message a callback button sits on, as Telegram shows it (formatting marks resolved away), or
+ * `null` when the message carries none (a photo, a very old message). What a handler needs to rewrite a message it holds no record of.
+ */
+function getCallbackMessageText(ctx) {
+    const message = ctx.callbackQuery?.message;
+    return message !== undefined && 'text' in message ? message.text : null;
+}
 /**
  * @description The map key of a per-MESSAGE snapshot (the list a keyboard's indexes resolve against, the rung a
  * question waits to add). A Telegram message id is unique only within ONE chat, so the chat (`key.space`) is part of

package/dist/connectors/telegram/commands/callbackMessage.js.map

@@ -1 +1 @@
-{"version":3,"file":"callbackMessage.js","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/callbackMessage.ts"],"names":[],"mappings":";;AAYA,oDAEC;AAOD,0DAEC;AAMD,0DAQC;AA/BD;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,GAAY;IAC/C,OAAO,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,GAAe,EAAE,SAAiB;IACxE,OAAO,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB,CAAY,SAAiC,EAAE,WAAmB,EAAE,QAAmB,EAAE,KAAa;IAC3I,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC9B,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrC,OAAO,SAAS,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAC7C,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;QAChC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}
+{"version":3,"file":"callbackMessage.js","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/callbackMessage.ts"],"names":[],"mappings":";;AAYA,oDAEC;AAMD,wDAGC;AAOD,0DAEC;AAMD,0DAQC;AAxCD;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,GAAY;IAC/C,OAAO,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,GAAY;IACjD,MAAM,OAAO,GAAG,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC;IAC3C,OAAO,OAAO,KAAK,SAAS,IAAI,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,GAAe,EAAE,SAAiB;IACxE,OAAO,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,SAAgB,uBAAuB,CAAY,SAAiC,EAAE,WAAmB,EAAE,QAAmB,EAAE,KAAa;IAC3I,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC9B,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrC,OAAO,SAAS,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAC7C,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;QAChC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/connectors/telegram/commands/compaction.d.ts

@@ -1,15 +1,53 @@
-import type { AgentAdapter, PendingQuestionState } from '../../../types';
+import type { AgentAdapter, PendingQuestionState, OpenCodeQuestion, ReAskedQuestionRecord } from '../../../types';
 import type { SessionKey } from '../../../sessionKey';
 import type { BotCore } from './botCore';
+import { type QuestionEnd } from '../../../openCodeQuestionFlow';
+import type { LatePromptOutcome } from '../../../utils/promptDelivery';
+/**
+ * @description The question the idle compaction asks again (D1), from the moment the compaction starts to the moment the
+ * re-ask is used or closed. It goes through three phases, and the one record serves them all:
+ *  - COMPACTING — the question was cleared and its old message lost its buttons; nothing is posted yet (`messageId: null`);
+ *  - SENDING — the re-ask is being sent: its message exists, the bot has no id for it yet (`messageId: null`);
+ *  - POSTED — the re-ask's message is known (`messageId`), its `reask_<i>` buttons live.
+ * `predecessorMessageId` is the message the question waited in before: the re-ask is always newer than it, and until the
+ * re-ask is posted the predecessor is where the question's result is written. `ending` is set when the record leaves the map
+ * as closed or answered — a re-ask that lands later ends the same way.
+ */
+export interface ReAskedQuestion {
+    question: OpenCodeQuestion;
+    messageId: number | null;
+    predecessorMessageId: number | null;
+    /** Whether the predecessor's result («asked again below», or the ending) is written or on its way — nothing else writes it. */
+    isPredecessorClosed: boolean;
+    /** Whether the edit that gave the predecessor its result has LANDED: what the saved state says, so a restart finishes a lost edit. */
+    isPredecessorEditLanded: boolean;
+    ending: QuestionEnd | null;
+    /** Where the re-ask's own send is: not begun, in flight (the message exists, its id is not known), or over (landed, or failed). */
+    sendPhase: 'notStarted' | 'inFlight' | 'finished';
+    /** Whether the idle fire has decided about the re-ask (posted it, or found the record taken and left it): its result has run. */
+    hasIdleResultRun: boolean;
+    /**
+     * A typed number answered the question and its label is still on its way to the agent. The record is out of the map, but no
+     * result is written on its messages until the delivery is known (it may reach no session, and then the question is open
+     * again): a re-ask that lands meanwhile is left as it is, and the idle compaction leaves the predecessor alone.
+     */
+    isAnswerPending: boolean;
+}
 /**
  * What the compaction flow needs from the bot: the shared core, the typing indicator, the prompt path the
  * compaction instruction goes through, and the pending-question state the idle re-ask reads and clears.
  */
-export interface CompactionPorts extends Pick<BotCore, 'bot' | 'command' | 'getState' | 'replyToThread' | 'deleteThreadMessage' | 'authoriseContext' | 'withThreadLocale' | 'checkIsGeneral' | 'wakeSleepingSession'> {
+export interface CompactionPorts extends Pick<BotCore, 'bot' | 'command' | 'getState' | 'replyToThread' | 'editThreadKeyboard' | 'authoriseContext' | 'withThreadLocale' | 'checkIsGeneral' | 'wakeSleepingSession'> {
     startTypingLoader: (key: SessionKey) => void;
     forwardPromptToAgent: (key: SessionKey, adapter: AgentAdapter, text: string) => Promise<void>;
     pendingQuestions: Map<string, PendingQuestionState>;
+    /** Clear the topic's pending question and unpin it; its message is left as it is (the idle re-ask closes it once the re-ask is posted). */
     clearPendingQuestion: (key: SessionKey) => void;
+    /**
+     * Edit a question's message to the question as asked plus a note in place of its buttons (the text stays, the message
+     * is never deleted); resolves whether it was edited. The re-asked copy uses it with `unanswered` when its conversation ends.
+     */
+    closeQuestionMessage: (key: SessionKey, messageId: number, question: OpenCodeQuestion, ending: QuestionEnd) => Promise<boolean>;
     /** The idle window in force (`AGENT_IDLE_MINUTES` or the 55-minute default; L-D9). */
     idleWindowMs: number;
     /** Whether a usage-limit wait is armed for the topic — no compaction turn then (L-D6). */
@@ -21,6 +59,26 @@ export interface CompactionPorts extends Pick<BotCore, 'bot' | 'command' | 'getS
     suspendThreadSession: (key: SessionKey) => Promise<void>;
     /** Wake a SLEEPING per-turn session for its idle compaction (L-D7): a resume only; `true` when it is live. */
     resumeSleepingSessionForCompaction: (key: SessionKey) => Promise<boolean>;
+    /** The adapter that runs the topic's conversation (the one a topic with no pick of its own answers to). */
+    getThreadAdapter: (key: SessionKey) => AgentAdapter;
+    /**
+     * Hand the label of an option a person chose on a re-asked question to the conversation as a fresh prompt, routed the way
+     * a typed message is (a live session gets it, a stopping one buffers it, a sleeping one is woken). Resolves where it went:
+     * `noSession` — nowhere, and the topic was told why.
+     */
+    deliverLabel: (key: SessionKey, label: string) => Promise<LatePromptOutcome | null>;
+    /** Wake the topic's SLEEPING conversation for a prompt of its own; `true` when it is live (a start that failed has told the topic why). */
+    resumeSleepingSessionForPrompt: (key: SessionKey) => Promise<boolean>;
+    /** Whether a session of the topic is starting (or stopping), so a prompt is buffered for the one to come. */
+    checkIsStarting: (key: SessionKey) => boolean;
+    /**
+     * End a question message the bot holds no record of, when its buttons are tapped: its own text (`messageText`) stays and
+     * «not answered» takes the place of the buttons. Resolves whether the message was changed at all (the text edit or the
+     * removal of the buttons landed); when not, its buttons are still there and the next tap tries again.
+     */
+    closeOrphanQuestionMessage: (key: SessionKey, messageId: number, messageText: string | null) => Promise<boolean>;
+    /** A person wrote in the topic: the bot-wide effects of that (the idle latch, the todo registry) — and the re-asked question's own end. */
+    notePersonActivity: (key: SessionKey) => void;
 }
 /**
  * @description Build the compaction flow — `/compact`, the compact-on-idle watchdog and its deferred variant —
@@ -40,7 +98,11 @@ export declare function createCompaction(ports: CompactionPorts): {
     };
     checkIsDeferredCompactionArmed: (key: SessionKey) => boolean;
     threadsCompacting: Set<string>;
-    reAskedQuestionOptions: Map<string, string[]>;
+    answerReAskedQuestionByNumber: (key: SessionKey, text: string) => Promise<boolean>;
+    reAskInterruptedQuestion: (key: SessionKey, saved: ReAskedQuestionRecord) => Promise<void>;
+    restoreReAskedQuestion: (key: SessionKey, saved: ReAskedQuestionRecord) => void;
+    closeSavedReAskedQuestion: (key: SessionKey, saved: ReAskedQuestionRecord) => void;
+    closeReAskedQuestion: (key: SessionKey) => void;
     registerCompactionCommands: () => void;
     registerCompactionCallbacks: () => void;
 };

package/dist/connectors/telegram/commands/compaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/compaction.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAoB,MAAM,gBAAgB,CAAC;AAC3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AA2BtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoHzC;;;GAGG;AACH,MAAM,WAAW,eACf,SAAQ,IAAI,CACV,OAAO,EACP,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,GAAG,qBAAqB,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,qBAAqB,CAC9J;IACD,iBAAiB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IAC7C,oBAAoB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACpD,oBAAoB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,qBAAqB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC;IACpD;;;OAGG;IACH,oBAAoB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,8GAA8G;IAC9G,kCAAkC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe;mCAoBf,UAAU,KAAG,OAAO;8BA6LzB,UAAU,KAAG,IAAI;kCA4Fb,UAAU,KAAG,IAAI;wCAaX,UAAU,KAAG,IAAI;iCAYxB,UAAU,KAAG,IAAI;gCAvGlB,UAAU,KAAG,IAAI;iCAiVhB,UAAU,KAAG;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;0CA/OpC,UAAU,KAAG,OAAO;;;sCAwZ1B,IAAI;uCAgGH,IAAI;EAgC7C"}
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/compaction.ts"],"names":[],"mappings":"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"}