@mulmobridge/telegram 1.0.0 → 1.0.2

package/README.md

@@ -102,6 +102,14 @@ Part of the [`@mulmobridge/*`](https://www.npmjs.com/~mulmobridge) package famil
 - [`@mulmobridge/xmpp`](https://www.npmjs.com/package/@mulmobridge/xmpp) — XMPP / Jabber
 - [`@mulmobridge/zulip`](https://www.npmjs.com/package/@mulmobridge/zulip) — Zulip
 
+## Related projects
+
+Published from the MulmoClaude monorepo by [Receptron](https://github.com/receptron).
+
+- **[MulmoClaude](https://github.com/receptron/mulmoclaude)** — an open-source AI assistant platform that runs on your own computer. Claude Code as the engine, a personal wiki for long-term memory, schema-driven collections for your data, and chat that summons the right GUI (markdown, charts, forms, spreadsheets, wikis) for each task.
+- **[MulmoTerminal](https://github.com/receptron/mulmoterminal)** — a terminal-first cockpit for running many AI coding agents in parallel. One roster showing every session's summary and PR status, tmux-backed session persistence, git-worktree isolation, one-click PRs, and mobile push with remote reply.
+- **[MulmoTerminal manual](https://receptron.github.io/mulmoterminal/)** — setup, workflows, feature reference, configuration, mobile notifications, and alternative / local model providers. Available in English and Japanese.
+
 ## License
 
 MIT

package/dist/api.d.ts

@@ -46,9 +46,9 @@ export interface TelegramApiOptions {
     fetchImpl?: typeof fetch;
 }
 export interface GetUpdatesOptions {
-    offset?: number;
-    timeoutSec?: number;
-    signal?: AbortSignal;
+    offset?: number | undefined;
+    timeoutSec?: number | undefined;
+    signal?: AbortSignal | undefined;
 }
 export interface TelegramApi {
     getUpdates(opts?: GetUpdatesOptions): Promise<TelegramUpdate[]>;

package/dist/api.js

@@ -13,7 +13,7 @@ export function createTelegramApi(opts) {
                 params.set("timeout", String(gu.timeoutSec));
             }
             const url = `${base}/getUpdates?${params.toString()}`;
-            const res = await fetchImpl(url, { signal: gu.signal });
+            const res = await fetchImpl(url, gu.signal !== undefined ? { signal: gu.signal } : {});
             if (!res.ok) {
                 throw new Error(`getUpdates failed: ${res.status} ${await safeText(res)}`);
             }

package/dist/router.js

@@ -74,42 +74,42 @@ export function createMessageRouter(deps) {
     // exclusive (photo OR document), but forwarded messages or future
     // API changes could carry both. We collect all available attachments
     // rather than picking one.
-    async function tryDownloadAttachments(msg) {
-        const attachments = [];
-        let anyFailed = false;
-        if (Array.isArray(msg.photo) && msg.photo.length > 0) {
-            const largest = msg.photo[msg.photo.length - 1];
-            try {
-                const dataUrl = await api.downloadFile(largest.file_id, "image/jpeg");
-                const parsed = parseDataUrl(dataUrl);
-                if (parsed) {
-                    attachments.push({ mimeType: parsed.mimeType, data: parsed.data });
-                }
-            }
-            catch (err) {
-                log.error(`[telegram] photo download failed: ${String(err)}`);
-                anyFailed = true;
-            }
+    async function downloadPhoto(msg) {
+        // Telegram lists photo sizes smallest-first, so the last entry is
+        // the highest resolution available.
+        const largest = Array.isArray(msg.photo) ? msg.photo[msg.photo.length - 1] : undefined;
+        if (!largest)
+            return null;
+        try {
+            const parsed = parseDataUrl(await api.downloadFile(largest.file_id, "image/jpeg"));
+            return parsed ? { attachment: { mimeType: parsed.mimeType, data: parsed.data } } : null;
         }
-        if (msg.document) {
-            const doc = msg.document;
-            const fallbackMime = doc.mime_type ?? "application/octet-stream";
-            try {
-                const dataUrl = await api.downloadFile(doc.file_id, fallbackMime);
-                const parsed = parseDataUrl(dataUrl);
-                if (parsed) {
-                    attachments.push({
-                        mimeType: parsed.mimeType,
-                        data: parsed.data,
-                        filename: doc.file_name,
-                    });
-                }
-            }
-            catch (err) {
-                log.error(`[telegram] document download failed: ${String(err)}`);
-                anyFailed = true;
-            }
+        catch (err) {
+            log.error(`[telegram] photo download failed: ${String(err)}`);
+            return { failed: true };
+        }
+    }
+    async function downloadDocument(msg) {
+        const doc = msg.document;
+        if (!doc)
+            return null;
+        const fallbackMime = doc.mime_type ?? "application/octet-stream";
+        try {
+            const parsed = parseDataUrl(await api.downloadFile(doc.file_id, fallbackMime));
+            if (!parsed)
+                return null;
+            const filename = doc.file_name !== undefined ? { filename: doc.file_name } : {};
+            return { attachment: { mimeType: parsed.mimeType, data: parsed.data, ...filename } };
         }
+        catch (err) {
+            log.error(`[telegram] document download failed: ${String(err)}`);
+            return { failed: true };
+        }
+    }
+    async function tryDownloadAttachments(msg) {
+        const outcomes = [await downloadPhoto(msg), await downloadDocument(msg)];
+        const attachments = outcomes.flatMap((outcome) => (outcome && "attachment" in outcome ? [outcome.attachment] : []));
+        const anyFailed = outcomes.some((outcome) => outcome !== null && "failed" in outcome);
         if (attachments.length === 0 && anyFailed) {
             return { attachments: [], failed: true };
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mulmobridge/telegram",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Telegram bridge for MulmoBridge — connect a Telegram bot to MulmoClaude",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,12 +30,30 @@
   "license": "MIT",
   "author": "Receptron Team",
   "dependencies": {
-    "@mulmobridge/client": "^1.0.0",
-    "@mulmobridge/protocol": "^1.0.0",
+    "@mulmobridge/client": "^1.0.2",
+    "@mulmobridge/protocol": "^1.0.1",
     "dotenv": "^17.0.0"
   },
   "devDependencies": {
-    "@types/node": "^26.1.1",
+    "@types/node": "^26.1.2",
     "typescript": "^6.0.3"
+  },
+  "homepage": "https://github.com/receptron/mulmoclaude/tree/main/packages/bridges/telegram#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/receptron/mulmoclaude.git",
+    "directory": "packages/bridges/telegram"
+  },
+  "keywords": [
+    "telegram",
+    "telegram-bot",
+    "mulmobridge",
+    "chatbot",
+    "bridge",
+    "ai-agent",
+    "mulmoclaude"
+  ],
+  "bugs": {
+    "url": "https://github.com/receptron/mulmoclaude/issues"
   }
 }