@animalabs/agent-framework 0.19.0 → 0.21.0

package/dist/src/modules/history/semantic.js

@@ -0,0 +1,418 @@
+/**
+ * Semantic (embedding) search for HistoryModule, backed by a shared remote
+ * embed-service (one per fleet; the index lives server-side, keyed by a
+ * per-store namespace).
+ *
+ * Two pieces:
+ *  - `SemanticIndexClient` — thin HTTP client for the service's index API
+ *    (`/v1/index/{ns}/upsert|search|stats`).
+ *  - `SemanticIndexer` — incremental sync from the resident's chronicle into
+ *    that namespace. Messages are watermarked by TIMESTAMP (chronicle's native
+ *    time index is the only cheap "what's new" query), with a re-scan overlap
+ *    so a message stamped slightly out of order is still picked up; the
+ *    service dedups by id + text hash, so re-sending is free. Summaries are
+ *    watermarked by `createdMs` (a fresh L3 spans months of old timestamps —
+ *    its creation time is the only monotonic signal).
+ *
+ * What gets embedded per message: text blocks verbatim, plus the string
+ * arguments of the agent's private-prose tools (think / journal / skip_reply
+ * / private_note) labelled `[think] …` — that is the resident's own diary and
+ * is exactly what "what did I think about X" should find. tool_result
+ * payloads, other tool arguments, thinking blocks and media are skipped.
+ *
+ * Failure posture: the service being down never breaks the module. Sync ticks
+ * log and back off; `semantic_search` returns a clean tool error.
+ */
+const PRIVATE_PROSE_TOOLS = new Set(['think', 'journal', 'skip_reply', 'private_note']);
+export class SemanticIndexClient {
+    cfg;
+    base;
+    ns;
+    timeoutMs;
+    constructor(cfg) {
+        this.cfg = cfg;
+        this.base = cfg.url.replace(/\/+$/, '');
+        this.ns = encodeURIComponent(cfg.namespace);
+        this.timeoutMs = cfg.requestTimeoutMs ?? 30_000;
+    }
+    async call(method, path, body) {
+        const headers = { 'content-type': 'application/json' };
+        if (this.cfg.token)
+            headers.authorization = `Bearer ${this.cfg.token}`;
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(`${this.base}${path}`, {
+                method, headers, body: body === undefined ? undefined : JSON.stringify(body), signal: ctrl.signal,
+            });
+            const text = await res.text();
+            let json;
+            try {
+                json = JSON.parse(text);
+            }
+            catch {
+                json = undefined;
+            }
+            if (!res.ok) {
+                const msg = json?.error?.message ?? text.slice(0, 200);
+                throw new Error(`embed-service ${method} ${path} → ${res.status}: ${msg}`);
+            }
+            return json;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /** Stats for this namespace; `null` when the namespace does not exist yet. */
+    async stats() {
+        try {
+            return await this.call('GET', `/v1/index/${this.ns}/stats`);
+        }
+        catch (e) {
+            if (e instanceof Error && /→ 404/.test(e.message))
+                return null;
+            throw e;
+        }
+    }
+    async upsert(items) {
+        return this.call('POST', `/v1/index/${this.ns}/upsert`, { items });
+    }
+    async delete(ids) {
+        return this.call('POST', `/v1/index/${this.ns}/delete`, { ids });
+    }
+    async search(req) {
+        return this.call('POST', `/v1/index/${this.ns}/search`, req);
+    }
+}
+/** Text to embed for one message, or '' when there is nothing worth indexing. */
+export function messageIndexText(msg, includePrivateTools = true) {
+    const parts = [];
+    for (const block of msg.content) {
+        if (block.type === 'text' && typeof block.text === 'string') {
+            parts.push(block.text);
+        }
+        else if (includePrivateTools && block.type === 'tool_use' && PRIVATE_PROSE_TOOLS.has(block.name)) {
+            const input = block.input ?? {};
+            for (const v of Object.values(input)) {
+                if (typeof v === 'string' && v.trim().length > 0)
+                    parts.push(`[${block.name}] ${v}`);
+            }
+        }
+    }
+    return parts.join('\n').trim();
+}
+/** Same two metadata shapes HistoryModule's getChannelId reads: MCPL ingestion writes `metadata.channelId`, older paths `metadata.external.channelId`. */
+function channelOf(msg) {
+    const md = msg.metadata;
+    if (typeof md?.channelId === 'string')
+        return md.channelId;
+    return typeof md?.external?.channelId === 'string' ? md.external.channelId : null;
+}
+function authorOf(msg) {
+    const md = msg.metadata;
+    const a = md?.external?.authorName ?? md?.authorName;
+    return typeof a === 'string' ? a : null;
+}
+export function messageToItem(msg, cfg) {
+    const text = messageIndexText(msg, cfg.includePrivateTools ?? true);
+    if (!text)
+        return null;
+    const tsMs = msg.timestamp.getTime();
+    return {
+        id: `msg:${String(msg.id)}`,
+        text: text.slice(0, cfg.maxChars ?? 32_000),
+        ts: tsMs / 1000,
+        channel: channelOf(msg),
+        kind: 'message',
+        cursor: tsMs,
+        meta: { participant: msg.participant, author: authorOf(msg), seq: msg.sequence },
+    };
+}
+export function summaryToItem(s, cfg) {
+    const text = s.content.trim();
+    if (!text)
+        return null;
+    return {
+        id: `sum:${s.id}`,
+        text: text.slice(0, cfg.maxChars ?? 32_000),
+        ts: s.startMs / 1000,
+        kind: 'summary',
+        level: s.level,
+        cursor: s.createdMs,
+        meta: { endTs: s.endMs / 1000, firstSequence: s.firstSequence, lastSequence: s.lastSequence, tokens: s.tokens, parentId: s.parentId ?? null },
+    };
+}
+export class SemanticIndexer {
+    cm;
+    client;
+    cfg;
+    log;
+    inFlight = null;
+    consecutiveFailures = 0;
+    backoffUntil = 0;
+    lastError = null;
+    lastSyncAt = null;
+    constructor(cm, client, cfg, log = () => { }) {
+        this.cm = cm;
+        this.client = client;
+        this.cfg = cfg;
+        this.log = log;
+    }
+    /**
+     * Edits and removals since the last successful sync. The time-cursor walk
+     * only revisits the overlap window, so an edit to an older message (its
+     * timestamp does not change) or a removal would otherwise never reach the
+     * index. The host persists the pending sets through `onPendingChange` /
+     * `restorePending` (HistoryModule keeps them in module state), so edits
+     * made during an embed-service outage survive a restart. Events that land
+     * while the module is detached are not replayed (removals are still hidden
+     * at search time by the current-branch check in HistoryModule).
+     */
+    editedIds = new Set();
+    removedIds = new Set();
+    detach = null;
+    /** Set once the service answers 404 to /delete (a build without the route): removals are dropped from then on. */
+    deleteUnsupported = false;
+    /** Called whenever the pending edit/remove sets change. */
+    onPendingChange = null;
+    pendingSnapshot() { return { edited: [...this.editedIds], removed: [...this.removedIds] }; }
+    restorePending(p) {
+        for (const id of p?.removed ?? []) {
+            this.removedIds.add(id);
+            this.editedIds.delete(id);
+        }
+        for (const id of p?.edited ?? [])
+            if (!this.removedIds.has(id))
+                this.editedIds.add(id);
+    }
+    pendingChanged() { this.onPendingChange?.(this.pendingSnapshot()); }
+    /** Subscribe to message-store edits/removals. Idempotent. */
+    attach() {
+        if (this.detach)
+            return;
+        const on = this.cm.onMessage;
+        if (typeof on !== 'function') {
+            this.log('[history/semantic] context-manager has no onMessage: edits and removals will not reach the index');
+            return;
+        }
+        this.detach = on.call(this.cm, (e) => {
+            if (e.type === 'edit') {
+                this.editedIds.add(String(e.messageId));
+                this.pendingChanged();
+            }
+            else if (e.type === 'remove') {
+                const id = String(e.messageId);
+                this.editedIds.delete(id);
+                if (!this.deleteUnsupported)
+                    this.removedIds.add(id);
+                this.pendingChanged();
+            }
+            // removeRange carries only its endpoints; removed ids in it are hidden at search time instead.
+        });
+    }
+    dispose() { this.detach?.(); this.detach = null; }
+    get backingOff() { return Date.now() < this.backoffUntil; }
+    /**
+     * Push what the index is missing, up to `maxItems`. Coalesces: a call while
+     * a sync is already running returns that run's promise instead of racing it.
+     */
+    catchUp(maxItems) {
+        if (this.inFlight)
+            return this.inFlight;
+        const run = this.runCatchUp(maxItems).finally(() => { this.inFlight = null; });
+        this.inFlight = run;
+        return run;
+    }
+    async runCatchUp(maxItems) {
+        const report = { pushed: 0, inserted: 0, updated: 0, unchanged: 0, more: false, messagesScanned: 0, summariesScanned: 0 };
+        if (this.backingOff) {
+            report.more = true;
+            return report;
+        }
+        const batchSize = Math.min(256, Math.max(1, this.cfg.syncBatch ?? 128));
+        try {
+            const stats = await this.client.stats();
+            const msgWm = stats?.by_kind.message?.max_cursor ?? null;
+            const sumWm = stats?.by_kind.summary?.max_cursor ?? null;
+            let budget = maxItems;
+            let pending = [];
+            const flush = async () => {
+                if (pending.length === 0)
+                    return;
+                const r = await this.client.upsert(pending);
+                report.pushed += pending.length;
+                report.inserted += r.inserted;
+                report.updated += r.updated;
+                report.unchanged += r.unchanged;
+                pending = [];
+            };
+            // Edits and removals first: they never come back round in the time walk.
+            // This phase fails on its own: a failure re-queues its ids, is logged
+            // and reported via lastError, and the tick falls through to summaries
+            // and the time walk, so one bad delete/upsert cannot freeze indexing.
+            let phaseError = null;
+            if (this.removedIds.size > 0 || this.editedIds.size > 0) {
+                const removed = [...this.removedIds];
+                // Edits spend the budget like any other upsert, so a large queue left
+                // by an outage cannot make a search's bounded catch-up unbounded; the
+                // rest stay queued for the next pass.
+                // Only actionable edits (an upsert or a delete) spend it: one whose
+                // message left the branch is dropped for free.
+                this.removedIds.clear();
+                const edited = [];
+                const toDelete = removed.map((id) => `msg:${id}`);
+                const blanked = [];
+                const toUpsert = [];
+                for (const id of [...this.editedIds]) {
+                    if (budget <= 0)
+                        break;
+                    this.editedIds.delete(id);
+                    const m = this.cm.getMessage(id);
+                    // Not on the current branch (e.g. /undo after the edit): drop it,
+                    // never delete — /redo brings the message back and the time walk
+                    // will not revisit it. Search-time branch checks hide it meanwhile.
+                    if (!m)
+                        continue;
+                    edited.push(id);
+                    budget--;
+                    const item = messageToItem(m, this.cfg);
+                    // On the branch but edited down to nothing indexable: delete.
+                    if (item)
+                        toUpsert.push(item);
+                    else {
+                        toDelete.push(`msg:${id}`);
+                        blanked.push(id);
+                    }
+                }
+                if (this.editedIds.size > 0)
+                    report.more = true;
+                if (toDelete.length > 0) {
+                    try {
+                        await this.client.delete(toDelete);
+                    }
+                    catch (e) {
+                        const msg = e instanceof Error ? e.message : String(e);
+                        if (/→ 404/.test(msg)) {
+                            // A service build without /delete (or a namespace that does
+                            // not exist). Drop the removals and blanked edits: search-time
+                            // checks (on-branch, still indexable) keep them out of results.
+                            this.deleteUnsupported = true;
+                            this.log(`[history/semantic] /delete unsupported by the embed-service; dropping ${toDelete.length} removal(s): ${msg}`);
+                        }
+                        else {
+                            for (const id of removed)
+                                this.removedIds.add(id);
+                            for (const id of blanked)
+                                if (!this.removedIds.has(id))
+                                    this.editedIds.add(id);
+                            phaseError = msg;
+                            this.log(`[history/semantic] delete failed, ${removed.length} removal(s) re-queued: ${msg}`);
+                        }
+                    }
+                }
+                try {
+                    for (let i = 0; i < toUpsert.length; i += batchSize) {
+                        const chunk = toUpsert.slice(i, i + batchSize);
+                        const r = await this.client.upsert(chunk);
+                        report.pushed += chunk.length;
+                        report.inserted += r.inserted;
+                        report.updated += r.updated;
+                        report.unchanged += r.unchanged;
+                    }
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    for (const id of edited)
+                        if (!this.removedIds.has(id))
+                            this.editedIds.add(id);
+                    phaseError = msg;
+                    this.log(`[history/semantic] edit re-upsert failed, ${edited.length} edit(s) re-queued: ${msg}`);
+                }
+                this.pendingChanged();
+            }
+            // Summaries before messages: they are few, and a message backlog that
+            // exceeds every tick's budget must not keep new summaries out forever.
+            {
+                const all = this.cm.getSummariesInRange({ fromMs: 0, toMs: Number.MAX_SAFE_INTEGER });
+                report.summariesScanned = all.length;
+                // `>=`: summaries sharing the watermark's millisecond may be only
+                // partly indexed (a bounded pass can stop inside a tie). Re-sending
+                // them is a dedup no-op for the service and costs no budget.
+                const fresh = all.filter((s) => sumWm === null || s.createdMs >= sumWm).sort((a, b) => a.createdMs - b.createdMs);
+                for (const s of fresh) {
+                    if (budget <= 0) {
+                        report.more = true;
+                        break;
+                    }
+                    const item = summaryToItem(s, this.cfg);
+                    if (!item)
+                        continue;
+                    pending.push(item);
+                    if (sumWm === null || s.createdMs > sumWm)
+                        budget--;
+                    if (pending.length >= batchSize)
+                        await flush();
+                }
+                await flush();
+            }
+            // Messages: walk forward from (watermark - overlap) via the time index.
+            // Sound because rows are stamped at append time (CM addMessage takes no
+            // timestamp). An importer that writes historical stamps into a live
+            // store, or a backward clock step past the overlap, lands behind the
+            // watermark and is never indexed.
+            let fromMs = msgWm === null ? undefined : Math.max(0, msgWm - (this.cfg.overlapMs ?? 600_000));
+            // Messages at exactly `fromMs` already seen this pass. The query bounds
+            // are inclusive, so the next page starts at the last page's final
+            // millisecond and skips the ones already walked with `offset` — a run
+            // of more than a page within one millisecond is walked, not jumped.
+            let offset = 0;
+            const pageSize = 256;
+            for (;;) {
+                if (budget <= 0) {
+                    report.more = true;
+                    break;
+                }
+                const page = this.cm.queryMessagesByTime({ fromMs, offset, limit: pageSize });
+                const msgs = page.messages;
+                report.messagesScanned += msgs.length;
+                for (const m of msgs) {
+                    const item = messageToItem(m, this.cfg);
+                    if (!item)
+                        continue;
+                    pending.push(item);
+                    // Only NEW items spend the budget. The overlap re-walk behind the
+                    // watermark is a dedup no-op for the service, and it must be one
+                    // for the budget too: when the overlap window held more messages
+                    // than a tick's budget, every tick spent it all re-sending the same
+                    // indexed items and never reached the first new one — the index
+                    // froze at the watermark while reporting merely `more: true`.
+                    if (msgWm === null || item.cursor === undefined || item.cursor > msgWm)
+                        budget--;
+                    if (pending.length >= batchSize)
+                        await flush();
+                }
+                if (msgs.length < pageSize)
+                    break;
+                const lastMs = msgs[msgs.length - 1].timestamp.getTime();
+                const atLast = msgs.filter((m) => m.timestamp.getTime() === lastMs).length;
+                offset = lastMs === fromMs ? offset + atLast : atLast;
+                fromMs = lastMs;
+            }
+            await flush();
+            this.consecutiveFailures = 0;
+            this.lastError = phaseError;
+            this.lastSyncAt = Date.now();
+            return report;
+        }
+        catch (e) {
+            this.consecutiveFailures++;
+            const delay = Math.min(15 * 60_000, 5_000 * 2 ** Math.min(8, this.consecutiveFailures - 1));
+            this.backoffUntil = Date.now() + delay;
+            this.lastError = e instanceof Error ? e.message : String(e);
+            this.log(`[history/semantic] sync failed (${this.consecutiveFailures}×, retry in ${Math.round(delay / 1000)}s): ${this.lastError}`);
+            report.more = true;
+            return report;
+        }
+    }
+}
+//# sourceMappingURL=semantic.js.map

package/dist/src/modules/history/semantic.js.map

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

package/dist/src/modules/index.d.ts

@@ -5,7 +5,8 @@ export { ApiModule } from './api/index.js';
 export type { ApiEvent } from './api/index.js';
 export { HealthModule } from './health/index.js';
 export type { HealthModuleConfig } from './health/index.js';
-export { HistoryModule } from './history/index.js';
+export { HistoryModule, type HistoryModuleOptions } from './history/index.js';
+export type { SemanticIndexConfig } from './history/semantic.js';
 export { WorkspaceModule, WorkspaceReadError } from './workspace/index.js';
 export type { WorkspaceReadErrorCode, WorkspaceReadStage, WorkspaceDiskReadResult, ReadFileFromDiskOptions } from './workspace/index.js';
 export type { WorkspaceConfig, MountConfig, MountState, WorkspaceModuleState, ReadInput, WriteInput, EditInput, DeleteInput, LsInput, GlobInput, GrepInput, StatusInput, MaterializeInput, SyncInput, } from './workspace/index.js';

package/dist/src/modules/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACzI,YAAY,EACV,eAAe,EACf,WAAW,EACX,UAAU,EACV,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,SAAS,EACT,WAAW,EACX,OAAO,EACP,SAAS,EACT,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,IAAI,gBAAgB,EAC7B,WAAW,EACX,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACzI,YAAY,EACV,eAAe,EACf,WAAW,EACX,UAAU,EACV,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,SAAS,EACT,WAAW,EACX,OAAO,EACP,SAAS,EACT,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,IAAI,gBAAgB,EAC7B,WAAW,EACX,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}

