sensorium-mcp 2.9.7 → 2.12.0

package/dist/tool-definitions.js

@@ -0,0 +1,453 @@
+/**
+ * MCP tool definitions — JSON schemas for all 14 tools.
+ * Separated from index.ts for readability.
+ */
+import { OPENAI_TTS_MAX_CHARS } from "./utils.js";
+export function getToolDefinitions() {
+    return [
+        {
+            name: "start_session",
+            description: "Start or resume a remote-copilot session. " +
+                "When called with a name that was used before, the server looks up the " +
+                "existing Telegram topic for that name and resumes it instead of creating a new one. " +
+                "If you are CONTINUING an existing chat (not a fresh conversation), " +
+                "look back through the conversation history for a previous start_session " +
+                "result that mentioned a Thread ID, then pass it as the threadId parameter " +
+                "to resume that existing topic. " +
+                "Requires the Telegram chat to be a forum supergroup with the bot as admin. " +
+                "Call this tool once, then call remote_copilot_wait_for_instructions.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: {
+                        type: "string",
+                        description: "Optional. A human-readable label for this session's Telegram topic (e.g. 'Fix auth bug'). " +
+                            "If omitted, a timestamp-based name is used.",
+                    },
+                    threadId: {
+                        type: "number",
+                        description: "Optional. The Telegram message_thread_id of an existing topic to resume. " +
+                            "When provided, no new topic is created — the session continues in the existing thread.",
+                    },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "remote_copilot_wait_for_instructions",
+            description: "Wait for a new instruction message from the operator via Telegram. " +
+                "The call blocks (long-polls) until a message arrives or the configured " +
+                "timeout elapses. If the timeout elapses with no message the tool output " +
+                "explicitly instructs the agent to call this tool again.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    threadId: {
+                        type: "number",
+                        description: "The Telegram thread ID of the active session. " +
+                            "ALWAYS pass this if you received it from start_session.",
+                    },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "report_progress",
+            description: "Send a progress update or result message to the operator via Telegram. " +
+                "Use standard Markdown for formatting (headings, bold, italic, lists, code blocks, etc.). " +
+                "It will be automatically converted to Telegram-compatible formatting.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    message: {
+                        type: "string",
+                        description: "The progress update or result to report. Use standard Markdown for formatting.",
+                    },
+                    threadId: {
+                        type: "number",
+                        description: "The Telegram thread ID of the active session. " +
+                            "ALWAYS pass this if you received it from start_session.",
+                    },
+                },
+                required: ["message"],
+            },
+        },
+        {
+            name: "send_file",
+            description: "Send a file (image or document) to the operator via Telegram. " +
+                "PREFERRED: provide filePath to send a file directly from disk (fast, no size limit). " +
+                "Alternative: provide base64-encoded content. " +
+                "Images (JPEG, PNG, GIF, WebP) are sent as photos; other files as documents.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Absolute path to the file on disk. PREFERRED over base64 — the server reads " +
+                            "and sends the file directly without passing data through the LLM context.",
+                    },
+                    base64: {
+                        type: "string",
+                        description: "The file content encoded as a base64 string. Use filePath instead when possible.",
+                    },
+                    filename: {
+                        type: "string",
+                        description: "The filename including extension (e.g. 'report.pdf', 'screenshot.png'). " +
+                            "Required when using base64. When using filePath, defaults to the file's basename.",
+                    },
+                    caption: {
+                        type: "string",
+                        description: "Optional caption to display with the file.",
+                    },
+                    threadId: {
+                        type: "number",
+                        description: "The Telegram thread ID of the active session. " +
+                            "ALWAYS pass this if you received it from start_session.",
+                    },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "send_voice",
+            description: "Send a voice message to the operator via Telegram. " +
+                "The text is converted to speech using OpenAI TTS and sent as a Telegram voice message. " +
+                "Requires OPENAI_API_KEY to be set.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    text: {
+                        type: "string",
+                        description: `The text to speak. Maximum ${OPENAI_TTS_MAX_CHARS} characters (OpenAI TTS limit).`,
+                    },
+                    voice: {
+                        type: "string",
+                        description: "The TTS voice to use. Each has a different personality: " +
+                            "alloy (neutral), echo (warm male), fable (storytelling), " +
+                            "onyx (deep authoritative), nova (friendly female), shimmer (gentle). " +
+                            "Choose based on the tone you want to convey.",
+                        enum: ["alloy", "echo", "fable", "onyx", "nova", "shimmer"],
+                    },
+                    threadId: {
+                        type: "number",
+                        description: "The Telegram thread ID of the active session. " +
+                            "ALWAYS pass this if you received it from start_session.",
+                    },
+                },
+                required: ["text"],
+            },
+        },
+        {
+            name: "schedule_wake_up",
+            description: "Schedule a wake-up task that will inject a prompt into your session at a specific time or after operator inactivity. " +
+                "Use this to become proactive — run tests, check CI, review code — without waiting for the operator. " +
+                "Three modes: (1) 'runAt' for a one-shot at a specific ISO 8601 time, " +
+                "(2) 'cron' for recurring tasks (5-field cron: minute hour day month weekday), " +
+                "(3) 'afterIdleMinutes' to fire after N minutes of operator silence. " +
+                "Note: cron expressions are evaluated against server-local time (not UTC). " +
+                "Use 'action: list' to see all scheduled tasks, or 'action: remove' with a taskId to cancel one.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    action: {
+                        type: "string",
+                        description: "Action to perform: 'add' (default), 'list', or 'remove'.",
+                        enum: ["add", "list", "remove"],
+                    },
+                    threadId: {
+                        type: "number",
+                        description: "Thread ID for the session (optional if already set).",
+                    },
+                    label: {
+                        type: "string",
+                        description: "Short human-readable label for the task (e.g. 'morning CI check').",
+                    },
+                    prompt: {
+                        type: "string",
+                        description: "The prompt to inject when the task fires. Be specific about what to do.",
+                    },
+                    runAt: {
+                        type: "string",
+                        description: "ISO 8601 timestamp for one-shot execution (e.g. '2026-03-15T09:00:00Z').",
+                    },
+                    cron: {
+                        type: "string",
+                        description: "5-field cron expression for recurring tasks (e.g. '0 9 * * *' = every day at 9am). Cron expressions are evaluated against server-local time (not UTC).",
+                    },
+                    afterIdleMinutes: {
+                        type: "number",
+                        description: "Fire after this many minutes of operator silence (e.g. 60).",
+                    },
+                    taskId: {
+                        type: "string",
+                        description: "Task ID to remove (for action: 'remove').",
+                    },
+                },
+            },
+        },
+        {
+            name: "sleep",
+            description: "Enter sleep mode — the agent hibernates until a specific time, a scheduled task fires, or the operator sends a message. " +
+                "Use this instead of repeated wait_for_instructions calls when nothing is pending. " +
+                "Specify 'wakeAt' (ISO 8601 timestamp) for a timed alarm, or omit it to sleep indefinitely until operator or scheduled task wakes you. " +
+                "Sleep uses a low-frequency poll (30s intervals) to minimize resource usage. " +
+                "On wake, returns the reason: 'operator_message', 'scheduled_task', 'alarm', or 'connection_lost'.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    threadId: {
+                        type: "number",
+                        description: "Thread ID for the session (optional if already set).",
+                    },
+                    wakeAt: {
+                        type: "string",
+                        description: "ISO 8601 timestamp to wake up at (e.g. '2026-03-20T14:00:00+02:00'). If omitted, sleeps until operator message or scheduled task.",
+                    },
+                },
+            },
+        },
+        // ── Memory Tools ──────────────────────────────────────────────────
+        {
+            name: "memory_bootstrap",
+            description: "Load memory briefing for session start. Call this ONCE after start_session. " +
+                "Returns operator profile, recent context, active procedures, and memory health. " +
+                "~2,500 tokens. Essential for crash recovery — restores knowledge from previous sessions.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    threadId: {
+                        type: "number",
+                        description: "Active thread ID.",
+                    },
+                },
+            },
+        },
+        {
+            name: "memory_search",
+            description: "Search across all memory layers for relevant information. " +
+                "Use BEFORE starting any task to recall facts, preferences, past events, or procedures. " +
+                "Returns ranked results with source layer. Do NOT use for info already in your bootstrap briefing.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: {
+                        type: "string",
+                        description: "Natural language search query.",
+                    },
+                    layers: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: 'Filter layers: ["episodic", "semantic", "procedural"]. Default: all.',
+                    },
+                    types: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: 'Filter by type: ["fact", "preference", "pattern", "workflow", ...].',
+                    },
+                    maxTokens: {
+                        type: "number",
+                        description: "Token budget for results. Default: 1500.",
+                    },
+                    threadId: {
+                        type: "number",
+                        description: "Active thread ID.",
+                    },
+                },
+                required: ["query"],
+            },
+        },
+        {
+            name: "memory_save",
+            description: "Save a piece of knowledge to semantic memory (Layer 3). " +
+                "Use when you learn something important that should persist across sessions: " +
+                "operator preferences, corrections, facts, patterns. " +
+                "Do NOT use for routine conversation — episodic memory captures that automatically.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    content: {
+                        type: "string",
+                        description: "The fact/preference/pattern in one clear sentence.",
+                    },
+                    type: {
+                        type: "string",
+                        description: '"fact" | "preference" | "pattern" | "entity" | "relationship".',
+                    },
+                    keywords: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "3-7 keywords for retrieval.",
+                    },
+                    confidence: {
+                        type: "number",
+                        description: "0.0-1.0. Default: 0.8.",
+                    },
+                    priority: {
+                        type: "number",
+                        description: "0=normal, 1=notable, 2=high importance. Infer from operator's emotional investment: 'important'/'I really need' → 2, 'would be nice'/'should' → 1, else 0.",
+                    },
+                    threadId: {
+                        type: "number",
+                        description: "Active thread ID.",
+                    },
+                },
+                required: ["content", "type", "keywords"],
+            },
+        },
+        {
+            name: "memory_save_procedure",
+            description: "Save or update a learned workflow/procedure to procedural memory (Layer 4). " +
+                "Use after completing a multi-step task the 2nd+ time, or when the operator teaches a process.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: {
+                        type: "string",
+                        description: "Short name for the procedure.",
+                    },
+                    type: {
+                        type: "string",
+                        description: '"workflow" | "habit" | "tool_pattern" | "template".',
+                    },
+                    description: {
+                        type: "string",
+                        description: "What this procedure accomplishes.",
+                    },
+                    steps: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "Ordered steps (for workflows).",
+                    },
+                    triggerConditions: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: "When to use this procedure.",
+                    },
+                    procedureId: {
+                        type: "string",
+                        description: "Existing ID to update (omit to create new).",
+                    },
+                    threadId: {
+                        type: "number",
+                        description: "Active thread ID.",
+                    },
+                },
+                required: ["name", "type", "description"],
+            },
+        },
+        {
+            name: "memory_update",
+            description: "Update or supersede an existing semantic note or procedure. " +
+                "Use when operator corrects stored information or when facts have changed.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    memoryId: {
+                        type: "string",
+                        description: "note_id or procedure_id to update.",
+                    },
+                    action: {
+                        type: "string",
+                        description: '"update" (modify in place) | "supersede" (expire old, create new).',
+                    },
+                    newContent: {
+                        type: "string",
+                        description: "New content (required for supersede, optional for update).",
+                    },
+                    newConfidence: {
+                        type: "number",
+                        description: "Updated confidence score.",
+                    },
+                    newPriority: {
+                        type: "number",
+                        description: "Updated priority: 0=normal, 1=notable, 2=high importance.",
+                    },
+                    reason: {
+                        type: "string",
+                        description: "Why this is being updated.",
+                    },
+                    threadId: {
+                        type: "number",
+                        description: "Active thread ID.",
+                    },
+                },
+                required: ["memoryId", "action", "reason"],
+            },
+        },
+        {
+            name: "memory_consolidate",
+            description: "Run memory consolidation cycle (sleep process). Normally triggered automatically during idle. " +
+                "Manually call if memory_status shows many unconsolidated episodes.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    threadId: {
+                        type: "number",
+                        description: "Active thread ID.",
+                    },
+                    phases: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: 'Run specific phases: ["promote", "decay", "meta"]. Default: all.',
+                    },
+                },
+            },
+        },
+        {
+            name: "memory_status",
+            description: "Get memory system health and statistics. Lightweight (~300 tokens). " +
+                "Use when unsure if you have relevant memories, to check if consolidation is needed, " +
+                "or to report memory state to operator.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    threadId: {
+                        type: "number",
+                        description: "Active thread ID.",
+                    },
+                },
+            },
+        },
+        {
+            name: "memory_forget",
+            description: "Mark a memory as expired/forgotten. Use sparingly — most forgetting happens via decay. " +
+                "Use when operator explicitly asks to forget something or info is confirmed wrong.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    memoryId: {
+                        type: "string",
+                        description: "note_id, procedure_id, or episode_id to forget.",
+                    },
+                    reason: {
+                        type: "string",
+                        description: "Why this is being forgotten.",
+                    },
+                    threadId: {
+                        type: "number",
+                        description: "Active thread ID.",
+                    },
+                },
+                required: ["memoryId", "reason"],
+            },
+        },
+        // ── Rate Limiting Tools ─────────────────────────────────────────────
+        {
+            name: "get_usage_stats",
+            description: "Get API usage statistics and rate limit status across all services (GitHub, OpenAI, etc.). " +
+                "Shows per-service usage, available capacity, and how many agents are sharing resources. " +
+                "Use this before making heavy API calls to check if you should throttle. " +
+                "Also useful to report resource usage to the operator.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    threadId: {
+                        type: "number",
+                        description: "Active thread ID.",
+                    },
+                },
+            },
+        },
+    ];
+}
+//# sourceMappingURL=tool-definitions.js.map

