sensorium-mcp 2.15.3 → 2.16.1

package/dist/tools/utility-tools.js

@@ -0,0 +1,256 @@
+/**
+ * Utility tool handlers extracted from index.ts.
+ *
+ * Handles: send_file, send_voice, schedule_wake_up, get_version, get_usage_stats
+ */
+import { readFile } from "fs/promises";
+import { basename } from "node:path";
+import { checkMaintenanceFlag } from "../config.js";
+import { textToSpeech, TTS_VOICES } from "../openai.js";
+import { rateLimiter } from "../rate-limiter.js";
+import { addSchedule, generateTaskId, listSchedules, removeSchedule } from "../scheduler.js";
+import { errorMessage, IMAGE_EXTENSIONS, OPENAI_TTS_MAX_CHARS } from "../utils.js";
+// ---------------------------------------------------------------------------
+// Dispatcher
+// ---------------------------------------------------------------------------
+export async function handleUtilityTool(name, args, ctx) {
+    switch (name) {
+        case "send_file":
+            return handleSendFile(args, ctx);
+        case "send_voice":
+            return handleSendVoice(args, ctx);
+        case "schedule_wake_up":
+            return handleScheduleWakeUp(args, ctx);
+        case "get_version":
+            return handleGetVersion(ctx);
+        case "get_usage_stats":
+            return handleGetUsageStats(args, ctx);
+        default:
+            return ctx.errorResult(`Unknown utility tool: ${name}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// send_file
+// ---------------------------------------------------------------------------
+async function handleSendFile(args, ctx) {
+    const { resolveThreadId, getShortReminder, errorResult, telegram, config } = ctx;
+    const effectiveThreadId = resolveThreadId(args);
+    if (effectiveThreadId === undefined) {
+        return errorResult("Error: No active session. Call start_session first, then pass the returned threadId.");
+    }
+    const filePath = typeof args.filePath === "string" ? args.filePath.trim() : "";
+    const base64Data = typeof args.base64 === "string" ? args.base64 : "";
+    const caption = typeof args.caption === "string" ? args.caption : undefined;
+    if (!filePath && !base64Data) {
+        return errorResult("Error: either 'filePath' or 'base64' argument is required for send_file.");
+    }
+    try {
+        let buffer;
+        let filename;
+        if (filePath) {
+            // Read directly from disk — fast, no LLM context overhead.
+            buffer = await readFile(filePath);
+            filename = typeof args.filename === "string" && args.filename.trim()
+                ? args.filename.trim()
+                : basename(filePath);
+        }
+        else {
+            buffer = Buffer.from(base64Data, "base64");
+            filename = typeof args.filename === "string" && args.filename.trim()
+                ? args.filename.trim()
+                : "file";
+        }
+        const ext = filename.split(".").pop()?.toLowerCase() ?? "";
+        if (IMAGE_EXTENSIONS.has(ext)) {
+            await telegram.sendPhoto(config.TELEGRAM_CHAT_ID, buffer, filename, caption, effectiveThreadId);
+        }
+        else {
+            await telegram.sendDocument(config.TELEGRAM_CHAT_ID, buffer, filename, caption, effectiveThreadId);
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `File "${filename}" sent to Telegram successfully.` + getShortReminder(effectiveThreadId),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        process.stderr.write(`Failed to send file via Telegram: ${errorMessage(err)}\n`);
+        return errorResult(`Error: Failed to send file to Telegram: ${errorMessage(err)}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// send_voice
+// ---------------------------------------------------------------------------
+async function handleSendVoice(args, ctx) {
+    const { resolveThreadId, getShortReminder, errorResult, telegram, config } = ctx;
+    const effectiveThreadId = resolveThreadId(args);
+    if (effectiveThreadId === undefined) {
+        return errorResult("Error: No active session. Call start_session first, then pass the returned threadId.");
+    }
+    const text = typeof args.text === "string" ? args.text.trim() : "";
+    const validVoices = TTS_VOICES;
+    const voice = typeof args.voice === "string" && validVoices.includes(args.voice)
+        ? args.voice
+        : "nova";
+    if (!text) {
+        return errorResult("Error: 'text' argument is required for send_voice.");
+    }
+    if (!config.OPENAI_API_KEY) {
+        return errorResult("Error: OPENAI_API_KEY is not set. Cannot generate voice.");
+    }
+    if (text.length > OPENAI_TTS_MAX_CHARS) {
+        return errorResult(`Error: text is ${text.length} characters — exceeds OpenAI TTS limit of ${OPENAI_TTS_MAX_CHARS}.`);
+    }
+    try {
+        const audioBuffer = await textToSpeech(text, config.OPENAI_API_KEY, voice);
+        await telegram.sendVoice(config.TELEGRAM_CHAT_ID, audioBuffer, effectiveThreadId);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Voice message sent to Telegram successfully.` + getShortReminder(effectiveThreadId),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        process.stderr.write(`Failed to send voice via Telegram: ${errorMessage(err)}\n`);
+        return errorResult(`Error: Failed to send voice message: ${errorMessage(err)}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// schedule_wake_up
+// ---------------------------------------------------------------------------
+async function handleScheduleWakeUp(args, ctx) {
+    const { resolveThreadId, getShortReminder, errorResult } = ctx;
+    const effectiveThreadId = resolveThreadId(args);
+    if (effectiveThreadId === undefined) {
+        return errorResult("Error: No active session. Call start_session first.");
+    }
+    const action = typeof args.action === "string" ? args.action : "add";
+    // --- List ---
+    if (action === "list") {
+        const tasks = listSchedules(effectiveThreadId);
+        if (tasks.length === 0) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "No scheduled tasks for this thread." + getShortReminder(effectiveThreadId),
+                    }],
+            };
+        }
+        const lines = tasks.map(t => {
+            const trigger = t.cron ? `cron: ${t.cron}` : t.runAt ? `at: ${t.runAt}` : `idle: ${t.afterIdleMinutes}min`;
+            const lastFired = t.lastFiredAt ? ` (last: ${t.lastFiredAt})` : "";
+            return `- **${t.label}** [${t.id}] — ${trigger}${lastFired}\n  Prompt: ${t.prompt.slice(0, 100)}${t.prompt.length > 100 ? "…" : ""}`;
+        });
+        return {
+            content: [{
+                    type: "text",
+                    text: `**Scheduled tasks (${tasks.length}):**\n\n${lines.join("\n\n")}` + getShortReminder(effectiveThreadId),
+                }],
+        };
+    }
+    // --- Remove ---
+    if (action === "remove") {
+        const taskId = typeof args.taskId === "string" ? args.taskId : "";
+        if (!taskId) {
+            return errorResult("Error: 'taskId' is required for remove action. Use action: 'list' to see task IDs.");
+        }
+        const removed = removeSchedule(effectiveThreadId, taskId);
+        return {
+            content: [{
+                    type: "text",
+                    text: removed
+                        ? `Task ${taskId} removed.` + getShortReminder(effectiveThreadId)
+                        : `Task ${taskId} not found.` + getShortReminder(effectiveThreadId),
+                }],
+        };
+    }
+    // --- Add ---
+    const label = typeof args.label === "string" ? args.label : "unnamed task";
+    const prompt = typeof args.prompt === "string" ? args.prompt : "";
+    if (!prompt) {
+        return errorResult("Error: 'prompt' is required — this is the text that will be injected when the task fires.");
+    }
+    const runAt = typeof args.runAt === "string" ? args.runAt : undefined;
+    const cron = typeof args.cron === "string" ? args.cron : undefined;
+    const afterIdleMinutes = typeof args.afterIdleMinutes === "number" ? args.afterIdleMinutes : undefined;
+    if (cron && cron.trim().split(/\s+/).length !== 5) {
+        return errorResult("Error: Invalid cron expression. Must be exactly 5 space-separated fields: minute hour day-of-month month day-of-week. " +
+            "Example: '0 9 * * *' (daily at 9am). Only *, numbers, and comma-separated lists are supported.");
+    }
+    if (!runAt && !cron && afterIdleMinutes == null) {
+        return errorResult("Error: Specify at least one trigger: 'runAt' (ISO timestamp), 'cron' (5-field), or 'afterIdleMinutes' (number).");
+    }
+    const task = {
+        id: generateTaskId(),
+        threadId: effectiveThreadId,
+        prompt,
+        label,
+        runAt,
+        cron,
+        afterIdleMinutes,
+        oneShot: runAt != null && !cron && afterIdleMinutes == null,
+        createdAt: new Date().toISOString(),
+    };
+    addSchedule(task);
+    const triggerDesc = cron
+        ? `recurring (cron: ${cron})`
+        : runAt
+            ? `one-shot at ${runAt}`
+            : `after ${afterIdleMinutes}min of operator silence`;
+    return {
+        content: [{
+                type: "text",
+                text: `✅ Scheduled: **${label}** [${task.id}]\nTrigger: ${triggerDesc}\nPrompt: ${prompt}` +
+                    getShortReminder(effectiveThreadId),
+            }],
+    };
+}
+// ---------------------------------------------------------------------------
+// get_version
+// ---------------------------------------------------------------------------
+function handleGetVersion(ctx) {
+    const maintenance = checkMaintenanceFlag();
+    return {
+        content: [{
+                type: "text",
+                text: `Server version: ${ctx.config.PKG_VERSION}` +
+                    (maintenance ? `\n⚠️ Update pending: ${maintenance}` : ""),
+            }],
+    };
+}
+// ---------------------------------------------------------------------------
+// get_usage_stats
+// ---------------------------------------------------------------------------
+function handleGetUsageStats(args, ctx) {
+    const threadId = ctx.resolveThreadId(args);
+    const stats = rateLimiter.getStats();
+    const lines = [
+        `## API Usage Stats`,
+        `Active sessions sharing resources: ${stats.activeSessions}`,
+        `Total API calls (last hour): ${stats.totalCallsLastHour}`,
+        ``,
+    ];
+    for (const svc of stats.services) {
+        const bar = svc.usagePercent > 80 ? "🔴" : svc.usagePercent > 50 ? "🟡" : "🟢";
+        lines.push(`### ${bar} ${svc.description} (${svc.service})`);
+        lines.push(`- Window usage: ${svc.callsInWindow}/${svc.maxPerWindow} (${svc.usagePercent}%)`);
+        lines.push(`- Burst tokens: ${svc.availableTokens}/${svc.burstCapacity}`);
+        if (svc.sessionBreakdown.length > 0) {
+            lines.push(`- Per-session:`);
+            for (const s of svc.sessionBreakdown) {
+                lines.push(`  - Thread ${s.threadId ?? "?"}: ${s.calls} calls`);
+            }
+        }
+        lines.push(``);
+    }
+    return {
+        content: [{ type: "text", text: lines.join("\n") + ctx.getShortReminder(threadId) }],
+    };
+}
+//# sourceMappingURL=utility-tools.js.map

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

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

package/dist/tools/wait-tool.d.ts

@@ -0,0 +1,69 @@
+/**
+ * remote_copilot_wait_for_instructions tool handler extracted from index.ts.
+ *
+ * This is the core long-polling loop that:
+ *   - Polls the dispatcher for new operator messages every 2s
+ *   - Processes all media types: text, photo, document, voice, video_note
+ *   - Runs voice analysis (transcription + emotion via VANPY)
+ *   - Auto-saves episodes to memory
+ *   - Injects relevant memory context via GPT-4o-mini smart filter
+ *   - Checks scheduled tasks during idle polling
+ *   - Triggers auto-consolidation (idle, episode-count, time-based)
+ *   - Sends SSE keepalive pings every 30s
+ *   - Detects maintenance flags and instructs agent to wait externally
+ *   - Activates the Dispatcher drive after extended operator silence
+ */
+import { type initMemoryDb } from "../memory.js";
+import type { TelegramClient } from "../telegram.js";
+import type { AppConfig } from "../types.js";
+type ContentBlock = {
+    type: string;
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
+type ToolResult = {
+    content: Array<ContentBlock>;
+    isError?: boolean;
+};
+export interface WaitToolContext {
+    /** Mutable per-session state — the handler reads and writes directly. */
+    state: {
+        currentThreadId: number | undefined;
+        sessionStartedAt: number;
+        waitCallCount: number;
+        lastToolCallAt: number;
+        deadSessionAlerted: boolean;
+        toolCallsSinceLastDelivery: number;
+        lastOperatorMessageAt: number;
+        lastConsolidationAt: number;
+        previewedUpdateIds: Set<number>;
+    };
+    addPreviewedId: (id: number) => void;
+    generateDmnReflection: (threadId: number) => string;
+    resolveThreadId: (args: Record<string, unknown> | undefined) => number | undefined;
+    telegram: TelegramClient;
+    telegramChatId: string;
+    getMemoryDb: () => ReturnType<typeof initMemoryDb>;
+    config: AppConfig;
+    errorResult: (msg: string) => {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    };
+}
+export interface WaitToolExtra {
+    sendNotification: (notification: {
+        method: string;
+        params: Record<string, unknown>;
+    }) => Promise<void>;
+    signal: AbortSignal;
+    requestId?: string | number;
+}
+export declare function handleWaitForInstructions(args: Record<string, unknown>, ctx: WaitToolContext, extra: WaitToolExtra): Promise<ToolResult>;
+export {};
+//# sourceMappingURL=wait-tool.d.ts.map

package/dist/tools/wait-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-tool.d.ts","sourceRoot":"","sources":["../../src/tools/wait-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAOL,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAUtB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7C,KAAK,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AACvG,KAAK,UAAU,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,KAAK,EAAE;QACL,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,qBAAqB,EAAE,MAAM,CAAC;QAC9B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;KACjC,CAAC;IACF,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,qBAAqB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;IAGnF,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACnD,MAAM,EAAE,SAAS,CAAC;IAGlB,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;CACjG;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,CAAC,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvG,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAMD,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,UAAU,CAAC,CAqsBrB"}