@tschmz/imp 0.1.0

package/dist/transports/telegram/telegram-transport.js

@@ -0,0 +1,414 @@
+import { randomUUID } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { isAbsolute } from "node:path";
+import { Bot, GrammyError } from "grammy";
+import { parseInboundCommand } from "../../application/commands/parse-inbound-command.js";
+import { inboundCommandMenu, inboundCommandNames } from "../../application/commands/registry.js";
+import { createOpenAiVoiceTranscriber, } from "./openai-voice-transcriber.js";
+import { renderTelegramMessages } from "./render-telegram-message.js";
+export function createTelegramTransport(config, bot = new Bot(config.token), logger, dependencies = {}) {
+    const allowedUserIds = new Set(config.allowedUserIds);
+    const fetchImpl = dependencies.fetch ?? fetch;
+    const voiceTranscriber = dependencies.voiceTranscriber ??
+        (config.voice?.enabled ? createOpenAiVoiceTranscriber() : undefined);
+    return {
+        async start(handler) {
+            const profile = await getTelegramBotProfile(bot, config);
+            await logger?.debug("validated telegram bot token", {
+                endpointId: config.id,
+                transport: "telegram",
+            });
+            await registerTelegramCommands(bot, config);
+            await logger?.debug("registered telegram bot commands", {
+                endpointId: config.id,
+                transport: "telegram",
+            });
+            bot.on("message:text", async (ctx) => {
+                const safeContext = validateTelegramContext(ctx, config.id, allowedUserIds, logger);
+                if (!safeContext) {
+                    return;
+                }
+                const textMessage = getTelegramTextMessage(safeContext.message);
+                if (!textMessage) {
+                    return;
+                }
+                const text = textMessage.text.trim();
+                if (!text) {
+                    await logger?.debug("ignored empty telegram message", {
+                        endpointId: config.id,
+                        transport: "telegram",
+                        conversationId: String(safeContext.chat.id),
+                        messageId: String(textMessage.message_id),
+                    });
+                    return;
+                }
+                dispatchTelegramEvent(handler, createTelegramInboundEvent(config.id, randomUUID(), safeContext, bot, {
+                    text,
+                    source: {
+                        kind: "text",
+                    },
+                    options: parseTelegramCommand(textMessage, profile.username),
+                }, logger), logger);
+            });
+            bot.on("message", async (ctx) => {
+                const safeContext = validateTelegramContext(ctx, config.id, allowedUserIds, logger);
+                if (!safeContext) {
+                    return;
+                }
+                const voiceMessage = getTelegramVoiceMessage(safeContext.message);
+                if (!voiceMessage) {
+                    return;
+                }
+                const correlationId = randomUUID();
+                const messageId = String(voiceMessage.message_id);
+                const conversationId = String(safeContext.chat.id);
+                if (!config.voice?.enabled || !voiceTranscriber) {
+                    await logger?.debug("ignored telegram voice message because voice transcription is disabled", {
+                        endpointId: config.id,
+                        transport: "telegram",
+                        conversationId,
+                        messageId,
+                        correlationId,
+                    });
+                    await safeContext.reply("Voice messages are not enabled for this endpoint.");
+                    return;
+                }
+                try {
+                    const transcript = await transcribeTelegramVoiceMessage(voiceMessage, config, bot, voiceTranscriber, fetchImpl);
+                    if (!transcript) {
+                        throw new Error("Voice transcription returned empty text.");
+                    }
+                    await logger?.debug("transcribed telegram voice message", {
+                        endpointId: config.id,
+                        transport: "telegram",
+                        conversationId,
+                        messageId,
+                        correlationId,
+                    });
+                    dispatchTelegramEvent(handler, createTelegramInboundEvent(config.id, correlationId, safeContext, bot, {
+                        text: transcript,
+                        transcript,
+                        source: {
+                            kind: "telegram-voice-transcript",
+                            transcript: {
+                                provider: config.voice.transcription.provider,
+                                model: config.voice.transcription.model,
+                            },
+                        },
+                    }, logger), logger);
+                }
+                catch (error) {
+                    await logger?.error("failed to transcribe telegram voice message", {
+                        endpointId: config.id,
+                        transport: "telegram",
+                        conversationId,
+                        messageId,
+                        correlationId,
+                        errorType: error instanceof Error ? error.name : typeof error,
+                    }, error);
+                    await safeContext.reply("Sorry, I couldn't transcribe that voice message.");
+                }
+            });
+            await bot.start();
+        },
+        async stop() {
+            bot.stop();
+        },
+    };
+}
+function dispatchTelegramEvent(handler, event, logger) {
+    const startedAt = Date.now();
+    const conversationId = event.message.conversation.externalId;
+    const messageId = event.message.messageId;
+    const correlationId = event.message.correlationId;
+    void logger?.debug("received telegram message", {
+        endpointId: event.message.endpointId,
+        transport: "telegram",
+        conversationId,
+        messageId,
+        correlationId,
+    });
+    detachTelegramEventProcessing(processTelegramEvent(handler, event, {
+        logger,
+        endpointId: event.message.endpointId,
+        conversationId,
+        messageId,
+        correlationId,
+        startedAt,
+    }), {
+        logger,
+        endpointId: event.message.endpointId,
+        conversationId,
+        messageId,
+        correlationId,
+    });
+}
+function validateTelegramContext(ctx, endpointId, allowedUserIds, logger) {
+    if (!ctx.chat || !ctx.message || !ctx.from) {
+        void logger?.debug("ignored telegram update without chat, message, or sender", {
+            endpointId,
+            transport: "telegram",
+        });
+        return undefined;
+    }
+    if (ctx.chat.type !== "private") {
+        void logger?.debug("ignored non-private telegram chat", {
+            endpointId,
+            transport: "telegram",
+            conversationId: String(ctx.chat.id),
+            messageId: String(ctx.message.message_id),
+        });
+        return undefined;
+    }
+    if (!allowedUserIds.has(String(ctx.from.id))) {
+        void logger?.debug("ignored telegram message from disallowed user", {
+            endpointId,
+            transport: "telegram",
+            conversationId: String(ctx.chat.id),
+            messageId: String(ctx.message.message_id),
+        });
+        return undefined;
+    }
+    return {
+        chat: ctx.chat,
+        message: ctx.message,
+        from: ctx.from,
+        reply: ctx.reply.bind(ctx),
+    };
+}
+function getTelegramTextMessage(message) {
+    return typeof message.text === "string" ? message : undefined;
+}
+function getTelegramVoiceMessage(message) {
+    return message.voice?.file_id
+        ? message
+        : undefined;
+}
+async function transcribeTelegramVoiceMessage(message, config, bot, transcriber, fetchImpl) {
+    const voice = message.voice;
+    if (!voice) {
+        throw new Error("Telegram voice message did not include a voice payload.");
+    }
+    const file = await bot.api.getFile(voice.file_id);
+    if (!file.file_path) {
+        throw new Error("Telegram voice file metadata did not include file_path.");
+    }
+    const downloadedAudio = await downloadTelegramFile(file.file_path, config.token, fetchImpl);
+    const mimeType = voice.mime_type ?? downloadedAudio.mimeType ?? "audio/ogg";
+    const extension = mimeType === "audio/mpeg" ? "mp3" : "ogg";
+    const transcript = await transcriber.transcribe({
+        audio: downloadedAudio.bytes,
+        fileName: `telegram-voice-${message.message_id}.${extension}`,
+        mimeType,
+        config: config.voice.transcription,
+    });
+    return transcript.text.trim();
+}
+async function downloadTelegramFile(filePath, token, fetchImpl) {
+    if (isAbsolute(filePath)) {
+        return {
+            bytes: new Uint8Array(await readFile(filePath)),
+        };
+    }
+    const response = await fetchImpl(`https://api.telegram.org/file/bot${token}/${filePath}`);
+    if (!response.ok) {
+        throw new Error(`Telegram file download failed (${response.status} ${response.statusText}).`);
+    }
+    return {
+        bytes: new Uint8Array(await response.arrayBuffer()),
+        mimeType: response.headers.get("content-type") ?? undefined,
+    };
+}
+async function processTelegramEvent(handler, event, options) {
+    try {
+        await handler.handle(event);
+        await options.logger?.debug("processed telegram message", {
+            endpointId: options.endpointId,
+            transport: "telegram",
+            conversationId: options.conversationId,
+            messageId: options.messageId,
+            correlationId: options.correlationId,
+            durationMs: Date.now() - options.startedAt,
+        });
+    }
+    catch (error) {
+        await logTelegramProcessingFailure(options.logger, {
+            endpointId: options.endpointId,
+            conversationId: options.conversationId,
+            messageId: options.messageId,
+            correlationId: options.correlationId,
+            errorType: error instanceof Error ? error.name : typeof error,
+        }, error);
+        try {
+            await event.deliverError?.(error);
+        }
+        catch (deliverErrorFailure) {
+            await logTelegramTerminalFailure(options.logger, {
+                endpointId: options.endpointId,
+                conversationId: options.conversationId,
+                messageId: options.messageId,
+                correlationId: options.correlationId,
+                errorType: deliverErrorFailure instanceof Error ? deliverErrorFailure.name : typeof deliverErrorFailure,
+            }, deliverErrorFailure);
+        }
+    }
+}
+function detachTelegramEventProcessing(operation, options) {
+    void Promise.resolve()
+        .then(() => operation)
+        .catch((error) => {
+        void logTelegramTerminalFailure(options.logger, {
+            endpointId: options.endpointId,
+            conversationId: options.conversationId,
+            messageId: options.messageId,
+            correlationId: options.correlationId,
+            errorType: error instanceof Error ? error.name : typeof error,
+        }, error).catch(() => {
+            // Detached processing must never leak terminal failure logging errors.
+        });
+    });
+}
+async function logTelegramProcessingFailure(logger, fields, error) {
+    await safelyLogTelegramError(logger, "failed to process telegram message", {
+        endpointId: fields.endpointId,
+        transport: "telegram",
+        conversationId: fields.conversationId,
+        messageId: fields.messageId,
+        correlationId: fields.correlationId,
+        errorType: fields.errorType,
+    }, error);
+}
+async function logTelegramTerminalFailure(logger, fields, error) {
+    await safelyLogTelegramError(logger, "telegram message processing terminated after an unhandled failure", {
+        endpointId: fields.endpointId,
+        transport: "telegram",
+        conversationId: fields.conversationId,
+        messageId: fields.messageId,
+        correlationId: fields.correlationId,
+        errorType: fields.errorType,
+    }, error);
+}
+async function safelyLogTelegramError(logger, message, fields, error) {
+    try {
+        await logger?.error(message, fields, error);
+    }
+    catch {
+        // Detached processing must never leak secondary logging failures.
+    }
+}
+function createTelegramInboundEvent(endpointId, correlationId, ctx, bot, payload, logger) {
+    return {
+        message: {
+            endpointId,
+            conversation: {
+                transport: "telegram",
+                externalId: String(ctx.chat.id),
+            },
+            messageId: String(ctx.message.message_id),
+            correlationId,
+            userId: String(ctx.from.id),
+            text: payload.text,
+            receivedAt: new Date().toISOString(),
+            ...(payload.source ? { source: payload.source } : {}),
+            ...(payload.options ? payload.options : {}),
+        },
+        async runWithProcessing(operation) {
+            const stopTyping = startTypingStatus(bot, ctx.chat.id);
+            try {
+                return await operation();
+            }
+            finally {
+                stopTyping();
+            }
+        },
+        async deliver(message) {
+            if (payload.transcript) {
+                for (const chunk of renderTelegramMessages(`**Transcript**\n${payload.transcript}`)) {
+                    await ctx.reply(chunk, {
+                        parse_mode: "HTML",
+                    });
+                }
+            }
+            for (const chunk of renderTelegramMessages(message.text)) {
+                await ctx.reply(chunk, {
+                    parse_mode: "HTML",
+                });
+            }
+        },
+        async deliverError() {
+            await logger?.debug("sending telegram processing error response", {
+                endpointId,
+                transport: "telegram",
+                conversationId: String(ctx.chat.id),
+                messageId: String(ctx.message.message_id),
+                correlationId,
+            });
+            await ctx.reply("Sorry, something went wrong while processing your message.");
+        },
+    };
+}
+async function getTelegramBotProfile(bot, config) {
+    try {
+        return await bot.api.getMe();
+    }
+    catch (error) {
+        if (error instanceof GrammyError) {
+            throw new Error(`Invalid Telegram endpoint token for endpoint "${config.id}" (${error.error_code}: ${error.description})`);
+        }
+        throw error;
+    }
+}
+async function registerTelegramCommands(bot, config) {
+    try {
+        await bot.api.setMyCommands(inboundCommandMenu);
+    }
+    catch (error) {
+        if (error instanceof GrammyError) {
+            throw new Error(`Failed to register Telegram commands for endpoint "${config.id}" (${error.error_code}: ${error.description})`);
+        }
+        throw error;
+    }
+}
+function parseTelegramCommand(message, botUsername) {
+    if (typeof message.text !== "string") {
+        return undefined;
+    }
+    return parseInboundCommand(message.text, {
+        botUsername,
+        entities: message.entities,
+        allowedCommands: inboundCommandNames,
+    });
+}
+function startTypingStatus(bot, chatId) {
+    let active = true;
+    let timeout;
+    const scheduleNext = () => {
+        if (!active) {
+            return;
+        }
+        timeout = setTimeout(() => {
+            void sendTyping();
+        }, 4000);
+    };
+    const sendTyping = async () => {
+        if (!active) {
+            return;
+        }
+        try {
+            await bot.api.sendChatAction(chatId, "typing");
+        }
+        catch {
+            scheduleNext();
+            return;
+        }
+        scheduleNext();
+    };
+    void sendTyping();
+    return () => {
+        active = false;
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+    };
+}
+//# sourceMappingURL=telegram-transport.js.map

