@adriangalilea/utils 0.5.0 → 0.7.0

package/dist/bot/coalesce.js

@@ -0,0 +1,155 @@
+/**
+ * Coalesce client-split inbound messages.
+ *
+ * Telegram clients (Desktop / iOS / web) split a single message > 4096
+ * chars into multiple `sendMessage` calls before they ever reach the
+ * server. The bot receives them as **separate** `message` updates with
+ * no marker linking them. This middleware joins them back into one
+ * event so your handlers see the full text.
+ *
+ *     user pastes 8000 chars → client splits in 2 → bot gets 2 updates
+ *                                                            │
+ *                                                            ▼
+ *                                                 coalesce middleware
+ *                                                            │
+ *                                                     hold + join
+ *                                                            │
+ *                                                            ▼
+ *                                              handler sees ONE event
+ *                                              with full ctx.text
+ *
+ * ## Detection rule (strict)
+ *
+ * We coalesce only when ALL hold. Otherwise fragments pass through
+ * as separate events — false negatives are preferred over silently
+ * merging unrelated messages.
+ *
+ *   1. Same chat.
+ *   2. Same user (override with `acrossUsers: true`).
+ *   3. Leading fragment length ≥ `minLeadingLength` (a current
+ *      guess — see the type definition for the default and the
+ *      reasoning). Short messages never start a real client split.
+ *   4. Each subsequent fragment within `windowMs` of the previous.
+ *
+ * ## Known caveats
+ *
+ *   - `ctx.entities` is cleared on coalesced messages — per-fragment
+ *     entity offsets would point at the wrong characters once joined.
+ *     Plain-text consumers don't care; formatted-input consumers
+ *     should disable this plugin.
+ *   - In-memory buffer; doesn't survive bot restart mid-burst.
+ *
+ * Peer deps: `gramio`.
+ *
+ * @example
+ * import { Bot } from 'gramio'
+ * import { coalesceLongMessages } from '@adriangalilea/utils/bot/coalesce'
+ *
+ * const bot = new Bot(process.env.BOT_TOKEN!)
+ *   .extend(coalesceLongMessages())     // ← before .on / .command handlers
+ *   .on('message', (ctx) => {
+ *     // ctx.text is the full pasted text even if Telegram split it
+ *     return ctx.send(`got ${ctx.text?.length} chars`)
+ *   })
+ *
+ * @example  Power-user escape hatch
+ *
+ * import { isCoalescent } from '@adriangalilea/utils/bot/coalesce'
+ *
+ * if (isCoalescent(prev, curr)) {
+ *   // do your own thing
+ * }
+ */
+import { Plugin } from 'gramio';
+// Current guess. Real Telegram clients split at natural boundaries
+// (newline / paragraph / sentence) before the 4096 cap, but we don't
+// yet have a solid dataset of where they actually land. Adjust as
+// real-world data comes in. Single source of truth — both
+// `isCoalescent` and the middleware read from here.
+const DEFAULT_MIN_LEADING_LENGTH = 3750;
+const DEFAULT_WINDOW_MS = 500;
+const DEFAULT_ACROSS_USERS = false;
+export const isCoalescent = (prev, curr, opts = {}) => {
+    const minLeadingLength = opts.minLeadingLength ?? DEFAULT_MIN_LEADING_LENGTH;
+    const windowMs = opts.windowMs ?? DEFAULT_WINDOW_MS;
+    const acrossUsers = opts.acrossUsers ?? DEFAULT_ACROSS_USERS;
+    if (prev.chatId !== curr.chatId)
+        return false;
+    if (!acrossUsers && prev.userId !== curr.userId)
+        return false;
+    if (prev.text.length < minLeadingLength)
+        return false;
+    if (curr.dateMs - prev.dateMs > windowMs)
+        return false;
+    return true;
+};
+export const coalesceLongMessages = (opts = {}) => {
+    const minLeadingLength = opts.minLeadingLength ?? DEFAULT_MIN_LEADING_LENGTH;
+    const windowMs = opts.windowMs ?? DEFAULT_WINDOW_MS;
+    const acrossUsers = opts.acrossUsers ?? DEFAULT_ACROSS_USERS;
+    const log = opts.log ?? false;
+    const dbg = (msg) => {
+        if (log)
+            console.error(`[coalesce] ${msg}`);
+    };
+    // Keyed per `<chatId>:<userId>` (or `<chatId>` when acrossUsers).
+    // Buffer lives only as long as fragments are still arriving — gets
+    // deleted on flush.
+    const buffers = new Map();
+    const keyFor = (chatId, userId) => acrossUsers ? `${chatId}` : `${chatId}:${userId}`;
+    return new Plugin('@adriangalilea/utils/bot/coalesce').use(async (ctx, next) => {
+        if (!ctx.is('message') || ctx.text === undefined)
+            return next();
+        const key = keyFor(ctx.chat.id, ctx.from.id);
+        const existing = buffers.get(key);
+        if (existing) {
+            // Continuation fragment — fold into the held buffer and reset
+            // the timer. No length check on continuations: once a buffer
+            // is open, anything within the window joins (the tail of a
+            // split is typically short). We don't call next(); this update
+            // is swallowed. The first fragment held by `existing.flush`
+            // will eventually fire next() with the combined text.
+            dbg(`join key=${key} len=${ctx.text.length} buffered=${existing.text.length}→${existing.text.length + ctx.text.length}`);
+            clearTimeout(existing.timer);
+            existing.text += ctx.text;
+            existing.timer = setTimeout(existing.flush, windowMs);
+            return;
+        }
+        if (ctx.text.length < minLeadingLength) {
+            // Short message → can never be the leading fragment of a real
+            // client split. Zero-latency passthrough.
+            dbg(`passthrough key=${key} len=${ctx.text.length} (<${minLeadingLength})`);
+            return next();
+        }
+        // Suspicious leading fragment: hold + start the wait window.
+        // Returns a Promise that only resolves after the buffer flushes
+        // (next() of THIS ctx is called with the combined text). This
+        // keeps gramio's middleware chain awaiting until we're done.
+        dbg(`open key=${key} len=${ctx.text.length} (≥${minLeadingLength}, wait ${windowMs}ms)`);
+        return new Promise((resolve, reject) => {
+            const buffered = {
+                text: ctx.text,
+                timer: setTimeout(() => buffered.flush(), windowMs),
+                flush: () => {
+                    // Detach from the map FIRST so any fragment arriving mid-flush
+                    // starts a fresh buffer instead of re-entering this one.
+                    dbg(`flush key=${key} total=${buffered.text.length}`);
+                    buffers.delete(key);
+                    // gramio's MessageContext exposes `text` as an accessor
+                    // with both `get` and `set` — assignment is the supported
+                    // way to override. We don't touch `entities`: fragment-1
+                    // entities reference fragment-1 text only, but plain-text
+                    // consumers (the sensible use of this plugin) ignore them.
+                    // Formatted-input consumers should disable the plugin.
+                    ctx.text = buffered.text;
+                    // Hand off to the rest of the chain. Resolve outer Promise
+                    // once the chain (and any downstream awaits) settles, so
+                    // gramio considers this middleware fully done.
+                    Promise.resolve(next()).then(() => resolve(), reject);
+                },
+            };
+            buffers.set(key, buffered);
+        });
+    });
+};
+//# sourceMappingURL=coalesce.js.map

