@namzu/sdk 38.2.1 → 40.0.0

package/dist/store/evidence/linked.js

@@ -0,0 +1,314 @@
+import { lstat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { EVIDENCE_CHUNK_BYTES, digest } from './format.js';
+import { eventTexts, evidenceSeal } from './index-page.js';
+import { EvidencePageLimit, PAGE_BYTES, decode, openEvidence, readBytes, readSmall, } from './io.js';
+import { passageMatcher, passagesInWindow } from './passages.js';
+import { recordPointerSchema, recordPredecessors } from './record-chain.js';
+import { evidenceSearchInput, evidenceTermsSchema } from './search-input.js';
+import { evidenceExclusionsKey, evidenceExclusionsSchema, excludesSuccessfulTool, } from './selection.js';
+import { createTextSourceReader, readTextPage, textPointerSchema } from './source-text.js';
+const integer = z.number().int().nonnegative().safe();
+const scopeSchema = z
+    .object({
+    tenantId: z.string().uuid(),
+    projectId: z.string().uuid(),
+    sessionId: z.string().uuid(),
+    runId: z.string().uuid(),
+})
+    .strict();
+const cursorSchema = z.object({
+    kind: z.enum(['linked-search', 'linked-search-terms', 'linked-search-tokens']),
+    query: z.string().max(256),
+    termsKey: z
+        .string()
+        .regex(/^[a-f0-9]{64}$/)
+        .optional(),
+    caseSensitive: z.boolean().default(true),
+    matchMode: z.enum(['literal', 'token']).default('literal'),
+    exclusionsKey: z
+        .string()
+        .regex(/^[a-f0-9]{64}$/)
+        .optional(),
+    seq: integer.optional(),
+    part: integer.optional(),
+    next: recordPointerSchema.nullable(),
+    textIndex: integer,
+    chunk: integer,
+    within: integer.default(0),
+});
+const addressSchema = z.object({ kind: z.literal('linked-text'), entry: textPointerSchema });
+/** Internal: only the durable writer can supply this anchor. Never accept it from a tool input. */
+export function createLinkedRunTextEvidenceSource(options, anchor) {
+    const scope = Object.freeze(scopeSchema.parse(options.scope));
+    const runDir = options.runDir;
+    const tip = recordPointerSchema.parse(anchor.tip);
+    const ceiling = tip.offset + tip.length;
+    const scopeKey = digest(JSON.stringify(scope));
+    const sourceKey = digest(`linked-v1:${scopeKey}:${anchor.identity}:${anchor.epoch}`);
+    const maxReadBytes = integer
+        .min(1024 * 1024)
+        .max(PAGE_BYTES)
+        .parse(options.maxReadBytes ?? PAGE_BYTES);
+    const inBoundary = (pointer) => {
+        if (pointer.seq > tip.seq || pointer.offset + pointer.length > ceiling)
+            throw new Error('Evidence address exceeds the captured boundary.');
+    };
+    async function access(signal, requestedBytes, action) {
+        const limit = Math.min(maxReadBytes, requestedBytes ?? maxReadBytes);
+        const budget = { bytes: 0, limit, signal };
+        signal?.throwIfAborted();
+        const verifyOwner = async () => {
+            const metadata = JSON.parse(decode(await readSmall(join(runDir, 'run.json'), budget, 512 * 1024)));
+            if (metadata.id !== scope.runId ||
+                JSON.stringify(scopeSchema.parse(metadata.metadata?.scope)) !== JSON.stringify(scope))
+                throw new Error('Evidence run does not belong to the authorized scope.');
+        };
+        await verifyOwner();
+        // Reserve a final ownership check; counters/status may change while this run works.
+        budget.limit = limit - 512 * 1024;
+        const path = join(options.runDir, 'transcript.jsonl');
+        const handle = await openEvidence(path);
+        const check = (stat) => {
+            if (`${stat.dev}:${stat.ino}` !== anchor.identity || stat.size < ceiling)
+                throw new Error('Captured transcript was replaced or shortened.');
+        };
+        try {
+            check(await handle.stat());
+            const seal = await evidenceSeal(options.indexDir, scopeKey, sourceKey, budget);
+            const result = await action(handle, seal, budget);
+            signal?.throwIfAborted();
+            check(await handle.stat());
+            check(await lstat(path));
+            budget.limit = limit;
+            await verifyOwner();
+            return { ...result, scannedBytes: budget.bytes };
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    return Object.freeze({
+        scope,
+        async search(options = {}, signal) {
+            const input = z
+                .object({
+                maxReadBytes: integer
+                    .min(1024 * 1024)
+                    .max(PAGE_BYTES)
+                    .optional(),
+                query: z.string().max(256).optional(),
+                terms: evidenceTermsSchema,
+                caseSensitive: z.boolean().default(true),
+                matchMode: z.enum(['literal', 'token']).default('literal'),
+                excludeSuccessfulTools: evidenceExclusionsSchema,
+                excludeDerivedSummaries: z.boolean().default(false),
+                cursor: z.string().max(4096).optional(),
+                seq: integer.positive().optional(),
+                part: integer.optional(),
+                limit: integer.min(1).max(4).default(4),
+            })
+                .strict()
+                .parse(options);
+            if (input.part !== undefined && input.seq === undefined)
+                throw new Error('Part requires an event sequence.');
+            const { query, terms, termsKey, browse } = evidenceSearchInput(input);
+            const exclusionsKey = evidenceExclusionsKey(input.excludeSuccessfulTools, input.excludeDerivedSummaries);
+            const kind = input.matchMode === 'token'
+                ? 'linked-search-tokens'
+                : terms
+                    ? 'linked-search-terms'
+                    : 'linked-search';
+            return access(signal, input.maxReadBytes, async (handle, seal, budget) => {
+                const readSource = createTextSourceReader(handle, runDir, scope.runId, budget);
+                const cursor = input.cursor
+                    ? cursorSchema.parse(seal.unpack(input.cursor))
+                    : {
+                        kind,
+                        query,
+                        termsKey,
+                        exclusionsKey,
+                        seq: input.seq,
+                        part: input.part,
+                        next: tip,
+                        textIndex: 0,
+                        chunk: 0,
+                        within: 0,
+                        caseSensitive: input.caseSensitive,
+                        matchMode: input.matchMode,
+                    };
+                if (cursor.kind !== kind ||
+                    cursor.query !== query ||
+                    cursor.termsKey !== termsKey ||
+                    cursor.exclusionsKey !== exclusionsKey ||
+                    cursor.caseSensitive !== input.caseSensitive ||
+                    cursor.matchMode !== input.matchMode ||
+                    cursor.seq !== input.seq ||
+                    cursor.part !== input.part)
+                    throw new Error('Search cursor query changed.');
+                const matchPassage = passageMatcher(terms ?? query, input.caseSensitive, input.matchMode);
+                const matches = [];
+                const unavailable = [];
+                let records = 0;
+                let parts = 0;
+                let chunks = 0;
+                let incomplete = false;
+                let excludedToolResults = 0;
+                let excludedSummaries = 0;
+                while (cursor.next &&
+                    records < 64 &&
+                    parts < 64 &&
+                    chunks < 64 &&
+                    matches.length < input.limit) {
+                    const pointer = cursor.next;
+                    inBoundary(pointer);
+                    if (input.seq !== undefined && pointer.seq < input.seq) {
+                        cursor.next = null;
+                        break;
+                    }
+                    let raw;
+                    try {
+                        raw = await readBytes(handle, pointer.offset, pointer.length, budget);
+                    }
+                    catch (error) {
+                        if (error instanceof EvidencePageLimit) {
+                            if (records === 0)
+                                throw new Error('Recorded text exceeds the available page budget.');
+                            break;
+                        }
+                        throw error;
+                    }
+                    if (digest(raw) !== pointer.sha256)
+                        throw new Error('Recorded text integrity chain changed.');
+                    const event = JSON.parse(decode(raw));
+                    if (event.runId !== scope.runId || event.seq !== pointer.seq)
+                        throw new Error('Recorded text identity changed.');
+                    records++;
+                    const links = recordPredecessors(event, pointer);
+                    incomplete ||= links.incomplete;
+                    const texts = input.seq === undefined || input.seq === pointer.seq ? eventTexts(event) : [];
+                    while (cursor.textIndex < texts.length &&
+                        parts < 64 &&
+                        chunks < 64 &&
+                        matches.length < input.limit) {
+                        const part = cursor.textIndex;
+                        if (input.part !== undefined && part !== input.part) {
+                            cursor.textIndex++;
+                            continue;
+                        }
+                        parts++;
+                        try {
+                            const derived = input.excludeDerivedSummaries && texts[part]?.source === 'compaction_shed:summary';
+                            if (derived ||
+                                excludesSuccessfulTool(event.type === 'tool_completed' && typeof event.toolUseId === 'string'
+                                    ? event
+                                    : (texts[part] ?? {}), input.excludeSuccessfulTools)) {
+                                if (derived)
+                                    excludedSummaries++;
+                                else
+                                    excludedToolResults++;
+                                cursor.textIndex++;
+                                cursor.chunk = 0;
+                                cursor.within = 0;
+                                continue;
+                            }
+                            const source = await readSource({ ...pointer, part }, raw);
+                            if (source.retained === 'preview')
+                                incomplete = true;
+                            while (cursor.chunk < source.chunks && chunks < 64 && matches.length < input.limit) {
+                                signal?.throwIfAborted();
+                                chunks++;
+                                if ((terms ?? [query]).some((term) => source.mayMatch(cursor.chunk, term, input.matchMode, input.caseSensitive))) {
+                                    const window = await source.window(cursor.chunk, input.matchMode === 'token');
+                                    const text = decode(window.bytes);
+                                    const page = passagesInWindow(text, Math.max(cursor.within, window.searchFrom ?? 0), matchPassage, input.limit - matches.length, source.entry.spill
+                                        ? (cursor.chunk + 1) * EVIDENCE_CHUNK_BYTES - window.offset
+                                        : undefined);
+                                    cursor.within = page.next;
+                                    for (const { start, end } of page.passages) {
+                                        const excerpt = text.slice(start, end);
+                                        const byteOffset = window.offset + Buffer.byteLength(text.slice(0, start));
+                                        matches.push({
+                                            address: seal.pack({ kind: 'linked-text', entry: { ...pointer, part } }),
+                                            seq: pointer.seq,
+                                            recordedAt: source.recordedAt,
+                                            source: source.entry.source,
+                                            part,
+                                            toolName: source.entry.toolName,
+                                            isError: source.entry.isError,
+                                            retained: source.retained,
+                                            excerpt,
+                                            excerptComplete: source.retained === 'full' &&
+                                                byteOffset === 0 &&
+                                                Buffer.byteLength(excerpt) === source.bytes,
+                                            byteOffset,
+                                            characterOffset: window.characterOffset === undefined
+                                                ? undefined
+                                                : window.characterOffset + start,
+                                        });
+                                    }
+                                    if (cursor.within < text.length)
+                                        break;
+                                }
+                                cursor.within = 0;
+                                cursor.chunk++;
+                                if (browse)
+                                    cursor.chunk = source.chunks;
+                            }
+                            if (cursor.chunk < source.chunks)
+                                break;
+                        }
+                        catch (error) {
+                            signal?.throwIfAborted();
+                            if (error instanceof EvidencePageLimit && (records > 1 || parts > 1 || chunks > 1))
+                                break;
+                            unavailable.push(`Text record ${pointer.seq}/${part} is unavailable or changed.`);
+                        }
+                        cursor.textIndex++;
+                        cursor.chunk = 0;
+                        cursor.within = 0;
+                    }
+                    if (cursor.textIndex < texts.length)
+                        break;
+                    cursor.next = links.next;
+                    cursor.textIndex = 0;
+                    cursor.chunk = 0;
+                    cursor.within = 0;
+                }
+                return {
+                    scope,
+                    matches,
+                    nextCursor: cursor.next ? seal.pack(cursor) : null,
+                    scannedBytes: budget.bytes,
+                    indexedRecords: records,
+                    cacheHit: false,
+                    incomplete: incomplete || unavailable.length > 0,
+                    unavailable,
+                    ...(excludedToolResults ? { excludedToolResults } : {}),
+                    ...(excludedSummaries ? { excludedSummaries } : {}),
+                };
+            });
+        },
+        async read(options, signal) {
+            const input = z
+                .object({
+                address: z.string().max(8192),
+                byteOffset: integer.default(0),
+                maxReadBytes: integer
+                    .min(1024 * 1024)
+                    .max(PAGE_BYTES)
+                    .optional(),
+            })
+                .strict()
+                .parse(options);
+            return access(signal, input.maxReadBytes, async (handle, seal, budget) => {
+                const pointer = addressSchema.parse(seal.unpack(input.address)).entry;
+                inBoundary(pointer);
+                const source = await createTextSourceReader(handle, runDir, scope.runId, budget)(pointer);
+                return readTextPage(source, scope, input.byteOffset, budget);
+            });
+        },
+    });
+}
+//# sourceMappingURL=linked.js.map

package/dist/store/evidence/linked.js.map

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

package/dist/store/evidence/passages.d.ts

@@ -0,0 +1,15 @@
+/** An exact excerpt; matching never rewrites the text or its UTF-16 positions. */
+export interface EvidencePassage {
+    hit: number;
+    start: number;
+    end: number;
+    next: number;
+}
+/** Exact substring or token matching, without caller-selected regex operators. */
+export declare function passageMatcher(query: string | readonly string[], caseSensitive: boolean, matchMode?: 'literal' | 'token'): (text: string, from: number) => EvidencePassage | undefined;
+/** Overlap bytes support boundary matches; starts in those bytes belong to the next window. */
+export declare function passagesInWindow(text: string, from: number, match: ReturnType<typeof passageMatcher>, limit: number, ownedBytes?: number): {
+    passages: EvidencePassage[];
+    next: number;
+};
+//# sourceMappingURL=passages.d.ts.map

package/dist/store/evidence/passages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passages.d.ts","sourceRoot":"","sources":["../../../src/store/evidence/passages.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACZ;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACjC,aAAa,EAAE,OAAO,EACtB,SAAS,GAAE,SAAS,GAAG,OAAmB,IAsBlC,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,eAAe,GAAG,SAAS,CA8BhE;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,EACxC,KAAK,EAAE,MAAM,EACb,UAAU,SAA2B,GACnC;IAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAY/C"}

package/dist/store/evidence/passages.js

@@ -0,0 +1,72 @@
+import { evidenceTokenMatcher } from '../../utils/evidence-tokens.js';
+/** Exact substring or token matching, without caller-selected regex operators. */
+export function passageMatcher(query, caseSensitive, matchMode = 'literal') {
+    const terms = typeof query === 'string' ? [query] : query;
+    const tokenMatch = matchMode === 'token' ? evidenceTokenMatcher(terms, caseSensitive) : undefined;
+    const expression = caseSensitive && typeof query === 'string'
+        ? undefined
+        : new RegExp(terms.map((term) => term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('|'), caseSensitive ? 'g' : 'giu');
+    const maxLength = Math.max(...terms.map((term) => term.length));
+    const find = (text, from) => {
+        if (tokenMatch)
+            return tokenMatch(text, from);
+        if (expression) {
+            expression.lastIndex = from;
+            const match = expression.exec(text);
+            return match ? { index: match.index, length: match[0].length } : undefined;
+        }
+        const index = text.indexOf(terms[0] ?? '', from);
+        return index < 0 ? undefined : { index, length: terms[0]?.length ?? 0 };
+    };
+    return (text, from) => {
+        const hit = find(text, from)?.index ?? -1;
+        if (hit < 0 || (from >= text.length && query !== ''))
+            return undefined;
+        let start = Math.max(0, hit - 120);
+        if (start > 0 && /[\uDC00-\uDFFF]/.test(text[start] ?? ''))
+            start--;
+        let end = Math.min(text.length, start + 512);
+        if (end < text.length && /[\uDC00-\uDFFF]/.test(text[end] ?? ''))
+            end--;
+        // Nearby hits already fully shown by this excerpt need no second copy.
+        // A match crossing its end still deserves a complete later excerpt.
+        let next = end === text.length || query === '' ? text.length : Math.max(hit + 1, end - maxLength + 1);
+        if (typeof query !== 'string' && end < text.length) {
+            // Different term lengths share one excerpt. Skip fully visible short
+            // matches, but keep the earliest long match that crosses its boundary.
+            let at = next;
+            next = end;
+            while (at < end) {
+                const crossing = find(text, at);
+                if (!crossing || crossing.index >= end)
+                    break;
+                if (crossing.index + crossing.length > end) {
+                    next = crossing.index;
+                    break;
+                }
+                at = crossing.index + 1;
+                if (/[\uDC00-\uDFFF]/.test(text[at] ?? ''))
+                    at++;
+            }
+        }
+        if (/[\uDC00-\uDFFF]/.test(text[next] ?? ''))
+            next++;
+        return { hit, start, end, next };
+    };
+}
+/** Overlap bytes support boundary matches; starts in those bytes belong to the next window. */
+export function passagesInWindow(text, from, match, limit, ownedBytes = Number.POSITIVE_INFINITY) {
+    const passages = [];
+    let next = from;
+    while (passages.length < limit) {
+        const passage = match(text, next);
+        if (!passage || Buffer.byteLength(text.slice(0, passage.hit)) >= ownedBytes)
+            return { passages, next: text.length };
+        passages.push(passage);
+        next = passage.next;
+        if (next >= text.length)
+            break;
+    }
+    return { passages, next };
+}
+//# sourceMappingURL=passages.js.map

package/dist/store/evidence/passages.js.map

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

package/dist/store/evidence/record-chain.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+export declare const recordPointerSchema: z.ZodObject<{
+    offset: z.ZodNumber;
+    length: z.ZodNumber;
+    sha256: z.ZodString;
+    seq: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    length: number;
+    seq: number;
+    sha256: string;
+    offset: number;
+}, {
+    length: number;
+    seq: number;
+    sha256: string;
+    offset: number;
+}>;
+export type RecordPointer = z.infer<typeof recordPointerSchema>;
+/** Malformed content must still be visited and rejected by the reader. */
+export declare function hasEvidenceText(event: Record<string, unknown>): boolean;
+/** Validate links even when a text-only traversal skips intervening operational records. */
+export declare function recordPredecessors(event: Record<string, unknown>, pointer: RecordPointer): {
+    previous: {
+        length: number;
+        seq: number;
+        sha256: string;
+        offset: number;
+    } | null;
+    next: {
+        length: number;
+        seq: number;
+        sha256: string;
+        offset: number;
+    } | null;
+    incomplete: boolean;
+};
+/** Bootstrap only the last complete record, never load a growing log to capture a boundary. */
+export declare function transcriptTail(path: string, runId: string): Promise<{
+    tip: RecordPointer;
+    textTip?: RecordPointer | null;
+} | undefined>;
+//# sourceMappingURL=record-chain.d.ts.map

package/dist/store/evidence/record-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-chain.d.ts","sourceRoot":"","sources":["../../../src/store/evidence/record-chain.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAMvE;AAED,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,aAAa;;;;;;;;;;;;;;EA8BxF;AAED,+FAA+F;AAC/F,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,GAAG,EAAE,aAAa,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,GAAG,SAAS,CAAC,CA8C7E"}

package/dist/store/evidence/record-chain.js

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+import { digest } from './format.js';
+import { eventTexts } from './index-page.js';
+import { RECORD_BYTES, decode, openEvidence, readBytes } from './io.js';
+const integer = z.number().int().nonnegative().safe();
+export const recordPointerSchema = z.object({
+    offset: integer,
+    length: integer.positive().max(RECORD_BYTES),
+    sha256: z.string().regex(/^[a-f0-9]{64}$/),
+    seq: integer.positive(),
+});
+/** Malformed content must still be visited and rejected by the reader. */
+export function hasEvidenceText(event) {
+    try {
+        return eventTexts(event).length > 0;
+    }
+    catch {
+        return true;
+    }
+}
+/** Validate links even when a text-only traversal skips intervening operational records. */
+export function recordPredecessors(event, pointer) {
+    let previous = null;
+    let incomplete = false;
+    if (event.previousRecord != null) {
+        previous = recordPointerSchema.parse(event.previousRecord);
+        if (previous.offset + previous.length !== pointer.offset || previous.seq + 1 !== pointer.seq)
+            throw new Error('Invalid text integrity chain.');
+    }
+    else if (pointer.seq === 1) {
+        if (pointer.offset !== 0 || event.type !== 'run_started')
+            throw new Error('Invalid transcript start.');
+    }
+    else {
+        incomplete = true;
+    }
+    let next = previous;
+    if (Object.hasOwn(event, 'previousTextRecord')) {
+        next = recordPointerSchema.nullable().parse(event.previousTextRecord);
+        if ((next === null && previous !== null) ||
+            (next !== null &&
+                (previous === null ||
+                    next.seq >= pointer.seq ||
+                    next.offset + next.length > pointer.offset ||
+                    (next.seq === previous.seq &&
+                        (next.offset !== previous.offset ||
+                            next.length !== previous.length ||
+                            next.sha256 !== previous.sha256)))))
+            throw new Error('Invalid text predecessor link.');
+    }
+    return { previous, next, incomplete };
+}
+/** Bootstrap only the last complete record, never load a growing log to capture a boundary. */
+export async function transcriptTail(path, runId) {
+    let handle;
+    try {
+        handle = await openEvidence(path);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+    try {
+        const stat = await handle.stat();
+        if (!stat.size)
+            return undefined;
+        const offset = Math.max(0, stat.size - RECORD_BYTES);
+        const tail = await readBytes(handle, offset, stat.size - offset, { bytes: 0 });
+        if (tail.at(-1) !== 10)
+            return undefined;
+        const start = tail.lastIndexOf(10, tail.length - 2) + 1;
+        if (start === 0 && offset !== 0)
+            return undefined;
+        const raw = tail.subarray(start);
+        let event;
+        try {
+            event = JSON.parse(decode(raw));
+        }
+        catch {
+            return undefined;
+        }
+        if (event?.runId !== runId)
+            return undefined;
+        const pointer = recordPointerSchema.safeParse({
+            offset: offset + start,
+            length: raw.length,
+            sha256: digest(raw),
+            seq: event.seq,
+        });
+        if (!pointer.success)
+            return undefined;
+        const tip = pointer.data;
+        // Starts, gaps and malformed records remain traversal barriers. They may
+        // never disappear behind a later text link after reopening the writer.
+        let textTip = tip;
+        try {
+            const links = recordPredecessors(event, tip);
+            if (!hasEvidenceText(event) && links.previous !== null)
+                textTip = Object.hasOwn(event, 'previousTextRecord') ? links.next : undefined;
+        }
+        catch {
+            // Keep the tail itself; retrieval will reject its malformed links.
+        }
+        return { tip, textTip };
+    }
+    finally {
+        await handle.close();
+    }
+}
+//# sourceMappingURL=record-chain.js.map

package/dist/store/evidence/record-chain.js.map

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

package/dist/store/evidence/search-input.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const evidenceTermsSchema: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">>;
+/** Canonical membership binds continuations without putting long term lists in cursors. */
+export declare function evidenceSearchInput(input: {
+    query?: string;
+    terms?: string[];
+    matchMode?: 'literal' | 'token';
+}): {
+    query: string;
+    terms: string[] | undefined;
+    termsKey: string | undefined;
+    browse: boolean;
+};
+/** Refinement only narrows matching; it never resets scope, filters or position. */
+export declare function evidenceTermRefinement(input: {
+    terms?: readonly string[];
+    cursor?: string;
+    matchMode?: string;
+    caseSensitive?: boolean;
+}, refined: readonly string[]): string[];
+//# sourceMappingURL=search-input.d.ts.map

package/dist/store/evidence/search-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-input.d.ts","sourceRoot":"","sources":["../../../src/store/evidence/search-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,mBAAmB,8EAUpB,CAAA;AAEZ,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;CAC/B;;;;;EAcA;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CACrC,KAAK,EAAE;IACN,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB,EACD,OAAO,EAAE,SAAS,MAAM,EAAE,GACxB,MAAM,EAAE,CAeV"}