@dsh-workbench/core 0.1.0

package/dist/types/app/units/index.d.ts

@@ -0,0 +1,4 @@
+import type { UnitClientFace } from '@dsh-workbench/shared';
+export declare function assembleClientUnits(registry: {
+    register(face: UnitClientFace): () => void;
+}): void;

package/dist/types/app/units/registry.d.ts

@@ -0,0 +1,12 @@
+import type { UnitManifest } from '@dsh-workbench/shared';
+import type { UnitClientFace } from '@dsh-workbench/shared';
+import { type BoardRegistry } from '../layouts/rightbar/registry';
+export interface ClientUnitRegistry {
+    register(face: UnitClientFace): () => void;
+    all(): readonly UnitClientFace[];
+    manifests(): readonly UnitManifest[];
+    readonly board: BoardRegistry;
+    subscribe(listener: () => void): () => void;
+    version(): number;
+}
+export declare function createClientUnitRegistry(): ClientUnitRegistry;

package/dist/types/modules/panels/__tests__/config.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/modules/panels/__tests__/face.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

package/dist/types/modules/panels/__tests__/market-tools.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/modules/panels/__tests__/market.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/modules/panels/__tests__/prefs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/modules/panels/__tests__/routes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/modules/panels/__tests__/service.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/modules/panels/__tests__/tools.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,2 @@
+import type { UnitHostFace } from '@dsh-workbench/shared/host';
+export declare const panelsHost: UnitHostFace;

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

@@ -0,0 +1,18 @@
+import type { UnitManifest } from '@dsh-workbench/shared';
+export type ShownPanels = readonly string[];
+export interface PanelEntry {
+    readonly id: string;
+    readonly titleKey: string;
+    readonly order: number;
+    readonly shown: boolean;
+    readonly source: 'default' | 'user';
+    readonly hasCard: boolean;
+}
+export declare function parseShown(raw: unknown): string[];
+export declare function parseReleased(raw: unknown): string[];
+export declare function resolvePanels(manifests: readonly UnitManifest[], panels: ShownPanels | null): PanelEntry[];
+export declare function withoutReleased(released: ShownPanels, id: string): string[];
+export declare function withReleased(released: ShownPanels, id: string): string[];
+export declare function withShown(panels: ShownPanels, id: string): string[];
+export declare function withHidden(panels: ShownPanels, id: string): string[];
+export declare function withMoved(panels: ShownPanels, id: string, index: number): string[];

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

@@ -0,0 +1,8 @@
+import type { UnitCall } from '@dsh-workbench/shared/host';
+import type { HandoffEntry } from '@dsh-workbench/shared/host';
+import type { UnitManifest } from '@dsh-workbench/shared';
+export declare const PANELS_FACT = "panels";
+export declare function panelsHandoffEntry(target?: {
+    readonly path?: string | undefined;
+}): HandoffEntry | undefined;
+export declare function panelsFactsOf(call: UnitCall, manifests: readonly UnitManifest[]): readonly string[] | undefined;

package/dist/types/modules/panels/model/handoff.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,41 @@
+import type { UnitCapability } from '../../../shared/api/host/probe-units';
+import { type ProvisionRequest } from '@dsh-workbench/shared/host';
+import type { UnitManifest } from '@dsh-workbench/shared';
+import { type PluginSourceCommand, type PluginSourceProblem } from '@dsh-workbench/shared/host';
+export type DependencyKind = 'plugin' | 'lib';
+export interface SharedDependency {
+    readonly id: string;
+    readonly kind: DependencyKind;
+    readonly name: string;
+    readonly status: 'ok' | 'outdated' | 'unsatisfied' | 'missing' | 'unchecked';
+    readonly installed?: string;
+    readonly latest?: string;
+    readonly purpose?: string;
+    readonly usedBy: readonly string[];
+}
+export interface DependencyTarget {
+    readonly id: string;
+    readonly kind: DependencyKind;
+    readonly name: string;
+    readonly declarers: readonly UnitManifest[];
+    readonly users: readonly UnitManifest[];
+}
+export declare function dependencyId(kind: DependencyKind, name: string): string;
+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 affectedUnitsOf(manifests: readonly UnitManifest[], request: ProvisionRequest): readonly string[];
+export declare function sharedDependencies(options: {
+    readonly manifests: readonly UnitManifest[];
+    readonly capabilities: ReadonlyMap<string, UnitCapability>;
+    readonly isReleased?: ((unit: string) => boolean) | undefined;
+}): SharedDependency[];
+export type DependencyPlan = readonly PluginSourceCommand[] | undefined;
+export declare function dependencyCommandPlan(options: {
+    readonly target: DependencyTarget;
+    readonly capability: UnitCapability | undefined;
+    readonly command: string;
+}): DependencyPlan;
+export declare function sourceProblemText(problem: PluginSourceProblem, env: string | undefined): string;

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