package/dist/bot/coalesce.js.map

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

package/dist/bot/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Telegram bot plugins for GramIO. Imported as subpaths so this module
+ * has zero footprint for consumers that don't use them.
+ *
+ * Peer deps (all optional): `gramio`, `@gramio/format`, `@gramio/storage`, `marked`.
+ *
+ *   import { adminContext, gracefulStart } from '@adriangalilea/utils/bot/kit'
+ *   import { accessControl } from '@adriangalilea/utils/bot/access-control'
+ *   import { llmStream } from '@adriangalilea/utils/bot/llm-stream'
+ *
+ * Or all-in-one (pulls every subpath):
+ *   import { ... } from '@adriangalilea/utils/bot'
+ */
+export * from './kit.js';
+export * from './access-control.js';
+export * from './coalesce.js';
+export * from './llm-stream.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/bot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,UAAU,CAAA;AACxB,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA"}

package/dist/bot/index.js

@@ -0,0 +1,18 @@
+/**
+ * Telegram bot plugins for GramIO. Imported as subpaths so this module
+ * has zero footprint for consumers that don't use them.
+ *
+ * Peer deps (all optional): `gramio`, `@gramio/format`, `@gramio/storage`, `marked`.
+ *
+ *   import { adminContext, gracefulStart } from '@adriangalilea/utils/bot/kit'
+ *   import { accessControl } from '@adriangalilea/utils/bot/access-control'
+ *   import { llmStream } from '@adriangalilea/utils/bot/llm-stream'
+ *
+ * Or all-in-one (pulls every subpath):
+ *   import { ... } from '@adriangalilea/utils/bot'
+ */
+export * from './kit.js';
+export * from './access-control.js';
+export * from './coalesce.js';
+export * from './llm-stream.js';
+//# sourceMappingURL=index.js.map

