@hopper-agent/core 0.1.1

package/dist/src/session-store.js

@@ -0,0 +1,112 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+const ULID_ALPHABET = '0123456789ABCDEFGHJKMNPQRSTVWXYZ';
+export function ulid(timestamp) {
+    const ts = timestamp ?? Date.now();
+    const timeBuf = new BigUint64Array(1);
+    const randBuf = new Uint8Array(16);
+    crypto.getRandomValues(randBuf);
+    const view = new DataView(timeBuf.buffer);
+    view.setBigUint64(0, BigInt(ts), false);
+    let result = '';
+    const timeBytes = new Uint8Array(timeBuf.buffer);
+    for (let i = 0; i < 10; i++) {
+        const idx = 9 - i;
+        const b = timeBytes[idx];
+        result += ULID_ALPHABET[b & 0x1f];
+    }
+    for (let i = 0; i < 16; i++) {
+        const b = randBuf[i];
+        result += ULID_ALPHABET[b & 0x1f];
+    }
+    return result;
+}
+export class SessionStore {
+    baseDir;
+    constructor(baseDir = path.join(os.homedir(), '.hopper-agent', 'sessions')) {
+        this.baseDir = baseDir;
+    }
+    sessionPath(id) {
+        return path.join(this.baseDir, id);
+    }
+    eventsPath(id) {
+        return path.join(this.sessionPath(id), 'events.jsonl');
+    }
+    metadataPath(id) {
+        return path.join(this.sessionPath(id), 'metadata.json');
+    }
+    getFiles(id) {
+        return {
+            path: this.sessionPath(id),
+            events: this.eventsPath(id),
+            metadata: this.metadataPath(id),
+        };
+    }
+    create(cwd, model, provider) {
+        const id = ulid();
+        const now = Date.now();
+        const info = { id, cwd, model, provider, createdAt: now, updatedAt: now };
+        const dir = this.sessionPath(id);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(this.metadataPath(id), JSON.stringify(info, null, 2) + '\n');
+        fs.closeSync(fs.openSync(this.eventsPath(id), 'a'));
+        return info;
+    }
+    load(id) {
+        const metaPath = this.metadataPath(id);
+        if (!fs.existsSync(metaPath))
+            return undefined;
+        return JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+    }
+    loadEvents(id) {
+        const eventsPath = this.eventsPath(id);
+        if (!fs.existsSync(eventsPath))
+            return [];
+        const content = fs.readFileSync(eventsPath, 'utf-8').trim();
+        if (!content)
+            return [];
+        return content
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    appendEvent(id, event) {
+        this.appendEvents(id, [event]);
+    }
+    appendEvents(id, events) {
+        const eventsPath = this.eventsPath(id);
+        const data = events.map((e) => JSON.stringify(e)).join('\n') + '\n';
+        fs.appendFileSync(eventsPath, data, 'utf-8');
+        this.touch(id);
+    }
+    list() {
+        if (!fs.existsSync(this.baseDir))
+            return [];
+        const entries = fs.readdirSync(this.baseDir, { withFileTypes: true });
+        const sessions = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const info = this.load(entry.name);
+            if (info)
+                sessions.push(info);
+        }
+        return sessions.sort((a, b) => b.updatedAt - a.updatedAt);
+    }
+    remove(id) {
+        const dir = this.sessionPath(id);
+        if (fs.existsSync(dir)) {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+    }
+    touch(id) {
+        const metaPath = this.metadataPath(id);
+        if (fs.existsSync(metaPath)) {
+            const info = JSON.parse(fs.readFileSync(metaPath, 'utf-8'));
+            info.updatedAt = Date.now();
+            fs.writeFileSync(metaPath, JSON.stringify(info, null, 2) + '\n');
+        }
+    }
+}
+//# sourceMappingURL=session-store.js.map

package/dist/src/session-store.js.map

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

package/dist/src/settings.d.ts

@@ -0,0 +1,41 @@
+export interface HopperSettings {
+    model: string;
+    effort: 'low' | 'medium' | 'high' | 'max' | 'auto';
+    mode: 'plan' | 'edit' | 'auto' | 'yolo';
+    theme: string;
+    statusline: boolean;
+    debug: boolean;
+    MODEL_PROVIDER?: string;
+    MODEL_URL?: string;
+    MODEL_API_KEY?: string;
+    OPENAI_API_KEY?: string;
+    OPENAI_URL?: string;
+    ANTHROPIC_API_KEY?: string;
+    ANTHROPIC_URL?: string;
+    OPENROUTER_API_KEY?: string;
+    OPENROUTER_URL?: string;
+    TELEGRAM_BOT_TOKEN?: string;
+    TELEGRAM_USER_ID?: string;
+    TELEGRAM_CHAT_ID?: string;
+    TELEGRAM_ALLOW_GROUPS?: boolean;
+    CHANNEL_TAB_ACTIVE?: string;
+    BRAVE_SEARCH_API_KEY?: string;
+    MCP_SERVERS?: Record<string, unknown>;
+    TOOLS_PER_CALL?: number;
+    WEBSEARCH_PER_CALL?: number;
+    HEARTBEAT?: 'on' | 'off';
+    HEARTBEAT_TIMES?: string;
+    HEARTBEAT_DAILY?: string;
+    HEARTBEAT_WEEKLY?: string;
+    HEARTBEAT_MONTHLY?: string;
+}
+export declare const DEFAULT_SETTINGS: HopperSettings;
+export declare class SettingsManager {
+    private settings;
+    constructor();
+    load(): HopperSettings;
+    save(): void;
+    update(partial: Partial<HopperSettings>): HopperSettings;
+    get(): HopperSettings;
+}
+//# sourceMappingURL=settings.d.ts.map

package/dist/src/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/settings.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACnD,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IAEf,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,SAAS,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,gBAAgB,EAAE,cAoB9B,CAAC;AAgBF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAiB;;IAMjC,IAAI,IAAI,cAAc;IAiEtB,IAAI,IAAI,IAAI;IAOZ,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc;IAMxD,GAAG,IAAI,cAAc;CAGtB"}

package/dist/src/settings.js

@@ -0,0 +1,128 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const DEFAULT_SETTINGS = {
+    model: 'claude-sonnet-4-6',
+    effort: 'auto',
+    mode: 'auto',
+    theme: 'tokyo-night',
+    statusline: true,
+    debug: false,
+    BRAVE_SEARCH_API_KEY: '',
+    TELEGRAM_BOT_TOKEN: '',
+    TELEGRAM_USER_ID: '',
+    TELEGRAM_CHAT_ID: '',
+    TELEGRAM_ALLOW_GROUPS: false,
+    CHANNEL_TAB_ACTIVE: 'main',
+    TOOLS_PER_CALL: 10,
+    WEBSEARCH_PER_CALL: 5,
+    HEARTBEAT: 'off',
+    HEARTBEAT_TIMES: '',
+    HEARTBEAT_DAILY: '6:00',
+    HEARTBEAT_WEEKLY: 'monday@6:00',
+    HEARTBEAT_MONTHLY: '1@6:00',
+};
+function migrateMode(raw) {
+    if (typeof raw !== 'string')
+        return DEFAULT_SETTINGS.mode;
+    switch (raw) {
+        case 'plan':
+        case 'edit':
+        case 'auto':
+        case 'yolo': return raw;
+        case 'auto-edit': return 'edit';
+        case 'manual': return 'auto';
+        case 'full-auto': return 'yolo';
+        default: return DEFAULT_SETTINGS.mode;
+    }
+}
+const CONFIG_DIR = join(homedir(), '.hopper-agent');
+const SETTINGS_FILE = join(CONFIG_DIR, 'settings.json');
+export class SettingsManager {
+    settings;
+    constructor() {
+        this.settings = { ...DEFAULT_SETTINGS };
+    }
+    load() {
+        this.settings = { ...DEFAULT_SETTINGS };
+        if (existsSync(SETTINGS_FILE)) {
+            try {
+                const raw = readFileSync(SETTINGS_FILE, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (parsed && typeof parsed === 'object') {
+                    // Accept MODEL_URL / MODEL_API_KEY regardless of casing (users
+                    // commonly write model_url, ModelUrl, MODEL_API, etc.).
+                    const pick = (...keys) => {
+                        for (const key of keys) {
+                            const direct = parsed[key];
+                            if (typeof direct === 'string' && direct.length > 0)
+                                return direct;
+                        }
+                        const normalize = (s) => s.replace(/[_-]/g, '').toLowerCase();
+                        const targets = keys.map(normalize);
+                        for (const [k, v] of Object.entries(parsed)) {
+                            if (typeof v !== 'string' || v.length === 0)
+                                continue;
+                            if (targets.includes(normalize(k)))
+                                return v;
+                        }
+                        return undefined;
+                    };
+                    const merged = {
+                        model: parsed.model ?? DEFAULT_SETTINGS.model,
+                        effort: parsed.effort ?? DEFAULT_SETTINGS.effort,
+                        mode: migrateMode(parsed.mode),
+                        theme: parsed.theme ?? DEFAULT_SETTINGS.theme,
+                        statusline: parsed.statusline ?? DEFAULT_SETTINGS.statusline,
+                        debug: parsed.debug ?? DEFAULT_SETTINGS.debug,
+                        BRAVE_SEARCH_API_KEY: pick('BRAVE_SEARCH_API_KEY', 'brave_search_api_key', 'braveSearchApiKey', 'BRAVE_API_KEY'),
+                        MODEL_URL: pick('MODEL_URL', 'model_url', 'modelUrl', 'MODEL_BASE_URL', 'baseUrl'),
+                        MODEL_API_KEY: pick('MODEL_API_KEY', 'model_api_key', 'MODEL_API', 'model_api', 'modelApiKey', 'apiKey', 'API_KEY'),
+                        MODEL_PROVIDER: pick('MODEL_PROVIDER', 'model_provider', 'modelProvider'),
+                        OPENAI_API_KEY: pick('OPENAI_API_KEY', 'openai_api_key', 'openaiApiKey'),
+                        OPENAI_URL: pick('OPENAI_URL', 'openai_url', 'openaiBaseUrl', 'OPENAI_BASE_URL', 'openai_base_url'),
+                        ANTHROPIC_API_KEY: pick('ANTHROPIC_API_KEY', 'anthropic_api_key', 'anthropicApiKey'),
+                        ANTHROPIC_URL: pick('ANTHROPIC_URL', 'anthropic_url', 'anthropicUrl'),
+                        OPENROUTER_API_KEY: pick('OPENROUTER_API_KEY', 'openrouter_api_key', 'openrouterApiKey'),
+                        OPENROUTER_URL: pick('OPENROUTER_URL', 'openrouter_url', 'openrouterUrl'),
+                        TELEGRAM_BOT_TOKEN: pick('TELEGRAM_BOT_TOKEN', 'telegram_bot_token', 'telegramBotToken'),
+                        TELEGRAM_USER_ID: pick('TELEGRAM_USER_ID', 'telegram_user_id', 'telegramUserId'),
+                        TELEGRAM_CHAT_ID: pick('TELEGRAM_CHAT_ID', 'telegram_chat_id', 'telegramChatId'),
+                        TELEGRAM_ALLOW_GROUPS: parsed.TELEGRAM_ALLOW_GROUPS ?? false,
+                        CHANNEL_TAB_ACTIVE: parsed.CHANNEL_TAB_ACTIVE ?? 'main',
+                        MCP_SERVERS: parsed.MCP_SERVERS ?? parsed.mcp_servers,
+                        TOOLS_PER_CALL: (typeof parsed.TOOLS_PER_CALL === 'number' && parsed.TOOLS_PER_CALL > 0)
+                            ? parsed.TOOLS_PER_CALL : DEFAULT_SETTINGS.TOOLS_PER_CALL,
+                        WEBSEARCH_PER_CALL: (typeof parsed.WEBSEARCH_PER_CALL === 'number' && parsed.WEBSEARCH_PER_CALL > 0)
+                            ? parsed.WEBSEARCH_PER_CALL : DEFAULT_SETTINGS.WEBSEARCH_PER_CALL,
+                        HEARTBEAT: parsed.HEARTBEAT ?? DEFAULT_SETTINGS.HEARTBEAT,
+                        HEARTBEAT_TIMES: parsed.HEARTBEAT_TIMES ?? parsed.HEARTBEAT_HOURLY ?? DEFAULT_SETTINGS.HEARTBEAT_TIMES,
+                        HEARTBEAT_DAILY: parsed.HEARTBEAT_DAILY ?? DEFAULT_SETTINGS.HEARTBEAT_DAILY,
+                        HEARTBEAT_WEEKLY: parsed.HEARTBEAT_WEEKLY ?? DEFAULT_SETTINGS.HEARTBEAT_WEEKLY,
+                        HEARTBEAT_MONTHLY: parsed.HEARTBEAT_MONTHLY ?? DEFAULT_SETTINGS.HEARTBEAT_MONTHLY,
+                    };
+                    this.settings = merged;
+                }
+            }
+            catch {
+                // ignore parse errors, use defaults
+            }
+        }
+        return this.settings;
+    }
+    save() {
+        if (!existsSync(CONFIG_DIR)) {
+            mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+        writeFileSync(SETTINGS_FILE, JSON.stringify(this.settings, null, 2) + '\n');
+    }
+    update(partial) {
+        this.settings = { ...this.settings, ...partial };
+        this.save();
+        return this.settings;
+    }
+    get() {
+        return { ...this.settings };
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/src/settings.js.map

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

package/dist/src/telegram-gateway.d.ts

@@ -0,0 +1,35 @@
+export interface TelegramMessageContext {
+    text: string;
+    chatId: string;
+    userId: string;
+    isGroup: boolean;
+    chatTitle?: string;
+}
+export interface TelegramGatewayConfig {
+    botToken: string;
+    allowedUserId: string;
+    onUserMessage: (ctx: TelegramMessageContext) => void;
+    /** Called when user taps Approve/Deny on an approval inline keyboard. */
+    onApprovalDecision?: (toolCallId: string, approved: boolean) => void;
+    onError?: (error: Error) => void;
+}
+export declare class TelegramGateway {
+    private bot;
+    private isRunning;
+    private config;
+    private typingTimers;
+    constructor(config: TelegramGatewayConfig);
+    private setupHandlers;
+    sendMessage(chatId: string, text: string): Promise<void>;
+    /**
+     * Send an inline keyboard approval request to a Telegram chat.
+     */
+    sendApprovalRequest(chatId: string, toolCallId: string, toolName: string, inputSummary: string): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    setOnApprovalDecision(fn: (toolCallId: string, approved: boolean) => void): void;
+    get isAlive(): boolean;
+    startTyping(chatId: string): void;
+    stopTyping(chatId: string): void;
+}
+//# sourceMappingURL=telegram-gateway.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-gateway.d.ts","sourceRoot":"","sources":["../../src/telegram-gateway.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACrD,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACrE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,YAAY,CAA0C;gBAElD,MAAM,EAAE,qBAAqB;IAMzC,OAAO,CAAC,aAAa;IAoDf,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9D;;OAEG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAyBV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,qBAAqB,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAIhF,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAmBjC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAOjC"}

package/dist/src/telegram-gateway.js

@@ -0,0 +1,145 @@
+import { Bot } from 'grammy';
+export class TelegramGateway {
+    bot;
+    isRunning = false;
+    config;
+    typingTimers = new Map();
+    constructor(config) {
+        this.config = config;
+        this.bot = new Bot(config.botToken);
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        // Only process text messages
+        this.bot.on('message:text', async (ctx) => {
+            const msg = ctx.message.text;
+            const userId = String(ctx.from?.id ?? '');
+            const chatId = String(ctx.chat.id);
+            const chatType = ctx.chat.type;
+            const chatTitle = ctx.chat.title;
+            // User ID filtering — gatekeeper logic
+            if (userId !== this.config.allowedUserId) {
+                return;
+            }
+            this.config.onUserMessage({
+                text: msg,
+                chatId,
+                userId,
+                isGroup: chatType === 'group' || chatType === 'supergroup',
+                chatTitle,
+            });
+            // Show typing indicator — Telegram's indicator expires after ~5s,
+            // so we keep resending every 4s until stopTyping is called.
+            this.startTyping(chatId);
+        });
+        // Handle inline keyboard button taps for approval decisions
+        this.bot.on('callback_query', async (ctx) => {
+            const data = ctx.callbackQuery.data;
+            if (!data) {
+                await ctx.answerCallbackQuery();
+                return;
+            }
+            const pipeIndex = data.indexOf('|');
+            if (pipeIndex === -1) {
+                await ctx.answerCallbackQuery();
+                return;
+            }
+            const action = data.slice(0, pipeIndex);
+            const toolCallId = data.slice(pipeIndex + 1);
+            const approved = action === 'approve';
+            this.config.onApprovalDecision?.(toolCallId, approved);
+            await ctx.answerCallbackQuery(); // dismiss the loading spinner
+        });
+        // Catch-all error handler
+        this.bot.catch((err) => {
+            console.error('[telegram-gateway] Error:', err.error);
+            this.config.onError?.(err.error);
+        });
+    }
+    async sendMessage(chatId, text) {
+        try {
+            await this.bot.api.sendMessage(chatId, text);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`[telegram-gateway] sendMessage failed for chat ${chatId}: ${msg}`);
+            throw err;
+        }
+    }
+    /**
+     * Send an inline keyboard approval request to a Telegram chat.
+     */
+    async sendApprovalRequest(chatId, toolCallId, toolName, inputSummary) {
+        // Strip non-printable chars and escape HTML to avoid Telegram parse failures
+        const safe = (s) => s.replace(/[^\x20-\x7E]/g, '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+        const cleanSummary = safe(inputSummary).replace(/[\r\n]/g, ' ').slice(0, 200);
+        const text = '[Tool approval needed]\n\n<b>' + safe(toolName) + '</b>\n' + cleanSummary;
+        try {
+            await this.bot.api.sendMessage(chatId, text, {
+                reply_markup: {
+                    inline_keyboard: [
+                        [
+                            { text: 'Allow', callback_data: 'approve|' + toolCallId },
+                            { text: 'Deny', callback_data: 'deny|' + toolCallId },
+                        ],
+                    ],
+                },
+                parse_mode: 'HTML',
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error('[telegram-gateway] sendApprovalRequest failed for chat ' + chatId + ': ' + msg);
+            throw err;
+        }
+    }
+    async start() {
+        if (this.isRunning)
+            return;
+        this.isRunning = true;
+        await this.bot.start();
+        console.log('[telegram-gateway] Bot started (polling)');
+    }
+    async stop() {
+        if (!this.isRunning)
+            return;
+        this.isRunning = false;
+        // Clear all typing timers
+        for (const timer of this.typingTimers.values()) {
+            clearInterval(timer);
+        }
+        this.typingTimers.clear();
+        await this.bot.stop();
+        console.log('[telegram-gateway] Bot stopped');
+    }
+    setOnApprovalDecision(fn) {
+        this.config.onApprovalDecision = fn;
+    }
+    get isAlive() {
+        return this.isRunning;
+    }
+    startTyping(chatId) {
+        // If already typing, don't start another timer
+        if (this.typingTimers.has(chatId))
+            return;
+        console.error(`[telegram-gateway] startTyping for ${chatId}, isRunning=${this.isRunning}`);
+        const send = () => {
+            if (this.isRunning) {
+                this.bot.api.sendChatAction(chatId, 'typing').catch((err) => {
+                    console.error(`[telegram-gateway] sendChatAction failed for ${chatId}:`, err?.message || err);
+                });
+            }
+        };
+        send(); // Send immediately
+        const interval = setInterval(send, 4000);
+        this.typingTimers.set(chatId, interval);
+    }
+    stopTyping(chatId) {
+        const timer = this.typingTimers.get(chatId);
+        if (timer) {
+            clearInterval(timer);
+            this.typingTimers.delete(chatId);
+        }
+    }
+}
+//# sourceMappingURL=telegram-gateway.js.map

package/dist/src/telegram-gateway.js.map

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

package/dist/src/turn-loop.d.ts

@@ -0,0 +1,106 @@
+import { EventBus, type Event } from './event-bus.js';
+import { SessionStore } from './session-store.js';
+import { type ApprovalMode } from './permission.js';
+import type { HopperSettings } from './settings.js';
+export type ReasoningEffort = 'low' | 'medium' | 'high' | 'max' | 'auto';
+export interface ProviderStream {
+    name: string;
+    stream(args: {
+        messages: Array<{
+            role: string;
+            content: unknown;
+        }>;
+        tools?: Array<{
+            name: string;
+            description: string;
+            inputSchema: unknown;
+        }>;
+        model?: string;
+        system?: string;
+        signal?: AbortSignal;
+        effort?: ReasoningEffort;
+    }): AsyncIterable<ProviderEvent>;
+    /** Non-streaming call — used for quick evaluations (e.g. harm-check). */
+    check(prompt: string, args?: {
+        model?: string;
+        system?: string;
+    }): Promise<string>;
+}
+export interface Tool {
+    definition: {
+        name: string;
+        description: string;
+        inputSchema: unknown;
+    };
+    execute: (input: Record<string, unknown>, settings: any) => Promise<{
+        output: unknown;
+        error?: string;
+    }>;
+}
+export type ProviderEvent = {
+    type: 'text-delta';
+    text: string;
+} | {
+    type: 'thinking-block';
+    thinking: string;
+    signature: string;
+} | {
+    type: 'tool-call';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+} | {
+    type: 'tool-result-request';
+    callId: string;
+} | {
+    type: 'usage';
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+} | {
+    type: 'stop';
+    reason: string;
+};
+export interface TurnLoopConfig {
+    provider: ProviderStream;
+    model: string;
+    tools: Tool[];
+    cwd: string;
+    settings: HopperSettings;
+    approvalMode?: ApprovalMode;
+    permissions?: Record<string, string[]>;
+    maxTurns?: number;
+    system?: string;
+    effort?: ReasoningEffort;
+    /** If provided, resume this session instead of creating a new one. */
+    sessionId?: string;
+    /** Called when a tool call needs interactive approval. Return true to allow, false to deny. */
+    onApprovalAsk?: (req: {
+        name: string;
+        input: Record<string, unknown>;
+        reason: string;
+    }) => Promise<boolean>;
+}
+export interface TurnLoopResult {
+    events: Event[];
+    sessionId: string;
+    reason: string;
+}
+export declare class TurnLoop {
+    private bus;
+    private store;
+    private permission;
+    private config;
+    private abort;
+    private abortController;
+    private messages;
+    private activeSessionId;
+    constructor(config: TurnLoopConfig, store?: SessionStore);
+    get eventBus(): EventBus;
+    getSessionId(): string | undefined;
+    cancel(): void;
+    private evaluateHarm;
+    run(prompt: string): Promise<TurnLoopResult>;
+}
+//# sourceMappingURL=turn-loop.d.ts.map

package/dist/src/turn-loop.d.ts.map

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