grok-dev 1.0.0-rc1

package/dist/storage/workspaces.js

@@ -0,0 +1,60 @@
+import { createHash } from "crypto";
+import fs from "fs";
+import path from "path";
+import { findGitRoot } from "../utils/git-root";
+import { getDatabase } from "./db";
+export function ensureWorkspace(cwd) {
+    const resolved = resolveWorkspace(cwd);
+    const now = new Date().toISOString();
+    const id = createHash("sha1").update(resolved.scopeKey).digest("hex").slice(0, 16);
+    const db = getDatabase();
+    db.prepare(`
+    INSERT INTO workspaces (id, scope_key, canonical_path, git_root, display_name, last_seen_at)
+    VALUES (@id, @scope_key, @canonical_path, @git_root, @display_name, @last_seen_at)
+    ON CONFLICT(scope_key) DO UPDATE SET
+      canonical_path = excluded.canonical_path,
+      git_root = excluded.git_root,
+      display_name = excluded.display_name,
+      last_seen_at = excluded.last_seen_at
+  `).run({
+        id,
+        scope_key: resolved.scopeKey,
+        canonical_path: resolved.canonicalPath,
+        git_root: resolved.gitRoot,
+        display_name: resolved.displayName,
+        last_seen_at: now,
+    });
+    const row = db
+        .prepare(`
+    SELECT id, scope_key, canonical_path, git_root, display_name, last_seen_at
+    FROM workspaces
+    WHERE scope_key = ?
+  `)
+        .get(resolved.scopeKey);
+    if (!row) {
+        throw new Error(`Failed to resolve workspace for ${cwd}`);
+    }
+    return toWorkspaceInfo(row);
+}
+export function resolveWorkspace(cwd) {
+    const canonicalPath = fs.realpathSync.native(cwd);
+    const gitRoot = findGitRoot(canonicalPath);
+    const scopePath = gitRoot || canonicalPath;
+    return {
+        scopeKey: scopePath,
+        canonicalPath,
+        gitRoot,
+        displayName: path.basename(scopePath) || "workspace",
+    };
+}
+function toWorkspaceInfo(row) {
+    return {
+        id: row.id,
+        scopeKey: row.scope_key,
+        canonicalPath: row.canonical_path,
+        gitRoot: row.git_root,
+        displayName: row.display_name,
+        lastSeenAt: new Date(row.last_seen_at),
+    };
+}
+//# sourceMappingURL=workspaces.js.map

package/dist/storage/workspaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../src/storage/workspaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAkBnC,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnF,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IAEzB,EAAE,CAAC,OAAO,CAAC;;;;;;;;GAQV,CAAC,CAAC,GAAG,CAAC;QACL,EAAE;QACF,SAAS,EAAE,QAAQ,CAAC,QAAQ;QAC5B,cAAc,EAAE,QAAQ,CAAC,aAAa;QACtC,QAAQ,EAAE,QAAQ,CAAC,OAAO;QAC1B,YAAY,EAAE,QAAQ,CAAC,WAAW;QAClC,YAAY,EAAE,GAAG;KAClB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC;;;;GAIV,CAAC;SACC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAA6B,CAAC;IAEtD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,IAAI,aAAa,CAAC;IAE3C,OAAO;QACL,QAAQ,EAAE,SAAS;QACnB,aAAa;QACb,OAAO;QACP,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,WAAW;KACrD,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,GAAiB;IACxC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,OAAO,EAAE,GAAG,CAAC,QAAQ;QACrB,WAAW,EAAE,GAAG,CAAC,YAAY;QAC7B,UAAU,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/telegram/bridge.d.ts

