@jungjaehoon/mama-os 0.25.0 → 0.27.0

package/dist/gateways/telegram-response-presenter.js

@@ -0,0 +1,250 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramResponsePresenter = void 0;
+exports.splitTelegramMessage = splitTelegramMessage;
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const DEFAULT_THROTTLE_MS = 800;
+const DEFAULT_MAX_LENGTH = 4096;
+const EMPTY_RESPONSE_MESSAGE = 'No response was generated.';
+function stripLeadingReasoningDecoration(text) {
+    if (!text.startsWith('||')) {
+        return text;
+    }
+    const closing = text.indexOf('||', 2);
+    if (closing < 0) {
+        return null;
+    }
+    return text.slice(closing + 2).replace(/^\s+/, '');
+}
+function redactInboundMediaPaths(text) {
+    let redacted = text.replace(/(?:\/[\w.@+-]+)*\/\.mama\/workspace\/media\/inbound\/[^\s]+/g, '[attachment]');
+    const workspaces = new Set([process.env.MAMA_WORKSPACE, (0, node_path_1.join)((0, node_os_1.homedir)(), '.mama', 'workspace')]);
+    for (const workspace of workspaces) {
+        if (!workspace)
+            continue;
+        const inboundRoot = (0, node_path_1.join)(workspace, 'media', 'inbound');
+        const escapedRoot = inboundRoot.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        redacted = redacted.replace(new RegExp(`${escapedRoot}(?:/[^\\s]+)+`, 'g'), '[attachment]');
+    }
+    return redacted;
+}
+function sanitizeVisibleText(text) {
+    const withoutDecoration = stripLeadingReasoningDecoration(text);
+    return withoutDecoration === null ? null : redactInboundMediaPaths(withoutDecoration);
+}
+function telegramErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function isSafeRateLimitRetry(error) {
+    if (error && typeof error === 'object' && 'error_code' in error && error.error_code === 429) {
+        return true;
+    }
+    return /(?:^|\b)429\b|too many requests/i.test(telegramErrorMessage(error));
+}
+function splitTelegramMessage(text, maxLength) {
+    const codePoints = Array.from(text);
+    if (codePoints.length <= maxLength) {
+        return [text];
+    }
+    const chunks = [];
+    let remaining = codePoints;
+    while (remaining.length > 0) {
+        if (remaining.length <= maxLength) {
+            chunks.push(remaining.join(''));
+            break;
+        }
+        const candidate = remaining.slice(0, maxLength);
+        const newline = candidate.lastIndexOf('\n');
+        const splitAt = newline > maxLength * 0.3 ? newline + 1 : maxLength;
+        chunks.push(remaining.slice(0, splitAt).join(''));
+        remaining = remaining.slice(splitAt);
+    }
+    return chunks;
+}
+class TelegramResponsePresenter {
+    adapter;
+    throttleMs;
+    maxLength;
+    handle = null;
+    accumulatedText = '';
+    toolStatus = '';
+    editTimer = null;
+    inFlightEdit = Promise.resolve();
+    finalized = false;
+    finalizing = false;
+    chunkRetryCount;
+    resumeFromChunk;
+    onChunkProgress;
+    constructor(adapter, options = {}) {
+        this.adapter = adapter;
+        this.throttleMs = options.throttleMs ?? DEFAULT_THROTTLE_MS;
+        this.maxLength = options.maxLength ?? DEFAULT_MAX_LENGTH;
+        this.chunkRetryCount = Math.max(1, options.chunkRetryCount ?? 3);
+        this.resumeFromChunk = Math.max(0, options.resumeFromChunk ?? 0);
+        this.onChunkProgress = options.onChunkProgress;
+    }
+    async start() {
+        if (this.handle || this.finalized || this.finalizing) {
+            return;
+        }
+        try {
+            this.handle = await this.adapter.send('⏳');
+        }
+        catch {
+            this.handle = null;
+        }
+    }
+    callbacks() {
+        return {
+            onDelta: (text) => {
+                if (this.finalized || this.finalizing) {
+                    return;
+                }
+                this.accumulatedText += text;
+                this.scheduleEdit();
+            },
+            onToolUse: (name) => {
+                if (this.finalized || this.finalizing) {
+                    return;
+                }
+                this.toolStatus = `🔧 ${name}...`;
+                this.scheduleEdit();
+            },
+            onToolComplete: (name, _toolUseId, isError) => {
+                if (this.finalized || this.finalizing || this.accumulatedText) {
+                    return;
+                }
+                this.toolStatus = `${isError ? '❌' : '✅'} ${name}`;
+                this.scheduleEdit();
+            },
+        };
+    }
+    markQueued() {
+        if (this.finalized || this.finalizing) {
+            return;
+        }
+        this.toolStatus = '⏳ Waiting for the earlier task to finish.';
+        this.scheduleEdit();
+    }
+    async finalize(rawResponse) {
+        if (this.finalized || this.finalizing) {
+            return;
+        }
+        this.finalizing = true;
+        this.cancelPendingEdit();
+        try {
+            await this.inFlightEdit;
+            const sanitized = sanitizeVisibleText(rawResponse);
+            const visible = (sanitized ?? '').trim() || EMPTY_RESPONSE_MESSAGE;
+            const chunks = splitTelegramMessage(visible, this.maxLength);
+            if (this.resumeFromChunk >= chunks.length) {
+                this.finalized = true;
+                return;
+            }
+            if (!this.handle || this.resumeFromChunk > 0) {
+                if (this.handle) {
+                    const staleHandle = this.handle;
+                    this.handle = null;
+                    await this.adapter.delete(staleHandle).catch(() => { });
+                }
+                await this.sendChunks(chunks.slice(this.resumeFromChunk), this.resumeFromChunk);
+                this.finalized = true;
+                return;
+            }
+            const handle = this.handle;
+            this.handle = null;
+            try {
+                await this.recordChunkProgress(0, true);
+                await this.adapter.edit(handle, chunks[0]);
+            }
+            catch (error) {
+                const message = telegramErrorMessage(error);
+                if (/message is not modified/i.test(message)) {
+                    // Telegram already has the desired text. Treat this as committed.
+                }
+                else if (/message to edit not found/i.test(message)) {
+                    await this.adapter.delete(handle).catch(() => { });
+                    await this.sendChunks(chunks);
+                    this.finalized = true;
+                    return;
+                }
+                else {
+                    // A timeout/network error may mean the edit was applied remotely.
+                    // Do not delete and resend an answer that could already be visible.
+                    throw error;
+                }
+            }
+            await this.recordChunkProgress(1, false);
+            await this.sendChunks(chunks.slice(1), 1);
+            this.finalized = true;
+        }
+        finally {
+            this.finalizing = false;
+        }
+    }
+    async fail(message) {
+        await this.finalize(message);
+    }
+    scheduleEdit() {
+        if (this.editTimer || this.finalized) {
+            return;
+        }
+        this.editTimer = setTimeout(() => {
+            this.editTimer = null;
+            this.inFlightEdit = this.inFlightEdit.then(() => this.flushStreamingEdit());
+        }, this.throttleMs);
+    }
+    async flushStreamingEdit() {
+        if (this.finalized || !this.handle) {
+            return;
+        }
+        const sanitized = sanitizeVisibleText(this.accumulatedText);
+        if (sanitized === null) {
+            return;
+        }
+        const visible = sanitized.trim() || this.toolStatus;
+        if (!visible) {
+            return;
+        }
+        const visibleCodePoints = Array.from(visible);
+        const bounded = visibleCodePoints.length > this.maxLength
+            ? visibleCodePoints.slice(-this.maxLength).join('')
+            : visible;
+        await this.adapter.edit(this.handle, bounded).catch(() => { });
+    }
+    cancelPendingEdit() {
+        if (this.editTimer) {
+            clearTimeout(this.editTimer);
+            this.editTimer = null;
+        }
+    }
+    async sendChunks(chunks, startIndex = 0) {
+        for (let offset = 0; offset < chunks.length; offset += 1) {
+            const chunk = chunks[offset];
+            const chunkIndex = startIndex + offset;
+            let lastError;
+            for (let attempt = 1; attempt <= this.chunkRetryCount; attempt += 1) {
+                try {
+                    await this.recordChunkProgress(chunkIndex, true);
+                    await this.adapter.send(chunk);
+                    await this.recordChunkProgress(chunkIndex + 1, false);
+                    lastError = undefined;
+                    break;
+                }
+                catch (error) {
+                    if (!isSafeRateLimitRetry(error))
+                        throw error;
+                    lastError = error;
+                }
+            }
+            if (lastError)
+                throw lastError;
+        }
+    }
+    async recordChunkProgress(nextIndex, uncertain) {
+        await this.onChunkProgress?.(nextIndex, uncertain);
+    }
+}
+exports.TelegramResponsePresenter = TelegramResponsePresenter;
+//# sourceMappingURL=telegram-response-presenter.js.map

