@dsh-workbench/core 0.3.11 → 1.0.0-beta.0

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

@@ -1,5 +1,5 @@
 import type { Translate } from '@dsh-workbench/shared';
-import type { BundleChange } from '../../../shared/api/bundle-install';
+import type { BundleChange } from '../../../kernel/contract/bundle-install';
 import type { MarketRowAction } from './market-row-types';
 export interface UpdatedModule {
     readonly kind?: string;
@@ -17,12 +17,6 @@ export type UpdateVerdict = {
     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;
@@ -31,10 +25,6 @@ export declare function updateVerdictOf(input: {
     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;

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

@@ -22,7 +22,11 @@ export interface Pending {
     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, shared?: readonly SharedRow[], plugins?: readonly MarketRow[] | null): boolean;
+export interface RemovalRead {
+    readonly units: ReadonlySet<string> | null;
+    readonly plugins: ReadonlySet<string> | null;
+}
+export declare function pendingLanded(pending: Pending | null, updates: ModuleUpdateMap, capabilities: CapabilityMap | null, installed: string | undefined, shared?: readonly SharedRow[], plugins?: readonly MarketRow[] | null, removal?: RemovalRead): 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/market-workbench-row.d.ts

@@ -1,4 +1,4 @@
-import type { WorkbenchVersion } from '../../../shared/api/bundle-install';
+import type { WorkbenchVersion } from '../../../kernel/contract/bundle-install';
 import type { MarketRow } from './market-row-types';
 export declare const WORKBENCH_ROW_ID = "workbench:self";
 export declare const WORKBENCH_TITLE_KEY = "panels.market.workbenchName";

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

@@ -22,19 +22,7 @@ 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;

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

@@ -3,10 +3,4 @@ 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

@@ -3,10 +3,4 @@ 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

@@ -1,24 +1,6 @@
 import type { DshClientContext } from '@dsh-workbench/shared';
-import type { SidebarEdition } from '../../../shared/api/sidebar-edition';
-/**
- * 设置项点下去之后记一笔“想切到哪一档”，刷新后据此等组合跟上；
- * 不用它区分“刚切换”和“旧组合兜底”，否则官方档会被当成切坏了。
- * @param edition 用户选的目标档位。
- */
+import type { SidebarEdition } from '../../../kernel/contract/sidebar-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

@@ -1,22 +1,5 @@
-import type { SidebarEdition } from '../../../shared/api/sidebar-edition';
-/**
- * 这一屏启动时按哪一档左栏渲染；组合层决定的，改它要刷新页面。
- * @returns 运行态档位（默认官方）。
- */
+import type { SidebarEdition } from '../../../kernel/contract/sidebar-edition';
 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/sidebar/use-attention.d.ts

@@ -15,8 +15,4 @@ export interface SidebarAttentionState {
     readonly attention: Attention;
 }
 export declare function useSidebarAttention(input: SidebarAttentionInput): SidebarAttentionState;
-/**
- * 左栏要的那份长任务归属：外壳那条读口交回「全进程还在跑的长任务」，这里折成会话侧与工作区侧。
- * @returns 两侧的归属（谁起了 / 哪个工作区里有几趟）。
- */
 export declare function useLongTaskPresence(): LongTaskPresence;

package/dist/types/app/layouts/sidebar/workshop-preset.d.ts

@@ -0,0 +1,2 @@
+import type { DshClientContext } from '@dsh-workbench/shared';
+export declare function installWorkshopPreset(ctx: DshClientContext): () => void;

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

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

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

@@ -0,0 +1,11 @@
+import type { Translate } from '@dsh-workbench/shared';
+import type { ConfigSyncRow } from '../../../kernel/contract/config-sync';
+export declare function SourceRows({ t, rows, picked, profile, assetOverwrites, onToggle, onToggleAsset, }: {
+    readonly t: Translate;
+    readonly rows: readonly ConfigSyncRow[];
+    readonly picked: readonly string[];
+    readonly profile: string;
+    readonly assetOverwrites: readonly string[];
+    readonly onToggle: (key: string, next: boolean) => void;
+    readonly onToggleAsset: (key: string, next: boolean) => void;
+}): JSX.Element;

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

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

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

@@ -5,13 +5,4 @@ export interface SettingsItemProps {
     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

@@ -2,10 +2,4 @@ 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

@@ -2,10 +2,4 @@ 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/app/units/manifests.d.ts

@@ -1,4 +1,4 @@
-import type { ClientUnitRegistry } from './registry';
+import type { ClientUnitRegistry } from '../../kernel/client/registry';
 export interface UnitManifestLoaderOptions {
     readonly subscribeFacts?: (fact: string, listener: () => void) => () => void;
 }

package/dist/types/{app/units → kernel/client}/registry.d.ts

@@ -1,6 +1,6 @@
 import type { UnitManifest } from '@dsh-workbench/shared';
 import type { BoardModule, UnitClientFace } from '@dsh-workbench/shared';
-import { type BoardRegistry } from '../layouts/rightbar/registry';
+import { type BoardRegistry } from './board-registry';
 export interface ClientUnitRefusal {
     readonly unit: string;
     readonly kind: ClientRefusalKind;

package/dist/types/kernel/contract/bundle-install.d.ts

@@ -0,0 +1,2 @@
+export { BUNDLE_REGISTRIES_ROUTE, BUNDLE_INSPECT_ROUTE, BUNDLE_REGISTRY_DEFAULT, MODULE_VERSIONS_ROUTE, SELF_UPDATE_STATES, RESTART_REASONS } from '@dsh-workbench/shared/contract/protocol/bundle-install';
+export type { BundleRegistry, BundleRegistries, BundleInspectProblem, BundleSpecKind, BundleInspectionAccepted, BundleInspectionRefused, BundleInspectionPlugin, BundleInspection, BundleRegistriesPayload, BundleInspectionPayload, BundleApplication, SelfUpdateState, WorkbenchSelfUpdate, RestartReason, BundleChangeStage, BundleFailureKind, BundlePackageResult, BundleChange, BundleInstallRequest, BundleCancellation, BundleSupplyState, BundleModulePayload, BundleSupplyPayload, BundleInstalledPlugin, BundleInstallPayload, BundleRemovePayload, BundleCancellationPayload, ModuleVersion, WorkbenchVersion, ModuleVersionsPayload } from '@dsh-workbench/shared/contract/protocol/bundle-install';

package/dist/types/kernel/contract/config-sync.d.ts

@@ -0,0 +1,2 @@
+export { CONFIG_SYNC_ROUTE, CONFIG_SYNC_RESOURCE } from '@dsh-workbench/shared/contract/protocol/config-sync';
+export type { ConfigSyncState, ConfigSyncAssetState, ConfigSyncAssetFile, ConfigSyncAsset, ConfigSyncRow, ConfigSyncProfile, ConfigSyncSnapshot, ConfigSyncApplied, ConfigSyncRequest } from '@dsh-workbench/shared/contract/protocol/config-sync';

package/dist/types/kernel/contract/diy.d.ts

@@ -0,0 +1 @@
+export { DIY_PRESET_ID, WORKSHOP_RELATIVE, WORKSHOP_TITLE, WORKSHOP_PAST_TITLES } from '@dsh-workbench/shared/contract/protocol/diy';

package/dist/types/kernel/contract/dsh-plugins.d.ts

@@ -0,0 +1,2 @@
+export { DSH_PLUGINS_ROUTE } from '@dsh-workbench/shared/contract/protocol/dsh-plugins';
+export type { DshPluginRow, DshPluginsSnapshot } from '@dsh-workbench/shared/contract/protocol/dsh-plugins';

package/dist/types/kernel/contract/index.d.ts

@@ -0,0 +1,4 @@
+export type { UnitModuleFace, UnitMountDeps, UnitMountResult } from '@dsh-workbench/shared/host';
+export type { BoardModuleProps as BoardProps, CallOverrides, DataError, DataReader, DataRequest, DataResult, RequestRecipe, UnitClientApi, UnitClientFace, } from '@dsh-workbench/shared';
+export type { DshClientContext as ClientContext, DshHostContext as HostContext } from '@dsh-workbench/shared';
+export type { UnitRegistry } from '../host/unit-registry.js';

package/dist/types/kernel/contract/long-tasks.d.ts

@@ -0,0 +1,2 @@
+export { LONG_TASKS_ROUTE } from '@dsh-workbench/shared/contract/protocol/long-tasks';
+export type { ShellLongTaskRow, ShellLongTasksPayload } from '@dsh-workbench/shared/contract/protocol/long-tasks';

package/dist/types/kernel/contract/market-index.d.ts

@@ -0,0 +1,2 @@
+export { MARKET_DISCOVER_ROUTE, MARKET_DOC_ROUTE, MARKET_INDEX_FORMAT, MARKET_INDEX_PATH, MARKET_PUBLISH_PREVIEW_ROUTE, MARKET_SOURCES_RESOURCE, MARKET_WORKBENCH_LABEL, } from '@dsh-workbench/shared/contract/protocol/market-index';
+export type { DiscoverCompat, DiscoverDoc, DiscoverDocKind, DiscoverEntry, DiscoverFilter, DiscoverInstallState, DiscoverPayload, DiscoverProblem, DiscoverSourceRow, DiscoverState, DiscoverVersionRow, IndexSourceSpec, MarketIndex, MarketIndexCategory, MarketIndexEngines, MarketIndexEntry, MarketIndexEntryMetadata, MarketIndexGitSource, MarketIndexLabel, MarketIndexMetadata, MarketIndexNpmSource, MarketIndexParse, MarketIndexProblem, MarketIndexProblemKind, MarketIndexSortKey, MarketIndexSource, MarketIndexVersion, MarketLocalizedText, MarketPublishDestination, MarketSourceConfig, MarketSourceKind, MarketSourcePolicy, MarketSourcesAction, MarketSourcesPayload, PublishChangelog, PublishPreview, } from '@dsh-workbench/shared/contract/protocol/market-index';

package/dist/types/kernel/contract/platform.d.ts

@@ -0,0 +1 @@
+export type { Deployment, HostOs, HostRuntime, ClientShell, ProfileName, SelfUpdateCli, HostCapabilities, ToolchainPlan, HostSurface, ClientCapabilities, ClientSurface } from '@dsh-workbench/shared/contract/protocol/platform';

package/dist/types/kernel/contract/preflight-wake.d.ts

@@ -0,0 +1,2 @@
+export { WAKE_BROWSER_ROUTE } from '@dsh-workbench/shared/contract/protocol/preflight-wake';
+export type { DesktopBrowserId, BrowserWakeStatus, WakeBrowserReply } from '@dsh-workbench/shared/contract/protocol/preflight-wake';

package/dist/types/kernel/contract/profile-create.d.ts

@@ -0,0 +1,2 @@
+export { PROFILE_CREATE_ROUTE, PROFILE_CREATE_RESOURCE } from '@dsh-workbench/shared/contract/protocol/profile-create';
+export type { ProfileCreateProfile, ProfileCreateSnapshot, ProfileCreateCopy, ProfileCreateRequest, ProfileCreateApplied } from '@dsh-workbench/shared/contract/protocol/profile-create';

package/dist/types/kernel/contract/sidebar-edition.d.ts

@@ -0,0 +1,2 @@
+export { SIDEBAR_EDITION_ROUTE, SIDEBAR_EDITION_RESOURCE } from '@dsh-workbench/shared/contract/protocol/sidebar-edition';
+export type { SidebarEdition, SidebarEditionSnapshot, SidebarEditionApplied, SidebarEditionRequest } from '@dsh-workbench/shared/contract/protocol/sidebar-edition';

package/dist/types/kernel/contract/unit-manifests.d.ts

@@ -0,0 +1,2 @@
+export { UNIT_MANIFESTS_ROUTE } from '@dsh-workbench/shared/contract/protocol/unit-manifests';
+export type { UnitManifestsPayload } from '@dsh-workbench/shared/contract/protocol/unit-manifests';

package/dist/types/{shared/api → kernel}/host/mount-units.d.ts

@@ -2,6 +2,7 @@ import type { DshHostContext } from '@dsh-workbench/shared';
 import type { UnitManifest } from '@dsh-workbench/shared/host';
 import { type RouteTable } from '@dsh-workbench/shared/host';
 import type { ContextRenderer, LongTaskBase, LongTaskChange, LongTaskRegistry, UnitMountDeps, UnitMountResult, UnitCall } from '@dsh-workbench/shared/host';
+import type { DataReader } from '@dsh-workbench/shared/host';
 import type { HostUnit } from './unit-registry';
 import { type UnitReadiness } from './unit-readiness';
 export declare function declaredNotesOf(plans: Iterable<{
@@ -60,7 +61,7 @@ export declare function mountUnits(units: readonly HostUnit[], deps: {
     manifests: () => readonly UnitManifest[];
     ownedUnits?: () => readonly string[];
     installable?: () => readonly string[];
-    opencliCommand?: string;
+    data?: DataReader;
     probe?: UnitMountDeps['probe'];
     store?: UnitMountDeps['store'];
     values?: UnitMountDeps['values'];

package/dist/types/modules/panels/client.d.ts

@@ -1 +1 @@
-export { ALL_TOOLS, DIY_RECORD_PREPARE_TOOL, DIY_RECORD_READ_TOOL, LONG_TASKS_STOP_TOOL } from './unit';
+export { ALL_TOOLS, DIY_PUBLISH_TOOL, DIY_RECORD_PREPARE_TOOL, DIY_RECORD_READ_TOOL, LONG_TASKS_STOP_TOOL } from './unit';

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

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

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

@@ -0,0 +1,2 @@
+import type { DshHostContext, DshToolRegistry } from '@dsh-workbench/shared';
+export declare function registerChangelogTool(ctx: DshHostContext, tools: DshToolRegistry): readonly (() => void)[];

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

@@ -1,5 +1,5 @@
 import type { DshHostContext, DshToolRunContext } from '@dsh-workbench/shared';
-import type { BundleChange } from '../../../shared/api/bundle-install';
+import type { BundleChange } from '../../../kernel/contract/bundle-install';
 import type { PanelsService } from './service';
 export declare const OUTPUT_SCHEMA: {
     type: string;
@@ -88,13 +88,6 @@ export declare function showOrReason(panels: PanelsService, unit: string, worksp
     readonly ok: boolean;
     readonly reason?: string;
 };
-/**
- * 这条会话在哪个工作区上：cwd → 登记的 workspace（开在子目录也落到工作区根）。DIY 的模块、面板、
- * 调试与工件全跟着它 —— **不猜、不回落到工坊**。
- * @param ctx - 宿主上下文。
- * @param exec - 这次工具调用（读它的会话 cwd）。
- * @returns 工作区根与标题。
- */
 export declare function workspaceOf(ctx: DshHostContext, exec: DshToolRunContext): Promise<{
     readonly root: string;
     readonly title: string;
@@ -106,14 +99,6 @@ export interface KnownUnit {
     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[];

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

@@ -28,4 +28,5 @@ export declare function debugOffBoardText(held: DebugState, situation?: BoardSit
 export declare function boardProbeOf(page: WorkbenchPage): BoardProbe;
 export declare function boardStateOf(page: WorkbenchPage, workshop: string | null): BoardState;
 export declare function boardGateText(situation: BoardSituation, unit: string, page: WorkbenchPage, title?: string): string;
+export declare function desktopPageText(page?: WorkbenchPage): string;
 export declare function pageAt(ctx: DshHostContext, exec: DshToolRunContext, raw: unknown, options?: PageOptions): Promise<PageHandle>;

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

@@ -1,20 +1,5 @@
 import type { DshShell } from '@dsh-workbench/shared';
-/**
- * 两个地址是不是"同一页"：比之前先把查询串 / 锚点 / 末尾斜杠抹掉 —— `open` 导航之后
- * 地址栏常常多一个斜杠或一串 hash，那不算开错了页。
- * @param here - 那一页现在真实所在的地址（`location.href`）。@param want - 我们要它去的地址。@returns 同一页为 `true`。
- */
 export declare function samePageOf(here: string, want: string): boolean;
-/**
- * 把录制那一页开起来，并且**确认它真的开起来了**才回来。
- *
- * 先收掉这条会话的残留（否则新页会开进上一次留下的那扇旧窗里，不顶前台、看上去"根本没弹窗"）；
- * 再 `tab new --window foreground` 开我们的页；**然后读一次 `location.href` 核实** —— 开出来是空白页
- * 或别的地址时，回落到 opencli 的 `open`（它落在会话租约那个标签上）再核一次；两次都不对就
- * `ok: false`，让调用方把这句话原样报给 agent，**不许在没开起来的页上装浮条说"已开始录制"**。
- * @param input - 这条会话的名字 / 目标地址 / 捕获文件（收残留那一拍要用）。
- * @returns `ok: false` 时 `at` 是那一页现在真实的地址（`''` = 空白页），`why` 是给 agent 看的一句话。
- */
 export declare function openRecordPage(input: {
     readonly shell: DshShell;
     readonly command: string;

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

@@ -76,7 +76,6 @@ export interface RecordReadFacts {
     readonly beatMs?: number;
 }
 export declare function renderRecordRead(input: RecordReadFacts): string;
-/** 详情那一拍的原料：入参 / 出参 / 请求头那几块原文的渲染全靠它。 */
 export interface RecordDetailFacts {
     readonly found: boolean;
     readonly where: string;
@@ -97,7 +96,6 @@ export interface RecordDetailFacts {
     readonly maxBytes: number;
     readonly note: string;
 }
-/** 把字段证据表插进详情正文：接在出参那一块之后、`请求头` 那一行（或第一条附注）之前；没有锚点就接在末尾。空串原样回。 */
 export declare function renderRecordDetail(input: RecordDetailFacts): string;
 export declare function moveOrThrow(move: RecordMove, held: RecordState | null): RecordState;
 export declare function domainOf(url: string): string;

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

@@ -6,9 +6,6 @@ export declare const OPEN_TIMEOUT_MS = 30000;
 export declare const SETTLE_MS = 2000;
 export declare const WAIT_CAP_MS: number;
 export declare const POLL_MS = 1000;
-/**
- * 捕获那一层要滤掉的 URL：静态资源（`data:` 与常见后缀）。用法 `new RegExp(...).test(url)`，命中即丢。
- */
 export declare const STATIC_URL_PATTERN = "^(data:)|(\\.(js|css|png|jpe?g|gif|svg|woff2?|ico|map|webp|mp4)(\\?|$))";
 export declare const DETAIL_MAX_BYTES = 60000;
 export declare const pauseFor: (ms: number) => Promise<void>;
@@ -16,20 +13,7 @@ export declare function waitOf(value: unknown): number;
 export declare function foreignDomainText(design: unknown, url: string): string;
 export declare function captureFileOf(artifactsDir: string, unit: string): string;
 export declare function lastCaptureFileOf(file: string): string;
-/**
- * 这一族自己的落图路径：跟 `rec-<unit>.jsonl` 同目录（外壳的取证目录）、`rec-shot-` 前缀。
- * @param captureFile - 这一场捕获文件；图就落在它旁边。@param unit - 单元名。@param n - 页面「已拍」计数。
- * @returns 形如 `…/artifacts/<工作区>/rec-shot-<unit>-<n>.png` 的路径。
- */
 export declare function shotFileOf(captureFile: string, unit: string, n: number): string;
-/**
- * 把这一张现场图落进 `shots/`：argv **只有 `screenshot <path>`，一个视口参数都不给** —— `--full-page` 走
- * `captureBeyondViewport`、`--width` / `--height` 走 `setDeviceMetricsOverride`：真机上按一下页面**看得见地闪**
- * （2026-10-21 两次报过）、还可能让填了一半的表单跳位；调试族那把平时也是这一档（先 `eval` 量盒子再本地 `clip`）。
- * 真机上这个平台整页高与视口一样（1512×698）—— `--full-page` 一点没多给，白闪。
- * @param input - 看护那一拍的依赖（shell / 命令 / 会话 / 台账）。
- * @param held - 当前那份约定（路径按它的 `unit` 拼）。@param n - 页面浮条上那个「已拍」计数。
- */
 export declare function takeShotOf(input: WatchFinishDeps, held: RecordState, n: number): Promise<void>;
 export declare function startRecordCapture(shell: DshShell, command: string, session: string, file: string): Promise<boolean>;
 export interface WatchFinishDeps {
@@ -41,16 +25,6 @@ export interface WatchFinishDeps {
     readonly url: string;
     readonly captureFile: string;
 }
-/**
- * 看护的一拍（= 一圈循环）：读数那一条 `eval` **自己在页面里最多等 `RECORD_WATCH_MS`**（浮条在他按
- * 「开始 / 截图 / 结束」时会唤醒挂在页面上的那个 waiter ⇒ 一按就回来），所以这一轮 = **恰好一条 `eval`**：
- * 命中就立刻做那一拍，没人按就照旧 3 秒一拍 —— 兜底周期一字未变。该落图就落图；认到「结束」就封口、
- * **叫醒 agent**、**关掉录制窗**、收工（关窗排在叫醒之后：关窗慢 / 失败不许拖住叫醒，失败也不抛 ——
- * 那一扇是我们为录制借来的，ADR-0064 补记）。
- * ⚠️ 读数那条**不许**改成 opencli 的 `wait xhr`：它**读一次清一次**那只捕获环（`cdp.js:346-353`），而 reaper
- * 也读同一只环才拿得到 body ⇒ 会把 `rec-<unit>.jsonl` 吃空。理由与实测见 `.scratch/diy-write-record/issues/06-doorbell.md` §1.1。
- * @param input - 看护那一拍的依赖。@returns `stop` = 这条循环可以收了；`delivered` = 这一拍叫醒过 agent。
- */
 export declare function watchFinishStepOf(input: WatchFinishDeps): Promise<{
     readonly stop: boolean;
     readonly delivered: boolean;
@@ -59,10 +33,6 @@ export interface WatchRoundOut {
     readonly stop: boolean;
     readonly delivered: boolean;
 }
-/**
- * 看护的一轮（就是 `watchFinishStepOf`，留着这个名字是给测试与调用点一个稳定的形）。
- * @param input - 看护那一拍的依赖。@returns 收不收工、有没有叫醒。
- */
 export declare function watchRoundOf(input: WatchFinishDeps): Promise<WatchRoundOut>;
 export declare function watchRecordFinish(input: WatchFinishDeps): void;
 export interface CaptureRead {

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

@@ -2,4 +2,5 @@ import type { DshHostContext } from '@dsh-workbench/shared';
 import type { DebugStore } from '@dsh-workbench/shared/host';
 import type { MarketService } from './market';
 import type { PanelsService } from './service';
+export declare const PUBLISH_TIMEOUT_MS: number;
 export declare function registerDiyTools(ctx: DshHostContext, market: MarketService, panels: PanelsService, debug: DebugStore): Array<() => void>;

package/dist/types/modules/panels/model/long-task-tools.d.ts

@@ -1,15 +1,4 @@
 import type { DshHostContext } from '@dsh-workbench/shared';
 import type { LongTaskBase, LongTaskRegistry } from '@dsh-workbench/shared/host';
-/**
- * 当前挂着的单元各自那把长任务注册表（晚绑定的取值器，形状同 `UnitMountDeps.longTaskRuns`）。
- */
 export type LongTaskRunsLookup = () => ReadonlyMap<string, LongTaskRegistry<LongTaskBase>>;
-/**
- * 注册长任务那两把外壳工具：看得见（`workbench_long_tasks_list`）与停得了任何单元的一趟
- * （`workbench_long_tasks_stop`）。`longTaskRuns` 是晚绑定的取值器：两把都从它取注册表，
- * 所以单元晚挂上 / 被摘掉都跟得上；没给的话停那把一律回"没有这一趟"。
- * @param ctx 宿主上下文，`tools` 服务不在时什么都不注册。
- * @param longTaskRuns 当前挂着的单元各自那把长任务注册表。
- * @returns 注销函数（没有 tools 服务就是空数组）。
- */
 export declare function registerLongTaskTools(ctx: DshHostContext, longTaskRuns?: LongTaskRunsLookup | undefined): Array<() => void>;

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

@@ -1,7 +1,6 @@
-import type { UnitCapability } from '../../../shared/api/host/probe-units';
+import type { UnitCapability } from '@dsh-workbench/shared/host';
 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;
@@ -13,9 +12,4 @@ export interface DependencyUpdateDeps {
         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-dependency.d.ts

@@ -1,13 +1,11 @@
-import type { UnitCapability } from '../../../shared/api/host/probe-units';
-import { type ProvisionRequest } from '@dsh-workbench/shared/host';
-import type { UnitManifest } from '@dsh-workbench/shared/host';
-import { type PluginSourceCommand, type PluginSourceProblem } from '@dsh-workbench/shared/host';
-export type DependencyKind = 'plugin' | 'lib';
+import type { NeedState, ProvisionProblem, SupplySource, UnitCapability, UnitManifest } from '@dsh-workbench/shared/host';
+export declare const DEPENDENCY_KINDS: readonly ["extension", "lib"];
+export type DependencyKind = (typeof DEPENDENCY_KINDS)[number];
 export interface SharedDependency {
     readonly id: string;
     readonly kind: DependencyKind;
     readonly name: string;
-    readonly status: 'ok' | 'outdated' | 'unsatisfied' | 'missing' | 'unchecked';
+    readonly status: NeedState['status'];
     readonly installed?: string;
     readonly latest?: string;
     readonly purpose?: string;
@@ -19,6 +17,8 @@ export interface DependencyTarget {
     readonly name: string;
     readonly declarers: readonly UnitManifest[];
     readonly users: readonly UnitManifest[];
+    readonly sources?: readonly SupplySource[];
+    readonly conflict?: string;
 }
 export declare function dependencyId(kind: DependencyKind, name: string): string;
 export declare function parseDependencyId(id: string): {
@@ -26,17 +26,22 @@ export declare function parseDependencyId(id: string): {
     readonly name: string;
 } | undefined;
 export declare function findDependency(manifests: readonly UnitManifest[], id: string, isReleased?: ((unit: string) => boolean) | undefined): DependencyTarget | undefined;
-export declare function affectedUnitsOf(manifests: readonly UnitManifest[], request: ProvisionRequest): readonly string[];
+export declare function affectedUnitsOf(manifests: readonly UnitManifest[], request: {
+    readonly id?: string | undefined;
+    readonly unit?: string | undefined;
+}): readonly string[];
 export declare function sharedDependencies(options: {
     readonly manifests: readonly UnitManifest[];
     readonly capabilities: ReadonlyMap<string, UnitCapability>;
     readonly isReleased?: ((unit: string) => boolean) | undefined;
 }): SharedDependency[];
-export type DependencyPlan = readonly PluginSourceCommand[] | undefined;
+export type DependencyPlan = readonly {
+    readonly line: string;
+    readonly optional?: true;
+}[] | undefined;
 export declare function dependencyCommandPlan(options: {
     readonly target: DependencyTarget;
     readonly capability: UnitCapability | undefined;
     readonly capabilities?: ReadonlyMap<string, UnitCapability> | undefined;
-    readonly command: string;
 }): DependencyPlan;
-export declare function sourceProblemText(problem: PluginSourceProblem, env: string | undefined): string;
+export declare function sourceProblemText(problem: ProvisionProblem, env: string | undefined): string;

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

@@ -0,0 +1,3 @@
+import type { RouteTable } from '@dsh-workbench/shared/host';
+import type { MarketDiscover } from './market-discover';
+export declare function marketDiscoverRoutes(discover: MarketDiscover): RouteTable;