@@ -0,0 +1,39 @@
+import type { Agent } from "../agent/agent";
+import type { ToolCall, ToolResult } from "../types/index";
+import type { TurnCoordinator } from "./turn-coordinator";
+export { splitTelegramMessage, TELEGRAM_MAX_MESSAGE } from "./limits";
+export interface TelegramBridgeOptions {
+    token: string;
+    getApprovedUserIds: () => number[];
+    coordinator: TurnCoordinator;
+    getTelegramAgent: (userId: number) => Agent;
+    onUserMessage?: (event: {
+        turnKey: string;
+        userId: number;
+        content: string;
+    }) => void;
+    onAssistantMessage?: (event: {
+        turnKey: string;
+        userId: number;
+        content: string;
+        done: boolean;
+    }) => void;
+    onToolCalls?: (event: {
+        turnKey: string;
+        userId: number;
+        toolCalls: ToolCall[];
+    }) => void;
+    onToolResult?: (event: {
+        turnKey: string;
+        userId: number;
+        toolCall: ToolCall;
+        toolResult: ToolResult;
+    }) => void;
+    onError?: (message: string) => void;
+}
+export interface TelegramBridgeHandle {
+    start: () => void;
+    stop: () => Promise<void>;
+    sendDm: (userId: number, text: string) => Promise<void>;
+}
+export declare function createTelegramBridge(opts: TelegramBridgeOptions): TelegramBridgeHandle;

package/dist/telegram/bridge.js

@@ -0,0 +1,164 @@
+import { Bot } from "grammy";
+import { loadUserSettings, resolveTelegramStreamSettings } from "../utils/settings";
+import { splitTelegramMessage, TELEGRAM_MAX_MESSAGE } from "./limits";
+import { registerPairingCode } from "./pairing";
+import { runTelegramPartialReply } from "./preview-stream";
+import { startTypingRefresh } from "./typing-refresh";
+export { splitTelegramMessage, TELEGRAM_MAX_MESSAGE } from "./limits";
+export function createTelegramBridge(opts) {
+    const bot = new Bot(opts.token);
+    let running = false;
+    bot.command("start", async (ctx) => {
+        await ctx.reply("Send /pair to link this chat to Grok CLI, then approve the code in the terminal.");
+    });
+    bot.command("pair", async (ctx) => {
+        const userId = ctx.from?.id;
+        if (userId === undefined)
+            return;
+        const code = registerPairingCode(userId);
+        await ctx.reply(`Your pairing code: ${code}\nEnter this code in Grok CLI (/remote-control → Telegram) to approve.`);
+    });
+    bot.on("message:text", async (ctx) => {
+        const text = ctx.message.text;
+        if (text.startsWith("/"))
+            return;
+        const userId = ctx.from?.id;
+        if (userId === undefined)
+            return;
+        const approved = opts.getApprovedUserIds();
+        if (!approved.includes(userId)) {
+            await ctx.reply("Not paired yet. Send /pair to get a code, then approve in Grok CLI.");
+            return;
+        }
+        await opts.coordinator.run(async () => {
+            try {
+                const turnKey = `telegram:${ctx.chat.id}:${ctx.message.message_id}`;
+                opts.onUserMessage?.({ turnKey, userId, content: text });
+                const agent = opts.getTelegramAgent(userId);
+                const stream = resolveTelegramStreamSettings(loadUserSettings().telegram);
+                if (stream.streaming === "off") {
+                    const stopTyping = startTypingRefresh(bot.api, ctx.chat.id, ctx.message.message_thread_id, stream.typingIndicator);
+                    let acc = "";
+                    try {
+                        for await (const chunk of agent.processMessage(text)) {
+                            switch (chunk.type) {
+                                case "content":
+                                    if (chunk.content) {
+                                        acc += chunk.content;
+                                    }
+                                    break;
+                                case "tool_calls":
+                                    if (chunk.toolCalls) {
+                                        opts.onToolCalls?.({ turnKey, userId, toolCalls: chunk.toolCalls });
+                                    }
+                                    break;
+                                case "tool_result":
+                                    if (chunk.toolCall && chunk.toolResult) {
+                                        opts.onToolResult?.({
+                                            turnKey,
+                                            userId,
+                                            toolCall: chunk.toolCall,
+                                            toolResult: chunk.toolResult,
+                                        });
+                                    }
+                                    break;
+                            }
+                        }
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        opts.onAssistantMessage?.({
+                            turnKey,
+                            userId,
+                            content: `Error: ${msg.slice(0, TELEGRAM_MAX_MESSAGE)}`,
+                            done: true,
+                        });
+                        await ctx.reply(`Error: ${msg.slice(0, TELEGRAM_MAX_MESSAGE)}`);
+                        return;
+                    }
+                    finally {
+                        stopTyping();
+                    }
+                    const trimmed = acc.trim() || "(no text output)";
+                    opts.onAssistantMessage?.({ turnKey, userId, content: trimmed, done: true });
+                    const parts = splitTelegramMessage(trimmed);
+                    for (const part of parts) {
+                        await ctx.reply(part);
+                    }
+                    return;
+                }
+                await runTelegramPartialReply(bot.api, {
+                    chatId: ctx.chat.id,
+                    messageThreadId: ctx.message.message_thread_id,
+                    typingIndicator: stream.typingIndicator,
+                    stream: agent.processMessage(text),
+                    onAssistantMessage: (event) => {
+                        opts.onAssistantMessage?.({
+                            turnKey,
+                            userId,
+                            content: event.content,
+                            done: event.done,
+                        });
+                    },
+                    onToolCalls: (toolCalls) => {
+                        opts.onToolCalls?.({ turnKey, userId, toolCalls });
+                    },
+                    onToolResult: (event) => {
+                        opts.onToolResult?.({
+                            turnKey,
+                            userId,
+                            toolCall: event.toolCall,
+                            toolResult: event.toolResult,
+                        });
+                    },
+                });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                opts.onAssistantMessage?.({
+                    turnKey: `telegram:${ctx.chat.id}:${ctx.message.message_id}`,
+                    userId,
+                    content: `Error: ${msg.slice(0, TELEGRAM_MAX_MESSAGE)}`,
+                    done: true,
+                });
+                try {
+                    await ctx.reply(`Error: ${msg.slice(0, TELEGRAM_MAX_MESSAGE)}`);
+                }
+                catch {
+                    /* user blocked bot or chat forbids messages */
+                }
+            }
+        });
+    });
+    bot.catch((err) => {
+        opts.onError?.(err instanceof Error ? err.message : String(err));
+    });
+    return {
+        start() {
+            if (running)
+                return;
+            running = true;
+            void bot
+                .start({
+                allowed_updates: ["message"],
+                drop_pending_updates: true,
+            })
+                .catch((err) => {
+                running = false;
+                opts.onError?.(err instanceof Error ? err.message : String(err));
+            });
+        },
+        async stop() {
+            if (!running)
+                return;
+            await bot.stop();
+            running = false;
+        },
+        async sendDm(userId, text) {
+            for (const part of splitTelegramMessage(text)) {
+                await bot.api.sendMessage(userId, part);
+            }
+        },
+    };
+}
+//# sourceMappingURL=bridge.js.map

