@modusensus/dsh-mneme 0.7.10 → 0.7.12

package/{dsh-mneme/lib → lib}/index.js

@@ -7,13 +7,14 @@ import { createSummarizer } from "./summarize.js";
 import { createDreamScheduler } from "./dream.js";
 import { createSleepScheduler, runSleep } from "./dream/sleep.js";
 import { createApi } from "./api.js";
+import { createStandaloneApi } from "./api-standalone.js";
 import { createSettings } from "./settings.js";
 import { createCommandManager } from "./commands.js";
 import { createEmbedder } from "./embedding.js";
 import { createEmbedderByProvider } from "./local-embedder.js";
 import { LocalReranker } from "./reranker.js";
 import { createVectorIndex } from "./vector-index.js";
-import { Config } from "./config.js";
+import { Config, applyLightModePreset } from "./config.js";
 import { extractEntities } from "./entities/extractor.js";
 import { mkdirSync } from "node:fs";
 import { join } from "node:path";
@@ -29,12 +30,12 @@ export { Config };
 // has no prototype, is called normally, and its returned disposer is collected
 // and run by the fiber on unload.
 export const apply = (ctx, config) => {
-  const cfg = Config(config);
+  const rawCfg = Config(config);
 
   // Resolve memoryDir: expand leading "~"
-  const memoryDir = cfg.memoryDir.startsWith("~")
-    ? join(homedir(), cfg.memoryDir.slice(1))
-    : cfg.memoryDir;
+  const memoryDir = rawCfg.memoryDir.startsWith("~")
+    ? join(homedir(), rawCfg.memoryDir.slice(1))
+    : rawCfg.memoryDir;
   mkdirSync(memoryDir, { recursive: true });
 
   const store = createStore(join(memoryDir, "memory.db"));
@@ -47,25 +48,28 @@ export const apply = (ctx, config) => {
   // default 90). Best-effort like the failure prune — the audit trail is
   // bookkeeping and a failed purge must never block plugin boot.
   try {
-    if (cfg.llmAudit?.enabled !== false) {
-      const retentionMs = Number.isInteger(cfg.llmAudit?.retentionDays) ? cfg.llmAudit.retentionDays : 90;
+    if (rawCfg.llmAudit?.enabled !== false) {
+      const retentionMs = Number.isInteger(rawCfg.llmAudit?.retentionDays) ? rawCfg.llmAudit.retentionDays : 90;
       store.deleteOldLlmAudits(new Date(Date.now() - retentionMs * 86400000).toISOString());
     }
   } catch { /* non-fatal */ }
-  // v0.7.0: recall_runs 滚动清理 —— recordRecall 默认开且注入路径也记账，表随
-  // 活跃度增长；启动时按 recallRetentionDays（默认 90 天）清一次，防膨胀。
-  // 与 llm_audit 同策略：纯 bookkeeping，清理失败绝不阻塞插件启动。
-  try {
-    const recallRetentionDays = Number.isInteger(cfg.recallRetentionDays) ? cfg.recallRetentionDays : 90;
-    store.purgeRecallRunsOlderThan(recallRetentionDays);
-  } catch { /* non-fatal */ }
-  const mirror = createMirror(memoryDir);
-  // User-configurable settings (profile, rules) and custom commands share the
-  // same SQLite file but live in dedicated tables, isolated from memories.
-  // Created before the service so the tag-config resolver (issue #31) can merge
-  // the Web panel's persisted toggles over the plugin config at runtime.
+
+  // User-configurable settings (profile, rules, panel mode, standalone API
+  // token) share the same SQLite file in dedicated tables, isolated from
+  // memories. Created before the config is finalized: the persisted
+  // panel_mode participates in light-mode resolution below.
   const settings = createSettings(store.db);
-  const service = createService({ store, mirror, config: cfg, logger: ctx.logger, settings });
+
+  // Light mode (v0.7.12): the bundle config flag OR a persisted panel_mode of
+  // "light" (the panel switch wins over the bundle config so it survives
+  // config redeploys). applyLightModePreset turns every heavy background /
+  // semantic feature off and keeps the core loop (autoInject, autoSummarize,
+  // hot memory, quality filter).
+  const lightMode = rawCfg.lightMode === true || settings.getPanelMode() === "light";
+  const cfg = applyLightModePreset({ ...rawCfg, lightMode });
+
+  const mirror = createMirror(memoryDir);
+  const service = createService({ store, mirror, config: cfg, logger: ctx.logger });
 
   // F-NEW-03: if the mirror sync failed last run (persisted dirty state), retry
   // a safe re-render at boot so a stale mirror converges without needing a
@@ -115,7 +119,13 @@ export const apply = (ctx, config) => {
 
   let embedder = null;
   let reranker = null;
-  if (cfg.embedProvider === "openai") {
+  if (lightMode) {
+    // Light mode: the whole vector pipeline stays off — no embedder (nothing
+    // pulls in ONNX/transformers), no reranker, no boot backfill (the preset
+    // also cleared autoReindexOnBoot). Recall degrades to keyword search and
+    // human mirror edits still merge on boot.
+    applyHumanEdits();
+  } else if (cfg.embedProvider === "openai") {
     // vectorIndex is passed so the legacy OpenAI embedder records the producing
     // model fingerprint after each successful embed (Bug3).
     embedder = createEmbedder({ store, settings, logger: ctx.logger, vectorIndex });
@@ -252,7 +262,7 @@ export const apply = (ctx, config) => {
       delayMs: cfg.dreamDelayMs,
       logger: ctx.logger,
       semantic: { embedder, vectorIndex },
-      onRun: () => (dream ? dream.runDream(ctx, service, cfg, settings) : Promise.resolve({ ok: true, skipped: true }))
+      onRun: () => (dream ? dream.runDream(ctx, service, cfg) : Promise.resolve({ ok: true, skipped: true }))
     });
     service.setDreamHook(() => dream.maybeSchedule(service));
   }
@@ -325,26 +335,6 @@ export const apply = (ctx, config) => {
   const summarizer = createSummarizer(ctx, service, cfg);
   disposers.push(summarizer.dispose);
 
-  // Session lifecycle (v0.6.0): when a session leaves the store and the toggle
-  // is enabled, mark every memory born in it as session-disposed (hidden from
-  // injection/search/dream but never destroyed — recoverable via
-  // restoreBySession). Default off, so a disposed session leaves its memories
-  // active (legacy behavior). Every path is guarded: a failure inside the
-  // callback must never propagate into DSH's session teardown (that would crash
-  // the plugin on the very delete action it serves).
-  if (cfg.sessionLifecycleEnabled) {
-    disposers.push(ctx.on("session/disposed", (session) => {
-      const sessionId = session?.id;
-      if (!sessionId) return;
-      try {
-        const { disposed } = service.disposeBySession(sessionId);
-        ctx.logger?.info?.(`[dsh-mneme] session disposed, hid ${disposed} memory(s) for ${sessionId}`);
-      } catch (error) {
-        ctx.logger?.warn?.(`[dsh-mneme] session dispose failed for ${sessionId}: ${String(error)}`);
-      }
-    }));
-  }
-
   if (ctx.webServer) {
     const api = createApi(ctx, service, settings, commands ?? {
       add: () => { throw new Error("commands unavailable"); },
@@ -354,6 +344,19 @@ export const apply = (ctx, config) => {
     disposers.push(api.dispose);
   }
 
+  // Standalone external API (v0.7.12): plain node:http server for ecosystem
+  // integrations outside the DSH host. Persisted external_api settings win
+  // over the bundle config (enabled/port); the Bearer token lives in the same
+  // kv and is auto-generated on first boot by createStandaloneApi. Binding a
+  // non-loopback host is the operator's documented responsibility.
+  if ((settings.getExternalApi?.()?.enabled ?? cfg.externalApiEnabled) === true) {
+    const standalone = createStandaloneApi({ service, store, config: cfg, logger: ctx.logger, settings });
+    disposers.push(() => standalone.server.close());
+    standalone.ready.catch((error) => {
+      ctx.logger?.warn?.(`[dsh-mneme] standalone API failed to start: ${String(error)}`);
+    });
+  }
+
   // Async disposer: cordis awaits the returned promise on unload (runDisposable),
   // so an in-flight dream run is allowed to finish before the SQLite store is
   // closed — dream.dispose() resolves only after its current run settles.

package/{dsh-mneme/lib → lib}/inject.js

@@ -8,7 +8,10 @@ import { createHotMemory } from "./hot-memory.js";
 // falls back to the legacy rule-based pick, never breaking the render.
 function lastUserQuery(ctx) {
   try {
-    const events = ctx?.agent?.session?.snapshotEvents?.() ?? ctx?.agent?.session?.events;
+    const session = ctx?.agent?.session;
+    // DSH ≥0.1.2-rc only exposes events via snapshotEvents(); older builds
+    // still have the .events property, so fall back to it.
+    const events = session?.snapshotEvents?.() ?? session?.events;
     if (!Array.isArray(events) || events.length === 0) return "";
     for (let i = events.length - 1; i >= 0; i--) {
       const event = events[i];
@@ -34,7 +37,8 @@ function lastUserQuery(ctx) {
 // returns [] on any failure, and the hot block simply does not render.
 function extractRounds(ctx, maxRounds) {
   try {
-    const events = ctx?.agent?.session?.snapshotEvents?.() ?? ctx?.agent?.session?.events;
+    const session = ctx?.agent?.session;
+    const events = session?.snapshotEvents?.() ?? session?.events;
     if (!Array.isArray(events) || events.length === 0) return [];
     const rounds = [];
     let pendingQuery = null;
@@ -75,49 +79,6 @@ export function createInjector(ctx, service, settings, config) {
   const maxItems = config.maxInjectedItems ?? 5;
   const threshold = config.importanceThreshold ?? 3;
 
-  // Prompt-variable escaping (issue #40): DSH's interpolate() treats `{{name}}`
-  // as a prompt variable and strictly validates the name against
-  // /^[a-z][a-z0-9_]*$/ — memory/profile content carrying legal template syntax
-  // (Obsidian-style `{{hl|}}`, `{{挖空}}`, `{{关键词}}`) would hit an illegal
-  // variable name and throw, crashing the whole turn. At the injection boundary
-  // we escape every run of 2+ consecutive braces, inserting a `\` between each
-  // pair, so no `{{`/`}}` substring survives into the prompt: `{{a}}` → `{\{a\}\}`,
-  // and odd runs like `{{{a}}}` (which pair-wise escaping would leave with a
-  // literal `{{`) are handled too. The text keeps its readable template form,
-  // the transform is idempotent (escaped braces are single + `\`, never two
-  // adjacent), and single braces pass through untouched — interpolate only
-  // scans `{{`. Off via config.escapePromptVariables=false (default true).
-  function escapePromptVars(text) {
-    if (config.escapePromptVariables === false) return String(text);
-    return String(text).replace(/[{}]{2,}/g, (run) => run.split("").join("\\"));
-  }
-
-  // Time-prefix injection (issue #34): opt-in, off by default. When enabled the
-  // current date/time is injected once per conversation — at the first prompt
-  // assembly of a new session — so the model can sense what time/day it is.
-  // A per-session latch means later assemblies in the same session never
-  // re-inject; a bare render ctx (no session id) falls back to once per
-  // injector lifetime.
-  const WEEKDAYS = ["周日", "周一", "周二", "周三", "周四", "周五", "周六"];
-  let timePrefixSession = null;
-
-  function renderTimePrefix(ctx) {
-    if (config.injectTimePrefix !== true) return "";
-    const sessionId = ctx?.agent?.session?.id;
-    if (sessionId === undefined) {
-      if (timePrefixSession !== null) return "";
-      timePrefixSession = true;
-    } else {
-      if (sessionId === timePrefixSession) return "";
-      timePrefixSession = sessionId;
-    }
-    const now = new Date();
-    const pad = (n) => String(n).padStart(2, "0");
-    const date = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;
-    const time = `${pad(now.getHours())}:${pad(now.getMinutes())}`;
-    return `[当前时间: ${date} ${WEEKDAYS[now.getDay()]} ${time}]`;
-  }
-
   // Bug6: bound the injected memory block. Each entry's content is truncated to
   // MAX_CONTENT chars (trailing `…`); the whole block gets a MAX_BLOCK budget
   // and an entry that would exceed it collapses to its title only, so a long
@@ -151,7 +112,7 @@ export function createInjector(ctx, service, settings, config) {
     for (const r of rounds) hot.add(r);
     const body = hot.getContext();
     if (!body) return "";
-    return escapePromptVars(`[短期上下文] 最近对话（共 ${rounds.length} 轮）：\n${body}`);
+    return `[短期上下文] 最近对话（共 ${rounds.length} 轮）：\n${body}`;
   }
 
   function render(candidates) {
@@ -175,7 +136,7 @@ export function createInjector(ctx, service, settings, config) {
         lines.push(`- [${m.type}] ${verified}${title}`);
       }
     }
-    return escapePromptVars(lines.join("\n"));
+    return lines.join("\n");
   }
 
   // Bug4: the system-prompt render is synchronous, so the semantic query vector
@@ -209,7 +170,7 @@ export function createInjector(ctx, service, settings, config) {
     const lines = ["[用户设置] 来自 dsh-mneme 的用户画像与规则："];
     if (profile) lines.push(`- 用户画像：${profile}`);
     for (const rule of rules) lines.push(`- 规则：${rule}`);
-    return escapePromptVars(lines.join("\n"));
+    return lines.join("\n");
   }
 
   const disposers = [
@@ -231,11 +192,8 @@ export function createInjector(ctx, service, settings, config) {
         // separate context) keeps the prompt assembly stable at two blocks.
         const hotText = renderHotContext(ctx);
         const body = render(candidates);
-        let out = !hotText ? body : (body ? `${hotText}\n\n${body}` : hotText);
-        // Time prefix (issue #34): leads the injection block once per session.
-        const timePrefix = renderTimePrefix(ctx);
-        if (!timePrefix) return out;
-        return out ? `${timePrefix}\n\n${out}` : timePrefix;
+        if (!hotText) return body;
+        return body ? `${hotText}\n\n${body}` : hotText;
       }
     }),
     ctx.systemPrompt.context({

package/{dsh-mneme/src → lib}/mirror.js

@@ -7,9 +7,7 @@ export const TYPE_FILE = {
   project: "projects.md",
   decision: "decisions.md",
   history: "history.md",
-  summary: "summary.md",
-  user: "user.md",
-  fact: "facts.md"
+  summary: "summary.md"
 };
 
 const ESCAPE = /([\\`*_[\]{}()#+.!|>~-])/g;
@@ -33,15 +31,6 @@ function renderMemory(m) {
     .digest("hex");
   const lines = [];
   lines.push(`## ${esc(m.title)}`);
-  // v0.6.2 tag line: entity_attrs-backed tags (attached by the service as
-  // `entityTags`) rendered as `#tag` space-separated under the title. No tags
-  // → no line. Legacy `- **标签**:` metadata below keeps the memories.tags
-  // column (still written by save/update) readable.
-  const entityTags = Array.isArray(m.entityTags) ? m.entityTags : [];
-  if (entityTags.length) {
-    lines.push("");
-    lines.push(entityTags.map((t) => `#${esc(t)}`).join(" "));
-  }
   lines.push("");
   lines.push(`- **ID**: \`${m.id}\``);
   lines.push(`- **类型**: ${m.type}`);

package/{dsh-mneme/lib → lib}/quality-filter.js

@@ -34,9 +34,7 @@ const TYPE_LABELS = {
   decision: ["decision", "决策", "决定"],
   history: ["history", "历史", "事件"],
   summary: ["summary", "总结", "摘要", "总览"],
-  pattern: ["pattern", "模式", "规律"],
-  user: ["user", "用户"],
-  fact: ["fact", "事实", "原子事实"]
+  pattern: ["pattern", "模式", "规律"]
 };
 
 /** Normalized bigram-overlap similarity in [0,1]; 0 for tiny/empty inputs. */

package/{dsh-mneme/lib → lib}/reranker.js

@@ -21,10 +21,7 @@ function modelHash(model) {
 
 /** Lazy default pipeline factory: dynamic import keeps module load cheap. */
 async function defaultPipelineLoader(task, model, options) {
-  const { env, pipeline } = await import("@huggingface/transformers");
-  // issue #13: mirror cache_dir onto env.cacheDir so the tokenizer pre-check
-  // resolves locally too (same fix as local-embedder.js).
-  if (options?.cache_dir) env.cacheDir = options.cache_dir;
+  const { pipeline } = await import("@huggingface/transformers");
   return pipeline(task, model, options);
 }