@roarpeng/graphflow 1.9.13 → 1.9.15

package/dist/learning/dialogue-thread.js

@@ -0,0 +1,419 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DIALOGUE_TURN_SENTINEL = exports.DIALOGUE_SESSION_KIND = exports.DIALOGUE_TURN_KIND = exports.DIALOGUE_SESSION_PREFIX = exports.DIALOGUE_TURN_PREFIX = void 0;
+exports.dialogueSessionIdFor = dialogueSessionIdFor;
+exports.dialogueTurnIdFor = dialogueTurnIdFor;
+exports.isDialogueTurnNode = isDialogueTurnNode;
+exports.isDialogueSessionNode = isDialogueSessionNode;
+exports.parseDialogueTurn = parseDialogueTurn;
+exports.parseDialogueSession = parseDialogueSession;
+exports.recordDialogueTurn = recordDialogueTurn;
+exports.listDialogueTurns = listDialogueTurns;
+exports.loadDialogueThread = loadDialogueThread;
+exports.formatDialogueThreadLines = formatDialogueThreadLines;
+exports.scoreTopicOverlap = scoreTopicOverlap;
+const hash_1 = require("../utils/hash");
+/**
+ * Dialogue threads: each user question (+ optional LLM reply) becomes a
+ * Decision node so a conversation stays a connected graph — sequential turns
+ * AND topic jumps. Clicking a turn means "resume from this node".
+ *
+ * Layout (same Decision + metadata.kind pattern as episodes / goals):
+ *   - session hub: id = dialogue-session:<hash>, kind "dialogue-session"
+ *   - turn:        id = dialogue:<sessionHash>:<seq>, kind "dialogue-turn"
+ *   - edges:       turn -part_of-> session
+ *                  parent -next_section-> turn   (resumeFrom or previous tip)
+ *                  prevTip -co_occurs-> turn     (when the click is a jump)
+ *                  turn -references-> code       (optional L1 anchors)
+ */
+exports.DIALOGUE_TURN_PREFIX = "dialogue:";
+exports.DIALOGUE_SESSION_PREFIX = "dialogue-session:";
+exports.DIALOGUE_TURN_KIND = "dialogue-turn";
+exports.DIALOGUE_SESSION_KIND = "dialogue-session";
+exports.DIALOGUE_TURN_SENTINEL = "dialogue-turn";
+const DEFAULT_SESSION_NAME = "main";
+const DEDUPE_WINDOW_MS = 30 * 60 * 1000;
+const MAX_QUERY_CHARS = 4_000;
+const MAX_REPLY_CHARS = 4_000;
+const MAX_RELATED_CODE = 6;
+const MAX_THREAD_PROMPT_TURNS = 6;
+const MIN_QUERY_CHARS = 4;
+function dialogueSessionIdFor(sessionName, workspaceRoot) {
+    const key = `${normalizeSessionName(sessionName)}|${(workspaceRoot ?? "").trim().toLowerCase()}`;
+    return `${exports.DIALOGUE_SESSION_PREFIX}${(0, hash_1.hashText)(key)}`;
+}
+function dialogueTurnIdFor(sessionId, seq) {
+    const sessionHash = sessionId.startsWith(exports.DIALOGUE_SESSION_PREFIX)
+        ? sessionId.slice(exports.DIALOGUE_SESSION_PREFIX.length)
+        : (0, hash_1.hashText)(sessionId);
+    return `${exports.DIALOGUE_TURN_PREFIX}${sessionHash}:${String(seq).padStart(4, "0")}`;
+}
+function isDialogueTurnNode(node) {
+    return node.metadata?.kind === exports.DIALOGUE_TURN_KIND || node.id.startsWith(exports.DIALOGUE_TURN_PREFIX);
+}
+function isDialogueSessionNode(node) {
+    return node.metadata?.kind === exports.DIALOGUE_SESSION_KIND || node.id.startsWith(exports.DIALOGUE_SESSION_PREFIX);
+}
+function parseDialogueTurn(node) {
+    if (!isDialogueTurnNode(node))
+        return undefined;
+    return deserializeTurn(node);
+}
+function parseDialogueSession(node) {
+    if (!isDialogueSessionNode(node))
+        return undefined;
+    return deserializeSession(node);
+}
+async function recordDialogueTurn(client, input) {
+    const userQuery = clip(input.userQuery, MAX_QUERY_CHARS);
+    const now = input.now ?? Date.now();
+    const sessionName = normalizeSessionName(input.sessionName);
+    const sessionId = dialogueSessionIdFor(sessionName, input.workspaceRoot);
+    const assistantReply = clip(input.assistantReply ?? "", MAX_REPLY_CHARS);
+    const session = (await loadSession(client, sessionId)) ?? {
+        id: sessionId,
+        name: sessionName,
+        turnCount: 0,
+        topicTokens: [],
+        createdAt: now,
+        updatedAt: now,
+    };
+    const existingTurns = await listDialogueTurns(client, { sessionId, limit: 500 });
+    const tip = existingTurns.find((turn) => turn.id === session.tipTurnId) ?? existingTurns[existingTurns.length - 1];
+    if (userQuery.trim().length < MIN_QUERY_CHARS) {
+        if (assistantReply && tip) {
+            const updated = { ...tip, assistantReply, updatedAt: now };
+            await persistTurn(client, updated, session, {
+                linkParent: false,
+                jumped: tip.jumped,
+                relatedNodeIds: mergeRelated(tip.relatedNodeIds, input.relatedNodeIds),
+            });
+            const nextSession = { ...session, tipTurnId: updated.id, updatedAt: now };
+            await persistSession(client, nextSession);
+            return { recorded: true, reused: true, jumped: updated.jumped, turn: updated, session: nextSession };
+        }
+        return { recorded: false, reused: false, jumped: false, skipped: "query-too-short" };
+    }
+    if (tip && shouldReuseTurn(tip, userQuery, now)) {
+        const updated = {
+            ...tip,
+            ...(assistantReply ? { assistantReply } : {}),
+            updatedAt: now,
+        };
+        await persistTurn(client, updated, session, {
+            linkParent: false,
+            jumped: tip.jumped,
+            relatedNodeIds: mergeRelated(tip.relatedNodeIds, input.relatedNodeIds),
+        });
+        const nextSession = {
+            ...session,
+            tipTurnId: updated.id,
+            updatedAt: now,
+            topicTokens: mergeTopicTokens(session.topicTokens, userQuery),
+        };
+        await persistSession(client, nextSession);
+        return { recorded: true, reused: true, jumped: updated.jumped, turn: updated, session: nextSession };
+    }
+    const resumeFrom = input.resumeFromTurnId?.trim() || undefined;
+    const parentTurnId = resumeFrom && existingTurns.some((turn) => turn.id === resumeFrom) ? resumeFrom : tip?.id;
+    const jumped = Boolean(parentTurnId && tip && parentTurnId !== tip.id);
+    const seq = session.turnCount + 1;
+    const turn = {
+        id: dialogueTurnIdFor(sessionId, seq),
+        sessionId,
+        seq,
+        userQuery,
+        assistantReply,
+        ...(parentTurnId ? { parentTurnId } : {}),
+        jumped,
+        relatedNodeIds: uniqueIds(input.relatedNodeIds).slice(0, MAX_RELATED_CODE),
+        createdAt: now,
+        updatedAt: now,
+    };
+    const nextSession = {
+        ...session,
+        tipTurnId: turn.id,
+        turnCount: seq,
+        topicTokens: mergeTopicTokens(session.topicTokens, userQuery),
+        updatedAt: now,
+    };
+    await persistSession(client, nextSession);
+    const previousTipId = jumped ? tip?.id : undefined;
+    await persistTurn(client, turn, nextSession, {
+        linkParent: true,
+        jumped,
+        ...(previousTipId ? { previousTipId } : {}),
+        relatedNodeIds: turn.relatedNodeIds,
+    });
+    return { recorded: true, reused: false, jumped, turn, session: nextSession };
+}
+async function listDialogueTurns(client, options) {
+    const nodes = await collectDialogueNodes(client);
+    const turns = [];
+    for (const node of nodes) {
+        const rec = parseDialogueTurn(node);
+        if (!rec)
+            continue;
+        if (options?.sessionId && rec.sessionId !== options.sessionId)
+            continue;
+        turns.push(rec);
+    }
+    if (options?.sessionId) {
+        turns.sort((a, b) => a.seq - b.seq || a.createdAt - b.createdAt || a.id.localeCompare(b.id));
+    }
+    else {
+        turns.sort((a, b) => b.updatedAt - a.updatedAt || b.seq - a.seq || a.id.localeCompare(b.id));
+    }
+    const limit = options?.limit;
+    if (limit === undefined) {
+        return turns;
+    }
+    const bounded = Math.max(1, limit);
+    if (options?.sessionId) {
+        return turns.slice(Math.max(0, turns.length - bounded));
+    }
+    return turns.slice(0, bounded);
+}
+async function loadDialogueThread(client, options) {
+    const sessionId = options?.sessionId ?? dialogueSessionIdFor(normalizeSessionName(options?.sessionName), options?.workspaceRoot);
+    const session = await loadSession(client, sessionId);
+    if (!session) {
+        return undefined;
+    }
+    const turns = await listDialogueTurns(client, {
+        sessionId,
+        limit: options?.limit ?? MAX_THREAD_PROMPT_TURNS,
+    });
+    if (turns.length === 0) {
+        return undefined;
+    }
+    return {
+        sessionId,
+        sessionName: session.name,
+        ...(session.tipTurnId ? { tipTurnId: session.tipTurnId } : {}),
+        jumped: turns[turns.length - 1]?.jumped === true,
+        overlap: 1,
+        turns,
+        promptLines: formatDialogueThreadLines({
+            sessionId,
+            sessionName: session.name,
+            ...(session.tipTurnId ? { tipTurnId: session.tipTurnId } : {}),
+            jumped: turns[turns.length - 1]?.jumped === true,
+            overlap: 1,
+            turns,
+            promptLines: [],
+        }),
+    };
+}
+function formatDialogueThreadLines(thread) {
+    const lines = [
+        `Thread: ${thread.sessionName} turns=${thread.turns.length}` +
+            (thread.tipTurnId ? ` tip=${thread.tipTurnId}` : "") +
+            (thread.jumped ? " jumped" : " mainline"),
+    ];
+    for (const turn of thread.turns.slice(-MAX_THREAD_PROMPT_TURNS)) {
+        const jumpMark = turn.jumped ? ` jump←${turn.parentTurnId ?? "?"}` : "";
+        const answer = turn.assistantReply.trim() ? clip(turn.assistantReply, 120) : "(pending)";
+        lines.push(`Turn #${turn.seq}${jumpMark} Q: ${clip(turn.userQuery, 80)} | A: ${answer}`);
+    }
+    lines.push(`Resume: graphflow_context({ resumeFromTurnId: "<dialogue turn id>" }) to continue from a clicked turn.`);
+    return lines;
+}
+function scoreTopicOverlap(previousTokens, query) {
+    const next = extractTokens(query);
+    if (previousTokens.length === 0 || next.length === 0) {
+        return 1;
+    }
+    const prev = new Set(previousTokens);
+    let hit = 0;
+    for (const token of next) {
+        if (prev.has(token))
+            hit += 1;
+    }
+    return hit / next.length;
+}
+async function persistTurn(client, turn, session, options) {
+    const related = uniqueIds(options.relatedNodeIds ?? turn.relatedNodeIds).slice(0, MAX_RELATED_CODE);
+    const stored = { ...turn, relatedNodeIds: related };
+    const node = {
+        id: stored.id,
+        type: "Decision",
+        content: compactTurnContent(stored),
+        metadata: {
+            kind: exports.DIALOGUE_TURN_KIND,
+            record: JSON.stringify(stored),
+            seq: stored.seq,
+            sessionId: stored.sessionId,
+            jumped: stored.jumped,
+        },
+    };
+    await client.upsertNodes([node]);
+    const edges = [{ from: stored.id, to: session.id, relation: "part_of" }];
+    if (options.linkParent && stored.parentTurnId) {
+        edges.push({ from: stored.parentTurnId, to: stored.id, relation: "next_section" });
+    }
+    if (options.jumped && options.previousTipId && options.previousTipId !== stored.parentTurnId) {
+        edges.push({ from: options.previousTipId, to: stored.id, relation: "co_occurs" });
+    }
+    for (const relatedId of related) {
+        edges.push({ from: stored.id, to: relatedId, relation: "references" });
+    }
+    await upsertUniqueEdges(client, edges);
+}
+async function persistSession(client, session) {
+    const node = {
+        id: session.id,
+        type: "Decision",
+        content: `dialogue-session ${session.name} turns=${session.turnCount}` +
+            (session.tipTurnId ? ` tip=${session.tipTurnId}` : ""),
+        metadata: {
+            kind: exports.DIALOGUE_SESSION_KIND,
+            record: JSON.stringify(session),
+            name: session.name,
+        },
+    };
+    await client.upsertNodes([node]);
+}
+async function loadSession(client, sessionId) {
+    if (typeof client.getNodesByIds === "function") {
+        const nodes = await client.getNodesByIds([sessionId]);
+        const node = nodes.find((item) => item.id === sessionId);
+        if (node) {
+            return parseDialogueSession(node);
+        }
+    }
+    const nodes = await collectDialogueNodes(client);
+    const node = nodes.find((item) => item.id === sessionId);
+    return node ? parseDialogueSession(node) : undefined;
+}
+async function collectDialogueNodes(client) {
+    const snapshot = client.readSnapshot?.();
+    if (snapshot) {
+        return snapshot.nodes.filter((node) => isDialogueTurnNode(node) || isDialogueSessionNode(node));
+    }
+    const byId = new Map();
+    for (const query of [exports.DIALOGUE_TURN_SENTINEL, "dialogue-session", exports.DIALOGUE_TURN_PREFIX]) {
+        for (const node of await client.queryByKeyword(query)) {
+            if (isDialogueTurnNode(node) || isDialogueSessionNode(node)) {
+                byId.set(node.id, node);
+            }
+        }
+    }
+    return Array.from(byId.values());
+}
+async function upsertUniqueEdges(client, edges) {
+    if (edges.length === 0)
+        return;
+    const snapshot = client.readSnapshot?.();
+    const existing = new Set((snapshot?.edges ?? []).map((edge) => `${edge.from}|${edge.relation}|${edge.to}`));
+    const fresh = edges.filter((edge) => !existing.has(`${edge.from}|${edge.relation}|${edge.to}`));
+    if (fresh.length === 0)
+        return;
+    await client.upsertEdges(fresh);
+}
+function shouldReuseTurn(turn, userQuery, now) {
+    if (now - turn.updatedAt > DEDUPE_WINDOW_MS)
+        return false;
+    return normalizeQuery(turn.userQuery) === normalizeQuery(userQuery);
+}
+function compactTurnContent(turn) {
+    const answer = turn.assistantReply.trim() ? clip(turn.assistantReply, 160) : "(pending)";
+    return `${exports.DIALOGUE_TURN_SENTINEL} #${turn.seq} Q: ${clip(turn.userQuery, 160)} | A: ${answer}`;
+}
+function deserializeTurn(node) {
+    const raw = typeof node.metadata?.record === "string" ? node.metadata.record : undefined;
+    if (!raw)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.id !== "string" || typeof parsed.userQuery !== "string")
+            return undefined;
+        return {
+            id: parsed.id,
+            sessionId: typeof parsed.sessionId === "string" ? parsed.sessionId : "",
+            seq: typeof parsed.seq === "number" ? parsed.seq : 0,
+            userQuery: parsed.userQuery,
+            assistantReply: typeof parsed.assistantReply === "string" ? parsed.assistantReply : "",
+            ...(typeof parsed.parentTurnId === "string" ? { parentTurnId: parsed.parentTurnId } : {}),
+            jumped: parsed.jumped === true,
+            relatedNodeIds: Array.isArray(parsed.relatedNodeIds)
+                ? parsed.relatedNodeIds.filter((id) => typeof id === "string")
+                : [],
+            createdAt: typeof parsed.createdAt === "number" ? parsed.createdAt : 0,
+            updatedAt: typeof parsed.updatedAt === "number" ? parsed.updatedAt : 0,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function deserializeSession(node) {
+    const raw = typeof node.metadata?.record === "string" ? node.metadata.record : undefined;
+    if (!raw)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.id !== "string")
+            return undefined;
+        return {
+            id: parsed.id,
+            name: typeof parsed.name === "string" ? parsed.name : DEFAULT_SESSION_NAME,
+            ...(typeof parsed.tipTurnId === "string" ? { tipTurnId: parsed.tipTurnId } : {}),
+            turnCount: typeof parsed.turnCount === "number" ? parsed.turnCount : 0,
+            topicTokens: Array.isArray(parsed.topicTokens)
+                ? parsed.topicTokens.filter((token) => typeof token === "string")
+                : [],
+            createdAt: typeof parsed.createdAt === "number" ? parsed.createdAt : 0,
+            updatedAt: typeof parsed.updatedAt === "number" ? parsed.updatedAt : 0,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizeSessionName(name) {
+    const trimmed = name?.trim();
+    return trimmed && trimmed.length > 0 ? trimmed.slice(0, 64) : DEFAULT_SESSION_NAME;
+}
+function normalizeQuery(query) {
+    return query.trim().replace(/\s+/g, " ").toLowerCase();
+}
+function clip(text, max) {
+    const normalized = text.replace(/\s+/g, " ").trim();
+    if (normalized.length <= max)
+        return normalized;
+    return `${normalized.slice(0, max - 1)}…`;
+}
+function extractTokens(text) {
+    const out = new Set();
+    for (const raw of text.toLowerCase().split(/[^a-z0-9_\u4e00-\u9fff]+/)) {
+        if (raw.length >= 2)
+            out.add(raw);
+    }
+    return Array.from(out);
+}
+function mergeTopicTokens(existing, query) {
+    const merged = new Set(existing);
+    for (const token of extractTokens(query)) {
+        merged.add(token);
+    }
+    return Array.from(merged).sort().slice(0, 48);
+}
+function uniqueIds(ids) {
+    if (!ids)
+        return [];
+    const seen = new Set();
+    const out = [];
+    for (const id of ids) {
+        const trimmed = id.trim();
+        if (!trimmed || seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        out.push(trimmed);
+    }
+    return out;
+}
+function mergeRelated(current, incoming) {
+    return uniqueIds([...current, ...(incoming ?? [])]).slice(0, MAX_RELATED_CODE);
+}
+//# sourceMappingURL=dialogue-thread.js.map

package/dist/learning/dialogue-thread.js.map

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

package/dist/learning/episodic-memory.d.ts

@@ -1,6 +1,8 @@
 import type { GraphNode } from "../core/types";
 import type { GraphClient } from "../graph/client-factory";
 import { type EmbeddingProvider } from "./embeddings";
+import { quarantineSkillsFromEpisode } from "./workflow-skill";
+export { quarantineSkillsFromEpisode };
 export interface EpisodeRecord {
     id: string;
     task: string;
@@ -36,6 +38,20 @@ export declare function recordEpisode(client: GraphClient, episode: Omit<Episode
  * whether execution succeeded, optionally providing lessons learned.
  */
 export declare function updateEpisodeOutcome(client: GraphClient, episodeId: string, outcome: "pass" | "fail", lessons?: string[], deviation?: DeviationKind): Promise<EpisodeRecord | undefined>;
+/**
+ * Load a single episode record (including its plan) by node id.
+ */
+export declare function loadEpisode(client: GraphClient, episodeId: string): Promise<EpisodeRecord | undefined>;
+/**
+ * Forget one episode: quarantine descendant skills (SkillJack hide, not
+ * delete), then mark the episode pruned so it stays auditable.
+ */
+export declare function forgetEpisode(client: GraphClient, episodeId: string): Promise<{
+    found: boolean;
+    hidden: number;
+    ids: string[];
+    pruned: boolean;
+}>;
 export declare function findSimilarEpisodes(client: GraphClient, task: string, limit?: number, embeddingProvider?: EmbeddingProvider): Promise<EpisodeRecord[]>;
 export declare function loadAllEpisodes(client: GraphClient): Promise<EpisodeRecord[]>;
 export declare function summarizeEpisodeForPrompt(episode: EpisodeRecord, client?: GraphClient): Promise<string>;

package/dist/learning/episodic-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"episodic-memory.d.ts","sourceRoot":"","sources":["../../src/learning/episodic-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IACtD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,0EAA0E;AAC1E,eAAO,MAAM,eAAe,uEAKlB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAOD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOxD;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,EAC9D,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,aAAa,CAAC,CAyCxB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,SAAS,CAAC,EAAE,aAAa,GACxB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CA0BpC;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAI,EACT,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,aAAa,EAAE,CAAC,CAqE1B;AAgCD,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAGnF;AA8BD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAwBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,aAAa,EAAE,CAcjE;AA2CD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAyD7B;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAatF"}
+{"version":3,"file":"episodic-memory.d.ts","sourceRoot":"","sources":["../../src/learning/episodic-memory.ts"],"names":[],"mappings":"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"}

package/dist/learning/episodic-memory.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEVIATION_KINDS = void 0;
+exports.DEVIATION_KINDS = exports.quarantineSkillsFromEpisode = void 0;
 exports.isDeviationKind = isDeviationKind;
 exports.extractTaskTokens = extractTaskTokens;
 exports.recordEpisode = recordEpisode;
 exports.updateEpisodeOutcome = updateEpisodeOutcome;
+exports.loadEpisode = loadEpisode;
+exports.forgetEpisode = forgetEpisode;
 exports.findSimilarEpisodes = findSimilarEpisodes;
 exports.loadAllEpisodes = loadAllEpisodes;
 exports.summarizeEpisodeForPrompt = summarizeEpisodeForPrompt;
@@ -13,6 +15,8 @@ exports.pruneExpiredEpisodes = pruneExpiredEpisodes;
 exports.forgetEpisodes = forgetEpisodes;
 const hash_1 = require("../utils/hash");
 const embeddings_1 = require("./embeddings");
+const workflow_skill_1 = require("./workflow-skill");
+Object.defineProperty(exports, "quarantineSkillsFromEpisode", { enumerable: true, get: function () { return workflow_skill_1.quarantineSkillsFromEpisode; } });
 /** Drift taxonomy shared by alignment-check submit and outcome report. */
 exports.DEVIATION_KINDS = [
     "none",
@@ -106,8 +110,64 @@ async function updateEpisodeOutcome(client, episodeId, outcome, lessons, deviati
         metadata: { ...node.metadata, record: serialize(updated) },
     };
     await client.upsertNodes([updatedNode]);
+    if (outcome === "pass" && updated.plan.length >= 2) {
+        try {
+            await (0, workflow_skill_1.distillWorkflowFromEpisode)(client, updated);
+        }
+        catch {
+            // Distillation must never block outcome reporting.
+        }
+    }
     return updated;
 }
+/**
+ * Load a single episode record (including its plan) by node id.
+ */
+async function loadEpisode(client, episodeId) {
+    const node = await loadEpisodeNode(client, episodeId);
+    if (!node)
+        return undefined;
+    return deserialize(node);
+}
+/**
+ * Forget one episode: quarantine descendant skills (SkillJack hide, not
+ * delete), then mark the episode pruned so it stays auditable.
+ */
+async function forgetEpisode(client, episodeId) {
+    const { hidden, ids } = await (0, workflow_skill_1.quarantineSkillsFromEpisode)(client, episodeId);
+    const node = await loadEpisodeNode(client, episodeId);
+    if (!node) {
+        return { found: false, hidden, ids, pruned: false };
+    }
+    const rec = deserialize(node);
+    const lessons = rec
+        ? ["forgotten", ...rec.lessons.filter((lesson) => lesson !== "forgotten")].slice(0, 4)
+        : ["forgotten"];
+    const updatedRecord = rec
+        ? { ...rec, lessons, updatedAt: Date.now() }
+        : undefined;
+    await client.upsertNodes([
+        {
+            ...node,
+            metadata: {
+                ...node.metadata,
+                pruned: true,
+                ...(updatedRecord ? { record: serialize(updatedRecord) } : {}),
+            },
+        },
+    ]);
+    return { found: true, hidden, ids, pruned: true };
+}
+async function loadEpisodeNode(client, episodeId) {
+    if (client.getNodesByIds) {
+        const nodes = await client.getNodesByIds([episodeId]);
+        const node = nodes.find((candidate) => candidate.id === episodeId);
+        if (node && isEpisodeNode(node))
+            return node;
+    }
+    const hits = await client.queryByKeyword(episodeId);
+    return hits.find((candidate) => candidate.id === episodeId && isEpisodeNode(candidate));
+}
 async function findSimilarEpisodes(client, task, limit = 3, embeddingProvider) {
     const queryTokens = new Set(extractTaskTokens(task));
     const candidateNodes = await collectEpisodeCandidates(client, task, Array.from(queryTokens));