@nodetool-ai/telegram 0.8.1

package/dist/turn-router.js

@@ -0,0 +1,360 @@
+/**
+ * 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 { createHash } from "node:crypto";
+import { createRendererState, foldFrame } from "./frame-renderer.js";
+/** Frames carry `chat_seq` on the wire; the renderer reads `seq`. */
+function normalizeFrame(frame) {
+    const carried = frame.chat_seq;
+    if (typeof carried === "number" && typeof frame.seq !== "number") {
+        return { ...frame, seq: carried };
+    }
+    return frame;
+}
+function threadIdOf(frame) {
+    const value = frame.thread_id;
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+/** `telegram-<chatId>-<uid8>-<n>`. */
+export function deriveThreadId(chatId, uid8, index) {
+    return `telegram-${chatId}-${uid8}-${index}`;
+}
+/** The short user hash that keeps two tenants' derived ids disjoint. */
+export function userHash8(userId) {
+    return createHash("sha256").update(userId).digest("hex").slice(0, 8);
+}
+/** Highest `n` among ids already in this chat's series, or 0 when there is none. */
+export function highestThreadIndex(threadIds, chatId, uid8) {
+    const prefix = `telegram-${chatId}-${uid8}-`;
+    let highest = 0;
+    for (const id of threadIds) {
+        if (!id.startsWith(prefix)) {
+            continue;
+        }
+        const index = Number.parseInt(id.slice(prefix.length), 10);
+        if (Number.isInteger(index) && index > highest) {
+            highest = index;
+        }
+    }
+    return highest;
+}
+// ---------------------------------------------------------------------------
+// Router
+// ---------------------------------------------------------------------------
+export class TurnRouter {
+    identity;
+    makeClient;
+    config;
+    executeOps;
+    now;
+    sessions = new Map();
+    conversations = new Map();
+    byThread = new Map();
+    constructor(options) {
+        this.identity = options.identity;
+        this.makeClient = options.makeClient;
+        this.config = options.config;
+        this.executeOps = options.executeOps;
+        this.now = options.nowMs ?? Date.now;
+    }
+    /**
+     * 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.
+     */
+    async submit(input) {
+        const resolution = await this.identity.resolve(input.telegramUserId);
+        if (resolution.unlinked) {
+            return {
+                status: "unlinked",
+                reason: resolution.reason,
+                message: resolution.message
+            };
+        }
+        const session = this.ensureSession(input.telegramUserId, resolution.token, resolution.userId);
+        const conversation = await this.ensureConversation(session, input.chatId);
+        if (conversation.running !== null) {
+            if (conversation.queue.length >= this.config.maxQueuedTurns) {
+                return { status: "busy", depth: conversation.queue.length };
+            }
+            conversation.queue.push({ text: input.text });
+            return {
+                status: "queued",
+                threadId: deriveThreadId(conversation.chatId, session.uid8, conversation.threadIndex),
+                depth: conversation.queue.length
+            };
+        }
+        const threadId = this.startTurn(session, conversation, input.text);
+        return { status: "started", threadId };
+    }
+    /** Cancel the in-flight turn in this chat. False when nothing was running. */
+    stop(chatId) {
+        const conversation = this.conversations.get(chatId);
+        if (!conversation || conversation.running === null) {
+            return false;
+        }
+        const session = this.sessions.get(conversation.telegramUserId);
+        if (!session) {
+            return false;
+        }
+        session.client.socket.stop(conversation.running.threadId);
+        return true;
+    }
+    /**
+     * 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) {
+        const conversation = this.conversations.get(chatId);
+        const session = conversation ? this.sessions.get(conversation.telegramUserId) : undefined;
+        if (!conversation || !session) {
+            return null;
+        }
+        conversation.queue.length = 0;
+        if (conversation.running !== null) {
+            this.byThread.delete(conversation.running.threadId);
+            conversation.running = null;
+        }
+        conversation.threadIndex += 1;
+        return deriveThreadId(chatId, session.uid8, conversation.threadIndex);
+    }
+    /** Current thread id for a chat, when one has been established. */
+    currentThreadId(chatId) {
+        const conversation = this.conversations.get(chatId);
+        const session = conversation ? this.sessions.get(conversation.telegramUserId) : undefined;
+        if (!conversation || !session) {
+            return null;
+        }
+        return deriveThreadId(chatId, session.uid8, conversation.threadIndex);
+    }
+    /** Messages waiting behind the in-flight turn, for `/status`. */
+    queueDepth(chatId) {
+        return this.conversations.get(chatId)?.queue.length ?? 0;
+    }
+    /** Whether a turn is in flight in this chat. */
+    isRunning(chatId) {
+        return this.conversations.get(chatId)?.running != null;
+    }
+    /**
+     * 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) {
+        const session = this.sessions.get(telegramUserId);
+        if (!session) {
+            return;
+        }
+        session.dispose();
+        session.client.socket.disconnect();
+        this.sessions.delete(telegramUserId);
+        this.identity.invalidate(telegramUserId);
+    }
+    /** Close every socket. */
+    close() {
+        for (const session of this.sessions.values()) {
+            session.dispose();
+            session.client.socket.disconnect();
+        }
+        this.sessions.clear();
+        this.conversations.clear();
+        this.byThread.clear();
+    }
+    // -------------------------------------------------------------------------
+    ensureSession(telegramUserId, token, userId) {
+        const existing = this.sessions.get(telegramUserId);
+        if (existing && existing.token === token && existing.userId === userId) {
+            return existing;
+        }
+        if (existing) {
+            // A re-minted token means a new socket: the old one authenticated with
+            // a credential that is on its way out.
+            existing.dispose();
+            existing.client.socket.disconnect();
+            this.sessions.delete(telegramUserId);
+        }
+        const client = this.makeClient({ token, userId });
+        const unsubscribers = [];
+        const session = {
+            telegramUserId,
+            userId,
+            token,
+            uid8: userHash8(userId),
+            client,
+            dispose: () => {
+                for (const off of unsubscribers) {
+                    off();
+                }
+            },
+            recovered: existing?.recovered ?? new Set()
+        };
+        unsubscribers.push(client.socket.onFrame((frame) => this.handleFrame(session, frame)));
+        unsubscribers.push(client.socket.onStateChange((state) => {
+            if (state === "connected") {
+                this.resumeRunningTurns(session);
+            }
+        }));
+        client.socket.connect();
+        this.sessions.set(telegramUserId, session);
+        return session;
+    }
+    async ensureConversation(session, chatId) {
+        let conversation = this.conversations.get(chatId);
+        if (!conversation) {
+            conversation = {
+                chatId,
+                telegramUserId: session.telegramUserId,
+                threadIndex: 1,
+                queue: [],
+                running: null,
+                chain: Promise.resolve()
+            };
+            this.conversations.set(chatId, conversation);
+        }
+        if (session.recovered.has(chatId)) {
+            return conversation;
+        }
+        session.recovered.add(chatId);
+        try {
+            const ids = await session.client.listThreadIds();
+            const highest = highestThreadIndex(ids, chatId, session.uid8);
+            if (highest > 0) {
+                conversation.threadIndex = highest;
+            }
+        }
+        catch {
+            // The bridge keeps no conversation state, so a failed listing costs the
+            // user a new thread, not a broken turn.
+        }
+        return conversation;
+    }
+    startTurn(session, conversation, text) {
+        const threadId = deriveThreadId(conversation.chatId, session.uid8, conversation.threadIndex);
+        const running = {
+            threadId,
+            renderer: createRendererState({ editThrottleMs: this.config.editThrottleMs }),
+            lastSeq: 0,
+            sent: false
+        };
+        conversation.running = running;
+        this.byThread.set(threadId, conversation);
+        session.client.socket.send({
+            threadId,
+            text,
+            provider: this.config.provider ?? null,
+            model: this.config.model ?? null,
+            agentMode: true,
+            permissionMode: this.config.permissionMode ?? "auto"
+        });
+        running.sent = true;
+        return threadId;
+    }
+    resumeRunningTurns(session) {
+        for (const conversation of this.conversations.values()) {
+            if (conversation.telegramUserId !== session.telegramUserId) {
+                continue;
+            }
+            const running = conversation.running;
+            if (running === null || !running.sent) {
+                continue;
+            }
+            // The renderer suppresses any replayed frame it has already applied, so
+            // asking for one seq too many costs nothing and asking for one too few
+            // would lose text.
+            session.client.socket.resume(running.threadId, running.lastSeq);
+        }
+    }
+    handleFrame(session, raw) {
+        const frame = normalizeFrame(raw);
+        const conversation = this.locateConversation(session, frame);
+        if (!conversation) {
+            return;
+        }
+        const running = conversation.running;
+        if (running === null) {
+            return;
+        }
+        const result = foldFrame(running.renderer, frame, this.now());
+        running.renderer = result.state;
+        if (typeof result.state.lastSeq === "number") {
+            running.lastSeq = result.state.lastSeq;
+        }
+        if (result.ops.length > 0) {
+            const context = {
+                chatId: conversation.chatId,
+                telegramUserId: session.telegramUserId,
+                userId: session.userId,
+                threadId: running.threadId,
+                token: session.token
+            };
+            this.deliver(conversation, context, result.ops);
+        }
+        if (result.state.ended) {
+            this.finishTurn(session, conversation);
+        }
+    }
+    locateConversation(session, frame) {
+        const threadId = threadIdOf(frame);
+        if (threadId !== null) {
+            return this.byThread.get(threadId) ?? null;
+        }
+        // Frames the server does not stamp with a thread belong to the one turn
+        // this user has in flight; with several, guessing would put text in the
+        // wrong chat, so nothing is rendered.
+        let candidate = null;
+        for (const conversation of this.conversations.values()) {
+            if (conversation.telegramUserId !== session.telegramUserId) {
+                continue;
+            }
+            if (conversation.running === null) {
+                continue;
+            }
+            if (candidate !== null) {
+                return null;
+            }
+            candidate = conversation;
+        }
+        return candidate;
+    }
+    deliver(conversation, context, ops) {
+        conversation.chain = conversation.chain.then(async () => {
+            try {
+                await this.executeOps(context, ops);
+            }
+            catch (err) {
+                // One failed Bot API call must not stall every later op in the chat.
+                console.error("[telegram] failed to deliver render ops:", err);
+            }
+        });
+    }
+    finishTurn(session, conversation) {
+        const running = conversation.running;
+        if (running !== null) {
+            this.byThread.delete(running.threadId);
+        }
+        conversation.running = null;
+        const next = conversation.queue.shift();
+        if (next === undefined) {
+            return;
+        }
+        this.startTurn(session, conversation, next.text);
+    }
+}
+//# sourceMappingURL=turn-router.js.map

package/dist/turn-router.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@nodetool-ai/telegram",
+  "version": "0.8.1",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "nodetool-telegram": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-typescript-workspace.mjs",
+    "test": "node ../../scripts/run-vitest.mjs run",
+    "test:watch": "node ../../scripts/run-vitest.mjs",
+    "lint": "node ../../scripts/run-tsc.mjs --noEmit"
+  },
+  "dependencies": {
+    "@nodetool-ai/protocol": "^0.8.1",
+    "@nodetool-ai/sdk": "^0.8.1",
+    "ws": "^8.18.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.13",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "^5.0.1"
+  },
+  "exports": {
+    ".": {
+      "nodetool-dev": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nodetool-ai/nodetool.git",
+    "directory": "packages/telegram"
+  },
+  "homepage": "https://nodetool.ai",
+  "bugs": {
+    "url": "https://github.com/nodetool-ai/nodetool/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "description": "Telegram bridge for NodeTool — private-chat turns onto the server's unified agent loop",
+  "keywords": [
+    "nodetool",
+    "ai",
+    "workflow",
+    "workflow-automation",
+    "typescript",
+    "telegram",
+    "bot",
+    "chatbot",
+    "bridge"
+  ]
+}