@withbuddi/buddi 0.1.0-pre.45 → 0.1.0-pre.47

package/node_modules/@buddi/runtime/dist/language.js

@@ -0,0 +1,191 @@
+/**
+ * The reply-language guard's eye: which language is a piece of text written in?
+ *
+ * Agent Father answered an English question in Spanish; the concierge answered
+ * in French after reading French news. The prompt already says to answer in
+ * the owner's language (the reply-language line in every agent's platform
+ * context); this is the deterministic check behind it, run by the loop on the
+ * final text of a turn. No model: a small stopword count for six languages.
+ *
+ * Biased hard toward precision, because a false positive costs the owner a
+ * second model call and a rewrite of an answer that was fine:
+ *
+ *  - code, links, email addresses, blockquotes and quoted passages are not the
+ *    answer's own words, so they are not counted;
+ *  - a word several languages share ("de", "la", "que") counts for each of
+ *    them by a fraction, so only the words that tell languages apart decide;
+ *  - a language is named only with enough evidence (`minHits`), twice the
+ *    evidence of the runner-up, and a tenth of the words at least;
+ *  - anything else is "cannot tell", and "cannot tell" never fires the guard.
+ */
+import { languageTag } from '@buddi/core';
+/** The name the model is asked to answer in. */
+export const LANGUAGE_NAMES = {
+    en: 'English', fr: 'French', es: 'Spanish', de: 'German', pt: 'Portuguese', it: 'Italian',
+};
+/** What the model is told when its answer is in the wrong language. */
+export function languageRetryText(language) {
+    return `Answer in ${language}.`;
+}
+/** The guard never looks at a reply shorter than this. */
+export const MIN_REPLY_WORDS = 12;
+const STOPWORDS = {
+    en: 'the and of to in is are was were be been being have has had it its this that these those with for on at by from you your yours i we our they their them he she his her not but or if what which who whom when where why how can will would should could do does did done there here an as about just than then my me so all any into because very also only some more most other such no yes please thanks thank hello hi let get got make made want need know think see one two today tomorrow yesterday out up down over again still much many each every',
+    fr: 'le la les des du un une est et en que qui dans pour pas sur au aux avec ce cet cette ces je tu il elle nous vous ils elles mais ou où sont été être avoir ont fait faire plus ne se sa son ses leur leurs mon ma mes ton ta tes votre vos notre nos très aussi comme tout tous toute toutes bien à c est j suis peux peut quel quelle quels quelles merci bonjour oui non salut voici voilà cela ça déjà encore aujourd hui demain hier chez donc alors sans sous entre après avant',
+    es: 'el la los las un una unos unas es y en que de del al por para con no se lo le les su sus está están estoy son ser fue pero como más muy este esta estos estas ese esa eso esto yo tú él ella nosotros ustedes usted hay también porque cuando donde dónde qué cómo cuál todo todos toda puede puedo tiene tengo hola gracias sí ya hoy mañana ayer sobre entre sin desde hasta muchas mucho',
+    de: 'der die das und in im ist nicht ein eine einen einem einer dem den des zu mit von auf für sich ich du er sie wir ihr es sind war wird werden haben hat habe auch als aber oder wenn noch nur schon wie bei aus nach kann können über dass diese dieser dieses mein meine dein ihre unser sehr hier bitte danke ja nein hallo heute morgen gestern gibt kein keine was wer wo warum mir mich dir dich uns euch',
+    pt: 'o a os as um uma uns umas é e em que de do da dos das no na nos nas por para com não se seu sua seus suas está estão estou são ser foi mas como mais muito muita este esta isso isto eu você vocês ele ela nós eles elas também quando onde porque tem tenho pode posso ao à olá obrigado obrigada sim já hoje amanhã ontem sobre entre sem até pelo pela',
+    it: 'il lo la i gli le un una uno è e a in che di del della dello dei degli delle nel nella per con non si suo sua suoi sono essere stato stata ma come più molto molta questo questa quello quella io tu lui lei noi voi loro anche quando dove perché ha hanno ho può posso al alla ci sei ciao grazie sì oggi domani ieri sono tra fra senza fino cosa qui',
+};
+/** Each word, with the languages it belongs to and the share each one gets. */
+const WEIGHTS = (() => {
+    const owners = new Map();
+    for (const [code, words] of Object.entries(STOPWORDS)) {
+        for (const word of new Set(words.split(/\s+/)))
+            owners.set(word, [...(owners.get(word) ?? []), code]);
+    }
+    return new Map([...owners].map(([word, codes]) => [word, codes.map((c) => [c, 1 / codes.length])]));
+})();
+/** Letters only one of the six languages uses. */
+const MARKS = [[/[ñ¿¡]/, 'es'], [/[ãõ]/, 'pt'], [/[ßäö]/, 'de'], [/[œ]/, 'fr']];
+const FENCE = /```[\s\S]*?(?:```|$)/g;
+const INLINE = /`[^`\n]*`/g;
+/** How much of a text is code, 0..1. */
+export function codeShare(text) {
+    const total = text.replace(/\s+/g, '').length;
+    if (total === 0)
+        return 0;
+    let code = 0;
+    for (const m of text.matchAll(FENCE))
+        code += m[0].replace(/\s+/g, '').length;
+    for (const m of text.replace(FENCE, ' ').matchAll(INLINE))
+        code += m[0].replace(/\s+/g, '').length;
+    return code / total;
+}
+/** The text's own words: no code, links, addresses, blockquotes or quoted passages. */
+export function ownWords(text) {
+    const prose = text
+        .replace(FENCE, ' ')
+        .replace(INLINE, ' ')
+        .replace(/^\s*>.*$/gm, ' ')
+        .replace(/\]\([^)]*\)/g, ' ')
+        .replace(/https?:\/\/\S+/gi, ' ')
+        .replace(/\S+@\S+\.\S+/g, ' ')
+        // A complete quotation goes whatever its length or line breaks: a long
+        // French passage quoted in an English answer is not the answer's French.
+        .replace(/"[^"]+"|“[^”]+”|«[^»]+»|„[^“”]+[“”]/g, ' ');
+    return prose.toLowerCase().match(/\p{L}+/gu) ?? [];
+}
+/** The language a text is in, with the evidence; `language` is null when it cannot tell. */
+export function scoreLanguage(text, opts = {}) {
+    const minHits = opts.minHits ?? 3;
+    const words = ownWords(text);
+    const scores = { en: 0, fr: 0, es: 0, de: 0, pt: 0, it: 0 };
+    for (const word of words) {
+        for (const [code, share] of WEIGHTS.get(word) ?? [])
+            scores[code] += share;
+        for (const [mark, code] of MARKS)
+            if (mark.test(word))
+                scores[code] += 0.5;
+    }
+    const ranked = Object.entries(scores).sort((a, b) => b[1] - a[1]);
+    const [best, second] = [ranked[0], ranked[1]];
+    const confident = best[1] >= minHits && best[1] >= 2 * second[1] && best[1] >= 0.1 * words.length;
+    return { language: confident ? best[0] : null, words: words.length, scores };
+}
+/** `scoreLanguage`, the verdict only. */
+export function detectLanguage(text, opts = {}) {
+    return scoreLanguage(text, opts).language;
+}
+const LANG = 'english|anglais|inglés|ingles|englisch|inglese|french|français|francais|francés|frances|französisch|francese|' +
+    'spanish|español|espanol|espagnol|spanisch|spagnolo|espanhol|german|deutsch|allemand|alemán|aleman|tedesco|alemão|alemao|' +
+    'italian|italiano|italien|italienisch|portuguese|português|portugues|portugais|portugiesisch|portoghese';
+/** Feminine and inflected adjectives that follow their noun ("une version française"). */
+const LANG_ADJ = `${LANG}|anglaise|française|francaise|espagnole|allemande|italienne|portugaise|inglesa|francesa|española|espanola|alemana|italiana|portuguesa|englische|französische|spanische|deutsche|italienische|portugiesische|englischen|französischen|spanischen|deutschen`;
+/** Words that can follow "in French" in an instruction without making it a noun phrase. */
+const AFTER = 'please|pls|now|instead|too|also|only|again|anymore|from|for|to|of|and|then|thanks|thank|' +
+    's|svp|merci|maintenant|désormais|dorénavant|aussi|seulement|pour|de|du|à|stp|' +
+    'bitte|jetzt|ab|danke|nur|auch|por|favor|ahora|gracias|solo|también|per|favore|ora|adesso|grazie|agora|obrigado|obrigada';
+/** Verbs of answering, writing or saying, in the six languages. */
+const VERB = 'answer|reply|respond|write|rewrite|say|speak|talk|tell|explain|summari[sz]e|give|send|draft|' +
+    'réponds|répondez|répondre|écris|écrivez|parle|parlez|dis|dites|explique|expliquez|résume|résumez|' +
+    'antworte|antworten|schreib|schreibe|sprich|erkläre|erklär|' +
+    'responde|responda|escribe|escriba|habla|hable|dime|explica|resume|' +
+    'rispondi|scrivi|parla|parli|dimmi|spiega|riassumi|' +
+    'escreva|escreve|fala|fale|diga|explique|resuma';
+/** Object pronouns that may sit between the verb and "in French" ("tell me in Spanish"). */
+const PRONOUN = 'me|us|him|her|them|it|this|that|back|moi|nous|lui|leur|le|la|les|ça|mir|uns|ihm|ihr|es|das|nos|lo|mi|ci|gli|lhe';
+const NOUN = 'summary|version|translation|reply|answer|response|text|copy|draft|edition|' +
+    'résumé|resume|traduction|réponse|texte|' +
+    'zusammenfassung|fassung|übersetzung|antwort|' +
+    'resumen|versión|traducción|respuesta|riassunto|versione|traduzione|risposta|resumo|versão|tradução|resposta';
+const INSTRUCTIONS = [
+    // "translate to German", "traduis", "übersetzen", "the Spanish translation".
+    /(?<!\p{L})(?:translat\p{L}*|tradu\p{L}*|übersetz\p{L}*|uebersetz\p{L}*)/iu,
+    // "answer in French", "write the mail in Spanish to Ana", "en français
+    // s'il te plaît": the language at the end of a clause, or followed by
+    // "please", "from now on", "to"; never by a noun ("in French politics").
+    new RegExp(`(?<!\\p{L})(?:in|into|en|auf|em|al|para)\\s+(?:${LANG})(?:\\s*(?:[.,!?;:)\\]]|$)|\\s+(?:${AFTER})(?!\\p{L}))`, 'imu'),
+    // "tell me in Spanish what is on", "réponds-moi en anglais": a verb of
+    // answering, at most two pronouns, then the language.
+    new RegExp(`(?<!\\p{L})(?:${VERB})(?:[\\s-]+(?:${PRONOUN})){0,2}\\s+(?:in|into|en|auf|em|al|para)\\s+(?:${LANG})(?!\\p{L})`, 'iu'),
+    // "a Spanish summary", "the French version".
+    new RegExp(`(?<!\\p{L})(?:${LANG})\\s+(?:${NOUN})(?!\\p{L})`, 'iu'),
+    // "une version française", "una respuesta española".
+    new RegExp(`(?<!\\p{L})(?:${NOUN})\\s+(?:${LANG_ADJ})(?!\\p{L})`, 'iu'),
+];
+/**
+ * Does the owner's message tell buddi which language to answer in ("answer in
+ * French", "give me a Spanish summary", "en français s'il te plaît") or ask
+ * for a translation? Then the answer's language is the owner's call, not the
+ * guard's. A language named as a subject ("what happened in French politics
+ * today?", "the French news") is no instruction.
+ */
+export function namesALanguage(message) {
+    return INSTRUCTIONS.some((re) => re.test(message));
+}
+/** The six-language code the profile's "Answer me in" names, if it names one of them. */
+export function profileLanguageCode(profile) {
+    const base = languageTag(profile)?.split('-')[0];
+    return base && base in LANGUAGE_NAMES ? base : null;
+}
+/** Below this many own words, a message too short to tell leans on the profile language. */
+export const SHORT_MESSAGE_WORDS = 8;
+/**
+ * The language the owner's message is in, read from its opening: the
+ * instruction comes first ("Résume cet article :" over a pasted English
+ * article). Text before the first blank line when the message has more than
+ * one paragraph, else its first forty own words.
+ */
+export function messageLanguage(message) {
+    const head = message.split(/\n\s*\n/)[0] ?? '';
+    return detectLanguage(ownWords(head).slice(0, 40).join(' '), { minHits: 2 });
+}
+/**
+ * Is this reply in the wrong language? Only when its language is confidently
+ * one of the six and differs from the anchor: the owner's message when it
+ * can be told, else the profile language, and the profile only for a short
+ * message (a long one that cannot be told is likely in a seventh language).
+ * Never for a short reply, a code-dominant one, a message that tells buddi
+ * which language to answer in or asks for a translation, or when nothing
+ * anchors the answer. A message, or an earlier one, that names an answer
+ * language hands the choice to the owner.
+ */
+export function offLanguage(reply, message, profile, 
+/** The owner's earlier words in the conversation: "answer in French from now on" still holds. */
+earlier = '') {
+    if (codeShare(reply) >= 0.4)
+        return null;
+    const scored = scoreLanguage(reply);
+    if (scored.words < MIN_REPLY_WORDS || !scored.language)
+        return null;
+    if ((message && namesALanguage(message)) || namesALanguage(earlier))
+        return null;
+    const asked = message ? messageLanguage(message) : null;
+    const short = !message || ownWords(message).length < SHORT_MESSAGE_WORDS;
+    const anchor = asked ?? (short ? profileLanguageCode(profile) : null);
+    if (!anchor || scored.language === anchor)
+        return null;
+    return { reply: scored.language, target: LANGUAGE_NAMES[anchor] };
+}
+//# sourceMappingURL=language.js.map

package/node_modules/@buddi/runtime/dist/language.js.map

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

package/node_modules/@buddi/runtime/dist/loop.d.ts

@@ -31,6 +31,13 @@ export interface RunAgentOptions {
     conversationId: string;
     /** The owner's turn. Omitted only when `resume` carries the turn instead. */
     userMessage?: string;
+    /**
+     * The owner's own words in `userMessage`, when buddi composed more around
+     * them (a mission's prompt under its context material and buddi's English
+     * instructions). The reply-language guard reads these, not buddi's text.
+     * Defaults to `userMessage`.
+     */
+    ownerText?: string;
     /**
      * An extra system line appended to the agent's prompt for this run only.
      *
@@ -79,7 +86,8 @@ export interface RunAgentOptions {
     /**
      * The words streamed through `onDelta` for the turn just written are
      * withdrawn: the grounding guard held that answer back (it cited sources
-     * nothing in the run had read) and the model is answering again. A surface
+     * nothing in the run had read), or the reply-language guard did (it was in
+     * the wrong language), and the model is answering again. A surface
      * drawing the live text clears it; nothing of it was stored. Never awaited.
      */
     onRetract?: () => void;
@@ -220,6 +228,12 @@ export interface Interjection {
     /** Whoever queued it knows it by this. The loop only hands it back. */
     id?: string;
     text: string;
+    /**
+     * Files the owner sent with it. Hydrated when the loop takes the line — the
+     * bytes go to the model in the same tool-results turn as the words — and
+     * stored as references, the way an opening turn's files are.
+     */
+    attachments?: readonly AttachmentRef[];
 }
 /**
  * Where a run hears about what the owner said while it worked.

package/node_modules/@buddi/runtime/dist/loop.d.ts.map

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

package/node_modules/@buddi/runtime/dist/loop.js

@@ -14,8 +14,9 @@ import { primeSecretScrubber, scrubDeep, scrubText } from '@buddi/core';
 import { ProviderError, isThinkingBlock } from './anthropic.js';
 import { NATIVE_SEARCH_SYSTEM_NOTE, planNativeSearch } from './search.js';
 import { GROUNDING_RETRY_TEXT, citationSignals, citesUnread } from './grounding.js';
+import { languageRetryText, offLanguage } from './language.js';
 import { compactObservations } from './projection.js';
-import { degradeMessages, DEFAULT_CAPABILITIES, } from './capabilities.js';
+import { degradeContent, degradeMessages, DEFAULT_CAPABILITIES, } from './capabilities.js';
 import { assertAttachmentCount, hydrateContent, hydrateMessages, toArtifactRefBlocks, } from './attachments.js';
 /**
  * The in-memory queue a surface with no durable store of its own hands to a
@@ -575,8 +576,10 @@ async function runAgentOnce(opts) {
     const history = compactObservations(opts.transcript ? await opts.transcript.load() : await loadMessages(pool, conversationId));
     // Stored history carries artifact_ref blocks; the provider needs the bytes.
     const replayed = await hydrateMessages(history, opts.loadArtifact);
+    // Files sent with no words: the turn is the files alone. Providers refuse an
+    // empty text block, and each file already carries its own note to the model.
     const userBlocks = [
-        { type: 'text', text: openingText },
+        ...(openingText.trim() === '' && attachments.length > 0 ? [] : [{ type: 'text', text: openingText }]),
         ...toArtifactRefBlocks(attachments),
     ];
     const sentUserBlocks = await hydrateContent(userBlocks, opts.loadArtifact, {
@@ -685,9 +688,20 @@ async function runAgentOnce(opts) {
      */
     let read = false;
     let regrounded = false;
-    /** The answer the guard held back, delivered (flagged) if the retry says nothing. */
+    /**
+     * The latest answer a guard held back (grounding or language), delivered if
+     * the retry says nothing. One slot for both, so a fallback never brings
+     * back an answer an earlier guard had already replaced.
+     */
     let heldBack;
     let unchecked = false;
+    /**
+     * The reply-language guard (docs/system-context.md, Reply language).
+     * `relanguaged`: an answer in the wrong language was held back once and the
+     * model asked to answer in the owner's; whatever comes next is delivered.
+     * One retry per turn across both guards: neither fires after the other.
+     */
+    let relanguaged = false;
     /**
      * What the owner added, leased for the step that has not happened yet.
      *
@@ -816,14 +830,16 @@ async function runAgentOnce(opts) {
             const finalAnswer = toolUses.length === 0 && res.stopReason !== 'pause_turn' && res.stopReason !== 'max_tokens';
             if (finalAnswer && !read && resume === undefined && !waitingForOwner && (turnText !== '' || regrounded)) {
                 if (regrounded) {
-                    unchecked = true;
                     // A retry that said nothing: the held-back answer goes out, flagged,
                     // rather than an empty reply.
                     if (turnText === '' && heldBack) {
                         delivered = heldBack.content;
                         turnText = heldBack.text;
                     }
-                    await appendEvent(pool, 'run.grounding', { stage: 'unchecked', agentId: agent.id, ...(opts.runId ? { runId: opts.runId } : {}) }, conversationId);
+                    if (!unchecked) {
+                        unchecked = true;
+                        await appendEvent(pool, 'run.grounding', { stage: 'unchecked', agentId: agent.id, ...(opts.runId ? { runId: opts.runId } : {}) }, conversationId);
+                    }
                 }
                 else {
                     // What the agent legitimately carries counts as held too: its own
@@ -831,7 +847,9 @@ async function runAgentOnce(opts) {
                     const known = [knownText(messages.slice(0, -1)), agent.systemPrompt, memory, platformContext?.prompt ?? ''].join('\n');
                     if (citesUnread(turnText, known)) {
                         regrounded = true;
-                        const budgetLeft = turns - exemptTurns < agent.maxTurns && turns < agent.maxTurns + MAX_EXEMPT_TURNS;
+                        // One retry per turn: a language rewrite that cites unread sources
+                        // is delivered flagged, not sent back a second time.
+                        const budgetLeft = !relanguaged && turns - exemptTurns < agent.maxTurns && turns < agent.maxTurns + MAX_EXEMPT_TURNS;
                         await appendEvent(pool, 'run.grounding', {
                             stage: budgetLeft ? 'retried' : 'unchecked',
                             agentId: agent.id,
@@ -851,6 +869,49 @@ async function runAgentOnce(opts) {
                     }
                 }
             }
+            /*
+             * The reply-language guard. A final answer whose language is clearly one
+             * of six, and matches neither the owner's message (when that can be
+             * told) nor their profile language, is held back the way the grounding
+             * guard holds one back: not stored, not said, its streamed words
+             * withdrawn. The model is told "Answer in <language>." once, in a turn
+             * the transcript does not keep, and whatever it answers is delivered.
+             * Only the run the owner reads: a delegate's answer is quoted into its
+             * caller's, and a decided approval coming back carries no owner message.
+             * `offLanguage` is precision-first; see language.ts.
+             */
+            if (finalAnswer && resume === undefined && (ctx.delegationDepth ?? 0) === 0 && !regrounded) {
+                if (relanguaged) {
+                    // A rewrite that said nothing: the held-back answer goes out.
+                    if (turnText === '' && heldBack) {
+                        delivered = heldBack.content;
+                        turnText = heldBack.text;
+                    }
+                }
+                else if (turnText !== '') {
+                    const off = offLanguage(turnText, opts.ownerText ?? userMessage, platformContext?.language, ownerWords(messages.slice(0, -1)));
+                    if (off) {
+                        relanguaged = true;
+                        const budgetLeft = turns - exemptTurns < agent.maxTurns && turns < agent.maxTurns + MAX_EXEMPT_TURNS;
+                        await appendEvent(pool, 'run.language', {
+                            stage: budgetLeft ? 'retried' : 'kept',
+                            agentId: agent.id,
+                            reply: off.reply,
+                            target: off.target,
+                            ...(opts.runId ? { runId: opts.runId } : {}),
+                        }, conversationId);
+                        if (budgetLeft) {
+                            heldBack = { content: delivered, text: turnText };
+                            try {
+                                opts.onRetract?.();
+                            }
+                            catch { /* a surface's drawing never decides a run */ }
+                            messages.push({ role: 'user', content: [{ type: 'text', text: languageRetryText(off.target) }] });
+                            continue;
+                        }
+                    }
+                }
+            }
             await persistMessage(pool, conversationId, 'assistant', persistable(delivered), opts.transcript?.speaker);
             if (turnText) {
                 spoken.push({ text: turnText, beforeToolCall: toolUses.length > 0 });
@@ -1041,17 +1102,30 @@ async function runAgentOnce(opts) {
             if (toolUses.length > 0 && toolUses.every((call) => registry.hasOwnBudget(call.name)))
                 exemptTurns++;
             const lastTurn = turns - exemptTurns >= agent.maxTurns || turns >= agent.maxTurns + MAX_EXEMPT_TURNS || pendingActionId !== undefined || ctx.signal?.aborted === true;
-            const leased = lastTurn ? [] : ((await opts.interjections?.lease()) ?? []).filter((item) => item.text.trim() !== '');
+            const leased = lastTurn ? [] : ((await opts.interjections?.lease()) ?? [])
+                .filter((item) => item.text.trim() !== '' || (item.attachments?.length ?? 0) > 0);
             // What the model is shown, and what the transcript keeps: the framing is
             // for the model — the record holds the owner's own words.
-            const spokenBlocks = leased.length === 0
-                ? []
-                : [{ type: 'text', text: interjectionText(leased.map((item) => item.text)) }];
-            const storedBlocks = leased.length === 0
-                ? []
-                : [{ type: 'text', text: leased.map((item) => item.text.trim()).join('\n\n') }];
+            const said = leased.map((item) => item.text).filter((text) => text.trim() !== '');
+            // Files that came with them: references in the record, the bytes (or the
+            // note, for what a model cannot look at) in what is sent. Never capped
+            // into a failure here — each file was accepted when it was uploaded, and
+            // a run must not die between two tool calls over one; an oversize one
+            // goes as a placeholder, the way a replayed one does.
+            const leasedRefs = toArtifactRefBlocks(leased.flatMap((item) => item.attachments ?? []));
+            const sentRefs = leasedRefs.length === 0 ? [] : degradeContent(await hydrateContent(leasedRefs, opts.loadArtifact), capabilities);
+            const spokenBlocks = [
+                ...(said.length === 0 ? [] : [{ type: 'text', text: interjectionText(said) }]),
+                ...sentRefs,
+            ];
+            const storedBlocks = [
+                ...(said.length === 0 ? [] : [{ type: 'text', text: said.map((text) => text.trim()).join('\n\n') }]),
+                ...leasedRefs,
+            ];
+            const uploaded = leased.flatMap((item) => item.attachments ?? [])
+                .map((a) => ({ artifactId: a.artifactId, kind: 'uploaded', agentId: null }));
             messages.push({ role: 'user', content: [...results, ...spokenBlocks] });
-            const turnMessageId = await persistMessage(pool, conversationId, 'user', [...results, ...storedBlocks], opts.transcript?.speaker, produced);
+            const turnMessageId = await persistMessage(pool, conversationId, 'user', [...results, ...storedBlocks], opts.transcript?.speaker, [...produced, ...uploaded]);
             if (leased.length > 0) {
                 inFlight = leased;
                 inFlightMessageId = turnMessageId;
@@ -1155,6 +1229,21 @@ async function runAgentOnce(opts) {
         ...(unchecked ? { unchecked: true } : {}),
     };
 }
+/**
+ * The owner's last few messages, for the reply-language guard: an owner who
+ * said "answer in Spanish from now on" a turn ago still meant it.
+ */
+function ownerWords(messages) {
+    const said = [];
+    for (const message of messages) {
+        if (message.role !== 'user')
+            continue;
+        const text = message.content.filter((b) => b.type === 'text').map((b) => b.text).join('\n');
+        if (text.trim() !== '')
+            said.push(text);
+    }
+    return said.slice(-6).join('\n');
+}
 /**
  * Everything the conversation held before an answer, as one string, for the
  * grounding guard: a source the owner named, or a tool returned earlier, is