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

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

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 {
@@ -64,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

@@ -1,6 +1,6 @@
 import type { DshShell } from '@dsh-workbench/shared';
-import type { BundleManager } from '../../../shared/api/host/bundle-manager';
-import type { InstalledModule, ProfileModule } from '../../../shared/api/host/installed-module';
+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 {
@@ -14,12 +14,6 @@ export interface BundleUpdateDeps {
     readonly logger?: {
         warn?(message: string): void;
     } | undefined;
+    readonly supply?: SupplyPort | undefined;
 }
-/**
- * 模块行那一颗「更新」：拿源上最新那一版（问不到就让源决定），有包就「先卸再装」，
- * 跑完**重新读盘对账**——版本没动、模块丢了、没到最新，都不许回一句“成了”。
- * @param unit 市场行的单元 id（模块包自己的 `dsh.workbench.unit`）。
- * @returns 管理器那一跳 + 校正后的 `change`、盘上实际 `module`、装丢后回滚成功的 `restored`；
- * 这份 profile 里没有这个模块时回 `null`。
- */
 export declare function updateModuleBundle(unit: string, deps: BundleUpdateDeps): Promise<BundleInstallOutcome | null>;

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

@@ -1,15 +1,7 @@
-import type { BundleChange } 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 { 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';
-/**
- * 更新跑完拿盘上的真实结果核对一次：dsh 回 `applied` 只代表"这一跳跑完了"，不代表版本真的动了
- * （源上给的版本可能不是最新、`pnpm` 也可能按供应策略暂缓）。判据是**点下去那一版 vs 盘上这一版**：
- * 没动就是 `no-change`，装完读不到模块就是 `module-gone`；两种情况都会把红字交给界面，而不是假装成功。
- * @param input.change 管理器回的那一跳；`before` 点下去之前盘上的版本；`after` 跑完再读的盘上结果。
- * @param input.restored 装丢之后回滚成功时装回去的版本（失败的那一跳仍然是失败）。
- * @returns 校正后的 `change`（成功时带 `version` = 盘上实际版本）与 `restored`。
- */
 export declare function verifyBundleUpdate(input: {
     readonly change: BundleChange;
     readonly before: string | undefined;
@@ -19,13 +11,5 @@ export declare function verifyBundleUpdate(input: {
     readonly change: BundleChange;
     readonly restored?: string;
 };
-/**
- * 命令那一跳（升 opencli 插件 / 库）跑完还落后时给一句人话：`undefined` = 真追上。
- * @param after 跑完重新探到的能力格；只认它自己的 `fix === 'update'`，别的失败不在这里下结论。
- */
 export declare function supplyUpdateStillBehind(after: UnitCapability): string | undefined;
-/**
- * 共用依赖行更新完还落后（插件 `outdated` 或库 `outdated` / `unsatisfied`）时给一句人话。
- * @param target 这一行代表的那份依赖；`capabilities` 是跑完后**强探**过的那批声明者。
- */
 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

@@ -19,7 +19,9 @@ 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";
@@ -48,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_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_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_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 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

@@ -1,16 +1,10 @@
 import type { DshHostContext, DshToolRunContext } from '@dsh-workbench/shared';
 import { type ToolUnit, type UnitMountResult } from '@dsh-workbench/shared/host';
-/**
- * dsh 交来的 `tools/pre-execute` 现场：工具名、实参与发起它的 agent。
- */
 export interface ApprovalGateExec {
     readonly name?: string;
     readonly arguments?: unknown;
     readonly agent?: DshToolRunContext['agent'];
 }
-/**
- * 外壳这一拍能交出的判定：与 dsh 的 pre-execute 判定同形。
- */
 export type ApprovalGateDecision = {
     readonly kind: 'allow';
 } | {
@@ -23,17 +17,10 @@ export type ApprovalGateDecision = {
     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>;
 }
-/**
- * 造 `tools/pre-execute` 的监听器：先让后面那道闸判，只有它说 allow 才轮到外壳的写审批。
- * 完全权限下不再把 `ask` 交出去（dsh 的 `never` 会直接拒），认领与 `{blocked}` 仍由 `approvalFor` 守。
- */
 export declare function createApprovalGate(deps: ApprovalGateDeps): (exec: ApprovalGateExec, next: () => Promise<ApprovalGateDecision>) => Promise<ApprovalGateDecision>;

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

@@ -1,6 +1,6 @@
 import type { DshHostContext, DshShell } from '@dsh-workbench/shared';
 import { type RouteHandler } from '@dsh-workbench/shared/host';
-import { type WorkbenchSelfUpdate } from '../bundle-install.js';
+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;

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

@@ -1,14 +1,3 @@
 import type { DshHostContext } from '@dsh-workbench/shared';
-/**
- * 这次会话的取证材料落哪儿（截图 / `rec-*.jsonl` / `net-*.jsonl`）：外壳自己的目录，按工作区分桶
- * （目录名 + 路径哈希前 8 位）。**不落用户仓库、也不落任何模块目录** —— 它在 opencli 的可写根内。
- * @param ctx - 宿主上下文（要 `dshHomePath` 服务）。
- * @param root - 工作区根（会话的登记 path）。
- * @returns 绝对路径；这台机器没有 `dshHomePath` 时抛错。
- */
 export declare function artifactsDirOf(ctx: DshHostContext, root: string): string;
-/**
- * 把这个目录建出来（宿主进程直接建 —— 不走 agent 的 shell，沙箱只放行会话工作区）。
- * @param dir - 要建的绝对路径；已存在就什么都不做。
- */
 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

@@ -7,23 +7,7 @@ export interface DiyModule {
 }
 export declare function insideRoot(root: string, target: string): boolean;
 export type WorkspaceShape = 'workspace' | 'package' | 'bare';
-/**
- * 这个工作区**像什么**（只用来把话说清楚，不用来拒绝任何事）：自己声明了 workspace（`pnpm-workspace.yaml`
- * 或 `package.json` 的 `workspaces`）就是 `workspace`；有 `package.json` 但没声明 workspace 是 `package`；
- * 连 `package.json` 都没有是 `bare`（空项目 / 一堆散文件都算这一档 —— DIY 的看与调不挑结构）。
- * @param root - 工作区根。
- * @returns 这三种形状之一。
- */
 export declare function shapeOf(root: string): WorkspaceShape;
-/**
- * 这个工作区里有哪些 DIY 模块：工作区根自己的 `package.json`、加上它声明的 workspace 包目录
- * （`pnpm-workspace.yaml` 的 `packages:`，或 `package.json` 的 `workspaces`），凡在
- * `dsh.workbench.unit` 里报了 id 的都算（ADR-0038 的声明协议）。
- * **只读声明、不猜目录**：工作区是什么结构都行（空项目 / 单包 / monorepo），找不到就是空数组。
- * @param root - 工作区根（会话的登记 path）。
- * @param installed - 已经装进 profile 的单元 id（会标在每一行上）。
- * @returns 按 unit 排好序的模块表；一个都没有就给空数组。
- */
 export declare function modulesIn(root: string, installed?: readonly string[]): readonly DiyModule[];
 export declare function readDesignOfModule(dir: string): unknown;
 export interface SyncState {

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;

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

@@ -1,3 +1,3 @@
 import { type ReconCommand, type ReconPlugin } from './diy-recon';
-export declare function reconCatalogOf(path?: string): readonly ReconCommand[] | undefined;
-export declare function installedPluginsOf(dir?: string): readonly ReconPlugin[];
+export declare function reconCatalogOf(path: string): readonly ReconCommand[] | undefined;
+export declare function installedPluginsOf(dir: string): readonly ReconPlugin[];

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

@@ -0,0 +1,8 @@
+import type { TokenSet } from '@dsh-workbench/shared/host';
+export interface TokenRenderOptions {
+    readonly name: string;
+    readonly bucket: string;
+    readonly all: boolean;
+    readonly searched: readonly string[];
+}
+export declare function renderTokensText(set: TokenSet, options: TokenRenderOptions): string;

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

@@ -1,13 +1,10 @@
 import type { DshHostContext } from '@dsh-workbench/shared';
-import type { FactLog, RouteTable } from '@dsh-workbench/shared/host';
-import type { OpencliResolution } from './opencli-command';
-/**
- * 外壳的几条读口路由（健康 / 事实 / 插件 / 模块版本 / 装前预检）。
- * @param input.ctx 宿主上下文；`running` 是**加载它的进程**里那一版（不是盘上），自更新后两者会不同。
- */
+import type { FactLog, ProfilePort, RouteTable } from '@dsh-workbench/shared/host';
+import type { OpencliResolution } from '@dsh-workbench/shared/host';
 export declare function createHostRoutes(input: {
     readonly ctx: DshHostContext;
     readonly facts: FactLog;
     readonly opencli: OpencliResolution;
     readonly running: string | undefined;
+    readonly profile: ProfilePort;
 }): RouteTable;

package/dist/types/shared/api/host/long-task-notice.d.ts

@@ -1,30 +1,10 @@
 import type { LongTaskBase, LongTaskChange } from '@dsh-workbench/shared/host';
 import { type AgentsLookup, type NoticeDelivery, type NoticeMessage } from './diy-debug-act';
-/**
- * 这条 notice 的来源标识（`source.kind`）—— 长任务自己一格，与调试 / 录制分开。
- */
 export declare const LONG_TASK_NOTICE_KIND = "workbench-long-task";
-/**
- * 一条"这一趟被停了"的 notice：发给谁（`session`）、说什么（`message` / `summary`）。
- */
 export interface LongTaskStopNotice {
     readonly session: string;
     readonly message: NoticeMessage;
     readonly summary: string;
 }
-/**
- * 判这一趟被停要不要回流给发起它的那个会话，并把话写好。
- * 只有"结算 + `stopped` + 这一趟记得会话 + 不是它自己停的"才回一条；跑完 / 失败 / 界面起的（没记会话）/ 自己停的回 `null`。
- * @param unit 这一趟属于哪个单元（进文案）。
- * @param change 长任务那一次变更；只有 `kind: 'settle'` 且 `snapshot.status === 'stopped'` 才可能成。
- * @returns 该发的那条（带收件会话），或者 `null`（不发）。
- */
 export declare function longTaskStopNotice(unit: string, change: LongTaskChange<LongTaskBase>): LongTaskStopNotice | null;
-/**
- * 把"这一趟被停了"送出去：正在跑的会话 inject 一条、闲着的跳过、没有这个 agent 就当没发生（模式 `drop`）。
- * @param agents 会话表（宿主从 `ctx.get('agents')` 拿）；拿不到就什么都不发。
- * @param unit 这一趟属于哪个单元。
- * @param change 长任务那一次变更。
- * @returns 送出去的结果；判据说不该发（`longTaskStopNotice` 回 `null`）就回 `null`。
- */
 export declare function notifyLongTaskStop(agents: AgentsLookup | undefined, unit: string, change: LongTaskChange<LongTaskBase>): NoticeDelivery | null;