@istarry/dsh-assistant-profile 0.5.0 → 0.6.1

package/lib/index.js

@@ -1,8 +1,5 @@
 import z from "@deepseek-ai/schemastery";
-import { TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
-import { defineTool } from "@deepseek-ai/dsh-tools";
-import "@deepseek-ai/dsh-llm";
-import "@deepseek-ai/dsh-session";
+import { Service } from "@deepseek-ai/cordis";
 //#region ../tooling/node_modules/.pnpm/js-yaml@4.2.0/node_modules/js-yaml/dist/js-yaml.mjs
 /*! js-yaml 4.2.0 https://github.com/nodeca/js-yaml @license MIT */
 var __create = Object.create;
@@ -2563,7 +2560,8 @@ const Config = z.object({
 	customsJson: z.string().default("[]").volatile(),
 	memoryEnabled: z.boolean().default(true).description("Inject the assistant memory into the system prompt").volatile(),
 	autoMemory: z.boolean().default(false).description("Let the model write memories on its own judgment (requires memoryEnabled)").volatile(),
-	memoryText: z.string().default("").description("The assistant memory document").volatile()
+	memoryText: z.string().default("").description("The assistant memory document").volatile(),
+	rememberSignal: z.string().default("").description("Browser-to-host mailbox for the remember button").volatile()
 });
 /** 跨插件重载共享的当前配置引用：旧闭包也能读到新值。 */
 const LIVE = Symbol.for("dsh.assistant-profile.config");
@@ -2671,26 +2669,77 @@ async function installPersona(ctx, agent) {
 	});
 }
 const MEMORY_ADD_DESCRIPTION = "Add one fact to the assistant's long-term memory when the conversation reveals something worth remembering across future sessions: stable preferences, work habits, durable decisions, or facts the human stated as lasting. Remember prose conclusions, not the raw exchange; merge related facts into one entry. Do not store credentials, one-off task details, or anything the human said is transient.";
-/** `memory_add` 的输出结构。 */
+/**
+* `memory_add` 的输出结构。
+*
+* 这是**输出值**的 JSON Schema，不是工具参数的 `defineTool` 方言：`required` 必须是
+* 对象层上的字符串数组，写成属性上的 `required: true` 会被宿主的 JSON Schema 校验器
+* 拒绝（`unsupported JSON schema: ... required is not supported on type "boolean"`），
+* 而注册失败只会让工具消失——不报给用户。
+*/
 const MEMORY_ADD_VALUE_SCHEMA = {
 	type: "object",
 	additionalProperties: false,
 	properties: {
-		saved: {
-			type: "boolean",
-			required: true
-		},
+		saved: { type: "boolean" },
 		outcome: { type: "string" },
 		content: { type: "string" }
-	}
+	},
+	required: ["saved"]
 };
+/** 把选中的对话文本提炼成记忆条目的指令（与 agent-suite 一致的规则）。 */
+const REMEMBER_INSTRUCTION = "你是一个长期记忆提炼引擎。用户从对话中圈选了下面这段内容，明确希望把它记入助手的长期记忆。请把这些内容提炼成简短、稳定、可跨会话复用的记忆条目。\n规则：\n- 每行输出一条记忆内容本身（不带时间戳、不带 \"- \" 前缀、不带编号）。\n- 用户既然圈选了它，请默认提取出其中明确、稳定的信息：称呼、偏好、习惯、约定、身份事实、项目背景。\n- 把相关事实合并成一条；不要逐字复述，只提炼结论，但保留关键名称、数字、关系。\n- 只有当整段内容完全是临时任务细节或含凭据、密钥时，才不输出条目（此时只输出一个真正的空行）。\n- 用与对话片段一致的语言书写（对话是中文就用中文，是英文就用英文）。\n- 严禁输出\"空行\"\"（空行）\"\"无\"\"没有\"\"none\"之类的占位文字。";
+/** 设置命名空间 = 本插件在 profile 里的条目 id。 */
+const SETTINGS_NS = "assistant-profile";
+/** 信箱里一次请求最多带多少字符（别把超长选区写进 profile 的 patch）。 */
+const REMEMBER_TEXT_LIMIT = 2e4;
+/** 信箱轮询间隔：0.7s 读一次字符串字段，人感觉不到延迟。 */
+const MAILBOX_POLL_MS = 700;
+/**
+* 一条用户消息。按线上形状手搭而不是引 `@deepseek-ai/dsh-llm`：宿主那边的包在插件
+* 目录里解析不到（只有 cordis 与 schemastery 两端共享），而消息只是 role/content/id
+* 三个字段的纯数据。
+* @param text - 消息正文。
+* @returns 可直接交给 llm.stream 的用户消息。
+*/
+function userMessage(text) {
+	return {
+		id: crypto.randomUUID(),
+		role: "user",
+		content: [{
+			type: "text",
+			text
+		}],
+		source: { kind: "user" }
+	};
+}
+/**
+* 解析信箱字段；坏数据当空（宁可什么都不做，也不误跑一次）。
+* @param raw - 字段原文。
+* @returns 解析出的信号。
+*/
+function parseSignal(raw) {
+	if (raw.trim() === "") return void 0;
+	try {
+		const parsed = JSON.parse(raw);
+		if (typeof parsed !== "object" || parsed === null) return void 0;
+		return parsed;
+	} catch {
+		return;
+	}
+}
 /**
 * 助理档案服务：人格注入 + 单份长期记忆。
 *
-* 记忆的存储、注入、两个开关、`memory_add` 工具和按钮提炼都在这里；
-* 客户端只负责设置页与弹窗。
+* 记忆的存储、注入、两个开关、`memory_add` 工具与按钮提炼都在这里；客户端只负责
+* 设置页、聊天里的「记住」按钮和选择弹窗。
+*
+* 按钮提炼没有自定义 RPC：浏览器把「要提炼哪段文本」写进 `rememberSignal`
+* （`phase: request`），宿主在 `loader/volatile-update` 里接手，用该会话自己的模型
+* 跑一次提炼，把结果写回同一个字段（`phase: done`）。写入统一走设置服务，所以记忆
+* 与它一样落进 profile 的 patch。
 */
