@adriangalilea/utils 0.5.0 → 0.6.0

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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAE/D,MAAM,OAAO,GAAG,IAAI,CAAA,CAAC,2DAA2D;AAChF,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAa/B,MAAM,OAAO,gBAAgB;IACnB,MAAM,GAAG,EAAE,CAAA;IACX,gBAAgB,CAAS;IACzB,gBAAgB,CAAgB;IAChC,aAAa,CAAgC;IAC7C,QAAQ,GAAG,KAAK,CAAA;IAChB,KAAK,GAAG,KAAK,CAAA;IACb,KAAK,GAAG,KAAK,CAAA;IAEb,MAAM,CAAQ;IACtB,4EAA4E;IAC5E,0EAA0E;IAC1E,4EAA4E;IACpE,GAAG,CAYV;IACO,IAAI,CAAyB;IAErC,YACE,GAA2D,EAC3D,IAAmB;QAEnB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAA;QACzB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAA;QAClB,IAAI,CAAC,IAAI,GAAG;YACV,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,mBAAmB;YAClD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,GAAG;YACpC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;SACnE,CAAA;IACH,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QACvD,IAAI,CAAC,IAAI;YAAE,OAAM;QAEjB,qEAAqE;QACrE,2EAA2E;QAC3E,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAClE,IAAI,CAAC,gBAAgB,GAAG,CAAC,KAAK,IAAI,EAAE;gBAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC;oBAC1C,OAAO,EAAE,IAAI,CAAC,MAAM;oBACpB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;iBAC5B,CAAC,CAAA;gBACF,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,UAAU,CAAA;YACzC,CAAC,CAAC,EAAE,CAAA;QACN,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB;YAAE,MAAM,IAAI,CAAC,gBAAgB,CAAA;QAEtD,wEAAwE;QACxE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAC/B,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;YACnC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,CAAA;YAE5C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;YACjB,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA,CAAC,oCAAoC;YAE1D,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;YAChB,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAA;YACjC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAA;YACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;YAClB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;gBAChC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAA;YAChC,CAAC;YAED,IAAI,IAAI;gBAAE,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YACjC,OAAM;QACR,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,aAAa,EAAE,CAAA;IACtB,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,GAAG;QACP,IAAI,IAAI,CAAC,KAAK;YAAE,OAAM;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;YAChC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAA;QAChC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ;YAAE,MAAM,KAAK,CAAC,EAAE,CAAC,CAAA;QACrC,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;IACvC,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,aAAa;YAAE,OAAM;QAC9B,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YACzC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAA;YAC9B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,IAAI,CAAC,aAAa,EAAE,CAAA;gBACpB,OAAM;YACR,CAAC;YACD,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAA;YACrB,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,aAAa,EAAE,CAAA;QACrD,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC1B,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAM;QACvB,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACxC,mEAAmE;YACnE,+DAA+D;YAC/D,iBAAiB;YACjB,OAAM;QACR,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;YAC/E,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC;gBACjC,OAAO,EAAE,IAAI,CAAC,MAAM;gBACpB,UAAU,EAAE,IAAI,CAAC,gBAAgB;gBACjC,IAAI,EAAE,OAAO;aACd,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,MAAM,CAAE,CAAsC,EAAE,OAAO,IAAI,CAAC,CAAC,CAAA;YACzE,IAAI,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;gBAC5C,2BAA2B;YAC7B,CAAC;iBAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,CAAC;gBACrD,mEAAmE;gBACnE,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAA;gBACjC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAA;gBACjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;YACnB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;gBACjB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;YACtB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;QACvB,CAAC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,WAA0B,EAAE,EAAE,EAAE,CACxD,IAAI,MAAM,CAAC,qCAAqC,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5E,sEAAsE;IACtE,qDAAqD;IACrD,WAAW,EAAE,CAAC,OAAsB,EAAE,EAAE,EAAE,CACxC,IAAI,gBAAgB,CAAC,GAAG,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC;CACtD,CAAC,CAAC,CAAA;AAEL,SAAS,SAAS,CAAC,IAAY,EAAE,MAAc;IAC7C,sEAAsE;IACtE,kEAAkE;IAClE,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QACzC,IAAI,GAAG,GAAG,MAAM,GAAG,CAAC;YAAE,OAAO,GAAG,CAAA;IAClC,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adriangalilea/utils",
-  "version": "0.5.0",
-  "description": "TypeScript utilities - logger, currency, formatter, and more",
+  "version": "0.6.0",
+  "description": "TypeScript utilities - logger, currency, formatter, GramIO bot plugins, and more",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "type": "module",
@@ -27,6 +27,22 @@
     "./currency": {
       "types": "./dist/universal/currency/index.d.ts",
       "default": "./dist/universal/currency/index.js"
+    },
+    "./bot": {
+      "types": "./dist/bot/index.d.ts",
+      "default": "./dist/bot/index.js"
+    },
+    "./bot/access-control": {
+      "types": "./dist/bot/access-control.d.ts",
+      "default": "./dist/bot/access-control.js"
+    },
+    "./bot/kit": {
+      "types": "./dist/bot/kit.d.ts",
+      "default": "./dist/bot/kit.js"
+    },
+    "./bot/llm-stream": {
+      "types": "./dist/bot/llm-stream.d.ts",
+      "default": "./dist/bot/llm-stream.js"
     }
   },
   "files": [
@@ -54,13 +70,42 @@
   "author": "Adrian Galilea <adriangalilea@gmail.com>",
   "license": "MIT",
   "devDependencies": {
+    "@gramio/format": "^0.8.0",
+    "@gramio/session": "^0.2.0",
+    "@gramio/storage": "^2.0.1",
     "@types/node": "^24.3.0",
+    "gramio": "^0.10.0",
+    "marked": "^15.0.11",
     "tsx": "^4.20.4",
     "typescript": "^5.9.2"
   },
   "dependencies": {
     "chalk": "^5.6.0"
   },
+  "peerDependencies": {
+    "@gramio/format": ">=0.8.0",
+    "@gramio/session": ">=0.2.0",
+    "@gramio/storage": ">=2.0.0",
+    "gramio": ">=0.10.0",
+    "marked": ">=12"
+  },
+  "peerDependenciesMeta": {
+    "@gramio/format": {
+      "optional": true
+    },
+    "@gramio/session": {
+      "optional": true
+    },
+    "@gramio/storage": {
+      "optional": true
+    },
+    "gramio": {
+      "optional": true
+    },
+    "marked": {
+      "optional": true
+    }
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"