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

package/packages/gateway/dist/telegram/surface.d.ts

@@ -22,6 +22,7 @@ import { type ArtifactStore, type IncomingAttachment } from './attachments.js';
 import { type BrowserCommandWord } from './browser-view.js';
 import { type AgentCatalog, type CatalogAgent } from './types.js';
 import { type CanvasView } from './outbound.js';
+import { type SpeechHooks } from './voice.js';
 export declare const SURFACE = "telegram";
 /** Proposal cards' callback prefix (`proposals.ts`); here so routing needs no import cycle. */
 export declare const PROPOSAL_CALLBACK_PREFIX = "prp";
@@ -271,6 +272,18 @@ export interface RunRequest {
      * answers the first message, which is what this surface did before.
      */
     interjections?: InterjectionSource;
+    /**
+     * This turn's answer will be read aloud as a voice note: the surface
+     * profile carries the `spoken` fact for this one run, so the agent writes
+     * for the ear.
+     */
+    spoken?: boolean;
+    /**
+     * The language the owner's voice note was in, by name ("French"), when it
+     * was detected: the surface profile names it for this one run, so the
+     * agent answers in it.
+     */
+    spokenLanguage?: string;
 }
 /**
  * What a turn produced.
@@ -345,6 +358,12 @@ export interface TelegramSurfaceOptions {
     artifacts?: ArtifactStore;
     /** Submits one turn and returns the reply text, and what it declared. */
     run(req: RunRequest): Promise<string | RunReply>;
+    /**
+     * The speech plugin's two tools, called by name as the owner. Absent: a
+     * voice note is kept and answered with the sentence that says how to have
+     * it heard, and every answer is text.
+     */
+    speech?: SpeechHooks;
     /** Runs a mission inline for `/recap`. Absent: the command is unavailable. */
     runMission?: RunMission;
     /**
@@ -681,5 +700,11 @@ export declare class TelegramSurface {
      * here, and an installation providing neither is told so plainly.
      */
     handleRecap(chatId: string): Promise<void>;
+    /**
+     * `/voice` alone shows the chat's choice; `/voice spoken|always|off` sets
+     * when, `/voice voice|both|text` what. Written to the chat's row and to the
+     * speech plugin's copy, so Settings → Speech shows the same.
+     */
+    handleVoice(chatId: string, arg: string): Promise<void>;
 }
 //# sourceMappingURL=surface.d.ts.map

package/packages/gateway/dist/telegram/surface.d.ts.map

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

package/packages/gateway/dist/telegram/surface.js

@@ -24,6 +24,7 @@ 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';
+import { answerSpoken, applyVoiceArg, claimTextInsteadNote, getChatVoice, languageName, INSTALL_SPEECH_TEXT, MAX_SPOKEN_CHARS, MAX_VOICE_CAPTION_CHARS, NO_WORDS_TEXT, notHeardText, SET_UP_LISTENING_TEXT, setChatVoice, textInsteadText, VOICE_USAGE_TEXT, voiceSetText, voiceStatusText, voiceTurnText, } from './voice.js';
 export const SURFACE = 'telegram';
 /** Proposal cards' callback prefix (`proposals.ts`); here so routing needs no import cycle. */
 export const PROPOSAL_CALLBACK_PREFIX = 'prp';
