@chendpoc/pi-memory 0.1.0

package/dist/tools/memoryRecall.js

@@ -0,0 +1,325 @@
+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) {
+        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);
+    }
+    async runIntent(intent, signal) {
+        if (this.service.status() !== "ready") {
+            return this.fallbackResult(intent, "service_unavailable", "fallback");
+        }
+        let result = await this.service.query(intent, signal);
+        if (result.transportError || result.errorClass === "unavailable") {
+            return this.fallbackResult(intent, "service_unavailable", "fallback");
+        }
+        if (result.errorClass === "retryable") {
+            await sleep(500, signal);
+            result = await this.service.query(intent, signal);
+            if (result.transportError ||
+                result.errorClass === "unavailable" ||
+                result.errorClass === "retryable") {
+                return this.fallbackResult(intent, "retryable_failed", "fallback_after_retry");
+            }
+        }
+        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

package/dist/tools/memoryRecall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryRecall.js","sourceRoot":"","sources":["../../src/tools/memoryRecall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAyC,MAAM,0BAA0B,CAAC;AAIhG,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD,MAAM,CAAC,MAAM,yBAAyB,GACpC,mHAAmH;IACnH,UAAU;IACV,oGAAoG;IACpG,yGAAyG;IACzG,4FAA4F;IAC5F,kHAAkH,CAAC;AAErH,MAAM,CAAC,MAAM,4BAA4B,GACvC,uDAAuD,CAAC;AAE1D,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,sHAAsH;IACtH,oHAAoH;CAC5G,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,CAAC;SAC9D;QACD,eAAe,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC7D,oBAAoB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAClE,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClC,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC1D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;QACvD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,eAAe,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QACpC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;KAClC;IACD,QAAQ,EAAE,CAAC,iBAAiB,CAAC;CACrB,CAAC;AAEX,MAAM,OAAO,gBAAgB;IAER;IACA;IACA;IAHnB,YACmB,OAAsB,EACtB,WAAiC,IAAI,EACrC,aAAmC,IAAI;QAFvC,YAAO,GAAP,OAAO,CAAe;QACtB,aAAQ,GAAR,QAAQ,CAA6B;QACrC,eAAU,GAAV,UAAU,CAA6B;IACvD,CAAC;IAEJ,IAAI;QACF,OAAO;YACL,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,yBAAyB;YACtC,UAAU,EAAE,wBAAwB;SACrC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,MAAoB;QAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChD,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAChD,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAmB,EAAE,MAAoB;QACvD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,OAAO,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,qBAAqB,EAAE,UAAU,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,UAAU,KAAK,aAAa,EAAE,CAAC;YACjE,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,qBAAqB,EAAE,UAAU,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;YACtC,MAAM,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACzB,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAClD,IACE,MAAM,CAAC,cAAc;gBACrB,MAAM,CAAC,UAAU,KAAK,aAAa;gBACnC,MAAM,CAAC,UAAU,KAAK,WAAW,EACjC,CAAC;gBACD,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,kBAAkB,EAAE,sBAAsB,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;YACtC,OAAO,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,WAAW,CAAC,MAAM,CAAC,GAAI,CAAC,CAAC;IAClC,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,MAAmB,EACnB,MAAc,EACd,MAAc;QAEd,MAAM,UAAU,GAA8B,EAAE,CAAC;QACjD,MAAM,QAAQ,GAA8B,EAAE,CAAC;QAE/C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpF,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAE9D,IAAI,QAAQ,GAA0B,IAAI,CAAC;gBAC3C,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvC,IAAI,CAAC;wBACH,QAAQ,GAAG,MAAM,aAAa,CAC5B,KAAK,EACL,IAA0B,EAC1B,IAAI,CAAC,UAAU,CAChB,CAAC;oBACJ,CAAC;oBAAC,MAAM,CAAC;wBACP,uCAAuC;oBACzC,CAAC;gBACH,CAAC;gBAED,IAAI,QAAQ,EAAE,CAAC;oBACb,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;wBACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;wBAC/B,UAAU,CAAC,IAAI,CAAC;4BACd,KAAK,EAAE,CAAC,CAAC,OAAO;4BAChB,KAAK,EAAE,CAAC,CAAC,KAAK;4BACd,QAAQ,EAAE,YAAY;4BACtB,GAAG,CAAC,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI;gCACnD,YAAY,IAAK,QAAoC;gCACrD,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAG,QAAoC,CAAC,UAAU,EAAE;gCAC3F,CAAC,CAAC,EAAE,CAAC;yBACR,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;wBACrB,UAAU,CAAC,IAAI,CAAC;4BACd,KAAK,EAAE,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;4BACpD,QAAQ,EAAE,aAAa;4BACvB,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ;gCACzB,CAAC,KAAK,IAAI;gCACV,YAAY,IAAK,CAA6B;gCAC5C,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE;gCAC7B,CAAC,CAAC,EAAE,CAAC;yBACR,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,gCAAgC;oBACtC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC1D,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;gBAC7D,IAAI,OAAO,EAAE,CAAC;oBACZ,UAAU,CAAC,IAAI,CAAC;wBACd,KAAK,EAAE,OAAO;wBACd,QAAQ,EAAE,aAAa;wBACvB,KAAK,EAAE,WAAW;qBACnB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG;YACV,MAAM;YACN,gBAAgB,EAAE,aAAa;YAC/B,cAAc,EAAE,IAAI;YACpB,UAAU;YACV,QAAQ;YACR,eAAe,EAAE,MAAM;SACxB,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1C,CAAC;CACF;AAED,SAAS,SAAS,CAAC,QAAgB;IACjC,IAAI,GAA4B,CAAC;IACjC,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAA4B,CAAC;IACpE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,KAAK,EAAE,kBAAkB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC3E,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,mDAAmD,EAAE,CAAC;IACxE,CAAC;IACD,OAAO,GAAkC,CAAC;AAC5C,CAAC;AAED,SAAS,YAAY,CAAC,CAAmB;IACvC,OAAO;QACL,IAAI,EAAG,CAAC,CAAC,IAAkB,IAAI,iBAAiB;QAChD,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,oBAAoB,EAAE,CAAC,CAAC,oBAAoB;QAC5C,cAAc,EAAE,CAAC,CAAC,cAAc;QAChC,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,WAAW,EAAG,CAAC,CAAC,WAA0C,IAAI,EAAE;QAChE,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACnF,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;KACzE,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,CAAmB;IACvC,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,oBAAoB,IAAI,EAAE,EAAE,CAAC;QAC/C,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,4HAA4H,CAAC;QACtI,CAAC;IACH,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;QACpC,IAAI,CAAC,CAAC,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC;YAC9B,OAAO,6CAA6C,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,CAAC,CAAC,oBAAoB,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,OAAO,qEAAqE,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACnG,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IAClC,IAAI,GAA4B,CAAC;IACjC,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAA4B,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,KAAK,IAAI,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,cAAc,CAAC,EAAE,CAAC;QAChF,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC3B,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrB,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACf,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClD,CAAC;AAED,SAAS,WAAW,CAAC,GAAqB;IACxC,IAAI,OAAO,GAAG,YAAY,CAAC;IAC3B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO,GAAG,qBAAqB,CAAC;QAChC,QAAQ,CAAC,OAAO,CAAC;YACf,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,oDAAoD;SAC9D,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACrC,MAAM,CAAC,GAA4B;YACjC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,oBAAoB,EAAE,CAAC,CAAC,oBAAoB;SAC7C,CAAC;QACF,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI;YAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QACvC,IAAI,CAAC,CAAC,aAAa,IAAI,IAAI;YAAE,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC;QAC/D,IAAI,CAAC,CAAC,sBAAsB,IAAI,IAAI,EAAE,CAAC;YACrC,CAAC,CAAC,sBAAsB,GAAG,CAAC,CAAC,sBAAsB,CAAC;QACtD,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,GAAG;QACV,MAAM,EAAE,gBAAgB;QACxB,gBAAgB,EAAE,OAAO;QACzB,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI;QAC1C,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;QACtC,UAAU,EAAE,KAAK;QACjB,QAAQ;QACR,eAAe,EAAE,IAAI;KACtB,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,eAAe,CAAC,GAA4B;IACnD,MAAM,GAAG,GAAG;QACV,MAAM,EAAE,gBAAgB;QACxB,gBAAgB,EAAE,YAAY;QAC9B,cAAc,EAAE,GAAG,EAAE,cAAc,IAAI,IAAI;QAC3C,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,gBAAgB,CAAC,GAAG,CAAC;QAC/B,eAAe,EAAE,IAAI;KACtB,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,gBAAgB,CAAC,GAA4B;IACpD,MAAM,GAAG,GAA8B,EAAE,CAAC;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACnC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI;YACpB,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO;YAC1B,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ;SACtC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAClC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACrC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/B,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,kBAAkB,CAChC,aAAuB,EACvB,WAAW,GAAG,EAAE;IAEhB,OAAO,mBAAmB,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,MAAM,UAAU,sBAAsB,CACpC,OAAsB,EACtB,QAA8B,EAC9B,UAAiC;IAEjC,OAAO,IAAI,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC;AACrE,CAAC"}

package/dist/trainer/bundleBuilder.d.ts

@@ -0,0 +1,30 @@
+import type { ResolvedGraph } from "./entityResolver.js";
+import type { ExtractedEvent } from "./extractFacts.js";
+import type { BundleManifest } from "../sidecar/bundle.js";
+export interface BundleData {
+    graph: ResolvedGraph;
+    events: ExtractedEvent[];
+}
+export interface BuildBundleOptions {
+    outputDir: string;
+    bundleVersion?: string;
+}
+export interface BuildBundleResult {
+    bundleDir: string;
+    manifest: BundleManifest;
+    stats: {
+        entityCount: number;
+        edgeCount: number;
+        eventCount: number;
+    };
+}
+/**
+ * Build a TLM-compatible bundle directory from resolved graph + events.
+ *
+ * Produces:
+ *   <outputDir>/bundles/<iso-ts>/
+ *     manifest.json
+ *     graph.json      — entities, edges, events
+ */
+export declare function buildBundle(data: BundleData, opts: BuildBundleOptions): Promise<BuildBundleResult>;
+//# sourceMappingURL=bundleBuilder.d.ts.map

package/dist/trainer/bundleBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleBuilder.d.ts","sourceRoot":"","sources":["../../src/trainer/bundleBuilder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAoC,MAAM,qBAAqB,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,sBAAsB,CAAC;AAE/E,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AA4GD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CA8C5B"}

package/dist/trainer/bundleBuilder.js

@@ -0,0 +1,106 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+function eventId(ev, idx) {
+    const hash = createHash("sha256")
+        .update(`${ev.sessionId}:${ev.turnIndex}:${idx}`)
+        .digest("hex")
+        .slice(0, 12);
+    return `ev_${hash}`;
+}
+function distinctSessions(ent) {
+    const s = new Set(ent.mentions.map((m) => m.sessionId));
+    return s.size;
+}
+function buildGraphData(graph, events) {
+    const eventRecords = events.map((ev, i) => ({
+        event_id: eventId(ev, i),
+        description: ev.description,
+        session_id: ev.sessionId,
+        timestamp: ev.timestamp,
+    }));
+    const eventsBySession = new Map();
+    for (const ev of eventRecords) {
+        let arr = eventsBySession.get(ev.session_id);
+        if (!arr) {
+            arr = [];
+            eventsBySession.set(ev.session_id, arr);
+        }
+        arr.push(ev.event_id);
+    }
+    const entities = graph.entities.map((ent) => ({
+        entity_id: ent.id,
+        label: ent.canonicalName,
+        type: ent.type,
+        aliases: ent.aliases,
+        mention_count: ent.mentions.length,
+        distinct_session_count: distinctSessions(ent),
+    }));
+    const edges = graph.relations.map((rel) => {
+        const evIds = eventsBySession.get(rel.sessionId) ?? [];
+        return {
+            head_entity_id: rel.headEntityId,
+            relation: rel.relation,
+            tail_entity_id: rel.tailEntityId,
+            supporting_event_ids: evIds.slice(0, 5),
+            evidence: rel.evidence,
+        };
+    });
+    return { entities, edges, events: eventRecords };
+}
+async function writeJsonFile(dir, filename, data) {
+    const content = JSON.stringify(data, null, 2) + "\n";
+    const filePath = path.join(dir, filename);
+    await fs.writeFile(filePath, content, "utf8");
+    const sha256 = createHash("sha256").update(content).digest("hex");
+    return {
+        path: filename,
+        size: Buffer.byteLength(content, "utf8"),
+        sha256,
+    };
+}
+/**
+ * Build a TLM-compatible bundle directory from resolved graph + events.
+ *
+ * Produces:
+ *   <outputDir>/bundles/<iso-ts>/
+ *     manifest.json
+ *     graph.json      — entities, edges, events
+ */
+export async function buildBundle(data, opts) {
+    const bundleTs = new Date()
+        .toISOString()
+        .replace(/[:.]/g, "-");
+    const bundleVersion = opts.bundleVersion ?? "0.6.0";
+    const bundlesDir = path.join(opts.outputDir, "bundles");
+    const bundleDir = path.join(bundlesDir, bundleTs);
+    await fs.mkdir(bundleDir, { recursive: true, mode: 0o700 });
+    const graphData = buildGraphData(data.graph, data.events);
+    const files = [];
+    const graphFile = await writeJsonFile(bundleDir, "graph.json", graphData);
+    files.push(graphFile);
+    const totalSize = files.reduce((sum, f) => sum + f.size, 0);
+    const integrityInput = files.map((f) => f.sha256).join(":");
+    const integritySha256 = createHash("sha256")
+        .update(integrityInput)
+        .digest("hex");
+    const manifest = {
+        bundle_ts: bundleTs,
+        bundle_version: bundleVersion,
+        size_bytes: totalSize,
+        integrity_sha256: integritySha256,
+        files,
+    };
+    const manifestContent = JSON.stringify(manifest, null, 2) + "\n";
+    await fs.writeFile(path.join(bundleDir, "manifest.json"), manifestContent, "utf8");
+    return {
+        bundleDir,
+        manifest,
+        stats: {
+            entityCount: graphData.entities.length,
+            edgeCount: graphData.edges.length,
+            eventCount: graphData.events.length,
+        },
+    };
+}
+//# sourceMappingURL=bundleBuilder.js.map

package/dist/trainer/bundleBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleBuilder.js","sourceRoot":"","sources":["../../src/trainer/bundleBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AA4C7B,SAAS,OAAO,CAAC,EAAkB,EAAE,GAAW;IAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;SAChD,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,MAAM,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAmB;IAC3C,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,CAAC,IAAI,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CACrB,KAAoB,EACpB,MAAwB;IAExB,MAAM,YAAY,GAAkB,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACzD,QAAQ,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACxB,WAAW,EAAE,EAAE,CAAC,WAAW;QAC3B,UAAU,EAAE,EAAE,CAAC,SAAS;QACxB,SAAS,EAAE,EAAE,CAAC,SAAS;KACxB,CAAC,CAAC,CAAC;IAEJ,MAAM,eAAe,GAAG,IAAI,GAAG,EAAoB,CAAC;IACpD,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,IAAI,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,EAAE,CAAC;YACT,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,QAAQ,GAAmB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5D,SAAS,EAAE,GAAG,CAAC,EAAE;QACjB,KAAK,EAAE,GAAG,CAAC,aAAa;QACxB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM;QAClC,sBAAsB,EAAE,gBAAgB,CAAC,GAAG,CAAC;KAC9C,CAAC,CAAC,CAAC;IAEJ,MAAM,KAAK,GAAiB,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtD,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACvD,OAAO;YACL,cAAc,EAAE,GAAG,CAAC,YAAY;YAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,cAAc,EAAE,GAAG,CAAC,YAAY;YAChC,oBAAoB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACvC,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AACnD,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,GAAW,EACX,QAAgB,EAChB,IAAa;IAEb,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC;QACxC,MAAM;KACP,CAAC;AACJ,CAAC;AAiBD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAgB,EAChB,IAAwB;IAExB,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE;SACxB,WAAW,EAAE;SACb,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACzB,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC;IAEpD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAE5D,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAyB,EAAE,CAAC;IAEvC,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEtB,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5D,MAAM,eAAe,GAAG,UAAU,CAAC,QAAQ,CAAC;SACzC,MAAM,CAAC,cAAc,CAAC;SACtB,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjB,MAAM,QAAQ,GAAmB;QAC/B,SAAS,EAAE,QAAQ;QACnB,cAAc,EAAE,aAAa;QAC7B,UAAU,EAAE,SAAS;QACrB,gBAAgB,EAAE,eAAe;QACjC,KAAK;KACN,CAAC;IAEF,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACjE,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EACrC,eAAe,EACf,MAAM,CACP,CAAC;IAEF,OAAO;QACL,SAAS;QACT,QAAQ;QACR,KAAK,EAAE;YACL,WAAW,EAAE,SAAS,CAAC,QAAQ,CAAC,MAAM;YACtC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM;YACjC,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM;SACpC;KACF,CAAC;AACJ,CAAC"}

package/dist/trainer/bundleLoader.d.ts

@@ -0,0 +1,12 @@
+import type { ResolvedGraph } from "./entityResolver.js";
+import type { ExtractedEvent } from "./extractFacts.js";
+export interface ExistingBundle {
+    graph: ResolvedGraph;
+    events: ExtractedEvent[];
+}
+/**
+ * Load the existing bundle's graph.json from `<bundleRoot>/current/graph.json`.
+ * Returns null when no current bundle exists or graph.json is missing/unparseable.
+ */
+export declare function loadExistingBundle(bundleRoot: string): Promise<ExistingBundle | null>;
+//# sourceMappingURL=bundleLoader.d.ts.map

package/dist/trainer/bundleLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleLoader.d.ts","sourceRoot":"","sources":["../../src/trainer/bundleLoader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoC,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,mBAAmB,CAAC;AA0CpE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA+ChC"}

package/dist/trainer/bundleLoader.js

@@ -0,0 +1,59 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+const VALID_ENTITY_TYPES = new Set([
+    "Person", "Company", "Organization", "Project", "Tool",
+    "Language", "Concept", "Document", "File", "Location",
+    "Product", "Website", "Platform", "Unknown",
+]);
+function toEntityType(t) {
+    return VALID_ENTITY_TYPES.has(t) ? t : "Unknown";
+}
+/**
+ * Load the existing bundle's graph.json from `<bundleRoot>/current/graph.json`.
+ * Returns null when no current bundle exists or graph.json is missing/unparseable.
+ */
+export async function loadExistingBundle(bundleRoot) {
+    const graphPath = path.join(bundleRoot, "current", "graph.json");
+    let raw;
+    try {
+        raw = await fs.readFile(graphPath, "utf8");
+    }
+    catch {
+        return null;
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!data.entities || !data.edges)
+        return null;
+    const entities = (data.entities ?? []).map((e) => ({
+        id: e.entity_id,
+        canonicalName: e.label,
+        type: toEntityType(e.type),
+        aliases: e.aliases ?? [],
+        mentions: [],
+    }));
+    const relations = (data.edges ?? []).map((e) => ({
+        headEntityId: e.head_entity_id,
+        relation: e.relation,
+        tailEntityId: e.tail_entity_id,
+        sessionId: "",
+        turnIndex: 0,
+        evidence: e.evidence ?? "",
+    }));
+    const events = (data.events ?? []).map((e) => ({
+        description: e.description,
+        sessionId: e.session_id,
+        timestamp: e.timestamp,
+        turnIndex: 0,
+    }));
+    return {
+        graph: { entities, relations },
+        events,
+    };
+}
+//# sourceMappingURL=bundleLoader.js.map

package/dist/trainer/bundleLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleLoader.js","sourceRoot":"","sources":["../../src/trainer/bundleLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAmC7B,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAS;IACzC,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM;IACtD,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;IACrD,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS;CAC5C,CAAC,CAAC;AAEH,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC;AAOD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAkB;IAElB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IAEjE,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,IAAmB,CAAC;IACxB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAE/C,MAAM,QAAQ,GAAqB,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnE,EAAE,EAAE,CAAC,CAAC,SAAS;QACf,aAAa,EAAE,CAAC,CAAC,KAAK;QACtB,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1B,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;QACxB,QAAQ,EAAE,EAAE;KACb,CAAC,CAAC,CAAC;IAEJ,MAAM,SAAS,GAAuB,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnE,YAAY,EAAE,CAAC,CAAC,cAAc;QAC9B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,YAAY,EAAE,CAAC,CAAC,cAAc;QAC9B,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;KAC3B,CAAC,CAAC,CAAC;IAEJ,MAAM,MAAM,GAAqB,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,SAAS,EAAE,CAAC;KACb,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE;QAC9B,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/trainer/deltaMerge.d.ts

@@ -0,0 +1,38 @@
+import type { ResolvedGraph } from "./entityResolver.js";
+import type { ExtractedEvent } from "./extractFacts.js";
+export type DeltaOp = "add" | "update" | "delete" | "skip";
+export interface DeltaLogEntry {
+    op: DeltaOp;
+    kind: "entity" | "edge" | "event";
+    detail: string;
+}
+export interface DeltaLog {
+    entries: DeltaLogEntry[];
+    added: number;
+    updated: number;
+    deleted: number;
+    skipped: number;
+}
+export interface MergeResult {
+    graph: ResolvedGraph;
+    events: ExtractedEvent[];
+    delta: DeltaLog;
+}
+/**
+ * Merge new extracted graph + events into an existing bundle graph,
+ * producing a combined result with delta operation log.
+ *
+ * Operations:
+ * - SKIP: entity+relation+tail already present with same value
+ * - ADD: genuinely new entity/edge/event
+ * - UPDATE: same head+relation but different tail, with update signal in evidence
+ * - DELETE: negated relation matches existing edge
+ */
+export declare function deltaMerge(existing: {
+    graph: ResolvedGraph;
+    events: ExtractedEvent[];
+}, incoming: {
+    graph: ResolvedGraph;
+    events: ExtractedEvent[];
+}): MergeResult;
+//# sourceMappingURL=deltaMerge.d.ts.map

package/dist/trainer/deltaMerge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deltaMerge.d.ts","sourceRoot":"","sources":["../../src/trainer/deltaMerge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAoC,MAAM,qBAAqB,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAUD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,EAC5D,QAAQ,EAAE;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,GAC3D,WAAW,CA6Kb"}