@roaming-ai/dsh-group-chat 0.2.0

package/lib/types/core/types.d.ts

@@ -0,0 +1,256 @@
+/**
+ * 群聊数据模型（core 层，无 cordis 依赖）。
+ * 数据模型：Group 1..N Session，消息挂在会话上；角色与工作区目录挂在群组上。
+ * @module dsh-group-chat/core/types
+ */
+/**
+ * 群组权限档位（对齐主会话 /permission 三档）：
+ * - view_only 仅可查看：只保留 read_file/list_dir，run_command 从 schema 剔除
+ * - workspace_write 工作区内修改：run_command 可用，每条命令逐条确认
+ * - full_access 完全权限：run_command 免确认直接执行
+ */
+export type PermissionTier = 'view_only' | 'workspace_write' | 'full_access';
+/** 全部合法档位（展示顺序）。 */
+export declare const PERMISSION_TIERS: readonly PermissionTier[];
+/** 档位安全化：合法字符串原样，其余 undefined。 */
+export declare function asPermissionTier(value: unknown): PermissionTier | undefined;
+/**
+ * ledger 行档位归一（v2→v3 兼容）：显式 permissionTier 优先；
+ * 缺失时按旧布尔迁移——allowCommands=true → workspace_write（今日语义即
+ * 「可执行命令但逐条确认」），false/无字段 → view_only。
+ */
+export declare function migrateTier(permissionTier: unknown, allowCommands: unknown): PermissionTier;
+/** 群组：角色与工作区目录的宿主。 */
+export interface GroupRecord {
+    id: string;
+    name: string;
+    workspaceDir: string;
+    permissionTier: PermissionTier;
+    roleIds: string[];
+    sessionIds: string[];
+}
+/** 会话：消息挂在会话上。 */
+export interface SessionRecord {
+    id: string;
+    groupId: string;
+    name: string;
+    topic: string;
+    /** 名称已被手动编辑：自动命名永久跳过（隐式固定）。 */
+    namePinned?: boolean;
+    /** 主题已被手动编辑：自动整理永久跳过（隐式固定）。 */
+    topicPinned?: boolean;
+    messageIds: string[];
+    createdAt: number;
+}
+/** 角色：绑定 provider/model 的群成员身份。 */
+export interface RoleRecord {
+    id: string;
+    groupId: string;
+    name: string;
+    color?: string;
+    persona: string;
+    provider: string;
+    model: string;
+    temperature?: number;
+    reasoningEffort?: string;
+    enabled: boolean;
+    thinking: boolean;
+}
+/** 一次工具调用的落盘/快照形态（TOOLS.md §3.3 回注契约的展示面）。 */
+export interface ToolCallRecord {
+    tool: string;
+    args: unknown;
+    status: string;
+    output: string;
+    durationMs?: number;
+}
+/** 消息（user / system / 角色发言共用一条记录）。 */
+export interface MessageRecord {
+    id: string;
+    sessionId: string;
+    seq: number;
+    speaker: string;
+    text: string;
+    reasoning?: string;
+    reasoningFull?: string;
+    thinkingSummary?: string;
+    model?: string;
+    error?: boolean;
+    toolCalls?: ToolCallRecord[];
+    ts: number;
+}
+/** run_command 确认闸门的待确认载荷。 */
+export interface PendingConfirm {
+    toolCallId: string;
+    tool: string;
+    args: {
+        command?: string;
+    } & Record<string, unknown>;
+}
+/** 最近一次创建的群组/会话，供客户端定位选中项。 */
+export interface LastCreated {
+    kind: 'group' | 'session';
+    groupId: string;
+    sessionId: string;
+}
+/** run 结束后的「输出完毕」标记（内存态不持久化，重启即清；reason 取 ok/error）。 */
+export interface RunFinished {
+    sessionId: string;
+    reason: 'ok' | 'error';
+}
+/** 对话进行时状态（run）。 */
+export interface RunState {
+    running: boolean;
+    sessionId: string | null;
+    currentRoleId: string | null;
+    partial: string;
+    partialReasoning: string;
+    stopping: boolean;
+    queue: string[];
+    pendingConfirm: PendingConfirm | null;
+    confirmSignal: {
+        resolve: (allowed: boolean) => void;
+    } | null;
+    childProc: import('node:child_process').ChildProcess | null;
+    /** 最近一次 run 的结束标记：会话列表「已完成/已出错」状态的数据源。 */
+    finished: RunFinished | null;
+}
+/** 角色发言的引擎产物。 */
+export interface SpeakResult {
+    text: string;
+    reasoning: string | undefined;
+    toolCalls: ToolCallRecord[];
+}
+/** 工具执行结果（host 内部约定）。 */
+export interface ToolExecution {
+    status: 'ok' | 'error' | 'denied';
+    output: string;
+    args: Record<string, unknown>;
+    durationMs: number;
+}
+/** 模型目录（models action 的缓存载荷）。 */
+export interface ModelCatalog {
+    at: number;
+    providers: {
+        id: string;
+        name: string;
+    }[];
+    modelsByProvider: Record<string, {
+        id: string;
+        name?: string;
+    }[]>;
+}
+/** 推理级别选项（efforts action 的载荷）。 */
+export interface EffortOptions {
+    efforts: {
+        id: string;
+        name: string;
+        description?: string;
+    }[];
+    defaultEffort: string | undefined;
+    error?: string;
+}
+/** 目录浏览结果（browse action 的载荷）。 */
+export interface BrowseResult {
+    ok: boolean;
+    path?: string;
+    home?: string;
+    parent?: string;
+    entries?: {
+        name: string;
+        type: string;
+        path: string;
+        size?: number;
+        hidden: boolean;
+    }[];
+    error?: string;
+}
+/** 群工作区 @ 文件检索结果（fileSearch action 的载荷）。 */
+export interface FileSearchResult {
+    ok: boolean;
+    candidates?: {
+        path: string;
+        isDir: boolean;
+    }[];
+    error?: string;
+}
+/** 发到客户端的全量快照（wire 形态）。 */
+export interface Snapshot {
+    revision: number;
+    run: {
+        running: boolean;
+        sessionId: string | null;
+        currentRoleId: string | null;
+        partial: string;
+        partialReasoning: string;
+        pendingConfirm: PendingConfirm | null;
+        finished: RunFinished | null;
+    };
+    lastCreated: LastCreated | null;
+    groups: {
+        id: string;
+        name: string;
+        workspaceDir: string;
+        permissionTier: PermissionTier;
+        roleIds: string[];
+        sessionIds: string[];
+    }[];
+    sessions: {
+        id: string;
+        groupId: string;
+        name: string;
+        topic: string;
+        messageIds: string[];
+        createdAt: number;
+    }[];
+    roles: {
+        id: string;
+        groupId: string;
+        name: string;
+        color?: string;
+        persona: string;
+        provider: string;
+        model: string;
+        temperature?: number;
+        reasoningEffort?: string;
+        enabled: boolean;
+        thinking: boolean;
+    }[];
+    messages: {
+        id: string;
+        sessionId: string;
+        seq: number;
+        speaker: string;
+        text: string;
+        reasoning?: string;
+        model?: string;
+        error?: boolean;
+        toolCalls?: ToolCallRecord[];
+        ts: number;
+    }[];
+    error?: string;
+}
+/** mutate 动作的参数形态（op 分发见 host/service）。 */
+export interface MutateArgs {
+    op: string;
+    groupId?: string;
+    sessionId?: string;
+    roleId?: string;
+    role?: Partial<RoleRecord>;
+    name?: string;
+    topic?: string;
+    path?: string;
+    tier?: string;
+    enabled?: boolean;
+}
+/** send 动作的参数形态。 */
+export interface SendArgs {
+    sessionId: string;
+    text?: string;
+    participantRoleIds?: string[];
+    rounds?: number;
+}
+/** 可选数值参数安全化：数字则原样，否则 undefined。 */
+export declare function asNumber(value: unknown): number | undefined;
+/** 可选字符串参数安全化：非 default 的非空字符串则原样，否则 undefined。 */
+export declare function asEffort(value: unknown): string | undefined;