@@ -96,6 +97,7 @@ export const HELP = [
     'buddi on Telegram.',
     '',
     'Send a statement, a receipt photo or a CSV and tell me what to do with it.',
+    'Send a voice note and I hear it, and answer with one, when the speech plugin is set up.',
     '',
     'Answers here are kept short, because you read them on a phone. Ask for more and you get more.',
     '',
@@ -113,6 +115,8 @@ export const HELP = [
     '/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',
+    '/voice [spoken|always|off] — answer with a voice when you send one (spoken), every time (always), or never (off)',
+    '/voice [voice|both|text] — send the voice note alone, with the text, or text only',
     '/browser — where the screen stands; /browser stop, /browser resume, /browser release',
     '/host — host execution permissions and running commands',
     '/hoststop — interrupt all host commands',
@@ -705,6 +709,10 @@ export class TelegramSurface {
      * restart drops it back to ordinary routing, never to a wrong agent.
      */
     #pending = new PendingQuestions();
+    /** The chats whose message in hand is a voice note the owner spoke; read by `#runFor`. */
+    #ownerSpoke = new Set();
+    /** The language of the voice note being run now, per chat, by name. */
+    #ownerLanguage = new Map();
     #offset;
     #running = false;
     #abort;
@@ -880,8 +888,11 @@ export class TelegramSurface {
         const incoming = extractAttachment(message);
         if (incoming) {
             // A file arrives with its own intent, caption or not. It is never the
-            // answer to "what time tonight?", so it ends any pending question.
-            this.#pending.clear(chatId);
+            // answer to "what time tonight?", so it ends any pending question. A
+            // voice note can be exactly that answer: it is heard, then routed as
+            // the words it carries.
+            if (incoming.slot !== 'voice' && incoming.slot !== 'audio')
+                this.#pending.clear(chatId);
             const messageId = String(message.message_id);
             this.enqueue(chatId, () => this.handleAttachment(chatId, resolution.ownerId, messageId, incoming));
             return;
@@ -1176,6 +1187,10 @@ export class TelegramSurface {
             await this.#opts.api.sendMessage(chatId, whereText(this.#opts.publicOrigin));
             return;
         }
+        if (command === '/voice') {
+            await this.handleVoice(chatId, text.slice(command.length));
+            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') {
@@ -1382,6 +1397,10 @@ export class TelegramSurface {
         // Whether this turn ended by asking the owner something. Read out of the
         // run, not out of what the owner is shown: the note is prepended after.
         let askedOwner = false;
+        // Read aloud? When the owner spoke and the chat says `spoken`, or always.
+        // Only with a speaker to read it; otherwise the agent is not told so.
+        const spoken = await this.#willSpeak(chatId);
+        const spokenLanguage = this.#ownerLanguage.get(chatId);
         // Where a message typed while this run works arrives. It is registered
         // before the first model call and closed after the last, so the window in
         // which the owner can get a word in is exactly the window in which the
@@ -1397,8 +1416,12 @@ export class TelegramSurface {
                     text: prompt,
                     interjections,
                     ...(carried?.attachments.length ? { attachments: carried.attachments } : {}),
+                    ...(spoken ? { spoken: true } : {}),
+                    ...(spokenLanguage ? { spokenLanguage } : {}),
                     onToolCall: (name) => progress.noteToolCall(name),
-                    onTextDelta: (delta) => stream.push(delta),
+                    // A spoken answer is not streamed: it arrives as a voice note with
+                    // its text underneath, and the progress line holds until then.
+                    ...(spoken ? {} : { onTextDelta: (delta) => stream.push(delta) }),
                 });
                 const reply = replyText(produced);
                 askedOwner = turnAskedOwner(typeof produced === 'string' ? undefined : produced.askedOwner, reply);
@@ -1416,7 +1439,7 @@ export class TelegramSurface {
                     ...(typeof produced !== 'string' && produced.question ? { question: produced.question } : {}),
                     ...extrasOf(produced),
                 };
-            }, label, carried ? readingText(label) : undefined, { agentId: agent.id, conversationId, prompt });
+            }, label, carried ? readingText(label) : undefined, { agentId: agent.id, conversationId, prompt }, spoken);
         }
         finally {
             /*
@@ -1552,10 +1575,11 @@ export class TelegramSurface {
             mime: row.mime,
             sizeBytes: row.sizeBytes,
         });
-        // Voice notes are kept, not heard: no run is started over bytes no model
-        // in this build can read, with or without a caption.
+        // A voice note is heard by the speech plugin and run as the owner's
+        // words. Without the plugin, or with listening not set
+        // up, it is kept and the reply says where to fix that.
         if (row.kind === 'audio') {
-            await api.sendMessage(chatId, gotAudioText(filename, row.sizeBytes));
+            await this.#heard(chatId, row, filename, incoming.caption);
             return;
         }
         const caption = incoming.caption;
@@ -1955,7 +1979,9 @@ export class TelegramSurface {
      * single message behind it — a `/recap` is the mission's, not the owner's,
      * and "try again" there would re-run something they never typed.
      */
-    retry) {
+    retry, 
+    /** Send the answer as a voice note, with its text as the caption. */
+    speak = false) {
         const stopTyping = this.#startTyping(chatId);
         const placeholder = placeholderOverride ?? placeholderText(agentName);
         // An explicit bubble, posted before the provider is called: the owner sees
@@ -1988,9 +2014,16 @@ export class TelegramSurface {
             const drawn = typeof produced === 'string' ? { text: produced, controls: [] } : produced;
             const reply = toPlainText(drawn.text);
             await progress.settle();
-            await stream.finish(reply, drawn.question && drawn.question.options.length > 0
+            const keyboard = drawn.question && drawn.question.options.length > 0
                 ? questionKeyboard(drawn.question)
-                : drawn.controls.length === 0 ? undefined : offersKeyboard(drawn.controls));
+                : drawn.controls.length === 0 ? undefined : offersKeyboard(drawn.controls);
+            // Buttons need a text message to sit under: an answer that carries any
+            // stays text, as cards and questions do.
+            const voice = speak && keyboard === undefined ? await this.#speakAnswer(chatId, placeholderId, reply, progress) : { sent: false };
+            if (!voice.sent)
+                await stream.finish(reply, keyboard);
+            if (voice.note)
+                await this.#opts.api.sendMessage(chatId, voice.note).catch(() => { });
             // Then what else the turn made: the view it drew, the files it saved.
             if (drawn.artifacts || drawn.canvas) {
                 await sendRunExtras({
@@ -2032,6 +2065,175 @@ export class TelegramSurface {
             stopTyping();
         }
     }
+    /* ---------------------------------------------------------------- *
+     * Voice
+     * ---------------------------------------------------------------- */
+    /**
+     * `/voice` alone shows the chat's choice; `/voice spoken|always|off` sets
+     * when, `/voice voice|both|text` what. Written to the chat's row and to the
+     * speech plugin's copy, so Settings → Speech shows the same.
+     */
+    async handleVoice(chatId, arg) {
+        const api = this.#opts.api;
+        const current = await this.#chatVoice(chatId);
+        if (arg.trim() === '') {
+            await api.sendMessage(chatId, voiceStatusText(current));
+            return;
+        }
+        const next = applyVoiceArg(current, arg);
+        if (!next) {
+            await api.sendMessage(chatId, VOICE_USAGE_TEXT);
+            return;
+        }
+        await setChatVoice(this.#opts.pool, SURFACE, chatId, next);
+        await this.#opts.speech?.saveVoicePrefs?.(next).catch(() => false);
+        await api.sendMessage(chatId, voiceSetText(next));
+    }
+    /** The chat's two choices: the speech plugin's copy where it has one, else the chat's row. */
+    async #chatVoice(chatId) {
+        const row = await getChatVoice(this.#opts.pool, SURFACE, chatId);
+        const prefs = (await this.#opts.speech?.voicePrefs?.().catch(() => ({}))) ?? {};
+        return { when: prefs.when ?? row.when, form: prefs.form ?? row.form };
+    }
+    /** Will this chat's next answer be read aloud? */
+    async #willSpeak(chatId) {
+        const speech = this.#opts.speech;
+        if (!speech || !this.#opts.artifacts || !speech.canSpeak())
+            return false;
+        try {
+            return answerSpoken((await this.#chatVoice(chatId)).when, this.#ownerSpoke.has(chatId));
+        }
+        catch (err) {
+            this.#log(`telegram: chat ${chatId} — the voice setting could not be read: ${message(err)}`);
+            return false;
+        }
+    }
+    /**
+     * A voice note, saved: transcribe it and run it as the owner's words (a
+     * caption follows the transcript). Nothing is echoed back: the transcript is
+     * the owner's message in the conversation, where the dashboard shows it.
+     * Refused or failed: one sentence, and the file stays saved.
+     */
+    async #heard(chatId, row, filename, caption) {
+        const api = this.#opts.api;
+        const speech = this.#opts.speech;
+        if (!speech) {
+            await api.sendMessage(chatId, `${gotAudioText(filename, row.sizeBytes)} ${INSTALL_SPEECH_TEXT}`);
+            return;
+        }
+        const stopTyping = this.#startTyping(chatId);
+        let heard;
+        try {
+            heard = await speech.transcribe(row.id);
+        }
+        catch (err) {
+            heard = { ok: false, reason: 'failed', message: message(err) };
+        }
+        finally {
+            stopTyping();
+        }
+        if (!heard.ok) {
+            if (heard.reason === 'failed')
+                this.#log(`telegram: chat ${chatId} — transcription failed: ${heard.message}`);
+            const text = heard.reason === 'missing'
+                ? `${gotAudioText(filename, row.sizeBytes)} ${INSTALL_SPEECH_TEXT}`
+                : heard.reason === 'unconfigured'
+                    ? `${gotAudioText(filename, row.sizeBytes)} ${SET_UP_LISTENING_TEXT}`
+                    : notHeardText(heard.message);
+            await api.sendMessage(chatId, text);
+            return;
+        }
+        if (heard.text === '') {
+            await api.sendMessage(chatId, NO_WORDS_TEXT);
+            return;
+        }
+        this.#ownerSpoke.add(chatId);
+        const language = languageName(heard.language);
+        if (language)
+            this.#ownerLanguage.set(chatId, language);
+        try {
+            await this.handleText(chatId, '', voiceTurnText(heard.text, caption));
+        }
+        finally {
+            this.#ownerSpoke.delete(chatId);
+            this.#ownerLanguage.delete(chatId);
+        }
+    }
+    /**
+     * The answer as a voice note, in place of the placeholder: alone (`/voice
+     * voice`), or with its text as the caption, or right after it past
+     * Telegram's 1,024 characters (`/voice both`). Not
+     * sent: the caller lands the text as usual, and `note` is the once-a-day
+     * line saying why, when there is one to say.
+     */
+    async #speakAnswer(chatId, placeholderId, reply, progress) {
+        const api = this.#opts.api;
+        const speech = this.#opts.speech;
+        const store = this.#opts.artifacts;
+        // A long answer is not read aloud, and nothing is said about it.
+        if (!speech || !store || reply.trim() === '' || reply.length > MAX_SPOKEN_CHARS)
+            return { sent: false };
+        const fallback = async (reason, detail) => {
+            this.#log(`telegram: chat ${chatId} — the answer went as text (${reason}): ${detail}`);
+            const note = await this.#textInsteadNote(chatId, reason);
+            return note ? { sent: false, note } : { sent: false };
+        };
+        api.sendChatAction(chatId, 'record_voice').catch(() => { });
+        const form = (await this.#chatVoice(chatId).catch(() => undefined))?.form ?? 'voice';
+        let said;
+        try {
+            said = await speech.say(reply, this.#handleNames());
+        }
+        catch (err) {
+            said = { ok: false, reason: 'failed', message: message(err) };
+        }
+        if (!said.ok)
+            return fallback(said.reason, said.message);
+        const loaded = await store.load(said.artifactId).catch(() => null);
+        if (!loaded)
+            return fallback('failed', `the voice ${said.artifactId} could not be read back`);
+        const withText = form === 'both';
+        const long = reply.length > MAX_VOICE_CAPTION_CHARS;
+        progress.silence();
+        try {
+            await api.sendVoice(chatId, Buffer.from(loaded.data, 'base64'), {
+                contentType: loaded.mime,
+                filename: loaded.mime === 'audio/mpeg' ? 'voice.mp3' : 'voice.ogg',
+                ...(withText && !long ? { caption: reply } : {}),
+            });
+        }
+        catch (err) {
+            return fallback('failed', message(err));
+        }
+        if (withText && long)
+            await api.sendMessage(chatId, reply);
+        if (placeholderId !== undefined)
+            await api.deleteMessage(chatId, placeholderId).catch(() => { });
+        return { sent: true };
+    }
+    /** Every agent's handle and name, so a spoken `@ledger` is read as its name. */
+    #handleNames() {
+        const names = {};
+        try {
+            for (const agent of this.#opts.catalog.list())
+                if (agent.handle && agent.name)
+                    names[agent.handle] = agent.name;
+        }
+        catch {
+            // No names: handles are read as bare words.
+        }
+        return names;
+    }
+    /** Today's "why this came as text" line for this chat, or nothing when it was said today. */
+    async #textInsteadNote(chatId, reason) {
+        try {
+            const claimed = await claimTextInsteadNote(this.#opts.pool, SURFACE, chatId, new Date(this.#now()), this.#opts.timezone ?? DEFAULT_TIMEZONE);
+            return claimed ? textInsteadText(reason) : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
     /**
      * 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.