package/dist/src/modules/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAmB3E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAA6B,MAAM,oBAAoB,CAAC;AAG9E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAmB3E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/tool-result-guard.d.ts

@@ -0,0 +1,82 @@
+import type { ContextManager, MessageId } from '@animalabs/context-manager';
+import type { ContentBlock, NormalizedMessage, ToolResult } from '@animalabs/membrane';
+import type { CompletedToolCall } from './types/index.js';
+export declare const TOOL_RESULT_GUARD_NOTICE = "Tool result withheld by the guard. The tool has already executed.";
+export declare const TOOL_RESULT_GUARD_AUDIT_STATE = "framework/tool-result-guard";
+/**
+ * Admission of newly returned tool output to durable model-facing memory.
+ *
+ * Raw output is appended to a separate Chronicle audit slot BEFORE the
+ * placeholder enters the context manager. In particular, onNewMessage and
+ * speculative compression never see unaccepted output. Acceptance edits the
+ * placeholder through CM's versioned edit API; withholding only appends an
+ * audit event. Neither operation erases the original output or its blobs.
+ */
+export declare class ToolResultGuard {
+    private readonly agentName;
+    private readonly cm;
+    private readonly configured;
+    private pending;
+    private registered;
+    private override;
+    /** True until a recovery produces a clean response/new tool round. */
+    recovering: boolean;
+    constructor(agentName: string, cm: ContextManager, configured?: boolean);
+    get enabled(): boolean;
+    setOverride(value: boolean | undefined): void;
+    get settingOverride(): boolean | undefined;
+    get hasPending(): boolean;
+    /** True only once the pending batch's originals were actually put on the
+     * wire. Guard effects (retry suppression, refusal claim, prose buffering)
+     * are scoped to this state; a merely staged batch never claims a refusal. */
+    get hasSubmittedPending(): boolean;
+    /** Extra input tokens the pending batch costs on the wire beyond the
+     * placeholder the strategy selected against (chars/4 + flat per image,
+     * the same heuristic as the physical-window projection). Compilation
+     * reserves this so substituting originals cannot exceed the budget. */
+    get pendingWireReserveTokens(): number;
+    /** Ordered storage work, separate from batches awaiting a provider verdict.
+     * A failed acceptance edit retains both the payload and its compression
+     * hold here; it can never re-arm refusal handling or tool submission. */
+    private unrecorded;
+    /** Retry edits and audit writes before a new activation, audit write,
+     * maintenance pass, or shutdown. A failed operation stays at the head. */
+    flushUnrecorded(): void;
+    private append;
+    private write;
+    private archive;
+    storeResults(content: ContentBlock[], wireResults: ToolResult[], originals: CompletedToolCall[]): MessageId;
+    /** Results for a live continuation (provideToolResults). Marks the batch
+     * submitted and returns the originals only when the audit is durable;
+     * otherwise returns placeholder results and leaves it unsubmitted. */
+    submissionResults(results: ToolResult[]): ToolResult[];
+    /** The stream carrying this batch ended without a clean round (abort or
+     * exhausted errors). Settle conservatively — an interrupted submission
+     * does not establish acceptance — so a later turn neither resubmits the
+     * originals nor attributes its own refusal to this batch. */
+    abandon(reason: string): void;
+    /** A budget/error restart compiles placeholders; restore pending output
+     * only in this provider request, never in the strategy's view. */
+    prepareRequest(messages: NormalizedMessage[], recordSubmission?: boolean): NormalizedMessage[];
+    /** The turn ended (endTurn/skip_reply) before the batch was submitted:
+     * nothing was refused, so admit it exactly as an unguarded agent would.
+     * Leaving it pending would turn it into a permanent withheld notice on
+     * restart and disable ordinary refusal handling on the next turn. */
+    settleTurnEnded(): void;
+    /** A refusal arrived while the pending batch was never on the wire (the
+     * strategy omitted the exchange). The guard cannot have caused it: record
+     * the batch as withheld, clear it, and let ordinary refusal handling run.
+     * Returns true when it settled such a batch. */
+    settleUnsubmitted(category: string): boolean;
+    /** A clean physical response accepts precisely the last submitted batch. */
+    accept(): void;
+    /** At most one recovery per batch; no scanning/deleting older history. */
+    withhold(category: string): string[] | null;
+    /** Transfer ownership from provider admission to an ordered storage job.
+     * Failure retains the accepted payload and its hold until the edit succeeds.
+     * Withheld content is final already, so audit failures cannot keep it held. */
+    private settle;
+    private releaseOperationHold;
+    private releaseHold;
+}
+//# sourceMappingURL=tool-result-guard.d.ts.map

