@yagr/agent 0.1.0

package/dist/gateway/manager.js

@@ -0,0 +1,204 @@
+import qrcode from 'qrcode-terminal';
+import { YagrConfigService } from '../config/yagr-config-service.js';
+import { createTelegramGatewayRuntime, getTelegramGatewayStatus } from './telegram.js';
+import { createWebUiGatewayRuntime, getWebUiGatewayStatus } from './webui.js';
+function summarizeTelegramStatus(status) {
+    if (!status.configured || !status.botUsername) {
+        return 'Not configured';
+    }
+    const linkedCount = status.linkedChats.length;
+    const chatSummary = linkedCount === 1 ? '1 linked chat' : `${linkedCount} linked chats`;
+    return `@${status.botUsername}, ${chatSummary}`;
+}
+function summarizeWebUiStatus(status) {
+    if (!status.configured) {
+        return 'Not configured';
+    }
+    return status.url;
+}
+const GATEWAY_DESCRIPTORS = [
+    {
+        id: 'telegram',
+        label: 'Telegram',
+        getStatus: (configService, enabled) => {
+            const status = getTelegramGatewayStatus(configService);
+            return {
+                id: 'telegram',
+                label: 'Telegram',
+                enabled,
+                configured: status.configured,
+                implemented: true,
+                summary: summarizeTelegramStatus(status),
+                details: {
+                    botUsername: status.botUsername,
+                    linkedChats: status.linkedChats,
+                    deepLink: status.deepLink,
+                },
+            };
+        },
+        createRuntime: async (engineResolver, options, configService) => createTelegramGatewayRuntime(engineResolver, options, configService),
+    },
+    {
+        id: 'webui',
+        label: 'Web UI',
+        getStatus: (configService, enabled) => {
+            const status = getWebUiGatewayStatus(configService);
+            return {
+                id: 'webui',
+                label: 'Web UI',
+                enabled,
+                configured: status.configured,
+                implemented: true,
+                summary: summarizeWebUiStatus(status),
+                details: {
+                    url: status.url,
+                    host: status.host,
+                    port: status.port,
+                },
+            };
+        },
+        createRuntime: async (engineResolver, options, configService) => createWebUiGatewayRuntime(engineResolver, options, configService),
+    },
+    {
+        id: 'whatsapp',
+        label: 'WhatsApp',
+        getStatus: (_configService, enabled) => ({
+            id: 'whatsapp',
+            label: 'WhatsApp',
+            enabled,
+            configured: false,
+            implemented: false,
+            summary: 'Not implemented yet',
+        }),
+    },
+];
+export function buildGatewaySupervisorStatus(surfaces) {
+    const normalizedSurfaces = surfaces.map((surface) => ({
+        ...surface,
+        startable: surface.enabled && surface.configured && surface.implemented,
+    }));
+    const warnings = normalizedSurfaces.flatMap((surface) => {
+        if (!surface.enabled) {
+            return [];
+        }
+        if (!surface.implemented) {
+            return [`${surface.label} is enabled but not implemented yet.`];
+        }
+        if (!surface.configured) {
+            return [`${surface.label} is enabled but not configured.`];
+        }
+        return [];
+    });
+    return {
+        enabledSurfaces: normalizedSurfaces.filter((surface) => surface.enabled).map((surface) => surface.id),
+        startableSurfaces: normalizedSurfaces.filter((surface) => surface.startable).map((surface) => surface.id),
+        surfaces: normalizedSurfaces,
+        warnings,
+    };
+}
+export function getGatewaySupervisorStatus(configService = new YagrConfigService()) {
+    const enabledSurfaces = configService.getEnabledGatewaySurfaces();
+    return buildGatewaySupervisorStatus(GATEWAY_DESCRIPTORS.map((descriptor) => descriptor.getStatus(configService, enabledSurfaces.includes(descriptor.id))));
+}
+async function stopRuntimeHandles(runtimes) {
+    await Promise.allSettled(runtimes.map(async (runtime) => {
+        await runtime.gateway.stop();
+    }));
+}
+export async function runGatewaySurfaces(surfaces, engineResolver, options = {}, configService = new YagrConfigService()) {
+    const requestedSurfaces = Array.from(new Set(surfaces));
+    if (requestedSurfaces.length === 0) {
+        throw new Error('No gateway surfaces were selected.');
+    }
+    const runtimes = [];
+    try {
+        for (const surface of requestedSurfaces) {
+            const descriptor = GATEWAY_DESCRIPTORS.find((entry) => entry.id === surface);
+            if (!descriptor || !descriptor.createRuntime) {
+                throw new Error(`${surface} is not implemented yet.`);
+            }
+            const status = descriptor.getStatus(configService, true);
+            if (!status.implemented) {
+                throw new Error(`${descriptor.label} is not implemented yet.`);
+            }
+            if (!status.configured) {
+                throw new Error(`${descriptor.label} is not configured.`);
+            }
+            const runtime = await descriptor.createRuntime(engineResolver, options, configService);
+            await runtime.gateway.start();
+            runtimes.push(runtime);
+            for (const line of runtime.startupMessages) {
+                process.stdout.write(`${line}\n`);
+            }
+            if (runtime.onboardingLink) {
+                process.stdout.write(`Onboarding link: ${runtime.onboardingLink}\n`);
+                qrcode.generate(runtime.onboardingLink, { small: true });
+            }
+        }
+    }
+    catch (error) {
+        await stopRuntimeHandles(runtimes);
+        throw error;
+    }
+    process.stdout.write(`Yagr gateway active. Surfaces: ${requestedSurfaces.join(', ')}.\n`);
+    await new Promise((resolve) => {
+        const stop = async () => {
+            await stopRuntimeHandles(runtimes);
+            resolve();
+        };
+        process.once('SIGINT', () => {
+            void stop();
+        });
+        process.once('SIGTERM', () => {
+            void stop();
+        });
+    });
+}
+export async function runGatewaySupervisor(engineResolver, options = {}, configService = new YagrConfigService()) {
+    const status = getGatewaySupervisorStatus(configService);
+    if (status.startableSurfaces.length === 0) {
+        const message = status.warnings[0] ?? 'No enabled and configured gateway surfaces are available.';
+        throw new Error(message);
+    }
+    const runtimes = [];
+    try {
+        for (const descriptor of GATEWAY_DESCRIPTORS) {
+            if (!status.startableSurfaces.includes(descriptor.id) || !descriptor.createRuntime) {
+                continue;
+            }
+            const runtime = await descriptor.createRuntime(engineResolver, options, configService);
+            await runtime.gateway.start();
+            runtimes.push(runtime);
+            for (const line of runtime.startupMessages) {
+                process.stdout.write(`${line}\n`);
+            }
+            if (runtime.onboardingLink) {
+                process.stdout.write(`Onboarding link: ${runtime.onboardingLink}\n`);
+                qrcode.generate(runtime.onboardingLink, { small: true });
+            }
+        }
+    }
+    catch (error) {
+        await stopRuntimeHandles(runtimes);
+        throw error;
+    }
+    process.stdout.write(`Yagr gateway supervisor active. Surfaces: ${status.startableSurfaces.join(', ')}.\n`);
+    if (status.warnings.length > 0) {
+        for (const warning of status.warnings) {
+            process.stdout.write(`Warning: ${warning}\n`);
+        }
+    }
+    await new Promise((resolve) => {
+        const stop = async () => {
+            await stopRuntimeHandles(runtimes);
+            resolve();
+        };
+        process.once('SIGINT', () => {
+            void stop();
+        });
+        process.once('SIGTERM', () => {
+            void stop();
+        });
+    });
+}
+//# sourceMappingURL=manager.js.map

