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

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

@@ -0,0 +1,15 @@
+import type { UnitCapability } from '@dsh-workbench/shared/host';
+import { type DependencyTarget, type SharedDependency } from './market-dependency';
+export interface DependencyUpdateDeps {
+    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;
+}
+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;

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

@@ -0,0 +1,33 @@
+import type { DshShell } from '@dsh-workbench/shared';
+import type { ProfileModule } from '@dsh-workbench/shared/host';
+import type { DiscoverDoc, DiscoverDocKind, DiscoverEntry, DiscoverFilter, DiscoverPayload } from '@dsh-workbench/shared/contract/protocol/market-index';
+import type { MarketIndexReader } from '../../../shared/api/host/market-index-fetch';
+import type { MarketDocReader } from '../../../shared/api/host/market-doc';
+import type { MarketSourcesStore } from '../../../shared/api/host/market-sources-store';
+export interface MarketDiscover {
+    snapshot(filter?: DiscoverFilter & {
+        readonly force?: boolean;
+    }): Promise<DiscoverPayload>;
+    document(name: string, version: string, kind: DiscoverDocKind): Promise<DiscoverDoc>;
+}
+export interface MarketDiscoverOptions {
+    readonly store: MarketSourcesStore;
+    readonly reader: MarketIndexReader;
+    readonly docs: MarketDocReader;
+    readonly modules: () => readonly ProfileModule[];
+    readonly defaultRegistry: () => Promise<string | undefined>;
+    readonly shell?: DshShell | undefined;
+    readonly shellVersion?: string | undefined;
+    readonly fetchImpl?: ((url: string, init: RequestInit) => Promise<Response>) | undefined;
+    readonly now?: (() => number) | undefined;
+    readonly peerTtlMs?: number | undefined;
+    readonly timeoutMs?: number | undefined;
+    readonly logger?: {
+        warn?(message: string): void;
+    } | undefined;
+}
+export declare function installTargetOf(entry: DiscoverEntry, version: string): {
+    readonly spec: string;
+    readonly registry?: string;
+} | undefined;
+export declare function createMarketDiscover(options: MarketDiscoverOptions): MarketDiscover;

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

@@ -1,6 +1,6 @@
 import type { ProvisionRequest } from '@dsh-workbench/shared/host';
-import type { BundleCancellation, BundleChange } from '../../../shared/api/bundle-install';
-import type { InstalledModule } from '../../../shared/api/host/installed-module';
+import type { BundleCancellation, BundleChange } from '../../../kernel/contract/bundle-install';
+import type { InstalledModule } from '@dsh-workbench/shared/host';
 import type { BundleSupply, MarketEntry, MarketService } from './market';
 import type { PluginKept } from './plugin-actions';
 import type { SharedDependency } from './market-dependency';
