@adriangalilea/utils 0.12.0 → 0.14.0

package/dist/bot/llm-stream.js

@@ -1,285 +0,0 @@
-/**
- * LLM streaming for GramIO bots — both halves of the pipeline:
- *
- *   `streamChat(response)`   — INPUT: parse OpenAI-compatible SSE
- *                              (OpenAI, vllm, mlx-lm, llama.cpp, Together,
- *                              Groq, …) into a typed `AsyncGenerator` of
- *                              `{ type: 'content' | 'reasoning', text }`.
- *
- *   `ctx.startStream()`      — OUTPUT: debounced `editMessageText` to
- *                              Telegram. Local Markdown parse via
- *                              `@gramio/format` so malformed mid-stream
- *                              markup degrades to plain text instead of
- *                              failing. Splits at 4000 chars on
- *                              paragraph / line / word boundary.
- *
- * The two compose into the canonical bot pipeline:
- *
- *     fetch(...) ──streamChat──> {content, reasoning} chunks ──ctx.startStream──> Telegram
- *
- * Peer deps: `gramio`, `@gramio/format`, `marked`.
- *
- * @example
- * import { Bot } from 'gramio'
- * import { llmStream, streamChat } from '@adriangalilea/utils/bot/llm-stream'
- *
- * const bot = new Bot(process.env.BOT_TOKEN!)
- *   .extend(llmStream())
- *   .on('message', async (ctx) => {
- *     const response = await fetch(process.env.LLM_URL!, {
- *       method: 'POST',
- *       headers: { 'Content-Type': 'application/json' },
- *       body: JSON.stringify({
- *         model: process.env.LLM_MODEL,
- *         messages: [{ role: 'user', content: ctx.text ?? '' }],
- *         stream: true,
- *       }),
- *     })
- *     const stream = ctx.startStream()
- *     for await (const chunk of streamChat(response)) {
- *       if (chunk.type === 'content') await stream.append(chunk.text)
- *       // chunk.type === 'reasoning' is also yielded for thinking models
- *     }
- *     await stream.end()
- *   })
- *
- * bot.start()
- */
-import { Plugin } from 'gramio';
-import { markdownToFormattable } from '@gramio/format/markdown';
-/**
- * Parse an OpenAI-compatible chat-completions SSE response into a
- * typed `AsyncGenerator<LLMChunk>`. Reads `response.body` once.
- *
- * Recognised reasoning aliases (as of 2026): `reasoning_content`
- * (vllm, qwen3, DeepSeek-R1, gpt-oss harmony) and `reasoning` (some
- * mlx-lm forks, gemma builds). If a model surfaces a new key, add it
- * here — single source of truth for the field.
- *
- * Constrained-SSE assumption: lines are `\n`-delimited and each event
- * is `data: <json>` or `data: [DONE]`. This matches every OpenAI-compat
- * server in the wild but is NOT the full SSE spec (no comments, no
- * multi-line `data:`, no `retry`/`id` fields). Swap to
- * `eventsource-parser` if you hit a producer that needs them.
- *
- * Malformed JSON lines are silently skipped; the generator ends when
- * the stream closes.
- *
- * @param response  the `fetch` `Response` from a `stream: true` chat
- *                  completion call. Must not be already consumed.
- * @throws if `response.body` is null (non-streaming response).
- *
- * @example  framework-agnostic — parser doesn't know about Telegram
- * const res = await fetch(url, { method: 'POST', body })
- * for await (const chunk of streamChat(res)) {
- *   if (chunk.type === 'content') process.stdout.write(chunk.text)
- * }
- */
-export async function* streamChat(response) {
-    if (!response.body)
-        throw new Error('streamChat: response.body is null');
-    const reader = response.body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = '';
-    while (true) {
-        const { done, value } = await reader.read();
-        if (done)
-            break;
-        buffer += decoder.decode(value, { stream: true });
-        const lines = buffer.split('\n');
-        buffer = lines.pop() ?? '';
-        for (const line of lines) {
-            if (!line.startsWith('data: '))
-                continue;
-            const data = line.slice(6).trim();
-            if (data === '[DONE]')
-                continue;
-            let parsed;
-            try {
-                parsed = JSON.parse(data);
-            }
-            catch {
-                continue;
-            }
-            const delta = parsed.choices?.[0]?.delta;
-            if (!delta)
-                continue;
-            const reasoning = delta.reasoning_content ?? delta.reasoning;
-            if (typeof reasoning === 'string' && reasoning.length > 0) {
-                yield { type: 'reasoning', text: reasoning };
-            }
-            if (typeof delta.content === 'string' && delta.content.length > 0) {
-                yield { type: 'content', text: delta.content };
-            }
-        }
-    }
-}
-// ─── OUTPUT: Telegram streamer ─────────────────────────────────────
-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;
-    threadId;
-    // 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;
-        // Captured so the streamed reply stays in the same thread.
-        // We call bot.api.sendMessage directly (no ctx.send), so the
-        // SendMixin's auto-thread doesn't help us here.
-        this.threadId = ctx.threadId;
-        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,
-                    ...(this.threadId !== undefined && { message_thread_id: this.threadId }),
-                    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

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

