dsh-tdai-memory 0.3.2 → 0.3.3

package/vendor/tdai/core/scene/scene-format.js

@@ -1,53 +1,53 @@
-/**
- * Scene Block file format: parse and format the META-delimited Markdown files.
- */
-const META_START = "-----META-START-----";
-const META_END = "-----META-END-----";
-/**
- * Parse a Scene Block file into structured data.
- */
-export function parseSceneBlock(raw, filename) {
-    const startIdx = raw.indexOf(META_START);
-    const endIdx = raw.indexOf(META_END);
-    if (startIdx === -1 || endIdx === -1) {
-        // No META section — treat entire file as content
-        return {
-            filename,
-            meta: { created: "", updated: "", summary: "", heat: 0 },
-            content: raw.trim(),
-        };
-    }
-    const metaBlock = raw.slice(startIdx + META_START.length, endIdx).trim();
-    const content = raw.slice(endIdx + META_END.length).trim();
-    const meta = {
-        created: extractMetaField(metaBlock, "created"),
-        updated: extractMetaField(metaBlock, "updated"),
-        summary: extractMetaField(metaBlock, "summary"),
-        heat: parseInt(extractMetaField(metaBlock, "heat"), 10) || 0,
-    };
-    return { filename, meta, content };
-}
-/**
- * Format a Scene Block back into file content.
- */
-export function formatSceneBlock(meta, content) {
-    return `${formatMeta(meta)}\n\n${content}`;
-}
-/**
- * Format the META section.
- */
-export function formatMeta(meta) {
-    return [
-        META_START,
-        `created: ${meta.created}`,
-        `updated: ${meta.updated}`,
-        `summary: ${meta.summary}`,
-        `heat: ${meta.heat}`,
-        META_END,
-    ].join("\n");
-}
-function extractMetaField(metaBlock, field) {
-    const re = new RegExp(`^${field}:\\s*(.*)$`, "m");
-    const m = metaBlock.match(re);
-    return m ? m[1].trim() : "";
-}
+/**
+ * Scene Block file format: parse and format the META-delimited Markdown files.
+ */
+const META_START = "-----META-START-----";
+const META_END = "-----META-END-----";
+/**
+ * Parse a Scene Block file into structured data.
+ */
+export function parseSceneBlock(raw, filename) {
+    const startIdx = raw.indexOf(META_START);
+    const endIdx = raw.indexOf(META_END);
+    if (startIdx === -1 || endIdx === -1) {
+        // No META section — treat entire file as content
+        return {
+            filename,
+            meta: { created: "", updated: "", summary: "", heat: 0 },
+            content: raw.trim(),
+        };
+    }
+    const metaBlock = raw.slice(startIdx + META_START.length, endIdx).trim();
+    const content = raw.slice(endIdx + META_END.length).trim();
+    const meta = {
+        created: extractMetaField(metaBlock, "created"),
+        updated: extractMetaField(metaBlock, "updated"),
+        summary: extractMetaField(metaBlock, "summary"),
+        heat: parseInt(extractMetaField(metaBlock, "heat"), 10) || 0,
+    };
+    return { filename, meta, content };
+}
+/**
+ * Format a Scene Block back into file content.
+ */
+export function formatSceneBlock(meta, content) {
+    return `${formatMeta(meta)}\n\n${content}`;
+}
+/**
+ * Format the META section.
+ */
+export function formatMeta(meta) {
+    return [
+        META_START,
+        `created: ${meta.created}`,
+        `updated: ${meta.updated}`,
+        `summary: ${meta.summary}`,
+        `heat: ${meta.heat}`,
+        META_END,
+    ].join("\n");
+}
+function extractMetaField(metaBlock, field) {
+    const re = new RegExp(`^${field}:\\s*(.*)$`, "m");
+    const m = metaBlock.match(re);
+    return m ? m[1].trim() : "";
+}

package/vendor/tdai/core/scene/scene-index.js