@@ -0,0 +1,14 @@
+import type { ProvisionRequest } from '@dsh-workbench/shared/host';
+import type { MarketEntry, MarketService } from './market';
+import type { SharedDependency } from './market-dependency';
+export type ProvisionResult = {
+    readonly ok: true;
+    readonly action: 'install' | 'update' | 'uninstall';
+    readonly module: MarketEntry;
+    readonly keptFor?: readonly string[];
+} | {
+    readonly ok: true;
+    readonly action: 'update-dependency';
+    readonly shared: readonly SharedDependency[];
+};
+export declare function dispatchMarket(market: MarketService, request: ProvisionRequest): Promise<ProvisionResult>;

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

@@ -0,0 +1,3 @@
+import type { DshHostContext } from '@dsh-workbench/shared';
+import type { MarketService } from './market';
+export declare function registerMarketTools(ctx: DshHostContext, market: MarketService): Array<() => void>;

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

@@ -0,0 +1,49 @@
+import type { DshShell } from '@dsh-workbench/shared';
+import type { PluginSource, UnitManifest } from '@dsh-workbench/shared';
+import type { UnitCapability } from '../../../shared/api/host/probe-units';
+import type { ProvisionAction } from '@dsh-workbench/shared/host';
+import type { UnitMountDeps } from '@dsh-workbench/shared/host';
+import { type SharedDependency } from './market-dependency';
+export 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 capability: UnitCapability;
+}
+export interface UninstallResult {
+    readonly entry: MarketEntry;
+    readonly keptFor: readonly string[];
+}
+export interface MarketService {
+    list(): Promise<{
+        readonly modules: MarketEntry[];
+        readonly shared: readonly SharedDependency[];
+    }>;
+    install(unit: string): Promise<MarketEntry>;
+    update(unit: string): Promise<MarketEntry>;
+    uninstall(unit: string): Promise<UninstallResult>;
+    updateDependency(id: string): Promise<readonly SharedDependency[]>;
+}
+export declare function createMarketService(options: {
+    manifests: readonly UnitManifest[];
+    probe?: UnitMountDeps['probe'];
+    shell?: DshShell | undefined;
+    command?: string | undefined;
+    onInstalled?: (unit: string) => void;
+    onUninstalled?: (unit: string) => void;
+    isReleased?: (unit: string) => boolean;
+    logger?: {
+        info?(message: string): void;
+        warn?(message: string): void;
+    } | undefined;
+}): MarketService;

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

@@ -0,0 +1,13 @@
+import type { PanelsService } from './service';
+export declare const PANELS_PREF_RESOURCE = "panels";
+export interface PanelsPrefAction {
+    readonly action: 'show' | 'hide' | 'enable' | 'disable' | 'move' | 'reset';
+    readonly id?: string;
+    readonly index?: number;
+    readonly path?: string;
+}
+export declare function parsePanelsPrefAction(payload: unknown): PanelsPrefAction;
+export declare function applyPanelsPref(panels: PanelsService, payload: unknown): {
+    ok: true;
+    units: unknown;
+};

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

@@ -0,0 +1,4 @@
+import { type RouteTable } from '@dsh-workbench/shared/host';
+import type { ValueHandoff } from '@dsh-workbench/shared/host';
+import type { PanelsService } from './service';
+export declare function panelRoutes(panels: PanelsService, values?: ValueHandoff): RouteTable;