package/dist/telegram/bridge.js.map

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

package/dist/telegram/index.d.ts

@@ -0,0 +1,3 @@
+export { createTelegramBridge, splitTelegramMessage } from "./bridge";
+export { approvePairingCode, clearPairingStore, registerPairingCode } from "./pairing";
+export { createTurnCoordinator } from "./turn-coordinator";

package/dist/telegram/index.js

@@ -0,0 +1,4 @@
+export { createTelegramBridge, splitTelegramMessage } from "./bridge";
+export { approvePairingCode, clearPairingStore, registerPairingCode } from "./pairing";
+export { createTurnCoordinator } from "./turn-coordinator";
+//# sourceMappingURL=index.js.map

package/dist/telegram/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telegram/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/telegram/limits.d.ts

@@ -0,0 +1,3 @@
+/** Telegram text message hard limit (characters). */
+export declare const TELEGRAM_MAX_MESSAGE = 4096;
+export declare function splitTelegramMessage(text: string): string[];

package/dist/telegram/limits.js

@@ -0,0 +1,12 @@
+/** Telegram text message hard limit (characters). */
+export const TELEGRAM_MAX_MESSAGE = 4096;
+export function splitTelegramMessage(text) {
+    if (!text)
+        return [];
+    const parts = [];
+    for (let i = 0; i < text.length; i += TELEGRAM_MAX_MESSAGE) {
+        parts.push(text.slice(i, i + TELEGRAM_MAX_MESSAGE));
+    }
+    return parts;
+}
+//# sourceMappingURL=limits.js.map

package/dist/telegram/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/telegram/limits.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,oBAAoB,EAAE,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/telegram/pairing.d.ts

