@chendpoc/pi-memory 0.1.13 → 0.2.0

package/dist/tools/memoryAppend.d.ts

@@ -1,47 +0,0 @@
-import type { MemoryScope } from "../consolidation/scope.js";
-import type { ToolResult } from "../types.js";
-export declare const MEMORY_APPEND_NAME = "memory_append";
-export declare const MEMORY_APPEND_DESCRIPTION: string;
-export declare const MEMORY_APPEND_PROMPT_SNIPPET = "Persist explicit user memory";
-export declare const MEMORY_APPEND_PROMPT_GUIDELINES: readonly ["Use memory_append only when the user explicitly asks to remember a preference or durable fact — not for transient task state."];
-export declare const MEMORY_APPEND_PARAMETERS: {
-    readonly type: "object";
-    readonly properties: {
-        readonly content: {
-            readonly type: "string";
-            readonly description: "New entries to append (markdown bullet points). Write in English by default.";
-        };
-    };
-    readonly required: readonly ["content"];
-};
-export declare function appendToMemoryMd(memoryMdPath: string, content: string): Promise<void>;
-export interface Stage1AppendOptions {
-    dbPath: string;
-    sessionId?: string;
-    sessionFile?: string;
-    scope?: MemoryScope;
-    now?: string;
-}
-export declare function appendToStage1(content: string, opts: Stage1AppendOptions): Promise<string>;
-export declare class MemoryAppendTool {
-    private readonly memoryMdPath;
-    private readonly stage1?;
-    constructor(memoryMdPath: string, stage1?: Stage1AppendOptions | undefined);
-    info(): {
-        name: string;
-        description: string;
-        parameters: {
-            readonly type: "object";
-            readonly properties: {
-                readonly content: {
-                    readonly type: "string";
-                    readonly description: "New entries to append (markdown bullet points). Write in English by default.";
-                };
-            };
-            readonly required: readonly ["content"];
-        };
-    };
-    run(argsJson: string): Promise<ToolResult>;
-}
-export declare function createMemoryAppendTool(memoryMdPath: string, stage1?: Stage1AppendOptions): MemoryAppendTool;
-//# sourceMappingURL=memoryAppend.d.ts.map

package/dist/tools/memoryAppend.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memoryAppend.d.ts","sourceRoot":"","sources":["../../src/tools/memoryAppend.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,eAAO,MAAM,yBAAyB,QAE+D,CAAC;AAEtG,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E,eAAO,MAAM,+BAA+B,4IAElC,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;;;;CAU3B,CAAC;AA6BX,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBADP,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,mBAAmB,YAAA;IAG/C,IAAI;;;;;;;;;;;;;;IAQE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CA4BjD;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,mBAAmB,GAC3B,gBAAgB,CAElB"}

package/dist/tools/memoryAppend.js

