@downcity/plugins 1.0.253 → 1.0.280

package/bin/memory/Action.js

@@ -1,39 +1,20 @@
 /**
- * Memory Plugin action 逻辑。
+ * Memory Plugin action 适配层。
  *
  * 关键点（中文）
- * - action 面向 agent 的记忆语义：search/read/remember/digest/revise。
- * - 原始证据先进入 sources，长期知识进入 wiki。
- * - LLM digest/revise 能力由 MemoryPlugin constructor 注入。
+ * - Action 只把 Agent/Session 上下文映射为 MemoryProvider 的领域输入。
+ * - 物理存储、检索实现和提炼策略全部属于 Provider。
+ * - 所有 Provider 异常都转换为稳定 PluginActionResult，不伪造成功。
  */
-import { isTextUIPart } from "ai";
-import { collectMemoryStatus, searchMemory, } from "./runtime/Search.js";
-import { MEMORY_DEFAULTS, } from "./runtime/Store.js";
-import { appendManualSource, appendMemoryRevision, appendWikiPage, readMemory, readWikiIndex, writeSessionSource, writeWikiPage, } from "./runtime/Writer.js";
-function toUiParts(message) {
-    const candidate = message;
-    return Array.isArray(candidate?.parts)
-        ? candidate.parts
-        : [];
-}
-function extractReadableLine(message) {
-    const candidate = message;
-    const raw_role = String(candidate?.role || "").toLowerCase();
-    if (raw_role !== "user" && raw_role !== "assistant")
-        return "";
-    const role = raw_role === "user" ? "User" : "Assistant";
-    const text = toUiParts(message)
-        .filter(isTextUIPart)
-        .map((part) => String(part.text || "").trim())
-        .filter(Boolean)
-        .join("\n")
-        .trim();
-    if (!text) {
-        return "";
-    }
-    return `${role}: ${text}`;
+/** 从 PluginContext 构造当前 Runtime 的默认 Memory scope。 */
+export function create_memory_scope(context, session_id) {
+    return {
+        agent_id: context.agent_id,
+        workspace_id: context.workspace_path,
+        ...(session_id ? { session_id } : {}),
+    };
 }
-/** 从 canonical Session Message 提取 Memory digest 文本。 */
+/** 从 canonical Session Message 提取可供 Provider 提炼的文本。 */
 function extract_session_message_line(message) {
     if (message.type !== "user" && message.type !== "assistant")
         return "";
@@ -45,303 +26,82 @@ function extract_session_message_line(message) {
         .trim();
     return text ? `${role}: ${text}` : "";
 }
-function readDigestPages(result) {
-    if (typeof result === "string") {
-        return {
-            pages: [{ title: "Memory Digest", content: result, tags: ["memory", "digest"] }],
-        };
-    }
-    return {
-        pages: result.pages,
-        summary: result.summary,
-    };
-}
-function readReviseResult(result, fallbackPath) {
-    if (typeof result === "string") {
-        return {
-            path: fallbackPath,
-            content: result,
-        };
-    }
-    return {
-        path: result.path || fallbackPath,
-        content: result.content,
-        summary: result.summary,
-    };
-}
-function slugify(value) {
-    const text = String(value || "")
-        .trim()
-        .toLowerCase()
-        .replace(/[^\p{L}\p{N}]+/gu, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 80);
-    return text || "inbox";
-}
-function toWikiMemoryPath(value) {
-    const clean = String(value || "").replace(/\\/g, "/").replace(/^\/+/, "").trim();
-    if (!clean)
-        return ".downcity/memory/wiki/inbox.md";
-    if (clean.startsWith(".downcity/memory/wiki/")) {
-        return clean.toLowerCase().endsWith(".md") ? clean : `${clean}.md`;
-    }
-    const withoutPrefix = clean.replace(/^wiki\//, "");
-    const withExt = withoutPrefix.toLowerCase().endsWith(".md")
-        ? withoutPrefix
-        : `${withoutPrefix}.md`;
-    return `.downcity/memory/wiki/${withExt}`;
-}
-/**
- * status action。
- */
-export async function statusMemoryAction(context, state) {
+/** 执行 Provider 调用并统一失败语义。 */
+async function run_provider_action(action) {
     try {
-        const stats = await collectMemoryStatus(context, state);
-        return {
-            success: true,
-            data: stats,
-        };
+        return { success: true, data: await action() };
     }
     catch (error) {
         return {
             success: false,
-            error: String(error),
+            error: error instanceof Error ? error.message : String(error),
         };
     }
 }
-/**
- * search action。
- */
-export async function searchMemoryAction(context, state, payload) {
-    try {
-        const response = await searchMemory(context, state, payload);
-        return {
-            success: true,
-            data: response,
-        };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: String(error),
-        };
-    }
+/** status action。 */
+export async function status_memory_action(provider) {
+    return await run_provider_action(async () => await provider.status());
 }
-/**
- * read action。
- */
-export async function readMemoryAction(context, payload) {
-    try {
-        const data = await readMemory(context, payload);
-        return { success: true, data: data };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: String(error),
-        };
-    }
+/** search action，内部委托 Provider recall。 */
+export async function search_memory_action(context, provider, input) {
+    return await run_provider_action(async () => await provider.recall({
+        ...input,
+        scope: create_memory_scope(context),
+    }));
 }
-/**
- * remember action。
- */
-export async function rememberMemoryAction(context, options, payload) {
-    try {
-        const content = String(payload.content || "").trim();
-        if (!content) {
-            throw new Error("content is required");
-        }
-        const source = await appendManualSource(context, content, payload.source);
-        const targetPath = toWikiMemoryPath(payload.path || slugify(payload.topic || "inbox"));
-        if (options.revise) {
-            const current = await readMemory(context, { path: targetPath }).catch(() => ({
-                path: targetPath,
-                text: "",
-            }));
-            const revised = readReviseResult(await options.revise({
-                rootPath: context.workspace_path,
-                path: targetPath,
-                currentContent: current.text,
-                instruction: "Integrate this new memory into the wiki page. Deduplicate and keep it concise.",
-                evidence: `${content}\n\nSource: ${source.path}`,
-            }), targetPath);
-            const written = await writeWikiPage(context, {
-                path: revised.path,
-                title: payload.topic,
-                content: revised.content,
-                tags: ["memory"],
-            });
-            const response = {
-                sourcePath: source.path,
-                wikiPath: written.path,
-                mode: "revised",
-                writtenChars: written.writtenChars,
-                summary: revised.summary,
-            };
-            return { success: true, data: response };
-        }
-        const written = await appendWikiPage(context, {
-            path: targetPath,
-            title: payload.topic || "Memory Inbox",
-            content,
-            sourcePath: source.path,
-        });
-        const response = {
-            sourcePath: source.path,
-            wikiPath: written.path,
-            mode: "appended",
-            writtenChars: written.writtenChars,
-        };
-        return { success: true, data: response };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: String(error),
-        };
-    }
+/** read action。 */
+export async function read_memory_action(context, provider, input) {
+    return await run_provider_action(async () => await provider.read({
+        ...input,
+        scope: create_memory_scope(context),
+    }));
 }
-/**
- * digest action。
- */
-export async function digestMemoryAction(context, options, payload) {
-    try {
-        const session_id = String(payload.session_id || "").trim();
-        if (!session_id) {
+/** remember action。 */
+export async function remember_memory_action(context, provider, input) {
+    return await run_provider_action(async () => await provider.remember({
+        ...input,
+        scope: create_memory_scope(context),
+    }));
+}
+/** digest action：Session 消息读取属于 Plugin 编排，长期记忆语义属于 Provider。 */
+export async function digest_memory_action(context, provider, input) {
+    return await run_provider_action(async () => {
+        const session_id = String(input.session_id || "").trim();
+        if (!session_id)
             throw new Error("session_id is required");
-        }
-        const maxMessages = Number.isFinite(payload.maxMessages)
-            ? Math.max(1, Math.floor(payload.maxMessages))
+        const max_messages = Number.isFinite(input.max_messages)
+            ? Math.max(1, Math.floor(input.max_messages))
             : 30;
         const snapshot = await context.sessions.runtime(session_id).context();
-        const total = snapshot.messages.length;
-        const start = Math.max(0, total - maxMessages);
-        const messages = snapshot.messages.slice(start);
-        const lines = messages
-            .map((message) => extract_session_message_line(message))
-            .filter((line) => line.length > 0);
-        const transcript = lines.length > 0
-            ? lines.join("\n\n")
-            : "本次 digest 未找到可写入的用户/助手文本内容。";
-        const sourceText = [
-            `Window: ${start}-${Math.max(start, total - 1)}`,
-            "",
-            transcript,
-        ].join("\n");
-        const source = await writeSessionSource(context, session_id, sourceText);
-        if (options.digest) {
-            const wikiIndex = await readWikiIndex(context);
-            const digested = readDigestPages(await options.digest({
-                rootPath: context.workspace_path,
-                sourceText,
-                sourcePath: source.path,
-                session_id,
-                wikiIndex,
-            }));
-            const wikiPaths = [];
-            for (const page of digested.pages) {
-                const written = await writeWikiPage(context, page);
-                wikiPaths.push(written.path);
-            }
-            const response = {
-                sourcePath: source.path,
-                wikiPaths,
-                message_count: lines.length,
-                mode: "digested",
-                summary: digested.summary,
-            };
-            return { success: true, data: response };
+        const start_index = Math.max(0, snapshot.messages.length - max_messages);
+        const lines = snapshot.messages
+            .slice(start_index)
+            .map(extract_session_message_line)
+            .filter(Boolean);
+        if (lines.length === 0) {
+            throw new Error("Session has no user or assistant text to digest");
         }
-        const written = await appendWikiPage(context, {
-            path: "session-digests",
-            title: "Session Digests",
-            content: sourceText,
-            sourcePath: source.path,
-        });
-        const response = {
-            sourcePath: source.path,
-            wikiPaths: [written.path],
+        const transcript = lines.join("\n\n");
+        return await provider.digest({
+            session_id,
+            scope: create_memory_scope(context, session_id),
+            transcript,
             message_count: lines.length,
-            mode: "archived",
-        };
-        return { success: true, data: response };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: String(error),
-        };
-    }
+        });
+    });
 }
-/**
- * revise action。
- */
-export async function reviseMemoryAction(context, options, payload) {
-    try {
-        const targetPath = toWikiMemoryPath(String(payload.path || "").trim());
-        if (!targetPath) {
-            throw new Error("path is required");
-        }
-        const instruction = String(payload.instruction || "").trim();
-        if (!instruction) {
-            throw new Error("instruction is required");
-        }
-        if (options.revise) {
-            const current = await readMemory(context, { path: targetPath }).catch(() => ({
-                path: targetPath,
-                text: "",
-            }));
-            const revised = readReviseResult(await options.revise({
-                rootPath: context.workspace_path,
-                path: targetPath,
-                currentContent: current.text,
-                instruction,
-                evidence: String(payload.evidence || ""),
-            }), targetPath);
-            const written = await writeWikiPage(context, {
-                path: revised.path,
-                content: revised.content,
-                tags: ["memory"],
-            });
-            const response = {
-                path: written.path,
-                mode: "revised",
-                writtenChars: written.writtenChars,
-                summary: revised.summary,
-            };
-            return { success: true, data: response };
-        }
-        const response = await appendMemoryRevision(context, payload);
-        return { success: true, data: response };
-    }
-    catch (error) {
-        return {
-            success: false,
-            error: String(error),
-        };
-    }
+/** revise action。 */
+export async function revise_memory_action(context, provider, input) {
+    return await run_provider_action(async () => await provider.revise({
+        ...input,
+        scope: create_memory_scope(context),
+    }));
 }
-/**
- * 把任意 payload 归一化为 search payload。
- */
-export function toSearchPayload(input) {
-    return {
-        query: String(input.query || ""),
-        maxResults: typeof input.maxResults === "number"
-            ? input.maxResults
-            : typeof input.maxResults === "string"
-                ? Number(input.maxResults)
-                : MEMORY_DEFAULTS.maxResults,
-        minScore: typeof input.minScore === "number"
-            ? input.minScore
-            : typeof input.minScore === "string"
-                ? Number(input.minScore)
-                : MEMORY_DEFAULTS.minScore,
-        includeSources: typeof input.includeSources === "boolean"
-            ? input.includeSources
-            : typeof input.includeSources === "string"
-                ? input.includeSources === "true"
-                : undefined,
-    };
+/** forget action。 */
+export async function forget_memory_action(context, provider, input) {
+    return await run_provider_action(async () => await provider.forget({
+        ...input,
+        scope: create_memory_scope(context),
+    }));
 }
 //# sourceMappingURL=Action.js.map

package/bin/memory/Action.js.map

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

package/bin/memory/MemoryPlugin.d.ts

@@ -1,51 +1,34 @@
 /**
- * MemoryPlugin：agent 的长期记忆 plugin。
+ * MemoryPlugin：Agent 长期记忆的 provider-neutral facade。
  *
- * 关键点（中文）
- * - 对外仍然是 MemoryPlugin，内部使用 LLM Wiki 方式组织知识。
- * - constructor 注入 digest/revise 能力，plugin 不绑定具体 LLM 服务。
- * - action 面向 agent 语义，而不是暴露底层文件写入细节。
+ * 职责说明（中文）
+ * - 对 Agent 暴露稳定的 Memory actions 与 system 使用约束。
+ * - 把 Agent/Session 上下文映射为结构化 Memory scope。
+ * - 将记忆形成、存储、召回、修订和删除委托给唯一 MemoryProvider。
+ *
+ * 边界说明（中文）
+ * - 不读取或拼接任何物理存储路径。
+ * - 不依赖 Workspace FileSystem，也不规定 Markdown、SQLite 或远程服务。
+ * - Provider 生命周期跟随当前 Plugin 实例，由 Agent 统一启动和释放。
  */
-import type { PluginContext } from "@downcity/agent";
-import type { PluginActions } from "@downcity/agent";
 import { BasePlugin } from "@downcity/agent";
-import { type MemoryRuntimeState } from "./runtime/Store.js";
-import type { MemoryPluginOptions } from "./types/Memory.js";
-/**
- * Memory plugin 类实现。
- */
+import type { PluginActions, PluginContext } from "@downcity/agent";
+import type { MemoryPluginOptions, MemoryProvider } from "../memory/types/Memory.js";
+/** Agent 长期记忆 Plugin。 */
 export declare class MemoryPlugin extends BasePlugin {
-    private readonly options;
-    /**
-     * plugin 名称。
-     */
+    /** Plugin 稳定名称。 */
     readonly name = "memory";
-    /**
-     * 当前实例持有的 memory plugin state。
-     */
-    runtimeState: MemoryRuntimeState | null;
-    /**
-     * 创建 MemoryPlugin。
-     */
-    constructor(options?: MemoryPluginOptions);
-    /**
-     * 当前 plugin 的 system 文本提供器。
-     */
+    /** 当前 Plugin 唯一绑定的 Memory Provider。 */
+    readonly provider: MemoryProvider;
+    constructor(profile?: MemoryPluginOptions);
+    /** 构建 provider-neutral Memory system 内容。 */
     system(context: PluginContext): Promise<string>;
-    /**
-     * 当前 plugin 生命周期。
-     */
+    /** Provider 生命周期与当前 Agent Plugin 实例保持一致。 */
     readonly lifecycle: {
         start: (context: PluginContext) => Promise<void>;
         stop: () => Promise<void>;
     };
-    /**
-     * 当前 plugin action 定义表。
-     */
+    /** Memory 对 Agent 暴露的稳定 Action 集合。 */
     readonly actions: PluginActions;
-    /**
-     * 获取或创建当前实例绑定的 memory plugin state。
-     */
-    private getOrCreateRuntimeState;
 }
 //# sourceMappingURL=MemoryPlugin.d.ts.map

package/bin/memory/MemoryPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryPlugin.d.ts","sourceRoot":"","sources":["../../src/memory/MemoryPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAW7C,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAqD7D;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAc9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAbpC;;OAEG;IACH,QAAQ,CAAC,IAAI,YAAY;IAEzB;;OAEG;IACI,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAQ;IAEtD;;OAEG;gBAC0B,OAAO,GAAE,mBAAwB;IAI9D;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD;;OAEG;IACH,QAAQ,CAAC,SAAS;yBACO,aAAa,KAAG,OAAO,CAAC,IAAI,CAAC;oBAIpC,OAAO,CAAC,IAAI,CAAC;MAG7B;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CA2R7B;IAEF;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAMhC"}
+{"version":3,"file":"MemoryPlugin.d.ts","sourceRoot":"","sources":["../../src/memory/MemoryPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,UAAU,EAAiB,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAGV,aAAa,EACb,aAAa,EACd,MAAM,iBAAiB,CAAC;AAczB,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EAEf,MAAM,0BAA0B,CAAC;AA+DlC,yBAAyB;AACzB,qBAAa,YAAa,SAAQ,UAAU;IAC1C,mBAAmB;IACnB,QAAQ,CAAC,IAAI,YAAY;IAEzB,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;gBAEtB,OAAO,GAAE,mBAAwB;IAgB7C,4CAA4C;IACtC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD,4CAA4C;IAC5C,QAAQ,CAAC,SAAS;yBACO,aAAa,KAAG,OAAO,CAAC,IAAI,CAAC;oBAKpC,OAAO,CAAC,IAAI,CAAC;MAG7B;IAEF,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAsS7B;CACH"}