sensorium-mcp 2.15.3 → 2.16.0

package/dist/tools/session-tools.js

@@ -0,0 +1,255 @@
+/**
+ * Session tool handlers extracted from index.ts.
+ *
+ * Handles: report_progress, hibernate
+ */
+import { convertMarkdown, splitMessage } from "../markdown.js";
+import { errorMessage } from "../utils.js";
+// ---------------------------------------------------------------------------
+// Dispatcher
+// ---------------------------------------------------------------------------
+export async function handleSessionTool(name, args, ctx, extra) {
+    switch (name) {
+        case "report_progress":
+            return handleReportProgress(args, ctx);
+        case "hibernate":
+            return handleHibernate(args, ctx, extra);
+        default:
+            return ctx.errorResult(`Unknown session tool: ${name}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// report_progress
+// ---------------------------------------------------------------------------
+async function handleReportProgress(args, ctx) {
+    const { resolveThreadId, getShortReminder, errorResult, telegram, telegramChatId, peekThreadMessages, previewedUpdateIds, addPreviewedId, } = ctx;
+    const effectiveThreadId = resolveThreadId(args);
+    if (effectiveThreadId === undefined) {
+        return errorResult("Error: No active session. Call start_session first, then pass the returned threadId.");
+    }
+    const rawMessage = typeof args?.message === "string"
+        ? args.message
+        : "";
+    if (!rawMessage) {
+        return errorResult("Error: 'message' argument is required for report_progress.");
+    }
+    // Normalize literal \n sequences to actual newlines.
+    // Some MCP clients pass escape sequences as literal text (e.g. "foo\\nbar"
+    // instead of "foo\nbar"). Convert them so Telegram renders line breaks.
+    const normalizedMessage = rawMessage.replace(/\\n/g, "\n");
+    // Convert standard Markdown to Telegram MarkdownV2.
+    let message;
+    try {
+        message = convertMarkdown(normalizedMessage);
+    }
+    catch {
+        // Fall back to raw text if Markdown conversion throws.
+        message = normalizedMessage;
+    }
+    let sentAsPlainText = false;
+    const mdChunks = splitMessage(message);
+    try {
+        for (const chunk of mdChunks) {
+            await telegram.sendMessage(telegramChatId, chunk, "MarkdownV2", effectiveThreadId);
+        }
+    }
+    catch (error) {
+        const errMsg = errorMessage(error);
+        // If Telegram rejected the message due to a MarkdownV2 parse error,
+        // retry as plain text using the original un-converted message.
+        const isParseError = errMsg.includes("can't parse entities");
+        if (isParseError) {
+            try {
+                const plainChunks = splitMessage(rawMessage);
+                for (const chunk of plainChunks) {
+                    await telegram.sendMessage(telegramChatId, chunk, undefined, effectiveThreadId);
+                }
+                sentAsPlainText = true;
+            }
+            catch (retryError) {
+                process.stderr.write(`Failed to send progress message via Telegram (plain fallback): ${errorMessage(retryError)}\n`);
+                return errorResult("Error: Failed to send progress update to Telegram even without formatting. " +
+                    "Please check the Telegram configuration and try again.");
+            }
+        }
+        else {
+            process.stderr.write(`Failed to send progress message via Telegram: ${errMsg}\n`);
+            return errorResult("Error: Failed to send progress update to Telegram. " +
+                "Check the Telegram configuration and try again.");
+        }
+    }
+    // Peek at any messages the operator sent while the agent was working.
+    // Uses non-destructive peek so media is preserved for full delivery
+    // via remote_copilot_wait_for_instructions. Tracks previewed update_ids
+    // to prevent the same messages from appearing on repeated calls.
+    let pendingMessages = [];
+    try {
+        const pendingStored = peekThreadMessages(effectiveThreadId);
+        for (const msg of pendingStored) {
+            if (previewedUpdateIds.has(msg.update_id))
+                continue;
+            addPreviewedId(msg.update_id);
+            if (msg.message.photo && msg.message.photo.length > 0) {
+                pendingMessages.push(msg.message.caption
+                    ? `[Photo received — will be downloaded when you call wait_for_instructions] ${msg.message.caption}`
+                    : "[Photo received from operator — will be downloaded when you call wait_for_instructions]");
+            }
+            else if (msg.message.document) {
+                pendingMessages.push(msg.message.caption
+                    ? `[Document: ${msg.message.document.file_name ?? "file"} — will be downloaded when you call wait_for_instructions] ${msg.message.caption}`
+                    : `[Document received: ${msg.message.document.file_name ?? "file"} — will be downloaded when you call wait_for_instructions]`);
+            }
+            else if (msg.message.voice) {
+                pendingMessages.push(`[Voice message — ${msg.message.voice.duration}s — will be transcribed on next wait]`);
+            }
+            else if (msg.message.video_note) {
+                pendingMessages.push(`[Video note — ${msg.message.video_note.duration}s — will be analyzed on next wait]`);
+            }
+            else if (msg.message.text) {
+                pendingMessages.push(msg.message.text);
+            }
+            else {
+                pendingMessages.push("[Unsupported message type — will be shown on next wait]");
+            }
+        }
+    }
+    catch {
+        // Non-fatal: pending messages will still be picked up by the next
+        // remote_copilot_wait_for_instructions call.
+    }
+    const baseStatus = (sentAsPlainText
+        ? "Progress reported successfully (as plain text — formatting could not be applied)."
+        : "Progress reported successfully.") + getShortReminder(effectiveThreadId);
+    const responseText = pendingMessages.length > 0
+        ? `${baseStatus}\n\n` +
+            `While you were working, the operator sent additional message(s). ` +
+            `Use those messages to steer your active session: ${pendingMessages.join("\n\n")}`
+        : baseStatus;
+    return {
+        content: [
+            {
+                type: "text",
+                text: responseText,
+            },
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// hibernate
+// ---------------------------------------------------------------------------
+async function handleHibernate(args, ctx, extra) {
+    const { resolveThreadId, getShortReminder, errorResult, peekThreadMessages, checkMaintenanceFlag, checkDueTasks, generateDmnReflection, lastOperatorMessageAt, } = ctx;
+    const effectiveThreadId = resolveThreadId(args);
+    if (effectiveThreadId === undefined) {
+        return errorResult("Error: No active session. Call start_session first.");
+    }
+    const wakeAt = typeof args.wakeAt === "string" ? new Date(args.wakeAt).getTime() : undefined;
+    if (wakeAt !== undefined && isNaN(wakeAt)) {
+        return errorResult("Error: Invalid wakeAt timestamp. Use ISO 8601 format.");
+    }
+    // Max hibernation time: 8 hours
+    const MAX_HIBERNATE_MS = 8 * 60 * 60 * 1000;
+    const HIBERNATE_POLL_MS = 30_000; // 30s
+    const SSE_KEEPALIVE_INTERVAL_MS = 30_000;
+    const deadline = Date.now() + MAX_HIBERNATE_MS;
+    let lastKeepalive = Date.now();
+    process.stderr.write(`[hibernate] Entering hibernation. threadId=${effectiveThreadId}, wakeAt=${wakeAt ? new Date(wakeAt).toISOString() : "indefinite"}\n`);
+    while (Date.now() < deadline) {
+        // Check for operator messages (non-destructive peek)
+        const peeked = peekThreadMessages(effectiveThreadId);
+        if (peeked.length > 0) {
+            process.stderr.write(`[hibernate] Waking up — ${peeked.length} operator message(s) received.\n`);
+            // Don't consume messages — let the next wait_for_instructions call handle them
+            return {
+                content: [{
+                        type: "text",
+                        text: `Woke up: operator sent a message. Call wait_for_instructions now to read it.` +
+                            getShortReminder(effectiveThreadId),
+                    }],
+            };
+        }
+        // Maintenance flag: stay hibernating (don't wake) — the watcher will restart us
+        // This is distinct from wait_for_instructions which tells the agent to hibernate.
+        // Here we're already hibernating, so we just keep hibernating through the update.
+        const maintenanceInfo = checkMaintenanceFlag();
+        if (maintenanceInfo) {
+            process.stderr.write(`[hibernate] Maintenance flag detected — staying hibernated through update: ${maintenanceInfo}\n`);
+            // Skip all other checks, just keep hibernating
+            await new Promise((resolve) => setTimeout(resolve, HIBERNATE_POLL_MS));
+            continue;
+        }
+        // Check for scheduled tasks
+        const dueTask = checkDueTasks(effectiveThreadId, lastOperatorMessageAt, false);
+        if (dueTask) {
+            process.stderr.write(`[hibernate] Waking up — scheduled task fired: ${dueTask.task.label}\n`);
+            // DMN sentinel: generate dynamic first-person reflection
+            const taskPrompt = dueTask.prompt === "__DMN__"
+                ? generateDmnReflection(effectiveThreadId)
+                : `⏰ Woke up: scheduled task **"${dueTask.task.label}"**\n\n${dueTask.prompt}`;
+            return {
+                content: [{
+                        type: "text",
+                        text: taskPrompt + getShortReminder(effectiveThreadId),
+                    }],
+            };
+        }
+        // Check alarm
+        if (wakeAt && Date.now() >= wakeAt) {
+            process.stderr.write(`[hibernate] Waking up — alarm reached.\n`);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Woke up: alarm time reached (${new Date(wakeAt).toISOString()}).` +
+                            getShortReminder(effectiveThreadId),
+                    }],
+            };
+        }
+        // SSE keepalive — use the same approach as wait_for_instructions
+        const sinceKeepalive = Date.now() - lastKeepalive;
+        if (sinceKeepalive >= SSE_KEEPALIVE_INTERVAL_MS && extra?.sendNotification) {
+            lastKeepalive = Date.now();
+            try {
+                await extra.sendNotification({
+                    method: "notifications/progress",
+                    params: {
+                        progressToken: extra.requestId,
+                        progress: 0,
+                        total: 0,
+                    },
+                });
+            }
+            catch {
+                process.stderr.write(`[hibernate] SSE keepalive failed — connection lost.\n`);
+                return {
+                    content: [{
+                            type: "text",
+                            text: "Hibernation interrupted: connection lost. Call hibernate again to resume." +
+                                getShortReminder(effectiveThreadId),
+                        }],
+                };
+            }
+        }
+        // Check abort signal
+        if (extra.signal.aborted) {
+            process.stderr.write(`[hibernate] SSE connection aborted during hibernation.\n`);
+            return {
+                content: [{
+                        type: "text",
+                        text: "Hibernation interrupted: connection closed." +
+                            getShortReminder(effectiveThreadId),
+                    }],
+            };
+        }
+        await new Promise((resolve) => setTimeout(resolve, HIBERNATE_POLL_MS));
+    }
+    // Max hibernation duration reached
+    process.stderr.write(`[hibernate] Max hibernation duration reached (8h).\n`);
+    return {
+        content: [{
+                type: "text",
+                text: "Woke up: maximum hibernation duration reached (8 hours)." +
+                    getShortReminder(effectiveThreadId),
+            }],
+    };
+}
+//# sourceMappingURL=session-tools.js.map