@@ -0,0 +1,9 @@
+export declare function registerPairingCode(userId: number): string;
+export declare function approvePairingCode(code: string): {
+    ok: true;
+    userId: number;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function clearPairingStore(): void;

package/dist/telegram/pairing.js

@@ -0,0 +1,30 @@
+import { randomBytes } from "node:crypto";
+const PAIRING_TTL_MS = 60 * 60 * 1000;
+/** code (uppercase) -> { userId, expiresAt } */
+const pendingByCode = new Map();
+function generateCode() {
+    const hex = randomBytes(4).toString("hex").slice(0, 6).toUpperCase();
+    return hex;
+}
+export function registerPairingCode(userId) {
+    const code = generateCode();
+    pendingByCode.set(code, { userId, expiresAt: Date.now() + PAIRING_TTL_MS });
+    return code;
+}
+export function approvePairingCode(code) {
+    const normalized = code.trim().toUpperCase();
+    const entry = pendingByCode.get(normalized);
+    if (!entry) {
+        return { ok: false, error: "Unknown or expired code." };
+    }
+    if (Date.now() > entry.expiresAt) {
+        pendingByCode.delete(normalized);
+        return { ok: false, error: "Code expired. Send /pair again in Telegram." };
+    }
+    pendingByCode.delete(normalized);
+    return { ok: true, userId: entry.userId };
+}
+export function clearPairingStore() {
+    pendingByCode.clear();
+}
+//# sourceMappingURL=pairing.js.map

package/dist/telegram/pairing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.js","sourceRoot":"","sources":["../../src/telegram/pairing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtC,gDAAgD;AAChD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAiD,CAAC;AAE/E,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACrE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC;IAC5E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;QACjC,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;IAC7E,CAAC;IACD,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,aAAa,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC"}

package/dist/telegram/preview-stream.d.ts

@@ -0,0 +1,22 @@
+import type { Api } from "grammy";
+import type { StreamChunk } from "../types/index";
+export interface TelegramPartialReplyArgs {
+    chatId: number | string;
+    messageThreadId?: number;
+    typingIndicator: boolean;
+    stream: AsyncIterable<StreamChunk>;
+    onAssistantMessage?: (event: {
+        content: string;
+        done: boolean;
+    }) => void;
+    onToolCalls?: (toolCalls: NonNullable<StreamChunk["toolCalls"]>) => void;
+    onToolResult?: (event: {
+        toolCall: NonNullable<StreamChunk["toolCall"]>;
+        toolResult: NonNullable<StreamChunk["toolResult"]>;
+    }) => void;
+}
+/**
+ * Sends a live-updating preview (send + throttled editMessageText), then finalizes.
+ * Falls back to buffer-then-send if the initial message cannot be sent.
+ */
+export declare function runTelegramPartialReply(api: Api, args: TelegramPartialReplyArgs): Promise<void>;

package/dist/telegram/preview-stream.js

@@ -0,0 +1,181 @@
+import { GrammyError } from "grammy";
+import { splitTelegramMessage, TELEGRAM_MAX_MESSAGE } from "./limits";
+import { startTypingRefresh } from "./typing-refresh";
+const EDIT_THROTTLE_MS = 350;
+const EDIT_MIN_CHARS = 48;
+const MAX_API_RETRIES = 12;
+/** Bot API allows `message_thread_id` for forum topics; @grammyjs/types may omit it on `editMessageText`. */
+function editThreadOpts(messageThreadId) {
+    return messageThreadId !== undefined ? { message_thread_id: messageThreadId } : {};
+}
+async function withRetry(fn) {
+    let lastErr;
+    for (let i = 0; i < MAX_API_RETRIES; i++) {
+        try {
+            return await fn();
+        }
+        catch (e) {
+            lastErr = e;
+            if (e instanceof GrammyError && e.error_code === 429) {
+                const retryAfter = Number(e.parameters.retry_after ?? 1) * 1000;
+                await new Promise((r) => setTimeout(r, retryAfter));
+                continue;
+            }
+            throw e;
+        }
+    }
+    throw lastErr;
+}
+/** Same text as before — not an error; avoid treating as preview failure. */
+function isMessageNotModified(err) {
+    return (err instanceof GrammyError &&
+        err.error_code === 400 &&
+        typeof err.description === "string" &&
+        err.description.toLowerCase().includes("message is not modified"));
+}
+/** Telegram requires non-empty text; use zero-width space so nothing visible appears before real tokens. */
+const EMPTY_PREVIEW_PLACEHOLDER = "\u200b";
+function previewBody(acc) {
+    if (!acc)
+        return EMPTY_PREVIEW_PLACEHOLDER;
+    return acc.length > TELEGRAM_MAX_MESSAGE ? acc.slice(0, TELEGRAM_MAX_MESSAGE) : acc;
+}
+/**
+ * Sends a live-updating preview (send + throttled editMessageText), then finalizes.
+ * Falls back to buffer-then-send if the initial message cannot be sent.
+ */
+export async function runTelegramPartialReply(api, args) {
+    const { chatId, messageThreadId, typingIndicator, stream, onAssistantMessage, onToolCalls, onToolResult } = args;
+    const stopTyping = startTypingRefresh(api, chatId, messageThreadId, typingIndicator);
+    const sendParts = async (parts) => {
+        for (const part of parts) {
+            await withRetry(() => api.sendMessage(chatId, part, { message_thread_id: messageThreadId }));
+        }
+    };
+    let previewMessageId;
+    /** First sendMessage failed — finish with sendParts only. */
+    let previewCreateFailed = false;
+    let acc = "";
+    let previewBroken = false;
+    let lastEditAt = 0;
+    let lastEditLen = 0;
+    /** First real message is sent only after assistant text exists so sendChatAction(typing) stays visible until then. */
+    const ensurePreviewMessage = async () => {
+        if (previewMessageId !== undefined || previewCreateFailed || !acc)
+            return;
+        try {
+            const sent = await withRetry(() => api.sendMessage(chatId, previewBody(acc), { message_thread_id: messageThreadId }));
+            if (!sent.message_id) {
+                previewCreateFailed = true;
+                return;
+            }
+            previewMessageId = sent.message_id;
+        }
+        catch {
+            previewCreateFailed = true;
+        }
+    };
+    const flushEdit = async (force) => {
+        if (previewMessageId === undefined || previewBroken)
+            return;
+        const messageId = previewMessageId;
+        const now = Date.now();
+        const delta = acc.length - lastEditLen;
+        if (!force && now - lastEditAt < EDIT_THROTTLE_MS && delta < EDIT_MIN_CHARS)
+            return;
+        try {
+            await withRetry(() => api.editMessageText(chatId, messageId, previewBody(acc), editThreadOpts(messageThreadId)));
+            lastEditAt = Date.now();
+            lastEditLen = acc.length;
+        }
+        catch (e) {
+            if (isMessageNotModified(e)) {
+                lastEditAt = Date.now();
+                lastEditLen = acc.length;
+                return;
+            }
+            previewBroken = true;
+        }
+    };
+    try {
+        try {
+            for await (const chunk of stream) {
+                switch (chunk.type) {
+                    case "content":
+                        if (chunk.content) {
+                            acc += chunk.content;
+                            onAssistantMessage?.({ content: acc, done: false });
+                            await ensurePreviewMessage();
+                            await flushEdit(false);
+                        }
+                        break;
+                    case "tool_calls":
+                        if (chunk.toolCalls) {
+                            onToolCalls?.(chunk.toolCalls);
+                        }
+                        break;
+                    case "tool_result":
+                        if (chunk.toolCall && chunk.toolResult) {
+                            onToolResult?.({ toolCall: chunk.toolCall, toolResult: chunk.toolResult });
+                        }
+                        break;
+                }
+            }
+        }
+        catch (err) {
+            await flushEdit(true);
+            const msg = err instanceof Error ? err.message : String(err);
+            const errText = `Error: ${msg.slice(0, TELEGRAM_MAX_MESSAGE)}`;
+            onAssistantMessage?.({ content: errText, done: true });
+            if (previewMessageId !== undefined && !previewBroken) {
+                const messageId = previewMessageId;
+                try {
+                    await withRetry(() => api.editMessageText(chatId, messageId, errText, editThreadOpts(messageThreadId)));
+                }
+                catch {
+                    await sendParts(splitTelegramMessage(errText));
+                }
+            }
+            else {
+                await sendParts(splitTelegramMessage(errText));
+            }
+            return;
+        }
+        await flushEdit(true);
+        const trimmed = acc.trim() || "(no text output)";
+        const parts = splitTelegramMessage(trimmed);
+        onAssistantMessage?.({ content: trimmed, done: true });
+        if (previewMessageId === undefined) {
+            await sendParts(parts);
+            return;
+        }
+        if (parts.length === 0) {
+            if (!previewBroken) {
+                const messageId = previewMessageId;
+                await withRetry(() => api.editMessageText(chatId, messageId, "(no text output)", editThreadOpts(messageThreadId)));
+            }
+            return;
+        }
+        if (previewBroken) {
+            await sendParts(parts);
+            return;
+        }
+        const messageId = previewMessageId;
+        try {
+            await withRetry(() => api.editMessageText(chatId, messageId, parts[0], editThreadOpts(messageThreadId)));
+        }
+        catch (e) {
+            if (!isMessageNotModified(e)) {
+                await sendParts(parts);
+                return;
+            }
+        }
+        if (parts.length > 1) {
+            await sendParts(parts.slice(1));
+        }
+    }
+    finally {
+        stopTyping();
+    }
+}
+//# sourceMappingURL=preview-stream.js.map

package/dist/telegram/preview-stream.js.map

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

package/dist/telegram/turn-coordinator.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Serialize async turns (local TUI + Telegram) so only one Agent.processMessage runs at a time.
+ */
+export declare function createTurnCoordinator(): {
+    run<T>(fn: () => Promise<T>): Promise<T>;
+};
+export type TurnCoordinator = ReturnType<typeof createTurnCoordinator>;

package/dist/telegram/turn-coordinator.js

@@ -0,0 +1,14 @@
+/**
+ * Serialize async turns (local TUI + Telegram) so only one Agent.processMessage runs at a time.
+ */
+export function createTurnCoordinator() {
+    let chain = Promise.resolve();
+    return {
+        run(fn) {
+            const result = chain.then(() => fn());
+            chain = result.then(() => { }, () => { });
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=turn-coordinator.js.map

package/dist/telegram/turn-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-coordinator.js","sourceRoot":"","sources":["../../src/telegram/turn-coordinator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,KAAK,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEhD,OAAO;QACL,GAAG,CAAI,EAAoB;YACzB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,KAAK,GAAG,MAAM,CAAC,IAAI,CACjB,GAAG,EAAE,GAAE,CAAC,EACR,GAAG,EAAE,GAAE,CAAC,CACT,CAAC;YACF,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/telegram/typing-refresh.d.ts

@@ -0,0 +1,3 @@
+import type { Api } from "grammy";
+/** Repeats `sendChatAction(typing)` until `stop()` is called. No-op when `enabled` is false. */
+export declare function startTypingRefresh(api: Api, chatId: number | string, messageThreadId: number | undefined, enabled: boolean): () => void;

package/dist/telegram/typing-refresh.js

@@ -0,0 +1,12 @@
+/** Telegram clears typing after ~5s; refresh before that so the indicator stays visible. */
+const TYPING_REFRESH_MS = 3500;
+/** Repeats `sendChatAction(typing)` until `stop()` is called. No-op when `enabled` is false. */
+export function startTypingRefresh(api, chatId, messageThreadId, enabled) {
+    if (!enabled)
+        return () => { };
+    const tick = () => void api.sendChatAction(chatId, "typing", { message_thread_id: messageThreadId }).catch(() => { });
+    tick();
+    const id = setInterval(tick, TYPING_REFRESH_MS);
+    return () => clearInterval(id);
+}
+//# sourceMappingURL=typing-refresh.js.map

package/dist/telegram/typing-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-refresh.js","sourceRoot":"","sources":["../../src/telegram/typing-refresh.ts"],"names":[],"mappings":"AAEA,4FAA4F;AAC5F,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,gGAAgG;AAChG,MAAM,UAAU,kBAAkB,CAChC,GAAQ,EACR,MAAuB,EACvB,eAAmC,EACnC,OAAgB;IAEhB,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,KAAK,GAAG,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACrH,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAChD,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC"}