package/lib/types/host/actions.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 动作分发（handleAction，POST /api/group-chat/action 的载荷）：
+ * mutate（12 种 CRUD/配置操作）| send | stop | confirmCommand | models | efforts。
+ * @module dsh-group-chat/host/actions
+ */
+import type { BrowseResult, Snapshot } from '../core/types.ts';
+import type { HostState } from './state.ts';
+/** 动作面。 */
+export interface Actions {
+    handleAction: (body: Record<string, unknown>) => Promise<unknown>;
+}
+/** 创建动作分发面。 */
+export declare function createActions(core: HostState, deps: {
+    touch: () => void;
+    snapshot: () => Snapshot;
+    schedulePersist: (targets?: {
+        ledger?: boolean;
+        session?: string | null;
+        roles?: string | null;
+        workspace?: string | null;
+    }) => void;
+    dropDirty: (targets: {
+        session?: string | null;
+        roles?: string | null;
+        workspace?: string | null;
+    }) => void;
+    appendMessage: import('./conversation.ts').Conversation['appendMessage'];
+    runLoop: import('./conversation.ts').Conversation['runLoop'];
+    wakeConfirm: () => void;
+    killChild: () => void;
+    browse: (args: {
+        path?: string;
+    } | undefined) => Promise<BrowseResult>;
+}): Actions;