package/dist/types/modules/panels/model/routes.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,25 @@
+import type { WorkspaceStore } from '@dsh-workbench/shared/host';
+import type { UnitManifest } from '@dsh-workbench/shared';
+import { type PanelEntry } from './config';
+export declare const PANELS_MODULE_ID = "panels";
+export declare const PANELS_FILE = "config.json";
+export declare const RELEASED_FILE = "released.json";
+export interface PanelsService {
+    list(workspace: string | null): PanelEntry[];
+    isReleased(id: string): boolean;
+    release(id: string): void;
+    accept(id: string): void;
+    subscribe(listener: () => void): () => void;
+    isEnabled(id: string, workspace: string | null): boolean;
+    show(id: string, workspace: string | null): PanelEntry[];
+    hide(id: string, workspace: string | null): PanelEntry[];
+    move(id: string, index: number, workspace: string | null): PanelEntry[];
+    resetWorkspace(workspace: string | null): PanelEntry[];
+}
+export declare function createPanelsService(options: {
+    manifests: () => readonly UnitManifest[];
+    store: WorkspaceStore;
+    logger?: {
+        warn?(message: string): void;
+    } | undefined;
+}): PanelsService;

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

@@ -0,0 +1,4 @@
+import type { DshHostContext } from '@dsh-workbench/shared';
+import type { ValueHandoff } from '@dsh-workbench/shared/host';
+import type { PanelsService } from './service';
+export declare function registerPanelTools(ctx: DshHostContext, panels: PanelsService, values?: ValueHandoff): Array<() => void>;

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

@@ -0,0 +1,4 @@
+import type { UnitManifest } from '@dsh-workbench/shared';
+export declare const PANELS_TOOL = "workbench_panels";
+export declare const MODULES_TOOL = "workbench_modules";
+export declare const panelsUnit: UnitManifest;

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

@@ -0,0 +1 @@
+export { currentSessionId, sessionNode, orderSessionRows, sessionRows, workspaceOfSession, sessionStatuses, visiblePendingKind, type SessionNode, type SessionStatusDot, } from './model/session-node';

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

@@ -0,0 +1,25 @@
+import type { SessionStatusSnapshot, SessionSummary, SessionsSnapshot, Translate } from '@dsh-workbench/shared';
+export interface SessionNode {
+    readonly id: string;
+    readonly title: string;
+    readonly blank: boolean;
+    readonly running: boolean;
+    readonly runningSubagentCount: number;
+    readonly completed: boolean;
+    readonly pinned: boolean;
+    readonly updatedAt: number;
+    readonly pendingInteraction: string | undefined;
+}
+export interface SessionStatusDot {
+    readonly state: 'ongoing' | 'warning' | 'done' | 'idle';
+    readonly label: string;
+}
+export declare function visiblePendingKind(kind: string | undefined): string | undefined;
+export declare function sessionNode(summary: SessionSummary, statusById: SessionStatusSnapshot, list: SessionsSnapshot, pinnedIds: ReadonlySet<string>, archivedIds: ReadonlySet<string>): SessionNode;
+export declare function sessionStatuses(node: SessionNode, t: Translate): SessionStatusDot[];
+export declare function currentSessionId(list: SessionsSnapshot, panelActive: boolean): string | undefined;
+export declare function orderSessionRows(rows: readonly SessionSummary[], pinnedIds: ReadonlySet<string>, archivedIds: ReadonlySet<string>): SessionSummary[];
+export declare function workspaceOfSession<T extends {
+    readonly sessionIds: readonly string[];
+}>(workspaces: readonly T[], sessionId: string | undefined): T | null;
+export declare function sessionRows(workspaceSessionIds: readonly string[], list: SessionsSnapshot, archivedIds: ReadonlySet<string>, current?: string | undefined): SessionSummary[];

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

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/__tests__/i18n-keys.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/__tests__/context-ref.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/context-chips.d.ts

@@ -0,0 +1,10 @@
+import type { DshClientContext } from '@dsh-workbench/shared';
+import { type ContextRef } from '@dsh-workbench/shared';
+export declare const CONTEXT_SOURCE = "workbench";
+export type ChipResult = 'inserted' | 'unavailable';
+export interface ContextChipsDeps {
+    currentSessionId(): string | undefined;
+}
+export declare function installContextChips(ctx: DshClientContext, deps: ContextChipsDeps): void;
+export declare function addContextChip(ref: ContextRef, label: string): ChipResult;
+export declare function serializeChipRef(encoded: string): string;

package/dist/types/shared/api/host/__tests__/capability-force.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/cli-error.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/context-inject.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/data-root.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/events.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/fact-writes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/facts.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/plugin-source.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/preflight-fixtures.d.ts

