remoat 0.2.0

package/dist/services/planningDetector.d.ts

@@ -0,0 +1,87 @@
+import { CdpService } from './cdpService';
+/** Planning mode button information */
+export interface PlanningInfo {
+    /** Open button text */
+    openText: string;
+    /** Proceed button text */
+    proceedText: string;
+    /** Plan title (file name shown in the card) */
+    planTitle: string;
+    /** Plan summary text */
+    planSummary: string;
+    /** Plan description (markdown rendered in leading-relaxed container) */
+    description: string;
+}
+export interface PlanningDetectorOptions {
+    /** CDP service instance */
+    cdpService: CdpService;
+    /** Poll interval in milliseconds (default: 2000ms) */
+    pollIntervalMs?: number;
+    /** Callback when planning buttons are detected */
+    onPlanningRequired: (info: PlanningInfo) => void;
+    /** Callback when a previously detected planning state is resolved (buttons disappeared) */
+    onResolved?: () => void;
+}
+/**
+ * Detects planning mode buttons (Open/Proceed) in the Antigravity UI via polling.
+ *
+ * Follows the same polling pattern as ApprovalDetector:
+ * - start()/stop() lifecycle
+ * - Duplicate notification prevention via lastDetectedKey
+ * - CDP error tolerance (continues polling on error)
+ */
+export declare class PlanningDetector {
+    private cdpService;
+    private pollIntervalMs;
+    private onPlanningRequired;
+    private onResolved?;
+    private pollTimer;
+    private isRunning;
+    /** Key of the last detected planning info (for duplicate notification prevention) */
+    private lastDetectedKey;
+    /** Full PlanningInfo from the last detection */
+    private lastDetectedInfo;
+    /** Timestamp of last notification (for cooldown-based dedup) */
+    private lastNotifiedAt;
+    /** Cooldown period in ms to suppress duplicate notifications */
+    private static readonly COOLDOWN_MS;
+    constructor(options: PlanningDetectorOptions);
+    /** Start monitoring. */
+    start(): void;
+    /** Stop monitoring. */
+    stop(): Promise<void>;
+    /** Return the last detected planning info. Returns null if nothing has been detected. */
+    getLastDetectedInfo(): PlanningInfo | null;
+    /** Returns whether monitoring is currently active. */
+    isActive(): boolean;
+    /**
+     * Click the Open button via CDP.
+     * @param buttonText Text of the button to click (default: detected openText or "Open")
+     * @returns true if click succeeded
+     */
+    clickOpenButton(buttonText?: string): Promise<boolean>;
+    /**
+     * Click the Proceed button via CDP.
+     * @param buttonText Text of the button to click (default: detected proceedText or "Proceed")
+     * @returns true if click succeeded
+     */
+    clickProceedButton(buttonText?: string): Promise<boolean>;
+    /**
+     * Extract plan content from the DOM after Open has been clicked.
+     * @returns Plan content text or null if not found
+     */
+    extractPlanContent(): Promise<string | null>;
+    /** Schedule the next poll. */
+    private schedulePoll;
+    /**
+     * Single poll iteration:
+     *   1. Get planning button info from DOM (with contextId)
+     *   2. Notify via callback only on new detection (prevent duplicates)
+     *   3. Reset lastDetectedKey / lastDetectedInfo when buttons disappear
+     */
+    private poll;
+    /** Internal click handler using buildClickScript from approvalDetector. */
+    private clickButton;
+    /** Execute Runtime.evaluate with contextId and return result.value. */
+    private runEvaluateScript;
+}

package/dist/services/planningDetector.js