package/dist/bot/message-history.d.ts

@@ -1,279 +0,0 @@
-/**
- * Per-user rolling message history for GramIO bots — opt-in, with
- * retention, **sharded by thread**.
- *
- * Each user has one session record. Inside that record, `history` keeps
- * a separate ring buffer per thread:
- *
- *     storage[userId].history.shards = {
- *       'general':   [ ...entries from no-thread messages ],
- *       '12345':     [ ...entries from message_thread_id=12345 ],
- *       '98765':     [ ...entries from message_thread_id=98765 ],
- *     }
- *
- * This makes the plugin compatible with both forum-supergroup topics
- * and BotFather's Threaded Mode for private chats (which is the whole
- * point of those features: parallel conversations with separate
- * context). `ctx.history` returns ONLY the slice for the current
- * thread; `ctx.allHistory` returns the full sharded map when you need
- * a cross-thread view (e.g. for `/export`).
- *
- * Thread key: `String(ctx.threadId)`, or `'general'` when no thread.
- *
- * ## What this plugin owns
- *
- *   - Appends each incoming user message to the shard for its thread
- *   - Prunes per-shard by `retentionDays` and `maxMessages`
- *   - Exposes `ctx.history` (current thread's pruned slice) and
- *     `ctx.allHistory` (full map) to handlers
- *
- * ## GDPR caveat — retention IS personal data
- *
- * Unlike `bot/language` (preference data, covered by Telegram's standard
- * privacy policy), retaining user **message content** is the one thing
- * the [standard policy](https://telegram.org/privacy-tpa) does NOT cover
- * by default. If you extend `messageHistory`, you should:
- *
- *   1. Set a custom `privacy` URL on your `botMenu` describing what you
- *      retain and for how long.
- *   2. Pass `personalData: { storage }` to your `botMenu` so 🗑 Forget
- *      and 📥 Export buttons appear — letting users see and delete
- *      the data you keep about them.
- *
- * These are not enforced by this plugin (would couple it to menu); they
- * are documented as the bot author's legal responsibility.
- *
- * Peer deps: `gramio`, `@gramio/session`.
- *
- * @example
- * import { Bot } from 'gramio'
- * import { session } from '@gramio/session'
- * import { redisStorage } from '@gramio/storage-redis'
- * import { messageHistory } from '@adriangalilea/utils/bot/message-history'
- *
- * const userSession = session({ storage: redisStorage(), key: 'session', initial: () => ({}) })
- *
- * const history = messageHistory({
- *   session: userSession,
- *   maxMessages: 100,         // cap per-thread
- *   retentionDays: 7,
- * })
- *
- * const bot = new Bot(process.env.BOT_TOKEN!)
- *   .extend(userSession)
- *   .extend(history.plugin)
- *   .command('replay', (ctx) => {
- *     const last = ctx.history.slice(-3).map((e) => e.text).join('\n---\n')
- *     return ctx.send(last || '(no history in this thread)')
- *   })
- */
-import { type DeriveDefinitions, Plugin } from 'gramio';
-import { session } from '@gramio/session';
-export type HistoryEntry = {
-    /** Telegram message id. */
-    messageId: number;
-    /** Unix seconds (Telegram's `message.date`). */
-    date: number;
-    /** Message text, or empty string if non-text. */
-    text: string;
-};
-/**
- * Per-thread shards. Key is `String(ctx.threadId)` or `'general'`
- * when no thread. Each shard is an independently capped + pruned
- * ring buffer.
- */
-export type HistoryRecord = {
-    shards: {
-        [threadKey: string]: HistoryEntry[];
-    };
-};
-/** Loose session shape — this plugin only touches the `history` field. */
-type SessionLike = {
-    history?: HistoryRecord;
-};
-/** @internal — kept unexported so it doesn't clash with peers' refs. */
-type HistorySessionPluginRef = ReturnType<typeof session<SessionLike, 'session'>>;
-export type MessageHistoryOptions = {
-    /**
-     * Shared session plugin. This plugin extends it for the type flow;
-     * gramio's runtime dedup ensures it only runs once per update.
-     */
-    session: HistorySessionPluginRef;
-    /** Ring buffer cap **per thread**. Oldest entries dropped when exceeded. */
-    maxMessages: number;
-    /** Entries older than this (in days) are dropped on read. */
-    retentionDays: number;
-};
-export type MessageHistoryFeature = {
-    plugin: ReturnType<typeof buildHistoryPlugin>;
-};
-type HistoryDerives = {
-    /** Pruned snapshot for the CURRENT thread only. */
-    history: ReadonlyArray<HistoryEntry>;
-    /**
-     * Pruned snapshot of all threads, keyed by thread (`'general'` or
-     * stringified threadId). Use for cross-thread views (e.g. /export).
-     */
-    allHistory: Readonly<{
-        [threadKey: string]: ReadonlyArray<HistoryEntry>;
-    }>;
-};
-export declare const messageHistory: (opts: MessageHistoryOptions) => MessageHistoryFeature;
-declare const buildHistoryPlugin: (args: {
-    sessionPlugin: HistorySessionPluginRef;
-    maxMessages: number;
-    retentionDays: number;
-}) => Plugin<{}, DeriveDefinitions & {
-    global: HistoryDerives;
-} & {
-    message: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    channel_post: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    inline_query: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    chosen_inline_result: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    callback_query: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    shipping_query: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    pre_checkout_query: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    poll_answer: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    chat_join_request: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    new_chat_members: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    new_chat_title: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    new_chat_photo: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    delete_chat_photo: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    group_chat_created: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    message_auto_delete_timer_changed: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    migrate_to_chat_id: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    migrate_from_chat_id: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    pinned_message: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    invoice: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    successful_payment: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    chat_shared: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    proximity_alert_triggered: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    video_chat_scheduled: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    video_chat_started: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    video_chat_ended: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    video_chat_participants_invited: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    web_app_data: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    location: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-    passport_data: {
-        session: SessionLike & {
-            $clear: () => Promise<void>;
-        };
-    };
-} & {
-    message: HistoryDerives;
-    callback_query: HistoryDerives;
-}, {}>;
-export {};
-//# sourceMappingURL=message-history.d.ts.map

