dsh-llm-codebuddy-power 1.0.0

package/lib/types/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * DeepSeek Harness 的 Tencent CodeBuddy provider 插件。
+ *
+ * 在 `ctx.llm` 上注册一条 `codebuddy` 路由,由浏览器 OAuth 登录而非 API key
+ * 授权,并提供 CodeBuddy 自己的(非 OpenAI)目录端点所报告的模型。
+ *
+ * 通过 Web 设置 → CodeBuddy 页面登录,或在终端执行
+ * `dsh plugin --profile web codebuddy-power`。无需 API key,运行中的 harness
+ * 无需重启即可取得该凭据。
+ *
+ * @module dsh-llm-codebuddy-power
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { CodeBuddyConnectionOptions } from './adapter.ts';
+import type { CodeBuddyPrefs, CodeBuddyPrefsConfig } from './prefs.ts';
+export { CodeBuddyAdapter, httpErrorCode } from './adapter.ts';
+export type { CodeBuddyAdapterOptions, CodeBuddyConnectionOptions } from './adapter.ts';
+export { CodeBuddyAuthService, CODEBUDDY_AUTH_CHANNEL } from './auth-service.ts';
+export type { CodeBuddyAccountsResult, CodeBuddyLoginStart, CodeBuddyLoginPoll, CodeBuddySessionAccount, CodeBuddyUsageResult, CodeBuddyUsageWindow, } from './auth-service.ts';
+export { CodeBuddySession, NotLoggedInError } from './session.ts';
+export type { CodeBuddyAccountInfo, TurnCreditAccount, TurnCreditAccountView, TurnCreditRecord, TurnCreditRecordView, } from './session.ts';
+export { login } from './login.ts';
+export type { LoginHooks, LoginResult } from './login.ts';
+export { getStoragePath, loadStorage, removeAccounts, setDefaultAccount, setLastAccount, updateStorage, upsertAccount, } from './storage.ts';
+export type { CodeBuddyStorage, CodeBuddyStoredAccount } from './storage.ts';
+export { loadSessionInfo, updateSessionInfo } from './session-store.ts';
+export type { SessionAccountRef, SessionInfo } from './session-store.ts';
+export { fetchUsage, fetchPersonalUsage, fetchEnterpriseUsage, parseUsage } from './usage.ts';
+export type { UsageSnapshot, UsageWindow } from './usage.ts';
+export * from './constants.ts';
+export { BLOCKED_MODEL_IDS, hasDisclosedCapacity, isBlockedModelId } from './types.ts';
+export type * from './types.ts';
+/** Cordis 插件名。 */
+export declare const name = "llm-codebuddy-power";
+/**
+ * 本插件的激活服务。`llm` 承载适配器路由,`tools` 接受文生图工具注册,
+ * `agents` 用于极简模式会话中按 agent 限制画图工具可见性。生成图片经
+ * 标准附件通道(attachments.saveImage + uiConversation.imageUrl)持久化与
+ * 展示,工具注册在附件服务挂载后(`ctx.inject(['attachments'])`)。
+ */
+export declare const inject: string[];
+/**
+ * 插件配置。每个字段都是可选的:内置默认值直达公开的 CodeBuddy 服务,且按
+ * 设计完全没有凭据字段 → 唯一的进入方式是浏览器登录。
+ *
+ * 界面偏好字段(`CodeBuddyPrefsConfig`)是设置命名空间的 base 层:用户在 Web
+ * 设置页的写入存在 harness 的用户设置文档里并覆盖它们。
+ */
+export interface Config extends CodeBuddyPrefsConfig {
+    /** Chat 端点基址;默认为 CodeBuddy 的 OpenAI 兼容路由。 */
+    baseURL?: string;
+    /** 目录未给出规模的模型的上下文容量。 */
+    defaultContextWindow?: number;
+    /** 目录未给出上限的模型的单次请求输出上限。 */
+    defaultMaxTokens?: number;
+    /** 单次流读取尚未完成时 provider 的最大空闲时间。 */
+    streamIdleTimeoutMs?: number;
+}
+/**
+ * 校验并补全原始配置。
+ *
+ * 编程式构造可以绕过任何 schema,因此边界在此判定,坏值在加载时就带字段名
+ * 失败,而不是等到请求中途。
+ * @param config - 原始入口配置。
+ * @returns 解析出的连接事实。
+ */
+export declare function resolveConnectionOptions(config?: Config): CodeBuddyConnectionOptions;
+/**
+ * 解析界面偏好的部署级 base 层。用户设置文档中的写入覆盖它。
+ *
+ * 与 {@link resolveConnectionOptions} 同理,编程式构造可以绕过任何 schema,
+ * 因此坏值在此判定并在加载时失败。
+ * @param config - 原始入口配置。
+ * @returns 设置命名空间的 base 值。
+ */
+export declare function resolvePrefsBase(config?: Config): CodeBuddyPrefs;
+/** 挂载插件:解析配置,然后注册路由。 */
+export declare function apply(ctx: Context, config?: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/login.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 浏览器 OAuth 登录流程,从发起到凭据落盘。
+ *
+ * 全程不索取 API key:握手生成一个 `state`,用户在普通浏览器中
+ * 登录,然后依据该 state 从服务轮询取出令牌。用户需要做的
+ * 只是在一个登录页面上点击完成。
+ *
+ * @module dsh-llm-codebuddy-power/login
+ */
+import type { Account, AuthToken } from './types.ts';
+import type { CodeBuddyStoredAccount } from './storage.ts';
+/** 一次完成的登录所产生的结果。 */
+export interface LoginResult {
+    account: CodeBuddyStoredAccount;
+    nickname: string;
+}
+/**
+ * 由刚签发的令牌与账号信息构建一个可持久化的账号条目。
+ *
+ * CLI 流程与 Web 认证服务共用,以免两者在存储结构上
+ * 产生分歧:两者写入的都是这个对象。
+ * @param token - 浏览器登录完成后签发的令牌。
+ * @param account - 令牌所对应的已登录账号。
+ * @returns 要持久化的账号条目。
+ */
+export declare function buildAccount(token: AuthToken, account: Account): CodeBuddyStoredAccount;
+/** 调用方提供的钩子,用于驱动流程中的用户交互。 */
+export interface LoginHooks {
+    /** 以用户必须打开的 URL 调用。 */
+    onUrl?: (url: string) => void;
+    /** 是否尝试自动打开浏览器。 */
+    openBrowser?: boolean;
+}
+/**
+ * 运行完整的浏览器登录流程。
+ * @param hooks - 用户交互钩子。
+ * @param signal - 可选取消。
+ * @returns 已追加到账号列表的账号与已登录昵称。
+ * @throws Error 握手失败、用户未及时完成,或
+ *   账号无法读取时。
+ */
+export declare function login(hooks?: LoginHooks, signal?: AbortSignal): Promise<LoginResult>;
+//# sourceMappingURL=login.d.ts.map

package/lib/types/model-enrich.d.ts

@@ -0,0 +1,125 @@
+/**
+ * 客户端模型面板的模型增强：推广/等级解析、按模型的覆盖值存储，以及
+ * RPC 安全的目录投影。
+ *
+ * 推广是 CodeBuddy 的定时活动（徽章 + 悬浮提示 + 可选折扣）；等级是订阅档位
+ * 徽章（"订阅优先"）。二者都是提示性的展示数据：主机解析展示事实，客户端负责
+ * 渲染。覆盖值让用户按模型限制上下文窗口 / 最大输出 token，统一存储在
+ * `$DSH_HOME/data/plugins/llm-codebuddy-power/`。
+ *
+ * @module dsh-llm-codebuddy-power/model-enrich
+ */
+import type { CodeBuddyModel, CodeBuddyModelPromotion, CodeBuddyModelTier } from './types.ts';
+/** 按模型的用户覆盖值：仅包含被显式限制的字段。 */
+export interface ModelOverrides {
+    /** 覆盖后的上下文容量（token）；缺省时取目录值。 */
+    contextWindow?: number;
+    /** 覆盖后的最大输出 token；缺省时取目录值。 */
+    maxOutputTokens?: number;
+}
+/** 覆盖值表：model id → 用户限制。 */
+export type ModelOverrideTable = Record<string, ModelOverrides>;
+/** 加载覆盖值表；文件缺失或损坏时按空表处理（丢失用户限制是安全的）。 */
+export declare function loadOverrides(): Promise<ModelOverrideTable>;
+/** 原子地持久化整张覆盖值表（读-改-写由调用方负责）。 */
+export declare function saveOverrides(table: ModelOverrideTable): Promise<void>;
+/** 面向客户端的单个生效推广的展示事实。 */
+export interface PromotionView {
+    /** 徽章标签，例如 "错峰使用"。 */
+    label: string;
+    /** 徽章底板颜色（十六进制）。 */
+    color: string;
+    /** 折扣后的积分费率，活动带有该项时才有。 */
+    discountedCredits?: string;
+    /** "strikethrough" 列出原价与折扣；"replace" 仅显示折扣。 */
+    displayMode?: string;
+    /** 悬浮提示文案，按语言排列。 */
+    textZh?: string;
+    textEn?: string;
+    /** 提示框按钮动作，存在时才有。 */
+    action?: {
+        type?: string;
+        labelZh?: string;
+        labelEn?: string;
+    };
+}
+/** 面向客户端的模型等级展示事实。 */
+export interface TierView {
+    /** 徽章标签，例如 "订阅优先"。 */
+    label: string;
+    /** 悬浮提示文案，按语言排列。 */
+    textZh?: string;
+    textEn?: string;
+    /** 提示框按钮动作，存在时才有（升级会打开定价页）。 */
+    action?: {
+        type?: string;
+        labelZh?: string;
+        labelEn?: string;
+    };
+}
+/**
+ * 判断某个推广当前是否生效：已启用、处于绝对有效期内，且声明了每日时段时
+ * 落在匹配的每日时段内（考虑时区）。
+ * @param promotion - 待判定的推广活动。
+ * @param now - 判定时刻，epoch 毫秒。
+ * @returns 活动当前生效时为 true。
+ */
+export declare function isPromotionActive(promotion: CodeBuddyModelPromotion, now?: number): boolean;
+/**
+ * 解析某个模型最终胜出的生效推广：在 `modelIds` 覆盖该模型且当前生效的活动
+ * 中，优先级最高者胜出（CodeBuddy 自身的选择规则）。只投影展示事实。
+ * @param promotions - 全部推广活动。
+ * @param modelId - 待解析的模型。
+ * @returns 胜出活动的展示事实，没有时为 undefined。
+ */
+export declare function promotionFor(promotions: readonly CodeBuddyModelPromotion[], modelId: string, now?: number): PromotionView | undefined;
+/**
+ * 解析挂在某个模型上的等级徽章。
+ * @param tiers - 全部模型等级。
+ * @param modelId - 待解析的模型。
+ * @returns 首个匹配等级的展示事实，没有时为 undefined。
+ */
+export declare function tierFor(tiers: readonly CodeBuddyModelTier[] | undefined, modelId: string): TierView | undefined;
+/** 客户端面板中的一行增强模型。 */
+export interface EnrichedModelRow {
+    id: string;
+    name: string;
+    /** 标价积分标签，例如 "x0.79"。 */
+    credits?: string;
+    /** 胜出的生效推广的展示事实，适用时才有。 */
+    promotion?: PromotionView;
+    /** 等级徽章，该模型带有等级时才有。 */
+    tier?: TierView;
+    /** 能力事实。 */
+    supportsImages?: boolean;
+    supportsReasoning?: boolean;
+    supportsToolCall?: boolean;
+    /** 目录默认的上下文容量。 */
+    contextWindow?: number;
+    /** 目录默认的最大输出 token。 */
+    maxOutputTokens?: number;
+    /**
+     * 目录公布的上下文容量上限,不受用户覆写影响。
+     *
+     * 与 `contextWindow`(生效值)分开下发是必需的:面板既要用生效值显示与起草,
+     * 又要用目录值限制可输入的上限。若限制也用生效值,用户把上限调低一次之后,
+     * 那个较低的覆写就会成为下一次编辑的上限,再也调不回去。
+     */
+    contextWindowCap?: number;
+    /** 目录公布的最大输出上限;与 `contextWindowCap` 同理。 */
+    maxOutputTokensCap?: number;
+    /** 各语言的描述。 */
+    descriptionZh?: string;
+    descriptionEn?: string;
+}
+/**
+ * 把目录模型及其推广/等级事实投影为可安全下发给客户端的增强行。
+ * 提供 `withOverrides` 时应用按模型的用户限制。
+ * @param model - 目录模型。
+ * @param promotions - 全部推广活动（按模型逐个解析）。
+ * @param tiers - 全部模型等级。
+ * @param withOverrides - 按模型的用户限制，没有时为 undefined。
+ * @returns 增强后的行。
+ */
+export declare function enrichModel(model: CodeBuddyModel, promotions: readonly CodeBuddyModelPromotion[], tiers: readonly CodeBuddyModelTier[] | undefined, withOverrides: ModelOverrides | undefined): EnrichedModelRow;
+//# sourceMappingURL=model-enrich.d.ts.map

package/lib/types/prefs.d.ts

@@ -0,0 +1,43 @@
+/**
+ * CodeBuddy 界面偏好的命名空间契约,Host 与 Client 两面共享。
+ *
+ * 这些偏好是**插件自己的设置命名空间**里的一段:`Config` 提供部署级 base,
+ * 用户在 Web 设置页的写入落在 harness 的用户设置文档里,因此换浏览器、重启
+ * harness 后仍然生效 —— 其中「极简模式画图工具」还会被宿主读取来决定
+ * `codebuddy-draw` 对模型是否可见,存在浏览器里会让同一次部署因浏览器而异。
+ *
+ * 本文件必须保持零依赖:两面都会编译它,而 Client 面若因此引入 schemastery
+ * 就会把它打进浏览器产物(校验 schema 是宿主面的事,见 `./settings.ts`)。
+ *
+ * @module dsh-llm-codebuddy-power/prefs
+ */
+/** 本插件拥有的设置命名空间,与插件名一致。 */
+export declare const CODEBUDDY_SETTINGS_NAMESPACE = "llm-codebuddy-power";
+/** 告警百分比的下界(含)。 */
+export declare const DANGER_PCT_MIN = 1;
+/** 告警百分比的上界(含)。 */
+export declare const DANGER_PCT_MAX = 100;
+/** 本插件在用户设置文档里持久化的界面偏好。 */
+export interface CodeBuddyPrefs {
+    /** 对话输入区是否显示额度圆环。 */
+    showUsage: boolean;
+    /** 圆环填充变为告警颜色的已用百分比,取值 `DANGER_PCT_MIN`..`DANGER_PCT_MAX`。 */
+    dangerPct: number;
+    /** 极简模式(agent preset `minimal`)会话是否注入 codebuddy-draw 工具。 */
+    drawToolInMinimal: boolean;
+}
+/** 未覆盖任何一层时使用的偏好默认值。 */
+export declare const DEFAULT_CODEBUDDY_SETTINGS: CodeBuddyPrefs;
+/**
+ * 插件配置里可覆盖的偏好字段。三者都是部署级默认值,用户设置文档中的写入
+ * 覆盖它们。
+ */
+export interface CodeBuddyPrefsConfig {
+    /** 对话输入区是否显示额度圆环。 */
+    showUsage?: boolean;
+    /** 圆环填充变为告警颜色的已用百分比。 */
+    dangerPct?: number;
+    /** 极简模式会话是否注入 codebuddy-draw 工具。 */
+    drawToolInMinimal?: boolean;
+}
+//# sourceMappingURL=prefs.d.ts.map

package/lib/types/rpc-route.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 本插件私有浏览器 RPC 通道的物理 HTTP 路由持有者。
+ *
+ * `connection.rpc.handle()` 无法在功能插件中使用:它在 Connection 服务自身的
+ * Context 下注册路由,而该 Context 的 fiber 从未声明 `webServer`,因此注册会抛出
+ * `cannot get property "webServer" without inject`,通道永远无法挂载,浏览器调用
+ * 随后落到 SPA 回退(HTTP 405)。本模块改为在同时声明这两个服务的 inject fork 中,
+ * 把前缀路由直接注册到 `webServer` 上,复现 Connection 桥本应提供的同一传输契约:
+ * 先做浏览器认证,然后接收 JSON `client-request` 信封、返回 `server-response` 信封。
+ *
+ * @module dsh-llm-codebuddy-power/rpc-route
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ConnectionRpcHandler } from '@deepseek-ai/dsh-client-connection';
+/**
+ * 把一个私有 RPC 通道挂载为 Web 前缀路由。
+ *
+ * 该路由由下方的 inject fork 持有,因此卸载本插件的 fiber 时会将其移除。
+ * 不含 `webServer` 的 profile(headless)不会解析出该 fork,也就不会挂载路由。
+ * @param ctx - 插件自身的 Context,用于创建持有路由的 inject fork。
+ * @param channel - 绝对通道前缀,例如 `/codebuddy`。
+ * @param handler - 已解码的 endpoint 处理器,返回 RPC 结果信封。
+ */
+export declare function mountPrivateChannel(ctx: Context, channel: string, handler: ConnectionRpcHandler): void;
+//# sourceMappingURL=rpc-route.d.ts.map