package/dist/tool-definitions.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Shared types used across modules in sensorium-mcp.
+ *
+ * This file defines the context interfaces that allow tool handlers
+ * and transport layers to access shared state without coupling directly
+ * to the monolithic index.ts.
+ */
+import type { Database } from "better-sqlite3";
+import type { TelegramClient } from "./telegram.js";
+export interface AppConfig {
+    TELEGRAM_TOKEN: string;
+    TELEGRAM_CHAT_ID: string;
+    OPENAI_API_KEY: string;
+    VOICE_ANALYSIS_URL: string;
+    WAIT_TIMEOUT_MINUTES: number;
+    FILES_DIR: string;
+    PKG_VERSION: string;
+}
+export interface SessionState {
+    waitCallCount: number;
+    sessionStartedAt: number;
+    currentThreadId: number | undefined;
+    lastToolCallAt: number;
+    deadSessionAlerted: boolean;
+    lastOperatorMessageAt: number;
+    lastConsolidationAt: number;
+    toolCallsSinceLastDelivery: number;
+    previewedUpdateIds: Set<number>;
+}
+export interface ToolContext {
+    config: AppConfig;
+    telegram: TelegramClient;
+    getMemoryDb: () => Database;
+    session: SessionState;
+    /** Resolve threadId from args or fall back to session's currentThreadId. */
+    resolveThreadId(args: Record<string, unknown> | undefined): number | undefined;
+    /** Cap and add a message ID to the previewed set. */
+    addPreviewedId(id: number): void;
+    /** Append time/thread/workflow hints to a tool response string. */
+    getReminders(threadId?: number, driveActive?: boolean): string;
+    /** Convert standard markdown to Telegram MarkdownV2. */
+    convertMarkdown(markdown: string): string;
+    /** Get the MCP session ID for this connection. */
+    getMcpSessionId?: () => string | undefined;
+}
+export interface DashboardCtx {
+    getDb: () => Database;
+    getActiveSessions: () => Array<{
+        mcpSessionId: string;
+        threadId: number;
+        startedAt: string;
+        lastToolCallAt: string;
+        toolName?: string;
+    }>;
+    serverStartTime: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0BAA0B,EAAE,MAAM,CAAC;IACnC,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACjC;AAID,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW,EAAE,MAAM,QAAQ,CAAC;IAC5B,OAAO,EAAE,YAAY,CAAC;IAEtB,4EAA4E;IAC5E,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IAE/E,qDAAqD;IACrD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC,mEAAmE;IACnE,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAE/D,wDAAwD;IACxD,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC5C;AAID,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,QAAQ,CAAC;IACtB,iBAAiB,EAAE,MAAM,KAAK,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Shared types used across modules in sensorium-mcp.
+ *
+ * This file defines the context interfaces that allow tool handlers
+ * and transport layers to access shared state without coupling directly
+ * to the monolithic index.ts.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sensorium-mcp",
-  "version": "2.9.7",
+  "version": "2.12.0",
   "description": "MCP server for remote control of AI assistants via Telegram",
   "main": "dist/index.js",
   "bin": {