package/dist/bot/message-history.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"message-history.d.ts","sourceRoot":"","sources":["../../src/bot/message-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAIzC,MAAM,MAAM,YAAY,GAAG;IACzB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAAA;KAAE,CAAA;CAChD,CAAA;AAaD,0EAA0E;AAC1E,KAAK,WAAW,GAAG;IAAE,OAAO,CAAC,EAAE,aAAa,CAAA;CAAE,CAAA;AAE9C,wEAAwE;AACxE,KAAK,uBAAuB,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAA;AAEjF,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;OAGG;IACH,OAAO,EAAE,uBAAuB,CAAA;IAChC,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAA;IACnB,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;CAC9C,CAAA;AAID,KAAK,cAAc,GAAG;IACpB,mDAAmD;IACnD,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;IACpC;;;OAGG;IACH,UAAU,EAAE,QAAQ,CAAC;QAAE,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,CAAA;KAAE,CAAC,CAAA;CAC3E,CAAA;AA6BD,eAAO,MAAM,cAAc,GAAI,MAAM,qBAAqB,KAAG,qBAW5D,CAAA;AAID,QAAA,MAAM,kBAAkB,GAAI,MAAM;IAChC,aAAa,EAAE,uBAAuB,CAAA;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;CACtB;YAGqD,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAqCnE,CAAA"}