package/lib/types/host/api/actions.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 动作分发（handleAction，POST /api/group-chat/action 的载荷）：
+ * mutate（12 种 CRUD/配置操作）| send | stop | confirmCommand | models | efforts。
+ * @module dsh-group-chat/host/api/actions
+ */
+import type { Snapshot } from '../../core/types.ts';
+import type { HostState } from '../state.ts';
+import type { Conversation } from '../engine/index.ts';
+import type { Materials } from '../materials/index.ts';
+/** 动作面。 */
+export interface Actions {
+    handleAction: (body: Record<string, unknown>) => Promise<unknown>;
+}
+/** 创建动作分发面。 */
+export declare function createActions(core: HostState, deps: {
+    touch: () => void;
+    snapshot: () => Snapshot;
+    schedulePersist: (targets?: {
+        ledger?: boolean;
+        session?: string | null;
+        roles?: string | null;
+        workspace?: string | null;
+    }) => void;
+    dropDirty: (targets: {
+        session?: string | null;
+        roles?: string | null;
+        workspace?: string | null;
+    }) => void;
+    appendMessage: Conversation['appendMessage'];
+    runLoop: Conversation['runLoop'];
+    wakeConfirm: () => void;
+    killChild: () => void;
+    browse: Materials['browse'];
+    fileSearch: Materials['fileSearch'];
+    disposeFileSearch: Materials['disposeFileSearch'];
+}): Actions;

package/lib/types/host/api/http.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Host HTTP 工具：回环信任栏（对齐 dsh-web shared/host/loopback.ts 语义 +
+ * 浏览器同源标记栏）、有界 JSON 请求体读取、JSON 响应写出。
+ * @module dsh-group-chat/host/api/http
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/**
+ * 请求级信任栏：浏览器同源标记（sec-fetch-site / Origin）必须存在且回环
+ * socket + 回环 Host 全过；X-Forwarded-For 一律不信任。无任何同源标记的
+ * 非浏览器请求（如裸 curl）一律拒绝。
+ */
+export declare function isTrustedRequest(req: IncomingMessage): boolean;
+/** 读有界 JSON 请求体；超限抛 'body-too-large'（路由映射 413）。 */
+export declare function readBody(req: IncomingMessage): Promise<unknown>;
+/** 写 JSON 响应；调用方可追加/覆盖默认头。 */
+export declare function writeJson(res: ServerResponse, status: number, body: unknown, headers?: Record<string, string | number>): void;

package/lib/types/host/api/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * API 层统一导出：HTTP 传输（护栏 + 路由）与动作分发。
+ * @module dsh-group-chat/host/api
+ */
+export { createActions } from './actions.ts';
+export type { Actions } from './actions.ts';
+export { makeGroupChatRoutes } from './routes.ts';

