dsh-tdai-memory 0.3.6 → 0.4.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Scorp1o117
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Scorp1o117
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,9 @@
 # dsh-tdai-memory
 
+## Configuration page (DSH 0.2.0-rc.2 and later)
+
+Open **Plugins → Installed → dsh-tdai-memory** from the homepage sidebar to configure and save this plugin. The page uses the official `plugins.bundle.config` interface, without a duplicate entry in global Settings. Web and Desktop share the page. This version requires DSH 0.2.0-rc.2 or a later 0.2.x host; existing configuration is retained.
+
 [![中文文档](https://img.shields.io/badge/%E4%B8%AD%E6%96%87%E6%96%87%E6%A1%A3-blue)](README.zh.md)
 
 **GitHub**: [Scorp1o117/dsh-tdai-memory](https://github.com/Scorp1o117/dsh-tdai-memory) · **npm**: [dsh-tdai-memory](https://www.npmjs.com/package/dsh-tdai-memory)
@@ -143,3 +147,5 @@ not need it. Users who select the local backend should install and approve
 
 MIT
 
+
+Saves use the configuration form API. Rejected writes retain the draft and show an error. Changing a model preserves credentials, and disabling a default-on option explicitly stores `false`.

package/README.zh.md

@@ -1,5 +1,9 @@
 # dsh-tdai-memory
 
+## 配置入口（DSH 0.2.0-rc.2 起）
+
+在首页侧边栏打开 **插件 → 已安装 → dsh-tdai-memory**，直接在插件详情页配置并保存。配置页注册到官方的 `plugins.bundle.config` 接口；全局设置页不再重复显示配置入口。Web 与桌面版使用相同界面，本版要求 DSH 0.2.0-rc.2 或更新的 0.2.x 版本。现有配置无需迁移。
+
 **GitHub**: [Scorp1o117/dsh-tdai-memory](https://github.com/Scorp1o117/dsh-tdai-memory) · **npm**: [dsh-tdai-memory](https://www.npmjs.com/package/dsh-tdai-memory) · [English](README.md)
 
 [![Enhancement Suite](https://img.shields.io/badge/part%20of-Enhancement%20Suite-3964fe)](https://github.com/Scorp1o117/dsh-enhancement-suite) [![npm](https://img.shields.io/npm/v/dsh-enhancement-suite)](https://www.npmjs.com/package/dsh-enhancement-suite)
@@ -56,7 +60,7 @@ dsh plugin --profile desktop add dsh-tdai-memory@0.3.6
 
 ## 配置（profile patch + settings）
 
-配置以 **settings 命名空间**驱动：profile patch 作为 base 层，`$DSH_HOME/settings.yaml` 的 `tdai-memory:` 节覆盖（LLM/embedding 密钥已迁到 settings.yaml）。Web UI 设置 → 记忆 可编辑全部字段（v0.2.0，含写-only 密钥）；TdaiCore 启动时构建，改动**重启后生效**。
+配置以 **settings 命名空间**驱动：profile patch 作为 base 层，`$DSH_HOME/settings.yaml` 的 `tdai-memory:` 节覆盖（LLM/embedding 密钥已迁到 settings.yaml）。首页侧边栏插件 → dsh-tdai-memory 可编辑全部字段（v0.2.0，含写-only 密钥）；TdaiCore 启动时构建，改动**重启后生效**。
 
 ```yaml
 # $DSH_HOME/settings.yaml
@@ -94,3 +98,5 @@ tdai-memory:
 - **L1 记忆向量**：随存储写入（8088 embedding 快）；L0 向量走后台任务，headless 退出时由 `destroy()` drain
 - **升级**：上游拉新代码后，在 tdai 项目目录重跑 `npx tsc -p dsh-tsconfig.json`（产物在 `dist-dsh/`）
 
+
+保存使用配置表单 API；宿主拒绝写入时保留草稿并提示错误。只修改模型不会覆盖密钥，关闭默认开启的选项会显式保存 `false`。

package/THIRD-PARTY-NOTICES.md

@@ -1,20 +1,20 @@
-# Third-party notices
-
-## TencentDB Agent Memory core (vendored in `vendor/tdai`)
-
-`vendor/tdai` is a TypeScript-compiled copy of the host-neutral core of
-[TencentCloud/TencentDB-Agent-Memory](https://github.com/TencentCloud/TencentDB-Agent-Memory)
-(`tdai-memory-openclaw-plugin`, npm: `@tencentdb-agent-memory/memory-tencentdb`),
-compiled with `tsc -p dsh-tsconfig.json` (see the upstream repo for source).
-Its runtime dependencies are declared in this package's `dependencies`.
-
-MIT License — Copyright (c) 2026 TencentCloud
-
-## Runtime dependencies
-
-- `ai` / `@ai-sdk/openai` — Vercel AI SDK (Apache-2.0)
-- `@node-rs/jieba` — Rust jieba bindings (MIT)
-- `sqlite-vec` — vector search extension for SQLite (Apache-2.0 / MIT)
-- `json5` — JSON5 parser (MIT)
-- `undici` — HTTP client (MIT)
-- `@tencentdb-agent-memory/tcvdb-text` — TencentDB text utilities (MIT)
+# Third-party notices
+
+## TencentDB Agent Memory core (vendored in `vendor/tdai`)
+
+`vendor/tdai` is a TypeScript-compiled copy of the host-neutral core of
+[TencentCloud/TencentDB-Agent-Memory](https://github.com/TencentCloud/TencentDB-Agent-Memory)
+(`tdai-memory-openclaw-plugin`, npm: `@tencentdb-agent-memory/memory-tencentdb`),
+compiled with `tsc -p dsh-tsconfig.json` (see the upstream repo for source).
+Its runtime dependencies are declared in this package's `dependencies`.
+
+MIT License — Copyright (c) 2026 TencentCloud
+
+## Runtime dependencies
+
+- `ai` / `@ai-sdk/openai` — Vercel AI SDK (Apache-2.0)
+- `@node-rs/jieba` — Rust jieba bindings (MIT)
+- `sqlite-vec` — vector search extension for SQLite (Apache-2.0 / MIT)
+- `json5` — JSON5 parser (MIT)
+- `undici` — HTTP client (MIT)
+- `@tencentdb-agent-memory/tcvdb-text` — TencentDB text utilities (MIT)

package/client.js

@@ -1,7 +1,7 @@
 /**
  * dsh-tdai-memory — browser half.
  *
- * A "记忆" section inside the Web UI settings page: edits the `tdai-memory`
+ * A configuration page inside the sidebar Plugins page: edits `tdai-memory`
  * settings namespace (data dir, extraction LLM, embeddings, capture/extract/
  * recall switches, tools) through the settings scope transport plus nested
  * `settings.mutate` ops. TdaiCore is built at startup, so changes apply
@@ -47,7 +47,7 @@ window.__ModuleLoader__.load({
 
     // ── locale ────────────────────────────────────────────────────────────
     var NS = "tdaiMemory";
-    var inject = ["slots", "locale", "configForms", "connection"];
+    var inject = ["slots", "locale", "configForms"];
     var zh = {
       nav: "记忆",
       intro: "TDAI 记忆配置：L0 捕获 → L1 结构化提取 → 召回注入。密钥只写不读。TdaiCore 在启动时构建，修改后需重启生效。",
@@ -88,6 +88,7 @@ window.__ModuleLoader__.load({
       saved: "已保存（重启后生效）",
       saving: "保存中…",
       error: "保存失败",
+      notApplied: "写入未生效，请检查配置后重试",
       unavailable: "设置命名空间不可用（服务端未注册 tdai-memory 命名空间？）",
       overridden: "已覆盖",
       loading: "加载中…"
@@ -132,6 +133,7 @@ window.__ModuleLoader__.load({
       saved: "Saved (applies after restart)",
       saving: "Saving…",
       error: "Save failed",
+      notApplied: "Write did not take effect; check the configuration and retry",
       unavailable: "Settings namespace unavailable (tdai-memory namespace not registered server-side?)",
       overridden: "overridden",
       loading: "Loading…"
@@ -176,7 +178,6 @@ window.__ModuleLoader__.load({
     function MemorySection(props) {
       var t = props.t;
       var scope = props.scope;
-      var api = props.api;
       var [snapshot, setSnapshot] = react.useState(function () { return scope.getSnapshot(); });
       var ready = snapshot.status === "ready" && snapshot.value !== void 0;
       var [draft, setDraft] = react.useState({});
@@ -216,6 +217,7 @@ window.__ModuleLoader__.load({
       var user = snapshot.user || {};
 
       function fieldDraft(f) {
+        if (f.secret) return draft[f.key] || "";
         if (f.type === "checkbox") return draft[f.key] !== void 0 ? draft[f.key] : Boolean(getPath(value, f.path));
         return draft[f.key] !== void 0 ? draft[f.key] : String(getPath(value, f.path) ?? "");
       }
@@ -226,6 +228,7 @@ window.__ModuleLoader__.load({
       }
 
       function onSave() {
+        if (busy || !snapshot.writable) return;
         setBusy(true); setNotice(null); setError(null);
         var ops = [];
         for (var i = 0; i < FIELDS.length; i += 1) {
@@ -240,7 +243,7 @@ window.__ModuleLoader__.load({
           }
           if (f.type === "checkbox") {
             if (Boolean(d) === Boolean(current)) continue;
-            ops.push(Boolean(d) ? { op: "set", path: f.path, value: true } : { op: "unset", path: f.path });
+            ops.push({ op: "set", path: f.path, value: Boolean(d) });
             continue;
           }
           if (String(d) === String(current ?? "")) continue;
@@ -248,35 +251,27 @@ window.__ModuleLoader__.load({
           ops.push(String(d).trim() === "" ? { op: "unset", path: f.path } : { op: "set", path: f.path, value: f.type === "number" ? Number(d) : d });
         }
         if (ops.length === 0) { setBusy(false); setNotice(t("saved")); return; }
-        api.settings.mutate({
-          ns: "tdai-memory",
-          ops: ops,
-          ...snapshot.revision === void 0 ? {} : { expectedRevision: snapshot.revision }
-        }).then(function (response) {
-          setBusy(false);
-          if (!response.result.ok) {
-            var detail = response.result.error || {};
-            setError(t("error") + ": " + String(detail.message || detail.code || "unknown"));
-            return;
-          }
-          setNotice(t("saved"));
-          if (response.result.value) setDraft(Object.assign({}, valueToDraft(response.result.value)));
-        }).catch(function (e) {
-          setBusy(false); setError(t("error") + ": " + String(e && e.message || e));
-        });
+        commit(ops);
       }
 
       function onReset() {
+        if (busy || !snapshot.writable) return;
         setBusy(true); setNotice(null); setError(null);
-        api.settings.mutate({
-          ns: "tdai-memory",
-          ops: FIELDS.map(function (f) { return { op: "unset", path: f.path }; }),
-          ...snapshot.revision === void 0 ? {} : { expectedRevision: snapshot.revision }
-        }).then(function (response) {
+        commit(FIELDS.map(function (f) { return { op: "unset", path: f.path }; }));
+      }
+
+      function commit(ops) {
+        // The form owns the transport and the recovery read. A refused Host
+        // write resolves false; it must not be displayed as a successful save.
+        Promise.resolve().then(function () {
+          return scope.mutate(ops, snapshot.revision);
+        }).then(function (ok) {
+          var next = scope.getSnapshot();
+          setSnapshot(next);
           setBusy(false);
-          if (!response.result.ok) { setError(t("error")); return; }
+          if (!ok) { setError(t("error") + ": " + t("notApplied")); return; }
           setNotice(t("saved"));
-          if (response.result.value) setDraft(Object.assign({}, valueToDraft(response.result.value)));
+          if (next.value) setDraft(valueToDraft(next.value));
         }).catch(function (e) {
           setBusy(false); setError(t("error") + ": " + String(e && e.message || e));
         });
@@ -336,7 +331,7 @@ window.__ModuleLoader__.load({
       var out = {};
       for (var i = 0; i < FIELDS.length; i += 1) {
         var f = FIELDS[i];
-        out[f.key] = f.type === "checkbox" ? Boolean(getPath(value, f.path)) : String(getPath(value, f.path) ?? "");
+        out[f.key] = f.secret ? "" : f.type === "checkbox" ? Boolean(getPath(value, f.path)) : String(getPath(value, f.path) ?? "");
       }
       return out;
     }
@@ -346,16 +341,13 @@ window.__ModuleLoader__.load({
       var t = ctx.locale.bind(NS);
       ctx.effect(function () { return ctx.locale.register(NS, { zh: zh, en: en }); }, "dsh-tdai-memory: dictionaries");
       var scope = ctx.configForms.get("tdai-memory");
-      var api = ctx.connection.api;
-      ctx.slots.inject("settings.section", function () {
+      ctx.slots.inject("plugins.bundle.config", function () {
         return ctx.slots.register({
-          name: "settings.section",
-          id: "tdai-memory",
-          order: 26,
-          label: function () { return t("nav"); },
+          name: "plugins.bundle.config",
+          key: "dsh-tdai-memory",
           locale: NS
         }, function (props) {
-          return h(MemorySection, Object.assign({}, props, { scope: scope, api: api }));
+          return h(MemorySection, Object.assign({}, props, { scope: scope, t: t }));
         });
       });
     }

package/cordis.patch.yml

@@ -1,8 +1,8 @@
-# dsh-tdai-memory — bundle patch layer
-#
-# Declares the plugin as a Cordis loader entry, making the package a standard
-# profile bundle: `dsh plugin --profile <p> add dsh-tdai-memory` installs and
-# mounts it without manual cordis.patch.yml edits.
-- insert:
-    - id: tdai-memory
-      name: 'dsh-tdai-memory'
+# dsh-tdai-memory — bundle patch layer
+#
+# Declares the plugin as a Cordis loader entry, making the package a standard
+# profile bundle: `dsh plugin --profile <p> add dsh-tdai-memory` installs and
+# mounts it without manual cordis.patch.yml edits.
+- insert:
+    - id: tdai-memory
+      name: 'dsh-tdai-memory'

package/index.js

@@ -37,7 +37,7 @@ const Config = z.object({
   /** TDAI data directory; default: ~/.memory-tencentdb/memory-tdai. */
   dataDir: z.string().default(""),
   /** LLM used for L1/L2/L3 extraction (OpenAI-compatible). Falls back to TDAI_LLM_* env. */
-  llm: z.object({
+  llm: z.object({
     baseUrl: z.string().default(""),
     apiKey: z.string().default("").role("secret"),
     model: z.string().default(""),
@@ -52,34 +52,34 @@ const Config = z.object({
     sessionHeaderName: z.string().default("x-opencode-session"),
     /** Fixed session id for LLM requests; empty = persistent auto id. */
     sessionId: z.string().default(""),
-  }).default({}),
+  }).default({}),
   /** Embedding endpoint (OpenAI-compatible /v1/embeddings). */
-  embedding: z.object({
+  embedding: z.object({
     baseUrl: z.string().default("http://127.0.0.1:8088/v1"),
     apiKey: z.string().default("").role("secret"),
     model: z.string().default("Qwen3-Embedding-0.6B"),
     dimensions: z.number().default(1024),
     sendDimensions: z.boolean().default(false),
-  }).default({}),
+  }).default({}),
   /** Capture conversations into L0. */
   captureEnabled: z.boolean().default(true),
   /** L1 extraction pipeline (facts from conversations). */
-  extraction: z.object({
+  extraction: z.object({
     enabled: z.boolean().default(true),
     /** Conflict detection before storing; extra LLM call, disable if flaky.
      *  Off by default: dedup LLM output parsing is flaky (README matches). */
     enableDedup: z.boolean().default(false),
-  }).default({}),
+  }).default({}),
   /** Recall injection settings. */
-  recall: z.object({
+  recall: z.object({
     enabled: z.boolean().default(true),
     maxResults: z.number().default(5),
     scoreThreshold: z.number().default(0.3),
     timeoutMs: z.number().default(3000),
-  }).default({}),
+  }).default({}),
   /** Register the two search tools. */
   toolsEnabled: z.boolean().default(true),
-}).volatile();
+}).volatile();
 
 /**
  * Whether a derived message is real human input.
@@ -390,9 +390,9 @@ function apply(ctx, config) {
   // `installSettingsSection` export (the provider now lives at ctx.settings).
   // Inline the same logic via ctx.inject(["settings"]) — works on both
   // 0.1.1 (module export wrapper) and 0.1.2 (ctx.settings) hosts.
-  ctx.on("settings/document-updated", (id) => {
-    if (id === NS) ctx.logger.warn("[tdai-memory] settings updated; restart to apply (TdaiCore is built at startup)");
-  });
+  ctx.on("settings/document-updated", (id) => {
+    if (id === NS) ctx.logger.warn("[tdai-memory] settings updated; restart to apply (TdaiCore is built at startup)");
+  });
 
   // Fallback when no settings service ever mounts: build from the entry
   // config. One-shot — if the settings mount arrives later, its build
@@ -401,7 +401,7 @@ function apply(ctx, config) {
   setTimeout(() => {
     if (!builtOnce) {
       builtOnce = true;
-      void build(typeof config.get === "function" ? config.get() : config);
+      void build(typeof config.get === "function" ? config.get() : config);
     }
   }, 500);
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "dsh-tdai-memory",
-    "version": "0.3.6",
+    "version": "0.4.0",
     "description": "DeepSeek Harness 的 TencentDB Agent Memory 移植：L0 对话捕获 → L1 结构化记忆提取 → L2 场景/L3 画像，自动召回注入 + 记忆/对话搜索工具；复用现有 ~/.memory-tencentdb/memory-tdai 数据；附 Web UI 设置栏。",
     "type": "module",
     "main": "index.js",
@@ -17,7 +17,7 @@
             "platform": "web"
         },
         "compatibility": {
-            "dsh": ">=0.1.7-rc.1 <0.2.0 || 0.2.0-rc.2",
+            "dsh": ">=0.2.0-rc.2 <0.3.0",
             "dshReleases": {
                 "0.1.5-rc.2": "incompatible",
                 "0.1.5-rc.3": "incompatible",
@@ -25,8 +25,8 @@
                 "0.1.6-alpha.2": "unknown",
                 "0.1.7-alpha.1": "unknown",
                 "0.1.7-alpha.2": "unknown",
-                "0.1.7-rc.1": "compatible",
-                "0.1.7-rc.2": "compatible",
+                "0.1.7-rc.1": "incompatible",
+                "0.1.7-rc.2": "incompatible",
                 "0.2.0-rc.2": "compatible"
             },
             "node": ">=22.18",
@@ -82,8 +82,8 @@
     },
     "peerDependencies": {
         "react": "^18.2.0",
-        "@deepseek-ai/dsh-tools": "^0.1.7-rc.1 || 0.2.0-rc.2",
-        "@deepseek-ai/dsh-settings": "^0.1.7-rc.1 || 0.2.0-rc.2",
+        "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2 <0.3.0",
+        "@deepseek-ai/dsh-settings": ">=0.2.0-rc.2 <0.3.0",
         "node-llama-cpp": "^3.19.1"
     },
     "peerDependenciesMeta": {
@@ -92,6 +92,6 @@
         }
     },
     "scripts": {
-        "test": "node tests/settings-scope-compat.test.mjs && node tests/install-contract.test.mjs"
+        "test": "node tests/settings-scope-compat.test.mjs && node tests/install-contract.test.mjs && node --test tests/plugin-page.test.mjs tests/client-write-flow.test.mjs"
     }
 }

package/recall-inject.js

@@ -1,86 +1,86 @@
-/**
- * tdai-recall-inject — agent-plane recall injection row for dsh-tdai-memory.
- *
- * Mounted INSIDE an agent preset (agent.cordis.yml), this row listens on the
- * `system-prompt/assemble` waterfall in the preset's scope, so it runs for
- * every assembly of every agent joined to that preset (agent -> preset scope
- * chain). It asks the `tdaiMemory` service (provided by the root-level
- * dsh-tdai-memory plugin) for relevant long-term memories and appends them
- * as dynamic context sections (user-role snapshots):
- *
- *   - tdai:recall  — relevant L1 memories for the current user message
- *   - tdai:profile — stable persona / scene navigation context
- *
- * The recall call is bounded by `recall.timeoutMs`; failures degrade to no
- * injection and never break the assembly.
- */
-import z from "@deepseek-ai/schemastery";
-
-/** Cordis plugin name. */
-const name = "tdai-recall-inject";
-/** Services consumed: the prompt registry and the memory core service. */
-const inject = ["systemPrompt", "tdaiMemory"];
-
-/** Runtime schema for the recall-inject row. */
-const Config = z.object({
-  /** Skip recall when the user message is shorter than this. */
-  minUserTextChars: z.number().default(1),
-  /** Per-session cache TTL for identical user text (ms). */
-  cacheTtlMs: z.number().default(30_000),
-});
-
-function apply(ctx, config) {
-  const cache = new Map();
-
-  ctx.on("system-prompt/assemble", async (assembly, context) => {
-    try {
-      const agent = context?.agent;
-      if (!agent) return assembly;
-      const session = agent.session;
-      if (!session) return assembly;
-      // Only real human input triggers recall. DSH injects synthetic
-      // user-role context (system reminders, runtime context, skill
-      // catalogs, …) whose source.kind is not "user"; recalling on those
-      // would pollute the prompt with irrelevant memories (issue #1).
-      const lastUser = [...session.deriveMessages()]
-        .reverse()
-        .find((m) => m.role === "user" && (m.source == null || m.source.kind === "user"));
-      if (!lastUser) return assembly;
-      const text = extractText(lastUser.content);
-      if (!text || text.length < config.minUserTextChars) return assembly;
-
-      const now = Date.now();
-      const cached = cache.get(session.id);
-      if (cached && cached.text === text && now - cached.ts < config.cacheTtlMs) {
-        return injectRecall(assembly, cached.result);
-      }
-      const result = await ctx.tdaiMemory
-        .handleBeforeRecall(text, session.id)
-        .catch(() => null);
-      cache.set(session.id, { text, result: result ?? {}, ts: now });
-      return injectRecall(assembly, result ?? {});
-    } catch {
-      return assembly;
-    }
-  });
-}
-
-function extractText(content) {
-  if (typeof content === "string") return content.trim();
-  if (!Array.isArray(content)) return "";
-  return content
-    .filter((b) => b && b.type === "text" && typeof b.text === "string")
-    .map((b) => b.text)
-    .join("\n")
-    .trim();
-}
-
-function injectRecall(assembly, result) {
-  const extras = [];
-  if (result.prependContext) extras.push({ name: "tdai:recall", order: 1000, text: result.prependContext });
-  if (result.appendSystemContext) extras.push({ name: "tdai:profile", order: 1001, text: result.appendSystemContext });
-  if (extras.length === 0) return assembly;
-  return { ...assembly, contexts: [...assembly.contexts, ...extras] };
-}
-
-export { Config, apply, inject, name };
+/**
+ * tdai-recall-inject — agent-plane recall injection row for dsh-tdai-memory.
+ *
+ * Mounted INSIDE an agent preset (agent.cordis.yml), this row listens on the
+ * `system-prompt/assemble` waterfall in the preset's scope, so it runs for
+ * every assembly of every agent joined to that preset (agent -> preset scope
+ * chain). It asks the `tdaiMemory` service (provided by the root-level
+ * dsh-tdai-memory plugin) for relevant long-term memories and appends them
+ * as dynamic context sections (user-role snapshots):
+ *
+ *   - tdai:recall  — relevant L1 memories for the current user message
+ *   - tdai:profile — stable persona / scene navigation context
+ *
+ * The recall call is bounded by `recall.timeoutMs`; failures degrade to no
+ * injection and never break the assembly.
+ */
+import z from "@deepseek-ai/schemastery";
+
+/** Cordis plugin name. */
+const name = "tdai-recall-inject";
+/** Services consumed: the prompt registry and the memory core service. */
+const inject = ["systemPrompt", "tdaiMemory"];
+
+/** Runtime schema for the recall-inject row. */
+const Config = z.object({
+  /** Skip recall when the user message is shorter than this. */
+  minUserTextChars: z.number().default(1),
+  /** Per-session cache TTL for identical user text (ms). */
+  cacheTtlMs: z.number().default(30_000),
+});
+
+function apply(ctx, config) {
+  const cache = new Map();
+
+  ctx.on("system-prompt/assemble", async (assembly, context) => {
+    try {
+      const agent = context?.agent;
+      if (!agent) return assembly;
+      const session = agent.session;
+      if (!session) return assembly;
+      // Only real human input triggers recall. DSH injects synthetic
+      // user-role context (system reminders, runtime context, skill
+      // catalogs, …) whose source.kind is not "user"; recalling on those
+      // would pollute the prompt with irrelevant memories (issue #1).
+      const lastUser = [...session.deriveMessages()]
+        .reverse()
+        .find((m) => m.role === "user" && (m.source == null || m.source.kind === "user"));
+      if (!lastUser) return assembly;
+      const text = extractText(lastUser.content);
+      if (!text || text.length < config.minUserTextChars) return assembly;
+
+      const now = Date.now();
+      const cached = cache.get(session.id);
+      if (cached && cached.text === text && now - cached.ts < config.cacheTtlMs) {
+        return injectRecall(assembly, cached.result);
+      }
+      const result = await ctx.tdaiMemory
+        .handleBeforeRecall(text, session.id)
+        .catch(() => null);
+      cache.set(session.id, { text, result: result ?? {}, ts: now });
+      return injectRecall(assembly, result ?? {});
+    } catch {
+      return assembly;
+    }
+  });
+}
+
+function extractText(content) {
+  if (typeof content === "string") return content.trim();
+  if (!Array.isArray(content)) return "";
+  return content
+    .filter((b) => b && b.type === "text" && typeof b.text === "string")
+    .map((b) => b.text)
+    .join("\n")
+    .trim();
+}
+
+function injectRecall(assembly, result) {
+  const extras = [];
+  if (result.prependContext) extras.push({ name: "tdai:recall", order: 1000, text: result.prependContext });
+  if (result.appendSystemContext) extras.push({ name: "tdai:profile", order: 1001, text: result.appendSystemContext });
+  if (extras.length === 0) return assembly;
+  return { ...assembly, contexts: [...assembly.contexts, ...extras] };
+}
+
+export { Config, apply, inject, name };

package/vendor/tdai/adapters/index.js

@@ -1,15 +1,15 @@
-/**
- * TDAI Adapters — barrel re-export for all host adapter implementations.
- *
- * Each adapter translates a specific host environment's API into
- * the host-neutral HostAdapter interface consumed by TdaiCore.
- *
- * Directory structure:
- *   adapters/
- *   ├── openclaw/      — OpenClaw plugin host (in-process, runEmbeddedPiAgent)
- *   └── standalone/    — Gateway / Hermes sidecar (HTTP, OpenAI-compatible API)
- */
-// OpenClaw adapter
-export { OpenClawHostAdapter, OpenClawLLMRunner, OpenClawLLMRunnerFactory } from "./openclaw/index.js";
-// Standalone adapter
-export { StandaloneHostAdapter, StandaloneLLMRunner, StandaloneLLMRunnerFactory } from "./standalone/index.js";
+/**
+ * TDAI Adapters — barrel re-export for all host adapter implementations.
+ *
+ * Each adapter translates a specific host environment's API into
+ * the host-neutral HostAdapter interface consumed by TdaiCore.
+ *
+ * Directory structure:
+ *   adapters/
+ *   ├── openclaw/      — OpenClaw plugin host (in-process, runEmbeddedPiAgent)
+ *   └── standalone/    — Gateway / Hermes sidecar (HTTP, OpenAI-compatible API)
+ */
+// OpenClaw adapter
+export { OpenClawHostAdapter, OpenClawLLMRunner, OpenClawLLMRunnerFactory } from "./openclaw/index.js";
+// Standalone adapter
+export { StandaloneHostAdapter, StandaloneLLMRunner, StandaloneLLMRunnerFactory } from "./standalone/index.js";