package/dist/gateways/telegram-response-presenter.js.map

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

package/dist/gateways/telegram.d.ts

@@ -2,14 +2,16 @@
  * Telegram Gateway for MAMA Standalone
  *
  * Production-hardened Telegram bot integration using grammY:
- * - 2-stage message dedup (message_id + content signature)
+ * - Telegram message_id dedup without dropping repeated short replies
+ * - Photo/document/caption ingestion through MAMA content blocks
  * - Group chat filtering (mention/command/reply-to-bot only)
  * - Sticker receive/send with emotion mapping
- * - ToolStatusTracker streaming (placeholder → editMessageText)
+ * - Single-message streaming presenter (placeholder → final answer)
  * - Typing indicator, error handling
  */
 import { BaseGateway } from './base-gateway.js';
 import type { MessageRouter } from './message-router.js';
+import { type TelegramMediaDownloadRequest } from './telegram-media.js';
 /**
  * Telegram Gateway configuration
  */
@@ -33,6 +35,12 @@ export interface TelegramGatewayOptions {
     config?: Partial<TelegramGatewayConfig>;
     /** Polling interval in ms (unused with grammY, kept for interface compat) */
     pollIntervalMs?: number;
+    /** Internal test seam; production defaults to MAMA's private Telegram media directory. */
+    mediaRoot?: string;
+    /** Internal test seam for the external Telegram file request. */
+    fetchImpl?: TelegramMediaDownloadRequest['fetchImpl'];
+    /** Internal test/operations seam for restart-safe completed-message deduplication. */
+    messageLedgerPath?: string;
 }
 /**
  * Telegram Gateway class
@@ -46,8 +54,12 @@ export declare class TelegramGateway extends BaseGateway {
     private botUsername;
     private lastError;
     private lastMessageAt;
+    private readonly mediaRoot;
+    private readonly fetchImpl?;
+    private readonly messageLedger;
+    private readonly chatTails;
+    private readonly activeChat;
     private recentMessageIds;
-    private recentMessageSignatures;
     private rejectedChatWarnAt;
     private dedupCleanupTimer;
     private stickerCache;
@@ -57,13 +69,24 @@ export declare class TelegramGateway extends BaseGateway {
     start(): Promise<void>;
     stop(): Promise<void>;
     private handleMessage;
-    sendMessage(chatId: string, text: string): Promise<void>;
-    sendFile(chatId: string, filePath: string, caption?: string): Promise<void>;
-    sendImage(chatId: string, imagePath: string, caption?: string): Promise<void>;
+    private runInChatQueue;
+    private processMessage;
+    sendMessage(chatId: string, text: string, idempotencyKey?: string): Promise<void>;
+    sendMessageFromActiveTurn(chatId: string, text: string, idempotencyKey?: string): Promise<void>;
+    private sendMessageNow;
+    sendFile(chatId: string, filePath: string, caption?: string, idempotencyKey?: string): Promise<void>;
+    sendFileFromActiveTurn(chatId: string, filePath: string, caption?: string, idempotencyKey?: string): Promise<void>;
+    sendImage(chatId: string, imagePath: string, caption?: string, idempotencyKey?: string): Promise<void>;
+    sendImageFromActiveTurn(chatId: string, imagePath: string, caption?: string, idempotencyKey?: string): Promise<void>;
+    private sendOutboundOnce;
+    private recoverPendingInboundDeliveries;
+    private createResponsePresenter;
+    private outboundLedgerKey;
     sendSticker(chatId: string | number, emotion: string): Promise<boolean>;
+    sendStickerFromActiveTurn(chatId: string | number, emotion: string): Promise<boolean>;
+    private sendStickerNow;
     getLastError(): string | null;
     getLastMessageAt(): number | undefined;
-    private splitMessage;
     private loadStickerSet;
 }
 //# sourceMappingURL=telegram.d.ts.map

package/dist/gateways/telegram.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/gateways/telegram.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,qBAAqB,CAAC;AAgC3E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,aAAa,EAAE,aAAa,CAAC;IAC7B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxC,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,QAAQ,CAAC,MAAM,EAAG,UAAU,CAAU;IAEtC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,aAAa,CAAqB;IAG1C,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,uBAAuB,CAA6B;IAC5D,OAAO,CAAC,kBAAkB,CAA6B;IAGvD,OAAO,CAAC,iBAAiB,CAA+C;IAGxE,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,gBAAgB,CAAS;IAEjC,SAAS,KAAK,cAAc,IAAI,MAAM,GAAG,IAAI,CAE5C;gBAEW,OAAO,EAAE,sBAAsB;IAUrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0FtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAwBb,aAAa;IAkLrB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3E,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7E,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB7E,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC,OAAO,CAAC,YAAY;YAiBN,cAAc;CAc7B"}
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/gateways/telegram.ts"],"names":[],"mappings":"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"}