@@ -0,0 +1,321 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlanningDetector = void 0;
+const logger_1 = require("../utils/logger");
+const approvalDetector_1 = require("./approvalDetector");
+/**
+ * Detection script for the Antigravity UI planning mode.
+ *
+ * Looks for Open/Proceed button pairs inside .notify-user-container
+ * and extracts plan metadata from the surrounding DOM elements.
+ */
+const DETECT_PLANNING_SCRIPT = `(() => {
+    const OPEN_PATTERNS = ['open'];
+    const PROCEED_PATTERNS = ['proceed'];
+
+    const normalize = (text) => (text || '').toLowerCase().replace(/\\s+/g, ' ').trim();
+
+    // Find the notify container that holds planning UI
+    const container = document.querySelector('.notify-user-container');
+    if (!container) return null;
+
+    const allButtons = Array.from(container.querySelectorAll('button'))
+        .filter(btn => btn.offsetParent !== null);
+
+    const openBtn = allButtons.find(btn => {
+        const t = normalize(btn.textContent || '');
+        return OPEN_PATTERNS.some(p => t === p || t.includes(p));
+    }) || null;
+
+    const proceedBtn = allButtons.find(btn => {
+        const t = normalize(btn.textContent || '');
+        return PROCEED_PATTERNS.some(p => t === p || t.includes(p));
+    }) || null;
+
+    // Both buttons must exist for this to be a planning UI
+    if (!openBtn || !proceedBtn) return null;
+
+    const openText = (openBtn.textContent || '').trim();
+    const proceedText = (proceedBtn.textContent || '').trim();
+
+    // Extract plan title from .inline-flex.break-all
+    const titleEl = container.querySelector('span.inline-flex.break-all, .inline-flex.break-all');
+    const planTitle = titleEl ? (titleEl.textContent || '').trim() : '';
+
+    // Extract plan summary from span.text-sm (excluding buttons text)
+    const summaryEls = Array.from(container.querySelectorAll('span.text-sm'));
+    const planSummary = summaryEls
+        .map(el => (el.textContent || '').trim())
+        .filter(text => text.length > 0 && text !== openText && text !== proceedText)
+        .join(' ');
+
+    // Extract description from leading-relaxed container, skipping code/style blocks
+    const descEl = container.querySelector('.leading-relaxed.select-text');
+    let description = '';
+    if (descEl) {
+        const SKIP_TAGS = new Set(['PRE', 'CODE', 'STYLE', 'SCRIPT']);
+        const parts = [];
+        const walk = (node) => {
+            if (node.nodeType === 3) {
+                const t = node.textContent || '';
+                if (t.trim()) parts.push(t.trim());
+            } else if (node.nodeType === 1 && !SKIP_TAGS.has(node.tagName)) {
+                for (const child of node.childNodes) walk(child);
+            }
+        };
+        walk(descEl);
+        description = parts.join(' ').slice(0, 500);
+    }
+
+    return { openText, proceedText, planTitle, planSummary, description };
+})()`;
+/**
+ * Extract plan content displayed after clicking Open.
+ *
+ * Looks for the rendered markdown inside the plan content area
+ * and returns the text, truncated to 4000 characters for Telegram message limits.
+ */
+const EXTRACT_PLAN_CONTENT_SCRIPT = `(() => {
+    // Simple HTML-to-Markdown converter for plan content
+    const htmlToMd = (el) => {
+        const parts = [];
+        const process = (node) => {
+            if (node.nodeType === 3) {
+                parts.push(node.textContent || '');
+                return;
+            }
+            if (node.nodeType !== 1) return;
+            const tag = node.tagName;
+            if (tag === 'H1') { parts.push('\\n# '); node.childNodes.forEach(process); parts.push('\\n'); return; }
+            if (tag === 'H2') { parts.push('\\n## '); node.childNodes.forEach(process); parts.push('\\n'); return; }
+            if (tag === 'H3') { parts.push('\\n### '); node.childNodes.forEach(process); parts.push('\\n'); return; }
+            if (tag === 'H4') { parts.push('\\n#### '); node.childNodes.forEach(process); parts.push('\\n'); return; }
+            if (tag === 'STRONG' || tag === 'B') { parts.push('**'); node.childNodes.forEach(process); parts.push('**'); return; }
+            if (tag === 'EM' || tag === 'I') { parts.push('*'); node.childNodes.forEach(process); parts.push('*'); return; }
+            if (tag === 'PRE') {
+                const code = node.querySelector('code');
+                const text = code ? (code.textContent || '') : (node.textContent || '');
+                parts.push('\\n\`\`\`\\n' + text + '\\n\`\`\`\\n');
+                return;
+            }
+            if (tag === 'CODE') { parts.push('\`' + (node.textContent || '') + '\`'); return; }
+            if (tag === 'A') {
+                const href = node.getAttribute('href') || '';
+                parts.push('['); node.childNodes.forEach(process); parts.push('](' + href + ')');
+                return;
+            }
+            if (tag === 'LI') { parts.push('\\n- '); node.childNodes.forEach(process); return; }
+            if (tag === 'BR') { parts.push('\\n'); return; }
+            if (tag === 'P') { parts.push('\\n\\n'); node.childNodes.forEach(process); parts.push('\\n'); return; }
+            if (tag === 'UL' || tag === 'OL') { node.childNodes.forEach(process); parts.push('\\n'); return; }
+            if (tag === 'STYLE' || tag === 'SCRIPT') return;
+            node.childNodes.forEach(process);
+        };
+        process(el);
+        return parts.join('').replace(/\\n{3,}/g, '\\n\\n').trim();
+    };
+
+    // Primary selector: plan content container
+    const contentContainer = document.querySelector(
+        'div.relative.pl-4.pr-4.py-1, div.relative.pl-4.pr-4'
+    );
+    if (contentContainer) {
+        const textEl = contentContainer.querySelector('.leading-relaxed.select-text');
+        if (textEl) {
+            return htmlToMd(textEl);
+        }
+    }
+
+    // Fallback: any leading-relaxed.select-text with significant content
+    const allLeading = Array.from(document.querySelectorAll('.leading-relaxed.select-text'));
+    for (const el of allLeading) {
+        const md = htmlToMd(el);
+        if (md.length > 100) {
+            return md;
+        }
+    }
+
+    return null;
+})()`;
+/**
+ * Detects planning mode buttons (Open/Proceed) in the Antigravity UI via polling.
+ *
+ * Follows the same polling pattern as ApprovalDetector:
+ * - start()/stop() lifecycle
+ * - Duplicate notification prevention via lastDetectedKey
+ * - CDP error tolerance (continues polling on error)
+ */
+class PlanningDetector {
+    cdpService;
+    pollIntervalMs;
+    onPlanningRequired;
+    onResolved;
+    pollTimer = null;
+    isRunning = false;
+    /** Key of the last detected planning info (for duplicate notification prevention) */
+    lastDetectedKey = null;
+    /** Full PlanningInfo from the last detection */
+    lastDetectedInfo = null;
+    /** Timestamp of last notification (for cooldown-based dedup) */
+    lastNotifiedAt = 0;
+    /** Cooldown period in ms to suppress duplicate notifications */
+    static COOLDOWN_MS = 5000;
+    constructor(options) {
+        this.cdpService = options.cdpService;
+        this.pollIntervalMs = options.pollIntervalMs ?? 2000;
+        this.onPlanningRequired = options.onPlanningRequired;
+        this.onResolved = options.onResolved;
+    }
+    /** Start monitoring. */
+    start() {
+        if (this.isRunning)
+            return;
+        this.isRunning = true;
+        this.lastDetectedKey = null;
+        this.lastDetectedInfo = null;
+        this.lastNotifiedAt = 0;
+        this.schedulePoll();
+    }
+    /** Stop monitoring. */
+    async stop() {
+        this.isRunning = false;
+        if (this.pollTimer) {
+            clearTimeout(this.pollTimer);
+            this.pollTimer = null;
+        }
+    }
+    /** Return the last detected planning info. Returns null if nothing has been detected. */
+    getLastDetectedInfo() {
+        return this.lastDetectedInfo;
+    }
+    /** Returns whether monitoring is currently active. */
+    isActive() {
+        return this.isRunning;
+    }
+    /**
+     * Click the Open button via CDP.
+     * @param buttonText Text of the button to click (default: detected openText or "Open")
+     * @returns true if click succeeded
+     */
+    async clickOpenButton(buttonText) {
+        const text = buttonText ?? this.lastDetectedInfo?.openText ?? 'Open';
+        return this.clickButton(text);
+    }
+    /**
+     * Click the Proceed button via CDP.
+     * @param buttonText Text of the button to click (default: detected proceedText or "Proceed")
+     * @returns true if click succeeded
+     */
+    async clickProceedButton(buttonText) {
+        const text = buttonText ?? this.lastDetectedInfo?.proceedText ?? 'Proceed';
+        return this.clickButton(text);
+    }
+    /**
+     * Extract plan content from the DOM after Open has been clicked.
+     * @returns Plan content text or null if not found
+     */
+    async extractPlanContent() {
+        try {
+            const result = await this.runEvaluateScript(EXTRACT_PLAN_CONTENT_SCRIPT);
+            return typeof result === 'string' ? result : null;
+        }
+        catch (error) {
+            logger_1.logger.error('[PlanningDetector] Error extracting plan content:', error);
+            return null;
+        }
+    }
+    /** Schedule the next poll. */
+    schedulePoll() {
+        if (!this.isRunning)
+            return;
+        this.pollTimer = setTimeout(async () => {
+            await this.poll();
+            if (this.isRunning) {
+                this.schedulePoll();
+            }
+        }, this.pollIntervalMs);
+    }
+    /**
+     * Single poll iteration:
+     *   1. Get planning button info from DOM (with contextId)
+     *   2. Notify via callback only on new detection (prevent duplicates)
+     *   3. Reset lastDetectedKey / lastDetectedInfo when buttons disappear
+     */
+    async poll() {
+        try {
+            const contextId = this.cdpService.getPrimaryContextId();
+            const callParams = {
+                expression: DETECT_PLANNING_SCRIPT,
+                returnByValue: true,
+                awaitPromise: false,
+            };
+            if (contextId !== null) {
+                callParams.contextId = contextId;
+            }
+            const result = await this.cdpService.call('Runtime.evaluate', callParams);
+            const info = result?.result?.value ?? null;
+            if (info) {
+                // Duplicate prevention: use button text pair as key (stable across DOM redraws)
+                const key = `${info.openText}::${info.proceedText}`;
+                const now = Date.now();
+                const withinCooldown = (now - this.lastNotifiedAt) < PlanningDetector.COOLDOWN_MS;
+                if (key !== this.lastDetectedKey && !withinCooldown) {
+                    this.lastDetectedKey = key;
+                    this.lastDetectedInfo = info;
+                    this.lastNotifiedAt = now;
+                    Promise.resolve(this.onPlanningRequired(info)).catch((err) => {
+                        logger_1.logger.error('[PlanningDetector] onPlanningRequired callback failed:', err);
+                    });
+                }
+                else if (key === this.lastDetectedKey) {
+                    // Same key — update stored info silently
+                    this.lastDetectedInfo = info;
+                }
+            }
+            else {
+                // Reset when buttons disappear (prepare for next planning detection)
+                const wasDetected = this.lastDetectedKey !== null;
+                this.lastDetectedKey = null;
+                this.lastDetectedInfo = null;
+                if (wasDetected && this.onResolved) {
+                    this.onResolved();
+                }
+            }
+        }
+        catch (error) {
+            // Ignore CDP errors and continue monitoring
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.includes('WebSocket is not connected')) {
+                return;
+            }
+            logger_1.logger.error('[PlanningDetector] Error during polling:', error);
+        }
+    }
+    /** Internal click handler using buildClickScript from approvalDetector. */
+    async clickButton(buttonText) {
+        try {
+            const result = await this.runEvaluateScript((0, approvalDetector_1.buildClickScript)(buttonText));
+            return result?.ok === true;
+        }
+        catch (error) {
+            logger_1.logger.error('[PlanningDetector] Error while clicking button:', error);
+            return false;
+        }
+    }
+    /** Execute Runtime.evaluate with contextId and return result.value. */
+    async runEvaluateScript(expression) {
+        const contextId = this.cdpService.getPrimaryContextId();
+        const callParams = {
+            expression,
+            returnByValue: true,
+            awaitPromise: false,
+        };
+        if (contextId !== null) {
+            callParams.contextId = contextId;
+        }
+        const result = await this.cdpService.call('Runtime.evaluate', callParams);
+        return result?.result?.value;
+    }
+}
+exports.PlanningDetector = PlanningDetector;
+//# sourceMappingURL=planningDetector.js.map

