charness 0.0.0-stage → 3.0.0

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

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendAutoContinueLimitsHint = appendAutoContinueLimitsHint;
+exports.createAutoContinueLimits = createAutoContinueLimits;
+/**
+ * `/auto_continue_limits` — whether the bot resumes an agent by itself when a usage-limit window resets, per topic
+ * or (in General) for the instance — with its buttons. See README.md in this folder.
+ */
+const telegraf_1 = require("telegraf");
+const sessionKeyCodec_1 = require("../sessionKeyCodec");
+const rateLimiter_1 = require("../../../rateLimiter");
+const i18n_1 = require("../../../i18n");
+const sendErrorClassifier_1 = require("../../../sendErrorClassifier");
+const autoContinueOnLimit_1 = require("../../../utils/autoContinueOnLimit");
+/**
+ * @description Append the shared `/auto_continue_limits` pointer to a usage-limit
+ * arming notice. ONE key appended at ONE place, so the reset-time notice and the
+ * "retrying in N min" fallback can never drift apart (the `effort.current_hint`
+ * block shared by both `/model`-set replies is the same pattern). No inline
+ * keyboard is needed: Telegram auto-links a bare command written in message text.
+ */
+function appendAutoContinueLimitsHint(noticeText) {
+    return `${noticeText}\n\n${(0, i18n_1.t)('autoContinueLimits.noticeHint')}`;
+}
+/**
+ * @description Build the `/auto_continue_limits` picker keyboard: Enable / Disable
+ * with `✓` on the current value, plus a «skip once» row ONLY while a limit resume
+ * is actually armed for the topic. A skip row with nothing to skip would be a dead
+ * end (same reasoning as the `/model` re-render never offering an empty list).
+ */
+function buildAutoContinueLimitsKeyboard(isEnabled, armedFireAt) {
+    const rows = [[
+            telegraf_1.Markup.button.callback((0, i18n_1.t)('autoContinueLimits.enableButton') + (isEnabled ? ' ✓' : ''), 'acl_on'),
+            telegraf_1.Markup.button.callback((0, i18n_1.t)('autoContinueLimits.disableButton') + (!isEnabled ? ' ✓' : ''), 'acl_off'),
+        ]];
+    if (armedFireAt !== null) {
+        rows.push([
+            telegraf_1.Markup.button.callback((0, i18n_1.t)('autoContinueLimits.skipButton'), (0, autoContinueOnLimit_1.buildSkipArmedRetryCallbackData)(armedFireAt)),
+        ]);
+    }
+    return telegraf_1.Markup.inlineKeyboard(rows);
+}
+/**
+ * @description Build the auto-resume switch over its ports. It returns the picker consumer the usage-limit
+ * notice's own buttons call, and the `register…()` calls.
+ */
+function createAutoContinueLimits(ports) {
+    const { getArmedLimitRetryFireAt, cancelApiRetry, getRequestWakeUpEngine, bot, command, getState, replyToThread, authoriseContext, withThreadLocale, checkIsGeneral } = ports;
+    /**
+     * @description Apply the `/auto_continue_limits` setting and RETURN the
+     * confirmation text — the single write path behind the command and its picker
+     * buttons, so the two can never drift. The caller decides delivery (the command
+     * replies; the picker edits its own message into the confirmation).
+     *
+     * Regular topic → the per-thread override; General topic → the instance-wide
+     * default. Turning it OFF for a topic also drops that topic's armed resume:
+     * staying armed after «Disable» would contradict the setting. Unlike
+     * `/compact_on_idle` there is no timer to re-arm — the toggle is read at the
+     * moment a limit error arrives.
+     */
+    async function applyAutoContinueLimits(key, isGeneral, enabled) {
+        const stateWord = enabled ? (0, i18n_1.t)('autoContinueLimits.on') : (0, i18n_1.t)('autoContinueLimits.off');
+        if (isGeneral) {
+            await getState().setAutoContinueOnLimitGlobalDefault(enabled);
+            return (0, i18n_1.t)('autoContinueLimits.setGlobal', { state: stateWord });
+        }
+        await getState().setAutoContinueOnLimitOverride(key, enabled);
+        if (!enabled) {
+            const isLimitWaitArmed = getArmedLimitRetryFireAt(key) !== null;
+            cancelApiRetry(key);
+            // Nothing resumes this wait any more: its request must not be woken into the same limit.
+            if (isLimitWaitArmed)
+                await getRequestWakeUpEngine()?.stopWakingForLimitWait(key);
+        }
+        return (0, i18n_1.t)('autoContinueLimits.setThisTopic', { state: stateWord });
+    }
+    /**
+     * @description Rewrite the tapped picker into a final, keyboard-less confirmation:
+     * a pick consumes the menu (the `/language` picker is the reference), so the same
+     * button can't be acted on twice and the topic reads truthfully. Best-effort — a
+     * failed edit only costs the relabel, never the state change that preceded it.
+     */
+    async function consumeAutoContinueLimitsPicker(key, cbMsg, text) {
+        if (!cbMsg)
+            return;
+        try {
+            await (0, rateLimiter_1.enqueueSend)(key, () => bot.telegram.editMessageText((0, sessionKeyCodec_1.getTelegramChatId)(key), cbMsg.message_id, undefined, text));
+        }
+        catch (e) {
+            const desc = (0, sendErrorClassifier_1.checkIsApiError)(e) ? (0, sendErrorClassifier_1.getErrorDescription)(e) : '';
+            if (!/message is not modified/i.test(desc))
+                console.warn('[acl_cb] picker relabel failed:', desc || e);
+        }
+    }
+    /** Shared `acl_on` / `acl_off` tap handler: apply, then consume the picker. */
+    async function handleAutoContinueLimitsCallback(ctx, enabled) {
+        const key = await authoriseContext(ctx);
+        if (!key) {
+            await ctx.answerCbQuery((0, i18n_1.t)('cb.access_denied'));
+            return;
+        }
+        await withThreadLocale(key, async () => {
+            const confirmation = await applyAutoContinueLimits(key, checkIsGeneral(key), enabled);
+            await ctx.answerCbQuery();
+            await consumeAutoContinueLimitsPicker(key, ctx.callbackQuery?.message, confirmation);
+        });
+    }
+    function registerAutoContinueLimitsCommands() {
+        // `/auto_continue_limits` — toggle waiting out a usage/session limit and resuming by
+        // itself. Regular topic → per-thread override; General → the instance-wide
+        // default. Bare → an Enable/Disable picker (✓ on current) plus a «skip once» row
+        // while a resume is armed. Deliberately NOT gated on an adapter/session (unlike
+        // `/compact_on_idle`): a limit can hit any topic at any time, and the operator must
+        // be able to set the preference before that.
+        command('auto_continue_limits', async (ctx, key) => {
+            const arg = ctx.message.text.split(/\s+/).slice(1).join(' ').trim().toLowerCase();
+            const isGeneral = checkIsGeneral(key);
+            if (arg === 'on' || arg === 'off') {
+                await replyToThread(key, await applyAutoContinueLimits(key, isGeneral, arg === 'on'));
+                return;
+            }
+            const isEnabled = isGeneral
+                ? getState().getAutoContinueOnLimitGlobalDefault()
+                : getState().checkIsAutoContinueOnLimitEnabled(key);
+            const stateWord = isEnabled ? (0, i18n_1.t)('autoContinueLimits.on') : (0, i18n_1.t)('autoContinueLimits.off');
+            const title = isGeneral
+                ? (0, i18n_1.t)('autoContinueLimits.titleGeneral', { state: stateWord })
+                : (0, i18n_1.t)('autoContinueLimits.title', { state: stateWord });
+            await replyToThread(key, title, buildAutoContinueLimitsKeyboard(isEnabled, getArmedLimitRetryFireAt(key)));
+        });
+    }
+    function registerAutoContinueLimitsCallbacks() {
+        bot.action('acl_on', (ctx) => handleAutoContinueLimitsCallback(ctx, true));
+        bot.action('acl_off', (ctx) => handleAutoContinueLimitsCallback(ctx, false));
+    }
+    return {
+        consumeAutoContinueLimitsPicker,
+        registerAutoContinueLimitsCommands,
+        registerAutoContinueLimitsCallbacks,
+    };
+}
+//# sourceMappingURL=autoContinueLimits.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * The ports every Telegram command module takes from `bot.ts`: the telegraf instance, the neutral command
+ * registrar, the topic send helpers and the few cross-cutting calls a handler makes. A module asks for the
+ * 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 { InboundCommand } from '../../../platform/inbound';
+import type { SessionKey } from '../../../sessionKey';
+import type { StateStore } from '../../../state';
+/** The Telegram context a command handler receives — a text message, always. */
+export type CommandContext = NarrowedContext<Context, Update.MessageUpdate<Message.TextMessage>>;
+/** Register a command handler on the neutral router. */
+export type RegisterCommand = (name: string | string[], handler: (ctx: CommandContext, key: SessionKey, parsed: InboundCommand) => Promise<void> | void) => void;
+export interface BotCore {
+    bot: Telegraf;
+    command: RegisterCommand;
+    /**
+     * The state store, assigned when the bot boots — after the handlers are registered. Read it through this
+     * getter each time a handler RUNS; a copy taken at registration would be `undefined`.
+     */
+    getState: () => StateStore;
+    /** Send into the topic (paced, tracked for `/clear_messages`); the sent message id, or `null` when the send failed. */
+    replyToThread: (key: SessionKey, text: string, extra?: object, options?: {
+        unpaced?: boolean;
+    }) => 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>;
+    /** 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(…)`. */
+    withThreadLocale: <TResult>(key: SessionKey, fn: () => TResult) => TResult;
+    checkIsGeneral: (key: SessionKey) => boolean;
+    /** Refresh (or create) the topic's pinned status banner. */
+    updatePinnedStatus: (key: SessionKey) => Promise<void>;
+    /** Close the topic's open request as cancelled (the conversation was cancelled or ended). */
+    cancelConversationRequest: (key: SessionKey) => void;
+    /**
+     * Wake the topic's SLEEPING conversation (process stopped, session kept) before a command that needs a live
+     * agent. The notice to post (a resume that failed and a fresh start), `''` for a silent resume, `null` when
+     * nothing slept.
+     */
+    wakeSleepingSession: (key: SessionKey) => Promise<string | null>;
+}
+//# sourceMappingURL=botCore.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=botCore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"botCore.js","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/botCore.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,12 @@
+/**
+ * The message a callback button sits on.
+ */
+import type { Context } from 'telegraf';
+/**
+ * @description Id of the message a callback button sits on, or `null` when
+ * Telegram did not attach one (a very old message). Callbacks that resolve an
+ * INDEX against a per-message snapshot need it to reject a stale keyboard
+ * rather than resolve against another message's list.
+ */
+export declare function getCallbackMessageId(ctx: Context): number | null;
+//# sourceMappingURL=callbackMessage.d.ts.map

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

