@withbuddi/buddi 0.1.0-pre.17 → 0.1.0-pre.19

package/node_modules/@buddi/gateway/dist/telegram/surface.js

@@ -15,14 +15,23 @@
  *  - Runs are serialized per chat, so two quick messages cannot interleave in
  *    one conversation.
  */
-import { DEFAULT_TIMEZONE, cancelReminder, getOnboarding, consumePairingCode, getActiveAgent, getOwnerDisplayName, listReminders, listSurfaceIdentitiesDetailed, localDateString, recordOfferJob, renderOffers, localDateTimeString, recordSurfaceUpdate, resolveOwnerForSurface, roleProblemMessage, setActiveAgent, setSurfaceCursor, takeOffer, answerQuestion, getQuestion, TELEGRAM_SURFACE, touchSurfaceIdentity, } from '@buddi/core';
+import { DEFAULT_TIMEZONE, cancelReminder, getOnboarding, consumePairingCode, getActiveAgent, getOwnerDisplayName, listReminders, listSurfaceIdentitiesDetailed, localDateString, recordOfferJob, renderOffers, localDateTimeString, recordSurfaceUpdate, resolveOwnerForSurface, roleProblemMessage, setActiveAgent, setSurfaceCursor, takeOffer, answerQuestion, getQuestion, TELEGRAM_SURFACE, touchSurfaceIdentity, presenceTouch, } from '@buddi/core';
 import { InterjectionQueue, createConversation } from '@buddi/runtime';
-import { MAX_CALLBACK_DATA_BYTES, MAX_MESSAGE_CHARS, } from './api.js';
+import { MAX_CALLBACK_DATA_BYTES, } from './api.js';
 import { extractAttachment, filesText, formatBytes, getLastAttachment, gotAudioText, gotFileText, listChatAttachments, MAX_ATTACHMENT_BYTES, ATTACHMENT_RECENCY_MS, oversizeText, recordChatAttachment, referencesAttachment, } from './attachments.js';
 import { BROWSER_COMMAND_HELP, parseBrowserCommand, } from './browser-view.js';
 import { isUnknownAgentError } from './types.js';
+import { whereText } from './commands.js';
+import { BURST_GAP_MS, StreamedAnswer, sendBurst, sendRunExtras, toPlainText, } from './outbound.js';
 import { FIRST_RUN_SUFFIX, shouldStartFirstRun } from '../agents/first-run.js';
 export const SURFACE = 'telegram';
+/** Proposal cards' callback prefix (`proposals.ts`); here so routing needs no import cycle. */
+export const PROPOSAL_CALLBACK_PREFIX = 'prp';
+/** `/missions` or `/goals` in a build that cannot read them. */
+export const SCHEDULE_UNAVAILABLE_TEXT = 'I cannot read the schedule from here; it is on the dashboard.';
+export const GOALS_UNAVAILABLE_TEXT = 'I cannot read the goals from here; they are on the dashboard.';
+// Moved to `outbound.ts`, where every send lives; still importable from here.
+export { BURST_GAP_MS, MAX_BURST_MESSAGES, TOOL_NAMESPACES, splitIntoMessages, stripToolNames, toPlainText, } from './outbound.js';
 /** The bubble posted when the agent that is working is not known by name. */
 export const PLACEHOLDER_TEXT = '⏳ Working on it…';
 /**
@@ -88,6 +97,8 @@ export const HELP = [
     '',
     'Send a statement, a receipt photo or a CSV and tell me what to do with it.',
     '',
+    'Answers here are kept short, because you read them on a phone. Ask for more and you get more.',
+    '',
     'Just write your question. Commands:',
     '/agents — list the agents you can talk to, and tap one to switch',
     '/use <handle> — switch to an agent, e.g. /use @ledger',
@@ -99,6 +110,9 @@ export const HELP = [
     '/reminders — what the agents have put on the clock, with a button to cancel one',
     '/quiet [1d|1w|off] — stop proactive messages for a while (7 days by default)',
     '/approvals — anything waiting for your approval',
+    '/missions — the next five scheduled missions',
+    '/goals — each goal with its number and where it stands',
+    '/where — the dashboard address, when your phone can reach it',
     '/browser — where the screen stands; /browser stop, /browser resume, /browser release',
     '/host — host execution permissions and running commands',
     '/hoststop — interrupt all host commands',
@@ -119,37 +133,9 @@ export const HELP = [
  * onboarding is `pending`, the default agent is run with `FIRST_RUN_SUFFIX` and
  * conducts the interview in its own words, using the `owner.*` tools.
  *
- * What is left in code is only the *shape* of the delivery, below.
- */
-/** How many messages one first-run answer may be broken into. */
-export const MAX_BURST_MESSAGES = 3;
-/** The pause between them: long enough to read as typing, short enough to wait. */
-export const BURST_GAP_MS = 600;
-/**
- * Break an answer into the messages it should arrive as.
- *
- * A paragraph break is the agent saying "and then this" — in a chat that is a
- * second message, not a blank line inside one bubble. So up to
- * `MAX_BURST_MESSAGES` paragraphs become that many sends, with a typing
- * indicator in between.
- *
- * The cap is a cap, not a truncation: an answer with *more* paragraphs than
- * that is sent whole. Breaking a six-paragraph explanation into three bubbles
- * and a blob would read worse than either, and a first run should never be
- * six paragraphs anyway — the skill says two short messages, maximum.
+ * What is left in code is only the *shape* of the delivery, which lives in
+ * `outbound.ts` with every other send.
  */