package/dist/services/planningDetector.js.map

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

package/dist/services/processManager.d.ts

@@ -0,0 +1,18 @@
+export interface TaskOptions {
+    id: string;
+    command: string;
+    args: string[];
+    cwd: string;
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+    onClose?: (code: number) => void;
+}
+export declare class ProcessManager {
+    private maxConcurrentTasks;
+    private queue;
+    private runningProcesses;
+    constructor(maxConcurrentTasks?: number);
+    submitTask(options: TaskOptions): Promise<void>;
+    private runNext;
+    stopTask(taskId: string): boolean;
+}

package/dist/services/processManager.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessManager = void 0;
+const child_process_1 = require("child_process");
+class ProcessManager {
+    maxConcurrentTasks;
+    queue = [];
+    runningProcesses = new Map();
+    constructor(maxConcurrentTasks = 1) {
+        this.maxConcurrentTasks = maxConcurrentTasks;
+    }
+    async submitTask(options) {
+        this.queue.push(options);
+        this.runNext();
+    }
+    runNext() {
+        if (this.runningProcesses.size >= this.maxConcurrentTasks) {
+            return;
+        }
+        const nextTask = this.queue.shift();
+        if (!nextTask) {
+            return;
+        }
+        const { id, command, args, cwd, onStdout, onStderr, onClose } = nextTask;
+        const child = (0, child_process_1.spawn)(command, args, { cwd });
+        this.runningProcesses.set(id, child);
+        child.stdout?.on('data', (data) => {
+            if (onStdout) {
+                onStdout(data.toString());
+            }
+        });
+        child.stderr?.on('data', (data) => {
+            if (onStderr) {
+                onStderr(data.toString());
+            }
+        });
+        child.on('close', (code) => {
+            this.runningProcesses.delete(id);
+            if (onClose) {
+                onClose(code ?? 0);
+            }
+            this.runNext();
+        });
+    }
+    stopTask(taskId) {
+        const child = this.runningProcesses.get(taskId);
+        if (child) {
+            child.kill();
+            this.runningProcesses.delete(taskId);
+            return true;
+        }
+        // Check if queued
+        const indexInQueue = this.queue.findIndex((task) => task.id === taskId);
+        if (indexInQueue !== -1) {
+            this.queue.splice(indexInQueue, 1);
+            return true;
+        }
+        return false;
+    }
+}
+exports.ProcessManager = ProcessManager;
+//# sourceMappingURL=processManager.js.map

