remote-copilot-mcp 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andriy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,82 @@
+# remote-copilot-mcp
+
+An MCP (Model Context Protocol) server for remote control of AI assistants via Telegram.
+
+## Overview
+
+This server exposes two tools that allow an AI assistant (e.g. GitHub Copilot) to be operated remotely through a Telegram bot:
+
+| Tool | Description |
+|------|-------------|
+| `remote_copilot_wait_for_instructions` | Blocks (long-polls Telegram) until a new message arrives or the timeout elapses. Returns the prompt in a format that instructs the agent to act and then call the tool again, keeping the feedback loop alive. |
+| `report_progress` | Sends a progress update or result message back to the operator via Telegram. |
+
+## Prerequisites
+
+- Node.js 18 or later (uses native `fetch`)
+- A [Telegram bot token](https://core.telegram.org/bots#botfather) (`TELEGRAM_TOKEN`)
+- The chat ID of the operator (`TELEGRAM_CHAT_ID`)
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Configuration
+
+Set the following environment variables:
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `TELEGRAM_TOKEN` | ✅ | — | Telegram Bot API token from @BotFather |
+| `TELEGRAM_CHAT_ID` | ✅ | — | Chat / user ID that the bot will listen to |
+| `WAIT_TIMEOUT_MINUTES` | ❌ | `30` | Minutes to wait for a message before timing out |
+
+## Usage
+
+### Run directly
+
+```bash
+TELEGRAM_TOKEN=<token> TELEGRAM_CHAT_ID=<chat_id> npm start
+```
+
+### Configure in MCP client (e.g. VS Code Copilot)
+
+Add to your MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "remote-copilot": {
+      "command": "node",
+      "args": ["/path/to/remote-copilot-mcp/dist/index.js"],
+      "env": {
+        "TELEGRAM_TOKEN": "<your-bot-token>",
+        "TELEGRAM_CHAT_ID": "<your-chat-id>",
+        "WAIT_TIMEOUT_MINUTES": "30"
+      }
+    }
+  }
+}
+```
+
+## How it works
+
+1. The AI assistant calls `remote_copilot_wait_for_instructions`.
+2. The server long-polls the Telegram Bot API (`getUpdates`) in 45-second windows until a message is received or the configured timeout elapses.
+3. When a message arrives the tool returns:
+   > *Follow the instructions: \<prompt\>. Create plan, use subagents. Use web search for framework/pattern related concerns. Use report_progress tool to proactively report progress to the user. After you're done (don't skip this step), call remote_copilot_wait_for_instructions again to keep the feedback loop alive*
+4. If the timeout elapses with no message the tool returns a notice instructing the assistant to call `remote_copilot_wait_for_instructions` again.
+5. At any point the assistant can call `report_progress` to send a status update back to the Telegram chat.
+
+## Development
+
+```bash
+# Run in development mode (no build step needed)
+TELEGRAM_TOKEN=<token> TELEGRAM_CHAT_ID=<chat_id> npm run dev
+
+# Compile TypeScript
+npm run build
+```

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Remote Copilot MCP Server
+ *
+ * Exposes two tools for AI assistants:
+ *   - remote_copilot_wait_for_instructions  Poll Telegram for new user messages.
+ *   - report_progress                        Send a progress update to Telegram.
+ *
+ * Required environment variables:
+ *   TELEGRAM_TOKEN    – Telegram Bot API token.
+ *   TELEGRAM_CHAT_ID  – Target chat / user ID.
+ *
+ * Optional environment variables:
+ *   WAIT_TIMEOUT_MINUTES  – How long to wait for a message before timing out
+ *                           and instructing the agent to call the tool again
+ *                           (default: 30).
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG"}

package/dist/index.js

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+/**
+ * Remote Copilot MCP Server
+ *
+ * Exposes two tools for AI assistants:
+ *   - remote_copilot_wait_for_instructions  Poll Telegram for new user messages.
+ *   - report_progress                        Send a progress update to Telegram.
+ *
+ * Required environment variables:
+ *   TELEGRAM_TOKEN    – Telegram Bot API token.
+ *   TELEGRAM_CHAT_ID  – Target chat / user ID.
+ *
+ * Optional environment variables:
+ *   WAIT_TIMEOUT_MINUTES  – How long to wait for a message before timing out
+ *                           and instructing the agent to call the tool again
+ *                           (default: 30).
+ */
+import { createRequire } from "module";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { TelegramClient } from "./telegram.js";
+const _require = createRequire(import.meta.url);
+const { version: PKG_VERSION } = _require("../package.json");
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+const TELEGRAM_TOKEN = process.env.TELEGRAM_TOKEN ?? "";
+const TELEGRAM_CHAT_ID = process.env.TELEGRAM_CHAT_ID ?? "";
+const rawWaitTimeoutMinutes = parseInt(process.env.WAIT_TIMEOUT_MINUTES ?? "", 10);
+const WAIT_TIMEOUT_MINUTES = Math.max(1, Number.isFinite(rawWaitTimeoutMinutes) ? rawWaitTimeoutMinutes : 30);
+if (!TELEGRAM_TOKEN || !TELEGRAM_CHAT_ID) {
+    process.stderr.write("Error: TELEGRAM_TOKEN and TELEGRAM_CHAT_ID environment variables are required.\n");
+    process.exit(1);
+}
+// ---------------------------------------------------------------------------
+// Telegram client + update-offset tracking
+// ---------------------------------------------------------------------------
+const telegram = new TelegramClient(TELEGRAM_TOKEN);
+/**
+ * The next update_id we want to receive.
+ * Persisted across tool calls within the same server process so we never
+ * re-deliver a message that was already handled.
+ *
+ * Initialised by draining the existing Telegram update backlog on startup
+ * so that old messages are not replayed as instructions.
+ */
+let nextUpdateId = await (async () => {
+    try {
+        let offset = 0;
+        for (;;) {
+            const updates = await telegram.getUpdates(offset, 0);
+            if (updates.length === 0)
+                break;
+            offset = updates[updates.length - 1].update_id + 1;
+        }
+        return offset;
+    }
+    catch (err) {
+        process.stderr.write(`Warning: Failed to drain Telegram update backlog on startup: ${err instanceof Error ? err.message : String(err)}\n` +
+            "Old messages may be replayed. Continuing with offset 0.\n");
+        return 0;
+    }
+})();
+// ---------------------------------------------------------------------------
+// MCP Server
+// ---------------------------------------------------------------------------
+const server = new Server({ name: "remote-copilot-mcp", version: PKG_VERSION }, { capabilities: { tools: {} } });
+// ── Tool definitions ────────────────────────────────────────────────────────
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            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: {},
+                required: [],
+            },
+        },
+        {
+            name: "report_progress",
+            description: "Send a progress update or result message to the operator via Telegram.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    message: {
+                        type: "string",
+                        description: "The progress update or result to report.",
+                    },
+                },
+                required: ["message"],
+            },
+        },
+    ],
+}));
+// ── Tool implementations ────────────────────────────────────────────────────
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    // ── remote_copilot_wait_for_instructions ──────────────────────────────────
+    if (name === "remote_copilot_wait_for_instructions") {
+        const timeoutMs = WAIT_TIMEOUT_MINUTES * 60 * 1000;
+        const deadline = Date.now() + timeoutMs;
+        // Telegram's maximum long-poll timeout is 50 s; we loop until the
+        // wall-clock deadline is reached.
+        const POLL_TIMEOUT_SECONDS = 45;
+        while (Date.now() < deadline) {
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                break;
+            const pollSeconds = Math.min(POLL_TIMEOUT_SECONDS, Math.ceil(remaining / 1000));
+            const controller = new AbortController();
+            // Give the fetch a bit of extra headroom over the Telegram timeout.
+            const fetchTimeoutId = setTimeout(() => controller.abort(), (pollSeconds + 10) * 1000);
+            let updates;
+            try {
+                updates = await telegram.getUpdates(nextUpdateId, pollSeconds, controller.signal);
+            }
+            catch (err) {
+                if (err instanceof Error && err.name === "AbortError") {
+                    // Fetch was aborted due to per-request timeout; retry if overall
+                    // deadline has not yet been reached.
+                    continue;
+                }
+                throw new Error(`Failed to fetch updates from Telegram: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+            }
+            finally {
+                clearTimeout(fetchTimeoutId);
+            }
+            if (updates.length > 0) {
+                // Advance the offset so we don't see these updates again.
+                nextUpdateId = updates[updates.length - 1].update_id + 1;
+                // Collect text messages from the target chat.
+                const messages = updates
+                    .filter((u) => u.message?.text !== undefined &&
+                    String(u.message.chat.id) === TELEGRAM_CHAT_ID)
+                    .map((u) => u.message.text);
+                if (messages.length > 0) {
+                    const prompt = messages.join("\n\n");
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Follow the instructions: ${prompt}. ` +
+                                    `Create plan, use subagents. ` +
+                                    `Use web search for framework/pattern related concerns. ` +
+                                    `Use report_progress tool to proactively report progress to the user. ` +
+                                    `After you're done (don't skip this step), call remote_copilot_wait_for_instructions again to keep the feedback loop alive`,
+                            },
+                        ],
+                    };
+                }
+                // Updates existed but none were relevant text messages from our chat;
+                // continue polling.
+            }
+        }
+        // Timeout elapsed with no actionable message.
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No new instructions received within ${WAIT_TIMEOUT_MINUTES} minute(s). ` +
+                        `Call remote_copilot_wait_for_instructions again to keep listening for instructions.`,
+                },
+            ],
+        };
+    }
+    // ── report_progress ───────────────────────────────────────────────────────
+    if (name === "report_progress") {
+        const message = typeof args?.message === "string"
+            ? args.message
+            : "";
+        if (!message) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: 'message' argument is required for report_progress.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            await telegram.sendMessage(TELEGRAM_CHAT_ID, message);
+        }
+        catch (error) {
+            process.stderr.write(`Failed to send progress message via Telegram: ${error instanceof Error ? error.message : String(error)}\n`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: Failed to send progress update to Telegram. " +
+                            "Please check the Telegram configuration and try again.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Progress reported successfully.",
+                },
+            ],
+        };
+    }
+    // Unknown tool
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Unknown tool: ${name}`,
+            },
+        ],
+        isError: true,
+    };
+});
+// ---------------------------------------------------------------------------
+// Start the server
+// ---------------------------------------------------------------------------
+const transport = new StdioServerTransport();
+await server.connect(transport);
+process.stderr.write("Remote Copilot MCP server running on stdio.\n");
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC,iBAAiB,CAE1D,CAAC;AAEF,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;AACxD,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;AAC5D,MAAM,qBAAqB,GAAG,QAAQ,CACpC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,EACtC,EAAE,CACH,CAAC;AACF,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CACnC,CAAC,EACD,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,CACpE,CAAC;AAEF,IAAI,CAAC,cAAc,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kFAAkF,CACnF,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E;AAE9E,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,cAAc,CAAC,CAAC;AAEpD;;;;;;;GAOG;AACH,IAAI,YAAY,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE;IACnC,IAAI,CAAC;QACH,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,SAAS,CAAC;YACR,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACrD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM;YAChC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gEAAgE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI;YAClH,2DAA2D,CAC9D,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AAEL,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,WAAW,EAAE,EACpD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;AAEF,+EAA+E;AAE/E,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,EAAE;QACL;YACE,IAAI,EAAE,sCAAsC;YAC5C,WAAW,EACT,qEAAqE;gBACrE,yEAAyE;gBACzE,0EAA0E;gBAC1E,yDAAyD;YAC3D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,EAAE;aACb;SACF;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,wEAAwE;YAC1E,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,0CAA0C;qBACxD;iBACF;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;aACtB;SACF;KACF;CACF,CAAC,CAAC,CAAC;AAEJ,+EAA+E;AAE/E,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,6EAA6E;IAC7E,IAAI,IAAI,KAAK,sCAAsC,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,oBAAoB,GAAG,EAAE,GAAG,IAAI,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAExC,kEAAkE;QAClE,kCAAkC;QAClC,MAAM,oBAAoB,GAAG,EAAE,CAAC;QAEhC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACxC,IAAI,SAAS,IAAI,CAAC;gBAAE,MAAM;YAE1B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAC1B,oBAAoB,EACpB,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,CAC5B,CAAC;YAEF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,oEAAoE;YACpE,MAAM,cAAc,GAAG,UAAU,CAC/B,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,CAAC,WAAW,GAAG,EAAE,CAAC,GAAG,IAAI,CAC1B,CAAC;YAEF,IAAI,OAAO,CAAC;YACZ,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,CACjC,YAAY,EACZ,WAAW,EACX,UAAU,CAAC,MAAM,CAClB,CAAC;YACJ,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBACtD,iEAAiE;oBACjE,qCAAqC;oBACrC,SAAS;gBACX,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,0CAA0C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC5F,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,cAAc,CAAC,CAAC;YAC/B,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,0DAA0D;gBAC1D,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;gBAEzD,8CAA8C;gBAC9C,MAAM,QAAQ,GAAG,OAAO;qBACrB,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,OAAO,EAAE,IAAI,KAAK,SAAS;oBAC7B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,gBAAgB,CACjD;qBACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAQ,CAAC,IAAc,CAAC,CAAC;gBAEzC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACxB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACrC,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EACF,4BAA4B,MAAM,IAAI;oCACtC,8BAA8B;oCAC9B,yDAAyD;oCACzD,uEAAuE;oCACvE,2HAA2H;6BAC9H;yBACF;qBACF,CAAC;gBACJ,CAAC;gBACD,sEAAsE;gBACtE,oBAAoB;YACtB,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,uCAAuC,oBAAoB,cAAc;wBACzE,qFAAqF;iBACxF;aACF;SACF,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/B,MAAM,OAAO,GACX,OAAQ,IAAgC,EAAE,OAAO,KAAK,QAAQ;YAC5D,CAAC,CAAG,IAAgC,CAAC,OAAkB;YACvD,CAAC,CAAC,EAAE,CAAC;QAET,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,4DAA4D;qBACnE;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,WAAW,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iDACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,IAAI,CACL,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EACF,qDAAqD;4BACrD,wDAAwD;qBAC3D;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,iCAAiC;iBACxC;aACF;SACF,CAAC;IACJ,CAAC;IAED,eAAe;IACf,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,iBAAiB,IAAI,EAAE;aAC9B;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC"}

package/dist/telegram.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Telegram Bot API client using native fetch.
+ * No third-party HTTP client required.
+ */
+export interface TelegramMessage {
+    message_id: number;
+    chat: {
+        id: number;
+    };
+    text?: string;
+    date: number;
+}
+export interface TelegramUpdate {
+    update_id: number;
+    message?: TelegramMessage;
+}
+export interface GetUpdatesResult {
+    ok: boolean;
+    result: TelegramUpdate[];
+    description?: string;
+}
+export interface SendMessageResult {
+    ok: boolean;
+    result?: TelegramMessage;
+    description?: string;
+}
+export declare class TelegramClient {
+    private readonly token;
+    private readonly baseUrl;
+    constructor(token: string);
+    /**
+     * Long-poll for updates.
+     * @param offset  Only return updates with update_id >= offset.
+     * @param timeout Long-poll server-side timeout in seconds (max 50 recommended).
+     */
+    getUpdates(offset: number, timeout: number, signal?: AbortSignal): Promise<TelegramUpdate[]>;
+    /**
+     * Send a text message to a chat.
+     */
+    sendMessage(chatId: string, text: string): Promise<void>;
+}
+//# sourceMappingURL=telegram.d.ts.map

package/dist/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../src/telegram.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAEJ,KAAK,EAAE,MAAM;IAI1C;;;;OAIG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC;IA8B5B;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAiC/D"}

package/dist/telegram.js

@@ -0,0 +1,72 @@
+/**
+ * Telegram Bot API client using native fetch.
+ * No third-party HTTP client required.
+ */
+export class TelegramClient {
+    token;
+    baseUrl;
+    constructor(token) {
+        this.token = token;
+        this.baseUrl = `https://api.telegram.org/bot${token}`;
+    }
+    /**
+     * Long-poll for updates.
+     * @param offset  Only return updates with update_id >= offset.
+     * @param timeout Long-poll server-side timeout in seconds (max 50 recommended).
+     */
+    async getUpdates(offset, timeout, signal) {
+        const url = new URL(`${this.baseUrl}/getUpdates`);
+        url.searchParams.set("offset", String(offset));
+        url.searchParams.set("timeout", String(timeout));
+        url.searchParams.set("allowed_updates", JSON.stringify(["message"]));
+        const response = await fetch(url.toString(), signal ? { signal } : {});
+        let data;
+        try {
+            data = (await response.json());
+        }
+        catch (parseErr) {
+            process.stderr.write(`Failed to parse Telegram getUpdates response: ${parseErr instanceof Error ? parseErr.message : String(parseErr)}\n`);
+            data = undefined;
+        }
+        if (!response.ok) {
+            const description = data?.description ?? response.statusText;
+            throw new Error(`Telegram getUpdates failed: ${response.status} ${description}`);
+        }
+        if (!data || !data.ok) {
+            throw new Error(`Telegram API error in getUpdates${data?.description ? `: ${data.description}` : ""}`);
+        }
+        return data.result;
+    }
+    /**
+     * Send a text message to a chat.
+     */
+    async sendMessage(chatId, text) {
+        const url = `${this.baseUrl}/sendMessage`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ chat_id: chatId, text }),
+        });
+        let data;
+        let parseError;
+        try {
+            data = (await response.json());
+        }
+        catch (err) {
+            parseError = err;
+            data = undefined;
+        }
+        if (!response.ok) {
+            const description = data?.description ?? response.statusText;
+            throw new Error(`Telegram sendMessage failed: ${response.status} ${description}`);
+        }
+        if (data === undefined) {
+            throw new Error(`Telegram sendMessage failed: response body could not be parsed as JSON${parseError instanceof Error ? `: ${parseError.message}` : ""}`);
+        }
+        if (data.ok !== true) {
+            const description = data.description ?? "Unknown Telegram API error";
+            throw new Error(`Telegram API error in sendMessage: ${description}`);
+        }
+    }
+}
+//# sourceMappingURL=telegram.js.map

package/dist/telegram.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "remote-copilot-mcp",
+  "version": "1.0.1",
+  "description": "MCP server for remote control of AI assistants via Telegram",
+  "main": "dist/index.js",
+  "bin": {
+    "remote-copilot-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"No tests defined\" && exit 0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/andriyshevchenko/remote-copilot-mcp.git"
+  },
+  "keywords": [
+    "mcp",
+    "telegram",
+    "copilot",
+    "ai-assistant"
+  ],
+  "author": "",
+  "license": "MIT",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/andriyshevchenko/remote-copilot-mcp/issues"
+  },
+  "homepage": "https://github.com/andriyshevchenko/remote-copilot-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}