package/dist/bot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,cAAc,UAAU,CAAA;AACxB,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA"}

package/dist/bot/kit.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Foundational helpers every bot wants. Two things:
+ *
+ *   `gracefulStart(bot, opts?)` — wires SIGINT/SIGTERM to bot.stop(),
+ *     runs an optional shutdown hook, force-kills if it hangs.
+ *
+ *   `adminContext({ adminId? })` — reads admin Telegram id from KEV
+ *     (`TELEGRAM_ADMIN_ID`) with optional hardcoded fallback. Decorates
+ *     every context with `ctx.adminId` (number) and `ctx.isAdmin`
+ *     (boolean). Throws at startup if neither source provides an id.
+ *
+ * Peer deps: `gramio`.
+ *
+ * @example
+ * import { Bot } from 'gramio'
+ * import { adminContext, gracefulStart } from '@adriangalilea/utils/bot/kit'
+ *
+ * const bot = new Bot(process.env.BOT_TOKEN!)
+ *   .extend(adminContext({ adminId: 190202471 }))   // KEV wins, 190… is fallback
+ *   .command('whoami', (ctx) => ctx.send(`admin? ${ctx.isAdmin}`))
+ *
+ * await gracefulStart(bot, { onShutdown: () => db.end() })
+ */
+import type { AnyBot } from 'gramio';
+import { Plugin } from 'gramio';
+export type GracefulStartOptions = {
+    /** Runs after `bot.stop()` resolves, before `process.exit`. Close DBs, flush logs. */
+    onShutdown?: () => Promise<void> | void;
+    /** Process exit code on graceful shutdown. Default 0. */
+    exitCode?: number;
+    /** Hard-kill after this many ms if shutdown hangs. Default 10000. */
+    forceExitAfterMs?: number;
+    /** Logger. Default `console.log`. Set `false` to silence. */
+    log?: ((msg: string) => void) | false;
+};
+export declare const gracefulStart: (bot: AnyBot, opts?: GracefulStartOptions) => Promise<void>;
+export type AdminContextOptions = {
+    /** Hardcoded fallback used when `KEV.TELEGRAM_ADMIN_ID` is unset. */
+    adminId?: number;
+};
+export declare const adminContext: (opts?: AdminContextOptions) => Plugin<{}, import("gramio").DeriveDefinitions & {
+    global: {
+        adminId: number;
+    };
+} & {
+    global: {
+        isAdmin: boolean;
+    };
+}, {}>;
+//# sourceMappingURL=kit.d.ts.map

package/dist/bot/kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.d.ts","sourceRoot":"","sources":["../../src/bot/kit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAK/B,MAAM,MAAM,oBAAoB,GAAG;IACjC,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACvC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,KAAK,CAAA;CACtC,CAAA;AAED,eAAO,MAAM,aAAa,GACxB,KAAK,MAAM,EACX,OAAM,oBAAyB,KAC9B,OAAO,CAAC,IAAI,CAiCd,CAAA;AAID,MAAM,MAAM,mBAAmB,GAAG;IAChC,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,OAAM,mBAAwB;;;;;;;;MAqB1D,CAAA"}