package/dist/tools/session-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tools.js","sourceRoot":"","sources":["../../src/tools/session-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK/D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA+B3C,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,IAA6B,EAC7B,GAAuB,EACvB,KAAY;IAEZ,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,iBAAiB;YACpB,OAAO,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACzC,KAAK,WAAW;YACd,OAAO,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3C;YACE,OAAO,GAAG,CAAC,WAAW,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,KAAK,UAAU,oBAAoB,CACjC,IAA6B,EAC7B,GAAuB;IAEvB,MAAM,EACJ,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EACxE,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,GACvD,GAAG,GAAG,CAAC;IAER,MAAM,iBAAiB,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC,sFAAsF,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,UAAU,GACd,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ;QAC/B,CAAC,CAAE,IAAI,CAAC,OAAkB;QAC1B,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC,4DAA4D,CAAC,CAAC;IACnF,CAAC;IAED,qDAAqD;IACrD,2EAA2E;IAC3E,wEAAwE;IACxE,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE3D,oDAAoD;IACpD,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,eAAe,CAAC,iBAAiB,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;QACvD,OAAO,GAAG,iBAAiB,CAAC;IAC9B,CAAC;IAED,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,QAAQ,CAAC,WAAW,CAAC,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,oEAAoE;QACpE,+DAA+D;QAC/D,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;QAC7D,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;gBAC7C,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;oBAChC,MAAM,QAAQ,CAAC,WAAW,CAAC,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;gBAClF,CAAC;gBACD,eAAe,GAAG,IAAI,CAAC;YACzB,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kEAAkE,YAAY,CAAC,UAAU,CAAC,IAAI,CAC/F,CAAC;gBACF,OAAO,WAAW,CAChB,6EAA6E;oBAC7E,wDAAwD,CACzD,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iDAAiD,MAAM,IAAI,CAC5D,CAAC;YACF,OAAO,WAAW,CAChB,qDAAqD;gBACrD,iDAAiD,CAClD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,oEAAoE;IACpE,wEAAwE;IACxE,iEAAiE;IACjE,IAAI,eAAe,GAAa,EAAE,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;QAC5D,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,IAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,SAAS;YACpD,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAE9B,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtD,eAAe,CAAC,IAAI,CAClB,GAAG,CAAC,OAAO,CAAC,OAAO;oBACjB,CAAC,CAAC,6EAA6E,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE;oBACpG,CAAC,CAAC,yFAAyF,CAC9F,CAAC;YACJ,CAAC;iBAAM,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAChC,eAAe,CAAC,IAAI,CAClB,GAAG,CAAC,OAAO,CAAC,OAAO;oBACjB,CAAC,CAAC,cAAc,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,MAAM,8DAA8D,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE;oBAC3I,CAAC,CAAC,uBAAuB,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,MAAM,4DAA4D,CAChI,CAAC;YACJ,CAAC;iBAAM,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC7B,eAAe,CAAC,IAAI,CAClB,oBAAoB,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,uCAAuC,CACtF,CAAC;YACJ,CAAC;iBAAM,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBAClC,eAAe,CAAC,IAAI,CAClB,iBAAiB,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,oCAAoC,CACrF,CAAC;YACJ,CAAC;iBAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC5B,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,eAAe,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;QAClE,6CAA6C;IAC/C,CAAC;IAED,MAAM,UAAU,GACd,CAAC,eAAe;QACd,CAAC,CAAC,mFAAmF;QACrF,CAAC,CAAC,iCAAiC,CAAC,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;IAE/E,MAAM,YAAY,GAChB,eAAe,CAAC,MAAM,GAAG,CAAC;QACxB,CAAC,CAAC,GAAG,UAAU,MAAM;YACrB,mEAAmE;YACnE,oDAAoD,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;QAClF,CAAC,CAAC,UAAU,CAAC;IAEjB,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,YAAY;aACnB;SACF;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,KAAK,UAAU,eAAe,CAC5B,IAA6B,EAC7B,GAAuB,EACvB,KAAY;IAEZ,MAAM,EACJ,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAC9C,kBAAkB,EAAE,oBAAoB,EAAE,aAAa,EACvD,qBAAqB,EAAE,qBAAqB,GAC7C,GAAG,GAAG,CAAC;IAER,MAAM,iBAAiB,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC,qDAAqD,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7F,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,OAAO,WAAW,CAAC,uDAAuD,CAAC,CAAC;IAC9E,CAAC;IAED,gCAAgC;IAChC,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,MAAM,iBAAiB,GAAG,MAAM,CAAC,CAAC,MAAM;IACxC,MAAM,yBAAyB,GAAG,MAAM,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAC;IAC/C,IAAI,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8CAA8C,iBAAiB,YAAY,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC;IAE5J,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,qDAAqD;QACrD,MAAM,MAAM,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,MAAM,CAAC,MAAM,kCAAkC,CAAC,CAAC;YACjG,+EAA+E;YAC/E,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,8EAA8E;4BAClF,gBAAgB,CAAC,iBAAiB,CAAC;qBACtC,CAAC;aACH,CAAC;QACJ,CAAC;QAED,gFAAgF;QAChF,kFAAkF;QAClF,kFAAkF;QAClF,MAAM,eAAe,GAAG,oBAAoB,EAAE,CAAC;QAC/C,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8EAA8E,eAAe,IAAI,CAAC,CAAC;YACxH,+CAA+C;YAC/C,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;YAC7E,SAAS;QACX,CAAC;QAED,4BAA4B;QAC5B,MAAM,OAAO,GAAG,aAAa,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,KAAK,CAAC,CAAC;QAC/E,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iDAAiD,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;YAC9F,yDAAyD;YACzD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS;gBAC7C,CAAC,CAAC,qBAAqB,CAAC,iBAAiB,CAAC;gBAC1C,CAAC,CAAC,gCAAgC,OAAO,CAAC,IAAI,CAAC,KAAK,UAAU,OAAO,CAAC,MAAM,EAAE,CAAC;YACjF,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAAC,iBAAiB,CAAC;qBACvD,CAAC;aACH,CAAC;QACJ,CAAC;QAED,cAAc;QACd,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,gCAAgC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,IAAI;4BACtE,gBAAgB,CAAC,iBAAiB,CAAC;qBACtC,CAAC;aACH,CAAC;QACJ,CAAC;QAED,iEAAiE;QACjE,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC;QAClD,IAAI,cAAc,IAAI,yBAAyB,IAAI,KAAK,EAAE,gBAAgB,EAAE,CAAC;YAC3E,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,gBAAgB,CAAC;oBAC3B,MAAM,EAAE,wBAAwB;oBAChC,MAAM,EAAE;wBACN,aAAa,EAAE,KAAK,CAAC,SAAS;wBAC9B,QAAQ,EAAE,CAAC;wBACX,KAAK,EAAE,CAAC;qBACT;iBACF,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;gBAC9E,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,2EAA2E;gCAC/E,gBAAgB,CAAC,iBAAiB,CAAC;yBACtC,CAAC;iBACH,CAAC;YACJ,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;YACjF,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,6CAA6C;4BACjD,gBAAgB,CAAC,iBAAiB,CAAC;qBACtC,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC/E,CAAC;IAED,mCAAmC;IACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC7E,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,0DAA0D;oBAC9D,gBAAgB,CAAC,iBAAiB,CAAC;aACtC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/start-session-tool.d.ts