package/dist/services/processManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processManager.js","sourceRoot":"","sources":["../../src/services/processManager.ts"],"names":[],"mappings":";;;AAAA,iDAAoD;AAYpD,MAAa,cAAc;IACf,kBAAkB,CAAS;IAC3B,KAAK,GAAkB,EAAE,CAAC;IAC1B,gBAAgB,GAA8B,IAAI,GAAG,EAAE,CAAC;IAEhE,YAAY,qBAA6B,CAAC;QACtC,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IACjD,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,OAAoB;QACxC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;IAEO,OAAO;QACX,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxD,OAAO;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,OAAO;QACX,CAAC;QAED,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;QAEzE,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAErC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAqB,EAAE,EAAE;YAC/C,IAAI,QAAQ,EAAE,CAAC;gBACX,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAqB,EAAE,EAAE;YAC/C,IAAI,QAAQ,EAAE,CAAC;gBACX,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAmB,EAAE,EAAE;YACtC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YACvB,CAAC;YACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC,CAAC,CAAC;IACP,CAAC;IAEM,QAAQ,CAAC,MAAc;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,KAAK,EAAE,CAAC;YACR,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,kBAAkB;QAClB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QACxE,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ;AAjED,wCAiEC"}

package/dist/services/progressSender.d.ts

