@moxxy/plugin-telegram 0.27.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moxxy (moxxy.ai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/approval.d.ts

@@ -0,0 +1,37 @@
+import type { ApprovalDecision, ApprovalRequest, ApprovalResolver } from '@moxxy/sdk';
+export interface PendingApproval {
+    readonly id: string;
+    readonly request: ApprovalRequest;
+    readonly resolve: (decision: ApprovalDecision) => void;
+}
+/**
+ * Generic approval resolver for the Telegram channel — counterpart to the
+ * TUI's ApprovalDialog. The channel renders the request as a message with
+ * an inline-keyboard option list and routes the user's button click (or
+ * follow-up text, for options with `requestsText: true`) back here via
+ * `resolvePending` / `resolvePendingWithText`.
+ *
+ * Mirrors TelegramPermissionResolver in shape: a Map<callId, pending>
+ * plus a `setDecider` callback the channel uses to actually render the
+ * UI. The strategy never knows whether the dialog is rendered as Ink
+ * components, inline keyboards, or a CLI prompt — it just awaits a
+ * promise.
+ */
+export declare class TelegramApprovalResolver implements ApprovalResolver {
+    readonly name = "telegram-approval";
+    private readonly pending;
+    private deciderFn;
+    private nextId;
+    setDecider(fn: (id: string, request: ApprovalRequest) => Promise<void>): void;
+    confirm(request: ApprovalRequest): Promise<ApprovalDecision>;
+    /** Look up a pending approval without resolving it. Used by the channel
+     *  when the user clicks an option that needs text follow-up — we keep
+     *  the approval pending and capture the next message. */
+    getPending(id: string): PendingApproval | undefined;
+    /** Resolve directly with an option id (no text). */
+    resolvePending(id: string, optionId: string): boolean;
+    /** Resolve with an option id AND a free-text follow-up. */
+    resolvePendingWithText(id: string, optionId: string, text: string): boolean;
+    abortAll(reason?: string): void;
+}
+//# sourceMappingURL=approval.d.ts.map

package/dist/approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../src/approval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACxD;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,QAAQ,CAAC,IAAI,uBAAuB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,SAAS,CAA0E;IAC3F,OAAO,CAAC,MAAM,CAAK;IAEnB,UAAU,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIvE,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoBlE;;6DAEyD;IACzD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAInD,oDAAoD;IACpD,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQrD,2DAA2D;IAC3D,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAQ3E,QAAQ,CAAC,MAAM,SAAmB,GAAG,IAAI;CAS1C"}

package/dist/approval.js

@@ -0,0 +1,75 @@
+/**
+ * Generic approval resolver for the Telegram channel — counterpart to the
+ * TUI's ApprovalDialog. The channel renders the request as a message with
+ * an inline-keyboard option list and routes the user's button click (or
+ * follow-up text, for options with `requestsText: true`) back here via
+ * `resolvePending` / `resolvePendingWithText`.
+ *
+ * Mirrors TelegramPermissionResolver in shape: a Map<callId, pending>
+ * plus a `setDecider` callback the channel uses to actually render the
+ * UI. The strategy never knows whether the dialog is rendered as Ink
+ * components, inline keyboards, or a CLI prompt — it just awaits a
+ * promise.
+ */
+export class TelegramApprovalResolver {
+    name = 'telegram-approval';
+    pending = new Map();
+    deciderFn = null;
+    nextId = 1;
+    setDecider(fn) {
+        this.deciderFn = fn;
+    }
+    async confirm(request) {
+        if (!this.deciderFn) {
+            // No bot wired up — best fallback is the request's defaultOptionId.
+            // For plan-execute, the default is "approve" which preserves the
+            // headless behavior (run the plan as drafted).
+            return { optionId: request.defaultOptionId ?? request.options[0]?.id ?? 'approve' };
+        }
+        const id = `appr_${this.nextId++}`;
+        return new Promise((resolve) => {
+            this.pending.set(id, { id, request, resolve });
+            this.deciderFn(id, request).catch((err) => {
+                this.pending.delete(id);
+                resolve({
+                    optionId: request.defaultOptionId ?? request.options[0]?.id ?? 'cancel',
+                    text: `decider failed: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            });
+        });
+    }
+    /** Look up a pending approval without resolving it. Used by the channel
+     *  when the user clicks an option that needs text follow-up — we keep
+     *  the approval pending and capture the next message. */
+    getPending(id) {
+        return this.pending.get(id);
+    }
+    /** Resolve directly with an option id (no text). */
+    resolvePending(id, optionId) {
+        const pending = this.pending.get(id);
+        if (!pending)
+            return false;
+        this.pending.delete(id);
+        pending.resolve({ optionId });
+        return true;
+    }
+    /** Resolve with an option id AND a free-text follow-up. */
+    resolvePendingWithText(id, optionId, text) {
+        const pending = this.pending.get(id);
+        if (!pending)
+            return false;
+        this.pending.delete(id);
+        pending.resolve({ optionId, text });
+        return true;
+    }
+    abortAll(reason = 'channel closed') {
+        for (const pending of this.pending.values()) {
+            pending.resolve({
+                optionId: pending.request.defaultOptionId ?? pending.request.options[0]?.id ?? 'cancel',
+                text: reason,
+            });
+        }
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=approval.js.map

package/dist/approval.js.map

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

package/dist/channel/approval-prompt.d.ts

@@ -0,0 +1,20 @@
+import { type Bot } from 'grammy';
+import type { ApprovalRequest } from '@moxxy/sdk';
+import type { TelegramApprovalResolver } from '../approval.js';
+export interface ApprovalPromptDeps {
+    readonly bot: Bot | null;
+    readonly chatId: number | null;
+    readonly resolver: TelegramApprovalResolver;
+    readonly logger?: {
+        warn(msg: string, meta?: Record<string, unknown>): void;
+    };
+}
+/**
+ * Render an approval request (e.g. plan-execute "validate plan") as a
+ * message + inline-keyboard option list. Options with `requestsText`
+ * are still picked here; the callback handler then captures the user's
+ * NEXT message as the follow-up text via the channel's awaiting-text
+ * state.
+ */
+export declare function askForApproval(id: string, request: ApprovalRequest, deps: ApprovalPromptDeps): Promise<void>;
+//# sourceMappingURL=approval-prompt.d.ts.map

package/dist/channel/approval-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-prompt.d.ts","sourceRoot":"","sources":["../../src/channel/approval-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAkB,MAAM,QAAQ,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAG/D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;CAC/E;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/channel/approval-prompt.js

@@ -0,0 +1,34 @@
+import { InlineKeyboard } from 'grammy';
+import { truncate } from './html.js';
+/**
+ * Render an approval request (e.g. plan-execute "validate plan") as a
+ * message + inline-keyboard option list. Options with `requestsText`
+ * are still picked here; the callback handler then captures the user's
+ * NEXT message as the follow-up text via the channel's awaiting-text
+ * state.
+ */
+export async function askForApproval(id, request, deps) {
+    if (!deps.bot || !deps.chatId)
+        return;
+    const keyboard = new InlineKeyboard();
+    for (const opt of request.options) {
+        const label = `${opt.hotkey ? `[${opt.hotkey}] ` : ''}${opt.label}`;
+        keyboard.text(label, `appr:${id}:${opt.id}`).row();
+    }
+    // Telegram has a ~4096-char message limit; truncate the body so a
+    // verbose plan doesn't fail to send. The full plan is also in the
+    // chat scrollback (the assistant_message events get streamed in).
+    const bodySnippet = truncate(request.body, 3000);
+    const summary = `📋 ${request.title}\n\n${bodySnippet}\n\n` +
+        `Pick an option below. Some options (e.g. Redraft) will prompt for follow-up text after you click.`;
+    try {
+        await deps.bot.api.sendMessage(deps.chatId, summary, { reply_markup: keyboard });
+    }
+    catch (err) {
+        deps.logger?.warn('approval send failed', { err: String(err) });
+        // Default-resolve on send failure so the loop strategy doesn't hang.
+        const fallback = request.defaultOptionId ?? request.options[0]?.id ?? 'cancel';
+        deps.resolver.resolvePending(id, fallback);
+    }
+}
+//# sourceMappingURL=approval-prompt.js.map

package/dist/channel/approval-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-prompt.js","sourceRoot":"","sources":["../../src/channel/approval-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,cAAc,EAAE,MAAM,QAAQ,CAAC;AAGlD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AASrC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAU,EACV,OAAwB,EACxB,IAAwB;IAExB,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO;IACtC,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;QACpE,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;IACrD,CAAC;IACD,kEAAkE;IAClE,kEAAkE;IAClE,kEAAkE;IAClE,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,OAAO,GACX,MAAM,OAAO,CAAC,KAAK,OAAO,WAAW,MAAM;QAC3C,mGAAmG,CAAC;IACtG,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChE,qEAAqE;QACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,QAAQ,CAAC;QAC/E,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/channel/callback-handler.d.ts

@@ -0,0 +1,32 @@
+import type { Bot, Context } from 'grammy';
+import type { ClientSession as Session } from '@moxxy/sdk';
+import type { TelegramPermissionResolver } from '../permission.js';
+import type { TelegramApprovalResolver } from '../approval.js';
+export interface AwaitingApprovalText {
+    approvalId: string;
+    optionId: string;
+}
+export interface CallbackState {
+    readonly bot: Bot | null;
+    readonly session: Session | null;
+    readonly chatId: number | null;
+    readonly permissionResolver: TelegramPermissionResolver;
+    readonly approvalResolver: TelegramApprovalResolver;
+    /** Pairing gate — the same authorization check the text/voice handlers enforce. */
+    readonly pairing: {
+        isAuthorized(chatId: number): boolean;
+    };
+}
+export interface CallbackCallbacks {
+    /** Latch an in-flight approval awaiting a text follow-up. */
+    setAwaitingApprovalText(state: AwaitingApprovalText | null): void;
+    setActiveModelOverride(modelId: string): void;
+}
+/** Inline-keyboard callback router. Dispatches by prefix:
+ *  - `perm:`   → permission resolver
+ *  - `appr:`   → approval resolver
+ *  - `model:`  → provider+model switch (with credential resolve)
+ *  - `mode:`   → mode switch
+ */
+export declare function handleCallback(ctx: Context, state: CallbackState, cb: CallbackCallbacks): Promise<void>;
+//# sourceMappingURL=callback-handler.d.ts.map

package/dist/channel/callback-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-handler.d.ts","sourceRoot":"","sources":["../../src/channel/callback-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAG3C,OAAO,KAAK,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;IACxD,QAAQ,CAAC,gBAAgB,EAAE,wBAAwB,CAAC;IACpD,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE;QAAE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CAC7D;AAED,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAAC;IAClE,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,aAAa,EACpB,EAAE,EAAE,iBAAiB,GACpB,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/dist/channel/callback-handler.js

@@ -0,0 +1,212 @@
+import { setCategoryDefault, setProviderModel } from '@moxxy/config';
+import { isSelectableMode } from '@moxxy/sdk';
+/** Inline-keyboard callback router. Dispatches by prefix:
+ *  - `perm:`   → permission resolver
+ *  - `appr:`   → approval resolver
+ *  - `model:`  → provider+model switch (with credential resolve)
+ *  - `mode:`   → mode switch
+ */
+export async function handleCallback(ctx, state, cb) {
+    const data = ctx.callbackQuery?.data;
+    if (!data)
+        return;
+    // Authorization gate — mirror the text/voice handlers. Button clicks can
+    // resolve permission prompts, approve plans, and switch provider/model/mode,
+    // so an unpaired chat's callbacks must be refused just like its messages
+    // (inline-keyboard messages can be forwarded to arbitrary chats).
+    const chatId = ctx.chat?.id ?? ctx.callbackQuery?.message?.chat?.id;
+    if (chatId === undefined || !state.pairing.isAuthorized(chatId)) {
+        try {
+            await ctx.answerCallbackQuery({ text: 'This bot is paired with a different chat.' });
+        }
+        catch {
+            /* ignore */
+        }
+        return;
+    }
+    if (data.startsWith('perm:')) {
+        await handlePerm(ctx, data, state.permissionResolver);
+        return;
+    }
+    if (data.startsWith('appr:')) {
+        await handleAppr(ctx, data, state, cb);
+        return;
+    }
+    if (data.startsWith('model:')) {
+        await handleModel(ctx, data, state.session, cb);
+        return;
+    }
+    if (data.startsWith('mode:')) {
+        await handleMode(ctx, data, state.session);
+        return;
+    }
+}
+async function handlePerm(ctx, data, resolver) {
+    const parts = data.split(':');
+    if (parts.length !== 3)
+        return;
+    const [, callId, choice] = parts;
+    if (!callId || !choice)
+        return;
+    const decision = mapChoice(choice);
+    const handled = resolver.resolvePending(callId, decision);
+    await ctx.answerCallbackQuery({ text: handled ? choice : 'no pending permission' });
+    if (handled && ctx.callbackQuery?.message) {
+        try {
+            await ctx.editMessageReplyMarkup({});
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+async function handleAppr(ctx, data, state, cb) {
+    // Format: appr:<approvalId>:<optionId>
+    const idx = data.indexOf(':', 5);
+    if (idx < 0)
+        return;
+    const approvalId = data.slice(5, idx);
+    const optionId = data.slice(idx + 1);
+    const pending = state.approvalResolver.getPending(approvalId);
+    if (!pending) {
+        await ctx.answerCallbackQuery({ text: 'no pending approval' });
+        return;
+    }
+    const option = pending.request.options.find((o) => o.id === optionId);
+    if (!option) {
+        await ctx.answerCallbackQuery({ text: 'unknown option' });
+        return;
+    }
+    // Clear the inline keyboard so the user can't double-click.
+    if (ctx.callbackQuery?.message) {
+        try {
+            await ctx.editMessageReplyMarkup({});
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    if (option.requestsText) {
+        // Don't resolve yet — capture the user's next message as the
+        // follow-up text. Mirrors the TUI dialog's text-entry sub-mode.
+        cb.setAwaitingApprovalText({ approvalId, optionId });
+        await ctx.answerCallbackQuery({ text: option.label });
+        const prompt = option.textPrompt ??
+            `Send your message — the next text you type becomes the ${optionId} input.`;
+        if (state.chatId && state.bot) {
+            try {
+                await state.bot.api.sendMessage(state.chatId, `✏️ ${prompt}`);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        return;
+    }
+    state.approvalResolver.resolvePending(approvalId, optionId);
+    await ctx.answerCallbackQuery({ text: option.label });
+}
+async function handleModel(ctx, data, session, cb) {
+    // Format: model:<providerName>::<modelId>
+    const payload = data.slice(6);
+    const [providerId, modelId] = payload.split('::');
+    if (!providerId || !modelId || !session) {
+        await ctx.answerCallbackQuery({ text: 'invalid model selection' });
+        return;
+    }
+    // Intercept switches to unconfigured providers — otherwise OAuth-
+    // backed providers (openai-codex) would surface a credential
+    // error on the next turn. Match the TUI's wording so the user
+    // sees the same setup command in both channels.
+    const ready = session.readyProviders ?? new Set();
+    if (!ready.has(providerId)) {
+        const cmd = providerId === 'openai-codex'
+            ? 'moxxy login openai-codex'
+            : `moxxy init   # (will prompt for ${providerId.toUpperCase()}_API_KEY)`;
+        await ctx.answerCallbackQuery({ text: `${providerId} not connected` });
+        if (ctx.callbackQuery?.message) {
+            try {
+                await ctx.editMessageText(`${providerId} isn't connected.\n\nRun \`${cmd}\` then restart moxxy.`, { parse_mode: 'Markdown' });
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        return;
+    }
+    try {
+        if (session.providers.getActiveName() !== providerId) {
+            // Resolve credentials and drop the cached instance, same as
+            // the TUI. Without this the new provider gets createClient({})
+            // and openai-codex throws "no OAuth credentials" on next turn.
+            const resolver = session.credentialResolver;
+            const cfg = resolver ? await resolver(providerId) : {};
+            const def = session.providers.list().find((p) => p.name === providerId);
+            if (def)
+                session.providers.replace(def);
+            session.providers.setActive(providerId, cfg);
+        }
+        cb.setActiveModelOverride(modelId);
+        // Persist to the unified manifest for the next CLI run — same config the TUI
+        // writes. Await so a write failure (disk/permission/lock) is caught below and
+        // reported, instead of telling the user "✓ switched" while it never landed.
+        await setCategoryDefault('provider', providerId);
+        await setProviderModel(providerId, modelId);
+        await ctx.answerCallbackQuery({ text: `→ ${providerId}:${modelId}` });
+        if (ctx.callbackQuery?.message) {
+            try {
+                await ctx.editMessageText(`✓ switched to ${providerId}:${modelId}`);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    catch (err) {
+        await ctx.answerCallbackQuery({
+            text: `failed: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    }
+}
+async function handleMode(ctx, data, session) {
+    const modeName = data.slice(5);
+    if (!modeName || !session) {
+        await ctx.answerCallbackQuery({ text: 'invalid mode' });
+        return;
+    }
+    // Refuse a special mode reached by name (e.g. a stale callback) — special
+    // modes are entered only via their own command. Mirrors the TUI guard.
+    const target = session.modes.list().find((m) => m.name === modeName);
+    if (target && !isSelectableMode(target)) {
+        await ctx.answerCallbackQuery({ text: `"${modeName}" is a special mode` });
+        return;
+    }
+    try {
+        session.modes.setActive(modeName);
+        // Await so a persistence failure is caught below (and reported) rather than
+        // claiming success while it silently never landed.
+        await setCategoryDefault('mode', modeName);
+        await ctx.answerCallbackQuery({ text: `mode → ${modeName}` });
+        if (ctx.callbackQuery?.message) {
+            try {
+                await ctx.editMessageText(`✓ mode → ${modeName}`);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    catch (err) {
+        await ctx.answerCallbackQuery({
+            text: `failed: ${err instanceof Error ? err.message : String(err)}`,
+        });
+    }
+}
+function mapChoice(choice) {
+    if (choice === 'allow')
+        return { mode: 'allow' };
+    if (choice === 'allow_session')
+        return { mode: 'allow_session' };
+    return { mode: 'deny', reason: 'denied by user' };
+}
+//# sourceMappingURL=callback-handler.js.map

package/dist/channel/callback-handler.js.map

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

package/dist/channel/frame-pump.d.ts

@@ -0,0 +1,58 @@
+import type { Bot } from 'grammy';
+import { TurnRenderer } from '../render.js';
+export interface FramePumpLogger {
+    warn(msg: string, meta?: Record<string, unknown>): void;
+}
+export interface FramePumpOptions {
+    readonly editFrameMs: number;
+    readonly logger?: FramePumpLogger;
+}
+/**
+ * Drives the throttled "compose snapshot → send/edit one message" loop
+ * for a turn. Owns the renderer and the Telegram-specific delivery —
+ * HTML parse-mode fallback + 4096-char message splitting — while the
+ * throttle/send-once-then-edit mechanics live in `@moxxy/channel-kit`'s
+ * {@link StreamPump} (one instance per turn).
+ *
+ * Lifecycle per turn:
+ *   1. `beginTurn(chatId)` resets state.
+ *   2. Renderer updates schedule edits via `scheduleEdit()`.
+ *   3. `flush(final)` drains the latest snapshot to Telegram.
+ *   4. `endTurn()` clears timers + chat binding.
+ */
+export declare class FramePump {
+    private readonly editFrameMs;
+    private readonly logger?;
+    private bot;
+    private renderer;
+    private pump;
+    constructor(opts: FramePumpOptions);
+    attachBot(bot: Bot | null): void;
+    /** Renderer the channel feeds events into. Owned here so reset/snapshot
+     *  cycles stay coordinated with the message-id state. */
+    get renderState(): TurnRenderer;
+    resetRenderer(): void;
+    beginTurn(chatId: number): void;
+    endTurn(): void;
+    scheduleEdit(): void;
+    flush(final: boolean): Promise<void>;
+    /** First real content of this turn — send (don't edit a placeholder). On the
+     *  final frame, overflow beyond Telegram's message limit goes out as
+     *  follow-up messages. */
+    private sendFrame;
+    private editFrame;
+    /**
+     * `text` is already Telegram-flavored HTML (produced by
+     * `composeFrame`). Try HTML; on parse-entity errors, strip tags and
+     * send plain text so the message still lands instead of looping on
+     * the same edit forever.
+     */
+    safeEdit(chatId: number, messageId: number, text: string): Promise<void>;
+    /**
+     * Send a new message (first frame of a turn or split-tail).
+     * Returns the new message_id on success so callers can set
+     * messageId for future edits.
+     */
+    safeSend(chatId: number, text: string): Promise<number | null>;
+}
+//# sourceMappingURL=frame-pump.d.ts.map

package/dist/channel/frame-pump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-pump.d.ts","sourceRoot":"","sources":["../../src/channel/frame-pump.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAGlC,OAAO,EAAE,YAAY,EAAoB,MAAM,cAAc,CAAC;AAG9D,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAkB;IAC1C,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,IAAI,CAAmC;gBAEnC,IAAI,EAAE,gBAAgB;IAKlC,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;IAIhC;6DACyD;IACzD,IAAI,WAAW,IAAI,YAAY,CAE9B;IAED,aAAa,IAAI,IAAI;IAIrB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAqB/B,OAAO,IAAI,IAAI;IAKf,YAAY,IAAI,IAAI;IAId,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C;;8BAE0B;YACZ,SAAS;YAYT,SAAS;IAgBvB;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB9E;;;;OAIG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAqBrE"}