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

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

@@ -1,3 +1,3 @@
 export type MarketSectionKind = 'installed' | 'pending' | 'plugins' | 'shared';
-export declare function marketSectionIcon(kind: MarketSectionKind): import("react").FunctionComponentElement<import("@dsh-workbench/shared").IconProps> | import("react").FunctionComponentElement<import("@deepseek-ai/dsh-client-ui-primitives").IconProps>;
+export declare function marketSectionIcon(kind: MarketSectionKind): import("react").FunctionComponentElement<import("@deepseek-ai/dsh-client-ui-primitives").IconProps> | import("react").FunctionComponentElement<import("@dsh-workbench/shared").IconProps>;
 export type MarketSectionIcon = ReturnType<typeof marketSectionIcon>;

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

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

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

@@ -1,10 +1,13 @@
+import type { WorkbenchSelfUpdate } from '../../../kernel/contract/bundle-install';
 import type { MarketRowAction, ModuleUpdate } from './market-row-types';
+import type { SharedState } from './market-shared-rows';
 export declare const MODULE_SETTLE_MS = 15000;
 export declare function holdBack(installed: readonly string[], roster: ReadonlySet<string>, active: ReadonlySet<string>, previous: ReadonlySet<string> | null): readonly string[];
 export declare const WORKBENCH_SWAP_MS = 180000;
 export declare const WORKBENCH_SWAP_POLL_MS = 800;
 export declare function swapLanded(until: string | undefined, installed: string | undefined): boolean;
 export declare function swapUntil(action: string, application: string | undefined, latest: string | undefined): string | undefined;
