@nodetool-ai/telegram 0.8.1

package/dist/markdown-html.js

@@ -0,0 +1,251 @@
+/**
+ * Agent markdown → Telegram HTML parse mode.
+ *
+ * MarkdownV2 makes every `.`, `-` and `(` in prose an escaping obligation, so
+ * one missed character fails the whole message. Telegram's HTML mode needs
+ * three characters escaped and supports the five tags this converter emits:
+ * `<b>`, `<i>`, `<code>`, `<pre>` and `<a href>`. Anything the converter
+ * cannot express — an unbalanced fence, markup it does not recognize as
+ * balanced — falls back to plain text, because a turn must never fail on
+ * formatting.
+ *
+ * Hand-rolled on purpose: the supported subset is small enough that a parser
+ * dependency would cost more than it covers.
+ */
+/** URL schemes allowed on a link. Anything else renders as its label. */
+const SAFE_SCHEMES = new Set(["http:", "https:", "tg:", "mailto:"]);
+// The info string is validated in code rather than the regex: the
+// \s*([^\s`~]*)\s* form is quadratic on trailing whitespace
+// (CodeQL js/polynomial-redos), while (.*)$ is linear.
+const FENCE_LINE = /^ {0,3}(`{3,}|~{3,})(.*)$/;
+/**
+ * Parse a fence delimiter line. Returns null for lines that are not a fence,
+ * including a fence-like line whose info string carries whitespace, backticks,
+ * or tildes — the same lines the previous single-token regex refused.
+ */
+function parseFenceLine(line) {
+    const match = FENCE_LINE.exec(line);
+    if (match === null) {
+        return null;
+    }
+    const info = match[2].trim();
+    if (/[\s`~]/.test(info)) {
+        return null;
+    }
+    return { marker: match[1], info };
+}
+/** Escape the three characters Telegram's HTML mode reserves. */
+export function escapeHtml(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function escapeAttribute(text) {
+    return escapeHtml(text).replace(/"/g, "&quot;");
+}
+/**
+ * Split into prose and fenced-code blocks. Returns null when a fence opens and
+ * never closes — the one input shape that must not be guessed at.
+ */
+function splitBlocks(markdown) {
+    const lines = markdown.split("\n");
+    const blocks = [];
+    let prose = [];
+    let code = null;
+    let marker = "";
+    let language = "";
+    const flushProse = () => {
+        if (prose.length > 0) {
+            blocks.push({ kind: "prose", text: prose.join("\n") });
+            prose = [];
+        }
+    };
+    for (const line of lines) {
+        const fence = parseFenceLine(line);
+        if (code === null) {
+            if (fence !== null) {
+                flushProse();
+                code = [];
+                marker = fence.marker[0];
+                language = fence.info;
+                continue;
+            }
+            prose.push(line);
+            continue;
+        }
+        if (fence !== null && fence.marker[0] === marker) {
+            blocks.push({ kind: "code", text: code.join("\n"), language });
+            code = null;
+            continue;
+        }
+        code.push(line);
+    }
+    if (code !== null) {
+        return null;
+    }
+    flushProse();
+    return blocks;
+}
+function renderLink(label, url) {
+    const trimmed = url.trim();
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        return null;
+    }
+    if (!SAFE_SCHEMES.has(parsed.protocol)) {
+        return null;
+    }
+    return `<a href="${escapeAttribute(trimmed)}">${inline(label)}</a>`;
+}
+/**
+ * Match `](url)` starting at `open` in `text`, tolerating balanced parentheses
+ * inside the URL (Wikipedia links are the usual offender).
+ */
+function matchLink(text, open) {
+    let depth = 1;
+    let i = open + 1;
+    for (; i < text.length; i += 1) {
+        const ch = text[i];
+        if (ch === "\n") {
+            return null;
+        }
+        if (ch === "[") {
+            depth += 1;
+        }
+        else if (ch === "]") {
+            depth -= 1;
+            if (depth === 0) {
+                break;
+            }
+        }
+    }
+    if (depth !== 0 || text[i + 1] !== "(") {
+        return null;
+    }
+    const label = text.slice(open + 1, i);
+    let parens = 1;
+    let j = i + 2;
+    for (; j < text.length; j += 1) {
+        const ch = text[j];
+        if (ch === "\n") {
+            return null;
+        }
+        if (ch === "(") {
+            parens += 1;
+        }
+        else if (ch === ")") {
+            parens -= 1;
+            if (parens === 0) {
+                break;
+            }
+        }
+    }
+    if (parens !== 0) {
+        return null;
+    }
+    return { label, url: text.slice(i + 2, j), end: j };
+}
+function findClosing(text, from, token) {
+    const next = text.indexOf(token, from);
+    // An emphasis run does not span a blank line.
+    if (next === -1 || text.slice(from, next).includes("\n\n")) {
+        return -1;
+    }
+    return next;
+}
+/** Is `_` at `index` a word-internal underscore (`snake_case`) rather than emphasis? */
+function isWordUnderscore(text, index, run) {
+    const before = index > 0 ? text[index - 1] : "";
+    const after = text[index + run] ?? "";
+    return /[A-Za-z0-9]/.test(before) && /[A-Za-z0-9]/.test(after);
+}
+/** Convert one prose run: bold, italic, inline code and links, rest escaped. */
+function inline(text) {
+    let out = "";
+    let i = 0;
+    while (i < text.length) {
+        const ch = text[i];
+        if (ch === "`") {
+            const close = text.indexOf("`", i + 1);
+            if (close > i + 1) {
+                out += `<code>${escapeHtml(text.slice(i + 1, close))}</code>`;
+                i = close + 1;
+                continue;
+            }
+        }
+        if (ch === "[") {
+            const link = matchLink(text, i);
+            if (link !== null) {
+                const rendered = renderLink(link.label, link.url);
+                if (rendered !== null) {
+                    out += rendered;
+                    i = link.end + 1;
+                    continue;
+                }
+            }
+        }
+        const double = text.slice(i, i + 2);
+        if ((double === "**" || double === "__") && !(double === "__" && isWordUnderscore(text, i, 2))) {
+            const close = findClosing(text, i + 2, double);
+            if (close > i + 2) {
+                out += `<b>${inline(text.slice(i + 2, close))}</b>`;
+                i = close + 2;
+                continue;
+            }
+        }
+        if ((ch === "*" || ch === "_") && !(ch === "_" && isWordUnderscore(text, i, 1))) {
+            const close = findClosing(text, i + 1, ch);
+            if (close > i + 1 && text[i + 1] !== " ") {
+                out += `<i>${inline(text.slice(i + 1, close))}</i>`;
+                i = close + 1;
+                continue;
+            }
+        }
+        out += escapeHtml(ch);
+        i += 1;
+    }
+    return out;
+}
+const TAG_SCAN = /<(\/?)([a-z]+)(?:\s[^<>]*)?>/g;
+/** Every emitted tag balanced and properly nested? The converter's own audit. */
+function isBalanced(html) {
+    const stack = [];
+    for (const match of html.matchAll(TAG_SCAN)) {
+        if (match[1] === "/") {
+            if (stack.pop() !== match[2]) {
+                return false;
+            }
+        }
+        else {
+            stack.push(match[2]);
+        }
+    }
+    return stack.length === 0;
+}
+/**
+ * Convert agent markdown to Telegram HTML.
+ *
+ * @returns `{ok: true, html}` when the safe subset covered the input, or
+ *   `{ok: false, text}` with the original text for a plain-text send.
+ */
+export function markdownToTelegramHtml(markdown) {
+    const blocks = splitBlocks(markdown);
+    if (blocks === null) {
+        return { ok: false, text: markdown };
+    }
+    const parts = blocks.map((block) => {
+        if (block.kind === "code") {
+            const language = block.language ?? "";
+            const open = language.length > 0 ? `<pre><code class="language-${escapeAttribute(language)}">` : "<pre><code>";
+            return `${open}${escapeHtml(block.text)}</code></pre>`;
+        }
+        return inline(block.text);
+    });
+    const html = parts.join("\n").replace(/\n{3,}/g, "\n\n");
+    if (!isBalanced(html)) {
+        return { ok: false, text: markdown };
+    }
+    return { ok: true, html };
+}
+//# sourceMappingURL=markdown-html.js.map

package/dist/markdown-html.js.map

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

package/dist/nodetool-client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The one module that touches `@nodetool-ai/sdk` and `ws`.
+ *
+ * The router talks to a narrow `BridgeClient` interface; this is the real
+ * implementation of it — a `ChatSocket` on the user's delegated token, plus
+ * the two tRPC reads the bridge makes (thread ids for `n` recovery, asset
+ * metadata for outbound files). Keeping the SDK behind this seam is what lets
+ * the router's whole test suite run on a scripted fake socket.
+ */
+import type { ChatSocket } from "@nodetool-ai/sdk";
+import type { AssetAttachment } from "./frame-renderer.js";
+import type { BridgeChatSocket, MakeBridgeClient } from "./turn-router.js";
+import type { DeliveryContext } from "./turn-router.js";
+import type { ResolvedAsset } from "./telegram-adapter.js";
+/** Wrap the SDK socket in the narrow interface the router consumes. */
+export declare function wrapChatSocket(socket: ChatSocket): BridgeChatSocket;
+export interface BridgeClientFactoryOptions {
+    /** NodeTool server base URL. */
+    readonly apiUrl: string;
+    readonly fetch?: typeof fetch;
+}
+/** A `makeClient` for the router, backed by the real server. */
+export declare function createBridgeClientFactory(options: BridgeClientFactoryOptions): MakeBridgeClient;
+/** Bare asset id out of `asset://<id>[.ext]`, or null for anything else. */
+export declare function assetIdOf(uri: string): string | null;
+/**
+ * Fetch an attachment's bytes as the linked user. An `asset://` reference is
+ * resolved through tRPC first, because only the server knows where the object
+ * lives; an absolute URL is fetched directly with the same token.
+ */
+export declare function createAssetResolver(options: BridgeClientFactoryOptions): (asset: AssetAttachment, context: DeliveryContext) => Promise<ResolvedAsset | null>;
+//# sourceMappingURL=nodetool-client.d.ts.map

package/dist/nodetool-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodetool-client.d.ts","sourceRoot":"","sources":["../src/nodetool-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAGlE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAgB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAa3D,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAwBnE;AAED,MAAM,WAAW,0BAA0B;IACzC,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC/B;AAED,gEAAgE;AAChE,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,gBAAgB,CA+BlB;AAED,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOpD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,WAG5D,eAAe,WACb,eAAe,KACvB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAmCjC"}

package/dist/nodetool-client.js

@@ -0,0 +1,127 @@
+/**
+ * The one module that touches `@nodetool-ai/sdk` and `ws`.
+ *
+ * The router talks to a narrow `BridgeClient` interface; this is the real
+ * implementation of it — a `ChatSocket` on the user's delegated token, plus
+ * the two tRPC reads the bridge makes (thread ids for `n` recovery, asset
+ * metadata for outbound files). Keeping the SDK behind this seam is what lets
+ * the router's whole test suite run on a scripted fake socket.
+ */
+import { WebSocket as NodeWebSocket } from "ws";
+import { createNodetoolClient } from "@nodetool-ai/sdk";
+// SAFETY: `ws`'s WebSocket implements the browser constructor shape the SDK
+// asks for (`new (url) => WebSocket` plus the readyState constants), but its
+// declarations are written against Node's own event types rather than the DOM
+// lib, so the two never structurally match. Every SDK use of it — construct,
+// `readyState`, `send`, `close`, the `on*` handlers — is in the intersection.
+const WS_CTOR = NodeWebSocket;
+/** Thread ids are read in pages; this bounds the recovery scan. */
+const THREAD_PAGE_LIMIT = 200;
+const THREAD_PAGE_MAX = 10;
+/** Wrap the SDK socket in the narrow interface the router consumes. */
+export function wrapChatSocket(socket) {
+    return {
+        connect: () => socket.connect(),
+        disconnect: () => socket.disconnect(),
+        send: (options) => socket.send({
+            threadId: options.threadId,
+            text: options.text,
+            provider: options.provider ?? null,
+            model: options.model ?? null,
+            agentMode: options.agentMode ?? true,
+            permissionMode: options.permissionMode ?? "auto"
+        }),
+        stop: (threadId) => socket.stop(threadId),
+        resume: (threadId, lastSeq) => socket.resume(threadId, lastSeq),
+        onFrame: (listener) => socket.on("raw", (frame) => {
+            // SAFETY: the renderer's `RenderFrame` is the protocol union plus an
+            // optional seq; the socket's `raw` event carries exactly the decoded
+            // frame, whose unmodelled members the renderer's `default` case drops.
+            listener(frame);
+        }),
+        onStateChange: (listener) => socket.on("state", (state) => listener(state))
+    };
+}
+/** A `makeClient` for the router, backed by the real server. */
+export function createBridgeClientFactory(options) {
+    return ({ token }) => {
+        const client = createNodetoolClient({
+            baseUrl: options.apiUrl,
+            authToken: token,
+            fetch: options.fetch,
+            WebSocket: WS_CTOR
+        });
+        return {
+            socket: wrapChatSocket(client.chat()),
+            async listThreadIds() {
+                const ids = [];
+                let cursor;
+                for (let page = 0; page < THREAD_PAGE_MAX; page += 1) {
+                    const input = { limit: THREAD_PAGE_LIMIT };
+                    if (cursor !== undefined) {
+                        input.cursor = cursor;
+                    }
+                    const result = await client.trpc.threads.list.query(input);
+                    for (const thread of result.threads) {
+                        ids.push(thread.id);
+                    }
+                    if (!result.next) {
+                        break;
+                    }
+                    cursor = result.next;
+                }
+                return ids;
+            }
+        };
+    };
+}
+/** Bare asset id out of `asset://<id>[.ext]`, or null for anything else. */
+export function assetIdOf(uri) {
+    if (!uri.startsWith("asset://")) {
+        return null;
+    }
+    const rest = uri.slice("asset://".length);
+    const withoutExt = rest.replace(/\.[A-Za-z0-9]+$/, "");
+    return withoutExt.length > 0 ? withoutExt : null;
+}
+/**
+ * Fetch an attachment's bytes as the linked user. An `asset://` reference is
+ * resolved through tRPC first, because only the server knows where the object
+ * lives; an absolute URL is fetched directly with the same token.
+ */
+export function createAssetResolver(options) {
+    const fetchImpl = options.fetch ?? fetch;
+    return async (asset, context) => {
+        const client = createNodetoolClient({
+            baseUrl: options.apiUrl,
+            authToken: context.token,
+            fetch: fetchImpl,
+            WebSocket: WS_CTOR
+        });
+        let url = asset.uri;
+        let filename = asset.name ?? "attachment";
+        let contentType = asset.contentType;
+        const assetId = assetIdOf(asset.uri);
+        if (assetId !== null) {
+            const record = await client.trpc.assets.get.query({ id: assetId });
+            if (!record.get_url) {
+                return null;
+            }
+            url = record.get_url;
+            filename = record.name;
+            contentType = record.content_type;
+        }
+        const response = await fetchImpl(url, {
+            headers: { authorization: `Bearer ${context.token}` }
+        });
+        if (!response.ok) {
+            return null;
+        }
+        return {
+            bytes: new Uint8Array(await response.arrayBuffer()),
+            filename,
+            contentType
+        };
+    };
+}
+//# sourceMappingURL=nodetool-client.js.map

package/dist/nodetool-client.js.map

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

package/dist/register-commands.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `setMyCommands` — a deploy step, not a boot step (design §12).
+ *
+ * Registering the command list is what makes `/link`, `/new` and the rest
+ * autocomplete in the Telegram UI. It is idempotent: Telegram replaces the
+ * whole list on every call, so running it twice leaves the same six commands.
+ */
+import { type BotCommandSpec } from "./bot-api.js";
+import { BOT_COMMANDS } from "./commands.js";
+export interface RegisterCommandsOptions {
+    readonly fetch?: typeof fetch;
+    /** Bot API base URL, for tests. */
+    readonly baseUrl?: string;
+    /** Command list to register. Defaults to the bridge's own six. */
+    readonly commands?: readonly BotCommandSpec[];
+}
+/**
+ * Publish the bot's command list.
+ *
+ * @returns the commands that were registered.
+ */
+export declare function registerCommands(botToken: string, options?: RegisterCommandsOptions): Promise<readonly BotCommandSpec[]>;
+export { BOT_COMMANDS };
+//# sourceMappingURL=register-commands.d.ts.map

package/dist/register-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-commands.d.ts","sourceRoot":"","sources":["../src/register-commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAYpC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/register-commands.js

@@ -0,0 +1,29 @@
+/**
+ * `setMyCommands` — a deploy step, not a boot step (design §12).
+ *
+ * Registering the command list is what makes `/link`, `/new` and the rest
+ * autocomplete in the Telegram UI. It is idempotent: Telegram replaces the
+ * whole list on every call, so running it twice leaves the same six commands.
+ */
+import { BotApi } from "./bot-api.js";
+import { BOT_COMMANDS } from "./commands.js";
+/**
+ * Publish the bot's command list.
+ *
+ * @returns the commands that were registered.
+ */
+export async function registerCommands(botToken, options = {}) {
+    const init = {
+        botToken,
+        fetch: options.fetch ?? fetch
+    };
+    if (options.baseUrl !== undefined) {
+        init.baseUrl = options.baseUrl;
+    }
+    const api = new BotApi(init);
+    const commands = options.commands ?? BOT_COMMANDS;
+    await api.setMyCommands(commands);
+    return commands;
+}
+export { BOT_COMMANDS };
+//# sourceMappingURL=register-commands.js.map

package/dist/register-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-commands.js","sourceRoot":"","sources":["../src/register-commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAuB,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAU7C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB,EAChB,OAAO,GAA4B,EAAE;IAErC,MAAM,IAAI,GAAgE;QACxE,QAAQ;QACR,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;KAC9B,CAAC;IACF,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,YAAY,CAAC;IAClD,MAAM,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/strings.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Trim trailing slashes from a URL base. A loop rather than `/\/+$/`: the
+ * unanchored regex backtracks quadratically on inputs with long interior
+ * slash runs (CodeQL js/polynomial-redos), and a base URL is operator input.
+ */
+export declare function trimTrailingSlashes(value: string): string;
+//# sourceMappingURL=strings.d.ts.map

package/dist/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../src/strings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD"}

package/dist/strings.js

@@ -0,0 +1,13 @@
+/**
+ * Trim trailing slashes from a URL base. A loop rather than `/\/+$/`: the
+ * unanchored regex backtracks quadratically on inputs with long interior
+ * slash runs (CodeQL js/polynomial-redos), and a base URL is operator input.
+ */
+export function trimTrailingSlashes(value) {
+    let end = value.length;
+    while (end > 0 && value[end - 1] === "/") {
+        end -= 1;
+    }
+    return value.slice(0, end);
+}
+//# sourceMappingURL=strings.js.map

package/dist/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../src/strings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,OAAO,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QACzC,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC"}

package/dist/telegram-adapter.d.ts

@@ -0,0 +1,100 @@
+/**
+ * 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 type { RenderOp } from "./frame-renderer.js";
+import type { AssetAttachment } from "./frame-renderer.js";
+import type { DeliveryContext } from "./turn-router.js";
+import type { TurnRouter } from "./turn-router.js";
+import type { BotApi, TelegramUpdate } from "./bot-api.js";
+import type { CommandIdentity } from "./commands.js";
+/** Long-poll seconds asked of `getUpdates`. */
+export declare const POLL_TIMEOUT_SECONDS = 50;
+/** Callback data on the inline stop button. */
+export declare const STOP_CALLBACK_DATA = "stop";
+/** Bytes of an asset, ready to upload. */
+export interface ResolvedAsset {
+    readonly bytes: Uint8Array;
+    readonly filename: string;
+    readonly contentType: string | null;
+}
+/**
+ * Fetch an attachment's bytes on the user's own delegated token. Injected so
+ * the adapter's tests never touch the network and the asset-URL scheme stays
+ * the client module's business.
+ */
+export type ResolveAsset = (asset: AssetAttachment, context: DeliveryContext) => Promise<ResolvedAsset | null>;
+export interface AdapterConfig {
+    readonly allowUsers: readonly string[];
+    readonly apiUrl: string;
+}
+export interface TelegramAdapterOptions {
+    readonly api: BotApi;
+    readonly identity: CommandIdentity;
+    readonly router: TurnRouter;
+    readonly config: AdapterConfig;
+    readonly fetch: typeof fetch;
+    /** Sleep, injected so backoff tests do not wait. */
+    readonly wait?: (ms: number) => Promise<void>;
+    readonly resolveAsset?: ResolveAsset;
+    readonly log?: (message: string, detail?: unknown) => void;
+}
+/** Why the poll loop stopped. */
+export type PollStopReason = "stopped" | "conflict" | "fatal";
+export declare class TelegramAdapter {
+    private readonly api;
+    private readonly identity;
+    private readonly router;
+    private readonly config;
+    private readonly fetchImpl;
+    private readonly wait;
+    private readonly resolveAsset;
+    private readonly log;
+    private offset;
+    private running;
+    private readonly messages;
+    private readonly queues;
+    private readonly declinedGroups;
+    constructor(options: TelegramAdapterOptions);
+    /**
+     * 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.
+     */
+    poll(): Promise<PollStopReason>;
+    /** Ask the poll loop to end after the in-flight request. */
+    stop(): void;
+    /** Wait until every queued op has been executed. */
+    flush(): Promise<void>;
+    handleUpdate(update: TelegramUpdate): Promise<void>;
+    private handleCallbackQuery;
+    private handleMessage;
+    private commandDeps;
+    /**
+     * 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: DeliveryContext, ops: readonly RenderOp[]) => void;
+    private queueFor;
+    private drain;
+    /** An intermediate edit nothing will see, because a later one is queued. */
+    private isSuperseded;
+    private executeOne;
+    private messagesFor;
+    private send;
+    private edit;
+    private sendPlain;
+    private attach;
+}
+//# sourceMappingURL=telegram-adapter.d.ts.map

package/dist/telegram-adapter.d.ts.map

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