@@ -0,0 +1,43 @@
+/**
+ * start_session tool handler extracted from index.ts.
+ *
+ * Creates or resumes a Telegram forum topic for the current MCP session,
+ * bootstraps memory, auto-schedules DMN reflection, and returns the
+ * session greeting with reminders.
+ */
+import { type initMemoryDb } from "../memory.js";
+import type { TelegramClient } from "../telegram.js";
+import type { AppConfig } from "../types.js";
+export interface StartSessionContext {
+    /** Mutable per-session state — the handler writes directly into this. */
+    session: {
+        currentThreadId: number | undefined;
+        sessionStartedAt: number;
+        waitCallCount: number;
+        lastToolCallAt: number;
+        deadSessionAlerted: boolean;
+        toolCallsSinceLastDelivery: number;
+        previewedUpdateIds: Set<number>;
+        lastOperatorMessageAt: number;
+        lastConsolidationAt: number;
+    };
+    telegram: TelegramClient;
+    telegramChatId: string;
+    config: AppConfig;
+    getMemoryDb: () => ReturnType<typeof initMemoryDb>;
+    getReminders: (threadId: number | undefined, driveActive: boolean, sessionStartedAt: number, autonomousMode: boolean) => string;
+    /** MCP session ID for this connection (from transport). */
+    getMcpSessionId?: () => string | undefined;
+    /** Close the transport — used for session registration. */
+    closeTransport?: () => void;
+}
+type ToolResult = {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function handleStartSession(args: Record<string, unknown>, ctx: StartSessionContext): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=start-session-tool.d.ts.map

package/dist/tools/start-session-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-session-tool.d.ts","sourceRoot":"","sources":["../../src/tools/start-session-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AASpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ7C,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,OAAO,EAAE;QACP,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,0BAA0B,EAAE,MAAM,CAAC;QACnC,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,qBAAqB,EAAE,MAAM,CAAC;QAC9B,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IAEF,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,MAAM,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACnD,YAAY,EAAE,CACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,WAAW,EAAE,OAAO,EACpB,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,OAAO,KACpB,MAAM,CAAC;IAEZ,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC3C,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAMxF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,UAAU,CAAC,CA0LrB"}

package/dist/tools/start-session-tool.js

@@ -0,0 +1,188 @@
+/**
+ * start_session tool handler extracted from index.ts.
+ *
+ * Creates or resumes a Telegram forum topic for the current MCP session,
+ * bootstraps memory, auto-schedules DMN reflection, and returns the
+ * session greeting with reminders.
+ */
+import { convertMarkdown } from "../markdown.js";
+import { assembleBootstrap } from "../memory.js";
+import { addSchedule, generateTaskId, listSchedules, purgeSchedules } from "../scheduler.js";
+import { lookupSession, persistSession, purgeOtherSessions, registerMcpSession, removeSession, } from "../sessions.js";
+import { errorMessage, errorResult } from "../utils.js";
+import { readThreadMessages } from "../dispatcher.js";
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+export async function handleStartSession(args, ctx) {
+    const { session, telegram, telegramChatId: TELEGRAM_CHAT_ID, config, getMemoryDb } = ctx;
+    session.sessionStartedAt = Date.now();
+    const typedArgs = args;
+    const rawThreadId = typedArgs.threadId;
+    const explicitThreadId = typeof rawThreadId === "number" ? rawThreadId
+        : typeof rawThreadId === "string" ? (Number.isFinite(Number(rawThreadId)) ? Number(rawThreadId) : undefined)
+            : undefined;
+    const customName = typeof typedArgs.name === "string" && typedArgs.name.trim()
+        ? typedArgs.name.trim()
+        : undefined;
+    // When creating a new session (no threadId), name is mandatory.
+    if (explicitThreadId === undefined && !customName) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Error: sessionName is required when creating a new session. Provide a descriptive name for the session.",
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Determine the thread to use:
+    // 1. Explicit threadId beats everything.
+    // 2. A known name looks up the persisted mapping — resume if found.
+    // 3. Otherwise create a new topic.
+    let resolvedPreexisting = false;
+    if (explicitThreadId !== undefined) {
+        session.currentThreadId = explicitThreadId;
+        // If a name was also supplied, keep the mapping up to date.
+        if (customName)
+            persistSession(TELEGRAM_CHAT_ID, customName, explicitThreadId);
+        resolvedPreexisting = true;
+    }
+    else if (customName !== undefined) {
+        const stored = lookupSession(TELEGRAM_CHAT_ID, customName);
+        if (stored !== undefined) {
+            session.currentThreadId = stored;
+            resolvedPreexisting = true;
+        }
+    }
+    if (resolvedPreexisting) {
+        // Drain any stale messages from the thread file so they aren't
+        // re-delivered in the next wait_for_instructions call.
+        const stale = readThreadMessages(session.currentThreadId);
+        if (stale.length > 0) {
+            process.stderr.write(`[start_session] Drained ${stale.length} stale message(s) from thread ${session.currentThreadId}.\n`);
+            // Notify the operator that stale messages were discarded.
+            try {
+                const notice = convertMarkdown(`\u26A0\uFE0F **${stale.length} message(s) from before the session resumed were discarded.** ` +
+                    `If you sent instructions while the agent was offline, please resend them.`);
+                await telegram.sendMessage(TELEGRAM_CHAT_ID, notice, "MarkdownV2", session.currentThreadId);
+            }
+            catch { /* non-fatal */ }
+        }
+        // Resume mode: verify the thread is still alive by sending a message.
+        // If the topic was deleted, drop the cached mapping and fall through to
+        // create a new topic.
+        try {
+            // Use plain text for probe — avoids MarkdownV2 parsing failures being mistaken for dead threads
+            await telegram.sendMessage(TELEGRAM_CHAT_ID, "\u{1F504} Session resumed. Continuing in this thread.", undefined, session.currentThreadId);
+        }
+        catch (err) {
+            const errMsg = errorMessage(err);
+            process.stderr.write(`[start_session] Probe failed for thread ${session.currentThreadId} in chat ${TELEGRAM_CHAT_ID}: ${errMsg}\n`);
+            // Telegram returns "Bad Request: message thread not found" or
+            // "Bad Request: the topic was closed" for deleted/closed topics.
+            const isThreadGone = /thread not found|topic.*(closed|deleted|not found)/i.test(errMsg);
+            if (isThreadGone) {
+                process.stderr.write(`[start_session] Cached thread ${session.currentThreadId} is gone (${errMsg}). Creating new topic.\n`);
+                // Drop the stale mapping and purge any scheduled tasks.
+                if (session.currentThreadId !== undefined)
+                    purgeSchedules(session.currentThreadId);
+                if (customName)
+                    removeSession(TELEGRAM_CHAT_ID, customName);
+                resolvedPreexisting = false;
+                session.currentThreadId = undefined;
+            }
+            // Other errors (network, etc.) are non-fatal — proceed anyway.
+        }
+    }
+    if (!resolvedPreexisting) {
+        // New session: create a dedicated forum topic.
+        const topicName = customName ??
+            `Copilot — ${new Date().toLocaleString("en-GB", {
+                day: "2-digit", month: "short", year: "numeric",
+                hour: "2-digit", minute: "2-digit", hour12: false,
+            })}`;
+        try {
+            const topic = await telegram.createForumTopic(TELEGRAM_CHAT_ID, topicName);
+            session.currentThreadId = topic.message_thread_id;
+            // Persist so the same name resumes this thread next time.
+            persistSession(TELEGRAM_CHAT_ID, topicName, session.currentThreadId);
+        }
+        catch (err) {
+            // Forum topics not available (e.g. plain group or DM) — cannot proceed
+            // without thread isolation. Return an error so the agent knows.
+            return errorResult(`Error: Could not create forum topic: ${errorMessage(err)}. ` +
+                "Ensure the Telegram chat is a forum supergroup with the bot as admin with can_manage_topics right.");
+        }
+        try {
+            const greeting = convertMarkdown("# 🤖 Remote Copilot Ready\n\n" +
+                "Your AI assistant is online and listening.\n\n" +
+                "**Send your instructions** and I'll get to work — " +
+                "I'll keep you posted on progress as I go.");
+            await telegram.sendMessage(TELEGRAM_CHAT_ID, greeting, "MarkdownV2", session.currentThreadId);
+        }
+        catch {
+            // Non-fatal.
+        }
+    }
+    const threadNote = session.currentThreadId !== undefined
+        ? ` Thread ID: ${session.currentThreadId} (pass this to start_session as threadId to resume this topic later).`
+        : "";
+    // Auto-bootstrap memory
+    let memoryBriefing = "";
+    try {
+        const db = getMemoryDb();
+        if (session.currentThreadId !== undefined) {
+            memoryBriefing = "\n\n" + assembleBootstrap(db, session.currentThreadId);
+        }
+    }
+    catch (e) {
+        memoryBriefing = "\n\n_Memory system unavailable._";
+    }
+    // Purge stale MCP sessions for this thread (from before a server restart)
+    // and register the current session.
+    if (session.currentThreadId !== undefined) {
+        const sid = ctx.getMcpSessionId?.();
+        const purged = purgeOtherSessions(session.currentThreadId, sid);
+        if (purged > 0) {
+            process.stderr.write(`[start_session] Purged ${purged} stale MCP session(s) for thread ${session.currentThreadId}.\n`);
+        }
+        if (sid && ctx.closeTransport) {
+            registerMcpSession(session.currentThreadId, sid, ctx.closeTransport);
+        }
+    }
+    // Auto-schedule DMN reflection task if not already present.
+    // This fires after 4 hours of operator silence, delivering a
+    // first-person introspection prompt sourced from memory.
+    // Only create on active thread — purge stale DMN tasks from other threads
+    // to avoid every thread accumulating reflection tasks.
+    if (config.AUTONOMOUS_MODE && session.currentThreadId !== undefined) {
+        const existingTasks = listSchedules(session.currentThreadId);
+        const hasDmn = existingTasks.some(t => t.label === "dmn-reflection");
+        if (!hasDmn) {
+            addSchedule({
+                id: generateTaskId(),
+                threadId: session.currentThreadId,
+                prompt: "__DMN__", // Sentinel — handler generates dynamic content
+                label: "dmn-reflection",
+                afterIdleMinutes: 240, // 4 hours
+                oneShot: false,
+                createdAt: new Date().toISOString(),
+            });
+            process.stderr.write(`[start_session] Auto-scheduled DMN reflection task for thread ${session.currentThreadId}.\n`);
+        }
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Session ${resolvedPreexisting ? "resumed" : "started"}.${threadNote}` +
+                    ` Call the remote_copilot_wait_for_instructions tool next.` +
+                    memoryBriefing +
+                    ctx.getReminders(session.currentThreadId, false, session.sessionStartedAt, config.AUTONOMOUS_MODE),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=start-session-tool.js.map

package/dist/tools/start-session-tool.js.map

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

package/dist/tools/utility-tools.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Utility tool handlers extracted from index.ts.
+ *
+ * Handles: send_file, send_voice, schedule_wake_up, get_version, get_usage_stats
+ */
+import type { TelegramClient } from "../telegram.js";
+import type { AppConfig } from "../types.js";
+/** Closure-bound helpers passed by the caller (index.ts createMcpServer). */
+export interface UtilityToolContext {
+    resolveThreadId: (args: Record<string, unknown>) => number | undefined;
+    getShortReminder: (threadId: number | undefined) => string;
+    errorResult: (msg: string) => {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    };
+    telegram: TelegramClient;
+    config: AppConfig;
+    sessionStartedAt: number;
+    waitCallCount: number;
+    toolCallsSinceLastDelivery: number;
+}
+type ToolResult = {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function handleUtilityTool(name: string, args: Record<string, unknown>, ctx: UtilityToolContext): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=utility-tools.d.ts.map

package/dist/tools/utility-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility-tools.d.ts","sourceRoot":"","sources":["../../src/tools/utility-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IACvE,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAAC;IAC3D,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC;IAChG,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,SAAS,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B,EAAE,MAAM,CAAC;CACpC;AAED,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAMxF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,UAAU,CAAC,CAerB"}