@aalis/plugin-user-relation 0.4.1

package/dist/actions.js

@@ -0,0 +1,705 @@
+import { scoreToTier } from './service.js';
+/** 关系类型 → 中文显示（WebUI 渲染用；不影响存储里的英文 key） */
+const RELATION_LABEL_ZH = {
+    // person-event role
+    initiator: '发起者',
+    participant: '参与者',
+    witness: '旁观者',
+    target: '被指向',
+    reporter: '转述者',
+    // person-entity role
+    enthusiast: '爱好者',
+    owner: '拥有者',
+    creator: '创作者',
+    critic: '批评者',
+    visitor: '访客',
+    mentioned: '仅提及',
+    // person-person relation
+    friend: '朋友',
+    cp: 'CP',
+    rival: '对手',
+    mentor: '师徒',
+    colleague: '同事',
+    familiar: '熟人',
+    antagonist: '对头',
+    admirer: '仰慕者',
+    // event-event relation
+    'caused-by': '因→果',
+    follows: '随后',
+    'part-of': '属于',
+    related: '相关',
+    // event-entity relation
+    about: '关于',
+    uses: '使用',
+    'located-at': '位于',
+    produced: '产出',
+    // entity-entity relation
+    contains: '包含',
+    'variant-of': '变体',
+    opposite: '对立',
+    // entity kind / sentiment（少量备用）
+    positive: '正向',
+    negative: '负向',
+    neutral: '中性',
+    mixed: '复杂',
+};
+function labelZh(raw) {
+    if (!raw)
+        return raw;
+    return RELATION_LABEL_ZH[raw] ?? raw;
+}
+function svc(ctx) {
+    return ctx.getService('user-relation');
+}
+function previewEvidence(e) {
+    if (e.evidence.length === 0)
+        return '';
+    const recent = [...e.evidence].sort((a, b) => b.extractedAt - a.extractedAt)[0];
+    return recent.quote
+        ? `「${recent.quote.slice(0, 30)}${recent.quote.length > 30 ? '…' : ''}」`
+        : `${recent.messageIds.length} 条证据`;
+}
+function formatDate(ts) {
+    return new Date(ts).toISOString().replace('T', ' ').slice(0, 16);
+}
+/** 给任意对象补充时间戳的可读字符串字段（保留原数字字段不动）。 */
+function withReadableDates(o) {
+    const out = { ...o };
+    for (const key of ['firstSeenAt', 'lastSeenAt', 'lastReinforcedAt', 'lastMentionedAt']) {
+        const v = o[key];
+        if (typeof v === 'number' && Number.isFinite(v)) {
+            out[`${key}Text`] = formatDate(v);
+        }
+    }
+    return out;
+}
+/** evidence 列表的统一展开（按时间倒序 + 附时间文本，保留 messageIds/quote/sessionId 原样）。 */
+function expandEvidence(list) {
+    return [...list]
+        .sort((a, b) => b.extractedAt - a.extractedAt)
+        .map(ev => ({
+        quote: ev.quote,
+        messageIds: ev.messageIds,
+        sessionId: ev.sessionId,
+        extractedAt: ev.extractedAt,
+        extractedAtText: formatDate(ev.extractedAt),
+    }));
+}
+export const actions = {
+    // ───── 表格数据源 ─────
+    async listPersons(ctx) {
+        const s = svc(ctx);
+        if (!s)
+            return [];
+        const snap = await s.loadAll();
+        return snap.persons
+            .sort((a, b) => b.lastSeenAt - a.lastSeenAt)
+            .map((p) => ({
+            id: p.id,
+            platform: p.platform,
+            userId: p.userId,
+            displayName: p.displayName ?? '',
+            firstSeenAt: formatDate(p.firstSeenAt),
+            lastSeenAt: formatDate(p.lastSeenAt),
+        }));
+    },
+    async listEvents(ctx) {
+        const s = svc(ctx);
+        if (!s)
+            return [];
+        const snap = await s.loadAll();
+        return snap.events
+            .sort((a, b) => b.lastReinforcedAt - a.lastReinforcedAt)
+            .map((e) => ({
+            id: e.id,
+            title: e.title,
+            category: e.category ?? '',
+            sessionScope: e.sessionScope ?? 'global',
+            summary: e.summary ?? '',
+            evidenceCount: e.evidence.length,
+            preview: previewEvidence(e),
+            lastReinforcedAt: formatDate(e.lastReinforcedAt),
+        }));
+    },
+    async listEntities(ctx) {
+        const s = svc(ctx);
+        if (!s)
+            return [];
+        const snap = await s.loadAll();
+        return snap.entities
+            .sort((a, b) => b.lastReinforcedAt - a.lastReinforcedAt)
+            .map((e) => ({
+            id: e.id,
+            name: e.name,
+            entityKind: e.entityKind,
+            aliases: (e.aliases ?? []).join(', '),
+            summary: e.summary ?? '',
+            evidenceCount: e.evidence.length,
+            lastReinforcedAt: formatDate(e.lastReinforcedAt),
+        }));
+    },
+    // ───── 关系图（Cytoscape elements） ─────
+    async getRelationGraph(ctx, args) {
+        const s = svc(ctx);
+        if (!s)
+            return { nodes: [], edges: [] };
+        // 焦点可为 person(`platform:userId`，含冒号) / event / entity(UUID)。
+        // 不再以「包含冒号」来过滤——event/entity UUID 不含冒号也应被接受。
+        const focusIdRaw = typeof args.focusId === 'string' ? args.focusId.trim() : '';
+        const focusId = focusIdRaw || undefined;
+        const maxDepth = numArg(args.maxDepth, 2);
+        const maxBreadth = numArg(args.maxBreadth, 10);
+        let persons;
+        let events;
+        let entities;
+        let edges;
+        let focusEdge;
+        // 全图 snapshot：用于给每个返回节点附 compositeScore + tier（基于全图位置而非子图）。
+        const fullSnap = await s.loadAll();
+        if (focusId) {
+            // 先检测 focusId 是否为某条边的 id：若是 → 取边两端点作为起点 + 1 跳邻域
+            const edgeMatch = fullSnap.edges.find(e => e.id === focusId);
+            if (edgeMatch) {
+                focusEdge = edgeMatch;
+                const endpointIds = edgeEndpointIds(edgeMatch);
+                const sub = await s.traverseSubgraph({ startNodeIds: endpointIds, maxDepth, maxBreadth });
+                persons = sub.persons;
+                events = sub.events;
+                entities = sub.entities;
+                edges = sub.edges;
+                if (!edges.some(e => e.id === edgeMatch.id))
+                    edges.push(edgeMatch);
+            }
+            else {
+                const sub = await s.traverseSubgraph({ startNodeIds: [focusId], maxDepth, maxBreadth });
+                persons = sub.persons;
+                events = sub.events;
+                entities = sub.entities;
+                edges = sub.edges;
+            }
+        }
+        else {
+            // 全图模式：直接全量返回，由前端 / 焦点功能进行筛选。
+            // 历史上这里做过「按 lastSeenAt 截断 + 过滤未触达事件/实体」的优化，
+            // 但会导致「person A 在图里但其关系对端 B 被截断 → A 看似孤儿」的视觉错觉
+            // （真正的孤儿在压缩阶段已由 pruneOrphans 删除）。压缩流程已收紧，全图直出更诚实。
+            persons = fullSnap.persons;
+            events = fullSnap.events;
+            entities = fullSnap.entities;
+            edges = fullSnap.edges;
+        }
+        const personLabel = (p) => p.displayName?.trim() || p.userId;
+        const truncate = (text, max) => (text.length > max ? `${text.slice(0, max)}…` : text);
+        // 给每个返回节点附 compositeScore + tier：用全图位置计算百分位，避免子图局部错觉。
+        const scoreOf = (id) => s._computeSingleNodeScore(id, fullSnap);
+        const allScored = [];
+        for (const p of fullSnap.persons) {
+            const sc = scoreOf(p.id);
+            if (sc)
+                allScored.push({ id: p.id, kind: 'person', score: sc.compositeScore });
+        }
+        for (const e of fullSnap.events) {
+            const sc = scoreOf(e.id);
+            if (sc)
+                allScored.push({ id: e.id, kind: 'event', score: sc.compositeScore });
+        }
+        for (const e of fullSnap.entities) {
+            const sc = scoreOf(e.id);
+            if (sc)
+                allScored.push({ id: e.id, kind: 'entity', score: sc.compositeScore });
+        }
+        const tierByNodeId = new Map();
+        for (const kind of ['person', 'event', 'entity']) {
+            const sameKind = allScored.filter(s => s.kind === kind).sort((a, b) => b.score - a.score);
+            for (let i = 0; i < sameKind.length; i++) {
+                const rank = i + 1;
+                const percentile = sameKind.length > 1 ? (sameKind.length - rank) / (sameKind.length - 1) : 1;
+                tierByNodeId.set(sameKind[i].id, {
+                    compositeScore: sameKind[i].score,
+                    tier: scoreToTier(sameKind[i].score, percentile),
+                });
+            }
+        }
+        const getScoreFields = (id) => {
+            const t = tierByNodeId.get(id);
+            return t ? { compositeScore: t.compositeScore, tier: t.tier } : { compositeScore: undefined, tier: undefined };
+        };
+        const globalPrRanks = {};
+        {
+            const prEntries = [];
+            for (const p of fullSnap.persons) {
+                if (typeof p.lastPageRank === 'number' && Number.isFinite(p.lastPageRank))
+                    prEntries.push({ id: p.id, kind: 'person', pr: p.lastPageRank });
+            }
+            for (const e of fullSnap.events) {
+                if (typeof e.lastPageRank === 'number' && Number.isFinite(e.lastPageRank))
+                    prEntries.push({ id: e.id, kind: 'event', pr: e.lastPageRank });
+            }
+            for (const e of fullSnap.entities) {
+                if (typeof e.lastPageRank === 'number' && Number.isFinite(e.lastPageRank))
+                    prEntries.push({ id: e.id, kind: 'entity', pr: e.lastPageRank });
+            }
+            const globalSorted = [...prEntries].sort((a, b) => b.pr - a.pr);
+            const globalTotal = globalSorted.length;
+            const globalRankById = new Map();
+            for (let i = 0; i < globalSorted.length; i++)
+                globalRankById.set(globalSorted[i].id, i + 1);
+            const byKind = new Map();
+            for (const e of prEntries) {
+                const arr = byKind.get(e.kind) ?? [];
+                arr.push(e);
+                byKind.set(e.kind, arr);
+            }
+            for (const [, arr] of byKind) {
+                arr.sort((a, b) => b.pr - a.pr);
+                for (let i = 0; i < arr.length; i++) {
+                    globalPrRanks[arr[i].id] = {
+                        kindRank: i + 1,
+                        kindTotal: arr.length,
+                        globalRank: globalRankById.get(arr[i].id) ?? 0,
+                        globalTotal,
+                    };
+                }
+            }
+        }
+        // 防御：过滤掉引用了缺失节点的“幽灵边”——避免前端 cytoscape 抛
+        // “Can not create edge with nonexistent source/target”导致整个图黑屏。
+        // 历史上某些级联删除/合并路径可能漏清边；这里只做防御性兜底，不修复存储。
+        {
+            const validNodeIds = new Set();
+            for (const p of persons)
+                validNodeIds.add(p.id);
+            for (const e of events)
+                validNodeIds.add(e.id);
+            for (const e of entities)
+                validNodeIds.add(e.id);
+            const before = edges.length;
+            const kept = [];
+            const danglingPairs = [];
+            for (const e of edges) {
+                const [src, tgt] = edgeEndpointIds(e);
+                if (validNodeIds.has(src) && validNodeIds.has(tgt)) {
+                    kept.push(e);
+                }
+                else {
+                    danglingPairs.push(`${e.id}(${src}→${tgt})`);
+                }
+            }
+            if (danglingPairs.length > 0) {
+                const logger = ctx.logger;
+                const sample = danglingPairs.slice(0, 5).join(', ');
+                const more = danglingPairs.length > 5 ? `，… 共 ${danglingPairs.length} 条` : '';
+                logger?.warn(`[user-relation] getRelationGraph: 跳过 ${danglingPairs.length}/${before} 条幽灵边（节点缺失）: ${sample}${more}`);
+            }
+            edges = kept;
+        }
+        return {
+            focusId,
+            focusEdge: focusEdge
+                ? {
+                    id: focusEdge.id,
+                    kind: focusEdge.kind,
+                    weight: focusEdge.weight,
+                    description: focusEdge.description,
+                    firstSeenAt: focusEdge.firstSeenAt,
+                    lastReinforcedAt: focusEdge.lastReinforcedAt,
+                    evidence: focusEdge.evidence,
+                    endpoints: edgeEndpointIds(focusEdge),
+                    // 按 kind 暴露的额外语义字段（在前端面板里展示）
+                    relation: focusEdge.kind === 'person-event' || focusEdge.kind === 'person-entity'
+                        ? undefined
+                        : focusEdge.relationType,
+                    role: focusEdge.kind === 'person-event' || focusEdge.kind === 'person-entity' ? focusEdge.role : undefined,
+                    sentiment: focusEdge.kind === 'person-event' || focusEdge.kind === 'person-entity' ? focusEdge.sentiment : undefined,
+                    directed: focusEdge.kind === 'person-event' || focusEdge.kind === 'person-entity' ? undefined : focusEdge.directed,
+                }
+                : undefined,
+            stats: {
+                persons: persons.length,
+                events: events.length,
+                entities: entities.length,
+                edges: edges.length,
+            },
+            globalPrRanks,
+            nodes: [
+                ...persons.map(p => ({
+                    data: {
+                        id: p.id,
+                        label: personLabel(p),
+                        kind: 'person',
+                        platform: p.platform,
+                        userId: p.userId,
+                        displayName: p.displayName,
+                        lastPageRank: p.lastPageRank,
+                        ...getScoreFields(p.id),
+                    },
+                })),
+                ...events.map(e => ({
+                    data: {
+                        id: e.id,
+                        label: truncate(e.title, 18),
+                        kind: 'event',
+                        category: e.category,
+                        title: e.title,
+                        summary: e.summary,
+                        sessionScope: e.sessionScope ?? 'global',
+                        lastPageRank: e.lastPageRank,
+                        ...getScoreFields(e.id),
+                    },
+                })),
+                ...entities.map(e => ({
+                    data: {
+                        id: e.id,
+                        label: truncate(e.name, 16),
+                        kind: 'entity',
+                        entityKind: e.entityKind,
+                        name: e.name,
+                        summary: e.summary,
+                        lastPageRank: e.lastPageRank,
+                        ...getScoreFields(e.id),
+                    },
+                })),
+            ],
+            edges: edges.map(e => {
+                if (e.kind === 'person-event') {
+                    return {
+                        data: {
+                            id: e.id,
+                            source: e.fromPersonId,
+                            target: e.toEventId,
+                            kind: 'person-event',
+                            label: labelZh(e.role),
+                            role: e.role,
+                            weight: e.weight,
+                            sentiment: e.sentiment,
+                            description: e.description,
+                        },
+                    };
+                }
+                if (e.kind === 'person-entity') {
+                    return {
+                        data: {
+                            id: e.id,
+                            source: e.fromPersonId,
+                            target: e.toEntityId,
+                            kind: 'person-entity',
+                            label: labelZh(e.role),
+                            role: e.role,
+                            weight: e.weight,
+                            sentiment: e.sentiment,
+                            description: e.description,
+                        },
+                    };
+                }
+                if (e.kind === 'event-event') {
+                    return {
+                        data: {
+                            id: e.id,
+                            source: e.fromEventId,
+                            target: e.toEventId,
+                            kind: 'event-event',
+                            label: labelZh(e.relationType),
+                            relationType: e.relationType,
+                            directed: e.directed,
+                            weight: e.weight,
+                            description: e.description,
+                        },
+                    };
+                }
+                if (e.kind === 'event-entity') {
+                    return {
+                        data: {
+                            id: e.id,
+                            source: e.fromEventId,
+                            target: e.toEntityId,
+                            kind: 'event-entity',
+                            label: labelZh(e.relationType),
+                            relationType: e.relationType,
+                            directed: true,
+                            weight: e.weight,
+                            description: e.description,
+                        },
+                    };
+                }
+                if (e.kind === 'entity-entity') {
+                    return {
+                        data: {
+                            id: e.id,
+                            source: e.fromEntityId,
+                            target: e.toEntityId,
+                            kind: 'entity-entity',
+                            label: labelZh(e.relationType),
+                            relationType: e.relationType,
+                            directed: e.directed,
+                            weight: e.weight,
+                            description: e.description,
+                        },
+                    };
+                }
+                return {
+                    data: {
+                        id: e.id,
+                        source: e.fromPersonId,
+                        target: e.toPersonId,
+                        kind: 'person-person',
+                        label: labelZh(e.relationType),
+                        relationType: e.relationType,
+                        directed: e.directed,
+                        weight: e.weight,
+                        description: e.description,
+                    },
+                };
+            }),
+        };
+    },
+    async getGraphNodeDetail(ctx, args) {
+        const s = svc(ctx);
+        if (!s)
+            return { error: 'service 不可用' };
+        const nodeId = String(args.nodeId ?? '');
+        const kind = String(args.kind ?? '');
+        if (kind === 'person') {
+            if (!nodeId.includes(':'))
+                return { error: '无效 personId' };
+            const nb = await s.getNeighborhood(nodeId);
+            return {
+                person: withReadableDates(nb.person),
+                eventCount: nb.events.length,
+                edgeCount: nb.edges.length,
+                recentEvents: nb.events.slice(0, 5).map(e => withReadableDates({
+                    id: e.id,
+                    title: e.title,
+                    category: e.category,
+                    summary: e.summary,
+                    weight: e.weight,
+                    mentionCount: e.mentionCount,
+                    firstSeenAt: e.firstSeenAt,
+                    lastReinforcedAt: e.lastReinforcedAt,
+                    lastMentionedAt: e.lastMentionedAt,
+                    evidenceCount: e.evidence.length,
+                    evidencePreview: previewEvidence(e),
+                })),
+                edges: nb.edges.slice(0, 10).map(e => {
+                    // 通用骨架：把所有边都 spread 出来，并补可读时间 + 中文 role/relation
+                    const base = withReadableDates({
+                        ...e,
+                        evidenceCount: e.evidence.length,
+                        evidencePreview: previewEvidence(e),
+                    });
+                    if (e.kind === 'person-event' || e.kind === 'person-entity') {
+                        base.roleZh = labelZh(e.role);
+                    }
+                    else if ('relationType' in e && e.relationType) {
+                        base.relationZh = labelZh(e.relationType);
+                    }
+                    return base;
+                }),
+            };
+        }
+        if (kind === 'event') {
+            const e = await s.getEvent(nodeId);
+            if (!e)
+                return { error: '事件不存在' };
+            return {
+                ...withReadableDates(e),
+                evidenceCount: e.evidence.length,
+                evidence: expandEvidence(e.evidence),
+            };
+        }
+        if (kind === 'entity') {
+            const e = await s.getEntity(nodeId);
+            if (!e)
+                return { error: '实体不存在' };
+            return {
+                ...withReadableDates(e),
+                aliases: e.aliases ?? [],
+                evidenceCount: e.evidence.length,
+                evidence: expandEvidence(e.evidence),
+            };
+        }
+        return { error: `未知 kind: ${kind}` };
+    },
+    // ───── stat / info ─────
+    async getStats(ctx) {
+        const s = svc(ctx);
+        if (!s)
+            return { value: 0 };
+        const snap = await s.loadAll();
+        const pe = snap.edges.filter(e => e.kind === 'person-event').length;
+        const pp = snap.edges.filter(e => e.kind === 'person-person').length;
+        const pent = snap.edges.filter(e => e.kind === 'person-entity').length;
+        const ee = snap.edges.filter(e => e.kind === 'event-event').length;
+        const eent = snap.edges.filter(e => e.kind === 'event-entity').length;
+        const entent = snap.edges.filter(e => e.kind === 'entity-entity').length;
+        return {
+            value: snap.persons.length,
+            detail: `人物 ${snap.persons.length} / 事件 ${snap.events.length} / 实体 ${snap.entities.length} / 人-事 ${pe} / 人-人 ${pp} / 人-实体 ${pent} / 事-事 ${ee} / 事-实体 ${eent} / 实体-实体 ${entent}`,
+        };
+    },
+    // ───── 详情 ─────
+    async getPerson(ctx, args) {
+        const s = svc(ctx);
+        if (!s)
+            return { error: 'service 不可用' };
+        const id = String(args.id ?? '');
+        const [platform = '', userId = ''] = id.split(':');
+        if (!platform || !userId)
+            return { error: '无效 personId' };
+        const nb = await s.getNeighborhood(id);
+        return {
+            person: nb.person,
+            events: nb.events,
+            edges: nb.edges,
+        };
+    },
+    async getEvent(ctx, args) {
+        const s = svc(ctx);
+        if (!s)
+            return { error: 'service 不可用' };
+        const e = await s.getEvent(String(args.id ?? ''));
+        if (!e)
+            return { error: '事件不存在' };
+        return e;
+    },
+    // ───── 操作类 ─────
+    async deletePerson(ctx, args) {
+        const s = svc(ctx);
+        if (!s)
+            return { error: 'service 不可用' };
+        const id = String(args.id ?? '');
+        const [platform = '', userId = ''] = id.split(':');
+        if (!platform || !userId)
+            return { error: '无效 personId' };
+        await s.deletePerson(platform, userId);
+        return { ok: true };
+    },
+    async deleteEvent(ctx, args) {
+        const s = svc(ctx);
+        if (!s)
+            return { error: 'service 不可用' };
+        await s.deleteEvent(String(args.id ?? ''));
+        return { ok: true };
+    },
+    async deleteEntity(ctx, args) {
+        const s = svc(ctx);
+        if (!s)
+            return { error: 'service 不可用' };
+        await s.deleteEntity(String(args.id ?? ''));
+        return { ok: true };
+    },
+    async deleteEdge(ctx, args) {
+        const s = svc(ctx);
+        if (!s)
+            return { error: 'service 不可用' };
+        await s.deleteEdge(String(args.id ?? ''));
+        return { ok: true };
+    },
+    async triggerExtraction(ctx, args) {
+        const s = svc(ctx);
+        if (!s)
+            return { error: 'service 不可用' };
+        const sessionId = String(args.sessionId ?? '').trim();
+        if (!sessionId)
+            return { error: '请输入 sessionId' };
+        return s.triggerExtraction(sessionId);
+    },
+    // ───── 多层查询（webui view + 调试用，参数走 view.* 范畴的默认值/上限由 index.ts 注入） ─────
+    async expandPerson(ctx, args) {
+        const s = svc(ctx);
+        if (!s)
+            return { error: 'service 不可用' };
+        const personId = String(args.personId ?? args.id ?? '').trim();
+        if (!personId.includes(':'))
+            return { error: 'personId 格式应为 platform:userId' };
+        const maxDepth = numArg(args.maxDepth, 2);
+        const maxBreadth = numArg(args.maxBreadth, 10);
+        const sub = await s.traverseSubgraph({
+            startNodeIds: [personId],
+            maxDepth,
+            maxBreadth,
+        });
+        return {
+            personId,
+            maxDepth,
+            maxBreadth,
+            stats: {
+                persons: sub.persons.length,
+                events: sub.events.length,
+                edges: sub.edges.length,
+            },
+            persons: sub.persons,
+            events: sub.events,
+            edges: sub.edges,
+        };
+    },
+    async findPath(ctx, args) {
+        const s = svc(ctx);
+        if (!s)
+            return { error: 'service 不可用' };
+        const from = String(args.fromPersonId ?? args.from ?? '').trim();
+        const to = String(args.toPersonId ?? args.to ?? '').trim();
+        if (!from.includes(':') || !to.includes(':'))
+            return { error: 'person id 格式应为 platform:userId' };
+        const maxDepth = numArg(args.maxDepth, 3);
+        const path = await s.findPath(from, to, maxDepth);
+        if (!path)
+            return { found: false, from, to, maxDepth };
+        return {
+            found: true,
+            length: path.edges.length,
+            nodes: path.nodes,
+            edges: path.edges,
+        };
+    },
+    async searchEvents(ctx, args) {
+        const s = svc(ctx);
+        if (!s)
+            return { error: 'service 不可用' };
+        const keyword = typeof args.keyword === 'string' ? args.keyword : undefined;
+        const days = numArgOptional(args.days);
+        const limit = numArg(args.limit, 20);
+        const events = await s.searchEvents({ keyword, days, limit });
+        return {
+            count: events.length,
+            events,
+        };
+    },
+};
+function numArg(v, fallback) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    if (typeof v === 'string' && v.trim() !== '') {
+        const n = Number(v);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return fallback;
+}
+function numArgOptional(v) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    if (typeof v === 'string' && v.trim() !== '') {
+        const n = Number(v);
+        if (Number.isFinite(n))
+            return n;
+    }
+    return undefined;
+}
+/** 给定一条边，返回它的两个端点 id（统一为字符串数组） */
+function edgeEndpointIds(e) {
+    switch (e.kind) {
+        case 'person-event':
+            return [e.fromPersonId, e.toEventId];
+        case 'person-person':
+            return [e.fromPersonId, e.toPersonId];
+        case 'person-entity':
+            return [e.fromPersonId, e.toEntityId];
+        case 'event-event':
+            return [e.fromEventId, e.toEventId];
+        case 'event-entity':
+            return [e.fromEventId, e.toEntityId];
+        case 'entity-entity':
+            return [e.fromEntityId, e.toEntityId];
+    }
+}
+//# sourceMappingURL=actions.js.map