package/lib/types/selection.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 每个会话选用的账号,以及“最后一次手动切换”的账号。
+ *
+ * 单独放在 `codebuddy-selection.json`,而不是并进凭据文件:凭据文件有两个写者
+ * (运行中的 harness 与 CLI),会话选择只有 harness 写,分开后两边不会各自基于
+ * 旧内容覆盖对方。文件里的 uid 指向已退出的账号时按“没有选择”处理 —— 兜底放在
+ * 读取侧,磁盘记录因此只增不删(与每轮积分一致);同一个 uid 账号日后重新登录
+ * 时,原来的选择会重新生效。
+ *
+ * @module dsh-llm-codebuddy-power/selection
+ */
+/** 会话选择文件的内容。 */
+export interface CodeBuddySelection {
+    /** 会话 id → 该会话显式选用的账号 uid。 */
+    sessions: Record<string, string>;
+    /** 最后一次被手动切换到的账号 uid;没有默认账号时作为兜底。 */
+    lastUid?: string;
+}
+/**
+ * 读取会话选择;文件缺失或损坏时按空内容处理。
+ * @returns 会话选择;没有任何选择时 `sessions` 为空对象。
+ */
+export declare function loadSelection(): Promise<CodeBuddySelection>;
+/**
+ * 记下一个会话选用的账号,并把它记为最后一次手动切换的账号。
+ * @param sessionId - dsh 会话 id。
+ * @param uid - 该会话要使用的账号 uid。
+ */
+export declare function selectAccount(sessionId: string, uid: string): Promise<void>;
+/**
+ * 选择文件的不透明新鲜度令牌,与 {@link storageFreshness} 同形。
+ * @returns 一个令牌;文件不存在时返回 `undefined`。
+ */
+export declare function selectionFreshness(): Promise<string | undefined>;
+//# sourceMappingURL=selection.d.ts.map

