visionclaw 0.1.219-dev.codex-issue-2805-worker-runtime.3 → 0.1.219-dev.codex-2941-task-board-on-main.1

package/dist/channels/telegram-task-board.js

@@ -0,0 +1,384 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getSharedProfileDir } from "../config/index.js";
+import { t } from "../i18n/index.js";
+import { logger } from "../logger.js";
+import { isMessageNotModified, TelegramApiError, } from "./telegram-status.js";
+const BOARD_STORE_FILE = "telegram-task-boards.json";
+/** Coalesce bursts of task changes into one edit, well under Telegram's per-chat limit. */
+const DEFAULT_FLUSH_DELAY_MS = 1_500;
+const MAX_TITLE_LENGTH = 60;
+/**
+ * The longest a new board waits for the front reply: while the turn that
+ * delegated is still running, its reply has not been sent yet, and a board
+ * posted first would be the user's first answer (#2941).
+ */
+const DEFAULT_MAX_REPLY_WAIT_MS = 60_000;
+/**
+ * A live row the ledger no longer knows and that has not changed for this
+ * long is dropped, so one lost final update cannot keep the board pinned.
+ */
+const STALE_ROW_MS = 24 * 60 * 60_000;
+/** How often a board with live rows is checked against the ledger. */
+const DEFAULT_RECHECK_MS = 10 * 60_000;
+const STATE_DOT = {
+    queued: "🟡",
+    running: "🔵",
+    waiting: "🟣",
+    completed: "✅",
+    failed: "🔴",
+    cancelled: "⚪",
+};
+function isTerminal(state) {
+    return state === "completed" || state === "failed" || state === "cancelled";
+}
+class RateLimited extends Error {
+    retryAfterMs;
+    constructor(retryAfterMs) {
+        super("Telegram rate limit");
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+function readBatches(file) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function escapeHtml(value) {
+    return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+/**
+ * A Telegram date-time entity: every client shows it in the reader's own
+ * timezone, like the chat's own message times. The inner text is the
+ * fallback for clients without the entity, in the owner's configured zone.
+ */
+function formatTime(timestamp, timeZone) {
+    const date = new Date(timestamp);
+    if (Number.isNaN(date.getTime()))
+        return "--:--";
+    let fallback;
+    try {
+        fallback = new Intl.DateTimeFormat("en-GB", { hour: "2-digit", minute: "2-digit", hourCycle: "h23", ...(timeZone ? { timeZone } : {}) }).format(date);
+    }
+    catch {
+        fallback = new Intl.DateTimeFormat("en-GB", { hour: "2-digit", minute: "2-digit", hourCycle: "h23" }).format(date);
+    }
+    return `<tg-time unix="${Math.floor(date.getTime() / 1000)}" format="t">${fallback}</tg-time>`;
+}
+/**
+ * Board HTML (parse_mode HTML): a one-line summary (what the pinned bar
+ * shows), then one row per task. `timeZone` is the owner's configured zone,
+ * used only for the fallback text of the time entities.
+ */
+export function renderTaskBoard(tasks, locale, timeZone) {
+    const count = (state) => tasks.filter((task) => task.state === state).length;
+    const active = tasks.filter((task) => !isTerminal(task.state)).length;
+    const summary = [
+        active > 0
+            ? t(active === 1 ? "taskboard.summary.active_one" : "taskboard.summary.active", locale, String(active))
+            : t("taskboard.summary.done", locale),
+        ...["completed", "failed", "cancelled"]
+            .filter((state) => count(state) > 0)
+            .map((state) => t(`taskboard.summary.${state}`, locale, String(count(state)))),
+    ].join(" · ");
+    const rows = tasks.map((task) => {
+        const title = escapeHtml(Array.from(task.title).slice(0, MAX_TITLE_LENGTH).join(""));
+        return `${STATE_DOT[task.state]} ${title} · ${t(`taskboard.state.${task.state}`, locale)} · ${formatTime(task.at, timeZone)}`;
+    });
+    return [summary, ...rows].join("\n");
+}
+/**
+ * The pinned background-task board of each Telegram chat (#2941). Foreground
+ * replies never carry task status: the board is sent and silently pinned
+ * once per batch, after the front reply, then only edited in place; a task
+ * that did not finish gets one short notice replying to the board (a
+ * finished one gets its result from General, or the Foreman fallback);
+ * when every task is terminal the board
+ * is unpinned and stays in the history. Telegram failures are logged, never
+ * thrown: the board must not break a turn.
+ */
+export class TelegramTaskBoard {
+    options;
+    storeFile;
+    flushDelayMs;
+    maxReplyWaitMs;
+    recheckMs;
+    /** Chats whose front turn is still running (its reply is not out yet). */
+    busyChats = new Set();
+    batches;
+    timers = new Map();
+    chains = new Map();
+    stopped = false;
+    constructor(options) {
+        this.options = options;
+        this.storeFile = options.storeFile ?? path.join(getSharedProfileDir(), BOARD_STORE_FILE);
+        this.flushDelayMs = options.flushDelayMs ?? DEFAULT_FLUSH_DELAY_MS;
+        this.maxReplyWaitMs = options.maxReplyWaitMs ?? DEFAULT_MAX_REPLY_WAIT_MS;
+        this.recheckMs = options.recheckMs ?? DEFAULT_RECHECK_MS;
+        this.batches = readBatches(this.storeFile);
+        // Boards left from before a restart: their final updates may have been
+        // missed while the process was down.
+        for (const key of Object.keys(this.batches))
+            this.schedule(key, key.includes("#closed:") ? 0 : this.recheckMs);
+    }
+    /**
+     * Whether the chat's current turn is still running. A new board waits for
+     * the turn to stop (its reply is sent by then), up to `maxReplyWaitMs`.
+     */
+    setTurnRunning(address, running) {
+        const key = this.key(address);
+        if (running) {
+            this.busyChats.add(key);
+            return;
+        }
+        if (!this.busyChats.delete(key))
+            return;
+        const batch = this.batches[key];
+        if (!this.stopped && batch && batch.messageId === undefined)
+            this.reschedule(key, this.flushDelayMs);
+    }
+    update(address, task) {
+        if (this.stopped)
+            return;
+        const key = this.key(address);
+        let batch = this.batches[key];
+        const index = batch?.tasks.findIndex((entry) => entry.taskId === task.taskId) ?? -1;
+        // A terminal state only matters to a batch that already shows the task.
+        if (index < 0 && isTerminal(task.state))
+            return;
+        // A new task joining an existing board: first repair rows whose final
+        // update was lost. If none of them is still live, that board is closed
+        // (unpinned) and the new task starts a fresh one.
+        if (batch && index < 0 && this.reconcile(batch)) {
+            this.close(key, batch);
+            batch = undefined;
+        }
+        if (!batch) {
+            batch = {
+                chatId: address.chatId,
+                ...(address.messageThreadId === undefined ? {} : { messageThreadId: address.messageThreadId }),
+                pinned: false,
+                tasks: [],
+                noticed: [],
+                createdAtMs: Date.now(),
+            };
+            this.batches[key] = batch;
+        }
+        if (index < 0) {
+            batch.tasks.push(task);
+        }
+        else {
+            const previous = batch.tasks[index];
+            if (previous.state === task.state && previous.title === task.title)
+                return;
+            batch.tasks[index] = task;
+        }
+        if (!isTerminal(task.state))
+            batch.noticed = batch.noticed.filter((taskId) => taskId !== task.taskId);
+        this.persist();
+        this.schedule(key, this.flushDelayMs);
+    }
+    /**
+     * Bring live rows in line with the ledger: a row the ledger reports in
+     * another state takes that state (quietly: its result was already handled
+     * there); an unknown row that has been idle too long is dropped. Returns
+     * whether every remaining row is terminal.
+     */
+    reconcile(batch) {
+        const lookup = this.options.lookupTask;
+        const now = Date.now();
+        batch.tasks = batch.tasks.flatMap((row) => {
+            if (isTerminal(row.state))
+                return [row];
+            const live = lookup?.(row.taskId);
+            if (live) {
+                if (isTerminal(live.state) && !batch.noticed.includes(row.taskId))
+                    batch.noticed.push(row.taskId);
+                return [live.state === row.state ? row : { ...live, title: row.title }];
+            }
+            const age = now - Date.parse(row.at);
+            return Number.isFinite(age) && age > STALE_ROW_MS ? [] : [row];
+        });
+        return batch.tasks.every((row) => isTerminal(row.state));
+    }
+    /** Finish a board under its own key, so a new board can start in the chat. */
+    close(key, batch) {
+        Reflect.deleteProperty(this.batches, key);
+        const closingKey = `${key}#closed:${batch.messageId ?? batch.createdAtMs ?? Date.now()}`;
+        this.batches[closingKey] = batch;
+        this.persist();
+        this.schedule(closingKey, 0);
+    }
+    stop() {
+        this.stopped = true;
+        for (const { timer } of this.timers.values())
+            clearTimeout(timer);
+        this.timers.clear();
+    }
+    key(address) {
+        return `${this.options.botIdentity}:${address.chatId}:${address.messageThreadId ?? ""}`;
+    }
+    reschedule(key, delayMs) {
+        const existing = this.timers.get(key);
+        if (existing)
+            clearTimeout(existing.timer);
+        this.timers.delete(key);
+        this.schedule(key, delayMs);
+    }
+    /** Flush the board after `delayMs`, unless a flush is already due sooner. */
+    schedule(key, delayMs) {
+        const dueAt = Date.now() + delayMs;
+        const existing = this.timers.get(key);
+        if (existing && existing.dueAt <= dueAt)
+            return;
+        if (existing)
+            clearTimeout(existing.timer);
+        const timer = setTimeout(() => {
+            this.timers.delete(key);
+            const next = (this.chains.get(key) ?? Promise.resolve()).then(() => this.flush(key));
+            this.chains.set(key, next);
+            void next.finally(() => {
+                if (this.chains.get(key) === next)
+                    this.chains.delete(key);
+            });
+        }, delayMs);
+        timer.unref();
+        this.timers.set(key, { timer, dueAt });
+    }
+    async flush(key) {
+        const batch = this.batches[key];
+        if (this.stopped || !batch)
+            return;
+        if (batch.messageId === undefined && this.busyChats.has(key)) {
+            const waitedMs = Date.now() - (batch.createdAtMs ?? 0);
+            if (waitedMs < this.maxReplyWaitMs) {
+                this.schedule(key, this.maxReplyWaitMs - waitedMs);
+                return;
+            }
+        }
+        // The periodic safety net: a board whose last live rows went stale closes.
+        this.reconcile(batch);
+        try {
+            await this.syncBoard(batch);
+            await this.sendNotices(batch);
+            if (batch.tasks.every((task) => isTerminal(task.state))) {
+                if (batch.pinned && batch.messageId !== undefined) {
+                    const unpinned = await this.call("unpinChatMessage", { chat_id: batch.chatId, message_id: batch.messageId });
+                    if (unpinned.ok)
+                        this.logAction("unpinned", batch);
+                }
+                Reflect.deleteProperty(this.batches, key);
+            }
+        }
+        catch (error) {
+            if (error instanceof RateLimited)
+                this.schedule(key, error.retryAfterMs);
+            else
+                logger.warn(`Telegram task board update failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        finally {
+            this.persist();
+        }
+        // Live rows left: check them against the ledger again later.
+        if (this.options.lookupTask && this.batches[key] === batch)
+            this.schedule(key, this.recheckMs);
+    }
+    async syncBoard(batch) {
+        const text = renderTaskBoard(batch.tasks, this.options.locale(), this.options.timeZone?.());
+        if (batch.renderedText === text)
+            return;
+        if (batch.messageId === undefined) {
+            const sent = await this.call("sendMessage", {
+                chat_id: batch.chatId,
+                text,
+                parse_mode: "HTML",
+                disable_notification: true,
+                ...this.topic(batch),
+            });
+            const messageId = sent.ok ? sent.result?.message_id : undefined;
+            if (typeof messageId !== "number")
+                return;
+            batch.messageId = messageId;
+            batch.renderedText = text;
+            this.logAction("created", batch);
+            // The only pin of this batch: after a failed pin or a manual unpin the board stays unpinned.
+            const pinned = await this.call("pinChatMessage", {
+                chat_id: batch.chatId,
+                message_id: messageId,
+                disable_notification: true,
+            });
+            batch.pinned = pinned.ok;
+            if (pinned.ok)
+                this.logAction("pinned", batch);
+            return;
+        }
+        const edited = await this.call("editMessageText", { chat_id: batch.chatId, message_id: batch.messageId, text, parse_mode: "HTML" });
+        if (edited.ok || isMessageNotModified(edited.error))
+            batch.renderedText = text;
+        if (edited.ok)
+            this.logAction("edited", batch);
+    }
+    /** One info line per board action: ids and the task count only, never titles or text. */
+    logAction(action, batch) {
+        logger.info(`Telegram task board ${action}`, {
+            action,
+            chatId: batch.chatId,
+            messageId: batch.messageId,
+            tasks: batch.tasks.length,
+        });
+    }
+    async sendNotices(batch) {
+        const locale = this.options.locale();
+        for (const task of batch.tasks) {
+            // A finished task's own message is General's result (or the Foreman
+            // fallback when General sends none); a "done" notice before it is noise.
+            if ((task.state !== "failed" && task.state !== "cancelled") || batch.noticed.includes(task.taskId))
+                continue;
+            const sent = await this.call("sendMessage", {
+                chat_id: batch.chatId,
+                text: t(`taskboard.notice.${task.state}`, locale, task.title, t(`task.failure.${task.failure ?? "error"}`, locale)),
+                ...this.topic(batch),
+                ...(batch.messageId === undefined
+                    ? {}
+                    : { reply_parameters: { message_id: batch.messageId, allow_sending_without_reply: true } }),
+            });
+            if (sent.ok)
+                batch.noticed.push(task.taskId);
+        }
+    }
+    topic(batch) {
+        return batch.messageThreadId === undefined ? {} : { message_thread_id: batch.messageThreadId };
+    }
+    /** One Bot API call. Rate limits abort the flush for a later retry; other failures are logged. */
+    async call(method, body) {
+        try {
+            const response = await this.options.transport.request(method, body);
+            return { ok: true, result: response.result };
+        }
+        catch (error) {
+            if (error instanceof TelegramApiError && error.errorCode === 429) {
+                throw new RateLimited((error.parameters?.retry_after ?? 5) * 1000);
+            }
+            if (!isMessageNotModified(error)) {
+                logger.warn(`Telegram task board ${method} failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            return { ok: false, error };
+        }
+    }
+    persist() {
+        try {
+            fs.mkdirSync(path.dirname(this.storeFile), { recursive: true, mode: 0o700 });
+            const tmp = `${this.storeFile}.${process.pid}.tmp`;
+            fs.writeFileSync(tmp, `${JSON.stringify(this.batches, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+            fs.renameSync(tmp, this.storeFile);
+        }
+        catch (error) {
+            logger.warn(`Telegram task board state was not saved: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=telegram-task-board.js.map

package/dist/channels/telegram-task-board.js.map

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

package/dist/channels/telegram.d.ts

@@ -1,6 +1,6 @@
 import { EventEmitter } from "node:events";
 import { type VisionClawConfig } from "../config/types.js";
-import { type InboundMessageHandler, type ChannelAdapter, type DeliveryContext, type DeliveryTarget, type MessageAttachment, type ReplyContext } from "./interface.js";
+import { type BackgroundTaskView, type InboundMessageHandler, type ChannelAdapter, type DeliveryContext, type DeliveryTarget, type MessageAttachment, type ReplyContext } from "./interface.js";
 import type { PublicThreadActivity } from "../agent/public-activity.js";
 /**
  * Telegram channel adapter.
@@ -19,6 +19,8 @@ export declare class TelegramAdapter extends EventEmitter implements ChannelAdap
      *  authorize admin commands and always trust the owner's direct chat. */
     private _ownerUserId;
     private statusPublisher;
+    private taskBoard;
+    private backgroundTaskLookup;
     /** Cached plans from the most recent payment prompt, used by the callback handler */
     constructor(config: VisionClawConfig);
     /**
@@ -27,6 +29,9 @@ export declare class TelegramAdapter extends EventEmitter implements ChannelAdap
      */
     setOwnerUserId(id: number): void;
     publishThreadActivity(threadId: string, activity: PublicThreadActivity, _agentInstanceId: string, deliveryTarget?: DeliveryTarget): void;
+    setBackgroundTaskLookup(lookup: (taskId: string) => BackgroundTaskView | null): void;
+    publishBackgroundTask(target: DeliveryTarget, task: BackgroundTaskView): void;
+    private getTaskBoard;
     /** Best-effort read of the owner's language preference for i18n. */
     private getOwnerLocale;
     /** Best-effort read of the owner's timezone preference for settings UI. */

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

@@ -1 +1 @@
-{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/channels/telegram.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/channels/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAU3C,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,oBAAoB,CAAC;AAU5B,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EAEnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAiJxE;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,YAAa,YAAW,cAAc;IACzE,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,GAAG,CAA4B;IACvC,yFAAyF;IACzF,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAoD;IAC1E;6EACyE;IACzE,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,eAAe,CAAwC;IAC/D,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,oBAAoB,CAAgE;IAC5F,qFAAqF;gBAEzE,MAAM,EAAE,gBAAgB;IAKpC;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIhC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI;IAYxI,uBAAuB,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,kBAAkB,GAAG,IAAI,GAAG,IAAI;IAIpF,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAM7E,OAAO,CAAC,YAAY;IAapB,oEAAoE;IACpE,OAAO,CAAC,cAAc;IAQtB,2EAA2E;IAC3E,OAAO,CAAC,gBAAgB;IAQxB;;;;;OAKG;IACH,wBAAwB,IAAI,IAAI;IAgBhC;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCrD;;;;OAIG;YACW,uBAAuB;YA0BvB,qBAAqB;YA6DrB,sBAAsB;YAwCtB,uBAAuB;YAsCvB,mBAAmB;YAyCnB,mBAAmB;IAuEjC,6DAA6D;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CACuK;IAEpN;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;;OAGG;YACW,qBAAqB;IAQnC,OAAO,CAAC,oBAAoB;IAwL5B,OAAO,CAAC,gBAAgB;IAOxB;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;IAUjC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAYvB;;;;;;;;;OASG;IACH,OAAO,CAAC,6BAA6B;IAWrC,OAAO,CAAC,0BAA0B;IAIlC,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,uBAAuB;YAIjB,qBAAqB;YAmCrB,4BAA4B;YA0C5B,yBAAyB;IAqBvC,OAAO,CAAC,yBAAyB;IAejC,OAAO,CAAC,eAAe;YA4BT,YAAY;YA4BZ,UAAU;YA4BV,mBAAmB;IAgBjC;;;;OAIG;IACH,OAAO,CAAC,cAAc;YAWR,cAAc;YAcd,mBAAmB;YAYnB,oBAAoB;IAkBlC,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,kBAAkB;IAa1B,qFAAqF;IACrF,OAAO,CAAC,iBAAiB,CAA0E;YAErF,gBAAgB;YAahB,qBAAqB;IA6CnC;;;OAGG;YACW,iBAAiB;YAejB,YAAY;YAgDZ,sBAAsB;IA2B9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,OAAO,CAAC,kBAAkB;IAoB1B,OAAO,CAAC,6BAA6B;IAQrC,OAAO,CAAC,mBAAmB;IAoBrB,WAAW,CACf,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,iBAAiB,EAAE,EACjC,OAAO,CAAC,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC;IA8GV,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB5E;;;OAGG;YACW,qBAAqB;IAmKnC;;OAEG;YACW,eAAe;YAYf,QAAQ;IA0BtB,uDAAuD;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAa7B;IAEX,gDAAgD;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAG7B;IAEX;;OAEG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAgBhB;;;OAGG;IACG,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc3D;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoChD;;OAEG;YACW,gBAAgB;IAuB9B;;OAEG;YACW,gBAAgB;IAsC9B;;;OAGG;YACW,yBAAyB;IA+FvC;;OAEG;YACW,iBAAiB;IAmD/B;;;OAGG;YACW,qBAAqB;CA0CpC"}

package/dist/channels/telegram.js

@@ -12,7 +12,8 @@ import { applyEngineSwitchTarget, describeEngineTarget, isAlreadyOnEngineTarget,
 import { LlmGatewayModelsError } from "../agent/llm-gateway-models.js";
 import { unavailableTargetFromTelegram } from "./unavailable-target.js";
 import { VOICE_TRANSCRIPTION_HANDLED_META_KEY, isAssistantTextDelivery, } from "./interface.js";
-import { createTelegramStatusPublisher } from "./telegram-status.js";
+import { createTelegramStatusPublisher, TelegramHttpTransport } from "./telegram-status.js";
+import { TelegramTaskBoard } from "./telegram-task-board.js";
 import { buildTelegramPreview, buildTelegramTitle, createTelegramAccessEntry, formatTelegramAccessSummary, getTelegramChatKind, serializeTelegramMessage, } from "./telegram-access.js";
 import { syncBotCommands } from "../onboarding/bot-profile.js";
 import { OnboardingServiceClient } from "../onboarding/onboarding-service-client.js";
@@ -128,6 +129,8 @@ export class TelegramAdapter extends EventEmitter {
      *  authorize admin commands and always trust the owner's direct chat. */
     _ownerUserId = null;
     statusPublisher = null;
+    taskBoard = null;
+    backgroundTaskLookup = null;
     /** Cached plans from the most recent payment prompt, used by the callback handler */
     constructor(config) {
         super();
@@ -150,6 +153,30 @@ export class TelegramAdapter extends EventEmitter {
         if (!target)
             return;
         void publisher.publish(threadId, activity, target);
+        // A new task board waits until this chat's turn has sent its reply.
+        this.getTaskBoard()?.setTurnRunning(target, activity.state === "running" || activity.state === "queued");
+    }
+    setBackgroundTaskLookup(lookup) {
+        this.backgroundTaskLookup = lookup;
+    }
+    publishBackgroundTask(target, task) {
+        const address = this.resolveActivityDeliveryTarget(target);
+        if (!address)
+            return;
+        this.getTaskBoard()?.update(address, task);
+    }
+    getTaskBoard() {
+        const botToken = this.config.channels.telegram?.botToken;
+        if (!this._botIdentity || !this.bot || !botToken)
+            return null;
+        this.taskBoard ??= new TelegramTaskBoard({
+            botIdentity: this._botIdentity,
+            transport: new TelegramHttpTransport(botToken),
+            locale: () => resolveLocale(this.getOwnerLocale()),
+            timeZone: () => this.getOwnerTimezone(),
+            lookupTask: (taskId) => this.backgroundTaskLookup?.(taskId),
+        });
+        return this.taskBoard;
     }
     /** Best-effort read of the owner's language preference for i18n. */
     getOwnerLocale() {
@@ -1047,6 +1074,8 @@ export class TelegramAdapter extends EventEmitter {
     async stop() {
         this.statusPublisher?.stop();
         this.statusPublisher = null;
+        this.taskBoard?.stop();
+        this.taskBoard = null;
         if (this.bot) {
             await this.bot.stopPolling({ cancel: true });
             this.bot = null;
@@ -1066,7 +1095,7 @@ export class TelegramAdapter extends EventEmitter {
         const botToken = this.config.channels.telegram?.botToken;
         if (!ownerChatId || !botToken)
             return null;
-        this.statusPublisher ??= createTelegramStatusPublisher(botToken, ownerChatId, (threadId) => this.resolveStatusTarget(threadId));
+        this.statusPublisher ??= createTelegramStatusPublisher(botToken, ownerChatId, (threadId) => this.resolveStatusTarget(threadId), () => resolveLocale(this.getOwnerLocale()));
         return this.statusPublisher;
     }
     resolveActivityDeliveryTarget(target) {