package/lib/types/host/api/routes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * HTTP 路由（经 webServer 暴露）：
+ *   GET  /api/group-chat/state   全量快照
+ *   POST /api/group-chat/action   { kind: mutate|send|stop|confirmCommand|models|efforts|browse|fileSearch, ... }
+ *   GET  /api/group-chat/events   SSE，状态变化时推送节流后的全量快照
+ * @module dsh-group-chat/host/api/routes
+ */
+import type { WebRoute } from '@deepseek-ai/dsh-host-webserver';
+import type { GroupChatService } from '../service.ts';
+/** 构建群聊的三条 HTTP 路由。 */
+export declare function makeGroupChatRoutes(service: GroupChatService): WebRoute[];

package/lib/types/host/broadcast.d.ts

@@ -0,0 +1,20 @@
+/**
+ * SSE 广播（节流）+ touch + 全量快照：变更经 touch()（revision++ + 节流广播）
+ * 通知 /api/group-chat/events 订阅者；快照读容器当前状态。
+ * @module dsh-group-chat/host/broadcast
+ */
+import type { HostState } from './state.ts';
+import type { Snapshot } from '../core/types.ts';
+/** 广播面。 */
+export interface Broadcast {
+    /** revision++ 并节流广播。 */
+    touch: () => void;
+    /** 全量快照（客户端唯一读取面）。 */
+    snapshot: () => Snapshot;
+    /** 订阅推送；返回退订函数。 */
+    subscribePush: (push: () => void) => () => void;
+    /** dispose：清掉挂起的节流定时器。 */
+    dispose: () => void;
+}
+/** 创建广播面。 */
+export declare function createBroadcast(core: HostState): Broadcast;

package/lib/types/host/conversation.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 对话引擎：消息追加、群聊记录转写、角色发言（speak：prompt 构建 + 流式
+ * 轮次 + 工具回注循环）、多轮 runLoop，以及会话标题/主题自动整理（retitle）。
+ * @module dsh-group-chat/host/conversation
+ */
+import type { MessageRecord, SessionRecord } from '../core/types.ts';
+import type { HostState } from './state.ts';
+import type { Materials } from './materials.ts';
+import type { Tools } from './tools.ts';
+/** 对话引擎面。 */
+export interface Conversation {
+    /** 追加一条消息到会话（touch + 落盘调度）。 */
+    appendMessage: (sess: SessionRecord, speaker: string, text: string, extra?: Partial<MessageRecord>) => MessageRecord;
+    /** 多轮 round-robin 主循环（send 触发；finally 复位 run）。 */
+    runLoop: (sess: SessionRecord) => Promise<void>;
+}
+/** 创建对话引擎。 */
+export declare function createConversation(core: HostState, deps: {
+    touch: () => void;
+    schedulePersist: (targets?: {
+        session?: string | null;
+    }) => void;
+    materials: Materials;
+    tools: Tools;
+}): Conversation;

package/lib/types/host/engine/conversation.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 对话引擎：消息追加、群聊记录转写、角色发言（speak：prompt 构建 + 流式
+ * 轮次 + 工具回注循环）、多轮 runLoop（每轮结束触发 retitle 标题整理）。
+ * @module dsh-group-chat/host/engine/conversation
+ */
+import type { MessageRecord, SessionRecord } from '../../core/types.ts';
+import type { HostState } from '../state.ts';
+import type { Materials } from '../materials/index.ts';
+import type { Tools } from '../tools/index.ts';
+/** 对话引擎面。 */
+export interface Conversation {
+    /** 追加一条消息到会话（touch + 落盘调度）。 */
+    appendMessage: (sess: SessionRecord, speaker: string, text: string, extra?: Partial<MessageRecord>) => MessageRecord;
+    /** 多轮 round-robin 主循环（send 触发；finally 复位 run）。 */
+    runLoop: (sess: SessionRecord) => Promise<void>;
+}
+/** 创建对话引擎。 */
+export declare function createConversation(core: HostState, deps: {
+    touch: () => void;
+    schedulePersist: (targets?: {
+        session?: string | null;
+    }) => void;
+    materials: Materials;
+    tools: Tools;
+}): Conversation;

