sensorium-mcp 2.16.28 → 2.16.30

package/dist/server/factory.js

@@ -0,0 +1,279 @@
+/**
+ * MCP Server factory — creates a fresh Server per transport connection.
+ *
+ * This is required because a single Server instance can only connect to one
+ * transport. In HTTP mode, each VS Code client gets its own Server instance.
+ * All instances share the same tool handler logic and in-process state.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { checkMaintenanceFlag, config } from "../config.js";
+import { peekThreadMessages } from "../dispatcher.js";
+import { formatDrivePrompt } from "../drive.js";
+import { checkDueTasks } from "../scheduler.js";
+import { DEAD_SESSION_TIMEOUT_MS } from "../sessions.js";
+import { getToolDefinitions } from "../tool-definitions.js";
+import { errorResult } from "../utils.js";
+import { getReminders, getShortReminder } from "../response-builders.js";
+import { log } from "../logger.js";
+import { handleMemoryTool } from "../tools/memory-tools.js";
+import { handleUtilityTool } from "../tools/utility-tools.js";
+import { handleSessionTool } from "../tools/session-tools.js";
+import { handleStartSession } from "../tools/start-session-tool.js";
+import { handleWaitForInstructions } from "../tools/wait/index.js";
+// ---------------------------------------------------------------------------
+// Public factory builder
+// ---------------------------------------------------------------------------
+/**
+ * Builds a `CreateMcpServerFn` that closes over the shared runtime singletons
+ * (Telegram client, memory database accessor).  The returned function is the
+ * factory that `startHttpServer` / `startStdioServer` call per-connection.
+ */
+export function buildMcpServerFactory(telegram, telegramChatId, getMemoryDb) {
+    return (getMcpSessionId, closeTransport) => createMcpServer(telegram, telegramChatId, getMemoryDb, getMcpSessionId, closeTransport);
+}
+// ---------------------------------------------------------------------------
+// Internal — per-connection server creation
+// ---------------------------------------------------------------------------
+function createMcpServer(telegram, telegramChatId, getMemoryDb, getMcpSessionId, closeTransport) {
+    const { PKG_VERSION } = config;
+    // ── Per-session state (isolated per HTTP session / stdio connection) ─────
+    let waitCallCount = 0;
+    let sessionStartedAt = Date.now();
+    let currentThreadId;
+    let lastToolCallAt = Date.now();
+    let deadSessionAlerted = false;
+    let waitInProgress = false;
+    let lastOperatorMessageAt = Date.now();
+    let lastOperatorMessageText = "";
+    let lastConsolidationAt = 0;
+    let toolCallsSinceLastDelivery = 0;
+    let lastDriveAttemptAt = 0;
+    let drivePhase2Fired = false;
+    const previewedUpdateIds = new Set();
+    const PREVIEWED_IDS_CAP = 1000;
+    function addPreviewedId(id) {
+        if (previewedUpdateIds.size >= PREVIEWED_IDS_CAP) {
+            const toDelete = previewedUpdateIds.size - PREVIEWED_IDS_CAP + 100;
+            let deleted = 0;
+            for (const old of previewedUpdateIds) {
+                if (deleted >= toDelete)
+                    break;
+                previewedUpdateIds.delete(old);
+                deleted++;
+            }
+        }
+        previewedUpdateIds.add(id);
+    }
+    /**
+     * Generate a first-person DMN (Default Mode Network) reflection prompt.
+     * Called when the __DMN__ sentinel fires as a scheduled task.
+     */
+    function generateDmnReflection(_threadId) {
+        try {
+            const idleMs = Date.now() - lastOperatorMessageAt;
+            const driveResult = formatDrivePrompt(idleMs, config.DMN_ACTIVATION_HOURS);
+            if (driveResult.activated && driveResult.prompt) {
+                return (`I've been thinking while the operator is away.\n\n` +
+                    `${driveResult.prompt}\n\n` +
+                    `If something here resonates, I should explore it — use subagents, search the codebase, review memory. ` +
+                    `Report what I find, then go back to hibernation or continue waiting.`);
+            }
+            return "I should review memory and the codebase for anything interesting while the operator is away.";
+        }
+        catch {
+            return "I should review memory and the codebase for anything interesting while the operator is away.";
+        }
+    }
+    function resolveThreadId(args) {
+        const raw = args?.threadId;
+        const explicit = typeof raw === "number" ? raw
+            : typeof raw === "string" ? Number(raw)
+                : undefined;
+        if (explicit !== undefined && Number.isFinite(explicit)) {
+            currentThreadId = explicit;
+            return explicit;
+        }
+        return currentThreadId;
+    }
+    const memoryToolCtx = {
+        resolveThreadId,
+        getShortReminder: (threadId) => getShortReminder(threadId, sessionStartedAt),
+        getMemoryDb,
+        errorResult,
+        onConsolidation: () => { lastConsolidationAt = Date.now(); },
+    };
+    const srv = new Server({ name: "sensorium-mcp", version: PKG_VERSION }, { capabilities: { tools: {} } });
+    // Dead session detector — per-session, runs every 2 minutes
+    const deadSessionInterval = setInterval(async () => {
+        if (!currentThreadId)
+            return;
+        // Skip check when wait_for_instructions is actively running — the session
+        // is definitively alive even if lastToolCallAt hasn't been refreshed.
+        if (waitInProgress)
+            return;
+        const elapsed = Date.now() - lastToolCallAt;
+        if (elapsed > DEAD_SESSION_TIMEOUT_MS && !deadSessionAlerted) {
+            deadSessionAlerted = true;
+            try {
+                const minutes = Math.round(elapsed / 60000);
+                await telegram.sendMessage(telegramChatId, `⚠️ *Session appears down* — no tool calls in ${minutes} minutes\\. The agent may have crashed or the VS Code window compacted the context\\. Please check and restart if needed\\.`, "MarkdownV2", currentThreadId);
+            }
+            catch (_) { /* non-fatal */ }
+        }
+    }, 2 * 60 * 1000);
+    // Clean up the interval when the server closes
+    srv.onclose = () => {
+        clearInterval(deadSessionInterval);
+    };
+    // ── Tool definitions ──────────────────────────────────────────────────────
+    srv.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: getToolDefinitions(),
+    }));
+    // ── Tool implementations ──────────────────────────────────────────────────
+    srv.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+        const { name, arguments: args } = request.params;
+        // Verbose logging: tool call dispatch
+        const argsSummary = args ? JSON.stringify(args).slice(0, 200) : "{}";
+        log.verbose("dispatch", `Tool call: ${name} args=${argsSummary}`);
+        // Dead session detection — update timestamp on any tool call.
+        // Only reset the alert flag when wait_for_instructions is called,
+        // as that's the primary health signal (agent is actively polling).
+        lastToolCallAt = Date.now();
+        // Track tool calls for activity monitoring
+        toolCallsSinceLastDelivery++;
+        // ── start_session ───────────────────────────────────────────────────────
+        if (name === "start_session") {
+            const startSessionCtx = {
+                session: {
+                    get currentThreadId() { return currentThreadId; },
+                    set currentThreadId(v) { currentThreadId = v; },
+                    get sessionStartedAt() { return sessionStartedAt; },
+                    set sessionStartedAt(v) { sessionStartedAt = v; },
+                    get waitCallCount() { return waitCallCount; },
+                    set waitCallCount(v) { waitCallCount = v; },
+                    get lastToolCallAt() { return lastToolCallAt; },
+                    set lastToolCallAt(v) { lastToolCallAt = v; },
+                    get deadSessionAlerted() { return deadSessionAlerted; },
+                    set deadSessionAlerted(v) { deadSessionAlerted = v; },
+                    get toolCallsSinceLastDelivery() { return toolCallsSinceLastDelivery; },
+                    set toolCallsSinceLastDelivery(v) { toolCallsSinceLastDelivery = v; },
+                    previewedUpdateIds,
+                    get lastOperatorMessageAt() { return lastOperatorMessageAt; },
+                    set lastOperatorMessageAt(v) { lastOperatorMessageAt = v; },
+                    get lastOperatorMessageText() { return lastOperatorMessageText; },
+                    set lastOperatorMessageText(v) { lastOperatorMessageText = v; },
+                    get lastConsolidationAt() { return lastConsolidationAt; },
+                    set lastConsolidationAt(v) { lastConsolidationAt = v; },
+                },
+                telegram,
+                telegramChatId,
+                config,
+                getMemoryDb,
+                getReminders,
+                getMcpSessionId,
+                closeTransport,
+            };
+            return handleStartSession((args ?? {}), startSessionCtx);
+        }
+        // ── remote_copilot_wait_for_instructions ────────────────────────────────
+        if (name === "remote_copilot_wait_for_instructions") {
+            const waitCtx = {
+                state: {
+                    get currentThreadId() { return currentThreadId; },
+                    set currentThreadId(v) { currentThreadId = v; },
+                    get sessionStartedAt() { return sessionStartedAt; },
+                    set sessionStartedAt(v) { sessionStartedAt = v; },
+                    get waitCallCount() { return waitCallCount; },
+                    set waitCallCount(v) { waitCallCount = v; },
+                    get lastToolCallAt() { return lastToolCallAt; },
+                    set lastToolCallAt(v) { lastToolCallAt = v; },
+                    get deadSessionAlerted() { return deadSessionAlerted; },
+                    set deadSessionAlerted(v) { deadSessionAlerted = v; },
+                    get toolCallsSinceLastDelivery() { return toolCallsSinceLastDelivery; },
+                    set toolCallsSinceLastDelivery(v) { toolCallsSinceLastDelivery = v; },
+                    get lastOperatorMessageAt() { return lastOperatorMessageAt; },
+                    set lastOperatorMessageAt(v) { lastOperatorMessageAt = v; },
+                    get lastOperatorMessageText() { return lastOperatorMessageText; },
+                    set lastOperatorMessageText(v) { lastOperatorMessageText = v; },
+                    get lastConsolidationAt() { return lastConsolidationAt; },
+                    set lastConsolidationAt(v) { lastConsolidationAt = v; },
+                    get lastDriveAttemptAt() { return lastDriveAttemptAt; },
+                    set lastDriveAttemptAt(v) { lastDriveAttemptAt = v; },
+                    get drivePhase2Fired() { return drivePhase2Fired; },
+                    set drivePhase2Fired(v) { drivePhase2Fired = v; },
+                    previewedUpdateIds,
+                },
+                addPreviewedId,
+                generateDmnReflection,
+                resolveThreadId,
+                telegram,
+                telegramChatId,
+                getMemoryDb,
+                config,
+                errorResult,
+            };
+            waitInProgress = true;
+            try {
+                return await handleWaitForInstructions((args ?? {}), waitCtx, extra);
+            }
+            finally {
+                waitInProgress = false;
+            }
+        }
+        // ── report_progress / hibernate ─────────────────────────────────────────
+        if (name === "report_progress" || name === "hibernate") {
+            const typedArgs = (args ?? {});
+            const sessionToolCtx = {
+                resolveThreadId,
+                getShortReminder: (threadId) => getShortReminder(threadId, sessionStartedAt),
+                errorResult,
+                telegram,
+                telegramChatId,
+                peekThreadMessages,
+                checkMaintenanceFlag,
+                checkDueTasks,
+                generateDmnReflection,
+                lastOperatorMessageAt,
+                lastOperatorMessageText,
+                previewedUpdateIds,
+                addPreviewedId,
+            };
+            return handleSessionTool(name, typedArgs, sessionToolCtx, extra);
+        }
+        // ── send_file / send_voice / schedule_wake_up ───────────────────────────
+        if (["send_file", "send_voice", "schedule_wake_up", "send_sticker"].includes(name)) {
+            const typedArgs = (args ?? {});
+            const utilityCtx = {
+                resolveThreadId,
+                getShortReminder: (threadId) => getShortReminder(threadId, sessionStartedAt),
+                errorResult,
+                telegram,
+                config,
+                sessionStartedAt,
+            };
+            return handleUtilityTool(name, typedArgs, utilityCtx);
+        }
+        // ── memory_* tools ────────────────────────────────────────────────────
+        if (name.startsWith("memory_")) {
+            return handleMemoryTool(name, (args ?? {}), memoryToolCtx);
+        }
+        // ── get_version ────────────────────────────────────────────────────────
+        if (name === "get_version") {
+            const typedArgs = (args ?? {});
+            const utilityCtx = {
+                resolveThreadId,
+                getShortReminder: (threadId) => getShortReminder(threadId, sessionStartedAt),
+                errorResult,
+                telegram,
+                config,
+                sessionStartedAt,
+            };
+            return handleUtilityTool(name, typedArgs, utilityCtx);
+        }
+        // Unknown tool
+        return errorResult(`Unknown tool: ${name}`);
+    });
+    return srv;
+}
+//# sourceMappingURL=factory.js.map