package/dist/gateway/manager.js.map

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

package/dist/gateway/telegram.d.ts

@@ -0,0 +1,30 @@
+import { YagrConfigService, type YagrTelegramLinkedChat } from '../config/yagr-config-service.js';
+import type { Engine } from '../engine/engine.js';
+import type { YagrRunOptions } from '../types.js';
+import type { GatewayRuntimeHandle } from './types.js';
+export declare function createOnboardingToken(): string;
+export declare function buildTelegramDeepLink(botUsername: string, onboardingToken: string): string;
+export declare function upsertLinkedChat(chats: YagrTelegramLinkedChat[], nextChat: YagrTelegramLinkedChat): YagrTelegramLinkedChat[];
+export declare function removeLinkedChat(chats: YagrTelegramLinkedChat[], chatId: string): YagrTelegramLinkedChat[];
+export declare function splitTelegramMessage(text: string, limit?: number): string[];
+interface TelegramGatewayRuntimeOptions extends YagrRunOptions {
+    botToken?: string;
+}
+export interface TelegramGatewayStatus {
+    configured: boolean;
+    botUsername?: string;
+    linkedChats: YagrTelegramLinkedChat[];
+    deepLink?: string;
+}
+export declare function resolveTelegramBotIdentity(botToken: string): Promise<{
+    username: string;
+    firstName: string;
+}>;
+export declare function setupTelegramGateway(configService?: YagrConfigService): Promise<void>;
+export declare function showTelegramOnboarding(configService?: YagrConfigService): void;
+export declare function getTelegramGatewayStatus(configService?: YagrConfigService): TelegramGatewayStatus;
+export declare function resetTelegramGateway(configService?: YagrConfigService): void;
+export declare function createTelegramGatewayRuntime(engineResolver: () => Promise<Engine>, options?: TelegramGatewayRuntimeOptions, configService?: YagrConfigService): GatewayRuntimeHandle;
+export declare function runTelegramGateway(engineResolver: () => Promise<Engine>, options?: TelegramGatewayRuntimeOptions, configService?: YagrConfigService): Promise<void>;
+export {};
+//# sourceMappingURL=telegram.d.ts.map