package/dist/bot/kit.js

@@ -0,0 +1,52 @@
+import { Plugin } from 'gramio';
+import { kev } from '../platform/kev.js';
+export const gracefulStart = async (bot, opts = {}) => {
+    const log = opts.log === false ? () => { } : (opts.log ?? ((m) => console.log(m)));
+    const forceMs = opts.forceExitAfterMs ?? 10_000;
+    let stopping = false;
+    const stop = async (signal) => {
+        if (stopping)
+            return;
+        stopping = true;
+        log(`[bot] ${signal} received, shutting down…`);
+        const force = setTimeout(() => {
+            console.error(`[bot] forced exit after ${forceMs}ms`);
+            process.exit(1);
+        }, forceMs);
+        force.unref?.();
+        try {
+            await bot.stop();
+            await opts.onShutdown?.();
+            log('[bot] shutdown clean');
+        }
+        catch (e) {
+            console.error('[bot] shutdown error', e);
+        }
+        finally {
+            clearTimeout(force);
+            process.exit(opts.exitCode ?? 0);
+        }
+    };
+    process.on('SIGINT', () => void stop('SIGINT'));
+    process.on('SIGTERM', () => void stop('SIGTERM'));
+    await bot.start();
+};
+export const adminContext = (opts = {}) => {
+    // KEV resolves: process.env → .env (project + monorepo, auto-discovered) → fallback.
+    // Cached after first read. `kev.int` panics on non-int strings, so a malformed
+    // env var screams immediately rather than producing NaN downstream.
+    const adminId = kev.int('TELEGRAM_ADMIN_ID', opts.adminId ?? 0);
+    if (!adminId) {
+        throw new Error('adminContext: TELEGRAM_ADMIN_ID not set and no adminId fallback. ' +
+            'Get your Telegram id from @UserIDentifyBot.');
+    }
+    return new Plugin('@adriangalilea/utils/bot/admin')
+        .decorate({ adminId })
+        .derive((ctx) => ({
+        // `senderId` is provided by gramio's SenderMixin. It's `undefined` on
+        // service-style events without an actor; the strict equality below
+        // gives `false` in that case, which is the right answer.
+        isAdmin: 'senderId' in ctx && ctx.senderId === adminId,
+    }));
+};
+//# sourceMappingURL=kit.js.map

package/dist/bot/kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit.js","sourceRoot":"","sources":["../../src/bot/kit.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AAexC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,GAAW,EACX,OAA6B,EAAE,EAChB,EAAE;IACjB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACjF,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,IAAI,MAAM,CAAA;IAE/C,IAAI,QAAQ,GAAG,KAAK,CAAA;IAEpB,MAAM,IAAI,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QACpC,IAAI,QAAQ;YAAE,OAAM;QACpB,QAAQ,GAAG,IAAI,CAAA;QACf,GAAG,CAAC,SAAS,MAAM,2BAA2B,CAAC,CAAA;QAE/C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,OAAO,CAAC,KAAK,CAAC,2BAA2B,OAAO,IAAI,CAAC,CAAA;YACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC,EAAE,OAAO,CAAC,CAAA;QACX,KAAK,CAAC,KAAK,EAAE,EAAE,CAAA;QAEf,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,IAAI,EAAE,CAAA;YAChB,MAAM,IAAI,CAAC,UAAU,EAAE,EAAE,CAAA;YACzB,GAAG,CAAC,sBAAsB,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAA;QAC1C,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAA;QAClC,CAAC;IACH,CAAC,CAAA;IAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC/C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;IAEjD,MAAM,GAAG,CAAC,KAAK,EAAE,CAAA;AACnB,CAAC,CAAA;AASD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAA4B,EAAE,EAAE,EAAE;IAC7D,qFAAqF;IACrF,+EAA+E;IAC/E,oEAAoE;IACpE,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAA;IAE/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,mEAAmE;YACjE,6CAA6C,CAChD,CAAA;IACH,CAAC;IAED,OAAO,IAAI,MAAM,CAAC,gCAAgC,CAAC;SAChD,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;SACrB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAChB,sEAAsE;QACtE,mEAAmE;QACnE,yDAAyD;QACzD,OAAO,EAAE,UAAU,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO;KACvD,CAAC,CAAC,CAAA;AACP,CAAC,CAAA"}