@@ -1,138 +0,0 @@
-import fs from "node:fs/promises";
-import { open } from "node:fs/promises";
-import path from "node:path";
-import { openConsolidationStore } from "../consolidation/stage1/store.js";
-export const MEMORY_APPEND_NAME = "memory_append";
-export const MEMORY_APPEND_DESCRIPTION = "Persist durable memory only when the user explicitly asks to remember something. " +
-    "Writes go through the pi-memory consolidation stage instead of direct file edits when configured.";
-export const MEMORY_APPEND_PROMPT_SNIPPET = "Persist explicit user memory";
-export const MEMORY_APPEND_PROMPT_GUIDELINES = [
-    "Use memory_append only when the user explicitly asks to remember a preference or durable fact — not for transient task state.",
-];
-export const MEMORY_APPEND_PARAMETERS = {
-    type: "object",
-    properties: {
-        content: {
-            type: "string",
-            description: "New entries to append (markdown bullet points). Write in English by default.",
-        },
-    },
-    required: ["content"],
-};
-const LOCK_RETRIES = 50;
-const LOCK_DELAY_MS = 20;
-async function withAppendLock(lockPath, fn) {
-    let handle;
-    for (let i = 0; i < LOCK_RETRIES; i++) {
-        try {
-            handle = await open(lockPath, "wx");
-            break;
-        }
-        catch {
-            await new Promise((r) => setTimeout(r, LOCK_DELAY_MS));
-        }
-    }
-    if (!handle) {
-        throw new Error("could not acquire MEMORY.md append lock");
-    }
-    try {
-        return await fn();
-    }
-    finally {
-        await handle.close();
-        await fs.unlink(lockPath).catch(() => { });
-    }
-}
-export async function appendToMemoryMd(memoryMdPath, content) {
-    const trimmed = content.trim();
-    if (!trimmed) {
-        throw new Error("content must not be empty");
-    }
-    await fs.mkdir(path.dirname(memoryMdPath), { recursive: true, mode: 0o700 });
-    const lockPath = `${memoryMdPath}.append.lock`;
-    const block = content.endsWith("\n") ? content : `${content}\n`;
-    await withAppendLock(lockPath, async () => {
-        await fs.appendFile(memoryMdPath, block, { encoding: "utf8", mode: 0o600 });
-    });
-}
-export async function appendToStage1(content, opts) {
-    const trimmed = content.trim();
-    if (!trimmed)
-        throw new Error("content must not be empty");
-    const store = openConsolidationStore(opts.dbPath);
-    if (!store)
-        throw new Error("could not open consolidation store");
-    const now = opts.now ?? new Date().toISOString();
-    const sessionId = opts.sessionId
-        ? `manual_${opts.sessionId}_${Date.now()}`
-        : `manual_${Date.now()}`;
-    try {
-        store.upsertStage1Output({
-            session_id: sessionId,
-            session_file: opts.sessionFile ?? "manual-memory-append",
-            source_mtime_ms: Date.now(),
-            generated_at: now,
-            raw_memory: trimmed,
-            rollout_summary: trimmed,
-            scope: opts.scope ?? "global",
-            status: "done",
-            selected_for_phase2: false,
-            usage_count: 0,
-            last_usage: now,
-            error_message: null,
-        });
-        return sessionId;
-    }
-    finally {
-        store.close();
-    }
-}
-export class MemoryAppendTool {
-    memoryMdPath;
-    stage1;
-    constructor(memoryMdPath, stage1) {
-        this.memoryMdPath = memoryMdPath;
-        this.stage1 = stage1;
-    }
-    info() {
-        return {
-            name: MEMORY_APPEND_NAME,
-            description: MEMORY_APPEND_DESCRIPTION,
-            parameters: MEMORY_APPEND_PARAMETERS,
-        };
-    }
-    async run(argsJson) {
-        let raw;
-        try {
-            raw = JSON.parse(argsJson);
-        }
-        catch (e) {
-            return {
-                content: `invalid arguments: ${e instanceof Error ? e.message : e}`,
-                isError: true,
-            };
-        }
-        const content = typeof raw.content === "string" ? raw.content : "";
-        if (!content.trim()) {
-            return { content: "content must not be empty", isError: true };
-        }
-        try {
-            if (this.stage1) {
-                const id = await appendToStage1(content, this.stage1);
-                return { content: `queued memory for consolidation: ${id}` };
-            }
-            await appendToMemoryMd(this.memoryMdPath, content);
-            return { content: `appended to ${this.memoryMdPath}` };
-        }
-        catch (e) {
-            return {
-                content: `error appending: ${e instanceof Error ? e.message : e}`,
-                isError: true,
-            };
-        }
-    }
-}
-export function createMemoryAppendTool(memoryMdPath, stage1) {
-    return new MemoryAppendTool(memoryMdPath, stage1);
-}
-//# sourceMappingURL=memoryAppend.js.map

package/dist/tools/memoryAppend.js.map

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

package/dist/tools/memoryRecall.d.ts