package/dist/src/tool-result-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-guard.d.ts","sourceRoot":"","sources":["../../src/tool-result-guard.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,wBAAwB,sEAAsE,CAAC;AAC5G,eAAO,MAAM,6BAA6B,gCAAgC,CAAC;AAsB3E;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAQxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAT7B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAsB;IACtC,sEAAsE;IACtE,UAAU,UAAS;gBAGA,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,cAAc,EAClB,UAAU,UAAQ;IAGrC,IAAI,OAAO,IAAI,OAAO,CAA6C;IACnE,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAC7C,IAAI,eAAe,IAAI,OAAO,GAAG,SAAS,CAA0B;IACpE,IAAI,UAAU,IAAI,OAAO,CAAuC;IAChE;;iFAE6E;IAC7E,IAAI,mBAAmB,IAAI,OAAO,CAA6C;IAE/E;;;2EAGuE;IACvE,IAAI,wBAAwB,IAAI,MAAM,CAcrC;IAED;;6EAEyE;IACzE,OAAO,CAAC,UAAU,CAAwB;IAE1C;8EAC0E;IAC1E,eAAe,IAAI,IAAI;IA8BvB,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,KAAK;IAab,OAAO,CAAC,OAAO;IASf,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,SAAS;IAmD3G;;0EAEsE;IACtE,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE;IAStD;;;iEAG6D;IAC7D,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ7B;sEACkE;IAClE,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,gBAAgB,UAAQ,GAAG,iBAAiB,EAAE;IAkB5F;;;yEAGqE;IACrE,eAAe,IAAI,IAAI;IAQvB;;;oDAGgD;IAChD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAO5C,4EAA4E;IAC5E,MAAM,IAAI,IAAI;IAQd,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAW3C;;mFAE+E;IAC/E,OAAO,CAAC,MAAM;IAmBd,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,WAAW;CAGpB"}