@@ -16,10 +16,11 @@ export type ProvisionResult = {
     readonly shared: readonly SharedDependency[];
 } | {
     readonly ok: true;
-    readonly action: 'install-bundle' | 'update-bundle';
+    readonly action: 'install-bundle' | 'install-version' | 'update-bundle';
     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-env.d.ts

@@ -1,10 +1,9 @@
-import type { UnitEnvNeeds, UnitManifest } from '@dsh-workbench/shared';
-import type { UnitCapability } from '../../../shared/api/host/probe-units';
+import type { Need, UnitCapability, UnitManifest } from '@dsh-workbench/shared/host';
 import { type PluginReferences } from './plugin-actions';
 import type { PluginLedger } from './plugin-ledger';
 export interface EnvDropper {
     usersOf(plugin: string, except?: string): string[];
-    drop(unit: string, env: UnitEnvNeeds | undefined, before: UnitCapability): Promise<string[]>;
+    drop(unit: string, needs: readonly Need[] | undefined, before: UnitCapability): Promise<string[]>;
 }
 export declare function createEnvDropper(options: {
     readonly catalog: () => readonly UnitManifest[];

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

@@ -1,6 +1,6 @@
-import type { BundleChange } from '../../../shared/api/bundle-install';
-import type { BundleManager } from '../../../shared/api/host/bundle-manager';
-import { type RegistryNotebook } from '../../../shared/api/host/profile-registries';
+import type { BundleChange } from '../../../kernel/contract/bundle-install';
+import type { BundleManager } from '@dsh-workbench/shared/host';
+import type { RegistryNotebook } from '@dsh-workbench/shared/host';
 export interface RegistryFixDeps {
     readonly registries?: RegistryNotebook | undefined;
     readonly logger?: {

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

@@ -1,2 +1,2 @@
-import type { BundleChange } from '../../../shared/api/bundle-install';
+import type { BundleChange } from '../../../kernel/contract/bundle-install';
 export declare function restartLogLine(change: BundleChange | null | undefined): string | undefined;

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

@@ -1,8 +1,9 @@
 import type { DshShell } from '@dsh-workbench/shared';
 import type { PluginSourceCommand } from '@dsh-workbench/shared/host';
-import type { BundleChange } from '../../../shared/api/bundle-install';
-import type { BundleManager } from '../../../shared/api/host/bundle-manager';
-import type { InstalledModule } from '../../../shared/api/host/installed-module';
+import type { BundleChange } from '../../../kernel/contract/bundle-install';
+import type { BundleManager } from '@dsh-workbench/shared/host';
+import type { InstalledModule } from '@dsh-workbench/shared/host';
+import { type SupplyPort } from '@dsh-workbench/shared/host';
 import type { PluginLedger } from './plugin-ledger';
 import type { BundleInstallOptions, BundleInstallOutcome, BundleSupply } from './market-types';
 export interface BundleInstallDeps {
@@ -11,6 +12,7 @@ export interface BundleInstallDeps {
     readonly registry?: string | undefined;
     readonly command: string;
     readonly shell?: DshShell | undefined;
+    readonly supply?: SupplyPort | undefined;
     readonly manager: BundleManager;
     readonly installed?: ((pkg: string) => InstalledModule) | undefined;
     readonly logger?: {

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

@@ -0,0 +1,9 @@
+import type { MarketSourcesAction } from '@dsh-workbench/shared/contract/protocol/market-index';
+import type { MarketSourceInitializer } from '../../../shared/api/host/market-source-init';
+import type { MarketSourcesStore } from '../../../shared/api/host/market-sources-store';
+export declare const MARKET_SOURCES_ACTION_RESOURCE = "market-sources";
+export declare function parseMarketSourcesAction(payload: unknown): MarketSourcesAction;
+export declare function marketSourcesAction(store: MarketSourcesStore, init?: MarketSourceInitializer | undefined): {
+    readonly resource: string;
+    handle(payload: unknown): Promise<unknown>;
+};

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

@@ -1,23 +1,15 @@
-import type { PluginSource } from '@dsh-workbench/shared';
+import type { Need } from '@dsh-workbench/shared';
 import type { ProvisionAction } from '@dsh-workbench/shared/host';
-import type { BundleCancellation, BundleChange, BundleInstalledPlugin } from '../../../shared/api/bundle-install';
-import type { InstalledModule } from '../../../shared/api/host/installed-module';
-import type { UnitCapability } from '../../../shared/api/host/probe-units';
+import type { BundleCancellation, BundleChange, BundleInstalledPlugin } from '../../../kernel/contract/bundle-install';
+import type { InstalledModule } from '@dsh-workbench/shared/host';
+import type { UnitCapability } from '@dsh-workbench/shared/host';
 import type { PluginUninstallOutcome, PluginUpdateOutcome } from './plugin-actions';
 import type { SharedDependency } from './market-dependency';
 export type MarketAction = ProvisionAction;
 export interface MarketEntry {
     readonly unit: string;
     readonly titleKey: string;
-    readonly plugins: readonly {
-        readonly name: string;
-        readonly source?: PluginSource;
-    }[];
-    readonly libs: readonly {
-        readonly name: string;
-        readonly version?: string | undefined;
-        readonly purpose: string;
-    }[];
+    readonly needs: readonly Need[];
     readonly capability: UnitCapability;
 }
 export interface UninstallResult {
@@ -48,6 +40,7 @@ export interface BundleInstallOutcome {
     readonly module: InstalledModule;
     readonly supply: BundleSupply;
     readonly plugin?: BundleInstalledPlugin;
+    readonly restored?: string;
 }
 export interface BundleRemoveOutcome {
     readonly change: BundleChange;
@@ -63,6 +56,7 @@ export interface MarketService {
     uninstall(unit: string): Promise<UninstallResult>;
     updateDependency(id: string): Promise<readonly SharedDependency[]>;
     installBundle(spec: string, options?: BundleInstallOptions): Promise<BundleInstallOutcome>;
+    replaceBundle(spec: string, options?: BundleInstallOptions): Promise<BundleInstallOutcome>;
     updateBundle(unit: string): Promise<BundleInstallOutcome | null>;
     updateWorkbench(pkg: string): Promise<BundleInstallOutcome>;
     removeBundle(pkg: string): Promise<BundleRemoveOutcome>;

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

@@ -0,0 +1,19 @@
+import type { DshShell } from '@dsh-workbench/shared';
+import type { BundleManager, SupplyPort } from '@dsh-workbench/shared/host';
+import type { InstalledModule, ProfileModule } from '@dsh-workbench/shared/host';
+import { type ReplaceBundleDeps } from './market-route';
+import type { BundleInstallOutcome } from './market-types';
+export interface BundleUpdateDeps {
+    readonly modules: (() => readonly ProfileModule[]) | undefined;
+    readonly installed: ((pkg: string) => InstalledModule) | undefined;
+    readonly shell: DshShell | undefined;
+    readonly manager: BundleManager;
+    readonly routeDeps: ReplaceBundleDeps;
+    readonly sweep: () => Promise<void>;
+    readonly refreshSupply: (unit: string) => Promise<void>;
+    readonly logger?: {
+        warn?(message: string): void;
+    } | undefined;
+    readonly supply?: SupplyPort | undefined;
+}
+export declare function updateModuleBundle(unit: string, deps: BundleUpdateDeps): Promise<BundleInstallOutcome | null>;

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

@@ -0,0 +1,15 @@
+import type { BundleChange } from '../../../kernel/contract/bundle-install';
+import type { InstalledModule } from '@dsh-workbench/shared/host';
+import type { UnitCapability } from '@dsh-workbench/shared/host';
+import type { DependencyTarget } from './market-dependency';
+export declare function verifyBundleUpdate(input: {
+    readonly change: BundleChange;
+    readonly before: string | undefined;
+    readonly after: InstalledModule;
+    readonly restored?: string | undefined;
+}): {
+    readonly change: BundleChange;
+    readonly restored?: string;
+};
+export declare function supplyUpdateStillBehind(after: UnitCapability): string | undefined;
+export declare function dependencyStillBehind(target: DependencyTarget, capabilities: ReadonlyMap<string, UnitCapability>): string | undefined;

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

@@ -1,6 +1,6 @@
 import type { DshShell } from '@dsh-workbench/shared';
-import type { InstalledModule, ProfilePackage } from '../../../shared/api/host/installed-module';
-import { type SelfUpdateRequest, type SelfUpdateStart } from '../../../shared/api/host/self-update';
+import type { InstalledModule, ProfilePackage, SupplyPort } from '@dsh-workbench/shared/host';
+import type { SelfUpdateRequest, SelfUpdateStart } from '@dsh-workbench/shared/host';
 import type { BundleInstallOutcome } from './market-types';
 export interface WorkbenchUpdateDeps {
     readonly asked: string;
@@ -15,5 +15,6 @@ export interface WorkbenchUpdateDeps {
         info?(message: string): void;
         warn?(message: string): void;
     } | undefined;
+    readonly supply?: SupplyPort | undefined;
 }
 export declare function updateWorkbenchOnce(deps: WorkbenchUpdateDeps): Promise<BundleInstallOutcome>;

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

@@ -1,10 +1,10 @@
 import type { DshShell } from '@dsh-workbench/shared';
 import type { UnitManifest } from '@dsh-workbench/shared';
-import type { BundleManager } from '../../../shared/api/host/bundle-manager';
-import type { InstalledModule, ProfileModule, ProfilePackage } from '../../../shared/api/host/installed-module';
-import type { RegistryNotebook } from '../../../shared/api/host/profile-registries';
-import type { UnitMountDeps } from '@dsh-workbench/shared/host';
-import type { SelfUpdateRequest, SelfUpdateStart } from '../../../shared/api/host/self-update';
+import type { BundleManager } from '@dsh-workbench/shared/host';
+import type { InstalledModule, ProfileModule, ProfilePackage } from '@dsh-workbench/shared/host';
+import type { RegistryNotebook } from '@dsh-workbench/shared/host';
+import { type SupplyPort, type UnitMountDeps } from '@dsh-workbench/shared/host';
+import type { SelfUpdateRequest, SelfUpdateStart } from '@dsh-workbench/shared/host';
 import { type PluginReferences } from './plugin-actions';
 import type { PluginLedger } from './plugin-ledger';
 import type { MarketService } from './market-types';
@@ -33,4 +33,5 @@ export declare function createMarketService(options: {
         info?(message: string): void;
         warn?(message: string): void;
     } | undefined;
+    supply?: SupplyPort | undefined;
 }): MarketService;

package/dist/types/modules/panels/model/plugin-actions.d.ts

@@ -1,5 +1,5 @@
 import type { DshShell } from '@dsh-workbench/shared';
-import { type PluginSourceCommand } from '@dsh-workbench/shared/host';
+import { type PluginSourceCommand, type SupplyPort } from '@dsh-workbench/shared/host';
 import type { PluginLedger } from './plugin-ledger';
 export type PluginKept = {
     readonly kind: 'held';
@@ -47,4 +47,5 @@ export declare function createPluginActions(options: {
         info?(message: string): void;
         warn?(message: string): void;
     } | undefined;
+    readonly supply?: SupplyPort | undefined;
 }): PluginActions;

package/dist/types/modules/panels/model/plugin-section.d.ts

@@ -1,13 +1,15 @@
 import type { DshShell } from '@dsh-workbench/shared';
-import { type RouteTable } from '@dsh-workbench/shared/host';
+import { type RouteTable, type SupplyPort } from '@dsh-workbench/shared/host';
 import type { InstalledPlugin } from '../../../shared/api/installed-plugins';
 import type { PluginLedger } from './plugin-ledger';
 export declare function installedPlugins(options: {
     readonly ledger: PluginLedger;
     readonly shell?: DshShell | undefined;
     readonly force?: boolean;
+    readonly supply?: SupplyPort | undefined;
 }): Promise<readonly InstalledPlugin[]>;
 export declare function pluginRoutes(options: {
     readonly ledger: PluginLedger;
     readonly shell?: DshShell | undefined;
+    readonly supply?: SupplyPort | undefined;
 }): RouteTable;

package/dist/types/modules/panels/model/publish-preview-routes.d.ts

@@ -0,0 +1,2 @@
+import type { RouteTable } from '@dsh-workbench/shared/host';
+export declare function publishPreviewRoutes(workshop: string | null): RouteTable;

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

@@ -14,13 +14,14 @@ export declare const MODULES_UPDATE_DEPENDENCY_TOOL = "workbench_modules_update_
 export declare const MODULES_UPDATE_PLUGIN_TOOL = "workbench_modules_update_plugin";
 export declare const MODULES_UNINSTALL_PLUGIN_TOOL = "workbench_modules_uninstall_plugin";
 export declare const MODULES_UPDATE_WORKBENCH_TOOL = "workbench_modules_update_workbench";
-export declare const DIY_LIST_TOOL = "workbench_diy_list";
 export declare const DIY_STATUS_TOOL = "workbench_diy_status";
 export declare const DIY_PANEL_TOOL = "workbench_diy_panel";
 export declare const DIY_COMPONENTS_TOOL = "workbench_diy_components";
 export declare const DIY_RECON_TOOL = "workbench_diy_recon";
 export declare const DIY_SPEC_TOOL = "workbench_diy_spec";
+export declare const DIY_CHANGELOG_TOOL = "workbench_diy_changelog";
 export declare const DIY_INSTALL_TOOL = "workbench_diy_install";
+export declare const DIY_PUBLISH_TOOL = "workbench_diy_publish";
 export declare const DIY_SHOW_TOOL = "workbench_diy_show";
 export declare const DIY_STATE_TOOL = "workbench_diy_state";
 export declare const DIY_HTML_TOOL = "workbench_diy_html";
@@ -49,11 +50,13 @@ export declare const DIY_DEBUG_START_TOOL = "workbench_diy_debug_start";
 export declare const DIY_DEBUG_PAUSE_TOOL = "workbench_diy_debug_pause";
 export declare const DIY_DEBUG_RESUME_TOOL = "workbench_diy_debug_resume";
 export declare const DIY_DEBUG_STOP_TOOL = "workbench_diy_debug_stop";
-export declare const ALL_TOOLS: readonly ["workbench_panels_list", "workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_list", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_components", "workbench_diy_recon", "workbench_diy_spec", "workbench_diy_install", "workbench_diy_show", "workbench_diy_state", "workbench_diy_html", "workbench_diy_find", "workbench_diy_click", "workbench_diy_hover", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_scroll", "workbench_diy_wait", "workbench_diy_eval", "workbench_diy_screenshot", "workbench_diy_network", "workbench_diy_dialog", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop", "workbench_diy_record_prepare", "workbench_diy_record_read", "workbench_diy_record_detail", "workbench_diy_record_stop", "workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop", "workbench_long_tasks_list", "workbench_long_tasks_stop"];
+export declare const ALL_TOOLS: readonly ["workbench_panels_list", "workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_list", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_components", "workbench_diy_recon", "workbench_diy_spec", "workbench_diy_changelog", "workbench_diy_install", "workbench_diy_publish", "workbench_diy_show", "workbench_diy_state", "workbench_diy_html", "workbench_diy_find", "workbench_diy_click", "workbench_diy_hover", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_scroll", "workbench_diy_wait", "workbench_diy_eval", "workbench_diy_screenshot", "workbench_diy_network", "workbench_diy_dialog", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop", "workbench_diy_record_prepare", "workbench_diy_record_read", "workbench_diy_record_detail", "workbench_diy_record_stop", "workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop", "workbench_long_tasks_list", "workbench_long_tasks_stop"];
 export type PanelsToolName = (typeof ALL_TOOLS)[number];
-export declare const READ_TOOLS: readonly ["workbench_panels_list", "workbench_modules_list", "workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_components", "workbench_diy_recon", "workbench_diy_spec", "workbench_diy_state", "workbench_diy_html", "workbench_diy_find", "workbench_diy_click", "workbench_diy_hover", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_scroll", "workbench_diy_wait", "workbench_diy_eval", "workbench_diy_screenshot", "workbench_diy_network", "workbench_diy_dialog", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop", "workbench_diy_record_read", "workbench_diy_record_detail", "workbench_diy_record_stop", "workbench_long_tasks_list"];
-export declare const WRITE_TOOLS: readonly ["workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_install", "workbench_diy_show", "workbench_diy_record_prepare", "workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop", "workbench_long_tasks_stop"];
-export declare const DIY_TOOLS: readonly ["workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_components", "workbench_diy_recon", "workbench_diy_spec", "workbench_diy_install", "workbench_diy_show", "workbench_diy_state", "workbench_diy_html", "workbench_diy_find", "workbench_diy_click", "workbench_diy_hover", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_scroll", "workbench_diy_wait", "workbench_diy_eval", "workbench_diy_screenshot", "workbench_diy_network", "workbench_diy_dialog", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop"];
+export declare const READ_TOOLS: readonly ["workbench_panels_list", "workbench_modules_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_components", "workbench_diy_recon", "workbench_diy_spec", "workbench_diy_state", "workbench_diy_html", "workbench_diy_find", "workbench_diy_click", "workbench_diy_hover", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_scroll", "workbench_diy_wait", "workbench_diy_eval", "workbench_diy_screenshot", "workbench_diy_network", "workbench_diy_dialog", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop", "workbench_diy_record_read", "workbench_diy_record_detail", "workbench_diy_record_stop", "workbench_long_tasks_list"];
+export declare const WRITE_TOOLS: readonly ["workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_changelog", "workbench_diy_install", "workbench_diy_publish", "workbench_diy_show", "workbench_diy_record_prepare", "workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop", "workbench_long_tasks_stop"];
+export declare const DIY_TOOLS: readonly ["workbench_diy_status", "workbench_diy_panel", "workbench_diy_components", "workbench_diy_recon", "workbench_diy_spec", "workbench_diy_changelog", "workbench_diy_install", "workbench_diy_publish", "workbench_diy_show", "workbench_diy_state", "workbench_diy_html", "workbench_diy_find", "workbench_diy_click", "workbench_diy_hover", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_scroll", "workbench_diy_wait", "workbench_diy_eval", "workbench_diy_screenshot", "workbench_diy_network", "workbench_diy_dialog", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop"];
 export declare const DIY_RECORD_TOOLS: readonly ["workbench_diy_record_prepare", "workbench_diy_record_read", "workbench_diy_record_detail", "workbench_diy_record_stop"];
 export declare const DIY_DEBUG_TOOLS: readonly ["workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop"];
+export declare const DIY_LOGS_TOOLS: readonly ["workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop"];
+export declare function screenOnlyToolsFor(pageDebug: boolean): readonly PanelsToolName[];
 export declare const panelsUnit: UnitManifest;

package/dist/types/modules/sessions/model/attention.d.ts

@@ -1,25 +1,14 @@
 import type { SessionStatusSnapshot, SessionSummary, SessionsSnapshot, Translate, WorkspaceView } from '@dsh-workbench/shared';
 export type AttentionSeverity = 'warning' | 'ongoing' | 'done';
-/**
- * 一个工作区那颗状态点：`count` 是**会话**条数（照旧，长任务没有会话可归时它是 0）；
- * `longTask` 为真表示这一档说的是长任务而不是会话 —— 只改那句人话的措辞。
- */
 export interface WorkspaceAttention {
     readonly severity: AttentionSeverity;
     readonly count: number;
     readonly longTask?: boolean | undefined;
 }
-/** 还在跑的长任务按两边归：会话行那颗 loading 点看 `bySession`，项目下拉每一行看 `byWorkspace`（按工作区路径数条数）。 */
 export interface LongTaskPresence {
     readonly bySession: ReadonlySet<string>;
     readonly byWorkspace: ReadonlyMap<string, number>;
 }
-/**
- * 把外壳那条长任务读口交回的行折成两侧的归属：有会话可归的进 `bySession`（那一行自己亮），
- * 每一条都按它属于哪个工作区进 `byWorkspace`（没有会话可归的那些只有这一侧看得见）。
- * @param rows 还在跑的长任务；每行要有它属于哪个工作区，会话那格可以没有。
- * @returns 两侧的归属；空输入就是两侧都空。
- */
 export declare function longTaskPresenceOf(rows: readonly {
     readonly workspace: string;
     readonly session?: string | undefined;

package/dist/types/modules/sessions/model/session-node.d.ts

@@ -17,16 +17,6 @@ export interface SessionStatusDot {
     readonly trailingLabel?: string;
 }
 export declare function visiblePendingKind(kind: string | undefined): string | undefined;
-/**
- * 把一条会话读成行上要的那几格。
- * @param summary 会话摘要。
- * @param statusById 会话状态表。
- * @param list 会话快照（子代理花名册在这里）。
- * @param pinnedIds 置顶的那些。
- * @param archivedIds 归档的那些。
- * @param longTaskIds 有长任务在跑的那些会话（外壳那条读口按“这趟是谁起的”算出来的）；不给就是都没有。
- * @returns 行模型；`longTask` 为真表示这条会话起的某趟长任务还在跑（它自己那一轮可能早结束了）。
- */
 export declare function sessionNode(summary: SessionSummary, statusById: SessionStatusSnapshot, list: SessionsSnapshot, pinnedIds: ReadonlySet<string>, archivedIds: ReadonlySet<string>, longTaskIds?: ReadonlySet<string>): SessionNode;
 export declare function sessionStatuses(node: SessionNode, t: Translate): SessionStatusDot[];
 export declare function currentSessionId(list: SessionsSnapshot, panelActive: boolean): string | undefined;

package/dist/types/shared/api/diy.d.ts

@@ -1,9 +1,11 @@
-export declare const DIY_PRESET_ID = "workbench-diy";
-export declare const WORKSHOP_RELATIVE = "workbench/diy";
-export declare const WORKSHOP_TITLE = "\u5DE5\u4F5C\u53F0DIY";
-export declare const WORKSHOP_PAST_TITLES: readonly string[];
+export { DIY_PRESET_ID, WORKSHOP_PAST_TITLES, WORKSHOP_RELATIVE, WORKSHOP_TITLE } from '../../kernel/contract/diy';
 export declare function isWorkshopPath(path: string): boolean;
 export interface DiyStartOptions {
     readonly agentPreset: string;
 }
 export declare function diyStartOptions(workspaceId: string, workshopId: string | undefined): DiyStartOptions | undefined;
+export declare function workshopPresetUpgrade(input: {
+    readonly workshop: boolean;
+    readonly blank: boolean;
+    readonly preset: unknown;
+}): string | undefined;

package/dist/types/shared/api/host/approval-call.d.ts

@@ -1,16 +1,7 @@
 import type { DshToolRunContext } from '@dsh-workbench/shared';
 import { type ApprovalCall } from '@dsh-workbench/shared/host';
-/**
- * 审批那一拍看到的这次工具调用：工具名 / 实参 / 所在工作区 / 发起的会话。
- */
 export interface ApprovalExec {
     readonly arguments?: unknown;
     readonly agent?: DshToolRunContext['agent'];
 }
-/**
- * 把 dsh 交来的那次工具调用折成审批策略要看的那份 call：工作区与发起会话都从 `exec` 现取，取不到就不写那个键。
- * @param exec dsh 交来的执行上下文；没有就只有实参这一格。
- * @param name 工具名；`undefined` = 这次调用没名字，不写这个键。
- * @returns 交给 `approvalFor` 的 `ApprovalCall`。
- */
 export declare function approvalCallOf(exec: ApprovalExec | undefined, name: string | undefined): ApprovalCall;

package/dist/types/shared/api/host/approval-gate.d.ts

@@ -0,0 +1,26 @@
+import type { DshHostContext, DshToolRunContext } from '@dsh-workbench/shared';
+import { type ToolUnit, type UnitMountResult } from '@dsh-workbench/shared/host';
+export interface ApprovalGateExec {
+    readonly name?: string;
+    readonly arguments?: unknown;
+    readonly agent?: DshToolRunContext['agent'];
+}
+export type ApprovalGateDecision = {
+    readonly kind: 'allow';
+} | {
+    readonly kind: 'deny';
+    readonly reason: string;
+} | {
+    readonly kind: 'cancel';
+} | {
+    readonly kind: 'ask';
+    readonly reason?: string;
+    readonly displayReason?: Record<string, string>;
+};
+export interface ApprovalGateDeps {
+    readonly ctx: DshHostContext;
+    readonly toolOf: (name: string) => ToolUnit | undefined;
+    readonly faceOf: (unit: string) => UnitMountResult | undefined;
+    readonly declaredNotes: () => ReadonlySet<string>;
+}
+export declare function createApprovalGate(deps: ApprovalGateDeps): (exec: ApprovalGateExec, next: () => Promise<ApprovalGateDecision>) => Promise<ApprovalGateDecision>;

package/dist/types/shared/api/host/bundle-routes.d.ts

@@ -1,7 +1,8 @@
 import type { DshHostContext, DshShell } from '@dsh-workbench/shared';
 import { type RouteHandler } from '@dsh-workbench/shared/host';
+import { type WorkbenchSelfUpdate } from '../../../kernel/contract/bundle-install';
 export declare function bundleRegistriesHandler(ctx: DshHostContext): RouteHandler;
 export declare function resetRefusalLog(): void;
 export declare function resetHoldLog(): void;
-export declare function moduleVersionsHandler(ctx: DshHostContext, shell: DshShell | undefined, running?: string | undefined): RouteHandler;
+export declare function moduleVersionsHandler(ctx: DshHostContext, shell: DshShell | undefined, running?: string | undefined, selfUpdate?: (() => WorkbenchSelfUpdate | undefined) | undefined): RouteHandler;
 export declare function bundleInspectHandler(ctx: DshHostContext): RouteHandler;

package/dist/types/shared/api/host/diy-artifacts.d.ts

@@ -0,0 +1,3 @@
+import type { DshHostContext } from '@dsh-workbench/shared';
+export declare function artifactsDirOf(ctx: DshHostContext, root: string): string;
+export declare function ensureDirOf(dir: string): void;

package/dist/types/shared/api/host/diy-changelog.d.ts

@@ -0,0 +1,13 @@
+import type { ChangelogKind } from '@dsh-workbench/shared/host';
+export interface ChangelogWrite {
+    readonly file: string;
+    readonly section: string;
+    readonly text: string;
+}
+export declare function moduleVersionOf(dir: string): string;
+export declare function writeChangelogEntry(dir: string, input: {
+    readonly version: string;
+    readonly kind: ChangelogKind;
+    readonly note: string;
+    readonly date?: string;
+}): ChangelogWrite;

package/dist/types/shared/api/host/diy-components.d.ts

@@ -6,7 +6,7 @@ export declare const NEAR_LIMIT = 8;
 export declare const PRUNE_CHARS = 8192;
 export declare const PRIMITIVES_PKG = "@deepseek-ai/dsh-client-ui-primitives";
 export declare const MANIFEST_TAIL = "//# sourceMappingURL=";
-export type SurfaceScope = 'all' | 'primitives' | 'kit';
+export type SurfaceScope = 'all' | 'primitives' | 'kit' | 'tokens';
 export interface SurfacePayload {
     readonly [key: string]: unknown;
 }
@@ -32,7 +32,6 @@ export declare function findFileOf(name: string, query: SurfaceQuery): {
 } | null;
 export declare function excerptOf(text: string, maxLines?: number): string;
 export declare function excerptAt(file: string, maxLines?: number): string;
-/** 指引目录：从宿主产物往上找 `skills/workbench-module-diy`（找不到回 `null`）。 */
 export declare function skillDirOf(from: string): string | null;
 export declare function byLocationOf(payload: SurfacePayload): readonly {
     readonly where: string;
@@ -49,7 +48,7 @@ export declare function bucketNamesOf(query: SurfaceQuery): readonly {
     readonly face: 'kit' | 'primitives';
     readonly keys: readonly string[];
 }[];
-export declare const TWO_FACE_ALL = "\u26A0\uFE0F \u4E24\u4E2A\u9762\u4E00\u8D77\u4E0D\u7ED9\u5168\u8868 \u2014\u2014 \u8981\u5168\u8868\u5C31\u6307\u540D\u4E00\u9762\uFF1Ascope=kit \u6216 scope=primitives\u3002";
+export declare const TWO_FACE_ALL = "\u26A0\uFE0F \u8981\u5168\u8868\u5C31\u6307\u540D\u4E00\u9762\uFF1Ascope=kit / primitives / tokens\u3002";
 export declare function refusesEvery(scope: SurfaceScope, all: boolean, focused: boolean): boolean;
 export declare function renderSurfaceText(query: SurfaceQuery, options: {
     scope: SurfaceScope;

package/dist/types/shared/api/host/diy-modules.d.ts

@@ -0,0 +1,25 @@
+export interface DiyModule {
+    readonly unit: string;
+    readonly name: string;
+    readonly description: string;
+    readonly dir: string;
+    readonly installed: boolean;
+}
+export declare function insideRoot(root: string, target: string): boolean;
+export type WorkspaceShape = 'workspace' | 'package' | 'bare';
+export declare function shapeOf(root: string): WorkspaceShape;
+export declare function modulesIn(root: string, installed?: readonly string[]): readonly DiyModule[];
+export declare function readDesignOfModule(dir: string): unknown;
+export interface SyncState {
+    readonly state: 'ok' | 'syncing' | 'failed';
+    readonly version: string;
+    readonly at: string;
+    readonly reason?: string;
+}
+export declare function syncStateOf(workspaceRoot: string): SyncState | undefined;
+export interface Toolchain {
+    readonly core: string;
+    readonly moduleTools: string;
+    readonly shared: string;
+}
+export declare function toolchainOf(workspaceRoot: string): Toolchain | undefined;

package/dist/types/shared/api/host/diy-publish-preview.d.ts

@@ -0,0 +1,4 @@
+import type { PublishPreview } from '@dsh-workbench/shared/contract/protocol/market-index';
+export declare function publishPreviewOf(root: string | null | undefined, unit: string, options?: {
+    readonly version?: string | undefined;
+}): PublishPreview | null;