@@ -0,0 +1,20 @@
+export interface ProgressSenderOptions {
+    send: (content: string) => Promise<unknown>;
+    throttleMs?: number;
+    maxLength?: number;
+    wrapInCodeBlock?: boolean;
+}
+export declare class ProgressSender {
+    private throttleMs;
+    private maxLength;
+    private wrapInCodeBlock;
+    private buffer;
+    private timer;
+    private sendContent;
+    constructor(options: ProgressSenderOptions);
+    append(text: string): void;
+    forceEmit(): void;
+    dispose(): void;
+    private emit;
+    private splitByLength;
+}

package/dist/services/progressSender.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressSender = void 0;
+class ProgressSender {
+    throttleMs;
+    maxLength;
+    wrapInCodeBlock;
+    buffer = '';
+    timer = null;
+    sendContent;
+    constructor(options) {
+        this.sendContent = options.send;
+        this.throttleMs = options.throttleMs ?? 3000;
+        this.maxLength = options.maxLength ?? 4000;
+        this.wrapInCodeBlock = options.wrapInCodeBlock ?? true;
+    }
+    append(text) {
+        this.buffer += text;
+        if (!this.timer) {
+            this.timer = setTimeout(() => {
+                this.emit();
+            }, this.throttleMs);
+        }
+    }
+    forceEmit() {
+        this.emit();
+    }
+    dispose() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.buffer = '';
+    }
+    emit() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (!this.buffer)
+            return;
+        const payload = this.buffer;
+        this.buffer = '';
+        const chunks = this.splitByLength(payload, this.maxLength);
+        for (const chunk of chunks) {
+            const escaped = chunk.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+            const content = this.wrapInCodeBlock ? `<pre>${escaped}</pre>` : chunk;
+            this.sendContent(content).catch(() => { });
+        }
+    }
+    splitByLength(text, maxLength) {
+        if (text.length <= maxLength) {
+            return [text];
+        }
+        const result = [];
+        let cursor = 0;
+        while (cursor < text.length) {
+            result.push(text.slice(cursor, cursor + maxLength));
+            cursor += maxLength;
+        }
+        return result;
+    }
+}
+exports.ProgressSender = ProgressSender;
+//# sourceMappingURL=progressSender.js.map

