@nodetool-ai/telegram 0.8.1

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * `npx @nodetool-ai/telegram` — run the bridge standalone next to any server.
+ *
+ * Config comes from the environment plus an optional `telegram-bot.json`
+ * (design §11). A config mistake is the most likely failure here, so it prints
+ * the offending fields and exits — never a stack trace.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}

package/dist/cli.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * `npx @nodetool-ai/telegram` — run the bridge standalone next to any server.
+ *
+ * Config comes from the environment plus an optional `telegram-bot.json`
+ * (design §11). A config mistake is the most likely failure here, so it prints
+ * the offending fields and exits — never a stack trace.
+ */
+import { TelegramConfigError, loadConfig } from "./config.js";
+import { registerCommands } from "./register-commands.js";
+import { startTelegramBot } from "./index.js";
+const USAGE = `nodetool-telegram — NodeTool's Telegram bridge
+
+Usage:
+  nodetool-telegram [serve]        Long-poll for updates and run turns
+  nodetool-telegram register       Publish the bot's command list (setMyCommands)
+
+Environment:
+  TELEGRAM_BOT_TOKEN           required (from @BotFather)
+  NODETOOL_API_URL             default http://127.0.0.1:7777
+  NODETOOL_INTEGRATION_TOKEN   required (the bot's service token)
+`;
+async function main(argv) {
+    const command = argv[0] ?? "serve";
+    if (command === "--help" || command === "-h" || command === "help") {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    if (command !== "serve" && command !== "register" && command !== "register-commands") {
+        process.stderr.write(`Unknown command: ${command}\n\n${USAGE}`);
+        return 2;
+    }
+    const config = loadConfig();
+    if (command !== "serve") {
+        const commands = await registerCommands(config.botToken);
+        process.stdout.write(`Registered ${commands.length} bot commands.\n`);
+        return 0;
+    }
+    const handle = startTelegramBot(config);
+    const shutdown = () => {
+        void handle.stop();
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    process.stdout.write(`Telegram bridge polling against ${config.apiUrl}\n`);
+    const reason = await handle.finished;
+    return reason === "stopped" ? 0 : 1;
+}
+main(process.argv.slice(2))
+    .then((code) => {
+    process.exitCode = code;
+})
+    .catch((err) => {
+    if (err instanceof TelegramConfigError) {
+        process.stderr.write(`${err.message}\n`);
+    }
+    else {
+        process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+    }
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,KAAK,GAAG;;;;;;;;;;CAUb,CAAC;AAEF,KAAK,UAAU,IAAI,CAAC,IAAuB;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IACnC,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,UAAU,IAAI,OAAO,KAAK,mBAAmB,EAAE,CAAC;QACrF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,QAAQ,CAAC,MAAM,kBAAkB,CAAC,CAAC;QACtE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;IACrC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACxB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;IACb,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtB,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;QACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/commands.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Bot commands (design §7). They never reach the LLM: each one is answered
+ * here, from the identity layer and the router's own state.
+ *
+ * The handlers are I/O-free apart from the collaborators handed to them, so
+ * every command is a unit test rather than a live Telegram session.
+ */
+import type { DeepLinkResult, IdentityResolution, LinkStart } from "./identity-client.js";
+import type { BotCommandSpec } from "./bot-api.js";
+/** The identity calls the commands make. A subset of `IdentityClient`. */
+export interface CommandIdentity {
+    resolve(externalId: string): Promise<IdentityResolution>;
+    linkStart(externalId: string): Promise<LinkStart>;
+    completeDeepLink(externalId: string, code: string): Promise<DeepLinkResult>;
+    unlink(externalId: string): Promise<boolean>;
+}
+/** The router state the commands read. A subset of `TurnRouter`. */
+export interface CommandRouter {
+    stop(chatId: string): boolean;
+    newThread(chatId: string): string | null;
+    currentThreadId(chatId: string): string | null;
+    queueDepth(chatId: string): number;
+    isRunning(chatId: string): boolean;
+}
+export interface CommandDeps {
+    readonly identity: CommandIdentity;
+    readonly router: CommandRouter;
+    /** NodeTool server base URL, for the `/status` health probe. */
+    readonly apiUrl: string;
+    readonly fetch: typeof fetch;
+    /** Telegram ids allowed to link. Empty = anyone. */
+    readonly allowUsers: readonly string[];
+}
+export interface CommandInput {
+    /** Command name without the leading slash, lowercased, `@bot` stripped. */
+    readonly command: string;
+    /** Everything after the command word, trimmed. */
+    readonly args: string;
+    readonly chatId: string;
+    readonly telegramUserId: string;
+}
+export interface CommandOutcome {
+    /** Lines to send back, in order. Empty means the command answered silently. */
+    readonly replies: readonly string[];
+}
+/** Commands anyone may run; the rest need a linked account (design §4). */
+export declare const PUBLIC_COMMANDS: ReadonlySet<string>;
+/** What `setMyCommands` registers, so the commands autocomplete in Telegram. */
+export declare const BOT_COMMANDS: readonly BotCommandSpec[];
+export declare const MESSAGES: {
+    readonly welcome: string;
+    readonly linkPrompt: string;
+    readonly notAllowed: string;
+    readonly groupDecline: "I work in private chat for now.";
+    readonly busy: "Still working on your previous message — send it again when I am done.";
+    readonly unknownCommand: "I do not know that command. Try /status.";
+    readonly needsLink: "That command needs a linked NodeTool account. Send /link first.";
+    readonly nothingRunning: "Nothing is running in this chat.";
+    readonly stopping: "⏹ stopping";
+    readonly unsupportedMedia: string;
+};
+/**
+ * Whether this Telegram user is allowed to use the bot at all. An empty
+ * allowlist means anyone may link (design §4).
+ */
+export declare function isAllowedUser(allowUsers: readonly string[], telegramUserId: string): boolean;
+/** Parse a `/command@bot args` message into its parts, or null when it is not one. */
+export declare function parseCommand(text: string, entities?: readonly {
+    type: string;
+    offset: number;
+    length: number;
+}[]): {
+    command: string;
+    args: string;
+} | null;
+/**
+ * Run one command.
+ *
+ * @returns the replies to send. Commands that need an account are refused
+ * before any work when the account is not linked.
+ */
+export declare function handleCommand(deps: CommandDeps, input: CommandInput): Promise<CommandOutcome>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

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

package/dist/commands.js

@@ -0,0 +1,191 @@
+/**
+ * Bot commands (design §7). They never reach the LLM: each one is answered
+ * here, from the identity layer and the router's own state.
+ *
+ * The handlers are I/O-free apart from the collaborators handed to them, so
+ * every command is a unit test rather than a live Telegram session.
+ */
+/** Commands anyone may run; the rest need a linked account (design §4). */
+export const PUBLIC_COMMANDS = new Set(["start", "link", "status"]);
+/** What `setMyCommands` registers, so the commands autocomplete in Telegram. */
+export const BOT_COMMANDS = [
+    { command: "start", description: "Welcome and link state" },
+    { command: "link", description: "Link this Telegram account to NodeTool" },
+    { command: "unlink", description: "Unlink this Telegram account" },
+    { command: "new", description: "Start a fresh conversation thread" },
+    { command: "stop", description: "Cancel the turn that is running" },
+    { command: "status", description: "Server connectivity, link state, queue depth" }
+];
+export const MESSAGES = {
+    welcome: "I am NodeTool. Message me and I run the turn on your own NodeTool " +
+        "account — your tools, your assets, your budget.",
+    linkPrompt: "This Telegram account is not linked to a NodeTool user yet. Send /link " +
+        "and open the URL I answer with.",
+    notAllowed: "This bot is restricted to a configured list of Telegram accounts, and " +
+        "yours is not on it.",
+    groupDecline: "I work in private chat for now.",
+    busy: "Still working on your previous message — send it again when I am done.",
+    unknownCommand: "I do not know that command. Try /status.",
+    needsLink: "That command needs a linked NodeTool account. Send /link first.",
+    nothingRunning: "Nothing is running in this chat.",
+    stopping: "⏹ stopping",
+    unsupportedMedia: "I only handle text for now — photos, documents and voice notes arrive in " +
+        "the next milestone."
+};
+function linkInstructions(start) {
+    const expiry = start.expiresAt === null ? "" : `\nThe link expires at ${start.expiresAt}.`;
+    return `Open this link while signed in to NodeTool to finish linking:\n${start.url}${expiry}`;
+}
+function describeIdentity(resolution) {
+    if (!resolution.unlinked) {
+        return `Linked to NodeTool user ${resolution.userId}.`;
+    }
+    return resolution.reason === "local-mode"
+        ? `This server is single-user; you are already in. (${resolution.message})`
+        : "Not linked.";
+}
+async function probeHealth(deps) {
+    try {
+        const response = await deps.fetch(`${deps.apiUrl}/health`, { method: "GET" });
+        if (!response.ok) {
+            return `unreachable (HTTP ${response.status})`;
+        }
+        const body = await response.json().catch(() => null);
+        const status = typeof body === "object" && body !== null && "status" in body
+            ? String(body.status)
+            : "ok";
+        return `${status} at ${deps.apiUrl}`;
+    }
+    catch (err) {
+        return `unreachable (${err.message})`;
+    }
+}
+/**
+ * Whether this Telegram user is allowed to use the bot at all. An empty
+ * allowlist means anyone may link (design §4).
+ */
+export function isAllowedUser(allowUsers, telegramUserId) {
+    return allowUsers.length === 0 || allowUsers.includes(telegramUserId);
+}
+/** Parse a `/command@bot args` message into its parts, or null when it is not one. */
+export function parseCommand(text, entities) {
+    const isCommand = entities?.some((entity) => entity.type === "bot_command" && entity.offset === 0) === true ||
+        text.startsWith("/");
+    if (!isCommand) {
+        return null;
+    }
+    const match = /^\/([A-Za-z0-9_]+)(?:@[A-Za-z0-9_]+)?\s*([\s\S]*)$/.exec(text.trim());
+    if (!match) {
+        return null;
+    }
+    return { command: match[1].toLowerCase(), args: match[2].trim() };
+}
+async function handleStart(deps, input) {
+    if (input.args.length === 0) {
+        const resolution = await deps.identity.resolve(input.telegramUserId);
+        return { replies: [`${MESSAGES.welcome}\n\n${describeIdentity(resolution)}`] };
+    }
+    const result = await deps.identity.completeDeepLink(input.telegramUserId, input.args);
+    if (result.ok) {
+        return { replies: ["Linked. Send me a message and I will run it on your account."] };
+    }
+    if (result.reason === "expired") {
+        return { replies: [`${result.message}\nSend /link to start again.`] };
+    }
+    if (result.reason === "mismatch") {
+        return { replies: [result.message] };
+    }
+    // The deep-link direction the server cannot express yet: fall back to the
+    // bot-initiated flow rather than leaving the user with a dead code.
+    const start = await deps.identity.linkStart(input.telegramUserId);
+    return {
+        replies: [
+            `${MESSAGES.welcome}\n\nThat start link could not be completed from here.\n` +
+                linkInstructions(start)
+        ]
+    };
+}
+async function handleLink(deps, input) {
+    const resolution = await deps.identity.resolve(input.telegramUserId);
+    if (!resolution.unlinked) {
+        return { replies: [`Already linked to NodeTool user ${resolution.userId}.`] };
+    }
+    if (resolution.reason === "local-mode") {
+        return { replies: [describeIdentity(resolution)] };
+    }
+    const start = await deps.identity.linkStart(input.telegramUserId);
+    return { replies: [linkInstructions(start)] };
+}
+async function handleUnlink(deps, input) {
+    const unlinked = await deps.identity.unlink(input.telegramUserId);
+    return {
+        replies: [unlinked ? "Unlinked. Send /link to connect again." : "This account was not linked."]
+    };
+}
+async function handleStatus(deps, input) {
+    const health = await probeHealth(deps);
+    let link;
+    try {
+        link = describeIdentity(await deps.identity.resolve(input.telegramUserId));
+    }
+    catch (err) {
+        link = `unknown (${err.message})`;
+    }
+    const thread = deps.router.currentThreadId(input.chatId) ?? "none yet";
+    const lines = [
+        `Server: ${health}`,
+        `Account: ${link}`,
+        `Thread: ${thread}`,
+        `Turn: ${deps.router.isRunning(input.chatId) ? "running" : "idle"}`,
+        `Queued: ${deps.router.queueDepth(input.chatId)}`
+    ];
+    return { replies: [lines.join("\n")] };
+}
+/**
+ * Run one command.
+ *
+ * @returns the replies to send. Commands that need an account are refused
+ * before any work when the account is not linked.
+ */
+export async function handleCommand(deps, input) {
+    if (!isAllowedUser(deps.allowUsers, input.telegramUserId)) {
+        return { replies: [MESSAGES.notAllowed] };
+    }
+    switch (input.command) {
+        case "start":
+            return handleStart(deps, input);
+        case "link":
+            return handleLink(deps, input);
+        case "status":
+            return handleStatus(deps, input);
+        case "unlink":
+        case "new":
+        case "stop":
+            break;
+        default:
+            return { replies: [MESSAGES.unknownCommand] };
+    }
+    const resolution = await deps.identity.resolve(input.telegramUserId);
+    if (resolution.unlinked && resolution.reason === "not-linked") {
+        return { replies: [MESSAGES.needsLink] };
+    }
+    switch (input.command) {
+        case "unlink":
+            return handleUnlink(deps, input);
+        case "new": {
+            const threadId = deps.router.newThread(input.chatId);
+            return {
+                replies: [
+                    threadId === null
+                        ? "No conversation here yet — your next message starts a fresh thread."
+                        : `New thread: ${threadId}`
+                ]
+            };
+        }
+        default:
+            return {
+                replies: [deps.router.stop(input.chatId) ? MESSAGES.stopping : MESSAGES.nothingRunning]
+            };
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Bridge configuration: environment variables plus an optional
+ * `telegram-bot.json`, validated at the boundary (design §11).
+ *
+ * Everything the bridge needs to reach Telegram and the NodeTool server is an
+ * env var; the JSON file carries only the tuning knobs an operator changes
+ * without redeploying. Both are parsed with zod so a bad value fails at
+ * startup naming the field, not on the first message.
+ */
+import { z } from "zod";
+/** Fully resolved bridge configuration. */
+export interface TelegramBotConfig {
+    /** Bot token from @BotFather. */
+    readonly botToken: string;
+    /** Base URL of the NodeTool server, no trailing slash. */
+    readonly apiUrl: string;
+    /** Service token the server recognizes as the messaging integration. */
+    readonly integrationToken: string;
+    /** Set = webhook mode; unset = long polling. */
+    readonly webhookUrl: string | null;
+    /** Verified against `X-Telegram-Bot-Api-Secret-Token`; set iff webhook mode. */
+    readonly webhookSecret: string | null;
+    /** Telegram user ids allowed to link. Empty = anyone. */
+    readonly allowUsers: readonly string[];
+    /** Minimum gap between `editMessageText` calls on one conversation. */
+    readonly editThrottleMs: number;
+    /** Messages queued behind an in-flight turn before the bot answers busy. */
+    readonly maxQueuedTurns: number;
+}
+/** Thrown when env or file config is missing or malformed. */
+export declare class TelegramConfigError extends Error {
+    /** Field names that failed, in the order reported. */
+    readonly fields: readonly string[];
+    constructor(message: string, fields: readonly string[]);
+}
+export declare const DEFAULT_API_URL = "http://127.0.0.1:7777";
+export declare const DEFAULT_EDIT_THROTTLE_MS = 1500;
+export declare const DEFAULT_MAX_QUEUED_TURNS = 3;
+export declare const DEFAULT_CONFIG_FILE = "telegram-bot.json";
+declare const fileSchema: z.ZodObject<{
+    allowUsers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    editThrottleMs: z.ZodDefault<z.ZodNumber>;
+    maxQueuedTurns: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/** The `telegram-bot.json` shape, all keys optional. */
+export type TelegramBotFileConfig = z.infer<typeof fileSchema>;
+export interface LoadConfigOptions {
+    /** Environment to read. Defaults to `process.env`. */
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    /**
+     * Path to `telegram-bot.json`. A missing file at the default path is not an
+     * error; a missing file at an explicitly requested path is.
+     */
+    readonly configPath?: string;
+    /** Already-parsed file config, for callers that hold it in memory. */
+    readonly fileConfig?: unknown;
+}
+/**
+ * Read and validate the bridge configuration.
+ *
+ * @throws {TelegramConfigError} naming every offending field.
+ */
+export declare function loadConfig(options?: LoadConfigOptions): TelegramBotConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gFAAgF;IAChF,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,uEAAuE;IACvE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,8DAA8D;AAC9D,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAEnC,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAIrD;CACF;AAED,eAAO,MAAM,eAAe,0BAA0B,CAAC;AACvD,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAkDvD,QAAA,MAAM,UAAU;;;;iBAId,CAAC;AAEH,wDAAwD;AACxD,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAuCD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,iBAAiB,CA4B7E"}

package/dist/config.js

@@ -0,0 +1,139 @@
+/**
+ * Bridge configuration: environment variables plus an optional
+ * `telegram-bot.json`, validated at the boundary (design §11).
+ *
+ * Everything the bridge needs to reach Telegram and the NodeTool server is an
+ * env var; the JSON file carries only the tuning knobs an operator changes
+ * without redeploying. Both are parsed with zod so a bad value fails at
+ * startup naming the field, not on the first message.
+ */
+import { readFileSync } from "node:fs";
+import { trimTrailingSlashes } from "./strings.js";
+import { z } from "zod";
+/** Thrown when env or file config is missing or malformed. */
+export class TelegramConfigError extends Error {
+    /** Field names that failed, in the order reported. */
+    fields;
+    constructor(message, fields) {
+        super(message);
+        this.name = "TelegramConfigError";
+        this.fields = fields;
+    }
+}
+export const DEFAULT_API_URL = "http://127.0.0.1:7777";
+export const DEFAULT_EDIT_THROTTLE_MS = 1500;
+export const DEFAULT_MAX_QUEUED_TURNS = 3;
+export const DEFAULT_CONFIG_FILE = "telegram-bot.json";
+function isHttpUrl(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === "http:" || url.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+const required = (field) => z
+    .string({ error: `${field} is required` })
+    .trim()
+    .min(1, { error: `${field} is required` });
+const optional = z
+    .string()
+    .trim()
+    .min(1)
+    .nullish()
+    .transform((v) => v ?? null);
+const envSchema = z
+    .object({
+    TELEGRAM_BOT_TOKEN: required("TELEGRAM_BOT_TOKEN"),
+    NODETOOL_API_URL: z
+        .string()
+        .trim()
+        .min(1)
+        .nullish()
+        .transform((v) => (v == null || v === "" ? DEFAULT_API_URL : v))
+        .refine(isHttpUrl, { error: "must be an absolute http(s) URL" }),
+    NODETOOL_INTEGRATION_TOKEN: required("NODETOOL_INTEGRATION_TOKEN"),
+    TELEGRAM_WEBHOOK_URL: optional.refine((v) => v === null || isHttpUrl(v), {
+        error: "must be an absolute http(s) URL"
+    }),
+    TELEGRAM_WEBHOOK_SECRET: optional
+})
+    .superRefine((value, ctx) => {
+    if (value.TELEGRAM_WEBHOOK_URL !== null && value.TELEGRAM_WEBHOOK_SECRET === null) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["TELEGRAM_WEBHOOK_SECRET"],
+            message: "is required when TELEGRAM_WEBHOOK_URL is set (webhook mode)"
+        });
+    }
+});
+const fileSchema = z.object({
+    allowUsers: z.array(z.string().trim().min(1)).default([]),
+    editThrottleMs: z.number().int().positive().default(DEFAULT_EDIT_THROTTLE_MS),
+    maxQueuedTurns: z.number().int().positive().default(DEFAULT_MAX_QUEUED_TURNS)
+});
+function fail(prefix, error) {
+    const issues = error.issues.map((issue) => {
+        const field = issue.path.join(".");
+        return field.length > 0 ? `${field}: ${issue.message}` : issue.message;
+    });
+    const fields = error.issues.map((issue) => issue.path.join("."));
+    throw new TelegramConfigError(`${prefix}\n  ${issues.join("\n  ")}`, fields);
+}
+function readFileConfig(options) {
+    if (options.fileConfig !== undefined) {
+        return options.fileConfig;
+    }
+    const path = options.configPath ?? DEFAULT_CONFIG_FILE;
+    const explicit = options.configPath !== undefined;
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch (err) {
+        if (!explicit && err.code === "ENOENT") {
+            return {};
+        }
+        throw new TelegramConfigError(`Cannot read ${path}: ${err.message}`, [path]);
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        throw new TelegramConfigError(`${path} is not valid JSON: ${err.message}`, [path]);
+    }
+}
+/**
+ * Read and validate the bridge configuration.
+ *
+ * @throws {TelegramConfigError} naming every offending field.
+ */
+export function loadConfig(options = {}) {
+    const env = options.env ?? process.env;
+    const fileParsed = fileSchema.safeParse(readFileConfig(options));
+    if (!fileParsed.success) {
+        fail("Invalid telegram-bot.json:", fileParsed.error);
+    }
+    const envParsed = envSchema.safeParse({
+        TELEGRAM_BOT_TOKEN: env.TELEGRAM_BOT_TOKEN,
+        NODETOOL_API_URL: env.NODETOOL_API_URL,
+        NODETOOL_INTEGRATION_TOKEN: env.NODETOOL_INTEGRATION_TOKEN,
+        TELEGRAM_WEBHOOK_URL: env.TELEGRAM_WEBHOOK_URL,
+        TELEGRAM_WEBHOOK_SECRET: env.TELEGRAM_WEBHOOK_SECRET
+    });
+    if (!envParsed.success) {
+        fail("Invalid Telegram bridge environment:", envParsed.error);
+    }
+    return {
+        botToken: envParsed.data.TELEGRAM_BOT_TOKEN,
+        apiUrl: trimTrailingSlashes(envParsed.data.NODETOOL_API_URL),
+        integrationToken: envParsed.data.NODETOOL_INTEGRATION_TOKEN,
+        webhookUrl: envParsed.data.TELEGRAM_WEBHOOK_URL,
+        webhookSecret: envParsed.data.TELEGRAM_WEBHOOK_SECRET,
+        allowUsers: fileParsed.data.allowUsers,
+        editThrottleMs: fileParsed.data.editThrottleMs,
+        maxQueuedTurns: fileParsed.data.maxQueuedTurns
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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