+export declare const REMOVAL_ACTIONS: ReadonlySet<MarketRowAction>;
 export declare function awaitsReadBack(action: MarketRowAction, application: string | undefined, version: string | undefined): boolean;
 export declare function readBackDone(input: {
     readonly action: MarketRowAction;
@@ -20,5 +23,19 @@ export declare function settleLanded(input: {
     readonly entry: ModuleUpdate | undefined;
     readonly clicked: string | undefined;
     readonly outdated: boolean;
+    readonly sharedState?: SharedState | undefined;
+    readonly pluginOutdated?: boolean | null | undefined;
+    readonly unitGone?: boolean | null | undefined;
+    readonly pluginGone?: boolean | null | undefined;
 }): boolean;
+export interface SelfUpdateStop {
+    readonly kind: 'failed' | 'rolled-back';
+    readonly reason?: string;
+    readonly version?: string;
+}
+export declare function selfUpdateStop(input: {
+    readonly until: string | undefined;
+    readonly since: number | undefined;
+    readonly update: WorkbenchSelfUpdate | null | undefined;
+}): SelfUpdateStop | undefined;
 export declare function holdWindowMs(until: string | undefined): number;

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

@@ -5,7 +5,7 @@ export type SharedState = 'checking' | 'installed' | 'outdated' | 'unsatisfied'
 export declare const SHARED_STATE_KEY: Readonly<Record<SharedState, string>>;
 export interface SharedRow {
     readonly id: string;
-    readonly kind: 'plugin' | 'lib';
+    readonly kind: 'extension' | 'lib';
     readonly label: string;
     readonly usedByKeys: readonly string[];
     readonly state: SharedState;

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

@@ -0,0 +1,31 @@
+import type { Translate } from '@dsh-workbench/shared';
+import type { BundleChange } from '../../../kernel/contract/bundle-install';
+import type { MarketRowAction } from './market-row-types';
+export interface UpdatedModule {
+    readonly kind?: string;
+    readonly pkg?: string;
+    readonly version?: string;
+}
+export type UpdateVerdict = {
+    readonly kind: 'ok';
+} | {
+    readonly kind: 'no-change';
+} | {
+    readonly kind: 'gone';
+    readonly restored?: string;
+} | {
+    readonly kind: 'behind';
+    readonly installed: string;
+};
+export declare function updateVerdictOf(input: {
+    readonly action: MarketRowAction;
+    readonly change: BundleChange | undefined;
+    readonly module: UpdatedModule | undefined;
+    readonly restored?: string | undefined;
+    readonly clicked?: string | undefined;
+    readonly latest?: string | undefined;
+}): UpdateVerdict;
+export declare function updateVerdictText(verdict: UpdateVerdict, t: Translate, input: {
+    readonly from?: string | undefined;
+    readonly latest?: string | undefined;
+}): string | undefined;

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

@@ -1,6 +1,7 @@
 import type { UnitManifest } from '@dsh-workbench/shared';
 import type { CapabilityMap } from '../../../shared/hooks/use-capabilities';
 import type { MarketRow, MarketRowAction, ModuleUpdateMap } from './market-rows';
+import type { SharedRow } from './market-shared-rows';
 export declare const PROGRESS_KEY: Readonly<Record<MarketRowAction, string>>;
 export declare const ACTION_LABEL_KEY: Readonly<Record<MarketRowAction, string>>;
 export interface HeldRow {
@@ -14,12 +15,18 @@ export interface Pending {
     readonly label?: string | undefined;
     readonly pkg?: string | undefined;
     readonly version?: string | undefined;
+    readonly latest?: string | undefined;
+    readonly since?: number | undefined;
     readonly row?: MarketRow | undefined;
     readonly until?: string | undefined;
     readonly readBack?: boolean | undefined;
 }
 export declare function holdOf(pending: Pending | null, application: string | undefined): HeldRow | undefined;
-export declare function pendingLanded(pending: Pending | null, updates: ModuleUpdateMap, capabilities: CapabilityMap | null, installed: string | undefined): boolean;
+export 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,6 +22,8 @@ export interface RightbarPersistence {
     readText(key: string): string | null;
     writeText(key: string, value: string | null): void;
 }
+export declare function readFlag(key: string, fallback: boolean): boolean;
+export declare function writeFlag(key: string, value: boolean): void;
 export declare const RIGHTBAR_DEFAULT_EXPANDED = true;
 export declare const RIGHTBAR_DEFAULT_COLUMN: RightbarColumn;
 export interface RightbarColumnPressed {

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

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

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

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

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

@@ -0,0 +1,6 @@
+import type { DshClientContext } from '@dsh-workbench/shared';
+import type { SidebarEdition } from '../../../kernel/contract/sidebar-edition';
+export declare function markSidebarEditionPending(edition: SidebarEdition): void;
+export declare function armCustomSidebarTakeover(): void;
+export declare function disarmCustomSidebarTakeover(): void;
+export declare function bootSidebarEdition(ctx: DshClientContext, registerOwn: () => void): void;

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

@@ -0,0 +1,5 @@
+import type { SidebarEdition } from '../../../kernel/contract/sidebar-edition';
+export declare function runtimeSidebarEdition(): SidebarEdition;
+export declare function setRuntimeSidebarEdition(next: SidebarEdition): void;
+export declare function subscribeSidebarEdition(listener: () => void): () => void;
+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/ConfigSyncItem.d.ts

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

package/dist/types/app/layouts/workbench-settings/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

@@ -0,0 +1,8 @@
+import type { ReactNode } from 'react';
+export interface SettingsItemProps {
+    readonly title: string;
+    readonly description?: string | undefined;
+    readonly action?: ReactNode | undefined;
+    readonly children?: ReactNode | undefined;
+}
+export declare function SettingsItem({ title, description, action, children }: SettingsItemProps): JSX.Element;

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

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

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

@@ -0,0 +1,5 @@
+import type { Translate } from '@dsh-workbench/shared';
+export interface WorkbenchSettingsSectionProps {
+    readonly t: Translate;
+}
+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,10 +1,6 @@
-import type { ApprovalPolicy } from '@dsh-workbench/shared/host';
+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';
+export type PublishApprovalPreview = PublishPreview;
 export declare const panelsApproval: ApprovalPolicy;
-/**
- * 面板族的审批策略：`panelsApproval` 再认长任务那一档（写成功要用户点头）。
- * `longTaskRuns` 用来查"这一趟是谁起的" —— 自己起的免问，别的会话起的 / 用户按的要问。
- * @param longTaskRuns 当前挂着的单元各自那把长任务注册表；没给就按"别人的"问（保守的那一侧）。
- * @returns 审批策略：认领的写工具回 ask / allow，不是本族的回 undefined。
- */
-export declare function panelsApprovalFor(longTaskRuns?: LongTaskRunsLookup | 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-browser-tools.d.ts

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

package/dist/types/modules/panels/model/diy-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;
@@ -7,7 +7,7 @@ export declare const OUTPUT_SCHEMA: {
         text: {
             type: string;
         };
-        workshop: {
+        workspace: {
             type: string;
         };
         modules: {
@@ -44,7 +44,7 @@ export declare const OUTPUT: {
             text: {
                 type: string;
             };
-            workshop: {
+            workspace: {
                 type: string;
             };
             modules: {
@@ -88,23 +88,25 @@ export declare function showOrReason(panels: PanelsService, unit: string, worksp
     readonly ok: boolean;
     readonly reason?: string;
 };
-/**
- * 这一次 DIY 调用落在哪个工坊上：**先认工坊自己的家**（`$DSH_HOME/workbench/diy`，宿主就是按它把工坊
- * 登记成工作区的），**不跟着会话 cwd 走** —— 用户把自己的项目设成工作区时，cwd 往上找会撞上任意一个
- * 带 `packages/` 的仓库，模块列表与 `shots/` 落点会一起变样（真机踩过：录制落点跑到仓库根、截图 EPERM）。
- * 只有拿不到工坊的家时，才退回"从会话工作区往上找像工坊的目录"。
- * @param ctx - 宿主上下文。
- * @param exec - 这次工具调用（退回那一档要读它的会话工作区）。
- * @returns 工坊的 packages 目录、根路径与标题。
- */
-export declare function workshopOf(ctx: DshHostContext, exec: DshToolRunContext): Promise<{
-    readonly packagesDir: string;
-    readonly workspace: string | null;
+export declare function workspaceOf(ctx: DshHostContext, exec: DshToolRunContext): Promise<{
+    readonly root: string;
     readonly title: string;
 }>;
-export declare function modulesOf(ctx: DshHostContext, packagesDir: string): {
+export interface KnownUnit {
+    readonly unit: string;
+    readonly name: string;
+    readonly description: string;
+    readonly dir: string;
+    readonly installed: boolean;
+}
+export declare function unitsOf(ctx: DshHostContext, root: string): {
     installed: string[];
-    modules: readonly import("@/shared/api/host/diy-workshop").WorkshopModule[];
+    modules: readonly import("@/shared/api/host/diy-modules").DiyModule[];
+    units: readonly KnownUnit[];
 };
-export declare function moduleDirsOf(packagesDir: string): readonly string[];
+export declare function modulesOf(ctx: DshHostContext, root: string): {
+    installed: string[];
+    modules: readonly import("@/shared/api/host/diy-modules").DiyModule[];
+};
+export declare function moduleDirsOf(root: string): readonly string[];
 export declare function panelEntriesOf(panels: PanelsService, workspace: string | null): import("./config").PanelEntry[];

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

@@ -4,7 +4,8 @@ import { type BoardFactState, type BoardProbe, type BoardSituation } from '@dsh-
 import { type WorkbenchPage } from './diy-browser';
 export type BoardState = BoardFactState;
 export interface PageHandle {
-    readonly packagesDir: string;
+    readonly root: string;
+    readonly artifactsDir: string;
     readonly unit: string;
     readonly args: Record<string, unknown>;
     readonly shell: DshShell;
@@ -17,7 +18,7 @@ export interface PageHandle {
 export interface PageOptions {
     readonly requireWorkbench?: boolean | undefined;
     readonly requireUnit?: boolean | undefined;
-    readonly requireBoard?: 'workshop' | false | undefined;
+    readonly requireBoard?: boolean | undefined;
     readonly requirePact?: boolean | undefined;
 }
 export declare function debugPausedText(held: DebugState): string;
@@ -27,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,30 +6,14 @@ 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>;
 export declare function waitOf(value: unknown): number;
 export declare function foreignDomainText(design: unknown, url: string): string;
-export declare function captureFileOf(packagesDir: string, unit: string): string;
+export declare function captureFileOf(artifactsDir: string, unit: string): string;
 export declare function lastCaptureFileOf(file: string): string;
-/**
- * 这一族自己的落图路径：跟 `rec-<unit>.jsonl` 同目录、`rec-shot-` 前缀（工坊那一页的图另有名字）。
- * @param captureFile - 这一场捕获文件；图就落在它旁边。@param unit - 单元名。@param n - 页面「已拍」计数。
- * @returns 形如 `…/shots/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-report.d.ts

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

package/dist/types/modules/panels/model/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>;