package/dist/services/progressSender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressSender.js","sourceRoot":"","sources":["../../src/services/progressSender.ts"],"names":[],"mappings":";;;AAOA,MAAa,cAAc;IACf,UAAU,CAAS;IACnB,SAAS,CAAS;IAClB,eAAe,CAAU;IAEzB,MAAM,GAAW,EAAE,CAAC;IACpB,KAAK,GAA0B,IAAI,CAAC;IAEpC,WAAW,CAAwC;IAE3D,YAAY,OAA8B;QACtC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;QAC3C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;IAC3D,CAAC;IAEM,MAAM,CAAC,IAAY;QACtB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACd,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACzB,IAAI,CAAC,IAAI,EAAE,CAAC;YAChB,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACxB,CAAC;IACL,CAAC;IAEM,SAAS;QACZ,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;IAEM,OAAO;QACV,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACrB,CAAC;IAEO,IAAI;QACR,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QAEjB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzF,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;YACvE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,IAAY,EAAE,SAAiB;QACjD,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;YACpD,MAAM,IAAI,SAAS,CAAC;QACxB,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ;AArED,wCAqEC"}

package/dist/services/promptDispatcher.d.ts

@@ -0,0 +1,38 @@
+import { ChatSessionRepository } from '../database/chatSessionRepository';
+import { CdpBridge, TelegramChannel } from './cdpBridgeManager';
+import { CdpService } from './cdpService';
+import { ModeService } from './modeService';
+import { ModelService } from './modelService';
+import { TitleGeneratorService } from './titleGeneratorService';
+import { TelegramTopicManager } from './telegramTopicManager';
+import { ChatSessionService } from './chatSessionService';
+import { InboundImageAttachment } from '../utils/imageHandler';
+export interface PromptDispatchOptions {
+    chatSessionService: ChatSessionService;
+    chatSessionRepo: ChatSessionRepository;
+    topicManager: TelegramTopicManager;
+    titleGenerator: TitleGeneratorService;
+}
+export interface PromptDispatchRequest {
+    channel: TelegramChannel;
+    prompt: string;
+    cdp: CdpService;
+    inboundImages?: InboundImageAttachment[];
+    options?: PromptDispatchOptions;
+}
+export interface PromptDispatcherDeps {
+    bridge: CdpBridge;
+    modeService: ModeService;
+    modelService: ModelService;
+    sendPromptImpl: (bridge: CdpBridge, channel: TelegramChannel, prompt: string, cdp: CdpService, modeService: ModeService, modelService: ModelService, inboundImages?: InboundImageAttachment[], options?: PromptDispatchOptions) => Promise<void>;
+}
+export declare class PromptDispatcher {
+    private readonly deps;
+    /** Per-channel lock to prevent concurrent prompt dispatch */
+    private channelLocks;
+    /** Per-workspace lock to prevent cross-topic races on the same workspace */
+    private workspaceLocks;
+    constructor(deps: PromptDispatcherDeps);
+    private channelKey;
+    send(req: PromptDispatchRequest): Promise<void>;
+}