@moxxy/plugin-telegram 0.27.0

package/dist/channel/slash-handler.js

@@ -0,0 +1,214 @@
+import { InlineKeyboard } from 'grammy';
+import { isSelectableMode } from '@moxxy/sdk';
+import { resolveVoiceToggle } from '@moxxy/channel-kit';
+/**
+ * Install guidance shown when enabling `/voice` with no active synthesizer —
+ * mirrors the voice-handler's transcriber guidance wording, pointing at the TTS
+ * plugin instead of the STT one.
+ */
+export const VOICE_NO_SYNTH_HINT = 'No text-to-speech backend is configured yet, so replies stay text-only. Install one with `moxxy plugins install tts-openai` and run `moxxy login openai` (or set OPENAI_API_KEY) to enable spoken replies.';
+/**
+ * Slash-command dispatcher for the Telegram channel.
+ *
+ * First tries the shared `session.commands` registry — this is where
+ * the universal commands (/info, /clear, /new, /exit, /help) live, so
+ * Telegram gets them for free alongside any plugin-contributed
+ * commands without needing a switch case here.
+ *
+ * Falls through to channel-local cases for Telegram-specific UI
+ * (model/loop pickers as inline keyboards, /yolo toggle, /tools and
+ * /skills as text dumps).
+ */
+export async function runSlash(ctx, text, state, cb) {
+    const session = state.session;
+    if (!session)
+        return;
+    const [head, ...rest] = text.split(/\s+/);
+    const name = head.slice(1);
+    const args = rest.join(' ');
+    // 1) Shared registry dispatch.
+    const registered = session.commands.get(name);
+    if (registered) {
+        try {
+            const result = await registered.handler({
+                channel: 'telegram',
+                sessionId: session.id,
+                args,
+                session,
+            });
+            if (result.kind === 'text') {
+                await ctx.reply(result.text);
+            }
+            else if (result.kind === 'session-action') {
+                await cb.performSessionAction(ctx, result.action, result.notice);
+            }
+            else if (result.kind === 'error') {
+                await ctx.reply(`error: ${result.message}`);
+            }
+        }
+        catch (err) {
+            await ctx.reply(`command /${name} failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return;
+    }
+    // 2) Channel-local cases.
+    switch (head) {
+        case '/model':
+            await renderModelPicker(ctx, session, state, args);
+            return;
+        case '/mode':
+            await renderModePicker(ctx, session);
+            return;
+        case '/yolo': {
+            const enabled = cb.toggleYolo();
+            await ctx.reply(enabled
+                ? '⚠ yolo mode ON — tool calls auto-approved for the rest of this session'
+                : 'yolo mode OFF — tool prompts will resume');
+            return;
+        }
+        case '/voice': {
+            const result = resolveVoiceToggle({
+                arg: args,
+                enabled: state.voiceReplies,
+                hasSynthesizer: session.synthesizers.tryGetActive() != null,
+                delivery: 'a voice note',
+                noSynthesizerHint: VOICE_NO_SYNTH_HINT,
+            });
+            if (result.persist)
+                await cb.setVoiceReplies(result.enabled);
+            await ctx.reply(result.reply);
+            return;
+        }
+        case '/tools': {
+            const list = session.tools
+                .list()
+                .map((t) => `${t.name} — ${t.description}`)
+                .join('\n');
+            await ctx.reply(list || '(no tools registered)');
+            return;
+        }
+        case '/skills': {
+            const list = session.skills
+                .list()
+                .map((s) => {
+                const triggers = s.frontmatter.triggers ?? [];
+                const triggerLine = triggers.length
+                    ? `\n   triggers: ${triggers.map((t) => `"${t}"`).join(', ')}`
+                    : '';
+                return `${s.frontmatter.name} — ${s.frontmatter.description}${triggerLine}`;
+            })
+                .join('\n');
+            await ctx.reply(list || '(no skills discovered)');
+            return;
+        }
+        default:
+            await ctx.reply(`unknown command: ${head} (try /help)`);
+    }
+}
+/** Telegram inline keyboards get unwieldy past this many rows; cap the picker. */
+const MODEL_PICKER_CAP = 30;
+async function renderModelPicker(ctx, session, state, filter = '') {
+    const providers = session.providers.list();
+    if (providers.length === 0) {
+        await ctx.reply('no providers registered');
+        return;
+    }
+    const keyboard = new InlineKeyboard();
+    const providerName = session.providers.getActiveName() ?? '';
+    const activeModel = state.activeModelOverride ?? state.model ?? '';
+    // Same boot-time readiness set the TUI uses to flag unconfigured
+    // providers — set by `@moxxy/cli` at setup time. Providers that
+    // failed credential resolution get a "(not connected)" suffix
+    // and a tap on them surfaces the right setup command instead of
+    // a no-op switch.
+    const ready = session.readyProviders ?? new Set();
+    // `/model <substring>` narrows the list so a model that sorts past the
+    // keyboard cap is still reachable from chat (the cap below would otherwise
+    // silently hide it with no fallback).
+    const needle = filter.trim().toLowerCase();
+    // Flatten so we can both apply the substring filter and report how many the
+    // cap hides (vs. how many the filter excluded).
+    const all = providers.flatMap((p) => p.models.map((m) => ({ provider: p.name, model: m.id })));
+    const matched = needle
+        ? all.filter((e) => `${e.provider}::${e.model}`.toLowerCase().includes(needle))
+        : all;
+    if (matched.length === 0) {
+        await ctx.reply(`no model matches "${filter.trim()}" — try /model with no argument.`);
+        return;
+    }
+    const shown = matched.slice(0, MODEL_PICKER_CAP);
+    for (const e of shown) {
+        const isCurrent = providerName === e.provider && activeModel === e.model;
+        const connected = ready.has(e.provider);
+        const label = `${isCurrent ? '• ' : ''}${e.provider}: ${e.model}` +
+            (connected ? '' : ' (not connected)');
+        keyboard.text(label, `model:${e.provider}::${e.model}`).row();
+    }
+    const hidden = matched.length - shown.length;
+    const prompt = hidden > 0
+        ? `Pick a model (${hidden} more not shown — narrow with /model <text>):`
+        : 'Pick a model:';
+    await ctx.reply(prompt, { reply_markup: keyboard });
+}
+async function renderModePicker(ctx, session) {
+    // Special modes (e.g. collaborative, entered via /collab) are hidden from the
+    // picker the same way they are in the TUI. See ModeDef.special.
+    const modes = session.modes.list().filter(isSelectableMode);
+    if (modes.length === 0) {
+        await ctx.reply('no modes registered');
+        return;
+    }
+    const keyboard = new InlineKeyboard();
+    const activeModeName = (() => {
+        try {
+            return session.modes.getActive().name;
+        }
+        catch {
+            return '';
+        }
+    })();
+    for (const s of modes) {
+        const isCurrent = s.name === activeModeName;
+        keyboard.text(`${isCurrent ? '• ' : ''}${s.name}`, `mode:${s.name}`).row();
+    }
+    await ctx.reply('Pick a mode:', { reply_markup: keyboard });
+}
+/**
+ * Push the union of registry commands + Telegram-local commands to
+ * Telegram so they appear in the chat's command menu (the "/" picker
+ * the official client shows). Best-effort: a network failure here
+ * doesn't block channel startup, the commands still work via text.
+ */
+export async function publishBotCommands(bot, session, logger) {
+    if (!session || !bot)
+        return;
+    const LOCAL = [
+        { command: 'model', description: 'Switch provider + model (inline keyboard)' },
+        { command: 'mode', description: 'Switch mode' },
+        { command: 'yolo', description: 'Toggle auto-approve mode' },
+        { command: 'voice', description: 'Toggle spoken voice replies' },
+        { command: 'tools', description: 'List the tools the active session can call' },
+        { command: 'skills', description: 'List the discovered skills' },
+        { command: 'cancel', description: 'Abort the current turn' },
+    ];
+    const shared = session.commands
+        .listForChannel('telegram')
+        .map((c) => ({ command: c.name, description: c.description }));
+    const seen = new Set(shared.map((c) => c.command));
+    const merged = [...shared, ...LOCAL.filter((c) => !seen.has(c.command))]
+        .sort((a, b) => a.command.localeCompare(b.command))
+        // Telegram caps descriptions at 256 chars and rejects empties.
+        .map((c) => ({
+        command: c.command,
+        description: (c.description || c.command).slice(0, 256),
+    }));
+    try {
+        await bot.api.setMyCommands(merged);
+    }
+    catch (err) {
+        logger?.warn?.('telegram setMyCommands failed', {
+            err: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=slash-handler.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { Context } from 'grammy';
+import type { ClientSession as Session } from '@moxxy/sdk';
+import type { TelegramApprovalResolver } from '../approval.js';
+import type { TelegramPermissionResolver } from '../permission.js';
+import type { ChannelHandle } from '@moxxy/sdk';
+import type { FramePump } from './frame-pump.js';
+import type { AwaitingApprovalText } from './callback-handler.js';
+import type { PairingHandler } from './pairing-handler.js';
+export interface TextHandlerState {
+    readonly session: Session | null;
+    readonly model: string | undefined;
+    readonly activeModelOverride: string | null;
+    readonly yolo: boolean;
+    readonly voiceReplies: boolean;
+    readonly busy: boolean;
+    readonly turnController: AbortController | null;
+    readonly awaitingApprovalText: AwaitingApprovalText | null;
+    readonly handle: ChannelHandle | null;
+}
+export interface TextHandlerDeps {
+    readonly pairing: PairingHandler;
+    readonly approvalResolver: TelegramApprovalResolver;
+    readonly permissionResolver: TelegramPermissionResolver;
+    readonly framePump: FramePump;
+}
+export interface TextHandlerCallbacks {
+    readonly setAwaitingApprovalText: (state: AwaitingApprovalText | null) => void;
+    readonly toggleYolo: () => boolean;
+    readonly setYolo: (value: boolean) => void;
+    readonly setVoiceReplies: (on: boolean) => Promise<void>;
+    readonly runUserTurn: (ctx: Context, chatId: number, text: string) => Promise<void>;
+    /** Host-issued pairing fallback: try to pair an unauthorized chat whose message
+     *  is the 6-digit code. Returns true when handled (so we skip the generic
+     *  "not paired" reply). See {@link TelegramChannel.tryHostPair}. */
+    readonly tryHostPair: (chatId: number, text: string) => Promise<boolean>;
+}
+/**
+ * Top-level dispatch for inbound text messages: authorization gate,
+ * awaiting-approval-text capture, /cancel, slash routing, and finally
+ * the user-turn path.
+ */
+export declare function handleTextMessage(ctx: Context, state: TextHandlerState, deps: TextHandlerDeps, cb: TextHandlerCallbacks): Promise<void>;
+//# sourceMappingURL=text-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-handler.d.ts","sourceRoot":"","sources":["../../src/channel/text-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,eAAe,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,wBAAwB,CAAC;IACpD,QAAQ,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,uBAAuB,EAAE,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/E,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF;;wEAEoE;IACpE,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,oBAAoB,GACvB,OAAO,CAAC,IAAI,CAAC,CAqEf"}

package/dist/channel/text-handler.js

@@ -0,0 +1,116 @@
+import { runSlash } from './slash-handler.js';
+/**
+ * Top-level dispatch for inbound text messages: authorization gate,
+ * awaiting-approval-text capture, /cancel, slash routing, and finally
+ * the user-turn path.
+ */
+export async function handleTextMessage(ctx, state, deps, cb) {
+    const chatId = ctx.chat?.id;
+    const text = ctx.message?.text;
+    if (!chatId || !text)
+        return;
+    if (!deps.pairing.isAuthorized(chatId)) {
+        // Host-issued pairing: a bare 6-digit message from an unpaired chat may be
+        // the code presented back to us. If so, pair and stop here.
+        if (await cb.tryHostPair(chatId, text))
+            return;
+        await ctx.reply('This bot is paired with a different chat (or not paired yet). Run `moxxy telegram pair` to (re-)pair.');
+        return;
+    }
+    // Capture awaiting-text BEFORE the busy guard so the user can answer
+    // an approval text prompt even while the strategy is technically
+    // still mid-turn (it's pending on us).
+    if (state.awaitingApprovalText) {
+        const { approvalId, optionId } = state.awaitingApprovalText;
+        cb.setAwaitingApprovalText(null);
+        const handled = deps.approvalResolver.resolvePendingWithText(approvalId, optionId, text);
+        if (handled) {
+            await ctx.reply(`✓ submitted (${optionId})`);
+        }
+        else {
+            await ctx.reply('that approval is no longer pending');
+        }
+        return;
+    }
+    // /cancel works even while busy; everything else routes through
+    // runSlash or the user-turn path.
+    if (text === '/cancel') {
+        if (state.turnController && !state.turnController.signal.aborted) {
+            state.turnController.abort('user cancel');
+            await ctx.reply('cancelling current turn…');
+        }
+        else {
+            await ctx.reply('nothing to cancel.');
+        }
+        return;
+    }
+    if (text.startsWith('/')) {
+        await runSlash(ctx, text, {
+            session: state.session,
+            model: state.model,
+            activeModelOverride: state.activeModelOverride,
+            yolo: state.yolo,
+            voiceReplies: state.voiceReplies,
+        }, {
+            toggleYolo: cb.toggleYolo,
+            setVoiceReplies: cb.setVoiceReplies,
+            performSessionAction: (c, action, notice) => performSessionAction(c, action, notice, state, deps, cb),
+        });
+        return;
+    }
+    if (state.busy) {
+        await ctx.reply('I am still working on the previous prompt. Send /cancel to abort it.');
+        return;
+    }
+    await cb.runUserTurn(ctx, chatId, text);
+}
+/**
+ * Channel-side handler for `session-action` outputs from registered
+ * commands. The TUI does the same thing; both channels translate the
+ * action into their own UI semantics (Telegram = reply text, Ink =
+ * setState + exit).
+ */
+async function performSessionAction(ctx, action, notice, state, deps, cb) {
+    if (!state.session)
+        return;
+    if (action === 'exit') {
+        await ctx.reply(notice ?? 'closing Telegram channel');
+        if (state.handle)
+            await state.handle.stop('user /exit');
+        return;
+    }
+    if (action === 'clear') {
+        deps.framePump.resetRenderer();
+        if (notice)
+            await ctx.reply(`✓ ${notice}`);
+        return;
+    }
+    if (action === 'new') {
+        if (state.turnController && !state.turnController.signal.aborted) {
+            state.turnController.abort('user reset');
+        }
+        deps.framePump.resetRenderer();
+        cb.setYolo(false);
+        cb.setAwaitingApprovalText(null);
+        deps.approvalResolver.abortAll('session reset');
+        deps.permissionResolver.abortAll('session reset');
+        // Wipe the history at its source. On a RemoteSession `reset()` asks the
+        // runner to clear its authoritative log (and persisted JSONL) and
+        // re-sync every attached mirror; on a local Session it clears the
+        // EventLog + truncates the sidecar. A mirror-only `log.clear()` would
+        // be cosmetic AND desync this client, so only claim success when the
+        // reset actually happened.
+        try {
+            if (typeof state.session.reset === 'function')
+                await state.session.reset();
+            else
+                state.session.log.clear();
+        }
+        catch (err) {
+            await ctx.reply(`⚠ /new failed: ${err instanceof Error ? err.message : String(err)} — history NOT cleared`);
+            return;
+        }
+        await ctx.reply(`✓ ${notice ?? 'new session — conversation history cleared'}`);
+    }
+}
+//# sourceMappingURL=text-handler.js.map

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

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

package/dist/channel/turn-runner.d.ts

@@ -0,0 +1,40 @@
+import type { Bot, Context } from 'grammy';
+import type { newTurnId } from '@moxxy/core';
+import type { ClientSession as Session } from '@moxxy/sdk';
+import type { FramePump } from './frame-pump.js';
+import type { TypingIndicator } from './typing-indicator.js';
+export interface TurnRunnerLogger {
+    warn(msg: string, meta?: Record<string, unknown>): void;
+}
+export interface TurnRunnerDeps {
+    readonly session: Session;
+    readonly bot: Bot | null;
+    readonly framePump: FramePump;
+    readonly typing: TypingIndicator;
+    readonly logger?: TurnRunnerLogger;
+    /**
+     * Called once with the FINAL assistant text after it has been flushed to the
+     * chat (so the text reply always lands first). Backs the optional voice
+     * reply. Best-effort — its failure is logged and never breaks the text turn.
+     */
+    readonly onFinalReply?: (text: string) => Promise<void>;
+}
+export interface TurnRunnerOptions {
+    readonly chatId: number;
+    readonly text: string;
+    readonly model: string | undefined;
+    readonly controller: AbortController;
+    /** turnId for this turn. The channel mints it so it can also record it as an
+     *  own-turn id (mirrorForeignTurn filters on those). */
+    readonly turnId: ReturnType<typeof newTurnId>;
+}
+/**
+ * Drive a single user turn end-to-end: kick off typing, subscribe the
+ * frame pump to session events, run the turn through `runTurn`, flush
+ * the final frame, and unwind state in `finally`.
+ *
+ * The controller is owned by the caller so /cancel can abort just this
+ * turn without poisoning the session-level signal.
+ */
+export declare function runUserTurn(ctx: Context, deps: TurnRunnerDeps, opts: TurnRunnerOptions): Promise<void>;
+//# sourceMappingURL=turn-runner.d.ts.map

package/dist/channel/turn-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-runner.d.ts","sourceRoot":"","sources":["../../src/channel/turn-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC;4DACwD;IACxD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;CAC/C;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CAsDf"}

package/dist/channel/turn-runner.js

@@ -0,0 +1,67 @@
+import { driveTurn, subscribeTurn } from '@moxxy/channel-kit';
+/**
+ * Drive a single user turn end-to-end: kick off typing, subscribe the
+ * frame pump to session events, run the turn through `runTurn`, flush
+ * the final frame, and unwind state in `finally`.
+ *
+ * The controller is owned by the caller so /cancel can abort just this
+ * turn without poisoning the session-level signal.
+ */
+export async function runUserTurn(ctx, deps, opts) {
+    const { session, bot, framePump, typing, logger, onFinalReply } = deps;
+    const { chatId, text, model, controller, turnId } = opts;
+    framePump.beginTurn(chatId);
+    // Kick off "typing…" right away so the user gets immediate feedback.
+    // Don't send an ellipsis placeholder message — the typing indicator
+    // IS the placeholder. The frame pump lazily sends the first real
+    // frame when there's content to display, then edits that message for
+    // every subsequent frame.
+    typing.start(bot, chatId);
+    // turnId is minted by the caller (the channel records it as an own-turn id).
+    // The frame-pump subscriber filters by it: `session.log` fans out to every
+    // listener; without this a concurrent turn driven by another channel
+    // (HTTP/runner) on the same Session would render into THIS chat. (AGENTS.md:
+    // filter event-log subscribers by turnId.)
+    const unsubscribe = subscribeTurn(session, turnId, (event) => {
+        const frame = framePump.renderState.accept(event);
+        if (frame.hasUpdate)
+            framePump.scheduleEdit();
+    });
+    try {
+        await driveTurn(session, { turnId, prompt: text, model, signal: controller.signal });
+        await framePump.flush(true);
+        // The text reply is now out. Speak the final assistant body if a voice
+        // reply is wired — isolated so a synth/transcode/transport failure can
+        // never break (or re-report) the already-delivered text turn.
+        if (onFinalReply) {
+            const finalText = framePump.renderState.snapshot().body;
+            if (finalText.trim()) {
+                try {
+                    await onFinalReply(finalText);
+                }
+                catch (err) {
+                    logger?.warn('telegram voice reply hook failed', {
+                        err: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+        }
+    }
+    catch (err) {
+        logger?.warn('telegram turn failed', {
+            err: err instanceof Error ? err.message : String(err),
+        });
+        try {
+            await ctx.reply(`Turn failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    finally {
+        typing.stop();
+        unsubscribe();
+        framePump.endTurn();
+    }
+}
+//# sourceMappingURL=turn-runner.js.map

package/dist/channel/turn-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-runner.js","sourceRoot":"","sources":["../../src/channel/turn-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAgC9D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAY,EACZ,IAAoB,EACpB,IAAuB;IAEvB,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACvE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEzD,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B,qEAAqE;IACrE,oEAAoE;IACpE,iEAAiE;IACjE,qEAAqE;IACrE,0BAA0B;IAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAE1B,6EAA6E;IAC7E,2EAA2E;IAC3E,qEAAqE;IACrE,6EAA6E;IAC7E,2CAA2C;IAC3C,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;QAC3D,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,SAAS;YAAE,SAAS,CAAC,YAAY,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACrF,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,uEAAuE;QACvE,uEAAuE;QACvE,8DAA8D;QAC9D,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC;YACxD,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;gBACrB,IAAI,CAAC;oBACH,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC;gBAChC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,EAAE,IAAI,CAAC,kCAAkC,EAAE;wBAC/C,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACtD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,IAAI,CAAC,sBAAsB,EAAE;YACnC,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACtD,CAAC,CAAC;QACH,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,KAAK,CAAC,gBAAgB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtF,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;QACd,SAAS,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/channel/typing-indicator.d.ts

@@ -0,0 +1,14 @@
+import type { Bot } from 'grammy';
+/**
+ * Show a "typing…" indicator in the chat for the lifetime of a turn.
+ * Telegram clears the indicator ~5s after the last sendChatAction, so
+ * we re-fire every 4s. Best-effort — a single failure shouldn't crash
+ * the turn (we keep the interval going so transient network blips
+ * recover on the next tick).
+ */
+export declare class TypingIndicator {
+    private timer;
+    start(bot: Bot | null, chatId: number): void;
+    stop(): void;
+}
+//# sourceMappingURL=typing-indicator.d.ts.map

package/dist/channel/typing-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-indicator.d.ts","sourceRoot":"","sources":["../../src/channel/typing-indicator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAElC;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAA+C;IAE5D,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAY5C,IAAI,IAAI,IAAI;CAMb"}

package/dist/channel/typing-indicator.js

@@ -0,0 +1,29 @@
+/**
+ * Show a "typing…" indicator in the chat for the lifetime of a turn.
+ * Telegram clears the indicator ~5s after the last sendChatAction, so
+ * we re-fire every 4s. Best-effort — a single failure shouldn't crash
+ * the turn (we keep the interval going so transient network blips
+ * recover on the next tick).
+ */
+export class TypingIndicator {
+    timer = null;
+    start(bot, chatId) {
+        if (!bot)
+            return;
+        this.stop();
+        const fire = () => {
+            bot.api.sendChatAction(chatId, 'typing').catch(() => {
+                /* best-effort */
+            });
+        };
+        fire();
+        this.timer = setInterval(fire, 4_000);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+}
+//# sourceMappingURL=typing-indicator.js.map

package/dist/channel/typing-indicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-indicator.js","sourceRoot":"","sources":["../../src/channel/typing-indicator.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAClB,KAAK,GAA0C,IAAI,CAAC;IAE5D,KAAK,CAAC,GAAe,EAAE,MAAc;QACnC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,GAAS,EAAE;YACtB,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBAClD,iBAAiB;YACnB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QACF,IAAI,EAAE,CAAC;QACP,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,42 @@
+import type { Context } from 'grammy';
+import type { ClientSession as Session } from '@moxxy/sdk';
+import type { PairingHandler } from './pairing-handler.js';
+export interface VoiceHandlerState {
+    readonly session: Session | null;
+    readonly busy: boolean;
+}
+export interface VoiceHandlerDeps {
+    readonly pairing: PairingHandler;
+    /** Bot token, used to build the Telegram file-download URL. */
+    readonly token: string;
+    readonly logger?: {
+        warn(msg: string, meta?: Record<string, unknown>): void;
+    };
+}
+export interface VoiceHandlerCallbacks {
+    readonly runUserTurn: (ctx: Context, chatId: number, text: string) => Promise<void>;
+    /** Override the network fetch for tests. Defaults to global `fetch`. */
+    readonly fetchAudio?: (url: string, init?: {
+        signal?: AbortSignal;
+    }) => Promise<{
+        ok: boolean;
+        /** HTTP status — surfaced in the download-failure log for diagnostics. */
+        status?: number;
+        statusText?: string;
+        /** Content-Length header, when present — used to reject oversized bodies pre-buffer. */
+        headers?: {
+            get(name: string): string | null;
+        };
+        arrayBuffer(): Promise<ArrayBuffer>;
+    }>;
+}
+/**
+ * Handle inbound voice notes and uploaded audio files. Authorization
+ * gate matches the text path. If no Transcriber is registered on the
+ * session, reply with a one-time guidance message instead of silently
+ * swallowing the audio. Otherwise: download via Bot-API file URL,
+ * transcribe through the active Transcriber, echo a short "heard:"
+ * confirmation, then run a normal user turn with the transcript.
+ */
+export declare function handleVoiceMessage(ctx: Context, state: VoiceHandlerState, deps: VoiceHandlerDeps, cb: VoiceHandlerCallbacks): Promise<void>;
+//# sourceMappingURL=voice-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-handler.d.ts","sourceRoot":"","sources":["../../src/channel/voice-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAkB3D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,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,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,CACpB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAC5B,OAAO,CAAC;QACX,EAAE,EAAE,OAAO,CAAC;QACZ,0EAA0E;QAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,wFAAwF;QACxF,OAAO,CAAC,EAAE;YAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC;QAC/C,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;KACrC,CAAC,CAAC;CACJ;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,qBAAqB,GACxB,OAAO,CAAC,IAAI,CAAC,CAuIf"}