package/lib/types/host/engine/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 对话引擎层统一导出
+ * @module dsh-group-chat/host/engine
+ */
+export { createConversation } from './conversation.ts';
+export type { Conversation } from './conversation.ts';
+export { createRetitle } from './retitle.ts';

package/lib/types/host/engine/retitle.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 会话标题/主题自动整理（参照 oil-codex-title）：每轮结束后用 DSH 默认模型
+ * 后台生成「类别 emoji + 对象｜目标」名称与演进式主题；手动编辑过的字段
+ * 永久跳过（隐式固定）。
+ * @module dsh-group-chat/host/engine/retitle
+ */
+import type { SessionRecord } from '../../core/types.ts';
+import type { HostState } from '../state.ts';
+/**
+ * 每轮结束后根据聊天内容整理会话名称与主题：后台 fire-and-forget、不产生
+ * 消息、静默失败。名称 =「类别 emoji + 对象｜目标」（类别固定、对象稳定、
+ * 目标实质变化才改）；主题 = 演进式一句话摘要（对象+目标+当前焦点），注入
+ * 后续轮次的角色上下文。手动编辑过的字段永久跳过（隐式固定，apply 时复查）。
+ */
+export declare function createRetitle(core: HostState, deps: {
+    touch: () => void;
+    schedulePersist: (targets?: {
+        session?: string | null;
+    }) => void;
+}): (sess: SessionRecord) => Promise<void>;

package/lib/types/host/http.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Host HTTP 工具：回环信任栏（对齐 dsh-web shared/host/loopback.ts 语义 +
+ * 浏览器同源标记栏）、有界 JSON 请求体读取、JSON 响应写出。
+ * @module dsh-group-chat/host/http
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+/**
+ * 请求级信任栏：浏览器同源标记（sec-fetch-site / Origin）必须存在且回环
+ * socket + 回环 Host 全过；X-Forwarded-For 一律不信任。无任何同源标记的
+ * 非浏览器请求（如裸 curl）一律拒绝。
+ */
+export declare function isTrustedRequest(req: IncomingMessage): boolean;
+/** 读有界 JSON 请求体；超限抛 'body-too-large'（路由映射 413）。 */
+export declare function readBody(req: IncomingMessage): Promise<unknown>;
+/** 写 JSON 响应；调用方可追加/覆盖默认头。 */
+export declare function writeJson(res: ServerResponse, status: number, body: unknown, headers?: Record<string, string | number>): void;

package/lib/types/host/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 群聊宿主半对外门面（对齐浏览器半 src/client/index.ts 的入口角色）：
+ * 插件入口（src/index.ts）只从这里取宿主面的装配件。
+ * @module dsh-group-chat/host
+ */
+export { createGroupChatService } from './service.ts';
+export type { GroupChatService } from './service.ts';
+export { makeGroupChatRoutes } from './api/routes.ts';

package/lib/types/host/materials/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 资料层统一导出
+ * @module dsh-group-chat/host/materials
+ */
+export { createMaterials } from './materials.ts';
+export type { Materials } from './materials.ts';