@@ -1,113 +0,0 @@
-import { createFallbackQuery } from "../fallback/index.js";
-import { type RerankOptions } from "../fallback/llmRerank.js";
-import type { FallbackQuery, MemoryQuerier, QueryIntent, ToolResult } from "../types.js";
-export declare const MEMORY_RECALL_NAME = "memory_recall";
-export declare const MEMORY_RECALL_DESCRIPTION: string;
-export declare const MEMORY_RECALL_PROMPT_SNIPPET = "Query local episodic memory by entity or relationship";
-export declare const MEMORY_RECALL_PROMPT_GUIDELINES: readonly ["Use memory_recall when the user asks about past sessions, people, projects, or decisions stored in long-term memory.", "Use memory_recall for relationship questions (e.g. who is X to me) when implicit preflight did not already answer."];
-export declare const MEMORY_RECALL_PARAMETERS: {
-    readonly type: "object";
-    readonly properties: {
-        readonly mode: {
-            readonly type: "string";
-            readonly enum: readonly ["direct_relation", "path_query", "typed_neighborhood"];
-        };
-        readonly anchor_mentions: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly relation_constraints: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly candidate_type: {
-            readonly type: "string";
-        };
-        readonly scope_filter: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly target_slot: {
-            readonly type: "string";
-            readonly enum: readonly ["head", "tail"];
-        };
-        readonly time_window: {
-            readonly type: "string";
-        };
-        readonly evidence_budget: {
-            readonly type: "integer";
-        };
-        readonly result_limit: {
-            readonly type: "integer";
-        };
-    };
-    readonly required: readonly ["anchor_mentions"];
-};
-export declare class MemoryRecallTool {
-    private readonly service;
-    private readonly fallback;
-    private readonly rerankOpts;
-    constructor(service: MemoryQuerier, fallback?: FallbackQuery | null, rerankOpts?: RerankOptions | null);
-    info(): {
-        name: string;
-        description: string;
-        parameters: {
-            readonly type: "object";
-            readonly properties: {
-                readonly mode: {
-                    readonly type: "string";
-                    readonly enum: readonly ["direct_relation", "path_query", "typed_neighborhood"];
-                };
-                readonly anchor_mentions: {
-                    readonly type: "array";
-                    readonly items: {
-                        readonly type: "string";
-                    };
-                };
-                readonly relation_constraints: {
-                    readonly type: "array";
-                    readonly items: {
-                        readonly type: "string";
-                    };
-                };
-                readonly candidate_type: {
-                    readonly type: "string";
-                };
-                readonly scope_filter: {
-                    readonly type: "array";
-                    readonly items: {
-                        readonly type: "string";
-                    };
-                };
-                readonly target_slot: {
-                    readonly type: "string";
-                    readonly enum: readonly ["head", "tail"];
-                };
-                readonly time_window: {
-                    readonly type: "string";
-                };
-                readonly evidence_budget: {
-                    readonly type: "integer";
-                };
-                readonly result_limit: {
-                    readonly type: "integer";
-                };
-            };
-            readonly required: readonly ["anchor_mentions"];
-        };
-    };
-    run(argsJson: string, signal?: AbortSignal, onProgress?: (msg: string) => void): Promise<ToolResult>;
-    runIntent(intent: QueryIntent, signal?: AbortSignal, onProgress?: (msg: string) => void): Promise<ToolResult>;
-    private fallbackResult;
-}
-/** @deprecated Use createFallbackQuery — kept for backward-compatible imports. */
-export declare function createStubFallback(memoryMdPaths: string[], sessionsDir?: string): FallbackQuery;
-export { createFallbackQuery };
-export declare function createMemoryRecallTool(service: MemoryQuerier, fallback: FallbackQuery | null, rerankOpts?: RerankOptions | null): MemoryRecallTool;
-//# sourceMappingURL=memoryRecall.d.ts.map

package/dist/tools/memoryRecall.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memoryRecall.d.ts","sourceRoot":"","sources":["../../src/tools/memoryRecall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAiB,KAAK,aAAa,EAAqB,MAAM,0BAA0B,CAAC;AAEhG,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAoB,WAAW,EAA+B,UAAU,EAAE,MAAM,aAAa,CAAC;AAExI,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,eAAO,MAAM,yBAAyB,QAM8E,CAAC;AAErH,eAAO,MAAM,4BAA4B,0DACgB,CAAC;AAE1D,eAAO,MAAM,+BAA+B,yPAGlC,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiB3B,CAAC;AAEX,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAFV,OAAO,EAAE,aAAa,EACtB,QAAQ,GAAE,aAAa,GAAG,IAAW,EACrC,UAAU,GAAE,aAAa,GAAG,IAAW;IAG1D,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAepG,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;YAqDrG,cAAc;CAmF7B;AAmKD,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,SAAK,GACf,aAAa,CAEf;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,aAAa,GAAG,IAAI,EAC9B,UAAU,CAAC,EAAE,aAAa,GAAG,IAAI,GAChC,gBAAgB,CAElB"}