@@ -0,0 +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;AAExC;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEhE"}

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCallbackMessageId = getCallbackMessageId;
+/**
+ * @description Id of the message a callback button sits on, or `null` when
+ * Telegram did not attach one (a very old message). Callbacks that resolve an
+ * INDEX against a per-message snapshot need it to reject a stale keyboard
+ * rather than resolve against another message's list.
+ */
+function getCallbackMessageId(ctx) {
+    return ctx.callbackQuery?.message?.message_id ?? null;
+}
+//# sourceMappingURL=callbackMessage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callbackMessage.js","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/callbackMessage.ts"],"names":[],"mappings":";;AAWA,oDAEC;AARD;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,GAAY;IAC/C,OAAO,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,47 @@
+import type { AgentAdapter, PendingQuestionState } from '../../../types';
+import type { SessionKey } from '../../../sessionKey';
+import type { BotCore } from './botCore';
+/**
+ * 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'> {
+    startTypingLoader: (key: SessionKey) => void;
+    forwardPromptToAgent: (key: SessionKey, adapter: AgentAdapter, text: string) => Promise<void>;
+    pendingQuestions: Map<string, PendingQuestionState>;
+    clearPendingQuestion: (key: SessionKey) => void;
+    /** 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). */
+    checkIsLimitWaitArmed: (key: SessionKey) => boolean;
+    /**
+     * Stop the topic's process, the session kept resumable (the idle stop, L3) — the bot's own orchestration:
+     * one transition per key, a prompt arriving meanwhile buffered and the session resumed for it.
+     */
+    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>;
+}
+/**
+ * @description Build the compaction flow — `/compact`, the compact-on-idle watchdog and its deferred variant —
+ * over its ports. It returns the activity hooks the bot's prompt, output and session-lifecycle paths call, the
+ * state the typing loop and the request probe read, and the `register…()` calls.
+ */
+export declare function createCompaction(ports: CompactionPorts): {
+    checkIsThreadCompacting: (key: SessionKey) => boolean;
+    noteThreadActivity: (key: SessionKey) => void;
+    noteThreadUserActivity: (key: SessionKey) => void;
+    markThreadTurnProducedOutput: (key: SessionKey) => void;
+    clearThreadCompaction: (key: SessionKey) => void;
+    rearmThreadIdleTimer: (key: SessionKey) => void;
+    armDeferredCompaction: (key: SessionKey) => {
+        ok: boolean;
+        message: string;
+    };
+    checkIsDeferredCompactionArmed: (key: SessionKey) => boolean;
+    threadsCompacting: Set<string>;
+    reAskedQuestionOptions: Map<string, string[]>;
+    registerCompactionCommands: () => void;
+    registerCompactionCallbacks: () => void;
+};
+//# sourceMappingURL=compaction.d.ts.map

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

@@ -0,0 +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;AAyBtD,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;kCAkFb,UAAU,KAAG,IAAI;wCAaX,UAAU,KAAG,IAAI;iCAYxB,UAAU,KAAG,IAAI;gCA7FlB,UAAU,KAAG,IAAI;iCAmThB,UAAU,KAAG;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;0CA3NpC,UAAU,KAAG,OAAO;;;sCAoY1B,IAAI;uCAgGH,IAAI;EAgC7C"}