@dsh-workbench/shared 0.3.3 → 0.3.5

package/src/api/dsh-client.ts

@@ -1,5 +1,8 @@
 import type { ReactNode } from 'react';
 
+/**
+ * 左栏一行的来源：dsh workspaces.list 快照里的一项，两个时间戳都是毫秒。
+ */
 export interface WorkspaceView {
   readonly workspaceId: string;
   readonly path: string;
@@ -9,12 +12,18 @@ export interface WorkspaceView {
   readonly updatedAt: number;
 }
 
+/**
+ * workspaces.list 的整份快照：可见工作区，加上归档与置顶的会话 id；外壳只读不改。
+ */
 export interface WorkspaceSnapshot {
   readonly items: readonly WorkspaceView[];
   readonly archivedSessionIds: readonly string[];
   readonly pinnedSessionIds: readonly string[];
 }
 
+/**
+ * 会话一行的来源（标题、空会话、在跑与否、被谁留住）；retainedBy 按视图名记留住它的份数，mainView 大于 0 即正被主视图占着。
+ */
 export interface SessionSummary {
   readonly id: string;
   readonly displayTitle: string;
@@ -25,10 +34,16 @@ export interface SessionSummary {
   readonly retainedBy: Readonly<Partial<Record<string, number>>>;
 }
 
+/**
+ * 会话投影里的一条子代理目录项；外壳只认 id，其余字段随 dsh 变。
+ */
 export interface SubagentCatalogEntry {
   readonly id: string;
 }
 
+/**
+ * dsh sessions.list 的快照：按 id 找会话，投影里可能挂着一串子代理目录。
+ */
 export interface SessionsSnapshot {
   readonly byId: Readonly<Record<string, SessionSummary>>;
   readonly projectionsBySession: Readonly<
@@ -36,34 +51,58 @@ export interface SessionsSnapshot {
   >;
 }
 
+/**
+ * 一个会话的三个状态位（在跑 / 有未读完成 / 等着用户交互）；字段缺省就是这一位不知道。
+ */
 export interface SessionStatus {
   readonly running?: boolean;
   readonly completionUnread?: boolean;
   readonly pendingInteraction?: { readonly kind?: string };
 }
 
+/**
+ * 会话 id 到状态位的只读表；查不到的 id 就是没有这一条状态。
+ */
 export type SessionStatusSnapshot = ReadonlyMap<string, SessionStatus>;
 
+/**
+ * dsh layout 的面板选择位；activePanelId 为 null 表示用户把面板关了。
+ */
 export interface PanelInfo {
   readonly activePanelId: string | null;
 }
 
+/**
+ * 某个插槽上注册着的一项（id、顺序、文案）；label 允许是函数，因为文案要跟语言走。
+ */
 export interface PanelEntry {
   readonly id: string;
   readonly order: number;
   readonly label: string | (() => string);
 }
 
+/**
+ * 选择器 hook 的形状（dsh 那套 useSyncExternalStore）：外壳拿它从快照里取一小块并在变更时重取。
+ */
 export type SnapshotSelectorHook<T> = <R>(selector: (state: T) => R) => R;
 
+/**
+ * 渲染 dsh 某个插槽的函数；key 定插槽，fallback 是空槽兜底，only 用来只渲染其中一个注册项。
+ */
 export type RenderSlot = (
   key: string,
   owner?: Record<string, unknown>,
   options?: { fallback?: ReactNode; hookContext?: unknown; only?: string },
 ) => ReactNode;
 
+/**
+ * 文案函数：给键（可带参数）回一句当前语言的文本；缺键时由 dsh 决定回什么，调用点不兜。
+ */
 export type Translate = (key: string, params?: Record<string, unknown>) => string;
 
+/**
+ * 往 dsh 插槽注册一项要给的参数；priority 与 order 小者靠前，inject 声明这一项要用到的作用域。
+ */
 export interface SlotRegisterOptions {
   name: string;
   priority?: number;
@@ -76,6 +115,9 @@ export interface SlotRegisterOptions {
   inject?: (scope?: unknown) => Record<string, unknown>;
 }
 
+/**
+ * dsh 的插槽服务：注册一项、注入作用域、订阅变更，以及按名取已注册项。
+ */
 export interface DshSlots {
   inject(name: string, callback: () => void | (() => void) | Iterable<() => void>): () => void;
   register(options: SlotRegisterOptions, component: unknown): () => void;
@@ -85,11 +127,17 @@ export interface DshSlots {
   onMutate?(callback: (name: string) => void): () => void;
 }
 
+/**
+ * dsh 的语言服务：按命名空间注册字典，再取回那个命名空间的文案函数。
+ */
 export interface DshLocale {
   register(namespace: string, dictionaries: Record<string, Record<string, string>>): () => void;
   bind(namespace: string): Translate;
 }
 
+/**
+ * dsh 的布局服务：选面板、开关左栏、开合右栏；右栏宽度经可选的 panels 写。
+ */
 export interface DshLayout {
   selectPanel(panelId: string | null): void;
   toggleSidebar(): void;
@@ -98,18 +146,30 @@ export interface DshLayout {
   readonly panels?: DshLayoutPanels;
 }
 
+/**
+ * layout 上那个可选的右栏宽度写口；dsh 没给这一位时右栏宽度就只是内存态。
+ */
 export interface DshLayoutPanels {
   setRightbar?(px: number): void;
 }
 
+/**
+ * 快捷键目录的口子；外壳只把它透出去，形状与内容随 dsh。
+ */
 export interface DshShortcutCatalog {
   readonly catalog: unknown;
 }
 
+/**
+ * 起一个新会话时能带的选项；目前只有 agent 预设这一项。
+ */
 export interface DshSessionStartOptions {
   readonly agentPreset?: string;
 }
 
+/**
+ * dsh 的工作区与会话动作：开工作区、开会话、起会话、挑目录。
+ */
 export interface DshUiWorkspace {
   openWorkspace(workspaceId: string): Promise<unknown>;
   openSession(sessionId: string): void;
@@ -117,17 +177,26 @@ export interface DshUiWorkspace {
   pickDirectory(): Promise<string | null>;
 }
 
+/**
+ * 工作区写口回的那点事实（新 id 或新标题）；字段都可能缺，缺了按「没写回」算。
+ */
 export interface DshWorkspaceWritten {
   readonly workspaceId?: string;
   readonly title?: string;
 }
 
+/**
+ * dsh 的工作区服务：list 是可订阅快照，create 与 rename 是写口。
+ */
 export interface DshWorkspaces {
   readonly list: DshObservable<WorkspaceSnapshot>;
   create(request: { path: string }): Promise<DshWorkspaceWritten | undefined>;
   rename(workspaceId: string, title: string): Promise<DshWorkspaceWritten>;
 }
 
+/**
+ * 往输入框插一条引用时要给的载荷：来源、引用文本、显示文案与剪贴板文本。
+ */
 export interface DshReferenceInsert {
   readonly source: string;
   readonly ref: string;
@@ -136,12 +205,18 @@ export interface DshReferenceInsert {
   readonly clipboardText: string;
 }
 
+/**
+ * 输入框里一段 token 的区间；draftRev 用来确认还是同一版草稿，插入引用时用它定位。
+ */
 export interface DshTokenSpan {
   readonly start: number;
   readonly end: number;
   readonly draftRev: number;
 }
 
+/**
+ * 某一个会话的输入框句柄；外壳借它插引用与弹提示，state 用来核对草稿版本。
+ */
 export interface DshSessionInput {
   caretSpan?: () => { start: number; end: number };
   readonly state: { getSnapshot(): { draftRev: number } | undefined };
@@ -149,6 +224,9 @@ export interface DshSessionInput {
   notify(level: 'info' | 'error', text: string): void;
 }
 
+/**
+ * 注册 @ 触发源的口子：候选由外壳现取，选中后的动作也归外壳，dsh 只负责触发。
+ */
 export interface DshInputTriggers {
   registerSource(source: {
     readonly trigger: '@';
@@ -165,10 +243,16 @@ export interface DshInputTriggers {
   }): () => void;
 }
 
+/**
+ * dsh 的对话服务；外壳只用它按会话取输入框句柄。
+ */
 export interface DshConversationService {
   readonly input: { for(actx: unknown): DshSessionInput };
 }
 
+/**
+ * 浏览器侧的会话服务：快照加按 id 取作用域；create 是可选写口，不是每个 dsh 版本都有。
+ */
 export interface DshSessionsService {
   readonly list: { getSnapshot(): SessionsSnapshot };
   scope(sessionId: string): unknown | undefined;
@@ -180,11 +264,17 @@ export interface DshSessionsService {
   }): Promise<unknown>;
 }
 
+/**
+ * dsh 侧最小的可订阅值：取当前快照加订阅变更，外壳用它接进 React。
+ */
 export interface DshObservable<T> {
   getSnapshot(): T;
   subscribe(listener: () => void): () => void;
 }
 
+/**
+ * dsh 的右栏服务：mounted 是在场与否的可订阅值，展开与开资源另走方法。
+ */
 export interface DshSidebarRight {
   readonly mounted: DshObservable<string | undefined>;
   isExpanded(): boolean;
@@ -193,6 +283,9 @@ export interface DshSidebarRight {
   openTab(kind: string, options?: unknown): void;
 }
 
+/**
+ * remote.sessions 写口：在宿主侧建会话并回会话 id。
+ */
 export interface DshSessionsRemote {
   create(request: {
     readonly workspaceId?: string;
@@ -201,10 +294,16 @@ export interface DshSessionsRemote {
   }): Promise<{ readonly sessionId: string }>;
 }
 
+/**
+ * dsh 客户端的远端写口集合；目前只有会话一家。
+ */
 export interface DshClientRemote {
   readonly sessions: DshSessionsRemote;
 }
 
+/**
+ * 客户端插件拿到的上下文：所有服务从它取，effect 注册的清理随插件卸载跑。
+ */
 export interface DshClientContext {
   get<T = unknown>(name: string): T | undefined;
   provide(name: string, value: unknown): void;

package/src/api/dsh.ts

@@ -1,14 +1,23 @@
+/**
+ * 宿主侧的日志口；info 与 warn 都可能没有，调用前要判存在。
+ */
 export interface DshLogger {
   info?(message: string): void;
   warn?(message: string): void;
 }
 
+/**
+ * 宿主 HTTP 路由拿到的请求：方法与 URL，请求体是异步可迭代的字节流。
+ */
 export interface DshRequest {
   readonly method?: string;
   readonly url?: string;
   [Symbol.asyncIterator]?(): AsyncIterator<Uint8Array>;
 }
 
+/**
+ * 宿主 HTTP 路由要写的响应：statusCode、setHeader 与 end 必备，流式那几个方法可选。
+ */
 export interface DshResponse {
   statusCode: number;
   setHeader(name: string, value: string): void;
@@ -18,32 +27,50 @@ export interface DshResponse {
   on?(event: 'close', listener: () => void): void;
 }
 
+/**
+ * 一条挂到 dsh web 服务器上的路由；kind 说明 path 是前缀还是全等匹配，handler 自己写响应。
+ */
 export interface DshWebRoute {
   readonly kind: 'prefix' | 'exact';
   readonly path: string;
   readonly handler: (req: DshRequest, res: DshResponse) => void | Promise<void>;
 }
 
+/**
+ * 宿主插件能看到的 profile 现场；dir 缺省表示 dsh 没给这个信息。
+ */
 export interface DshProfileContext {
   readonly dir?: string;
 }
 
+/**
+ * 工具声明的静态半（名字加其余关键字）；外壳只按 name 认工具。
+ */
 export interface DshToolSchema {
   readonly name: string;
   readonly [key: string]: unknown;
 }
 
+/**
+ * 系统提示词装配到一半的那份；tools 是可改的工具表，其余字段随 dsh。
+ */
 export interface DshPromptAssembly {
   readonly tools?: readonly DshToolSchema[] | undefined;
   readonly [key: string]: unknown;
 }
 
+/**
+ * 装配提示词时给判定方的现场（哪个 agent、哪个作用域）；两者都可能缺。
+ */
 export interface DshAssemblyContext {
   readonly agent?: unknown;
   readonly scope?: unknown;
   readonly [key: string]: unknown;
 }
 
+/**
+ * 宿主插件上下文：on 订阅 dsh 的钩子（提示词装配、工具执行前后、agent 生命周期），webServer 挂路由。
+ */
 export interface DshHostContext {
   on?: {
     (
@@ -107,6 +134,9 @@ export interface DshHostContext {
   readonly webServer: { register(route: DshWebRoute): () => void };
 }
 
+/**
+ * 一次 shell 执行的结果口：result() 给退出码、超时与中断标志，以及截断过的 stdout / stderr。
+ */
 export interface DshShellExecution {
   result(): Promise<{
     exitCode: number | null;
@@ -117,6 +147,9 @@ export interface DshShellExecution {
   }>;
 }
 
+/**
+ * dsh 的 shell 服务：先 resolve 出执行规格，再把它原样喂给 execute。
+ */
 export interface DshShell {
   resolve(request: {
     command: string;
@@ -129,14 +162,30 @@ export interface DshShell {
   execute(spec: unknown): Promise<DshShellExecution>;
 }
 
+/** 一条工作区记录：id、磁盘路径与显示名（登记处按路径认领 / 新建时认的就是它）。 */
+export interface DshWorkspaceRecord {
+  readonly id: string;
+  readonly path: string;
+  readonly title: string;
+}
+
+/**
+ * 宿主侧的工作区登记处：按 id 查、按路径认领、按路径新建。
+ */
 export interface DshWorkspaceRegistry {
   get(id: string): { id: string; path?: string; title?: string } | undefined;
-  resolveByPath(path: string): Promise<{ readonly id: unknown } | undefined>;
+  resolveByPath(path: string): Promise<DshWorkspaceRecord | undefined>;
   create(path: string, title?: string): Promise<{ id?: string; path?: string; title?: string } | undefined>;
 }
 
+/**
+ * 把相对路径拼成 dsh home 下的绝对路径（服务名 dshHomePath）；外壳存自己的状态用它，不自己拼 home。
+ */
 export type DshHomePath = (relative: string) => string;
 
+/**
+ * 要注册进 dsh 的一把工具：名字、描述、参数表、输出渲染与执行体。
+ */
 export interface DshToolDefinition {
   name: string;
   description: string;
@@ -148,6 +197,9 @@ export interface DshToolDefinition {
   execute(args: unknown, exec: DshToolRunContext): Promise<unknown>;
 }
 
+/**
+ * 工具执行时给的那点现场（会话 id 与 cwd）；层级都可能缺，缺了就当不知道。
+ */
 export interface DshToolRunContext {
   readonly agent?:
     | {
@@ -161,6 +213,9 @@ export interface DshToolRunContext {
     | undefined;
 }
 
+/**
+ * dsh 的工具表；register 回的清理函数负责在插件卸载时摘掉这条工具。
+ */
 export interface DshToolRegistry {
   register(definition: DshToolDefinition): () => void;
 }

package/src/api/facts.ts

@@ -1,27 +1,54 @@
+/**
+ * 宿主推来的一帧事实变更：rev 在同一纪元里单调，facts 是这一帧动过的名字。
+ */
 export interface FactFrame {
   readonly epoch?: string;
   readonly rev: number;
   readonly facts: readonly string[];
 }
 
+/**
+ * 范围查法的后缀：cmdb/* 这类名字表示「这个前缀下的一族」，不是一条事实。
+ */
 export const FACT_SCOPE_SUFFIX = '*';
 
+/**
+ * 由单元 id 拼出它那一族事实的范围名。
+ * @param unit 单元 id，不带后缀。
+ * @returns <unit>* —— 永远是范围名，不是某一条事实。
+ */
 export function unitFactScope(unit: string): string {
   return `${unit}${FACT_SCOPE_SUFFIX}`;
 }
 
+/**
+ * 判一个名字是不是范围查法，不是问这条事实存不存在。
+ * @param name 事实名或范围名。
+ * @returns 单字符 * 不算范围；只有「至少一个字符加 *」才算。
+ */
 export function isFactScope(name: string): boolean {
   return name.length > 1 && name.endsWith(FACT_SCOPE_SUFFIX);
 }
 
+/**
+ * 取范围名对应的前缀，普通事实名原样返回。
+ * @param name 事实名或范围名。
+ * @returns 去掉末尾 * 的前缀；本来不是范围就给原值。
+ */
 export function scopePrefixOf(name: string): string {
   return isFactScope(name) ? name.slice(0, -FACT_SCOPE_SUFFIX.length) : name;
 }
 
+/**
+ * 事实的来路：start 建连并按帧回调，cursor 报已收到的宿主 rev（断线重连时交给宿主）。
+ */
 export interface FactTransport {
   start(handlers: { readonly onFrame: (frame: FactFrame) => void; readonly cursor: () => number }): () => void;
 }
 
+/**
+ * 浏览器侧的事实通道：订阅、读版本、手动刷新，帧到了由它分发给订阅者。
+ */
 export interface FactChannel {
   subscribe(fact: string, listener: () => void): () => void;
   revisionOf(fact: string): number;
@@ -35,6 +62,11 @@ interface FactEntry {
   readonly listeners: Set<() => void>;
 }
 
+/**
+ * 造一条事实通道：第一次订阅时才连传输层，最后一个订阅者走掉就断开。
+ * @param options 传输层，用来连宿主。
+ * @returns 通道句柄；没记录过的事实版本给 0，refresh() 不带事实名时刷新全部并逐个通知。
+ */
 export function createFactChannel(options: { readonly transport: FactTransport }): FactChannel {
   const entries = new Map<string, FactEntry>();
   let epoch: string | null = null;
@@ -146,6 +178,11 @@ export function createFactChannel(options: { readonly transport: FactTransport }
   return channel;
 }
 
+/**
+ * 把传输层收到的原始数据读成一帧；坏数据当没收到。
+ * @param data 帧的原始数据，期望是 JSON 字符串。
+ * @returns 合法帧；不是字符串、JSON 坏了、或 rev 不是数字都给 null。
+ */
 export function parseFactFrame(data: unknown): FactFrame | null {
   if (typeof data !== 'string') return null;
   try {
@@ -161,6 +198,11 @@ export function parseFactFrame(data: unknown): FactFrame | null {
   }
 }
 
+/**
+ * 读口路由到事实名的映射，当前一对一。
+ * @param route 读口路由。
+ * @returns 该路由对应的事实名（就是路由本身）。
+ */
 export function factOfRoute(route: string): string {
   return route;
 }

package/src/api/host-write.ts

@@ -1,16 +1,29 @@
 import type { ApiResponse } from './workbench-client.js';
 
+/**
+ * 宿主写口的五条通道（偏好、动作、供给、工坊调试、工坊录制），是写路由的第一段。
+ */
 export type WriteChannel =
   | 'prefs'
   | 'actions'
   | 'provision'
-  | 'diy-debug';
+  | 'diy-debug'
+  | 'diy-record';
 
+/**
+ * 由通道与资源拼出写路由。
+ * @param channel 写通道。
+ * @param resource 该通道下的资源名。
+ * @returns 路由字符串；provision 只有一段，其余是 channel/resource。
+ */
 export function writeRoute(channel: WriteChannel, resource: string): string {
   if (channel === 'provision') return 'provision';
   return `${channel}/${resource}`;
 }
 
+/**
+ * 写通道统一的结果：成了带值，没成带一句能给人看的话（可选明细与帮助链接）。
+ */
 export type WriteOutcome<T> =
   | { readonly ok: true; readonly value: T }
   | {
@@ -20,6 +33,12 @@ export type WriteOutcome<T> =
       readonly helpUrl?: string;
     };
 
+/**
+ * 把写通道的响应翻成 WriteOutcome。
+ * @param response 写口回的响应；null 表示请求本身没成（网络断了，宿主没答）。
+ * @param networkText 拿不到任何服务端文案时兜底的那句。
+ * @returns 失败时 message 优先用服务端自己的话，没有才用响应正文或 networkText。
+ */
 export function writeOutcomeOf<T>(response: ApiResponse<T> | null, networkText: string): WriteOutcome<T> {
   if (response === null) return { ok: false, message: networkText };
   if (!response.ok) {

package/src/api/long-task.ts

@@ -1,28 +1,59 @@
+/**
+ * 一条长任务的四种态；needs-login 与 running 一样算还没结束。
+ */
 export type LongTaskStatus = 'running' | 'needs-login' | 'ok' | 'failed';
 
+/**
+ * 长任务步骤流里的一行：kind 定样式，登录那一步带 loginUrl 给用户去点。
+ */
 export interface LongTaskStep {
   readonly kind: 'start' | 'succeed' | 'fail' | 'info' | 'warn';
   readonly text: string;
   readonly loginUrl?: string | undefined;
 }
 
+/**
+ * 单元的长任务读口路由。
+ * @param unit 单元 id。
+ * @returns <unit>/runs。
+ */
 export function runsRouteOf(unit: string): string {
   return `${unit}/runs`;
 }
 
+/**
+ * 长任务读口回的载荷：一串 run，形状由模块自己定，外壳只透传。
+ */
 export interface LongTasksPayload {
   readonly runs: readonly Readonly<Record<string, unknown>>[];
 }
 
+/**
+ * 有长任务在跑时的轮询间隔（毫秒）。
+ */
 export const LONG_TASK_POLL_MS = 1500;
 
+/**
+ * 没有长任务时的轮询间隔（毫秒），比在跑那一档大一个量级。
+ */
 export const LONG_TASK_IDLE_MS = 10_000;
 
+/**
+ * 算这次该隔多久再问一次长任务。
+ * @param live 是否有在跑的长任务。
+ * @param override 调用点指定的间隔；给了就用它，不再看 live。
+ * @returns 毫秒：有活 1500，没活 10000。
+ */
 export function longTaskPollMs(live: boolean, override?: number | undefined): number {
   if (override !== undefined) return override;
   return live ? LONG_TASK_POLL_MS : LONG_TASK_IDLE_MS;
 }
 
+/**
+ * 从读口状态里取 run 列表。
+ * @param state 读口状态；value 还没到就按空算。
+ * @returns 一串 run（形状由调用点自己判），没有就给空数组。
+ */
 export function longTaskRunsOf<T>(state: {
   readonly phase?: string | undefined;
   readonly value?: LongTasksPayload | undefined;
@@ -30,6 +61,11 @@ export function longTaskRunsOf<T>(state: {
   return (state.value?.runs ?? []) as readonly T[];
 }
 
+/**
+ * 把长任务态折成状态点的那一档。
+ * @param status 长任务的四种态。
+ * @returns ongoing / done / error / idle；needs-login 也算进行中。
+ */
 export function longTaskDot(status: LongTaskStatus): 'ongoing' | 'done' | 'error' | 'idle' {
   if (status === 'ok') return 'done';
   if (status === 'failed') return 'error';

package/src/api/unit-board.ts

@@ -2,25 +2,45 @@ import type { ModuleBlocker } from './blocker.js';
 import type { CapabilityPayload } from './workbench-contract.js';
 import type { ApiError } from './workbench-client.js';
 
+/**
+ * 卡片闸的两种档：capability 按环境读数判，none 无条件放行。
+ */
 export type GateMode =
   | 'capability'
   | 'none';
 
+/**
+ * 一次放行判定的结果；gated 为假时卡片不画。
+ */
 export interface UnitGate {
   readonly gated: boolean;
 }
 
+/**
+ * 判这张卡现在能不能画。
+ * @param capability 环境读数；还没读到给 null。
+ * @param mode 闸档。
+ * @returns mode 为 none 或读数还没到都放行（先放行让它读）；读到明确不通过（ok 与 unchecked 之外）才拦。
+ */
 export function gateOf(capability: CapabilityPayload | null, mode: GateMode): UnitGate {
   if (mode === 'none') return { gated: true };
   if (capability === null) return { gated: true };
   return { gated: capability.status === 'ok' || capability.status === 'unchecked' };
 }
 
+/**
+ * 一个单元攒下的卡住态：blocker 顶掉卡片，notice 只提示；组装方产出，卡片消费。
+ */
 export interface UnitBlockers {
   readonly blocker?: ModuleBlocker;
   readonly notice?: ModuleBlocker;
 }
 
+/**
+ * 把候选卡住态分档，每档只留第一个。
+ * @param candidates 候选（可能含 undefined），按优先级从高到低给。
+ * @returns 分出的 blocker 与 notice；已经有 blocker 时不带 notice（挡住就不必再提示）。
+ */
 export function splitBlocker(candidates: readonly (ModuleBlocker | undefined)[]): UnitBlockers {
   let blocker: ModuleBlocker | undefined;
   let notice: ModuleBlocker | undefined;
@@ -38,6 +58,11 @@ export function splitBlocker(candidates: readonly (ModuleBlocker | undefined)[])
   };
 }
 
+/**
+ * 由读口错误算出「出错搭车强探」的防抖键：同一个键只自动重探一次。
+ * @param error 读口错误；undefined 表示这次没有错误。
+ * @returns 键字符串；空 code 归一到 unknown。
+ */
 export function probeKeyOf(error: ApiError | undefined): string | null {
   if (error === undefined) return null;
   return error.code === '' ? 'unknown' : error.code;