@aalis/plugin-user-relation 0.4.1

package/dist/store.js

@@ -0,0 +1,207 @@
+export const RELATION_NAMESPACE = 'user-relation';
+const PERSON_PREFIX = 'person:';
+const EVENT_PREFIX = 'event:';
+const ENTITY_PREFIX = 'entity:';
+const EDGE_PREFIX = 'edge:';
+const MERGE_REJECT_PREFIX = 'merge-reject:';
+/** key 编码 / 解码 */
+export function personKey(platform, userId) {
+    return `${PERSON_PREFIX}${platform}:${userId}`;
+}
+export function eventKey(eventId) {
+    return `${EVENT_PREFIX}${eventId}`;
+}
+function entityKey(entityId) {
+    return `${ENTITY_PREFIX}${entityId}`;
+}
+export function edgeKey(edgeId) {
+    return `${EDGE_PREFIX}${edgeId}`;
+}
+/**
+ * mergeReject 持久化缓存的 key：把两端 id 排序，得到对称稳定键。
+ * 用于 consolidate LLM 否决合并的去重缓存——下次 maintain 时若双方"真新关系"指标未变即可跳过 LLM。
+ *
+ * **失效信号（2026-05 改造）**：采用 `evidence.length` 作为"是否有新关系/新提及"的稳定信号。
+ * 旧版用 `lastReinforcedAt`，但该字段会被 evictByQuota → rewriteWeights 的衰减回写批量刷新，
+ * 导致缓存全量失效、连续 maintain 重复调 LLM。evidence.length 仅在节点真新增 evidence 时增长，
+ * 与衰减回写解耦，是更稳定的"分别没有新关系产生"指标。
+ * 旧字段 aReinforcedAt/bReinforcedAt 保留作为兼容信息，但**不再参与判断**。
+ */
+function mergeRejectKey(aId, bId) {
+    const [x, y] = aId < bId ? [aId, bId] : [bId, aId];
+    return `${MERGE_REJECT_PREFIX}${x}|${y}`;
+}
+/** Memory 后端不支持 metadata 时使用的 NoOp 实现 —— 抛错而非静默吞掉，避免数据丢失被忽略 */
+class UnsupportedMemoryError extends Error {
+    constructor() {
+        super('RelationStore 要求当前 memory 服务支持 "metadata" 能力 (saveMetadata/getMetadata/listMetadata/deleteMetadata)。' +
+            '请启用 plugin-memory-sqlite / plugin-memory-mongodb 或其他实现 metadata 能力的 memory 插件。');
+        this.name = 'UnsupportedMemoryError';
+    }
+}
+function assertMetadataSupport(memory) {
+    if (!memory.saveMetadata || !memory.getMetadata || !memory.listMetadata || !memory.deleteMetadata) {
+        throw new UnsupportedMemoryError();
+    }
+}
+export class RelationStore {
+    memory;
+    constructor(memory) {
+        this.memory = memory;
+        assertMetadataSupport(memory);
+    }
+    // ----- Person -----
+    async getPerson(platform, userId) {
+        const data = await this.memory.getMetadata(RELATION_NAMESPACE, personKey(platform, userId));
+        return data;
+    }
+    async upsertPerson(node) {
+        await this.memory.saveMetadata(RELATION_NAMESPACE, personKey(node.platform, node.userId), node);
+    }
+    async deletePerson(platform, userId) {
+        await this.memory.deleteMetadata(RELATION_NAMESPACE, personKey(platform, userId));
+    }
+    // ----- Event -----
+    async getEvent(eventId) {
+        const data = await this.memory.getMetadata(RELATION_NAMESPACE, eventKey(eventId));
+        return data;
+    }
+    async upsertEvent(node) {
+        await this.memory.saveMetadata(RELATION_NAMESPACE, eventKey(node.id), node);
+    }
+    async deleteEvent(eventId) {
+        await this.memory.deleteMetadata(RELATION_NAMESPACE, eventKey(eventId));
+    }
+    // ----- Entity -----
+    async getEntity(entityId) {
+        const data = await this.memory.getMetadata(RELATION_NAMESPACE, entityKey(entityId));
+        return data;
+    }
+    async upsertEntity(node) {
+        await this.memory.saveMetadata(RELATION_NAMESPACE, entityKey(node.id), node);
+    }
+    async deleteEntity(entityId) {
+        await this.memory.deleteMetadata(RELATION_NAMESPACE, entityKey(entityId));
+    }
+    // ----- Edge -----
+    async getEdge(edgeId) {
+        const data = await this.memory.getMetadata(RELATION_NAMESPACE, edgeKey(edgeId));
+        return data;
+    }
+    async upsertEdge(edge) {
+        await this.memory.saveMetadata(RELATION_NAMESPACE, edgeKey(edge.id), edge);
+    }
+    async deleteEdge(edgeId) {
+        await this.memory.deleteMetadata(RELATION_NAMESPACE, edgeKey(edgeId));
+    }
+    // ----- MergeReject 缓存（consolidate LLM 否决合并的持久化去重） -----
+    async getMergeReject(aId, bId) {
+        const data = await this.memory.getMetadata(RELATION_NAMESPACE, mergeRejectKey(aId, bId));
+        return data;
+    }
+    async saveMergeReject(record) {
+        await this.memory.saveMetadata(RELATION_NAMESPACE, mergeRejectKey(record.aId, record.bId), record);
+    }
+    async deleteMergeReject(aId, bId) {
+        await this.memory.deleteMetadata(RELATION_NAMESPACE, mergeRejectKey(aId, bId));
+    }
+    /** 列出全部 MergeReject 记录（webui / debug 用，体量预计 < 候选数）。 */
+    async listMergeRejects() {
+        const entries = await this.memory.listMetadata(RELATION_NAMESPACE);
+        const out = [];
+        for (const { key, data } of entries) {
+            if (key.startsWith(MERGE_REJECT_PREFIX))
+                out.push(data);
+        }
+        return out;
+    }
+    /** 当某个节点被合并/删除时，清理所有涉及它的 MergeReject 缓存（旧 id 不再有效）。 */
+    async deleteMergeRejectsByNode(nodeId) {
+        const entries = await this.memory.listMetadata(RELATION_NAMESPACE);
+        let deleted = 0;
+        for (const { key, data } of entries) {
+            if (!key.startsWith(MERGE_REJECT_PREFIX))
+                continue;
+            const r = data;
+            if (r.aId === nodeId || r.bId === nodeId) {
+                await this.memory.deleteMetadata(RELATION_NAMESPACE, key);
+                deleted++;
+            }
+        }
+        return deleted;
+    }
+    // ----- 全量加载（webui / 注入用） -----
+    async loadAll() {
+        const entries = await this.memory.listMetadata(RELATION_NAMESPACE);
+        const persons = [];
+        const events = [];
+        const entities = [];
+        const edges = [];
+        for (const { key, data } of entries) {
+            if (key.startsWith(PERSON_PREFIX))
+                persons.push(data);
+            else if (key.startsWith(EVENT_PREFIX))
+                events.push(data);
+            else if (key.startsWith(ENTITY_PREFIX))
+                entities.push(data);
+            else if (key.startsWith(EDGE_PREFIX))
+                edges.push(data);
+            // 其他 key 静默忽略，便于未来加扩展类型而不破坏老版
+        }
+        return { persons, events, entities, edges };
+    }
+    /** 级联删除人物：移除该人物所有相关边，然后删除人物本身 */
+    async deletePersonCascade(platform, userId) {
+        const id = `${platform}:${userId}`;
+        const snapshot = await this.loadAll();
+        let deletedEdges = 0;
+        for (const edge of snapshot.edges) {
+            const involved = (edge.kind === 'person-event' && edge.fromPersonId === id) ||
+                (edge.kind === 'person-entity' && edge.fromPersonId === id) ||
+                (edge.kind === 'person-person' && (edge.fromPersonId === id || edge.toPersonId === id));
+            if (involved) {
+                await this.deleteEdge(edge.id);
+                deletedEdges++;
+            }
+        }
+        await this.deletePerson(platform, userId);
+        // 顺手清掉这个人的 mergeReject 缓存（pair metadata 会变孤儿）
+        await this.deleteMergeRejectsByNode(id);
+        return { deletedEdges };
+    }
+    /** 级联删除事件：移除所有指向该事件的边，然后删除事件本身 */
+    async deleteEventCascade(eventId) {
+        const snapshot = await this.loadAll();
+        let deletedEdges = 0;
+        for (const edge of snapshot.edges) {
+            const involved = (edge.kind === 'person-event' && edge.toEventId === eventId) ||
+                (edge.kind === 'event-event' && (edge.fromEventId === eventId || edge.toEventId === eventId)) ||
+                (edge.kind === 'event-entity' && edge.fromEventId === eventId);
+            if (involved) {
+                await this.deleteEdge(edge.id);
+                deletedEdges++;
+            }
+        }
+        await this.deleteEvent(eventId);
+        await this.deleteMergeRejectsByNode(eventId);
+        return { deletedEdges };
+    }
+    /** 级联删除实体：移除所有指向该实体的 person-entity / event-entity / entity-entity 边 */
+    async deleteEntityCascade(entityId) {
+        const snapshot = await this.loadAll();
+        let deletedEdges = 0;
+        for (const edge of snapshot.edges) {
+            const involved = (edge.kind === 'person-entity' && edge.toEntityId === entityId) ||
+                (edge.kind === 'event-entity' && edge.toEntityId === entityId) ||
+                (edge.kind === 'entity-entity' && (edge.fromEntityId === entityId || edge.toEntityId === entityId));
+            if (involved) {
+                await this.deleteEdge(edge.id);
+                deletedEdges++;
+            }
+        }
+        await this.deleteEntity(entityId);
+        await this.deleteMergeRejectsByNode(entityId);
+        return { deletedEdges };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Agent 工具：让 LLM 在 reasoning 中主动深挖关系图。
+ *
+ * 设计原则（单写者 + 与 profile 对称）：
+ * - 关系图的「新建 / 强化 / 删除」由 extractor 单线程被动归纳，agent **不能** 直接写或删。
+ * - agent 暴露的工具全部 **只读**；纠错走 `/relation cleanup` slash 命令。
+ *
+ * 这套工具覆盖 6 类边、3 类节点的检索/分析需求：
+ *   resolve_node       —— 由关键词跨类解析节点 ID
+ *   expand_node        —— 以任意节点为中心 BFS 子图（可限定 session_scope）
+ *   find_path          —— 任意节点 ↔ 任意节点 最短路径
+ *   score              —— 双节点联系分数（Katz + AA）
+ *   recommend_persons  —— 给 person 推荐 top-K “想认识”的人（一步达成，避免多次 score）
+ *   gossip             —— 某会话最近的“瓜”（事件热度榜）
+ *   shared             —— 两节点共同邻居（共同兴趣/事件/朋友）
+ *   search_persons     —— 按 platform/关键词列人
+ *   search_entities    —— 按 kind/关键词列实体
+ *   search_events      —— 按关键词/天数列事件（可限定 session_scope）
+ *   list_edges         —— 多条件过滤边
+ *   timeline           —— 节点时间线（可限定 session_scope）
+ *
+ * 所有 depth/breadth/limit 参数会被 hardMax 截断，防止 Agent 一次拉满爆 token。
+ */
+import type { Context } from '@aalis/core';
+import type { RelationService } from './service.js';
+interface ToolsConfig {
+    enabled: boolean;
+    /** 工具分组名（默认 'user-relation'） */
+    group: string;
+    /** Agent 调用时的默认 depth（expand_node） */
+    defaultMaxDepth: number;
+    /** Agent 调用时的默认 breadth（expand_node） */
+    defaultMaxBreadth: number;
+    /** 硬上限 depth；超过会被截断 */
+    hardMaxDepth: number;
+    /** 硬上限 breadth */
+    hardMaxBreadth: number;
+    /** search_events / search_persons / search_entities 默认 limit */
+    searchEventsDefaultLimit: number;
+    searchEventsHardMaxLimit: number;
+    /** find_path 默认/硬上限最大深度 */
+    findPathDefaultMaxDepth: number;
+    findPathHardMaxDepth: number;
+    debug: boolean;
+}
+export declare function registerRelationTools(ctx: Context, service: RelationService, cfg: ToolsConfig): void;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAcpD,UAAU,WAAW;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,wBAAwB,EAAE,MAAM,CAAC;IACjC,wBAAwB,EAAE,MAAM,CAAC;IACjC,2BAA2B;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAy7CpG"}