-var AssistantProfile = class extends TypertRemoteService {
+var AssistantProfile = class extends Service {
 	config;
 	static inject = [
 		"systemPrompt",
@@ -2700,6 +2749,10 @@ var AssistantProfile = class extends TypertRemoteService {
 	static Config = Config;
 	/** `memory_add` 工具的注册 disposer，只在开关允许时存在。 */
 	toolDisposer;
+	/** 正在处理一次按钮提炼：同一时间只跑一个。 */
+	remembering = false;
+	/** 上一次处理过的请求 id，防止同一请求被重复执行。 */
+	lastRequestId;
 	constructor(ctx, config) {
 		super(ctx, "assistantProfile");
 		this.config = config;
@@ -2728,7 +2781,18 @@ var AssistantProfile = class extends TypertRemoteService {
 		this.syncTool();
 		ctx.on("loader/volatile-update", () => {
 			this.syncTool();
+			this.schedulePump();
 		});
+		ctx.effect(() => {
+			const poller = setInterval(() => {
+				this.syncTool();
+				this.pumpRemember();
+			}, MAILBOX_POLL_MS);
+			return () => {
+				clearInterval(poller);
+			};
+		}, "assistant-profile: mailbox poll");
+		this.schedulePump();
 	}
 	/** 按当前开关注册或撤下 `memory_add` 工具。 */
 	syncTool() {
@@ -2742,43 +2806,53 @@ var AssistantProfile = class extends TypertRemoteService {
 	/** 注册模型侧的记忆工具，返回撤下函数。 */
 	registerTool() {
 		const ctx = this.ctx;
-		const disposer = ctx.tools.register(defineTool({
-			name: "memory_add",
-			description: MEMORY_ADD_DESCRIPTION,
-			parameters: { text: {
-				type: "string",
-				required: true,
-				description: "The stable fact to remember, in its final prose form."
-			} },
-			output: {
-				schema: MEMORY_ADD_VALUE_SCHEMA,
-				render: (_args, value) => {
-					const v = value;
-					if (v.saved) return [{
-						type: "text",
-						text: `记住：${v.content ?? ""}`
-					}];
-					return [{
-						type: "text",
-						text: `未记住：${v.outcome ?? "未启用"}`
-					}];
+		let disposer;
+		try {
+			disposer = ctx.tools.register({
+				name: "memory_add",
+				description: MEMORY_ADD_DESCRIPTION,
+				parameters: {
+					type: "object",
+					additionalProperties: false,
+					properties: { text: {
+						type: "string",
+						description: "The stable fact to remember, in its final prose form."
+					} },
+					required: ["text"]
+				},
+				output: {
+					schema: MEMORY_ADD_VALUE_SCHEMA,
+					render: (_args, value) => {
+						const v = value;
+						if (v.saved) return [{
+							type: "text",
+							text: `记住：${v.content ?? ""}`
+						}];
+						return [{
+							type: "text",
+							text: `未记住：${v.outcome ?? "未启用"}`
+						}];
+					}
+				},
+				execute: async (args) => {
+					const trimmed = (typeof args.text === "string" ? args.text : "").trim();
+					if (trimmed === "") return {
+						saved: false,
+						outcome: "empty fact"
+					};
+					const result = appendToText(this.config.memoryText.get(), trimmed);
+					await this.writeMemory(result.text);
+					return {
+						saved: true,
+						content: result.content,
+						outcome: result.appended ? "appended" : result.refreshed ? "refreshed" : "unchanged"
+					};
 				}
-			},
-			execute: async (args, _exec) => {
-				const trimmed = args.text.trim();
-				if (trimmed === "") return {
-					saved: false,
-					outcome: "empty fact"
-				};
-				const result = appendToText(this.config.memoryText.get(), trimmed);
-				this.config.memoryText.set(result.text);
-				return {
-					saved: true,
-					content: result.content,
-					outcome: result.appended ? "appended" : result.refreshed ? "refreshed" : "unchanged"
-				};
-			}
-		}));
+			});
+		} catch (error) {
+			ctx.logger.warn(`assistant-profile: memory_add registration failed: ${String(error)}`);
+			return () => {};
+		}
 		const teardown = () => {
 			disposer();
 			this.toolDisposer = void 0;
@@ -2788,7 +2862,169 @@ var AssistantProfile = class extends TypertRemoteService {
 			disposer();
 		};
 	}
+	/**
+	* 把一段记忆文本落进配置。只能经设置服务写：`Volatile` 只暴露 `get()`，
+	* 宿主没有权限直接改自己的配置引用；写入经它之后，加载器会把新值就地提交进
+	* 运行时引用（下一次组装提示词就读到），并落进 profile 的 patch。
+	* @param next - 新的整段文本。
+	*/
+	async writeMemory(next) {
+		await this.persist({ memoryText: next });
+	}
+	/**
+	* 经设置服务写回本插件的 volatile 字段。
+	* @param patch - 要写入的字段。
+	* @returns 是否写成功（失败只记日志，由调用方决定要不要重试）。
+	*/
+	async persist(patch) {
+		const settings = this.ctx.get("settings");
+		if (settings === void 0) return false;
+		try {
+			await settings.update(SETTINGS_NS, patch);
+			return true;
+		} catch (error) {
+			this.ctx.logger.warn(`assistant-profile: persist failed: ${String(error)}`);
+			return false;
+		}
+	}
+	/**
+	* 把一次信箱处理排到当前事务之外。
+	*
+	* 设置写入本身跑在 HMR 事务里（`hmr.runExclusive`），而写回结果又要经设置服务再开
+	* 一个事务——直接调用会撞上「HMR transactions cannot be nested」。所以触发点统一
+	* 用 `setTimeout(0)` 推到事务之外，轮询那条路天然在事务外。
+	*/
+	schedulePump() {
+		setTimeout(() => {
+			this.pumpRemember();
+		}, 0);
+	}
+	/**
+	* 检查信箱里有没有新请求，有就跑一次提炼并写回结果。
+	*
+	* 这里绝不向外抛：调用方是 `void`，一次未捕获的拒绝会被加载器当成插件加载失败。
+	*/
+	async pumpRemember() {
+		if (this.remembering) return;
+		const signal = parseSignal(this.config.rememberSignal.get());
+		if (signal?.phase !== "request" || signal.id === void 0) return;
+		if (signal.id === this.lastRequestId) return;
+		this.remembering = true;
+		this.lastRequestId = signal.id;
+		let result;
+		try {
+			result = await this.remember(signal.sessionId ?? "", signal.text ?? "");
+		} catch (error) {
+			result = {
+				saved: false,
+				outcome: `failed: ${errorChain(error)}`
+			};
+		}
+		try {
+			if (!await this.publishSignal({
+				id: signal.id,
+				phase: "done",
+				saved: result.saved,
+				entries: result.entries,
+				outcome: result.outcome
+			})) this.lastRequestId = void 0;
+		} finally {
+			this.remembering = false;
+		}
+	}
+	/**
+	* 把结果写回信箱（同一个字段），浏览器据此结束等待。
+	* @param signal - 带结果的信箱内容。
+	*/
+	async publishSignal(signal) {
+		return await this.persist({ rememberSignal: JSON.stringify(signal) });
+	}
+	/**
+	* 用该会话自己的模型把选中的对话文本提炼成记忆条目并追加。
+	*
+	* 会话必须还在线（agent 提供模型配置）；提炼不写入对话历史，只发一次独立请求。
+	* @param sessionId - 执行提炼的会话。
+	* @param text - 选中的对话文本。
+	* @returns 是否记住了、记住了什么、或失败原因。
+	*/
+	async remember(sessionId, text) {
+		const trimmed = text.trim().slice(0, REMEMBER_TEXT_LIMIT);
+		if (trimmed === "") return {
+			saved: false,
+			outcome: "empty selection"
+		};
+		const agent = this.ctx.get("agents")?.get(sessionId);
+		if (agent === void 0) return {
+			saved: false,
+			outcome: "session not open"
+		};
+		const callConfig = agent.session.requestHeader?.()?.config;
+		if (callConfig === void 0) return {
+			saved: false,
+			outcome: "no provider/model available"
+		};
+		const llm = this.ctx.llm;
+		let output = "";
+		let failure;
+		try {
+			for await (const chunk of llm.stream({
+				...callConfig,
+				messages: [userMessage(trimmed), userMessage(REMEMBER_INSTRUCTION)],
+				sessionId: agent.session.id
+			})) if (chunk.type === "text-delta" && typeof chunk.text === "string") output += chunk.text;
+			else if (chunk.type === "finish") {
+				const kind = chunk.reason?.kind;
+				if (kind === "error" || kind === "aborted") failure = `analysis ${kind}: ${errorChain(chunk.reason?.failure)}`;
+				else if (kind === "max-tokens") failure = "analysis truncated at the token cap";
+			}
+		} catch (error) {
+			return {
+				saved: false,
+				outcome: `analysis failed: ${errorChain(error)}`
+			};
+		}
+		if (failure !== void 0) return {
+			saved: false,
+			outcome: failure
+		};
+		const entries = splitLines(output);
+		if (entries.length === 0) return {
+			saved: false,
+			outcome: "nothing worth remembering"
+		};
+		let next = this.config.memoryText.get();
+		for (const entry of entries) next = appendToText(next, entry).text;
+		await this.writeMemory(next);
+		return {
+			saved: true,
+			entries,
+			outcome: `remembered ${String(entries.length)}`
+		};
+	}
 };
+/** 把错误及其 cause 链压成一行。 */
+function errorChain(error) {
+	const parts = [];
+	let current = error;
+	while (typeof current === "object" && current !== null && parts.length < 4) {
+		const message = current.message;
+		if (typeof message !== "string" || message === "") break;
+		parts.push(message);
+		current = current.cause;
+	}
+	return parts.join(" | ");
+}
+/** 把模型输出拆成一行一条记忆（去列表前缀、丢空行、丢占位词）。 */
+function splitLines(text) {
+	const entries = [];
+	for (const raw of text.split(/\r?\n/)) {
+		const line = stripInvisible(raw.trim().replace(/^[-*]\s+/, "").trim());
+		if (line === "") continue;
+		if (isVacuousEntry(line)) continue;
+		entries.push(line);
+	}
+	return entries;
+}
 /** 去掉模型可能在正文周围吐出的不可见字符。 */
 function stripInvisible(value) {
 	return value.replace(/[\u0000-\u001F\u007F-\u009F\u00A0\u00AD\u1680\u2000-\u200B\u2028-\u202F\u205F-\u206F\u3000\uFEFF\uFFFD]/g, "").trim();

package/package.json

@@ -1,10 +1,17 @@
 {
   "name": "@istarry/dsh-assistant-profile",
-  "description": "助理档案：给 DSH 一份全局人格（名称 / 风格 / 语言 / 人格提示词），每个新会话的系统提示最前面都带着它；侧栏「新会话」上方显示助理名",
-  "version": "0.5.0",
+  "description": "助理档案：给 DSH 一份全局人格（名称 / 语言 / 人格提示词）与一份长期记忆，每个新会话的系统提示最前面都带着它；聊天里点一下就能把选中的对话提炼进记忆；侧栏「新会话」上方显示助理名",
+  "version": "0.6.1",
   "icon": "./icon.svg",
   "type": "module",
   "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json",
+    "./package.json": "./package.json"
+  },
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -45,11 +52,6 @@
     "@deepseek-ai/dsh-agent": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-agent-preset-registry": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-settings": "^0.2.1-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.2.1-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "*",
-    "@deepseek-ai/dsh-tools": "*",
-    "@deepseek-ai/dsh-llm": "*",
-    "@deepseek-ai/dsh-session": "*",
-    "@deepseek-ai/dsh-home-paths": "*"
+    "@deepseek-ai/dsh-system-prompt": "^0.2.1-rc.2"
   }
 }