package/dist/tools/memoryRecall.js

@@ -1,351 +0,0 @@
-import { createFallbackQuery } from "../fallback/index.js";
-import { rerankWithLLM } from "../fallback/llmRerank.js";
-export const MEMORY_RECALL_NAME = "memory_recall";
-export const MEMORY_RECALL_DESCRIPTION = "Read structured episodic memory from the local TLM sidecar — past sessions consolidated into long-term records.\n" +
-    "Modes:\n" +
-    "- direct_relation: one-hop predicate (e.g. \"what did X create?\"). Read groups[].via_relations.\n" +
-    "- path_query: multi-hop / possessive. relation_constraints is the ordered path; inverse hops use ^-1.\n" +
-    "- typed_neighborhood: typed target with exactly one relation. Requires candidate_type.\n\n" +
-    "Ground answers in supporting evidence internally; tell the user \"past records\" / \"以前的记录\", not raw event IDs.";
-export const MEMORY_RECALL_PROMPT_SNIPPET = "Query local episodic memory by entity or relationship";
-export const MEMORY_RECALL_PROMPT_GUIDELINES = [
-    "Use memory_recall when the user asks about past sessions, people, projects, or decisions stored in long-term memory.",
-    "Use memory_recall for relationship questions (e.g. who is X to me) when implicit preflight did not already answer.",
-];
-export const MEMORY_RECALL_PARAMETERS = {
-    type: "object",
-    properties: {
-        mode: {
-            type: "string",
-            enum: ["direct_relation", "path_query", "typed_neighborhood"],
-        },
-        anchor_mentions: { type: "array", items: { type: "string" } },
-        relation_constraints: { type: "array", items: { type: "string" } },
-        candidate_type: { type: "string" },
-        scope_filter: { type: "array", items: { type: "string" } },
-        target_slot: { type: "string", enum: ["head", "tail"] },
-        time_window: { type: "string" },
-        evidence_budget: { type: "integer" },
-        result_limit: { type: "integer" },
-    },
-    required: ["anchor_mentions"],
-};
-export class MemoryRecallTool {
-    service;
-    fallback;
-    rerankOpts;
-    constructor(service, fallback = null, rerankOpts = null) {
-        this.service = service;
-        this.fallback = fallback;
-        this.rerankOpts = rerankOpts;
-    }
-    info() {
-        return {
-            name: MEMORY_RECALL_NAME,
-            description: MEMORY_RECALL_DESCRIPTION,
-            parameters: MEMORY_RECALL_PARAMETERS,
-        };
-    }
-    async run(argsJson, signal, onProgress) {
-        const args = parseArgs(argsJson);
-        if ("error" in args) {
-            return { content: args.error, isError: true };
-        }
-        const intent = argsToIntent(args);
-        const validation = validateArgs(args);
-        if (validation) {
-            return { content: validation, isError: true };
-        }
-        return this.runIntent(intent, signal, onProgress);
-    }
-    async runIntent(intent, signal, onProgress) {
-        if (this.service.status() !== "ready") {
-            return this.fallbackResult(intent, "service_unavailable", "fallback");
-        }
-        // Emit a progress message if the sidecar takes longer than 500 ms.
-        let progressTimer = null;
-        if (onProgress) {
-            progressTimer = setTimeout(() => {
-                onProgress("Querying episodic memory…");
-            }, 500);
-        }
-        let result;
-        try {
-            result = await this.service.query(intent, signal);
-        }
-        finally {
-            if (progressTimer != null)
-                clearTimeout(progressTimer);
-        }
-        if (result.transportError || result.errorClass === "unavailable") {
-            return this.fallbackResult(intent, "service_unavailable", "fallback");
-        }
-        if (result.errorClass === "retryable") {
-            let retryTimer = null;
-            if (onProgress) {
-                retryTimer = setTimeout(() => onProgress("Retrying memory query…"), 500);
-            }
-            let retryResult;
-            try {
-                await sleep(500, signal);
-                retryResult = await this.service.query(intent, signal);
-            }
-            finally {
-                if (retryTimer != null)
-                    clearTimeout(retryTimer);
-            }
-            if (retryResult.transportError ||
-                retryResult.errorClass === "unavailable" ||
-                retryResult.errorClass === "retryable") {
-                return this.fallbackResult(intent, "retryable_failed", "fallback_after_retry");
-            }
-            result = retryResult;
-        }
-        if (result.errorClass === "permanent") {
-            return permanentResult(result.env);
-        }
-        return shapeResult(result.env);
-    }
-    async fallbackResult(intent, reason, source) {
-        const candidates = [];
-        const warnings = [];
-        if (this.fallback) {
-            const query = intent.anchor_mentions.map((s) => s.trim()).filter(Boolean).join(" ");
-            const limit = intent.result_limit && intent.result_limit > 0 ? intent.result_limit : 10;
-            try {
-                const hits = await this.fallback.sessionKeyword(query, limit);
-                let reranked = null;
-                if (this.rerankOpts && hits.length > 0) {
-                    try {
-                        reranked = await rerankWithLLM(query, hits, this.rerankOpts);
-                    }
-                    catch {
-                        /* silent fallback to original order */
-                    }
-                }
-                if (reranked) {
-                    for (const r of reranked) {
-                        const original = hits[r.index];
-                        candidates.push({
-                            value: r.summary,
-                            score: r.score,
-                            evidence: "llm_rerank",
-                            ...(typeof original === "object" && original !== null &&
-                                "session_id" in original
-                                ? { scope: "session_search", session_id: original.session_id }
-                                : {}),
-                        });
-                    }
-                }
-                else {
-                    for (const h of hits) {
-                        candidates.push({
-                            value: typeof h === "string" ? h : JSON.stringify(h),
-                            evidence: "text_search",
-                            ...(typeof h === "object" &&
-                                h !== null &&
-                                "session_id" in h
-                                ? { scope: "session_search" }
-                                : {}),
-                        });
-                    }
-                }
-            }
-            catch (err) {
-                warnings.push({
-                    code: "fallback_session_search_failed",
-                    message: err instanceof Error ? err.message : String(err),
-                });
-            }
-            try {
-                const snippet = await this.fallback.memoryFileSnippet(query);
-                if (snippet) {
-                    candidates.push({
-                        value: snippet,
-                        evidence: "text_search",
-                        scope: "memory_md",
-                    });
-                }
-            }
-            catch {
-                /* optional */
-            }
-        }
-        const out = {
-            source,
-            evidence_quality: "text_search",
-            bundle_version: null,
-            candidates,
-            warnings,
-            fallback_reason: reason,
-        };
-        return { content: JSON.stringify(out) };
-    }
-}
-function parseArgs(argsJson) {
-    let raw;
-    try {
-        raw = JSON.parse(coerceArgs(argsJson));
-    }
-    catch (e) {
-        return { error: `invalid input: ${e instanceof Error ? e.message : e}` };
-    }
-    const anchor = raw.anchor_mentions;
-    if (!Array.isArray(anchor) || anchor.length === 0) {
-        return { error: "anchor_mentions is required and must be non-empty" };
-    }
-    return raw;
-}
-function argsToIntent(a) {
-    return {
-        mode: a.mode || "direct_relation",
-        anchor_mentions: a.anchor_mentions,
-        relation_constraints: a.relation_constraints,
-        candidate_type: a.candidate_type,
-        scope_filter: a.scope_filter,
-        target_slot: a.target_slot ?? "",
-        time_window: a.time_window,
-        evidence_budget: a.evidence_budget && a.evidence_budget > 0 ? a.evidence_budget : 5,
-        result_limit: a.result_limit && a.result_limit > 0 ? a.result_limit : 10,
-    };
-}
-function validateArgs(a) {
-    for (const rel of a.relation_constraints ?? []) {
-        if (isBroadRelation(rel)) {
-            return "memory_recall requires concrete relation_constraints. Broad relations like related_to are not valid for structured lookup.";
-        }
-    }
-    if (a.mode === "typed_neighborhood") {
-        if (!a.candidate_type?.trim()) {
-            return "typed_neighborhood requires candidate_type.";
-        }
-        if ((a.relation_constraints?.length ?? 0) !== 1) {
-            return "typed_neighborhood requires exactly one relation_constraints value.";
-        }
-    }
-    return null;
-}
-function isBroadRelation(rel) {
-    let r = rel.trim().toLowerCase();
-    r = r.replace(/^\^/, "").replace(/\^-1$/, "");
-    return ["related_to", "relates_to", "associated_with", "about", "mentions", "other"].includes(r);
-}
-function coerceArgs(argsJson) {
-    let raw;
-    try {
-        raw = JSON.parse(argsJson);
-    }
-    catch {
-        return argsJson;
-    }
-    let changed = false;
-    for (const field of ["anchor_mentions", "relation_constraints", "scope_filter"]) {
-        const v = raw[field];
-        if (typeof v === "string") {
-            try {
-                raw[field] = JSON.parse(v);
-                changed = true;
-            }
-            catch {
-                /* keep */
-            }
-        }
-    }
-    for (const field of ["result_limit", "evidence_budget"]) {
-        const v = raw[field];
-        if (typeof v === "string") {
-            const n = Number(v);
-            if (!Number.isNaN(n)) {
-                raw[field] = n;
-                changed = true;
-            }
-        }
-    }
-    return changed ? JSON.stringify(raw) : argsJson;
-}
-function shapeResult(env) {
-    let quality = "structured";
-    const warnings = envelopeWarnings(env);
-    if (env.reason === "degraded") {
-        quality = "structured_degraded";
-        warnings.unshift({
-            code: "bundle_degraded",
-            message: "memory bundle degraded — results may be incomplete",
-        });
-    }
-    const cands = env.candidates.map((c) => {
-        const m = {
-            value: c.value,
-            score: c.score,
-            evidence: c.evidence,
-            supporting_event_ids: c.supporting_event_ids,
-        };
-        if (c.scope != null)
-            m.scope = c.scope;
-        if (c.support_count != null)
-            m.support_count = c.support_count;
-        if (c.distinct_session_count != null) {
-            m.distinct_session_count = c.distinct_session_count;
-        }
-        return m;
-    });
-    const out = {
-        source: "memory_sidecar",
-        evidence_quality: quality,
-        bundle_version: env.bundle_version ?? null,
-        memory_block: env.memory_block ?? null,
-        candidates: cands,
-        warnings,
-        fallback_reason: null,
-    };
-    return { content: JSON.stringify(out) };
-}
-function permanentResult(env) {
-    const out = {
-        source: "memory_sidecar",
-        evidence_quality: "structured",
-        bundle_version: env?.bundle_version ?? null,
-        candidates: [],
-        warnings: envelopeWarnings(env),
-        fallback_reason: null,
-    };
-    return { content: JSON.stringify(out), isError: true };
-}
-function envelopeWarnings(env) {
-    const out = [];
-    if (!env)
-        return out;
-    for (const w of env.warnings ?? []) {
-        out.push({ code: w.code, message: w.message });
-    }
-    if (env.error) {
-        out.push({
-            code: env.error.code,
-            message: env.error.message,
-            sub_code: env.error.details?.sub_code,
-        });
-    }
-    return out;
-}
-function sleep(ms, signal) {
-    return new Promise((resolve, reject) => {
-        if (signal?.aborted) {
-            reject(new Error("aborted"));
-            return;
-        }
-        const t = setTimeout(resolve, ms);
-        signal?.addEventListener("abort", () => {
-            clearTimeout(t);
-            reject(new Error("aborted"));
-        }, { once: true });
-    });
-}
-/** @deprecated Use createFallbackQuery — kept for backward-compatible imports. */
-export function createStubFallback(memoryMdPaths, sessionsDir = "") {
-    return createFallbackQuery({ sessionsDir, memoryMdPaths });
-}
-export { createFallbackQuery };
-export function createMemoryRecallTool(service, fallback, rerankOpts) {
-    return new MemoryRecallTool(service, fallback, rerankOpts ?? null);
-}
-//# sourceMappingURL=memoryRecall.js.map