package/dist/server/factory.js.map

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

package/dist/services/dispatcher/broker.d.ts

@@ -0,0 +1,83 @@
+/**
+ * File-based per-thread message broker.
+ *
+ * Incoming Telegram messages are written by the poller to per-thread JSONL
+ * files under ~/.remote-copilot-mcp/threads/<threadId>.jsonl.
+ * Each MCP instance reads from its own thread file — contention-free.
+ */
+export declare const OFFSET_FILE: string;
+export interface StoredReaction {
+    emoji: string;
+    messageId: number;
+    chatId: number;
+    date: number;
+}
+export declare function writeReactionFile(reaction: StoredReaction): void;
+/**
+ * Read and clear the pending reaction (if any).
+ * Returns null if no reaction is pending.
+ */
+export declare function readPendingReaction(): StoredReaction | null;
+export declare function ensureDirs(): void;
+export declare function readOffset(): number;
+export declare function writeOffset(offset: number): void;
+export interface StoredMessage {
+    update_id: number;
+    message: {
+        message_id: number;
+        chat_id: number;
+        text?: string;
+        caption?: string;
+        message_thread_id?: number;
+        photo?: Array<{
+            file_id: string;
+            width: number;
+            height: number;
+        }>;
+        document?: {
+            file_id: string;
+            file_name?: string;
+            mime_type?: string;
+        };
+        voice?: {
+            file_id: string;
+            duration: number;
+            mime_type?: string;
+        };
+        video_note?: {
+            file_id: string;
+            length: number;
+            duration: number;
+        };
+        sticker?: {
+            file_id: string;
+            emoji?: string;
+            set_name?: string;
+        };
+        animation?: {
+            file_id: string;
+            duration?: number;
+            thumbnail?: {
+                file_id: string;
+            };
+        };
+        date: number;
+    };
+}
+/**
+ * Append a message to a thread's JSONL file.
+ * Throws on write failure so the caller can track which messages were persisted.
+ */
+export declare function appendToThread(threadId: number | "general", msg: StoredMessage): void;
+/**
+ * Read and clear all pending messages for a thread.
+ * Uses rename for atomic read-and-clear to prevent message loss.
+ */
+export declare function readThreadMessages(threadId: number | undefined): StoredMessage[];
+/**
+ * Non-destructive peek at pending messages for a thread.
+ * Unlike readThreadMessages, this does NOT consume the messages — they remain
+ * in the thread file for the next readThreadMessages call.
+ */
+export declare function peekThreadMessages(threadId: number | undefined): StoredMessage[];
+//# sourceMappingURL=broker.d.ts.map

