@dsh-workbench/shared 0.3.1 → 0.3.2

package/dist/components/MockStrip.css

@@ -36,14 +36,4 @@
   border-color: transparent;
   background: var(--dsw-alias-brand-primary);
   color: var(--dsw-alias-label-primary-foreground);
-}
-
-.wb-mockChipOn:hover {
-  border-color: transparent;
-  background: var(--dsw-alias-brand-primary);
-  color: var(--dsw-alias-label-primary-foreground);
-}
-
-.wb-panelBody.wb-panelMany .wb-mockStrip {
-  display: none;
-}
+}

package/dist/host/browser-find.js

@@ -1,5 +1,5 @@
 import { parseJsonLoose } from '../lib/text.js';
-import { BROWSER_BRIDGE_SESSION } from './browser-read.js';
+import { BROWSER_READ_SESSION } from './browser-read.js';
 import { backgroundLine } from './opencli-window.js';
 import { runShell } from './shell.js';
 const DEFAULT_TIMEOUT_MS = 25000;
@@ -152,7 +152,7 @@ async function openOnce(shell, command, session, url, timeoutMs) {
 export async function browserFind(options) {
     const { shell, css, url, open = true } = options;
     const command = options.command ?? 'opencli';
-    const session = options.session ?? BROWSER_BRIDGE_SESSION;
+    const session = options.session ?? BROWSER_READ_SESSION;
     const limit = options.limit ?? DEFAULT_LIMIT;
     const textMax = options.textMax ?? DEFAULT_TEXT_MAX;
     const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;

package/dist/host/browser-read.d.ts

@@ -1,5 +1,6 @@
 import type { DshShell } from '../api/dsh.js';
-export declare const BROWSER_BRIDGE_SESSION = "workbench";
+export declare const BROWSER_SCREEN_SESSION = "workbench";
+export declare const BROWSER_READ_SESSION = "workbench-read";
 export interface BrowserReadResult {
     readonly ok: boolean;
     readonly code: string;

package/dist/host/browser-read.js

@@ -1,7 +1,8 @@
 import { parseJsonLoose, tailLines } from '../lib/text.js';
 import { backgroundLine } from './opencli-window.js';
 import { runShell } from './shell.js';
-export const BROWSER_BRIDGE_SESSION = 'workbench';
+export const BROWSER_SCREEN_SESSION = 'workbench';
+export const BROWSER_READ_SESSION = 'workbench-read';
 const DEFAULT_TIMEOUT_MS = 25000;
 const DEFAULT_RETRY_MS = 1200;
 const DEFAULT_SETTLE_MS = 900;
@@ -158,7 +159,7 @@ async function openOnce(shell, command, session, url, timeoutMs) {
 export async function browserRead(options) {
     const { shell, script, url, loginUrl, open = true } = options;
     const command = options.command ?? 'opencli';
-    const session = options.session ?? BROWSER_BRIDGE_SESSION;
+    const session = options.session ?? BROWSER_READ_SESSION;
     const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     const retryMs = options.retryMs ?? DEFAULT_RETRY_MS;
     const settleMs = options.settleMs ?? DEFAULT_SETTLE_MS;

package/dist/lib/lint-probe.d.ts

@@ -0,0 +1 @@
+export declare function useLintProbe(): number;

package/dist/lib/lint-probe.js

@@ -0,0 +1,6 @@
+import { useRef } from './react';
+export function useLintProbe() {
+    const probeRef = useRef(0);
+    probeRef.current = 1;
+    return probeRef.current;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/shared",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
   "license": "MIT",
   "type": "module",
@@ -40,7 +40,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json && node scripts/copy-css.mjs",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit --incremental --tsBuildInfoFile node_modules/.cache/tsconfig.tsbuildinfo",
     "test": "vitest run",
     "coverage": "vitest run --coverage",
     "barrels": "node scripts/barrels.mjs",

package/src/host/__tests__/browser-find.test.ts

@@ -1,4 +1,5 @@
 import { describe, expect, it } from 'vitest';
+import { BROWSER_SCREEN_SESSION } from '../browser-read.js';
 import {
   browserFind,
   cellRows,
@@ -317,3 +318,13 @@ describe('browserFind · 后台静默（问页 + 读 + 打开都不许抢焦点
     expect(backgroundless(commands)).toEqual([]);
   });
 });
+
+describe('browserFind · 读有它自己那条会话（不许碰屏那条）', () => {
+  it('默认那条命令里一条都不带屏那条会话名', async () => {
+    const { shell, commands } = fakeShell({ url: ['about:blank', SITE], find: [{ stdout: MATCH }] });
+    await browserFind({ shell, css: CSS, url: SITE, ...FAST });
+
+    expect(commands.length).toBeGreaterThan(0);
+    expect(commands.some((one) => one.includes(`'${BROWSER_SCREEN_SESSION}'`))).toBe(false);
+  });
+});

package/src/host/__tests__/browser-read.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { browserRead } from '../browser-read.js';
+import { BROWSER_READ_SESSION, BROWSER_SCREEN_SESSION, browserRead } from '../browser-read.js';
 
 interface Step {
   readonly stdout?: string;
@@ -45,7 +45,7 @@ describe('browserRead · 读成功', () => {
     expect(out.ok).toBe(true);
     expect(out.code).toBe('ok');
     expect(out.value).toEqual({ ok: true, n: 3 });
-    expect(commands[0]).toContain("'browser' 'workbench' 'eval'");
+    expect(commands[0]).toContain(`'browser' '${BROWSER_READ_SESSION}' 'eval'`);
   });
 
   it('脚本没回 ok 字段（例如直接回一个数）也算读到了', async () => {
@@ -123,6 +123,37 @@ describe('browserRead · 两拍（不在站点上就先打开）', () => {
   });
 });
 
+describe('browserRead · 读有它自己那条会话（不许碰屏那条）', () => {
+  it('默认那条不是工坊绑用户当前页用的那条', () => {
+    expect(BROWSER_READ_SESSION).not.toBe(BROWSER_SCREEN_SESSION);
+  });
+
+  it('两拍三条命令里一条都不带屏那条会话名', async () => {
+    const { shell, commands } = fakeShell([
+      { stdout: JSON.stringify({ ok: false, code: 'not-on-site' }) },
+      { stdout: 'opened' },
+      { stdout: JSON.stringify({ ok: true, n: 1 }) },
+    ]);
+    const out = await browserRead({ shell, script, url: URL, ...FAST });
+
+    expect(out.ok).toBe(true);
+    expect(commands.some((one) => one.includes(`'${BROWSER_SCREEN_SESSION}'`))).toBe(false);
+  });
+
+  it('调用点自己给的 session 说了算（模块可以自己开一条）', async () => {
+    const { shell, commands } = fakeShell([
+      { stdout: JSON.stringify({ ok: false, code: 'not-on-site' }) },
+      { stdout: 'opened' },
+      { stdout: JSON.stringify({ ok: true }) },
+    ]);
+    const out = await browserRead({ shell, script, url: URL, session: 'llm-wallet', ...FAST });
+
+    expect(out.ok).toBe(true);
+    expect(commands.every((one) => one.includes("'llm-wallet'"))).toBe(true);
+    expect(commands.some((one) => one.includes(`'${BROWSER_SCREEN_SESSION}'`))).toBe(false);
+  });
+});
+
 describe('browserRead · 命令这一层的问题', () => {
   it('刚重启时第一次失败：等一下再读一次就成功（实测的那个坑）', async () => {
     const { shell, commands } = fakeShell([

package/src/host/browser-find.ts

@@ -1,6 +1,6 @@
 import type { DshShell } from '../api/dsh.js';
 import { parseJsonLoose } from '../lib/text.js';
-import { BROWSER_BRIDGE_SESSION } from './browser-read.js';
+import { BROWSER_READ_SESSION } from './browser-read.js';
 import { backgroundLine } from './opencli-window.js';
 import { runShell } from './shell.js';
 
@@ -215,7 +215,7 @@ async function openOnce(
 export async function browserFind(options: BrowserFindOptions): Promise<BrowserFindResult> {
   const { shell, css, url, open = true } = options;
   const command = options.command ?? 'opencli';
-  const session = options.session ?? BROWSER_BRIDGE_SESSION;
+  const session = options.session ?? BROWSER_READ_SESSION;
   const limit = options.limit ?? DEFAULT_LIMIT;
   const textMax = options.textMax ?? DEFAULT_TEXT_MAX;
   const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;

package/src/host/browser-read.ts

@@ -3,7 +3,8 @@ import { parseJsonLoose, tailLines } from '../lib/text.js';
 import { backgroundLine } from './opencli-window.js';
 import { runShell } from './shell.js';
 
-export const BROWSER_BRIDGE_SESSION = 'workbench';
+export const BROWSER_SCREEN_SESSION = 'workbench';
+export const BROWSER_READ_SESSION = 'workbench-read';
 
 const DEFAULT_TIMEOUT_MS = 25000;
 const DEFAULT_RETRY_MS = 1200;
@@ -226,7 +227,7 @@ async function openOnce(
 export async function browserRead(options: BrowserReadOptions): Promise<BrowserReadResult> {
   const { shell, script, url, loginUrl, open = true } = options;
   const command = options.command ?? 'opencli';
-  const session = options.session ?? BROWSER_BRIDGE_SESSION;
+  const session = options.session ?? BROWSER_READ_SESSION;
   const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
   const retryMs = options.retryMs ?? DEFAULT_RETRY_MS;
   const settleMs = options.settleMs ?? DEFAULT_SETTLE_MS;

package/dist/components/StateDot.d.ts

@@ -1,5 +0,0 @@
-export type DotState = 'ongoing' | 'warning' | 'done' | 'idle' | string;
-export declare function StateDot({ state, size }: {
-    state: DotState;
-    size: number;
-}): JSX.Element;

package/dist/components/StateDot.js

@@ -1,10 +0,0 @@
-import { h } from '../lib/react.js';
-export function StateDot({ state, size }) {
-    if (state === 'ongoing') {
-        return (h("svg", { className: "wb-loading", viewBox: "0 0 24 24", width: size, height: size, "aria-hidden": "true", style: { display: 'block' } },
-            h("g", { className: "wb-loadingMotion" },
-                h("circle", { className: "wb-loadingTrack", cx: 12, cy: 12, r: 9.5 }),
-                h("circle", { className: "wb-loadingArc", cx: 12, cy: 12, r: 9.5 }))));
-    }
-    return (h("span", { className: "wb-stateDot", "data-state": state, style: { width: size, height: size }, "aria-hidden": "true" }));
-}

package/dist/host/__tests__/fakes.d.ts

@@ -1,41 +0,0 @@
-import type { DshShell } from '../../api/dsh.js';
-import type { Opencli } from '../../host/opencli.js';
-export interface ShellCall {
-    command: string;
-    workdir?: string;
-    timeoutMs?: number;
-    onExpiry?: string;
-    stdoutMaxBytes?: number;
-}
-export interface ShellReply {
-    stdout?: string;
-    stderr?: string;
-    exitCode?: number | null;
-    timedOut?: boolean;
-    aborted?: boolean;
-    failWith?: Error;
-}
-export declare function createFakeShell(replies?: ShellReply[] | ((call: ShellCall, index: number) => ShellReply)): {
-    shell: DshShell;
-    calls: ShellCall[];
-    peak: () => number;
-    commands: () => string[];
-};
-export interface OpencliCall {
-    args: readonly string[];
-    key?: string;
-    workdir?: string;
-    refresh?: boolean;
-}
-export declare function createFakeOpencli(replies?: Array<unknown | Error> | ((call: OpencliCall, index: number) => unknown | Error)): {
-    opencli: Opencli;
-    calls: OpencliCall[];
-    keys: () => (string | undefined)[];
-};
-export declare function createFakeLogger(): {
-    logger: {
-        info: () => void;
-        warn: (message: string) => void;
-    };
-    warnings: string[];
-};

package/dist/host/__tests__/fakes.js

@@ -1,76 +0,0 @@
-import { setTimeout as delay } from 'node:timers/promises';
-const tick = () => delay(0);
-export function createFakeShell(replies = []) {
-    const calls = [];
-    let running = 0;
-    let peak = 0;
-    const replyAt = (index) => typeof replies === 'function' ? replies(calls[index], index) : (replies[index] ?? {});
-    const shell = {
-        resolve(request) {
-            calls.push(request);
-            return request;
-        },
-        async execute() {
-            const index = calls.length - 1;
-            const reply = replyAt(index);
-            if (reply.failWith !== undefined)
-                throw reply.failWith;
-            running += 1;
-            peak = Math.max(peak, running);
-            return {
-                async result() {
-                    await tick();
-                    running -= 1;
-                    return {
-                        exitCode: reply.exitCode ?? 0,
-                        timedOut: reply.timedOut ?? false,
-                        aborted: reply.aborted ?? false,
-                        stdout: { text: reply.stdout ?? '', truncated: false },
-                        stderr: { text: reply.stderr ?? '', truncated: false },
-                    };
-                },
-            };
-        },
-    };
-    return {
-        shell,
-        calls,
-        peak: () => peak,
-        commands: () => calls.map((call) => call.command),
-    };
-}
-export function createFakeOpencli(replies = []) {
-    const calls = [];
-    const opencli = {
-        async json(args, options = {}) {
-            const call = {
-                args,
-                ...(options.key === undefined ? {} : { key: options.key }),
-                ...(options.workdir === undefined ? {} : { workdir: options.workdir }),
-            };
-            calls.push(call);
-            const index = calls.length - 1;
-            const reply = typeof replies === 'function' ? replies(call, index) : (replies[index] ?? []);
-            if (reply instanceof Error)
-                throw reply;
-            return { value: reply, at: Date.now() };
-        },
-    };
-    return {
-        opencli,
-        calls,
-        keys: () => calls.map((call) => call.key),
-    };
-}
-export function createFakeLogger() {
-    const warnings = [];
-    return {
-        logger: {
-            info: () => { },
-            warn: (message) => {
-                warnings.push(message);
-            },
-        },
-        warnings,
-    };
-}

package/dist/host/__tests__/preflight-fixtures.d.ts

@@ -1,19 +0,0 @@
-import { createFakeShell } from './fakes';
-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("../..").DshShell;
-        calls: import("./fakes").ShellCall[];
-        peak: () => number;
-        commands: () => string[];
-    };
-    preflight: import("../preflight").Preflight;
-};

package/dist/host/__tests__/preflight-fixtures.js

@@ -1,47 +0,0 @@
-import { createPreflight } from '../preflight';
-import { createFakeShell } from './fakes';
-export const GOOD_BRIDGE_REPORT = [
-    'opencli v1.8.7 doctor (node v24.15.0)',
-    '',
-    '[OK] Daemon: running on port 19825 (v1.8.7)',
-    '[OK] Extension: connected (v1.0.24)',
-    '[OK] Connectivity: connected in 0.0s',
-    '',
-    'Everything looks good!',
-].join('\n');
-export const ALL_OK = [{ stdout: '1.8.8\n' }, { stdout: GOOD_BRIDGE_REPORT }];
-export const STALE_DAEMON_BRIDGE = [
-    'opencli v1.8.7 doctor (node v24.15.0)',
-    '',
-    '[STALE] Daemon: running on port 19825 (v1.8.8 != CLI v1.8.7)',
-    '[OK] Extension: connected (v1.0.24)',
-    '[OK] Connectivity: connected in 0.0s',
-    '',
-    'Issues:',
-    '  • Stale daemon detected: daemon v1.8.8 != CLI v1.8.7.',
-    '  Run: opencli daemon restart',
-].join('\n');
-export const BROKEN_BRIDGE = [
-    'opencli v1.8.7 doctor (node v24.15.0)',
-    '',
-    '[MISSING] Daemon: not running',
-    '[MISSING] Extension: not connected',
-    '[FAIL] Connectivity: failed (daemon not reachable)',
-    '',
-    'Issues:',
-    "  • Daemon is not running. It should start automatically when you run an opencli browser command.",
-    '  • Daemon is running but the Chrome/Chromium extension is not connected.',
-    'If the extension is not installed:',
-    '  1. Download from https://github.com/jackwener/opencli/releases',
-    '  2. Open chrome://extensions/ → Enable Developer Mode',
-    '  3. Click "Load unpacked" → select the extension folder',
-].join('\n');
-export function build(replies, install, warmReads) {
-    const fake = createFakeShell(replies);
-    const preflight = createPreflight({
-        shell: fake.shell,
-        ...(install === undefined ? {} : { install }),
-        ...(warmReads === undefined ? {} : { warmReads }),
-    });
-    return { fake, preflight };
-}

package/dist/host/context-inject.d.ts

@@ -1,24 +0,0 @@
-import { type ContextRef } from '@dsh-workbench/shared';
-import type { ContextRenderer } from './unit-face';
-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/host/context-inject.js

@@ -1,74 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { encodeRef, parseMarkers } from '@dsh-workbench/shared';
-export const CONTEXT_SOURCE_KIND = 'workbench';
-export function collectContextRefs(messages) {
-    const seen = new Set();
-    const refs = [];
-    for (const message of messages) {
-        if (message.source?.kind !== 'user')
-            continue;
-        for (const block of message.content ?? []) {
-            if (block.type !== 'text' || typeof block.text !== 'string')
-                continue;
-            for (const ref of parseMarkers(block.text)) {
-                const key = encodeRef(ref);
-                if (seen.has(key))
-                    continue;
-                seen.add(key);
-                refs.push(ref);
-            }
-        }
-    }
-    return refs;
-}
-export function buildContextMessage(text, summary) {
-    return {
-        role: 'user',
-        id: randomUUID(),
-        content: [{ type: 'text', text }],
-        source: { kind: CONTEXT_SOURCE_KIND, form: 'notice', summary },
-    };
-}
-export function createContextInjector(options) {
-    const done = new WeakMap();
-    return {
-        async inject(messages, agent) {
-            const refs = collectContextRefs(messages);
-            if (refs.length === 0)
-                return undefined;
-            const key = typeof agent === 'object' && agent !== null ? agent : undefined;
-            const seen = key === undefined ? undefined : (done.get(key) ?? new Set());
-            if (key !== undefined && seen !== undefined)
-                done.set(key, seen);
-            const fresh = [];
-            for (const ref of refs) {
-                const encoded = encodeRef(ref);
-                if (seen?.has(encoded) === true)
-                    continue;
-                seen?.add(encoded);
-                fresh.push(ref);
-            }
-            if (fresh.length === 0)
-                return undefined;
-            const texts = [];
-            for (const ref of fresh) {
-                const render = options.renderers.get(ref.kind);
-                if (render === undefined)
-                    continue;
-                let text;
-                try {
-                    text = await render(ref);
-                }
-                catch (error) {
-                    options.logger?.warn?.(`[dsh-workbench] 渲染对话引用失败：${String(error)}`);
-                    text = `工作台面板引用了一条内容（${encodeRef(ref)}），但当前渲染不出来（项目未选中或数据源不可用）。`;
-                }
-                if (text !== '')
-                    texts.push(text);
-            }
-            if (texts.length === 0)
-                return undefined;
-            return buildContextMessage(texts.join('\n\n'), `工作台引用：${fresh.length} 条`);
-        },
-    };
-}

package/dist/host/events.d.ts

@@ -1,9 +0,0 @@
-import type { DshHostContext, DshRequest, DshResponse } from '@dsh-workbench/shared';
-import type { FactLog } from './facts';
-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/host/events.js

@@ -1,70 +0,0 @@
-import { EVENTS_PATH } from '@dsh-workbench/shared';
-const HEARTBEAT_MS = 25_000;
-function frame(payload) {
-    return `data: ${JSON.stringify(payload)}\n\n`;
-}
-export function createFactStream(log) {
-    const connections = new Set();
-    const cleanups = new Map();
-    const drop = (res) => {
-        cleanups.get(res)?.();
-        cleanups.delete(res);
-        connections.delete(res);
-    };
-    return {
-        size: () => connections.size,
-        closeAll() {
-            for (const res of [...connections]) {
-                drop(res);
-                res.end?.();
-            }
-        },
-        handler(req, res) {
-            if (req.method !== undefined && req.method !== 'GET') {
-                res.statusCode = 405;
-                res.end();
-                return;
-            }
-            const url = req.url ?? '/';
-            const cut = url.indexOf('?');
-            const since = Number(new URLSearchParams(cut === -1 ? '' : url.slice(cut + 1)).get('since') ?? 0) || 0;
-            const opening = log.since(since);
-            if (typeof res.write !== 'function') {
-                res.statusCode = 200;
-                res.setHeader('content-type', 'application/json; charset=utf-8');
-                res.end(JSON.stringify({ ok: true, ...opening }));
-                return;
-            }
-            const headers = {
-                'content-type': 'text/event-stream; charset=utf-8',
-                'cache-control': 'no-store, no-transform',
-                connection: 'keep-alive',
-            };
-            if (typeof res.writeHead === 'function')
-                res.writeHead(200, headers);
-            else {
-                res.statusCode = 200;
-                for (const [name, value] of Object.entries(headers))
-                    res.setHeader(name, value);
-            }
-            res.write(': connected\n\n');
-            res.write(frame({ type: 'sync', ...opening }));
-            connections.add(res);
-            const timer = setInterval(() => res.write?.(': ping\n\n'), HEARTBEAT_MS);
-            const unsubscribe = log.subscribe((change) => res.write?.(frame({ type: 'bump', ...change })));
-            cleanups.set(res, () => {
-                clearInterval(timer);
-                unsubscribe();
-            });
-            res.on?.('close', () => drop(res));
-        },
-    };
-}
-export function registerFactStream(ctx, log) {
-    const stream = createFactStream(log);
-    const unregister = ctx.webServer.register({ kind: 'exact', path: EVENTS_PATH, handler: stream.handler });
-    return () => {
-        stream.closeAll();
-        unregister();
-    };
-}

package/dist/host/mount-units.d.ts

@@ -1,52 +0,0 @@
-import type { DshHostContext } from '@dsh-workbench/shared';
-import type { UnitManifest } from '@dsh-workbench/shared';
-import { type RouteTable } from './http';
-import type { ContextRenderer, UnitHostFace, UnitMountDeps, UnitMountResult, UnitCall } from './unit-face';
-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;