@actalk/inkos-core 0.5.1 → 0.6.0

package/dist/utils/length-metrics.js

@@ -0,0 +1,85 @@
+const REFERENCE_TARGET = 2200;
+const SOFT_RANGE_DELTA = 300;
+const HARD_RANGE_DELTA = 600;
+export function countChapterLength(content, countingMode) {
+    const normalized = stripMarkdownMetadata(content);
+    if (countingMode === "en_words") {
+        const words = normalized.match(/[A-Za-z0-9]+(?:'[A-Za-z0-9]+)?/g);
+        return words?.length ?? 0;
+    }
+    return normalized.replace(/\s+/g, "").length;
+}
+export function resolveLengthCountingMode(language = "zh") {
+    return language === "en" ? "en_words" : "zh_chars";
+}
+export function formatLengthCount(count, countingMode) {
+    return countingMode === "en_words" ? `${count} words` : `${count}字`;
+}
+export function buildLengthSpec(target, language = "zh") {
+    const softDelta = scaleRangeDelta(target, SOFT_RANGE_DELTA);
+    const hardDelta = Math.max(softDelta, scaleRangeDelta(target, HARD_RANGE_DELTA));
+    const softMin = Math.max(1, target - softDelta);
+    const softMax = target + softDelta;
+    const hardMin = Math.max(1, target - hardDelta);
+    const hardMax = target + hardDelta;
+    return {
+        target,
+        softMin,
+        softMax,
+        hardMin,
+        hardMax,
+        countingMode: resolveLengthCountingMode(language),
+        normalizeMode: "none",
+    };
+}
+function scaleRangeDelta(target, referenceDelta) {
+    return Math.max(1, Math.floor((target * referenceDelta) / REFERENCE_TARGET));
+}
+export function isOutsideSoftRange(count, spec) {
+    return count < spec.softMin || count > spec.softMax;
+}
+export function isOutsideHardRange(count, spec) {
+    return count < spec.hardMin || count > spec.hardMax;
+}
+export function chooseNormalizeMode(count, spec) {
+    if (count < spec.softMin)
+        return "expand";
+    if (count > spec.softMax)
+        return "compress";
+    return "none";
+}
+function stripMarkdownMetadata(content) {
+    const lines = content.replace(/\r\n/g, "\n").replace(/^\uFEFF/, "").split("\n");
+    const proseLines = [];
+    let index = 0;
+    if (lines[index]?.trim() === "---") {
+        index += 1;
+        while (index < lines.length && lines[index]?.trim() !== "---") {
+            index += 1;
+        }
+        if (index < lines.length) {
+            index += 1;
+        }
+    }
+    let inFence = false;
+    for (; index < lines.length; index += 1) {
+        const line = lines[index] ?? "";
+        const trimmed = line.trim();
+        if (/^(```|~~~)/.test(trimmed)) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence) {
+            continue;
+        }
+        if (/^#{1,6}\s+/.test(trimmed)) {
+            continue;
+        }
+        if (trimmed === "---" || trimmed === "...") {
+            continue;
+        }
+        proseLines.push(line);
+    }
+    return proseLines.join("\n");
+}
+//# sourceMappingURL=length-metrics.js.map

package/dist/utils/length-metrics.js.map

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

package/dist/utils/long-span-fatigue.d.ts

@@ -0,0 +1,28 @@
+export interface LongSpanFatigueIssue {
+    readonly severity: "warning";
+    readonly category: string;
+    readonly description: string;
+    readonly suggestion: string;
+}
+export interface AnalyzeLongSpanFatigueInput {
+    readonly bookDir: string;
+    readonly chapterNumber: number;
+    readonly chapterContent: string;
+    readonly chapterSummary?: string;
+    readonly language?: "zh" | "en";
+}
+export interface EnglishVarianceBrief {
+    readonly highFrequencyPhrases: ReadonlyArray<string>;
+    readonly repeatedOpeningPatterns: ReadonlyArray<string>;
+    readonly repeatedEndingShapes: ReadonlyArray<string>;
+    readonly sceneObligation: string;
+    readonly text: string;
+}
+export declare function buildEnglishVarianceBrief(params: {
+    readonly bookDir: string;
+    readonly chapterNumber: number;
+}): Promise<EnglishVarianceBrief | null>;
+export declare function analyzeLongSpanFatigue(input: AnalyzeLongSpanFatigueInput): Promise<{
+    readonly issues: ReadonlyArray<LongSpanFatigueIssue>;
+}>;
+//# sourceMappingURL=long-span-fatigue.d.ts.map

package/dist/utils/long-span-fatigue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-span-fatigue.d.ts","sourceRoot":"","sources":["../../src/utils/long-span-fatigue.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,uBAAuB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxD,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAaD,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAiCvC;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;CAAE,CAAC,CAiCnE"}

package/dist/utils/long-span-fatigue.js

@@ -0,0 +1,359 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+const SENTENCE_SIMILARITY_THRESHOLD = 0.72;
+const CHINESE_PUNCTUATION = /[，。！？；：“”‘’（）《》、\s\-—…·]/g;
+const ENGLISH_PUNCTUATION = /[^a-z0-9]+/gi;
+export async function buildEnglishVarianceBrief(params) {
+    const chapterBodies = await loadPreviousChapterBodies(params.bookDir, params.chapterNumber, 24);
+    if (chapterBodies.length < 2) {
+        return null;
+    }
+    const summaryRows = await loadSummaryRows(join(params.bookDir, "story", "chapter_summaries.md"));
+    const recentRows = summaryRows
+        .filter((row) => row.chapter < params.chapterNumber)
+        .sort((left, right) => left.chapter - right.chapter)
+        .slice(-3);
+    const highFrequencyPhrases = collectRepeatedEnglishPhrases(chapterBodies);
+    const repeatedOpeningPatterns = collectRepeatedBoundaryPatterns(chapterBodies, "opening");
+    const repeatedEndingShapes = collectRepeatedBoundaryPatterns(chapterBodies, "ending");
+    const sceneObligation = chooseSceneObligation(recentRows, repeatedOpeningPatterns, repeatedEndingShapes);
+    const lines = [
+        "## English Variance Brief",
+        "",
+        `- High-frequency phrases to avoid: ${formatEnglishList(highFrequencyPhrases)}`,
+        `- Repeated opening patterns to avoid: ${formatEnglishList(repeatedOpeningPatterns)}`,
+        `- Repeated ending patterns to avoid: ${formatEnglishList(repeatedEndingShapes)}`,
+        `- Scene obligation: ${sceneObligation}`,
+    ];
+    return {
+        highFrequencyPhrases,
+        repeatedOpeningPatterns,
+        repeatedEndingShapes,
+        sceneObligation,
+        text: lines.join("\n"),
+    };
+}
+export async function analyzeLongSpanFatigue(input) {
+    const language = input.language ?? "zh";
+    const issues = [];
+    const summaryRows = await loadSummaryRows(join(input.bookDir, "story", "chapter_summaries.md"));
+    const mergedRows = mergeCurrentSummary(summaryRows, input.chapterSummary);
+    const recentRows = mergedRows
+        .filter((row) => row.chapter <= input.chapterNumber)
+        .sort((left, right) => left.chapter - right.chapter)
+        .slice(-3);
+    const chapterTypeIssue = buildChapterTypeIssue(recentRows, language);
+    if (chapterTypeIssue) {
+        issues.push(chapterTypeIssue);
+    }
+    const recentChapterBodies = await loadRecentChapterBodies(input.bookDir, input.chapterNumber, input.chapterContent);
+    const openingIssue = buildSentencePatternIssue(recentChapterBodies, "opening", language);
+    if (openingIssue) {
+        issues.push(openingIssue);
+    }
+    const endingIssue = buildSentencePatternIssue(recentChapterBodies, "ending", language);
+    if (endingIssue) {
+        issues.push(endingIssue);
+    }
+    return { issues };
+}
+async function loadSummaryRows(path) {
+    try {
+        const raw = await readFile(path, "utf-8");
+        return raw
+            .split("\n")
+            .map((line) => parseSummaryRow(line))
+            .filter((row) => row !== null);
+    }
+    catch {
+        return [];
+    }
+}
+async function loadPreviousChapterBodies(bookDir, currentChapter, limit) {
+    const chaptersDir = join(bookDir, "chapters");
+    try {
+        const files = await readdir(chaptersDir);
+        const previousFiles = files
+            .map((file) => ({ file, chapter: Number.parseInt(file.slice(0, 4), 10) }))
+            .filter((entry) => Number.isFinite(entry.chapter) && entry.chapter < currentChapter && entry.file.endsWith(".md"))
+            .sort((left, right) => left.chapter - right.chapter)
+            .slice(-limit);
+        return Promise.all(previousFiles.map((entry) => readFile(join(chaptersDir, entry.file), "utf-8")));
+    }
+    catch {
+        return [];
+    }
+}
+function mergeCurrentSummary(rows, currentSummary) {
+    const parsedCurrent = currentSummary ? parseSummaryRow(currentSummary) : null;
+    if (!parsedCurrent)
+        return [...rows];
+    const nextRows = rows.filter((row) => row.chapter !== parsedCurrent.chapter);
+    nextRows.push(parsedCurrent);
+    return nextRows;
+}
+function parseSummaryRow(line) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("|") || trimmed.includes("章节 |") || trimmed.includes("Chapter |") || trimmed.includes("---")) {
+        return null;
+    }
+    const cells = trimmed
+        .split("|")
+        .map((cell) => cell.trim())
+        .filter((cell) => cell.length > 0);
+    if (cells.length < 8) {
+        return null;
+    }
+    const chapter = Number.parseInt(cells[0] ?? "", 10);
+    if (!Number.isFinite(chapter) || chapter <= 0) {
+        return null;
+    }
+    return {
+        chapter,
+        title: cells[1] ?? "",
+        mood: cells[6] ?? "",
+        chapterType: cells[7] ?? "",
+    };
+}
+function buildChapterTypeIssue(rows, language) {
+    if (rows.length < 3)
+        return null;
+    const types = rows
+        .map((row) => row.chapterType.trim())
+        .filter((value) => isMeaningfulValue(value));
+    if (types.length < 3)
+        return null;
+    const normalized = types.map((value) => value.toLowerCase());
+    if (!normalized.every((value) => value === normalized[0])) {
+        return null;
+    }
+    if (language === "en") {
+        return {
+            severity: "warning",
+            category: "Pacing Monotony",
+            description: `The last 3 chapter types are identical: ${types.join(" -> ")}, which suggests macro pacing monotony.`,
+            suggestion: "Switch the next chapter's function instead of extending the same beat again. Rotate setup, payoff, reversal, and fallout more deliberately.",
+        };
+    }
+    return {
+        severity: "warning",
+        category: "节奏单调",
+        description: `最近3章章节类型完全一致：${types.join(" -> ")}，长篇节奏可能开始固化。`,
+        suggestion: "下一章应切换章节功能，不要连续重复同一种布局/推进节拍。",
+    };
+}
+async function loadRecentChapterBodies(bookDir, currentChapter, currentContent) {
+    const chaptersDir = join(bookDir, "chapters");
+    try {
+        const files = await readdir(chaptersDir);
+        const previousFiles = files
+            .map((file) => ({ file, chapter: Number.parseInt(file.slice(0, 4), 10) }))
+            .filter((entry) => Number.isFinite(entry.chapter) && entry.chapter < currentChapter && entry.file.endsWith(".md"))
+            .sort((left, right) => left.chapter - right.chapter)
+            .slice(-2);
+        if (previousFiles.length < 2) {
+            return [];
+        }
+        const previousBodies = await Promise.all(previousFiles.map((entry) => readFile(join(chaptersDir, entry.file), "utf-8")));
+        return [...previousBodies, currentContent];
+    }
+    catch {
+        return [];
+    }
+}
+function buildSentencePatternIssue(chapterBodies, boundary, language) {
+    if (chapterBodies.length < 3)
+        return null;
+    const sentences = chapterBodies.map((body) => extractBoundarySentence(body, boundary));
+    if (sentences.some((sentence) => sentence === null)) {
+        return null;
+    }
+    const normalized = sentences
+        .map((sentence) => normalizeSentence(sentence, language));
+    if (normalized.some((sentence) => sentence.length < 18)) {
+        return null;
+    }
+    const similarities = [
+        diceCoefficient(normalized[0], normalized[1]),
+        diceCoefficient(normalized[1], normalized[2]),
+    ];
+    if (Math.min(...similarities) < SENTENCE_SIMILARITY_THRESHOLD) {
+        return null;
+    }
+    const sample = summarizeSentence(sentences[2], language);
+    const pairText = similarities.map((value) => value.toFixed(2)).join("/");
+    if (language === "en") {
+        const category = boundary === "opening" ? "Opening Pattern Repetition" : "Ending Pattern Repetition";
+        const position = boundary === "opening" ? "openings" : "endings";
+        return {
+            severity: "warning",
+            category,
+            description: `The last 3 chapter ${position} are highly similar (adjacent similarity ${pairText}), which risks a formulaic rhythm. Current ${boundary} signature: "${sample}".`,
+            suggestion: boundary === "opening"
+                ? "Change the next chapter opening vector. Start from action, consequence, or surprise instead of repeating the same camera move."
+                : "Change the next chapter landing pattern. End on consequence, decision, or a new variable instead of repeating the same explanatory cadence.",
+        };
+    }
+    return {
+        severity: "warning",
+        category: boundary === "opening" ? "开头同构" : "结尾同构",
+        description: `最近3章${boundary === "opening" ? "开头" : "结尾"}句式高度相似（相邻相似度${pairText}），容易形成模板化${boundary === "opening" ? "开篇" : "章尾"}。当前句式近似“${sample}”。`,
+        suggestion: boundary === "opening"
+            ? "下一章换一个开篇入口，用动作、后果或异常信息切入，不要连续沿用同一种抬镜句。"
+            : "下一章换一个收束方式，用行动后果、角色决断或新变量落板，不要连续用解释性句子收尾。",
+    };
+}
+function collectRepeatedEnglishPhrases(chapterBodies) {
+    const counts = new Map();
+    for (const body of chapterBodies) {
+        const tokens = body
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]+/gi, " ")
+            .split(/\s+/)
+            .filter((token) => token.length >= 3)
+            .filter((token) => !ENGLISH_STOP_WORDS.has(token));
+        const seen = new Set();
+        for (let index = 0; index <= tokens.length - 3; index += 1) {
+            const phrase = `${tokens[index]} ${tokens[index + 1]} ${tokens[index + 2]}`;
+            seen.add(phrase);
+        }
+        for (const phrase of seen) {
+            counts.set(phrase, (counts.get(phrase) ?? 0) + 1);
+        }
+    }
+    return [...counts.entries()]
+        .filter(([, count]) => count >= 2)
+        .sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]))
+        .slice(0, 3)
+        .map(([phrase]) => phrase);
+}
+function collectRepeatedBoundaryPatterns(chapterBodies, boundary) {
+    const counts = new Map();
+    for (const body of chapterBodies) {
+        const sentence = extractBoundarySentence(body, boundary);
+        if (!sentence)
+            continue;
+        const tokens = sentence
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]+/gi, " ")
+            .split(/\s+/)
+            .filter(Boolean)
+            .slice(0, 4);
+        if (tokens.length < 2)
+            continue;
+        const pattern = tokens.join(" ");
+        counts.set(pattern, (counts.get(pattern) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .filter(([, count]) => count >= 2)
+        .sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]))
+        .slice(0, 3)
+        .map(([pattern]) => pattern);
+}
+function chooseSceneObligation(rows, repeatedOpenings, repeatedEndings) {
+    const recentTypes = rows
+        .map((row) => row.chapterType.trim().toLowerCase())
+        .filter((type) => type.length > 0);
+    if (recentTypes.length >= 3 && recentTypes.every((type) => type === recentTypes[0])) {
+        return "confrontation under pressure";
+    }
+    if (repeatedEndings.length > 0) {
+        return "discovery under pressure";
+    }
+    if (repeatedOpenings.length > 0) {
+        return "negotiation with withholding";
+    }
+    return "concealment with active pushback";
+}
+function extractBoundarySentence(content, boundary) {
+    const flattened = content
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.startsWith("#"))
+        .join(" ");
+    const sentences = flattened
+        .split(/(?<=[。！？!?\.])\s+/)
+        .map((sentence) => sentence.trim())
+        .filter((sentence) => sentence.length > 0);
+    if (sentences.length === 0) {
+        return null;
+    }
+    return boundary === "opening" ? sentences[0] : sentences[sentences.length - 1];
+}
+function normalizeSentence(sentence, language) {
+    if (language === "en") {
+        return sentence
+            .toLowerCase()
+            .replace(ENGLISH_PUNCTUATION, "")
+            .trim();
+    }
+    return sentence
+        .replace(CHINESE_PUNCTUATION, "")
+        .toLowerCase();
+}
+function summarizeSentence(sentence, language) {
+    if (language === "en") {
+        const words = sentence
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]+/gi, " ")
+            .split(/\s+/)
+            .filter(Boolean)
+            .slice(0, 6)
+            .join(" ");
+        return words.length > 0 ? words : sentence.slice(0, 32);
+    }
+    const collapsed = sentence.replace(CHINESE_PUNCTUATION, "");
+    return collapsed.slice(0, 12);
+}
+function formatEnglishList(values) {
+    return values.length > 0 ? values.join(", ") : "none";
+}
+function diceCoefficient(left, right) {
+    if (left === right)
+        return 1;
+    if (left.length < 2 || right.length < 2)
+        return 0;
+    const leftBigrams = buildBigrams(left);
+    const rightBigrams = buildBigrams(right);
+    let overlap = 0;
+    for (const [bigram, count] of leftBigrams) {
+        overlap += Math.min(count, rightBigrams.get(bigram) ?? 0);
+    }
+    const leftCount = [...leftBigrams.values()].reduce((sum, value) => sum + value, 0);
+    const rightCount = [...rightBigrams.values()].reduce((sum, value) => sum + value, 0);
+    return (2 * overlap) / (leftCount + rightCount);
+}
+function buildBigrams(value) {
+    const result = new Map();
+    for (let index = 0; index < value.length - 1; index++) {
+        const bigram = value.slice(index, index + 2);
+        result.set(bigram, (result.get(bigram) ?? 0) + 1);
+    }
+    return result;
+}
+function isMeaningfulValue(value) {
+    const normalized = value.trim().toLowerCase();
+    return normalized.length > 0 && normalized !== "none" && normalized !== "(none)" && normalized !== "无";
+}
+const ENGLISH_STOP_WORDS = new Set([
+    "the",
+    "and",
+    "but",
+    "with",
+    "from",
+    "into",
+    "that",
+    "this",
+    "there",
+    "again",
+    "while",
+    "after",
+    "before",
+    "were",
+    "was",
+    "had",
+    "has",
+    "have",
+    "kept",
+]);
+//# sourceMappingURL=long-span-fatigue.js.map

package/dist/utils/long-span-fatigue.js.map

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

package/dist/utils/memory-retrieval.d.ts

@@ -0,0 +1,39 @@
+import type { HookAgenda } from "../models/input-governance.js";
+import { type Fact, type StoredHook, type StoredSummary } from "../state/memory-db.js";
+export interface MemorySelection {
+    readonly summaries: ReadonlyArray<StoredSummary>;
+    readonly hooks: ReadonlyArray<StoredHook>;
+    readonly activeHooks: ReadonlyArray<StoredHook>;
+    readonly facts: ReadonlyArray<Fact>;
+    readonly volumeSummaries: ReadonlyArray<VolumeSummarySelection>;
+    readonly dbPath?: string;
+}
+export interface VolumeSummarySelection {
+    readonly heading: string;
+    readonly content: string;
+    readonly anchor: string;
+}
+export declare const DEFAULT_HOOK_LOOKAHEAD_CHAPTERS = 3;
+export declare function retrieveMemorySelection(params: {
+    readonly bookDir: string;
+    readonly chapterNumber: number;
+    readonly goal: string;
+    readonly outlineNode?: string;
+    readonly mustKeep?: ReadonlyArray<string>;
+}): Promise<MemorySelection>;
+export declare function extractQueryTerms(goal: string, outlineNode: string | undefined, mustKeep: ReadonlyArray<string>): string[];
+export declare function renderSummarySnapshot(summaries: ReadonlyArray<StoredSummary>, language?: "zh" | "en"): string;
+export declare function renderHookSnapshot(hooks: ReadonlyArray<StoredHook>, language?: "zh" | "en"): string;
+export declare function buildPlannerHookAgenda(params: {
+    readonly hooks: ReadonlyArray<StoredHook>;
+    readonly chapterNumber: number;
+    readonly maxMustAdvance?: number;
+    readonly maxEligibleResolve?: number;
+    readonly maxStaleDebt?: number;
+}): HookAgenda;
+export declare function parseChapterSummariesMarkdown(markdown: string): StoredSummary[];
+export declare function parsePendingHooksMarkdown(markdown: string): StoredHook[];
+export declare function parseCurrentStateFacts(markdown: string, fallbackChapter: number): Fact[];
+export declare function isFuturePlannedHook(hook: StoredHook, chapterNumber: number, lookahead?: number): boolean;
+export declare function isHookWithinChapterWindow(hook: StoredHook, chapterNumber: number, recentWindow?: number, lookahead?: number): boolean;
+//# sourceMappingURL=memory-retrieval.d.ts.map

package/dist/utils/memory-retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-retrieval.d.ts","sourceRoot":"","sources":["../../src/utils/memory-retrieval.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAQhE,OAAO,EAAY,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAIjG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3C,GAAG,OAAO,CAAC,eAAe,CAAC,CAmG3B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAc1H;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,EACvC,QAAQ,GAAE,IAAI,GAAG,IAAW,GAC3B,MAAM,CA0BR;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,EAChC,QAAQ,GAAE,IAAI,GAAG,IAAW,GAC3B,MAAM,CAyBR;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC,GAAG,UAAU,CAqCb;AA4GD,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAc/E;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAiCxE;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GACtB,IAAI,EAAE,CA2CR;AAyOD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,MAAwC,GAClD,OAAO,CAET;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,MAAM,EACrB,YAAY,GAAE,MAAU,EACxB,SAAS,GAAE,MAAwC,GAClD,OAAO,CAoBT"}