@sema-agent/core 1.279.0

package/dist/core/memory-engine/sync.js

@@ -0,0 +1,68 @@
+export function reconcileMemoryEntries(baseRevs, local, remote) {
+    const plan = { push: [], pull: [], deleteLocal: [], deleteRemote: [], conflicts: [], cleared: [] };
+    const localById = new Map(local.map((e) => [e.id, e]));
+    const remoteById = new Map(remote.map((e) => [e.id, e]));
+    const ids = new Set([...localById.keys(), ...remoteById.keys(), ...Object.keys(baseRevs)]);
+    for (const id of ids) {
+        const l = localById.get(id);
+        const r = remoteById.get(id);
+        const base = baseRevs[id];
+        if (l !== undefined && r !== undefined) {
+            if (l.rev === r.rev)
+                continue;
+            const localChanged = base === undefined || l.rev !== base;
+            const remoteChanged = base === undefined || r.rev !== base;
+            if (localChanged && remoteChanged)
+                plan.conflicts.push({ id, local: l, remote: r, ...(base !== undefined ? { baseRev: base } : {}) });
+            else if (localChanged)
+                plan.push.push(l);
+            else
+                plan.pull.push(r);
+            continue;
+        }
+        if (l !== undefined) {
+            if (base === undefined)
+                plan.push.push(l);
+            else if (l.rev !== base)
+                plan.conflicts.push({ id, local: l, baseRev: base });
+            else
+                plan.deleteLocal.push({ id, baseRev: base });
+            continue;
+        }
+        if (r !== undefined) {
+            if (base === undefined)
+                plan.pull.push(r);
+            else if (r.rev !== base)
+                plan.conflicts.push({ id, remote: r, baseRev: base });
+            else
+                plan.deleteRemote.push({ id, baseRev: base });
+            continue;
+        }
+        plan.cleared.push(id);
+    }
+    return plan;
+}
+export function nextSyncBaseline(local, remote) {
+    const remoteById = new Map(remote.map((e) => [e.id, e.rev]));
+    const base = {};
+    for (const e of local) {
+        if (remoteById.get(e.id) === e.rev)
+            base[e.id] = e.rev;
+    }
+    return base;
+}
+export function mergeRecallHits(hitLists, limit) {
+    const seen = new Set();
+    const merged = [];
+    for (const list of hitLists) {
+        for (const h of list) {
+            if (seen.has(h.id))
+                continue;
+            seen.add(h.id);
+            merged.push(h);
+        }
+    }
+    merged.sort((a, b) => a.score - b.score || a.id.localeCompare(b.id));
+    return merged.slice(0, Math.max(0, limit));
+}
+//# sourceMappingURL=sync.js.map

package/dist/core/memory-engine/sync.js.map

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

package/dist/core/memory-engine/types.d.ts