package/dist/services/dispatcher/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../../src/services/dispatcher/broker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,eAAO,MAAM,WAAW,QAA2B,CAAC;AAMpD,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CAChB;AAID,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAIhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,GAAG,IAAI,CAQ3D;AAMD,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAiCD,wBAAgB,UAAU,IAAI,MAAM,CAQnC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAQhD;AAMD,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;YACV,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;SAClB,CAAC,CAAC;QACH,QAAQ,CAAC,EAAE;YACP,OAAO,EAAE,MAAM,CAAC;YAChB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,SAAS,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;QACF,KAAK,CAAC,EAAE;YACJ,OAAO,EAAE,MAAM,CAAC;YAChB,QAAQ,EAAE,MAAM,CAAC;YACjB,SAAS,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;QACF,UAAU,CAAC,EAAE;YACT,OAAO,EAAE,MAAM,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,OAAO,CAAC,EAAE;YACN,OAAO,EAAE,MAAM,CAAC;YAChB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,QAAQ,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;QACF,SAAS,CAAC,EAAE;YACR,OAAO,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,SAAS,CAAC,EAAE;gBACR,OAAO,EAAE,MAAM,CAAC;aACnB,CAAC;SACL,CAAC;QACF,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC;CACL;AAqBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAIrF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,EAAE,CAmBhF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,EAAE,CAShF"}

