@withbuddi/buddi 0.1.0-pre.44 → 0.1.0-pre.46

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

@@ -0,0 +1,158 @@
+/**
+ * The grounding guard's eye: does a reply name sources it never read?
+ *
+ * An owner asked the concierge about a headline in today's news; it answered
+ * at length, citing CBS, AP, NPR and a law school, with no tool call at all.
+ * Every citation was invented. The prompt already says not to (the grounding
+ * lines in every agent's platform context); this is the deterministic check
+ * behind it, run by the loop on the final text of a turn that read nothing.
+ *
+ * Biased hard toward precision, because a false positive costs the owner a
+ * second model call and, worse, a "not checked" flag on an honest answer:
+ *
+ *  - an outlet or a domain counts only where it is *cited* — in parentheses,
+ *    after "according to" / "selon" / "d'après" / "per" / "via", before
+ *    "reports" / "said" / "writes", or as a markdown link. "The BBC is a
+ *    broadcaster" is a mention, not a citation, and so is a bare link ("open
+ *    https://github.com"): a bare link only backs up markers or a "Sources:"
+ *    line, it never counts as a source on its own;
+ *  - one citation is not enough on its own: it takes two distinct sources, or
+ *    one (or a bare link) with numbered markers ([1]) or a "Sources:" line;
+ *  - an outlet and its own domain ("Reuters", "reuters.com") are one source;
+ *  - a source the conversation already holds (the owner named it, a tool
+ *    returned it earlier) is not counted;
+ *  - code is ignored, and so is an email address.
+ *
+ * Figures alone are never a signal: "it costs about €20" is how people talk.
+ */
+/** What the model is told when it cited sources without reading anything. */
+export const GROUNDING_RETRY_TEXT = 'You cited sources without reading anything. Verify with your tools or a colleague, or remove the claims.';
+/** The muted line the surfaces draw under a reply the guard could not get checked. */
+export const UNCHECKED_LINE = 'Answered from memory, not checked';
+/**
+ * News outlets and agencies a model reaches for when it invents a citation.
+ * Not a directory: the names that showed up in fabricated answers, and their
+ * neighbours. Matched case-sensitively, so "AP" is the agency and "ap" is not.
+ */
+const OUTLETS = [
+    'Associated Press', 'AP', 'Reuters', 'AFP', 'Agence France-Presse', 'Bloomberg',
+    'BBC', 'CNN', 'CBS', 'NBC', 'ABC News', 'NPR', 'PBS', 'Fox News', 'MSNBC', 'CNBC',
+    'New York Times', 'NYT', 'Washington Post', 'Wall Street Journal', 'WSJ', 'USA Today',
+    'Los Angeles Times', 'The Guardian', 'Financial Times', 'The Economist', 'Politico', 'Axios',
+    'The Atlantic', 'The Hill', 'Al Jazeera', 'Sky News', 'The Telegraph', 'The Times', 'Forbes',
+    'TechCrunch', 'The Verge', 'Le Monde', 'Le Figaro', 'Libération', 'Les Echos', 'France 24',
+    'franceinfo', 'Le Parisien', 'RFI', 'Der Spiegel', 'El País', 'Deutsche Welle', 'Euronews',
+    'Jeune Afrique', 'Nikkei', 'South China Morning Post',
+];
+const TLDS = 'com|org|net|gov|edu|int|news|info|co\\.uk|org\\.uk|ac\\.uk|fr|de|es|it|ch|be|ca|au|uk|eu|tv|us|ng|tg|sn|ci|za|ke|jp|in';
+/** A host name, with or without a scheme. Not preceded by `@` (an email) or a word character. */
+const DOMAIN = new RegExp(`(?<![@\\w.-])(?:https?://)?(?:www\\.)?((?:[a-z0-9-]+\\.)+(?:${TLDS}))(?![\\w-])`, 'gi');
+const URL = /https?:\/\/[^\s)>\]]+/gi;
+const ATTRIBUTION = /\b(?:[Aa]ccording to|[Ss]elon|[Dd]['’]apr[eè]s|[Aa]s reported by|[Rr]eported by|[Cc]ited by)\s+(?:the\s+|l[ae]\s+|les\s+|l['’])?([A-Z][\p{L}&.'’-]*(?:\s+(?:of\s+|de\s+|du\s+|for\s+)?[A-Z][\p{L}&.'’-]*){0,4})/gu;
+/** Right before a citation: "according to", "per", "via", "source:". */
+const BEFORE = /(?:according to|selon|d['’]apr[eè]s|as reported by|reported by|cited by|\bper|\bvia|sources?\s*:)\s+(?:the\s+|l[ae]\s+|les\s+)?$/i;
+/** Right after one: "reports", "said", "writes". */
+const AFTER = /^['’]?s?\s+(?:has\s+|have\s+|had\s+)?(?:reports?|reported|reporting|said|says|wrote|writes|notes?|noted|confirmed|found|revealed|rapporte|indique|affirme|écrit|a rapporté|a indiqué)\b/i;
+const MARKER = /\[(\d{1,2})\](?!\()|[¹²³⁴⁵⁶⁷⁸⁹]/g;
+const SOURCES_LINE = /^\s*(?:[*_#>-]+\s*)?(?:Sources?|R[ée]f[ée]rences?|References)\s*(?:[*_]+)?\s*:/im;
+/** Code is not prose: a fenced block or inline code never cites anything. */
+function stripCode(text) {
+    return text.replace(/```[\s\S]*?```/g, ' ').replace(/`[^`\n]*`/g, ' ');
+}
+const norm = (token) => token.normalize('NFKD').replace(/[̀-ͯ]/g, '').toLowerCase().replace(/^www\./, '').replace(/^the\s+/, '').trim();
+const escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const compact = (name) => norm(name).replace(/[^a-z0-9]/g, '');
+/** Each outlet under the keys its own domain is likely to carry: "reuters", "cbsnews", "theguardian". */
+const OUTLET_KEYS = new Map(OUTLETS.flatMap((outlet) => {
+    const key = compact(outlet);
+    const raw = outlet.normalize('NFKD').replace(/[̀-ͯ]/g, '').toLowerCase().replace(/[^a-z0-9]/g, '');
+    return [...new Set([key, `${key}news`, raw, `${raw}news`])].map((k) => [k, norm(outlet)]);
+}));
+const TLD_SUFFIX = new RegExp(`\\.(?:${TLDS})$`, 'i');
+/** The outlet a host belongs to ("www.reuters.com" → "reuters"), or the host itself. */
+function sourceOfHost(host) {
+    const label = norm(host).replace(TLD_SUFFIX, '').split('.').pop() ?? '';
+    return OUTLET_KEYS.get(label) ?? host;
+}
+/** Is the occurrence at [start, end) in a citation position? */
+function cited(text, start, end) {
+    const before = text.slice(Math.max(0, start - 40), start);
+    if (BEFORE.test(before))
+        return true;
+    if (AFTER.test(text.slice(end, end + 40)))
+        return true;
+    // Inside a short parenthesis: "(CBS News, Oct 3)", "(reuters.com)".
+    const open = text.lastIndexOf('(', start);
+    if (open !== -1 && start - open <= 60 && !text.slice(open, start).includes(')')) {
+        const close = text.indexOf(')', end);
+        if (close !== -1 && close - end <= 60 && !text.slice(end, close).includes('('))
+            return true;
+    }
+    // A markdown link's label: "[CBS News](https://…)".
+    const bracket = text.lastIndexOf('[', start);
+    if (bracket !== -1 && start - bracket <= 80 && !text.slice(bracket, start).includes(']')) {
+        const shut = text.indexOf('](', end);
+        if (shut !== -1 && shut - end <= 80 && !text.slice(end, shut).includes('['))
+            return true;
+    }
+    return false;
+}
+/**
+ * The citation signals in a reply. `known` is everything the conversation
+ * already held before this answer (the owner's words, earlier tool results,
+ * earlier replies): a source found there is not counted.
+ */
+export function citationSignals(reply, known = '') {
+    const text = stripCode(reply);
+    const found = new Set();
+    const bare = new Set();
+    const add = (token, into = found) => {
+        const n = norm(token);
+        if (n.length >= 2)
+            into.add(n);
+    };
+    for (const outlet of OUTLETS) {
+        const re = new RegExp(`(?<![\\p{L}\\p{N}])${escape(outlet)}(?:\\s+News)?(?![\\p{L}\\p{N}])`, 'gu');
+        for (const m of text.matchAll(re)) {
+            if (cited(text, m.index, m.index + m[0].length))
+                add(outlet);
+        }
+    }
+    for (const m of text.matchAll(URL)) {
+        const host = /^https?:\/\/(?:www\.)?([^/:?#]+)/i.exec(m[0])?.[1];
+        if (host)
+            add(sourceOfHost(host), cited(text, m.index, m.index + m[0].length) ? found : bare);
+    }
+    for (const m of text.matchAll(DOMAIN)) {
+        if (cited(text, m.index, m.index + m[0].length))
+            add(sourceOfHost(m[1]));
+    }
+    for (const m of text.matchAll(ATTRIBUTION)) {
+        const name = m[1].replace(/[.,;:'’]+$/, '');
+        // An outlet already counted under its own name is one source, not two.
+        const outlet = OUTLETS.find((o) => name === o || name.startsWith(`${o} `));
+        add(outlet ?? name);
+    }
+    const held = known.normalize('NFKD').replace(/[̀-ͯ]/g, '').toLowerCase();
+    const unheld = (token) => !new RegExp(`(?<![\\p{L}\\p{N}])${escape(token)}(?![\\p{L}\\p{N}])`, 'u').test(held);
+    const sources = [...found].filter(unheld);
+    const links = [...bare].filter((token) => !found.has(token) && unheld(token));
+    const markers = new Set();
+    for (const m of text.matchAll(MARKER))
+        markers.add(m[1] ?? m[0]);
+    return { sources, links, markers: markers.size, sourcesLine: SOURCES_LINE.test(text) };
+}
+/**
+ * Does this reply cite sources the conversation never read? The loop asks
+ * only for the final text of a turn in which nothing was read — no tool call,
+ * no delegation, no native search — so "cites" here means "invented".
+ */
+export function citesUnread(reply, known = '') {
+    const s = citationSignals(reply, known);
+    if (s.sources.length >= 2)
+        return true;
+    if (s.sources.length + s.links.length >= 1 && (s.markers >= 1 || s.sourcesLine))
+        return true;
+    return s.markers >= 2 && s.sourcesLine;
+}
+//# sourceMappingURL=grounding.js.map

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

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

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

@@ -8,6 +8,7 @@ export * from './rate-limit.js';
 export * from './transport.js';
 export * from './attachments.js';
 export * from './loop.js';
+export * from './grounding.js';
 export * from './delegate.js';
 export * from './projection.js';
 export * from './context-window.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAE5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACnJ,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAE5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACnJ,cAAc,qBAAqB,CAAC"}

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

@@ -8,6 +8,7 @@ export * from './rate-limit.js';
 export * from './transport.js';
 export * from './attachments.js';
 export * from './loop.js';
+export * from './grounding.js';
 export * from './delegate.js';
 export * from './projection.js';
 export * from './context-window.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,yEAAyE;AACzE,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAwB,MAAM,sBAAsB,CAAC;AACnJ,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,yEAAyE;AACzE,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAwB,MAAM,sBAAsB,CAAC;AACnJ,cAAc,qBAAqB,CAAC"}

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

@@ -76,6 +76,13 @@ export interface RunAgentOptions {
      * is `onText`.
      */
     onDelta?: (delta: CompletionDelta) => void;
+    /**
+     * 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
+     * drawing the live text clears it; nothing of it was stored. Never awaited.
+     */
+    onRetract?: () => void;
     /**
      * Whether a run that runs out of budget says so in the transcript. Default
      * true — the owner is owed the sentence.
@@ -213,6 +220,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.
@@ -312,6 +325,12 @@ export interface RunResult {
     usage: Usage;
     /** Set only when `stopped === 'awaiting-approval'`. */
     pendingActionId?: string;
+    /**
+     * The grounding guard's verdict: the answer cited sources, nothing in the
+     * run read anything, and asked once to verify it still did not. It was
+     * delivered all the same, and the surfaces draw `UNCHECKED_LINE` under it.
+     */
+    unchecked?: boolean;
     /**
      * What this run actually ran on (docs/architecture.md, "Runtime provider port").
      * Pinned provider, pinned model, credential kind — plus the concrete model

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

@@ -13,8 +13,9 @@ import { APPROVAL_RESUME_SPEAKER, DELEGATE_TOOL_NAME, SYSTEM_TOOLS, collectUntru
 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 { 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
@@ -527,7 +528,13 @@ async function runAgentOnce(opts) {
     const memory = opts.memoryPreamble ? await opts.memoryPreamble(agent.id) : '';
     // The run's own agent and grant go along: a paragraph that is only for an
     // agent holding certain tools (the learning one) is decided by the grant.
-    const platformContext = await ctx.systemContext?.({ agentId: agent.id, tools: tools.map((t) => t.name) });
+    // The owner's words ride along, so the context can name a story of today's
+    // edition the message is about (the gateway's edition origin line).
+    const platformContext = await ctx.systemContext?.({
+        agentId: agent.id,
+        tools: tools.map((t) => t.name),
+        ...(userMessage !== undefined ? { message: userMessage } : {}),
+    });
     const system = composeSystem(agent.systemPrompt, [opts.systemSuffix, platformContext?.prompt].filter(Boolean).join('\n\n'), memory, opts.surface, search.enabled ? NATIVE_SEARCH_SYSTEM_NOTE : undefined);
     // Provenance for every tool call this run makes. The caller's context is not
     // mutated: it is shared across runs, and a run's identity is its own.
@@ -568,8 +575,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, {
@@ -668,6 +677,19 @@ async function runAgentOnce(opts) {
     let waitingForOwner = false;
     /** Turns spent only on own-budget tools: not counted against maxTurns. */
     let exemptTurns = 0;
+    /**
+     * The grounding guard (docs/system-context.md, Grounding). `read` turns true
+     * at the first tool call or delegation that came back successfully, or the
+     * first native search of the run. A call that was unknown, refused,
+     * truncated, failed or still waits on the owner read nothing; until
+     * something did, an answer that cites sources cited them from memory. `regrounded`:
+     * that answer was held back once and the model asked to verify.
+     */
+    let read = false;
+    let regrounded = false;
+    /** The answer the guard held back, delivered (flagged) if the retry says nothing. */
+    let heldBack;
+    let unchecked = false;
     /**
      * What the owner added, leased for the step that has not happened yet.
      *
@@ -759,7 +781,6 @@ async function runAgentOnce(opts) {
             // What is *sent back* keeps the provider's own blocks — a paused turn is
             // only continuable with them. What is *stored* does not: see `persistable`.
             messages.push({ role: 'assistant', content: assistantContent });
-            await persistMessage(pool, conversationId, 'assistant', persistable(assistantContent), opts.transcript?.speaker);
             // The audit line for a search nobody dispatched. Written before the run can
             // end, and before the next request, so the order in the log is the order it
             // happened in.
@@ -780,7 +801,59 @@ async function runAgentOnce(opts) {
                 }
             }
             const toolUses = assistantContent.filter((b) => b.type === 'tool_use');
-            const turnText = textOf(assistantContent);
+            let turnText = textOf(assistantContent);
+            let delivered = assistantContent;
+            if ((res.searches?.length ?? 0) > 0)
+                read = true;
+            /*
+             * The grounding guard. A final answer, in a run that read nothing — no
+             * tool, no colleague, no search, not a decided approval coming back — that
+             * names sources the conversation never held was written from memory. It is
+             * not delivered: not stored, not said, its streamed words withdrawn. The
+             * model is told so once, in a turn the transcript does not keep, and
+             * answers again. A second answer that still reads nothing is delivered
+             * with the run marked `unchecked`, which the surfaces draw as a quiet
+             * line under it. `citesUnread` is precision-first; see grounding.ts.
+             */
+            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);
+                }
+                else {
+                    // What the agent legitimately carries counts as held too: its own
+                    // prompt, its memory notes, the platform context it was given.
+                    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;
+                        await appendEvent(pool, 'run.grounding', {
+                            stage: budgetLeft ? 'retried' : 'unchecked',
+                            agentId: agent.id,
+                            sources: citationSignals(turnText, known).sources.slice(0, 8),
+                            ...(opts.runId ? { runId: opts.runId } : {}),
+                        }, conversationId);
+                        if (budgetLeft) {
+                            heldBack = { content: assistantContent, text: turnText };
+                            try {
+                                opts.onRetract?.();
+                            }
+                            catch { /* a surface's drawing never decides a run */ }
+                            messages.push({ role: 'user', content: [{ type: 'text', text: GROUNDING_RETRY_TEXT }] });
+                            continue;
+                        }
+                        unchecked = true;
+                    }
+                }
+            }
+            await persistMessage(pool, conversationId, 'assistant', persistable(delivered), opts.transcript?.speaker);
             if (turnText) {
                 spoken.push({ text: turnText, beforeToolCall: toolUses.length > 0 });
                 await opts.onText?.(turnText);
@@ -872,6 +945,8 @@ async function runAgentOnce(opts) {
                     catch { /* a surface's drawing never decides a run */ }
                 }
                 if (outcome.ok) {
+                    // Something came back: from here on the run has read (the guard).
+                    read = true;
                     if (registry.waitsForOwner(call.name, outcome.output))
                         waitingForOwner = true;
                     // A tool that declares it saves files, and names them in its output,
@@ -968,17 +1043,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;
@@ -1069,6 +1157,8 @@ async function runAgentOnce(opts) {
         ...(opts.surface ? { surface: opts.surface.id } : {}),
         ...(opts.runId ? { runId: opts.runId } : {}),
         ...(pendingActionId ? { actionId: pendingActionId } : {}),
+        // Delivered from memory after the grounding guard asked for a check.
+        ...(unchecked ? { unchecked: true } : {}),
     }, conversationId);
     return {
         text: joinSpoken(spoken),
@@ -1077,6 +1167,26 @@ async function runAgentOnce(opts) {
         usage,
         snapshot,
         ...(pendingActionId ? { pendingActionId } : {}),
+        ...(unchecked ? { unchecked: true } : {}),
     };
 }
+/**
+ * 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
+ * not one the answer invented.
+ */
+function knownText(messages) {
+    const parts = [];
+    for (const message of messages) {
+        for (const block of message.content) {
+            if (block.type === 'text')
+                parts.push(block.text);
+            else if (block.type === 'tool_result')
+                parts.push(typeof block.content === 'string' ? block.content : JSON.stringify(block.content));
+            else if (block.type === 'tool_use')
+                parts.push(JSON.stringify(block.input));
+        }
+    }
+    return parts.join('\n');
+}
 //# sourceMappingURL=loop.js.map