package/lib/types/serialize.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 把 harness 消息序列化为 CodeBuddy(OpenAI 兼容)chat 请求。
+ *
+ * 用户文本被拼接,助手文本成为 `content`,工具调用成为
+ * `tool_calls`,每个工具结果成为其自身的 `role: 'tool'` 消息 →
+ * harness 把工具结果放在用户消息内部,而这条 wire 路由
+ * 不接受这种形式。对于支持图像的模型,图像以 OpenAI 兼容的
+ * `image_url` 部件(`data:<type>;base64,...`)出现在用户或工具 content
+ * 数组中,与官方 CLI 的发送方式完全一致。工具结果的图只对 `read_image`
+ * 这类"看图"工具发送,生成图工具的结果仍走纯文本信封。
+ *
+ * @module dsh-llm-codebuddy-power/serialize
+ */
+import type { GenerateOptions, Message } from '@deepseek-ai/dsh-llm';
+import type { RequestImageAttachment } from '@deepseek-ai/dsh-attachment';
+import type { WireMessage, WireRequest } from './types.ts';
+/** 请求中每个图像已解析的请求版本,以 attachment id 为键。 */
+export type RequestImages = ReadonlyMap<RequestImageAttachment['attachment']['attachmentId'], RequestImageAttachment>;
+/**
+ * 按顺序序列化整个对话。
+ * @param messages - harness 会话。
+ * @param supportsImages - 所选模型是否声明支持图像输入。
+ * @param images - 请求中每个图像已解析的请求版本。
+ * @returns wire 消息,每个工具结果展开为独立条目。
+ */
+export declare function serializeMessages(messages: readonly Message[], supportsImages: boolean, images?: RequestImages): WireMessage[];
+/**
+ * 构建 chat-completions 请求体。始终流式并上报 usage;
+ * 缺省的选项被省略而非以 null 发送,以便应用
+ * 提供方自身的默认值。
+ * @param options - 组装好的 harness 请求。
+ * @param supportsImages - 所选模型是否声明支持图像输入。
+ * @param images - 请求中每个图像已解析的请求版本。
+ * @returns 请求体。
+ */
+export declare function serializeRequest(options: GenerateOptions, supportsImages: boolean, images?: RequestImages): WireRequest;
+//# sourceMappingURL=serialize.d.ts.map