package/dist/transports/telegram/telegram-transport.js.map

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

package/dist/transports/telegram/transport-adapter.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import type { TelegramEndpointConfig } from "../../config/types.js";
+import type { ActiveEndpointRuntimeConfig } from "../../daemon/types.js";
+import type { Logger } from "../../logging/types.js";
+import type { Transport } from "../types.js";
+export declare const telegramTransportConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"telegram">;
+    enabled: z.ZodBoolean;
+    token: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        env: z.ZodOptional<z.ZodString>;
+        file: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>;
+    access: z.ZodObject<{
+        allowedUserIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    routing: z.ZodOptional<z.ZodObject<{
+        defaultAgentId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    voice: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        transcription: z.ZodObject<{
+            provider: z.ZodLiteral<"openai">;
+            model: z.ZodString;
+            language: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export declare function normalizeTelegramRuntimeConfig(endpoint: TelegramEndpointConfig, options: {
+    dataRoot: string;
+    defaultAgentId: string;
+}): ActiveEndpointRuntimeConfig;
+export declare function createTelegramTransportFromRuntimeConfig(config: ActiveEndpointRuntimeConfig, logger: Logger): Transport;

package/dist/transports/telegram/transport-adapter.js

@@ -0,0 +1,62 @@
+import { join } from "node:path";
+import { z } from "zod";
+import { secretValueConfigSchema } from "../../config/secret-value.js";
+import { createTelegramTransport } from "./telegram-transport.js";
+export const telegramTransportConfigSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal("telegram"),
+    enabled: z.boolean(),
+    token: secretValueConfigSchema,
+    access: z.object({
+        allowedUserIds: z
+            .string()
+            .array()
+            .refine((values) => values.every((value) => /^\d+$/.test(value)), {
+            message: "Telegram user IDs must contain digits only.",
+        }),
+    }),
+    routing: z
+        .object({
+        defaultAgentId: z.string().min(1).optional(),
+    })
+        .optional(),
+    voice: z
+        .object({
+        enabled: z.boolean(),
+        transcription: z.object({
+            provider: z.literal("openai"),
+            model: z.string().min(1),
+            language: z.string().min(1).optional(),
+        }),
+    })
+        .optional(),
+}).strict();
+export function normalizeTelegramRuntimeConfig(endpoint, options) {
+    if (typeof endpoint.token !== "string") {
+        throw new Error(`Telegram endpoint "${endpoint.id}" token must be resolved before runtime normalization.`);
+    }
+    const endpointRoot = join(options.dataRoot, "endpoints", endpoint.id);
+    const logsDir = join(options.dataRoot, "logs", "endpoints");
+    const runtimeDir = join(options.dataRoot, "runtime", "endpoints");
+    return {
+        id: endpoint.id,
+        type: endpoint.type,
+        token: endpoint.token,
+        allowedUserIds: endpoint.access.allowedUserIds,
+        ...(endpoint.voice ? { voice: endpoint.voice } : {}),
+        defaultAgentId: endpoint.routing?.defaultAgentId ?? options.defaultAgentId,
+        paths: {
+            dataRoot: options.dataRoot,
+            endpointRoot,
+            conversationsDir: join(endpointRoot, "conversations"),
+            logsDir,
+            logFilePath: join(logsDir, `${endpoint.id}.log`),
+            runtimeDir,
+            runtimeStatePath: join(runtimeDir, `${endpoint.id}.json`),
+        },
+    };
+}
+export function createTelegramTransportFromRuntimeConfig(config, logger) {
+    return createTelegramTransport(config, undefined, logger);
+}
+//# sourceMappingURL=transport-adapter.js.map

package/dist/transports/telegram/transport-adapter.js.map

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

package/dist/transports/types.d.ts

@@ -0,0 +1,15 @@
+import type { IncomingMessage, OutgoingMessage } from "../domain/message.js";
+export type TransportFactory<TConfig = unknown, TLogger = unknown> = (config: TConfig, logger: TLogger) => Transport;
+export interface TransportInboundEvent {
+    message: IncomingMessage;
+    runWithProcessing<T>(operation: () => Promise<T>): Promise<T>;
+    deliver(message: OutgoingMessage): Promise<void>;
+    deliverError?(error: unknown): Promise<void>;
+}
+export interface TransportHandler {
+    handle(event: TransportInboundEvent): Promise<void>;
+}
+export interface Transport {
+    start(handler: TransportHandler): Promise<void>;
+    stop?(): Promise<void> | void;
+}

package/dist/transports/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transports/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transports/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@tschmz/imp",
+  "version": "0.1.0",
+  "private": false,
+  "description": "A lightweight local daemon for modular agent endpoints",
+  "type": "module",
+  "bin": {
+    "imp": "./dist/main.js"
+  },
+  "files": [
+    "dist",
+    "config.example.json",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.6.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && chmod +x dist/main.js",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "check": "npm run typecheck && npm run lint",
+    "start": "node dist/main.js",
+    "prepublishOnly": "npm run clean && npm run check && npm run build"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "8.3.2",
+    "@mariozechner/pi-agent-core": "^0.65.0",
+    "@mariozechner/pi-ai": "^0.65.0",
+    "@mariozechner/pi-coding-agent": "^0.65.0",
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "commander": "14.0.3",
+    "grammy": "^1.42.0",
+    "handlebars": "4.7.9",
+    "yaml": "2.8.3",
+    "zod": "^4.0.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.29.1",
+    "vitest": "^3.2.4"
+  }
+}