package/dist/gateway/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/gateway/telegram.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAClG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAsB,cAAc,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAW,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIhE,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAE1F;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,sBAAsB,EAAE,EAC/B,QAAQ,EAAE,sBAAsB,GAC/B,sBAAsB,EAAE,CAa1B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAE1G;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAyB,GAAG,MAAM,EAAE,CAsB3F;AAED,UAAU,6BAA8B,SAAQ,cAAc;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,sBAAsB,EAAE,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA4BD,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAWnH;AAED,wBAAsB,oBAAoB,CAAC,aAAa,oBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CjG;AAED,wBAAgB,sBAAsB,CAAC,aAAa,oBAA0B,GAAG,IAAI,CAmBpF;AAED,wBAAgB,wBAAwB,CAAC,aAAa,oBAA0B,GAAG,qBAAqB,CAevG;AAED,wBAAgB,oBAAoB,CAAC,aAAa,oBAA0B,GAAG,IAAI,CAQlF;AAED,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EACrC,OAAO,GAAE,6BAAkC,EAC3C,aAAa,oBAA0B,GACtC,oBAAoB,CAmBtB;AAwPD,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EACrC,OAAO,GAAE,6BAAkC,EAC3C,aAAa,oBAA0B,GACtC,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/gateway/telegram.js

