@dsh-workbench/core 0.3.9 → 0.3.11

package/dist/types/app/client.d.ts

@@ -9,7 +9,7 @@ import * as capabilityGateModule from '../shared/hooks/use-capability-gate';
 import * as unitBoardModule from '../shared/hooks/use-unit-board';
 import * as visibleBusyModule from '../shared/hooks/use-visible-busy';
 import * as blockerStateModule from '../shared/components/BlockerState';
-import { ActivityAction, ActivityBlock, ActivityLine, ApprovalDetail, ApprovalPlan, Card, CardAnchor, CardBoundary, CardHead, CenteredState, ChoiceGroup, ConfirmBar, EmptyState, Field, Form, FormActions, FormRow, FormRows, IconBrandMark, IconConversation, IconModuleMark, IconNpm, IconOpencli, IconPanelScreen, Link, LongTaskRow, longTaskIsLive, Note, Row, Rows, SaveBar, SelectField, SettingsSection, SkeletonRows, Spinner, Stack, StateBlock, TextField, apiGet, apiPost, blockerOfCapability, blockerOfError, cardIdOf, cx, defaultSelectFilter, duplicateKeysOf, errorReasonOf, excerpt, filterSelectOptions, firstProblemOf, formFirstProblemOf, formValuesOf, holdBusy, parseJsonLoose, parseLocalTimestamp, readText, relativeTime, relativeTimeAgo, relativeTimeBucket, relativeTimeCompact, revealFirstProblem, searchTextOf, selectCursorValue, selectEntries, shortenPath, stepSelectCursor, writeText } from '@dsh-workbench/shared';
+import { ActivityAction, ActivityBlock, ActivityLine, ApprovalDetail, ApprovalPlan, Card, CardAnchor, CardBoundary, CardHead, CenteredState, ChoiceGroup, ConfirmBar, EmptyState, Field, Form, FormActions, FormRow, FormRows, IconBrandMark, IconConversation, IconModuleMark, IconNpm, IconOpencli, IconPanelScreen, Link, LongTaskRow, longTaskIsLive, Note, Row, Rows, SaveBar, SelectField, SettingsSection, SkeletonRows, Spinner, Stack, StateBlock, TextField, apiGet, apiPost, blockerOfCapability, blockerOfError, cardIdOf, cx, defaultSelectFilter, duplicateKeysOf, errorReasonOf, excerpt, factOfRoute, filterSelectOptions, firstProblemOf, formFirstProblemOf, formValuesOf, holdBusy, parseJsonLoose, parseLocalTimestamp, readText, relativeTime, relativeTimeAgo, relativeTimeBucket, relativeTimeCompact, revealFirstProblem, searchTextOf, selectCursorValue, selectEntries, shortenPath, stepSelectCursor, writeText } from '@dsh-workbench/shared';
 export declare const kit: {
     hooks: {
         heldPhase(phase: visibleBusyModule.HeldPhase, refreshing: boolean): visibleBusyModule.HeldPhase;
@@ -100,6 +100,7 @@ export declare const kit: {
         CONTEXT_SOURCE: "workbench";
         apiGet: typeof apiGet;
         apiPost: typeof apiPost;
+        factOfRoute: typeof factOfRoute;
     };
     lib: {
         longTaskIsLive: typeof longTaskIsLive;

package/dist/types/app/layouts/env-gate/boot-gate.d.ts

@@ -19,7 +19,7 @@ export interface BootGate {
  * 拿到这一拍之后门该怎么办：`close` 撤掉放行、`hold` 停在原地等用户动手、`wait` 接着轮询。
  * 桥接坏了（`bridgeIssues` 非空）与 DIY 模式挂不起来（`diyGap` 非空）都是**不拦路**的，
  * 但那块「怎么解决」得先真的画出来 —— 停在原地 + 一颗「先进入工作台」才叫不拦路，
- * 就绪即撤等于把那块提示连同修法一起丢掉，用户进去只会发现「工作台 DIY」整个不在。
+ * 就绪即撤等于把那块提示连同修法一起丢掉，用户进去只会发现「工作台 DIY 模式」整个不在。
  */
 export declare function gateActionOf(snapshot: PreflightSnapshot): 'close' | 'hold' | 'wait';
 export declare function createBootGate(ctx: {

package/dist/types/app/layouts/market/use-module-versions.d.ts

@@ -1,18 +1,29 @@
-import type { ModuleVersion, WorkbenchVersion } from '../../../shared/api/bundle-install';
+import type { ModuleVersion, WorkbenchSelfUpdate, WorkbenchVersion } from '../../../shared/api/bundle-install';
 import type { InstalledPlugin } from '../../../shared/api/installed-plugins';
 export interface ModuleVersionsState {
     readonly modules: readonly ModuleVersion[] | null;
     readonly plugins: readonly InstalledPlugin[] | null;
     readonly workbench: WorkbenchVersion | null;
+    readonly selfUpdate: WorkbenchSelfUpdate | null;
     readonly read: boolean;
     readonly checkedAt: number | null;
 }
 export interface ModuleVersionsView extends ModuleVersionsState {
     reload(options?: {
         readonly force?: boolean;
+        readonly fresh?: boolean;
     }): void;
 }
+/**
+ * 写完之后把读数作废：这之前发出去的在飞读取即使回来也不许再发布（它读的是改之前的盘）。
+ * 每次写成功都调用一次，再配一次 `force + fresh` 的读。
+ */
+export declare function bumpModuleVersionsEpoch(): void;
 export declare function moduleVersionsValue(): ModuleVersionsState;
+/**
+ * 清掉这份读数（夹具与判据用）：状态、订阅者、在飞读取与代际一起归零。
+ */
+export declare function resetModuleVersions(): void;
 export declare function subscribeModuleVersions(listener: () => void): () => void;
-export declare function runModuleVersionsRead(force?: boolean): Promise<void>;
+export declare function runModuleVersionsRead(force?: boolean, fresh?: boolean): Promise<void>;
 export declare function useModuleVersions(): ModuleVersionsView;

package/dist/types/app/layouts/rightbar/MarketView.d.ts

@@ -6,23 +6,26 @@ import type { InstalledPlugin } from '../../../shared/api/installed-plugins';
 import { type InstalledWorkbenchModule } from './market-rows';
 import type { MarketMock } from './market-mock';
 import type { ModuleUpdateMap } from './market-rows';
-import type { WorkbenchVersion } from '../../../shared/api/bundle-install';
+import type { WorkbenchSelfUpdate, WorkbenchVersion } from '../../../shared/api/bundle-install';
 export interface MarketViewProps {
     readonly t: Translate;
     readonly manifests: readonly UnitManifest[];
     readonly installable?: ReadonlySet<string> | null | undefined;
     readonly capabilities: CapabilityMap | null;
     readonly freshness: MarketFreshness;
-    readonly onChanged: () => void;
+    readonly onChanged: (options?: {
+        readonly force?: boolean;
+    }) => void;
     readonly onPending?: ((pending: boolean) => void) | undefined;
     readonly updates?: ModuleUpdateMap | undefined;
     readonly installed?: readonly InstalledWorkbenchModule[] | undefined;
     readonly installedRead?: boolean | undefined;
     readonly workbench?: WorkbenchVersion | null | undefined;
+    readonly selfUpdate?: WorkbenchSelfUpdate | null | undefined;
     readonly plugins?: readonly InstalledPlugin[] | null | undefined;
     readonly settling?: ReadonlySet<string> | undefined;
     readonly mock?: MarketMock | undefined;
     readonly defaults?: readonly string[] | undefined;
     readonly changed?: Readonly<Record<string, number>> | undefined;
 }
-export declare function MarketView({ t, manifests, installable, capabilities, freshness, onChanged, onPending, updates, installed, installedRead, workbench, plugins, settling, mock, defaults, changed, }: MarketViewProps): JSX.Element;
+export declare function MarketView({ t, manifests, installable, capabilities, freshness, onChanged, onPending, updates, installed, installedRead, workbench, selfUpdate, plugins, settling, mock, defaults, changed, }: MarketViewProps): JSX.Element;

package/dist/types/app/layouts/rightbar/market-act.d.ts

@@ -12,11 +12,14 @@ export interface MarketActSeats {
     } | null) => void;
     readonly setNotice: (next: string | null) => void;
 }
-export declare function marketActOf(options: {
+export interface MarketActOptions {
     readonly t: Translate;
     readonly mocked: boolean;
     readonly rowOf: (id: string) => MarketRow | undefined;
     readonly seats: MarketActSeats;
     readonly send: (body: Record<string, unknown>) => Promise<WriteOutcome<unknown>>;
-    readonly onChanged: () => void;
-}): (id: string, action: MarketRowAction) => Promise<void>;
+    readonly onChanged: (options?: {
+        readonly force?: boolean;
+    }) => void;
+}
+export declare function marketActOf(options: MarketActOptions): (id: string, action: MarketRowAction) => Promise<void>;

package/dist/types/app/layouts/rightbar/market-rows.d.ts

@@ -5,7 +5,7 @@ import type { SharedRow } from './market-shared-rows';
 import type { CapabilityMap } from '../../../shared/hooks/use-capabilities';
 export type { MarketHintKey, MarketNote, MarketRow, MarketRowAction, MarketState, ModuleUpdate, } from './market-row-types';
 export type { SharedRow, SharedState } from './market-shared-rows';
-export { SHARED_DOT, SHARED_STATE_KEY, sharedActions, sharedRows } from './market-shared-rows';
+export { SHARED_STATE_KEY, sharedActions, sharedRows } from './market-shared-rows';
 export declare const MARKET_STATE_KEY: Readonly<Record<MarketState, string>>;
 export declare const MARKET_DOT: Readonly<Record<MarketState, 'ongoing' | 'done' | 'warning' | 'idle' | 'error'>>;
 export type ModuleUpdateMap = Readonly<Record<string, ModuleUpdate>>;

package/dist/types/app/layouts/rightbar/market-settle-hold.d.ts

@@ -1,10 +1,12 @@
 import type { Translate } from '@dsh-workbench/shared';
+import type { WorkbenchSelfUpdate } from '../../../shared/api/bundle-install';
 import type { Pending } from './market-view-text';
 export declare function useSettleHold(input: {
     readonly pending: Pending | null;
     readonly landed: boolean;
     readonly t: Translate;
     readonly onChanged: () => void;
+    readonly selfUpdate?: WorkbenchSelfUpdate | null | undefined;
     readonly setPending: (next: Pending | null) => void;
     readonly setFailed: (next: {
         readonly id: string;

package/dist/types/app/layouts/rightbar/market-settle.d.ts

@@ -1,4 +1,6 @@
+import type { WorkbenchSelfUpdate } from '../../../shared/api/bundle-install';
 import type { MarketRowAction, ModuleUpdate } from './market-row-types';
+import type { SharedState } from './market-shared-rows';
 export declare const MODULE_SETTLE_MS = 15000;
 export declare function holdBack(installed: readonly string[], roster: ReadonlySet<string>, active: ReadonlySet<string>, previous: ReadonlySet<string> | null): readonly string[];
 export declare const WORKBENCH_SWAP_MS = 180000;
@@ -20,5 +22,23 @@ export declare function settleLanded(input: {
     readonly entry: ModuleUpdate | undefined;
     readonly clicked: string | undefined;
     readonly outdated: boolean;
+    readonly sharedState?: SharedState | undefined;
+    readonly pluginOutdated?: boolean | null | undefined;
 }): boolean;
+export interface SelfUpdateStop {
+    readonly kind: 'failed' | 'rolled-back';
+    readonly reason?: string;
+    readonly version?: string;
+}
+/**
+ * 工作台自更新是不是已经由外面那个进程判死了：`failed` / `rolled-back` 都算收尾，
+ * 不必再等盘上版本追上来（最多 3 分钟的等待里用户不该一直看「正在更新」）。
+ * `since` 是点下去那一刻（毫秒），marker 比它早太多说明是上一次的现场，不算。
+ * @returns `undefined` = 还在跑或没有现场；否则 `kind` 与日志尾里最后一句原因。
+ */
+export declare function selfUpdateStop(input: {
+    readonly until: string | undefined;
+    readonly since: number | undefined;
+    readonly update: WorkbenchSelfUpdate | null | undefined;
+}): SelfUpdateStop | undefined;
 export declare function holdWindowMs(until: string | undefined): number;

package/dist/types/app/layouts/rightbar/market-shared-rows.d.ts

@@ -3,7 +3,6 @@ import type { CapabilityMap } from '../../../shared/hooks/use-capabilities';
 import type { MarketRowAction } from './market-row-types';
 export type SharedState = 'checking' | 'installed' | 'outdated' | 'unsatisfied' | 'missing' | 'unchecked';
 export declare const SHARED_STATE_KEY: Readonly<Record<SharedState, string>>;
-export declare const SHARED_DOT: Readonly<Record<SharedState, 'ongoing' | 'done' | 'warning' | 'idle'>>;
 export interface SharedRow {
     readonly id: string;
     readonly kind: 'plugin' | 'lib';

package/dist/types/app/layouts/rightbar/market-update-verdict.d.ts

@@ -0,0 +1,41 @@
+import type { Translate } from '@dsh-workbench/shared';
+import type { BundleChange } from '../../../shared/api/bundle-install';
+import type { MarketRowAction } from './market-row-types';
+export interface UpdatedModule {
+    readonly kind?: string;
+    readonly pkg?: string;
+    readonly version?: string;
+}
+export type UpdateVerdict = {
+    readonly kind: 'ok';
+} | {
+    readonly kind: 'no-change';
+} | {
+    readonly kind: 'gone';
+    readonly restored?: string;
+} | {
+    readonly kind: 'behind';
+    readonly installed: string;
+};
+/**
+ * 更新那一拍到底算不算成了：只认**盘上这一版**，不认 `applied` 这个字。
+ * `no-change` = 点下去那版和盘上一样；`gone` = 跑完读不到模块（`restored` 是回滚成功的版本）；
+ * `behind` = 版本动了但没到源上最新。`ok` 之外都要给用户一句失败原因。
+ * @param input.clicked 点下去那一刻盘上的版本；`latest` 当时源上最新那一版。
+ */
+export declare function updateVerdictOf(input: {
+    readonly action: MarketRowAction;
+    readonly change: BundleChange | undefined;
+    readonly module: UpdatedModule | undefined;
+    readonly restored?: string | undefined;
+    readonly clicked?: string | undefined;
+    readonly latest?: string | undefined;
+}): UpdateVerdict;
+/**
+ * 把判死的更新结果翻成那一行底下的一句人话；`ok` 给 `undefined`。
+ * @param input.from 点下去那版（`no-change` 要说清"还是它"）。
+ */
+export declare function updateVerdictText(verdict: UpdateVerdict, t: Translate, input: {
+    readonly from?: string | undefined;
+    readonly latest?: string | undefined;
+}): string | undefined;

package/dist/types/app/layouts/rightbar/market-view-text.d.ts

@@ -1,6 +1,7 @@
 import type { UnitManifest } from '@dsh-workbench/shared';
 import type { CapabilityMap } from '../../../shared/hooks/use-capabilities';
 import type { MarketRow, MarketRowAction, ModuleUpdateMap } from './market-rows';
+import type { SharedRow } from './market-shared-rows';
 export declare const PROGRESS_KEY: Readonly<Record<MarketRowAction, string>>;
 export declare const ACTION_LABEL_KEY: Readonly<Record<MarketRowAction, string>>;
 export interface HeldRow {
@@ -14,12 +15,14 @@ export interface Pending {
     readonly label?: string | undefined;
     readonly pkg?: string | undefined;
     readonly version?: string | undefined;
+    readonly latest?: string | undefined;
+    readonly since?: number | undefined;
     readonly row?: MarketRow | undefined;
     readonly until?: string | undefined;
     readonly readBack?: boolean | undefined;
 }
 export declare function holdOf(pending: Pending | null, application: string | undefined): HeldRow | undefined;
-export declare function pendingLanded(pending: Pending | null, updates: ModuleUpdateMap, capabilities: CapabilityMap | null, installed: string | undefined): boolean;
+export declare function pendingLanded(pending: Pending | null, updates: ModuleUpdateMap, capabilities: CapabilityMap | null, installed: string | undefined, shared?: readonly SharedRow[], plugins?: readonly MarketRow[] | null): boolean;
 export declare function holdExpired(held: HeldRow | undefined, backInRoster: boolean, elapsedMs: number): boolean;
 export declare function heldIdOf(pending: Pending | null, held: HeldRow | undefined): string | null;
 export declare function pinnedRowOf(pending: Pending | null, held: HeldRow | undefined): MarketRow | undefined;

package/dist/types/app/layouts/rightbar/store.d.ts

@@ -22,6 +22,20 @@ export interface RightbarPersistence {
     readText(key: string): string | null;
     writeText(key: string, value: string | null): void;
 }
+/**
+ * 读一个布尔开关：键不存在时返回 `fallback`，只有存进去的 `'true'` 算真。
+ * 外壳自己那几个开合态用它（kit 上的 `readText` / `writeText` 是给模块的文本档）。
+ * @param key - localStorage 键。
+ * @param fallback - 没有这个键时的值。
+ * @returns 开关状态。
+ */
+export declare function readFlag(key: string, fallback: boolean): boolean;
+/**
+ * 把一个布尔开关写进 localStorage（存 `'true'` / `'false'`）；写不进去静默作罢。
+ * @param key - localStorage 键。
+ * @param value - 开关状态。
+ */
+export declare function writeFlag(key: string, value: boolean): void;
 export declare const RIGHTBAR_DEFAULT_EXPANDED = true;
 export declare const RIGHTBAR_DEFAULT_COLUMN: RightbarColumn;
 export interface RightbarColumnPressed {

package/dist/types/app/layouts/sidebar/LongTaskDot.d.ts

@@ -0,0 +1,12 @@
+import type { Translate } from '@dsh-workbench/shared';
+export interface LongTaskDotProps {
+    readonly sessionId: string;
+    readonly t: Translate;
+}
+/**
+ * 会话行前面那颗「长任务还在跑」的点；两种左栏共用同一个 `sidebar.session.row.leading` 座位。
+ * @param props.sessionId - 这一行的会话。
+ * @param props.t - 词表（只在提示里用）。
+ * @returns 有长任务时一个状态点，否则 `null`。
+ */
+export declare function LongTaskDot({ sessionId, t }: LongTaskDotProps): JSX.Element | null;

package/dist/types/app/layouts/sidebar/LongTaskHover.d.ts

@@ -0,0 +1,12 @@
+import type { Translate } from '@dsh-workbench/shared';
+export interface LongTaskHoverProps {
+    readonly sessionId: string;
+    readonly t: Translate;
+}
+/**
+ * 悬停卡里那行「长任务在跑」；两种左栏共用一个 `sidebar.session.row.hover` 座位。
+ * @param props.sessionId - 这一行的会话。
+ * @param props.t - 词表。
+ * @returns 有长任务时一行灰字，否则 `null`。
+ */
+export declare function LongTaskHover({ sessionId, t }: LongTaskHoverProps): JSX.Element | null;

package/dist/types/app/layouts/sidebar/edition-boot.d.ts

@@ -0,0 +1,24 @@
+import type { DshClientContext } from '@dsh-workbench/shared';
+import type { SidebarEdition } from '../../../shared/api/sidebar-edition';
+/**
+ * 设置项点下去之后记一笔“想切到哪一档”，刷新后据此等组合跟上；
+ * 不用它区分“刚切换”和“旧组合兜底”，否则官方档会被当成切坏了。
+ * @param edition 用户选的目标档位。
+ */
+export declare function markSidebarEditionPending(edition: SidebarEdition): void;
+/**
+ * 切自定义时先把“官方被摘掉就接管”挂上，再发写口——这样组合一生效就原地换成
+ * 我们的左栏，不必刷新，也不会出现左栏空一拍。
+ */
+export declare function armCustomSidebarTakeover(): void;
+/**
+ * 写口没成时把待接管撤掉，别在 3 秒后误刷新。
+ */
+export declare function disarmCustomSidebarTakeover(): void;
+/**
+ * 启动时按组合决定左栏：先把官方座位让出来；官方没落地才注册我们自己的。
+ * 官方 → 自定义刚写完时组合可能还没跟上，官方座位还在；这时最多自刷 2 次等它。
+ * @param ctx 客户端上下文（只读 slots）。
+ * @param registerOwn 注册工作台自己那套左栏（调用方保证幂等）。
+ */
+export declare function bootSidebarEdition(ctx: DshClientContext, registerOwn: () => void): void;

package/dist/types/app/layouts/sidebar/edition.d.ts

@@ -0,0 +1,22 @@
+import type { SidebarEdition } from '../../../shared/api/sidebar-edition';
+/**
+ * 这一屏启动时按哪一档左栏渲染；组合层决定的，改它要刷新页面。
+ * @returns 运行态档位（默认官方）。
+ */
+export declare function runtimeSidebarEdition(): SidebarEdition;
+/**
+ * 记下这一屏的左栏档位（只在启动时由客户端调用一次）。
+ * @param next 读到的档位。
+ */
+export declare function setRuntimeSidebarEdition(next: SidebarEdition): void;
+/**
+ * 订阅运行态档位的变化（目前只在启动时变一次）。
+ * @param listener 变化时的回调。
+ * @returns 取消订阅。
+ */
+export declare function subscribeSidebarEdition(listener: () => void): () => void;
+/**
+ * 组件里读运行态档位（启动后解析出来才变一次，变了会重渲染）。
+ * @returns 运行态档位。
+ */
+export declare function useRuntimeSidebarEdition(): SidebarEdition;

package/dist/types/app/layouts/workbench-settings/ConfigSyncItem.d.ts

@@ -0,0 +1,5 @@
+import type { Translate } from '@dsh-workbench/shared';
+export interface ConfigSyncItemProps {
+    readonly t: Translate;
+}
+export declare function ConfigSyncItem({ t }: ConfigSyncItemProps): JSX.Element;

package/dist/types/app/layouts/workbench-settings/SettingsItem.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from 'react';
+export interface SettingsItemProps {
+    readonly title: string;
+    readonly description?: string | undefined;
+    readonly action?: ReactNode | undefined;
+    readonly children?: ReactNode | undefined;
+}
+/**
+ * 设置一节里的一个配置项：自己的标题、一句说明、右上动作与内容。
+ * 多个配置项叠在同一节里，项与项之间由样式画分隔线。
+ * @param props.title - 这一项的名字（同时给读屏，`aria-label`）。
+ * @param props.description - 项下面那句说明；不给不占位。
+ * @param props.action - 标题右侧的动作（如"重新读一遍"）；不给不占位。
+ * @param props.children - 这一项的内容。
+ * @returns 一个 `aria-label` 为标题的 `section`。
+ */
+export declare function SettingsItem({ title, description, action, children }: SettingsItemProps): JSX.Element;

package/dist/types/app/layouts/workbench-settings/SidebarEditionItem.d.ts

@@ -0,0 +1,11 @@
+import type { Translate } from '@dsh-workbench/shared';
+export interface SidebarEditionItemProps {
+    readonly t: Translate;
+}
+/**
+ * 「工作台设置」里的「会话列表」项：选官方还是自定义左栏。
+ * 写入的是 profile patch 那一行；与当前这一屏的档位不同就提示刷新页面。
+ * @param props.t - 这一项的词表。
+ * @returns 一个配置项。
+ */
+export declare function SidebarEditionItem({ t }: SidebarEditionItemProps): JSX.Element;

package/dist/types/app/layouts/workbench-settings/WorkbenchSettingsSection.d.ts

@@ -0,0 +1,11 @@
+import type { Translate } from '@dsh-workbench/shared';
+export interface WorkbenchSettingsSectionProps {
+    readonly t: Translate;
+}
+/**
+ * 设置页里「工作台设置」这一节：工作台自己这一侧的配置都收在这里，一项一张。
+ * 现在是「会话列表」与「配置同步」两项；再加配置项时按 `SettingsItem` 的形状往下排。
+ * @param props.t - 这一节的词表。
+ * @returns 设置页的一节。
+ */
+export declare function WorkbenchSettingsSection({ t }: WorkbenchSettingsSectionProps): JSX.Element;

package/dist/types/modules/panels/model/approval.d.ts

@@ -1,10 +1,18 @@
-import type { ApprovalPolicy } from '@dsh-workbench/shared/host';
+import type { ApprovalPolicy, RecordState } from '@dsh-workbench/shared/host';
 import type { LongTaskRunsLookup } from './long-task-tools';
+/**
+ * 面板族不带现场的那份策略：只按调用本身判（长任务按"别人的"问、录制一律问）。
+ * 要它认现场（这一趟是谁起的、此刻有没有活着的录制）就用 `panelsApprovalFor`。
+ */
 export declare const panelsApproval: ApprovalPolicy;
 /**
- * 面板族的审批策略：`panelsApproval` 再认长任务那一档（写成功要用户点头）。
+ * 面板族的审批策略：`panelsApproval` 再认两档现场 —— 长任务那一档（别人的写要用户点头）与
+ * 录制那一档（已经活着的一场录制：再 prepare 一定当场失败，连问都不问）。
  * `longTaskRuns` 用来查"这一趟是谁起的" —— 自己起的免问，别的会话起的 / 用户按的要问。
+ * `recording` 返回此刻活着的录制约定（没有就 `null`）：活着时 `record_prepare` 回 `deny`（理由 = 处理函数
+ * 会回的那句"另一场还占着 / 你已持有一场"），因为那一拍占不到屏、问了也白问。
  * @param longTaskRuns 当前挂着的单元各自那把长任务注册表；没给就按"别人的"问（保守的那一侧）。
- * @returns 审批策略：认领的写工具回 ask / allow，不是本族的回 undefined。
+ * @param recording 活着的录制约定取值器；没给就照旧问（老外壳 / 老套件的那一侧）。
+ * @returns 审批策略：认领的写工具回 ask / allow / deny，不是本族的回 undefined。
  */
-export declare function panelsApprovalFor(longTaskRuns?: LongTaskRunsLookup | undefined): ApprovalPolicy;
+export declare function panelsApprovalFor(longTaskRuns?: LongTaskRunsLookup | undefined, recording?: (() => RecordState | null) | undefined): ApprovalPolicy;

package/dist/types/modules/panels/model/diy-browser-tools.d.ts

@@ -34,6 +34,6 @@ export declare function clipNote(clip: PngClip, viewport: {
     readonly width: number;
     readonly height: number;
 }): string;
-export declare function defaultShotPath(packagesDir: string, unit: string, stamp: number): string;
+export declare function defaultShotPath(dir: string, unit: string, stamp: number): string;
 export declare const BROWSER_TOOLS: readonly BrowserToolRow[];
 export declare function registerBrowserTools(ctx: DshHostContext, tools: DshToolRegistry): readonly (() => void)[];

package/dist/types/modules/panels/model/diy-context.d.ts

@@ -7,7 +7,7 @@ export declare const OUTPUT_SCHEMA: {
         text: {
             type: string;
         };
-        workshop: {
+        workspace: {
             type: string;
         };
         modules: {
@@ -44,7 +44,7 @@ export declare const OUTPUT: {
             text: {
                 type: string;
             };
-            workshop: {
+            workspace: {
                 type: string;
             };
             modules: {
@@ -89,22 +89,39 @@ export declare function showOrReason(panels: PanelsService, unit: string, worksp
     readonly reason?: string;
 };
 /**
- * 这一次 DIY 调用落在哪个工坊上：**先认工坊自己的家**（`$DSH_HOME/workbench/diy`，宿主就是按它把工坊
- * 登记成工作区的），**不跟着会话 cwd 走** —— 用户把自己的项目设成工作区时，cwd 往上找会撞上任意一个
- * 带 `packages/` 的仓库，模块列表与 `shots/` 落点会一起变样（真机踩过：录制落点跑到仓库根、截图 EPERM）。
- * 只有拿不到工坊的家时，才退回"从会话工作区往上找像工坊的目录"。
+ * 这条会话在哪个工作区上：cwd → 登记的 workspace（开在子目录也落到工作区根）。DIY 的模块、面板、
+ * 调试与工件全跟着它 —— **不猜、不回落到工坊**。
  * @param ctx - 宿主上下文。
- * @param exec - 这次工具调用（退回那一档要读它的会话工作区）。
- * @returns 工坊的 packages 目录、根路径与标题。
+ * @param exec - 这次工具调用（读它的会话 cwd）。
+ * @returns 工作区根与标题。
  */
-export declare function workshopOf(ctx: DshHostContext, exec: DshToolRunContext): Promise<{
-    readonly packagesDir: string;
-    readonly workspace: string | null;
+export declare function workspaceOf(ctx: DshHostContext, exec: DshToolRunContext): Promise<{
+    readonly root: string;
     readonly title: string;
 }>;
-export declare function modulesOf(ctx: DshHostContext, packagesDir: string): {
+export interface KnownUnit {
+    readonly unit: string;
+    readonly name: string;
+    readonly description: string;
+    readonly dir: string;
+    readonly installed: boolean;
+}
+/**
+ * 这条会话能看见的单元：**装进 profile 的**（不管源码在哪）+ 这个工作区里声明了的那几个。
+ * 看板 / 调试 / 上板只认"装没装"（源码在不在本机这个工作区里是另一件事）；`dir` 空串表示
+ * 只有安装记录、这个工作区里没有它的源码。工作区是什么结构都不影响这一层。
+ * @param ctx - 宿主上下文（要 profile 服务）。
+ * @param root - 会话的登记工作区。
+ * @returns 已装 id 名单、工作区里的模块、以及两者合并后的单元表（按 unit 排序，同 id 以工作区那份为准）。
+ */
+export declare function unitsOf(ctx: DshHostContext, root: string): {
+    installed: string[];
+    modules: readonly import("@/shared/api/host/diy-modules").DiyModule[];
+    units: readonly KnownUnit[];
+};
+export declare function modulesOf(ctx: DshHostContext, root: string): {
     installed: string[];
-    modules: readonly import("@/shared/api/host/diy-workshop").WorkshopModule[];
+    modules: readonly import("@/shared/api/host/diy-modules").DiyModule[];
 };
-export declare function moduleDirsOf(packagesDir: string): readonly string[];
+export declare function moduleDirsOf(root: string): readonly string[];
 export declare function panelEntriesOf(panels: PanelsService, workspace: string | null): import("./config").PanelEntry[];

package/dist/types/modules/panels/model/diy-page.d.ts

@@ -4,7 +4,8 @@ import { type BoardFactState, type BoardProbe, type BoardSituation } from '@dsh-
 import { type WorkbenchPage } from './diy-browser';
 export type BoardState = BoardFactState;
 export interface PageHandle {
-    readonly packagesDir: string;
+    readonly root: string;
+    readonly artifactsDir: string;
     readonly unit: string;
     readonly args: Record<string, unknown>;
     readonly shell: DshShell;
@@ -17,7 +18,7 @@ export interface PageHandle {
 export interface PageOptions {
     readonly requireWorkbench?: boolean | undefined;
     readonly requireUnit?: boolean | undefined;
-    readonly requireBoard?: 'workshop' | false | undefined;
+    readonly requireBoard?: boolean | undefined;
     readonly requirePact?: boolean | undefined;
 }
 export declare function debugPausedText(held: DebugState): string;

package/dist/types/modules/panels/model/diy-record.d.ts

@@ -14,12 +14,12 @@ export declare const DETAIL_MAX_BYTES = 60000;
 export declare const pauseFor: (ms: number) => Promise<void>;
 export declare function waitOf(value: unknown): number;
 export declare function foreignDomainText(design: unknown, url: string): string;
-export declare function captureFileOf(packagesDir: string, unit: string): string;
+export declare function captureFileOf(artifactsDir: string, unit: string): string;
 export declare function lastCaptureFileOf(file: string): string;
 /**
- * 这一族自己的落图路径：跟 `rec-<unit>.jsonl` 同目录、`rec-shot-` 前缀（工坊那一页的图另有名字）。
+ * 这一族自己的落图路径：跟 `rec-<unit>.jsonl` 同目录（外壳的取证目录）、`rec-shot-` 前缀。
  * @param captureFile - 这一场捕获文件；图就落在它旁边。@param unit - 单元名。@param n - 页面「已拍」计数。
- * @returns 形如 `…/shots/rec-shot-<unit>-<n>.png` 的路径。
+ * @returns 形如 `…/artifacts/<工作区>/rec-shot-<unit>-<n>.png` 的路径。
  */
 export declare function shotFileOf(captureFile: string, unit: string, n: number): string;
 /**

package/dist/types/modules/panels/model/diy-report.d.ts

@@ -1,11 +1,11 @@
 import type { PanelUnitReport } from '@dsh-workbench/shared/host';
-import { type WorkshopModule, type WorkshopSync, type WorkshopToolchain } from '../../../shared/api/host/diy-workshop';
+import { type DiyModule, type SyncState, type Toolchain, type WorkspaceShape } from '../../../shared/api/host/diy-modules';
 export declare const SYNC_STALE_MINUTES = 15;
 export declare const SYNC_STALE_MS: number;
 export declare function syncNotice(input: {
-    readonly sync: WorkshopSync | undefined;
+    readonly sync: SyncState | undefined;
     readonly shellVersion: string | undefined;
-    readonly toolchain: WorkshopToolchain | undefined;
+    readonly toolchain: Toolchain | undefined;
     readonly now?: number;
     readonly windowMs?: number;
 }): string | undefined;
@@ -32,8 +32,7 @@ export declare function ageText(at: number, now: number): string;
 export declare function stampOf(at: number): string;
 export declare function readText(read: PanelUnitReport['cards'][number], now: number): string;
 export declare function renderPanel(options: {
-    readonly packagesDir: string;
-    readonly workspace: string | null;
+    readonly root: string;
     readonly rows: readonly {
         readonly unit: string;
         readonly name: string;
@@ -68,7 +67,7 @@ export declare function statusOf(options: {
     readonly open: boolean;
     readonly health: SuiteHealth;
 }): ModuleStatus;
-export declare function renderStatus(packagesDir: string, lines: readonly ModuleStatus[], options?: {
+export declare function renderStatus(root: string, lines: readonly ModuleStatus[], options?: {
     readonly shellVersion?: string;
 }): string;
-export declare function renderList(packagesDir: string, modules: readonly WorkshopModule[]): string;
+export declare function renderList(root: string, modules: readonly DiyModule[], shape?: WorkspaceShape): string;

package/dist/types/modules/panels/model/market-dependency-update.d.ts

@@ -0,0 +1,21 @@
+import type { UnitCapability } from '../../../shared/api/host/probe-units';
+import { type DependencyTarget, type SharedDependency } from './market-dependency';
+export interface DependencyUpdateDeps {
+    readonly command: string;
+    readonly capabilityOf: (unit: string, force?: boolean) => Promise<UnitCapability>;
+    readonly runAll: (commands: readonly {
+        readonly line: string;
+        readonly optional?: true;
+    }[]) => Promise<void>;
+    readonly snapshot: () => Promise<readonly SharedDependency[]>;
+    readonly logger?: {
+        info?(message: string): void;
+        warn?(message: string): void;
+    } | undefined;
+}
+/**
+ * 共用依赖那一行的「更新」：只跑点名的那一份，跑完**强探**声明它的每个模块；
+ * 仍落后就抛出原因（含“这一行没有可执行的更新命令”），不静默返回旧清单。
+ * @param target `findDependency` 找到的那一份（插件或库）。
+ */
+export declare function updateDependencyRow(target: DependencyTarget, deps: DependencyUpdateDeps): Promise<readonly SharedDependency[]>;

package/dist/types/modules/panels/model/market-dispatch.d.ts

@@ -20,6 +20,7 @@ export type ProvisionResult = {
     readonly change: BundleChange;
     readonly module: InstalledModule;
     readonly supply: BundleSupply;
+    readonly restored?: string;
 } | {
     readonly ok: true;
     readonly action: 'remove-bundle';

package/dist/types/modules/panels/model/market-types.d.ts

@@ -48,6 +48,7 @@ export interface BundleInstallOutcome {
     readonly module: InstalledModule;
     readonly supply: BundleSupply;
     readonly plugin?: BundleInstalledPlugin;
+    readonly restored?: string;
 }
 export interface BundleRemoveOutcome {
     readonly change: BundleChange;