-export function splitIntoMessages(text, max = MAX_BURST_MESSAGES) {
-    const body = text.trim();
-    if (body === '')
-        return [];
-    const paragraphs = body
-        .split(/\n\s*\n/)
-        .map((part) => part.trim())
-        .filter((part) => part !== '');
-    if (paragraphs.length <= 1 || paragraphs.length > max)
-        return [body];
-    return paragraphs;
-}
 /**
  * A file arrived in a build with no artifact store wired up. Not an error the
  * owner caused, and said as a fact about the installation rather than a stack.
@@ -325,215 +311,19 @@ export function newAgentOpening(arg) {
     const said = arg.trim();
     return said === '' ? NEW_AGENT_OPENING : said;
 }
+/** The extras a reply carries past its text, copied onto the drawn turn. */
+function extrasOf(produced) {
+    if (typeof produced === 'string')
+        return {};
+    return {
+        ...(produced.artifacts && produced.artifacts.length > 0 ? { artifacts: produced.artifacts } : {}),
+        ...(produced.canvas ? { canvas: produced.canvas } : {}),
+    };
+}
 /** The text of a reply, whichever shape the runner returned. */
 export function replyText(reply) {
     return typeof reply === 'string' ? reply : reply.text;
 }
-/* ------------------------------------------------------------------ *
- * Plain text safety net
- * ------------------------------------------------------------------ */
-/*
- * We never send `parse_mode`, so any markdown a model emits is shown to the
- * owner literally: `**Status — 2026-09-13**`, backticks, pipe tables. The
- * prompt asks for plain text; this is the deterministic net under that ask.
- *
- * It is pure and conservative: markers are only removed when they actually
- * wrap a span, so arithmetic (`2 * 3`) and identifiers (`snake_case`) survive
- * untouched, and no digit, currency symbol or word is ever rewritten.
- */
-/** A ``` fence line, with or without a language tag. */
-const FENCE_RE = /^\s*```[A-Za-z0-9_+-]*\s*$/;
-/** `# Heading` → `Heading`. Only at the start of a line, marker plus space. */
-const HEADING_RE = /^(\s*)#{1,6}[ \t]+(?=\S)/;
-/** `[label](url)` → `label (url)`. */
-const LINK_RE = /\[([^\]\n]*)\]\(([^()\s]*)\)/g;
-/** `` `code` `` → `code`. Single backticks only; the span may not be empty. */
-const INLINE_CODE_RE = /`([^`\n]+)`/g;
-/** `**bold**` — both markers must hug non-space, so `a ** b` is left alone. */
-const BOLD_STAR_RE = /\*\*(?=\S)([^*\n]+?)(?<=\S)\*\*/g;
-/** `__bold__` — word characters on either side mean it is an identifier. */
-const BOLD_UNDER_RE = /(^|[^\w])__(?=\S)([^_\n]+?)(?<=\S)__(?!\w)/g;
-/** `*italic*` — a lone `*` (as in `2 * 3`) never matches: it wraps nothing. */
-const ITALIC_STAR_RE = /\*(?=\S)([^*\n]+?)(?<=\S)\*/g;
-/** `_italic_` — `snake_case` keeps its underscores: they sit inside a word. */
-const ITALIC_UNDER_RE = /(^|[^\w])_(?=\S)([^_\n]+?)(?<=\S)_(?!\w)/g;
-/** `|---|:--:|` and friends: a table rule carries no content. */
-function isTableSeparatorRow(cells) {
-    return cells.length > 0 && cells.every((cell) => /^:?-{2,}:?$/.test(cell));
-}
-/** `| a | b |` → `a — b`; the separator row is dropped by the caller. */
-function tableCells(line) {
-    const trimmed = line.trim();
-    if (!trimmed.startsWith('|') || trimmed.length < 2)
-        return undefined;
-    const inner = trimmed.replace(/^\|/, '').replace(/\|$/, '');
-    if (!inner.includes('|') && inner.trim() === '')
-        return undefined;
-    return inner.split('|').map((cell) => cell.trim());
-}
-/** Marker removal inside one line of prose. Never applied to fenced code. */
-function stripInline(line) {
-    return line
-        .replace(LINK_RE, (whole, label, url) => {
-        const text = label.trim();
-        if (url === '')
-            return text;
-        return text === '' ? url : `${text} (${url})`;
-    })
-        .replace(INLINE_CODE_RE, '$1')
-        .replace(BOLD_STAR_RE, '$1')
-        .replace(BOLD_UNDER_RE, '$1$2')
-        .replace(ITALIC_STAR_RE, '$1')
-        .replace(ITALIC_UNDER_RE, '$1$2');
-}
-/* ------------------------------------------------------------------ *
- * Tool names never reach the owner
- * ------------------------------------------------------------------ */
-/**
- * The namespaces the runtime registers tools under. Tool names are internal
- * plumbing: the owner is told what happened, never which function did it.
- * The personas say so, and this pass is the deterministic net under that ask
- * for the turns where the model slips anyway.
- *
- * The surface is constructed without a registry to read, so this is the one
- * place the namespaces live. A new namespace belongs here the day its tools
- * are registered.
- */
-export const TOOL_NAMESPACES = [
-    'finance',
-    'memory',
-    'artifacts',
-    'email',
-    'agent',
-    'mission',
-    'reminder',
-    'schedule',
-];
-/**
- * Tool names that carry no underscore. A dotted pair counts as a tool only
- * when the namespace is known *and* the second half is snake_case or one of
- * these — "has a dot" is never the rule, so `gmail.com`, `shotcrisp.app`,
- * `Statement.pdf`, `v1.2.3` and an email address are all left alone.
- */
-const TOOL_WORDS = [
-    'summary',
-    'balance',
-    'delegate',
-    'report',
-    'silent',
-    'status',
-    'search',
-    'send',
-    'list',
-    'add',
-    'set',
-    'get',
-    'cancel',
-    'snooze',
-    'purge',
-    'remember',
-    'recall',
-    'forget',
-    'note',
-    'read',
-    'text',
-    'describe',
-    'reconcile',
-];
-const NAMESPACE_ALT = TOOL_NAMESPACES.join('|');
-/**
- * `finance.set_liability`, `agent.delegate`. The guards on either side keep
- * the match off anything that merely contains a dot: a longer hostname
- * (`mail.finance.summary.io`), a path segment, an address local part. A dot
- * that ends a sentence is not a continuation, so a mention may close one.
- */
-const TOOL_REF_SRC = `(?<![\\w./@-])(?:${NAMESPACE_ALT})\\.` +
-    `(?:[a-z][a-z0-9]*(?:_[a-z0-9]+)+|${TOOL_WORDS.join('|')})(?![\\w@/-])(?!\\.[A-Za-z0-9])`;
-/** `(finance.set_liability)`, `(via agent.delegate)` — the whole aside goes. */
-const TOOL_PAREN_RE = new RegExp(`[ \\t]*\\((?:\\s*(?:via|see|using|through|with|by)\\s+)?${TOOL_REF_SRC}` +
-    `(?:[ \\t]*(?:,|and|\\+|&)[ \\t]*${TOOL_REF_SRC})*[ \\t]*\\)`, 'gi');
-/** `` `finance.x` ``, `'finance.x'`, `"finance.x"` — the quotes leave with it. */
-const TOOL_QUOTED_RE = new RegExp(`[\`'"“‘]${TOOL_REF_SRC}[\`'"”’]`, 'gi');
-/** A bare mention, with the connector that introduced it when there is one. */
-const TOOL_BARE_RE = new RegExp(`(?:[ \\t]+(?:via|using|through|by calling)[ \\t]+)?${TOOL_REF_SRC}`, 'gi');
-/**
- * Spacing and punctuation left dangling by a removal: `stored , and` or
- * `on the calendar .`. Applied only to a line something was actually removed
- * from, so prose that mentions no tool is returned byte for byte.
- */
-function tidyAfterRemoval(cleaned, indent) {
-    const body = cleaned
-        .replace(/\(\s*\)/g, '')
-        .replace(/\[\s*\]/g, '')
-        .replace(/[ \t]{2,}/g, ' ')
-        .replace(/\([ \t]+/g, '(')
-        .replace(/[ \t]+([,.;:!?)])/g, '$1')
-        .replace(/,(?:[ \t]*,)+/g, ',')
-        .replace(/,[ \t]*([.;:!?])/g, '$1')
-        .replace(/([.;:!?])[ \t]*,/g, '$1')
-        .trim();
-    if (body === '')
-        return '';
-    // All that survived is punctuation: the mention *was* the sentence. Drop
-    // the remains and leave every other line of the answer untouched.
-    return /^[,.;:!?—-]+$/.test(body) ? '' : `${indent}${body}`;
-}
-/** One line of prose, minus any tool reference and the mess it leaves. */
-function stripToolNamesFromLine(line) {
-    const cleaned = line
-        .replace(TOOL_PAREN_RE, '')
-        .replace(TOOL_QUOTED_RE, '')
-        .replace(TOOL_BARE_RE, '');
-    if (cleaned === line)
-        return line;
-    return tidyAfterRemoval(cleaned, /^[ \t]*/.exec(line)?.[0] ?? '');
-}
-/**
- * Remove internal tool names from an agent answer. Pure, idempotent, and
- * conservative: a line with no tool reference in it is returned unchanged.
- *
- * Exported on its own so every surface that renders an answer — Telegram
- * through `toPlainText`, the CLI directly — applies the same rule.
- */
-export function stripToolNames(text) {
-    if (text === '')
-        return '';
-    return text.split('\n').map(stripToolNamesFromLine).join('\n');
-}
-/**
- * Render agent-authored markdown as the plain text Telegram will display
- * verbatim. Pure: same input, same output, no clock and no I/O.
- *
- * Applied to final agent and mission answers only. Progress lines and the
- * surface's own copy (`/help`, `/agents`) are already plain by construction.
- */
-export function toPlainText(text) {
-    if (text === '')
-        return '';
-    const lines = text.split('\n');
-    const out = [];
-    let inFence = false;
-    for (const line of lines) {
-        if (FENCE_RE.test(line)) {
-            // Drop the fence, keep whatever it wrapped.
-            inFence = !inFence;
-            continue;
-        }
-        if (inFence) {
-            out.push(line);
-            continue;
-        }
-        const cells = tableCells(line);
-        if (cells) {
-            if (isTableSeparatorRow(cells))
-                continue;
-            out.push(stripToolNamesFromLine(stripInline(cells.join(' — '))));
-            continue;
-        }
-        out.push(stripToolNamesFromLine(stripInline(line.replace(HEADING_RE, '$1'))));
-    }
-    return out.join('\n').replace(/\n{3,}/g, '\n\n');
-}
 /* ------------------------------------------------------------------ *
  * The progress bubble
  * ------------------------------------------------------------------ */
