@aki_riko/hymem-dsh 0.0.0-stage → 0.1.0

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @aki_riko/hymem-dsh —— Hy-Memory 的 DSH 适配层（单插件）。
+ *
+ * 四块职责：
+ *   1. tools     7 个记忆工具 → Hy-Memory HTTP
+ *   2. soul      文件式 SOUL 注入 system prompt（静止：只有 compaction/end 才重读）
+ *   3. resident  compaction/end 后一次性注入常驻记忆（数据来自 Hy-Memory）
+ *   4. curator   定时整理（后续版本；本版留接口）
+ *
+ * 设计铁律（2026-10-26）：
+ *   - 不依赖 memoryd / dream，Hy-Memory 是唯一后端
+ *   - SOUL 静止、不动态注入，检索只靠主动 tool call
+ *   - 子代理会话不注入 SOUL/MEMORY（防人格污染）
+ */
+import type { Context } from "@deepseek-ai/cordis";
+export declare const name = "riko-hymem";
+export declare const inject: string[];
+export type Config = Record<string, unknown>;
+export declare function apply(ctx: Context, config?: Config): void;

package/dist/index.js

@@ -0,0 +1,158 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { resolve } from "node:path";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+import { resolveConfig, isWorkspaceAllowed, isTopLevelSession } from "./config.js";
+import { HyClient } from "./client.js";
+import { buildHyTools } from "./tools.js";
+import { setupCapture } from "./capture.js";
+import { renderResident } from "./resident.js";
+export const name = "riko-hymem";
+export const inject = ["tools"];
+const SOUL_SECTION_NAME = "riko-soul";
+const SOUL_SECTION_ORDER = 100;
+function makeLogger(ctx) {
+    const anyCtx = ctx;
+    const l = anyCtx.logger;
+    return {
+        warn: (m) => l?.warn(m),
+        error: (m) => l?.error(m),
+        info: (m) => l?.info(m),
+    };
+}
+/** 注入进 prompt 的文本要转义，避免被当成 XML 指令执行。 */
+function escapeXmlData(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+/** 在每个顶层 Agent 的 ctx 上挂 hook（DSH 的 agent/created 模式）。 */
+function registerPerAgent(ctx, event, hook, workspaceAllow) {
+    const host = ctx;
+    host.on("agent/created", (payload) => {
+        const header = payload?.agent?.session?.header;
+        if (!isTopLevelSession(header))
+            return;
+        if (!isWorkspaceAllowed(workspaceAllow, header?.cwd))
+            return;
+        const agentCtx = payload.agent.ctx;
+        agentCtx.on(event, hook);
+    });
+}
+export function apply(ctx, config = {}) {
+    const cfg = resolveConfig(config);
+    const logger = makeLogger(ctx);
+    const client = new HyClient({
+        baseUrl: cfg.hyMemoryUrl,
+        userId: cfg.userId,
+        timeoutMs: cfg.timeoutMs,
+        logger,
+    });
+    // ---------- 1. 记忆工具 ----------
+    if (cfg.toolsEnabled) {
+        const tools = buildHyTools(client);
+        const registry = ctx.tools;
+        for (const tool of tools) {
+            registry.register(tool);
+        }
+        logger.info?.(`riko-hymem: 已注册记忆工具 (user_id=${cfg.userId}, url=${cfg.hyMemoryUrl})`);
+    }
+    // ---------- 2. SOUL 注入 ----------
+    if (cfg.soulEnabled) {
+        const soulPath = cfg.soulFile
+            ? resolve(cfg.soulFile)
+            : fileURLToPath(new URL("../soul.md", import.meta.url));
+        let soulText = "";
+        const loadSoul = (reason) => {
+            try {
+                soulText = readFileSync(soulPath, "utf8");
+                logger.info?.(`riko-hymem: SOUL 已读取 (${reason}, ${soulText.length} 字符)`);
+            }
+            catch (error) {
+                // 读失败保留旧文本：prompt 前缀绝不能抖动（否则 prompt cache 全废）
+                logger.warn(`riko-hymem: SOUL 读取失败，保留旧缓存 ${error instanceof Error ? error.message : String(error)}`);
+            }
+        };
+        loadSoul("startup");
+        // SOUL 静止：只有 compact 结束才重读（爹地要求）
+        ctx.on("session/event", (session, event) => {
+            if (event?.type !== "compaction/end")
+                return;
+            if (!isTopLevelSession(session?.header))
+                return;
+            loadSoul("compaction/end");
+        });
+        const soulHook = async (assembly, context, next) => {
+            const result = (await next());
+            const ctxInfo = context;
+            const header = ctxInfo.agent?.session?.header;
+            if (!isTopLevelSession(header))
+                return result;
+            if (!isWorkspaceAllowed(cfg.workspaceAllow, header?.cwd))
+                return result;
+            if (cfg.targetAgent && String(ctxInfo.agent?.id ?? "") !== cfg.targetAgent)
+                return result;
+            if (result.sections.some((s) => s.name === SOUL_SECTION_NAME))
+                return result;
+            if (!soulText.trim())
+                return result;
+            result.sections.push({
+                name: SOUL_SECTION_NAME,
+                order: SOUL_SECTION_ORDER,
+                text: `<agent_memory:soul version="0">\n${escapeXmlData(soulText)}\n</agent_memory:soul>`,
+                interpolate: false,
+            });
+            return result;
+        };
+        registerPerAgent(ctx, "system-prompt/assemble", soulHook, cfg.workspaceAllow);
+    }
+    // ---------- 3. 常驻记忆（compact 后一次）----------
+    if (cfg.residentEnabled) {
+        let pending = false;
+        ctx.on("session/event", (session, event) => {
+            if (event?.type !== "compaction/end")
+                return;
+            if (!isTopLevelSession(session?.header))
+                return;
+            pending = true;
+        });
+        const residentHook = async (payload, next) => {
+            const decision = (await next());
+            if (!pending)
+                return decision;
+            pending = false;
+            const p = payload;
+            if (!isTopLevelSession(p.agent?.session?.header))
+                return decision;
+            if (decision?.kind !== "enter" || p.signal?.aborted)
+                return decision;
+            try {
+                const text = await renderResident(client, cfg.residentBudgetChars, logger, p.signal);
+                if (!text)
+                    return decision;
+                const message = createUserMessage({
+                    content: [
+                        {
+                            type: "text",
+                            text: `<agent_memory:resident>\n${escapeXmlData(text)}\n</agent_memory:resident>`,
+                        },
+                    ],
+                    // dsh-llm 的 source 类型是封闭枚举：注入的记忆按"系统提供的召回"标记。
+                    source: { kind: "system-prompt", form: "recall" },
+                });
+                return { ...decision, messages: [message, ...(decision.messages ?? [])] };
+            }
+            catch (error) {
+                logger.warn(`riko-hymem: 常驻记忆注入失败 ${error instanceof Error ? error.message : String(error)}`);
+                return decision;
+            }
+        };
+        registerPerAgent(ctx, "agent/pre-step", residentHook, cfg.workspaceAllow);
+    }
+    // ---------- 4. 自动捕获（默认关，写入交给 hy-sync）----------
+    if (cfg.captureEnabled) {
+        const cleanupCapture = setupCapture(ctx, client, cfg, logger);
+        ctx.effect(() => cleanupCapture);
+        logger.info?.(`riko-hymem: 已启用消息捕获 (workspaceAllow=${JSON.stringify(cfg.workspaceAllow)})`);
+    }
+    logger.info?.(`riko-hymem: 插件加载完成 tools=${cfg.toolsEnabled} soul=${cfg.soulEnabled} resident=${cfg.residentEnabled} url=${cfg.hyMemoryUrl}`);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/resident.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resident（常驻记忆）渲染器。
+ *
+ * 设计（2026-10-26 定稿）：
+ * - compact 后注入一次，平时零占用
+ * - 数据全部来自 Hy-Memory，不再依赖 memoryd / dream
+ * - 三源合并：L0 画像 + L6 行为模式（图库）+ L2 关键事实 / L7 未完成打算
+ * - 按字符预算截断，超预算先砍细节
+ */
+import type { HyClient } from "./client.js";
+import type { Logger } from "./types.js";
+export declare function renderResident(client: HyClient, budgetChars: number, logger: Logger, signal?: AbortSignal): Promise<string | null>;

package/dist/resident.js

@@ -0,0 +1,59 @@
+function textOf(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+export async function renderResident(client, budgetChars, logger, signal) {
+    const blocks = [];
+    // 1) L0：爹地的稳定信息
+    try {
+        const r = await client.getUserProfile({}, signal);
+        const data = (r.data ?? {});
+        const profile = data.profile;
+        if (profile && typeof profile === "object") {
+            const lines = Object.entries(profile)
+                .map(([key, value]) => [key, textOf(value)])
+                .filter(([, value]) => value.length > 0)
+                .map(([key, value]) => `- ${key}：${value}`);
+            if (lines.length > 0)
+                blocks.push(`## 爹地的稳定信息\n${lines.join("\n")}`);
+        }
+    }
+    catch (error) {
+        logger.warn(`resident: user_profile 读取失败 ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // 2) L6 / L2 / L7：一次 list 全拿
+    try {
+        const r = await client.list({ limit: 100 }, signal);
+        const data = (r.data ?? {});
+        const nodes = Array.isArray(data.graph?.nodes) ? data.graph.nodes : [];
+        const memories = Array.isArray(data.vdb?.memories) ? data.vdb.memories : [];
+        const patterns = nodes.map((n) => textOf(n?.content)).filter((t) => t.length > 0);
+        if (patterns.length > 0) {
+            blocks.push("## 行为模式（跨会话归纳）\n" + patterns.map((t) => `- ${t}`).join("\n"));
+        }
+        const facts = memories
+            .filter((m) => m?.layer === "l2_fact")
+            .map((m) => textOf(m?.content))
+            .filter((t) => t.length > 0);
+        if (facts.length > 0) {
+            blocks.push("## 关键事实\n" + facts.map((t) => `- ${t}`).join("\n"));
+        }
+        const plans = memories
+            .filter((m) => m?.layer === "l7_intention")
+            .map((m) => textOf(m?.content))
+            .filter((t) => t.length > 0);
+        if (plans.length > 0) {
+            blocks.push("## 之前留下的打算\n" + plans.map((t) => `- ${t}`).join("\n"));
+        }
+    }
+    catch (error) {
+        logger.warn(`resident: list 读取失败 ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (blocks.length === 0)
+        return null;
+    let text = "# 长期记忆（Hy-Memory 自动渲染）\n\n" + blocks.join("\n\n");
+    if (text.length > budgetChars) {
+        text = text.slice(0, budgetChars).trimEnd() + "\n- …（已达预算上限，其余略）";
+    }
+    return text;
+}
+//# sourceMappingURL=resident.js.map

package/dist/resident.js.map

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

package/dist/soul.d.ts

@@ -0,0 +1,18 @@
+import type { Context } from "@deepseek-ai/cordis";
+export declare const TWIN_SOUL_SECTION_NAME = "twin-soul";
+export declare const TWIN_SOUL_SECTION_ORDER = 100;
+/** Default template lives beside the package's dist/ directory and is user-editable. */
+export declare function defaultSoulFilePath(): string;
+export interface FileSoulWatcher {
+    getText(): string;
+    close(): void;
+}
+/** Create a hot-reloading watcher for a local soul file. */
+export declare function createFileSoulWatcher(soulFile?: string, onChange?: () => void, logger?: {
+    warn(msg: string): void;
+}): FileSoulWatcher;
+/**
+ * @deprecated B1 编排收口：默认只走内核 Soul（order 10300）；
+ * 全局 twin-soul（order 100）平行注入已废弃。若需文件覆盖，使用 config.fileSoulEnabled opt-in。
+ */
+export declare function registerTwinSoul(ctx: Context, soulFile?: string): void;

package/dist/soul.js

@@ -0,0 +1,151 @@
+/**
+ * File-based twin personality.
+ *
+ * B1 编排收口：内核 Soul（order 10300，按 agent 隔离）是单一真相源。
+ * 本模块提供文件监听与读取辅助（createFileSoulWatcher）；旧版全局平行注入
+ * registerTwinSoul 已废弃，默认不再调用。
+ */
+import { readFile, readFileSync, watch } from "node:fs";
+import { basename, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export const TWIN_SOUL_SECTION_NAME = "twin-soul";
+export const TWIN_SOUL_SECTION_ORDER = 100;
+/** Default template lives beside the package's dist/ directory and is user-editable. */
+export function defaultSoulFilePath() {
+    const configured = process.env.RIKO_DSH_SOUL_FILE;
+    return configured
+        ? resolve(configured)
+        : fileURLToPath(new URL("../soul.md", import.meta.url));
+}
+function warn(ctx, message) {
+    const logger = ctx.logger;
+    logger?.warn?.(`riko-dsh: ${message}`);
+}
+/** Create a hot-reloading watcher for a local soul file. */
+export function createFileSoulWatcher(soulFile = defaultSoulFilePath(), onChange, logger) {
+    const path = resolve(soulFile);
+    let soulText = "";
+    try {
+        soulText = readFileSync(path, "utf8");
+    }
+    catch (error) {
+        logger?.warn(`soul 文件无法读取: ${path} (${error instanceof Error ? error.message : String(error)})`);
+    }
+    let watcher;
+    let reloadTimer;
+    const reload = () => {
+        readFile(path, "utf8", (error, nextText) => {
+            if (error) {
+                if (error.code === "ENOENT") {
+                    nextText = "";
+                }
+                else {
+                    logger?.warn(`soul 文件重载失败: ${path} (${error.message})`);
+                    return;
+                }
+            }
+            if (nextText === soulText)
+                return;
+            soulText = nextText;
+            try {
+                onChange?.();
+            }
+            catch (emitError) {
+                logger?.warn(`system prompt 更新通知失败: ${emitError instanceof Error ? emitError.message : String(emitError)}`);
+            }
+        });
+    };
+    try {
+        watcher = watch(dirname(path), (_eventType, filename) => {
+            if (filename !== null && filename.toString() !== basename(path))
+                return;
+            if (reloadTimer !== undefined)
+                clearTimeout(reloadTimer);
+            reloadTimer = setTimeout(() => {
+                reloadTimer = undefined;
+                reload();
+            }, 40);
+        });
+        watcher.on("error", (error) => logger?.warn(`soul 文件监听失败: ${error.message}`));
+    }
+    catch (error) {
+        logger?.warn(`soul 文件监听无法启动: ${path} (${error instanceof Error ? error.message : String(error)})`);
+    }
+    return {
+        getText: () => soulText,
+        close: () => {
+            if (reloadTimer !== undefined)
+                clearTimeout(reloadTimer);
+            watcher?.close();
+        },
+    };
+}
+/**
+ * @deprecated B1 编排收口：默认只走内核 Soul（order 10300）；
+ * 全局 twin-soul（order 100）平行注入已废弃。若需文件覆盖，使用 config.fileSoulEnabled opt-in。
+ */
+export function registerTwinSoul(ctx, soulFile = defaultSoulFilePath()) {
+    const path = resolve(soulFile);
+    ctx.effect(() => {
+        let soulText = "";
+        try {
+            soulText = readFileSync(path, "utf8");
+        }
+        catch (error) {
+            warn(ctx, `soul 文件无法读取: ${path} (${error instanceof Error ? error.message : String(error)})`);
+        }
+        const removeSection = ctx.systemPrompt.section({
+            name: TWIN_SOUL_SECTION_NAME,
+            order: TWIN_SOUL_SECTION_ORDER,
+            text: () => soulText,
+            interpolate: false,
+        });
+        let watcher;
+        let reloadTimer;
+        const reload = () => {
+            readFile(path, "utf8", (error, nextText) => {
+                if (error) {
+                    if (error.code === "ENOENT") {
+                        nextText = "";
+                    }
+                    else {
+                        warn(ctx, `soul 文件重载失败: ${path} (${error.message})`);
+                        return;
+                    }
+                }
+                if (nextText === soulText)
+                    return;
+                soulText = nextText;
+                try {
+                    ctx.emit("system-prompt/change");
+                }
+                catch (emitError) {
+                    warn(ctx, `system prompt 更新通知失败: ${emitError instanceof Error ? emitError.message : String(emitError)}`);
+                }
+            });
+        };
+        try {
+            watcher = watch(dirname(path), (_eventType, filename) => {
+                if (filename !== null && filename.toString() !== basename(path))
+                    return;
+                if (reloadTimer !== undefined)
+                    clearTimeout(reloadTimer);
+                reloadTimer = setTimeout(() => {
+                    reloadTimer = undefined;
+                    reload();
+                }, 40);
+            });
+            watcher.on("error", (error) => warn(ctx, `soul 文件监听失败: ${error.message}`));
+        }
+        catch (error) {
+            warn(ctx, `soul 文件监听无法启动: ${path} (${error instanceof Error ? error.message : String(error)})`);
+        }
+        return () => {
+            if (reloadTimer !== undefined)
+                clearTimeout(reloadTimer);
+            watcher?.close();
+            removeSection();
+        };
+    }, "riko-dsh.twin-soul");
+}
+//# sourceMappingURL=soul.js.map

package/dist/soul.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "@deepseek-ai/dsh-tools";
+import type { HyClient } from "./client.js";
+export declare function buildHyTools(client: HyClient): ToolDefinition[];

package/dist/tools.js

@@ -0,0 +1,183 @@
+import { defineTool } from "@deepseek-ai/dsh-tools";
+const RESULT_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        ok: { type: "boolean", required: true },
+        data: { type: "json" },
+        error: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                code: { type: "string", required: true },
+                message: { type: "string", required: true },
+            },
+        },
+    },
+};
+function renderResult(_args, value) {
+    return [{ type: "text", text: JSON.stringify(value) }];
+}
+function toToolResult(r) {
+    if (r.ok) {
+        return { ok: true, data: (r.data ?? null) };
+    }
+    return { ok: false, error: r.error };
+}
+export function buildHyTools(client) {
+    return [
+        defineTool({
+            name: "memory_search",
+            description: "搜索相关的长期记忆。根据 query 检索语义或词法相关的记忆列表。",
+            parameters: {
+                query: { type: "string", required: true, description: "描述要查找的记忆内容" },
+                limit: { type: "number", description: "返回数量上限，默认 5" },
+                user_ids: { type: "json", description: "可选的用户 ID 列表（例如 [\"riko\"]，默认当前配置的用户）" },
+                scene: {
+                    type: "string",
+                    description: "检索场景：chat（闲聊）或 productivity（coding/工作）。查技术经验时用 productivity 能命中 coding 记忆链路",
+                },
+                intention_limit: { type: "number", description: "返回多少条 L7 前瞻意图/计划，默认 0" },
+                search_mode: { type: "string", description: "检索模式，默认 default；hybrid 强调词法+向量融合" },
+                queries: {
+                    type: "json",
+                    description: "多查询数组：同一意图换个说法多路检索再融合，例如 [\"记忆架构\",\"插件怎么拆\"]",
+                },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                if (!args.query || typeof args.query !== "string" || !args.query.trim()) {
+                    return { ok: false, error: { code: "INVALID_FIELD", message: "query 必填且不能为空" } };
+                }
+                const userIds = Array.isArray(args.user_ids)
+                    ? args.user_ids.filter((u) => typeof u === "string" && u.trim().length > 0)
+                    : undefined;
+                return toToolResult(await client.search({
+                    query: args.query.trim(),
+                    limit: args.limit,
+                    user_ids: userIds,
+                    scene: args.scene,
+                    intention_limit: args.intention_limit,
+                    search_mode: args.search_mode,
+                    queries: Array.isArray(args.queries)
+                        ? args.queries.filter((q) => typeof q === "string")
+                        : undefined,
+                }, exec?.signal));
+            },
+        }),
+        defineTool({
+            name: "memory_get",
+            description: "根据记忆 ID 获取单条记忆详情。ID 须来自 memory_search 或记忆工具的回执。",
+            parameters: {
+                id: { type: "string", required: true, description: "记忆 ID (UUID 格式)" },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                if (!args.id || typeof args.id !== "string" || !args.id.trim()) {
+                    return { ok: false, error: { code: "INVALID_FIELD", message: "id 必填且不能为空" } };
+                }
+                return toToolResult(await client.get(args.id.trim(), exec?.signal));
+            },
+        }),
+        defineTool({
+            name: "memory_profile",
+            description: "读取用户的 L0 长期画像（姓名、职业、所在地、雇主等稳定字段）。想知道\"用户是谁\"或做个性化称呼时先调这个，比 search 更省 token。",
+            parameters: {
+                user_id: { type: "string", description: "可选用户 ID，默认当前配置的用户" },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                return toToolResult(await client.getUserProfile({ user_id: args.user_id?.trim() || undefined }, exec?.signal));
+            },
+        }),
+        defineTool({
+            name: "memory_remember",
+            description: "持久保存记忆到 Hy-Memory。两种用法：(1) 官方主推——传 messages 数组（完整对话），由 SDK 自己提取原子事实，带上下文更准；(2) 简化——传 text 一句话。二者选一。",
+            parameters: {
+                text: { type: "string", description: "要保存的记忆正文（与 messages 二选一）" },
+                messages: {
+                    type: "json",
+                    description: "官方主推方式：传完整对话消息数组（每项含 role 和 content），由 SDK 自己提取事实；与 text 二选一",
+                },
+                user_id: { type: "string", description: "可选用户 ID，默认当前配置" },
+                session_id: { type: "string", description: "可选会话 ID，传 messages 时建议带上" },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                const hasMessages = Array.isArray(args.messages) && args.messages.length > 0;
+                const hasText = typeof args.text === "string" && args.text.trim().length > 0;
+                if (!hasMessages && !hasText) {
+                    return {
+                        ok: false,
+                        error: { code: "INVALID_FIELD", message: "text 或 messages 必须提供一个" },
+                    };
+                }
+                // 2026-10-26 审计修正：
+                // 纯 text 是调用方已经提炼好的事实 → 走 add_extracted，跳过 LLM 提取（1-2 秒）
+                // messages 是原始对话 → 走 add，让 SDK 自己提取
+                if (hasText && !hasMessages) {
+                    return toToolResult(await client.addExtracted({
+                        contents: args.text.trim(),
+                        user_id: args.user_id?.trim() || undefined,
+                        session_id: args.session_id?.trim() || undefined,
+                    }, exec?.signal));
+                }
+                return toToolResult(await client.add({
+                    messages: args.messages,
+                    user_id: args.user_id?.trim() || undefined,
+                    session_id: args.session_id?.trim() || undefined,
+                }, exec?.signal));
+            },
+        }),
+        defineTool({
+            name: "memory_correct",
+            description: "纠正或更新已有的记忆内容。将指定 ID 的记忆内容替换为新的文本。",
+            parameters: {
+                id: { type: "string", required: true, description: "需要更新的记忆 ID" },
+                text: { type: "string", required: true, description: "纠正后的新记忆文本" },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                if (!args.id || typeof args.id !== "string" || !args.id.trim()) {
+                    return { ok: false, error: { code: "INVALID_FIELD", message: "id 必填且不能为空" } };
+                }
+                if (!args.text || typeof args.text !== "string" || !args.text.trim()) {
+                    return { ok: false, error: { code: "INVALID_FIELD", message: "text 必填且不能为空" } };
+                }
+                return toToolResult(await client.update(args.id.trim(), {
+                    text: args.text.trim(),
+                }, exec?.signal));
+            },
+        }),
+        defineTool({
+            name: "memory_forget",
+            description: "删除或遗忘指定的记忆内容。",
+            parameters: {
+                id: { type: "string", required: true, description: "需要删除的记忆 ID" },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                if (!args.id || typeof args.id !== "string" || !args.id.trim()) {
+                    return { ok: false, error: { code: "INVALID_FIELD", message: "id 必填且不能为空" } };
+                }
+                return toToolResult(await client.delete(args.id.trim(), exec?.signal));
+            },
+        }),
+        defineTool({
+            name: "memory_list",
+            description: "列出当前用户的记忆列表（分页查看）。",
+            parameters: {
+                limit: { type: "number", description: "返回数量上限，默认 20" },
+                user_id: { type: "string", description: "可选的用户 ID，默认当前配置的用户" },
+            },
+            output: { schema: RESULT_SCHEMA, render: renderResult },
+            async execute(args, exec) {
+                return toToolResult(await client.list({
+                    limit: args.limit,
+                    user_id: args.user_id?.trim() || undefined,
+                }, exec?.signal));
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=tools.js.map