@jungjaehoon/mama-os 0.78.0 → 0.79.1

package/dist/gateways/telegram-commands.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UPDATE_REFUSED = exports.TELEGRAM_HOST_COMMANDS = void 0;
+exports.hostCommand = hostCommand;
+exports.helpText = helpText;
+exports.whoamiText = whoamiText;
+exports.startOverText = startOverText;
+exports.stopText = stopText;
+exports.updateText = updateText;
+exports.updateGroupText = updateGroupText;
+exports.statusText = statusText;
+/**
+ * Commands the host answers itself, before any turn: the menu the bot registers and the list
+ * /help prints. Any other command text goes to MAMA as an ordinary message.
+ */
+exports.TELEGRAM_HOST_COMMANDS = [
+    { command: 'whoami', description: 'Your Telegram ID and how MAMA knows you' },
+    { command: 'status', description: 'Whether MAMA is working, and on what' },
+    { command: 'stop', description: 'Stop the turn running in this conversation' },
+    { command: 'new', description: 'Start this conversation over' },
+    { command: 'update', description: 'Update MAMA to the latest release (owners)' },
+    { command: 'help', description: 'The commands MAMA answers itself' },
+];
+/**
+ * The host command a message opens with; `other_bot` for a command addressed to another bot
+ * (`/status@other_bot`), which is not for MAMA at all; null for anything else, an unknown
+ * command included, which stays an ordinary message.
+ */
+function hostCommand(message, botUsername) {
+    const first = message.entities?.[0];
+    if (!message.text || first?.type !== 'bot_command' || first.offset !== 0)
+        return null;
+    const [name, addressee] = message.text.slice(1, first.length).split('@', 2);
+    if (addressee !== undefined && addressee.toLowerCase() !== botUsername().toLowerCase())
+        return 'other_bot';
+    const command = name.toLowerCase();
+    return exports.TELEGRAM_HOST_COMMANDS.some((entry) => entry.command === command)
+        ? command
+        : null;
+}
+function helpText() {
+    return [
+        'Commands MAMA answers itself, without a turn:',
+        ...exports.TELEGRAM_HOST_COMMANDS.map(({ command, description }) => `/${command}: ${description}`),
+        'Anything else goes to MAMA as a message.',
+    ].join('\n');
+}
+function whoamiText(input) {
+    const lines = [
+        `Telegram ID: ${input.userId}`,
+        `MAMA knows you as ${input.owner ? 'an owner' : 'a member'} (${input.principalId}).`,
+    ];
+    if (!input.privateChat) {
+        const group = `This group (${input.chatId}) is ${input.commonChannel ? "MAMA's common channel" : 'a group MAMA admits'}`;
+        lines.push(input.owner
+            ? `${group}; your messages here run in the common session.`
+            : `${group}; your messages here run in your own conversation for this group.`);
+    }
+    return lines.join('\n');
+}
+function startOverText(result, target, owner) {
+    // A member's own conversation is reset with their group conversations (member-session.ts);
+    // an owner's group messages go to the common session instead, which this does not reset.
+    const memberDm = target.kind === 'member' && target.room === undefined;
+    if (result === 'busy')
+        return 'MAMA is still busy with work that would carry into a new conversation. Wait a moment, then send /new again.';
+    if (memberDm && !owner)
+        return 'Started over: your next message, here or in a group, begins a new conversation. What MAMA has saved stays.';
+    if (memberDm)
+        return 'Started over: your next message here begins a new conversation; the common group goes on until /new there. What MAMA has saved stays.';
+    return 'Started over: the next message here begins a new conversation. What MAMA has saved stays.';
+}
+function stopText(result, target) {
+    if (result === 'idle')
+        return 'Nothing is running in this conversation.';
+    if (result === 'starting')
+        return 'A turn here is starting or finishing. Send /stop again in a moment.';
+    return target.kind === 'common'
+        ? "Stopped the common session's running turn. A message it was answering is told it was interrupted; anything waiting still runs."
+        : 'Stopped the turn running in this conversation. Its message is told it was interrupted; messages sent after it still run.';
+}
+function updateText(result) {
+    if (result.kind === 'busy')
+        return result.source === 'job'
+            ? `An /update started at ${result.since} still runs; it reports to the chat it was started from. This one starts nothing.`
+            : `An update has held the install since ${result.since}; this /update starts nothing.`;
+    if (result.kind === 'repeated')
+        return 'This /update was already received and started an update. Send /update again for another.';
+    if (result.kind === 'checkout')
+        return [
+            '/update serves npm installs. This install is a checkout, which updates by git:',
+            ...result.steps,
+        ].join('\n');
+    if (result.kind === 'not_updatable')
+        return `/update cannot update this install: ${result.reason}`;
+    return result.to === null
+        ? `Updating ${result.from} to the latest release; progress follows.`
+        : `Updating ${result.from} → ${result.to}; progress follows.`;
+}
+/**
+ * What a group is told when the answer names paths (a checkout's steps, why an install cannot be
+ * updated): the full answer goes to the owner's DM, as /status keeps the owner's view there.
+ * `dm`: whether that DM send went out.
+ */
+function updateGroupText(result, dm) {
+    const where = dm
+        ? 'the details are in your DM'
+        : 'MAMA could not send the details to your DM; send /update there';
+    return result.kind === 'checkout'
+        ? `This install updates by git, not /update; ${where}.`
+        : `/update cannot update this install; ${where}.`;
+}
+/** Who may run /update: an owner, in their own DM or the common channel. */
+exports.UPDATE_REFUSED = 'Only an owner can run /update, in their own DM with MAMA or in the common group.';
+function statusText(status) {
+    const lines = [
+        `MAMA ${status.version}, running since ${status.since}`,
+        `This conversation: ${status.conversationRunning ? 'a turn is running' : 'idle'}`,
+    ];
+    if (status.owner === undefined) {
+        lines.push(`Inputs not yet done: ${status.inputsWaiting}`);
+        return lines;
+    }
+    lines.push(`All conversations: ${status.owner.turnsRunning} turns running, ${status.inputsWaiting} inputs not yet done`);
+    const failing = status.owner.sources.filter((source) => !source.healthy);
+    if (status.owner.sources.length > 0)
+        lines.push(`Sources: ${status.owner.sources.length - failing.length} of ${status.owner.sources.length} polling` +
+            (failing.length > 0 ? `; failing: ${failing.map((source) => source.name).join(', ')}` : ''));
+    return lines;
+}
+//# sourceMappingURL=telegram-commands.js.map