package/dist/services/dispatcher/broker.js

@@ -0,0 +1,175 @@
+/**
+ * File-based per-thread message broker.
+ *
+ * Incoming Telegram messages are written by the poller to per-thread JSONL
+ * files under ~/.remote-copilot-mcp/threads/<threadId>.jsonl.
+ * Each MCP instance reads from its own thread file — contention-free.
+ */
+import { mkdirSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync, } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { log } from "../../logger.js";
+import { isPidAlive } from "./lock.js";
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+const BASE_DIR = join(homedir(), ".remote-copilot-mcp");
+const THREADS_DIR = join(BASE_DIR, "threads");
+export const OFFSET_FILE = join(BASE_DIR, "offset");
+const REACTION_FILE = join(BASE_DIR, "pending_reaction.json");
+export function writeReactionFile(reaction) {
+    try {
+        writeFileSync(REACTION_FILE, JSON.stringify(reaction), "utf8");
+    }
+    catch { /* non-fatal */ }
+}
+/**
+ * Read and clear the pending reaction (if any).
+ * Returns null if no reaction is pending.
+ */
+export function readPendingReaction() {
+    try {
+        const raw = readFileSync(REACTION_FILE, "utf8");
+        unlinkSync(REACTION_FILE);
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Directory setup & orphan recovery
+// ---------------------------------------------------------------------------
+export function ensureDirs() {
+    mkdirSync(THREADS_DIR, { recursive: true });
+    recoverOrphanedReads();
+}
+/**
+ * On startup, scan for orphaned `.reading.PID` files left by hard-crashed
+ * processes and append their content back to the original thread file
+ * so those messages aren't permanently lost.
+ */
+function recoverOrphanedReads() {
+    try {
+        const files = readdirSync(THREADS_DIR);
+        for (const f of files) {
+            const match = f.match(/^(.+)\.reading\.(\d+)$/);
+            if (match) {
+                const pid = Number.parseInt(match[2], 10);
+                if (!isPidAlive(pid)) {
+                    const orphan = join(THREADS_DIR, f);
+                    const original = join(THREADS_DIR, match[1]);
+                    try {
+                        const content = readFileSync(orphan, "utf8");
+                        writeFileSync(original, content, { flag: "a", encoding: "utf8" });
+                        unlinkSync(orphan);
+                        log.info(`[dispatcher] Recovered orphaned file: ${f}`);
+                    }
+                    catch { /* best effort */ }
+                }
+            }
+        }
+    }
+    catch { /* non-fatal */ }
+}
+// ---------------------------------------------------------------------------
+// Offset persistence (shared across all instances)
+// ---------------------------------------------------------------------------
+export function readOffset() {
+    try {
+        const raw = readFileSync(OFFSET_FILE, "utf8").trim();
+        const n = Number(raw);
+        return Number.isFinite(n) ? n : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+export function writeOffset(offset) {
+    try {
+        const tmp = OFFSET_FILE + `.tmp.${process.pid}`;
+        writeFileSync(tmp, String(offset), "utf8");
+        renameSync(tmp, OFFSET_FILE); // atomic replace
+    }
+    catch {
+        // Non-fatal.
+    }
+}
+function threadFilePath(threadId) {
+    return join(THREADS_DIR, `${threadId}.jsonl`);
+}
+/** Parse JSONL content into StoredMessage[], skipping corrupt lines. */
+function parseJsonlLines(raw, label) {
+    if (!raw)
+        return [];
+    const results = [];
+    for (const line of raw.split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            results.push(JSON.parse(line));
+        }
+        catch {
+            log.warn(`[dispatcher] Skipping corrupt JSONL line in ${label}`);
+        }
+    }
+    return results;
+}
+/**
+ * Append a message to a thread's JSONL file.
+ * Throws on write failure so the caller can track which messages were persisted.
+ */
+export function appendToThread(threadId, msg) {
+    const file = threadFilePath(threadId);
+    const line = JSON.stringify(msg) + "\n";
+    writeFileSync(file, line, { flag: "a", encoding: "utf8" });
+}
+/**
+ * Read and clear all pending messages for a thread.
+ * Uses rename for atomic read-and-clear to prevent message loss.
+ */
+export function readThreadMessages(threadId) {
+    const key = threadId ?? "general";
+    const file = threadFilePath(key);
+    const tmp = file + ".reading." + process.pid;
+    try {
+        renameSync(file, tmp);
+    }
+    catch {
+        return [];
+    }
+    try {
+        const raw = readFileSync(tmp, "utf8").trim();
+        const messages = parseJsonlLines(raw, `${key}.jsonl`);
+        try {
+            unlinkSync(tmp);
+        }
+        catch { /* already gone */ }
+        return messages;
+    }
+    catch {
+        // Read failed — restore the original file to prevent message loss
+        try {
+            renameSync(tmp, file);
+        }
+        catch { /* best effort */ }
+        return [];
+    }
+}
+/**
+ * Non-destructive peek at pending messages for a thread.
+ * Unlike readThreadMessages, this does NOT consume the messages — they remain
+ * in the thread file for the next readThreadMessages call.
+ */
+export function peekThreadMessages(threadId) {
+    const key = threadId ?? "general";
+    const file = threadFilePath(key);
+    try {
+        const raw = readFileSync(file, "utf8").trim();
+        return parseJsonlLines(raw, `${key}.jsonl`);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=broker.js.map

package/dist/services/dispatcher/broker.js.map

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

package/dist/services/dispatcher/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Barrel re-export for the dispatcher subsystem.
+ */
+export type { StoredReaction, StoredMessage } from "./broker.js";
+export { readPendingReaction, readThreadMessages, peekThreadMessages } from "./broker.js";
+export { startDispatcher } from "./poller.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/dispatcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/dispatcher/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAG1F,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/services/dispatcher/index.js

@@ -0,0 +1,7 @@
+/**
+ * Barrel re-export for the dispatcher subsystem.
+ */
+export { readPendingReaction, readThreadMessages, peekThreadMessages } from "./broker.js";
+// Poller — startup entry point
+export { startDispatcher } from "./poller.js";
+//# sourceMappingURL=index.js.map

package/dist/services/dispatcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/dispatcher/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE1F,+BAA+B;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/services/dispatcher/lock.d.ts

@@ -0,0 +1,25 @@
+/**
+ * File-lock acquisition and management for the Telegram poller.
+ *
+ * Only one MCP instance may poll Telegram at a time. This module provides
+ * a file-system–based lock (with stale-lock detection via PID check) so
+ * multiple instances can coordinate without conflicts.
+ */
+/** Check whether a PID is still alive. */
+export declare function isPidAlive(pid: number): boolean;
+export declare function readLock(): {
+    pid: number;
+    ts: number;
+} | null;
+/**
+ * Write (refresh) the lock file, but only if we still own it.
+ * Prevents a TOCTOU race where two pollers run simultaneously:
+ * if another process stole the lock between our check and write,
+ * we must not overwrite their lock.
+ *
+ * Returns true if the lock was refreshed, false if we lost ownership.
+ */
+export declare function refreshLock(): boolean;
+export declare function removeLock(): void;
+export declare function tryAcquireLock(): boolean;
+//# sourceMappingURL=lock.d.ts.map

package/dist/services/dispatcher/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../src/services/dispatcher/lock.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAMD,wBAAgB,QAAQ,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW7D;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAWrC;AAED,wBAAgB,UAAU,IAAI,IAAI,CAMjC;AAMD,wBAAgB,cAAc,IAAI,OAAO,CA0BxC"}