@nodetool-ai/telegram 0.8.1

package/dist/telegram-adapter.js

@@ -0,0 +1,366 @@
+/**
+ * TelegramAdapter — the only module that knows Telegram (design §3).
+ *
+ * Two directions meet here. Inbound: `getUpdates` long polling, private-chat
+ * and command routing, the unlinked-user prompt, group declines. Outbound: the
+ * renderer's ops become Bot API calls, with the platform's two facts of life
+ * handled rather than hoped away — 429 `retry_after`, and the parse mode
+ * rejecting text, which falls back to plain rather than failing the turn.
+ *
+ * Ops are executed off a per-chat queue. That queue is what makes superseded
+ * edits droppable: while a backoff holds the head of the queue, later edits to
+ * the same message pile up behind it, and only the last one is worth sending.
+ */
+import { BotApiError, TELEGRAM_UPLOAD_LIMIT_BYTES } from "./bot-api.js";
+import { MESSAGES, handleCommand, isAllowedUser, parseCommand } from "./commands.js";
+/** Long-poll seconds asked of `getUpdates`. */
+export const POLL_TIMEOUT_SECONDS = 50;
+/** Callback data on the inline stop button. */
+export const STOP_CALLBACK_DATA = "stop";
+function defaultWait(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isPhoto(contentType, filename) {
+    if (contentType !== null) {
+        return contentType.startsWith("image/") && !contentType.includes("svg");
+    }
+    return /\.(jpe?g|png|webp)$/i.test(filename);
+}
+export class TelegramAdapter {
+    api;
+    identity;
+    router;
+    config;
+    fetchImpl;
+    wait;
+    resolveAsset;
+    log;
+    offset = 0;
+    running = false;
+    messages = new Map();
+    queues = new Map();
+    declinedGroups = new Set();
+    constructor(options) {
+        this.api = options.api;
+        this.identity = options.identity;
+        this.router = options.router;
+        this.config = options.config;
+        this.fetchImpl = options.fetch;
+        this.wait = options.wait ?? defaultWait;
+        this.resolveAsset = options.resolveAsset ?? null;
+        this.log = options.log ?? ((message, detail) => console.error(message, detail ?? ""));
+    }
+    /**
+     * Long-poll until {@link stop} is called.
+     *
+     * A 409 means another process holds this bot token's update stream — two
+     * consumers silently steal each other's updates, so the loop ends and says
+     * so instead of fighting for them.
+     */
+    async poll() {
+        this.running = true;
+        while (this.running) {
+            let updates;
+            try {
+                updates = await this.api.getUpdates(this.offset, POLL_TIMEOUT_SECONDS);
+            }
+            catch (err) {
+                if (err instanceof BotApiError && err.isConflict) {
+                    this.log("[telegram] another getUpdates consumer holds this bot token — " +
+                        "stop the other bridge instance (or delete the webhook) and start again.");
+                    this.running = false;
+                    return "conflict";
+                }
+                if (err instanceof BotApiError && err.retryAfterSeconds !== null) {
+                    await this.wait(err.retryAfterSeconds * 1000);
+                    continue;
+                }
+                if (err instanceof BotApiError && err.status === 401) {
+                    this.log(`[telegram] ${err.message}`);
+                    this.running = false;
+                    return "fatal";
+                }
+                this.log("[telegram] getUpdates failed:", err);
+                await this.wait(1000);
+                continue;
+            }
+            for (const update of updates) {
+                this.offset = Math.max(this.offset, update.update_id + 1);
+                try {
+                    await this.handleUpdate(update);
+                }
+                catch (err) {
+                    this.log("[telegram] failed to handle update:", err);
+                }
+            }
+        }
+        return "stopped";
+    }
+    /** Ask the poll loop to end after the in-flight request. */
+    stop() {
+        this.running = false;
+    }
+    /** Wait until every queued op has been executed. */
+    async flush() {
+        for (const queue of this.queues.values()) {
+            await queue.draining;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Inbound
+    // -------------------------------------------------------------------------
+    async handleUpdate(update) {
+        if (update.callback_query) {
+            await this.handleCallbackQuery(update.callback_query);
+            return;
+        }
+        const message = update.message;
+        if (message) {
+            await this.handleMessage(message);
+        }
+    }
+    async handleCallbackQuery(query) {
+        const chatId = query.message ? String(query.message.chat.id) : null;
+        if (query.data !== STOP_CALLBACK_DATA || chatId === null) {
+            await this.api.answerCallbackQuery(query.id);
+            return;
+        }
+        const stopped = this.router.stop(chatId);
+        await this.api.answerCallbackQuery(query.id, stopped ? MESSAGES.stopping : MESSAGES.nothingRunning);
+    }
+    async handleMessage(message) {
+        const chatId = String(message.chat.id);
+        const telegramUserId = message.from ? String(message.from.id) : null;
+        if (telegramUserId === null) {
+            return;
+        }
+        if (message.chat.type !== "private") {
+            if (!this.declinedGroups.has(chatId)) {
+                this.declinedGroups.add(chatId);
+                await this.sendPlain(chatId, MESSAGES.groupDecline);
+            }
+            return;
+        }
+        if (!isAllowedUser(this.config.allowUsers, telegramUserId)) {
+            await this.sendPlain(chatId, MESSAGES.notAllowed);
+            return;
+        }
+        const text = message.text ?? message.caption ?? "";
+        const command = text.length > 0 ? parseCommand(text, message.entities) : null;
+        if (command !== null) {
+            const outcome = await handleCommand(this.commandDeps(), {
+                command: command.command,
+                args: command.args,
+                chatId,
+                telegramUserId
+            });
+            for (const reply of outcome.replies) {
+                await this.sendPlain(chatId, reply);
+            }
+            return;
+        }
+        if (text.length === 0) {
+            await this.sendPlain(chatId, MESSAGES.unsupportedMedia);
+            return;
+        }
+        const result = await this.router.submit({ telegramUserId, chatId, text });
+        if (result.status === "unlinked") {
+            await this.sendPlain(chatId, result.reason === "local-mode" ? result.message : MESSAGES.linkPrompt);
+            return;
+        }
+        if (result.status === "busy") {
+            await this.sendPlain(chatId, MESSAGES.busy);
+        }
+    }
+    commandDeps() {
+        return {
+            identity: this.identity,
+            router: this.router,
+            apiUrl: this.config.apiUrl,
+            fetch: this.fetchImpl,
+            allowUsers: this.config.allowUsers
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Outbound
+    // -------------------------------------------------------------------------
+    /**
+     * Accept a batch of render ops for delivery. Returns once the ops are
+     * queued; the per-chat drain loop executes them in order.
+     */
+    executeOps = (context, ops) => {
+        const queue = this.queueFor(context.chatId);
+        for (const op of ops) {
+            queue.ops.push({ op, context });
+        }
+        if (queue.draining === null) {
+            queue.draining = this.drain(context.chatId, queue).finally(() => {
+                queue.draining = null;
+            });
+        }
+    };
+    queueFor(chatId) {
+        let queue = this.queues.get(chatId);
+        if (!queue) {
+            queue = { ops: [], draining: null };
+            this.queues.set(chatId, queue);
+        }
+        return queue;
+    }
+    async drain(chatId, queue) {
+        while (queue.ops.length > 0) {
+            const entry = queue.ops.shift();
+            if (entry === undefined) {
+                return;
+            }
+            if (this.isSuperseded(entry.op, queue)) {
+                continue;
+            }
+            try {
+                await this.executeOne(chatId, entry);
+            }
+            catch (err) {
+                if (err instanceof BotApiError && err.retryAfterSeconds !== null) {
+                    await this.wait(err.retryAfterSeconds * 1000);
+                    // Re-queue at the head; the supersede check runs again, so a newer
+                    // edit of the same message wins over this one.
+                    queue.ops.unshift(entry);
+                    continue;
+                }
+                this.log("[telegram] render op failed:", err);
+            }
+        }
+    }
+    /** An intermediate edit nothing will see, because a later one is queued. */
+    isSuperseded(op, queue) {
+        if (op.kind !== "edit") {
+            return false;
+        }
+        return queue.ops.some((entry) => (entry.op.kind === "edit" || entry.op.kind === "finalize") &&
+            entry.op.target === op.target);
+    }
+    async executeOne(chatId, entry) {
+        const { op, context } = entry;
+        const state = this.messagesFor(chatId);
+        switch (op.kind) {
+            case "typing":
+                await this.api.sendChatAction(chatId, "typing");
+                return;
+            case "send": {
+                const sent = await this.send(chatId, op.text, op.parseMode, op.target === "status");
+                state[op.target] = sent;
+                return;
+            }
+            case "edit": {
+                const messageId = state[op.target];
+                if (messageId === null) {
+                    state[op.target] = await this.send(chatId, op.text, op.parseMode, op.target === "status");
+                    return;
+                }
+                await this.edit(chatId, messageId, op.text, op.parseMode);
+                return;
+            }
+            case "finalize": {
+                const messageId = state[op.target];
+                if (op.create || messageId === null) {
+                    await this.send(chatId, op.text, op.parseMode, false);
+                }
+                else {
+                    await this.edit(chatId, messageId, op.text, op.parseMode);
+                }
+                state[op.target] = null;
+                return;
+            }
+            case "stop-note":
+                await this.sendPlain(chatId, op.text);
+                return;
+            case "attach":
+                await this.attach(chatId, op.asset, context);
+                return;
+            default:
+                return;
+        }
+    }
+    messagesFor(chatId) {
+        let state = this.messages.get(chatId);
+        if (!state) {
+            state = { status: null, stream: null };
+            this.messages.set(chatId, state);
+        }
+        return state;
+    }
+    async send(chatId, text, parseMode, withStopButton) {
+        const payload = { chat_id: chatId, text };
+        if (parseMode === "html") {
+            payload.parse_mode = "HTML";
+        }
+        if (withStopButton) {
+            payload.reply_markup = {
+                inline_keyboard: [[{ text: "⏹ Stop", callback_data: STOP_CALLBACK_DATA }]]
+            };
+        }
+        try {
+            const sent = await this.api.sendMessage(payload);
+            return sent.message_id;
+        }
+        catch (err) {
+            if (err instanceof BotApiError && err.isParseFailure) {
+                delete payload.parse_mode;
+                const sent = await this.api.sendMessage(payload);
+                return sent.message_id;
+            }
+            throw err;
+        }
+    }
+    async edit(chatId, messageId, text, parseMode) {
+        const payload = {
+            chat_id: chatId,
+            message_id: messageId,
+            text
+        };
+        if (parseMode === "html") {
+            payload.parse_mode = "HTML";
+        }
+        try {
+            await this.api.editMessageText(payload);
+        }
+        catch (err) {
+            if (err instanceof BotApiError && err.isUnmodified) {
+                // The message already shows this text; nothing to do.
+                return;
+            }
+            if (err instanceof BotApiError && err.isParseFailure) {
+                delete payload.parse_mode;
+                await this.api.editMessageText(payload);
+                return;
+            }
+            throw err;
+        }
+    }
+    async sendPlain(chatId, text) {
+        await this.api.sendMessage({ chat_id: chatId, text });
+    }
+    async attach(chatId, asset, context) {
+        if (this.resolveAsset === null) {
+            await this.sendPlain(chatId, `📎 ${asset.name ?? asset.uri}`);
+            return;
+        }
+        const resolved = await this.resolveAsset(asset, context);
+        if (resolved === null) {
+            await this.sendPlain(chatId, `📎 ${asset.name ?? asset.uri}`);
+            return;
+        }
+        if (resolved.bytes.byteLength > TELEGRAM_UPLOAD_LIMIT_BYTES) {
+            await this.sendPlain(chatId, `📎 too large for Telegram: ${asset.uri}`);
+            return;
+        }
+        const photo = isPhoto(resolved.contentType, resolved.filename);
+        const form = new FormData();
+        form.append("chat_id", chatId);
+        form.append(photo ? "photo" : "document", new Blob([resolved.bytes], {
+            type: resolved.contentType ?? "application/octet-stream"
+        }), resolved.filename);
+        await this.api.callMultipart(photo ? "sendPhoto" : "sendDocument", form);
+    }
+}
+//# sourceMappingURL=telegram-adapter.js.map

package/dist/telegram-adapter.js.map

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

package/dist/turn-router.d.ts

@@ -0,0 +1,167 @@
+/**
+ * TurnRouter — one turn at a time per conversation, one socket per user
+ * (design §6).
+ *
+ * The router is where identity, the chat socket and the pure frame renderer
+ * meet. It owns three things the other modules deliberately do not:
+ *
+ * - **Whose socket.** A Telegram user's turns run on a `ChatSocket` opened
+ *   with that user's delegated token, so every turn is the server's own
+ *   tenant-isolated path. Two users never share a socket.
+ * - **Turn order.** A private chat is one conversation: a second message while
+ *   a turn runs queues behind it (capped), mirroring the server's per-thread
+ *   turn lock instead of racing it.
+ * - **The clock.** `foldFrame` is clockless by construction; this layer is
+ *   where `Date.now()` enters, which keeps the renderer's throttling rules
+ *   exercisable by scripted tests.
+ *
+ * Nothing here imports the Telegram API or the NodeTool SDK: the socket, the
+ * thread listing and the delivery of render ops are all injected.
+ */
+import type { RenderFrame, RenderOp } from "./frame-renderer.js";
+import type { IdentityResolution, UnlinkedReason } from "./identity-client.js";
+/** The identity surface the router needs — a subset of `IdentityClient`. */
+export interface IdentityResolver {
+    resolve(externalId: string): Promise<IdentityResolution>;
+    invalidate(externalId: string): void;
+}
+/** One outbound turn, in the shape the server's `chat_message` command takes. */
+export interface BridgeSendOptions {
+    readonly threadId: string;
+    readonly text: string;
+    readonly provider?: string | null;
+    readonly model?: string | null;
+    readonly agentMode?: boolean;
+    readonly permissionMode?: "plan" | "default" | "auto" | null;
+}
+/**
+ * The chat socket, narrowed to what the bridge uses. `@nodetool-ai/sdk`'s
+ * `ChatSocket` is wrapped into this shape in `nodetool-client.ts`, so the
+ * router stays free of the SDK — and of `ws`.
+ */
+export interface BridgeChatSocket {
+    connect(): void;
+    disconnect(): void;
+    send(options: BridgeSendOptions): void;
+    stop(threadId: string): void;
+    /** Replay everything after `lastSeq` on this thread (`resume_chat`). */
+    resume(threadId: string, lastSeq: number): void;
+    /** Every inbound frame, including types without a typed handler. */
+    onFrame(listener: (frame: RenderFrame) => void): () => void;
+    /** Connection-state transitions; `connected` after a drop triggers resume. */
+    onStateChange(listener: (state: string) => void): () => void;
+}
+/** A connected NodeTool client bound to one user's delegated token. */
+export interface BridgeClient {
+    readonly socket: BridgeChatSocket;
+    /** Thread ids owned by this user, for `n` recovery after a restart. */
+    listThreadIds(): Promise<readonly string[]>;
+}
+export type MakeBridgeClient = (session: {
+    readonly token: string;
+    readonly userId: string;
+}) => BridgeClient;
+/** Everything the adapter needs to place a turn's ops in the right chat. */
+export interface DeliveryContext {
+    readonly chatId: string;
+    readonly telegramUserId: string;
+    /** NodeTool user the turn runs as. */
+    readonly userId: string;
+    readonly threadId: string;
+    /** Delegated token, so the adapter can fetch the user's own assets. */
+    readonly token: string;
+}
+export type ExecuteOps = (context: DeliveryContext, ops: readonly RenderOp[]) => void | Promise<void>;
+export interface TurnRouterOptions {
+    readonly identity: IdentityResolver;
+    readonly makeClient: MakeBridgeClient;
+    readonly config: TurnRouterConfig;
+    readonly executeOps: ExecuteOps;
+    /** Clock, in ms. Defaults to `Date.now`. */
+    readonly nowMs?: () => number;
+}
+export interface TurnRouterConfig {
+    readonly editThrottleMs: number;
+    readonly maxQueuedTurns: number;
+    /** Provider override for every turn; null leaves the server's default. */
+    readonly provider?: string | null;
+    readonly model?: string | null;
+    /**
+     * There is no interactive approver on this surface, so `auto` is the mode
+     * that makes a turn complete rather than park forever (design §9).
+     */
+    readonly permissionMode?: "plan" | "default" | "auto";
+}
+export type SubmitResult = {
+    readonly status: "started";
+    readonly threadId: string;
+} | {
+    readonly status: "queued";
+    readonly threadId: string;
+    readonly depth: number;
+} | {
+    readonly status: "busy";
+    readonly depth: number;
+} | {
+    readonly status: "unlinked";
+    readonly reason: UnlinkedReason;
+    readonly message: string;
+};
+export interface SubmitInput {
+    readonly telegramUserId: string;
+    readonly chatId: string;
+    readonly text: string;
+}
+/** `telegram-<chatId>-<uid8>-<n>`. */
+export declare function deriveThreadId(chatId: string, uid8: string, index: number): string;
+/** The short user hash that keeps two tenants' derived ids disjoint. */
+export declare function userHash8(userId: string): string;
+/** Highest `n` among ids already in this chat's series, or 0 when there is none. */
+export declare function highestThreadIndex(threadIds: readonly string[], chatId: string, uid8: string): number;
+export declare class TurnRouter {
+    private readonly identity;
+    private readonly makeClient;
+    private readonly config;
+    private readonly executeOps;
+    private readonly now;
+    private readonly sessions;
+    private readonly conversations;
+    private readonly byThread;
+    constructor(options: TurnRouterOptions);
+    /**
+     * Take one inbound message. Starts a turn when the conversation is idle,
+     * queues it when a turn is running, and answers busy when the queue is full.
+     */
+    submit(input: SubmitInput): Promise<SubmitResult>;
+    /** Cancel the in-flight turn in this chat. False when nothing was running. */
+    stop(chatId: string): boolean;
+    /**
+     * Rotate this chat onto a fresh thread (`/new`). Anything queued behind the
+     * current turn is dropped: the user asked for a clean slate, and delivering
+     * old messages into a new thread would be the opposite.
+     */
+    newThread(chatId: string): string | null;
+    /** Current thread id for a chat, when one has been established. */
+    currentThreadId(chatId: string): string | null;
+    /** Messages waiting behind the in-flight turn, for `/status`. */
+    queueDepth(chatId: string): number;
+    /** Whether a turn is in flight in this chat. */
+    isRunning(chatId: string): boolean;
+    /**
+     * Drop a user's session and cached token after the server rejects it. The
+     * next turn mints a fresh token and opens a new socket, rather than retrying
+     * a credential the server has already refused.
+     */
+    invalidateSession(telegramUserId: string): void;
+    /** Close every socket. */
+    close(): void;
+    private ensureSession;
+    private ensureConversation;
+    private startTurn;
+    private resumeRunningTurns;
+    private handleFrame;
+    private locateConversation;
+    private deliver;
+    private finishTurn;
+}
+//# sourceMappingURL=turn-router.d.ts.map

package/dist/turn-router.d.ts.map

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