@@ -0,0 +1,19 @@
+import { createFakeShell } from '@dsh-workbench/shared/host';
+export declare const GOOD_BRIDGE_REPORT: string;
+export declare const ALL_OK: {
+    stdout: string;
+}[];
+export declare const STALE_DAEMON_BRIDGE: string;
+export declare const BROKEN_BRIDGE: string;
+export declare function build(replies: Parameters<typeof createFakeShell>[0], install?: () => Promise<{
+    ok: boolean;
+    detail: string;
+}>, warmReads?: () => readonly (readonly string[])[]): {
+    fake: {
+        shell: import("@dsh-workbench/shared").DshShell;
+        calls: import("@dsh-workbench/shared/host").ShellCall[];
+        peak: () => number;
+        commands: () => string[];
+    };
+    preflight: import("../preflight").Preflight;
+};

package/dist/types/shared/api/host/__tests__/preflight-warm.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/preflight.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/probe-cache.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/probe-libs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/probe-units-cache.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/probe-units-npm-source.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/probe-units-release.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/probe-units.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/probe-verdict.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/provision-dependency.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/release.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/tool-approval.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/tool-kit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/tool-scope.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/tool-surface.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/unit-face.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/unit-readiness.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/unit-registry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/value-handoff.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/version-range.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/workspace-store.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/__tests__/write-result.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/context-inject.d.ts

@@ -0,0 +1,24 @@
+import { type ContextRef } from '@dsh-workbench/shared';
+import type { ContextRenderer } from '@dsh-workbench/shared/host';
+export declare const CONTEXT_SOURCE_KIND = "workbench";
+export interface ScannableMessage {
+    readonly source?: {
+        readonly kind?: string;
+    };
+    readonly content?: readonly {
+        readonly type?: string;
+        readonly text?: string;
+    }[];
+}
+export type { ContextRenderer };
+export declare function collectContextRefs(messages: readonly ScannableMessage[]): ContextRef[];
+export declare function buildContextMessage(text: string, summary: string): unknown;
+export interface ContextInjector {
+    inject(messages: readonly ScannableMessage[], agent: unknown): Promise<unknown | undefined>;
+}
+export declare function createContextInjector(options: {
+    renderers: ReadonlyMap<string, ContextRenderer>;
+    logger?: {
+        warn?(message: string): void;
+    } | undefined;
+}): ContextInjector;

package/dist/types/shared/api/host/events.d.ts

@@ -0,0 +1,9 @@
+import type { DshHostContext, DshRequest, DshResponse } from '@dsh-workbench/shared';
+import type { FactLog } from '@dsh-workbench/shared/host';
+export interface FactStream {
+    handler(req: DshRequest, res: DshResponse): void;
+    closeAll(): void;
+    size(): number;
+}
+export declare function createFactStream(log: FactLog): FactStream;
+export declare function registerFactStream(ctx: DshHostContext, log: FactLog): () => void;

package/dist/types/shared/api/host/git.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/http.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/mount-units.d.ts

@@ -0,0 +1,52 @@
+import type { DshHostContext } from '@dsh-workbench/shared';
+import type { UnitManifest } from '@dsh-workbench/shared';
+import { type RouteTable } from '@dsh-workbench/shared/host';
+import type { ContextRenderer, UnitHostFace, UnitMountDeps, UnitMountResult, UnitCall } from '@dsh-workbench/shared/host';
+import { type UnitReadiness } from './unit-readiness';
+export interface MountedUnit {
+    readonly face: UnitHostFace;
+    readonly result: UnitMountResult;
+    readonly readiness: UnitReadiness;
+}
+export interface UnitsPlan {
+    readonly mounted: readonly MountedUnit[];
+    readonly routes: RouteTable;
+    readonly gate: UnitMountResult['gate'];
+    readonly prefs: ReadonlyArray<{
+        readonly resource: string;
+        readonly unit: string;
+        handle(payload: unknown): unknown;
+    }>;
+    readonly actions: ReadonlyArray<{
+        readonly resource: string;
+        readonly unit: string;
+        handle(payload: unknown): unknown;
+    }>;
+    readonly provision: UnitMountResult['provision'];
+    readonly contextRenderers: ReadonlyMap<string, ContextRenderer>;
+    readonly owners: ReadonlyMap<string, string>;
+    readonly routesOfUnit: ReadonlyMap<string, readonly string[]>;
+    readonly factsOf: ReadonlyMap<string, (call: UnitCall) => readonly string[] | undefined>;
+    readonly skipped: ReadonlyArray<{
+        readonly id: string;
+        readonly missing: readonly string[];
+    }>;
+    readonly warmReads: () => readonly (readonly string[])[];
+    readonly disposeLongTasks: () => void;
+}
+export declare function mountUnits(faces: readonly UnitHostFace[], deps: {
+    ctx: DshHostContext;
+    logger?: {
+        info?(m: string): void;
+        warn?(m: string): void;
+    } | undefined;
+    manifests: () => readonly UnitManifest[];
+    opencliCommand?: string;
+    probe?: UnitMountDeps['probe'];
+    store?: UnitMountDeps['store'];
+    values?: UnitMountDeps['values'];
+    longTasks?: {
+        readonly scope: string;
+        readonly bump: (facts: readonly string[]) => void;
+    } | undefined;
+}): UnitsPlan;