@@ -0,0 +1,406 @@
+import { randomBytes } from 'node:crypto';
+import qrcode from 'qrcode-terminal';
+import { Telegraf } from 'telegraf';
+import { YagrAgent } from '../agent.js';
+import { YagrConfigService } from '../config/yagr-config-service.js';
+const TELEGRAM_MESSAGE_LIMIT = 4096;
+export function createOnboardingToken() {
+    return randomBytes(18).toString('base64url');
+}
+export function buildTelegramDeepLink(botUsername, onboardingToken) {
+    return `https://t.me/${botUsername}?start=${onboardingToken}`;
+}
+export function upsertLinkedChat(chats, nextChat) {
+    const chatId = String(nextChat.chatId);
+    const existing = chats.find((entry) => String(entry.chatId) === chatId);
+    if (!existing) {
+        return [...chats, { ...nextChat, chatId }];
+    }
+    return chats.map((entry) => (String(entry.chatId) === chatId
+        ? { ...entry, ...nextChat, chatId }
+        : entry));
+}
+export function removeLinkedChat(chats, chatId) {
+    return chats.filter((entry) => String(entry.chatId) !== String(chatId));
+}
+export function splitTelegramMessage(text, limit = TELEGRAM_MESSAGE_LIMIT) {
+    const normalized = text.trim();
+    if (!normalized) {
+        return [];
+    }
+    const chunks = [];
+    let remaining = normalized;
+    while (remaining.length > limit) {
+        const candidate = remaining.slice(0, limit);
+        const splitAt = Math.max(candidate.lastIndexOf('\n\n'), candidate.lastIndexOf('\n'), candidate.lastIndexOf(' '));
+        const cut = splitAt > Math.floor(limit * 0.6) ? splitAt : limit;
+        chunks.push(remaining.slice(0, cut).trim());
+        remaining = remaining.slice(cut).trim();
+    }
+    if (remaining) {
+        chunks.push(remaining);
+    }
+    return chunks;
+}
+function buildTelegramTokenInstructions() {
+    return [
+        '1) Open Telegram and chat with @BotFather',
+        '2) Run /newbot (or /mybots)',
+        '3) Copy the token (looks like 123456:ABC...)',
+        'Yagr stores this token during setup.',
+        'Docs: https://core.telegram.org/bots#how-do-i-create-a-bot',
+    ].join('\n');
+}
+function formatLinkedChatCount(count) {
+    return count === 1 ? '1 chat lie' : `${count} chats lies`;
+}
+function formatRequiredActions(actions) {
+    if (actions.length === 0) {
+        return '';
+    }
+    return [
+        'Actions requises :',
+        ...actions.map((action) => `- ${action.title}: ${action.message}`),
+        'Utilise /approve pour reprendre si la demande est approuvable.',
+    ].join('\n');
+}
+export async function resolveTelegramBotIdentity(botToken) {
+    const bot = new Telegraf(botToken);
+    const me = await bot.telegram.getMe();
+    if (!me.username) {
+        throw new Error('Telegram bot username is missing. Configure the bot with BotFather first.');
+    }
+    return {
+        username: me.username,
+        firstName: me.first_name,
+    };
+}
+export async function setupTelegramGateway(configService = new YagrConfigService()) {
+    const currentToken = configService.getTelegramBotToken() ?? '';
+    if (!currentToken) {
+        process.stdout.write(`\nTo create a Telegram bot token:\n${buildTelegramTokenInstructions()}\n`);
+    }
+    const readline = await import('node:readline/promises');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    let botToken;
+    try {
+        if (currentToken) {
+            const answer = await rl.question(`Reuse saved token? [Y/n] `);
+            botToken = answer.trim().toLowerCase() === 'n' ? await rl.question('Telegram bot token: ') : currentToken;
+        }
+        else {
+            botToken = await rl.question('Telegram bot token: ');
+        }
+    }
+    finally {
+        rl.close();
+    }
+    if (!botToken.includes(':'))
+        throw new Error('Invalid Telegram bot token format.');
+    process.stdout.write('Verifying token...\n');
+    const identity = await resolveTelegramBotIdentity(botToken);
+    configService.saveTelegramBotToken(botToken);
+    const nextConfig = configService.updateLocalConfig((localConfig) => ({
+        ...localConfig,
+        telegram: {
+            ...localConfig.telegram,
+            botUsername: identity.username,
+            onboardingToken: localConfig.telegram?.onboardingToken ?? createOnboardingToken(),
+            linkedChats: localConfig.telegram?.linkedChats ?? [],
+        },
+    }));
+    configService.enableGatewaySurface('telegram');
+    const deepLink = buildTelegramDeepLink(nextConfig.telegram?.botUsername ?? identity.username, nextConfig.telegram?.onboardingToken ?? createOnboardingToken());
+    process.stdout.write(`\nTelegram bot ready: @${identity.username}\nOnboarding link: ${deepLink}\n`);
+    qrcode.generate(deepLink, { small: true });
+    process.stdout.write('Gateway saved. Start with `yagr gateway start`.\n');
+}
+export function showTelegramOnboarding(configService = new YagrConfigService()) {
+    const status = getTelegramGatewayStatus(configService);
+    if (!status.configured || !status.botUsername || !status.deepLink) {
+        throw new Error('Telegram is not configured. Run `yagr telegram setup` first.');
+    }
+    process.stdout.write([
+        '',
+        `Bot: @${status.botUsername}`,
+        `Onboarding link: ${status.deepLink}`,
+        `Linked chats: ${formatLinkedChatCount(status.linkedChats.length)}`,
+        '',
+        'Scan the QR or open the link, then press Start in Telegram.',
+        '',
+    ].join('\n'));
+    qrcode.generate(status.deepLink, { small: true });
+}
+export function getTelegramGatewayStatus(configService = new YagrConfigService()) {
+    const localConfig = configService.getLocalConfig();
+    const telegram = localConfig.telegram;
+    const botToken = configService.getTelegramBotToken();
+    const linkedChats = telegram?.linkedChats ?? [];
+    const deepLink = telegram?.botUsername && telegram.onboardingToken
+        ? buildTelegramDeepLink(telegram.botUsername, telegram.onboardingToken)
+        : undefined;
+    return {
+        configured: Boolean(botToken && telegram?.botUsername && telegram?.onboardingToken),
+        botUsername: telegram?.botUsername,
+        linkedChats,
+        deepLink,
+    };
+}
+export function resetTelegramGateway(configService = new YagrConfigService()) {
+    configService.clearTelegramBotToken();
+    configService.disableGatewaySurface('telegram');
+    configService.updateLocalConfig((localConfig) => {
+        const nextConfig = { ...localConfig };
+        delete nextConfig.telegram;
+        return nextConfig;
+    });
+}
+export function createTelegramGatewayRuntime(engineResolver, options = {}, configService = new YagrConfigService()) {
+    const status = getTelegramGatewayStatus(configService);
+    const botToken = options.botToken ?? configService.getTelegramBotToken();
+    const onboardingToken = configService.getLocalConfig().telegram?.onboardingToken;
+    if (!botToken || !status.botUsername || !onboardingToken) {
+        throw new Error('Telegram is not configured. Run `yagr telegram setup` first.');
+    }
+    const linkedCount = status.linkedChats.length;
+    return {
+        gateway: new TelegramGateway(engineResolver, options, configService, botToken, onboardingToken),
+        startupMessages: [
+            `Yagr Telegram gateway listening as @${status.botUsername}. ${formatLinkedChatCount(linkedCount)}.`,
+            'Telegram transport is ready. The current orchestrator connection will be resolved on first message.',
+        ],
+        onboardingLink: status.deepLink && linkedCount === 0 ? status.deepLink : undefined,
+    };
+}
+class TelegramGateway {
+    engineResolver;
+    options;
+    configService;
+    onboardingToken;
+    bot;
+    agents = new Map();
+    runningChats = new Set();
+    pendingApprovals = new Map();
+    enginePromise;
+    stopped = false;
+    constructor(engineResolver, options, configService, botToken, onboardingToken) {
+        this.engineResolver = engineResolver;
+        this.options = options;
+        this.configService = configService;
+        this.onboardingToken = onboardingToken;
+        this.bot = new Telegraf(botToken);
+    }
+    async start() {
+        this.bot.start(async (ctx) => {
+            const payload = typeof ctx.payload === 'string' ? ctx.payload.trim() : '';
+            const chatId = String(ctx.chat.id);
+            if (payload !== this.onboardingToken) {
+                await ctx.reply('Ce bot n’est pas encore lie a cette conversation. Utilise le QR ou le lien genere par `yagr telegram setup`.');
+                return;
+            }
+            this.linkChat({
+                chatId,
+                userId: String(ctx.from?.id ?? ''),
+                username: ctx.from?.username,
+                firstName: ctx.from?.first_name,
+                linkedAt: new Date().toISOString(),
+                lastSeenAt: new Date().toISOString(),
+            });
+            await ctx.reply('Yagr est maintenant lie a ce chat. Tu peux me parler directement ici.');
+        });
+        this.bot.command('status', async (ctx) => {
+            const chatId = String(ctx.chat.id);
+            if (!this.isLinkedChat(chatId)) {
+                await ctx.reply('Chat non lie. Utilise le QR ou le lien d’onboarding d’abord.');
+                return;
+            }
+            const linkedChats = this.configService.getLocalConfig().telegram?.linkedChats ?? [];
+            await ctx.reply(`Gateway Telegram actif. ${formatLinkedChatCount(linkedChats.length)}.`);
+        });
+        this.bot.command('pending', async (ctx) => {
+            const chatId = String(ctx.chat.id);
+            const actions = this.pendingApprovals.get(chatId) ?? [];
+            if (actions.length === 0) {
+                await ctx.reply('Aucune action en attente.');
+                return;
+            }
+            await ctx.reply(formatRequiredActions(actions));
+        });
+        this.bot.command('approve', async (ctx) => {
+            const chatId = String(ctx.chat.id);
+            if (!this.isLinkedChat(chatId)) {
+                await ctx.reply('Chat non lie.');
+                return;
+            }
+            const actions = this.pendingApprovals.get(chatId) ?? [];
+            if (actions.length === 0) {
+                await ctx.reply('Aucune action approuvable en attente.');
+                return;
+            }
+            await this.executeRun(chatId, 'Permission granted. Continue the current task and execute the previously blocked step now.', actions, ctx.reply.bind(ctx));
+        });
+        this.bot.command('reset', async (ctx) => {
+            const chatId = String(ctx.chat.id);
+            this.agents.delete(chatId);
+            this.pendingApprovals.delete(chatId);
+            await ctx.reply('Conversation Yagr reinitialisee pour ce chat.');
+        });
+        this.bot.command('unlink', async (ctx) => {
+            const chatId = String(ctx.chat.id);
+            if (!this.isLinkedChat(chatId)) {
+                await ctx.reply('Ce chat n’est pas lie.');
+                return;
+            }
+            this.unlinkChat(chatId);
+            this.agents.delete(chatId);
+            this.pendingApprovals.delete(chatId);
+            await ctx.reply('Chat delie. Relance le lien/QR d’onboarding pour te reconnecter.');
+        });
+        this.bot.on('text', async (ctx) => {
+            const chatId = String(ctx.chat.id);
+            const text = ctx.message.text.trim();
+            if (!text || text.startsWith('/')) {
+                return;
+            }
+            if (ctx.chat.type !== 'private') {
+                await ctx.reply('Telegram supporte seulement les chats prives pour le moment.');
+                return;
+            }
+            if (!this.isLinkedChat(chatId)) {
+                await ctx.reply('Ce chat n’est pas encore lie. Utilise le QR ou le lien d’onboarding d’abord.');
+                return;
+            }
+            this.touchChat(chatId, ctx.from?.id, ctx.from?.username, ctx.from?.first_name);
+            await this.executeRun(chatId, text, [], ctx.reply.bind(ctx));
+        });
+        await this.bot.launch({ dropPendingUpdates: false });
+    }
+    async stop() {
+        if (this.stopped) {
+            return;
+        }
+        this.stopped = true;
+        this.bot.stop('Yagr Telegram gateway stopping');
+    }
+    async reply(chatId, message) {
+        const parts = splitTelegramMessage(message);
+        for (const part of parts) {
+            await this.bot.telegram.sendMessage(Number(chatId), part);
+        }
+    }
+    linkChat(chat) {
+        this.configService.updateLocalConfig((localConfig) => ({
+            ...localConfig,
+            telegram: {
+                ...localConfig.telegram,
+                linkedChats: upsertLinkedChat(localConfig.telegram?.linkedChats ?? [], chat),
+            },
+        }));
+    }
+    unlinkChat(chatId) {
+        this.configService.updateLocalConfig((localConfig) => ({
+            ...localConfig,
+            telegram: {
+                ...localConfig.telegram,
+                linkedChats: removeLinkedChat(localConfig.telegram?.linkedChats ?? [], chatId),
+            },
+        }));
+    }
+    touchChat(chatId, userId, username, firstName) {
+        const current = this.configService.getLocalConfig().telegram?.linkedChats ?? [];
+        const existing = current.find((entry) => String(entry.chatId) === String(chatId));
+        if (!existing) {
+            return;
+        }
+        this.linkChat({
+            ...existing,
+            chatId: String(chatId),
+            userId: userId ? String(userId) : existing.userId,
+            username: username ?? existing.username,
+            firstName: firstName ?? existing.firstName,
+            lastSeenAt: new Date().toISOString(),
+        });
+    }
+    isLinkedChat(chatId) {
+        const linkedChats = this.configService.getLocalConfig().telegram?.linkedChats ?? [];
+        return linkedChats.some((entry) => String(entry.chatId) === String(chatId));
+    }
+    async getEngine() {
+        this.enginePromise ??= this.engineResolver();
+        return await this.enginePromise;
+    }
+    async getAgent(chatId) {
+        const existing = this.agents.get(chatId);
+        if (existing) {
+            return existing;
+        }
+        const next = new YagrAgent(await this.getEngine());
+        this.agents.set(chatId, next);
+        return next;
+    }
+    async executeRun(chatId, prompt, satisfiedRequiredActions, reply) {
+        if (this.runningChats.has(chatId)) {
+            await reply('Un run est deja en cours pour ce chat. Attends sa fin avant d’envoyer une nouvelle demande.');
+            return;
+        }
+        this.runningChats.add(chatId);
+        try {
+            await reply('Yagr travaille...');
+            const result = await (await this.getAgent(chatId)).run(prompt, {
+                ...this.options,
+                display: undefined,
+                satisfiedRequiredActionIds: satisfiedRequiredActions.map((action) => action.id),
+            });
+            if (result.requiredActions.length > 0) {
+                this.pendingApprovals.set(chatId, result.requiredActions);
+            }
+            else {
+                this.pendingApprovals.delete(chatId);
+            }
+            const sections = [result.text.trim()];
+            const requiredActionsText = formatRequiredActions(result.requiredActions);
+            if (requiredActionsText) {
+                sections.push(requiredActionsText);
+            }
+            const message = sections.filter(Boolean).join('\n\n');
+            if (!message) {
+                await reply('Run termine, mais aucune reponse textuelle n’a ete produite.');
+                return;
+            }
+            for (const chunk of splitTelegramMessage(message)) {
+                await reply(chunk);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            await reply(`Run echoue: ${message}`);
+        }
+        finally {
+            this.runningChats.delete(chatId);
+        }
+    }
+}
+export async function runTelegramGateway(engineResolver, options = {}, configService = new YagrConfigService()) {
+    const runtime = createTelegramGatewayRuntime(engineResolver, options, configService);
+    for (const line of runtime.startupMessages) {
+        process.stdout.write(`${line}\n`);
+    }
+    if (runtime.onboardingLink) {
+        process.stdout.write(`Onboarding link: ${runtime.onboardingLink}\n`);
+        qrcode.generate(runtime.onboardingLink, { small: true });
+    }
+    await runtime.gateway.start();
+    await new Promise((resolve) => {
+        const stop = async () => {
+            await runtime.gateway.stop();
+            resolve();
+        };
+        process.once('SIGINT', () => {
+            void stop();
+        });
+        process.once('SIGTERM', () => {
+            void stop();
+        });
+    });
+}
+//# sourceMappingURL=telegram.js.map