@dsh-workbench/core 1.1.8 → 1.1.9

package/dist/types/app/layouts/approval-detail.d.ts

@@ -1,4 +1,4 @@
-import type { ApprovalInput, ReactNode, Translate, UnitManifest, UnitToolOpencli } from '@dsh-workbench/shared';
+import type { ApprovalInput, ReactNode, Translate, UnitManifest, UnitToolRuntime } from '@dsh-workbench/shared';
 import type { MarketSourcesPayload, PublishPreview } from '../../kernel/contract/market-index';
 export interface ApprovalRow {
     readonly label: string;
@@ -12,9 +12,9 @@ export interface ApprovalPlanView {
     readonly warn?: string | undefined;
 }
 export declare function marketSourceRows(tool: string, args: Readonly<Record<string, unknown>>, payload: MarketSourcesPayload | null | undefined, t: Translate): readonly ApprovalRow[];
-export declare function pluginToolIndexOf(manifests: readonly UnitManifest[]): ReadonlyMap<string, UnitToolOpencli>;
-export declare function pluginApprovalRows(origin: UnitToolOpencli, args: Readonly<Record<string, unknown>>, t: Translate): readonly ApprovalRow[];
+export declare function pluginToolIndexOf(manifests: readonly UnitManifest[]): ReadonlyMap<string, UnitToolRuntime>;
+export declare function pluginApprovalRows(origin: UnitToolRuntime, args: Readonly<Record<string, unknown>>, t: Translate): readonly ApprovalRow[];
 export declare function shellApprovalRenderer(manifests: () => readonly UnitManifest[]): (input: ApprovalInput, t: Translate) => ReactNode;
 export declare function shellClaimsApprovalDetail(tool: string): boolean;
-export declare function shellApprovalPlan(input: ApprovalInput, t: Translate, pluginTools?: ReadonlyMap<string, UnitToolOpencli> | undefined): ApprovalPlanView | undefined;
-export declare function shellApprovalDetail(input: ApprovalInput, t: Translate, pluginTools?: ReadonlyMap<string, UnitToolOpencli> | undefined): ReactNode;
+export declare function shellApprovalPlan(input: ApprovalInput, t: Translate, pluginTools?: ReadonlyMap<string, UnitToolRuntime> | undefined): ApprovalPlanView | undefined;
+export declare function shellApprovalDetail(input: ApprovalInput, t: Translate, pluginTools?: ReadonlyMap<string, UnitToolRuntime> | undefined): ReactNode;

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

@@ -1,14 +1,15 @@
 import type { Translate } from '@dsh-workbench/shared';
 import type { PreflightBridgeIssue, PreflightGuidance, PreflightSnapshot, PreflightStep } from '@dsh-workbench/shared/host';
+import type { RuntimeProfile } from '@dsh-workbench/shared';
 export declare function failedStepText(guidance: PreflightGuidance | undefined, t: Translate): string;
 export declare function stepDetailText(step: PreflightStep, snapshot: PreflightSnapshot, t: Translate): string;
 export declare function showsRawDetails(snapshot: PreflightSnapshot): boolean;
-export declare const OPENCLI_EXTENSION_URL = "https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk";
+export declare function showsRawAll(snapshot: PreflightSnapshot, panelShown: boolean): boolean;
 export interface BridgeAdvice {
-    readonly textKey: string;
+    readonly text: string;
     readonly link?: {
-        readonly labelKey: string;
+        readonly label: string;
         readonly href: string;
     };
 }
-export declare function bridgeAdvice(issue: PreflightBridgeIssue): BridgeAdvice;
+export declare function bridgeAdvice(issue: PreflightBridgeIssue, t: Translate, fixes?: RuntimeProfile['bridge']): BridgeAdvice;

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

@@ -1,13 +1,15 @@
-import type { Translate } from '@dsh-workbench/shared';
+import type { ReactNode, Translate } from '@dsh-workbench/shared';
 import type { UnitManifest } from '@dsh-workbench/shared';
 import type { CapabilityMap } from '../../../shared/hooks/use-capabilities';
 import type { MarketFreshness } from './market-freshness';
 import type { InstalledPlugin } from '../../../shared/api/installed-plugins';
-import { type InstalledWorkbenchModule } from './market-rows';
+import { type InstalledWorkbenchModule, type MarketRow, type MarketRowAction, type SharedRow } from './market-rows';
 import type { TitleResolve } from './market-names';
 import type { MarketMock } from './market-mock';
+import type { MarketFailure } from './market-row-types';
 import type { ModuleUpdateMap } from './market-rows';
 import type { WorkbenchSelfUpdate, WorkbenchVersion } from '../../../kernel/contract/bundle-install';
+import { type Pending } from './market-view-text';
 import type { VersionsCheck, VersionsPart } from '../market/use-module-versions';
 export interface MarketViewProps {
     readonly t: Translate;
@@ -15,6 +17,7 @@ export interface MarketViewProps {
     readonly manifests: readonly UnitManifest[];
     readonly installable?: ReadonlySet<string> | null | undefined;
     readonly capabilities: CapabilityMap | null;
+    readonly runtimePluginMarket?: boolean | undefined;
     readonly freshness: MarketFreshness;
     readonly onChanged: (options?: {
         readonly force?: boolean;
@@ -35,4 +38,23 @@ export interface MarketViewProps {
     readonly defaults?: readonly string[] | undefined;
     readonly changed?: Readonly<Record<string, number>> | undefined;
 }
-export declare function MarketView({ t, titleOf, manifests, installable, capabilities, freshness, onChanged, onPending, updates, modulesCheck, pluginsCheck, onCheck, installed, installedRead, workbench, selfUpdate, plugins, settling, installing, mock, defaults, changed, }: MarketViewProps): JSX.Element;
+export declare function MarketBody({ t, self, shown, pluginList, installedList, shared, pending, failed, notice, act, onConfirming, setDefault, boardBusy, checks, onRecheck, rechecking, runtimePluginMarket, }: {
+    readonly t: Translate;
+    readonly runtimePluginMarket?: boolean | undefined;
+    readonly self: MarketRow | undefined;
+    readonly shown: readonly MarketRow[];
+    readonly pluginList: readonly MarketRow[];
+    readonly installedList: readonly MarketRow[];
+    readonly shared: readonly SharedRow[];
+    readonly pending: Pending | null;
+    readonly failed: MarketFailure | null;
+    readonly notice: string | null;
+    readonly act: (id: string, action: MarketRowAction) => Promise<void>;
+    readonly onConfirming: (id: string | null) => void;
+    readonly setDefault: (id: string, next: boolean) => Promise<void>;
+    readonly boardBusy: boolean;
+    readonly checks: Readonly<Record<VersionsPart, ReactNode>>;
+    readonly onRecheck: () => void;
+    readonly rechecking: boolean;
+}): JSX.Element;
+export declare function MarketView({ t, titleOf, manifests, installable, capabilities, runtimePluginMarket, freshness, onChanged, onPending, updates, modulesCheck, pluginsCheck, onCheck, installed, installedRead, workbench, selfUpdate, plugins, settling, installing, mock, defaults, changed, }: MarketViewProps): JSX.Element;

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

@@ -41,7 +41,6 @@ export declare function latestCheckSummary(modules: readonly InstalledWorkbenchM
 export declare function checkedPluginCount(plugins: readonly InstalledPlugin[] | null | undefined): number;
 export declare function installedRows(modules: readonly InstalledWorkbenchModule[], manifests: readonly UnitManifest[], listed: ReadonlySet<string>, names?: MarketNameMap | undefined, defaults?: ReadonlySet<string>, changed?: Readonly<Record<string, number>>): MarketRow[];
 export declare function marketSwitchLocked(row: MarketRow): boolean;
-export declare function marketAsksAgent(row: MarketRow): boolean;
 export declare function marketActions(row: MarketRow): MarketRowAction[];
 export declare function capabilityOutdated(capabilities: CapabilityMap | null, unit: string): boolean;
 export declare function marketCatalog(manifests: readonly UnitManifest[], installable: ReadonlySet<string> | null | undefined): readonly UnitManifest[];

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

@@ -5,6 +5,7 @@ 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 declare const UPDATE_ACTIONS: readonly MarketRowAction[];
 export interface HeldRow {
     readonly id: string;
     readonly row: MarketRow;
@@ -48,5 +49,3 @@ export declare function pendingRowOf(input: {
     readonly rows: readonly MarketRow[];
     readonly names: MarketNameMap;
 }): MarketRow | undefined;
-export declare function askAgentReason(row: MarketRow, t: Translate): string;
-export declare function askAgentText(row: MarketRow, t: Translate): string;

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

@@ -1,5 +1,5 @@
 import type { Translate, WorkspaceView } from '@dsh-workbench/shared';
-import type { Attention } from '../../../modules/sessions';
+import { type Attention } from '../../../modules/sessions';
 export interface ProjectSwitcherProps {
     items: readonly WorkspaceView[];
     current: WorkspaceView | null;

package/dist/types/app/layouts/sidebar/workspace-groups.d.ts

@@ -9,7 +9,10 @@ export interface WorkspaceSectionPlan<T> {
     readonly heading: string | null;
     readonly items: readonly T[];
 }
+export interface WorkspaceSectionOptions<T> {
+    readonly rankOf?: ((item: T) => number) | undefined;
+}
 export declare function workspaceSections<T extends {
     readonly path: string;
     readonly title: string;
-}>(items: readonly T[], headings: WorkspaceHeadings): readonly WorkspaceSectionPlan<T>[];
+}>(items: readonly T[], headings: WorkspaceHeadings, options?: WorkspaceSectionOptions<T>): readonly WorkspaceSectionPlan<T>[];

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

@@ -1,4 +1,5 @@
 export type { UnitModuleFace, UnitMountDeps, UnitMountResult } from '@dsh-workbench/shared/host';
+export type { FlowAction, FlowActionContext, FlowActionRegistry, FlowActionStep, FlowCheck, FlowDefinition, FlowForEach, FlowHost, FlowPoll, FlowPredicate, FlowProblem, FlowResult, FlowRetry, FlowRunOptions, FlowScope, FlowStep, FlowStepEvent, FlowSubFlowStep, FlowValue, HostKit, } from '@dsh-workbench/shared/host';
 export type { ExtensionCaller, ExtensionCallOptions, ExtensionNeed, ExtensionSession, CommandReader, ExtensionValue, GitReader, LibReader } from '@dsh-workbench/shared';
 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';

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

@@ -1,10 +1,10 @@
 import type { DshShell } from '@dsh-workbench/shared';
-import { type BrowserStep } from './diy-browser';
+import { type LineMaker, type BrowserStep } from './diy-browser';
 export declare const ACT_TIMEOUT_MS = 15000;
 export interface ActStep extends BrowserStep {
     readonly payload: Record<string, unknown> | undefined;
 }
-export declare function actBrowser(shell: DshShell, command: string, session: string, argv: readonly string[], timeoutMs?: number): Promise<ActStep>;
+export declare function actBrowser(shell: DshShell, command: string, session: string, argv: readonly string[], timeoutMs?: number, line?: LineMaker): Promise<ActStep>;
 export declare function actErrorOf(step: ActStep): string;
 export declare const SWEEP_TIMEOUT_MS = 4000;
 export declare function stopNetworkExact(shell: DshShell, file: string, timeoutMs?: number): Promise<boolean>;

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

@@ -8,7 +8,9 @@ export interface BrowserStep {
     readonly timedOut: boolean;
     readonly truncated: boolean;
 }
-export declare function runBrowserStep(shell: DshShell, command: string, argv: readonly string[], timeoutMs?: number): Promise<BrowserStep>;
+export type LineMaker = (command: string, argv: readonly string[]) => string;
+export declare function plainLine(command: string, argv: readonly string[]): string;
+export declare function runBrowserStep(shell: DshShell, command: string, argv: readonly string[], timeoutMs?: number, line?: LineMaker): Promise<BrowserStep>;
 export declare function jsonOf(raw: string): Record<string, unknown> | undefined;
 export declare function textOf(value: unknown): string;
 export interface BoundTab {
@@ -17,7 +19,7 @@ export interface BoundTab {
     readonly title: string;
     readonly reason: string;
 }
-export declare function bindCurrentTab(shell: DshShell, command: string, session: string): Promise<BoundTab>;
+export declare function bindCurrentTab(shell: DshShell, command: string, session: string, timeoutMs?: number, line?: LineMaker): Promise<BoundTab>;
 export interface WorkbenchPage {
     readonly ok: boolean;
     readonly url: string;

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

@@ -1,7 +1,7 @@
 import type { DshHostContext, DshShell, DshToolRunContext } from '@dsh-workbench/shared';
 import type { DebugState } from '@dsh-workbench/shared/host';
 import { type BoardFactState, type BoardProbe, type BoardSituation } from '@dsh-workbench/shared/host';
-import { type WorkbenchPage } from './diy-browser';
+import { type LineMaker, type WorkbenchPage } from './diy-browser';
 export type BoardState = BoardFactState;
 export interface PageHandle {
     readonly root: string;
@@ -11,6 +11,7 @@ export interface PageHandle {
     readonly shell: DshShell;
     readonly command: string;
     readonly session: string;
+    readonly line?: LineMaker;
     readonly bound: boolean;
     readonly board: BoardState;
     readonly boardPath: string;

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

@@ -1,5 +1,6 @@
 import type { DshHostContext, DshShell } from '@dsh-workbench/shared';
 import type { RecordState, RecordStore } from '@dsh-workbench/shared/host';
+import { type LineMaker } from './diy-browser';
 import type { CaptureEntry } from './diy-record-capture';
 import type { RecordCall, RecordListRow, RecordPageRead } from './diy-record-text';
 export declare const OPEN_TIMEOUT_MS = 30000;
@@ -15,7 +16,7 @@ export declare function captureFileOf(artifactsDir: string, unit: string): strin
 export declare function lastCaptureFileOf(file: string): string;
 export declare function shotFileOf(captureFile: string, unit: string, n: number): string;
 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 declare function startRecordCapture(shell: DshShell, command: string, session: string, file: string, makeLine?: LineMaker): Promise<boolean>;
 export interface WatchFinishDeps {
     readonly ctx: DshHostContext;
     readonly shell: DshShell;

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

@@ -1,5 +1,6 @@
 import type { DshHostContext } from '@dsh-workbench/shared';
 import type { DebugStore } from '@dsh-workbench/shared/host';
+export declare function browserBridgeOn(ctx: DshHostContext): boolean;
 import type { PublishPreview } from '@dsh-workbench/shared/contract/protocol/market-index';
 import type { MarketService } from './market';
 import type { PanelsService } from './service';

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

@@ -25,7 +25,7 @@ export declare function parseDependencyId(id: string): {
     readonly kind: DependencyKind;
     readonly name: string;
 } | undefined;
-export declare function findDependency(manifests: readonly UnitManifest[], id: string, isReleased?: ((unit: string) => boolean) | undefined): DependencyTarget | undefined;
+export declare function findDependency(manifests: readonly UnitManifest[], id: string, isReleased?: ((unit: string) => boolean) | undefined, packagePrefix?: string | undefined): DependencyTarget | undefined;
 export declare function affectedUnitsOf(manifests: readonly UnitManifest[], request: {
     readonly id?: string | undefined;
     readonly unit?: string | undefined;

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

@@ -12,6 +12,8 @@ export declare function createEnvDropper(options: {
     readonly references?: (() => PluginReferences) | undefined;
     readonly command: string;
     readonly run: (line: string, optional?: boolean) => Promise<void>;
+    readonly libUninstallCommand: (need: Need) => string;
+    readonly pluginPackagePrefix?: string | undefined;
     readonly logger?: {
         info?(message: string): void;
         warn?(message: string): void;

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

@@ -16,7 +16,7 @@ export declare function createMarketService(options: {
     manifestsNow?: (() => readonly UnitManifest[]) | undefined;
     probe?: UnitMountDeps['probe'];
     shell?: DshShell | undefined;
-    command?: string | undefined;
+    command: string;
     onInstalled?: (unit: string) => void;
     onUninstalled?: (unit: string) => void;
     isReleased?: (unit: string) => boolean;

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

@@ -1,4 +1,5 @@
 import type { PluginLedgerEntry, WorkspaceStore } from '@dsh-workbench/shared/host';
+import { type PluginFiles } from './plugin-name';
 export interface PluginLedgerIntent {
     readonly package: string;
     readonly registry?: string | undefined;
@@ -6,6 +7,7 @@ export interface PluginLedgerIntent {
 }
 export interface PluginLedger {
     readonly home: string;
+    readonly pluginFiles?: PluginFiles | undefined;
     list(): readonly PluginLedgerEntry[];
     all(): readonly PluginLedgerEntry[];
     read(pkg: string): PluginLedgerEntry | undefined;
@@ -19,4 +21,5 @@ export interface PluginLedger {
 export declare function createPluginLedger(options: {
     readonly store: WorkspaceStore;
     readonly home: string;
+    readonly pluginFiles?: PluginFiles | undefined;
 }): PluginLedger;

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

@@ -3,6 +3,10 @@ export interface PluginEntryRef {
     readonly local?: boolean | undefined;
     readonly name?: string | undefined;
 }
-export declare function pluginDirOf(entry: PluginEntryRef): string;
-export declare function pluginOnDisk(entry: PluginEntryRef): boolean;
-export declare function pluginNameOf(entry: PluginEntryRef): string | undefined;
+export interface PluginFiles {
+    readonly dir?: string | undefined;
+    readonly manifest?: string | undefined;
+}
+export declare function pluginDirOf(entry: PluginEntryRef, files: PluginFiles | undefined): string;
+export declare function pluginOnDisk(entry: PluginEntryRef, files: PluginFiles | undefined): boolean;
+export declare function pluginNameOf(entry: PluginEntryRef, files: PluginFiles | undefined): string | undefined;

package/dist/types/modules/sessions/index.d.ts

@@ -1,3 +1,3 @@
 export { currentSessionId, orderByRecency, sessionNode, orderSessionRows, sessionRows, workspaceOfSession, sessionStatuses, visiblePendingKind, type SessionNode, type SessionStatusDot, } from './model/session-node';
 export { scrollEdgesOf, type ScrollEdges } from './model/scroll-edges';
-export { attentionLabel, attentionOf, attentionOfSession, attentionSessionIdOf, attentionWordLabel, longTaskPresenceOf, type Attention, type AttentionInput, type AttentionSeverity, type LongTaskPresence, type WorkspaceAttention, } from './model/attention';
+export { attentionLabel, attentionListRank, attentionOf, attentionOfSession, attentionSessionIdOf, attentionWordLabel, longTaskPresenceOf, type Attention, type AttentionInput, type AttentionSeverity, type LongTaskPresence, type WorkspaceAttention, } from './model/attention';

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

@@ -26,6 +26,7 @@ export interface AttentionInput {
     readonly currentWorkspaceId: string | null;
     readonly longTasks?: LongTaskPresence | undefined;
 }
+export declare function attentionListRank(attention: WorkspaceAttention | null | undefined): number;
 export declare function attentionOfSession(summary: SessionSummary, statusById: SessionStatusSnapshot, sessions: SessionsSnapshot, longTaskIds?: ReadonlySet<string>): AttentionSeverity | undefined;
 export interface AttentionPickInput {
     readonly workspace: WorkspaceView | 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 installedPluginsOf(dir: string, prefix: string): readonly ReconPlugin[];

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

@@ -26,6 +26,13 @@ export interface ReconSite {
     readonly browser: boolean;
     readonly commands: readonly ReconCommand[];
 }
+export interface ReconSurface {
+    readonly name: string;
+    readonly pluginPrefix: string;
+    invoke(site: string, command?: string): string;
+    help(site: string): string;
+    readonly authorHint?: string;
+}
 export interface ReconPlugin {
     readonly name: string;
     readonly commands: readonly string[];
@@ -37,13 +44,13 @@ export interface ReconAnswer {
     readonly next: string;
     readonly text: string;
 }
-export declare function invocableOf(command: ReconCommand): string;
+export declare function invocableOf(command: ReconCommand, surface: ReconSurface): string;
 export declare function manifestCommandsOf(raw: string): readonly ReconCommand[];
-export declare function pluginNamesOf(entries: readonly string[]): readonly string[];
+export declare function pluginNamesOf(entries: readonly string[], prefix: string): readonly string[];
 export declare function pluginCommandsOf(files: readonly string[]): readonly string[];
 export declare function hostOf(url: string): string;
 export declare function keywordsOf(keyword: string, url: string): readonly string[];
 export declare function scoreOf(command: ReconCommand, word: string): number;
-export declare function reconOf(commands: readonly ReconCommand[], plugins: readonly ReconPlugin[], keywords: readonly string[]): ReconAnswer;
-export declare function nextOf(answer: ReconAnswer): string;
-export declare function textOf(answer: ReconAnswer): string;
+export declare function reconOf(commands: readonly ReconCommand[], plugins: readonly ReconPlugin[], keywords: readonly string[], surface: ReconSurface): ReconAnswer;
+export declare function nextOf(answer: ReconAnswer, surface: ReconSurface): string;
+export declare function textOf(answer: ReconAnswer, surface: ReconSurface): string;

package/dist/types/shared/api/host/flow/task.d.ts

@@ -0,0 +1,10 @@
+import { type FlowActionRegistry, type FlowDefinition, type LongTaskBase, type LongTaskDeps, type LongTaskRegistry } from '@dsh-workbench/shared/host';
+export declare function flowTaskDeps(actions: FlowActionRegistry): Pick<LongTaskDeps<LongTaskBase>, 'run' | 'outcome' | 'view' | 'stopped'>;
+export interface StartFlowOptions {
+    readonly runs: LongTaskRegistry<LongTaskBase>;
+    readonly flow: FlowDefinition;
+    readonly input: unknown;
+    readonly workspace: string;
+    readonly session?: string | undefined;
+}
+export declare function startFlow(options: StartFlowOptions): LongTaskBase;

package/dist/types/shared/api/host/flow/tool.d.ts

@@ -0,0 +1,12 @@
+import type { DshToolDefinition, DshToolRunContext } from '@dsh-workbench/shared';
+import { type FlowActionRegistry, type FlowDefinition, type LongTaskBase, type LongTaskRegistry } from '@dsh-workbench/shared/host';
+export interface FlowToolOptions {
+    readonly name: string;
+    readonly description: string;
+    readonly flow: FlowDefinition;
+    readonly actions: FlowActionRegistry;
+    readonly runs: LongTaskRegistry<LongTaskBase>;
+    readonly workspaceOf?: ((exec: DshToolRunContext | undefined) => string | null) | undefined;
+    readonly sessionOf?: ((exec: DshToolRunContext | undefined) => string | null) | undefined;
+}
+export declare function flowTool(options: FlowToolOptions): DshToolDefinition;

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

@@ -1,10 +1,10 @@
 import type { DshHostContext } from '@dsh-workbench/shared';
 import type { FactLog, ProfilePort, RouteTable } from '@dsh-workbench/shared/host';
-import type { OpencliResolution } from '@dsh-workbench/shared/host';
+import type { RuntimeStatus } from '@dsh-workbench/shared/host';
 export declare function createHostRoutes(input: {
     readonly ctx: DshHostContext;
     readonly facts: FactLog;
-    readonly opencli: OpencliResolution;
+    readonly runtimes: Readonly<Record<string, RuntimeStatus>>;
     readonly running: string | undefined;
     readonly profile: ProfilePort;
 }): RouteTable;

package/dist/types/shared/api/host/plugin-term.d.ts

@@ -0,0 +1,2 @@
+import type { DshHostContext } from '@dsh-workbench/shared';
+export declare function pluginTermOf(ctx: DshHostContext): string;

package/dist/types/shared/api/host/runtime-surface.d.ts

@@ -0,0 +1,3 @@
+import type { DshHostContext } from '@dsh-workbench/shared';
+import type { RuntimeCommandSurface } from '@dsh-workbench/shared/host';
+export declare function surfaceOf(ctx: DshHostContext): RuntimeCommandSurface | undefined;

package/dist/types/shared/hooks/locale-text.d.ts

@@ -0,0 +1,3 @@
+import type { RuntimeText } from '@dsh-workbench/shared';
+export declare function setRuntimeTextResolver(next?: (text: RuntimeText) => string): void;
+export declare function runtimeText(text: RuntimeText): string;

package/dist/types/shared/hooks/runtime-queries.d.ts

@@ -0,0 +1,6 @@
+import type { ApiResponse, RuntimeCapabilities, RuntimeProfile } from '@dsh-workbench/shared';
+export type RuntimeCapabilitiesPayload = {
+    readonly capabilities: RuntimeCapabilities;
+    readonly runtimeProfile?: RuntimeProfile | null;
+};
+export declare function readRuntimeCapabilities(): Promise<ApiResponse<RuntimeCapabilitiesPayload>>;

package/dist/types/shared/hooks/runtime-terms.d.ts

@@ -0,0 +1,2 @@
+import type { Translate } from '@dsh-workbench/shared';
+export declare function runtimeTermsOf(t: Translate): Readonly<Record<string, string>>;

package/dist/types/shared/hooks/use-runtime-capabilities.d.ts

@@ -0,0 +1,6 @@
+import type { RuntimeCapabilities, RuntimeProfile } from '@dsh-workbench/shared';
+export declare function pluginMarketOf(capabilities: RuntimeCapabilities | undefined): boolean;
+export declare function runtimeCapabilitiesValue(): RuntimeCapabilities | undefined;
+export declare function runtimeProfileValue(): RuntimeProfile | undefined;
+export declare function resetRuntimeCapabilities(): void;
+export declare function useRuntimeCapabilities(): RuntimeCapabilities | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "1.1.8",
+  "version": "1.1.9",
   "description": "个人工作台：Agent 工作台（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -100,8 +100,8 @@
     "proper-lockfile": "^4.1.2",
     "which": "^7.0.0",
     "write-file-atomic": "^8.0.0",
-    "@dsh-workbench/shared": "1.1.8",
-    "@dsh-workbench/adapters-default": "1.1.8"
+    "@dsh-workbench/adapters-default": "1.1.9",
+    "@dsh-workbench/shared": "1.1.9"
   },
   "license": "MIT",
   "repository": {
@@ -113,6 +113,9 @@
   "bugs": {
     "url": "https://github.com/novaeth/dsh-workbench/issues"
   },
+  "workbench": {
+    "adapterSet": "@dsh-workbench/adapters-default"
+  },
   "scripts": {
     "build": "node scripts/build.mjs && node scripts/build-types.mjs",
     "build:host": "node scripts/build.mjs host",

package/scripts/seed-workshop.sh

@@ -524,7 +524,7 @@ fi
 # 且那句 pnpm 前缀每次都要写对）。这里给一个**与 cwd 无关**的同名入口，启动器把它
 # 挂进 PATH —— 于是"在工坊里"和"在别的目录里"都叫得动同一个工具链。
 #
-# 转发脚本而不是软链：同 `bin/opencli-isolated` 那条坑 —— pnpm publish 之后包里的脚本没有 x 位，
+# 转发脚本而不是软链：同运行时包装那条坑 —— pnpm publish 之后包里的脚本没有 x 位，
 # 软链过去一执行就是 Permission denied。x 位由 chmod 当场给。
 # ⚠️ 先 rm -f：旧版本留下的软链还在时，`>` 会顺着软链把真脚本覆盖掉。
 ENTRY_DIR="$WORKBENCH_HOME/bin"

package/skills/workbench-module-diy/DESIGN.md

@@ -14,10 +14,12 @@
 | agent 写平台（提交、发布、改配置） | DIY | 预览 + 确认两拍（[TOOLS.md](TOOLS.md) §5–§7） |
 | 用户已在浏览器登录过该系统，只是不知道数据在哪 | DIY | 复用登录探（[DATASOURCE.md](DATASOURCE.md)） |
 | 要**新凭据**（账号 / 密钥 / token） | 工程 | 停；说清谁配什么 |
-| 多步长流程（要等、中途要人、失败要续） | 工程 | 同上 |
+| 多步、要等、要重试、以后还要跑 | 先问 | 一次性 → 直接用工具跑；固化 → DIY 的 workflow（[FLOW.md](FLOW.md)）；要新凭据 / 新服务 → 工程 |
 | 新服务 / 新进程 / 新依赖 | 工程 | 同上 |
 | 改工作台外壳，或改已发布模块 | 工程 | 同上 |
 
+多步长流程不是一律工程：复用现有登录、没有新凭据、要固化 → DIY 的 workflow；只有新凭据 / 新服务 / 新依赖才停。
+
 输出：一句结论 + 下一步 + 预计发生什么。
 
 ## 1 分工

package/skills/workbench-module-diy/FLOW.md

@@ -0,0 +1,117 @@
+# Workflow：先问一次性还是固化
+
+多步、要等、要重试、要写平台的活，**不要默认造模块**。先问一句，再决定。
+
+## 1 先问
+
+问用户（给推荐，允许一字通过）：
+
+> 这件事是一次性的，还是以后还要按同样步骤跑？我建议 **<一次性 / 固化>**，因为 **<重复信号 / 只此一次>**。
+
+只问一次；用户已经说过「就这一次 / 以后都要 / 固化」，照办，不追问。
+
+| 信号 | 建议 |
+|---|---|
+| 用户说「以后 / 每次 / 每周 / 按这个流程 / 固化 / 做成按钮」 | 固化 |
+| 三步以上、有先后依赖 | 固化 |
+| 要等、轮询、重试、取消、中途登录 | 固化 |
+| 要写平台、要审批、要留痕 | 固化 |
+| 只这一次、还在探、单步读 / 写 | 一次性 |
+| 拿不准 | 先一次性，跑通后用户再要固化 |
+
+- **一次性**：不建模块、不写 flow；直接用现有工具 / 命令跑完，告诉用户「这次直接跑，没固化」。
+- **固化**：进入第 2 节；先给流程形状，再问一次「按这个固化吗？」。
+
+不要问「要不要用 FlowDefinition / 怎么写代码 / 选哪个引擎」——这些是实现，用户不决定。
+
+## 2 固化后长什么样
+
+一条 workflow = 模块宿主半侧的一份 `FlowDefinition` + 动作表 + 长任务 + 工具（可选卡片）。
+**v0 没有 flow 仓库，固化就是写进模块**，不是存一份 JSON。
+
+跑起来用户看到：
+
+- 一条长任务行：到哪步、重试第几次、要登录、可停止、失败原因。
+- 写平台前有一次审批（模块清单 `writes: true` + `needsApproval`）。
+- 工具返回 `runId`；再调可看同一条。
+
+固化前给用户看这个形状（一句话 + 步骤表），问一次：
+
+> 我建议固化成 N 步：A → B（每 5s 查，最多 5 次，找不到就触发）→ C；输入：…；写到：…；失败停在：…。按这个固化吗？
+
+## 3 怎么写
+
+只走宿主 kit（`mount(deps)` 的 `deps.flow`）与 `@dsh-workbench/core/contract` 的类型：
+
+- `FlowDefinition` / `FlowStep` / `FlowValue` / `FlowPredicate` 从 `@dsh-workbench/core/contract` 取。
+- `deps.flow.createActions()` / `deps.flow.check()` / `deps.flow.run()`。
+
+最小宿主半侧（长任务与工具的完整签名见 [TOOLS.md](TOOLS.md) §9）：
+
+```ts
+import type { FlowDefinition, UnitModuleFace } from '@dsh-workbench/core/contract';
+
+const flow: FlowDefinition = {
+  id: 'release',
+  title: '发布',
+  target: { $ref: 'in.env' },
+  steps: [
+    { id: 'read', action: 'read' },
+    {
+      id: 'wait',
+      action: 'wait',
+      poll: {
+        everyMs: 5000,
+        maxMs: 300000,
+        until: { $eq: [{ $ref: 'value.state' }, { $lit: 'done' }] },
+      },
+    },
+  ],
+};
+
+export const face: UnitModuleFace = {
+  unit: 'release',
+  mount(deps) {
+    const actions = deps.flow.createActions();
+    actions.register('read', async () => ({ ok: true }));
+    actions.register('wait', async () => ({ state: 'done' }));
+    return { routes: {}, registerTools: () => [] };
+  },
+};
+```
+
+在模块 `mount` 里：
+
+- `const runs = deps.longTasks.create({ key, run, view, outcome, stopped })`；`run` 调 `deps.flow.run`，把 `onStep` 映射到长任务的 `onStep`；返回 `status === 'failed'` 时 throw，让注册表标 failed。
+- `registerTools` 返回一把工具：`execute` 里 `runs.start`，返回 `{ ok, runId, status, text }`；再按 `runId` 查。
+- 写平台的工具：清单 `writes: true` + `needsApproval` / `approvalDetail`；动作里不要自己再问一遍。
+- 校验：`deps.flow.check(flow, actions)`；有问题先修，不装。
+
+### v0.1 能用的形状
+
+| 需要 | 写法 |
+|---|---|
+| 等 / 轮询 | `poll: { everyMs, maxMs, until }` |
+| 超时继续 | `poll.onTimeout: 'continue'`，后面用 `when: { $not: { $exists: ... } }` |
+| 不限时（审核） | `poll.maxMs: 0` |
+| 逐项 + 轮询 | `forEach` 与 `poll` 同一步；每项单独轮询 |
+| 子流程 | `{ id, flow: subFlow, with: { ... } }`；结果在 `steps.<id>` |
+| 提前结束 | `flow.stopWhen` |
+| 登录 | 动作里 `ctx.login(url)`；长任务进 `needs-login`，动作自己等 / 重试 |
+
+分支（`already_merged` / `can_merge` / `REVIEW_WAITING`）继续写在动作里；flow 只保留稳定的外层顺序。
+
+## 4 不要做
+
+- 为一次性任务建模块 / 写 flow；先跑。
+- 不问用户就固化；也不要把「要不要固化」问成技术选型。
+- 把分支、重试、登录循环全塞进 flow 配置；flow 表达不了的就放动作。
+- 在 flow 里存密钥 / token；凭据走已有登录或 `needs`。
+- 让 flow 绕过审批；写工具的审批在清单，不在动作里。
+
+## 5 验收
+
+- `deps.flow.check` 无问题；`dsh-wb-module build` / `check` 绿。
+- 真跑一遍：长任务行出现、进度对、能停止、失败给原因；要登录时给链接。
+- 写平台前审批屏能看到对象 / 环境 / 影响；拒绝后不跑。
+- 用户只说过需求；没被问实现。