@@ -1,82 +1,82 @@
-/**
- * Scene Index: maintains a JSON index of all scene blocks for quick lookup.
- */
-import fs from "node:fs/promises";
-import path from "node:path";
-import { parseSceneBlock } from "./scene-format.js";
-/**
- * Read the scene index from disk.
- *
- * The index is written exclusively by syncSceneIndex() (engineering side).
- * The LLM is sandboxed to scene_blocks/ and cannot access this file.
- */
-export async function readSceneIndex(dataDir) {
-    const indexPath = path.join(dataDir, ".metadata", "scene_index.json");
-    try {
-        const raw = await fs.readFile(indexPath, "utf-8");
-        const parsed = JSON.parse(raw);
-        if (!Array.isArray(parsed))
-            return [];
-        const entries = [];
-        for (const item of parsed) {
-            if (!item || typeof item !== "object")
-                continue;
-            const filename = typeof item.filename === "string" ? item.filename : "";
-            if (!filename)
-                continue;
-            entries.push({
-                filename,
-                summary: typeof item.summary === "string" ? item.summary : "",
-                heat: typeof item.heat === "number" ? item.heat : 0,
-                created: typeof item.created === "string" ? item.created : "",
-                updated: typeof item.updated === "string" ? item.updated : "",
-            });
-        }
-        return entries;
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Write the scene index to disk.
- */
-export async function writeSceneIndex(dataDir, entries) {
-    const indexPath = path.join(dataDir, ".metadata", "scene_index.json");
-    await fs.mkdir(path.dirname(indexPath), { recursive: true });
-    await fs.writeFile(indexPath, JSON.stringify(entries, null, 2), "utf-8");
-}
-/**
- * Rebuild scene index by scanning all .md files in the scene_blocks directory.
- */
-export async function syncSceneIndex(dataDir) {
-    const blocksDir = path.join(dataDir, "scene_blocks");
-    let files;
-    try {
-        files = (await fs.readdir(blocksDir)).filter((f) => f.endsWith(".md"));
-    }
-    catch {
-        files = [];
-    }
-    const entries = [];
-    for (const file of files) {
-        try {
-            const raw = await fs.readFile(path.join(blocksDir, file), "utf-8");
-            const block = parseSceneBlock(raw, file);
-            entries.push({
-                filename: file,
-                summary: block.meta.summary,
-                heat: block.meta.heat,
-                created: block.meta.created,
-                updated: block.meta.updated,
-            });
-        }
-        catch {
-            // File may have been deleted between readdir and readFile (e.g. by concurrent
-            // SceneExtractor soft-delete). Skip it and continue syncing the rest.
-            continue;
-        }
-    }
-    await writeSceneIndex(dataDir, entries);
-    return entries;
-}
+/**
+ * Scene Index: maintains a JSON index of all scene blocks for quick lookup.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { parseSceneBlock } from "./scene-format.js";
+/**
+ * Read the scene index from disk.
+ *
+ * The index is written exclusively by syncSceneIndex() (engineering side).
+ * The LLM is sandboxed to scene_blocks/ and cannot access this file.
+ */
+export async function readSceneIndex(dataDir) {
+    const indexPath = path.join(dataDir, ".metadata", "scene_index.json");
+    try {
+        const raw = await fs.readFile(indexPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        const entries = [];
+        for (const item of parsed) {
+            if (!item || typeof item !== "object")
+                continue;
+            const filename = typeof item.filename === "string" ? item.filename : "";
+            if (!filename)
+                continue;
+            entries.push({
+                filename,
+                summary: typeof item.summary === "string" ? item.summary : "",
+                heat: typeof item.heat === "number" ? item.heat : 0,
+                created: typeof item.created === "string" ? item.created : "",
+                updated: typeof item.updated === "string" ? item.updated : "",
+            });
+        }
+        return entries;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Write the scene index to disk.
+ */
+export async function writeSceneIndex(dataDir, entries) {
+    const indexPath = path.join(dataDir, ".metadata", "scene_index.json");
+    await fs.mkdir(path.dirname(indexPath), { recursive: true });
+    await fs.writeFile(indexPath, JSON.stringify(entries, null, 2), "utf-8");
+}
+/**
+ * Rebuild scene index by scanning all .md files in the scene_blocks directory.
+ */
+export async function syncSceneIndex(dataDir) {
+    const blocksDir = path.join(dataDir, "scene_blocks");
+    let files;
+    try {
+        files = (await fs.readdir(blocksDir)).filter((f) => f.endsWith(".md"));
+    }
+    catch {
+        files = [];
+    }
+    const entries = [];
+    for (const file of files) {
+        try {
+            const raw = await fs.readFile(path.join(blocksDir, file), "utf-8");
+            const block = parseSceneBlock(raw, file);
+            entries.push({
+                filename: file,
+                summary: block.meta.summary,
+                heat: block.meta.heat,
+                created: block.meta.created,
+                updated: block.meta.updated,
+            });
+        }
+        catch {
+            // File may have been deleted between readdir and readFile (e.g. by concurrent
+            // SceneExtractor soft-delete). Skip it and continue syncing the rest.
+            continue;
+        }
+    }
+    await writeSceneIndex(dataDir, entries);
+    return entries;
+}

package/vendor/tdai/core/scene/scene-navigation.js

@@ -1,60 +1,60 @@
-/**
- * Scene navigation: generates a summary navigation section appended to persona.md.
- *
- * The navigation includes **absolute** file paths so the agent can directly
- * use read_file for on-demand scene loading (progressive disclosure).
- */
-import path from "node:path";
-const NAV_HEADER = "---\n## 🗺️ Scene Navigation (Scene Index)";
+/**
+ * Scene navigation: generates a summary navigation section appended to persona.md.
+ *
+ * The navigation includes **absolute** file paths so the agent can directly
+ * use read_file for on-demand scene loading (progressive disclosure).
+ */
+import path from "node:path";
+const NAV_HEADER = "---\n## 🗺️ Scene Navigation (Scene Index)";
 const NAV_FOOTER = `📌 使用说明：
 - Path 是 scene block 的绝对路径，可直接使用 read_file 读取完整内容
 - 热度：该场景被记忆命中的累计次数，越高越重要
-- Summary：场景的核心要点摘要`;
-/**
- * Build a fire-emoji string based on heat value (visual priority cue for the agent).
- */
-function heatEmoji(heat) {
-    if (heat >= 1000)
-        return " 🔥🔥🔥🔥🔥";
-    if (heat >= 500)
-        return " 🔥🔥🔥🔥";
-    if (heat >= 200)
-        return " 🔥🔥🔥";
-    if (heat >= 100)
-        return " 🔥🔥";
-    if (heat >= 50)
-        return " 🔥";
-    return "";
-}
-/**
- * Generate the scene navigation Markdown section.
- *
- * @param entries - Scene index entries
- * @param dataDir - Absolute path to the plugin data directory; when provided,
- *                  scene paths are rendered as absolute paths so the agent can
- *                  call read_file directly without path concatenation.
- */
-export function generateSceneNavigation(entries, dataDir) {
-    if (entries.length === 0)
-        return "";
-    const sorted = [...entries].sort((a, b) => b.heat - a.heat);
-    const blocks = sorted.map((e) => {
-        const scenePath = dataDir
-            ? path.join(dataDir, "scene_blocks", e.filename)
-            : `scene_blocks/${e.filename}`;
-        const pathLine = `### Path: ${scenePath}`;
-        const heatLine = `**热度**: ${e.heat}${heatEmoji(e.heat)}${e.updated ? ` | **更新**: ${e.updated}` : ""}`;
-        const summaryLine = `Summary: ${e.summary}`;
-        return `${pathLine}\n${heatLine}\n${summaryLine}`;
-    });
-    return `${NAV_HEADER}\n*以下是当前场景记忆的索引，可根据需要 read_file 读取详细内容。*\n\n${blocks.join("\n\n")}\n\n${NAV_FOOTER}`;
-}
-/**
- * Strip the scene navigation section from persona content.
- */
-export function stripSceneNavigation(personaContent) {
-    const idx = personaContent.indexOf(NAV_HEADER);
-    if (idx === -1)
-        return personaContent;
-    return personaContent.slice(0, idx).trimEnd();
-}
+- Summary：场景的核心要点摘要`;
+/**
+ * Build a fire-emoji string based on heat value (visual priority cue for the agent).
+ */
+function heatEmoji(heat) {
+    if (heat >= 1000)
+        return " 🔥🔥🔥🔥🔥";
+    if (heat >= 500)
+        return " 🔥🔥🔥🔥";
+    if (heat >= 200)
+        return " 🔥🔥🔥";
+    if (heat >= 100)
+        return " 🔥🔥";
+    if (heat >= 50)
+        return " 🔥";
+    return "";
+}
+/**
+ * Generate the scene navigation Markdown section.
+ *
+ * @param entries - Scene index entries
+ * @param dataDir - Absolute path to the plugin data directory; when provided,
+ *                  scene paths are rendered as absolute paths so the agent can
+ *                  call read_file directly without path concatenation.
+ */
+export function generateSceneNavigation(entries, dataDir) {
+    if (entries.length === 0)
+        return "";
+    const sorted = [...entries].sort((a, b) => b.heat - a.heat);
+    const blocks = sorted.map((e) => {
+        const scenePath = dataDir
+            ? path.join(dataDir, "scene_blocks", e.filename)
+            : `scene_blocks/${e.filename}`;
+        const pathLine = `### Path: ${scenePath}`;
+        const heatLine = `**热度**: ${e.heat}${heatEmoji(e.heat)}${e.updated ? ` | **更新**: ${e.updated}` : ""}`;
+        const summaryLine = `Summary: ${e.summary}`;
+        return `${pathLine}\n${heatLine}\n${summaryLine}`;
+    });
+    return `${NAV_HEADER}\n*以下是当前场景记忆的索引，可根据需要 read_file 读取详细内容。*\n\n${blocks.join("\n\n")}\n\n${NAV_FOOTER}`;
+}
+/**
+ * Strip the scene navigation section from persona content.
+ */
+export function stripSceneNavigation(personaContent) {
+    const idx = personaContent.indexOf(NAV_HEADER);
+    if (idx === -1)
+        return personaContent;
+    return personaContent.slice(0, idx).trimEnd();
+}