@moxxy/plugin-telegram 0.41.3 → 0.42.0

package/dist/pair-flow.js.map

@@ -1 +1 @@
-{"version":3,"file":"pair-flow.js","sourceRoot":"","sources":["../src/pair-flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAiC,MAAM,YAAY,CAAC;AAEnF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,uEAAuE;AACvE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;AAC3D,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAA6B;IAC7D,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC5B,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC;QAClC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAmB;QACnC,KAAK,EAAG,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,CAAwB,IAAI,SAAS;QACvE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAe;KACjC,CAAC,CAAC;IACH,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE1D,iEAAiE;IACjE,IAAI,aAAa,GAAsC,IAAI,CAAC;IAC5D,MAAM,MAAM,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QAC7C,aAAa,GAAG,OAAO,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE;QAC9C,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC;QACxB,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAExC,iFAAiF;IACjF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5D,mEAAmE;IACnE,mCAAmC;IACnC,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACxC,WAAW,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC,CAAC;IAEF,2EAA2E;IAC3E,0EAA0E;IAC1E,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,GAAG,CAAC,IAAI,CACN,kGAAkG,CACnG,CAAC;QACF,MAAM,OAAO,EAAE,CAAC;QAChB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,CAAC,KAAK,CAAC,yFAAyF,CAAC,CAAC;QACrG,MAAM,OAAO,EAAE,CAAC;QAChB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IACvB,GAAG,CAAC,IAAI,CAAC,+FAA+F,CAAC,CAAC;IAE1G,0EAA0E;IAC1E,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE;QACzC,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,MAAM,OAAO,EAAE,CAAC;QAChB,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,GAAS,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAElC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,IAAI,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;IAC5B,IAAI,CAAC,IAAI,CAAC,mBAAmB,MAAM,iBAAiB,CAAC,CAAC;IAEtD,IAAI,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,yEAAyE;QACzE,uEAAuE;QACvE,6DAA6D;QAC7D,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC5C,MAAM,OAAO,EAAE,CAAC;QAChB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,oEAAoE;QACpE,oEAAoE;QACpE,MAAM,MAAM,CAAC,OAAO,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,KAAK,UAAU,WAAW,CAAC,GAAW;IACpC,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,IAAI,CAAC;QACH,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,EAAE,GAAG,EAAE,CAAC;IACV,CAAC;IACD,oCAAoC;IACpC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,WAAW,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"pair-flow.js","sourceRoot":"","sources":["../src/pair-flow.ts"],"names":[],"mappings":"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"}

package/dist/tools/send-message.d.ts

@@ -0,0 +1,21 @@
+import { InputFile } from 'grammy';
+import { type ToolDef } from '@moxxy/sdk';
+import { type TelegramSender } from '../channel/send-rich.js';
+/** The slice of grammy's `Api` this tool uses (the real client satisfies it). */
+export interface TelegramSendApi extends TelegramSender {
+    sendDocument(chatId: number, document: InputFile): Promise<unknown>;
+}
+export interface TelegramSendMessageToolDeps {
+    readonly getVault: () => {
+        get(name: string): Promise<string | null>;
+    };
+    /** Build the API client for a token. Defaults to grammy's lightweight `Api`. */
+    readonly createApi?: (token: string) => TelegramSendApi;
+}
+/**
+ * `telegram_send_message` — push a message (and files) to the paired chat from
+ * ANY session (desktop, goal mode, a scheduled prompt) without the Telegram
+ * channel running. A one-off `Api` rather than a full `Bot`: no long-polling.
+ */
+export declare function buildTelegramSendMessageTool(deps: TelegramSendMessageToolDeps): ToolDef;
+//# sourceMappingURL=send-message.d.ts.map

package/dist/tools/send-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-message.d.ts","sourceRoot":"","sources":["../../src/tools/send-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE5E,iFAAiF;AACjF,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;KAAE,CAAC;IACvE,gFAAgF;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,eAAe,CAAC;CACzD;AASD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAmEvF"}

package/dist/tools/send-message.js

@@ -0,0 +1,84 @@
+import { Api, InputFile } from 'grammy';
+import { defineTool, z } from '@moxxy/sdk';
+import { readLocalFiles, resolveSecret } from '@moxxy/channel-kit';
+import { TELEGRAM_AUTHORIZED_CHAT_KEY, TELEGRAM_TOKEN_KEY, parseChatId } from '../keys.js';
+import { sendMarkdown } from '../channel/send-rich.js';
+const TOKEN_ENV = 'MOXXY_TELEGRAM_TOKEN';
+/** Cap on one push — a couple of Telegram messages once split. */
+const MAX_TEXT_CHARS = 8_000;
+/** The Bot API accepts uploads up to 50 MB. */
+const MAX_UPLOAD_BYTES = 50 * 1024 * 1024;
+const MAX_FILES = 10;
+/**
+ * `telegram_send_message` — push a message (and files) to the paired chat from
+ * ANY session (desktop, goal mode, a scheduled prompt) without the Telegram
+ * channel running. A one-off `Api` rather than a full `Bot`: no long-polling.
+ */
+export function buildTelegramSendMessageTool(deps) {
+    const createApi = deps.createApi ?? ((token) => new Api(token));
+    return defineTool({
+        name: 'telegram_send_message',
+        description: 'Push a message to the paired Telegram chat. Use it to proactively report progress, a finished ' +
+            'task, or a blocker that needs their decision — e.g. from a long goal-mode run or a scheduled ' +
+            'prompt — without the Telegram channel running. The text is rendered with the same rich ' +
+            'Markdown→Telegram formatting as interactive replies (bold, code, `> [!type]` callouts, ' +
+            '`||spoilers||`); pass an explicit `parseMode` to send the raw text under that parse mode ' +
+            'instead. Long text is split into several messages. Pass `files` (local paths) to send files ' +
+            'the owner asked for as documents — up to 10 files, 50 MB in total. Requires a stored bot ' +
+            'token + a paired chat (run `moxxy channels telegram pair` once).',
+        inputSchema: z.object({
+            text: z.string().trim().min(1).max(MAX_TEXT_CHARS),
+            files: z.array(z.string().min(1).max(4096)).max(MAX_FILES).optional(),
+            /** Optional override; defaults to the vault-paired chat id. */
+            chatId: z.number().int().optional(),
+            /** Force a Telegram parse mode and send `text` verbatim under it. */
+            parseMode: z.enum(['MarkdownV2', 'Markdown', 'HTML']).optional(),
+        }),
+        permission: { action: 'prompt' },
+        isolation: {
+            capabilities: {
+                // Attachments are whatever local file the owner asked for; the
+                // permission prompt shows the paths before anything is read or sent.
+                fs: { read: ['~/.moxxy/vault.*', '~/**', '$cwd/**', '/tmp/**'] },
+                net: { mode: 'allowlist', hosts: ['api.telegram.org'] },
+                env: [TOKEN_ENV],
+                timeMs: 120_000,
+            },
+        },
+        handler: async ({ text, files: filePaths, chatId, parseMode }, ctx) => {
+            const vault = deps.getVault();
+            const token = await resolveSecret(vault, { envVar: TOKEN_ENV, vaultKey: TELEGRAM_TOKEN_KEY });
+            if (!token) {
+                throw new Error(`no Telegram bot token configured (set ${TOKEN_ENV} or run \`moxxy channels telegram setup\`)`);
+            }
+            const target = chatId ?? parseChatId(await vault.get(TELEGRAM_AUTHORIZED_CHAT_KEY));
+            if (!target) {
+                throw new Error('no authorized chat — run `moxxy channels telegram pair` first or pass `chatId` explicitly');
+            }
+            const files = await readLocalFiles(filePaths ?? [], {
+                cwd: ctx.cwd,
+                maxTotalBytes: MAX_UPLOAD_BYTES,
+                service: 'Telegram',
+                limitLabel: '50 MB per upload',
+            });
+            const api = createApi(token);
+            let parts = 1;
+            // An explicit mode means the caller owns the markup: send it verbatim.
+            if (parseMode)
+                await api.sendMessage(target, text, { parse_mode: parseMode });
+            else
+                parts = await sendMarkdown(api, target, text);
+            // Files go under the text that introduces them, in order.
+            for (const file of files)
+                await api.sendDocument(target, new InputFile(file.data, file.name));
+            return {
+                delivered: true,
+                chatId: target,
+                parts,
+                length: text.length,
+                ...(files.length > 0 ? { files: files.map((f) => f.name) } : {}),
+            };
+        },
+    });
+}
+//# sourceMappingURL=send-message.js.map

package/dist/tools/send-message.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moxxy/plugin-telegram",
-  "version": "0.41.3",
+  "version": "0.42.0",
   "description": "Telegram channel for moxxy via grammy. Treats Telegram chats as a bidirectional channel: prompts in, assistant + tool prompts out, inline-keyboard permission flow, QR deep-link chat pairing.",
   "keywords": [
     "moxxy",
@@ -68,19 +68,20 @@
     "@clack/prompts": "1.8.1",
     "grammy": "^1.46.0",
     "qrcode": "^1.5.4",
-    "@moxxy/channel-kit": "0.41.3",
-    "@moxxy/config": "0.41.3",
-    "@moxxy/plugin-vault": "0.41.3",
-    "@moxxy/core": "0.41.3",
-    "@moxxy/sdk": "0.41.3"
+    "@moxxy/channel-kit": "0.42.0",
+    "@moxxy/plugin-vault": "0.42.0",
+    "@moxxy/core": "0.42.0",
+    "@moxxy/sdk": "0.42.0",
+    "@moxxy/config": "0.42.0"
   },
   "devDependencies": {
-    "@types/node": "^22.10.0",
+    "@types/node": "^22.20.5",
     "@types/qrcode": "^1.5.5",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.11",
-    "@moxxy/tsconfig": "0.0.0",
-    "@moxxy/vitest-preset": "0.0.0"
+    "vitest": "^5.0.3",
+    "@moxxy/testing": "0.0.71",
+    "@moxxy/vitest-preset": "0.0.0",
+    "@moxxy/tsconfig": "0.0.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/src/channel/callback-handler.test.ts

@@ -1,13 +1,11 @@
 import { describe, expect, it, vi } from 'vitest';
 import type { Context } from 'grammy';
 
-// The manifest writers (setCategoryDefault/setProviderModel) can reject on
-// disk/permission/lock. Mock them so we can drive the failure path.
+// The manifest writer (setCategoryDefault) can reject on disk/permission/lock.
+// Mock it so we can drive the failure path.
 const setCategoryDefault = vi.fn(async () => {});
-const setProviderModel = vi.fn(async () => {});
 vi.mock('@moxxy/config', () => ({
   setCategoryDefault: (...a: unknown[]) => setCategoryDefault(...a),
-  setProviderModel: (...a: unknown[]) => setProviderModel(...a),
 }));
 
 import { handleCallback, type CallbackState, type CallbackCallbacks } from './callback-handler.js';
@@ -56,7 +54,7 @@ const makeState = (over: Partial<CallbackState> = {}): { state: CallbackState; r
 
 const cb: CallbackCallbacks = {
   setAwaitingApprovalText: () => undefined,
-  setActiveModelOverride: () => undefined,
+  model: { run: async () => '', choices: async () => ({ current: null, options: [] }) },
 };
 
 describe('handleCallback — pairing gate (A46)', () => {
@@ -99,7 +97,7 @@ describe('handleCallback — pairing gate (A46)', () => {
   });
 });
 
-describe('handleCallback — model/mode persistence failure (u110-5)', () => {
+describe('handleCallback — mode persistence failure (u110-5)', () => {
   const fakeSession = () =>
     ({
       readyProviders: new Set(['openai']),
@@ -142,24 +140,6 @@ describe('handleCallback — model/mode persistence failure (u110-5)', () => {
     pairing: { isAuthorized: () => true },
   });
 
-  it('does NOT claim "✓ switched" when the manifest write rejects (model)', async () => {
-    setCategoryDefault.mockReset();
-    setProviderModel.mockReset();
-    setCategoryDefault.mockRejectedValueOnce(new Error('EROFS'));
-    const { ctx, editMessageText, answerCallbackQuery } = ctxWithEdit('model:openai::gpt-x');
-    await handleCallback(ctx, stateFor(fakeSession()), cb);
-
-    expect(setCategoryDefault).toHaveBeenCalledWith('provider', 'openai');
-    // The success edit must NOT have fired; the failure surfaces via the toast.
-    const successEdits = editMessageText.mock.calls.filter((c) =>
-      String(c[0]).includes('✓ switched'),
-    );
-    expect(successEdits).toHaveLength(0);
-    expect(
-      answerCallbackQuery.mock.calls.some((c) => /failed/i.test(String((c[0] as { text?: string } | undefined)?.text))),
-    ).toBe(true);
-  });
-
   it('does NOT claim "✓ mode →" when the manifest write rejects (mode)', async () => {
     setCategoryDefault.mockReset();
     setCategoryDefault.mockRejectedValueOnce(new Error('EROFS'));
@@ -176,13 +156,4 @@ describe('handleCallback — model/mode persistence failure (u110-5)', () => {
     ).toBe(true);
   });
 
-  it('persists and confirms success when the manifest writes resolve (model)', async () => {
-    setCategoryDefault.mockReset();
-    setProviderModel.mockReset();
-    const { ctx, editMessageText } = ctxWithEdit('model:openai::gpt-x');
-    await handleCallback(ctx, stateFor(fakeSession()), cb);
-    expect(
-      editMessageText.mock.calls.some((c) => String(c[0]).includes('✓ switched')),
-    ).toBe(true);
-  });
 });

package/src/channel/callback-handler.ts

@@ -1,10 +1,12 @@
 import type { Bot, Context } from 'grammy';
-import { setCategoryDefault, setProviderModel } from '@moxxy/config';
+import { setCategoryDefault } from '@moxxy/config';
 import { isSelectableMode } from '@moxxy/sdk';
 import type { ClientSession as Session } from '@moxxy/sdk';
 import type { PermissionDecision } from '@moxxy/sdk';
 import type { TelegramPermissionResolver } from '../permission.js';
 import type { TelegramApprovalResolver } from '../approval.js';
+import type { TelegramModel } from './model.js';
+import { PROVIDER_PREFIX, modelScreen, providerScreen } from './model-picker.js';
 
 export interface AwaitingApprovalText {
   approvalId: string;
@@ -24,13 +26,15 @@ export interface CallbackState {
 export interface CallbackCallbacks {
   /** Latch an in-flight approval awaiting a text follow-up. */
   setAwaitingApprovalText(state: AwaitingApprovalText | null): void;
-  setActiveModelOverride(modelId: string): void;
+  /** This bot's own model (the `/model` picker). */
+  readonly model: Pick<TelegramModel, 'run' | 'choices'>;
 }
 
 /** Inline-keyboard callback router. Dispatches by prefix:
  *  - `perm:`   → permission resolver
  *  - `appr:`   → approval resolver
- *  - `model:`  → provider+model switch (with credential resolve)
+ *  - `mprov:`  → the model picker's screens (a provider's models, or back)
+ *  - `model:`  → this bot's model (`provider::model` or `default`)
  *  - `mode:`   → mode switch
  */
 export async function handleCallback(
@@ -65,8 +69,12 @@ export async function handleCallback(
     await handleAppr(ctx, data, state, cb);
     return;
   }
+  if (data.startsWith(PROVIDER_PREFIX)) {
+    await showPickerScreen(ctx, data.slice(PROVIDER_PREFIX.length), cb);
+    return;
+  }
   if (data.startsWith('model:')) {
-    await handleModel(ctx, data, state.session, cb);
+    await handleModel(ctx, data.slice('model:'.length), cb);
     return;
   }
   if (data.startsWith('mode:')) {
@@ -146,71 +154,32 @@ async function handleAppr(
   await ctx.answerCallbackQuery({ text: option.label });
 }
 
-async function handleModel(
-  ctx: Context,
-  data: string,
-  session: Session | null,
-  cb: CallbackCallbacks,
-): Promise<void> {
-  // 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;
+/** A provider button (its models) or `‹ Providers` (back), redrawn in place. */
+async function showPickerScreen(ctx: Context, provider: string, cb: CallbackCallbacks): Promise<void> {
+  const { current, options } = await cb.model.choices();
+  const screen = provider ? modelScreen(provider, current, options) : providerScreen(current, options);
+  await ctx.answerCallbackQuery();
+  try {
+    await ctx.editMessageText(screen.text, { parse_mode: 'HTML', reply_markup: screen.keyboard });
+  } catch {
+    /* ignore — an unchanged screen can't be re-sent */
   }
-  // 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<string>();
-  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 */
-      }
-    }
+}
+
+/** A tapped `/model` button: the same switch as `/model <value>`, answered in place. */
+async function handleModel(ctx: Context, value: string, cb: CallbackCallbacks): Promise<void> {
+  if (!value) {
+    await ctx.answerCallbackQuery({ text: 'invalid model selection' });
     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 */
-      }
+  const reply = await cb.model.run(value);
+  await ctx.answerCallbackQuery({ text: reply.slice(0, 190) });
+  if (ctx.callbackQuery?.message) {
+    try {
+      await ctx.editMessageText(reply);
+    } catch {
+      /* ignore */
     }
-  } catch (err) {
-    await ctx.answerCallbackQuery({
-      text: `failed: ${err instanceof Error ? err.message : String(err)}`,
-    });
   }
 }
 

package/src/channel/mirror.test.ts

@@ -0,0 +1,59 @@
+import { describe, expect, it } from 'vitest';
+import { TurnCoordinator } from '@moxxy/channel-kit';
+import type { MoxxyEvent, TurnId } from '@moxxy/sdk';
+import { createTelegramMirror, type TelegramSender } from './mirror.js';
+
+const prompt = (turnId: string, text: string) =>
+  ({ type: 'user_prompt', turnId: turnId as TurnId, text }) as unknown as MoxxyEvent;
+const reply = (turnId: string, content: string) =>
+  ({ type: 'assistant_message', turnId: turnId as TurnId, content }) as unknown as MoxxyEvent;
+
+function api() {
+  const sent: Array<{ chatId: number; text: string; parseMode?: string }> = [];
+  const sender: TelegramSender = {
+    sendMessage: async (chatId, text, opts) => {
+      sent.push({ chatId, text, ...(opts?.parse_mode ? { parseMode: opts.parse_mode } : {}) });
+      return undefined;
+    },
+  };
+  return { sent, sender };
+}
+
+describe('a message written in the app shows in the Telegram chat', () => {
+  it("posts the app's prompt and its reply to the paired chat, formatted like the bot's replies", async () => {
+    const { sent, sender } = api();
+    const { mirror } = createTelegramMirror({ turns: new TurnCoordinator(), api: () => sender, pairedChat: () => 42 });
+
+    mirror.accept(prompt('t1', 'what is on my calendar?'));
+    mirror.accept(reply('t1', 'Two **meetings**.'));
+    await mirror.idle();
+
+    expect(sent).toEqual([
+      { chatId: 42, text: '<i>typed in moxxy:</i> what is on my calendar?', parseMode: 'HTML' },
+      { chatId: 42, text: 'Two <b>meetings</b>.', parseMode: 'HTML' },
+    ]);
+  });
+
+  it('goes to the chat the owner last wrote from', async () => {
+    const { sent, sender } = api();
+    const { mirror, target } = createTelegramMirror({ turns: new TurnCoordinator(), api: () => sender, pairedChat: () => 42 });
+    target.remember(7);
+
+    mirror.accept(reply('t1', 'hello'));
+    await mirror.idle();
+
+    expect(sent.map((m) => m.chatId)).toEqual([7]);
+  });
+
+  it('stays quiet while no chat is paired or the bot is not running', async () => {
+    const { sent, sender } = api();
+    const unpaired = createTelegramMirror({ turns: new TurnCoordinator(), api: () => sender, pairedChat: () => null });
+    const stopped = createTelegramMirror({ turns: new TurnCoordinator(), api: () => null, pairedChat: () => 42 });
+
+    unpaired.mirror.accept(reply('t1', 'hello'));
+    stopped.mirror.accept(reply('t2', 'hello'));
+    await Promise.all([unpaired.mirror.idle(), stopped.mirror.idle()]);
+
+    expect(sent).toEqual([]);
+  });
+});

package/src/channel/mirror.ts

@@ -0,0 +1,36 @@
+import { ForeignTurnMirror, MirrorTarget, type TurnCoordinator } from '@moxxy/channel-kit';
+import { sendMarkdown, type TelegramSender } from './send-rich.js';
+
+export type { TelegramSender } from './send-rich.js';
+
+export interface TelegramMirrorOptions {
+  readonly turns: Pick<TurnCoordinator, 'mirrorPrompt' | 'mirrorText'>;
+  /** The running bot's API, or null while it is stopped. */
+  readonly api: () => TelegramSender | null;
+  /** The paired chat, or null while unpaired. */
+  readonly pairedChat: () => number | null;
+  readonly logger?: { warn(msg: string, meta?: Record<string, unknown>): void };
+}
+
+/**
+ * Turns another surface ran on the bot's session (the desktop's chat with this
+ * bot) shown in Telegram: the prompt written in the app, then its reply — into
+ * the chat the owner last wrote from, else the paired chat.
+ */
+export function createTelegramMirror(opts: TelegramMirrorOptions): {
+  readonly mirror: ForeignTurnMirror<number>;
+  readonly target: MirrorTarget<number>;
+} {
+  const target = new MirrorTarget<number>(async () => opts.pairedChat());
+  const mirror = new ForeignTurnMirror<number>({
+    turns: opts.turns,
+    target,
+    post: async (chatId, text) => {
+      const api = opts.api();
+      if (api) await sendMarkdown(api, chatId, text);
+    },
+    formatPrompt: (prompt) => `_typed in moxxy:_ ${prompt}`,
+    onError: (err) => opts.logger?.warn('telegram mirror failed', { err: String(err) }),
+  });
+  return { mirror, target };
+}

package/src/channel/model-picker.ts

@@ -0,0 +1,75 @@
+import { InlineKeyboard } from 'grammy';
+import { formatModelChoice, type ModelChoice, type ModelOption } from '@moxxy/channel-kit';
+import { escapeHtml } from '../format.js';
+
+/**
+ * The `/model` picker as two screens in one message: the providers, then the
+ * models of the one tapped (with a way back). The bot's current choice is the
+ * green button.
+ */
+export interface PickerScreen {
+  /** HTML (`parse_mode: 'HTML'`). */
+  readonly text: string;
+  readonly keyboard: InlineKeyboard;
+}
+
+/** Callback data prefix of a provider button; empty provider = back to the list. */
+export const PROVIDER_PREFIX = 'mprov:';
+/** Telegram rejects a button whose callback data exceeds 64 bytes. */
+const CALLBACK_DATA_MAX_BYTES = 64;
+/** A provider's models shown at once; the rest are reachable with /model <text>. */
+const MODELS_CAP = 30;
+
+const fits = (data: string) => Buffer.byteLength(data) <= CALLBACK_DATA_MAX_BYTES;
+
+function nowLine(current: ModelChoice | null): string {
+  return current ? `Now: <code>${escapeHtml(formatModelChoice(current))}</code>` : 'Now: the default model';
+}
+
+export function providerScreen(current: ModelChoice | null, options: ReadonlyArray<ModelOption>): PickerScreen {
+  const keyboard = new InlineKeyboard().text(current ? 'Default model' : '✓ Default model', 'model:default');
+  if (!current) keyboard.success();
+  keyboard.row();
+  const providers = [...new Set(options.map((o) => o.provider))];
+  providers.forEach((provider, index) => {
+    const models = options.filter((o) => o.provider === provider);
+    const connected = models.some((o) => o.connected);
+    const isCurrent = current?.provider === provider;
+    const label = `${isCurrent ? '✓ ' : ''}${provider} · ${
+      connected ? `${models.length} ${models.length === 1 ? 'model' : 'models'}` : 'not connected'
+    }`;
+    if (!fits(`${PROVIDER_PREFIX}${provider}`)) return;
+    keyboard.text(label, `${PROVIDER_PREFIX}${provider}`);
+    if (isCurrent) keyboard.success();
+    if (index % 2 === 1) keyboard.row();
+  });
+  return {
+    text: `<b>Model for this bot</b>\n${nowLine(current)}\n\nPick a provider:`,
+    keyboard,
+  };
+}
+
+export function modelScreen(
+  provider: string,
+  current: ModelChoice | null,
+  options: ReadonlyArray<ModelOption>,
+): PickerScreen {
+  const models = options.filter((o) => o.provider === provider && fits(`model:${formatModelChoice(o)}`));
+  const shown = models.slice(0, MODELS_CAP);
+  const keyboard = new InlineKeyboard();
+  for (const o of shown) {
+    const isCurrent = current != null && formatModelChoice(current) === formatModelChoice(o);
+    keyboard.text(`${isCurrent ? '✓ ' : ''}${o.model}`, `model:${formatModelChoice(o)}`);
+    if (isCurrent) keyboard.success();
+    keyboard.row();
+  }
+  keyboard.text('‹ Providers', PROVIDER_PREFIX);
+  const connected = models.some((o) => o.connected);
+  const more = models.length - shown.length;
+  return {
+    text:
+      `<b>${escapeHtml(provider)}</b>${connected ? '' : ' · not connected'}\n${nowLine(current)}\n\nPick a model:` +
+      (more > 0 ? `\n<i>${more} more — use /model &lt;text&gt;</i>` : ''),
+    keyboard,
+  };
+}