package/dist/types/shared/api/host/opencli.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/api/host/preflight.d.ts

@@ -0,0 +1,58 @@
+import type { DshShell } from '@dsh-workbench/shared';
+export type PreflightStepId = 'opencli' | 'bridge' | 'warm';
+export type PreflightStepStatus = 'pending' | 'running' | 'ok' | 'warn' | 'failed';
+export interface PreflightStep {
+    readonly id: PreflightStepId;
+    readonly status: PreflightStepStatus;
+    readonly detail?: string;
+    readonly action?: string;
+    readonly command?: string;
+}
+export type PreflightFailure = 'permission' | 'network' | 'missing' | 'unknown';
+export declare function classifyFailure(text: string): PreflightFailure;
+export type PreflightGuidance = 'install' | 'path' | 'shell';
+export type PreflightBridgeIssue = 'daemon' | 'extension' | 'profile' | 'stale' | 'unknown';
+export declare function readBridgeReport(stdout: string): {
+    readonly ok: boolean;
+    readonly issues: readonly PreflightBridgeIssue[];
+    readonly detail: string;
+};
+export interface PreflightSnapshot {
+    readonly phase: 'idle' | 'checking' | 'installing' | 'ready' | 'failed';
+    readonly steps: readonly PreflightStep[];
+    readonly at: number;
+    readonly error?: string;
+    readonly failure?: PreflightFailure;
+    readonly guidance?: PreflightGuidance;
+    readonly bridgeIssues?: readonly PreflightBridgeIssue[];
+}
+export interface Preflight {
+    run(options?: {
+        force?: boolean;
+    }): Promise<PreflightSnapshot>;
+    snapshot(): PreflightSnapshot;
+}
+export declare const OPENCLI_INSTALL_COMMAND: string;
+export interface BridgeVerdict {
+    readonly ok: boolean;
+    readonly detail: string;
+    readonly issues: readonly PreflightBridgeIssue[];
+    readonly command?: string | undefined;
+}
+export declare function canWarm(bridge: {
+    ok: boolean;
+    issues: readonly PreflightBridgeIssue[];
+}): boolean;
+export declare function createPreflight(options: {
+    shell: DshShell;
+    command?: string;
+    installCommand?: string;
+    logger?: {
+        warn?(message: string): void;
+    } | undefined;
+    install?: (() => Promise<{
+        ok: boolean;
+        detail: string;
+    }>) | undefined;
+    warmReads?: (() => readonly (readonly string[])[]) | undefined;
+}): Preflight;

package/dist/types/shared/api/host/probe-cache.d.ts

@@ -0,0 +1,6 @@
+export interface TimedMemo<T> {
+    get(key: string, now?: number): T | undefined;
+    set(key: string, value: T, now?: number): void;
+    clear(): void;
+}
+export declare function createTimedMemo<T>(ttlMs: number): TimedMemo<T>;

package/dist/types/shared/api/host/probe-libs.d.ts

@@ -0,0 +1,11 @@
+import type { DshShell } from '@dsh-workbench/shared';
+export type { UnitCapability, UnitCommands, UnitLibState, UnitPluginState } from '@dsh-workbench/shared/host';
+import type { UnitLibState } from '@dsh-workbench/shared/host';
+import type { UnitLibNeed } from '@dsh-workbench/shared';
+export declare function installedLibVersion(name: string): string | undefined;
+export declare function probeLibs(options: {
+    readonly needs: readonly UnitLibNeed[];
+    readonly shell: DshShell;
+    readonly force: boolean;
+}): Promise<ReadonlyMap<string, UnitLibState>>;
+export declare function resetLibCache(): void;