package/dist/gateways/telegram-commands.js.map

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

package/dist/gateways/telegram.d.ts

@@ -2,6 +2,7 @@ import type { ActionResult, JudgmentAccess, PrincipalRepository } from '@jungjae
 import type { MemberSelection } from '../api/member-enrollment.js';
 import { BaseGateway } from './base-gateway.js';
 import type { OwnerHostExchangeInput, OwnerMessageInput, TurnIntake } from './turn-contract.js';
+import { type TelegramHostCommandPort } from './telegram-commands.js';
 import { type OwnerMessageLedger, type TelegramMessageLedgerEntry } from './telegram-message-ledger.js';
 import { type MemberFileDeliveryContext, type TelegramFileDeliveryResult } from '../api/file-delivery.js';
 export interface TelegramGatewayConfig {
@@ -30,6 +31,8 @@ export interface TelegramGatewayOptions {
     onMemberSelection?: (selection: MemberSelection) => Promise<ActionResult>;
     /** Store the final transport receipt as history, outside the owner-message intake. */
     recordMemberSelection?: (exchange: OwnerHostExchangeInput) => void;
+    /** The commands the host answers before any turn (/status, /new). */
+    hostCommands: TelegramHostCommandPort;
 }
 /** Telegram personal/common ingress and its durable response transport. */
 export declare class TelegramGateway extends BaseGateway {
@@ -50,6 +53,7 @@ export declare class TelegramGateway extends BaseGateway {
     private stopIntake;
     private intakeStopped;
     private readonly enrollmentCompletions;
+    private readonly commandAnswers;
     private readonly activePresenters;
     private readonly recentMessageIds;
     private readonly activeChat;
@@ -57,6 +61,7 @@ export declare class TelegramGateway extends BaseGateway {
     private readonly pendingEnrollments;
     private readonly onMemberSelection?;
     private readonly recordMemberSelection?;
+    private readonly hostCommands;
     private bot;
     private lastError;
     private lastMessageAt;
@@ -92,6 +97,14 @@ export declare class TelegramGateway extends BaseGateway {
     private requireAllowedChat;
     private handleMessage;
     private handleMessageInput;
+    /** Answer a host command in the chat it came from; no turn and no stored message. */
+    private answerHostCommand;
+    /**
+     * /update: an owner in their DM or the common channel; an owner in another group is refused
+     * too, since its members would read the progress. An answer that names paths goes to the
+     * owner's DM, and the group is told so.
+     */
+    private answerUpdate;
     private acceptMessage;
     /** Host preparation of a transport-verified envelope accepted while the member was retired. */
     prepareDeferredMemberInput(principalId: string, input: OwnerMessageInput): Promise<OwnerMessageInput>;
@@ -99,6 +112,13 @@ export declare class TelegramGateway extends BaseGateway {
     private createResponsePresenter;
     private deliverReadyEntry;
     recoverPendingResponses(): Promise<void>;
+    /**
+     * Recover one owner message as startup recovery does, for an input parked uncertain while the
+     * daemon runs (a turn stopped with /stop, or timed out): every other message still in flight
+     * keeps its turn and its answer.
+     */
+    recoverResponse(sourceRef: string): Promise<void>;
+    private recoverEntry;
     private sendMessageNow;
     private deliverOutboundEntry;
     private runInChatQueue;

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

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

package/dist/gateways/telegram.js

@@ -10,6 +10,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const grammy_1 = require("grammy");
 const base_gateway_js_1 = require("./base-gateway.js");
+const telegram_commands_js_1 = require("./telegram-commands.js");
 const telegram_text_entities_js_1 = require("./telegram-text-entities.js");
 const telegram_format_js_1 = require("./telegram-format.js");
 const telegram_message_ledger_js_1 = require("./telegram-message-ledger.js");
@@ -89,6 +90,7 @@ class TelegramGateway extends base_gateway_js_1.BaseGateway {
         this.stopIntake = () => resolve(undefined);
     });
     enrollmentCompletions = new Set();
+    commandAnswers = new Set();
     activePresenters = new Map();
     recentMessageIds = new Map();
     activeChat = new node_async_hooks_1.AsyncLocalStorage();
@@ -96,6 +98,7 @@ class TelegramGateway extends base_gateway_js_1.BaseGateway {
     pendingEnrollments = new Map();
     onMemberSelection;
     recordMemberSelection;
+    hostCommands;
     bot = null;
     lastError = null;
     lastMessageAt;
@@ -110,6 +113,7 @@ class TelegramGateway extends base_gateway_js_1.BaseGateway {
         this.principalPaths = options.principalPaths;
         this.onMemberSelection = options.onMemberSelection;
         this.recordMemberSelection = options.recordMemberSelection;
+        this.hostCommands = options.hostCommands;
         this.config = {
             enabled: options.config?.enabled ?? true,
             allowedChats: options.config?.allowedChats ?? [],
@@ -159,6 +163,17 @@ class TelegramGateway extends base_gateway_js_1.BaseGateway {
                 console.error(`telegram handler failed error=${this.lastError}`);
             });
             await this.bot.init();
+            // The menu only lists the commands; they are answered whether or not it is registered,
+            // so a failed registration is logged and the gateway runs on.
+            const commands = telegram_commands_js_1.TELEGRAM_HOST_COMMANDS.map(({ command, description }) => ({
+                command,
+                description,
+            }));
+            for (const type of ['all_private_chats', 'all_group_chats']) {
+                await this.bot.api.setMyCommands(commands, { scope: { type } }).catch((error) => {
+                    console.error(`telegram command menu failed scope=${type} error=${telegramErrorMessage(error)}`);
+                });
+            }
             this.connected = true;
             this.lastError = null;
             this.emitEvent({ type: 'connected', source: 'telegram', timestamp: new Date() });
@@ -196,6 +211,7 @@ class TelegramGateway extends base_gateway_js_1.BaseGateway {
     async drain() {
         await super.drain();
         await Promise.allSettled([...this.enrollmentCompletions]);
+        await Promise.allSettled([...this.commandAnswers]);
         await Promise.allSettled([...this.chatTails.values()]);
     }
     async stop() {
@@ -563,6 +579,17 @@ class TelegramGateway extends base_gateway_js_1.BaseGateway {
             return;
         }
         const principalId = principal.principalId;
+        // A host command is answered now, ahead of any intake waiting in this chat.
+        const command = (0, telegram_commands_js_1.hostCommand)(message, () => this.bot.botInfo.username);
+        if (command === 'other_bot')
+            return;
+        if (command !== null) {
+            // /new may wait for a member to be served; polling admits other updates meanwhile.
+            const answer = this.answerHostCommand(message, command, principalId).catch((error) => this.log(`telegram host command reply failed command=${command} error=${telegramErrorMessage(error)}`));
+            this.commandAnswers.add(answer);
+            void answer.finally(() => this.commandAnswers.delete(answer));
+            return;
+        }
         const recorded = this.messageLedger.get(sourceMessageRef(chatId, message.message_id));
         const memberRoom = !privateChat && (recorded ? recorded.principalId !== undefined : !this.ownerAllowed(userId));
         const selectedIntake = () => privateChat || memberRoom
@@ -612,6 +639,71 @@ class TelegramGateway extends base_gateway_js_1.BaseGateway {
         }
         await this.acceptMessage(message, principalId, intake);
     }
+    /** Answer a host command in the chat it came from; no turn and no stored message. */
+    async answerHostCommand(message, command, principalId) {
+        const chatId = String(message.chat.id);
+        const userId = String(message.from.id);
+        const privateChat = message.chat.type === 'private';
+        const owner = this.ownerAllowed(userId);
+        // Owners in the common group speak in the common session; everyone else in their own.
+        const target = !privateChat && owner
+            ? { kind: 'common' }
+            : { kind: 'member', principalId, ...(privateChat ? {} : { room: chatId }) };
+        let text;
+        try {
+            if (command === 'help')
+                text = (0, telegram_commands_js_1.helpText)();
+            else if (command === 'whoami')
+                text = (0, telegram_commands_js_1.whoamiText)({
+                    userId,
+                    chatId,
+                    privateChat,
+                    commonChannel: chatId === this.config.ownerChatId,
+                    principalId,
+                    owner,
+                });
+            else if (command === 'status')
+                // Everyone in a group reads the reply, so the owner's view of every conversation stays
+                // in the owner's DM.
+                text = (0, telegram_commands_js_1.statusText)(await this.hostCommands.status(target, owner && privateChat)).join('\n');
+            else if (command === 'stop')
+                text = (0, telegram_commands_js_1.stopText)(await this.hostCommands.stopTurn(target), target);
+            else if (command === 'update')
+                text = await this.answerUpdate(message, owner, privateChat);
+            else
+                text = (0, telegram_commands_js_1.startOverText)(await this.hostCommands.startOver(target), target, owner);
+        }
+        catch (error) {
+            this.log(`telegram host command failed command=${command} error=${telegramErrorMessage(error)}`);
+            text = `MAMA could not answer /${command}; its log has the error.`;
+        }
+        await this.bot.api.sendMessage(Number(chatId), text, {
+            reply_parameters: { message_id: message.message_id, allow_sending_without_reply: true },
+        });
+        this.log(`telegram host command=${command} chat=${privateChat ? 'private' : 'group'}`);
+    }
+    /**
+     * /update: an owner in their DM or the common channel; an owner in another group is refused
+     * too, since its members would read the progress. An answer that names paths goes to the
+     * owner's DM, and the group is told so.
+     */
+    async answerUpdate(message, owner, privateChat) {
+        const chatId = String(message.chat.id);
+        if (!owner || (!privateChat && chatId !== this.config.ownerChatId))
+            return telegram_commands_js_1.UPDATE_REFUSED;
+        const result = await this.hostCommands.update({ chatId, messageId: message.message_id });
+        if (privateChat || (result.kind !== 'checkout' && result.kind !== 'not_updatable'))
+            return (0, telegram_commands_js_1.updateText)(result);
+        let dm = true;
+        try {
+            await this.bot.api.sendMessage(message.from.id, (0, telegram_commands_js_1.updateText)(result));
+        }
+        catch (error) {
+            dm = false;
+            this.log(`telegram /update details not sent to DM error=${telegramErrorMessage(error)}`);
+        }
+        return (0, telegram_commands_js_1.updateGroupText)(result, dm);
+    }
     async acceptMessage(message, principalId, intake, queuedClaim) {
         const chatId = String(message.chat.id);
         const privateChat = message.chat.type === 'private';
@@ -828,45 +920,57 @@ class TelegramGateway extends base_gateway_js_1.BaseGateway {
         }, true);
     }
     async recoverPendingResponses() {
-        for (const entry of this.messageLedger.listUndelivered()) {
-            try {
-                if (entry.deliveryUncertain) {
-                    this.log(`telegram delivery requires reconciliation key=${entry.key} state=${entry.state} next_chunk_index=${entry.nextChunkIndex ?? 0}`);
-                    continue;
-                }
-                if (entry.key.startsWith('outbound:') && entry.state === 'ready') {
-                    // Personal turn recovery belongs to mailbox reconciliation, which checks the current person
-                    // and input before sending. Gateway startup cannot establish that authority.
-                    if (entry.idempotencyKey && (0, personal_turns_js_1.isPersonalTurnTextKey)(entry.idempotencyKey))
-                        continue;
-                    const chatId = entry.deliveryTarget?.slice('telegram:'.length);
-                    if (!entry.deliveryTarget?.startsWith('telegram:') || !chatId) {
-                        throw new Error('Telegram outbound entry has no valid destination');
-                    }
-                    if (!this.config.allowedChats?.includes(chatId)) {
-                        const recipient = this.registry.resolveByExternal('telegram', 'private', chatId);
-                        if (recipient?.kind !== 'member' || recipient.status !== 'active')
-                            continue;
-                    }
-                    await this.runInChatQueue(chatId, () => this.deliverOutboundEntry(entry.key, chatId));
-                    continue;
-                }
-                if (!entry.key.startsWith('telegram:'))
-                    continue;
-                const intake = await this.responseIntake(entry.key);
-                if (entry.state === 'ready' && entry.response !== undefined) {
-                    await this.deliverReadyEntry(entry.key);
-                    continue;
+        for (const entry of this.messageLedger.listUndelivered())
+            await this.recoverEntry(entry);
+    }
+    /**
+     * Recover one owner message as startup recovery does, for an input parked uncertain while the
+     * daemon runs (a turn stopped with /stop, or timed out): every other message still in flight
+     * keeps its turn and its answer.
+     */
+    async recoverResponse(sourceRef) {
+        const entry = this.messageLedger.get(sourceRef);
+        if (entry && entry.state !== 'delivered')
+            await this.recoverEntry(entry);
+    }
+    async recoverEntry(entry) {
+        try {
+            if (entry.deliveryUncertain) {
+                this.log(`telegram delivery requires reconciliation key=${entry.key} state=${entry.state} next_chunk_index=${entry.nextChunkIndex ?? 0}`);
+                return;
+            }
+            if (entry.key.startsWith('outbound:') && entry.state === 'ready') {
+                // Personal turn recovery belongs to mailbox reconciliation, which checks the current person
+                // and input before sending. Gateway startup cannot establish that authority.
+                if (entry.idempotencyKey && (0, personal_turns_js_1.isPersonalTurnTextKey)(entry.idempotencyKey))
+                    return;
+                const chatId = entry.deliveryTarget?.slice('telegram:'.length);
+                if (!entry.deliveryTarget?.startsWith('telegram:') || !chatId) {
+                    throw new Error('Telegram outbound entry has no valid destination');
                 }
-                if (entry.state === 'processing' && !intake.isPending?.(entry.key)) {
-                    await this.interruptResponse(entry.key);
+                if (!this.config.allowedChats?.includes(chatId)) {
+                    const recipient = this.registry.resolveByExternal('telegram', 'private', chatId);
+                    if (recipient?.kind !== 'member' || recipient.status !== 'active')
+                        return;
                 }
+                await this.runInChatQueue(chatId, () => this.deliverOutboundEntry(entry.key, chatId));
+                return;
             }
-            catch (error) {
-                // Delivery already recorded its progress; one entry must not keep polling from starting.
-                this.log(`telegram recovery failed key=${entry.key} error=${telegramErrorMessage(error)}`);
+            if (!entry.key.startsWith('telegram:'))
+                return;
+            const intake = await this.responseIntake(entry.key);
+            if (entry.state === 'ready' && entry.response !== undefined) {
+                await this.deliverReadyEntry(entry.key);
+                return;
+            }
+            if (entry.state === 'processing' && !intake.isPending?.(entry.key)) {
+                await this.interruptResponse(entry.key);
             }
         }
+        catch (error) {
+            // Delivery already recorded its progress; one entry must not keep polling from starting.
+            this.log(`telegram recovery failed key=${entry.key} error=${telegramErrorMessage(error)}`);
+        }
     }
     async sendMessageNow(chatId, text, idempotencyKey) {
         if (!this.bot)