package/lib/types/host/materials/materials.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 资料读取与路径解析：群组工作区目录 → 注入文件清单 + 目录浏览器 + @ 文件检索。
+ * 路径解析顺序：~ 展开到 home；绝对路径直用；相对路径先试各工作区根，
+ * 再试 dsh web 进程 cwd。目录浏览器、资料读取与文件检索共用同一套解析。
+ * 无独立笔记/文件清单：共享资料 = workspaceDir 根下一层文本文件。
+ * @module dsh-group-chat/host/materials
+ */
+import type { BrowseResult, FileSearchResult, GroupRecord } from '../../core/types.ts';
+import type { HostState } from '../state.ts';
+/** 资料面。 */
+export interface Materials {
+    /** 群组工作区目录 → 注入文件清单（dir 为解析后的展示路径）。 */
+    loadWorkspaceFiles: (g: GroupRecord) => Promise<{
+        dir: string;
+        parts: {
+            name: string;
+            content: string;
+            error?: string;
+        }[];
+    }>;
+    /** 文件清单 → system 提示词内的「共享资料」块（单文件 16k / 总量 48k 截断）。 */
+    materialBlock: (parts: {
+        name: string;
+        content: string;
+        error?: string;
+    }[], dir: string) => string;
+    /** 目录浏览：返回文件+目录条目（绝对路径由 Host 解析，客户端不拼路径）。 */
+    browse: (args: {
+        path?: string;
+    } | undefined) => Promise<BrowseResult>;
+    /** 群工作区 @ 文件检索（WorkspaceFileSearch，根 = 解析后的 workspaceDir）。 */
+    fileSearch: (args: {
+        groupId?: string;
+        query?: string;
+    } | undefined) => Promise<FileSearchResult>;
+    /** 释放某群（或全部）文件检索索引。 */
+    disposeFileSearch: (groupId?: string) => void;
+}
+/** 创建资料面。 */
+export declare function createMaterials(core: HostState): Materials;

package/lib/types/host/materials.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 资料读取与路径解析：群组工作区目录 → 注入文件清单 + 目录浏览器。
+ * 路径解析顺序：~ 展开到 home；绝对路径直用；相对路径先试各工作区根，
+ * 再试 dsh web 进程 cwd。目录浏览器与资料读取共用同一套解析。
+ * @module dsh-group-chat/host/materials
+ */
+import type { BrowseResult, GroupRecord } from '../core/types.ts';
+import type { HostState } from './state.ts';
+/** 资料面。 */
+export interface Materials {
+    /** 群组工作区目录 → 注入文件清单（dir 为解析后的展示路径）。 */
+    loadWorkspaceFiles: (g: GroupRecord) => Promise<{
+        dir: string;
+        parts: {
+            name: string;
+            content: string;
+            error?: string;
+        }[];
+    }>;
+    /** 文件清单 → system 提示词内的「共享资料」块（单文件 16k / 总量 48k 截断）。 */
+    materialBlock: (parts: {
+        name: string;
+        content: string;
+        error?: string;
+    }[], dir: string) => string;
+    /** 目录浏览：返回文件+目录条目（绝对路径由 Host 解析，客户端不拼路径）。 */
+    browse: (args: {
+        path?: string;
+    } | undefined) => Promise<BrowseResult>;
+}
+/** 创建资料面。 */
+export declare function createMaterials(core: HostState): Materials;

package/lib/types/host/persistence/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 持久化层统一导出
+ * @module dsh-group-chat/host/persistence
+ */
+export { createPersistence } from './persistence.ts';
+export type { Persistence } from './persistence.ts';

package/lib/types/host/persistence/persistence.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 持久化（PERSISTENCE.md v2.1）：事件驱动脏标记合并落盘 + 启动恢复。
+ * 锁失败/写失败时降级为内存态运行（console 告警）。
+ * @module dsh-group-chat/host/persistence
+ */
+import type { HostState } from '../state.ts';
+/** 持久化面。 */
+export interface Persistence {
+    /** 事件驱动落盘；同一 tick 内多次变更合并为一次写。 */
+    schedulePersist: (targets?: {
+        ledger?: boolean;
+        session?: string | null;
+        roles?: string | null;
+        workspace?: string | null;
+    }) => void;
+    /** 同步 flush：写全部脏文件（dispose 最终落盘用）。 */
+    flushNow: () => void;
+    /** 删除群组/会话后摘除脏标记（对应文件已删/将删，flush 跳过）。 */
+    dropDirty: (targets: {
+        session?: string | null;
+        roles?: string | null;
+        workspace?: string | null;
+    }) => void;
+    /** dispose：同步最终 flush → 释放锁 → 摘除句柄。 */
+    release: () => void;
+}
+/**
+ * 创建持久化面：构造即完成 store 初始化 + hydrate（v1 迁移 → 残留清理 →
+ * 清单 → 群组数据 → 会话文件；缺文件空重建；补建默认会话/群组立即落盘）。
+ */
+export declare function createPersistence(core: HostState): Persistence;