@@ -553,6 +343,7 @@ export class ProgressBubble {
     intervalMs;
     now;
     #labels = [];
+    #silent = false;
     #calls = 0;
     #chain = Promise.resolve();
     #lastEditAt = 0;
@@ -572,7 +363,7 @@ export class ProgressBubble {
         const label = toolLabel(name);
         if (!this.#labels.includes(label))
             this.#labels.push(label);
-        if (this.messageId === undefined)
+        if (this.messageId === undefined || this.#silent)
             return;
         const at = this.now();
         if (this.#lastEditAt !== 0 && at - this.#lastEditAt < this.intervalMs)
@@ -597,6 +388,13 @@ export class ProgressBubble {
     get toolCalls() {
         return this.#calls;
     }
+    /**
+     * Stop editing: the answer is streaming into this message now, and a
+     * progress line written over it would take the owner's text away.
+     */
+    silence() {
+        this.#silent = true;
+    }
     /** Wait for in-flight edits, so the final answer is the last write. */
     settle() {
         return this.#chain;
@@ -843,6 +641,8 @@ export function callbackKind(data) {
         return 'offer';
     if (raw.startsWith(`${QUESTION_CALLBACK_PREFIX}:`))
         return 'question';
+    if (raw.startsWith(`${PROPOSAL_CALLBACK_PREFIX}:`))
+        return 'proposal';
     return 'approval';
 }
 /**
@@ -997,6 +797,18 @@ export class TelegramSurface {
                 this.enqueue(chain, () => this.handleQuestionCallback(callback));
                 return;
             }
+            if (kind === 'proposal') {
+                const proposals = this.#opts.proposals;
+                if (!proposals) {
+                    this.#log('telegram: proposal callback ignored (no proposal cards wired)');
+                    await this.#opts.api.answerCallbackQuery(callback.id).catch(() => { });
+                    return;
+                }
+                // Authorization is the proposal handler's, which re-establishes the
+                // owner identity from core, as the approval handler does.
+                this.enqueue(chain, () => proposals.handleCallback(callback));
+                return;
+            }
             const approvals = this.#opts.approvals;
             if (!approvals) {
                 this.#log('telegram: callback_query ignored (no approval machinery wired)');
@@ -1177,6 +989,9 @@ export class TelegramSurface {
     /** `last_seen_at`, at most once per identity per `TOUCH_INTERVAL_MS`. */
     async #touch(userId, label) {
         const at = this.#now();
+        // Presence, unthrottled: the owner is here now, and "now" is what decides
+        // whether a notification is shown or sent (docs/notifications.md).
+        await presenceTouch(this.#opts.pool, SURFACE, new Date(at)).catch((err) => this.#log(`telegram: presence failed: ${message(err)}`));
         const last = this.#lastTouch.get(userId);
         if (last !== undefined && at - last < TOUCH_INTERVAL_MS)
             return;
@@ -1345,6 +1160,22 @@ export class TelegramSurface {
             await this.handleReminders(chatId);
             return;
         }
+        // Read-only, all three: the phone says where things stand; changing them
+        // is the dashboard's.
+        if (command === '/missions') {
+            const missions = this.#opts.missions;
+            await this.#opts.api.sendMessage(chatId, missions ? await missions() : SCHEDULE_UNAVAILABLE_TEXT);
+            return;
+        }
+        if (command === '/goals') {
+            const goals = this.#opts.goals;
+            await this.#opts.api.sendMessage(chatId, goals ? await goals() : GOALS_UNAVAILABLE_TEXT);
+            return;
+        }
+        if (command === '/where') {
+            await this.#opts.api.sendMessage(chatId, whereText(this.#opts.publicOrigin));
+            return;
+        }
         // `/quiet 1w` — the argument is everything after the command word, so
         // `/quiet` alone parses as the default. The surface never reads a duration.
         if (command === '/quiet') {
@@ -1480,27 +1311,8 @@ export class TelegramSurface {
             stopTyping();
         }
     }
-    /**
-     * Send one answer as up to three messages, typing between them.
-     *
-     * The pause is the whole point: three bubbles posted in the same millisecond
-     * are one block with extra steps. `splitIntoMessages` decides how many there
-     * are; this only paces them.
-     */
     async #sendBurst(chatId, reply) {
-        const parts = splitIntoMessages(reply);
-        if (parts.length === 0) {
-            await this.#opts.api.sendMessage(chatId, '(no reply)');
-            return;
-        }
-        const gap = this.#opts.burstGapMs ?? BURST_GAP_MS;
-        for (const [index, part] of parts.entries()) {
-            if (index > 0) {
-                await this.#opts.api.sendChatAction(chatId).catch(() => { });
-                await sleep(gap);
-            }
-            await this.#opts.api.sendMessage(chatId, part);
-        }
+        await sendBurst(this.#opts.api, chatId, reply, this.#opts.burstGapMs ?? BURST_GAP_MS);
     }
     /**
      * The owner's answer to a question a one-shot agent asked.
@@ -1577,7 +1389,7 @@ export class TelegramSurface {
         const interjections = new InterjectionQueue();
         this.#interjections.set(chatId, interjections);
         try {
-            await this.#withBubble(chatId, async (progress) => {
+            await this.#withBubble(chatId, async (progress, stream) => {
                 const produced = await this.#opts.run({
                     conversationId,
                     chatId,
@@ -1586,6 +1398,7 @@ export class TelegramSurface {
                     interjections,
                     ...(carried?.attachments.length ? { attachments: carried.attachments } : {}),
                     onToolCall: (name) => progress.noteToolCall(name),
+                    onTextDelta: (delta) => stream.push(delta),
                 });
                 const reply = replyText(produced);
                 askedOwner = turnAskedOwner(typeof produced === 'string' ? undefined : produced.askedOwner, reply);
@@ -1601,6 +1414,7 @@ export class TelegramSurface {
                 return {
                     ...renderOffers(TELEGRAM_SURFACE, note ? `${note}\n\n${reply}` : reply, typeof produced === 'string' ? [] : (produced.offers ?? [])),
                     ...(typeof produced !== 'string' && produced.question ? { question: produced.question } : {}),
+                    ...extrasOf(produced),
                 };
             }, label, carried ? readingText(label) : undefined, { agentId: agent.id, conversationId, prompt });
         }
@@ -1758,13 +1572,14 @@ export class TelegramSurface {
             filename,
             sizeBytes: row.sizeBytes,
         });
-        await this.#withBubble(chatId, async (progress) => this.#rendered(await this.#opts.run({
+        await this.#withBubble(chatId, async (progress, stream) => this.#rendered(await this.#opts.run({
             conversationId,
             chatId,
             agent,
             text: caption,
             ...(turn.attachments.length ? { attachments: turn.attachments } : {}),
             onToolCall: (name) => progress.noteToolCall(name),
+            onTextDelta: (delta) => stream.push(delta),
         })), handleLabel(agent.handle), readingText(handleLabel(agent.handle)));
     }
     /** `/use <handle|id>` — switch this chat to another agent, or explain why not. */
@@ -2152,17 +1967,41 @@ export class TelegramSurface {
             return undefined;
         });
         const progress = new ProgressBubble(this.#opts.api, chatId, placeholderId, this.#log, this.#opts.progressIntervalMs ?? PROGRESS_EDIT_INTERVAL_MS, this.#opts.now ?? (() => Date.now()), placeholder);
+        // The answer, streamed into the same bubble while the model speaks. The
+        // first chunk silences the progress line; the final write is the answer.
+        const outbound = { api: this.#opts.api, log: this.#log };
+        const stream = new StreamedAnswer(outbound, chatId, placeholderId, {
+            now: this.#opts.now ?? (() => Date.now()),
+            ...(this.#opts.streamIntervalMs === undefined ? {} : { intervalMs: this.#opts.streamIntervalMs }),
+            // Typing is already on, from `#startTyping`.
+            typing: false,
+            takeOver: async () => {
+                progress.silence();
+                await progress.settle();
+            },
+        });
         try {
             // Safety net, not the mechanism: TELEGRAM_SURFACE already told the model
             // markdown does not render here, and we never send `parse_mode`. This
             // catches the answer of a model that ignored the profile.
-            const produced = await produce(progress);
+            const produced = await produce(progress, stream);
             const drawn = typeof produced === 'string' ? { text: produced, controls: [] } : produced;
             const reply = toPlainText(drawn.text);
             await progress.settle();
-            await this.#finish(chatId, placeholderId, reply, drawn.question && drawn.question.options.length > 0
+            await stream.finish(reply, drawn.question && drawn.question.options.length > 0
                 ? questionKeyboard(drawn.question)
                 : drawn.controls.length === 0 ? undefined : offersKeyboard(drawn.controls));
+            // Then what else the turn made: the view it drew, the files it saved.
+            if (drawn.artifacts || drawn.canvas) {
+                await sendRunExtras({
+                    ...outbound,
+                    ...(this.#opts.artifacts ? { artifacts: this.#opts.artifacts } : {}),
+                    ...(this.#opts.publicOrigin ? { publicOrigin: this.#opts.publicOrigin } : {}),
+                }, chatId, {
+                    ...(drawn.artifacts ? { artifacts: drawn.artifacts } : {}),
+                    ...(drawn.canvas ? { canvas: drawn.canvas } : {}),
+                });
+            }
         }
         catch (err) {
             // The raw error goes to the log with its whole cause chain; what reaches
@@ -2185,7 +2024,7 @@ export class TelegramSurface {
                 message: outcome.detail,
             });
             await progress.settle();
-            await this.#replace(chatId, placeholderId, toPlainText(outcome.rendered.text), outcome.rendered.controls.length === 0
+            await stream.finish(toPlainText(outcome.rendered.text), outcome.rendered.controls.length === 0
                 ? undefined
                 : offersKeyboard(outcome.rendered.controls)).catch(() => { });
         }
@@ -2193,34 +2032,6 @@ export class TelegramSurface {
             stopTyping();
         }
     }
-    /**
-     * Land the answer in the placeholder when it fits — one bubble, no flicker —
-     * and otherwise drop the placeholder and send the chunks.
-     */
-    async #finish(chatId, placeholderId, reply, keyboard) {
-        const text = reply.trim() === '' ? '(no reply)' : reply;
-        if (placeholderId !== undefined && text.length > MAX_MESSAGE_CHARS) {
-            await this.#opts.api.deleteMessage(chatId, placeholderId).catch((err) => {
-                this.#log(`telegram: placeholder delete failed: ${message(err)}`);
-            });
-            await this.#opts.api.sendMessage(chatId, text, keyboard ? { replyMarkup: keyboard } : {});
-            return;
-        }
-        await this.#replace(chatId, placeholderId, text, keyboard);
-    }
-    /** Edit the placeholder, falling back to a new message on any edit failure. */
-    async #replace(chatId, placeholderId, text, keyboard) {
-        if (placeholderId !== undefined) {
-            try {
-                await this.#opts.api.editMessageText(chatId, placeholderId, text, keyboard ? { replyMarkup: keyboard } : {});
-                return;
-            }
-            catch (err) {
-                this.#log(`telegram: final edit failed, sending instead: ${message(err)}`);
-            }
-        }
-        await this.#opts.api.sendMessage(chatId, text, keyboard ? { replyMarkup: keyboard } : {});
-    }
     /**
      * One turn's reply, with whatever it offered already drawn into the shape
      * this surface sends: the text, and the controls if there are any.
@@ -2232,6 +2043,7 @@ export class TelegramSurface {
         return {
             ...renderOffers(TELEGRAM_SURFACE, replyText(produced), typeof produced === 'string' ? [] : (produced.offers ?? [])),
             ...(typeof produced !== 'string' && produced.question ? { question: produced.question } : {}),
+            ...extrasOf(produced),
         };
     }
     #startTyping(chatId) {