package/dist/bot/llm-stream.d.ts

@@ -0,0 +1,84 @@
+/**
+ * LLM streaming output for GramIO bots.
+ *
+ * Sends a placeholder, then debounces `editMessageText` calls as the
+ * LLM produces chunks. Markdown is parsed locally with
+ * `markdownToFormattable` — invalid markup degrades to plain text
+ * instead of failing (Telegram's `parse_mode` would reject the whole
+ * message). Splits at 4000 chars by promoting the next chunk to a
+ * fresh message at a paragraph/line/word boundary.
+ *
+ * Peer deps: `gramio`, `@gramio/format`, `marked`.
+ *
+ * @example
+ * import { Bot } from 'gramio'
+ * import { llmStream } from '@adriangalilea/utils/bot/llm-stream'
+ * import Anthropic from '@anthropic-ai/sdk'
+ *
+ * const claude = new Anthropic()
+ * const bot = new Bot(process.env.BOT_TOKEN!)
+ *   .extend(llmStream())
+ *   .on('message', async (ctx) => {
+ *     const stream = ctx.startStream()
+ *     const sse = await claude.messages.stream({
+ *       model: 'claude-opus-4-5',
+ *       max_tokens: 1024,
+ *       messages: [{ role: 'user', content: ctx.text ?? '' }],
+ *     })
+ *     for await (const chunk of sse) {
+ *       if (chunk.type === 'content_block_delta' && chunk.delta.type === 'text_delta') {
+ *         await stream.append(chunk.delta.text)
+ *       }
+ *     }
+ *     await stream.end()
+ *   })
+ *
+ * bot.start()
+ */
+import { Plugin } from 'gramio';
+export type StreamOptions = {
+    /** Debounce window between edits, in ms. Default 800. */
+    debounceMs?: number;
+    /** Initial placeholder shown until the first chunk arrives. Default "…". */
+    placeholder?: string;
+    /** Parse buffer as markdown. Default true. Set false for plain text streaming. */
+    markdown?: boolean;
+    /** Called on edit/send errors after internal recovery (rate limits, etc.). */
+    onError?: (err: unknown) => void;
+};
+export declare class MarkdownStreamer {
+    private buffer;
+    private currentMessageId?;
+    private firstSendPromise?;
+    private debounceTimer?;
+    private inFlight;
+    private dirty;
+    private ended;
+    private chatId;
+    private bot;
+    private opts;
+    constructor(ctx: {
+        chat: {
+            id: number;
+        };
+        bot: MarkdownStreamer['bot'];
+    }, opts: StreamOptions);
+    /** Append a chunk. Schedules a debounced edit. */
+    append(text: string): Promise<void>;
+    /** Flush any pending edit and close the stream. Idempotent. */
+    end(): Promise<void>;
+    private scheduleFlush;
+    private flushNow;
+}
+/**
+ * GramIO plugin. Adds `ctx.startStream(opts?)` on every message context.
+ *
+ * Defaults set here apply to every stream; per-call options in
+ * `ctx.startStream({...})` override them.
+ */
+export declare const llmStream: (defaults?: StreamOptions) => Plugin<{}, import("gramio").DeriveDefinitions & {
+    message: {
+        startStream: (opts?: StreamOptions) => MarkdownStreamer;
+    };
+}, {}>;
+//# sourceMappingURL=llm-stream.d.ts.map