@@ -0,0 +1,128 @@
+export interface MemoryEntryFrontmatter {
+    name?: string;
+    description?: string;
+    type?: string;
+    deleted?: boolean;
+    extra?: string[];
+}
+export interface MemoryEntry {
+    id: string;
+    slug: string;
+    frontmatter: MemoryEntryFrontmatter;
+    body: string;
+    rev: string;
+    scope: string;
+}
+export interface MemoryEntryHeader {
+    id: string;
+    slug: string;
+    scope: string;
+    name?: string;
+    description?: string;
+    type?: string;
+    mtimeMs: number;
+    rev: string;
+    sizeBytes: number;
+}
+export interface ScoredMemoryEntry extends MemoryEntryHeader {
+    score: number;
+}
+export interface NotePatch {
+    op: "add" | "update" | "delete";
+    id: string;
+    entry?: MemoryEntry;
+    baseRev?: string;
+    guard?: "absent";
+}
+export interface PatchReport {
+    applied: Array<{
+        op: NotePatch["op"];
+        id: string;
+        slug?: string;
+    }>;
+    conflicts: Array<{
+        op: NotePatch["op"];
+        id: string;
+        reason: string;
+        baseRev?: string;
+        currentRev?: string;
+    }>;
+}
+export interface MemoryBackend {
+    listHeaders(scopes: readonly string[]): Promise<MemoryEntryHeader[]>;
+    getByIds(ids: readonly string[]): Promise<MemoryEntry[]>;
+    search(query: string, scopes: readonly string[], opts?: {
+        limit?: number;
+    }): Promise<ScoredMemoryEntry[]>;
+    applyPatches(patches: readonly NotePatch[]): Promise<PatchReport>;
+    getConsolidationCursor(scope: string): Promise<string | undefined>;
+    setConsolidationCursor(scope: string, cursor: string): Promise<void>;
+}
+export interface MaterializedFile {
+    path: string;
+    relPath: string;
+    scope: string;
+    id: string;
+    slug: string;
+    rev: string;
+    stub: boolean;
+    readonly: boolean;
+}
+export interface MemorySessionHandle {
+    memoryDir: string;
+    writableRoot: string;
+    writeScope: string | null;
+    scopes: string[];
+    materialized: MaterializedFile[];
+    fileToScope: Map<string, string>;
+    baseRevs: Map<string, string>;
+    baseIds: Map<string, string>;
+    indexBaselineLines: number;
+    indexText: string;
+}
+export type HarvestRejectionCode = "outside_root" | "symlink" | "secret" | "injection" | "filename" | "too_large" | "file_cap" | "readonly_layer" | "stub_modified" | "nested_too_deep" | "quarantine_failed" | "invalid";
+export interface HarvestRejection {
+    path: string;
+    code: HarvestRejectionCode;
+    reason: string;
+}
+export interface ScanFinding {
+    code: "secret" | "injection" | "filename" | "too_large";
+    reason: string;
+}
+export interface MemoryAnnouncement {
+    kind: "gate" | "external";
+    at: number;
+    sessionId?: string;
+    items: string[];
+}
+export interface HarvestReport {
+    ok: boolean;
+    incident?: {
+        kind: "mass_deletion" | "index_cleared" | "dir_missing" | "sidecar_corrupt";
+        detail: string;
+    };
+    patches: {
+        add: number;
+        update: number;
+        delete: number;
+    };
+    conflicts: PatchReport["conflicts"];
+    rejections: HarvestRejection[];
+    quarantined: string[];
+    movedToQuarantine: string[];
+    quarantineFailures?: Array<{
+        path: string;
+        contained: boolean;
+        detail: string;
+    }>;
+    missing: string[];
+    restored: string[];
+    warnings: string[];
+    degraded?: {
+        reason: "deadline" | "file_budget";
+        pending: string[];
+    };
+    inboundFindings?: HarvestRejection[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/memory-engine/types.d.ts.map

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

package/dist/core/memory-engine/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/memory-engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/memory-engine/types.ts"],"names":[],"mappings":""}

package/dist/core/memory-recall.d.ts

@@ -0,0 +1,82 @@
+import type { MemoryNoteHeader, MemoryNoteRecord, MemoryStore } from "./memory.js";
+import type { ModelRef, TaskSpec, TaskResult } from "./types.js";
+export declare const DEFAULT_MAX_SELECTED = 5;
+export declare const DEFAULT_MAX_LINKED = 3;
+export declare const DEFAULT_SELECT_TIMEOUT_MS = 5000;
+export declare function formatMemoryAge(ageMs: number): string;
+export declare const RECALL_CAVEAT: string;
+export interface MemorySelectRequest {
+    objective: string;
+    manifest: MemoryNoteHeader[];
+    recentTools?: string[];
+}
+export type MemorySelector = (req: MemorySelectRequest, signal?: AbortSignal) => Promise<string[]>;
+export interface SelectiveRecallOptions {
+    store: MemoryStore;
+    scope: string;
+    objective: string;
+    selector: MemorySelector;
+    recentTools?: string[];
+    nowMs?: number;
+    maxSelected?: number;
+    maxLinked?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    priorSurfacedIds?: ReadonlySet<string>;
+}
+export type SelectiveRecallResult = {
+    block: string;
+    surfacedIds: string[];
+} | {
+    block: undefined;
+    surfacedIds: string[];
+} | {
+    degrade: true;
+    surfacedIds: string[];
+};
+export declare function resolveLinkedIds(headers: MemoryNoteHeader[], selected: MemoryNoteRecord[], max: number): string[];
+export declare function buildManifestText(headers: MemoryNoteHeader[]): string;
+export declare function validateSelectedIds(headers: MemoryNoteHeader[], ids: string[], max: number): string[];
+export declare function composeSelectiveBody(manifestText: string, selected: MemoryNoteRecord[], nowMs: number, linked?: MemoryNoteRecord[], recallable?: boolean): string;
+export declare function composeSelectiveMemoryBlock(scope: string, manifestText: string, selected: MemoryNoteRecord[], nowMs: number, linked?: MemoryNoteRecord[]): string;
+export declare function selectAndComposeMemory(opts: SelectiveRecallOptions): Promise<SelectiveRecallResult>;
+export declare function encodeSurfacedKey(scope: string, id: string): string;
+export interface ScopedNoteHeader extends MemoryNoteHeader {
+    scope: string;
+}
+export interface ScopedNoteRecord extends MemoryNoteRecord {
+    scope: string;
+}
+export interface LayeredRecallOptions {
+    store: MemoryStore;
+    scopes: ReadonlyArray<string>;
+    objective: string;
+    selector: MemorySelector;
+    recentTools?: string[];
+    nowMs?: number;
+    maxSelected?: number;
+    maxLinked?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    priorSurfacedKeys?: ReadonlySet<string>;
+}
+export type LayeredRecallResult = {
+    block: string;
+    surfacedKeys: string[];
+} | {
+    block: undefined;
+    surfacedKeys: string[];
+} | {
+    degrade: true;
+    surfacedKeys: string[];
+};
+export declare function selectAndComposeLayeredMemory(opts: LayeredRecallOptions): Promise<LayeredRecallResult>;
+export interface MemorySelectorRunner {
+    runTask(spec: TaskSpec): Promise<TaskResult>;
+}
+export declare function createBrainMemorySelector(runner: MemorySelectorRunner, opts?: {
+    model?: ModelRef;
+    timeoutSec?: number;
+    release?: (sessionId: string) => Promise<void> | void;
+}): MemorySelector;
+//# sourceMappingURL=memory-recall.d.ts.map

package/dist/core/memory-recall.d.ts.map

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

package/dist/core/memory-recall.js

@@ -0,0 +1,352 @@
+import { Type } from "typebox";
+import { sanitizeUntrustedText } from "./untrusted-text.js";
+export const DEFAULT_MAX_SELECTED = 5;
+export const DEFAULT_MAX_LINKED = 3;
+export const DEFAULT_SELECT_TIMEOUT_MS = 5_000;
+const MANIFEST_MAX_LINES = 200;
+const MANIFEST_MAX_BYTES = 25_000;
+const SELECTED_BODY_MAX_BYTES = 50_000;
+const ONE_DAY_MS = 24 * 60 * 60 * 1_000;
+const ONE_WEEK_MS = 7 * ONE_DAY_MS;
+const ONE_MONTH_MS = 30.44 * ONE_DAY_MS;
+export function formatMemoryAge(ageMs) {
+    if (ageMs < ONE_DAY_MS)
+        return "today";
+    if (ageMs < 2 * ONE_DAY_MS)
+        return "yesterday";
+    if (ageMs < ONE_WEEK_MS)
+        return `${Math.floor(ageMs / ONE_DAY_MS)} days ago`;
+    if (ageMs < ONE_MONTH_MS) {
+        const weeks = Math.floor(ageMs / ONE_WEEK_MS);
+        return `${weeks} ${weeks === 1 ? "week" : "weeks"} ago`;
+    }
+    const months = Math.floor(ageMs / ONE_MONTH_MS);
+    return `${months} ${months === 1 ? "month" : "months"} ago`;
+}
+export const RECALL_CAVEAT = "These notes were recalled as relevant, but they are point-in-time observations from when they were " +
+    "written — they may now be stale. Trust current tool output over memory, and update or remove a note you " +
+    "find is wrong.\n\n" +
+    "## Before recommending from memory\n" +
+    '- "The memory says X exists" is not the same as "X exists now" — a note is not proof the thing still exists.\n' +
+    "- If the user is about to act on your recommendation (not just asking about history), verify first.\n" +
+    "- If a note names a file, check the file exists; if it names a function or symbol, grep for it; if it names a flag or value, read the current source.\n" +
+    "- Memory is a snapshot from when it was written, not a live view — prefer `git log` or reading the code over recalling the snapshot.";
+export function resolveLinkedIds(headers, selected, max) {
+    if (max <= 0 || selected.length === 0)
+        return [];
+    const byName = new Map();
+    for (const h of headers) {
+        if (!h.name)
+            continue;
+        const prev = byName.get(h.name);
+        if (!prev || h.mtimeMs > prev.mtimeMs)
+            byName.set(h.name, h);
+    }
+    const selectedIds = new Set(selected.map((r) => r.id));
+    const out = [];
+    const seen = new Set();
+    for (const r of selected) {
+        for (const m of r.text.matchAll(/\[\[([^[\]\n]{1,128})\]\]/g)) {
+            const target = byName.get(m[1].trim());
+            if (!target || selectedIds.has(target.id) || seen.has(target.id))
+                continue;
+            seen.add(target.id);
+            out.push(target.id);
+            if (out.length >= max)
+                return out;
+        }
+    }
+    return out;
+}
+function manifestField(s, cap) {
+    const t = s.replace(/\s+/g, " ").trim();
+    return t.length > cap ? `${t.slice(0, cap)}…` : t;
+}
+export function buildManifestText(headers) {
+    const lines = [];
+    let bytes = 0;
+    let truncated;
+    for (const h of headers) {
+        if (lines.length >= MANIFEST_MAX_LINES) {
+            truncated = "lines";
+            break;
+        }
+        const tag = h.type ? `[${manifestField(h.type, 32)}] ` : "";
+        const line = `- ${h.id}: ${tag}${manifestField(h.description, 300)}`;
+        const lb = Buffer.byteLength(line, "utf8") + 1;
+        if (bytes + lb > MANIFEST_MAX_BYTES) {
+            truncated = "bytes";
+            break;
+        }
+        lines.push(line);
+        bytes += lb;
+    }
+    const note = truncated ? `\n<manifest truncated: ${truncated} cap reached; ${headers.length - lines.length} notes omitted — consolidation should shrink memory>` : "";
+    return lines.join("\n") + note;
+}
+export function validateSelectedIds(headers, ids, max) {
+    const valid = new Set(headers.map((h) => h.id));
+    const out = [];
+    const seen = new Set();
+    for (const id of ids) {
+        if (out.length >= max)
+            break;
+        if (valid.has(id) && !seen.has(id)) {
+            seen.add(id);
+            out.push(id);
+        }
+    }
+    return out;
+}
+export function composeSelectiveBody(manifestText, selected, nowMs, linked = [], recallable = true) {
+    const renderNote = (r, label) => {
+        const ageMs = nowMs - r.mtimeMs;
+        const verify = ageMs > ONE_DAY_MS ? " — verify it's still current" : "";
+        const stale = ` (written ${formatMemoryAge(ageMs)}${verify})`;
+        const prefix = label ? `${sanitizeUntrustedText(label, ["user_memory"])} ` : "";
+        return `- ${prefix}${sanitizeUntrustedText(r.text, ["user_memory"])}${stale}`;
+    };
+    let body = selected.map((r) => renderNote(r)).join("\n");
+    if (linked.length > 0) {
+        body +=
+            `\n\nLinked notes (followed one hop from [[name]] references above — same staleness caveats apply):\n` +
+                linked.map((r) => renderNote(r, r.name ? `[[${r.name}]]` : "")).join("\n");
+    }
+    if (Buffer.byteLength(body, "utf8") > SELECTED_BODY_MAX_BYTES) {
+        const buf = Buffer.from(body, "utf8");
+        let cut = SELECTED_BODY_MAX_BYTES;
+        while (cut > 0 && (buf[cut] & 0xc0) === 0x80)
+            cut--;
+        body = `${buf.subarray(0, cut).toString("utf8")}\n<selected notes truncated to ${SELECTED_BODY_MAX_BYTES} bytes>`;
+    }
+    const selectedSection = selected.length > 0 ? `\n\nRelevant notes:\n${body}` : "\n\n(no notes selected as relevant to this task)";
+    const manifestSection = recallable
+        ? `Memory index — to load a note in full, call Recall with keywords from its description:\n${sanitizeUntrustedText(manifestText, ["user_memory"])}`
+        : "";
+    return `${manifestSection}${selectedSection}`;
+}
+export function composeSelectiveMemoryBlock(scope, manifestText, selected, nowMs, linked = []) {
+    return (`<user_memory scope="${scope}" mode="selective">\n` +
+        `${RECALL_CAVEAT}\n\n` +
+        `${composeSelectiveBody(manifestText, selected, nowMs, linked)}\n` +
+        `</user_memory>`);
+}
+export async function selectAndComposeMemory(opts) {
+    if (!opts.store.listStructuredNotes || !opts.store.getByIds)
+        return { degrade: true, surfacedIds: [] };
+    const allHeaders = await opts.store.listStructuredNotes(opts.scope);
+    if (allHeaders.length === 0)
+        return { degrade: true, surfacedIds: [] };
+    const headers = opts.priorSurfacedIds?.size
+        ? allHeaders.filter((h) => !opts.priorSurfacedIds.has(h.id))
+        : allHeaders;
+    if (headers.length === 0)
+        return { block: undefined, surfacedIds: [] };
+    const manifestText = buildManifestText(headers);
+    const max = opts.maxSelected ?? DEFAULT_MAX_SELECTED;
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_SELECT_TIMEOUT_MS;
+    const ac = new AbortController();
+    if (opts.signal?.aborted)
+        ac.abort();
+    const onOuterAbort = () => ac.abort();
+    opts.signal?.addEventListener("abort", onOuterAbort, { once: true });
+    let ids;
+    try {
+        ids = await withTimeout(opts.selector({ objective: opts.objective, manifest: headers, recentTools: opts.recentTools }, ac.signal), timeoutMs, () => ac.abort());
+    }
+    catch {
+        return { degrade: true, surfacedIds: [] };
+    }
+    finally {
+        opts.signal?.removeEventListener("abort", onOuterAbort);
+    }
+    const chosen = validateSelectedIds(headers, ids, max);
+    const records = chosen.length > 0 ? await opts.store.getByIds(opts.scope, chosen) : [];
+    let linked = [];
+    const maxLinked = opts.maxLinked ?? DEFAULT_MAX_LINKED;
+    if (records.length > 0 && maxLinked > 0) {
+        try {
+            const linkedIds = resolveLinkedIds(headers, records, maxLinked);
+            if (linkedIds.length > 0)
+                linked = await opts.store.getByIds(opts.scope, linkedIds);
+        }
+        catch {
+            linked = [];
+        }
+    }
+    const surfacedIds = [...records.map((r) => r.id), ...linked.map((r) => r.id)];
+    return {
+        block: composeSelectiveMemoryBlock(opts.scope, manifestText, records, opts.nowMs ?? Date.now(), linked),
+        surfacedIds,
+    };
+}
+export function encodeSurfacedKey(scope, id) {
+    return `${scope.length}:${scope}:${id}`;
+}
+export async function selectAndComposeLayeredMemory(opts) {
+    if (!opts.store.listStructuredNotes || !opts.store.getByIds)
+        return { degrade: true, surfacedKeys: [] };
+    const listStructuredNotes = opts.store.listStructuredNotes.bind(opts.store);
+    const getByIds = opts.store.getByIds.bind(opts.store);
+    const perScope = await Promise.all(opts.scopes.map(async (scope) => {
+        const headers = await listStructuredNotes(scope);
+        return headers.map((h) => ({ ...h, scope }));
+    }));
+    const allScoped = perScope.flat();
+    if (allScoped.length === 0)
+        return { degrade: true, surfacedKeys: [] };
+    const scoped = opts.priorSurfacedKeys?.size
+        ? allScoped.filter((h) => !opts.priorSurfacedKeys.has(encodeSurfacedKey(h.scope, h.id)))
+        : allScoped;
+    if (scoped.length === 0)
+        return { block: undefined, surfacedKeys: [] };
+    const scopeIndex = new Map();
+    opts.scopes.forEach((s, i) => scopeIndex.set(s, i));
+    const tokenOf = (h) => `s${scopeIndex.get(h.scope) ?? 0}#${h.id}`;
+    const byToken = new Map();
+    const manifestHeaders = scoped.map((h) => {
+        const token = tokenOf(h);
+        byToken.set(token, h);
+        return { ...h, id: token, description: `[${h.scope}] ${h.description}` };
+    });
+    const max = opts.maxSelected ?? DEFAULT_MAX_SELECTED;
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_SELECT_TIMEOUT_MS;
+    const ac = new AbortController();
+    if (opts.signal?.aborted)
+        ac.abort();
+    const onOuterAbort = () => ac.abort();
+    opts.signal?.addEventListener("abort", onOuterAbort, { once: true });
+    let chosenTokens;
+    try {
+        const ids = await withTimeout(opts.selector({ objective: opts.objective, manifest: manifestHeaders, recentTools: opts.recentTools }, ac.signal), timeoutMs, () => ac.abort());
+        chosenTokens = validateSelectedIds(manifestHeaders, ids, max);
+    }
+    catch {
+        return { degrade: true, surfacedKeys: [] };
+    }
+    finally {
+        opts.signal?.removeEventListener("abort", onOuterAbort);
+    }
+    const wantByScope = new Map();
+    for (const token of chosenTokens) {
+        const h = byToken.get(token);
+        if (!h)
+            continue;
+        const arr = wantByScope.get(h.scope) ?? [];
+        arr.push(h.id);
+        wantByScope.set(h.scope, arr);
+    }
+    const maxLinked = opts.maxLinked ?? DEFAULT_MAX_LINKED;
+    const recordsByScope = new Map();
+    const linkedByScope = new Map();
+    const scopedHeadersByScope = new Map();
+    for (const h of scoped) {
+        const arr = scopedHeadersByScope.get(h.scope) ?? [];
+        arr.push(h);
+        scopedHeadersByScope.set(h.scope, arr);
+    }
+    for (const [scope, ids] of wantByScope) {
+        const records = ids.length > 0 ? await getByIds(scope, ids) : [];
+        recordsByScope.set(scope, records);
+        if (records.length > 0 && maxLinked > 0) {
+            try {
+                const linkedIds = resolveLinkedIds(scopedHeadersByScope.get(scope) ?? [], records, maxLinked);
+                if (linkedIds.length > 0)
+                    linkedByScope.set(scope, await getByIds(scope, linkedIds));
+            }
+            catch {
+            }
+        }
+    }
+    const nowMs = opts.nowMs ?? Date.now();
+    const recallableScope = opts.scopes[0];
+    const surfacedKeys = [];
+    const subsections = [];
+    for (const scope of opts.scopes) {
+        const records = recordsByScope.get(scope) ?? [];
+        const linked = linkedByScope.get(scope) ?? [];
+        if (records.length === 0 && linked.length === 0)
+            continue;
+        for (const r of records)
+            surfacedKeys.push(encodeSurfacedKey(scope, r.id));
+        for (const r of linked)
+            surfacedKeys.push(encodeSurfacedKey(scope, r.id));
+        const recallable = scope === recallableScope;
+        const body = composeSelectiveBody(recallable ? buildManifestText(scopedHeadersByScope.get(scope) ?? []) : "", records, nowMs, linked, recallable);
+        subsections.push(`<scope name="${sanitizeUntrustedText(scope, ["user_memory"])}">\n${body}\n</scope>`);
+    }
+    if (subsections.length === 0)
+        return { block: undefined, surfacedKeys: [] };
+    return {
+        block: `<user_memory mode="selective">\n${RECALL_CAVEAT}\n\n${subsections.join("\n")}\n</user_memory>`,
+        surfacedKeys,
+    };
+}
+const SELECT_PROMPT = "You choose which long-term memory notes are relevant to the current task. You are given the task and a " +
+    "numbered manifest of note ids + descriptions. Return ONLY the ids that are clearly useful for this task " +
+    "(at most a handful). If you are unsure, leave it out — an empty list is fine. For any tool the task will " +
+    "use, keep notes about its gotchas/warnings/known-issues but skip pure usage/API notes (that is when " +
+    "gotchas matter most). Never invent an id that is not in the manifest.";
+export function createBrainMemorySelector(runner, opts = {}) {
+    const schema = Type.Object({ ids: Type.Array(Type.String()) });
+    return async (req, signal) => {
+        const manifest = sanitizeUntrustedText(buildManifestText(req.manifest), ["user_memory"]);
+        const tools = req.recentTools?.length ? `\n\nTools this task will use: ${req.recentTools.join(", ")}.` : "";
+        const objective = `TASK:\n${req.objective}${tools}\n\nMEMORY MANIFEST (id: description):\n${manifest}\n\nReturn the relevant note ids.`;
+        const selectorSessionId = `memsel-${globalThis.crypto.randomUUID()}`;
+        let r;
+        try {
+            r = await runner.runTask({
+                objective,
+                systemPrompt: SELECT_PROMPT,
+                ...(opts.model ? { model: opts.model } : {}),
+                sessionId: selectorSessionId,
+                tools: [],
+                outputSchema: schema,
+                enableBlockedReport: false,
+                memory: undefined,
+                limits: { timeoutSec: opts.timeoutSec ?? 20, maxTurns: 2 },
+                signal,
+            });
+        }
+        catch (e) {
+            try {
+                if (opts.release)
+                    await opts.release(selectorSessionId);
+            }
+            catch {
+            }
+            throw e;
+        }
+        try {
+            if (r.status !== "completed") {
+                throw new Error(`memory-select sub-task did not complete (status=${r.status}) — degrading to inject-all`);
+            }
+            const out = r.structuredOutput;
+            if (!out || !Array.isArray(out.ids)) {
+                throw new Error("memory-select sub-task produced no { ids } output — degrading to inject-all");
+            }
+            return out.ids.filter((x) => typeof x === "string");
+        }
+        finally {
+            if (opts.release)
+                await opts.release(r.sessionId);
+        }
+    };
+}
+function withTimeout(p, ms, onTimeout) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            onTimeout?.();
+            reject(new Error("memory-select timeout"));
+        }, ms);
+        p.then((v) => {
+            clearTimeout(timer);
+            resolve(v);
+        }, (e) => {
+            clearTimeout(timer);
+            reject(e);
+        });
+    });
+}
+//# sourceMappingURL=memory-recall.js.map