package/lib/types/session-store.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 插件自有的会话信息持久化:按会话一个文件,存该会话选用的账号、用过的账号表与
+ * 每轮消耗的积分。
+ *
+ * 这三件事都是"这个会话自己的事实",因此放在同一个文件里
+ * (`$DSH_HOME/data/plugins/llm-codebuddy-power/sessions/<会话id>.json`):读一次
+ * 就拿到它们,也不会出现两份记录各自指向不同账号。文件是纯增量记录 —— 缺文件等价于
+ * "没选过账号、没有积分"。写入是读-改-写的原子替换,并经 [atomic-file.ts](./atomic-file.ts)
+ * 按路径串行化:一轮里画图与聊天会各自累加一次积分,分开读-改-写会丢掉其中一次。
+ *
+ * 文件只增不删:会话被销毁(一次性子代理跑完即如此)不等于用户删除了会话。
+ *
+ * **账号在表里存一次,每轮记录只引用它的序号**:同一个账号会在几十轮里反复出现,逐轮
+ * 内联昵称是同一份事实的重复副本 —— 实测这让文件大了近一倍。键是文件内部自己编的序号
+ * 而不是 uid 的任何截断:一个只在本文件里做引用的键不必携带 uid 的信息,截断反而会
+ * 让两个同前缀的账号共用一条记录(把历史轮次张冠李戴),而序号不可能重复。
+ *
+ * 排版也在这里决定:`credits` 每条一行、`accounts` 每条一行,其余保持缩进。逐条一行
+ * 让追加一轮只改动两行,而整个文件一行虽然更小,却让文件不可读、改动无法辨别。
+ *
+ * @module dsh-llm-codebuddy-power/session-store
+ */
+import type { TurnCreditRecord } from './session.ts';
+/** 账号表里一个账号的两个事实:完整 uid 与昵称。 */
+export interface SessionAccountRef {
+    uid: string;
+    nick: string;
+}
+/** 一个会话的持久化信息。 */
+export interface SessionInfo {
+    /** 该会话选用的账号 uid;未选用时缺省,按默认账号解析。 */
+    uid?: string;
+    /** 本会话用过的账号,以文件内部序号为键;每轮记录里的账号引用指向这里。 */
+    accounts: Record<string, SessionAccountRef>;
+    /** 每轮消耗的积分,按轮次号索引。 */
+    credits: Record<string, TurnCreditRecord>;
+}
+/**
+ * 账号在账号表里的序号。
+ *
+ * 序号从 0 起、按首次用到该账号的顺序分配,并保留在表里 —— 记录引用的是序号,因此
+ * 序号不能随表内增删而改变,否则已有轮次会指向别的账号。
+ * @param table - 当前的账号表。
+ * @param uid - 要引用的账号 uid。
+ * @returns 该账号的序号;从未用过时是下一个未占用的序号。
+ */
+export declare function accountKeyFor(table: Record<string, SessionAccountRef>, uid: string): string;
+/**
+ * 读取一个会话的信息。
+ * @param sessionId - dsh 会话 id。
+ * @returns 该会话选用的账号、用过的账号表与积分记录;缺文件或损坏时返回空信息。
+ */
+export declare function loadSessionInfo(sessionId: string): Promise<SessionInfo>;
+/**
+ * 读-改-写一个会话的信息(原子替换,文件不存在则新建)。
+ *
+ * 读发生在队列内部,因此排队中的后一次改动看得到前一次的结果,而不是各自基于同一份
+ * 旧内容。文件此刻不可读时按空信息起手,与 {@link loadSessionInfo} 对同一情况的判断一致。
+ * @param sessionId - dsh 会话 id。
+ * @param change - 由当前信息算出新信息;不得就地修改传入值。
+ */
+export declare function updateSessionInfo(sessionId: string, change: (current: SessionInfo) => SessionInfo): Promise<void>;
+//# sourceMappingURL=session-store.d.ts.map