package/dist/bot/llm-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-stream.d.ts","sourceRoot":"","sources":["../../src/bot/llm-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAM/B,MAAM,MAAM,aAAa,GAAG;IAC1B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CACjC,CAAA;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,gBAAgB,CAAC,CAAQ;IACjC,OAAO,CAAC,gBAAgB,CAAC,CAAe;IACxC,OAAO,CAAC,aAAa,CAAC,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,KAAK,CAAQ;IAErB,OAAO,CAAC,MAAM,CAAQ;IAItB,OAAO,CAAC,GAAG,CAYV;IACD,OAAO,CAAC,IAAI,CAAyB;gBAGnC,GAAG,EAAE;QAAE,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;KAAE,EAC3D,IAAI,EAAE,aAAa;IAYrB,kDAAkD;IAC5C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CzC,+DAA+D;IACzD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1B,OAAO,CAAC,aAAa;YAaP,QAAQ;CAmCvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,WAAU,aAAkB;;6BAI9B,aAAa;;MAEhC,CAAA"}

package/dist/bot/llm-stream.js

@@ -0,0 +1,201 @@
+/**
+ * LLM streaming output for GramIO bots.
+ *
+ * Sends a placeholder, then debounces `editMessageText` calls as the
+ * LLM produces chunks. Markdown is parsed locally with
+ * `markdownToFormattable` — invalid markup degrades to plain text
+ * instead of failing (Telegram's `parse_mode` would reject the whole
+ * message). Splits at 4000 chars by promoting the next chunk to a
+ * fresh message at a paragraph/line/word boundary.
+ *
+ * Peer deps: `gramio`, `@gramio/format`, `marked`.
+ *
+ * @example
+ * import { Bot } from 'gramio'
+ * import { llmStream } from '@adriangalilea/utils/bot/llm-stream'
+ * import Anthropic from '@anthropic-ai/sdk'
+ *
+ * const claude = new Anthropic()
+ * const bot = new Bot(process.env.BOT_TOKEN!)
+ *   .extend(llmStream())
+ *   .on('message', async (ctx) => {
+ *     const stream = ctx.startStream()
+ *     const sse = await claude.messages.stream({
+ *       model: 'claude-opus-4-5',
+ *       max_tokens: 1024,
+ *       messages: [{ role: 'user', content: ctx.text ?? '' }],
+ *     })
+ *     for await (const chunk of sse) {
+ *       if (chunk.type === 'content_block_delta' && chunk.delta.type === 'text_delta') {
+ *         await stream.append(chunk.delta.text)
+ *       }
+ *     }
+ *     await stream.end()
+ *   })
+ *
+ * bot.start()
+ */
+import { Plugin } from 'gramio';
+import { markdownToFormattable } from '@gramio/format/markdown';
+const MAX_LEN = 4000; // Telegram caps at 4096; leave headroom for entity offsets
+const DEFAULT_DEBOUNCE_MS = 800;
+export class MarkdownStreamer {
+    buffer = '';
+    currentMessageId;
+    firstSendPromise;
+    debounceTimer;
+    inFlight = false;
+    dirty = false;
+    ended = false;
+    chatId;
+    // Match gramio's `bot.api` shape structurally. `text` accepts string or any
+    // `Formattable` (from `@gramio/format`) — both stringify safely. We don't
+    // import gramio's full Bot type to keep the streamer testable in isolation.
+    bot;
+    opts;
+    constructor(ctx, opts) {
+        this.chatId = ctx.chat.id;
+        this.bot = ctx.bot;
+        this.opts = {
+            debounceMs: opts.debounceMs ?? DEFAULT_DEBOUNCE_MS,
+            placeholder: opts.placeholder ?? '…',
+            markdown: opts.markdown ?? true,
+            onError: opts.onError ?? ((e) => console.error('[llm-stream]', e)),
+        };
+    }
+    /** Append a chunk. Schedules a debounced edit. */
+    async append(text) {
+        if (this.ended)
+            throw new Error('stream already ended');
+        if (!text)
+            return;
+        // first chunk: send the placeholder so we have a message_id to edit.
+        // Serialized via firstSendPromise so concurrent appends don't double-send.
+        if (this.currentMessageId === undefined && !this.firstSendPromise) {
+            this.firstSendPromise = (async () => {
+                const sent = await this.bot.api.sendMessage({
+                    chat_id: this.chatId,
+                    text: this.opts.placeholder,
+                });
+                this.currentMessageId = sent.message_id;
+            })();
+        }
+        if (this.firstSendPromise)
+            await this.firstSendPromise;
+        // overflow: freeze current message at last good split, start a new one.
+        const next = this.buffer + text;
+        if (next.length > MAX_LEN) {
+            const splitAt = findSplit(next, MAX_LEN);
+            const head = next.slice(0, splitAt);
+            const tail = next.slice(splitAt).trimStart();
+            this.buffer = head;
+            this.dirty = true;
+            await this.flushNow(); // commits head into current message
+            this.buffer = '';
+            this.currentMessageId = undefined;
+            this.firstSendPromise = undefined;
+            this.dirty = false;
+            if (this.debounceTimer) {
+                clearTimeout(this.debounceTimer);
+                this.debounceTimer = undefined;
+            }
+            if (tail)
+                await this.append(tail);
+            return;
+        }
+        this.buffer = next;
+        this.dirty = true;
+        this.scheduleFlush();
+    }
+    /** Flush any pending edit and close the stream. Idempotent. */
+    async end() {
+        if (this.ended)
+            return;
+        this.ended = true;
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = undefined;
+        }
+        while (this.inFlight)
+            await sleep(50);
+        if (this.dirty)
+            await this.flushNow();
+    }
+    scheduleFlush() {
+        if (this.debounceTimer)
+            return;
+        this.debounceTimer = setTimeout(async () => {
+            this.debounceTimer = undefined;
+            if (this.inFlight) {
+                this.scheduleFlush();
+                return;
+            }
+            await this.flushNow();
+            if (this.dirty && !this.ended)
+                this.scheduleFlush();
+        }, this.opts.debounceMs);
+    }
+    async flushNow() {
+        if (!this.dirty)
+            return;
+        if (this.currentMessageId === undefined) {
+            // No active message yet — likely the first send is still in flight
+            // or the recovery path cleared it. Caller's next append() will
+            // re-create one.
+            return;
+        }
+        this.inFlight = true;
+        this.dirty = false;
+        const snapshot = this.buffer;
+        try {
+            const payload = this.opts.markdown ? markdownToFormattable(snapshot) : snapshot;
+            await this.bot.api.editMessageText({
+                chat_id: this.chatId,
+                message_id: this.currentMessageId,
+                text: payload,
+            });
+        }
+        catch (e) {
+            const msg = String(e?.message ?? e);
+            if (msg.includes('message is not modified')) {
+                // identical content — fine
+            }
+            else if (msg.includes('message to edit not found')) {
+                // message gone (deleted by user, etc.) — restart with a fresh send
+                this.currentMessageId = undefined;
+                this.firstSendPromise = undefined;
+                this.dirty = true;
+            }
+            else {
+                this.dirty = true;
+                this.opts.onError(e);
+            }
+        }
+        finally {
+            this.inFlight = false;
+        }
+    }
+}
+/**
+ * GramIO plugin. Adds `ctx.startStream(opts?)` on every message context.
+ *
+ * Defaults set here apply to every stream; per-call options in
+ * `ctx.startStream({...})` override them.
+ */
+export const llmStream = (defaults = {}) => new Plugin('@adriangalilea/utils/bot/llm-stream').derive('message', (ctx) => ({
+    // gramio's `message` scope guarantees `ctx.chat`. `ctx.bot.api` is on
+    // every Context. Structural compat → no cast needed.
+    startStream: (opts = {}) => new MarkdownStreamer(ctx, { ...defaults, ...opts }),
+}));
+function findSplit(text, maxLen) {
+    // Prefer paragraph break, then line, then space. Reject splits in the
+    // first half — better to truncate at maxLen than to leave a stub.
+    for (const sep of ['\n\n', '\n', ' ']) {
+        const idx = text.lastIndexOf(sep, maxLen);
+        if (idx > maxLen / 2)
+            return idx;
+    }
+    return maxLen;
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+//# sourceMappingURL=llm-stream.js.map

package/dist/bot/llm-stream.js.map

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